feat: idea_id op create_pbi/create_sprint legt idee-koppeling vast (ISS-17) #227

Merged
janpeter merged 3 commits from claude/iss-17-idea-link into main 2026-10-14 20:03:23 +02:00
Owner

Bronfix voor ISS-17 in scrum4me-mcp: create_pbi en create_sprint kunnen de koppeling idee → PBI/sprint vastleggen, zodat Scrum Usage (IDEA-260) het verbruik van een sprint aan het idee kan toerekenen.

Effect pas na de vervolgstappen. Na de merge moet de MCP opnieuw verbinden, en moeten de ceremonie-instructies (review-loop, methodiek-rule in agent-rules) idea_id meegeven. Tot die tijd stuurt geen ceremonie idea_id, en blijft het symptoom van ISS-17 bestaan.

Wijziging

  • create_pbi en create_sprint krijgen een optionele idea_id.
    • create_pbi vult ideas.pbi_id, create_sprint vult ideas.build_sprint_id.
    • De kolom wordt alleen gevuld als die leeg is en nooit overschreven (keuze JP).
    • De response meldt idea_link: { idea_id, field, outcome: "set" | "skipped_existing" }.
  • Validatie vóór het aanmaken:
    • Het idee moet van de aanroeper zijn.
    • Het product moet het primaire of een secundair (idea_products) product van het idee zijn.
    • Faalt een van beide, dan volgt een toolError en wordt er niets aangemaakt.
  • Atomair:
    • create_pbi koppelt binnen de bestaande serializable transactie.
    • create_sprint zet de create en de koppeling samen in één prisma.$transaction; de code-conflict-retry blijft werken.
  • PPE-compatibel: idea_id komt alleen in het gehashte request als hij is meegegeven. De payload_hash van bestaande ceremony-calls verandert dus niet.
    • Let op: een ceremonie die idea_id samen met ppe stuurt, moet idea_id ook in de eigen hash opnemen.
  • Ongewijzigd: de status van het idee en build_sprint_run_id. Er is geen schemawijziging.

Verificatie

  • npm run typecheck: exit 0.
  • npm run typecheck:tests: exit 0.
  • npm test (inclusief typecheck van de tests): 272 files geslaagd en 10 overgeslagen; 2724 tests geslaagd en 84 overgeslagen. Dat zijn 15 nieuwe tests.
  • Niet tegen een echte Postgres gemeten: de nieuwe tests werken met mocks. De retry-test gebruikt de foutvorm van de driver-adapter. De PPE-suites met database draaien alleen in CI.

Buiten deze PR

  • Backfill: bestaande ideeën vullen uit de metadata van idea_logs. Dat is een data-migratie via scrum4me-web en vraagt prod-akkoord.
  • Ceremonie-instructies: idea_id meegeven bij een idee-ceremonie. Dat hoort in agent-rules.
  • Meerdere sprints per idee: daar is een koppeltabel voor nodig.

Scrum4Me: ISS-17 · PBI-39 · ST-062 · T-186, T-187

🤖 Generated with Claude Code

