aoaoe 0.190.0 → 0.192.0

package/README.md

@@ -657,6 +657,7 @@ Config lives at `~/.aoaoe/aoaoe.config.json` (canonical, written by `aoaoe init`
 | `policies.autoAnswerPermissions` | Auto-approve permission prompts | `true` |
 | `policies.allowDestructive` | Allow `remove_agent` and `stop_session` actions | `false` |
 | `policies.maxStuckNudgesBeforePause` | Auto-pause task after N nudges with no progress (0 = disabled) | `0` |
+| `policies.quietHours` | Skip reasoning during these hours, e.g. `"01:00-06:00"` (polling continues) | (none) |
 | `promptTemplate` | Reasoner prompt strategy: `default`, `hands-off`, `aggressive`, `review-focused`, `shipping` | `"default"` |
 | `policies.userActivityThresholdMs` | Ignore sessions with recent human keystrokes | `30000` |
 | `policies.actionCooldownMs` | Minimum ms between actions on the same session | `30000` |

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/executor.js

@@ -213,8 +213,11 @@ export class Executor {
         }
         const snap = this.resolveSession(sessionId, snapshots);
         const title = snap?.session.title ?? sessionId;
-        await this.taskManager.completeTask(title, summary);
-        return this.logAction({ action: "complete_task", session: sessionId, summary }, true, `task completed for ${title}: ${summary}`);
+        const unblockedTitles = await this.taskManager.completeTask(title, summary);
+        const detail = unblockedTitles.length > 0
+            ? `task completed for ${title}: ${summary} (unblocked: ${unblockedTitles.join(", ")})`
+            : `task completed for ${title}: ${summary}`;
+        return this.logAction({ action: "complete_task", session: sessionId, summary }, true, detail);
     }
     // resolve a session reference (exact ID, prefix, or title) to the matching snapshot
     // single source of truth for session resolution — both tmux name and ID derive from this

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

