deepseek-harness/docs
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
..
cookbook fix(docs): address Codex review on the architecture rewrite 2026-07-04 16:28:38 +08:00
cordis-catalog Add JSDoc completeness gate for the cordis surface 2026-07-04 19:06:35 +08:00
core-data-structures fix(docs): address Codex review on the architecture rewrite 2026-07-04 16:28:38 +08:00
i18n docs: equal-authority pairing with sidecar consistency records 2026-07-03 07:41:24 -07:00
postmortem fix(docs): address Codex review round 3 — last three moved-policy citations 2026-07-04 16:02:39 +08:00
rfc Add JSDoc completeness gate for the cordis surface 2026-07-04 19:06:35 +08:00
tool-catalog Merge remote-tracking branch 'origin/master' into web-capability-seam 2026-07-03 16:49:00 +08:00
AGENTS.md Merge branch 'worktree-docs-overhaul-a-standard' into worktree-docs-overhaul-b-agents 2026-07-04 17:23:16 +08:00
architecture.md docs(architecture): rewrite the system map to the 1,800-word budget 2026-07-04 14:43:48 +08:00
defensive-patterns.md docs(AGENTS): rewrite the root standing orders to the 1,500-word budget 2026-07-04 14:22:47 +08:00
development.i18n.yaml feat(doc-standards): documentation tiers, budgets, and the ceiling gate 2026-07-04 13:53:43 +08:00
development.md feat(doc-standards): documentation tiers, budgets, and the ceiling gate 2026-07-04 13:53:43 +08:00
development.zh.md feat(doc-standards): documentation tiers, budgets, and the ceiling gate 2026-07-04 13:53:43 +08:00
module-graph.md Merge branch 'worktree-hooks-e-protocol' into worktree-hooks-f-bridges 2026-07-04 03:09:37 +08:00
testing.md fix(docs): address ds-review-bot — the e2e tier is not DeepSeek-only 2026-07-04 16:43:23 +08:00