driftdetect-cortex 0.9.41

package/dist/storage/interface.d.ts.map

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

package/dist/storage/interface.js

@@ -0,0 +1,9 @@
+/**
+ * Memory Storage Interface
+ *
+ * Defines the contract for memory storage implementations.
+ * Supports CRUD operations, vector search, bitemporal queries,
+ * and relationship management.
+ */
+export {};
+//# sourceMappingURL=interface.js.map

package/dist/storage/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/storage/interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/storage/sqlite/client.d.ts

@@ -0,0 +1,64 @@
+/**
+ * SQLite Client Wrapper
+ *
+ * Wraps better-sqlite3 with WAL mode, foreign key support, and sqlite-vec for vector search.
+ */
+import Database from 'better-sqlite3';
+import type { Database as DatabaseType } from 'better-sqlite3';
+/**
+ * SQLite client configuration
+ */
+export interface SQLiteClientConfig {
+    /** Path to the database file */
+    dbPath: string;
+    /** Enable WAL mode (default: true) */
+    walMode?: boolean;
+    /** Enable foreign keys (default: true) */
+    foreignKeys?: boolean;
+    /** Enable vector search (default: true) */
+    vectorSearch?: boolean;
+    /** Enable verbose logging */
+    verbose?: boolean;
+}
+/**
+ * SQLite client wrapper
+ */
+export declare class SQLiteClient {
+    private db;
+    private readonly config;
+    private _vecEnabled;
+    constructor(config: SQLiteClientConfig);
+    /**
+     * Check if vector search is enabled
+     */
+    get vecEnabled(): boolean;
+    /**
+     * Get the underlying database instance
+     */
+    get database(): DatabaseType;
+    /**
+     * Execute raw SQL
+     */
+    exec(sql: string): void;
+    /**
+     * Prepare a statement
+     */
+    prepare(sql: string): Database.Statement;
+    /**
+     * Run a transaction
+     */
+    transaction<T>(fn: () => T): T;
+    /**
+     * Close the database connection
+     */
+    close(): void;
+    /**
+     * Check if the database is open
+     */
+    get isOpen(): boolean;
+    /**
+     * Get database file path
+     */
+    get path(): string;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/storage/sqlite/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/storage/sqlite/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG/D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAe;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IACtD,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,kBAAkB;IAiCtC;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,YAAY,CAE3B;IAED;;OAEG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIvB;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS;IAIxC;;OAEG;IACH,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAI9B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/storage/sqlite/client.js

@@ -0,0 +1,94 @@
+/**
+ * SQLite Client Wrapper
+ *
+ * Wraps better-sqlite3 with WAL mode, foreign key support, and sqlite-vec for vector search.
+ */
+import Database from 'better-sqlite3';
+import * as sqliteVec from 'sqlite-vec';
+/**
+ * SQLite client wrapper
+ */
+export class SQLiteClient {
+    db;
+    config;
+    _vecEnabled = false;
+    constructor(config) {
+        this.config = {
+            dbPath: config.dbPath,
+            walMode: config.walMode ?? true,
+            foreignKeys: config.foreignKeys ?? true,
+            vectorSearch: config.vectorSearch ?? true,
+            verbose: config.verbose ?? false,
+        };
+        this.db = new Database(this.config.dbPath, {
+            verbose: this.config.verbose ? console.log : undefined,
+        });
+        // Configure pragmas
+        if (this.config.walMode) {
+            this.db.pragma('journal_mode = WAL');
+        }
+        if (this.config.foreignKeys) {
+            this.db.pragma('foreign_keys = ON');
+        }
+        // Load sqlite-vec extension
+        if (this.config.vectorSearch) {
+            try {
+                sqliteVec.load(this.db);
+                this._vecEnabled = true;
+            }
+            catch (err) {
+                console.warn('sqlite-vec not available:', err.message);
+                this._vecEnabled = false;
+            }
+        }
+    }
+    /**
+     * Check if vector search is enabled
+     */
+    get vecEnabled() {
+        return this._vecEnabled;
+    }
+    /**
+     * Get the underlying database instance
+     */
+    get database() {
+        return this.db;
+    }
+    /**
+     * Execute raw SQL
+     */
+    exec(sql) {
+        this.db.exec(sql);
+    }
+    /**
+     * Prepare a statement
+     */
+    prepare(sql) {
+        return this.db.prepare(sql);
+    }
+    /**
+     * Run a transaction
+     */
+    transaction(fn) {
+        return this.db.transaction(fn)();
+    }
+    /**
+     * Close the database connection
+     */
+    close() {
+        this.db.close();
+    }
+    /**
+     * Check if the database is open
+     */
+    get isOpen() {
+        return this.db.open;
+    }
+    /**
+     * Get database file path
+     */
+    get path() {
+        return this.db.name;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/storage/sqlite/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/storage/sqlite/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,OAAO,KAAK,SAAS,MAAM,YAAY,CAAC;AAkBxC;;GAEG;AACH,MAAM,OAAO,YAAY;IACf,EAAE,CAAe;IACR,MAAM,CAA+B;IAC9C,WAAW,GAAG,KAAK,CAAC;IAE5B,YAAY,MAA0B;QACpC,IAAI,CAAC,MAAM,GAAG;YACZ,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;YAC/B,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,IAAI;YACvC,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,IAAI;YACzC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,KAAK;SACjC,CAAC;QAEF,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;YACzC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;SACvD,CAAC,CAAC;QAEH,oBAAoB;QACpB,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAC5B,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;QACtC,CAAC;QAED,4BAA4B;QAC5B,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACxB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YAC1B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,2BAA2B,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;gBAClE,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,GAAW;QACd,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,GAAW;QACjB,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,WAAW,CAAI,EAAW;QACxB,OAAO,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;IACtB,CAAC;CACF"}

package/dist/storage/sqlite/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * SQLite Storage Implementation
+ *
+ * Default storage backend using SQLite with sqlite-vss for vector search.
+ */
+export * from './client.js';
+export * from './schema.js';
+export * from './migrations.js';
+export * from './queries.js';
+export * from './storage.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/sqlite/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/sqlite/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/storage/sqlite/index.js

@@ -0,0 +1,11 @@
+/**
+ * SQLite Storage Implementation
+ *
+ * Default storage backend using SQLite with sqlite-vss for vector search.
+ */
+export * from './client.js';
+export * from './schema.js';
+export * from './migrations.js';
+export * from './queries.js';
+export * from './storage.js';
+//# sourceMappingURL=index.js.map

package/dist/storage/sqlite/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/storage/sqlite/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/storage/sqlite/migrations.d.ts

@@ -0,0 +1,32 @@
+/**
+ * SQLite Schema Migrations
+ *
+ * Handles schema versioning and migrations for the Cortex database.
+ */
+import type { SQLiteClient } from './client.js';
+/**
+ * Migration definition
+ */
+export interface Migration {
+    version: number;
+    description: string;
+    up: string;
+    down?: string;
+}
+/**
+ * All migrations in order
+ */
+export declare const MIGRATIONS: Migration[];
+/**
+ * Run migrations to bring database to current version
+ */
+export declare function runMigrations(client: SQLiteClient): Promise<void>;
+/**
+ * Get current schema version
+ */
+export declare function getSchemaVersion(client: SQLiteClient): number;
+/**
+ * Check if migrations are needed
+ */
+export declare function needsMigration(client: SQLiteClient): boolean;
+//# sourceMappingURL=migrations.d.ts.map

package/dist/storage/sqlite/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../../src/storage/sqlite/migrations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,EAyIjC,CAAC;AAEF;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAmCvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAY7D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAG5D"}

package/dist/storage/sqlite/migrations.js

@@ -0,0 +1,198 @@
+/**
+ * SQLite Schema Migrations
+ *
+ * Handles schema versioning and migrations for the Cortex database.
+ */
+import { SCHEMA, SCHEMA_VERSION } from './schema.js';
+/**
+ * All migrations in order
+ */
+export const MIGRATIONS = [
+    {
+        version: 1,
+        description: 'Initial schema',
+        up: SCHEMA,
+    },
+    // Cortex v2 migrations
+    {
+        version: 2,
+        description: 'Causal edges table for causal graph',
+        up: `
+      -- Causal edges table for tracking causal relationships between memories
+      CREATE TABLE IF NOT EXISTS causal_edges (
+        id TEXT PRIMARY KEY,
+        source_id TEXT NOT NULL,
+        target_id TEXT NOT NULL,
+        relation TEXT NOT NULL CHECK (relation IN (
+          'caused', 'enabled', 'prevented', 'contradicts',
+          'supersedes', 'supports', 'derived_from', 'triggered_by'
+        )),
+        strength REAL DEFAULT 1.0 CHECK (strength >= 0 AND strength <= 1),
+        evidence TEXT,  -- JSON array of CausalEvidence
+        inferred INTEGER DEFAULT 0,
+        created_at TEXT DEFAULT (datetime('now')),
+        validated_at TEXT,
+        created_by TEXT,
+        
+        FOREIGN KEY (source_id) REFERENCES memories(id) ON DELETE CASCADE,
+        FOREIGN KEY (target_id) REFERENCES memories(id) ON DELETE CASCADE
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_causal_source ON causal_edges(source_id);
+      CREATE INDEX IF NOT EXISTS idx_causal_target ON causal_edges(target_id);
+      CREATE INDEX IF NOT EXISTS idx_causal_relation ON causal_edges(relation);
+      CREATE INDEX IF NOT EXISTS idx_causal_strength ON causal_edges(strength);
+      CREATE INDEX IF NOT EXISTS idx_causal_inferred ON causal_edges(inferred);
+      CREATE INDEX IF NOT EXISTS idx_causal_validated ON causal_edges(validated_at);
+    `,
+        down: `
+      DROP INDEX IF EXISTS idx_causal_validated;
+      DROP INDEX IF EXISTS idx_causal_inferred;
+      DROP INDEX IF EXISTS idx_causal_strength;
+      DROP INDEX IF EXISTS idx_causal_relation;
+      DROP INDEX IF EXISTS idx_causal_target;
+      DROP INDEX IF EXISTS idx_causal_source;
+      DROP TABLE IF EXISTS causal_edges;
+    `,
+    },
+    {
+        version: 3,
+        description: 'Session context table for token efficiency',
+        up: `
+      -- Session context table for tracking what has been loaded
+      CREATE TABLE IF NOT EXISTS session_contexts (
+        id TEXT PRIMARY KEY,
+        started_at TEXT DEFAULT (datetime('now')),
+        ended_at TEXT,
+        loaded_memories TEXT,  -- JSON array of memory IDs
+        loaded_patterns TEXT,  -- JSON array of pattern IDs
+        loaded_files TEXT,     -- JSON array of file paths
+        loaded_constraints TEXT, -- JSON array of constraint IDs
+        tokens_sent INTEGER DEFAULT 0,
+        queries_made INTEGER DEFAULT 0,
+        last_activity TEXT DEFAULT (datetime('now')),
+        metadata TEXT  -- JSON object with session metadata
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_session_started ON session_contexts(started_at);
+      CREATE INDEX IF NOT EXISTS idx_session_ended ON session_contexts(ended_at);
+      CREATE INDEX IF NOT EXISTS idx_session_activity ON session_contexts(last_activity);
+    `,
+        down: `
+      DROP INDEX IF EXISTS idx_session_activity;
+      DROP INDEX IF EXISTS idx_session_ended;
+      DROP INDEX IF EXISTS idx_session_started;
+      DROP TABLE IF EXISTS session_contexts;
+    `,
+    },
+    {
+        version: 4,
+        description: 'Validation history table for active learning',
+        up: `
+      -- Validation history for tracking memory validation feedback
+      CREATE TABLE IF NOT EXISTS memory_validation_history (
+        id TEXT PRIMARY KEY,
+        memory_id TEXT NOT NULL,
+        action TEXT NOT NULL CHECK (action IN ('confirmed', 'rejected', 'modified')),
+        previous_confidence REAL,
+        new_confidence REAL,
+        feedback TEXT,
+        validated_at TEXT DEFAULT (datetime('now')),
+        validated_by TEXT,
+        session_id TEXT,
+        
+        FOREIGN KEY (memory_id) REFERENCES memories(id) ON DELETE CASCADE,
+        FOREIGN KEY (session_id) REFERENCES session_contexts(id) ON DELETE SET NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_validation_memory ON memory_validation_history(memory_id);
+      CREATE INDEX IF NOT EXISTS idx_validation_action ON memory_validation_history(action);
+      CREATE INDEX IF NOT EXISTS idx_validation_time ON memory_validation_history(validated_at);
+    `,
+        down: `
+      DROP INDEX IF EXISTS idx_validation_time;
+      DROP INDEX IF EXISTS idx_validation_action;
+      DROP INDEX IF EXISTS idx_validation_memory;
+      DROP TABLE IF EXISTS memory_validation_history;
+    `,
+    },
+    {
+        version: 5,
+        description: 'Usage history table for memory effectiveness tracking',
+        up: `
+      -- Usage history for tracking memory effectiveness
+      CREATE TABLE IF NOT EXISTS memory_usage_history (
+        id TEXT PRIMARY KEY,
+        memory_id TEXT NOT NULL,
+        outcome TEXT NOT NULL CHECK (outcome IN ('accepted', 'modified', 'rejected')),
+        context TEXT,  -- JSON with generation context
+        used_at TEXT DEFAULT (datetime('now')),
+        session_id TEXT,
+        
+        FOREIGN KEY (memory_id) REFERENCES memories(id) ON DELETE CASCADE,
+        FOREIGN KEY (session_id) REFERENCES session_contexts(id) ON DELETE SET NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_usage_memory ON memory_usage_history(memory_id);
+      CREATE INDEX IF NOT EXISTS idx_usage_outcome ON memory_usage_history(outcome);
+      CREATE INDEX IF NOT EXISTS idx_usage_time ON memory_usage_history(used_at);
+    `,
+        down: `
+      DROP INDEX IF EXISTS idx_usage_time;
+      DROP INDEX IF EXISTS idx_usage_outcome;
+      DROP INDEX IF EXISTS idx_usage_memory;
+      DROP TABLE IF EXISTS memory_usage_history;
+    `,
+    },
+];
+/**
+ * Run migrations to bring database to current version
+ */
+export async function runMigrations(client) {
+    const db = client.database;
+    // Create migrations table if it doesn't exist
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS schema_migrations (
+      version INTEGER PRIMARY KEY,
+      applied_at TEXT DEFAULT (datetime('now')),
+      description TEXT
+    );
+  `);
+    // Get current version
+    const currentVersion = db.prepare('SELECT MAX(version) as version FROM schema_migrations').get();
+    const version = currentVersion?.version ?? 0;
+    // Apply pending migrations
+    for (const migration of MIGRATIONS) {
+        if (migration.version > version) {
+            // Only log migrations in verbose mode (check env var)
+            if (process.env['DRIFT_VERBOSE'] === 'true') {
+                console.error(`Applying migration ${migration.version}: ${migration.description}`);
+            }
+            client.transaction(() => {
+                db.exec(migration.up);
+                db.prepare('INSERT INTO schema_migrations (version, description) VALUES (?, ?)').run(migration.version, migration.description);
+            });
+        }
+    }
+}
+/**
+ * Get current schema version
+ */
+export function getSchemaVersion(client) {
+    const db = client.database;
+    try {
+        const result = db.prepare('SELECT MAX(version) as version FROM schema_migrations').get();
+        return result?.version ?? 0;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Check if migrations are needed
+ */
+export function needsMigration(client) {
+    const currentVersion = getSchemaVersion(client);
+    return currentVersion < SCHEMA_VERSION;
+}
+//# sourceMappingURL=migrations.js.map

package/dist/storage/sqlite/migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../../src/storage/sqlite/migrations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAYrD;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAgB;IACrC;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,gBAAgB;QAC7B,EAAE,EAAE,MAAM;KACX;IACD,uBAAuB;IACvB;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,qCAAqC;QAClD,EAAE,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;KA2BH;QACD,IAAI,EAAE;;;;;;;;KAQL;KACF;IACD;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,4CAA4C;QACzD,EAAE,EAAE;;;;;;;;;;;;;;;;;;;KAmBH;QACD,IAAI,EAAE;;;;;KAKL;KACF;IACD;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,8CAA8C;QAC3D,EAAE,EAAE;;;;;;;;;;;;;;;;;;;;KAoBH;QACD,IAAI,EAAE;;;;;KAKL;KACF;IACD;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,uDAAuD;QACpE,EAAE,EAAE;;;;;;;;;;;;;;;;;KAiBH;QACD,IAAI,EAAE;;;;;KAKL;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAoB;IACtD,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC;IAE3B,8CAA8C;IAC9C,EAAE,CAAC,IAAI,CAAC;;;;;;GAMP,CAAC,CAAC;IAEH,sBAAsB;IACtB,MAAM,cAAc,GAAG,EAAE,CAAC,OAAO,CAC/B,uDAAuD,CACxD,CAAC,GAAG,EAAgC,CAAC;IAEtC,MAAM,OAAO,GAAG,cAAc,EAAE,OAAO,IAAI,CAAC,CAAC;IAE7C,2BAA2B;IAC3B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,SAAS,CAAC,OAAO,GAAG,OAAO,EAAE,CAAC;YAChC,sDAAsD;YACtD,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,MAAM,EAAE,CAAC;gBAC5C,OAAO,CAAC,KAAK,CAAC,sBAAsB,SAAS,CAAC,OAAO,KAAK,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;YACrF,CAAC;YAED,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE;gBACtB,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;gBACtB,EAAE,CAAC,OAAO,CACR,oEAAoE,CACrE,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;YAClD,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAoB;IACnD,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC;IAE3B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CACvB,uDAAuD,CACxD,CAAC,GAAG,EAAgC,CAAC;QAEtC,OAAO,MAAM,EAAE,OAAO,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,MAAM,cAAc,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAChD,OAAO,cAAc,GAAG,cAAc,CAAC;AACzC,CAAC"}

package/dist/storage/sqlite/queries.d.ts

@@ -0,0 +1,106 @@
+/**
+ * SQLite Prepared Statements
+ *
+ * Pre-defined SQL queries for common operations.
+ */
+/**
+ * Insert a new memory
+ */
+export declare const INSERT_MEMORY = "\n  INSERT INTO memories (\n    id, type, content, summary, recorded_at, valid_from, \n    confidence, importance, created_by, tags, created_at, updated_at, access_count\n  ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)\n";
+/**
+ * Get a memory by ID
+ */
+export declare const GET_MEMORY = "\n  SELECT id, content FROM memories \n  WHERE id = ? AND archived = 0\n";
+/**
+ * Get a memory by ID with bitemporal scope
+ */
+export declare const GET_MEMORY_SCOPED = "\n  SELECT id, content FROM memories \n  WHERE id = ? AND archived = 0\n";
+/**
+ * Update a memory
+ */
+export declare const UPDATE_MEMORY = "\n  UPDATE memories \n  SET content = ?, summary = ?, confidence = ?, importance = ?, \n      tags = ?, updated_at = ?, last_validated = ?\n  WHERE id = ?\n";
+/**
+ * Delete a memory (soft delete)
+ */
+export declare const SOFT_DELETE_MEMORY = "\n  UPDATE memories \n  SET archived = 1, archive_reason = 'deleted', updated_at = ?\n  WHERE id = ?\n";
+/**
+ * Hard delete a memory
+ */
+export declare const HARD_DELETE_MEMORY = "\n  DELETE FROM memories WHERE id = ?\n";
+/**
+ * Find memories by type
+ */
+export declare const FIND_BY_TYPE = "\n  SELECT id, content FROM memories \n  WHERE type = ? AND archived = 0\n  ORDER BY created_at DESC\n  LIMIT ? OFFSET ?\n";
+/**
+ * Find memories by pattern
+ */
+export declare const FIND_BY_PATTERN = "\n  SELECT m.id, m.content FROM memories m\n  JOIN memory_patterns mp ON m.id = mp.memory_id\n  WHERE mp.pattern_id = ? AND m.archived = 0\n";
+/**
+ * Find memories by constraint
+ */
+export declare const FIND_BY_CONSTRAINT = "\n  SELECT m.id, m.content FROM memories m\n  JOIN memory_constraints mc ON m.id = mc.memory_id\n  WHERE mc.constraint_id = ? AND m.archived = 0\n";
+/**
+ * Find memories by file
+ */
+export declare const FIND_BY_FILE = "\n  SELECT m.id, m.content FROM memories m\n  JOIN memory_files mf ON m.id = mf.memory_id\n  WHERE mf.file_path = ? AND m.archived = 0\n";
+/**
+ * Find memories by function
+ */
+export declare const FIND_BY_FUNCTION = "\n  SELECT m.id, m.content FROM memories m\n  JOIN memory_functions mfn ON m.id = mfn.memory_id\n  WHERE mfn.function_id = ? AND m.archived = 0\n";
+/**
+ * Count memories by type
+ */
+export declare const COUNT_BY_TYPE = "\n  SELECT type, COUNT(*) as count FROM memories \n  WHERE archived = 0\n  GROUP BY type\n";
+/**
+ * Count total memories
+ */
+export declare const COUNT_TOTAL = "\n  SELECT COUNT(*) as count FROM memories WHERE archived = 0\n";
+/**
+ * Get memory summaries
+ */
+export declare const GET_SUMMARIES = "\n  SELECT id, type, summary, confidence, importance, created_at, last_accessed, access_count\n  FROM memories\n  WHERE archived = 0\n  ORDER BY created_at DESC\n  LIMIT ? OFFSET ?\n";
+/**
+ * Update access tracking
+ */
+export declare const UPDATE_ACCESS = "\n  UPDATE memories \n  SET last_accessed = ?, access_count = access_count + 1\n  WHERE id = ?\n";
+/**
+ * Link memory to pattern
+ */
+export declare const LINK_PATTERN = "\n  INSERT OR IGNORE INTO memory_patterns (memory_id, pattern_id) VALUES (?, ?)\n";
+/**
+ * Link memory to constraint
+ */
+export declare const LINK_CONSTRAINT = "\n  INSERT OR IGNORE INTO memory_constraints (memory_id, constraint_id) VALUES (?, ?)\n";
+/**
+ * Link memory to file
+ */
+export declare const LINK_FILE = "\n  INSERT OR REPLACE INTO memory_files (memory_id, file_path, line_start, line_end, content_hash) \n  VALUES (?, ?, ?, ?, ?)\n";
+/**
+ * Link memory to function
+ */
+export declare const LINK_FUNCTION = "\n  INSERT OR IGNORE INTO memory_functions (memory_id, function_id) VALUES (?, ?)\n";
+/**
+ * Add relationship
+ */
+export declare const ADD_RELATIONSHIP = "\n  INSERT OR REPLACE INTO memory_relationships (source_id, target_id, relationship, strength) \n  VALUES (?, ?, ?, ?)\n";
+/**
+ * Remove relationship
+ */
+export declare const REMOVE_RELATIONSHIP = "\n  DELETE FROM memory_relationships \n  WHERE source_id = ? AND target_id = ? AND relationship = ?\n";
+/**
+ * Get related memories
+ */
+export declare const GET_RELATED = "\n  SELECT m.id, m.content FROM memories m\n  JOIN memory_relationships mr ON m.id = mr.target_id\n  WHERE mr.source_id = ? AND m.archived = 0\n";
+/**
+ * Get related memories by type
+ */
+export declare const GET_RELATED_BY_TYPE = "\n  SELECT m.id, m.content FROM memories m\n  JOIN memory_relationships mr ON m.id = mr.target_id\n  WHERE mr.source_id = ? AND mr.relationship = ? AND m.archived = 0\n";
+/**
+ * Insert embedding link
+ */
+export declare const INSERT_EMBEDDING_LINK = "\n  INSERT OR REPLACE INTO memory_embedding_link (memory_id, embedding_rowid) VALUES (?, ?)\n";
+/**
+ * Get embedding rowid for memory
+ */
+export declare const GET_EMBEDDING_ROWID = "\n  SELECT embedding_rowid FROM memory_embedding_link WHERE memory_id = ?\n";
+//# sourceMappingURL=queries.d.ts.map

package/dist/storage/sqlite/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../src/storage/sqlite/queries.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa,oOAKzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,6EAGtB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,6EAG7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,iKAKzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,2GAI9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,4CAE9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,+HAKxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,iJAI3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,uJAI9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,6IAIxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,sJAI5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,+FAIzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,oEAEvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,2LAMzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,qGAIzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,sFAExB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,4FAE3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,oIAGrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,wFAEzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,6HAG5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,0GAG/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,qJAIvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,6KAI/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,kGAEjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,gFAE/B,CAAC"}