deepseek-harness/docs
Tianyi Cui d8fd3225af feat(tool-fs): result-time applied-hunk diffs for write/edit
fs write/edit now emit a result-time contextual-diff tool_call_update
(the applied hunk with ±3 context lines, one hunk per replace_all site),
matching what claude-agent-acp sends and what makes an editor render the
change in place. The call-time snippet diff stays; the result hunk
supersedes it (ACP content-replace).

Mechanism:
- A persisted tool-private `meta` channel: execute may return
  `{ content, meta }`; `meta` (JsonValue) rides on the tool/result event
  and is handed back to presentResult, so the diff reproduces on replay
  (event-sourced). JsonValue is now exported from dsh-session.
- The backend returns raw before/after text (storage facts) on
  FsWriteOutcome/FsEditOutcome; the tool computes the hunk via the npm
  `diff` package's structuredPatch. A create has no before → no result
  diff; a failed/aborted mutation carries no meta.
- ToolResultView gains a DiffResultView; the bridge's result-side switch
  renders it as {type:'diff'} content blocks.

RFC: docs/rfc/implemented/architecture/2026-07-02-result-time-applied-hunk-diffs.md
(justifies the npm `diff` runtime dep over vendoring and the meta channel);
the render-intent-union RFC's Non-goal is updated to record this shipped.
All fs snapshot goldens re-recorded; edit/overwrite gain the contextual
result diff, create/read/policy-reject unchanged in structure.
2026-07-03 17:12:00 +08:00
..
cookbook refactor(tools): tagged render-intent union for tool-call presentation 2026-07-03 02:04:03 +08:00
cordis-catalog feat(tool-fs): result-time applied-hunk diffs for write/edit 2026-07-03 17:12:00 +08:00
core-data-structures feat(tool-fs): result-time applied-hunk diffs for write/edit 2026-07-03 17:12:00 +08:00
i18n docs(i18n): address round-2 terminology review 2026-07-01 23:08:45 +08:00
postmortem Fix doc cross-links for the hierarchy; add package-path + shape gates 2026-06-20 23:12:14 +08:00
rfc feat(tool-fs): result-time applied-hunk diffs for write/edit 2026-07-03 17:12:00 +08:00
tool-catalog docs(tool-catalog): register dsh-tool-fs in the boot manifest 2026-07-02 09:30:04 +08:00
AGENTS.md docs(rfc): classify RFCs by kind via path-encoded subdirectories 2026-06-20 22:29:45 +08:00
architecture.md feat(coding-agent): wire the filesystem tools into the demo 2026-07-02 19:46:59 +08:00
development.md docs: address review sync gaps 2026-07-01 12:56:13 +08:00
module-graph.md feat(tool-fs): result-time applied-hunk diffs for write/edit 2026-07-03 17:12:00 +08:00