syntaur 0.74.0 → 0.76.0

package/dist/dashboard/server.js

@@ -2543,6 +2543,10 @@ function modelFlagArgs(agent) {
   const m = agent.model?.trim();
   return m ? ["--model", m] : [];
 }
+function agentNameArgs(agent) {
+  const n = agent.agentName?.trim();
+  return n ? ["--agent", n] : [];
+}
 function stripModelFlags(args) {
   const out = [];
   for (let i = 0; i < args.length; i++) {
@@ -3898,6 +3902,26 @@ function validateAgentList(agents) {
         `agent "${agent.id}" has invalid launchPrompt \u2014 must be a single line (no newlines)`
       );
     }
+    if (agent.agentName !== void 0 && /[\r\n]/.test(agent.agentName)) {
+      throw new AgentConfigError(
+        `agent "${agent.id}" has invalid agentName \u2014 must be a single line (no newlines)`
+      );
+    }
+    if (agent.workdir !== void 0 && /[\r\n]/.test(agent.workdir)) {
+      throw new AgentConfigError(
+        `agent "${agent.id}" has invalid workdir \u2014 must be a single line (no newlines)`
+      );
+    }
+    if (agent.agentName !== void 0 && agent.agentName.trim() !== "" && agent.workdir !== void 0 && agent.workdir.trim() !== "") {
+      throw new AgentConfigError(
+        `agent "${agent.id}" sets both agentName and workdir \u2014 these are mutually exclusive`
+      );
+    }
+    if (agent.agentName !== void 0 && agent.agentName.trim() !== "" && agent.model !== void 0 && agent.model.trim() !== "") {
+      throw new AgentConfigError(
+        `agent "${agent.id}" sets both agentName and model \u2014 the agent definition's own model is authoritative; remove the profile model`
+      );
+    }
     validateSessionInvocation(agent, "resume", agent.resume);
     validateSessionInvocation(agent, "fork", agent.fork);
     if (agent.default) defaults++;
@@ -4718,6 +4742,8 @@ function parseAgentsConfig(content) {
       ...current.model ? { model: current.model } : {},
       ...current.playbook ? { playbook: current.playbook } : {},
       ...current.launchPrompt ? { launchPrompt: current.launchPrompt } : {},
+      ...current.agentName ? { agentName: current.agentName } : {},
+      ...current.workdir ? { workdir: current.workdir } : {},
       ...current.resume ? { resume: current.resume } : {},
       ...current.fork ? { fork: current.fork } : {}
     });
