@cleocode/cleo 2026.5.96 → 2026.5.97

package/dist/cli/index.js

@@ -1591,6 +1591,13 @@ var init_credentials = __esm({
   }
 });
 
+// packages/contracts/src/dispatch/identity.ts
+var init_identity = __esm({
+  "packages/contracts/src/dispatch/identity.ts"() {
+    "use strict";
+  }
+});
+
 // packages/contracts/src/docs-taxonomy.ts
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
@@ -1982,6 +1989,13 @@ var init_engine_result = __esm({
   }
 });
 
+// packages/contracts/src/enums.ts
+var init_enums = __esm({
+  "packages/contracts/src/enums.ts"() {
+    "use strict";
+  }
+});
+
 // packages/contracts/src/exit-codes.ts
 var ExitCode;
 var init_exit_codes = __esm({
@@ -2198,6 +2212,13 @@ var init_plugin_llm = __esm({
   }
 });
 
+// packages/contracts/src/memory/observe.ts
+var init_observe = __esm({
+  "packages/contracts/src/memory/observe.ts"() {
+    "use strict";
+  }
+});
+
 // packages/contracts/src/operations/admin.ts
 var init_admin = __esm({
   "packages/contracts/src/operations/admin.ts"() {
@@ -2234,6 +2255,13 @@ var init_docs = __esm({
   }
 });
 
+// packages/contracts/src/operations/focus.ts
+var init_focus = __esm({
+  "packages/contracts/src/operations/focus.ts"() {
+    "use strict";
+  }
+});
+
 // packages/contracts/src/operations/intelligence.ts
 var init_intelligence = __esm({
   "packages/contracts/src/operations/intelligence.ts"() {
@@ -2424,6 +2452,7 @@ var init_operations = __esm({
     init_conduit();
     init_dialectic();
     init_docs();
+    init_focus();
     init_intelligence();
     init_issues();
     init_lifecycle();
@@ -3387,8 +3416,10 @@ var init_src2 = __esm({
     init_changesets();
     init_cli_category();
     init_credentials();
+    init_identity();
     init_docs_taxonomy();
     init_engine_result();
+    init_enums();
     init_errors();
     init_evidence_record_schema();
     init_exit_codes();
@@ -3396,6 +3427,7 @@ var init_src2 = __esm({
     init_graph();
     init_lafs();
     init_plugin_llm();
+    init_observe();
     init_operations();
     init_nexus_scope_map();
     init_params();
@@ -8682,6 +8714,25 @@ var init_registry = __esm({
         requiredParams: [],
         params: []
       },
+      // T9975 — per-agent session isolation: adopt rebinds env to a specific session.
+      {
+        gateway: "mutate",
+        domain: "session",
+        operation: "adopt",
+        description: "session.adopt \u2014 rebind env to a specific session for multi-agent isolation (T9975)",
+        tier: 0,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: [],
+        params: [
+          {
+            name: "sessionId",
+            type: "string",
+            required: true,
+            description: "Session ID to adopt"
+          }
+        ]
+      },
       // session.context.inject moved to admin.context.inject (T5615)
       {
         gateway: "mutate",
@@ -13628,6 +13679,102 @@ var init_registry = __esm({
             description: "Task ID whose worktree (branch task/T<id>) to unlock"
           }
         ]
+      },
+      // T9804 — Claude Code Agent isolation:worktree bridge (adopt)
+      {
+        gateway: "mutate",
+        domain: "worktree",
+        operation: "adopt",
+        description: "worktree.adopt (mutate) \u2014 register an externally-created worktree (e.g. Claude Code Agent isolation:worktree) in the CLEO SSoT. Writes to .cleo/worktrees.json sentinel index and appends audit entry (T9804).",
+        tier: 1,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: ["worktreePath"],
+        params: [
+          {
+            name: "worktreePath",
+            type: "string",
+            required: true,
+            description: "Absolute or relative path to the worktree directory to adopt"
+          },
+          {
+            name: "source",
+            type: "string",
+            required: false,
+            description: "Source classification (claude-agent | manual | adopted). Inferred from path when omitted."
+          },
+          {
+            name: "taskId",
+            type: "string",
+            required: false,
+            description: "Task ID to associate with this worktree. Extracted from branch name when omitted."
+          },
+          {
+            name: "actor",
+            type: "string",
+            required: false,
+            description: "Override actor name written to the audit log."
+          }
+        ]
+      },
+      // T9805 — Explicit single-worktree destruction with sentinel + audit update
+      {
+        gateway: "mutate",
+        domain: "worktree",
+        operation: "destroy",
+        description: "worktree.destroy (mutate) \u2014 explicitly destroy the XDG worktree for a task, remove its sentinel index entry, and append an audit-log row to .cleo/audit/worktree-lifecycle.jsonl (T9805 AC1).",
+        tier: 1,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: ["taskId"],
+        params: [
+          {
+            name: "taskId",
+            type: "string",
+            required: true,
+            description: "Task ID whose XDG worktree should be destroyed (e.g. T9805).",
+            cli: { positional: true }
+          },
+          {
+            name: "force",
+            type: "boolean",
+            required: false,
+            description: "Force removal even when the worktree has uncommitted changes. Default: false."
+          },
+          {
+            name: "deleteBranch",
+            type: "boolean",
+            required: false,
+            description: "Delete the task branch (task/T<id>) after removing the worktree. Default: true."
+          },
+          {
+            name: "reason",
+            type: "string",
+            required: false,
+            description: "Free-form reason recorded in the audit log (e.g. pr-merged, manual, idle-timeout). Default: manual."
+          }
+        ]
+      },
+      // ---------------------------------------------------------------------------
+      // T9973 — focus domain: single-envelope task orientation (8 calls → 1)
+      // ---------------------------------------------------------------------------
+      {
+        gateway: "query",
+        domain: "focus",
+        operation: "show",
+        description: "focus.show (query) \u2014 single-envelope orientation for a task, epic, or saga. Aggregates identity + scope + members + blockers + readyWave + attachedDocs + recentActivity + brainContext into \u2264 1 500 tokens.",
+        tier: 0,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: ["id"],
+        params: [
+          {
+            name: "id",
+            type: "string",
+            required: true,
+            description: "Task, Epic, or Saga ID to orient on (e.g. T9973, T9831)"
+          }
+        ]
       }
     ];
     counts = getCounts();
@@ -13989,6 +14136,7 @@ __export(engine_exports, {
   releaseRollbackFull: () => releaseRollbackFull,
   releaseShow: () => releaseShow,
   releaseTag: () => releaseTag,
+  sessionAdopt: () => sessionAdopt,
   sessionArchive: () => sessionArchive,
   sessionBriefing: () => sessionBriefing,
   sessionChainShow: () => sessionChainShow,
@@ -14214,6 +14362,7 @@ import {
   releaseRollbackFull,
   releaseShow,
   releaseTag,
+  sessionAdopt,
   sessionArchive,
   sessionBriefing,
   sessionChainShow,
@@ -17620,6 +17769,7 @@ import {
   generateDocsLlmsTxt,
   getCleoDirAbsolute,
   getProjectRoot as getProjectRoot5,
+  memoryObserve as memoryObserve2,
   resolveAttachmentBackend,
   SlugCollisionError
 } from "@cleocode/core/internal";
@@ -17716,6 +17866,23 @@ function compareByOrderBy(orderBy) {
   }
   return (a, b) => b.createdAt.localeCompare(a.createdAt);
 }
+function docObservationTitle(slug, attachmentId) {
+  return `Doc attached: ${slug ?? attachmentId}`;
+}
+function emitDocAttachmentObservation(payload, projectRoot) {
+  const title = docObservationTitle(payload.slug, payload.attachmentId);
+  const narrative = JSON.stringify(payload);
+  memoryObserve2(
+    {
+      text: narrative,
+      title,
+      type: "feature",
+      sourceType: "manual"
+    },
+    projectRoot
+  ).catch(() => {
+  });
+}
 function docsEnvelopeToResponse(envelope, gateway, operation, startTime) {
   if (!envelope.success) {
     return {
@@ -18187,6 +18354,15 @@ var init_docs2 = __esm({
             )
           ).catch(() => {
           });
+          const filePayload = {
+            kind: "doc-attachment",
+            attachmentId: meta.id,
+            ownerId,
+            addedAt: (/* @__PURE__ */ new Date()).toISOString(),
+            ...slug !== void 0 ? { slug } : {},
+            ...type2 !== void 0 ? { type: type2 } : {}
+          };
+          emitDocAttachmentObservation(filePayload, getProjectRoot5());
           return lafsSuccess(
             {
               attachmentId: meta.id,
@@ -18240,6 +18416,15 @@ var init_docs2 = __esm({
           ).catch(() => {
           });
           const backend = "legacy";
+          const urlPayload = {
+            kind: "doc-attachment",
+            attachmentId: meta.id,
+            ownerId,
+            addedAt: (/* @__PURE__ */ new Date()).toISOString(),
+            ...slug !== void 0 ? { slug } : {},
+            ...type2 !== void 0 ? { type: type2 } : {}
+          };
+          emitDocAttachmentObservation(urlPayload, getProjectRoot5());
           return lafsSuccess(
             {
               attachmentId: meta.id,
@@ -18379,8 +18564,272 @@ var init_docs2 = __esm({
   }
 });
 
+// packages/cleo/src/dispatch/domains/focus.ts
+import { execSync as execSync2 } from "node:child_process";
+import { getProjectRoot as getProjectRoot6 } from "@cleocode/core";
+import {
+  createAttachmentStore as createAttachmentStore2,
+  memoryFind as memoryFind2,
+  orchestrateReady as orchestrateReady2,
+  taskRelates as taskRelates2,
+  taskShow as taskShow2
+} from "@cleocode/core/internal";
+function roughTokenCount(value) {
+  try {
+    return Math.ceil(JSON.stringify(value).length / 4);
+  } catch {
+    return 0;
+  }
+}
+function fetchRecentActivity(taskId, projectRoot) {
+  try {
+    const raw = execSync2(`git log --grep="${taskId}" --pretty=format:"%H	%s	%aI" -n 5`, {
+      encoding: "utf8",
+      stdio: ["pipe", "pipe", "pipe"],
+      cwd: projectRoot
+    });
+    return raw.trim().split("\n").filter(Boolean).map((line) => {
+      const parts = line.split("	");
+      return {
+        commitSha: parts[0] ?? "",
+        message: parts[1] ?? "",
+        date: parts[2] ?? ""
+      };
+    }).filter((c) => c.commitSha !== "");
+  } catch {
+    return [];
+  }
+}
+async function fetchAttachedDocs(projectRoot, taskId) {
+  try {
+    const store = createAttachmentStore2();
+    const metas = await store.listByOwner("task", taskId, projectRoot);
+    const entries = [];
+    for (const meta of metas) {
+      const extras = await store.getExtras(meta.id, projectRoot);
+      entries.push({
+        attachmentId: meta.id,
+        kind: meta.attachment.kind,
+        ...extras?.slug != null ? { slug: extras.slug } : {},
+        ...extras?.type != null ? { type: extras.type } : {}
+      });
+    }
+    return entries;
+  } catch {
+    return [];
+  }
+}
+async function fetchBrainContext(taskId) {
+  try {
+    const [obsResult, decResult, lrnResult] = await Promise.allSettled([
+      memoryFind2({ query: taskId, limit: 3, tables: ["observations"] }),
+      memoryFind2({ query: taskId, limit: 3, tables: ["decisions"] }),
+      memoryFind2({ query: taskId, limit: 3, tables: ["learnings"] })
+    ]);
+    const toHits = (r) => {
+      if (r.status !== "fulfilled" || !r.value.success) return [];
+      const data = r.value.data;
+      return (data?.results ?? []).slice(0, 3);
+    };
+    return {
+      observations: toHits(obsResult),
+      learnings: toHits(lrnResult),
+      decisions: toHits(decResult)
+    };
+  } catch {
+    return void 0;
+  }
+}
+async function fetchSagaMembersWithTitles(projectRoot, sagaId) {
+  try {
+    const relResult = await taskRelates2(projectRoot, sagaId);
+    if (!relResult.success) return [];
+    const memberIds = (relResult.data?.relations ?? []).filter((r) => r.type === "groups").map((r) => r.taskId);
+    if (memberIds.length === 0) return [];
+    const showResults = await Promise.allSettled(
+      memberIds.map((epicId) => taskShow2(projectRoot, epicId))
+    );
+    return showResults.map((r, i) => {
+      const epicId = memberIds[i] ?? "";
+      if (r.status !== "fulfilled" || !r.value.success) {
+        return { epicId, title: epicId, status: "unknown" };
+      }
+      const t = r.value.data.task;
+      return { epicId: t.id, title: t.title, status: t.status };
+    }).filter((m) => m.epicId !== "");
+  } catch {
+    return [];
+  }
+}
+async function buildFocusEnvelope(id, projectRoot) {
+  const showResult = await taskShow2(projectRoot, id);
+  if (!showResult.success) {
+    return {
+      error: {
+        code: showResult.error?.code?.toString() ?? "E_NOT_FOUND",
+        message: showResult.error?.message ?? `Task not found: ${id}`
+      }
+    };
+  }
+  const task = showResult.data.task;
+  const labels = Array.isArray(task.labels) ? task.labels : [];
+  const isSaga = labels.includes("saga");
+  const isEpic = task.type === "epic" && !isSaga;
+  const entityType = isSaga ? "saga" : isEpic ? "epic" : "task";
+  const identity = {
+    id: task.id,
+    title: task.title,
+    type: entityType,
+    status: task.status,
+    ...task.parentId != null ? { parentId: task.parentId } : {}
+  };
+  const scope = {};
+  if (entityType === "task") {
+    scope.taskId = task.id;
+    if (task.parentId) scope.epicId = task.parentId;
+  } else if (entityType === "epic") {
+    scope.epicId = task.id;
+  } else {
+    scope.sagaId = task.id;
+  }
+  const blockers = [];
+  const explicitBlockers = Array.isArray(task.blockedBy) ? task.blockedBy : [];
+  const unresolvedDepends = [];
+  if (explicitBlockers.length === 0 && Array.isArray(task.depends)) {
+    for (const depId of task.depends) {
+      const dRes = await taskShow2(projectRoot, depId).catch(() => null);
+      if (dRes?.success && dRes.data) {
+        const s = dRes.data.task.status;
+        if (s !== "done" && s !== "cancelled") {
+          unresolvedDepends.push(depId);
+          blockers.push({
+            id: depId,
+            title: dRes.data.task.title,
+            reason: `dependency not resolved (status: ${s})`
+          });
+        }
+      }
+    }
+  }
+  if (explicitBlockers.length > 0) {
+    await Promise.allSettled(
+      explicitBlockers.map(async (bid) => {
+        const bRes = await taskShow2(projectRoot, bid).catch(() => null);
+        blockers.push({
+          id: bid,
+          title: bRes?.success ? bRes.data?.task.title ?? bid : bid,
+          reason: bRes?.success ? bRes.data?.task.status ?? "unknown" : "unknown"
+        });
+      })
+    );
+  }
+  const epicIdForReady = entityType === "epic" ? task.id : entityType === "task" && task.parentId ? task.parentId : void 0;
+  const [sagaMembersResult, readyResult, docsResult, brainResult] = await Promise.allSettled([
+    isSaga ? fetchSagaMembersWithTitles(projectRoot, id) : Promise.resolve(void 0),
+    epicIdForReady && TASK_ID_RE2.test(epicIdForReady) ? orchestrateReady2(epicIdForReady, projectRoot) : Promise.resolve(null),
+    fetchAttachedDocs(projectRoot, id),
+    fetchBrainContext(id)
+  ]);
+  const recentActivity = fetchRecentActivity(id, projectRoot);
+  const members = sagaMembersResult.status === "fulfilled" && sagaMembersResult.value != null ? sagaMembersResult.value : void 0;
+  let readyWave;
+  if (readyResult.status === "fulfilled" && readyResult.value?.success) {
+    const rData = readyResult.value.data;
+    const rTasks = rData?.readyTasks ?? [];
+    if (rTasks.length > 0) {
+      readyWave = rTasks.map((t) => ({
+        id: t.id,
+        title: t.title,
+        priority: t.priority,
+        depends: t.depends
+      }));
+    }
+  }
+  const attachedDocs = docsResult.status === "fulfilled" && docsResult.value.length > 0 ? docsResult.value : void 0;
+  const brainContext = brainResult.status === "fulfilled" ? brainResult.value : void 0;
+  const envelope = {
+    identity,
+    scope,
+    ...members != null ? { members } : {},
+    blockers,
+    ...readyWave != null ? { readyWave } : {},
+    ...attachedDocs != null ? { attachedDocs } : {},
+    ...recentActivity.length > 0 ? { recentActivity } : {},
+    ...brainContext != null ? { brainContext } : {},
+    tokensEstimated: 0
+  };
+  envelope.tokensEstimated = roughTokenCount(envelope);
+  return envelope;
+}
+var TASK_ID_RE2, QUERY_OPS4, FocusHandler;
+var init_focus2 = __esm({
+  "packages/cleo/src/dispatch/domains/focus.ts"() {
+    "use strict";
+    init_typed();
+    init_base();
+    init_meta2();
+    TASK_ID_RE2 = /^T\d+$/i;
+    QUERY_OPS4 = /* @__PURE__ */ new Set(["show"]);
+    FocusHandler = class {
+      /**
+       * Execute a read-only focus query operation.
+       *
+       * @param operation - Operation name (`'show'`).
+       * @param params    - Raw params (must contain `id: string`).
+       */
+      async query(operation, params) {
+        const startTime = Date.now();
+        if (!QUERY_OPS4.has(operation)) {
+          return unsupportedOp("query", "focus", operation, startTime);
+        }
+        try {
+          const id = typeof params?.["id"] === "string" ? params["id"].trim() : "";
+          if (!id) {
+            return {
+              meta: dispatchMeta("query", "focus", operation, startTime),
+              success: false,
+              error: { code: "E_INVALID_INPUT", message: "id is required (e.g. cleo focus T9973)" }
+            };
+          }
+          const projectRoot = getProjectRoot6();
+          const result = await buildFocusEnvelope(id, projectRoot);
+          if ("error" in result) {
+            return {
+              meta: dispatchMeta("query", "focus", operation, startTime),
+              success: false,
+              error: result.error
+            };
+          }
+          const wrapped = lafsSuccess(result, "focus.show");
+          return {
+            meta: dispatchMeta("query", "focus", operation, startTime),
+            success: true,
+            data: wrapped.data
+          };
+        } catch (error) {
+          return handleErrorResult("query", "focus", operation, error, startTime);
+        }
+      }
+      /**
+       * The focus domain has no mutate operations.
+       *
+       * @param operation - Always unsupported.
+       * @param _params   - Unused.
+       */
+      async mutate(operation, _params) {
+        const startTime = Date.now();
+        return unsupportedOp("mutate", "focus", operation, startTime);
+      }
+      /** Declared operations for introspection. */
+      getSupportedOperations() {
+        return { query: ["show"], mutate: [] };
+      }
+    };
+  }
+});
+
 // packages/cleo/src/dispatch/domains/intelligence.ts
-import { getLogger as getLogger5, getProjectRoot as getProjectRoot6, getTaskAccessor as getTaskAccessor2 } from "@cleocode/core";
+import { getLogger as getLogger5, getProjectRoot as getProjectRoot7, getTaskAccessor as getTaskAccessor2 } from "@cleocode/core";
 import {
   calculateTaskRisk,
   extractPatternsFromHistory,
@@ -18400,7 +18849,7 @@ var init_intelligence2 = __esm({
       // Query
       // -----------------------------------------------------------------------
       async query(operation, params) {
-        const projectRoot = getProjectRoot6();
+        const projectRoot = getProjectRoot7();
         const startTime = Date.now();
         try {
           switch (operation) {
@@ -18619,7 +19068,7 @@ async function wrap(op, params, label) {
     return lafsError("E_INTERNAL", err instanceof Error ? err.message : String(err), label);
   }
 }
-var coreOps, _llmTypedHandler, QUERY_OPS4, MUTATE_OPS4, LlmHandler;
+var coreOps, _llmTypedHandler, QUERY_OPS5, MUTATE_OPS4, LlmHandler;
 var init_llm2 = __esm({
   "packages/cleo/src/dispatch/domains/llm/index.ts"() {
     "use strict";
@@ -18651,7 +19100,7 @@ var init_llm2 = __esm({
       use: async (params) => wrap(coreOps["use"], params, "use"),
       profile: async (params) => wrap(coreOps["profile"], params, "profile")
     });
-    QUERY_OPS4 = /* @__PURE__ */ new Set(["list", "test", "whoami", "auxiliary-status"]);
+    QUERY_OPS5 = /* @__PURE__ */ new Set(["list", "test", "whoami", "auxiliary-status"]);
     MUTATE_OPS4 = /* @__PURE__ */ new Set(["add", "remove", "use", "profile"]);
     LlmHandler = class {
       /** Declared operations for introspection and validation. */
@@ -18666,7 +19115,7 @@ var init_llm2 = __esm({
        */
       async query(operation, params) {
         const startTime = Date.now();
-        if (!QUERY_OPS4.has(operation)) {
+        if (!QUERY_OPS5.has(operation)) {
           return unsupportedOp("query", "llm", operation, startTime);
         }
         try {
@@ -18704,8 +19153,9 @@ var init_llm2 = __esm({
 });
 
 // packages/cleo/src/dispatch/domains/memory.ts
-import { getLogger as getLogger6, getProjectRoot as getProjectRoot7 } from "@cleocode/core";
+import { getLogger as getLogger6, getProjectRoot as getProjectRoot8 } from "@cleocode/core";
 import {
+  createAttachmentStore as createAttachmentStore3,
   generateMemoryBridgeContent,
   getBrainDb,
   getBrainNativeDb,
@@ -18732,7 +19182,7 @@ var init_memory2 = __esm({
       // Query
       // -----------------------------------------------------------------------
       async query(operation, params) {
-        const projectRoot = getProjectRoot7();
+        const projectRoot = getProjectRoot8();
         const startTime = Date.now();
         try {
           switch (operation) {
@@ -19839,7 +20289,7 @@ var init_memory2 = __esm({
       // Mutate
       // -----------------------------------------------------------------------
       async mutate(operation, params) {
-        const projectRoot = getProjectRoot7();
+        const projectRoot = getProjectRoot8();
         const startTime = Date.now();
         try {
           switch (operation) {
@@ -20098,15 +20548,16 @@ var init_memory2 = __esm({
                 let found = false;
                 let foundTable = "";
                 let alreadyVerified = false;
+                let foundNarrative = null;
                 for (const tbl of tables) {
                   try {
-                    const row = nativeDb.prepare(
-                      `SELECT id, verified FROM ${tbl} WHERE id = ? AND invalid_at IS NULL LIMIT 1`
-                    ).get(entryId);
+                    const selectSql = tbl === "brain_observations" ? `SELECT id, verified, narrative FROM ${tbl} WHERE id = ? AND invalid_at IS NULL LIMIT 1` : `SELECT id, verified FROM ${tbl} WHERE id = ? AND invalid_at IS NULL LIMIT 1`;
+                    const row = nativeDb.prepare(selectSql).get(entryId);
                     if (row) {
                       found = true;
                       foundTable = tbl;
                       alreadyVerified = row.verified === 1;
+                      foundNarrative = row.narrative ?? null;
                       if (!alreadyVerified) {
                         if (tbl === "brain_observations") {
                           try {
@@ -20135,6 +20586,22 @@ var init_memory2 = __esm({
                     startTime
                   );
                 }
+                let attachmentMissing;
+                let attachmentId;
+                if (foundTable === "brain_observations" && foundNarrative) {
+                  try {
+                    const payload = JSON.parse(
+                      foundNarrative
+                    );
+                    if (payload.kind === "doc-attachment" && typeof payload.attachmentId === "string") {
+                      attachmentId = payload.attachmentId;
+                      const store = createAttachmentStore3();
+                      const meta = await store.getMetadata(payload.attachmentId);
+                      attachmentMissing = meta === null;
+                    }
+                  } catch {
+                  }
+                }
                 return wrapResult(
                   {
                     success: true,
@@ -20143,7 +20610,13 @@ var init_memory2 = __esm({
                       table: foundTable.replace("brain_", ""),
                       verified: true,
                       alreadyVerified,
-                      verifiedAt: alreadyVerified ? null : now
+                      verifiedAt: alreadyVerified ? null : now,
+                      // T9976 — doc-attachment round-trip fields (only present when applicable).
+                      ...attachmentId !== void 0 ? { attachmentId } : {},
+                      ...attachmentMissing !== void 0 ? { attachmentMissing } : {},
+                      ...attachmentMissing === true ? {
+                        warning: `Attachment '${attachmentId}' referenced by this observation no longer exists in the docs store. The doc may have been removed.`
+                      } : {}
                     }
                   },
                   "mutate",
@@ -20299,6 +20772,92 @@ var init_memory2 = __esm({
             // which already handles all sweep sub-commands via a unified case block.
             case "sweep":
               return this.query(operation, params);
+            // T9976 — backfill: emit memory observations for existing doc attachments
+            // that do not yet have a corresponding brain observation.
+            case "backfill-docs": {
+              try {
+                const store = createAttachmentStore3();
+                const allAttachments = await store.listAllInProject();
+                await getBrainDb(projectRoot);
+                const nativeDb = getBrainNativeDb();
+                const existingAttachmentIds = /* @__PURE__ */ new Set();
+                if (nativeDb) {
+                  try {
+                    const existing = nativeDb.prepare(
+                      `SELECT narrative FROM brain_observations
+                     WHERE narrative LIKE '%"kind":"doc-attachment"%'
+                       AND invalid_at IS NULL`
+                    ).all();
+                    for (const row of existing) {
+                      if (!row.narrative) continue;
+                      try {
+                        const p = JSON.parse(row.narrative);
+                        if (p.kind === "doc-attachment" && typeof p.attachmentId === "string") {
+                          existingAttachmentIds.add(p.attachmentId);
+                        }
+                      } catch {
+                      }
+                    }
+                  } catch {
+                  }
+                }
+                let emitted = 0;
+                let skipped = 0;
+                const emittedIds = [];
+                for (const item of allAttachments) {
+                  const attId = item.metadata.id;
+                  if (existingAttachmentIds.has(attId)) {
+                    skipped++;
+                    continue;
+                  }
+                  const extras = await store.getExtras(attId);
+                  const slug = extras?.slug ?? void 0;
+                  const type2 = extras?.type ?? void 0;
+                  const payload = {
+                    kind: "doc-attachment",
+                    attachmentId: attId,
+                    ownerId: item.ownerId,
+                    addedAt: item.metadata.createdAt,
+                    ...slug !== void 0 ? { slug } : {},
+                    ...type2 !== void 0 ? { type: type2 } : {}
+                  };
+                  const { memoryObserve: brainObserve } = await import("@cleocode/core/internal");
+                  await brainObserve(
+                    {
+                      text: JSON.stringify(payload),
+                      title: `Doc attached: ${slug ?? attId}`,
+                      type: "feature",
+                      // sourceType: 'manual' avoids the mental-model queue (5s flush interval).
+                      // The mental-model queue is only entered when `agent` is set + type is in
+                      // MENTAL_MODEL_TYPES. Using 'manual' bypasses this path entirely.
+                      sourceType: "manual"
+                    },
+                    projectRoot
+                  ).catch(() => {
+                  });
+                  emittedIds.push(attId);
+                  emitted++;
+                }
+                return wrapResult(
+                  {
+                    success: true,
+                    data: {
+                      total: allAttachments.length,
+                      emitted,
+                      skipped,
+                      emittedAttachmentIds: emittedIds,
+                      hint: emitted === 0 ? "All existing attachments already have memory observations \u2014 nothing to backfill." : `Emitted ${emitted} new doc-attachment observations. Use 'cleo memory find <slug>' to verify.`
+                    }
+                  },
+                  "mutate",
+                  "memory",
+                  operation,
+                  startTime
+                );
+              } catch (backfillErr) {
+                return handleErrorResult("mutate", "memory", operation, backfillErr, startTime);
+              }
+            }
             default:
               return unsupportedOp("mutate", "memory", operation, startTime);
           }
@@ -20380,7 +20939,9 @@ var init_memory2 = __esm({
             // T1003 — staged backfill operations
             "backfill.run",
             "backfill.approve",
-            "backfill.rollback"
+            "backfill.rollback",
+            // T9976 — emit memory observations for existing doc attachments
+            "backfill-docs"
           ]
         };
       }
@@ -20488,7 +21049,7 @@ import {
   getBrainNativeDb as getBrainNativeDb2,
   getLogger as getLogger7,
   getNexusNativeDb,
-  getProjectRoot as getProjectRoot8,
+  getProjectRoot as getProjectRoot9,
   nexusAugment,
   nexusBlockers,
   nexusBrainAnchors,
@@ -20760,7 +21321,7 @@ async function handleImpact(operation, params, startTime) {
     5
   );
   const projectIdParam = params?.projectId;
-  const projectId = projectIdParam ?? Buffer.from(getProjectRoot8()).toString("base64url").slice(0, 32);
+  const projectId = projectIdParam ?? Buffer.from(getProjectRoot9()).toString("base64url").slice(0, 32);
   try {
     const { getNexusDb } = await import("@cleocode/core/store/nexus-sqlite");
     await getNexusDb();
@@ -20937,7 +21498,7 @@ async function handleImpact(operation, params, startTime) {
     return handleErrorResult("query", "nexus", operation, dbErr, startTime);
   }
 }
-var _nexusTypedHandler, QUERY_OPS5, MUTATE_OPS5, NexusHandler, IMPACT_REVERSE_TYPES;
+var _nexusTypedHandler, QUERY_OPS6, MUTATE_OPS5, NexusHandler, IMPACT_REVERSE_TYPES;
 var init_nexus3 = __esm({
   "packages/cleo/src/dispatch/domains/nexus.ts"() {
     "use strict";
@@ -21021,7 +21582,7 @@ var init_nexus3 = __esm({
         return wrapCoreResult(await nexusAugment(params.pattern, params.limit ?? 5), "augment");
       },
       "share.status": async (_params) => {
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         return wrapCoreResult(await nexusShareStatus(projectRoot), "share.status");
       },
       "transfer.preview": async (params) => {
@@ -21057,39 +21618,39 @@ var init_nexus3 = __esm({
       },
       "full-context": async (params) => {
         if (!params.symbol) return lafsError("E_INVALID_INPUT", "symbol is required", "full-context");
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         return wrapCoreResult(await nexusFullContext(params.symbol, projectRoot), "full-context");
       },
       "task-footprint": async (params) => {
         if (!params.taskId) return lafsError("E_INVALID_INPUT", "taskId is required", "task-footprint");
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         return wrapCoreResult(await nexusTaskFootprint(params.taskId, projectRoot), "task-footprint");
       },
       "brain-anchors": async (params) => {
         if (!params.entryId)
           return lafsError("E_INVALID_INPUT", "entryId is required", "brain-anchors");
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         return wrapCoreResult(await nexusBrainAnchors(params.entryId, projectRoot), "brain-anchors");
       },
       why: async (params) => {
         if (!params.symbol) return lafsError("E_INVALID_INPUT", "symbol is required", "why");
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         return wrapCoreResult(await nexusWhy(params.symbol, projectRoot), "why");
       },
       "impact-full": async (params) => {
         if (!params.symbol) return lafsError("E_INVALID_INPUT", "symbol is required", "impact-full");
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         return wrapCoreResult(await nexusImpactFull(params.symbol, projectRoot), "impact-full");
       },
       "route-map": async (params) => {
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         const projectId = params.projectId ?? Buffer.from(projectRoot).toString("base64url").slice(0, 32);
         return wrapCoreResult(await nexusRouteMap(projectId, projectRoot), "route-map");
       },
       "shape-check": async (params) => {
         if (!params.routeSymbol)
           return lafsError("E_INVALID_INPUT", "routeSymbol is required", "shape-check");
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         const projectId = params.projectId ?? Buffer.from(projectRoot).toString("base64url").slice(0, 32);
         return wrapCoreResult(
           await nexusShapeCheck(params.routeSymbol, projectId, projectRoot),
@@ -21101,7 +21662,7 @@ var init_nexus3 = __esm({
         return wrapCoreResult(await nexusSearchCode(params.pattern, params.limit ?? 10), "search-code");
       },
       wiki: async (params) => {
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         const outputDir = params.outputDir ?? `${projectRoot}/.cleo/wiki`;
         return wrapCoreResult(
           await nexusWiki(outputDir, projectRoot, {
@@ -21114,7 +21675,7 @@ var init_nexus3 = __esm({
       "contracts-show": async (params) => {
         if (!params.projectA || !params.projectB)
           return lafsError("E_INVALID_INPUT", "projectA and projectB are required", "contracts-show");
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         return wrapCoreResult(
           await nexusContractsShow(params.projectA, params.projectB, projectRoot),
           "contracts-show"
@@ -21122,7 +21683,7 @@ var init_nexus3 = __esm({
       },
       "task-symbols": async (params) => {
         if (!params.taskId) return lafsError("E_INVALID_INPUT", "taskId is required", "task-symbols");
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         return wrapCoreResult(await nexusTaskSymbols(params.taskId, projectRoot), "task-symbols");
       },
       "profile.view": async (params) => wrapCoreResult(
@@ -21137,20 +21698,20 @@ var init_nexus3 = __esm({
       "sigil.list": async (params) => wrapCoreResult(await nexusSigilList(params.role), "sigil.list"),
       // T1510 — Phase 2 query ops
       clusters: async (params) => {
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         const repoPath = params.repoPath ?? projectRoot;
         const projectId = params.projectId ?? Buffer.from(repoPath).toString("base64url").slice(0, 32);
         return wrapCoreResult(await nexusClusters(projectId, repoPath), "clusters");
       },
       flows: async (params) => {
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         const repoPath = params.repoPath ?? projectRoot;
         const projectId = params.projectId ?? Buffer.from(repoPath).toString("base64url").slice(0, 32);
         return wrapCoreResult(await nexusFlows(projectId, repoPath), "flows");
       },
       context: async (params) => {
         if (!params.symbol) return lafsError("E_INVALID_INPUT", "symbol is required", "context");
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         const projectId = params.projectId ?? Buffer.from(projectRoot).toString("base64url").slice(0, 32);
         const limit = typeof params.limit === "number" ? params.limit : 20;
         const showContent = params.content === true;
@@ -21199,13 +21760,13 @@ var init_nexus3 = __esm({
         "projects.clean"
       ),
       "refresh-bridge": async (params) => {
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         const repoPath = params.repoPath ?? projectRoot;
         const projectId = params.projectId;
         return wrapCoreResult(await nexusRefreshBridge(repoPath, projectId), "refresh-bridge");
       },
       diff: async (params) => {
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         const repoPath = params.repoPath ?? projectRoot;
         return wrapCoreResult(
           await nexusDiff(
@@ -21225,17 +21786,17 @@ var init_nexus3 = __esm({
         );
       },
       "hot-paths": async (params) => {
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         const limit = typeof params.limit === "number" ? params.limit : 20;
         return wrapCoreResult(await nexusHotPaths(projectRoot, limit), "hot-paths");
       },
       "hot-nodes": async (params) => {
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         const limit = typeof params.limit === "number" ? params.limit : 20;
         return wrapCoreResult(await nexusHotNodes(projectRoot, limit), "hot-nodes");
       },
       "cold-symbols": async (params) => {
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         const days = typeof params.days === "number" ? params.days : 30;
         return wrapCoreResult(await nexusColdSymbols(projectRoot, days), "cold-symbols");
       },
@@ -21271,11 +21832,11 @@ var init_nexus3 = __esm({
         );
       },
       reconcile: async (params) => wrapCoreResult(
-        await nexusReconcileProject(params.projectRoot ?? getProjectRoot8()),
+        await nexusReconcileProject(params.projectRoot ?? getProjectRoot9()),
         "reconcile"
       ),
       "share.snapshot.export": async (params) => {
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         return wrapCoreResult(
           await nexusShareSnapshotExport(projectRoot, params.outputPath),
           "share.snapshot.export"
@@ -21284,7 +21845,7 @@ var init_nexus3 = __esm({
       "share.snapshot.import": async (params) => {
         if (!params.inputPath)
           return lafsError("E_INVALID_INPUT", "inputPath is required", "share.snapshot.import");
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         return wrapCoreResult(
           await nexusShareSnapshotImport(projectRoot, params.inputPath),
           "share.snapshot.import"
@@ -21312,13 +21873,13 @@ var init_nexus3 = __esm({
         );
       },
       "contracts-sync": async (params) => {
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         const repoPath = params.repoPath ?? projectRoot;
         const projectId = params.projectId ?? Buffer.from(repoPath).toString("base64url").slice(0, 32);
         return wrapCoreResult(await nexusContractsSync(projectId, repoPath), "contracts-sync");
       },
       "contracts-link-tasks": async (params) => {
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         const repoPath = params.repoPath ?? projectRoot;
         const projectId = params.projectId ?? Buffer.from(repoPath).toString("base64url").slice(0, 32);
         return wrapCoreResult(
@@ -21327,7 +21888,7 @@ var init_nexus3 = __esm({
         );
       },
       "conduit-scan": async (_params) => {
-        const projectRoot = getProjectRoot8();
+        const projectRoot = getProjectRoot9();
         return wrapCoreResult(await nexusConduitScan(projectRoot), "conduit-scan");
       },
       "profile.import": async (params) => wrapCoreResult(await nexusProfileImport(params.path), "profile.import"),
@@ -21360,7 +21921,7 @@ var init_nexus3 = __esm({
       },
       "sigil.sync": async (_params) => wrapCoreResult(await nexusSigilSync(), "sigil.sync")
     });
-    QUERY_OPS5 = /* @__PURE__ */ new Set([
+    QUERY_OPS6 = /* @__PURE__ */ new Set([
       "share.status",
       "status",
       "list",
@@ -21437,7 +21998,7 @@ var init_nexus3 = __esm({
        */
       async query(operation, params) {
         const startTime = Date.now();
-        if (!QUERY_OPS5.has(operation)) {
+        if (!QUERY_OPS6.has(operation)) {
           return unsupportedOp("query", "nexus", operation, startTime);
         }
         if (operation === "top-entries") {
@@ -21494,7 +22055,7 @@ var init_nexus3 = __esm({
       /** Declared operations for introspection and validation. */
       getSupportedOperations() {
         return {
-          query: Array.from(QUERY_OPS5),
+          query: Array.from(QUERY_OPS6),
           mutate: Array.from(MUTATE_OPS5)
         };
       }
@@ -21531,7 +22092,7 @@ import {
   extractTypedGates,
   getIvtrState,
   getLogger as getLogger8,
-  getProjectRoot as getProjectRoot9,
+  getProjectRoot as getProjectRoot10,
   getTask,
   loopBackIvtr,
   releaseIvtr,
@@ -21547,7 +22108,7 @@ function extractEvidenceFromRaw(raw) {
   return [];
 }
 async function ivtrStatusOp(params) {
-  const cwd = getProjectRoot9();
+  const cwd = getProjectRoot10();
   const state = await getIvtrState(params.taskId, { cwd });
   if (!state) {
     return engineSuccess2({
@@ -21577,7 +22138,7 @@ async function ivtrStatusOp(params) {
   });
 }
 async function ivtrStartOp(params) {
-  const cwd = getProjectRoot9();
+  const cwd = getProjectRoot10();
   const task = await getTask(params.taskId, cwd);
   if (!task) {
     return engineError2("E_NOT_FOUND", `Task ${params.taskId} not found`);
@@ -21598,7 +22159,7 @@ async function ivtrStartOp(params) {
   });
 }
 async function ivtrNextOp(params) {
-  const cwd = getProjectRoot9();
+  const cwd = getProjectRoot10();
   const task = await getTask(params.taskId, cwd);
   if (!task) {
     return engineError2("E_NOT_FOUND", `Task ${params.taskId} not found`);
@@ -21649,7 +22210,7 @@ async function ivtrNextOp(params) {
   });
 }
 async function ivtrReleaseOp(params) {
-  const cwd = getProjectRoot9();
+  const cwd = getProjectRoot10();
   const result = await releaseIvtr(params.taskId, { cwd });
   if (!result.released) {
     return {
@@ -21686,7 +22247,7 @@ async function ivtrReleaseOp(params) {
   };
 }
 async function ivtrLoopBackOp(params) {
-  const cwd = getProjectRoot9();
+  const cwd = getProjectRoot10();
   if (!isLoopBackTarget(params.phase)) {
     return {
       success: false,
@@ -26252,8 +26813,8 @@ async function loadPlaybookByName(name) {
     return null;
   }
   try {
-    const { getProjectRoot: getProjectRoot43 } = await import("@cleocode/core/internal");
-    const projectRoot = __playbookRuntimeOverrides.projectRoot ?? getProjectRoot43();
+    const { getProjectRoot: getProjectRoot44 } = await import("@cleocode/core/internal");
+    const projectRoot = __playbookRuntimeOverrides.projectRoot ?? getProjectRoot44();
     const resolved = resolvePlaybook(name, {
       projectRoot,
       globalPlaybooksDir: __playbookRuntimeOverrides.globalPlaybooksDir,
@@ -26297,8 +26858,8 @@ async function acquireDb() {
 async function buildDefaultDispatcher() {
   if (__playbookRuntimeOverrides.dispatcher) return __playbookRuntimeOverrides.dispatcher;
   const { orchestrateSpawnExecute: orchestrateSpawnExecute2 } = await Promise.resolve().then(() => (init_engine(), engine_exports));
-  const { getProjectRoot: getProjectRoot43 } = await import("@cleocode/core/internal");
-  const projectRoot = getProjectRoot43();
+  const { getProjectRoot: getProjectRoot44 } = await import("@cleocode/core/internal");
+  const projectRoot = getProjectRoot44();
   return {
     async dispatch(input2) {
       try {
@@ -26364,7 +26925,7 @@ async function lookupApprovalByTokenForDispatch(token) {
   const db = await acquireDb();
   return getPlaybookApprovalByToken(db, token);
 }
-var __playbookRuntimeOverrides, _playbookTypedHandler, QUERY_OPS6, MUTATE_OPS6, PlaybookHandler;
+var __playbookRuntimeOverrides, _playbookTypedHandler, QUERY_OPS7, MUTATE_OPS6, PlaybookHandler;
 var init_playbook2 = __esm({
   "packages/cleo/src/dispatch/domains/playbook.ts"() {
     "use strict";
@@ -26488,8 +27049,8 @@ var init_playbook2 = __esm({
             projectRoot = __playbookRuntimeOverrides.projectRoot;
           } else {
             try {
-              const { getProjectRoot: getProjectRoot43 } = await import("@cleocode/core/internal");
-              projectRoot = getProjectRoot43();
+              const { getProjectRoot: getProjectRoot44 } = await import("@cleocode/core/internal");
+              projectRoot = getProjectRoot44();
             } catch {
               projectRoot = void 0;
             }
@@ -26553,14 +27114,14 @@ var init_playbook2 = __esm({
         const dispatcher = await buildDefaultDispatcher();
         let result;
         try {
-          const { getProjectRoot: getProjectRoot43 } = await import("@cleocode/core/internal");
+          const { getProjectRoot: getProjectRoot44 } = await import("@cleocode/core/internal");
           const opts = {
             db,
             playbook: parsed.definition,
             playbookHash: parsed.sourceHash,
             initialContext,
             dispatcher,
-            projectRoot: getProjectRoot43()
+            projectRoot: getProjectRoot44()
           };
           if (__playbookRuntimeOverrides.approvalSecret !== void 0) {
             opts.approvalSecret = __playbookRuntimeOverrides.approvalSecret;
@@ -26667,7 +27228,7 @@ var init_playbook2 = __esm({
         }
       }
     });
-    QUERY_OPS6 = /* @__PURE__ */ new Set(["status", "list", "validate", "catalog"]);
+    QUERY_OPS7 = /* @__PURE__ */ new Set(["status", "list", "validate", "catalog"]);
     MUTATE_OPS6 = /* @__PURE__ */ new Set(["run", "resume"]);
     PlaybookHandler = class {
       /**
@@ -26675,7 +27236,7 @@ var init_playbook2 = __esm({
        */
       async query(operation, params) {
         const startTime = Date.now();
-        if (!QUERY_OPS6.has(operation)) {
+        if (!QUERY_OPS7.has(operation)) {
           return unsupportedOp("query", "playbook", operation, startTime);
         }
         try {
@@ -26742,7 +27303,7 @@ var init_playbook2 = __esm({
 // packages/cleo/src/dispatch/domains/orchestrate.ts
 import {
   getLogger as getLogger9,
-  getProjectRoot as getProjectRoot10,
+  getProjectRoot as getProjectRoot11,
   instantiateTessera,
   listTesseraTemplates,
   paginate as paginate2,
@@ -26756,25 +27317,25 @@ function evictFanoutManifest() {
   }
 }
 async function orchestrateStatusOp(params) {
-  return orchestrateStatus(params.epicId, getProjectRoot10());
+  return orchestrateStatus(params.epicId, getProjectRoot11());
 }
 async function orchestrateNextOp(params) {
-  return orchestrateNext(params.epicId, getProjectRoot10());
+  return orchestrateNext(params.epicId, getProjectRoot11());
 }
 async function orchestrateReadyOp(params) {
-  return orchestrateReady(params.epicId, getProjectRoot10(), {
+  return orchestrateReady(params.epicId, getProjectRoot11(), {
     ignoreDepsValidate: params.ignoreDepsValidate,
     via: params.via
   });
 }
 async function orchestrateAnalyzeOp(params) {
   if (params.mode === "parallel-safety") {
-    return orchestrateAnalyzeParallelSafety(params.taskIds ?? [], getProjectRoot10());
+    return orchestrateAnalyzeParallelSafety(params.taskIds ?? [], getProjectRoot11());
   }
-  return orchestrateAnalyze(params.epicId, getProjectRoot10(), params.mode);
+  return orchestrateAnalyze(params.epicId, getProjectRoot11(), params.mode);
 }
 async function orchestrateClassifyOp(params) {
-  return orchestrateClassify(params.request, params.context, getProjectRoot10());
+  return orchestrateClassify(params.request, params.context, getProjectRoot11());
 }
 function orchestrateFanoutStatusOp(params) {
   const entry = fanoutManifestStore.get(params.manifestEntryId);
@@ -26807,23 +27368,23 @@ function orchestrateFanoutStatusOp(params) {
   });
 }
 async function orchestrateContextOp(params) {
-  return orchestrateContext(params.epicId, getProjectRoot10());
+  return orchestrateContext(params.epicId, getProjectRoot11());
 }
 async function orchestrateWavesOp(params) {
-  return orchestrateWaves(params.epicId, getProjectRoot10(), { via: params.via });
+  return orchestrateWaves(params.epicId, getProjectRoot11(), { via: params.via });
 }
 async function orchestratePlanOp(params) {
   return orchestratePlan({
     epicId: params.epicId,
-    projectRoot: getProjectRoot10(),
+    projectRoot: getProjectRoot11(),
     preferTier: params.preferTier
   });
 }
 async function orchestrateBootstrapOp(params) {
-  return orchestrateBootstrap(getProjectRoot10(), { speed: params.speed });
+  return orchestrateBootstrap(getProjectRoot11(), { speed: params.speed });
 }
 async function orchestrateUnblockOp(_params) {
-  return orchestrateUnblockOpportunities(getProjectRoot10());
+  return orchestrateUnblockOpportunities(getProjectRoot11());
 }
 async function orchestrateTesseraListOp(params) {
   return Promise.resolve({ success: true, data: params });
@@ -26835,13 +27396,13 @@ async function orchestratePendingOp(_params) {
   return Promise.resolve({ success: true, data: {} });
 }
 async function orchestrateStartOp(params) {
-  return orchestrateStartup(params.epicId, getProjectRoot10());
+  return orchestrateStartup(params.epicId, getProjectRoot11());
 }
 async function orchestrateSpawnOp(params) {
   return orchestrateSpawn(
     params.taskId,
     params.protocolType,
-    getProjectRoot10(),
+    getProjectRoot11(),
     params.tier,
     params.noWorktree,
     params.spawnScope
@@ -26860,7 +27421,7 @@ async function orchestrateHandoffOp(params) {
     },
     // Inject cleo session ops to avoid core→cleo import cycle (T1570 ADR-057)
     { sessionStatus, sessionEnd, sessionContextInject },
-    getProjectRoot10()
+    getProjectRoot11()
   );
 }
 async function orchestrateSpawnExecuteOp(params) {
@@ -26868,19 +27429,19 @@ async function orchestrateSpawnExecuteOp(params) {
     params.taskId,
     params.adapterId,
     params.protocolType,
-    getProjectRoot10(),
+    getProjectRoot11(),
     params.tier
   );
 }
 async function orchestrateValidateOp(params) {
-  return orchestrateValidate(params.taskId, getProjectRoot10());
+  return orchestrateValidate(params.taskId, getProjectRoot11());
 }
 async function orchestratePivotOp(params) {
   try {
     const result = await pivotTask(params.fromTaskId, params.toTaskId, {
       reason: params.reason,
       blocksFrom: params.blocksFrom,
-      projectRoot: getProjectRoot10()
+      projectRoot: getProjectRoot11()
     });
     return { success: true, data: result };
   } catch (err) {
@@ -26898,19 +27459,19 @@ async function orchestratePivotOp(params) {
   }
 }
 async function orchestrateWorktreeCompleteOp(params) {
-  return handleWorktreeComplete(params.taskId, getProjectRoot10(), params.resolve);
+  return handleWorktreeComplete(params.taskId, getProjectRoot11(), params.resolve);
 }
 async function orchestrateWorktreeCleanupOp(params) {
-  return handleWorktreeCleanup(getProjectRoot10(), params.taskIds);
+  return handleWorktreeCleanup(getProjectRoot11(), params.taskIds);
 }
 async function orchestrateWorktreePruneOp(params) {
-  return handleWorktreePrune(getProjectRoot10(), params.taskId);
+  return handleWorktreePrune(getProjectRoot11(), params.taskId);
 }
 async function orchestrateParallelOp(params) {
   return Promise.resolve({ success: true, data: params });
 }
 async function orchestrateFanoutOp(params) {
-  return orchestrateFanoutImpl(params.items, getProjectRoot10());
+  return orchestrateFanoutImpl(params.items, getProjectRoot11());
 }
 async function orchestrateTesseraInstantiateOp(params) {
   return Promise.resolve({ success: true, data: params });
@@ -27887,7 +28448,7 @@ var init_orchestrate2 = __esm({
                       startTime
                     );
                   return wrapResult(
-                    await orchestrateParallelStart(epicId, wave, getProjectRoot10()),
+                    await orchestrateParallelStart(epicId, wave, getProjectRoot11()),
                     "mutate",
                     "orchestrate",
                     "parallel",
@@ -27916,7 +28477,7 @@ var init_orchestrate2 = __esm({
                       startTime
                     );
                   return wrapResult(
-                    await orchestrateParallelEnd(epicId, wave, getProjectRoot10()),
+                    await orchestrateParallelEnd(epicId, wave, getProjectRoot11()),
                     "mutate",
                     "orchestrate",
                     "parallel",
@@ -27983,7 +28544,7 @@ var init_orchestrate2 = __esm({
                   epicId,
                   variables: { epicId, ...variables }
                 },
-                getProjectRoot10()
+                getProjectRoot11()
               );
               return {
                 meta: dispatchMeta("mutate", "orchestrate", operation, startTime),
@@ -28076,7 +28637,7 @@ import {
   describeChannel,
   formatStageGuidance,
   getLogger as getLogger10,
-  getProjectRoot as getProjectRoot11,
+  getProjectRoot as getProjectRoot12,
   isValidStage,
   listChains,
   paginate as paginate3,
@@ -28084,19 +28645,19 @@ import {
   showChain
 } from "@cleocode/core/internal";
 async function stageValidateOp(params) {
-  return lifecycleCheck(params.epicId, params.targetStage, getProjectRoot11());
+  return lifecycleCheck(params.epicId, params.targetStage, getProjectRoot12());
 }
 async function stageStatusOp(params) {
-  return lifecycleStatus(params.epicId, getProjectRoot11());
+  return lifecycleStatus(params.epicId, getProjectRoot12());
 }
 async function stageHistoryOp(params) {
-  return lifecycleHistory(params.taskId, getProjectRoot11());
+  return lifecycleHistory(params.taskId, getProjectRoot12());
 }
 async function stageGuidanceOp(params) {
   let stage = params.stage;
   const epicId = params.epicId;
   const format = params.format ?? "markdown";
-  const projectRoot = getProjectRoot11();
+  const projectRoot = getProjectRoot12();
   if (!stage && epicId) {
     const statusResult = await lifecycleStatus(epicId, projectRoot);
     if (statusResult.success) {
@@ -28112,14 +28673,14 @@ async function stageRecordOp(params) {
     params.stage,
     params.status,
     params.notes,
-    getProjectRoot11()
+    getProjectRoot12()
   );
 }
 async function stageSkipOp(params) {
-  return lifecycleSkip(params.taskId, params.stage, params.reason, getProjectRoot11());
+  return lifecycleSkip(params.taskId, params.stage, params.reason, getProjectRoot12());
 }
 async function stageResetOp(params) {
-  return lifecycleReset(params.taskId, params.stage, params.reason, getProjectRoot11());
+  return lifecycleReset(params.taskId, params.stage, params.reason, getProjectRoot12());
 }
 async function stageGatePassOp(params) {
   return lifecycleGatePass(
@@ -28127,24 +28688,24 @@ async function stageGatePassOp(params) {
     params.gateName,
     params.agent,
     params.notes,
-    getProjectRoot11()
+    getProjectRoot12()
   );
 }
 async function stageGateFailOp(params) {
-  return lifecycleGateFail(params.taskId, params.gateName, params.reason, getProjectRoot11());
+  return lifecycleGateFail(params.taskId, params.gateName, params.reason, getProjectRoot12());
 }
 async function releaseListOp(params) {
   return releaseList(
     { status: params.status, limit: params.limit, offset: params.offset },
-    getProjectRoot11()
+    getProjectRoot12()
   );
 }
 async function releaseShowOp(params) {
-  return releaseShow(params.version, getProjectRoot11());
+  return releaseShow(params.version, getProjectRoot12());
 }
 async function releaseChannelShowOp(_params) {
   let currentBranch = "unknown";
-  const projectRoot = getProjectRoot11();
+  const projectRoot = getProjectRoot12();
   try {
     currentBranch = execFileSync("git", ["rev-parse", "--abbrev-ref", "HEAD"], {
       encoding: "utf-8",
@@ -28162,52 +28723,52 @@ async function releaseChannelShowOp(_params) {
   };
 }
 async function releasePrStatusOp(params) {
-  return releasePrStatus(params.version, getProjectRoot11());
+  return releasePrStatus(params.version, getProjectRoot12());
 }
 async function releaseCancelOp(params) {
-  return releaseCancel(params.version, getProjectRoot11());
+  return releaseCancel(params.version, getProjectRoot12());
 }
 async function releaseRollbackOp(params) {
-  return releaseRollback(params.version, params.reason, getProjectRoot11());
+  return releaseRollback(params.version, params.reason, getProjectRoot12());
 }
 async function releaseRollbackFullOp(params) {
   return releaseRollbackFull(
     params.version,
     { reason: params.reason, force: params.force, unpublish: params.unpublish },
-    getProjectRoot11()
+    getProjectRoot12()
   );
 }
 async function manifestShowOp(params) {
-  return pipelineManifestShow(params.entryId, getProjectRoot11());
+  return pipelineManifestShow(params.entryId, getProjectRoot12());
 }
 async function manifestListOp(params) {
-  return pipelineManifestList(params, getProjectRoot11());
+  return pipelineManifestList(params, getProjectRoot12());
 }
 async function manifestFindOp(params) {
   return pipelineManifestFind(
     params.query,
     { confidence: params.confidence, limit: params.limit },
-    getProjectRoot11()
+    getProjectRoot12()
   );
 }
 async function manifestStatsOp(params) {
-  return pipelineManifestStats(params.epicId, getProjectRoot11());
+  return pipelineManifestStats(params.epicId, getProjectRoot12());
 }
 async function manifestAppendOp(params) {
-  return pipelineManifestAppend(params.entry, getProjectRoot11());
+  return pipelineManifestAppend(params.entry, getProjectRoot12());
 }
 async function manifestArchiveOp(params) {
-  return pipelineManifestArchive(params.beforeDate, getProjectRoot11());
+  return pipelineManifestArchive(params.beforeDate, getProjectRoot12());
 }
 async function phaseShowOp(params) {
-  return phaseShow(params.phaseId, getProjectRoot11());
+  return phaseShow(params.phaseId, getProjectRoot12());
 }
 async function phaseListOp(_params) {
-  return phaseList(getProjectRoot11());
+  return phaseList(getProjectRoot12());
 }
 async function phaseSetOp(params) {
   const { phaseId, action, rollback, force, dryRun } = params;
-  const projectRoot = getProjectRoot11();
+  const projectRoot = getProjectRoot12();
   if (action === "start") {
     return phaseStart(phaseId, projectRoot);
   }
@@ -28217,28 +28778,28 @@ async function phaseSetOp(params) {
   return phaseSet({ phaseId, rollback, force, dryRun }, projectRoot);
 }
 async function phaseAdvanceOp(params) {
-  return phaseAdvance(params.force, getProjectRoot11());
+  return phaseAdvance(params.force, getProjectRoot12());
 }
 async function phaseRenameOp(params) {
-  return phaseRename(params.oldName, params.newName, getProjectRoot11());
+  return phaseRename(params.oldName, params.newName, getProjectRoot12());
 }
 async function phaseDeleteOp(params) {
   return phaseDelete(
     params.phaseId,
     { reassignTo: params.reassignTo, force: params.force },
-    getProjectRoot11()
+    getProjectRoot12()
   );
 }
 async function chainShowOp(params) {
-  const chain = await showChain(params.chainId, getProjectRoot11());
+  const chain = await showChain(params.chainId, getProjectRoot12());
   return { _chain: chain, _chainId: params.chainId };
 }
 async function chainListOp(_params) {
-  const chains = await listChains(getProjectRoot11());
+  const chains = await listChains(getProjectRoot12());
   return { _chains: chains };
 }
 async function chainAddOp(params) {
-  await addChain(params.chain, getProjectRoot11());
+  await addChain(params.chain, getProjectRoot12());
   return { id: params.chain.id };
 }
 async function chainInstantiateOp(params) {
@@ -28249,7 +28810,7 @@ async function chainInstantiateOp(params) {
       variables: params.variables,
       stageToTask: params.stageToTask
     },
-    getProjectRoot11()
+    getProjectRoot12()
   );
 }
 async function chainAdvanceOp(params) {
@@ -28257,7 +28818,7 @@ async function chainAdvanceOp(params) {
     params.instanceId,
     params.nextStage,
     params.gateResults ?? [],
-    getProjectRoot11()
+    getProjectRoot12()
   );
 }
 function pipelinePhaseListResponse(envelope, params, operation, startTime) {
@@ -28775,7 +29336,7 @@ var init_pipeline3 = __esm({
 // packages/cleo/src/dispatch/domains/provenance.ts
 import {
   getLogger as getLogger11,
-  getProjectRoot as getProjectRoot12,
+  getProjectRoot as getProjectRoot13,
   provenanceBackfill,
   verifyProvenance
 } from "@cleocode/core/internal";
@@ -28820,7 +29381,7 @@ var init_provenance = __esm({
                 ...version ? { version } : {},
                 all,
                 ...limit !== void 0 ? { limit } : {},
-                projectRoot: getProjectRoot12()
+                projectRoot: getProjectRoot13()
               });
               return wrapResult(result, "query", "provenance", operation, startTime);
             }
@@ -28866,7 +29427,7 @@ var init_provenance = __esm({
               const resetCheckpoint = typeof params?.["resetCheckpoint"] === "boolean" ? params["resetCheckpoint"] : false;
               const result = await provenanceBackfill({
                 since,
-                projectRoot: getProjectRoot12(),
+                projectRoot: getProjectRoot13(),
                 forceOverwrite,
                 dryRun,
                 resetCheckpoint
@@ -28896,12 +29457,12 @@ var init_provenance = __esm({
 });
 
 // packages/cleo/src/dispatch/domains/release.ts
-import { getLogger as getLogger12, getProjectRoot as getProjectRoot13 } from "@cleocode/core/internal";
+import { getLogger as getLogger12, getProjectRoot as getProjectRoot14 } from "@cleocode/core/internal";
 async function releaseGateOp(params) {
-  return releaseGateCheck(params.epicId, params.force ?? false, getProjectRoot13());
+  return releaseGateCheck(params.epicId, params.force ?? false, getProjectRoot14());
 }
 async function releaseIvtrSuggestOp(params) {
-  return releaseIvtrAutoSuggest(params.taskId, getProjectRoot13());
+  return releaseIvtrAutoSuggest(params.taskId, getProjectRoot14());
 }
 var log3, coreOps4, ReleaseHandler;
 var init_release2 = __esm({
@@ -29078,7 +29639,7 @@ var init_release2 = __esm({
                 hotfix: typeof params?.hotfix === "boolean" ? params.hotfix : false,
                 dryRun: typeof params?.dryRun === "boolean" ? params.dryRun : false,
                 writeChangelog: typeof params?.writeChangelog === "boolean" ? params.writeChangelog : true,
-                projectRoot: getProjectRoot13()
+                projectRoot: getProjectRoot14()
               };
               return wrapResult(await releasePlan(typed), "mutate", "release", operation, startTime);
             }
@@ -29100,7 +29661,7 @@ var init_release2 = __esm({
                 workflow: typeof params?.workflow === "string" ? params.workflow : void 0,
                 watch: typeof params?.watch === "boolean" ? params.watch : false,
                 commitPlan: typeof params?.commitPlan === "boolean" ? params.commitPlan : false,
-                projectRoot: getProjectRoot13()
+                projectRoot: getProjectRoot14()
               };
               return wrapResult(await releaseOpen(typed), "mutate", "release", operation, startTime);
             }
@@ -29117,7 +29678,7 @@ var init_release2 = __esm({
                   startTime
                 );
               const result = await releaseReconcileV2(version, {
-                projectRoot: getProjectRoot13(),
+                projectRoot: getProjectRoot14(),
                 fromWorkflow: typeof params?.fromWorkflow === "boolean" ? params.fromWorkflow : false,
                 rollback: typeof params?.rollback === "boolean" ? params.rollback : false
               });
@@ -29146,7 +29707,7 @@ var init_release2 = __esm({
 });
 
 // packages/cleo/src/dispatch/domains/sentient.ts
-import { getProjectRoot as getProjectRoot14 } from "@cleocode/core";
+import { getProjectRoot as getProjectRoot15 } from "@cleocode/core";
 import {
   sentientAllowlistAdd,
   sentientAllowlistList,
@@ -29159,23 +29720,23 @@ import {
   sentientProposeReject,
   sentientProposeRun
 } from "@cleocode/core/sentient";
-var coreOps5, _sentientTypedHandler, QUERY_OPS7, MUTATE_OPS7, SentientHandler;
+var coreOps5, _sentientTypedHandler, QUERY_OPS8, MUTATE_OPS7, SentientHandler;
 var init_sentient2 = __esm({
   "packages/cleo/src/dispatch/domains/sentient.ts"() {
     "use strict";
     init_typed();
     init_base();
     coreOps5 = {
-      "propose.list": (params) => sentientProposeList(getProjectRoot14(), params),
-      "propose.diff": (params) => sentientProposeDiff(getProjectRoot14(), params),
-      "allowlist.list": (params) => sentientAllowlistList(getProjectRoot14(), params),
-      "propose.accept": (params) => sentientProposeAccept(getProjectRoot14(), params),
-      "propose.reject": (params) => sentientProposeReject(getProjectRoot14(), params),
-      "propose.run": (params) => sentientProposeRun(getProjectRoot14(), params),
-      "propose.enable": (params) => sentientProposeEnable(getProjectRoot14(), params),
-      "propose.disable": (params) => sentientProposeDisable(getProjectRoot14(), params),
-      "allowlist.add": (params) => sentientAllowlistAdd(getProjectRoot14(), params),
-      "allowlist.remove": (params) => sentientAllowlistRemove(getProjectRoot14(), params)
+      "propose.list": (params) => sentientProposeList(getProjectRoot15(), params),
+      "propose.diff": (params) => sentientProposeDiff(getProjectRoot15(), params),
+      "allowlist.list": (params) => sentientAllowlistList(getProjectRoot15(), params),
+      "propose.accept": (params) => sentientProposeAccept(getProjectRoot15(), params),
+      "propose.reject": (params) => sentientProposeReject(getProjectRoot15(), params),
+      "propose.run": (params) => sentientProposeRun(getProjectRoot15(), params),
+      "propose.enable": (params) => sentientProposeEnable(getProjectRoot15(), params),
+      "propose.disable": (params) => sentientProposeDisable(getProjectRoot15(), params),
+      "allowlist.add": (params) => sentientAllowlistAdd(getProjectRoot15(), params),
+      "allowlist.remove": (params) => sentientAllowlistRemove(getProjectRoot15(), params)
     };
     _sentientTypedHandler = defineTypedHandler("sentient", {
       // -------------------------------------------------------------------------
@@ -29279,7 +29840,7 @@ var init_sentient2 = __esm({
         }
       }
     });
-    QUERY_OPS7 = /* @__PURE__ */ new Set(["propose.list", "propose.diff", "allowlist.list"]);
+    QUERY_OPS8 = /* @__PURE__ */ new Set(["propose.list", "propose.diff", "allowlist.list"]);
     MUTATE_OPS7 = /* @__PURE__ */ new Set([
       "propose.accept",
       "propose.reject",
@@ -29313,7 +29874,7 @@ var init_sentient2 = __esm({
        */
       async query(operation, params) {
         const startTime = Date.now();
-        if (!QUERY_OPS7.has(operation)) {
+        if (!QUERY_OPS8.has(operation)) {
           return unsupportedOp("query", "sentient", operation, startTime);
         }
         try {
@@ -29408,31 +29969,31 @@ var init_session_context = __esm({
 import {
   getDb,
   getLogger as getLogger13,
-  getProjectRoot as getProjectRoot15,
+  getProjectRoot as getProjectRoot16,
   lintSessionForCanonViolations,
   sessions
 } from "@cleocode/core/internal";
 import { eq } from "drizzle-orm";
 async function sessionStatusOp() {
-  return sessionStatus(getProjectRoot15());
+  return sessionStatus(getProjectRoot16());
 }
 async function sessionListOp(params) {
-  return sessionList(getProjectRoot15(), params);
+  return sessionList(getProjectRoot16(), params);
 }
 async function sessionShowOp(params) {
   if (params.include === "debrief") {
-    return sessionDebriefShow(getProjectRoot15(), params.sessionId);
+    return sessionDebriefShow(getProjectRoot16(), params.sessionId);
   }
-  return sessionShow(getProjectRoot15(), params.sessionId);
+  return sessionShow(getProjectRoot16(), params.sessionId);
 }
 async function sessionFindOp(params) {
-  return sessionFind(getProjectRoot15(), params);
+  return sessionFind(getProjectRoot16(), params);
 }
 async function sessionDecisionLogOp(params) {
-  return sessionDecisionLog(getProjectRoot15(), params);
+  return sessionDecisionLog(getProjectRoot16(), params);
 }
 async function sessionContextDriftOp(params) {
-  return sessionContextDrift(getProjectRoot15(), params);
+  return sessionContextDrift(getProjectRoot16(), params);
 }
 async function sessionHandoffShowOp(params) {
   let scopeFilter;
@@ -29443,33 +30004,36 @@ async function sessionHandoffShowOp(params) {
       scopeFilter = { type: "epic", epicId: params.scope.replace("epic:", "") };
     }
   }
-  return sessionHandoff(getProjectRoot15(), scopeFilter);
+  return sessionHandoff(getProjectRoot16(), scopeFilter);
 }
 async function sessionBriefingShowOp(params) {
-  return sessionBriefing(getProjectRoot15(), params);
+  return sessionBriefing(getProjectRoot16(), params);
 }
 async function sessionStartOp(params) {
-  return sessionStart(getProjectRoot15(), params);
+  return sessionStart(getProjectRoot16(), params);
 }
 async function sessionEndOp(params) {
-  return sessionEnd(getProjectRoot15(), params.note, {
+  return sessionEnd(getProjectRoot16(), params.note, {
     sessionSummary: params.sessionSummary
   });
 }
 async function sessionResumeOp(params) {
-  return sessionResume(getProjectRoot15(), params.sessionId);
+  return sessionResume(getProjectRoot16(), params.sessionId);
 }
 async function sessionSuspendOp(params) {
-  return sessionSuspend(getProjectRoot15(), params.sessionId, params.reason);
+  return sessionSuspend(getProjectRoot16(), params.sessionId, params.reason);
 }
 async function sessionGcOp(params) {
-  return sessionGc(getProjectRoot15(), params.maxAgeDays);
+  return sessionGc(getProjectRoot16(), params.maxAgeDays);
 }
 async function sessionRecordDecisionOp(params) {
-  return sessionRecordDecision(getProjectRoot15(), params);
+  return sessionRecordDecision(getProjectRoot16(), params);
 }
 async function sessionRecordAssumptionOp(params) {
-  return sessionRecordAssumption(getProjectRoot15(), params);
+  return sessionRecordAssumption(getProjectRoot16(), params);
+}
+async function sessionAdoptOp(params) {
+  return sessionAdopt(getProjectRoot16(), params.sessionId);
 }
 async function sessionLintOp(params) {
   if (!params.transcript) {
@@ -29481,7 +30045,7 @@ async function sessionLintOp(params) {
   try {
     const result = lintSessionForCanonViolations({
       transcriptPath: params.transcript,
-      projectRoot: getProjectRoot15()
+      projectRoot: getProjectRoot16()
     });
     const wireResult = {
       transcriptPath: result.transcriptPath,
@@ -29518,7 +30082,7 @@ async function storeSessionOwnerAuthToken(projectRoot, sessionId, token) {
   const db = await getDb(projectRoot);
   db.update(sessions).set({ ownerAuthToken: token }).where(eq(sessions.id, sessionId)).run();
 }
-var coreOps6, _sessionTypedHandler, QUERY_OPS8, MUTATE_OPS8, SessionHandler;
+var coreOps6, _sessionTypedHandler, QUERY_OPS9, MUTATE_OPS8, SessionHandler;
 var init_session3 = __esm({
   "packages/cleo/src/dispatch/domains/session.ts"() {
     "use strict";
@@ -29542,7 +30106,9 @@ var init_session3 = __esm({
       gc: sessionGcOp,
       "record.decision": sessionRecordDecisionOp,
       "record.assumption": sessionRecordAssumptionOp,
-      lint: sessionLintOp
+      lint: sessionLintOp,
+      // T9975 — per-agent session isolation
+      adopt: sessionAdoptOp
     };
     _sessionTypedHandler = defineTypedHandler("session", {
       // -------------------------------------------------------------------------
@@ -29602,7 +30168,7 @@ var init_session3 = __esm({
       // SSoT-EXEMPT: storeOwnerAuthToken (DB side-effect requiring post-create sessionId),
       // bindSession (process-scoped context, requires scope-string parsing) — ADR-058
       start: async (params) => {
-        const projectRoot = getProjectRoot15();
+        const projectRoot = getProjectRoot16();
         if (!params.scope) {
           return lafsError("E_INVALID_INPUT", "scope is required", "start");
         }
@@ -29651,7 +30217,7 @@ var init_session3 = __esm({
       // SSoT-EXEMPT: orchestrated post-op pipeline — sessionComputeDebrief, persistSessionMemory,
       // unbindSession (process-context teardown), refreshMemoryBridge — ADR-058
       end: async (params) => {
-        const projectRoot = getProjectRoot15();
+        const projectRoot = getProjectRoot16();
         const endResult = await coreOps6.end(params);
         if (!endResult.success) {
           return lafsError(
@@ -29750,9 +30316,27 @@ var init_session3 = __esm({
           return lafsError("E_INTERNAL", "session.lint returned no data", "lint");
         }
         return lafsSuccess(result.data, "lint");
+      },
+      // T9975 — per-agent session isolation: adopt rebinds env to a specific session.
+      adopt: async (params) => {
+        if (!params.sessionId) {
+          return lafsError("E_INVALID_INPUT", "sessionId is required", "adopt");
+        }
+        const result = await coreOps6.adopt(params);
+        if (!result.success) {
+          return lafsError(
+            String(result.error?.code ?? "E_INTERNAL"),
+            result.error?.message ?? "Unknown error",
+            "adopt"
+          );
+        }
+        if (!result.data) {
+          return lafsError("E_INTERNAL", "session.adopt returned no data", "adopt");
+        }
+        return lafsSuccess(result.data, "adopt");
       }
     });
-    QUERY_OPS8 = /* @__PURE__ */ new Set([
+    QUERY_OPS9 = /* @__PURE__ */ new Set([
       "status",
       "list",
       "show",
@@ -29770,7 +30354,9 @@ var init_session3 = __esm({
       "suspend",
       "gc",
       "record.decision",
-      "record.assumption"
+      "record.assumption",
+      // T9975 — per-agent session isolation
+      "adopt"
     ]);
     SessionHandler = class {
       // -----------------------------------------------------------------------
@@ -29784,7 +30370,7 @@ var init_session3 = __esm({
        */
       async query(operation, params) {
         const startTime = Date.now();
-        if (!QUERY_OPS8.has(operation)) {
+        if (!QUERY_OPS9.has(operation)) {
           return unsupportedOp("query", "session", operation, startTime);
         }
         try {
@@ -29861,7 +30447,7 @@ var init_session3 = __esm({
 });
 
 // packages/cleo/src/dispatch/domains/sticky.ts
-import { getLogger as getLogger14, getProjectRoot as getProjectRoot16 } from "@cleocode/core";
+import { getLogger as getLogger14, getProjectRoot as getProjectRoot17 } from "@cleocode/core";
 import {
   stickyAdd,
   stickyArchive,
@@ -29875,7 +30461,7 @@ import {
 } from "@cleocode/core/internal";
 async function stickyListOp(params) {
   return stickyListFiltered(
-    getProjectRoot16(),
+    getProjectRoot17(),
     {
       status: params.status,
       color: params.color,
@@ -29887,10 +30473,10 @@ async function stickyListOp(params) {
   );
 }
 async function stickyShowOp(params) {
-  return stickyShow(getProjectRoot16(), params.stickyId);
+  return stickyShow(getProjectRoot17(), params.stickyId);
 }
 async function stickyAddOp(params) {
-  return stickyAdd(getProjectRoot16(), {
+  return stickyAdd(getProjectRoot17(), {
     content: params.content,
     tags: params.tags,
     color: params.color,
@@ -29898,24 +30484,24 @@ async function stickyAddOp(params) {
   });
 }
 async function stickyArchiveOp(params) {
-  return stickyArchive(getProjectRoot16(), params.stickyId);
+  return stickyArchive(getProjectRoot17(), params.stickyId);
 }
 async function stickyPurgeOp(params) {
-  return stickyPurge(getProjectRoot16(), params.stickyId);
+  return stickyPurge(getProjectRoot17(), params.stickyId);
 }
 async function stickyConvertTaskOp(params) {
-  const result = await stickyConvertToTask(getProjectRoot16(), params.stickyId, params.title);
+  const result = await stickyConvertToTask(getProjectRoot17(), params.stickyId, params.title);
   if (!result.success) return { taskId: void 0 };
   return { taskId: result.data.taskId };
 }
 async function stickyConvertMemoryOp(params) {
-  const result = await stickyConvertToMemory(getProjectRoot16(), params.stickyId, params.memoryType);
+  const result = await stickyConvertToMemory(getProjectRoot17(), params.stickyId, params.memoryType);
   if (!result.success) return { memoryId: void 0 };
   return { memoryId: result.data.memoryId };
 }
 async function stickyConvertSessionNoteOp(params) {
   const result = await stickyConvertToSessionNote(
-    getProjectRoot16(),
+    getProjectRoot17(),
     params.stickyId,
     params.sessionId
   );
@@ -29923,7 +30509,7 @@ async function stickyConvertSessionNoteOp(params) {
   return { sessionId: result.data.sessionId };
 }
 async function stickyConvertTaskNoteOp(params) {
-  const result = await stickyConvertToTaskNote(getProjectRoot16(), params.stickyId, params.taskId);
+  const result = await stickyConvertToTaskNote(getProjectRoot17(), params.stickyId, params.taskId);
   if (!result.success) return { taskId: void 0 };
   return { taskId: result.data.taskId };
 }
@@ -29946,7 +30532,7 @@ function envelopeToDispatch(envelope, gateway, operation, startTime) {
     }
   };
 }
-var log4, stickyCoreOps, _stickyTypedHandler, QUERY_OPS9, MUTATE_OPS9, CONVERT_TARGET_TO_KEY, StickyHandler;
+var log4, stickyCoreOps, _stickyTypedHandler, QUERY_OPS10, MUTATE_OPS9, CONVERT_TARGET_TO_KEY, StickyHandler;
 var init_sticky2 = __esm({
   "packages/cleo/src/dispatch/domains/sticky.ts"() {
     "use strict";
@@ -30024,7 +30610,7 @@ var init_sticky2 = __esm({
         return data.taskId ? lafsSuccess(data, "convert.task_note") : lafsError("E_CONVERT_FAILED", "convert to task note failed", "convert.task_note");
       }
     });
-    QUERY_OPS9 = /* @__PURE__ */ new Set(["list", "show"]);
+    QUERY_OPS10 = /* @__PURE__ */ new Set(["list", "show"]);
     MUTATE_OPS9 = /* @__PURE__ */ new Set(["add", "convert", "archive", "purge"]);
     CONVERT_TARGET_TO_KEY = {
       task: "convert.task",
@@ -30035,7 +30621,7 @@ var init_sticky2 = __esm({
     StickyHandler = class {
       async query(operation, params) {
         const startTime = Date.now();
-        if (!QUERY_OPS9.has(operation)) {
+        if (!QUERY_OPS10.has(operation)) {
           return unsupportedOp("query", "sticky", operation, startTime);
         }
         try {
@@ -30094,9 +30680,30 @@ var init_sticky2 = __esm({
 });
 
 // packages/cleo/src/dispatch/domains/tasks.ts
-import { getLogger as getLogger15, getProjectRoot as getProjectRoot17 } from "@cleocode/core";
+import { getLogger as getLogger15, getProjectRoot as getProjectRoot18 } from "@cleocode/core";
+import { createAttachmentStore as createAttachmentStore4 } from "@cleocode/core/internal";
+async function fetchTaskAttachments(projectRoot, taskId) {
+  try {
+    const store = createAttachmentStore4();
+    const metas = await store.listByOwner("task", taskId, projectRoot);
+    const entries = [];
+    for (const meta of metas) {
+      const extras = await store.getExtras(meta.id, projectRoot);
+      const entry = {
+        attachmentId: meta.id,
+        kind: meta.attachment.kind,
+        ...extras?.slug != null ? { slug: extras.slug } : {},
+        ...extras?.type != null ? { type: extras.type } : {}
+      };
+      entries.push(entry);
+    }
+    return entries;
+  } catch {
+    return [];
+  }
+}
 async function sagaCreate(params) {
-  const projectRoot = getProjectRoot17();
+  const projectRoot = getProjectRoot18();
   const title = typeof params.title === "string" ? params.title : "";
   const description = typeof params.description === "string" ? params.description : void 0;
   const acceptance = Array.isArray(params.acceptance) ? params.acceptance : void 0;
@@ -30112,7 +30719,7 @@ async function sagaCreate(params) {
   );
 }
 async function sagaAdd(params) {
-  const projectRoot = getProjectRoot17();
+  const projectRoot = getProjectRoot18();
   const sagaId = typeof params.sagaId === "string" ? params.sagaId : "";
   const epicId = typeof params.epicId === "string" ? params.epicId : "";
   if (!sagaId || !epicId) {
@@ -30150,7 +30757,7 @@ async function sagaAdd(params) {
   return lafsSuccess({ sagaId, epicId, added: relResult.data?.added ?? true }, "saga.add");
 }
 async function sagaList() {
-  const projectRoot = getProjectRoot17();
+  const projectRoot = getProjectRoot18();
   const result = await taskList(projectRoot, { type: "epic", label: "saga" });
   if (!result.success) {
     return lafsError("E_GENERAL", result.error?.message ?? "Failed to list Sagas", "saga.list");
@@ -30163,7 +30770,7 @@ async function sagaList() {
   return lafsSuccess({ sagas: topLevel, total: topLevel.length }, "saga.list");
 }
 async function sagaMembers(params) {
-  const projectRoot = getProjectRoot17();
+  const projectRoot = getProjectRoot18();
   const sagaId = typeof params.sagaId === "string" ? params.sagaId : "";
   if (!sagaId) {
     return lafsError("E_INVALID_INPUT", "sagaId is required", "saga.members");
@@ -30188,7 +30795,7 @@ async function sagaMembers(params) {
   );
 }
 async function sagaRollup(params) {
-  const projectRoot = getProjectRoot17();
+  const projectRoot = getProjectRoot18();
   const sagaId = typeof params.sagaId === "string" ? params.sagaId : "";
   if (!sagaId) {
     return lafsError("E_INVALID_INPUT", "sagaId is required", "saga.rollup");
@@ -30228,7 +30835,7 @@ async function sagaRollup(params) {
     "saga.rollup"
   );
 }
-var _tasksTypedHandler, QUERY_OPS10, MUTATE_OPS10, TasksHandler;
+var _tasksTypedHandler, QUERY_OPS11, MUTATE_OPS10, TasksHandler;
 var init_tasks3 = __esm({
   "packages/cleo/src/dispatch/domains/tasks.ts"() {
     "use strict";
@@ -30240,17 +30847,29 @@ var init_tasks3 = __esm({
       // Query ops
       // -------------------------------------------------------------------------
       show: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         if (params.ivtrHistory) {
           return wrapCoreResult(await taskShowIvtrHistory(projectRoot, params.taskId), "show");
         }
         if (params.history) {
           return wrapCoreResult(await taskShowWithHistory(projectRoot, params.taskId, true), "show");
         }
-        return wrapCoreResult(await taskShow(projectRoot, params.taskId), "show");
+        const [coreResult, attachments] = await Promise.all([
+          taskShow(projectRoot, params.taskId),
+          fetchTaskAttachments(projectRoot, params.taskId)
+        ]);
+        if (!coreResult.success) {
+          return wrapCoreResult(coreResult, "show");
+        }
+        const showResult = {
+          task: coreResult.data.task,
+          view: coreResult.data.view,
+          attachments
+        };
+        return { success: true, data: showResult };
       },
       list: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         const result = await taskList(projectRoot, {
           parent: params.parent,
           status: params.status,
@@ -30276,7 +30895,7 @@ var init_tasks3 = __esm({
         return lafsSuccess(result.data, "list");
       },
       find: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(
           await taskFind(projectRoot, params.query, params.limit, {
             id: params.id,
@@ -30293,15 +30912,15 @@ var init_tasks3 = __esm({
         );
       },
       tree: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(await taskTree(projectRoot, params.taskId, params.withBlockers), "tree");
       },
       blockers: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(await taskBlockers(projectRoot, params), "blockers");
       },
       depends: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         if (params.action === "overview") {
           return wrapCoreResult(await taskDepsOverview(projectRoot), "depends");
         }
@@ -30321,14 +30940,14 @@ var init_tasks3 = __esm({
         );
       },
       "deps.validate": async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(
           await taskDepsValidate(projectRoot, params.epicId, params.scope),
           "deps.validate"
         );
       },
       "deps.tree": async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         if (!params.epicId) {
           return lafsError("E_INVALID_INPUT", "epicId is required for deps.tree", "deps.tree");
         }
@@ -30338,29 +30957,29 @@ var init_tasks3 = __esm({
         );
       },
       analyze: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(
           await taskAnalyze(projectRoot, params.taskId, { tierLimit: params.tierLimit }),
           "analyze"
         );
       },
       impact: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(
           await taskImpact(projectRoot, params.change, params.matchLimit),
           "impact"
         );
       },
       next: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(await taskNext(projectRoot, params), "next");
       },
       plan: async (_params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(await taskPlan(projectRoot), "plan");
       },
       relates: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         if (params.mode) {
           return wrapCoreResult(
             await taskRelatesFind(projectRoot, params.taskId, {
@@ -30373,36 +30992,36 @@ var init_tasks3 = __esm({
         return wrapCoreResult(await taskRelates(projectRoot, params.taskId), "relates");
       },
       "complexity.estimate": async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(
           await taskComplexityEstimate(projectRoot, { taskId: params.taskId }),
           "complexity.estimate"
         );
       },
       history: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         if (params.taskId) {
           return wrapCoreResult(await taskHistory(projectRoot, params.taskId, params.limit), "history");
         }
         return wrapCoreResult(await taskWorkHistory(projectRoot), "history");
       },
       current: async (_params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(await taskCurrentGet(projectRoot), "current");
       },
       "label.list": async (_params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(await taskLabelList(projectRoot), "label.list");
       },
       "sync.links": async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(await taskSyncLinks(projectRoot, params), "sync.links");
       },
       // -------------------------------------------------------------------------
       // Mutate ops
       // -------------------------------------------------------------------------
       "add-batch": async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(
           await tasksAddBatchOp(projectRoot, {
             tasks: params.tasks ?? [],
@@ -30413,7 +31032,7 @@ var init_tasks3 = __esm({
         );
       },
       add: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(
           await addTaskWithSessionScope(projectRoot, {
             title: params.title,
@@ -30441,7 +31060,7 @@ var init_tasks3 = __esm({
         );
       },
       update: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(
           await taskUpdate(projectRoot, params.taskId, {
             title: params.title,
@@ -30484,7 +31103,7 @@ var init_tasks3 = __esm({
         );
       },
       complete: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         if (params.force !== void 0) {
           return lafsError(
             "E_FLAG_REMOVED",
@@ -30507,15 +31126,15 @@ var init_tasks3 = __esm({
         return wrapCoreResult(result, "complete");
       },
       cancel: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(await taskCancel(projectRoot, params.taskId, params.reason), "cancel");
       },
       delete: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(await taskDelete(projectRoot, params.taskId, params.force), "delete");
       },
       archive: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(
           await taskArchive(projectRoot, params.taskId, params.before, {
             taskIds: params.taskIds,
@@ -30526,7 +31145,7 @@ var init_tasks3 = __esm({
         );
       },
       restore: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         if (params.from === "done") {
           return wrapCoreResult(
             await taskReopen(projectRoot, params.taskId, {
@@ -30554,21 +31173,21 @@ var init_tasks3 = __esm({
         );
       },
       reparent: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(
           await taskReparent(projectRoot, params.taskId, params.newParentId ?? null),
           "reparent"
         );
       },
       reorder: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(
           await taskReorder(projectRoot, params.taskId, params.position),
           "reorder"
         );
       },
       "relates.add": async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         const relatedId = params.relatedId ?? params.targetId;
         if (!relatedId) {
           return lafsError("E_INVALID_INPUT", "relatedId (or targetId) is required", "relates.add");
@@ -30579,7 +31198,7 @@ var init_tasks3 = __esm({
         );
       },
       "relates.remove": async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         if (!params.relatedId) {
           return lafsError("E_INVALID_INPUT", "relatedId is required", "relates.remove");
         }
@@ -30589,15 +31208,15 @@ var init_tasks3 = __esm({
         );
       },
       start: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(await taskStart(projectRoot, params.taskId), "start");
       },
       stop: async (_params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(await taskStop(projectRoot), "stop");
       },
       "sync.reconcile": async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(
           await taskSyncReconcile(projectRoot, {
             providerId: params.providerId,
@@ -30611,22 +31230,22 @@ var init_tasks3 = __esm({
         );
       },
       "sync.links.remove": async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(
           await taskSyncLinksRemove(projectRoot, params.providerId),
           "sync.links.remove"
         );
       },
       claim: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(await taskClaim(projectRoot, params.taskId, params.agentId), "claim");
       },
       unclaim: async (params) => {
-        const projectRoot = getProjectRoot17();
+        const projectRoot = getProjectRoot18();
         return wrapCoreResult(await taskUnclaim(projectRoot, params.taskId), "unclaim");
       }
     });
-    QUERY_OPS10 = /* @__PURE__ */ new Set([
+    QUERY_OPS11 = /* @__PURE__ */ new Set([
       "show",
       "list",
       "find",
@@ -30685,7 +31304,7 @@ var init_tasks3 = __esm({
        */
       async query(operation, params) {
         const startTime = Date.now();
-        if (!QUERY_OPS10.has(operation)) {
+        if (!QUERY_OPS11.has(operation)) {
           return unsupportedOp("query", "tasks", operation, startTime);
         }
         if (operation === "impact" && !params?.change) {
@@ -30849,7 +31468,7 @@ var init_tasks3 = __esm({
 });
 
 // packages/cleo/src/dispatch/domains/tools.ts
-import { getLogger as getLogger16, getProjectRoot as getProjectRoot18 } from "@cleocode/core";
+import { getLogger as getLogger16, getProjectRoot as getProjectRoot19 } from "@cleocode/core";
 import {
   codeOutline,
   codeParse,
@@ -30900,7 +31519,7 @@ var init_tools = __esm({
     init_routing();
     ToolsHandler = class {
       get projectRoot() {
-        return getProjectRoot18();
+        return getProjectRoot19();
       }
       // -----------------------------------------------------------------------
       // DomainHandler interface
@@ -31482,7 +32101,7 @@ var init_tools = __esm({
 // packages/cleo/src/dispatch/domains/upgrade.ts
 import { dirname as dirname3, resolve as resolve3 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
-import { getLogger as getLogger17, getProjectRoot as getProjectRoot19 } from "@cleocode/core";
+import { getLogger as getLogger17, getProjectRoot as getProjectRoot20 } from "@cleocode/core";
 import { upgradeWorkflows } from "@cleocode/core/internal";
 function resolveTemplatesDir() {
   const here = dirname3(fileURLToPath2(import.meta.url));
@@ -31522,7 +32141,7 @@ var init_upgrade = __esm({
             case "workflows": {
               const includeRendered = params?.["includeRendered"] === true;
               const result = await upgradeWorkflows({
-                projectRoot: getProjectRoot19(),
+                projectRoot: getProjectRoot20(),
                 templatesDir: resolveTemplatesDir(),
                 dryRun: true
               });
@@ -31565,7 +32184,7 @@ var init_upgrade = __esm({
               const dryRun = params?.["dryRun"] === true;
               const includeRendered = params?.["includeRendered"] === true;
               const result = await upgradeWorkflows({
-                projectRoot: getProjectRoot19(),
+                projectRoot: getProjectRoot20(),
                 templatesDir: resolveTemplatesDir(),
                 force,
                 dryRun
@@ -31607,7 +32226,7 @@ import {
   adoptWorktree,
   forceUnlockWorktree,
   getLogger as getLogger18,
-  getProjectRoot as getProjectRoot20,
+  getProjectRoot as getProjectRoot21,
   listWorktrees,
   pruneOrphanedWorktreesByStatus
 } from "@cleocode/core/internal";
@@ -31659,7 +32278,7 @@ var init_worktree2 = __esm({
           switch (operation) {
             case "list": {
               const opts = {
-                projectRoot: getProjectRoot20(),
+                projectRoot: getProjectRoot21(),
                 statusFilter: coerceStatusFilter(params?.["statusFilter"]),
                 staleDays: typeof params?.["staleDays"] === "number" ? params["staleDays"] : void 0
               };
@@ -31722,7 +32341,7 @@ var init_worktree2 = __esm({
               const rawTaskId = params?.["taskId"];
               const taskId = rawTaskId === null ? null : typeof rawTaskId === "string" && rawTaskId.length > 0 ? rawTaskId : void 0;
               const opts = {
-                projectRoot: getProjectRoot20(),
+                projectRoot: getProjectRoot21(),
                 worktreePath,
                 ...source !== void 0 ? { source } : {},
                 ...taskId !== void 0 ? { taskId } : {},
@@ -31755,7 +32374,7 @@ var init_worktree2 = __esm({
                 deleteBranch: params?.["deleteBranch"] !== false,
                 ...typeof params?.["reason"] === "string" && params["reason"].length > 0 ? { reason: params["reason"] } : {}
               };
-              const result = await destroyWorktree(getProjectRoot20(), opts);
+              const result = await destroyWorktree(getProjectRoot21(), opts);
               const engineResult = result.error !== void 0 ? {
                 success: false,
                 error: {
@@ -31774,7 +32393,7 @@ var init_worktree2 = __esm({
             }
             case "prune": {
               const opts = {
-                projectRoot: getProjectRoot20(),
+                projectRoot: getProjectRoot21(),
                 dryRun: params?.["dryRun"] === true,
                 ...typeof params?.["staleDays"] === "number" ? { staleDays: params["staleDays"] } : {},
                 ...typeof params?.["idleDays"] === "number" ? { staleDays: params["idleDays"] } : {},
@@ -31803,7 +32422,7 @@ var init_worktree2 = __esm({
                 );
               }
               const opts = {
-                projectRoot: getProjectRoot20(),
+                projectRoot: getProjectRoot21(),
                 taskId,
                 ...typeof params?.["actor"] === "string" && params["actor"].length > 0 ? { actor: params["actor"] } : {}
               };
@@ -31856,6 +32475,7 @@ function createDomainHandlers() {
   handlers.set("sticky", new StickyHandler());
   handlers.set("diagnostics", new DiagnosticsHandler());
   handlers.set("docs", new DocsHandler());
+  handlers.set("focus", new FocusHandler());
   handlers.set("playbook", new PlaybookHandler());
   handlers.set("conduit", new ConduitHandler());
   handlers.set("sentient", new SentientHandler());
@@ -31874,6 +32494,7 @@ var init_domains = __esm({
     init_conduit2();
     init_diagnostics();
     init_docs2();
+    init_focus2();
     init_intelligence2();
     init_llm2();
     init_memory2();
@@ -32326,11 +32947,11 @@ var init_security = __esm({
 });
 
 // packages/cleo/src/dispatch/middleware/sanitizer.ts
-function createSanitizer(getProjectRoot43) {
+function createSanitizer(getProjectRoot44) {
   return async (req, next) => {
     if (req.params) {
       try {
-        const root = getProjectRoot43 ? getProjectRoot43() : void 0;
+        const root = getProjectRoot44 ? getProjectRoot44() : void 0;
         req.params = sanitizeParams(req.params, root, {
           domain: req.domain,
           operation: req.operation
@@ -32455,7 +33076,7 @@ import { createRequire } from "node:module";
 import { dirname as dirname4, join as join8 } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 import { catalog, registerSkillLibraryFromPath } from "@cleocode/caamp";
-import { autoRecordDispatchTokenUsage, getProjectRoot as getProjectRoot21, hooks } from "@cleocode/core/internal";
+import { autoRecordDispatchTokenUsage, getProjectRoot as getProjectRoot22, hooks } from "@cleocode/core/internal";
 function ensureCaampLibrary() {
   if (catalog.isCatalogAvailable()) return;
   try {
@@ -32506,7 +33127,7 @@ function createCliDispatcher() {
     middlewares: [
       createSessionResolver(lookupCliSession),
       // T4959: session identity first
-      createSanitizer(() => getProjectRoot21()),
+      createSanitizer(() => getProjectRoot22()),
       createFieldFilter(),
       createAudit(),
       // T4959: CLI now gets audit trail
@@ -32520,7 +33141,7 @@ function resetCliDispatcher() {
 }
 async function dispatchFromCli(gateway, domain, operation, params, outputOpts) {
   const dispatcher = getCliDispatcher();
-  const projectRoot = getProjectRoot21();
+  const projectRoot = getProjectRoot22();
   const dispatchStart = Date.now();
   hooks.dispatch("PromptSubmit", projectRoot, {
     timestamp: (/* @__PURE__ */ new Date()).toISOString(),
@@ -32565,7 +33186,7 @@ async function dispatchFromCli(gateway, domain, operation, params, outputOpts) {
       operation,
       sessionId: response.meta.sessionId,
       requestId: response.meta.requestId,
-      cwd: getProjectRoot21()
+      cwd: getProjectRoot22()
     });
     const opts = {
       command: outputOpts?.command ?? operation,
@@ -32627,7 +33248,7 @@ function handleRawError(response, _opts) {
 }
 async function dispatchRaw(gateway, domain, operation, params) {
   const dispatcher = getCliDispatcher();
-  const projectRoot = getProjectRoot21();
+  const projectRoot = getProjectRoot22();
   const dispatchStart = Date.now();
   hooks.dispatch("PromptSubmit", projectRoot, {
     timestamp: (/* @__PURE__ */ new Date()).toISOString(),
@@ -32982,7 +33603,7 @@ __export(add_exports, {
 });
 import {
   appendSignedSeverityAttestation,
-  getProjectRoot as getProjectRoot22,
+  getProjectRoot as getProjectRoot23,
   inferTaskAddParams
 } from "@cleocode/core";
 var addCommand;
@@ -33211,7 +33832,7 @@ For 2+ tasks at once: cleo add-batch --file tasks.json (single transaction, atom
           return;
         }
         if (args["depends-waiver"] !== void 0) params["dependsWaiver"] = args["depends-waiver"];
-        const inferred = await inferTaskAddParams(getProjectRoot22(), {
+        const inferred = await inferTaskAddParams(getProjectRoot23(), {
           title: args.title,
           description: args.description ?? args.desc,
           filesInfer: args["files-infer"],
@@ -33835,7 +34456,7 @@ var agent_exports = {};
 __export(agent_exports, {
   agentCommand: () => agentCommand
 });
-import { getProjectRoot as getProjectRoot23 } from "@cleocode/core";
+import { getProjectRoot as getProjectRoot24 } from "@cleocode/core";
 import {
   checkAgentHealth,
   detectCrashedAgents,
@@ -34228,7 +34849,7 @@ var init_agent = __esm({
           const { AgentRegistryAccessor } = await import("@cleocode/core/agents");
           const { getDb: getDb3 } = await import("@cleocode/core/internal");
           await getDb3();
-          const registry = new AgentRegistryAccessor(getProjectRoot23());
+          const registry = new AgentRegistryAccessor(getProjectRoot24());
           const agentId = args.id;
           const displayName = args.name;
           const classification = args.classification;
@@ -34346,7 +34967,7 @@ agent ${agentId}:
           const { AgentRegistryAccessor } = await import("@cleocode/core/agents");
           const { getDb: getDb3 } = await import("@cleocode/core/internal");
           await getDb3();
-          const registry = new AgentRegistryAccessor(getProjectRoot23());
+          const registry = new AgentRegistryAccessor(getProjectRoot24());
           const credential = await registry.get(args.agentId);
           if (!credential) {
             cliOutput(
@@ -34434,7 +35055,7 @@ agent ${agentId}:
           const { existsSync: existsSync18, readFileSync: readFileSync19 } = await import("node:fs");
           const { join: join35 } = await import("node:path");
           await getDb3();
-          const registry = new AgentRegistryAccessor(getProjectRoot23());
+          const registry = new AgentRegistryAccessor(getProjectRoot24());
           const credential = await registry.get(args.agentId);
           if (!credential) {
             cliOutput(
@@ -34553,7 +35174,7 @@ agent ${agentId}:
           const { AgentRegistryAccessor } = await import("@cleocode/core/agents");
           const { getDb: getDb3 } = await import("@cleocode/core/internal");
           await getDb3();
-          const registry = new AgentRegistryAccessor(getProjectRoot23());
+          const registry = new AgentRegistryAccessor(getProjectRoot24());
           const credential = await registry.get(args.agentId);
           if (!credential) {
             cliOutput(
@@ -34610,7 +35231,7 @@ agent ${agentId}:
           const { AgentRegistryAccessor } = await import("@cleocode/core/agents");
           const { getDb: getDb3 } = await import("@cleocode/core/internal");
           await getDb3();
-          const registry = new AgentRegistryAccessor(getProjectRoot23());
+          const registry = new AgentRegistryAccessor(getProjectRoot24());
           if (args.agentId) {
             const credential = await registry.get(args.agentId);
             if (!credential) {
@@ -34686,7 +35307,7 @@ agent ${agentId}:
           const { AgentRegistryAccessor, createConduit } = await import("@cleocode/core/agents");
           const { getDb: getDb3 } = await import("@cleocode/core/internal");
           await getDb3();
-          const registry = new AgentRegistryAccessor(getProjectRoot23());
+          const registry = new AgentRegistryAccessor(getProjectRoot24());
           const active = await registry.getActive();
           if (!active) {
             cliOutput(
@@ -34743,7 +35364,7 @@ Assigned task ${args.taskId}. Run: cleo show ${args.taskId} && cleo start ${args
           const { AgentRegistryAccessor, createConduit } = await import("@cleocode/core/agents");
           const { getDb: getDb3 } = await import("@cleocode/core/internal");
           await getDb3();
-          const registry = new AgentRegistryAccessor(getProjectRoot23());
+          const registry = new AgentRegistryAccessor(getProjectRoot24());
           const active = await registry.getActive();
           if (!active) {
             cliOutput(
@@ -34809,7 +35430,7 @@ You are idle. Check your queue: cleo current || cleo next. Report status immedia
           const { AgentRegistryAccessor } = await import("@cleocode/core/agents");
           const { getDb: getDb3 } = await import("@cleocode/core/internal");
           await getDb3();
-          const registry = new AgentRegistryAccessor(getProjectRoot23());
+          const registry = new AgentRegistryAccessor(getProjectRoot24());
           const role = args.role;
           const taskId = args.task;
           const model = args.model ?? "sonnet";
@@ -34874,7 +35495,7 @@ You are idle. Check your queue: cleo current || cleo next. Report status immedia
           const { AgentRegistryAccessor, createConduit } = await import("@cleocode/core/agents");
           const { getDb: getDb3 } = await import("@cleocode/core/internal");
           await getDb3();
-          const registry = new AgentRegistryAccessor(getProjectRoot23());
+          const registry = new AgentRegistryAccessor(getProjectRoot24());
           const active = await registry.getActive();
           if (!active) {
             cliOutput(
@@ -34918,7 +35539,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
           const { AgentRegistryAccessor } = await import("@cleocode/core/agents");
           const { getDb: getDb3 } = await import("@cleocode/core/internal");
           await getDb3();
-          const registry = new AgentRegistryAccessor(getProjectRoot23());
+          const registry = new AgentRegistryAccessor(getProjectRoot24());
           const agents = await registry.list({ active: true });
           let stopped = 0;
           for (const a of agents) {
@@ -34991,7 +35612,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
           const { promisify: promisify2 } = await import("node:util");
           const execFileAsync = promisify2(execFile2);
           await getDb3();
-          const registry = new AgentRegistryAccessor(getProjectRoot23());
+          const registry = new AgentRegistryAccessor(getProjectRoot24());
           const credential = await registry.get(args.agentId);
           if (!credential) {
             cliOutput(
@@ -35148,7 +35769,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
           await getDb3();
           const includeGlobal = args.global === true;
           const includeDisabled = args["include-disabled"] === true;
-          const agents = listAgentsForProject(getProjectRoot23(), {
+          const agents = listAgentsForProject(getProjectRoot24(), {
             includeGlobal,
             includeDisabled
           });
@@ -35199,7 +35820,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
           const { getDb: getDb3 } = await import("@cleocode/core/internal");
           await getDb3();
           const includeGlobal = args.global === true;
-          const agent = lookupAgent(getProjectRoot23(), args.agentId, { includeGlobal });
+          const agent = lookupAgent(getProjectRoot24(), args.agentId, { includeGlobal });
           if (!agent) {
             cliOutput(
               {
@@ -35265,7 +35886,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
           const { AgentRegistryAccessor, attachAgentToProject, lookupAgent } = await import("@cleocode/core/agents");
           const { getDb: getDb3 } = await import("@cleocode/core/internal");
           await getDb3();
-          const projectRoot = getProjectRoot23();
+          const projectRoot = getProjectRoot24();
           const _registry = new AgentRegistryAccessor(projectRoot);
           void _registry;
           const globalAgent = lookupAgent(projectRoot, args.agentId, { includeGlobal: true });
@@ -35321,7 +35942,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
           const { AgentRegistryAccessor, detachAgentFromProject, getProjectAgentRef } = await import("@cleocode/core/agents");
           const { getDb: getDb3 } = await import("@cleocode/core/internal");
           await getDb3();
-          const projectRoot = getProjectRoot23();
+          const projectRoot = getProjectRoot24();
           const _registry = new AgentRegistryAccessor(projectRoot);
           void _registry;
           const ref = getProjectAgentRef(projectRoot, args.agentId);
@@ -35378,7 +35999,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
           const { AgentRegistryAccessor, detachAgentFromProject, getProjectAgentRef } = await import("@cleocode/core/agents");
           const { getDb: getDb3 } = await import("@cleocode/core/internal");
           await getDb3();
-          const projectRoot = getProjectRoot23();
+          const projectRoot = getProjectRoot24();
           if (!args.global) {
             const _registry = new AgentRegistryAccessor(projectRoot);
             void _registry;
@@ -35460,7 +36081,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
           const { AgentRegistryAccessor } = await import("@cleocode/core/agents");
           const { getDb: getDb3 } = await import("@cleocode/core/internal");
           await getDb3();
-          const registry = new AgentRegistryAccessor(getProjectRoot23());
+          const registry = new AgentRegistryAccessor(getProjectRoot24());
           const result = await registry.rotateKey(args.agentId);
           cliOutput(
             {
@@ -35499,7 +36120,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
           const { AgentRegistryAccessor } = await import("@cleocode/core/agents");
           const { getDb: getDb3 } = await import("@cleocode/core/internal");
           await getDb3();
-          const registry = new AgentRegistryAccessor(getProjectRoot23());
+          const registry = new AgentRegistryAccessor(getProjectRoot24());
           const credential = await registry.get(args.agentId);
           if (!credential) {
             cliOutput(
@@ -35574,7 +36195,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
           const { getDb: getDb3 } = await import("@cleocode/core/internal");
           const { createRuntime } = await import("@cleocode/runtime");
           await getDb3();
-          const registry = new AgentRegistryAccessor(getProjectRoot23());
+          const registry = new AgentRegistryAccessor(getProjectRoot24());
           const groupIds = args.group ? args.group.split(",").map((s) => s.trim()) : void 0;
           const handle = await createRuntime(registry, {
             agentId: args.agent,
@@ -35657,7 +36278,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
           const { AgentRegistryAccessor, createConduit } = await import("@cleocode/core/agents");
           const { getDb: getDb3 } = await import("@cleocode/core/internal");
           await getDb3();
-          const registry = new AgentRegistryAccessor(getProjectRoot23());
+          const registry = new AgentRegistryAccessor(getProjectRoot24());
           const agentId = args.agent;
           const conduit = await createConduit(registry, agentId);
           const limit = Number(args.limit) || 20;
@@ -35709,7 +36330,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
           const { AgentRegistryAccessor, createConduit } = await import("@cleocode/core/agents");
           const { getDb: getDb3 } = await import("@cleocode/core/internal");
           await getDb3();
-          const registry = new AgentRegistryAccessor(getProjectRoot23());
+          const registry = new AgentRegistryAccessor(getProjectRoot24());
           const agentId = args.agent;
           const to = args.to;
           const conv = args.conv;
@@ -35987,7 +36608,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
           const db = _sdDb;
           const isGlobal = args.global === true;
           const targetTier = isGlobal ? "global" : "project";
-          const projectRoot = getProjectRoot23();
+          const projectRoot = getProjectRoot24();
           try {
             if (args.resync) {
               const parsedName = basename(cantPath, ".cant");
@@ -36284,7 +36905,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
             const xdgData = process.env["XDG_DATA_HOME"] ?? join35(home, ".local", "share");
             targetRoot = join35(xdgData, "cleo", "cant", "agents");
           } else {
-            targetRoot = join35(getProjectRoot23(), CLEO_DIR_NAME, CANT_AGENTS_SUBDIR);
+            targetRoot = join35(getProjectRoot24(), CLEO_DIR_NAME, CANT_AGENTS_SUBDIR);
           }
           const agentDir = join35(targetRoot, name);
           if (existsSync18(agentDir)) {
@@ -36357,7 +36978,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
             const { AgentRegistryAccessor } = await import("@cleocode/core/agents");
             const { getDb: getDb3 } = await import("@cleocode/core/internal");
             await getDb3();
-            const registry = new AgentRegistryAccessor(getProjectRoot23());
+            const registry = new AgentRegistryAccessor(getProjectRoot24());
             const existing = await registry.get(name);
             if (!existing) {
               const descMatch = personaContent.match(/description:\s*"([^"]+)"/);
@@ -36441,7 +37062,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
             return;
           }
           const specContent = readFileSync19(specPath, "utf-8");
-          const projectRoot = getProjectRoot23();
+          const projectRoot = getProjectRoot24();
           const outputDir = args["output-dir"] ? resolve9(args["output-dir"]) : join35(projectRoot, ".cleo", "cant", "agents");
           mkdirSync6(outputDir, { recursive: true });
           if (args["dry-run"]) {
@@ -36572,7 +37193,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
           const { db: _sdDb3 } = await openCleoDb2("signaldock");
           const db = _sdDb3;
           try {
-            const report = await buildDoctorReport(db, { projectRoot: getProjectRoot23() });
+            const report = await buildDoctorReport(db, { projectRoot: getProjectRoot24() });
             const repairFlag = args.repair === true;
             let reconciled;
             if (repairFlag) {
@@ -36840,7 +37461,7 @@ var audit_exports = {};
 __export(audit_exports, {
   auditCommand: () => auditCommand
 });
-import { getProjectRoot as getProjectRoot24, reconstructLineage } from "@cleocode/core/internal";
+import { getProjectRoot as getProjectRoot25, reconstructLineage } from "@cleocode/core/internal";
 var reconstructCommand, auditCommand;
 var init_audit2 = __esm({
   "packages/cleo/src/cli/commands/audit.ts"() {
@@ -36884,7 +37505,7 @@ var init_audit2 = __esm({
           repoRoot = args["repo-root"];
         } else {
           try {
-            repoRoot = getProjectRoot24(process.cwd()) ?? process.cwd();
+            repoRoot = getProjectRoot25(process.cwd()) ?? process.cwd();
           } catch {
             repoRoot = process.cwd();
           }
@@ -37508,7 +38129,7 @@ var backfill_exports = {};
 __export(backfill_exports, {
   backfillCommand: () => backfillCommand
 });
-import { backfillTasks, getProjectRoot as getProjectRoot25, populateEmbeddings } from "@cleocode/core/internal";
+import { backfillTasks, getProjectRoot as getProjectRoot26, populateEmbeddings } from "@cleocode/core/internal";
 var backfillCommand;
 var init_backfill = __esm({
   "packages/cleo/src/cli/commands/backfill.ts"() {
@@ -37542,7 +38163,7 @@ var init_backfill = __esm({
         }
       },
       async run({ args }) {
-        const root = getProjectRoot25();
+        const root = getProjectRoot26();
         if (args.embeddings) {
           try {
             let lastLine = "";
@@ -38060,9 +38681,9 @@ var init_backup = __esm({
       async run({ args }) {
         const scope = args.scope;
         const { packBundle } = await import("@cleocode/core/store/backup-pack.js");
-        const { getProjectRoot: getProjectRoot43 } = await import("@cleocode/core");
+        const { getProjectRoot: getProjectRoot44 } = await import("@cleocode/core");
         const includesProject = scope === "project" || scope === "all";
-        const projectRoot = includesProject ? getProjectRoot43() : void 0;
+        const projectRoot = includesProject ? getProjectRoot44() : void 0;
         let passphrase;
         if (args.encrypt === true) {
           passphrase = process.env["CLEO_BACKUP_PASSPHRASE"];
@@ -38138,12 +38759,12 @@ var init_backup = __esm({
       },
       async run({ args }) {
         const bundlePath = args.bundle;
-        const { getProjectRoot: getProjectRoot43, getCleoHome: getCleoHome6, getCleoVersion } = await import("@cleocode/core");
+        const { getProjectRoot: getProjectRoot44, getCleoHome: getCleoHome6, getCleoVersion } = await import("@cleocode/core");
         const { BundleError, cleanupStaging, unpackBundle } = await import("@cleocode/core/store/backup-unpack.js");
         const { regenerateConfigJson, regenerateProjectContextJson, regenerateProjectInfoJson } = await import("@cleocode/core/store/regenerators.js");
         const { regenerateAndCompare } = await import("@cleocode/core/store/restore-json-merge.js");
         const { buildConflictReport, writeConflictReport } = await import("@cleocode/core/store/restore-conflict-report.js");
-        const projectRoot = getProjectRoot43();
+        const projectRoot = getProjectRoot44();
         if (args.force !== true) {
           const existing = checkForExistingData(projectRoot, getCleoHome6());
           if (existing.length > 0) {
@@ -38361,7 +38982,7 @@ var brain_exports = {};
 __export(brain_exports, {
   brainCommand: () => brainCommand
 });
-import { getProjectRoot as getProjectRoot26 } from "@cleocode/core";
+import { getProjectRoot as getProjectRoot27 } from "@cleocode/core";
 import {
   backfillBrainGraph,
   exportBrainAsGexf,
@@ -38406,7 +39027,7 @@ var init_brain2 = __esm({
         json: { type: "boolean", description: "Output results as JSON" }
       },
       async run({ args }) {
-        const root = getProjectRoot26();
+        const root = getProjectRoot27();
         try {
           const result = await runBrainMaintenance(root, {
             skipDecay: !!args["skip-decay"],
@@ -38477,7 +39098,7 @@ var init_brain2 = __esm({
         json: { type: "boolean", description: "Output results as JSON" }
       },
       async run({ args: _args }) {
-        const root = getProjectRoot26();
+        const root = getProjectRoot27();
         try {
           const result = await backfillBrainGraph(root);
           cliOutput(
@@ -38518,7 +39139,7 @@ var init_brain2 = __esm({
         json: { type: "boolean", description: "Output results as JSON" }
       },
       async run({ args: _args }) {
-        const root = getProjectRoot26();
+        const root = getProjectRoot27();
         try {
           const result = await purgeBrainNoise(root);
           cliOutput(
@@ -38564,7 +39185,7 @@ var init_brain2 = __esm({
         json: { type: "boolean", description: "Output results as JSON" }
       },
       async run({ args }) {
-        const root = getProjectRoot26();
+        const root = getProjectRoot27();
         const limit = Number.parseInt(args.limit, 10) || 20;
         try {
           const stats = await getPlasticityStats(root, limit);
@@ -38614,7 +39235,7 @@ var init_brain2 = __esm({
         json: { type: "boolean", description: "Output results as JSON" }
       },
       async run({ args: _args }) {
-        const root = getProjectRoot26();
+        const root = getProjectRoot27();
         try {
           const report = await getMemoryQualityReport(root);
           cliOutput(
@@ -38663,7 +39284,7 @@ var init_brain2 = __esm({
         }
       },
       async run({ args }) {
-        const root = getProjectRoot26();
+        const root = getProjectRoot27();
         const format = args.format ?? "gexf";
         if (format !== "gexf" && format !== "json") {
           cliError(`Invalid format: ${format}. Use 'gexf' or 'json'.`, "E_VALIDATION", {
@@ -38880,7 +39501,7 @@ var init_briefing = __esm({
         "max-next": {
           type: "string",
           description: "Maximum next tasks to show",
-          default: "5"
+          default: "3"
         },
         "max-bugs": {
           type: "string",
@@ -38908,6 +39529,25 @@ var init_briefing = __esm({
           type: "boolean",
           description: "Exit non-zero when briefing contract violations are detected (T1905)",
           alias: "x"
+        },
+        /**
+         * T9974: debug mode — surface peerPatterns and other verbose fields
+         * suppressed by default. Passing --debug --with-profile --max-next 5
+         * restores the ~pre-T9974 output shape.
+         */
+        debug: {
+          type: "boolean",
+          description: "Include verbose debug fields (peerPatterns etc.) suppressed by default",
+          default: false
+        },
+        /**
+         * T9974: include cold.userProfile traits in the bundle.
+         * Off by default — large trait dump rarely needed at session start.
+         */
+        "with-profile": {
+          type: "boolean",
+          description: "Include user profile traits in the bundle (suppressed by default)",
+          default: false
         }
       },
       async run({ args, cmd, rawArgs }) {
@@ -38933,7 +39573,9 @@ var init_briefing = __esm({
             maxNextTasks: parseInt(args["max-next"], 10),
             maxBugs: parseInt(args["max-bugs"], 10),
             maxBlocked: parseInt(args["max-blocked"], 10),
-            maxEpics: parseInt(args["max-epics"], 10)
+            maxEpics: parseInt(args["max-epics"], 10),
+            debug: args.debug,
+            withProfile: args["with-profile"]
           },
           { command: "briefing" }
         );
@@ -39448,7 +40090,7 @@ __export(changeset_exports, {
 });
 import { existsSync as existsSync11 } from "node:fs";
 import { join as join14 } from "node:path";
-import { changesets, getProjectRoot as getProjectRoot27 } from "@cleocode/core";
+import { changesets, getProjectRoot as getProjectRoot28 } from "@cleocode/core";
 function isValidKind(raw) {
   return typeof raw === "string" && CHANGESET_KINDS.includes(raw);
 }
@@ -39543,7 +40185,7 @@ var init_changeset = __esm({
           ...typeof args.notes === "string" && args.notes.length > 0 ? { notes: args.notes } : {},
           ...typeof args.breaking === "string" && args.breaking.length > 0 ? { breaking: args.breaking } : {}
         };
-        const projectRoot = getProjectRoot27();
+        const projectRoot = getProjectRoot28();
         const outcome = await changesets.writeChangesetEntry(entry, {
           projectRoot,
           ...typeof args["attached-by"] === "string" && args["attached-by"].length > 0 ? { attachedBy: args["attached-by"] } : {}
@@ -39570,7 +40212,7 @@ var init_changeset = __esm({
       },
       args: {},
       async run() {
-        const projectRoot = getProjectRoot27();
+        const projectRoot = getProjectRoot28();
         const dir = join14(projectRoot, ".changeset");
         if (!existsSync11(dir)) {
           const empty = { entries: [], count: 0, dir, note: "no .changeset/ dir" };
@@ -39959,7 +40601,7 @@ var init_check2 = __esm({
         }
       },
       async run({ args }) {
-        const { execSync: execSync2 } = await import("node:child_process");
+        const { execSync: execSync3 } = await import("node:child_process");
         const since = args.since;
         const branch = args.branch || "HEAD";
         const strict = Boolean(args.strict);
@@ -39967,7 +40609,7 @@ var init_check2 = __esm({
         const range = since ? `${since}..${branch}` : branch;
         let logOutput;
         try {
-          logOutput = execSync2(`git log --no-merges --pretty=format:"%H	%s" -n ${limit} ${range}`, {
+          logOutput = execSync3(`git log --no-merges --pretty=format:"%H	%s" -n ${limit} ${range}`, {
             encoding: "utf8",
             stdio: ["pipe", "pipe", "pipe"]
           });
@@ -39980,7 +40622,7 @@ var init_check2 = __esm({
           process.exit(1);
         }
         const lines = logOutput.trim().split("\n").filter(Boolean);
-        const TASK_ID_RE2 = /T[0-9]+/;
+        const TASK_ID_RE3 = /T[0-9]+/;
         const EXEMPT_RE = /^(Merge |Revert |fixup! |squash! |amend! )/;
         const untagged = [];
         const total = lines.length;
@@ -39990,7 +40632,7 @@ var init_check2 = __esm({
           const sha = line.slice(0, tabIdx).trim();
           const subject = line.slice(tabIdx + 1).trim();
           if (EXEMPT_RE.test(subject)) continue;
-          if (!TASK_ID_RE2.test(subject)) {
+          if (!TASK_ID_RE3.test(subject)) {
             untagged.push({ sha: sha.slice(0, 12), subject });
           }
         }
@@ -43006,8 +43648,8 @@ import { stat } from "node:fs/promises";
 import { dirname as dirname8, join as join19, normalize, resolve as resolve5 } from "node:path";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 import {
-  createAttachmentStore as createAttachmentStore2,
-  getProjectRoot as getProjectRoot28,
+  createAttachmentStore as createAttachmentStore5,
+  getProjectRoot as getProjectRoot29,
   searchAllProjectDocs
 } from "@cleocode/core/internal";
 function getViewerAssetsDir() {
@@ -43067,9 +43709,9 @@ async function serveStatic(res, assetsDir, relPath) {
   }
 }
 function buildViewerHandler(opts = {}) {
-  const projectRoot = opts.projectRoot ?? getProjectRoot28();
+  const projectRoot = opts.projectRoot ?? getProjectRoot29();
   const assetsDir = getViewerAssetsDir();
-  const store = createAttachmentStore2();
+  const store = createAttachmentStore5();
   return async (req, res) => {
     try {
       const method = (req.method ?? "GET").toUpperCase();
@@ -43245,7 +43887,7 @@ import { spawn } from "node:child_process";
 import { open as fsOpen } from "node:fs/promises";
 import { join as join20 } from "node:path";
 import { fileURLToPath as fileURLToPath6 } from "node:url";
-import { getCleoHome as getCleoHome3, getProjectRoot as getProjectRoot29 } from "@cleocode/core";
+import { getCleoHome as getCleoHome3, getProjectRoot as getProjectRoot30 } from "@cleocode/core";
 function getCleoBinPath() {
   const thisFile = fileURLToPath6(import.meta.url);
   return join20(thisFile, "..", "..", "index.js");
@@ -43296,7 +43938,7 @@ async function spawnDetachedServer(opts) {
     detached: true,
     stdio,
     env: { ...process.env, [DETACHED_CHILD_ENV]: "1" },
-    cwd: getProjectRoot29()
+    cwd: getProjectRoot30()
   });
   child.unref();
   if (handle) await handle.close();
@@ -43448,7 +44090,7 @@ var init_docs_viewer = __esm({
           pid: process.pid,
           port: handle.port,
           host: handle.host,
-          projectRoot: getProjectRoot29(),
+          projectRoot: getProjectRoot30(),
           startedAt: Date.now()
         };
         await writeViewerPidFile(record);
@@ -43732,7 +44374,7 @@ import {
   createAttachmentStoreDocsAccessor,
   exportDocument,
   getAgentOutputsAbsolute,
-  getProjectRoot as getProjectRoot30,
+  getProjectRoot as getProjectRoot31,
   listDocVersions,
   makeClassifierForScanRoot,
   mergeDocs,
@@ -44118,7 +44760,7 @@ var init_docs3 = __esm({
         const taskId = String(args.task);
         const includeAttachments = args["include-attachments"] !== false;
         const includeMemoryRefs = args["include-memory-refs"] === true;
-        const projectRoot = getProjectRoot30();
+        const projectRoot = getProjectRoot31();
         try {
           const result = await exportDocument({
             taskId,
@@ -44184,7 +44826,7 @@ var init_docs3 = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot30();
+        const projectRoot = getProjectRoot31();
         const limit = args.limit ? Number.parseInt(String(args.limit), 10) : 10;
         try {
           const result = args.owner ? await searchDocs2(String(args.query), {
@@ -44240,7 +44882,7 @@ var init_docs3 = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot30();
+        const projectRoot = getProjectRoot31();
         const rawStrategy = args.strategy ?? "three-way";
         const strategy = rawStrategy === "cherry-pick" || rawStrategy === "multi-diff" ? rawStrategy : "three-way";
         try {
@@ -44289,7 +44931,7 @@ var init_docs3 = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot30();
+        const projectRoot = getProjectRoot31();
         const fmt = args.format ?? "mermaid";
         try {
           const result = await buildDocsGraph({ ownerId: String(args.for), projectRoot });
@@ -44358,7 +45000,7 @@ var init_docs3 = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot30();
+        const projectRoot = getProjectRoot31();
         try {
           const result = await rankDocs({
             ownerId: String(args.for),
@@ -44396,7 +45038,7 @@ var init_docs3 = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot30();
+        const projectRoot = getProjectRoot31();
         try {
           const result = await listDocVersions({
             ownerId: String(args.for),
@@ -44439,7 +45081,7 @@ var init_docs3 = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot30();
+        const projectRoot = getProjectRoot31();
         try {
           const result = await publishDocs({
             ownerId: String(args.for),
@@ -44563,7 +45205,7 @@ var init_docs3 = __esm({
       },
       async run({ args }) {
         if (args.from) {
-          const projectRoot = getProjectRoot30();
+          const projectRoot = getProjectRoot31();
           const ownerId = args.for ?? void 0;
           if (!ownerId) {
             cliError(
@@ -44630,7 +45272,7 @@ var init_docs3 = __esm({
         }
       },
       async run() {
-        const projectRoot = getProjectRoot30();
+        const projectRoot = getProjectRoot31();
         try {
           const result = await statusDocs({ projectRoot });
           cliOutput(result, { command: "docs status", operation: "docs.status" });
@@ -44715,7 +45357,7 @@ var init_docs3 = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot30();
+        const projectRoot = getProjectRoot31();
         const dirArg = String(args.dir);
         const scanRoot = isAbsolute2(dirArg) ? dirArg : resolve6(projectRoot, dirArg);
         const dryRun = args["dry-run"] === true;
@@ -44789,15 +45431,15 @@ var init_docs3 = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot30();
+        const projectRoot = getProjectRoot31();
         const { registry, configError } = loadCliRegistry(projectRoot);
         const kinds = registry.list().map(toWireKind);
         const extensionsCount = kinds.filter((k) => k.isExtension).length;
         let counts2;
         if (args["include-counts"]) {
           counts2 = {};
-          const { createAttachmentStore: createAttachmentStore3 } = await import("@cleocode/core/internal");
-          const store = createAttachmentStore3();
+          const { createAttachmentStore: createAttachmentStore6 } = await import("@cleocode/core/internal");
+          const store = createAttachmentStore6();
           for (const k of kinds) counts2[k.kind] = 0;
           try {
             const rows = await store.listAllInProject(projectRoot);
@@ -44833,14 +45475,14 @@ var init_docs3 = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot30();
+        const projectRoot = getProjectRoot31();
         const { registry, configError } = loadCliRegistry(projectRoot);
         const kinds = registry.list().map(toWireKind);
         let counts2;
         if (args.counts) {
           counts2 = {};
-          const { createAttachmentStore: createAttachmentStore3 } = await import("@cleocode/core/internal");
-          const store = createAttachmentStore3();
+          const { createAttachmentStore: createAttachmentStore6 } = await import("@cleocode/core/internal");
+          const store = createAttachmentStore6();
           for (const k of kinds) counts2[k.kind] = 0;
           try {
             const rows2 = await store.listAllInProject(projectRoot);
@@ -45187,7 +45829,7 @@ __export(migrate_agents_v2_exports, {
 import { createHash as createHash2 } from "node:crypto";
 import { appendFileSync as appendFileSync2, existsSync as existsSync14, mkdirSync as mkdirSync3, readdirSync as readdirSync2, readFileSync as readFileSync14 } from "node:fs";
 import { join as join22 } from "node:path";
-import { getProjectRoot as getProjectRoot31, installAgentFromCant } from "@cleocode/core/internal";
+import { getProjectRoot as getProjectRoot32, installAgentFromCant } from "@cleocode/core/internal";
 import { openCleoDb } from "@cleocode/core/store/open-cleo-db";
 function sha256Hex(bytes) {
   return createHash2("sha256").update(bytes).digest("hex");
@@ -45374,7 +46016,7 @@ var init_migrate_agents_v2 = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot31();
+        const projectRoot = getProjectRoot32();
         const verbose = args.quiet !== true;
         if (verbose) {
           humanInfo("Scanning .cleo/cant/agents/ and .cleo/agents/ for unregistered agents...");
@@ -45418,7 +46060,7 @@ __export(doctor_exports, {
 });
 import { mkdirSync as mkdirSync4, writeFileSync as writeFileSync4 } from "node:fs";
 import { join as join23 } from "node:path";
-import { getProjectRoot as getProjectRoot32 } from "@cleocode/core";
+import { getProjectRoot as getProjectRoot33 } from "@cleocode/core";
 import {
   quarantineRogueCleoDir,
   scanRogueCleoDirs
@@ -45661,7 +46303,7 @@ var init_doctor = __esm({
         try {
           if (args.brain) {
             const { computeBrainHealthDashboard } = await import("@cleocode/core/memory/brain-health-dashboard.js");
-            const projectRoot = getProjectRoot32();
+            const projectRoot = getProjectRoot33();
             const dashboard = await computeBrainHealthDashboard(projectRoot);
             cliOutput(dashboard, { command: "doctor", operation: "doctor.brain" });
             if (dashboard.hasP0Failure) {
@@ -45670,7 +46312,7 @@ var init_doctor = __esm({
             return;
           }
           if (args["scan-test-fixtures-in-prod"]) {
-            const projectRoot = getProjectRoot32();
+            const projectRoot = getProjectRoot33();
             const matches = await scanTestFixturesInProd(projectRoot);
             const dryRun = args["dry-run"] !== false && args.quarantine !== true;
             const quarantined = !dryRun && matches.length > 0 ? await quarantineTestFixtures(projectRoot, matches) : void 0;
@@ -45758,7 +46400,7 @@ var init_doctor = __esm({
             progress.complete("Comprehensive diagnostics complete");
           } else if (args["scan-rogue-cleo-dirs"]) {
             progress.step(0, "Scanning for rogue .cleo/ directories");
-            const projectRoot = getProjectRoot32();
+            const projectRoot = getProjectRoot33();
             const reports = scanRogueCleoDirs(projectRoot);
             progress.complete(
               `Found ${reports.length} rogue .cleo/ director${reports.length === 1 ? "y" : "ies"}`
@@ -45767,7 +46409,7 @@ var init_doctor = __esm({
           } else if (args["quarantine-rogue-cleo-dirs"]) {
             const isDryRun = args["dry-run"] === true;
             progress.step(0, `${isDryRun ? "[DRY RUN] " : ""}Scanning for rogue .cleo/ directories`);
-            const projectRoot = getProjectRoot32();
+            const projectRoot = getProjectRoot33();
             const reports = scanRogueCleoDirs(projectRoot);
             if (reports.length === 0) {
               progress.complete("No rogue .cleo/ directories found \u2014 nothing to quarantine");
@@ -45821,7 +46463,7 @@ var init_doctor = __esm({
             const { detectAndRemoveLegacyGlobalFiles, detectAndRemoveStrayProjectNexus } = await import("@cleocode/core/store/cleanup-legacy.js");
             const { getCleoHome: getCleoHome6 } = await import("@cleocode/core");
             const cleoHome = getCleoHome6();
-            const projectRoot = getProjectRoot32();
+            const projectRoot = getProjectRoot33();
             const legacyResult = detectAndRemoveLegacyGlobalFiles(cleoHome);
             const strayResult = detectAndRemoveStrayProjectNexus(projectRoot);
             const isDryRun = args["dry-run"] === true;
@@ -45854,7 +46496,7 @@ var init_doctor = __esm({
           } else if (args["audit-worktree-orphans"]) {
             progress.step(0, "Comprehensive worktree anomaly audit (T9808 / council D009)");
             const { auditWorktreeOrphansComprehensive, scanWorktreeOrphans } = await import("@cleocode/core/doctor/worktree-orphans.js");
-            const projectRoot = getProjectRoot32();
+            const projectRoot = getProjectRoot33();
             const [comprehensive, legacyOrphans] = await Promise.all([
               auditWorktreeOrphansComprehensive(projectRoot),
               scanWorktreeOrphans(projectRoot)
@@ -45882,7 +46524,7 @@ var init_doctor = __esm({
               `${isDryRun ? "[DRY RUN] " : ""}Scanning + pruning worktree-orphan .cleo/ directories`
             );
             const { pruneWorktreeOrphans, scanWorktreeOrphans } = await import("@cleocode/core/doctor/worktree-orphans.js");
-            const projectRoot = getProjectRoot32();
+            const projectRoot = getProjectRoot33();
             const orphans = await scanWorktreeOrphans(projectRoot);
             if (orphans.length === 0) {
               progress.complete("No worktree orphans found \u2014 nothing to prune");
@@ -45937,7 +46579,7 @@ var init_doctor = __esm({
               { command: "doctor", operation: "admin.health" }
             );
             try {
-              const projectRoot = getProjectRoot32();
+              const projectRoot = getProjectRoot33();
               const conflicts = readMigrationConflicts(projectRoot);
               if (conflicts.length > 0) {
                 progress.complete(
@@ -46756,6 +47398,42 @@ var init_find = __esm({
   }
 });
 
+// packages/cleo/src/cli/commands/focus.ts
+var focus_exports = {};
+__export(focus_exports, {
+  focusCommand: () => focusCommand
+});
+var focusCommand;
+var init_focus3 = __esm({
+  "packages/cleo/src/cli/commands/focus.ts"() {
+    "use strict";
+    init_dist();
+    init_cli();
+    focusCommand = defineCommand({
+      meta: {
+        name: "focus",
+        description: "Single-envelope orientation for a task, epic, or saga \u2014 replaces 8 separate calls with one"
+      },
+      args: {
+        id: {
+          type: "positional",
+          description: "Task, Epic, or Saga ID to orient on (e.g. T9973, T9831)",
+          required: true
+        }
+      },
+      async run({ args }) {
+        await dispatchFromCli(
+          "query",
+          "focus",
+          "show",
+          { id: args["id"] },
+          { command: "focus" }
+        );
+      }
+    });
+  }
+});
+
 // packages/cleo/src/cli/commands/gc.ts
 var gc_exports = {};
 __export(gc_exports, {
@@ -49052,7 +49730,7 @@ var llm_cost_exports = {};
 __export(llm_cost_exports, {
   costCommand: () => costCommand
 });
-import { getProjectRoot as getProjectRoot33 } from "@cleocode/core/internal";
+import { getProjectRoot as getProjectRoot34 } from "@cleocode/core/internal";
 import { computeCost } from "@cleocode/core/llm/usage-pricing";
 function resolveSessionId(raw) {
   if (raw === "current") {
@@ -49125,7 +49803,7 @@ var init_llm_cost = __esm({
           process.exit(6);
         }
         const sessionId = resolveSessionId(rawSessionId);
-        const projectRoot = getProjectRoot33(process.cwd());
+        const projectRoot = getProjectRoot34(process.cwd());
         let breakdown;
         try {
           breakdown = await loadSessionCostBreakdown(projectRoot, sessionId);
@@ -50676,7 +51354,7 @@ import { createHash as createHash3 } from "node:crypto";
 import { existsSync as existsSync16, mkdirSync as mkdirSync5, readdirSync as readdirSync3, readFileSync as readFileSync16, writeFileSync as writeFileSync5 } from "node:fs";
 import { homedir as homedir5 } from "node:os";
 import { join as join27 } from "node:path";
-import { getProjectRoot as getProjectRoot34 } from "@cleocode/core";
+import { getProjectRoot as getProjectRoot35 } from "@cleocode/core";
 import {
   getBrainDb as getBrainDb2,
   getDreamStatus,
@@ -51643,7 +52321,7 @@ var init_memory3 = __esm({
       },
       args: {},
       async run() {
-        const root = getProjectRoot34();
+        const root = getProjectRoot35();
         try {
           const result = await runConsolidation(root);
           cliOutput(result, { command: "memory-consolidate", operation: "memory.consolidate" });
@@ -51667,7 +52345,7 @@ var init_memory3 = __esm({
         }
       },
       async run({ args }) {
-        const root = getProjectRoot34();
+        const root = getProjectRoot35();
         if (args.status) {
           try {
             const status = await getDreamStatus(root);
@@ -51704,7 +52382,7 @@ var init_memory3 = __esm({
         }
       },
       async run({ args }) {
-        const root = getProjectRoot34();
+        const root = getProjectRoot35();
         try {
           const { runObserver, runReflector } = await import("@cleocode/core/memory");
           const observerResult = await runObserver(root, args.session, {
@@ -51744,7 +52422,7 @@ var init_memory3 = __esm({
         }
       },
       async run({ args }) {
-        const root = getProjectRoot34();
+        const root = getProjectRoot35();
         try {
           await getBrainDb2(root);
           const { totalDuplicateRows, groups } = await scanDuplicateEntries();
@@ -51790,7 +52468,7 @@ var init_memory3 = __esm({
       async run({ args }) {
         const sourceDir = args.from ?? join27(homedir5(), ".claude", "projects", "-mnt-projects-cleocode", "memory");
         const isDryRun = !!args["dry-run"];
-        const projectRoot = getProjectRoot34();
+        const projectRoot = getProjectRoot35();
         const stateFile = join27(projectRoot, CLEO_DIR_NAME, MIGRATE_MEMORY_HASHES_JSON);
         if (!existsSync16(sourceDir)) {
           cliError(`Source directory not found: ${sourceDir}`, "E_NOT_FOUND", { name: "E_NOT_FOUND" });
@@ -52003,7 +52681,7 @@ var init_memory3 = __esm({
       },
       args: {},
       async run() {
-        const root = getProjectRoot34();
+        const root = getProjectRoot35();
         try {
           await getBrainDb2(root);
           const result = await getTierStats(root);
@@ -52046,7 +52724,7 @@ var init_memory3 = __esm({
         }
       },
       async run({ args }) {
-        const root = getProjectRoot34();
+        const root = getProjectRoot35();
         const targetTier = args.to;
         const reason = args.reason;
         const validTiers = ["medium", "long"];
@@ -52112,7 +52790,7 @@ var init_memory3 = __esm({
         }
       },
       async run({ args }) {
-        const root = getProjectRoot34();
+        const root = getProjectRoot35();
         const targetTier = args.to;
         const reason = args.reason;
         const validTiers = ["short", "medium"];
@@ -52580,7 +53258,7 @@ var migrate_claude_mem_exports = {};
 __export(migrate_claude_mem_exports, {
   migrateClaudeMemCommand: () => migrateClaudeMemCommand
 });
-import { getProjectRoot as getProjectRoot35, migrateClaudeMem } from "@cleocode/core/internal";
+import { getProjectRoot as getProjectRoot36, migrateClaudeMem } from "@cleocode/core/internal";
 import { ingestLooseAgentOutputs, ingestRcasdDirectories } from "@cleocode/core/memory";
 import { getDb as getDb2 } from "@cleocode/core/store/sqlite";
 var storageCommand, claudeMemCommand, manifestIngestCommand, migrateClaudeMemCommand;
@@ -52643,7 +53321,7 @@ var init_migrate_claude_mem = __esm({
         }
       },
       async run({ args }) {
-        const root = getProjectRoot35();
+        const root = getProjectRoot36();
         try {
           const result = await migrateClaudeMem(root, {
             sourcePath: args.source,
@@ -52692,7 +53370,7 @@ var init_migrate_claude_mem = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot35();
+        const projectRoot = getProjectRoot36();
         try {
           const db = await getDb2(projectRoot);
           const rcasdFlag = Boolean(args.rcasd);
@@ -52796,7 +53474,7 @@ __export(nexus_exports, {
 import { appendFile as appendFile2, mkdir as mkdir3 } from "node:fs/promises";
 import { homedir as homedir6 } from "node:os";
 import path4 from "node:path";
-import { getProjectRoot as getProjectRoot36 } from "@cleocode/core";
+import { getProjectRoot as getProjectRoot37 } from "@cleocode/core";
 import { generateGexf, getSymbolImpact } from "@cleocode/core/nexus";
 async function appendDeprecationTelemetry(op, replacement) {
   try {
@@ -52908,7 +53586,7 @@ var init_nexus4 = __esm({
       async run({ args }) {
         applyJsonFlag2(args.json);
         const projectIdOverride = args["project-id"];
-        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot36();
+        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot37();
         const startTime = Date.now();
         try {
           const [{ getNexusDb, nexusSchema }, { getIndexStats }] = await Promise.all([
@@ -53423,7 +54101,7 @@ var init_nexus4 = __esm({
         applyJsonFlag2(args.json);
         const startTime = Date.now();
         const projectIdOverride = args["project-id"];
-        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot36();
+        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot37();
         const projectId = projectIdOverride ?? Buffer.from(repoPath).toString("base64url").slice(0, 32);
         const response = await dispatchRaw("query", "nexus", "clusters", { projectId, repoPath });
         const durationMs = Date.now() - startTime;
@@ -53467,7 +54145,7 @@ var init_nexus4 = __esm({
         applyJsonFlag2(args.json);
         const startTime = Date.now();
         const projectIdOverride = args["project-id"];
-        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot36();
+        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot37();
         const projectId = projectIdOverride ?? Buffer.from(repoPath).toString("base64url").slice(0, 32);
         const response = await dispatchRaw("query", "nexus", "flows", { projectId, repoPath });
         const durationMs = Date.now() - startTime;
@@ -53510,7 +54188,7 @@ var init_nexus4 = __esm({
         void appendDeprecationTelemetry("nexus.context", "cleo graph context");
         const startTime = Date.now();
         const projectIdOverride = args["project-id"];
-        const repoPath = getProjectRoot36();
+        const repoPath = getProjectRoot37();
         const projectId = projectIdOverride ?? Buffer.from(repoPath).toString("base64url").slice(0, 32);
         const limit = parseInt(args.limit, 10);
         const symbolName = args.symbol;
@@ -53573,7 +54251,7 @@ var init_nexus4 = __esm({
         const startTime = Date.now();
         const whyFlag = !!args.why;
         const projectIdOverride = args["project-id"];
-        const repoPath = getProjectRoot36();
+        const repoPath = getProjectRoot37();
         const projectId = projectIdOverride ?? Buffer.from(repoPath).toString("base64url").slice(0, 32);
         const maxDepth = Math.min(parseInt(args.depth, 10), 5);
         const symbolName = args.symbol;
@@ -53645,7 +54323,7 @@ var init_nexus4 = __esm({
         const projectIdOverride = args["project-id"];
         const isIncremental = !!args.incremental;
         const ctx = getFormatContext();
-        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot36();
+        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot37();
         humanInfo(`[nexus] Analyzing: ${repoPath}${isIncremental ? " (incremental)" : ""}`);
         try {
           const [{ getNexusDb, nexusSchema }, { runPipeline }, { eq: eq2 }] = await Promise.all([
@@ -53797,7 +54475,7 @@ var init_nexus4 = __esm({
       async run({ args }) {
         applyJsonFlag2(args.json);
         const startTime = Date.now();
-        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot36();
+        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot37();
         const name = args.name;
         const response = await dispatchRaw("mutate", "nexus", "projects.register", {
           path: repoPath,
@@ -54155,7 +54833,7 @@ var init_nexus4 = __esm({
         applyJsonFlag2(args.json);
         const startTime = Date.now();
         const projectIdOverride = args["project-id"];
-        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot36();
+        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot37();
         const projectId = projectIdOverride ?? Buffer.from(repoPath).toString("base64url").slice(0, 32);
         const response = await dispatchRaw("mutate", "nexus", "refresh-bridge", {
           repoPath,
@@ -54304,7 +54982,7 @@ var init_nexus4 = __esm({
       async run({ args }) {
         applyJsonFlag2(args.json);
         const startTime = Date.now();
-        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot36();
+        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot37();
         const projectIdOverride = args["project-id"];
         const beforeRef = args.before ?? "HEAD~1";
         const afterRef = args.after ?? "HEAD";
@@ -54422,7 +55100,7 @@ var init_nexus4 = __esm({
         applyJsonFlag2(args.json);
         const startTime = Date.now();
         const projectIdOverride = args["project-id"];
-        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot36();
+        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot37();
         const projectId = projectIdOverride ?? Buffer.from(repoPath).toString("base64url").slice(0, 32);
         const response = await dispatchRaw("query", "nexus", "route-map", { projectId });
         const durationMs = Date.now() - startTime;
@@ -54478,7 +55156,7 @@ var init_nexus4 = __esm({
         const startTime = Date.now();
         const routeSymbol = args.routeSymbol;
         const projectIdOverride = args["project-id"];
-        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot36();
+        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot37();
         const projectId = projectIdOverride ?? Buffer.from(repoPath).toString("base64url").slice(0, 32);
         const response = await dispatchRaw("query", "nexus", "shape-check", { routeSymbol, projectId });
         const durationMs = Date.now() - startTime;
@@ -54868,7 +55546,7 @@ var init_nexus4 = __esm({
       async run({ args }) {
         applyJsonFlag2(args.json);
         const startTime = Date.now();
-        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot36();
+        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot37();
         const projectIdOverride = args["project-id"];
         const projectId = projectIdOverride ?? Buffer.from(repoPath).toString("base64url").slice(0, 32);
         const response = await dispatchRaw("mutate", "nexus", "contracts-sync", {
@@ -54972,7 +55650,7 @@ var init_nexus4 = __esm({
       async run({ args }) {
         applyJsonFlag2(args.json);
         const startTime = Date.now();
-        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot36();
+        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot37();
         const projectId = Buffer.from(repoPath).toString("base64url").slice(0, 32);
         const response = await dispatchRaw("mutate", "nexus", "contracts-link-tasks", {
           projectId,
@@ -55048,7 +55726,7 @@ var init_nexus4 = __esm({
       async run({ args }) {
         applyJsonFlag2(args.json);
         const startTime = Date.now();
-        const outputDir = args.output ?? path4.join(getProjectRoot36(), ".cleo", "wiki");
+        const outputDir = args.output ?? path4.join(getProjectRoot37(), ".cleo", "wiki");
         const communityFilter = args.community ?? void 0;
         const isIncremental = !!args.incremental;
         let loomProvider = null;
@@ -55072,11 +55750,11 @@ var init_nexus4 = __esm({
         }
         try {
           const { generateNexusWikiIndex } = await import("@cleocode/core/nexus/wiki-index.js");
-          const result = await generateNexusWikiIndex(outputDir, getProjectRoot36(), {
+          const result = await generateNexusWikiIndex(outputDir, getProjectRoot37(), {
             communityFilter,
             incremental: isIncremental,
             loomProvider,
-            projectRoot: getProjectRoot36()
+            projectRoot: getProjectRoot37()
           });
           const durationMs = Date.now() - startTime;
           if (!result.success) {
@@ -57497,7 +58175,7 @@ var refresh_memory_exports = {};
 __export(refresh_memory_exports, {
   refreshMemoryCommand: () => refreshMemoryCommand
 });
-import { getProjectRoot as getProjectRoot37 } from "@cleocode/core";
+import { getProjectRoot as getProjectRoot38 } from "@cleocode/core";
 var refreshMemoryCommand;
 var init_refresh_memory = __esm({
   "packages/cleo/src/cli/commands/refresh-memory.ts"() {
@@ -57510,7 +58188,7 @@ var init_refresh_memory = __esm({
         description: "Regenerate .cleo/memory-bridge.md from brain.db"
       },
       async run() {
-        const projectDir = getProjectRoot37();
+        const projectDir = getProjectRoot38();
         const { writeMemoryBridge } = await import("@cleocode/core/internal");
         const result = await writeMemoryBridge(projectDir);
         if (result.written) {
@@ -58898,7 +59576,7 @@ __export(restore_exports, {
 });
 import fs3 from "node:fs";
 import path5 from "node:path";
-import { CleoError as CleoError7, getProjectRoot as getProjectRoot38, getTaskAccessor as getTaskAccessor3 } from "@cleocode/core";
+import { CleoError as CleoError7, getProjectRoot as getProjectRoot39, getTaskAccessor as getTaskAccessor3 } from "@cleocode/core";
 function parseMarkdownValue(raw) {
   const trimmed = raw.trim();
   if (trimmed === "_(not present)_" || trimmed === "") return void 0;
@@ -59018,7 +59696,7 @@ var init_restore = __esm({
         description: "Apply manually-resolved conflicts from .cleo/restore-conflicts.md"
       },
       async run() {
-        const projectRoot = getProjectRoot38();
+        const projectRoot = getProjectRoot39();
         const reportPath = path5.join(projectRoot, CLEO_DIR_NAME, RESTORE_CONFLICTS_MD);
         if (!fs3.existsSync(reportPath)) {
           humanLine("No pending restore conflicts. Nothing to finalize.");
@@ -61424,7 +62102,7 @@ var sequence_exports = {};
 __export(sequence_exports, {
   sequenceCommand: () => sequenceCommand
 });
-import { getProjectRoot as getProjectRoot39 } from "@cleocode/core/internal";
+import { getProjectRoot as getProjectRoot40 } from "@cleocode/core/internal";
 var showCommand12, checkCommand6, repairCommand, sequenceCommand;
 var init_sequence = __esm({
   "packages/cleo/src/cli/commands/sequence.ts"() {
@@ -61460,7 +62138,7 @@ var init_sequence = __esm({
       meta: { name: "repair", description: "Reset counter to max + 1 if behind" },
       async run() {
         const { repairSequence } = await import("@cleocode/core/internal");
-        const projectRoot = getProjectRoot39();
+        const projectRoot = getProjectRoot40();
         const repair = await repairSequence(projectRoot);
         const result = {
           repaired: repair.repaired,
@@ -61549,7 +62227,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, lintCommand, sessionCommand;
+var startCommand7, endCommand, handoffCommand2, statusCommand14, resumeCommand2, findCommand6, 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";
@@ -61624,7 +62302,9 @@ var init_session4 = __esm({
             // CLI-level alias normalization: --focus and --start-task both map to startTask (ADR-057 D2)
             startTask: args["start-task"] ?? args.focus,
             grade: args.grade,
-            ownerAuthToken
+            ownerAuthToken,
+            // T9975: per-agent handle for multi-agent isolation
+            agentHandle: args.agent
           },
           { command: "session", operation: "session.start" }
         );
@@ -61829,6 +62509,15 @@ var init_session4 = __esm({
         offset: {
           type: "string",
           description: "Skip first n results"
+        },
+        /**
+         * T9975: surface all per-agent columns (agent, scope, lastActivity).
+         * When set, the result includes agentHandle, scopeKind, scopeId, and
+         * lastActivity for each session — useful for multi-agent dashboards.
+         */
+        all: {
+          type: "boolean",
+          description: "Show all columns including per-agent fields (agent, scope, lastActivity) \u2014 T9975"
         }
       },
       async run({ args }) {
@@ -61839,7 +62528,8 @@ var init_session4 = __esm({
           {
             status: args.status,
             limit: args.limit ? Number.parseInt(args.limit, 10) : void 0,
-            offset: args.offset ? Number.parseInt(args.offset, 10) : void 0
+            offset: args.offset ? Number.parseInt(args.offset, 10) : void 0,
+            all: args.all
           },
           { command: "session", operation: "session.list" }
         );
@@ -61903,8 +62593,8 @@ var init_session4 = __esm({
         "audit-scope": { type: "string", description: "Audit log scope (global|local)" }
       },
       async run({ args }) {
-        const { detectSessionDrift, getProjectRoot: getProjectRoot43 } = await import("@cleocode/core");
-        const projectRoot = await getProjectRoot43();
+        const { detectSessionDrift, getProjectRoot: getProjectRoot44 } = await import("@cleocode/core");
+        const projectRoot = await getProjectRoot44();
         const scope = args["audit-scope"] === "local" ? "local" : "global";
         const report = await detectSessionDrift({ projectRoot, auditScope: scope });
         cliOutput(report, { command: "session drift", operation: "session.drift" });
@@ -62070,6 +62760,35 @@ var init_session4 = __esm({
         );
       }
     });
+    adoptCommand = defineCommand({
+      meta: {
+        name: "adopt",
+        description: "Rebind env to a specific session \u2014 prints export command to eval (T9975)"
+      },
+      args: {
+        sessionId: {
+          type: "positional",
+          description: "Session ID to adopt",
+          required: true
+        }
+      },
+      async run({ args }) {
+        const response = await dispatchRaw("mutate", "session", "adopt", {
+          sessionId: args.sessionId
+        });
+        if (!response.success) {
+          handleRawError(response, { command: "session adopt", operation: "session.adopt" });
+          return;
+        }
+        const data = response.data;
+        if (data?.exportCommand) {
+          process.stdout.write(`${data.exportCommand}
+`);
+        } else {
+          cliOutput(data ?? {}, { command: "session adopt", operation: "session.adopt" });
+        }
+      }
+    });
     lintCommand = defineCommand({
       meta: {
         name: "lint",
@@ -62111,7 +62830,9 @@ var init_session4 = __esm({
         "record-assumption": recordAssumptionCommand,
         "record-decision": recordDecisionCommand,
         "decision-log": decisionLogCommand,
-        lint: lintCommand
+        lint: lintCommand,
+        // T9975 — per-agent session isolation
+        adopt: adoptCommand
       },
       async run({ cmd, rawArgs }) {
         const firstArg = rawArgs?.find((a) => !a.startsWith("-"));
@@ -64757,7 +65478,7 @@ __export(token_exports, {
   tokenCommand: () => tokenCommand
 });
 import { readFileSync as readFileSync17 } from "node:fs";
-import { getProjectRoot as getProjectRoot40, measureTokenExchange, recordTokenExchange as recordTokenExchange2 } from "@cleocode/core/internal";
+import { getProjectRoot as getProjectRoot41, measureTokenExchange, recordTokenExchange as recordTokenExchange2 } from "@cleocode/core/internal";
 function readPayload(args, textKey, fileKey) {
   const text = args[textKey];
   const file = args[fileKey];
@@ -64921,7 +65642,7 @@ var init_token = __esm({
           domain: args.domain,
           operation: args.operation
         };
-        const result = args.record ? await recordTokenExchange2(getProjectRoot40(), input2) : await measureTokenExchange(input2);
+        const result = args.record ? await recordTokenExchange2(getProjectRoot41(), input2) : await measureTokenExchange(input2);
         cliOutput(result, {
           command: "token",
           operation: args.record ? "admin.token.record" : "token.estimate"
@@ -64957,7 +65678,7 @@ __export(transcript_exports, {
 });
 import { homedir as homedir7 } from "node:os";
 import { join as join31 } from "node:path";
-import { getProjectRoot as getProjectRoot41 } from "@cleocode/core";
+import { getProjectRoot as getProjectRoot42 } from "@cleocode/core";
 import {
   parseDurationMs,
   pruneTranscripts,
@@ -64987,7 +65708,7 @@ var init_transcript = __esm({
       async run({ args }) {
         if (args.pending) {
           try {
-            const projectRoot = getProjectRoot41();
+            const projectRoot = getProjectRoot42();
             const { scanPendingTranscripts } = await import("@cleocode/core/memory/transcript-scanner.js");
             const pending = await scanPendingTranscripts(projectRoot);
             cliOutput(
@@ -65084,7 +65805,7 @@ var init_transcript = __esm({
       async run({ args }) {
         const tier = args.tier ?? "warm";
         const dryRun = args["dry-run"] ?? false;
-        const projectRoot = getProjectRoot41();
+        const projectRoot = getProjectRoot42();
         try {
           const { extractTranscript } = await import("@cleocode/core/memory/transcript-extractor.js");
           const { findSessionTranscriptPath, listAllTranscripts } = await import("@cleocode/core/memory/transcript-scanner.js");
@@ -65196,7 +65917,7 @@ var init_transcript = __esm({
         const dryRun = args["dry-run"] ?? false;
         const olderThanHours = args["older-than-hours"] ? Number.parseInt(args["older-than-hours"], 10) : 24;
         const limit = args.limit ? Number.parseInt(args.limit, 10) : void 0;
-        const projectRoot = getProjectRoot41();
+        const projectRoot = getProjectRoot42();
         try {
           const { extractTranscript } = await import("@cleocode/core/memory/transcript-extractor.js");
           const { listAllTranscripts } = await import("@cleocode/core/memory/transcript-scanner.js");
@@ -66323,7 +67044,7 @@ __export(worktree_exports, {
   worktreeCommand: () => worktreeCommand
 });
 import readline4 from "node:readline";
-import { getProjectRoot as getProjectRoot42, listWorktrees as listWorktrees2 } from "@cleocode/core/internal";
+import { getProjectRoot as getProjectRoot43, listWorktrees as listWorktrees2 } from "@cleocode/core/internal";
 async function promptYesNo2(question) {
   return new Promise((resolve9) => {
     const rl = readline4.createInterface({ input: process.stdin, output: process.stdout });
@@ -66344,7 +67065,7 @@ function renderOrphanPreamble(wt) {
     ""
   ].join("\n");
 }
-var VALID_STATUS_VALUES, listCommand27, pruneCommand3, destroyCommand, forceUnlockCommand, VALID_ADOPT_SOURCES, adoptCommand, worktreeCommand;
+var VALID_STATUS_VALUES, listCommand27, pruneCommand3, destroyCommand, forceUnlockCommand, VALID_ADOPT_SOURCES, adoptCommand2, worktreeCommand;
 var init_worktree3 = __esm({
   "packages/cleo/src/cli/commands/worktree.ts"() {
     "use strict";
@@ -66428,7 +67149,7 @@ var init_worktree3 = __esm({
         const staleDays = staleDaysRaw !== void 0 ? Number.parseInt(staleDaysRaw, 10) : void 0;
         const idleDaysRaw = typeof args["idle-days"] === "string" ? args["idle-days"] : void 0;
         const idleDays = idleDaysRaw !== void 0 ? Number.parseInt(idleDaysRaw, 10) : void 0;
-        const projectRoot = getProjectRoot42();
+        const projectRoot = getProjectRoot43();
         const listResult = await listWorktrees2({
           projectRoot,
           ...staleDays !== void 0 && !Number.isNaN(staleDays) ? { staleDays } : {}
@@ -66585,7 +67306,7 @@ var init_worktree3 = __esm({
       }
     });
     VALID_ADOPT_SOURCES = ["claude-agent", "manual", "adopted"];
-    adoptCommand = defineCommand({
+    adoptCommand2 = defineCommand({
       meta: {
         name: "adopt",
         description: "Register an externally-created worktree (e.g. Claude Code Agent isolation:worktree) in the CLEO SSoT so it surfaces in `cleo worktree list`."
@@ -66641,7 +67362,7 @@ var init_worktree3 = __esm({
       },
       subCommands: {
         list: listCommand27,
-        adopt: adoptCommand,
+        adopt: adoptCommand2,
         prune: pruneCommand3,
         destroy: destroyCommand,
         "force-unlock": forceUnlockCommand
@@ -67017,6 +67738,12 @@ var COMMAND_MANIFEST = [
     description: "Fuzzy search tasks by title/description",
     load: async () => (await Promise.resolve().then(() => (init_find(), find_exports))).findCommand
   },
+  {
+    exportName: "focusCommand",
+    name: "focus",
+    description: "Single-envelope orientation for a task, epic, or saga \u2014 replaces 8 separate calls with one",
+    load: async () => (await Promise.resolve().then(() => (init_focus3(), focus_exports))).focusCommand
+  },
   {
     exportName: "gcCommand",
     name: "gc",
@@ -67955,7 +68682,7 @@ async function runStartupMaintenance() {
     detectAndRemoveStrayProjectNexus,
     getGlobalSalt,
     getLogger: getLogger20,
-    getProjectRoot: getProjectRoot43,
+    getProjectRoot: getProjectRoot44,
     isCleanupMarkerSet,
     migrateSignaldockToConduit,
     needsSignaldockToConduitMigration,
@@ -67964,7 +68691,7 @@ async function runStartupMaintenance() {
   } = await import("@cleocode/core/internal");
   let projectRootForCleanup = "";
   try {
-    projectRootForCleanup = getProjectRoot43();
+    projectRootForCleanup = getProjectRoot44();
   } catch {
   }
   if (!isCleanupMarkerSet(CLI_VERSION, projectRootForCleanup)) {
@@ -67984,7 +68711,7 @@ async function runStartupMaintenance() {
   const isInitInvocation = process.argv.slice(2).some((a) => a === "init");
   if (!isInitInvocation) {
     try {
-      const _projectRootForMigration = getProjectRoot43();
+      const _projectRootForMigration = getProjectRoot44();
       if (needsSignaldockToConduitMigration(_projectRootForMigration)) {
         const migrationResult = migrateSignaldockToConduit(_projectRootForMigration);
         if (migrationResult.status === "failed") {