feat(IDEA-243): scrum4me_changes-notify bij elke zichtbare jobstatus- en usage-write (PR A) #208
No reviewers
Labels
No labels
severity/s2
severity/s3
severity/s4
No milestone
No project
No assignees
2 participants
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
janpeter/scrum4me-mcp!208
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "feat/idea-243-job-notify"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
IDEA-243 inc. 1 — PR A: jobstatus-notify voor elke zichtbare claude_jobs-write (scrum4me-mcp)
Base: main @
580fae5(plan werd geschreven tegen4eb0cd1; regelnummers verschoven, writers op symbool gelokaliseerd).Wat
Eén bron (
src/lib/job-notify.ts) voor descrum4me_changes-jobnotify, met PoolClient- en Prisma-adapter, en notifies op elkezichtbare status- of usage-write. Claims gebruiken
claude_job_status_changed(status CLAIMED), nietclaude_job_claimed.Foutbeleid: binnen een tx notify op de tx-client (mag gooien, tx breekt af); buiten een tx best-effort (catch + console.warn),
ná de bestaande side-effects.
Gedragswijziging
update_job_statusgebruikt nu de builder: het envelope is begrensd op 7500 bytes (summary, dan error, dan branch, dan pr_urlworden ingekort/weggelaten; verplichte velden blijven). Eerder kon een grote summary/error pg_notify (limiet 8000 bytes) laten falen,
wat de (non-fatale) notify stil deed verdwijnen. Payloadvorm voor normale grootte is ongewijzigd.
Writer-audit (
claude_jobs-writers insrc/)notifyJobChanged, tx)terminalizeAttempt-> DONE/FAILED/CANCELLEDrejectUnstartedInTransaction-> CANCELLEDwriteDispatchUsageonce-early-returntryClaimJobclaim -> CLAIMEDtx)markJobTerminallyFailed-> FAILEDrollbackClaim-> QUEUEDrequeued > 0)releaseMismatchedClaim-> QUEUEDtx, alleen na geslaagde guard)LocalLlmWorktreeRefused-> FAILED:280), retry_count-bump, branch/base_sha-update, sprint-scope tx-updateapplyDocsAuditTerminalUpdateresolved_at-update, follow-up createnotifyJobEnqueuedpersistJobUsageSnapshot(beide takken)tx)tx;updateManyAndReturn):251notifyJobEnqueuedRuntimes die deze PR raakt (deploy door JP)
src/dispatch/server.ts)src/http.ts, met image)MCP_GIT_REF)Extern bewijs: consumers in Scrum4Me-web (lokale checkout, branch
codex/opus-48-job-defaults@ f4cb0c5f, 2026-08-23; NIET geverifieerd tegen prod/main)Grep op
scrum4me_changes/claude_job_status_changed/claude_job_enqueuedin*.ts(x):app/api/realtime/{solo,jobs,notifications}/route.tsfilteren optype: 'claude_job_enqueued' | 'claude_job_status'(zonder_changed);vendor/scrum4me-shared/lib/realtime-payload.tskentclaude_job_status_changed(id. in workersapp/api/realtime/queue/route.ts).Gevolg: nieuwe notifies op
_status_changedbereiken de workers-queue-SSE; de web-routes die opclaude_job_statusfilterenzouden ze negeren (zelfde situatie als de bestaande update_job_status-notify). Te bevestigen tegen Scrum4Me-main.
Verificatie
npm run typecheck,npm run typecheck:tests,npm test: groen — 268 testbestanden / 2634 tests geslaagd (10 / 81 skipped), door de orchestrator herhaald.npm run test:dispatch: NIET lokaal gedraaid (preflightdispatch-test-db.mjs checkfaalt metDISPATCH_TEST_SCHEMA_ROOT_REQUIRED;geen test-DB beschikbaar). De nieuwe
__tests__/dispatch/job-notify.integration.test.tsdraait in de CI-stap "Run disposable dispatch integration gate"; die CI-run geldt als bewijs.Selection-cancel en sources-reject hebben geen eigen integratiescenario (alleen code, niet DB-bewezen).
Companion: janpeter/scrum4me-workers#148 (PR B). Plan: PLANS/idea-243-increment-1-plan rev 6 (dubbel GO), Review record ronde 6 (rev 7); taken T-201..T-205.
🤖 Generated with Claude Code
REQUEST_CHANGES
Findings:
__tests__/dispatch/job-notify.integration.test.ts:22: de expliciet in T-205/A5 vereiste LISTEN-scenario’s voor selectie-cancel (retireExpiredCandidate) en sources-reject (rejectUnstartedInTransaction) ontbreken. Dit betreft de gewijzigde writers binnen PR A; de PR-beschrijving bevestigt zelf het ontbreken. Daarnaast geeft de normale completion op regel 26 geen usage mee: de bewering op regel 28 dat terminal- en usage-notify tot precies één DONE worden samengevoegd wordt dus niet getest. De cancel-assertie op regel 39 controleert alleen de laatste entry en sluit dubbele CANCELLED-notifies niet uit. Voeg de twee scenario’s met een bestaande QUEUED job toe, geef usage mee bij normale completion en controleer per scenario de volledige exacte lijst[type, status], zoals A5 voorschrijft.Plan gekoppeld via pr_refs (product scrum4me-workers), referenties: T-201 (scrum4me-workers), T-205 (scrum4me-workers), story ST-065. Geen onderdelen weggelaten (
omittedis leeg). PR A presenteert A1–A6 als oplevering; de ontbrekende A5-dekking valt daarom binnen deze PR. De latere UI-acceptatiecriteria en companion PR B zijn geen blokkerende bevindingen voor deze MCP-PR.Verificatie op
e42aec83b077dcea271ffdff0a8bba0b6475dd0d:npm run typecheck,npm run typecheck:testsennpm testgeslaagd (268 bestanden / 2634 tests; 10 bestanden / 81 tests overgeslagen).npm run test:dispatchstopt lokaal bijDISPATCH_TEST_SCHEMA_ROOT_REQUIRED; de Forgejo-statusCI / PR candidate (never published)voor dezelfde commit is success. Dat bewijst de aanwezige tests, maar vult de ontbrekende scenario’s niet aan.De gedeelde builder en de tx-client-adapters sluiten aan op het bestaande realtime-contract en de productstandaard voor afzonderlijke bron- en testtypechecks. De PR documenteert de writer-audit, de vier runtimes, het bytebudget en de beperkingen van het externe consumerbewijs. Geen concrete runtime-regressie vastgesteld.
COMMENT
Findings:
__tests__/dispatch/job-notify.integration.test.ts:26: de vereiste lifecycle-, late-usage-, replay- en annuleringsscenario’s zijn aanwezig, maar hun PostgreSQL-uitvoering is voor deze head nog niet bewezen. Lokaal stoptnpm run test:dispatchbijDISPATCH_TEST_SCHEMA_ROOT_REQUIRED; de head-gebonden Forgejo-CI staat nog op pending. Geen vastgestelde codefout, wel onvoldoende bewijs voor APPROVED.__tests__/wait-for-job-local-llm-repo-root.test.ts:314: de volledige run met threadpool faalt op de HOME-afhankelijke repo-root-assertie. Dezelfde fout is op base580fae5gereproduceerd met dezelfde pool; dit is geen aangetoonde PR-regressie.__tests__/dispatch/job-notify.integration.test.ts:65: de PR-beschrijving meldt nog dat selectie-cancel en sources-reject geen eigen integratiescenario hebben. Die staan inmiddels op regels 65 en 78; actualiseer die passage.plan gekoppeld via pr_refs (product scrum4me-workers), referenties: T-201 (scrum4me-workers), T-205 (scrum4me-workers), story ST-065. Geen onderdelen weggelaten (
omittedis leeg). De eerdere blokkerende testdekking is verwerkt: completion krijgt usage mee, volledige exacte notificatielijsten worden gecontroleerd en beide ontbrekende annuleringsscenario’s zijn toegevoegd. De UI-acceptatiecriteria horen bij companion PR B en blokkeren deze MCP-PR niet.De gedeelde builder, het bytebudget, de tx-client-adapters en guards sluiten aan op het gekoppelde plan en de geraadpleegde productstandaarden. Geen concrete runtime-regressie of blokkerende codebevinding vastgesteld.
Verificatie op
ed01f2c7fd93614048866757ee6d6cf350c9c7e1: beide typechecks geslaagd; 58 gerichte tests geslaagd. Volledigenpm test -- --pool=threads --maxWorkers=2: 2633 geslaagd, 1 bestaande fout, 81 overgeslagen (267 bestanden geslaagd, 1 gefaald, 10 overgeslagen). De standaard forkpool-runs kwamen hier niet tot voortgang en zijn afgebroken. Dispatch-DB-bewijs blijft open; daarom autonoom COMMENT.