Skip to content

docs(adr): re-point ADR-0066 D1's self-cite from ADR-0094 D5 - #8440

Merged
hotlong merged 1 commit into
mainfrom
claude/issue-8386-adr-0066-d5-cite
Aug 13, 2026
Merged

docs(adr): re-point ADR-0066 D1's self-cite from ADR-0094 D5#8440
hotlong merged 1 commit into
mainfrom
claude/issue-8386-adr-0066-d5-cite

Conversation

@qq9340100

Copy link
Copy Markdown
Collaborator

Part of #8386

docs/adr/0066-unified-authorization-model.md:45 — D1's own "Landed (2026-07)"
paragraph — closes on:

Aligns with ADR-0094 D5 (retire implicit managed_by-guessing).

ADR-0094 D5 ("Env-scope overlays of package-owned sets are FIRST-CLASS
customizations") never discusses capabilities, placeholder derivation, or
back-doors at all — grep -ni "capabilit\|guess\|back-door" over its body
(lines 197-236) returns no hits — and it is now RETIRED (#6858 / PR #6962),
so the cite sends readers to a section headed RETIRED 2026-08-09.

The claim is real and correct, and it is ADR-0066 D1's own direction: the
same paragraph already states "This retires the implicit back-door where a
capability existed only as an untitled placeholder derived from a permission
set's systemPermissions[] … DEFINE/GRANT/REQUIRE stay decoupled." Verified
against ADR-0094 D1 ("The metadata layer is the only authoritative store for
definitions") as the alternative candidate first — that decision is about
sys_permission_set projection, not capability/back-door retirement, so it
does not fit. ADR-0066 D1 does. One sentence changed, no other prose touched.

#8386 is not addressed here for its docs half — content/docs/permissions/authorization.mdx:190
carries the same wrong cite and lands separately as a normal-path PR: #8437.

This PR touches docs/adr/** and is therefore ADR-class per repo convention:
left draft, nothing armed (no auto-merge, no enqueue), awaiting a human
merge.

Tests

Local gates (scoped, per repo convention — CI runs the full farm):

  • pnpm check:docs-audit-scope — pass
  • pnpm check:adr-anchors — pass (48 anchored files, 23547 citations resolve)
  • node scripts/check-adr-links.mjs — pass (533 relative links resolve)
  • pnpm check:nul-bytes — pass
  • node scripts/pm/dispatch-gates.mjs docs/adr/0066-unified-authorization-model.md — re-derived; surfaces check:adr-anchors, check-adr-links.mjs, and check-adr-merge-approval.mjs (the last 401s locally without a token, per the dispatch prompt — expected, CI judges it)

Generated by Claude Code


Generated by Claude Code

…066 D1
ADR-0094 D5 ("Env-scope overlays of package-owned sets are FIRST-CLASS
customizations") never discusses capabilities, placeholder derivation,
or managed_by back-doors, and is now RETIRED (#6858 / PR #6962) — the
cite sent readers to a section headed RETIRED 2026-08-09. The claim
being attributed ("retire implicit managed_by-guessing") is ADR-0066
D1's own direction; this corrects the cross-reference.
Part of #8386
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Jqe56GnYFddggeAyfkZFVz
@qq9340100qq9340100 added the skip-changeset PR has no user-facing published change; bypasses the changeset gate label Aug 13, 2026 — with Claude
@vercel

vercelBot commented Aug 13, 2026

Copy link
Copy Markdown

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

1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
objectstackIgnoredIgnoredAug 13, 2026 1:12pm

Request Review

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentationsize/xsskip-changesetPR has no user-facing published change; bypasses the changeset gate

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@qq9340100@hotlong@claude