@stigmer/react 3.0.9-dev.20260616060535 → 3.1.1

package/execution/artifact-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifact-utils.d.ts","sourceRoot":"","sources":["../../src/execution/artifact-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kEAAkE,CAAC;AAuC1G;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,iBAAiB,GAC1B,MAAM,GAAG,IAAI,CAEf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAOnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAOtE;AAMD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAMvE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIhE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAC1B,kBAAkB,CAepB;AAQD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAerE"}
+{"version":3,"file":"artifact-utils.d.ts","sourceRoot":"","sources":["../../src/execution/artifact-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kEAAkE,CAAC;AAuC1G;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,iBAAiB,GAC1B,MAAM,GAAG,IAAI,CAEf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAOnE;AAMD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAMvE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIhE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAC1B,kBAAkB,CAepB;AAQD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAerE"}

package/execution/artifact-utils.js

@@ -73,23 +73,6 @@ export function isTextArtifact(artifact) {
         return false;
     return TEXT_EXTENSIONS.has(ext);
 }
-/**
- * Checks whether an artifact's pre-signed download URL has expired.
- *
- * Returns `true` when:
- * - `expiresAt` is empty or cannot be parsed as a valid date
- * - The current time is past the expiration timestamp
- *
- * Expired URLs can be refreshed via `stigmer.agentExecution.getArtifactDownloadUrl()`.
- */
-export function isArtifactExpired(artifact) {
-    if (!artifact.expiresAt)
-        return true;
-    const expiresMs = Date.parse(artifact.expiresAt);
-    if (Number.isNaN(expiresMs))
-        return true;
-    return Date.now() >= expiresMs;
-}
 const YAML_EXTENSIONS = new Set(["yaml", "yml"]);
 const JSON_EXTENSIONS = new Set(["json"]);
 const MARKDOWN_EXTENSIONS = new Set(["md", "mdx"]);

package/execution/artifact-utils.js.map

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

package/execution/execution-phases.d.ts

@@ -1,7 +1,2 @@
-import { ExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
-/**
- * Returns `true` when the given phase represents a final, immutable
- * execution state — no further updates will arrive from the server.
- */
-export declare function isTerminalPhase(phase: ExecutionPhase): boolean;
+export { isTerminalPhase } from "@stigmer/sdk";
 //# sourceMappingURL=execution-phases.d.ts.map

package/execution/execution-phases.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execution-phases.d.ts","sourceRoot":"","sources":["../../src/execution/execution-phases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAS9F;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAE9D"}
+{"version":3,"file":"execution-phases.d.ts","sourceRoot":"","sources":["../../src/execution/execution-phases.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/execution/execution-phases.js

@@ -1,15 +1,5 @@
-import { ExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
-const TERMINAL_PHASES = new Set([
-    ExecutionPhase.EXECUTION_COMPLETED,
-    ExecutionPhase.EXECUTION_FAILED,
-    ExecutionPhase.EXECUTION_CANCELLED,
-    ExecutionPhase.EXECUTION_TERMINATED,
-]);
-/**
- * Returns `true` when the given phase represents a final, immutable
- * execution state — no further updates will arrive from the server.
- */
-export function isTerminalPhase(phase) {
-    return TERMINAL_PHASES.has(phase);
-}
+// Re-export the framework-agnostic execution-phase predicates from @stigmer/sdk
+// so the React surface shares one source of truth with @stigmer/ink and the pure
+// SDK logic (e.g. the file-review fold). See the sdk module for the definitions.
+export { isTerminalPhase } from "@stigmer/sdk";
 //# sourceMappingURL=execution-phases.js.map

package/execution/execution-phases.js.map

@@ -1 +1 @@
-{"version":3,"file":"execution-phases.js","sourceRoot":"","sources":["../../src/execution/execution-phases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAE9F,MAAM,eAAe,GAAgC,IAAI,GAAG,CAAC;IAC3D,cAAc,CAAC,mBAAmB;IAClC,cAAc,CAAC,gBAAgB;IAC/B,cAAc,CAAC,mBAAmB;IAClC,cAAc,CAAC,oBAAoB;CACpC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAqB;IACnD,OAAO,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC"}
+{"version":3,"file":"execution-phases.js","sourceRoot":"","sources":["../../src/execution/execution-phases.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,iFAAiF;AACjF,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/execution/file-path-resolver.d.ts

@@ -23,6 +23,34 @@ export type PathClassification = {
  * edge-case handling (leading-slash stripping, bare `.stigmer`).
  */
 export declare function classifyPath(path: string): PathClassification;
+/** A file path split into its directory prefix and final segment for display. */
+export interface DisplayPath {
+    /**
+     * The directory portion including the trailing slash (e.g. `"src/app/"`), or
+     * `""` when the path has no directory. Rendered dimmed and allowed to
+     * truncate — it is context, not identity.
+     */
+    readonly dir: string;
+    /**
+     * The final path segment — the file name (e.g. `"main.ts"`). This is the
+     * identity of the change and must never be clipped.
+     */
+    readonly base: string;
+}
+/**
+ * Splits a file path into `{ dir, base }` for filename-first display.
+ *
+ * The motivation: a raw tool-call path is frequently an absolute, deeply-nested
+ * string (`/Users/me/scm/.../notes.md`), and naive CSS `truncate` on the whole
+ * path clips the *end* — hiding the file name, the one part that identifies the
+ * change. Splitting lets the renderer keep the base name always visible and
+ * truncate only the (dimmed) directory.
+ *
+ * Pure (no React) so it is unit-testable in isolation and reusable by any
+ * surface. A trailing slash is tolerated (a directory path keeps its last
+ * segment as the base); a path with no slash is all base.
+ */
+export declare function splitDisplayPath(path: string): DisplayPath;
 /**
  * Constructs a browsable GitHub blob URL from a git clone URL.
  *

package/execution/file-path-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-path-resolver.d.ts","sourceRoot":"","sources":["../../src/execution/file-path-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4DAA4D,CAAC;AAKjG;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IACE,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,GACD;IACE,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAU7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CA0Bf;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IACE,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GACD;IACE,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,SAAS,cAAc,EAAE,GAC1C,kBAAkB,CAqCpB"}
+{"version":3,"file":"file-path-resolver.d.ts","sourceRoot":"","sources":["../../src/execution/file-path-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4DAA4D,CAAC;AAKjG;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IACE,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,GACD;IACE,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAU7D;AAED,iFAAiF;AACjF,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAQ1D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CA0Bf;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IACE,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GACD;IACE,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,SAAS,cAAc,EAAE,GAC1C,kBAAkB,CAqCpB"}

package/execution/file-path-resolver.js

@@ -18,6 +18,30 @@ export function classifyPath(path) {
     }
     return { kind: "workspace", remainder: clean };
 }
+/**
+ * Splits a file path into `{ dir, base }` for filename-first display.
+ *
+ * The motivation: a raw tool-call path is frequently an absolute, deeply-nested
+ * string (`/Users/me/scm/.../notes.md`), and naive CSS `truncate` on the whole
+ * path clips the *end* — hiding the file name, the one part that identifies the
+ * change. Splitting lets the renderer keep the base name always visible and
+ * truncate only the (dimmed) directory.
+ *
+ * Pure (no React) so it is unit-testable in isolation and reusable by any
+ * surface. A trailing slash is tolerated (a directory path keeps its last
+ * segment as the base); a path with no slash is all base.
+ */
+export function splitDisplayPath(path) {
+    if (!path)
+        return { dir: "", base: "" };
+    const trimmed = path.replace(/\/+$/, "");
+    const idx = trimmed.lastIndexOf("/");
+    if (idx < 0)
+        return { dir: "", base: trimmed };
+    const base = trimmed.slice(idx + 1);
+    // A path that was only slashes collapses to the original — never an empty base.
+    return base ? { dir: trimmed.slice(0, idx + 1), base } : { dir: "", base: trimmed };
+}
 /**
  * Constructs a browsable GitHub blob URL from a git clone URL.
  *

package/execution/file-path-resolver.js.map

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

package/execution/file-review-status.d.ts

@@ -0,0 +1,127 @@
+import type { CapturedFileChange, FileChangeSet } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/filereview_pb";
+import { FileDecisionAction } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+/**
+ * Why an `"unavailable"` file cannot be reviewed — the honest per-file cause the
+ * runner records on `CapturedFileChange.blocked_reason` (design doc 15).
+ *
+ * - `"secret"` — the path looks like a secret; the bytes were deliberately never
+ *   captured (there is nothing to review, by design).
+ * - `"size"` — the diff was captured but its bodies were dropped to keep the
+ *   persisted status under its size limit.
+ * - `"unknown"` — incomplete for a reason the wire does not name (a defensive
+ *   catch-all; historical rows and future/unmapped causes land here).
+ */
+export type FileBlockReason = "secret" | "size" | "unknown";
+/**
+ * How completely a single captured file change can be reviewed before a decision
+ * is made — the classification that decides whether a file can be kept. A
+ * discriminated union so every consumer handles each case exhaustively and reads
+ * the block reason from one place (no "classify, then separately look up why").
+ *
+ * - `{ kind: "reviewable" }` — the full before/after diff is available; the
+ *   reviewer can see exactly what changed and Keep or Discard it.
+ * - `{ kind: "binary" }` — a binary file changed; there is no text diff to
+ *   review (the bytes are captured and flagged, but a byte diff is not
+ *   human-reviewable). Binary is proven by `FileContent.is_binary`, not by the
+ *   block reason.
+ * - `{ kind: "unavailable"; reason }` — the diff is not available to review at
+ *   all, with the honest {@link FileBlockReason} the runner recorded.
+ *
+ * Both `"binary"` and `"unavailable"` are non-reviewable: the file cannot be
+ * approved (kept), only discarded. This mirrors the server, which blocks
+ * approval of any change set that is not fully complete.
+ */
+export type FileReviewability = {
+    readonly kind: "reviewable";
+} | {
+    readonly kind: "binary";
+} | {
+    readonly kind: "unavailable";
+    readonly reason: FileBlockReason;
+};
+/**
+ * Classify a {@link CapturedFileChange} by how completely it can be reviewed,
+ * from the signals the runner authors onto the change (see the file-review
+ * producer in the runner's `shared/filereview`).
+ *
+ * The mapping is derived from three proto signals, in order:
+ *
+ * 1. `diff_complete === true` → `"reviewable"`. The change set can only be
+ *    `COMPLETE` when every file is complete, so a complete file is always
+ *    reviewable.
+ * 2. otherwise, a binary side (`before.is_binary` or `after.is_binary`) →
+ *    `"binary"`. The runner marks a git-tracked file incomplete precisely
+ *    because a side is binary (`diff_complete = !binary`); a CAS file carries
+ *    `is_binary` on its blob ref. `is_binary` is preserved when a large body is
+ *    offloaded from an inline value to a storage ref, so this holds regardless
+ *    of offload. Binary is therefore derived here, never duplicated onto the
+ *    block reason (doc 15).
+ * 3. otherwise → `"unavailable"` with the honest cause from
+ *    `blocked_reason`: `SECRET_WITHHELD → "secret"`, `SIZE_ELIDED → "size"`,
+ *    else `"unknown"`. Before doc 15 this bucket was cause-agnostic (the wire
+ *    could not prove secret-withheld vs size-dropped); the runner now records
+ *    the cause at capture time, so the UI can say *why* rather than only *that*
+ *    the diff is unavailable.
+ */
+export declare function fileReviewability(change: CapturedFileChange): FileReviewability;
+/**
+ * How completely a whole {@link FileChangeSet} can be reviewed — the set-level
+ * sibling of {@link FileReviewability} that decides whether the set can be kept
+ * in one action. Drives the card's bulk affordance and keeps headless builders
+ * on the same classification.
+ *
+ * - `"complete"` — every file is reviewable; the set can be approved as-is.
+ * - `"binary-only"` — the set's ONLY blocker is binary files (every non-binary
+ *   file is fully reviewable). No text diff for the binaries, but their exact
+ *   bytes are captured and reconcilable, so the whole set can be KEPT in one
+ *   acknowledged action ("Keep all"). Includes mixed sets (text edits + images).
+ * - `"blocked"` — at least one file is unavailable to review with no keepable
+ *   bytes (secret-withheld / size-elided / uncapturable), so the set cannot be
+ *   approved at once; it must be resolved per file.
+ */
+export type ChangeSetReviewability = "complete" | "binary-only" | "blocked";
+/**
+ * Classify a {@link FileChangeSet} from its server-derived `diff_completeness`
+ * rollup (the field exists precisely so clients need not re-fold the per-file
+ * signals). The runner and the size backstop both derive that value from the
+ * same rule the backend gate re-checks, so this classification, the per-file
+ * {@link fileReviewability} fold, and the server gate agree by construction.
+ */
+export declare function changeSetReviewability(set: FileChangeSet): ChangeSetReviewability;
+/**
+ * Each file's EFFECTIVE verdict for a settled set, folding the decisions the
+ * way the runner reconcile does (most-specific-wins): the last CHANGE_SET
+ * decision is the baseline for every file, and a later-or-earlier FILE decision
+ * overrides it for that file (FILE > CHANGE_SET regardless of ledger order;
+ * within a scope, last write wins).
+ *
+ * This is the fold for DISPLAYING history — a set decided via "Keep all"
+ * correctly reads every file as kept. The interactive per-file selected state
+ * deliberately uses the FILE-only fold instead (a CHANGE_SET decision cannot
+ * coexist with an open review, so it never pre-selects anything there).
+ */
+export declare function deriveEffectiveVerdicts(set: FileChangeSet): ReadonlyMap<string, FileDecisionAction>;
+/**
+ * The captured change a transcript row's file path refers to, or `null`. The
+ * row's path may be absolute (harness tool args) while captured paths are
+ * workspace-root-relative, so the match accepts an exact match or a
+ * `/`-boundary suffix. Presentation-only — never a correlation key.
+ */
+export declare function changeForRowPath(set: FileChangeSet, rowPath: string): CapturedFileChange | null;
+/**
+ * The review state a stamped transcript row should badge — how this file edit
+ * stands in its change set's review lifecycle. `null` means "show no badge",
+ * chosen over guessing: a missing set (not yet projected), a CAPTURING set, or
+ * a row whose file is absent from the set (its edit was superseded or fully
+ * reverted within the turn) renders unbadged, never mislabeled.
+ *
+ * - `"pending"` — the set is AWAITING_REVIEW; this edit's net result is on the
+ *   decision surface now.
+ * - `"kept"` / `"discarded"` — the set is decided/reconciled and this file's
+ *   effective verdict is known ({@link deriveEffectiveVerdicts}).
+ * - `"failed"` — the set's reconcile failed; the workspace outcome for this
+ *   edit is not the reviewed one.
+ */
+export type FileReviewRowState = "pending" | "kept" | "discarded" | "failed";
+export declare function fileReviewRowState(set: FileChangeSet | undefined, rowPath: string | null): FileReviewRowState | null;
+//# sourceMappingURL=file-review-status.d.ts.map

package/execution/file-review-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-review-status.d.ts","sourceRoot":"","sources":["../../src/execution/file-review-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,aAAa,EAEd,MAAM,oEAAoE,CAAC;AAC5E,OAAO,EAGL,kBAAkB,EAGnB,MAAM,8DAA8D,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAE5D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,iBAAiB,CAI/E;AAcD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC;AAE5E;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,GAAG,sBAAsB,CASjF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,aAAa,GACjB,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAezC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,MAAM,GACd,kBAAkB,GAAG,IAAI,CAU3B;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE7E,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,aAAa,GAAG,SAAS,EAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,kBAAkB,GAAG,IAAI,CAoB3B"}

package/execution/file-review-status.js

@@ -0,0 +1,135 @@
+import { DiffCompleteness, FileChangeSetStatus, FileDecisionAction, FileDecisionScope, FileReviewBlockReason, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+/**
+ * Classify a {@link CapturedFileChange} by how completely it can be reviewed,
+ * from the signals the runner authors onto the change (see the file-review
+ * producer in the runner's `shared/filereview`).
+ *
+ * The mapping is derived from three proto signals, in order:
+ *
+ * 1. `diff_complete === true` → `"reviewable"`. The change set can only be
+ *    `COMPLETE` when every file is complete, so a complete file is always
+ *    reviewable.
+ * 2. otherwise, a binary side (`before.is_binary` or `after.is_binary`) →
+ *    `"binary"`. The runner marks a git-tracked file incomplete precisely
+ *    because a side is binary (`diff_complete = !binary`); a CAS file carries
+ *    `is_binary` on its blob ref. `is_binary` is preserved when a large body is
+ *    offloaded from an inline value to a storage ref, so this holds regardless
+ *    of offload. Binary is therefore derived here, never duplicated onto the
+ *    block reason (doc 15).
+ * 3. otherwise → `"unavailable"` with the honest cause from
+ *    `blocked_reason`: `SECRET_WITHHELD → "secret"`, `SIZE_ELIDED → "size"`,
+ *    else `"unknown"`. Before doc 15 this bucket was cause-agnostic (the wire
+ *    could not prove secret-withheld vs size-dropped); the runner now records
+ *    the cause at capture time, so the UI can say *why* rather than only *that*
+ *    the diff is unavailable.
+ */
+export function fileReviewability(change) {
+    if (change.diffComplete)
+        return { kind: "reviewable" };
+    if (change.before?.isBinary || change.after?.isBinary)
+        return { kind: "binary" };
+    return { kind: "unavailable", reason: blockReasonOf(change.blockedReason) };
+}
+/** Map the proto {@link FileReviewBlockReason} to the UI {@link FileBlockReason}. */
+function blockReasonOf(reason) {
+    switch (reason) {
+        case FileReviewBlockReason.SECRET_WITHHELD:
+            return "secret";
+        case FileReviewBlockReason.SIZE_ELIDED:
+            return "size";
+        default:
+            return "unknown";
+    }
+}
+/**
+ * Classify a {@link FileChangeSet} from its server-derived `diff_completeness`
+ * rollup (the field exists precisely so clients need not re-fold the per-file
+ * signals). The runner and the size backstop both derive that value from the
+ * same rule the backend gate re-checks, so this classification, the per-file
+ * {@link fileReviewability} fold, and the server gate agree by construction.
+ */
+export function changeSetReviewability(set) {
+    switch (set.diffCompleteness) {
+        case DiffCompleteness.COMPLETE:
+            return "complete";
+        case DiffCompleteness.BINARY_SUMMARY_ONLY:
+            return "binary-only";
+        default:
+            return "blocked";
+    }
+}
+/**
+ * Each file's EFFECTIVE verdict for a settled set, folding the decisions the
+ * way the runner reconcile does (most-specific-wins): the last CHANGE_SET
+ * decision is the baseline for every file, and a later-or-earlier FILE decision
+ * overrides it for that file (FILE > CHANGE_SET regardless of ledger order;
+ * within a scope, last write wins).
+ *
+ * This is the fold for DISPLAYING history — a set decided via "Keep all"
+ * correctly reads every file as kept. The interactive per-file selected state
+ * deliberately uses the FILE-only fold instead (a CHANGE_SET decision cannot
+ * coexist with an open review, so it never pre-selects anything there).
+ */
+export function deriveEffectiveVerdicts(set) {
+    let bulk = null;
+    const byFileId = new Map();
+    for (const d of set.decisions) {
+        if (d.scope === FileDecisionScope.CHANGE_SET)
+            bulk = d.action;
+        else if (d.scope === FileDecisionScope.FILE && d.fileChangeId) {
+            byFileId.set(d.fileChangeId, d.action);
+        }
+    }
+    const effective = new Map();
+    for (const c of set.changes) {
+        const verdict = byFileId.get(c.id) ?? bulk;
+        if (verdict != null)
+            effective.set(c.id, verdict);
+    }
+    return effective;
+}
+/**
+ * The captured change a transcript row's file path refers to, or `null`. The
+ * row's path may be absolute (harness tool args) while captured paths are
+ * workspace-root-relative, so the match accepts an exact match or a
+ * `/`-boundary suffix. Presentation-only — never a correlation key.
+ */
+export function changeForRowPath(set, rowPath) {
+    if (!rowPath)
+        return null;
+    const normalized = rowPath.replace(/\\/g, "/");
+    for (const c of set.changes) {
+        const path = c.pathAfter || c.pathBefore;
+        if (path && (normalized === path || normalized.endsWith(`/${path}`))) {
+            return c;
+        }
+    }
+    return null;
+}
+export function fileReviewRowState(set, rowPath) {
+    if (!set)
+        return null;
+    switch (set.status) {
+        case FileChangeSetStatus.AWAITING_REVIEW:
+            return "pending";
+        case FileChangeSetStatus.FAILED:
+            return "failed";
+        case FileChangeSetStatus.DECIDED:
+        case FileChangeSetStatus.RECONCILED: {
+            if (!rowPath)
+                return null;
+            const change = changeForRowPath(set, rowPath);
+            if (!change)
+                return null;
+            const verdict = deriveEffectiveVerdicts(set).get(change.id);
+            if (verdict === FileDecisionAction.APPROVE)
+                return "kept";
+            if (verdict === FileDecisionAction.REJECT)
+                return "discarded";
+            return null;
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=file-review-status.js.map

package/execution/file-review-status.js.map

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