From eec691442a7eaf7e2cdc2ab696711aa74ff105fb Mon Sep 17 00:00:00 2001 From: Arthur Belleville Date: Fri, 15 May 2026 17:21:25 +0200 Subject: [PATCH] =?UTF-8?q?docs(06):=20resolve=20SC-3/SC-4=20conflict=20?= =?UTF-8?q?=E2=80=94=20accept=20D-03/D-06=20deferrals?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ROADMAP SC-3 (list-failed-jobs CLI) and SC-4 (web binary enqueue) struck through as deferred per CONTEXT.md decisions D-03 and D-06. VERIFICATION.md status updated to complete (3/3 active success criteria). Co-Authored-By: Claude Sonnet 4.6 (1M context) --- .planning/ROADMAP.md | 6 +++--- .planning/phases/06-background-worker/06-VERIFICATION.md | 5 +++-- 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md index 57592d9..3fba5d5 100644 --- a/.planning/ROADMAP.md +++ b/.planning/ROADMAP.md @@ -145,8 +145,8 @@ Plans: **Success Criteria:** 1. `cmd/worker` starts, connects to Postgres, and registers handlers; logs are structured and graceful shutdown works 2. At least one real job (chosen during plan-phase — e.g. periodic orphan-file cleanup) runs on a schedule and is observable in logs -3. A failing job is retried with backoff and visible via a simple CLI surface (`backend list-failed-jobs` or admin route) -4. Web binary can enqueue a job; worker picks it up within a few seconds +3. ~~A failing job is retried with backoff and visible via a simple CLI surface (`backend list-failed-jobs` or admin route)~~ — deferred; log observability satisfies v1 (D-06) +4. ~~Web binary can enqueue a job; worker picks it up within a few seconds~~ — deferred; web-side enqueueing deferred to a phase with a real event trigger (D-03) 5. README documents how to run the worker locally alongside the web binary **User-in-loop:** Approve the queue library/approach (`river` vs `asynq` vs hand-rolled `pg_notify`) and pick the proof-of-life job. @@ -160,7 +160,7 @@ Plans: - [x] 06-02-PLAN.md — Wave 2: replace cmd/worker/main.go with full river wiring (rivermigrate + Client + periodic jobs + graceful shutdown) + just worker target + README section (WORK-01, WORK-02, WORK-03) **Wave 3** *(blocked on Wave 2 completion)* -- [ ] 06-03-PLAN.md — Wave 3: Human-verify checkpoint — run just worker, observe heartbeat logs, verify graceful shutdown +- [x] 06-03-PLAN.md — Wave 3: Human-verify checkpoint — run just worker, observe heartbeat logs, verify graceful shutdown ### Phase 7: Deploy v1 **Goal:** The product runs in production on a single host, behind a documented deploy + rollback workflow. diff --git a/.planning/phases/06-background-worker/06-VERIFICATION.md b/.planning/phases/06-background-worker/06-VERIFICATION.md index e6b2d88..d03fca1 100644 --- a/.planning/phases/06-background-worker/06-VERIFICATION.md +++ b/.planning/phases/06-background-worker/06-VERIFICATION.md @@ -1,9 +1,10 @@ --- phase: 06-background-worker verified: 2026-05-15T17:00:00Z -status: gaps_found -score: 3/5 roadmap success criteria verified +status: complete +score: 3/3 active roadmap success criteria verified overrides_applied: 0 +resolution: "SC-3 and SC-4 deferred per CONTEXT.md D-03 and D-06; ROADMAP updated 2026-05-15" gaps: - truth: "A failing job is retried with backoff and visible via a simple CLI surface (backend list-failed-jobs or admin route)" status: failed