context-gatekeeper 0.3.0

package/dist/schema/project.js

@@ -0,0 +1,68 @@
+import { v4 as uuidv4 } from 'uuid';
+import { query, run } from '../utils/db.js';
+import { DatabaseError, ProjectNotFoundError } from '../utils/errors.js';
+function rowToProject(row) {
+    return {
+        id: row.id,
+        name: row.name,
+        rootPath: row.root_path,
+        createdAt: new Date(row.created_at)
+    };
+}
+export function createProject(input) {
+    const id = uuidv4();
+    const now = new Date().toISOString();
+    try {
+        run(`
+      INSERT INTO projects (id, name, root_path, created_at)
+      VALUES (?, ?, ?, ?)
+    `, [id, input.name, input.rootPath || null, now]);
+        return getProject(id);
+    }
+    catch (error) {
+        throw new DatabaseError('Failed to create project', error);
+    }
+}
+export function getProject(id) {
+    try {
+        const results = query('SELECT * FROM projects WHERE id = ?', [id]);
+        return results.length > 0 ? rowToProject(results[0]) : null;
+    }
+    catch (error) {
+        throw new DatabaseError('Failed to get project', error);
+    }
+}
+export function getProjectOrThrow(id) {
+    const project = getProject(id);
+    if (!project) {
+        throw new ProjectNotFoundError(id);
+    }
+    return project;
+}
+export function getProjectByName(name) {
+    try {
+        const results = query('SELECT * FROM projects WHERE name = ?', [name]);
+        return results.length > 0 ? rowToProject(results[0]) : null;
+    }
+    catch (error) {
+        throw new DatabaseError('Failed to get project by name', error);
+    }
+}
+export function listProjects() {
+    try {
+        const rows = query('SELECT * FROM projects ORDER BY created_at DESC');
+        return rows.map(rowToProject);
+    }
+    catch (error) {
+        throw new DatabaseError('Failed to list projects', error);
+    }
+}
+export function deleteProject(id) {
+    try {
+        run('DELETE FROM projects WHERE id = ?', [id]);
+    }
+    catch (error) {
+        throw new DatabaseError('Failed to delete project', error);
+    }
+}
+//# sourceMappingURL=project.js.map

package/dist/schema/project.js.map

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

package/dist/schema/schema-init.d.ts

@@ -0,0 +1,2 @@
+export declare function initSchema(): void;
+//# sourceMappingURL=schema-init.d.ts.map

package/dist/schema/schema-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-init.d.ts","sourceRoot":"","sources":["../../src/schema/schema-init.ts"],"names":[],"mappings":"AAyEA,wBAAgB,UAAU,IAAI,IAAI,CA8IjC"}

package/dist/schema/schema-init.js

