aoaoe 0.70.0 → 0.71.0

package/dist/config.d.ts

@@ -46,6 +46,9 @@ export declare function parseCliArgs(argv: string[]): {
     tailCount?: number;
     runStats: boolean;
     statsLast?: string;
+    runReplay: boolean;
+    replaySpeed?: number;
+    replayLast?: 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, runStats: false, statsLast: 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, runReplay: false, replaySpeed: undefined, replayLast: undefined };
     // check for subcommand as first non-flag arg
     if (argv[2] === "test-context") {
         return { ...defaults, testContext: true };
@@ -419,6 +419,24 @@ export function parseCliArgs(argv) {
         }
         return { ...defaults, runStats: true, statsLast: last };
     }
+    if (argv[2] === "replay") {
+        let speed;
+        let last;
+        for (let i = 3; i < argv.length; i++) {
+            if ((argv[i] === "--speed" || argv[i] === "-s") && argv[i + 1]) {
+                const val = parseFloat(argv[++i]);
+                if (!isNaN(val) && val >= 0)
+                    speed = val;
+            }
+            else if ((argv[i] === "--last" || argv[i] === "-l") && argv[i + 1]) {
+                last = argv[++i];
+            }
+            else if (argv[i] === "--instant") {
+                speed = 0;
+            }
+        }
+        return { ...defaults, runReplay: true, replaySpeed: speed, replayLast: last };
+    }
     if (argv[2] === "register") {
         register = true;
         // parse --title from remaining args
@@ -512,7 +530,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, runStats: false, statsLast: 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, runReplay: false, replaySpeed: undefined, replayLast: undefined };
 }
 export function printHelp() {
     console.log(`aoaoe - autonomous supervisor for agent-of-empires sessions
@@ -544,6 +562,10 @@ commands:
   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)
+  replay         play back tui-history.jsonl like a movie with simulated timing
+  replay --speed <N>  playback speed: 1=realtime, 5=5x (default), 10=fast, 0=instant
+  replay --instant    same as --speed 0 (no delays, dump all entries immediately)
+  replay --last <duration>  only replay entries from the last 1h, 6h, 24h, 7d
   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)
@@ -579,6 +601,11 @@ logs options:
   --grep, -g <pattern>               filter entries by substring or regex
   -n, --count <number>               number of entries to show (default: 50)
 
+replay options:
+  --speed, -s <number>               playback speed multiplier (default: 5)
+  --instant                          no delays, dump all entries immediately
+  --last, -l <duration>              time window: 1h, 6h, 24h, 7d
+
 tail options:
   -f, --follow                       keep watching for new entries (Ctrl+C to stop)
   -n, --count <number>               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, runStats: isStats, statsLast, 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, runReplay: isReplay, replaySpeed, replayLast, registerTitle } = parseCliArgs(process.argv);
     if (help) {
         printHelp();
         process.exit(0);
@@ -115,6 +115,12 @@ async function main() {
         await runStatsCommand(statsLast);
         return;
     }
+    // `aoaoe replay` -- play back tui-history.jsonl like a movie
+    if (isReplay) {
+        const { runReplay: doReplay } = await import("./replay.js");
+        await doReplay({ speed: replaySpeed ?? 5, last: replayLast });
+        return;
+    }
     // `aoaoe task` -- task management CLI
     if (isTaskCli) {
         await runTaskCli(process.argv);

package/dist/replay.d.ts

@@ -0,0 +1,43 @@
+import { type HistoryEntry } from "./tui-history.js";
+/**
+ * Compute the delay between two entries, scaled by speed multiplier.
+ * Caps individual delays to prevent long waits on idle periods.
+ */
+export declare function computeDelay(prevTs: number, currTs: number, speed: number, maxDelayMs?: number): number;
+/**
+ * Format a speed multiplier for display.
+ */
+export declare function formatSpeed(speed: number): string;
+/**
+ * Parse a speed string ("2x", "10x", "0.5x", "instant") into a number.
+ * Returns 0 for instant, null for invalid.
+ */
+export declare function parseSpeed(input: string): number | null;
+/**
+ * Filter entries by time window.
+ */
+export declare function filterByWindow(entries: HistoryEntry[], maxAgeMs?: number, now?: number): HistoryEntry[];
+/**
+ * Build the replay header.
+ */
+export declare function formatReplayHeader(entries: HistoryEntry[], speed: number, windowLabel?: string): string;
+/**
+ * Build the replay footer.
+ */
+export declare function formatReplayFooter(entries: HistoryEntry[]): string;
+/**
+ * Load entries from the history file, optionally filtering by time window.
+ */
+export declare function loadReplayEntries(maxAgeMs?: number, filePath?: string): HistoryEntry[];
+/**
+ * Run the replay.
+ * Prints entries with simulated delays between them.
+ * Speed 0 = instant (no delays).
+ * Ctrl+C stops playback.
+ */
+export declare function runReplay(opts: {
+    speed: number;
+    last?: string;
+    filePath?: string;
+}): Promise<void>;
+//# sourceMappingURL=replay.d.ts.map

package/dist/replay.js

@@ -0,0 +1,174 @@
+// replay.ts — play back tui-history.jsonl like a movie.
+// shows what the daemon did with simulated timing or instant output.
+// reuses formatTailEntry from tail.ts for consistent rendering.
+// pure exported functions for testability.
+import { readFileSync, existsSync } from "node:fs";
+import { TUI_HISTORY_FILE } from "./tui-history.js";
+import { formatTailEntry, formatTailDate } from "./tail.js";
+import { parseDuration } from "./export.js";
+import { DIM, RESET, AMBER } from "./colors.js";
+/**
+ * Compute the delay between two entries, scaled by speed multiplier.
+ * Caps individual delays to prevent long waits on idle periods.
+ */
+export function computeDelay(prevTs, currTs, speed, maxDelayMs = 3000) {
+    if (speed <= 0)
+        return 0;
+    const raw = currTs - prevTs;
+    if (raw <= 0)
+        return 0;
+    return Math.min(Math.round(raw / speed), maxDelayMs);
+}
+/**
+ * Format a speed multiplier for display.
+ */
+export function formatSpeed(speed) {
+    if (speed <= 0)
+        return "instant";
+    if (speed === 1)
+        return "1x (realtime)";
+    if (Number.isInteger(speed))
+        return `${speed}x`;
+    return `${speed.toFixed(1)}x`;
+}
+/**
+ * Parse a speed string ("2x", "10x", "0.5x", "instant") into a number.
+ * Returns 0 for instant, null for invalid.
+ */
+export function parseSpeed(input) {
+    if (input === "instant" || input === "0")
+        return 0;
+    const match = input.match(/^(\d+(?:\.\d+)?)x?$/);
+    if (!match)
+        return null;
+    const val = parseFloat(match[1]);
+    if (!isFinite(val) || val < 0)
+        return null;
+    return val;
+}
+/**
+ * Filter entries by time window.
+ */
+export function filterByWindow(entries, maxAgeMs, now) {
+    if (!maxAgeMs)
+        return entries;
+    const cutoff = (now ?? Date.now()) - maxAgeMs;
+    return entries.filter((e) => e.ts >= cutoff);
+}
+/**
+ * Build the replay header.
+ */
+export function formatReplayHeader(entries, speed, windowLabel) {
+    if (entries.length === 0)
+        return `${DIM}no entries to replay${RESET}`;
+    const first = entries[0];
+    const last = entries[entries.length - 1];
+    const dateRange = formatTailDate(first.ts) === formatTailDate(last.ts)
+        ? formatTailDate(first.ts)
+        : `${formatTailDate(first.ts)} → ${formatTailDate(last.ts)}`;
+    const span = last.ts - first.ts;
+    const spanStr = span < 60_000 ? `${Math.floor(span / 1000)}s`
+        : span < 3_600_000 ? `${Math.floor(span / 60_000)}m`
+            : `${Math.floor(span / 3_600_000)}h ${Math.floor((span % 3_600_000) / 60_000)}m`;
+    const speedStr = formatSpeed(speed);
+    const windowStr = windowLabel ? ` (${windowLabel})` : "";
+    return `${DIM}── replay: ${entries.length} entries, ${dateRange}, span ${spanStr}, ${AMBER}${speedStr}${RESET}${DIM}${windowStr} ──${RESET}`;
+}
+/**
+ * Build the replay footer.
+ */
+export function formatReplayFooter(entries) {
+    if (entries.length === 0)
+        return "";
+    return `${DIM}── replay complete: ${entries.length} entries ──${RESET}`;
+}
+/**
+ * Sleep for a given number of milliseconds.
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Load entries from the history file, optionally filtering by time window.
+ */
+export function loadReplayEntries(maxAgeMs, 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 = [];
+        for (const line of lines) {
+            try {
+                const parsed = JSON.parse(line);
+                if (isValidEntry(parsed))
+                    entries.push(parsed);
+            }
+            catch {
+                // skip malformed
+            }
+        }
+        return filterByWindow(entries, maxAgeMs);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Run the replay.
+ * Prints entries with simulated delays between them.
+ * Speed 0 = instant (no delays).
+ * Ctrl+C stops playback.
+ */
+export async function runReplay(opts) {
+    const filePath = opts.filePath ?? TUI_HISTORY_FILE;
+    const maxAgeMs = opts.last ? parseDuration(opts.last) ?? undefined : undefined;
+    if (opts.last && maxAgeMs === undefined) {
+        process.stderr.write(`error: --last must be like "1h", "6h", "24h", "7d", got "${opts.last}"\n`);
+        process.exit(1);
+    }
+    const entries = loadReplayEntries(maxAgeMs, filePath);
+    const windowLabel = opts.last ?? undefined;
+    // header
+    process.stderr.write(formatReplayHeader(entries, opts.speed, windowLabel) + "\n");
+    if (entries.length === 0)
+        return;
+    // Ctrl+C cleanup
+    let stopped = false;
+    const onSignal = () => { stopped = true; };
+    process.on("SIGINT", onSignal);
+    process.on("SIGTERM", onSignal);
+    try {
+        for (let i = 0; i < entries.length; i++) {
+            if (stopped)
+                break;
+            // delay between entries
+            if (i > 0 && opts.speed > 0) {
+                const delay = computeDelay(entries[i - 1].ts, entries[i].ts, opts.speed);
+                if (delay > 0)
+                    await sleep(delay);
+            }
+            if (stopped)
+                break;
+            process.stderr.write(formatTailEntry(entries[i]) + "\n");
+        }
+    }
+    finally {
+        process.removeListener("SIGINT", onSignal);
+        process.removeListener("SIGTERM", onSignal);
+    }
+    // footer
+    if (!stopped) {
+        process.stderr.write(formatReplayFooter(entries) + "\n");
+    }
+}
+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=replay.js.map

package/package.json

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