Skip to content

docs(kernel): drop the Security row from the runtime-services Source-of-Truth list, and gate that list#9861

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
os-steve merged 1 commit into from
Aug 19, 2026
+238 −37
Merged

docs(kernel): drop the Security row from the runtime-services Source-of-Truth list, and gate that list #9861

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions .github/workflows/lint.yml
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -557,6 +557,17 @@ jobs:
# too, and holds every stability LABEL it and the kernel/index.mdx table
# publish to the page's own Stability bullet. That second half catches a
# WRONG row, which membership checking passes silently.
#
# #9629 closed the last gap. The chapter's "Source of Truth" canonical-source
# list -- a SIXTH enumeration -- was deliberately left unheld while
# `services.security` was an open product question: it carried a row for a
# service with no page, and any rule written over the list would have
# answered that question in a gate rather than by ruling. The 2026-08-18
# maintainer ruling made the accessor internal, the row is dropped, and the
# list is now held to the pages too -- one row per page, labelled with the
# accessor, each path a file that exists. Row ORDER is deliberately still
# not held: unlike the chapter list and the matrix, this list has never
# followed meta.json nav order.
- name: Runtime-services indexes enumerate the chapter's real pages
run: pnpm check:runtime-services-index

Expand Down
9 changes: 8 additions & 1 deletion content/docs/kernel/runtime-services/index.mdx
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -46,7 +46,6 @@ This chapter documents the runtime `services.*` APIs used in hook/action/flow/pl
Each page links the canonical TypeScript source used to derive signatures.

- Data: `packages/client/src/index.ts`
- Security: `packages/spec/src/contracts/security-service.ts`
- Sharing: `packages/spec/src/contracts/sharing-service.ts`
- Queue: `packages/spec/src/contracts/queue-service.ts`
- Email: `packages/spec/src/contracts/email-service.ts`
Expand All@@ -55,6 +54,14 @@ Each page links the canonical TypeScript source used to derive signatures.
- Settings: `packages/services/service-settings/src/settings-service.ts`
- Audit: `packages/plugins/plugin-audit/src/auth-event-audit.ts`

`services.security` is **not** on this list. The kernel registers a `security` service,
but it is an internal accessor rather than a documented runtime service, so this chapter
has no page for it. For access decisions read the
[permissions guide](/docs/permissions) — the one in-process call most readers need is
shown in [Explain Access](/docs/permissions/explain) — and the interface an
implementation must provide, `ISecurityService`, is listed with the other
[kernel contracts](/docs/kernel/contracts).

<Callout type="warn" title="Not this: the settings audit sink">
A second audit shape shares the word and is easy to reach for by mistake.
`SettingsAuditSink` — canonical source
Expand Down
Loading
Loading