aoaoe 0.191.0 → 0.192.0

package/dist/backup.d.ts

@@ -0,0 +1,11 @@
+export declare function createBackup(outputPath?: string): Promise<string>;
+export declare function restoreBackup(inputPath: string): Promise<{
+    restored: string[];
+    skipped: string[];
+}>;
+export declare function formatBackupResult(path: string): string;
+export declare function formatRestoreResult(result: {
+    restored: string[];
+    skipped: string[];
+}): string;
+//# sourceMappingURL=backup.d.ts.map

package/dist/backup.js

@@ -0,0 +1,121 @@
+// backup.ts — backup and restore aoaoe state + config for portability.
+// backs up ~/.aoaoe/ contents to a timestamped tarball or directory.
+import { existsSync, mkdirSync, readdirSync, copyFileSync, statSync } from "node:fs";
+import { join, basename } from "node:path";
+import { homedir } from "node:os";
+import { exec } from "./shell.js";
+import { DIM, GREEN, YELLOW, RESET } from "./colors.js";
+const AOAOE_DIR = join(homedir(), ".aoaoe");
+// files to include in backup (relative to ~/.aoaoe/)
+const BACKUP_FILES = [
+    "aoaoe.config.json",
+    "task-state.json",
+    "supervisor-history.jsonl",
+    "pin-presets.json",
+    "templates.json",
+    "prompt-templates.json",
+    "tui-prefs.json",
+];
+export async function createBackup(outputPath) {
+    if (!existsSync(AOAOE_DIR)) {
+        throw new Error("~/.aoaoe/ does not exist — nothing to back up");
+    }
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
+    const defaultPath = join(process.cwd(), `aoaoe-backup-${timestamp}`);
+    const target = outputPath || defaultPath;
+    // also include aoaoe.tasks.json from cwd if it exists
+    const cwdTasksFile = join(process.cwd(), "aoaoe.tasks.json");
+    // try tar first (most portable)
+    const tarTarget = target.endsWith(".tar.gz") ? target : `${target}.tar.gz`;
+    const filesToBackup = [];
+    for (const f of BACKUP_FILES) {
+        const full = join(AOAOE_DIR, f);
+        if (existsSync(full))
+            filesToBackup.push(full);
+    }
+    if (existsSync(cwdTasksFile))
+        filesToBackup.push(cwdTasksFile);
+    if (filesToBackup.length === 0) {
+        throw new Error("no files to back up");
+    }
+    const result = await exec("tar", [
+        "czf", tarTarget,
+        ...filesToBackup.map((f) => f),
+    ]);
+    if (result.exitCode === 0) {
+        const size = statSync(tarTarget).size;
+        const sizeStr = size < 1024 ? `${size}B` : `${(size / 1024).toFixed(1)}KB`;
+        return `${tarTarget} (${filesToBackup.length} files, ${sizeStr})`;
+    }
+    // tar failed — fall back to directory copy
+    mkdirSync(target, { recursive: true });
+    let count = 0;
+    for (const full of filesToBackup) {
+        const name = basename(full);
+        copyFileSync(full, join(target, name));
+        count++;
+    }
+    return `${target}/ (${count} files copied)`;
+}
+export async function restoreBackup(inputPath) {
+    const restored = [];
+    const skipped = [];
+    if (!existsSync(inputPath)) {
+        throw new Error(`backup not found: ${inputPath}`);
+    }
+    if (!existsSync(AOAOE_DIR)) {
+        mkdirSync(AOAOE_DIR, { recursive: true });
+    }
+    // try tar extraction
+    if (inputPath.endsWith(".tar.gz") || inputPath.endsWith(".tgz")) {
+        const result = await exec("tar", ["xzf", inputPath, "-C", "/"]);
+        if (result.exitCode === 0) {
+            // check what was restored
+            for (const f of BACKUP_FILES) {
+                if (existsSync(join(AOAOE_DIR, f)))
+                    restored.push(f);
+            }
+            return { restored, skipped };
+        }
+        throw new Error(`tar extraction failed: ${result.stderr}`);
+    }
+    // directory restore
+    if (!statSync(inputPath).isDirectory()) {
+        throw new Error(`${inputPath} is not a directory or tar.gz archive`);
+    }
+    const files = readdirSync(inputPath);
+    for (const f of files) {
+        const src = join(inputPath, f);
+        if (f === "aoaoe.tasks.json") {
+            // restore to cwd
+            copyFileSync(src, join(process.cwd(), f));
+            restored.push(f);
+        }
+        else if (BACKUP_FILES.includes(f)) {
+            copyFileSync(src, join(AOAOE_DIR, f));
+            restored.push(f);
+        }
+        else {
+            skipped.push(f);
+        }
+    }
+    return { restored, skipped };
+}
+export function formatBackupResult(path) {
+    return `  ${GREEN}✓${RESET} backup created: ${path}`;
+}
+export function formatRestoreResult(result) {
+    const lines = [];
+    if (result.restored.length > 0) {
+        lines.push(`  ${GREEN}✓${RESET} restored ${result.restored.length} file(s):`);
+        for (const f of result.restored)
+            lines.push(`    ${DIM}${f}${RESET}`);
+    }
+    if (result.skipped.length > 0) {
+        lines.push(`  ${YELLOW}!${RESET} skipped ${result.skipped.length} file(s):`);
+        for (const f of result.skipped)
+            lines.push(`    ${DIM}${f}${RESET}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=backup.js.map

package/dist/config.d.ts

@@ -61,6 +61,10 @@ export declare function parseCliArgs(argv: string[]): {
     configDiff: boolean;
     notifyTest: boolean;
     runDoctor: boolean;
+    runBackup: boolean;
+    backupOutput?: string;
+    runRestore: boolean;
+    restoreInput?: string;
     runLogs: boolean;
     logsActions: boolean;
     logsGrep?: string;
@@ -69,6 +73,7 @@ export declare function parseCliArgs(argv: string[]): {
     exportFormat?: string;
     exportOutput?: string;
     exportLast?: string;
+    exportTasks: boolean;
     runInit: boolean;
     initForce: boolean;
     runTaskCli: boolean;

package/dist/config.js

@@ -333,7 +333,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, showTasksJson: false, runProgress: false, progressSince: undefined, progressJson: false, runHealth: false, healthJson: false, runSummary: false, runAdopt: false, adoptTemplate: undefined, showHistory: false, showStatus: false, runRunbook: false, runbookJson: false, runbookSection: undefined, runIncident: false, incidentSince: undefined, incidentLimit: undefined, incidentJson: false, incidentNdjson: false, incidentWatch: false, incidentChangesOnly: false, incidentHeartbeatSec: undefined, incidentIntervalMs: undefined, runSupervisor: false, supervisorAll: false, supervisorSince: undefined, supervisorLimit: undefined, supervisorJson: false, supervisorNdjson: false, supervisorWatch: false, supervisorChangesOnly: false, supervisorHeartbeatSec: undefined, supervisorIntervalMs: undefined, 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 };
+    const defaults = { overrides, help: false, version: false, register: false, testContext: false, runTest: false, showTasks: false, showTasksJson: false, runProgress: false, progressSince: undefined, progressJson: false, runHealth: false, healthJson: false, runSummary: false, runAdopt: false, adoptTemplate: undefined, showHistory: false, showStatus: false, runRunbook: false, runbookJson: false, runbookSection: undefined, runIncident: false, incidentSince: undefined, incidentLimit: undefined, incidentJson: false, incidentNdjson: false, incidentWatch: false, incidentChangesOnly: false, incidentHeartbeatSec: undefined, incidentIntervalMs: undefined, runSupervisor: false, supervisorAll: false, supervisorSince: undefined, supervisorLimit: undefined, supervisorJson: false, supervisorNdjson: false, supervisorWatch: false, supervisorChangesOnly: false, supervisorHeartbeatSec: undefined, supervisorIntervalMs: undefined, showConfig: false, configValidate: false, configDiff: false, notifyTest: false, runDoctor: false, runBackup: false, backupOutput: undefined, runRestore: false, restoreInput: undefined, runLogs: false, logsActions: false, logsGrep: undefined, logsCount: undefined, runExport: false, exportFormat: undefined, exportOutput: undefined, exportLast: undefined, exportTasks: false, 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 };
@@ -531,6 +531,14 @@ export function parseCliArgs(argv) {
     if (argv[2] === "doctor") {
         return { ...defaults, runDoctor: true };
     }
+    if (argv[2] === "backup") {
+        const output = argv[3] && !argv[3].startsWith("-") ? argv[3] : undefined;
+        return { ...defaults, runBackup: true, backupOutput: output };
+    }
+    if (argv[2] === "restore") {
+        const input = argv[3] && !argv[3].startsWith("-") ? argv[3] : undefined;
+        return { ...defaults, runRestore: true, restoreInput: input };
+    }
     if (argv[2] === "logs") {
         const actions = argv.includes("--actions") || argv.includes("-a");
         let grep;
@@ -551,7 +559,10 @@ export function parseCliArgs(argv) {
         let format;
         let output;
         let last;
+        const exportTasks = argv.includes("--tasks");
         for (let i = 3; i < argv.length; i++) {
+            if (argv[i] === "--tasks")
+                continue;
             if ((argv[i] === "--format" || argv[i] === "-f") && argv[i + 1]) {
                 format = argv[++i];
             }
@@ -562,7 +573,7 @@ export function parseCliArgs(argv) {
                 last = argv[++i];
             }
         }
-        return { ...defaults, runExport: true, exportFormat: format, exportOutput: output, exportLast: last };
+        return { ...defaults, runExport: true, exportFormat: format, exportOutput: output, exportLast: last, exportTasks };
     }
     if (argv[2] === "init") {
         const force = argv.includes("--force") || argv.includes("-f");
@@ -717,7 +728,7 @@ export function parseCliArgs(argv) {
                 break;
         }
     }
-    return { overrides, help, version, register: false, testContext: false, runTest: false, showTasks: false, showTasksJson: false, runProgress: false, progressSince: undefined, progressJson: false, runHealth: false, healthJson: false, runSummary: false, runAdopt: false, adoptTemplate: undefined, showHistory: false, showStatus: false, runRunbook: false, runbookJson: false, runbookSection: undefined, runIncident: false, incidentSince: undefined, incidentLimit: undefined, incidentJson: false, incidentNdjson: false, incidentWatch: false, incidentChangesOnly: false, incidentHeartbeatSec: undefined, incidentIntervalMs: undefined, runSupervisor: false, supervisorAll: false, supervisorSince: undefined, supervisorLimit: undefined, supervisorJson: false, supervisorNdjson: false, supervisorWatch: false, supervisorChangesOnly: false, supervisorHeartbeatSec: undefined, supervisorIntervalMs: undefined, 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 };
+    return { overrides, help, version, register: false, testContext: false, runTest: false, showTasks: false, showTasksJson: false, runProgress: false, progressSince: undefined, progressJson: false, runHealth: false, healthJson: false, runSummary: false, runAdopt: false, adoptTemplate: undefined, showHistory: false, showStatus: false, runRunbook: false, runbookJson: false, runbookSection: undefined, runIncident: false, incidentSince: undefined, incidentLimit: undefined, incidentJson: false, incidentNdjson: false, incidentWatch: false, incidentChangesOnly: false, incidentHeartbeatSec: undefined, incidentIntervalMs: undefined, runSupervisor: false, supervisorAll: false, supervisorSince: undefined, supervisorLimit: undefined, supervisorJson: false, supervisorNdjson: false, supervisorWatch: false, supervisorChangesOnly: false, supervisorHeartbeatSec: undefined, supervisorIntervalMs: undefined, showConfig: false, configValidate: false, configDiff: false, notifyTest: false, runDoctor: false, runBackup: false, backupOutput: undefined, runRestore: false, restoreInput: undefined, runLogs: false, logsActions: false, logsGrep: undefined, logsCount: undefined, runExport: false, exportFormat: undefined, exportOutput: undefined, exportLast: undefined, exportTasks: false, 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
@@ -761,6 +772,8 @@ commands:
   config --validate  validate config + check tool availability
   config --diff  show only fields that differ from defaults
   notify-test    send a test notification to configured webhooks
+  backup [path]  backup ~/.aoaoe/ state + config to tarball
+  restore <path> restore from backup tarball or directory
   doctor         comprehensive health check (config, tools, daemon, disk)
   logs           show recent conversation log entries (last 50)
   logs --actions show action log entries (from ~/.aoaoe/actions.log)
@@ -770,6 +783,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)
+  export --tasks                   export task history instead of timeline
+  export --tasks --format md       export task history as markdown
   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

package/dist/export.d.ts

@@ -1,3 +1,4 @@
+import type { TaskState } from "./types.js";
 import type { HistoryEntry } from "./tui-history.js";
 export interface TimelineEntry {
     ts: number;
@@ -14,4 +15,6 @@ export declare function filterByAge(entries: TimelineEntry[], maxAgeMs: number,
 export declare function parseDuration(input: string): number | null;
 export declare function formatTimelineJson(entries: TimelineEntry[]): string;
 export declare function formatTimelineMarkdown(entries: TimelineEntry[]): string;
+export declare function formatTaskExportJson(tasks: TaskState[]): string;
+export declare function formatTaskExportMarkdown(tasks: TaskState[]): string;
 //# sourceMappingURL=export.d.ts.map

package/dist/export.js

@@ -129,4 +129,61 @@ export function formatTimelineMarkdown(entries) {
     lines.push("");
     return lines.join("\n");
 }
+// ── task export ─────────────────────────────────────────────────────────────
+export function formatTaskExportJson(tasks) {
+    const payload = tasks.map((t) => ({
+        session: t.sessionTitle,
+        repo: t.repo,
+        status: t.status,
+        goal: t.goal,
+        dependsOn: t.dependsOn ?? [],
+        createdAt: t.createdAt ?? null,
+        completedAt: t.completedAt ?? null,
+        lastProgressAt: t.lastProgressAt ?? null,
+        progressCount: t.progress.length,
+        progress: t.progress.map((p) => ({
+            at: p.at,
+            time: new Date(p.at).toISOString(),
+            summary: p.summary,
+        })),
+    }));
+    return JSON.stringify(payload, null, 2);
+}
+export function formatTaskExportMarkdown(tasks) {
+    const lines = [];
+    lines.push("# Task History Export");
+    lines.push("");
+    lines.push(`Generated: ${new Date().toISOString()}`);
+    lines.push(`Tasks: ${tasks.length}`);
+    lines.push("");
+    for (const t of tasks) {
+        const icon = t.status === "completed" ? "✓"
+            : t.status === "active" ? "●"
+                : t.status === "paused" ? "◎"
+                    : t.status === "failed" ? "✗"
+                        : "○";
+        lines.push(`## ${icon} ${t.sessionTitle} (${t.status})`);
+        lines.push("");
+        lines.push(`- **Goal**: ${t.goal}`);
+        lines.push(`- **Repo**: ${t.repo}`);
+        if (t.dependsOn?.length)
+            lines.push(`- **Depends on**: ${t.dependsOn.join(", ")}`);
+        if (t.createdAt)
+            lines.push(`- **Created**: ${new Date(t.createdAt).toISOString()}`);
+        if (t.completedAt)
+            lines.push(`- **Completed**: ${new Date(t.completedAt).toISOString()}`);
+        lines.push(`- **Progress entries**: ${t.progress.length}`);
+        lines.push("");
+        if (t.progress.length > 0) {
+            lines.push("### Progress");
+            lines.push("");
+            for (const p of t.progress) {
+                const time = new Date(p.at).toLocaleString();
+                lines.push(`- **${time}**: ${p.summary}`);
+            }
+            lines.push("");
+        }
+    }
+    return lines.join("\n");
+}
 //# sourceMappingURL=export.js.map

package/dist/index.js

@@ -28,7 +28,7 @@ import { savePreset, deletePreset, getPreset, formatPresetList } from "./pin-pre
 import { resolvePromptTemplate, formatPromptTemplateList } from "./reasoner/prompt-templates.js";
 import { formatHealthReport, computeAllHealth } from "./health-score.js";
 import { ConfigWatcher, formatConfigChange } from "./config-watcher.js";
-import { parseActionLogEntries, parseActivityEntries, mergeTimeline, filterByAge, parseDuration, formatTimelineJson, formatTimelineMarkdown } from "./export.js";
+import { parseActionLogEntries, parseActivityEntries, mergeTimeline, filterByAge, parseDuration, formatTimelineJson, formatTimelineMarkdown, formatTaskExportJson, formatTaskExportMarkdown } 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";
@@ -40,7 +40,7 @@ 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
 const TASK_RECONCILE_EVERY_POLLS = 6;
 async function main() {
-    const { overrides, help, version, register, testContext: isTestContext, runTest, showTasks, showTasksJson, runProgress, progressSince, progressJson, runHealth, healthJson, runSummary, runAdopt, adoptTemplate, showHistory, showStatus, runRunbook, runbookJson, runbookSection, runIncident, incidentSince, incidentLimit, incidentJson, incidentNdjson, incidentWatch, incidentChangesOnly, incidentHeartbeatSec, incidentIntervalMs, runSupervisor, supervisorAll, supervisorSince, supervisorLimit, supervisorJson, supervisorNdjson, supervisorWatch, supervisorChangesOnly, supervisorHeartbeatSec, supervisorIntervalMs, 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);
+    const { overrides, help, version, register, testContext: isTestContext, runTest, showTasks, showTasksJson, runProgress, progressSince, progressJson, runHealth, healthJson, runSummary, runAdopt, adoptTemplate, showHistory, showStatus, runRunbook, runbookJson, runbookSection, runIncident, incidentSince, incidentLimit, incidentJson, incidentNdjson, incidentWatch, incidentChangesOnly, incidentHeartbeatSec, incidentIntervalMs, runSupervisor, supervisorAll, supervisorSince, supervisorLimit, supervisorJson, supervisorNdjson, supervisorWatch, supervisorChangesOnly, supervisorHeartbeatSec, supervisorIntervalMs, showConfig, configValidate, configDiff, notifyTest, runDoctor, runBackup, backupOutput, runRestore, restoreInput, 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);
@@ -71,7 +71,7 @@ async function main() {
         return;
     }
     // suppress noisy [tasks] [config] log lines in one-shot CLI commands
-    if (showTasks || runProgress || runHealth || runSummary || runAdopt || showStatus || runRunbook || runIncident || runSupervisor) {
+    if (showTasks || runProgress || runHealth || runSummary || runAdopt || runBackup || runRestore || runExport || showStatus || runRunbook || runIncident || runSupervisor) {
         process.env.AOAOE_QUIET = "1";
     }
     // `aoaoe tasks` -- show current task state
@@ -147,6 +147,33 @@ async function main() {
         await runDoctorCheck();
         return;
     }
+    if (runBackup) {
+        try {
+            const result = await createBackup(backupOutput);
+            console.log(formatBackupResult(result));
+        }
+        catch (err) {
+            console.error(`backup failed: ${err instanceof Error ? err.message : err}`);
+            process.exitCode = 1;
+        }
+        return;
+    }
+    if (runRestore) {
+        if (!restoreInput) {
+            console.error("usage: aoaoe restore <backup-path>");
+            process.exitCode = 1;
+            return;
+        }
+        try {
+            const result = await restoreBackup(restoreInput);
+            console.log(formatRestoreResult(result));
+        }
+        catch (err) {
+            console.error(`restore failed: ${err instanceof Error ? err.message : err}`);
+            process.exitCode = 1;
+        }
+        return;
+    }
     // `aoaoe logs` -- show conversation or action log entries
     if (runLogs) {
         await showLogs(logsActions, logsGrep, logsCount);
@@ -154,9 +181,42 @@ async function main() {
     }
     // `aoaoe export` -- export session timeline as JSON or Markdown
     if (runExport) {
-        await runTimelineExport(exportFormat, exportOutput, exportLast);
+        const { exportTasks } = parseCliArgs(process.argv);
+        if (exportTasks) {
+            await runTaskExport(exportFormat, exportOutput);
+        }
+        else {
+            await runTimelineExport(exportFormat, exportOutput, exportLast);
+        }
         return;
     }
+    async function runTaskExport(format, output) {
+        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);
+        }
+        const basePath = process.cwd();
+        const defs = loadTaskDefinitions(basePath);
+        const taskProfiles = resolveProfiles(loadConfig());
+        const tm = defs.length > 0 ? new TaskManager(basePath, defs, taskProfiles) : undefined;
+        const tasks = tm?.tasks ?? [...loadTaskState().values()];
+        if (tasks.length === 0) {
+            console.error("no tasks to export");
+            return;
+        }
+        const isMarkdown = fmt === "markdown" || fmt === "md";
+        const content = isMarkdown ? formatTaskExportMarkdown(tasks) : formatTaskExportJson(tasks);
+        if (output) {
+            writeFileSync(output, content);
+            console.log(`exported ${tasks.length} task(s) to ${output}`);
+        }
+        else {
+            process.stdout.write(content);
+            if (!content.endsWith("\n"))
+                process.stdout.write("\n");
+        }
+    }
     // `aoaoe stats` -- show aggregate daemon statistics
     if (isStats) {
         await runStatsCommand(statsLast);
@@ -4469,6 +4529,7 @@ async function showProgressDigest(since, asJson = false) {
     console.log(formatProgressDigest(tasks, maxAgeMs));
 }
 import { resolveTemplate } from "./task-templates.js";
+import { createBackup, restoreBackup, formatBackupResult, formatRestoreResult } from "./backup.js";
 // adopt untracked live AoE sessions as tasks with optional template goal.
 async function adoptUntrackedSessions(templateName) {
     const basePath = process.cwd();

package/dist/task-cli.js

@@ -6,7 +6,7 @@ import { resolve, basename } from "node:path";
 import { buildProfileListArgs } from "./poller.js";
 import { loadConfig } from "./config.js";
 import { resolveProfiles } from "./tui.js";
-import { loadTaskState, saveTaskState, formatTaskTable, syncTaskDefinitionsFromState, taskStateKey, resolveTaskRepoPath, TaskManager, loadTaskDefinitions, injectGoalToSession } from "./task-manager.js";
+import { loadTaskState, saveTaskState, formatTaskTable, formatTaskHistory, syncTaskDefinitionsFromState, taskStateKey, resolveTaskRepoPath, TaskManager, loadTaskDefinitions, injectGoalToSession } from "./task-manager.js";
 import { goalToList } from "./types.js";
 import { resolveTemplate, formatTemplateList } from "./task-templates.js";
 import { BOLD, DIM, GREEN, YELLOW, RED, RESET } from "./colors.js";
@@ -26,6 +26,7 @@ function getTaskProfiles() {
 function taskCommandHelp(prefix = "aoaoe task") {
     return [
         `${prefix} list                     show tracked tasks`,
+        `${prefix} history [session]         show progress history (all or one session)`,
         `${prefix} templates                show available task templates`,
         `${prefix} reconcile                link/create sessions now`,
         `${prefix} new <title> <path>       create task + session`,
@@ -454,6 +455,13 @@ export async function runTaskCli(argv) {
             console.log(formatTemplateList());
             return;
         }
+        case "history": {
+            const states = loadTaskState();
+            const tasks = [...states.values()];
+            const sessionFilter = args[0] || undefined;
+            console.log(formatTaskHistory(tasks, sessionFilter));
+            return;
+        }
         case "reconcile": {
             const basePath = process.cwd();
             const defs = loadTaskDefinitions(basePath);
@@ -623,6 +631,12 @@ export async function handleTaskSlashCommand(args) {
     if (sub === "templates" || sub === "template") {
         return formatTemplateList();
     }
-    return "usage: /task [list|start|stop|edit|new|rm|reconcile|templates|help] [args]";
+    if (sub === "history") {
+        const states = loadTaskState();
+        const tasks = [...states.values()];
+        const sessionFilter = rest[0] || undefined;
+        return formatTaskHistory(tasks, sessionFilter);
+    }
+    return "usage: /task [list|start|stop|edit|new|rm|reconcile|templates|history|help] [args]";
 }
 //# sourceMappingURL=task-cli.js.map

package/dist/task-manager.d.ts

@@ -43,6 +43,7 @@ export declare function deriveTitle(repo: string): string;
  */
 export declare function readNextRoadmapItems(basePath: string, maxItems?: number): string;
 export declare function formatTaskTable(states: Map<string, TaskState> | TaskState[]): string;
+export declare function formatTaskHistory(tasks: TaskState[], sessionFilter?: string): string;
 export declare function formatAgo(ms: number): string;
 export declare function formatProgressDigest(tasks: TaskState[], maxAgeMs?: number): string;
 //# sourceMappingURL=task-manager.d.ts.map

package/dist/task-manager.js

@@ -629,6 +629,37 @@ export function formatTaskTable(states) {
     }
     return lines.join("\n");
 }
+// format detailed progress history for one or all tasks.
+export function formatTaskHistory(tasks, sessionFilter) {
+    const filtered = sessionFilter
+        ? tasks.filter((t) => t.sessionTitle.toLowerCase() === sessionFilter.toLowerCase()
+            || t.sessionTitle.toLowerCase().includes(sessionFilter.toLowerCase()))
+        : tasks;
+    if (filtered.length === 0) {
+        return sessionFilter ? `  no task found matching "${sessionFilter}"` : "  (no tasks)";
+    }
+    const lines = [];
+    for (const t of filtered) {
+        const statusIcon = t.status === "completed" ? "✓"
+            : t.status === "active" ? "●"
+                : t.status === "paused" ? "◎"
+                    : t.status === "failed" ? "✗"
+                        : "○";
+        lines.push(`  ${statusIcon} ${BOLD}${t.sessionTitle}${RESET} ${DIM}(${t.status})${RESET}`);
+        lines.push(`    ${DIM}goal: ${t.goal.length > 80 ? t.goal.slice(0, 77) + "..." : t.goal}${RESET}`);
+        if (t.progress.length === 0) {
+            lines.push(`    ${DIM}(no progress entries)${RESET}`);
+        }
+        else {
+            for (const p of t.progress) {
+                const ts = new Date(p.at).toLocaleString();
+                lines.push(`    ${DIM}${ts}${RESET}  ${p.summary}`);
+            }
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
 export function formatAgo(ms) {
     if (ms < 60_000)
         return `${Math.round(ms / 1000)}s ago`;

package/package.json

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