harnery 0.33.0 → 0.34.1

package/dist/commands/artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/commands/artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAa1E,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CAmGN"}
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/commands/artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAc1E,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CAmGN"}

package/dist/commands/artifacts.js

@@ -1,4 +1,5 @@
-import { monorepoRoot, readHeartbeat, resolveOwner } from "../core/agents/index.js";
+import { monorepoRoot, resolveOwner } from "../core/agents/index.js";
+import { readLiveCoordinationRow } from "../core/agents/state/live-coordination-view.js";
 import { cleanArtifacts, createArtifact, inventoryArtifacts, releaseArtifact, renewArtifact, showArtifact, } from "../core/artifacts/index.js";
 import { artifactDefaultRetentionDays, coordFreshnessSeconds } from "../core/config.js";
 export function registerArtifactsCommand(program, emit, context) {
@@ -14,7 +15,7 @@ export function registerArtifactsCommand(program, emit, context) {
         .action((slug, opts) => {
         run(emit, () => {
             const repoRoot = requireRepoRoot(context);
-            const actor = currentActor();
+            const actor = currentActor(repoRoot);
             const retentionDays = opts.days
                 ? parseDays(opts.days)
                 : artifactDefaultRetentionDays(repoRoot);
@@ -64,7 +65,7 @@ export function registerArtifactsCommand(program, emit, context) {
         run(emit, () => {
             const repoRoot = requireRepoRoot(context);
             const manifest = renewArtifact(repoRoot, ref, parseDays(opts.days), opts.reason, {
-                actor: currentActor(),
+                actor: currentActor(repoRoot),
             });
             emit.data(manifest);
         });
@@ -75,7 +76,7 @@ export function registerArtifactsCommand(program, emit, context) {
         .action((ref) => {
         run(emit, () => {
             const repoRoot = requireRepoRoot(context);
-            emit.data(releaseArtifact(repoRoot, ref, { actor: currentActor() }));
+            emit.data(releaseArtifact(repoRoot, ref, { actor: currentActor(repoRoot) }));
         });
     });
     root
@@ -93,11 +94,11 @@ export function registerArtifactsCommand(program, emit, context) {
         });
     });
 }
-function currentActor() {
+function currentActor(repoRoot) {
     const instanceId = resolveOwner();
     if (!instanceId)
         return undefined;
-    const hb = readHeartbeat(instanceId);
+    const hb = readLiveCoordinationRow(repoRoot, instanceId);
     return {
         instance_id: instanceId,
         session_id: hb?.session_id,

package/dist/commands/backup.d.ts

@@ -6,7 +6,7 @@
  * paths and are init'd on first `harn backup init`. Subcommands:
  *
  *   init      restic init the repo (one-time)
- *   snapshot  restic backup .harnery/ (working artifacts excluded)
+ *   snapshot  restic backup of the durable, privacy-safe V3 state
  *   list      restic snapshots
  *   restore   restic restore <id>
  *   prune     restic forget --keep-daily 7 --keep-weekly 4 --prune

package/dist/commands/backup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/commands/backup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AA4EnD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAqN/E"}
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/commands/backup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AA4EnD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CA6N/E"}

package/dist/commands/backup.js

@@ -6,7 +6,7 @@
  * paths and are init'd on first `harn backup init`. Subcommands:
  *
  *   init      restic init the repo (one-time)
- *   snapshot  restic backup .harnery/ (working artifacts excluded)
+ *   snapshot  restic backup of the durable, privacy-safe V3 state
  *   list      restic snapshots
  *   restore   restic restore <id>
  *   prune     restic forget --keep-daily 7 --keep-weekly 4 --prune
@@ -108,40 +108,53 @@ export function registerBackupCommand(program, emit) {
     // -- snapshot --
     backup
         .command("snapshot")
-        .description("Take a restic snapshot of .harnery/ (excluding events.ndjson and " +
-        ".lock files and artifacts/ by default). Pass --target to back up a different path.")
-        .option("--target <path>", "Path to snapshot (default: .harnery/ from cwd walk-up)")
+        .description("Take a restic snapshot of the durable, privacy-safe V3 ledger and coordination state.")
         .option("--tag <tag>", "Restic tag (repeatable)", collect, [])
         .option("--repo <path>", "Repository path")
         .option("--password-file <path>", "Password file")
-        .option("--include-events", "Don't exclude events.ndjson (default: excluded; large + machine-local)")
         .option("--include-artifacts", "Include managed working artifacts (default: excluded; potentially large + ephemeral)")
         .action((opts) => {
         if (!checkRestic(emit)) {
             emit.setExitCode(1);
             return;
         }
-        const target = opts.target ?? findHarneryDir();
-        if (!target) {
+        const harnery = findHarneryDir();
+        if (!harnery) {
             emit.error({
                 code: "target_missing",
-                message: "No .harnery/ found above cwd; pass --target explicitly or run from a monorepo with .harnery/",
+                message: "No .harnery/ found above cwd; run from an initialized project",
             });
             emit.setExitCode(1);
             return;
         }
         const passThrough = [];
-        if (!opts.includeEvents) {
-            passThrough.push("--exclude", "events.ndjson");
-            passThrough.push("--exclude", ".lock");
-            passThrough.push("--exclude", ".log.lock");
-        }
-        if (!opts.includeArtifacts)
-            passThrough.push("--exclude", "artifacts");
         for (const t of opts.tag) {
             passThrough.push("--tag", t);
         }
-        const r = runRestic(["backup", target], {
+        const safeTargets = [
+            "ledgers",
+            "councils",
+            "journal",
+            "work",
+            "workflows",
+            "decisions",
+            "config.jsonc",
+            ".name-history",
+        ]
+            .map((entry) => path.join(harnery, entry))
+            .filter(existsSync);
+        if (opts.includeArtifacts && existsSync(path.join(harnery, "artifacts"))) {
+            safeTargets.push(path.join(harnery, "artifacts"));
+        }
+        if (safeTargets.length === 0) {
+            emit.error({
+                code: "backup_empty",
+                message: "No durable V3 state is available to back up",
+            });
+            emit.setExitCode(1);
+            return;
+        }
+        const r = runRestic(["backup", ...safeTargets], {
             repo: opts.repo,
             passwordFile: opts.passwordFile,
             stdio: "inherit",

package/dist/commands/browse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browse.d.ts","sourceRoot":"","sources":["../../src/commands/browse.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAmM1E,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,WAAW,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CAkZN"}
+{"version":3,"file":"browse.d.ts","sourceRoot":"","sources":["../../src/commands/browse.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AA+N1E,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,WAAW,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CA+cN"}

package/dist/commands/browse.js

@@ -1,8 +1,11 @@
-import { existsSync, mkdirSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, isAbsolute, resolve } from "node:path";
 import { resolveBinName } from "../core/config.js";
 import { Browser, browserProxyFromEnv, browserProxyGateFromEnv, captureDevOverlay, DEFAULT_CRITIQUE_RUBRIC, extractObservedIp, parseAssertSpec, runCritique, tilesFromFullPage, WEBRTC_PROXY_ONLY_ARG, writeNetscapeCookieFile, wslHeadedLaunchArgs, } from "../lib/browser/index.js";
+import { buildQaManifest, classifySignatures, } from "../lib/browser/qa-plan.js";
+import { DEFAULT_REUSE_MISMATCH_RATIO, planCritiqueReuse, QA_CRITIQUE_CONTRACT_VERSION, rubricDigest, } from "../lib/browser/qa-reuse.js";
+import { loadQaSnapshot, resolveQaBaseline, saveQaSnapshot } from "../lib/browser/qa-snapshot.js";
 import { startBrowserSessionServer, } from "../lib/browser/session-control.js";
 import { diffAgainstBaseline, saveBaseline, } from "../lib/browser/visual-diff.js";
 import { CookieJar } from "../lib/cookies/index.js";
@@ -203,6 +206,34 @@ export function registerBrowseCommand(program, emitParam, context) {
         .option("--diff-threshold <ratio>", "mismatchRatio (mismatchedPixels / totalPixels) below which the diff is " +
         "considered a match (0–1, default 0.01 = 1%).", "0.01")
         .option("--diff-fail", "Exit non-zero if --diff mismatchRatio exceeds --diff-threshold; requires --diff.")
+        .option("--qa-plan", "Classify this render against the persisted QA baseline and emit a review manifest " +
+        "(change class, scope selectors, required contexts, provider-call ceiling) under " +
+        "`qaPlan` in the JSON envelope — BEFORE any vision spend. Text/data-only edits plan " +
+        "zero model calls; ambiguity widens, never narrows. Baseline comes from the snapshot " +
+        "store (seed one with --qa-snapshot); no baseline classifies as `unknown`.")
+        .option("--qa-snapshot", "Persist this render (signature + DOM + full-page screenshot) as the QA baseline for the " +
+        "target + context, replacing any prior snapshot atomically. Run it on a page state you " +
+        "trust — typically right after a passing QA run — so the next --qa-plan inherits its " +
+        "baseline for free.")
+        .option("--qa-target <key>", "Override the snapshot-store key (default: the url argument). Lets a production render " +
+        "seed the baseline for a local file/route: browse the prod URL with --qa-snapshot " +
+        "--qa-target <local-target>, then --qa-plan the local target.")
+        .option("--qa-theme <theme>", "Context label for the QA snapshot store: light | dark (default light). Labels the " +
+        "stored/compared context; it does not switch the page's rendered theme.", "light")
+        .option("--qa-state <name>", "Context state label for the QA snapshot store (default 'default').", "default")
+        .option("--qa-scope <selector>", "Explicit scope selector from the producing task (repeatable) — resolution-order rung 1; " +
+        "overrides lifted anchors in the --qa-plan manifest.", (value, previous = []) => [...previous, value], [])
+        .option("--qa-states <names>", "Comma-separated interaction states to review (promotes the plan to interaction-state).", (value) => value
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean))
+        .option("--qa-reuse", "Reuse the baseline run's critique verdicts for tiles whose pixels provably didn't " +
+        "change (band-diff against the persisted --qa-snapshot screenshot; strict mismatch " +
+        "threshold). Only clean regions are reused — a region with baseline findings or any " +
+        "pixel drift is always re-reviewed. Requires --check-critique; misses degrade to a " +
+        "full fresh review, never an error. Stats land under `qaReuse` in the JSON envelope.")
+        .option("--qa-reuse-threshold <ratio>", "Band-diff mismatch ratio at or below which a clean tile region is reused " +
+        `(default ${DEFAULT_REUSE_MISMATCH_RATIO}; lower it toward 0 for stricter reuse).`)
         .option("--no-dev-overlay", "Skip auto-capture of Next.js dev-overlay issues. Default: capture every queued error (kind/code/message/stack) when a <nextjs-portal> shadow root is present. Necessary because Next.js 16 + React 19 route hydration errors + most React warnings through onCaughtError → next-devtools' errorQueue, NOT through console.error, so Playwright's standard listener doesn't see them. Surfaces them in the JSON envelope under `devOverlay`.")
         .action(async (url, opts) => {
         try {
@@ -388,18 +419,119 @@ async function runBrowse(url, opts, context) {
                 contrast: opts.checkContrast !== undefined ? { scope: contentScope(opts.checkContrast) } : null,
             });
         }
+        // Diff-aware QA planning. Signature capture must also happen BEFORE any
+        // annotation overlays are injected — an annotation box is a DOM change.
+        let qaPlan;
+        let qaCapture;
+        if (opts.qaPlan || opts.qaSnapshot) {
+            const qa = await runQaPlanning(browser, url, navResult.url, opts);
+            qaPlan = qa.report;
+            qaCapture = qa.capture;
+            if (qaPlan?.manifest) {
+                const m = qaPlan.manifest;
+                emit.log(`qa-plan: class=${m.change_class} scopes=${m.scopes.map((s) => s.selector).join(",") || "-"} ` +
+                    `contexts=${m.contexts.length} model-calls<=${m.predicted.model_calls_ceiling} baseline=${m.baseline_source}`, "info");
+            }
+        }
         // Vision critique. Capture tiles BEFORE any annotation overlays are injected
         // so the model sees the real page, not our boxes.
         let critique;
+        let qaReuse;
+        let critiqueTiles;
+        let critiqueFullPage;
         if (opts.checkCritique !== undefined) {
-            const tiles = await captureCritiqueTiles(browser, opts);
+            const rubric = opts.checkCritiqueRubric ?? DEFAULT_CRITIQUE_RUBRIC;
+            const captured = await captureCritiqueTiles(browser, opts, context?.critiqueProvider?.tileBudgetPx);
+            critiqueTiles = captured.tiles;
+            critiqueFullPage = captured.fullPage;
+            let tilesToReview = captured.tiles;
+            if (opts.qaReuse) {
+                const reuseContext = {
+                    viewport: opts.viewport ?? "desktop",
+                    theme: opts.qaTheme === "dark" ? "dark" : "light",
+                    state: opts.qaState ?? "default",
+                };
+                const stored = loadQaSnapshot(opts.qaTarget ?? url, reuseContext, {});
+                if (stored?.screenshotPath && stored.critique) {
+                    qaReuse = planCritiqueReuse({
+                        baselineScreenshot: readFileSync(stored.screenshotPath),
+                        baselineCritique: stored.critique,
+                        currentScreenshot: captured.fullPage,
+                        tiles: captured.tiles,
+                        rubric,
+                        mismatchThreshold: opts.qaReuseThreshold
+                            ? Number.parseFloat(opts.qaReuseThreshold)
+                            : undefined,
+                    });
+                }
+                else {
+                    qaReuse = {
+                        mode: "band-diff",
+                        review: captured.tiles,
+                        decisions: [],
+                        tiles_total: captured.tiles.length,
+                        tiles_reused: 0,
+                        tiles_reviewed: captured.tiles.length,
+                        provider_calls_avoided: 0,
+                        mismatch_threshold: DEFAULT_REUSE_MISMATCH_RATIO,
+                        invalidation: "no persisted baseline snapshot with critique results for this target/context",
+                    };
+                }
+                tilesToReview = qaReuse.review;
+                emit.log(`qa-reuse: ${qaReuse.tiles_reused}/${qaReuse.tiles_total} tiles reused (band-diff), ` +
+                    `${qaReuse.tiles_reviewed} reviewed fresh${qaReuse.invalidation ? ` — ${qaReuse.invalidation}` : ""}`, "info");
+            }
             critique = await runCritique({
                 url: navResult.url,
-                rubric: opts.checkCritiqueRubric ?? DEFAULT_CRITIQUE_RUBRIC,
-                tiles,
+                rubric,
+                tiles: tilesToReview,
                 provider: context?.critiqueProvider,
             });
         }
+        // Persist the QA baseline AFTER critique so a passing run's verdicts ride
+        // along with the snapshot (still before annotations mutate the page).
+        if (opts.qaSnapshot && qaCapture) {
+            const screenshotPng = critiqueFullPage ?? (await browser.fullPageScreenshotBuffer());
+            // Persist critique results only when the full tile set was freshly
+            // reviewed — a partially-reused run must never become the next
+            // baseline's finding record.
+            const fullCoverage = critique?.provider &&
+                critique.outcome !== "skipped" &&
+                critiqueTiles !== undefined &&
+                (!qaReuse || qaReuse.tiles_reused === 0);
+            const persistedCritique = fullCoverage && critique && critiqueTiles
+                ? {
+                    contract_version: QA_CRITIQUE_CONTRACT_VERSION,
+                    rubric_digest: rubricDigest(opts.checkCritiqueRubric ?? DEFAULT_CRITIQUE_RUBRIC),
+                    outcome: critique.outcome,
+                    findings: critique.findings,
+                    tiles: critiqueTiles.map((t) => ({
+                        index: t.index,
+                        label: t.label,
+                        x: t.x ?? 0,
+                        scrollY: t.scrollY,
+                        width: t.width,
+                        height: t.height,
+                    })),
+                }
+                : undefined;
+            const saved = saveQaSnapshot(qaCapture.target, qaCapture.context, {
+                signature: qaCapture.signature,
+                domHtml: qaCapture.domHtml,
+                screenshotPng,
+                ...(persistedCritique ? { critique: persistedCritique } : {}),
+            }, {});
+            if (qaPlan) {
+                qaPlan.snapshotSaved = {
+                    path: saved.path,
+                    target: qaCapture.target,
+                    context: qaCapture.context,
+                };
+            }
+            emit.log(`qa-snapshot: saved baseline for ${qaCapture.target} ` +
+                `[${qaCapture.context.viewport}/${qaCapture.context.theme}/${qaCapture.context.state}]` +
+                `${persistedCritique ? " (with critique results)" : ""}`, "info");
+        }
         let asserts;
         if (opts.assert && opts.assert.length > 0) {
             const specs = opts.assert.map(parseAssertSpec);
@@ -487,10 +619,10 @@ async function runBrowse(url, opts, context) {
             if (opts.baseline || opts.diff) {
                 throw new Error("--baseline / --diff require trio mode (screenshot file). Remove --snapshot/--html/--json or capture the screenshot first.");
             }
-            await runPrintMode(browser, navResult, opts, evalResult, visibility, widths, overflow, runts, layoutLint, hit, content, critique, asserts, devOverlay, batchResult);
+            await runPrintMode(browser, navResult, opts, evalResult, visibility, widths, overflow, runts, layoutLint, hit, content, critique, asserts, devOverlay, batchResult, qaPlan, qaReuse ? summarizeReuse(qaReuse) : undefined);
         }
         else {
-            await runTrioMode(browser, navResult, opts, evalResult, visibility, widths, overflow, runts, layoutLint, hit, content, critique, asserts, devOverlay, batchResult);
+            await runTrioMode(browser, navResult, opts, evalResult, visibility, widths, overflow, runts, layoutLint, hit, content, critique, asserts, devOverlay, batchResult, qaPlan, qaReuse ? summarizeReuse(qaReuse) : undefined);
         }
         if (visibility && opts.checkVisibleAnnotate !== false) {
             await browser.clearVisibilityAnnotations();
@@ -688,7 +820,7 @@ function splitBatchSteps(input) {
 // ---------------------------------------------------------------------------
 // Print mode (--snapshot / --html / --json): stdout, no file writes
 // ---------------------------------------------------------------------------
-async function runPrintMode(browser, navResult, opts, evalResult, visibility, widths, overflow, runts, layoutLint, hit, content, critique, asserts, devOverlay, batchResult) {
+async function runPrintMode(browser, navResult, opts, evalResult, visibility, widths, overflow, runts, layoutLint, hit, content, critique, asserts, devOverlay, batchResult, qaPlan, qaReuse) {
     let body = null;
     if (opts.html) {
         body = await browser.htmlContent(opts.selector);
@@ -734,6 +866,10 @@ async function runPrintMode(browser, navResult, opts, evalResult, visibility, wi
             result.asserts = asserts;
         if (devOverlay)
             result.devOverlay = devOverlay;
+        if (qaPlan)
+            result.qaPlan = qaPlan;
+        if (qaReuse)
+            result.qaReuse = qaReuse;
         if (batchResult && batchResult.clipboardReads.length > 0) {
             result.batchClipboardReads = batchResult.clipboardReads;
         }
@@ -755,7 +891,7 @@ async function runPrintMode(browser, navResult, opts, evalResult, visibility, wi
 // ---------------------------------------------------------------------------
 // Trio mode (default): write <prefix>.{png,html,json}
 // ---------------------------------------------------------------------------
-async function runTrioMode(browser, navResult, opts, evalResult, visibility, widths, overflow, runts, layoutLint, hit, content, critique, asserts, devOverlay, batchResult) {
+async function runTrioMode(browser, navResult, opts, evalResult, visibility, widths, overflow, runts, layoutLint, hit, content, critique, asserts, devOverlay, batchResult, qaPlan, qaReuse) {
     const prefix = resolveOutPrefix(opts.out);
     mkdirSync(dirname(prefix), { recursive: true });
     const written = [];
@@ -837,6 +973,10 @@ async function runTrioMode(browser, navResult, opts, evalResult, visibility, wid
         envelope.asserts = asserts;
     if (devOverlay)
         envelope.devOverlay = devOverlay;
+    if (qaPlan)
+        envelope.qaPlan = qaPlan;
+    if (qaReuse)
+        envelope.qaReuse = qaReuse;
     if (batchResult && batchResult.clipboardReads.length > 0) {
         envelope.batchClipboardReads = batchResult.clipboardReads;
     }
@@ -1198,9 +1338,75 @@ function applyContentFailGates(opts, content) {
 // ---------------------------------------------------------------------------
 // Vision critique tiling
 // ---------------------------------------------------------------------------
-async function captureCritiqueTiles(browser, opts) {
+/** Envelope-safe reuse stats: everything except the `review` tiles, whose
+ * base64 PNGs would bloat the JSON by megabytes. */
+function summarizeReuse(plan) {
+    const { review: _review, ...rest } = plan;
+    return rest;
+}
+/**
+ * Diff-aware QA planning inside a browse run: capture the page's QA signature
+ * (before any annotation overlay mutates the DOM) and classify against the
+ * persisted baseline. Persistence happens later in the run — after critique —
+ * so a passing run's verdicts ride along with the snapshot; this helper only
+ * supplies the live-page inputs (signature, page height, explicit scope match
+ * counts). Classification and manifest math live in lib/browser/qa-plan.ts.
+ */
+async function runQaPlanning(browser, targetArg, renderedUrl, opts) {
+    const context = {
+        viewport: opts.viewport ?? "desktop",
+        theme: opts.qaTheme === "dark" ? "dark" : "light",
+        state: opts.qaState ?? "default",
+    };
+    const target = opts.qaTarget ?? targetArg;
+    const captured = await browser.qaSignature();
+    const signature = {
+        url: renderedUrl,
+        capturedAt: new Date().toISOString(),
+        nodes: captured.nodes,
+        stylesheets: captured.stylesheets,
+        ...(captured.truncated ? { truncated: true } : {}),
+    };
+    const report = {
+        signature: {
+            nodes: captured.nodes.length,
+            stylesheets: captured.stylesheets.length,
+            truncated: captured.truncated,
+        },
+    };
+    if (opts.qaPlan) {
+        const baseline = await resolveQaBaseline({ target, context });
+        const classification = classifySignatures(baseline.signature, signature);
+        // Full-page tile ceiling from the real page height and the critique
+        // tiling knobs, so the predicted cost matches what --check-critique
+        // would actually spend.
+        const pageHeight = await browser.currentPage.evaluate(() => Math.max(document.documentElement.scrollHeight, document.body?.scrollHeight ?? 0));
+        const band = Number.parseInt(opts.checkCritiqueBand ?? "1400", 10);
+        const overlap = Number.parseInt(opts.checkCritiqueOverlap ?? "120", 10);
+        const maxTiles = Number.parseInt(opts.checkCritiqueMaxTiles ?? "24", 10);
+        const estimatedFullPageTiles = Math.min(maxTiles, Math.max(1, Math.ceil(pageHeight / Math.max(1, band - overlap))));
+        const explicitScopes = [];
+        for (const selector of opts.qaScope ?? []) {
+            const matches = await browser.currentPage.evaluate((sel) => document.querySelectorAll(sel).length, selector);
+            explicitScopes.push({ selector, reason: "explicit input (--qa-scope)", matches });
+        }
+        report.classification = classification;
+        report.manifest = buildQaManifest(classification, {
+            baselineSource: baseline.source,
+            ...(explicitScopes.length > 0 ? { explicitScopes } : {}),
+            ...(opts.qaStates?.length ? { states: opts.qaStates } : {}),
+            ...(opts.assert?.length ? { outcomeAssertions: opts.assert } : {}),
+            estimatedFullPageTiles,
+        });
+    }
+    return { report, capture: { target, context, signature, domHtml: captured.domHtml } };
+}
+async function captureCritiqueTiles(browser, opts, tileBudgetPx) {
     const maxTiles = Math.max(1, Number.parseInt(opts.checkCritiqueMaxTiles ?? "24", 10));
-    const band = Math.max(200, Number.parseInt(opts.checkCritiqueBand ?? "1400", 10));
+    // The routed provider's vision long-edge budget caps band height so tiles
+    // are never silently downscaled by the model.
+    const bandFlag = Math.max(200, Number.parseInt(opts.checkCritiqueBand ?? "1400", 10));
+    const band = tileBudgetPx ? Math.max(200, Math.min(bandFlag, tileBudgetPx)) : bandFlag;
     const overlap = Math.max(0, Number.parseInt(opts.checkCritiqueOverlap ?? "120", 10));
     // Capture the whole page ONCE, then crop tiles from the pixels. Playwright's
     // clip is viewport-relative, so a below-fold band clip throws ("clipped area
@@ -1210,14 +1416,30 @@ async function captureCritiqueTiles(browser, opts) {
     const elementRects = typeof opts.checkCritique === "string"
         ? await browser.elementTiles(opts.checkCritique)
         : undefined;
-    const tiles = tilesFromFullPage(buffer, { elementRects, bandHeight: band, overlap, maxTiles });
+    // Content-aware seams: atoms let band cuts snap into gaps and over-tall
+    // selector tiles band internally. Extraction failing is never fatal — the
+    // tiler falls back to fixed bands, today's behavior.
+    let atoms;
+    try {
+        atoms = await browser.visualAtoms();
+    }
+    catch {
+        atoms = undefined;
+    }
+    const tiles = tilesFromFullPage(buffer, {
+        elementRects,
+        bandHeight: band,
+        overlap,
+        maxTiles,
+        atoms,
+    });
     if (elementRects && elementRects.length > maxTiles) {
         emit.log(`check-critique: ${elementRects.length} elements matched, capped to ${maxTiles} tiles`, "warn");
     }
     else if (!elementRects && tiles.length >= maxTiles) {
         emit.log(`check-critique: page banded to the ${maxTiles}-tile cap (raise --check-critique-max-tiles for full coverage)`, "warn");
     }
-    return tiles;
+    return { tiles, fullPage: buffer };
 }
 function logCritiqueSummary(critique) {
     if (critique.outcome === "skipped") {

package/dist/commands/checkpoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/commands/checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAU1E;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CA2HN"}
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/commands/checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAW1E;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CA2HN"}

package/dist/commands/checkpoint.js

@@ -1,4 +1,5 @@
-import { monorepoRoot, readHeartbeat, resolveOwner } from "../core/agents/index.js";
+import { monorepoRoot, resolveOwner } from "../core/agents/index.js";
+import { readLiveCoordinationRow } from "../core/agents/state/live-coordination-view.js";
 import { checkpointContext, readContextState, readLatestCapsule, } from "../core/context/index.js";
 /**
  * `harn checkpoint`: durable context continuity across compaction.
@@ -126,7 +127,7 @@ function resolveContinuityIdentity(context, opts) {
     if (!instanceId) {
         throw new Error("could not resolve the current agent; pass --instance and --session");
     }
-    const heartbeat = readHeartbeat(instanceId);
+    const heartbeat = readLiveCoordinationRow(coordRoot, instanceId);
     const sessionId = opts.session ?? heartbeat?.session_id ?? instanceId;
     const adapter = opts.adapter
         ? parseAdapter(opts.adapter)

package/dist/commands/claude-desktop.d.ts

@@ -15,5 +15,5 @@ import type { EmitContext, HarneryProgramContext } from "../commander.js";
  * desktop app picks the copies up, and opening one resumes with full
  * history.
  */
-export declare function registerClaudeDesktopCommand(program: Command, emit: EmitContext, context?: HarneryProgramContext): void;
+export declare function registerClaudeDesktopCommand(program: Command, emit: EmitContext, _context?: HarneryProgramContext): void;
 //# sourceMappingURL=claude-desktop.d.ts.map

package/dist/commands/claude-desktop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-desktop.d.ts","sourceRoot":"","sources":["../../src/commands/claude-desktop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAc1E;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CA6PN"}
+{"version":3,"file":"claude-desktop.d.ts","sourceRoot":"","sources":["../../src/commands/claude-desktop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAU1E;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,IAAI,CA8JN"}

package/dist/commands/claude-desktop.js

@@ -1,5 +1,4 @@
-import { monorepoRoot } from "../core/agents/index.js";
-import { applyMirror, applyTidy, findDesktopDataDirs, listAccounts, planMirror, planTidy, readCliAccount, readDesktopLifecycleIndex, } from "../lib/claude-desktop.js";
+import { applyMirror, findDesktopDataDirs, listAccounts, planMirror, readCliAccount, } from "../lib/claude-desktop.js";
 /**
  * `claude-desktop`: make Claude desktop-app sessions survive account
  * switches.
@@ -15,10 +14,10 @@ import { applyMirror, applyTidy, findDesktopDataDirs, listAccounts, planMirror,
  * desktop app picks the copies up, and opening one resumes with full
  * history.
  */
-export function registerClaudeDesktopCommand(program, emit, context) {
+export function registerClaudeDesktopCommand(program, emit, _context) {
     const cmd = program
         .command("claude-desktop")
-        .description("Claude desktop-app session index: list, mirror, and archive completed sessions")
+        .description("Claude desktop-app session index: list and mirror sessions across accounts")
         .action(() => {
         const dirs = requireDataDirs(emit, undefined);
         for (const dir of dirs) {
@@ -142,76 +141,6 @@ export function registerClaudeDesktopCommand(program, emit, context) {
             });
         }
     });
-    cmd
-        .command("tidy")
-        .description("Archive desktop sidebar entries whose mapped Harnery lifecycle is done. " +
-        "Dry-run by default; --yes applies atomic entry updates.")
-        .option("--data-dir <path>", "Explicit desktop-app data directory")
-        .option("--account <uuid-prefix>", "Only entries under accounts matching this UUID prefix (repeatable)", collect, [])
-        .option("--include-legacy-prefix", "Also archive unmatched historical entries whose title starts with [DONE]")
-        .option("--yes", "Apply the archive plan (default is dry-run)")
-        .action(async (opts) => {
-        const dirs = requireDataDirs(emit, opts.dataDir);
-        const coordRoot = context?.resolveCoordRoot?.() ?? context?.repoRoot ?? monorepoRoot() ?? process.cwd();
-        const lifecycle = await readDesktopLifecycleIndex(coordRoot);
-        for (const dir of dirs) {
-            const plan = planTidy(listAccounts(dir), lifecycle, {
-                accounts: opts.account,
-                includeLegacyPrefix: opts.includeLegacyPrefix,
-            });
-            const planned = plan.actions.map((action) => ({
-                account_uuid: action.entry.accountUuid,
-                cli_session_id: action.entry.cliSessionId,
-                title: action.entry.title,
-                source: action.source,
-                lifecycle_updated_at: action.lifecycle?.updatedAt ?? null,
-                file: action.entry.file,
-            }));
-            const skipped = plan.skipped
-                .map((skip) => ({
-                account_uuid: skip.entry.accountUuid,
-                cli_session_id: skip.entry.cliSessionId,
-                title: skip.entry.title,
-                reason: skip.reason,
-                lifecycle: skip.lifecycle?.state ?? null,
-            }))
-                .filter((skip) => skip.reason !== "already_archived");
-            const skippedByReason = Object.fromEntries([
-                "already_archived",
-                "blocked_title",
-                "lifecycle_active",
-                "lifecycle_blocked",
-                "unmatched",
-            ].map((reason) => [
-                reason,
-                plan.skipped.filter((skip) => skip.reason === reason).length,
-            ]));
-            if (!opts.yes) {
-                emit.data({
-                    data_dir: dir,
-                    dry_run: true,
-                    planned,
-                    skipped,
-                    skipped_by_reason: skippedByReason,
-                    hint: plan.actions.length > 0 ? "re-run with --yes to archive" : "nothing to archive",
-                });
-                continue;
-            }
-            const result = applyTidy(plan);
-            emit.data({
-                data_dir: dir,
-                dry_run: false,
-                archived: result.archived,
-                already_archived: result.alreadyArchived,
-                planned,
-                skipped,
-                skipped_by_reason: skippedByReason,
-                hint: result.archived > 0
-                    ? "fully quit the Claude desktop app (tray icon, not the X) and relaunch to refresh the sidebar"
-                    : "nothing to archive",
-            });
-        }
-    });
 }
 function collect(value, previous) {
     return previous.concat([value]);

package/dist/commands/context.js

@@ -84,10 +84,6 @@ function renderSelf(s) {
     body.push(`  agent-${s.name ?? "?"}  (${formatAge(s.session_age_secs)} old, owner=${s.instance_id.slice(0, 8)}…)`);
     if (s.task)
         body.push(`  task:    "${s.task}"`);
-    if (s.last_tool) {
-        const target = s.last_tool_target ? `  ${truncate(s.last_tool_target, 80)}` : "";
-        body.push(`  last:    ${s.last_tool}${target}`);
-    }
     if (s.files_held.length > 0) {
         body.push(`  holds ${s.files_held.length} file(s):`);
         for (const f of s.files_held.slice(0, 5))
@@ -150,8 +146,7 @@ function renderPeers(p) {
     const lines = p.rows.map((peer) => {
         const taskBit = peer.task ? ` "${truncate(peer.task, 40)}"` : "";
         const filesBit = peer.files > 0 ? `${peer.files}f` : "0f";
-        const lastBit = peer.last_tool ? `, last: ${peer.last_tool}` : "";
-        return `  agent-${peer.name.padEnd(12)}${taskBit}  (${peer.age_min}m old, ${filesBit}${lastBit})`;
+        return `  agent-${peer.name.padEnd(12)}${taskBit}  (${peer.age_min}m old, ${filesBit})`;
     });
     return section("peers", lines);
 }

package/dist/commands/decision.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../src/commands/decision.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AA6CnD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,GAAG,IAAI,CAsTtF"}
+{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../src/commands/decision.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAwCnD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,GAAG,IAAI,CAgStF"}