mirror of
https://github.com/deepseek-ai/deepseek-harness
synced 2026-08-15 21:04:50 +00:00
docs/persistence-catalog/log-events.md enumerates every SessionEventMap member — the owning dsh-session vocabulary plus the dsh-compact and dsh-hook-protocol declaration merges — with payload, surface/log-only badge, JSDoc prose, and declaration site. scripts/gen-persistence-catalog.ts is a pure AST pass in the gen-cordis-catalog mold: verify-persistence-catalog (--check) joins doc-sync, so a stale committed catalog fails pre-push and CI. The walk enforces JSDoc completeness (every member needs description prose; @mode is rejected as a category error — log events do not dispatch on the cordis bus), derives the surface badge from the SurfaceEventType union with a stale-member cross-check, and hard-errors on duplicate declarations. Payloads render through the TypeScript printer so newline-separated multi-line type literals still emit valid one-line fragments. Documented the five previously JSDoc-less core events (turn/step boundaries, tool/call), removed the two stray @mode tags on the hook/* merges, and replaced the hand-restated event enumerations (session.md hook/* table, compact README table, hook-protocol README bullets, session README name-list — whose merge note had already drifted) with links to the catalog. RFC: docs/rfc/implemented/process/2026-07-04-persistence-log-catalog.md.
18 lines
403 B
JSON
18 lines
403 B
JSON
{
|
|
"required": [
|
|
"README.md",
|
|
"docs/development.md",
|
|
"docs/i18n/README.md",
|
|
"docs/i18n/translation-rules.md",
|
|
"docs/rfc/implemented/process/2026-07-02-bilingual-docs-and-pairing-gate.md"
|
|
],
|
|
"excluded": [
|
|
"docs/AGENTS.md",
|
|
"docs/module-graph.md",
|
|
"docs/cordis-catalog/",
|
|
"docs/tool-catalog/",
|
|
"docs/persistence-catalog/",
|
|
"docs/i18n/terminology.md"
|
|
]
|
|
}
|