syncpoint-ai 0.1.0

package/dist/server/db-migrations.js

@@ -0,0 +1,246 @@
+/**
+ * Database migration functions extracted from db.ts.
+ *
+ * Each function is idempotent — safe to call on an already-migrated database.
+ * All functions are called by runMigrations() in db.ts.
+ */
+import fs from "node:fs";
+import { InternalError } from "../kernel/index.js";
+import * as schema from "./schema.js";
+// ── Helpers ──────────────────────────────────────────
+function hasTable(db, tableName) {
+    return Boolean(db.prepare("SELECT name FROM sqlite_master WHERE type = 'table' AND name = ?").get(tableName));
+}
+function hasColumn(db, tableName, columnName) {
+    if (!hasTable(db, tableName))
+        return false;
+    const columns = db.prepare(`PRAGMA table_info(${tableName})`).all();
+    return columns.some(column => column.name === columnName);
+}
+function hasIndex(db, indexName) {
+    return Boolean(db.prepare("SELECT name FROM sqlite_master WHERE type = 'index' AND name = ?").get(indexName));
+}
+// ── Migration functions ──────────────────────────────
+/**
+ * Purpose: Normalizes the legacy `peer_contract` table by splitting its JSON
+ * `participants` column into dedicated child tables (participant, responsibility,
+ * interface_spec, resource_boundary, dependency).
+ *
+ * Idempotency: Skips if the `participants` column no longer exists.
+ */
+export function runPeerContractNormalizationMigration(db, sqlPath) {
+    if (!hasColumn(db, "peer_contract", "participants"))
+        return;
+    const childTables = [
+        "peer_contract_participant",
+        "peer_contract_responsibility",
+        "peer_contract_interface_spec",
+        "peer_contract_resource_boundary",
+        "peer_contract_dependency",
+    ];
+    const partiallyExistingChildTables = childTables.filter(tableName => hasTable(db, tableName));
+    if (partiallyExistingChildTables.length > 0) {
+        throw new InternalError(`peer_contract normalization encountered partial child tables: ${partiallyExistingChildTables.join(", ")}`);
+    }
+    if (!fs.existsSync(sqlPath)) {
+        throw new InternalError("Missing peer_contract normalization migration SQL.");
+    }
+    db.exec(fs.readFileSync(sqlPath, "utf-8"));
+}
+/**
+ * Purpose: Creates indexes on foreign key columns across join tables
+ * (resource_claim_resource, sync_gate_resource, operation_resource,
+ * write_permit_resource) to accelerate FK-based lookups.
+ *
+ * Idempotency: Checks for each index before creation.
+ */
+export function runFkIndexesMigration(db) {
+    const fkIndexes = [
+        { table: "resource_claim_resource", index: "idx_rcr_claim", column: "claim_id" },
+        { table: "sync_gate_resource", index: "idx_sgr_gate", column: "gate_id" },
+        { table: "sync_gate_related_claim", index: "idx_sgrc_gate", column: "gate_id" },
+        { table: "operation_resource", index: "idx_opr_op", column: "operation_id" },
+        { table: "write_permit_resource", index: "idx_wpr_permit", column: "permit_id" },
+    ];
+    for (const { table, index, column } of fkIndexes) {
+        if (hasTable(db, table) && !hasIndex(db, index)) {
+            db.exec(`CREATE INDEX \`${index}\` ON \`${table}\` (\`${column}\`);`);
+        }
+    }
+}
+/**
+ * Purpose: Creates the `agent_registry_entry` table from an external SQL file
+ * and ensures its unique index on `agent_id` exists. Supports the agent
+ * registration and discovery subsystem.
+ *
+ * Idempotency: Skips table creation if it already exists; adds index if missing.
+ */
+export function runAgentRegistryEntryMigration(db, sqlPath) {
+    if (!hasTable(db, "agent_registry_entry")) {
+        if (!fs.existsSync(sqlPath)) {
+            throw new InternalError("Missing agent_registry_entry migration SQL.");
+        }
+        db.exec(fs.readFileSync(sqlPath, "utf-8"));
+        return;
+    }
+    if (!hasIndex(db, "uq_agent_registry_entry_agent")) {
+        db.exec("CREATE UNIQUE INDEX IF NOT EXISTS `uq_agent_registry_entry_agent` ON `agent_registry_entry` (`agent_id`);");
+    }
+}
+/**
+ * Purpose: Creates composite indexes on frequently queried columns across
+ * core tables (resource_claim, sync_gate, checkpoint, checkpoint_review, event)
+ * to accelerate common query paths: by actor+status, session, task, and time ranges.
+ *
+ * Idempotency: Checks for each index before creation.
+ */
+export function runQueryPathIndexesMigration(db) {
+    const queryIndexes = [
+        { table: "resource_claim", index: "idx_claims_actor_status", columns: "actor_id, status" },
+        { table: "resource_claim", index: "idx_claims_session", columns: "session_id" },
+        { table: "resource_claim", index: "idx_claims_task", columns: "task_id" },
+        { table: "sync_gate", index: "idx_gates_status_created", columns: "status, created_at" },
+        { table: "sync_gate", index: "idx_gates_task", columns: "task_id" },
+        { table: "checkpoint", index: "idx_checkpoints_task_created", columns: "task_id, created_at" },
+        { table: "checkpoint_review", index: "idx_reviews_task_created", columns: "task_id, created_at" },
+        { table: "checkpoint_review", index: "idx_reviews_status", columns: "status" },
+        { table: "checkpoint_review", index: "idx_reviews_req_agent", columns: "requesting_agent_id" },
+        { table: "event", index: "idx_events_entity", columns: "entity_type, entity_id" },
+        { table: "event", index: "idx_events_type", columns: "event_type" },
+        { table: "event", index: "idx_events_created", columns: "created_at" },
+    ];
+    for (const { table, index, columns } of queryIndexes) {
+        if (hasTable(db, table) && !hasIndex(db, index)) {
+            db.exec(`CREATE INDEX \`${index}\` ON \`${table}\` (${columns});`);
+        }
+    }
+}
+/**
+ * Purpose: Creates the `agent_message` table from an external SQL file.
+ * Stores inter-agent messages for the collaboration protocol.
+ *
+ * Idempotency: Skips if the table already exists.
+ */
+export function runAgentMessageMigration(db, sqlPath) {
+    if (hasTable(db, "agent_message"))
+        return;
+    if (!fs.existsSync(sqlPath)) {
+        throw new InternalError("Missing agent_message migration SQL.");
+    }
+    db.exec(fs.readFileSync(sqlPath, "utf-8"));
+}
+/**
+ * Purpose: Creates the `state_transition_log` table with indexes on entity,
+ * agent, and timestamp columns. Provides an audit trail for all entity state
+ * transitions in the system.
+ *
+ * Idempotency: Skips if the table already exists.
+ */
+export function runStateTransitionLogMigration(db) {
+    if (hasTable(db, "state_transition_log"))
+        return;
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS state_transition_log (
+      id TEXT PRIMARY KEY,
+      entity_type TEXT NOT NULL,
+      entity_id TEXT NOT NULL,
+      from_state TEXT NOT NULL,
+      to_state TEXT NOT NULL,
+      operation TEXT NOT NULL,
+      agent_id TEXT NOT NULL,
+      payload_json TEXT NOT NULL DEFAULT '{}',
+      created_at TEXT NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_stlog_entity ON state_transition_log (entity_type, entity_id);
+    CREATE INDEX IF NOT EXISTS idx_stlog_agent ON state_transition_log (agent_id);
+    CREATE INDEX IF NOT EXISTS idx_stlog_created ON state_transition_log (created_at);
+  `);
+}
+/**
+ * Purpose: Adds `scope`, `function_name`, `line_start`, and `line_end` columns
+ * to all resource join tables. Enables fine-grained resource scoping beyond
+ * file-level (e.g., function-level, line-range).
+ *
+ * Idempotency: Checks each column before adding; skips missing tables.
+ */
+export function runResourceScopeMigration(db) {
+    const tables = [
+        { table: "resource_claim_resource" },
+        { table: "sync_gate_resource" },
+        { table: "operation_resource" },
+        { table: "write_permit_resource" },
+        { table: "context_snapshot_resource" },
+    ];
+    for (const { table } of tables) {
+        if (!hasTable(db, table))
+            continue;
+        const columns = db.prepare(`PRAGMA table_info(${table})`).all().map(c => c.name);
+        if (!columns.includes("scope")) {
+            db.exec(`ALTER TABLE \`${table}\` ADD COLUMN \`scope\` text NOT NULL DEFAULT 'file';`);
+        }
+        if (!columns.includes("function_name")) {
+            db.exec(`ALTER TABLE \`${table}\` ADD COLUMN \`function_name\` text;`);
+        }
+        if (!columns.includes("line_start")) {
+            db.exec(`ALTER TABLE \`${table}\` ADD COLUMN \`line_start\` integer;`);
+        }
+        if (!columns.includes("line_end")) {
+            db.exec(`ALTER TABLE \`${table}\` ADD COLUMN \`line_end\` integer;`);
+        }
+    }
+}
+/**
+ * Purpose: Adds incremental snapshot support columns (`version`, `content_hash`,
+ * `is_delta`, `base_snapshot_id`) to the `context_snapshot` table. Enables
+ * delta-based snapshots that reference a base snapshot instead of storing full
+ * copies every time.
+ *
+ * Idempotency: Checks each column before adding; skips if table is missing.
+ */
+export function runContextSnapshotIncrementalMigration(db) {
+    if (!hasTable(db, "context_snapshot"))
+        return;
+    const columns = db.prepare("PRAGMA table_info(context_snapshot)").all().map(c => c.name);
+    if (!columns.includes("version")) {
+        db.exec(`ALTER TABLE context_snapshot ADD COLUMN version integer NOT NULL DEFAULT 1;`);
+    }
+    if (!columns.includes("content_hash")) {
+        db.exec(`ALTER TABLE context_snapshot ADD COLUMN content_hash text NOT NULL DEFAULT '';`);
+    }
+    if (!columns.includes("is_delta")) {
+        db.exec(`ALTER TABLE context_snapshot ADD COLUMN is_delta integer NOT NULL DEFAULT 0;`);
+    }
+    if (!columns.includes("base_snapshot_id")) {
+        db.exec(`ALTER TABLE context_snapshot ADD COLUMN base_snapshot_id text NOT NULL DEFAULT '';`);
+    }
+}
+/**
+ * Purpose: Adds a monotonically increasing `seq` column and index to the `event`
+ * table. Enables ordered event replay and catch-up subscriptions by sequence number.
+ *
+ * Idempotency: Checks for column before adding; skips if table is missing.
+ */
+export function runEventSeqMigration(db) {
+    if (!hasTable(db, "event"))
+        return;
+    const columns = db.prepare("PRAGMA table_info(event)").all().map(c => c.name);
+    if (!columns.includes("seq")) {
+        db.exec(`ALTER TABLE event ADD COLUMN seq integer NOT NULL DEFAULT 0;`);
+        db.exec(`CREATE INDEX IF NOT EXISTS idx_events_seq ON event (seq);`);
+    }
+}
+/**
+ * Purpose: Creates runtime-only tables: `memory_version` (optimistic concurrency
+ * control for project memory) and the FTS5 full-text search index.
+ */
+export function ensureRuntimeOnlyTables(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS memory_version (
+      id      INTEGER PRIMARY KEY CHECK (id = 1),
+      version INTEGER NOT NULL DEFAULT 0
+    );
+    INSERT OR IGNORE INTO memory_version (id, version) VALUES (1, 0);
+  `);
+    db.exec(schema.PROJECT_MEMORY_FTS_SQL);
+}
+//# sourceMappingURL=db-migrations.js.map

package/dist/server/db-migrations.js.map

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

package/dist/server/db.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Database connection and Drizzle ORM setup for SyncPoint.
+ *
+ * Use `defaultContext` for the standard project database,
+ * or `createDatabaseContext()` / `createTestDatabaseContext()` for custom setups.
+ */
+import Database from "better-sqlite3";
+import { drizzle } from "drizzle-orm/better-sqlite3";
+import * as schema from "./schema.js";
+export declare const SYNCPOINT_DIR_NAME = ".syncpoint";
+export declare function findProjectSyncpointDir(from?: string): string | null;
+export declare function isProjectLocal(): boolean;
+export declare function getSyncpointDir(): string;
+export declare function getDbPath(): string;
+export type SyncPointDb = ReturnType<typeof drizzle<typeof schema>>;
+export interface DatabaseContextOptions {
+    dbPath?: string;
+    skipWal?: boolean;
+    /** Pre-existing Database handle. When set, no connection, pragmas,
+     *  or migrations are applied — the caller owns the lifecycle. */
+    sqlite?: Database.Database;
+}
+export declare class DatabaseContext {
+    private _sqlite;
+    private _db;
+    private _walEnabled;
+    private _dbPath;
+    private _skipWal;
+    private _externalSqlite;
+    constructor(opts?: DatabaseContextOptions);
+    get db(): SyncPointDb;
+    get raw(): Database.Database;
+    get dbPath(): string;
+    get walEnabled(): boolean;
+    destroy(): void;
+    checkIntegrity(): {
+        ok: boolean;
+        details: string;
+    };
+    backup(destPath: string): {
+        ok: boolean;
+        error?: string;
+    };
+    getWalSize(): number | null;
+    private _applyPragmas;
+    private _runMigrations;
+}
+export declare function createDatabaseContext(opts?: DatabaseContextOptions): DatabaseContext;
+export declare function createTestDatabaseContext(): DatabaseContext;
+/** Default project database context. Created lazily on first access. */
+export declare const defaultContext: DatabaseContext;
+export declare function initSyncpointDir(baseDir?: string): string;
+/** Run migrations on a raw Database handle (for tests that bypass DatabaseContext). */
+export declare function runMigrations(db: Database.Database): void;
+//# sourceMappingURL=db.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../_build/src/server/db.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAOrD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AActC,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAyB/C,wBAAgB,uBAAuB,CAAC,IAAI,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAiBnF;AAED,wBAAgB,cAAc,IAAI,OAAO,CAGxC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAKxC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAalC;AA4BD,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC;AAEpE,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;qEACiE;IACjE,MAAM,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC;CAC5B;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,GAAG,CAA4B;IACvC,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,eAAe,CAAU;gBAErB,IAAI,GAAE,sBAA2B;IAa7C,IAAI,EAAE,IAAI,WAAW,CAOpB;IAED,IAAI,GAAG,IAAI,QAAQ,CAAC,QAAQ,CAG3B;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,OAAO,IAAI,IAAI;IAWf,cAAc,IAAI;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAgBlD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAoBzD,UAAU,IAAI,MAAM,GAAG,IAAI;IAW3B,OAAO,CAAC,aAAa;IA4BrB,OAAO,CAAC,cAAc;CAevB;AAID,wBAAgB,qBAAqB,CAAC,IAAI,CAAC,EAAE,sBAAsB,GAAG,eAAe,CAEpF;AAED,wBAAgB,yBAAyB,IAAI,eAAe,CAE3D;AAED,wEAAwE;AACxE,eAAO,MAAM,cAAc,iBAAwB,CAAC;AAIpD,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,MAAsB,GAAG,MAAM,CAQxE;AAED,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAazD"}

package/dist/server/db.js

@@ -0,0 +1,265 @@
+/**
+ * Database connection and Drizzle ORM setup for SyncPoint.
+ *
+ * Use `defaultContext` for the standard project database,
+ * or `createDatabaseContext()` / `createTestDatabaseContext()` for custom setups.
+ */
+import Database from "better-sqlite3";
+import { drizzle } from "drizzle-orm/better-sqlite3";
+import { migrate } from "drizzle-orm/better-sqlite3/migrator";
+import path from "node:path";
+import os from "node:os";
+import fs from "node:fs";
+import { fileURLToPath } from "node:url";
+import { InternalError } from "../kernel/index.js";
+import * as schema from "./schema.js";
+import { runPeerContractNormalizationMigration, runAgentRegistryEntryMigration, runAgentMessageMigration, runFkIndexesMigration, runQueryPathIndexesMigration, runStateTransitionLogMigration, runResourceScopeMigration, runContextSnapshotIncrementalMigration, runEventSeqMigration, ensureRuntimeOnlyTables, } from "./db-migrations.js";
+export const SYNCPOINT_DIR_NAME = ".syncpoint";
+const DEFAULT_DB_NAME = "syncpoint.db";
+// ── Path helpers ──────────────────────────────────────
+const DRIZZLE_MIGRATIONS_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../drizzle");
+const PEER_CONTRACT_NORMALIZATION_SQL_PATH = path.join(DRIZZLE_MIGRATIONS_DIR, "0001_peer_contract_normalization.sql");
+const AGENT_REGISTRY_ENTRY_SQL_PATH = path.join(DRIZZLE_MIGRATIONS_DIR, "0002_agent_registry_entry.sql");
+const AGENT_MESSAGE_SQL_PATH = path.join(DRIZZLE_MIGRATIONS_DIR, "0004_agent_message.sql");
+export function findProjectSyncpointDir(from = process.cwd()) {
+    let dir = path.resolve(from);
+    const { root } = path.parse(dir);
+    const fallbackDir = path.resolve(os.homedir(), SYNCPOINT_DIR_NAME);
+    while (true) {
+        const candidate = path.join(dir, SYNCPOINT_DIR_NAME);
+        if (path.resolve(candidate) !== fallbackDir &&
+            fs.existsSync(candidate) &&
+            fs.statSync(candidate).isDirectory()) {
+            return candidate;
+        }
+        if (dir === root)
+            break;
+        dir = path.dirname(dir);
+    }
+    return null;
+}
+export function isProjectLocal() {
+    if (process.env.SYNCPOINT_DB_DIR)
+        return true;
+    return findProjectSyncpointDir() !== null;
+}
+export function getSyncpointDir() {
+    if (process.env.SYNCPOINT_DB_DIR)
+        return process.env.SYNCPOINT_DB_DIR;
+    const projectDir = findProjectSyncpointDir();
+    if (projectDir)
+        return projectDir;
+    return path.join(os.homedir(), SYNCPOINT_DIR_NAME);
+}
+export function getDbPath() {
+    if (process.env.SYNCPOINT_DB_DIR) {
+        const dir = process.env.SYNCPOINT_DB_DIR;
+        fs.mkdirSync(dir, { recursive: true });
+        return path.join(dir, DEFAULT_DB_NAME);
+    }
+    const projectDir = findProjectSyncpointDir();
+    if (projectDir) {
+        return path.join(projectDir, DEFAULT_DB_NAME);
+    }
+    const fallback = path.join(os.homedir(), SYNCPOINT_DIR_NAME);
+    fs.mkdirSync(fallback, { recursive: true });
+    return path.join(fallback, DEFAULT_DB_NAME);
+}
+function detectNetworkFilesystem(dbPath) {
+    const networkPrefixes = [
+        "/mnt/", "/media/", "/Volumes/",
+        "/net/", "/nfs/", "/smb/", "/cifs/",
+    ];
+    if (process.platform === "win32") {
+        if (dbPath.startsWith("\\\\"))
+            return true;
+        const cloudSyncPatterns = [
+            "OneDrive", "Dropbox", "Google Drive", "Box", "iCloudDrive",
+        ];
+        if (cloudSyncPatterns.some(p => dbPath.includes(p)))
+            return true;
+    }
+    if (networkPrefixes.some(p => dbPath.startsWith(p)))
+        return true;
+    return false;
+}
+function ensureDrizzleMigrationAssets() {
+    if (!fs.existsSync(DRIZZLE_MIGRATIONS_DIR)) {
+        throw new InternalError("Drizzle migrations not found. Run `pnpm --filter syncpoint-server db:generate` first.");
+    }
+}
+export class DatabaseContext {
+    _sqlite = null;
+    _db = null;
+    _walEnabled = null;
+    _dbPath;
+    _skipWal;
+    _externalSqlite;
+    constructor(opts = {}) {
+        this._dbPath = opts.dbPath ?? getDbPath();
+        this._skipWal = opts.skipWal ?? false;
+        if (opts.sqlite) {
+            this._sqlite = opts.sqlite;
+            this._externalSqlite = true;
+            // Build the drizzle wrapper immediately — caller manages lifecycle
+            this._db = drizzle(this._sqlite, { schema });
+        }
+        else {
+            this._externalSqlite = false;
+        }
+    }
+    get db() {
+        if (this._db)
+            return this._db;
+        this._sqlite = new Database(this._dbPath);
+        this._applyPragmas();
+        this._db = drizzle(this._sqlite, { schema });
+        this._runMigrations();
+        return this._db;
+    }
+    get raw() {
+        this.db;
+        return this._sqlite;
+    }
+    get dbPath() {
+        return this._dbPath;
+    }
+    get walEnabled() {
+        return this._walEnabled === true;
+    }
+    destroy() {
+        if (this._sqlite) {
+            if (!this._externalSqlite) {
+                this._sqlite.close();
+            }
+            this._sqlite = null;
+            this._db = null;
+            this._walEnabled = null;
+        }
+    }
+    checkIntegrity() {
+        if (!this._sqlite) {
+            return { ok: false, details: "Database not initialized" };
+        }
+        try {
+            const result = this._sqlite.pragma("integrity_check", { simple: true });
+            const ok = result === "ok";
+            return { ok, details: ok ? "ok" : String(result) };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                details: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+    backup(destPath) {
+        if (!this._sqlite) {
+            return { ok: false, error: "Database not initialized" };
+        }
+        try {
+            const resolved = path.resolve(destPath);
+            const destDir = path.dirname(resolved);
+            if (!fs.existsSync(destDir)) {
+                fs.mkdirSync(destDir, { recursive: true });
+            }
+            this._sqlite.exec(`VACUUM INTO '${resolved.replace(/'/g, "''")}'`);
+            return { ok: true };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+    getWalSize() {
+        if (!this._sqlite || !this._walEnabled)
+            return null;
+        try {
+            const walPath = this._dbPath + "-wal";
+            const stat = fs.statSync(walPath);
+            return stat.size;
+        }
+        catch {
+            return null;
+        }
+    }
+    _applyPragmas() {
+        const db = this._sqlite;
+        db.pragma("foreign_keys = ON");
+        if (this._skipWal || detectNetworkFilesystem(this._dbPath)) {
+            this._walEnabled = false;
+            return;
+        }
+        try {
+            db.pragma("journal_mode = WAL");
+            const currentMode = db.pragma("journal_mode", { simple: true });
+            if (currentMode === "wal") {
+                this._walEnabled = true;
+                db.pragma("synchronous = NORMAL");
+                db.pragma("wal_autocheckpoint = 1000");
+                db.pragma("busy_timeout = 5000");
+                db.pragma("mmap_size = 268435456");
+                db.pragma("temp_store = MEMORY");
+                db.pragma("cache_size = -64000");
+            }
+            else {
+                this._walEnabled = false;
+            }
+        }
+        catch {
+            this._walEnabled = false;
+        }
+    }
+    _runMigrations() {
+        const db = this._sqlite;
+        ensureDrizzleMigrationAssets();
+        migrate(drizzle(db, { schema }), { migrationsFolder: DRIZZLE_MIGRATIONS_DIR });
+        runPeerContractNormalizationMigration(db, PEER_CONTRACT_NORMALIZATION_SQL_PATH);
+        runAgentRegistryEntryMigration(db, AGENT_REGISTRY_ENTRY_SQL_PATH);
+        runAgentMessageMigration(db, AGENT_MESSAGE_SQL_PATH);
+        runFkIndexesMigration(db);
+        runQueryPathIndexesMigration(db);
+        runStateTransitionLogMigration(db);
+        runResourceScopeMigration(db);
+        runContextSnapshotIncrementalMigration(db);
+        runEventSeqMigration(db);
+        ensureRuntimeOnlyTables(db);
+    }
+}
+// ── Factory functions ─────────────────────────────────
+export function createDatabaseContext(opts) {
+    return new DatabaseContext(opts);
+}
+export function createTestDatabaseContext() {
+    return new DatabaseContext({ dbPath: ":memory:", skipWal: true });
+}
+/** Default project database context. Created lazily on first access. */
+export const defaultContext = new DatabaseContext();
+// ── Utilities ─────────────────────────────────────────
+export function initSyncpointDir(baseDir = process.cwd()) {
+    const dir = path.join(path.resolve(baseDir), SYNCPOINT_DIR_NAME);
+    fs.mkdirSync(dir, { recursive: true });
+    const dbPath = path.join(dir, DEFAULT_DB_NAME);
+    const ctx = new DatabaseContext({ dbPath });
+    ctx.db;
+    ctx.destroy();
+    return dir;
+}
+/** Run migrations on a raw Database handle (for tests that bypass DatabaseContext). */
+export function runMigrations(db) {
+    ensureDrizzleMigrationAssets();
+    migrate(drizzle(db, { schema }), { migrationsFolder: DRIZZLE_MIGRATIONS_DIR });
+    runPeerContractNormalizationMigration(db, PEER_CONTRACT_NORMALIZATION_SQL_PATH);
+    runAgentRegistryEntryMigration(db, AGENT_REGISTRY_ENTRY_SQL_PATH);
+    runAgentMessageMigration(db, AGENT_MESSAGE_SQL_PATH);
+    runFkIndexesMigration(db);
+    runQueryPathIndexesMigration(db);
+    runStateTransitionLogMigration(db);
+    runResourceScopeMigration(db);
+    runContextSnapshotIncrementalMigration(db);
+    runEventSeqMigration(db);
+    ensureRuntimeOnlyTables(db);
+}
+//# sourceMappingURL=db.js.map

