Found while implementing #9534 (rewriting content/docs/kernel/runtime-services/audit-service.mdx around the real audit slot). Not fixed there: that card's dispatch pinned the file surface to the audit-service page alone, so this second file was reported rather than ridden along.
What is wrong
content/docs/kernel/runtime-services/index.mdx:46 carries a canonical-source pointer:
- Audit bridge: `packages/services/service-settings/src/settings-service.types.ts`
That is SettingsAuditSink — a constructor-injected sink that service-settings receives directly (settings-service-plugin.ts, via buildConfigChangeAuditSink). It is never registered as, or resolved from, the kernel audit slot.
The slot's only registrant is AuditPlugin (packages/plugins/plugin-audit/src/audit-plugin.ts:117), registering createAuthEventAuditSink(...), whose canonical source is packages/plugins/plugin-audit/src/auth-event-audit.ts.
This is the identical defect #9534 recorded, one file up. Line 21 of the same page lists services.audit among the runtime service slots, so the page names the slot and then points at the wrong type for it.
Why it is worth a card now
Before #9534 the index line was at least consistent with the page it links to — both described the settings sink. After #9534 the two contradict each other: audit-service.mdx documents recordAuthEvent / 'login' | 'logout' with the plugin-audit canonical source, while the index still sends a reader to settings-service.types.ts for the same slot. A reader who trusts the index lands on a type the slot never returns.
Suggested fix
Repoint line 46 at packages/plugins/plugin-audit/src/auth-event-audit.ts. If the settings sink deserves its own line, name it as the constructor-injected SettingsAuditSink it is, not as the services.audit bridge.
⚠️ Small scope, stated plainly: one line in a hand-written content/docs/** index page, no published artifact involved.
Refs: #9534 · PR #9587
Found while implementing #9534 (rewriting
content/docs/kernel/runtime-services/audit-service.mdxaround the realauditslot). Not fixed there: that card's dispatch pinned the file surface to theaudit-servicepage alone, so this second file was reported rather than ridden along.What is wrong
content/docs/kernel/runtime-services/index.mdx:46carries a canonical-source pointer:That is
SettingsAuditSink— a constructor-injected sink thatservice-settingsreceives directly (settings-service-plugin.ts, viabuildConfigChangeAuditSink). It is never registered as, or resolved from, the kernelauditslot.The slot's only registrant is
AuditPlugin(packages/plugins/plugin-audit/src/audit-plugin.ts:117), registeringcreateAuthEventAuditSink(...), whose canonical source ispackages/plugins/plugin-audit/src/auth-event-audit.ts.This is the identical defect #9534 recorded, one file up. Line 21 of the same page lists
services.auditamong the runtime service slots, so the page names the slot and then points at the wrong type for it.Why it is worth a card now
Before #9534 the index line was at least consistent with the page it links to — both described the settings sink. After #9534 the two contradict each other:
audit-service.mdxdocumentsrecordAuthEvent/'login' | 'logout'with the plugin-audit canonical source, while the index still sends a reader tosettings-service.types.tsfor the same slot. A reader who trusts the index lands on a type the slot never returns.Suggested fix
Repoint line 46 at
packages/plugins/plugin-audit/src/auth-event-audit.ts. If the settings sink deserves its own line, name it as the constructor-injectedSettingsAuditSinkit is, not as theservices.auditbridge.content/docs/**index page, no published artifact involved.Refs: #9534 · PR #9587