aoaoe 0.49.0 → 0.51.0

package/dist/chat.js

@@ -53,8 +53,9 @@ function main() {
                 lastSize = currSize;
             }
         }
-        catch {
+        catch (e) {
             // file may be truncated or removed — reset so we pick up from start of new file
+            console.error(`[chat] conversation log read failed: ${e}`);
             lastSize = 0;
         }
     };
@@ -341,7 +342,8 @@ async function captureTmuxPane(tmuxName) {
         const result = await exec("tmux", ["capture-pane", "-t", tmuxName, "-p", "-S", "-100"], 5_000);
         return result.exitCode === 0 ? result.stdout : null;
     }
-    catch {
+    catch (e) {
+        console.error(`[chat] tmux capture-pane failed for ${tmuxName}: ${e}`);
         return null;
     }
 }
@@ -437,7 +439,9 @@ function appendToInput(msg) {
     try {
         appendFileSync(INPUT_FILE, msg + "\n");
     }
-    catch { }
+    catch (e) {
+        console.error(`[chat] pending-input write failed: ${e}`);
+    }
 }
 function replayLog() {
     if (!existsSync(CONVO_LOG))
@@ -449,7 +453,9 @@ function replayLog() {
             console.log(`${DIM}--- end of history ---${RESET}\n`);
         }
     }