package/dist/server/db.js.map

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

package/dist/server/event-bus.d.ts

@@ -0,0 +1,65 @@
+/**
+ * SyncPoint internal event bus using Node EventEmitter.
+ * Used to push real-time events to SSE clients.
+ *
+ * Features:
+ *   - Monotonically increasing event sequence numbers
+ *   - Heartbeat detection
+ *   - SSE connection management
+ *   - Last-Event-Seq support for reconnection replay
+ *   - Event ring buffer for replay after reconnect
+ *   - Prometheus-compatible metrics
+ */
+import { EventEmitter } from "node:events";
+export interface SyncPointEventData {
+    /** Monotonically increasing sequence number. Clients track this for replay. */
+    seq: number;
+    eventType: string;
+    entityType: string;
+    entityId: string;
+    detail?: string;
+    timestamp: string;
+}
+/** SSE connection metrics snapshot. */
+export interface SseMetrics {
+    activeConnections: number;
+    totalConnections: number;
+    eventsPushed: number;
+    reconnects: number;
+    reconnectReplays: number;
+}
+declare class SyncPointEventBus extends EventEmitter {
+    private _seq;
+    private _ring;
+    private _metrics;
+    constructor();
+    /** Emit an event with an auto-incremented sequence number. */
+    emitEvent(eventType: string, entityType: string, entityId: string, detail?: string): void;
+    /** Current sequence number (for Last-Event-Seq handshake). */
+    get currentSeq(): number;
+    /** Reset sequence counter (for testing). */
+    resetSequence(): void;
+    /**
+     * Recover sequence counter from persisted state (e.g. after server restart).
+     * Sets _seq to the given value so subsequent events continue from there.
+     */
+    recoverSeq(maxSeq: number): void;
+    /**
+     * Replay events after a given sequence number.
+     * Returns events with seq > lastSeq from the ring buffer.
+     */
+    replayAfter(lastSeq: number): SyncPointEventData[];
+    /** Increment active connection count. */
+    connectionOpened(): void;
+    /** Decrement active connection count. */
+    connectionClosed(): void;
+    /** Increment reconnect counter. */
+    reconnectDetected(): void;
+    /** Get current metrics snapshot. */
+    getMetrics(): SseMetrics;
+    /** Reset metrics (for testing). */
+    resetMetrics(): void;
+}
+export declare function createEventBus(): SyncPointEventBus;
+export { SyncPointEventBus };
+//# sourceMappingURL=event-bus.d.ts.map