@methodts/runtime 0.1.0

package/dist/event-bus/persistence-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence-sink.d.ts","sourceRoot":"","sources":["../../src/event-bus/persistence-sink.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAIlE,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,kBAAkB,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAUD,qBAAa,eAAgB,YAAW,SAAS,EAAE,WAAW;IAC5D,QAAQ,CAAC,IAAI,iBAAiB;IAE9B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAqB;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,gBAAgB,CAAwC;gBAEpD,OAAO,EAAE,sBAAsB;IAS3C;;;OAGG;IACH,mBAAmB,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIpD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAkBlC,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAM1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC5B;;;;OAIG;YACW,aAAa;IA0B3B;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IASvC;;;OAGG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAO1D,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAS9C,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;YAInD,UAAU;IAYxB,kDAAkD;IAC5C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAO/B"}

package/dist/event-bus/persistence-sink.js

@@ -0,0 +1,193 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * PersistenceSink — PRD 026 Phase 3.
+ *
+ * Writes every RuntimeEvent to a JSONL file via the FileSystemProvider port.
+ * Uses write-ahead batching: events accumulate in memory and flush every
+ * 1 second or 100 events (whichever comes first). On flush failure, emits
+ * system.sink_overflow via a callback — never crashes.
+ *
+ * Also handles event replay on startup: reads the JSONL file, filters by
+ * a configurable replay window, and returns events for import into the bus.
+ *
+ * Cursor recovery: persists last-processed sequence per sink in a JSON file.
+ * On restart, sinks resume from their last cursor.
+ */
+const DEFAULT_LOG_PATH = '.method/events.jsonl';
+const DEFAULT_CURSORS_PATH = '.method/events-cursors.json';
+const DEFAULT_REPLAY_WINDOW_HOURS = 24;
+const DEFAULT_FLUSH_INTERVAL_MS = 1000;
+const DEFAULT_FLUSH_BATCH_SIZE = 100;
+// ── PersistenceSink ─────────────────────────────────────────────
+export class PersistenceSink {
+    name = 'persistence';
+    fs;
+    logPath;
+    cursorsPath;
+    replayWindowHours;
+    flushIntervalMs;
+    flushBatchSize;
+    buffer = [];
+    flushTimer = null;
+    flushing = false;
+    lastSequence = 0;
+    overflowCallback = null;
+    constructor(options) {
+        this.fs = options.fs;
+        this.logPath = options.logPath ?? DEFAULT_LOG_PATH;
+        this.cursorsPath = options.cursorsPath ?? DEFAULT_CURSORS_PATH;
+        this.replayWindowHours = options.replayWindowHours ?? DEFAULT_REPLAY_WINDOW_HOURS;
+        this.flushIntervalMs = options.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS;
+        this.flushBatchSize = options.flushBatchSize ?? DEFAULT_FLUSH_BATCH_SIZE;
+    }
+    /**
+     * Set a callback to notify when flush fails (e.g., emit system.sink_overflow).
+     * Called from composition root after bus is created.
+     */
+    setOverflowCallback(cb) {
+        this.overflowCallback = cb;
+    }
+    /**
+     * Initialize from persisted cursor state. Call before registering as a sink.
+     */
+    async init() {
+        const cursors = await this.loadCursors();
+        this.lastSequence = cursors[this.name] ?? 0;
+    }
+    // ── EventSink interface ──────────────────────────────────────
+    onEvent(event) {
+        // Skip events already persisted (cursor recovery on replay)
+        if (event.sequence <= this.lastSequence)
+            return;
+        this.buffer.push(event);
+        this.lastSequence = event.sequence;
+        // Flush immediately if batch size reached
+        if (this.buffer.length >= this.flushBatchSize) {
+            this.flush().catch(() => { });
+        }
+        else if (!this.flushTimer) {
+            this.flushTimer = setTimeout(() => {
+                this.flushTimer = null;
+                this.flush().catch(() => { });
+            }, this.flushIntervalMs);
+        }
+    }
+    onError(error, event) {
+        console.error(`[persistence-sink] Error processing event ${event.id}:`, error.message);
+    }
+    // ── Flush ────────────────────────────────────────────────────
+    async flush() {
+        if (this.flushing || this.buffer.length === 0)
+            return;
+        this.flushing = true;
+        // Swap buffer so new events accumulate in a fresh array during write
+        const batch = this.buffer;
+        this.buffer = [];
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+        try {
+            const lines = batch.map(e => JSON.stringify(e)).join('\n') + '\n';
+            await this.fs.appendFile(this.logPath, lines, 'utf-8');
+            await this.saveCursor();
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`[persistence-sink] Flush failed: ${msg}`);
+            if (this.overflowCallback) {
+                try {
+                    this.overflowCallback(msg);
+                }
+                catch { /* double fault */ }
+            }
+            // Put events back for retry on next flush
+            this.buffer = [...batch, ...this.buffer];
+        }
+        finally {
+            this.flushing = false;
+        }
+    }
+    // ── Replay ───────────────────────────────────────────────────
+    /**
+     * Read and parse all events from the JSONL log file.
+     * Skips corrupt lines gracefully. Returns empty array if the log is missing.
+     * Shared by replay() (time-window filter) and readEventsSince() (cursor filter).
+     */
+    async readAllEvents() {
+        let content;
+        try {
+            content = await this.fs.readFile(this.logPath, 'utf-8');
+        }
+        catch {
+            console.warn(`[persistence-sink] No event log at ${this.logPath}, starting fresh`);
+            return [];
+        }
+        const events = [];
+        for (const line of content.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                const event = JSON.parse(trimmed);
+                events.push(event);
+            }
+            catch {
+                console.warn('[persistence-sink] Skipping corrupt JSONL line');
+            }
+        }
+        return events;
+    }
+    /**
+     * Read events from JSONL file for replay into the bus.
+     * Filters by replay window. Skips corrupt lines gracefully.
+     */
+    async replay() {
+        const all = await this.readAllEvents();
+        const windowMs = this.replayWindowHours * 60 * 60 * 1000;
+        const cutoff = Date.now() - windowMs;
+        return all.filter(e => new Date(e.timestamp).getTime() >= cutoff);
+    }
+    // ── EventReader interface ────────────────────────────────────
+    /**
+     * Read events from the persistent log where sequence > sinceSeq.
+     * Returns events in append order. Corrupt JSONL lines are skipped gracefully.
+     */
+    async readEventsSince(sinceSeq) {
+        const all = await this.readAllEvents();
+        return all.filter(e => e.sequence > sinceSeq);
+    }
+    // ── Cursor management ────────────────────────────────────────
+    async loadCursors() {
+        try {
+            const content = await this.fs.readFile(this.cursorsPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return {};
+        }
+    }
+    async saveCursors(cursors) {
+        await this.fs.writeFile(this.cursorsPath, JSON.stringify(cursors, null, 2), 'utf-8');
+    }
+    async saveCursor() {
+        try {
+            const cursors = await this.loadCursors();
+            cursors[this.name] = this.lastSequence;
+            await this.saveCursors(cursors);
+        }
+        catch (err) {
+            console.error('[persistence-sink] Failed to save cursor:', err);
+        }
+    }
+    // ── Lifecycle ────────────────────────────────────────────────
+    /** Flush remaining buffer and clean up timers. */
+    async dispose() {
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+        await this.flush();
+    }
+}
+//# sourceMappingURL=persistence-sink.js.map

