@omnitype-code/journal 2.0.0

package/dist/daemon/server.js

@@ -0,0 +1,323 @@
+/**
+ * Unix Domain Socket server.
+ *
+ * Protocol: newline-delimited JSON over UDS (or named pipe on Windows).
+ * Each message: { type, id, payload }
+ * Each response: { type: "reply", id, ok, payload? }
+ *
+ * Message types the daemon accepts:
+ *   append       — write one event to the journal
+ *   append_batch — write multiple events in one flush
+ *   query_spans  — read materialized spans for a file
+ *   query_file   — read file state
+ *   query_health — get chain head + stats
+ *   subscribe    — register for live event push (streaming mode)
+ */
+import { createServer, createConnection } from 'node:net';
+import { mkdirSync, existsSync, unlinkSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { randomBytes, createHmac, timingSafeEqual } from 'node:crypto';
+import { deriveAdapterSubkey } from '../crypto/chain.js';
+export function getSocketPath(journalRoot) {
+    if (process.platform === 'win32') {
+        return '\\\\.\\pipe\\omnitype-journal';
+    }
+    return join(journalRoot, 'daemon.sock');
+}
+export class DaemonServer {
+    server;
+    journal;
+    subscribers = new Set();
+    installKey;
+    hardened;
+    // Map from socket to auth state — unauthenticated connections can only call `handshake`
+    connState = new Map();
+    constructor(journal, socketPath, installKey, hardened = false) {
+        this.journal = journal;
+        this.installKey = installKey;
+        this.hardened = hardened;
+        // Clean up stale socket
+        if (process.platform !== 'win32' && existsSync(socketPath)) {
+            unlinkSync(socketPath);
+        }
+        mkdirSync(dirname(socketPath), { recursive: true });
+        this.server = createServer((socket) => this.handleConnection(socket));
+        // Broadcast journal events to subscribers
+        journal.subscribe((event) => {
+            if (this.subscribers.size === 0)
+                return;
+            const msg = JSON.stringify({ type: 'event', payload: event }) + '\n';
+            for (const sub of this.subscribers) {
+                sub.write(msg, () => { });
+            }
+        });
+        this.server.listen(socketPath, () => {
+            console.error(`[omnitype-daemon] listening on ${socketPath}`);
+        });
+    }
+    handleConnection(socket) {
+        let buf = '';
+        // Each new connection starts unauthenticated
+        this.connState.set(socket, { adapterId: null, challenge: null, authenticated: false });
+        socket.on('data', (chunk) => {
+            buf += chunk.toString('utf-8');
+            const lines = buf.split('\n');
+            buf = lines.pop() ?? '';
+            for (const line of lines) {
+                if (!line.trim())
+                    continue;
+                this.handleMessage(socket, line);
+            }
+        });
+        socket.on('close', () => {
+            this.subscribers.delete(socket);
+            this.connState.delete(socket);
+        });
+        socket.on('error', () => {
+            this.subscribers.delete(socket);
+            this.connState.delete(socket);
+        });
+    }
+    handleMessage(socket, line) {
+        let msg;
+        try {
+            msg = JSON.parse(line);
+        }
+        catch {
+            this.send(socket, { type: 'reply', id: '', ok: false, error: 'invalid JSON' });
+            return;
+        }
+        try {
+            const result = this.dispatch(msg, socket);
+            if (result instanceof Promise) {
+                result
+                    .then((payload) => this.send(socket, { type: 'reply', id: msg.id, ok: true, payload }))
+                    .catch((err) => this.send(socket, { type: 'reply', id: msg.id, ok: false, error: String(err) }));
+            }
+            else {
+                this.send(socket, { type: 'reply', id: msg.id, ok: true, payload: result });
+            }
+        }
+        catch (err) {
+            this.send(socket, { type: 'reply', id: msg.id, ok: false, error: String(err) });
+        }
+    }
+    dispatch(msg, socket) {
+        const state = this.connState.get(socket);
+        // ── Handshake phase (Day 2: §1.1) ────────────────────────────────────────
+        // Step 1: client sends { type:'handshake_init', adapter_id }
+        // Daemon responds with a random challenge.
+        // Step 2: client sends { type:'handshake_response', adapter_id, response: HMAC(subkey, challenge) }
+        // Daemon verifies; marks connection authenticated.
+        // All other message types are rejected until authenticated.
+        if (msg.type === 'handshake_init') {
+            const { adapter_id } = msg.payload;
+            const challenge = randomBytes(32);
+            state.adapterId = adapter_id;
+            state.challenge = challenge;
+            state.authenticated = false;
+            // Advertise hardened mode so adapters know not to attempt a key-based
+            // response (in hardened mode the key never leaves the daemon).
+            return { challenge: challenge.toString('hex'), hardened: this.hardened };
+        }
+        if (msg.type === 'handshake_response') {
+            const { adapter_id, response } = msg.payload;
+            if (!state.challenge || state.adapterId !== adapter_id) {
+                throw new Error('handshake_response before handshake_init');
+            }
+            if (this.hardened) {
+                // Hardened mode: the daemon is the sole key-holder and brokers all
+                // signing, so adapters cannot (and must not) prove key possession. The
+                // socket is same-user gated by OS filesystem permissions; integrity is
+                // guaranteed at rest by the keychain-held key and pinned server-side by
+                // the cloud anchor. We accept the connection without a subkey challenge.
+                // NOTE: this does not prove the *caller's* process identity — closing the
+                // live same-user-impostor gap requires OS-level adapter code-signing.
+            }
+            else {
+                const subkey = deriveAdapterSubkey(this.installKey, adapter_id);
+                const expected = createHmac('sha256', subkey).update(state.challenge).digest();
+                const provided = Buffer.from(response, 'hex');
+                if (provided.length !== expected.length || !timingSafeEqual(expected, provided)) {
+                    state.authenticated = false;
+                    throw new Error('adapter authentication failed — subkey mismatch');
+                }
+            }
+            state.authenticated = true;
+            // Emit CapabilityClaim + AdapterInstalled
+            const { capabilities, manifest_sig_verified, runtime_mode } = msg.payload;
+            this.journal.registerAdapter(adapter_id, capabilities ?? {}, manifest_sig_verified ?? false, runtime_mode ?? 'hook');
+            return { authenticated: true };
+        }
+        // All write operations require authentication
+        if (!state.authenticated && msg.type !== 'query_health') {
+            throw new Error(`unauthenticated: call handshake_init + handshake_response before ${msg.type}`);
+        }
+        switch (msg.type) {
+            case 'append': {
+                const { actor, body, tier, adapter_id, sync } = msg.payload;
+                // Enforce: adapter_id in message must match the authenticated adapter (Day 2: §1.1)
+                if (state.adapterId && adapter_id !== state.adapterId) {
+                    throw new Error(`adapter_id mismatch: authenticated as ${state.adapterId}, got ${adapter_id}`);
+                }
+                const seq = this.journal.append(actor, body, tier, adapter_id, sync ?? false);
+                return { seq };
+            }
+            case 'append_batch': {
+                const { events, adapter_id } = msg.payload;
+                if (state.adapterId && adapter_id !== state.adapterId) {
+                    throw new Error(`adapter_id mismatch: authenticated as ${state.adapterId}, got ${adapter_id}`);
+                }
+                const seqs = [];
+                for (const e of events) {
+                    seqs.push(this.journal.append(e.actor, e.body, e.tier, adapter_id));
+                }
+                return { seqs };
+            }
+            case 'query_spans': {
+                const { path, min_tier } = msg.payload;
+                return { spans: this.journal.getSpans(path, min_tier) };
+            }
+            case 'query_attribution': {
+                const { path } = msg.payload;
+                return { summary: this.journal.getAttributionSummary(path) };
+            }
+            case 'query_attestations': {
+                const { path } = msg.payload;
+                return { attestations: this.journal.getHighestTierAttestations(path) };
+            }
+            case 'query_conflicts': {
+                const { path } = msg.payload;
+                return { conflicts: this.journal.getConcurrencyConflicts(path) };
+            }
+            case 'query_health': {
+                const head = this.journal.getChainHead();
+                const info = this.journal.getInstallInfo();
+                return { head, install: info };
+            }
+            case 'subscribe': {
+                this.subscribers.add(socket);
+                return { subscribed: true };
+            }
+            default:
+                throw new Error(`unknown message type: ${msg.type}`);
+        }
+    }
+    send(socket, reply) {
+        socket.write(JSON.stringify(reply) + '\n');
+    }
+    close() {
+        return new Promise((resolve) => this.server.close(() => resolve()));
+    }
+}
+// ─── Client (used by VSCode extension and CLI) ────────────────────────────────
+export class JournalClient {
+    socketPath;
+    socket = null;
+    pending = new Map();
+    buf = '';
+    idCounter = 0;
+    constructor(socketPath) {
+        this.socketPath = socketPath;
+    }
+    async connect() {
+        return new Promise((resolve, reject) => {
+            this.socket = createConnection(this.socketPath, () => resolve());
+            this.socket.on('error', reject);
+            this.socket.on('data', (chunk) => {
+                this.buf += chunk.toString('utf-8');
+                const lines = this.buf.split('\n');
+                this.buf = lines.pop() ?? '';
+                for (const line of lines) {
+                    if (!line.trim())
+                        continue;
+                    try {
+                        const reply = JSON.parse(line);
+                        if (reply.type === 'event') {
+                            // Subscribed events — no pending promise to resolve
+                            continue;
+                        }
+                        const handler = this.pending.get(reply.id);
+                        if (!handler)
+                            continue;
+                        this.pending.delete(reply.id);
+                        if (reply.ok) {
+                            handler.resolve(reply.payload);
+                        }
+                        else {
+                            handler.reject(new Error(reply.error ?? 'unknown error'));
+                        }
+                    }
+                    catch { /* ignore malformed reply */ }
+                }
+            });
+            this.socket.on('close', () => {
+                for (const { reject } of this.pending.values()) {
+                    reject(new Error('daemon disconnected'));
+                }
+                this.pending.clear();
+            });
+        });
+    }
+    /**
+     * Authenticate with the daemon using the per-adapter subkey. (Day 2: §1.1)
+     * Must be called after connect() and before any append calls.
+     * installKey is the 32-byte install key; adapterId is this adapter's ID.
+     */
+    async authenticate(installKey, adapterId, opts = {}) {
+        const { createHmac: hmac } = await import('node:crypto');
+        const initResult = await this.send('handshake_init', { adapter_id: adapterId });
+        const challenge = Buffer.from(initResult.challenge, 'hex');
+        // Derive subkey and respond to challenge
+        const subkey = hmac('sha256', installKey).update(`adapter-subkey:${adapterId}`).digest();
+        const response = hmac('sha256', subkey).update(challenge).digest('hex');
+        await this.send('handshake_response', {
+            adapter_id: adapterId,
+            response,
+            capabilities: opts.capabilities ?? {},
+            manifest_sig_verified: opts.manifestSigVerified ?? false,
+            runtime_mode: opts.runtimeMode ?? 'hook',
+        });
+    }
+    async send(type, payload) {
+        const id = String(++this.idCounter);
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, {
+                resolve: (v) => resolve(v),
+                reject,
+            });
+            this.socket.write(JSON.stringify({ type, id, payload }) + '\n');
+        });
+    }
+    async append(actor, body, tier, adapterId, sync = false) {
+        return this.send('append', { actor, body, tier, adapter_id: adapterId, sync });
+    }
+    async appendBatch(events, adapterId) {
+        return this.send('append_batch', { events, adapter_id: adapterId });
+    }
+    async querySpans(path, minTier) {
+        return this.send('query_spans', { path, min_tier: minTier });
+    }
+    async health() {
+        return this.send('query_health', {});
+    }
+    disconnect() {
+        this.socket?.destroy();
+        this.socket = null;
+    }
+    /** Check if the daemon is running without connecting. */
+    static async isRunning(socketPath) {
+        return new Promise((resolve) => {
+            const s = createConnection(socketPath, () => {
+                s.destroy();
+                resolve(true);
+            });
+            s.on('error', () => resolve(false));
+            s.setTimeout(500, () => {
+                s.destroy();
+                resolve(false);
+            });
+        });
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/daemon/server.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from './schema/events.js';
+export * from './crypto/chain.js';
+export { Journal, resolvePaths } from './daemon/journal.js';
+export { DaemonServer, JournalClient, getSocketPath } from './daemon/server.js';
+export { SegmentWriter, SegmentReader } from './log/segment.js';
+export { Materializer } from './materializer/db.js';
+export { CloudAnchor, AnchorQueue, signAnchor, verifyAnchor } from './cloud/anchor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// Public API for @omnitype-code/journal
+export * from './schema/events.js';
+export * from './crypto/chain.js';
+export { Journal, resolvePaths } from './daemon/journal.js';
+export { DaemonServer, JournalClient, getSocketPath } from './daemon/server.js';
+export { SegmentWriter, SegmentReader } from './log/segment.js';
+export { Materializer } from './materializer/db.js';
+export { CloudAnchor, AnchorQueue, signAnchor, verifyAnchor } from './cloud/anchor.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/log/segment.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Append-only log segment.
+ *
+ * Wire format per record:
+ *   u32 length (BE) | JSON bytes | u32 length (BE) | u32 CRC32C
+ *
+ * Trailing length enables backward scan (crash recovery from end).
+ * CRC32C validates the record in forward iteration.
+ *
+ * Segments rotate at MAX_SEGMENT_BYTES or MAX_SEGMENT_AGE_MS.
+ * Rotated segments are immutable; the current segment is always current.log.
+ */
+import type { JournalEvent } from '../schema/events.js';
+export interface SegmentInfo {
+    id: number;
+    path: string;
+    size: number;
+    createdAt: number;
+}
+export declare class SegmentWriter {
+    private fd;
+    private bytesWritten;
+    private createdAt;
+    private segmentsDir;
+    currentId: number;
+    constructor(segmentsDir: string);
+    private currentPath;
+    append(event: JournalEvent): void;
+    appendBatch(events: JournalEvent[]): void;
+    private shouldRotate;
+    private rotate;
+    close(): void;
+    listSegments(): SegmentInfo[];
+}
+export declare class SegmentReader {
+    static readAll(segmentsDir: string): Generator<JournalEvent>;
+    /** Find last valid seq in a segment (for crash recovery). */
+    static recoverLastValid(segPath: string): {
+        lastSeq: number;
+        truncateAt: number;
+    } | null;
+}
+//# sourceMappingURL=segment.d.ts.map

package/dist/log/segment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"segment.d.ts","sourceRoot":"","sources":["../../src/log/segment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AA2CxD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IACrB,SAAS,EAAE,MAAM,CAAC;gBAEb,WAAW,EAAE,MAAM;IAiB/B,OAAO,CAAC,WAAW;IAInB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAQjC,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI;IAUzC,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,MAAM;IAgBd,KAAK,IAAI,IAAI;IAKb,YAAY,IAAI,WAAW,EAAE;CAe9B;AAED,qBAAa,aAAa;IACxB,MAAM,CAAE,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC;IAiB7D,6DAA6D;IAC7D,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAsBzF"}

package/dist/log/segment.js

@@ -0,0 +1,180 @@
+/**
+ * Append-only log segment.
+ *
+ * Wire format per record:
+ *   u32 length (BE) | JSON bytes | u32 length (BE) | u32 CRC32C
+ *
+ * Trailing length enables backward scan (crash recovery from end).
+ * CRC32C validates the record in forward iteration.
+ *
+ * Segments rotate at MAX_SEGMENT_BYTES or MAX_SEGMENT_AGE_MS.
+ * Rotated segments are immutable; the current segment is always current.log.
+ */
+import { openSync, writeSync, writeFileSync, fsyncSync, closeSync, readFileSync, statSync, readdirSync } from 'node:fs';
+import { createHash } from 'node:crypto';
+import { join } from 'node:path';
+const MAX_SEGMENT_BYTES = 64 * 1024 * 1024; // 64 MiB
+const MAX_SEGMENT_AGE_MS = 60 * 60 * 1000; // 1 hour
+function crc32c(buf) {
+    // Simple table-driven CRC32C (Castagnoli).
+    let crc = 0xffffffff;
+    for (let i = 0; i < buf.length; i++) {
+        crc ^= buf[i];
+        for (let j = 0; j < 8; j++) {
+            crc = (crc >>> 1) ^ (crc & 1 ? 0x82f63b78 : 0);
+        }
+    }
+    return (crc ^ 0xffffffff) >>> 0;
+}
+function encodeRecord(event) {
+    const json = Buffer.from(JSON.stringify(event), 'utf-8');
+    const len = json.length;
+    const lenBuf = Buffer.allocUnsafe(4);
+    lenBuf.writeUInt32BE(len, 0);
+    const crcVal = crc32c(json);
+    const crcBuf = Buffer.allocUnsafe(4);
+    crcBuf.writeUInt32BE(crcVal, 0);
+    return Buffer.concat([lenBuf, json, lenBuf, crcBuf]);
+}
+function decodeRecord(buf, offset) {
+    if (offset + 4 > buf.length)
+        return null;
+    const len = buf.readUInt32BE(offset);
+    if (offset + 4 + len + 8 > buf.length)
+        return null;
+    const jsonBuf = buf.subarray(offset + 4, offset + 4 + len);
+    const storedCrc = buf.readUInt32BE(offset + 4 + len + 4);
+    if (crc32c(jsonBuf) !== storedCrc)
+        return null;
+    try {
+        const event = JSON.parse(jsonBuf.toString('utf-8'));
+        return { event, next: offset + 4 + len + 8 };
+    }
+    catch {
+        return null;
+    }
+}
+export class SegmentWriter {
+    fd;
+    bytesWritten = 0;
+    createdAt;
+    segmentsDir;
+    currentId;
+    constructor(segmentsDir) {
+        this.segmentsDir = segmentsDir;
+        const existing = this.listSegments();
+        this.currentId = existing.length > 0
+            ? Math.max(...existing.map((s) => s.id)) + 1
+            : 0;
+        const path = this.currentPath();
+        this.fd = openSync(path, 'a');
+        try {
+            this.bytesWritten = statSync(path).size;
+        }
+        catch {
+            this.bytesWritten = 0;
+        }
+        this.createdAt = Date.now();
+    }
+    currentPath() {
+        return join(this.segmentsDir, `${String(this.currentId).padStart(8, '0')}.log`);
+    }
+    append(event) {
+        const record = encodeRecord(event);
+        writeSync(this.fd, record);
+        fsyncSync(this.fd);
+        this.bytesWritten += record.length;
+        if (this.shouldRotate())
+            this.rotate();
+    }
+    appendBatch(events) {
+        if (events.length === 0)
+            return;
+        const records = events.map(encodeRecord);
+        const combined = Buffer.concat(records);
+        writeSync(this.fd, combined);
+        fsyncSync(this.fd);
+        this.bytesWritten += combined.length;
+        if (this.shouldRotate())
+            this.rotate();
+    }
+    shouldRotate() {
+        return (this.bytesWritten >= MAX_SEGMENT_BYTES ||
+            Date.now() - this.createdAt >= MAX_SEGMENT_AGE_MS);
+    }
+    rotate() {
+        fsyncSync(this.fd);
+        closeSync(this.fd);
+        // Write segment checksum sidecar
+        const segPath = this.currentPath();
+        const segBuf = readFileSync(segPath);
+        const sha256 = createHash('sha256').update(segBuf).digest('hex');
+        writeFileSync(segPath + '.sha256', sha256 + '\n', 'utf-8');
+        this.currentId++;
+        const newPath = this.currentPath();
+        this.fd = openSync(newPath, 'a');
+        this.bytesWritten = 0;
+        this.createdAt = Date.now();
+    }
+    close() {
+        fsyncSync(this.fd);
+        closeSync(this.fd);
+    }
+    listSegments() {
+        try {
+            return readdirSync(this.segmentsDir)
+                .filter((f) => /^\d{8}\.log$/.test(f))
+                .map((f) => {
+                const id = parseInt(f, 10);
+                const path = join(this.segmentsDir, f);
+                const stat = statSync(path);
+                return { id, path, size: stat.size, createdAt: stat.ctimeMs };
+            })
+                .sort((a, b) => a.id - b.id);
+        }
+        catch {
+            return [];
+        }
+    }
+}
+export class SegmentReader {
+    static *readAll(segmentsDir) {
+        const entries = readdirSync(segmentsDir)
+            .filter((f) => /^\d{8}\.log$/.test(f))
+            .sort();
+        for (const file of entries) {
+            const buf = readFileSync(join(segmentsDir, file));
+            let offset = 0;
+            while (offset < buf.length) {
+                const result = decodeRecord(buf, offset);
+                if (!result)
+                    break;
+                yield result.event;
+                offset = result.next;
+            }
+        }
+    }
+    /** Find last valid seq in a segment (for crash recovery). */
+    static recoverLastValid(segPath) {
+        let buf;
+        try {
+            buf = readFileSync(segPath);
+        }
+        catch {
+            return null;
+        }
+        let lastGoodOffset = 0;
+        let lastSeq = -1;
+        let offset = 0;
+        while (offset < buf.length) {
+            const result = decodeRecord(buf, offset);
+            if (!result)
+                break;
+            lastGoodOffset = result.next;
+            lastSeq = result.event.seq;
+            offset = result.next;
+        }
+        return lastSeq >= 0 ? { lastSeq, truncateAt: lastGoodOffset } : null;
+    }
+}
+//# sourceMappingURL=segment.js.map

package/dist/log/segment.js.map

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

package/dist/materializer/db.d.ts

@@ -0,0 +1,47 @@
+/**
+ * SQLite WAL materializer (using node:sqlite — built into Node 22.5+).
+ *
+ * The spans table is the derived view of who wrote which bytes.
+ * Reconstructible by replaying the journal from scratch.
+ */
+import type { FileState, JournalEvent, Origin, Span, Tier } from '../schema/events.js';
+export declare class Materializer {
+    private db;
+    constructor(dbPath: string);
+    get lastAppliedSeq(): number;
+    apply(event: JournalEvent): void;
+    private applyEvent;
+    private applyFileOpened;
+    private applyEditOp;
+    private applyUnattributed;
+    private applySplice;
+    getSpans(path: string, minTier?: Tier): Span[];
+    getFile(path: string): FileState | undefined;
+    getAttributionSummary(path: string): Record<Origin, number>;
+    /**
+     * Day 18 (§3.4): Get highest-tier attribution for a byte range.
+     * Competes_with arbitration: when multiple adapters attest to the same bytes,
+     * the attestation with the lowest tier number (T0 < T1 < T2 < T3) wins.
+     * Ties are broken by highest confidence, then earliest seq.
+     */
+    getHighestTierAttestations(path: string): Array<{
+        byte_start: number;
+        byte_end: number;
+        origin: Origin;
+        tier: Tier;
+        confidence: number;
+        adapter_id: string;
+    }>;
+    /**
+     * Day 15 (§4.1): Get pending concurrency conflicts — files that need retry.
+     * Returns the current hash the retrying tool should use as pre_hash.
+     */
+    getConcurrencyConflicts(path?: string): Array<{
+        path: string;
+        conflicting_seq: number;
+        expected_hash: string;
+        actual_hash: string;
+    }>;
+    close(): void;
+}
+//# sourceMappingURL=db.d.ts.map