@londer/cortex 0.1.0

package/dist/storage/sqlite.js

@@ -0,0 +1,162 @@
+import Database from 'better-sqlite3';
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { loadConfig } from '../config.js';
+export class SQLiteStore {
+    db;
+    constructor(dbPath) {
+        const path = dbPath ?? loadConfig().sqlitePath;
+        mkdirSync(dirname(path), { recursive: true });
+        this.db = new Database(path);
+    }
+    init() {
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('foreign_keys = ON');
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS memories (
+        id TEXT PRIMARY KEY,
+        content TEXT NOT NULL,
+        type TEXT NOT NULL,
+        project TEXT,
+        tags TEXT,
+        entities TEXT,
+        source TEXT,
+        created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+        updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+        is_deleted INTEGER DEFAULT 0
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_memories_project ON memories(project);
+      CREATE INDEX IF NOT EXISTS idx_memories_type ON memories(type);
+      CREATE INDEX IF NOT EXISTS idx_memories_created ON memories(created_at);
+
+      CREATE TABLE IF NOT EXISTS sessions (
+        id TEXT PRIMARY KEY,
+        project TEXT,
+        started_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+        last_active DATETIME,
+        tool_calls INTEGER DEFAULT 0
+      );
+    `);
+        // Phase 2: Add new columns (safe to run multiple times)
+        this.migratePhase2();
+    }
+    migratePhase2() {
+        // Add new columns if they don't exist
+        const columns = this.db.pragma('table_info(memories)');
+        const existingColumns = new Set(columns.map(c => c.name));
+        if (!existingColumns.has('source_type')) {
+            this.db.exec(`ALTER TABLE memories ADD COLUMN source_type TEXT DEFAULT 'manual'`);
+        }
+        if (!existingColumns.has('consolidated_from')) {
+            this.db.exec(`ALTER TABLE memories ADD COLUMN consolidated_from TEXT DEFAULT NULL`);
+        }
+        if (!existingColumns.has('extraction_confidence')) {
+            this.db.exec(`ALTER TABLE memories ADD COLUMN extraction_confidence REAL DEFAULT NULL`);
+        }
+        if (!existingColumns.has('extraction_tier')) {
+            this.db.exec(`ALTER TABLE memories ADD COLUMN extraction_tier INTEGER DEFAULT NULL`);
+        }
+        // Create consolidation_log table
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS consolidation_log (
+        id TEXT PRIMARY KEY,
+        action TEXT NOT NULL,
+        reason TEXT,
+        source_ids TEXT NOT NULL,
+        result_id TEXT,
+        mode TEXT NOT NULL,
+        created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+      );
+    `);
+    }
+    insertMemory(memory) {
+        const stmt = this.db.prepare(`
+      INSERT INTO memories (id, content, type, project, tags, entities, source, created_at, updated_at, is_deleted,
+                           source_type, consolidated_from, extraction_confidence, extraction_tier)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        stmt.run(memory.id, memory.content, memory.type, memory.project, JSON.stringify(memory.tags), JSON.stringify(memory.entities), memory.source, memory.created_at, memory.updated_at, memory.is_deleted, memory.source_type ?? 'manual', memory.consolidated_from ?? null, memory.extraction_confidence ?? null, memory.extraction_tier ?? null);
+    }
+    getMemory(id) {
+        const stmt = this.db.prepare('SELECT * FROM memories WHERE id = ? AND is_deleted = 0');
+        const row = stmt.get(id);
+        return row ? this.rowToMemory(row) : null;
+    }
+    getMemoriesByIds(ids) {
+        if (ids.length === 0)
+            return [];
+        const placeholders = ids.map(() => '?').join(',');
+        const stmt = this.db.prepare(`SELECT * FROM memories WHERE id IN (${placeholders}) AND is_deleted = 0`);
+        const rows = stmt.all(...ids);
+        return rows.map(row => this.rowToMemory(row));
+    }
+    getRecentMemories(project, limit) {
+        if (project) {
+            const stmt = this.db.prepare('SELECT * FROM memories WHERE project = ? AND is_deleted = 0 ORDER BY created_at DESC LIMIT ?');
+            return stmt.all(project, limit).map(row => this.rowToMemory(row));
+        }
+        const stmt = this.db.prepare('SELECT * FROM memories WHERE is_deleted = 0 ORDER BY created_at DESC LIMIT ?');
+        return stmt.all(limit).map(row => this.rowToMemory(row));
+    }
+    searchByProject(project, limit) {
+        const stmt = this.db.prepare('SELECT * FROM memories WHERE project = ? AND is_deleted = 0 ORDER BY created_at DESC LIMIT ?');
+        return stmt.all(project, limit).map(row => this.rowToMemory(row));
+    }
+    softDelete(id) {
+        const stmt = this.db.prepare('UPDATE memories SET is_deleted = 1, updated_at = CURRENT_TIMESTAMP WHERE id = ?');
+        stmt.run(id);
+    }
+    deleteByProject(project) {
+        const stmt = this.db.prepare('DELETE FROM memories WHERE project = ?');
+        stmt.run(project);
+    }
+    getStats() {
+        const memoriesCount = this.db.prepare('SELECT COUNT(*) as count FROM memories WHERE is_deleted = 0').get().count;
+        // Count unique entities across all memories
+        const rows = this.db.prepare('SELECT entities FROM memories WHERE is_deleted = 0 AND entities IS NOT NULL').all();
+        const entitySet = new Set();
+        for (const row of rows) {
+            try {
+                const entities = JSON.parse(row.entities);
+                for (const e of entities)
+                    entitySet.add(e);
+            }
+            catch { /* skip invalid */ }
+        }
+        return {
+            totalMemories: memoriesCount,
+            totalEntities: entitySet.size,
+            totalRelationships: 0, // Neo4j tracks relationships; approximation is fine here
+        };
+    }
+    insertConsolidationLog(entry) {
+        const stmt = this.db.prepare(`
+      INSERT INTO consolidation_log (id, action, reason, source_ids, result_id, mode, created_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `);
+        stmt.run(entry.id, entry.action, entry.reason, JSON.stringify(entry.source_ids), entry.result_id, entry.mode, entry.created_at);
+    }
+    close() {
+        this.db.close();
+    }
+    rowToMemory(row) {
+        return {
+            id: row.id,
+            content: row.content,
+            type: row.type,
+            project: row.project ?? null,
+            tags: JSON.parse(row.tags ?? '[]'),
+            entities: JSON.parse(row.entities ?? '[]'),
+            source: row.source ?? null,
+            created_at: row.created_at,
+            updated_at: row.updated_at,
+            is_deleted: row.is_deleted,
+            source_type: row.source_type ?? null,
+            consolidated_from: row.consolidated_from ?? null,
+            extraction_confidence: row.extraction_confidence ?? null,
+            extraction_tier: row.extraction_tier ?? null,
+        };
+    }
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/storage/sqlite.js.map

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

package/dist/templates/claude-instructions.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Claude Code instruction templates for Cortex integration.
+ *
+ * PROJECT_INSTRUCTIONS — appended to a project's CLAUDE.md
+ * GLOBAL_INSTRUCTIONS  — written to ~/.claude/CLAUDE.md
+ */
+export declare const START_MARKER = "<!-- cortex-instructions-start -->";
+export declare const END_MARKER = "<!-- cortex-instructions-end -->";
+export declare const PROJECT_INSTRUCTIONS = "<!-- cortex-instructions-start -->\n## Memory System (Cortex MCP)\n\nYou have access to a persistent memory system called Cortex, connected via MCP. It stores knowledge across sessions and projects. **Use it proactively without being asked.**\n\n### Automatic behaviours\n\n**At the start of every non-trivial task:**\n1. Call `memory_context` with a description of what you're about to do and the current project name.\n2. Read the returned context. Let it inform your approach \u2014 don't ignore it.\n\n**During work, store memories when you encounter:**\n- An architectural or design decision (type: `decision`) \u2014 include the reasoning, not just the outcome.\n- A bug and its root cause (type: `insight`) \u2014 future you will thank past you.\n- A pattern or convention being used in the project (type: `pattern`).\n- A useful code snippet worth reusing (type: `snippet`).\n- A factual piece of project knowledge (type: `fact`).\n- A gotcha, caveat, or non-obvious behaviour (type: `note`).\n\n**When you discover relationships between components:**\n- Call `memory_relate` to connect entities in the knowledge graph.\n- Use meaningful relation types: `DEPENDS_ON`, `USES`, `PART_OF`, `RELATED_TO`, `IMPLEMENTS`, `CALLS`.\n\n### Available tools\n\n| Tool | When to use |\n|------|-------------|\n| `memory_store` | Store a specific piece of knowledge with type, tags, and entities. |\n| `memory_search` | Find memories by semantic similarity. Use when you need specific past knowledge. |\n| `memory_relate` | Connect two entities with a typed relationship. |\n| `memory_graph_query` | Explore what's connected to an entity in the knowledge graph. |\n| `memory_context` | Get the best available context for a task. Call this at the start of work. |\n| `memory_forget` | Remove outdated or incorrect memories. Requires `confirm: true`. |\n| `memory_ingest` | Process a large block of text (meeting notes, docs) into memories. |\n| `memory_consolidate` | Merge redundant memories. Use `dry_run: true` to preview first. |\n| `memory_config` | Check config, storage health, stats. Set API key at runtime. |\n\n### Extraction tiers\n\nCortex extracts entities using a tiered system that adapts to available resources:\n\n- **Tier 1 (Regex):** Always available. Detects snake_case, camelCase, PascalCase identifiers and basic verb patterns.\n- **Tier 2 (NLP):** Always available. Linguistic analysis with embedding similarity for smarter entity and relationship detection.\n- **Tier 3 (LLM):** Requires Anthropic API key. Full semantic understanding of natural language entity names and complex relationships.\n\nThe active tier is selected automatically. Check it with `memory_config({ action: 'get' })`. To unlock Tier 3, set an API key: `memory_config({ action: 'set', key: 'anthropic_api_key', value: 'sk-ant-...' })`.\n\n### What NOT to store\n\n- Code patterns, conventions, architecture, file paths, or project structure \u2014 these can be derived by reading the current project state.\n- Git history, recent changes, or who-changed-what \u2014 `git log` / `git blame` are authoritative.\n- Debugging solutions or fix recipes \u2014 the fix is in the code; the commit message has the context.\n- Anything already documented in CLAUDE.md files.\n- Ephemeral task details: in-progress work, temporary state, current conversation context.\n\n### Memory search before assumptions\n\nIf you're unsure about a project's conventions, past decisions, or how something works \u2014 search Cortex first (`memory_search`), then check the codebase, then ask the user. In that order.\n\n### Always include\n\n- The `project` parameter \u2014 infer it from the current working directory or ask if unclear.\n- Relevant `entities` as snake_case identifiers when storing memories.\n- Meaningful `tags` for discoverability.\n<!-- cortex-instructions-end -->";
+export declare const GLOBAL_INSTRUCTIONS = "<!-- cortex-instructions-start -->\n## Memory System (Cortex)\n\nYou have access to a persistent memory system called Cortex, connected via MCP. It stores knowledge across sessions and projects. **Use it proactively without being asked.**\n\n### Automatic behaviours\n\n**At the start of every non-trivial task:**\n1. Call `memory_context` with a description of what you're about to do and the current project name.\n2. Read the returned context. Let it inform your approach \u2014 don't ignore it.\n\n**During work, store memories when you encounter:**\n- An architectural or design decision (type: `decision`) \u2014 include the reasoning, not just the outcome.\n- A bug and its root cause (type: `insight`) \u2014 future you will thank past you.\n- A pattern or convention being used in the project (type: `pattern`).\n- A useful code snippet worth reusing (type: `snippet`).\n- A factual piece of project knowledge (type: `fact`).\n- A gotcha, caveat, or non-obvious behaviour (type: `note`).\n\n**When you discover relationships between components:**\n- Call `memory_relate` to connect entities in the knowledge graph.\n- Use meaningful relation types: `DEPENDS_ON`, `USES`, `PART_OF`, `RELATED_TO`, `IMPLEMENTS`, `CALLS`.\n\n### What NOT to store\n- Trivial information (file listed, routine shell commands).\n- Information already in the codebase (don't duplicate what's in README, package.json, etc.).\n- Temporary debugging steps that won't matter tomorrow.\n\n### Always include\n- The `project` parameter \u2014 infer it from the current working directory or ask if unclear.\n- Relevant `entities` as snake_case identifiers.\n- Meaningful `tags` for discoverability.\n\n### Memory search before assumptions\nIf you're unsure about a project's conventions, past decisions, or how something works \u2014 search Cortex first (`memory_search`), then check the codebase, then ask the user. In that order.\n<!-- cortex-instructions-end -->";
+//# sourceMappingURL=claude-instructions.d.ts.map

package/dist/templates/claude-instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-instructions.d.ts","sourceRoot":"","sources":["../../src/templates/claude-instructions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,YAAY,uCAAuC,CAAC;AACjE,eAAO,MAAM,UAAU,qCAAqC,CAAC;AAE7D,eAAO,MAAM,oBAAoB,+wHAgEnB,CAAC;AAEf,eAAO,MAAM,mBAAmB,65DAmClB,CAAC"}

package/dist/templates/claude-instructions.js

@@ -0,0 +1,110 @@
+/**
+ * Claude Code instruction templates for Cortex integration.
+ *
+ * PROJECT_INSTRUCTIONS — appended to a project's CLAUDE.md
+ * GLOBAL_INSTRUCTIONS  — written to ~/.claude/CLAUDE.md
+ */
+export const START_MARKER = '<!-- cortex-instructions-start -->';
+export const END_MARKER = '<!-- cortex-instructions-end -->';
+export const PROJECT_INSTRUCTIONS = `${START_MARKER}
+## Memory System (Cortex MCP)
+
+You have access to a persistent memory system called Cortex, connected via MCP. It stores knowledge across sessions and projects. **Use it proactively without being asked.**
+
+### Automatic behaviours
+
+**At the start of every non-trivial task:**
+1. Call \`memory_context\` with a description of what you're about to do and the current project name.
+2. Read the returned context. Let it inform your approach — don't ignore it.
+
+**During work, store memories when you encounter:**
+- An architectural or design decision (type: \`decision\`) — include the reasoning, not just the outcome.
+- A bug and its root cause (type: \`insight\`) — future you will thank past you.
+- A pattern or convention being used in the project (type: \`pattern\`).
+- A useful code snippet worth reusing (type: \`snippet\`).
+- A factual piece of project knowledge (type: \`fact\`).
+- A gotcha, caveat, or non-obvious behaviour (type: \`note\`).
+
+**When you discover relationships between components:**
+- Call \`memory_relate\` to connect entities in the knowledge graph.
+- Use meaningful relation types: \`DEPENDS_ON\`, \`USES\`, \`PART_OF\`, \`RELATED_TO\`, \`IMPLEMENTS\`, \`CALLS\`.
+
+### Available tools
+
+| Tool | When to use |
+|------|-------------|
+| \`memory_store\` | Store a specific piece of knowledge with type, tags, and entities. |
+| \`memory_search\` | Find memories by semantic similarity. Use when you need specific past knowledge. |
+| \`memory_relate\` | Connect two entities with a typed relationship. |
+| \`memory_graph_query\` | Explore what's connected to an entity in the knowledge graph. |
+| \`memory_context\` | Get the best available context for a task. Call this at the start of work. |
+| \`memory_forget\` | Remove outdated or incorrect memories. Requires \`confirm: true\`. |
+| \`memory_ingest\` | Process a large block of text (meeting notes, docs) into memories. |
+| \`memory_consolidate\` | Merge redundant memories. Use \`dry_run: true\` to preview first. |
+| \`memory_config\` | Check config, storage health, stats. Set API key at runtime. |
+
+### Extraction tiers
+
+Cortex extracts entities using a tiered system that adapts to available resources:
+
+- **Tier 1 (Regex):** Always available. Detects snake_case, camelCase, PascalCase identifiers and basic verb patterns.
+- **Tier 2 (NLP):** Always available. Linguistic analysis with embedding similarity for smarter entity and relationship detection.
+- **Tier 3 (LLM):** Requires Anthropic API key. Full semantic understanding of natural language entity names and complex relationships.
+
+The active tier is selected automatically. Check it with \`memory_config({ action: 'get' })\`. To unlock Tier 3, set an API key: \`memory_config({ action: 'set', key: 'anthropic_api_key', value: 'sk-ant-...' })\`.
+
+### What NOT to store
+
+- Code patterns, conventions, architecture, file paths, or project structure — these can be derived by reading the current project state.
+- Git history, recent changes, or who-changed-what — \`git log\` / \`git blame\` are authoritative.
+- Debugging solutions or fix recipes — the fix is in the code; the commit message has the context.
+- Anything already documented in CLAUDE.md files.
+- Ephemeral task details: in-progress work, temporary state, current conversation context.
+
+### Memory search before assumptions
+
+If you're unsure about a project's conventions, past decisions, or how something works — search Cortex first (\`memory_search\`), then check the codebase, then ask the user. In that order.
+
+### Always include
+
+- The \`project\` parameter — infer it from the current working directory or ask if unclear.
+- Relevant \`entities\` as snake_case identifiers when storing memories.
+- Meaningful \`tags\` for discoverability.
+${END_MARKER}`;
+export const GLOBAL_INSTRUCTIONS = `${START_MARKER}
+## Memory System (Cortex)
+
+You have access to a persistent memory system called Cortex, connected via MCP. It stores knowledge across sessions and projects. **Use it proactively without being asked.**
+
+### Automatic behaviours
+
+**At the start of every non-trivial task:**
+1. Call \`memory_context\` with a description of what you're about to do and the current project name.
+2. Read the returned context. Let it inform your approach — don't ignore it.
+
+**During work, store memories when you encounter:**
+- An architectural or design decision (type: \`decision\`) — include the reasoning, not just the outcome.
+- A bug and its root cause (type: \`insight\`) — future you will thank past you.
+- A pattern or convention being used in the project (type: \`pattern\`).
+- A useful code snippet worth reusing (type: \`snippet\`).
+- A factual piece of project knowledge (type: \`fact\`).
+- A gotcha, caveat, or non-obvious behaviour (type: \`note\`).
+
+**When you discover relationships between components:**
+- Call \`memory_relate\` to connect entities in the knowledge graph.
+- Use meaningful relation types: \`DEPENDS_ON\`, \`USES\`, \`PART_OF\`, \`RELATED_TO\`, \`IMPLEMENTS\`, \`CALLS\`.
+
+### What NOT to store
+- Trivial information (file listed, routine shell commands).
+- Information already in the codebase (don't duplicate what's in README, package.json, etc.).
+- Temporary debugging steps that won't matter tomorrow.
+
+### Always include
+- The \`project\` parameter — infer it from the current working directory or ask if unclear.
+- Relevant \`entities\` as snake_case identifiers.
+- Meaningful \`tags\` for discoverability.
+
+### Memory search before assumptions
+If you're unsure about a project's conventions, past decisions, or how something works — search Cortex first (\`memory_search\`), then check the codebase, then ask the user. In that order.
+${END_MARKER}`;
+//# sourceMappingURL=claude-instructions.js.map

package/dist/templates/claude-instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-instructions.js","sourceRoot":"","sources":["../../src/templates/claude-instructions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,oCAAoC,CAAC;AACjE,MAAM,CAAC,MAAM,UAAU,GAAG,kCAAkC,CAAC;AAE7D,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgEjD,UAAU,EAAE,CAAC;AAEf,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmChD,UAAU,EAAE,CAAC"}

package/dist/tools/config.d.ts

@@ -0,0 +1,21 @@
+import type { MemoryConfigInput, MemoryConfigOutput } from '../types/index.js';
+import type { RuntimeConfigStore } from '../config-store.js';
+import type { AnthropicClient } from '../llm/anthropic-client.js';
+import type { EntityExtractor } from '../extraction/extractor.js';
+import type { SQLiteStore } from '../storage/sqlite.js';
+import type { QdrantStore } from '../storage/qdrant.js';
+import type { Neo4jStore } from '../storage/neo4j.js';
+import type { Consolidator } from '../consolidation/consolidator.js';
+import type { CortexConfig } from '../config.js';
+export interface ConfigToolDeps {
+    configStore: RuntimeConfigStore;
+    llmClient: AnthropicClient;
+    extractor: EntityExtractor;
+    sqlite: SQLiteStore;
+    qdrant: QdrantStore;
+    neo4j: Neo4jStore;
+    consolidator: Consolidator | null;
+    baseConfig: CortexConfig;
+}
+export declare function handleMemoryConfig(args: MemoryConfigInput, deps: ConfigToolDeps): Promise<MemoryConfigOutput>;
+//# sourceMappingURL=config.d.ts.map

package/dist/tools/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/tools/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAkB,MAAM,mBAAmB,CAAC;AAC/F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,kBAAkB,CAAC;IAChC,SAAS,EAAE,eAAe,CAAC;IAC3B,SAAS,EAAE,eAAe,CAAC;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC;IAClB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,YAAY,CAAC;CAC1B;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,iBAAiB,EACvB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAgB7B"}

package/dist/tools/config.js

@@ -0,0 +1,96 @@
+export async function handleMemoryConfig(args, deps) {
+    if (args.action === 'get') {
+        return getConfig(deps);
+    }
+    if (args.action === 'set') {
+        if (!args.key || args.value === undefined) {
+            return {
+                config: null,
+                error: 'Both key and value are required for set action',
+            };
+        }
+        return setConfig(args.key, args.value, deps);
+    }
+    return { config: null, error: `Unknown action: ${args.action}` };
+}
+async function getConfig(deps) {
+    const { llmClient, extractor, sqlite, qdrant, neo4j, baseConfig } = deps;
+    // Check storage connectivity
+    let qdrantStatus = 'disconnected';
+    let neo4jStatus = 'disconnected';
+    try {
+        if (await qdrant.healthCheck())
+            qdrantStatus = 'connected';
+    }
+    catch { /* disconnected */ }
+    try {
+        if (await neo4j.healthCheck())
+            neo4jStatus = 'connected';
+    }
+    catch { /* disconnected */ }
+    // Get stats
+    const stats = sqlite.getStats();
+    const usage = llmClient.getUsage();
+    return {
+        config: {
+            llm_available: llmClient.isAvailable(),
+            llm_model: llmClient.isAvailable() ? llmClient.getModel() : null,
+            extraction_tier: baseConfig.extractionTier,
+            active_extraction_tier: extractor.getActiveTier(),
+            auto_extract: baseConfig.autoExtract,
+            consolidation_enabled: baseConfig.consolidationEnabled,
+            consolidation_interval_ms: baseConfig.consolidationIntervalMs,
+            storage: {
+                qdrant: qdrantStatus,
+                neo4j: neo4jStatus,
+                sqlite: 'connected',
+            },
+            stats: {
+                total_memories: stats.totalMemories,
+                total_entities: stats.totalEntities,
+                total_relationships: stats.totalRelationships,
+                llm_tokens_used: { input: usage.inputTokens, output: usage.outputTokens },
+            },
+        },
+    };
+}
+async function setConfig(key, value, deps) {
+    const { configStore, llmClient, extractor, consolidator } = deps;
+    if (!configStore.isSettable(key)) {
+        return {
+            config: null,
+            error: `Key "${key}" is not settable at runtime`,
+        };
+    }
+    // Special handling for API key
+    if (key === 'anthropic_api_key') {
+        const valid = await llmClient.setApiKey(value);
+        if (!valid) {
+            return {
+                config: null,
+                error: 'Invalid API key — validation failed',
+            };
+        }
+    }
+    // Special handling for extraction tier
+    if (key === 'extraction_tier') {
+        const validTiers = ['auto', 'local-only', 'llm-preferred'];
+        if (!validTiers.includes(value)) {
+            return {
+                config: null,
+                error: `Invalid extraction tier. Must be one of: ${validTiers.join(', ')}`,
+            };
+        }
+        extractor.setExtractionTier(value);
+    }
+    const result = configStore.set(key, value);
+    return {
+        config: null,
+        updated: {
+            key,
+            previous: result.previous,
+            current: result.current,
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/tools/config.js.map

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

package/dist/tools/consolidate.d.ts

@@ -0,0 +1,4 @@
+import type { MemoryConsolidateInput, MemoryConsolidateOutput } from '../types/index.js';
+import type { Consolidator } from '../consolidation/consolidator.js';
+export declare function handleMemoryConsolidate(args: MemoryConsolidateInput, consolidator: Consolidator): Promise<MemoryConsolidateOutput>;
+//# sourceMappingURL=consolidate.d.ts.map

package/dist/tools/consolidate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidate.d.ts","sourceRoot":"","sources":["../../src/tools/consolidate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAErE,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,sBAAsB,EAC5B,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,uBAAuB,CAAC,CAgBlC"}

package/dist/tools/consolidate.js

@@ -0,0 +1,16 @@
+export async function handleMemoryConsolidate(args, consolidator) {
+    const maxClusters = args.max_clusters ?? 10;
+    const dryRun = args.dry_run ?? false;
+    const result = await consolidator.run(args.project, maxClusters, dryRun);
+    return {
+        merged: result.merged,
+        archived: result.archived,
+        contradictions: result.contradictions,
+        flagged: result.flagged,
+        unchanged: result.unchanged,
+        duration_ms: result.duration_ms,
+        mode: result.mode,
+        ...(dryRun && result.details ? { details: result.details } : {}),
+    };
+}
+//# sourceMappingURL=consolidate.js.map

package/dist/tools/consolidate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidate.js","sourceRoot":"","sources":["../../src/tools/consolidate.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAA4B,EAC5B,YAA0B;IAE1B,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;IAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC;IAErC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IAEzE,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjE,CAAC;AACJ,CAAC"}

package/dist/tools/context.d.ts

@@ -0,0 +1,8 @@
+import type { MemoryContextInput, MemoryContextOutput } from '../types/index.js';
+import type { Embedder } from '../embedding/embedder.js';
+import type { SQLiteStore } from '../storage/sqlite.js';
+import type { QdrantStore } from '../storage/qdrant.js';
+import type { Neo4jStore } from '../storage/neo4j.js';
+import type { EntityExtractor } from '../extraction/extractor.js';
+export declare function handleMemoryContext(args: MemoryContextInput, embedder: Embedder, sqlite: SQLiteStore, qdrant: QdrantStore, neo4j: Neo4jStore, currentProject?: string, extractor?: EntityExtractor): Promise<MemoryContextOutput>;
+//# sourceMappingURL=context.d.ts.map

package/dist/tools/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAGlE,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,kBAAkB,EACxB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,UAAU,EACjB,cAAc,CAAC,EAAE,MAAM,EACvB,SAAS,CAAC,EAAE,eAAe,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CA4E9B"}

package/dist/tools/context.js

@@ -0,0 +1,84 @@
+import { mergeAndRank, formatContext } from '../orchestration/ranker.js';
+export async function handleMemoryContext(args, embedder, sqlite, qdrant, neo4j, currentProject, extractor) {
+    const project = args.project ?? currentProject ?? null;
+    const maxTokens = args.max_tokens ?? 2000;
+    // 1. Semantic search (Tier 1)
+    const vector = await embedder.embed(args.description);
+    const semanticResults = await qdrant.search(vector, undefined, 20);
+    // Enrich semantic results with content from SQLite
+    const semanticIds = semanticResults.map(r => r.id);
+    const semanticMemories = sqlite.getMemoriesByIds(semanticIds);
+    const memMap = new Map(semanticMemories.map(m => [m.id, m]));
+    for (const r of semanticResults) {
+        const mem = memMap.get(r.id);
+        if (mem) {
+            r.content = mem.content;
+        }
+    }
+    // 2. Graph traversal (Tier 2) — use tiered extractor if available, else regex fallback
+    let entityNames;
+    if (extractor) {
+        const extraction = await extractor.extract(args.description, project ?? undefined);
+        entityNames = extraction.entities.map(e => e.name);
+    }
+    else {
+        entityNames = extractEntityNamesLegacy(args.description);
+    }
+    const graphMemories = [];
+    const seenGraphIds = new Set();
+    for (const entityName of entityNames) {
+        try {
+            const graphResult = await neo4j.traverse(entityName, 2);
+            const allEntities = new Set([entityName, ...graphResult.connections.map(c => c.entity)]);
+            for (const eName of allEntities) {
+                const memIds = await neo4j.findMemoriesByEntity(eName);
+                for (const memId of memIds) {
+                    if (seenGraphIds.has(memId))
+                        continue;
+                    seenGraphIds.add(memId);
+                    const mem = sqlite.getMemory(memId);
+                    if (mem) {
+                        graphMemories.push({ id: mem.id, content: mem.content, score: 0.7 });
+                    }
+                }
+            }
+        }
+        catch {
+            // Entity doesn't exist in graph — that's fine
+        }
+    }
+    // 3. Recent memories (Tier 3)
+    const recentMemories = sqlite.getRecentMemories(project, 10);
+    // 4. Merge, rank, deduplicate
+    const { ranked } = mergeAndRank(semanticResults, graphMemories, recentMemories, project, undefined, maxTokens);
+    // 5. Format as context block
+    const context = formatContext(ranked);
+    // 6. Build sources list
+    const sources = ranked.map(r => ({
+        id: r.id,
+        type: r.sourceType,
+        score: r.score,
+    }));
+    return { context, sources };
+}
+/**
+ * Legacy entity name extraction (fallback when extractor not available).
+ */
+function extractEntityNamesLegacy(description) {
+    const patterns = [
+        /[a-z][a-z0-9]*(?:_[a-z0-9]+)+/g,
+        /[a-z]+(?:[A-Z][a-z0-9]+)+/g,
+        /[A-Z][a-z0-9]+(?:[A-Z][a-z0-9]+)+/g,
+    ];
+    const entities = new Set();
+    for (const pattern of patterns) {
+        const matches = description.match(pattern);
+        if (matches) {
+            for (const m of matches) {
+                entities.add(m);
+            }
+        }
+    }
+    return Array.from(entities);
+}
+//# sourceMappingURL=context.js.map

package/dist/tools/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEzE,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAwB,EACxB,QAAkB,EAClB,MAAmB,EACnB,MAAmB,EACnB,KAAiB,EACjB,cAAuB,EACvB,SAA2B;IAE3B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,cAAc,IAAI,IAAI,CAAC;IACvD,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC;IAE1C,8BAA8B;IAC9B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtD,MAAM,eAAe,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IAEnE,mDAAmD;IACnD,MAAM,WAAW,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACnD,MAAM,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,KAAK,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7B,IAAI,GAAG,EAAE,CAAC;YACR,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,uFAAuF;IACvF,IAAI,WAAqB,CAAC;IAC1B,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,IAAI,SAAS,CAAC,CAAC;QACnF,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;SAAM,CAAC;QACN,WAAW,GAAG,wBAAwB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,aAAa,GAA0D,EAAE,CAAC;IAChF,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IAEvC,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;YACxD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,GAAG,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAEzF,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;gBAChC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;gBACvD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;oBAC3B,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC;wBAAE,SAAS;oBACtC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;oBACxB,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;oBACpC,IAAI,GAAG,EAAE,CAAC;wBACR,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;oBACvE,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,8CAA8C;QAChD,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,MAAM,cAAc,GAAG,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAE7D,8BAA8B;IAC9B,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY,CAC7B,eAAe,EACf,aAAa,EACb,cAAc,EACd,OAAO,EACP,SAAS,EACT,SAAS,CACV,CAAC;IAEF,6BAA6B;IAC7B,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAEtC,wBAAwB;IACxB,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/B,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,UAAU;QAClB,KAAK,EAAE,CAAC,CAAC,KAAK;KACf,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,SAAS,wBAAwB,CAAC,WAAmB;IACnD,MAAM,QAAQ,GAAG;QACf,gCAAgC;QAChC,4BAA4B;QAC5B,oCAAoC;KACrC,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC"}

package/dist/tools/forget.d.ts

@@ -0,0 +1,7 @@
+import type { MemoryForgetInput, MemoryForgetOutput } from '../types/index.js';
+import type { Embedder } from '../embedding/embedder.js';
+import type { SQLiteStore } from '../storage/sqlite.js';
+import type { QdrantStore } from '../storage/qdrant.js';
+import type { Neo4jStore } from '../storage/neo4j.js';
+export declare function handleMemoryForget(args: MemoryForgetInput, embedder: Embedder, sqlite: SQLiteStore, qdrant: QdrantStore, neo4j: Neo4jStore): Promise<MemoryForgetOutput>;
+//# sourceMappingURL=forget.d.ts.map

package/dist/tools/forget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forget.d.ts","sourceRoot":"","sources":["../../src/tools/forget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,kBAAkB,CAAC,CAmD7B"}

package/dist/tools/forget.js

@@ -0,0 +1,49 @@
+export async function handleMemoryForget(args, embedder, sqlite, qdrant, neo4j) {
+    // Must provide either id or query
+    if (!args.id && !args.query) {
+        throw new Error('Either id or query must be provided');
+    }
+    let idsToDelete = [];
+    if (args.id) {
+        // Direct deletion by ID — always attempt cleanup across all stores,
+        // even if SQLite doesn't have the record (handles orphaned entries)
+        idsToDelete = [args.id];
+    }
+    else if (args.query) {
+        // Search for matching memories
+        const vector = await embedder.embed(args.query);
+        const results = await qdrant.search(vector, undefined, 5);
+        idsToDelete = results.map(r => r.id);
+    }
+    // Safety guard: require explicit confirmation before any deletion
+    if (!args.confirm) {
+        return {
+            forgotten: idsToDelete,
+            count: idsToDelete.length,
+        };
+    }
+    // Actually delete from all stores
+    for (const id of idsToDelete) {
+        // Soft delete in SQLite
+        sqlite.softDelete(id);
+        // Delete from Qdrant
+        try {
+            await qdrant.delete(id);
+        }
+        catch (error) {
+            console.error(`[cortex] Failed to delete ${id} from Qdrant: ${error}`);
+        }
+        // Unlink from Neo4j (don't delete orphaned entities)
+        try {
+            await neo4j.unlinkMemory(id);
+        }
+        catch (error) {
+            console.error(`[cortex] Failed to unlink ${id} from Neo4j: ${error}`);
+        }
+    }
+    return {
+        forgotten: idsToDelete,
+        count: idsToDelete.length,
+    };
+}
+//# sourceMappingURL=forget.js.map