harnery 0.35.0 → 0.37.0

package/src/commands/artifacts.ts

@@ -4,6 +4,7 @@ import { monorepoRoot, resolveOwner } from "../core/agents/index.ts";
 import { readLiveCoordinationRow } from "../core/agents/state/live-coordination-view.ts";
 import {
   type ArtifactActor,
+  adoptUnmanagedArtifactFiles,
   cleanArtifacts,
   createArtifact,
   inventoryArtifacts,
@@ -28,7 +29,8 @@ export function registerArtifactsCommand(
     .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)")
-    .action((slug: string, opts: { purpose: string; days?: string }) => {
+    .option("--big", "Acknowledge that this workspace may exceed the per-bundle size ceiling")
+    .action((slug: string, opts: { purpose: string; days?: string; big?: boolean }) => {
       run(emit, () => {
         const repoRoot = requireRepoRoot(context);
         const actor = currentActor(repoRoot);
@@ -40,6 +42,7 @@ export function registerArtifactsCommand(
           purpose: opts.purpose,
           retentionDays,
           actor,
+          big: opts.big,
         });
         emit.data({
           path: created.path,
@@ -50,6 +53,34 @@ export function registerArtifactsCommand(
       });
     });
 
+  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: { purpose: string; days?: string; big?: boolean; yes?: boolean }) => {
+      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.")
@@ -143,16 +174,23 @@ function parseDays(value: string): number {
   return parsed;
 }
 
-function summarize(rows: { classification: string; action: string }[]): Record<string, unknown> {
+function summarize(
+  rows: { classification: string; action: string; bytes?: number | null }[],
+): Record<string, unknown> {
   const classifications: Record<string, number> = {};
   for (const row of rows) {
     classifications[row.classification] = (classifications[row.classification] ?? 0) + 1;
   }
   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,
+    ),
   };
 }
 

package/src/commands/backup.ts

@@ -108,10 +108,10 @@ export function registerBackupCommand(program: Command, emit: EmitContext): void
   backup
     .command("init")
     .description("Create the restic repository + password file (one-time).")
-    .option("--repo <path>", `Repository path (default: ${defaultRepo()})`)
+    .option("--repo <path>", "Repository path (default: configured backup.repo)")
     .option(
       "--password-file <path>",
-      `Password file (default: ${defaultPasswordFile()}, autogenerated)`,
+      "Password file (default: configured backup.password_file; autogenerated)",
     )
     .action((opts: BaseOpts) => {
       if (!checkRestic(emit)) {
@@ -257,24 +257,27 @@ export function registerBackupCommand(program: Command, emit: EmitContext): void
   // -- 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).`,
+    .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("--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))
     .option("--dry-run", "Show what would be pruned without actually pruning")
     .option("--repo <path>", "Repository path")
     .option("--password-file <path>", "Password file")
     .action(
       (
         opts: BaseOpts & {
-          keepDaily: string;
-          keepWeekly: string;
-          keepMonthly: string;
+          keepDaily?: string;
+          keepWeekly?: string;
+          keepMonthly?: string;
           dryRun?: boolean;
         },
       ) => {
@@ -282,14 +285,15 @@ export function registerBackupCommand(program: Command, emit: EmitContext): void
           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");
         else args.push("--dry-run");

package/src/commands/browse-session.ts

@@ -28,6 +28,7 @@ export function registerBrowseSessionCommand(program: Command, emit: EmitContext
 
   session
     .command("status")
+    .description("Report whether the opted-in browser session is reachable")
     .requiredOption("--control-file <path>", "Owner-only session descriptor")
     .action((opts: ControlFileOpts) => runAction(emit, opts.controlFile, "status", {}));
 
@@ -43,6 +44,7 @@ export function registerBrowseSessionCommand(program: Command, emit: EmitContext
 
   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: ControlFileOpts & { out: string }) =>
@@ -51,11 +53,13 @@ export function registerBrowseSessionCommand(program: Command, emit: EmitContext
 
   session
     .command("tabs")
+    .description("List open tabs with stable session-local indexes")
     .requiredOption("--control-file <path>", "Owner-only session descriptor")
     .action((opts: ControlFileOpts) => 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: ControlFileOpts & { index: number }) =>
@@ -64,6 +68,7 @@ export function registerBrowseSessionCommand(program: Command, emit: EmitContext
 
   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: string, opts: ControlFileOpts) =>
       runAction(emit, opts.controlFile, "open_tab", { url }),
@@ -71,6 +76,7 @@ export function registerBrowseSessionCommand(program: Command, emit: EmitContext
 
   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: ControlFileOpts & { index: number }) =>
@@ -79,6 +85,7 @@ export function registerBrowseSessionCommand(program: Command, emit: EmitContext
 
   session
     .command("goto <url>")
+    .description("Navigate the active tab to a URL")
     .requiredOption("--control-file <path>", "Owner-only session descriptor")
     .action((url: string, opts: ControlFileOpts) =>
       runAction(emit, opts.controlFile, "goto", { url }),
@@ -86,12 +93,14 @@ export function registerBrowseSessionCommand(program: Command, emit: EmitContext
 
   session
     .command("reload")
+    .description("Reload the active tab")
     .requiredOption("--control-file <path>", "Owner-only session descriptor")
     .action((opts: ControlFileOpts) => 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: LocatorOpts) =>
     runAction(emit, opts.controlFile, "click", { locator: parseLocatorOptions(opts, true) }),
@@ -112,6 +121,7 @@ export function registerBrowseSessionCommand(program: Command, emit: EmitContext
 
   session
     .command("press <key>")
+    .description("Press a keyboard key in the active tab")
     .requiredOption("--control-file <path>", "Owner-only session descriptor")
     .action((key: string, opts: ControlFileOpts) =>
       runAction(emit, opts.controlFile, "press", { key }),
@@ -120,6 +130,7 @@ export function registerBrowseSessionCommand(program: Command, emit: EmitContext
   addLocatorOptions(
     session
       .command("wait")
+      .description("Wait for one strict locator in the active tab")
       .requiredOption("--control-file <path>", "Owner-only session descriptor"),
   ).action((opts: LocatorOpts) =>
     runAction(emit, opts.controlFile, "wait", { locator: parseLocatorOptions(opts, true) }),
@@ -127,6 +138,7 @@ export function registerBrowseSessionCommand(program: Command, emit: EmitContext
 
   session
     .command("close")
+    .description("Close the opted-in browser session")
     .requiredOption("--control-file <path>", "Owner-only session descriptor")
     .action((opts: ControlFileOpts) => runAction(emit, opts.controlFile, "close", {}));
 }

package/src/commands/browse.ts

@@ -117,6 +117,7 @@ interface BrowseOpts {
   store?: string;
   profile?: string;
   viewport?: string;
+  colorScheme?: string;
   waitUntil: string;
   timeout: string;
   json?: boolean;
@@ -230,6 +231,7 @@ export function registerBrowseCommand(
   program: Command,
   emitParam: EmitContext,
   context?: HarneryProgramContext,
+  binName = resolveBinName(),
 ): void {
   emit = emitParam;
   program
@@ -246,7 +248,7 @@ export function registerBrowseCommand(
     .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 -\`)`,
+      `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")
@@ -274,6 +276,12 @@ export function registerBrowseCommand(
       "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>",
@@ -733,6 +741,13 @@ async function runBrowse(
       : new CookieJar({ path: opts.store ?? DEFAULT_STORE, source: "harn-browse" });
   const headed = opts.login || opts.headed;
   const viewport = parseViewport(opts.viewport ?? "desktop");
+  let colorScheme: "light" | "dark" | undefined;
+  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) {
@@ -753,6 +768,7 @@ async function runBrowse(
     headed,
     jar,
     viewport,
+    ...(colorScheme ? { colorScheme } : {}),
     navigationTimeout: Number.parseInt(opts.timeout, 10),
     waitUntil: opts.waitUntil as BrowseOpts["waitUntil"] as never,
     recordHarPath: opts.networkHar ? resolve(opts.networkHar) : undefined,
@@ -932,12 +948,10 @@ async function runBrowse(
     let critiqueTiles: CritiqueTile[] | undefined;
     let critiqueFullPage: Buffer | undefined;
     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;
@@ -984,7 +998,7 @@ async function runBrowse(
         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/src/commands/conversations.ts

@@ -0,0 +1,279 @@
+import type { Command } from "commander";
+import type { EmitContext } from "../commander.ts";
+import type { HarneryConversationCatalog } from "../core/conversations/catalog.ts";
+import { buildConversationContextPack } from "../core/conversations/context-pack.ts";
+import type {
+  HarneryConversationQueryRequest,
+  HarneryConversationRecordV1,
+  HarneryConversationRole,
+} from "../core/conversations/contract.ts";
+import {
+  type HarneryConversationPurgePlan,
+  planConversationPurge,
+  validatePurgeExecutionRequest,
+} from "../core/conversations/lifecycle.ts";
+import { queryConversationCatalog } from "../core/conversations/query.ts";
+
+export interface RegisterConversationsOptions {
+  project_scope_id: string;
+  records?: () => readonly HarneryConversationRecordV1[];
+}
+
+export function registerConversationsCommand(
+  program: Command,
+  emit: EmitContext,
+  catalog?: HarneryConversationCatalog,
+  dependencies?: RegisterConversationsOptions,
+): void {
+  const pendingPlans = new Map<string, HarneryConversationPurgePlan>();
+  const conversations = program.command("conversations").description("Query conversation evidence");
+
+  conversations
+    .command("list")
+    .option("--provider <id>")
+    .option("--project <id>")
+    .option("--json")
+    .action(async (options: { provider?: string; project?: string; json?: boolean }) => {
+      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 as unknown as Record<string, unknown>[]);
+      });
+    });
+
+  addQueryOptions(conversations.command("query"))
+    .option("--json")
+    .action(async (options: QueryOptions) => {
+      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: QueryOptions & { maxTokens: number; maxBytes: number; json?: boolean }) => {
+        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: { mode: string; authority: string; yes?: boolean }) => {
+      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: {
+        conversation?: string;
+        before?: string;
+        transaction?: string;
+        yes?: boolean;
+        json?: boolean;
+      }) => {
+        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?: HarneryConversationCatalog,
+  dependencies?: RegisterConversationsOptions,
+): {
+  catalog: HarneryConversationCatalog;
+  dependencies: RegisterConversationsOptions;
+} {
+  if (!catalog || !dependencies)
+    throw new Error("conversation providers are not configured by this host");
+  return { catalog, dependencies };
+}
+
+interface QueryOptions {
+  text?: string;
+  regex?: string;
+  role?: string;
+  since?: string;
+  until?: string;
+  project?: string;
+  provider?: string;
+  session?: string;
+  conversation?: string;
+  record?: string;
+  limit: number;
+  contextBefore: number;
+  contextAfter: number;
+  json?: boolean;
+}
+
+function addQueryOptions(command: Command): 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: RegisterConversationsOptions,
+  options: QueryOptions,
+): HarneryConversationQueryRequest {
+  const role = options.role as HarneryConversationRole | undefined;
+  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: string, requested?: string): string {
+  if (requested && requested !== expected)
+    throw new Error("cross-project conversation access denied");
+  return expected;
+}
+
+function parsePositive(value: string): number {
+  const parsed = Number(value);
+  if (!Number.isSafeInteger(parsed) || parsed <= 0) throw new Error("expected a positive integer");
+  return parsed;
+}
+
+function parseNonnegative(value: string): number {
+  const parsed = Number(value);
+  if (!Number.isSafeInteger(parsed) || parsed < 0)
+    throw new Error("expected a nonnegative integer");
+  return parsed;
+}
+
+async function run(emit: EmitContext, action: () => Promise<void>): Promise<void> {
+  try {
+    await action();
+  } catch (error) {
+    emit.error({
+      code: "conversation_command_failed",
+      message: error instanceof Error ? error.message : String(error),
+    });
+    emit.setExitCode(1);
+  }
+}

package/src/commands/deinit.ts

@@ -35,6 +35,7 @@ import type { EmitContext } from "../commander.ts";
 import { DEFAULT_BIN_NAME } from "../core/config.ts";
 import { ADAPTER_SPECS, type AdapterId } from "../core/hooks/adapter/events.ts";
 import type { SettingsFile } from "../core/hooks/adapter/wiring.ts";
+import { removeIndexerExclusions } from "../lib/indexer-exclusions.ts";
 import { removeInstructions } from "../lib/instructions/apply.ts";
 import { removeGitHooks } from "../lib/instructions/git-hooks.ts";
 import { unwireHooks } from "./init.ts";
@@ -136,6 +137,11 @@ export function registerDeinitCommand(program: Command, emit: EmitContext, binNa
         }
       }
 
+      // ── 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}`));