[cixzhang]

Summary

• defines shared runtime roles for render, handlers, refs, Effects, external resources, node replacement, observation, lifecycle ownership, and broadcast identity
• keeps React techniques as guidance unless misuse causes observable correctness, ownership, cleanup, accessibility, or scale harm
• constrains Effects to external-system synchronization while allowing documented singletons and recommending Effect Events for non-reactive latest reads
• permits refs as general non-rendering mutable storage while preventing hidden rendered state
• delegates public ref / handleRef admission and naming, controlled/optimistic semantics, accessibility, styling, tooling, and public-hook identity to their existing owners

Audit-row coverage

Owned here:

• C5, C6, C19
• durable runtime outcomes from C1, C9, C10, C16, C22
• a narrow lifecycle/scale boundary informed by C7–C8

Explicitly delegated:

• C2, C13 → public API, family, and component contracts
• C3, C17 → accessibility, interaction, family, and component contracts
• C4, C11, C18, C21 → lint/contributor guidance unless an invariant is violated
• C12 → applicable primitive owner
• C14 → runtime state boundary here; public composition/introspection with API/component owners
• C15 → applicable registry/data owner
• C20 → style/token/component/interaction owner

Owner decisions

• Effects are constrained, not banned.
• Controlled props are not casually mirrored; current owners may define explicit optimistic seams.
• React owns rendered semantics; refs may hold general non-rendering mutable data.
• Effect Events are guidance for non-reactive latest reads, never hidden dependencies.
• Complex behavior remains with the stable lifecycle owner; private extraction is guidance, not policy.
• ref and handleRef may coexist, but their public naming/admission belongs to architecture:public-component-api; handle identity is unspecified.
• CSS-first and pooled observation are guidance; runtime owns lifecycle and unbounded-fan-out outcomes.

Overlap receipt

• Searched current records and open PRs by owner/id, Effects, refs, observers, controlled state, DOM ownership, and behavior seams.
• fix(Dialog): capture the opener only on the closed-to-open edge #5642 is a concrete Dialog lifecycle implementation and non-authoritative evidence, not overlapping shared authority.
• feat(theme): ordered environmental adaptations in defineTheme #5543 touches public-component-api for theme adaptations and does not own React runtime.
• docs: define RTL audit evidence policy #6046, docs: define bidirectionality design intent #6047, and docs(core): define the internationalization contract #6048 own RTL/bidirectionality/internationalization and are untouched.

Validation

• node scripts/check-knowledge.mjs
• pnpm check:sync
• Prettier
• git diff --check
• independent authority map and Matt-style exact-file review

The record is 226 lines because it carries an explicit audit-row ownership/delegation matrix; removing that routing would recreate duplicate authority.

No implementation, tooling, wiki, or audit-table changes. No changeset.

False-positive / false-negative audit

Initial current-code audit sampled 21 cases: 4 false-positive risks, 2 false-negative risks, 13 correct passes, and 2 cases without a current specimen. After the five wording fixes and two mutation expectations, the exact-head rerun classified all 19 concrete cases correctly: 0 false positives, 0 false negatives, 19 correct, with the 2 no-specimen cases covered by explicit node-replacement and N-consumer observer mutations.

[vercel]

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

Project	Deployment	Actions	Updated
astryx	Ready	Preview	Sep 8, 2026 12:27am UTC

[github-actions]

PR Analysis Report

📚 Storybook Preview

View Storybook for this PR
GitHub Pages may take up to a minute to hydrate after deploy.

🧪 Sandbox Preview

View Sandbox for this PR
GitHub Pages may take up to a minute to hydrate after deploy.

No new or modified components detected.

Bundle Size Summary

No component packages changed.

Accessibility Audit

Status: No accessibility violations detected.

---

_{Generated by PR Enrichment workflow | Storybook | Sandbox | View full report}

[cixzhang]

Closing as superseded by the owner direction to burn down audit gaps through amendments to existing canonical records rather than new architecture records. The researched clauses and row routing will be reused in smaller owner-specific amendment PRs.

[cixzhang]

/approve-spec 1270947

[cixzhang]

Reopened under Cindy’s latest explicit owner direction to finalize and merge this runtime authority. That direct approval supersedes the earlier amend-first closure for this PR.

[cixzhang]

/approve-spec 1270947

[cixzhang]

Semantic verdict: approve

This is good. The runtime boundaries are clear and keep public API, component behavior, and specialized systems with their existing owners.

[Reviewed by Robohands]