@stigmer/ink 3.1.3 → 3.1.4

package/file-review.d.ts

@@ -25,6 +25,23 @@ export declare function progressEntryDisplayPath(entry: FileChangeProgressEntry)
  * terminal reviewer sees the same explanation.
  */
 export declare function blockReasonNote(change: CapturedFileChange): string | null;
+/** The aggregate `+N −M` line counts for a change set. */
+export interface LineStats {
+    /** Total lines added across the set's changes. */
+    readonly linesAdded: number;
+    /** Total lines removed across the set's changes. */
+    readonly linesRemoved: number;
+}
+/**
+ * Sums a change set's per-file `linesAdded`/`linesRemoved` into one aggregate,
+ * for the set-level `+N −M` shown beside the prompt header and the settled
+ * record summary (parity with the web card's collapsed-bar aggregate). Counts
+ * every change regardless of verdict — it reports what changed, not what was
+ * kept. A file with no counts (binary, secret-withheld, or a record predating
+ * the fields) contributes zero, so the aggregate honestly understates rather
+ * than guessing; when NO file has counts it is zero and the stat is hidden.
+ */
+export declare function changeSetLineStats(set: FileChangeSet): LineStats;
 /** The effective per-file verdict counts for a settled change set. */
 export interface SettledCounts {
     /** Files kept (effective verdict APPROVE). */

package/file-review.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-review.d.ts","sourceRoot":"","sources":["../src/file-review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,EACd,MAAM,oEAAoE,CAAC;AAC5E,OAAO,EACL,cAAc,EAEf,MAAM,8DAA8D,CAAC;AAGtE;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAWvD;AAoBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAE/E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,CAiBzE;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,aAAa,CAc/D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CASzD"}
+{"version":3,"file":"file-review.d.ts","sourceRoot":"","sources":["../src/file-review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,EACd,MAAM,oEAAoE,CAAC;AAC5E,OAAO,EACL,cAAc,EAEf,MAAM,8DAA8D,CAAC;AAGtE;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAWvD;AAoBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAE/E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,CAiBzE;AAED,0DAA0D;AAC1D,MAAM,WAAW,SAAS;IACxB,kDAAkD;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,SAAS,CAQhE;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,aAAa,CAc/D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CASzD"}

package/file-review.js

@@ -70,6 +70,24 @@ export function blockReasonNote(change) {
             }
     }
 }
