Skip to content

feat(dogfood): ADR-0056 D10 — authorization conformance matrix (CI-checked)#2071

Merged
os-zhuang merged 1 commit into
mainfrom
claude/adr-0056-d10-conformance
Jun 20, 2026
Merged

feat(dogfood): ADR-0056 D10 — authorization conformance matrix (CI-checked)#2071
os-zhuang merged 1 commit into
mainfrom
claude/adr-0056-d10-conformance

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

What (ADR-0056 D10 — authorization conformance matrix, the durable guardrail)

Encodes the ADR-0056 audit as a living, CI-checked artifact. One row per authorization primitive in exactly one honest state (enforced / experimental / removed); enforced rows name their runtime enforcement site, high-risk ones reference an end-to-end dogfood proof. A test asserts:

  • no duplicate ids; every primitive in a valid state;
  • every enforced primitive declares an enforcement site (no silent claims);
  • every experimental/removed primitive carries a rationale note;
  • every referenced dogfood proof file exists on disk (the ratchet);
  • the high-risk OWD/derived/anonymous/default-profile primitives each carry a proof.

This makes "the permission model is landed" a green CI gate — a new fail-open (an enforced row with no site) or a deleted proof breaks the build. It's the durable centerpiece of ADR-0056: the one-time audit can't rot.

Also recorded

An implementation-status table (D1/D2/D4/D6/D7/D8/D10 all landed) and the requireAuth default-flip readiness audit appended to the ADR:

  • Share links — SAFE: validated then read under a system context (not anonymous fail-open).
  • Control-plane — exempt (skip-paths).
  • Public forms — AT RISK: rely on a guest_portal profile that isn't built-in → the documented pre-requisite before any flip.

Verification

authz-conformance test 6/6. Dogfood-only + docs; no runtime change.

ADR-0056 program — complete

All decisions landed with proofs. The only remaining item is the release-gated requireAuth default flip, now fully scoped with a readiness audit + documented prerequisite (make public-form submit self-authorizing / ship a built-in guest_portal).

🤖 Generated with Claude Code


Generated by Claude Code

…ecked)

Encode the ADR-0056 audit as a living artifact: one row per authz primitive in
exactly one honest state (enforced/experimental/removed); enforced rows name an
enforcement site, high-risk ones reference an end-to-end dogfood proof. A test
asserts completeness + that every referenced proof file exists on disk — making
"the permission model is landed" a green CI gate (a new fail-open or a deleted
proof breaks the build). Also records the implementation status + the requireAuth
default-flip readiness audit (share-links safe; public forms need a built-in
guest_portal) in the ADR. 6/6 conformance tests pass.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XVdnfUAx85amkerym26vdx
@vercel

vercel Bot commented Jun 20, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
spec Ready Ready Preview, Comment Jun 20, 2026 9:31am

Request Review

@github-actions github-actions Bot added documentation Improvements or additions to documentation tests labels Jun 20, 2026
@github-actions

Copy link
Copy Markdown
Contributor

📓 Docs Drift Check

No hand-written docs reference the 1 changed package(s). ✅

@os-zhuang
os-zhuang marked this pull request as ready for review June 20, 2026 09:31
@os-zhuang
os-zhuang merged commit da6351e into main Jun 20, 2026
17 checks passed
@os-zhuang
os-zhuang deleted the claude/adr-0056-d10-conformance branch June 20, 2026 09:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/m tests

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants