aoaoe 0.54.0 → 0.56.0

package/README.md

@@ -241,7 +241,9 @@ commands:
   status         quick daemon health check (is it running? what's it doing?)
   config         show the effective resolved config (defaults + file)
   config --validate  validate config + check tool availability
+  config --diff  show only fields that differ from defaults
   notify-test    send a test notification to configured webhooks
+  doctor         comprehensive health check (config, tools, daemon, disk)
   task           manage tasks and sessions (list, start, stop, new, rm, edit)
   tasks          show task progress (from aoaoe.tasks.json)
   history        review recent actions (from ~/.aoaoe/actions.log)

package/dist/config.d.ts

@@ -1,4 +1,5 @@
 import type { AoaoeConfig } from "./types.js";
+export declare const DEFAULTS: AoaoeConfig;
 export declare function findConfigFile(): string | null;
 export declare function configFileExists(): boolean;
 export declare function defaultConfigPath(): string;
@@ -9,6 +10,11 @@ export declare function warnUnknownKeys(raw: unknown, source: string): void;
 export declare function validateConfig(config: AoaoeConfig): void;
 export declare function validateEnvironment(config: AoaoeConfig): Promise<void>;
 export declare function deepMerge(...objects: Record<string, unknown>[]): AoaoeConfig;
+export declare function computeConfigDiff(current: Record<string, unknown>, defaults: Record<string, unknown>, prefix?: string): Array<{
+    path: string;
+    current: unknown;
+    default: unknown;
+}>;
 export declare function parseCliArgs(argv: string[]): {
     overrides: Partial<AoaoeConfig>;
     help: boolean;
@@ -21,7 +27,9 @@ export declare function parseCliArgs(argv: string[]): {
     showStatus: boolean;
     showConfig: boolean;
     configValidate: boolean;
+    configDiff: boolean;
     notifyTest: boolean;
+    runDoctor: boolean;
     runInit: boolean;
     initForce: boolean;
     runTaskCli: boolean;

package/dist/config.js

@@ -9,7 +9,7 @@ const AOAOE_DIR = join(homedir(), ".aoaoe");
 const CONFIG_NAMES = ["aoaoe.config.json", ".aoaoe.json"];
 // search order: ~/.aoaoe/ first (canonical), then cwd (local override for dev)
 const CONFIG_SEARCH_DIRS = [AOAOE_DIR, process.cwd()];
-const DEFAULTS = {
+export const DEFAULTS = {
     reasoner: "opencode",
     pollIntervalMs: 10_000,
     opencode: {
@@ -259,6 +259,31 @@ export function deepMerge(...objects) {
     }
     return result;
 }
+// compute fields that differ between two config objects (flat dot-notation paths)
+// exported for testing
+export function computeConfigDiff(current, defaults, prefix = "") {
+    const diffs = [];
+    const allKeys = new Set([...Object.keys(current), ...Object.keys(defaults)]);
+    for (const key of allKeys) {
+        const fullPath = prefix ? `${prefix}.${key}` : key;
+        const curVal = current[key];
+        const defVal = defaults[key];
+        // both are plain objects — recurse
+        if (curVal && defVal &&
+            typeof curVal === "object" && !Array.isArray(curVal) &&
+            typeof defVal === "object" && !Array.isArray(defVal)) {
+            diffs.push(...computeConfigDiff(curVal, defVal, fullPath));
+            continue;
+        }
+        // compare with JSON.stringify for arrays/objects, === for primitives
+        const curStr = JSON.stringify(curVal);
+        const defStr = JSON.stringify(defVal);
+        if (curStr !== defStr) {
+            diffs.push({ path: fullPath, current: curVal, default: defVal });
+        }
+    }
+    return diffs;
+}
 function log(msg) {
     console.error(`[config] ${msg}`);
 }
@@ -274,7 +299,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, showHistory: false, showStatus: false, showConfig: false, configValidate: false, notifyTest: false, runInit: false, initForce: false, runTaskCli: false };
+    const defaults = { overrides, help: false, version: false, register: false, testContext: false, runTest: false, showTasks: false, showHistory: false, showStatus: false, showConfig: false, configValidate: false, configDiff: false, notifyTest: false, runDoctor: false, runInit: false, initForce: false, runTaskCli: false };
     // check for subcommand as first non-flag arg
     if (argv[2] === "test-context") {
         return { ...defaults, testContext: true };
@@ -296,11 +321,15 @@ export function parseCliArgs(argv) {
     }
     if (argv[2] === "config") {
         const validate = argv.includes("--validate") || argv.includes("-V");
-        return { ...defaults, showConfig: true, configValidate: validate };
+        const diff = argv.includes("--diff");
+        return { ...defaults, showConfig: true, configValidate: validate, configDiff: diff };
     }
     if (argv[2] === "notify-test") {
         return { ...defaults, notifyTest: true };
     }
+    if (argv[2] === "doctor") {
+        return { ...defaults, runDoctor: true };
+    }
     if (argv[2] === "init") {
         const force = argv.includes("--force") || argv.includes("-f");
         return { ...defaults, runInit: true, initForce: force };
@@ -390,7 +419,7 @@ export function parseCliArgs(argv) {
                 break;
         }
     }
-    return { overrides, help, version, register: false, testContext: false, runTest: false, showTasks: false, showHistory: false, showStatus: false, showConfig: false, configValidate: false, notifyTest: false, runInit: false, initForce: false, runTaskCli: false };
+    return { overrides, help, version, register: false, testContext: false, runTest: false, showTasks: false, showHistory: false, showStatus: false, showConfig: false, configValidate: false, configDiff: false, notifyTest: false, runDoctor: false, runInit: false, initForce: false, runTaskCli: false };
 }
 export function printHelp() {
     console.log(`aoaoe - autonomous supervisor for agent-of-empires sessions
@@ -408,8 +437,10 @@ commands:
   (none)         start the supervisor daemon (interactive TUI)
   status         quick daemon health check (is it running? what's it doing?)
   config         show the effective resolved config (defaults + file)
-  config --validate  validate config file + check tool availability
+  config --validate  validate config + check tool availability
+  config --diff  show only fields that differ from defaults
   notify-test    send a test notification to configured webhooks
+  doctor         comprehensive health check (config, tools, daemon, disk)
   task           manage tasks and sessions (list, start, stop, new, rm, edit)
   tasks          show task progress (from aoaoe.tasks.json)
   history        review recent actions (from ~/.aoaoe/actions.log)

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { loadConfig, validateEnvironment, parseCliArgs, printHelp, configFileExists, findConfigFile } from "./config.js";
+import { loadConfig, validateEnvironment, parseCliArgs, printHelp, configFileExists, findConfigFile, DEFAULTS, computeConfigDiff } from "./config.js";
 import { Poller, computeTmuxName } from "./poller.js";
 import { createReasoner } from "./reasoner/index.js";
 import { Executor } from "./executor.js";
@@ -28,7 +28,7 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 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
 async function main() {
-    const { overrides, help, version, register, testContext: isTestContext, runTest, showTasks, showHistory, showStatus, showConfig, configValidate, notifyTest, runInit, initForce, runTaskCli: isTaskCli, registerTitle } = parseCliArgs(process.argv);
+    const { overrides, help, version, register, testContext: isTestContext, runTest, showTasks, showHistory, showStatus, showConfig, configValidate, configDiff, notifyTest, runDoctor, runInit, initForce, runTaskCli: isTaskCli, registerTitle } = parseCliArgs(process.argv);
     if (help) {
         printHelp();
         process.exit(0);
@@ -73,11 +73,14 @@ async function main() {
         showDaemonStatus();
         return;
     }
-    // `aoaoe config` -- show effective resolved config (with optional --validate)
+    // `aoaoe config` -- show effective resolved config (with optional --validate or --diff)
     if (showConfig) {
         if (configValidate) {
             await runConfigValidation();
         }
+        else if (configDiff) {
+            showConfigDiff();
+        }
         else {
             showEffectiveConfig();
         }
@@ -88,6 +91,11 @@ async function main() {
         await runNotifyTest();
         return;
     }
+    // `aoaoe doctor` -- comprehensive health check
+    if (runDoctor) {
+        await runDoctorCheck();
+        return;
+    }
     // `aoaoe task` -- task management CLI
     if (isTaskCli) {
         await runTaskCli(process.argv);
@@ -1243,6 +1251,42 @@ function showDaemonStatus() {
             console.log(`    ${statusIcon} ${BOLD}${s.title}${RESET} (${s.tool}) ${s.status}${userTag}${taskTag}`);
         }
     }
+    // last action from actions.log
+    try {
+        const actionsLogPath = join(homedir(), ".aoaoe", "actions.log");
+        if (existsSync(actionsLogPath)) {
+            const content = readFileSync(actionsLogPath, "utf-8").trim();
+            if (content) {
+                const logLines = content.split("\n").filter((l) => l.trim());
+                // find last non-wait action
+                for (let i = logLines.length - 1; i >= 0; i--) {
+                    try {
+                        const entry = toActionLogEntry(JSON.parse(logLines[i]));
+                        if (!entry || entry.action.action === "wait")
+                            continue;
+                        const ago = Date.now() - entry.timestamp;
+                        const agoStr = ago < 60_000 ? `${Math.floor(ago / 1000)}s ago` :
+                            ago < 3_600_000 ? `${Math.floor(ago / 60_000)}m ago` :
+                                `${Math.floor(ago / 3_600_000)}h ago`;
+                        const icon = entry.success ? `${GREEN}+${RESET}` : `${RED}!${RESET}`;
+                        const session = entry.action.session?.slice(0, 8) ?? entry.action.title ?? "";
+                        const detail = entry.detail.length > 40 ? entry.detail.slice(0, 37) + "..." : entry.detail;
+                        console.log("");
+                        console.log(`  last action: ${icon} ${entry.action.action} ${session} ${DIM}(${agoStr})${RESET}`);
+                        if (detail)
+                            console.log(`    ${DIM}${detail}${RESET}`);
+                        break;
+                    }
+                    catch {
+                        // skip malformed lines
+                    }
+                }
+            }
+        }
+    }
+    catch {
+        // best-effort — actions.log might not exist
+    }
     console.log("");
 }
 // `aoaoe config --validate` -- validate config file, field values, and tool availability
@@ -1363,6 +1407,231 @@ async function runConfigValidation() {
     if (failed > 0)
         process.exit(1);
 }
+// `aoaoe doctor` -- comprehensive health check: config, tools, daemon, disk, sessions
+async function runDoctorCheck() {
+    const pkg = readPkgVersion();
+    let checks = 0;
+    let passed = 0;
+    let warnings = 0;
+    console.log("");
+    console.log(`  aoaoe${pkg ? ` v${pkg}` : ""} — doctor`);
+    console.log(`  ${"─".repeat(50)}`);
+    // ── 1. config ──────────────────────────────────────────────────────────
+    console.log(`\n  ${BOLD}config${RESET}`);
+    const configPath = findConfigFile();
+    checks++;
+    if (configPath) {
+        console.log(`  ${GREEN}✓${RESET} config file: ${configPath}`);
+        passed++;
+    }
+    else {
+        console.log(`  ${YELLOW}!${RESET} no config file (using defaults)`);
+        warnings++;
+    }
+    let config;
+    checks++;
+    try {
+        config = loadConfig();
+        console.log(`  ${GREEN}✓${RESET} config validates OK`);
+        passed++;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.log(`  ${RED}✗${RESET} config invalid: ${msg.split("\n")[0]}`);
+        // use defaults to continue checking other things
+        config = loadConfig({});
+    }
+    // ── 2. tools ───────────────────────────────────────────────────────────
+    console.log(`\n  ${BOLD}tools${RESET}`);
+    const toolChecks = [
+        { cmd: "node", label: "Node.js", versionArg: ["--version"], required: true },
+        { cmd: "aoe", label: "agent-of-empires", versionArg: ["--version"], required: true },
+        { cmd: "tmux", label: "terminal multiplexer", versionArg: ["-V"], required: true },
+    ];
+    if (config.reasoner === "opencode") {
+        toolChecks.push({ cmd: "opencode", label: "OpenCode CLI", versionArg: ["version"], required: true });
+    }
+    else {
+        toolChecks.push({ cmd: "claude", label: "Claude Code CLI", versionArg: ["--version"], required: true });
+    }
+    for (const tool of toolChecks) {
+        checks++;
+        try {
+            const result = await shellExec(tool.cmd, tool.versionArg);
+            const ver = result.stdout.trim().split("\n")[0].slice(0, 60) || result.stderr.trim().split("\n")[0].slice(0, 60);
+            console.log(`  ${GREEN}✓${RESET} ${tool.cmd} — ${ver}`);
+            passed++;
+        }
+        catch {
+            if (tool.required) {
+                console.log(`  ${RED}✗${RESET} ${tool.cmd} not found (${tool.label})`);
+            }
+            else {
+                console.log(`  ${YELLOW}!${RESET} ${tool.cmd} not found (${tool.label}, optional)`);
+                warnings++;
+            }
+        }
+    }
+    // ── 3. reasoner server ─────────────────────────────────────────────────
+    if (config.reasoner === "opencode") {
+        console.log(`\n  ${BOLD}reasoner${RESET}`);
+        checks++;
+        try {
+            const resp = await fetch(`http://127.0.0.1:${config.opencode.port}/health`, {
+                signal: AbortSignal.timeout(3000),
+            });
+            if (resp.ok) {
+                console.log(`  ${GREEN}✓${RESET} opencode serve responding on port ${config.opencode.port}`);
+                passed++;
+            }
+            else {
+                console.log(`  ${YELLOW}!${RESET} opencode serve on port ${config.opencode.port} returned ${resp.status}`);
+                warnings++;
+            }
+        }
+        catch {
+            console.log(`  ${RED}✗${RESET} opencode serve not responding on port ${config.opencode.port}`);
+            console.log(`    ${DIM}start with: opencode serve --port ${config.opencode.port}${RESET}`);
+        }
+    }
+    // ── 4. daemon ──────────────────────────────────────────────────────────
+    console.log(`\n  ${BOLD}daemon${RESET}`);
+    const state = readState();
+    const daemonRunning = isDaemonRunningFromState(state);
+    checks++;
+    if (daemonRunning && state) {
+        console.log(`  ${GREEN}✓${RESET} daemon running (poll #${state.pollCount}, phase: ${state.phase})`);
+        console.log(`    ${state.sessions.length} session(s) monitored`);
+        passed++;
+    }
+    else {
+        console.log(`  ${DIM}○${RESET} daemon not running`);
+        passed++; // not running is fine for doctor — just informational
+    }
+    // lock file check
+    const lockPath = join(homedir(), ".aoaoe", "daemon.lock");
+    if (existsSync(lockPath) && !daemonRunning) {
+        checks++;
+        console.log(`  ${YELLOW}!${RESET} stale lock file found: ${lockPath}`);
+        console.log(`    ${DIM}remove with: rm ${lockPath}${RESET}`);
+        warnings++;
+    }
+    // ── 5. disk / data ─────────────────────────────────────────────────────
+    console.log(`\n  ${BOLD}data${RESET}`);
+    const aoaoeDir = join(homedir(), ".aoaoe");
+    if (existsSync(aoaoeDir)) {
+        checks++;
+        try {
+            const files = await import("node:fs").then(fs => fs.readdirSync(aoaoeDir));
+            let totalSize = 0;
+            for (const f of files) {
+                try {
+                    totalSize += statSync(join(aoaoeDir, f)).size;
+                }
+                catch { /* skip unreadable */ }
+            }
+            const sizeStr = totalSize < 1024 ? `${totalSize}B` :
+                totalSize < 1_048_576 ? `${(totalSize / 1024).toFixed(1)}KB` :
+                    `${(totalSize / 1_048_576).toFixed(1)}MB`;
+            console.log(`  ${GREEN}✓${RESET} ~/.aoaoe/ — ${files.length} files, ${sizeStr}`);
+            passed++;
+        }
+        catch {
+            console.log(`  ${YELLOW}!${RESET} could not read ~/.aoaoe/`);
+            warnings++;
+        }
+        // actions log stats
+        const actionsPath = join(aoaoeDir, "actions.log");
+        if (existsSync(actionsPath)) {
+            checks++;
+            try {
+                const content = readFileSync(actionsPath, "utf-8").trim();
+                const lineCount = content ? content.split("\n").length : 0;
+                const size = statSync(actionsPath).size;
+                const sizeStr = size < 1024 ? `${size}B` : `${(size / 1024).toFixed(1)}KB`;
+                console.log(`  ${GREEN}✓${RESET} actions.log — ${lineCount} entries, ${sizeStr}`);
+                passed++;
+            }
+            catch {
+                console.log(`  ${YELLOW}!${RESET} actions.log unreadable`);
+                warnings++;
+            }
+        }
+    }
+    else {
+        console.log(`  ${DIM}○${RESET} ~/.aoaoe/ does not exist yet (run 'aoaoe init')`);
+    }
+    // ── 6. aoe sessions ───────────────────────────────────────────────────
+    console.log(`\n  ${BOLD}sessions${RESET}`);
+    checks++;
+    try {
+        const listResult = await shellExec("aoe", ["list", "--json"]);
+        if (listResult.exitCode === 0 && listResult.stdout.trim()) {
+            const sessions = JSON.parse(listResult.stdout);
+            if (Array.isArray(sessions) && sessions.length > 0) {
+                console.log(`  ${GREEN}✓${RESET} ${sessions.length} aoe session(s) found`);
+                for (const s of sessions.slice(0, 5)) {
+                    console.log(`    ${DIM}${s.title ?? s.id} (${s.tool ?? "?"})${RESET}`);
+                }
+                if (sessions.length > 5)
+                    console.log(`    ${DIM}...and ${sessions.length - 5} more${RESET}`);
+                passed++;
+            }
+            else {
+                console.log(`  ${DIM}○${RESET} no aoe sessions (start some with 'aoe add')`);
+                passed++;
+            }
+        }
+        else {
+            console.log(`  ${YELLOW}!${RESET} aoe list returned non-zero (is aoe running?)`);
+            warnings++;
+        }
+    }
+    catch {
+        console.log(`  ${RED}✗${RESET} could not run 'aoe list --json'`);
+    }
+    // ── summary ────────────────────────────────────────────────────────────
+    const failed = checks - passed - warnings;
+    console.log("");
+    console.log(`  ${"─".repeat(50)}`);
+    if (failed === 0 && warnings === 0) {
+        console.log(`  ${GREEN}${BOLD}all ${checks} checks passed${RESET} — looking healthy`);
+    }
+    else if (failed === 0) {
+        console.log(`  ${passed}/${checks} passed, ${YELLOW}${warnings} warning(s)${RESET}`);
+    }
+    else {
+        console.log(`  ${passed}/${checks} passed, ${RED}${failed} failed${RESET}${warnings > 0 ? `, ${YELLOW}${warnings} warning(s)${RESET}` : ""}`);
+    }
+    console.log("");
+}
+// `aoaoe config --diff` -- show only fields that differ from defaults
+function showConfigDiff() {
+    const configPath = findConfigFile();
+    const configResult = loadConfig();
+    const { _configPath, ...config } = configResult;
+    const diffs = computeConfigDiff(config, DEFAULTS);
+    console.log("");
+    console.log("  aoaoe — config diff (vs. defaults)");
+    console.log(`  ${"─".repeat(50)}`);
+    console.log(`  source: ${configPath ?? "defaults (no config file found)"}`);
+    console.log("");
+    if (diffs.length === 0) {
+        console.log("  (no differences — config matches defaults)");
+    }
+    else {
+        for (const d of diffs) {
+            const curStr = d.current === undefined ? `${DIM}(not set)${RESET}` : `${GREEN}${JSON.stringify(d.current)}${RESET}`;
+            const defStr = d.default === undefined ? `${DIM}(not set)${RESET}` : `${DIM}${JSON.stringify(d.default)}${RESET}`;
+            console.log(`  ${YELLOW}${d.path}${RESET}`);
+            console.log(`    current:  ${curStr}`);
+            console.log(`    default:  ${defStr}`);
+        }
+        console.log("");
+        console.log(`  ${diffs.length} field(s) differ from defaults`);
+    }
+    console.log("");
+}
 // `aoaoe config` -- show the effective resolved config (defaults + file + any notes)
 function showEffectiveConfig() {
     const configPath = findConfigFile();

package/package.json

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