aoaoe 0.187.0 → 0.188.0

package/dist/config.d.ts

@@ -25,6 +25,8 @@ export declare function parseCliArgs(argv: string[]): {
     showTasks: boolean;
     showTasksJson: boolean;
     runProgress: boolean;
+    runHealth: boolean;
+    healthJson: boolean;
     progressSince?: string;
     progressJson: boolean;
     showHistory: boolean;

package/dist/config.js

@@ -331,7 +331,7 @@ export function parseCliArgs(argv) {
     let initForce = false;
     let runTaskCli = false;
     let registerTitle;
-    const defaults = { overrides, help: false, version: false, register: false, testContext: false, runTest: false, showTasks: false, showTasksJson: false, runProgress: false, progressSince: undefined, progressJson: false, showHistory: false, showStatus: false, runRunbook: false, runbookJson: false, runbookSection: undefined, runIncident: false, incidentSince: undefined, incidentLimit: undefined, incidentJson: false, incidentNdjson: false, incidentWatch: false, incidentChangesOnly: false, incidentHeartbeatSec: undefined, incidentIntervalMs: undefined, runSupervisor: false, supervisorAll: false, supervisorSince: undefined, supervisorLimit: undefined, supervisorJson: false, supervisorNdjson: false, supervisorWatch: false, supervisorChangesOnly: false, supervisorHeartbeatSec: undefined, supervisorIntervalMs: undefined, showConfig: false, configValidate: false, configDiff: false, notifyTest: false, runDoctor: false, runLogs: false, logsActions: false, logsGrep: undefined, logsCount: undefined, runExport: false, exportFormat: undefined, exportOutput: undefined, exportLast: undefined, runInit: false, initForce: false, runTaskCli: false, runTail: false, tailFollow: false, tailCount: undefined, runStats: false, statsLast: undefined, runReplay: false, replaySpeed: undefined, replayLast: undefined };
+    const defaults = { overrides, help: false, version: false, register: false, testContext: false, runTest: false, showTasks: false, showTasksJson: false, runProgress: false, progressSince: undefined, progressJson: false, runHealth: false, healthJson: false, showHistory: false, showStatus: false, runRunbook: false, runbookJson: false, runbookSection: undefined, runIncident: false, incidentSince: undefined, incidentLimit: undefined, incidentJson: false, incidentNdjson: false, incidentWatch: false, incidentChangesOnly: false, incidentHeartbeatSec: undefined, incidentIntervalMs: undefined, runSupervisor: false, supervisorAll: false, supervisorSince: undefined, supervisorLimit: undefined, supervisorJson: false, supervisorNdjson: false, supervisorWatch: false, supervisorChangesOnly: false, supervisorHeartbeatSec: undefined, supervisorIntervalMs: undefined, showConfig: false, configValidate: false, configDiff: false, notifyTest: false, runDoctor: false, runLogs: false, logsActions: false, logsGrep: undefined, logsCount: undefined, runExport: false, exportFormat: undefined, exportOutput: undefined, exportLast: undefined, runInit: false, initForce: false, runTaskCli: false, runTail: false, tailFollow: false, tailCount: undefined, runStats: false, statsLast: undefined, runReplay: false, replaySpeed: undefined, replayLast: undefined };
     // check for subcommand as first non-flag arg
     if (argv[2] === "test-context") {
         return { ...defaults, testContext: true };
@@ -355,6 +355,10 @@ export function parseCliArgs(argv) {
         }
         return { ...defaults, runProgress: true, progressSince: since, progressJson: json };
     }
+    if (argv[2] === "health") {
+        const json = argv.includes("--json");
+        return { ...defaults, runHealth: true, healthJson: json };
+    }
     if (argv[2] === "history") {
         return { ...defaults, showHistory: true };
     }
@@ -700,7 +704,7 @@ export function parseCliArgs(argv) {
                 break;
         }
     }
-    return { overrides, help, version, register: false, testContext: false, runTest: false, showTasks: false, showTasksJson: false, runProgress: false, progressSince: undefined, progressJson: false, showHistory: false, showStatus: false, runRunbook: false, runbookJson: false, runbookSection: undefined, runIncident: false, incidentSince: undefined, incidentLimit: undefined, incidentJson: false, incidentNdjson: false, incidentWatch: false, incidentChangesOnly: false, incidentHeartbeatSec: undefined, incidentIntervalMs: undefined, runSupervisor: false, supervisorAll: false, supervisorSince: undefined, supervisorLimit: undefined, supervisorJson: false, supervisorNdjson: false, supervisorWatch: false, supervisorChangesOnly: false, supervisorHeartbeatSec: undefined, supervisorIntervalMs: undefined, showConfig: false, configValidate: false, configDiff: false, notifyTest: false, runDoctor: false, runLogs: false, logsActions: false, logsGrep: undefined, logsCount: undefined, runExport: false, exportFormat: undefined, exportOutput: undefined, exportLast: undefined, runInit: false, initForce: false, runTaskCli: false, runTail: false, tailFollow: false, tailCount: undefined, runStats: false, statsLast: undefined, runReplay: false, replaySpeed: undefined, replayLast: undefined };
+    return { overrides, help, version, register: false, testContext: false, runTest: false, showTasks: false, showTasksJson: false, runProgress: false, progressSince: undefined, progressJson: false, runHealth: false, healthJson: false, showHistory: false, showStatus: false, runRunbook: false, runbookJson: false, runbookSection: undefined, runIncident: false, incidentSince: undefined, incidentLimit: undefined, incidentJson: false, incidentNdjson: false, incidentWatch: false, incidentChangesOnly: false, incidentHeartbeatSec: undefined, incidentIntervalMs: undefined, runSupervisor: false, supervisorAll: false, supervisorSince: undefined, supervisorLimit: undefined, supervisorJson: false, supervisorNdjson: false, supervisorWatch: false, supervisorChangesOnly: false, supervisorHeartbeatSec: undefined, supervisorIntervalMs: undefined, showConfig: false, configValidate: false, configDiff: false, notifyTest: false, runDoctor: false, runLogs: false, logsActions: false, logsGrep: undefined, logsCount: undefined, runExport: false, exportFormat: undefined, exportOutput: undefined, exportLast: undefined, runInit: false, initForce: false, runTaskCli: false, runTail: false, tailFollow: false, tailCount: undefined, runStats: false, statsLast: undefined, runReplay: false, replaySpeed: undefined, replayLast: undefined };
 }
 export function printHelp() {
     console.log(`aoaoe - autonomous supervisor for agent-of-empires sessions
@@ -768,6 +772,8 @@ commands:
   progress       per-session accomplishment digest (last 24h)
   progress --since <duration>  filter progress window (1h, 8h, 7d)
   progress --json              machine-readable progress output
+  health         per-session health scores (0-100, fleet average)
+  health --json  machine-readable health output
   history        review recent actions (from ~/.aoaoe/actions.log)
   test           run integration test (creates sessions, tests, cleans up)
   test-context   scan sessions + context files (read-only, no LLM, safe)

package/dist/index.js

@@ -26,7 +26,7 @@ import { loadTuiHistory, searchHistory, TUI_HISTORY_FILE, computeHistoryStats }
 import { appendSupervisorEvent, loadSupervisorEvents } from "./supervisor-history.js";
 import { savePreset, deletePreset, getPreset, formatPresetList } from "./pin-presets.js";
 import { resolvePromptTemplate, formatPromptTemplateList } from "./reasoner/prompt-templates.js";
-import { formatHealthReport } from "./health-score.js";
+import { formatHealthReport, computeAllHealth } from "./health-score.js";
 import { ConfigWatcher, formatConfigChange } from "./config-watcher.js";
 import { parseActionLogEntries, parseActivityEntries, mergeTimeline, filterByAge, parseDuration, formatTimelineJson, formatTimelineMarkdown } from "./export.js";
 import { actionSession, actionDetail, toActionLogEntry } from "./types.js";
@@ -40,7 +40,7 @@ const AOAOE_DIR = join(homedir(), ".aoaoe"); // watch dir for wakeable sleep
 const INPUT_FILE = join(AOAOE_DIR, "pending-input.txt"); // file IPC from chat.ts
 const TASK_RECONCILE_EVERY_POLLS = 6;
 async function main() {
-    const { overrides, help, version, register, testContext: isTestContext, runTest, showTasks, showTasksJson, runProgress, progressSince, progressJson, showHistory, showStatus, runRunbook, runbookJson, runbookSection, runIncident, incidentSince, incidentLimit, incidentJson, incidentNdjson, incidentWatch, incidentChangesOnly, incidentHeartbeatSec, incidentIntervalMs, runSupervisor, supervisorAll, supervisorSince, supervisorLimit, supervisorJson, supervisorNdjson, supervisorWatch, supervisorChangesOnly, supervisorHeartbeatSec, supervisorIntervalMs, showConfig, configValidate, configDiff, notifyTest, runDoctor, runLogs, logsActions, logsGrep, logsCount, runExport, exportFormat, exportOutput, exportLast, runInit, initForce, runTaskCli: isTaskCli, runTail: isTail, tailFollow, tailCount, runStats: isStats, statsLast, runReplay: isReplay, replaySpeed, replayLast, registerTitle } = parseCliArgs(process.argv);
+    const { overrides, help, version, register, testContext: isTestContext, runTest, showTasks, showTasksJson, runProgress, progressSince, progressJson, runHealth, healthJson, showHistory, showStatus, runRunbook, runbookJson, runbookSection, runIncident, incidentSince, incidentLimit, incidentJson, incidentNdjson, incidentWatch, incidentChangesOnly, incidentHeartbeatSec, incidentIntervalMs, runSupervisor, supervisorAll, supervisorSince, supervisorLimit, supervisorJson, supervisorNdjson, supervisorWatch, supervisorChangesOnly, supervisorHeartbeatSec, supervisorIntervalMs, showConfig, configValidate, configDiff, notifyTest, runDoctor, runLogs, logsActions, logsGrep, logsCount, runExport, exportFormat, exportOutput, exportLast, runInit, initForce, runTaskCli: isTaskCli, runTail: isTail, tailFollow, tailCount, runStats: isStats, statsLast, runReplay: isReplay, replaySpeed, replayLast, registerTitle } = parseCliArgs(process.argv);
     if (help) {
         printHelp();
         process.exit(0);
@@ -80,6 +80,11 @@ async function main() {
         await showProgressDigest(progressSince, progressJson);
         return;
     }
+    // `aoaoe health` -- per-session health scores
+    if (runHealth) {
+        showHealthStatus(healthJson);
+        return;
+    }
     // `aoaoe history` -- review recent actions
     if (showHistory) {
         await showActionHistory();
@@ -4415,6 +4420,29 @@ async function showProgressDigest(since, asJson = false) {
     }
     console.log(formatProgressDigest(tasks, maxAgeMs));
 }
+function showHealthStatus(asJson = false) {
+    const basePath = process.cwd();
+    const defs = loadTaskDefinitions(basePath);
+    const taskProfiles = resolveProfiles(loadConfig());
+    const tm = defs.length > 0 ? new TaskManager(basePath, defs, taskProfiles) : undefined;
+    const tasks = tm?.tasks ?? [];
+    if (tasks.length === 0) {
+        if (asJson) {
+            console.log("[]");
+            return;
+        }
+        console.log("no tasks defined.");
+        return;
+    }
+    if (asJson) {
+        const healths = computeAllHealth(tasks);
+        console.log(JSON.stringify(healths, null, 2));
+        return;
+    }
+    console.log("");
+    console.log(formatHealthReport(tasks));
+    console.log("");
+}
 // `aoaoe history` -- review recent actions from the persistent action log
 async function showActionHistory() {
     const logFile = join(homedir(), ".aoaoe", "actions.log");
@@ -5253,6 +5281,47 @@ async function runDoctorCheck() {
     catch {
         console.log(`  ${RED}✗${RESET} could not run 'aoe list --json'`);
     }
+    // ── 7. tasks ────────────────────────────────────────────────────────────
+    console.log(`\n  ${BOLD}tasks${RESET}`);
+    checks++;
+    try {
+        const defs = loadTaskDefinitions(process.cwd());
+        const taskProfiles = resolveProfiles(config);
+        if (defs.length === 0) {
+            console.log(`  ${DIM}○${RESET} no task definitions (create aoaoe.tasks.json or run 'aoaoe init')`);
+            passed++;
+        }
+        else {
+            const tm = new TaskManager(process.cwd(), defs, taskProfiles);
+            const tasks = tm.tasks;
+            const active = tasks.filter((t) => t.status === "active").length;
+            const pending = tasks.filter((t) => t.status === "pending").length;
+            const paused = tasks.filter((t) => t.status === "paused").length;
+            const completed = tasks.filter((t) => t.status === "completed").length;
+            const stuck = tasks.filter((t) => t.status === "active" && t.lastProgressAt && (Date.now() - t.lastProgressAt > 30 * 60_000)).length;
+            console.log(`  ${GREEN}✓${RESET} ${tasks.length} task(s): ${active} active, ${pending} pending, ${paused} paused, ${completed} completed`);
+            if (stuck > 0) {
+                console.log(`  ${YELLOW}!${RESET} ${stuck} task(s) possibly stuck (no progress >30min)`);
+                warnings++;
+            }
+            // check for untracked sessions
+            try {
+                const liveStatus = await probeLiveSessionStatus();
+                const trackedTitles = new Set(tasks.map((t) => t.sessionTitle.toLowerCase()));
+                const untracked = [...liveStatus.keys()].filter((t) => !trackedTitles.has(t));
+                if (untracked.length > 0) {
+                    console.log(`  ${YELLOW}!${RESET} ${untracked.length} untracked session(s): ${untracked.join(", ")}`);
+                    console.log(`    ${DIM}adopt with: /task <name> :: <goal>${RESET}`);
+                    warnings++;
+                }
+            }
+            catch { /* aoe not available */ }
+            passed++;
+        }
+    }
+    catch (err) {
+        console.log(`  ${RED}✗${RESET} task check failed: ${err instanceof Error ? err.message : err}`);
+    }
     // ── summary ────────────────────────────────────────────────────────────
     const failed = checks - passed - warnings;
     console.log("");

package/dist/reasoner/opencode.js

@@ -140,6 +140,24 @@ export class OpencodeReasoner {
                 if (errMsg.includes("401") || errMsg.includes("Unauthorized")) {
                     this.log("hint: auth token may be expired — run `opencode auth login` to re-authenticate");
                 }
+                // auto-restart opencode server on persistent 500s (likely stale state)
+                if (errMsg.includes("500") || errMsg.includes("ECONNREFUSED")) {
+                    this.log("opencode server appears unhealthy — attempting restart");
+                    this.killOrphanedServer();
+                    try {
+                        await this.startServer(this.config.opencode.port);
+                        for (let i = 0; i < 15; i++) {
+                            if (await this.tryConnect(this.config.opencode.port)) {
+                                this.log("opencode server restarted successfully");
+                                break;
+                            }
+                            await sleep(1000);
+                        }
+                    }
+                    catch (restartErr) {
+                        this.log(`opencode server restart failed: ${restartErr}`);
+                    }
+                }
                 this.sessionId = null;
                 this.messageCount = 0;
                 return { actions: [{ action: "wait", reason: "SDK session error" }] };
@@ -254,8 +272,10 @@ class OpencodeClient {
             headers: { "Content-Type": "application/json" },
             body: JSON.stringify({ title }),
         });
-        if (!res.ok)
-            throw new Error(`create session failed: ${res.status}`);
+        if (!res.ok) {
+            const body = await res.text().catch(() => "(no body)");
+            throw new Error(`create session failed: ${res.status} ${res.statusText} — ${body.slice(0, 200)}`);
+        }
         return (await res.json());
     }
     async sendMessage(sessionId, text, noReply, signal) {
@@ -268,8 +288,10 @@ class OpencodeClient {
             }),
             signal,
         });
-        if (!res.ok)
-            throw new Error(`send message failed: ${res.status}`);
+        if (!res.ok) {
+            const body = await res.text().catch(() => "(no body)");
+            throw new Error(`send message failed: ${res.status} ${res.statusText} — ${body.slice(0, 200)}`);
+        }
         if (noReply)
             return "";
         const data = (await res.json());

package/dist/wake.d.ts

@@ -5,12 +5,13 @@ export interface WakeResult {
 }
 /**
  * Sleep for up to `ms` milliseconds, but wake early if:
- * - a file change is detected in `watchDir` (returns "wake")
+ * - a relevant file change is detected in `watchDir` (returns "wake")
  * - the AbortSignal fires (returns "abort")
  * - the timeout expires naturally (returns "timeout")
  *
  * Uses fs.watch on the directory — fires when pending-input.txt is written
- * or the interrupt flag file is created. No polling.
+ * or the interrupt flag file is created. Ignores daemon-state.json and other
+ * internal files to prevent wake storms.
  */
-export declare function wakeableSleep(ms: number, watchDir: string, signal?: AbortSignal): Promise<WakeResult>;
+export declare function wakeableSleep(ms: number, watchDir: string, signal?: AbortSignal, minWakeIntervalMs?: number): Promise<WakeResult>;
 //# sourceMappingURL=wake.d.ts.map

package/dist/wake.js

@@ -2,19 +2,29 @@
 // that wakes immediately when files appear in the watch directory.
 // this drops message latency from up to 10s (full poll interval) to ~100ms.
 import { watch } from "node:fs";
+// minimum interval between wake events — prevents storm from daemon-state.json writes
+const MIN_WAKE_INTERVAL_MS = 2000;
+// files that should trigger a wake (user input, interrupt flag)
+// daemon-state.json and supervisor-history.jsonl are excluded to prevent wake storms
+const WAKE_FILES = new Set([
+    "pending-input.txt",
+    "interrupt",
+]);
 /**
  * Sleep for up to `ms` milliseconds, but wake early if:
- * - a file change is detected in `watchDir` (returns "wake")
+ * - a relevant file change is detected in `watchDir` (returns "wake")
  * - the AbortSignal fires (returns "abort")
  * - the timeout expires naturally (returns "timeout")
  *
  * Uses fs.watch on the directory — fires when pending-input.txt is written
- * or the interrupt flag file is created. No polling.
+ * or the interrupt flag file is created. Ignores daemon-state.json and other
+ * internal files to prevent wake storms.
  */
-export function wakeableSleep(ms, watchDir, signal) {
+export function wakeableSleep(ms, watchDir, signal, minWakeIntervalMs = MIN_WAKE_INTERVAL_MS) {
     return new Promise((resolve) => {
         const start = Date.now();
         let settled = false;
+        let lastWakeAt = 0;
         const settle = (reason) => {
             if (settled)
                 return;
@@ -27,7 +37,15 @@ export function wakeableSleep(ms, watchDir, signal) {
         // fs.watch on directory — fires on any file create/rename/change
         let watcher = null;
         try {
-            watcher = watch(watchDir, { persistent: false }, (_event, _filename) => {
+            watcher = watch(watchDir, { persistent: false }, (_event, filename) => {
+                // only wake for relevant files (user input, interrupt) — not internal state files
+                if (filename && !WAKE_FILES.has(filename))
+                    return;
+                // debounce: don't wake more than once per minWakeIntervalMs
+                const now = Date.now();
+                if (now - lastWakeAt < minWakeIntervalMs)
+                    return;
+                lastWakeAt = now;
                 settle("wake");
             });
             // fs.watch can emit 'error' on broken watchers (e.g. dir deleted)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aoaoe",
-  "version": "0.187.0",
+  "version": "0.188.0",
   "description": "Autonomous supervisor for agent-of-empires sessions using OpenCode or Claude Code",
   "type": "module",
   "main": "dist/index.js",