@mu-crew/mu 4.0.0 → 4.1.0

package/dist/{cli-GB2CAVVW.js → cli-TV3N47AZ.js}

@@ -41,11 +41,8 @@ import {
   steerStallHandler,
   waitForEvents,
   waitWithActions
-} from "./chunk-5HECDBK3.js";
+} from "./chunk-4ULY3ZKO.js";
 import {
-  DelegateCallConflictError,
-  DelegateNotFoundError,
-  DelegateStateError,
   FRONTIER_MAX_DEPTH,
   HumanNeededInvalidError,
   NEXT_BYTES,
@@ -56,7 +53,6 @@ import {
   SyncPeerRefAmbiguousError,
   SyncSourceNotFoundError,
   SyncSourceTooNewError,
-  TERMINAL_DELEGATE_STATES,
   TaskAutoArgError,
   TaskAutoRefusedError,
   TaskBriefMissingError,
@@ -75,27 +71,23 @@ import {
   currentCallers,
   encodeEnvelope,
   escapeRecordText,
-  finishDelegate,
   footerLine,
   foreignVersionMessage,
-  getDelegateCall,
   ingestFromDb,
   jsonDocument,
   linesBytes,
-  listDelegates,
   liveAgentToOutput,
   loadOpenTaskFrontier,
+  localMachineId,
   logOut,
   logPage,
   logReceipt,
-  markDelegate,
   noticesField,
   okEnvelope,
   pageOut,
   pageRecords,
   peerStatuses,
   recordHumanNeeded,
-  registerDelegateCall,
   renderArgv,
   repairPeer,
   resumeArgv,
@@ -108,9 +100,8 @@ import {
   taskPage,
   taskRecordCut,
   taskToOutput,
-  verdictTally,
   workstreamIdOf
-} from "./chunk-GQNHIPJN.js";
+} from "./chunk-SS7NQSSZ.js";
 import {
   AgentAbortNeedsCtlError,
   AgentAbortTimeoutError,
@@ -141,6 +132,9 @@ import {
   CrossWorkstreamEdgeError,
   CtlDeliveryUnknownError,
   CycleError,
+  DelegateCallConflictError,
+  DelegateNotFoundError,
+  DelegateStateError,
   EXPECTED_TABLES,
   GUARD_ALREADY_OWNED,
   GUARD_HUGE_ID,
@@ -182,6 +176,7 @@ import {
   SubstateReasonRequiredError,
   TASK_STATUS_LIST,
   TASK_SUBSTATES,
+  TERMINAL_DELEGATE_STATES,
   TaskAlreadyOwnedError,
   TaskExistsError,
   TaskHasOpenBlockersError,
@@ -240,6 +235,8 @@ import {
   deadStagings,
   defaultDbPath,
   delegateOutcome,
+  delegateProcessDir,
+  delegateSessionDir,
   deleteTask,
   dirtyFiles,
   ensureWorkstream,
@@ -247,10 +244,12 @@ import {
   errCode,
   expectsCtl,
   findEdgeCycles,
+  finishDelegate,
   forget,
   formatPair,
   getAgent,
   getAgentByPane,
+  getDelegateCall,
   getHost,
   getTask,
   getTaskEdgesWithStatus,
@@ -274,6 +273,7 @@ import {
   lastClaimActor,
   latestSeq,
   listAgents,
+  listDelegates,
   listEmptyWorkstreams,
   listForgetCandidates,
   listHostChannels,
@@ -288,6 +288,7 @@ import {
   listTornDownWorkstreams,
   listWorkstreams,
   listWorktrees,
+  markDelegate,
   muTable,
   murmurAvailable,
   openDb,
@@ -307,6 +308,7 @@ import {
   reconcile,
   recoveriesFor,
   recoveryWorkstreams,
+  registerDelegateCall,
   registerOwnedWait,
   registerWorktree,
   reinitWorkstream,
@@ -340,20 +342,21 @@ import {
   unparkTask,
   updateTask,
   usageLines,
+  verdictTally,
   weakDecisionWarning,
   withOpContext,
   withTaskFence,
   workstreamRevision,
   worktreePath,
   worktreesRoot
-} from "./chunk-S424D5EP.js";
+} from "./chunk-UCZPJX7K.js";
 import {
   defaultStateDir
 } from "./chunk-PZ5GOCWH.js";
 
 // src/cli.ts
 import { readFileSync as readFileSync3 } from "fs";
-import { dirname as dirname6, join as join4 } from "path";
+import { dirname as dirname7, join as join5 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 
 // node_modules/commander/lib/error.js
@@ -4650,7 +4653,7 @@ async function parseWaitRef(db, raw, scope, legacy = {}) {
     return { kind, workstream, id: parsed.name };
   }
   if (getAgent(db, parsed.name, workstream) === void 0) {
-    const { AgentNotFoundError: AgentNotFoundError2 } = await import("./errors-KHOYKD7D.js");
+    const { AgentNotFoundError: AgentNotFoundError2 } = await import("./errors-GRONKWFS.js");
     throw new AgentNotFoundError2(parsed.name);
   }
   return {
@@ -6994,6 +6997,7 @@ function assertWorktreeFlags(opts) {
     return;
   }
   for (const flag of ["from", "root"]) {
+    if (flag === "root" && opts.host !== void 0) continue;
     if (opts[flag] !== void 0) throw new UsageError(say("agent.spawn_needs_worktree", flag));
   }
 }
@@ -7847,10 +7851,10 @@ function wireAgentCommands(program2) {
     "run in its own git worktree (git worktree add --detach under the state dir); its path is the cwd"
   ).option("--from <ref>", "with --worktree: start at this commit or branch (default: HEAD)").option(
     "--root <repo>",
-    "with --worktree: the repo to add it to (default: the git root of your cwd)"
+    "with --worktree: the repo to add it to (default: the git root of your cwd). With --host: a REMOTE repo (default the profile's --repo), also without --worktree, as the start directory"
   ).option(
     "--host <profile>",
-    "run on this host profile (mu host add): the pane runs its --shell template, which starts the remote pi and forwards its control socket here; --cwd and --worktree name REMOTE paths (the worktree is made by its --exec, under ~/.local/state/mu-next/remote-worktrees/<ws>/<name>); the pane dying is the agent dying. tmux only; not with --root"
+    "run on this host profile (mu host add): the pane runs its --shell template, which starts the remote pi and forwards its control socket here; --cwd and --worktree name REMOTE paths (the worktree is made by its --exec, under ~/.local/state/mu-next/remote-worktrees/<ws>/<name>); --root names the remote repo; the pane dying is the agent dying. tmux only"
   ).option("--no-ctl", "skip the control-socket handshake with the mu pi extension").option(
     "--next-free",
     "if <name> is taken, take the next free one (worker-1 \u2192 worker-2, review \u2192 review-2); --json's agent.name says which"
@@ -8037,7 +8041,7 @@ function openDashboardOrHelp(program2) {
     (syncDb) => withShutdown(syncDb, async (shutdown) => {
       const key = "NODE_ENV";
       process.env[key] ??= "production";
-      const { runDashboard } = await import("./tui-ALPHYTA2.js");
+      const { runDashboard } = await import("./tui-FUBQ326D.js");
       const first = program2.opts().workstream?.[0];
       await runDashboard({ dbPath: defaultDbPath(), syncDb, shutdown, initialWorkstream: first });
     }),
@@ -8176,7 +8180,7 @@ function checkStrayDbFiles() {
       `Live DB: ${defaultDbPath()}`,
       "",
       "These are hand-made copies, pre-upgrade saves, and the backups",
-      "`mu db compact` / `mu db forget` write first (mu.db.pre-<verb>-<time>).",
+      "`mu db compact` / `mu db forget` / `mu delegates prune` write first (mu.db.pre-<verb>-<time>).",
       "No mu code path reads them and none prunes them. Keep a pre-forget",
       "backup until you are sure: it is the only way back from a forget.",
       "Otherwise disaster recovery is the ops log, so a copy is a convenience:",
@@ -9106,7 +9110,7 @@ var LOG_TAIL_BYTES = 2e3;
 var sha = (s, n) => createHash("sha256").update(s).digest("hex").slice(0, n);
 function delegateProcessPaths(db, row) {
   const base = dirname3(db.name);
-  const dir = join2(base, "delegate-process", sha(row.callId, 16));
+  const dir = delegateProcessDir(db.name, row.callId);
   return {
     dir,
     log: join2(dir, "pi.log"),
@@ -9437,6 +9441,196 @@ ${tail(p.log)}` : void 0
   }
 }
 
+// src/delegate-prune.ts
+import { lstatSync, readdirSync as readdirSync2, rmSync as rmSync2 } from "fs";
+import { dirname as dirname4, join as join3 } from "path";
+var PRUNE_DEFAULT_DAYS = 30;
+function sizeOf3(p) {
+  let st;
+  try {
+    st = lstatSync(p);
+  } catch {
+    return 0;
+  }
+  if (!st.isDirectory()) return st.size;
+  let n = 0;
+  for (const e of readdirSync2(p)) n += sizeOf3(join3(p, e));
+  return n;
+}
+var hasFileDir = (db) => db.name !== "" && db.name !== ":memory:";
+var LOOSE_MIN_AGE_MS = 864e5;
+function looseSessions(db, cutoff, workstream, now) {
+  const root = join3(dirname4(db.name), "delegate-sessions");
+  const before = Math.min(Date.parse(cutoff), now - LOOSE_MIN_AGE_MS);
+  const out = [];
+  const wss = db.prepare(
+    "SELECT name FROM workstreams WHERE torn_down_at IS NULL AND (? IS NULL OR name = ?)"
+  ).all(workstream ?? null, workstream ?? null).map((r) => r.name);
+  for (const ws of wss) {
+    let names;
+    try {
+      names = readdirSync2(join3(root, ws));
+    } catch {
+      continue;
+    }
+    for (const f of names) {
+      const p = join3(root, ws, f);
+      if (!f.endsWith(".jsonl")) continue;
+      try {
+        const st = lstatSync(p);
+        if (st.isFile() && st.mtimeMs < before) out.push(p);
+      } catch {
+      }
+    }
+  }
+  return out.sort();
+}
+var callFiles = (db, c) => [
+  delegateSessionDir(db.name, c.workstream, c.task),
+  delegateProcessDir(db.name, c.callId)
+];
+var TASK_PUTS_WHERE = `entity IN ('task', 'note') AND op = 'put'
+  AND key >= @k AND key < @k || '$' AND (key = @k OR key >= @k || '#')
+  AND (@own = 1 OR machine_id <> @me)`;
+var MIN_DATE_MS = -864e13;
+function planDelegatePrune(db, opts = {}) {
+  const days2 = opts.days ?? PRUNE_DEFAULT_DAYS;
+  const ownHistory = opts.ownHistory ?? !syncEnabled();
+  const cutoff = new Date(
+    Math.max(MIN_DATE_MS, (opts.now ?? Date.now()) - days2 * 864e5)
+  ).toISOString();
+  const rows = db.prepare(
+    `SELECT t.id AS id, w.name AS workstream, t.local_id AS task, t.updated_at AS updated_at,
+              d.call_id AS call_id, d.state AS call_state,
+              (SELECT COUNT(*) FROM task_edges e WHERE e.from_task_id = t.id OR e.to_task_id = t.id) AS edges,
+              EXISTS (SELECT 1 FROM tasks jt JOIN workstreams jw ON jw.id = jt.workstream_id
+                        JOIN task_auto ja ON ja.task_id = jt.id AND ja.enabled = 1
+                       WHERE jw.name = d.record_workstream AND jt.local_id = d.record_task) AS judged_auto
+         FROM tasks t
+         JOIN workstreams w ON w.id = t.workstream_id AND w.torn_down_at IS NULL
+         JOIN delegate_calls d ON d.task_id = t.id
+        WHERE t.kind = 'delegate' AND t.status = 'CLOSED' AND t.updated_at < ?
+          AND (? IS NULL OR w.name = ?)
+        ORDER BY w.name, t.updated_at, t.local_id`
+  ).all(cutoff, opts.workstream ?? null, opts.workstream ?? null);
+  const plan = {
+    cutoff,
+    days: days2,
+    candidates: [],
+    kept: { edges: 0, refuteTarget: 0 },
+    ownHistory,
+    ops: 0,
+    bytes: 0,
+    files: { paths: [], bytes: 0 }
+  };
+  const cost = db.prepare(
+    `SELECT COUNT(*) AS n, COALESCE(SUM(length(payload)), 0) AS b FROM ops WHERE ${TASK_PUTS_WHERE}`
+  );
+  const me = localMachineId(db);
+  const own = ownHistory ? 1 : 0;
+  for (const r of rows) {
+    if (!["done", "failed", "cancelled"].includes(r.call_state)) continue;
+    if (r.edges > 0) {
+      plan.kept.edges++;
+      continue;
+    }
+    if (r.call_id.startsWith("refute:") && r.judged_auto === 1) {
+      plan.kept.refuteTarget++;
+      continue;
+    }
+    plan.candidates.push({
+      workstream: r.workstream,
+      task: r.task,
+      callId: r.call_id,
+      closedAt: r.updated_at
+    });
+    const c = cost.get({ k: `${r.workstream}/${r.task}`, own, me });
+    plan.ops += c.n;
+    plan.bytes += c.b;
+  }
+  if (hasFileDir(db)) {
+    const paths = [
+      ...plan.candidates.flatMap((c) => callFiles(db, c)).filter(exists2),
+      ...looseSessions(db, cutoff, opts.workstream, opts.now ?? Date.now())
+    ];
+    plan.files = { paths, bytes: paths.reduce((n, p) => n + sizeOf3(p), 0) };
+  }
+  return plan;
+}
+function exists2(p) {
+  try {
+    lstatSync(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function pruneDelegates(db, plan) {
+  let tasks = 0;
+  let ops = 0;
+  const pruned = [];
+  withOpContext(
+    db,
+    { intent: "delegate.prune", actor: "mu delegates prune", group: "new" },
+    () => db.transaction(() => {
+      const del = db.prepare(
+        `DELETE FROM tasks WHERE kind = 'delegate' AND status = 'CLOSED' AND updated_at < ?
+              AND local_id = ? AND workstream_id = (SELECT id FROM workstreams WHERE name = ?)
+              AND NOT EXISTS (SELECT 1 FROM task_edges e
+                               WHERE e.from_task_id = tasks.id OR e.to_task_id = tasks.id)`
+      );
+      const puts = db.prepare(`DELETE FROM ops WHERE ${TASK_PUTS_WHERE}`);
+      const me = localMachineId(db);
+      const own = plan.ownHistory ? 1 : 0;
+      const cursor = db.prepare("DELETE FROM wait_cursors WHERE ref = ?");
+      for (const c of plan.candidates) {
+        if (del.run(plan.cutoff, c.task, c.workstream).changes === 0) continue;
+        tasks++;
+        pruned.push(c);
+        ops += puts.run({ k: `${c.workstream}/${c.task}`, own, me }).changes;
+        cursor.run(`delegate:${c.workstream}/${c.callId}`);
+      }
+    }).immediate()
+  );
+  let files = 0;
+  if (hasFileDir(db)) {
+    const loose = new Set(plan.files.paths);
+    const go = [
+      ...pruned.flatMap((c) => callFiles(db, c)),
+      ...looseSessions(db, plan.cutoff, void 0, Date.now()).filter((p) => loose.has(p))
+    ];
+    for (const p of go) {
+      if (!exists2(p)) continue;
+      try {
+        rmSync2(p, { recursive: true, force: true });
+        files++;
+      } catch {
+      }
+    }
+  }
+  return { tasks, ops, files };
+}
+function checkOldDelegates(db, opts = {}) {
+  const plan = planDelegatePrune(db, opts);
+  const n = plan.candidates.length;
+  if (n === 0)
+    return {
+      name: "delegates-old",
+      severity: "ok",
+      detail: `no closed delegate task older than ${plan.days} days`
+    };
+  return {
+    name: "delegates-old",
+    severity: "ok",
+    detail: `${n} closed delegate task(s) older than ${plan.days} days (${plan.ops} ops)`,
+    remediation: [
+      "Each holds its whole brief and report, synced to every peer. Their verdicts stay on the judged tasks.",
+      "  mu delegates prune              # dry run: what goes, and what is kept",
+      "  mu delegates prune --yes        # backs up beside the DB first; irreversible"
+    ]
+  };
+}
+
 // src/workstream-scope.ts
 function workstreamNameProblem(value, flag = "-w/--workstream") {
   if (value.length > 0 && value.trim().length === 0) {
@@ -9648,6 +9842,82 @@ async function cmdDelegatesRun(db, callId, opts) {
   }
   if (r.ran && r.state !== "done") throw new CliExitError(1);
 }
+function keptLine(plan) {
+  const parts = [
+    plan.kept.edges > 0 ? `${plan.kept.edges} with edges` : "",
+    plan.kept.refuteTarget > 0 ? `${plan.kept.refuteTarget} refute checks of tasks still under mu task auto` : ""
+  ].filter((p) => p !== "");
+  return parts.length > 0 ? `kept: ${parts.join(", ")}` : "";
+}
+async function cmdDelegatesPrune(db, opts) {
+  if (opts.workstream !== void 0) await resolveExistingWorkstream(db, opts.workstream);
+  const plan = planDelegatePrune(db, {
+    ...opts.olderThan !== void 0 ? { days: opts.olderThan } : {},
+    ...opts.workstream !== void 0 ? { workstream: opts.workstream } : {}
+  });
+  const n = plan.candidates.length;
+  const files = plan.files.paths.length;
+  const filesNote = files > 0 ? `, ${files} pi session(s) (${formatBytes(plan.files.bytes)})` : "";
+  if (opts.yes === true && n === 0 && files === 0) {
+    if (opts.json)
+      return emitJson({ dryRun: false, ...plan, pruned: 0, deletedOps: 0, deletedFiles: 0 });
+    console.log(pc.dim(`nothing to prune: no closed delegate task older than ${plan.days} days`));
+    const kept2 = keptLine(plan);
+    if (kept2) console.log(pc.dim(kept2));
+    return;
+  }
+  if (opts.yes !== true) {
+    if (opts.json) return emitJson({ dryRun: true, ...plan });
+    if (n === 0 && files === 0)
+      console.log(pc.dim(`nothing to prune: no closed delegate task older than ${plan.days} days`));
+    else {
+      const t = muTable({ head: ["TASK", "CALL", "CLOSED"] });
+      for (const c of plan.candidates.slice(0, 20))
+        t.push([`${c.workstream}/${c.task}`, c.callId, c.closedAt.slice(0, 10)]);
+      console.log(t.toString());
+      if (n > 20) console.log(pc.dim(`... and ${n - 20} more`));
+      console.log(
+        `${n} closed delegate task(s) older than ${plan.days} days: ${plan.ops} ops (${formatBytes(plan.bytes)})${filesNote}. Dry run; nothing changed (--yes applies; irreversible).`
+      );
+      if (!plan.ownHistory)
+        console.log(
+          pc.dim(
+            "sync is on: the rows go everywhere, but this machine's own history stays (its segment is rebuilt from it)"
+          )
+        );
+    }
+    const kept2 = keptLine(plan);
+    if (kept2) console.log(pc.dim(kept2));
+    return;
+  }
+  if (n === 0) {
+    const r2 = pruneDelegates(db, plan);
+    if (opts.json)
+      return emitJson({ dryRun: false, ...plan, pruned: 0, deletedOps: 0, deletedFiles: r2.files });
+    console.log(`Pruned ${r2.files} pi session(s); no delegate task was old enough.`);
+    return;
+  }
+  const backup = backupBeside(db, "prune");
+  const r = pruneDelegates(db, plan);
+  const size = vacuumAndCheck(db, backup);
+  if (opts.json)
+    return emitJson({
+      dryRun: false,
+      ...plan,
+      pruned: r.tasks,
+      deletedOps: r.ops,
+      deletedFiles: r.files,
+      backup,
+      ...size
+    });
+  console.log(
+    `Pruned ${r.tasks} delegate task(s), ${r.ops} ops${r.files > 0 ? `, ${r.files} pi session(s)` : ""}: ${formatBytes(size.before)} \u2192 ${formatBytes(size.after)}. Drift check clean.`
+  );
+  const kept = keptLine(plan);
+  if (kept) console.log(pc.dim(kept));
+  if (!size.checkpointed) console.log(pc.dim(CHECKPOINT_PENDING));
+  console.log(pc.dim(`backup (the only way back): ${backup}`));
+}
 async function cmdDelegatesReissue(_db, callId, _opts) {
   throw new UsageError(
     `reissue runs inside the pi session that owns the call: use ${reissueHint(callId)} there (a shell would leave it queued with nothing to start it)`,
@@ -9699,6 +9969,12 @@ function wireDelegatesCommands(program2) {
     const opts = this.optsWithGlobals();
     return handle((db) => cmdDelegatesRun(db, callId, opts), this)();
   });
+  d.command("prune").description(
+    `Delete this machine's closed delegate tasks older than --older-than days (default ${PRUNE_DEFAULT_DAYS}) and their pi session files; the deletion syncs. Dry run without --yes; --yes backs up, VACUUMs, checks drift`
+  ).option("--older-than <days>", "age in days since the task closed", parsePositiveNumber).option("--yes", "apply (default: dry run)").option("-w, --workstream <name>", "only this workstream (default: every live one)").option(...JSON_OPT).action(function() {
+    const opts = this.optsWithGlobals();
+    return handle((db) => cmdDelegatesPrune(db, opts), this)();
+  });
   d.command("reissue <call-id>").description(
     "Refuses: reissue a refused call with the `mu_delegate_reissue` tool in its pi session (only that runtime can start or drain it)"
   ).option(...JSON_OPT).action(function(callId) {
@@ -9708,15 +9984,15 @@ function wireDelegatesCommands(program2) {
 }
 
 // src/cli/doctor.ts
-import { dirname as dirname5 } from "path";
+import { dirname as dirname6 } from "path";
 
 // src/doctor-summary.ts
 import { accessSync, constants, existsSync as existsSync3, readFileSync as readFileSync2, realpathSync } from "fs";
-import { delimiter, dirname as dirname4, join as join3, parse } from "path";
+import { delimiter, dirname as dirname5, join as join4, parse } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function resolveExecutable(name) {
   for (const dir of (process.env.PATH ?? "").split(delimiter).filter(Boolean)) {
-    const candidate = join3(dir, name);
+    const candidate = join4(dir, name);
     try {
       accessSync(candidate, constants.X_OK);
       return realpathSync(candidate);
@@ -9726,10 +10002,10 @@ function resolveExecutable(name) {
   return null;
 }
 function murmurVersion(executable) {
-  let dir = dirname4(executable);
+  let dir = dirname5(executable);
   const root = parse(dir).root;
   while (dir !== root) {
-    const packagePath = join3(dir, "package.json");
+    const packagePath = join4(dir, "package.json");
     if (existsSync3(packagePath)) {
       try {
         const pkg = JSON.parse(readFileSync2(packagePath, "utf8"));
@@ -9739,7 +10015,7 @@ function murmurVersion(executable) {
       } catch {
       }
     }
-    dir = dirname4(dir);
+    dir = dirname5(dir);
   }
   return null;
 }
@@ -9811,7 +10087,7 @@ function ctlExtensionDoctorCheck(reports) {
 var DOCTOR_CTL_TIMEOUT_MS = 500;
 function installedMuVersion() {
   try {
-    const pkgPath = join3(dirname4(fileURLToPath2(import.meta.url)), "..", "package.json");
+    const pkgPath = join4(dirname5(fileURLToPath2(import.meta.url)), "..", "package.json");
     const pkg = JSON.parse(readFileSync2(pkgPath, "utf8"));
     const v = typeof pkg === "object" && pkg !== null ? pkg.version : null;
     return typeof v === "string" ? v : null;
@@ -10055,7 +10331,7 @@ async function cmdDoctor(db, opts = {}) {
       console.log(`  ${pad(fact.name)}: ${fact.value ? pc.green(fact.value) : pc.dim("not set")}`);
     }
   }
-  const ctlSockets = await ctlSocketsDoctorCheck(listAgents(db), { stateDir: dirname5(db.name) });
+  const ctlSockets = await ctlSocketsDoctorCheck(listAgents(db), { stateDir: dirname6(db.name) });
   const muExt = ctlExtensionDoctorCheck(ctlSockets.agents);
   printCheck("agent state", agentStateCheck(health, extensionLive(ctlSockets.agents)));
   printCheck("mu ext", muExt);
@@ -10199,6 +10475,14 @@ state (workstream=${ws})`));
     console.log("");
     for (const line2 of dormant.remediation) console.log(`  ${line2}`);
   }
+  const oldDelegates = checkOldDelegates(db);
+  console.log(
+    `  ${oldDelegates.name.padEnd(16)} : ${oldDelegates.remediation === void 0 ? pc.green("ok") : pc.yellow("note")} ${pc.dim(oldDelegates.detail)}`
+  );
+  if (oldDelegates.remediation !== void 0) {
+    console.log("");
+    for (const line2 of oldDelegates.remediation) console.log(`  ${line2}`);
+  }
   console.log(pc.bold("\ndisk"));
   const disk = checkDiskRecon(db);
   if (printHazards(disk)) sawHazard = true;
@@ -10301,7 +10585,7 @@ function opsSizeHint(db) {
 }
 async function cmdDoctorJson(db, opts = {}) {
   const health = await muxHealth();
-  const ctlSockets = await ctlSocketsDoctorCheck(listAgents(db), { stateDir: dirname5(db.name) });
+  const ctlSockets = await ctlSocketsDoctorCheck(listAgents(db), { stateDir: dirname6(db.name) });
   const muExt = ctlExtensionDoctorCheck(ctlSockets.agents);
   const env = {
     // `mux` is the backend-agnostic key. `tmux` is kept as an alias for
@@ -10410,7 +10694,16 @@ async function cmdDoctorJson(db, opts = {}) {
       remediation: dormantHazard.remediation ?? [],
       workstreams: findDormantWorkstreams(db, { currentWorkstream }),
       thresholds: { finishedIdleDays: FINISHED_IDLE_DAYS, abandonedIdleDays: ABANDONED_IDLE_DAYS }
-    }
+    },
+    oldDelegates: (() => {
+      const h = checkOldDelegates(db);
+      return {
+        name: h.name,
+        severity: h.severity,
+        detail: h.detail,
+        remediation: h.remediation ?? []
+      };
+    })()
   };
   const worktreeUsage = opts.disk === true ? measureWorktreeUsage(db) : null;
   let drift;
@@ -10514,7 +10807,7 @@ function cmdHostAdd(db, name, opts) {
     shell: opts.shell,
     exec: opts.exec,
     fetch: opts.fetch,
-    repo: opts.repo,
+    repo: opts.repo ?? null,
     max_sessions: opts.maxSessions ?? null
   });
   if (isJsonMode()) {
@@ -10535,9 +10828,9 @@ function cmdHostList(db) {
   }
   const held = /* @__PURE__ */ new Map();
   for (const c of listHostChannels(db)) held.set(c.host, (held.get(c.host) ?? 0) + 1);
-  const t = muTable({ head: ["HOST", "REPO", "CHANNELS"] });
+  const t = muTable({ head: ["HOST", "DEFAULT REPO", "CHANNELS"] });
   for (const h of hosts) {
-    t.push([h.name, h.repo, `${held.get(h.name) ?? 0}/${h.max_sessions ?? "\u221E"}`]);
+    t.push([h.name, h.repo ?? "-", `${held.get(h.name) ?? 0}/${h.max_sessions ?? "\u221E"}`]);
   }
   console.log(t.toString());
 }
@@ -10549,7 +10842,7 @@ function cmdHostShow(db, name) {
     return;
   }
   console.log(
-    `${pc.bold(host.name)}  repo ${host.repo}  max-sessions ${host.max_sessions ?? "none"}`
+    `${pc.bold(host.name)}  default repo ${host.repo ?? "-"}  max-sessions ${host.max_sessions ?? "none"}`
   );
   for (const f of ["shell", "exec", "fetch"]) console.log(`  ${f.padEnd(6)} ${host[f]}`);
   console.log(
@@ -10580,7 +10873,6 @@ function cmdHostInit(name, opts) {
     `--shell ${shellQuote(s.shell)}`,
     `--exec ${shellQuote(s.exec)}`,
     `--fetch ${shellQuote(s.fetch)}`,
-    "--repo '<remote repo path>'",
     "--max-sessions 1"
   ].join(" \\\n  ");
   if (isJsonMode()) {
@@ -10593,7 +10885,10 @@ function cmdHostInit(name, opts) {
 }
 async function cmdHostCheck(db, name, opts) {
   const agent = opts.agent === void 0 ? void 0 : { name: opts.agent, workstream: await resolveWorkstream(opts.workstream) };
-  const report = await checkHost(db, name, agent === void 0 ? {} : { agent });
+  const report = await checkHost(db, name, {
+    ...agent !== void 0 ? { agent } : {},
+    ...opts.root !== void 0 ? { root: opts.root } : {}
+  });
   if (isJsonMode()) {
     if (!report.ok) throw failureWithData(failedError(report), report);
     emitJson(report);
@@ -10617,7 +10912,10 @@ function wireHostCommands(program2) {
   );
   host.command("add <name>").description(
     "Store a machine-local host profile of command templates: --shell opens the pane, --exec runs one remote command, --fetch brings commits home. Placeholders {env} {cmd} {local_sock} {remote_sock} {cwd}; grammar in docs/guide/remote.md."
-  ).requiredOption("--shell <template>", "pane command template (opens the remote shell)").requiredOption("--exec <template>", "template that runs one remote command ({cmd})").requiredOption("--fetch <template>", "local template that fetches commits home ({cwd})").requiredOption("--repo <path>", "the repository's path on the host").option(
+  ).requiredOption("--shell <template>", "pane command template (opens the remote shell)").requiredOption("--exec <template>", "template that runs one remote command ({cmd})").requiredOption("--fetch <template>", "local template that fetches commits home ({cwd})").option(
+    "--repo <path>",
+    "default remote repo for `agent spawn --host` without --root (a profile names a machine, not a repo)"
+  ).option(
     "--max-sessions <n>",
     "cap on channels mu holds to this host at once (panes, --exec, --fetch)",
     parseNonNegativeInt
@@ -10641,8 +10939,8 @@ function wireHostCommands(program2) {
     return handle(async () => cmdHostInit(name, opts), this)();
   });
   host.command("check <name>").description(
-    "Run the profile's --exec under one channel: host answers, repo is git, pi runs, `pi list` names mu. --agent also probes that agent's forwarded control socket. Reports each failure, retries nothing; exit 5 if a step fails."
-  ).option("--agent <name>", "also probe this agent's control socket (the forward rides its pane)").option(...WORKSTREAM_OPT).option(...JSON_OPT).action(function(name) {
+    "Run the profile's --exec under one channel: host answers, the repo (--root, else the default) is git, pi runs, `pi list` names mu. --agent also probes that agent's control socket. Exit 5 if a step fails; retries nothing."
+  ).option("--agent <name>", "also probe this agent's control socket (the forward rides its pane)").option("--root <path>", "the remote repo the repo step checks (default: the profile's)").option(...WORKSTREAM_OPT).option(...JSON_OPT).action(function(name) {
     const opts = this.optsWithGlobals();
     return handle((db) => cmdHostCheck(db, name, opts), this)();
   });
@@ -11994,8 +12292,8 @@ function emitJsonCollection(items) {
 }
 function readPackageVersion() {
   try {
-    const here = dirname6(fileURLToPath3(import.meta.url));
-    const pkgPath = join4(here, "..", "package.json");
+    const here = dirname7(fileURLToPath3(import.meta.url));
+    const pkgPath = join5(here, "..", "package.json");
     const raw = readFileSync3(pkgPath, "utf8");
     const parsed = JSON.parse(raw);
     return typeof parsed.version === "string" ? parsed.version : "unknown";
@@ -12170,4 +12468,4 @@ export {
   truncate,
   truncateFront
 };
-//# sourceMappingURL=cli-GB2CAVVW.js.map
+//# sourceMappingURL=cli-TV3N47AZ.js.map