docs(adr): status-hygiene sweep — fix 0096 collision, flip implemented statuses, mark PRIORITIZATION stale#3032
Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
…d statuses, mark PRIORITIZATION stale Follow-up to the ADR-0086 re-evaluation (#2557): an audit of docs/adr found three hygiene defects; this fixes the mechanical ones. 1. Resolve the ADR-0096 numbering collision. Two unrelated ADRs landed as 0096 on the same day; the first-merged one (execution-surface identity admission, #2975) keeps 0096, and the connector ADR (#2977) is renumbered to ADR-0097. All connector-semantic "ADR-0096" references in code comments, test titles, and zod describe/message strings are updated to ADR-0097; execution-surface references (http-dispatcher, authz-conformance, graphql/realtime contracts, service-realtime README) are untouched. CHANGELOGs and commit history are left as historical record. 2. Flip Status lines of implemented ADRs that were still Proposed, with evidence: 0093 (tenancy service + membership reconciler + dogfood test) and 0095 (tenant-layer.ts + posture-ladder.ts + matrix-gate tests). Verified code+tests on main before flipping; other stale-looking ADRs (0049/0056/0057/0066/...) are left for per-ADR verification. 3. Mark docs/adr/PRIORITIZATION.md as a historical snapshot (it predates ADR-0050+) and record the status-hygiene rule: the PR that lands an ADR's implementation flips its Status line with one line of evidence.
os-zhuang
force-pushed
the
claude/auth-model-design-eval-xxgzcl
branch
from
July 16, 2026 08:36
f7549b3 to
fc64552
Compare
github-actions
Bot
added
documentation
Contributor
📓 Docs Drift CheckThis PR changes 3 package(s): 99 hand-written doc(s) reference the affected code and may need an implementation-accuracy re-verification:
|
os-zhuang
added a commit
that referenced
this pull request
Jul 16, 2026
…d 0097 collision (#3070) The #3032 sweep renumbered the connector ADR 0096→0097 while the pinyin-search ADR had landed as 0097 the same day. Connector ADR keeps 0097 (125 propagated references); pinyin moves to the free 0098 slot. Pinyin-semantic references updated in all three places they exist (ADR file, environment-variables.mdx, unreleased changeset); CHANGELOG history untouched.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Follow-up to the ADR-0086 re-evaluation (#2557 / #3011). An audit of
docs/adr/againstmainfound three hygiene defects; this PR fixes the mechanical ones.1. ADR-0096 numbering collision resolved
Two unrelated ADRs landed as 0096 on the same day. First-merged keeps the number:
0096-execution-surface-identity-admission.md(ADR-0096 (execution-surface identity admission) + fixes for the 3 confirmed-exploitable holes it surfaced (#2980, #2981, #2982) #2975, merged first) — keeps 0096.0096-declarative-connector-instances.md(Implement ADR-0096: declarative connector instances (provider-boundconnectors:materialized by generic executors) #2977) — renumbered to ADR-0097.All connector-semantic
ADR-0096references (code comments, test titles, zoddescribe/messagestrings acrossspec/integration,service-automation, the three connector packages, andapp-showcase) are updated toADR-0097. Execution-surface references (http-dispatcher,authz-conformance.*,graphql/realtimecontracts,service-realtimeREADME) are untouched — each site was classified by context before the rename. CHANGELOGs and commit history are left as historical record.No behavior change: the renamed strings are documentation text; no test asserts the old literals (verified by grep; the affected
connector-provider/connector-materialization/connector-descriptor-auditsuites were re-run).2. Implemented-but-still-Proposed statuses flipped (verified code + tests only)
plugin-auth/src/tenancy-service.ts,reconcile-membership.ts,membership-reconciler.dogfood.test.ts).plugin-security/src/tenant-layer.ts,core/src/security/posture-ladder.ts,authz-matrix-gate.test.ts+posture-ladder.test.ts, tracking(authz): 双轨赛道下的授权改进开发任务 v2（内核链 ADR 待编号 + 补齐轨 + 地基） #2920 B1–B4).The audit also flagged ~15 more heavily-referenced Proposed ADRs (0049/0056/0057/0066/…) as likely implemented, but by reference-density proxy only — those are deliberately not flipped here; each needs per-ADR verification before its status moves.
3. PRIORITIZATION.md marked as a historical snapshot
It predates ADR-0050+ (dated 2026-06-12, scoped to "all 49 ADRs"; the directory now reaches 0097). A banner records this and adopts a status-hygiene rule: the PR that lands an ADR's implementation flips that ADR's
Status:line with one line of evidence — the ADR-0078 no-silently-stale discipline applied to the ADRs themselves.🤖 Generated with Claude Code
Generated by Claude Code