harnery 0.27.0 → 0.29.0

package/dist/core/workflow/workspaces/state.d.ts.map

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

package/dist/core/workflow/workspaces/state.js

@@ -1,8 +1,9 @@
 import { chmodSync, closeSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, statSync, writeFileSync, } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { canonicalJson, fsyncParentDirectory, readJsonRecord, stableDigest, writeImmutableJson, } from "../durable-record.js";
+export { appendWorkflowJournalEvent } from "../journal.js";
 const JSON_LIMIT = 512 * 1024;
-const EVENT_LIMIT = 32 * 1024;
+const WORKSPACE_EVENT_BYTES = 32 * 1024;
 const ID = /^[A-Za-z0-9][A-Za-z0-9._-]{0,199}$/;
 export function workflowRunDir(coordRoot, runId) {
     assertId(runId, "run id");
@@ -62,7 +63,9 @@ export function readWorkspaceBinding(coordRoot, providerId, bindingId) {
     return existsSync(path) ? readJsonRecord(path, "workspace binding") : undefined;
 }
 export function appendWorkspaceEvent(coordRoot, claim, event, data = {}) {
-    if (!event || event.length > 100 || Buffer.byteLength(JSON.stringify(data)) > EVENT_LIMIT / 2) {
+    if (!event ||
+        event.length > 100 ||
+        Buffer.byteLength(JSON.stringify(data)) > WORKSPACE_EVENT_BYTES / 2) {
         throw new Error("workspace provider event is invalid or too large");
     }
     const path = workspaceEventsPath(coordRoot, claim.provider_id, claim.binding_id);
@@ -85,7 +88,7 @@ export function appendWorkspaceEvent(coordRoot, claim, event, data = {}) {
         record_sha256: stableDigest(basis),
     };
     const line = `${canonicalJson(record)}\n`;
-    if (Buffer.byteLength(line) > EVENT_LIMIT)
+    if (Buffer.byteLength(line) > WORKSPACE_EVENT_BYTES)
         throw new Error("workspace provider event is too large");
     const fd = openSync(path, "a", 0o600);
     try {
@@ -113,7 +116,7 @@ export function readWorkspaceEvents(coordRoot, providerId, bindingId) {
         .split("\n")
         .filter(Boolean)
         .map((line, index) => {
-        if (Buffer.byteLength(line) > EVENT_LIMIT) {
+        if (Buffer.byteLength(line) > WORKSPACE_EVENT_BYTES) {
             throw new Error(`workspace event ${index + 1} is too large`);
         }
         let record;
@@ -148,30 +151,6 @@ export function readWorkspaceEvents(coordRoot, providerId, bindingId) {
 function recordsDigestPlaceholder() {
     return null;
 }
-export function appendWorkflowJournalEvent(coordRoot, runId, event, data) {
-    const path = join(workflowRunDir(coordRoot, runId), "journal.jsonl");
-    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
-    const existed = existsSync(path);
-    const line = `${JSON.stringify({
-        schema_version: 1,
-        run_id: runId,
-        ts: new Date().toISOString(),
-        event,
-        ...data,
-    })}\n`;
-    if (Buffer.byteLength(line) > EVENT_LIMIT)
-        throw new Error("workflow journal event is too large");
-    const fd = openSync(path, "a", 0o600);
-    try {
-        writeFileSync(fd, line, "utf8");
-        fsyncSync(fd);
-    }
-    finally {
-        closeSync(fd);
-    }
-    if (!existed)
-        fsyncParentDirectory(path);
-}
 export function appendCleanupAttempt(coordRoot, runId, input) {
     const path = join(workflowRunDir(coordRoot, runId), "cleanup", "attempts.jsonl");
     mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
@@ -187,7 +166,7 @@ export function appendCleanupAttempt(coordRoot, runId, input) {
         record_sha256: stableDigest(basis),
     };
     const line = `${canonicalJson(attempt)}\n`;
-    if (Buffer.byteLength(line) > EVENT_LIMIT) {
+    if (Buffer.byteLength(line) > WORKSPACE_EVENT_BYTES) {
         throw new Error("workspace cleanup attempt is too large");
     }
     const fd = openSync(path, "a", 0o600);
@@ -230,7 +209,7 @@ export function readCleanupAttempts(coordRoot, runId) {
 }
 function appendChainedRecord(path, record, label) {
     const line = `${canonicalJson(record)}\n`;
-    if (Buffer.byteLength(line) > EVENT_LIMIT) {
+    if (Buffer.byteLength(line) > WORKSPACE_EVENT_BYTES) {
         throw new Error(`${label} is too large`);
     }
     const fd = openSync(path, "a", 0o600);

package/dist/lib/browser/client.d.ts

@@ -134,6 +134,56 @@ export declare class Browser {
     screenshot(path: string, opts?: {
         fullPage?: boolean;
     }): Promise<number>;
+    /**
+     * Capture a full-page screenshot from an explicit capture viewport and
+     * evaluate the caller's final evidence expression immediately before the
+     * pixels are written. Playwright normally manages the full-page viewport
+     * internally, which leaves callers unable to inspect fixed/sticky geometry
+     * in the state the PNG actually renders.
+     */
+    screenshotWithEvaluation<T = unknown>(path: string, evaluation: string, opts?: {
+        fullPage?: boolean;
+    }): Promise<{
+        bytes: number;
+        evaluation: T;
+        viewport: {
+            width: number;
+            height: number;
+        };
+        evidence: {
+            converged: boolean;
+            reason: string;
+            passes: number;
+            max_passes: number;
+            max_dimension: number;
+            max_pixels: number;
+            original_viewport: {
+                width: number;
+                height: number;
+            };
+            evaluated_viewport: {
+                width: number;
+                height: number;
+            };
+            document_extent_before_evaluation: {
+                width: number;
+                height: number;
+            };
+            document_extent_after_evaluation: {
+                width: number;
+                height: number;
+            };
+            document_extent_after_screenshot: {
+                width: number;
+                height: number;
+            };
+            screenshot: {
+                width: number;
+                height: number;
+                bytes: number;
+            };
+        };
+    }>;
     /**
      * Plain-text snapshot of the document body. Suitable as a coarse "what's
      * on screen" signal for LLM iteration loops. For richer extraction, use

package/dist/lib/browser/client.d.ts.map

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

package/dist/lib/browser/client.js

@@ -155,6 +155,109 @@ export class Browser {
         const buf = await page.screenshot({ path, fullPage: opts.fullPage ?? true, type: "png" });
         return buf.length;
     }
+    /**
+     * Capture a full-page screenshot from an explicit capture viewport and
+     * evaluate the caller's final evidence expression immediately before the
+     * pixels are written. Playwright normally manages the full-page viewport
+     * internally, which leaves callers unable to inspect fixed/sticky geometry
+     * in the state the PNG actually renders.
+     */
+    async screenshotWithEvaluation(path, evaluation, opts = {}) {
+        const page = this.currentPage;
+        const fullPage = opts.fullPage ?? true;
+        const maxPasses = 4;
+        const maxDimension = 32_000;
+        const maxPixels = 128_000_000;
+        const documentExtent = () => page.evaluate(() => ({
+            width: Math.max(document.documentElement.scrollWidth, document.body?.scrollWidth ?? 0),
+            height: Math.max(document.documentElement.scrollHeight, document.body?.scrollHeight ?? 0),
+        }));
+        const originalViewport = page.viewportSize();
+        if (!originalViewport) {
+            throw new Error("Capture-state evaluation requires a page with an explicit viewport.");
+        }
+        let captureViewport = originalViewport;
+        let passes = fullPage ? 0 : 1;
+        let extentBeforeEvaluation = await documentExtent();
+        let bounded = true;
+        if (fullPage) {
+            for (let pass = 0; pass < maxPasses; pass += 1) {
+                passes = pass + 1;
+                const nextViewport = {
+                    width: originalViewport.width,
+                    height: Math.max(originalViewport.height, Math.ceil(extentBeforeEvaluation.height)),
+                };
+                bounded =
+                    nextViewport.width <= maxDimension &&
+                        nextViewport.height <= maxDimension &&
+                        nextViewport.width * nextViewport.height <= maxPixels;
+                if (!bounded)
+                    break;
+                if (nextViewport.width === captureViewport.width &&
+                    nextViewport.height === captureViewport.height &&
+                    extentBeforeEvaluation.width <= captureViewport.width &&
+                    extentBeforeEvaluation.height === captureViewport.height) {
+                    break;
+                }
+                captureViewport = nextViewport;
+                await page.setViewportSize(captureViewport);
+                extentBeforeEvaluation = await documentExtent();
+            }
+        }
+        try {
+            const evaluationResult = await page.evaluate(evaluation);
+            const extentAfterEvaluation = await documentExtent();
+            const buf = await page.screenshot({ path, fullPage: fullPage && bounded, type: "png" });
+            const extentAfterScreenshot = await documentExtent();
+            const screenshot = {
+                width: buf.readUInt32BE(16),
+                height: buf.readUInt32BE(20),
+                bytes: buf.length,
+            };
+            const exact = fullPage
+                ? bounded &&
+                    captureViewport.width === extentBeforeEvaluation.width &&
+                    captureViewport.height === extentBeforeEvaluation.height &&
+                    captureViewport.width === extentAfterEvaluation.width &&
+                    captureViewport.height === extentAfterEvaluation.height &&
+                    captureViewport.width === extentAfterScreenshot.width &&
+                    captureViewport.height === extentAfterScreenshot.height &&
+                    captureViewport.width === screenshot.width &&
+                    captureViewport.height === screenshot.height
+                : captureViewport.width === screenshot.width &&
+                    captureViewport.height === screenshot.height;
+            const reason = !bounded
+                ? "capture_bounds_exceeded"
+                : exact
+                    ? "capture_viewport_converged"
+                    : "capture_viewport_non_convergent";
+            return {
+                bytes: buf.length,
+                evaluation: evaluationResult,
+                viewport: captureViewport,
+                evidence: {
+                    converged: exact,
+                    reason,
+                    passes,
+                    max_passes: maxPasses,
+                    max_dimension: maxDimension,
+                    max_pixels: maxPixels,
+                    original_viewport: originalViewport,
+                    evaluated_viewport: captureViewport,
+                    document_extent_before_evaluation: extentBeforeEvaluation,
+                    document_extent_after_evaluation: extentAfterEvaluation,
+                    document_extent_after_screenshot: extentAfterScreenshot,
+                    screenshot,
+                },
+            };
+        }
+        finally {
+            if (captureViewport.width !== originalViewport.width ||
+                captureViewport.height !== originalViewport.height) {
+                await page.setViewportSize(originalViewport);
+            }
+        }
+    }
     /**
      * Plain-text snapshot of the document body. Suitable as a coarse "what's
      * on screen" signal for LLM iteration loops. For richer extraction, use

package/dist/lib/exec.d.ts

@@ -10,6 +10,10 @@ export interface ExecResult {
     stdout: string;
     stderr: string;
     exitCode: number;
+    /** True when this process killed the child for exceeding `opts.timeout`. A
+     * child that handles the signal cleanly still exits 0, so the exit code alone
+     * cannot distinguish a kill from an ordinary finish. */
+    timedOut?: boolean;
 }
 export interface ExecOpts {
     cwd?: string;

package/dist/lib/exec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/lib/exec.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,QAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAmC5E;AAED,sEAAsE;AACtE,wBAAsB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAEhG"}
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/lib/exec.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB;;4DAEwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,QAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAwC5E;AAED,sEAAsE;AACtE,wBAAsB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAEhG"}

package/dist/lib/exec.js

@@ -29,7 +29,11 @@ export function exec(cmd, opts = {}) {
         proc.stdout?.on("data", (d) => out.push(d));
         proc.stderr?.on("data", (d) => err.push(d));
         const timeout = opts.timeout ?? 30_000;
-        const timer = setTimeout(() => proc.kill(), timeout);
+        let timedOut = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            proc.kill();
+        }, timeout);
         const finish = (exitCode, errOverride) => {
             clearTimeout(timer);
             const stdout = Buffer.concat(out).toString("utf-8");
@@ -39,6 +43,7 @@ export function exec(cmd, opts = {}) {
                 stdout: shouldTrim ? stdout.trim() : stdout.replace(/\n$/, ""),
                 stderr: shouldTrim ? stderr.trim() : stderr.replace(/\n$/, ""),
                 exitCode,
+                ...(timedOut ? { timedOut: true } : {}),
             });
         };
         // ENOENT (binary not found) and similar spawn failures surface here rather

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harnery",
-  "version": "0.27.0",
+  "version": "0.29.0",
   "description": "Multi-agent coordination for AI coding agents - Claude Code, Cursor, and Codex.",
   "license": "MIT",
   "author": "Ryan Kelly",

package/src/commands/browse.ts

@@ -67,6 +67,7 @@ interface BrowseOpts {
   press?: string;
   waitFor?: string;
   evaluate?: string;
+  captureEvaluate?: string;
   batch?: string;
   networkHar?: string;
   login?: boolean;
@@ -179,6 +180,10 @@ export function registerBrowseCommand(
       "--evaluate <js>",
       "Run JS in the page context after navigation; result printed to stdout",
     )
+    .option(
+      "--capture-evaluate <js>",
+      "In trio mode, evaluate JS inside the exact screenshot viewport immediately before capture; result is written as captureEval",
+    )
     .option(
       "--batch <steps>",
       "Run multiple steps in one session, semicolon-separated. Each step is one of: " +
@@ -601,6 +606,11 @@ async function runBrowse(
     }
 
     if (printMode) {
+      if (opts.captureEvaluate) {
+        throw new Error(
+          "--capture-evaluate requires trio mode so its result can be bound to a screenshot.",
+        );
+      }
       if (opts.baseline || opts.diff) {
         throw new Error(
           "--baseline / --diff require trio mode (screenshot file). Remove --snapshot/--html/--json or capture the screenshot first.",
@@ -911,10 +921,27 @@ async function runTrioMode(
   const skipScreenshot = opts.screenshot === false || opts.domOnly === true;
   let pngPath: string | undefined;
   let pngBytes: number | undefined;
+  let captureEvalResult: unknown;
+  let captureViewport: { width: number; height: number } | undefined;
+  let captureEvidence: unknown;
   if (!skipScreenshot) {
     pngPath = `${prefix}.png`;
-    pngBytes = await browser.screenshot(pngPath, { fullPage: opts.fullPage !== false });
+    if (opts.captureEvaluate) {
+      const captured = await browser.screenshotWithEvaluation(pngPath, opts.captureEvaluate, {
+        fullPage: opts.fullPage !== false,
+      });
+      pngBytes = captured.bytes;
+      captureEvalResult = captured.evaluation;
+      captureViewport = captured.viewport;
+      captureEvidence = captured.evidence;
+    } else {
+      pngBytes = await browser.screenshot(pngPath, { fullPage: opts.fullPage !== false });
+    }
     written.push(pngPath);
+  } else if (opts.captureEvaluate) {
+    throw new Error(
+      "--capture-evaluate requires a screenshot; remove --no-screenshot / --dom-only.",
+    );
   }
 
   const htmlPath = `${prefix}.html`;
@@ -937,6 +964,11 @@ async function runTrioMode(
   };
   if (pngBytes !== undefined) envelope.screenshotBytes = pngBytes;
   if (opts.evaluate) envelope.eval = evalResult;
+  if (opts.captureEvaluate) {
+    envelope.captureEval = captureEvalResult;
+    envelope.captureViewport = captureViewport;
+    envelope.captureEvidence = captureEvidence;
+  }
   if (opts.networkHar) envelope.har = resolve(opts.networkHar);
   if (visibility) envelope.visibility = visibility;
   if (widths) envelope.width = widths;

package/src/commands/work.ts

@@ -1,3 +1,4 @@
+import { resolve } from "node:path";
 import type { Command } from "commander";
 import type { EmitContext } from "../commander.ts";
 import { workflowSubscriptionOnly } from "../core/config.ts";
@@ -19,6 +20,7 @@ import {
   reconcileWorkItem,
   reopenWorkItem,
   runWorkItem,
+  type WorkAttempt,
   type WorkRecord,
 } from "../core/work/index.ts";
 import { WorkflowParkedError } from "../core/workflow/index.ts";
@@ -43,6 +45,7 @@ interface WorkRunOpts {
   allowApiBilling?: boolean;
   policy?: string;
   isolation?: PolicyIsolation;
+  workspaceRoot?: string;
   approvalTo?: string;
   actor?: string;
   json?: boolean;
@@ -52,8 +55,12 @@ interface GovernanceOpts {
   actor?: string;
   reason?: string;
   json?: boolean;
+  finding?: string[];
+  dispose?: string[];
 }
 
+const MAX_ATTEMPT_JOURNAL_ERROR_RENDER = 240;
+
 export function registerWorkCommand(program: Command, emit: EmitContext): void {
   const registry = createBuiltinHarnessRegistry();
   const harnesses = registry.ids();
@@ -173,6 +180,7 @@ function registerRunCommand(
     .option("--allow-api-billing", "Permit API-key override billing")
     .option("--policy <file>", "Host policy JSON/JSONC")
     .option("--isolation <mode>", "shared | worktree | sandbox | remote")
+    .option("--workspace-root <dir>", "Writable root the isolated workspace is allocated under")
     .option("--approval-to <address>", "Address durable ASK requests")
     .option("--actor <name>", "Actor recorded in attempt receipts")
     .option("--json", "Emit the workflow report or parked result as JSON")
@@ -181,7 +189,21 @@ function registerRunCommand(
         if (opts.harness && !registry.get(opts.harness)) {
           throw new Error(`unknown harness ${JSON.stringify(opts.harness)}`);
         }
+        if (opts.workspaceRoot && opts.isolation !== "worktree") {
+          throw new Error("--workspace-root requires --isolation worktree");
+        }
         try {
+          // An isolated attempt needs a provider AND the writable root it may
+          // allocate under; the engine refuses to guess either. Without them a
+          // worktree request degrades to shared, which the proof records as
+          // requested vs effective isolation and the reporting below surfaces.
+          const { createLocalGitWorktreeProvider } = await import("../core/workflow/index.ts");
+          const workspace = opts.workspaceRoot
+            ? {
+                provider: createLocalGitWorktreeProvider({ coordRoot }),
+                writableRoots: [resolve(opts.workspaceRoot)],
+              }
+            : undefined;
           const report = await runWorkItem({
             coordRoot,
             workId,
@@ -204,6 +226,7 @@ function registerRunCommand(
               approvalMode: "park",
               approvalAddressee: opts.approvalTo,
               isolation: opts.isolation,
+              workspace,
               networkAccess: "enabled",
             },
           });
@@ -211,8 +234,18 @@ function registerRunCommand(
             emit.config({ format: "json" });
             emit.data(report);
           } else {
+            // A requested isolation the run could not honour is recorded in the
+            // proof as requested vs effective, which nobody reads on a green run.
+            // Say it here instead, so a silent downgrade to shared cannot pass for
+            // an isolated attempt.
+            const degraded =
+              opts.isolation && opts.isolation !== "shared" && !report.workspaceBinding
+                ? `note: ran shared; ${opts.isolation} isolation was requested but not allocated` +
+                  `${opts.workspaceRoot ? "" : " (no --workspace-root given)"}\n`
+                : "";
             emit.text(
-              `work ${workId}: run ${report.runId} finished\nproof: ${report.proofPath}\n` +
+              `work ${workId}: run ${report.runId} finished\n${degraded}` +
+                `proof: ${report.proofPath}\n` +
                 `next: harn work reconcile ${workId}\n`,
             );
           }
@@ -257,14 +290,66 @@ function registerGovernanceCommand(
     )
     .option("--actor <name>", "Actor recorded in the governance receipt")
     .option("--reason <text>", "Bounded decision reason")
-    .option("--json", "Emit the complete work record as JSON")
-    .action((workId: string, opts: GovernanceOpts) => {
-      withWorkRoot(emit, (coordRoot) => {
-        const fn =
-          name === "accept" ? acceptWorkItem : name === "cancel" ? cancelWorkItem : reopenWorkItem;
-        emitWork(fn(coordRoot, workId, opts), opts.json, emit, true);
-      });
+    .option("--json", "Emit the complete work record as JSON");
+  const command = work.commands.at(-1) as Command;
+  if (name === "reopen") {
+    command.option(
+      "--finding <text>",
+      "Correction the next attempt must address (repeatable)",
+      collectValue,
+      [] as string[],
+    );
+  }
+  if (name === "accept") {
+    command.option(
+      "--dispose <id=outcome[:reason]>",
+      "Dispose of an open finding: fixed, or deferred:<reason> (repeatable)",
+      collectValue,
+      [] as string[],
+    );
+  }
+  command.action((workId: string, opts: GovernanceOpts) => {
+    withWorkRoot(emit, (coordRoot) => {
+      const fn =
+        name === "accept" ? acceptWorkItem : name === "cancel" ? cancelWorkItem : reopenWorkItem;
+      emitWork(
+        fn(coordRoot, workId, {
+          ...opts,
+          ...(opts.finding?.length ? { findings: opts.finding } : {}),
+          ...(opts.dispose?.length ? { dispositions: opts.dispose.map(parseDisposition) } : {}),
+        }),
+        opts.json,
+        emit,
+        true,
+      );
     });
+  });
+}
+
+function collectValue(value: string, previous: string[]): string[] {
+  return [...previous, value];
+}
+
+/** `<id>=fixed` or `<id>=deferred:<reason>`. Deferring without a reason is
+ * rejected downstream, so a lapsed finding cannot look like a decision. */
+function parseDisposition(input: string): {
+  id: string;
+  outcome: "fixed" | "deferred";
+  reason?: string;
+} {
+  const split = input.indexOf("=");
+  if (split <= 0)
+    throw new Error(`invalid --dispose ${JSON.stringify(input)}; expected <id>=<outcome>`);
+  const id = input.slice(0, split).trim();
+  const rest = input.slice(split + 1).trim();
+  const [outcome, ...reasonParts] = rest.split(":");
+  if (outcome !== "fixed" && outcome !== "deferred") {
+    throw new Error(
+      `invalid --dispose outcome ${JSON.stringify(outcome)}; expected fixed or deferred`,
+    );
+  }
+  const reason = reasonParts.join(":").trim();
+  return { id, outcome, ...(reason ? { reason } : {}) };
 }
 
 function emitWork(
@@ -297,18 +382,28 @@ function emitWork(
     lines.push("acceptance:", ...record.intent.acceptance.map((item) => `  - ${item}`));
   }
   if (projection.attempts.length) {
-    lines.push(
-      "attempts:",
-      ...projection.attempts.map(
-        (attempt) => `  ${attempt.number}. ${attempt.run_id}  ${attempt.status}`,
-      ),
-    );
+    lines.push("attempts:", ...projection.attempts.map(renderAttemptRow));
   }
   if (projection.approval_id) lines.push(`approval: ${projection.approval_id}`);
   if (projection.proof_path) lines.push(`proof: ${projection.proof_path}`);
   emit.text(`${lines.join("\n")}\n`);
 }
 
+export function renderAttemptRow(attempt: WorkAttempt): string {
+  const statusDetail =
+    attempt.status === "journal_unreadable"
+      ? `: ${renderAttemptJournalError(attempt.journal_error)}`
+      : "";
+  return `  ${attempt.number}. ${attempt.run_id}  ${attempt.status}${statusDetail}`;
+}
+
+function renderAttemptJournalError(error: string | undefined): string {
+  const normalized = (error ?? "").replace(/\s+/g, " ").trim();
+  const value = normalized || "unknown journal read error";
+  if (value.length <= MAX_ATTEMPT_JOURNAL_ERROR_RENDER) return value;
+  return `${value.slice(0, MAX_ATTEMPT_JOURNAL_ERROR_RENDER - 3).trimEnd()}...`;
+}
+
 function renderWorkRow(record: WorkRecord): string {
   const projection = record.projection;
   return `${record.intent.id}  ${projection.state.padEnd(17)}  ${projection.attempts_used}/${record.intent.max_attempts}  ${projection.next_action.padEnd(21)}  ${record.intent.title}`;

package/src/core/harnesses/types.ts

@@ -83,6 +83,11 @@ export interface HarnessRawResult {
   exitCode: number;
   durationMs: number;
   resultFileText?: string;
+  /** The host killed this child for exceeding its timeout. A vendor CLI that
+   * handles the signal cleanly still exits 0, so exit code alone cannot tell a
+   * kill from a finish; without this a timed-out child reads as a success with
+   * an empty answer. */
+  timedOut?: boolean;
 }
 
 export interface HarnessBenchFixture {

package/src/core/work/index.ts

@@ -7,6 +7,7 @@ export {
   createWorkItem,
   listWorkItems,
   newWorkId,
+  openOperatorFindings,
   readWorkItem,
   reconcileAllWorkItems,
   reconcileWorkItem,