Bronfix voor ISS-17 in scrum4me-mcp: `create_pbi` en `create_sprint` kunnen de koppeling idee → PBI/sprint vastleggen, zodat Scrum Usage (IDEA-260) het verbruik van een sprint aan het idee kan toerekenen. **Effect pas na de vervolgstappen.** Na de merge moet de MCP opnieuw verbinden, en moeten de ceremonie-instructies (`review-loop`, methodiek-rule in agent-rules) `idea_id` meegeven. Tot die tijd stuurt geen ceremonie `idea_id`, en blijft het symptoom van ISS-17 bestaan. ## Wijziging - **`create_pbi` en `create_sprint`** krijgen een optionele `idea_id`. - `create_pbi` vult `ideas.pbi_id`, `create_sprint` vult `ideas.build_sprint_id`. - De kolom wordt **alleen gevuld als die leeg is** en nooit overschreven (keuze JP). - De response meldt `idea_link: { idea_id, field, outcome: "set" | "skipped_existing" }`. - **Validatie vóór het aanmaken:** - Het idee moet van de aanroeper zijn. - Het product moet het primaire of een secundair (`idea_products`) product van het idee zijn. - Faalt een van beide, dan volgt een `toolError` en wordt er niets aangemaakt. - **Atomair:** - `create_pbi` koppelt binnen de bestaande serializable transactie. - `create_sprint` zet de create en de koppeling samen in één `prisma.$transaction`; de code-conflict-retry blijft werken. - **PPE-compatibel:** `idea_id` komt alleen in het gehashte request als hij is meegegeven. De payload_hash van bestaande ceremony-calls verandert dus niet. - Let op: een ceremonie die `idea_id` samen met `ppe` stuurt, moet `idea_id` ook in de eigen hash opnemen. - **Ongewijzigd:** de status van het idee en `build_sprint_run_id`. Er is geen schemawijziging. ## Verificatie - `npm run typecheck`: exit 0. - `npm run typecheck:tests`: exit 0. - `npm test` (inclusief typecheck van de tests): 272 files geslaagd en 10 overgeslagen; 2724 tests geslaagd en 84 overgeslagen. Dat zijn 15 nieuwe tests. - Niet tegen een echte Postgres gemeten: de nieuwe tests werken met mocks. De retry-test gebruikt de foutvorm van de driver-adapter. De PPE-suites met database draaien alleen in CI. ## Buiten deze PR - **Backfill:** bestaande ideeën vullen uit de metadata van `idea_logs`. Dat is een data-migratie via scrum4me-web en vraagt prod-akkoord. - **Ceremonie-instructies:** `idea_id` meegeven bij een idee-ceremonie. Dat hoort in agent-rules. - **Meerdere sprints per idee:** daar is een koppeltabel voor nodig. Scrum4Me: ISS-17 · PBI-39 · ST-062 · T-186, T-187 🤖 Generated with [Claude Code](https://claude.com/claude-code)
De ceremonie maakt via create_pbi een PBI van een idee, maar de tool kende
geen idea_id, waardoor ideas.pbi_id leeg bleef. Met de optionele idea_id
valideert de tool eigenaar en product (primair of secundair) vooraf en zet
hij de koppeling in dezelfde transactie als de create, alleen als die nog
leeg is. Het PPE-request krijgt idea_id alleen als hij is meegegeven, zodat
de payload hash van bestaande calls ongewijzigd blijft.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
feat(create_sprint): optionele idea_id koppelt ideas.build_sprint_id als leeg (ISS-17, T-187)
Some checks failed
CI / Final merge attestation and immutable publication (pull_request) Has been skipped
CI / PR candidate (never published) (pull_request) Has been cancelled
d6072cfbe6
De ceremonie maakt via create_sprint een sprint van een idee, maar de tool
kende geen idea_id, waardoor ideas.build_sprint_id leeg bleef. Met de
optionele idea_id valideert de tool eigenaar en product vooraf en zet hij de
koppeling alleen als die nog leeg is. Met idea_id delen sprint-create en
koppeling één transactie op beide code-paden; zonder idea_id blijft het een
kale create, zodat bestaand gedrag en de PPE payload hash ongewijzigd blijven.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
test(create_sprint): retry-test met idea_id gebruikt de driver-adapter-foutvorm (ISS-17)
All checks were successful
CI / Final merge attestation and immutable publication (pull_request) Has been skipped
CI / PR candidate (never published) (pull_request) Successful in 5m12s
9515557a49
Onder Prisma 7 + adapter-pg ontbreekt meta.target; de nieuwe retry-test bouwde
nog de klassieke P2002-vorm en dekte dus een vorm die productie niet levert.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
s4m-codex-reviewer left a comment

COMMENT

