@principles/core 1.73.0

package/dist/runtime-v2/store/sqlite-connection-close.test.d.ts

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

package/dist/runtime-v2/store/sqlite-connection-close.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-connection-close.test.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/store/sqlite-connection-close.test.ts"],"names":[],"mappings":""}

package/dist/runtime-v2/store/sqlite-connection-close.test.js

@@ -0,0 +1,57 @@
+/**
+ * SqliteConnection close() regression tests.
+ *
+ * Verifies that close() is safe to call even when:
+ * 1. getDb() was never called
+ * 2. getDb() failed (threw before this.db was set)
+ */
+import { describe, it, expect, afterEach } from 'vitest';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { SqliteConnection } from './sqlite-connection.js';
+describe('SqliteConnection.close', () => {
+    const tmpDir = path.join(os.tmpdir(), `pd-sqlite-conn-test-${process.pid}-${Date.now()}`);
+    afterEach(() => {
+        try {
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+        }
+        catch {
+            // ignore cleanup errors on Windows
+        }
+    });
+    it('close() is safe when getDb() was never called', () => {
+        const testDir = path.join(tmpDir, 'never-opened');
+        fs.mkdirSync(testDir, { recursive: true });
+        const conn = new SqliteConnection(testDir);
+        expect(() => conn.close()).not.toThrow();
+    });
+    it('close() is safe when connection initialization failed', () => {
+        const testDir = path.join(tmpDir, 'init-fail');
+        fs.mkdirSync(testDir, { recursive: true });
+        const conn = new SqliteConnection(testDir);
+        expect(() => conn.close()).not.toThrow();
+    });
+    it('close() is safe on fresh connection with no db file', () => {
+        const testDir = path.join(tmpDir, 'no-db-file');
+        fs.mkdirSync(testDir, { recursive: true });
+        const conn = new SqliteConnection(testDir);
+        expect(() => conn.close()).not.toThrow();
+    });
+    it('close() works normally after successful getDb()', () => {
+        const testDir = path.join(tmpDir, 'normal-close');
+        fs.mkdirSync(testDir, { recursive: true });
+        const conn = new SqliteConnection(testDir);
+        conn.getDb();
+        expect(() => conn.close()).not.toThrow();
+    });
+    it('close() can be called multiple times safely', () => {
+        const testDir = path.join(tmpDir, 'double-close');
+        fs.mkdirSync(testDir, { recursive: true });
+        const conn = new SqliteConnection(testDir);
+        conn.getDb();
+        conn.close();
+        expect(() => conn.close()).not.toThrow();
+    });
+});
+//# sourceMappingURL=sqlite-connection-close.test.js.map

package/dist/runtime-v2/store/sqlite-connection-close.test.js.map

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

package/dist/runtime-v2/store/sqlite-connection-pragma.test.d.ts

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

package/dist/runtime-v2/store/sqlite-connection-pragma.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-connection-pragma.test.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/store/sqlite-connection-pragma.test.ts"],"names":[],"mappings":""}

package/dist/runtime-v2/store/sqlite-connection-pragma.test.js

