aoaoe 0.68.0 → 0.70.0

package/dist/config.d.ts

@@ -41,6 +41,11 @@ export declare function parseCliArgs(argv: string[]): {
     runInit: boolean;
     initForce: boolean;
     runTaskCli: boolean;
+    runTail: boolean;
+    tailFollow: boolean;
+    tailCount?: number;
+    runStats: boolean;
+    statsLast?: string;
     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, runStats: false, statsLast: undefined };
     // check for subcommand as first non-flag arg
     if (argv[2] === "test-context") {
         return { ...defaults, testContext: true };
@@ -395,6 +395,30 @@ 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] === "stats") {
+        let last;
+        for (let i = 3; i < argv.length; i++) {
+            if ((argv[i] === "--last" || argv[i] === "-l") && argv[i + 1]) {
+                last = argv[++i];
+            }
+        }
+        return { ...defaults, runStats: true, statsLast: last };
+    }
     if (argv[2] === "register") {
         register = true;
         // parse --title from remaining args
@@ -488,7 +512,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, runStats: false, statsLast: undefined };
 }
 export function printHelp() {
     console.log(`aoaoe - autonomous supervisor for agent-of-empires sessions
@@ -518,6 +542,11 @@ 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)
+  stats          show aggregate daemon statistics (actions, sessions, activity)
+  stats --last <duration>  time window: 1h, 6h, 24h, 7d (default: all time)
+  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 +579,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, runStats: isStats, statsLast, registerTitle } = parseCliArgs(process.argv);
     if (help) {
         printHelp();
         process.exit(0);
@@ -110,6 +110,11 @@ async function main() {
         await runTimelineExport(exportFormat, exportOutput, exportLast);
         return;
     }
+    // `aoaoe stats` -- show aggregate daemon statistics
+    if (isStats) {
+        await runStatsCommand(statsLast);
+        return;
+    }
     // `aoaoe task` -- task management CLI
     if (isTaskCli) {
         await runTaskCli(process.argv);
@@ -121,6 +126,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("");
@@ -1449,6 +1460,36 @@ async function runTimelineExport(format, output, last) {
         process.stdout.write(content);
     }
 }
+// `aoaoe stats` -- show aggregate daemon statistics
+async function runStatsCommand(last) {
+    const { parseActionStats, parseHistoryStats, combineStats, formatStats } = await import("./stats.js");
+    const { parseDuration } = await import("./export.js");
+    const { loadTuiHistory } = await import("./tui-history.js");
+    const maxAgeMs = last ? parseDuration(last) : undefined;
+    if (last && maxAgeMs === undefined) {
+        console.error(`error: --last must be like "1h", "6h", "24h", "7d", got "${last}"`);
+        process.exit(1);
+    }
+    const windowLabel = last ?? "all time";
+    // read actions.log
+    const actionsFile = join(homedir(), ".aoaoe", "actions.log");
+    let actionLines = [];
+    try {
+        if (existsSync(actionsFile)) {
+            actionLines = readFileSync(actionsFile, "utf-8").trim().split("\n").filter((l) => l.trim());
+        }
+    }
+    catch {
+        // no actions — that's fine
+    }
+    // read tui-history
+    const retentionMs = maxAgeMs ?? 365 * 24 * 60 * 60 * 1000; // 1 year default
+    const historyEntries = loadTuiHistory(100_000, undefined, retentionMs);
+    const actionStats = parseActionStats(actionLines, maxAgeMs ?? undefined);
+    const historyStats = parseHistoryStats(historyEntries, maxAgeMs ?? undefined);
+    const combined = combineStats(actionStats, historyStats);
+    console.log(formatStats(combined, windowLabel));
+}
 // `aoaoe test` -- dynamically import and run the integration test
 async function runIntegrationTest() {
     const testModule = resolve(__dirname, "integration-test.js");

package/dist/stats.d.ts

@@ -0,0 +1,54 @@
+import type { HistoryEntry } from "./tui-history.js";
+export interface ActionStats {
+    total: number;
+    succeeded: number;
+    failed: number;
+    byType: Map<string, number>;
+    bySession: Map<string, {
+        total: number;
+        ok: number;
+        fail: number;
+    }>;
+    firstTs: number;
+    lastTs: number;
+}
+export interface HistoryStats {
+    total: number;
+    byTag: Map<string, number>;
+    firstTs: number;
+    lastTs: number;
+}
+export interface CombinedStats {
+    actions: ActionStats | null;
+    history: HistoryStats | null;
+    timeRange: {
+        start: number;
+        end: number;
+    } | null;
+}
+/**
+ * Parse action log lines into aggregate stats.
+ * Skips malformed lines and wait actions.
+ */
+export declare function parseActionStats(lines: string[], maxAgeMs?: number, now?: number): ActionStats | null;
+/**
+ * Parse tui-history entries into aggregate stats.
+ */
+export declare function parseHistoryStats(entries: HistoryEntry[], maxAgeMs?: number, now?: number): HistoryStats | null;
+/**
+ * Combine action and history stats into a unified stats object.
+ */
+export declare function combineStats(actions: ActionStats | null, history: HistoryStats | null): CombinedStats;
+/**
+ * Format a duration in ms as a human-friendly string.
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Format a rate as "X per hour" or "X per day".
+ */
+export declare function formatRate(count: number, spanMs: number): string;
+/**
+ * Format the full stats display for terminal output.
+ */
+export declare function formatStats(stats: CombinedStats, windowLabel?: string): string;
+//# sourceMappingURL=stats.d.ts.map

package/dist/stats.js

@@ -0,0 +1,221 @@
+// stats.ts — aggregate daemon statistics from actions.log and tui-history.jsonl.
+// pure exported functions for testability.
+import { toActionLogEntry } from "./types.js";
+import { BOLD, RESET, DIM, GREEN, RED, YELLOW, SLATE, AMBER, LIME, SKY, CYAN, } from "./colors.js";
+// ── Parsing ───────────────────────────────────────────────────────────────────
+/**
+ * Parse action log lines into aggregate stats.
+ * Skips malformed lines and wait actions.
+ */
+export function parseActionStats(lines, maxAgeMs, now) {
+    const cutoff = maxAgeMs ? (now ?? Date.now()) - maxAgeMs : 0;
+    const byType = new Map();
+    const bySession = new Map();
+    let total = 0;
+    let succeeded = 0;
+    let failed = 0;
+    let firstTs = Infinity;
+    let lastTs = 0;
+    for (const line of lines) {
+        try {
+            const entry = toActionLogEntry(JSON.parse(line));
+            if (!entry)
+                continue;
+            if (entry.action.action === "wait")
+                continue;
+            if (entry.timestamp < cutoff)
+                continue;
+            total++;
+            if (entry.success)
+                succeeded++;
+            else
+                failed++;
+            if (entry.timestamp < firstTs)
+                firstTs = entry.timestamp;
+            if (entry.timestamp > lastTs)
+                lastTs = entry.timestamp;
+            const type = entry.action.action;
+            byType.set(type, (byType.get(type) ?? 0) + 1);
+            const session = entry.action.title ?? entry.action.session?.slice(0, 8) ?? "unknown";
+            const existing = bySession.get(session) ?? { total: 0, ok: 0, fail: 0 };
+            existing.total++;
+            if (entry.success)
+                existing.ok++;
+            else
+                existing.fail++;
+            bySession.set(session, existing);
+        }
+        catch {
+            // skip malformed
+        }
+    }
+    if (total === 0)
+        return null;
+    return { total, succeeded, failed, byType, bySession, firstTs, lastTs };
+}
+/**
+ * Parse tui-history entries into aggregate stats.
+ */
+export function parseHistoryStats(entries, maxAgeMs, now) {
+    const cutoff = maxAgeMs ? (now ?? Date.now()) - maxAgeMs : 0;
+    const byTag = new Map();
+    let total = 0;
+    let firstTs = Infinity;
+    let lastTs = 0;
+    for (const entry of entries) {
+        if (entry.ts < cutoff)
+            continue;
+        total++;
+        if (entry.ts < firstTs)
+            firstTs = entry.ts;
+        if (entry.ts > lastTs)
+            lastTs = entry.ts;
+        byTag.set(entry.tag, (byTag.get(entry.tag) ?? 0) + 1);
+    }
+    if (total === 0)
+        return null;
+    return { total, byTag, firstTs, lastTs };
+}
+/**
+ * Combine action and history stats into a unified stats object.
+ */
+export function combineStats(actions, history) {
+    let start = Infinity;
+    let end = 0;
+    if (actions) {
+        if (actions.firstTs < start)
+            start = actions.firstTs;
+        if (actions.lastTs > end)
+            end = actions.lastTs;
+    }
+    if (history) {
+        if (history.firstTs < start)
+            start = history.firstTs;
+        if (history.lastTs > end)
+            end = history.lastTs;
+    }
+    const timeRange = start < Infinity && end > 0 ? { start, end } : null;
+    return { actions, history, timeRange };
+}
+// ── Formatting ────────────────────────────────────────────────────────────────
+/**
+ * Format a duration in ms as a human-friendly string.
+ */
+export function formatDuration(ms) {
+    if (ms < 60_000)
+        return `${Math.floor(ms / 1000)}s`;
+    if (ms < 3_600_000) {
+        const m = Math.floor(ms / 60_000);
+        const s = Math.floor((ms % 60_000) / 1000);
+        return s > 0 ? `${m}m ${s}s` : `${m}m`;
+    }
+    if (ms < 86_400_000) {
+        const h = Math.floor(ms / 3_600_000);
+        const m = Math.floor((ms % 3_600_000) / 60_000);
+        return m > 0 ? `${h}h ${m}m` : `${h}h`;
+    }
+    const d = Math.floor(ms / 86_400_000);
+    const h = Math.floor((ms % 86_400_000) / 3_600_000);
+    return h > 0 ? `${d}d ${h}h` : `${d}d`;
+}
+/**
+ * Format a rate as "X per hour" or "X per day".
+ */
+export function formatRate(count, spanMs) {
+    if (spanMs <= 0)
+        return `${count} total`;
+    const hours = spanMs / 3_600_000;
+    if (hours < 1)
+        return `${count} total`;
+    const perHour = count / hours;
+    if (perHour >= 1)
+        return `${perHour.toFixed(1)}/hr`;
+    const perDay = perHour * 24;
+    return `${perDay.toFixed(1)}/day`;
+}
+/**
+ * Format the full stats display for terminal output.
+ */
+export function formatStats(stats, windowLabel) {
+    const lines = [];
+    const hr = "─".repeat(54);
+    lines.push("");
+    lines.push(`  ${BOLD}aoaoe — stats${RESET}${windowLabel ? `  ${DIM}(${windowLabel})${RESET}` : ""}`);
+    lines.push(`  ${hr}`);
+    // time range
+    if (stats.timeRange) {
+        const { start, end } = stats.timeRange;
+        const span = end - start;
+        const startStr = new Date(start).toLocaleString();
+        const endStr = new Date(end).toLocaleString();
+        lines.push(`  ${DIM}from:${RESET}  ${startStr}`);
+        lines.push(`  ${DIM}to:${RESET}    ${endStr}`);
+        lines.push(`  ${DIM}span:${RESET}  ${formatDuration(span)}`);
+    }
+    else {
+        lines.push(`  ${DIM}no data found${RESET}`);
+        lines.push("");
+        return lines.join("\n");
+    }
+    // actions
+    if (stats.actions) {
+        const a = stats.actions;
+        const span = a.lastTs - a.firstTs;
+        const rate = formatRate(a.total, span);
+        lines.push("");
+        lines.push(`  ${BOLD}actions${RESET}  ${DIM}(${rate})${RESET}`);
+        const successRate = a.total > 0 ? Math.round((a.succeeded / a.total) * 100) : 0;
+        const successColor = successRate >= 90 ? GREEN : successRate >= 70 ? YELLOW : RED;
+        lines.push(`  total:    ${BOLD}${a.total}${RESET}  ${GREEN}${a.succeeded} ok${RESET}  ${a.failed > 0 ? `${RED}${a.failed} failed${RESET}` : `${DIM}0 failed${RESET}`}  ${successColor}(${successRate}%)${RESET}`);
+        // by type — sorted by count descending
+        const sorted = [...a.byType.entries()].sort((x, y) => y[1] - x[1]);
+        for (const [type, count] of sorted) {
+            const bar = "█".repeat(Math.min(20, Math.round((count / a.total) * 20)));
+            const pct = Math.round((count / a.total) * 100);
+            lines.push(`  ${AMBER}${type.padEnd(18)}${RESET} ${String(count).padStart(4)}  ${SLATE}${bar}${RESET} ${DIM}${pct}%${RESET}`);
+        }
+        // top sessions — sorted by total actions
+        if (a.bySession.size > 0) {
+            lines.push("");
+            lines.push(`  ${BOLD}top sessions${RESET}`);
+            const topSessions = [...a.bySession.entries()]
+                .sort((x, y) => y[1].total - x[1].total)
+                .slice(0, 8);
+            for (const [name, counts] of topSessions) {
+                const failTag = counts.fail > 0 ? `  ${RED}${counts.fail} fail${RESET}` : "";
+                lines.push(`  ${CYAN}${name.padEnd(20)}${RESET} ${String(counts.total).padStart(4)} actions  ${GREEN}${counts.ok} ok${RESET}${failTag}`);
+            }
+        }
+    }
+    else {
+        lines.push("");
+        lines.push(`  ${DIM}no actions recorded${RESET}`);
+    }
+    // history activity breakdown
+    if (stats.history) {
+        const h = stats.history;
+        lines.push("");
+        lines.push(`  ${BOLD}activity${RESET}  ${DIM}(${h.total} events)${RESET}`);
+        const tagOrder = ["observation", "reasoner", "explain", "+ action", "! action", "you", "system", "status"];
+        const tagColors = {
+            "observation": SLATE, "reasoner": SKY, "explain": CYAN,
+            "+ action": AMBER, "! action": RED, "action": AMBER, "error": RED,
+            "you": LIME, "system": SLATE, "status": SLATE,
+        };
+        // sort: known tags first in order, then unknown by count
+        const knownTags = tagOrder.filter((t) => h.byTag.has(t));
+        const unknownTags = [...h.byTag.keys()].filter((t) => !tagOrder.includes(t)).sort((a, b) => (h.byTag.get(b) ?? 0) - (h.byTag.get(a) ?? 0));
+        const allTags = [...knownTags, ...unknownTags];
+        for (const tag of allTags) {
+            const count = h.byTag.get(tag) ?? 0;
+            const color = tagColors[tag] ?? SLATE;
+            const bar = "█".repeat(Math.min(20, Math.round((count / h.total) * 20)));
+            const pct = Math.round((count / h.total) * 100);
+            lines.push(`  ${color}${tag.padEnd(18)}${RESET} ${String(count).padStart(4)}  ${SLATE}${bar}${RESET} ${DIM}${pct}%${RESET}`);
+        }
+    }
+    lines.push(`  ${hr}`);
+    lines.push("");
+    return lines.join("\n");
+}
+//# sourceMappingURL=stats.js.map

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.70.0",
   "description": "Autonomous supervisor for agent-of-empires sessions using OpenCode or Claude Code",
   "type": "module",
   "main": "dist/index.js",