syntaur 0.35.0 → 0.37.0

package/dist/index.js

@@ -5382,8 +5382,8 @@ async function migrateFromMarkdown(projectsDir2) {
   return allSessions.length;
 }
 async function parseMarkdownSessionsIndex(filePath, projectSlug) {
-  const { readFile: readFile64 } = await import("fs/promises");
-  const raw2 = await readFile64(filePath, "utf-8");
+  const { readFile: readFile65 } = await import("fs/promises");
+  const raw2 = await readFile65(filePath, "utf-8");
   const sessions = [];
   const lines = raw2.split("\n");
   let inTable = false;
@@ -16925,7 +16925,7 @@ function createTodosRouter(todosDir2, broadcast, projectsDir2) {
     try {
       const { archivePath: archivePath2 } = await Promise.resolve().then(() => (init_parser2(), parser_exports));
       const { resolve: resolve87 } = await import("path");
-      const { readFile: readFile64 } = await import("fs/promises");
+      const { readFile: readFile65 } = await import("fs/promises");
       const { writeFileForce: writeFileForce2 } = await Promise.resolve().then(() => (init_fs(), fs_exports));
       const workspace = getWorkspaceParam(req.params.workspace);
       const outcome = await wsLock(workspace, async () => {
@@ -16944,7 +16944,7 @@ function createTodosRouter(todosDir2, broadcast, projectsDir2) {
         await ensureDir(resolve87(todosDir2, "archive"));
         let archContent = "";
         if (await fileExists(archFile)) {
-          archContent = await readFile64(archFile, "utf-8");
+          archContent = await readFile65(archFile, "utf-8");
           archContent = archContent.trimEnd() + "\n\n";
         } else {
           archContent = `---
@@ -17233,7 +17233,7 @@ workspace: ${workspace}
         const { readConfig: readConfig3 } = await Promise.resolve().then(() => (init_config2(), config_exports));
         const { assignmentsDir: assignmentsDirFn } = await Promise.resolve().then(() => (init_paths(), paths_exports));
         const { fileExists: fileExists2, writeFileForce: writeFileForce2 } = await Promise.resolve().then(() => (init_fs(), fs_exports));
-        const { readFile: readFile64 } = await import("fs/promises");
+        const { readFile: readFile65 } = 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;
@@ -17254,7 +17254,7 @@ workspace: ${workspace}
         }
         const assignmentMdPath2 = resolvePath2(assignmentDir, "assignment.md");
         if (!await fileExists2(assignmentMdPath2)) return { error: `Target assignment not found: ${assignmentMdPath2}` };
-        let content = await readFile64(assignmentMdPath2, "utf-8");
+        let content = await readFile65(assignmentMdPath2, "utf-8");
         content = appendTodosToAssignmentBody2(
           content,
           items.map((it) => ({
@@ -21238,6 +21238,12 @@ async function getConfiguredOrLegacyManagedPluginDir(pluginKind) {
   }
   return null;
 }
+async function readManagedInstallVersion(pluginKind) {
+  const dir = await getConfiguredOrLegacyManagedPluginDir(pluginKind);
+  if (!dir) return null;
+  const metadata = await readInstallMetadata(dir);
+  return metadata?.packageVersion ?? null;
+}
 async function getConfiguredOrLegacyMarketplacePath() {
   const config = await readConfig();
   if (config.integrations.codexMarketplacePath) {
@@ -22278,7 +22284,7 @@ function normalizeSlashes(p) {
 }
 function detectInstallKind(scriptUrl, opts = {}) {
   const realpath3 = opts.realpath ?? realpathSync.native;
-  const readFile64 = opts.readFile ?? ((p) => readFileSync(p, "utf-8"));
+  const readFile65 = opts.readFile ?? ((p) => readFileSync(p, "utf-8"));
   const ua = opts.envUserAgent !== void 0 ? opts.envUserAgent : process.env.npm_config_user_agent ?? "";
   const resolved = resolveScriptPath(scriptUrl, realpath3);
   if (resolved === null) {
@@ -22299,7 +22305,7 @@ function detectInstallKind(scriptUrl, opts = {}) {
     const pkgJsonPath = join5(dir, "package.json");
     let raw2;
     try {
-      raw2 = readFile64(pkgJsonPath);
+      raw2 = readFile65(pkgJsonPath);
     } catch {
       const parent2 = dirname12(dir);
       if (parent2 === dir) break;
@@ -25865,12 +25871,12 @@ function describeScope(scope) {
 }
 async function injectPromotedTodos(assignmentDir, todos, scopeLabel) {
   const { resolve: resolvePath2 } = await import("path");
-  const { readFile: readFile64 } = await import("fs/promises");
+  const { readFile: readFile65 } = await import("fs/promises");
   const { writeFileForce: writeFileForce2 } = await Promise.resolve().then(() => (init_fs(), fs_exports));
   const { appendTodosToAssignmentBody: appendTodosToAssignmentBody2, touchAssignmentUpdated: touchAssignmentUpdated2 } = await Promise.resolve().then(() => (init_assignment_todos(), assignment_todos_exports));
   const { nowTimestamp: nowTimestamp3 } = await Promise.resolve().then(() => (init_timestamp(), timestamp_exports));
   const assignmentMdPath2 = resolvePath2(assignmentDir, "assignment.md");
-  let content = await readFile64(assignmentMdPath2, "utf-8");
+  let content = await readFile65(assignmentMdPath2, "utf-8");
   content = appendTodosToAssignmentBody2(
     content,
     todos.map((t) => ({
@@ -26002,8 +26008,8 @@ async function moveTodo(id, options) {
       throw new Error(`Plan directory already exists at target: ${newPlanDir}; refusing to move.`);
     }
     const { rename: rename11, mkdir: mkdir12 } = await import("fs/promises");
-    const { dirname: dirname25 } = await import("path");
-    await mkdir12(dirname25(newPlanDir), { recursive: true });
+    const { dirname: dirname26 } = await import("path");
+    await mkdir12(dirname26(newPlanDir), { recursive: true });
     await rename11(item.planDir, newPlanDir);
     item.planDir = newPlanDir;
   }
@@ -26120,13 +26126,13 @@ backupCommand.command("config").description("Show or update backup configuration
 
 // src/commands/doctor.ts
 import { Command as Command4 } from "commander";
-import { readFile as readFile46 } from "fs/promises";
+import { readFile as readFile47 } from "fs/promises";
 import { isAbsolute as isAbsolute11, resolve as resolve69 } from "path";
 
 // src/utils/doctor/index.ts
-import { fileURLToPath as fileURLToPath11 } from "url";
-import { readFile as readFile45 } from "fs/promises";
-import { dirname as dirname21, join as join14 } from "path";
+import { fileURLToPath as fileURLToPath12 } from "url";
+import { readFile as readFile46 } from "fs/promises";
+import { dirname as dirname22, join as join15 } from "path";
 
 // src/utils/doctor/context.ts
 init_config2();
@@ -28699,6 +28705,64 @@ var bundleChecks = [
   staleWorktree
 ];
 
+// src/utils/doctor/checks/plugin.ts
+import { readFile as readFile45 } from "fs/promises";
+import { dirname as dirname21, join as join14 } from "path";
+import { fileURLToPath as fileURLToPath11 } from "url";
+var CATEGORY13 = "plugin";
+var PLUGIN_KINDS = ["claude", "codex"];
+async function readCliVersion() {
+  try {
+    let dir = dirname21(fileURLToPath11(import.meta.url));
+    for (let i = 0; i < 8; i += 1) {
+      try {
+        const parsed = JSON.parse(await readFile45(join14(dir, "package.json"), "utf-8"));
+        if (typeof parsed.version === "string" && parsed.version.length > 0) return parsed.version;
+      } catch {
+      }
+      dir = dirname21(dir);
+    }
+  } catch {
+  }
+  return null;
+}
+var versionDrift = {
+  id: "plugin.version-drift",
+  category: CATEGORY13,
+  title: "Installed plugin matches the CLI version",
+  async run() {
+    const cliVersion2 = await readCliVersion();
+    return Promise.all(
+      PLUGIN_KINDS.map(async (kind) => {
+        const base = { id: this.id, category: this.category, title: this.title, affected: [kind], autoFixable: false };
+        const label = getPluginDisplayName(kind);
+        const installed = await readManagedInstallVersion(kind);
+        if (installed === null) {
+          return { ...base, status: "skipped", detail: `no managed ${label} install` };
+        }
+        if (!cliVersion2) {
+          return { ...base, status: "skipped", detail: "could not read the running CLI version" };
+        }
+        if (installed === cliVersion2) {
+          return { ...base, status: "pass", detail: `${label} ${installed} matches CLI` };
+        }
+        const command = `${getPluginInstallCommand(kind)} --force`;
+        return {
+          ...base,
+          status: "warn",
+          detail: `installed ${label} v${installed} differs from CLI v${cliVersion2}`,
+          remediation: {
+            kind: "manual",
+            suggestion: `Re-run \`${command}\` to refresh the ${label}`,
+            command
+          }
+        };
+      })
+    );
+  }
+};
+var pluginChecks = [versionDrift];
+
 // src/utils/doctor/registry.ts
 function allChecks() {
   return [
@@ -28713,7 +28777,8 @@ function allChecks() {
     ...terminalChecks,
     ...skillsChecks,
     ...crossAgentChecks,
-    ...bundleChecks
+    ...bundleChecks,
+    ...pluginChecks
   ];
 }
 
@@ -28795,15 +28860,15 @@ async function finalize(checks) {
 }
 async function readVersion() {
   try {
-    const here = fileURLToPath11(import.meta.url);
-    let dir = dirname21(here);
+    const here = fileURLToPath12(import.meta.url);
+    let dir = dirname22(here);
     for (let i = 0; i < 6; i++) {
       try {
-        const raw2 = await readFile45(join14(dir, "package.json"), "utf-8");
+        const raw2 = await readFile46(join15(dir, "package.json"), "utf-8");
         const parsed = JSON.parse(raw2);
         return typeof parsed.version === "string" ? parsed.version : null;
       } catch {
-        dir = dirname21(dir);
+        dir = dirname22(dir);
       }
     }
     return null;
@@ -28909,7 +28974,7 @@ async function validateAssignmentFile(inputPath, cwd = process.cwd()) {
   }
   let content;
   try {
-    content = await readFile46(absolute, "utf-8");
+    content = await readFile47(absolute, "utf-8");
   } catch (err2) {
     return {
       ok: false,
@@ -29234,7 +29299,7 @@ init_timestamp();
 init_assignment_resolver();
 init_templates();
 import { resolve as resolve70 } from "path";
-import { readFile as readFile47 } from "fs/promises";
+import { readFile as readFile48 } from "fs/promises";
 function shortId() {
   return generateId().split("-")[0];
 }
@@ -29280,7 +29345,7 @@ async function commentCommand(target, text, options = {}) {
   let currentContent;
   let currentCount = 0;
   if (await fileExists(commentsPath)) {
-    currentContent = await readFile47(commentsPath, "utf-8");
+    currentContent = await readFile48(commentsPath, "utf-8");
     const countMatch = currentContent.match(/^entryCount:\s*(\d+)/m);
     if (countMatch) currentCount = parseInt(countMatch[1], 10);
   } else {
@@ -29314,7 +29379,7 @@ ${entry}`;
 }
 
 // src/commands/capture.ts
-import { resolve as resolve74, relative as relative4, dirname as dirname22 } from "path";
+import { resolve as resolve74, relative as relative4, dirname as dirname23 } from "path";
 import { copyFile as copyFile3, mkdir as mkdir11, realpath as realpath2, rm as rm13, stat as stat9, writeFile as writeFile15 } from "fs/promises";
 import { existsSync as existsSync6 } from "fs";
 
@@ -29326,7 +29391,7 @@ init_slug();
 init_assignment_resolver();
 init_parser();
 import { resolve as resolve71 } from "path";
-import { readFile as readFile48 } from "fs/promises";
+import { readFile as readFile49 } from "fs/promises";
 var AssignmentTargetError = class extends Error {
 };
 function classifyContext(ctx) {
@@ -29341,7 +29406,7 @@ async function readAssignmentFrontmatterId(assignmentDir) {
   const path = resolve71(assignmentDir, "assignment.md");
   if (!await fileExists(path)) return null;
   try {
-    const content = await readFile48(path, "utf-8");
+    const content = await readFile49(path, "utf-8");
     const [fm] = extractFrontmatter(content);
     return getField(fm, "id");
   } catch {
@@ -29352,7 +29417,7 @@ async function readContextJson(cwd) {
   const path = resolve71(cwd, ".syntaur", "context.json");
   if (!await fileExists(path)) return null;
   try {
-    const raw2 = await readFile48(path, "utf-8");
+    const raw2 = await readFile49(path, "utf-8");
     return JSON.parse(raw2);
   } catch {
     return null;
@@ -29479,7 +29544,7 @@ init_fs();
 import { spawn as spawn7 } from "child_process";
 import { mkdtemp as mkdtemp2, rm as rm9, stat as stat7 } from "fs/promises";
 import { tmpdir as tmpdir3 } from "os";
-import { join as join15 } from "path";
+import { join as join16 } from "path";
 function argsFor(mode, pngPath) {
   switch (mode) {
     case "interactive":
@@ -29512,8 +29577,8 @@ async function captureScreenshot(mode) {
       "screencapture is only available on macOS. Use --file <path> to attach an existing image."
     );
   }
-  const tmpDir = await mkdtemp2(join15(tmpdir3(), "syntaur-screenshot-"));
-  const pngPath = join15(tmpDir, "shot.png");
+  const tmpDir = await mkdtemp2(join16(tmpdir3(), "syntaur-screenshot-"));
+  const pngPath = join16(tmpDir, "shot.png");
   const cleanup = async () => {
     await rm9(tmpDir, { recursive: true, force: true }).catch(() => {
     });
@@ -29551,9 +29616,9 @@ async function captureScreenshot(mode) {
 
 // src/utils/asciinema.ts
 import { spawn as spawn8 } from "child_process";
-import { mkdtemp as mkdtemp3, readFile as readFile49, rm as rm10 } from "fs/promises";
+import { mkdtemp as mkdtemp3, readFile as readFile50, rm as rm10 } from "fs/promises";
 import { tmpdir as tmpdir4 } from "os";
-import { join as join16 } from "path";
+import { join as join17 } from "path";
 var SAFE_RE = /^[A-Za-z0-9_@%+=:,./-]+$/;
 function shellQuote2(s) {
   if (s.length === 0) return `''`;
@@ -29590,8 +29655,8 @@ function runAsciinema(args, stdio) {
   });
 }
 async function captureAsciinema(opts) {
-  const tmpDir = await mkdtemp3(join16(tmpdir4(), "syntaur-asciinema-"));
-  const castPath = join16(tmpDir, "session.cast");
+  const tmpDir = await mkdtemp3(join17(tmpdir4(), "syntaur-asciinema-"));
+  const castPath = join17(tmpDir, "session.cast");
   const cleanup = async () => {
     await rm10(tmpDir, { recursive: true, force: true }).catch(() => {
     });
@@ -29614,7 +29679,7 @@ async function captureAsciinema(opts) {
       }
       throw err2;
     }
-    const text = await readFile49(castPath, "utf8").catch(() => null);
+    const text = await readFile50(castPath, "utf8").catch(() => null);
     if (text === null) {
       throw new Error(
         `asciinema produced no cast file at ${castPath} (exit ${exitCode}). Try running 'asciinema rec ${castPath}' directly to diagnose.`
@@ -29642,9 +29707,9 @@ async function captureAsciinema(opts) {
 // src/utils/recording.ts
 init_paths();
 import { spawn as spawn9 } from "child_process";
-import { mkdir as mkdir10, mkdtemp as mkdtemp4, open as open3, readFile as readFile50, rm as rm11, stat as stat8, unlink as unlink10, writeFile as writeFile14 } from "fs/promises";
+import { mkdir as mkdir10, mkdtemp as mkdtemp4, open as open3, readFile as readFile51, rm as rm11, stat as stat8, unlink as unlink10, writeFile as writeFile14 } from "fs/promises";
 import { tmpdir as tmpdir5 } from "os";
-import { join as join17, resolve as resolve72 } from "path";
+import { join as join18, resolve as resolve72 } from "path";
 import { setTimeout as sleep } from "timers/promises";
 function sigintPollIntervalMs() {
   const raw2 = process.env.SYNTAUR_RECORDING_POLL_INTERVAL_MS;
@@ -29716,7 +29781,7 @@ async function acquirePidfile(pidfile) {
     } catch (err2) {
       if (err2.code !== "EEXIST") throw err2;
       if (attempt === 1) throw err2;
-      const existing = (await readFile50(pidfile, "utf-8").catch(() => "")).trim();
+      const existing = (await readFile51(pidfile, "utf-8").catch(() => "")).trim();
       if (existing.startsWith(STARTING_SENTINEL_PREFIX)) {
         const parentPidRaw = existing.slice(STARTING_SENTINEL_PREFIX.length);
         const parentPid = Number.parseInt(parentPidRaw, 10);
@@ -29769,8 +29834,8 @@ async function startRecording(input4) {
   let acquiredPid = null;
   try {
     logHandle = await open3(log, "w");
-    tmpDir = await mkdtemp4(join17(tmpdir5(), "syntaur-recording-"));
-    const mp4Path = join17(tmpDir, "recording.mp4");
+    tmpDir = await mkdtemp4(join18(tmpdir5(), "syntaur-recording-"));
+    const mp4Path = join18(tmpDir, "recording.mp4");
     let child;
     try {
       child = spawn9("ffmpeg", ffmpegArgs(input4.device, input4.fps, mp4Path), {
@@ -29818,7 +29883,7 @@ async function startRecording(input4) {
     logHandle = null;
     if (warmupMs > 0) await sleep(warmupMs);
     if (!await isProcessAlive(pid)) {
-      const tail = await readFile50(log, "utf-8").then((s) => s.split("\n").slice(-20).join("\n")).catch(() => "");
+      const tail = await readFile51(log, "utf-8").then((s) => s.split("\n").slice(-20).join("\n")).catch(() => "");
       acquiredPid = null;
       throw new Error(
         `ffmpeg exited during startup \u2014 likely macOS Screen Recording permission missing. Grant access to your terminal in System Settings \u2192 Privacy & Security \u2192 Screen Recording, then retry. Log: ${log}
@@ -29875,7 +29940,7 @@ ${tail}`
 async function stopRecording() {
   const pidfile = pidfilePath();
   const sidecar = sidecarPath();
-  const pidRaw = await readFile50(pidfile, "utf-8").catch(() => null);
+  const pidRaw = await readFile51(pidfile, "utf-8").catch(() => null);
   if (pidRaw === null) {
     throw new Error(
       `No active recording found (no pidfile at ${pidfile}). Did you run --start?`
@@ -29885,7 +29950,7 @@ async function stopRecording() {
   if (!Number.isInteger(pid) || pid <= 0) {
     throw new Error(`Pidfile at ${pidfile} is corrupt (got "${pidRaw}").`);
   }
-  const sidecarRaw = await readFile50(sidecar, "utf-8").catch(() => null);
+  const sidecarRaw = await readFile51(sidecar, "utf-8").catch(() => null);
   if (sidecarRaw === null) {
     throw new Error(
       `No recording sidecar at ${sidecar}. The recording state is inconsistent \u2014 delete ${pidfile} and re-run --start.`
@@ -30018,9 +30083,9 @@ function listArtifactsByAssignment(assignmentId) {
 
 // src/utils/transcribers/elevenlabs.ts
 import { spawn as spawn10 } from "child_process";
-import { mkdtemp as mkdtemp5, readFile as readFile51, rm as rm12 } from "fs/promises";
+import { mkdtemp as mkdtemp5, readFile as readFile52, rm as rm12 } from "fs/promises";
 import { tmpdir as tmpdir6 } from "os";
-import { join as join18 } from "path";
+import { join as join19 } from "path";
 var SCRIBE_URL = "https://api.elevenlabs.io/v1/speech-to-text";
 var NO_AUDIO_MARKERS = [
   "Stream map '0:a:0' matches no streams",
@@ -30082,7 +30147,7 @@ async function extractAudio(videoAbsPath, wavOut) {
   throw new TranscribeFfmpegError(`ffmpeg failed (exit ${result.code}): ${tail}`);
 }
 async function callScribe(wavPath, apiKey, opts) {
-  const audio = await readFile51(wavPath);
+  const audio = await readFile52(wavPath);
   const form = new FormData();
   form.set("file", new Blob([new Uint8Array(audio)], { type: "audio/wav" }), "audio.wav");
   form.set("model_id", "scribe_v1");
@@ -30110,8 +30175,8 @@ var elevenLabsScribe = {
         "ELEVENLABS_API_KEY is not set. Export it (e.g. `export ELEVENLABS_API_KEY=\u2026`) and re-run. A config-file slot will land later."
       );
     }
-    const tmp = await mkdtemp5(join18(tmpdir6(), "syntaur-transcribe-"));
-    const wav = join18(tmp, "audio.wav");
+    const tmp = await mkdtemp5(join19(tmpdir6(), "syntaur-transcribe-"));
+    const wav = join19(tmp, "audio.wav");
     try {
       await extractAudio(videoAbsPath, wav);
       return await callScribe(wav, apiKey, opts);
@@ -30385,7 +30450,7 @@ async function captureCommand(target, options = {}) {
     criterionIndex = sidecar.criterionIndex;
     stopNote = sidecar.note;
     resolvedSource = mp4Path;
-    const mp4TmpDir = dirname22(mp4Path);
+    const mp4TmpDir = dirname23(mp4Path);
     shelloutCleanup = async () => {
       await rm13(mp4TmpDir, { recursive: true, force: true }).catch(() => {
       });
@@ -30547,8 +30612,8 @@ async function captureCommand(target, options = {}) {
 
 // src/commands/proof.ts
 import { Command as Command6 } from "commander";
-import { readFile as readFile52, writeFile as writeFile16, rename as rename10, stat as stat10 } from "fs/promises";
-import { resolve as resolve75, relative as relative5, isAbsolute as isAbsolute12, dirname as dirname23 } from "path";
+import { readFile as readFile53, writeFile as writeFile16, rename as rename10, stat as stat10 } from "fs/promises";
+import { resolve as resolve75, relative as relative5, isAbsolute as isAbsolute12, dirname as dirname24 } from "path";
 import { randomBytes as randomBytes4 } from "crypto";
 
 // src/utils/acceptance-criteria-parse.ts
@@ -30792,7 +30857,7 @@ async function readAssignmentMeta(assignmentDir) {
   if (!await fileExists(path)) {
     return { title: "", body: "" };
   }
-  const content = await readFile52(path, "utf-8");
+  const content = await readFile53(path, "utf-8");
   const fmMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/);
   let title = "";
   if (fmMatch) {
@@ -30854,7 +30919,7 @@ async function loadInlineFiles(rows, assignmentDir) {
       continue;
     }
     try {
-      out.set(r.file_path, await readFile52(abs, "utf-8"));
+      out.set(r.file_path, await readFile53(abs, "utf-8"));
     } catch {
       out.set(r.file_path, null);
     }
@@ -30867,13 +30932,13 @@ async function loadTranscriptSidecars(rows, assignmentDir) {
   for (const r of rows) {
     if (r.kind !== "video" || !r.file_path) continue;
     const videoAbs = resolve75(assignmentDir, r.file_path);
-    const sidecar = resolve75(dirname23(videoAbs), `${r.id}.transcript.md`);
+    const sidecar = resolve75(dirname24(videoAbs), `${r.id}.transcript.md`);
     if (!isWithin(proofRoot, sidecar)) continue;
     if (!await fileExists(sidecar)) continue;
     const st = await stat10(sidecar);
     if (st.size > INLINE_TEXT_LIMIT_BYTES) continue;
     try {
-      out.set(r.id, await readFile52(sidecar, "utf-8"));
+      out.set(r.id, await readFile53(sidecar, "utf-8"));
     } catch {
     }
   }
@@ -31632,7 +31697,7 @@ function isoToCcusageDate(iso) {
 // src/usage/cwd-extractor.ts
 init_paths();
 import { open as open4, readdir as readdir26, stat as stat11 } from "fs/promises";
-import { join as join19 } from "path";
+import { join as join20 } from "path";
 import { homedir as homedir12 } from "os";
 var SCAN_LINE_CAP = 50;
 var TAIL_READ_BYTES = 8 * 1024;
@@ -31709,12 +31774,12 @@ async function* walkClaudeProjects(opts = {}) {
   const dirs = await listDirSafe(root);
   for (const dirent of dirs) {
     if (!dirent.isDirectory) continue;
-    const dirPath = join19(root, dirent.name);
+    const dirPath = join20(root, dirent.name);
     const files = await listDirSafe(dirPath);
     let cachedCwd = null;
     for (const f of files) {
       if (!f.isFile || !f.name.endsWith(".jsonl")) continue;
-      const filePath = join19(dirPath, f.name);
+      const filePath = join20(dirPath, f.name);
       if (opts.sinceMtimeMs !== void 0) {
         const mtime = await mtimeMs(filePath);
         if (mtime !== null && mtime < opts.sinceMtimeMs) continue;
@@ -31751,8 +31816,8 @@ function resolveCodexSessionsRoot(override) {
   const fromSessionsEnv = process.env.CODEX_SESSIONS_DIR;
   if (fromSessionsEnv && fromSessionsEnv.length > 0) return expandHome(fromSessionsEnv);
   const fromHomeEnv = process.env.CODEX_HOME;
-  if (fromHomeEnv && fromHomeEnv.length > 0) return join19(expandHome(fromHomeEnv), "sessions");
-  return join19(homedir12(), ".codex", "sessions");
+  if (fromHomeEnv && fromHomeEnv.length > 0) return join20(expandHome(fromHomeEnv), "sessions");
+  return join20(homedir12(), ".codex", "sessions");
 }
 async function listDirSafe(path) {
   try {
@@ -31772,7 +31837,7 @@ async function* walkJsonlRecursive(root) {
     const current = stack.pop();
     const entries = await listDirSafe(current);
     for (const e of entries) {
-      const full = join19(current, e.name);
+      const full = join20(current, e.name);
       if (e.isDirectory) {
         stack.push(full);
       } else if (e.isFile && e.name.endsWith(".jsonl")) {
@@ -32112,7 +32177,7 @@ init_timestamp();
 init_assignment_resolver();
 init_assignment_todos();
 import { resolve as resolve76 } from "path";
-import { readFile as readFile53 } from "fs/promises";
+import { readFile as readFile54 } from "fs/promises";
 async function requestCommand(target, text, options = {}) {
   if (!text || !text.trim()) {
     throw new Error("Request text cannot be empty.");
@@ -32143,7 +32208,7 @@ async function requestCommand(target, text, options = {}) {
     throw new Error(`assignment.md not found at ${assignmentMdPath2}`);
   }
   const source = options.from ?? process.env.SYNTAUR_ASSIGNMENT ?? "unknown";
-  let content = await readFile53(assignmentMdPath2, "utf-8");
+  let content = await readFile54(assignmentMdPath2, "utf-8");
   content = appendTodosToAssignmentBody(content, [
     { description: `${text.trim()} (from: ${source})` }
   ]);
@@ -32157,13 +32222,13 @@ init_fs();
 init_paths();
 init_config2();
 import { Command as Command9 } from "commander";
-import { readFile as readFile54, readdir as readdir27 } from "fs/promises";
+import { readFile as readFile55, readdir as readdir27 } from "fs/promises";
 import { resolve as resolve77 } from "path";
 async function readContextAssignmentDir(cwd) {
   const path = resolve77(cwd, ".syntaur", "context.json");
   if (!await fileExists(path)) return null;
   try {
-    const raw2 = await readFile54(path, "utf-8");
+    const raw2 = await readFile55(path, "utf-8");
     const ctx = JSON.parse(raw2);
     if (typeof ctx.assignmentDir === "string" && ctx.assignmentDir.length > 0) {
       return ctx.assignmentDir;
@@ -32385,7 +32450,7 @@ async function runPlanCreate(options) {
       "plan.md already exists. Use --force to overwrite, or `syntaur plan version` to create the next version."
     );
   }
-  const assignmentMd = await readFile54(assignmentMdPath2, "utf-8");
+  const assignmentMd = await readFile55(assignmentMdPath2, "utf-8");
   const slugMatch = assignmentMd.match(/^slug:\s*(.+?)\s*$/m);
   const slug = slugMatch ? slugMatch[1].trim() : assignmentDir.split("/").pop() ?? "";
   await writeFileForce(planPath, buildInitialPlanStub(slug));
@@ -32421,11 +32486,11 @@ async function runPlanVersion(options) {
   if (await fileExists(newPath) && !options.force) {
     throw new Error(`${next.fileName} already exists. Use --force to overwrite.`);
   }
-  const assignmentMd = await readFile54(assignmentMdPath2, "utf-8");
+  const assignmentMd = await readFile55(assignmentMdPath2, "utf-8");
   const slugMatch = assignmentMd.match(/^slug:\s*(.+?)\s*$/m);
   const slug = slugMatch ? slugMatch[1].trim() : assignmentDir.split("/").pop() ?? "";
   const oldPlanPath = resolve77(assignmentDir, current.fileName);
-  const oldPlanContent = await readFile54(oldPlanPath, "utf-8");
+  const oldPlanContent = await readFile55(oldPlanPath, "utf-8");
   const oldBody = oldPlanContent.replace(/^---[\s\S]*?\n---\n?/, "");
   const carriedTodos = extractUncheckedTodos(oldBody);
   const stub = buildNewPlanStub({
@@ -32473,14 +32538,14 @@ init_paths();
 init_config2();
 init_timestamp();
 import { Command as Command10 } from "commander";
-import { readFile as readFile55, readdir as readdir28, stat as stat12 } from "fs/promises";
+import { readFile as readFile56, readdir as readdir28, stat as stat12 } from "fs/promises";
 import { resolve as resolve78 } from "path";
 
 // src/utils/session-id.ts
 import { execFileSync as execFileSync3 } from "child_process";
 import { mkdirSync as mkdirSync3, readFileSync as readFileSync2, statSync as statSync3, writeFileSync as writeFileSync2 } from "fs";
 import { homedir as homedir13 } from "os";
-import { dirname as dirname24, join as join20 } from "path";
+import { dirname as dirname25, join as join21 } from "path";
 var SESSION_ID_ENV_VARS = [
   "CLAUDE_CODE_SESSION_ID",
   "OPENCODE_SESSION_ID",
@@ -32512,7 +32577,7 @@ function defaultStatMtimeMs(path) {
 }
 function readRuntimeMarker(pid, dir) {
   if (!Number.isInteger(pid) || pid <= 0) return null;
-  const path = join20(dir, `${pid}.json`);
+  const path = join21(dir, `${pid}.json`);
   try {
     const parsed = JSON.parse(readFileSync2(path, "utf8"));
     if (parsed && typeof parsed === "object" && typeof parsed.sessionId === "string" && parsed.sessionId.length > 0) {
@@ -32571,8 +32636,8 @@ async function resolveOwnSessionId(opts = {}, deps = {}) {
   const sideChannel = await resolveSideChannelSessionId(opts, deps);
   if (sideChannel) return sideChannel;
   const home2 = deps.homeDir ?? homedir13();
-  const claudeSessionsDir = deps.claudeSessionsDir ?? join20(home2, ".claude", "sessions");
-  const runtimeSessionsDir = deps.runtimeSessionsDir ?? join20(home2, ".syntaur", "runtime", "sessions");
+  const claudeSessionsDir = deps.claudeSessionsDir ?? join21(home2, ".claude", "sessions");
+  const runtimeSessionsDir = deps.runtimeSessionsDir ?? join21(home2, ".syntaur", "runtime", "sessions");
   const startPid = deps.startPid ?? process.ppid;
   const fromMarker = resolveFromAncestorMarkers(
     startPid,
@@ -32596,7 +32661,7 @@ async function readContext(cwd) {
   const path = resolve78(cwd, ".syntaur", "context.json");
   if (!await fileExists(path)) return null;
   try {
-    const raw2 = await readFile55(path, "utf-8");
+    const raw2 = await readFile56(path, "utf-8");
     return JSON.parse(raw2);
   } catch {
     return null;
@@ -32621,7 +32686,7 @@ async function findLatestSessionSummary(assignmentDir) {
 async function findOpenHandoff(assignmentDir) {
   const handoffPath = resolve78(assignmentDir, "handoff.md");
   if (!await fileExists(handoffPath)) return null;
-  const content = await readFile55(handoffPath, "utf-8");
+  const content = await readFile56(handoffPath, "utf-8");
   const body = content.replace(/^---[\s\S]*?\n---\n?/, "").trim();
   if (body.length === 0) return null;
   if (/^<!--[\s\S]*-->$/.test(body)) return null;
@@ -32781,13 +32846,13 @@ async function runSessionSave(options, cwd = process.cwd(), body) {
   const now = nowTimestamp();
   let created = now;
   if (await fileExists(summaryPath)) {
-    const existing = await readFile55(summaryPath, "utf-8");
+    const existing = await readFile56(summaryPath, "utf-8");
     created = extractCreated(existing) ?? now;
   }
   let sectionBody = body;
   if (sectionBody === void 0) {
     if (options.fromFile) {
-      sectionBody = await readFile55(resolve78(cwd, options.fromFile), "utf-8");
+      sectionBody = await readFile56(resolve78(cwd, options.fromFile), "utf-8");
     } else {
       sectionBody = await readStdin();
     }
@@ -32847,13 +32912,13 @@ init_config2();
 init_timestamp();
 init_frontmatter();
 import { Command as Command11 } from "commander";
-import { readFile as readFile56 } from "fs/promises";
+import { readFile as readFile57 } from "fs/promises";
 import { resolve as resolve79 } from "path";
 async function readContext2(cwd) {
   const path = resolve79(cwd, ".syntaur", "context.json");
   if (!await fileExists(path)) return null;
   try {
-    return JSON.parse(await readFile56(path, "utf-8"));
+    return JSON.parse(await readFile57(path, "utf-8"));
   } catch {
     return null;
   }
@@ -32908,7 +32973,7 @@ async function runWorktreeRemove(options, cwd = process.cwd()) {
   if (!await fileExists(assignmentPath)) {
     throw new Error(`Assignment file not found: ${assignmentPath}`);
   }
-  const original = await readFile56(assignmentPath, "utf-8");
+  const original = await readFile57(assignmentPath, "utf-8");
   const fm = parseAssignmentFrontmatter(original);
   const repository = options.repository ?? fm.workspace.repository ?? void 0;
   const worktreePath = fm.workspace.worktreePath ?? void 0;
@@ -33008,12 +33073,12 @@ init_fs();
 init_slug();
 import { Command as Command12 } from "commander";
 import { resolve as resolve81 } from "path";
-import { readFile as readFile58, readdir as readdir30, rm as rm14 } from "fs/promises";
+import { readFile as readFile59, readdir as readdir30, rm as rm14 } from "fs/promises";
 
 // src/utils/project-indexes.ts
 init_parser();
 init_fs();
-import { readdir as readdir29, readFile as readFile57 } from "fs/promises";
+import { readdir as readdir29, readFile as readFile58 } from "fs/promises";
 import { resolve as resolve80 } from "path";
 function nowIso3() {
   return (/* @__PURE__ */ new Date()).toISOString().replace(/\.\d{3}Z$/, "Z");
@@ -33049,7 +33114,7 @@ async function rebuildResourcesIndex(projectDir) {
   lines.push("| Name | Category | Source | Related Assignments | Updated |");
   lines.push("|------|----------|--------|---------------------|---------|");
   for (const fileName of files) {
-    const content = await readFile57(resolve80(dir, fileName), "utf-8");
+    const content = await readFile58(resolve80(dir, fileName), "utf-8");
     const parsed = parseResource(content);
     const slugBase = fileName.replace(/\.md$/, "");
     const name = parsed.name || slugBase;
@@ -33080,7 +33145,7 @@ async function rebuildMemoriesIndex(projectDir) {
   lines.push("| Name | Source | Scope | Source Assignment | Updated |");
   lines.push("|------|--------|-------|-------------------|---------|");
   for (const fileName of files) {
-    const content = await readFile57(resolve80(dir, fileName), "utf-8");
+    const content = await readFile58(resolve80(dir, fileName), "utf-8");
     const parsed = parseMemory(content);
     const slugBase = fileName.replace(/\.md$/, "");
     const name = parsed.name || slugBase;
@@ -33195,7 +33260,7 @@ async function runResourceList(project) {
   const slugs = await listResourceSlugs(projectDir);
   const out = [];
   for (const slug of slugs) {
-    const parsed = parseResource(await readFile58(resolve81(projectDir, "resources", `${slug}.md`), "utf-8"));
+    const parsed = parseResource(await readFile59(resolve81(projectDir, "resources", `${slug}.md`), "utf-8"));
     out.push({ slug, name: parsed.name, category: parsed.category, source: parsed.source, updated: parsed.updated });
   }
   return out;
@@ -33204,7 +33269,7 @@ async function runResourceShow(project, slug) {
   const projectDir = await resolveProjectDir(project);
   const filePath = resolve81(projectDir, "resources", `${slug}.md`);
   if (!await fileExists(filePath)) throw new Error(`Resource "${slug}" not found in project "${project}".`);
-  const parsed = parseResource(await readFile58(filePath, "utf-8"));
+  const parsed = parseResource(await readFile59(filePath, "utf-8"));
   return {
     slug,
     name: parsed.name,
@@ -33225,7 +33290,7 @@ async function runResourceUpdate(slug, options) {
   if (options.name === void 0 && options.source === void 0 && options.category === void 0 && options.relatedAssignments === void 0) {
     throw new Error("Provide at least one of --name, --source, --category, --related-assignments.");
   }
-  const original = await readFile58(filePath, "utf-8");
+  const original = await readFile59(filePath, "utf-8");
   const content = editResourceFrontmatter(original, {
     name: options.name,
     category: options.category,
@@ -33322,7 +33387,7 @@ init_fs();
 init_slug();
 import { Command as Command13 } from "commander";
 import { resolve as resolve82 } from "path";
-import { readFile as readFile59, readdir as readdir31, rm as rm15 } from "fs/promises";
+import { readFile as readFile60, readdir as readdir31, rm as rm15 } from "fs/promises";
 init_parser();
 function nowIso5() {
   return (/* @__PURE__ */ new Date()).toISOString().replace(/\.\d{3}Z$/, "Z");
@@ -33428,7 +33493,7 @@ async function runMemoryList(project) {
   const slugs = await listMemorySlugs(projectDir);
   const out = [];
   for (const slug of slugs) {
-    const parsed = parseMemory(await readFile59(resolve82(projectDir, "memories", `${slug}.md`), "utf-8"));
+    const parsed = parseMemory(await readFile60(resolve82(projectDir, "memories", `${slug}.md`), "utf-8"));
     out.push({ slug, name: parsed.name, scope: parsed.scope, source: parsed.source, updated: parsed.updated });
   }
   return out;
@@ -33437,7 +33502,7 @@ async function runMemoryShow(project, slug) {
   const projectDir = await resolveProjectDir2(project);
   const filePath = resolve82(projectDir, "memories", `${slug}.md`);
   if (!await fileExists(filePath)) throw new Error(`Memory "${slug}" not found in project "${project}".`);
-  const parsed = parseMemory(await readFile59(filePath, "utf-8"));
+  const parsed = parseMemory(await readFile60(filePath, "utf-8"));
   return {
     slug,
     name: parsed.name,
@@ -33461,7 +33526,7 @@ async function runMemoryUpdate(slug, options) {
       "Provide at least one of --name, --source, --scope, --source-assignment, --related-assignments."
     );
   }
-  const original = await readFile59(filePath, "utf-8");
+  const original = await readFile60(filePath, "utf-8");
   const content = editMemoryFrontmatter(original, {
     name: options.name,
     source: options.source,
@@ -33560,7 +33625,7 @@ init_paths();
 init_fs();
 init_frontmatter();
 import { Command as Command14 } from "commander";
-import { readFile as readFile60 } from "fs/promises";
+import { readFile as readFile61 } from "fs/promises";
 import { resolve as resolve83 } from "path";
 var AGE_PATTERN = /^(\d+)([dhwm])$/i;
 function parseAgeToCutoff(age) {
@@ -33594,7 +33659,7 @@ async function loadTags(item) {
   const path = assignmentMdPath(item);
   if (!await fileExists(path)) return [];
   try {
-    const content = await readFile60(path, "utf-8");
+    const content = await readFile61(path, "utf-8");
     return parseAssignmentFrontmatter(content).tags;
   } catch {
     return [];
@@ -34023,7 +34088,7 @@ init_fs();
 init_timestamp();
 init_frontmatter();
 import { Command as Command16 } from "commander";
-import { readFile as readFile61 } from "fs/promises";
+import { readFile as readFile62 } from "fs/promises";
 import { resolve as resolve84 } from "path";
 async function scanDirs() {
   const config = await readConfig();
@@ -34039,7 +34104,7 @@ function configPath() {
 async function readStatusBlock() {
   const p = configPath();
   if (!await fileExists(p)) return null;
-  const content = await readFile61(p, "utf-8");
+  const content = await readFile62(p, "utf-8");
   return parseStatusConfig(content);
 }
 async function requireStatusBlock() {
@@ -34288,7 +34353,7 @@ async function runStatusRename(id, opts) {
     printBlockDiff(before, after);
     const now2 = nowTimestamp();
     for (const a of affected) {
-      const original = await readFile61(a.path, "utf-8");
+      const original = await readFile62(a.path, "utf-8");
       const rewritten = updateAssignmentFile(original, { status: newId, updated: now2 });
       console.log(`
 --- ${a.display}/assignment.md`);
@@ -34299,9 +34364,9 @@ async function runStatusRename(id, opts) {
   }
   const cfgPath = configPath();
   const buffers = /* @__PURE__ */ new Map();
-  buffers.set(cfgPath, await fileExists(cfgPath) ? await readFile61(cfgPath, "utf-8") : "");
+  buffers.set(cfgPath, await fileExists(cfgPath) ? await readFile62(cfgPath, "utf-8") : "");
   for (const a of affected) {
-    buffers.set(a.path, await readFile61(a.path, "utf-8"));
+    buffers.set(a.path, await readFile62(a.path, "utf-8"));
   }
   const now = nowTimestamp();
   try {
@@ -34481,13 +34546,13 @@ init_config2();
 init_timestamp();
 init_frontmatter();
 import { Command as Command17 } from "commander";
-import { readFile as readFile62 } from "fs/promises";
+import { readFile as readFile63 } from "fs/promises";
 import { resolve as resolve85 } from "path";
 async function readContext3(cwd) {
   const path = resolve85(cwd, ".syntaur", "context.json");
   if (!await fileExists(path)) return null;
   try {
-    return JSON.parse(await readFile62(path, "utf-8"));
+    return JSON.parse(await readFile63(path, "utf-8"));
   } catch {
     return null;
   }
@@ -34538,7 +34603,7 @@ async function runWorkspaceSet(options, cwd = process.cwd()) {
 ${pre.errors.map((e) => `  - ${e}`).join("\n")}`
     );
   }
-  const original = await readFile62(path, "utf-8");
+  const original = await readFile63(path, "utf-8");
   let next = updateAssignmentWorkspace(original, partial);
   next = updateAssignmentFile(next, { updated: nowTimestamp() });
   await writeFileForce(path, next);
@@ -34575,13 +34640,13 @@ init_config2();
 init_timestamp();
 init_templates();
 import { Command as Command18 } from "commander";
-import { readFile as readFile63 } from "fs/promises";
+import { readFile as readFile64 } from "fs/promises";
 import { resolve as resolve86 } from "path";
 async function readContext4(cwd) {
   const path = resolve86(cwd, ".syntaur", "context.json");
   if (!await fileExists(path)) return null;
   try {
-    return JSON.parse(await readFile63(path, "utf-8"));
+    return JSON.parse(await readFile64(path, "utf-8"));
   } catch {
     return null;
   }
@@ -34662,7 +34727,7 @@ async function runProgressLog(text, options, cwd = process.cwd()) {
   }
   const path = resolve86(dir, "progress.md");
   const now = nowTimestamp();
-  const content = await fileExists(path) ? await readFile63(path, "utf-8") : renderProgress({ assignment: slug, timestamp: now });
+  const content = await fileExists(path) ? await readFile64(path, "utf-8") : renderProgress({ assignment: slug, timestamp: now });
   const next = appendProgressEntry(content, text, now);
   await writeFileForce(path, next);
   return path;