hzl-core 0.1.0

package/dist/db/connection.d.ts

@@ -0,0 +1,13 @@
+import Database from 'better-sqlite3';
+export declare function getDefaultDbPath(): string;
+export declare function createConnection(dbPath?: string): Database.Database;
+/**
+ * Execute a function within a write transaction using BEGIN IMMEDIATE.
+ * This ensures proper locking for concurrent access from multiple agents.
+ * Includes retry logic for SQLITE_BUSY errors.
+ */
+export declare function withWriteTransaction<T>(db: Database.Database, fn: () => T, opts?: {
+    retries?: number;
+    busySleepMs?: number;
+}): T;
+//# sourceMappingURL=connection.d.ts.map

package/dist/db/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/db/connection.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAMtC,wBAAgB,gBAAgB,IAAI,MAAM,CAGzC;AAED,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAcnE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,EAAE,EAAE,MAAM,CAAC,EACX,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,CAAC,CAuBH"}

package/dist/db/connection.js

@@ -0,0 +1,52 @@
+import Database from 'better-sqlite3';
+import path from 'path';
+import os from 'os';
+import fs from 'fs';
+import { runMigrations } from './migrations.js';
+export function getDefaultDbPath() {
+    const hzlDir = path.join(os.homedir(), '.hzl');
+    return path.join(hzlDir, 'data.db');
+}
+export function createConnection(dbPath) {
+    const resolvedPath = dbPath ?? process.env.HZL_DB ?? getDefaultDbPath();
+    // Handle in-memory databases
+    if (resolvedPath !== ':memory:') {
+        const dir = path.dirname(resolvedPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+    }
+    const db = new Database(resolvedPath);
+    runMigrations(db);
+    return db;
+}
+/**
+ * Execute a function within a write transaction using BEGIN IMMEDIATE.
+ * This ensures proper locking for concurrent access from multiple agents.
+ * Includes retry logic for SQLITE_BUSY errors.
+ */
+export function withWriteTransaction(db, fn, opts) {
+    const retries = opts?.retries ?? 5;
+    const busySleepMs = opts?.busySleepMs ?? 25;
+    let attempt = 0;
+    while (true) {
+        try {
+            // Use immediate transaction for write lock
+            return db.transaction(fn).immediate();
+        }
+        catch (err) {
+            const isBusy = err?.code === 'SQLITE_BUSY' || String(err?.message).includes('SQLITE_BUSY');
+            if (!isBusy || attempt >= retries) {
+                throw err;
+            }
+            attempt += 1;
+            // Simple sleep with exponential backoff
+            const sleepTime = busySleepMs * attempt;
+            const start = Date.now();
+            while (Date.now() - start < sleepTime) {
+                // Busy wait (synchronous sleep for better-sqlite3)
+            }
+        }
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/db/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/db/connection.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,UAAU,gBAAgB;IAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAe;IAC9C,MAAM,YAAY,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,gBAAgB,EAAE,CAAC;IAExE,6BAA6B;IAC7B,IAAI,YAAY,KAAK,UAAU,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,YAAY,CAAC,CAAC;IACtC,aAAa,CAAC,EAAE,CAAC,CAAC;IAClB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,EAAqB,EACrB,EAAW,EACX,IAAiD;IAEjD,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,CAAC,CAAC;IACnC,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,EAAE,CAAC;IAC5C,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,2CAA2C;YAC3C,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC;QACxC,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,GAAG,EAAE,IAAI,KAAK,aAAa,IAAI,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;YAC3F,IAAI,CAAC,MAAM,IAAI,OAAO,IAAI,OAAO,EAAE,CAAC;gBAClC,MAAM,GAAG,CAAC;YACZ,CAAC;YACD,OAAO,IAAI,CAAC,CAAC;YACb,wCAAwC;YACxC,MAAM,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;YACxC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,SAAS,EAAE,CAAC;gBACtC,mDAAmD;YACrD,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/db/connection.test.d.ts

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

package/dist/db/connection.test.d.ts.map

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

package/dist/db/connection.test.js

@@ -0,0 +1,63 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { createConnection, getDefaultDbPath, withWriteTransaction } from './connection.js';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+describe('connection', () => {
+    const testDbPath = path.join(os.tmpdir(), 'hzl-test-' + Date.now() + '.db');
+    afterEach(() => {
+        try {
+            if (fs.existsSync(testDbPath))
+                fs.unlinkSync(testDbPath);
+            if (fs.existsSync(testDbPath + '-wal'))
+                fs.unlinkSync(testDbPath + '-wal');
+            if (fs.existsSync(testDbPath + '-shm'))
+                fs.unlinkSync(testDbPath + '-shm');
+        }
+        catch { }
+    });
+    it('creates database file at specified path', () => {
+        const db = createConnection(testDbPath);
+        expect(fs.existsSync(testDbPath)).toBe(true);
+        db.close();
+    });
+    it('runs migrations on new database', () => {
+        const db = createConnection(testDbPath);
+        const tables = db.prepare("SELECT name FROM sqlite_master WHERE type='table'").all();
+        const tableNames = tables.map((t) => t.name);
+        expect(tableNames).toContain('events');
+        expect(tableNames).toContain('tasks_current');
+        expect(tableNames).toContain('projection_state');
+        db.close();
+    });
+    it('returns default path in ~/.hzl/', () => {
+        const defaultPath = getDefaultDbPath();
+        expect(defaultPath).toContain('.hzl');
+        expect(defaultPath).toContain('data.db');
+    });
+});
+describe('withWriteTransaction', () => {
+    it('commits on success', () => {
+        const db = createConnection(':memory:');
+        withWriteTransaction(db, () => {
+            db.prepare('INSERT INTO projection_state (name, last_event_id, updated_at) VALUES (?, ?, ?)').run('test', 0, new Date().toISOString());
+        });
+        const row = db.prepare('SELECT * FROM projection_state WHERE name = ?').get('test');
+        expect(row).toBeDefined();
+        db.close();
+    });
+    it('rolls back on error', () => {
+        const db = createConnection(':memory:');
+        try {
+            withWriteTransaction(db, () => {
+                db.prepare('INSERT INTO projection_state (name, last_event_id, updated_at) VALUES (?, ?, ?)').run('test', 0, new Date().toISOString());
+                throw new Error('Intentional failure');
+            });
+        }
+        catch { }
+        const row = db.prepare('SELECT * FROM projection_state WHERE name = ?').get('test');
+        expect(row).toBeUndefined();
+        db.close();
+    });
+});
+//# sourceMappingURL=connection.test.js.map

package/dist/db/connection.test.js.map

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

package/dist/db/migrations/v2.d.ts

@@ -0,0 +1,2 @@
+export declare const MIGRATION_V2 = "\n-- Placeholder for future schema changes\n";
+//# sourceMappingURL=v2.d.ts.map

package/dist/db/migrations/v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2.d.ts","sourceRoot":"","sources":["../../../src/db/migrations/v2.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,iDAExB,CAAC"}

package/dist/db/migrations/v2.js

@@ -0,0 +1,4 @@
+export const MIGRATION_V2 = `
+-- Placeholder for future schema changes
+`;
+//# sourceMappingURL=v2.js.map

package/dist/db/migrations/v2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2.js","sourceRoot":"","sources":["../../../src/db/migrations/v2.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;;CAE3B,CAAC"}

package/dist/db/migrations.d.ts

@@ -0,0 +1,4 @@
+import type Database from 'better-sqlite3';
+export declare function getCurrentVersion(db: Database.Database): number;
+export declare function runMigrations(db: Database.Database): void;
+//# sourceMappingURL=migrations.d.ts.map

package/dist/db/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/db/migrations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAO3C,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAgB/D;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CA2BzD"}

package/dist/db/migrations.js

@@ -0,0 +1,45 @@
+import { SCHEMA_V1, PRAGMAS } from './schema.js';
+const MIGRATIONS = {
+    1: SCHEMA_V1,
+};
+export function getCurrentVersion(db) {
+    try {
+        const rows = db
+            .prepare('SELECT version FROM schema_migrations')
+            .all();
+        let maxVersion = 0;
+        for (const row of rows) {
+            const parsed = Number(row.version);
+            if (Number.isFinite(parsed) && parsed > maxVersion) {
+                maxVersion = parsed;
+            }
+        }
+        return maxVersion;
+    }
+    catch {
+        return 0;
+    }
+}
+export function runMigrations(db) {
+    db.exec(PRAGMAS);
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS schema_migrations (
+      version INTEGER PRIMARY KEY,
+      applied_at TEXT NOT NULL
+    )
+  `);
+    const currentVersion = getCurrentVersion(db);
+    const versions = Object.keys(MIGRATIONS)
+        .map(Number)
+        .sort((a, b) => a - b);
+    for (const version of versions) {
+        if (version > currentVersion) {
+            db.transaction(() => {
+                db.exec(MIGRATIONS[version]);
+                db.prepare('INSERT INTO schema_migrations (version, applied_at) VALUES (?, ?)').run(version, new Date().toISOString());
+            })();
+        }
+    }
+    db.exec(SCHEMA_V1);
+}
+//# sourceMappingURL=migrations.js.map

package/dist/db/migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../src/db/migrations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,UAAU,GAA2B;IACzC,CAAC,EAAE,SAAS;CACb,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,EAAqB;IACrD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,EAAE;aACZ,OAAO,CAAC,uCAAuC,CAAC;aAChD,GAAG,EAA2C,CAAC;QAClD,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACnC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,UAAU,EAAE,CAAC;gBACnD,UAAU,GAAG,MAAM,CAAC;YACtB,CAAC;QACH,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAqB;IACjD,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEjB,EAAE,CAAC,IAAI,CAAC;;;;;GAKP,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;SACrC,GAAG,CAAC,MAAM,CAAC;SACX,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAEzB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,GAAG,cAAc,EAAE,CAAC;YAC7B,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;gBAClB,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC7B,EAAE,CAAC,OAAO,CACR,mEAAmE,CACpE,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;YAC3C,CAAC,CAAC,EAAE,CAAC;QACP,CAAC;IACH,CAAC;IAED,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACrB,CAAC"}

package/dist/db/migrations.test.d.ts

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

package/dist/db/migrations.test.d.ts.map

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

package/dist/db/migrations.test.js

@@ -0,0 +1,75 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import Database from 'better-sqlite3';
+import { runMigrations, getCurrentVersion } from './migrations.js';
+describe('migrations', () => {
+    let db;
+    beforeEach(() => {
+        db = new Database(':memory:');
+    });
+    afterEach(() => {
+        db.close();
+    });
+    it('creates schema_migrations table', () => {
+        runMigrations(db);
+        const table = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='schema_migrations'").get();
+        expect(table).toBeDefined();
+    });
+    it('creates events table with correct columns', () => {
+        runMigrations(db);
+        const columns = db.prepare("PRAGMA table_info(events)").all();
+        const columnNames = columns.map((c) => c.name);
+        expect(columnNames).toContain('event_id');
+        expect(columnNames).toContain('task_id');
+        expect(columnNames).toContain('type');
+        expect(columnNames).toContain('data');
+        expect(columnNames).toContain('timestamp');
+    });
+    it('creates tasks_current projection table with lease fields', () => {
+        runMigrations(db);
+        const columns = db.prepare("PRAGMA table_info(tasks_current)").all();
+        const columnNames = columns.map((c) => c.name);
+        expect(columnNames).toContain('task_id');
+        expect(columnNames).toContain('title');
+        expect(columnNames).toContain('status');
+        expect(columnNames).toContain('project');
+        expect(columnNames).toContain('claimed_at');
+        expect(columnNames).toContain('lease_until');
+    });
+    it('creates task_dependencies table', () => {
+        runMigrations(db);
+        const table = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='task_dependencies'").get();
+        expect(table).toBeDefined();
+    });
+    it('creates projection_state table', () => {
+        runMigrations(db);
+        const table = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='projection_state'").get();
+        expect(table).toBeDefined();
+    });
+    it('creates task_tags table for fast tag filtering', () => {
+        runMigrations(db);
+        const table = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='task_tags'").get();
+        expect(table).toBeDefined();
+    });
+    it('creates task_comments table', () => {
+        runMigrations(db);
+        const table = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='task_comments'").get();
+        expect(table).toBeDefined();
+    });
+    it('creates task_checkpoints table', () => {
+        runMigrations(db);
+        const table = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='task_checkpoints'").get();
+        expect(table).toBeDefined();
+    });
+    it('creates task_search FTS5 table', () => {
+        runMigrations(db);
+        const table = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='task_search'").get();
+        expect(table).toBeDefined();
+    });
+    it('is idempotent', () => {
+        runMigrations(db);
+        runMigrations(db);
+        const version = getCurrentVersion(db);
+        expect(version).toBe(1);
+    });
+});
+//# sourceMappingURL=migrations.test.js.map

package/dist/db/migrations.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.test.js","sourceRoot":"","sources":["../../src/db/migrations.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEnE,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,IAAI,EAAqB,CAAC;IAE1B,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,GAAG,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,aAAa,CAAC,EAAE,CAAC,CAAC;QAClB,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CACtB,gFAAgF,CACjF,CAAC,GAAG,EAAE,CAAC;QACR,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,aAAa,CAAC,EAAE,CAAC,CAAC;QAClB,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC,GAAG,EAAE,CAAC;QAC9D,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,aAAa,CAAC,EAAE,CAAC,CAAC;QAClB,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC,GAAG,EAAE,CAAC;QACrE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,aAAa,CAAC,EAAE,CAAC,CAAC;QAClB,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CACtB,gFAAgF,CACjF,CAAC,GAAG,EAAE,CAAC;QACR,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,aAAa,CAAC,EAAE,CAAC,CAAC;QAClB,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CACtB,+EAA+E,CAChF,CAAC,GAAG,EAAE,CAAC;QACR,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,aAAa,CAAC,EAAE,CAAC,CAAC;QAClB,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CACtB,wEAAwE,CACzE,CAAC,GAAG,EAAE,CAAC;QACR,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,aAAa,CAAC,EAAE,CAAC,CAAC;QAClB,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CACtB,4EAA4E,CAC7E,CAAC,GAAG,EAAE,CAAC;QACR,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,aAAa,CAAC,EAAE,CAAC,CAAC;QAClB,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CACtB,+EAA+E,CAChF,CAAC,GAAG,EAAE,CAAC;QACR,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,aAAa,CAAC,EAAE,CAAC,CAAC;QAClB,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CACtB,0EAA0E,CAC3E,CAAC,GAAG,EAAE,CAAC;QACR,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,eAAe,EAAE,GAAG,EAAE;QACvB,aAAa,CAAC,EAAE,CAAC,CAAC;QAClB,aAAa,CAAC,EAAE,CAAC,CAAC;QAClB,MAAM,OAAO,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC;QACtC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/db/schema.d.ts

@@ -0,0 +1,3 @@
+export declare const SCHEMA_V1 = "\n-- Append-only event store (source of truth)\nCREATE TABLE IF NOT EXISTS events (\n    id               INTEGER PRIMARY KEY AUTOINCREMENT,\n    event_id         TEXT NOT NULL UNIQUE,\n    task_id          TEXT NOT NULL,\n    type             TEXT NOT NULL,\n    data             TEXT NOT NULL CHECK (json_valid(data)),\n    author           TEXT,\n    agent_id         TEXT,\n    session_id       TEXT,\n    correlation_id   TEXT,\n    causation_id     TEXT,\n    timestamp        TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ','now'))\n);\n\n-- Track last applied event id per projection (enables incremental projection + doctor checks)\nCREATE TABLE IF NOT EXISTS projection_state (\n    name          TEXT PRIMARY KEY,\n    last_event_id INTEGER NOT NULL DEFAULT 0,\n    updated_at    TEXT NOT NULL\n);\n\n-- Current-state projection for fast reads (rebuildable from events)\nCREATE TABLE IF NOT EXISTS tasks_current (\n    task_id            TEXT PRIMARY KEY,\n    title              TEXT NOT NULL,\n    project            TEXT NOT NULL,\n    status             TEXT NOT NULL CHECK (status IN ('backlog','ready','in_progress','done','archived')),\n    parent_id          TEXT,\n    description        TEXT,\n    links              TEXT NOT NULL DEFAULT '[]' CHECK (json_valid(links)),\n    tags               TEXT NOT NULL DEFAULT '[]' CHECK (json_valid(tags)),\n    priority           INTEGER NOT NULL DEFAULT 0 CHECK (priority BETWEEN 0 AND 3),\n    due_at             TEXT,\n    metadata           TEXT NOT NULL DEFAULT '{}' CHECK (json_valid(metadata)),\n    claimed_at         TEXT,\n    claimed_by_author  TEXT,\n    claimed_by_agent_id TEXT,\n    lease_until        TEXT,\n    created_at         TEXT NOT NULL,\n    updated_at         TEXT NOT NULL,\n    last_event_id      INTEGER NOT NULL\n);\n\n-- Dependency edges for fast availability checks (rebuildable from events)\nCREATE TABLE IF NOT EXISTS task_dependencies (\n    task_id        TEXT NOT NULL,\n    depends_on_id  TEXT NOT NULL,\n    PRIMARY KEY (task_id, depends_on_id)\n);\n\n-- Fast tag filtering (rebuildable)\nCREATE TABLE IF NOT EXISTS task_tags (\n    task_id TEXT NOT NULL,\n    tag     TEXT NOT NULL,\n    PRIMARY KEY (task_id, tag)\n);\n\n-- Fast access for steering comments (rebuildable)\nCREATE TABLE IF NOT EXISTS task_comments (\n    event_rowid INTEGER PRIMARY KEY,\n    task_id     TEXT NOT NULL,\n    author      TEXT,\n    agent_id    TEXT,\n    text        TEXT NOT NULL,\n    timestamp   TEXT NOT NULL\n);\n\n-- Fast access for checkpoints (rebuildable)\nCREATE TABLE IF NOT EXISTS task_checkpoints (\n    event_rowid INTEGER PRIMARY KEY,\n    task_id     TEXT NOT NULL,\n    name        TEXT NOT NULL,\n    data        TEXT NOT NULL DEFAULT '{}' CHECK (json_valid(data)),\n    timestamp   TEXT NOT NULL\n);\n\n-- Full-text search over tasks (rebuildable)\nCREATE VIRTUAL TABLE IF NOT EXISTS task_search USING fts5(\n    task_id UNINDEXED,\n    title,\n    description\n);\n\n-- Indexes for events\nCREATE INDEX IF NOT EXISTS idx_events_task_id ON events(task_id);\nCREATE INDEX IF NOT EXISTS idx_events_task_id_id ON events(task_id, id);\nCREATE INDEX IF NOT EXISTS idx_events_type ON events(type);\nCREATE INDEX IF NOT EXISTS idx_events_timestamp ON events(timestamp);\nCREATE INDEX IF NOT EXISTS idx_events_correlation_id ON events(correlation_id);\n\n-- Indexes for tasks_current\nCREATE INDEX IF NOT EXISTS idx_tasks_current_project_status ON tasks_current(project, status);\nCREATE INDEX IF NOT EXISTS idx_tasks_current_priority ON tasks_current(project, priority, created_at);\nCREATE INDEX IF NOT EXISTS idx_tasks_current_claim_next ON tasks_current(project, status, priority DESC, created_at ASC, task_id ASC);\nCREATE INDEX IF NOT EXISTS idx_tasks_current_stuck ON tasks_current(project, status, claimed_at);\nCREATE INDEX IF NOT EXISTS idx_tasks_current_parent ON tasks_current(parent_id);\n\n-- Indexes for dependencies\nCREATE INDEX IF NOT EXISTS idx_deps_depends_on ON task_dependencies(depends_on_id);\n\n-- Indexes for tags/comments/checkpoints\nCREATE INDEX IF NOT EXISTS idx_task_tags_tag ON task_tags(tag, task_id);\nCREATE INDEX IF NOT EXISTS idx_task_comments_task ON task_comments(task_id, event_rowid);\nCREATE INDEX IF NOT EXISTS idx_task_checkpoints_task ON task_checkpoints(task_id, event_rowid);\n";
+export declare const PRAGMAS = "\nPRAGMA journal_mode=WAL;\nPRAGMA synchronous=NORMAL;\nPRAGMA foreign_keys=ON;\nPRAGMA busy_timeout=5000;\n";
+//# sourceMappingURL=schema.d.ts.map

package/dist/db/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,2uIA0GrB,CAAC;AAEF,eAAO,MAAM,OAAO,iHAKnB,CAAC"}

package/dist/db/schema.js

@@ -0,0 +1,114 @@
+export const SCHEMA_V1 = `
+-- Append-only event store (source of truth)
+CREATE TABLE IF NOT EXISTS events (
+    id               INTEGER PRIMARY KEY AUTOINCREMENT,
+    event_id         TEXT NOT NULL UNIQUE,
+    task_id          TEXT NOT NULL,
+    type             TEXT NOT NULL,
+    data             TEXT NOT NULL CHECK (json_valid(data)),
+    author           TEXT,
+    agent_id         TEXT,
+    session_id       TEXT,
+    correlation_id   TEXT,
+    causation_id     TEXT,
+    timestamp        TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ','now'))
+);
+
+-- Track last applied event id per projection (enables incremental projection + doctor checks)
+CREATE TABLE IF NOT EXISTS projection_state (
+    name          TEXT PRIMARY KEY,
+    last_event_id INTEGER NOT NULL DEFAULT 0,
+    updated_at    TEXT NOT NULL
+);
+
+-- Current-state projection for fast reads (rebuildable from events)
+CREATE TABLE IF NOT EXISTS tasks_current (
+    task_id            TEXT PRIMARY KEY,
+    title              TEXT NOT NULL,
+    project            TEXT NOT NULL,
+    status             TEXT NOT NULL CHECK (status IN ('backlog','ready','in_progress','done','archived')),
+    parent_id          TEXT,
+    description        TEXT,
+    links              TEXT NOT NULL DEFAULT '[]' CHECK (json_valid(links)),
+    tags               TEXT NOT NULL DEFAULT '[]' CHECK (json_valid(tags)),
+    priority           INTEGER NOT NULL DEFAULT 0 CHECK (priority BETWEEN 0 AND 3),
+    due_at             TEXT,
+    metadata           TEXT NOT NULL DEFAULT '{}' CHECK (json_valid(metadata)),
+    claimed_at         TEXT,
+    claimed_by_author  TEXT,
+    claimed_by_agent_id TEXT,
+    lease_until        TEXT,
+    created_at         TEXT NOT NULL,
+    updated_at         TEXT NOT NULL,
+    last_event_id      INTEGER NOT NULL
+);
+
+-- Dependency edges for fast availability checks (rebuildable from events)
+CREATE TABLE IF NOT EXISTS task_dependencies (
+    task_id        TEXT NOT NULL,
+    depends_on_id  TEXT NOT NULL,
+    PRIMARY KEY (task_id, depends_on_id)
+);
+
+-- Fast tag filtering (rebuildable)
+CREATE TABLE IF NOT EXISTS task_tags (
+    task_id TEXT NOT NULL,
+    tag     TEXT NOT NULL,
+    PRIMARY KEY (task_id, tag)
+);
+
+-- Fast access for steering comments (rebuildable)
+CREATE TABLE IF NOT EXISTS task_comments (
+    event_rowid INTEGER PRIMARY KEY,
+    task_id     TEXT NOT NULL,
+    author      TEXT,
+    agent_id    TEXT,
+    text        TEXT NOT NULL,
+    timestamp   TEXT NOT NULL
+);
+
+-- Fast access for checkpoints (rebuildable)
+CREATE TABLE IF NOT EXISTS task_checkpoints (
+    event_rowid INTEGER PRIMARY KEY,
+    task_id     TEXT NOT NULL,
+    name        TEXT NOT NULL,
+    data        TEXT NOT NULL DEFAULT '{}' CHECK (json_valid(data)),
+    timestamp   TEXT NOT NULL
+);
+
+-- Full-text search over tasks (rebuildable)
+CREATE VIRTUAL TABLE IF NOT EXISTS task_search USING fts5(
+    task_id UNINDEXED,
+    title,
+    description
+);
+
+-- Indexes for events
+CREATE INDEX IF NOT EXISTS idx_events_task_id ON events(task_id);
+CREATE INDEX IF NOT EXISTS idx_events_task_id_id ON events(task_id, id);
+CREATE INDEX IF NOT EXISTS idx_events_type ON events(type);
+CREATE INDEX IF NOT EXISTS idx_events_timestamp ON events(timestamp);
+CREATE INDEX IF NOT EXISTS idx_events_correlation_id ON events(correlation_id);
+
+-- Indexes for tasks_current
+CREATE INDEX IF NOT EXISTS idx_tasks_current_project_status ON tasks_current(project, status);
+CREATE INDEX IF NOT EXISTS idx_tasks_current_priority ON tasks_current(project, priority, created_at);
+CREATE INDEX IF NOT EXISTS idx_tasks_current_claim_next ON tasks_current(project, status, priority DESC, created_at ASC, task_id ASC);
+CREATE INDEX IF NOT EXISTS idx_tasks_current_stuck ON tasks_current(project, status, claimed_at);
+CREATE INDEX IF NOT EXISTS idx_tasks_current_parent ON tasks_current(parent_id);
+
+-- Indexes for dependencies
+CREATE INDEX IF NOT EXISTS idx_deps_depends_on ON task_dependencies(depends_on_id);
+
+-- Indexes for tags/comments/checkpoints
+CREATE INDEX IF NOT EXISTS idx_task_tags_tag ON task_tags(tag, task_id);
+CREATE INDEX IF NOT EXISTS idx_task_comments_task ON task_comments(task_id, event_rowid);
+CREATE INDEX IF NOT EXISTS idx_task_checkpoints_task ON task_checkpoints(task_id, event_rowid);
+`;
+export const PRAGMAS = `
+PRAGMA journal_mode=WAL;
+PRAGMA synchronous=NORMAL;
+PRAGMA foreign_keys=ON;
+PRAGMA busy_timeout=5000;
+`;
+//# sourceMappingURL=schema.js.map

package/dist/db/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0GxB,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG;;;;;CAKtB,CAAC"}

package/dist/events/store.d.ts

@@ -0,0 +1,33 @@
+import type Database from 'better-sqlite3';
+import { EventEnvelope, EventType } from './types.js';
+export interface AppendEventInput {
+    event_id?: string;
+    task_id: string;
+    type: EventType;
+    data: Record<string, unknown>;
+    author?: string;
+    agent_id?: string;
+    session_id?: string;
+    correlation_id?: string;
+    causation_id?: string;
+}
+export interface PersistedEventEnvelope extends EventEnvelope {
+    rowid: number;
+}
+export interface GetByTaskIdOptions {
+    afterId?: number;
+    limit?: number;
+}
+export declare class EventStore {
+    private db;
+    private insertReturningStmt;
+    private insertIgnoreStmt;
+    private selectByTaskStmt;
+    private selectByEventIdStmt;
+    constructor(db: Database.Database);
+    append(input: AppendEventInput): PersistedEventEnvelope;
+    appendIdempotent(input: AppendEventInput): PersistedEventEnvelope | null;
+    getByTaskId(taskId: string, opts?: GetByTaskIdOptions): PersistedEventEnvelope[];
+    private rowToEnvelope;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/events/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/events/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,SAAS,EAAqB,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IAC3D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,UAAU;IAMT,OAAO,CAAC,EAAE;IALtB,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,mBAAmB,CAAqB;gBAE5B,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAyBzC,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,sBAAsB;IA+BvD,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,sBAAsB,GAAG,IAAI;IA0BxE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,sBAAsB,EAAE;IAShF,OAAO,CAAC,aAAa;CAetB"}

package/dist/events/store.js

@@ -0,0 +1,81 @@
+import { generateId } from '../utils/id.js';
+import { validateEventData } from './types.js';
+export class EventStore {
+    db;
+    insertReturningStmt;
+    insertIgnoreStmt;
+    selectByTaskStmt;
+    selectByEventIdStmt;
+    constructor(db) {
+        this.db = db;
+        // Use RETURNING to get canonical DB timestamp and rowid
+        this.insertReturningStmt = db.prepare(`
+      INSERT INTO events (event_id, task_id, type, data, author, agent_id, session_id, correlation_id, causation_id)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+      RETURNING id, timestamp
+    `);
+        this.insertIgnoreStmt = db.prepare(`
+      INSERT OR IGNORE INTO events (event_id, task_id, type, data, author, agent_id, session_id, correlation_id, causation_id)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        this.selectByTaskStmt = db.prepare(`
+      SELECT * FROM events
+      WHERE task_id = ? AND id > COALESCE(?, 0)
+      ORDER BY id ASC
+      LIMIT COALESCE(?, 1000)
+    `);
+        this.selectByEventIdStmt = db.prepare(`
+      SELECT * FROM events WHERE event_id = ?
+    `);
+    }
+    append(input) {
+        validateEventData(input.type, input.data);
+        const eventId = input.event_id ?? generateId();
+        const row = this.insertReturningStmt.get(eventId, input.task_id, input.type, JSON.stringify(input.data), input.author ?? null, input.agent_id ?? null, input.session_id ?? null, input.correlation_id ?? null, input.causation_id ?? null);
+        return {
+            rowid: row.id,
+            event_id: eventId,
+            task_id: input.task_id,
+            type: input.type,
+            data: input.data,
+            author: input.author,
+            agent_id: input.agent_id,
+            session_id: input.session_id,
+            correlation_id: input.correlation_id,
+            causation_id: input.causation_id,
+            timestamp: row.timestamp,
+        };
+    }
+    appendIdempotent(input) {
+        validateEventData(input.type, input.data);
+        const eventId = input.event_id ?? generateId();
+        const result = this.insertIgnoreStmt.run(eventId, input.task_id, input.type, JSON.stringify(input.data), input.author ?? null, input.agent_id ?? null, input.session_id ?? null, input.correlation_id ?? null, input.causation_id ?? null);
+        // If no rows changed, the event_id already existed
+        if (result.changes === 0) {
+            return null;
+        }
+        // Fetch the inserted row to get canonical timestamp
+        const row = this.selectByEventIdStmt.get(eventId);
+        return this.rowToEnvelope(row);
+    }
+    getByTaskId(taskId, opts) {
+        const rows = this.selectByTaskStmt.all(taskId, opts?.afterId ?? null, opts?.limit ?? null);
+        return rows.map(row => this.rowToEnvelope(row));
+    }
+    rowToEnvelope(row) {
+        return {
+            rowid: row.id,
+            event_id: row.event_id,
+            task_id: row.task_id,
+            type: row.type,
+            data: JSON.parse(row.data),
+            author: row.author ?? undefined,
+            agent_id: row.agent_id ?? undefined,
+            session_id: row.session_id ?? undefined,
+            correlation_id: row.correlation_id ?? undefined,
+            causation_id: row.causation_id ?? undefined,
+            timestamp: row.timestamp,
+        };
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/events/store.js.map

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

package/dist/events/store.test.d.ts

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

package/dist/events/store.test.d.ts.map

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