@askexenow/exe-os 0.9.289 → 0.9.290

package/dist/skill-refinement-Y6LLKYRL.js

@@ -0,0 +1,158 @@
+import {
+  getClient
+} from "./chunk-DBQ6I6K2.js";
+import "./chunk-2I23RPSI.js";
+import "./chunk-XCPVYQVK.js";
+import "./chunk-PNQDP3OA.js";
+import "./chunk-FXU7JOXK.js";
+import "./chunk-5P3HOBZX.js";
+import "./chunk-LYH5HE24.js";
+import "./chunk-MLKGABMK.js";
+
+// src/lib/skill-refinement.ts
+import crypto from "crypto";
+async function incrementSkillUsage(behaviors) {
+  const skills = behaviors.filter((b) => b.domain === "skill");
+  if (skills.length === 0) return;
+  try {
+    const client = getClient();
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    for (const skill of skills) {
+      await client.execute({
+        sql: `UPDATE behaviors SET use_count = use_count + 1, last_used_at = ?, updated_at = ? WHERE id = ?`,
+        args: [now, now, skill.id]
+      });
+    }
+  } catch (err) {
+    process.stderr.write(
+      `[skill-refinement] Failed to increment usage: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+  }
+}
+async function incrementSkillSuccess(assignedTo, projectName) {
+  try {
+    const client = getClient();
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const cutoff = new Date(Date.now() - 24 * 60 * 60 * 1e3).toISOString();
+    const rows = await client.execute({
+      sql: `SELECT id FROM behaviors
+            WHERE agent_id = ? AND domain = 'skill' AND active = 1
+            AND use_count > 0 AND last_used_at > ?
+            ${projectName ? "AND (project_name = ? OR project_name IS NULL)" : ""}`,
+      args: projectName ? [assignedTo, cutoff, projectName] : [assignedTo, cutoff]
+    });
+    for (const row of rows.rows) {
+      const id = String(row.id);
+      await client.execute({
+        sql: `UPDATE behaviors SET success_count = success_count + 1, updated_at = ? WHERE id = ?`,
+        args: [now, id]
+      });
+    }
+    if (rows.rows.length > 0) {
+      process.stderr.write(
+        `[skill-refinement] Incremented success_count for ${rows.rows.length} skill(s) (agent: ${assignedTo})
+`
+      );
+    }
+  } catch (err) {
+    process.stderr.write(
+      `[skill-refinement] Failed to increment success: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+  }
+}
+var MIN_USES_FOR_REVIEW = 3;
+var LOW_SUCCESS_RATE = 0.8;
+var HIGH_SUCCESS_RATE = 0.9;
+var MIN_USES_FOR_PROMOTION = 10;
+async function runSkillRefinement() {
+  const client = getClient();
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const result = {
+    reviewed: 0,
+    flaggedLowSuccess: 0,
+    boostedConfidence: 0,
+    promotedToIdentity: 0
+  };
+  const rows = await client.execute({
+    sql: `SELECT id, agent_id, content, use_count, success_count, last_refined_at, project_name
+          FROM behaviors
+          WHERE domain = 'skill' AND active = 1 AND use_count >= ?`,
+    args: [MIN_USES_FOR_REVIEW]
+  });
+  for (const rawRow of rows.rows) {
+    const row = rawRow;
+    result.reviewed++;
+    const successRate = row.use_count > 0 ? row.success_count / row.use_count : 0;
+    if (successRate < LOW_SUCCESS_RATE) {
+      result.flaggedLowSuccess++;
+      const { writeMemory } = await import("./lib/store.js");
+      await writeMemory({
+        id: crypto.randomUUID(),
+        agent_id: row.agent_id,
+        agent_role: "",
+        session_id: "",
+        timestamp: now,
+        tool_name: "skill-refinement",
+        project_name: row.project_name ?? "",
+        has_error: false,
+        raw_text: `SKILL REVIEW NEEDED: "${row.content.slice(0, 100)}..." has ${Math.round(successRate * 100)}% success rate (${row.success_count}/${row.use_count} uses). Consider revising or deactivating.`,
+        vector: null,
+        memory_type: "observation"
+      });
+      await client.execute({
+        sql: `UPDATE behaviors SET last_refined_at = ?, updated_at = ? WHERE id = ?`,
+        args: [now, now, row.id]
+      });
+    } else if (row.use_count >= MIN_USES_FOR_PROMOTION && successRate > HIGH_SUCCESS_RATE) {
+      result.promotedToIdentity++;
+      try {
+        const { getIdentity, updateIdentity } = await import("./lib/identity.js");
+        const identity = await getIdentity(row.agent_id);
+        if (identity) {
+          const promotionBlock = `
+
+## Promoted Skill (auto-promoted ${now.split("T")[0]})
+${row.content}`;
+          await updateIdentity(row.agent_id, identity + promotionBlock, "skill-refinement");
+        }
+        await client.execute({
+          sql: `UPDATE behaviors SET active = 0, last_refined_at = ?, updated_at = ? WHERE id = ?`,
+          args: [now, now, row.id]
+        });
+        const { writeMemory: writePromoMemory } = await import("./lib/store.js");
+        await writePromoMemory({
+          id: crypto.randomUUID(),
+          agent_id: row.agent_id,
+          agent_role: "",
+          session_id: "",
+          timestamp: now,
+          tool_name: "skill-refinement",
+          project_name: row.project_name ?? "",
+          has_error: false,
+          raw_text: `SKILL PROMOTED TO IDENTITY: "${row.content.slice(0, 100)}..." \u2014 ${row.success_count}/${row.use_count} uses (${Math.round(successRate * 100)}% success). Deactivated as behavior, appended to identity.`,
+          vector: null,
+          memory_type: "decision"
+        });
+      } catch (err) {
+        process.stderr.write(
+          `[skill-refinement] Failed to promote skill ${row.id}: ${err instanceof Error ? err.message : String(err)}
+`
+        );
+      }
+    } else if (successRate > HIGH_SUCCESS_RATE) {
+      result.boostedConfidence++;
+      await client.execute({
+        sql: `UPDATE behaviors SET priority = 'p0', last_refined_at = ?, updated_at = ? WHERE id = ? AND priority != 'p0'`,
+        args: [now, now, row.id]
+      });
+    }
+  }
+  return result;
+}
+export {
+  incrementSkillSuccess,
+  incrementSkillUsage,
+  runSkillRefinement
+};

package/dist/steward-gate-QV2APBFB.js

@@ -0,0 +1,14 @@
+import {
+  StewardGate
+} from "./chunk-I7Z6MK2B.js";
+import "./chunk-DBQ6I6K2.js";
+import "./chunk-2I23RPSI.js";
+import "./chunk-XCPVYQVK.js";
+import "./chunk-PNQDP3OA.js";
+import "./chunk-FXU7JOXK.js";
+import "./chunk-5P3HOBZX.js";
+import "./chunk-LYH5HE24.js";
+import "./chunk-MLKGABMK.js";
+export {
+  StewardGate
+};

package/dist/task-enforcement-GLDD2W5D.js

@@ -0,0 +1,505 @@
+import {
+  sendIntercom,
+  updateTaskStatus
+} from "./chunk-6TLURATK.js";
+import "./chunk-EZHTLPOS.js";
+import "./chunk-4JERP7NT.js";
+import "./chunk-4FVVJ7ME.js";
+import "./chunk-QKDRYZ2N.js";
+import "./chunk-MVW62NIZ.js";
+import "./chunk-OYNKIAVW.js";
+import "./chunk-SSTLTIF3.js";
+import {
+  recordOrchestrationEventBestEffort
+} from "./chunk-6IPJF5QD.js";
+import "./chunk-RJY45A5J.js";
+import "./chunk-NGP6LSV2.js";
+import "./chunk-272SJ4RN.js";
+import "./chunk-CVYC6DUW.js";
+import "./chunk-OPU3NYOO.js";
+import "./chunk-GJV3WDWM.js";
+import "./chunk-MP2AFCGL.js";
+import "./chunk-V5MGYIZS.js";
+import "./chunk-HYZV25LY.js";
+import {
+  isCoordinatorName
+} from "./chunk-DBQ6I6K2.js";
+import "./chunk-2I23RPSI.js";
+import "./chunk-XCPVYQVK.js";
+import "./chunk-PNQDP3OA.js";
+import "./chunk-FXU7JOXK.js";
+import "./chunk-SYOGNG2R.js";
+import "./chunk-5P3HOBZX.js";
+import "./chunk-LYH5HE24.js";
+import "./chunk-MLKGABMK.js";
+
+// src/lib/task-enforcement.ts
+import { appendFile } from "fs/promises";
+import path from "path";
+var TASK_ENFORCEMENT_INTERVAL_MS = 6e4;
+var TASK_ENFORCEMENT_DEBOUNCE_MS = 18e4;
+var MANAGER_GRACE_PERIOD_MS = 6e5;
+var STUCK_TASK_THRESHOLD_MS = (() => {
+  const raw = process.env.EXE_STUCK_TASK_THRESHOLD_MS;
+  const parsed = raw ? Number(raw) : NaN;
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : 72 * 60 * 60 * 1e3;
+})();
+var IDLE_PATTERNS = [
+  "Standing by",
+  "All tasks complete",
+  "No tasks found",
+  "Anything else?",
+  "What do you need?"
+];
+var NUDGE_ECHO_PATTERNS = [
+  "You have pending notifications",
+  "You have open tasks. Run list_tasks",
+  "You have more open tasks to dispatch",
+  "Run list_tasks to check for assigned work",
+  "Run list_tasks to find them"
+];
+var MCP_ZOMBIE_PATTERNS = [
+  "session expired",
+  "MCP server disconnected",
+  "MCP server is not connected",
+  'MCP server "exe-os" is not connected',
+  "MCP connection lost",
+  "MCP error",
+  "MCP_UNHEALTHY"
+];
+var MANAGER_ROLES = ["COO", "CTO"];
+var AUDIT_LOG_PATH = path.join(
+  process.env.HOME ?? process.env.USERPROFILE ?? "/tmp",
+  ".exe-os",
+  "enforcement-audit.jsonl"
+);
+function writeAuditEntry(entry) {
+  const line = JSON.stringify(entry) + "\n";
+  appendFile(AUDIT_LOG_PATH, line).catch(() => {
+  });
+}
+function decideManagerAction(counts, isIdle, withinGracePeriod, nudgeEcho) {
+  if (counts.openTasks === 0) return "skip";
+  if (withinGracePeriod) return "grace_period";
+  if (!isIdle) return "active";
+  if (nudgeEcho) return "active";
+  if ((counts.inProgressTasks ?? 0) > 0) return "active";
+  if (counts.activeSubtasks === 0) return "nudge";
+  return "soft_nudge";
+}
+function decideWorkerAction(taskCount, isIdle, nudgeEcho) {
+  if (taskCount === 0) return "skip";
+  if (nudgeEcho) return "idle";
+  return isIdle ? "nudge" : "idle";
+}
+function isIdlePane(paneText) {
+  return IDLE_PATTERNS.some((p) => paneText.includes(p));
+}
+function isCurrentlyIdle(paneText) {
+  const nonEmptyLines = paneText.split("\n").map((line) => line.trim()).filter(Boolean);
+  const lastLine = nonEmptyLines.at(-1) ?? "";
+  if (/(?:^|[>❯$#])\s*\/mcp\s*$/.test(lastLine)) return true;
+  if (IDLE_PATTERNS.some((p) => lastLine.includes(p))) return true;
+  if (lineHasMcpZombiePattern(lastLine)) return true;
+  const currentLines = nonEmptyLines.slice(-3);
+  return tailHasMcpZombieContext(currentLines) && lineLooksLikeMcpReconnectPrompt(lastLine);
+}
+function isNudgeEcho(paneText) {
+  return NUDGE_ECHO_PATTERNS.some((p) => paneText.includes(p));
+}
+function lineHasMcpZombiePattern(line) {
+  const lower = line.toLowerCase();
+  if (lower.includes("not connected") && !lower.includes("mcp server")) return false;
+  return MCP_ZOMBIE_PATTERNS.some((p) => lower.includes(p.toLowerCase()));
+}
+function tailHasMcpZombieContext(lines) {
+  return lines.some(lineHasMcpZombiePattern);
+}
+function lineLooksLikeMcpReconnectPrompt(line) {
+  const lower = line.toLowerCase();
+  return lower.includes("/mcp") && (lower.includes("reconnect") || lower.includes("connect") || lower.includes("run") || lower.includes("try"));
+}
+function isMcpZombiePane(paneText, paneCurrentlyIdle) {
+  if (!paneCurrentlyIdle) return false;
+  const nonEmptyLines = paneText.split("\n").map((line) => line.trim()).filter(Boolean);
+  const lastLine = nonEmptyLines.at(-1) ?? "";
+  if (/(?:^|[>❯$#])\s*\/mcp\s*$/.test(lastLine)) return true;
+  if (lineHasMcpZombiePattern(lastLine)) return true;
+  const currentLines = nonEmptyLines.slice(-3);
+  return tailHasMcpZombieContext(currentLines) && lineLooksLikeMcpReconnectPrompt(lastLine);
+}
+function sendNudge(transport, session, runtime, action) {
+  const message = action === "nudge" ? "You have open tasks. Run list_tasks to find them." : "You have more open tasks to dispatch. Run list_tasks.";
+  if (transport.sendKeysLiteral) {
+    transport.sendKeysLiteral(session, message);
+  } else {
+    transport.sendKeys(session, message);
+  }
+  process.stderr.write(
+    `[enforcement-audit] SENT nudge to ${session} (${runtime}, ${action})
+`
+  );
+}
+function _resetNudgeState() {
+}
+function coordinatorScopeFromSession(session) {
+  const dashIndex = session.indexOf("-");
+  if (dashIndex <= 0) return null;
+  const scope = session.slice(dashIndex + 1).trim();
+  return scope.length > 0 ? scope : null;
+}
+function strictTaskSessionScope(scope) {
+  if (!scope) return { sql: " AND session_scope IS NOT NULL AND 1 = 0", args: [] };
+  return { sql: " AND session_scope = ?", args: [scope] };
+}
+async function countOrphanedTasksForAgent(client, agentName, statuses) {
+  const result = await client.execute({
+    sql: `SELECT COUNT(*) as cnt FROM tasks WHERE assigned_to = ? AND status IN (${statuses}) AND session_scope IS NULL`,
+    args: [agentName]
+  });
+  return Number(result.rows[0]?.cnt ?? 0);
+}
+async function findStuckTasks(client, scopeList, now, thresholdMs = STUCK_TASK_THRESHOLD_MS) {
+  if (scopeList.length === 0) return [];
+  const result = await client.execute({
+    sql: `SELECT id, title, assigned_to, status, created_at, updated_at
+          FROM tasks
+          WHERE status IN ('open', 'blocked')
+            AND session_scope IN (${scopeList.map(() => "?").join(",")})`,
+    args: scopeList
+  });
+  const stuck = [];
+  for (const row of result.rows) {
+    const updatedAt = row.updated_at ?? row.created_at;
+    if (!updatedAt) continue;
+    const ts = new Date(updatedAt).getTime();
+    if (!Number.isFinite(ts)) continue;
+    const ageMs = now - ts;
+    if (ageMs > thresholdMs) {
+      stuck.push({
+        id: String(row.id),
+        title: String(row.title ?? ""),
+        assigned_to: String(row.assigned_to ?? ""),
+        status: String(row.status ?? ""),
+        ageMs
+      });
+    }
+  }
+  stuck.sort((a, b) => b.ageMs - a.ageMs);
+  return stuck;
+}
+async function runTaskEnforcementTick(deps) {
+  const { transport, employees, client } = deps;
+  const now = deps.now ?? Date.now();
+  const tickStartedAt = Date.now();
+  const sessions = transport.listSessions();
+  let processedAnyEmployee = false;
+  let processedSessions = 0;
+  let nudgesSent = 0;
+  const processedScopes = /* @__PURE__ */ new Set();
+  recordOrchestrationEventBestEffort({
+    eventType: "daemon.tick.started",
+    source: "task-enforcement.runTaskEnforcementTick",
+    payload: { sessionCount: sessions.length }
+  });
+  const hasScopeRestriction = deps.scopeFilter.sql.length > 0;
+  const allowedScope = hasScopeRestriction && deps.scopeFilter.args.length > 0 ? String(deps.scopeFilter.args[deps.scopeFilter.args.length - 1]) : null;
+  for (const session of sessions) {
+    if (!session.includes("-")) continue;
+    const agentName = session.split("-")[0]?.replace(/\d+$/, "");
+    if (!agentName) continue;
+    if (allowedScope) {
+      const sessionSuffix = session.slice(session.indexOf("-") + 1);
+      if (sessionSuffix !== allowedScope) continue;
+    }
+    if ("isAlive" in transport && typeof transport.isAlive === "function") {
+      if (!transport.isAlive(session)) continue;
+    }
+    const employee = employees.find((e) => e.name === agentName);
+    if (!employee) continue;
+    processedAnyEmployee = true;
+    processedSessions++;
+    const coordinatorSession = coordinatorScopeFromSession(session);
+    const effectiveScope = strictTaskSessionScope(coordinatorSession);
+    if (coordinatorSession) processedScopes.add(coordinatorSession);
+    const isManager = MANAGER_ROLES.includes(employee.role);
+    try {
+      let action = "skip";
+      let reason = "";
+      let openTasks = 0;
+      let activeSubtasks = 0;
+      let paneIdle;
+      if (isManager) {
+        const openResult = await client.execute({
+          sql: `SELECT COUNT(*) as cnt FROM tasks WHERE assigned_to = ? AND status = 'open'${effectiveScope.sql}`,
+          args: [agentName, ...effectiveScope.args]
+        });
+        openTasks = Number(openResult.rows[0]?.cnt ?? 0);
+        if (openTasks === 0 && coordinatorSession) {
+          const orphaned = await countOrphanedTasksForAgent(client, agentName, "'open'");
+          if (orphaned > 0) {
+            process.stderr.write(
+              `[exed] Task enforcement: ${agentName}-${coordinatorSession} has ${orphaned} orphaned open task(s) with NULL session_scope; not nudging until owning scope is repaired.
+`
+            );
+          }
+        }
+        if (openTasks > 0) {
+          const subtaskResult = await client.execute({
+            sql: `SELECT COUNT(*) as cnt FROM tasks WHERE assigned_by = ? AND status = 'in_progress'${effectiveScope.sql}`,
+            args: [agentName, ...effectiveScope.args]
+          });
+          activeSubtasks = Number(subtaskResult.rows[0]?.cnt ?? 0);
+        }
+        let withinGracePeriod = false;
+        let graceRemaining = 0;
+        if (openTasks > 0) {
+          const newestResult = await client.execute({
+            sql: `SELECT created_at FROM tasks WHERE assigned_to = ? AND status = 'open'${effectiveScope.sql} ORDER BY created_at DESC LIMIT 1`,
+            args: [agentName, ...effectiveScope.args]
+          });
+          const newestCreatedAt = newestResult.rows[0]?.created_at;
+          if (newestCreatedAt) {
+            const taskAge = now - new Date(newestCreatedAt).getTime();
+            if (taskAge < MANAGER_GRACE_PERIOD_MS) {
+              withinGracePeriod = true;
+              graceRemaining = Math.round((MANAGER_GRACE_PERIOD_MS - taskAge) / 1e3);
+            }
+          }
+        }
+        let inProgressTasks = 0;
+        if (openTasks > 0) {
+          const ipResult = await client.execute({
+            sql: `SELECT COUNT(*) as cnt FROM tasks WHERE assigned_to = ? AND status = 'in_progress'${effectiveScope.sql}`,
+            args: [agentName, ...effectiveScope.args]
+          });
+          inProgressTasks = Number(ipResult.rows[0]?.cnt ?? 0);
+        }
+        const pane = deps.paneCache?.get(session) ?? (deps.capturePaneAsync ? await deps.capturePaneAsync(session, 20) : transport.capturePane(session, 20));
+        paneIdle = isIdlePane(pane);
+        const nudgeEcho = isNudgeEcho(pane);
+        action = decideManagerAction({ openTasks, activeSubtasks, inProgressTasks }, paneIdle, withinGracePeriod, nudgeEcho);
+        if (action === "skip") reason = "no open tasks";
+        else if (action === "grace_period") reason = `task assigned <10min ago (${graceRemaining}s remaining)`;
+        else if (action === "active") reason = nudgeEcho ? "pane shows previous nudge (anti-loop)" : inProgressTasks > 0 ? `${inProgressTasks} tasks in_progress` : "pane shows active work";
+        else if (action === "nudge") reason = `${openTasks} open tasks, 0 delegated, pane idle`;
+        else if (action === "soft_nudge") reason = `${openTasks} open tasks, ${activeSubtasks} delegated, pane idle`;
+        writeAuditEntry({
+          timestamp: new Date(now).toISOString(),
+          session,
+          agent: agentName,
+          role: "manager",
+          action,
+          reason,
+          openTasks,
+          activeSubtasks,
+          paneIdle,
+          graceRemaining: withinGracePeriod ? graceRemaining : void 0
+        });
+        process.stderr.write(
+          `[exed] Task enforcement: ${agentName} (manager) ${openTasks} open, ${activeSubtasks} delegated, pane=${paneIdle ? "idle" : "active"}. Action: ${action} (${reason})
+`
+        );
+      } else {
+        const taskResult = await client.execute({
+          sql: `SELECT COUNT(*) as cnt FROM tasks WHERE assigned_to = ? AND status IN ('open', 'in_progress')${effectiveScope.sql}`,
+          args: [agentName, ...effectiveScope.args]
+        });
+        const taskCount = Number(taskResult.rows[0]?.cnt ?? 0);
+        openTasks = taskCount;
+        if (taskCount === 0 && coordinatorSession) {
+          const orphaned = await countOrphanedTasksForAgent(client, agentName, "'open','in_progress'");
+          if (orphaned > 0) {
+            process.stderr.write(
+              `[exed] Task enforcement: ${agentName}-${coordinatorSession} has ${orphaned} orphaned task(s) with NULL session_scope; not nudging until owning scope is repaired.
+`
+            );
+          }
+        }
+        if (taskCount > 0) {
+          const pane = deps.paneCache?.get(session) ?? (deps.capturePaneAsync ? await deps.capturePaneAsync(session, 20) : transport.capturePane(session, 20));
+          paneIdle = isIdlePane(pane);
+          const workerNudgeEcho = isNudgeEcho(pane);
+          const paneCurrentlyIdle = isCurrentlyIdle(pane);
+          if (isMcpZombiePane(pane, paneCurrentlyIdle) && deps.zombieWorkerRecover) {
+            const reason2 = "pane shows dead MCP client";
+            await deps.zombieWorkerRecover(session, agentName, coordinatorSession ?? "", reason2);
+            writeAuditEntry({
+              timestamp: new Date(now).toISOString(),
+              session,
+              agent: agentName,
+              role: "worker",
+              action: "active",
+              reason: reason2,
+              openTasks: taskCount,
+              paneIdle
+            });
+            continue;
+          }
+          action = decideWorkerAction(taskCount, paneIdle, workerNudgeEcho);
+        }
+        if (action === "skip") reason = "no tasks";
+        else if (action === "idle") reason = `${taskCount} tasks but pane active`;
+        else if (action === "nudge") reason = `${taskCount} tasks, pane idle`;
+        writeAuditEntry({
+          timestamp: new Date(now).toISOString(),
+          session,
+          agent: agentName,
+          role: "worker",
+          action,
+          reason,
+          openTasks: taskCount,
+          paneIdle
+        });
+        process.stderr.write(
+          `[exed] Task enforcement: ${agentName} (worker) ${taskCount} tasks, pane=${paneIdle ?? "n/a"}. Action: ${action} (${reason})
+`
+        );
+      }
+      if (action === "skip" || action === "idle" || action === "grace_period" || action === "active") continue;
+      nudgesSent++;
+      sendIntercom(session, { callerSessionScope: coordinatorSession, reason: "nudge" });
+    } catch {
+    }
+  }
+  if (processedAnyEmployee) {
+    try {
+      const scopeList = allowedScope ? [...processedScopes].filter((s) => s === allowedScope) : [...processedScopes];
+      const staleBlocked = scopeList.length === 0 ? { rows: [] } : await client.execute({
+        sql: `SELECT t.id, t.title, b.status as blocker_status
+                  FROM tasks t
+                  JOIN tasks b ON t.blocked_by = b.id
+                  WHERE t.status = 'blocked'
+                    AND b.status IN ('done', 'cancelled', 'closed')
+                    AND t.session_scope IN (${scopeList.map(() => "?").join(",")})`,
+        args: scopeList
+      });
+      const nowIso = new Date(now).toISOString();
+      for (const row of staleBlocked.rows) {
+        try {
+          await updateTaskStatus({ taskId: String(row.id), status: "open" });
+        } catch {
+          await client.execute({
+            sql: `UPDATE tasks SET status = 'open', updated_at = ? WHERE id = ?`,
+            args: [nowIso, String(row.id)]
+          });
+        }
+        await client.execute({
+          sql: `UPDATE tasks SET blocked_by = NULL WHERE id = ?`,
+          args: [String(row.id)]
+        });
+        process.stderr.write(
+          `[exed] Auto-unblocked "${String(row.title)}" \u2014 blocker already ${String(row.blocker_status)}
+`
+        );
+      }
+    } catch {
+    }
+  }
+  if (processedAnyEmployee && deps.reviewerSpawn) {
+    try {
+      const scopeList = allowedScope ? [...processedScopes].filter((s) => s === allowedScope) : [...processedScopes];
+      const reviewerRows = scopeList.length === 0 ? { rows: [] } : await client.execute({
+        sql: `SELECT DISTINCT reviewer, session_scope FROM tasks
+                  WHERE status = 'needs_review'
+                    AND reviewer IS NOT NULL
+                    AND reviewer != ''
+                    AND session_scope IN (${scopeList.map(() => "?").join(",")})`,
+        args: scopeList
+      });
+      const liveSessionSet = new Set(sessions);
+      for (const row of reviewerRows.rows) {
+        const reviewerName = String(row.reviewer ?? "");
+        const sessionScope = row.session_scope ? String(row.session_scope) : null;
+        if (!reviewerName || !sessionScope) continue;
+        if (isCoordinatorName(reviewerName, employees)) {
+          process.stderr.write(
+            `[exed] Reviewer auto-spawn: skipping ${reviewerName} (coordinator, not dispatchable)
+`
+          );
+          continue;
+        }
+        const reviewerSession = `${reviewerName}-${sessionScope}`;
+        if (liveSessionSet.has(reviewerSession)) continue;
+        try {
+          const result = deps.reviewerSpawn(reviewerName, sessionScope);
+          if (!result) continue;
+          if (result.status === "spawned") {
+            process.stderr.write(
+              `[exed] Reviewer auto-spawn: spawned ${reviewerName} in ${sessionScope} (has needs_review tasks)
+`
+            );
+          } else if (result.status === "failed") {
+            process.stderr.write(
+              `[exed] Reviewer auto-spawn: failed to spawn ${reviewerName} in ${sessionScope}: ${result.error ?? "unknown"}
+`
+            );
+          }
+        } catch (spawnErr) {
+          process.stderr.write(
+            `[exed] Reviewer auto-spawn error for ${reviewerName}: ${spawnErr instanceof Error ? spawnErr.message : String(spawnErr)}
+`
+          );
+        }
+      }
+    } catch {
+    }
+  }
+  if (processedAnyEmployee) {
+    try {
+      const scopeList = allowedScope ? [...processedScopes].filter((s) => s === allowedScope) : [...processedScopes];
+      const stuck = await findStuckTasks(client, scopeList, now);
+      if (stuck.length > 0) {
+        const oldest = stuck[0];
+        const oldestStuckHours = Math.round(oldest.ageMs / 36e5);
+        writeAuditEntry({
+          timestamp: new Date(now).toISOString(),
+          session: allowedScope ?? "(all-scopes)",
+          agent: "(enforcement)",
+          role: "manager",
+          action: "stuck_alert",
+          reason: `${stuck.length} stuck task(s) > ${Math.round(STUCK_TASK_THRESHOLD_MS / 36e5)}h; oldest "${oldest.title}" (${oldest.assigned_to}, ${oldest.status}) ${oldestStuckHours}h`,
+          stuckTasks: stuck.length,
+          oldestStuckHours
+        });
+        process.stderr.write(
+          `[exed] STUCK-TASK ALERT: ${stuck.length} open/blocked task(s) idle > ${Math.round(STUCK_TASK_THRESHOLD_MS / 36e5)}h. Oldest: "${oldest.title}" (assigned ${oldest.assigned_to}, ${oldest.status}, ${oldestStuckHours}h).
+`
+        );
+        recordOrchestrationEventBestEffort({
+          eventType: "task.stuck.detected",
+          source: "task-enforcement.runTaskEnforcementTick",
+          payload: { stuckTasks: stuck.length, oldestStuckHours, oldestTaskId: oldest.id }
+        });
+      }
+    } catch {
+    }
+  }
+  recordOrchestrationEventBestEffort({
+    eventType: "daemon.tick.completed",
+    source: "task-enforcement.runTaskEnforcementTick",
+    durationMs: Date.now() - tickStartedAt,
+    result: processedAnyEmployee ? "processed" : "no_employee_sessions",
+    payload: { sessionCount: sessions.length, processedSessions, nudgesSent }
+  });
+}
+export {
+  IDLE_PATTERNS,
+  MANAGER_GRACE_PERIOD_MS,
+  MANAGER_ROLES,
+  MCP_ZOMBIE_PATTERNS,
+  NUDGE_ECHO_PATTERNS,
+  STUCK_TASK_THRESHOLD_MS,
+  TASK_ENFORCEMENT_DEBOUNCE_MS,
+  TASK_ENFORCEMENT_INTERVAL_MS,
+  _resetNudgeState,
+  decideManagerAction,
+  decideWorkerAction,
+  findStuckTasks,
+  isCurrentlyIdle,
+  isIdlePane,
+  isMcpZombiePane,
+  isNudgeEcho,
+  runTaskEnforcementTick,
+  sendNudge
+};