@wrongstack/cli 0.308.6 → 0.308.7

package/dist/{cli-main-HCCYX3D5.js → cli-main-L3T4KJKU.js}

@@ -27,7 +27,7 @@ import {
 } from "./chunk-T6YAVFXA.js";
 import {
   setupPlugins
-} from "./chunk-KV6DNQT6.js";
+} from "./chunk-BZJ4MP32.js";
 import {
   startCliHqConnection
 } from "./chunk-FKWHSFX4.js";
@@ -44,7 +44,7 @@ import {
 import {
   PLUGIN_AUDIT_ENTRIES,
   runPluginManagementCommand
-} from "./chunk-RK7E3IXT.js";
+} from "./chunk-H6C7SO5H.js";
 import {
   configureSimpleUiRuntimeContext,
   detectProjectFacts,
@@ -113,7 +113,7 @@ import {
 
 // src/cli-main.ts
 import * as path32 from "node:path";
-import { FLEET_ROSTER as FLEET_ROSTER6, mailboxSessionTag as mailboxSessionTag5 } from "@wrongstack/core/coordination";
+import { FLEET_ROSTER as FLEET_ROSTER6, mailboxSessionTag as mailboxSessionTag6 } from "@wrongstack/core/coordination";
 import { TOKENS as TOKENS12 } from "@wrongstack/core/kernel";
 import { getSessionRegistry } from "@wrongstack/core/storage";
 import { writeErr as writeErr3 } from "@wrongstack/core/utils";
@@ -1704,7 +1704,7 @@ function subscribeBrainDecisionLog(events) {
 }
 
 // src/fleet/host.ts
-import { randomUUID as randomUUID4 } from "node:crypto";
+import { randomUUID as randomUUID5 } from "node:crypto";
 import {
   createProjectAgentRoster
 } from "@wrongstack/core/agent-catalog";
@@ -2359,6 +2359,62 @@ function createHostStatusBroadcaster(input) {
   });
 }
 
