@cleocode/cleo 2026.5.114 → 2026.5.120

package/dist/cli/index.js

@@ -1388,6 +1388,40 @@ var init_animation_bridge = __esm({
   }
 });
 
+// packages/cleo/src/cli/output-context.ts
+function setOutputMode(mode) {
+  currentMode = mode;
+}
+function getOutputMode() {
+  return currentMode;
+}
+function isOutputMode(value) {
+  return OUTPUT_MODES.includes(value);
+}
+var OUTPUT_MODES, currentMode;
+var init_output_context = __esm({
+  "packages/cleo/src/cli/output-context.ts"() {
+    "use strict";
+    OUTPUT_MODES = ["envelope", "id", "table", "count", "silent"];
+    currentMode = "envelope";
+  }
+});
+
+// packages/cleo/src/cli/summary-context.ts
+function setSummaryMode(on) {
+  currentSummary = on;
+}
+function getSummaryMode() {
+  return currentSummary;
+}
+var currentSummary;
+var init_summary_context = __esm({
+  "packages/cleo/src/cli/summary-context.ts"() {
+    "use strict";
+    currentSummary = false;
+  }
+});
+
 // packages/contracts/src/acceptance-gate-schema.ts
 import { z } from "zod";
 var gateBaseSchema, fileAssertionSchema, testGateSchema, fileGateSchema, commandGateSchema, lintGateSchema, httpGateSchema, manualGateSchema, acceptanceGateSchema, gateResultDetailsSchema, acceptanceGateResultSchema, acceptanceItemSchema, acceptanceArraySchema;
@@ -4248,6 +4282,39 @@ var init_operations_registry = __esm({
           }
         ]
       },
+      {
+        gateway: "mutate",
+        domain: "tasks",
+        operation: "relates.remove",
+        description: "tasks.relates.remove (mutate) \u2014 delete a relation between two tasks. Pass `type` to scope deletion to a single relation kind; omit to remove any type.",
+        tier: 1,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: ["taskId", "relatedId"],
+        params: [
+          {
+            name: "taskId",
+            type: "string",
+            required: true,
+            description: "Source task ID",
+            cli: { positional: true }
+          },
+          {
+            name: "relatedId",
+            type: "string",
+            required: true,
+            description: "Target task ID to remove the relation to",
+            cli: { positional: true }
+          },
+          {
+            name: "type",
+            type: "string",
+            required: false,
+            description: "Optional relation type (blocks|related|duplicates|absorbs|fixes|extends|supersedes). Omit to remove any type.",
+            cli: { flag: "type" }
+          }
+        ]
+      },
       // === saga sub-domain (ADR-073 — above-epic grouping tier) ===
       {
         gateway: "mutate",
@@ -8533,6 +8600,39 @@ var init_operations_registry = __esm({
           }
         ]
       },
+      // ── docs.supersede (T10162) ──────────────────────────────────────────────
+      {
+        gateway: "mutate",
+        domain: "docs",
+        operation: "supersede",
+        description: "docs.supersede (mutate) \u2014 atomically flip an older doc to `superseded` and link both rows via the supersedes/superseded_by self-FK pointers (T10162 \xB7 Saga T9855)",
+        tier: 1,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: ["oldSlug", "newSlug"],
+        params: [
+          {
+            name: "oldSlug",
+            type: "string",
+            required: true,
+            description: "Slug of the doc being replaced",
+            cli: { positional: true }
+          },
+          {
+            name: "newSlug",
+            type: "string",
+            required: true,
+            description: "Slug of the doc that replaces oldSlug",
+            cli: { positional: true }
+          },
+          {
+            name: "reason",
+            type: "string",
+            required: false,
+            description: "Optional human-readable reason carried back on the response"
+          }
+        ]
+      },
       // ── docs.generate (T798) ─────────────────────────────────────────────────
       {
         gateway: "query",
@@ -8558,6 +8658,55 @@ var init_operations_registry = __esm({
           }
         ]
       },
+      // ── docs.update (T10161 — Epic T10157 / Saga T9855) ──────────────────────
+      {
+        gateway: "mutate",
+        domain: "docs",
+        operation: "update",
+        description: "docs.update (mutate) \u2014 replace blob content for an existing slug while preserving the slug. New sha256 + new attachment row; the old row stays reachable by ID for history. NO supersession edge (use `cleo docs supersede` for that). Audit log entry appended to .cleo/audit/docs-versioning.jsonl (squashed within a 5-min window).",
+        tier: 1,
+        idempotent: false,
+        sessionRequired: false,
+        requiredParams: ["slug"],
+        params: [
+          {
+            name: "slug",
+            type: "string",
+            required: true,
+            description: "Slug of the existing attachment to update"
+          },
+          {
+            name: "file",
+            type: "string",
+            required: false,
+            description: "Path to a local file containing the new content"
+          },
+          {
+            name: "content",
+            type: "string",
+            required: false,
+            description: "Inline UTF-8 content (mutually exclusive with file)"
+          },
+          {
+            name: "message",
+            type: "string",
+            required: false,
+            description: "One-line summary describing the change (recorded in the audit log)"
+          },
+          {
+            name: "status",
+            type: "string",
+            required: false,
+            description: 'Override the new lifecycle status. Defaults to "draft" on every update. Valid: draft|proposed|accepted|superseded|archived|deprecated.'
+          },
+          {
+            name: "attachedBy",
+            type: "string",
+            required: false,
+            description: 'Agent identity that performed the update (defaults to "human")'
+          }
+        ]
+      },
       // ── playbook.* HITL CLI surface (T935) ───────────────────────────────────
       {
         gateway: "mutate",
@@ -12520,6 +12669,174 @@ var init_normalizer = __esm({
   }
 });
 