Plan gekoppeld via pr_refs: T-186, T-187, ST-062. Er zijn geen onderdelen weggelaten (omitted is leeg).

De diff volgt het gekoppelde plan binnen de beschreven PR-scope: eigenaars- en productvalidatie, conditioneel vullen zonder overschrijven, koppeling binnen dezelfde transactie, ongewijzigde requests zonder idea_id en bijgewerkte toolbeschrijvingen. Geen blokkerende code- of architectuurbevindingen vastgesteld. Backfill en aanpassing van ceremonie-instructies zijn expliciet vervolgwerk.

Findings:

  • info — tests/create-sprint.test.ts:69: de transactiemock geeft de root-client als tx door. Daardoor bewijzen de nieuwe tests niet dat create en koppeling uitsluitend de transactieclient gebruiken; ook een onbedoelde root-client-update zou slagen. Gebruik afzonderlijke root-/tx-mocks en controleer dat de root-update niet wordt aangeroepen.
  • warning (verificatie, bestaande baseline) — tests/wait-for-job-local-llm-repo-root.test.ts:314: de bestaande conventie-test faalt zowel op deze head als op base 11b0c3f (verwachte Projects-root versus on-demand-clone-root). Dit is geen aangetoonde PR-regressie, maar een volledig groene suite is hier niet bevestigd.

Verificatie op 9515557a49:

  • npm run typecheck en typecheck:tests: geslaagd.
  • Gerichte Vitest-run met threads: 2 bestanden, 22 tests geslaagd.
  • git diff --check: geslaagd.
  • Volledige npm-testpogingen afgebroken wegens uitblijvende voortgang; ook de begrensde thread-run is niet afgerond. De genoemde baseline-fout is afzonderlijk op head en base gereproduceerd. Geen nieuwe echte-database-integratieverificatie uitgevoerd.

Vanwege de onvolledige suiteverificatie blijft het verdict COMMENT.

## COMMENT Plan gekoppeld via pr_refs: T-186, T-187, ST-062. Er zijn geen onderdelen weggelaten (omitted is leeg). De diff volgt het gekoppelde plan binnen de beschreven PR-scope: eigenaars- en productvalidatie, conditioneel vullen zonder overschrijven, koppeling binnen dezelfde transactie, ongewijzigde requests zonder idea_id en bijgewerkte toolbeschrijvingen. Geen blokkerende code- of architectuurbevindingen vastgesteld. Backfill en aanpassing van ceremonie-instructies zijn expliciet vervolgwerk. Findings: - **info** — __tests__/create-sprint.test.ts:69: de transactiemock geeft de root-client als tx door. Daardoor bewijzen de nieuwe tests niet dat create en koppeling uitsluitend de transactieclient gebruiken; ook een onbedoelde root-client-update zou slagen. Gebruik afzonderlijke root-/tx-mocks en controleer dat de root-update niet wordt aangeroepen. - **warning (verificatie, bestaande baseline)** — __tests__/wait-for-job-local-llm-repo-root.test.ts:314: de bestaande conventie-test faalt zowel op deze head als op base 11b0c3f (verwachte Projects-root versus on-demand-clone-root). Dit is geen aangetoonde PR-regressie, maar een volledig groene suite is hier niet bevestigd. Verificatie op 9515557a492b79572ee34a73bf546aa95352afdc: - npm run typecheck en typecheck:tests: geslaagd. - Gerichte Vitest-run met threads: 2 bestanden, 22 tests geslaagd. - git diff --check: geslaagd. - Volledige npm-testpogingen afgebroken wegens uitblijvende voortgang; ook de begrensde thread-run is niet afgerond. De genoemde baseline-fout is afzonderlijk op head en base gereproduceerd. Geen nieuwe echte-database-integratieverificatie uitgevoerd. Vanwege de onvolledige suiteverificatie blijft het verdict COMMENT.
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
janpeter/scrum4me-mcp!227
No description provided.