deepseek-harness/docs/rfc/implemented/process
Tianyi Cui a29bbe1453 Add JSDoc completeness gate for the cordis surface
gen-cordis-catalog now hard-errors (aggregated, not fail-fast) when an
event lacks description prose or a payload @param, or a public service
method lacks JSDoc, a @param per parameter, a @returns on a non-void
result, or an explicit return type annotation. The this receiver and the
trailing waterfall next are exempt on events (mode machinery owned by
@mode); a stale @param naming no real parameter errors, mirroring the
@mode contradiction check. parseJsDoc now ends prose at the first block
tag (standard JSDoc semantics), so the tags never change the rendered
catalog — only Source: line pointers moved.

Fills the ~139 gaps found across the 15 surface files, extends the spec
with negative-path fixtures for every new guard plus the exemptions,
records the decision as an implemented process RFC, and extends the
AGENTS.md typed-events bullet with the authoring rule. Runs inside
verify-cordis-catalog -> doc-sync, so CI and pre-push enforce it with
zero new wiring.
2026-07-04 19:06:35 +08:00
..
2026-06-11-doc-sync-enforcement.md fix(docs): address Codex review round 1 on the AGENTS.md rewrite 2026-07-04 15:11:49 +08:00
2026-06-11-quality-gates.md Use explicit ts specifiers for declarations 2026-06-22 06:11:00 +08:00
2026-06-11-tsdown-over-dumble.md Merge remote-tracking branch 'origin/master' into feat/adr0016-type-build-check 2026-06-22 00:35:51 +08:00
2026-06-11-vendor-cordis-as-source.md docs(rfc): classify RFCs by kind via path-encoded subdirectories 2026-06-20 22:29:45 +08:00
2026-06-16-pnpm-over-yarn.md docs(rfc): classify RFCs by kind via path-encoded subdirectories 2026-06-20 22:29:45 +08:00
2026-06-17-ts-build-config.md docs: update rewriteRelativeImportExtensions to current rfc 2026-06-22 09:03:28 +08:00
2026-06-18-markdown-cross-link-lint.md docs(rfc): classify RFCs by kind via path-encoded subdirectories 2026-06-20 22:29:45 +08:00
2026-06-20-core-data-structures-catalog.md refactor(tools): tagged render-intent union for tool-call presentation 2026-07-03 02:04:03 +08:00
2026-06-20-generated-cordis-catalog.md fix(compact): address PR 110 review findings 2026-06-29 16:02:27 +08:00
2026-06-20-rfc-classification.md docs(rfc): classify RFCs by kind via path-encoded subdirectories 2026-06-20 22:29:45 +08:00
2026-07-02-bilingual-docs-and-pairing-gate.i18n.yaml docs: equal-authority pairing with sidecar consistency records 2026-07-03 07:41:24 -07:00
2026-07-02-bilingual-docs-and-pairing-gate.md docs: equal-authority pairing with sidecar consistency records 2026-07-03 07:41:24 -07:00
2026-07-02-bilingual-docs-and-pairing-gate.zh.md docs: equal-authority pairing with sidecar consistency records 2026-07-03 07:41:24 -07:00
2026-07-02-tool-schema-catalog.md fix(docs): address Codex review round 2 — repoint every remaining moved-policy citation 2026-07-04 15:43:51 +08:00
2026-07-04-cordis-jsdoc-completeness-gate.md Add JSDoc completeness gate for the cordis surface 2026-07-04 19:06:35 +08:00
2026-07-04-doc-tiers-and-budgets.md Merge branch 'worktree-docs-overhaul-b-agents' into worktree-docs-overhaul-c-architecture 2026-07-04 17:26:12 +08:00