aoaoe 0.62.0 → 0.64.0

package/README.md

@@ -248,6 +248,10 @@ commands:
   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)
+  export         export session timeline as JSON or Markdown for post-mortems
+  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)
   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

@@ -34,6 +34,10 @@ export declare function parseCliArgs(argv: string[]): {
     logsActions: boolean;
     logsGrep?: string;
     logsCount?: number;
+    runExport: boolean;
+    exportFormat?: string;
+    exportOutput?: string;
+    exportLast?: string;
     runInit: boolean;
     initForce: boolean;
     runTaskCli: boolean;

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, 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 };
     // check for subcommand as first non-flag arg
     if (argv[2] === "test-context") {
         return { ...defaults, testContext: true };
@@ -374,6 +374,23 @@ export function parseCliArgs(argv) {
         }
         return { ...defaults, runLogs: true, logsActions: actions, logsGrep: grep, logsCount: count };
     }
+    if (argv[2] === "export") {
+        let format;
+        let output;
+        let last;
+        for (let i = 3; i < argv.length; i++) {
+            if ((argv[i] === "--format" || argv[i] === "-f") && argv[i + 1]) {
+                format = argv[++i];
+            }
+            else if ((argv[i] === "--output" || argv[i] === "-o") && argv[i + 1]) {
+                output = argv[++i];
+            }
+            else if ((argv[i] === "--last" || argv[i] === "-l") && argv[i + 1]) {
+                last = argv[++i];
+            }
+        }
+        return { ...defaults, runExport: true, exportFormat: format, exportOutput: output, exportLast: last };
+    }
     if (argv[2] === "init") {
         const force = argv.includes("--force") || argv.includes("-f");
         return { ...defaults, runInit: true, initForce: force };
@@ -471,7 +488,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, 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 };
 }
 export function printHelp() {
     console.log(`aoaoe - autonomous supervisor for agent-of-empires sessions
@@ -497,6 +514,10 @@ commands:
   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)
+  export         export session timeline as JSON or Markdown for post-mortems
+  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)
   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/daemon-state.d.ts

@@ -1,4 +1,5 @@
 import type { DaemonState, DaemonPhase, DaemonSessionState, Observation } from "./types.js";
+export declare function setStateDir(dir: string): void;
 export declare function resetInternalState(): void;
 export declare function setSessionTask(sessionId: string, task: string): void;
 export declare function writeState(phase: DaemonPhase, updates?: Partial<Omit<DaemonState, "phase" | "phaseStartedAt">>): void;

package/dist/daemon-state.js

@@ -6,10 +6,19 @@ import { join } from "node:path";
 import { homedir } from "node:os";
 import { toDaemonState } from "./types.js";
 import { parseTasks, formatTaskList } from "./task-parser.js";
-const AOAOE_DIR = join(homedir(), ".aoaoe");
-const STATE_FILE = join(AOAOE_DIR, "daemon-state.json");
-const INTERRUPT_FILE = join(AOAOE_DIR, "interrupt");
-const LOCK_FILE = join(AOAOE_DIR, "daemon.lock");
+// default state directory — overridable via setStateDir() for test isolation
+let AOAOE_DIR = join(homedir(), ".aoaoe");
+let STATE_FILE = join(AOAOE_DIR, "daemon-state.json");
+let INTERRUPT_FILE = join(AOAOE_DIR, "interrupt");
+let LOCK_FILE = join(AOAOE_DIR, "daemon.lock");
+// redirect all state file paths to a custom directory (test isolation)
+export function setStateDir(dir) {
+    AOAOE_DIR = dir;
+    STATE_FILE = join(dir, "daemon-state.json");
+    INTERRUPT_FILE = join(dir, "interrupt");
+    LOCK_FILE = join(dir, "daemon.lock");
+    dirEnsured = false; // force re-create on next write
+}
 // cache: only mkdirSync once per process (no need to stat the dir on every phase change)
 let dirEnsured = false;
 function ensureDir() {
@@ -52,14 +61,15 @@ export function setSessionTask(sessionId, task) {
 const DEBOUNCE_MS = 500;
 let lastFlushedPhase = null;
 let lastFlushTime = 0;
-const STATE_TMP = STATE_FILE + ".tmp";
+// note: STATE_TMP is computed dynamically inside flushState() since STATE_FILE is mutable
 function flushState() {
     try {
         ensureDir();
         // atomic write: write to temp file, then rename into place.
         // prevents chat.ts from reading a partially-written JSON file.
-        writeFileSync(STATE_TMP, JSON.stringify(currentState) + "\n");
-        renameSync(STATE_TMP, STATE_FILE);
+        const tmp = STATE_FILE + ".tmp";
+        writeFileSync(tmp, JSON.stringify(currentState) + "\n");
+        renameSync(tmp, STATE_FILE);
         lastFlushedPhase = currentState.phase;
         lastFlushTime = Date.now();
     }

package/dist/export.d.ts

@@ -0,0 +1,17 @@
+import type { HistoryEntry } from "./tui-history.js";
+export interface TimelineEntry {
+    ts: number;
+    source: "action" | "activity";
+    tag: string;
+    text: string;
+    success?: boolean;
+    session?: string;
+}
+export declare function parseActionLogEntries(lines: string[]): TimelineEntry[];
+export declare function parseActivityEntries(entries: HistoryEntry[]): TimelineEntry[];
+export declare function mergeTimeline(...sources: TimelineEntry[][]): TimelineEntry[];
+export declare function filterByAge(entries: TimelineEntry[], maxAgeMs: number, now?: number): TimelineEntry[];
+export declare function parseDuration(input: string): number | null;
+export declare function formatTimelineJson(entries: TimelineEntry[]): string;
+export declare function formatTimelineMarkdown(entries: TimelineEntry[]): string;
+//# sourceMappingURL=export.d.ts.map

package/dist/export.js

@@ -0,0 +1,132 @@
+// export.ts — pure functions for exporting session timelines as JSON or Markdown
+// reads actions.log (JSONL) and tui-history.jsonl, merges into a unified timeline
+import { toActionLogEntry } from "./types.js";
+// ── parsers ─────────────────────────────────────────────────────────────────
+// parse actions.log JSONL lines into timeline entries
+export function parseActionLogEntries(lines) {
+    const entries = [];
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        try {
+            const entry = toActionLogEntry(JSON.parse(line));
+            if (!entry)
+                continue;
+            // skip wait actions (noise in post-mortems)
+            if (entry.action.action === "wait")
+                continue;
+            entries.push({
+                ts: entry.timestamp,
+                source: "action",
+                tag: entry.action.action,
+                text: entry.detail || `${entry.action.action} on ${entry.action.session ?? "unknown"}`,
+                success: entry.success,
+                session: entry.action.session ?? entry.action.title,
+            });
+        }
+        catch {
+            // skip malformed lines
+        }
+    }
+    return entries;
+}
+// convert tui-history entries into timeline entries
+export function parseActivityEntries(entries) {
+    return entries.map((e) => ({
+        ts: e.ts,
+        source: "activity",
+        tag: e.tag,
+        text: e.text,
+    }));
+}
+// ── merge + filter ──────────────────────────────────────────────────────────
+// merge multiple sources into a single chronological timeline
+export function mergeTimeline(...sources) {
+    const all = sources.flat();
+    all.sort((a, b) => a.ts - b.ts);
+    return all;
+}
+// filter entries by time window (keep entries newer than cutoff)
+export function filterByAge(entries, maxAgeMs, now = Date.now()) {
+    const cutoff = now - maxAgeMs;
+    return entries.filter((e) => e.ts >= cutoff);
+}
+// ── duration parser ─────────────────────────────────────────────────────────
+// parse human-friendly duration strings: "1h", "6h", "24h", "2d", "7d", "30d"
+export function parseDuration(input) {
+    const match = input.match(/^(\d+)(h|d)$/);
+    if (!match)
+        return null;
+    const val = parseInt(match[1], 10);
+    if (val <= 0)
+        return null;
+    const unit = match[2];
+    if (unit === "h")
+        return val * 60 * 60 * 1000;
+    if (unit === "d")
+        return val * 24 * 60 * 60 * 1000;
+    return null;
+}
+// ── formatters ──────────────────────────────────────────────────────────────
+// format timeline as pretty-printed JSON
+export function formatTimelineJson(entries) {
+    const output = entries.map((e) => {
+        const obj = {
+            time: new Date(e.ts).toISOString(),
+            source: e.source,
+            tag: e.tag,
+            text: e.text,
+        };
+        if (e.success !== undefined)
+            obj.success = e.success;
+        if (e.session)
+            obj.session = e.session;
+        return obj;
+    });
+    return JSON.stringify(output, null, 2) + "\n";
+}
+// format timeline as a readable Markdown post-mortem document
+export function formatTimelineMarkdown(entries) {
+    if (entries.length === 0) {
+        return "# aoaoe Session Export\n\n_No entries in the selected time range._\n";
+    }
+    const lines = [];
+    const now = new Date();
+    const first = new Date(entries[0].ts);
+    const last = new Date(entries[entries.length - 1].ts);
+    lines.push("# aoaoe Session Export");
+    lines.push("");
+    lines.push(`**Generated**: ${now.toISOString()}`);
+    lines.push(`**Range**: ${first.toISOString()} — ${last.toISOString()}`);
+    lines.push(`**Entries**: ${entries.length}`);
+    lines.push("");
+    lines.push("## Timeline");
+    lines.push("");
+    // group entries by hour
+    let currentHour = "";
+    for (const entry of entries) {
+        const d = new Date(entry.ts);
+        const hour = d.toLocaleString("en-US", {
+            month: "short", day: "numeric", hour: "numeric", minute: undefined, hour12: true,
+        }).replace(/:00/, "");
+        // simpler: just use HH:00 block headers
+        const hourKey = `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")} ${String(d.getHours()).padStart(2, "0")}:00`;
+        if (hourKey !== currentHour) {
+            if (currentHour)
+                lines.push("");
+            lines.push(`### ${hourKey}`);
+            lines.push("");
+            currentHour = hourKey;
+        }
+        const time = `${String(d.getHours()).padStart(2, "0")}:${String(d.getMinutes()).padStart(2, "0")}:${String(d.getSeconds()).padStart(2, "0")}`;
+        const icon = entry.source === "action"
+            ? (entry.success ? "+" : "!")
+            : "·";
+        const sessionPart = entry.session ? ` → ${entry.session}` : "";
+        const text = entry.text.length > 120 ? entry.text.slice(0, 117) + "..." : entry.text;
+        lines.push(`- \`${time}\` ${icon} **${entry.tag}**${sessionPart}: ${text}`);
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+//# sourceMappingURL=export.js.map

package/dist/index.js

@@ -20,6 +20,7 @@ import { isDaemonRunningFromState } from "./chat.js";
 import { sendNotification, sendTestNotification } from "./notify.js";
 import { startHealthServer } from "./health.js";
 import { loadTuiHistory } from "./tui-history.js";
+import { parseActionLogEntries, parseActivityEntries, mergeTimeline, filterByAge, parseDuration, formatTimelineJson, formatTimelineMarkdown } from "./export.js";
 import { actionSession, actionDetail, toActionLogEntry } from "./types.js";
 import { YELLOW, GREEN, DIM, BOLD, RED, RESET } from "./colors.js";
 import { readFileSync, existsSync, statSync, mkdirSync, writeFileSync, chmodSync } from "node:fs";
@@ -30,7 +31,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, 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, registerTitle } = parseCliArgs(process.argv);
     if (help) {
         printHelp();
         process.exit(0);
@@ -103,6 +104,11 @@ async function main() {
         await showLogs(logsActions, logsGrep, logsCount);
         return;
     }
+    // `aoaoe export` -- export session timeline as JSON or Markdown
+    if (runExport) {
+        await runTimelineExport(exportFormat, exportOutput, exportLast);
+        return;
+    }
     // `aoaoe task` -- task management CLI
     if (isTaskCli) {
         await runTaskCli(process.argv);
@@ -1311,6 +1317,47 @@ async function showLogs(actions, grep, count) {
         console.log("");
     }
 }
+// `aoaoe export` -- export session timeline as JSON or Markdown for post-mortems
+async function runTimelineExport(format, output, last) {
+    const fmt = format ?? "json";
+    if (fmt !== "json" && fmt !== "markdown" && fmt !== "md") {
+        console.error(`error: --format must be "json" or "markdown", got "${fmt}"`);
+        process.exit(1);
+    }
+    // parse time window (default 24h)
+    const durationMs = last ? parseDuration(last) : 24 * 60 * 60 * 1000;
+    if (durationMs === null) {
+        console.error(`error: --last must be like "1h", "6h", "24h", "7d", got "${last}"`);
+        process.exit(1);
+    }
+    // read actions.log
+    const actionsFile = join(homedir(), ".aoaoe", "actions.log");
+    let actionEntries = [];
+    try {
+        const lines = readFileSync(actionsFile, "utf-8").trim().split("\n").filter((l) => l.trim());
+        actionEntries = parseActionLogEntries(lines);
+    }
+    catch {
+        // no actions.log — that's fine
+    }
+    // read tui-history.jsonl
+    const historyEntries = loadTuiHistory(10_000, undefined, durationMs);
+    const activityEntries = parseActivityEntries(historyEntries);
+    // merge and filter
+    let timeline = mergeTimeline(actionEntries, activityEntries);
+    timeline = filterByAge(timeline, durationMs);
+    // format
+    const isMarkdown = fmt === "markdown" || fmt === "md";
+    const content = isMarkdown ? formatTimelineMarkdown(timeline) : formatTimelineJson(timeline);
+    // output
+    if (output) {
+        writeFileSync(output, content);
+        console.log(`exported ${timeline.length} entries to ${output}`);
+    }
+    else {
+        process.stdout.write(content);
+    }
+}
 // `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.62.0",
+  "version": "0.64.0",
   "description": "Autonomous supervisor for agent-of-empires sessions using OpenCode or Claude Code",
   "type": "module",
   "main": "dist/index.js",