aoaoe 0.55.0 → 0.57.0

package/README.md

@@ -243,6 +243,11 @@ commands:
   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)
+  logs           show recent conversation log entries
+  logs --actions show action log entries (from ~/.aoaoe/actions.log)
+  logs --grep <pattern>  filter log entries by substring or regex
+  logs -n <count>        number of entries to show (default: 50)
   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

@@ -29,6 +29,11 @@ export declare function parseCliArgs(argv: string[]): {
     configValidate: boolean;
     configDiff: boolean;
     notifyTest: boolean;
+    runDoctor: boolean;
+    runLogs: boolean;
+    logsActions: boolean;
+    logsGrep?: string;
+    logsCount?: number;
     runInit: boolean;
     initForce: boolean;
     runTaskCli: boolean;

package/dist/config.js

@@ -299,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, configDiff: 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, runLogs: false, logsActions: false, logsGrep: undefined, logsCount: undefined, runInit: false, initForce: false, runTaskCli: false };
     // check for subcommand as first non-flag arg
     if (argv[2] === "test-context") {
         return { ...defaults, testContext: true };
@@ -327,6 +327,25 @@ export function parseCliArgs(argv) {
     if (argv[2] === "notify-test") {
         return { ...defaults, notifyTest: true };
     }
+    if (argv[2] === "doctor") {
+        return { ...defaults, runDoctor: true };
+    }
+    if (argv[2] === "logs") {
+        const actions = argv.includes("--actions") || argv.includes("-a");
+        let grep;
+        let count;
+        for (let i = 3; i < argv.length; i++) {
+            if ((argv[i] === "--grep" || argv[i] === "-g") && argv[i + 1]) {
+                grep = argv[++i];
+            }
+            else if ((argv[i] === "-n" || argv[i] === "--count") && argv[i + 1]) {
+                const val = parseInt(argv[++i], 10);
+                if (!isNaN(val) && val > 0)
+                    count = val;
+            }
+        }
+        return { ...defaults, runLogs: true, logsActions: actions, logsGrep: grep, logsCount: count };
+    }
     if (argv[2] === "init") {
         const force = argv.includes("--force") || argv.includes("-f");
         return { ...defaults, runInit: true, initForce: force };
@@ -416,7 +435,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, configDiff: 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, runLogs: false, logsActions: false, logsGrep: undefined, logsCount: undefined, runInit: false, initForce: false, runTaskCli: false };
 }
 export function printHelp() {
     console.log(`aoaoe - autonomous supervisor for agent-of-empires sessions
@@ -437,6 +456,11 @@ commands:
   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)
+  logs           show recent conversation log entries (last 50)
+  logs --actions show action log entries (from ~/.aoaoe/actions.log)
+  logs --grep <pattern>  filter log entries by substring or regex
+  logs -n <count>        number of entries to show (default: 50)
   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)
@@ -463,6 +487,11 @@ options:
 init options:
   --force, -f                        overwrite existing config
 
+logs options:
+  --actions, -a                      show action log instead of conversation log
+  --grep, -g <pattern>               filter entries by substring or regex
+  -n, --count <number>               number of entries to show (default: 50)
+
 register options:
   --title, -t <name>                 session title in AoE (default: aoaoe)
 

package/dist/console.d.ts

@@ -65,5 +65,11 @@ export declare function summarizeRecentActions(logLines: string[], windowMs?: nu
  * Pure function: takes stderr text, returns a plain-English explanation.
  */
 export declare function friendlyError(stderr: string): string;
+/**
+ * Filter log lines by a grep pattern (substring or regex).
+ * Tries the pattern as a regex first; falls back to plain case-insensitive substring match
+ * if the pattern is not valid regex syntax.
+ */
+export declare function filterLogLines(lines: string[], pattern: string): string[];
 export declare function colorizeConsoleLine(line: string): string;
 //# sourceMappingURL=console.d.ts.map

package/dist/console.js

@@ -365,6 +365,25 @@ export function friendlyError(stderr) {
     const firstLine = s.split("\n")[0].trim();
     return firstLine.length > 120 ? firstLine.slice(0, 117) + "..." : firstLine;
 }
+/**
+ * Filter log lines by a grep pattern (substring or regex).
+ * Tries the pattern as a regex first; falls back to plain case-insensitive substring match
+ * if the pattern is not valid regex syntax.
+ */
+export function filterLogLines(lines, pattern) {
+    let re = null;
+    try {
+        re = new RegExp(pattern, "i");
+    }
+    catch {
+        // invalid regex — use substring
+    }
+    return lines.filter((line) => {
+        if (re)
+            return re.test(line);
+        return line.toLowerCase().includes(pattern.toLowerCase());
+    });
+}
 // colorize a single console line for inline terminal output
 // applied to each line as it's written (not batch like chat.ts colorize)
 export function colorizeConsoleLine(line) {

package/dist/index.js

@@ -7,7 +7,7 @@ import { printDashboard } from "./dashboard.js";
 import { InputReader } from "./input.js";
 import { ReasonerConsole } from "./console.js";
 import { writeState, buildSessionStates, checkInterrupt, clearInterrupt, cleanupState, acquireLock, readState } from "./daemon-state.js";
-import { formatSessionSummaries, formatActionDetail, formatPlainEnglishAction, narrateObservation, summarizeRecentActions, friendlyError } from "./console.js";
+import { formatSessionSummaries, formatActionDetail, formatPlainEnglishAction, narrateObservation, summarizeRecentActions, friendlyError, colorizeConsoleLine, filterLogLines } from "./console.js";
 import { loadGlobalContext, resolveProjectDirWithSource, discoverContextFiles, loadSessionContext } from "./context.js";
 import { tick as loopTick } from "./loop.js";
 import { exec as shellExec } from "./shell.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, configDiff, 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, runLogs, logsActions, logsGrep, logsCount, runInit, initForce, runTaskCli: isTaskCli, registerTitle } = parseCliArgs(process.argv);
     if (help) {
         printHelp();
         process.exit(0);
@@ -91,6 +91,16 @@ async function main() {
         await runNotifyTest();
         return;
     }
+    // `aoaoe doctor` -- comprehensive health check
+    if (runDoctor) {
+        await runDoctorCheck();
+        return;
+    }
+    // `aoaoe logs` -- show conversation or action log entries
+    if (runLogs) {
+        await showLogs(logsActions, logsGrep, logsCount);
+        return;
+    }
     // `aoaoe task` -- task management CLI
     if (isTaskCli) {
         await runTaskCli(process.argv);
@@ -1183,6 +1193,104 @@ async function showActionHistory() {
     console.log(`  breakdown: ${breakdown}`);
     console.log("");
 }
+// `aoaoe logs` -- show conversation or action log entries
+async function showLogs(actions, grep, count) {
+    const n = count ?? 50;
+    if (actions) {
+        // show action log entries (JSONL from ~/.aoaoe/actions.log)
+        const logFile = join(homedir(), ".aoaoe", "actions.log");
+        if (!existsSync(logFile)) {
+            console.log("no action log found (no actions have been taken yet)");
+            return;
+        }
+        let lines;
+        try {
+            lines = readFileSync(logFile, "utf-8").trim().split("\n").filter((l) => l.trim());
+        }
+        catch {
+            console.error("failed to read action log");
+            return;
+        }
+        if (lines.length === 0) {
+            console.log("action log is empty");
+            return;
+        }
+        // apply grep filter before slicing
+        if (grep) {
+            lines = filterLogLines(lines, grep);
+            if (lines.length === 0) {
+                console.log(`no action log entries matching '${grep}'`);
+                return;
+            }
+        }
+        const recent = lines.slice(-n);
+        console.log("");
+        console.log(`  action log (last ${recent.length} of ${lines.length}${grep ? ` matching '${grep}'` : ""})`);
+        console.log(`  ${"─".repeat(70)}`);
+        for (const line of recent) {
+            try {
+                const entry = toActionLogEntry(JSON.parse(line));
+                if (!entry)
+                    continue;
+                const time = new Date(entry.timestamp).toLocaleTimeString();
+                const date = new Date(entry.timestamp).toLocaleDateString();
+                const icon = entry.success ? `${GREEN}+${RESET}` : `${RED}!${RESET}`;
+                const actionName = entry.action.action;
+                const session = entry.action.session?.slice(0, 8) ?? entry.action.title ?? "";
+                const detail = entry.detail.length > 50 ? entry.detail.slice(0, 47) + "..." : entry.detail;
+                console.log(`  ${icon} ${DIM}${date} ${time}${RESET}  ${YELLOW}${actionName.padEnd(16)}${RESET} ${session.padEnd(10)} ${detail}`);
+            }
+            catch {
+                // skip unparseable lines
+            }
+        }
+        console.log(`  ${"─".repeat(70)}`);
+        console.log("");
+    }
+    else {
+        // show conversation log entries (text from ~/.aoaoe/conversation.log)
+        const logFile = join(homedir(), ".aoaoe", "conversation.log");
+        if (!existsSync(logFile)) {
+            console.log("no conversation log found (daemon hasn't run yet)");
+            return;
+        }
+        let lines;
+        try {
+            const content = readFileSync(logFile, "utf-8");
+            lines = content.split("\n");
+        }
+        catch {
+            console.error("failed to read conversation log");
+            return;
+        }
+        // remove trailing empty line from split
+        if (lines.length > 0 && lines[lines.length - 1] === "") {
+            lines.pop();
+        }
+        if (lines.length === 0) {
+            console.log("conversation log is empty");
+            return;
+        }
+        // apply grep filter before slicing
+        if (grep) {
+            lines = filterLogLines(lines, grep);
+            if (lines.length === 0) {
+                console.log(`no conversation log entries matching '${grep}'`);
+                return;
+            }
+        }
+        const recent = lines.slice(-n);
+        console.log("");
+        console.log(`  conversation log (last ${recent.length} of ${lines.length}${grep ? ` matching '${grep}'` : ""})`);
+        console.log(`  ${"─".repeat(70)}`);
+        // colorize using the same function as the inline console output
+        for (const line of recent) {
+            console.log(`  ${colorizeConsoleLine(line)}`);
+        }
+        console.log(`  ${"─".repeat(70)}`);
+        console.log("");
+    }
+}
 // `aoaoe test` -- dynamically import and run the integration test
 async function runIntegrationTest() {
     const testModule = resolve(__dirname, "integration-test.js");
@@ -1402,6 +1510,204 @@ 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();

package/package.json

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