@blockspool/cli 0.4.1 → 0.4.2

package/dist/lib/logger.js

@@ -0,0 +1,42 @@
+/**
+ * Logger implementation for CLI
+ */
+import chalk from 'chalk';
+/**
+ * Create a logger instance
+ */
+export function createLogger(opts = {}) {
+    const { verbose = false, quiet = false } = opts;
+    return {
+        debug(msg, data) {
+            if (verbose && !quiet) {
+                const dataStr = data ? ` ${JSON.stringify(data)}` : '';
+                console.log(chalk.gray(`[debug] ${msg}${dataStr}`));
+            }
+        },
+        info(msg, data) {
+            if (!quiet) {
+                const dataStr = data && verbose ? ` ${JSON.stringify(data)}` : '';
+                console.log(chalk.blue(`[info] ${msg}${dataStr}`));
+            }
+        },
+        warn(msg, data) {
+            const dataStr = data ? ` ${JSON.stringify(data)}` : '';
+            console.log(chalk.yellow(`[warn] ${msg}${dataStr}`));
+        },
+        error(msg, data) {
+            const dataStr = data ? ` ${JSON.stringify(data)}` : '';
+            console.error(chalk.red(`[error] ${msg}${dataStr}`));
+        },
+    };
+}
+/**
+ * Silent logger (for tests or quiet mode)
+ */
+export const silentLogger = {
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+//# sourceMappingURL=logger.js.map

package/dist/lib/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAQ1B;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAsB,EAAE;IACnD,MAAM,EAAE,OAAO,GAAG,KAAK,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;IAEhD,OAAO;QACL,KAAK,CAAC,GAAW,EAAE,IAA8B;YAC/C,IAAI,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;gBACtB,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QAED,IAAI,CAAC,GAAW,EAAE,IAA8B;YAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,OAAO,GAAG,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QAED,IAAI,CAAC,GAAW,EAAE,IAA8B;YAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,GAAG,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC;QACvD,CAAC;QAED,KAAK,CAAC,GAAW,EAAE,IAA8B;YAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,GAAG,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC;QACvD,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAW;IAClC,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;CAChB,CAAC"}

package/dist/lib/retention.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Retention & Cleanup
+ *
+ * Prune logic for all unbounded state accumulation points.
+ * Called automatically on session start and via `blockspool prune`.
+ */
+import { type RetentionConfig, type SoloConfig } from './solo-config.js';
+import type { DatabaseAdapter } from '@blockspool/core/db';
+export interface PruneReport {
+    runFoldersRemoved: number;
+    historyLinesRemoved: number;
+    artifactsRemoved: number;
+    spoolArchivesRemoved: number;
+    deferredProposalsRemoved: number;
+    completedTicketsRemoved: number;
+    mergedBranchesRemoved: number;
+    totalPruned: number;
+}
+export declare function getRetentionConfig(config: SoloConfig | null): RetentionConfig;
+/**
+ * Sort .blockspool/runs/ by mtime, delete oldest beyond cap.
+ */
+export declare function pruneRunFolders(repoRoot: string, maxRuns: number, dryRun?: boolean): number;
+/**
+ * Keep last N lines in history.ndjson, rewrite file.
+ */
+export declare function pruneHistory(repoRoot: string, maxEntries: number, dryRun?: boolean): number;
+/**
+ * Within each run folder, keep newest N artifact files.
+ */
+export declare function pruneArtifacts(repoRoot: string, maxPerRun: number, dryRun?: boolean): number;
+/**
+ * Delete oldest *.archived.ndjson in spool/ beyond cap.
+ */
+export declare function pruneSpoolArchives(repoRoot: string, maxArchives: number, dryRun?: boolean): number;
+/**
+ * Trim oldest deferred proposals from run-state.json beyond cap.
+ */
+export declare function pruneDeferredProposals(repoRoot: string, maxDeferred: number, dryRun?: boolean): number;
+/**
+ * Hard-delete oldest completed tickets beyond cap.
+ * Uses the DatabaseAdapter interface (Postgres $1 placeholders).
+ */
+export declare function pruneCompletedTickets(adapter: DatabaseAdapter | null, maxCompleted: number, dryRun?: boolean): Promise<number>;
+/**
+ * Delete local blockspool/* branches that are fully merged, keeping the
+ * newest N merged branches. Only touches local branches — never deletes
+ * remote branches, and never touches unmerged branches.
+ *
+ * NOT called during auto-prune-on-start — only via `blockspool prune`.
+ */
+export declare function pruneMergedBranches(repoRoot: string, maxMergedBranches: number, dryRun?: boolean): number;
+export declare function pruneAll(repoRoot: string, config: RetentionConfig, dryRun?: boolean): PruneReport;
+/**
+ * Full prune including async DB operations.
+ */
+export declare function pruneAllAsync(repoRoot: string, config: RetentionConfig, adapter?: DatabaseAdapter | null, dryRun?: boolean): Promise<PruneReport>;
+/**
+ * Format a prune report for display.
+ */
+export declare function formatPruneReport(report: PruneReport, dryRun?: boolean): string;
+//# sourceMappingURL=retention.d.ts.map

package/dist/lib/retention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../src/lib/retention.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,UAAU,EAGhB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAM3D,MAAM,WAAW,WAAW;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wBAAwB,EAAE,MAAM,CAAC;IACjC,uBAAuB,EAAE,MAAM,CAAC;IAChC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB;AAmBD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,eAAe,CAK7E;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,UAAQ,GACb,MAAM,CAsBR;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,UAAQ,GACb,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,UAAQ,GACb,MAAM,CA+BR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,MAAM,UAAQ,GACb,MAAM,CAsBR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,MAAM,UAAQ,GACb,MAAM,CAWR;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,eAAe,GAAG,IAAI,EAC/B,YAAY,EAAE,MAAM,EACpB,MAAM,UAAQ,GACb,OAAO,CAAC,MAAM,CAAC,CA6BjB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,EACzB,MAAM,UAAQ,GACb,MAAM,CA0CR;AAMD,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,eAAe,EACvB,MAAM,UAAQ,GACb,WAAW,CAkBb;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,eAAe,GAAG,IAAW,EACtC,MAAM,UAAQ,GACb,OAAO,CAAC,WAAW,CAAC,CAQtB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,UAAQ,GAAG,MAAM,CA+B7E"}

package/dist/lib/retention.js

@@ -0,0 +1,285 @@
+/**
+ * Retention & Cleanup
+ *
+ * Prune logic for all unbounded state accumulation points.
+ * Called automatically on session start and via `blockspool prune`.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { DEFAULT_RETENTION_CONFIG, getBlockspoolDir, } from './solo-config.js';
+import { readRunState, writeRunState } from './run-state.js';
+function emptyReport() {
+    return {
+        runFoldersRemoved: 0,
+        historyLinesRemoved: 0,
+        artifactsRemoved: 0,
+        spoolArchivesRemoved: 0,
+        deferredProposalsRemoved: 0,
+        completedTicketsRemoved: 0,
+        mergedBranchesRemoved: 0,
+        totalPruned: 0,
+    };
+}
+// =============================================================================
+// Config helper
+// =============================================================================
+export function getRetentionConfig(config) {
+    return {
+        ...DEFAULT_RETENTION_CONFIG,
+        ...(config?.retention ?? {}),
+    };
+}
+// =============================================================================
+// Individual prune functions
+// =============================================================================
+/**
+ * Sort .blockspool/runs/ by mtime, delete oldest beyond cap.
+ */
+export function pruneRunFolders(repoRoot, maxRuns, dryRun = false) {
+    const runsDir = path.join(getBlockspoolDir(repoRoot), 'runs');
+    if (!fs.existsSync(runsDir))
+        return 0;
+    const entries = fs.readdirSync(runsDir, { withFileTypes: true })
+        .filter(e => e.isDirectory())
+        .map(e => ({
+        name: e.name,
+        path: path.join(runsDir, e.name),
+        mtime: fs.statSync(path.join(runsDir, e.name)).mtimeMs,
+    }))
+        .sort((a, b) => b.mtime - a.mtime); // newest first
+    if (entries.length <= maxRuns)
+        return 0;
+    const toRemove = entries.slice(maxRuns);
+    if (!dryRun) {
+        for (const entry of toRemove) {
+            fs.rmSync(entry.path, { recursive: true, force: true });
+        }
+    }
+    return toRemove.length;
+}
+/**
+ * Keep last N lines in history.ndjson, rewrite file.
+ */
+export function pruneHistory(repoRoot, maxEntries, dryRun = false) {
+    const historyPath = path.join(getBlockspoolDir(repoRoot), 'history.ndjson');
+    if (!fs.existsSync(historyPath))
+        return 0;
+    const content = fs.readFileSync(historyPath, 'utf-8');
+    const lines = content.split('\n').filter(l => l.trim().length > 0);
+    if (lines.length <= maxEntries)
+        return 0;
+    const removed = lines.length - maxEntries;
+    if (!dryRun) {
+        const kept = lines.slice(-maxEntries);
+        fs.writeFileSync(historyPath, kept.join('\n') + '\n');
+    }
+    return removed;
+}
+/**
+ * Within each run folder, keep newest N artifact files.
+ */
+export function pruneArtifacts(repoRoot, maxPerRun, dryRun = false) {
+    const runsDir = path.join(getBlockspoolDir(repoRoot), 'runs');
+    if (!fs.existsSync(runsDir))
+        return 0;
+    let totalRemoved = 0;
+    const runDirs = fs.readdirSync(runsDir, { withFileTypes: true })
+        .filter(e => e.isDirectory());
+    for (const runDir of runDirs) {
+        const runPath = path.join(runsDir, runDir.name);
+        const files = fs.readdirSync(runPath, { withFileTypes: true })
+            .filter(e => e.isFile())
+            .map(e => ({
+            name: e.name,
+            path: path.join(runPath, e.name),
+            mtime: fs.statSync(path.join(runPath, e.name)).mtimeMs,
+        }))
+            .sort((a, b) => b.mtime - a.mtime);
+        if (files.length <= maxPerRun)
+            continue;
+        const toRemove = files.slice(maxPerRun);
+        if (!dryRun) {
+            for (const file of toRemove) {
+                fs.unlinkSync(file.path);
+            }
+        }
+        totalRemoved += toRemove.length;
+    }
+    return totalRemoved;
+}
+/**
+ * Delete oldest *.archived.ndjson in spool/ beyond cap.
+ */
+export function pruneSpoolArchives(repoRoot, maxArchives, dryRun = false) {
+    const spoolDir = path.join(getBlockspoolDir(repoRoot), 'spool');
+    if (!fs.existsSync(spoolDir))
+        return 0;
+    const archives = fs.readdirSync(spoolDir)
+        .filter(f => f.endsWith('.archived.ndjson'))
+        .map(f => ({
+        name: f,
+        path: path.join(spoolDir, f),
+        mtime: fs.statSync(path.join(spoolDir, f)).mtimeMs,
+    }))
+        .sort((a, b) => b.mtime - a.mtime);
+    if (archives.length <= maxArchives)
+        return 0;
+    const toRemove = archives.slice(maxArchives);
+    if (!dryRun) {
+        for (const archive of toRemove) {
+            fs.unlinkSync(archive.path);
+        }
+    }
+    return toRemove.length;
+}
+/**
+ * Trim oldest deferred proposals from run-state.json beyond cap.
+ */
+export function pruneDeferredProposals(repoRoot, maxDeferred, dryRun = false) {
+    const state = readRunState(repoRoot);
+    if (state.deferredProposals.length <= maxDeferred)
+        return 0;
+    const removed = state.deferredProposals.length - maxDeferred;
+    if (!dryRun) {
+        // Keep the newest (last added)
+        state.deferredProposals = state.deferredProposals.slice(-maxDeferred);
+        writeRunState(repoRoot, state);
+    }
+    return removed;
+}
+/**
+ * Hard-delete oldest completed tickets beyond cap.
+ * Uses the DatabaseAdapter interface (Postgres $1 placeholders).
+ */
+export async function pruneCompletedTickets(adapter, maxCompleted, dryRun = false) {
+    if (!adapter)
+        return 0;
+    try {
+        const countResult = await adapter.query(`SELECT COUNT(*) as cnt FROM tickets WHERE status = 'done'`);
+        const count = countResult.rows[0]?.cnt ?? 0;
+        if (count <= maxCompleted)
+            return 0;
+        const toRemove = count - maxCompleted;
+        if (!dryRun) {
+            // Subquery to find oldest N completed tickets, then delete them.
+            // Works on both SQLite and Postgres.
+            await adapter.query(`DELETE FROM tickets WHERE id IN (
+          SELECT id FROM tickets WHERE status = 'done'
+          ORDER BY updated_at ASC LIMIT $1
+        )`, [toRemove]);
+        }
+        return toRemove;
+    }
+    catch {
+        // Table might not exist or schema differs — non-fatal
+        return 0;
+    }
+}
+/**
+ * Delete local blockspool/* branches that are fully merged, keeping the
+ * newest N merged branches. Only touches local branches — never deletes
+ * remote branches, and never touches unmerged branches.
+ *
+ * NOT called during auto-prune-on-start — only via `blockspool prune`.
+ */
+export function pruneMergedBranches(repoRoot, maxMergedBranches, dryRun = false) {
+    try {
+        // Get the list of blockspool/* branches that are fully merged into HEAD
+        const mergedResult = spawnSync('git', ['branch', '--merged', 'HEAD', '--list', 'blockspool/*', '--sort=-committerdate', '--format=%(refname:short)'], { cwd: repoRoot, encoding: 'utf-8' });
+        if (mergedResult.status !== 0 || !mergedResult.stdout)
+            return 0;
+        // Check current branch so we never delete it
+        const headResult = spawnSync('git', ['branch', '--show-current'], {
+            cwd: repoRoot,
+            encoding: 'utf-8',
+        });
+        const currentBranch = headResult.stdout?.trim() ?? '';
+        const mergedBranches = mergedResult.stdout.trim().split('\n')
+            .filter(b => b && b !== currentBranch);
+        if (mergedBranches.length <= maxMergedBranches)
+            return 0;
+        // Keep the newest N, delete the rest
+        const toDelete = mergedBranches.slice(maxMergedBranches);
+        let removed = 0;
+        if (!dryRun) {
+            for (const branch of toDelete) {
+                const delResult = spawnSync('git', ['branch', '-d', branch], {
+                    cwd: repoRoot,
+                    encoding: 'utf-8',
+                });
+                if (delResult.status === 0)
+                    removed++;
+            }
+        }
+        else {
+            removed = toDelete.length;
+        }
+        return removed;
+    }
+    catch {
+        return 0;
+    }
+}
+// =============================================================================
+// Main prune (sync — file-system only)
+// =============================================================================
+export function pruneAll(repoRoot, config, dryRun = false) {
+    const report = emptyReport();
+    report.runFoldersRemoved = pruneRunFolders(repoRoot, config.maxRuns, dryRun);
+    report.historyLinesRemoved = pruneHistory(repoRoot, config.maxHistoryEntries, dryRun);
+    report.artifactsRemoved = pruneArtifacts(repoRoot, config.maxArtifactsPerRun, dryRun);
+    report.spoolArchivesRemoved = pruneSpoolArchives(repoRoot, config.maxSpoolArchives, dryRun);
+    report.deferredProposalsRemoved = pruneDeferredProposals(repoRoot, config.maxDeferredProposals, dryRun);
+    // Branch pruning is NOT run here — only via explicit `blockspool prune`
+    report.totalPruned =
+        report.runFoldersRemoved +
+            report.historyLinesRemoved +
+            report.artifactsRemoved +
+            report.spoolArchivesRemoved +
+            report.deferredProposalsRemoved;
+    return report;
+}
+/**
+ * Full prune including async DB operations.
+ */
+export async function pruneAllAsync(repoRoot, config, adapter = null, dryRun = false) {
+    const report = pruneAll(repoRoot, config, dryRun);
+    report.completedTicketsRemoved = await pruneCompletedTickets(adapter, config.maxCompletedTickets, dryRun);
+    report.mergedBranchesRemoved = pruneMergedBranches(repoRoot, config.maxMergedBranches, dryRun);
+    report.totalPruned += report.completedTicketsRemoved + report.mergedBranchesRemoved;
+    return report;
+}
+/**
+ * Format a prune report for display.
+ */
+export function formatPruneReport(report, dryRun = false) {
+    const prefix = dryRun ? 'Would remove' : 'Removed';
+    const lines = [];
+    if (report.runFoldersRemoved > 0) {
+        lines.push(`  ${prefix} ${report.runFoldersRemoved} run folder(s)`);
+    }
+    if (report.historyLinesRemoved > 0) {
+        lines.push(`  ${prefix} ${report.historyLinesRemoved} history line(s)`);
+    }
+    if (report.artifactsRemoved > 0) {
+        lines.push(`  ${prefix} ${report.artifactsRemoved} artifact file(s)`);
+    }
+    if (report.spoolArchivesRemoved > 0) {
+        lines.push(`  ${prefix} ${report.spoolArchivesRemoved} spool archive(s)`);
+    }
+    if (report.deferredProposalsRemoved > 0) {
+        lines.push(`  ${prefix} ${report.deferredProposalsRemoved} deferred proposal(s)`);
+    }
+    if (report.completedTicketsRemoved > 0) {
+        lines.push(`  ${prefix} ${report.completedTicketsRemoved} completed ticket(s)`);
+    }
+    if (report.mergedBranchesRemoved > 0) {
+        lines.push(`  ${prefix} ${report.mergedBranchesRemoved} merged branch(es)`);
+    }
+    if (lines.length === 0) {
+        return '  Nothing to prune.';
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=retention.js.map

package/dist/lib/retention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.js","sourceRoot":"","sources":["../../src/lib/retention.ts"],"names":[],"mappings":"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"}

package/dist/lib/run-history.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Run History - Audit trail for auto runs
+ *
+ * Appends a structured summary after each auto run to
+ * .blockspool/history.ndjson for post-run analysis.
+ */
+export interface RunHistoryEntry {
+    timestamp: string;
+    mode: 'auto' | 'manual' | 'ci';
+    scope: string;
+    formula?: string;
+    ticketsProposed: number;
+    ticketsApproved: number;
+    ticketsCompleted: number;
+    ticketsFailed: number;
+    prsCreated: number;
+    prsMerged: number;
+    durationMs: number;
+    parallel: number;
+    stoppedReason?: string;
+    errors?: string[];
+    /** Individual ticket outcomes */
+    tickets?: TicketOutcome[];
+}
+export interface TicketOutcome {
+    id: string;
+    title: string;
+    category?: string;
+    status: 'completed' | 'failed' | 'spindle_abort' | 'skipped';
+    prUrl?: string;
+    durationMs?: number;
+    error?: string;
+}
+/**
+ * Append a run history entry to the NDJSON file
+ */
+export declare function appendRunHistory(entry: RunHistoryEntry, repoPath?: string): string;
+/**
+ * Read all run history entries
+ */
+export declare function readRunHistory(repoPath?: string, limit?: number): RunHistoryEntry[];
+/**
+ * Format a history entry for display
+ */
+export declare function formatHistoryEntry(entry: RunHistoryEntry): string;
+/**
+ * Check run history and return a billing reminder banner if the user has hit
+ * a multiple of BILLING_REMINDER_INTERVAL completed tickets while using a
+ * paid API key. Returns null if no reminder is due.
+ */
+export declare function getBillingReminder(repoPath?: string): string | null;
+//# sourceMappingURL=run-history.d.ts.map

package/dist/lib/run-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-history.d.ts","sourceRoot":"","sources":["../../src/lib/run-history.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,iCAAiC;IACjC,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,eAAe,GAAG,SAAS,CAAC;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,eAAe,EACtB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAaR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,eAAe,EAAE,CAoBnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAqBjE;AAQD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAyBnE"}

package/dist/lib/run-history.js

@@ -0,0 +1,116 @@
+/**
+ * Run History - Audit trail for auto runs
+ *
+ * Appends a structured summary after each auto run to
+ * .blockspool/history.ndjson for post-run analysis.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// =============================================================================
+// History File Operations
+// =============================================================================
+/**
+ * Append a run history entry to the NDJSON file
+ */
+export function appendRunHistory(entry, repoPath) {
+    const dir = path.join(repoPath || process.cwd(), '.blockspool');
+    const filePath = path.join(dir, 'history.ndjson');
+    // Ensure directory exists
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const line = JSON.stringify(entry) + '\n';
+    fs.appendFileSync(filePath, line, 'utf-8');
+    return filePath;
+}
+/**
+ * Read all run history entries
+ */
+export function readRunHistory(repoPath, limit) {
+    const filePath = path.join(repoPath || process.cwd(), '.blockspool', 'history.ndjson');
+    if (!fs.existsSync(filePath))
+        return [];
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const lines = content.trim().split('\n').filter(l => l.length > 0);
+    // Most recent first
+    const entries = [];
+    for (let i = lines.length - 1; i >= 0; i--) {
+        try {
+            entries.push(JSON.parse(lines[i]));
+        }
+        catch {
+            // Skip malformed lines
+        }
+        if (limit && entries.length >= limit)
+            break;
+    }
+    return entries;
+}
+/**
+ * Format a history entry for display
+ */
+export function formatHistoryEntry(entry) {
+    const date = new Date(entry.timestamp);
+    const duration = formatDuration(entry.durationMs);
+    const formula = entry.formula ? ` (${entry.formula})` : '';
+    const parts = [
+        `${date.toLocaleDateString()} ${date.toLocaleTimeString()} | ${entry.mode}${formula}`,
+        `  Scope: ${entry.scope} | Duration: ${duration} | Parallel: ${entry.parallel}`,
+        `  Tickets: ${entry.ticketsCompleted} completed, ${entry.ticketsFailed} failed (${entry.ticketsProposed} proposed)`,
+        `  PRs: ${entry.prsCreated} created, ${entry.prsMerged} merged`,
+    ];
+    if (entry.stoppedReason) {
+        parts.push(`  Stopped: ${entry.stoppedReason}`);
+    }
+    if (entry.errors?.length) {
+        parts.push(`  Errors: ${entry.errors.length}`);
+    }
+    return parts.join('\n');
+}
+// =============================================================================
+// Billing Reminder
+// =============================================================================
+const BILLING_REMINDER_INTERVAL = 10;
+/**
+ * Check run history and return a billing reminder banner if the user has hit
+ * a multiple of BILLING_REMINDER_INTERVAL completed tickets while using a
+ * paid API key. Returns null if no reminder is due.
+ */
+export function getBillingReminder(repoPath) {
+    const hasAnthropicKey = !!process.env.ANTHROPIC_API_KEY;
+    const hasOpenaiKey = !!process.env.OPENAI_API_KEY;
+    if (!hasAnthropicKey && !hasOpenaiKey)
+        return null;
+    const entries = readRunHistory(repoPath);
+    const totalCompleted = entries.reduce((sum, e) => sum + e.ticketsCompleted, 0);
+    if (totalCompleted === 0)
+        return null;
+    if (totalCompleted % BILLING_REMINDER_INTERVAL !== 0)
+        return null;
+    const provider = hasAnthropicKey ? 'ANTHROPIC_API_KEY' : 'OPENAI_API_KEY';
+    return [
+        '┌──────────────────────────────────────────────────────────────┐',
+        '│  Billing reminder: You are using a paid API key.            │',
+        `│  Auth: ${provider.padEnd(50)}│`,
+        `│  Tickets completed this project: ${String(totalCompleted).padEnd(27)}│`,
+        '│  API usage is billed per-token by your provider.            │',
+        '│  Alternatives to reduce cost:                               │',
+        '│    - BlockSpool plugin (/blockspool:auto) — uses your       │',
+        '│      Claude Pro/Max subscription, no API key needed         │',
+        '│    - --provider codex — uses your Codex subscription        │',
+        '└──────────────────────────────────────────────────────────────┘',
+    ].join('\n');
+}
+function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60)
+        return `${seconds}s`;
+    const minutes = Math.floor(seconds / 60);
+    const remainingSeconds = seconds % 60;
+    if (minutes < 60)
+        return `${minutes}m ${remainingSeconds}s`;
+    const hours = Math.floor(minutes / 60);
+    const remainingMinutes = minutes % 60;
+    return `${hours}h ${remainingMinutes}m`;
+}
+//# sourceMappingURL=run-history.js.map

package/dist/lib/run-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-history.js","sourceRoot":"","sources":["../../src/lib/run-history.ts"],"names":[],"mappings":"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"}

package/dist/lib/run-state.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Persistent run state for cross-session cycle tracking.
+ *
+ * Stored in `.blockspool/run-state.json`. Tracks how many scout cycles
+ * have run so periodic tasks (like docs-audit) can trigger automatically.
+ */
+export interface DeferredProposal {
+    category: string;
+    title: string;
+    description: string;
+    files: string[];
+    allowed_paths: string[];
+    confidence: number;
+    impact_score: number;
+    original_scope: string;
+    deferredAt: number;
+}
+export interface RunState {
+    /** Total scout cycles completed (persists across sessions) */
+    totalCycles: number;
+    /** Cycle number of the last docs-audit run */
+    lastDocsAuditCycle: number;
+    /** Timestamp of last run */
+    lastRunAt: number;
+    /** Proposals deferred because they were outside the session scope */
+    deferredProposals: DeferredProposal[];
+}
+/**
+ * Read the current run state from disk.
+ */
+export declare function readRunState(repoRoot: string): RunState;
+/**
+ * Write the run state to disk.
+ */
+export declare function writeRunState(repoRoot: string, state: RunState): void;
+/**
+ * Increment the cycle counter and return the new state.
+ */
+export declare function recordCycle(repoRoot: string): RunState;
+/**
+ * Check if a docs-audit cycle is due.
+ * Returns true every N cycles since the last docs-audit.
+ */
+export declare function isDocsAuditDue(repoRoot: string, interval?: number): boolean;
+/**
+ * Record that a docs-audit was run.
+ */
+export declare function recordDocsAudit(repoRoot: string): void;
+/**
+ * Defer a proposal for later when the scope matches.
+ */
+export declare function deferProposal(repoRoot: string, proposal: DeferredProposal): void;
+/**
+ * Retrieve and remove deferred proposals that now match the given scope.
+ * Also prunes proposals older than 7 days.
+ */
+export declare function popDeferredForScope(repoRoot: string, scope: string): DeferredProposal[];
+//# sourceMappingURL=run-state.d.ts.map

package/dist/lib/run-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-state.d.ts","sourceRoot":"","sources":["../../src/lib/run-state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;CACvC;AAeD;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAgBvD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAOrE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAMtD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,OAAO,CAG9E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAItD;AAKD;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAMhF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,EAAE,CA8BvF"}