package/dist/event-bus/persistence-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence-sink.js","sourceRoot":"","sources":["../../src/event-bus/persistence-sink.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;;;;;;;;;;;GAaG;AAiBH,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAChD,MAAM,oBAAoB,GAAG,6BAA6B,CAAC;AAC3D,MAAM,2BAA2B,GAAG,EAAE,CAAC;AACvC,MAAM,yBAAyB,GAAG,IAAI,CAAC;AACvC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAErC,mEAAmE;AAEnE,MAAM,OAAO,eAAe;IACjB,IAAI,GAAG,aAAa,CAAC;IAEb,EAAE,CAAqB;IACvB,OAAO,CAAS;IAChB,WAAW,CAAS;IACpB,iBAAiB,CAAS;IAC1B,eAAe,CAAS;IACxB,cAAc,CAAS;IAEhC,MAAM,GAAmB,EAAE,CAAC;IAC5B,UAAU,GAAyC,IAAI,CAAC;IACxD,QAAQ,GAAG,KAAK,CAAC;IACjB,YAAY,GAAG,CAAC,CAAC;IACjB,gBAAgB,GAAmC,IAAI,CAAC;IAEhE,YAAY,OAA+B;QACzC,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC;QACnD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,oBAAoB,CAAC;QAC/D,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,2BAA2B,CAAC;QAClF,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,yBAAyB,CAAC;QAC5E,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,wBAAwB,CAAC;IAC3E,CAAC;IAED;;;OAGG;IACH,mBAAmB,CAAC,EAAyB;QAC3C,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,gEAAgE;IAEhE,OAAO,CAAC,KAAmB;QACzB,4DAA4D;QAC5D,IAAI,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAEhD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC;QAEnC,0CAA0C;QAC1C,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC9C,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAA0B,CAAC,CAAC,CAAC;QACvD,CAAC;aAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;gBAChC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;gBACvB,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAA0B,CAAC,CAAC,CAAC;YACvD,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,CAAC,KAAY,EAAE,KAAmB;QACvC,OAAO,CAAC,KAAK,CAAC,6CAA6C,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACzF,CAAC;IAED,gEAAgE;IAEhE,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEtD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAErB,qEAAqE;QACrE,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QAEjB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YAClE,MAAM,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,CAAC,KAAK,CAAC,oCAAoC,GAAG,EAAE,CAAC,CAAC;YAEzD,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAC1B,IAAI,CAAC;oBAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;YAClE,CAAC;YAED,0CAA0C;YAC1C,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;IAED,gEAAgE;IAEhE;;;;OAIG;IACK,KAAK,CAAC,aAAa;QACzB,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,sCAAsC,IAAI,CAAC,OAAO,kBAAkB,CAAC,CAAC;YACnF,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,MAAM,GAAmB,EAAE,CAAC;QAElC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAiB,CAAC;gBAClD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM;QACV,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC;QACrC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,MAAM,CAAC,CAAC;IACpE,CAAC;IAED,gEAAgE;IAEhE;;;OAGG;IACH,KAAK,CAAC,eAAe,CAAC,QAAgB;QACpC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QACvC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED,gEAAgE;IAEhE,KAAK,CAAC,WAAW;QACf,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAClE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAA2B,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAA+B;QAC/C,MAAM,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACvF,CAAC;IAEO,KAAK,CAAC,UAAU;QACtB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC;YACvC,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,GAAG,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,gEAAgE;IAEhE,kDAAkD;IAClD,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;QACD,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/event-bus/persistence-sink.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Unit tests for PersistenceSink (PRD 026 Phase 3).
+ * Uses in-memory FileSystemProvider mock — no real I/O.
+ */
+export {};
+//# sourceMappingURL=persistence-sink.test.d.ts.map

