docs(tools): DiffResultView.diffs may be a whole-file diff, not only hunks

The write-diff-card fix made write's presentResult return an args-derived
whole-file diff (oldText:null) for a create / unchanged overwrite, but the
DiffResultView contract and its mirrored docs still said `diffs` is ALWAYS
the applied contextual hunks computed from before/after. Correct the type
JSDoc, the write execute-side comment, and the four mirrored surfaces
(tools.md, tools README, acp-feature-support, adding-a-tool cookbook) to
say: typically the applied hunks, or a whole-file diff when there is no
before-image (a create) — and that a mutation returns the diff result even
when it duplicates the call-time card, since a tool_call_update.content
replace would otherwise clobber the diff with the model-facing text.
Regenerate the cordis catalog (source line shift).

packages/core/tools/src/index.ts

@@ -220,19 +220,21 @@ export interface TerminalResultView {
 
 /**
  * A completed file mutation rendered as an inline diff card, the *result-time*
- * analogue of {@link DiffCallView}. Set by a tool whose `execute` applied a
- * file change (e.g. `write`, `edit`): `diffs` are the APPLIED hunks computed
- * from the before/after file content (one entry per hunk, each with surrounding
- * context lines), so the editor shows the real change with context — distinct
- * from the call-time whole-snippet {@link DiffCallView}. A `tool_call_update`'s
- * content REPLACES the call's content in an editor, so this result diff
- * supersedes the pending snippet.
+ * analogue of {@link DiffCallView}. Set by a tool whose `execute` applied a file
+ * change (e.g. `write`, `edit`): `diffs` are the change to show — typically the
+ * APPLIED hunks computed from the before/after content (one entry per hunk, each
+ * with surrounding context lines), so the editor shows the real change in place;
+ * a tool with no before-image (e.g. a file create) may instead give a whole-file
+ * diff (`oldText: null`). A `tool_call_update`'s content REPLACES the call's
+ * content in an editor, so a mutation tool returns this even when it duplicates
+ * the call-time snippet — otherwise the model-facing result text would replace
+ * (clobber) the pending diff card.
  */
 export interface DiffResultView {
   card: 'diff'
   /** Replacement title for the completed call. Omit to keep the pending-state title. */
   title?: string
-  /** One entry per applied hunk (a contextual diff), in file order. */
+  /** The change to show, in file order — applied contextual hunks, or a whole-file diff when there is no before-image. */
   diffs: FileDiff[]
 }