aoaoe 0.56.0 → 0.57.0

package/README.md

@@ -244,6 +244,10 @@ commands:
   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

@@ -30,6 +30,10 @@ export declare function parseCliArgs(argv: string[]): {
     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, runDoctor: 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 };
@@ -330,6 +330,22 @@ export function parseCliArgs(argv) {
     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 };
@@ -419,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, runDoctor: 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
@@ -441,6 +457,10 @@ commands:
   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)
@@ -467,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, runDoctor, 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);
@@ -96,6 +96,11 @@ async function main() {
         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);
@@ -1188,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");

package/package.json

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