syntaur 0.67.0 → 0.69.0

package/dist/dashboard/server.js

@@ -937,6 +937,38 @@ CREATE TABLE IF NOT EXISTS meta (key TEXT PRIMARY KEY, value TEXT);
 });
 
 // src/lifecycle/event-emit.ts
+var event_emit_exports = {};
+__export(event_emit_exports, {
+  emitEvent: () => emitEvent,
+  isSuppressingEvents: () => isSuppressingEvents,
+  recordStatusEvent: () => recordStatusEvent,
+  resolveActor: () => resolveActor,
+  setSuppressEvents: () => setSuppressEvents,
+  withSuppressedEvents: () => withSuppressedEvents
+});
+function setSuppressEvents(value) {
+  suppressEvents = value;
+}
+function isSuppressingEvents() {
+  return suppressEvents;
+}
+function withSuppressedEvents(fn) {
+  const prior = suppressEvents;
+  suppressEvents = true;
+  try {
+    const result = fn();
+    if (result instanceof Promise) {
+      return result.finally(() => {
+        suppressEvents = prior;
+      });
+    }
+    suppressEvents = prior;
+    return result;
+  } catch (e) {
+    suppressEvents = prior;
+    throw e;
+  }
+}
 function resolveActor(by) {
   return by ?? "system";
 }
@@ -952,6 +984,10 @@ function recordStatusEvent(input) {
     details: { from: input.from, to: input.to, command: input.command }
   });
 }
