cccmemory 1.8.0

package/dist/memory/WorkingMemoryStore.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Working Memory Store
+ *
+ * A key-value store for facts, decisions, and context that persists
+ * across conversation boundaries. Enables Claude to "remember" things
+ * explicitly and retrieve them later.
+ */
+import type { Database } from "better-sqlite3";
+import type { WorkingMemoryItem, RememberOptions, RecallOptions, SemanticRecallOptions, SemanticRecallResult } from "./types.js";
+export declare class WorkingMemoryStore {
+    private db;
+    constructor(db: Database);
+    /**
+     * Store a fact/decision/context in working memory
+     */
+    remember(options: RememberOptions): WorkingMemoryItem;
+    /**
+     * Recall a specific item by key
+     */
+    recall(key: string, projectPath: string): WorkingMemoryItem | null;
+    /**
+     * Recall items matching options
+     */
+    recallMany(options: RecallOptions): WorkingMemoryItem[];
+    /**
+     * Semantic search across working memory using FTS
+     */
+    recallRelevant(options: SemanticRecallOptions): SemanticRecallResult[];
+    /**
+     * Forget (delete) a memory item by key
+     */
+    forget(key: string, projectPath: string): boolean;
+    /**
+     * Forget all items for a project
+     */
+    forgetAll(projectPath: string): number;
+    /**
+     * List all memory items for a project
+     */
+    list(projectPath: string, options?: {
+        tags?: string[];
+        limit?: number;
+        offset?: number;
+    }): WorkingMemoryItem[];
+    /**
+     * Get count of items for a project
+     */
+    count(projectPath: string): number;
+    /**
+     * Get a single item by ID
+     */
+    private getById;
+    /**
+     * Convert database row to WorkingMemoryItem
+     */
+    private rowToItem;
+    /**
+     * Clean up expired items
+     */
+    private cleanupExpired;
+    /**
+     * Insert into FTS index
+     */
+    private insertFts;
+    /**
+     * Update FTS index
+     */
+    private updateFts;
+    /**
+     * Delete from FTS index
+     */
+    private deleteFts;
+    /**
+     * Escape FTS query for safe matching
+     */
+    private escapeFtsQuery;
+    /**
+     * Normalize BM25 rank to a similarity score (0-1)
+     * BM25 returns negative scores, lower is better
+     */
+    private normalizeRank;
+}
+//# sourceMappingURL=WorkingMemoryStore.d.ts.map

package/dist/memory/WorkingMemoryStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkingMemoryStore.d.ts","sourceRoot":"","sources":["../../src/memory/WorkingMemoryStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EACV,iBAAiB,EAEjB,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,EAAE,CAAW;gBAET,EAAE,EAAE,QAAQ;IAIxB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,iBAAiB;IAyErD;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAmBlE;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,iBAAiB,EAAE;IA8CvD;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,oBAAoB,EAAE;IAgCtE;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IAiBjD;;OAEG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAiBtC;;OAEG;IACH,IAAI,CACF,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7D,iBAAiB,EAAE;IA8BtB;;OAEG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAYlC;;OAEG;IACH,OAAO,CAAC,OAAO;IAYf;;OAEG;IACH,OAAO,CAAC,SAAS;IAejB;;OAEG;IACH,OAAO,CAAC,cAAc;IAsBtB;;OAEG;IACH,OAAO,CAAC,SAAS;IAmBjB;;OAEG;IACH,OAAO,CAAC,SAAS;IAgBjB;;OAEG;IACH,OAAO,CAAC,SAAS;IAUjB;;OAEG;IACH,OAAO,CAAC,cAAc;IAqBtB;;;OAGG;IACH,OAAO,CAAC,aAAa;CAKtB"}

package/dist/memory/WorkingMemoryStore.js

