@phuetz/code-buddy 0.1.25 → 0.2.0

package/dist/observability/run-store.js

@@ -0,0 +1,419 @@
+/**
+ * RunStore — JSONL-based observability store for agent runs.
+ *
+ * Each run gets its own directory under .codebuddy/runs/run_<id>/ with:
+ *   events.jsonl   — append-only event log (one JSON object per line)
+ *   metrics.json   — tokens, cost, duration, failover count
+ *   artifacts/     — plan.md, patch.diff, commands.log, summary.md …
+ *
+ * Written in append mode for performance — no full-file parsing per event.
+ * Automatic pruning keeps the 30 most recent runs.
+ */
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { randomBytes } from 'crypto';
+import { logger } from '../utils/logger.js';
+const MAX_RUNS = 30;
+// ──────────────────────────────────────────────────────────────────
+// RunStore
+// ──────────────────────────────────────────────────────────────────
+export class RunStore {
+    static _instance = null;
+    runsDir;
+    /** File handles for active run event streams */
+    handles = new Map();
+    /** In-memory event counts per run */
+    eventCounts = new Map();
+    /** In-memory summaries for fast listing */
+    summaries = new Map();
+    constructor(runsDir) {
+        this.runsDir = runsDir || path.join(os.homedir(), '.codebuddy', 'runs');
+        this.ensureDir(this.runsDir);
+        this.loadSummaries();
+    }
+    static getInstance() {
+        if (!RunStore._instance) {
+            RunStore._instance = new RunStore();
+        }
+        return RunStore._instance;
+    }
+    // ──────────────────────────────────────────────────────────────
+    // Run lifecycle
+    // ──────────────────────────────────────────────────────────────
+    /**
+     * Create a new run and return its ID.
+     */
+    startRun(objective, metadata) {
+        const runId = `run_${Date.now().toString(36)}_${randomBytes(3).toString('hex')}`;
+        const runDir = this.runDir(runId);
+        this.ensureDir(runDir);
+        this.ensureDir(path.join(runDir, 'artifacts'));
+        const summary = {
+            runId,
+            objective,
+            status: 'running',
+            startedAt: Date.now(),
+            eventCount: 0,
+            artifactCount: 0,
+            metadata,
+        };
+        this.summaries.set(runId, summary);
+        this.eventCounts.set(runId, 0);
+        // Create events file synchronously, then open append stream
+        const eventsPath = path.join(runDir, 'events.jsonl');
+        fs.writeFileSync(eventsPath, '', { flag: 'a' }); // ensure file exists
+        const ws = fs.createWriteStream(eventsPath, { flags: 'a', encoding: 'utf-8' });
+        this.handles.set(runId, ws);
+        // Emit run_start event
+        this.emit(runId, { type: 'run_start', data: { objective, metadata } });
+        // Save initial metrics
+        this.saveMetrics(runId, {
+            totalTokens: 0,
+            promptTokens: 0,
+            completionTokens: 0,
+            totalCost: 0,
+            durationMs: 0,
+            toolCallCount: 0,
+            failoverCount: 0,
+        });
+        this.saveSummary(runId, summary);
+        this.pruneOldRuns();
+        logger.debug(`RunStore: started run ${runId}`, { objective });
+        return runId;
+    }
+    /**
+     * Fork an existing run — creates a new child run that inherits the parent's
+     * objective and metadata, with `parentRolloutId` set for lineage tracking.
+     *
+     * Codex-inspired session fork / rollout unification: both the checkpoint
+     * rollback path and A/B variant rollouts produce forked runs that can be
+     * compared via `buddy run show <id>`.
+     *
+     * @param parentRunId - The run being forked
+     * @param reason      - Human-readable fork reason ('retry', 'ab-variant-B', etc.)
+     * @param overrides   - Optional metadata overrides for the forked run
+     */
+    forkRun(parentRunId, reason, overrides) {
+        const parent = this.summaries.get(parentRunId);
+        const objective = parent
+            ? `[fork:${reason}] ${parent.objective}`
+            : `[fork:${reason}]`;
+        const parentMeta = parent?.metadata ?? {};
+        const forkMeta = {
+            ...parentMeta,
+            ...overrides,
+            parentRolloutId: parentRunId,
+            forkReason: reason,
+        };
+        const newRunId = this.startRun(objective, forkMeta);
+        this.emit(newRunId, {
+            type: 'decision',
+            data: { kind: 'fork', parentRunId, reason },
+        });
+        logger.debug(`RunStore: forked run ${parentRunId} → ${newRunId}`, { reason });
+        return newRunId;
+    }
+    /**
+     * Emit an event for a run. Thread-safe: writes are serialized by the writable stream.
+     */
+    emit(runId, event) {
+        const ws = this.handles.get(runId);
+        if (!ws)
+            return;
+        const fullEvent = {
+            ts: Date.now(),
+            runId,
+            ...event,
+        };
+        try {
+            ws.write(JSON.stringify(fullEvent) + '\n');
+        }
+        catch (err) {
+            logger.debug('RunStore: failed to write event', { runId, err });
+        }
+        // Update in-memory count
+        const count = (this.eventCounts.get(runId) || 0) + 1;
+        this.eventCounts.set(runId, count);
+        const summary = this.summaries.get(runId);
+        if (summary) {
+            summary.eventCount = count;
+        }
+    }
+    /**
+     * End a run and flush the event stream.
+     */
+    endRun(runId, status) {
+        this.emit(runId, { type: 'run_end', data: { status } });
+        const summary = this.summaries.get(runId);
+        if (summary) {
+            summary.status = status;
+            summary.endedAt = Date.now();
+            this.saveSummary(runId, summary);
+        }
+        // Update metrics duration
+        try {
+            const metricsPath = path.join(this.runDir(runId), 'metrics.json');
+            if (fs.existsSync(metricsPath)) {
+                const metrics = JSON.parse(fs.readFileSync(metricsPath, 'utf-8'));
+                metrics.durationMs = (summary?.endedAt || Date.now()) - (summary?.startedAt || Date.now());
+                fs.writeFileSync(metricsPath, JSON.stringify(metrics, null, 2));
+            }
+        }
+        catch {
+            // Ignore
+        }
+        // Close write stream
+        const ws = this.handles.get(runId);
+        if (ws) {
+            ws.end();
+            this.handles.delete(runId);
+        }
+        logger.debug(`RunStore: ended run ${runId} with status ${status}`);
+    }
+    // ──────────────────────────────────────────────────────────────
+    // Artifacts
+    // ──────────────────────────────────────────────────────────────
+    /**
+     * Save an artifact file for a run. Returns the absolute path.
+     */
+    saveArtifact(runId, name, content) {
+        const artifactsDir = path.join(this.runDir(runId), 'artifacts');
+        this.ensureDir(artifactsDir);
+        const filePath = path.join(artifactsDir, name);
+        fs.writeFileSync(filePath, content, 'utf-8');
+        const summary = this.summaries.get(runId);
+        if (summary) {
+            summary.artifactCount = (summary.artifactCount || 0) + 1;
+            this.saveSummary(runId, summary);
+        }
+        this.emit(runId, {
+            type: 'patch_created',
+            data: { artifact: name, path: filePath },
+        });
+        return filePath;
+    }
+    /**
+     * Update metrics for a run (merges with existing).
+     */
+    updateMetrics(runId, metrics) {
+        try {
+            const metricsPath = path.join(this.runDir(runId), 'metrics.json');
+            let existing = {};
+            if (fs.existsSync(metricsPath)) {
+                existing = JSON.parse(fs.readFileSync(metricsPath, 'utf-8'));
+            }
+            const merged = { ...existing, ...metrics };
+            fs.writeFileSync(metricsPath, JSON.stringify(merged, null, 2));
+        }
+        catch {
+            // Ignore
+        }
+    }
+    // ──────────────────────────────────────────────────────────────
+    // Reading
+    // ──────────────────────────────────────────────────────────────
+    /**
+     * Get the full record for a run (summary + metrics + artifact list).
+     */
+    getRun(runId) {
+        const summary = this.summaries.get(runId);
+        if (!summary)
+            return null;
+        const runDir = this.runDir(runId);
+        let metrics = {};
+        try {
+            const metricsPath = path.join(runDir, 'metrics.json');
+            if (fs.existsSync(metricsPath)) {
+                metrics = JSON.parse(fs.readFileSync(metricsPath, 'utf-8'));
+            }
+        }
+        catch {
+            // Ignore
+        }
+        const artifacts = [];
+        try {
+            const artifactsDir = path.join(runDir, 'artifacts');
+            if (fs.existsSync(artifactsDir)) {
+                artifacts.push(...fs.readdirSync(artifactsDir));
+            }
+        }
+        catch {
+            // Ignore
+        }
+        return { summary, metrics, artifacts };
+    }
+    /**
+     * List runs, most recent first.
+     */
+    listRuns(limit = 20) {
+        return Array.from(this.summaries.values())
+            .sort((a, b) => b.startedAt - a.startedAt)
+            .slice(0, limit);
+    }
+    /**
+     * Read all events from a run's JSONL file.
+     */
+    getEvents(runId) {
+        const eventsPath = path.join(this.runDir(runId), 'events.jsonl');
+        if (!fs.existsSync(eventsPath))
+            return [];
+        const events = [];
+        try {
+            const lines = fs.readFileSync(eventsPath, 'utf-8').split('\n');
+            for (const line of lines) {
+                if (!line.trim())
+                    continue;
+                try {
+                    events.push(JSON.parse(line));
+                }
+                catch {
+                    // Skip malformed lines
+                }
+            }
+        }
+        catch {
+            // Ignore
+        }
+        return events;
+    }
+    /**
+     * Async generator that yields new events as they are appended to events.jsonl.
+     * Stops when the run ends (status no longer 'running') or after timeout.
+     */
+    async *streamEvents(runId, timeoutMs = 300_000) {
+        const eventsPath = path.join(this.runDir(runId), 'events.jsonl');
+        if (!fs.existsSync(eventsPath))
+            return;
+        let offset = 0;
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+            const summary = this.summaries.get(runId);
+            const isActive = summary?.status === 'running' || this.handles.has(runId);
+            // Read new bytes since last offset
+            try {
+                const buf = Buffer.alloc(1024 * 64);
+                const fd = fs.openSync(eventsPath, 'r');
+                const bytesRead = fs.readSync(fd, buf, 0, buf.length, offset);
+                fs.closeSync(fd);
+                if (bytesRead > 0) {
+                    const chunk = buf.slice(0, bytesRead).toString('utf-8');
+                    offset += bytesRead;
+                    const lines = chunk.split('\n');
+                    for (const line of lines) {
+                        if (!line.trim())
+                            continue;
+                        try {
+                            yield JSON.parse(line);
+                        }
+                        catch {
+                            // Skip malformed
+                        }
+                    }
+                }
+            }
+            catch {
+                // Ignore read errors
+            }
+            if (!isActive)
+                break;
+            // Small delay before next poll
+            await new Promise((r) => setTimeout(r, 200));
+        }
+    }
+    /**
+     * Read artifact content.
+     */
+    getArtifact(runId, name) {
+        const filePath = path.join(this.runDir(runId), 'artifacts', name);
+        try {
+            return fs.readFileSync(filePath, 'utf-8');
+        }
+        catch {
+            return null;
+        }
+    }
+    // ──────────────────────────────────────────────────────────────
+    // Private helpers
+    // ──────────────────────────────────────────────────────────────
+    runDir(runId) {
+        return path.join(this.runsDir, runId);
+    }
+    ensureDir(dir) {
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+    }
+    saveMetrics(runId, metrics) {
+        try {
+            const metricsPath = path.join(this.runDir(runId), 'metrics.json');
+            fs.writeFileSync(metricsPath, JSON.stringify(metrics, null, 2));
+        }
+        catch {
+            // Ignore
+        }
+    }
+    saveSummary(runId, summary) {
+        try {
+            const summaryPath = path.join(this.runDir(runId), 'summary.json');
+            fs.writeFileSync(summaryPath, JSON.stringify(summary, null, 2));
+        }
+        catch {
+            // Ignore
+        }
+    }
+    loadSummaries() {
+        try {
+            if (!fs.existsSync(this.runsDir))
+                return;
+            const dirs = fs.readdirSync(this.runsDir).filter((d) => d.startsWith('run_'));
+            for (const dir of dirs) {
+                try {
+                    const summaryPath = path.join(this.runsDir, dir, 'summary.json');
+                    if (fs.existsSync(summaryPath)) {
+                        const summary = JSON.parse(fs.readFileSync(summaryPath, 'utf-8'));
+                        this.summaries.set(summary.runId, summary);
+                        // Count events from file size heuristic (avoid full parse on load)
+                        const eventsPath = path.join(this.runsDir, dir, 'events.jsonl');
+                        if (fs.existsSync(eventsPath)) {
+                            this.eventCounts.set(summary.runId, summary.eventCount || 0);
+                        }
+                    }
+                }
+                catch {
+                    // Skip malformed
+                }
+            }
+        }
+        catch {
+            // Ignore
+        }
+    }
+    pruneOldRuns() {
+        const sorted = Array.from(this.summaries.values()).sort((a, b) => b.startedAt - a.startedAt);
+        if (sorted.length <= MAX_RUNS)
+            return;
+        const toRemove = sorted.slice(MAX_RUNS);
+        for (const s of toRemove) {
+            const runDir = this.runDir(s.runId);
+            this.summaries.delete(s.runId);
+            this.eventCounts.delete(s.runId);
+            // Destroy handle immediately (force close, no flush needed for pruned runs)
+            const ws = this.handles.get(s.runId);
+            if (ws) {
+                ws.destroy();
+                this.handles.delete(s.runId);
+            }
+            // Remove directory after a short delay to let the stream fully close
+            setTimeout(() => {
+                try {
+                    fs.rmSync(runDir, { recursive: true, force: true });
+                }
+                catch {
+                    // Ignore
+                }
+            }, 20);
+        }
+    }
+}
+//# sourceMappingURL=run-store.js.map

package/dist/observability/run-store.js.map

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

package/dist/observability/run-viewer.d.ts

@@ -0,0 +1,33 @@
+/**
+ * RunViewer — terminal display helpers for RunStore runs.
+ *
+ * Provides:
+ *   showRun()    — display complete timeline + metrics + artifacts
+ *   tailRun()    — stream events in real-time (follow mode)
+ *   replayRun()  — show timeline then re-execute test steps
+ */
+import { RunEvent, RunMetrics } from './run-store.js';
+/**
+ * Build a full timeline string from a list of events.
+ */
+export declare function prettyTimeline(events: RunEvent[]): string;
+/**
+ * Format metrics for display.
+ */
+export declare function showMetrics(metrics: Partial<RunMetrics>): string;
+/**
+ * Print a complete run record to stdout.
+ */
+export declare function showRun(runId: string): Promise<void>;
+/**
+ * Tail a run's event stream live.
+ */
+export declare function tailRun(runId: string): Promise<void>;
+/**
+ * Replay: show timeline then list test steps that can be re-run.
+ */
+export declare function replayRun(runId: string, rerun?: boolean): Promise<void>;
+/**
+ * List runs summary to stdout.
+ */
+export declare function listRuns(limit?: number): void;