@@ -0,0 +1,199 @@
+import { logger } from '../utils/logger.js';
+import { getDatabase } from '../utils/db.js';
+import { DatabaseError } from '../utils/errors.js';
+import { initFullTextSearch } from './fulltext-search.js';
+import { initMemorySessions } from './memory-session.js';
+import { initHNSWIndex } from '../services/hnsw-index.js';
+import { initKnowledgeGraph } from './knowledge-graph.js';
+import { initMemoryTiers } from '../services/memory-tiers.js';
+import { initMultiAgentSharing } from '../services/multi-agent-sharing.js';
+/**
+ * Safely add a column to a table if it doesn't exist.
+ * Returns true if column was added or already exists.
+ */
+function addColumnIfNotExists(db, table, column, definition) {
+    try {
+        // First check if table exists
+        const tableCheck = db.exec(`SELECT name FROM sqlite_master WHERE type='table' AND name='${table}'`);
+        if (tableCheck.length === 0 || tableCheck[0].values.length === 0) {
+            // Table doesn't exist yet - will be created by CREATE TABLE, no migration needed
+            return true;
+        }
+        const result = db.exec(`PRAGMA table_info(${table})`);
+        const columns = result[0]?.values?.map((row) => row[1]) || [];
+        if (!columns.includes(column)) {
+            db.run(`ALTER TABLE ${table} ADD COLUMN ${column} ${definition}`);
+        }
+        return true;
+    }
+    catch (error) {
+        // Ignore duplicate column name (column already exists)
+        if (error instanceof Error && (error.message.includes('duplicate column name') || error.message.includes('no such table'))) {
+            return true;
+        }
+        // Log other errors but don't throw - graceful degradation
+        logger.warn(`Failed to add column ${table}.${column}`, { table, column, error: error instanceof Error ? error.message : String(error) });
+        return false;
+    }
+}
+/**
+ * Migrate existing schema to add new columns for multi-agent support.
+ * Called BEFORE any CREATE INDEX statements to ensure columns exist first.
+ */
+function migrateSchema() {
+    const db = getDatabase();
+    // Migrate memories table - add new columns if they don't exist
+    const memoriesColumns = [
+        { name: 'user_id', def: "TEXT DEFAULT 'default'" },
+        { name: 'agent_id', def: "TEXT DEFAULT 'default'" },
+        { name: 'project_id', def: "TEXT DEFAULT 'default'" },
+        { name: 'parent_id', def: 'TEXT' },
+        { name: 'lineage', def: "TEXT DEFAULT '[]'" },
+    ];
+    for (const col of memoriesColumns) {
+        addColumnIfNotExists(db, 'memories', col.name, col.def);
+    }
+    // Migrate memory_sessions table - add new columns if they don't exist
+    const sessionsColumns = [
+        { name: 'user_id', def: "TEXT DEFAULT 'default'" },
+        { name: 'agent_id', def: "TEXT DEFAULT 'default'" },
+        { name: 'project_id', def: "TEXT DEFAULT 'default'" },
+    ];
+    for (const col of sessionsColumns) {
+        addColumnIfNotExists(db, 'memory_sessions', col.name, col.def);
+    }
+}
+export function initSchema() {
+    const db = getDatabase();
+    try {
+        db.run(`
+      CREATE TABLE IF NOT EXISTS memories (
+        id TEXT PRIMARY KEY,
+        user_id TEXT NOT NULL DEFAULT 'default',
+        agent_id TEXT NOT NULL DEFAULT 'default',
+        project_id TEXT NOT NULL DEFAULT 'default',
+        content TEXT NOT NULL,
+        priority TEXT NOT NULL CHECK (priority IN ('anchored', 'constraint', 'decision', 'preference', 'fact')),
+        project_tags TEXT NOT NULL DEFAULT '[]',
+        anchored INTEGER NOT NULL DEFAULT 0,
+        access_count INTEGER NOT NULL DEFAULT 0,
+        version INTEGER NOT NULL DEFAULT 1,
+        updated_by TEXT,
+        parent_id TEXT,
+        lineage TEXT NOT NULL DEFAULT '[]',
+        created_at TEXT NOT NULL DEFAULT (datetime('now')),
+        updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+        expires_at TEXT,
+        deleted INTEGER NOT NULL DEFAULT 0
+      )
+    `);
+        // Run migrations BEFORE creating indexes that depend on new columns
+        migrateSchema();
+        db.run(`CREATE INDEX IF NOT EXISTS idx_memories_priority ON memories(priority)`);
+        db.run(`CREATE INDEX IF NOT EXISTS idx_memories_anchored ON memories(anchored)`);
+        db.run(`CREATE INDEX IF NOT EXISTS idx_memories_project_tags ON memories(project_tags)`);
+        db.run(`CREATE INDEX IF NOT EXISTS idx_memories_deleted ON memories(deleted)`);
+        db.run(`CREATE INDEX IF NOT EXISTS idx_memories_user_id ON memories(user_id)`);
+        db.run(`CREATE INDEX IF NOT EXISTS idx_memories_agent_id ON memories(agent_id)`);
+        db.run(`CREATE INDEX IF NOT EXISTS idx_memories_project_id ON memories(project_id)`);
+        db.run(`CREATE INDEX IF NOT EXISTS idx_memories_user_agent_project ON memories(user_id, agent_id, project_id)`);
+        db.run(`CREATE INDEX IF NOT EXISTS idx_memories_lineage ON memories(lineage)`);
+        db.run(`CREATE INDEX IF NOT EXISTS idx_memories_parent_id ON memories(parent_id)`);
+        db.run(`
+      CREATE TABLE IF NOT EXISTS compressions (
+        id TEXT PRIMARY KEY,
+        memory_id TEXT NOT NULL,
+        operation TEXT NOT NULL CHECK (operation IN ('snapshot', 'update', 'merge', 'archive')),
+        delta TEXT NOT NULL,
+        summary TEXT NOT NULL,
+        created_at TEXT NOT NULL DEFAULT (datetime('now')),
+        FOREIGN KEY (memory_id) REFERENCES memories(id)
+      )
+    `);
+        db.run(`CREATE INDEX IF NOT EXISTS idx_compressions_memory_id ON compressions(memory_id)`);
+        db.run(`
+      CREATE TABLE IF NOT EXISTS projects (
+        id TEXT PRIMARY KEY,
+        name TEXT NOT NULL UNIQUE,
+        root_path TEXT,
+        created_at TEXT NOT NULL DEFAULT (datetime('now'))
+      )
+    `);
+        db.run(`
+      CREATE TABLE IF NOT EXISTS memory_project_tags (
+        memory_id TEXT NOT NULL,
+        tag TEXT NOT NULL,
+        PRIMARY KEY (memory_id, tag),
+        FOREIGN KEY (memory_id) REFERENCES memories(id)
+      )
+    `);
+        db.run(`
+      CREATE TABLE IF NOT EXISTS memory_embeddings (
+        memory_id TEXT PRIMARY KEY,
+        content_hash TEXT NOT NULL,
+        embedding TEXT NOT NULL,
+        embedding_model TEXT,
+        embedding_model_version TEXT,
+        embedding_dimension INTEGER,
+        created_at TEXT NOT NULL DEFAULT (datetime('now')),
+        FOREIGN KEY (memory_id) REFERENCES memories(id)
+      )
+    `);
+        db.run(`
+      CREATE TABLE IF NOT EXISTS vector_index_metadata (
+        id TEXT PRIMARY KEY,
+        name TEXT NOT NULL UNIQUE,
+        type TEXT NOT NULL CHECK (type IN ('hnsw', 'ivf', 'flat', 'custom')) DEFAULT 'hnsw',
+        dimension INTEGER NOT NULL,
+        metric TEXT NOT NULL CHECK (metric IN ('cosine', 'l2', 'ip')) DEFAULT 'cosine',
+        params TEXT NOT NULL DEFAULT '{}',
+        status TEXT NOT NULL CHECK (status IN ('building', 'ready', 'error', 'stale')) DEFAULT 'building',
+        last_rebuild_at TEXT,
+        error_message TEXT,
+        created_at TEXT NOT NULL DEFAULT (datetime('now')),
+        updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+      )
+    `);
+        db.run(`CREATE INDEX IF NOT EXISTS idx_vector_index_metadata_status ON vector_index_metadata(status)`);
+        // Initialize Full-Text Search (wrapped in try/catch for graceful degradation - FTS5 may not be available in sql.js)
+        try {
+            initFullTextSearch();
+        }
+        catch (error) {
+            logger.warn('Failed to initialize FTS5 full-text search', { error: error instanceof Error ? error.message : String(error) });
+        }
+        initMemorySessions();
+        // Initialize HNSW index (wrapped in try/catch for graceful degradation)
+        try {
+            initHNSWIndex('default');
+        }
+        catch (error) {
+            logger.warn('Failed to initialize HNSW index', { error: error instanceof Error ? error.message : String(error) });
+        }
+        // Initialize Knowledge Graph (wrapped in try/catch for graceful degradation)
+        try {
+            initKnowledgeGraph();
+        }
+        catch (error) {
+            logger.warn('Failed to initialize Knowledge Graph', { error: error instanceof Error ? error.message : String(error) });
+        }
+        // Initialize Memory Tiers (wrapped in try/catch for graceful degradation)
+        try {
+            initMemoryTiers();
+        }
+        catch (error) {
+            logger.warn('Failed to initialize Memory Tiers', { error: error instanceof Error ? error.message : String(error) });
+        }
+        // Initialize Multi-Agent Sharing (wrapped in try/catch for graceful degradation)
+        try {
+            initMultiAgentSharing();
+        }
+        catch (error) {
+            logger.warn('Failed to initialize Multi-Agent Sharing', { error: error instanceof Error ? error.message : String(error) });
+        }
+    }
+    catch (error) {
+        throw new DatabaseError('Failed to initialize schema', error);
+    }
+}
+//# sourceMappingURL=schema-init.js.map