package/dist/event-bus/persistence-sink.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence-sink.test.d.ts","sourceRoot":"","sources":["../../src/event-bus/persistence-sink.test.ts"],"names":[],"mappings":"AACA;;;GAGG"}

package/dist/event-bus/persistence-sink.test.js

@@ -0,0 +1,319 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Unit tests for PersistenceSink (PRD 026 Phase 3).
+ * Uses in-memory FileSystemProvider mock — no real I/O.
+ */
+import { describe, it, beforeEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { PersistenceSink } from './persistence-sink.js';
+// ── In-memory FileSystem mock ──────────────────────────────────
+function createMemoryFs() {
+    const files = new Map();
+    const dirs = new Set();
+    const norm = (p) => p.replace(/\\/g, '/');
+    return {
+        files,
+        readFileSync(path, _encoding) {
+            const content = files.get(norm(path));
+            if (content === undefined)
+                throw new Error(`ENOENT: no such file: ${path}`);
+            return content;
+        },
+        writeFileSync(path, content) {
+            files.set(norm(path), content);
+        },
+        existsSync(path) {
+            return files.has(norm(path)) || dirs.has(norm(path));
+        },
+        readdirSync(_path, _options) {
+            return [];
+        },
+        statSync(_path) {
+            return { mtimeMs: 0, mtime: new Date(), size: 0, isFile: () => true, isDirectory: () => false };
+        },
+        unlinkSync(path) {
+            files.delete(norm(path));
+        },
+        mkdirSync(path) {
+            dirs.add(norm(path));
+        },
+        renameSync(oldPath, newPath) {
+            const content = files.get(norm(oldPath));
+            if (content !== undefined) {
+                files.set(norm(newPath), content);
+                files.delete(norm(oldPath));
+            }
+        },
+        realpathSync(path) {
+            return path;
+        },
+        async readFile(path, encoding) {
+            return this.readFileSync(path, encoding);
+        },
+        async writeFile(path, content) {
+            this.writeFileSync(path, content);
+        },
+        async appendFile(path, content) {
+            const existing = files.get(norm(path)) ?? '';
+            files.set(norm(path), existing + content);
+        },
+        async readdir(path) {
+            return this.readdirSync(path);
+        },
+        async stat(path) {
+            return this.statSync(path);
+        },
+        async access() { },
+        async mkdir(path, opts) {
+            this.mkdirSync(path, opts);
+        },
+    };
+}
+// ── Test helpers ───────────────────────────────────────────────
+function makeEvent(seq, overrides = {}) {
+    return {
+        id: `evt-${seq}`,
+        version: 1,
+        timestamp: new Date().toISOString(),
+        sequence: seq,
+        domain: 'session',
+        type: 'session.spawned',
+        severity: 'info',
+        payload: { test: true },
+        source: 'test',
+        ...overrides,
+    };
+}
+// ── Tests ──────────────────────────────────────────────────────
+describe('PersistenceSink', () => {
+    let fs;
+    let sink;
+    const logPath = '.method/events.jsonl';
+    const cursorsPath = '.method/events-cursors.json';
+    beforeEach(async () => {
+        fs = createMemoryFs();
+        sink = new PersistenceSink({
+            fs,
+            logPath,
+            cursorsPath,
+            flushIntervalMs: 50, // fast for testing
+            flushBatchSize: 3,
+        });
+        await sink.init();
+    });
+    describe('onEvent + flush', () => {
+        it('buffers events and flushes at batch size', async () => {
+            sink.onEvent(makeEvent(1));
+            sink.onEvent(makeEvent(2));
+            // Not yet flushed (batch size is 3)
+            assert.equal(fs.files.has(logPath), false);
+            sink.onEvent(makeEvent(3));
+            // Allow async flush to complete
+            await new Promise(r => setTimeout(r, 20));
+            const content = fs.files.get(logPath);
+            assert.ok(content, 'JSONL file should exist after flush');
+            const lines = content.trim().split('\n');
+            assert.equal(lines.length, 3, 'should have 3 JSON lines');
+            const parsed = JSON.parse(lines[0]);
+            assert.equal(parsed.id, 'evt-1');
+        });
+        it('flushes on timer when batch size not reached', async () => {
+            sink.onEvent(makeEvent(1));
+            // Wait for timer flush (50ms configured)
+            await new Promise(r => setTimeout(r, 100));
+            const content = fs.files.get(logPath);
+            assert.ok(content);
+            const lines = content.trim().split('\n');
+            assert.equal(lines.length, 1);
+        });
+        it('appends to existing JSONL file', async () => {
+            fs.files.set(logPath, '{"id":"old","version":1,"sequence":0}\n');
+            sink.onEvent(makeEvent(1));
+            await sink.flush();
+            const content = fs.files.get(logPath);
+            const lines = content.trim().split('\n');
+            assert.equal(lines.length, 2, 'should append, not overwrite');
+            assert.ok(lines[0].includes('"old"'));
+            assert.ok(lines[1].includes('"evt-1"'));
+        });
+    });
+    describe('cursor recovery', () => {
+        it('skips events at or below last cursor', async () => {
+            // Simulate prior cursor state
+            fs.files.set(cursorsPath, JSON.stringify({ persistence: 5 }));
+            const sinkWithCursor = new PersistenceSink({
+                fs,
+                logPath,
+                cursorsPath,
+                flushBatchSize: 1,
+            });
+            await sinkWithCursor.init();
+            // Events 1-5 should be skipped
+            sinkWithCursor.onEvent(makeEvent(3));
+            sinkWithCursor.onEvent(makeEvent(5));
+            await new Promise(r => setTimeout(r, 20));
+            assert.equal(fs.files.has(logPath), false, 'no events should be written');
+            // Event 6 should be persisted
+            sinkWithCursor.onEvent(makeEvent(6));
+            await new Promise(r => setTimeout(r, 20));
+            const content = fs.files.get(logPath);
+            assert.ok(content.includes('"evt-6"'));
+        });
+        it('saves cursor after flush', async () => {
+            sink.onEvent(makeEvent(1));
+            sink.onEvent(makeEvent(2));
+            sink.onEvent(makeEvent(3));
+            await new Promise(r => setTimeout(r, 20));
+            const cursors = JSON.parse(fs.files.get(cursorsPath));
+            assert.equal(cursors.persistence, 3);
+        });
+        it('returns empty cursors when file missing', async () => {
+            const cursors = await sink.loadCursors();
+            assert.deepEqual(cursors, {});
+        });
+    });
+    describe('replay', () => {
+        it('reads events from JSONL file', async () => {
+            const events = [makeEvent(1), makeEvent(2), makeEvent(3)];
+            fs.files.set(logPath, events.map(e => JSON.stringify(e)).join('\n') + '\n');
+            const replayed = await sink.replay();
+            assert.equal(replayed.length, 3);
+            assert.equal(replayed[0].id, 'evt-1');
+            assert.equal(replayed[2].id, 'evt-3');
+        });
+        it('filters by replay window', async () => {
+            const oldEvent = makeEvent(1, {
+                timestamp: new Date(Date.now() - 48 * 60 * 60 * 1000).toISOString(), // 48h ago
+            });
+            const recentEvent = makeEvent(2, {
+                timestamp: new Date().toISOString(),
+            });
+            fs.files.set(logPath, [oldEvent, recentEvent].map(e => JSON.stringify(e)).join('\n') + '\n');
+            const replayed = await sink.replay();
+            assert.equal(replayed.length, 1, 'only recent event within 24h window');
+            assert.equal(replayed[0].id, 'evt-2');
+        });
+        it('skips corrupt JSONL lines gracefully', async () => {
+            const goodEvent = makeEvent(1);
+            fs.files.set(logPath, `${JSON.stringify(goodEvent)}\n{corrupt json\n${JSON.stringify(makeEvent(2))}\n`);
+            const replayed = await sink.replay();
+            assert.equal(replayed.length, 2, 'should skip corrupt line and parse the rest');
+        });
+        it('returns empty array when file missing', async () => {
+            const replayed = await sink.replay();
+            assert.deepEqual(replayed, []);
+        });
+        it('returns empty array for empty file', async () => {
+            fs.files.set(logPath, '');
+            const replayed = await sink.replay();
+            assert.deepEqual(replayed, []);
+        });
+    });
+    describe('readEventsSince', () => {
+        it('returns events with sequence > sinceSeq', async () => {
+            const events = [makeEvent(1), makeEvent(2), makeEvent(3), makeEvent(4), makeEvent(5)];
+            fs.files.set(logPath, events.map(e => JSON.stringify(e)).join('\n') + '\n');
+            const result = await sink.readEventsSince(2);
+            assert.equal(result.length, 3, 'should return events 3, 4, 5');
+            assert.deepEqual(result.map(e => e.sequence), [3, 4, 5]);
+        });
+        it('returns empty array when sinceSeq >= max sequence', async () => {
+            const events = [makeEvent(1), makeEvent(2), makeEvent(3)];
+            fs.files.set(logPath, events.map(e => JSON.stringify(e)).join('\n') + '\n');
+            const result = await sink.readEventsSince(99);
+            assert.deepEqual(result, []);
+        });
+        it('returns empty array when log file missing', async () => {
+            const result = await sink.readEventsSince(0);
+            assert.deepEqual(result, []);
+        });
+        it('skips corrupt JSONL lines gracefully', async () => {
+            const goodEvent1 = makeEvent(1);
+            const goodEvent2 = makeEvent(2);
+            fs.files.set(logPath, `${JSON.stringify(goodEvent1)}\n{this is not valid json\n${JSON.stringify(goodEvent2)}\n`);
+            const result = await sink.readEventsSince(0);
+            assert.equal(result.length, 2, 'should skip corrupt line and return the rest');
+            assert.deepEqual(result.map(e => e.sequence), [1, 2]);
+        });
+        it('returns events in append (monotonic) order', async () => {
+            const events = [makeEvent(1), makeEvent(2), makeEvent(3), makeEvent(4), makeEvent(5)];
+            fs.files.set(logPath, events.map(e => JSON.stringify(e)).join('\n') + '\n');
+            const result = await sink.readEventsSince(0);
+            assert.equal(result.length, 5);
+            for (let i = 1; i < result.length; i++) {
+                assert.ok(result[i].sequence > result[i - 1].sequence, 'sequences should be monotonically increasing');
+            }
+        });
+        it('sinceSeq=0 returns all events', async () => {
+            const events = [makeEvent(1), makeEvent(2), makeEvent(3)];
+            fs.files.set(logPath, events.map(e => JSON.stringify(e)).join('\n') + '\n');
+            const result = await sink.readEventsSince(0);
+            assert.equal(result.length, 3);
+            assert.deepEqual(result.map(e => e.sequence), [1, 2, 3]);
+        });
+        it('returns empty array for empty file', async () => {
+            fs.files.set(logPath, '');
+            const result = await sink.readEventsSince(0);
+            assert.deepEqual(result, []);
+        });
+        it('ignores replay window (returns old events outside 24h)', async () => {
+            // readEventsSince uses cursor filter, NOT time window — so old events should be included.
+            const oldEvent = makeEvent(1, {
+                timestamp: new Date(Date.now() - 48 * 60 * 60 * 1000).toISOString(),
+            });
+            const recentEvent = makeEvent(2, {
+                timestamp: new Date().toISOString(),
+            });
+            fs.files.set(logPath, [oldEvent, recentEvent].map(e => JSON.stringify(e)).join('\n') + '\n');
+            const result = await sink.readEventsSince(0);
+            assert.equal(result.length, 2, 'cursor-based replay should not filter by time');
+        });
+    });
+    describe('flush failure', () => {
+        it('emits overflow callback on write error', async () => {
+            const overflows = [];
+            sink.setOverflowCallback(msg => overflows.push(msg));
+            // Make appendFile throw
+            fs.appendFile = async () => { throw new Error('disk full'); };
+            sink.onEvent(makeEvent(1));
+            sink.onEvent(makeEvent(2));
+            sink.onEvent(makeEvent(3));
+            // Wait for flush attempt
+            await new Promise(r => setTimeout(r, 20));
+            assert.equal(overflows.length, 1);
+            assert.ok(overflows[0].includes('disk full'));
+        });
+        it('retains events in buffer after flush failure', async () => {
+            // Make appendFile throw once, then succeed
+            let callCount = 0;
+            const originalAppend = fs.appendFile.bind(fs);
+            fs.appendFile = async (path, content, encoding) => {
+                callCount++;
+                if (callCount === 1)
+                    throw new Error('transient');
+                return originalAppend(path, content, encoding);
+            };
+            sink.onEvent(makeEvent(1));
+            sink.onEvent(makeEvent(2));
+            sink.onEvent(makeEvent(3));
+            await new Promise(r => setTimeout(r, 20));
+            // Events should still be in buffer after first failure
+            // Trigger another flush
+            await sink.flush();
+            const content = fs.files.get(logPath);
+            assert.ok(content, 'events should be written on retry');
+            assert.equal(content.trim().split('\n').length, 3);
+        });
+    });
+    describe('dispose', () => {
+        it('flushes remaining buffer on dispose', async () => {
+            sink.onEvent(makeEvent(1));
+            // Don't wait for timer — dispose should flush immediately
+            await sink.dispose();
+            const content = fs.files.get(logPath);
+            assert.ok(content);
+            assert.equal(content.trim().split('\n').length, 1);
+        });
+    });
+});
+//# sourceMappingURL=persistence-sink.test.js.map

package/dist/event-bus/persistence-sink.test.js.map

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

package/dist/event-bus/session-checkpoint-sink.d.ts

@@ -0,0 +1,91 @@
+/**
+ * SessionCheckpointSink — PRD 029 Phase C-2.
+ *
+ * Persists session snapshots to the session persistence store whenever
+ * session-domain lifecycle events fire. Uses debounced writes: multiple
+ * events for the same session within a 200ms window collapse into a
+ * single save() call.
+ *
+ * Depends on two narrow callbacks (not the pool directly) to respect
+ * G-BOUNDARY. The composition root wires:
+ *   - poolList(): current session status snapshots
+ *   - save(): writes a PersistedSession record
+ */
+import type { RuntimeEvent, EventSink } from '../ports/event-bus.js';
+/**
+ * Minimal persisted session shape accepted by the save callback.
+ *
+ * Q2 audit (S2 §14, PRD-057 §10 Q2): The only bridge-specific field was the
+ * `mode: 'pty' | 'print'` union — that narrowing is transport-specific (bridge
+ * runs PTY and print sessions; agent-runtime uses different modes). Here we
+ * keep `mode: string` in the runtime-level port and let the bridge-side save
+ * callback narrow it when persisting its own `PersistedSession` record.
+ *
+ * Every other field (`session_id`, `workdir`, `nickname`, `purpose`, `status`,
+ * `created_at`, `last_activity_at`, `prompt_count`, `depth`,
+ * `parent_session_id`, `isolation`, `metadata`) is session-generic and stays
+ * strongly typed.
+ */
+export interface PersistedSessionInput {
+    session_id: string;
+    workdir: string;
+    nickname: string;
+    purpose: string | null;
+    /** Session mode — opaque string at the runtime level. Bridge narrows to 'pty' | 'print'; agent-runtime may use its own modes. */
+    mode: string;
+    status: string;
+    created_at: string;
+    last_activity_at: string;
+    prompt_count: number;
+    depth: number;
+    parent_session_id: string | null;
+    isolation: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Minimal session status info returned by the poolList callback.
+ * Matches the relevant fields of SessionStatusInfo from the sessions domain.
+ */
+export interface SessionStatusInfo {
+    sessionId: string;
+    nickname: string;
+    purpose: string | null;
+    status: string;
+    promptCount: number;
+    lastActivityAt: Date;
+    workdir: string;
+    mode: string;
+    chain: {
+        parent_session_id: string | null;
+        depth: number;
+    };
+    worktree: {
+        isolation: string;
+    };
+    metadata?: Record<string, unknown>;
+}
+export interface SessionCheckpointSinkOptions {
+    /** Persist a session snapshot. */
+    save: (session: PersistedSessionInput) => Promise<void>;
+    /** Get current session statuses from the pool. */
+    poolList: () => SessionStatusInfo[];
+    /** Debounce window in milliseconds (default: 200). */
+    debounceMs?: number;
+}
+export declare class SessionCheckpointSink implements EventSink {
+    readonly name = "session-checkpoint";
+    private readonly save;
+    private readonly poolList;
+    private readonly debounceMs;
+    /** Pending debounce timers keyed by sessionId. */
+    private readonly pendingTimers;
+    constructor(options: SessionCheckpointSinkOptions);
+    onEvent(event: RuntimeEvent): void;
+    onError(error: Error, event: RuntimeEvent): void;
+    private checkpoint;
+    /** Clean up pending timers. Call on shutdown. */
+    dispose(): void;
+    /** Number of pending debounce timers (for testing/monitoring). */
+    get pendingCount(): number;
+}
+//# sourceMappingURL=session-checkpoint-sink.d.ts.map