@cleocode/cleo 2026.5.72 → 2026.5.74

package/dist/cli/index.js

@@ -12054,6 +12054,25 @@ var init_registry = __esm({
           }
         ]
       },
+      // llm query: auxiliary-status — show configured auxiliary fallback chain
+      {
+        gateway: "query",
+        domain: "llm",
+        operation: "auxiliary-status",
+        description: "llm.auxiliary-status (query) \u2014 show the active multi-provider auxiliary fallback chain and how to configure it (T9319)",
+        tier: 2,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: [],
+        params: [
+          {
+            name: "projectRoot",
+            type: "string",
+            required: false,
+            description: "Optional project root for config resolution"
+          }
+        ]
+      },
       // llm mutate: add — upsert credential into the pool
       {
         gateway: "mutate",
@@ -16691,6 +16710,7 @@ var init_intelligence2 = __esm({
 // packages/cleo/src/dispatch/domains/llm/index.ts
 import {
   llmAdd,
+  llmAuxiliaryStatus,
   llmList,
   llmProfile,
   llmRemove,
@@ -16717,6 +16737,7 @@ var init_llm2 = __esm({
       list: llmList,
       test: llmTest,
       whoami: llmWhoami,
+      "auxiliary-status": llmAuxiliaryStatus,
       add: llmAdd,
       remove: llmRemove,
       use: llmUse,
@@ -16729,6 +16750,7 @@ var init_llm2 = __esm({
       list: async (params) => wrap(coreOps["list"], params, "list"),
       test: async (params) => wrap(coreOps["test"], params, "test"),
       whoami: async (params) => wrap(coreOps["whoami"], params, "whoami"),
+      "auxiliary-status": async (params) => wrap(coreOps["auxiliary-status"], params, "auxiliary-status"),
       // -------------------------------------------------------------------------
       // Mutate ops
       // -------------------------------------------------------------------------
@@ -16737,13 +16759,13 @@ var init_llm2 = __esm({
       use: async (params) => wrap(coreOps["use"], params, "use"),
       profile: async (params) => wrap(coreOps["profile"], params, "profile")
     });
-    QUERY_OPS4 = /* @__PURE__ */ new Set(["list", "test", "whoami"]);
+    QUERY_OPS4 = /* @__PURE__ */ new Set(["list", "test", "whoami", "auxiliary-status"]);
     MUTATE_OPS4 = /* @__PURE__ */ new Set(["add", "remove", "use", "profile"]);
     LlmHandler = class {
       /** Declared operations for introspection and validation. */
       getSupportedOperations() {
         return {
-          query: ["list", "test", "whoami"],
+          query: ["list", "test", "whoami", "auxiliary-status"],
           mutate: ["add", "remove", "use", "profile"]
         };
       }
@@ -24311,8 +24333,8 @@ async function loadPlaybookByName(name) {
     return null;
   }
   try {
-    const { getProjectRoot: getProjectRoot33 } = await import("@cleocode/core/internal");
-    const projectRoot = __playbookRuntimeOverrides.projectRoot ?? getProjectRoot33();
+    const { getProjectRoot: getProjectRoot34 } = await import("@cleocode/core/internal");
+    const projectRoot = __playbookRuntimeOverrides.projectRoot ?? getProjectRoot34();
     const resolved = resolvePlaybook(name, {
       projectRoot,
       globalPlaybooksDir: __playbookRuntimeOverrides.globalPlaybooksDir,
@@ -24356,8 +24378,8 @@ async function acquireDb() {
 async function buildDefaultDispatcher() {
   if (__playbookRuntimeOverrides.dispatcher) return __playbookRuntimeOverrides.dispatcher;
   const { orchestrateSpawnExecute: orchestrateSpawnExecute2 } = await Promise.resolve().then(() => (init_engine(), engine_exports));
-  const { getProjectRoot: getProjectRoot33 } = await import("@cleocode/core/internal");
-  const projectRoot = getProjectRoot33();
+  const { getProjectRoot: getProjectRoot34 } = await import("@cleocode/core/internal");
+  const projectRoot = getProjectRoot34();
   return {
     async dispatch(input) {
       try {
@@ -24547,8 +24569,8 @@ var init_playbook2 = __esm({
             projectRoot = __playbookRuntimeOverrides.projectRoot;
           } else {
             try {
-              const { getProjectRoot: getProjectRoot33 } = await import("@cleocode/core/internal");
-              projectRoot = getProjectRoot33();
+              const { getProjectRoot: getProjectRoot34 } = await import("@cleocode/core/internal");
+              projectRoot = getProjectRoot34();
             } catch {
               projectRoot = void 0;
             }
@@ -24612,14 +24634,14 @@ var init_playbook2 = __esm({
         const dispatcher = await buildDefaultDispatcher();
         let result;
         try {
-          const { getProjectRoot: getProjectRoot33 } = await import("@cleocode/core/internal");
+          const { getProjectRoot: getProjectRoot34 } = await import("@cleocode/core/internal");
           const opts = {
             db,
             playbook: parsed.definition,
             playbookHash: parsed.sourceHash,
             initialContext,
             dispatcher,
-            projectRoot: getProjectRoot33()
+            projectRoot: getProjectRoot34()
           };
           if (__playbookRuntimeOverrides.approvalSecret !== void 0) {
             opts.approvalSecret = __playbookRuntimeOverrides.approvalSecret;
@@ -29530,11 +29552,11 @@ var init_security = __esm({
 });
 
 // packages/cleo/src/dispatch/middleware/sanitizer.ts
-function createSanitizer(getProjectRoot33) {
+function createSanitizer(getProjectRoot34) {
   return async (req, next) => {
     if (req.params) {
       try {
-        const root = getProjectRoot33 ? getProjectRoot33() : void 0;
+        const root = getProjectRoot34 ? getProjectRoot34() : void 0;
         req.params = sanitizeParams(req.params, root, {
           domain: req.domain,
           operation: req.operation
@@ -34129,6 +34151,144 @@ var init_audit2 = __esm({
   }
 });
 
+// packages/cleo/src/cli/commands/backfill.ts
+var backfill_exports = {};
+__export(backfill_exports, {
+  backfillCommand: () => backfillCommand
+});
+import { backfillTasks, getProjectRoot as getProjectRoot20, populateEmbeddings } from "@cleocode/core/internal";
+var backfillCommand;
+var init_backfill = __esm({
+  "packages/cleo/src/cli/commands/backfill.ts"() {
+    "use strict";
+    init_dist();
+    init_renderers();
+    backfillCommand = defineCommand({
+      meta: {
+        name: "backfill",
+        description: "Retroactively add acceptance criteria and verification metadata to existing tasks"
+      },
+      args: {
+        "dry-run": {
+          type: "boolean",
+          description: "Show what would be changed without modifying any tasks",
+          default: false
+        },
+        rollback: {
+          type: "boolean",
+          description: "Revert a previous backfill (clear auto-generated AC and verification)",
+          default: false
+        },
+        tasks: {
+          type: "string",
+          description: "Comma-separated list of task IDs to restrict backfill to (e.g. T001,T002)"
+        },
+        embeddings: {
+          type: "boolean",
+          description: "Retroactively generate embeddings for brain observations that lack them",
+          default: false
+        }
+      },
+      async run({ args }) {
+        const root = getProjectRoot20();
+        if (args.embeddings) {
+          try {
+            let lastLine = "";
+            const result = await populateEmbeddings(root, {
+              onProgress: (current, total) => {
+                if (process.stdout.isTTY) {
+                  humanProgress(`\rEmbedding ${current}/${total}...`);
+                } else {
+                  const line = `Embedding ${current}/${total}...`;
+                  if (line !== lastLine) {
+                    humanLine(line);
+                    lastLine = line;
+                  }
+                }
+              }
+            });
+            if (process.stdout.isTTY && result.processed + result.skipped + result.errors > 0) {
+              humanProgress("\n");
+            }
+            if (result.processed === 0 && result.skipped === 0 && result.errors === 0) {
+              cliOutput(
+                {
+                  processed: 0,
+                  skipped: 0,
+                  errors: 0,
+                  message: "No observations to embed (provider unavailable or nothing to backfill)."
+                },
+                { command: "backfill", operation: "admin.backfill", message: "Nothing to embed" }
+              );
+              return;
+            }
+            cliOutput(
+              { processed: result.processed, skipped: result.skipped, errors: result.errors },
+              {
+                command: "backfill",
+                operation: "admin.backfill",
+                message: `Processed ${result.processed}, skipped ${result.skipped}, errors ${result.errors}`
+              }
+            );
+          } catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            cliError(
+              `Embedding backfill failed: ${message}`,
+              "E_INTERNAL",
+              {
+                name: "E_INTERNAL"
+              },
+              { operation: "admin.backfill" }
+            );
+            process.exit(1);
+          }
+          return;
+        }
+        const dryRun = !!args["dry-run"];
+        const rollback = !!args.rollback;
+        const taskIds = args.tasks?.trim() ? args.tasks.split(",").map((s) => s.trim()).filter(Boolean) : void 0;
+        if (!dryRun && !rollback && !process.env["CLEO_NONINTERACTIVE"]) {
+          humanWarn(
+            "Warning: Backfill will modify tasks in-place. Run with --dry-run first to preview changes.\n  Set CLEO_NONINTERACTIVE=1 or pass --dry-run to suppress this warning.\n"
+          );
+        }
+        try {
+          const result = await backfillTasks(root, { dryRun, rollback, taskIds });
+          const output = {
+            dryRun,
+            rollback,
+            tasksScanned: result.tasksScanned,
+            tasksChanged: result.tasksChanged,
+            changes: result.changes
+          };
+          if (!rollback) {
+            output["acAdded"] = result.acAdded;
+            output["verificationAdded"] = result.verificationAdded;
+          }
+          const messagePrefix = dryRun ? "[dry run] " : rollback ? "[rollback] " : "";
+          const messageSuffix = result.changes.length === 0 ? "Nothing to do \u2014 all tasks already have AC and verification metadata." : `Scanned ${result.tasksScanned}, changed ${result.tasksChanged} task(s).`;
+          cliOutput(output, {
+            command: "backfill",
+            operation: "admin.backfill",
+            message: `${messagePrefix}${messageSuffix}`
+          });
+        } catch (err) {
+          const message = err instanceof Error ? err.message : String(err);
+          cliError(
+            `Backfill failed: ${message}`,
+            "E_INTERNAL",
+            {
+              name: "E_INTERNAL"
+            },
+            { operation: "admin.backfill" }
+          );
+          process.exit(1);
+        }
+      }
+    });
+  }
+});
+
 // packages/cleo/src/cli/commands/backup-inspect.ts
 var backup_inspect_exports = {};
 __export(backup_inspect_exports, {
@@ -34547,9 +34707,9 @@ var init_backup = __esm({
       },
       async run({ args }) {
         const scope = args.scope;
-        const { packBundle, getProjectRoot: getProjectRoot33 } = await import("@cleocode/core/internal");
+        const { packBundle, getProjectRoot: getProjectRoot34 } = await import("@cleocode/core/internal");
         const includesProject = scope === "project" || scope === "all";
-        const projectRoot = includesProject ? getProjectRoot33() : void 0;
+        const projectRoot = includesProject ? getProjectRoot34() : void 0;
         let passphrase;
         if (args.encrypt === true) {
           passphrase = process.env["CLEO_BACKUP_PASSPHRASE"];
@@ -34850,7 +35010,7 @@ import {
   exportBrainAsJson,
   getMemoryQualityReport,
   getPlasticityStats,
-  getProjectRoot as getProjectRoot20,
+  getProjectRoot as getProjectRoot21,
   purgeBrainNoise,
   runBrainMaintenance
 } from "@cleocode/core/internal";
@@ -34889,7 +35049,7 @@ var init_brain2 = __esm({
         json: { type: "boolean", description: "Output results as JSON" }
       },
       async run({ args }) {
-        const root = getProjectRoot20();
+        const root = getProjectRoot21();
         try {
           const result = await runBrainMaintenance(root, {
             skipDecay: !!args["skip-decay"],
@@ -34960,7 +35120,7 @@ var init_brain2 = __esm({
         json: { type: "boolean", description: "Output results as JSON" }
       },
       async run({ args: _args }) {
-        const root = getProjectRoot20();
+        const root = getProjectRoot21();
         try {
           const result = await backfillBrainGraph(root);
           cliOutput(
@@ -35001,7 +35161,7 @@ var init_brain2 = __esm({
         json: { type: "boolean", description: "Output results as JSON" }
       },
       async run({ args: _args }) {
-        const root = getProjectRoot20();
+        const root = getProjectRoot21();
         try {
           const result = await purgeBrainNoise(root);
           cliOutput(
@@ -35047,7 +35207,7 @@ var init_brain2 = __esm({
         json: { type: "boolean", description: "Output results as JSON" }
       },
       async run({ args }) {
-        const root = getProjectRoot20();
+        const root = getProjectRoot21();
         const limit = Number.parseInt(args.limit, 10) || 20;
         try {
           const stats = await getPlasticityStats(root, limit);
@@ -35097,7 +35257,7 @@ var init_brain2 = __esm({
         json: { type: "boolean", description: "Output results as JSON" }
       },
       async run({ args: _args }) {
-        const root = getProjectRoot20();
+        const root = getProjectRoot21();
         try {
           const report = await getMemoryQualityReport(root);
           cliOutput(
@@ -35146,7 +35306,7 @@ var init_brain2 = __esm({
         }
       },
       async run({ args }) {
-        const root = getProjectRoot20();
+        const root = getProjectRoot21();
         const format = args.format ?? "gexf";
         if (format !== "gexf" && format !== "json") {
           cliError(`Invalid format: ${format}. Use 'gexf' or 'json'.`, "E_VALIDATION", {
@@ -39023,7 +39183,7 @@ import {
   exportDocument,
   formatError as formatError5,
   getAgentOutputsAbsolute,
-  getProjectRoot as getProjectRoot21,
+  getProjectRoot as getProjectRoot22,
   listDocVersions,
   mergeDocs,
   publishDocs,
@@ -39319,7 +39479,7 @@ var init_docs3 = __esm({
         const taskId = String(args.task);
         const includeAttachments = args["include-attachments"] !== false;
         const includeMemoryRefs = args["include-memory-refs"] === true;
-        const projectRoot = getProjectRoot21();
+        const projectRoot = getProjectRoot22();
         try {
           const result = await exportDocument({
             taskId,
@@ -39382,7 +39542,7 @@ var init_docs3 = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot21();
+        const projectRoot = getProjectRoot22();
         try {
           const result = await searchDocs2(String(args.query), {
             ownerId: args.owner ?? void 0,
@@ -39434,7 +39594,7 @@ var init_docs3 = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot21();
+        const projectRoot = getProjectRoot22();
         const rawStrategy = args.strategy ?? "three-way";
         const strategy = rawStrategy === "cherry-pick" || rawStrategy === "multi-diff" ? rawStrategy : "three-way";
         try {
@@ -39484,7 +39644,7 @@ var init_docs3 = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot21();
+        const projectRoot = getProjectRoot22();
         const fmt = args.format ?? "mermaid";
         try {
           const result = await buildDocsGraph({ ownerId: String(args.for), projectRoot });
@@ -39554,7 +39714,7 @@ var init_docs3 = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot21();
+        const projectRoot = getProjectRoot22();
         try {
           const result = await rankDocs({
             ownerId: String(args.for),
@@ -39593,7 +39753,7 @@ var init_docs3 = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot21();
+        const projectRoot = getProjectRoot22();
         try {
           const result = await listDocVersions({
             ownerId: String(args.for),
@@ -39637,7 +39797,7 @@ var init_docs3 = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot21();
+        const projectRoot = getProjectRoot22();
         try {
           const result = await publishDocs({
             ownerId: String(args.for),
@@ -40042,7 +40202,7 @@ __export(migrate_agents_v2_exports, {
 import { createHash as createHash2 } from "node:crypto";
 import { appendFileSync as appendFileSync2, existsSync as existsSync10, mkdirSync as mkdirSync3, readdirSync as readdirSync2, readFileSync as readFileSync11 } from "node:fs";
 import { join as join13 } from "node:path";
-import { getProjectRoot as getProjectRoot22, installAgentFromCant } from "@cleocode/core/internal";
+import { getProjectRoot as getProjectRoot23, installAgentFromCant } from "@cleocode/core/internal";
 import { openCleoDb } from "@cleocode/core/store/open-cleo-db";
 function sha256Hex(bytes) {
   return createHash2("sha256").update(bytes).digest("hex");
@@ -40229,7 +40389,7 @@ var init_migrate_agents_v2 = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot22();
+        const projectRoot = getProjectRoot23();
         const verbose = args.quiet !== true;
         if (verbose) {
           humanInfo("Scanning .cleo/cant/agents/ and .cleo/agents/ for unregistered agents...");
@@ -40273,7 +40433,7 @@ __export(doctor_exports, {
 });
 import { mkdirSync as mkdirSync4, writeFileSync as writeFileSync3 } from "node:fs";
 import { join as join14 } from "node:path";
-import { getProjectRoot as getProjectRoot23, quarantineRogueCleoDir, scanRogueCleoDirs } from "@cleocode/core/internal";
+import { getProjectRoot as getProjectRoot24, quarantineRogueCleoDir, scanRogueCleoDirs } from "@cleocode/core/internal";
 async function scanTestFixturesInProd(projectRoot) {
   const { getDb: getDb3, getNativeDb } = await import("@cleocode/core/internal");
   await getDb3(projectRoot);
@@ -40495,7 +40655,7 @@ var init_doctor = __esm({
         try {
           if (args.brain) {
             const { computeBrainHealthDashboard } = await import("@cleocode/core/internal");
-            const projectRoot = getProjectRoot23();
+            const projectRoot = getProjectRoot24();
             const dashboard = await computeBrainHealthDashboard(projectRoot);
             cliOutput(dashboard, { command: "doctor", operation: "doctor.brain" });
             if (dashboard.hasP0Failure) {
@@ -40504,7 +40664,7 @@ var init_doctor = __esm({
             return;
           }
           if (args["scan-test-fixtures-in-prod"]) {
-            const projectRoot = getProjectRoot23();
+            const projectRoot = getProjectRoot24();
             const matches = await scanTestFixturesInProd(projectRoot);
             const dryRun = args["dry-run"] !== false && args.quarantine !== true;
             const quarantined = !dryRun && matches.length > 0 ? await quarantineTestFixtures(projectRoot, matches) : void 0;
@@ -40592,7 +40752,7 @@ var init_doctor = __esm({
             progress.complete("Comprehensive diagnostics complete");
           } else if (args["scan-rogue-cleo-dirs"]) {
             progress.step(0, "Scanning for rogue .cleo/ directories");
-            const projectRoot = getProjectRoot23();
+            const projectRoot = getProjectRoot24();
             const reports = scanRogueCleoDirs(projectRoot);
             progress.complete(
               `Found ${reports.length} rogue .cleo/ director${reports.length === 1 ? "y" : "ies"}`
@@ -40601,7 +40761,7 @@ var init_doctor = __esm({
           } else if (args["quarantine-rogue-cleo-dirs"]) {
             const isDryRun = args["dry-run"] === true;
             progress.step(0, `${isDryRun ? "[DRY RUN] " : ""}Scanning for rogue .cleo/ directories`);
-            const projectRoot = getProjectRoot23();
+            const projectRoot = getProjectRoot24();
             const reports = scanRogueCleoDirs(projectRoot);
             if (reports.length === 0) {
               progress.complete("No rogue .cleo/ directories found \u2014 nothing to quarantine");
@@ -40655,7 +40815,7 @@ var init_doctor = __esm({
             const { detectAndRemoveLegacyGlobalFiles, detectAndRemoveStrayProjectNexus } = await import("@cleocode/core/internal");
             const { getCleoHome: getCleoHome3 } = await import("@cleocode/core/internal");
             const cleoHome = getCleoHome3();
-            const projectRoot = getProjectRoot23();
+            const projectRoot = getProjectRoot24();
             const legacyResult = detectAndRemoveLegacyGlobalFiles(cleoHome);
             const strayResult = detectAndRemoveStrayProjectNexus(projectRoot);
             const isDryRun = args["dry-run"] === true;
@@ -40704,7 +40864,7 @@ var init_doctor = __esm({
               { command: "doctor", operation: "admin.health" }
             );
             try {
-              const projectRoot = getProjectRoot23();
+              const projectRoot = getProjectRoot24();
               const conflicts = readMigrationConflicts(projectRoot);
               if (conflicts.length > 0) {
                 progress.complete(
@@ -41649,7 +41809,7 @@ __export(generate_changelog_exports, {
 import { execFileSync as execFileSync2 } from "node:child_process";
 import { existsSync as existsSync11, mkdirSync as mkdirSync5, readFileSync as readFileSync12, writeFileSync as writeFileSync4 } from "node:fs";
 import { dirname as dirname7, join as join17 } from "node:path";
-import { CleoError as CleoError4, formatError as formatError6, getConfigPath, getProjectRoot as getProjectRoot24 } from "@cleocode/core";
+import { CleoError as CleoError4, formatError as formatError6, getConfigPath, getProjectRoot as getProjectRoot25 } from "@cleocode/core";
 function getChangelogSource(cwd) {
   const configPath = getConfigPath(cwd);
   try {
@@ -41680,7 +41840,7 @@ function getDefaultOutputPath(platform) {
   }
 }
 function getGitHubRepoSlug(cwd) {
-  const projectRoot = getProjectRoot24(cwd);
+  const projectRoot = getProjectRoot25(cwd);
   try {
     const remoteUrl = execFileSync2("git", ["remote", "get-url", "origin"], {
       cwd: projectRoot,
@@ -41813,7 +41973,7 @@ var init_generate_changelog = __esm({
           const targetPlatform = args.platform;
           const dryRun = args["dry-run"] === true;
           const sourceFile = getChangelogSource();
-          const sourcePath = join17(getProjectRoot24(), sourceFile);
+          const sourcePath = join17(getProjectRoot25(), sourceFile);
           if (!existsSync11(sourcePath)) {
             throw new CleoError4(4 /* NOT_FOUND */, `Changelog source not found: ${sourcePath}`);
           }
@@ -41826,7 +41986,7 @@ var init_generate_changelog = __esm({
             const outputPath = platformConfig?.path ?? getDefaultOutputPath(targetPlatform);
             const content = generateForPlatform(targetPlatform, sourceContent, repoSlug, limit);
             if (!dryRun) {
-              const fullPath = join17(getProjectRoot24(), outputPath);
+              const fullPath = join17(getProjectRoot25(), outputPath);
               mkdirSync5(dirname7(fullPath), { recursive: true });
               writeFileSync4(fullPath, content, "utf-8");
             }
@@ -41847,7 +42007,7 @@ var init_generate_changelog = __esm({
                 limit
               );
               if (!dryRun) {
-                const fullPath = join17(getProjectRoot24(), platformConfig.path);
+                const fullPath = join17(getProjectRoot25(), platformConfig.path);
                 mkdirSync5(dirname7(fullPath), { recursive: true });
                 writeFileSync4(fullPath, content, "utf-8");
               }
@@ -43884,7 +44044,7 @@ var llm_cost_exports = {};
 __export(llm_cost_exports, {
   costCommand: () => costCommand
 });
-import { getProjectRoot as getProjectRoot25 } from "@cleocode/core/internal";
+import { getProjectRoot as getProjectRoot26 } from "@cleocode/core/internal";
 import { computeCost } from "@cleocode/core/llm/usage-pricing";
 function resolveSessionId(raw) {
   if (raw === "current") {
@@ -43957,7 +44117,7 @@ var init_llm_cost = __esm({
           process.exit(6);
         }
         const sessionId = resolveSessionId(rawSessionId);
-        const projectRoot = getProjectRoot25(process.cwd());
+        const projectRoot = getProjectRoot26(process.cwd());
         let breakdown;
         try {
           breakdown = await loadSessionCostBreakdown(projectRoot, sessionId);
@@ -43988,6 +44148,199 @@ var init_llm_cost = __esm({
   }
 });
 
+// packages/cleo/src/cli/commands/llm-stream.ts
+var llm_stream_exports = {};
+__export(llm_stream_exports, {
+  runLlmStream: () => runLlmStream,
+  streamCommand: () => streamCommand
+});
+async function buildSession(provider, model) {
+  const [
+    { resolveCredentials: resolveCredentials2 },
+    { ConcreteSession },
+    { AnthropicTransport },
+    { ChatCompletionsTransport },
+    { GeminiTransport }
+  ] = await Promise.all([
+    import(
+      /* webpackIgnore: true */
+      "@cleocode/core/llm/credentials.js"
+    ),
+    import(
+      /* webpackIgnore: true */
+      "@cleocode/core/llm/concrete-session.js"
+    ),
+    import(
+      /* webpackIgnore: true */
+      "@cleocode/core/llm/transports/anthropic.js"
+    ),
+    import(
+      /* webpackIgnore: true */
+      "@cleocode/core/llm/transports/chat-completions.js"
+    ),
+    import(
+      /* webpackIgnore: true */
+      "@cleocode/core/llm/transports/gemini.js"
+    )
+  ]);
+  const cred = resolveCredentials2(provider);
+  if (!cred.apiKey) {
+    throw new Error(
+      `No credential found for provider '${provider}'. Set the appropriate environment variable or run 'cleo llm add ${provider}'.`
+    );
+  }
+  let transport;
+  if (provider === "anthropic") {
+    transport = cred.authType === "oauth" ? new AnthropicTransport({ authToken: cred.apiKey }) : new AnthropicTransport({ apiKey: cred.apiKey });
+  } else if (provider === "gemini") {
+    transport = new GeminiTransport({ apiKey: cred.apiKey });
+  } else {
+    transport = new ChatCompletionsTransport({ provider, apiKey: cred.apiKey });
+  }
+  const resolvedCredential = {
+    provider,
+    label: "default",
+    token: cred.apiKey,
+    authType: cred.authType,
+    expiresAt: null,
+    refreshToken: null,
+    extraHeaders: {},
+    baseUrl: null,
+    awsProfile: null
+  };
+  return new ConcreteSession({ transport, model, credential: resolvedCredential });
+}
+async function getComputeCost() {
+  const { computeCost: computeCost2 } = await import(
+    /* webpackIgnore: true */
+    "@cleocode/core/llm/usage-pricing"
+  );
+  return computeCost2;
+}
+async function resolveDefaultModel(provider) {
+  const [{ getProviderProfile: getProviderProfile2 }, { IMPLICIT_FALLBACK_MODEL }] = await Promise.all([
+    import(
+      /* webpackIgnore: true */
+      "@cleocode/core/llm/provider-registry/index.js"
+    ),
+    import(
+      /* webpackIgnore: true */
+      "@cleocode/core/llm/role-resolver.js"
+    )
+  ]);
+  const profile = await getProviderProfile2(provider);
+  return profile?.defaultModel ?? IMPLICIT_FALLBACK_MODEL;
+}
+async function runLlmStream(opts) {
+  const stdout = opts.stdout ?? process.stdout;
+  const stderr2 = opts.stderr ?? process.stderr;
+  const session = opts._sessionOverride ?? await buildSession(opts.provider, opts.model ?? await resolveDefaultModel(opts.provider));
+  const sendOpts = {
+    ...opts.system != null ? { systemSuffix: opts.system } : {}
+  };
+  const messages = [{ role: "user", content: opts.prompt }];
+  let finalUsage = { inputTokens: 0, outputTokens: 0, costUsd: null };
+  const stream = session.stream(messages, sendOpts);
+  for await (const delta of stream) {
+    if (delta.text) {
+      stdout.write(delta.text);
+    }
+    if (delta.reasoning && opts.showThink) {
+      stderr2.write(delta.reasoning);
+    }
+    if (delta.usage !== null) {
+      const { inputTokens, outputTokens } = delta.usage;
+      let costUsd = null;
+      try {
+        const computeCost2 = await getComputeCost();
+        const raw = computeCost2({ inputTokens, outputTokens }, session.model);
+        costUsd = raw === 0 ? null : raw;
+      } catch {
+      }
+      finalUsage = { inputTokens, outputTokens, costUsd };
+    }
+  }
+  stderr2.write(`${JSON.stringify(finalUsage)}
+`);
+  return finalUsage;
+}
+var streamCommand;
+var init_llm_stream = __esm({
+  "packages/cleo/src/cli/commands/llm-stream.ts"() {
+    "use strict";
+    init_dist();
+    streamCommand = defineCommand({
+      meta: {
+        name: "stream",
+        description: "Stream a single-prompt completion via LlmTransport.stream(). Text deltas are written to stdout incrementally. Reasoning/think blocks go to stderr (requires --think). A JSON usage summary is printed to stderr at stream end."
+      },
+      args: {
+        provider: {
+          type: "positional",
+          description: "Provider transport (anthropic | openai | gemini | moonshot | openrouter | \u2026)",
+          required: true
+        },
+        prompt: {
+          type: "positional",
+          description: "Prompt text to send to the model.",
+          required: true
+        },
+        model: {
+          type: "string",
+          description: "Model identifier override (e.g. 'claude-sonnet-4-6'). Uses provider default when omitted."
+        },
+        "max-tokens": {
+          type: "string",
+          description: "Maximum output tokens (default: 4096)."
+        },
+        temperature: {
+          type: "string",
+          description: "Sampling temperature in 0.0\u20131.0 (default: 0.7)."
+        },
+        think: {
+          type: "boolean",
+          description: "Emit reasoning/think blocks to stderr (default: off).",
+          default: false
+        },
+        system: {
+          type: "string",
+          description: "Optional system prompt prepended to the conversation."
+        }
+      },
+      async run({ args }) {
+        const a = args;
+        const provider = String(a["provider"] ?? "").trim();
+        const prompt = String(a["prompt"] ?? "").trim();
+        if (!provider) {
+          process.stderr.write("[error] cleo llm stream: <provider> is required.\n");
+          process.exit(2);
+        }
+        if (!prompt) {
+          process.stderr.write("[error] cleo llm stream: <prompt> is required.\n");
+          process.exit(2);
+        }
+        const model = typeof a["model"] === "string" && a["model"] ? a["model"] : void 0;
+        const maxTokensRaw = typeof a["max-tokens"] === "string" ? Number(a["max-tokens"]) : void 0;
+        const maxTokens = maxTokensRaw !== void 0 && !Number.isNaN(maxTokensRaw) ? maxTokensRaw : void 0;
+        const tempRaw = typeof a["temperature"] === "string" ? parseFloat(a["temperature"]) : void 0;
+        const temperature = tempRaw !== void 0 && !Number.isNaN(tempRaw) ? tempRaw : void 0;
+        const showThink = a["think"] === true;
+        const system = typeof a["system"] === "string" && a["system"] ? a["system"] : void 0;
+        void maxTokens;
+        void temperature;
+        try {
+          await runLlmStream({ provider, prompt, model, maxTokens, temperature, showThink, system });
+        } catch (err) {
+          const msg = err instanceof Error ? err.message : String(err);
+          process.stderr.write(`[error] cleo llm stream: ${msg}
+`);
+          process.exit(1);
+        }
+      }
+    });
+  }
+});
+
 // packages/cleo/src/cli/commands/llm-login.ts
 import { spawn } from "node:child_process";
 import { createServer } from "node:http";
@@ -44334,6 +44687,57 @@ var init_llm_login = __esm({
   }
 });
 
+// packages/cleo/src/cli/commands/llm-refresh-catalog.ts
+import {
+  buildContextIndex,
+  fetchAndCacheCatalog,
+  findLatestCacheFile,
+  getCatalogDir,
+  readCacheFile
+} from "@cleocode/core/llm/catalog-cache";
+async function runLlmRefreshCatalog(dir) {
+  const cacheDir = dir ?? getCatalogDir();
+  try {
+    const { filePath, catalog: catalog2 } = await fetchAndCacheCatalog(cacheDir);
+    const index = buildContextIndex(catalog2);
+    const providerCount = Object.keys(catalog2).length;
+    const modelCount = Object.keys(index).length;
+    return {
+      success: true,
+      data: { providers: providerCount, models: modelCount, filePath, source: "live" }
+    };
+  } catch {
+  }
+  const latestPath = findLatestCacheFile(cacheDir);
+  if (latestPath) {
+    const catalog2 = readCacheFile(latestPath);
+    if (catalog2) {
+      const index = buildContextIndex(catalog2);
+      return {
+        success: true,
+        data: {
+          providers: Object.keys(catalog2).length,
+          models: Object.keys(index).length,
+          filePath: latestPath,
+          source: "stale-cache"
+        }
+      };
+    }
+  }
+  return {
+    success: false,
+    error: {
+      message: "Failed to fetch model catalog and no cached snapshot found.",
+      code: "E_CATALOG_UNAVAILABLE"
+    }
+  };
+}
+var init_llm_refresh_catalog = __esm({
+  "packages/cleo/src/cli/commands/llm-refresh-catalog.ts"() {
+    "use strict";
+  }
+});
+
 // packages/cleo/src/cli/commands/llm.ts
 var llm_exports = {};
 __export(llm_exports, {
@@ -44372,7 +44776,7 @@ function makeLlmSubcommand(opts) {
     }
   });
 }
-var API_KEY_FLAG_DEPRECATION, addCommand5, listCommand10, removeCommand3, useCommand, profileCommand, testCommand, whoamiCommand, listProvidersCommand, loginCommand, llmCommand;
+var API_KEY_FLAG_DEPRECATION, addCommand5, listCommand10, removeCommand3, useCommand, profileCommand, testCommand, whoamiCommand, listProvidersCommand, contextEnginesListCommand, contextEnginesCommand, loginCommand, refreshCatalogCommand, llmCommand;
 var init_llm3 = __esm({
   "packages/cleo/src/cli/commands/llm.ts"() {
     "use strict";
@@ -44381,6 +44785,8 @@ var init_llm3 = __esm({
     init_renderers();
     init_llm_cost();
     init_llm_login();
+    init_llm_refresh_catalog();
+    init_llm_stream();
     API_KEY_FLAG_DEPRECATION = "[warning] --api-key exposes the secret to 'ps' listings and shell history. Prefer --api-key-stdin or --api-key-env=NAME for production use.";
     addCommand5 = defineCommand({
       meta: {
@@ -44651,6 +45057,46 @@ var init_llm3 = __esm({
         );
       }
     });
+    contextEnginesListCommand = defineCommand({
+      meta: {
+        name: "list",
+        description: "List all registered ContextEngine names (builtins + user plugins)."
+      },
+      args: {
+        json: {
+          type: "boolean",
+          description: "Output as JSON"
+        }
+      },
+      async run() {
+        const { listContextEngines } = await import(
+          /* webpackIgnore: true */
+          "@cleocode/core/llm/executor-factory"
+        );
+        const engines = listContextEngines();
+        cliOutput(
+          { engines: [...engines] },
+          {
+            command: "llm-context-engines-list",
+            operation: "llm.contextEngines.list"
+          }
+        );
+      }
+    });
+    contextEnginesCommand = defineCommand({
+      meta: {
+        name: "context-engines",
+        description: "Manage registered ContextEngine plugins."
+      },
+      subCommands: {
+        list: contextEnginesListCommand
+      },
+      async run({ cmd, rawArgs }) {
+        const firstArg = rawArgs?.find((a) => !a.startsWith("-"));
+        if (firstArg && cmd.subCommands && firstArg in cmd.subCommands) return;
+        await showUsage(cmd);
+      }
+    });
     loginCommand = defineCommand({
       meta: {
         name: "login",
@@ -44686,6 +45132,36 @@ var init_llm3 = __esm({
           );
         } else if (result.error) {
           process.stderr.write(`[error] ${result.error.message}
+`);
+          process.exit(1);
+        }
+      }
+    });
+    refreshCatalogCommand = defineCommand({
+      meta: {
+        name: "refresh-catalog",
+        description: "Fetch the live model catalog from models.dev and persist it to disk. Falls back to the most-recent cached snapshot on network failure."
+      },
+      args: {
+        json: {
+          type: "boolean",
+          description: "Output result as JSON"
+        }
+      },
+      async run({ args }) {
+        const jsonOutput = args["json"] === true;
+        const result = await runLlmRefreshCatalog();
+        if (jsonOutput) {
+          process.stdout.write(`${JSON.stringify(result, null, 2)}
+`);
+        } else if (result.success && result.data) {
+          const d = result.data;
+          process.stdout.write(
+            `Catalog refreshed: ${d.providers} providers, ${d.models} models written to ${d.filePath}
+`
+          );
+        } else if (!result.success) {
+          process.stderr.write(`[error] ${result.error?.message ?? "refresh failed"}
 `);
           process.exit(1);
         }
@@ -44698,12 +45174,15 @@ var init_llm3 = __esm({
       },
       subCommands: {
         add: addCommand5,
+        "context-engines": contextEnginesCommand,
         cost: costCommand,
         list: listCommand10,
         login: loginCommand,
         remove: removeCommand3,
+        stream: streamCommand,
         use: useCommand,
         profile: profileCommand,
+        "refresh-catalog": refreshCatalogCommand,
         test: testCommand,
         whoami: whoamiCommand,
         "list-providers": listProvidersCommand
@@ -45149,7 +45628,7 @@ import {
   getBrainDb as getBrainDb2,
   getBrainNativeDb as getBrainNativeDb3,
   getDreamStatus,
-  getProjectRoot as getProjectRoot26,
+  getProjectRoot as getProjectRoot27,
   runConsolidation,
   triggerManualDream
 } from "@cleocode/core/internal";
@@ -45215,7 +45694,7 @@ function makeMemorySubcommand(opts) {
     }
   });
 }
-var storeCommand, findCommand5, statsCommand4, observeCommand, timelineCommand, fetchCommand2, decisionFindCommand, decisionStoreCommand, linkCommand, traceCommand, relatedCommand, contextCommand3, graphStatsCommand, graphShowCommand, graphNeighborsCommand, graphAddCommand, graphRemoveCommand, reasonWhyCommand, reasonSimilarCommand, searchHybridCommand, codeLinksCommand, codeAutoLinkCommand, codeMemoriesForCodeCommand, codeForMemoryCommand, consolidateCommand, dreamCommand, reflectCommand, dedupScanCommand, importCommand3, doctorCommand3, llmStatusCommand, verifyCommand, pendingVerifyCommand, tierStatsCommand, tierPromoteCommand, tierDemoteCommand, precompactFlushCommand, backfillRunCommand, backfillApproveCommand, backfillRollbackCommand, backfillCommand, digestCommand, recentCommand, diaryReadCommand, diaryWriteCommand, diaryCommand, watchCommand2, tierCommand, sweepCommand, memoryCommand;
+var storeCommand, findCommand5, statsCommand4, observeCommand, timelineCommand, fetchCommand2, decisionFindCommand, decisionStoreCommand, linkCommand, traceCommand, relatedCommand, contextCommand3, graphStatsCommand, graphShowCommand, graphNeighborsCommand, graphAddCommand, graphRemoveCommand, reasonWhyCommand, reasonSimilarCommand, searchHybridCommand, codeLinksCommand, codeAutoLinkCommand, codeMemoriesForCodeCommand, codeForMemoryCommand, consolidateCommand, dreamCommand, reflectCommand, dedupScanCommand, importCommand3, doctorCommand3, llmStatusCommand, verifyCommand, pendingVerifyCommand, tierStatsCommand, tierPromoteCommand, tierDemoteCommand, precompactFlushCommand, backfillRunCommand, backfillApproveCommand, backfillRollbackCommand, backfillCommand2, digestCommand, recentCommand, diaryReadCommand, diaryWriteCommand, diaryCommand, watchCommand2, tierCommand, sweepCommand, memoryCommand;
 var init_memory3 = __esm({
   "packages/cleo/src/cli/commands/memory.ts"() {
     "use strict";
@@ -46110,7 +46589,7 @@ var init_memory3 = __esm({
       },
       args: {},
       async run() {
-        const root = getProjectRoot26();
+        const root = getProjectRoot27();
         try {
           const result = await runConsolidation(root);
           cliOutput(result, { command: "memory-consolidate", operation: "memory.consolidate" });
@@ -46134,7 +46613,7 @@ var init_memory3 = __esm({
         }
       },
       async run({ args }) {
-        const root = getProjectRoot26();
+        const root = getProjectRoot27();
         if (args.status) {
           try {
             const status = await getDreamStatus(root);
@@ -46171,7 +46650,7 @@ var init_memory3 = __esm({
         }
       },
       async run({ args }) {
-        const root = getProjectRoot26();
+        const root = getProjectRoot27();
         try {
           const { runObserver, runReflector } = await import("@cleocode/core/internal");
           const observerResult = await runObserver(root, args.session, {
@@ -46211,7 +46690,7 @@ var init_memory3 = __esm({
         }
       },
       async run({ args }) {
-        const root = getProjectRoot26();
+        const root = getProjectRoot27();
         try {
           const { getBrainDb: getBrainDbInner, getBrainNativeDb: getBrainNativeDbInner } = await import("@cleocode/core/internal");
           await getBrainDbInner(root);
@@ -46309,7 +46788,7 @@ var init_memory3 = __esm({
       async run({ args }) {
         const sourceDir = args.from ?? join19(homedir6(), ".claude", "projects", "-mnt-projects-cleocode", "memory");
         const isDryRun = !!args["dry-run"];
-        const projectRoot = getProjectRoot26();
+        const projectRoot = getProjectRoot27();
         const stateFile = join19(projectRoot, CLEO_DIR_NAME, MIGRATE_MEMORY_HASHES_JSON);
         if (!existsSync13(sourceDir)) {
           cliError(`Source directory not found: ${sourceDir}`, "E_NOT_FOUND", { name: "E_NOT_FOUND" });
@@ -46522,7 +47001,7 @@ var init_memory3 = __esm({
       },
       args: {},
       async run() {
-        const root = getProjectRoot26();
+        const root = getProjectRoot27();
         try {
           await getBrainDb2(root);
           const nativeDb = getBrainNativeDb3();
@@ -46621,7 +47100,7 @@ var init_memory3 = __esm({
         }
       },
       async run({ args }) {
-        const root = getProjectRoot26();
+        const root = getProjectRoot27();
         const targetTier = args.to;
         const reason = args.reason;
         const validTiers = ["medium", "long"];
@@ -46725,7 +47204,7 @@ var init_memory3 = __esm({
         }
       },
       async run({ args }) {
-        const root = getProjectRoot26();
+        const root = getProjectRoot27();
         const targetTier = args.to;
         const reason = args.reason;
         const validTiers = ["short", "medium"];
@@ -46884,7 +47363,7 @@ var init_memory3 = __esm({
         runId: args["runId"]
       })
     });
-    backfillCommand = defineCommand({
+    backfillCommand2 = defineCommand({
       meta: {
         name: "backfill",
         description: "Staged brain-graph backfill operations: run, approve, rollback (T1003)."
@@ -47217,7 +47696,7 @@ data: ${JSON.stringify({ ts: (/* @__PURE__ */ new Date()).toISOString() })}
         tier: tierCommand,
         // T1013 — new memory subcommands
         "precompact-flush": precompactFlushCommand,
-        backfill: backfillCommand,
+        backfill: backfillCommand2,
         digest: digestCommand,
         recent: recentCommand,
         diary: diaryCommand,
@@ -47239,7 +47718,7 @@ var migrate_claude_mem_exports = {};
 __export(migrate_claude_mem_exports, {
   migrateClaudeMemCommand: () => migrateClaudeMemCommand
 });
-import { getProjectRoot as getProjectRoot27, migrateClaudeMem } from "@cleocode/core/internal";
+import { getProjectRoot as getProjectRoot28, migrateClaudeMem } from "@cleocode/core/internal";
 import { ingestLooseAgentOutputs, ingestRcasdDirectories } from "@cleocode/core/memory";
 import { getDb as getDb2 } from "@cleocode/core/store/sqlite";
 var storageCommand, claudeMemCommand, manifestIngestCommand, migrateClaudeMemCommand;
@@ -47302,7 +47781,7 @@ var init_migrate_claude_mem = __esm({
         }
       },
       async run({ args }) {
-        const root = getProjectRoot27();
+        const root = getProjectRoot28();
         try {
           const result = await migrateClaudeMem(root, {
             sourcePath: args.source,
@@ -47351,7 +47830,7 @@ var init_migrate_claude_mem = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot27();
+        const projectRoot = getProjectRoot28();
         try {
           const db = await getDb2(projectRoot);
           const rcasdFlag = Boolean(args.rcasd);
@@ -48296,7 +48775,7 @@ var init_nexus4 = __esm({
         const repoPath = args.path ? path4.resolve(args.path) : process.cwd();
         humanInfo(`[nexus] Analyzing: ${repoPath}${isIncremental ? " (incremental)" : ""}`);
         try {
-          const [{ getNexusDb, nexusSchema }, { runPipeline }, { getProjectRoot: getProjectRoot33 }, { eq: eq2 }] = await Promise.all([
+          const [{ getNexusDb, nexusSchema }, { runPipeline }, { getProjectRoot: getProjectRoot34 }, { eq: eq2 }] = await Promise.all([
             import("@cleocode/core/store/nexus-sqlite"),
             import("@cleocode/nexus/pipeline"),
             import("@cleocode/core/internal"),
@@ -48376,7 +48855,7 @@ var init_nexus4 = __esm({
               extensions: { duration_ms: durationMs }
             }
           );
-          void getProjectRoot33;
+          void getProjectRoot34;
         } catch (err) {
           const msg = err instanceof Error ? err.message : String(err);
           cliError(
@@ -51978,7 +52457,7 @@ var refresh_memory_exports = {};
 __export(refresh_memory_exports, {
   refreshMemoryCommand: () => refreshMemoryCommand
 });
-import { getProjectRoot as getProjectRoot28 } from "@cleocode/core";
+import { getProjectRoot as getProjectRoot29 } from "@cleocode/core";
 var refreshMemoryCommand;
 var init_refresh_memory = __esm({
   "packages/cleo/src/cli/commands/refresh-memory.ts"() {
@@ -51991,7 +52470,7 @@ var init_refresh_memory = __esm({
         description: "Regenerate .cleo/memory-bridge.md from brain.db"
       },
       async run() {
-        const projectDir = getProjectRoot28();
+        const projectDir = getProjectRoot29();
         const { writeMemoryBridge } = await import("@cleocode/core/internal");
         const result = await writeMemoryBridge(projectDir);
         if (result.written) {
@@ -53301,7 +53780,7 @@ __export(restore_exports, {
 import fs3 from "node:fs";
 import path5 from "node:path";
 import { CleoError as CleoError8, getTaskAccessor as getTaskAccessor3 } from "@cleocode/core";
-import { getProjectRoot as getProjectRoot29 } from "@cleocode/core/internal";
+import { getProjectRoot as getProjectRoot30 } from "@cleocode/core/internal";
 function parseMarkdownValue(raw) {
   const trimmed = raw.trim();
   if (trimmed === "_(not present)_" || trimmed === "") return void 0;
@@ -53421,7 +53900,7 @@ var init_restore = __esm({
         description: "Apply manually-resolved conflicts from .cleo/restore-conflicts.md"
       },
       async run() {
-        const projectRoot = getProjectRoot29();
+        const projectRoot = getProjectRoot30();
         const reportPath = path5.join(projectRoot, CLEO_DIR_NAME, RESTORE_CONFLICTS_MD);
         if (!fs3.existsSync(reportPath)) {
           humanLine("No pending restore conflicts. Nothing to finalize.");
@@ -55396,7 +55875,7 @@ var sequence_exports = {};
 __export(sequence_exports, {
   sequenceCommand: () => sequenceCommand
 });
-import { getProjectRoot as getProjectRoot30 } from "@cleocode/core/internal";
+import { getProjectRoot as getProjectRoot31 } from "@cleocode/core/internal";
 var showCommand12, checkCommand6, repairCommand, sequenceCommand;
 var init_sequence = __esm({
   "packages/cleo/src/cli/commands/sequence.ts"() {
@@ -55432,7 +55911,7 @@ var init_sequence = __esm({
       meta: { name: "repair", description: "Reset counter to max + 1 if behind" },
       async run() {
         const { repairSequence } = await import("@cleocode/core/internal");
-        const projectRoot = getProjectRoot30();
+        const projectRoot = getProjectRoot31();
         const repair = await repairSequence(projectRoot);
         const result = {
           repaired: repair.repaired,
@@ -55875,8 +56354,8 @@ var init_session4 = __esm({
         "audit-scope": { type: "string", description: "Audit log scope (global|local)" }
       },
       async run({ args }) {
-        const { detectSessionDrift, getProjectRoot: getProjectRoot33 } = await import("@cleocode/core");
-        const projectRoot = await getProjectRoot33();
+        const { detectSessionDrift, getProjectRoot: getProjectRoot34 } = await import("@cleocode/core");
+        const projectRoot = await getProjectRoot34();
         const scope = args["audit-scope"] === "local" ? "local" : "global";
         const report = await detectSessionDrift({ projectRoot, auditScope: scope });
         cliOutput(report, { command: "session drift", operation: "session.drift" });
@@ -57384,7 +57863,7 @@ __export(token_exports, {
   tokenCommand: () => tokenCommand
 });
 import { readFileSync as readFileSync15 } from "node:fs";
-import { getProjectRoot as getProjectRoot31, measureTokenExchange, recordTokenExchange as recordTokenExchange2 } from "@cleocode/core/internal";
+import { getProjectRoot as getProjectRoot32, measureTokenExchange, recordTokenExchange as recordTokenExchange2 } from "@cleocode/core/internal";
 function readPayload(args, textKey, fileKey) {
   const text = args[textKey];
   const file = args[fileKey];
@@ -57548,7 +58027,7 @@ var init_token = __esm({
           domain: args.domain,
           operation: args.operation
         };
-        const result = args.record ? await recordTokenExchange2(getProjectRoot31(), input) : await measureTokenExchange(input);
+        const result = args.record ? await recordTokenExchange2(getProjectRoot32(), input) : await measureTokenExchange(input);
         cliOutput(result, {
           command: "token",
           operation: args.record ? "admin.token.record" : "token.estimate"
@@ -57584,7 +58063,7 @@ __export(transcript_exports, {
 });
 import { homedir as homedir8 } from "node:os";
 import { join as join23 } from "node:path";
-import { getProjectRoot as getProjectRoot32 } from "@cleocode/core";
+import { getProjectRoot as getProjectRoot33 } from "@cleocode/core";
 import {
   parseDurationMs,
   pruneTranscripts,
@@ -57614,7 +58093,7 @@ var init_transcript = __esm({
       async run({ args }) {
         if (args.pending) {
           try {
-            const projectRoot = getProjectRoot32();
+            const projectRoot = getProjectRoot33();
             const { scanPendingTranscripts } = await import("@cleocode/core/memory/transcript-scanner.js");
             const pending = await scanPendingTranscripts(projectRoot);
             cliOutput(
@@ -57711,7 +58190,7 @@ var init_transcript = __esm({
       async run({ args }) {
         const tier = args.tier ?? "warm";
         const dryRun = args["dry-run"] ?? false;
-        const projectRoot = getProjectRoot32();
+        const projectRoot = getProjectRoot33();
         try {
           const { extractTranscript } = await import("@cleocode/core/memory/transcript-extractor.js");
           const { findSessionTranscriptPath, listAllTranscripts } = await import("@cleocode/core/memory/transcript-scanner.js");
@@ -57823,7 +58302,7 @@ var init_transcript = __esm({
         const dryRun = args["dry-run"] ?? false;
         const olderThanHours = args["older-than-hours"] ? Number.parseInt(args["older-than-hours"], 10) : 24;
         const limit = args.limit ? Number.parseInt(args.limit, 10) : void 0;
-        const projectRoot = getProjectRoot32();
+        const projectRoot = getProjectRoot33();
         try {
           const { extractTranscript } = await import("@cleocode/core/memory/transcript-extractor.js");
           const { listAllTranscripts } = await import("@cleocode/core/memory/transcript-scanner.js");
@@ -58935,6 +59414,12 @@ var COMMAND_MANIFEST = [
     description: "Git-backed audit tooling (lineage reconstruction, integrity checks). ",
     load: async () => (await Promise.resolve().then(() => (init_audit2(), audit_exports))).auditCommand
   },
+  {
+    exportName: "backfillCommand",
+    name: "backfill",
+    description: "Retroactively add acceptance criteria and verification metadata to existing tasks",
+    load: async () => (await Promise.resolve().then(() => (init_backfill(), backfill_exports))).backfillCommand
+  },
   {
     exportName: "backupInspectSubCommand",
     name: "inspect",
@@ -59283,6 +59768,12 @@ var COMMAND_MANIFEST = [
     description: "Compute cumulative USD cost for an LLM session from recorded token_usage entries. ",
     load: async () => (await Promise.resolve().then(() => (init_llm_cost(), llm_cost_exports))).costCommand
   },
+  {
+    exportName: "streamCommand",
+    name: "stream",
+    description: "Stream a single-prompt completion via LlmTransport.stream(). ",
+    load: async () => (await Promise.resolve().then(() => (init_llm_stream(), llm_stream_exports))).streamCommand
+  },
   {
     exportName: "llmCommand",
     name: "llm",
@@ -60050,7 +60541,7 @@ async function runStartupMaintenance() {
     detectAndRemoveStrayProjectNexus,
     getGlobalSalt,
     getLogger: getLogger17,
-    getProjectRoot: getProjectRoot33,
+    getProjectRoot: getProjectRoot34,
     isCleanupMarkerSet,
     migrateSignaldockToConduit,
     needsSignaldockToConduitMigration,
@@ -60059,7 +60550,7 @@ async function runStartupMaintenance() {
   } = await import("@cleocode/core/internal");
   let projectRootForCleanup = "";
   try {
-    projectRootForCleanup = getProjectRoot33();
+    projectRootForCleanup = getProjectRoot34();
   } catch {
   }
   if (!isCleanupMarkerSet(CLI_VERSION, projectRootForCleanup)) {
@@ -60079,7 +60570,7 @@ async function runStartupMaintenance() {
   const isInitInvocation = process.argv.slice(2).some((a) => a === "init");
   if (!isInitInvocation) {
     try {
-      const _projectRootForMigration = getProjectRoot33();
+      const _projectRootForMigration = getProjectRoot34();
       if (needsSignaldockToConduitMigration(_projectRootForMigration)) {
         const migrationResult = migrateSignaldockToConduit(_projectRootForMigration);
         if (migrationResult.status === "failed") {