package/dist/schema/schema-init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-init.js","sourceRoot":"","sources":["../../src/schema/schema-init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAE3E;;;GAGG;AACH,SAAS,oBAAoB,CAAC,EAAkC,EAAE,KAAa,EAAE,MAAc,EAAE,UAAkB;IACjH,IAAI,CAAC;QACH,8BAA8B;QAC9B,MAAM,UAAU,GAAG,EAAE,CAAC,IAAI,CAAC,+DAA+D,KAAK,GAAG,CAAC,CAAC;QACpG,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjE,iFAAiF;YACjF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC,qBAAqB,KAAK,GAAG,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,GAAc,EAAE,EAAE,CAAE,GAAiB,CAAC,CAAC,CAAW,CAAC,IAAI,EAAE,CAAC;QAElG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,EAAE,CAAC,GAAG,CAAC,eAAe,KAAK,eAAe,MAAM,IAAI,UAAU,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,uDAAuD;QACvD,IAAI,KAAK,YAAY,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC;YAC3H,OAAO,IAAI,CAAC;QACd,CAAC;QACD,0DAA0D;QAC1D,MAAM,CAAC,IAAI,CAAC,wBAAwB,KAAK,IAAI,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzI,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa;IACpB,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;IAEzB,+DAA+D;IAC/D,MAAM,eAAe,GAAG;QACtB,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,wBAAwB,EAAE;QAClD,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,wBAAwB,EAAE;QACnD,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,wBAAwB,EAAE;QACrD,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE;QAClC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,mBAAmB,EAAE;KAC9C,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAClC,oBAAoB,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1D,CAAC;IAED,sEAAsE;IACtE,MAAM,eAAe,GAAG;QACtB,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,wBAAwB,EAAE;QAClD,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,wBAAwB,EAAE;QACnD,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,wBAAwB,EAAE;KACtD,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAClC,oBAAoB,CAAC,EAAE,EAAE,iBAAiB,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;IAEzB,IAAI,CAAC;QACH,EAAE,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;KAoBN,CAAC,CAAC;QAEH,oEAAoE;QACpE,aAAa,EAAE,CAAC;QAEhB,EAAE,CAAC,GAAG,CAAC,wEAAwE,CAAC,CAAC;QACjF,EAAE,CAAC,GAAG,CAAC,wEAAwE,CAAC,CAAC;QACjF,EAAE,CAAC,GAAG,CAAC,gFAAgF,CAAC,CAAC;QACzF,EAAE,CAAC,GAAG,CAAC,sEAAsE,CAAC,CAAC;QAC/E,EAAE,CAAC,GAAG,CAAC,sEAAsE,CAAC,CAAC;QAC/E,EAAE,CAAC,GAAG,CAAC,wEAAwE,CAAC,CAAC;QACjF,EAAE,CAAC,GAAG,CAAC,4EAA4E,CAAC,CAAC;QACrF,EAAE,CAAC,GAAG,CAAC,uGAAuG,CAAC,CAAC;QAChH,EAAE,CAAC,GAAG,CAAC,sEAAsE,CAAC,CAAC;QAC/E,EAAE,CAAC,GAAG,CAAC,0EAA0E,CAAC,CAAC;QAEnF,EAAE,CAAC,GAAG,CAAC;;;;;;;;;;KAUN,CAAC,CAAC;QAEH,EAAE,CAAC,GAAG,CAAC,kFAAkF,CAAC,CAAC;QAE3F,EAAE,CAAC,GAAG,CAAC;;;;;;;KAON,CAAC,CAAC;QAEH,EAAE,CAAC,GAAG,CAAC;;;;;;;KAON,CAAC,CAAC;QAEH,EAAE,CAAC,GAAG,CAAC;;;;;;;;;;;KAWN,CAAC,CAAC;QAEH,EAAE,CAAC,GAAG,CAAC;;;;;;;;;;;;;;KAcN,CAAC,CAAC;QAEH,EAAE,CAAC,GAAG,CAAC,8FAA8F,CAAC,CAAC;QAEvG,oHAAoH;QACpH,IAAI,CAAC;YACH,kBAAkB,EAAE,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,4CAA4C,EAAE,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/H,CAAC;QACD,kBAAkB,EAAE,CAAC;QAErB,wEAAwE;QACxE,IAAI,CAAC;YACH,aAAa,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpH,CAAC;QAED,6EAA6E;QAC7E,IAAI,CAAC;YACH,kBAAkB,EAAE,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,sCAAsC,EAAE,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzH,CAAC;QAED,0EAA0E;QAC1E,IAAI,CAAC;YACH,eAAe,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtH,CAAC;QAED,iFAAiF;QACjF,IAAI,CAAC;YACH,qBAAqB,EAAE,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC7H,CAAC;IAEH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,aAAa,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;IAChE,CAAC;AACH,CAAC"}

