cccmemory 1.8.0

package/dist/storage/GlobalIndex.js

@@ -0,0 +1,310 @@
+/**
+ * Global Index for Cross-Project Search
+ *
+ * This module manages a lightweight global registry of all indexed projects
+ * (both Claude Code and Codex). It maintains a central database that tracks:
+ * - Which projects have been indexed
+ * - Where their databases are located
+ * - When they were last indexed
+ * - Basic statistics about each project
+ *
+ * The global index enables:
+ * - Discovery of all indexed projects
+ * - Cross-project search routing
+ * - Batch indexing operations
+ * - Global statistics
+ *
+ * Architecture:
+ * - Each project keeps its own database (per-project isolation)
+ * - The global index is a registry that links to project databases
+ * - Cross-project searches query multiple databases and merge results
+ *
+ * @example
+ * ```typescript
+ * const globalIndex = new GlobalIndex();
+ * await globalIndex.registerProject({
+ *   project_path: '/Users/user/project',
+ *   source_type: 'claude-code',
+ *   db_path: '/Users/user/.claude/projects/-project/.db',
+ * });
+ *
+ * const projects = await globalIndex.getAllProjects();
+ * console.log(`Tracking ${projects.length} projects`);
+ * ```
+ */
+import Database from "better-sqlite3";
+import { existsSync, mkdirSync, openSync, closeSync } from "fs";
+import { join, dirname } from "path";
+import { homedir } from "os";
+import { nanoid } from "nanoid";
+import { safeJsonParse } from "../utils/safeJson.js";
+import { getCanonicalProjectPath } from "../utils/worktree.js";
+function resolveGlobalIndexPath() {
+    const defaultPath = join(homedir(), ".claude", ".cccmemory-global.db");
+    const canCreateDbFile = (dbPath) => {
+        try {
+            mkdirSync(dirname(dbPath), { recursive: true });
+            const fd = openSync(dbPath, "a");
+            closeSync(fd);
+            return true;
+        }
+        catch (error) {
+            const err = error;
+            if (err.code === "EACCES" || err.code === "EPERM" || err.code === "EROFS") {
+                return false;
+            }
+            throw error;
+        }
+    };
+    const canWriteExistingDbFile = (dbPath) => {
+        try {
+            const fd = openSync(dbPath, "r+");
+            closeSync(fd);
+            return true;
+        }
+        catch (error) {
+            const err = error;
+            if (err.code === "EACCES" ||
+                err.code === "EPERM" ||
+                err.code === "EROFS" ||
+                err.code === "ENOENT") {
+                return false;
+            }
+            throw error;
+        }
+    };
+    const requestedPath = process.env.CCCMEMORY_GLOBAL_INDEX_PATH;
+    if (requestedPath) {
+        if (canCreateDbFile(requestedPath)) {
+            return requestedPath;
+        }
+        throw new Error(`Global index path is not writable: ${requestedPath}\n` +
+            "Fix permissions or set CCCMEMORY_GLOBAL_INDEX_PATH to a writable file path.\n" +
+            "If you're running under Codex or Claude with a locked home dir (~/.claude or ~/.codex), " +
+            "you must set CCCMEMORY_GLOBAL_INDEX_PATH explicitly.");
+    }
+    if (canCreateDbFile(defaultPath)) {
+        return defaultPath;
+    }
+    const canonicalPath = getCanonicalProjectPath(process.cwd()).canonicalPath;
+    const fallbackPath = join(canonicalPath, ".cccmemory", "global-index.db");
+    if (existsSync(fallbackPath) && canWriteExistingDbFile(fallbackPath)) {
+        console.error(`⚠️ Using existing project-local global index at ${fallbackPath}. ` +
+            "No new files are created there automatically. " +
+            "Set CCCMEMORY_GLOBAL_INDEX_PATH to make this explicit.");
+        return fallbackPath;
+    }
+    throw new Error(`Unable to create global index at ${defaultPath}.\n` +
+        `Fix permissions for ${dirname(defaultPath)} or set CCCMEMORY_GLOBAL_INDEX_PATH.\n` +
+        "If you're running under Codex or Claude with a locked home dir (~/.claude or ~/.codex), " +
+        "you must set CCCMEMORY_GLOBAL_INDEX_PATH explicitly.");
+}
+/**
+ * Global Index Manager
+ *
+ * Maintains a central registry of all indexed projects in a global database.
+ */
+export class GlobalIndex {
+    db = null;
+    globalDbPath;
+    initialized = false;
+    constructor(customPath) {
+        // Use custom path or default to ~/.claude/.cccmemory-global.db
+        // Note: Database is NOT opened here - lazy initialization in ensureInitialized()
+        if (customPath) {
+            this.globalDbPath = customPath;
+        }
+        else {
+            this.globalDbPath = resolveGlobalIndexPath();
+        }
+    }
+    /**
+     * Ensure database is initialized (lazy initialization).
+     * Called automatically by methods that need the database.
+     */
+    ensureInitialized() {
+        if (!this.initialized || !this.db) {
+            // Create parent directory if needed
+            const parentDir = dirname(this.globalDbPath);
+            if (!existsSync(parentDir)) {
+                mkdirSync(parentDir, { recursive: true });
+            }
+            // Open/create database
+            this.db = new Database(this.globalDbPath);
+            // Initialize schema
+            this.initializeSchema();
+            this.initialized = true;
+        }
+        return this.db;
+    }
+    /**
+     * Initialize the global index database schema.
+     * Note: this.db is guaranteed to be set when this is called from ensureInitialized()
+     */
+    initializeSchema() {
+        if (!this.db) {
+            throw new Error("Database not initialized");
+        }
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS project_metadata (
+        id TEXT PRIMARY KEY,
+        project_path TEXT NOT NULL UNIQUE,
+        source_type TEXT NOT NULL,
+        db_path TEXT NOT NULL,
+        last_indexed INTEGER NOT NULL,
+        message_count INTEGER DEFAULT 0,
+        conversation_count INTEGER DEFAULT 0,
+        decision_count INTEGER DEFAULT 0,
+        mistake_count INTEGER DEFAULT 0,
+        metadata TEXT,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_proj_source ON project_metadata(source_type);
+      CREATE INDEX IF NOT EXISTS idx_proj_last_indexed ON project_metadata(last_indexed);
+      CREATE INDEX IF NOT EXISTS idx_proj_path ON project_metadata(project_path);
+    `);
+    }
+    /**
+     * Register or update a project in the global index.
+     * Uses atomic UPSERT to avoid race conditions.
+     *
+     * @param options - Project registration options
+     * @returns The registered/updated project metadata
+     */
+    registerProject(options) {
+        const db = this.ensureInitialized();
+        const now = Date.now();
+        const id = nanoid();
+        // Atomic UPSERT - avoids race conditions between concurrent registrations
+        const stmt = db.prepare(`
+      INSERT INTO project_metadata (
+        id, project_path, source_type, db_path, last_indexed,
+        message_count, conversation_count, decision_count, mistake_count,
+        metadata, created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(project_path) DO UPDATE SET
+        source_type = excluded.source_type,
+        db_path = excluded.db_path,
+        last_indexed = excluded.last_indexed,
+        message_count = excluded.message_count,
+        conversation_count = excluded.conversation_count,
+        decision_count = excluded.decision_count,
+        mistake_count = excluded.mistake_count,
+        metadata = excluded.metadata,
+        updated_at = excluded.updated_at
+    `);
+        stmt.run(id, options.project_path, options.source_type, options.db_path, now, options.message_count ?? 0, options.conversation_count ?? 0, options.decision_count ?? 0, options.mistake_count ?? 0, JSON.stringify(options.metadata ?? {}), now, now);
+        const row = db
+            .prepare("SELECT * FROM project_metadata WHERE project_path = ?")
+            .get(options.project_path);
+        return {
+            id: row.id,
+            project_path: row.project_path,
+            source_type: row.source_type,
+            db_path: row.db_path,
+            last_indexed: row.last_indexed,
+            message_count: row.message_count,
+            conversation_count: row.conversation_count,
+            decision_count: row.decision_count,
+            mistake_count: row.mistake_count,
+            metadata: safeJsonParse(row.metadata, {}),
+            created_at: row.created_at,
+            updated_at: row.updated_at,
+        };
+    }
+    /**
+     * Get all registered projects.
+     *
+     * @param sourceType - Optional filter by source type
+     * @returns Array of project metadata
+     */
+    getAllProjects(sourceType) {
+        let sql = "SELECT * FROM project_metadata";
+        const params = [];
+        if (sourceType) {
+            sql += " WHERE source_type = ?";
+            params.push(sourceType);
+        }
+        sql += " ORDER BY last_indexed DESC";
+        const db = this.ensureInitialized();
+        const rows = db.prepare(sql).all(...params);
+        return rows.map((row) => ({
+            ...row,
+            metadata: safeJsonParse(row.metadata, {}),
+        }));
+    }
+    /**
+     * Get a specific project by path.
+     *
+     * @param projectPath - Absolute path to the project
+     * @returns Project metadata or null if not found
+     */
+    getProject(projectPath) {
+        const db = this.ensureInitialized();
+        const row = db
+            .prepare("SELECT * FROM project_metadata WHERE project_path = ?")
+            .get(projectPath);
+        if (!row) {
+            return null;
+        }
+        return {
+            ...row,
+            metadata: safeJsonParse(row.metadata, {}),
+        };
+    }
+    /**
+     * Remove a project from the global index.
+     *
+     * Note: This does NOT delete the project's database, only removes it from the registry.
+     *
+     * @param projectPath - Absolute path to the project
+     * @returns True if project was removed, false if not found
+     */
+    removeProject(projectPath) {
+        const db = this.ensureInitialized();
+        const stmt = db.prepare("DELETE FROM project_metadata WHERE project_path = ?");
+        const result = stmt.run(projectPath);
+        return result.changes > 0;
+    }
+    /**
+     * Get global statistics across all projects.
+     *
+     * @returns Aggregate statistics
+     */
+    getGlobalStats() {
+        const db = this.ensureInitialized();
+        const stats = db
+            .prepare(`
+      SELECT
+        COUNT(*) as total_projects,
+        COALESCE(SUM(CASE WHEN source_type = 'claude-code' THEN 1 ELSE 0 END), 0) as claude_code_projects,
+        COALESCE(SUM(CASE WHEN source_type = 'codex' THEN 1 ELSE 0 END), 0) as codex_projects,
+        COALESCE(SUM(message_count), 0) as total_messages,
+        COALESCE(SUM(conversation_count), 0) as total_conversations,
+        COALESCE(SUM(decision_count), 0) as total_decisions,
+        COALESCE(SUM(mistake_count), 0) as total_mistakes
+      FROM project_metadata
+    `)
+            .get();
+        return stats;
+    }
+    /**
+     * Close the global index database.
+     */
+    close() {
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+            this.initialized = false;
+        }
+    }
+    /**
+     * Get the path to the global index database.
+     */
+    getDbPath() {
+        return this.globalDbPath;
+    }
+}
+//# sourceMappingURL=GlobalIndex.js.map

package/dist/storage/GlobalIndex.js.map

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

package/dist/storage/SQLiteManager.d.ts

@@ -0,0 +1,114 @@
+/**
+ * SQLite Manager with optimized settings
+ * Based on patterns from code-graph-rag-mcp for maximum performance
+ */
+import Database from "better-sqlite3";
+export interface SQLiteConfig {
+    dbPath?: string;
+    projectPath?: string;
+    readOnly?: boolean;
+    verbose?: boolean;
+    /** Memory-mapped I/O size in bytes (default: 1GB). Set to 0 to disable. */
+    mmapSize?: number;
+    /** Cache size in KB (default: 64MB) */
+    cacheSizeKb?: number;
+}
+export declare class SQLiteManager {
+    private db;
+    private dbPath;
+    private isReadOnly;
+    private mmapSize;
+    private cacheSizeKb;
+    constructor(config?: SQLiteConfig);
+    private ensureDirectoryExists;
+    /**
+     * Load sqlite-vec extension for vector search
+     */
+    private loadVectorExtension;
+    /**
+     * Create sqlite-vec virtual tables for vector search with specified dimensions
+     * Public method called when embedding provider dimensions are known
+     */
+    createVecTablesWithDimensions(dimensions: number): void;
+    /**
+     * Apply performance optimizations
+     * Based on code-graph-rag-mcp sqlite-manager.ts
+     */
+    private optimizeDatabase;
+    /**
+     * Initialize database schema from schema.sql
+     */
+    private initializeSchema;
+    /**
+     * Apply database migrations for existing databases
+     */
+    private applyMigrations;
+    /**
+     * Get the underlying database instance
+     */
+    getDatabase(): Database.Database;
+    /**
+     * Execute a transaction
+     */
+    transaction<T>(fn: () => T): T;
+    /**
+     * Prepare a statement
+     */
+    prepare<T extends unknown[] = unknown[]>(sql: string): Database.Statement<T>;
+    /**
+     * Execute SQL directly
+     */
+    exec(sql: string): void;
+    /**
+     * Close the database connection
+     */
+    close(): void;
+    /**
+     * Get database statistics
+     */
+    getStats(): {
+        dbPath: string;
+        fileSize: number;
+        pageCount: number;
+        pageSize: number;
+        wal: {
+            enabled: boolean;
+            size: number | null;
+        };
+    };
+    /**
+     * Get database file path
+     */
+    getDbPath(): string;
+    /**
+     * Vacuum the database to reclaim space
+     */
+    vacuum(): void;
+    /**
+     * Analyze the database for query optimization
+     */
+    analyze(): void;
+    /**
+     * Checkpoint the WAL file
+     */
+    checkpoint(): void;
+    /**
+     * Get current schema version
+     */
+    getSchemaVersion(): number;
+}
+/**
+ * Get a SQLiteManager instance for the given config.
+ * Instances are cached by dbPath to avoid re-opening the same database.
+ */
+export declare function getSQLiteManager(config?: SQLiteConfig): SQLiteManager;
+/**
+ * Reset all cached SQLiteManager instances.
+ * Useful for testing or when switching projects.
+ */
+export declare function resetSQLiteManager(): void;
+/**
+ * Reset a specific SQLiteManager instance by path.
+ */
+export declare function resetSQLiteManagerByPath(dbPath: string): void;
+//# sourceMappingURL=SQLiteManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SQLiteManager.d.ts","sourceRoot":"","sources":["../../src/storage/SQLiteManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAoBtC,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA8KD,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,GAAE,YAAiB;IAoCrC,OAAO,CAAC,qBAAqB;IAO7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;;OAGG;IACH,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IA2DvD;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAyCxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqFxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAyJvB;;OAEG;IACH,WAAW,IAAI,QAAQ,CAAC,QAAQ;IAIhC;;OAEG;IACH,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAK9B;;OAEG;IACH,OAAO,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IAI5E;;OAEG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIvB;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,QAAQ,IAAI;QACV,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,GAAG,EAAE;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAC;KAChD;IA+BD;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,MAAM,IAAI,IAAI;IAOd;;OAEG;IACH,OAAO,IAAI,IAAI;IAOf;;OAEG;IACH,UAAU,IAAI,IAAI;IAOlB;;OAEG;IACH,gBAAgB,IAAI,MAAM;CAU3B;AAKD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,aAAa,CAarE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAKzC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAM7D"}