@cleocode/cleo 2026.10.12 → 2026.10.13-rc.ci.682

package/dist/cli/{context-NPOCCDYU.js → context-ULY3365D.js}

@@ -17,7 +17,7 @@ import {
   dispatchFromCli,
   dispatchRaw,
   handleRawError
-} from "./chunk-RIJNJKQJ.js";
+} from "./chunk-J3NQONHJ.js";
 import "./chunk-6N6WGLXE.js";
 import "./chunk-4VASFLUW.js";
 import {
@@ -29,7 +29,7 @@ import {
 } from "./chunk-4RGSNUUP.js";
 import "./chunk-6JSJNYH2.js";
 import "./chunk-D7BAQNV2.js";
-import "./chunk-J76TS67V.js";
+import "./chunk-WTP5FO4A.js";
 
 // packages/cleo/src/cli/commands/context.ts
 import { ExitCode } from "@cleocode/contracts/exit-codes.js";
@@ -139,4 +139,4 @@ var contextCommand = defineCommand({
 export {
   contextCommand
 };
-//# sourceMappingURL=context-NPOCCDYU.js.map
+//# sourceMappingURL=context-ULY3365D.js.map

package/dist/cli/{contribution-OFEBQYQS.js → contribution-G4WD5HD7.js}

@@ -15,7 +15,7 @@
 })();
 import {
   dispatchFromCli
-} from "./chunk-RIJNJKQJ.js";
+} from "./chunk-J3NQONHJ.js";
 import "./chunk-6N6WGLXE.js";
 import "./chunk-4VASFLUW.js";
 import {
@@ -26,7 +26,7 @@ import "./chunk-QKMBWYAS.js";
 import "./chunk-4RGSNUUP.js";
 import "./chunk-6JSJNYH2.js";
 import "./chunk-D7BAQNV2.js";
-import "./chunk-J76TS67V.js";
+import "./chunk-WTP5FO4A.js";
 
 // packages/cleo/src/cli/commands/contribution.ts
 var validateCommand = defineCommand({
@@ -109,4 +109,4 @@ var contributionCommand = defineCommand({
 export {
   contributionCommand
 };
-//# sourceMappingURL=contribution-OFEBQYQS.js.map
+//# sourceMappingURL=contribution-G4WD5HD7.js.map

package/dist/cli/{current-NL7OMKXP.js → current-64QYQURQ.js}

@@ -15,7 +15,7 @@
 })();
 import {
   dispatchFromCli
-} from "./chunk-RIJNJKQJ.js";
+} from "./chunk-J3NQONHJ.js";
 import "./chunk-6N6WGLXE.js";
 import "./chunk-4VASFLUW.js";
 import {
@@ -25,7 +25,7 @@ import "./chunk-QKMBWYAS.js";
 import "./chunk-4RGSNUUP.js";
 import "./chunk-6JSJNYH2.js";
 import "./chunk-D7BAQNV2.js";
-import "./chunk-J76TS67V.js";
+import "./chunk-WTP5FO4A.js";
 
 // packages/cleo/src/cli/commands/current.ts
 var currentCommand = defineCommand({
@@ -40,4 +40,4 @@ var currentCommand = defineCommand({
 export {
   currentCommand
 };
-//# sourceMappingURL=current-NL7OMKXP.js.map
+//# sourceMappingURL=current-64QYQURQ.js.map

package/dist/cli/{daemon-ZZTC475S.js → daemon-L4M6DMXL.js}

@@ -21,7 +21,7 @@ import {
 } from "./chunk-YY66LFZF.js";
 import {
   createCliGatewayHandler
-} from "./chunk-RIJNJKQJ.js";
+} from "./chunk-J3NQONHJ.js";
 import "./chunk-6N6WGLXE.js";
 import "./chunk-4VASFLUW.js";
 import {
@@ -34,7 +34,7 @@ import {
 } from "./chunk-4RGSNUUP.js";
 import "./chunk-6JSJNYH2.js";
 import "./chunk-D7BAQNV2.js";
-import "./chunk-J76TS67V.js";
+import "./chunk-WTP5FO4A.js";
 
 // packages/cleo/src/cli/commands/daemon.ts
 import { existsSync } from "node:fs";
@@ -449,4 +449,4 @@ var daemonCommand = defineCommand({
 export {
   daemonCommand
 };
-//# sourceMappingURL=daemon-ZZTC475S.js.map
+//# sourceMappingURL=daemon-L4M6DMXL.js.map

package/dist/cli/{dash-RTFOE2GL.js → dash-SAPS4TMX.js}

@@ -18,7 +18,7 @@ import {
 } from "./chunk-47JYZAMS.js";
 import {
   dispatchFromCli
-} from "./chunk-RIJNJKQJ.js";
+} from "./chunk-J3NQONHJ.js";
 import "./chunk-6N6WGLXE.js";
 import "./chunk-4VASFLUW.js";
 import {
@@ -30,7 +30,7 @@ import {
 } from "./chunk-4RGSNUUP.js";
 import "./chunk-6JSJNYH2.js";
 import "./chunk-D7BAQNV2.js";
-import "./chunk-J76TS67V.js";
+import "./chunk-WTP5FO4A.js";
 
 // packages/cleo/src/cli/commands/dash.ts
 var dashCommand = defineCommand({
@@ -68,4 +68,4 @@ var dashCommand = defineCommand({
 export {
   dashCommand
 };
-//# sourceMappingURL=dash-RTFOE2GL.js.map
+//# sourceMappingURL=dash-SAPS4TMX.js.map

package/dist/cli/{decompose-CHNHPEVP.js → decompose-QOB4WQEM.js}

@@ -17,7 +17,7 @@ import "./chunk-C3B7C43W.js";
 import {
   dispatchRaw,
   handleRawError
-} from "./chunk-RIJNJKQJ.js";
+} from "./chunk-J3NQONHJ.js";
 import "./chunk-6N6WGLXE.js";
 import "./chunk-4VASFLUW.js";
 import {
@@ -29,7 +29,7 @@ import {
 } from "./chunk-4RGSNUUP.js";
 import "./chunk-6JSJNYH2.js";
 import "./chunk-D7BAQNV2.js";
-import "./chunk-J76TS67V.js";
+import "./chunk-WTP5FO4A.js";
 
 // packages/cleo/src/cli/commands/decompose.ts
 var decomposeCommand = defineCommand({
@@ -75,4 +75,4 @@ var decomposeCommand = defineCommand({
 export {
   decomposeCommand
 };
-//# sourceMappingURL=decompose-CHNHPEVP.js.map
+//# sourceMappingURL=decompose-QOB4WQEM.js.map

package/dist/cli/{decomposition-ZR2PXXZF.js → decomposition-2F4E7PWO.js}

@@ -15,7 +15,7 @@
 })();
 import {
   dispatchFromCli
-} from "./chunk-RIJNJKQJ.js";
+} from "./chunk-J3NQONHJ.js";
 import "./chunk-6N6WGLXE.js";
 import "./chunk-4VASFLUW.js";
 import {
@@ -26,7 +26,7 @@ import "./chunk-QKMBWYAS.js";
 import "./chunk-4RGSNUUP.js";
 import "./chunk-6JSJNYH2.js";
 import "./chunk-D7BAQNV2.js";
-import "./chunk-J76TS67V.js";
+import "./chunk-WTP5FO4A.js";
 
 // packages/cleo/src/cli/commands/decomposition.ts
 var validateCommand = defineCommand({
@@ -119,4 +119,4 @@ var decompositionCommand = defineCommand({
 export {
   decompositionCommand
 };
-//# sourceMappingURL=decomposition-ZR2PXXZF.js.map
+//# sourceMappingURL=decomposition-2F4E7PWO.js.map

package/dist/cli/{delete-ZPWWK3BT.js → delete-DBB3YVOZ.js}

@@ -16,7 +16,7 @@
 import {
   dispatchRaw,
   handleRawError
-} from "./chunk-RIJNJKQJ.js";
+} from "./chunk-J3NQONHJ.js";
 import "./chunk-6N6WGLXE.js";
 import "./chunk-4VASFLUW.js";
 import {
@@ -28,7 +28,7 @@ import {
 } from "./chunk-4RGSNUUP.js";
 import "./chunk-6JSJNYH2.js";
 import "./chunk-D7BAQNV2.js";
-import "./chunk-J76TS67V.js";
+import "./chunk-WTP5FO4A.js";
 
 // packages/cleo/src/cli/commands/delete.ts
 var deleteCommand = defineCommand({
@@ -66,4 +66,4 @@ var deleteCommand = defineCommand({
 export {
   deleteCommand
 };
-//# sourceMappingURL=delete-ZPWWK3BT.js.map
+//# sourceMappingURL=delete-DBB3YVOZ.js.map

package/dist/cli/{deps-2AC2UHTE.js → deps-ZVGLNONP.js}

@@ -23,7 +23,7 @@ import {
   renderLegend,
   renderSummary,
   renderTree
-} from "./chunk-RIJNJKQJ.js";
+} from "./chunk-J3NQONHJ.js";
 import "./chunk-6N6WGLXE.js";
 import "./chunk-4VASFLUW.js";
 import {
@@ -41,7 +41,7 @@ import {
   isQuiet
 } from "./chunk-6JSJNYH2.js";
 import "./chunk-D7BAQNV2.js";
-import "./chunk-J76TS67V.js";
+import "./chunk-WTP5FO4A.js";
 
 // packages/cleo/src/cli/commands/deps.ts
 import { ExitCode } from "@cleocode/contracts/exit-codes.js";
@@ -459,4 +459,4 @@ export {
   depsCommand,
   treeCommand
 };
-//# sourceMappingURL=deps-2AC2UHTE.js.map
+//# sourceMappingURL=deps-ZVGLNONP.js.map

package/dist/cli/{detect-JAYIERC6.js → detect-VCH63Q3U.js}

@@ -15,7 +15,7 @@
 })();
 import {
   dispatchFromCli
-} from "./chunk-RIJNJKQJ.js";
+} from "./chunk-J3NQONHJ.js";
 import "./chunk-6N6WGLXE.js";
 import "./chunk-4VASFLUW.js";
 import {
@@ -25,7 +25,7 @@ import "./chunk-QKMBWYAS.js";
 import "./chunk-4RGSNUUP.js";
 import "./chunk-6JSJNYH2.js";
 import "./chunk-D7BAQNV2.js";
-import "./chunk-J76TS67V.js";
+import "./chunk-WTP5FO4A.js";
 
 // packages/cleo/src/cli/commands/detect.ts
 var detectCommand = defineCommand({
@@ -43,4 +43,4 @@ var detectCommand = defineCommand({
 export {
   detectCommand
 };
-//# sourceMappingURL=detect-JAYIERC6.js.map
+//# sourceMappingURL=detect-VCH63Q3U.js.map

package/dist/cli/{diagnostics-4L76U6UG.js → diagnostics-HIHXEUWC.js}

@@ -18,7 +18,7 @@ import {
 } from "./chunk-47JYZAMS.js";
 import {
   dispatchFromCli
-} from "./chunk-RIJNJKQJ.js";
+} from "./chunk-J3NQONHJ.js";
 import "./chunk-6N6WGLXE.js";
 import "./chunk-4VASFLUW.js";
 import {
@@ -29,7 +29,7 @@ import "./chunk-QKMBWYAS.js";
 import "./chunk-4RGSNUUP.js";
 import "./chunk-6JSJNYH2.js";
 import "./chunk-D7BAQNV2.js";
-import "./chunk-J76TS67V.js";
+import "./chunk-WTP5FO4A.js";
 
 // packages/cleo/src/cli/commands/diagnostics.ts
 var enableCommand = defineCommand({
@@ -130,4 +130,4 @@ var diagnosticsCommand = defineCommand({
 export {
   diagnosticsCommand
 };
-//# sourceMappingURL=diagnostics-4L76U6UG.js.map
+//# sourceMappingURL=diagnostics-HIHXEUWC.js.map

package/dist/cli/{docs-QLDL3V32.js → docs-IVQAL6ZI.js}

@@ -25,7 +25,7 @@ import {
   dispatchFromCli,
   dispatchRaw,
   handleRawError
-} from "./chunk-RIJNJKQJ.js";
+} from "./chunk-J3NQONHJ.js";
 import "./chunk-6N6WGLXE.js";
 import {
   resolve
@@ -49,7 +49,7 @@ import {
 } from "./chunk-4RGSNUUP.js";
 import "./chunk-6JSJNYH2.js";
 import "./chunk-D7BAQNV2.js";
-import "./chunk-J76TS67V.js";
+import "./chunk-WTP5FO4A.js";
 
 // packages/cleo/src/cli/commands/docs.ts
 import { appendFile, mkdir as mkdir3, readdir, readFile as readFile2, writeFile as writeFile2 } from "node:fs/promises";
@@ -237,6 +237,18 @@ function parseFormat(raw) {
   return candidate;
 }
 
+// packages/cleo/src/cli/commands/docs/migrate.ts
+var migrateCommand = defineCommand({
+  meta: {
+    name: "migrate",
+    description: "Migrate legacy docs + history into the re-keyed store (T13360, spec \xA75): runs inside the migration safety harness (backup \u2192 verify \u2192 commit/rollback), labels imported rows origin:migrated, content-captures or records dangling docs, and is idempotent (re-runs are verified no-ops)."
+  },
+  args: {},
+  async run() {
+    await dispatchFromCli("mutate", "docs", "migrate", {}, { command: "docs migrate" });
+  }
+});
+
 // packages/cleo/src/cli/commands/docs/set-alias.ts
 import { ExitCode as ExitCode3 } from "@cleocode/contracts/exit-codes.js";
 import { setDisplayAlias } from "@cleocode/core/docs/display-alias";
@@ -314,6 +326,18 @@ var setAliasCommand = defineCommand({
   }
 });
 
+// packages/cleo/src/cli/commands/docs/stats.ts
+var statsCommand = defineCommand({
+  meta: {
+    name: "stats",
+    description: "Per-project CleoDocs adoption metrics (read-only, T13363): add:update ratio from the docs audit log, loose-markdown count with scanned/excluded dirs, docs_wikilinks edge count, and live decision_adr_links count. Emitted for the Council pilot baseline comparisons."
+  },
+  args: {},
+  async run() {
+    await dispatchFromCli("query", "docs", "stats", {}, { command: "docs stats" });
+  }
+});
+
 // packages/cleo/src/cli/commands/docs/triage.ts
 import { ExitCode as ExitCode4 } from "@cleocode/contracts/exit-codes.js";
 function parseLimit(raw) {
@@ -1579,7 +1603,7 @@ var fetchCommand = defineCommand({
         } else {
           cliError(`Content not retrievable: ${ref}`, ExitCode6.NOT_FOUND, {
             name: "E_NOT_FOUND",
-            fix: "The doc metadata exists but its blob may be missing. Try: cleo docs publish <slug>"
+            fix: "The doc metadata exists but its bytes are not in the blob store. Try: cleo docs doctor --repair"
           });
         }
         process.exit(ExitCode6.NOT_FOUND);
@@ -2165,7 +2189,11 @@ var updateCommand = defineCommand({
         ...typeof args.status === "string" ? { status: args.status } : {},
         ...args["dry-run"] === true ? { dryRun: true } : {},
         ...args.strict === true ? { strict: true } : {},
-        ...typeof args["attached-by"] === "string" ? { attachedBy: args["attached-by"] } : {}
+        ...typeof args["attached-by"] === "string" ? { attachedBy: args["attached-by"] } : {},
+        // T13674: the version the edit was authored against (the fetch
+        // envelope's metadata.headVersionUid). A stale base merges or
+        // conflicts instead of silently dropping a concurrent writer's edit.
+        ...typeof args["base-version-uid"] === "string" ? { baseVersionUid: args["base-version-uid"] } : {}
       },
       { command: "docs update" }
     );
@@ -2497,13 +2525,17 @@ function parseOlderThanDays(raw) {
 var doctorCommand = defineCommand({
   meta: {
     name: "doctor",
-    description: "Docs store health diagnostics + safe repairs: dangling local-file pointers, docVersion skew vs the audit log, empty topics/related_tasks provenance, docs_wikilinks drift, legacy store surfaces, stale drafts. Dry-run by default; --apply executes repairs (a fresh backup is created automatically first)."
+    description: "Docs store health diagnostics + safe repairs: dangling local-file pointers, docVersion skew vs the audit log, empty topics/related_tasks provenance, docs_wikilinks drift, legacy store surfaces, blob-store coverage, stale drafts. Dry-run by default; --apply executes repairs (a fresh backup is created automatically first); --repair runs only the hash-verified legacy-bytes \u2192 blob-store backfill (T13653)."
   },
   args: {
     apply: {
       type: "boolean",
       description: "Execute the repairs (default: dry-run plan only)"
     },
+    repair: {
+      type: "boolean",
+      description: "Backfill hash-verified legacy bytes into the blob store so unmigrated docs become readable again (T13653); runs only this repair, with the same backup gate"
+    },
     "older-than-days": {
       type: "string",
       description: "Age threshold in days for the stale-drafts check (default 30)"
@@ -2512,12 +2544,13 @@ var doctorCommand = defineCommand({
   },
   async run({ args }) {
     const apply = args.apply === true;
+    const repair = args.repair === true;
     const olderThanDays = parseOlderThanDays(args["older-than-days"]);
     await dispatchFromCli(
-      apply ? "mutate" : "query",
+      apply || repair ? "mutate" : "query",
       "docs",
       "doctor",
-      { apply, ...olderThanDays !== void 0 ? { olderThanDays } : {} },
+      { apply, repair, ...olderThanDays !== void 0 ? { olderThanDays } : {} },
       { command: "docs doctor" }
     );
   }
@@ -2803,6 +2836,10 @@ var docsCommand = defineCommand({
     audit: auditCommand,
     // T13446 — docs.triage batch triage (proposals only; --record persists D#### verdicts)
     triage: triageCommand,
+    // T13363 — docs.stats adoption metrics (read-only)
+    stats: statsCommand,
+    // T13360 — docs.migrate legacy docs import (harness-bracketed, idempotent)
+    migrate: migrateCommand,
     // Drift status — agent-facing, kept per cleodocs-rearch-design §6 (T13361 retired gap-check only)
     status: statusCommand,
     // T9645 reingest — retained: the docs-reingest workflow invokes `docs sync --from/--for/--name`
@@ -2823,4 +2860,4 @@ export {
   _llmOutputCommand,
   docsCommand
 };
-//# sourceMappingURL=docs-QLDL3V32.js.map
+//# sourceMappingURL=docs-IVQAL6ZI.js.map

package/dist/cli/{docs-W6SF4HRS.js → docs-RD5GJP3U.js}

@@ -15,7 +15,7 @@
 })();
 import {
   lazyOperation
-} from "./chunk-J76TS67V.js";
+} from "./chunk-WTP5FO4A.js";
 import {
   defineTypedHandler,
   lafsError,
@@ -126,6 +126,17 @@ var supersedeDoc = lazyOperation(
 var triageDocs = lazyOperation(
   async () => (await import("@cleocode/core/docs/triage")).triageDocs
 );
+var computeDocsStats = lazyOperation(
+  async () => (await import("@cleocode/core/docs/stats")).computeDocsStats
+);
+var runLegacyDocMigration = lazyOperation(
+  async () => (await import("@cleocode/core/docs/legacy-doc-migration")).runLegacyDocMigration
+);
+var sqliteModuleForMigration = null;
+async function sqliteForMigration() {
+  sqliteModuleForMigration ??= await import("@cleocode/core/store/sqlite.js");
+  return sqliteModuleForMigration;
+}
 var syncFromGit = lazyOperation(
   async () => (await import("@cleocode/core/docs/docs-ops")).syncFromGit
 );
@@ -532,12 +543,16 @@ var _docsTypedHandler = defineTypedHandler("docs", {
     }
     const content = await model.fetchContent(doc);
     if (content === null) {
-      return lafsError("E_NOT_FOUND", `Content not retrievable: ${ref}`, "fetch");
+      return lafsError(
+        "E_NOT_FOUND",
+        `Content not retrievable: ${ref} \u2014 the doc's bytes are not in the blob store; run \`cleo docs doctor --repair\` to backfill hash-verified legacy bytes (T13653)`,
+        "fetch"
+      );
     }
     const backend = await currentAttachmentBackend();
     const linkedDecisions = doc.slug ? (await listDecisionLinksForAdr(getProjectRoot(), doc.slug)).map((link) => link.decisionId) : void 0;
     return lafsSuccess(
-      buildDocsFetchResult({
+      await buildDocsFetchResult({
         doc,
         content,
         projectRoot: getProjectRoot(),
@@ -550,12 +565,13 @@ var _docsTypedHandler = defineTypedHandler("docs", {
   // ── docs.doctor ────────────────────────────────────────────────────────────
   doctor: async (params) => {
     const apply = params.apply === true;
+    const repair = params.repair === true;
     const projectRoot = getProjectRoot();
     let backupReceiptPath;
-    if (apply) {
+    if (apply || repair) {
       const backup = await createSystemBackup(projectRoot, {
         type: "snapshot",
-        note: "docs doctor pre-repair (T13447)"
+        note: `docs doctor pre-repair (T13447${repair ? "/T13653" : ""})`
       });
       const STORE_FILE = "cleo.db";
       if (!backup.files.includes(STORE_FILE)) {
@@ -570,6 +586,7 @@ var _docsTypedHandler = defineTypedHandler("docs", {
     }
     const result = await runDocsDoctor(projectRoot, {
       apply,
+      repair,
       ...params.olderThanDays !== void 0 ? { olderThanDays: params.olderThanDays } : {},
       ...backupReceiptPath !== void 0 ? { backupReceiptPath } : {}
     });
@@ -578,6 +595,43 @@ var _docsTypedHandler = defineTypedHandler("docs", {
     }
     return lafsSuccess(result.report, "doctor");
   },
+  // ── docs.migrate (T13360 — spec §5 honest legacy docs import) ─────────────
+  migrate: async (_params) => {
+    const projectRoot = getProjectRoot();
+    const { getDb, getNativeDb } = await sqliteForMigration();
+    await getDb(projectRoot);
+    const native = getNativeDb(projectRoot);
+    if (native === null) {
+      return lafsError(
+        "E_DOCS_MIGRATE_NO_STORE",
+        // @sync-invariant none:input-shape the project store could not be opened; nothing was written
+        "docs migrate requires an open project store \u2014 the migration wrote nothing",
+        "migrate"
+      );
+    }
+    const result = await runLegacyDocMigration({
+      projectRoot,
+      db: native,
+      cwd: projectRoot
+    });
+    const step = result.report.steps[0];
+    const summary = result.report.status === "completed" ? `legacy docs migration: ${result.counts.toCapture} captured, ${result.counts.toMarkDangling} dangling, ${result.counts.toSkip} already migrated, ${result.counts.nativeConflicts} native-conflict skips (${result.counts.versions} history rows)` : `legacy docs migration ${result.report.status}: ${result.report.failure ?? "step failed"}`;
+    return lafsSuccess(
+      {
+        status: result.report.status,
+        captured: result.counts.toCapture,
+        dangling: result.counts.toMarkDangling,
+        skipped: result.counts.toSkip,
+        nativeConflicts: result.counts.nativeConflicts,
+        versionsImported: result.counts.versions,
+        failure: result.report.failure,
+        backupId: step?.backup?.backupId ?? null,
+        transaction: step?.transaction ?? "none",
+        summary
+      },
+      "migrate"
+    );
+  },
   // ── docs.add ───────────────────────────────────────────────────────────────
   add: async (params) => {
     const {
@@ -1327,6 +1381,17 @@ var _docsTypedHandler = defineTypedHandler("docs", {
         docVersion: outcome.result.docVersion,
         squashed: outcome.result.squashed,
         summary: outcome.result.summary,
+        // T13604 — recorded CRDT section conflicts reach the envelope (AC1):
+        // the projection names the sections + both version refs.
+        ...outcome.result.sectionConflicts !== void 0 ? { sectionConflicts: outcome.result.sectionConflicts } : {},
+        // T13356 — advisory lease notices reach the envelope too: sections
+        // leased by other sessions; the edit proceeded anyway.
+        ...outcome.result.leaseNotices !== void 0 ? { leaseNotices: outcome.result.leaseNotices } : {},
+        // T13674 — a stale declared base was merged, not blindly applied:
+        // the head carries a concurrent writer's edit too; the caller must
+        // re-fetch before its next edit.
+        ...outcome.result.staleBaseMerged !== void 0 ? { staleBaseMerged: outcome.result.staleBaseMerged } : {},
+        ...outcome.result.headVersionUid !== void 0 ? { headVersionUid: outcome.result.headVersionUid } : {},
         // T11053 — surface which backend stored the updated blob so
         // observability consumers can confirm the V2 mirror succeeded.
         attachmentBackend: backend,
@@ -1491,7 +1556,8 @@ var QUERY_OPS = /* @__PURE__ */ new Set([
   "status",
   "audit",
   "doctor",
-  "triage"
+  "triage",
+  "stats"
 ]);
 var MUTATE_OPS = /* @__PURE__ */ new Set([
   "add",
@@ -1504,7 +1570,8 @@ var MUTATE_OPS = /* @__PURE__ */ new Set([
   "publish-pr",
   "sync",
   "import",
-  "doctor"
+  "doctor",
+  "migrate"
 ]);
 async function dispatchDocsLegacyQuery(operation, params) {
   const projectRoot = getProjectRoot();
@@ -1572,6 +1639,8 @@ async function dispatchDocsLegacyQuery(operation, params) {
         record: params["record"] === true,
         projectRoot
       });
+    case "stats":
+      return computeDocsStats({ projectRoot });
     default:
       throw new Error(`Unsupported docs query operation: ${operation}`);
   }
@@ -1798,7 +1867,8 @@ var DocsHandler = class {
         "status",
         "audit",
         "doctor",
-        "triage"
+        "triage",
+        "stats"
       ],
       mutate: [
         "add",
@@ -1811,7 +1881,8 @@ var DocsHandler = class {
         "publish-pr",
         "sync",
         "import",
-        "doctor"
+        "doctor",
+        "migrate"
       ]
     };
   }
@@ -1819,4 +1890,4 @@ var DocsHandler = class {
 export {
   DocsHandler
 };
-//# sourceMappingURL=docs-W6SF4HRS.js.map
+//# sourceMappingURL=docs-RD5GJP3U.js.map

package/dist/cli/{doctor-IR52QRCO.js → doctor-WCPTKJ4M.js}

@@ -126,7 +126,7 @@ import {
 import {
   dispatchFromCli,
   dispatchRaw
-} from "./chunk-RIJNJKQJ.js";
+} from "./chunk-J3NQONHJ.js";
 import "./chunk-6N6WGLXE.js";
 import "./chunk-4VASFLUW.js";
 import {
@@ -140,7 +140,7 @@ import {
 } from "./chunk-4RGSNUUP.js";
 import "./chunk-6JSJNYH2.js";
 import "./chunk-D7BAQNV2.js";
-import "./chunk-J76TS67V.js";
+import "./chunk-WTP5FO4A.js";
 
 // packages/cleo/src/cli/commands/doctor.ts
 import { mkdirSync, writeFileSync } from "node:fs";
@@ -1276,4 +1276,4 @@ Dependency cycles: check skipped (${msg})`);
 export {
   doctorCommand
 };
-//# sourceMappingURL=doctor-IR52QRCO.js.map
+//# sourceMappingURL=doctor-WCPTKJ4M.js.map

package/dist/cli/{done-CP2IO47C.js → done-NUIGWK6L.js}

@@ -16,11 +16,11 @@
 import {
   completeCommandArgs,
   completeDispatchParams
-} from "./chunk-YAKWUB4J.js";
+} from "./chunk-RCZVA6E6.js";
 import "./chunk-C3B7C43W.js";
 import {
   dispatchRaw
-} from "./chunk-RIJNJKQJ.js";
+} from "./chunk-J3NQONHJ.js";
 import "./chunk-6N6WGLXE.js";
 import "./chunk-4VASFLUW.js";
 import {
@@ -35,7 +35,7 @@ import {
   withoutOutputPointer
 } from "./chunk-6JSJNYH2.js";
 import "./chunk-D7BAQNV2.js";
-import "./chunk-J76TS67V.js";
+import "./chunk-WTP5FO4A.js";
 
 // packages/cleo/src/cli/commands/done.ts
 async function batchEntry(taskId, result, args) {
@@ -179,7 +179,8 @@ var doneCommand = defineCommand({
         blocker: "completion-refused",
         cause: completed.error?.code,
         next: {
-          command: completed.error?.fix ?? `cleo complete ${args.taskId}`,
+          // T13648: keep the explicit PR carrier; `cleo complete` has no --pr.
+          command: completed.error?.fix ?? (args.pr === void 0 ? `cleo complete ${args.taskId}` : `cleo done ${args.taskId} --pr ${args.pr}`),
           why: "Every gate is recorded; completion itself was refused."
         },
         recordedGates: recorded.data.recordedGates
@@ -201,4 +202,4 @@ var doneCommand = defineCommand({
 export {
   doneCommand
 };
-//# sourceMappingURL=done-CP2IO47C.js.map
+//# sourceMappingURL=done-NUIGWK6L.js.map

package/dist/cli/{export-MO7GIYDH.js → export-GYR7Y6NH.js}

@@ -17,7 +17,7 @@ import {
   dispatchFromCli,
   dispatchRaw,
   handleRawError
-} from "./chunk-RIJNJKQJ.js";
+} from "./chunk-J3NQONHJ.js";
 import "./chunk-6N6WGLXE.js";
 import "./chunk-4VASFLUW.js";
 import {
@@ -27,7 +27,7 @@ import "./chunk-QKMBWYAS.js";
 import "./chunk-4RGSNUUP.js";
 import "./chunk-6JSJNYH2.js";
 import "./chunk-D7BAQNV2.js";
-import "./chunk-J76TS67V.js";
+import "./chunk-WTP5FO4A.js";
 
 // packages/cleo/src/cli/commands/export.ts
 var exportCommand = defineCommand({
@@ -90,4 +90,4 @@ var exportCommand = defineCommand({
 export {
   exportCommand
 };
-//# sourceMappingURL=export-MO7GIYDH.js.map
+//# sourceMappingURL=export-GYR7Y6NH.js.map