+// packages/cleo/src/cli/renderers/output-mode.ts
+function extractIds(data) {
+  if (data === null || typeof data !== "object") return [];
+  const rec = data;
+  const task = rec["task"];
+  if (task && typeof task === "object") {
+    const id2 = task["id"];
+    if (typeof id2 === "string") return [id2];
+  }
+  const tasks = rec["tasks"];
+  if (Array.isArray(tasks)) {
+    return tasks.map((t) => t && typeof t === "object" ? t["id"] : void 0).filter((id2) => typeof id2 === "string");
+  }
+  const items = rec["items"];
+  if (Array.isArray(items)) {
+    return items.map((t) => t && typeof t === "object" ? t["id"] : void 0).filter((id2) => typeof id2 === "string");
+  }
+  const id = rec["id"];
+  if (typeof id === "string") return [id];
+  return [];
+}
+function extractCount(data) {
+  if (data === null || typeof data !== "object") return 0;
+  const rec = data;
+  const total = rec["total"];
+  if (typeof total === "number" && Number.isFinite(total)) return total;
+  const tasks = rec["tasks"];
+  if (Array.isArray(tasks)) return tasks.length;
+  const items = rec["items"];
+  if (Array.isArray(items)) return items.length;
+  if (rec["task"] && typeof rec["task"] === "object") return 1;
+  if (typeof rec["id"] === "string") return 1;
+  return 0;
+}
+function truncate(value, max) {
+  if (value.length <= max) return value;
+  return value.slice(0, Math.max(0, max - 1)) + "\u2026";
+}
+function renderTableList(tasks) {
+  if (tasks.length === 0) return "No rows.";
+  const COL_TITLE_MAX = 60;
+  const rows = tasks.map((t) => ({
+    id: typeof t["id"] === "string" ? t["id"] : "",
+    status: typeof t["status"] === "string" ? t["status"] : "",
+    priority: typeof t["priority"] === "string" ? t["priority"] : "",
+    title: truncate(typeof t["title"] === "string" ? t["title"] : "", COL_TITLE_MAX)
+  }));
+  const widths = {
+    id: Math.max(2, ...rows.map((r) => r.id.length)),
+    status: Math.max(6, ...rows.map((r) => r.status.length)),
+    priority: Math.max(8, ...rows.map((r) => r.priority.length)),
+    title: Math.max(5, ...rows.map((r) => r.title.length))
+  };
+  const pad = (s, w) => s + " ".repeat(Math.max(0, w - s.length));
+  const header = `${pad("id", widths.id)}  ${pad("status", widths.status)}  ${pad(
+    "priority",
+    widths.priority
+  )}  ${pad("title", widths.title)}`;
+  const sep2 = `${"-".repeat(widths.id)}  ${"-".repeat(widths.status)}  ${"-".repeat(
+    widths.priority
+  )}  ${"-".repeat(widths.title)}`;
+  const body = rows.map(
+    (r) => `${pad(r.id, widths.id)}  ${pad(r.status, widths.status)}  ${pad(
+      r.priority,
+      widths.priority
+    )}  ${pad(r.title, widths.title)}`
+  ).join("\n");
+  return `${header}
+${sep2}
+${body}`;
+}
+function renderTableGeneric(data) {
+  const entries = Object.entries(data);
+  if (entries.length === 0) return "(empty)";
+  const rows = entries.map(([k, v]) => ({
+    field: k,
+    value: v === null || v === void 0 ? "" : typeof v === "object" ? JSON.stringify(v) : String(v)
+  }));
+  const VAL_MAX = 80;
+  for (const r of rows) r.value = truncate(r.value, VAL_MAX);
+  const widths = {
+    field: Math.max(5, ...rows.map((r) => r.field.length)),
+    value: Math.max(5, ...rows.map((r) => r.value.length))
+  };
+  const pad = (s, w) => s + " ".repeat(Math.max(0, w - s.length));
+  const header = `${pad("field", widths.field)}  ${pad("value", widths.value)}`;
+  const sep2 = `${"-".repeat(widths.field)}  ${"-".repeat(widths.value)}`;
+  const body = rows.map((r) => `${pad(r.field, widths.field)}  ${pad(r.value, widths.value)}`).join("\n");
+  return `${header}
+${sep2}
+${body}`;
+}
+function renderSummary2(data) {
+  if (data === null || typeof data !== "object") {
+    return { text: "" };
+  }
+  const rec = data;
+  const tasks = rec["tasks"];
+  if (Array.isArray(tasks)) {
+    return { text: renderSummaryList(tasks) };
+  }
+  const items = rec["items"];
+  if (Array.isArray(items)) {
+    return { text: renderSummaryList(items) };
+  }
+  const task = rec["task"];
+  if (task && typeof task === "object") {
+    return { text: renderSummaryRow(task) };
+  }
+  if (typeof rec["id"] === "string") {
+    return { text: renderSummaryRow(rec) };
+  }
+  return { text: "" };
+}
+function renderSummaryRow(record) {
+  const id = typeof record["id"] === "string" ? record["id"] : "";
+  const status = typeof record["status"] === "string" ? record["status"] : "";
+  const title = truncate(typeof record["title"] === "string" ? record["title"] : "", 60);
+  return `${id} [${status}] ${title}`;
+}
+function renderSummaryList(rows) {
+  if (rows.length === 0) return "No rows.";
+  const lines = [];
+  for (const row of rows) {
+    if (!row || typeof row !== "object") continue;
+    const rec = row;
+    if (typeof rec["id"] !== "string") continue;
+    lines.push(renderSummaryRow(rec));
+  }
+  return lines.length === 0 ? "No rows." : lines.join("\n");
+}
+function renderOutputMode(mode, data) {
+  switch (mode) {
+    case "id": {
+      const ids = extractIds(data);
+      return { text: ids.length === 0 ? "" : ids.join("\n") };
+    }
+    case "count": {
+      return { text: String(extractCount(data)) };
+    }
+    case "table": {
+      if (data && typeof data === "object") {
+        const rec = data;
+        const tasks = rec["tasks"];
+        if (Array.isArray(tasks)) {
+          return { text: renderTableList(tasks) };
+        }
+        const items = rec["items"];
+        if (Array.isArray(items)) {
+          return { text: renderTableList(items) };
+        }
+        return { text: renderTableGeneric(rec) };
+      }
+      return { text: data === null || data === void 0 ? "(empty)" : String(data) };
+    }
+    case "silent": {
+      return { text: null };
+    }
+    case "envelope":
+      throw new Error("renderOutputMode: envelope mode must be handled by caller");
+  }
+}
+var init_output_mode = __esm({
+  "packages/cleo/src/cli/renderers/output-mode.ts"() {
+    "use strict";
+  }
+});
+
 // packages/cleo/src/cli/renderers/index.ts
 var renderers_exports = {};
 __export(renderers_exports, {
@@ -12535,7 +12852,9 @@ __export(renderers_exports, {
 import { randomUUID } from "node:crypto";
 import {
   drainWarnings,
+  extractByJsonPointer,
   formatSuccess,
+  isJsonPointer,
   metaFooter,
   pagerFooter,
   renderAuditReconstruct,
@@ -12593,7 +12912,8 @@ import {
   renderStop,
   renderTree as renderTree2,
   renderVersion,
-  renderWaves
+  renderWaves,
+  serializePointerValue
 } from "@cleocode/core";
 import { applyFieldFilter, extractFieldFromResult } from "@cleocode/lafs";
 import {
@@ -12615,11 +12935,60 @@ function pickDecoratorMetaExtensionsLocal(responseMeta) {
   const out = {};
   if (responseMeta["_nexus"] !== void 0) out["_nexus"] = responseMeta["_nexus"];
   if (responseMeta["deprecated"] !== void 0) out["deprecated"] = responseMeta["deprecated"];
+  if (responseMeta["suggestedNext"] !== void 0) {
+    out["suggestedNext"] = responseMeta["suggestedNext"];
+  }
+  if (responseMeta["projection"] !== void 0) {
+    out["projection"] = responseMeta["projection"];
+  }
   return out;
 }
+function buildEnvelopeForPointer(data, opts) {
+  const decoratorExt = pickDecoratorMetaExtensionsLocal(opts.responseMeta);
+  const meta = {
+    ...decoratorExt,
+    ...opts.extensions ?? {},
+    operation: opts.operation ?? "cli.output"
+  };
+  if (opts.message) meta["message"] = opts.message;
+  const envelope = {
+    success: true,
+    data,
+    meta
+  };
+  if (opts.page) envelope["page"] = opts.page;
+  return envelope;
+}
 function cliOutput(data, opts) {
   const ctx = getFormatContext();
   const fieldCtx = getFieldContext();
+  const outputMode = getOutputMode();
+  const summary = getSummaryMode();
+  if (outputMode !== "envelope" && !fieldCtx.field) {
+    const out = renderOutputMode(outputMode, data);
+    if (out.text !== null && out.text.length > 0) {
+      process.stdout.write(out.text + "\n");
+    }
+    return;
+  }
+  if (summary && !fieldCtx.field) {
+    const out = renderSummary2(data);
+    if (out.text !== null && out.text.length > 0) {
+      process.stdout.write(out.text + "\n");
+    }
+    return;
+  }
+  if (fieldCtx.field && isJsonPointer(fieldCtx.field)) {
+    const envelope = buildEnvelopeForPointer(data, opts);
+    const value = extractByJsonPointer(envelope, fieldCtx.field);
+    if (value === void 0) {
+      cliError(`Pointer "${fieldCtx.field}" did not resolve`, 4, { name: "E_FIELD_NOT_FOUND" });
+      process.exit(4);
+    }
+    process.stdout.write(`${serializePointerValue(value)}
+`);
+    return;
+  }
   if (ctx.format === "human") {
     let dataToRender = data;
     let fieldExtracted = false;
@@ -12769,6 +13138,12 @@ function isHumanOutput() {
 }
 function cliError(message, code, details, meta) {
   const ctx = getFormatContext();
+  const outputMode = getOutputMode();
+  if (outputMode === "silent") {
+    process.stderr.write(`Error: ${message}${code ? ` (${code})` : ""}
+`);
+    return;
+  }
   if (ctx.format === "human") {
     process.stderr.write(`Error: ${message}${code ? ` (${code})` : ""}
 `);
@@ -12811,8 +13186,11 @@ var init_renderers = __esm({
     "use strict";
     init_field_context();
     init_format_context();
+    init_output_context();
+    init_summary_context();
     init_lafs_validator();
     init_normalizer();
+    init_output_mode();
     renderers = {
       // Task CRUD
       show: renderShow,
@@ -17005,18 +17383,25 @@ import { resolve as resolve2 } from "node:path";
 import { pushWarning } from "@cleocode/core";
 import {
   AUTO_TOKEN,
+  allocateAdrSlug,
   allocateAutoSlugForDispatch,
+  consumeReservedSlug,
   createAttachmentStore,
   createAttachmentStoreV2,
   generateDocsLlmsTxt,
   getCleoDirAbsolute,
   getProjectRoot as getProjectRoot5,
+  isLifecycleStatus,
   memoryObserve as memoryObserve2,
   parseChangesetFrontmatter,
   releaseReservedSlug,
   reserveSlugForDispatch,
   resolveAttachmentBackend,
   SlugCollisionError,
+  SUPERSEDE_NOT_FOUND_CODE,
+  SUPERSEDE_SAME_SLUG_CODE,
+  supersedeDoc,
+  updateDocBySlug,
   validateDocBody,
   writeChangesetEntry
 } from "@cleocode/core/internal";
@@ -17494,6 +17879,7 @@ var init_docs2 = __esm({
           labels: rawLabels,
           attachedBy: rawAttachedBy,
           slug: rawSlug,
+          title: rawTitle,
           type: rawType,
           strict: strictMode
         } = params;
@@ -17601,6 +17987,19 @@ var init_docs2 = __esm({
             if (err.code === "E_FILE_WRITE_FAILED") {
               return lafsError("E_FILE_ERROR", err.message, "add");
             }
+            if (err.code === "E_SLUG_RESERVED") {
+              return {
+                success: false,
+                error: {
+                  code: "E_SLUG_RESERVED",
+                  message: err.message,
+                  details: {
+                    suggestions: err.suggestions,
+                    aliases: err.aliases
+                  }
+                }
+              };
+            }
             return lafsError("E_SSOT_WRITE_FAILED", err.message, "add");
           }
           const changesetPayload = {
@@ -17633,14 +18032,31 @@ var init_docs2 = __esm({
             "add"
           );
         }
+        let adrNumber;
+        if (type2 === "adr" && slug === void 0) {
+          if (typeof rawTitle !== "string" || rawTitle.trim().length === 0) {
+            return lafsError(
+              "E_VALIDATION",
+              "title is required when type=adr and slug is omitted \u2014 the allocator needs a title to assemble adr-NNN-<kebab-title>",
+              "add"
+            );
+          }
+          const allocation = await allocateAdrSlug(getProjectRoot5(), { title: rawTitle });
+          if (!allocation.ok) {
+            return lafsError(allocation.code, allocation.message, "add");
+          }
+          slug = allocation.slug;
+          adrNumber = allocation.number;
+        }
         if (type2 !== void 0 && slug !== void 0) {
           const patternCheck = getDocKindRegistry().validateSlug(type2, slug);
           if (!patternCheck.ok) {
+            if (adrNumber !== void 0) releaseReservedSlug(slug);
             const exampleHint = patternCheck.example ? ` (example: ${patternCheck.example})` : "";
             return lafsError("E_SLUG_PATTERN_MISMATCH", `${patternCheck.error}${exampleHint}`, "add");
           }
         }
-        if (slug !== void 0) {
+        if (slug !== void 0 && adrNumber === void 0) {
           const reservation = await reserveSlugForDispatch(getProjectRoot5(), {
             kind: type2 ?? "",
             slug
@@ -17741,6 +18157,7 @@ var init_docs2 = __esm({
             }
             throw err;
           }
+          if (adrNumber !== void 0 && slug !== void 0) consumeReservedSlug(slug);
           let backend = "legacy";
           try {
             const v2 = createAttachmentStoreV2(getProjectRoot5());
@@ -17782,7 +18199,8 @@ var init_docs2 = __esm({
               // Cast: core returns 'llmtxt'|'legacy'; contracts uses 'legacy'|'llmstxt-v2' (T1529)
               attachmentBackend: backend,
               ...slug !== void 0 ? { slug } : {},
-              ...type2 !== void 0 ? { type: type2 } : {}
+              ...type2 !== void 0 ? { type: type2 } : {},
+              ...adrNumber !== void 0 ? { adrNumber } : {}
             },
             "add"
           );
@@ -17823,6 +18241,7 @@ var init_docs2 = __esm({
             }
             throw err;
           }
+          if (adrNumber !== void 0 && slug !== void 0) consumeReservedSlug(slug);
           import("@cleocode/core/internal").then(
             ({ ensureLlmtxtNode }) => ensureLlmtxtNode(getProjectRoot5(), meta.sha256, `${ownerType}:${ownerId}`, url)
           ).catch(() => {
@@ -17849,7 +18268,8 @@ var init_docs2 = __esm({
               // Cast: core returns 'llmtxt'|'legacy'; contracts uses 'legacy'|'llmstxt-v2' (T1529)
               attachmentBackend: backend,
               ...slug !== void 0 ? { slug } : {},
-              ...type2 !== void 0 ? { type: type2 } : {}
+              ...type2 !== void 0 ? { type: type2 } : {},
+              ...adrNumber !== void 0 ? { adrNumber } : {}
             },
             "add"
           );
@@ -17907,10 +18327,90 @@ var init_docs2 = __esm({
           },
           "remove"
         );
+      },
+      // ── docs.update (T10161 — E12.C4 / Saga T9855) ─────────────────────────────
+      update: async (params) => {
+        const { slug: rawSlug, file: filePath, content: inlineContent, status: rawStatus } = params;
+        if (typeof rawSlug !== "string" || rawSlug.length === 0) {
+          return lafsError("E_INVALID_INPUT", "slug is required", "update");
+        }
+        const hasFile = typeof filePath === "string" && filePath.length > 0;
+        const hasContent = typeof inlineContent === "string";
+        if (hasFile === hasContent) {
+          return lafsError(
+            "E_INVALID_INPUT",
+            "Provide exactly one of --file <path> or --content <text>",
+            "update",
+            'Use `cleo docs update <slug> --file ./new.md` OR `cleo docs update <slug> --content "..."`.'
+          );
+        }
+        if (rawStatus !== void 0 && !isLifecycleStatus(rawStatus)) {
+          return lafsError(
+            "E_INVALID_INPUT",
+            `status must be one of: draft|proposed|accepted|superseded|archived|deprecated \u2014 got '${String(rawStatus)}'`,
+            "update"
+          );
+        }
+        const projectRoot = getProjectRoot5();
+        const resolvedParams = hasFile ? { ...params, file: resolve2(filePath) } : params;
+        const outcome = await updateDocBySlug(projectRoot, resolvedParams);
+        if (!outcome.ok) {
+          return lafsError(outcome.error.code, outcome.error.message, "update");
+        }
+        return lafsSuccess(
+          {
+            slug: outcome.result.slug,
+            ...outcome.result.type !== null ? { type: outcome.result.type } : {},
+            attachmentId: outcome.result.attachmentId,
+            previousAttachmentId: outcome.result.previousAttachmentId,
+            sha256: outcome.result.sha256,
+            previousSha256: outcome.result.previousSha256,
+            changed: outcome.result.changed,
+            lifecycleStatus: outcome.result.lifecycleStatus,
+            updatedAt: outcome.result.updatedAt,
+            version: outcome.result.version,
+            squashed: outcome.result.squashed
+          },
+          "update"
+        );
+      },
+      // ── docs.supersede ─────────────────────────────────────────────────────────
+      supersede: async (params) => {
+        const { oldSlug, newSlug, reason } = params;
+        if (typeof oldSlug !== "string" || oldSlug.length === 0) {
+          return lafsError("E_INVALID_INPUT", "<oldSlug> is required", "supersede");
+        }
+        if (typeof newSlug !== "string" || newSlug.length === 0) {
+          return lafsError("E_INVALID_INPUT", "<newSlug> is required", "supersede");
+        }
+        try {
+          const result = await supersedeDoc(getProjectRoot5(), {
+            oldSlug,
+            newSlug,
+            ...typeof reason === "string" && reason.length > 0 ? { reason } : {}
+          });
+          const payload = {
+            oldSlug: result.oldSlug,
+            newSlug: result.newSlug,
+            oldAttachmentId: result.oldAttachmentId,
+            newAttachmentId: result.newAttachmentId,
+            supersededAt: result.supersededAt,
+            edgeId: result.edgeId,
+            ...result.reason !== void 0 ? { reason: result.reason } : {}
+          };
+          return lafsSuccess(payload, "supersede");
+        } catch (err) {
+          const code = err && typeof err === "object" && "code" in err && typeof err.code === "number" ? (
+            // Map ExitCode (number) → stable LAFS string code expected by callers.
+            err.code === 4 ? SUPERSEDE_NOT_FOUND_CODE : err.code === 6 ? SUPERSEDE_SAME_SLUG_CODE : "E_INTERNAL"
+          ) : "E_INTERNAL";
+          const message = err instanceof Error ? err.message : "supersede failed";
+          return lafsError(code, message, "supersede");
+        }
       }
     });
     QUERY_OPS3 = /* @__PURE__ */ new Set(["list", "fetch", "generate"]);
-    MUTATE_OPS3 = /* @__PURE__ */ new Set(["add", "remove"]);
+    MUTATE_OPS3 = /* @__PURE__ */ new Set(["add", "remove", "update", "supersede"]);
     DocsHandler = class {
       // -----------------------------------------------------------------------
       // Query
@@ -17969,7 +18469,7 @@ var init_docs2 = __esm({
       getSupportedOperations() {
         return {
           query: ["list", "fetch", "generate"],
-          mutate: ["add", "remove"]
+          mutate: ["add", "remove", "update", "supersede"]
         };
       }
     };
@@ -20430,6 +20930,9 @@ function pickDecoratorMetaExtensions(responseMeta) {
   const out = {};
   if (responseMeta["_nexus"] !== void 0) out["_nexus"] = responseMeta["_nexus"];
   if (responseMeta["deprecated"] !== void 0) out["deprecated"] = responseMeta["deprecated"];
+  if (responseMeta["suggestedNext"] !== void 0) {
+    out["suggestedNext"] = responseMeta["suggestedNext"];
+  }
   return out;
 }
 function buildNexusMetaExtensions(operation, params = {}) {
@@ -26817,7 +27320,8 @@ async function orchestrateSpawnOp(params) {
     getProjectRoot11(),
     params.tier,
     params.noWorktree,
-    params.spawnScope
+    params.spawnScope,
+    params.atomicityScope
   );
 }
 async function orchestrateHandoffOp(params) {
@@ -27654,12 +28158,15 @@ var init_orchestrate2 = __esm({
                 );
               const tierRaw = params.tier;
               const tier = tierRaw === 0 || tierRaw === 1 || tierRaw === 2 ? tierRaw : void 0;
+              const atomicityScopeRaw = params.atomicityScope;
+              const atomicityScope = atomicityScopeRaw === "orchestrator-defer" ? "orchestrator-defer" : void 0;
               const p = {
                 taskId: params.taskId,
                 protocolType: params.protocolType,
                 tier,
                 noWorktree: params.noWorktree,
-                spawnScope: params.spawnScope
+                spawnScope: params.spawnScope,
+                ...atomicityScope ? { atomicityScope } : {}
               };
               return wrapResult(await coreOps2.spawn(p), "mutate", "orchestrate", operation, startTime);
             }
@@ -30092,7 +30599,7 @@ var init_sticky2 = __esm({
 });
 
 // packages/cleo/src/dispatch/domains/tasks.ts
-import { getLogger as getLogger15, getProjectRoot as getProjectRoot18 } from "@cleocode/core";
+import { getLogger as getLogger15, getProjectRoot as getProjectRoot18, TASKS_SUGGESTED_NEXT_BUILDERS } from "@cleocode/core";
 import { createAttachmentStore as createAttachmentStore4 } from "@cleocode/core/internal";
 import {
   sagaAdd as coreSagaAdd,
@@ -30170,6 +30677,25 @@ async function sagaReconcile(params) {
     "saga.reconcile"
   );
 }
+function stampSuggestedNext(response, operation, params) {
+  if (!response.success) return response;
+  const builder = TASKS_SUGGESTED_NEXT_BUILDERS[operation];
+  if (!builder) return response;
+  let suggestions;
+  try {
+    suggestions = builder(params, response.data);
+  } catch {
+    return response;
+  }
+  if (suggestions.length === 0) return response;
+  return {
+    ...response,
+    meta: {
+      ...response.meta,
+      suggestedNext: suggestions
+    }
+  };
+}
 var _tasksTypedHandler, QUERY_OPS11, MUTATE_OPS10, TasksHandler;
 var init_tasks2 = __esm({
   "packages/cleo/src/dispatch/domains/tasks.ts"() {
@@ -30241,7 +30767,9 @@ var init_tasks2 = __esm({
             fields: params.fields,
             verbose: params.verbose,
             // T944/T9072: kind filter
-            kind: params.kind
+            kind: params.kind,
+            // T9905: unified urgency surface
+            urgent: params.urgent
           }),
           "find"
         );
@@ -30684,7 +31212,14 @@ var init_tasks2 = __esm({
             operation,
             params ?? {}
           );
-          return wrapResult(envelopeToEngineResult(envelope), "query", "tasks", operation, startTime);
+          const response = wrapResult(
+            envelopeToEngineResult(envelope),
+            "query",
+            "tasks",
+            operation,
+            startTime
+          );
+          return stampSuggestedNext(response, operation, params ?? {});
         } catch (error) {
           getLogger15("domain:tasks").error(
             { gateway: "query", domain: "tasks", operation, err: error },
@@ -30771,7 +31306,14 @@ var init_tasks2 = __esm({
             operation,
             params ?? {}
           );
-          return wrapResult(envelopeToEngineResult(envelope), "mutate", "tasks", operation, startTime);
+          const response = wrapResult(
+            envelopeToEngineResult(envelope),
+            "mutate",
+            "tasks",
+            operation,
+            startTime
+          );
+          return stampSuggestedNext(response, operation, params ?? {});
         } catch (error) {
           getLogger15("domain:tasks").error(
             { gateway: "mutate", domain: "tasks", operation, err: error },
@@ -32296,6 +32838,88 @@ var init_field_filter = __esm({
   }
 });
 
+// packages/cleo/src/cli/projection-context.ts
+function setProjectionOptOut(optOut) {
+  currentOptOut = optOut;
+}
+function getProjectionOptOut() {
+  return currentOptOut;
+}
+var currentOptOut;
+var init_projection_context = __esm({
+  "packages/cleo/src/cli/projection-context.ts"() {
+    "use strict";
+    currentOptOut = false;
+  }
+});
+
+// packages/cleo/src/dispatch/middleware/mutate-minimal-envelope.ts
+import {
+  applyMutateProjection,
+  MUTATE_PROJECTION_PLANS,
+  resolveProjectionMode
+} from "@cleocode/core";
+function resolveModeFor(req) {
+  const override = req.params?.["_projection"];
+  if (override === "full" || override === "mvi") return override;
+  return resolveProjectionMode(getProjectionOptOut() || void 0);
+}
+function createMutateMinimalEnvelope() {
+  return async (req, next) => {
+    const mode = resolveModeFor(req);
+    const opKey = `${req.domain}.${req.operation}`;
+    const hasPlan = MUTATE_PROJECTION_PLANS[opKey] !== void 0;
+    const response = await next();
+    if (!hasPlan) return response;
+    if (response.success && response.data !== void 0) {
+      response.data = applyMutateProjection(response.data, opKey, mode);
+    }
+    response.meta.mutateProjection = mode;
+    return response;
+  };
+}
+var init_mutate_minimal_envelope = __esm({
+  "packages/cleo/src/dispatch/middleware/mutate-minimal-envelope.ts"() {
+    "use strict";
+    init_projection_context();
+  }
+});
+
+// packages/cleo/src/dispatch/middleware/mvi-record-projection.ts
+import {
+  applyProjectionPlan,
+  PROJECTION_PLANS,
+  resolveProjectionMode as resolveProjectionMode2
+} from "@cleocode/core";
+function resolveModeFor2(req) {
+  const override = req.params?.["_projection"];
+  if (override === "full" || override === "mvi") return override;
+  return resolveProjectionMode2(getProjectionOptOut() || void 0);
+}
+function createMviRecordProjection() {
+  return async (req, next) => {
+    const mode = resolveModeFor2(req);
+    if (req.params && "_projection" in req.params) {
+      delete req.params["_projection"];
+    }
+    const opKey = `${req.domain}.${req.operation}`;
+    const hasPlan = PROJECTION_PLANS[opKey] !== void 0;
+    const response = await next();
+    if (!hasPlan) return response;
+    if (response.success && response.data !== void 0) {
+      response.data = applyProjectionPlan(response.data, opKey, mode);
+    }
+    response.meta.projection = mode;
+    return response;
+  };
+}
+var init_mvi_record_projection = __esm({
+  "packages/cleo/src/dispatch/middleware/mvi-record-projection.ts"() {
+    "use strict";
+    init_projection_context();
+  }
+});
+
 // packages/cleo/src/dispatch/lib/security.ts
 import {
   ALL_VALID_STATUSES,
@@ -32503,6 +33127,15 @@ function createCliDispatcher() {
       // T4959: session identity first
       createSanitizer(() => getProjectRoot22()),
       createFieldFilter(),
+      // T9922 (Saga T9855 / E8.3): MVI record projection default for read ops.
+      // Runs AFTER the domain handler returns so it can trim the data payload
+      // before audit + telemetry record byte sizes. Sits before audit so the
+      // audit trail captures the projected (final) bytes.
+      createMviRecordProjection(),
+      // T9931 (Saga T9855 / E9.4): minimal envelopes for mutate ops. Mirror
+      // policy to the read-side projection — sits in the same pre-audit slot
+      // so audit/telemetry record the trimmed bytes.
+      createMutateMinimalEnvelope(),
       createAudit(),
       // T4959: CLI now gets audit trail
       createTelemetry()
@@ -32669,6 +33302,8 @@ var init_cli = __esm({
     init_domains();
     init_audit();
     init_field_filter();
+    init_mutate_minimal_envelope();
+    init_mvi_record_projection();
     init_sanitizer();
     init_session_resolver();
     init_telemetry();
@@ -32864,16 +33499,16 @@ function wrapParseError(rawInput, parseErr, sourceLabel) {
   const snippet2 = rawInput.length > PARSE_ERROR_SNIPPET_MAX_LENGTH ? `${rawInput.slice(0, PARSE_ERROR_SNIPPET_MAX_LENGTH)}\u2026` : rawInput;
   return new Error(`Invalid JSON in ${sourceLabel}: ${parseErr.message} (got: ${snippet2})`);
 }
-function readStdinJson(stdin) {
+function readStdinJson(stdin2) {
   return new Promise((resolve8, reject) => {
     const chunks = [];
-    stdin.on("data", (chunk) => {
+    stdin2.on("data", (chunk) => {
       chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
     });
-    stdin.on("error", (err) => {
+    stdin2.on("error", (err) => {
       reject(err);
     });
-    stdin.on("end", () => {
+    stdin2.on("end", () => {
       const raw = Buffer.concat(chunks).toString("utf8");
       try {
         resolve8(JSON.parse(raw));
@@ -32883,7 +33518,7 @@ function readStdinJson(stdin) {
     });
   });
 }
-async function collectMutateInput(args, stdin) {
+async function collectMutateInput(args, stdin2) {
   if (typeof args.params === "string" && args.params.length > 0) {
     try {
       return JSON.parse(args.params);
@@ -32899,8 +33534,8 @@ async function collectMutateInput(args, stdin) {
       throw wrapParseError(raw, err, `--file ${args.file}`);
     }
   }
-  if (stdin.isTTY !== true) {
-    return readStdinJson(stdin);
+  if (stdin2.isTTY !== true) {
+    return readStdinJson(stdin2);
   }
   if (args.positional !== void 0 && args.positional.length > 0) {
     return args.positional;
@@ -35780,7 +36415,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
         try {
           const { existsSync: existsSync19, statSync } = await import("node:fs");
           const { resolve: resolve8, basename, dirname: dirname12 } = await import("node:path");
-          const { execFileSync: execFileSync4 } = await import("node:child_process");
+          const { execFileSync: execFileSync5 } = await import("node:child_process");
           const resolvedDir = resolve8(args.dir);
           if (!existsSync19(resolvedDir) || !statSync(resolvedDir).isDirectory()) {
             cliOutput(
@@ -35817,7 +36452,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
           const archivePath = resolve8(archiveName);
           const parentDir = dirname12(resolvedDir);
           try {
-            execFileSync4("zip", ["-r", archivePath, agentName], {
+            execFileSync5("zip", ["-r", archivePath, agentName], {
               cwd: parentDir,
               encoding: "utf-8",
               timeout: 3e4
@@ -39480,7 +40115,7 @@ var init_changeset = __esm({
         });
         if (!outcome.ok) {
           const err = outcome.error;
-          const hint = err.code === "E_SLUG_PATTERN_MISMATCH" && err.example ? `example slug: ${err.example}` : void 0;
+          const hint = err.code === "E_SLUG_PATTERN_MISMATCH" && err.example ? `example slug: ${err.example}` : err.code === "E_SLUG_RESERVED" ? `try: ${err.suggestions.join(", ")}` : void 0;
           cliError(err.message, 6 /* VALIDATION_ERROR */, {
             name: err.code,
             ...hint ? { fix: hint } : {}
@@ -43786,6 +44421,94 @@ var init_strict_args = __esm({
   }
 });
 
+// packages/cleo/src/cli/commands/docs/graph.ts
+import {
+  buildDocProvenanceGraph,
+  DocProvenanceRootNotFoundError,
+  renderProvenanceGraphAsDot
+} from "@cleocode/core/internal";
+function parseDepth(raw) {
+  if (raw === void 0 || raw === null || raw === "") return 2;
+  const parsed = Number.parseInt(String(raw), 10);
+  if (!Number.isInteger(parsed) || parsed < 0) {
+    cliError(
+      `--depth must be a non-negative integer (got '${String(raw)}')`,
+      6 /* VALIDATION_ERROR */,
+      { name: "E_VALIDATION" }
+    );
+    process.exit(6 /* VALIDATION_ERROR */);
+  }
+  return parsed;
+}
+function parseFormat(raw) {
+  if (raw === void 0 || raw === null || raw === "") return "json";
+  const candidate = String(raw);
+  if (candidate !== "json" && candidate !== "dot") {
+    cliError(`--format must be one of: json|dot \u2014 got '${candidate}'`, 6 /* VALIDATION_ERROR */, {
+      name: "E_VALIDATION"
+    });
+    process.exit(6 /* VALIDATION_ERROR */);
+  }
+  return candidate;
+}
+var graphCommand;
+var init_graph2 = __esm({
+  "packages/cleo/src/cli/commands/docs/graph.ts"() {
+    "use strict";
+    init_src2();
+    init_define_cli_command();
+    init_renderers();
+    graphCommand = defineCommand({
+      meta: {
+        name: "graph",
+        description: "Traverse the docs provenance graph from a root (slug or task ID) and return a typed DocProvenanceResponse envelope. Walks supersedes/superseded-by chains plus cross-entity edges to owning + related tasks. Default depth=2. Pass --format dot for Graphviz output (still wrapped in the envelope under data.dot)."
+      },
+      args: {
+        root: {
+          type: "string",
+          description: "Root identifier \u2014 a canonical doc slug (e.g. adr-078-docs-provenance) or a CLEO task ID (T####). Required.",
+          required: true
+        },
+        depth: {
+          type: "string",
+          description: "Maximum BFS hops from the root (default: 2; minimum: 0)."
+        },
+        format: {
+          type: "string",
+          description: "Output format: json (default) | dot."
+        }
+      },
+      async run({ args }) {
+        const root = String(args.root);
+        const depth = parseDepth(args.depth);
+        const format = parseFormat(args.format);
+        try {
+          const graph = await buildDocProvenanceGraph({ root, depth });
+          const payload = { ...graph };
+          if (format === "dot") {
+            payload["dot"] = renderProvenanceGraphAsDot(graph);
+          }
+          cliOutput(payload, { command: "docs graph", operation: "docs.graph" });
+        } catch (err) {
+          if (err instanceof DocProvenanceRootNotFoundError) {
+            cliError(err.message, 4 /* NOT_FOUND */, {
+              name: "E_DOC_PROVENANCE_ROOT_NOT_FOUND",
+              fix: "Verify the root with `cleo docs list --project --type adr` (or your kind) and pass an existing slug or task ID. Slugs and task IDs are matched against attachments.slug and attachment_refs.owner_id respectively.",
+              details: { root }
+            });
+            process.exit(4 /* NOT_FOUND */);
+          }
+          const message = err instanceof Error ? err.message : String(err);
+          cliError(`docs graph failed: ${message}`, 1 /* GENERAL_ERROR */, {
+            name: "E_DOCS_GRAPH_FAILED"
+          });
+          process.exit(1 /* GENERAL_ERROR */);
+        }
+      }
+    });
+  }
+});
+
 // packages/cleo/src/viewer/pidfile.ts
 import { mkdir, readFile as readFile3, unlink, writeFile } from "node:fs/promises";
 import { dirname as dirname6, join as join18 } from "node:path";
@@ -44614,7 +45337,6 @@ __export(docs_exports, {
 import { appendFile, mkdir as mkdir2, readdir, readFile as readFile4, writeFile as writeFile2 } from "node:fs/promises";
 import { dirname as dirname8, isAbsolute as isAbsolute2, join as join21, resolve as resolve5 } from "node:path";
 import {
-  buildDocsGraph,
   CleoError as CleoError3,
   CounterMismatchError,
   checkSlugSimilarity,
@@ -44623,6 +45345,7 @@ import {
   DEFAULT_SIMILARITY_THRESHOLD,
   detectStrayCleoDb as detectStrayCleoDb2,
   exportDocument,
+  findSimilarDocs,
   getAgentOutputsAbsolute,
   getProjectRoot as getProjectRoot38,
   listDocVersions,
@@ -44728,7 +45451,7 @@ function loadCliRegistry(projectRoot) {
     throw err;
   }
 }
-var addCommand5, listCommand8, fetchCommand, removeCommand2, generateCommand, exportCommand4, searchCommand, mergeCommand, graphCommand, rankCommand, versionsCommand, publishCommand2, publishPrCommand, syncCommand3, statusCommand7, gapCheckCommand, importCommand2, schemaCommand, listTypesCommand, docsCommand;
+var addCommand5, listCommand8, fetchCommand, removeCommand2, supersedeCommandArgs, supersedeCommand, generateCommand, exportCommand4, searchCommand, findCommand3, mergeCommand, rankCommand, updateCommand, versionsCommand, publishCommand2, publishPrCommand, syncCommand3, statusCommand7, gapCheckCommand, importCommand2, schemaCommand, listTypesCommand, docsCommand;
 var init_docs3 = __esm({
   "packages/cleo/src/cli/commands/docs.ts"() {
     "use strict";
@@ -44738,11 +45461,12 @@ var init_docs3 = __esm({
     init_canon_docs();
     init_strict_args();
     init_renderers();
+    init_graph2();
     init_docs_viewer();
     addCommand5 = defineCommand({
       meta: {
         name: "add",
-        description: 'Attach a local file or remote URL to a CLEO entity (task, session, observation). Owner type is inferred from the ID prefix: T### \u2192 task, ses_* \u2192 session, O-* \u2192 observation. Use --slug to set a human-friendly alias (unique per project) (T9636).\n\nPositional arguments:\n  <owner-id>             Owner entity ID (T###, ses_*, O-*) \u2014 required\n  [file]                 Local file path to attach \u2014 optional when --url is set\n\nNamed arguments:\n  --url <url>            Remote URL to attach (instead of a local file)\n  --desc <text>          Free-text description of this attachment\n  --labels <csv>         Comma-separated labels (e.g. rfc,spec)\n  --attached-by <name>   Agent identity that created the attachment (default: "human")\n  --slug <kebab>         Human-friendly alias, unique per project (T9636)\n  --type <kind>          Taxonomy classification \u2014 run `cleo docs list-types` for kinds\n  --allow-similar        Bypass the slug-similarity warn \u2014 every bypass is audited\n                         to .cleo/audit/similar-bypass.jsonl (T10361)\n  --strict               Enforce body-schema (requiredSections) \u2014 fail with\n                         E_DOC_SCHEMA_MISMATCH instead of warning (T10160)\n\nValidation behaviors:\n  \u2022 Unknown flags \u2192 E_UNKNOWN_FLAG with did-you-mean suggestions (T10359)\n  \u2022 Slug collision \u2192 E_SLUG_RESERVED + 3 alternative slugs (T10386)\n  \u2022 Near-duplicate slug \u2192 W_SLUG_SIMILAR warning unless --allow-similar (T10361)\n  \u2022 TODO(T10360): --type adr will auto-allocate adr-NNN-<title> from a --title flag.'
+        description: 'Attach a local file or remote URL to a CLEO entity (task, session, observation). Owner type is inferred from the ID prefix: T### \u2192 task, ses_* \u2192 session, O-* \u2192 observation. Use --slug to set a human-friendly alias (unique per project) (T9636).\n\nPositional arguments:\n  <owner-id>             Owner entity ID (T###, ses_*, O-*) \u2014 required\n  [file]                 Local file path to attach \u2014 optional when --url is set\n\nNamed arguments:\n  --url <url>            Remote URL to attach (instead of a local file)\n  --desc <text>          Free-text description of this attachment\n  --labels <csv>         Comma-separated labels (e.g. rfc,spec)\n  --attached-by <name>   Agent identity that created the attachment (default: "human")\n  --slug <kebab>         Human-friendly alias, unique per project (T9636)\n  --title <text>         Human-readable title \u2014 REQUIRED for --type adr when --slug is omitted (T10360)\n  --type <kind>          Taxonomy classification \u2014 run `cleo docs list-types` for kinds\n  --allow-similar        Bypass the slug-similarity warn \u2014 every bypass is audited\n                         to .cleo/audit/similar-bypass.jsonl (T10361)\n  --strict               Enforce body-schema (requiredSections) \u2014 fail with\n                         E_DOC_SCHEMA_MISMATCH instead of warning (T10160)\n\nValidation behaviors:\n  \u2022 Unknown flags \u2192 E_UNKNOWN_FLAG with did-you-mean suggestions (T10359)\n  \u2022 Slug collision \u2192 E_SLUG_RESERVED + 3 alternative slugs (T10386)\n  \u2022 Near-duplicate slug \u2192 W_SLUG_SIMILAR warning unless --allow-similar (T10361)\n  \u2022 For --type adr without --slug, slug auto-allocates as `adr-NNN-<kebab-title>` via the\n    central allocator (T10360 \u2014 closes T10153). --title is required in this case.'
       },
       args: {
         "owner-id": {
@@ -44775,6 +45499,10 @@ var init_docs3 = __esm({
           type: "string",
           description: "Human-friendly kebab-case alias for the attachment, unique per project (T9636). Collision returns E_SLUG_RESERVED with 3 alternative suggestions (legacy E_SLUG_TAKEN aliased under details.aliases for one release \u2014 T10386)."
         },
+        title: {
+          type: "string",
+          description: "Human-readable title used to derive the kebab-slug tail when auto-allocating an ADR slug. REQUIRED when --type adr is set AND --slug is omitted. Slugified via the shared kebabize helper (lowercase, hyphen-separated, diacritics stripped) (T10360)."
+        },
         type: {
           type: "string",
           description: "Taxonomy classification \u2014 run `cleo docs list-types` to enumerate registered kinds (T9637 / T9788)"
@@ -44814,6 +45542,17 @@ var init_docs3 = __esm({
           });
           process.exit(6);
         }
+        if (args.type === "adr" && !args.slug && !args.title) {
+          cliError(
+            "--title <text> is required when --type adr is used without --slug \u2014 the allocator needs a title to assemble adr-NNN-<kebab-title>",
+            6,
+            {
+              name: "E_VALIDATION",
+              fix: 'Re-run with --title "Adopt Drizzle v1 beta" (or pass --slug adr-042-explicit-name to bypass auto-allocation).'
+            }
+          );
+          process.exit(6);
+        }
         let resolvedFile;
         if (fileArg) {
           const routing = resolveWorktreeRouting2();
@@ -44926,6 +45665,7 @@ var init_docs3 = __esm({
             ...args.labels ? { labels: args.labels } : {},
             ...args["attached-by"] ? { attachedBy: args["attached-by"] } : {},
             ...args.slug ? { slug: args.slug } : {},
+            ...args.title ? { title: args.title } : {},
             ...args.type ? { type: args.type } : {},
             ...args.strict === true ? { strict: true } : {}
           },
@@ -44966,6 +45706,15 @@ var init_docs3 = __esm({
         orderBy: {
           type: "string",
           description: "Sort key: newest (default \u2014 most recent first), sha (ascending hex), slug (alphabetical, slug-less rows last) (T9792)."
+        },
+        // T9922 — MVI record projection opt-out flags (surfaced for --help).
+        verbose: {
+          type: "boolean",
+          description: "Return full attachment records instead of the MVI projection (id + slug + type + kind + sha + size + createdAt). T9922."
+        },
+        full: {
+          type: "boolean",
+          description: "Alias for --verbose. T9922."
         }
       },
       async run({ args }) {
@@ -45032,6 +45781,15 @@ var init_docs3 = __esm({
           type: "positional",
           description: "Attachment ID (att_*) or SHA-256 hex",
           required: true
+        },
+        // T9922 — MVI record projection opt-out flags (surfaced for --help).
+        verbose: {
+          type: "boolean",
+          description: "Return the full attachment metadata block instead of the MVI projection. The byte payload is always returned. T9922."
+        },
+        full: {
+          type: "boolean",
+          description: "Alias for --verbose. T9922."
         }
       },
       async run({ args }) {
@@ -45075,6 +45833,54 @@ var init_docs3 = __esm({
         );
       }
     });
+    supersedeCommandArgs = {
+      oldSlug: {
+        type: "positional",
+        description: "Slug of the doc being replaced",
+        required: true
+      },
+      newSlug: {
+        type: "positional",
+        description: "Slug of the doc that replaces oldSlug",
+        required: true
+      },
+      reason: {
+        type: "string",
+        description: "Optional human-readable reason carried back on the response envelope"
+      }
+    };
+    supersedeCommand = defineCommand({
+      meta: {
+        name: "supersede",
+        description: "Atomically supersede an older doc with a newer one: flips lifecycle_status to 'superseded' on the old row and links both rows via the supersedes/superseded_by FK pointers. All writes commit in a single SQLite transaction."
+      },
+      args: supersedeCommandArgs,
+      async run({ args, rawArgs }) {
+        try {
+          assertKnownFlags(rawArgs, supersedeCommandArgs, "docs supersede");
+        } catch (err) {
+          if (err instanceof UnknownFlagError) {
+            cliError(err.message, 6 /* VALIDATION_ERROR */, { name: "E_VALIDATION" });
+            process.exit(6 /* VALIDATION_ERROR */);
+          }
+          throw err;
+        }
+        const oldSlug = args.oldSlug;
+        const newSlug = args.newSlug;
+        const reason = typeof args.reason === "string" && args.reason.length > 0 ? args.reason : void 0;
+        await dispatchFromCli(
+          "mutate",
+          "docs",
+          "supersede",
+          {
+            oldSlug,
+            newSlug,
+            ...reason !== void 0 ? { reason } : {}
+          },
+          { command: "docs supersede" }
+        );
+      }
+    });
     generateCommand = defineCommand({
       meta: {
         name: "generate",
@@ -45226,6 +46032,102 @@ var init_docs3 = __esm({
         }
       }
     });
+    findCommand3 = defineCommand({
+      meta: {
+        name: "find",
+        description: "Find docs similar to a seed slug via llmtxt/similarity.rankBySimilarity. Pass --similar <slug>; results default to the same DocKind as the seed. Use --all-kinds to rank cross-kind, --threshold to set the minimum cosine score, and --limit to cap the number of returned hits.\n\nNamed arguments:\n  --similar <slug>       Slug of the seed doc to anchor similarity against (required for now)\n  --limit <n>            Maximum number of hits to return (default 10)\n  --threshold <0..1>     Minimum cosine score, hits below are dropped (default 0.5)\n  --all-kinds            Disable the same-kind filter and rank cross-kind\n  --json                 Emit LAFS JSON envelope (default for non-TTY)"
+      },
+      args: {
+        similar: {
+          type: "string",
+          description: "Slug of the seed doc to anchor similarity against"
+        },
+        limit: {
+          type: "string",
+          description: "Maximum number of hits to return (default: 10)"
+        },
+        threshold: {
+          type: "string",
+          description: "Minimum cosine similarity score in [0, 1] (default: 0.5)"
+        },
+        "all-kinds": {
+          type: "boolean",
+          description: "Disable the same-kind filter and rank across every DocKind"
+        },
+        json: {
+          type: "boolean",
+          description: "Emit LAFS JSON envelope instead of human-readable output"
+        }
+      },
+      async run({ args, rawArgs }) {
+        try {
+          assertKnownFlags(rawArgs, findCommand3.args, "docs find");
+        } catch (err) {
+          if (err instanceof UnknownFlagError) {
+            cliError(err.message, 6 /* VALIDATION_ERROR */, {
+              name: err.code,
+              fix: err.fix,
+              alternatives: err.suggestions.map((s) => ({ action: s, command: s })),
+              details: { flag: err.flag, knownFlags: err.knownFlags }
+            });
+            process.exit(6 /* VALIDATION_ERROR */);
+          }
+          throw err;
+        }
+        const similarSlug = typeof args.similar === "string" ? args.similar.trim() : "";
+        if (similarSlug.length === 0) {
+          cliError("--similar <slug> is required", 6 /* VALIDATION_ERROR */, {
+            name: "E_VALIDATION",
+            fix: "Example: `cleo docs find --similar adr-073-above-epic-naming --limit 5`."
+          });
+          process.exit(6 /* VALIDATION_ERROR */);
+        }
+        let limit;
+        if (typeof args.limit === "string") {
+          const parsed = Number.parseInt(args.limit, 10);
+          if (!Number.isFinite(parsed) || parsed <= 0) {
+            cliError(
+              `--limit must be a positive integer (got "${args.limit}")`,
+              6 /* VALIDATION_ERROR */,
+              {
+                name: "E_VALIDATION"
+              }
+            );
+            process.exit(6 /* VALIDATION_ERROR */);
+          }
+          limit = parsed;
+        }
+        let threshold;
+        if (typeof args.threshold === "string") {
+          const parsed = Number.parseFloat(args.threshold);
+          if (!Number.isFinite(parsed) || parsed < 0 || parsed > 1) {
+            cliError(
+              `--threshold must be a number in [0, 1] (got "${args.threshold}")`,
+              6 /* VALIDATION_ERROR */,
+              { name: "E_VALIDATION" }
+            );
+            process.exit(6 /* VALIDATION_ERROR */);
+          }
+          threshold = parsed;
+        }
+        const allKinds = args["all-kinds"] === true;
+        const projectRoot = getProjectRoot38();
+        try {
+          const result = await findSimilarDocs(similarSlug, {
+            ...limit !== void 0 ? { limit } : {},
+            ...threshold !== void 0 ? { threshold } : {},
+            allKinds,
+            projectRoot
+          });
+          cliOutput(result, { command: "docs find", operation: "docs.find" });
+        } catch (err) {
+          const code = err instanceof Error && typeof err.code === "string" ? err.code : "E_DOCS_FIND_FAILED";
+          const message = err instanceof Error ? err.message : String(err);
+          cliError(`docs find failed: ${message}`, 1 /* GENERAL_ERROR */, { name: code });
+          process.exit(1 /* GENERAL_ERROR */);
+        }
+      }
+    });
     mergeCommand = defineCommand({
       meta: {
         name: "merge",
@@ -45284,10 +46186,10 @@ var init_docs3 = __esm({
         }
       }
     });
-    graphCommand = defineCommand({
+    rankCommand = defineCommand({
       meta: {
-        name: "graph",
-        description: "Build a document relationship graph for an entity using llmtxt/graph.buildGraph. Output formats: mermaid (default), dot, json."
+        name: "rank",
+        description: "Rank attachments for an entity by relevance using llmtxt/similarity.rankBySimilarity. Pass --query to use a custom query; otherwise the entity ID anchors the ranking."
       },
       args: {
         for: {
@@ -45295,13 +46197,9 @@ var init_docs3 = __esm({
           description: "Owner entity ID (T###, ses_*, O-*)",
           required: true
         },
-        format: {
-          type: "string",
-          description: "Output format: mermaid | dot | json (default: mermaid)"
-        },
-        out: {
+        query: {
           type: "string",
-          description: "Write graph to this file path"
+          description: "Optional free-text query to rank against (default: owner ID)"
         },
         json: {
           type: "boolean",
@@ -45310,89 +46208,105 @@ var init_docs3 = __esm({
       },
       async run({ args }) {
         const projectRoot = getProjectRoot38();
-        const fmt = args.format ?? "mermaid";
         try {
-          const result = await buildDocsGraph({ ownerId: String(args.for), projectRoot });
-          let output2;
-          if (fmt === "dot") {
-            const dotLines = ["digraph docs {"];
-            for (const node of result.nodes) {
-              dotLines.push(`  "${node.id}" [label="${node.label}"];`);
-            }
-            for (const edge of result.edges) {
-              dotLines.push(`  "${edge.source}" -> "${edge.target}" [label="${edge.relation}"];`);
-            }
-            dotLines.push("}");
-            output2 = dotLines.join("\n");
-          } else if (fmt === "json") {
-            output2 = JSON.stringify(result, null, 2);
-          } else {
-            const lines = ["graph LR"];
-            for (const edge of result.edges) {
-              lines.push(`  ${edge.source} -->|${edge.relation}| ${edge.target}`);
-            }
-            if (result.edges.length === 0) {
-              for (const node of result.nodes) {
-                lines.push(`  ${node.id}["${node.label}"]`);
-              }
-            }
-            output2 = lines.join("\n");
-          }
-          if (typeof args.out === "string" && args.out.length > 0) {
-            const outPath = isAbsolute2(args.out) ? args.out : resolve5(projectRoot, args.out);
-            await mkdir2(dirname8(outPath), { recursive: true });
-            await writeFile2(outPath, output2, "utf8");
-            humanInfo(`Wrote graph to ${outPath}`);
-          }
-          cliOutput(
-            { format: fmt, nodeCount: result.nodes.length, edgeCount: result.edges.length, output: output2 },
-            { command: "docs graph", operation: "docs.graph" }
-          );
+          const result = await rankDocs({
+            ownerId: String(args.for),
+            query: args.query ?? void 0,
+            projectRoot
+          });
+          cliOutput(result, { command: "docs rank", operation: "docs.rank" });
         } catch (err) {
           const message = err instanceof Error ? err.message : String(err);
-          cliError(`docs graph failed: ${message}`, 1 /* GENERAL_ERROR */, {
-            name: "E_DOCS_GRAPH_FAILED"
+          cliError(`docs rank failed: ${message}`, 1 /* GENERAL_ERROR */, {
+            name: "E_DOCS_RANK_FAILED"
           });
           process.exit(1 /* GENERAL_ERROR */);
         }
       }
     });
-    rankCommand = defineCommand({
+    updateCommand = defineCommand({
       meta: {
-        name: "rank",
-        description: "Rank attachments for an entity by relevance using llmtxt/similarity.rankBySimilarity. Pass --query to use a custom query; otherwise the entity ID anchors the ranking."
+        name: "update",
+        description: 'Replace blob content for an existing slug while preserving the slug. Pass --file <path> OR --content <text> (exactly one). Defaults --status to "draft" on every update so explicit `accepted` docs get back-pressured to draft on edit. Audit log entry appended to .cleo/audit/docs-versioning.jsonl (squashed within 5 min).\n\nPositional arguments:\n  <slug>                 Slug of the attachment to update (required)\n\nNamed arguments:\n  --file <path>          Local file containing the new content\n  --content <text>       Inline UTF-8 content (mutually exclusive with --file)\n  --message <text>       One-line summary of the change (audit log)\n  --status <status>      Override lifecycle status \u2014 default "draft"\n  --attached-by <name>   Agent identity for this revision (default "human")'
       },
       args: {
-        for: {
-          type: "string",
-          description: "Owner entity ID (T###, ses_*, O-*)",
+        slug: {
+          type: "positional",
+          description: "Slug of the attachment to update",
           required: true
         },
-        query: {
+        file: {
           type: "string",
-          description: "Optional free-text query to rank against (default: owner ID)"
+          description: "Local file containing the new content"
         },
-        json: {
-          type: "boolean",
-          description: "Emit LAFS JSON envelope"
+        content: {
+          type: "string",
+          description: "Inline UTF-8 content (mutually exclusive with --file)"
+        },
+        message: {
+          type: "string",
+          description: "One-line summary of the change (recorded in the audit log)"
+        },
+        status: {
+          type: "string",
+          description: "Lifecycle status to set on the new row. Valid: draft|proposed|accepted|superseded|archived|deprecated. Default: draft."
+        },
+        "attached-by": {
+          type: "string",
+          description: 'Agent identity that performed the update (default: "human")'
         }
       },
-      async run({ args }) {
-        const projectRoot = getProjectRoot38();
+      async run({ args, rawArgs }) {
         try {
-          const result = await rankDocs({
-            ownerId: String(args.for),
-            query: args.query ?? void 0,
-            projectRoot
-          });
-          cliOutput(result, { command: "docs rank", operation: "docs.rank" });
+          assertKnownFlags(rawArgs, updateCommand.args, "docs update");
         } catch (err) {
-          const message = err instanceof Error ? err.message : String(err);
-          cliError(`docs rank failed: ${message}`, 1 /* GENERAL_ERROR */, {
-            name: "E_DOCS_RANK_FAILED"
+          if (err instanceof UnknownFlagError) {
+            cliError(err.message, 6 /* VALIDATION_ERROR */, {
+              name: err.code,
+              fix: err.fix,
+              alternatives: err.suggestions.map((s) => ({ action: s, command: s })),
+              details: { flag: err.flag, knownFlags: err.knownFlags }
+            });
+            process.exit(6 /* VALIDATION_ERROR */);
+          }
+          throw err;
+        }
+        const slug = String(args.slug);
+        const filePath = typeof args.file === "string" ? args.file : void 0;
+        const inlineContent = typeof args.content === "string" ? args.content : void 0;
+        if (filePath !== void 0 && inlineContent !== void 0) {
+          cliError("--file and --content are mutually exclusive", 6 /* VALIDATION_ERROR */, {
+            name: "E_VALIDATION",
+            fix: "Use `cleo docs update <slug> --file <path>` OR `--content <text>` (not both)."
           });
-          process.exit(1 /* GENERAL_ERROR */);
+          process.exit(6 /* VALIDATION_ERROR */);
+        }
+        if (filePath === void 0 && inlineContent === void 0) {
+          cliError("provide --file <path> OR --content <text>", 6 /* VALIDATION_ERROR */, {
+            name: "E_VALIDATION",
+            fix: 'Example: `cleo docs update my-doc --file ./new.md` OR `cleo docs update my-doc --content "..."`.'
+          });
+          process.exit(6 /* VALIDATION_ERROR */);
         }
+        let resolvedFile;
+        if (filePath !== void 0) {
+          const routing = resolveWorktreeRouting2();
+          resolvedFile = resolveWorktreeFilePath(filePath, routing);
+        }
+        await dispatchFromCli(
+          "mutate",
+          "docs",
+          "update",
+          {
+            slug,
+            ...resolvedFile !== void 0 ? { file: resolvedFile } : {},
+            ...inlineContent !== void 0 ? { content: inlineContent } : {},
+            ...typeof args.message === "string" ? { message: args.message } : {},
+            ...typeof args.status === "string" ? { status: args.status } : {},
+            ...typeof args["attached-by"] === "string" ? { attachedBy: args["attached-by"] } : {}
+          },
+          { command: "docs update" }
+        );
       }
     });
     versionsCommand = defineCommand({
@@ -45901,13 +46815,17 @@ var init_docs3 = __esm({
       },
       subCommands: {
         add: addCommand5,
+        update: updateCommand,
         list: listCommand8,
         fetch: fetchCommand,
         remove: removeCommand2,
+        supersede: supersedeCommand,
         generate: generateCommand,
         export: exportCommand4,
+        find: findCommand3,
         search: searchCommand,
         merge: mergeCommand,
+        // T10164 — DocProvenanceResponse-typed graph (`--root <slug>|<taskId>`).
         graph: graphCommand,
         rank: rankCommand,
         versions: versionsCommand,
@@ -46349,6 +47267,7 @@ var ProgressTracker;
 var init_progress = __esm({
   "packages/cleo/src/cli/progress.ts"() {
     "use strict";
+    init_format_context();
     ProgressTracker = class {
       enabled;
       prefix;
@@ -46365,7 +47284,7 @@ var init_progress = __esm({
        * Start the progress tracker.
        */
       start() {
-        if (!this.enabled) return;
+        if (!this.enabled || isQuiet()) return;
         this.currentStep = 0;
         stderr.write(`
 ${this.prefix}: Starting...
@@ -46375,7 +47294,7 @@ ${this.prefix}: Starting...
        * Update to a specific step.
        */
       step(index, message) {
-        if (!this.enabled) return;
+        if (!this.enabled || isQuiet()) return;
         this.currentStep = index;
         const stepName = this.steps[index] ?? message ?? "Working...";
         const progress = `[${index + 1}/${this.totalSteps}]`;
@@ -46397,7 +47316,7 @@ ${this.prefix}: Starting...
        * one JSON object per CLI invocation (ADR-039 / T927).
        */
       complete(summary) {
-        if (!this.enabled) return;
+        if (!this.enabled || isQuiet()) return;
         if (summary) {
           stderr.write(`
 ${this.prefix}: \u2713 ${summary}
@@ -46414,7 +47333,7 @@ ${this.prefix}: \u2713 Complete
        * Report an error.
        */
       error(message) {
-        if (!this.enabled) return;
+        if (!this.enabled || isQuiet()) return;
         stderr.write(`
 ${this.prefix}: \u2717 ${message}
 
@@ -48129,10 +49048,10 @@ var init_federation = __esm({
 // packages/cleo/src/cli/commands/find.ts
 var find_exports = {};
 __export(find_exports, {
-  findCommand: () => findCommand3
+  findCommand: () => findCommand4
 });
 import { createPage } from "@cleocode/core";
-var findCommand3;
+var findCommand4;
 var init_find = __esm({
   "packages/cleo/src/cli/commands/find.ts"() {
     "use strict";
@@ -48140,7 +49059,7 @@ var init_find = __esm({
     init_dist();
     init_cli();
     init_renderers();
-    findCommand3 = defineCommand({
+    findCommand4 = defineCommand({
       meta: { name: "find", description: "Fuzzy search tasks by title/description" },
       args: {
         query: {
@@ -48159,7 +49078,16 @@ var init_find = __esm({
         limit: { type: "string", description: "Max results (default: 20)" },
         offset: { type: "string", description: "Skip first N results" },
         fields: { type: "string", description: "Comma-separated additional fields to include" },
-        verbose: { type: "boolean", description: "Include all task fields", alias: "v" },
+        verbose: {
+          type: "boolean",
+          description: "Return full task records instead of the MVI projection (id + title + status + key metadata). T9922.",
+          alias: "v"
+        },
+        // T9922 — MVI record projection opt-out alias (surfaced for --help).
+        full: {
+          type: "boolean",
+          description: "Alias for --verbose. T9922."
+        },
         /**
          * Filter by task kind axis (T944/T9072).
          * Values: work | research | experiment | bug | spike | release
@@ -48167,6 +49095,20 @@ var init_find = __esm({
         kind: {
           type: "string",
           description: "Filter by kind axis (work|research|experiment|bug|spike|release) \u2014 T944"
+        },
+        /**
+         * Unified urgency surface (T9905).
+         *
+         * Selects tasks where
+         *   priority IN ('critical','high') OR severity IN ('P0','P1')
+         *
+         * Combines the two orthogonal urgency axes (priority + severity) into a
+         * single filter so agents don't have to query each axis separately.
+         */
+        urgent: {
+          type: "boolean",
+          description: "Surface urgent work across both axes: priority IN (critical,high) OR severity IN (P0,P1) (T9905)",
+          alias: "u"
         }
       },
       async run({ args }) {
@@ -48184,6 +49126,7 @@ var init_find = __esm({
         if (args.fields !== void 0) params["fields"] = args.fields;
         if (args.verbose !== void 0) params["verbose"] = args.verbose;
         if (args.kind !== void 0) params["kind"] = args.kind;
+        if (args.urgent !== void 0) params["urgent"] = args.urgent;
         const response = await dispatchRaw("query", "tasks", "find", params);
         if (!response.success) {
           handleRawError(response, { command: "find", operation: "tasks.find" });
@@ -48540,7 +49483,7 @@ function applyJsonFlag(jsonFlag) {
   }
 }
 var statusCommand9, resolveCommand, depsCommand2, rawCommand, discoverCommand, searchCommand2, augmentCommand, contextCommand2, impactCommand2, impactFullCommand, clustersCommand, flowsCommand, diffCommand, routeMapCommand, shapeCheckCommand, searchCodeCommand, wikiCommand, hotPathsCommand, hotNodesCommand, coldSymbolsCommand, orphansCommand, queryCommand, initCommand, syncCommand4, reconcileCommand, livingFullContextCommand, livingTaskFootprintCommand, livingBrainAnchorsCommand, livingWhyCommand, livingConduitScanCommand, livingCommand, graphCommand2;
-var init_graph2 = __esm({
+var init_graph3 = __esm({
   "packages/cleo/src/cli/commands/graph.ts"() {
     "use strict";
     init_dist();
@@ -49604,11 +50547,12 @@ import { join as join26 } from "node:path";
 import { fileURLToPath as fileURLToPath6 } from "node:url";
 import {
   CleoError as CleoError4,
-  formatError as formatError4,
   getWorkflowTemplatesDir as getCoreWorkflowTemplatesDir,
   initProject as initProject2,
+  pushWarning as pushWarning5,
   scaffoldWorkflows
 } from "@cleocode/core";
+import { getTemplatesByKind } from "@cleocode/core/templates/registry";
 function getGitignoreTemplate() {
   try {
     const thisFile = fileURLToPath6(import.meta.url);
@@ -49626,6 +50570,9 @@ function getGitignoreTemplate() {
 function getWorkflowTemplatesDir2() {
   return getCoreWorkflowTemplatesDir();
 }
+function isWorkflowName(id) {
+  return id === "release-prepare" || id === "release-publish" || id === "release-fanout" || id === "release-rollback";
+}
 var initCommand2;
 var init_init = __esm({
   "packages/cleo/src/cli/commands/init.ts"() {
@@ -49666,7 +50613,11 @@ var init_init = __esm({
         },
         workflows: {
           type: "boolean",
-          description: "Scaffold the release-prepare.yml workflow into .github/workflows/ (T9531).",
+          /**
+           * @deprecated Use `cleo templates install --kind workflow` instead
+           * (T9886 / Saga T9855). Removal target: v2026.7.0. T9888.
+           */
+          description: "[DEPRECATED \u2014 use `cleo templates install --kind workflow`] Scaffold release workflows into .github/workflows/. Will be removed in v2026.7.0.",
           default: false
         },
         "dry-run": {
@@ -49678,11 +50629,23 @@ var init_init = __esm({
       async run({ args }) {
         try {
           if (args.workflows) {
+            pushWarning5({
+              code: "W_INIT_WORKFLOWS_DEPRECATED",
+              message: "[deprecated] cleo init --workflows: use `cleo templates install --kind workflow` instead. This alias will be removed in v2026.7.0.",
+              severity: "warn",
+              deprecated: "cleo init --workflows",
+              replacement: "cleo templates install --kind workflow",
+              removeBy: "v2026.7.0",
+              context: { task: "T9888", saga: "T9855" }
+            });
             const projectRoot = process.cwd();
             const templatesDir = getWorkflowTemplatesDir2();
+            const workflowEntries = getTemplatesByKind("workflow");
+            const templates2 = workflowEntries.map((entry) => entry.id).filter((id) => isWorkflowName(id));
             const result2 = await scaffoldWorkflows({
               projectRoot,
               templatesDir,
+              ...templates2.length > 0 ? { templates: templates2 } : {},
               dryRun: !!args["dry-run"],
               force: !!args.force
             });
@@ -49724,7 +50687,7 @@ var init_init = __esm({
           );
         } catch (err) {
           if (err instanceof CleoError4) {
-            cliError(formatError4(err), err.code, { name: "E_INTERNAL" });
+            cliError(`init failed: ${err.message}`, err.code, { name: "E_INTERNAL" });
             process.exit(err.code);
           }
           throw err;
@@ -50495,6 +51458,20 @@ var init_list3 = __esm({
       "parent-id": {
         type: "string",
         description: "Alias for --parent (legacy parentId compatibility)"
+      },
+      // T9922 — MVI record projection opt-out flags (surfaced for --help).
+      verbose: {
+        type: "boolean",
+        description: "Return full task records instead of the MVI projection (id + title + status + key metadata). T9922."
+      },
+      full: {
+        type: "boolean",
+        description: "Alias for --verbose. T9922."
+      },
+      // T9932 — 1-line-per-record summary render. Global flag; parsed by cli/index.ts.
+      summary: {
+        type: "boolean",
+        description: 'Render each task as a single line "<id> [<status>] <title-truncated-60>". Composes with --output: --output {id|table|count|silent} wins. T9932.'
       }
     };
     listCommand11 = defineCommand({
@@ -50727,7 +51704,7 @@ async function resolveDefaultModel(provider) {
   return profile?.defaultModel ?? IMPLICIT_FALLBACK_MODEL;
 }
 async function runLlmStream(opts) {
-  const stdout = opts.stdout ?? process.stdout;
+  const stdout2 = 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 = {
@@ -50738,7 +51715,7 @@ async function runLlmStream(opts) {
   const stream = session.stream(messages, sendOpts);
   for await (const delta of stream) {
     if (delta.text) {
-      stdout.write(delta.text);
+      stdout2.write(delta.text);
     }
     if (delta.reasoning && opts.showThink) {
       stderr2.write(delta.reasoning);
@@ -51253,7 +52230,7 @@ var llm_exports = {};
 __export(llm_exports, {
   llmCommand: () => llmCommand
 });
-import { pushWarning as pushWarning5 } from "@cleocode/core";
+import { pushWarning as pushWarning6 } from "@cleocode/core";
 async function getListProviders() {
   const { listProviders } = await import(
     /* webpackIgnore: true */
@@ -51384,7 +52361,7 @@ var init_llm3 = __esm({
           apiKey = envValue;
           source = "env";
         } else if (typeof a["api-key"] === "string" && a["api-key"]) {
-          pushWarning5({
+          pushWarning6({
             code: "W_DEPRECATED_FLAG",
             message: API_KEY_FLAG_DEPRECATION,
             deprecated: "--api-key=<value>",
@@ -51813,7 +52790,7 @@ async function readStdin() {
     process.stdin.on("error", reject);
   });
 }
-var showCommand7, listCommand13, findCommand4, statsCommand3, appendCommand, archiveCommand2, manifestCommand;
+var showCommand7, listCommand13, findCommand5, statsCommand3, appendCommand, archiveCommand2, manifestCommand;
 var init_manifest3 = __esm({
   "packages/cleo/src/cli/commands/manifest.ts"() {
     "use strict";
@@ -51899,7 +52876,7 @@ var init_manifest3 = __esm({
         );
       }
     });
-    findCommand4 = defineCommand({
+    findCommand5 = defineCommand({
       meta: {
         name: "find",
         description: "Full-text search manifest entries"
@@ -52108,7 +53085,7 @@ var init_manifest3 = __esm({
       subCommands: {
         show: showCommand7,
         list: listCommand13,
-        find: findCommand4,
+        find: findCommand5,
         stats: statsCommand3,
         append: appendCommand,
         archive: archiveCommand2
@@ -52188,7 +53165,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, importCommand4, doctorCommand3, llmStatusCommand, verifyCommand, pendingVerifyCommand, tierStatsCommand, tierPromoteCommand, tierDemoteCommand, precompactFlushCommand, backfillRunCommand, backfillApproveCommand, backfillRollbackCommand, backfillCommand2, digestCommand, recentCommand, diaryReadCommand, diaryWriteCommand, diaryCommand, watchCommand2, tierCommand, sweepCommand, memoryCommand;
+var storeCommand, findCommand6, 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, importCommand4, 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";
@@ -52280,7 +53257,7 @@ var init_memory3 = __esm({
         }
       }
     });
-    findCommand5 = defineCommand({
+    findCommand6 = defineCommand({
       meta: {
         name: "find",
         description: "Search BRAIN memory (all tables, or filter by --type pattern|learning)"
@@ -53893,7 +54870,7 @@ data: ${JSON.stringify({ ts: item.ts })}
       meta: { name: "memory", description: "BRAIN memory operations (patterns, learnings)" },
       subCommands: {
         store: storeCommand,
-        find: findCommand5,
+        find: findCommand6,
         stats: statsCommand4,
         observe: observeCommand,
         timeline: timelineCommand,
@@ -55375,8 +56352,8 @@ var init_nexus3 = __esm({
             return;
           }
           if (!skipPrompt) {
-            const { createInterface: createInterface4 } = await import("node:readline");
-            const rl = createInterface4({ input: process.stdin, output: process.stdout });
+            const { createInterface: createInterface5 } = await import("node:readline");
+            const rl = createInterface5({ input: process.stdin, output: process.stdout });
             const confirmed = await new Promise((resolve8) => {
               rl.question(
                 `
@@ -56682,7 +57659,9 @@ __export(orchestrate_exports, {
   formatRollupTable: () => formatRollupTable,
   orchestrateCommand: () => orchestrateCommand
 });
+import { execFileSync as execFileSync3 } from "node:child_process";
 import { orchestration } from "@cleocode/core";
+import { BUILD_CONFIG as BUILD_CONFIG2 } from "@cleocode/core/internal";
 function formatRollupTable(rollup) {
   const waves = "waves" in rollup ? rollup.waves : [rollup];
   const lines = [];
@@ -56775,9 +57754,34 @@ var init_orchestrate3 = __esm({
         epic: {
           type: "string",
           description: "Epic ID to scope status to"
+        },
+        "merge-queue": {
+          type: "boolean",
+          description: "Show GitHub merge queue depth instead of epic status (T10445)"
         }
       },
       async run({ args }) {
+        if (args["merge-queue"]) {
+          const repo = BUILD_CONFIG2.repository.fullName;
+          let queueDepth = 0;
+          let estimatedWaitMinutes = 0;
+          let blocked = false;
+          let note = "merge queue not enabled";
+          try {
+            const raw = execFileSync3(
+              "gh",
+              ["api", `repos/${repo}/merge-queue`, "--jq", ".entries | length"],
+              { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"], timeout: 15e3 }
+            );
+            queueDepth = Number(raw.trim()) || 0;
+            estimatedWaitMinutes = queueDepth * 5;
+            blocked = queueDepth > 10;
+            note = queueDepth > 0 ? "active" : "empty";
+          } catch {
+          }
+          cliOutput({ queueDepth, estimatedWaitMinutes, blocked, note }, { command: "orchestrate" });
+          return;
+        }
         await dispatchFromCli(
           "query",
           "orchestrate",
@@ -56947,6 +57951,10 @@ var init_orchestrate3 = __esm({
         scope: {
           type: "string",
           description: "T9807 sparse-checkout scope: directory prefix to check out in the worktree (cone mode). Example: --scope packages/cleo creates a worktree with only that subtree checked out. Reduces disk usage and checkout time for tasks scoped to a single package."
+        },
+        "orchestrator-defer": {
+          type: "boolean",
+          description: "T9214 atomicity waiver: defer worker file-scope declaration to commit time. Tier-1+ orchestrators only \u2014 records auditable atomicity_waiver in the spawn manifest. Bypasses E_ATOMICITY_NO_SCOPE for worker tasks without explicit AC.files."
         }
       },
       async run({ args }) {
@@ -56957,6 +57965,7 @@ var init_orchestrate3 = __esm({
             tier = parsed;
           }
         }
+        const atomicityScope = args["orchestrator-defer"] ? "orchestrator-defer" : void 0;
         await dispatchFromCli(
           "mutate",
           "orchestrate",
@@ -56966,7 +57975,8 @@ var init_orchestrate3 = __esm({
             protocolType: args.protocol,
             tier,
             noWorktree: args["no-worktree"] === true,
-            ...args.scope ? { spawnScope: args.scope } : {}
+            ...args.scope ? { spawnScope: args.scope } : {},
+            ...atomicityScope ? { atomicityScope } : {}
           },
           { command: "orchestrate" }
         );
@@ -57585,7 +58595,7 @@ __export(otel_exports, {
 import {
   CleoError as CleoError5,
   clearOtelData,
-  formatError as formatError5,
+  formatError as formatError4,
   getOtelSessions,
   getOtelSpawns,
   getOtelStatus,
@@ -57606,7 +58616,7 @@ var init_otel = __esm({
           cliOutput(result, { command: "otel" });
         } catch (err) {
           if (err instanceof CleoError5) {
-            cliError(formatError5(err), err.code, { name: "E_INTERNAL" });
+            cliError(formatError4(err), err.code, { name: "E_INTERNAL" });
             process.exit(err.code);
           }
           throw err;
@@ -57621,7 +58631,7 @@ var init_otel = __esm({
           cliOutput(result, { command: "otel" });
         } catch (err) {
           if (err instanceof CleoError5) {
-            cliError(formatError5(err), err.code, { name: "E_INTERNAL" });
+            cliError(formatError4(err), err.code, { name: "E_INTERNAL" });
             process.exit(err.code);
           }
           throw err;
@@ -57649,7 +58659,7 @@ var init_otel = __esm({
           cliOutput(result, { command: "otel" });
         } catch (err) {
           if (err instanceof CleoError5) {
-            cliError(formatError5(err), err.code, { name: "E_INTERNAL" });
+            cliError(formatError4(err), err.code, { name: "E_INTERNAL" });
             process.exit(err.code);
           }
           throw err;
@@ -57677,7 +58687,7 @@ var init_otel = __esm({
           cliOutput(result, { command: "otel" });
         } catch (err) {
           if (err instanceof CleoError5) {
-            cliError(formatError5(err), err.code, { name: "E_INTERNAL" });
+            cliError(formatError4(err), err.code, { name: "E_INTERNAL" });
             process.exit(err.code);
           }
           throw err;
@@ -57705,7 +58715,7 @@ var init_otel = __esm({
           cliOutput(result, { command: "otel" });
         } catch (err) {
           if (err instanceof CleoError5) {
-            cliError(formatError5(err), err.code, { name: "E_INTERNAL" });
+            cliError(formatError4(err), err.code, { name: "E_INTERNAL" });
             process.exit(err.code);
           }
           throw err;
@@ -57720,7 +58730,7 @@ var init_otel = __esm({
           cliOutput(result, { command: "otel" });
         } catch (err) {
           if (err instanceof CleoError5) {
-            cliError(formatError5(err), err.code, { name: "E_INTERNAL" });
+            cliError(formatError4(err), err.code, { name: "E_INTERNAL" });
             process.exit(err.code);
           }
           throw err;
@@ -59829,7 +60839,7 @@ __export(research_exports, {
 function generateResearchId() {
   return `res_${Date.now()}`;
 }
-var addCommand10, showCommand11, listCommand21, pendingCommand2, linkCommand2, updateCommand, statsCommand5, linksCommand, archiveCommand3, manifestCommand2, researchCommand;
+var addCommand10, showCommand11, listCommand21, pendingCommand2, linkCommand2, updateCommand2, statsCommand5, linksCommand, archiveCommand3, manifestCommand2, researchCommand;
 var init_research2 = __esm({
   "packages/cleo/src/cli/commands/research.ts"() {
     "use strict";
@@ -59996,7 +61006,7 @@ var init_research2 = __esm({
         );
       }
     });
-    updateCommand = defineCommand({
+    updateCommand2 = defineCommand({
       meta: { name: "update", description: "Update research findings" },
       args: {
         id: {
@@ -60150,7 +61160,7 @@ var init_research2 = __esm({
         list: listCommand21,
         pending: pendingCommand2,
         link: linkCommand2,
-        update: updateCommand,
+        update: updateCommand2,
         stats: statsCommand5,
         links: linksCommand,
         archive: archiveCommand3,
@@ -61290,7 +62300,7 @@ import { join as join28 } from "node:path";
 import * as readline2 from "node:readline";
 import { promisify } from "node:util";
 import {
-  BUILD_CONFIG as BUILD_CONFIG2,
+  BUILD_CONFIG as BUILD_CONFIG3,
   CleoError as CleoError8,
   checkAllRegisteredProjects as checkAllRegisteredProjects2,
   checkStorageMigration,
@@ -61309,14 +62319,14 @@ async function getCurrentVersion() {
 }
 async function getNpmInstalledVersion() {
   try {
-    const { stdout } = await execAsync("npm", [
+    const { stdout: stdout2 } = await execAsync("npm", [
       "ls",
       "-g",
       "@cleocode/cleo",
       "--depth=0",
       "--json"
     ]);
-    const data = JSON.parse(stdout);
+    const data = JSON.parse(stdout2);
     return data.dependencies?.["@cleocode/cleo"]?.version ?? null;
   } catch {
     return null;
@@ -61324,19 +62334,19 @@ async function getNpmInstalledVersion() {
 }
 async function getDistTagVersion(tag) {
   try {
-    const { stdout } = await execAsync("npm", ["view", `@cleocode/cleo@${tag}`, "version"]);
-    const v = stdout.trim();
+    const { stdout: stdout2 } = await execAsync("npm", ["view", `@cleocode/cleo@${tag}`, "version"]);
+    const v = stdout2.trim();
     return v || null;
   } catch {
     if (tag === "latest") {
       try {
-        const { stdout } = await execAsync("curl", [
+        const { stdout: stdout2 } = await execAsync("curl", [
           "-sL",
           "--max-time",
           "10",
           `https://api.github.com/repos/${GITHUB_REPO}/releases/latest`
         ]);
-        const data = JSON.parse(stdout);
+        const data = JSON.parse(stdout2);
         return data.tag_name?.replace(/^v/, "") ?? null;
       } catch {
         return null;
@@ -61537,7 +62547,7 @@ var init_self_update = __esm({
     init_progress();
     init_renderers();
     execAsync = promisify(execFile);
-    GITHUB_REPO = BUILD_CONFIG2.repository.fullName;
+    GITHUB_REPO = BUILD_CONFIG3.repository.fullName;
     selfUpdateCommand = defineCommand({
       meta: {
         name: "self-update",
@@ -61764,10 +62774,13 @@ var init_self_update = __esm({
 // packages/cleo/src/cli/commands/sentient.ts
 var sentient_exports = {};
 __export(sentient_exports, {
+  __setPromptAcceptExecutionForTest: () => __setPromptAcceptExecutionForTest,
+  promptAcceptExecution: () => promptAcceptExecution,
   sentientCommand: () => sentientCommand
 });
 import { join as join29 } from "node:path";
-import { cwd as processCwd3 } from "node:process";
+import { cwd as processCwd3, stdin, stdout } from "node:process";
+import { createInterface as createInterface3 } from "node:readline/promises";
 import {
   getSentientDaemonStatus as getSentientDaemonStatus2,
   monitorWorkers,
@@ -61778,6 +62791,12 @@ import {
   stopSentientDaemon,
   WORKER_BUDGET_MS
 } from "@cleocode/core/sentient/daemon.js";
+import {
+  appendSentientExecuteAudit,
+  executeFixAction,
+  extractFixActionFromNotesJson,
+  parseFixAction
+} from "@cleocode/core/sentient/execute-action.js";
 import { safeRunProposeTick } from "@cleocode/core/sentient/propose-tick.js";
 import { patchSentientState, readSentientState as readSentientState2 } from "@cleocode/core/sentient/state.js";
 import { safeRunTick } from "@cleocode/core/sentient/tick.js";
@@ -61797,7 +62816,14 @@ function emitFailure3(code, message, _jsonMode, operation) {
   cliError(message, code, { name: code }, operation ? { operation } : void 0);
   process.exit(1);
 }
-var projectArgs2, startSub, stopSub, statusSub, resumeSub, tickSub, proposeListSub, proposeAcceptSub, proposeRejectSub, proposeDiffSub, proposeRunSub, proposeEnableSub, proposeDisableSub, proposeSub, baselineCaptureSub, baselineSub, allowlistListSub, allowlistAddSub, allowlistRemoveSub, allowlistSub, monitorSub, reviewStatusListSub, reviewStatusShowSub, reviewStatusAcceptSub, reviewStatusRejectSub, reviewStatusSub, sentientCommand;
+function __setPromptAcceptExecutionForTest(next) {
+  const prev = promptAcceptExecution;
+  promptAcceptExecution = next;
+  return () => {
+    promptAcceptExecution = prev;
+  };
+}
+var projectArgs2, startSub, stopSub, statusSub, resumeSub, tickSub, proposeListSub, promptAcceptExecution, proposeAcceptSub, proposeRejectSub, proposeDiffSub, proposeRunSub, proposeEnableSub, proposeDisableSub, proposeSub, baselineCaptureSub, baselineSub, allowlistListSub, allowlistAddSub, allowlistRemoveSub, allowlistSub, monitorSub, reviewStatusListSub, reviewStatusShowSub, reviewStatusAcceptSub, reviewStatusRejectSub, reviewStatusSub, sentientCommand;
 var init_sentient3 = __esm({
   "packages/cleo/src/cli/commands/sentient.ts"() {
     "use strict";
@@ -61995,19 +63021,42 @@ Logs:  ${logPath}`
         }
       }
     });
+    promptAcceptExecution = async (fixAction) => {
+      const rl = createInterface3({ input: stdin, output: stdout });
+      try {
+        stdout.write(`[sentient] Proposal accepted. fixAction:
+  $ ${fixAction}
+`);
+        const answer = await rl.question("Execute now? [y/N] ");
+        const normalised = answer.trim().toLowerCase();
+        return normalised === "y" || normalised === "yes";
+      } finally {
+        rl.close();
+      }
+    };
     proposeAcceptSub = defineCommand({
       meta: {
         name: "accept",
-        description: "Accept a proposal \u2014 transition proposed \u2192 pending"
+        description: "Accept a proposal \u2014 transition proposed \u2192 pending, optionally execute its fixAction"
       },
       args: {
         ...projectArgs2,
-        id: { type: "positional", description: "Proposal task ID", required: true }
+        id: { type: "positional", description: "Proposal task ID", required: true },
+        execute: {
+          type: "boolean",
+          description: "Execute proposal.fixAction without prompting"
+        },
+        "no-execute": {
+          type: "boolean",
+          description: "Skip fixAction execution even if the proposal carries one"
+        }
       },
       async run({ args }) {
         const projectRoot = resolveProjectRoot6(args.project);
         const jsonMode = args.json === true;
         const id = args.id;
+        const forceExecute = args.execute === true;
+        const skipExecute = args["no-execute"] === true;
         try {
           const { getDb: getDb3 } = await import("@cleocode/core/store/sqlite.js");
           const { tasks } = await import("@cleocode/core/store/tasks-schema");
@@ -62034,10 +63083,54 @@ Logs:  ${logPath}`
               proposalsAccepted: state.tier2Stats.proposalsAccepted + 1
             }
           });
+          const fixAction = extractFixActionFromNotesJson(existing.notesJson ?? null);
+          let shouldExecute = false;
+          if (fixAction && !skipExecute) {
+            if (forceExecute) {
+              shouldExecute = true;
+            } else {
+              shouldExecute = await promptAcceptExecution(fixAction);
+            }
+          }
+          if (!shouldExecute) {
+            emitSuccess2(
+              {
+                id,
+                status: "pending",
+                acceptedAt: now,
+                executed: false,
+                fixAction: fixAction ?? null
+              },
+              jsonMode,
+              `Proposal ${id} accepted \u2192 pending`
+            );
+            return;
+          }
+          const parsed = parseFixAction(fixAction);
+          if (!parsed.ok) {
+            emitFailure3(parsed.code, parsed.reason, jsonMode);
+            return;
+          }
+          const result = await executeFixAction(parsed, { cwd: projectRoot });
+          await appendSentientExecuteAudit(projectRoot, {
+            proposalId: id,
+            fixAction,
+            exitCode: result.exitCode,
+            durationMs: result.durationMs,
+            timestamp: (/* @__PURE__ */ new Date()).toISOString()
+          });
           emitSuccess2(
-            { id, status: "pending", acceptedAt: now },
+            {
+              id,
+              status: "pending",
+              acceptedAt: now,
+              executed: true,
+              exitCode: result.exitCode,
+              stderrSnippet: result.stderrSnippet,
+              fixAction
+            },
             jsonMode,
-            `Proposal ${id} accepted \u2192 pending`
+            `Proposal ${id} accepted \u2192 pending (fixAction exit=${result.exitCode})`
           );
         } catch (err) {
           const message = err instanceof Error ? err.message : String(err);
@@ -62833,9 +63926,9 @@ async function promptOwnerAuthPassword(sessionName) {
     );
     return null;
   }
-  const { createInterface: createInterface4 } = await import("node:readline");
+  const { createInterface: createInterface5 } = await import("node:readline");
   const { deriveOwnerAuthToken } = await import("@cleocode/core/internal");
-  const rl = createInterface4({
+  const rl = createInterface5({
     input: process.stdin,
     output: process.stderr,
     terminal: true
@@ -62876,7 +63969,7 @@ async function promptOwnerAuthPassword(sessionName) {
   const token = deriveOwnerAuthToken(sessionName, password);
   return token;
 }
-var startCommand7, endCommand, handoffCommand2, statusCommand14, resumeCommand2, findCommand6, listCommand23, gcCommand2, showCommand13, driftCommand, contextDriftCommand, suspendCommand, recordAssumptionCommand, recordDecisionCommand, decisionLogCommand, adoptCommand, lintCommand, sessionCommand;
+var startCommand7, endCommand, handoffCommand2, statusCommand14, resumeCommand2, findCommand7, listCommand23, gcCommand2, showCommand13, driftCommand, contextDriftCommand, suspendCommand, recordAssumptionCommand, recordDecisionCommand, decisionLogCommand, adoptCommand, lintCommand, sessionCommand;
 var init_session4 = __esm({
   "packages/cleo/src/cli/commands/session.ts"() {
     "use strict";
@@ -63106,7 +64199,7 @@ var init_session4 = __esm({
         );
       }
     });
-    findCommand6 = defineCommand({
+    findCommand7 = defineCommand({
       meta: {
         name: "find",
         description: "Find sessions (lightweight discovery \u2014 minimal fields, low context cost)"
@@ -63469,7 +64562,7 @@ var init_session4 = __esm({
         handoff: handoffCommand2,
         status: statusCommand14,
         resume: resumeCommand2,
-        find: findCommand6,
+        find: findCommand7,
         list: listCommand23,
         gc: gcCommand2,
         show: showCommand13,
@@ -63954,9 +65047,27 @@ var init_show2 = __esm({
     showCommand14 = defineCommand({
       meta: {
         name: "show",
-        description: "Show full task details by ID (returns complete task record with metadata, verification, lifecycle)"
+        description: "Show task details by ID. MVI-projected (id + title + status + key metadata) by default; pass --verbose / --full to receive the complete record with description, acceptance, verification, evidence, etc. (T9922)"
+      },
+      args: {
+        ...paramsToCittyArgs(getOperationParams("query", "tasks", "show")),
+        // T9922 — MVI record projection opt-out flags. The global parser in
+        // cli/index.ts reads these too; the declarations here surface them in
+        // `cleo show --help` and document the contract for agents.
+        verbose: {
+          type: "boolean",
+          description: "Return the full task record (description, acceptance, verification, evidence) instead of the MVI projection. T9922."
+        },
+        full: {
+          type: "boolean",
+          description: "Alias for --verbose. T9922."
+        },
+        // T9932 — 1-line summary render. Global flag; parsed by cli/index.ts.
+        summary: {
+          type: "boolean",
+          description: 'Render the task as a single line "<id> [<status>] <title-truncated-60>". Composes with --output: --output {id|table|count|silent} wins. T9932.'
+        }
       },
-      args: paramsToCittyArgs(getOperationParams("query", "tasks", "show")),
       async run({ args }) {
         await dispatchFromCli(
           "query",
@@ -64078,7 +65189,7 @@ function buildSkillsDoctorAdoptAdapters() {
     }
   };
 }
-var listCommand24, searchCommand4, findCommand7, validateCommand8, infoCommand, installCommand3, uninstallCommand2, enableCommand2, disableCommand2, refreshCommand, dispatchCommand, catalogCommand, precedenceCommand, depsCommand4, doctorBridgeCommand, doctorAdoptOrphansCommand, statsCommand6, importHermesCommand, migrateCommand2, pruneTelemetryCommand, spawnProvidersCommand, doctorDiagnoseCommand, doctorCommand4, proposePatchCommand, skillsCommand2;
+var listCommand24, searchCommand4, findCommand8, validateCommand8, infoCommand, installCommand3, uninstallCommand2, enableCommand2, disableCommand2, refreshCommand, dispatchCommand, catalogCommand, precedenceCommand, depsCommand4, doctorBridgeCommand, doctorAdoptOrphansCommand, statsCommand6, importHermesCommand, migrateCommand2, pruneTelemetryCommand, spawnProvidersCommand, doctorDiagnoseCommand, doctorCommand4, proposePatchCommand, skillsCommand2;
 var init_skills2 = __esm({
   "packages/cleo/src/cli/commands/skills.ts"() {
     "use strict";
@@ -64136,7 +65247,7 @@ var init_skills2 = __esm({
         );
       }
     });
-    findCommand7 = defineCommand({
+    findCommand8 = defineCommand({
       meta: {
         name: "find",
         description: "Federated skill search across local, canonical, and federation peers"
@@ -64821,7 +65932,7 @@ var init_skills2 = __esm({
       subCommands: {
         list: listCommand24,
         search: searchCommand4,
-        find: findCommand7,
+        find: findCommand8,
         validate: validateCommand8,
         info: infoCommand,
         install: installCommand3,
@@ -66139,7 +67250,7 @@ var init_install = __esm({
 });
 
 // packages/cleo/src/cli/commands/templates/list.ts
-import { getTemplateManifest, getTemplatesByKind } from "@cleocode/core/templates/registry";
+import { getTemplateManifest, getTemplatesByKind as getTemplatesByKind2 } from "@cleocode/core/templates/registry";
 function parseTemplateKind(raw) {
   if (raw === void 0 || raw === "") return null;
   return TEMPLATE_KINDS.includes(raw) ? raw : null;
@@ -66178,7 +67289,7 @@ var init_list4 = __esm({
           process.exit(2 /* INVALID_INPUT */);
           return;
         }
-        const entries = kind === null ? getTemplateManifest() : getTemplatesByKind(kind);
+        const entries = kind === null ? getTemplateManifest() : getTemplatesByKind2(kind);
         const result = { kind, entries };
         cliOutput(result, {
           command: "templates-list",
@@ -67286,7 +68397,7 @@ var init_transcript = __esm({
 // packages/cleo/src/cli/commands/update.ts
 var update_exports = {};
 __export(update_exports, {
-  updateCommand: () => updateCommand2
+  updateCommand: () => updateCommand3
 });
 import {
   appendSignedSeverityAttestation as appendSignedSeverityAttestation2,
@@ -67297,7 +68408,7 @@ import {
   TASK_PIPELINE_STAGES,
   validateOperationInput as validateOperationInput3
 } from "@cleocode/core";
-var updateCommand2;
+var updateCommand3;
 var init_update = __esm({
   "packages/cleo/src/cli/commands/update.ts"() {
     "use strict";
@@ -67306,7 +68417,7 @@ var init_update = __esm({
     init_cli();
     init_collect_input();
     init_renderers();
-    updateCommand2 = defineCommand({
+    updateCommand3 = defineCommand({
       meta: {
         name: "update",
         description: "Update a task. Safe under concurrent invocation \u2014 retries on SQLITE_BUSY up to 4 attempts (gh#391)."
@@ -67350,7 +68461,7 @@ var init_update = __esm({
         },
         priority: {
           type: "string",
-          description: "New priority (critical|high|medium|low)",
+          description: "New priority (critical|high|medium|low). Orthogonal to --severity \u2014 see `cleo find --urgent` for the unified surface (T9905).",
           alias: "p"
         },
         type: {
@@ -67474,7 +68585,7 @@ var init_update = __esm({
          */
         severity: {
           type: "string",
-          description: "Severity level (P0|P1|P2|P3) \u2014 valid for any --role (T9073). Orthogonal to priority. Appends signed attestation."
+          description: "Severity level (P0|P1|P2|P3) \u2014 valid for any --kind (T9073). Orthogonal to --priority \u2014 does NOT auto-map (a P0 with priority=medium stays medium). Use `cleo find --urgent` for the unified surface (T9905). Appends signed attestation."
         },
         /**
          * Operator-supplied justification required to override the
@@ -68060,10 +69171,10 @@ var web_exports = {};
 __export(web_exports, {
   webCommand: () => webCommand
 });
-import { execFileSync as execFileSync3, spawn as spawn3 } from "node:child_process";
+import { execFileSync as execFileSync4, spawn as spawn3 } from "node:child_process";
 import { mkdir as mkdir4, open, readFile as readFile7, rm, stat as stat2, writeFile as writeFile3 } from "node:fs/promises";
 import { join as join34 } from "node:path";
-import { CleoError as CleoError11, formatError as formatError6, getCleoHome as getCleoHome5 } from "@cleocode/core";
+import { CleoError as CleoError11, formatError as formatError5, getCleoHome as getCleoHome5 } from "@cleocode/core";
 function getWebPaths() {
   const cleoHome = getCleoHome5();
   return {
@@ -68124,7 +69235,7 @@ async function startWebServer(port, host) {
     await stat2(webIndexPath);
   } catch {
     try {
-      execFileSync3("pnpm", ["--filter", "@cleocode/studio", "run", "build"], {
+      execFileSync4("pnpm", ["--filter", "@cleocode/studio", "run", "build"], {
         cwd: projectRoot,
         stdio: "ignore"
       });
@@ -68216,7 +69327,7 @@ var init_web = __esm({
           await startWebServer(Number.parseInt(args.port, 10), args.host);
         } catch (err) {
           if (err instanceof CleoError11) {
-            console.error(formatError6(err));
+            console.error(formatError5(err));
             process.exit(err.code);
           }
           throw err;
@@ -68260,7 +69371,7 @@ var init_web = __esm({
           cliOutput({ stopped: true }, { command: "web", message: "CLEO Web UI stopped" });
         } catch (err) {
           if (err instanceof CleoError11) {
-            console.error(formatError6(err));
+            console.error(formatError5(err));
             process.exit(err.code);
           }
           throw err;
@@ -68313,7 +69424,7 @@ var init_web = __esm({
           await startWebServer(Number.parseInt(args.port, 10), args.host);
         } catch (err) {
           if (err instanceof CleoError11) {
-            console.error(formatError6(err));
+            console.error(formatError5(err));
             process.exit(err.code);
           }
           throw err;
@@ -68328,7 +69439,7 @@ var init_web = __esm({
           cliOutput(status, { command: "web" });
         } catch (err) {
           if (err instanceof CleoError11) {
-            console.error(formatError6(err));
+            console.error(formatError5(err));
             process.exit(err.code);
           }
           throw err;
@@ -68361,7 +69472,7 @@ var init_web = __esm({
           cliOutput({ url }, { command: "web", message: `Open browser to: ${url}` });
         } catch (err) {
           if (err instanceof CleoError11) {
-            console.error(formatError6(err));
+            console.error(formatError5(err));
             process.exit(err.code);
           }
           throw err;
@@ -69126,7 +70237,7 @@ var COMMAND_MANIFEST = [
     exportName: "graphCommand",
     name: "graph",
     description: "Project-scoped code intelligence: symbol graph, impact analysis, clusters, flows",
-    load: async () => (await Promise.resolve().then(() => (init_graph2(), graph_exports))).graphCommand
+    load: async () => (await Promise.resolve().then(() => (init_graph3(), graph_exports))).graphCommand
   },
   {
     exportName: "historyCommand",
@@ -69461,7 +70572,7 @@ var COMMAND_MANIFEST = [
   {
     exportName: "showCommand",
     name: "show",
-    description: "Show full task details by ID (returns complete task record with metadata, verification, lifecycle)",
+    description: "Show task details by ID. MVI-projected (id + title + status + key metadata) by default; pass --verbose / --full to receive the complete record with description, acceptance, verification, evidence, etc. (T9922)",
     load: async () => (await Promise.resolve().then(() => (init_show2(), show_exports))).showCommand
   },
   {
@@ -69819,6 +70930,10 @@ function resolveFormat(opts, defaults) {
   return resolveOutputFormat(input2);
 }
 
+// packages/cleo/src/cli/index.ts
+init_output_context();
+init_projection_context();
+
 // packages/cleo/src/cli/resolve-subcommand.ts
 async function resolveLazyValue(input2) {
   if (typeof input2 === "function") {
@@ -69846,6 +70961,7 @@ async function resolveSubCommandForHelp(cmd, rawArgs) {
 }
 
 // packages/cleo/src/cli/index.ts
+init_summary_context();
 {
   const [major] = process.versions.node.split(".").map(Number);
   if (typeof major !== "number" || major < 24) {
@@ -69904,6 +71020,9 @@ alias("pipeline", "phaseCommand");
 async function startCli() {
   const argv = process.argv.slice(2);
   const rawOpts = {};
+  let verboseFlag = false;
+  let outputModeRaw;
+  let summaryFlag = false;
   for (let i = 0; i < argv.length; i++) {
     const arg = argv[i];
     if (arg === "--json") rawOpts["json"] = true;
@@ -69912,6 +71031,9 @@ async function startCli() {
     else if (arg === "--field" && i + 1 < argv.length) rawOpts["field"] = argv[++i];
     else if (arg === "--fields" && i + 1 < argv.length) rawOpts["fields"] = argv[++i];
     else if (arg === "--mvi" && i + 1 < argv.length) rawOpts["mvi"] = argv[++i];
+    else if (arg === "--verbose" || arg === "--full") verboseFlag = true;
+    else if (arg === "--output" && i + 1 < argv.length) outputModeRaw = argv[++i];
+    else if (arg === "--summary") summaryFlag = true;
   }
   const formatResolution = resolveFormat(rawOpts);
   setFormatContext(formatResolution);
@@ -69920,6 +71042,19 @@ async function startCli() {
     fieldResolution.mvi = "minimal";
   }
   setFieldContext(fieldResolution);
+  setProjectionOptOut(verboseFlag || formatResolution.format === "human");
+  if (outputModeRaw !== void 0) {
+    if (!isOutputMode(outputModeRaw)) {
+      process.stderr.write(
+        `Error: invalid --output mode "${outputModeRaw}"
+Valid modes: envelope, id, table, count, silent
+`
+      );
+      process.exit(2);
+    }
+    setOutputMode(outputModeRaw);
+  }
+  setSummaryMode(summaryFlag);
   const isHelpOrVersion = argv.length === 0 || argv[0] === "--help" || argv[0] === "-h" || argv[0] === "--version" || argv[0] === "-V" || argv[0] === "help";
   if (argv[0] === "--version" || argv[0] === "-V") {
     const { cliOutput: cliOutput2 } = await Promise.resolve().then(() => (init_renderers(), renderers_exports));
@@ -69927,6 +71062,10 @@ async function startCli() {
     return;
   }
   if (!isHelpOrVersion) {
+    if (rawOpts["quiet"] === true) {
+      const { setLoggerQuiet } = await import("@cleocode/core/internal");
+      setLoggerQuiet(true);
+    }
     await runStartupMaintenance();
   }
   if (!isHelpOrVersion) {