@@ -0,0 +1,261 @@
+/**
+ * PRI-140: SQLite WAL & Busy Timeout Configuration tests.
+ *
+ * TDD tests verifying:
+ * 1. Writable connections apply WAL / busy_timeout / synchronous = NORMAL
+ * 2. Data survives reconnect under WAL
+ * 3. Readonly connections never create .pd dir or mutate schema
+ * 4. Pragma failures throw PDRuntimeError (not silent)
+ * 5. getPragmaReport() reports actual SQLite configuration
+ */
+import { describe, it, expect, afterEach } from 'vitest';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import Database from 'better-sqlite3';
+import { SqliteConnection } from './sqlite-connection.js';
+import { PDRuntimeError } from '../error-categories.js';
+const TMP = path.join(os.tmpdir(), `pd-pri140-${process.pid}`);
+function freshDir(label) {
+    const dir = path.join(TMP, `${label}-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+    fs.mkdirSync(dir, { recursive: true });
+    return dir;
+}
+afterEach(() => {
+    try {
+        fs.rmSync(TMP, { recursive: true, force: true });
+    }
+    catch { /* Windows */ }
+});
+// -- 1. Writable connection applies required pragmas --
+describe('PRI-140: writable connection pragmas', () => {
+    it('sets journal_mode=WAL, busy_timeout=5000, synchronous=NORMAL, foreign_keys=ON', () => {
+        const dir = freshDir('pragma-check');
+        const conn = new SqliteConnection(dir);
+        try {
+            const db = conn.getDb();
+            const journalMode = db.pragma('journal_mode', { simple: true });
+            expect(journalMode).toBe('wal');
+            const busyTimeout = db.pragma('busy_timeout', { simple: true });
+            expect(busyTimeout).toBe(5000);
+            const synchronous = db.pragma('synchronous', { simple: true });
+            expect(synchronous).toBe(1);
+            const foreignKeys = db.pragma('foreign_keys', { simple: true });
+            expect(foreignKeys).toBe(1);
+        }
+        finally {
+            conn.close();
+        }
+    });
+});
+// -- 2. Reconnect retains data with WAL --
+describe('PRI-140: reconnect data retention', () => {
+    it('data survives close and reopen under WAL', () => {
+        const dir = freshDir('reconnect');
+        const conn1 = new SqliteConnection(dir);
+        const db1 = conn1.getDb();
+        db1.prepare('INSERT INTO tasks (task_id, task_kind, status, created_at, updated_at) VALUES (?, ?, ?, ?, ?)').run('t-001', 'diagnostician', 'pending', new Date().toISOString(), new Date().toISOString());
+        conn1.close();
+        const conn2 = new SqliteConnection(dir);
+        try {
+            const db2 = conn2.getDb();
+            const row = db2.prepare("SELECT * FROM tasks WHERE task_id = 't-001'").get();
+            expect(row).toBeDefined();
+            expect(row.task_id).toBe('t-001');
+            const journalMode = db2.pragma('journal_mode', { simple: true });
+            expect(journalMode).toBe('wal');
+        }
+        finally {
+            conn2.close();
+        }
+    });
+});
+// -- 3. Readonly connection: no .pd creation, no schema mutation --
+describe('PRI-140: readonly connection constraints', () => {
+    it('does not create .pd directory when it does not exist', () => {
+        const writableDir = freshDir('readonly-setup');
+        const writer = new SqliteConnection(writableDir);
+        writer.getDb();
+        writer.close();
+        const pdDir = path.join(writableDir, '.pd');
+        expect(fs.existsSync(pdDir)).toBe(true);
+        const readonlyConn = new SqliteConnection({ workspaceDir: writableDir, readonly: true });
+        try {
+            const db = readonlyConn.getDb();
+            const tables = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='tasks'").all();
+            expect(tables.length).toBe(1);
+            expect(() => {
+                db.exec("INSERT INTO tasks (task_id, task_kind, status, created_at, updated_at) VALUES ('x','y','z','a','b')");
+            }).toThrow();
+        }
+        finally {
+            readonlyConn.close();
+        }
+    });
+    it('does not create .pd directory on a fresh path', () => {
+        const freshPath = freshDir('readonly-fresh');
+        const pdDir = path.join(freshPath, '.pd');
+        expect(fs.existsSync(pdDir)).toBe(false);
+        const readonlyConn = new SqliteConnection({ workspaceDir: freshPath, readonly: true });
+        expect(() => readonlyConn.getDb()).toThrow();
+        expect(fs.existsSync(pdDir)).toBe(false);
+        readonlyConn.close();
+    });
+});
+// -- 4. Pragma failure throws PDRuntimeError --
+describe('PRI-140: pragma failure is loud', () => {
+    it('throws PDRuntimeError when WAL pragma fails', () => {
+        const dir = freshDir('pragma-fail');
+        const origPragma = Database.prototype.pragma;
+        Database.prototype.pragma = function (...args) {
+            if (typeof args[0] === 'string' && args[0].includes('journal_mode')) {
+                throw new Error('simulated pragma failure');
+            }
+            return origPragma.apply(this, args);
+        };
+        try {
+            const conn = new SqliteConnection(dir);
+            expect(() => conn.getDb()).toThrow(PDRuntimeError);
+            conn.close();
+        }
+        finally {
+            Database.prototype.pragma = origPragma;
+        }
+    });
+    it('PDRuntimeError has storage_unavailable category', () => {
+        const dir = freshDir('pragma-category');
+        const origPragma = Database.prototype.pragma;
+        Database.prototype.pragma = function (...args) {
+            if (typeof args[0] === 'string' && args[0].includes('journal_mode')) {
+                throw new Error('simulated pragma failure');
+            }
+            return origPragma.apply(this, args);
+        };
+        try {
+            const conn = new SqliteConnection(dir);
+            try {
+                conn.getDb();
+                expect.unreachable('should have thrown');
+            }
+            catch (err) {
+                expect(err).toBeInstanceOf(PDRuntimeError);
+                expect(err.category).toBe('storage_unavailable');
+                expect(err.message).toContain('pragma');
+            }
+            conn.close();
+        }
+        finally {
+            Database.prototype.pragma = origPragma;
+        }
+    });
+});
+// -- 5. getPragmaReport() diagnostics --
+describe('PRI-140: getPragmaReport()', () => {
+    it('reports healthy for correctly configured writable connection', () => {
+        const dir = freshDir('report-healthy');
+        const conn = new SqliteConnection(dir);
+        try {
+            conn.getDb();
+            const report = conn.getPragmaReport();
+            expect(report.healthy).toBe(true);
+            expect(report.issues).toHaveLength(0);
+            expect(report.journalMode).toBe('wal');
+            expect(report.busyTimeout).toBe(5000);
+            expect(report.synchronous).toBe('1');
+            expect(report.foreignKeys).toBe(true);
+        }
+        finally {
+            conn.close();
+        }
+    });
+    it('reports unhealthy when db is not opened', () => {
+        const dir = freshDir('report-not-opened');
+        const conn = new SqliteConnection(dir);
+        try {
+            const report = conn.getPragmaReport();
+            expect(report.healthy).toBe(false);
+            expect(report.issues).toContain('database not opened');
+        }
+        finally {
+            conn.close();
+        }
+    });
+});
+function tryGetPragmaError(conn) {
+    try {
+        conn.getDb();
+    }
+    catch (err) {
+        if (err instanceof PDRuntimeError) {
+            return err;
+        }
+        return undefined;
+    }
+}
+// -- 6. Verification readback failure (pragma SET succeeds but readback returns unexpected value) --
+describe('PRI-140: verification readback failure', () => {
+    it('throws PDRuntimeError when foreign_keys readback returns false after SET succeeded', () => {
+        const dir = freshDir('fk-readback-fail');
+        const origPragma = Database.prototype.pragma;
+        Database.prototype.pragma = function (...args) {
+            // Only intercept foreign_keys readback; let all other calls (including SET) pass through
+            if (typeof args[0] === 'string' && args[0] === 'foreign_keys' && typeof args[1] === 'object' && args[1] !== null && args[1].simple === true) {
+                return 0;
+            }
+            return origPragma.apply(this, args);
+        };
+        try {
+            const conn = new SqliteConnection(dir);
+            expect(() => conn.getDb()).toThrow(PDRuntimeError);
+            const err = tryGetPragmaError(conn);
+            expect(err?.message).toContain('Failed to enable foreign keys');
+        }
+        finally {
+            Database.prototype.pragma = origPragma;
+        }
+    });
+    it('throws PDRuntimeError when journal_mode readback returns non-WAL value after SET succeeded', () => {
+        const dir = freshDir('wal-readback-fail');
+        const origPragma = Database.prototype.pragma;
+        Database.prototype.pragma = function (...args) {
+            // Only intercept journal_mode readback; let all other calls pass through
+            if (typeof args[0] === 'string' && args[0] === 'journal_mode' && typeof args[1] === 'object' && args[1] !== null && args[1].simple === true) {
+                return 'memory';
+            }
+            return origPragma.apply(this, args);
+        };
+        try {
+            const conn = new SqliteConnection(dir);
+            expect(() => conn.getDb()).toThrow(PDRuntimeError);
+            const err = tryGetPragmaError(conn);
+            expect(err?.message).toContain('got: memory');
+        }
+        finally {
+            Database.prototype.pragma = origPragma;
+        }
+    });
+});
+// -- 7. getDb() does not cache broken connection after pragma failure --
+describe('PRI-140: getDb() leak protection', () => {
+    it('second getDb() after pragma failure also throws (no cached broken db)', () => {
+        const dir = freshDir('leak-protection');
+        const origPragma = Database.prototype.pragma;
+        Database.prototype.pragma = function (...args) {
+            if (typeof args[0] === 'string' && args[0].includes('journal_mode')) {
+                throw new Error('simulated pragma failure');
+            }
+            return origPragma.apply(this, args);
+        };
+        try {
+            const conn = new SqliteConnection(dir);
+            expect(() => conn.getDb()).toThrow(PDRuntimeError);
+            // Second call should also throw, not return cached broken connection
+            expect(() => conn.getDb()).toThrow(PDRuntimeError);
+            conn.close();
+        }
+        finally {
+            Database.prototype.pragma = origPragma;
+        }
+    });
+});
+//# sourceMappingURL=sqlite-connection-pragma.test.js.map

package/dist/runtime-v2/store/sqlite-connection-pragma.test.js.map

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

package/dist/runtime-v2/store/sqlite-connection.d.ts

@@ -0,0 +1,39 @@
+/**
+ * SQLite connection factory for PD Runtime v2 state store.
+ *
+ * Opens (or creates) the workspace-level DB at `<workspaceDir>/.pd/state.db`
+ * with WAL journal mode, 5-second busy timeout, and synchronous NORMAL.
+ * Initializes the tasks and runs tables on first open.
+ *
+ * @example
+ * const conn = new SqliteConnection('/path/to/workspace');
+ * const db = conn.getDb();
+ * // ... use db
+ * conn.close();
+ */
+import Database from 'better-sqlite3';
+export interface SqliteConnectionOptions {
+    workspaceDir: string;
+    readonly?: boolean;
+}
+export interface SqlitePragmaReport {
+    journalMode: string;
+    busyTimeout: number;
+    synchronous: string;
+    foreignKeys: boolean;
+    healthy: boolean;
+    issues: string[];
+}
+export declare class SqliteConnection {
+    private db;
+    private readonly dbPath;
+    private readonly readonlyMode;
+    constructor(workspaceDirOrOpts: string | SqliteConnectionOptions);
+    getDb(): Database.Database;
+    getPragmaReport(): SqlitePragmaReport;
+    private initSchema;
+    private migrateSchema;
+    /** Closes the underlying database connection. */
+    close(): void;
+}
+//# sourceMappingURL=sqlite-connection.d.ts.map

package/dist/runtime-v2/store/sqlite-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-connection.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/store/sqlite-connection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAKtC,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,EAAE,CAAkC;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;gBAE3B,kBAAkB,EAAE,MAAM,GAAG,uBAAuB;IAYhE,KAAK,IAAI,QAAQ,CAAC,QAAQ;IAsD1B,eAAe,IAAI,kBAAkB;IA4BrC,OAAO,CAAC,UAAU;IAiOlB,OAAO,CAAC,aAAa;IA+BrB,iDAAiD;IACjD,KAAK,IAAI,IAAI;CAWd"}