Files
canina/scripts/seo-performance/implementation-spec.md
T

6 lines
1.5 KiB
Markdown

# Worker scope and acceptance
Bound to baseline specs/002-seo-performance-tracking; this local directory is not a Git worktree, so artifacts are local only, not committed/deployed. No backend/UI edits, cron or production writes authorized.
Replace fabricated zeros with explicit unavailable/no_data and null. Collect all findings by pagination, exact canonical URL Google matching, same inclusive date period ending UTC today minus three days (GSC final data; GA4 property timezone retained separately). Google successful API response, not session construction, proves access. GSC top-row reporting is not exhaustive keyword coverage. No causal commerce attribution without source linkage. Store snapshots/outbox durably and deduplicate period+revision; feedback revision binds mandatory directive and backend must reject stale revisions. No invented optimization thresholds: insufficient evidence until approved policy and comparison data exist.
Plan: injectable REST collectors; local SQLite snapshot/outbox; backend adapter with strict pagination; explicit opt-in delivery, local read-only probe mode. Failure errors sanitized to class/status only. Tests precede implementation (9 RED failures observed). Test doubles are confined to tests.
Tasks: implement collectors/store/orchestrator; test authentication/429/timeouts/partial pages and reruns; live read-only Google probe; backend integration contract pending sibling; document blockers and acceptance evidence. No automatic deployment.