feat(rules): menu-item Rules + rules inzien/bewerken op /rules/[slug] (PBI-46) #168
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-workers!168
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "feat/rules-menu-edit"
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?
Samenvatting
/rules(actief op/rules/<slug>)./rules/[slug]: kop (basename, slug, agent, scope, doelpad, revisie N), inhoud opgemaakt/bron viaMarkdownSourceView, Bewerken → editor met volledigecontent_mdincl. frontmatter, Opslaan/Annuleren.saveRuleAction→@sharedwriteProductDoc(zelfde write-laag als MCPcreate_product_doc): nieuwe immutable revisie, noop bij gelijke inhoud, 409 bij gelijktijdige wijziging (melding: herlaad). Scope vastgepind op rules-product +MANUAL+claude-/codex--slug; maakt nooit een doc aan (bestaanscheck in de tx). Alleen hoofd-DB, queue-DB niet geraakt.docs/pages/rules.md,docs/pages/dashboard.md(navzin) en de stale kopcommentaar inlib/rules/sync.tsbijgewerkt.Ontwerpkeuzes JP: eigen pagina per rule, Opslaan en Publish los, alleen huidige revisie. Buiten scope: revisiehistorie, aanmaken/verwijderen, gepubliceerd-indicator.
Scrum4Me: PBI-46 / ST-082 / T-266…T-269 (sprint S-2026-10-16-1).
Verificatie
npm run verifyexit 0 — Test Files 221 passed | 4 skipped (225), Tests 2811 passed | 66 skipped (2877) (baseline main: 217 / 2767).next buildexit 0;/rulesen/rules/[slug]in de routelijst.Reviewronde 1 (s4m-codex-reviewer, REQUEST_CHANGES op
0a3aae7)5737d7asaveRuleActionleest binnen de transactie de opgeslagen (genormaliseerde)content_mdterug en geeft die mee; de pagina en een heropende editor tonen die, inclusief de nieuwelast_updated. Regressietests in action en component. →16ca0f2npm run verifyexit 0 (220 files, 2806 tests), lokalenext buildexit 0.Reviewronde 2 (s4m-codex-reviewer, REQUEST_CHANGES op
16ca0f2)@sharedwriteProductDoccontroleertexpected_revision_idalleen als het niet leeg is.saveRuleActionvergelijkt nu zelf strikt binnen de transactie (current_revision_id !== expectedRevisionId, ook null vs. revisie) en geeft bij mismatch 409 zonderwriteProductDocaan te roepen. Regressietests voor null↔revisie en revisie↔revisie (rood zonder fix), plus null/null schrijft wel. →186080cwriteProductDoc: de guard draait daarvóór, en de tests bewijzen dat de write-laag bij een mismatch niet wordt aangeroepen.@shareden de/context-editor zijn niet gewijzigd (die heeft dezelfde null-semantiek).npm run verifyexit 0 (220 files, 2809 tests), lokalenext buildexit 0.Reviewronde 3 (s4m-codex-reviewer, REQUEST_CHANGES op
186080c)expectedRevisionId: null) wordt nu geweigerd vóór elke DB-toegang, met de melding dat de eerste revisie via de MCP (create_product_doc) moet komen; op de pagina staat Bewerken dan uit. →ed5a9ca__tests__/actions/rules-concurrency.test.tsmet de echtewriteProductDoc: een commit tussen onze guard en de read inwriteProductDocgeeft 409 en geen write.writeProductDocen diensmax(revision)-aggregaat, dan schrijft deze save een revisie na die van de ander (revisienummer max+1, dus geen botsing op@@unique([doc_id, revision])) en overschrijft de inhoud zonder 409. Het venster is enkele milliseconden en zit in de gedeelde write-laag, dus MCPcreate_product_docen de/context-editor hebben hetzelfde. Botsen twee saves op hetzelfde revisienummer, dan faalt er één op de unieke index (geen stille overschrijving). Een structurele fix hoort in@sharedwriteProductDoc(rij vergrendelen vóór de token-check), niet alleen in deze action. Beschreven indocs/pages/rules.md.npm run verifyexit 0 (221 files, 2811 tests).🤖 Generated with Claude Code
REQUEST_CHANGES
Plan gekoppeld via pr_refs: T-266, T-269, ST-082. Geen omitted onderdelen. Navigatie, vaste rules-scope, admin-guard, bestaande-doc-check binnen de transactie, gedeelde writeProductDoc-laag en documentatie sluiten aan op het plan. De expliciet geplande rules-scope zonder ownership-check is beoordeeld als bewuste uitzondering op het algemene context-editorpatroon.
Verificatie op commit
0a3aae7a94: npm run verify geslaagd (220 testbestanden geslaagd, 4 overgeslagen; 2.803 tests geslaagd, 66 overgeslagen; één bestaande lintwaarschuwing). De 61 gerichte bestaande tests slagen. Twee tijdelijke aanvullende regressietests reproduceren bovenstaande problemen; deze zijn daarna verwijderd en de checkout is ongewijzigd. Geen live DB-/browserintegratietest uitgevoerd.REQUEST_CHANGES
Plan gekoppeld via pr_refs: T-266, T-269, ST-082. Er zijn geen planonderdelen weggelaten uit de aangeleverde context. Navigatie, detailweergave, scopes, documentatie en de reguliere opslag-/publishflow sluiten aan op het plan; onderstaande fout schendt de vereiste revisiecontrole.
Findings:
actions/rules.ts:67— Een rule zonder huidige revisie wordt geladen metexpectedRevisionId: null. Als een andere sessie daarna revisie 1 opslaat, geeft deze action nog steeds null door aanwriteProductDoc. Die gedeelde functie controleert alleen een truthyexpected_revision_id, waardoor de 409-check vervalt en verouderde inhoud de andere wijziging kan overschrijven als revisie 2. Controleer ook een verwachte null tegen de actuele revisie en geef bij een mismatch 409. Voeg een regressietest toe met de echte gedeelde schrijffunctie; de huidige mocktest controleert alleen het doorgeven van null.Verificatie op commit
16ca0f26a9c460f37f6b716866f4679442217309: lint zonder errors (één bestaande warning), typecheck geslaagd; schone testsuite: 220 bestanden geslaagd, 4 overgeslagen; 2.806 tests geslaagd, 66 overgeslagen. Een afzonderlijke gerichte controle met de echtewriteProductDocen een gesimuleerde DB bevestigt dat het verouderde null-token het schrijfpad bereikt in plaats van een 409 op te leveren. Geen live database-integratietest uitgevoerd.REQUEST_CHANGES
actions/rules.ts:56: De revisiecheck en de write zijn niet atomair beschermd tegen andere schrijvers. Bij de standaard PostgreSQL-isolatie vergrendelt dezefindUniquede rij niet. Scenario: de guard leestcurrent_revision_id = null; een andere schrijver commit een eerste revisie; vervolgens leestwriteProductDocdie nieuwe revisie, maar slaat zijn controle over omdatexpected_revision_idnull is. De action schrijft dan succesvol een volgende revisie met het verouderde concept, zonder de beloofde 409. Een transactie alleen voorkomt deze interleaving niet. Bescherm de check tot en met de write met bijvoorbeeld een rijlock, of gebruik serialiseerbare transacties met passende conflictverwerking. Voeg een test toe waarin de andere commit tussen de guard en de gedeelde write plaatsvindt; de huidige tests mockenwriteProductDocen missen dit scenario.plan gekoppeld via pr_refs: T-266, T-269, ST-082. Navigatie, detailweergave, bewerken, Publish en documentatie zijn aanwezig. De garantie dat een elders gewijzigde doc een 409 oplevert is door bovenstaande race nog niet volledig gerealiseerd.
Verificatie op commit
186080c3392d1d834a952776de0cfb7453994c4d:npm run verifygeslaagd (lint zonder errors, typecheck geslaagd; 220 testbestanden geslaagd, 4 overgeslagen; 2809 tests geslaagd, 66 overgeslagen). Daarnaast een deterministische reproductie uitgevoerd met de echte gedeelde write-laag en gesimuleerde database-reads voor bovenstaande interleaving: verwachtok:false, code:409, ontvangenok:true, revision:2en overschreven actuele inhoud. Deze aanvullende test faalt zoals beschreven; geen live database-concurrencytest uitgevoerd.Reactie op review ronde 3 (op
186080c), verwerkt ined5a9ca:__tests__/actions/rules-concurrency.test.tsgebruikt de echtewriteProductDocmet een nep-tx waarin een andere schrijver commit tussen onze guard en de read inwriteProductDoc. Resultaat: 409, geen create/update/revisie-insert.writeProductDocen diensmax(revision)-aggregaat levert een revisie max+1 op, dus geen botsing op de unieke index en geen 409. Dat venster is milliseconden groot en zit in de gedeelde laag (MCPcreate_product_docen de/context-editor delen het). Een structurele fix hoort in@sharedwriteProductDoc. Het restvenster staat indocs/pages/rules.mden in de PR-beschrijving.npm run verifyexit 0 oped5a9ca: 221 testbestanden geslaagd (4 overgeslagen), 2811 tests geslaagd (66 overgeslagen).REQUEST_CHANGES
actions/rules.ts:64: de revisiecheck en write zijn niet atomair. Als een andere writer revisie 2 commit tussen de interne read vanwriteProductDoc(revisie 1) en diensmax(revision)-query, slaagt de verouderde save als revisie 3 en vervangt die de actieve inhoud zonder 409. De unieke revisieconstraint voorkomt dit niet: het volgende nummer is dan 3. Maak de check/write atomair (bijvoorbeeld met passende locking of serializable-isolatie en conflictmapping naar 409) en test dit venster. De nieuwe concurrency-test dekt uitsluitend een commit vóór de interne read.Plan gekoppeld via pr_refs: T-266, T-269 en ST-082. Geen onderdelen weggelaten (
omittedleeg). Navigatie, detailweergave, scopebewaking, bewerken, Publish en documentatie zijn aanwezig; bovenstaande race schendt het afgesproken optimistic-concurrencygedrag.Verificatie op
ed5a9caad054a973b64fda8c689126bef890bc19:npm run verifygeslaagd — 221 testbestanden geslaagd, 4 overgeslagen; 2811 tests geslaagd, 66 overgeslagen. Eén bestaande lintwaarschuwing incomponents/jobs/job-card.tsx. Aanvullende tijdelijke reproductie met de echte@shared-schrijffunctie en gesimuleerde DB-interleaving bevestigt dat de stale save ten onrechte slaagt; geen echte parallelle DB-test uitgevoerd. Productpatroon voorwriteProductDocen stylingconventies geraadpleegd.