@@ -0,0 +1,318 @@
+/**
+ * Working Memory Store
+ *
+ * A key-value store for facts, decisions, and context that persists
+ * across conversation boundaries. Enables Claude to "remember" things
+ * explicitly and retrieve them later.
+ */
+import { nanoid } from "nanoid";
+export class WorkingMemoryStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Store a fact/decision/context in working memory
+     */
+    remember(options) {
+        const now = Date.now();
+        const id = nanoid();
+        const expiresAt = options.ttl ? now + options.ttl * 1000 : null;
+        // Check if key already exists for this project
+        const existing = this.db
+            .prepare("SELECT id FROM working_memory WHERE project_path = ? AND key = ?")
+            .get(options.projectPath, options.key);
+        if (existing) {
+            // Update existing
+            this.db
+                .prepare(`UPDATE working_memory
+           SET value = ?, context = ?, tags = ?, session_id = ?, updated_at = ?, expires_at = ?
+           WHERE id = ?`)
+                .run(options.value, options.context || null, options.tags ? JSON.stringify(options.tags) : null, options.sessionId || null, now, expiresAt, existing.id);
+            // Update FTS
+            this.updateFts(existing.id, options.key, options.value, options.context);
+            return this.getById(existing.id);
+        }
+        // Insert new
+        this.db
+            .prepare(`INSERT INTO working_memory
+         (id, key, value, context, tags, session_id, project_path, created_at, updated_at, expires_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(id, options.key, options.value, options.context || null, options.tags ? JSON.stringify(options.tags) : null, options.sessionId || null, options.projectPath, now, now, expiresAt);
+        // Insert into FTS
+        this.insertFts(id, options.key, options.value, options.context);
+        return {
+            id,
+            key: options.key,
+            value: options.value,
+            context: options.context,
+            tags: options.tags || [],
+            sessionId: options.sessionId,
+            projectPath: options.projectPath,
+            createdAt: now,
+            updatedAt: now,
+            expiresAt: expiresAt || undefined,
+        };
+    }
+    /**
+     * Recall a specific item by key
+     */
+    recall(key, projectPath) {
+        // First, clean up expired items
+        this.cleanupExpired();
+        const row = this.db
+            .prepare(`SELECT * FROM working_memory
+         WHERE project_path = ? AND key = ?
+         AND (expires_at IS NULL OR expires_at > ?)`)
+            .get(projectPath, key, Date.now());
+        if (!row) {
+            return null;
+        }
+        return this.rowToItem(row);
+    }
+    /**
+     * Recall items matching options
+     */
+    recallMany(options) {
+        // First, clean up expired items
+        if (!options.includeExpired) {
+            this.cleanupExpired();
+        }
+        let sql = "SELECT * FROM working_memory WHERE 1=1";
+        const params = [];
+        if (options.projectPath) {
+            sql += " AND project_path = ?";
+            params.push(options.projectPath);
+        }
+        if (options.key) {
+            sql += " AND key = ?";
+            params.push(options.key);
+        }
+        if (options.sessionId) {
+            sql += " AND session_id = ?";
+            params.push(options.sessionId);
+        }
+        if (!options.includeExpired) {
+            sql += " AND (expires_at IS NULL OR expires_at > ?)";
+            params.push(Date.now());
+        }
+        sql += " ORDER BY updated_at DESC";
+        const rows = this.db.prepare(sql).all(...params);
+        // Filter by tags in JavaScript (JSON array in SQLite)
+        let items = rows.map((row) => this.rowToItem(row));
+        const filterTags = options.tags;
+        if (filterTags && filterTags.length > 0) {
+            items = items.filter((item) => filterTags.some((tag) => item.tags.includes(tag)));
+        }
+        return items;
+    }
+    /**
+     * Semantic search across working memory using FTS
+     */
+    recallRelevant(options) {
+        // First, clean up expired items
+        this.cleanupExpired();
+        const limit = options.limit || 10;
+        // Use FTS5 for text search
+        const ftsResults = this.db
+            .prepare(`SELECT wm.*,
+                bm25(working_memory_fts) as rank
+         FROM working_memory_fts fts
+         JOIN working_memory wm ON wm.id = fts.id
+         WHERE working_memory_fts MATCH ?
+         AND wm.project_path = ?
+         AND (wm.expires_at IS NULL OR wm.expires_at > ?)
+         ORDER BY rank
+         LIMIT ?`)
+            .all(this.escapeFtsQuery(options.query), options.projectPath, Date.now(), limit);
+        return ftsResults.map((row) => ({
+            ...this.rowToItem(row),
+            similarity: this.normalizeRank(row.rank),
+        }));
+    }
+    /**
+     * Forget (delete) a memory item by key
+     */
+    forget(key, projectPath) {
+        const item = this.recall(key, projectPath);
+        if (!item) {
+            return false;
+        }
+        // Delete from FTS first
+        this.deleteFts(item.id);
+        // Delete from main table
+        const result = this.db
+            .prepare("DELETE FROM working_memory WHERE project_path = ? AND key = ?")
+            .run(projectPath, key);
+        return result.changes > 0;
+    }
+    /**
+     * Forget all items for a project
+     */
+    forgetAll(projectPath) {
+        // Get all IDs first for FTS cleanup
+        const items = this.db
+            .prepare("SELECT id FROM working_memory WHERE project_path = ?")
+            .all(projectPath);
+        for (const item of items) {
+            this.deleteFts(item.id);
+        }
+        const result = this.db
+            .prepare("DELETE FROM working_memory WHERE project_path = ?")
+            .run(projectPath);
+        return result.changes;
+    }
+    /**
+     * List all memory items for a project
+     */
+    list(projectPath, options) {
+        // First, clean up expired items
+        this.cleanupExpired();
+        const limit = options?.limit || 100;
+        const offset = options?.offset || 0;
+        const rows = this.db
+            .prepare(`SELECT * FROM working_memory
+         WHERE project_path = ?
+         AND (expires_at IS NULL OR expires_at > ?)
+         ORDER BY updated_at DESC
+         LIMIT ? OFFSET ?`)
+            .all(projectPath, Date.now(), limit, offset);
+        let items = rows.map((row) => this.rowToItem(row));
+        // Filter by tags if specified
+        const listTags = options?.tags;
+        if (listTags && listTags.length > 0) {
+            items = items.filter((item) => listTags.some((tag) => item.tags.includes(tag)));
+        }
+        return items;
+    }
+    /**
+     * Get count of items for a project
+     */
+    count(projectPath) {
+        const result = this.db
+            .prepare(`SELECT COUNT(*) as count FROM working_memory
+         WHERE project_path = ?
+         AND (expires_at IS NULL OR expires_at > ?)`)
+            .get(projectPath, Date.now());
+        return result.count;
+    }
+    /**
+     * Get a single item by ID
+     */
+    getById(id) {
+        const row = this.db
+            .prepare("SELECT * FROM working_memory WHERE id = ?")
+            .get(id);
+        if (!row) {
+            return null;
+        }
+        return this.rowToItem(row);
+    }
+    /**
+     * Convert database row to WorkingMemoryItem
+     */
+    rowToItem(row) {
+        return {
+            id: row.id,
+            key: row.key,
+            value: row.value,
+            context: row.context || undefined,
+            tags: row.tags ? JSON.parse(row.tags) : [],
+            sessionId: row.session_id || undefined,
+            projectPath: row.project_path,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+            expiresAt: row.expires_at || undefined,
+        };
+    }
+    /**
+     * Clean up expired items
+     */
+    cleanupExpired() {
+        const now = Date.now();
+        // Get expired IDs for FTS cleanup
+        const expired = this.db
+            .prepare("SELECT id FROM working_memory WHERE expires_at IS NOT NULL AND expires_at <= ?")
+            .all(now);
+        for (const item of expired) {
+            this.deleteFts(item.id);
+        }
+        // Delete expired items
+        this.db
+            .prepare("DELETE FROM working_memory WHERE expires_at IS NOT NULL AND expires_at <= ?")
+            .run(now);
+    }
+    /**
+     * Insert into FTS index
+     */
+    insertFts(id, key, value, context) {
+        try {
+            this.db
+                .prepare(`INSERT INTO working_memory_fts(id, key, value, context)
+           VALUES (?, ?, ?, ?)`)
+                .run(id, key, value, context || "");
+        }
+        catch (_error) {
+            // FTS insert can fail if table doesn't exist yet
+            // Silently ignore - search will fall back to non-FTS
+        }
+    }
+    /**
+     * Update FTS index
+     */
+    updateFts(id, key, value, context) {
+        try {
+            // Delete old entry
+            this.deleteFts(id);
+            // Insert new entry
+            this.insertFts(id, key, value, context);
+        }
+        catch (_error) {
+            // Silently ignore FTS errors
+        }
+    }
+    /**
+     * Delete from FTS index
+     */
+    deleteFts(id) {
+        try {
+            this.db
+                .prepare("DELETE FROM working_memory_fts WHERE id = ?")
+                .run(id);
+        }
+        catch (_error) {
+            // Silently ignore FTS errors
+        }
+    }
+    /**
+     * Escape FTS query for safe matching
+     */
+    escapeFtsQuery(query) {
+        // Escape special FTS5 characters and wrap in quotes for phrase matching
+        // Also handle simple word queries
+        const words = query
+            .split(/\s+/)
+            .filter((w) => w.length > 0)
+            .map((word) => {
+            // Remove special characters that could break FTS
+            const cleaned = word.replace(/['"(){}[\]:*^~\\-]/g, "");
+            return cleaned;
+        })
+            .filter((w) => w.length > 0);
+        if (words.length === 0) {
+            return '""';
+        }
+        // Join with OR for broad matching
+        return words.map((w) => `"${w}"`).join(" OR ");
+    }
+    /**
+     * Normalize BM25 rank to a similarity score (0-1)
+     * BM25 returns negative scores, lower is better
+     */
+    normalizeRank(rank) {
+        // Convert negative BM25 score to positive similarity
+        // Typical BM25 scores range from -50 to 0
+        return Math.max(0, Math.min(1, 1 + rank / 50));
+    }
+}
+//# sourceMappingURL=WorkingMemoryStore.js.map

package/dist/memory/WorkingMemoryStore.js.map

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

package/dist/memory/types.d.ts

@@ -0,0 +1,192 @@
+/**
+ * Working Memory Types
+ *
+ * Types for the working memory store that allows Claude to remember
+ * facts, decisions, and context across conversation boundaries.
+ */
+/**
+ * A single item stored in working memory
+ */
+export interface WorkingMemoryItem {
+    id: string;
+    key: string;
+    value: string;
+    context?: string;
+    tags: string[];
+    sessionId?: string;
+    projectPath: string;
+    createdAt: number;
+    updatedAt: number;
+    expiresAt?: number;
+}
+/**
+ * Database row representation of a working memory item
+ */
+export interface WorkingMemoryRow {
+    id: string;
+    key: string;
+    value: string;
+    context: string | null;
+    tags: string | null;
+    session_id: string | null;
+    project_path: string;
+    created_at: number;
+    updated_at: number;
+    expires_at: number | null;
+    embedding: Buffer | null;
+}
+/**
+ * Options for storing a memory item
+ */
+export interface RememberOptions {
+    key: string;
+    value: string;
+    context?: string;
+    tags?: string[];
+    sessionId?: string;
+    projectPath: string;
+    ttl?: number;
+}
+/**
+ * Options for recalling memory items
+ */
+export interface RecallOptions {
+    key?: string;
+    tags?: string[];
+    sessionId?: string;
+    projectPath?: string;
+    includeExpired?: boolean;
+}
+/**
+ * Options for semantic recall
+ */
+export interface SemanticRecallOptions {
+    query: string;
+    projectPath: string;
+    limit?: number;
+    threshold?: number;
+}
+/**
+ * Result from semantic recall with similarity score
+ */
+export interface SemanticRecallResult extends WorkingMemoryItem {
+    similarity: number;
+}
+/**
+ * Session handoff document for transferring context between conversations
+ */
+export interface SessionHandoff {
+    id: string;
+    fromSessionId: string;
+    projectPath: string;
+    createdAt: number;
+    decisions: HandoffDecision[];
+    activeFiles: ActiveFile[];
+    pendingTasks: PendingTask[];
+    workingMemory: WorkingMemoryItem[];
+    contextSummary: string;
+    resumedBy?: string;
+    resumedAt?: number;
+}
+/**
+ * Decision included in a handoff
+ */
+export interface HandoffDecision {
+    id: string;
+    text: string;
+    rationale?: string;
+    context?: string;
+    timestamp: number;
+}
+/**
+ * File that was actively worked on
+ */
+export interface ActiveFile {
+    path: string;
+    lastAction: "read" | "edit" | "create" | "delete";
+    summary?: string;
+    timestamp: number;
+}
+/**
+ * Task that was in progress
+ */
+export interface PendingTask {
+    description: string;
+    status: "in_progress" | "blocked" | "pending";
+    context?: string;
+}
+/**
+ * Database row for session handoff
+ */
+export interface SessionHandoffRow {
+    id: string;
+    from_session_id: string;
+    project_path: string;
+    created_at: number;
+    handoff_data: string;
+    resumed_by_session_id: string | null;
+    resumed_at: number | null;
+}
+/**
+ * Live checkpoint for real-time session tracking
+ */
+export interface SessionCheckpoint {
+    id: string;
+    sessionId: string;
+    projectPath: string;
+    checkpointNumber: number;
+    createdAt: number;
+    decisions: HandoffDecision[];
+    activeFiles: ActiveFile[];
+    taskState?: Record<string, unknown>;
+    contextSummary: string;
+}
+/**
+ * Database row for session checkpoint
+ */
+export interface SessionCheckpointRow {
+    id: string;
+    session_id: string;
+    project_path: string;
+    checkpoint_number: number;
+    created_at: number;
+    decisions: string;
+    active_files: string;
+    task_state: string | null;
+    context_summary: string;
+}
+/**
+ * Configuration for real-time watching
+ */
+export interface RealtimeConfig {
+    enabled: boolean;
+    watchPaths: string[];
+    extractionInterval: number;
+    checkpointInterval: number;
+    autoRemember: {
+        decisions: boolean;
+        fileEdits: boolean;
+        errors: boolean;
+    };
+}
+/**
+ * Context injection result
+ */
+export interface InjectedContext {
+    handoff?: SessionHandoff;
+    decisions: HandoffDecision[];
+    memory: WorkingMemoryItem[];
+    recentFiles: ActiveFile[];
+    summary: string;
+    tokenEstimate: number;
+}
+/**
+ * Options for context injection
+ */
+export interface ContextInjectionOptions {
+    query?: string;
+    projectPath: string;
+    maxTokens?: number;
+    sources?: Array<"history" | "decisions" | "memory" | "handoffs">;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/memory/types.d.ts.map

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

package/dist/memory/types.js

@@ -0,0 +1,8 @@
+/**
+ * Working Memory Types
+ *
+ * Types for the working memory store that allows Claude to remember
+ * facts, decisions, and context across conversation boundaries.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/memory/types.js.map

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

package/dist/parsers/CodexConversationParser.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Codex Conversation Parser for MCP integration.
+ *
+ * This parser reads conversation history from Codex's storage location
+ * (~/.codex/sessions) and converts it to the same format as ConversationParser.
+ *
+ * Codex stores conversations in a date-hierarchical structure:
+ * ~/.codex/sessions/YYYY/MM/DD/rollout-{timestamp}-{uuid}.jsonl
+ *
+ * Each line in a Codex session file has the structure:
+ * {
+ *   timestamp: string,
+ *   type: "session_meta" | "response_item" | "event_msg" | "turn_context",
+ *   payload: { ... }
+ * }
+ *
+ * @example
+ * ```typescript
+ * const parser = new CodexConversationParser();
+ * const result = parser.parseSessions('/Users/username/.codex');
+ * console.error(`Parsed ${result.conversations.length} Codex sessions`);
+ * ```
+ */
+import type { ParseResult } from "./ConversationParser.js";
+/**
+ * Parser for Codex conversation history.
+ *
+ * Converts Codex session files into the same format as ConversationParser
+ * so they can be stored in the same database and searched together.
+ */
+export declare class CodexConversationParser {
+    /**
+     * Parse all Codex sessions.
+     *
+     * Recursively scans the sessions directory for JSONL files and parses them.
+     *
+     * @param codexPath - Path to Codex home directory (default: ~/.codex)
+     * @param sessionId - Optional specific session ID to parse
+     * @returns ParseResult with all extracted entities
+     */
+    parseSession(codexPath: string, sessionId?: string, lastIndexedMs?: number): ParseResult;
+    /**
+     * Recursively find all .jsonl session files.
+     */
+    private findSessionFiles;
+    /**
+     * Parse a single Codex session file.
+     */
+    private parseSessionFile;
+}
+//# sourceMappingURL=CodexConversationParser.d.ts.map

package/dist/parsers/CodexConversationParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodexConversationParser.d.ts","sourceRoot":"","sources":["../../src/parsers/CodexConversationParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,KAAK,EAOV,WAAW,EACZ,MAAM,yBAAyB,CAAC;AAwCjC;;;;;GAKG;AACH,qBAAa,uBAAuB;IAClC;;;;;;;;OAQG;IACH,YAAY,CACV,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,GACrB,WAAW;IA0Fd;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuBxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CA6KzB"}