syntaur 0.24.0 → 0.25.0

package/dist/index.js

@@ -93,9 +93,10 @@ __export(fs_exports, {
   ensureDir: () => ensureDir,
   fileExists: () => fileExists,
   writeFileForce: () => writeFileForce,
+  writeFileReport: () => writeFileReport,
   writeFileSafe: () => writeFileSafe
 });
-import { mkdir, writeFile, access, rename } from "fs/promises";
+import { mkdir, writeFile, readFile, access, rename } from "fs/promises";
 import { dirname, join } from "path";
 async function ensureDir(dir) {
   await mkdir(dir, { recursive: true });
@@ -126,6 +127,22 @@ async function writeFileForce(filePath, content) {
   await writeFile(tempPath, content, "utf-8");
   await rename(tempPath, filePath);
 }
+async function writeFileReport(filePath, content, options = {}) {
+  if (!await fileExists(filePath)) {
+    await ensureDir(dirname(filePath));
+    await writeFile(filePath, content, "utf-8");
+    return "written";
+  }
+  const current = await readFile(filePath, "utf-8").catch(() => null);
+  if (current === content) {
+    return "already-current";
+  }
+  if (!options.force) {
+    return "differs-preserved";
+  }
+  await writeFileForce(filePath, content);
+  return "overwritten";
+}
 var init_fs = __esm({
   "src/utils/fs.ts"() {
     "use strict";
@@ -471,7 +488,7 @@ var init_timestamp = __esm({
 });
 
 // src/utils/fs-migration.ts
-import { readdir, readFile, rename as rename2, writeFile as writeFile2 } from "fs/promises";
+import { readdir, readFile as readFile2, rename as rename2, writeFile as writeFile2 } from "fs/promises";
 import { resolve as resolve2 } from "path";
 async function migrateLegacyProjectFiles(projectsDir2) {
   const result = {
@@ -540,7 +557,7 @@ async function migrateLegacyArchivedProjects(projectsDir2) {
     const projectMd = resolve2(projectsDir2, entry.name, "project.md");
     try {
       if (!await fileExists(projectMd)) continue;
-      const content = await readFile(projectMd, "utf-8");
+      const content = await readFile2(projectMd, "utf-8");
       if (readFrontmatterField(content, "statusOverride") !== "archived") continue;
       let next = setFrontmatterField(content, "archived", true);
       if (readFrontmatterField(content, "archivedAt") === null) {
@@ -565,7 +582,7 @@ async function migrateLegacyConfig(configPath) {
   if (!await fileExists(configPath)) return result;
   let content;
   try {
-    content = await readFile(configPath, "utf-8");
+    content = await readFile2(configPath, "utf-8");
   } catch {
     return result;
   }
@@ -822,7 +839,7 @@ __export(config_exports, {
   writeTerminalConfig: () => writeTerminalConfig,
   writeThemeConfig: () => writeThemeConfig
 });
-import { readFile as readFile2 } from "fs/promises";
+import { readFile as readFile3 } from "fs/promises";
 import { spawnSync } from "child_process";
 import { resolve as resolve3, isAbsolute } from "path";
 function parseAgentCommand(value, agentId) {
@@ -950,6 +967,18 @@ function parseFrontmatter(content) {
   }
   return result;
 }
+function parseInstalledAgents(fm) {
+  const prefix = "integrations.installedAgents.";
+  const installedAgents = {};
+  for (const [key, value] of Object.entries(fm)) {
+    if (!key.startsWith(prefix)) continue;
+    const id = key.slice(prefix.length);
+    if (!id) continue;
+    const scope = value === "project" ? "project" : "global";
+    installedAgents[id] = { scope };
+  }
+  return Object.keys(installedAgents).length > 0 ? { installedAgents } : {};
+}
 function parseStatusConfig(content) {
   const match = content.match(/^---\n([\s\S]*?)\n---/);
   if (!match) return null;
@@ -1079,6 +1108,11 @@ function serializeIntegrationConfig(integrations) {
   if (integrations.codexMarketplacePath) {
     lines.push(`  codexMarketplacePath: ${integrations.codexMarketplacePath}`);
   }
+  if (integrations.installedAgents) {
+    for (const [id, rec] of Object.entries(integrations.installedAgents)) {
+      lines.push(`  installedAgents.${id}: ${rec.scope}`);
+    }
+  }
   if (lines.length === 0) {
     return null;
   }
@@ -1147,7 +1181,7 @@ async function updatePlaybooksConfig(playbooks) {
     disabled: Array.from(new Set(playbooks.disabled ?? current.disabled))
   };
   const playbooksBlock = serializePlaybooksConfig(nextPlaybooks);
-  const existing = await fileExists(configPath) ? await readFile2(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
+  const existing = await fileExists(configPath) ? await readFile3(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) {
     const bodyBlock = playbooksBlock ? `${playbooksBlock}
@@ -1199,7 +1233,7 @@ function serializeThemeConfig(theme) {
 async function writeThemeConfig(theme) {
   const configPath = resolve3(syntaurRoot(), "config.md");
   const themeBlock = serializeThemeConfig(theme);
-  const existing = await fileExists(configPath) ? await readFile2(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
+  const existing = await fileExists(configPath) ? await readFile3(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) {
     const content = `---
@@ -1225,7 +1259,7 @@ ${normalizedFm}
 async function deleteThemeConfig() {
   const configPath = resolve3(syntaurRoot(), "config.md");
   if (!await fileExists(configPath)) return;
-  const existing = await readFile2(configPath, "utf-8");
+  const existing = await readFile3(configPath, "utf-8");
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) return;
   const fmBlock = fmMatch[2];
@@ -1245,7 +1279,7 @@ function stripTopLevelScalar(fmBlock, key) {
 async function writeTerminalConfig(terminal) {
   const configPath = resolve3(syntaurRoot(), "config.md");
   const terminalLine = `terminal: ${terminal}`;
-  const existing = await fileExists(configPath) ? await readFile2(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
+  const existing = await fileExists(configPath) ? await readFile3(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) {
     const content = `---
@@ -1271,7 +1305,7 @@ ${normalizedFm}
 async function deleteTerminalConfig() {
   const configPath = resolve3(syntaurRoot(), "config.md");
   if (!await fileExists(configPath)) return;
-  const existing = await readFile2(configPath, "utf-8");
+  const existing = await readFile3(configPath, "utf-8");
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) return;
   const fmBlock = fmMatch[2];
@@ -1340,7 +1374,7 @@ async function writeHotkeyBindingsConfig(cfg) {
   }
   const configPath = resolve3(syntaurRoot(), "config.md");
   const block = serializeHotkeyBindingsConfig({ bindings: cleaned });
-  const existing = await fileExists(configPath) ? await readFile2(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
+  const existing = await fileExists(configPath) ? await readFile3(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) {
     const content = `---
@@ -1366,7 +1400,7 @@ ${normalizedFm}
 async function deleteHotkeyBindingsConfig() {
   const configPath = resolve3(syntaurRoot(), "config.md");
   if (!await fileExists(configPath)) return;
-  const existing = await readFile2(configPath, "utf-8");
+  const existing = await readFile3(configPath, "utf-8");
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) return;
   const fmBlock = fmMatch[2];
@@ -1683,7 +1717,7 @@ async function writeAgentsConfig(agents) {
   validateAgentList(agents);
   const configPath = resolve3(syntaurRoot(), "config.md");
   const agentsBlock = serializeAgentsConfig(agents);
-  const existing = await fileExists(configPath) ? await readFile2(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
+  const existing = await fileExists(configPath) ? await readFile3(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) {
     const content = `---
@@ -1708,7 +1742,7 @@ ${newFm}
 async function deleteAgentsConfig() {
   const configPath = resolve3(syntaurRoot(), "config.md");
   if (!await fileExists(configPath)) return;
-  const existing = await readFile2(configPath, "utf-8");
+  const existing = await readFile3(configPath, "utf-8");
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) return;
   const fmBlock = fmMatch[2];
@@ -1732,7 +1766,7 @@ ${statusBlock}
     await writeFileForce(configPath, content);
     return;
   }
-  const existing = await readFile2(configPath, "utf-8");
+  const existing = await readFile3(configPath, "utf-8");
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) {
     const content = `---
@@ -1776,7 +1810,7 @@ ${statusBlock}
 async function deleteStatusConfig() {
   const configPath = resolve3(syntaurRoot(), "config.md");
   if (!await fileExists(configPath)) return;
-  const existing = await readFile2(configPath, "utf-8");
+  const existing = await readFile3(configPath, "utf-8");
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) return;
   const fmBlock = fmMatch[2];
@@ -1794,7 +1828,7 @@ async function updateIntegrationConfig(integrations) {
     ...integrations
   };
   const integrationBlock = serializeIntegrationConfig(nextIntegrations);
-  const existing = await fileExists(configPath) ? await readFile2(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
+  const existing = await fileExists(configPath) ? await readFile3(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) {
     const content = `---
@@ -1824,7 +1858,7 @@ async function updateOnboardingConfig(onboarding) {
     ...onboarding
   };
   const onboardingBlock = serializeOnboardingConfig(nextOnboarding);
-  const existing = await fileExists(configPath) ? await readFile2(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
+  const existing = await fileExists(configPath) ? await readFile3(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) {
     const content = `---
@@ -1858,7 +1892,7 @@ async function updateBackupConfig(backup) {
     ...backup
   };
   const backupBlock = serializeBackupConfig(nextBackup);
-  const existing = await fileExists(configPath) ? await readFile2(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
+  const existing = await fileExists(configPath) ? await readFile3(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) {
     const content = `---
@@ -1890,7 +1924,7 @@ async function readConfig() {
     migratedConfigPaths.add(configPath);
     await migrateLegacyConfig(configPath);
   }
-  const content = await readFile2(configPath, "utf-8");
+  const content = await readFile3(configPath, "utf-8");
   const fm = parseFrontmatter(content);
   if (Object.keys(fm).length === 0) {
     console.warn("Warning: ~/.syntaur/config.md has malformed frontmatter, using defaults");
@@ -1929,7 +1963,8 @@ async function readConfig() {
       codexMarketplacePath: parseOptionalAbsolutePath(
         fm["integrations.codexMarketplacePath"],
         "integrations.codexMarketplacePath"
-      )
+      ),
+      ...parseInstalledAgents(fm)
     },
     backup: fm["backup.repo"] || fm["backup.categories"] ? {
       repo: fm["backup.repo"] && fm["backup.repo"] !== "null" ? fm["backup.repo"] : null,
@@ -2094,7 +2129,7 @@ var init_slug = __esm({
 
 // src/utils/playbooks.ts
 import { resolve as resolve4 } from "path";
-import { readdir as readdir2, readFile as readFile3, unlink } from "fs/promises";
+import { readdir as readdir2, readFile as readFile4, unlink } from "fs/promises";
 function escapeRegExp(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
@@ -2120,7 +2155,7 @@ async function resolvePlaybookSlug(playbooksDir3, slug) {
   for (const entry of entries) {
     if (!isVisiblePlaybookFile(entry.name, entry.isFile())) continue;
     const filePath = resolve4(playbooksDir3, entry.name);
-    const raw = await readFile3(filePath, "utf-8");
+    const raw = await readFile4(filePath, "utf-8");
     const parsed = parsePlaybook(raw);
     const canonical = parsed.slug || entry.name.replace(/\.md$/, "");
     if (canonical === slug) {
@@ -2168,7 +2203,7 @@ async function rebuildPlaybookManifest(playbooksDir3) {
   const rows = [];
   for (const entry of entries) {
     if (!isVisiblePlaybookFile(entry.name, entry.isFile())) continue;
-    const raw = await readFile3(resolve4(playbooksDir3, entry.name), "utf-8");
+    const raw = await readFile4(resolve4(playbooksDir3, entry.name), "utf-8");
     const parsed = parsePlaybook(raw);
     const slug = parsed.slug || entry.name.replace(/\.md$/, "");
     if (disabledSet.has(slug)) continue;
@@ -2246,7 +2281,7 @@ async function renamePlaybook(playbooksDir3, oldSlug, newSlug) {
       );
     }
   }
-  const raw = await readFile3(oldPath, "utf-8");
+  const raw = await readFile4(oldPath, "utf-8");
   let next = setFrontmatterField2(raw, "slug", newSlug);
   next = setFrontmatterField2(next, "updated", `"${nowTimestamp()}"`);
   await writeFileForce(newPath, next);
@@ -3173,6 +3208,24 @@ var init_opencode_config = __esm({
   }
 });
 
+// src/templates/hermes-soul.ts
+function renderHermesSoul(params2) {
+  const body = renderCodexAgents(params2);
+  return `# SOUL -- Syntaur Protocol Operator
+
+This agent follows the Syntaur protocol for multi-agent project coordination.
+Hermes loads this file as part of its identity / system context; treat the
+Write Boundary Rules and Lifecycle sections below as binding.
+
+${body}`;
+}
+var init_hermes_soul = __esm({
+  "src/templates/hermes-soul.ts"() {
+    "use strict";
+    init_codex_agents();
+  }
+});
+
 // src/templates/index.ts
 var init_templates = __esm({
   "src/templates/index.ts"() {
@@ -3193,6 +3246,7 @@ var init_templates = __esm({
     init_cursor_rules();
     init_codex_agents();
     init_opencode_config();
+    init_hermes_soul();
   }
 });
 
@@ -3745,7 +3799,7 @@ __export(parser_exports, {
   writeChecklist: () => writeChecklist
 });
 import { randomBytes } from "crypto";
-import { readFile as readFile5 } from "fs/promises";
+import { readFile as readFile6 } from "fs/promises";
 import { resolve as resolve8 } from "path";
 function generateShortId() {
   return randomBytes(2).toString("hex");
@@ -4042,7 +4096,7 @@ async function readChecklist(todosDir2, workspace) {
   if (!await fileExists(path)) {
     return { workspace, archiveInterval: "weekly", items: [] };
   }
-  const content = await readFile5(path, "utf-8");
+  const content = await readFile6(path, "utf-8");
   return parseChecklist(content);
 }
 async function writeChecklist(todosDir2, checklist) {
@@ -4055,7 +4109,7 @@ async function readLog(todosDir2, workspace) {
   if (!await fileExists(path)) {
     return { workspace, entries: [] };
   }
-  const content = await readFile5(path, "utf-8");
+  const content = await readFile6(path, "utf-8");
   return parseLog(content);
 }
 async function appendLogEntry(todosDir2, workspace, entry) {
@@ -4063,7 +4117,7 @@ async function appendLogEntry(todosDir2, workspace, entry) {
   const path = logPath(todosDir2, workspace);
   let content;
   if (await fileExists(path)) {
-    content = await readFile5(path, "utf-8");
+    content = await readFile6(path, "utf-8");
     content = content.trimEnd() + "\n\n" + serializeLogEntry(entry) + "\n";
   } else {
     const fm = `---
@@ -4231,7 +4285,7 @@ var init_linked_todos = __esm({
 
 // src/lifecycle/transitions.ts
 import { resolve as resolve10 } from "path";
-import { readFile as readFile6 } from "fs/promises";
+import { readFile as readFile7 } from "fs/promises";
 function linkedAssignmentRef(frontmatter) {
   return frontmatter.project ? `${frontmatter.project}/${frontmatter.slug}` : frontmatter.id;
 }
@@ -4251,7 +4305,7 @@ async function readAssignment(filePath) {
   if (!await fileExists(filePath)) {
     throw new Error(`Assignment file not found: ${filePath}`);
   }
-  const content = await readFile6(filePath, "utf-8");
+  const content = await readFile7(filePath, "utf-8");
   const frontmatter = parseAssignmentFrontmatter(content);
   return { content, frontmatter };
 }
@@ -4264,7 +4318,7 @@ async function checkDependencies(projectDir, dependsOn, terminalStatuses3) {
       unmet.push(`${depSlug} (file not found)`);
       continue;
     }
-    const depContent = await readFile6(depPath, "utf-8");
+    const depContent = await readFile7(depPath, "utf-8");
     const depFrontmatter = parseAssignmentFrontmatter(depContent);
     if (!terminals.has(depFrontmatter.status)) {
       unmet.push(`${depSlug} (status: ${depFrontmatter.status})`);
@@ -4417,7 +4471,7 @@ var init_lifecycle = __esm({
 
 // src/utils/assignment-resolver.ts
 import { resolve as resolve11 } from "path";
-import { readdir as readdir5, readFile as readFile7 } from "fs/promises";
+import { readdir as readdir5, readFile as readFile8 } from "fs/promises";
 async function resolveAssignmentById(projectsDir2, assignmentsDir2, id) {
   let standaloneMatch = null;
   let projectMatch = null;
@@ -4426,7 +4480,7 @@ async function resolveAssignmentById(projectsDir2, assignmentsDir2, id) {
   if (await fileExists(standalonePath)) {
     let workspaceGroup = null;
     try {
-      const content = await readFile7(standalonePath, "utf-8");
+      const content = await readFile8(standalonePath, "utf-8");
       const [fm] = extractFrontmatter(content);
       workspaceGroup = getField(fm, "workspaceGroup");
     } catch {
@@ -4454,7 +4508,7 @@ async function resolveAssignmentById(projectsDir2, assignmentsDir2, id) {
           const aPath = resolve11(assignmentsPath, a.name, "assignment.md");
           if (!await fileExists(aPath)) continue;
           try {
-            const content = await readFile7(aPath, "utf-8");
+            const content = await readFile8(aPath, "utf-8");
             const [fm] = extractFrontmatter(content);
             const fileId = getField(fm, "id");
             if (fileId === id) {
@@ -5106,8 +5160,8 @@ async function migrateFromMarkdown(projectsDir2) {
   return allSessions.length;
 }
 async function parseMarkdownSessionsIndex(filePath, projectSlug) {
-  const { readFile: readFile54 } = await import("fs/promises");
-  const raw = await readFile54(filePath, "utf-8");
+  const { readFile: readFile56 } = await import("fs/promises");
+  const raw = await readFile56(filePath, "utf-8");
   const sessions = [];
   const lines = raw.split("\n");
   let inTable = false;
@@ -5177,7 +5231,7 @@ CREATE INDEX IF NOT EXISTS idx_sessions_assignment ON sessions(project_slug, ass
 });
 
 // src/dashboard/agent-sessions.ts
-import { readFile as readFile8 } from "fs/promises";
+import { readFile as readFile9 } from "fs/promises";
 import { resolve as resolve13 } from "path";
 function rowToSession(row) {
   return {
@@ -5265,7 +5319,7 @@ async function deleteSessions(sessionIds) {
 }
 async function readAssignmentStatusFromPath(assignmentMdPath2) {
   if (!await fileExists(assignmentMdPath2)) return null;
-  const raw = await readFile8(assignmentMdPath2, "utf-8");
+  const raw = await readFile9(assignmentMdPath2, "utf-8");
   const match = raw.match(/^status:\s*(.+)$/m);
   return match ? match[1].trim() : null;
 }
@@ -5350,7 +5404,7 @@ var init_overviewCopy = __esm({
 });
 
 // src/dashboard/servers.ts
-import { readdir as readdir7, readFile as readFile9, unlink as unlink2 } from "fs/promises";
+import { readdir as readdir7, readFile as readFile10, unlink as unlink2 } from "fs/promises";
 import { resolve as resolve14 } from "path";
 function sanitizeSessionName(name) {
   return name.replace(/[^a-zA-Z0-9_-]/g, "-");
@@ -5410,7 +5464,7 @@ async function listSessionFiles(dir) {
 async function readSessionFile(dir, name) {
   const filePath = resolve14(dir, `${sanitizeSessionName(name)}.md`);
   if (!await fileExists(filePath)) return null;
-  const raw = await readFile9(filePath, "utf-8");
+  const raw = await readFile10(filePath, "utf-8");
   const [frontmatter] = extractFrontmatter(raw);
   if (!frontmatter) return null;
   const session = getField(frontmatter, "session") ?? name;
@@ -5539,8 +5593,8 @@ function scanKey(serversDir2, projectsDir2, assignmentsDir2) {
   return `${serversDir2}\0${projectsDir2}\0${assignmentsDir2 ?? ""}`;
 }
 function delay(ms) {
-  return new Promise((resolve79) => {
-    const timer2 = setTimeout(resolve79, ms);
+  return new Promise((resolve82) => {
+    const timer2 = setTimeout(resolve82, ms);
     if (typeof timer2.unref === "function") {
       timer2.unref();
     }
@@ -5983,7 +6037,7 @@ var init_scanner = __esm({
 });
 
 // src/dashboard/api.ts
-import { readdir as readdir8, readFile as readFile10, writeFile as writeFile3 } from "fs/promises";
+import { readdir as readdir8, readFile as readFile11, writeFile as writeFile3 } from "fs/promises";
 import { resolve as resolve16, dirname as dirname3, basename } from "path";
 function clearFrontmatterField(content, key) {
   const fieldRegex = new RegExp(`^(${escapeRegExp2(key)}:)\\s*.*$`, "m");
@@ -6071,7 +6125,7 @@ async function computeStandaloneRecords(assignmentsDir2) {
     const assignmentMdPath2 = resolve16(assignmentDir, "assignment.md");
     if (!await fileExists(assignmentMdPath2)) continue;
     try {
-      const content = await readFile10(assignmentMdPath2, "utf-8");
+      const content = await readFile11(assignmentMdPath2, "utf-8");
       const record = parseAssignmentFull(content);
       records.push({ assignmentDir, id: entry.name, record });
     } catch {
@@ -6147,7 +6201,7 @@ async function listProjects(projectsDir2) {
 async function readWorkspaceRegistry(projectsDir2) {
   const registryPath = resolve16(dirname3(projectsDir2), "workspaces.json");
   try {
-    const raw = await readFile10(registryPath, "utf-8");
+    const raw = await readFile11(registryPath, "utf-8");
     const parsed = JSON.parse(raw);
     return Array.isArray(parsed) ? parsed.filter((w) => typeof w === "string") : [];
   } catch {
@@ -6236,7 +6290,7 @@ async function deleteWorkspace(projectsDir2, name, opts = {}) {
     const timestamp = nowTimestamp();
     for (const slug of projectsReferencing) {
       const path = resolve16(projectsDir2, slug, "project.md");
-      const raw = await readFile10(path, "utf-8");
+      const raw = await readFile11(path, "utf-8");
       let next = clearFrontmatterField(raw, "workspace");
       next = setUpdatedField(next, timestamp);
       await writeFileForce(path, next);
@@ -6245,7 +6299,7 @@ async function deleteWorkspace(projectsDir2, name, opts = {}) {
     for (const id of standalonesReferencing) {
       if (!opts.assignmentsDir) break;
       const path = resolve16(opts.assignmentsDir, id, "assignment.md");
-      const raw = await readFile10(path, "utf-8");
+      const raw = await readFile11(path, "utf-8");
       let next = clearFrontmatterField(raw, "workspaceGroup");
       next = setUpdatedField(next, timestamp);
       await writeFileForce(path, next);
@@ -6482,7 +6536,7 @@ async function getEditableDocument(projectsDir2, documentType, projectSlug, assi
   if (!filePath || !await fileExists(filePath)) {
     return null;
   }
-  const content = await readFile10(filePath, "utf-8");
+  const content = await readFile11(filePath, "utf-8");
   const title = getEditableDocumentTitle(documentType, projectSlug, assignmentSlug);
   return {
     documentType,
@@ -6508,7 +6562,7 @@ async function getEditableDocumentById(projectsDir2, assignmentsDir2, documentTy
   if (!fileName) return null;
   const filePath = resolve16(resolved.assignmentDir, fileName);
   if (!await fileExists(filePath)) return null;
-  const content = await readFile10(filePath, "utf-8");
+  const content = await readFile11(filePath, "utf-8");
   const label = resolved.id;
   const title = documentType === "assignment" ? `Edit Assignment: ${label}` : documentType === "plan" ? `Edit Plan: ${label}` : documentType === "scratchpad" ? `Edit Scratchpad: ${label}` : documentType === "handoff" ? `Append Handoff: ${label}` : `Append Decision: ${label}`;
   return {
@@ -6527,7 +6581,7 @@ async function getProjectDetail(projectsDir2, slug) {
   if (!await fileExists(projectMdPath)) {
     return null;
   }
-  const projectContent = await readFile10(projectMdPath, "utf-8");
+  const projectContent = await readFile11(projectMdPath, "utf-8");
   const project = parseProject(projectContent);
   const assignments = await listAssignmentRecords(projectPath);
   const rollup = await buildProjectRollup(projectPath, project, assignments);
@@ -6564,18 +6618,18 @@ async function getAssignmentDetail(projectsDir2, projectSlug, assignmentSlug) {
   if (!await fileExists(assignmentMdPath2)) {
     return null;
   }
-  const assignmentContent = await readFile10(assignmentMdPath2, "utf-8");
+  const assignmentContent = await readFile11(assignmentMdPath2, "utf-8");
   const assignment = parseAssignmentFull(assignmentContent);
   let projectWorkspace = null;
   const projectMdPath = resolve16(projectsDir2, projectSlug, "project.md");
   if (await fileExists(projectMdPath)) {
-    const projectContent = await readFile10(projectMdPath, "utf-8");
+    const projectContent = await readFile11(projectMdPath, "utf-8");
     projectWorkspace = parseProject(projectContent).workspace;
   }
   let plan = null;
   const planPath = resolve16(assignmentDir, "plan.md");
   if (await fileExists(planPath)) {
-    const planContent = await readFile10(planPath, "utf-8");
+    const planContent = await readFile11(planPath, "utf-8");
     const parsed = parsePlan(planContent);
     plan = {
       status: parsed.status,
@@ -6586,7 +6640,7 @@ async function getAssignmentDetail(projectsDir2, projectSlug, assignmentSlug) {
   let scratchpad = null;
   const scratchpadPath = resolve16(assignmentDir, "scratchpad.md");
   if (await fileExists(scratchpadPath)) {
-    const scratchpadContent = await readFile10(scratchpadPath, "utf-8");
+    const scratchpadContent = await readFile11(scratchpadPath, "utf-8");
     const parsed = parseScratchpad(scratchpadContent);
     scratchpad = {
       updated: parsed.updated,
@@ -6596,7 +6650,7 @@ async function getAssignmentDetail(projectsDir2, projectSlug, assignmentSlug) {
   let handoff = null;
   const handoffPath = resolve16(assignmentDir, "handoff.md");
   if (await fileExists(handoffPath)) {
-    const handoffContent = await readFile10(handoffPath, "utf-8");
+    const handoffContent = await readFile11(handoffPath, "utf-8");
     const parsed = parseHandoff(handoffContent);
     handoff = {
       updated: parsed.updated,
@@ -6607,7 +6661,7 @@ async function getAssignmentDetail(projectsDir2, projectSlug, assignmentSlug) {
   let decisionRecord = null;
   const decisionRecordPath = resolve16(assignmentDir, "decision-record.md");
   if (await fileExists(decisionRecordPath)) {
-    const decisionRecordContent = await readFile10(decisionRecordPath, "utf-8");
+    const decisionRecordContent = await readFile11(decisionRecordPath, "utf-8");
     const parsed = parseDecisionRecord(decisionRecordContent);
     decisionRecord = {
       updated: parsed.updated,
@@ -6618,7 +6672,7 @@ async function getAssignmentDetail(projectsDir2, projectSlug, assignmentSlug) {
   let progress = null;
   const progressPath = resolve16(assignmentDir, "progress.md");
   if (await fileExists(progressPath)) {
-    const progressContent = await readFile10(progressPath, "utf-8");
+    const progressContent = await readFile11(progressPath, "utf-8");
     const parsed = parseProgress(progressContent);
     progress = {
       updated: parsed.updated,
@@ -6629,7 +6683,7 @@ async function getAssignmentDetail(projectsDir2, projectSlug, assignmentSlug) {
   let comments = null;
   const commentsPath = resolve16(assignmentDir, "comments.md");
   if (await fileExists(commentsPath)) {
-    const commentsContent = await readFile10(commentsPath, "utf-8");
+    const commentsContent = await readFile11(commentsPath, "utf-8");
     const parsed = parseComments(commentsContent);
     comments = {
       updated: parsed.updated,
@@ -6783,7 +6837,7 @@ async function countMentionsInAssignment(sourceDir, target) {
   const bodies = [];
   const assignmentMd = resolve16(sourceDir, "assignment.md");
   if (await fileExists(assignmentMd)) {
-    const content = await readFile10(assignmentMd, "utf-8");
+    const content = await readFile11(assignmentMd, "utf-8");
     const todosMatch = content.match(/^## Todos\s*$([\s\S]*?)(?=^## |$(?![\r\n]))/m);
     if (todosMatch) bodies.push(todosMatch[1]);
   }
@@ -6791,7 +6845,7 @@ async function countMentionsInAssignment(sourceDir, target) {
     const path = resolve16(sourceDir, filename);
     if (await fileExists(path)) {
       try {
-        bodies.push(await readFile10(path, "utf-8"));
+        bodies.push(await readFile11(path, "utf-8"));
       } catch {
       }
     }
@@ -6851,42 +6905,42 @@ async function buildStandaloneAssignmentDetail(resolved) {
   const assignmentDir = resolved.assignmentDir;
   const assignmentMdPath2 = resolve16(assignmentDir, "assignment.md");
   if (!await fileExists(assignmentMdPath2)) return null;
-  const assignmentContent = await readFile10(assignmentMdPath2, "utf-8");
+  const assignmentContent = await readFile11(assignmentMdPath2, "utf-8");
   const assignment = parseAssignmentFull(assignmentContent);
   let plan = null;
   const planPath = resolve16(assignmentDir, "plan.md");
   if (await fileExists(planPath)) {
-    const parsed = parsePlan(await readFile10(planPath, "utf-8"));
+    const parsed = parsePlan(await readFile11(planPath, "utf-8"));
     plan = { status: parsed.status, updated: parsed.updated, body: parsed.body };
   }
   let scratchpad = null;
   const scratchpadPath = resolve16(assignmentDir, "scratchpad.md");
   if (await fileExists(scratchpadPath)) {
-    const parsed = parseScratchpad(await readFile10(scratchpadPath, "utf-8"));
+    const parsed = parseScratchpad(await readFile11(scratchpadPath, "utf-8"));
     scratchpad = { updated: parsed.updated, body: parsed.body };
   }
   let handoff = null;
   const handoffPath = resolve16(assignmentDir, "handoff.md");
   if (await fileExists(handoffPath)) {
-    const parsed = parseHandoff(await readFile10(handoffPath, "utf-8"));
+    const parsed = parseHandoff(await readFile11(handoffPath, "utf-8"));
     handoff = { updated: parsed.updated, handoffCount: parsed.handoffCount, body: parsed.body };
   }
   let decisionRecord = null;
   const decisionRecordPath = resolve16(assignmentDir, "decision-record.md");
   if (await fileExists(decisionRecordPath)) {
-    const parsed = parseDecisionRecord(await readFile10(decisionRecordPath, "utf-8"));
+    const parsed = parseDecisionRecord(await readFile11(decisionRecordPath, "utf-8"));
     decisionRecord = { updated: parsed.updated, decisionCount: parsed.decisionCount, body: parsed.body };
   }
   let progress = null;
   const progressPath = resolve16(assignmentDir, "progress.md");
   if (await fileExists(progressPath)) {
-    const parsed = parseProgress(await readFile10(progressPath, "utf-8"));
+    const parsed = parseProgress(await readFile11(progressPath, "utf-8"));
     progress = { updated: parsed.updated, entryCount: parsed.entryCount, entries: parsed.entries };
   }
   let comments = null;
   const commentsPath = resolve16(assignmentDir, "comments.md");
   if (await fileExists(commentsPath)) {
-    const parsed = parseComments(await readFile10(commentsPath, "utf-8"));
+    const parsed = parseComments(await readFile11(commentsPath, "utf-8"));
     comments = { updated: parsed.updated, entryCount: parsed.entryCount, entries: parsed.entries };
   }
   const detail = {
@@ -6952,7 +7006,7 @@ async function computeProjectRecords(projectsDir2, traces) {
         return null;
       }
       const t0 = traces ? performance.now() : 0;
-      const projectContent = await readFile10(projectMdPath, "utf-8");
+      const projectContent = await readFile11(projectMdPath, "utf-8");
       const project = parseProject(projectContent);
       if (traces) accumulatePhase(traces, "parse-project-md", performance.now() - t0);
       const t1 = traces ? performance.now() : 0;
@@ -7006,7 +7060,7 @@ async function listAssignmentRecords(projectPath, traces) {
         return null;
       }
       const t0 = traces ? performance.now() : 0;
-      const content = await readFile10(assignmentMd, "utf-8");
+      const content = await readFile11(assignmentMd, "utf-8");
       const parsed = parseAssignmentFull(content);
       if (traces) accumulatePhase(traces, "read-assignment-md", performance.now() - t0);
       return parsed;
@@ -7028,7 +7082,7 @@ async function listResources(projectPath) {
       continue;
     }
     const filePath = resolve16(resourcesDir, entry.name);
-    const content = await readFile10(filePath, "utf-8");
+    const content = await readFile11(filePath, "utf-8");
     const parsed = parseResource(content);
     results.push({
       name: parsed.name,
@@ -7054,7 +7108,7 @@ async function listMemories(projectPath) {
       continue;
     }
     const filePath = resolve16(memoriesDir, entry.name);
-    const content = await readFile10(filePath, "utf-8");
+    const content = await readFile11(filePath, "utf-8");
     const parsed = parseMemory(content);
     results.push({
       name: parsed.name,
@@ -7117,7 +7171,7 @@ async function getMemoryDetail(projectsDir2, projectSlug, itemSlug) {
   if (!projectRecord) return null;
   const filePath = resolve16(projectRecord.projectPath, "memories", `${itemSlug}.md`);
   if (!await fileExists(filePath)) return null;
-  const content = await readFile10(filePath, "utf-8");
+  const content = await readFile11(filePath, "utf-8");
   const parsed = parseMemory(content);
   return {
     name: parsed.name,
@@ -7143,7 +7197,7 @@ async function getResourceDetail(projectsDir2, projectSlug, itemSlug) {
   if (!projectRecord) return null;
   const filePath = resolve16(projectRecord.projectPath, "resources", `${itemSlug}.md`);
   if (!await fileExists(filePath)) return null;
-  const content = await readFile10(filePath, "utf-8");
+  const content = await readFile11(filePath, "utf-8");
   const parsed = parseResource(content);
   return {
     name: parsed.name,
@@ -7161,7 +7215,7 @@ async function getResourceDetail(projectsDir2, projectSlug, itemSlug) {
 async function loadDependencyGraph(projectPath, assignments) {
   const statusPath = resolve16(projectPath, "_status.md");
   if (await fileExists(statusPath)) {
-    const statusContent = await readFile10(statusPath, "utf-8");
+    const statusContent = await readFile11(statusPath, "utf-8");
     const parsed = parseStatus(statusContent);
     const derivedGraph = extractMermaidGraph(parsed.body);
     if (derivedGraph) {
@@ -7328,7 +7382,7 @@ async function getUnmetDependencies(projectPath, dependsOn, terminalStatuses3, d
       unmet.push(`${dependency} (missing)`);
       continue;
     }
-    const content = await readFile10(dependencyPath, "utf-8");
+    const content = await readFile11(dependencyPath, "utf-8");
     const parsed = parseAssignmentFull(content);
     if (!terminals.has(parsed.status)) {
       unmet.push(`${dependency} (${parsed.status})`);
@@ -7623,7 +7677,7 @@ async function countOpenQuestions(projectPath, assignmentSlug) {
     return 0;
   }
   try {
-    const content = await readFile10(commentsPath, "utf-8");
+    const content = await readFile11(commentsPath, "utf-8");
     const parsed = parseComments(content);
     return parsed.entries.filter(
       (e) => e.type === "question" && e.resolved !== true
@@ -7696,7 +7750,7 @@ async function listPlaybooks(playbooksDir3) {
   for (const entry of entries) {
     if (!entry.isFile() || !entry.name.endsWith(".md") || entry.name.startsWith("_") || entry.name === "manifest.md") continue;
     const filePath = resolve16(playbooksDir3, entry.name);
-    const raw = await readFile10(filePath, "utf-8");
+    const raw = await readFile11(filePath, "utf-8");
     const parsed = parsePlaybook(raw);
     const slug = parsed.slug || entry.name.replace(/\.md$/, "");
     playbooks.push({
@@ -7881,7 +7935,7 @@ __export(git_worktree_exports, {
   removeWorktree: () => removeWorktree
 });
 import { spawn } from "child_process";
-import { readFile as readFile13 } from "fs/promises";
+import { readFile as readFile14 } from "fs/promises";
 function run(command, args, cwd) {
   return new Promise((resolvePromise) => {
     const child = spawn(command, args, { cwd, stdio: ["ignore", "pipe", "pipe"] });
@@ -7959,7 +8013,7 @@ async function createWorktreeAndRecord(opts) {
   const { assignmentPath, repository, branch, worktreePath, parentBranch } = opts;
   await createWorktree({ repository, branch, worktreePath, parentBranch });
   try {
-    const content = await readFile13(assignmentPath, "utf-8");
+    const content = await readFile14(assignmentPath, "utf-8");
     const updated = updateAssignmentWorkspace(content, {
       repository,
       worktreePath,
@@ -8428,15 +8482,15 @@ import {
   unlinkSync
 } from "fs";
 import { fileURLToPath as fileURLToPath9, pathToFileURL } from "url";
-import { dirname as dirname16, resolve as resolve47, join as join9 } from "path";
-import { homedir as homedir8, tmpdir as tmpdir2 } from "os";
-import { spawnSync as spawnSync6 } from "child_process";
+import { dirname as dirname16, resolve as resolve49, join as join9 } from "path";
+import { homedir as homedir9, tmpdir as tmpdir2 } from "os";
+import { spawnSync as spawnSync7 } from "child_process";
 function syntaurRootMjs() {
   const override = process.env.SYNTAUR_HOME;
   if (override && override.length > 0) {
     return override;
   }
-  return join9(homedir8(), ".syntaur");
+  return join9(homedir9(), ".syntaur");
 }
 async function registerMacosUrlHandler(options = { throwOnFailure: false }) {
   const { throwOnFailure } = options;
@@ -8450,7 +8504,7 @@ async function registerMacosUrlHandler(options = { throwOnFailure: false }) {
   }
   const stateRoot = syntaurRootMjs();
   mkdirSync2(stateRoot, { recursive: true });
-  const lockPath = resolve47(stateRoot, "install-url-handler.lock");
+  const lockPath = resolve49(stateRoot, "install-url-handler.lock");
   let lockFd;
   try {
     lockFd = openSync(lockPath, "wx");
@@ -8466,11 +8520,11 @@ async function registerMacosUrlHandler(options = { throwOnFailure: false }) {
     throw err2;
   }
   try {
-    const pkgRoot = resolve47(dirname16(fileURLToPath9(import.meta.url)), "..");
-    const cliBin = realpathSync3(resolve47(pkgRoot, "bin/syntaur.js"));
+    const pkgRoot = resolve49(dirname16(fileURLToPath9(import.meta.url)), "..");
+    const cliBin = realpathSync3(resolve49(pkgRoot, "bin/syntaur.js"));
     const nodeBin = process.execPath;
     const bundleParent = join9(
-      homedir8(),
+      homedir9(),
       "Library",
       "Application Support",
       "Syntaur"
@@ -8490,7 +8544,7 @@ async function registerMacosUrlHandler(options = { throwOnFailure: false }) {
       renderAppleScript({ nodeBin, cliBin, installedTerminals }),
       "utf-8"
     );
-    const compile = spawnSync6(
+    const compile = spawnSync7(
       OSACOMPILE,
       ["-o", bundlePath, scriptPath],
       { stdio: "pipe", encoding: "utf-8" }
@@ -8534,7 +8588,7 @@ async function registerMacosUrlHandler(options = { throwOnFailure: false }) {
       ["Add :CFBundleURLTypes:0:CFBundleURLSchemes array", null],
       [`Add :CFBundleURLTypes:0:CFBundleURLSchemes:0 string ${URL_SCHEME}`, null]
     ]);
-    const sign = spawnSync6(
+    const sign = spawnSync7(
       "/usr/bin/codesign",
       ["--force", "--deep", "--sign", "-", bundlePath],
       { stdio: "pipe", encoding: "utf-8" }
@@ -8546,7 +8600,7 @@ async function registerMacosUrlHandler(options = { throwOnFailure: false }) {
       }
       console.warn(`syntaur: ${msg} \u2014 macOS may deny Automation permission.`);
     }
-    const ls = spawnSync6(LSREGISTER, ["-f", bundlePath], {
+    const ls = spawnSync7(LSREGISTER, ["-f", bundlePath], {
       stdio: "pipe",
       encoding: "utf-8"
     });
@@ -8595,9 +8649,9 @@ function detectInstalledTerminals() {
     ghostty: "Ghostty.app",
     warp: "Warp.app"
   };
-  const appDirs = ["/Applications", join9(homedir8(), "Applications")];
+  const appDirs = ["/Applications", join9(homedir9(), "Applications")];
   for (const [id, bundleId] of Object.entries(bundleIds)) {
-    const r = spawnSync6(
+    const r = spawnSync7(
       "mdfind",
       [`kMDItemCFBundleIdentifier == '${bundleId}'`],
       { encoding: "utf-8" }
@@ -8757,13 +8811,13 @@ function runPlistBuddy(plistPath, steps) {
   for (const step of steps) {
     if (Array.isArray(step)) {
       const [primary, fallback] = step;
-      const a = spawnSync6("/usr/libexec/PlistBuddy", ["-c", primary, plistPath], {
+      const a = spawnSync7("/usr/libexec/PlistBuddy", ["-c", primary, plistPath], {
         stdio: "pipe",
         encoding: "utf-8"
       });
       if (a.status === 0) continue;
       if (fallback === null) continue;
-      const b = spawnSync6("/usr/libexec/PlistBuddy", ["-c", fallback, plistPath], {
+      const b = spawnSync7("/usr/libexec/PlistBuddy", ["-c", fallback, plistPath], {
         stdio: "pipe",
         encoding: "utf-8"
       });
@@ -8773,7 +8827,7 @@ function runPlistBuddy(plistPath, steps) {
         );
       }
     } else {
-      const r = spawnSync6("/usr/libexec/PlistBuddy", ["-c", step, plistPath], {
+      const r = spawnSync7("/usr/libexec/PlistBuddy", ["-c", step, plistPath], {
         stdio: "pipe",
         encoding: "utf-8"
       });
@@ -9317,7 +9371,7 @@ init_fs();
 init_config();
 init_playbooks();
 import { resolve as resolve5, dirname as dirname2 } from "path";
-import { readdir as readdir3, readFile as readFile4 } from "fs/promises";
+import { readdir as readdir3, readFile as readFile5 } from "fs/promises";
 import { fileURLToPath } from "url";
 async function initCommand(options) {
   const root = syntaurRoot();
@@ -9369,7 +9423,7 @@ async function seedDefaultPlaybooks(playbooksDir3) {
     if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
     const targetPath = resolve5(playbooksDir3, entry.name);
     if (await fileExists(targetPath)) continue;
-    const content = await readFile4(resolve5(examplesDir, entry.name), "utf-8");
+    const content = await readFile5(resolve5(examplesDir, entry.name), "utf-8");
     await writeFileSafe(targetPath, content);
     count++;
   }
@@ -9931,7 +9985,7 @@ function mergePatch(current, patch) {
 // src/utils/view-prefs.ts
 init_paths();
 init_fs();
-import { readFile as readFile11, rename as rename3, unlink as unlink3 } from "fs/promises";
+import { readFile as readFile12, rename as rename3, unlink as unlink3 } from "fs/promises";
 import { resolve as resolve17 } from "path";
 function corruptFilePath() {
   const ts = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
@@ -9954,7 +10008,7 @@ async function readViewPrefsFile() {
   }
   let raw;
   try {
-    raw = await readFile11(path, "utf-8");
+    raw = await readFile12(path, "utf-8");
   } catch {
     return { ...DEFAULT_VIEW_PREFS_FILE };
   }
@@ -10137,7 +10191,7 @@ function isDashboardSlot(value) {
 // src/utils/saved-views.ts
 init_paths();
 init_fs();
-import { readFile as readFile12, rename as rename4, unlink as unlink4 } from "fs/promises";
+import { readFile as readFile13, rename as rename4, unlink as unlink4 } from "fs/promises";
 import { randomUUID as randomUUID2 } from "crypto";
 import { resolve as resolve18 } from "path";
 function corruptFilePath2() {
@@ -10167,7 +10221,7 @@ async function readSavedViewsFile() {
   }
   let raw;
   try {
-    raw = await readFile12(path, "utf-8");
+    raw = await readFile13(path, "utf-8");
   } catch {
     return cloneDefault();
   }
@@ -10487,7 +10541,7 @@ init_fs();
 init_git_worktree();
 import { Router as Router2 } from "express";
 import { resolve as resolve21, basename as basename3, isAbsolute as isAbsolute2 } from "path";
-import { rm, readFile as readFile15, open as fsOpen, stat as fsStat, realpath as fsRealpath } from "fs/promises";
+import { rm, readFile as readFile16, open as fsOpen, stat as fsStat, realpath as fsRealpath } from "fs/promises";
 import { spawnSync as spawnSync3 } from "child_process";
 
 // src/utils/worktree-defaults.ts
@@ -10563,7 +10617,7 @@ function validateBranchName(name) {
 // src/dashboard/repository-candidates.ts
 init_fs();
 init_parser();
-import { readdir as readdir9, readFile as readFile14 } from "fs/promises";
+import { readdir as readdir9, readFile as readFile15 } from "fs/promises";
 import { resolve as resolve20 } from "path";
 function toSourceAssignment(parsed, fallbackId) {
   const repository = parsed.workspace.repository?.trim();
@@ -10583,7 +10637,7 @@ async function getProjectRepositoryCandidates(projectsDir2, projectSlug) {
   const out = [];
   const projectPath = resolve20(projectsDir2, projectSlug, "project.md");
   if (await fileExists(projectPath)) {
-    const project = parseProject(await readFile14(projectPath, "utf-8"));
+    const project = parseProject(await readFile15(projectPath, "utf-8"));
     for (const raw of project.repositories) {
       const path = raw.trim();
       if (!path) continue;
@@ -10600,7 +10654,7 @@ async function getProjectRepositoryCandidates(projectsDir2, projectSlug) {
       if (!entry.isDirectory()) continue;
       const assignmentMd = resolve20(assignmentsDir2, entry.name, "assignment.md");
       if (!await fileExists(assignmentMd)) continue;
-      const parsed = parseAssignmentFull(await readFile14(assignmentMd, "utf-8"));
+      const parsed = parseAssignmentFull(await readFile15(assignmentMd, "utf-8"));
       const repo = parsed.workspace.repository?.trim();
       if (!repo) continue;
       const abs = resolve20(repo);
@@ -10623,7 +10677,7 @@ async function getStandaloneRepositoryCandidates(assignmentsDir2, excludeAssignm
     if (entry.name === excludeAssignmentId) continue;
     const assignmentMd = resolve20(assignmentsDir2, entry.name, "assignment.md");
     if (!await fileExists(assignmentMd)) continue;
-    const parsed = parseAssignmentFull(await readFile14(assignmentMd, "utf-8"));
+    const parsed = parseAssignmentFull(await readFile15(assignmentMd, "utf-8"));
     const repo = parsed.workspace.repository?.trim();
     if (!repo) continue;
     const abs = resolve20(repo);
@@ -10644,7 +10698,7 @@ async function getProjectSourceAssignments(projectsDir2, projectSlug, excludeSlu
     if (entry.name === excludeSlug) continue;
     const assignmentMd = resolve20(assignmentsDir2, entry.name, "assignment.md");
     if (!await fileExists(assignmentMd)) continue;
-    const parsed = parseAssignmentFull(await readFile14(assignmentMd, "utf-8"));
+    const parsed = parseAssignmentFull(await readFile15(assignmentMd, "utf-8"));
     const source = toSourceAssignment(parsed, entry.name);
     if (!source) continue;
     if (seen.has(entry.name)) continue;
@@ -10663,7 +10717,7 @@ async function getStandaloneSourceAssignments(assignmentsDir2, excludeAssignment
     if (entry.name === excludeAssignmentId) continue;
     const assignmentMd = resolve20(assignmentsDir2, entry.name, "assignment.md");
     if (!await fileExists(assignmentMd)) continue;
-    const parsed = parseAssignmentFull(await readFile14(assignmentMd, "utf-8"));
+    const parsed = parseAssignmentFull(await readFile15(assignmentMd, "utf-8"));
     const source = toSourceAssignment(parsed, entry.name);
     if (!source) continue;
     if (seen.has(entry.name)) continue;
@@ -10834,7 +10888,7 @@ async function readCurrentDocument(filePath) {
   if (!await fileExists(filePath)) {
     return null;
   }
-  return readFile15(filePath, "utf-8");
+  return readFile16(filePath, "utf-8");
 }
 var worktreeInFlight = /* @__PURE__ */ new Set();
 async function assertRepoRoot(repoInput) {
@@ -10888,7 +10942,7 @@ async function handleWorktreeCreate(req, res, ctx) {
   }
   worktreeInFlight.add(ctx.assignmentPath);
   try {
-    const parsed = parseAssignmentFull(await readFile15(ctx.assignmentPath, "utf-8"));
+    const parsed = parseAssignmentFull(await readFile16(ctx.assignmentPath, "utf-8"));
     if (parsed.workspace.worktreePath) {
       res.status(409).json({ error: "Worktree already configured for this assignment" });
       return;
@@ -11258,7 +11312,7 @@ ${body.startsWith("\n") ? body.slice(1) : body}${body.endsWith("\n") ? "" : "\n"
         }
         const nextContentRaw = requireContent(req, res);
         if (!nextContentRaw) return;
-        const currentContent = await readFile15(filePath, "utf-8");
+        const currentContent = await readFile16(filePath, "utf-8");
         const frontmatterBlock = extractFrontmatterBlock(currentContent);
         if (!frontmatterBlock) {
           res.status(500).json({ error: `${kind} file is malformed (no frontmatter)` });
@@ -11709,7 +11763,7 @@ ${nextBody}${nextBody.endsWith("\n") ? "" : "\n"}`;
       let currentContent;
       let currentCount = 0;
       if (await fileExists(commentsPath)) {
-        currentContent = await readFile15(commentsPath, "utf-8");
+        currentContent = await readFile16(commentsPath, "utf-8");
         const countMatch = currentContent.match(/^entryCount:\s*(\d+)/m);
         if (countMatch) currentCount = parseInt(countMatch[1], 10);
       } else {
@@ -11766,7 +11820,7 @@ ${entry}`;
         res.status(400).json({ error: "resolved (boolean) is required" });
         return;
       }
-      const content = await readFile15(commentsPath, "utf-8");
+      const content = await readFile16(commentsPath, "utf-8");
       const parsed = parseComments(content);
       const target = parsed.entries.find((e) => e.id === commentId);
       if (!target) {
@@ -11813,7 +11867,7 @@ ${entry}`;
         });
         return;
       }
-      let content = await readFile15(projectPath, "utf-8");
+      let content = await readFile16(projectPath, "utf-8");
       content = setTopLevelField(content, "workspace", workspace ?? null);
       content = setTopLevelField(content, "updated", nowTimestamp());
       await writeFileForce(projectPath, content);
@@ -11850,7 +11904,7 @@ ${entry}`;
         return;
       }
       const assignmentPath = resolve21(resolved.assignmentDir, "assignment.md");
-      let content = await readFile15(assignmentPath, "utf-8");
+      let content = await readFile16(assignmentPath, "utf-8");
       content = setTopLevelField(content, "workspaceGroup", workspaceGroup ?? null);
       content = setTopLevelField(content, "updated", nowTimestamp());
       await writeFileForce(assignmentPath, content);
@@ -12067,7 +12121,7 @@ ${entry}`;
           return;
         }
         const assignmentPath = resolve21(resolved.assignmentDir, "assignment.md");
-        const parsedForSlug = parseAssignmentFull(await readFile15(assignmentPath, "utf-8"));
+        const parsedForSlug = parseAssignmentFull(await readFile16(assignmentPath, "utf-8"));
         const assignmentSlugForBranch = parsedForSlug.slug || resolved.id;
         await handleWorktreeCreate(req, res, {
           assignmentPath,
@@ -12096,7 +12150,7 @@ ${entry}`;
         res.status(400).json({ error: `Invalid status. Must be one of: ${validStatuses.join(", ")}, or null to clear.` });
         return;
       }
-      let content = await readFile15(projectPath, "utf-8");
+      let content = await readFile16(projectPath, "utf-8");
       content = setTopLevelField(content, "statusOverride", status ?? null);
       content = setTopLevelField(content, "updated", nowTimestamp());
       await writeFileForce(projectPath, content);
@@ -12129,7 +12183,7 @@ ${entry}`;
         res.status(400).json({ error: `Invalid status. Must be one of: ${validStatuses.join(", ")}.` });
         return;
       }
-      let content = await readFile15(assignmentPath, "utf-8");
+      let content = await readFile16(assignmentPath, "utf-8");
       content = setTopLevelField(content, "status", status);
       content = setTopLevelField(content, "updated", nowTimestamp());
       if (status !== "blocked") {
@@ -12155,7 +12209,7 @@ ${entry}`;
         res.status(404).json({ error: `Project "${projectSlug}" not found` });
         return;
       }
-      const content = await readFile15(projectPath, "utf-8");
+      const content = await readFile16(projectPath, "utf-8");
       await writeFileForce(projectPath, applyArchiveFields(content, true, archiveReason(req.body)));
       const project = await getProjectDetail(projectsDir2, projectSlug);
       res.json({ project });
@@ -12172,7 +12226,7 @@ ${entry}`;
         res.status(404).json({ error: `Project "${projectSlug}" not found` });
         return;
       }
-      const content = await readFile15(projectPath, "utf-8");
+      const content = await readFile16(projectPath, "utf-8");
       await writeFileForce(projectPath, applyArchiveFields(content, false, null));
       const project = await getProjectDetail(projectsDir2, projectSlug);
       res.json({ project });
@@ -12189,7 +12243,7 @@ ${entry}`;
       res.status(404).json({ error: "Assignment not found" });
       return;
     }
-    const content = await readFile15(assignmentPath, "utf-8");
+    const content = await readFile16(assignmentPath, "utf-8");
     await writeFileForce(assignmentPath, applyArchiveFields(content, archived, archived ? archiveReason(req.body) : null));
     const assignment = await getAssignmentDetail(projectsDir2, projectSlug, assignmentSlug);
     res.json({ assignment });
@@ -12222,7 +12276,7 @@ ${entry}`;
       return;
     }
     const assignmentPath = resolve21(resolved.assignmentDir, "assignment.md");
-    const content = await readFile15(assignmentPath, "utf-8");
+    const content = await readFile16(assignmentPath, "utf-8");
     await writeFileForce(assignmentPath, applyArchiveFields(content, archived, archived ? archiveReason(req.body) : null));
     const assignment = await getAssignmentDetailById(projectsDir2, assignmentsDir2, id);
     res.json({ assignment });
@@ -12263,7 +12317,7 @@ ${entry}`;
         res.status(400).json({ error: validation.error });
         return;
       }
-      let content = await readFile15(assignmentPath, "utf-8");
+      let content = await readFile16(assignmentPath, "utf-8");
       content = setTopLevelField(content, "assignee", validation.value);
       content = setTopLevelField(content, "updated", nowTimestamp());
       await writeFileForce(assignmentPath, content);
@@ -12294,7 +12348,7 @@ ${entry}`;
         res.status(400).json({ error: validation.error });
         return;
       }
-      let content = await readFile15(assignmentPath, "utf-8");
+      let content = await readFile16(assignmentPath, "utf-8");
       content = setTopLevelField(content, "title", validation.value);
       content = setTopLevelField(content, "updated", nowTimestamp());
       await writeFileForce(assignmentPath, content);
@@ -12812,7 +12866,7 @@ ${entry}`;
         res.status(400).json({ error: `Invalid status. Must be one of: ${validStatuses.join(", ")}.` });
         return;
       }
-      let content = await readFile15(assignmentPath, "utf-8");
+      let content = await readFile16(assignmentPath, "utf-8");
       content = setTopLevelField(content, "status", status);
       content = setTopLevelField(content, "updated", nowTimestamp());
       if (status !== "blocked") {
@@ -12848,7 +12902,7 @@ ${entry}`;
         res.status(400).json({ error: validation.error });
         return;
       }
-      let content = await readFile15(assignmentPath, "utf-8");
+      let content = await readFile16(assignmentPath, "utf-8");
       content = setTopLevelField(content, "assignee", validation.value);
       content = setTopLevelField(content, "updated", nowTimestamp());
       await writeFileForce(assignmentPath, content);
@@ -12881,7 +12935,7 @@ ${entry}`;
         res.status(400).json({ error: validation.error });
         return;
       }
-      let content = await readFile15(assignmentPath, "utf-8");
+      let content = await readFile16(assignmentPath, "utf-8");
       content = setTopLevelField(content, "title", validation.value);
       content = setTopLevelField(content, "updated", nowTimestamp());
       await writeFileForce(assignmentPath, content);
@@ -13018,7 +13072,7 @@ async function appendCommentTo(assignmentDir, assignmentRef, req, res, reloadDet
   let currentContent;
   let currentCount = 0;
   if (await fileExists(commentsPath)) {
-    currentContent = await readFile15(commentsPath, "utf-8");
+    currentContent = await readFile16(commentsPath, "utf-8");
     const countMatch = currentContent.match(/^entryCount:\s*(\d+)/m);
     if (countMatch) currentCount = parseInt(countMatch[1], 10);
   } else {
@@ -13058,7 +13112,7 @@ async function toggleCommentResolvedAt(assignmentDir, commentId, req, res, reloa
     res.status(400).json({ error: "resolved (boolean) is required" });
     return;
   }
-  const content = await readFile15(commentsPath, "utf-8");
+  const content = await readFile16(commentsPath, "utf-8");
   const parsed = parseComments(content);
   const target = parsed.entries.find((e) => e.id === commentId);
   if (!target) {
@@ -13844,7 +13898,7 @@ import { Router as Router8 } from "express";
 
 // src/utils/status-config-resolution.ts
 init_frontmatter();
-import { readFile as readFile16, writeFile as writeFile4, rm as rm2 } from "fs/promises";
+import { readFile as readFile17, writeFile as writeFile4, rm as rm2 } from "fs/promises";
 import { dirname as dirname5 } from "path";
 
 // src/utils/assignment-walk.ts
@@ -13927,7 +13981,7 @@ async function scanAssignmentsByStatus(projectsDir2, standaloneDir, ids) {
     const assignmentPath = `${entry.assignmentDir}/assignment.md`;
     let content;
     try {
-      content = await readFile16(assignmentPath, "utf-8");
+      content = await readFile17(assignmentPath, "utf-8");
     } catch (err2) {
       const code = err2?.code;
       if (code === "ENOENT") {
@@ -13990,7 +14044,7 @@ async function applyStatusResolutions(resolutions, affected, validTargets) {
     const list = affected.get(r.id) ?? [];
     for (const a of list) {
       try {
-        const content = await readFile16(a.path, "utf-8");
+        const content = await readFile17(a.path, "utf-8");
         buffer.set(a.path, content);
       } catch (err2) {
         const code = err2?.code;
@@ -14018,7 +14072,7 @@ async function applyStatusResolutions(resolutions, affected, validTargets) {
       for (const a of list) {
         let current;
         try {
-          current = await readFile16(a.path, "utf-8");
+          current = await readFile17(a.path, "utf-8");
         } catch (err2) {
           const code = err2?.code;
           if (code === "ENOENT") {
@@ -14067,7 +14121,7 @@ async function applyStatusResolutions(resolutions, affected, validTargets) {
     const list = affected.get(r.id) ?? [];
     for (const a of list) {
       try {
-        const current = await readFile16(a.path, "utf-8");
+        const current = await readFile17(a.path, "utf-8");
         const fm = parseAssignmentFrontmatter(current);
         if (fm.status !== r.id) {
           console.warn(
@@ -15456,7 +15510,7 @@ init_playbook();
 init_playbooks();
 import { Router as Router11 } from "express";
 import { resolve as resolve26 } from "path";
-import { readFile as readFile17 } from "fs/promises";
+import { readFile as readFile18 } from "fs/promises";
 function statusForPlaybookError(code) {
   switch (code) {
     case "manifest":
@@ -15538,7 +15592,7 @@ function createPlaybooksRouter(playbooksDir3) {
         return;
       }
       const filePath = resolve26(playbooksDir3, resolved.filename);
-      const content = await readFile17(filePath, "utf-8");
+      const content = await readFile18(filePath, "utf-8");
       res.json({
         documentType: "playbook",
         title: `Edit Playbook: ${resolved.slug}`,
@@ -15889,8 +15943,8 @@ function createTodosRouter(todosDir2, broadcast, projectsDir2) {
   router.post("/:workspace/archive", async (req, res) => {
     try {
       const { archivePath: archivePath2 } = await Promise.resolve().then(() => (init_parser2(), parser_exports));
-      const { resolve: resolve79 } = await import("path");
-      const { readFile: readFile54 } = await import("fs/promises");
+      const { resolve: resolve82 } = await import("path");
+      const { readFile: readFile56 } = await import("fs/promises");
       const { writeFileForce: writeFileForce2 } = await Promise.resolve().then(() => (init_fs(), fs_exports));
       const workspace = getWorkspaceParam(req.params.workspace);
       const checklist = await readChecklist(todosDir2, workspace);
@@ -15906,10 +15960,10 @@ function createTodosRouter(todosDir2, broadcast, projectsDir2) {
         (e) => e.itemIds.every((id) => completedIds.has(id))
       );
       const archFile = archivePath2(todosDir2, workspace, checklist.archiveInterval);
-      await ensureDir(resolve79(todosDir2, "archive"));
+      await ensureDir(resolve82(todosDir2, "archive"));
       let archContent = "";
       if (await fileExists(archFile)) {
-        archContent = await readFile54(archFile, "utf-8");
+        archContent = await readFile56(archFile, "utf-8");
         archContent = archContent.trimEnd() + "\n\n";
       } else {
         archContent = `---
@@ -16191,7 +16245,7 @@ workspace: ${workspace}
         const { readConfig: readConfig3 } = await Promise.resolve().then(() => (init_config2(), config_exports));
         const { assignmentsDir: assignmentsDirFn } = await Promise.resolve().then(() => (init_paths(), paths_exports));
         const { fileExists: fileExists2, writeFileForce: writeFileForce2 } = await Promise.resolve().then(() => (init_fs(), fs_exports));
-        const { readFile: readFile54 } = await import("fs/promises");
+        const { readFile: readFile56 } = await import("fs/promises");
         const { appendTodosToAssignmentBody: appendTodosToAssignmentBody2, touchAssignmentUpdated: touchAssignmentUpdated2 } = await Promise.resolve().then(() => (init_assignment_todos(), assignment_todos_exports));
         const { nowTimestamp: nowTimestamp3 } = await Promise.resolve().then(() => (init_timestamp(), timestamp_exports));
         let assignmentRef;
@@ -16212,7 +16266,7 @@ workspace: ${workspace}
         }
         const assignmentMdPath2 = resolvePath2(assignmentDir, "assignment.md");
         if (!await fileExists2(assignmentMdPath2)) return { error: `Target assignment not found: ${assignmentMdPath2}` };
-        let content = await readFile54(assignmentMdPath2, "utf-8");
+        let content = await readFile56(assignmentMdPath2, "utf-8");
         content = appendTodosToAssignmentBody2(
           content,
           items.map((it) => ({
@@ -16400,7 +16454,7 @@ init_fs();
 init_paths();
 init_slug();
 import { Router as Router13 } from "express";
-import { mkdir as mkdir3, readFile as readFile18, rename as rename6 } from "fs/promises";
+import { mkdir as mkdir3, readFile as readFile19, rename as rename6 } from "fs/promises";
 import { resolve as resolve27, dirname as dirname7 } from "path";
 init_promote_todos();
 init_api();
@@ -16625,7 +16679,7 @@ function createProjectTodosRouter(projectsDir2, broadcast, workspaceTodosDir) {
       const archFile = archivePath(todosDir2, slug, checklist.archiveInterval);
       let archContent = "";
       if (await fileExists(archFile)) {
-        archContent = await readFile18(archFile, "utf-8");
+        archContent = await readFile19(archFile, "utf-8");
         archContent = archContent.trimEnd() + "\n\n";
       } else {
         archContent = `---
@@ -17082,7 +17136,7 @@ workspace: ${slug}
         }
         const assignmentMdPath2 = resolve27(assignmentDir, "assignment.md");
         if (!await fileExists(assignmentMdPath2)) return { error: `Target assignment not found: ${assignmentMdPath2}` };
-        let content = await readFile18(assignmentMdPath2, "utf-8");
+        let content = await readFile19(assignmentMdPath2, "utf-8");
         content = appendTodosToAssignmentBody2(
           content,
           items.map((it) => ({
@@ -17286,7 +17340,7 @@ init_fs();
 init_paths();
 init_parser2();
 import { randomBytes as randomBytes2 } from "crypto";
-import { readFile as readFile19 } from "fs/promises";
+import { readFile as readFile20 } from "fs/promises";
 var BUNDLE_ID_REGEX = /^[a-f0-9]{4}$/;
 var SCOPE_VALUES = /* @__PURE__ */ new Set(["workspace", "project", "global"]);
 var SCOPE_ID_REGEX = /^[a-z0-9_][a-z0-9_-]*$/;
@@ -17389,7 +17443,7 @@ ${lines}
 async function readBundles(todosDir2) {
   const path = bundlesPath(todosDir2);
   if (!await fileExists(path)) return [];
-  const content = await readFile19(path, "utf-8");
+  const content = await readFile20(path, "utf-8");
   return parseBundles(content).bundles;
 }
 async function writeBundles(todosDir2, bundles) {
@@ -17566,7 +17620,7 @@ init_fs();
 init_config2();
 import { execFile as execFile2 } from "child_process";
 import { promisify as promisify2 } from "util";
-import { cp, mkdtemp, rm as rm3, readFile as readFile20, writeFile as writeFile5, unlink as unlink5, stat, open as open2, rename as rename7 } from "fs/promises";
+import { cp, mkdtemp, rm as rm3, readFile as readFile21, writeFile as writeFile5, unlink as unlink5, stat, open as open2, rename as rename7 } from "fs/promises";
 import { resolve as resolve29, join as join3 } from "path";
 import { tmpdir } from "os";
 var exec2 = promisify2(execFile2);
@@ -17627,7 +17681,7 @@ async function acquireLock() {
     return lockPath;
   } catch (err2) {
     if (err2.code === "EEXIST") {
-      const pid = await readFile20(lockPath, "utf-8").catch(() => "");
+      const pid = await readFile21(lockPath, "utf-8").catch(() => "");
       throw new Error(
         `Backup operation already in progress (lock file at ${lockPath}, pid ${pid.trim() || "unknown"}). If stale, delete the file and retry.`
       );
@@ -17674,7 +17728,7 @@ function resolveCategoriesStrict(csv) {
   return parseCategoriesStrict(parts);
 }
 async function readSanitizedConfig(configPath) {
-  const content = await readFile20(configPath, "utf-8");
+  const content = await readFile21(configPath, "utf-8");
   return content.replace(/^(\s*lastBackup:\s*).*$/m, "$1null").replace(/^(\s*lastRestore:\s*).*$/m, "$1null");
 }
 async function backupToGithub(overrides) {
@@ -19066,7 +19120,7 @@ init_frontmatter();
 init_timestamp();
 init_assignment_resolver();
 import { resolve as resolve33 } from "path";
-import { readFile as readFile21, writeFile as writeFile7 } from "fs/promises";
+import { readFile as readFile22, writeFile as writeFile7 } from "fs/promises";
 async function resolveTarget(target, options) {
   const config = await readConfig();
   const baseDir = options.dir ? expandHome(options.dir) : config.defaultProjectDir;
@@ -19098,7 +19152,7 @@ async function resolveTarget(target, options) {
   return null;
 }
 async function writeArchiveState(filePath, archived, reason) {
-  const content = await readFile21(filePath, "utf-8");
+  const content = await readFile22(filePath, "utf-8");
   const updated = updateAssignmentFile(content, {
     archived,
     archivedAt: archived ? nowTimestamp() : null,
@@ -19167,7 +19221,7 @@ init_config2();
 init_frontmatter();
 init_timestamp();
 import { resolve as resolve34 } from "path";
-import { readdir as readdir13, readFile as readFile22 } from "fs/promises";
+import { readdir as readdir13, readFile as readFile23 } from "fs/promises";
 var PROMOTABLE_STATUSES = /* @__PURE__ */ new Set(["pending"]);
 function objectiveIsFleshedOut(content) {
   const match = content.match(/##\s+Objective\s*\n([\s\S]*?)(?=\n##\s+|$)/);
@@ -19193,7 +19247,7 @@ async function collectCandidates(baseDirs) {
       if (await fileExists(directAssignmentMd)) {
         const fm = await parseSafe(directAssignmentMd);
         if (fm && PROMOTABLE_STATUSES.has(fm.status)) {
-          const content = await readFile22(directAssignmentMd, "utf-8");
+          const content = await readFile23(directAssignmentMd, "utf-8");
           if (objectiveIsFleshedOut(content) && hasAcceptanceCriteria(content)) {
             candidates.push({
               projectSlug: null,
@@ -19216,7 +19270,7 @@ async function collectCandidates(baseDirs) {
         if (!await fileExists(assignmentMd)) continue;
         const fm = await parseSafe(assignmentMd);
         if (!fm || !PROMOTABLE_STATUSES.has(fm.status)) continue;
-        const content = await readFile22(assignmentMd, "utf-8");
+        const content = await readFile23(assignmentMd, "utf-8");
         if (!objectiveIsFleshedOut(content)) continue;
         if (!hasAcceptanceCriteria(content)) continue;
         candidates.push({
@@ -19233,7 +19287,7 @@ async function collectCandidates(baseDirs) {
 }
 async function parseSafe(path) {
   try {
-    const content = await readFile22(path, "utf-8");
+    const content = await readFile23(path, "utf-8");
     return parseAssignmentFrontmatter(content);
   } catch {
     return null;
@@ -19262,7 +19316,7 @@ async function migrateStatusesCommand(options) {
   const now = nowTimestamp();
   let migrated = 0;
   for (const c2 of candidates) {
-    const content = await readFile22(c2.assignmentMd, "utf-8");
+    const content = await readFile23(c2.assignmentMd, "utf-8");
     const updated = updateAssignmentFile(content, {
       status: c2.toStatus,
       updated: now
@@ -19320,7 +19374,7 @@ import {
   readdir as readdir14,
   symlink,
   lstat,
-  readFile as readFile23,
+  readFile as readFile24,
   readlink,
   rename as rename8,
   rm as rm4,
@@ -19362,8 +19416,8 @@ function getPluginManifestRelativePath(pluginKind) {
   return pluginKind === "claude" ? ".claude-plugin/plugin.json" : ".codex-plugin/plugin.json";
 }
 function getDefaultPluginTargetDir(pluginKind) {
-  const home = homedir3();
-  return pluginKind === "claude" ? resolve36(home, ".claude", "plugins", "syntaur") : resolve36(home, "plugins", "syntaur");
+  const home2 = homedir3();
+  return pluginKind === "claude" ? resolve36(home2, ".claude", "plugins", "syntaur") : resolve36(home2, "plugins", "syntaur");
 }
 function getDefaultMarketplacePath() {
   return resolve36(homedir3(), ".agents", "plugins", "marketplace.json");
@@ -19381,7 +19435,7 @@ function getInstallMarkerPath(targetDir) {
   return resolve36(targetDir, INSTALL_MARKER_FILENAME);
 }
 async function readPackageManifest(packageRoot) {
-  const raw = await readFile23(resolve36(packageRoot, "package.json"), "utf-8");
+  const raw = await readFile24(resolve36(packageRoot, "package.json"), "utf-8");
   return JSON.parse(raw);
 }
 async function readJsonFileIfExists(pathValue) {
@@ -19389,7 +19443,7 @@ async function readJsonFileIfExists(pathValue) {
     return null;
   }
   try {
-    const raw = await readFile23(pathValue, "utf-8");
+    const raw = await readFile24(pathValue, "utf-8");
     return JSON.parse(raw);
   } catch {
     return null;
@@ -19405,7 +19459,7 @@ async function readPluginManifestName(targetDir, pluginKind) {
   if (!await fileExists(manifestPath)) {
     return void 0;
   }
-  const raw = await readFile23(manifestPath, "utf-8");
+  const raw = await readFile24(manifestPath, "utf-8");
   const parsed = JSON.parse(raw);
   return parsed.name;
 }
@@ -19415,7 +19469,7 @@ async function readInstallMetadata(targetDir) {
     return null;
   }
   try {
-    const raw = await readFile23(markerPath, "utf-8");
+    const raw = await readFile24(markerPath, "utf-8");
     return JSON.parse(raw);
   } catch {
     return null;
@@ -19538,7 +19592,7 @@ async function writeClaudeMarketplaceFile(manifestPath, marketplace) {
   }
   if (await fileExists(manifestPath)) {
     try {
-      const prev = await readFile23(manifestPath, "utf-8");
+      const prev = await readFile24(manifestPath, "utf-8");
       JSON.parse(prev);
       const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
       await writeFile8(`${manifestPath}.bak-${stamp}`, prev, "utf-8");
@@ -19686,7 +19740,7 @@ async function registerKnownClaudeMarketplace(name, rootDir) {
   const manifestPath = getClaudeKnownMarketplacesPath();
   let existing = {};
   if (await fileExists(manifestPath)) {
-    const raw = await readFile23(manifestPath, "utf-8");
+    const raw = await readFile24(manifestPath, "utf-8");
     try {
       const parsed = JSON.parse(raw);
       if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
@@ -19713,7 +19767,7 @@ async function registerKnownClaudeMarketplace(name, rootDir) {
   existing[name].autoUpdate = true;
   await ensureDir(dirname10(manifestPath));
   if (await fileExists(manifestPath)) {
-    const prev = await readFile23(manifestPath, "utf-8");
+    const prev = await readFile24(manifestPath, "utf-8");
     const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
     await writeFile8(`${manifestPath}.bak-${stamp}`, prev, "utf-8");
   }
@@ -19731,7 +19785,7 @@ async function setSyntaurPluginEnabled(options) {
   const key = `syntaur@${options.marketplaceName}`;
   let parsed = {};
   if (await fileExists(settingsPath)) {
-    const raw = await readFile23(settingsPath, "utf-8");
+    const raw = await readFile24(settingsPath, "utf-8");
     try {
       parsed = JSON.parse(raw);
     } catch {
@@ -19750,7 +19804,7 @@ async function setSyntaurPluginEnabled(options) {
   await ensureDir(dirname10(settingsPath));
   if (await fileExists(settingsPath)) {
     const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-    const prev = await readFile23(settingsPath, "utf-8");
+    const prev = await readFile24(settingsPath, "utf-8");
     await writeFile8(`${settingsPath}.bak-${stamp}`, prev, "utf-8");
   }
   const tmpPath = `${settingsPath}.tmp`;
@@ -19988,7 +20042,7 @@ async function readMarketplaceFile(marketplacePath) {
       plugins: []
     };
   }
-  const raw = await readFile23(marketplacePath, "utf-8");
+  const raw = await readFile24(marketplacePath, "utf-8");
   const parsed = JSON.parse(raw);
   return {
     name: parsed.name ?? "local",
@@ -20224,13 +20278,13 @@ async function textPrompt(question, defaultValue) {
 
 // src/utils/install-skills.ts
 init_fs();
-import { readFile as readFile25, readdir as readdir15, mkdir as mkdir4, copyFile, rm as rm5, lstat as lstat2 } from "fs/promises";
+import { readFile as readFile26, readdir as readdir15, mkdir as mkdir4, copyFile, rm as rm5, lstat as lstat2 } from "fs/promises";
 import { resolve as resolve38, relative as relative3, join as join4 } from "path";
 import { homedir as homedir5 } from "os";
 
 // src/utils/plugin-state.ts
 init_fs();
-import { readFile as readFile24 } from "fs/promises";
+import { readFile as readFile25 } from "fs/promises";
 import { resolve as resolve37 } from "path";
 import { homedir as homedir4 } from "os";
 function settingsPathFor(agent) {
@@ -20241,7 +20295,7 @@ async function readJsonOrNull(path) {
   if (!path) return null;
   if (!await fileExists(path)) return null;
   try {
-    const raw = await readFile24(path, "utf-8");
+    const raw = await readFile25(path, "utf-8");
     return JSON.parse(raw);
   } catch {
     return null;
@@ -20315,7 +20369,7 @@ async function walkFiles(root) {
 }
 async function filesEqual(a, b) {
   try {
-    const [ba, bb] = await Promise.all([readFile25(a), readFile25(b)]);
+    const [ba, bb] = await Promise.all([readFile26(a), readFile26(b)]);
     if (ba.length !== bb.length) return false;
     return ba.equals(bb);
   } catch {
@@ -20416,6 +20470,24 @@ async function installSkillsWithReport(options) {
   }
   return { results };
 }
+async function installSkillsToDir(options) {
+  const source = options.sourceDir ?? await getSkillsDir();
+  if (!await fileExists(source)) {
+    throw new Error(
+      `Syntaur skills not found at ${source}. Reinstall syntaur: npm install -g syntaur@latest`
+    );
+  }
+  const force = options.force ?? false;
+  const skillNames = await discoverSkillNames(source);
+  await mkdir4(options.targetDir, { recursive: true });
+  const results = [];
+  for (const skill of skillNames) {
+    const srcDir = join4(source, skill);
+    const destDir = join4(options.targetDir, skill);
+    results.push(await installSkillDir(srcDir, destDir, skill, force));
+  }
+  return results;
+}
 async function uninstallSkills(options) {
   const targetRoot = options.targetDir ?? defaultSkillTargetDir(options.target);
   if (!await fileExists(targetRoot)) return [];
@@ -20437,7 +20509,7 @@ async function uninstallSkills(options) {
     if (await isSymlink(destDir)) continue;
     const skillMd = join4(destDir, "SKILL.md");
     if (!await fileExists(skillMd)) continue;
-    const content = await readFile25(skillMd, "utf-8").catch(() => "");
+    const content = await readFile26(skillMd, "utf-8").catch(() => "");
     const match = content.match(/^name:\s*(\S+)\s*$/m);
     if (!match || match[1] !== skill) continue;
     await rm5(destDir, { recursive: true, force: true });
@@ -20965,7 +21037,7 @@ async function executeLaunchPlan(plan, spawnFn = realSpawn) {
       `Spawn failed: ${msg}. Verify the terminal is installed and on PATH.`
     );
   }
-  await new Promise((resolve79, reject) => {
+  await new Promise((resolve82, reject) => {
     let settled = false;
     let stderr = "";
     const finishOk = () => {
@@ -20975,7 +21047,7 @@ async function executeLaunchPlan(plan, spawnFn = realSpawn) {
         child.unref();
       } catch {
       }
-      resolve79();
+      resolve82();
     };
     const finishErr = (remediation) => {
       if (settled) return;
@@ -21130,7 +21202,7 @@ function normalizeSlashes(p) {
 }
 function detectInstallKind(scriptUrl, opts = {}) {
   const realpath3 = opts.realpath ?? realpathSync.native;
-  const readFile54 = opts.readFile ?? ((p) => readFileSync(p, "utf-8"));
+  const readFile56 = opts.readFile ?? ((p) => readFileSync(p, "utf-8"));
   const ua = opts.envUserAgent !== void 0 ? opts.envUserAgent : process.env.npm_config_user_agent ?? "";
   const resolved = resolveScriptPath(scriptUrl, realpath3);
   if (resolved === null) {
@@ -21151,7 +21223,7 @@ function detectInstallKind(scriptUrl, opts = {}) {
     const pkgJsonPath = join5(dir, "package.json");
     let raw;
     try {
-      raw = readFile54(pkgJsonPath);
+      raw = readFile56(pkgJsonPath);
     } catch {
       const parent2 = dirname11(dir);
       if (parent2 === dir) break;
@@ -21236,20 +21308,20 @@ async function maybeNudgeForNpxInstall(scriptUrl) {
 init_paths();
 init_fs();
 import { fileURLToPath as fileURLToPath6 } from "url";
-import { readFile as readFile27 } from "fs/promises";
+import { readFile as readFile28 } from "fs/promises";
 import { dirname as dirname13, join as join7, resolve as resolve41 } from "path";
 import { spawn as spawn5 } from "child_process";
 import { createInterface as createInterface2 } from "readline/promises";
 
 // src/utils/version.ts
 import { fileURLToPath as fileURLToPath5 } from "url";
-import { readFile as readFile26 } from "fs/promises";
+import { readFile as readFile27 } from "fs/promises";
 import { dirname as dirname12, join as join6 } from "path";
 async function readPackageVersion(scriptUrl) {
   try {
     const scriptPath = fileURLToPath5(scriptUrl);
     const pkgRoot = dirname12(dirname12(scriptPath));
-    const raw = await readFile26(join6(pkgRoot, "package.json"), "utf-8");
+    const raw = await readFile27(join6(pkgRoot, "package.json"), "utf-8");
     const parsed = JSON.parse(raw);
     return typeof parsed.version === "string" ? parsed.version : null;
   } catch {
@@ -21279,7 +21351,7 @@ function isRunningViaNpx(scriptUrl) {
 async function readState() {
   if (!await fileExists(STATE_FILE)) return null;
   try {
-    const raw = await readFile27(STATE_FILE, "utf-8");
+    const raw = await readFile28(STATE_FILE, "utf-8");
     return JSON.parse(raw);
   } catch {
     return null;
@@ -21338,7 +21410,7 @@ async function readGlobalVersion() {
   try {
     const manifestPath = join7(rootPath, "syntaur", "package.json");
     if (!await fileExists(manifestPath)) return null;
-    const raw = await readFile27(manifestPath, "utf-8");
+    const raw = await readFile28(manifestPath, "utf-8");
     const parsed = JSON.parse(raw);
     return typeof parsed.version === "string" ? parsed.version : null;
   } catch {
@@ -21696,7 +21768,7 @@ async function refreshPluginSkills(options, pm, runner, getManagedDir, resolveFr
 // src/commands/install-statusline.ts
 init_paths();
 init_fs();
-import { readFile as readFile29, writeFile as writeFile11, copyFile as copyFile2, rm as rm6, stat as stat2, symlink as symlink2, unlink as unlink8, lstat as lstat3 } from "fs/promises";
+import { readFile as readFile30, writeFile as writeFile11, copyFile as copyFile2, rm as rm6, stat as stat2, symlink as symlink2, unlink as unlink8, lstat as lstat3 } from "fs/promises";
 import { resolve as resolve43, dirname as dirname15 } from "path";
 import { homedir as homedir7 } from "os";
 import { fileURLToPath as fileURLToPath8 } from "url";
@@ -21704,7 +21776,7 @@ import { fileURLToPath as fileURLToPath8 } from "url";
 // src/commands/configure-statusline.ts
 init_paths();
 init_fs();
-import { readFile as readFile28, writeFile as writeFile10 } from "fs/promises";
+import { readFile as readFile29, writeFile as writeFile10 } from "fs/promises";
 import { resolve as resolve42, dirname as dirname14 } from "path";
 import { spawnSync as spawnSync5 } from "child_process";
 import { checkbox, input as input2, confirm } from "@inquirer/prompts";
@@ -21731,7 +21803,7 @@ function getConfigPath(installRoot) {
 async function readConfig2(path) {
   if (!await fileExists(path)) return null;
   try {
-    const raw = await readFile28(path, "utf-8");
+    const raw = await readFile29(path, "utf-8");
     const parsed = JSON.parse(raw);
     if (!parsed || typeof parsed !== "object") return null;
     const segments = Array.isArray(parsed.segments) ? parsed.segments.filter(isSegmentName) : [];
@@ -21919,7 +21991,7 @@ function getPackageStatuslineSource() {
 }
 async function readSettingsJson(settingsPath) {
   if (!await fileExists(settingsPath)) return {};
-  const raw = await readFile29(settingsPath, "utf-8");
+  const raw = await readFile30(settingsPath, "utf-8");
   if (raw.trim() === "") return {};
   try {
     const parsed = JSON.parse(raw);
@@ -22107,7 +22179,7 @@ async function uninstallStatuslineCommand(options = {}) {
   let restored = null;
   if (await fileExists(backupPath)) {
     try {
-      const raw = await readFile29(backupPath, "utf-8");
+      const raw = await readFile30(backupPath, "utf-8");
       const parsed = JSON.parse(raw);
       const prev = parsed?.previousStatusLine;
       if (prev && typeof prev === "object" && typeof prev.command === "string") {
@@ -22284,6 +22356,353 @@ async function uninstallSkillsCommand(options) {
 // src/commands/setup.ts
 import { execSync } from "child_process";
 init_config2();
+
+// src/commands/cross-agent-install.ts
+init_fs();
+import { spawnSync as spawnSync6 } from "child_process";
+import { resolve as resolve46 } from "path";
+import { readFile as readFile31 } from "fs/promises";
+
+// src/commands/setup-adapter.ts
+init_paths();
+init_fs();
+init_config2();
+init_slug();
+import { resolve as resolve45 } from "path";
+
+// src/targets/registry.ts
+init_fs();
+import { homedir as homedir8 } from "os";
+import { resolve as resolve44 } from "path";
+function home(...segments) {
+  return resolve44(homedir8(), ...segments);
+}
+function hermesHome() {
+  const env = process.env.HERMES_HOME;
+  return env && env.length > 0 ? resolve44(env) : home(".hermes");
+}
+function hermesSkillsDir() {
+  return resolve44(hermesHome(), "skills");
+}
+function isHermesHomeCustom() {
+  return hermesHome() !== home(".hermes");
+}
+function codexHome() {
+  const env = process.env.CODEX_HOME;
+  return env && env.length > 0 ? resolve44(env) : home(".codex");
+}
+var detectDir = (dir) => () => fileExists(dir);
+var AGENT_TARGETS = [
+  {
+    id: "cursor",
+    displayName: "Cursor",
+    skillsShAgentId: "cursor",
+    detect: detectDir(home(".cursor")),
+    skillsDir: { global: home(".cursor", "skills") },
+    instructions: {
+      files: [
+        { path: ".cursor/rules/syntaur-protocol.mdc", renderer: "cursorProtocol" },
+        { path: ".cursor/rules/syntaur-assignment.mdc", renderer: "cursorAssignment" }
+      ]
+    }
+  },
+  {
+    // codex is BOTH an adapter (writes AGENTS.md) AND a native plugin.
+    id: "codex",
+    displayName: "Codex",
+    skillsShAgentId: "codex",
+    nativePlugin: "codex",
+    detect: detectDir(codexHome()),
+    skillsDir: { global: resolve44(codexHome(), "skills") },
+    instructions: { files: [{ path: "AGENTS.md", renderer: "codexAgents" }] }
+  },
+  {
+    id: "opencode",
+    displayName: "OpenCode",
+    skillsShAgentId: "opencode",
+    detect: detectDir(home(".config", "opencode")),
+    skillsDir: { global: home(".config", "opencode", "skills") },
+    instructions: {
+      files: [
+        { path: "AGENTS.md", renderer: "codexAgents" },
+        { path: "opencode.json", renderer: "openCodeConfig" }
+      ]
+    }
+  },
+  {
+    // claude has NO adapter today (not in the old SUPPORTED_FRAMEWORKS) — the
+    // full plugin path owns its skills/hooks/commands. Native-plugin only.
+    id: "claude",
+    displayName: "Claude Code",
+    skillsShAgentId: "claude-code",
+    nativePlugin: "claude",
+    detect: detectDir(home(".claude")),
+    skillsDir: { global: home(".claude", "skills") }
+  },
+  {
+    id: "pi",
+    displayName: "Pi",
+    skillsShAgentId: "pi",
+    detect: detectDir(home(".pi")),
+    skillsDir: { global: home(".pi", "agent", "skills") },
+    instructions: { files: [{ path: "AGENTS.md", renderer: "codexAgents" }] }
+  },
+  {
+    id: "openclaw",
+    displayName: "OpenClaw",
+    skillsShAgentId: "openclaw",
+    detect: detectDir(home(".openclaw")),
+    skillsDir: { global: home(".openclaw", "skills") },
+    instructions: { files: [{ path: "AGENTS.md", renderer: "codexAgents" }] }
+  },
+  {
+    id: "hermes",
+    displayName: "Hermes Agent",
+    skillsShAgentId: "hermes-agent",
+    detect: () => fileExists(hermesHome()),
+    skillsDir: { global: hermesSkillsDir() },
+    instructions: { files: [{ path: "SOUL.md", renderer: "hermesSoul" }] }
+  }
+];
+var AGENT_TARGETS_BY_ID = Object.fromEntries(
+  AGENT_TARGETS.map((t) => [t.id, t])
+);
+function getAgentTarget(id) {
+  return AGENT_TARGETS_BY_ID[id];
+}
+function agentTargetIds() {
+  return AGENT_TARGETS.map((t) => t.id);
+}
+function adapterTargets() {
+  return AGENT_TARGETS.filter((t) => t.instructions !== void 0);
+}
+
+// src/targets/renderers.ts
+init_cursor_rules();
+init_codex_agents();
+init_opencode_config();
+init_hermes_soul();
+var RENDERERS = {
+  codexAgents: (ctx) => renderCodexAgents(ctx),
+  cursorProtocol: () => renderCursorProtocol(),
+  cursorAssignment: (ctx) => renderCursorAssignment(ctx),
+  openCodeConfig: (ctx) => renderOpenCodeConfig({ projectDir: ctx.projectDir }),
+  hermesSoul: (ctx) => renderHermesSoul(ctx)
+};
+
+// src/commands/setup-adapter.ts
+async function setupAdapterCommand(framework, options) {
+  const target = getAgentTarget(framework);
+  if (!target || !target.instructions) {
+    const supported = adapterTargets().map((t) => t.id).join(", ");
+    throw new Error(
+      `Unsupported framework "${framework}". Supported: ${supported}`
+    );
+  }
+  if (!options.project) {
+    throw new Error("--project <slug> is required.");
+  }
+  if (!options.assignment) {
+    throw new Error("--assignment <slug> is required.");
+  }
+  if (!isValidSlug(options.project)) {
+    throw new Error(
+      `Invalid project slug "${options.project}". Slugs must be lowercase, hyphen-separated, with no special characters.`
+    );
+  }
+  if (!isValidSlug(options.assignment)) {
+    throw new Error(
+      `Invalid assignment slug "${options.assignment}". Slugs must be lowercase, hyphen-separated, with no special characters.`
+    );
+  }
+  const config = await readConfig();
+  const baseDir = options.dir ? expandHome(options.dir) : config.defaultProjectDir;
+  const projectDir = resolve45(baseDir, options.project);
+  const assignmentDir = resolve45(projectDir, "assignments", options.assignment);
+  const projectMdPath = resolve45(projectDir, "project.md");
+  if (!await fileExists(projectDir) || !await fileExists(projectMdPath)) {
+    throw new Error(`Project "${options.project}" not found at ${projectDir}.`);
+  }
+  const assignmentMdPath2 = resolve45(assignmentDir, "assignment.md");
+  if (!await fileExists(assignmentDir) || !await fileExists(assignmentMdPath2)) {
+    throw new Error(
+      `Assignment "${options.assignment}" not found at ${assignmentDir}.`
+    );
+  }
+  const cwd = process.cwd();
+  const rendererParams = {
+    projectSlug: options.project,
+    assignmentSlug: options.assignment,
+    projectDir,
+    assignmentDir
+  };
+  const writtenFiles = [];
+  const upToDateFiles = [];
+  const skippedFiles = [];
+  for (const file of target.instructions.files) {
+    const filePath = resolve45(cwd, file.path);
+    const content = RENDERERS[file.renderer](rendererParams);
+    const status = await writeFileReport(filePath, content, {
+      force: options.force
+    });
+    if (status === "differs-preserved") {
+      skippedFiles.push(filePath);
+    } else if (status === "already-current") {
+      upToDateFiles.push(filePath);
+    } else {
+      writtenFiles.push(filePath);
+    }
+  }
+  if (writtenFiles.length > 0) {
+    console.log(`Generated ${target.id} adapter files:`);
+    for (const f of writtenFiles) {
+      console.log(`  ${f}`);
+    }
+  }
+  if (upToDateFiles.length > 0) {
+    console.log(`Already up-to-date:`);
+    for (const f of upToDateFiles) {
+      console.log(`  ${f}`);
+    }
+  }
+  if (skippedFiles.length > 0) {
+    console.log(`Skipped (exists with different content, use --force to overwrite):`);
+    for (const f of skippedFiles) {
+      console.log(`  ${f}`);
+    }
+  }
+  if (writtenFiles.length === 0 && skippedFiles.length === 0 && upToDateFiles.length > 0) {
+    console.log(`No changes. All ${target.id} adapter files are already up-to-date.`);
+  }
+}
+
+// src/commands/cross-agent-install.ts
+init_config2();
+var DEFAULT_SKILLS_SOURCE = "prong-horn/syntaur";
+function parseTargetIds(options) {
+  const raw = [options.target, options.agent].filter(Boolean).join(",");
+  const ids = raw.split(",").map((s) => s.trim()).filter(Boolean);
+  return [...new Set(ids)];
+}
+function isNpxAvailable() {
+  try {
+    const r = spawnSync6("npx", ["--version"], { stdio: "ignore" });
+    return !r.error && r.status === 0;
+  } catch {
+    return false;
+  }
+}
+async function readAssignmentContext() {
+  const p = resolve46(process.cwd(), ".syntaur", "context.json");
+  if (!await fileExists(p)) return null;
+  try {
+    return JSON.parse(await readFile31(p, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+async function crossAgentInstallCommand(options) {
+  const ids = parseTargetIds(options);
+  if (ids.length === 0) {
+    throw new Error("No agents specified. Use --target <id> or --agent <id>.");
+  }
+  const targets = [];
+  for (const id of ids) {
+    const t = getAgentTarget(id);
+    if (!t) {
+      throw new Error(
+        `Unknown agent "${id}". Known agents: ${agentTargetIds().join(", ")}`
+      );
+    }
+    if (t.nativePlugin) {
+      throw new Error(
+        `"${id}" installs as a native Syntaur plugin, not via cross-agent install. Use \`syntaur setup --${t.nativePlugin}\` (or \`syntaur ${t.nativePlugin === "claude" ? "install-plugin" : "install-codex-plugin"}\`).`
+      );
+    }
+    targets.push(t);
+  }
+  const dryRun = Boolean(options.dryRun);
+  const force = Boolean(options.force);
+  const scope = "global";
+  const prefix = dryRun ? "[dry-run] " : "";
+  if (!dryRun && !await isSyntaurDataInstalled()) {
+    await initCommand({});
+  }
+  const skillsShIds = targets.map((t) => t.skillsShAgentId ?? t.id);
+  const argv = ["skills", "add", DEFAULT_SKILLS_SOURCE, "--agent", ...skillsShIds];
+  console.log(`${prefix}Tier 1 (skills): npx ${argv.join(" ")}`);
+  let tier1Done = false;
+  if (!dryRun) {
+    if (isNpxAvailable()) {
+      const r = spawnSync6("npx", argv, { stdio: "inherit" });
+      tier1Done = !r.error && r.status === 0;
+      if (!tier1Done) {
+        console.log("`npx skills add` failed; falling back to offline copy.");
+      }
+    } else {
+      console.log("npx not available; using offline skill copy.");
+    }
+  }
+  for (const t of targets) {
+    const globalDir = t.id === "hermes" ? hermesSkillsDir() : t.skillsDir?.global;
+    if (!globalDir) continue;
+    const offlineNeeded = !tier1Done;
+    const hermesCustom = t.id === "hermes" && isHermesHomeCustom();
+    if (!offlineNeeded && !hermesCustom) continue;
+    if (dryRun) {
+      const label = hermesCustom ? "offline copy (always \u2014 custom $HERMES_HOME)" : "offline copy (fallback if npx unavailable)";
+      console.log(`${prefix}${label} -> ${globalDir}`);
+      continue;
+    }
+    const reason = hermesCustom && tier1Done ? " ($HERMES_HOME reconcile)" : "";
+    await installSkillsToDir({ targetDir: globalDir, force });
+    console.log(`Copied skills -> ${globalDir}${reason}`);
+  }
+  const adapterTargets2 = targets.filter((t) => t.instructions);
+  if (adapterTargets2.length > 0) {
+    const ctx = await readAssignmentContext();
+    const haveCtx = Boolean(ctx?.projectSlug && ctx?.assignmentSlug);
+    for (const t of adapterTargets2) {
+      if (dryRun) {
+        for (const f of t.instructions.files) {
+          console.log(
+            `${prefix}Tier 2 (${t.id}): ${resolve46(process.cwd(), f.path)}`
+          );
+        }
+        continue;
+      }
+      if (!haveCtx) {
+        console.log(
+          `No project-nested assignment context in cwd; skipping Tier-2 files for ${t.id}.`
+        );
+        continue;
+      }
+      try {
+        await setupAdapterCommand(t.id, {
+          project: ctx.projectSlug,
+          assignment: ctx.assignmentSlug,
+          force
+        });
+      } catch (err2) {
+        const msg = err2 instanceof Error ? err2.message : String(err2);
+        console.log(`Tier 2 for ${t.id} skipped: ${msg}`);
+      }
+    }
+  }
+  if (!dryRun) {
+    const current = (await readConfig()).integrations.installedAgents ?? {};
+    const next = { ...current };
+    for (const t of targets) {
+      next[t.id] = { scope };
+    }
+    await updateIntegrationConfig({ installedAgents: next });
+  }
+  console.log(
+    `${prefix}Done. Agents: ${targets.map((t) => t.displayName).join(", ")}.`
+  );
+}
+
+// src/commands/setup.ts
 function isCliInstalled(command) {
   try {
     execSync(`which ${command}`, { stdio: "ignore" });
@@ -22301,6 +22720,15 @@ function printNonInteractiveSetupHelp() {
   console.error(`  npx syntaur@latest setup --yes --dashboard`);
 }
 async function setupCommand(options) {
+  if (options.dryRun && !options.target && !options.agent) {
+    throw new Error(
+      "--dry-run only applies to cross-agent install. Pass --target <id> or --agent <id>."
+    );
+  }
+  if (options.target || options.agent) {
+    await crossAgentInstallCommand(options);
+    return;
+  }
   const initialized = await isSyntaurDataInstalled();
   const interactive = isInteractiveTerminal();
   if (!initialized) {
@@ -22385,7 +22813,7 @@ async function setupCommand(options) {
 }
 
 // src/commands/uninstall.ts
-import { resolve as resolve44 } from "path";
+import { resolve as resolve47 } from "path";
 init_paths();
 function expandTargets(options) {
   if (options.all) {
@@ -22465,7 +22893,7 @@ async function uninstallCommand(options) {
     const configuredProjectDir = await getConfiguredProjectDir();
     await removeSyntaurData();
     console.log(`Removed ${syntaurRoot()}`);
-    if (configuredProjectDir && resolve44(configuredProjectDir) !== resolve44(syntaurRoot(), "projects")) {
+    if (configuredProjectDir && resolve47(configuredProjectDir) !== resolve47(syntaurRoot(), "projects")) {
       console.warn(
         `Warning: config.md pointed to an external project directory (${configuredProjectDir}). That directory was not removed automatically.`
       );
@@ -22476,114 +22904,11 @@ async function uninstallCommand(options) {
   }
 }
 
-// src/commands/setup-adapter.ts
-init_paths();
-init_fs();
-init_config2();
-init_slug();
-init_cursor_rules();
-init_codex_agents();
-init_opencode_config();
-import { resolve as resolve45 } from "path";
-var SUPPORTED_FRAMEWORKS = ["cursor", "codex", "opencode"];
-async function setupAdapterCommand(framework, options) {
-  if (!SUPPORTED_FRAMEWORKS.includes(framework)) {
-    throw new Error(
-      `Unsupported framework "${framework}". Supported: ${SUPPORTED_FRAMEWORKS.join(", ")}`
-    );
-  }
-  if (!options.project) {
-    throw new Error("--project <slug> is required.");
-  }
-  if (!options.assignment) {
-    throw new Error("--assignment <slug> is required.");
-  }
-  if (!isValidSlug(options.project)) {
-    throw new Error(
-      `Invalid project slug "${options.project}". Slugs must be lowercase, hyphen-separated, with no special characters.`
-    );
-  }
-  if (!isValidSlug(options.assignment)) {
-    throw new Error(
-      `Invalid assignment slug "${options.assignment}". Slugs must be lowercase, hyphen-separated, with no special characters.`
-    );
-  }
-  const config = await readConfig();
-  const baseDir = options.dir ? expandHome(options.dir) : config.defaultProjectDir;
-  const projectDir = resolve45(baseDir, options.project);
-  const assignmentDir = resolve45(
-    projectDir,
-    "assignments",
-    options.assignment
-  );
-  const projectMdPath = resolve45(projectDir, "project.md");
-  if (!await fileExists(projectDir) || !await fileExists(projectMdPath)) {
-    throw new Error(
-      `Project "${options.project}" not found at ${projectDir}.`
-    );
-  }
-  const assignmentMdPath2 = resolve45(assignmentDir, "assignment.md");
-  if (!await fileExists(assignmentDir) || !await fileExists(assignmentMdPath2)) {
-    throw new Error(
-      `Assignment "${options.assignment}" not found at ${assignmentDir}.`
-    );
-  }
-  const cwd = process.cwd();
-  const writtenFiles = [];
-  const skippedFiles = [];
-  const rendererParams = {
-    projectSlug: options.project,
-    assignmentSlug: options.assignment,
-    projectDir,
-    assignmentDir
-  };
-  async function writeAdapterFile(filePath, content) {
-    if (options.force) {
-      await writeFileForce(filePath, content);
-      writtenFiles.push(filePath);
-    } else {
-      if (await writeFileSafe(filePath, content)) {
-        writtenFiles.push(filePath);
-      } else {
-        skippedFiles.push(filePath);
-      }
-    }
-  }
-  if (framework === "cursor") {
-    const protocolPath = resolve45(cwd, ".cursor", "rules", "syntaur-protocol.mdc");
-    const assignmentPath = resolve45(cwd, ".cursor", "rules", "syntaur-assignment.mdc");
-    await writeAdapterFile(protocolPath, renderCursorProtocol());
-    await writeAdapterFile(assignmentPath, renderCursorAssignment(rendererParams));
-  } else if (framework === "codex" || framework === "opencode") {
-    const agentsPath = resolve45(cwd, "AGENTS.md");
-    await writeAdapterFile(agentsPath, renderCodexAgents(rendererParams));
-    if (framework === "opencode") {
-      const configPath = resolve45(cwd, "opencode.json");
-      await writeAdapterFile(configPath, renderOpenCodeConfig({ projectDir }));
-    }
-  }
-  if (writtenFiles.length > 0) {
-    console.log(`Generated ${framework} adapter files:`);
-    for (const f of writtenFiles) {
-      console.log(`  ${f}`);
-    }
-  }
-  if (skippedFiles.length > 0) {
-    console.log(`Skipped (already exist, use --force to overwrite):`);
-    for (const f of skippedFiles) {
-      console.log(`  ${f}`);
-    }
-  }
-  if (writtenFiles.length === 0 && skippedFiles.length > 0) {
-    console.log(`No files written. All target files already exist.`);
-  }
-}
-
 // src/commands/track-session.ts
 init_paths();
 init_fs();
 init_config2();
-import { resolve as resolve46 } from "path";
+import { resolve as resolve48 } from "path";
 init_session_db();
 init_agent_sessions();
 async function trackSessionCommand(options) {
@@ -22598,7 +22923,7 @@ async function trackSessionCommand(options) {
   if (options.project) {
     const config = await readConfig();
     const baseDir = options.dir ? expandHome(options.dir) : config.defaultProjectDir;
-    const projectDir = resolve46(baseDir, options.project);
+    const projectDir = resolve48(baseDir, options.project);
     if (!await fileExists(projectDir)) {
       throw new Error(
         `Project "${options.project}" not found at ${projectDir}.`
@@ -22730,8 +23055,8 @@ function formatInstallUrlHandlerError(err2) {
 init_config2();
 init_paths();
 init_fs();
-import { resolve as resolve48, isAbsolute as isAbsolute7 } from "path";
-import { readFile as readFile30 } from "fs/promises";
+import { resolve as resolve50, isAbsolute as isAbsolute7 } from "path";
+import { readFile as readFile32 } from "fs/promises";
 import { select, confirm as confirm2, input as input3 } from "@inquirer/prompts";
 async function browseCommand(options) {
   const config = await readConfig();
@@ -22800,7 +23125,7 @@ async function pickAgent2(agents) {
   return picked;
 }
 async function ensureWorktree(opts) {
-  const assignmentPath = resolve48(
+  const assignmentPath = resolve50(
     opts.projectsDir,
     opts.projectSlug,
     "assignments",
@@ -22810,7 +23135,7 @@ async function ensureWorktree(opts) {
   if (!await fileExists(assignmentPath)) {
     return void 0;
   }
-  const content = await readFile30(assignmentPath, "utf-8");
+  const content = await readFile32(assignmentPath, "utf-8");
   const { parseAssignmentFrontmatter: parseAssignmentFrontmatter2 } = await Promise.resolve().then(() => (init_frontmatter(), frontmatter_exports));
   const fm = parseAssignmentFrontmatter2(content);
   const { workspace } = fm;
@@ -22880,7 +23205,7 @@ async function ensureWorktree(opts) {
 async function runCreate(opts) {
   const { createWorktreeAndRecord: createWorktreeAndRecord2, GitWorktreeError: GitWorktreeError2 } = await Promise.resolve().then(() => (init_git_worktree(), git_worktree_exports));
   const expandedWorktree = expandHome(opts.worktreePath);
-  const absWorktree = isAbsolute7(expandedWorktree) ? expandedWorktree : resolve48(expandedWorktree);
+  const absWorktree = isAbsolute7(expandedWorktree) ? expandedWorktree : resolve50(expandedWorktree);
   try {
     await createWorktreeAndRecord2({
       assignmentPath: opts.assignmentPath,
@@ -22909,7 +23234,7 @@ init_paths();
 init_fs();
 init_playbook();
 init_playbooks();
-import { resolve as resolve49 } from "path";
+import { resolve as resolve51 } from "path";
 async function createPlaybookCommand(name, options) {
   if (!name.trim()) {
     throw new Error("Playbook name cannot be empty.");
@@ -22922,7 +23247,7 @@ async function createPlaybookCommand(name, options) {
   }
   const dir = playbooksDir();
   await ensureDir(dir);
-  const filePath = resolve49(dir, `${slug}.md`);
+  const filePath = resolve51(dir, `${slug}.md`);
   if (await fileExists(filePath)) {
     throw new Error(
       `Playbook "${slug}" already exists at ${filePath}
@@ -22944,8 +23269,8 @@ init_paths();
 init_fs();
 init_parser();
 init_config2();
-import { readdir as readdir16, readFile as readFile31 } from "fs/promises";
-import { resolve as resolve50 } from "path";
+import { readdir as readdir16, readFile as readFile33 } from "fs/promises";
+import { resolve as resolve52 } from "path";
 async function listPlaybooksCommand(options = {}) {
   const dir = playbooksDir();
   if (!await fileExists(dir)) {
@@ -22960,8 +23285,8 @@ async function listPlaybooksCommand(options = {}) {
   );
   const rows = [];
   for (const entry of mdFiles) {
-    const filePath = resolve50(dir, entry.name);
-    const raw = await readFile31(filePath, "utf-8");
+    const filePath = resolve52(dir, entry.name);
+    const raw = await readFile33(filePath, "utf-8");
     const parsed = parsePlaybook(raw);
     const slug = parsed.slug || entry.name.replace(/\.md$/, "");
     const disabled = disabledSet.has(slug);
@@ -23084,14 +23409,14 @@ init_fs();
 init_config2();
 init_slug();
 import { Command as Command2 } from "commander";
-import { readFile as readFile33 } from "fs/promises";
-import { resolve as resolve52 } from "path";
+import { readFile as readFile35 } from "fs/promises";
+import { resolve as resolve54 } from "path";
 
 // src/commands/bundle.ts
 init_paths();
 import { Command } from "commander";
-import { mkdir as mkdir7, readFile as readFile32, readdir as readdir17, rm as rm7, writeFile as writeFile12 } from "fs/promises";
-import { resolve as resolve51 } from "path";
+import { mkdir as mkdir7, readFile as readFile34, readdir as readdir17, rm as rm7, writeFile as writeFile12 } from "fs/promises";
+import { resolve as resolve53 } from "path";
 init_parser2();
 init_fs();
 init_config2();
@@ -23109,7 +23434,7 @@ async function resolveBundleScope(options) {
       throw new Error(`Invalid project slug: "${options.project}".`);
     }
     const config = await readConfig();
-    const projectMd = resolve51(config.defaultProjectDir, options.project, "project.md");
+    const projectMd = resolve53(config.defaultProjectDir, options.project, "project.md");
     if (!await fileExists(projectMd)) {
       throw new Error(`Project "${options.project}" not found.`);
     }
@@ -23179,10 +23504,10 @@ function pickNextPlanFile(planDir, existingFiles) {
     const m = f.match(/^plan-v(\d+)\.md$/);
     if (m) versions.add(parseInt(m[1], 10));
   }
-  if (versions.size === 0) return { target: resolve51(planDir, "plan.md"), version: 1 };
+  if (versions.size === 0) return { target: resolve53(planDir, "plan.md"), version: 1 };
   let n = 2;
   while (versions.has(n)) n++;
-  return { target: resolve51(planDir, `plan-v${n}.md`), version: n };
+  return { target: resolve53(planDir, `plan-v${n}.md`), version: n };
 }
 function dedupePreserveOrder(ids) {
   const out = [];
@@ -23266,7 +23591,7 @@ bundleCommand.command("new").description("Create a new bundle from 2+ existing t
     if (options.plan) {
       const planDir = bundlePlanDir(sc.todosPath, sc.scopeId, id);
       await ensureDir(planDir);
-      const target = resolve51(planDir, "plan.md");
+      const target = resolve53(planDir, "plan.md");
       const memberLines = items.map((it) => `- ${it.description} [t:${it.id}]`).join("\n");
       const stub = [
         "---",
@@ -23442,7 +23767,7 @@ bundleCommand.command("worktree").description("Create a git worktree for the bun
     }
     const repository = options.repository ?? process.cwd();
     const parentBranch = options.parentBranch ?? "main";
-    const worktreePath = options.worktreePath ?? resolve51(repository, ".worktrees", options.branch);
+    const worktreePath = options.worktreePath ?? resolve53(repository, ".worktrees", options.branch);
     const checklist = await readChecklist(sc.todosPath, sc.checklistKey);
     for (const memberId of bundle.todoIds) {
       const item = checklist.items.find((i) => i.id === memberId);
@@ -23452,8 +23777,8 @@ bundleCommand.command("worktree").description("Create a git worktree for the bun
     }
     const bundlesFilePath = bundlesPath(sc.todosPath);
     const checklistFilePath = checklistPath(sc.todosPath, sc.checklistKey);
-    const bundlesSnapshot = await fileExists(bundlesFilePath) ? await readFile32(bundlesFilePath, "utf-8") : null;
-    const checklistSnapshot = await fileExists(checklistFilePath) ? await readFile32(checklistFilePath, "utf-8") : null;
+    const bundlesSnapshot = await fileExists(bundlesFilePath) ? await readFile34(bundlesFilePath, "utf-8") : null;
+    const checklistSnapshot = await fileExists(checklistFilePath) ? await readFile34(checklistFilePath, "utf-8") : null;
     const record = async () => {
       bundle.branch = options.branch;
       bundle.worktreePath = worktreePath;
@@ -23469,7 +23794,7 @@ bundleCommand.command("worktree").description("Create a git worktree for the bun
       try {
         await writeBundles(sc.todosPath, bundles);
         await writeChecklist(sc.todosPath, checklist);
-        const ctxDir = resolve51(worktreePath, ".syntaur");
+        const ctxDir = resolve53(worktreePath, ".syntaur");
         await mkdir7(ctxDir, { recursive: true });
         const payload = {
           bundleId: bundle.id,
@@ -23483,7 +23808,7 @@ bundleCommand.command("worktree").description("Create a git worktree for the bun
           repository,
           boundAt: nowISO()
         };
-        await writeFile12(resolve51(ctxDir, "context.json"), JSON.stringify(payload, null, 2) + "\n");
+        await writeFile12(resolve53(ctxDir, "context.json"), JSON.stringify(payload, null, 2) + "\n");
       } catch (err2) {
         try {
           if (bundlesSnapshot === null) {
@@ -23673,7 +23998,7 @@ async function resolveScope(options) {
       throw new Error(`Invalid project slug: "${options.project}".`);
     }
     const config = await readConfig();
-    const projectMd = resolve52(config.defaultProjectDir, options.project, "project.md");
+    const projectMd = resolve54(config.defaultProjectDir, options.project, "project.md");
     if (!await fileExists(projectMd)) {
       throw new Error(`Project "${options.project}" not found.`);
     }
@@ -23996,10 +24321,10 @@ todoCommand.command("archive").description("Archive completed todos and their lo
       (e) => e.itemIds.every((id) => completedIds.has(id))
     );
     const archFile = archivePath(todosPath, workspace, checklist.archiveInterval);
-    await ensureDir(resolve52(todosPath, "archive"));
+    await ensureDir(resolve54(todosPath, "archive"));
     let archContent = "";
     if (await fileExists(archFile)) {
-      archContent = await readFile33(archFile, "utf-8");
+      archContent = await readFile35(archFile, "utf-8");
       archContent = archContent.trimEnd() + "\n\n";
     } else {
       archContent = `---
@@ -24176,12 +24501,12 @@ function describeScope(scope) {
 }
 async function injectPromotedTodos(assignmentDir, todos, scopeLabel) {
   const { resolve: resolvePath2 } = await import("path");
-  const { readFile: readFile54 } = await import("fs/promises");
+  const { readFile: readFile56 } = await import("fs/promises");
   const { writeFileForce: writeFileForce2 } = await Promise.resolve().then(() => (init_fs(), fs_exports));
   const { appendTodosToAssignmentBody: appendTodosToAssignmentBody2, touchAssignmentUpdated: touchAssignmentUpdated2 } = await Promise.resolve().then(() => (init_assignment_todos(), assignment_todos_exports));
   const { nowTimestamp: nowTimestamp3 } = await Promise.resolve().then(() => (init_timestamp(), timestamp_exports));
   const assignmentMdPath2 = resolvePath2(assignmentDir, "assignment.md");
-  let content = await readFile54(assignmentMdPath2, "utf-8");
+  let content = await readFile56(assignmentMdPath2, "utf-8");
   content = appendTodosToAssignmentBody2(
     content,
     todos.map((t) => ({
@@ -24232,7 +24557,7 @@ todoCommand.command("plan").description("Create or open a plan directory for a t
     );
     let target;
     if (existingFiles.length === 0) {
-      target = resolve52(planDir, "plan.md");
+      target = resolve54(planDir, "plan.md");
     } else {
       const versions = /* @__PURE__ */ new Set();
       for (const f of existingFiles) {
@@ -24242,7 +24567,7 @@ todoCommand.command("plan").description("Create or open a plan directory for a t
       }
       let n = 2;
       while (versions.has(n)) n++;
-      target = resolve52(planDir, `plan-v${n}.md`);
+      target = resolve54(planDir, `plan-v${n}.md`);
     }
     if (!await fileExists(target)) {
       const stub = `---
@@ -24431,24 +24756,24 @@ backupCommand.command("config").description("Show or update backup configuration
 
 // src/commands/doctor.ts
 import { Command as Command4 } from "commander";
-import { readFile as readFile41 } from "fs/promises";
-import { isAbsolute as isAbsolute10, resolve as resolve64 } from "path";
+import { readFile as readFile43 } from "fs/promises";
+import { isAbsolute as isAbsolute10, resolve as resolve67 } from "path";
 
 // src/utils/doctor/index.ts
 import { fileURLToPath as fileURLToPath11 } from "url";
-import { readFile as readFile40 } from "fs/promises";
-import { dirname as dirname19, join as join12 } from "path";
+import { readFile as readFile42 } from "fs/promises";
+import { dirname as dirname19, join as join13 } from "path";
 
 // src/utils/doctor/context.ts
 init_config2();
 init_paths();
 init_fs();
 import Database4 from "better-sqlite3";
-import { resolve as resolve53 } from "path";
+import { resolve as resolve55 } from "path";
 async function buildCheckContext(cwd = process.cwd()) {
   const config = await readConfig();
   const root = syntaurRoot();
-  const dbPath = resolve53(root, "syntaur.db");
+  const dbPath = resolve55(root, "syntaur.db");
   let db5 = null;
   let dbError = null;
   if (await fileExists(dbPath)) {
@@ -24482,8 +24807,8 @@ function closeCheckContext(ctx) {
 // src/utils/doctor/checks/env.ts
 init_fs();
 init_paths();
-import { resolve as resolve54, isAbsolute as isAbsolute8 } from "path";
-import { readFile as readFile34, stat as stat3 } from "fs/promises";
+import { resolve as resolve56, isAbsolute as isAbsolute8 } from "path";
+import { readFile as readFile36, stat as stat3 } from "fs/promises";
 import { fileURLToPath as fileURLToPath10 } from "url";
 import { dirname as dirname17, join as join10 } from "path";
 var CATEGORY = "env";
@@ -24523,7 +24848,7 @@ var configValid = {
   category: CATEGORY,
   title: "~/.syntaur/config.md is valid",
   async run(ctx) {
-    const configPath = resolve54(ctx.syntaurRoot, "config.md");
+    const configPath = resolve56(ctx.syntaurRoot, "config.md");
     if (!await fileExists(configPath)) {
       return {
         id: this.id,
@@ -24540,7 +24865,7 @@ var configValid = {
         autoFixable: false
       };
     }
-    const content = await readFile34(configPath, "utf-8");
+    const content = await readFile36(configPath, "utf-8");
     const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
     if (!fmMatch || fmMatch[1].trim() === "") {
       return {
@@ -24820,7 +25145,7 @@ async function readLocalPkg() {
     for (let i = 0; i < 6; i++) {
       const candidate = join10(dir, "package.json");
       try {
-        const text = await readFile34(candidate, "utf-8");
+        const text = await readFile36(candidate, "utf-8");
         return JSON.parse(text);
       } catch {
         dir = dirname17(dir);
@@ -24872,7 +25197,7 @@ function versionGte(a, b) {
 
 // src/utils/doctor/checks/structure.ts
 init_fs();
-import { resolve as resolve55 } from "path";
+import { resolve as resolve57 } from "path";
 import { readdir as readdir18, stat as stat4 } from "fs/promises";
 var CATEGORY2 = "structure";
 var KNOWN_TOP_LEVEL = /* @__PURE__ */ new Set([
@@ -24892,7 +25217,7 @@ var projectsDir = {
   category: CATEGORY2,
   title: "projects/ directory exists",
   async run(ctx) {
-    const p = resolve55(ctx.syntaurRoot, "projects");
+    const p = resolve57(ctx.syntaurRoot, "projects");
     if (!await fileExists(p)) {
       return {
         id: this.id,
@@ -24917,7 +25242,7 @@ var playbooksDir2 = {
   category: CATEGORY2,
   title: "playbooks/ directory exists",
   async run(ctx) {
-    const p = resolve55(ctx.syntaurRoot, "playbooks");
+    const p = resolve57(ctx.syntaurRoot, "playbooks");
     if (!await fileExists(p)) {
       return {
         id: this.id,
@@ -24942,7 +25267,7 @@ var todosDirValid = {
   category: CATEGORY2,
   title: "todos/ directory is readable (if present)",
   async run(ctx) {
-    const p = resolve55(ctx.syntaurRoot, "todos");
+    const p = resolve57(ctx.syntaurRoot, "todos");
     if (!await fileExists(p)) {
       return {
         id: this.id,
@@ -24973,7 +25298,7 @@ var serversDirValid = {
   category: CATEGORY2,
   title: "servers/ directory is readable (if present)",
   async run(ctx) {
-    const p = resolve55(ctx.syntaurRoot, "servers");
+    const p = resolve57(ctx.syntaurRoot, "servers");
     if (!await fileExists(p)) {
       return {
         id: this.id,
@@ -25018,7 +25343,7 @@ var knownFilesRecognized = {
       title: this.title,
       status: "warn",
       detail: `unexpected top-level entries: ${unexpected.join(", ")}`,
-      affected: unexpected.map((n) => resolve55(ctx.syntaurRoot, n)),
+      affected: unexpected.map((n) => resolve57(ctx.syntaurRoot, n)),
       remediation: {
         kind: "manual",
         suggestion: "Review these entries \u2014 they may be leftover state from older versions",
@@ -25047,7 +25372,7 @@ function pass2(check) {
 
 // src/utils/doctor/checks/project.ts
 init_fs();
-import { resolve as resolve56 } from "path";
+import { resolve as resolve58 } from "path";
 import { readdir as readdir19, stat as stat5 } from "fs/promises";
 var CATEGORY3 = "project";
 var REQUIRED_PROJECT_FILES = [
@@ -25077,10 +25402,10 @@ async function listProjects2(ctx) {
   for (const e of entries) {
     if (!e.isDirectory()) continue;
     if (e.name.startsWith(".") || e.name.startsWith("_")) continue;
-    const projectDir = resolve56(dir, e.name);
+    const projectDir = resolve58(dir, e.name);
     let looksLikeProject = false;
     for (const marker of PROJECT_MARKERS) {
-      if (await fileExists(resolve56(projectDir, marker))) {
+      if (await fileExists(resolve58(projectDir, marker))) {
         looksLikeProject = true;
         break;
       }
@@ -25099,7 +25424,7 @@ var requiredFiles = {
     for (const projectDir of projects) {
       const missing = [];
       for (const rel of REQUIRED_PROJECT_FILES) {
-        const p = resolve56(projectDir, rel);
+        const p = resolve58(projectDir, rel);
         if (!await fileExists(p)) missing.push(rel);
       }
       if (missing.length === 0) continue;
@@ -25109,7 +25434,7 @@ var requiredFiles = {
         title: this.title,
         status: "error",
         detail: `project at ${projectDir} is missing: ${missing.join(", ")}`,
-        affected: missing.map((m) => resolve56(projectDir, m)),
+        affected: missing.map((m) => resolve58(projectDir, m)),
         remediation: {
           kind: "manual",
           suggestion: "Recreate the missing scaffold files from templates",
@@ -25132,7 +25457,7 @@ var manifestStale = {
     const projects = await listProjects2(ctx);
     const results = [];
     for (const projectDir of projects) {
-      const manifestPath = resolve56(projectDir, "manifest.md");
+      const manifestPath = resolve58(projectDir, "manifest.md");
       if (!await fileExists(manifestPath)) continue;
       const manifestMtime = (await stat5(manifestPath)).mtimeMs;
       const newestAssignment = await newestAssignmentMtime(projectDir);
@@ -25181,7 +25506,7 @@ var orphanFiles = {
         title: this.title,
         status: "warn",
         detail: `project at ${projectDir} has unexpected entries: ${orphans.join(", ")}`,
-        affected: orphans.map((o) => resolve56(projectDir, o)),
+        affected: orphans.map((o) => resolve58(projectDir, o)),
         autoFixable: false
       });
     }
@@ -25191,7 +25516,7 @@ var orphanFiles = {
 };
 var projectChecks = [requiredFiles, manifestStale, orphanFiles];
 async function newestAssignmentMtime(projectDir) {
-  const assignmentsRoot = resolve56(projectDir, "assignments");
+  const assignmentsRoot = resolve58(projectDir, "assignments");
   if (!await fileExists(assignmentsRoot)) return 0;
   let newest = 0;
   let entries;
@@ -25202,7 +25527,7 @@ async function newestAssignmentMtime(projectDir) {
   }
   for (const e of entries) {
     if (!e.isDirectory()) continue;
-    const assignmentMd = resolve56(assignmentsRoot, e.name, "assignment.md");
+    const assignmentMd = resolve58(assignmentsRoot, e.name, "assignment.md");
     try {
       const s = await stat5(assignmentMd);
       if (s.mtimeMs > newest) newest = s.mtimeMs;
@@ -25226,8 +25551,8 @@ init_fs();
 init_parser();
 init_types();
 init_paths();
-import { resolve as resolve57 } from "path";
-import { readFile as readFile35, readdir as readdir20 } from "fs/promises";
+import { resolve as resolve59 } from "path";
+import { readFile as readFile37, readdir as readdir20 } from "fs/promises";
 var CATEGORY4 = "assignment";
 var STATUSES_REQUIRING_HANDOFF = /* @__PURE__ */ new Set(["review", "completed"]);
 var PRE_WORKSPACE_STATUSES = /* @__PURE__ */ new Set([
@@ -25321,7 +25646,7 @@ var invalidStatus = {
     const allowed = configuredStatuses(ctx);
     const results = [];
     for (const a of withAssignmentMd) {
-      const path = resolve57(a.assignmentDir, "assignment.md");
+      const path = resolve59(a.assignmentDir, "assignment.md");
       const parsed = await parseSafe2(path);
       if (!parsed) continue;
       if (!allowed.has(parsed.status)) {
@@ -25354,7 +25679,7 @@ var workspaceMissing = {
     const terminal = terminalStatuses(ctx);
     const results = [];
     for (const a of withAssignmentMd) {
-      const path = resolve57(a.assignmentDir, "assignment.md");
+      const path = resolve59(a.assignmentDir, "assignment.md");
       const parsed = await parseSafe2(path);
       if (!parsed) continue;
       if (terminal.has(parsed.status)) continue;
@@ -25401,12 +25726,12 @@ var requiredFilesByStatus = {
     const { withAssignmentMd } = await listAssignments(ctx);
     const results = [];
     for (const a of withAssignmentMd) {
-      const assignmentPath = resolve57(a.assignmentDir, "assignment.md");
+      const assignmentPath = resolve59(a.assignmentDir, "assignment.md");
       const parsed = await parseSafe2(assignmentPath);
       if (!parsed) continue;
       const missing = [];
       if (STATUSES_REQUIRING_HANDOFF.has(parsed.status)) {
-        const handoffPath = resolve57(a.assignmentDir, "handoff.md");
+        const handoffPath = resolve59(a.assignmentDir, "handoff.md");
         if (!await fileExists(handoffPath)) missing.push("handoff.md");
       }
       if (missing.length === 0) continue;
@@ -25416,7 +25741,7 @@ var requiredFilesByStatus = {
         title: this.title,
         status: "warn",
         detail: `${a.projectSlug}/${a.assignmentSlug} (status: ${parsed.status}) is missing ${missing.join(", ")}`,
-        affected: missing.map((m) => resolve57(a.assignmentDir, m)),
+        affected: missing.map((m) => resolve59(a.assignmentDir, m)),
         remediation: {
           kind: "manual",
           suggestion: `Create the missing ${missing.join(" and ")} files for this assignment`,
@@ -25439,7 +25764,7 @@ var companionFilesScaffolded = {
     for (const a of withAssignmentMd) {
       const missing = [];
       for (const filename of ["progress.md", "comments.md"]) {
-        if (!await fileExists(resolve57(a.assignmentDir, filename))) {
+        if (!await fileExists(resolve59(a.assignmentDir, filename))) {
           missing.push(filename);
         }
       }
@@ -25451,7 +25776,7 @@ var companionFilesScaffolded = {
         title: this.title,
         status: "warn",
         detail: `${label} is missing ${missing.join(" and ")} (pre-v2.0 assignment \u2014 not required, but scaffolding them keeps the dashboard and CLIs consistent)`,
-        affected: missing.map((m) => resolve57(a.assignmentDir, m)),
+        affected: missing.map((m) => resolve59(a.assignmentDir, m)),
         remediation: {
           kind: "manual",
           suggestion: `Create ${missing.join(" and ")} with the renderProgress/renderComments templates, or re-scaffold via the CLI`,
@@ -25484,7 +25809,7 @@ var typeDefinition = {
     const { withAssignmentMd } = await listAssignments(ctx);
     const results = [];
     for (const a of withAssignmentMd) {
-      const path = resolve57(a.assignmentDir, "assignment.md");
+      const path = resolve59(a.assignmentDir, "assignment.md");
       const parsed = await parseSafe2(path);
       if (!parsed) continue;
       if (!parsed.type) continue;
@@ -25518,7 +25843,7 @@ var projectFrontmatterMatchesContainer = {
     const { withAssignmentMd } = await listAssignments(ctx);
     const results = [];
     for (const a of withAssignmentMd) {
-      const path = resolve57(a.assignmentDir, "assignment.md");
+      const path = resolve59(a.assignmentDir, "assignment.md");
       const parsed = await parseSafe2(path);
       if (!parsed) continue;
       if (a.standalone) {
@@ -25569,13 +25894,13 @@ var draftMissingObjective = {
     const { withAssignmentMd } = await listAssignments(ctx);
     const results = [];
     for (const a of withAssignmentMd) {
-      const path = resolve57(a.assignmentDir, "assignment.md");
+      const path = resolve59(a.assignmentDir, "assignment.md");
       const parsed = await parseSafe2(path);
       if (!parsed) continue;
       if (parsed.status !== "draft") continue;
       let raw;
       try {
-        raw = await readFile35(path, "utf-8");
+        raw = await readFile37(path, "utf-8");
       } catch {
         continue;
       }
@@ -25608,7 +25933,7 @@ var readyToImplementMissingPlan = {
     const { withAssignmentMd } = await listAssignments(ctx);
     const results = [];
     for (const a of withAssignmentMd) {
-      const path = resolve57(a.assignmentDir, "assignment.md");
+      const path = resolve59(a.assignmentDir, "assignment.md");
       const parsed = await parseSafe2(path);
       if (!parsed) continue;
       if (parsed.status !== "ready_to_implement") continue;
@@ -25617,7 +25942,7 @@ var readyToImplementMissingPlan = {
       let hasPlanContent = false;
       for (const f of planFiles) {
         try {
-          const c2 = await readFile35(resolve57(a.assignmentDir, f), "utf-8");
+          const c2 = await readFile37(resolve59(a.assignmentDir, f), "utf-8");
           if (c2.trim().length > 0) {
             hasPlanContent = true;
             break;
@@ -25633,7 +25958,7 @@ var readyToImplementMissingPlan = {
         title: this.title,
         status: "warn",
         detail: `${label} (status: ready_to_implement) has no plan.md or plan-v<N>.md`,
-        affected: [resolve57(a.assignmentDir, "plan.md")],
+        affected: [resolve59(a.assignmentDir, "plan.md")],
         remediation: {
           kind: "manual",
           suggestion: `Write a plan with '/plan-assignment' (or 'syntaur plan'), then re-mark ready_to_implement`,
@@ -25660,7 +25985,7 @@ var assignmentChecks = [
 ];
 async function parseSafe2(path) {
   try {
-    const content = await readFile35(path, "utf-8");
+    const content = await readFile37(path, "utf-8");
     return parseAssignmentFull(content);
   } catch {
     return null;
@@ -25679,7 +26004,7 @@ function pass4(check, detail) {
 
 // src/utils/doctor/checks/dashboard.ts
 init_fs();
-import { resolve as resolve58 } from "path";
+import { resolve as resolve60 } from "path";
 var CATEGORY5 = "dashboard";
 var dbReachable = {
   id: "dashboard.db-reachable",
@@ -25693,7 +26018,7 @@ var dbReachable = {
         title: this.title,
         status: "error",
         detail: `could not open syntaur.db: ${ctx.dbError ?? "unknown error"}`,
-        affected: [resolve58(ctx.syntaurRoot, "syntaur.db")],
+        affected: [resolve60(ctx.syntaurRoot, "syntaur.db")],
         remediation: {
           kind: "manual",
           suggestion: "Start the dashboard once (`syntaur dashboard`) to initialize the DB, or restore it from backup",
@@ -25711,7 +26036,7 @@ var dbReachable = {
           title: this.title,
           status: "error",
           detail: 'syntaur.db is missing the expected "sessions" table',
-          affected: [resolve58(ctx.syntaurRoot, "syntaur.db")],
+          affected: [resolve60(ctx.syntaurRoot, "syntaur.db")],
           autoFixable: false
         };
       }
@@ -25723,7 +26048,7 @@ var dbReachable = {
         title: this.title,
         status: "error",
         detail: `syntaur.db query failed: ${err2 instanceof Error ? err2.message : String(err2)}`,
-        affected: [resolve58(ctx.syntaurRoot, "syntaur.db")],
+        affected: [resolve60(ctx.syntaurRoot, "syntaur.db")],
         autoFixable: false
       };
     }
@@ -25749,7 +26074,7 @@ var ghostSessions = {
     const results = [];
     for (const row of rows) {
       if (!row.project_slug) continue;
-      const projectPath = resolve58(projectsDir2, row.project_slug, "project.md");
+      const projectPath = resolve60(projectsDir2, row.project_slug, "project.md");
       if (!await fileExists(projectPath)) {
         results.push({
           id: this.id,
@@ -25768,7 +26093,7 @@ var ghostSessions = {
         continue;
       }
       if (row.assignment_slug) {
-        const assignmentPath = resolve58(
+        const assignmentPath = resolve60(
           projectsDir2,
           row.project_slug,
           "assignments",
@@ -25820,9 +26145,9 @@ function skipped(check, reason) {
 
 // src/utils/doctor/checks/integrations.ts
 init_fs();
-import { resolve as resolve59, dirname as dirname18, basename as basename5 } from "path";
-import { readdir as readdir21, readFile as readFile36 } from "fs/promises";
-import { homedir as homedir9 } from "os";
+import { resolve as resolve61, dirname as dirname18, basename as basename5 } from "path";
+import { readdir as readdir21, readFile as readFile38 } from "fs/promises";
+import { homedir as homedir10 } from "os";
 var CATEGORY6 = "integrations";
 var claudePluginLinked = {
   id: "integrations.claude-plugin-linked",
@@ -25903,10 +26228,10 @@ var backupConfigured = {
   }
 };
 async function readKnownMarketplaces() {
-  const path = resolve59(homedir9(), ".claude", "plugins", "known_marketplaces.json");
+  const path = resolve61(homedir10(), ".claude", "plugins", "known_marketplaces.json");
   if (!await fileExists(path)) return {};
   try {
-    const raw = await readFile36(path, "utf-8");
+    const raw = await readFile38(path, "utf-8");
     return JSON.parse(raw);
   } catch {
     return {};
@@ -25940,7 +26265,7 @@ var claudeMarketplaceRegistered = {
       };
     }
     const marketplaceRoot = dirname18(pluginsParent);
-    const marketplaceManifest = resolve59(marketplaceRoot, ".claude-plugin", "marketplace.json");
+    const marketplaceManifest = resolve61(marketplaceRoot, ".claude-plugin", "marketplace.json");
     if (!await fileExists(marketplaceManifest)) {
       return {
         id: this.id,
@@ -25959,7 +26284,7 @@ var claudeMarketplaceRegistered = {
     }
     let parsed = {};
     try {
-      parsed = JSON.parse(await readFile36(marketplaceManifest, "utf-8"));
+      parsed = JSON.parse(await readFile38(marketplaceManifest, "utf-8"));
     } catch {
       return {
         id: this.id,
@@ -25991,7 +26316,7 @@ var claudeMarketplaceRegistered = {
       title: this.title,
       status: "error",
       detail: issues.join("; "),
-      affected: [marketplaceManifest, resolve59(homedir9(), ".claude", "plugins", "known_marketplaces.json")],
+      affected: [marketplaceManifest, resolve61(homedir10(), ".claude", "plugins", "known_marketplaces.json")],
       remediation: {
         kind: "manual",
         suggestion: "Re-run install-plugin to ensure both files are in sync.",
@@ -26031,8 +26356,8 @@ function skipped2(check, reason) {
 init_fs();
 init_parser();
 init_types();
-import { resolve as resolve60 } from "path";
-import { readFile as readFile37 } from "fs/promises";
+import { resolve as resolve62 } from "path";
+import { readFile as readFile39 } from "fs/promises";
 var CATEGORY7 = "workspace";
 var ASSIGNMENT_FIELDS = ["projectSlug", "assignmentSlug", "projectDir", "assignmentDir"];
 var BUNDLE_FIELDS = ["bundleId", "bundleScope", "bundleScopeId"];
@@ -26053,12 +26378,12 @@ function isStandaloneSession(ctx) {
   return !hasAnyAssignmentField(ctx) && !hasAnyBundleField(ctx) && typeof ctx.sessionId === "string" && ctx.sessionId.length > 0;
 }
 async function loadContext(ctx) {
-  const path = resolve60(ctx.cwd, ".syntaur", "context.json");
+  const path = resolve62(ctx.cwd, ".syntaur", "context.json");
   if (!await fileExists(path)) {
     return { data: null, path, exists: false, parseError: null };
   }
   try {
-    const raw = await readFile37(path, "utf-8");
+    const raw = await readFile39(path, "utf-8");
     return { data: JSON.parse(raw), path, exists: true, parseError: null };
   } catch (err2) {
     return {
@@ -26152,7 +26477,7 @@ var contextAssignmentResolves = {
     if (isStandaloneSession(data)) return skipped3(this, "standalone session context \u2014 no assignment to resolve");
     if (isBundleContext(data)) return skipped3(this, "bundle context \u2014 no assignment to resolve");
     if (!data?.assignmentDir) return skipped3(this, "context has no assignmentDir");
-    const assignmentMd = resolve60(data.assignmentDir, "assignment.md");
+    const assignmentMd = resolve62(data.assignmentDir, "assignment.md");
     if (!await fileExists(assignmentMd)) {
       return {
         id: this.id,
@@ -26182,10 +26507,10 @@ var contextTerminal = {
     if (isStandaloneSession(data)) return skipped3(this, "standalone session context \u2014 no assignment to check");
     if (isBundleContext(data)) return skipped3(this, "bundle context \u2014 no assignment to check");
     if (!data?.assignmentDir) return skipped3(this, "context has no assignmentDir");
-    const assignmentMd = resolve60(data.assignmentDir, "assignment.md");
+    const assignmentMd = resolve62(data.assignmentDir, "assignment.md");
     if (!await fileExists(assignmentMd)) return skipped3(this, "assignment file missing");
     try {
-      const content = await readFile37(assignmentMd, "utf-8");
+      const content = await readFile39(assignmentMd, "utf-8");
       const parsed = parseAssignmentFull(content);
       const terminal = terminalStatuses2(ctx);
       if (terminal.has(parsed.status)) {
@@ -26241,7 +26566,7 @@ function skipped3(check, reason) {
 init_config2();
 import { isAbsolute as isAbsolute9 } from "path";
 import { access as access2, constants as fsConstants } from "fs/promises";
-import { spawnSync as spawnSync7 } from "child_process";
+import { spawnSync as spawnSync8 } from "child_process";
 var CATEGORY8 = "agents";
 var agentsResolvable = {
   id: "agents.commands-resolvable",
@@ -26305,7 +26630,7 @@ async function checkAgent(agent) {
       };
     }
   }
-  const result = spawnSync7("which", [agent.command], { encoding: "utf-8" });
+  const result = spawnSync8("which", [agent.command], { encoding: "utf-8" });
   if (result.status === 0 && result.stdout.trim().length > 0) {
     return {
       ...base,
@@ -26330,16 +26655,16 @@ var agentChecks = [agentsResolvable];
 
 // src/utils/doctor/checks/terminal.ts
 init_config2();
-import { spawnSync as spawnSync8 } from "child_process";
-import { readFile as readFile38 } from "fs/promises";
-import { resolve as resolve61 } from "path";
+import { spawnSync as spawnSync9 } from "child_process";
+import { readFile as readFile40 } from "fs/promises";
+import { resolve as resolve63 } from "path";
 init_paths();
 init_fs();
 var CATEGORY9 = "terminal";
 async function readRawTerminalKey() {
-  const configPath = resolve61(syntaurRoot(), "config.md");
+  const configPath = resolve63(syntaurRoot(), "config.md");
   if (!await fileExists(configPath)) return null;
-  const content = await readFile38(configPath, "utf-8");
+  const content = await readFile40(configPath, "utf-8");
   const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
   if (!fmMatch) return null;
   const line = fmMatch[1].split("\n").find((l) => /^terminal:\s*/.test(l));
@@ -26452,7 +26777,7 @@ var kittyRemoteControl = {
         autoFixable: false
       };
     }
-    const result = spawnSync8("kitty", ["@", "ls"], {
+    const result = spawnSync9("kitty", ["@", "ls"], {
       encoding: "utf-8",
       timeout: 2e3
     });
@@ -26489,13 +26814,13 @@ var terminalChecks = [
 
 // src/utils/doctor/checks/skills.ts
 init_fs();
-import { resolve as resolve62, join as join11 } from "path";
-import { readdir as readdir22, readFile as readFile39, lstat as lstat4 } from "fs/promises";
-import { homedir as homedir10 } from "os";
+import { resolve as resolve64, join as join11 } from "path";
+import { readdir as readdir22, readFile as readFile41, lstat as lstat4 } from "fs/promises";
+import { homedir as homedir11 } from "os";
 var CATEGORY10 = "skills";
 var skillTargets = [
-  { agent: "claude", dir: resolve62(homedir10(), ".claude", "skills"), label: "~/.claude/skills" },
-  { agent: "codex", dir: resolve62(homedir10(), ".codex", "skills"), label: "~/.codex/skills" }
+  { agent: "claude", dir: resolve64(homedir11(), ".claude", "skills"), label: "~/.claude/skills" },
+  { agent: "codex", dir: resolve64(homedir11(), ".codex", "skills"), label: "~/.codex/skills" }
 ];
 var skillsDedupCheck = {
   id: "skills.dedup",
@@ -26519,7 +26844,7 @@ var skillsDedupCheck = {
         if (!KNOWN_SKILLS.includes(entry.name)) continue;
         const skillMd = join11(dir, entry.name, "SKILL.md");
         if (!await fileExists(skillMd)) continue;
-        const content = await readFile39(skillMd, "utf-8").catch(() => "");
+        const content = await readFile41(skillMd, "utf-8").catch(() => "");
         const match = content.match(/^name:\s*(\S+)\s*$/m);
         if (!match || match[1] !== entry.name) continue;
         let isSymlink2 = false;
@@ -26567,14 +26892,101 @@ var skillsDedupCheck = {
 };
 var skillsChecks = [skillsDedupCheck];
 
+// src/utils/doctor/checks/cross-agent.ts
+init_fs();
+import { join as join12, resolve as resolve65 } from "path";
+var CATEGORY11 = "cross-agent";
+async function countSyntaurSkills(dir) {
+  if (!await fileExists(dir)) return 0;
+  let n = 0;
+  for (const skill of KNOWN_SKILLS) {
+    if (await fileExists(join12(dir, skill, "SKILL.md"))) n++;
+  }
+  return n;
+}
+var crossAgentSkillsCheck = {
+  id: "cross-agent.skills",
+  category: CATEGORY11,
+  title: "Cross-agent targets have Syntaur skills + protocol files",
+  async run(ctx) {
+    const installed = ctx.config.integrations.installedAgents ?? {};
+    const total = KNOWN_SKILLS.length;
+    const lines = [];
+    const problems = [];
+    const affected = [];
+    let considered = 0;
+    for (const t of AGENT_TARGETS) {
+      if (t.nativePlugin) continue;
+      const dir = t.skillsDir?.global;
+      if (!dir) continue;
+      const recorded = Boolean(installed[t.id]);
+      const detected = await t.detect();
+      if (!recorded && !detected) continue;
+      considered++;
+      const present = await countSyntaurSkills(dir);
+      lines.push(`${t.displayName}: ${present}/${total} skills (${dir})`);
+      if (recorded && present < total) {
+        problems.push(
+          `${t.displayName}: ${present === 0 ? "no Syntaur skills" : `incomplete skills (${present}/${total})`}`
+        );
+        affected.push(dir);
+      }
+      if (recorded && t.instructions) {
+        for (const f of t.instructions.files) {
+          const p = resolve65(ctx.cwd, f.path);
+          if (!await fileExists(p)) {
+            problems.push(`${t.displayName}: missing protocol file ${f.path} in cwd`);
+            affected.push(p);
+          }
+        }
+      }
+    }
+    if (considered === 0) {
+      return {
+        id: this.id,
+        category: this.category,
+        title: this.title,
+        status: "skipped",
+        detail: "No cross-agent targets detected or recorded.",
+        autoFixable: false
+      };
+    }
+    if (problems.length > 0) {
+      return {
+        id: this.id,
+        category: this.category,
+        title: this.title,
+        status: "warn",
+        detail: `${problems.join("; ")}. (${lines.join("; ")})`,
+        affected,
+        remediation: {
+          kind: "manual",
+          suggestion: "Re-run `syntaur setup --target <id>` (from the assignment workspace, to also write protocol files) to complete the install.",
+          command: null
+        },
+        autoFixable: false
+      };
+    }
+    return {
+      id: this.id,
+      category: this.category,
+      title: this.title,
+      status: "pass",
+      detail: lines.join("; "),
+      autoFixable: false
+    };
+  }
+};
+var crossAgentChecks = [crossAgentSkillsCheck];
+
 // src/utils/doctor/checks/bundles.ts
 init_fs();
 init_paths();
-import { resolve as resolve63 } from "path";
+import { resolve as resolve66 } from "path";
 import { readdir as readdir23 } from "fs/promises";
-import { spawnSync as spawnSync9 } from "child_process";
+import { spawnSync as spawnSync10 } from "child_process";
 init_parser2();
-var CATEGORY11 = "bundles";
+var CATEGORY12 = "bundles";
 async function listScopes(ctx) {
   const out = [];
   const td = todosDir();
@@ -26600,7 +27012,7 @@ async function listScopes(ctx) {
       if (!e.isDirectory()) continue;
       const slug = e.name;
       if (typeof slug !== "string" || slug.startsWith(".")) continue;
-      const projectMd = resolve63(ctx.config.defaultProjectDir, slug, "project.md");
+      const projectMd = resolve66(ctx.config.defaultProjectDir, slug, "project.md");
       if (!await fileExists(projectMd)) continue;
       out.push({
         scopeLabel: `project:${slug}`,
@@ -26655,7 +27067,7 @@ async function gatherBundlesByScope(scopes) {
 }
 var orphanBundleId = {
   id: "bundles.orphan-bundleid",
-  category: CATEGORY11,
+  category: CATEGORY12,
   title: "Every todo with a bundleId points at an existing bundle in the same scope",
   async run(ctx) {
     const scopes = await listScopes(ctx);
@@ -26678,7 +27090,7 @@ var orphanBundleId = {
 };
 var missingMembers = {
   id: "bundles.missing-members",
-  category: CATEGORY11,
+  category: CATEGORY12,
   title: "Every bundle member exists in the bundle's scope checklist",
   async run(ctx) {
     const scopes = await listScopes(ctx);
@@ -26697,7 +27109,7 @@ var missingMembers = {
 };
 var scopeMismatch = {
   id: "bundles.scope-mismatch",
-  category: CATEGORY11,
+  category: CATEGORY12,
   title: "Every bundle member's bundleId matches the bundle id",
   async run(ctx) {
     const scopes = await listScopes(ctx);
@@ -26715,7 +27127,7 @@ var scopeMismatch = {
 };
 var minMembers = {
   id: "bundles.min-members",
-  category: CATEGORY11,
+  category: CATEGORY12,
   title: "Every bundle has at least 2 members",
   async run(ctx) {
     const scopes = await listScopes(ctx);
@@ -26731,7 +27143,7 @@ var minMembers = {
 };
 var stalePlanDir = {
   id: "bundles.stale-plan-dir",
-  category: CATEGORY11,
+  category: CATEGORY12,
   title: "Every bundle's persisted planDir still exists on disk",
   async run(ctx) {
     const scopes = await listScopes(ctx);
@@ -26755,7 +27167,7 @@ var stalePlanDir = {
 };
 var staleWorktree = {
   id: "bundles.stale-worktree",
-  category: CATEGORY11,
+  category: CATEGORY12,
   title: "Every bundle's persisted worktree still exists in the repo",
   async run(ctx) {
     const scopes = await listScopes(ctx);
@@ -26765,7 +27177,7 @@ var staleWorktree = {
       if (bs.bundle.worktreePath === null || bs.bundle.repository === null) continue;
       const onDisk = await fileExists(bs.bundle.worktreePath);
       let gitKnowsIt = false;
-      const gitOut = spawnSync9("git", ["-C", bs.bundle.repository, "worktree", "list", "--porcelain"], { encoding: "utf-8" });
+      const gitOut = spawnSync10("git", ["-C", bs.bundle.repository, "worktree", "list", "--porcelain"], { encoding: "utf-8" });
       if (gitOut.status === 0) {
         gitKnowsIt = gitOut.stdout.split("\n").some((l) => l.trim() === `worktree ${bs.bundle.worktreePath}`);
       }
@@ -26805,6 +27217,7 @@ function allChecks() {
     ...agentChecks,
     ...terminalChecks,
     ...skillsChecks,
+    ...crossAgentChecks,
     ...bundleChecks
   ];
 }
@@ -26891,7 +27304,7 @@ async function readVersion() {
     let dir = dirname19(here);
     for (let i = 0; i < 6; i++) {
       try {
-        const raw = await readFile40(join12(dir, "package.json"), "utf-8");
+        const raw = await readFile42(join13(dir, "package.json"), "utf-8");
         const parsed = JSON.parse(raw);
         return typeof parsed.version === "string" ? parsed.version : null;
       } catch {
@@ -26988,7 +27401,7 @@ var REQUIRED_WORKSPACE_FIELDS = [
 ];
 var ISO_DATE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z$/;
 async function validateAssignmentFile(inputPath, cwd = process.cwd()) {
-  const absolute = isAbsolute10(inputPath) ? inputPath : resolve64(cwd, inputPath);
+  const absolute = isAbsolute10(inputPath) ? inputPath : resolve67(cwd, inputPath);
   const errors = [];
   const warnings = [];
   if (!await fileExists(absolute)) {
@@ -27001,7 +27414,7 @@ async function validateAssignmentFile(inputPath, cwd = process.cwd()) {
   }
   let content;
   try {
-    content = await readFile41(absolute, "utf-8");
+    content = await readFile43(absolute, "utf-8");
   } catch (err2) {
     return {
       ok: false,
@@ -27325,8 +27738,8 @@ init_uuid();
 init_timestamp();
 init_assignment_resolver();
 init_templates();
-import { resolve as resolve65 } from "path";
-import { readFile as readFile42 } from "fs/promises";
+import { resolve as resolve68 } from "path";
+import { readFile as readFile44 } from "fs/promises";
 function shortId() {
   return generateId().split("-")[0];
 }
@@ -27356,7 +27769,7 @@ async function commentCommand(target, text, options = {}) {
     if (!isValidSlug(target)) {
       throw new Error(`Invalid assignment slug "${target}".`);
     }
-    assignmentDir = resolve65(baseDir, options.project, "assignments", target);
+    assignmentDir = resolve68(baseDir, options.project, "assignments", target);
     assignmentRef = target;
   } else {
     const resolved = await resolveAssignmentById(baseDir, assignmentsDir(), target);
@@ -27366,13 +27779,13 @@ async function commentCommand(target, text, options = {}) {
     assignmentDir = resolved.assignmentDir;
     assignmentRef = resolved.standalone ? resolved.id : resolved.assignmentSlug;
   }
-  const commentsPath = resolve65(assignmentDir, "comments.md");
+  const commentsPath = resolve68(assignmentDir, "comments.md");
   const timestamp = nowTimestamp();
   const author = options.author ?? process.env.USER ?? "unknown";
   let currentContent;
   let currentCount = 0;
   if (await fileExists(commentsPath)) {
-    currentContent = await readFile42(commentsPath, "utf-8");
+    currentContent = await readFile44(commentsPath, "utf-8");
     const countMatch = currentContent.match(/^entryCount:\s*(\d+)/m);
     if (countMatch) currentCount = parseInt(countMatch[1], 10);
   } else {
@@ -27406,7 +27819,7 @@ ${entry}`;
 }
 
 // src/commands/capture.ts
-import { resolve as resolve69, relative as relative4, dirname as dirname20 } from "path";
+import { resolve as resolve72, relative as relative4, dirname as dirname20 } from "path";
 import { copyFile as copyFile3, mkdir as mkdir9, realpath as realpath2, rm as rm12, stat as stat8, writeFile as writeFile14 } from "fs/promises";
 import { existsSync as existsSync6 } from "fs";
 
@@ -27417,8 +27830,8 @@ init_config2();
 init_slug();
 init_assignment_resolver();
 init_parser();
-import { resolve as resolve66 } from "path";
-import { readFile as readFile43 } from "fs/promises";
+import { resolve as resolve69 } from "path";
+import { readFile as readFile45 } from "fs/promises";
 var AssignmentTargetError = class extends Error {
 };
 function classifyContext(ctx) {
@@ -27430,10 +27843,10 @@ function classifyContext(ctx) {
   return "empty";
 }
 async function readAssignmentFrontmatterId(assignmentDir) {
-  const path = resolve66(assignmentDir, "assignment.md");
+  const path = resolve69(assignmentDir, "assignment.md");
   if (!await fileExists(path)) return null;
   try {
-    const content = await readFile43(path, "utf-8");
+    const content = await readFile45(path, "utf-8");
     const [fm] = extractFrontmatter(content);
     return getField(fm, "id");
   } catch {
@@ -27441,10 +27854,10 @@ async function readAssignmentFrontmatterId(assignmentDir) {
   }
 }
 async function readContextJson(cwd) {
-  const path = resolve66(cwd, ".syntaur", "context.json");
+  const path = resolve69(cwd, ".syntaur", "context.json");
   if (!await fileExists(path)) return null;
   try {
-    const raw = await readFile43(path, "utf-8");
+    const raw = await readFile45(path, "utf-8");
     return JSON.parse(raw);
   } catch {
     return null;
@@ -27465,15 +27878,15 @@ async function resolveAssignmentTarget(input4, opts = {}) {
     if (!isValidSlug(input4)) {
       throw new AssignmentTargetError(`Invalid assignment slug "${input4}".`);
     }
-    const projectDir = resolve66(baseDir, opts.project);
-    const projectMdPath = resolve66(projectDir, "project.md");
+    const projectDir = resolve69(baseDir, opts.project);
+    const projectMdPath = resolve69(projectDir, "project.md");
     if (!await fileExists(projectDir) || !await fileExists(projectMdPath)) {
       throw new AssignmentTargetError(
         `Project "${opts.project}" not found at ${projectDir}.`
       );
     }
-    const assignmentDir = resolve66(projectDir, "assignments", input4);
-    const assignmentMdPath2 = resolve66(assignmentDir, "assignment.md");
+    const assignmentDir = resolve69(projectDir, "assignments", input4);
+    const assignmentMdPath2 = resolve69(assignmentDir, "assignment.md");
     if (!await fileExists(assignmentMdPath2)) {
       throw new AssignmentTargetError(
         `Assignment "${input4}" not found in project "${opts.project}".`
@@ -27512,7 +27925,7 @@ async function resolveAssignmentTarget(input4, opts = {}) {
   }
   if (ctx.assignmentDir) {
     const dir = expandHome(ctx.assignmentDir);
-    const assignmentMdPath2 = resolve66(dir, "assignment.md");
+    const assignmentMdPath2 = resolve69(dir, "assignment.md");
     if (!await fileExists(assignmentMdPath2)) {
       throw new AssignmentTargetError(
         `.syntaur/context.json points to a missing assignment dir: ${dir}.`
@@ -27541,8 +27954,8 @@ async function resolveAssignmentTarget(input4, opts = {}) {
         `.syntaur/context.json contains invalid slugs: project="${ctx.projectSlug}" assignment="${ctx.assignmentSlug}".`
       );
     }
-    const assignmentDir = resolve66(baseDir, ctx.projectSlug, "assignments", ctx.assignmentSlug);
-    const assignmentMdPath2 = resolve66(assignmentDir, "assignment.md");
+    const assignmentDir = resolve69(baseDir, ctx.projectSlug, "assignments", ctx.assignmentSlug);
+    const assignmentMdPath2 = resolve69(assignmentDir, "assignment.md");
     if (!await fileExists(assignmentMdPath2)) {
       throw new AssignmentTargetError(
         `.syntaur/context.json points to a missing assignment: ${assignmentDir}.`
@@ -27605,7 +28018,7 @@ init_fs();
 import { spawn as spawn7 } from "child_process";
 import { mkdtemp as mkdtemp2, rm as rm8, stat as stat6 } from "fs/promises";
 import { tmpdir as tmpdir3 } from "os";
-import { join as join13 } from "path";
+import { join as join14 } from "path";
 function argsFor(mode, pngPath) {
   switch (mode) {
     case "interactive":
@@ -27638,8 +28051,8 @@ async function captureScreenshot(mode) {
       "screencapture is only available on macOS. Use --file <path> to attach an existing image."
     );
   }
-  const tmpDir = await mkdtemp2(join13(tmpdir3(), "syntaur-screenshot-"));
-  const pngPath = join13(tmpDir, "shot.png");
+  const tmpDir = await mkdtemp2(join14(tmpdir3(), "syntaur-screenshot-"));
+  const pngPath = join14(tmpDir, "shot.png");
   const cleanup = async () => {
     await rm8(tmpDir, { recursive: true, force: true }).catch(() => {
     });
@@ -27677,9 +28090,9 @@ async function captureScreenshot(mode) {
 
 // src/utils/asciinema.ts
 import { spawn as spawn8 } from "child_process";
-import { mkdtemp as mkdtemp3, readFile as readFile44, rm as rm9 } from "fs/promises";
+import { mkdtemp as mkdtemp3, readFile as readFile46, rm as rm9 } from "fs/promises";
 import { tmpdir as tmpdir4 } from "os";
-import { join as join14 } from "path";
+import { join as join15 } from "path";
 var SAFE_RE = /^[A-Za-z0-9_@%+=:,./-]+$/;
 function shellQuote2(s) {
   if (s.length === 0) return `''`;
@@ -27716,8 +28129,8 @@ function runAsciinema(args, stdio) {
   });
 }
 async function captureAsciinema(opts) {
-  const tmpDir = await mkdtemp3(join14(tmpdir4(), "syntaur-asciinema-"));
-  const castPath = join14(tmpDir, "session.cast");
+  const tmpDir = await mkdtemp3(join15(tmpdir4(), "syntaur-asciinema-"));
+  const castPath = join15(tmpDir, "session.cast");
   const cleanup = async () => {
     await rm9(tmpDir, { recursive: true, force: true }).catch(() => {
     });
@@ -27740,7 +28153,7 @@ async function captureAsciinema(opts) {
       }
       throw err2;
     }
-    const text = await readFile44(castPath, "utf8").catch(() => null);
+    const text = await readFile46(castPath, "utf8").catch(() => null);
     if (text === null) {
       throw new Error(
         `asciinema produced no cast file at ${castPath} (exit ${exitCode}). Try running 'asciinema rec ${castPath}' directly to diagnose.`
@@ -27768,9 +28181,9 @@ async function captureAsciinema(opts) {
 // src/utils/recording.ts
 init_paths();
 import { spawn as spawn9 } from "child_process";
-import { mkdir as mkdir8, mkdtemp as mkdtemp4, open as open3, readFile as readFile45, rm as rm10, stat as stat7, unlink as unlink9, writeFile as writeFile13 } from "fs/promises";
+import { mkdir as mkdir8, mkdtemp as mkdtemp4, open as open3, readFile as readFile47, rm as rm10, stat as stat7, unlink as unlink9, writeFile as writeFile13 } from "fs/promises";
 import { tmpdir as tmpdir5 } from "os";
-import { join as join15, resolve as resolve67 } from "path";
+import { join as join16, resolve as resolve70 } from "path";
 import { setTimeout as sleep } from "timers/promises";
 function sigintPollIntervalMs() {
   const raw = process.env.SYNTAUR_RECORDING_POLL_INTERVAL_MS;
@@ -27791,13 +28204,13 @@ function sigtermWaitMs() {
   return Number.isFinite(parsed) && parsed >= 0 ? parsed : 1e3;
 }
 function pidfilePath() {
-  return resolve67(syntaurRoot(), "recording.pid");
+  return resolve70(syntaurRoot(), "recording.pid");
 }
 function logPath2() {
-  return resolve67(syntaurRoot(), "recording.log");
+  return resolve70(syntaurRoot(), "recording.log");
 }
 function sidecarPath() {
-  return resolve67(syntaurRoot(), "recording.json");
+  return resolve70(syntaurRoot(), "recording.json");
 }
 function ffmpegArgs(device, fps, mp4Path) {
   return [
@@ -27842,7 +28255,7 @@ async function acquirePidfile(pidfile) {
     } catch (err2) {
       if (err2.code !== "EEXIST") throw err2;
       if (attempt === 1) throw err2;
-      const existing = (await readFile45(pidfile, "utf-8").catch(() => "")).trim();
+      const existing = (await readFile47(pidfile, "utf-8").catch(() => "")).trim();
       if (existing.startsWith(STARTING_SENTINEL_PREFIX)) {
         const parentPidRaw = existing.slice(STARTING_SENTINEL_PREFIX.length);
         const parentPid = Number.parseInt(parentPidRaw, 10);
@@ -27895,8 +28308,8 @@ async function startRecording(input4) {
   let acquiredPid = null;
   try {
     logHandle = await open3(log, "w");
-    tmpDir = await mkdtemp4(join15(tmpdir5(), "syntaur-recording-"));
-    const mp4Path = join15(tmpDir, "recording.mp4");
+    tmpDir = await mkdtemp4(join16(tmpdir5(), "syntaur-recording-"));
+    const mp4Path = join16(tmpDir, "recording.mp4");
     let child;
     try {
       child = spawn9("ffmpeg", ffmpegArgs(input4.device, input4.fps, mp4Path), {
@@ -27944,7 +28357,7 @@ async function startRecording(input4) {
     logHandle = null;
     if (warmupMs > 0) await sleep(warmupMs);
     if (!await isProcessAlive(pid)) {
-      const tail = await readFile45(log, "utf-8").then((s) => s.split("\n").slice(-20).join("\n")).catch(() => "");
+      const tail = await readFile47(log, "utf-8").then((s) => s.split("\n").slice(-20).join("\n")).catch(() => "");
       acquiredPid = null;
       throw new Error(
         `ffmpeg exited during startup \u2014 likely macOS Screen Recording permission missing. Grant access to your terminal in System Settings \u2192 Privacy & Security \u2192 Screen Recording, then retry. Log: ${log}
@@ -28001,7 +28414,7 @@ ${tail}`
 async function stopRecording() {
   const pidfile = pidfilePath();
   const sidecar = sidecarPath();
-  const pidRaw = await readFile45(pidfile, "utf-8").catch(() => null);
+  const pidRaw = await readFile47(pidfile, "utf-8").catch(() => null);
   if (pidRaw === null) {
     throw new Error(
       `No active recording found (no pidfile at ${pidfile}). Did you run --start?`
@@ -28011,7 +28424,7 @@ async function stopRecording() {
   if (!Number.isInteger(pid) || pid <= 0) {
     throw new Error(`Pidfile at ${pidfile} is corrupt (got "${pidRaw}").`);
   }
-  const sidecarRaw = await readFile45(sidecar, "utf-8").catch(() => null);
+  const sidecarRaw = await readFile47(sidecar, "utf-8").catch(() => null);
   if (sidecarRaw === null) {
     throw new Error(
       `No recording sidecar at ${sidecar}. The recording state is inconsistent \u2014 delete ${pidfile} and re-run --start.`
@@ -28076,7 +28489,7 @@ async function stopRecording() {
 // src/db/proof-db.ts
 init_paths();
 import Database5 from "better-sqlite3";
-import { resolve as resolve68 } from "path";
+import { resolve as resolve71 } from "path";
 var db4 = null;
 var PROOF_SCHEMA_VERSION = "1";
 var SCHEMA_SQL4 = `
@@ -28096,7 +28509,7 @@ CREATE TABLE IF NOT EXISTS meta (key TEXT PRIMARY KEY, value TEXT);
 `;
 function initProofDb(dbPath) {
   if (db4) return db4;
-  const finalPath = dbPath ?? resolve68(syntaurRoot(), "syntaur.db");
+  const finalPath = dbPath ?? resolve71(syntaurRoot(), "syntaur.db");
   db4 = new Database5(finalPath);
   db4.pragma("journal_mode = WAL");
   db4.exec(SCHEMA_SQL4);
@@ -28144,9 +28557,9 @@ function listArtifactsByAssignment(assignmentId) {
 
 // src/utils/transcribers/elevenlabs.ts
 import { spawn as spawn10 } from "child_process";
-import { mkdtemp as mkdtemp5, readFile as readFile46, rm as rm11 } from "fs/promises";
+import { mkdtemp as mkdtemp5, readFile as readFile48, rm as rm11 } from "fs/promises";
 import { tmpdir as tmpdir6 } from "os";
-import { join as join16 } from "path";
+import { join as join17 } from "path";
 var SCRIBE_URL = "https://api.elevenlabs.io/v1/speech-to-text";
 var NO_AUDIO_MARKERS = [
   "Stream map '0:a:0' matches no streams",
@@ -28208,7 +28621,7 @@ async function extractAudio(videoAbsPath, wavOut) {
   throw new TranscribeFfmpegError(`ffmpeg failed (exit ${result.code}): ${tail}`);
 }
 async function callScribe(wavPath, apiKey, opts) {
-  const audio = await readFile46(wavPath);
+  const audio = await readFile48(wavPath);
   const form = new FormData();
   form.set("file", new Blob([new Uint8Array(audio)], { type: "audio/wav" }), "audio.wav");
   form.set("model_id", "scribe_v1");
@@ -28236,8 +28649,8 @@ var elevenLabsScribe = {
         "ELEVENLABS_API_KEY is not set. Export it (e.g. `export ELEVENLABS_API_KEY=\u2026`) and re-run. A config-file slot will land later."
       );
     }
-    const tmp = await mkdtemp5(join16(tmpdir6(), "syntaur-transcribe-"));
-    const wav = join16(tmp, "audio.wav");
+    const tmp = await mkdtemp5(join17(tmpdir6(), "syntaur-transcribe-"));
+    const wav = join17(tmp, "audio.wav");
     try {
       await extractAudio(videoAbsPath, wav);
       return await callScribe(wav, apiKey, opts);
@@ -28524,7 +28937,7 @@ async function captureCommand(target, options = {}) {
     });
   }
   if (options.file) {
-    const expanded = options.file.startsWith("~/") ? resolve69(process.env.HOME ?? "", options.file.slice(2)) : resolve69(options.file);
+    const expanded = options.file.startsWith("~/") ? resolve72(process.env.HOME ?? "", options.file.slice(2)) : resolve72(options.file);
     if (!await fileExists(expanded)) {
       throw new Error(`--file does not exist: ${options.file}`);
     }
@@ -28565,7 +28978,7 @@ async function captureCommand(target, options = {}) {
     }
     initProofDb();
     const subdir = criterionIndex === null ? "untagged" : String(criterionIndex);
-    const destDir = resolve69(proofDir(resolved.assignmentDir), subdir);
+    const destDir = resolve72(proofDir(resolved.assignmentDir), subdir);
     if (resolvedSource) await mkdir9(destDir, { recursive: true });
     const ext = resolvedSource ? extensionForKind(kind) : null;
     let id = null;
@@ -28574,7 +28987,7 @@ async function captureCommand(target, options = {}) {
     let lastErr = null;
     for (let attempt = 0; attempt < MAX_ID_RETRIES; attempt += 1) {
       const candidate = generateArtifactId();
-      const candidateAbsPath = resolvedSource && ext ? resolve69(destDir, `${candidate}.${ext}`) : null;
+      const candidateAbsPath = resolvedSource && ext ? resolve72(destDir, `${candidate}.${ext}`) : null;
       const candidateRel = candidateAbsPath ? relative4(resolved.assignmentDir, candidateAbsPath) : null;
       try {
         insertArtifact({
@@ -28618,7 +29031,7 @@ async function captureCommand(target, options = {}) {
       }
     }
     if (options.transcribe && kind === "video" && absPath && id) {
-      const sidecarPath2 = resolve69(destDir, `${id}.transcript.md`);
+      const sidecarPath2 = resolve72(destDir, `${id}.transcript.md`);
       if (existsSync6(sidecarPath2)) {
         console.warn(
           `transcript: ${sidecarPath2} already exists, skipping (delete to re-transcribe)`
@@ -28650,7 +29063,7 @@ async function captureCommand(target, options = {}) {
     const tagSuffix = criterionIndex === null ? "untagged" : `criterion ${criterionIndex}`;
     console.log(`Captured artifact ${id} (${kind}) for ${ref} \u2014 ${tagSuffix}.`);
     if (relativeFilePath) {
-      console.log(`  file: ${resolve69(resolved.assignmentDir, relativeFilePath)}`);
+      console.log(`  file: ${resolve72(resolved.assignmentDir, relativeFilePath)}`);
     }
   } catch (err2) {
     if (options.stop && kind === "video" && shelloutCleanup && resolvedSource) {
@@ -28673,8 +29086,8 @@ async function captureCommand(target, options = {}) {
 
 // src/commands/proof.ts
 import { Command as Command6 } from "commander";
-import { readFile as readFile47, writeFile as writeFile15, rename as rename9, stat as stat9 } from "fs/promises";
-import { resolve as resolve70, relative as relative5, isAbsolute as isAbsolute11, dirname as dirname21 } from "path";
+import { readFile as readFile49, writeFile as writeFile15, rename as rename9, stat as stat9 } from "fs/promises";
+import { resolve as resolve73, relative as relative5, isAbsolute as isAbsolute11, dirname as dirname21 } from "path";
 import { randomBytes as randomBytes4 } from "crypto";
 
 // src/utils/acceptance-criteria-parse.ts
@@ -28914,11 +29327,11 @@ function renderProofHtml(params2, inlineFiles = /* @__PURE__ */ new Map(), trans
 
 // src/commands/proof.ts
 async function readAssignmentMeta(assignmentDir) {
-  const path = resolve70(assignmentDir, "assignment.md");
+  const path = resolve73(assignmentDir, "assignment.md");
   if (!await fileExists(path)) {
     return { title: "", body: "" };
   }
-  const content = await readFile47(path, "utf-8");
+  const content = await readFile49(path, "utf-8");
   const fmMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/);
   let title = "";
   if (fmMatch) {
@@ -28965,7 +29378,7 @@ async function loadInlineFiles(rows, assignmentDir) {
   for (const r of rows) {
     if (!r.file_path) continue;
     if (r.kind !== "http" && r.kind !== "text") continue;
-    const abs = resolve70(assignmentDir, r.file_path);
+    const abs = resolve73(assignmentDir, r.file_path);
     if (!isWithin(proofRoot, abs)) {
       out.set(r.file_path, null);
       continue;
@@ -28980,7 +29393,7 @@ async function loadInlineFiles(rows, assignmentDir) {
       continue;
     }
     try {
-      out.set(r.file_path, await readFile47(abs, "utf-8"));
+      out.set(r.file_path, await readFile49(abs, "utf-8"));
     } catch {
       out.set(r.file_path, null);
     }
@@ -28992,14 +29405,14 @@ async function loadTranscriptSidecars(rows, assignmentDir) {
   const proofRoot = proofDir(assignmentDir);
   for (const r of rows) {
     if (r.kind !== "video" || !r.file_path) continue;
-    const videoAbs = resolve70(assignmentDir, r.file_path);
-    const sidecar = resolve70(dirname21(videoAbs), `${r.id}.transcript.md`);
+    const videoAbs = resolve73(assignmentDir, r.file_path);
+    const sidecar = resolve73(dirname21(videoAbs), `${r.id}.transcript.md`);
     if (!isWithin(proofRoot, sidecar)) continue;
     if (!await fileExists(sidecar)) continue;
     const st = await stat9(sidecar);
     if (st.size > INLINE_TEXT_LIMIT_BYTES) continue;
     try {
-      out.set(r.id, await readFile47(sidecar, "utf-8"));
+      out.set(r.id, await readFile49(sidecar, "utf-8"));
     } catch {
     }
   }
@@ -29033,8 +29446,8 @@ async function proofBuildCommand(target, options = {}) {
   };
   const md = renderProofMarkdown(renderParams);
   const html = renderProofHtml(renderParams, inlineFiles, transcriptSidecars);
-  const mdPath = resolve70(resolved.assignmentDir, "proof.md");
-  const htmlPath = resolve70(resolved.assignmentDir, "proof.html");
+  const mdPath = resolve73(resolved.assignmentDir, "proof.md");
+  const htmlPath = resolve73(resolved.assignmentDir, "proof.html");
   await atomicWrite(mdPath, md);
   await atomicWrite(htmlPath, html);
   console.log(`Wrote ${htmlPath}`);
@@ -29699,7 +30112,7 @@ async function runCcusage(opts = {}) {
   };
 }
 function runOnce(binary, args, env, timeoutMs, maxOutputBytes) {
-  return new Promise((resolve79) => {
+  return new Promise((resolve82) => {
     const child = spawn11(binary, args, {
       env: env ?? process.env,
       stdio: ["ignore", "pipe", "pipe"]
@@ -29713,7 +30126,7 @@ function runOnce(binary, args, env, timeoutMs, maxOutputBytes) {
       if (settled) return;
       settled = true;
       clearTimeout(timer2);
-      resolve79(result);
+      resolve82(result);
     };
     const timer2 = setTimeout(() => {
       timedOut = true;
@@ -29758,8 +30171,8 @@ function isoToCcusageDate(iso) {
 // src/usage/cwd-extractor.ts
 init_paths();
 import { open as open4, readdir as readdir24, stat as stat10 } from "fs/promises";
-import { join as join17 } from "path";
-import { homedir as homedir11 } from "os";
+import { join as join18 } from "path";
+import { homedir as homedir12 } from "os";
 var SCAN_LINE_CAP = 50;
 var TAIL_READ_BYTES = 8 * 1024;
 var TAIL_READ_BYTES_MAX = 64 * 1024;
@@ -29833,12 +30246,12 @@ async function* walkClaudeProjects(opts = {}) {
   const dirs = await listDirSafe(root);
   for (const dirent of dirs) {
     if (!dirent.isDirectory) continue;
-    const dirPath = join17(root, dirent.name);
+    const dirPath = join18(root, dirent.name);
     const files = await listDirSafe(dirPath);
     let cachedCwd = null;
     for (const f of files) {
       if (!f.isFile || !f.name.endsWith(".jsonl")) continue;
-      const filePath = join17(dirPath, f.name);
+      const filePath = join18(dirPath, f.name);
       if (opts.sinceMtimeMs !== void 0) {
         const mtime = await mtimeMs(filePath);
         if (mtime !== null && mtime < opts.sinceMtimeMs) continue;
@@ -29875,8 +30288,8 @@ function resolveCodexSessionsRoot(override) {
   const fromSessionsEnv = process.env.CODEX_SESSIONS_DIR;
   if (fromSessionsEnv && fromSessionsEnv.length > 0) return expandHome(fromSessionsEnv);
   const fromHomeEnv = process.env.CODEX_HOME;
-  if (fromHomeEnv && fromHomeEnv.length > 0) return join17(expandHome(fromHomeEnv), "sessions");
-  return join17(homedir11(), ".codex", "sessions");
+  if (fromHomeEnv && fromHomeEnv.length > 0) return join18(expandHome(fromHomeEnv), "sessions");
+  return join18(homedir12(), ".codex", "sessions");
 }
 async function listDirSafe(path) {
   try {
@@ -29896,7 +30309,7 @@ async function* walkJsonlRecursive(root) {
     const current = stack.pop();
     const entries = await listDirSafe(current);
     for (const e of entries) {
-      const full = join17(current, e.name);
+      const full = join18(current, e.name);
       if (e.isDirectory) {
         stack.push(full);
       } else if (e.isFile && e.name.endsWith(".jsonl")) {
@@ -30235,8 +30648,8 @@ init_slug();
 init_timestamp();
 init_assignment_resolver();
 init_assignment_todos();
-import { resolve as resolve71 } from "path";
-import { readFile as readFile48 } from "fs/promises";
+import { resolve as resolve74 } from "path";
+import { readFile as readFile50 } from "fs/promises";
 async function requestCommand(target, text, options = {}) {
   if (!text || !text.trim()) {
     throw new Error("Request text cannot be empty.");
@@ -30252,7 +30665,7 @@ async function requestCommand(target, text, options = {}) {
     if (!isValidSlug(target)) {
       throw new Error(`Invalid assignment slug "${target}".`);
     }
-    assignmentDir = resolve71(baseDir, options.project, "assignments", target);
+    assignmentDir = resolve74(baseDir, options.project, "assignments", target);
     targetRef = target;
   } else {
     const resolved = await resolveAssignmentById(baseDir, assignmentsDir(), target);
@@ -30262,12 +30675,12 @@ async function requestCommand(target, text, options = {}) {
     assignmentDir = resolved.assignmentDir;
     targetRef = resolved.standalone ? resolved.id : resolved.assignmentSlug;
   }
-  const assignmentMdPath2 = resolve71(assignmentDir, "assignment.md");
+  const assignmentMdPath2 = resolve74(assignmentDir, "assignment.md");
   if (!await fileExists(assignmentMdPath2)) {
     throw new Error(`assignment.md not found at ${assignmentMdPath2}`);
   }
   const source = options.from ?? process.env.SYNTAUR_ASSIGNMENT ?? "unknown";
-  let content = await readFile48(assignmentMdPath2, "utf-8");
+  let content = await readFile50(assignmentMdPath2, "utf-8");
   content = appendTodosToAssignmentBody(content, [
     { description: `${text.trim()} (from: ${source})` }
   ]);
@@ -30280,13 +30693,13 @@ async function requestCommand(target, text, options = {}) {
 init_fs();
 init_paths();
 import { Command as Command9 } from "commander";
-import { readFile as readFile49, readdir as readdir25 } from "fs/promises";
-import { resolve as resolve72 } from "path";
+import { readFile as readFile51, readdir as readdir25 } from "fs/promises";
+import { resolve as resolve75 } from "path";
 async function readContextAssignmentDir(cwd) {
-  const path = resolve72(cwd, ".syntaur", "context.json");
+  const path = resolve75(cwd, ".syntaur", "context.json");
   if (!await fileExists(path)) return null;
   try {
-    const raw = await readFile49(path, "utf-8");
+    const raw = await readFile51(path, "utf-8");
     const ctx = JSON.parse(raw);
     if (typeof ctx.assignmentDir === "string" && ctx.assignmentDir.length > 0) {
       return ctx.assignmentDir;
@@ -30300,9 +30713,9 @@ async function resolveAssignmentDir(opts) {
   const cwd = opts.cwd ?? process.cwd();
   if (opts.assignment) {
     if (opts.project) {
-      return resolve72(defaultProjectDir(), opts.project, "assignments", opts.assignment);
+      return resolve75(defaultProjectDir(), opts.project, "assignments", opts.assignment);
     }
-    return resolve72(assignmentsDir(), opts.assignment);
+    return resolve75(assignmentsDir(), opts.assignment);
   }
   const fromCtx = await readContextAssignmentDir(cwd);
   if (fromCtx) return fromCtx;
@@ -30445,7 +30858,7 @@ async function runPlanVersion(options) {
   if (!await fileExists(assignmentDir)) {
     throw new Error(`Assignment directory does not exist: ${assignmentDir}`);
   }
-  const assignmentMdPath2 = resolve72(assignmentDir, "assignment.md");
+  const assignmentMdPath2 = resolve75(assignmentDir, "assignment.md");
   if (!await fileExists(assignmentMdPath2)) {
     throw new Error(`Missing assignment.md at: ${assignmentMdPath2}`);
   }
@@ -30457,15 +30870,15 @@ async function runPlanVersion(options) {
   }
   const current = planFiles[planFiles.length - 1];
   const next = nextPlanFileName(current.version);
-  const newPath = resolve72(assignmentDir, next.fileName);
+  const newPath = resolve75(assignmentDir, next.fileName);
   if (await fileExists(newPath) && !options.force) {
     throw new Error(`${next.fileName} already exists. Use --force to overwrite.`);
   }
-  const assignmentMd = await readFile49(assignmentMdPath2, "utf-8");
+  const assignmentMd = await readFile51(assignmentMdPath2, "utf-8");
   const slugMatch = assignmentMd.match(/^slug:\s*(.+?)\s*$/m);
   const slug = slugMatch ? slugMatch[1].trim() : assignmentDir.split("/").pop() ?? "";
-  const oldPlanPath = resolve72(assignmentDir, current.fileName);
-  const oldPlanContent = await readFile49(oldPlanPath, "utf-8");
+  const oldPlanPath = resolve75(assignmentDir, current.fileName);
+  const oldPlanContent = await readFile51(oldPlanPath, "utf-8");
   const oldBody = oldPlanContent.replace(/^---[\s\S]*?\n---\n?/, "");
   const carriedTodos = extractUncheckedTodos(oldBody);
   const stub = buildNewPlanStub({
@@ -30502,26 +30915,26 @@ planCommand.command("version").description(
 // src/commands/session.ts
 init_fs();
 import { Command as Command10 } from "commander";
-import { readFile as readFile50, readdir as readdir26, stat as stat11 } from "fs/promises";
-import { resolve as resolve73 } from "path";
+import { readFile as readFile52, readdir as readdir26, stat as stat11 } from "fs/promises";
+import { resolve as resolve76 } from "path";
 async function readContext(cwd) {
-  const path = resolve73(cwd, ".syntaur", "context.json");
+  const path = resolve76(cwd, ".syntaur", "context.json");
   if (!await fileExists(path)) return null;
   try {
-    const raw = await readFile50(path, "utf-8");
+    const raw = await readFile52(path, "utf-8");
     return JSON.parse(raw);
   } catch {
     return null;
   }
 }
 async function findLatestSessionSummary(assignmentDir) {
-  const sessionsRoot = resolve73(assignmentDir, "sessions");
+  const sessionsRoot = resolve76(assignmentDir, "sessions");
   if (!await fileExists(sessionsRoot)) return null;
   const entries = await readdir26(sessionsRoot, { withFileTypes: true });
   let best = null;
   for (const entry of entries) {
     if (!entry.isDirectory()) continue;
-    const summaryPath = resolve73(sessionsRoot, entry.name, "summary.md");
+    const summaryPath = resolve76(sessionsRoot, entry.name, "summary.md");
     if (!await fileExists(summaryPath)) continue;
     const st = await stat11(summaryPath);
     if (best === null || st.mtime.getTime() > best.mtime.getTime()) {
@@ -30531,9 +30944,9 @@ async function findLatestSessionSummary(assignmentDir) {
   return best;
 }
 async function findOpenHandoff(assignmentDir) {
-  const handoffPath = resolve73(assignmentDir, "handoff.md");
+  const handoffPath = resolve76(assignmentDir, "handoff.md");
   if (!await fileExists(handoffPath)) return null;
-  const content = await readFile50(handoffPath, "utf-8");
+  const content = await readFile52(handoffPath, "utf-8");
   const body = content.replace(/^---[\s\S]*?\n---\n?/, "").trim();
   if (body.length === 0) return null;
   if (/^<!--[\s\S]*-->$/.test(body)) return null;
@@ -30641,13 +31054,13 @@ init_git_worktree();
 init_fs();
 init_paths();
 import { Command as Command11 } from "commander";
-import { readFile as readFile51 } from "fs/promises";
-import { resolve as resolve74 } from "path";
+import { readFile as readFile53 } from "fs/promises";
+import { resolve as resolve77 } from "path";
 async function readContext2(cwd) {
-  const path = resolve74(cwd, ".syntaur", "context.json");
+  const path = resolve77(cwd, ".syntaur", "context.json");
   if (!await fileExists(path)) return null;
   try {
-    return JSON.parse(await readFile51(path, "utf-8"));
+    return JSON.parse(await readFile53(path, "utf-8"));
   } catch {
     return null;
   }
@@ -30655,7 +31068,7 @@ async function readContext2(cwd) {
 async function resolveAssignmentPath2(opts) {
   if (opts.assignment) {
     if (opts.project) {
-      return resolve74(
+      return resolve77(
         defaultProjectDir(),
         opts.project,
         "assignments",
@@ -30663,10 +31076,10 @@ async function resolveAssignmentPath2(opts) {
         "assignment.md"
       );
     }
-    return resolve74(assignmentsDir(), opts.assignment, "assignment.md");
+    return resolve77(assignmentsDir(), opts.assignment, "assignment.md");
   }
   const ctx = await readContext2(opts.cwd);
-  if (ctx?.assignmentDir) return resolve74(ctx.assignmentDir, "assignment.md");
+  if (ctx?.assignmentDir) return resolve77(ctx.assignmentDir, "assignment.md");
   throw new Error(
     "No active assignment. Pass --assignment <slug> [--project <slug>] or run from a workspace with .syntaur/context.json."
   );
@@ -30677,7 +31090,7 @@ async function runWorktreeCreate(options, cwd = process.cwd()) {
   }
   const repository = options.repository ?? cwd;
   const parentBranch = options.parentBranch ?? "main";
-  const worktreePath = options.worktreePath ?? resolve74(repository, ".worktrees", options.branch);
+  const worktreePath = options.worktreePath ?? resolve77(repository, ".worktrees", options.branch);
   const assignmentPath = await resolveAssignmentPath2({
     assignment: options.assignment,
     project: options.project,
@@ -30714,13 +31127,13 @@ init_paths();
 init_fs();
 init_slug();
 import { Command as Command12 } from "commander";
-import { resolve as resolve76 } from "path";
+import { resolve as resolve79 } from "path";
 
 // src/utils/project-indexes.ts
 init_parser();
 init_fs();
-import { readdir as readdir27, readFile as readFile52 } from "fs/promises";
-import { resolve as resolve75 } from "path";
+import { readdir as readdir27, readFile as readFile54 } from "fs/promises";
+import { resolve as resolve78 } from "path";
 function nowIso3() {
   return (/* @__PURE__ */ new Date()).toISOString().replace(/\.\d{3}Z$/, "Z");
 }
@@ -30739,7 +31152,7 @@ function joinList(items) {
   return items.length === 0 ? "\u2014" : items.map(escapeCell).join(", ");
 }
 async function rebuildResourcesIndex(projectDir) {
-  const dir = resolve75(projectDir, "resources");
+  const dir = resolve78(projectDir, "resources");
   await ensureDir(dir);
   const files = await listSlugFiles(dir);
   const slug = readProjectSlug(projectDir);
@@ -30755,7 +31168,7 @@ async function rebuildResourcesIndex(projectDir) {
   lines.push("| Name | Category | Source | Related Assignments | Updated |");
   lines.push("|------|----------|--------|---------------------|---------|");
   for (const fileName of files) {
-    const content = await readFile52(resolve75(dir, fileName), "utf-8");
+    const content = await readFile54(resolve78(dir, fileName), "utf-8");
     const parsed = parseResource(content);
     const slugBase = fileName.replace(/\.md$/, "");
     const name = parsed.name || slugBase;
@@ -30765,12 +31178,12 @@ async function rebuildResourcesIndex(projectDir) {
     );
   }
   lines.push("");
-  const indexPath = resolve75(dir, "_index.md");
+  const indexPath = resolve78(dir, "_index.md");
   await writeFileForce(indexPath, lines.join("\n"));
   return { total: files.length, path: indexPath };
 }
 async function rebuildMemoriesIndex(projectDir) {
-  const dir = resolve75(projectDir, "memories");
+  const dir = resolve78(projectDir, "memories");
   await ensureDir(dir);
   const files = await listSlugFiles(dir);
   const slug = readProjectSlug(projectDir);
@@ -30786,7 +31199,7 @@ async function rebuildMemoriesIndex(projectDir) {
   lines.push("| Name | Source | Scope | Source Assignment | Updated |");
   lines.push("|------|--------|-------|-------------------|---------|");
   for (const fileName of files) {
-    const content = await readFile52(resolve75(dir, fileName), "utf-8");
+    const content = await readFile54(resolve78(dir, fileName), "utf-8");
     const parsed = parseMemory(content);
     const slugBase = fileName.replace(/\.md$/, "");
     const name = parsed.name || slugBase;
@@ -30796,7 +31209,7 @@ async function rebuildMemoriesIndex(projectDir) {
     );
   }
   lines.push("");
-  const indexPath = resolve75(dir, "_index.md");
+  const indexPath = resolve78(dir, "_index.md");
   await writeFileForce(indexPath, lines.join("\n"));
   return { total: files.length, path: indexPath };
 }
@@ -30834,8 +31247,8 @@ async function runResourceAdd(options) {
   if (!isValidSlug(options.project)) {
     throw new Error(`Invalid project slug: "${options.project}".`);
   }
-  const projectDir = resolve76(defaultProjectDir(), options.project);
-  if (!await fileExists(resolve76(projectDir, "project.md"))) {
+  const projectDir = resolve79(defaultProjectDir(), options.project);
+  if (!await fileExists(resolve79(projectDir, "project.md"))) {
     throw new Error(`Project "${options.project}" not found at ${projectDir}.`);
   }
   if (!options.name) throw new Error("--name is required.");
@@ -30844,7 +31257,7 @@ async function runResourceAdd(options) {
   if (!isValidSlug(slug)) {
     throw new Error(`Invalid resource slug: "${slug}".`);
   }
-  const filePath = resolve76(projectDir, "resources", `${slug}.md`);
+  const filePath = resolve79(projectDir, "resources", `${slug}.md`);
   if (await fileExists(filePath) && !options.force) {
     throw new Error(
       `Resource "${slug}" already exists at ${filePath}. Use --force to overwrite.`
@@ -30879,7 +31292,7 @@ init_paths();
 init_fs();
 init_slug();
 import { Command as Command13 } from "commander";
-import { resolve as resolve77 } from "path";
+import { resolve as resolve80 } from "path";
 function nowIso5() {
   return (/* @__PURE__ */ new Date()).toISOString().replace(/\.\d{3}Z$/, "Z");
 }
@@ -30914,8 +31327,8 @@ async function runMemoryAdd(options) {
   if (!isValidSlug(options.project)) {
     throw new Error(`Invalid project slug: "${options.project}".`);
   }
-  const projectDir = resolve77(defaultProjectDir(), options.project);
-  if (!await fileExists(resolve77(projectDir, "project.md"))) {
+  const projectDir = resolve80(defaultProjectDir(), options.project);
+  if (!await fileExists(resolve80(projectDir, "project.md"))) {
     throw new Error(`Project "${options.project}" not found at ${projectDir}.`);
   }
   if (!options.name) throw new Error("--name is required.");
@@ -30924,7 +31337,7 @@ async function runMemoryAdd(options) {
   if (!isValidSlug(slug)) {
     throw new Error(`Invalid memory slug: "${slug}".`);
   }
-  const filePath = resolve77(projectDir, "memories", `${slug}.md`);
+  const filePath = resolve80(projectDir, "memories", `${slug}.md`);
   if (await fileExists(filePath) && !options.force) {
     throw new Error(
       `Memory "${slug}" already exists at ${filePath}. Use --force to overwrite.`
@@ -30961,8 +31374,8 @@ init_paths();
 init_fs();
 init_frontmatter();
 import { Command as Command14 } from "commander";
-import { readFile as readFile53 } from "fs/promises";
-import { resolve as resolve78 } from "path";
+import { readFile as readFile55 } from "fs/promises";
+import { resolve as resolve81 } from "path";
 var AGE_PATTERN = /^(\d+)([dhwm])$/i;
 function parseAgeToCutoff(age) {
   const match = age.match(AGE_PATTERN);
@@ -30981,7 +31394,7 @@ function parseAgeToCutoff(age) {
 }
 function assignmentMdPath(item) {
   if (item.projectSlug) {
-    return resolve78(
+    return resolve81(
       defaultProjectDir(),
       item.projectSlug,
       "assignments",
@@ -30989,13 +31402,13 @@ function assignmentMdPath(item) {
       "assignment.md"
     );
   }
-  return resolve78(assignmentsDir(), item.id, "assignment.md");
+  return resolve81(assignmentsDir(), item.id, "assignment.md");
 }
 async function loadTags(item) {
   const path = assignmentMdPath(item);
   if (!await fileExists(path)) return [];
   try {
-    const content = await readFile53(path, "utf-8");
+    const content = await readFile55(path, "utf-8");
     return parseAssignmentFrontmatter(content).tags;
   } catch {
     return [];
@@ -31467,7 +31880,8 @@ function spliceDashDashFromArgv(argv) {
 // src/index.ts
 {
   const sub = process.argv[2];
-  if (sub !== "update" && sub !== "upgrade") {
+  const isDryRunSetup = sub === "setup" && process.argv.slice(3).includes("--dry-run");
+  if (sub !== "update" && sub !== "upgrade" && !isDryRunSetup) {
     await maybePromptInstall(import.meta.url);
     await maybeNudgeForNpxInstall(import.meta.url);
   }
@@ -31712,7 +32126,7 @@ program.command("reopen").description("Reopen a completed or failed assignment")
     process.exit(1);
   }
 });
-program.command("setup").description("Initialize Syntaur and optionally install plugins or launch the dashboard").option("--yes", "Skip interactive prompts and perform only the requested flags").option("--claude", "Install the Claude Code plugin").option("--codex", "Install the Codex plugin").option("--claude-dir <path>", "Install the Claude Code plugin at a specific path").option("--codex-dir <path>", "Install the Codex plugin at a specific path").option("--codex-marketplace-path <path>", "Write the Codex marketplace entry to a specific file").option("--dashboard", "Launch the dashboard after setup").action(async (options) => {
+program.command("setup").description("Initialize Syntaur and optionally install plugins or launch the dashboard").option("--yes", "Skip interactive prompts and perform only the requested flags").option("--claude", "Install the Claude Code plugin").option("--codex", "Install the Codex plugin").option("--claude-dir <path>", "Install the Claude Code plugin at a specific path").option("--codex-dir <path>", "Install the Codex plugin at a specific path").option("--codex-marketplace-path <path>", "Write the Codex marketplace entry to a specific file").option("--dashboard", "Launch the dashboard after setup").option("--target <id>", "Install Syntaur into a cross-agent target (pi, hermes, openclaw, cursor, opencode); comma-separated for several").option("--agent <id>", "Alias for --target; cross-agent target id(s) to install into").option("--force", "Overwrite existing cross-agent protocol files / skills").option("--dry-run", "Print the cross-agent install actions without writing anything").action(async (options) => {
   try {
     await setupCommand(options);
   } catch (error) {