@cleocode/cleo 2026.4.25 → 2026.4.26

package/dist/cli/index.js

@@ -38789,10 +38789,10 @@ async function readProjectMeta(projectPath) {
 }
 async function readProjectId(projectPath) {
   try {
-    const { readFileSync: readFileSync102, existsSync: existsSync131 } = await import("node:fs");
+    const { readFileSync: readFileSync103, existsSync: existsSync131 } = await import("node:fs");
     const infoPath = join64(projectPath, ".cleo", "project-info.json");
     if (!existsSync131(infoPath)) return "";
-    const data = JSON.parse(readFileSync102(infoPath, "utf-8"));
+    const data = JSON.parse(readFileSync103(infoPath, "utf-8"));
     return typeof data.projectId === "string" ? data.projectId : "";
   } catch {
     return "";
@@ -75190,6 +75190,7 @@ var init_cleo = __esm({
 // packages/core/src/index.ts
 var init_src2 = __esm({
   "packages/core/src/index.ts"() {
+    "use strict";
     init_src();
     init_adapters();
     init_admin();
@@ -102133,6 +102134,30 @@ var init_registry5 = __esm({
         sessionRequired: false,
         requiredParams: []
       },
+      {
+        gateway: "query",
+        domain: "admin",
+        operation: "roadmap",
+        description: "admin.roadmap (query) \u2014 project roadmap from task provenance, epics grouped by status with progress",
+        tier: 1,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: [],
+        params: [
+          {
+            name: "includeHistory",
+            type: "boolean",
+            required: false,
+            description: "Include release history from CHANGELOG.md"
+          },
+          {
+            name: "upcomingOnly",
+            type: "boolean",
+            required: false,
+            description: "Only show pending/upcoming epics (exclude completed)"
+          }
+        ]
+      },
       {
         gateway: "query",
         domain: "admin",
@@ -109397,6 +109422,13 @@ var init_admin2 = __esm({
               });
               return wrapResult(result, "query", "admin", operation, startTime);
             }
+            case "roadmap": {
+              const result = await systemRoadmap(projectRoot, {
+                includeHistory: params?.includeHistory,
+                upcomingOnly: params?.upcomingOnly
+              });
+              return wrapResult(result, "query", "admin", operation, startTime);
+            }
             case "smoke": {
               const result = await systemSmoke();
               return wrapResult(result, "query", "admin", operation, startTime);
@@ -109897,6 +109929,7 @@ var init_admin2 = __esm({
             "backup",
             "export",
             "map",
+            "roadmap",
             "smoke",
             "hooks.matrix"
           ],
@@ -111707,7 +111740,7 @@ var init_nexus2 = __esm({
 async function orchestrateClassify(request, context, projectRoot) {
   try {
     const { getCleoCantWorkflowsDir: getCleoCantWorkflowsDir2 } = await Promise.resolve().then(() => (init_internal(), internal_exports));
-    const { readFileSync: readFileSync102, readdirSync: readdirSync42, existsSync: existsSync131 } = await import("node:fs");
+    const { readFileSync: readFileSync103, readdirSync: readdirSync42, existsSync: existsSync131 } = await import("node:fs");
     const { join: join131 } = await import("node:path");
     const workflowsDir = getCleoCantWorkflowsDir2();
     const combined = `${request} ${context ?? ""}`.toLowerCase();
@@ -111716,7 +111749,7 @@ async function orchestrateClassify(request, context, projectRoot) {
       const files = readdirSync42(workflowsDir).filter((f2) => f2.endsWith(".cant"));
       for (const file2 of files) {
         try {
-          const src = readFileSync102(join131(workflowsDir, file2), "utf-8");
+          const src = readFileSync103(join131(workflowsDir, file2), "utf-8");
           const teamMatch = /^team\s+(\S+):/m.exec(src);
           if (!teamMatch) continue;
           const teamName = teamMatch[1];
@@ -111736,7 +111769,7 @@ async function orchestrateClassify(request, context, projectRoot) {
       const files = readdirSync42(localCantDir).filter((f2) => f2.endsWith(".cant"));
       for (const file2 of files) {
         try {
-          const src = readFileSync102(join131(localCantDir, file2), "utf-8");
+          const src = readFileSync103(join131(localCantDir, file2), "utf-8");
           const teamMatch = /^team\s+(\S+):/m.exec(src);
           if (!teamMatch) continue;
           const teamName = teamMatch[1];
@@ -116276,7 +116309,7 @@ var init_cli = __esm({
 
 // packages/cleo/src/cli/index.ts
 init_internal();
-import { readFileSync as readFileSync101 } from "node:fs";
+import { readFileSync as readFileSync102 } from "node:fs";
 import { dirname as dirname28, join as join130 } from "node:path";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 
@@ -117619,6 +117652,13 @@ function registerAdminCommand(program) {
   admin.command("context-inject <protocolType>").description(
     "Inject protocol content into session context (e.g. cleo-base, ct-orchestrator, ct-cleo)"
   ).option("--task <id>", "Scope injection to a specific task ID").option("--variant <variant>", "Select a named protocol variant").action(async (protocolType, opts) => {
+    if (!protocolType || typeof protocolType !== "string" || protocolType.trim() === "") {
+      console.error("Error: missing required argument <protocolType>");
+      console.error(
+        "Usage: cleo admin context-inject <protocolType> [--task <id>] [--variant <variant>]"
+      );
+      process.exit(1);
+    }
     await dispatchFromCli(
       "mutate",
       "admin",
@@ -117873,7 +117913,7 @@ agent ${agentId}:
     try {
       const { AgentRegistryAccessor: AgentRegistryAccessor2, getDb: getDb4 } = await Promise.resolve().then(() => (init_internal(), internal_exports));
       const { createRuntime } = await import("@cleocode/runtime");
-      const { existsSync: existsSync131, readFileSync: readFileSync102 } = await import("node:fs");
+      const { existsSync: existsSync131, readFileSync: readFileSync103 } = await import("node:fs");
       const { join: join131 } = await import("node:path");
       await getDb4();
       const registry2 = new AgentRegistryAccessor2(process.cwd());
@@ -117896,7 +117936,7 @@ agent ${agentId}:
       let cantValidation = null;
       const cantPath = opts["cant"] ?? join131(".cleo", "agents", `${agentId}.cant`);
       if (existsSync131(cantPath)) {
-        profile = readFileSync102(cantPath, "utf-8");
+        profile = readFileSync103(cantPath, "utf-8");
         try {
           const cantModule = await import("@cleocode/cant");
           const validate = "validate" in cantModule ? cantModule.validate : null;
@@ -118936,7 +118976,7 @@ Task ${taskId} reassigned to you by ${active.agentId}. Run: cleo show ${taskId}
   });
   agent.command("install <path>").description("Install an agent from a .cantz archive or agent directory").option("--global", "Install to global tier (~/.local/share/cleo/cant/agents/)").action(async (sourcePath, opts) => {
     try {
-      const { existsSync: existsSync131, mkdirSync: mkdirSync31, cpSync, readFileSync: readFileSync102, rmSync: rmSync3, statSync: statSync22 } = await import("node:fs");
+      const { existsSync: existsSync131, mkdirSync: mkdirSync31, cpSync, readFileSync: readFileSync103, rmSync: rmSync3, statSync: statSync22 } = await import("node:fs");
       const { join: join131, basename: basename19, resolve: resolve16 } = await import("node:path");
       const { homedir: homedir7 } = await import("node:os");
       const { tmpdir: tmpdir3 } = await import("node:os");
@@ -119055,7 +119095,7 @@ Task ${taskId} reassigned to you by ${active.agentId}. Run: cleo show ${taskId}
       }
       let registered = false;
       try {
-        const persona = readFileSync102(join131(targetDir, "persona.cant"), "utf-8");
+        const persona = readFileSync103(join131(targetDir, "persona.cant"), "utf-8");
         const descMatch = persona.match(/description:\s*"([^"]+)"/);
         const displayName = descMatch?.[1] ?? agentName;
         const { AgentRegistryAccessor: AgentRegistryAccessor2, getDb: getDb4 } = await Promise.resolve().then(() => (init_internal(), internal_exports));
@@ -120840,6 +120880,47 @@ async function loadMigrateEngine() {
   throw new Error("Cannot load CANT migration engine. Ensure @cleocode/cant is installed.");
 }
 
+// packages/cleo/src/cli/commands/chain.ts
+init_cli();
+import { readFileSync as readFileSync98 } from "node:fs";
+function registerChainCommand(program) {
+  const chain = program.command("chain").description("WarpChain pipeline management (tier-2 orchestrator)");
+  chain.command("show <chainId>").description("Show details for a WarpChain definition").action(async (chainId) => {
+    await dispatchFromCli("query", "pipeline", "chain.show", { chainId }, { command: "chain" });
+  });
+  chain.command("list").description("List all WarpChain definitions").action(async () => {
+    await dispatchFromCli("query", "pipeline", "chain.list", {}, { command: "chain" });
+  });
+  chain.command("add <file>").description("Add a new WarpChain definition from a JSON file").action(async (file2) => {
+    const chainJson = JSON.parse(readFileSync98(file2, "utf-8"));
+    await dispatchFromCli(
+      "mutate",
+      "pipeline",
+      "chain.add",
+      { chain: chainJson },
+      { command: "chain" }
+    );
+  });
+  chain.command("instantiate <chainId> <epicId>").description("Instantiate a WarpChain for an epic").action(async (chainId, epicId) => {
+    await dispatchFromCli(
+      "mutate",
+      "pipeline",
+      "chain.instantiate",
+      { chainId, epicId },
+      { command: "chain" }
+    );
+  });
+  chain.command("advance <instanceId> <nextStage>").description("Advance a WarpChain instance to the next stage").action(async (instanceId, nextStage) => {
+    await dispatchFromCli(
+      "mutate",
+      "pipeline",
+      "chain.advance",
+      { instanceId, nextStage },
+      { command: "chain" }
+    );
+  });
+}
+
 // packages/cleo/src/cli/commands/check.ts
 init_cli();
 var SUPPORTED_PROTOCOL_TYPES = [
@@ -120880,10 +120961,10 @@ function registerCheckCommand(program) {
     );
   });
   check2.command("chain-validate <file>").description("Validate a WarpChain definition from a JSON file").action(async (file2) => {
-    const { readFileSync: readFileSync102 } = await import("node:fs");
+    const { readFileSync: readFileSync103 } = await import("node:fs");
     let chain;
     try {
-      chain = JSON.parse(readFileSync102(file2, "utf8"));
+      chain = JSON.parse(readFileSync103(file2, "utf8"));
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
       console.error(`Failed to read or parse chain file: ${message}`);
@@ -121057,7 +121138,7 @@ function registerClaimCommand(program) {
       "tasks",
       "claim",
       {
-        taskId,
+        id: taskId,
         agentId: opts["agent"]
       },
       { command: "claim", operation: "tasks.claim" }
@@ -121070,7 +121151,7 @@ function registerUnclaimCommand(program) {
       "mutate",
       "tasks",
       "unclaim",
-      { taskId },
+      { id: taskId },
       { command: "unclaim", operation: "tasks.unclaim" }
     );
   });
@@ -121571,7 +121652,7 @@ function registerDepsCommand(program) {
       {
         epicId
       },
-      { command: "deps", operation: "tasks.depends" }
+      { command: "deps", operation: "orchestrate.waves" }
     );
   });
   deps.command("critical-path <taskId>").description("Find longest dependency chain from task").action(async (taskId) => {
@@ -121641,7 +121722,7 @@ function registerDetectCommand(program) {
 // packages/cleo/src/cli/commands/detect-drift.ts
 init_src();
 init_renderers();
-import { existsSync as existsSync129, readdirSync as readdirSync41, readFileSync as readFileSync98 } from "node:fs";
+import { existsSync as existsSync129, readdirSync as readdirSync41, readFileSync as readFileSync99 } from "node:fs";
 import { dirname as dirname26, join as join125 } from "node:path";
 function findProjectRoot() {
   let currentDir = process.cwd();
@@ -121661,7 +121742,7 @@ function registerDetectDriftCommand(program) {
     const isCleoRepo = existsSync129(join125(projectRoot, "src", "cli", "commands")) || existsSync129(join125(projectRoot, "packages", "cleo", "src"));
     const safeRead = (filePath) => {
       try {
-        return readFileSync98(filePath, "utf-8");
+        return readFileSync99(filePath, "utf-8");
       } catch {
         return "";
       }
@@ -122396,27 +122477,6 @@ function registerDoctorCommand(program) {
   });
 }
 
-// packages/cleo/src/cli/commands/env.ts
-init_internal();
-init_renderers();
-async function getEnvStatus() {
-  return getRuntimeDiagnostics({ detailed: false });
-}
-async function getEnvInfo() {
-  return getRuntimeDiagnostics({ detailed: true });
-}
-function registerEnvCommand(program) {
-  const env = program.command("env").description("Environment and mode inspection");
-  env.command("status", { isDefault: true }).description("Show current environment mode and runtime info").action(async () => {
-    const result = await getEnvStatus();
-    cliOutput(result, { command: "env" });
-  });
-  env.command("info").description("Show detailed environment info including binary paths and compilation status").action(async () => {
-    const result = await getEnvInfo();
-    cliOutput(result, { command: "env" });
-  });
-}
-
 // packages/cleo/src/cli/commands/exists.ts
 init_src();
 init_internal();
@@ -122641,12 +122701,12 @@ init_src();
 init_src2();
 init_renderers();
 import { execFileSync as execFileSync16 } from "node:child_process";
-import { existsSync as existsSync130, mkdirSync as mkdirSync30, readFileSync as readFileSync99, writeFileSync as writeFileSync24 } from "node:fs";
+import { existsSync as existsSync130, mkdirSync as mkdirSync30, readFileSync as readFileSync100, writeFileSync as writeFileSync24 } from "node:fs";
 import { dirname as dirname27, join as join127 } from "node:path";
 function getChangelogSource(cwd) {
   const configPath = getConfigPath(cwd);
   try {
-    const config2 = JSON.parse(readFileSync99(configPath, "utf-8"));
+    const config2 = JSON.parse(readFileSync100(configPath, "utf-8"));
     return config2?.release?.changelog?.source ?? "CHANGELOG.md";
   } catch {
     return "CHANGELOG.md";
@@ -122655,7 +122715,7 @@ function getChangelogSource(cwd) {
 function getEnabledPlatforms(cwd) {
   const configPath = getConfigPath(cwd);
   try {
-    const config2 = JSON.parse(readFileSync99(configPath, "utf-8"));
+    const config2 = JSON.parse(readFileSync100(configPath, "utf-8"));
     const outputs = config2?.release?.changelog?.outputs ?? [];
     return outputs.filter((o) => o.enabled);
   } catch {
@@ -122784,7 +122844,7 @@ function registerGenerateChangelogCommand(program) {
       if (!existsSync130(sourcePath)) {
         throw new CleoError(4 /* NOT_FOUND */, `Changelog source not found: ${sourcePath}`);
       }
-      const sourceContent = readFileSync99(sourcePath, "utf-8");
+      const sourceContent = readFileSync100(sourcePath, "utf-8");
       const repoSlug = getGitHubRepoSlug();
       const results = [];
       if (targetPlatform) {
@@ -123476,9 +123536,20 @@ function registerMemoryBrainCommand(program) {
     }
     cliOutput(result, { command: "memory", operation: "memory.stats" });
   });
-  memory.command("observe <text>").description("Save an observation to brain.db").option("--title <title>", "Short title for the observation").option(
+  memory.command("observe <text>").description(
+    "Save an observation to brain.db \u2014 captures facts, decisions, and discoveries for cross-session memory"
+  ).option(
+    "--title <title>",
+    "Short title for the observation (defaults to first 120 chars of text)"
+  ).option(
+    "--type <type>",
+    "Category: discovery (found something new), decision (choice made), bugfix (bug found/fixed), refactor (code restructured), feature (feature added), change (general change), pattern (recurring pattern), session_summary (end-of-session recap)"
+  ).option(
     "--agent <name>",
-    "Tag this observation with the producing agent name (Wave 8 mental models)"
+    "Name of the agent producing this observation (enables per-agent memory retrieval)"
+  ).option(
+    "--source-type <sourceType>",
+    "How this observation was captured: manual (typed by human/agent), auto (lifecycle hook), transcript (extracted from session)"
   ).action(async (text3, opts) => {
     await dispatchFromCli(
       "mutate",
@@ -123487,7 +123558,9 @@ function registerMemoryBrainCommand(program) {
       {
         text: text3,
         title: opts["title"],
-        ...opts["agent"] !== void 0 && { agent: opts["agent"] }
+        ...opts["agent"] !== void 0 && { agent: opts["agent"] },
+        ...opts["type"] !== void 0 && { type: opts["type"] },
+        sourceType: opts["sourceType"] ?? "manual"
       },
       { command: "memory", operation: "memory.observe" }
     );
@@ -123515,7 +123588,7 @@ function registerMemoryBrainCommand(program) {
       { command: "memory", operation: "memory.fetch" }
     );
   });
-  memory.command("decision find [query]").description("Search decisions stored in brain.db").option("--limit <n>", "Maximum results", parseInt).option("--json", "Output as JSON").action(async (query, opts) => {
+  memory.command("decision-find [query]").description("Search decisions stored in brain.db").option("--limit <n>", "Maximum results", parseInt).option("--json", "Output as JSON").action(async (query, opts) => {
     await dispatchFromCli(
       "query",
       "memory",
@@ -123527,7 +123600,7 @@ function registerMemoryBrainCommand(program) {
       { command: "memory", operation: "memory.decision.find" }
     );
   });
-  memory.command("decision store").description("Store a decision to brain.db").requiredOption("--decision <text>", "The decision that was made").requiredOption("--rationale <text>", "Rationale behind the decision").option("--alternatives <text>", "Alternatives that were considered").option("--linked-task <id>", "Task ID to associate with this decision").option("--json", "Output as JSON").action(async (opts) => {
+  memory.command("decision-store").description("Store a decision to brain.db").requiredOption("--decision <text>", "The decision that was made").requiredOption("--rationale <text>", "Rationale behind the decision").option("--alternatives <text>", "Alternatives that were considered").option("--linked-task <id>", "Task ID to associate with this decision").option("--json", "Output as JSON").action(async (opts) => {
     await dispatchFromCli(
       "mutate",
       "memory",
@@ -123550,7 +123623,7 @@ function registerMemoryBrainCommand(program) {
       { command: "memory", operation: "memory.link" }
     );
   });
-  memory.command("graph show <nodeId>").description("Get a PageIndex graph node and its edges").option("--json", "Output as JSON").action(async (nodeId, _opts) => {
+  memory.command("graph-show <nodeId>").description("Get a PageIndex graph node and its edges").option("--json", "Output as JSON").action(async (nodeId, _opts) => {
     await dispatchFromCli(
       "query",
       "memory",
@@ -123559,7 +123632,7 @@ function registerMemoryBrainCommand(program) {
       { command: "memory", operation: "memory.graph.show" }
     );
   });
-  memory.command("graph neighbors <nodeId>").description("Get neighbor nodes from the PageIndex graph").option("--depth <n>", "Traversal depth", parseInt).option("--limit <n>", "Maximum neighbors", parseInt).option("--json", "Output as JSON").action(async (nodeId, opts) => {
+  memory.command("graph-neighbors <nodeId>").description("Get neighbor nodes from the PageIndex graph").option("--depth <n>", "Traversal depth", parseInt).option("--limit <n>", "Maximum neighbors", parseInt).option("--json", "Output as JSON").action(async (nodeId, opts) => {
     await dispatchFromCli(
       "query",
       "memory",
@@ -123572,7 +123645,7 @@ function registerMemoryBrainCommand(program) {
       { command: "memory", operation: "memory.graph.neighbors" }
     );
   });
-  memory.command("graph add").description("Add a node or edge to the PageIndex graph").option("--node-id <id>", "Node ID to add").option("--label <text>", "Label for the node").option("--from <id>", "Source node ID for an edge").option("--to <id>", "Target node ID for an edge").option("--edge-type <type>", "Edge relationship type").option("--json", "Output as JSON").action(async (opts) => {
+  memory.command("graph-add").description("Add a node or edge to the PageIndex graph").option("--node-id <id>", "Node ID to add").option("--label <text>", "Label for the node").option("--from <id>", "Source node ID for an edge").option("--to <id>", "Target node ID for an edge").option("--edge-type <type>", "Edge relationship type").option("--json", "Output as JSON").action(async (opts) => {
     await dispatchFromCli(
       "mutate",
       "memory",
@@ -123587,7 +123660,7 @@ function registerMemoryBrainCommand(program) {
       { command: "memory", operation: "memory.graph.add" }
     );
   });
-  memory.command("graph remove").description("Remove a node or edge from the PageIndex graph").option("--node-id <id>", "Node ID to remove").option("--from <id>", "Source node ID of the edge to remove").option("--to <id>", "Target node ID of the edge to remove").option("--json", "Output as JSON").action(async (opts) => {
+  memory.command("graph-remove").description("Remove a node or edge from the PageIndex graph").option("--node-id <id>", "Node ID to remove").option("--from <id>", "Source node ID of the edge to remove").option("--to <id>", "Target node ID of the edge to remove").option("--json", "Output as JSON").action(async (opts) => {
     await dispatchFromCli(
       "mutate",
       "memory",
@@ -123600,7 +123673,7 @@ function registerMemoryBrainCommand(program) {
       { command: "memory", operation: "memory.graph.remove" }
     );
   });
-  memory.command("reason why <taskId>").description("Causal trace through task dependency chains").option("--depth <n>", "Maximum trace depth", parseInt).option("--json", "Output as JSON").action(async (taskId, opts) => {
+  memory.command("reason-why <taskId>").description("Causal trace through task dependency chains").option("--depth <n>", "Maximum trace depth", parseInt).option("--json", "Output as JSON").action(async (taskId, opts) => {
     await dispatchFromCli(
       "query",
       "memory",
@@ -123612,7 +123685,7 @@ function registerMemoryBrainCommand(program) {
       { command: "memory", operation: "memory.reason.why" }
     );
   });
-  memory.command("reason similar <entryId>").description("Find semantically similar brain entries").option("--limit <n>", "Maximum results", parseInt).option("--json", "Output as JSON").action(async (entryId, opts) => {
+  memory.command("reason-similar <entryId>").description("Find semantically similar brain entries").option("--limit <n>", "Maximum results", parseInt).option("--json", "Output as JSON").action(async (entryId, opts) => {
     await dispatchFromCli(
       "query",
       "memory",
@@ -123624,7 +123697,7 @@ function registerMemoryBrainCommand(program) {
       { command: "memory", operation: "memory.reason.similar" }
     );
   });
-  memory.command("search hybrid <query>").description("Hybrid search across FTS5, vector, and graph indexes").option("--limit <n>", "Maximum results", parseInt).option("--json", "Output as JSON").action(async (query, opts) => {
+  memory.command("search-hybrid <query>").description("Hybrid search across FTS5, vector, and graph indexes").option("--limit <n>", "Maximum results", parseInt).option("--json", "Output as JSON").action(async (query, opts) => {
     await dispatchFromCli(
       "query",
       "memory",
@@ -123919,23 +123992,37 @@ function registerNexusCommand(program) {
 // packages/cleo/src/cli/commands/observe.ts
 init_cli();
 function registerObserveCommand(program) {
-  program.command("observe <text>").description("Save an observation to brain.db").option("-t, --title <title>", "Optional title (defaults to first 120 chars of text)").option(
+  program.command("observe <text>").description(
+    "Save an observation to brain.db \u2014 captures facts, decisions, and discoveries for cross-session memory"
+  ).option(
+    "-t, --title <title>",
+    "Short title for the observation (defaults to first 120 chars of text)"
+  ).option(
     "--type <type>",
-    "Observation type (discovery, decision, bugfix, refactor, feature, change, pattern, session_summary)"
-  ).action(async (text3, opts) => {
-    await dispatchFromCli(
-      "mutate",
-      "memory",
-      "observe",
-      {
-        text: text3,
-        title: opts.title,
-        ...opts.type !== void 0 && { type: opts.type },
-        sourceType: "manual"
-      },
-      { command: "observe", operation: "memory.observe" }
-    );
-  });
+    "Category: discovery (found something new), decision (choice made), bugfix (bug found/fixed), refactor (code restructured), feature (feature added), change (general change), pattern (recurring pattern), session_summary (end-of-session recap)"
+  ).option(
+    "--agent <name>",
+    "Name of the agent producing this observation (enables per-agent memory retrieval)"
+  ).option(
+    "--source-type <sourceType>",
+    "How this observation was captured: manual (typed by human/agent), auto (lifecycle hook), transcript (extracted from session)"
+  ).action(
+    async (text3, opts) => {
+      await dispatchFromCli(
+        "mutate",
+        "memory",
+        "observe",
+        {
+          text: text3,
+          title: opts.title,
+          ...opts.type !== void 0 && { type: opts.type },
+          ...opts.agent !== void 0 && { agent: opts.agent },
+          sourceType: opts.sourceType ?? "manual"
+        },
+        { command: "observe", operation: "memory.observe" }
+      );
+    }
+  );
 }
 
 // packages/cleo/src/cli/commands/ops.ts
@@ -124079,6 +124166,110 @@ function registerOrchestrateCommand(program) {
       { command: "orchestrate" }
     );
   });
+  orch.command("bootstrap").description("Load brain state for agent bootstrapping").option("--epic <epicId>", "Epic ID to scope bootstrap context to").action(async (opts) => {
+    await dispatchFromCli(
+      "query",
+      "orchestrate",
+      "bootstrap",
+      { epicId: opts["epic"] },
+      { command: "orchestrate" }
+    );
+  });
+  orch.command("classify <request>").description("Classify a request using CANT prompt-based team routing").action(async (request) => {
+    await dispatchFromCli(
+      "query",
+      "orchestrate",
+      "classify",
+      { request },
+      { command: "orchestrate" }
+    );
+  });
+  orch.command("fanout-status").description("Get fanout status for an epic").option("--epic <epicId>", "Epic ID to scope fanout status to").action(async (opts) => {
+    await dispatchFromCli(
+      "query",
+      "orchestrate",
+      "fanout.status",
+      { epicId: opts["epic"] },
+      { command: "orchestrate" }
+    );
+  });
+  orch.command("handoff <taskId>").description("Perform session handoff and spawn successor for a task").requiredOption("--protocol <type>", "Protocol type for handoff").action(async (taskId, opts) => {
+    await dispatchFromCli(
+      "mutate",
+      "orchestrate",
+      "handoff",
+      { taskId, protocolType: opts["protocol"] },
+      { command: "orchestrate" }
+    );
+  });
+  orch.command("spawn-execute <taskId>").description("Execute spawn for a task via the adapter registry").action(async (taskId) => {
+    await dispatchFromCli(
+      "mutate",
+      "orchestrate",
+      "spawn.execute",
+      { taskId },
+      { command: "orchestrate" }
+    );
+  });
+  orch.command("fanout <epicId>").description("Fan out tasks for an epic using parallel spawn").option("--tasks <ids>", "Comma-separated task IDs to fan out").action(async (epicId, opts) => {
+    const taskIds = typeof opts["tasks"] === "string" ? opts["tasks"].split(",").map((s3) => s3.trim()) : void 0;
+    await dispatchFromCli(
+      "mutate",
+      "orchestrate",
+      "fanout",
+      { epicId, taskIds },
+      { command: "orchestrate" }
+    );
+  });
+  orch.command("conduit-status").description("Get conduit messaging status").action(async () => {
+    await dispatchFromCli(
+      "query",
+      "orchestrate",
+      "conduit.status",
+      {},
+      { command: "orchestrate" }
+    );
+  });
+  orch.command("conduit-peek").description("Peek at queued conduit messages").option("--limit <n>", "Maximum number of messages to return", parseInt).action(async (opts) => {
+    await dispatchFromCli(
+      "query",
+      "orchestrate",
+      "conduit.peek",
+      { limit: opts["limit"] },
+      { command: "orchestrate" }
+    );
+  });
+  orch.command("conduit-start").description("Start the conduit message loop").option("--poll-interval <ms>", "Polling interval in milliseconds", parseInt).action(async (opts) => {
+    await dispatchFromCli(
+      "mutate",
+      "orchestrate",
+      "conduit.start",
+      { pollInterval: opts["pollInterval"] },
+      { command: "orchestrate" }
+    );
+  });
+  orch.command("conduit-stop").description("Stop the conduit message loop").action(async () => {
+    await dispatchFromCli(
+      "mutate",
+      "orchestrate",
+      "conduit.stop",
+      {},
+      { command: "orchestrate" }
+    );
+  });
+  orch.command("conduit-send <content>").description("Send a message via conduit to an agent or conversation").option("--to <agentId>", "Target agent ID").option("--conversation <id>", "Conversation ID to send into").action(async (content, opts) => {
+    await dispatchFromCli(
+      "mutate",
+      "orchestrate",
+      "conduit.send",
+      {
+        content,
+        agentId: opts["to"],
+        conversationId: opts["conversation"]
+      },
+      { command: "orchestrate" }
+    );
+  });
 }
 
 // packages/cleo/src/cli/commands/otel.ts
@@ -125322,17 +125513,18 @@ function registerRestoreCommand(program) {
 // packages/cleo/src/cli/commands/roadmap.ts
 init_cli();
 function registerRoadmapCommand(program) {
-  program.command("roadmap").description("Generate roadmap from pending epics and CHANGELOG history").option("--include-history", "Include release history from CHANGELOG").option("--upcoming-only", "Only show upcoming/planned releases").action(async (opts) => {
+  program.command("roadmap").description(
+    "Generate project roadmap from task provenance \u2014 epics grouped by status with progress"
+  ).option("--include-history", "Include release history from CHANGELOG.md").option("--upcoming-only", "Only show pending/upcoming epics (exclude completed)").action(async (opts) => {
     await dispatchFromCli(
       "query",
       "admin",
-      "dash",
+      "roadmap",
       {
-        type: "roadmap",
         includeHistory: opts["includeHistory"],
         upcomingOnly: opts["upcomingOnly"]
       },
-      { command: "roadmap" }
+      { command: "roadmap", operation: "admin.roadmap" }
     );
   });
 }
@@ -126057,7 +126249,7 @@ function registerShowCommand(program) {
 // packages/cleo/src/cli/commands/skills.ts
 init_cli();
 function registerSkillsCommand(program) {
-  const skillsCmd = program.command("skills").description("Skill management: list, discover, validate, info, install");
+  const skillsCmd = program.command("skills").description("Skill management: list, search, validate, info, install");
   skillsCmd.command("list").description("List installed skills").option("--global", "Use global skills directory").action(async (opts) => {
     await dispatchFromCli(
       "query",
@@ -126081,17 +126273,6 @@ function registerSkillsCommand(program) {
       { command: "skills", operation: "tools.skill.find" }
     );
   });
-  skillsCmd.command("discover").description("Scan and discover available skills").action(async () => {
-    await dispatchFromCli(
-      "query",
-      "tools",
-      "skill.list",
-      {
-        scope: "project"
-      },
-      { command: "skills", operation: "tools.skill.list" }
-    );
-  });
   skillsCmd.command("validate <skill-name>").description("Validate skill against protocol").action(async (skillName) => {
     await dispatchFromCli(
       "query",
@@ -126577,6 +126758,36 @@ function registerSyncCommand(program) {
       { command: "sync", operation: "tasks.sync.links" }
     );
   });
+  sync.command("reconcile <file>").description("Reconcile external tasks from a JSON file against CLEO tasks").requiredOption("--provider <providerId>", "Provider ID (e.g. linear, jira, github)").option(
+    "--conflict-policy <policy>",
+    "How to resolve conflicts: keep-cleo, keep-external, or newest (default: keep-cleo)",
+    "keep-cleo"
+  ).action(async (file2, opts) => {
+    const { readFileSync: readFileSync103 } = await import("node:fs");
+    let externalTasks;
+    try {
+      externalTasks = JSON.parse(readFileSync103(file2, "utf8"));
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      console.error(`Failed to read or parse external tasks file: ${message}`);
+      process.exit(2);
+    }
+    if (!Array.isArray(externalTasks)) {
+      console.error("External tasks file must contain a JSON array");
+      process.exit(2);
+    }
+    await dispatchFromCli(
+      "mutate",
+      "tasks",
+      "sync.reconcile",
+      {
+        providerId: opts["provider"],
+        externalTasks,
+        conflictPolicy: opts["conflictPolicy"]
+      },
+      { command: "sync", operation: "tasks.sync.reconcile" }
+    );
+  });
 }
 
 // packages/cleo/src/cli/commands/testing.ts
@@ -126587,13 +126798,14 @@ function registerTestingCommand(program) {
     await dispatchFromCli(
       "query",
       "check",
-      "manifest",
+      "protocol",
       {
+        protocolType: "testing",
+        mode: "task",
         taskId,
-        strict: !!opts["strict"],
-        type: "testing"
+        strict: !!opts["strict"]
       },
-      { command: "testing", operation: "check.manifest" }
+      { command: "testing", operation: "check.protocol" }
     );
   });
   testingCmd.command("check <manifestFile>").description("Validate testing protocol from a manifest file").option("--strict", "Exit with error code on violations").action(async (manifestFile, opts) => {
@@ -126650,11 +126862,11 @@ function registerTestingCommand(program) {
 init_internal();
 init_cli();
 init_renderers();
-import { readFileSync as readFileSync100 } from "node:fs";
+import { readFileSync as readFileSync101 } from "node:fs";
 function readPayload(opts, textKey, fileKey) {
   const text3 = opts[textKey];
   const file2 = opts[fileKey];
-  if (file2) return readFileSync100(file2, "utf-8");
+  if (file2) return readFileSync101(file2, "utf-8");
   return text3;
 }
 function registerTokenCommand(program) {
@@ -127240,7 +127452,7 @@ var codeCommand = defineCommand({
 // packages/cleo/src/cli/index.ts
 function getPackageVersion() {
   const pkgPath = join130(dirname28(fileURLToPath5(import.meta.url)), "../../package.json");
-  const pkg = JSON.parse(readFileSync101(pkgPath, "utf-8"));
+  const pkg = JSON.parse(readFileSync102(pkgPath, "utf-8"));
   return pkg.version;
 }
 var CLI_VERSION = getPackageVersion();
@@ -127266,9 +127478,9 @@ registerDepsCommand(rootShim);
 registerTreeCommand(rootShim);
 registerResearchCommand(rootShim);
 registerOrchestrateCommand(rootShim);
+registerChainCommand(rootShim);
 registerLifecycleCommand(rootShim);
 registerReleaseCommand(rootShim);
-registerEnvCommand(rootShim);
 registerCheckpointCommand(rootShim);
 registerCommandsCommand(rootShim);
 registerDocsCommand(rootShim);