Repository navigation
Commit 7a08cbf
committed
docs(kernel): drop the Security row from the runtime-services Source-of-Truth list, and gate that list
`services.security` is ruled an internal accessor, not a publicly documented
runtime accessor (maintainer ruling, 2026-08-18). The chapter's Source-of-Truth
list carried `Security: packages/spec/src/contracts/security-service.ts` while
`services.security` was documented nowhere under `content/docs/`, so the list's
own sentence -- "Each page links the canonical TypeScript source used to derive
signatures" -- was false for exactly that row: a reader following it landed on a
contract file with nothing explaining the accessor.
The row is dropped. No page is created and the accessor is not relocated. A short
note in its place says where security really lives for a reader who needs it: the
permissions chapter for access decisions, `permissions/explain` for the one
in-process call, and `ISecurityService` in kernel contracts for the interface an
implementation must provide. Five of the chapter's six enumerations already
omitted Security (meta.json "pages", the chapter list, the kernel/index.mdx
table, versioning.mdx's Current Matrix, the Stability Legend), so this is the
whole edit -- nothing else in the chapter names it.
check-runtime-services-index gains a sixth claim rather than losing one. That
list was left unheld on purpose while this was an open product question: any rule
written over it -- an allowlist entry included -- would have answered the question
in a gate, and #9684 pinned that restraint with two self-test assertions. Now
that it is ruled, "one row per page" is decidable, so the limb is built and those
two pins are re-aimed at the answer: the page-less row is CAUGHT, and caught as a
canonical-source row rather than misread as a stability claim. Membership runs
both ways, duplicates are rejected, and each row's path must be a file that
exists. Row ORDER is deliberately not held -- unlike the chapter list and the
matrix, this list has never followed meta.json nav order, and enforcing it would
re-sort a published list to a convention it never had.
The existing six checks are untouched.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XqDQYVU5smx29ts9pAErja1 parent 55d2993 commit 7a08cbf
3 files changed
Lines changed: 238 additions & 37 deletions
File tree
- .github/workflows
- content/docs/kernel/runtime-services
- scripts
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
557 | 557 | | |
558 | 558 | | |
559 | 559 | | |
| 560 | + | |
| 561 | + | |
| 562 | + | |
| 563 | + | |
| 564 | + | |
| 565 | + | |
| 566 | + | |
| 567 | + | |
| 568 | + | |
| 569 | + | |
| 570 | + | |
560 | 571 | | |
561 | 572 | | |
562 | 573 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
46 | 46 | | |
47 | 47 | | |
48 | 48 | | |
49 | | - | |
50 | 49 | | |
51 | 50 | | |
52 | 51 | | |
| |||
55 | 54 | | |
56 | 55 | | |
57 | 56 | | |
| 57 | + | |
| 58 | + | |
| 59 | + | |
| 60 | + | |
| 61 | + | |
| 62 | + | |
| 63 | + | |
| 64 | + | |
58 | 65 | | |
59 | 66 | | |
60 | 67 | | |
| |||
0 commit comments