@cleocode/core 2026.3.45 → 2026.3.47

package/dist/index.js

@@ -18472,16 +18472,6 @@ var init_json_schema_validator = __esm({
 });
 
 // packages/core/src/schema-management.ts
-var schema_management_exports = {};
-__export(schema_management_exports, {
-  checkGlobalSchemas: () => checkGlobalSchemas,
-  checkSchemaStaleness: () => checkSchemaStaleness,
-  cleanProjectSchemas: () => cleanProjectSchemas,
-  ensureGlobalSchemas: () => ensureGlobalSchemas,
-  getSchemaVersion: () => getSchemaVersion2,
-  listInstalledSchemas: () => listInstalledSchemas,
-  resolveSchemaPath: () => resolveSchemaPath
-});
 import {
   copyFileSync as copyFileSync4,
   existsSync as existsSync30,
@@ -18607,70 +18597,6 @@ function checkGlobalSchemas() {
     stale
   };
 }
-function checkSchemaStaleness() {
-  const globalDir = getCleoSchemasDir();
-  const bundledFiles = listBundledSchemas();
-  const stale = [];
-  const current = [];
-  const missing = [];
-  const packageRoot = getPackageRoot();
-  const bundledDir = join34(packageRoot, "schemas");
-  for (const file2 of bundledFiles) {
-    const globalPath = join34(globalDir, file2);
-    if (!existsSync30(globalPath)) {
-      missing.push(file2);
-      continue;
-    }
-    const bundledVersion = readVersionFromPath(join34(bundledDir, file2));
-    const globalVersion = readVersionFromPath(globalPath);
-    if (bundledVersion !== null && bundledVersion !== globalVersion) {
-      stale.push(file2);
-    } else {
-      current.push(file2);
-    }
-  }
-  return { stale, current, missing };
-}
-function listInstalledSchemas() {
-  const globalDir = getCleoSchemasDir();
-  if (!existsSync30(globalDir)) return [];
-  let files;
-  try {
-    files = readdirSync16(globalDir).filter((f) => f.endsWith(".schema.json"));
-  } catch {
-    return [];
-  }
-  return files.map((name2) => {
-    const fullPath = join34(globalDir, name2);
-    return {
-      name: name2,
-      path: fullPath,
-      version: readVersionFromPath(fullPath)
-    };
-  });
-}
-async function cleanProjectSchemas(projectRoot) {
-  const projectSchemasDir = join34(projectRoot, ".cleo", "schemas");
-  if (!existsSync30(projectSchemasDir)) {
-    return { cleaned: false };
-  }
-  try {
-    const stat2 = statSync7(projectSchemasDir);
-    if (!stat2.isDirectory()) {
-      return { cleaned: false };
-    }
-  } catch {
-    return { cleaned: false };
-  }
-  const timestamp2 = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19);
-  const backupDir = join34(projectRoot, ".cleo", "backups", "schemas");
-  const backupTarget = join34(backupDir, `schemas-${timestamp2}`);
-  if (!existsSync30(backupDir)) {
-    mkdirSync8(backupDir, { recursive: true });
-  }
-  renameSync3(projectSchemasDir, backupTarget);
-  return { cleaned: true };
-}
 var init_schema_management = __esm({
   "packages/core/src/schema-management.ts"() {
     "use strict";
@@ -18876,7 +18802,7 @@ async function ensureInjection(projectRoot) {
     }
   }
   const agentsMdPath = join36(projectRoot, "AGENTS.md");
-  const agentsMdLines = ["@~/.cleo/templates/CLEO-INJECTION.md"];
+  const agentsMdLines = ["@~/.agents/AGENTS.md"];
   const projectContextPath = join36(projectRoot, ".cleo", "project-context.json");
   if (existsSync32(projectContextPath)) {
     agentsMdLines.push("@.cleo/project-context.json");
@@ -18889,7 +18815,8 @@ async function ensureInjection(projectRoot) {
   if (contributorBlock) {
     agentsMdLines.push(contributorBlock);
   }
-  const agentsAction = await inject2(agentsMdPath, agentsMdLines.join("\n"));
+  const agentsMdContent = agentsMdLines.join("\n");
+  const agentsAction = await inject2(agentsMdPath, agentsMdContent);
   actions.push(`AGENTS.md CLEO content (${agentsAction})`);
   const content = getInjectionTemplateContent();
   if (content) {
@@ -18904,8 +18831,9 @@ async function ensureInjection(projectRoot) {
   try {
     const globalAgentsDir = getAgentsHome();
     const globalAgentsMd = join36(globalAgentsDir, "AGENTS.md");
+    const globalHubContent = "@~/.cleo/templates/CLEO-INJECTION.md";
     await mkdir4(globalAgentsDir, { recursive: true });
-    await inject2(globalAgentsMd, "@~/.cleo/templates/CLEO-INJECTION.md");
+    await inject2(globalAgentsMd, globalHubContent);
   } catch {
   }
   return {
@@ -19085,6 +19013,7 @@ __export(scaffold_exports, {
   CLEO_GITIGNORE_FALLBACK: () => CLEO_GITIGNORE_FALLBACK,
   REQUIRED_CLEO_SUBDIRS: () => REQUIRED_CLEO_SUBDIRS,
   REQUIRED_GLOBAL_SUBDIRS: () => REQUIRED_GLOBAL_SUBDIRS,
+  STALE_GLOBAL_ENTRIES: () => STALE_GLOBAL_ENTRIES,
   checkBrainDb: () => checkBrainDb,
   checkCleoGitRepo: () => checkCleoGitRepo,
   checkCleoStructure: () => checkCleoStructure,
@@ -19121,7 +19050,7 @@ __export(scaffold_exports, {
 import { execFile as execFile3 } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import { existsSync as existsSync33, constants as fsConstants3, readFileSync as readFileSync22, statSync as statSync8 } from "node:fs";
-import { access as access3, mkdir as mkdir5, readFile as readFile6, writeFile as writeFile5 } from "node:fs/promises";
+import { access as access3, mkdir as mkdir5, readFile as readFile6, rm as rm2, writeFile as writeFile5 } from "node:fs/promises";
 import { dirname as dirname8, join as join37, resolve as resolve5 } from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 import { promisify as promisify3 } from "node:util";
@@ -19136,7 +19065,7 @@ async function fileExists(path2) {
 async function stripCLEOBlocks(filePath) {
   if (!existsSync33(filePath)) return;
   const content = await readFile6(filePath, "utf8");
-  const stripped = content.replace(/\n?<!-- CLEO:START -->[\s\S]*?<!-- CLEO:END -->\n?/g, "");
+  const stripped = content.replace(/\n?<!-- CLEO:START[^>]*-->[\s\S]*?<!-- CLEO:END -->\n?/g, "");
   if (stripped !== content) await writeFile5(filePath, stripped, "utf8");
 }
 async function removeCleoFromRootGitignore(projectRoot) {
@@ -19413,7 +19342,7 @@ async function ensureProjectContext(projectRoot, opts) {
   try {
     const schemaPath = join37(
       dirname8(fileURLToPath4(import.meta.url)),
-      "../../schemas/project-context.schema.json"
+      "../schemas/project-context.schema.json"
     );
     if (existsSync33(schemaPath)) {
       const AjvModule = await import("ajv");
@@ -19819,6 +19748,19 @@ async function ensureGlobalHome() {
   for (const subdir of REQUIRED_GLOBAL_SUBDIRS) {
     await mkdir5(join37(cleoHome, subdir), { recursive: true });
   }
+  for (const stale of STALE_GLOBAL_ENTRIES) {
+    const stalePath = join37(cleoHome, stale);
+    if (existsSync33(stalePath)) {
+      try {
+        await rm2(stalePath, { recursive: true, force: true });
+        console.warn(`[CLEO] Removed stale global entry: ${stalePath}`);
+      } catch (err) {
+        console.warn(
+          `[CLEO] Could not remove stale global entry ${stalePath}: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+    }
+  }
   return {
     action: alreadyExists ? "skipped" : "created",
     path: cleoHome,
@@ -19854,11 +19796,9 @@ async function ensureGlobalTemplates() {
   return { action: "created", path: injectionPath };
 }
 async function ensureGlobalScaffold() {
-  const { ensureGlobalSchemas: ensureGlobalSchemas2 } = await Promise.resolve().then(() => (init_schema_management(), schema_management_exports));
   const home = await ensureGlobalHome();
-  const schemas = ensureGlobalSchemas2();
   const templates = await ensureGlobalTemplates();
-  return { home, schemas, templates };
+  return { home, templates };
 }
 function checkGlobalHome() {
   const cleoHome = getCleoHome();
@@ -19935,7 +19875,7 @@ function checkLogDir(projectRoot) {
     fix: null
   };
 }
-var execFileAsync3, REQUIRED_CLEO_SUBDIRS, CLEO_GITIGNORE_FALLBACK, REQUIRED_GLOBAL_SUBDIRS;
+var execFileAsync3, REQUIRED_CLEO_SUBDIRS, CLEO_GITIGNORE_FALLBACK, REQUIRED_GLOBAL_SUBDIRS, STALE_GLOBAL_ENTRIES;
 var init_scaffold = __esm({
   "packages/core/src/scaffold.ts"() {
     "use strict";
@@ -19992,7 +19932,21 @@ metrics/
 .backups/
 backups/
 `;
-    REQUIRED_GLOBAL_SUBDIRS = ["schemas", "templates"];
+    REQUIRED_GLOBAL_SUBDIRS = ["logs", "templates"];
+    STALE_GLOBAL_ENTRIES = [
+      "adrs",
+      "rcasd",
+      "agent-outputs",
+      "backups",
+      "sandbox",
+      "tasks.db",
+      "tasks.db-shm",
+      "tasks.db-wal",
+      "brain-worker.pid",
+      "VERSION",
+      "schemas",
+      "bin"
+    ];
   }
 });
 
@@ -41536,8 +41490,8 @@ function parseTokenMetrics(inputFile, cwd) {
     const raw = JSON.parse(readFileSync28(file2, "utf-8"));
     if (raw.resourceMetrics) {
       const points = [];
-      for (const rm2 of raw.resourceMetrics ?? []) {
-        for (const sm of rm2.scopeMetrics ?? []) {
+      for (const rm3 of raw.resourceMetrics ?? []) {
+        for (const sm of rm3.scopeMetrics ?? []) {
           for (const metric of sm.metrics ?? []) {
             if (metric.name !== "claude_code.token.usage") continue;
             for (const dp of metric.sum?.dataPoints ?? []) {
@@ -47551,8 +47505,8 @@ var PLATFORM_PATHS = {
   "gitlab-ci": ".gitlab-ci.yml",
   circleci: ".circleci/config.yml"
 };
-function getPlatformPath(platform3) {
-  return PLATFORM_PATHS[platform3];
+function getPlatformPath(platform5) {
+  return PLATFORM_PATHS[platform5];
 }
 function detectCIPlatform(projectDir) {
   const dir = projectDir ?? process.cwd();
@@ -47646,10 +47600,10 @@ workflows:
               only: /^v.*/
 `;
 }
-function generateCIConfig(platform3, cwd) {
+function generateCIConfig(platform5, cwd) {
   const releaseConfig = loadReleaseConfig(cwd);
   const gates = releaseConfig.gates.map((g) => ({ name: g.name, command: g.command }));
-  switch (platform3) {
+  switch (platform5) {
     case "github-actions":
       return generateGitHubActions({ gates });
     case "gitlab-ci":
@@ -47658,10 +47612,10 @@ function generateCIConfig(platform3, cwd) {
       return generateCircleCI({ gates });
   }
 }
-function writeCIConfig(platform3, options = {}) {
+function writeCIConfig(platform5, options = {}) {
   const projectDir = options.projectDir ?? process.cwd();
-  const outputPath = join63(projectDir, getPlatformPath(platform3));
-  const content = generateCIConfig(platform3, projectDir);
+  const outputPath = join63(projectDir, getPlatformPath(platform5));
+  const content = generateCIConfig(platform5, projectDir);
   if (options.dryRun) {
     return { action: "would_write", path: outputPath, content };
   }
@@ -47669,9 +47623,9 @@ function writeCIConfig(platform3, options = {}) {
   writeFileSync6(outputPath, content, "utf-8");
   return { action: "wrote", path: outputPath, content };
 }
-function validateCIConfig(platform3, projectDir) {
+function validateCIConfig(platform5, projectDir) {
   const dir = projectDir ?? process.cwd();
-  const configPath = join63(dir, getPlatformPath(platform3));
+  const configPath = join63(dir, getPlatformPath(platform5));
   if (!existsSync59(configPath)) {
     return { valid: false, exists: false, errors: ["Config file not found"] };
   }
@@ -49213,239 +49167,1463 @@ __export(routing_exports, {
 var CAPABILITY_MATRIX = [
   // === Tasks Domain ===
   // Query operations
-  { domain: "tasks", operation: "show", gateway: "query", mode: "native" },
-  { domain: "tasks", operation: "list", gateway: "query", mode: "native" },
-  { domain: "tasks", operation: "find", gateway: "query", mode: "native" },
-  { domain: "tasks", operation: "tree", gateway: "query", mode: "native" },
-  { domain: "tasks", operation: "blockers", gateway: "query", mode: "native" },
-  { domain: "tasks", operation: "depends", gateway: "query", mode: "native" },
-  { domain: "tasks", operation: "analyze", gateway: "query", mode: "native" },
-  { domain: "tasks", operation: "next", gateway: "query", mode: "native" },
-  { domain: "tasks", operation: "plan", gateway: "query", mode: "native" },
-  { domain: "tasks", operation: "relates", gateway: "query", mode: "native" },
-  { domain: "tasks", operation: "complexity.estimate", gateway: "query", mode: "native" },
-  { domain: "tasks", operation: "history", gateway: "query", mode: "native" },
-  { domain: "tasks", operation: "current", gateway: "query", mode: "native" },
-  { domain: "tasks", operation: "label.list", gateway: "query", mode: "native" },
+  { domain: "tasks", operation: "show", gateway: "query", mode: "native", preferredChannel: "mcp" },
+  { domain: "tasks", operation: "list", gateway: "query", mode: "native", preferredChannel: "mcp" },
+  { domain: "tasks", operation: "find", gateway: "query", mode: "native", preferredChannel: "mcp" },
+  {
+    domain: "tasks",
+    operation: "tree",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tasks",
+    operation: "blockers",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tasks",
+    operation: "depends",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tasks",
+    operation: "analyze",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  { domain: "tasks", operation: "next", gateway: "query", mode: "native", preferredChannel: "mcp" },
+  { domain: "tasks", operation: "plan", gateway: "query", mode: "native", preferredChannel: "mcp" },
+  {
+    domain: "tasks",
+    operation: "relates",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tasks",
+    operation: "complexity.estimate",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tasks",
+    operation: "history",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tasks",
+    operation: "current",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "tasks",
+    operation: "label.list",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
   // Mutate operations
-  { domain: "tasks", operation: "add", gateway: "mutate", mode: "native" },
-  { domain: "tasks", operation: "update", gateway: "mutate", mode: "native" },
-  { domain: "tasks", operation: "complete", gateway: "mutate", mode: "native" },
-  { domain: "tasks", operation: "cancel", gateway: "mutate", mode: "native" },
-  { domain: "tasks", operation: "delete", gateway: "mutate", mode: "native" },
-  { domain: "tasks", operation: "archive", gateway: "mutate", mode: "native" },
-  { domain: "tasks", operation: "restore", gateway: "mutate", mode: "native" },
-  { domain: "tasks", operation: "reparent", gateway: "mutate", mode: "native" },
-  { domain: "tasks", operation: "reorder", gateway: "mutate", mode: "native" },
-  { domain: "tasks", operation: "relates.add", gateway: "mutate", mode: "native" },
-  { domain: "tasks", operation: "start", gateway: "mutate", mode: "native" },
-  { domain: "tasks", operation: "stop", gateway: "mutate", mode: "native" },
+  { domain: "tasks", operation: "add", gateway: "mutate", mode: "native", preferredChannel: "mcp" },
+  {
+    domain: "tasks",
+    operation: "update",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "tasks",
+    operation: "complete",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "tasks",
+    operation: "cancel",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tasks",
+    operation: "delete",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tasks",
+    operation: "archive",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tasks",
+    operation: "restore",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tasks",
+    operation: "reparent",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tasks",
+    operation: "reorder",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tasks",
+    operation: "relates.add",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tasks",
+    operation: "start",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "tasks",
+    operation: "stop",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
   // Sync sub-domain (provider-agnostic task reconciliation)
-  { domain: "tasks", operation: "sync.reconcile", gateway: "mutate", mode: "native" },
-  { domain: "tasks", operation: "sync.links", gateway: "query", mode: "native" },
-  { domain: "tasks", operation: "sync.links.remove", gateway: "mutate", mode: "native" },
+  {
+    domain: "tasks",
+    operation: "sync.reconcile",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tasks",
+    operation: "sync.links",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tasks",
+    operation: "sync.links.remove",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
   // === Session Domain ===
   // Query operations
-  { domain: "session", operation: "status", gateway: "query", mode: "native" },
-  { domain: "session", operation: "list", gateway: "query", mode: "native" },
-  { domain: "session", operation: "show", gateway: "query", mode: "native" },
-  { domain: "session", operation: "decision.log", gateway: "query", mode: "native" },
-  { domain: "session", operation: "context.drift", gateway: "query", mode: "native" },
-  { domain: "session", operation: "handoff.show", gateway: "query", mode: "native" },
-  { domain: "session", operation: "briefing.show", gateway: "query", mode: "native" },
-  { domain: "session", operation: "find", gateway: "query", mode: "native" },
+  {
+    domain: "session",
+    operation: "status",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "session",
+    operation: "list",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "session",
+    operation: "show",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "session",
+    operation: "decision.log",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "session",
+    operation: "context.drift",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "session",
+    operation: "handoff.show",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "session",
+    operation: "briefing.show",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "session",
+    operation: "find",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
   // Mutate operations
-  { domain: "session", operation: "start", gateway: "mutate", mode: "native" },
-  { domain: "session", operation: "end", gateway: "mutate", mode: "native" },
-  { domain: "session", operation: "resume", gateway: "mutate", mode: "native" },
-  { domain: "session", operation: "suspend", gateway: "mutate", mode: "native" },
-  { domain: "session", operation: "gc", gateway: "mutate", mode: "native" },
-  { domain: "session", operation: "record.decision", gateway: "mutate", mode: "native" },
-  { domain: "session", operation: "record.assumption", gateway: "mutate", mode: "native" },
+  {
+    domain: "session",
+    operation: "start",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "session",
+    operation: "end",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "session",
+    operation: "resume",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "session",
+    operation: "suspend",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "session",
+    operation: "gc",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "session",
+    operation: "record.decision",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "session",
+    operation: "record.assumption",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
   // === Admin Domain ===
   // Query operations
-  { domain: "admin", operation: "version", gateway: "query", mode: "native" },
-  { domain: "admin", operation: "health", gateway: "query", mode: "native" },
-  { domain: "admin", operation: "config.show", gateway: "query", mode: "native" },
-  { domain: "admin", operation: "stats", gateway: "query", mode: "native" },
-  { domain: "admin", operation: "context", gateway: "query", mode: "native" },
-  { domain: "admin", operation: "runtime", gateway: "query", mode: "native" },
-  { domain: "admin", operation: "job", gateway: "query", mode: "native" },
-  { domain: "admin", operation: "dash", gateway: "query", mode: "native" },
-  { domain: "admin", operation: "log", gateway: "query", mode: "native" },
-  { domain: "admin", operation: "sequence", gateway: "query", mode: "native" },
-  { domain: "admin", operation: "help", gateway: "query", mode: "native" },
-  { domain: "admin", operation: "token", gateway: "query", mode: "native" },
-  { domain: "admin", operation: "export", gateway: "query", mode: "native" },
-  { domain: "admin", operation: "adr.show", gateway: "query", mode: "native" },
-  { domain: "admin", operation: "adr.find", gateway: "query", mode: "native" },
+  {
+    domain: "admin",
+    operation: "version",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "health",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "config.show",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "stats",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "context",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "runtime",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "job",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  { domain: "admin", operation: "dash", gateway: "query", mode: "native", preferredChannel: "mcp" },
+  {
+    domain: "admin",
+    operation: "log",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "sequence",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  { domain: "admin", operation: "help", gateway: "query", mode: "native", preferredChannel: "mcp" },
+  {
+    domain: "admin",
+    operation: "token",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "export",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "adr.show",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "adr.find",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  { domain: "admin", operation: "map", gateway: "query", mode: "native", preferredChannel: "mcp" },
   // Mutate operations
-  { domain: "admin", operation: "init", gateway: "mutate", mode: "native" },
-  { domain: "admin", operation: "config.set", gateway: "mutate", mode: "native" },
-  { domain: "admin", operation: "backup", gateway: "mutate", mode: "native" },
-  { domain: "admin", operation: "migrate", gateway: "mutate", mode: "native" },
-  { domain: "admin", operation: "cleanup", gateway: "mutate", mode: "native" },
-  { domain: "admin", operation: "safestop", gateway: "mutate", mode: "native" },
-  { domain: "admin", operation: "inject.generate", gateway: "mutate", mode: "native" },
-  { domain: "admin", operation: "job.cancel", gateway: "mutate", mode: "native" },
-  { domain: "admin", operation: "install.global", gateway: "mutate", mode: "native" },
-  { domain: "admin", operation: "token", gateway: "mutate", mode: "native" },
-  { domain: "admin", operation: "health", gateway: "mutate", mode: "native" },
-  { domain: "admin", operation: "detect", gateway: "mutate", mode: "native" },
-  { domain: "admin", operation: "import", gateway: "mutate", mode: "native" },
-  { domain: "admin", operation: "context.inject", gateway: "mutate", mode: "native" },
-  { domain: "admin", operation: "adr.sync", gateway: "mutate", mode: "native" },
+  {
+    domain: "admin",
+    operation: "init",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "config.set",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "backup",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "migrate",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "cleanup",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "safestop",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "inject.generate",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "job.cancel",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "install.global",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "token",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "health",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "detect",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "import",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "context.inject",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "adr.sync",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "admin",
+    operation: "map",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
   // === Check Domain ===
   // Query operations
-  { domain: "check", operation: "schema", gateway: "query", mode: "native" },
-  { domain: "check", operation: "protocol", gateway: "query", mode: "native" },
-  { domain: "check", operation: "task", gateway: "query", mode: "native" },
-  { domain: "check", operation: "manifest", gateway: "query", mode: "native" },
-  { domain: "check", operation: "output", gateway: "query", mode: "native" },
-  { domain: "check", operation: "compliance.summary", gateway: "query", mode: "native" },
-  { domain: "check", operation: "test", gateway: "query", mode: "native" },
-  { domain: "check", operation: "coherence", gateway: "query", mode: "native" },
-  { domain: "check", operation: "gate.status", gateway: "query", mode: "native" },
-  { domain: "check", operation: "archive.stats", gateway: "query", mode: "native" },
-  { domain: "check", operation: "grade", gateway: "query", mode: "native" },
-  { domain: "check", operation: "grade.list", gateway: "query", mode: "native" },
-  { domain: "check", operation: "chain.validate", gateway: "query", mode: "native" },
+  {
+    domain: "check",
+    operation: "schema",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "check",
+    operation: "protocol",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "check",
+    operation: "task",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "check",
+    operation: "manifest",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "check",
+    operation: "output",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "check",
+    operation: "compliance.summary",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "check",
+    operation: "test",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "check",
+    operation: "coherence",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "check",
+    operation: "gate.status",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "check",
+    operation: "archive.stats",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "check",
+    operation: "grade",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "check",
+    operation: "grade.list",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "check",
+    operation: "chain.validate",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
   // Mutate operations
-  { domain: "check", operation: "compliance.record", gateway: "mutate", mode: "native" },
-  { domain: "check", operation: "test.run", gateway: "mutate", mode: "native" },
-  { domain: "check", operation: "gate.set", gateway: "mutate", mode: "native" },
+  {
+    domain: "check",
+    operation: "compliance.record",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "check",
+    operation: "test.run",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "check",
+    operation: "gate.set",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "check",
+    operation: "compliance.sync",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
   // === Orchestrate Domain ===
   // Query operations
-  { domain: "orchestrate", operation: "status", gateway: "query", mode: "native" },
-  { domain: "orchestrate", operation: "next", gateway: "query", mode: "native" },
-  { domain: "orchestrate", operation: "ready", gateway: "query", mode: "native" },
-  { domain: "orchestrate", operation: "analyze", gateway: "query", mode: "native" },
-  { domain: "orchestrate", operation: "context", gateway: "query", mode: "native" },
-  { domain: "orchestrate", operation: "waves", gateway: "query", mode: "native" },
-  { domain: "orchestrate", operation: "bootstrap", gateway: "query", mode: "native" },
-  { domain: "orchestrate", operation: "unblock.opportunities", gateway: "query", mode: "native" },
-  { domain: "orchestrate", operation: "tessera.list", gateway: "query", mode: "native" },
+  {
+    domain: "orchestrate",
+    operation: "status",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "orchestrate",
+    operation: "next",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "orchestrate",
+    operation: "ready",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "orchestrate",
+    operation: "analyze",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "orchestrate",
+    operation: "context",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "orchestrate",
+    operation: "waves",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "orchestrate",
+    operation: "bootstrap",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "orchestrate",
+    operation: "unblock.opportunities",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "orchestrate",
+    operation: "tessera.list",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
   // Mutate operations
-  { domain: "orchestrate", operation: "start", gateway: "mutate", mode: "native" },
-  { domain: "orchestrate", operation: "spawn", gateway: "mutate", mode: "native" },
-  { domain: "orchestrate", operation: "handoff", gateway: "mutate", mode: "native" },
-  { domain: "orchestrate", operation: "spawn.execute", gateway: "mutate", mode: "native" },
-  { domain: "orchestrate", operation: "validate", gateway: "mutate", mode: "native" },
-  { domain: "orchestrate", operation: "parallel", gateway: "mutate", mode: "native" },
-  { domain: "orchestrate", operation: "tessera.instantiate", gateway: "mutate", mode: "native" },
+  {
+    domain: "orchestrate",
+    operation: "start",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "orchestrate",
+    operation: "spawn",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "orchestrate",
+    operation: "handoff",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "orchestrate",
+    operation: "spawn.execute",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "orchestrate",
+    operation: "validate",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "orchestrate",
+    operation: "parallel",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "orchestrate",
+    operation: "tessera.instantiate",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
   // === Memory Domain (brain.db cognitive memory -- T5241) ===
   // Query operations
-  { domain: "memory", operation: "find", gateway: "query", mode: "native" },
-  { domain: "memory", operation: "timeline", gateway: "query", mode: "native" },
-  { domain: "memory", operation: "fetch", gateway: "query", mode: "native" },
-  { domain: "memory", operation: "decision.find", gateway: "query", mode: "native" },
-  { domain: "memory", operation: "pattern.find", gateway: "query", mode: "native" },
-  { domain: "memory", operation: "learning.find", gateway: "query", mode: "native" },
-  { domain: "memory", operation: "graph.show", gateway: "query", mode: "native" },
-  { domain: "memory", operation: "graph.neighbors", gateway: "query", mode: "native" },
-  { domain: "memory", operation: "reason.why", gateway: "query", mode: "native" },
-  { domain: "memory", operation: "reason.similar", gateway: "query", mode: "native" },
-  { domain: "memory", operation: "search.hybrid", gateway: "query", mode: "native" },
+  {
+    domain: "memory",
+    operation: "find",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "memory",
+    operation: "timeline",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "memory",
+    operation: "fetch",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "memory",
+    operation: "decision.find",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "memory",
+    operation: "pattern.find",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "memory",
+    operation: "learning.find",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "memory",
+    operation: "graph.show",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "memory",
+    operation: "graph.neighbors",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "memory",
+    operation: "reason.why",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "memory",
+    operation: "reason.similar",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "memory",
+    operation: "search.hybrid",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
   // Mutate operations
-  { domain: "memory", operation: "observe", gateway: "mutate", mode: "native" },
-  { domain: "memory", operation: "decision.store", gateway: "mutate", mode: "native" },
-  { domain: "memory", operation: "pattern.store", gateway: "mutate", mode: "native" },
-  { domain: "memory", operation: "learning.store", gateway: "mutate", mode: "native" },
-  { domain: "memory", operation: "link", gateway: "mutate", mode: "native" },
-  { domain: "memory", operation: "graph.add", gateway: "mutate", mode: "native" },
-  { domain: "memory", operation: "graph.remove", gateway: "mutate", mode: "native" },
+  {
+    domain: "memory",
+    operation: "observe",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "memory",
+    operation: "decision.store",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "memory",
+    operation: "pattern.store",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "memory",
+    operation: "learning.store",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "memory",
+    operation: "link",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "memory",
+    operation: "graph.add",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "memory",
+    operation: "graph.remove",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
   // === Pipeline Domain ===
   // Stage sub-domain (RCASD lifecycle)
-  { domain: "pipeline", operation: "stage.validate", gateway: "query", mode: "native" },
-  { domain: "pipeline", operation: "stage.status", gateway: "query", mode: "native" },
-  { domain: "pipeline", operation: "stage.history", gateway: "query", mode: "native" },
-  { domain: "pipeline", operation: "stage.record", gateway: "mutate", mode: "native" },
-  { domain: "pipeline", operation: "stage.skip", gateway: "mutate", mode: "native" },
-  { domain: "pipeline", operation: "stage.reset", gateway: "mutate", mode: "native" },
-  { domain: "pipeline", operation: "stage.gate.pass", gateway: "mutate", mode: "native" },
-  { domain: "pipeline", operation: "stage.gate.fail", gateway: "mutate", mode: "native" },
+  {
+    domain: "pipeline",
+    operation: "stage.validate",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "pipeline",
+    operation: "stage.status",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "pipeline",
+    operation: "stage.history",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "stage.record",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "stage.skip",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "stage.reset",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "stage.gate.pass",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "stage.gate.fail",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
   // Manifest sub-domain (T5241)
-  { domain: "pipeline", operation: "manifest.show", gateway: "query", mode: "native" },
-  { domain: "pipeline", operation: "manifest.list", gateway: "query", mode: "native" },
-  { domain: "pipeline", operation: "manifest.find", gateway: "query", mode: "native" },
-  { domain: "pipeline", operation: "manifest.stats", gateway: "query", mode: "native" },
-  { domain: "pipeline", operation: "manifest.append", gateway: "mutate", mode: "native" },
-  { domain: "pipeline", operation: "manifest.archive", gateway: "mutate", mode: "native" },
+  {
+    domain: "pipeline",
+    operation: "manifest.show",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "manifest.list",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "manifest.find",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "manifest.stats",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "manifest.append",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "manifest.archive",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
   // Phase sub-domain (T5326)
-  { domain: "pipeline", operation: "phase.show", gateway: "query", mode: "native" },
-  { domain: "pipeline", operation: "phase.list", gateway: "query", mode: "native" },
-  { domain: "pipeline", operation: "phase.set", gateway: "mutate", mode: "native" },
-  { domain: "pipeline", operation: "phase.advance", gateway: "mutate", mode: "native" },
-  { domain: "pipeline", operation: "phase.rename", gateway: "mutate", mode: "native" },
-  { domain: "pipeline", operation: "phase.delete", gateway: "mutate", mode: "native" },
+  {
+    domain: "pipeline",
+    operation: "phase.show",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "phase.list",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "phase.set",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "phase.advance",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "phase.rename",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "phase.delete",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
   // Chain sub-domain (T5405)
-  { domain: "pipeline", operation: "chain.show", gateway: "query", mode: "native" },
-  { domain: "pipeline", operation: "chain.list", gateway: "query", mode: "native" },
-  { domain: "pipeline", operation: "chain.add", gateway: "mutate", mode: "native" },
-  { domain: "pipeline", operation: "chain.instantiate", gateway: "mutate", mode: "native" },
-  { domain: "pipeline", operation: "chain.advance", gateway: "mutate", mode: "native" },
+  {
+    domain: "pipeline",
+    operation: "chain.show",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "chain.list",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "chain.add",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "chain.instantiate",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "chain.advance",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
   // Release sub-domain (T5615 consolidated)
-  { domain: "pipeline", operation: "release.list", gateway: "query", mode: "native" },
-  { domain: "pipeline", operation: "release.show", gateway: "query", mode: "native" },
-  { domain: "pipeline", operation: "release.channel.show", gateway: "query", mode: "native" },
-  { domain: "pipeline", operation: "release.ship", gateway: "mutate", mode: "native" },
-  { domain: "pipeline", operation: "release.cancel", gateway: "mutate", mode: "native" },
-  { domain: "pipeline", operation: "release.rollback", gateway: "mutate", mode: "native" },
+  {
+    domain: "pipeline",
+    operation: "release.list",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "release.show",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "release.channel.show",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "release.ship",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "cli"
+  },
+  {
+    domain: "pipeline",
+    operation: "release.cancel",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "pipeline",
+    operation: "release.rollback",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
   // === Tools Domain ===
   // Issue operations
-  { domain: "tools", operation: "issue.diagnostics", gateway: "query", mode: "native" },
+  {
+    domain: "tools",
+    operation: "issue.diagnostics",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
   // Skill operations
-  { domain: "tools", operation: "skill.list", gateway: "query", mode: "native" },
-  { domain: "tools", operation: "skill.show", gateway: "query", mode: "native" },
-  { domain: "tools", operation: "skill.find", gateway: "query", mode: "native" },
-  { domain: "tools", operation: "skill.dispatch", gateway: "query", mode: "native" },
-  { domain: "tools", operation: "skill.verify", gateway: "query", mode: "native" },
-  { domain: "tools", operation: "skill.dependencies", gateway: "query", mode: "native" },
-  { domain: "tools", operation: "skill.spawn.providers", gateway: "query", mode: "native" },
-  { domain: "tools", operation: "skill.catalog", gateway: "query", mode: "native" },
-  { domain: "tools", operation: "skill.precedence", gateway: "query", mode: "native" },
-  { domain: "tools", operation: "skill.install", gateway: "mutate", mode: "native" },
-  { domain: "tools", operation: "skill.uninstall", gateway: "mutate", mode: "native" },
-  { domain: "tools", operation: "skill.refresh", gateway: "mutate", mode: "native" },
+  {
+    domain: "tools",
+    operation: "skill.list",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "tools",
+    operation: "skill.show",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "tools",
+    operation: "skill.find",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "tools",
+    operation: "skill.dispatch",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tools",
+    operation: "skill.verify",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tools",
+    operation: "skill.dependencies",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tools",
+    operation: "skill.spawn.providers",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tools",
+    operation: "skill.catalog",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tools",
+    operation: "skill.precedence",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tools",
+    operation: "skill.install",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tools",
+    operation: "skill.uninstall",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tools",
+    operation: "skill.refresh",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
   // Provider operations
-  { domain: "tools", operation: "provider.list", gateway: "query", mode: "native" },
-  { domain: "tools", operation: "provider.detect", gateway: "query", mode: "native" },
-  { domain: "tools", operation: "provider.inject.status", gateway: "query", mode: "native" },
-  { domain: "tools", operation: "provider.supports", gateway: "query", mode: "native" },
-  { domain: "tools", operation: "provider.hooks", gateway: "query", mode: "native" },
-  { domain: "tools", operation: "provider.inject", gateway: "mutate", mode: "native" },
+  {
+    domain: "tools",
+    operation: "provider.list",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "tools",
+    operation: "provider.detect",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "tools",
+    operation: "provider.inject.status",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tools",
+    operation: "provider.supports",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tools",
+    operation: "provider.hooks",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tools",
+    operation: "provider.inject",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  // Adapter sub-domain (T5240)
+  {
+    domain: "tools",
+    operation: "adapter.list",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "tools",
+    operation: "adapter.show",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "tools",
+    operation: "adapter.detect",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tools",
+    operation: "adapter.health",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "tools",
+    operation: "adapter.activate",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "tools",
+    operation: "adapter.dispose",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
   // === Nexus Domain ===
   // Query operations
-  { domain: "nexus", operation: "status", gateway: "query", mode: "native" },
-  { domain: "nexus", operation: "list", gateway: "query", mode: "native" },
-  { domain: "nexus", operation: "show", gateway: "query", mode: "native" },
-  { domain: "nexus", operation: "search", gateway: "query", mode: "native" },
-  { domain: "nexus", operation: "graph", gateway: "query", mode: "native" },
-  { domain: "nexus", operation: "deps", gateway: "query", mode: "native" },
-  { domain: "nexus", operation: "resolve", gateway: "query", mode: "native" },
-  { domain: "nexus", operation: "discover", gateway: "query", mode: "native" },
-  { domain: "nexus", operation: "orphans.list", gateway: "query", mode: "native" },
-  { domain: "nexus", operation: "blockers.show", gateway: "query", mode: "native" },
-  { domain: "nexus", operation: "path.show", gateway: "query", mode: "native" },
-  { domain: "nexus", operation: "share.status", gateway: "query", mode: "native" },
+  {
+    domain: "nexus",
+    operation: "status",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "nexus",
+    operation: "list",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "nexus",
+    operation: "show",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "nexus",
+    operation: "search",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "nexus",
+    operation: "graph",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "nexus",
+    operation: "deps",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "nexus",
+    operation: "resolve",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "nexus",
+    operation: "discover",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "nexus",
+    operation: "orphans.list",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "nexus",
+    operation: "blockers.show",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "nexus",
+    operation: "path.show",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "nexus",
+    operation: "share.status",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "nexus",
+    operation: "transfer.preview",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "either"
+  },
   // Mutate operations
-  { domain: "nexus", operation: "init", gateway: "mutate", mode: "native" },
-  { domain: "nexus", operation: "register", gateway: "mutate", mode: "native" },
-  { domain: "nexus", operation: "unregister", gateway: "mutate", mode: "native" },
-  { domain: "nexus", operation: "sync", gateway: "mutate", mode: "native" },
-  { domain: "nexus", operation: "reconcile", gateway: "mutate", mode: "native" },
-  { domain: "nexus", operation: "permission.set", gateway: "mutate", mode: "native" },
-  { domain: "nexus", operation: "share.snapshot.export", gateway: "mutate", mode: "native" },
-  { domain: "nexus", operation: "share.snapshot.import", gateway: "mutate", mode: "native" },
+  {
+    domain: "nexus",
+    operation: "init",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "nexus",
+    operation: "register",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "nexus",
+    operation: "unregister",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "nexus",
+    operation: "sync",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "nexus",
+    operation: "reconcile",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "nexus",
+    operation: "permission.set",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "nexus",
+    operation: "share.snapshot.export",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "nexus",
+    operation: "share.snapshot.import",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "nexus",
+    operation: "transfer",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
   // === Sticky Domain ===
   // Query operations
-  { domain: "sticky", operation: "list", gateway: "query", mode: "native" },
-  { domain: "sticky", operation: "show", gateway: "query", mode: "native" },
+  {
+    domain: "sticky",
+    operation: "list",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "sticky",
+    operation: "show",
+    gateway: "query",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
   // Mutate operations
-  { domain: "sticky", operation: "add", gateway: "mutate", mode: "native" },
-  { domain: "sticky", operation: "archive", gateway: "mutate", mode: "native" },
-  { domain: "sticky", operation: "convert", gateway: "mutate", mode: "native" },
-  { domain: "sticky", operation: "purge", gateway: "mutate", mode: "native" }
+  {
+    domain: "sticky",
+    operation: "add",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "mcp"
+  },
+  {
+    domain: "sticky",
+    operation: "archive",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "sticky",
+    operation: "convert",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  },
+  {
+    domain: "sticky",
+    operation: "purge",
+    gateway: "mutate",
+    mode: "native",
+    preferredChannel: "either"
+  }
 ];
 function getOperationMode(domain2, operation, gateway) {
   const entry = CAPABILITY_MATRIX.find(
@@ -50465,7 +51643,9 @@ function extractBody(content) {
 // packages/core/src/skills/agents/install.ts
 init_paths();
 import { existsSync as existsSync66, mkdirSync as mkdirSync14, readdirSync as readdirSync25, readlinkSync, symlinkSync, unlinkSync as unlinkSync4 } from "node:fs";
+import { platform as platform2 } from "node:os";
 import { basename as basename12, join as join70 } from "node:path";
+var DIR_SYMLINK_TYPE = platform2() === "win32" ? "junction" : "dir";
 function getAgentInstallDir() {
   return getClaudeAgentsDir();
 }
@@ -50495,7 +51675,7 @@ function installAgent(agentDir) {
     }
   }
   try {
-    symlinkSync(agentDir, targetPath, "dir");
+    symlinkSync(agentDir, targetPath, DIR_SYMLINK_TYPE);
     return { installed: true, path: targetPath };
   } catch (err) {
     return { installed: false, path: targetPath, error: `Symlink failed: ${err}` };
@@ -52391,11 +53571,11 @@ async function validateOrchestratorCompliance(epicId, cwd) {
 }
 
 // packages/core/src/skills/skill-paths.ts
-init_paths();
 import { existsSync as existsSync76, lstatSync, readlinkSync as readlinkSync2, realpathSync as realpathSync2 } from "node:fs";
 import { delimiter, join as join79, resolve as resolve9 } from "node:path";
+import { getCanonicalSkillsDir as getCanonicalSkillsDir2 } from "@cleocode/caamp";
 function getCaampCanonical() {
-  return join79(getAgentsHome(), "skills");
+  return getCanonicalSkillsDir2();
 }
 function getProjectEmbedded(projectRoot) {
   const root = projectRoot ?? process.cwd();
@@ -54541,7 +55721,7 @@ function getNodeVersionInfo() {
   };
 }
 function getNodeUpgradeInstructions() {
-  const platform3 = detectPlatform();
+  const platform5 = detectPlatform();
   const arch2 = process.arch;
   const instructions = [];
   const hasFnm = commandExists2("fnm");
@@ -54556,7 +55736,7 @@ function getNodeUpgradeInstructions() {
   if (hasVolta) {
     instructions.push(`volta install node@${MINIMUM_NODE_MAJOR}`);
   }
-  switch (platform3) {
+  switch (platform5) {
     case "linux":
       if (commandExists2("dnf")) {
         instructions.push(
@@ -54588,7 +55768,7 @@ function getNodeUpgradeInstructions() {
   }
   instructions.push(`https://nodejs.org/en/download/`);
   const recommended = instructions[0] ?? `https://nodejs.org/en/download/`;
-  return { platform: platform3, arch: arch2, instructions, recommended };
+  return { platform: platform5, arch: arch2, instructions, recommended };
 }
 function getSystemInfo2() {
   return {
@@ -57160,7 +58340,6 @@ function validateLabels2(labels, repoLabels) {
 var ui_exports = {};
 __export(ui_exports, {
   ALIASES_VERSION: () => ALIASES_VERSION,
-  INJECTION_VALIDATION_KEYS: () => INJECTION_VALIDATION_KEYS,
   appendToChangelog: () => appendToChangelog,
   checkAliasesStatus: () => checkAliasesStatus,
   defaultFlags: () => defaultFlags,
@@ -57177,7 +58356,6 @@ __export(ui_exports, {
   getCurrentShell: () => getCurrentShell,
   getInstalledVersion: () => getInstalledVersion,
   getRcFilePath: () => getRcFilePath,
-  getValidationKey: () => getValidationKey,
   groupTasksIntoSections: () => groupTasksIntoSections,
   hasAliasBlock: () => hasAliasBlock,
   injectAliases: () => injectAliases,
@@ -57193,7 +58371,7 @@ __export(ui_exports, {
 
 // packages/core/src/ui/aliases.ts
 import { existsSync as existsSync92, readFileSync as readFileSync67, writeFileSync as writeFileSync15 } from "node:fs";
-import { homedir as homedir5, platform as platform2 } from "node:os";
+import { homedir as homedir5, platform as platform3 } from "node:os";
 import { join as join96 } from "node:path";
 var MARKER_START = "# CLEO-CLAUDE-ALIASES:START";
 var MARKER_END = "# CLEO-CLAUDE-ALIASES:END";
@@ -57208,7 +58386,7 @@ function getCurrentShell() {
   const shell = process.env.SHELL ?? "";
   if (shell.includes("zsh")) return "zsh";
   if (shell.includes("bash")) return "bash";
-  if (platform2() === "win32") return "powershell";
+  if (platform3() === "win32") return "powershell";
   return "bash";
 }
 function getRcFilePath(shell) {
@@ -57232,7 +58410,7 @@ function detectAvailableShells() {
   const shells = [];
   if (existsSync92(getRcFilePath("bash")) || existsSync92("/bin/bash")) shells.push("bash");
   if (existsSync92(getRcFilePath("zsh")) || existsSync92("/bin/zsh")) shells.push("zsh");
-  if (platform2() === "win32") shells.push("powershell");
+  if (platform3() === "win32") shells.push("powershell");
   return shells;
 }
 function generateBashAliases(cleoPath) {
@@ -57664,16 +58842,6 @@ function isJsonOutput(flags) {
   return resolveFormat(flags.format) === "json";
 }
 
-// packages/core/src/ui/injection-legacy.ts
-var INJECTION_VALIDATION_KEYS = {
-  "CLAUDE.md": "claude_md",
-  "AGENTS.md": "agents_md",
-  "GEMINI.md": "gemini_md"
-};
-function getValidationKey(target) {
-  return INJECTION_VALIDATION_KEYS[target] ?? target.toLowerCase().replace(/[^a-z0-9]/g, "_");
-}
-
 // packages/core/src/validation/index.ts
 var validation_exports = {};
 __export(validation_exports, {
@@ -60654,15 +61822,34 @@ init_injection();
 init_memory_bridge();
 import { existsSync as existsSync99, readdirSync as readdirSync33, readFileSync as readFileSync73 } from "node:fs";
 import { copyFile as copyFile3, lstat, mkdir as mkdir16, readFile as readFile17, symlink, unlink as unlink4, writeFile as writeFile11 } from "node:fs/promises";
+import { platform as platform4 } from "node:os";
 import { basename as basename17, dirname as dirname19, join as join100 } from "node:path";
 init_paths();
 init_scaffold();
 init_schema_management();
 init_json2();
+var DIR_SYMLINK_TYPE2 = platform4() === "win32" ? "junction" : "dir";
 async function initAgentDefinition(created, warnings) {
-  const packageRoot = getPackageRoot();
-  const agentSourceDir = join100(packageRoot, "agents", "cleo-subagent");
-  if (!existsSync99(agentSourceDir)) {
+  let agentSourceDir = null;
+  try {
+    const { createRequire: createRequire5 } = await import("node:module");
+    const req = createRequire5(import.meta.url);
+    const agentsPkgMain = req.resolve("@cleocode/agents/package.json");
+    const agentsPkgRoot = dirname19(agentsPkgMain);
+    const candidate = join100(agentsPkgRoot, "cleo-subagent");
+    if (existsSync99(candidate)) {
+      agentSourceDir = candidate;
+    }
+  } catch {
+  }
+  if (!agentSourceDir) {
+    const packageRoot = getPackageRoot();
+    const bundled = join100(packageRoot, "agents", "cleo-subagent");
+    if (existsSync99(bundled)) {
+      agentSourceDir = bundled;
+    }
+  }
+  if (!agentSourceDir) {
     warnings.push("agents/cleo-subagent/ not found in package, skipping agent definition install");
     return;
   }
@@ -60676,7 +61863,7 @@ async function initAgentDefinition(created, warnings) {
       }
     } catch {
     }
-    await symlink(agentSourceDir, globalAgentsDir, "dir");
+    await symlink(agentSourceDir, globalAgentsDir, DIR_SYMLINK_TYPE2);
     created.push("agent: cleo-subagent (symlinked)");
   } catch (_err) {
     try {
@@ -60693,61 +61880,6 @@ async function initAgentDefinition(created, warnings) {
     }
   }
 }
-async function initCoreSkills(created, warnings) {
-  try {
-    const { getInstalledProviders: getInstalledProviders3, installSkill: installSkill2, registerSkillLibraryFromPath } = await import("@cleocode/caamp");
-    const providers = getInstalledProviders3();
-    if (providers.length === 0) {
-      return;
-    }
-    const packageRoot = getPackageRoot();
-    let ctSkillsRoot = null;
-    try {
-      const bundledPath = join100(packageRoot, "packages", "skills");
-      if (existsSync99(join100(bundledPath, "skills.json"))) {
-        ctSkillsRoot = bundledPath;
-      } else {
-        const ctSkillsPath = join100(packageRoot, "node_modules", "@cleocode", "skills");
-        if (existsSync99(join100(ctSkillsPath, "skills.json"))) {
-          ctSkillsRoot = ctSkillsPath;
-        }
-      }
-    } catch {
-    }
-    if (!ctSkillsRoot) {
-      warnings.push("skills package not found, skipping core skill installation");
-      return;
-    }
-    try {
-      registerSkillLibraryFromPath(ctSkillsRoot);
-    } catch {
-      warnings.push("Failed to register skill library with CAAMP");
-    }
-    const catalogPath = join100(ctSkillsRoot, "skills.json");
-    const catalog3 = JSON.parse(readFileSync73(catalogPath, "utf-8"));
-    const skills = catalog3.skills ?? [];
-    const coreSkills = skills.filter((s) => s.tier <= 2);
-    const installed = [];
-    for (const skill of coreSkills) {
-      const skillSourceDir = dirname19(join100(ctSkillsRoot, skill.path));
-      if (!existsSync99(skillSourceDir)) {
-        continue;
-      }
-      try {
-        const result = await installSkill2(skillSourceDir, skill.name, providers, true);
-        if (result.success) {
-          installed.push(skill.name);
-        }
-      } catch {
-      }
-    }
-    if (installed.length > 0) {
-      created.push(`skills: ${installed.length} core skills installed`);
-    }
-  } catch (err) {
-    warnings.push(`Core skill install: ${err instanceof Error ? err.message : String(err)}`);
-  }
-}
 async function initNexusRegistration(projectRoot, created, warnings) {
   try {
     const { nexusReconcile: nexusReconcile2 } = await Promise.resolve().then(() => (init_registry3(), registry_exports3));
@@ -61005,7 +62137,6 @@ async function initProject(opts = {}) {
     warnings.push(`Contributor MCP setup: ${err instanceof Error ? err.message : String(err)}`);
   }
   await initAgentDefinition(created, warnings);
-  await initCoreSkills(created, warnings);
   await initNexusRegistration(projRoot, created, warnings);
   try {
     const { AdapterManager: AdapterManager2 } = await Promise.resolve().then(() => (init_adapters(), adapters_exports));