aoaoe 0.68.0 → 0.69.0

package/dist/config.d.ts

@@ -41,6 +41,9 @@ export declare function parseCliArgs(argv: string[]): {
     runInit: boolean;
     initForce: boolean;
     runTaskCli: boolean;
+    runTail: boolean;
+    tailFollow: boolean;
+    tailCount?: number;
     registerTitle?: string;
 };
 export declare function printHelp(): void;

package/dist/config.js

@@ -327,7 +327,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, runLogs: false, logsActions: false, logsGrep: undefined, logsCount: undefined, runExport: false, exportFormat: undefined, exportOutput: undefined, exportLast: undefined, 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, runExport: false, exportFormat: undefined, exportOutput: undefined, exportLast: undefined, runInit: false, initForce: false, runTaskCli: false, runTail: false, tailFollow: false, tailCount: undefined };
     // check for subcommand as first non-flag arg
     if (argv[2] === "test-context") {
         return { ...defaults, testContext: true };
@@ -395,6 +395,21 @@ export function parseCliArgs(argv) {
         const force = argv.includes("--force") || argv.includes("-f");
         return { ...defaults, runInit: true, initForce: force };
     }
+    if (argv[2] === "tail") {
+        let follow = false;
+        let count;
+        for (let i = 3; i < argv.length; i++) {
+            if (argv[i] === "-f" || argv[i] === "--follow") {
+                follow = true;
+            }
+            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, runTail: true, tailFollow: follow, tailCount: count };
+    }
     if (argv[2] === "register") {
         register = true;
         // parse --title from remaining args
@@ -488,7 +503,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, runLogs: false, logsActions: false, logsGrep: undefined, logsCount: undefined, runExport: false, exportFormat: undefined, exportOutput: undefined, exportLast: undefined, 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, runExport: false, exportFormat: undefined, exportOutput: undefined, exportLast: undefined, runInit: false, initForce: false, runTaskCli: false, runTail: false, tailFollow: false, tailCount: undefined };
 }
 export function printHelp() {
     console.log(`aoaoe - autonomous supervisor for agent-of-empires sessions
@@ -518,6 +533,9 @@ commands:
   export --format <json|markdown>  output format (default: json)
   export --output <file>           write to file (default: stdout)
   export --last <duration>         time window: 1h, 6h, 24h, 7d (default: 24h)
+  tail           live-stream daemon activity to a separate terminal
+  tail -f        follow mode — keep watching for new entries (Ctrl+C to stop)
+  tail -n <N>    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)
@@ -550,6 +568,10 @@ logs options:
   --grep, -g <pattern>               filter entries by substring or regex
   -n, --count <number>               number of entries to show (default: 50)
 
+tail options:
+  -f, --follow                       keep watching for new entries (Ctrl+C to stop)
+  -n, --count <number>               number of entries to show (default: 50)
+
 register options:
   --title, -t <name>                 session title in AoE (default: aoaoe)
 

package/dist/index.js

@@ -32,7 +32,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, runLogs, logsActions, logsGrep, logsCount, runExport, exportFormat, exportOutput, exportLast, 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, runExport, exportFormat, exportOutput, exportLast, runInit, initForce, runTaskCli: isTaskCli, runTail: isTail, tailFollow, tailCount, registerTitle } = parseCliArgs(process.argv);
     if (help) {
         printHelp();
         process.exit(0);
@@ -121,6 +121,12 @@ async function main() {
         await doInit(initForce);
         return;
     }
+    // `aoaoe tail` -- live-stream daemon activity to a separate terminal
+    if (isTail) {
+        const { runTail: doTail } = await import("./tail.js");
+        await doTail({ count: tailCount ?? 50, follow: tailFollow });
+        return;
+    }
     // auto-init: if no config file exists, run init automatically
     if (!configFileExists()) {
         console.error("");

package/dist/tail.d.ts

@@ -0,0 +1,41 @@
+import { type HistoryEntry } from "./tui-history.js";
+/**
+ * Format a HistoryEntry as a colorized terminal line.
+ * Matches TUI formatActivity style but for plain scrolling output.
+ */
+export declare function formatTailEntry(entry: HistoryEntry): string;
+/**
+ * Format a date string for the tail header.
+ */
+export declare function formatTailDate(ts: number): string;
+/**
+ * Load the last N entries from the history file.
+ * Returns entries newest-last (chronological order).
+ */
+export declare function loadTailEntries(count: number, filePath?: string): HistoryEntry[];
+/**
+ * Get the current file size (for follow mode to detect appends).
+ */
+export declare function getFileSize(filePath: string): number;
+/**
+ * Read new bytes appended since a given offset, parse into entries.
+ */
+export declare function readNewEntries(filePath: string, fromByte: number): {
+    entries: HistoryEntry[];
+    newSize: number;
+};
+/**
+ * Print entries to stderr (colorized).
+ */
+export declare function printEntries(entries: HistoryEntry[]): void;
+/**
+ * Run the tail command.
+ * Without follow: print last N entries, exit.
+ * With follow: print last N, then watch for new entries (blocks until Ctrl+C).
+ */
+export declare function runTail(opts: {
+    count: number;
+    follow: boolean;
+    filePath?: string;
+}): Promise<void>;
+//# sourceMappingURL=tail.d.ts.map

package/dist/tail.js

@@ -0,0 +1,211 @@
+// tail.ts — live-stream daemon activity to a separate terminal.
+// reads from tui-history.jsonl, optionally follows for new entries.
+// pure exported functions for testability.
+import { readFileSync, statSync, existsSync, openSync, readSync, closeSync } from "node:fs";
+import { watch } from "node:fs";
+import { TUI_HISTORY_FILE } from "./tui-history.js";
+import { SLATE, RESET, DIM, BOLD, CYAN, AMBER, ROSE, LIME, SKY, } from "./colors.js";
+/**
+ * Format a HistoryEntry as a colorized terminal line.
+ * Matches TUI formatActivity style but for plain scrolling output.
+ */
+export function formatTailEntry(entry) {
+    let color = SLATE;
+    let prefix = entry.tag;
+    switch (entry.tag) {
+        case "observation":
+            color = SLATE;
+            prefix = "obs";
+            break;
+        case "reasoner":
+            color = SKY;
+            break;
+        case "explain":
+            color = `${BOLD}${CYAN}`;
+            prefix = "AI";
+            break;
+        case "+ action":
+        case "action":
+            color = AMBER;
+            prefix = "→ action";
+            break;
+        case "! action":
+        case "error":
+            color = ROSE;
+            prefix = "✗ error";
+            break;
+        case "you":
+            color = LIME;
+            break;
+        case "system":
+            color = SLATE;
+            break;
+        case "status":
+            color = SLATE;
+            break;
+        default:
+            color = SLATE;
+            break;
+    }
+    return `${SLATE}${entry.time}${RESET} ${color}${prefix}${RESET} ${DIM}│${RESET} ${entry.text}`;
+}
+/**
+ * Format a date string for the tail header.
+ */
+export function formatTailDate(ts) {
+    const d = new Date(ts);
+    return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+}
+/**
+ * Load the last N entries from the history file.
+ * Returns entries newest-last (chronological order).
+ */
+export function loadTailEntries(count, filePath = TUI_HISTORY_FILE) {
+    try {
+        if (!existsSync(filePath))
+            return [];
+        const content = readFileSync(filePath, "utf-8");
+        const lines = content.split("\n").filter((l) => l.trim());
+        const entries = [];
+        // read from the end to minimize parsing
+        const start = Math.max(0, lines.length - count);
+        for (let i = start; i < lines.length; i++) {
+            try {
+                const parsed = JSON.parse(lines[i]);
+                if (isValidEntry(parsed))
+                    entries.push(parsed);
+            }
+            catch {
+                // skip malformed
+            }
+        }
+        return entries;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get the current file size (for follow mode to detect appends).
+ */
+export function getFileSize(filePath) {
+    try {
+        return statSync(filePath).size;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Read new bytes appended since a given offset, parse into entries.
+ */
+export function readNewEntries(filePath, fromByte) {
+    try {
+        const size = statSync(filePath).size;
+        if (size === 0)
+            return { entries: [], newSize: 0 };
+        // file was truncated/rotated — read from start
+        const start = size < fromByte ? 0 : fromByte;
+        if (start === size)
+            return { entries: [], newSize: size };
+        const buf = Buffer.alloc(size - start);
+        const fd = openSync(filePath, "r");
+        readSync(fd, buf, 0, buf.length, start);
+        closeSync(fd);
+        const text = buf.toString("utf-8");
+        const lines = text.split("\n").filter((l) => l.trim());
+        const entries = [];
+        for (const line of lines) {
+            try {
+                const parsed = JSON.parse(line);
+                if (isValidEntry(parsed))
+                    entries.push(parsed);
+            }
+            catch {
+                // skip
+            }
+        }
+        return { entries, newSize: size };
+    }
+    catch {
+        return { entries: [], newSize: fromByte };
+    }
+}
+/**
+ * Print entries to stderr (colorized).
+ */
+export function printEntries(entries) {
+    for (const e of entries) {
+        process.stderr.write(formatTailEntry(e) + "\n");
+    }
+}
+/**
+ * Run the tail command.
+ * Without follow: print last N entries, exit.
+ * With follow: print last N, then watch for new entries (blocks until Ctrl+C).
+ */
+export async function runTail(opts) {
+    const filePath = opts.filePath ?? TUI_HISTORY_FILE;
+    // print initial entries
+    const entries = loadTailEntries(opts.count, filePath);
+    if (entries.length === 0) {
+        process.stderr.write(`${DIM}no history entries found${RESET}\n`);
+        if (!opts.follow)
+            return;
+        process.stderr.write(`${DIM}waiting for new entries... (Ctrl+C to stop)${RESET}\n`);
+    }
+    else {
+        // date header
+        const firstDate = formatTailDate(entries[0].ts);
+        const lastDate = formatTailDate(entries[entries.length - 1].ts);
+        const dateRange = firstDate === lastDate ? firstDate : `${firstDate} → ${lastDate}`;
+        process.stderr.write(`${DIM}── ${entries.length} entries (${dateRange}) ──${RESET}\n`);
+        printEntries(entries);
+    }
+    if (!opts.follow)
+        return;
+    // follow mode: watch file for changes
+    process.stderr.write(`${DIM}── following (Ctrl+C to stop) ──${RESET}\n`);
+    let lastSize = getFileSize(filePath);
+    return new Promise((_resolve) => {
+        let watcher = null;
+        try {
+            watcher = watch(filePath, { persistent: true }, () => {
+                const { entries: newEntries, newSize } = readNewEntries(filePath, lastSize);
+                if (newEntries.length > 0) {
+                    printEntries(newEntries);
+                }
+                lastSize = newSize;
+            });
+            watcher.on("error", () => {
+                // file may be rotated — try to recover
+                lastSize = 0;
+            });
+        }
+        catch {
+            process.stderr.write(`${ROSE}failed to watch ${filePath}${RESET}\n`);
+        }
+        // Ctrl+C cleanup
+        const cleanup = () => {
+            if (watcher) {
+                try {
+                    watcher.close();
+                }
+                catch { }
+            }
+            process.exit(0);
+        };
+        process.on("SIGINT", cleanup);
+        process.on("SIGTERM", cleanup);
+    });
+}
+function isValidEntry(val) {
+    if (typeof val !== "object" || val === null)
+        return false;
+    const obj = val;
+    return (typeof obj.ts === "number" &&
+        typeof obj.time === "string" &&
+        typeof obj.tag === "string" &&
+        typeof obj.text === "string");
+}
+//# sourceMappingURL=tail.js.map

package/package.json

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