+function emitEvent(input) {
+  if (suppressEvents) return;
+  recordEvent(input);
+}
 var suppressEvents;
 var init_event_emit = __esm({
   "src/lifecycle/event-emit.ts"() {
@@ -3764,7 +3800,9 @@ __export(config_exports, {
   getTerminal: () => getTerminal,
   normalizeFactDeclarations: () => normalizeFactDeclarations,
   parseAgentCommand: () => parseAgentCommand,
+  parseDurationMs: () => parseDurationMs,
   parseSearchConfig: () => parseSearchConfig,
+  parseStalenessConfig: () => parseStalenessConfig,
   parseStatusConfig: () => parseStatusConfig,
   parseTerminalConfig: () => parseTerminalConfig,
   readConfig: () => readConfig,
@@ -3780,6 +3818,7 @@ __export(config_exports, {
   validateDeriveConfig: () => validateDeriveConfig,
   validateDeriveShape: () => validateDeriveShape,
   validateFactDeclarations: () => validateFactDeclarations,
+  validateStalenessConfig: () => validateStalenessConfig,
   writeAgentsConfig: () => writeAgentsConfig,
   writeHotkeyBindingsConfig: () => writeHotkeyBindingsConfig,
   writeSearchConfig: () => writeSearchConfig,
@@ -3791,6 +3830,13 @@ __export(config_exports, {
 import { readFile as readFile5 } from "fs/promises";
 import { spawnSync } from "child_process";
 import { resolve as resolve7, isAbsolute } from "path";
+function parseDurationMs(raw2) {
+  const m = raw2.trim().match(DURATION_RE);
+  if (!m) return null;
+  const n = Number(m[1]);
+  if (!Number.isFinite(n) || n <= 0) return null;
+  return n * DURATION_UNIT_MS[m[2] ?? "ms"];
+}
 function parseAgentCommand(value, agentId) {
   if (typeof value !== "string" || value.trim() === "") {
     throw new AgentConfigError(
@@ -5027,6 +5073,65 @@ ${cleanedFm}
 ---${afterFrontmatter}`;
   await writeFileForce(configPath, newContent);
 }
+function parseStalenessConfig(content) {
+  const match = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!match) return null;
+  const fmBlock = match[1];
+  const blockStart = fmBlock.match(/^staleness:\s*$/m);
+  if (!blockStart) return null;
+  const startIdx = (blockStart.index ?? 0) + blockStart[0].length;
+  const lines = fmBlock.slice(startIdx).split("\n");
+  const out = {};
+  for (const line of lines) {
+    if (line.trim() === "") continue;
+    const trimmed = line.trimStart();
+    const indent = line.length - trimmed.length;
+    if (indent === 0) break;
+    const ci = trimmed.indexOf(":");
+    if (ci <= 0) continue;
+    const key = trimmed.slice(0, ci).trim();
+    const field = STALENESS_KEY_TO_FIELD[key];
+    if (!field) continue;
+    let value = trimmed.slice(ci + 1).trim();
+    if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+      value = value.slice(1, -1);
+    }
+    const ms = parseDurationMs(value);
+    if (ms !== null) out[field] = ms;
+  }
+  return Object.keys(out).length > 0 ? out : null;
+}
+function validateStalenessConfig(content) {
+  const match = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!match) return [];
+  const fmBlock = match[1];
+  const blockStart = fmBlock.match(/^staleness:\s*$/m);
+  if (!blockStart) return [];
+  const startIdx = (blockStart.index ?? 0) + blockStart[0].length;
+  const lines = fmBlock.slice(startIdx).split("\n");
+  const problems = [];
+  for (const line of lines) {
+    if (line.trim() === "") continue;
+    const trimmed = line.trimStart();
+    const indent = line.length - trimmed.length;
+    if (indent === 0) break;
+    const ci = trimmed.indexOf(":");
+    if (ci <= 0) continue;
+    const key = trimmed.slice(0, ci).trim();
+    let value = trimmed.slice(ci + 1).trim();
+    if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+      value = value.slice(1, -1);
+    }
+    if (!(key in STALENESS_KEY_TO_FIELD)) {
+      problems.push(`staleness.${key}: unknown key (expected one of ${Object.keys(STALENESS_KEY_TO_FIELD).join(", ")})`);
+      continue;
+    }
+    if (parseDurationMs(value) === null) {
+      problems.push(`staleness.${key}: "${value}" is not a positive duration (e.g. 7d, 12h, 30m, 90s, 500ms)`);
+    }
+  }
+  return problems;
+}
 function parseSearchConfig(content) {
   const match = content.match(/^---\n([\s\S]*?)\n---/);
   if (!match) return null;
@@ -5309,7 +5414,9 @@ async function readConfig() {
       }
     })(),
     searchConfig: parseSearchConfig(content),
-    workspaceVisibility: parseWorkspaceVisibilityConfig(fmBlock)
+    workspaceVisibility: parseWorkspaceVisibilityConfig(fmBlock),
+    staleness: parseStalenessConfig(content),
+    stalenessWatchdog: String(fm["stalenessWatchdog"]).toLowerCase() === "true"
   };
 }
 function getAssignmentTypes(config) {
@@ -5372,7 +5479,7 @@ async function updateAgentsConfig(mutation, options = {}) {
   await writeAgentsConfig(next);
   return { previous, next, written: true };
 }
-var DEFAULT_ASSIGNMENT_TYPES, DEFAULT_CONFIG, AUTO_CREATE_WORKTREE_VALUES, SESSION_AUTO_TRACK_VALUES, AgentConfigError, DEFAULT_STATUS_COLORS, KNOWN_AGENT_SCALAR_FIELDS, migratedConfigPaths, TerminalConfigError;
+var STALENESS_KEY_TO_FIELD, DURATION_RE, DURATION_UNIT_MS, DEFAULT_ASSIGNMENT_TYPES, DEFAULT_CONFIG, AUTO_CREATE_WORKTREE_VALUES, SESSION_AUTO_TRACK_VALUES, AgentConfigError, DEFAULT_STATUS_COLORS, KNOWN_AGENT_SCALAR_FIELDS, migratedConfigPaths, TerminalConfigError;
 var init_config2 = __esm({
   "src/utils/config.ts"() {
     "use strict";
@@ -5389,6 +5496,21 @@ var init_config2 = __esm({
     init_terminal_schema();
     init_search_schema();
     init_workspace_visibility_schema();
+    STALENESS_KEY_TO_FIELD = {
+      inProgressNoActivity: "inProgressNoActivityMs",
+      readyUnclaimed: "readyUnclaimedMs",
+      reviewAging: "reviewAgingMs",
+      blockedAging: "blockedAgingMs",
+      planApprovalAging: "planApprovalAgingMs"
+    };
+    DURATION_RE = /^(\d+(?:\.\d+)?)\s*(ms|s|m|h|d)?$/;
+    DURATION_UNIT_MS = {
+      ms: 1,
+      s: 1e3,
+      m: 6e4,
+      h: 36e5,
+      d: 864e5
+    };
     DEFAULT_ASSIGNMENT_TYPES = {
       definitions: [
         { id: "feature", label: "Feature" },
@@ -5431,7 +5553,9 @@ var init_config2 = __esm({
       searchConfig: null,
       workspaceVisibility: {
         hidden: []
-      }
+      },
+      staleness: null,
+      stalenessWatchdog: false
     };
     AUTO_CREATE_WORKTREE_VALUES = ["skip", "ask", "always"];
     SESSION_AUTO_TRACK_VALUES = ["all", "workspaces-only", "off"];
@@ -7793,6 +7917,74 @@ var init_overviewCopy = __esm({
   }
 });
 
+// src/staleness/classify.ts
+function resolveStaleThresholds(overrides) {
+  const merged = { ...DEFAULT_STALE_THRESHOLDS };
+  if (overrides) {
+    for (const key of Object.keys(merged)) {
+      const v = overrides[key];
+      if (typeof v === "number" && Number.isFinite(v) && v > 0) merged[key] = v;
+    }
+  }
+  return merged;
+}
+function classifyNeedsAttention(input, thresholds = DEFAULT_STALE_THRESHOLDS) {
+  if (input.isTerminal) return [];
+  const reasons = [];
+  const age = input.statusAgeMs;
+  const aged = (gate) => age !== null && age >= gate;
+  const blocked = input.disposition === "blocked" || input.blockedReason !== null;
+  if (input.phase === IN_PROGRESS_PHASE && !blocked && aged(thresholds.inProgressNoActivityMs) && input.lastActivityMs !== null && input.lastActivityMs >= thresholds.inProgressNoActivityMs) {
+    reasons.push({
+      kind: "in_progress_no_activity",
+      label: "In progress, but no recent activity",
+      severity: "medium"
+    });
+  }
+  if (input.phase === READY_PHASE && input.assignee === null && aged(thresholds.readyUnclaimedMs)) {
+    reasons.push({
+      kind: "ready_unclaimed",
+      label: "Ready to implement, unclaimed",
+      severity: "medium"
+    });
+  }
+  if (input.phase === REVIEW_PHASE && aged(thresholds.reviewAgingMs)) {
+    reasons.push({ kind: "review_aging", label: "Awaiting review", severity: "high" });
+  }
+  if (blocked && aged(thresholds.blockedAgingMs)) {
+    reasons.push({ kind: "blocked_aging", label: "Blocked and aging", severity: "high" });
+  }
+  if (input.phase === PLANNING_PHASE && input.planExists && !input.planApproved && aged(thresholds.planApprovalAgingMs)) {
+    reasons.push({
+      kind: "plan_awaiting_approval",
+      label: "Plan awaiting approval",
+      severity: "medium"
+    });
+  }
+  if (input.depsSatisfied === false && (input.phase === READY_PHASE || input.phase === IN_PROGRESS_PHASE)) {
+    reasons.push({ kind: "deps_unsatisfied", label: "Unmet dependencies", severity: "high" });
+  }
+  return reasons;
+}
+var DAY, DEFAULT_STALE_THRESHOLDS, PLANNING_PHASE, READY_PHASE, IN_PROGRESS_PHASE, REVIEW_PHASE;
+var init_classify = __esm({
+  "src/staleness/classify.ts"() {
+    "use strict";
+    DAY = 24 * 60 * 60 * 1e3;
+    DEFAULT_STALE_THRESHOLDS = {
+      inProgressNoActivityMs: 7 * DAY,
+      readyUnclaimedMs: 3 * DAY,
+      reviewAgingMs: 3 * DAY,
+      blockedAgingMs: 3 * DAY,
+      planApprovalAgingMs: 3 * DAY
+    };
+    PLANNING_PHASE = "ready_for_planning";
+    READY_PHASE = "ready_to_implement";
+    IN_PROGRESS_PHASE = "in_progress";
+    REVIEW_PHASE = "review";
+  }
+});
+
 // src/dashboard/servers.ts
 import { readdir as readdir9, readFile as readFile12, unlink as unlink2 } from "fs/promises";
 import { resolve as resolve15 } from "path";
@@ -8427,7 +8619,38 @@ var init_scanner = __esm({
 });
 
 // src/dashboard/api.ts
-import { readdir as readdir10, readFile as readFile13, writeFile as writeFile3 } from "fs/promises";
+var api_exports = {};
+__export(api_exports, {
+  WorkspaceBlockedError: () => WorkspaceBlockedError,
+  clearStatusConfigCache: () => clearStatusConfigCache,
+  collectStaleCandidates: () => collectStaleCandidates,
+  createWorkspace: () => createWorkspace,
+  deleteWorkspace: () => deleteWorkspace,
+  getAssignmentDetail: () => getAssignmentDetail,
+  getAssignmentDetailById: () => getAssignmentDetailById,
+  getEditableDocument: () => getEditableDocument,
+  getEditableDocumentById: () => getEditableDocumentById,
+  getHelp: () => getHelp,
+  getMemoryDetail: () => getMemoryDetail,
+  getOverview: () => getOverview,
+  getPlaybookDetail: () => getPlaybookDetail,
+  getProjectDetail: () => getProjectDetail,
+  getResourceDetail: () => getResourceDetail,
+  getStatusConfig: () => getStatusConfig,
+  installRecordsInvalidation: () => installRecordsInvalidation,
+  invalidateRecordsCache: () => invalidateRecordsCache,
+  listAllMemories: () => listAllMemories,
+  listAllResources: () => listAllResources,
+  listArchived: () => listArchived,
+  listAssignmentsBoard: () => listAssignmentsBoard,
+  listPlaybooks: () => listPlaybooks,
+  listProjects: () => listProjects,
+  listWorkspaceRecords: () => listWorkspaceRecords,
+  listWorkspaces: () => listWorkspaces,
+  resolveProjectPath: () => resolveProjectPath,
+  resolveWorkspaceMembers: () => resolveWorkspaceMembers
+});
+import { readdir as readdir10, readFile as readFile13, writeFile as writeFile3, stat as stat2 } from "fs/promises";
 import { resolve as resolve17, dirname as dirname2, basename } from "path";
 function clearFrontmatterField(content, key) {
   const fieldRegex = new RegExp(`^(${escapeRegExp2(key)}:)\\s*.*$`, "m");
@@ -8818,10 +9041,10 @@ async function getOverview(projectsDir, serversDir2, assignmentsDir2, options =
         (total, record) => total + (record.summary.progress["failed"] ?? 0),
         0
       ),
-      staleAssignments: activeProjectRecords.reduce(
-        (total, record) => total + activeAssignments(record.assignments).filter((assignment) => isStale(assignment.updated)).length,
-        0
-      ) + activeStandaloneRecords.filter((sr) => isStale(sr.record.updated)).length
+      // Derived from the SAME classifier verdict as the stale segment (via the
+      // pre-cap segment total) so the badge count can never diverge from the
+      // listed rows.
+      staleAssignments: segments.stale.total
     },
     hero,
     segments,
@@ -9973,9 +10196,77 @@ function segmentSeverity(segment) {
       return "medium";
   }
 }
+function topStaleReason(reasons) {
+  if (reasons.length === 0) return null;
+  return reasons.slice().sort((a, b) => STALE_SEVERITY_RANK[b.severity] - STALE_SEVERITY_RANK[a.severity])[0];
+}
+async function readProgressActivityMs(progressPath, now) {
+  try {
+    const s = await stat2(progressPath);
+    return Math.max(0, now - s.mtimeMs);
+  } catch {
+    return null;
+  }
+}
+function classifyAssignmentRecord(assignment, terminalStatuses, depsSatisfied, lastActivityMs, thresholds) {
+  const virtuals = deriveStatusVirtuals(assignment, terminalStatuses);
+  return classifyNeedsAttention(
+    {
+      phase: virtuals.phase,
+      disposition: virtuals.disposition,
+      isTerminal: terminalStatuses.has(assignment.status),
+      assignee: assignment.assignee ?? null,
+      blockedReason: assignment.blockedReason,
+      depsSatisfied,
+      // plan_awaiting_approval is deferred to the decision inbox's plan-approval
+      // category for now; pass values that keep that reason dormant.
+      planExists: false,
+      planApproved: true,
+      statusAgeMs: virtuals.statusAge,
+      lastActivityMs
+    },
+    thresholds
+  );
+}
+async function collectStaleCandidates(projectsDir, assignmentsDir2) {
+  const [projectRecords, standaloneRecords] = await Promise.all([
+    listProjectRecords(projectsDir),
+    listStandaloneRecords(assignmentsDir2)
+  ]);
+  const { terminalStatuses } = await getStatusConfig();
+  const thresholds = resolveStaleThresholds((await readConfig()).staleness);
+  const now = Date.now();
+  const out = [];
+  for (const record of projectRecords) {
+    if (isProjectArchived(record.summary)) continue;
+    const projectPath = resolve17(projectsDir, record.summary.slug);
+    const depMap = /* @__PURE__ */ new Map();
+    for (const a of record.assignments) depMap.set(a.slug, a.status);
+    for (const assignment of activeAssignments(record.assignments)) {
+      const depsSatisfied = assignment.dependsOn.length === 0 ? true : (await getUnmetDependencies(projectPath, assignment.dependsOn, terminalStatuses, depMap)).length === 0;
+      const lastActivityMs = await readProgressActivityMs(
+        resolve17(projectPath, "assignments", assignment.slug, "progress.md"),
+        now
+      );
+      const reasons = classifyAssignmentRecord(assignment, terminalStatuses, depsSatisfied, lastActivityMs, thresholds);
+      if (reasons.length > 0) {
+        out.push({ assignmentId: assignment.id, projectSlug: record.summary.slug, reasons });
+      }
+    }
+  }
+  for (const sr of standaloneRecords) {
+    if (sr.record.archived === true) continue;
+    const lastActivityMs = await readProgressActivityMs(resolve17(sr.assignmentDir, "progress.md"), now);
+    const reasons = classifyAssignmentRecord(sr.record, terminalStatuses, true, lastActivityMs, thresholds);
+    if (reasons.length > 0) out.push({ assignmentId: sr.record.id, projectSlug: null, reasons });
+  }
+  return out;
+}
 async function buildOverviewSegmentBuckets(projectsDir, projectRecords, standaloneRecords, traces) {
   const now = Date.now();
   const buckets = emptyBuckets();
+  const { terminalStatuses } = await getStatusConfig();
+  const staleThresholds = resolveStaleThresholds((await readConfig()).staleness);
   const newestPool = [];
   for (const record of projectRecords) {
     if (isProjectArchived(record.summary)) continue;
@@ -9984,6 +10275,7 @@ async function buildOverviewSegmentBuckets(projectsDir, projectRecords, standalo
       depMap.set(a.slug, a.status);
     }
     const visibleAssignments = activeAssignments(record.assignments);
+    const projectPath = resolve17(projectsDir, record.summary.slug);
     const resolvedTransitions = await Promise.all(
       visibleAssignments.map(async (assignment) => {
         const t0 = traces ? performance.now() : 0;
@@ -9995,13 +10287,25 @@ async function buildOverviewSegmentBuckets(projectsDir, projectRecords, standalo
           { traces, dependencyStatusMap: depMap }
         );
         if (traces) accumulatePhase(traces, "get-available-transitions", performance.now() - t0);
-        return { assignment, availableTransitions };
+        const depsSatisfied = assignment.dependsOn.length === 0 ? true : (await getUnmetDependencies(projectPath, assignment.dependsOn, terminalStatuses, depMap)).length === 0;
+        const lastActivityMs = await readProgressActivityMs(
+          resolve17(projectPath, "assignments", assignment.slug, "progress.md"),
+          now
+        );
+        return { assignment, availableTransitions, depsSatisfied, lastActivityMs };
       })
     );
-    for (const { assignment, availableTransitions } of resolvedTransitions) {
+    for (const { assignment, availableTransitions, depsSatisfied, lastActivityMs } of resolvedTransitions) {
       const segmentId = STATUS_TO_SEGMENT[assignment.status];
-      const stale = isStale(assignment.updated);
-      const isTerminal = TERMINAL_STATUSES2.has(assignment.status);
+      const isTerminal = terminalStatuses.has(assignment.status);
+      const staleReasons = classifyAssignmentRecord(
+        assignment,
+        terminalStatuses,
+        depsSatisfied,
+        lastActivityMs,
+        staleThresholds
+      );
+      const stale = staleReasons.length > 0;
       const agingMs = Math.max(0, now - parseTimestamp(assignment.updated));
       const baseId = `${record.summary.slug}:${assignment.slug}`;
       const shared = {
@@ -10030,11 +10334,12 @@ async function buildOverviewSegmentBuckets(projectsDir, projectRecords, standalo
         buckets[segmentId].push(primary);
       }
       if (stale && !isTerminal) {
+        const top = topStaleReason(staleReasons);
         const staleItem = {
           ...shared,
           id: `${baseId}:stale`,
           severity: "low",
-          reason: SEGMENT_REASON.stale,
+          reason: top?.label ?? SEGMENT_REASON.stale,
           segment: "stale"
         };
         buckets.stale.push(staleItem);
@@ -10058,14 +10363,22 @@ async function buildOverviewSegmentBuckets(projectsDir, projectRecords, standalo
       const t0 = traces ? performance.now() : 0;
       const availableTransitions = await getStandaloneAvailableTransitions(sr.record);
       if (traces) accumulatePhase(traces, "get-available-transitions", performance.now() - t0);
-      return { sr, availableTransitions };
+      const lastActivityMs = await readProgressActivityMs(resolve17(sr.assignmentDir, "progress.md"), now);
+      return { sr, availableTransitions, lastActivityMs };
     })
   );
-  for (const { sr, availableTransitions } of resolvedStandaloneTransitions) {
+  for (const { sr, availableTransitions, lastActivityMs } of resolvedStandaloneTransitions) {
     const assignment = sr.record;
     const segmentId = STATUS_TO_SEGMENT[assignment.status];
-    const stale = isStale(assignment.updated);
-    const isTerminal = TERMINAL_STATUSES2.has(assignment.status);
+    const isTerminal = terminalStatuses.has(assignment.status);
+    const staleReasons = classifyAssignmentRecord(
+      assignment,
+      terminalStatuses,
+      true,
+      lastActivityMs,
+      staleThresholds
+    );
+    const stale = staleReasons.length > 0;
     const agingMs = Math.max(0, now - parseTimestamp(assignment.updated));
     const baseId = `standalone:${sr.id}`;
     const shared = {
@@ -10093,11 +10406,12 @@ async function buildOverviewSegmentBuckets(projectsDir, projectRecords, standalo
       });
     }
     if (stale && !isTerminal) {
+      const top = topStaleReason(staleReasons);
       buckets.stale.push({
         ...shared,
         id: `${baseId}:stale`,
         severity: "low",
-        reason: SEGMENT_REASON.stale,
+        reason: top?.label ?? SEGMENT_REASON.stale,
         segment: "stale"
       });
     }
@@ -10218,13 +10532,6 @@ function parseTimestamp(timestamp) {
   const parsed = Date.parse(timestamp);
   return Number.isFinite(parsed) ? parsed : 0;
 }
-function isStale(updated) {
-  const timestamp = parseTimestamp(updated);
-  if (timestamp === 0) {
-    return false;
-  }
-  return Date.now() - timestamp > STALE_ASSIGNMENT_MS;
-}
 async function countOpenQuestions(projectPath, assignmentSlug) {
   const commentsPath = resolve17(
     projectPath,
@@ -10343,7 +10650,7 @@ async function getPlaybookDetail(playbooksDir2, slug) {
     enabled
   };
 }
-var WorkspaceBlockedError, STALE_ASSIGNMENT_MS, RECENT_PROJECTS_LIMIT, RECENT_ACTIVITY_LIMIT, RECENT_SESSIONS_LIMIT, NEWEST_CREATED_LIMIT, SEGMENT_DISPLAY_CAP, STALE_LIMIT_DEFAULT, STALE_LIMIT_MAX, TERMINAL_STATUSES2, STATUS_TO_SEGMENT, HERO_PRIORITY, projectRecordsCache, standaloneRecordsCache, DEFAULT_TRANSITION_DEFINITIONS, _cachedConfig, REFERENCED_BY_LIMIT, migratedProjectsDirs, DEFAULT_GRAPH_COLORS;
+var WorkspaceBlockedError, RECENT_PROJECTS_LIMIT, RECENT_ACTIVITY_LIMIT, RECENT_SESSIONS_LIMIT, NEWEST_CREATED_LIMIT, SEGMENT_DISPLAY_CAP, STALE_LIMIT_DEFAULT, STALE_LIMIT_MAX, STATUS_TO_SEGMENT, HERO_PRIORITY, projectRecordsCache, standaloneRecordsCache, DEFAULT_TRANSITION_DEFINITIONS, _cachedConfig, REFERENCED_BY_LIMIT, migratedProjectsDirs, DEFAULT_GRAPH_COLORS, STALE_SEVERITY_RANK;
 var init_api = __esm({
   "src/dashboard/api.ts"() {
     "use strict";
@@ -10361,6 +10668,7 @@ var init_api = __esm({
     init_help();
     init_agent_sessions();
     init_overviewCopy();
+    init_classify();
     WorkspaceBlockedError = class extends Error {
       blockedBy;
       constructor(blockedBy) {
@@ -10371,7 +10679,6 @@ var init_api = __esm({
         this.blockedBy = blockedBy;
       }
     };
-    STALE_ASSIGNMENT_MS = 7 * 24 * 60 * 60 * 1e3;
     RECENT_PROJECTS_LIMIT = 6;
     RECENT_ACTIVITY_LIMIT = 12;
     RECENT_SESSIONS_LIMIT = 10;
@@ -10379,7 +10686,6 @@ var init_api = __esm({
     SEGMENT_DISPLAY_CAP = 5;
     STALE_LIMIT_DEFAULT = 50;
     STALE_LIMIT_MAX = 200;
-    TERMINAL_STATUSES2 = /* @__PURE__ */ new Set(["completed", "failed", "archived"]);
     STATUS_TO_SEGMENT = {
       review: "readyForReview",
       ready_to_implement: "readyToImplement",
@@ -10472,6 +10778,7 @@ var init_api = __esm({
       failed: "fill:#9f2d2d,stroke:#651616,color:#ffffff",
       review: "fill:#c6911e,stroke:#7a5a10,color:#ffffff"
     };
+    STALE_SEVERITY_RANK = { high: 3, medium: 2, low: 1 };
   }
 });
 
@@ -10907,12 +11214,13 @@ __export(recompute_exports, {
   markDeriveMigrated: () => markDeriveMigrated,
   recomputeAll: () => recomputeAll,
   recomputeAndWrite: () => recomputeAndWrite,
+  recomputeAssignmentDir: () => recomputeAssignmentDir,
   recomputeDependents: () => recomputeDependents,
   resolveDeriveContext: () => resolveDeriveContext
 });
 import { createHash as createHash2 } from "crypto";
-import { open, readdir as readdir12, readFile as readFile17, unlink as unlink5, stat as stat2 } from "fs/promises";
-import { dirname as dirname4, resolve as resolve22 } from "path";
+import { open, readdir as readdir12, readFile as readFile17, unlink as unlink5, stat as stat3 } from "fs/promises";
+import { basename as basename3, dirname as dirname4, resolve as resolve22 } from "path";
 async function isDeriveMigrated() {
   return fileExists(resolve22(syntaurRoot(), MIGRATION_MARKER));
 }
@@ -10952,7 +11260,7 @@ async function acquireLock(assignmentDir) {
       const code = err.code;
       if (code !== "EEXIST") throw err;
       try {
-        const info = await stat2(lockPath);
+        const info = await stat3(lockPath);
         if (Date.now() - info.mtimeMs > LOCK_STALE_MS) {
           await unlink5(lockPath).catch(() => {
           });
@@ -11144,6 +11452,18 @@ async function recomputeAll(projectsDir, standaloneDir, opts) {
   }
   return summary;
 }
+async function recomputeAssignmentDir(assignmentDir, cause, by) {
+  try {
+    const assignmentPath = resolve22(assignmentDir, "assignment.md");
+    if (!await fileExists(assignmentPath)) return null;
+    const parent = dirname4(assignmentDir);
+    const projectDir = basename3(parent) === "assignments" ? dirname4(parent) : null;
+    const context = await resolveDeriveContext();
+    return await recomputeAndWrite(assignmentPath, { cause, by, projectDir, context });
+  } catch {
+    return null;
+  }
+}
 var LOCK_FILE, LOCK_STALE_MS, LOCK_WAIT_MS, LOCK_MAX_WAITS, CAS_RETRIES, MIGRATION_MARKER;
 var init_recompute = __esm({
   "src/lifecycle/recompute.ts"() {
@@ -11251,14 +11571,14 @@ var init_process_info = __esm({
 });
 
 // src/usage/cwd-extractor.ts
-import { open as open3, readdir as readdir13, stat as stat3 } from "fs/promises";
+import { open as open3, readdir as readdir13, stat as stat4 } from "fs/promises";
 import { join as join4 } from "path";
 import { homedir as homedir3 } from "os";
 async function extractClaudeSessionMeta(jsonlPath) {
   const cwd = await derivePathFromTranscript(jsonlPath);
   if (!cwd) return null;
-  const basename6 = jsonlPath.split("/").pop() ?? "";
-  const sessionId = basename6.replace(/\.jsonl$/, "");
+  const basename7 = jsonlPath.split("/").pop() ?? "";
+  const sessionId = basename7.replace(/\.jsonl$/, "");
   if (!sessionId) return null;
   const startTs = await readFirstTimestamp(jsonlPath);
   const endTs = await readLastTimestamp(jsonlPath);
@@ -11353,8 +11673,8 @@ async function* walkClaudeProjects(opts = {}) {
 async function* walkCodexSessions(opts = {}) {
   const root = resolveCodexSessionsRoot(opts.root);
   for await (const filePath of walkJsonlRecursive(root)) {
-    const basename6 = filePath.split("/").pop() ?? "";
-    if (!basename6.endsWith(".jsonl")) continue;
+    const basename7 = filePath.split("/").pop() ?? "";
+    if (!basename7.endsWith(".jsonl")) continue;
     if (opts.sinceMtimeMs !== void 0) {
       const mtime = await mtimeMs(filePath);
       if (mtime !== null && mtime < opts.sinceMtimeMs) continue;
@@ -11372,10 +11692,10 @@ function resolveCodexSessionsRoot(override) {
   return join4(homedir3(), ".codex", "sessions");
 }
 async function extractPiSessionMeta(jsonlPath) {
-  const basename6 = jsonlPath.split("/").pop() ?? "";
-  const underscoreIdx = basename6.lastIndexOf("_");
+  const basename7 = jsonlPath.split("/").pop() ?? "";
+  const underscoreIdx = basename7.lastIndexOf("_");
   if (underscoreIdx === -1) return null;
-  const sessionId = basename6.slice(underscoreIdx + 1).replace(/\.jsonl$/, "");
+  const sessionId = basename7.slice(underscoreIdx + 1).replace(/\.jsonl$/, "");
   if (!sessionId) return null;
   let handle;
   try {
@@ -11490,7 +11810,7 @@ async function* walkJsonlRecursive(root) {
 }
 async function mtimeMs(path) {
   try {
-    const s = await stat3(path);
+    const s = await stat4(path);
     return s.mtimeMs;
   } catch {
     return null;
@@ -12096,6 +12416,40 @@ var init_scanner2 = __esm({
   }
 });
 
+// src/staleness/watchdog.ts
+var watchdog_exports = {};
+__export(watchdog_exports, {
+  runStalenessWatchdogTick: () => runStalenessWatchdogTick
+});
+function runStalenessWatchdogTick(candidates, seen, emit) {
+  const staleNow = /* @__PURE__ */ new Map();
+  for (const c of candidates) {
+    if (c.reasons.length > 0) staleNow.set(c.assignmentId, c);
+  }
+  let newlyStale = 0;
+  for (const [id, c] of staleNow) {
+    if (!seen.has(id)) {
+      seen.add(id);
+      newlyStale++;
+      emit({ assignmentId: id, projectSlug: c.projectSlug, type: "staleness-detected", reasons: c.reasons });
+    }
+  }
+  let cleared = 0;
+  for (const id of [...seen]) {
+    if (!staleNow.has(id)) {
+      seen.delete(id);
+      cleared++;
+      emit({ assignmentId: id, projectSlug: null, type: "staleness-cleared", reasons: [] });
+    }
+  }
+  return { scanned: candidates.length, stale: staleNow.size, newlyStale, cleared };
+}
+var init_watchdog = __esm({
+  "src/staleness/watchdog.ts"() {
+    "use strict";
+  }
+});
+
 // src/dashboard/server.ts
 init_paths();
 init_api();
@@ -13264,7 +13618,7 @@ init_timestamp();
 init_fs();
 init_git_worktree();
 import { Router as Router2 } from "express";
-import { resolve as resolve23, basename as basename3, isAbsolute as isAbsolute4 } from "path";
+import { resolve as resolve23, basename as basename4, isAbsolute as isAbsolute4 } from "path";
 import { rm, readFile as readFile18, open as fsOpen, stat as fsStat, realpath as fsRealpath } from "fs/promises";
 import { spawnSync as spawnSync3 } from "child_process";
 
@@ -14485,7 +14839,7 @@ function createWriteRouter(projectsDir, assignmentsDir2, todosDir2) {
       res.status(404).json({ error: `Project "${slug}" not found` });
       return;
     }
-    const document = await getEditableDocument(projectsDir, "memory", basename3(projectDir), itemSlug);
+    const document = await getEditableDocument(projectsDir, "memory", basename4(projectDir), itemSlug);
     if (!document) {
       res.status(404).json({ error: "Memory not found" });
       return;
@@ -14504,7 +14858,7 @@ function createWriteRouter(projectsDir, assignmentsDir2, todosDir2) {
       res.status(404).json({ error: `Project "${slug}" not found` });
       return;
     }
-    const document = await getEditableDocument(projectsDir, "resource", basename3(projectDir), itemSlug);
+    const document = await getEditableDocument(projectsDir, "resource", basename4(projectDir), itemSlug);
     if (!document) {
       res.status(404).json({ error: "Resource not found" });
       return;
@@ -14589,7 +14943,7 @@ ${body.startsWith("\n") ? body.slice(1) : body}${body.endsWith("\n") ? "" : "\n"
         let content = renderItemStub(kind, {
           slug: requestedSlug,
           name,
-          projectSlug: basename3(projectDir),
+          projectSlug: basename4(projectDir),
           timestamp
         });
         const customBody = typeof body.body === "string" ? body.body : "";
@@ -14606,13 +14960,13 @@ ${body.startsWith("\n") ? body.slice(1) : body}${body.endsWith("\n") ? "" : "\n"
         } catch (err) {
           if (err.code === "EEXIST") {
             res.status(409).json({
-              error: `${kind === "memory" ? "Memory" : "Resource"} with slug "${requestedSlug}" already exists in project "${basename3(projectDir)}".`
+              error: `${kind === "memory" ? "Memory" : "Resource"} with slug "${requestedSlug}" already exists in project "${basename4(projectDir)}".`
             });
             return;
           }
           throw err;
         }
-        res.status(201).json({ slug: requestedSlug, projectSlug: basename3(projectDir), content });
+        res.status(201).json({ slug: requestedSlug, projectSlug: basename4(projectDir), content });
       } catch (error) {
         console.error(`Error creating ${kind}:`, error);
         res.status(500).json({ error: `Failed to create ${kind}: ${error.message}` });
@@ -14647,7 +15001,7 @@ ${body.startsWith("\n") ? body.slice(1) : body}${body.endsWith("\n") ? "" : "\n"
 ${nextBody}${nextBody.endsWith("\n") ? "" : "\n"}`;
         merged = setTopLevelField(merged, "updated", nowTimestamp());
         await writeFileForce(filePath, merged);
-        const detail = await getItemDetail(kind, basename3(projectDir), itemSlug);
+        const detail = await getItemDetail(kind, basename4(projectDir), itemSlug);
         res.json({ [kind]: detail, content: merged });
       } catch (error) {
         console.error(`Error updating ${kind}:`, error);
@@ -17811,25 +18165,29 @@ async function resolveSessionPlan(input, terminal) {
   }
   let cwd = session.path;
   let fallbackWarning = null;
-  if (session.projectSlug && session.assignmentSlug) {
-    const detail = await getAssignmentDetail(
+  if (!isExistingDir(session.path)) {
+    const detail = session.projectSlug && session.assignmentSlug ? await getAssignmentDetail(
       input.projectsDir,
       session.projectSlug,
       session.assignmentSlug
-    );
+    ) : session.assignmentSlug ? await getAssignmentDetailById(
+      input.projectsDir,
+      input.assignmentsDir,
+      session.assignmentSlug
+    ) : null;
     if (detail) {
       const picked = resolveWorkspaceCwd({
         worktreePath: detail.workspace.worktreePath,
         repository: detail.workspace.repository,
         branch: detail.workspace.branch,
-        assignmentSlug: session.assignmentSlug
+        assignmentSlug: detail.slug
       });
       if (picked.cwd !== null) {
         cwd = picked.cwd;
         fallbackWarning = picked.fallbackWarning;
       } else {
         fallbackWarning = formatFallbackCwdWarning({
-          assignmentSlug: session.assignmentSlug,
+          assignmentSlug: detail.slug,
           workspaceDir: session.path,
           worktreePath: detail.workspace.worktreePath,
           branch: detail.workspace.branch
@@ -17865,7 +18223,7 @@ async function resolveSessionPlan(input, terminal) {
 // src/launch/execute.ts
 import { spawn as spawn3 } from "child_process";
 import { homedir as homedir5 } from "os";
-import { basename as basename4, join as join6, resolve as resolve26 } from "path";
+import { basename as basename5, join as join6, resolve as resolve26 } from "path";
 init_fs();
 init_config2();
 init_session_id();
@@ -17885,7 +18243,7 @@ var TerminalNotFoundError = class extends Error {
 var realSpawn = (command, args, options) => spawn3(command, args, options);
 var WRAPPER_COMMANDS = /* @__PURE__ */ new Set(["osascript", "open", "sh"]);
 function isWrapperCommand(command) {
-  return WRAPPER_COMMANDS.has(basename4(command));
+  return WRAPPER_COMMANDS.has(basename5(command));
 }
 var WRAPPER_EXIT_TIMEOUT_MS = 1500;
 async function executeLaunchPlan(plan, spawnFn = realSpawn) {
@@ -19665,7 +20023,7 @@ async function readEvents(jobId) {
 
 // src/schedules/attempt.ts
 import { createHash as createHash3 } from "crypto";
-import { open as open4, readFile as readFile22, stat as stat4, unlink as unlink6 } from "fs/promises";
+import { open as open4, readFile as readFile22, stat as stat5, unlink as unlink6 } from "fs/promises";
 import { resolve as resolve31 } from "path";
 
 // src/schedules/triggers.ts
@@ -19862,7 +20220,7 @@ async function acquireJobLock(id) {
       const code = err.code;
       if (code !== "EEXIST") throw err;
       try {
-        const info = await stat4(lockPath);
+        const info = await stat5(lockPath);
         if (Date.now() - info.mtimeMs > LOCK_STALE_MS2) {
           await unlink6(lockPath).catch(() => {
           });
@@ -21864,8 +22222,8 @@ init_api();
 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 resolve39, basename as basename5, dirname as dirname9, extname } from "path";
+import { mkdir as mkdir4, readdir as readdir15, stat as stat6, rename as rename5, rm as rm4, unlink as unlink7, writeFile as writeFile6, cp } from "fs/promises";
+import { resolve as resolve39, basename as basename6, dirname as dirname9, extname } from "path";
 
 // src/utils/proof-artifact-id.ts
 import { randomBytes as randomBytes2 } from "crypto";
@@ -21938,7 +22296,7 @@ function isSafeInlineMime(mime) {
   return SAFE_INLINE_MIME.has(mime);
 }
 function sanitizeAttachmentName(name) {
-  let n = basename5(name || "").replace(/["'\\/]/g, "_");
+  let n = basename6(name || "").replace(/["'\\/]/g, "_");
   n = Array.from(n, (ch) => {
     const code = ch.charCodeAt(0);
     return code < 32 || code === 127 ? "_" : ch;
@@ -21961,7 +22319,7 @@ function attachmentDirFor(todosDir2, scopeId, todoId) {
 }
 async function dirExists(p) {
   try {
-    return (await stat5(p)).isDirectory();
+    return (await stat6(p)).isDirectory();
   } catch {
     return false;
   }
@@ -21996,7 +22354,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(resolve39(dir, stored));
+      const st = await stat6(resolve39(dir, stored));
       if (!st.isFile()) continue;
       out.push({ id, filename, mime: mimeForName(filename), size: st.size, createdAt: st.mtime.toISOString() });
     } catch {
@@ -24162,7 +24520,7 @@ init_fs();
 init_config2();
 import { execFile as execFile2 } from "child_process";
 import { promisify as promisify2 } from "util";
-import { cp as cp2, mkdtemp, rm as rm5, readFile as readFile29, writeFile as writeFile7, unlink as unlink8, stat as stat6, open as open5, rename as rename8 } from "fs/promises";
+import { cp as cp2, mkdtemp, rm as rm5, readFile as readFile29, writeFile as writeFile7, unlink as unlink8, stat as stat7, open as open5, rename as rename8 } from "fs/promises";
 import { resolve as resolve42, join as join9 } from "path";
 import { tmpdir } from "os";
 var exec2 = promisify2(execFile2);
@@ -24256,7 +24614,7 @@ async function cloneOrInit(repoUrl, destDir) {
 }
 async function copyRecursive(src, dest) {
   if (!await fileExists(src)) return;
-  const s = await stat6(src);
+  const s = await stat7(src);
   if (s.isDirectory()) {
     await ensureDir(dest);
     await cp2(src, dest, { recursive: true, force: true });
@@ -25911,6 +26269,8 @@ function createDashboardServer(options) {
     });
   }
   let watcherHandle = null;
+  const STALENESS_WATCHDOG_INTERVAL_MS = 5 * 60 * 1e3;
+  let stalenessWatchdogTimer = null;
   return {
     async start() {
       const { recomputeAndWrite: recomputeAndWrite2, recomputeAll: recomputeAll2, resolveDeriveContext: resolveDeriveContext2, isDeriveMigrated: isDeriveMigrated2 } = await Promise.resolve().then(() => (init_recompute(), recompute_exports));
@@ -26007,6 +26367,38 @@ function createDashboardServer(options) {
         onAgentSessionsChanged: () => broadcast({ type: "agent-sessions-updated", timestamp: (/* @__PURE__ */ new Date()).toISOString() })
       });
       startUsageCollector();
+      const startupConfig = await readConfig();
+      if (startupConfig.stalenessWatchdog) {
+        const { collectStaleCandidates: collectStaleCandidates2 } = await Promise.resolve().then(() => (init_api(), api_exports));
+        const { runStalenessWatchdogTick: runStalenessWatchdogTick2 } = await Promise.resolve().then(() => (init_watchdog(), watchdog_exports));
+        const { emitEvent: emitEvent2 } = await Promise.resolve().then(() => (init_event_emit(), event_emit_exports));
+        const stalenessSeen = /* @__PURE__ */ new Set();
+        const watchdogTick = async () => {
+          if (!await migrationGate()) return;
+          try {
+            const candidates = await collectStaleCandidates2(projectsDir, assignmentsDir2);
+            const summary = runStalenessWatchdogTick2(candidates, stalenessSeen, (e) => {
+              emitEvent2({
+                assignmentId: e.assignmentId,
+                projectSlug: e.projectSlug,
+                type: e.type,
+                actor: "system",
+                details: { reasons: e.reasons.map((r) => r.kind) }
+              });
+            });
+            if (summary.newlyStale > 0 || summary.cleared > 0) {
+              console.log(
+                `staleness watchdog: ${summary.newlyStale} newly stale, ${summary.cleared} cleared (${summary.stale}/${summary.scanned} stale).`
+              );
+            }
+          } catch (err) {
+            console.error("staleness watchdog tick failed:", err);
+          }
+        };
+        void watchdogTick();
+        stalenessWatchdogTimer = setInterval(() => void watchdogTick(), STALENESS_WATCHDOG_INTERVAL_MS);
+        stalenessWatchdogTimer.unref?.();
+      }
       return new Promise((resolvePromise, reject) => {
         server.on("error", (err) => {
           if (err.code === "EADDRINUSE") {
@@ -26028,6 +26420,10 @@ function createDashboardServer(options) {
       });
     },
     async stop() {
+      if (stalenessWatchdogTimer) {
+        clearInterval(stalenessWatchdogTimer);
+        stalenessWatchdogTimer = null;
+      }
       await stopAutodiscovery();
       await stopUsageCollector();
       if (watcherHandle) {