harnery 0.35.0 → 0.37.0

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;AAc1E,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;AAe1E,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CAiIN"}

package/dist/commands/artifacts.js

@@ -1,6 +1,6 @@
 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 { adoptUnmanagedArtifactFiles, cleanArtifacts, createArtifact, inventoryArtifacts, releaseArtifact, renewArtifact, showArtifact, } from "../core/artifacts/index.js";
 import { artifactDefaultRetentionDays, coordFreshnessSeconds } from "../core/config.js";
 export function registerArtifactsCommand(program, emit, context) {
     const root = program
@@ -12,6 +12,7 @@ export function registerArtifactsCommand(program, emit, context) {
         .description("Create one managed artifact workspace and print its path.")
         .requiredOption("--purpose <text>", "What the files are for")
         .option("--days <n>", "Retention in days (default from artifacts.default_retention_days)")
+        .option("--big", "Acknowledge that this workspace may exceed the per-bundle size ceiling")
         .action((slug, opts) => {
         run(emit, () => {
             const repoRoot = requireRepoRoot(context);
@@ -24,6 +25,7 @@ export function registerArtifactsCommand(program, emit, context) {
                 purpose: opts.purpose,
                 retentionDays,
                 actor,
+                big: opts.big,
             });
             emit.data({
                 path: created.path,
@@ -33,6 +35,27 @@ export function registerArtifactsCommand(program, emit, context) {
             });
         });
     });
+    root
+        .command("adopt-unmanaged")
+        .description("Preview loose direct-child files, or move them into one managed workspace.")
+        .option("--purpose <text>", "Why the adopted files are being retained", "Adopt legacy loose artifact files")
+        .option("--days <n>", "Retention in days (default from artifacts.default_retention_days)")
+        .option("--big", "Acknowledge an adopted bundle above the per-bundle size ceiling")
+        .option("--yes", "Move the exact previewed regular files into a managed workspace")
+        .action((opts) => {
+        run(emit, () => {
+            const repoRoot = requireRepoRoot(context);
+            emit.data(adoptUnmanagedArtifactFiles(repoRoot, {
+                yes: opts.yes,
+                big: opts.big,
+                purpose: opts.purpose,
+                retentionDays: opts.days
+                    ? parseDays(opts.days)
+                    : artifactDefaultRetentionDays(repoRoot),
+                actor: currentActor(repoRoot),
+            }));
+        });
+    });
     root
         .command("list")
         .description("Inventory every artifact workspace with its cleanup classification.")
@@ -125,9 +148,11 @@ function summarize(rows) {
     }
     return {
         total: rows.length,
+        bytes: rows.reduce((sum, row) => sum + (row.bytes ?? 0), 0),
         classifications,
         would_delete: rows.filter((row) => row.action === "would-delete").length,
         deleted: rows.filter((row) => row.action === "deleted").length,
+        would_delete_bytes: rows.reduce((sum, row) => sum + (row.action === "would-delete" ? (row.bytes ?? 0) : 0), 0),
     };
 }
 function run(emit, fn) {

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,CA6N/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,CAiO/E"}

package/dist/commands/backup.js

@@ -86,8 +86,8 @@ export function registerBackupCommand(program, emit) {
     backup
         .command("init")
         .description("Create the restic repository + password file (one-time).")
-        .option("--repo <path>", `Repository path (default: ${defaultRepo()})`)
-        .option("--password-file <path>", `Password file (default: ${defaultPasswordFile()}, autogenerated)`)
+        .option("--repo <path>", "Repository path (default: configured backup.repo)")
+        .option("--password-file <path>", "Password file (default: configured backup.password_file; autogenerated)")
         .action((opts) => {
         if (!checkRestic(emit)) {
             emit.setExitCode(1);
@@ -219,13 +219,12 @@ export function registerBackupCommand(program, emit) {
     // -- prune --
     // Prune-policy defaults come from backup.keep_* in config.jsonc (falling back
     // to 7/4/6); an explicit --keep-* flag still overrides per invocation.
-    const prunePolicy = backupConfig();
     backup
         .command("prune")
-        .description(`Forget + prune snapshots (default policy: keep ${prunePolicy.keepDaily} daily / ${prunePolicy.keepWeekly} weekly / ${prunePolicy.keepMonthly} monthly).`)
-        .option("--keep-daily <n>", "Daily snapshots to keep", String(prunePolicy.keepDaily))
-        .option("--keep-weekly <n>", "Weekly snapshots to keep", String(prunePolicy.keepWeekly))
-        .option("--keep-monthly <n>", "Monthly snapshots to keep", String(prunePolicy.keepMonthly))
+        .description("Forget + prune snapshots (default policy comes from backup.keep_* config).")
+        .option("--keep-daily <n>", "Daily snapshots to keep (default: configured backup.keep_daily)")
+        .option("--keep-weekly <n>", "Weekly snapshots to keep (default: configured backup.keep_weekly)")
+        .option("--keep-monthly <n>", "Monthly snapshots to keep (default: configured backup.keep_monthly)")
         .option("--dry-run", "Show what would be pruned without actually pruning")
         .option("--repo <path>", "Repository path")
         .option("--password-file <path>", "Password file")
@@ -234,14 +233,15 @@ export function registerBackupCommand(program, emit) {
             emit.setExitCode(1);
             return;
         }
+        const prunePolicy = backupConfig();
         const args = [
             "forget",
             "--keep-daily",
-            opts.keepDaily,
+            opts.keepDaily ?? String(prunePolicy.keepDaily),
             "--keep-weekly",
-            opts.keepWeekly,
+            opts.keepWeekly ?? String(prunePolicy.keepWeekly),
             "--keep-monthly",
-            opts.keepMonthly,
+            opts.keepMonthly ?? String(prunePolicy.keepMonthly),
         ];
         if (!opts.dryRun)
             args.push("--prune");

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

@@ -1 +1 @@
-{"version":3,"file":"browse-session.d.ts","sourceRoot":"","sources":["../../src/commands/browse-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAOtE,UAAU,eAAe;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,WAAY,SAAQ,eAAe;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CA4GtF;AAYD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,GAAG,qBAAqB,CAAC;AAC9F,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,KAAK,GACd,qBAAqB,GAAG,SAAS,CAAC;AAoDrC,wBAAsB,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBpE"}
+{"version":3,"file":"browse-session.d.ts","sourceRoot":"","sources":["../../src/commands/browse-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAOtE,UAAU,eAAe;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,WAAY,SAAQ,eAAe;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAwHtF;AAYD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,GAAG,qBAAqB,CAAC;AAC9F,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,KAAK,GACd,qBAAqB,GAAG,SAAS,CAAC;AAoDrC,wBAAsB,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBpE"}

package/dist/commands/browse-session.js

@@ -5,6 +5,7 @@ export function registerBrowseSessionCommand(program, emit) {
         .description("Control an opted-in headed browse session through an owner-only descriptor");
     session
         .command("status")
+        .description("Report whether the opted-in browser session is reachable")
         .requiredOption("--control-file <path>", "Owner-only session descriptor")
         .action((opts) => runAction(emit, opts.controlFile, "status", {}));
     addLocatorOptions(session
@@ -16,37 +17,45 @@ export function registerBrowseSessionCommand(program, emit) {
     });
     session
         .command("screenshot")
+        .description("Capture the active tab to a new PNG file")
         .requiredOption("--control-file <path>", "Owner-only session descriptor")
         .requiredOption("--out <path>", "New PNG path in an existing directory")
         .action((opts) => runAction(emit, opts.controlFile, "screenshot", { out: opts.out }));
     session
         .command("tabs")
+        .description("List open tabs with stable session-local indexes")
         .requiredOption("--control-file <path>", "Owner-only session descriptor")
         .action((opts) => runAction(emit, opts.controlFile, "tabs", {}));
     session
         .command("select-tab")
+        .description("Select an open tab by its stable session-local index")
         .requiredOption("--control-file <path>", "Owner-only session descriptor")
         .requiredOption("--index <n>", "Stable session-local tab index", parseIndex)
         .action((opts) => runAction(emit, opts.controlFile, "select_tab", { index: opts.index }));
     session
         .command("open-tab <url>")
+        .description("Open a URL in a new tab and select it")
         .requiredOption("--control-file <path>", "Owner-only session descriptor")
         .action((url, opts) => runAction(emit, opts.controlFile, "open_tab", { url }));
     session
         .command("close-tab")
+        .description("Close an open tab by its stable session-local index")
         .requiredOption("--control-file <path>", "Owner-only session descriptor")
         .requiredOption("--index <n>", "Stable session-local tab index", parseIndex)
         .action((opts) => runAction(emit, opts.controlFile, "close_tab", { index: opts.index }));
     session
         .command("goto <url>")
+        .description("Navigate the active tab to a URL")
         .requiredOption("--control-file <path>", "Owner-only session descriptor")
         .action((url, opts) => runAction(emit, opts.controlFile, "goto", { url }));
     session
         .command("reload")
+        .description("Reload the active tab")
         .requiredOption("--control-file <path>", "Owner-only session descriptor")
         .action((opts) => runAction(emit, opts.controlFile, "reload", {}));
     addLocatorOptions(session
         .command("click")
+        .description("Click one strict locator in the active tab")
         .requiredOption("--control-file <path>", "Owner-only session descriptor")).action((opts) => runAction(emit, opts.controlFile, "click", { locator: parseLocatorOptions(opts, true) }));
     addLocatorOptions(session
         .command("fill")
@@ -60,13 +69,16 @@ export function registerBrowseSessionCommand(program, emit) {
     });
     session
         .command("press <key>")
+        .description("Press a keyboard key in the active tab")
         .requiredOption("--control-file <path>", "Owner-only session descriptor")
         .action((key, opts) => runAction(emit, opts.controlFile, "press", { key }));
     addLocatorOptions(session
         .command("wait")
+        .description("Wait for one strict locator in the active tab")
         .requiredOption("--control-file <path>", "Owner-only session descriptor")).action((opts) => runAction(emit, opts.controlFile, "wait", { locator: parseLocatorOptions(opts, true) }));
     session
         .command("close")
+        .description("Close the opted-in browser session")
         .requiredOption("--control-file <path>", "Owner-only session descriptor")
         .action((opts) => runAction(emit, opts.controlFile, "close", {}));
 }

package/dist/commands/browse.d.ts

@@ -1,4 +1,4 @@
 import type { Command } from "commander";
 import type { EmitContext, HarneryProgramContext } from "../commander.js";
-export declare function registerBrowseCommand(program: Command, emitParam: EmitContext, context?: HarneryProgramContext): void;
+export declare function registerBrowseCommand(program: Command, emitParam: EmitContext, context?: HarneryProgramContext, binName?: string): void;
 //# sourceMappingURL=browse.d.ts.map

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;AAgO1E,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,WAAW,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CA+cN"}
+{"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;AAiO1E,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,WAAW,EACtB,OAAO,CAAC,EAAE,qBAAqB,EAC/B,OAAO,SAAmB,GACzB,IAAI,CAqdN"}

package/dist/commands/browse.js

@@ -41,7 +41,7 @@ const VIEWPORT_PRESETS = {
 // cookies/read: the many helper functions in this large file close over
 // `emit` so action callbacks stay concise.
 let emit;
-export function registerBrowseCommand(program, emitParam, context) {
+export function registerBrowseCommand(program, emitParam, context, binName = resolveBinName()) {
     emit = emitParam;
     program
         .command("browse <url>")
@@ -50,7 +50,7 @@ export function registerBrowseCommand(program, emitParam, context) {
         .option("--no-screenshot", "Skip the .png in the trio (DOM + JSON only)")
         .option("--no-full-page", "Capture only the viewport, not the full scrollable page")
         .option("--snapshot", "Print body innerText to stdout (skips file writes)")
-        .option("--html", `Print raw outer HTML to stdout (skips file writes; pair with \`${resolveBinName()} read -\`)`)
+        .option("--html", `Print raw outer HTML to stdout (skips file writes; pair with \`${binName} read -\`)`)
         .option("--json", "Print full JSON envelope to stdout (skips file writes)")
         .option("--selector <css>", "Scope --html / --snapshot to one element")
         .option("--click <selector>", "Click this selector after navigation")
@@ -64,6 +64,9 @@ export function registerBrowseCommand(program, emitParam, context) {
         'Example: `--batch "click button; wait 1500; reload; wait 3000"`. `reload` preserves sessionStorage + cookies, which is how to repro sessionStorage-restored UI state.')
         .option("--network-har <path>", "Record network traffic to a HAR file (finalized on close)")
         .option("--viewport <preset|WxH>", "Viewport: mobile (390x844), tablet (820x1180), desktop (1280x800), hd (1920x1080), or explicit '1920x1080'", "desktop")
+        .option("--color-scheme <scheme>", "Emulate prefers-color-scheme for the whole session: light | dark. " +
+        "Renders theme-aware pages in that scheme without page-specific toggles. " +
+        "Absent = browser default (unchanged behavior).")
         .option("--login", "Headed mode for one-time auth flow (cookies persist in profile)")
         .option("--login-close-file <path>", "With --login, wait for this file instead of terminal Enter, then remove it and close cleanly")
         .option("--control-file <path>", "With --login, publish an owner-only descriptor for repeated browse-session control")
@@ -265,6 +268,13 @@ async function runBrowse(url, opts, context) {
         : new CookieJar({ path: opts.store ?? DEFAULT_STORE, source: "harn-browse" });
     const headed = opts.login || opts.headed;
     const viewport = parseViewport(opts.viewport ?? "desktop");
+    let colorScheme;
+    if (opts.colorScheme !== undefined) {
+        if (opts.colorScheme !== "light" && opts.colorScheme !== "dark") {
+            throw new Error(`--color-scheme must be light or dark (got: ${opts.colorScheme}).`);
+        }
+        colorScheme = opts.colorScheme;
+    }
     const proxy = opts.proxyFromEnv ? browserProxyFromEnv() : undefined;
     const proxyGate = opts.proxyFromEnv ? browserProxyGateFromEnv() : null;
     if (opts.loginCloseFile && !opts.login) {
@@ -282,6 +292,7 @@ async function runBrowse(url, opts, context) {
         headed,
         jar,
         viewport,
+        ...(colorScheme ? { colorScheme } : {}),
         navigationTimeout: Number.parseInt(opts.timeout, 10),
         waitUntil: opts.waitUntil,
         recordHarPath: opts.networkHar ? resolve(opts.networkHar) : undefined,
@@ -440,8 +451,9 @@ async function runBrowse(url, opts, context) {
         let critiqueTiles;
         let critiqueFullPage;
         if (opts.checkCritique !== undefined) {
+            const critiqueProvider = context?.critiqueProvider ?? (await context?.critiqueProviderLoader?.());
             const rubric = opts.checkCritiqueRubric ?? DEFAULT_CRITIQUE_RUBRIC;
-            const captured = await captureCritiqueTiles(browser, opts, context?.critiqueProvider?.tileBudgetPx);
+            const captured = await captureCritiqueTiles(browser, opts, critiqueProvider?.tileBudgetPx);
             critiqueTiles = captured.tiles;
             critiqueFullPage = captured.fullPage;
             let tilesToReview = captured.tiles;
@@ -485,7 +497,7 @@ async function runBrowse(url, opts, context) {
                 url: navResult.url,
                 rubric,
                 tiles: tilesToReview,
-                provider: context?.critiqueProvider,
+                provider: critiqueProvider,
             });
         }
         // Persist the QA baseline AFTER critique so a passing run's verdicts ride

package/dist/commands/conversations.d.ts

@@ -0,0 +1,10 @@
+import type { Command } from "commander";
+import type { EmitContext } from "../commander.js";
+import type { HarneryConversationCatalog } from "../core/conversations/catalog.js";
+import type { HarneryConversationRecordV1 } from "../core/conversations/contract.js";
+export interface RegisterConversationsOptions {
+    project_scope_id: string;
+    records?: () => readonly HarneryConversationRecordV1[];
+}
+export declare function registerConversationsCommand(program: Command, emit: EmitContext, catalog?: HarneryConversationCatalog, dependencies?: RegisterConversationsOptions): void;
+//# sourceMappingURL=conversations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../../src/commands/conversations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAEnF,OAAO,KAAK,EAEV,2BAA2B,EAE5B,MAAM,mCAAmC,CAAC;AAQ3C,MAAM,WAAW,4BAA4B;IAC3C,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,SAAS,2BAA2B,EAAE,CAAC;CACxD;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,0BAA0B,EACpC,YAAY,CAAC,EAAE,4BAA4B,GAC1C,IAAI,CAkJN"}

package/dist/commands/conversations.js

@@ -0,0 +1,201 @@
+import { buildConversationContextPack } from "../core/conversations/context-pack.js";
+import { planConversationPurge, validatePurgeExecutionRequest, } from "../core/conversations/lifecycle.js";
+import { queryConversationCatalog } from "../core/conversations/query.js";
+export function registerConversationsCommand(program, emit, catalog, dependencies) {
+    const pendingPlans = new Map();
+    const conversations = program.command("conversations").description("Query conversation evidence");
+    conversations
+        .command("list")
+        .option("--provider <id>")
+        .option("--project <id>")
+        .option("--json")
+        .action(async (options) => {
+        await run(emit, async () => {
+            const configured = requireConversations(catalog, dependencies);
+            const project = exactProject(configured.dependencies.project_scope_id, options.project);
+            const providers = options.provider
+                ? [configured.catalog.require(options.provider)]
+                : configured.catalog.list();
+            const rows = (await Promise.all(providers.map(async (provider) => provider.capabilities.can_list ? provider.list(project) : []))).flat();
+            if (options.json) {
+                emit.config({ format: "json" });
+                emit.data({ schema: "harnery.conversation-list/v1", project_scope_id: project, rows });
+            }
+            else
+                emit.rows(rows);
+        });
+    });
+    addQueryOptions(conversations.command("query"))
+        .option("--json")
+        .action(async (options) => {
+        await run(emit, async () => {
+            const configured = requireConversations(catalog, dependencies);
+            const result = await queryConversationCatalog(configured.catalog, request(configured.dependencies, options));
+            if (options.json) {
+                emit.config({ format: "json" });
+                emit.data(result);
+            }
+            else {
+                emit.rows(result.hits.map(({ record, citation }) => ({
+                    ...citation,
+                    content: record.content,
+                })));
+            }
+        });
+    });
+    addQueryOptions(conversations.command("context"))
+        .option("--max-tokens <count>", "Token ceiling", parsePositive, 2_000)
+        .option("--max-bytes <count>", "Byte ceiling", parsePositive, 16_000)
+        .option("--json")
+        .action(async (options) => {
+        await run(emit, async () => {
+            const configured = requireConversations(catalog, dependencies);
+            const result = await queryConversationCatalog(configured.catalog, request(configured.dependencies, options));
+            const pack = buildConversationContextPack(result, {
+                max_tokens: options.maxTokens,
+                max_bytes: options.maxBytes,
+            });
+            if (options.json)
+                emit.config({ format: "json" });
+            emit.data(pack);
+        });
+    });
+    conversations
+        .command("archive")
+        .requiredOption("--mode <mode>", "off | source | archive")
+        .option("--authority <mode>", "shadow | cutover | rollback", "shadow")
+        .option("--yes", "Reserved for a future checked capture transaction")
+        .action((options) => {
+        const validMode = ["off", "source", "archive"].includes(options.mode);
+        const validAuthority = ["shadow", "cutover", "rollback"].includes(options.authority);
+        if (!validMode || !validAuthority) {
+            emit.error({ code: "conversation_archive_mode_invalid", message: "invalid archive mode" });
+            emit.setExitCode(1);
+            return;
+        }
+        emit.data({
+            schema: "harnery.conversation-archive-plan/v1",
+            access_mode: options.mode,
+            authority_mode: options.authority,
+            dry_run: true,
+            writes: false,
+            execution_enabled: false,
+        });
+    });
+    conversations
+        .command("purge")
+        .option("--conversation <id>")
+        .option("--before <time>")
+        .option("--transaction <id>")
+        .option("--yes")
+        .option("--json")
+        .action((options) => {
+        try {
+            const configured = requireConversations(catalog, dependencies);
+            if (options.transaction) {
+                const plan = pendingPlans.get(options.transaction);
+                if (!plan)
+                    throw new Error(`unknown purge transaction: ${options.transaction}`);
+                const result = validatePurgeExecutionRequest(plan, options.transaction, options.yes ?? false);
+                if (options.json)
+                    emit.config({ format: "json" });
+                emit.data({ schema: "harnery.conversation-purge-result/v1", ...result });
+                if (result.reason_code !== "execution_disabled")
+                    emit.setExitCode(1);
+                return;
+            }
+            const plan = planConversationPurge({
+                records: configured.dependencies.records?.() ?? [],
+                project_scope_id: configured.dependencies.project_scope_id,
+                ...(options.conversation ? { conversation_id: options.conversation } : {}),
+                ...(options.before ? { before: options.before } : {}),
+            });
+            pendingPlans.set(plan.transaction_id, plan);
+            if (options.json)
+                emit.config({ format: "json" });
+            emit.data(plan);
+        }
+        catch (error) {
+            emit.error({
+                code: "conversation_purge_failed",
+                message: error instanceof Error ? error.message : String(error),
+            });
+            emit.setExitCode(1);
+        }
+    });
+}
+function requireConversations(catalog, dependencies) {
+    if (!catalog || !dependencies)
+        throw new Error("conversation providers are not configured by this host");
+    return { catalog, dependencies };
+}
+function addQueryOptions(command) {
+    return command
+        .option("--text <literal>")
+        .option("--regex <pattern>")
+        .option("--role <role>")
+        .option("--since <time>")
+        .option("--until <time>")
+        .option("--project <id>")
+        .option("--provider <id>")
+        .option("--session <id>")
+        .option("--conversation <id>")
+        .option("--record <id>")
+        .option("--limit <count>", "Match ceiling", parsePositive, 20)
+        .option("--context-before <count>", "Earlier neighbors", parseNonnegative, 0)
+        .option("--context-after <count>", "Later neighbors", parseNonnegative, 0);
+}
+function request(dependencies, options) {
+    const role = options.role;
+    return {
+        project_scope_id: exactProject(dependencies.project_scope_id, options.project),
+        limit: options.limit,
+        context_before: options.contextBefore,
+        context_after: options.contextAfter,
+        budgets: {
+            max_source_records: 10_000,
+            max_decoded_bytes: 16 * 1_024 * 1_024,
+            max_matches: options.limit,
+            max_wall_ms: 5_000,
+            max_regex_chars: 256,
+        },
+        ...(options.text ? { text: options.text } : {}),
+        ...(options.regex ? { regex: options.regex } : {}),
+        ...(role ? { role } : {}),
+        ...(options.since ? { since: options.since } : {}),
+        ...(options.until ? { until: options.until } : {}),
+        ...(options.provider ? { provider_id: options.provider } : {}),
+        ...(options.session ? { session_id: options.session } : {}),
+        ...(options.conversation ? { conversation_id: options.conversation } : {}),
+        ...(options.record ? { record_id: options.record } : {}),
+    };
+}
+function exactProject(expected, requested) {
+    if (requested && requested !== expected)
+        throw new Error("cross-project conversation access denied");
+    return expected;
+}
+function parsePositive(value) {
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed <= 0)
+        throw new Error("expected a positive integer");
+    return parsed;
+}
+function parseNonnegative(value) {
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < 0)
+        throw new Error("expected a nonnegative integer");
+    return parsed;
+}
+async function run(emit, action) {
+    try {
+        await action();
+    }
+    catch (error) {
+        emit.error({
+            code: "conversation_command_failed",
+            message: error instanceof Error ? error.message : String(error),
+        });
+        emit.setExitCode(1);
+    }
+}

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

@@ -1 +1 @@
-{"version":3,"file":"deinit.d.ts","sourceRoot":"","sources":["../../src/commands/deinit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAenD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAmHjG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE;IACtC,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAEV;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C"}
+{"version":3,"file":"deinit.d.ts","sourceRoot":"","sources":["../../src/commands/deinit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAgBnD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAwHjG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE;IACtC,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAEV;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C"}

package/dist/commands/deinit.js

@@ -31,6 +31,7 @@ import { relative, resolve } from "node:path";
 import { createInterface } from "node:readline";
 import { DEFAULT_BIN_NAME } from "../core/config.js";
 import { ADAPTER_SPECS } from "../core/hooks/adapter/events.js";
+import { removeIndexerExclusions } from "../lib/indexer-exclusions.js";
 import { removeInstructions } from "../lib/instructions/apply.js";
 import { removeGitHooks } from "../lib/instructions/git-hooks.js";
 import { unwireHooks } from "./init.js";
@@ -115,6 +116,10 @@ export function registerDeinitCommand(program, emit, binName) {
                     `(${remaining} other hook(s) kept)`);
             }
         }
+        // ── 1a′. editor indexer exclusions ─────────────────────────────────────
+        // Reverse only what init wrote: the managed .cursorindexingignore entry
+        // and the files.watcherExclude key. Consumer-authored entries stay.
+        actions.push(...removeIndexerExclusions(projectRoot, dryRun));
         // ── 1b. agent-facing instructions block + skills ───────────────────────
         const removed = removeInstructions(projectRoot, { adapter, dryRun });
         actions.push(...removed.actions, ...removed.warnings.map((w) => `! ${w}`));

package/dist/commands/diagnostics.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "commander";
+import type { EmitContext, HarneryProgramContext } from "../commander.js";
+export declare function registerDiagnosticsCommand(program: Command, emit: EmitContext, context?: HarneryProgramContext): void;
+//# sourceMappingURL=diagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/commands/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAyB1E,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CAiKN"}