@opensip-cli/datastore 0.1.0

package/dist/__tests__/migration-integrity.test.js

@@ -0,0 +1,78 @@
+import { existsSync, readdirSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import { sql } from 'drizzle-orm';
+import { describe, expect, it } from 'vitest';
+import { DataStoreFactory, requireDrizzleDataStore } from '../index.js';
+/**
+ * Migration-integrity guardrail.
+ *
+ * Drizzle's runtime migrator (`drizzle-orm/better-sqlite3/migrator`) applies
+ * ONLY the migrations registered in `meta/_journal.json`; a `.sql` file that is
+ * not in the journal is silently ignored. That gap let three hand-authored
+ * migrations (0009/0010/0011) ship without journal entries — so the columns
+ * they add (`stable_id`, `timestamp_iso`, `payload_version`) never reached any
+ * database, and every datastore read failed with `no such column`. These tests
+ * make that class of drift fail loudly in CI instead of at a user's terminal.
+ */
+const MIGRATIONS_DIR = fileURLToPath(new URL('../../migrations', import.meta.url));
+const META_DIR = fileURLToPath(new URL('../../migrations/meta', import.meta.url));
+async function readJournal() {
+    const raw = await readFile(fileURLToPath(new URL('../../migrations/meta/_journal.json', import.meta.url)), 'utf8');
+    return JSON.parse(raw).entries;
+}
+/** Migration SQL files, e.g. `0010_add_timestamp_iso_and_payload_version`, sorted by number. */
+function sqlMigrationTags() {
+    return readdirSync(MIGRATIONS_DIR)
+        .filter((f) => /^\d{4}_.*\.sql$/.test(f))
+        .map((f) => f.replace(/\.sql$/, ''))
+        .sort();
+}
+describe('migration journal ↔ SQL file parity', () => {
+    it('every NNNN_*.sql migration file is registered in _journal.json (and vice versa)', async () => {
+        const entries = await readJournal();
+        const journalTags = entries.map((e) => e.tag).sort();
+        const fileTags = sqlMigrationTags();
+        // Set equality, reported as a diff so a missing/extra migration is obvious.
+        const unregisteredFiles = fileTags.filter((t) => !journalTags.includes(t));
+        const danglingEntries = journalTags.filter((t) => !fileTags.includes(t));
+        expect(unregisteredFiles, 'SQL files present on disk but missing from _journal.json').toEqual([]);
+        expect(danglingEntries, '_journal.json entries with no matching SQL file').toEqual([]);
+        expect(journalTags).toEqual(fileTags);
+    });
+    it('journal entry indices are contiguous and match the file ordering', async () => {
+        const entries = await readJournal();
+        const byIdx = [...entries].sort((a, b) => a.idx - b.idx);
+        expect(byIdx.map((e) => e.idx)).toEqual(byIdx.map((_, i) => i));
+        expect(byIdx.map((e) => e.tag)).toEqual(sqlMigrationTags());
+    });
+    it('every journal entry has a corresponding meta/NNNN_snapshot.json', async () => {
+        const entries = await readJournal();
+        const missing = entries
+            .map((e) => `${String(e.idx).padStart(4, '0')}_snapshot.json`)
+            .filter((name) => !existsSync(`${META_DIR}/${name}`));
+        expect(missing, 'journal entries without a drizzle snapshot (breaks future db:generate)').toEqual([]);
+    });
+});
+describe('fresh database fully realizes the ORM schema', () => {
+    it('applies the whole chain and materializes every hand-migrated column', () => {
+        // Uses the real migrations folder (factory default). Throws if any migration
+        // fails — e.g. a multi-statement file missing `statement-breakpoint`, or a
+        // duplicate `ADD COLUMN`.
+        const ds = DataStoreFactory.open({ backend: 'memory' });
+        try {
+            const cols = (table) => new Set(requireDrizzleDataStore(ds)
+                .db.all(sql.raw(`PRAGMA table_info(${table})`))
+                .map((r) => r.name));
+            expect(cols('sessions').has('timestamp_iso')).toBe(true); // 0010
+            expect(cols('session_tool_payload').has('payload_version')).toBe(true); // 0010
+            expect(cols('tool_state').has('stable_id')).toBe(true); // 0009
+            expect(cols('tool_baseline_entries').has('stable_id')).toBe(true); // 0009
+            expect(cols('tool_baseline_meta').has('stable_id')).toBe(true); // 0009
+        }
+        finally {
+            ds.close();
+        }
+    });
+});
+//# sourceMappingURL=migration-integrity.test.js.map

package/dist/__tests__/migration-integrity.test.js.map

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

package/dist/__tests__/tool-state-repo.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * ToolStateRepo round-trips (ADR-0042, plan phase 7.5): put/get/list/delete/
+ * clear, upsert semantics, per-tool isolation, and the payload cap erroring
+ * (never evicting).
+ */
+export {};
+//# sourceMappingURL=tool-state-repo.test.d.ts.map

package/dist/__tests__/tool-state-repo.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-state-repo.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/tool-state-repo.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/__tests__/tool-state-repo.test.js

@@ -0,0 +1,54 @@
+/**
+ * ToolStateRepo round-trips (ADR-0042, plan phase 7.5): put/get/list/delete/
+ * clear, upsert semantics, per-tool isolation, and the payload cap erroring
+ * (never evicting).
+ */
+import { ValidationError } from '@opensip-cli/core';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { DataStoreFactory } from '../factory.js';
+import { ToolStateRepo, TOOL_STATE_MAX_PAYLOAD_BYTES } from '../tool-state-repo.js';
+let ds;
+let repo;
+beforeEach(() => {
+    ds = DataStoreFactory.open({ backend: 'memory' });
+    repo = new ToolStateRepo(ds);
+});
+afterEach(() => {
+    ds.close();
+});
+describe('ToolStateRepo', () => {
+    it('round-trips an opaque JSON payload', () => {
+        repo.put('acme-audit', 'cursor', { page: 3, items: ['a', 'b'] });
+        expect(repo.get('acme-audit', 'cursor')).toEqual({ page: 3, items: ['a', 'b'] });
+    });
+    it('get of a never-put key is undefined', () => {
+        expect(repo.get('acme-audit', 'nope')).toBeUndefined();
+    });
+    it('put is an upsert (same key replaces)', () => {
+        repo.put('acme-audit', 'k', { v: 1 });
+        repo.put('acme-audit', 'k', { v: 2 });
+        expect(repo.get('acme-audit', 'k')).toEqual({ v: 2 });
+        expect(repo.list('acme-audit')).toEqual(['k']);
+    });
+    it('list returns this tool’s keys sorted; delete removes one', () => {
+        repo.put('acme-audit', 'b', 1);
+        repo.put('acme-audit', 'a', 2);
+        expect(repo.list('acme-audit')).toEqual(['a', 'b']);
+        repo.delete('acme-audit', 'a');
+        expect(repo.list('acme-audit')).toEqual(['b']);
+    });
+    it('tools are isolated: clear(A) never touches B', () => {
+        repo.put('tool-a', 'k', 1);
+        repo.put('tool-b', 'k', 2);
+        expect(repo.clear('tool-a')).toBe(1);
+        expect(repo.get('tool-a', 'k')).toBeUndefined();
+        expect(repo.get('tool-b', 'k')).toBe(2);
+    });
+    it('an oversized payload throws ValidationError (error, never evict)', () => {
+        const big = 'x'.repeat(TOOL_STATE_MAX_PAYLOAD_BYTES + 1);
+        expect(() => repo.put('acme-audit', 'big', big)).toThrow(ValidationError);
+        // Nothing was stored — the cap rejects, it does not truncate or evict.
+        expect(repo.get('acme-audit', 'big')).toBeUndefined();
+    });
+});
+//# sourceMappingURL=tool-state-repo.test.js.map

package/dist/__tests__/tool-state-repo.test.js.map

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

package/dist/__tests__/version-guard.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=version-guard.test.d.ts.map

package/dist/__tests__/version-guard.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-guard.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/version-guard.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/version-guard.test.js

@@ -0,0 +1,110 @@
+import { mkdtempSync, readFileSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import Database from 'better-sqlite3';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { DataStoreFactory, DataStoreVersionError } from '../index.js';
+import { isDbNewerThanCli, readSupportedDbVersion } from '../schema-version.js';
+/** The bundled migrations folder lives at the package root (mirrors factory's default). */
+const MIGRATIONS_FOLDER = join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'migrations');
+/** Read SQLite's `PRAGMA user_version` directly via a throwaway connection. */
+function readUserVersion(path) {
+    const db = new Database(path);
+    try {
+        return Number(db.pragma('user_version', { simple: true }));
+    }
+    finally {
+        db.close();
+    }
+}
+/** Force a `PRAGMA user_version` onto an existing file via a throwaway connection. */
+function writeUserVersion(path, version) {
+    const db = new Database(path);
+    try {
+        db.pragma(`user_version = ${version}`);
+    }
+    finally {
+        db.close();
+    }
+}
+let tmp;
+beforeEach(() => {
+    tmp = mkdtempSync(join(tmpdir(), 'ds-version-'));
+});
+afterEach(() => {
+    rmSync(tmp, { recursive: true, force: true });
+});
+describe('readSupportedDbVersion', () => {
+    it('equals the bundled migration journal entry count', () => {
+        const journal = JSON.parse(readFileSync(join(MIGRATIONS_FOLDER, 'meta', '_journal.json'), 'utf8'));
+        expect(readSupportedDbVersion(MIGRATIONS_FOLDER)).toBe(journal.entries.length);
+    });
+    it('is at least 1 (the package ships migrations)', () => {
+        expect(readSupportedDbVersion(MIGRATIONS_FOLDER)).toBeGreaterThanOrEqual(1);
+    });
+    it('returns undefined for an unreadable journal (broken install)', () => {
+        expect(readSupportedDbVersion(join(tmp, 'does-not-exist'))).toBeUndefined();
+    });
+});
+describe('isDbNewerThanCli', () => {
+    it('blocks only when the db is strictly ahead of the CLI', () => {
+        expect(isDbNewerThanCli(7, 6)).toBe(true);
+        expect(isDbNewerThanCli(6, 6)).toBe(false); // equal = same schema, safe
+        expect(isDbNewerThanCli(0, 6)).toBe(false); // fresh / legacy, safe
+    });
+});
+describe('DataStoreFactory.open — version stamp', () => {
+    it('stamps a freshly created SQLite db with the supported version', () => {
+        const path = join(tmp, 'fresh.sqlite');
+        const supported = readSupportedDbVersion(MIGRATIONS_FOLDER);
+        const ds = DataStoreFactory.open({ backend: 'sqlite', path });
+        ds.close();
+        expect(readUserVersion(path)).toBe(supported);
+    });
+    it('adopts a pre-guard "legacy" db (user_version 0) and re-stamps it', () => {
+        const path = join(tmp, 'legacy.sqlite');
+        // Create + migrate, then simulate a legacy file by clearing the stamp.
+        DataStoreFactory.open({ backend: 'sqlite', path }).close();
+        writeUserVersion(path, 0);
+        expect(readUserVersion(path)).toBe(0);
+        // Reopening must NOT throw, and must re-stamp to the supported version.
+        const reopened = DataStoreFactory.open({ backend: 'sqlite', path });
+        reopened.close();
+        expect(readUserVersion(path)).toBe(readSupportedDbVersion(MIGRATIONS_FOLDER));
+    });
+    it('reopening an already-current db is a no-op that preserves the stamp', () => {
+        const path = join(tmp, 'reopen.sqlite');
+        DataStoreFactory.open({ backend: 'sqlite', path }).close();
+        const first = readUserVersion(path);
+        DataStoreFactory.open({ backend: 'sqlite', path }).close();
+        expect(readUserVersion(path)).toBe(first);
+    });
+});
+describe('DataStoreFactory.open — downgrade guard', () => {
+    it('throws DataStoreVersionError when the db was written by a newer CLI', () => {
+        const path = join(tmp, 'future.sqlite');
+        DataStoreFactory.open({ backend: 'sqlite', path }).close();
+        // Stamp it far ahead of anything this CLI could support.
+        writeUserVersion(path, 9999);
+        expect(() => DataStoreFactory.open({ backend: 'sqlite', path })).toThrow(DataStoreVersionError);
+    });
+    it('the error message points at the install script and the delete fallback', () => {
+        const path = join(tmp, 'future-msg.sqlite');
+        DataStoreFactory.open({ backend: 'sqlite', path }).close();
+        writeUserVersion(path, 9999);
+        try {
+            DataStoreFactory.open({ backend: 'sqlite', path });
+            expect.unreachable('open should have thrown DataStoreVersionError');
+        }
+        catch (error) {
+            expect(error).toBeInstanceOf(DataStoreVersionError);
+            const err = error;
+            expect(err.dbVersion).toBe(9999);
+            expect(err.supportedVersion).toBe(readSupportedDbVersion(MIGRATIONS_FOLDER));
+            expect(err.message).toContain('curl -fsSL https://opensip.ai/cli/install.sh | bash');
+            expect(err.message).toContain(path);
+        }
+    });
+});
+//# sourceMappingURL=version-guard.test.js.map

package/dist/__tests__/version-guard.test.js.map

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

package/dist/backends/memory.d.ts

@@ -0,0 +1,3 @@
+import type { DrizzleDataStore } from '../data-store.js';
+export declare function openMemoryBackend(): DrizzleDataStore;
+//# sourceMappingURL=memory.d.ts.map

package/dist/backends/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/backends/memory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,wBAAgB,iBAAiB,IAAI,gBAAgB,CAEpD"}

package/dist/backends/memory.js

@@ -0,0 +1,5 @@
+import { buildSqliteDataStore } from './shared.js';
+export function openMemoryBackend() {
+    return buildSqliteDataStore(':memory:');
+}
+//# sourceMappingURL=memory.js.map

package/dist/backends/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/backends/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAInD,MAAM,UAAU,iBAAiB;IAC/B,OAAO,oBAAoB,CAAC,UAAU,CAAC,CAAC;AAC1C,CAAC"}

package/dist/backends/shared.d.ts

@@ -0,0 +1,3 @@
+import type { SqliteBackendHandle } from '../data-store.js';
+export declare function buildSqliteDataStore(dbPath: string): SqliteBackendHandle;
+//# sourceMappingURL=shared.d.ts.map

package/dist/backends/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/backends/shared.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAiB,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE3E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CA0BxE"}

package/dist/backends/shared.js

@@ -0,0 +1,31 @@
+import Database from 'better-sqlite3';
+import { drizzle } from 'drizzle-orm/better-sqlite3';
+export function buildSqliteDataStore(dbPath) {
+    const sqlite = new Database(dbPath);
+    sqlite.pragma('journal_mode = WAL');
+    sqlite.pragma('foreign_keys = ON');
+    const db = drizzle(sqlite);
+    let closed = false;
+    return {
+        db,
+        close() {
+            if (closed)
+                return;
+            sqlite.close();
+            closed = true;
+        },
+        transaction(fn) {
+            return db.transaction(fn);
+        },
+        readUserVersion() {
+            // `{ simple: true }` returns the scalar (0 on a fresh DB) rather than a row array.
+            return Number(sqlite.pragma('user_version', { simple: true }));
+        },
+        writeUserVersion(version) {
+            // PRAGMA does not accept bound parameters; the value is an integer we own,
+            // so interpolating it is safe (and `Number(...)`-guarded by the type).
+            sqlite.pragma(`user_version = ${version}`);
+        },
+    };
+}
+//# sourceMappingURL=shared.js.map

package/dist/backends/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/backends/shared.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAIrD,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACpC,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACnC,MAAM,EAAE,GAAkB,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,OAAO;QACL,EAAE;QACF,KAAK;YACH,IAAI,MAAM;gBAAE,OAAO;YACnB,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;QACD,WAAW,CAAI,EAA4B;YACzC,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC5B,CAAC;QACD,eAAe;YACb,mFAAmF;YACnF,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACjE,CAAC;QACD,gBAAgB,CAAC,OAAe;YAC9B,2EAA2E;YAC3E,uEAAuE;YACvE,MAAM,CAAC,MAAM,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAC;QAC7C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/backends/sqlite.d.ts

@@ -0,0 +1,5 @@
+import type { SqliteBackendHandle } from '../data-store.js';
+export declare function openSqliteBackend(opts: {
+    path: string;
+}): SqliteBackendHandle;
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/backends/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/backends/sqlite.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,mBAAmB,CAG7E"}

package/dist/backends/sqlite.js

@@ -0,0 +1,8 @@
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { buildSqliteDataStore } from './shared.js';
+export function openSqliteBackend(opts) {
+    mkdirSync(dirname(opts.path), { recursive: true });
+    return buildSqliteDataStore(opts.path);
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/backends/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../src/backends/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAInD,MAAM,UAAU,iBAAiB,CAAC,IAAsB;IACtD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,OAAO,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC"}

package/dist/baseline-repo.d.ts

@@ -0,0 +1,50 @@
+import { type Signal } from '@opensip-cli/core';
+import { type DataStore } from './data-store.js';
+/** One baseline entry to persist: its opaque fingerprint + the full Signal payload. */
+export interface BaselineEntry {
+    readonly fingerprint: string;
+    readonly payload: Signal;
+}
+/** One loaded baseline row: the fingerprint + its stored payload (null if absent). */
+export interface BaselineRow {
+    readonly fingerprint: string;
+    readonly payload: Signal | null;
+}
+/**
+ * The generic host-owned baseline repository (ADR-0036). One repo over the
+ * shared `tool_baseline_entries` / `tool_baseline_meta` tables, scoped by the
+ * `tool` column so every tool shares the table but never sees another tool's
+ * rows. Replaces the per-tool `GraphBaselineRepo` / `FitBaselineRepo`.
+ *
+ * `save` is an atomic per-tool replace (delete-all + bulk insert + meta upsert in
+ * one transaction), mirroring graph's atomic-rename-of-tmp-file semantic. The
+ * `payload` column carries the full Signal so the diff can surface full-object
+ * `resolved` findings and re-render SARIF.
+ */
+export declare class BaselineRepo {
+    private readonly datastore;
+    constructor(datastore: DataStore);
+    /**
+     * Replace this tool's entire baseline in one transaction. Entries are deduped
+     * by fingerprint (last wins) and sorted by fingerprint for deterministic
+     * ordering. The meta row is upserted as the existence marker — an empty
+     * baseline is a valid saved state ("saved, no findings" ≠ "never saved").
+     */
+    save(tool: string, entries: readonly BaselineEntry[]): void;
+    /** Load this tool's baseline rows (fingerprint + payload). Empty when none saved. */
+    load(tool: string): readonly BaselineRow[];
+    /** True iff this tool has saved a baseline (independent of whether it was empty). */
+    exists(tool: string): boolean;
+    /** When this tool's baseline was captured (ms epoch), or undefined when none exists. */
+    capturedAt(tool: string): number | undefined;
+    /**
+     * Delete this tool's baseline — entries + the meta existence marker, one
+     * transaction (`tools data purge`, ADR-0042). After a clear, `exists()` is
+     * false (vs. `save(tool, [])`, which leaves an EMPTY-but-saved baseline).
+     */
+    clear(tool: string): {
+        readonly entries: number;
+        readonly meta: boolean;
+    };
+}
+//# sourceMappingURL=baseline-repo.d.ts.map

package/dist/baseline-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline-repo.d.ts","sourceRoot":"","sources":["../src/baseline-repo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EAA2B,KAAK,SAAS,EAAyB,MAAM,iBAAiB,CAAC;AAKjG,uFAAuF;AACvF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,sFAAsF;AACtF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;gBAEjC,SAAS,EAAE,SAAS;IAIhC;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI;IAoD3D,qFAAqF;IACrF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE;IAgC1C,qFAAqF;IACrF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAU7B,wFAAwF;IACxF,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAU5C;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;KAAE;CAoB1E"}

package/dist/baseline-repo.js

@@ -0,0 +1,159 @@
+import { logger } from '@opensip-cli/core';
+import { eq, sql } from 'drizzle-orm';
+import { requireDrizzleDataStore } from './data-store.js';
+import { toolBaselineEntries, toolBaselineMeta } from './schema/baseline.js';
+const MODULE_NAME = 'datastore:baseline-repo';
+/**
+ * The generic host-owned baseline repository (ADR-0036). One repo over the
+ * shared `tool_baseline_entries` / `tool_baseline_meta` tables, scoped by the
+ * `tool` column so every tool shares the table but never sees another tool's
+ * rows. Replaces the per-tool `GraphBaselineRepo` / `FitBaselineRepo`.
+ *
+ * `save` is an atomic per-tool replace (delete-all + bulk insert + meta upsert in
+ * one transaction), mirroring graph's atomic-rename-of-tmp-file semantic. The
+ * `payload` column carries the full Signal so the diff can surface full-object
+ * `resolved` findings and re-render SARIF.
+ */
+export class BaselineRepo {
+    datastore;
+    constructor(datastore) {
+        this.datastore = requireDrizzleDataStore(datastore);
+    }
+    /**
+     * Replace this tool's entire baseline in one transaction. Entries are deduped
+     * by fingerprint (last wins) and sorted by fingerprint for deterministic
+     * ordering. The meta row is upserted as the existence marker — an empty
+     * baseline is a valid saved state ("saved, no findings" ≠ "never saved").
+     */
+    save(tool, entries) {
+        try {
+            const capturedAt = Date.now();
+            const byFingerprint = new Map();
+            for (const e of entries)
+                byFingerprint.set(e.fingerprint, e.payload);
+            const rows = [...byFingerprint.entries()]
+                .sort(([a], [b]) => Number(a > b) - Number(a < b))
+                .map(([fingerprint, payload]) => ({ tool, fingerprint, payload, capturedAt }));
+            this.datastore.transaction((tx) => {
+                tx.delete(toolBaselineEntries).where(eq(toolBaselineEntries.tool, tool)).run();
+                // Chunked insert to avoid hitting SQLite's SQLITE_MAX_VARIABLE_NUMBER (~32766 vars).
+                // Each row uses 4 bound parameters (tool, fingerprint, payload, capturedAt).
+                // 2000-row chunks are comfortably safe even on older SQLite builds.
+                if (rows.length > 0) {
+                    const CHUNK = 2000;
+                    for (let i = 0; i < rows.length; i += CHUNK) {
+                        const chunk = rows.slice(i, i + CHUNK);
+                        tx.insert(toolBaselineEntries).values(chunk).run();
+                    }
+                }
+                // Upsert the existence marker keyed on `tool`.
+                tx.insert(toolBaselineMeta)
+                    .values({ tool, capturedAt })
+                    .onConflictDoUpdate({
+                    target: toolBaselineMeta.tool,
+                    set: { capturedAt: sql `excluded.captured_at` },
+                })
+                    .run();
+            });
+            logger.info({
+                evt: 'datastore.baseline.save.complete',
+                module: MODULE_NAME,
+                msg: 'Saved tool baseline',
+                tool,
+                count: rows.length,
+            });
+        }
+        catch (error) {
+            /* v8 ignore start */
+            logger.error({
+                evt: 'datastore.baseline.save.error',
+                module: MODULE_NAME,
+                msg: 'Failed to save tool baseline',
+                tool,
+                error: error instanceof Error ? error.message : String(error),
+                ...(error instanceof Error && error.stack ? { stack: error.stack } : {}),
+            });
+            throw error;
+            /* v8 ignore stop */
+        }
+    }
+    /** Load this tool's baseline rows (fingerprint + payload). Empty when none saved. */
+    load(tool) {
+        try {
+            const rows = this.datastore.db
+                .select({
+                fingerprint: toolBaselineEntries.fingerprint,
+                payload: toolBaselineEntries.payload,
+            })
+                .from(toolBaselineEntries)
+                .where(eq(toolBaselineEntries.tool, tool))
+                .all();
+            logger.info({
+                evt: 'datastore.baseline.load.complete',
+                module: MODULE_NAME,
+                msg: 'Loaded tool baseline',
+                tool,
+                count: rows.length,
+            });
+            return rows.map((r) => ({ fingerprint: r.fingerprint, payload: r.payload }));
+        }
+        catch (error) {
+            /* v8 ignore start */
+            logger.error({
+                evt: 'datastore.baseline.load.error',
+                module: MODULE_NAME,
+                msg: 'Failed to load tool baseline',
+                tool,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+            /* v8 ignore stop */
+        }
+    }
+    /** True iff this tool has saved a baseline (independent of whether it was empty). */
+    exists(tool) {
+        const row = this.datastore.db
+            .select({ tool: toolBaselineMeta.tool })
+            .from(toolBaselineMeta)
+            .where(eq(toolBaselineMeta.tool, tool))
+            .limit(1)
+            .get();
+        return row !== undefined;
+    }
+    /** When this tool's baseline was captured (ms epoch), or undefined when none exists. */
+    capturedAt(tool) {
+        const row = this.datastore.db
+            .select({ capturedAt: toolBaselineMeta.capturedAt })
+            .from(toolBaselineMeta)
+            .where(eq(toolBaselineMeta.tool, tool))
+            .limit(1)
+            .get();
+        return row?.capturedAt;
+    }
+    /**
+     * Delete this tool's baseline — entries + the meta existence marker, one
+     * transaction (`tools data purge`, ADR-0042). After a clear, `exists()` is
+     * false (vs. `save(tool, [])`, which leaves an EMPTY-but-saved baseline).
+     */
+    clear(tool) {
+        let entries = 0;
+        let meta = false;
+        this.datastore.transaction((tx) => {
+            entries = tx
+                .delete(toolBaselineEntries)
+                .where(eq(toolBaselineEntries.tool, tool))
+                .run().changes;
+            meta = tx.delete(toolBaselineMeta).where(eq(toolBaselineMeta.tool, tool)).run().changes > 0;
+        });
+        logger.info({
+            evt: 'datastore.baseline.clear.complete',
+            module: MODULE_NAME,
+            msg: 'Cleared tool baseline',
+            tool,
+            entries,
+            meta,
+        });
+        return { entries, meta };
+    }
+}
+//# sourceMappingURL=baseline-repo.js.map

package/dist/baseline-repo.js.map

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