docs: finish the whole-file-diff sweep across comments and RFCs

Codex's stale-prose pass found seven more spots still describing the
result diff as ALWAYS an applied contextual hunk, or a create/binary
overwrite as rendering "only the call-time card": the DiffCallView JSDoc
and the acp bridge diff-arm comment, the FsWriteOutcome.before and
readTextForDiff JSDoc, and three RFC lines. All now say: the result diff
is the applied change — a contextual hunk when there is a before-image,
else a whole-file diff (create / undiffable binary) — and a successful
mutation always returns the result diff so the model-facing text can't
clobber it. Regenerate the cordis catalog (source line shift).

packages/core/tools/src/index.ts

@@ -159,8 +159,9 @@ export interface TerminalCallView {
  * A call that creates or modifies files, rendered as an inline diff card by a
  * capable UI. Set by a tool whose call writes/edits a file (e.g. `write`,
  * `edit`). The diffs are derived from the call ARGUMENTS (a create's `oldText` is
- * `null`); the result-time applied-hunk diff (with context) is a separate
- * {@link DiffResultView} the tool emits after `execute`.
+ * `null`); the tool emits a separate {@link DiffResultView} after `execute` — the
+ * applied change (an edit/overwrite hunk with context, or a whole-file diff for a
+ * create).
  */
 export interface DiffCallView {
   card: 'diff'

packages/fs/fs-local/src/fsio.ts

@@ -386,8 +386,9 @@ export async function readForEdit(
  * Best-effort read of a file's current text for a before/after diff basis, used
  * by an overwrite. Returns the LF-normalized decoded content, or `null` when the
  * file is binary or not valid UTF-8 — a write must succeed regardless of the
- * prior bytes, so an undiffable prior file simply yields no contextual diff
- * (the caller treats `null` the same as an absent file: call-time card only).
+ * prior bytes, so an undiffable prior file simply yields no contextual-hunk basis
+ * (the caller treats `null` the same as an absent file: the result renders a
+ * whole-file diff rather than an applied hunk).
  */
 export async function readTextForDiff(absolutePath: string, signal?: AbortSignal): Promise<string | null> {
   const buffer = await readFileAbortable(absolutePath, 'read', signal)

packages/fs/fs/src/types.ts

@@ -103,8 +103,10 @@ export interface FsWriteOutcome {
   version: FsVersion
   /**
    * The file's content BEFORE the write, or `null` when the file did not exist
-   * (a create). LF-normalized storage text (the diff basis), never a diff — a
-   * consumer computes the result-time contextual diff from `before`/`after`.
+   * (a create) or was undiffable (binary/non-UTF-8). LF-normalized storage text
+   * (the diff basis), never a diff — a consumer computes the result-time
+   * contextual diff from `before`/`after` when `before` is present, else falls
+   * back to a whole-file diff.
    */
   before: string | null
   /** The file's content AFTER the write, LF-normalized to share `before`'s diff basis. */

packages/ui/acp/src/index.ts

@@ -1170,10 +1170,12 @@ function toolResultUpdate(callId: CallId, view: ToolResultView, isError: boolean
         ...view.title !== undefined ? { title: view.title } : {},
       }
     case 'diff': {
-      // A result-time applied-hunk diff: emit one `{ type: 'diff' }` content block
-      // per hunk (mirroring the call-side diff arm). `tool_call_update.content`
-      // REPLACES the call's content in an editor, so these hunks supersede the
-      // call-time whole-file snippet the pending card installed.
+      // A result-time diff: emit one `{ type: 'diff' }` content block per entry
+      // (an applied hunk for an edit/overwrite, or a whole-file diff for a
+      // create), mirroring the call-side diff arm. `tool_call_update.content`
+      // REPLACES the call's content in an editor, so this result diff supersedes
+      // the diff the pending card installed (and keeps the model-facing result
+      // text from clobbering it).
       const content: AcpToolCallContent[] = view.diffs.map(d => ({ type: 'diff', path: d.path, oldText: d.oldText, newText: d.newText }))
       return {
         sessionUpdate: 'tool_call_update',