deepseek-harness/docs
Tianyi Cui e64623ebfd refactor(fs): prune write-only fields and the dead routing knob from the seam
The fs seam split left four pieces of pre-split surface populated on
every call and read by nobody:

- STREAM_MIN_SIZE + FsIoInternals.streamMinSize in dsh-fs-local: the
  backend has no read routing (readWholeText/streamWholeText are
  separate primitives the caller picks), and the real 10 MiB routing
  constant lives in dsh-tool-fs's read tool. Delete the dead mirror and
  the knob whose JSDoc claimed an override that did not exist; the
  remaining FsIoInternals knobs stay (the atomic-write tests use them).
- FsTarget.inputPath: a "diagnostics only" field every backend and test
  fake had to fabricate, with zero production readers (policy and error
  messages use targetKey/displayPath). listDir gave children the bare
  entry name, which was nobody's input.
- FsEditOutcome.replacements/.replaceAll: replacements had no reader
  (the single-match policy is enforced by the FS_AMBIGUOUS_EDIT /
  FS_EDIT_NOT_FOUND throws, whose message keeps the internal count);
  replaceAll only echoed the replace_all argument back to
  formatEditOutput, which now takes it from the parsed args. The
  outcome shrinks to { version, before, after }, parallel to
  FsWriteOutcome's backend-discovered fields. Emitted text is unchanged
  for both branches (no snapshot churn).
- FileReadOutcome.limit/.version: formatReadOutput renders
  offset/lines/totalLines/truncatedByBytes only, and the fs/observed
  emit uses info.version directly.

Backends shed four fabrication obligations and gain none. Doc pastes
(core-data-structures/filesystem.md), the dsh-fs README resolve row,
and the test fakes shrink with the types. RFC moved to
implemented/simplification and amended to the shipped shape
(FsEditSpec -> FsEditRequest name fix; manifest rows needed no change).
2026-07-04 15:37:43 +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 refactor(fs): prune write-only fields and the dead routing knob from the seam 2026-07-04 15:37:43 +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 refactor(fs): prune write-only fields and the dead routing knob from the seam 2026-07-04 15:37:43 +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