syntaur 0.23.0 → 0.25.0

package/dist/dashboard/server.js

@@ -388,9 +388,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 });
@@ -421,6 +422,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";
@@ -762,7 +779,7 @@ __export(parser_exports, {
   writeChecklist: () => writeChecklist
 });
 import { randomBytes } from "crypto";
-import { readFile } from "fs/promises";
+import { readFile as readFile2 } from "fs/promises";
 import { resolve as resolve2 } from "path";
 function generateShortId() {
   return randomBytes(2).toString("hex");
@@ -1059,7 +1076,7 @@ async function readChecklist(todosDir2, workspace) {
   if (!await fileExists(path)) {
     return { workspace, archiveInterval: "weekly", items: [] };
   }
-  const content = await readFile(path, "utf-8");
+  const content = await readFile2(path, "utf-8");
   return parseChecklist(content);
 }
 async function writeChecklist(todosDir2, checklist) {
@@ -1072,7 +1089,7 @@ async function readLog(todosDir2, workspace) {
   if (!await fileExists(path)) {
     return { workspace, entries: [] };
   }
-  const content = await readFile(path, "utf-8");
+  const content = await readFile2(path, "utf-8");
   return parseLog(content);
 }
 async function appendLogEntry(todosDir2, workspace, entry) {
@@ -1080,7 +1097,7 @@ async function appendLogEntry(todosDir2, workspace, entry) {
   const path = logPath(todosDir2, workspace);
   let content;
   if (await fileExists(path)) {
-    content = await readFile(path, "utf-8");
+    content = await readFile2(path, "utf-8");
     content = content.trimEnd() + "\n\n" + serializeLogEntry(entry) + "\n";
   } else {
     const fm = `---
@@ -1248,7 +1265,7 @@ var init_linked_todos = __esm({
 
 // src/lifecycle/transitions.ts
 import { resolve as resolve4 } from "path";
-import { readFile as readFile2 } from "fs/promises";
+import { readFile as readFile3 } from "fs/promises";
 function linkedAssignmentRef(frontmatter) {
   return frontmatter.project ? `${frontmatter.project}/${frontmatter.slug}` : frontmatter.id;
 }
@@ -1268,7 +1285,7 @@ async function readAssignment(filePath) {
   if (!await fileExists(filePath)) {
     throw new Error(`Assignment file not found: ${filePath}`);
   }
-  const content = await readFile2(filePath, "utf-8");
+  const content = await readFile3(filePath, "utf-8");
   const frontmatter = parseAssignmentFrontmatter(content);
   return { content, frontmatter };
 }
@@ -1281,7 +1298,7 @@ async function checkDependencies(projectDir, dependsOn, terminalStatuses) {
       unmet.push(`${depSlug} (file not found)`);
       continue;
     }
-    const depContent = await readFile2(depPath, "utf-8");
+    const depContent = await readFile3(depPath, "utf-8");
     const depFrontmatter = parseAssignmentFrontmatter(depContent);
     if (!terminals.has(depFrontmatter.status)) {
       unmet.push(`${depSlug} (status: ${depFrontmatter.status})`);
@@ -1431,7 +1448,7 @@ var init_config = __esm({
 });
 
 // src/utils/fs-migration.ts
-import { readdir as readdir2, readFile as readFile3, rename as rename2, writeFile as writeFile2 } from "fs/promises";
+import { readdir as readdir2, readFile as readFile4, rename as rename2, writeFile as writeFile2 } from "fs/promises";
 import { resolve as resolve5 } from "path";
 async function migrateLegacyProjectFiles(projectsDir) {
   const result = {
@@ -1500,7 +1517,7 @@ async function migrateLegacyArchivedProjects(projectsDir) {
     const projectMd = resolve5(projectsDir, entry.name, "project.md");
     try {
       if (!await fileExists(projectMd)) continue;
-      const content = await readFile3(projectMd, "utf-8");
+      const content = await readFile4(projectMd, "utf-8");
       if (readFrontmatterField(content, "statusOverride") !== "archived") continue;
       let next = setFrontmatterField(content, "archived", true);
       if (readFrontmatterField(content, "archivedAt") === null) {
@@ -1525,7 +1542,7 @@ async function migrateLegacyConfig(configPath) {
   if (!await fileExists(configPath)) return result;
   let content;
   try {
-    content = await readFile3(configPath, "utf-8");
+    content = await readFile4(configPath, "utf-8");
   } catch {
     return result;
   }
@@ -1782,7 +1799,7 @@ __export(config_exports, {
   writeTerminalConfig: () => writeTerminalConfig,
   writeThemeConfig: () => writeThemeConfig
 });
-import { readFile as readFile4 } from "fs/promises";
+import { readFile as readFile5 } from "fs/promises";
 import { spawnSync } from "child_process";
 import { resolve as resolve6, isAbsolute } from "path";
 function parseAgentCommand(value, agentId) {
@@ -1910,6 +1927,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;
@@ -2039,6 +2068,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;
   }
@@ -2107,7 +2141,7 @@ async function updatePlaybooksConfig(playbooks) {
     disabled: Array.from(new Set(playbooks.disabled ?? current.disabled))
   };
   const playbooksBlock = serializePlaybooksConfig(nextPlaybooks);
-  const existing = await fileExists(configPath) ? await readFile4(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
+  const existing = await fileExists(configPath) ? await readFile5(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) {
     const bodyBlock = playbooksBlock ? `${playbooksBlock}
@@ -2159,7 +2193,7 @@ function serializeThemeConfig(theme) {
 async function writeThemeConfig(theme) {
   const configPath = resolve6(syntaurRoot(), "config.md");
   const themeBlock = serializeThemeConfig(theme);
-  const existing = await fileExists(configPath) ? await readFile4(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
+  const existing = await fileExists(configPath) ? await readFile5(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) {
     const content = `---
@@ -2185,7 +2219,7 @@ ${normalizedFm}
 async function deleteThemeConfig() {
   const configPath = resolve6(syntaurRoot(), "config.md");
   if (!await fileExists(configPath)) return;
-  const existing = await readFile4(configPath, "utf-8");
+  const existing = await readFile5(configPath, "utf-8");
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) return;
   const fmBlock = fmMatch[2];
@@ -2205,7 +2239,7 @@ function stripTopLevelScalar(fmBlock, key) {
 async function writeTerminalConfig(terminal) {
   const configPath = resolve6(syntaurRoot(), "config.md");
   const terminalLine = `terminal: ${terminal}`;
-  const existing = await fileExists(configPath) ? await readFile4(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
+  const existing = await fileExists(configPath) ? await readFile5(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) {
     const content = `---
@@ -2231,7 +2265,7 @@ ${normalizedFm}
 async function deleteTerminalConfig() {
   const configPath = resolve6(syntaurRoot(), "config.md");
   if (!await fileExists(configPath)) return;
-  const existing = await readFile4(configPath, "utf-8");
+  const existing = await readFile5(configPath, "utf-8");
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) return;
   const fmBlock = fmMatch[2];
@@ -2300,7 +2334,7 @@ async function writeHotkeyBindingsConfig(cfg) {
   }
   const configPath = resolve6(syntaurRoot(), "config.md");
   const block = serializeHotkeyBindingsConfig({ bindings: cleaned });
-  const existing = await fileExists(configPath) ? await readFile4(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
+  const existing = await fileExists(configPath) ? await readFile5(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) {
     const content = `---
@@ -2326,7 +2360,7 @@ ${normalizedFm}
 async function deleteHotkeyBindingsConfig() {
   const configPath = resolve6(syntaurRoot(), "config.md");
   if (!await fileExists(configPath)) return;
-  const existing = await readFile4(configPath, "utf-8");
+  const existing = await readFile5(configPath, "utf-8");
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) return;
   const fmBlock = fmMatch[2];
@@ -2643,7 +2677,7 @@ async function writeAgentsConfig(agents) {
   validateAgentList(agents);
   const configPath = resolve6(syntaurRoot(), "config.md");
   const agentsBlock = serializeAgentsConfig(agents);
-  const existing = await fileExists(configPath) ? await readFile4(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
+  const existing = await fileExists(configPath) ? await readFile5(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) {
     const content = `---
@@ -2668,7 +2702,7 @@ ${newFm}
 async function deleteAgentsConfig() {
   const configPath = resolve6(syntaurRoot(), "config.md");
   if (!await fileExists(configPath)) return;
-  const existing = await readFile4(configPath, "utf-8");
+  const existing = await readFile5(configPath, "utf-8");
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) return;
   const fmBlock = fmMatch[2];
@@ -2692,7 +2726,7 @@ ${statusBlock}
     await writeFileForce(configPath, content);
     return;
   }
-  const existing = await readFile4(configPath, "utf-8");
+  const existing = await readFile5(configPath, "utf-8");
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) {
     const content = `---
@@ -2736,7 +2770,7 @@ ${statusBlock}
 async function deleteStatusConfig() {
   const configPath = resolve6(syntaurRoot(), "config.md");
   if (!await fileExists(configPath)) return;
-  const existing = await readFile4(configPath, "utf-8");
+  const existing = await readFile5(configPath, "utf-8");
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) return;
   const fmBlock = fmMatch[2];
@@ -2754,7 +2788,7 @@ async function updateIntegrationConfig(integrations) {
     ...integrations
   };
   const integrationBlock = serializeIntegrationConfig(nextIntegrations);
-  const existing = await fileExists(configPath) ? await readFile4(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
+  const existing = await fileExists(configPath) ? await readFile5(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) {
     const content = `---
@@ -2784,7 +2818,7 @@ async function updateOnboardingConfig(onboarding) {
     ...onboarding
   };
   const onboardingBlock = serializeOnboardingConfig(nextOnboarding);
-  const existing = await fileExists(configPath) ? await readFile4(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
+  const existing = await fileExists(configPath) ? await readFile5(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) {
     const content = `---
@@ -2818,7 +2852,7 @@ async function updateBackupConfig(backup) {
     ...backup
   };
   const backupBlock = serializeBackupConfig(nextBackup);
-  const existing = await fileExists(configPath) ? await readFile4(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
+  const existing = await fileExists(configPath) ? await readFile5(configPath, "utf-8") : renderConfig({ defaultProjectDir: defaultProjectDir() });
   const fmMatch = existing.match(/^(---\n)([\s\S]*?)\n(---)/);
   if (!fmMatch) {
     const content = `---
@@ -2850,7 +2884,7 @@ async function readConfig() {
     migratedConfigPaths.add(configPath);
     await migrateLegacyConfig(configPath);
   }
-  const content = await readFile4(configPath, "utf-8");
+  const content = await readFile5(configPath, "utf-8");
   const fm = parseFrontmatter(content);
   if (Object.keys(fm).length === 0) {
     console.warn("Warning: ~/.syntaur/config.md has malformed frontmatter, using defaults");
@@ -2889,7 +2923,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,
@@ -3054,7 +3089,7 @@ var init_slug = __esm({
 
 // src/utils/playbooks.ts
 import { resolve as resolve7 } from "path";
-import { readdir as readdir3, readFile as readFile5, unlink } from "fs/promises";
+import { readdir as readdir3, readFile as readFile6, unlink } from "fs/promises";
 function escapeRegExp(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
@@ -3080,7 +3115,7 @@ async function resolvePlaybookSlug(playbooksDir2, slug) {
   for (const entry of entries) {
     if (!isVisiblePlaybookFile(entry.name, entry.isFile())) continue;
     const filePath = resolve7(playbooksDir2, entry.name);
-    const raw = await readFile5(filePath, "utf-8");
+    const raw = await readFile6(filePath, "utf-8");
     const parsed = parsePlaybook(raw);
     const canonical = parsed.slug || entry.name.replace(/\.md$/, "");
     if (canonical === slug) {
@@ -3128,7 +3163,7 @@ async function rebuildPlaybookManifest(playbooksDir2) {
   const rows = [];
   for (const entry of entries) {
     if (!isVisiblePlaybookFile(entry.name, entry.isFile())) continue;
-    const raw = await readFile5(resolve7(playbooksDir2, entry.name), "utf-8");
+    const raw = await readFile6(resolve7(playbooksDir2, entry.name), "utf-8");
     const parsed = parsePlaybook(raw);
     const slug = parsed.slug || entry.name.replace(/\.md$/, "");
     if (disabledSet.has(slug)) continue;
@@ -3206,7 +3241,7 @@ async function renamePlaybook(playbooksDir2, oldSlug, newSlug) {
       );
     }
   }
-  const raw = await readFile5(oldPath, "utf-8");
+  const raw = await readFile6(oldPath, "utf-8");
   let next = setFrontmatterField2(raw, "slug", newSlug);
   next = setFrontmatterField2(next, "updated", `"${nowTimestamp()}"`);
   await writeFileForce(newPath, next);
@@ -3243,7 +3278,7 @@ var init_playbooks = __esm({
 
 // src/utils/assignment-resolver.ts
 import { resolve as resolve8 } from "path";
-import { readdir as readdir4, readFile as readFile6 } from "fs/promises";
+import { readdir as readdir4, readFile as readFile7 } from "fs/promises";
 async function resolveAssignmentById(projectsDir, assignmentsDir2, id) {
   let standaloneMatch = null;
   let projectMatch = null;
@@ -3252,7 +3287,7 @@ async function resolveAssignmentById(projectsDir, assignmentsDir2, id) {
   if (await fileExists(standalonePath)) {
     let workspaceGroup = null;
     try {
-      const content = await readFile6(standalonePath, "utf-8");
+      const content = await readFile7(standalonePath, "utf-8");
       const [fm] = extractFrontmatter2(content);
       workspaceGroup = getField(fm, "workspaceGroup");
     } catch {
@@ -3280,7 +3315,7 @@ async function resolveAssignmentById(projectsDir, assignmentsDir2, id) {
           const aPath = resolve8(assignmentsPath, a.name, "assignment.md");
           if (!await fileExists(aPath)) continue;
           try {
-            const content = await readFile6(aPath, "utf-8");
+            const content = await readFile7(aPath, "utf-8");
             const [fm] = extractFrontmatter2(content);
             const fileId = getField(fm, "id");
             if (fileId === id) {
@@ -3932,8 +3967,8 @@ async function migrateFromMarkdown(projectsDir) {
   return allSessions.length;
 }
 async function parseMarkdownSessionsIndex(filePath, projectSlug) {
-  const { readFile: readFile20 } = await import("fs/promises");
-  const raw = await readFile20(filePath, "utf-8");
+  const { readFile: readFile21 } = await import("fs/promises");
+  const raw = await readFile21(filePath, "utf-8");
   const sessions = [];
   const lines = raw.split("\n");
   let inTable = false;
@@ -4003,7 +4038,7 @@ CREATE INDEX IF NOT EXISTS idx_sessions_assignment ON sessions(project_slug, ass
 });
 
 // src/dashboard/agent-sessions.ts
-import { readFile as readFile7 } from "fs/promises";
+import { readFile as readFile8 } from "fs/promises";
 import { resolve as resolve10 } from "path";
 function rowToSession(row) {
   return {
@@ -4091,7 +4126,7 @@ async function deleteSessions(sessionIds) {
 }
 async function readAssignmentStatusFromPath(assignmentMdPath) {
   if (!await fileExists(assignmentMdPath)) return null;
-  const raw = await readFile7(assignmentMdPath, "utf-8");
+  const raw = await readFile8(assignmentMdPath, "utf-8");
   const match = raw.match(/^status:\s*(.+)$/m);
   return match ? match[1].trim() : null;
 }
@@ -4176,7 +4211,7 @@ var init_overviewCopy = __esm({
 });
 
 // src/dashboard/servers.ts
-import { readdir as readdir6, readFile as readFile8, unlink as unlink2 } from "fs/promises";
+import { readdir as readdir6, readFile as readFile9, unlink as unlink2 } from "fs/promises";
 import { resolve as resolve11 } from "path";
 function sanitizeSessionName(name) {
   return name.replace(/[^a-zA-Z0-9_-]/g, "-");
@@ -4236,7 +4271,7 @@ async function listSessionFiles(dir) {
 async function readSessionFile(dir, name) {
   const filePath = resolve11(dir, `${sanitizeSessionName(name)}.md`);
   if (!await fileExists(filePath)) return null;
-  const raw = await readFile8(filePath, "utf-8");
+  const raw = await readFile9(filePath, "utf-8");
   const [frontmatter] = extractFrontmatter2(raw);
   if (!frontmatter) return null;
   const session = getField(frontmatter, "session") ?? name;
@@ -4809,7 +4844,7 @@ var init_scanner = __esm({
 });
 
 // src/dashboard/api.ts
-import { readdir as readdir7, readFile as readFile9, writeFile as writeFile3 } from "fs/promises";
+import { readdir as readdir7, readFile as readFile10, writeFile as writeFile3 } from "fs/promises";
 import { resolve as resolve13, dirname as dirname2, basename } from "path";
 function clearFrontmatterField(content, key) {
   const fieldRegex = new RegExp(`^(${escapeRegExp2(key)}:)\\s*.*$`, "m");
@@ -4897,7 +4932,7 @@ async function computeStandaloneRecords(assignmentsDir2) {
     const assignmentMdPath = resolve13(assignmentDir, "assignment.md");
     if (!await fileExists(assignmentMdPath)) continue;
     try {
-      const content = await readFile9(assignmentMdPath, "utf-8");
+      const content = await readFile10(assignmentMdPath, "utf-8");
       const record = parseAssignmentFull(content);
       records.push({ assignmentDir, id: entry.name, record });
     } catch {
@@ -4973,7 +5008,7 @@ async function listProjects(projectsDir) {
 async function readWorkspaceRegistry(projectsDir) {
   const registryPath = resolve13(dirname2(projectsDir), "workspaces.json");
   try {
-    const raw = await readFile9(registryPath, "utf-8");
+    const raw = await readFile10(registryPath, "utf-8");
     const parsed = JSON.parse(raw);
     return Array.isArray(parsed) ? parsed.filter((w) => typeof w === "string") : [];
   } catch {
@@ -5062,7 +5097,7 @@ async function deleteWorkspace(projectsDir, name, opts = {}) {
     const timestamp = nowTimestamp();
     for (const slug of projectsReferencing) {
       const path = resolve13(projectsDir, slug, "project.md");
-      const raw = await readFile9(path, "utf-8");
+      const raw = await readFile10(path, "utf-8");
       let next = clearFrontmatterField(raw, "workspace");
       next = setUpdatedField(next, timestamp);
       await writeFileForce(path, next);
@@ -5071,7 +5106,7 @@ async function deleteWorkspace(projectsDir, name, opts = {}) {
     for (const id of standalonesReferencing) {
       if (!opts.assignmentsDir) break;
       const path = resolve13(opts.assignmentsDir, id, "assignment.md");
-      const raw = await readFile9(path, "utf-8");
+      const raw = await readFile10(path, "utf-8");
       let next = clearFrontmatterField(raw, "workspaceGroup");
       next = setUpdatedField(next, timestamp);
       await writeFileForce(path, next);
@@ -5308,7 +5343,7 @@ async function getEditableDocument(projectsDir, documentType, projectSlug, assig
   if (!filePath || !await fileExists(filePath)) {
     return null;
   }
-  const content = await readFile9(filePath, "utf-8");
+  const content = await readFile10(filePath, "utf-8");
   const title = getEditableDocumentTitle(documentType, projectSlug, assignmentSlug);
   return {
     documentType,
@@ -5334,7 +5369,7 @@ async function getEditableDocumentById(projectsDir, assignmentsDir2, documentTyp
   if (!fileName) return null;
   const filePath = resolve13(resolved.assignmentDir, fileName);
   if (!await fileExists(filePath)) return null;
-  const content = await readFile9(filePath, "utf-8");
+  const content = await readFile10(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 {
@@ -5353,7 +5388,7 @@ async function getProjectDetail(projectsDir, slug) {
   if (!await fileExists(projectMdPath)) {
     return null;
   }
-  const projectContent = await readFile9(projectMdPath, "utf-8");
+  const projectContent = await readFile10(projectMdPath, "utf-8");
   const project = parseProject(projectContent);
   const assignments = await listAssignmentRecords(projectPath);
   const rollup = await buildProjectRollup(projectPath, project, assignments);
@@ -5390,18 +5425,18 @@ async function getAssignmentDetail(projectsDir, projectSlug, assignmentSlug) {
   if (!await fileExists(assignmentMdPath)) {
     return null;
   }
-  const assignmentContent = await readFile9(assignmentMdPath, "utf-8");
+  const assignmentContent = await readFile10(assignmentMdPath, "utf-8");
   const assignment = parseAssignmentFull(assignmentContent);
   let projectWorkspace = null;
   const projectMdPath = resolve13(projectsDir, projectSlug, "project.md");
   if (await fileExists(projectMdPath)) {
-    const projectContent = await readFile9(projectMdPath, "utf-8");
+    const projectContent = await readFile10(projectMdPath, "utf-8");
     projectWorkspace = parseProject(projectContent).workspace;
   }
   let plan = null;
   const planPath = resolve13(assignmentDir, "plan.md");
   if (await fileExists(planPath)) {
-    const planContent = await readFile9(planPath, "utf-8");
+    const planContent = await readFile10(planPath, "utf-8");
     const parsed = parsePlan(planContent);
     plan = {
       status: parsed.status,
@@ -5412,7 +5447,7 @@ async function getAssignmentDetail(projectsDir, projectSlug, assignmentSlug) {
   let scratchpad = null;
   const scratchpadPath = resolve13(assignmentDir, "scratchpad.md");
   if (await fileExists(scratchpadPath)) {
-    const scratchpadContent = await readFile9(scratchpadPath, "utf-8");
+    const scratchpadContent = await readFile10(scratchpadPath, "utf-8");
     const parsed = parseScratchpad(scratchpadContent);
     scratchpad = {
       updated: parsed.updated,
@@ -5422,7 +5457,7 @@ async function getAssignmentDetail(projectsDir, projectSlug, assignmentSlug) {
   let handoff = null;
   const handoffPath = resolve13(assignmentDir, "handoff.md");
   if (await fileExists(handoffPath)) {
-    const handoffContent = await readFile9(handoffPath, "utf-8");
+    const handoffContent = await readFile10(handoffPath, "utf-8");
     const parsed = parseHandoff(handoffContent);
     handoff = {
       updated: parsed.updated,
@@ -5433,7 +5468,7 @@ async function getAssignmentDetail(projectsDir, projectSlug, assignmentSlug) {
   let decisionRecord = null;
   const decisionRecordPath = resolve13(assignmentDir, "decision-record.md");
   if (await fileExists(decisionRecordPath)) {
-    const decisionRecordContent = await readFile9(decisionRecordPath, "utf-8");
+    const decisionRecordContent = await readFile10(decisionRecordPath, "utf-8");
     const parsed = parseDecisionRecord(decisionRecordContent);
     decisionRecord = {
       updated: parsed.updated,
@@ -5444,7 +5479,7 @@ async function getAssignmentDetail(projectsDir, projectSlug, assignmentSlug) {
   let progress = null;
   const progressPath = resolve13(assignmentDir, "progress.md");
   if (await fileExists(progressPath)) {
-    const progressContent = await readFile9(progressPath, "utf-8");
+    const progressContent = await readFile10(progressPath, "utf-8");
     const parsed = parseProgress(progressContent);
     progress = {
       updated: parsed.updated,
@@ -5455,7 +5490,7 @@ async function getAssignmentDetail(projectsDir, projectSlug, assignmentSlug) {
   let comments = null;
   const commentsPath = resolve13(assignmentDir, "comments.md");
   if (await fileExists(commentsPath)) {
-    const commentsContent = await readFile9(commentsPath, "utf-8");
+    const commentsContent = await readFile10(commentsPath, "utf-8");
     const parsed = parseComments(commentsContent);
     comments = {
       updated: parsed.updated,
@@ -5609,7 +5644,7 @@ async function countMentionsInAssignment(sourceDir, target) {
   const bodies = [];
   const assignmentMd = resolve13(sourceDir, "assignment.md");
   if (await fileExists(assignmentMd)) {
-    const content = await readFile9(assignmentMd, "utf-8");
+    const content = await readFile10(assignmentMd, "utf-8");
     const todosMatch = content.match(/^## Todos\s*$([\s\S]*?)(?=^## |$(?![\r\n]))/m);
     if (todosMatch) bodies.push(todosMatch[1]);
   }
@@ -5617,7 +5652,7 @@ async function countMentionsInAssignment(sourceDir, target) {
     const path = resolve13(sourceDir, filename);
     if (await fileExists(path)) {
       try {
-        bodies.push(await readFile9(path, "utf-8"));
+        bodies.push(await readFile10(path, "utf-8"));
       } catch {
       }
     }
@@ -5677,42 +5712,42 @@ async function buildStandaloneAssignmentDetail(resolved) {
   const assignmentDir = resolved.assignmentDir;
   const assignmentMdPath = resolve13(assignmentDir, "assignment.md");
   if (!await fileExists(assignmentMdPath)) return null;
-  const assignmentContent = await readFile9(assignmentMdPath, "utf-8");
+  const assignmentContent = await readFile10(assignmentMdPath, "utf-8");
   const assignment = parseAssignmentFull(assignmentContent);
   let plan = null;
   const planPath = resolve13(assignmentDir, "plan.md");
   if (await fileExists(planPath)) {
-    const parsed = parsePlan(await readFile9(planPath, "utf-8"));
+    const parsed = parsePlan(await readFile10(planPath, "utf-8"));
     plan = { status: parsed.status, updated: parsed.updated, body: parsed.body };
   }
   let scratchpad = null;
   const scratchpadPath = resolve13(assignmentDir, "scratchpad.md");
   if (await fileExists(scratchpadPath)) {
-    const parsed = parseScratchpad(await readFile9(scratchpadPath, "utf-8"));
+    const parsed = parseScratchpad(await readFile10(scratchpadPath, "utf-8"));
     scratchpad = { updated: parsed.updated, body: parsed.body };
   }
   let handoff = null;
   const handoffPath = resolve13(assignmentDir, "handoff.md");
   if (await fileExists(handoffPath)) {
-    const parsed = parseHandoff(await readFile9(handoffPath, "utf-8"));
+    const parsed = parseHandoff(await readFile10(handoffPath, "utf-8"));
     handoff = { updated: parsed.updated, handoffCount: parsed.handoffCount, body: parsed.body };
   }
   let decisionRecord = null;
   const decisionRecordPath = resolve13(assignmentDir, "decision-record.md");
   if (await fileExists(decisionRecordPath)) {
-    const parsed = parseDecisionRecord(await readFile9(decisionRecordPath, "utf-8"));
+    const parsed = parseDecisionRecord(await readFile10(decisionRecordPath, "utf-8"));
     decisionRecord = { updated: parsed.updated, decisionCount: parsed.decisionCount, body: parsed.body };
   }
   let progress = null;
   const progressPath = resolve13(assignmentDir, "progress.md");
   if (await fileExists(progressPath)) {
-    const parsed = parseProgress(await readFile9(progressPath, "utf-8"));
+    const parsed = parseProgress(await readFile10(progressPath, "utf-8"));
     progress = { updated: parsed.updated, entryCount: parsed.entryCount, entries: parsed.entries };
   }
   let comments = null;
   const commentsPath = resolve13(assignmentDir, "comments.md");
   if (await fileExists(commentsPath)) {
-    const parsed = parseComments(await readFile9(commentsPath, "utf-8"));
+    const parsed = parseComments(await readFile10(commentsPath, "utf-8"));
     comments = { updated: parsed.updated, entryCount: parsed.entryCount, entries: parsed.entries };
   }
   const detail = {
@@ -5778,7 +5813,7 @@ async function computeProjectRecords(projectsDir, traces) {
         return null;
       }
       const t0 = traces ? performance.now() : 0;
-      const projectContent = await readFile9(projectMdPath, "utf-8");
+      const projectContent = await readFile10(projectMdPath, "utf-8");
       const project = parseProject(projectContent);
       if (traces) accumulatePhase(traces, "parse-project-md", performance.now() - t0);
       const t1 = traces ? performance.now() : 0;
@@ -5832,7 +5867,7 @@ async function listAssignmentRecords(projectPath, traces) {
         return null;
       }
       const t0 = traces ? performance.now() : 0;
-      const content = await readFile9(assignmentMd, "utf-8");
+      const content = await readFile10(assignmentMd, "utf-8");
       const parsed = parseAssignmentFull(content);
       if (traces) accumulatePhase(traces, "read-assignment-md", performance.now() - t0);
       return parsed;
@@ -5854,7 +5889,7 @@ async function listResources(projectPath) {
       continue;
     }
     const filePath = resolve13(resourcesDir, entry.name);
-    const content = await readFile9(filePath, "utf-8");
+    const content = await readFile10(filePath, "utf-8");
     const parsed = parseResource(content);
     results.push({
       name: parsed.name,
@@ -5880,7 +5915,7 @@ async function listMemories(projectPath) {
       continue;
     }
     const filePath = resolve13(memoriesDir, entry.name);
-    const content = await readFile9(filePath, "utf-8");
+    const content = await readFile10(filePath, "utf-8");
     const parsed = parseMemory(content);
     results.push({
       name: parsed.name,
@@ -5943,7 +5978,7 @@ async function getMemoryDetail(projectsDir, projectSlug, itemSlug) {
   if (!projectRecord) return null;
   const filePath = resolve13(projectRecord.projectPath, "memories", `${itemSlug}.md`);
   if (!await fileExists(filePath)) return null;
-  const content = await readFile9(filePath, "utf-8");
+  const content = await readFile10(filePath, "utf-8");
   const parsed = parseMemory(content);
   return {
     name: parsed.name,
@@ -5969,7 +6004,7 @@ async function getResourceDetail(projectsDir, projectSlug, itemSlug) {
   if (!projectRecord) return null;
   const filePath = resolve13(projectRecord.projectPath, "resources", `${itemSlug}.md`);
   if (!await fileExists(filePath)) return null;
-  const content = await readFile9(filePath, "utf-8");
+  const content = await readFile10(filePath, "utf-8");
   const parsed = parseResource(content);
   return {
     name: parsed.name,
@@ -5987,7 +6022,7 @@ async function getResourceDetail(projectsDir, projectSlug, itemSlug) {
 async function loadDependencyGraph(projectPath, assignments) {
   const statusPath = resolve13(projectPath, "_status.md");
   if (await fileExists(statusPath)) {
-    const statusContent = await readFile9(statusPath, "utf-8");
+    const statusContent = await readFile10(statusPath, "utf-8");
     const parsed = parseStatus(statusContent);
     const derivedGraph = extractMermaidGraph(parsed.body);
     if (derivedGraph) {
@@ -6154,7 +6189,7 @@ async function getUnmetDependencies(projectPath, dependsOn, terminalStatuses, de
       unmet.push(`${dependency} (missing)`);
       continue;
     }
-    const content = await readFile9(dependencyPath, "utf-8");
+    const content = await readFile10(dependencyPath, "utf-8");
     const parsed = parseAssignmentFull(content);
     if (!terminals.has(parsed.status)) {
       unmet.push(`${dependency} (${parsed.status})`);
@@ -6449,7 +6484,7 @@ async function countOpenQuestions(projectPath, assignmentSlug) {
     return 0;
   }
   try {
-    const content = await readFile9(commentsPath, "utf-8");
+    const content = await readFile10(commentsPath, "utf-8");
     const parsed = parseComments(content);
     return parsed.entries.filter(
       (e) => e.type === "question" && e.resolved !== true
@@ -6522,7 +6557,7 @@ async function listPlaybooks(playbooksDir2) {
   for (const entry of entries) {
     if (!entry.isFile() || !entry.name.endsWith(".md") || entry.name.startsWith("_") || entry.name === "manifest.md") continue;
     const filePath = resolve13(playbooksDir2, entry.name);
-    const raw = await readFile9(filePath, "utf-8");
+    const raw = await readFile10(filePath, "utf-8");
     const parsed = parsePlaybook(raw);
     const slug = parsed.slug || entry.name.replace(/\.md$/, "");
     playbooks.push({
@@ -7201,7 +7236,7 @@ function mergePatch(current, patch) {
 // src/utils/view-prefs.ts
 init_paths();
 init_fs();
-import { readFile as readFile10, rename as rename3, unlink as unlink3 } from "fs/promises";
+import { readFile as readFile11, rename as rename3, unlink as unlink3 } from "fs/promises";
 import { resolve as resolve14 } from "path";
 function corruptFilePath() {
   const ts = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
@@ -7224,7 +7259,7 @@ async function readViewPrefsFile() {
   }
   let raw;
   try {
-    raw = await readFile10(path, "utf-8");
+    raw = await readFile11(path, "utf-8");
   } catch {
     return { ...DEFAULT_VIEW_PREFS_FILE };
   }
@@ -7407,7 +7442,7 @@ function isDashboardSlot(value) {
 // src/utils/saved-views.ts
 init_paths();
 init_fs();
-import { readFile as readFile11, rename as rename4, unlink as unlink4 } from "fs/promises";
+import { readFile as readFile12, rename as rename4, unlink as unlink4 } from "fs/promises";
 import { randomUUID } from "crypto";
 import { resolve as resolve15 } from "path";
 function corruptFilePath2() {
@@ -7437,7 +7472,7 @@ async function readSavedViewsFile() {
   }
   let raw;
   try {
-    raw = await readFile11(path, "utf-8");
+    raw = await readFile12(path, "utf-8");
   } catch {
     return cloneDefault();
   }
@@ -7753,7 +7788,7 @@ init_lifecycle();
 init_slug();
 import { Router as Router2 } from "express";
 import { resolve as resolve18, basename as basename3, isAbsolute as isAbsolute2 } from "path";
-import { rm, readFile as readFile14, open as fsOpen, stat as fsStat, realpath as fsRealpath } from "fs/promises";
+import { rm, readFile as readFile15, open as fsOpen, stat as fsStat, realpath as fsRealpath } from "fs/promises";
 import { spawnSync as spawnSync3 } from "child_process";
 
 // src/utils/uuid.ts
@@ -7770,7 +7805,7 @@ init_fs();
 init_frontmatter();
 init_fs();
 import { spawn } from "child_process";
-import { readFile as readFile12 } from "fs/promises";
+import { readFile as readFile13 } from "fs/promises";
 function run(command, args, cwd) {
   return new Promise((resolvePromise) => {
     const child = spawn(command, args, { cwd, stdio: ["ignore", "pipe", "pipe"] });
@@ -7854,7 +7889,7 @@ async function createWorktreeAndRecord(opts) {
   const { assignmentPath, repository, branch, worktreePath, parentBranch } = opts;
   await createWorktree({ repository, branch, worktreePath, parentBranch });
   try {
-    const content = await readFile12(assignmentPath, "utf-8");
+    const content = await readFile13(assignmentPath, "utf-8");
     const updated = updateAssignmentWorkspace(content, {
       repository,
       worktreePath,
@@ -7967,7 +8002,7 @@ function validateBranchName(name) {
 // src/dashboard/repository-candidates.ts
 init_fs();
 init_parser();
-import { readdir as readdir8, readFile as readFile13 } from "fs/promises";
+import { readdir as readdir8, readFile as readFile14 } from "fs/promises";
 import { resolve as resolve17 } from "path";
 function toSourceAssignment(parsed, fallbackId) {
   const repository = parsed.workspace.repository?.trim();
@@ -7987,7 +8022,7 @@ async function getProjectRepositoryCandidates(projectsDir, projectSlug) {
   const out = [];
   const projectPath = resolve17(projectsDir, projectSlug, "project.md");
   if (await fileExists(projectPath)) {
-    const project = parseProject(await readFile13(projectPath, "utf-8"));
+    const project = parseProject(await readFile14(projectPath, "utf-8"));
     for (const raw of project.repositories) {
       const path = raw.trim();
       if (!path) continue;
@@ -8004,7 +8039,7 @@ async function getProjectRepositoryCandidates(projectsDir, projectSlug) {
       if (!entry.isDirectory()) continue;
       const assignmentMd = resolve17(assignmentsDir2, entry.name, "assignment.md");
       if (!await fileExists(assignmentMd)) continue;
-      const parsed = parseAssignmentFull(await readFile13(assignmentMd, "utf-8"));
+      const parsed = parseAssignmentFull(await readFile14(assignmentMd, "utf-8"));
       const repo = parsed.workspace.repository?.trim();
       if (!repo) continue;
       const abs = resolve17(repo);
@@ -8027,7 +8062,7 @@ async function getStandaloneRepositoryCandidates(assignmentsDir2, excludeAssignm
     if (entry.name === excludeAssignmentId) continue;
     const assignmentMd = resolve17(assignmentsDir2, entry.name, "assignment.md");
     if (!await fileExists(assignmentMd)) continue;
-    const parsed = parseAssignmentFull(await readFile13(assignmentMd, "utf-8"));
+    const parsed = parseAssignmentFull(await readFile14(assignmentMd, "utf-8"));
     const repo = parsed.workspace.repository?.trim();
     if (!repo) continue;
     const abs = resolve17(repo);
@@ -8048,7 +8083,7 @@ async function getProjectSourceAssignments(projectsDir, projectSlug, excludeSlug
     if (entry.name === excludeSlug) continue;
     const assignmentMd = resolve17(assignmentsDir2, entry.name, "assignment.md");
     if (!await fileExists(assignmentMd)) continue;
-    const parsed = parseAssignmentFull(await readFile13(assignmentMd, "utf-8"));
+    const parsed = parseAssignmentFull(await readFile14(assignmentMd, "utf-8"));
     const source = toSourceAssignment(parsed, entry.name);
     if (!source) continue;
     if (seen.has(entry.name)) continue;
@@ -8067,7 +8102,7 @@ async function getStandaloneSourceAssignments(assignmentsDir2, excludeAssignment
     if (entry.name === excludeAssignmentId) continue;
     const assignmentMd = resolve17(assignmentsDir2, entry.name, "assignment.md");
     if (!await fileExists(assignmentMd)) continue;
-    const parsed = parseAssignmentFull(await readFile13(assignmentMd, "utf-8"));
+    const parsed = parseAssignmentFull(await readFile14(assignmentMd, "utf-8"));
     const source = toSourceAssignment(parsed, entry.name);
     if (!source) continue;
     if (seen.has(entry.name)) continue;
@@ -8642,7 +8677,7 @@ async function readCurrentDocument(filePath) {
   if (!await fileExists(filePath)) {
     return null;
   }
-  return readFile14(filePath, "utf-8");
+  return readFile15(filePath, "utf-8");
 }
 var worktreeInFlight = /* @__PURE__ */ new Set();
 async function assertRepoRoot(repoInput) {
@@ -8696,7 +8731,7 @@ async function handleWorktreeCreate(req, res, ctx) {
   }
   worktreeInFlight.add(ctx.assignmentPath);
   try {
-    const parsed = parseAssignmentFull(await readFile14(ctx.assignmentPath, "utf-8"));
+    const parsed = parseAssignmentFull(await readFile15(ctx.assignmentPath, "utf-8"));
     if (parsed.workspace.worktreePath) {
       res.status(409).json({ error: "Worktree already configured for this assignment" });
       return;
@@ -9066,7 +9101,7 @@ ${body.startsWith("\n") ? body.slice(1) : body}${body.endsWith("\n") ? "" : "\n"
         }
         const nextContentRaw = requireContent(req, res);
         if (!nextContentRaw) return;
-        const currentContent = await readFile14(filePath, "utf-8");
+        const currentContent = await readFile15(filePath, "utf-8");
         const frontmatterBlock = extractFrontmatterBlock(currentContent);
         if (!frontmatterBlock) {
           res.status(500).json({ error: `${kind} file is malformed (no frontmatter)` });
@@ -9517,7 +9552,7 @@ ${nextBody}${nextBody.endsWith("\n") ? "" : "\n"}`;
       let currentContent;
       let currentCount = 0;
       if (await fileExists(commentsPath)) {
-        currentContent = await readFile14(commentsPath, "utf-8");
+        currentContent = await readFile15(commentsPath, "utf-8");
         const countMatch = currentContent.match(/^entryCount:\s*(\d+)/m);
         if (countMatch) currentCount = parseInt(countMatch[1], 10);
       } else {
@@ -9574,7 +9609,7 @@ ${entry}`;
         res.status(400).json({ error: "resolved (boolean) is required" });
         return;
       }
-      const content = await readFile14(commentsPath, "utf-8");
+      const content = await readFile15(commentsPath, "utf-8");
       const parsed = parseComments(content);
       const target = parsed.entries.find((e) => e.id === commentId);
       if (!target) {
@@ -9621,7 +9656,7 @@ ${entry}`;
         });
         return;
       }
-      let content = await readFile14(projectPath, "utf-8");
+      let content = await readFile15(projectPath, "utf-8");
       content = setTopLevelField(content, "workspace", workspace ?? null);
       content = setTopLevelField(content, "updated", nowTimestamp());
       await writeFileForce(projectPath, content);
@@ -9658,7 +9693,7 @@ ${entry}`;
         return;
       }
       const assignmentPath = resolve18(resolved.assignmentDir, "assignment.md");
-      let content = await readFile14(assignmentPath, "utf-8");
+      let content = await readFile15(assignmentPath, "utf-8");
       content = setTopLevelField(content, "workspaceGroup", workspaceGroup ?? null);
       content = setTopLevelField(content, "updated", nowTimestamp());
       await writeFileForce(assignmentPath, content);
@@ -9875,7 +9910,7 @@ ${entry}`;
           return;
         }
         const assignmentPath = resolve18(resolved.assignmentDir, "assignment.md");
-        const parsedForSlug = parseAssignmentFull(await readFile14(assignmentPath, "utf-8"));
+        const parsedForSlug = parseAssignmentFull(await readFile15(assignmentPath, "utf-8"));
         const assignmentSlugForBranch = parsedForSlug.slug || resolved.id;
         await handleWorktreeCreate(req, res, {
           assignmentPath,
@@ -9904,7 +9939,7 @@ ${entry}`;
         res.status(400).json({ error: `Invalid status. Must be one of: ${validStatuses.join(", ")}, or null to clear.` });
         return;
       }
-      let content = await readFile14(projectPath, "utf-8");
+      let content = await readFile15(projectPath, "utf-8");
       content = setTopLevelField(content, "statusOverride", status ?? null);
       content = setTopLevelField(content, "updated", nowTimestamp());
       await writeFileForce(projectPath, content);
@@ -9937,7 +9972,7 @@ ${entry}`;
         res.status(400).json({ error: `Invalid status. Must be one of: ${validStatuses.join(", ")}.` });
         return;
       }
-      let content = await readFile14(assignmentPath, "utf-8");
+      let content = await readFile15(assignmentPath, "utf-8");
       content = setTopLevelField(content, "status", status);
       content = setTopLevelField(content, "updated", nowTimestamp());
       if (status !== "blocked") {
@@ -9963,7 +9998,7 @@ ${entry}`;
         res.status(404).json({ error: `Project "${projectSlug}" not found` });
         return;
       }
-      const content = await readFile14(projectPath, "utf-8");
+      const content = await readFile15(projectPath, "utf-8");
       await writeFileForce(projectPath, applyArchiveFields(content, true, archiveReason(req.body)));
       const project = await getProjectDetail(projectsDir, projectSlug);
       res.json({ project });
@@ -9980,7 +10015,7 @@ ${entry}`;
         res.status(404).json({ error: `Project "${projectSlug}" not found` });
         return;
       }
-      const content = await readFile14(projectPath, "utf-8");
+      const content = await readFile15(projectPath, "utf-8");
       await writeFileForce(projectPath, applyArchiveFields(content, false, null));
       const project = await getProjectDetail(projectsDir, projectSlug);
       res.json({ project });
@@ -9997,7 +10032,7 @@ ${entry}`;
       res.status(404).json({ error: "Assignment not found" });
       return;
     }
-    const content = await readFile14(assignmentPath, "utf-8");
+    const content = await readFile15(assignmentPath, "utf-8");
     await writeFileForce(assignmentPath, applyArchiveFields(content, archived, archived ? archiveReason(req.body) : null));
     const assignment = await getAssignmentDetail(projectsDir, projectSlug, assignmentSlug);
     res.json({ assignment });
@@ -10030,7 +10065,7 @@ ${entry}`;
       return;
     }
     const assignmentPath = resolve18(resolved.assignmentDir, "assignment.md");
-    const content = await readFile14(assignmentPath, "utf-8");
+    const content = await readFile15(assignmentPath, "utf-8");
     await writeFileForce(assignmentPath, applyArchiveFields(content, archived, archived ? archiveReason(req.body) : null));
     const assignment = await getAssignmentDetailById(projectsDir, assignmentsDir2, id);
     res.json({ assignment });
@@ -10071,7 +10106,7 @@ ${entry}`;
         res.status(400).json({ error: validation.error });
         return;
       }
-      let content = await readFile14(assignmentPath, "utf-8");
+      let content = await readFile15(assignmentPath, "utf-8");
       content = setTopLevelField(content, "assignee", validation.value);
       content = setTopLevelField(content, "updated", nowTimestamp());
       await writeFileForce(assignmentPath, content);
@@ -10102,7 +10137,7 @@ ${entry}`;
         res.status(400).json({ error: validation.error });
         return;
       }
-      let content = await readFile14(assignmentPath, "utf-8");
+      let content = await readFile15(assignmentPath, "utf-8");
       content = setTopLevelField(content, "title", validation.value);
       content = setTopLevelField(content, "updated", nowTimestamp());
       await writeFileForce(assignmentPath, content);
@@ -10620,7 +10655,7 @@ ${entry}`;
         res.status(400).json({ error: `Invalid status. Must be one of: ${validStatuses.join(", ")}.` });
         return;
       }
-      let content = await readFile14(assignmentPath, "utf-8");
+      let content = await readFile15(assignmentPath, "utf-8");
       content = setTopLevelField(content, "status", status);
       content = setTopLevelField(content, "updated", nowTimestamp());
       if (status !== "blocked") {
@@ -10656,7 +10691,7 @@ ${entry}`;
         res.status(400).json({ error: validation.error });
         return;
       }
-      let content = await readFile14(assignmentPath, "utf-8");
+      let content = await readFile15(assignmentPath, "utf-8");
       content = setTopLevelField(content, "assignee", validation.value);
       content = setTopLevelField(content, "updated", nowTimestamp());
       await writeFileForce(assignmentPath, content);
@@ -10689,7 +10724,7 @@ ${entry}`;
         res.status(400).json({ error: validation.error });
         return;
       }
-      let content = await readFile14(assignmentPath, "utf-8");
+      let content = await readFile15(assignmentPath, "utf-8");
       content = setTopLevelField(content, "title", validation.value);
       content = setTopLevelField(content, "updated", nowTimestamp());
       await writeFileForce(assignmentPath, content);
@@ -10826,7 +10861,7 @@ async function appendCommentTo(assignmentDir, assignmentRef, req, res, reloadDet
   let currentContent;
   let currentCount = 0;
   if (await fileExists(commentsPath)) {
-    currentContent = await readFile14(commentsPath, "utf-8");
+    currentContent = await readFile15(commentsPath, "utf-8");
     const countMatch = currentContent.match(/^entryCount:\s*(\d+)/m);
     if (countMatch) currentCount = parseInt(countMatch[1], 10);
   } else {
@@ -10866,7 +10901,7 @@ async function toggleCommentResolvedAt(assignmentDir, commentId, req, res, reloa
     res.status(400).json({ error: "resolved (boolean) is required" });
     return;
   }
-  const content = await readFile14(commentsPath, "utf-8");
+  const content = await readFile15(commentsPath, "utf-8");
   const parsed = parseComments(content);
   const target = parsed.entries.find((e) => e.id === commentId);
   if (!target) {
@@ -11694,7 +11729,7 @@ import { Router as Router8 } from "express";
 
 // src/utils/status-config-resolution.ts
 init_frontmatter();
-import { readFile as readFile15, writeFile as writeFile4, rm as rm2 } from "fs/promises";
+import { readFile as readFile16, writeFile as writeFile4, rm as rm2 } from "fs/promises";
 import { dirname as dirname4 } from "path";
 
 // src/utils/assignment-walk.ts
@@ -11777,7 +11812,7 @@ async function scanAssignmentsByStatus(projectsDir, standaloneDir, ids) {
     const assignmentPath = `${entry.assignmentDir}/assignment.md`;
     let content;
     try {
-      content = await readFile15(assignmentPath, "utf-8");
+      content = await readFile16(assignmentPath, "utf-8");
     } catch (err) {
       const code = err?.code;
       if (code === "ENOENT") {
@@ -11840,7 +11875,7 @@ async function applyStatusResolutions(resolutions, affected, validTargets) {
     const list = affected.get(r.id) ?? [];
     for (const a of list) {
       try {
-        const content = await readFile15(a.path, "utf-8");
+        const content = await readFile16(a.path, "utf-8");
         buffer.set(a.path, content);
       } catch (err) {
         const code = err?.code;
@@ -11868,7 +11903,7 @@ async function applyStatusResolutions(resolutions, affected, validTargets) {
       for (const a of list) {
         let current;
         try {
-          current = await readFile15(a.path, "utf-8");
+          current = await readFile16(a.path, "utf-8");
         } catch (err) {
           const code = err?.code;
           if (code === "ENOENT") {
@@ -11917,7 +11952,7 @@ async function applyStatusResolutions(resolutions, affected, validTargets) {
     const list = affected.get(r.id) ?? [];
     for (const a of list) {
       try {
-        const current = await readFile15(a.path, "utf-8");
+        const current = await readFile16(a.path, "utf-8");
         const fm = parseAssignmentFrontmatter(current);
         if (fm.status !== r.id) {
           console.warn(
@@ -12792,7 +12827,7 @@ init_timestamp();
 init_fs();
 import { Router as Router11 } from "express";
 import { resolve as resolve23 } from "path";
-import { readFile as readFile16 } from "fs/promises";
+import { readFile as readFile17 } from "fs/promises";
 init_playbooks();
 function statusForPlaybookError(code) {
   switch (code) {
@@ -12875,7 +12910,7 @@ function createPlaybooksRouter(playbooksDir2) {
         return;
       }
       const filePath = resolve23(playbooksDir2, resolved.filename);
-      const content = await readFile16(filePath, "utf-8");
+      const content = await readFile17(filePath, "utf-8");
       res.json({
         documentType: "playbook",
         title: `Edit Playbook: ${resolved.slug}`,
@@ -13562,7 +13597,7 @@ function createTodosRouter(todosDir2, broadcast, projectsDir) {
     try {
       const { archivePath: archivePath2 } = await Promise.resolve().then(() => (init_parser2(), parser_exports));
       const { resolve: resolve29 } = await import("path");
-      const { readFile: readFile20 } = await import("fs/promises");
+      const { readFile: readFile21 } = 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);
@@ -13581,7 +13616,7 @@ function createTodosRouter(todosDir2, broadcast, projectsDir) {
       await ensureDir(resolve29(todosDir2, "archive"));
       let archContent = "";
       if (await fileExists(archFile)) {
-        archContent = await readFile20(archFile, "utf-8");
+        archContent = await readFile21(archFile, "utf-8");
         archContent = archContent.trimEnd() + "\n\n";
       } else {
         archContent = `---
@@ -13863,7 +13898,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: readFile20 } = await import("fs/promises");
+        const { readFile: readFile21 } = 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;
@@ -13884,7 +13919,7 @@ workspace: ${workspace}
         }
         const assignmentMdPath = resolvePath2(assignmentDir, "assignment.md");
         if (!await fileExists2(assignmentMdPath)) return { error: `Target assignment not found: ${assignmentMdPath}` };
-        let content = await readFile20(assignmentMdPath, "utf-8");
+        let content = await readFile21(assignmentMdPath, "utf-8");
         content = appendTodosToAssignmentBody2(
           content,
           items.map((it) => ({
@@ -14072,7 +14107,7 @@ init_fs();
 init_paths();
 init_slug();
 import { Router as Router13 } from "express";
-import { mkdir as mkdir3, readFile as readFile17, rename as rename6 } from "fs/promises";
+import { mkdir as mkdir3, readFile as readFile18, rename as rename6 } from "fs/promises";
 import { resolve as resolve25, dirname as dirname6 } from "path";
 init_api();
 var WORKSPACE_REGEX2 = /^[a-z0-9_][a-z0-9-]*$/;
@@ -14296,7 +14331,7 @@ function createProjectTodosRouter(projectsDir, broadcast, workspaceTodosDir) {
       const archFile = archivePath(todosDir2, slug, checklist.archiveInterval);
       let archContent = "";
       if (await fileExists(archFile)) {
-        archContent = await readFile17(archFile, "utf-8");
+        archContent = await readFile18(archFile, "utf-8");
         archContent = archContent.trimEnd() + "\n\n";
       } else {
         archContent = `---
@@ -14753,7 +14788,7 @@ workspace: ${slug}
         }
         const assignmentMdPath = resolve25(assignmentDir, "assignment.md");
         if (!await fileExists(assignmentMdPath)) return { error: `Target assignment not found: ${assignmentMdPath}` };
-        let content = await readFile17(assignmentMdPath, "utf-8");
+        let content = await readFile18(assignmentMdPath, "utf-8");
         content = appendTodosToAssignmentBody2(
           content,
           items.map((it) => ({
@@ -14957,7 +14992,7 @@ init_fs();
 init_paths();
 init_parser2();
 import { randomBytes as randomBytes2 } from "crypto";
-import { readFile as readFile18 } from "fs/promises";
+import { readFile as readFile19 } 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_-]*$/;
@@ -15024,7 +15059,7 @@ function parseBundles(content) {
 async function readBundles(todosDir2) {
   const path = bundlesPath(todosDir2);
   if (!await fileExists(path)) return [];
-  const content = await readFile18(path, "utf-8");
+  const content = await readFile19(path, "utf-8");
   return parseBundles(content).bundles;
 }
 
@@ -15197,7 +15232,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 readFile19, writeFile as writeFile5, unlink as unlink5, stat, open as open2, rename as rename7 } from "fs/promises";
+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 { resolve as resolve27, join as join3 } from "path";
 import { tmpdir } from "os";
 var exec2 = promisify2(execFile2);
@@ -15258,7 +15293,7 @@ async function acquireLock() {
     return lockPath;
   } catch (err) {
     if (err.code === "EEXIST") {
-      const pid = await readFile19(lockPath, "utf-8").catch(() => "");
+      const pid = await readFile20(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.`
       );
@@ -15305,7 +15340,7 @@ function resolveCategoriesStrict(csv) {
   return parseCategoriesStrict(parts);
 }
 async function readSanitizedConfig(configPath) {
-  const content = await readFile19(configPath, "utf-8");
+  const content = await readFile20(configPath, "utf-8");
   return content.replace(/^(\s*lastBackup:\s*).*$/m, "$1null").replace(/^(\s*lastRestore:\s*).*$/m, "$1null");
 }
 async function backupToGithub(overrides) {