aoaoe 0.69.0 → 0.70.0

package/dist/config.d.ts

@@ -44,6 +44,8 @@ export declare function parseCliArgs(argv: string[]): {
     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, runTail: false, tailFollow: false, tailCount: undefined };
+    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 };
@@ -410,6 +410,15 @@ export function parseCliArgs(argv) {
         }
         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
@@ -503,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, runTail: false, tailFollow: false, tailCount: undefined };
+    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
@@ -533,6 +542,8 @@ 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)

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, runTail: isTail, tailFollow, tailCount, 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);
@@ -1455,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/package.json

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