syntaur 0.62.0 → 0.64.0

package/dist/dashboard/server.js

@@ -6215,7 +6215,7 @@ async function computeFactsDetailed(input) {
   const ac = countRealAcceptanceCriteria(body);
   const needsPlanDigest = frontmatter.planApproval !== null || declarations.some((d) => d.type === "attestation" && d.binds === "plan");
   const planFile = await latestPlanFile(assignmentDir);
-  const [planFileContent, unresolvedQuestions, depsSatisfied] = await Promise.all([
+  const [planFileContent, unresolvedQuestions2, depsSatisfied] = await Promise.all([
     needsPlanDigest && planFile ? readFile9(resolve10(assignmentDir, planFile), "utf-8").catch(() => null) : Promise.resolve(null),
     countUnresolvedQuestions(assignmentDir),
     areDependenciesSatisfied(projectDir, frontmatter.dependsOn, terminalStatuses)
@@ -6233,7 +6233,7 @@ async function computeFactsDetailed(input) {
     workspaceSet: frontmatter.workspace.repository !== null && frontmatter.workspace.branch !== null,
     implementationStarted: frontmatter.implementationStarted,
     depsSatisfied,
-    unresolvedQuestions,
+    unresolvedQuestions: unresolvedQuestions2,
     blocked: frontmatter.blockedReason !== null,
     parked: frontmatter.parked,
     reviewRequested: frontmatter.reviewRequested,
@@ -7494,8 +7494,8 @@ async function migrateFromMarkdown(projectsDir) {
   return allSessions.length;
 }
 async function parseMarkdownSessionsIndex(filePath, projectSlug) {
-  const { readFile: readFile31 } = await import("fs/promises");
-  const raw2 = await readFile31(filePath, "utf-8");
+  const { readFile: readFile32 } = await import("fs/promises");
+  const raw2 = await readFile32(filePath, "utf-8");
   const sessions = [];
   const lines = raw2.split("\n");
   let inTable = false;
@@ -7954,8 +7954,8 @@ function scanKey(serversDir2, projectsDir, assignmentsDir2) {
   return `${serversDir2}\0${projectsDir}\0${assignmentsDir2 ?? ""}`;
 }
 function delay(ms) {
-  return new Promise((resolve46) => {
-    const timer3 = setTimeout(resolve46, ms);
+  return new Promise((resolve47) => {
+    const timer3 = setTimeout(resolve47, ms);
     if (typeof timer3.unref === "function") {
       timer3.unref();
     }
@@ -11662,8 +11662,8 @@ var init_renderers = __esm({
 });
 
 // src/targets/user-descriptors.ts
-import { resolve as resolve42 } from "path";
-import { readFile as readFile29, readdir as readdir18 } from "fs/promises";
+import { resolve as resolve43 } from "path";
+import { readFile as readFile30, readdir as readdir18 } from "fs/promises";
 var VALID_RENDERER_KEYS;
 var init_user_descriptors = __esm({
   "src/targets/user-descriptors.ts"() {
@@ -11677,20 +11677,20 @@ var init_user_descriptors = __esm({
 
 // src/targets/registry.ts
 import { homedir as homedir7 } from "os";
-import { join as join10, resolve as resolve43 } from "path";
+import { join as join10, resolve as resolve44 } from "path";
 function home(...segments) {
-  return resolve43(homedir7(), ...segments);
+  return resolve44(homedir7(), ...segments);
 }
 function hermesHome() {
   const env = process.env.HERMES_HOME;
-  return env && env.length > 0 ? resolve43(env) : home(".hermes");
+  return env && env.length > 0 ? resolve44(env) : home(".hermes");
 }
 function hermesSkillsDir() {
-  return resolve43(hermesHome(), "skills");
+  return resolve44(hermesHome(), "skills");
 }
 function codexHome() {
   const env = process.env.CODEX_HOME;
-  return env && env.length > 0 ? resolve43(env) : home(".codex");
+  return env && env.length > 0 ? resolve44(env) : home(".codex");
 }
 function toDiscovered(meta) {
   if (!meta) return null;
@@ -11751,7 +11751,7 @@ var init_registry = __esm({
         skillsShAgentId: "codex",
         nativePlugin: "codex",
         detect: detectDir(codexHome()),
-        skillsDir: { global: resolve43(codexHome(), "skills") },
+        skillsDir: { global: resolve44(codexHome(), "skills") },
         instructions: { files: [{ path: "AGENTS.md", renderer: "codexAgents" }] },
         sessions: codexSessions
       },
@@ -11819,7 +11819,7 @@ var init_registry = __esm({
         tier3: {
           kind: "hermes-plugin",
           source: "platforms/hermes/plugins/syntaur",
-          installDir: () => resolve43(hermesHome(), "plugins", "syntaur"),
+          installDir: () => resolve44(hermesHome(), "plugins", "syntaur"),
           entry: "plugin.yaml"
         }
       }
@@ -11838,8 +11838,8 @@ __export(scanner_exports2, {
 import { execFile as execFile3, execFileSync as execFileSync4 } from "child_process";
 import { promisify as promisify3 } from "util";
 import { statSync as statSync4 } from "fs";
-import { readFile as readFile30 } from "fs/promises";
-import { resolve as resolve44 } from "path";
+import { readFile as readFile31 } from "fs/promises";
+import { resolve as resolve45 } from "path";
 function emptySummary() {
   return { discovered: 0, inserted: 0, revived: 0, swept: 0, skipped: 0, changed: false };
 }
@@ -11895,10 +11895,10 @@ async function defaultOpenFiles(files) {
 async function readContextLink(cwd, cache3) {
   if (cache3.has(cwd)) return cache3.get(cwd);
   let link = null;
-  const path = resolve44(cwd, ".syntaur", "context.json");
+  const path = resolve45(cwd, ".syntaur", "context.json");
   if (await fileExists(path)) {
     try {
-      const parsed = JSON.parse(await readFile30(path, "utf-8"));
+      const parsed = JSON.parse(await readFile31(path, "utf-8"));
       link = {
         projectSlug: typeof parsed.projectSlug === "string" ? parsed.projectSlug : null,
         assignmentSlug: typeof parsed.assignmentSlug === "string" ? parsed.assignmentSlug : null
@@ -12063,7 +12063,7 @@ init_assignment_resolver();
 init_agent_sessions();
 import express from "express";
 import { createServer } from "http";
-import { resolve as resolve45 } from "path";
+import { resolve as resolve46 } from "path";
 import { writeFile as writeFile8, unlink as unlink9 } from "fs/promises";
 import { WebSocketServer, WebSocket } from "ws";
 
@@ -17857,7 +17857,7 @@ async function executeLaunchPlan(plan, spawnFn = realSpawn) {
       `Spawn failed: ${msg}. Verify the terminal is installed and on PATH.`
     );
   }
-  await new Promise((resolve46, reject) => {
+  await new Promise((resolve47, reject) => {
     let settled = false;
     let stderr = "";
     const finishOk = () => {
@@ -17867,7 +17867,7 @@ async function executeLaunchPlan(plan, spawnFn = realSpawn) {
         child.unref();
       } catch {
       }
-      resolve46();
+      resolve47();
     };
     const finishErr = (remediation) => {
       if (settled) return;
@@ -20934,15 +20934,355 @@ function parseFilters(query) {
   return out;
 }
 
+// src/dashboard/api-inbox.ts
+import { Router as Router16 } from "express";
+
+// src/inbox/index.ts
+init_fs();
+init_assignment_walk();
+init_parser();
+init_facts();
+init_state_machine();
+import { resolve as resolve36 } from "path";
+import { readFile as readFile25 } from "fs/promises";
+
+// src/inbox/types.ts
+var INBOX_CATEGORIES = [
+  "review",
+  "blocked",
+  "question",
+  "plan-approval"
+];
+
+// src/inbox/index.ts
+function isReview(a) {
+  return a.status === "review";
+}
+function isBlocked(a) {
+  return a.status === "blocked";
+}
+function isUnresolvedQuestion(c) {
+  return c.type === "question" && c.resolved !== true;
+}
+function unresolvedQuestions(comments) {
+  return comments.filter(isUnresolvedQuestion);
+}
+async function isPlanAwaitingApproval(a, assignmentDir) {
+  if (a.status !== "ready_for_planning") return false;
+  const latest = await latestPlanFile(assignmentDir);
+  if (latest === null) return false;
+  const approved = await isPlanApproved(assignmentDir, { planApproval: a.planApproval });
+  return !approved;
+}
+function canonicalRfc3339(ms) {
+  return new Date(ms).toISOString().replace(/\.\d{3}Z$/, "Z");
+}
+function validTimestamp(value) {
+  if (typeof value !== "string") return null;
+  const t = value.trim();
+  if (t.length === 0) return null;
+  const ms = Date.parse(t);
+  return Number.isNaN(ms) ? null : canonicalRfc3339(ms);
+}
+function latestStatusHistoryAt(a) {
+  let best = null;
+  for (const e of a.statusHistory) {
+    const at = validTimestamp(e.at);
+    if (at === null) continue;
+    const ms = Date.parse(at);
+    if (best === null || ms >= best.ms) best = { at, ms };
+  }
+  return best?.at ?? null;
+}
+function latestStatusHistoryAtWhere(a, pred) {
+  let best = null;
+  for (const e of a.statusHistory) {
+    if (!pred(e)) continue;
+    const at = validTimestamp(e.at);
+    if (at === null) continue;
+    const ms = Date.parse(at);
+    if (best === null || ms >= best.ms) best = { at, ms };
+  }
+  return best?.at ?? null;
+}
+function resolveSince(category, a, now, comment) {
+  let primary = null;
+  switch (category) {
+    case "review":
+      primary = latestStatusHistoryAtWhere(a, (e) => e.to === "review");
+      break;
+    case "blocked":
+      primary = latestStatusHistoryAtWhere(a, (e) => e.dispositionTo === "blocked");
+      break;
+    case "question":
+      primary = validTimestamp(comment?.timestamp);
+      break;
+    case "plan-approval":
+      primary = latestStatusHistoryAt(a);
+      break;
+  }
+  return primary ?? latestStatusHistoryAt(a) ?? validTimestamp(a.updated) ?? validTimestamp(a.created) ?? canonicalRfc3339(now);
+}
+function computeAgeMs(since, now) {
+  const ms = Date.parse(since);
+  if (Number.isNaN(ms)) return 0;
+  return Math.max(0, now - ms);
+}
+var KNOWN_TRANSITION_CLI_VERBS = /* @__PURE__ */ new Set([
+  "start",
+  "complete",
+  "fail",
+  "reopen",
+  "block",
+  "unblock",
+  "review"
+]);
+function deriveReviewVerbs(config) {
+  const candidates = /* @__PURE__ */ new Set();
+  for (const t of config.transitions) {
+    if (t.from === "review") candidates.add(t.command);
+  }
+  for (const key of config.transitionTable.keys()) {
+    if (key.startsWith("review:")) candidates.add(key.slice("review:".length));
+  }
+  const blockedParked = config.blockedParkedStatuses ?? /* @__PURE__ */ new Set();
+  const terminalAccept = [];
+  const activeReopen = [];
+  for (const command of candidates) {
+    const target = getTargetStatus("review", command, config.transitionTable);
+    if (target === null) continue;
+    const isTerminal = config.terminalStatuses.has(target);
+    if (isTerminal && command !== "fail" && KNOWN_TRANSITION_CLI_VERBS.has(command)) {
+      terminalAccept.push(command);
+    }
+    if (!isTerminal && !blockedParked.has(target) && (command === "start" || command === "reopen")) {
+      activeReopen.push(command);
+    }
+  }
+  const accept = terminalAccept.find((c) => c === "complete") ?? terminalAccept[0] ?? null;
+  const reopen = activeReopen.find((c) => c === "start") ?? activeReopen.find((c) => c === "reopen") ?? null;
+  return { accept, reopen };
+}
+function targetAndProject(item) {
+  if (item.project === null) {
+    return { target: item.assignmentId, projectFlag: "" };
+  }
+  return { target: item.assignmentSlug, projectFlag: ` --project ${item.project}` };
+}
+function buildAction(category, item, ctx) {
+  const { target, projectFlag } = targetAndProject(item);
+  switch (category) {
+    case "review":
+      if (ctx.acceptCommand) {
+        return {
+          verb: "Accept",
+          command: `syntaur ${ctx.acceptCommand} ${target}${projectFlag}`
+        };
+      }
+      if (ctx.reopenCommand) {
+        return {
+          verb: "Reopen",
+          command: `syntaur ${ctx.reopenCommand} ${target}${projectFlag}`
+        };
+      }
+      return {
+        verb: "Review",
+        command: `syntaur timeline ${target}${projectFlag}`
+      };
+    case "blocked":
+      return {
+        verb: "Unblock",
+        command: `syntaur unblock ${target}${projectFlag}`
+      };
+    case "question":
+      return {
+        verb: "Answer",
+        command: `syntaur comment ${target} "<answer>" --reply-to ${ctx.commentId ?? ""}${projectFlag}`
+      };
+    case "plan-approval":
+      return {
+        verb: "Approve plan",
+        command: `syntaur plan approve ${target}${projectFlag}`
+      };
+  }
+}
+function orderByUrgency(items) {
+  return [...items].sort((x, y) => y.ageMs - x.ageMs);
+}
+function summarizeQuestion(c) {
+  const body = c.body.replace(/\s+/g, " ").trim();
+  const clipped = body.length > 140 ? `${body.slice(0, 137)}...` : body;
+  return clipped.length > 0 ? clipped : "(empty question)";
+}
+async function computeInbox(opts) {
+  const now = opts.now ?? Date.now();
+  const typeFilter = opts.types && opts.types.length > 0 ? new Set(opts.types) : null;
+  const reviewVerbs = deriveReviewVerbs(opts.statusConfig);
+  const walk = await listAssignmentsByProject(opts.projectsDir, opts.assignmentsDir);
+  const matched = [];
+  for (const entry of walk.withAssignmentMd) {
+    if (opts.project !== void 0 && entry.projectSlug !== opts.project) continue;
+    let parsed;
+    try {
+      const content = await readFile25(resolve36(entry.assignmentDir, "assignment.md"), "utf-8");
+      parsed = parseAssignmentFull(content);
+    } catch {
+      continue;
+    }
+    if (parsed.archived) continue;
+    if (parsed.disposition === "parked" || parsed.disposition === "terminal") continue;
+    if (opts.statusConfig.terminalStatuses.has(parsed.status)) continue;
+    const project = entry.projectSlug;
+    const assignmentSlug = entry.assignmentSlug;
+    const assignmentId = parsed.id;
+    const title = parsed.title;
+    const baseItem = { project, assignmentSlug, assignmentId };
+    if ((!typeFilter || typeFilter.has("review")) && isReview(parsed)) {
+      const since = resolveSince("review", parsed, now);
+      matched.push({
+        ...baseItem,
+        title,
+        category: "review",
+        since,
+        ageMs: computeAgeMs(since, now),
+        summary: parsed.reviewRequested ? "Review requested \u2014 awaiting accept or reopen." : "Awaiting review \u2014 accept or reopen.",
+        acceptCommand: reviewVerbs.accept,
+        reopenCommand: reviewVerbs.reopen,
+        action: buildAction("review", baseItem, {
+          acceptCommand: reviewVerbs.accept,
+          reopenCommand: reviewVerbs.reopen
+        })
+      });
+    }
+    if ((!typeFilter || typeFilter.has("blocked")) && isBlocked(parsed)) {
+      const since = resolveSince("blocked", parsed, now);
+      matched.push({
+        ...baseItem,
+        title,
+        category: "blocked",
+        since,
+        ageMs: computeAgeMs(since, now),
+        summary: parsed.blockedReason ? `Blocked: ${parsed.blockedReason}` : "Blocked \u2014 awaiting unblock.",
+        action: buildAction("blocked", baseItem, {})
+      });
+    }
+    if (!typeFilter || typeFilter.has("question")) {
+      const commentsPath = resolve36(entry.assignmentDir, "comments.md");
+      if (await fileExists(commentsPath)) {
+        try {
+          const content = await readFile25(commentsPath, "utf-8");
+          const parsedComments = parseComments(content);
+          for (const c of unresolvedQuestions(parsedComments.entries)) {
+            const since = resolveSince("question", parsed, now, c);
+            matched.push({
+              ...baseItem,
+              title,
+              category: "question",
+              since,
+              ageMs: computeAgeMs(since, now),
+              summary: summarizeQuestion(c),
+              commentId: c.id,
+              action: buildAction("question", baseItem, {
+                commentId: c.id
+              })
+            });
+          }
+        } catch {
+        }
+      }
+    }
+    if (!typeFilter || typeFilter.has("plan-approval")) {
+      if (await isPlanAwaitingApproval(parsed, entry.assignmentDir)) {
+        const since = resolveSince("plan-approval", parsed, now);
+        matched.push({
+          ...baseItem,
+          title,
+          category: "plan-approval",
+          since,
+          ageMs: computeAgeMs(since, now),
+          summary: "Plan awaiting approval.",
+          action: buildAction("plan-approval", baseItem, {})
+        });
+      }
+    }
+  }
+  const counts = {
+    review: 0,
+    blocked: 0,
+    question: 0,
+    "plan-approval": 0
+  };
+  for (const item of matched) counts[item.category]++;
+  const total = matched.length;
+  const ordered = [];
+  for (const category of INBOX_CATEGORIES) {
+    ordered.push(...orderByUrgency(matched.filter((i) => i.category === category)));
+  }
+  const items = opts.limit !== void 0 && opts.limit >= 0 ? ordered.slice(0, opts.limit) : ordered;
+  return { items, counts, total };
+}
+
+// src/dashboard/api-inbox.ts
+init_api();
+init_config2();
+function createInboxRouter(projectsDir, assignmentsDir2) {
+  const router = Router16();
+  router.get("/inbox", async (req2, res) => {
+    try {
+      const project = typeof req2.query.project === "string" && req2.query.project.length > 0 ? req2.query.project : void 0;
+      let types;
+      if (typeof req2.query.type === "string" && req2.query.type.length > 0) {
+        const raw2 = req2.query.type.split(",").map((t) => t.trim()).filter(Boolean);
+        const unknown = raw2.filter((t) => !INBOX_CATEGORIES.includes(t));
+        if (unknown.length > 0) {
+          res.status(400).json({
+            error: `Unknown inbox type(s): ${unknown.map((u) => JSON.stringify(u)).join(", ")}. Valid types: ${INBOX_CATEGORIES.join(", ")}.`
+          });
+          return;
+        }
+        types = raw2;
+      }
+      let limit;
+      if (typeof req2.query.limit === "string") {
+        const n = Number(req2.query.limit);
+        if (Number.isInteger(n) && n > 0) limit = n;
+      }
+      const resolved = await getStatusConfig();
+      const headline = (resolved.derive ?? DEFAULT_DERIVE_CONFIG).headline;
+      const blockedParkedStatuses = new Set(
+        [headline.blocked, headline.parked].filter(Boolean)
+      );
+      const statusConfig = { ...resolved, blockedParkedStatuses };
+      const result = await computeInbox({
+        projectsDir,
+        assignmentsDir: assignmentsDir2,
+        project,
+        types,
+        limit,
+        statusConfig
+      });
+      res.json(result);
+    } catch (error) {
+      console.warn("[inbox] failed to compute inbox:", error);
+      res.json({
+        items: [],
+        counts: { review: 0, blocked: 0, question: 0, "plan-approval": 0 },
+        total: 0
+      });
+    }
+  });
+  return router;
+}
+
 // src/dashboard/api-playbooks.ts
 init_api();
 init_parser();
 init_slug();
 init_timestamp();
 init_fs();
-import { Router as Router16 } from "express";
-import { resolve as resolve36 } from "path";
-import { readFile as readFile25 } from "fs/promises";
+import { Router as Router17 } from "express";
+import { resolve as resolve37 } from "path";
+import { readFile as readFile26 } from "fs/promises";
 init_playbooks();
 function statusForPlaybookError(code) {
   switch (code) {
@@ -20957,7 +21297,7 @@ function statusForPlaybookError(code) {
   }
 }
 function createPlaybooksRouter(playbooksDir2) {
-  const router = Router16();
+  const router = Router17();
   router.get("/", async (_req, res) => {
     try {
       const playbooks = await listPlaybooks(playbooksDir2);
@@ -21024,8 +21364,8 @@ function createPlaybooksRouter(playbooksDir2) {
         res.status(404).json({ error: `Playbook "${req2.params.slug}" not found` });
         return;
       }
-      const filePath = resolve36(playbooksDir2, resolved.filename);
-      const content = await readFile25(filePath, "utf-8");
+      const filePath = resolve37(playbooksDir2, resolved.filename);
+      const content = await readFile26(filePath, "utf-8");
       res.json({
         documentType: "playbook",
         title: `Edit Playbook: ${resolved.slug}`,
@@ -21050,7 +21390,7 @@ function createPlaybooksRouter(playbooksDir2) {
         return;
       }
       await ensureDir(playbooksDir2);
-      const filePath = resolve36(playbooksDir2, `${slug}.md`);
+      const filePath = resolve37(playbooksDir2, `${slug}.md`);
       if (await fileExists(filePath)) {
         res.status(409).json({ error: `Playbook "${slug}" already exists` });
         return;
@@ -21074,7 +21414,7 @@ function createPlaybooksRouter(playbooksDir2) {
         res.status(404).json({ error: `Playbook "${req2.params.slug}" not found` });
         return;
       }
-      const filePath = resolve36(playbooksDir2, resolved.filename);
+      const filePath = resolve37(playbooksDir2, resolved.filename);
       await writeFileForce(filePath, content);
       await rebuildPlaybookManifest(playbooksDir2);
       res.json({ slug: resolved.slug, path: filePath });
@@ -21121,7 +21461,7 @@ init_fs_migration();
 init_parser2();
 init_fs();
 init_paths();
-import { Router as Router18 } from "express";
+import { Router as Router19 } from "express";
 import { readdir as readdir16 } from "fs/promises";
 import { resolve as resolvePath, dirname as dirname10 } from "path";
 import { rename as rename6, mkdir as mkdir5 } from "fs/promises";
@@ -21137,7 +21477,7 @@ init_uuid();
 init_paths();
 init_fs();
 init_config2();
-import { resolve as resolve37 } from "path";
+import { resolve as resolve38 } from "path";
 async function createAssignmentCommand(title, options) {
   if (!title.trim()) {
     throw new Error("Assignment title cannot be empty.");
@@ -21212,14 +21552,14 @@ async function createAssignmentCommand(title, options) {
   if (options.oneOff) {
     const standaloneRoot = assignmentsDir();
     folderName = id;
-    assignmentDir = resolve37(standaloneRoot, folderName);
+    assignmentDir = resolve38(standaloneRoot, folderName);
     projectSlug = null;
     await ensureDir(standaloneRoot);
   } else {
     const baseDir = options.dir ? expandHome(options.dir) : config.defaultProjectDir;
     projectSlug = options.project;
-    const projectDir = resolve37(baseDir, projectSlug);
-    const projectMdPath = resolve37(projectDir, "project.md");
+    const projectDir = resolve38(baseDir, projectSlug);
+    const projectMdPath = resolve38(projectDir, "project.md");
     if (!await fileExists(projectDir) || !await fileExists(projectMdPath)) {
       throw new Error(
         `Project "${projectSlug}" not found at ${projectDir}.
@@ -21227,9 +21567,9 @@ Run 'syntaur create-project' first or use --one-off.`
       );
     }
     if (dependsOn.length > 0) {
-      const depDirBase = resolve37(projectDir, "assignments");
+      const depDirBase = resolve38(projectDir, "assignments");
       for (const dep of dependsOn) {
-        const depDir = resolve37(depDirBase, dep);
+        const depDir = resolve38(depDirBase, dep);
         if (!await fileExists(depDir)) {
           console.warn(
             `Warning: dependency "${dep}" does not exist in project "${projectSlug}" yet.`
@@ -21238,7 +21578,7 @@ Run 'syntaur create-project' first or use --one-off.`
       }
     }
     folderName = assignmentSlug;
-    assignmentDir = resolve37(projectDir, "assignments", folderName);
+    assignmentDir = resolve38(projectDir, "assignments", folderName);
   }
   if (await fileExists(assignmentDir)) {
     throw new Error(
@@ -21250,7 +21590,7 @@ Use --slug to specify a different slug.`
   const companionAssignmentRef = projectSlug === null ? id : assignmentSlug;
   const files = [
     [
-      resolve37(assignmentDir, "assignment.md"),
+      resolve38(assignmentDir, "assignment.md"),
       renderAssignment({
         id,
         slug: assignmentSlug,
@@ -21268,35 +21608,35 @@ Use --slug to specify a different slug.`
       })
     ],
     [
-      resolve37(assignmentDir, "scratchpad.md"),
+      resolve38(assignmentDir, "scratchpad.md"),
       renderScratchpad({
         assignmentSlug: companionAssignmentRef,
         timestamp
       })
     ],
     [
-      resolve37(assignmentDir, "handoff.md"),
+      resolve38(assignmentDir, "handoff.md"),
       renderHandoff({
         assignmentSlug: companionAssignmentRef,
         timestamp
       })
     ],
     [
-      resolve37(assignmentDir, "decision-record.md"),
+      resolve38(assignmentDir, "decision-record.md"),
       renderDecisionRecord({
         assignmentSlug: companionAssignmentRef,
         timestamp
       })
     ],
     [
-      resolve37(assignmentDir, "progress.md"),
+      resolve38(assignmentDir, "progress.md"),
       renderProgress({
         assignment: companionAssignmentRef,
         timestamp
       })
     ],
     [
-      resolve37(assignmentDir, "comments.md"),
+      resolve38(assignmentDir, "comments.md"),
       renderComments({
         assignment: companionAssignmentRef,
         timestamp
@@ -21470,7 +21810,7 @@ import { raw } from "express";
 
 // src/todos/attachments.ts
 import { mkdir as mkdir4, readdir as readdir15, stat as stat5, rename as rename5, rm as rm4, unlink as unlink7, writeFile as writeFile6, cp } from "fs/promises";
-import { resolve as resolve38, basename as basename5, dirname as dirname9, extname } from "path";
+import { resolve as resolve39, basename as basename5, dirname as dirname9, extname } from "path";
 
 // src/utils/proof-artifact-id.ts
 import { randomBytes as randomBytes2 } from "crypto";
@@ -21557,12 +21897,12 @@ function sanitizeAttachmentName(name) {
   return n;
 }
 function attachmentsRootDir(todosDir2) {
-  return resolve38(todosDir2, "attachments");
+  return resolve39(todosDir2, "attachments");
 }
 function attachmentDirFor(todosDir2, scopeId, todoId) {
   assertScope(scopeId);
   assertTodoId(todoId);
-  return resolve38(attachmentsRootDir(todosDir2), scopeId, todoId);
+  return resolve39(attachmentsRootDir(todosDir2), scopeId, todoId);
 }
 async function dirExists(p) {
   try {
@@ -21576,7 +21916,7 @@ async function writeAttachment(todosDir2, scopeId, todoId, originalName, bytes)
   await mkdir4(dir, { recursive: true });
   const id = generateArtifactId();
   const filename = sanitizeAttachmentName(originalName);
-  await writeFile6(resolve38(dir, `${id}__${filename}`), bytes);
+  await writeFile6(resolve39(dir, `${id}__${filename}`), bytes);
   return {
     id,
     filename,
@@ -21601,7 +21941,7 @@ async function listAttachments(todosDir2, scopeId, todoId) {
     if (!ATTACHMENT_ID_RE.test(id)) continue;
     const filename = stored.slice(sep2 + 2);
     try {
-      const st = await stat5(resolve38(dir, stored));
+      const st = await stat5(resolve39(dir, stored));
       if (!st.isFile()) continue;
       out.push({ id, filename, mime: mimeForName(filename), size: st.size, createdAt: st.mtime.toISOString() });
     } catch {
@@ -21612,7 +21952,7 @@ async function listAttachments(todosDir2, scopeId, todoId) {
 }
 async function readScopeAttachments(todosDir2, scopeId) {
   assertScope(scopeId);
-  const scopeDir = resolve38(attachmentsRootDir(todosDir2), scopeId);
+  const scopeDir = resolve39(attachmentsRootDir(todosDir2), scopeId);
   let todoIds;
   try {
     todoIds = await readdir15(scopeDir);
@@ -21640,7 +21980,7 @@ async function resolveAttachmentFile(todosDir2, scopeId, todoId, attachmentId) {
   const stored = names.find((n) => n.startsWith(prefix));
   if (!stored) return null;
   const filename = stored.slice(prefix.length);
-  return { path: resolve38(dir, stored), filename, mime: mimeForName(filename) };
+  return { path: resolve39(dir, stored), filename, mime: mimeForName(filename) };
 }
 async function deleteAttachment(todosDir2, scopeId, todoId, attachmentId) {
   const resolved = await resolveAttachmentFile(todosDir2, scopeId, todoId, attachmentId);
@@ -21802,7 +22142,7 @@ function touchItem3(item) {
   item.updatedAt = now;
 }
 function createTodosRouter(todosDir2, broadcast, projectsDir) {
-  const router = Router18();
+  const router = Router19();
   installRecordsInvalidation(router);
   function broadcastUpdate() {
     broadcast({ type: "todos-updated", timestamp: (/* @__PURE__ */ new Date()).toISOString() });
@@ -22052,8 +22392,8 @@ function createTodosRouter(todosDir2, broadcast, projectsDir) {
   router.post("/:workspace/archive", async (req2, res) => {
     try {
       const { archivePath: archivePath2 } = await Promise.resolve().then(() => (init_parser2(), parser_exports));
-      const { resolve: resolve46 } = await import("path");
-      const { readFile: readFile31 } = await import("fs/promises");
+      const { resolve: resolve47 } = await import("path");
+      const { readFile: readFile32 } = await import("fs/promises");
       const { writeFileForce: writeFileForce2 } = await Promise.resolve().then(() => (init_fs(), fs_exports));
       const workspace = getWorkspaceParam(req2.params.workspace);
       const outcome = await wsLock(workspace, async () => {
@@ -22069,10 +22409,10 @@ function createTodosRouter(todosDir2, broadcast, projectsDir) {
           (e) => e.itemIds.every((id) => completedIds.has(id))
         );
         const archFile = archivePath2(todosDir2, workspace, checklist.archiveInterval);
-        await ensureDir(resolve46(todosDir2, "archive"));
+        await ensureDir(resolve47(todosDir2, "archive"));
         let archContent = "";
         if (await fileExists(archFile)) {
-          archContent = await readFile31(archFile, "utf-8");
+          archContent = await readFile32(archFile, "utf-8");
           archContent = archContent.trimEnd() + "\n\n";
         } else {
           archContent = `---
@@ -22364,7 +22704,7 @@ workspace: ${workspace}
         const { readConfig: readConfig2 } = await Promise.resolve().then(() => (init_config2(), config_exports));
         const { assignmentsDir: assignmentsDirFn } = await Promise.resolve().then(() => (init_paths(), paths_exports));
         const { fileExists: fileExists2, writeFileForce: writeFileForce2 } = await Promise.resolve().then(() => (init_fs(), fs_exports));
-        const { readFile: readFile31 } = await import("fs/promises");
+        const { readFile: readFile32 } = await import("fs/promises");
         const { appendTodosToAssignmentBody: appendTodosToAssignmentBody2, touchAssignmentUpdated: touchAssignmentUpdated2 } = await Promise.resolve().then(() => (init_assignment_todos(), assignment_todos_exports));
         const { nowTimestamp: nowTimestamp3 } = await Promise.resolve().then(() => (init_timestamp(), timestamp_exports));
         let assignmentRef;
@@ -22385,7 +22725,7 @@ workspace: ${workspace}
         }
         const assignmentMdPath = resolvePath2(assignmentDir, "assignment.md");
         if (!await fileExists2(assignmentMdPath)) return { error: `Target assignment not found: ${assignmentMdPath}` };
-        let content = await readFile31(assignmentMdPath, "utf-8");
+        let content = await readFile32(assignmentMdPath, "utf-8");
         content = appendTodosToAssignmentBody2(
           content,
           items.map((it) => ({
@@ -22579,9 +22919,9 @@ init_parser2();
 init_fs();
 init_paths();
 init_slug();
-import { Router as Router19 } from "express";
-import { mkdir as mkdir6, readFile as readFile26, rename as rename7 } from "fs/promises";
-import { resolve as resolve39, dirname as dirname11 } from "path";
+import { Router as Router20 } from "express";
+import { mkdir as mkdir6, readFile as readFile27, rename as rename7 } from "fs/promises";
+import { resolve as resolve40, dirname as dirname11 } from "path";
 init_api();
 var WORKSPACE_REGEX2 = /^[a-z0-9_][a-z0-9-]*$/;
 function touchItem4(item) {
@@ -22597,7 +22937,7 @@ function params(req2) {
   return req2.params;
 }
 async function projectExists(projectsDir, slug) {
-  return fileExists(resolve39(projectsDir, slug, "project.md"));
+  return fileExists(resolve40(projectsDir, slug, "project.md"));
 }
 async function ensureProjectTodosDir(projectsDir, slug) {
   const todosDir2 = projectTodosDir(projectsDir, slug);
@@ -22614,7 +22954,7 @@ async function ensureProjectTodosDir(projectsDir, slug) {
     throw err;
   }
   try {
-    await mkdir6(resolve39(todosDir2, "archive"), { recursive: false });
+    await mkdir6(resolve40(todosDir2, "archive"), { recursive: false });
   } catch (err) {
     const code = err.code;
     if (code === "EEXIST") return;
@@ -22630,7 +22970,7 @@ function notFound(res, slug) {
   res.status(404).json({ error: `Project "${slug}" not found` });
 }
 function createProjectTodosRouter(projectsDir, broadcast, workspaceTodosDir) {
-  const router = Router19({ mergeParams: true });
+  const router = Router20({ mergeParams: true });
   installRecordsInvalidation(router);
   function broadcastUpdate(projectSlug) {
     broadcast({ type: "todos-updated", projectSlug, timestamp: (/* @__PURE__ */ new Date()).toISOString() });
@@ -22818,7 +23158,7 @@ function createProjectTodosRouter(projectsDir, broadcast, workspaceTodosDir) {
         const archFile = archivePath(todosDir2, slug, checklist.archiveInterval);
         let archContent = "";
         if (await fileExists(archFile)) {
-          archContent = await readFile26(archFile, "utf-8");
+          archContent = await readFile27(archFile, "utf-8");
           archContent = archContent.trimEnd() + "\n\n";
         } else {
           archContent = `---
@@ -23280,17 +23620,17 @@ workspace: ${slug}
         if (tg.includes("/")) {
           const parts = tg.split("/");
           if (parts.length !== 2) return { error: `Invalid target.assignment "${tg}"` };
-          assignmentDir = resolve39(projectsDir, parts[0], "assignments", parts[1]);
+          assignmentDir = resolve40(projectsDir, parts[0], "assignments", parts[1]);
           assignmentRef = `${parts[0]}/${parts[1]}`;
         } else if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(tg)) {
-          assignmentDir = resolve39(assignmentsDirFn(), tg);
+          assignmentDir = resolve40(assignmentsDirFn(), tg);
           assignmentRef = tg;
         } else {
           return { error: `Invalid target.assignment "${tg}"` };
         }
-        const assignmentMdPath = resolve39(assignmentDir, "assignment.md");
+        const assignmentMdPath = resolve40(assignmentDir, "assignment.md");
         if (!await fileExists(assignmentMdPath)) return { error: `Target assignment not found: ${assignmentMdPath}` };
-        let content = await readFile26(assignmentMdPath, "utf-8");
+        let content = await readFile27(assignmentMdPath, "utf-8");
         content = appendTodosToAssignmentBody2(
           content,
           items.map((it) => ({
@@ -23492,7 +23832,7 @@ workspace: ${slug}
 }
 
 // src/dashboard/api-bundles.ts
-import { Router as Router20 } from "express";
+import { Router as Router21 } from "express";
 import { readdir as readdir17 } from "fs/promises";
 
 // src/todos/bundle-parser.ts
@@ -23501,7 +23841,7 @@ init_fs();
 init_paths();
 init_parser2();
 import { randomBytes as randomBytes3 } from "crypto";
-import { readFile as readFile27 } from "fs/promises";
+import { readFile as readFile28 } 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_-]*$/;
@@ -23568,7 +23908,7 @@ function parseBundles(content) {
 async function readBundles(todosDir2) {
   const path = bundlesPath(todosDir2);
   if (!await fileExists(path)) return [];
-  const content = await readFile27(path, "utf-8");
+  const content = await readFile28(path, "utf-8");
   return parseBundles(content).bundles;
 }
 
@@ -23603,7 +23943,7 @@ function annotate(bundle, items) {
 }
 function createBundlesRouter(todosDir2, broadcast) {
   void broadcast;
-  const router = Router20();
+  const router = Router21();
   function validateWorkspace(req2, res, next) {
     const workspace = getWorkspaceParam2(req2.params.workspace);
     if (workspace && !WORKSPACE_REGEX3.test(workspace)) {
@@ -23669,8 +24009,8 @@ function createBundlesRouter(todosDir2, broadcast) {
 init_fs();
 init_paths();
 init_slug();
-import { Router as Router21 } from "express";
-import { resolve as resolve40 } from "path";
+import { Router as Router22 } from "express";
+import { resolve as resolve41 } from "path";
 init_parser2();
 function deriveStatus2(bundle, items) {
   const members = bundle.todoIds.map((id) => items.find((i) => i.id === id)).filter((i) => i !== void 0);
@@ -23699,7 +24039,7 @@ function notFound2(res, slug) {
 }
 function createProjectBundlesRouter(projectsDir, broadcast) {
   void broadcast;
-  const router = Router21({ mergeParams: true });
+  const router = Router22({ mergeParams: true });
   function validateProjectId(req2, res, next) {
     const slug = getProjectIdParam2(req2.params.projectId);
     if (!slug || !isValidSlug(slug)) {
@@ -23712,7 +24052,7 @@ function createProjectBundlesRouter(projectsDir, broadcast) {
   router.get("/", async (req2, res) => {
     try {
       const slug = getProjectIdParam2(req2.params.projectId);
-      const projectMd = resolve40(projectsDir, slug, "project.md");
+      const projectMd = resolve41(projectsDir, slug, "project.md");
       if (!await fileExists(projectMd)) {
         notFound2(res, slug);
         return;
@@ -23733,7 +24073,7 @@ function createProjectBundlesRouter(projectsDir, broadcast) {
 init_config2();
 init_api();
 init_scanner();
-import { Router as Router22 } from "express";
+import { Router as Router23 } from "express";
 
 // src/utils/github-backup.ts
 init_paths();
@@ -23741,8 +24081,8 @@ init_fs();
 init_config2();
 import { execFile as execFile2 } from "child_process";
 import { promisify as promisify2 } from "util";
-import { cp as cp2, mkdtemp, rm as rm5, readFile as readFile28, writeFile as writeFile7, unlink as unlink8, stat as stat6, open as open5, rename as rename8 } from "fs/promises";
-import { resolve as resolve41, join as join9 } from "path";
+import { cp as cp2, mkdtemp, rm as rm5, readFile as readFile29, writeFile as writeFile7, unlink as unlink8, stat as stat6, open as open5, rename as rename8 } from "fs/promises";
+import { resolve as resolve42, join as join9 } from "path";
 import { tmpdir } from "os";
 var exec2 = promisify2(execFile2);
 var VALID_CATEGORIES = ["projects", "playbooks", "todos", "servers", "config"];
@@ -23782,7 +24122,7 @@ async function resolveCategoryPath(category) {
     case "servers":
       return { sourcePath: serversDir(), repoPath: "servers", isFile: false };
     case "config":
-      return { sourcePath: resolve41(syntaurRoot(), "config.md"), repoPath: "config.md", isFile: true };
+      return { sourcePath: resolve42(syntaurRoot(), "config.md"), repoPath: "config.md", isFile: true };
   }
 }
 async function checkGitInstalled() {
@@ -23793,7 +24133,7 @@ async function checkGitInstalled() {
   }
 }
 async function acquireLock2() {
-  const lockPath = resolve41(syntaurRoot(), LOCK_FILE_NAME);
+  const lockPath = resolve42(syntaurRoot(), LOCK_FILE_NAME);
   await ensureDir(syntaurRoot());
   try {
     const handle = await open5(lockPath, "wx");
@@ -23802,7 +24142,7 @@ async function acquireLock2() {
     return lockPath;
   } catch (err) {
     if (err.code === "EEXIST") {
-      const pid = await readFile28(lockPath, "utf-8").catch(() => "");
+      const pid = await readFile29(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.`
       );
@@ -23840,7 +24180,7 @@ async function copyRecursive(src, dest) {
     await ensureDir(dest);
     await cp2(src, dest, { recursive: true, force: true });
   } else {
-    await ensureDir(resolve41(dest, ".."));
+    await ensureDir(resolve42(dest, ".."));
     await cp2(src, dest, { force: true });
   }
 }
@@ -23849,7 +24189,7 @@ function resolveCategoriesStrict(csv) {
   return parseCategoriesStrict(parts);
 }
 async function readSanitizedConfig(configPath) {
-  const content = await readFile28(configPath, "utf-8");
+  const content = await readFile29(configPath, "utf-8");
   return content.replace(/^(\s*lastBackup:\s*).*$/m, "$1null").replace(/^(\s*lastRestore:\s*).*$/m, "$1null");
 }
 async function backupToGithub(overrides) {
@@ -23888,7 +24228,7 @@ async function backupToGithub(overrides) {
       }
       if (category === "config") {
         const sanitized = await readSanitizedConfig(sourcePath);
-        await ensureDir(resolve41(destPath, ".."));
+        await ensureDir(resolve42(destPath, ".."));
         await writeFile7(destPath, sanitized, "utf-8");
       } else {
         await copyRecursive(sourcePath, destPath);
@@ -23942,7 +24282,7 @@ async function backupToGithub(overrides) {
 }
 async function safeRestoreCategory(localPath, repoSrcPath, isFile) {
   if (isFile) {
-    await ensureDir(resolve41(localPath, ".."));
+    await ensureDir(resolve42(localPath, ".."));
     await cp2(repoSrcPath, localPath, { force: true });
     return;
   }
@@ -24043,7 +24383,7 @@ async function restoreFromGithub(overrides) {
 }
 async function getBackupStatus() {
   const config = await readConfig();
-  const lockPath = resolve41(syntaurRoot(), LOCK_FILE_NAME);
+  const lockPath = resolve42(syntaurRoot(), LOCK_FILE_NAME);
   const locked = await fileExists(lockPath);
   return {
     repo: config.backup?.repo ?? null,
@@ -24056,7 +24396,7 @@ async function getBackupStatus() {
 
 // src/dashboard/api-backup.ts
 function createBackupRouter() {
-  const router = Router22();
+  const router = Router23();
   router.get("/", async (_req, res) => {
     try {
       const status = await getBackupStatus();
@@ -24526,7 +24866,7 @@ async function runCcusage(opts = {}) {
   };
 }
 function runOnce(binary, args, env, timeoutMs, maxOutputBytes) {
-  return new Promise((resolve46) => {
+  return new Promise((resolve47) => {
     const child = spawn4(binary, args, {
       env: env ?? process.env,
       stdio: ["ignore", "pipe", "pipe"]
@@ -24540,7 +24880,7 @@ function runOnce(binary, args, env, timeoutMs, maxOutputBytes) {
       if (settled) return;
       settled = true;
       clearTimeout(timer3);
-      resolve46(result);
+      resolve47(result);
     };
     const timer3 = setTimeout(() => {
       timedOut = true;
@@ -24839,7 +25179,7 @@ function createDashboardServer(options) {
   (async () => {
     try {
       const configResult = await migrateLegacyConfig(
-        resolve45(syntaurRoot(), "config.md")
+        resolve46(syntaurRoot(), "config.md")
       );
       const projectResult = await migrateLegacyProjectFiles(projectsDir);
       const summary = summarizeMigration(projectResult, configResult);
@@ -25329,6 +25669,7 @@ function createDashboardServer(options) {
   app.use("/api/schedules", createSchedulesRouter(broadcast));
   app.use("/api/usage", createUsageRouter(projectsDir, assignmentsDir2));
   app.use("/api", createEventsRouter(projectsDir, assignmentsDir2));
+  app.use("/api", createInboxRouter(projectsDir, assignmentsDir2));
   app.use("/api/agent-sessions", createAgentSessionsRouter(projectsDir, broadcast, assignmentsDir2));
   app.use("/api/config/agents", createAgentsRouter());
   app.use(
@@ -25361,14 +25702,14 @@ function createDashboardServer(options) {
   app.use("/api/backup", createBackupRouter());
   if (serveStaticUi && dashboardDistPath) {
     const sendOpts = { dotfiles: "allow" };
-    app.use("/assets", express.static(resolve45(dashboardDistPath, "assets"), sendOpts));
+    app.use("/assets", express.static(resolve46(dashboardDistPath, "assets"), sendOpts));
     app.use(express.static(dashboardDistPath, { ...sendOpts, index: false, fallthrough: true }));
     app.get("{*path}", async (req2, res) => {
       if (req2.path.startsWith("/api") || req2.path === "/ws" || req2.path.startsWith("/assets")) {
         res.status(404).json({ error: "Not Found" });
         return;
       }
-      const indexPath = resolve45(dashboardDistPath, "index.html");
+      const indexPath = resolve46(dashboardDistPath, "index.html");
       if (!await fileExists(indexPath)) {
         res.status(503).send(
           'Dashboard not built. Run "npm run build:dashboard" first.'
@@ -25402,8 +25743,8 @@ function createDashboardServer(options) {
         if (!await migrationGate()) return;
         try {
           const context = await resolveDeriveContext2();
-          const projectDir = projectSlug ? resolve45(projectsDir, projectSlug) : null;
-          const path = projectDir ? resolve45(projectDir, "assignments", assignmentSlug, "assignment.md") : resolve45(assignmentsDir2, assignmentSlug, "assignment.md");
+          const projectDir = projectSlug ? resolve46(projectsDir, projectSlug) : null;
+          const path = projectDir ? resolve46(projectDir, "assignments", assignmentSlug, "assignment.md") : resolve46(assignmentsDir2, assignmentSlug, "assignment.md");
           if (!await fileExists(path)) return;
           const result = await recomputeAndWrite2(path, {
             cause: "derive",
@@ -25456,8 +25797,8 @@ function createDashboardServer(options) {
         serversDir: serversDir2,
         playbooksDir: playbooksDir2,
         todosDir: todosDir2,
-        dbPath: resolve45(syntaurRoot(), "syntaur.db"),
-        configPath: resolve45(syntaurRoot(), "config.md"),
+        dbPath: resolve46(syntaurRoot(), "syntaur.db"),
+        configPath: resolve46(syntaurRoot(), "config.md"),
         onMessage: broadcast,
         onAssignmentChanged: (projectSlug, assignmentSlug) => {
           void recomputeOne(projectSlug, assignmentSlug);
@@ -25493,7 +25834,7 @@ function createDashboardServer(options) {
           }
         });
         server.listen(port, () => {
-          const portFile = resolve45(syntaurRoot(), "dashboard-port");
+          const portFile = resolve46(syntaurRoot(), "dashboard-port");
           writeFile8(portFile, String(port), "utf-8").catch(() => {
           });
           resolvePromise();
@@ -25513,7 +25854,7 @@ function createDashboardServer(options) {
         client.terminate();
       }
       clients.clear();
-      const portFile = resolve45(syntaurRoot(), "dashboard-port");
+      const portFile = resolve46(syntaurRoot(), "dashboard-port");
       await unlink9(portFile).catch(() => {
       });
       server.closeAllConnections?.();