@@ -18,7 +18,7 @@ import { TaskManager, loadTaskDefinitions, loadTaskState, saveTaskState, formatT
 import { goalToList } from "./types.js";
 import { runTaskCli, handleTaskSlashCommand, quickTaskUpdate } from "./task-cli.js";
 import { parsePaneMilestones } from "./task-parser.js";
-import { TUI, hitTestSession, nextSortMode, SORT_MODES, formatUptime, formatClipText, loadTuiPrefs, saveTuiPrefs, validateGroupName, CONTEXT_BURN_THRESHOLD, buildSnapshotData, formatSnapshotJson, formatSnapshotMarkdown, formatBroadcastSummary, rankSessions, TOP_SORT_MODES, formatIdleSince, CONTEXT_CEILING_THRESHOLD, buildSessionStats, formatSessionStatsLines, formatStatsJson, validateSessionTag, validateColorName, computeErrorTrend, parseQuietHoursRange, computeCostSummary, formatSessionReport, formatQuietStatus, formatSessionAge, formatHealthTrendChart, isOverBudget, DRAIN_ICON, formatSessionsTable, buildFanOutTemplate, TRUST_STABLE_TICKS_TO_ESCALATE, formatTrustLadderStatus, computeContextBudgets, formatContextBudgetTable, CTX_BUDGET_DEFAULT_GLOBAL, resolveProfiles, formatProfileSummary, parseContextCeiling, shouldCompactContext, formatCompactionNudge, formatCompactionAlert, buildSessionDependencyGraph, formatDependencyGraph, formatRelayRules, matchRelayRules, detectOOM, shouldRestartOnOOM, formatOOMAlert, searchSessionOutputs, formatSearchResults, formatThrottleConfig, diffSessionOutput, formatSessionDiff, formatAlertPatterns, matchAlertPatterns, formatLifecycleHooks, matchLifecycleHooks, buildHookEnv } from "./tui.js";
+import { TUI, hitTestSession, nextSortMode, SORT_MODES, formatUptime, formatClipText, loadTuiPrefs, saveTuiPrefs, validateGroupName, CONTEXT_BURN_THRESHOLD, buildSnapshotData, formatSnapshotJson, formatSnapshotMarkdown, formatBroadcastSummary, rankSessions, TOP_SORT_MODES, formatIdleSince, CONTEXT_CEILING_THRESHOLD, buildSessionStats, formatSessionStatsLines, formatStatsJson, validateSessionTag, validateColorName, computeErrorTrend, isQuietHour, parseQuietHoursRange, computeCostSummary, formatSessionReport, formatQuietStatus, formatSessionAge, formatHealthTrendChart, isOverBudget, DRAIN_ICON, formatSessionsTable, buildFanOutTemplate, TRUST_STABLE_TICKS_TO_ESCALATE, formatTrustLadderStatus, computeContextBudgets, formatContextBudgetTable, CTX_BUDGET_DEFAULT_GLOBAL, resolveProfiles, formatProfileSummary, parseContextCeiling, shouldCompactContext, formatCompactionNudge, formatCompactionAlert, buildSessionDependencyGraph, formatDependencyGraph, formatRelayRules, matchRelayRules, detectOOM, shouldRestartOnOOM, formatOOMAlert, searchSessionOutputs, formatSearchResults, formatThrottleConfig, diffSessionOutput, formatSessionDiff, formatAlertPatterns, matchAlertPatterns, formatLifecycleHooks, matchLifecycleHooks, buildHookEnv } from "./tui.js";
 import { isDaemonRunningFromState } from "./chat.js";
 import { sendNotification, sendTestNotification, formatNotifyFilters, parseNotifyEvents, shouldNotifySession } from "./notify.js";
 import { startHealthServer } from "./health.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);
@@ -3230,11 +3290,22 @@ async function main() {
                 // - Always reason if there's a user message (immediate response)
                 // - Always reason if forceDashboard is set
                 // - Otherwise gate on reasonIntervalMs elapsed since last reasoning call
+                // - Skip if in quiet hours (unless user message forces it)
                 const msSinceLastReason = Date.now() - lastReasonerAt;
-                const reasonDue = lastReasonerAt === 0
+                const quietSpec = config.policies.quietHours;
+                const inQuietHours = quietSpec ? isQuietHour(new Date().getHours(), [parseQuietHoursRange(quietSpec)].filter(Boolean)) : false;
+                const reasonDue = (lastReasonerAt === 0
                     || msSinceLastReason >= config.reasonIntervalMs
                     || !!userMessage
-                    || forceDashboard;
+                    || forceDashboard)
+                    && (!inQuietHours || !!userMessage); // user messages always get through even in quiet hours
+                if (inQuietHours && !userMessage && pollCount % 30 === 1) {
+                    const msg = `quiet hours active (${quietSpec}) — polling only, no reasoning`;
+                    if (tui)
+                        tui.log("status", msg);
+                    else
+                        log(msg);
+                }
                 if (!reasonDue) {
                     // Observation-only tick: poll sessions, update TUI state, skip LLM
                     const observation = await poller.poll();
@@ -3767,6 +3838,18 @@ async function daemonTick(config, poller, reasoner, executor, reasonerConsole, p
                 });
             }
         }
+        // notify: task lifecycle events
+        if (entry.success && entry.action.action === "complete_task" && sessionTitle) {
+            const nFilters = tui ? tui.getAllSessionNotifyFilters() : new Map();
+            if (shouldNotifySession("task_completed", sessionTitle, nFilters, config.notifications?.events)) {
+                sendNotification(config, {
+                    event: "task_completed",
+                    timestamp: Date.now(),
+                    session: sessionTitle,
+                    detail: `completed: ${actionText ?? "task finished"}`,
+                });
+            }
+        }
     }
     // auto-pause tracking: record stuck nudges for send_input actions targeting stuck sessions.
     // a "stuck nudge" = send_input to a session that hasn't had progress in >30 min.
@@ -3794,6 +3877,15 @@ async function daemonTick(config, poller, reasoner, executor, reasonerConsole, p
                     else
                         log(msg);
                     appendSupervisorEvent({ at: Date.now(), detail: `auto-pause: ${title}` });
+                    const nFilters = tui ? tui.getAllSessionNotifyFilters() : new Map();
+                    if (shouldNotifySession("task_stuck", title, nFilters, config.notifications?.events)) {
+                        sendNotification(config, {
+                            event: "task_stuck",
+                            timestamp: Date.now(),
+                            session: title,
+                            detail: `auto-paused after ${task.stuckNudgeCount} stuck nudges with no progress`,
+                        });
+                    }
                 }
             }
         }
