feat(products): tab Toegang per product (IDEA-267 I1, M54) #397

Merged
janpeter merged 24 commits from feat/idea-267-toegang into main 2026-10-19 15:06:12 +02:00
Owner

IDEA-267 I1 — tab Toegang per product (M54)

Nieuwe tab Toegang in de productinstellingen. Per product staan daar de allowlist- en toegangsstappen: repo, Forgejo Actions-trust, agent-push en harness, review-dispatch, deploy, optioneel en tokens. Het overzicht is alleen-lezen, met vinkjes in de nieuwe tabel product_access_steps.

  • Spec: docs/specs/2026-10-18-idea-267-toegang-per-product.md (rev 7, delta D1).
  • Plan: docs/plans/M54-idea-267-toegang-per-product.md (rev 4 + V1-uitkomst).
  • Reviewrecords: docs/reviews/2026-10-18-idea-267-*.
  • Runbook: RUNBOOKS/product-toegang (product-doc).

Wat zit erin

  • lib/access-checklist/:
    • stappencatalogus (22 stappen);
    • repo-parsing;
    • trust-evaluatie. De parser spiegelt load_allowlist van de runner, dus True blijft een string en elke afwijkende vorm is fail-closed;
    • evaluateProductAccess;
    • statusbadges;
    • Forgejo-lezer (server-only, alleen voor beheerders, nooit token-logging);
    • DB-lader.
  • actions/access-checklist.ts: vinkjes zetten en weghalen. context_at_check komt uit de productrij en nooit uit invoer. D1: Gedaan op actions.trust_rollout bewaart de sha256 van de trust-YAML die de action zelf meet, en alleen als die gelijk is aan expectedTrustSha256 van de pagina. Anders volgt 409.
  • UI: tab Toegang (?tab=toegang, gestuurde tabs), een rode CI-blokkademelding per oorzaak, en één kaart per poort.
  • Markdown headingIds, zodat runbook-links op de juiste kop landen.
  • Na het aanmaken van een product kom je op de tab Toegang (T9).
  • DB:
    • vendor/scrum4me-shared → 8df7f2c0 (scrum4me-shared PR #85);
    • migratie 20261019120000_product_access_steps zonder GRANT;
    • additief contract public.table.product_access_steps.

Vóór de merge (JP)

  1. Zet FORGEJO_ACCESS_READ_TOKEN (janpeter, alleen read:repository) in /srv/scrum4me/repos/Scrum4Me/.env op srv. Op 2026-10-19 stond hij er nog niet in. Zonder token toont de tab "niet meetbaar (geen token)".
  2. CI-job queue-dispatch moet groen zijn. Die speelt de additieve migratie af en valt buiten npm run verify. Ook next build in CI moet groen zijn: dat bewaakt de server/client-grens.

Na de merge

  1. De deploy stopt met exit 3 op de nieuwe policy-hash. Keur hem goed met de Ops-flow Approve Policy Hash (approve_policy_hash) en controleer dat er geen UNCONTRACTED_OBJECT komt.
  2. Praktijkproef op thuis.jp-visser.nl, met MacSearch en Scrum4Me:
    • vergelijk de live stappen met Forgejo en met de trust-YAML;
    • vink stappen af;
    • test de runbook-links;
    • wissel van tab zonder te herladen (Algemeen → Toegang): het paneel moet het skeleton vervangen.

Verificatie

npm run verify is groen: lint zonder fouten, typecheck groen, 468 testbestanden met 5461 tests.

🤖 Generated with Claude Code

## IDEA-267 I1 — tab Toegang per product (M54) Nieuwe tab **Toegang** in de productinstellingen. Per product staan daar de allowlist- en toegangsstappen: repo, Forgejo Actions-trust, agent-push en harness, review-dispatch, deploy, optioneel en tokens. Het overzicht is alleen-lezen, met vinkjes in de nieuwe tabel `product_access_steps`. - Spec: `docs/specs/2026-10-18-idea-267-toegang-per-product.md` (rev 7, delta D1). - Plan: `docs/plans/M54-idea-267-toegang-per-product.md` (rev 4 + V1-uitkomst). - Reviewrecords: `docs/reviews/2026-10-18-idea-267-*`. - Runbook: RUNBOOKS/product-toegang (product-doc). ### Wat zit erin - `lib/access-checklist/`: - stappencatalogus (22 stappen); - repo-parsing; - trust-evaluatie. De parser spiegelt `load_allowlist` van de runner, dus `True` blijft een string en elke afwijkende vorm is fail-closed; - `evaluateProductAccess`; - statusbadges; - Forgejo-lezer (server-only, alleen voor beheerders, nooit token-logging); - DB-lader. - `actions/access-checklist.ts`: vinkjes zetten en weghalen. `context_at_check` komt uit de productrij en nooit uit invoer. **D1:** Gedaan op `actions.trust_rollout` bewaart de sha256 van de trust-YAML die de action zelf meet, en alleen als die gelijk is aan `expectedTrustSha256` van de pagina. Anders volgt 409. - UI: tab Toegang (`?tab=toegang`, gestuurde tabs), een rode CI-blokkademelding per oorzaak, en één kaart per poort. - Markdown `headingIds`, zodat runbook-links op de juiste kop landen. - Na het aanmaken van een product kom je op de tab Toegang (T9). - DB: - `vendor/scrum4me-shared` → 8df7f2c0 (scrum4me-shared PR #85); - migratie `20261019120000_product_access_steps` zonder GRANT; - additief contract `public.table.product_access_steps`. ### Vóór de merge (JP) 1. **Zet `FORGEJO_ACCESS_READ_TOKEN`** (janpeter, alleen `read:repository`) in `/srv/scrum4me/repos/Scrum4Me/.env` op srv. Op 2026-10-19 stond hij er nog niet in. Zonder token toont de tab "niet meetbaar (geen token)". 2. **CI-job `queue-dispatch`** moet groen zijn. Die speelt de additieve migratie af en valt buiten `npm run verify`. Ook `next build` in CI moet groen zijn: dat bewaakt de server/client-grens. ### Na de merge 3. De deploy stopt met exit 3 op de nieuwe policy-hash. Keur hem goed met de Ops-flow **Approve Policy Hash** (`approve_policy_hash`) en controleer dat er geen `UNCONTRACTED_OBJECT` komt. 4. Praktijkproef op thuis.jp-visser.nl, met MacSearch en Scrum4Me: - vergelijk de live stappen met Forgejo en met de trust-YAML; - vink stappen af; - test de runbook-links; - wissel van tab zonder te herladen (Algemeen → Toegang): het paneel moet het skeleton vervangen. ### Verificatie `npm run verify` is groen: lint zonder fouten, typecheck groen, 468 testbestanden met 5461 tests. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Beheerdersgrens voor Forgejo-metingen, exacte trust-match, afhankelijkheid per vinkje,
dispatch-poortvolgorde, URL-gestuurde tabs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Dispatch-poort volgens de multi-product-runbook (geen IDEA-233-blokkade), gestuurde tabs,
afhankelijkheid op live N.v.t., migratie-grants en policy-hash-goedkeuring.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Na het max2-incident van 2026-10-18 (agent-harness niet in writers: van
Scrum4Me, trust HARD, alle runners stil) gaf Toegang in het venster tussen
merge en uitrol een vals klaar. Gedaan op actions.trust_rollout bewaart nu
de sha256 van de door de action gemeten YAML; N.v.t. blijft aan repo_url.
Timertijden gecorrigeerd naar lokale tijd. Wacht op delta-review via CODEX.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
CODEX NO-GO (1 BLOCKER, 2 MINOR): de geaccepteerde race tussen pagina en
klik bracht het valse klaar terug. De action vergelijkt nu haar eigen
YAML-meting met de sha die de pagina toonde (409 bij verschil) en weigert
DONE zonder geldige Forgejo-repo. Bewijs voor de timer- en incidentclaims
in het record.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Volgorde van de validatie in de action volgt het server-action-patroon;
de vormcontrole op expectedTrustSha256 zit pas in het DONE-pad na de
beheerderscheck. F1 is niet apart gereviewd.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Beide aanmaakpaden (dialoog en /products/new) gaan na succes naar
/products/{id}/settings?tab=toegang, met een redirecttest per pad.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
ProductSettingsTabs volgt een activeTab-prop alleen bij een gewijzigde
waarde (vorige prop in state, geen useEffect) en schrijft bij een klik
?tab=<id> met router.replace. resolveSettingsTab accepteert alleen een
exacte tab-id en valt anders terug op algemeen.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- steps.ts: 22 stappen met poort, soort, eis, afhankelijkheid (incl. trust_yaml)
- repo-path.ts: parseRepoPath, alleen git.jp-visser.nl/<owner>/<repo>
- trust.ts: parseTrustScope spiegelt load_allowlist van de runner
  (True blijft string, blokreeks-writers en andere afwijkende vormen
  geven null); evaluateTrust volgt classify()

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- evaluate.ts: status per stap, poorten, samenvatting, CI-melding (urgent)
  en tokenIssues; ForgejoAccessReading staat hier, de lezer importeert hem
- D1: Gedaan op actions.trust_rollout alleen met gemeten trust-YAML;
  trustSha256 gaat mee naar de knop; DONE verouderd bij een andere sha
- status-badge.ts: labels en MD3-klassen; niet-meetbaar en n.v.t. neutraal

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- forgejo-read-server.ts (server-only): repo, collaborators, permissies en
  trust-YAML; voorrang admin_only > no_token > repo-URL vóór elke fetch;
  fail-closed redenen, geen logging van URL's of tokens
- readTrustYaml (D1): de enige plek die de trust-YAML leest, parset en
  hasht; render en action krijgen dezelfde sha
- FORGEJO_ACCESS_READ_TOKEN optioneel in lib/env.ts en .env.example
- repo-path.ts exporteert FORGEJO_HOST en SEGMENT voor de lezer

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- vendor/scrum4me-shared → 8df7f2c0 (merge van shared PR #85); schema via
  gen-schema: alleen ProductAccessStep, ProductAccessStepState en de
  back-relation op Product
- migratie 20261019120000_product_access_steps: enum, tabel, PK en FK met
  ON DELETE CASCADE; geen GRANT of REVOKE
- contract public.table.product_access_steps (web/preparedWeb CRUD) met
  migrationId; enum-type staat niet in de catalogus

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- setProductAccessStepAction: auth → validatie → eigenaar; context_at_check
  uit de productrij, nooit uit invoer; null = deleteMany
- D1: DONE op actions.trust_rollout alleen voor een beheerder, met een
  geldige expectedTrustSha256, een Forgejo-repo en een eigen meting via
  readTrustYaml die gelijk is aan die sha (anders 403/422/409)
- loadAccessFacts (server-only): eigenaar-product, harness-keuzes, eigen
  geldige tokens zonder token_hash, en de vinkjes

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
feat(products): tab Toegang met checklistpaneel (IDEA-267 T8)
All checks were successful
CI / DB Access Policy Gate (pull_request) Successful in 1m45s
CI / Queue Dispatch Guard Gate (pull_request) Successful in 2m20s
CI / Lint, Typecheck, Test & Build (pull_request) Successful in 4m45s
CI / DB Access Production Sentinel (pull_request) Successful in 50s
ec0f6d26fe
- ToegangTabContent: skeleton op een inactieve tab, Suspense + paneel
  alleen als ?tab=toegang (geen Forgejo-calls op andere tabs)
- AccessChecklistPanel: loadAccessFacts → readForgejoAccess →
  evaluateProductAccess; rode CI-melding per oorzaak (spec §4.2),
  samenvatting en één kaart per poort
- AccessStepButtons: Gedaan / N.v.t. / Ongedaan maken; Gedaan op
  actions.trust_rollout stuurt expectedTrustSha256 mee (D1)
- instellingenpagina: ?tab= via resolveSettingsTab, gestuurde tabs
- Markdown headingIds (rehype-slug) voor de runbook-ankers in product-docs

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

APPROVED

Geen blokkerende findings gevonden op commit ec0f6d26fe.

Findings:

  • MINOR (niet blokkerend) — actions/access-checklist.ts:17: setStepSchema staat inline in de action. Het productpatroon patterns/server-action schrijft Zod-schema's onder lib/schemas/*.ts voor. Verplaats het schema daarheen voor patroonconformiteit; het huidige validatiegedrag is correct.

Plan: plan gekoppeld via pbi. Getoetst aan M54 / IDEA-267 I1 en spec revisie 7, inclusief delta D1. De diff past bij de beschreven PR-scope: catalogus, metingen, evaluatie, opslag, tabs, aanmaakpaden en runbook-ankers. De beheerders-/eigenaarsgrenzen, contextafhankelijke veroudering en weigering bij een gewijzigde trust-YAML zijn geïmplementeerd en getest. Het gepubliceerde runbook bevat alle 22 stapkoppen. Uitrol, policy-hashgoedkeuring en praktijkproef zijn expliciet vervolgwerk in de PR; deze review bevestigt geen live-acceptatie.

Verificatie: exacte PR-head lokaal uitgecheckt, inclusief shared-submodule. Lint: 0 fouten (8 waarschuwingen buiten de gewijzigde bestanden). De eerste lokale typecheck bereikte de Node-heaplimiet; opnieuw uitgevoerd met NODE_OPTIONS=--max-old-space-size=6144 npm run typecheck: geslaagd. npm test -- --maxWorkers=2: 468 bestanden geslaagd, 4 overgeslagen; 5461 tests geslaagd, 38 overgeslagen. Live-DB-tests zijn lokaal overgeslagen wegens ontbrekende testdatabase. Alle vier Forgejo-CI-gates op deze head zijn groen: Lint/Typecheck/Test/Build, DB Access Policy, Queue Dispatch Guard en DB Access Production Sentinel.

# APPROVED Geen blokkerende findings gevonden op commit ec0f6d26fe2c28b403151dada816e5829b6f034a. Findings: - **MINOR (niet blokkerend)** — `actions/access-checklist.ts:17`: `setStepSchema` staat inline in de action. Het productpatroon `patterns/server-action` schrijft Zod-schema's onder `lib/schemas/*.ts` voor. Verplaats het schema daarheen voor patroonconformiteit; het huidige validatiegedrag is correct. **Plan:** plan gekoppeld via pbi. Getoetst aan M54 / IDEA-267 I1 en spec revisie 7, inclusief delta D1. De diff past bij de beschreven PR-scope: catalogus, metingen, evaluatie, opslag, tabs, aanmaakpaden en runbook-ankers. De beheerders-/eigenaarsgrenzen, contextafhankelijke veroudering en weigering bij een gewijzigde trust-YAML zijn geïmplementeerd en getest. Het gepubliceerde runbook bevat alle 22 stapkoppen. Uitrol, policy-hashgoedkeuring en praktijkproef zijn expliciet vervolgwerk in de PR; deze review bevestigt geen live-acceptatie. **Verificatie:** exacte PR-head lokaal uitgecheckt, inclusief shared-submodule. Lint: 0 fouten (8 waarschuwingen buiten de gewijzigde bestanden). De eerste lokale typecheck bereikte de Node-heaplimiet; opnieuw uitgevoerd met `NODE_OPTIONS=--max-old-space-size=6144 npm run typecheck`: geslaagd. `npm test -- --maxWorkers=2`: 468 bestanden geslaagd, 4 overgeslagen; 5461 tests geslaagd, 38 overgeslagen. Live-DB-tests zijn lokaal overgeslagen wegens ontbrekende testdatabase. Alle vier Forgejo-CI-gates op deze head zijn groen: Lint/Typecheck/Test/Build, DB Access Policy, Queue Dispatch Guard en DB Access Production Sentinel.
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!397
No description provided.