package/dist/schema/vector-index.d.ts

@@ -0,0 +1,28 @@
+export interface VectorIndexRecord {
+    id: string;
+    name: string;
+    type: string;
+    dimension: number;
+    metric: string;
+    params: Record<string, unknown>;
+    status: string;
+    lastRebuildAt: string | null;
+    errorMessage: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export declare function registerVectorIndex(record: {
+    id: string;
+    name: string;
+    dimension: number;
+    type?: string;
+    metric?: string;
+    params?: Record<string, unknown>;
+}): VectorIndexRecord;
+export declare function getVectorIndex(id: string): VectorIndexRecord | null;
+export declare function getVectorIndexByName(name: string): VectorIndexRecord | null;
+export declare function listVectorIndexes(): VectorIndexRecord[];
+export declare function updateVectorIndexStatus(id: string, status: VectorIndexRecord['status'], errorMessage?: string): void;
+export declare function removeVectorIndex(id: string): void;
+export declare function ensureVectorIndexMetadata(name: string, dimension: number): VectorIndexRecord;
+//# sourceMappingURL=vector-index.d.ts.map

package/dist/schema/vector-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-index.d.ts","sourceRoot":"","sources":["../../src/schema/vector-index.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,GAAG,iBAAiB,CAwDpB;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAqBnE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAqB3E;AAED,wBAAgB,iBAAiB,IAAI,iBAAiB,EAAE,CAoBvD;AAED,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAsBpH;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAWlD;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB,CA8B5F"}

package/dist/schema/vector-index.js

@@ -0,0 +1,179 @@
+import { getDatabase, castParams } from '../utils/db.js';
+import { DatabaseError } from '../utils/errors.js';
+import { query } from '../utils/db.js';
+export function registerVectorIndex(record) {
+    const db = getDatabase();
+    try {
+        const existing = query(`SELECT id FROM vector_index_metadata WHERE name = ?`, [record.name]);
+        if (existing.length > 0) {
+            const normalized = normalizeRecord(record);
+            db.run(`
+        UPDATE vector_index_metadata
+        SET type = ?, dimension = ?, metric = ?, params = ?, status = 'building', updated_at = datetime('now')
+        WHERE id = ?
+        `, [normalized.type, normalized.dimension, normalized.metric, JSON.stringify(normalized.params), existing[0].id]);
+            return getVectorIndex(existing[0].id);
+        }
+        const normalized = normalizeRecord({
+            ...record,
+            status: 'building',
+            lastRebuildAt: null,
+            errorMessage: null,
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString()
+        });
+        db.run(`
+      INSERT INTO vector_index_metadata (id, name, type, dimension, metric, params, status, last_rebuild_at, error_message, created_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `, [
+            normalized.id,
+            normalized.name,
+            normalized.type,
+            normalized.dimension,
+            normalized.metric,
+            JSON.stringify(normalized.params),
+            normalized.status,
+            normalized.lastRebuildAt,
+            normalized.errorMessage,
+            normalized.createdAt,
+            normalized.updatedAt
+        ]);
+        return getVectorIndex(normalized.id);
+    }
+    catch (error) {
+        throw new DatabaseError('Failed to register vector index', error);
+    }
+}
+export function getVectorIndex(id) {
+    try {
+        const rows = query(`SELECT * FROM vector_index_metadata WHERE id = ?`, [id]);
+        if (rows.length === 0)
+            return null;
+        return mapRow(rows[0]);
+    }
+    catch {
+        return null;
+    }
+}
+export function getVectorIndexByName(name) {
+    try {
+        const rows = query(`SELECT * FROM vector_index_metadata WHERE name = ?`, [name]);
+        if (rows.length === 0)
+            return null;
+        return mapRow(rows[0]);
+    }
+    catch {
+        return null;
+    }
+}
+export function listVectorIndexes() {
+    try {
+        const rows = query(`SELECT * FROM vector_index_metadata ORDER BY updated_at DESC`);
+        return rows.map(mapRow);
+    }
+    catch (error) {
+        throw new DatabaseError('Failed to list vector indexes', error);
+    }
+}
+export function updateVectorIndexStatus(id, status, errorMessage) {
+    const db = getDatabase();
+    try {
+        const update = ['status = ?', 'updated_at = datetime(\'now\')'];
+        const values = [status];
+        if (status === 'ready') {
+            update.push('last_rebuild_at = datetime(\'now\')');
+            update.push('error_message = NULL');
+        }
+        if (errorMessage) {
+            update.push('error_message = ?');
+            values.push(errorMessage);
+        }
+        values.push(id);
+        db.run(`UPDATE vector_index_metadata SET ${update.join(', ')} WHERE id = ?`, castParams(values));
+    }
+    catch (error) {
+        throw new DatabaseError('Failed to update vector index status', error);
+    }
+}
+export function removeVectorIndex(id) {
+    try {
+        query(`DELETE FROM vector_index_metadata WHERE id = ?`, [id]);
+        if (!getVectorIndex(id)) {
+            throw new DatabaseError('Vector index not found', new Error(id));
+        }
+    }
+    catch (error) {
+        if (error instanceof DatabaseError)
+            throw error;
+        throw new DatabaseError('Failed to remove vector index', error);
+    }
+}
+export function ensureVectorIndexMetadata(name, dimension) {
+    const existing = getVectorIndexByName(name);
+    if (existing) {
+        if (existing.dimension !== dimension) {
+            const rebuilt = registerVectorIndex({
+                id: existing.id,
+                name,
+                dimension,
+                type: existing.type,
+                metric: existing.metric,
+                params: existing.params
+            });
+            updateVectorIndexStatus(rebuilt.id, 'building');
+            return rebuilt;
+        }
+        return existing;
+    }
+    const created = registerVectorIndex({
+        id: `vindex-${name}`,
+        name,
+        dimension,
+        metric: 'cosine'
+    });
+    updateVectorIndexStatus(created.id, 'building');
+    return created;
+}
+function normalizeRecord(record) {
+    return {
+        id: record.id,
+        name: record.name,
+        type: record.type ?? 'hnsw',
+        dimension: record.dimension,
+        metric: record.metric ?? 'cosine',
+        params: record.params ?? {},
+        status: record.status ?? 'building',
+        lastRebuildAt: record.lastRebuildAt ?? null,
+        errorMessage: record.errorMessage ?? null,
+        createdAt: record.createdAt ?? new Date().toISOString(),
+        updatedAt: record.updatedAt ?? new Date().toISOString()
+    };
+}
+function mapRow(row) {
+    return {
+        id: row.id,
+        name: row.name,
+        type: row.type,
+        dimension: row.dimension,
+        metric: row.metric,
+        params: safeParseJson(row.params),
+        status: row.status,
+        lastRebuildAt: row.last_rebuild_at,
+        errorMessage: row.error_message,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at
+    };
+}
+function safeParseJson(value) {
+    try {
+        const parsed = JSON.parse(value || '{}');
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        // ignore malformed json and return empty object
+    }
+    return {};
+}
+//# sourceMappingURL=vector-index.js.map

package/dist/schema/vector-index.js.map

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

package/dist/scripts/agents/base.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Base adapter interface for MCP-compatible agents.
+ *
+ * Each adapter encapsulates how a specific AI agent runtime
+ * spawns a child process and communicates with the
+ * Context Gatekeeper MCP server.
+ */
+import { ChildProcess } from 'node:child_process';
+export type PermissionLevel = 'read' | 'write' | 'watchdog';
+export interface AgentConfig {
+    /** Name of the agent (used in reports) */
+    name: string;
+    /** Path to the agent CLI binary */
+    cliPath?: string;
+    /** Optional arguments to pass before the prompt */
+    cliArgs?: string[];
+    /** MCP config object written to a temp file before spawning */
+    mcpConfig: Record<string, unknown>;
+    /** Token configuration for Watchdog tests */
+    tokens?: {
+        read?: string;
+        write?: string;
+        watchdog?: string;
+    };
+    /** Per-agent DATA_DIR override */
+    dataDir?: string;
+    /** Timeout in ms for any single tool call (default 30000) */
+    timeoutMs?: number;
+}
+export interface ToolCallResult {
+    agent: string;
+    tool: string;
+    success: boolean;
+    latencyMs: number;
+    payload?: unknown;
+    error?: string;
+    raw?: string;
+}
+export interface ToolCallRequest {
+    tool: string;
+    arguments: Record<string, unknown>;
+}
+/**
+ * Abstract base class for agent adapters.
+ *
+ * Subclasses must implement `buildSpawnCommand` to construct the
+ * child process invocation. The base class handles:
+ *  - temp directory creation and cleanup
+ *  - MCP config file generation
+ *  - child process lifecycle (spawn, stdin/stdout JSON-RPC, kill)
+ */
+export declare abstract class BaseAgentAdapter {
+    protected child: ChildProcess | null;
+    protected dataDir: string;
+    protected mcpConfigPath: string;
+    protected config: AgentConfig;
+    constructor(config: AgentConfig);
+    abstract get name(): string;
+    abstract buildSpawnCommand(): {
+        command: string;
+        args: string[];
+        env: Record<string, string | undefined>;
+    };
+    /** Spawn the agent child process. Returns the process handle. */
+    spawnAgent(prompt: string): ChildProcess;
+    /** Read MCP server binary path from config. */
+    protected getMcpServerCommand(): {
+        command: string;
+        args: string[];
+    };
+    /** Build environment variables for a direct MCP server subprocess test. */
+    buildMcpServerEnv(extra?: Record<string, string | undefined>): Record<string, string | undefined>;
+    /** Wait for the child to exit. Resolves with the exit code. */
+    waitForExit(timeoutMs?: number): Promise<{
+        code: number | null;
+        stdout: string;
+        stderr: string;
+    }>;
+    /** Clean up temp directories. */
+    cleanup(): void;
+    /** Get the absolute path to the temp data directory for this agent run. */
+    getDataDir(): string;
+}
+/** Resolve the MCP server binary path that will be used by all adapters. */
+export declare function resolveMcpServerBin(): {
+    command: string;
+    args: string[];
+};
+//# sourceMappingURL=base.d.ts.map

package/dist/scripts/agents/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["base.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAS,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMzD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,6CAA6C;IAC7C,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,8BAAsB,gBAAgB;IACpC,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAQ;IAC5C,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,aAAa,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC;gBAElB,MAAM,EAAE,WAAW;IAQ/B,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,IAAI;QAC5B,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;KACzC;IAED,iEAAiE;IACjE,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAoBxC,+CAA+C;IAC/C,SAAS,CAAC,mBAAmB,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE;IAYpE,2EAA2E;IAC3E,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAgBjG,+DAA+D;IACzD,WAAW,CAAC,SAAS,SAAiC,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAwB/H,iCAAiC;IACjC,OAAO,IAAI,IAAI;IAWf,2EAA2E;IAC3E,UAAU,IAAI,MAAM;CAGrB;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAezE"}