feat(rules): menu-item Rules + rules inzien/bewerken op /rules/[slug] (PBI-46) #168

Merged
janpeter merged 8 commits from feat/rules-menu-edit into main 2026-10-16 22:22:08 +02:00
Owner

Samenvatting

  • Menu-item Rules: losse link na Messages naar /rules (actief op /rules/<slug>).
  • Detailpagina /rules/[slug]: kop (basename, slug, agent, scope, doelpad, revisie N), inhoud opgemaakt/bron via MarkdownSourceView, Bewerken → editor met volledige content_md incl. frontmatter, Opslaan/Annuleren.
  • Opslaan via nieuwe saveRuleAction → @shared writeProductDoc (zelfde write-laag als MCP create_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.
  • Publish blijft een aparte stap (tabel én detailpagina); op de detailpagina uit zolang er onopgeslagen wijzigingen zijn.
  • Tabel: rule-naam linkt naar de detailpagina; ondertitel, docs/pages/rules.md, docs/pages/dashboard.md (navzin) en de stale kopcommentaar in lib/rules/sync.ts bijgewerkt.

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 verify exit 0 — Test Files 221 passed | 4 skipped (225), Tests 2811 passed | 66 skipped (2877) (baseline main: 217 / 2767).
  • Lokale next build exit 0; /rules en /rules/[slug] in de routelijst.
  • Niet getest: runtime tegen de echte DB / rule-docs.

Reviewronde 1 (s4m-codex-reviewer, REQUEST_CHANGES op 0a3aae7)

  • ERROR — tekstverlies bij doortypen tijdens opslaan: de editor is read-only zolang de save loopt (ook de onChange negeert invoer). Regressietest met uitgestelde save. → 5737d7a
  • WARNING — weergave volgt opgeslagen revisie niet: saveRuleAction leest binnen de transactie de opgeslagen (genormaliseerde) content_md terug en geeft die mee; de pagina en een heropende editor tonen die, inclusief de nieuwe last_updated. Regressietests in action en component. → 16ca0f2
  • Na de fixes: npm run verify exit 0 (220 files, 2806 tests), lokale next build exit 0.

Reviewronde 2 (s4m-codex-reviewer, REQUEST_CHANGES op 16ca0f2)

  • ERROR — revisiecheck vervalt bij null-token: @shared writeProductDoc controleert expected_revision_id alleen als het niet leeg is. saveRuleAction vergelijkt nu zelf strikt binnen de transactie (current_revision_id !== expectedRevisionId, ook null vs. revisie) en geeft bij mismatch 409 zonder writeProductDoc aan te roepen. Regressietests voor null↔revisie en revisie↔revisie (rood zonder fix), plus null/null schrijft wel. → 186080c
  • Geen test met de echte writeProductDoc: de guard draait daarvóór, en de tests bewijzen dat de write-laag bij een mismatch niet wordt aangeroepen. @shared en de /context-editor zijn niet gewijzigd (die heeft dezelfde null-semantiek).
  • Na de fix: npm run verify exit 0 (220 files, 2809 tests), lokale next build exit 0.

Reviewronde 3 (s4m-codex-reviewer, REQUEST_CHANGES op 186080c)

  • ERROR — race tussen guard en write bij null-token: terecht. Opslaan zonder revisie bij het laden (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
  • Nieuwe test __tests__/actions/rules-concurrency.test.ts met de echte writeProductDoc: een commit tussen onze guard en de read in writeProductDoc geeft 409 en geen write.
  • Bewust geen rijlock (besluit JP). Er blijft een restvenster bij een niet-leeg token: commit een andere schrijver tussen de token-read in writeProductDoc en diens max(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 MCP create_product_doc en 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 @shared writeProductDoc (rij vergrendelen vóór de token-check), niet alleen in deze action. Beschreven in docs/pages/rules.md.
  • Na de fix: npm run verify exit 0 (221 files, 2811 tests).

🤖 Generated with Claude Code

## Samenvatting - **Menu-item Rules**: losse link na *Messages* naar `/rules` (actief op `/rules/<slug>`). - **Detailpagina `/rules/[slug]`**: kop (basename, slug, agent, scope, doelpad, revisie N), inhoud opgemaakt/bron via `MarkdownSourceView`, **Bewerken** → editor met volledige `content_md` incl. frontmatter, **Opslaan**/**Annuleren**. - **Opslaan** via nieuwe `saveRuleAction` → `@shared` `writeProductDoc` (zelfde write-laag als MCP `create_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. - **Publish** blijft een aparte stap (tabel én detailpagina); op de detailpagina uit zolang er onopgeslagen wijzigingen zijn. - Tabel: rule-naam linkt naar de detailpagina; ondertitel, `docs/pages/rules.md`, `docs/pages/dashboard.md` (navzin) en de stale kopcommentaar in `lib/rules/sync.ts` bijgewerkt. 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 verify` exit 0 — Test Files 221 passed | 4 skipped (225), Tests 2811 passed | 66 skipped (2877) (baseline main: 217 / 2767). - Lokale `next build` exit 0; `/rules` en `/rules/[slug]` in de routelijst. - Niet getest: runtime tegen de echte DB / rule-docs. ## Reviewronde 1 (s4m-codex-reviewer, REQUEST_CHANGES op 0a3aae7) - **ERROR — tekstverlies bij doortypen tijdens opslaan**: de editor is read-only zolang de save loopt (ook de onChange negeert invoer). Regressietest met uitgestelde save. → `5737d7a` - **WARNING — weergave volgt opgeslagen revisie niet**: `saveRuleAction` leest binnen de transactie de opgeslagen (genormaliseerde) `content_md` terug en geeft die mee; de pagina en een heropende editor tonen die, inclusief de nieuwe `last_updated`. Regressietests in action en component. → `16ca0f2` - Na de fixes: `npm run verify` exit 0 (220 files, 2806 tests), lokale `next build` exit 0. ## Reviewronde 2 (s4m-codex-reviewer, REQUEST_CHANGES op 16ca0f2) - **ERROR — revisiecheck vervalt bij null-token**: `@shared` `writeProductDoc` controleert `expected_revision_id` alleen als het niet leeg is. `saveRuleAction` vergelijkt nu zelf strikt binnen de transactie (`current_revision_id !== expectedRevisionId`, ook null vs. revisie) en geeft bij mismatch 409 zonder `writeProductDoc` aan te roepen. Regressietests voor null↔revisie en revisie↔revisie (rood zonder fix), plus null/null schrijft wel. → `186080c` - Geen test met de echte `writeProductDoc`: de guard draait daarvóór, en de tests bewijzen dat de write-laag bij een mismatch niet wordt aangeroepen. `@shared` en de `/context`-editor zijn niet gewijzigd (die heeft dezelfde null-semantiek). - Na de fix: `npm run verify` exit 0 (220 files, 2809 tests), lokale `next build` exit 0. ## Reviewronde 3 (s4m-codex-reviewer, REQUEST_CHANGES op 186080c) - **ERROR — race tussen guard en write bij null-token**: terecht. Opslaan zonder revisie bij het laden (`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` - Nieuwe test `__tests__/actions/rules-concurrency.test.ts` met de **echte** `writeProductDoc`: een commit tussen onze guard en de read in `writeProductDoc` geeft 409 en geen write. - **Bewust geen rijlock (besluit JP).** Er blijft een restvenster bij een niet-leeg token: commit een andere schrijver tussen de token-read in `writeProductDoc` en diens `max(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 MCP `create_product_doc` en 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 `@shared` `writeProductDoc` (rij vergrendelen vóór de token-check), niet alleen in deze action. Beschreven in `docs/pages/rules.md`. - Na de fix: `npm run verify` exit 0 (221 files, 2811 tests). 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Losse link naar /rules direct na Messages; actief op /rules en
/rules/<slug>, aria-current alleen op /rules zelf.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
getRuleDocBySlug leest een MANUAL-doc van het rules-product via de
compound key (alleen claude-/codex-slugs) met het revisienummer.
saveRuleAction schrijft via @shared writeProductDoc een nieuwe
immutable revisie, guardt eerst het bestaan in de tx (nooit aanmaken)
en mapt fouten zoals saveProductDocAction. Verouderde header in
lib/rules/sync.ts bijgewerkt.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Server-page met admin-guard, notFound voor onbekende slugs en een
laadfout zoals de lijstpagina. RuleDetail toont kop, scope, doelpad en
revisie, de inhoud via MarkdownSourceView en een editor voor de hele
content_md (incl. frontmatter). Opslaan via saveRuleAction schuift het
concurrency-token door en ververst de route; Publish staat uit zolang
er onopgeslagen wijzigingen zijn.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
feat(rules): rule-naam linkt naar detailpagina, subtitel en paginadoc (T-269)
All checks were successful
CI / Verify (pull_request) Successful in 4m32s
0a3aae7a94
De rule-naam in de tabel linkt naar /rules/<slug>; Publish blijft per
rij. De subtitel noemt bekijken/bewerken via de detailpagina in plaats
van de Docs-UI/MCP. docs/pages/rules.md beschrijft de detailpagina,
saveRuleAction en de aangescherpte toegang.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
s4m-codex-reviewer requested changes 2026-10-16 20:28:20 +02:00
Dismissed
s4m-codex-reviewer left a comment

REQUEST_CHANGES

  • ERROR / P2 — app/(app)/rules/_components/rule-detail.tsx:66 — Tekstverlies bij doortypen tijdens opslaan. De textarea blijft bewerkbaar terwijl de save loopt. De save bewaart de draft van het klikmoment en sluit daarna de editor; opnieuw Bewerken vervangt de nieuwere draft door die oudere opgeslagen tekst. Tussentijdse invoer verdwijnt zonder waarschuwing. Maak de textarea tijdelijk niet bewerkbaar, of behoud nieuwere wijzigingen en laat de editor open. Voeg een regressietest met een uitgestelde save toe.
  • WARNING / P3 — app/(app)/rules/_components/rule-detail.tsx:63 — De weergegeven inhoud volgt de opgeslagen revisie niet volledig. writeProductDoc normaliseert last_updated, maar savedContent krijgt de ongenormaliseerde draft. router.refresh verandert de props, terwijl useState die niet opnieuw overneemt. Daardoor toont ook opnieuw Bewerken oude frontmatter. Neem na opslaan de canonieke serverinhoud over zonder nieuwere lokale wijzigingen te verliezen.

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 - **ERROR / P2 — app/(app)/rules/_components/rule-detail.tsx:66** — Tekstverlies bij doortypen tijdens opslaan. De textarea blijft bewerkbaar terwijl de save loopt. De save bewaart de draft van het klikmoment en sluit daarna de editor; opnieuw Bewerken vervangt de nieuwere draft door die oudere opgeslagen tekst. Tussentijdse invoer verdwijnt zonder waarschuwing. Maak de textarea tijdelijk niet bewerkbaar, of behoud nieuwere wijzigingen en laat de editor open. Voeg een regressietest met een uitgestelde save toe. - **WARNING / P3 — app/(app)/rules/_components/rule-detail.tsx:63** — De weergegeven inhoud volgt de opgeslagen revisie niet volledig. writeProductDoc normaliseert last_updated, maar savedContent krijgt de ongenormaliseerde draft. router.refresh verandert de props, terwijl useState die niet opnieuw overneemt. Daardoor toont ook opnieuw Bewerken oude frontmatter. Neem na opslaan de canonieke serverinhoud over zonder nieuwere lokale wijzigingen te verliezen. 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 0a3aae7a94ab2d64b22268f2a5f26bec5de9cb2e: 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.
De textarea bleef bewerkbaar terwijl saveRuleAction liep. De save stuurt
het concept van het klikmoment en sluit daarna de editor, waardoor tekst
die tijdens het opslaan werd getypt stil verdween. De editor is nu
readOnly zolang busy === 'save' en de onChange negeert wijzigingen in
die toestand, zodat ook programmatische change-events niets doorlaten.

Regressietest met een handmatig afgehandelde (deferred) save.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
fix(rules): canonieke inhoud na opslaan tonen (review #168)
All checks were successful
CI / Verify (pull_request) Successful in 2m33s
16ca0f26a9
writeProductDoc bewaart de genormaliseerde tekst (o.a. last_updated in de
frontmatter), maar de detailpagina zette savedContent op het lokale
concept. router.refresh() wijzigt wel de props, maar useState neemt die
niet opnieuw over, dus weergave en een volgende Bewerken toonden de oude
frontmatter.

saveRuleAction leest nu binnen dezelfde transactie de opgeslagen
content_md terug op doc_id (ook bij een noop) en geeft die mee in het
ok-resultaat. RuleDetail zet savedContent en het concept op die inhoud.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
s4m-codex-reviewer requested changes 2026-10-16 21:14:30 +02:00
Dismissed
s4m-codex-reviewer left a comment

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:

  • ERROR (blokkerend) — actions/rules.ts:67 — Een rule zonder huidige revisie wordt geladen met expectedRevisionId: null. Als een andere sessie daarna revisie 1 opslaat, geeft deze action nog steeds null door aan writeProductDoc. Die gedeelde functie controleert alleen een truthy expected_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 echte writeProductDoc en 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 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: - **ERROR (blokkerend)** — `actions/rules.ts:67` — Een rule zonder huidige revisie wordt geladen met `expectedRevisionId: null`. Als een andere sessie daarna revisie 1 opslaat, geeft deze action nog steeds null door aan `writeProductDoc`. Die gedeelde functie controleert alleen een truthy `expected_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 echte `writeProductDoc` en 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.
fix(rules): revisiecheck ook bij null-token (review #168)
All checks were successful
CI / Verify (pull_request) Successful in 4m32s
186080c339
@shared writeProductDoc checkt expected_revision_id alleen bij een
niet-leeg token. Een rule die zonder revisie geladen is, kon zo een
intussen elders geschreven revisie stil overschrijven. saveRuleAction
selecteert nu current_revision_id in de bestaanscheck en vergelijkt
strikt met het meegestuurde token; bij een verschil volgt een 409
vóór writeProductDoc.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
s4m-codex-reviewer requested changes 2026-10-16 21:43:46 +02:00
Dismissed
s4m-codex-reviewer left a comment

REQUEST_CHANGES

  • ERROR (blokkerend) — actions/rules.ts:56: De revisiecheck en de write zijn niet atomair beschermd tegen andere schrijvers. Bij de standaard PostgreSQL-isolatie vergrendelt deze findUnique de rij niet. Scenario: de guard leest current_revision_id = null; een andere schrijver commit een eerste revisie; vervolgens leest writeProductDoc die nieuwe revisie, maar slaat zijn controle over omdat expected_revision_id null 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 mocken writeProductDoc en 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 verify geslaagd (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: verwacht ok:false, code:409, ontvangen ok:true, revision:2 en overschreven actuele inhoud. Deze aanvullende test faalt zoals beschreven; geen live database-concurrencytest uitgevoerd.

# REQUEST_CHANGES - **ERROR (blokkerend)** — `actions/rules.ts:56`: De revisiecheck en de write zijn niet atomair beschermd tegen andere schrijvers. Bij de standaard PostgreSQL-isolatie vergrendelt deze `findUnique` de rij niet. Scenario: de guard leest `current_revision_id = null`; een andere schrijver commit een eerste revisie; vervolgens leest `writeProductDoc` die nieuwe revisie, maar slaat zijn controle over omdat `expected_revision_id` null 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 mocken `writeProductDoc` en 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 verify` geslaagd (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: verwacht `ok:false, code:409`, ontvangen `ok:true, revision:2` en overschreven actuele inhoud. Deze aanvullende test faalt zoals beschreven; geen live database-concurrencytest uitgevoerd.
fix(rules): opslaan zonder revisie weigeren (review #168)
All checks were successful
CI / Verify (pull_request) Successful in 4m29s
ed5a9caad0
saveRuleAction weigert een null-token (rule-doc zonder revisie bij het
laden) vóór elke DB-toegang: @shared writeProductDoc slaat zijn
revisiecheck over bij een leeg token, dus een intussen elders gecommitte
revisie kon stil overschreven worden. Opslaan kan pas na een eerste
revisie via de MCP (create_product_doc). Voor een niet-leeg token blijft
de strikte vergelijking in de tx staan; writeProductDoc leest de doc
daarna zelf opnieuw.

RuleDetail zet Bewerken uit voor een doc zonder revisie, met uitleg. De
server-guard blijft leidend. Nieuwe interleaving-test met de echte
writeProductDoc: een commit tussen onze guard-read en de read in
writeProductDoc geeft een 409 zonder write.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Author
Owner

Reactie op review ronde 3 (op 186080c), verwerkt in ed5a9ca:

  1. Null-token: opgelost door opslaan zonder revisie bij het laden te weigeren (geen DB-toegang, duidelijke melding; op de pagina staat Bewerken uit). Daarmee bestaat het pad "guard leest null → ander commit revisie 1 → writeProductDoc slaat de check over" niet meer.
  2. Gevraagde test met de echte write-laag: __tests__/actions/rules-concurrency.test.ts gebruikt de echte writeProductDoc met een nep-tx waarin een andere schrijver commit tussen onze guard en de read in writeProductDoc. Resultaat: 409, geen create/update/revisie-insert.
  3. Geen rijlock, bewust (besluit product owner). Er blijft een restvenster bij een niet-leeg token: een commit tussen de token-read in writeProductDoc en diens max(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 (MCP create_product_doc en de /context-editor delen het). Een structurele fix hoort in @shared writeProductDoc. Het restvenster staat in docs/pages/rules.md en in de PR-beschrijving.

npm run verify exit 0 op ed5a9ca: 221 testbestanden geslaagd (4 overgeslagen), 2811 tests geslaagd (66 overgeslagen).

Reactie op review ronde 3 (op 186080c), verwerkt in `ed5a9ca`: 1. **Null-token**: opgelost door opslaan zonder revisie bij het laden te weigeren (geen DB-toegang, duidelijke melding; op de pagina staat Bewerken uit). Daarmee bestaat het pad "guard leest null → ander commit revisie 1 → writeProductDoc slaat de check over" niet meer. 2. **Gevraagde test met de echte write-laag**: `__tests__/actions/rules-concurrency.test.ts` gebruikt de echte `writeProductDoc` met een nep-tx waarin een andere schrijver commit tussen onze guard en de read in `writeProductDoc`. Resultaat: 409, geen create/update/revisie-insert. 3. **Geen rijlock, bewust (besluit product owner).** Er blijft een restvenster bij een niet-leeg token: een commit tussen de token-read in `writeProductDoc` en diens `max(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 (MCP `create_product_doc` en de `/context`-editor delen het). Een structurele fix hoort in `@shared` `writeProductDoc`. Het restvenster staat in `docs/pages/rules.md` en in de PR-beschrijving. `npm run verify` exit 0 op `ed5a9ca`: 221 testbestanden geslaagd (4 overgeslagen), 2811 tests geslaagd (66 overgeslagen).
s4m-codex-reviewer left a comment

REQUEST_CHANGES

  • ERROR (blokkerend) — actions/rules.ts:64: de revisiecheck en write zijn niet atomair. Als een andere writer revisie 2 commit tussen de interne read van writeProductDoc (revisie 1) en diens max(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 (omitted leeg). Navigatie, detailweergave, scopebewaking, bewerken, Publish en documentatie zijn aanwezig; bovenstaande race schendt het afgesproken optimistic-concurrencygedrag.

Verificatie op ed5a9caad054a973b64fda8c689126bef890bc19: npm run verify geslaagd — 221 testbestanden geslaagd, 4 overgeslagen; 2811 tests geslaagd, 66 overgeslagen. Eén bestaande lintwaarschuwing in components/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 voor writeProductDoc en stylingconventies geraadpleegd.

# REQUEST_CHANGES - **ERROR (blokkerend)** — `actions/rules.ts:64`: de revisiecheck en write zijn niet atomair. Als een andere writer revisie 2 commit tussen de interne read van `writeProductDoc` (revisie 1) en diens `max(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 (`omitted` leeg). Navigatie, detailweergave, scopebewaking, bewerken, Publish en documentatie zijn aanwezig; bovenstaande race schendt het afgesproken optimistic-concurrencygedrag. Verificatie op `ed5a9caad054a973b64fda8c689126bef890bc19`: `npm run verify` geslaagd — 221 testbestanden geslaagd, 4 overgeslagen; 2811 tests geslaagd, 66 overgeslagen. Eén bestaande lintwaarschuwing in `components/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 voor `writeProductDoc` en stylingconventies geraadpleegd.
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-workers!168
No description provided.