-    catch { }
+    catch (e) {
+        console.error(`[chat] conversation log replay failed: ${e}`);
+    }
 }
 export function colorize(text) {
     // first pass: colorize tick separator lines (──── tick #N ────)

package/dist/config.d.ts

@@ -2,7 +2,10 @@ import type { AoaoeConfig } from "./types.js";
 export declare function findConfigFile(): string | null;
 export declare function configFileExists(): boolean;
 export declare function defaultConfigPath(): string;
-export declare function loadConfig(overrides?: Partial<AoaoeConfig>): AoaoeConfig;
+export declare function loadConfig(overrides?: Partial<AoaoeConfig>): AoaoeConfig & {
+    _configPath?: string;
+};
+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;
@@ -15,6 +18,8 @@ export declare function parseCliArgs(argv: string[]): {
     runTest: boolean;
     showTasks: boolean;
     showHistory: boolean;
+    showStatus: boolean;
+    showConfig: boolean;
     runInit: boolean;
     initForce: boolean;
     runTaskCli: boolean;

package/dist/config.js

@@ -61,16 +61,56 @@ export function loadConfig(overrides) {
     const found = findConfigFile();
     if (found) {
         try {
-            fileConfig = JSON.parse(readFileSync(found, "utf-8"));
+            const raw = JSON.parse(readFileSync(found, "utf-8"));
+            warnUnknownKeys(raw, found);
+            fileConfig = raw;
             log(`loaded config from ${found}`);
         }
         catch (e) {
-            console.error(`warning: failed to parse ${found}, using defaults`);
+            if (e instanceof SyntaxError) {
+                console.error(`warning: failed to parse ${found}, using defaults`);
+            }
+            else {
+                throw e; // re-throw validation errors from warnUnknownKeys
+            }
         }
     }
     const config = deepMerge(DEFAULTS, fileConfig, (overrides ?? {}));
     validateConfig(config);
-    return config;
+    return { ...config, _configPath: found ?? undefined };
+}
+// known top-level and nested config keys — used to warn on typos
+const KNOWN_KEYS = {
+    reasoner: true, pollIntervalMs: true, captureLinesCount: true,
+    verbose: true, dryRun: true, observe: true, confirm: true,
+    contextFiles: true, sessionDirs: true, protectedSessions: true,
+    opencode: new Set(["port", "model"]),
+    claudeCode: new Set(["model", "yolo", "resume"]),
+    aoe: new Set(["profile"]),
+    policies: new Set([
+        "maxIdleBeforeNudgeMs", "maxErrorsBeforeRestart", "autoAnswerPermissions",
+        "actionCooldownMs", "userActivityThresholdMs", "allowDestructive",
+    ]),
+};
+export function warnUnknownKeys(raw, source) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return;
+    const obj = raw;
+    for (const key of Object.keys(obj)) {
+        if (!(key in KNOWN_KEYS)) {
+            console.error(`warning: unknown config key "${key}" in ${source} (typo?)`);
+            continue;
+        }
+        // check nested keys for known sub-objects
+        const schema = KNOWN_KEYS[key];
+        if (schema instanceof Set && obj[key] && typeof obj[key] === "object" && !Array.isArray(obj[key])) {
+            for (const subKey of Object.keys(obj[key])) {
+                if (!schema.has(subKey)) {
+                    console.error(`warning: unknown config key "${key}.${subKey}" in ${source} (typo?)`);
+                }
+            }
+        }
+    }
 }
 // validate config values to catch bad configs at startup rather than runtime
 export function validateConfig(config) {
@@ -205,7 +245,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, 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, runInit: false, initForce: false, runTaskCli: false };
     // check for subcommand as first non-flag arg
     if (argv[2] === "test-context") {
         return { ...defaults, testContext: true };
@@ -222,6 +262,12 @@ export function parseCliArgs(argv) {
     if (argv[2] === "history") {
         return { ...defaults, showHistory: true };
     }
+    if (argv[2] === "status") {
+        return { ...defaults, showStatus: true };
+    }
+    if (argv[2] === "config") {
+        return { ...defaults, showConfig: true };
+    }
     if (argv[2] === "init") {
         const force = argv.includes("--force") || argv.includes("-f");
         return { ...defaults, runInit: true, initForce: force };
@@ -311,7 +357,7 @@ export function parseCliArgs(argv) {
                 break;
         }
     }
-    return { overrides, help, version, register: false, testContext: false, runTest: false, showTasks: false, showHistory: 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, runInit: false, initForce: false, runTaskCli: false };
 }
 export function printHelp() {
     console.log(`aoaoe - autonomous supervisor for agent-of-empires sessions
@@ -327,6 +373,8 @@ getting started:
 commands:
   init           detect tools + sessions, import history, generate config
   (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)
   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/console.js

@@ -91,7 +91,8 @@ export class ReasonerConsole {
             const st = statSync(INPUT_FILE);
             return st.size > 0;
         }
-        catch {
+        catch (e) {
+            console.error(`[console] pending-input size check failed: ${e}`);
             return false;
         }
     }
@@ -133,7 +134,9 @@ export class ReasonerConsole {
         try {
             appendFileSync(CONVO_LOG, line + "\n");
         }
-        catch { }
+        catch (e) {
+            console.error(`[console] conversation log write failed: ${e}`);
+        }
         // in inline mode, also print colorized output to stderr
         if (this.inlineMode) {
             process.stderr.write(colorizeConsoleLine(line) + "\n");

package/dist/context.js

@@ -78,7 +78,8 @@ export function readContextFile(filePath) {
         evictCache();
         return content;
     }
-    catch {
+    catch (e) {
+        console.error(`[context] context file read failed for ${filePath}: ${e}`);
         return "";
     }
 }
@@ -109,8 +110,9 @@ export function discoverContextFiles(dir) {
                 seenInodes.add(inodeKey);
             }
         }
-        catch {
+        catch (e) {
             // stat failed — still add by path to avoid silently dropping
+            console.error(`[context] inode de-dup stat failed for ${resolved}: ${e}`);
         }
         seenPaths.add(resolved);
         found.push(filePath);

package/dist/executor.js

@@ -164,7 +164,8 @@ export class Executor {
                 return this.logAction({ action: "create_agent", path, title, tool }, false, `path is not a directory: ${path}`);
             }
         }
-        catch {
+        catch (e) {
+            console.error(`[executor] statSync failed for create_agent path ${path}: ${e}`);
             return this.logAction({ action: "create_agent", path, title, tool }, false, `cannot stat path: ${path}`);
         }
         // validate tool name
@@ -281,7 +282,9 @@ export class Executor {
                 this.rotateLogIfNeeded();
                 appendFileSync(LOG_FILE, JSON.stringify(entry) + "\n");
             }
-            catch { } // best-effort, don't crash the daemon
+            catch (e) {
+                console.error(`[executor] action log write failed: ${e}`);
+            } // best-effort, don't crash the daemon
         }
         return entry;
     }

package/dist/index.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-import { loadConfig, validateEnvironment, parseCliArgs, printHelp, configFileExists } from "./config.js";
+import { loadConfig, validateEnvironment, parseCliArgs, printHelp, configFileExists, findConfigFile } from "./config.js";
 import { Poller, computeTmuxName } from "./poller.js";
 import { createReasoner } from "./reasoner/index.js";
 import { Executor } from "./executor.js";
 import { printDashboard } from "./dashboard.js";
 import { InputReader } from "./input.js";
 import { ReasonerConsole } from "./console.js";
-import { writeState, buildSessionStates, checkInterrupt, clearInterrupt, cleanupState, acquireLock } from "./daemon-state.js";
+import { writeState, buildSessionStates, checkInterrupt, clearInterrupt, cleanupState, acquireLock, readState } from "./daemon-state.js";
 import { formatSessionSummaries, formatActionDetail, formatPlainEnglishAction, narrateObservation, summarizeRecentActions, friendlyError } from "./console.js";
 import { loadGlobalContext, resolveProjectDirWithSource, discoverContextFiles, loadSessionContext } from "./context.js";
 import { tick as loopTick } from "./loop.js";
@@ -16,6 +16,7 @@ import { classifyMessages, formatUserMessages, buildReceipts, shouldSkipSleep, h
 import { TaskManager, loadTaskDefinitions, loadTaskState, formatTaskTable } from "./task-manager.js";
 import { runTaskCli, handleTaskSlashCommand } from "./task-cli.js";
 import { TUI } from "./tui.js";
+import { isDaemonRunningFromState } from "./chat.js";
 import { actionSession, actionDetail } from "./types.js";
 import { YELLOW, GREEN, DIM, BOLD, RED, RESET } from "./colors.js";
 import { readFileSync, existsSync, statSync, mkdirSync, writeFileSync, chmodSync } from "node:fs";
@@ -26,7 +27,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, runInit, initForce, runTaskCli: isTaskCli, registerTitle } = parseCliArgs(process.argv);
+    const { overrides, help, version, register, testContext: isTestContext, runTest, showTasks, showHistory, showStatus, showConfig, runInit, initForce, runTaskCli: isTaskCli, registerTitle } = parseCliArgs(process.argv);
     if (help) {
         printHelp();
         process.exit(0);
@@ -66,6 +67,16 @@ async function main() {
         await showActionHistory();
         return;
     }
+    // `aoaoe status` -- quick one-shot daemon health check
+    if (showStatus) {
+        showDaemonStatus();
+        return;
+    }
+    // `aoaoe config` -- show effective resolved config
+    if (showConfig) {
+        showEffectiveConfig();
+        return;
+    }
     // `aoaoe task` -- task management CLI
     if (isTaskCli) {
         await runTaskCli(process.argv);
@@ -92,7 +103,9 @@ async function main() {
             console.error("");
         }
     }
-    const config = loadConfig(overrides);
+    const configResult = loadConfig(overrides);
+    const configPath = configResult._configPath;
+    const config = configResult; // strip _configPath from type for downstream
     // acquire daemon lock — prevent two daemons from running simultaneously
     const lock = acquireLock();
     if (!lock.acquired) {
@@ -112,6 +125,7 @@ async function main() {
         console.error("");
         console.error("  aoaoe" + (pkg ? ` v${pkg}` : "") + "  —  autonomous supervisor");
         console.error(`  reasoner: ${config.reasoner}  |  poll: ${config.pollIntervalMs / 1000}s`);
+        console.error(`  config: ${configPath ?? "defaults (no config file found)"}`);
         if (config.observe)
             console.error("  OBSERVE MODE — watching only, no AI, no actions");
         else if (config.confirm)
@@ -210,6 +224,7 @@ async function main() {
             tui.log("system", `The AI supervisor is watching your agents and will help when needed.`);
         }
         tui.log("system", "");
+        tui.log("system", `config: ${configPath ?? "using defaults (no config file found)"}`);
         tui.log("system", "Type a message to talk to the AI, or use /help for commands.");
         tui.log("system", "Press ESC twice to interrupt the AI mid-thought.");
         tui.log("system", "");
@@ -1097,6 +1112,80 @@ async function runIntegrationTest() {
     // the integration test is a self-contained script that runs main() on import
     await import(testModule);
 }
+// `aoaoe status` -- quick one-shot health check: is the daemon running? what's it doing?
+function showDaemonStatus() {
+    const state = readState();
+    const running = isDaemonRunningFromState(state);
+    const pkg = readPkgVersion();
+    console.log("");
+    console.log(`  aoaoe${pkg ? ` v${pkg}` : ""} — daemon status`);
+    console.log(`  ${"─".repeat(50)}`);
+    if (!running || !state) {
+        console.log(`  ${RED}●${RESET} daemon is ${BOLD}not running${RESET}`);
+        const configPath = findConfigFile();
+        console.log(`  config: ${configPath ?? "none found (run 'aoaoe init')"}`);
+        console.log("");
+        console.log("  start with: aoaoe");
+        console.log("  or observe: aoaoe --observe");
+        console.log("");
+        return;
+    }
+    // daemon is running — show details
+    const elapsed = Date.now() - state.phaseStartedAt;
+    const elapsedStr = elapsed < 60_000 ? `${Math.floor(elapsed / 1000)}s` : `${Math.floor(elapsed / 60_000)}m`;
+    const phaseIcon = state.phase === "sleeping" ? `${DIM}○${RESET}` :
+        state.phase === "reasoning" ? `${YELLOW}●${RESET}` :
+            state.phase === "executing" ? `${GREEN}●${RESET}` :
+                state.phase === "polling" ? `${YELLOW}○${RESET}` :
+                    `${RED}●${RESET}`;
+    console.log(`  ${GREEN}●${RESET} daemon is ${BOLD}running${RESET}  (poll #${state.pollCount})`);
+    console.log(`  ${phaseIcon} phase: ${state.phase} (${elapsedStr})`);
+    if (state.paused)
+        console.log(`  ${YELLOW}${BOLD}  PAUSED${RESET}`);
+    console.log(`  poll interval: ${state.pollIntervalMs / 1000}s`);
+    if (state.nextTickAt > Date.now()) {
+        const countdown = Math.ceil((state.nextTickAt - Date.now()) / 1000);
+        console.log(`  next tick: ${countdown}s`);
+    }
+    console.log("");
+    // sessions
+    if (state.sessions.length === 0) {
+        console.log("  no active sessions");
+    }
+    else {
+        console.log(`  ${state.sessions.length} session(s):`);
+        for (const s of state.sessions) {
+            const statusIcon = s.status === "working" || s.status === "running" ? `${GREEN}●${RESET}` :
+                s.status === "idle" ? `${DIM}○${RESET}` :
+                    s.status === "error" ? `${RED}●${RESET}` :
+                        s.status === "done" ? `${GREEN}✓${RESET}` :
+                            `${DIM}?${RESET}`;
+            const userTag = s.userActive ? ` ${DIM}(user active)${RESET}` : "";
+            const taskTag = s.currentTask ? ` — ${DIM}${s.currentTask.slice(0, 50)}${RESET}` : "";
+            console.log(`    ${statusIcon} ${BOLD}${s.title}${RESET} (${s.tool}) ${s.status}${userTag}${taskTag}`);
+        }
+    }
+    console.log("");
+}
+// `aoaoe config` -- show the effective resolved config (defaults + file + any notes)
+function showEffectiveConfig() {
+    const configPath = findConfigFile();
+    const configResult = loadConfig();
+    // strip _configPath from output
+    const { _configPath, ...config } = configResult;
+    console.log("");
+    console.log("  aoaoe — effective config");
+    console.log(`  ${"─".repeat(50)}`);
+    console.log(`  source: ${configPath ?? "defaults (no config file found)"}`);
+    console.log("");
+    console.log(JSON.stringify(config, null, 2));
+    console.log("");
+    // helpful notes
+    if (!configPath) {
+        console.log(`  ${DIM}create a config: aoaoe init${RESET}`);
+        console.log("");
+    }
+}
 main().catch((err) => {
     console.error(`fatal: ${err}`);
     process.exit(1);

package/dist/init.js

@@ -60,7 +60,8 @@ async function discoverSessions() {
             .filter((r) => r.status === "fulfilled")
             .map((r) => r.value);
     }
-    catch {
+    catch (e) {
+        console.error(`[init] failed to parse session list: ${e}`);
         return [];
     }
 }
@@ -72,7 +73,8 @@ async function getSessionStatus(id) {
         const data = JSON.parse(result.stdout);
         return toSessionStatus(data.status);
     }
-    catch {
+    catch (e) {
+        console.error(`[init] failed to parse session status for ${id}: ${e}`);
         return "unknown";
     }
 }

package/dist/poller.js

@@ -115,7 +115,8 @@ export class Poller {
             const data = JSON.parse(result.stdout);
             return toSessionStatus(data.status);
         }
-        catch {
+        catch (e) {
+            console.error(`[poller] failed to parse session status for ${id}: ${e}`);
             return "unknown";
         }
     }
@@ -232,7 +233,8 @@ export async function listAoeSessionsShared(timeoutMs = 10_000) {
         const parsed = JSON.parse(result.stdout);
         raw = Array.isArray(parsed) ? parsed : [];
     }
-    catch {
+    catch (e) {
+        console.error(`[poller] failed to parse session list: ${e}`);
         return [];
     }
     const results = await Promise.allSettled(raw.map(async (s) => {
@@ -245,7 +247,9 @@ export async function listAoeSessionsShared(timeoutMs = 10_000) {
                 status = JSON.parse(showResult.stdout).status ?? "unknown";
             }
         }
-        catch { }
+        catch (e) {
+            console.error(`[poller] failed to parse session show for ${id}: ${e}`);
+        }
         return { id, title, tool: s.tool ?? "", status, tmuxName: computeTmuxName(id, title) };
     }));
     return results

package/package.json

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