@@ -4909,6 +4935,12 @@ function assignAgentField(target, key, rawValue) {
     case "launchPrompt":
       target.launchPrompt = value;
       break;
+    case "agentName":
+      target.agentName = value;
+      break;
+    case "workdir":
+      target.workdir = value;
+      break;
   }
 }
 function yamlQuoteScalar(value) {
@@ -4938,6 +4970,12 @@ function serializeAgentsConfig(agents) {
     if (a.launchPrompt) {
       lines.push(`    launchPrompt: ${yamlQuoteScalar(a.launchPrompt)}`);
     }
+    if (a.agentName) {
+      lines.push(`    agentName: ${yamlQuoteScalar(a.agentName)}`);
+    }
+    if (a.workdir) {
+      lines.push(`    workdir: ${yamlQuoteScalar(a.workdir)}`);
+    }
     if (a.args && a.args.length > 0) {
       lines.push(`    args:`);
       for (const arg of a.args) {
@@ -5585,7 +5623,9 @@ var init_config2 = __esm({
       "resolveFromShellAliases",
       "model",
       "playbook",
-      "launchPrompt"
+      "launchPrompt",
+      "agentName",
+      "workdir"
     ]);
     migratedConfigPaths = /* @__PURE__ */ new Set();
     TerminalConfigError = class extends Error {
@@ -6013,6 +6053,21 @@ function resolveWorkspaceCwd(input) {
     invalidReason: `workspace path invalid for ${assignmentSlug}: tried worktreePath ${shown(worktreePath)} and repository ${shown(repository)} \u2014 neither is an existing directory`
   };
 }
+function resolveLaunchCwd(agent, worktreeCwd) {
+  const wd = agent.workdir?.trim();
+  if (wd) {
+    const expanded = expandHome(wd);
+    if (!isExistingDir(expanded)) {
+      return {
+        spawnCwd: worktreeCwd,
+        worktreePath: worktreeCwd,
+        invalidReason: `agent "${agent.id}" workdir ${agent.workdir} (resolved ${expanded}) is not an existing directory`
+      };
+    }
+    return { spawnCwd: expanded, worktreePath: worktreeCwd, invalidReason: null };
+  }
+  return { spawnCwd: worktreeCwd, worktreePath: worktreeCwd, invalidReason: null };
+}
 function formatFallbackCwdWarning(opts) {
   const missing = [];
   if (!opts.worktreePath) missing.push("worktreePath");
@@ -6024,6 +6079,7 @@ function formatFallbackCwdWarning(opts) {
 var init_cwd = __esm({
   "src/launch/cwd.ts"() {
     "use strict";
+    init_paths();
   }
 });
 
@@ -7857,8 +7913,8 @@ async function migrateFromMarkdown(projectsDir) {
   return allSessions.length;
 }
 async function parseMarkdownSessionsIndex(filePath, projectSlug) {
-  const { readFile: readFile31 } = await import("fs/promises");
-  const raw2 = await readFile31(filePath, "utf-8");
+  const { readFile: readFile32 } = await import("fs/promises");
+  const raw2 = await readFile32(filePath, "utf-8");
   const sessions = [];
   const lines = raw2.split("\n");
   let inTable = false;
@@ -12472,69 +12528,6 @@ var init_session_id = __esm({
   }
 });
 
-// src/utils/assignment-todos.ts
-var assignment_todos_exports = {};
-__export(assignment_todos_exports, {
-  appendTodosToAssignmentBody: () => appendTodosToAssignmentBody,
-  touchAssignmentUpdated: () => touchAssignmentUpdated
-});
-function setTopLevelField2(content, key, value) {
-  const fieldRegex = new RegExp(`^(${key}:)\\s*.*$`, "m");
-  if (fieldRegex.test(content)) {
-    return content.replace(fieldRegex, `$1 ${value}`);
-  }
-  return content;
-}
-function appendTodosToAssignmentBody(body, todos) {
-  if (todos.length === 0) return body;
-  const lines = todos.map((t) => {
-    const base = `- [ ] ${t.description.trim()}`;
-    return t.trace ? `${base} <!-- ${t.trace} -->` : base;
-  });
-  const block = lines.join("\n");
-  const todosHeading = /^## Todos\s*$/m;
-  if (todosHeading.test(body)) {
-    return body.replace(
-      /(^## Todos[\s\S]*?)(\n## |\n*$)/m,
-      (_m, section, nextHeading) => {
-        return `${section.trimEnd()}
-${block}
-${nextHeading}`;
-      }
-    );
-  }
-  return `${body.trimEnd()}
-
-## Todos
-
-${block}
-`;
-}
-function touchAssignmentUpdated(content, timestamp) {
-  return setTopLevelField2(content, "updated", `"${timestamp}"`);
-}
-var init_assignment_todos = __esm({
-  "src/utils/assignment-todos.ts"() {
-    "use strict";
-  }
-});
-
-// src/utils/path-canon.ts
-import { realpathSync as realpathSync2 } from "fs";
-import { resolve as resolve44 } from "path";
-function canonicalPath(p) {
-  try {
-    return realpathSync2(resolve44(p));
-  } catch {
-    return resolve44(p).replace(/\/+$/, "");
-  }
-}
-var init_path_canon = __esm({
-  "src/utils/path-canon.ts"() {
-    "use strict";
-  }
-});
-
 // src/targets/renderers.ts
 var RENDERERS;
 var init_renderers = __esm({
@@ -12555,8 +12548,8 @@ var init_renderers = __esm({
 });
 
 // src/targets/user-descriptors.ts
-import { resolve as resolve45 } from "path";
-import { readFile as readFile30, readdir as readdir18 } from "fs/promises";
+import { resolve as resolve26 } from "path";
+import { readFile as readFile19, readdir as readdir14 } from "fs/promises";
 var VALID_RENDERER_KEYS;
 var init_user_descriptors = __esm({
   "src/targets/user-descriptors.ts"() {
@@ -12569,21 +12562,21 @@ var init_user_descriptors = __esm({
 });
 
 // src/targets/registry.ts
-import { homedir as homedir7 } from "os";
-import { join as join10, resolve as resolve46 } from "path";
+import { homedir as homedir4 } from "os";
+import { join as join5, resolve as resolve27 } from "path";
 function home(...segments) {
-  return resolve46(homedir7(), ...segments);
+  return resolve27(homedir4(), ...segments);
 }
 function hermesHome() {
   const env = process.env.HERMES_HOME;
-  return env && env.length > 0 ? resolve46(env) : home(".hermes");
+  return env && env.length > 0 ? resolve27(env) : home(".hermes");
 }
 function hermesSkillsDir() {
-  return resolve46(hermesHome(), "skills");
+  return resolve27(hermesHome(), "skills");
 }
 function codexHome() {
   const env = process.env.CODEX_HOME;
-  return env && env.length > 0 ? resolve46(env) : home(".codex");
+  return env && env.length > 0 ? resolve27(env) : home(".codex");
 }
 function toDiscovered(meta) {
   if (!meta) return null;
@@ -12595,6 +12588,9 @@ function toDiscovered(meta) {
     transcriptPath: meta.path
   };
 }
+function getAgentTarget(id) {
+  return AGENT_TARGETS_BY_ID[id];
+}
 var detectDir, claudeSessions, codexSessions, piSessions, AGENT_TARGETS, AGENT_TARGETS_BY_ID;
 var init_registry = __esm({
   "src/targets/registry.ts"() {
@@ -12604,7 +12600,7 @@ var init_registry = __esm({
     init_user_descriptors();
     detectDir = (dir) => () => fileExists(dir);
     claudeSessions = {
-      globs: (root) => [join10(root ?? home(".claude", "projects"), "*", "*.jsonl")],
+      globs: (root) => [join5(root ?? home(".claude", "projects"), "*", "*.jsonl")],
       parse: async (file) => toDiscovered(await extractClaudeSessionMeta(file)),
       walk: async function* (opts = {}) {
         for await (const meta of walkClaudeProjects({ root: opts.root, sinceMtimeMs: opts.sinceMtimeMs })) {
@@ -12614,7 +12610,7 @@ var init_registry = __esm({
       }
     };
     codexSessions = {
-      globs: (root) => [join10(root ?? resolveCodexSessionsRoot(), "**", "*.jsonl")],
+      globs: (root) => [join5(root ?? resolveCodexSessionsRoot(), "**", "*.jsonl")],
       parse: async (file) => toDiscovered(await extractCodexSessionMeta(file)),
       walk: async function* (opts = {}) {
         for await (const meta of walkCodexSessions({ root: opts.root, sinceMtimeMs: opts.sinceMtimeMs })) {
@@ -12624,7 +12620,7 @@ var init_registry = __esm({
       }
     };
     piSessions = {
-      globs: (root) => [join10(root ?? resolvePiSessionsRoot(), "*", "*.jsonl")],
+      globs: (root) => [join5(root ?? resolvePiSessionsRoot(), "*", "*.jsonl")],
       parse: async (file) => toDiscovered(await extractPiSessionMeta(file)),
       walk: async function* (opts = {}) {
         for await (const meta of walkPiSessions({ root: opts.root, sinceMtimeMs: opts.sinceMtimeMs })) {
@@ -12654,7 +12650,7 @@ var init_registry = __esm({
         skillsShAgentId: "codex",
         nativePlugin: "codex",
         detect: detectDir(codexHome()),
-        skillsDir: { global: resolve46(codexHome(), "skills") },
+        skillsDir: { global: resolve27(codexHome(), "skills") },
         instructions: { files: [{ path: "AGENTS.md", renderer: "codexAgents" }] },
         sessions: codexSessions
       },
@@ -12680,7 +12676,8 @@ var init_registry = __esm({
         nativePlugin: "claude",
         detect: detectDir(home(".claude")),
         skillsDir: { global: home(".claude", "skills") },
-        sessions: claudeSessions
+        sessions: claudeSessions,
+        agentsDir: home(".claude", "agents")
       },
       {
         id: "pi",
@@ -12723,7 +12720,7 @@ var init_registry = __esm({
         tier3: {
           kind: "hermes-plugin",
           source: "platforms/hermes/plugins/syntaur",
-          installDir: () => resolve46(hermesHome(), "plugins", "syntaur"),
+          installDir: () => resolve27(hermesHome(), "plugins", "syntaur"),
           entry: "plugin.yaml"
         }
       }
@@ -12734,6 +12731,69 @@ var init_registry = __esm({
   }
 });
 
+// src/utils/assignment-todos.ts
+var assignment_todos_exports = {};
+__export(assignment_todos_exports, {
+  appendTodosToAssignmentBody: () => appendTodosToAssignmentBody,
+  touchAssignmentUpdated: () => touchAssignmentUpdated
+});
+function setTopLevelField2(content, key, value) {
+  const fieldRegex = new RegExp(`^(${key}:)\\s*.*$`, "m");
+  if (fieldRegex.test(content)) {
+    return content.replace(fieldRegex, `$1 ${value}`);
+  }
+  return content;
+}
+function appendTodosToAssignmentBody(body, todos) {
+  if (todos.length === 0) return body;
+  const lines = todos.map((t) => {
+    const base = `- [ ] ${t.description.trim()}`;
+    return t.trace ? `${base} <!-- ${t.trace} -->` : base;
+  });
+  const block = lines.join("\n");
+  const todosHeading = /^## Todos\s*$/m;
+  if (todosHeading.test(body)) {
+    return body.replace(
+      /(^## Todos[\s\S]*?)(\n## |\n*$)/m,
+      (_m, section, nextHeading) => {
+        return `${section.trimEnd()}
+${block}
+${nextHeading}`;
+      }
+    );
+  }
+  return `${body.trimEnd()}
+
+## Todos
+
+${block}
+`;
+}
+function touchAssignmentUpdated(content, timestamp) {
+  return setTopLevelField2(content, "updated", `"${timestamp}"`);
+}
+var init_assignment_todos = __esm({
+  "src/utils/assignment-todos.ts"() {
+    "use strict";
+  }
+});
+
+// src/utils/path-canon.ts
+import { realpathSync as realpathSync2 } from "fs";
+import { resolve as resolve46 } from "path";
+function canonicalPath(p) {
+  try {
+    return realpathSync2(resolve46(p));
+  } catch {
+    return resolve46(p).replace(/\/+$/, "");
+  }
+}
+var init_path_canon = __esm({
+  "src/utils/path-canon.ts"() {
+    "use strict";
+  }
+});
+
 // src/sessions/agent-view.ts
 import { execFile as execFile3 } from "child_process";
 import { promisify as promisify3 } from "util";
@@ -18143,6 +18203,55 @@ function createAgentSessionsRouter(projectsDir, broadcast, assignmentsDir2) {
 init_config2();
 init_agents_schema();
 import { Router as Router5 } from "express";
+
+// src/targets/agent-definitions.ts
+init_parser();
+init_registry();
+import { readdir as readdir15, readFile as readFile20 } from "fs/promises";
+import { join as join6 } from "path";
+async function collectMarkdown(dir, out) {
+  let entries;
+  try {
+    entries = await readdir15(dir, { withFileTypes: true });
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    const full = join6(dir, entry.name);
+    if (entry.isDirectory()) {
+      await collectMarkdown(full, out);
+    } else if (entry.isFile() && entry.name.endsWith(".md")) {
+      out.push(full);
+    }
+  }
+}
+async function discoverClaudeAgents(root) {
+  const dir = root ?? getAgentTarget("claude")?.agentsDir;
+  if (!dir) return [];
+  const files = [];
+  await collectMarkdown(dir, files);
+  files.sort();
+  const byName = /* @__PURE__ */ new Map();
+  for (const file of files) {
+    let content;
+    try {
+      content = await readFile20(file, "utf-8");
+    } catch {
+      continue;
+    }
+    const [frontmatter] = extractFrontmatter2(content);
+    if (!frontmatter) continue;
+    const name = getField(frontmatter, "name")?.trim();
+    if (!name) continue;
+    if (byName.has(name)) continue;
+    const description = getField(frontmatter, "description")?.trim() || void 0;
+    const model = getField(frontmatter, "model")?.trim() || void 0;
+    byName.set(name, { name, description, model, path: file });
+  }
+  return [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+
+// src/dashboard/api-agents.ts
 function mapAgentErrorToFieldErrors(err) {
   const message = err.message;
   let match = message.match(/^agent id "([^"]*)" is invalid/);
@@ -18230,6 +18339,38 @@ function mapAgentErrorToFieldErrors(err) {
       ]
     };
   }
+  match = message.match(/^agent "([^"]+)" has invalid agentName/);
+  if (match) {
+    return {
+      error: message,
+      fieldErrors: [{ id: match[1], field: "agentName", message: "must be a single line" }]
+    };
+  }
+  match = message.match(/^agent "([^"]+)" has invalid workdir/);
+  if (match) {
+    return {
+      error: message,
+      fieldErrors: [{ id: match[1], field: "workdir", message: "must be a single line" }]
+    };
+  }
+  match = message.match(/^agent "([^"]+)" sets both agentName and workdir/);
+  if (match) {
+    return {
+      error: message,
+      fieldErrors: [
+        { id: match[1], field: "workdir", message: "agentName and workdir are mutually exclusive" }
+      ]
+    };
+  }
+  match = message.match(/^agent "([^"]+)" sets both agentName and model/);
+  if (match) {
+    return {
+      error: message,
+      fieldErrors: [
+        { id: match[1], field: "model", message: "remove the profile model; the agent defines its own" }
+      ]
+    };
+  }
   return { error: message };
 }
 function coerceAgentRow(raw2, index) {
@@ -18377,10 +18518,47 @@ function coerceAgentRow(raw2, index) {
     }
     if (entry.launchPrompt.trim()) cleaned.launchPrompt = entry.launchPrompt;
   }
+  if (entry.agentName !== void 0) {
+    if (typeof entry.agentName !== "string") {
+      return {
+        ok: false,
+        status: 400,
+        body: {
+          error: `agents[${index}].agentName must be a string`,
+          fieldErrors: [{ id, field: "agentName", message: "agentName must be a string" }]
+        }
+      };
+    }
+    const agentName = entry.agentName.trim();
+    if (agentName) cleaned.agentName = agentName;
+  }
+  if (entry.workdir !== void 0) {
+    if (typeof entry.workdir !== "string") {
+      return {
+        ok: false,
+        status: 400,
+        body: {
+          error: `agents[${index}].workdir must be a string`,
+          fieldErrors: [{ id, field: "workdir", message: "workdir must be a string" }]
+        }
+      };
+    }
+    const workdir = entry.workdir.trim();
+    if (workdir) cleaned.workdir = workdir;
+  }
   return { ok: true, value: cleaned };
 }
 function createAgentsRouter() {
   const router = Router5();
+  router.get("/claude-discovered", async (_req, res) => {
+    try {
+      const agents = await discoverClaudeAgents();
+      res.json({ agents });
+    } catch (err) {
+      console.error("Error discovering Claude agents:", err);
+      res.status(500).json({ error: "Failed to discover Claude agents" });
+    }
+  });
   router.get("/", async (_req, res) => {
     try {
       const config = await readConfig();
@@ -18443,8 +18621,8 @@ import { Router as Router6 } from "express";
 // src/utils/terminal-probe.ts
 import { spawnSync as spawnSync4 } from "child_process";
 import { existsSync as existsSync2 } from "fs";
-import { homedir as homedir4 } from "os";
-import { join as join5 } from "path";
+import { homedir as homedir5 } from "os";
+import { join as join7 } from "path";
 var APP_BUNDLE_IDS = {
   "terminal-app": "com.apple.Terminal",
   iterm: "com.googlecode.iterm2",
@@ -18461,7 +18639,7 @@ var APP_FIXED_PATHS = {
   "terminal-app": "/System/Applications/Utilities/Terminal.app"
 };
 function defaultApplicationsDirs() {
-  return ["/Applications", join5(homedir4(), "Applications")];
+  return ["/Applications", join7(homedir5(), "Applications")];
 }
 function findAppBundle(terminal, dirs = defaultApplicationsDirs()) {
   const fixed = APP_FIXED_PATHS[terminal];
@@ -18469,7 +18647,7 @@ function findAppBundle(terminal, dirs = defaultApplicationsDirs()) {
   const bundleName = APP_BUNDLE_NAMES[terminal];
   if (bundleName) {
     for (const dir of dirs) {
-      const candidate = join5(dir, bundleName);
+      const candidate = join7(dir, bundleName);
       if (existsSync2(candidate)) return candidate;
     }
   }
@@ -18499,11 +18677,11 @@ var defaultCmuxLsappinfoRunner = () => {
 function resolveCmuxCli(applicationsDirsOverride, cliDirsOverride, lsappinfoRunnerOverride) {
   const bundle = findAppBundle("cmux", applicationsDirsOverride);
   if (bundle) {
-    const cli = join5(bundle, "Contents/Resources/bin/cmux");
+    const cli = join7(bundle, "Contents/Resources/bin/cmux");
     if (existsSync2(cli)) return cli;
   }
   for (const dir of cliDirsOverride ?? CMUX_CLI_DIRS) {
-    const cli = join5(dir, "cmux");
+    const cli = join7(dir, "cmux");
     if (existsSync2(cli)) return cli;
   }
   if (process.platform === "darwin") {
@@ -18512,7 +18690,7 @@ function resolveCmuxCli(applicationsDirsOverride, cliDirsOverride, lsappinfoRunn
     if (stdout) {
       const match = stdout.match(/"LSBundlePath"="([^"]+)"/);
       if (match) {
-        const cli = join5(match[1], "Contents/Resources/bin/cmux");
+        const cli = join7(match[1], "Contents/Resources/bin/cmux");
         if (existsSync2(cli)) return cli;
       }
     }
@@ -18594,8 +18772,19 @@ function resolveTemplate(template, ctx) {
   const warnings = [];
   const prompt = template.replace(TOKEN_RE, (_match, boundary, token) => {
     if (token === "assignment") {
+      if (!ctx.assignmentDir) {
+        warnings.push(`launchPrompt: "@assignment" has no assignment context here \u2014 left as literal text.`);
+        return boundary + "@assignment";
+      }
       return boundary + assignmentPointer(ctx.id, ctx.assignmentDir);
     }
+    if (token === "worktree") {
+      if (!ctx.worktreePath) {
+        warnings.push(`launchPrompt: "@worktree" has no worktree path here \u2014 left as literal text.`);
+        return boundary + "@worktree";
+      }
+      return boundary + ctx.worktreePath;
+    }
     if (!isValidSlug(token)) {
       warnings.push(`launchPrompt: "@${token}" is not a valid playbook token \u2014 left as literal text.`);
       return boundary + "@" + token;
@@ -18609,16 +18798,37 @@ function resolveTemplate(template, ctx) {
   return { prompt, warnings };
 }
 function resolveLaunchPrompt(input) {
-  const { template, playbook, id, assignmentDir, projectSlug, assignmentSlug, knownPlaybookSlugs } = input;
+  const {
+    template,
+    playbook,
+    id,
+    assignmentDir,
+    projectSlug,
+    assignmentSlug,
+    worktreePath,
+    spawnCwd,
+    knownPlaybookSlugs
+  } = input;
   if (template && template.trim()) {
-    return resolveTemplate(template, { id, assignmentDir, knownPlaybookSlugs });
+    return resolveTemplate(template, { id, assignmentDir, worktreePath, knownPlaybookSlugs });
   }
   const pb = playbook?.trim();
   if (pb) {
-    const pointer = assignmentPointer(id, assignmentDir);
-    return { prompt: `${pointer} Run ${runPlaybookClause(pb)} end-to-end.`, warnings: [] };
+    const clause = runPlaybookClause(pb);
+    const prompt = assignmentDir ? `${assignmentPointer(id, assignmentDir)} Run ${clause} end-to-end.` : `Run ${clause} end-to-end.`;
+    return { prompt, warnings: [] };
+  }
+  if (worktreePath && spawnCwd && worktreePath !== spawnCwd) {
+    const grab = bareGrabSeed({ projectSlug, assignmentSlug: assignmentSlug ?? "", id });
+    return {
+      prompt: `The assignment's worktree is at ${worktreePath}. cd there, then grab the assignment with ${grab} and work it end-to-end.`,
+      warnings: []
+    };
+  }
+  if (!assignmentSlug && !id) {
+    return { prompt: "", warnings: [] };
   }
-  return { prompt: bareGrabSeed({ projectSlug, assignmentSlug, id }), warnings: [] };
+  return { prompt: bareGrabSeed({ projectSlug, assignmentSlug: assignmentSlug ?? "", id }), warnings: [] };
 }
 function effectiveLaunchTemplate(input) {
   if (input.launchPrompt && input.launchPrompt.trim()) {
@@ -18628,6 +18838,14 @@ function effectiveLaunchTemplate(input) {
   if (pb) {
     return `@assignment Run ${runPlaybookClause(pb)} end-to-end.`;
   }
+  if (input.workdir && input.workdir.trim()) {
+    const grab = bareGrabSeed({
+      projectSlug: input.projectSlug,
+      assignmentSlug: input.assignmentSlug,
+      id: input.id
+    });
+    return `The assignment's worktree is at @worktree. cd there, then grab the assignment with ${grab} and work it end-to-end.`;
+  }
   return bareGrabSeed({
     projectSlug: input.projectSlug,
     assignmentSlug: input.assignmentSlug,
@@ -18651,7 +18869,7 @@ init_agents_schema();
 init_cwd();
 import { spawn as spawn2 } from "child_process";
 import { mkdir as mkdir2, writeFile as writeFile4 } from "fs/promises";
-import { isAbsolute as isAbsolute5, resolve as resolve26 } from "path";
+import { isAbsolute as isAbsolute5, resolve as resolve28 } from "path";
 init_paths();
 init_playbooks();
 init_cwd();
@@ -18661,8 +18879,10 @@ function shellQuote(arg) {
 }
 function buildAgentArgv(agent, prompt, env = process.env) {
   const position = agent.promptArgPosition ?? "first";
-  const baseArgs = applyModelFlag(agent, [...agent.args ?? []]);
-  const agentArgs = position === "first" ? [prompt, ...baseArgs] : position === "last" ? [...baseArgs, prompt] : baseArgs;
+  const prefix = agentNameArgs(agent);
+  const baseArgs = agent.agentName ? [...agent.args ?? []] : applyModelFlag(agent, [...agent.args ?? []]);
+  const positioned = position === "first" ? [prompt, ...baseArgs] : position === "last" ? [...baseArgs, prompt] : baseArgs;
+  const agentArgs = [...prefix, ...positioned];
   if (agent.resolveFromShellAliases) {
     const requested = env.SHELL;
     let shell = requested;
@@ -18742,8 +18962,60 @@ async function resolveLaunchPlan(input) {
   if (input.kind === "assignment") {
     return resolveAssignmentPlan(input, terminal);
   }
+  if (input.kind === "standalone") {
+    return resolveStandalonePlan(input, terminal);
+  }
   return resolveSessionPlan(input, terminal);
 }
+async function resolveStandalonePlan(input, terminal) {
+  const agentId = input.agentId ?? input.id;
+  if (!agentId) {
+    throw new LaunchError(
+      "agent-not-configured",
+      "A standalone launch requires an agent id."
+    );
+  }
+  const agent = getAgents(input.config).find((a) => a.id === agentId);
+  if (!agent) {
+    throw new LaunchError(
+      "agent-not-configured",
+      `Agent "${agentId}" requested for a standalone launch is not in your agents list.`
+    );
+  }
+  const wd = agent.workdir?.trim();
+  if (!wd) {
+    throw new LaunchError(
+      "workspace-path-invalid",
+      `Agent "${agent.id}" has no workdir \u2014 a standalone launch requires a valid workdir.`
+    );
+  }
+  const expanded = expandHome(wd);
+  if (!isExistingDir(expanded)) {
+    throw new LaunchError(
+      "workspace-path-invalid",
+      `Agent "${agent.id}" workdir ${agent.workdir} (resolved ${expanded}) is not an existing directory \u2014 a standalone launch requires a valid workdir.`
+    );
+  }
+  const knownPlaybookSlugs = await listPlaybookSlugs(playbooksDir());
+  const template = input.promptOverride !== void 0 ? input.promptOverride : agent.launchPrompt;
+  const { prompt, warnings: promptWarnings } = resolveLaunchPrompt({
+    template,
+    playbook: agent.playbook,
+    projectSlug: null,
+    knownPlaybookSlugs
+  });
+  const { argv, shellFallbackWarning } = buildFreshArgv(agent, prompt);
+  return {
+    terminal,
+    cwd: expanded,
+    argv,
+    env: process.env,
+    agentId: agent.id,
+    fallbackWarning: null,
+    shellFallbackWarning,
+    promptWarnings
+  };
+}
 async function resolveAssignmentPlan(input, terminal) {
   const resolved = await resolveAssignmentById(
     input.projectsDir,
@@ -18767,17 +19039,6 @@ async function resolveAssignmentPlan(input, terminal) {
       `Assignment ${input.id} resolver returned a directory but detail could not be loaded`
     );
   }
-  const picked = resolveWorkspaceCwd({
-    worktreePath: detail.workspace.worktreePath,
-    repository: detail.workspace.repository,
-    branch: detail.workspace.branch,
-    assignmentSlug: resolved.assignmentSlug
-  });
-  if (picked.cwd === null) {
-    throw new LaunchError("workspace-path-invalid", picked.invalidReason);
-  }
-  const cwd = picked.cwd;
-  const fallbackWarning = picked.fallbackWarning;
   let agent;
   if (input.agentId) {
     const found = getAgents(input.config).find((a) => a.id === input.agentId);
@@ -18791,6 +19052,30 @@ async function resolveAssignmentPlan(input, terminal) {
   } else {
     agent = pickAgent(input.config);
   }
+  if (input.agentName !== void 0) {
+    agent = { ...agent, agentName: input.agentName };
+  }
+  const picked = resolveWorkspaceCwd({
+    worktreePath: detail.workspace.worktreePath,
+    repository: detail.workspace.repository,
+    branch: detail.workspace.branch,
+    assignmentSlug: resolved.assignmentSlug
+  });
+  if (picked.cwd === null) {
+    throw new LaunchError("workspace-path-invalid", picked.invalidReason);
+  }
+  const launchCwd = resolveLaunchCwd(agent, picked.cwd);
+  if (launchCwd.invalidReason) {
+    throw new LaunchError("workspace-path-invalid", launchCwd.invalidReason);
+  }
+  const cwd = launchCwd.spawnCwd;
+  const fallbackWarning = picked.fallbackWarning;
+  const promptWarningsExtra = [];
+  if (input.agentName !== void 0 && input.agentName.trim() && agent.model?.trim()) {
+    promptWarningsExtra.push(
+      `profile model "${agent.model.trim()}" suppressed: agent "${input.agentName.trim()}" defines its own model`
+    );
+  }
   const knownPlaybookSlugs = await listPlaybookSlugs(playbooksDir());
   const template = input.promptOverride !== void 0 ? input.promptOverride : agent.launchPrompt;
   const { prompt, warnings: promptWarnings } = resolveLaunchPrompt({
@@ -18800,6 +19085,8 @@ async function resolveAssignmentPlan(input, terminal) {
     assignmentDir: resolved.assignmentDir,
     projectSlug: resolved.projectSlug,
     assignmentSlug: resolved.assignmentSlug,
+    worktreePath: launchCwd.worktreePath,
+    spawnCwd: launchCwd.spawnCwd,
     knownPlaybookSlugs
   });
   const { argv, shellFallbackWarning } = buildFreshArgv(agent, prompt);
@@ -18811,7 +19098,7 @@ async function resolveAssignmentPlan(input, terminal) {
     agentId: agent.id,
     fallbackWarning,
     shellFallbackWarning,
-    promptWarnings
+    promptWarnings: [...promptWarningsExtra, ...promptWarnings]
   };
 }
 async function resolveSessionPlan(input, terminal) {
@@ -18887,8 +19174,8 @@ async function resolveSessionPlan(input, terminal) {
 
 // src/launch/execute.ts
 import { spawn as spawn3 } from "child_process";
-import { homedir as homedir5 } from "os";
-import { basename as basename5, join as join6, resolve as resolve27 } from "path";
+import { homedir as homedir6 } from "os";
+import { basename as basename5, join as join8, resolve as resolve29 } from "path";
 init_fs();
 init_config2();
 init_session_id();
@@ -18994,7 +19281,7 @@ async function registerLaunchAtBirth(plan, child) {
     const sessionId = plan.session?.sessionId ?? null;
     const procStart = captureProcessStartedAt(pid);
     const envDir = process.env.SYNTAUR_RUNTIME_SESSIONS_DIR;
-    const markerDir = envDir && envDir.length > 0 ? envDir : join6(homedir5(), ".syntaur", "runtime", "sessions");
+    const markerDir = envDir && envDir.length > 0 ? envDir : join8(homedir6(), ".syntaur", "runtime", "sessions");
     writeRuntimeMarker(
       pid,
       {
@@ -19007,7 +19294,7 @@ async function registerLaunchAtBirth(plan, child) {
       markerDir
     );
     if (!sessionId) return;
-    if (autoTrack === "workspaces-only" && !await fileExists(resolve27(plan.cwd, ".syntaur", "context.json"))) {
+    if (autoTrack === "workspaces-only" && !await fileExists(resolve29(plan.cwd, ".syntaur", "context.json"))) {
       return;
     }
     const { initSessionDb: initSessionDb2 } = await Promise.resolve().then(() => (init_session_db(), session_db_exports));
@@ -19183,7 +19470,7 @@ function appleScriptString(value) {
 init_paths();
 init_fs();
 import { fileURLToPath } from "url";
-import { dirname as dirname6, resolve as resolve28, join as join7 } from "path";
+import { dirname as dirname6, resolve as resolve30, join as join9 } from "path";
 import { realpathSync, readFileSync as readFileSync3, mkdirSync as mkdirSync2 } from "fs";
 
 // src/dashboard/api-launch-preflight.ts
@@ -19344,7 +19631,8 @@ function createLaunchPreflightRouter(projectsDir, assignmentsDir2) {
         playbook: agent.playbook,
         projectSlug: resolved.projectSlug,
         assignmentSlug: resolved.assignmentSlug,
-        id: resolved.id
+        id: resolved.id,
+        workdir: agent.workdir
       });
       res.json({ template, knownPlaybookSlugs });
     } catch (error) {
@@ -19588,7 +19876,7 @@ init_frontmatter();
 init_event_emit();
 init_assignment_walk();
 init_timestamp();
-import { readFile as readFile19, writeFile as writeFile5, rm as rm2 } from "fs/promises";
+import { readFile as readFile21, writeFile as writeFile5, rm as rm2 } from "fs/promises";
 import { dirname as dirname7 } from "path";
 var StatusResolutionError = class extends Error {
   constructor(message, code) {
@@ -19607,7 +19895,7 @@ async function scanAssignmentsByStatus(projectsDir, standaloneDir, ids) {
     const assignmentPath = `${entry.assignmentDir}/assignment.md`;
     let content;
     try {
-      content = await readFile19(assignmentPath, "utf-8");
+      content = await readFile21(assignmentPath, "utf-8");
     } catch (err) {
       const code = err?.code;
       if (code === "ENOENT") {
@@ -19670,7 +19958,7 @@ async function applyStatusResolutions(resolutions, affected, validTargets) {
     const list = affected.get(r.id) ?? [];
     for (const a of list) {
       try {
-        const content = await readFile19(a.path, "utf-8");
+        const content = await readFile21(a.path, "utf-8");
         buffer.set(a.path, content);
       } catch (err) {
         const code = err?.code;
@@ -19699,7 +19987,7 @@ async function applyStatusResolutions(resolutions, affected, validTargets) {
       for (const a of list) {
         let current;
         try {
-          current = await readFile19(a.path, "utf-8");
+          current = await readFile21(a.path, "utf-8");
         } catch (err) {
           const code = err?.code;
           if (code === "ENOENT") {
@@ -19770,7 +20058,7 @@ async function applyStatusResolutions(resolutions, affected, validTargets) {
     const list = affected.get(r.id) ?? [];
     for (const a of list) {
       try {
-        const current = await readFile19(a.path, "utf-8");
+        const current = await readFile21(a.path, "utf-8");
         const fm = parseAssignmentFrontmatter(current);
         if (fm.status !== r.id) {
           console.warn(
@@ -20250,7 +20538,7 @@ import { Router as Router12 } from "express";
 init_paths();
 import Database3 from "better-sqlite3";
 import { randomUUID as randomUUID3 } from "crypto";
-import { resolve as resolve29 } from "path";
+import { resolve as resolve31 } from "path";
 var db3 = null;
 var LEASE_SCHEMA_VERSION = "1";
 var SCHEMA_SQL3 = `
@@ -20337,7 +20625,7 @@ function isBusyError(err) {
 }
 function initLeasesDb(dbPath) {
   if (db3) return db3;
-  const finalPath = dbPath ?? resolve29(syntaurRoot(), "syntaur.db");
+  const finalPath = dbPath ?? resolve31(syntaurRoot(), "syntaur.db");
   db3 = new Database3(finalPath);
   db3.pragma("journal_mode = WAL");
   db3.pragma("busy_timeout = 5000");
@@ -20489,15 +20777,15 @@ init_fs();
 init_paths();
 init_timestamp();
 import { randomUUID as randomUUID4 } from "crypto";
-import { readFile as readFile20, readdir as readdir14, rm as rm3 } from "fs/promises";
-import { resolve as resolve30 } from "path";
+import { readFile as readFile22, readdir as readdir16, rm as rm3 } from "fs/promises";
+import { resolve as resolve32 } from "path";
 function schedulesDir() {
   const override3 = process.env.SYNTAUR_SCHEDULES_DIR;
-  if (override3 && override3.length > 0) return resolve30(override3);
-  return resolve30(syntaurRoot(), "schedules");
+  if (override3 && override3.length > 0) return resolve32(override3);
+  return resolve32(syntaurRoot(), "schedules");
 }
 function jobPath(id) {
-  return resolve30(schedulesDir(), `${jobFileSafe(id)}.md`);
+  return resolve32(schedulesDir(), `${jobFileSafe(id)}.md`);
 }
 function jobFileSafe(id) {
   if (!/^[A-Za-z0-9_-]+$/.test(id)) {
@@ -20622,7 +20910,7 @@ function validateJob(raw2) {
 async function readJob(id) {
   const path = jobPath(id);
   if (!await fileExists(path)) return null;
-  return parseJobFile(await readFile20(path, "utf-8"));
+  return parseJobFile(await readFile22(path, "utf-8"));
 }
 async function writeJob(job) {
   const next = { ...job, updatedAt: nowTimestamp() };
@@ -20632,7 +20920,7 @@ async function writeJob(job) {
 async function listJobs() {
   let names;
   try {
-    names = await readdir14(schedulesDir());
+    names = await readdir16(schedulesDir());
   } catch {
     return [];
   }
@@ -20640,7 +20928,7 @@ async function listJobs() {
   for (const name of names) {
     if (!name.endsWith(".md")) continue;
     try {
-      jobs.push(parseJobFile(await readFile20(resolve30(schedulesDir(), name), "utf-8")));
+      jobs.push(parseJobFile(await readFile22(resolve32(schedulesDir(), name), "utf-8")));
     } catch {
     }
   }
@@ -20650,13 +20938,13 @@ async function listJobs() {
 
 // src/schedules/event-log.ts
 init_timestamp();
-import { appendFile, readFile as readFile21, mkdir as mkdir3 } from "fs/promises";
-import { dirname as dirname8, resolve as resolve31 } from "path";
+import { appendFile, readFile as readFile23, mkdir as mkdir3 } from "fs/promises";
+import { dirname as dirname8, resolve as resolve33 } from "path";
 function eventLogPath(jobId) {
   if (!/^[A-Za-z0-9_-]+$/.test(jobId)) {
     throw new Error(`Unsafe schedule id: ${JSON.stringify(jobId)}`);
   }
-  return resolve31(schedulesDir(), `${jobId}.jsonl`);
+  return resolve33(schedulesDir(), `${jobId}.jsonl`);
 }
 async function appendEvent(jobId, type, data) {
   const event = { type, at: nowTimestamp(), ...data ? { data } : {} };
@@ -20669,7 +20957,7 @@ async function appendEvent(jobId, type, data) {
 async function readEvents(jobId) {
   let content;
   try {
-    content = await readFile21(eventLogPath(jobId), "utf-8");
+    content = await readFile23(eventLogPath(jobId), "utf-8");
   } catch {
     return [];
   }
@@ -20688,8 +20976,8 @@ async function readEvents(jobId) {
 
 // src/schedules/attempt.ts
 import { createHash as createHash3 } from "crypto";
-import { open as open4, readFile as readFile22, stat as stat5, unlink as unlink6 } from "fs/promises";
-import { resolve as resolve32 } from "path";
+import { open as open4, readFile as readFile24, stat as stat5, unlink as unlink6 } from "fs/promises";
+import { resolve as resolve34 } from "path";
 
 // src/schedules/triggers.ts
 import { Cron } from "croner";
@@ -20868,7 +21156,7 @@ var LOCK_WAIT_MS2 = 50;
 var LOCK_MAX_WAITS2 = 100;
 var MAX_CONSUMED_EDGES = 50;
 async function acquireJobLock(id) {
-  const lockPath = resolve32(schedulesDir(), `${id}.lock`);
+  const lockPath = resolve34(schedulesDir(), `${id}.lock`);
   const token = `${process.pid}:${createHash3("sha256").update(`${Math.random()}${Date.now()}`).digest("hex").slice(0, 12)}`;
   for (let attempt = 0; attempt <= LOCK_MAX_WAITS2; attempt++) {
     try {
@@ -20877,7 +21165,7 @@ async function acquireJobLock(id) {
       await handle.close();
       return async () => {
         try {
-          const current = await readFile22(lockPath, "utf-8");
+          const current = await readFile24(lockPath, "utf-8");
           if (current === token) await unlink6(lockPath);
         } catch {
         }
@@ -21183,7 +21471,7 @@ async function reapStale(jobs, deps) {
 
 // src/schedules/unattended.ts
 import { existsSync as existsSync3 } from "fs";
-import { resolve as resolve33 } from "path";
+import { resolve as resolve35 } from "path";
 var UnattendedRefusalError = class extends Error {
   constructor(message) {
     super(message);
@@ -21199,7 +21487,7 @@ function assertUnattendedTerminalSupported(terminal) {
 }
 function isKillSwitchEngaged() {
   if (process.env.SYNTAUR_SCHEDULES_DISABLED === "1") return true;
-  return existsSync3(resolve33(schedulesDir(), "KILL"));
+  return existsSync3(resolve35(schedulesDir(), "KILL"));
 }
 function canFire(job, deps) {
   const killSwitch = deps.killSwitch ?? isKillSwitchEngaged;
@@ -21350,20 +21638,20 @@ init_config2();
 init_paths();
 init_assignment_resolver();
 init_frontmatter();
-import { readFile as readFile23 } from "fs/promises";
-import { resolve as resolve34 } from "path";
+import { readFile as readFile25 } from "fs/promises";
+import { resolve as resolve36 } from "path";
 
 // src/schedules/launch-ack.ts
 init_session_id();
 import { readdirSync as readdirSync2 } from "fs";
-import { homedir as homedir6 } from "os";
-import { join as join8 } from "path";
+import { homedir as homedir7 } from "os";
+import { join as join10 } from "path";
 function defaultSleep(ms) {
   return new Promise((r) => setTimeout(r, ms));
 }
 function runtimeSessionsDir() {
   const override3 = process.env.SYNTAUR_RUNTIME_SESSIONS_DIR;
-  return override3 && override3.length > 0 ? override3 : join8(homedir6(), ".syntaur", "runtime", "sessions");
+  return override3 && override3.length > 0 ? override3 : join10(homedir7(), ".syntaur", "runtime", "sessions");
 }
 function defaultAckProbe(handle) {
   const dir = runtimeSessionsDir();
@@ -21411,7 +21699,7 @@ async function defaultReadAssignment(assignmentId) {
   const resolved = await resolveAssignmentById(projectsDir, assignmentsDir(), assignmentId);
   if (!resolved) return null;
   try {
-    const content = await readFile23(resolve34(resolved.assignmentDir, "assignment.md"), "utf-8");
+    const content = await readFile25(resolve36(resolved.assignmentDir, "assignment.md"), "utf-8");
     return parseAssignmentFrontmatter(content);
   } catch {
     return null;
@@ -21503,7 +21791,7 @@ import { Router as Router14 } from "express";
 // src/db/usage-db.ts
 init_paths();
 import Database4 from "better-sqlite3";
-import { resolve as resolve35 } from "path";
+import { resolve as resolve37 } from "path";
 var db4 = null;
 var USAGE_SCHEMA_VERSION = "1";
 var SCHEMA_SQL4 = `
@@ -21577,7 +21865,7 @@ function nowIso2() {
 }
 function initUsageDb(dbPath) {
   if (db4) return db4;
-  const finalPath = dbPath ?? resolve35(syntaurRoot(), "syntaur.db");
+  const finalPath = dbPath ?? resolve37(syntaurRoot(), "syntaur.db");
   db4 = new Database4(finalPath);
   db4.pragma("journal_mode = WAL");
   db4.pragma("busy_timeout = 5000");
@@ -22190,14 +22478,14 @@ init_fs();
 init_parser();
 init_events_db();
 import { Router as Router15 } from "express";
-import { resolve as resolve36 } from "path";
-import { readFile as readFile24 } from "fs/promises";
+import { resolve as resolve38 } from "path";
+import { readFile as readFile26 } from "fs/promises";
 function createEventsRouter(projectsDir, assignmentsDir2) {
   const router = Router15();
   router.get("/projects/:slug/assignments/:aslug/events", async (req2, res) => {
     try {
       const { slug, aslug } = req2.params;
-      const assignmentMdPath = resolve36(
+      const assignmentMdPath = resolve38(
         projectsDir,
         slug,
         "assignments",
@@ -22218,7 +22506,7 @@ function createEventsRouter(projectsDir, assignmentsDir2) {
   router.get("/standalone/assignments/:id/events", async (req2, res) => {
     try {
       const { id: dirId } = req2.params;
-      const assignmentMdPath = resolve36(assignmentsDir2, dirId, "assignment.md");
+      const assignmentMdPath = resolve38(assignmentsDir2, dirId, "assignment.md");
       const id = await readAssignmentId2(assignmentMdPath) ?? dirId;
       res.json({ events: loadEvents(id, req2.query) });
     } catch (error) {
@@ -22230,7 +22518,7 @@ function createEventsRouter(projectsDir, assignmentsDir2) {
 }
 async function readAssignmentId2(assignmentMdPath) {
   if (!await fileExists(assignmentMdPath)) return null;
-  const content = await readFile24(assignmentMdPath, "utf-8");
+  const content = await readFile26(assignmentMdPath, "utf-8");
   const [fm] = extractFrontmatter2(content);
   const id = getField(fm, "id");
   return id && id.length > 0 ? id : null;
@@ -22275,8 +22563,8 @@ init_assignment_walk();
 init_parser();
 init_facts();
 init_state_machine();
-import { resolve as resolve37 } from "path";
-import { readFile as readFile25 } from "fs/promises";
+import { resolve as resolve39 } from "path";
+import { readFile as readFile27 } from "fs/promises";
 
 // src/inbox/types.ts
 var INBOX_CATEGORIES = [
@@ -22456,7 +22744,7 @@ async function computeInbox(opts) {
     if (opts.project !== void 0 && entry.projectSlug !== opts.project) continue;
     let parsed;
     try {
-      const content = await readFile25(resolve37(entry.assignmentDir, "assignment.md"), "utf-8");
+      const content = await readFile27(resolve39(entry.assignmentDir, "assignment.md"), "utf-8");
       parsed = parseAssignmentFull(content);
     } catch {
       continue;
@@ -22499,10 +22787,10 @@ async function computeInbox(opts) {
       });
     }
     if (!typeFilter || typeFilter.has("question")) {
-      const commentsPath = resolve37(entry.assignmentDir, "comments.md");
+      const commentsPath = resolve39(entry.assignmentDir, "comments.md");
       if (await fileExists(commentsPath)) {
         try {
-          const content = await readFile25(commentsPath, "utf-8");
+          const content = await readFile27(commentsPath, "utf-8");
           const parsedComments = parseComments(content);
           for (const c of unresolvedQuestions(parsedComments.entries)) {
             const since = resolveSince("question", parsed, now, c);
@@ -22613,8 +22901,8 @@ init_slug();
 init_timestamp();
 init_fs();
 import { Router as Router17 } from "express";
-import { resolve as resolve38 } from "path";
-import { readFile as readFile26 } from "fs/promises";
+import { resolve as resolve40 } from "path";
+import { readFile as readFile28 } from "fs/promises";
 init_playbooks();
 function statusForPlaybookError(code) {
   switch (code) {
@@ -22696,8 +22984,8 @@ function createPlaybooksRouter(playbooksDir2) {
         res.status(404).json({ error: `Playbook "${req2.params.slug}" not found` });
         return;
       }
-      const filePath = resolve38(playbooksDir2, resolved.filename);
-      const content = await readFile26(filePath, "utf-8");
+      const filePath = resolve40(playbooksDir2, resolved.filename);
+      const content = await readFile28(filePath, "utf-8");
       res.json({
         documentType: "playbook",
         title: `Edit Playbook: ${resolved.slug}`,
@@ -22722,7 +23010,7 @@ function createPlaybooksRouter(playbooksDir2) {
         return;
       }
       await ensureDir(playbooksDir2);
-      const filePath = resolve38(playbooksDir2, `${slug}.md`);
+      const filePath = resolve40(playbooksDir2, `${slug}.md`);
       if (await fileExists(filePath)) {
         res.status(409).json({ error: `Playbook "${slug}" already exists` });
         return;
@@ -22746,7 +23034,7 @@ function createPlaybooksRouter(playbooksDir2) {
         res.status(404).json({ error: `Playbook "${req2.params.slug}" not found` });
         return;
       }
-      const filePath = resolve38(playbooksDir2, resolved.filename);
+      const filePath = resolve40(playbooksDir2, resolved.filename);
       await writeFileForce(filePath, content);
       await rebuildPlaybookManifest(playbooksDir2);
       res.json({ slug: resolved.slug, path: filePath });
@@ -22794,7 +23082,7 @@ init_parser2();
 init_fs();
 init_paths();
 import { Router as Router19 } from "express";
-import { readdir as readdir16 } from "fs/promises";
+import { readdir as readdir18 } from "fs/promises";
 import { resolve as resolvePath, dirname as dirname10 } from "path";
 import { rename as rename6, mkdir as mkdir5 } from "fs/promises";
 init_slug();
@@ -22809,7 +23097,7 @@ init_uuid();
 init_paths();
 init_fs();
 init_config2();
-import { resolve as resolve39 } from "path";
+import { resolve as resolve41 } from "path";
 async function createAssignmentCommand(title, options) {
   if (!title.trim()) {
     throw new Error("Assignment title cannot be empty.");
@@ -22884,14 +23172,14 @@ async function createAssignmentCommand(title, options) {
   if (options.oneOff) {
     const standaloneRoot = assignmentsDir();
     folderName = id;
-    assignmentDir = resolve39(standaloneRoot, folderName);
+    assignmentDir = resolve41(standaloneRoot, folderName);
     projectSlug = null;
     await ensureDir(standaloneRoot);
   } else {
     const baseDir = options.dir ? expandHome(options.dir) : config.defaultProjectDir;
     projectSlug = options.project;
-    const projectDir = resolve39(baseDir, projectSlug);
-    const projectMdPath = resolve39(projectDir, "project.md");
+    const projectDir = resolve41(baseDir, projectSlug);
+    const projectMdPath = resolve41(projectDir, "project.md");
     if (!await fileExists(projectDir) || !await fileExists(projectMdPath)) {
       throw new Error(
         `Project "${projectSlug}" not found at ${projectDir}.
@@ -22899,9 +23187,9 @@ Run 'syntaur create-project' first or use --one-off.`
       );
     }
     if (dependsOn.length > 0) {
-      const depDirBase = resolve39(projectDir, "assignments");
+      const depDirBase = resolve41(projectDir, "assignments");
       for (const dep of dependsOn) {
-        const depDir = resolve39(depDirBase, dep);
+        const depDir = resolve41(depDirBase, dep);
         if (!await fileExists(depDir)) {
           console.warn(
             `Warning: dependency "${dep}" does not exist in project "${projectSlug}" yet.`
@@ -22910,7 +23198,7 @@ Run 'syntaur create-project' first or use --one-off.`
       }
     }
     folderName = assignmentSlug;
-    assignmentDir = resolve39(projectDir, "assignments", folderName);
+    assignmentDir = resolve41(projectDir, "assignments", folderName);
   }
   if (await fileExists(assignmentDir)) {
     throw new Error(
@@ -22922,7 +23210,7 @@ Use --slug to specify a different slug.`
   const companionAssignmentRef = projectSlug === null ? id : assignmentSlug;
   const files = [
     [
-      resolve39(assignmentDir, "assignment.md"),
+      resolve41(assignmentDir, "assignment.md"),
       renderAssignment({
         id,
         slug: assignmentSlug,
@@ -22940,35 +23228,35 @@ Use --slug to specify a different slug.`
       })
     ],
     [
-      resolve39(assignmentDir, "scratchpad.md"),
+      resolve41(assignmentDir, "scratchpad.md"),
       renderScratchpad({
         assignmentSlug: companionAssignmentRef,
         timestamp
       })
     ],
     [
-      resolve39(assignmentDir, "handoff.md"),
+      resolve41(assignmentDir, "handoff.md"),
       renderHandoff({
         assignmentSlug: companionAssignmentRef,
         timestamp
       })
     ],
     [
-      resolve39(assignmentDir, "decision-record.md"),
+      resolve41(assignmentDir, "decision-record.md"),
       renderDecisionRecord({
         assignmentSlug: companionAssignmentRef,
         timestamp
       })
     ],
     [
-      resolve39(assignmentDir, "progress.md"),
+      resolve41(assignmentDir, "progress.md"),
       renderProgress({
         assignment: companionAssignmentRef,
         timestamp
       })
     ],
     [
-      resolve39(assignmentDir, "comments.md"),
+      resolve41(assignmentDir, "comments.md"),
       renderComments({
         assignment: companionAssignmentRef,
         timestamp
@@ -23141,8 +23429,8 @@ init_api();
 import { raw } from "express";
 
 // src/todos/attachments.ts
-import { mkdir as mkdir4, readdir as readdir15, stat as stat6, rename as rename5, rm as rm4, unlink as unlink7, writeFile as writeFile6, cp } from "fs/promises";
-import { resolve as resolve40, basename as basename6, dirname as dirname9, extname } from "path";
+import { mkdir as mkdir4, readdir as readdir17, stat as stat6, rename as rename5, rm as rm4, unlink as unlink7, writeFile as writeFile6, cp } from "fs/promises";
+import { resolve as resolve42, basename as basename6, dirname as dirname9, extname } from "path";
 
 // src/utils/proof-artifact-id.ts
 import { randomBytes as randomBytes2 } from "crypto";
@@ -23229,12 +23517,12 @@ function sanitizeAttachmentName(name) {
   return n;
 }
 function attachmentsRootDir(todosDir2) {
-  return resolve40(todosDir2, "attachments");
+  return resolve42(todosDir2, "attachments");
 }
 function attachmentDirFor(todosDir2, scopeId, todoId) {
   assertScope(scopeId);
   assertTodoId(todoId);
-  return resolve40(attachmentsRootDir(todosDir2), scopeId, todoId);
+  return resolve42(attachmentsRootDir(todosDir2), scopeId, todoId);
 }
 async function dirExists(p) {
   try {
@@ -23248,7 +23536,7 @@ async function writeAttachment(todosDir2, scopeId, todoId, originalName, bytes)
   await mkdir4(dir, { recursive: true });
   const id = generateArtifactId();
   const filename = sanitizeAttachmentName(originalName);
-  await writeFile6(resolve40(dir, `${id}__${filename}`), bytes);
+  await writeFile6(resolve42(dir, `${id}__${filename}`), bytes);
   return {
     id,
     filename,
@@ -23261,7 +23549,7 @@ async function listAttachments(todosDir2, scopeId, todoId) {
   const dir = attachmentDirFor(todosDir2, scopeId, todoId);
   let names;
   try {
-    names = await readdir15(dir);
+    names = await readdir17(dir);
   } catch {
     return [];
   }
@@ -23273,7 +23561,7 @@ async function listAttachments(todosDir2, scopeId, todoId) {
     if (!ATTACHMENT_ID_RE.test(id)) continue;
     const filename = stored.slice(sep2 + 2);
     try {
-      const st = await stat6(resolve40(dir, stored));
+      const st = await stat6(resolve42(dir, stored));
       if (!st.isFile()) continue;
       out.push({ id, filename, mime: mimeForName(filename), size: st.size, createdAt: st.mtime.toISOString() });
     } catch {
@@ -23284,10 +23572,10 @@ async function listAttachments(todosDir2, scopeId, todoId) {
 }
 async function readScopeAttachments(todosDir2, scopeId) {
   assertScope(scopeId);
-  const scopeDir = resolve40(attachmentsRootDir(todosDir2), scopeId);
+  const scopeDir = resolve42(attachmentsRootDir(todosDir2), scopeId);
   let todoIds;
   try {
-    todoIds = await readdir15(scopeDir);
+    todoIds = await readdir17(scopeDir);
   } catch {
     return {};
   }
@@ -23304,7 +23592,7 @@ async function resolveAttachmentFile(todosDir2, scopeId, todoId, attachmentId) {
   const dir = attachmentDirFor(todosDir2, scopeId, todoId);
   let names;
   try {
-    names = await readdir15(dir);
+    names = await readdir17(dir);
   } catch {
     return null;
   }
@@ -23312,7 +23600,7 @@ async function resolveAttachmentFile(todosDir2, scopeId, todoId, attachmentId) {
   const stored = names.find((n) => n.startsWith(prefix));
   if (!stored) return null;
   const filename = stored.slice(prefix.length);
-  return { path: resolve40(dir, stored), filename, mime: mimeForName(filename) };
+  return { path: resolve42(dir, stored), filename, mime: mimeForName(filename) };
 }
 async function deleteAttachment(todosDir2, scopeId, todoId, attachmentId) {
   const resolved = await resolveAttachmentFile(todosDir2, scopeId, todoId, attachmentId);
@@ -23608,7 +23896,7 @@ function createTodosRouter(todosDir2, broadcast, projectsDir) {
   router.get("/", async (_req, res) => {
     try {
       await ensureDir(todosDir2);
-      const files = await readdir16(todosDir2).catch(() => []);
+      const files = await readdir18(todosDir2).catch(() => []);
       const workspaces = [];
       for (const file of files) {
         if (typeof file !== "string") continue;
@@ -23729,7 +24017,7 @@ function createTodosRouter(todosDir2, broadcast, projectsDir) {
     try {
       const { archivePath: archivePath2 } = await Promise.resolve().then(() => (init_parser2(), parser_exports));
       const { resolve: resolve49 } = await import("path");
-      const { readFile: readFile31 } = await import("fs/promises");
+      const { readFile: readFile32 } = await import("fs/promises");
       const { writeFileForce: writeFileForce2 } = await Promise.resolve().then(() => (init_fs(), fs_exports));
       const workspace = getWorkspaceParam(req2.params.workspace);
       const outcome = await wsLock(workspace, async () => {
@@ -23748,7 +24036,7 @@ function createTodosRouter(todosDir2, broadcast, projectsDir) {
         await ensureDir(resolve49(todosDir2, "archive"));
         let archContent = "";
         if (await fileExists(archFile)) {
-          archContent = await readFile31(archFile, "utf-8");
+          archContent = await readFile32(archFile, "utf-8");
           archContent = archContent.trimEnd() + "\n\n";
         } else {
           archContent = `---
@@ -24049,7 +24337,7 @@ workspace: ${workspace}
         const { readConfig: readConfig2 } = 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: readFile31 } = await import("fs/promises");
+        const { readFile: readFile32 } = 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;
@@ -24070,7 +24358,7 @@ workspace: ${workspace}
         }
         const assignmentMdPath = resolvePath2(assignmentDir, "assignment.md");
         if (!await fileExists2(assignmentMdPath)) return { error: `Target assignment not found: ${assignmentMdPath}` };
-        let content = await readFile31(assignmentMdPath, "utf-8");
+        let content = await readFile32(assignmentMdPath, "utf-8");
         content = appendTodosToAssignmentBody2(
           content,
           items.map((it) => ({
@@ -24265,8 +24553,8 @@ init_fs();
 init_paths();
 init_slug();
 import { Router as Router20 } from "express";
-import { mkdir as mkdir6, readFile as readFile27, rename as rename7 } from "fs/promises";
-import { resolve as resolve41, dirname as dirname11 } from "path";
+import { mkdir as mkdir6, readFile as readFile29, rename as rename7 } from "fs/promises";
+import { resolve as resolve43, dirname as dirname11 } from "path";
 init_api();
 var WORKSPACE_REGEX2 = /^[a-z0-9_][a-z0-9-]*$/;
 function touchItem4(item) {
@@ -24282,7 +24570,7 @@ function params(req2) {
   return req2.params;
 }
 async function projectExists(projectsDir, slug) {
-  return fileExists(resolve41(projectsDir, slug, "project.md"));
+  return fileExists(resolve43(projectsDir, slug, "project.md"));
 }
 async function ensureProjectTodosDir(projectsDir, slug) {
   const todosDir2 = projectTodosDir(projectsDir, slug);
@@ -24299,7 +24587,7 @@ async function ensureProjectTodosDir(projectsDir, slug) {
     throw err;
   }
   try {
-    await mkdir6(resolve41(todosDir2, "archive"), { recursive: false });
+    await mkdir6(resolve43(todosDir2, "archive"), { recursive: false });
   } catch (err) {
     const code = err.code;
     if (code === "EEXIST") return;
@@ -24507,7 +24795,7 @@ function createProjectTodosRouter(projectsDir, broadcast, workspaceTodosDir) {
         const archFile = archivePath(todosDir2, slug, checklist.archiveInterval);
         let archContent = "";
         if (await fileExists(archFile)) {
-          archContent = await readFile27(archFile, "utf-8");
+          archContent = await readFile29(archFile, "utf-8");
           archContent = archContent.trimEnd() + "\n\n";
         } else {
           archContent = `---
@@ -24978,17 +25266,17 @@ workspace: ${slug}
         if (tg.includes("/")) {
           const parts = tg.split("/");
           if (parts.length !== 2) return { error: `Invalid target.assignment "${tg}"` };
-          assignmentDir = resolve41(projectsDir, parts[0], "assignments", parts[1]);
+          assignmentDir = resolve43(projectsDir, parts[0], "assignments", parts[1]);
           assignmentRef = `${parts[0]}/${parts[1]}`;
         } else if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(tg)) {
-          assignmentDir = resolve41(assignmentsDirFn(), tg);
+          assignmentDir = resolve43(assignmentsDirFn(), tg);
           assignmentRef = tg;
         } else {
           return { error: `Invalid target.assignment "${tg}"` };
         }
-        const assignmentMdPath = resolve41(assignmentDir, "assignment.md");
+        const assignmentMdPath = resolve43(assignmentDir, "assignment.md");
         if (!await fileExists(assignmentMdPath)) return { error: `Target assignment not found: ${assignmentMdPath}` };
-        let content = await readFile27(assignmentMdPath, "utf-8");
+        let content = await readFile29(assignmentMdPath, "utf-8");
         content = appendTodosToAssignmentBody2(
           content,
           items.map((it) => ({
@@ -25191,7 +25479,7 @@ workspace: ${slug}
 
 // src/dashboard/api-bundles.ts
 import { Router as Router21 } from "express";
-import { readdir as readdir17 } from "fs/promises";
+import { readdir as readdir19 } from "fs/promises";
 
 // src/todos/bundle-parser.ts
 init_parser();
@@ -25199,7 +25487,7 @@ init_fs();
 init_paths();
 init_parser2();
 import { randomBytes as randomBytes3 } from "crypto";
-import { readFile as readFile28 } from "fs/promises";
+import { readFile as readFile30 } 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_-]*$/;
@@ -25266,7 +25554,7 @@ function parseBundles(content) {
 async function readBundles(todosDir2) {
   const path = bundlesPath(todosDir2);
   if (!await fileExists(path)) return [];
-  const content = await readFile28(path, "utf-8");
+  const content = await readFile30(path, "utf-8");
   return parseBundles(content).bundles;
 }
 
@@ -25315,7 +25603,7 @@ function createBundlesRouter(todosDir2, broadcast) {
     try {
       await ensureDir(todosDir2);
       const bundles = await readBundles(todosDir2);
-      const workspaceFiles = await readdir17(todosDir2).catch(() => []);
+      const workspaceFiles = await readdir19(todosDir2).catch(() => []);
       const itemsByKey = /* @__PURE__ */ new Map();
       for (const f of workspaceFiles) {
         if (typeof f !== "string") continue;
@@ -25368,7 +25656,7 @@ init_fs();
 init_paths();
 init_slug();
 import { Router as Router22 } from "express";
-import { resolve as resolve42 } from "path";
+import { resolve as resolve44 } from "path";
 init_parser2();
 function deriveStatus2(bundle, items) {
   const members = bundle.todoIds.map((id) => items.find((i) => i.id === id)).filter((i) => i !== void 0);
@@ -25410,7 +25698,7 @@ function createProjectBundlesRouter(projectsDir, broadcast) {
   router.get("/", async (req2, res) => {
     try {
       const slug = getProjectIdParam2(req2.params.projectId);
-      const projectMd = resolve42(projectsDir, slug, "project.md");
+      const projectMd = resolve44(projectsDir, slug, "project.md");
       if (!await fileExists(projectMd)) {
         notFound2(res, slug);
         return;
@@ -25439,8 +25727,8 @@ init_fs();
 init_config2();
 import { execFile as execFile2 } from "child_process";
 import { promisify as promisify2 } from "util";
-import { cp as cp2, mkdtemp, rm as rm5, readFile as readFile29, writeFile as writeFile7, unlink as unlink8, stat as stat7, open as open5, rename as rename8 } from "fs/promises";
-import { resolve as resolve43, join as join9 } from "path";
+import { cp as cp2, mkdtemp, rm as rm5, readFile as readFile31, writeFile as writeFile7, unlink as unlink8, stat as stat7, open as open5, rename as rename8 } from "fs/promises";
+import { resolve as resolve45, join as join11 } from "path";
 import { tmpdir } from "os";
 var exec2 = promisify2(execFile2);
 var VALID_CATEGORIES = ["projects", "playbooks", "todos", "servers", "config"];
@@ -25480,7 +25768,7 @@ async function resolveCategoryPath(category) {
     case "servers":
       return { sourcePath: serversDir(), repoPath: "servers", isFile: false };
     case "config":
-      return { sourcePath: resolve43(syntaurRoot(), "config.md"), repoPath: "config.md", isFile: true };
+      return { sourcePath: resolve45(syntaurRoot(), "config.md"), repoPath: "config.md", isFile: true };
   }
 }
 async function checkGitInstalled() {
@@ -25491,7 +25779,7 @@ async function checkGitInstalled() {
   }
 }
 async function acquireLock2() {
-  const lockPath = resolve43(syntaurRoot(), LOCK_FILE_NAME);
+  const lockPath = resolve45(syntaurRoot(), LOCK_FILE_NAME);
   await ensureDir(syntaurRoot());
   try {
     const handle = await open5(lockPath, "wx");
@@ -25500,7 +25788,7 @@ async function acquireLock2() {
     return lockPath;
   } catch (err) {
     if (err.code === "EEXIST") {
-      const pid = await readFile29(lockPath, "utf-8").catch(() => "");
+      const pid = await readFile31(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.`
       );
@@ -25538,7 +25826,7 @@ async function copyRecursive(src, dest) {
     await ensureDir(dest);
     await cp2(src, dest, { recursive: true, force: true });
   } else {
-    await ensureDir(resolve43(dest, ".."));
+    await ensureDir(resolve45(dest, ".."));
     await cp2(src, dest, { force: true });
   }
 }
@@ -25547,7 +25835,7 @@ function resolveCategoriesStrict(csv) {
   return parseCategoriesStrict(parts);
 }
 async function readSanitizedConfig(configPath) {
-  const content = await readFile29(configPath, "utf-8");
+  const content = await readFile31(configPath, "utf-8");
   return content.replace(/^(\s*lastBackup:\s*).*$/m, "$1null").replace(/^(\s*lastRestore:\s*).*$/m, "$1null");
 }
 async function backupToGithub(overrides) {
@@ -25570,11 +25858,11 @@ async function backupToGithub(overrides) {
   let tmpDir = null;
   const timestamp = (/* @__PURE__ */ new Date()).toISOString();
   try {
-    tmpDir = await mkdtemp(join9(tmpdir(), "syntaur-backup-"));
+    tmpDir = await mkdtemp(join11(tmpdir(), "syntaur-backup-"));
     await cloneOrInit(repo, tmpDir);
     for (const category of categories) {
       const { sourcePath, repoPath, isFile } = await resolveCategoryPath(category);
-      const destPath = join9(tmpDir, repoPath);
+      const destPath = join11(tmpDir, repoPath);
       if (isFile) {
         await rm5(destPath, { force: true });
       } else {
@@ -25586,7 +25874,7 @@ async function backupToGithub(overrides) {
       }
       if (category === "config") {
         const sanitized = await readSanitizedConfig(sourcePath);
-        await ensureDir(resolve43(destPath, ".."));
+        await ensureDir(resolve45(destPath, ".."));
         await writeFile7(destPath, sanitized, "utf-8");
       } else {
         await copyRecursive(sourcePath, destPath);
@@ -25640,7 +25928,7 @@ async function backupToGithub(overrides) {
 }
 async function safeRestoreCategory(localPath, repoSrcPath, isFile) {
   if (isFile) {
-    await ensureDir(resolve43(localPath, ".."));
+    await ensureDir(resolve45(localPath, ".."));
     await cp2(repoSrcPath, localPath, { force: true });
     return;
   }
@@ -25702,7 +25990,7 @@ async function restoreFromGithub(overrides) {
   const timestamp = (/* @__PURE__ */ new Date()).toISOString();
   try {
     await updateBackupConfig({ lastRestore: timestamp });
-    tmpDir = await mkdtemp(join9(tmpdir(), "syntaur-restore-"));
+    tmpDir = await mkdtemp(join11(tmpdir(), "syntaur-restore-"));
     await cloneOrInit(repo, tmpDir);
     for (const category of categories) {
       if (category === "config") {
@@ -25711,7 +25999,7 @@ async function restoreFromGithub(overrides) {
       }
       try {
         const { sourcePath: localPath, repoPath, isFile } = await resolveCategoryPath(category);
-        const repoSrcPath = join9(tmpDir, repoPath);
+        const repoSrcPath = join11(tmpDir, repoPath);
         if (!await fileExists(repoSrcPath)) {
           console.warn(`Category "${category}" not found in backup repo, skipping.`);
           continue;
@@ -25741,7 +26029,7 @@ async function restoreFromGithub(overrides) {
 }
 async function getBackupStatus() {
   const config = await readConfig();
-  const lockPath = resolve43(syntaurRoot(), LOCK_FILE_NAME);
+  const lockPath = resolve45(syntaurRoot(), LOCK_FILE_NAME);
   const locked = await fileExists(lockPath);
   return {
     repo: config.backup?.repo ?? null,