@@ -4437,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/notify.js

@@ -200,6 +200,9 @@ function eventTitle(event) {
         case "action_failed": return "Action Failed";
         case "daemon_started": return "Daemon Started";
         case "daemon_stopped": return "Daemon Stopped";
+        case "task_completed": return "Task Completed";
+        case "task_stuck": return "Task Stuck";
+        case "task_unblocked": return "Task Unblocked";
     }
 }
 /**
@@ -245,6 +248,7 @@ export function formatNotifyFilters(sessionFilters) {
  */
 export const VALID_NOTIFY_EVENTS = [
     "session_error", "session_done", "action_executed", "action_failed", "daemon_started", "daemon_stopped",
+    "task_completed", "task_stuck", "task_unblocked",
 ];
 export function parseNotifyEvents(eventNames) {
     const valid = new Set(VALID_NOTIFY_EVENTS);
@@ -264,6 +268,9 @@ function eventIcon(event) {
         case "action_failed": return "\u274C"; // ❌
         case "daemon_started": return "\u{1F680}"; // 🚀
         case "daemon_stopped": return "\u{1F6D1}"; // 🛑
+        case "task_completed": return "\u{1F3C6}"; // 🏆
+        case "task_stuck": return "\u26A0\uFE0F"; // ⚠️
+        case "task_unblocked": return "\u{1F513}"; // 🔓
     }
 }
 //# sourceMappingURL=notify.js.map

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

@@ -32,7 +32,7 @@ export declare class TaskManager {
     }>;
     reportProgress(sessionTitle: string, summary: string): void;
     recordStuckNudge(sessionTitle: string, maxNudges: number): boolean;
-    completeTask(sessionTitle: string, summary: string, cleanupSession?: boolean): Promise<void>;
+    completeTask(sessionTitle: string, summary: string, cleanupSession?: boolean): Promise<string[]>;
     private save;
 }
 export declare function deriveTitle(repo: string): string;
@@ -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

@@ -487,7 +487,7 @@ export class TaskManager {
     async completeTask(sessionTitle, summary, cleanupSession = true) {
         const task = this.getTaskForSession(sessionTitle);
         if (!task)
-            return;
+            return [];
         // find original definition to check continueOnRoadmap
         const def = this.definitions.find((d) => (d.sessionTitle || deriveTitle(d.repo)).toLowerCase() === sessionTitle.toLowerCase());
         if (def?.continueOnRoadmap) {
@@ -499,7 +499,7 @@ export class TaskManager {
             task.lastProgressAt = Date.now();
             log(`continueOnRoadmap: recycled task '${sessionTitle}' with fresh roadmap goal`);
             this.save();
-            return;
+            return [];
         }
         task.status = "completed";
         task.completedAt = Date.now();
@@ -516,6 +516,7 @@ export class TaskManager {
             log(`dependency met: activated '${downstream.sessionTitle}' (was waiting on '${task.sessionTitle}')`);
         }
         this.save();
+        return unblocked.map((t) => t.sessionTitle);
     }
     save() {
         saveTaskState(this.states);
@@ -628,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/dist/types.d.ts

@@ -112,6 +112,7 @@ export interface AoaoeConfig {
         userActivityThresholdMs?: number;
         allowDestructive?: boolean;
         maxStuckNudgesBeforePause?: number;
+        quietHours?: string;
     };
     contextFiles: string[];
     sessionDirs: Record<string, string>;
@@ -132,7 +133,7 @@ export interface AoaoeConfig {
     healthPort?: number;
     tuiHistoryRetentionDays?: number;
 }
-export type NotificationEvent = "session_error" | "session_done" | "action_executed" | "action_failed" | "daemon_started" | "daemon_stopped";
+export type NotificationEvent = "session_error" | "session_done" | "action_executed" | "action_failed" | "daemon_started" | "daemon_stopped" | "task_completed" | "task_stuck" | "task_unblocked";
 export type DaemonPhase = "sleeping" | "polling" | "reasoning" | "executing" | "interrupted";
 export interface DaemonSessionState {
     id: string;

package/package.json

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