deepseek-harness/docs
Tianyi Cui 48d25cdd44 Fix review findings: validate the hooks cap, integer read caps, doc drift, config plumb-through test
A Codex review pass on the draft caught four real gaps and two solid
suggestions; all addressed except one pushed back on the merits:

- hooks-claude/hooks-codex: stderrSummaryMaxChars was the one new knob
  with NO range validation — a negative/NaN cap would silently
  misbehave inside slice(). Both bridges now assert a positive integer
  at the TOP of apply() (before the config-file parse's early return,
  so a bad value fails the load loudly), with rejection tests.
- tool-fs: the read caps count lines/chars/bytes, so positive-FINITE
  was too loose (a fractional readLimit would flow into windowing
  arithmetic and the schema description). All four now require a
  positive integer, matching tool-web's cap.
- Doc drift the gates cannot catch: tool-web's README tools table
  still named WEB_SEARCH_MAX_RESULTS as the mechanism; compact-basic's
  README/module doc and the compaction-capability-seam RFC still
  described estimation as fixed char/4 rather than the charsPerToken
  default.
- subagent-acp: the dispose graces were tested only at the
  startAcpRun level, so a regression that stopped threading plugin
  config into AcpRunSpec would have survived. A provider-path test now
  drives the trap-escalation scenario through ctx.subagents.start with
  small config graces and bounds dispose at 4s.

Pushed back on: converting compact-basic's charsPerToken to a
schemastery field. The package's whole config is deliberately
hand-rolled (resolveConfig, every threshold REQUIRED with no default —
a documented design posture); one schemastery field beside it would be
incoherent. The knob is cordis.yml-reachable, defaulted, and validated,
which is what the convention requires; migrating the package to
schemastery wholesale is pre-existing config-surface hygiene out of
this change's scope.
2026-07-04 18:06:35 +08:00
..
cookbook Merge branch 'worktree-hooks-f-bridges' into worktree-hooks-g-stream-chunk 2026-07-04 03:21:00 +08:00
cordis-catalog Merge branch 'worktree-hooks-f-bridges' into worktree-hooks-g-stream-chunk 2026-07-04 03:21:00 +08:00
core-data-structures Expose audited hardcoded tunables as plugin config 2026-07-04 17:37:23 +08:00
i18n docs: equal-authority pairing with sidecar consistency records 2026-07-03 07:41:24 -07:00
postmortem Fix doc cross-links for the hierarchy; add package-path + shape gates 2026-06-20 23:12:14 +08:00
rfc Fix review findings: validate the hooks cap, integer read caps, doc drift, config plumb-through test 2026-07-04 18: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 docs(rfc): classify RFCs by kind via path-encoded subdirectories 2026-06-20 22:29:45 +08:00
architecture.md Merge branch 'worktree-hooks-f-bridges' into worktree-hooks-g-stream-chunk 2026-07-04 03:21:00 +08:00
development.i18n.yaml docs: rename coding demo to repl 2026-07-04 01:07:26 +08:00
development.md docs: rename coding demo to repl 2026-07-04 01:07:26 +08:00
development.zh.md docs: rename coding demo to repl 2026-07-04 01:07:26 +08:00
module-graph.md Merge branch 'worktree-hooks-e-protocol' into worktree-hooks-f-bridges 2026-07-04 03:09:37 +08:00