+// src/fleet/host-explore-companion.ts
+import { randomUUID as randomUUID2 } from "node:crypto";
+import {
+  buildProbeTaskText,
+  DEFAULT_EXPLORE_COMPANION_AGENT_ID,
+  ExploreCompanion,
+  getSharedProjectMailbox as getSharedProjectMailbox3,
+  mailboxSessionTag as mailboxSessionTag2
+} from "@wrongstack/core/coordination";
+function createHostExploreCompanion(input) {
+  const { director, events, sessionId, mailboxProjectDir, roster, config } = input;
+  if (config?.enabled === false) return null;
+  const sessionTag = mailboxSessionTag2(sessionId);
+  const mailbox = () => getSharedProjectMailbox3(mailboxProjectDir, events);
+  const template = roster[DEFAULT_EXPLORE_COMPANION_AGENT_ID];
+  let residentId;
+  const ensureResident = async () => {
+    if (residentId) {
+      const alive = director.status().subagents.some((s) => s.id === residentId);
+      if (alive) return residentId;
+      residentId = void 0;
+    }
+    if (!template) throw new Error("explore-companion role missing from roster");
+    const subagentId = await director.spawn({
+      ...template,
+      id: `explore-companion-${sessionTag}`,
+      name: "Explore Companion"
+    });
+    residentId = subagentId;
+    return subagentId;
+  };
+  const options = {
+    events,
+    mailbox: mailbox(),
+    leaderSessionId: sessionId,
+    leaderAgentId: "leader",
+    onProbe: async (probe) => {
+      const subagentId = await ensureResident();
+      const taskId = randomUUID2();
+      await director.assignInternal({
+        id: taskId,
+        description: buildProbeTaskText(probe),
+        subagentId
+      });
+      return { subagentId, taskId };
+    },
+    cooldownMs: config?.cooldownMs,
+    maxPending: config?.maxPending,
+    pollIntervalMs: config?.pollIntervalMs,
+    companionAgentId: `${DEFAULT_EXPLORE_COMPANION_AGENT_ID}@${sessionTag}`
+  };
+  const companion = new ExploreCompanion(options);
+  companion.start();
+  return companion;
+}
+
 // src/fleet/host-learning-scheduler.ts
 import {
   LearningOptimizationScheduler,
@@ -3003,7 +3059,7 @@ function aggregateFleetUsage(completed) {
 }
 
 // src/fleet/host-subagent-factory.ts
-import { randomUUID as randomUUID2 } from "node:crypto";
+import { randomUUID as randomUUID3 } from "node:crypto";
 import { existsSync, statSync } from "node:fs";
 import * as path6 from "node:path";
 import {
@@ -3021,7 +3077,7 @@ import {
 import {
   DEFAULT_SUBAGENT_BASELINE,
   FLEET_ROSTER,
-  getSharedProjectMailbox as getSharedProjectMailbox3,
+  getSharedProjectMailbox as getSharedProjectMailbox4,
   resolveSubagentModelTarget as resolveSubagentModelTarget2
 } from "@wrongstack/core/coordination";
 import { installDesignStudioMiddleware } from "@wrongstack/core/design";
@@ -3464,7 +3520,7 @@ ${message} Falling back to the assigned checkout.` : `${message} Falling back to
     }
     let onlineAgents = [];
     try {
-      const subagentMailbox = getSharedProjectMailbox3(host.mailboxProjectDir());
+      const subagentMailbox = getSharedProjectMailbox4(host.mailboxProjectDir());
       onlineAgents = await subagentMailbox.getAgentStatuses();
     } catch {
     }
@@ -3531,7 +3587,7 @@ ${audienceMemory.map((text) => `- ${text}`).join("\n")}`
     if (rolePrompt) {
       baseSystem.push({ type: "text", text: rolePrompt });
     }
-    const subagentName = effectiveCfg.id ?? effectiveCfg.name ?? `sub_${randomUUID2().slice(0, 8)}`;
+    const subagentName = effectiveCfg.id ?? effectiveCfg.name ?? `sub_${randomUUID3().slice(0, 8)}`;
     if (effectiveCfg.role) {
       host.recordLearningRole(subagentName, effectiveCfg.role, skillResolution.selected);
     }
@@ -3680,12 +3736,12 @@ ${audienceMemory.map((text) => `- ${text}`).join("\n")}`
 }
 
 // src/fleet/host-supervisor.ts
-import { randomUUID as randomUUID3 } from "node:crypto";
+import { randomUUID as randomUUID4 } from "node:crypto";
 import {
   dispatchAgent,
   FleetSupervisor,
-  getSharedProjectMailbox as getSharedProjectMailbox4,
-  mailboxSessionTag as mailboxSessionTag2
+  getSharedProjectMailbox as getSharedProjectMailbox5,
+  mailboxSessionTag as mailboxSessionTag3
 } from "@wrongstack/core/coordination";
 import { toErrorMessage as toErrorMessage2 } from "@wrongstack/core/utils/error";
 
@@ -3711,8 +3767,8 @@ function createHostFleetSupervisor(input) {
     getLeaderMailboxId
   } = input;
   if (!director || !brain || supervisorConfig?.enabled === false) return null;
-  const supTag = () => mailboxSessionTag2(sessionId);
-  const mailbox = () => getSharedProjectMailbox4(mailboxProjectDir, events);
+  const supTag = () => mailboxSessionTag3(sessionId);
+  const mailbox = () => getSharedProjectMailbox5(mailboxProjectDir, events);
   const supervisor = new FleetSupervisor({
     events,
     fleet: director.fleet,
@@ -3738,7 +3794,7 @@ function createHostFleetSupervisor(input) {
           ].filter((part) => typeof part === "string" && part.trim().length > 0).join("\n\n");
           const subagentId = await director.spawn({
             ...template ?? { name: "fleet helper", role: "executor" },
-            id: `helper-${randomUUID3().slice(0, 8)}`,
+            id: `helper-${randomUUID4().slice(0, 8)}`,
             name: `fleet helper (${routed.role})`,
             role: routed.role,
             systemPromptOverride: helperPrompt
@@ -3780,8 +3836,8 @@ function createHostFleetSupervisor(input) {
 // src/fleet/host-task-result-report.ts
 import {
   formatSubagentStructuredReport,
-  getSharedProjectMailbox as getSharedProjectMailbox5,
-  mailboxSessionTag as mailboxSessionTag3
+  getSharedProjectMailbox as getSharedProjectMailbox6,
+  mailboxSessionTag as mailboxSessionTag4
 } from "@wrongstack/core/coordination";
 async function reportTaskResultToLeader({
   notification: n,
@@ -3791,8 +3847,8 @@ async function reportTaskResultToLeader({
   getLeaderMailboxId
 }) {
   try {
-    const leaderId2 = getLeaderMailboxId?.() ?? `leader@${mailboxSessionTag3(sessionId)}`;
-    const mailbox = getSharedProjectMailbox5(mailboxProjectDir, events);
+    const leaderId2 = getLeaderMailboxId?.() ?? `leader@${mailboxSessionTag4(sessionId)}`;
+    const mailbox = getSharedProjectMailbox6(mailboxProjectDir, events);
     const ok = n.status === "success";
     const MAX_BODY = 700;
     const failureText = [
@@ -3895,6 +3951,11 @@ var MultiAgentHost = class {
    *  buildDirector() (when a BrainArbiter is available), stopped in
    *  dispose(). Also published to the supervisor registry for /supervisor. */
   fleetSupervisor = null;
+  /** ExploreCompanion — state-triggered background codebase explorer behind
+   *  the leader. Built in buildDirector() (unless disabled via
+   *  fleet.exploreCompanion.enabled=false), stopped in dispose(). Probes are
+   *  assigned to a lazily-spawned resident `explore-companion` subagent. */
+  exploreCompanion = null;
   /** Built-ins plus lazily-resolved project-created roles. */
   roster;
   /** Live roster surface shared by spawn_subagent and the blocking delegate tool. */
@@ -4009,6 +4070,14 @@ var MultiAgentHost = class {
     });
     this.statusBroadcaster.start();
     this.buildFleetSupervisor(config);
+    this.exploreCompanion = createHostExploreCompanion({
+      director: this.director,
+      events: this.deps.events,
+      sessionId: this.deps.session.id,
+      mailboxProjectDir: this.mailboxProjectDir(),
+      roster: this.roster,
+      config: config.fleet?.exploreCompanion
+    });
     this.directorOffHandles.push(
       ...registerDirectorBudgetAndContextBridges({
         director: this.director,
@@ -4096,7 +4165,7 @@ var MultiAgentHost = class {
     return this.acpRunnerCache.get(subagentId);
   }
   async spawnACP(subagentId, task, config) {
-    const taskId = randomUUID4();
+    const taskId = randomUUID5();
     await this.ensureCoordinator(config);
     const coordinator = this.getCoordinator();
     const acpRunner = await this.buildACPRunner(subagentId);
@@ -4208,7 +4277,7 @@ var MultiAgentHost = class {
     return result;
   }
   async _spawnAndAssign(subagentConfig, description = "", opts) {
-    const taskId = randomUUID4();
+    const taskId = randomUUID5();
     if (!this.director)
       throw new AgentError({
         message: "Director is not initialized",
@@ -4354,6 +4423,8 @@ var MultiAgentHost = class {
     this.fleetSupervisor?.stop();
     if (this.fleetSupervisor) setActiveFleetSupervisor(null);
     this.fleetSupervisor = null;
+    this.exploreCompanion?.stop();
+    this.exploreCompanion = null;
     this.adaptiveConcurrencyController?.dispose();
     this.adaptiveConcurrencyController = void 0;
     if (this.director) {
@@ -4412,7 +4483,7 @@ function setupBrainAndOrchestration(deps) {
     cwd,
     wpaths,
     teardownHandlers,
-    mailboxSessionTag: mailboxSessionTag6,
+    mailboxSessionTag: mailboxSessionTag7,
     brainMailbox,
     agentMonitor,
     manifestPath,
@@ -4565,9 +4636,9 @@ function setupBrainAndOrchestration(deps) {
     // trigger corrective steers to the leader agent.
     leaderSessionId: () => context.session?.id ?? session.id,
     intervene: async ({ subject, body }) => {
-      const leaderUniqueId = `leader@${mailboxSessionTag6(session.id)}`;
+      const leaderUniqueId = `leader@${mailboxSessionTag7(session.id)}`;
       await brainMailbox.send({
-        from: `brain@${mailboxSessionTag6(session.id)}`,
+        from: `brain@${mailboxSessionTag7(session.id)}`,
         to: leaderUniqueId,
         type: "steer",
         subject,
@@ -6156,7 +6227,7 @@ ${res.out}` };
       const orchestrator = new PhaseOrchestrator({
         graph,
         ctx: {
-          executeTask: async (task, phaseId, env) => {
+          executeTask: async (task, phaseId, env, signal) => {
             const phase = graph.phases.get(phaseId);
             const phaseName = phase?.name ?? phaseId;
             let agentName = task.assignee;
@@ -6169,7 +6240,7 @@ ${res.out}` };
             return runOnce(
               buildTaskPrompt(task, phaseName, goal),
               `goal-${agentName}`.slice(0, 48),
-              abort.signal,
+              signal ? AbortSignal.any([abort.signal, signal]) : abort.signal,
               env?.cwd
             );
           },
@@ -6284,7 +6355,7 @@ ${res.out}` };
       const orchestrator = new PhaseOrchestrator({
         graph,
         ctx: {
-          executeTask: async (task, phaseId, env) => {
+          executeTask: async (task, phaseId, env, signal) => {
             const phase = graph.phases.get(phaseId);
             const phaseName = phase?.name ?? phaseId;
             let agentName = task.assignee;
@@ -6297,7 +6368,7 @@ ${res.out}` };
             return runOnce(
               buildTaskPrompt(task, phaseName, title),
               "goal-" + agentName.slice(0, 48),
-              abort.signal,
+              signal ? AbortSignal.any([abort.signal, signal]) : abort.signal,
               env?.cwd
             );
           },
@@ -8937,7 +9008,7 @@ ${color13.dim("YOLO enabled; tool calls run without approval unless an explicit
 }
 
 // src/slash-commands/brain.ts
-import { randomUUID as randomUUID5 } from "node:crypto";
+import { randomUUID as randomUUID6 } from "node:crypto";
 import { color as color16 } from "@wrongstack/core/utils";
 
 // src/slash-commands/brain-council.ts
@@ -9547,7 +9618,7 @@ function buildBrainCommand(opts) {
         }
         try {
           const decision = await opts.brain.decide({
-            id: `brain-ask-${randomUUID5()}`,
+            id: `brain-ask-${randomUUID6()}`,
             sessionId: opts.context?.session.id,
             source: "user",
             question,
@@ -11925,7 +11996,7 @@ function buildDoctorCommand(opts) {
   ].join("\n");
   async function loadPluginSchemas() {
     try {
-      const { BUILTIN_PLUGIN_FACTORIES } = await import("./plugins-XRGWC3NJ.js");
+      const { BUILTIN_PLUGIN_FACTORIES } = await import("./plugins-EEKHCMBE.js");
       const settled = await Promise.allSettled(BUILTIN_PLUGIN_FACTORIES.map((f) => f()));
       const loaded = [];
       for (const s of settled) {
@@ -15740,7 +15811,7 @@ function buildKanbanAgentPrompt(board, task, assignment) {
   const dependencyLines = (task.dependsOn ?? []).map((depId) => board.tasks.find((candidate) => candidate.id === depId)).filter((dep) => Boolean(dep)).map((dep) => `- ${dep.title} [${dep.status}] (${dep.id})`);
   const checks = task.successCriteria?.map((check) => `- ${check.description}`).join("\n");
   const metrics = task.goalMetrics?.map(
-    (metric) => `- ${metric.name}: ${metric.current ?? "n/a"}${metric.target !== void 0 ? ` / ${metric.target}` : ""}${metric.unit ? ` ${metric.unit}` : ""} [${metric.status}]`
+    (metric) => `- ${metric.name}: ${metric.current ?? "n/a"}${metric.target !== void 0 ? ` / ${metric.direction === "at_most" ? "\u2264" : "\u2265"} ${metric.target}` : ""}${metric.unit ? ` ${metric.unit}` : ""} [${metric.status}]`
   ).join("\n");
   const chain = task.chain ? [
     `chainId: ${task.chain.chainId}`,
@@ -16648,8 +16719,8 @@ function buildKanbanCommand(opts) {
 
 // src/slash-commands/mailbox.ts
 import {
-  getSharedProjectMailbox as getSharedProjectMailbox6,
-  mailboxSessionTag as mailboxSessionTag4,
+  getSharedProjectMailbox as getSharedProjectMailbox7,
+  mailboxSessionTag as mailboxSessionTag5,
   resolveMailboxIdentity,
   resolveProjectDir as resolveProjectDir2
 } from "@wrongstack/core/coordination";
@@ -16657,7 +16728,7 @@ import { color as color37, wstackGlobalRoot as wstackGlobalRoot2 } from "@wrongs
 function buildMailbox(opts) {
   const projectDir = opts.paths?.projectDir ?? resolveProjectDir2(opts.projectRoot, wstackGlobalRoot2());
   try {
-    return getSharedProjectMailbox6(projectDir);
+    return getSharedProjectMailbox7(projectDir);
   } catch {
     return null;
   }
@@ -16667,7 +16738,7 @@ function leaderId(opts) {
     const identity = resolveMailboxIdentity(opts.context);
     return { id: identity.callerId, base: identity.baseId };
   }
-  return { id: `leader@${mailboxSessionTag4("default")}`, base: "leader" };
+  return { id: `leader@${mailboxSessionTag5("default")}`, base: "leader" };
 }
 function fmtAge3(iso) {
   const ms = Date.now() - new Date(iso).getTime();
@@ -16977,7 +17048,7 @@ function buildMailboxCommand(opts) {
 
 // src/slash-commands/mailbox-demo.ts
 import {
-  getSharedProjectMailbox as getSharedProjectMailbox7,
+  getSharedProjectMailbox as getSharedProjectMailbox8,
   resolveProjectDir as resolveProjectDir3
 } from "@wrongstack/core/coordination";
 import { wstackGlobalRoot as wstackGlobalRoot3 } from "@wrongstack/core/utils";
@@ -16985,7 +17056,7 @@ var DEMO_AGENT_ID = "mailbox-demo";
 function buildMailbox2(opts) {
   const projectDir = opts.paths?.projectDir ?? resolveProjectDir3(opts.projectRoot, wstackGlobalRoot3());
   try {
-    return getSharedProjectMailbox7(projectDir);
+    return getSharedProjectMailbox8(projectDir);
   } catch {
     return null;
   }
@@ -26802,7 +26873,7 @@ function buildSupervisorCommand(opts) {
 }
 
 // src/slash-commands/tasks.ts
-import { randomUUID as randomUUID6 } from "node:crypto";
+import { randomUUID as randomUUID7 } from "node:crypto";
 import {
   addPlanItem as addPlanItem2,
   emptyPlan as emptyPlan2,
@@ -26965,7 +27036,7 @@ ${formatPlan2(updated)}`;
             const title = parts.join(" ");
             const now = (/* @__PURE__ */ new Date()).toISOString();
             file.tasks.push({
-              id: `task_${randomUUID6()}`,
+              id: `task_${randomUUID7()}`,
               title,
               type,
               priority,
@@ -27135,7 +27206,7 @@ ${formatTaskProgress(file.tasks)}`;
             ];
             if (found.item.description) {
               todos.push({
-                id: `todo_${randomUUID6()}`,
+                id: `todo_${randomUUID7()}`,
                 content: found.item.description.slice(0, 200),
                 status: "pending",
                 promotedFromTask: found.item.id
@@ -28018,7 +28089,7 @@ function buildTelegramSettingsCommand(opts) {
 }
 
 // src/slash-commands/todos.ts
-import { randomUUID as randomUUID7 } from "node:crypto";
+import { randomUUID as randomUUID8 } from "node:crypto";
 import { formatTodosList as formatTodosList2 } from "@wrongstack/core/utils";
 import { todoTool as todoTool3 } from "@wrongstack/tools";
 function findTodo(todos, query) {
@@ -28077,7 +28148,7 @@ function buildTodosCommand(opts) {
               return { message: "This Todo list is a Kanban projection. Add the task in Kanban." };
             }
             const item = {
-              id: `todo_${Date.now()}_${randomUUID7().slice(0, 7)}`,
+              id: `todo_${Date.now()}_${randomUUID8().slice(0, 7)}`,
               content: restJoined,
               status: "pending"
             };
@@ -30099,7 +30170,7 @@ async function spawnAgent2(director, role, task, maxIterations) {
 // src/wiring/dep-watcher.ts
 import * as path22 from "node:path";
 import {
-  getSharedProjectMailbox as getSharedProjectMailbox8,
+  getSharedProjectMailbox as getSharedProjectMailbox9,
   startPackageOutdatedWatcher,
   startTechStackConsumer
 } from "@wrongstack/core/coordination";
@@ -30119,7 +30190,7 @@ function setupDepWatcherConsumers(deps) {
   if (dwCfg?.["enabled"] === true) {
     try {
       const projectDir = path22.join(globalRoot, "projects", projectSlug);
-      const tsMailbox = getSharedProjectMailbox8(projectDir, events);
+      const tsMailbox = getSharedProjectMailbox9(projectDir, events);
       const fileAuthorOpts = {
         storageDir: projectDir,
         projectRoot
@@ -30152,7 +30223,7 @@ function setupDepWatcherConsumers(deps) {
   if (dwCfg?.["enabled"] === true) {
     try {
       const projectDir = path22.join(globalRoot, "projects", projectSlug);
-      const pkgMailbox = getSharedProjectMailbox8(projectDir, events);
+      const pkgMailbox = getSharedProjectMailbox9(projectDir, events);
       const pkgTrackerOpts = {
         storageDir: projectDir,
         projectRoot
@@ -30195,7 +30266,7 @@ function setupDepWatcherConsumers(deps) {
 
 // src/wiring/dep-watcher-bridge.ts
 import * as path23 from "node:path";
-import { attachDepWatcherBridge, getSharedProjectMailbox as getSharedProjectMailbox9 } from "@wrongstack/core/coordination";
+import { attachDepWatcherBridge, getSharedProjectMailbox as getSharedProjectMailbox10 } from "@wrongstack/core/coordination";
 function setupDepWatcherBridge(deps) {
   const { config, wpaths, projectRoot, events, logger, teardownHandlers } = deps;
   const fwCfg = config.extensions?.["file-watcher"];
@@ -30204,7 +30275,7 @@ function setupDepWatcherBridge(deps) {
   if (dwCfg?.["enabled"] === true) {
     try {
       const projectDir = path23.join(wpaths.globalRoot, "projects", wpaths.projectSlug);
-      const dwMailbox = getSharedProjectMailbox9(projectDir, events);
+      const dwMailbox = getSharedProjectMailbox10(projectDir, events);
       depWatcherDispose = attachDepWatcherBridge({
         events,
         mailbox: dwMailbox,
@@ -30540,7 +30611,7 @@ function setupHqTelemetry(deps) {
     agentMonitor,
     brainMailbox,
     teardownHandlers,
-    mailboxSessionTag: mailboxSessionTag6,
+    mailboxSessionTag: mailboxSessionTag7,
     hqPublisherRef,
     mcpRegistry
   } = deps;
@@ -30549,7 +30620,7 @@ function setupHqTelemetry(deps) {
   const hqCommandController = {
     steerMailbox: brainMailbox,
     interruptLeader: () => false,
-    sessionTag: () => mailboxSessionTag6(session.id),
+    sessionTag: () => mailboxSessionTag7(session.id),
     allowRunCommand: () => flags["hq-allow-exec"] === true
   };
   const hqOnCommand = createHqCommandDispatcher(hqCommandController);
@@ -30704,7 +30775,7 @@ function setupHqTelemetry(deps) {
 
 // src/wiring/lifecycle-plugins.ts
 import * as path28 from "node:path";
-import { getSharedProjectMailbox as getSharedProjectMailbox10 } from "@wrongstack/core/coordination";
+import { getSharedProjectMailbox as getSharedProjectMailbox11 } from "@wrongstack/core/coordination";
 import { CouncilOrchestrator, OneShotOrchestrator as OneShotOrchestrator2 } from "@wrongstack/core/execution";
 import { countShellHooks, HookRegistry, HookRunner, shellHooksEqual } from "@wrongstack/core/hooks";
 import { allServers as allServers3 } from "@wrongstack/core/infrastructure";
@@ -31764,7 +31835,7 @@ async function setupLifecycleAndPlugins(deps) {
   registerMcpObservability(healthRegistry, metricsSink, mcpRegistry);
   const slashRegistry = new SlashCommandRegistry();
   const hqPublisherRef = { current: void 0 };
-  const brainMailbox = getSharedProjectMailbox10(
+  const brainMailbox = getSharedProjectMailbox11(
     wpaths.projectDir,
     events,
     () => hqPublisherRef.current
@@ -31825,7 +31896,8 @@ async function setupLifecycleAndPlugins(deps) {
       historyFile: wpaths.historyFile,
       syncConfig: wpaths.syncConfig,
       projectDir: wpaths.projectDir,
-      projectGoal: wpaths.projectGoal
+      projectGoal: wpaths.projectGoal,
+      projectRoot: wpaths.projectRoot
     },
     hookRegistry,
     mailbox: brainMailbox,
@@ -33384,7 +33456,7 @@ async function runInteractive(cliCtx) {
     cwd,
     wpaths,
     teardownHandlers,
-    mailboxSessionTag: mailboxSessionTag5,
+    mailboxSessionTag: mailboxSessionTag6,
     brainMailbox,
     agentMonitor,
     manifestPath,
@@ -33415,7 +33487,7 @@ async function runInteractive(cliCtx) {
     agentMonitor,
     brainMailbox,
     teardownHandlers,
-    mailboxSessionTag: mailboxSessionTag5,
+    mailboxSessionTag: mailboxSessionTag6,
     hqPublisherRef,
     mcpRegistry
   });
@@ -33748,4 +33820,4 @@ export {
   CLI_VERSION,
   runInteractive
 };
-//# sourceMappingURL=cli-main-HCCYX3D5.js.map
+//# sourceMappingURL=cli-main-L3T4KJKU.js.map

package/dist/fleet/host-explore-companion.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Host wiring for the ExploreCompanion — the state-triggered background
+ * codebase explorer behind the leader agent.
+ *
+ * Mirrors `host-supervisor.ts`: a thin builder that wires the core
+ * `ExploreCompanion` observer (coordination/explore-companion.ts) to the
+ * director, the project mailbox, and the host session. Built in
+ * `buildDirector()`, stopped in `dispose()`.
+ *
+ * Resident model: one `explore-companion` subagent is spawned lazily on the
+ * FIRST probe (never eagerly — an idle session pays nothing) and holds a
+ * stable subagent id so subsequent probes reuse it. When the resident is
+ * gone (removed/reaped/never spawned), the next probe spawns a fresh one.
+ * Probes are `assignInternal`ed, never awaited — the leader is never
+ * blocked, and internal tasks stay out of the leader-visible task surface
+ * (same treatment as shadow passes).
+ *
+ * @module host-explore-companion
+ */
+import { type Director, ExploreCompanion } from '@wrongstack/core/coordination';
+import type { EventBus } from '@wrongstack/core/kernel';
+import type { SubagentConfig } from '@wrongstack/core/types';
+/** Config block for the explore-companion host wiring (FleetConfig.exploreCompanion). */
+export interface HostExploreCompanionConfig {
+    /** Kill switch. Default true. */
+    enabled?: boolean | undefined;
+    /** Min gap between probes on the same subject (ms). Default 120_000. */
+    cooldownMs?: number | undefined;
+    /** Pending probe queue cap. Default 8. */
+    maxPending?: number | undefined;
+    /** Mailbox poll interval for explicit asks (ms). Default 5_000. */
+    pollIntervalMs?: number | undefined;
+}
+export interface HostExploreCompanionInput {
+    director: Director;
+    events: EventBus;
+    sessionId: string;
+    mailboxProjectDir: string;
+    roster: Record<string, SubagentConfig>;
+    config?: HostExploreCompanionConfig | undefined;
+}
+export declare function createHostExploreCompanion(input: HostExploreCompanionInput): ExploreCompanion | null;
+//# sourceMappingURL=host-explore-companion.d.ts.map

package/dist/fleet/host.d.ts

@@ -53,6 +53,11 @@ export declare class MultiAgentHost {
      *  buildDirector() (when a BrainArbiter is available), stopped in
      *  dispose(). Also published to the supervisor registry for /supervisor. */
     private fleetSupervisor;
+    /** ExploreCompanion — state-triggered background codebase explorer behind
+     *  the leader. Built in buildDirector() (unless disabled via
+     *  fleet.exploreCompanion.enabled=false), stopped in dispose(). Probes are
+     *  assigned to a lazily-spawned resident `explore-companion` subagent. */
+    private exploreCompanion;
     /** Built-ins plus lazily-resolved project-created roles. */
     private readonly roster;
     constructor(deps: MultiAgentDeps, opts?: MultiAgentHostOptions);

package/dist/index.js

@@ -1863,12 +1863,12 @@ var loaders = {
   providers: async () => (await import("./providers-models-4FAKM2WO.js")).providersCmd,
   models: async () => (await import("./providers-models-4FAKM2WO.js")).modelsCmd,
   mcp: async () => (await import("./mcp-CMLFHRG2.js")).mcpCmd,
-  plugin: async () => (await import("./plugin-usage-PTEETL3J.js")).pluginCmd,
-  plugins: async () => (await import("./plugin-usage-PTEETL3J.js")).pluginCmd,
+  plugin: async () => (await import("./plugin-usage-26LIIW3P.js")).pluginCmd,
+  plugins: async () => (await import("./plugin-usage-26LIIW3P.js")).pluginCmd,
   diag: async () => (await import("./diag-doctor-WTBHPOMB.js")).diagCmd,
   doctor: async () => (await import("./diag-doctor-WTBHPOMB.js")).doctorCmd,
   export: async () => (await import("./export-CCUXRJOU.js")).exportCmd,
-  usage: async () => (await import("./plugin-usage-PTEETL3J.js")).usageCmd,
+  usage: async () => (await import("./plugin-usage-26LIIW3P.js")).usageCmd,
   version: async () => (await import("./version-help-TFD6VPF3.js")).versionCmd,
   help: async () => (await import("./version-help-TFD6VPF3.js")).helpCmd,
   projects: async () => (await import("./projects-XE76NFNZ.js")).projectsCmd,
@@ -4466,7 +4466,7 @@ async function initializeCli(argv) {
 async function main(argv) {
   const cliCtx = await initializeCli(argv);
   if (typeof cliCtx === "number") return cliCtx;
-  const { runInteractive } = await import("./cli-main-HCCYX3D5.js");
+  const { runInteractive } = await import("./cli-main-L3T4KJKU.js");
   return runInteractive(cliCtx);
 }
 

package/dist/plugin-management.d.ts

@@ -14,6 +14,15 @@ export declare const OFFICIAL_PLUGINS: readonly [{
 export interface PluginManagementDeps {
     config: Config;
     configPath: string;
+    /** Override `~/.wrongstack` for tests. Defaults to the real home dir. */
+    globalRoot?: string | undefined;
+    /** Injectable package-manager runner for tests. */
+    runPackageManager?: ((pm: string, args: readonly string[], cwd: string) => Promise<PackageManagerRunResult>) | undefined;
+}
+export interface PackageManagerRunResult {
+    code: number | null;
+    stdout: string;
+    stderr: string;
 }
 export interface PluginManagementResult {
     code: number;

package/dist/{plugin-usage-PTEETL3J.js → plugin-usage-26LIIW3P.js}

@@ -1,6 +1,6 @@
 import {
   runPluginManagementCommand
-} from "./chunk-RK7E3IXT.js";
+} from "./chunk-H6C7SO5H.js";
 import {
   restoreFlags
 } from "./chunk-CSAPOCBP.js";
@@ -41,4 +41,4 @@ export {
   pluginCmd,
   usageCmd
 };
-//# sourceMappingURL=plugin-usage-PTEETL3J.js.map
+//# sourceMappingURL=plugin-usage-26LIIW3P.js.map

package/dist/{plugins-XRGWC3NJ.js → plugins-EEKHCMBE.js}

@@ -7,8 +7,8 @@ import {
   pluginNameFromSpec,
   setupPlugins,
   warnIfDeprecatedPluginName
-} from "./chunk-KV6DNQT6.js";
-import "./chunk-RK7E3IXT.js";
+} from "./chunk-BZJ4MP32.js";
+import "./chunk-H6C7SO5H.js";
 import "./chunk-TYO2OVAD.js";
 import "./chunk-7OCVIDC7.js";
 export {
@@ -21,4 +21,4 @@ export {
   setupPlugins,
   warnIfDeprecatedPluginName
 };
-//# sourceMappingURL=plugins-XRGWC3NJ.js.map
+//# sourceMappingURL=plugins-EEKHCMBE.js.map