syntaur 0.67.0 → 0.69.0

package/dist/launch/index.d.ts

@@ -180,6 +180,19 @@ interface DeriveConfig {
     headline: HeadlineProjection;
 }
 
+/**
+ * Per-reason age gates (ms). Defaults are sensible; Task 5 lets config override
+ * these keyed on disposition/phase. `deps_unsatisfied` has no age gate (a hard
+ * contradiction), so it is intentionally absent here.
+ */
+interface StaleThresholds {
+    inProgressNoActivityMs: number;
+    readyUnclaimedMs: number;
+    reviewAgingMs: number;
+    blockedAgingMs: number;
+    planApprovalAgingMs: number;
+}
+
 /**
  * Search-config schema — the shape behind the `search:` block in
  * `~/.syntaur/config.md` and the command palette's customizable behavior.
@@ -307,6 +320,11 @@ interface SyntaurConfig {
     terminal: TerminalChoice | null;
     searchConfig: SearchConfig | null;
     workspaceVisibility: WorkspaceVisibilityConfig;
+    /** Optional per-reason staleness age-gate overrides (defaults-first; null = all defaults). */
+    staleness: Partial<StaleThresholds> | null;
+    /** Opt-in: run the read-only staleness watchdog on the dashboard loop (emits
+     * staleness-detected/cleared audit events; never mutates status). Off by default. */
+    stalenessWatchdog: boolean;
 }
 
 /**

package/dist/launch/index.js

@@ -2153,7 +2153,9 @@ __export(config_exports, {
   getTerminal: () => getTerminal,
   normalizeFactDeclarations: () => normalizeFactDeclarations,
   parseAgentCommand: () => parseAgentCommand,
+  parseDurationMs: () => parseDurationMs,
   parseSearchConfig: () => parseSearchConfig,
+  parseStalenessConfig: () => parseStalenessConfig,
   parseStatusConfig: () => parseStatusConfig,
   parseTerminalConfig: () => parseTerminalConfig,
   readConfig: () => readConfig,
@@ -2169,6 +2171,7 @@ __export(config_exports, {
   validateDeriveConfig: () => validateDeriveConfig,
   validateDeriveShape: () => validateDeriveShape,
   validateFactDeclarations: () => validateFactDeclarations,
+  validateStalenessConfig: () => validateStalenessConfig,
   writeAgentsConfig: () => writeAgentsConfig,
   writeHotkeyBindingsConfig: () => writeHotkeyBindingsConfig,
   writeSearchConfig: () => writeSearchConfig,
@@ -2180,6 +2183,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(raw) {
+  const m = raw.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(
@@ -3416,6 +3426,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;
@@ -3698,7 +3767,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) {
@@ -3761,7 +3832,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";
@@ -3778,6 +3849,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" },
@@ -3820,7 +3906,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"];
@@ -5075,8 +5163,24 @@ var init_overviewCopy = __esm({
   }
 });
 
+// src/staleness/classify.ts
+var DAY, DEFAULT_STALE_THRESHOLDS;
+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
+    };
+  }
+});
+
 // src/dashboard/api.ts
-import { readdir as readdir9, readFile as readFile12, writeFile as writeFile3 } from "fs/promises";
+import { readdir as readdir9, readFile as readFile12, writeFile as writeFile3, stat as stat2 } from "fs/promises";
 import { resolve as resolve15, dirname as dirname2, basename } from "path";
 function activeAssignments(items) {
   return items.filter((item) => item.archived !== true);
@@ -5951,7 +6055,7 @@ function getProjectActivityTimestamp(projectUpdated, assignments) {
   }
   return latest;
 }
-var STALE_ASSIGNMENT_MS, projectRecordsCache, standaloneRecordsCache, DEFAULT_TRANSITION_DEFINITIONS, _cachedConfig, REFERENCED_BY_LIMIT, migratedProjectsDirs, DEFAULT_GRAPH_COLORS;
+var projectRecordsCache, standaloneRecordsCache, DEFAULT_TRANSITION_DEFINITIONS, _cachedConfig, REFERENCED_BY_LIMIT, migratedProjectsDirs, DEFAULT_GRAPH_COLORS;
 var init_api = __esm({
   "src/dashboard/api.ts"() {
     "use strict";
@@ -5969,7 +6073,7 @@ var init_api = __esm({
     init_help();
     init_agent_sessions();
     init_overviewCopy();
-    STALE_ASSIGNMENT_MS = 7 * 24 * 60 * 60 * 1e3;
+    init_classify();
     projectRecordsCache = /* @__PURE__ */ new Map();
     standaloneRecordsCache = /* @__PURE__ */ new Map();
     DEFAULT_TRANSITION_DEFINITIONS = [
@@ -6461,25 +6565,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
@@ -6615,7 +6723,7 @@ function captureProcessStartedAt(pid) {
 
 // src/usage/cwd-extractor.ts
 init_paths();
-import { open as open2, readdir as readdir10, stat as stat2 } from "fs/promises";
+import { open as open2, readdir as readdir10, stat as stat3 } from "fs/promises";
 import { join as join4 } from "path";
 import { homedir as homedir3 } from "os";