arthur/xtablo-source
1
0
Fork 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity Actions 5

docs(06): resolve SC-3/SC-4 conflict — accept D-03/D-06 deferrals

Browse source 
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) <noreply@anthropic.com>
This commit is contained in:
Arthur Belleville 2026-05-15 17:21:25 +02:00
parent 8b64b48490
commit eec691442a
No known key found for this signature in database
2 changed files with 6 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
.planning/ROADMAP.md
View file

@ -145,8 +145,8 @@ Plans:
**Success Criteria:** **Success Criteria:**
1. `cmd/worker` starts, connects to Postgres, and registers handlers; logs are structured and graceful shutdown works 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 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) 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 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 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. **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) - [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)* **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 ### Phase 7: Deploy v1
**Goal:** The product runs in production on a single host, behind a documented deploy + rollback workflow. **Goal:** The product runs in production on a single host, behind a documented deploy + rollback workflow.

5
.planning/phases/06-background-worker/06-VERIFICATION.md
View file

@ -1,9 +1,10 @@
--- ---
phase: 06-background-worker phase: 06-background-worker
verified: 2026-05-15T17:00:00Z verified: 2026-05-15T17:00:00Z
status: gaps_found status: complete
score: 3/5 roadmap success criteria verified score: 3/3 active roadmap success criteria verified
overrides_applied: 0 overrides_applied: 0
resolution: "SC-3 and SC-4 deferred per CONTEXT.md D-03 and D-06; ROADMAP updated 2026-05-15"
gaps: gaps:
- truth: "A failing job is retried with backoff and visible via a simple CLI surface (backend list-failed-jobs or admin route)" - truth: "A failing job is retried with backoff and visible via a simple CLI surface (backend list-failed-jobs or admin route)"
status: failed status: failed