aoaoe 0.60.0 → 0.62.0

package/README.md

@@ -342,6 +342,7 @@ Config lives at `~/.aoaoe/aoaoe.config.json` (canonical, written by `aoaoe init`
 | `notifications.slackWebhookUrl` | Slack incoming webhook URL (block kit format) | (none) |
 | `notifications.events` | Filter which events fire (omit to send all). Valid: `session_error`, `session_done`, `action_executed`, `action_failed`, `daemon_started`, `daemon_stopped` | (all) |
 | `notifications.maxRetries` | Retry failed webhook deliveries with exponential backoff (1s, 2s, 4s, ...) | `0` (no retry) |
+| `tuiHistoryRetentionDays` | How many days of TUI history to replay on startup (1-365) | `7` |
 
 Also reads `.aoaoe.json` as an alternative config filename.
 
@@ -497,6 +498,7 @@ src/
   dashboard.ts      # periodic CLI status table with task column
   daemon-state.ts   # shared IPC state file + interrupt flag
   tui.ts            # in-place terminal UI (alternate screen, scroll regions)
+  tui-history.ts    # persisted TUI history (JSONL file with rotation, replay on startup)
   input.ts          # stdin readline listener with inject() for post-interrupt
   init.ts           # `aoaoe init`: auto-discover tools, sessions, generate config
   notify.ts         # webhook + Slack notification dispatcher for daemon events

package/dist/config.js

@@ -83,7 +83,7 @@ export function loadConfig(overrides) {
 const KNOWN_KEYS = {
     reasoner: true, pollIntervalMs: true, captureLinesCount: true,
     verbose: true, dryRun: true, observe: true, confirm: true,
-    contextFiles: true, sessionDirs: true, protectedSessions: true, healthPort: true,
+    contextFiles: true, sessionDirs: true, protectedSessions: true, healthPort: true, tuiHistoryRetentionDays: true,
     opencode: new Set(["port", "model"]),
     claudeCode: new Set(["model", "yolo", "resume"]),
     aoe: new Set(["profile"]),
@@ -133,6 +133,13 @@ export function validateConfig(config) {
             errors.push(`healthPort must be 1-65535, got ${config.healthPort}`);
         }
     }
+    // tuiHistoryRetentionDays: must be a positive integer, 1-365
+    if (config.tuiHistoryRetentionDays !== undefined) {
+        const d = config.tuiHistoryRetentionDays;
+        if (typeof d !== "number" || !isFinite(d) || !Number.isInteger(d) || d < 1 || d > 365) {
+            errors.push(`tuiHistoryRetentionDays must be an integer 1-365, got ${d}`);
+        }
+    }
     if (typeof config.policies?.maxErrorsBeforeRestart !== "number" || config.policies.maxErrorsBeforeRestart < 1) {
         errors.push(`policies.maxErrorsBeforeRestart must be >= 1, got ${config.policies?.maxErrorsBeforeRestart}`);
     }
@@ -540,6 +547,7 @@ example config:
       "other-repo": "/path/to/other-repo"
     },
     "healthPort": 4098,
+    "tuiHistoryRetentionDays": 7,
     "notifications": {
       "webhookUrl": "https://example.com/webhook",
       "slackWebhookUrl": "https://hooks.slack.com/services/T.../B.../xxx",
@@ -552,6 +560,9 @@ example config:
   aoaoe loads AGENTS.md, claude.md, and other AI instruction files
   from each project directory to give the reasoner per-session context.
 
+  tuiHistoryRetentionDays controls how many days of TUI history to replay
+  on daemon startup (default: 7, range: 1-365). History file rotates at 50MB.
+
   notifications sends webhook alerts for daemon events. Both webhookUrl
   and slackWebhookUrl are optional. events filters which events fire
   (omit to send all). maxRetries enables exponential backoff retry on

package/dist/index.js

@@ -19,6 +19,7 @@ import { TUI } from "./tui.js";
 import { isDaemonRunningFromState } from "./chat.js";
 import { sendNotification, sendTestNotification } from "./notify.js";
 import { startHealthServer } from "./health.js";
+import { loadTuiHistory } from "./tui-history.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";
@@ -230,6 +231,12 @@ async function main() {
     await reasonerConsole.start();
     // start TUI (alternate screen buffer) after input is ready
     if (tui) {
+        // replay persisted history from previous runs before entering alt screen
+        const retentionDays = config.tuiHistoryRetentionDays ?? 7;
+        const retentionMs = retentionDays * 24 * 60 * 60 * 1000;
+        const history = loadTuiHistory(200, undefined, retentionMs);
+        if (history.length > 0)
+            tui.replayHistory(history);
         tui.start(pkg || "dev");
         tui.updateState({ reasonerName: config.observe ? "observe-only" : config.reasoner });
         // welcome banner — plain-English explanation of what's happening

package/dist/tui-history.d.ts

@@ -0,0 +1,28 @@
+/** JSONL entry format — extends ActivityEntry with epoch timestamp for filtering */
+export interface HistoryEntry {
+    ts: number;
+    time: string;
+    tag: string;
+    text: string;
+}
+/**
+ * Append a single history entry to the JSONL file.
+ * Fire-and-forget — errors are silently swallowed so they never block the TUI.
+ * Rotates the file if it exceeds MAX_FILE_SIZE before appending.
+ */
+export declare function appendHistoryEntry(entry: HistoryEntry, filePath?: string, maxSize?: number): void;
+/**
+ * Load recent TUI history entries from the JSONL file.
+ * Returns the last `maxEntries` entries (default 200), newest last.
+ * Filters out entries older than `maxAgeMs` (default: 7 days).
+ * Returns empty array if the file doesn't exist or is unreadable.
+ */
+export declare function loadTuiHistory(maxEntries?: number, filePath?: string, maxAgeMs?: number): HistoryEntry[];
+/**
+ * Rotate the history file if it exceeds the size threshold.
+ * Renames current file to .old (overwriting any previous .old) and starts fresh.
+ */
+export declare function rotateTuiHistory(filePath?: string, maxSize?: number): boolean;
+/** Default history file path (for wiring in index.ts) */
+export declare const TUI_HISTORY_FILE: string;
+//# sourceMappingURL=tui-history.d.ts.map

package/dist/tui-history.js

@@ -0,0 +1,91 @@
+// tui-history.ts — persisted TUI activity history
+// JSONL file at ~/.aoaoe/tui-history.jsonl with rotation at 50MB.
+// pure exported functions for testability — no classes, no singletons.
+import { appendFileSync, readFileSync, renameSync, statSync, mkdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const AOAOE_DIR = join(homedir(), ".aoaoe");
+const HISTORY_FILE = join(AOAOE_DIR, "tui-history.jsonl");
+const HISTORY_OLD = join(AOAOE_DIR, "tui-history.jsonl.old");
+const MAX_FILE_SIZE = 50 * 1024 * 1024; // 50MB rotation threshold
+/**
+ * Append a single history entry to the JSONL file.
+ * Fire-and-forget — errors are silently swallowed so they never block the TUI.
+ * Rotates the file if it exceeds MAX_FILE_SIZE before appending.
+ */
+export function appendHistoryEntry(entry, filePath = HISTORY_FILE, maxSize = MAX_FILE_SIZE) {
+    try {
+        const dir = join(filePath, "..");
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        rotateTuiHistory(filePath, maxSize);
+        const line = JSON.stringify(entry) + "\n";
+        appendFileSync(filePath, line, "utf-8");
+    }
+    catch {
+        // fire-and-forget — never crash the daemon over history persistence
+    }
+}
+/**
+ * Load recent TUI history entries from the JSONL file.
+ * Returns the last `maxEntries` entries (default 200), newest last.
+ * Filters out entries older than `maxAgeMs` (default: 7 days).
+ * Returns empty array if the file doesn't exist or is unreadable.
+ */
+export function loadTuiHistory(maxEntries = 200, filePath = HISTORY_FILE, maxAgeMs = 7 * 24 * 60 * 60 * 1000) {
+    try {
+        if (!existsSync(filePath))
+            return [];
+        const content = readFileSync(filePath, "utf-8");
+        const lines = content.split("\n").filter((l) => l.trim());
+        const cutoff = Date.now() - maxAgeMs;
+        const recent = lines.slice(-maxEntries * 2); // read extra to compensate for age filtering
+        const entries = [];
+        for (const line of recent) {
+            try {
+                const parsed = JSON.parse(line);
+                if (isValidEntry(parsed) && parsed.ts >= cutoff)
+                    entries.push(parsed);
+            }
+            catch {
+                // skip malformed lines
+            }
+        }
+        return entries.slice(-maxEntries);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Rotate the history file if it exceeds the size threshold.
+ * Renames current file to .old (overwriting any previous .old) and starts fresh.
+ */
+export function rotateTuiHistory(filePath = HISTORY_FILE, maxSize = MAX_FILE_SIZE) {
+    try {
+        if (!existsSync(filePath))
+            return false;
+        const size = statSync(filePath).size;
+        if (size < maxSize)
+            return false;
+        const oldPath = filePath + ".old";
+        renameSync(filePath, oldPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Validate that a parsed JSON value has the shape of a HistoryEntry */
+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");
+}
+/** Default history file path (for wiring in index.ts) */
+export const TUI_HISTORY_FILE = HISTORY_FILE;
+//# sourceMappingURL=tui-history.js.map

package/dist/tui.d.ts

@@ -1,4 +1,5 @@
 import type { DaemonSessionState, DaemonPhase } from "./types.js";
+import type { HistoryEntry } from "./tui-history.js";
 declare function phaseDisplay(phase: DaemonPhase, paused: boolean, spinnerFrame: number): string;
 export interface ActivityEntry {
     time: string;
@@ -38,6 +39,7 @@ export declare class TUI {
         nextTickAt?: number;
     }): void;
     log(tag: string, text: string): void;
+    replayHistory(entries: HistoryEntry[]): void;
     private updateDimensions;
     private computeLayout;
     private onResize;

package/dist/tui.js

@@ -1,4 +1,5 @@
 import { BOLD, DIM, RESET, GREEN, CYAN, WHITE, BG_DARK, INDIGO, TEAL, AMBER, SLATE, ROSE, LIME, SKY, BOX, SPINNER, DOT, } from "./colors.js";
+import { appendHistoryEntry } from "./tui-history.js";
 // ── ANSI helpers ────────────────────────────────────────────────────────────
 const ESC = "\x1b";
 const CSI = `${ESC}[`;
@@ -140,6 +141,19 @@ export class TUI {
         }
         if (this.active)
             this.writeActivityLine(entry);
+        // persist to disk (fire-and-forget, never blocks)
+        appendHistoryEntry({ ts: now.getTime(), time, tag, text });
+    }
+    // populate activity buffer from persisted history before start()
+    // entries are loaded from the JSONL file and added to the in-memory buffer
+    replayHistory(entries) {
+        for (const e of entries) {
+            this.activityBuffer.push({ time: e.time, tag: e.tag, text: e.text });
+        }
+        // trim to max
+        if (this.activityBuffer.length > this.maxActivity) {
+            this.activityBuffer = this.activityBuffer.slice(-this.maxActivity);
+        }
     }
     // ── Layout computation ──────────────────────────────────────────────────
     updateDimensions() {

package/dist/types.d.ts

@@ -122,6 +122,7 @@ export interface AoaoeConfig {
         maxRetries?: number;
     };
     healthPort?: number;
+    tuiHistoryRetentionDays?: number;
 }
 export type NotificationEvent = "session_error" | "session_done" | "action_executed" | "action_failed" | "daemon_started" | "daemon_stopped";
 export type DaemonPhase = "sleeping" | "polling" | "reasoning" | "executing" | "interrupted";

package/package.json

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