+/**
+ * Sums a change set's per-file `linesAdded`/`linesRemoved` into one aggregate,
+ * for the set-level `+N −M` shown beside the prompt header and the settled
+ * record summary (parity with the web card's collapsed-bar aggregate). Counts
+ * every change regardless of verdict — it reports what changed, not what was
+ * kept. A file with no counts (binary, secret-withheld, or a record predating
+ * the fields) contributes zero, so the aggregate honestly understates rather
+ * than guessing; when NO file has counts it is zero and the stat is hidden.
+ */
+export function changeSetLineStats(set) {
+    let linesAdded = 0;
+    let linesRemoved = 0;
+    for (const change of set.changes) {
+        linesAdded += change.linesAdded;
+        linesRemoved += change.linesRemoved;
+    }
+    return { linesAdded, linesRemoved };
+}
 /**
  * Folds a settled change set's decisions into kept / discarded / not-reviewed
  * counts, using the same `deriveEffectiveVerdicts` fold the web uses so a

package/file-review.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-review.js","sourceRoot":"","sources":["../src/file-review.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"file-review.js","sourceRoot":"","sources":["../src/file-review.ts"],"names":[],"mappings":"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"}

package/index.d.ts

@@ -10,8 +10,10 @@ export { TodoList, type TodoListProps } from "./components/TodoList.js";
 export { ApprovalPrompt, type ApprovalPromptProps } from "./components/ApprovalPrompt.js";
 export { FileReviewPrompt, type FileReviewPromptProps } from "./components/FileReviewPrompt.js";
 export { FileReviewRecord, type FileReviewRecordProps } from "./components/FileReviewRecord.js";
+export { FileDiffBody, type FileDiffBodyProps } from "./components/FileDiffBody.js";
 export { FileChangeProgressBar, type FileChangeProgressBarProps, } from "./components/FileChangeProgressBar.js";
-export { kindLetter, changeDisplayPath, progressEntryDisplayPath, blockReasonNote, settledCounts, settledSummary, type SettledCounts, } from "./file-review.js";
+export { FileLineStats } from "./components/FileReviewAtoms.js";
+export { kindLetter, changeDisplayPath, progressEntryDisplayPath, blockReasonNote, changeSetLineStats, settledCounts, settledSummary, type LineStats, type SettledCounts, } from "./file-review.js";
 export { ExecutionProgress, type ExecutionProgressProps } from "./components/ExecutionProgress.js";
 export { FollowUpInput, type FollowUpInputProps } from "./components/FollowUpInput.js";
 export { UsageWidget, type UsageWidgetProps } from "./components/UsageWidget.js";

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAGjF,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAChG,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAChG,OAAO,EACL,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,uCAAuC,CAAC;AAG/C,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,wBAAwB,EACxB,eAAe,EACf,aAAa,EACb,cAAc,EACd,KAAK,aAAa,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGpF,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,KAAK,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC3G,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAGvF,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAGjF,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAChG,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EACL,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAGhE,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,wBAAwB,EACxB,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,KAAK,SAAS,EACd,KAAK,aAAa,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGpF,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,KAAK,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC3G,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAGvF,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/index.js

@@ -14,9 +14,11 @@ export { TodoList } from "./components/TodoList.js";
 export { ApprovalPrompt } from "./components/ApprovalPrompt.js";
 export { FileReviewPrompt } from "./components/FileReviewPrompt.js";
 export { FileReviewRecord } from "./components/FileReviewRecord.js";
+export { FileDiffBody } from "./components/FileDiffBody.js";
 export { FileChangeProgressBar, } from "./components/FileChangeProgressBar.js";
+export { FileLineStats } from "./components/FileReviewAtoms.js";
 // File-review pure helpers (kind letters, paths, block reasons, settled counts)
-export { kindLetter, changeDisplayPath, progressEntryDisplayPath, blockReasonNote, settledCounts, settledSummary, } from "./file-review.js";
+export { kindLetter, changeDisplayPath, progressEntryDisplayPath, blockReasonNote, changeSetLineStats, settledCounts, settledSummary, } from "./file-review.js";
 export { ExecutionProgress } from "./components/ExecutionProgress.js";
 export { FollowUpInput } from "./components/FollowUpInput.js";
 export { UsageWidget } from "./components/UsageWidget.js";

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,kBAAkB,EAAgC,MAAM,eAAe,CAAC;AAEjF,iDAAiD;AACjD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GAEpB,MAAM,mBAAmB,CAAC;AAE3B,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,aAAa;AACb,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAsB,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,cAAc,EAA4B,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAA8B,MAAM,kCAAkC,CAAC;AAChG,OAAO,EAAE,gBAAgB,EAA8B,MAAM,kCAAkC,CAAC;AAChG,OAAO,EACL,qBAAqB,GAEtB,MAAM,uCAAuC,CAAC;AAE/C,gFAAgF;AAChF,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,wBAAwB,EACxB,eAAe,EACf,aAAa,EACb,cAAc,GAEf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAA+B,MAAM,mCAAmC,CAAC;AACnG,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,WAAW,EAAyB,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AAEpF,0CAA0C;AAC1C,OAAO,EAAE,cAAc,EAA6C,MAAM,gCAAgC,CAAC;AAC3G,OAAO,EAAE,WAAW,EAAyB,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AAEvF,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAA+C,MAAM,sBAAsB,CAAC;AAChG,OAAO,EAAE,UAAU,EAAwB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,kBAAkB,EAAgC,MAAM,eAAe,CAAC;AAEjF,iDAAiD;AACjD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GAEpB,MAAM,mBAAmB,CAAC;AAE3B,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,aAAa;AACb,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAsB,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,cAAc,EAA4B,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAA8B,MAAM,kCAAkC,CAAC;AAChG,OAAO,EAAE,gBAAgB,EAA8B,MAAM,kCAAkC,CAAC;AAChG,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AACpF,OAAO,EACL,qBAAqB,GAEtB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAEhE,gFAAgF;AAChF,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,wBAAwB,EACxB,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,cAAc,GAGf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAA+B,MAAM,mCAAmC,CAAC;AACnG,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,WAAW,EAAyB,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AAEpF,0CAA0C;AAC1C,OAAO,EAAE,cAAc,EAA6C,MAAM,gCAAgC,CAAC;AAC3G,OAAO,EAAE,WAAW,EAAyB,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AAEvF,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAA+C,MAAM,sBAAsB,CAAC;AAChG,OAAO,EAAE,UAAU,EAAwB,MAAM,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stigmer/ink",
-  "version": "3.1.3",
+  "version": "3.1.4",
   "description": "Ink (React for terminals) components for rendering Stigmer agent sessions in the terminal",
   "license": "Apache-2.0",
   "type": "module",
@@ -35,7 +35,7 @@
   },
   "dependencies": {
     "@connectrpc/connect-node": "^2.1.1",
-    "@stigmer/react": "3.1.3",
+    "@stigmer/react": "3.1.4",
     "ink-spinner": "^5.0.0",
     "ink-text-input": "^6.0.0",
     "marked": "^15.0.7",
@@ -43,8 +43,8 @@
   },
   "peerDependencies": {
     "@bufbuild/protobuf": "^2.0.0",
-    "@stigmer/protos": "3.1.3",
-    "@stigmer/sdk": "3.1.3",
+    "@stigmer/protos": "3.1.4",
+    "@stigmer/sdk": "3.1.4",
     "ink": "^7.0.0",
     "react": ">=19.0.0"
   }

package/src/__tests__/components.test.tsx

@@ -7,10 +7,12 @@ import { AgentMessageSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexec
 import { MessageType, ExecutionPhase, ToolCallStatus, ApprovalAction, ApprovalPolicySource } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
 import { ToolCallSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
 import { PendingApprovalSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/approval_pb";
+import { AgentExecutionSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
 import { MessageEntry } from "../components/MessageEntry.js";
 import { ExecutionProgress } from "../components/ExecutionProgress.js";
 import { ToolCallItem } from "../components/ToolCallItem.js";
 import { ApprovalPrompt } from "../components/ApprovalPrompt.js";
+import { MessageThread } from "../components/MessageThread.js";
 
 describe("MessageEntry", () => {
   it("renders a human message with 'You' prefix", () => {
@@ -221,4 +223,67 @@ describe("ApprovalPrompt", () => {
 
     expect(onSubmit).toHaveBeenCalledWith(ApprovalAction.APPROVE);
   });
+
+  it("ignores keyboard input when inactive", () => {
+    const pending = create(PendingApprovalSchema);
+    pending.toolCallId = "tc-1";
+    pending.toolName = "write_file";
+    const onSubmit = vi.fn();
+
+    const { stdin } = render(
+      <ApprovalPrompt
+        pendingApproval={pending}
+        onSubmit={onSubmit}
+        isActive={false}
+      />,
+    );
+    stdin.write("y");
+    stdin.write("a");
+
+    expect(onSubmit).not.toHaveBeenCalled();
+  });
+});
+
+describe("MessageThread — multi-approval keyboard arbitration", () => {
+  function execWithApprovals(...toolCallIds: string[]) {
+    const pendingApprovals = toolCallIds.map((id) => {
+      const pa = create(PendingApprovalSchema);
+      pa.toolCallId = id;
+      pa.toolName = "write_file";
+      return pa;
+    });
+    return create(AgentExecutionSchema, {
+      metadata: { id: "aex-1" },
+      status: { pendingApprovals },
+    });
+  }
+
+  it("routes a single keystroke to only the FIRST of multiple pending approvals", () => {
+    // The regression lock for the keyboard-sharing bug: two live ApprovalPrompts
+    // each had an unconditional useInput, so one keystroke settled both. Now only
+    // the first is active.
+    const onApprovalSubmit = vi.fn();
+    const exec = execWithApprovals("tc-1", "tc-2");
+
+    const { stdin } = render(
+      <MessageThread executions={[exec]} onApprovalSubmit={onApprovalSubmit} />,
+    );
+    stdin.write("y");
+
+    expect(onApprovalSubmit).toHaveBeenCalledTimes(1);
+    expect(onApprovalSubmit).toHaveBeenCalledWith("tc-1", ApprovalAction.APPROVE);
+  });
+
+  it("keeps the sole pending approval interactive", () => {
+    const onApprovalSubmit = vi.fn();
+    const exec = execWithApprovals("tc-1");
+
+    const { stdin } = render(
+      <MessageThread executions={[exec]} onApprovalSubmit={onApprovalSubmit} />,
+    );
+    stdin.write("y");
+
+    expect(onApprovalSubmit).toHaveBeenCalledTimes(1);
+    expect(onApprovalSubmit).toHaveBeenCalledWith("tc-1", ApprovalAction.APPROVE);
+  });
 });

package/src/__tests__/data-pickers.test.tsx

@@ -2,12 +2,12 @@ import React from "react";
 import { describe, it, expect, vi } from "vitest";
 import { render } from "ink-testing-library";
 import { create } from "@bufbuild/protobuf";
-import type { Stigmer } from "@stigmer/sdk";
 import { SearchResultSchema } from "@stigmer/protos/ai/stigmer/search/v1/io_pb";
 import { SessionSchema } from "@stigmer/protos/ai/stigmer/agentic/session/v1/api_pb";
 import { InkStigmerProvider } from "../provider.js";
 import { AgentPicker } from "../components/AgentPicker.js";
 import { SessionPicker } from "../components/SessionPicker.js";
+import { fakeClient } from "./test-support.js";
 
 const KEY = { enter: "\r" } as const;
 
@@ -27,11 +27,6 @@ function session(id: string, subject: string, agentInstanceId: string) {
   });
 }
 
-// Minimal Stigmer stub exposing only the methods the picker hooks call.
-function fakeClient(overrides: Record<string, unknown>): Stigmer {
-  return overrides as unknown as Stigmer;
-}
-
 describe("AgentPicker", () => {
   it("renders search results and returns the chosen agent on Enter", async () => {
     const results = [

package/src/__tests__/file-review.test.tsx

@@ -6,8 +6,10 @@ import { FileReviewContext } from "@stigmer/react";
 import {
   ToolCallSchema,
   FileContentSchema,
+  ToolCallOutputRefSchema,
   AgentMessageSchema,
 } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+import type { FileContent } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
 import type { ToolCall } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
 import {
   FileChangeSetSchema,
@@ -30,7 +32,11 @@ import { ToolCallItem } from "../components/ToolCallItem.js";
 import { ToolCallGroup } from "../components/ToolCallGroup.js";
 import { FileReviewPrompt } from "../components/FileReviewPrompt.js";
 import { FileReviewRecord } from "../components/FileReviewRecord.js";
+import { FileDiffBody } from "../components/FileDiffBody.js";
 import { MessageThread } from "../components/MessageThread.js";
+import { FileLineStats } from "../components/FileReviewAtoms.js";
+import { changeSetLineStats } from "../file-review.js";
+import { fakeClient, renderWithClient } from "./test-support.js";
 
 // --- fixtures -------------------------------------------------------------
 
@@ -41,6 +47,8 @@ interface ChangeOpts {
   readonly diffComplete?: boolean;
   readonly binary?: boolean;
   readonly blockedReason?: FileReviewBlockReason;
+  readonly linesAdded?: number;
+  readonly linesRemoved?: number;
 }
 
 function makeChange(opts: ChangeOpts) {
@@ -52,6 +60,8 @@ function makeChange(opts: ChangeOpts) {
     diffComplete: opts.diffComplete ?? true,
     fileDigest: `fd-${opts.id}`,
     blockedReason: opts.blockedReason ?? FileReviewBlockReason.UNSPECIFIED,
+    linesAdded: opts.linesAdded ?? 0,
+    linesRemoved: opts.linesRemoved ?? 0,
     before: opts.binary ? create(FileContentSchema, { isBinary: true }) : undefined,
     after: opts.binary ? create(FileContentSchema, { isBinary: true }) : undefined,
   });
@@ -215,7 +225,9 @@ describe("FileReviewPrompt — per-file", () => {
 
   it("enters per-file mode and keeps a reviewable file with its file digest", async () => {
     const onSubmit = vi.fn();
-    const { stdin, lastFrame } = render(
+    // Per-file mode mounts FileDiffBody, whose useFileChangeContent reads the
+    // Stigmer client — so these tests render under a provider.
+    const { stdin, lastFrame } = renderWithClient(
       <FileReviewPrompt changeSet={blockedSet} onSubmit={onSubmit} />,
     );
     stdin.write("f");
@@ -235,7 +247,7 @@ describe("FileReviewPrompt — per-file", () => {
 
   it("refuses to keep an unavailable file but allows discard", async () => {
     const onSubmit = vi.fn();
-    const { stdin } = render(
+    const { stdin } = renderWithClient(
       <FileReviewPrompt changeSet={blockedSet} onSubmit={onSubmit} />,
     );
     stdin.write("f");
@@ -262,7 +274,7 @@ describe("FileReviewPrompt — per-file", () => {
       ],
     });
     const onSubmit = vi.fn();
-    const { stdin } = render(
+    const { stdin } = renderWithClient(
       <FileReviewPrompt changeSet={binarySet} onSubmit={onSubmit} />,
     );
     stdin.write("f");
@@ -494,3 +506,306 @@ describe("MessageThread — file-review integration", () => {
     expect(out).not.toContain("File review —"); // but no settled record
   });
 });
+
+// --- FileLineStats (shared atom) -----------------------------------------
+
+describe("FileLineStats", () => {
+  it("renders nothing when both counts are zero (never +0 -0)", () => {
+    const { lastFrame } = render(<FileLineStats linesAdded={0} linesRemoved={0} />);
+    expect((lastFrame() ?? "").trim()).toBe("");
+  });
+
+  it("renders +N -M when counts exist", () => {
+    const { lastFrame } = render(<FileLineStats linesAdded={7} linesRemoved={3} />);
+    const out = lastFrame() ?? "";
+    expect(out).toContain("+7");
+    expect(out).toContain("-3");
+  });
+
+  it("renders a one-sided stat (added only) without hiding it", () => {
+    const { lastFrame } = render(<FileLineStats linesAdded={5} linesRemoved={0} />);
+    const out = lastFrame() ?? "";
+    expect(out).toContain("+5");
+    expect(out).toContain("-0"); // both sides always shown once any count exists
+  });
+});
+
+// --- changeSetLineStats (pure helper) ------------------------------------
+
+describe("changeSetLineStats", () => {
+  it("sums per-file counts across the set", () => {
+    const set = makeSet({
+      status: FileChangeSetStatus.RECONCILED,
+      changes: [
+        makeChange({ id: "a", path: "one.ts", linesAdded: 10, linesRemoved: 2 }),
+        makeChange({ id: "b", path: "two.ts", linesAdded: 5, linesRemoved: 3 }),
+      ],
+    });
+    expect(changeSetLineStats(set)).toEqual({ linesAdded: 15, linesRemoved: 5 });
+  });
+
+  it("treats an uncountable (binary/withheld) file as a zero contributor — honest understatement", () => {
+    const set = makeSet({
+      status: FileChangeSetStatus.AWAITING_REVIEW,
+      changes: [
+        makeChange({ id: "txt", path: "app.ts", linesAdded: 8, linesRemoved: 1 }),
+        makeChange({ id: "img", path: "logo.png", kind: FileChangeKind.BINARY_CHANGE, binary: true }),
+      ],
+    });
+    expect(changeSetLineStats(set)).toEqual({ linesAdded: 8, linesRemoved: 1 });
+  });
+
+  it("is zero for a set whose files carry no counts (stat then hidden by the atom)", () => {
+    const set = makeSet({
+      status: FileChangeSetStatus.RECONCILED,
+      changes: [makeChange({ id: "a", path: "one.ts" })],
+    });
+    expect(changeSetLineStats(set)).toEqual({ linesAdded: 0, linesRemoved: 0 });
+  });
+});
+
+// --- Line stats on the review surfaces -----------------------------------
+
+describe("FileReviewPrompt — line stats", () => {
+  it("shows the set aggregate +N -M on the header", () => {
+    const set = makeSet({
+      status: FileChangeSetStatus.AWAITING_REVIEW,
+      changes: [
+        makeChange({ id: "a", path: "one.ts", linesAdded: 12, linesRemoved: 3 }),
+        makeChange({ id: "b", path: "two.ts", linesAdded: 4, linesRemoved: 1 }),
+      ],
+    });
+    const out = render(<FileReviewPrompt changeSet={set} onSubmit={() => {}} />).lastFrame() ?? "";
+    expect(out).toContain("2 files awaiting review");
+    expect(out).toContain("+16");
+    expect(out).toContain("-4");
+  });
+
+  it("hides the header aggregate when no file has counts (never +0 -0)", () => {
+    const set = makeSet({
+      status: FileChangeSetStatus.AWAITING_REVIEW,
+      changes: [makeChange({ id: "a", path: "one.ts" })],
+    });
+    const out = render(<FileReviewPrompt changeSet={set} onSubmit={() => {}} />).lastFrame() ?? "";
+    expect(out).not.toContain("+");
+  });
+
+  it("shows per-file +N -M in per-file mode", async () => {
+    const set = makeSet({
+      status: FileChangeSetStatus.AWAITING_REVIEW,
+      changes: [
+        makeChange({ id: "a", path: "one.ts", linesAdded: 10, linesRemoved: 2 }),
+        makeChange({ id: "b", path: "two.ts", linesAdded: 4, linesRemoved: 0 }),
+      ],
+    });
+    const { stdin, lastFrame } = renderWithClient(
+      <FileReviewPrompt changeSet={set} onSubmit={() => {}} />,
+    );
+    stdin.write("f");
+    await tick();
+    const out = lastFrame() ?? "";
+    expect(out).toContain("+10");
+    expect(out).toContain("+4");
+  });
+});
+
+describe("FileReviewRecord — line stats", () => {
+  it("shows the set aggregate and per-file +N -M", () => {
+    const set = makeSet({
+      status: FileChangeSetStatus.RECONCILED,
+      changes: [
+        makeChange({ id: "a", path: "one.ts", linesAdded: 9, linesRemoved: 2 }),
+        makeChange({ id: "b", path: "two.ts", linesAdded: 3, linesRemoved: 1 }),
+      ],
+      decisions: [
+        { scope: FileDecisionScope.CHANGE_SET, action: FileDecisionAction.APPROVE },
+      ],
+    });
+    const out = render(<FileReviewRecord fileChangeSet={set} />).lastFrame() ?? "";
+    expect(out).toContain("+12"); // aggregate 9+3
+    expect(out).toContain("+9"); // per-file
+    expect(out).toContain("+3"); // per-file
+  });
+
+  it("renders no stat when the set carries no counts", () => {
+    const set = makeSet({
+      status: FileChangeSetStatus.RECONCILED,
+      changes: [makeChange({ id: "a", path: "one.ts" })],
+    });
+    expect(render(<FileReviewRecord fileChangeSet={set} />).lastFrame() ?? "").not.toContain("+");
+  });
+});
+
+// --- FileDiffBody ---------------------------------------------------------
+
+/**
+ * Polls the rendered frame until it contains `needle`, then returns. Replaces a
+ * fixed sleep: an artifact fetch resolves on its own microtask schedule (and a
+ * truncated side chains a second download-url fetch), so any single delay raced
+ * green locally but timed out under CI load. Polling waits exactly as long as
+ * the render needs and no longer, and fails with the actual frame on timeout.
+ */
+async function waitForFrame(
+  lastFrame: () => string | undefined,
+  needle: string,
+  timeoutMs = 2000,
+): Promise<void> {
+  const deadline = Date.now() + timeoutMs;
+  for (;;) {
+    if ((lastFrame() ?? "").includes(needle)) return;
+    if (Date.now() >= deadline) {
+      throw new Error(
+        `waitForFrame timed out after ${timeoutMs}ms waiting for ${JSON.stringify(
+          needle,
+        )}; last frame was ${JSON.stringify(lastFrame() ?? "")}`,
+      );
+    }
+    await new Promise((resolve) => setTimeout(resolve, 10));
+  }
+}
+
+function inlineSide(text: string): FileContent {
+  return create(FileContentSchema, { body: { case: "inline", value: text } });
+}
+
+function offloadedSide(storageKey: string, contentHash = "h"): FileContent {
+  return create(FileContentSchema, {
+    body: {
+      case: "ref",
+      value: create(ToolCallOutputRefSchema, { storageKey, contentHash }),
+    },
+  });
+}
+
+function changeWith(opts: {
+  id: string;
+  kind?: FileChangeKind;
+  before?: FileContent;
+  after?: FileContent;
+}) {
+  return create(CapturedFileChangeSchema, {
+    id: opts.id,
+    pathAfter: "file.ts",
+    pathBefore: "file.ts",
+    kind: opts.kind ?? FileChangeKind.MODIFY,
+    fileDigest: `fd-${opts.id}`,
+    before: opts.before,
+    after: opts.after,
+  });
+}
+
+describe("FileDiffBody", () => {
+  it("renders +/- lines for an inline whole-file diff (computeDiff parity)", () => {
+    const change = changeWith({
+      id: "m",
+      before: inlineSide("keep\nold\ntail\n"),
+      after: inlineSide("keep\nnew\ntail\n"),
+    });
+    const out = renderWithClient(<FileDiffBody change={change} />).lastFrame() ?? "";
+    expect(out).toContain("-old"); // removed, red
+    expect(out).toContain("+new"); // added, green
+    expect(out).toContain("keep"); // context retained
+  });
+
+  it("shows 'Binary file changed.' for a binary side", () => {
+    const change = create(CapturedFileChangeSchema, {
+      id: "bin",
+      pathAfter: "logo.png",
+      pathBefore: "logo.png",
+      kind: FileChangeKind.BINARY_CHANGE,
+      before: create(FileContentSchema, { isBinary: true }),
+      after: create(FileContentSchema, { isBinary: true }),
+    });
+    const out = renderWithClient(<FileDiffBody change={change} />).lastFrame() ?? "";
+    expect(out).toContain("Binary file changed.");
+  });
+
+  it("labels a genuinely empty new file (CREATE with no content)", () => {
+    const change = changeWith({ id: "new", kind: FileChangeKind.ADD, after: inlineSide("") });
+    const out = renderWithClient(<FileDiffBody change={change} />).lastFrame() ?? "";
+    expect(out).toContain("Empty new file.");
+  });
+
+  it("falls back to 'No preview available.' for a MODIFY with no renderable diff", () => {
+    const change = changeWith({ id: "np" }); // no before/after content
+    const out = renderWithClient(<FileDiffBody change={change} />).lastFrame() ?? "";
+    expect(out).toContain("No preview available.");
+  });
+
+  it("shows a loading notice while an offloaded side is in flight", () => {
+    const change = changeWith({ id: "load", after: offloadedSide("artifacts/aex-1/after") });
+    const client = fakeClient({
+      agentExecution: { getArtifactContent: () => new Promise(() => {}) },
+    });
+    const out = renderWithClient(<FileDiffBody change={change} />, client).lastFrame() ?? "";
+    expect(out).toContain("Loading diff");
+  });
+
+  it("reports a server-truncated offloaded side as un-diffable inline", async () => {
+    const change = changeWith({ id: "trunc", after: offloadedSide("artifacts/aex-1/after") });
+    const client = fakeClient({
+      agentExecution: {
+        getArtifactContent: async () => ({
+          content: new TextEncoder().encode("way too big"),
+          contentType: "text/plain",
+          truncated: true,
+        }),
+        // A truncated side activates useArtifactDownloadUrl (the notice offers a
+        // full-file download). Stub it so the fetch resolves instead of throwing
+        // on an undefined method — an unstubbed throw unmounts the ink tree and
+        // blanks the frame, which raced green locally but failed under CI load.
+        getArtifactDownloadUrl: async () => ({ downloadUrl: "https://example.test/full" }),
+      },
+    });
+    const { lastFrame } = renderWithClient(<FileDiffBody change={change} />, client);
+    await waitForFrame(lastFrame, "too large to diff inline");
+    expect(lastFrame() ?? "").toContain("too large to diff inline");
+  });
+
+  it("surfaces a fetch failure as an honest error notice", async () => {
+    const change = changeWith({ id: "err", after: offloadedSide("artifacts/aex-1/after") });
+    const client = fakeClient({
+      agentExecution: {
+        getArtifactContent: async () => {
+          throw new Error("boom");
+        },
+      },
+    });
+    const { lastFrame } = renderWithClient(<FileDiffBody change={change} />, client);
+    await waitForFrame(lastFrame, "Could not load this file's contents.");
+    expect(lastFrame() ?? "").toContain("Could not load this file's contents.");
+  });
+
+  it("caps an oversized diff and reports the overflow", () => {
+    const many = Array.from({ length: 250 }, (_, i) => `line ${i}`).join("\n");
+    const change = changeWith({ id: "big", before: inlineSide(""), after: inlineSide(`${many}\n`) });
+    const out = renderWithClient(<FileDiffBody change={change} />).lastFrame() ?? "";
+    expect(out).toMatch(/… \d+ more lines/);
+  });
+});
+
+describe("FileReviewPrompt — inline diff (master-detail)", () => {
+  it("shows only the selected file's diff and follows the selection", async () => {
+    const set = makeSet({
+      status: FileChangeSetStatus.AWAITING_REVIEW,
+      changes: [
+        changeWith({ id: "a", before: inlineSide("alpha\n"), after: inlineSide("ALPHA\n") }),
+        changeWith({ id: "b", before: inlineSide("bravo\n"), after: inlineSide("BRAVO\n") }),
+      ],
+    });
+    const { stdin, lastFrame } = renderWithClient(
+      <FileReviewPrompt changeSet={set} onSubmit={() => {}} />,
+    );
+    stdin.write("f");
+    await tick();
+    const first = lastFrame() ?? "";
+    expect(first).toContain("+ALPHA"); // selected file's diff
+    expect(first).not.toContain("+BRAVO"); // the other file's diff is not mounted
+
+    stdin.write("\u001B[B"); // down → select the second file
+    await tick();
+    const second = lastFrame() ?? "";
+    expect(second).toContain("+BRAVO");
+    expect(second).not.toContain("+ALPHA");
+  });
+});

package/src/__tests__/test-support.tsx

@@ -0,0 +1,25 @@
+import React, { type ReactElement } from "react";
+import { render } from "ink-testing-library";
+import type { Stigmer } from "@stigmer/sdk";
+import { InkStigmerProvider } from "../provider.js";
+
+/**
+ * Builds a minimal Stigmer stub exposing only the methods a test's hooks call.
+ * Anything not overridden is absent, so a test that touches an unstubbed method
+ * fails loudly rather than silently no-op'ing.
+ */
+export function fakeClient(overrides: Record<string, unknown> = {}): Stigmer {
+  return overrides as unknown as Stigmer;
+}
+
+/**
+ * Renders a tree under an {@link InkStigmerProvider} so hooks that read the
+ * Stigmer client (e.g. `useFileChangeContent` → `useStigmer`, which throws
+ * without a provider) work. Returns the `ink-testing-library` handle.
+ */
+export function renderWithClient(
+  node: ReactElement,
+  client: Stigmer = fakeClient(),
+) {
+  return render(<InkStigmerProvider client={client}>{node}</InkStigmerProvider>);
+}