cortex-mcp 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,54 @@
+# Changelog
+
+All notable changes to Cortex MCP Server are documented here.
+
+## [1.0.1] -- 2026-02-19
+
+### Fixed
+- **FTS5 indexing** -- Triggers were silently failing to index memories for search
+- **Emoji removal** -- All emojis removed from source code for professional terminal output
+- **SECURITY.md port** -- Documented port corrected from 3100 to 3456
+- **CONTRIBUTING.md** -- Fixed `npm run dev` to `npm run watch`
+- **Config leak** -- Added `bin/` and `.ai/` to `.gitignore` and `.npmignore`
+
+### Added
+- **Soak testing** -- 500-operation stability test (1800+ ops/sec, 0 failures)
+- **Binary builds** -- `scripts/build-binaries.js` for standalone executables
+- **CI/CD pipeline** -- `.github/workflows/release.yml` for automated releases
+- **Value verification** -- `scripts/value-test.js` proves cross-session memory recall
+- **Performance stats** -- Added to README (<1ms latency, 1800+ ops/sec)
+- **Direct download** -- README Option 3 for binary downloads
+
+## [1.0.0] -- 2026-02-18
+
+### Added
+- **`force_recall` tool** — Mandatory context injection at conversation start
+- **`quick_store` tool** — One-sentence memory storage with auto-classification
+- **`store_memory` / `recall_memory`** — Full memory CRUD with type, tags, reason
+- **`update_memory` / `delete_memory` / `list_memories`** — Memory management
+- **`auto_learn` tool** — Extracts decisions and patterns from AI responses
+- **`verify_code` tool** — Detects hallucinated imports, exports, env variables
+- **`verify_files` tool** — Catches hallucinated file paths
+- **`scan_project` tool** — Scans project structure, stack, and git history
+- **`get_context` tool** — Compressed context for current file
+- **`get_stats` / `health_check`** — Database and server diagnostics
+- **`export_memories` / `import_memories`** — JSON bundle export/import with dedup
+- **Git auto-capture** — `post-commit` hook classifies every commit as a memory
+- **Branch/merge capture** — `post-checkout` and `post-merge` hooks track workflow
+- **Build error capture** — `cortex-run` wrapper captures test/build failures
+- **Optional LLM enhancement** — OpenAI/Anthropic/compatible APIs for smarter classification
+- **Web dashboard** — localhost:3456 with memory viewer, search, export
+- **`cortex-setup` CLI** — Auto-configures Antigravity, Claude, Cursor, Copilot, Windsurf, Zed
+- **CLI routing** — `npx @cortex-mcp/server setup` and `--version` subcommands
+- **Quality gates** — Junk rejection, contradiction detection, deduplication
+- **Rate limiting** — 30 stores, 100 auto-learns, 500 calls per session
+- **Memory decay** — Stale/low-quality memories cleaned automatically
+- **Crash protection** — `uncaughtException` and `unhandledRejection` handlers
+- **Degraded mode** — Server reports errors instead of crashing if DB init fails
+
+### Technical
+- SQLite-backed persistence with FTS5 full-text search
+- MiniLM-L6-v2 semantic embeddings via `@xenova/transformers` (background worker)
+- Hybrid retrieval: semantic similarity + keyword FTS + recency scoring
+- Direct SQLite hooks for sub-500ms git hook execution
+- Optional LLM with graceful fallback to keyword classification

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Perla Jaswanth Kumar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,202 @@
+# Cortex MCP — Persistent AI Memory
+
+> Give your AI coding assistant a brain that remembers across sessions.
+
+Cortex is an MCP (Model Context Protocol) server that provides persistent, intelligent memory to any AI coding assistant — Cursor, Claude Code, Windsurf, Cline, or any MCP-compatible tool.
+
+## The Problem
+
+Every time you start a new conversation, your AI assistant forgets everything:
+- Coding conventions you already explained
+- Bugs you already fixed
+- Decisions you already made
+- What files you were working on
+
+**Cortex solves this.** It stores, ranks, and proactively recalls context so your AI never starts from zero.
+
+## Quick Start
+
+### Option 1: npm install (recommended)
+```bash
+npm install -g cortex-mcp
+```
+
+Then add to your MCP config:
+```json
+{
+  "mcpServers": {
+    "cortex": {
+      "command": "cortex-mcp",
+      "transportType": "stdio"
+    }
+  }
+}
+```
+
+### Option 2: Clone from source
+```bash
+git clone <your-repo-url>
+cd cognitive-memory
+npm install
+npm run build
+```
+
+Then add to your MCP config:
+```json
+{
+  "mcpServers": {
+    "cortex": {
+      "command": "node",
+      "args": ["<path-to>/cognitive-memory/dist/mcp-stdio.js"],
+      "transportType": "stdio"
+    }
+  }
+}
+```
+
+Restart your IDE and Cortex is active.
+
+### Option 3: Direct Download (Binaries)
+No Node.js required. Just download and run.
+- [Windows](https://github.com/cortex-mcp/server/releases/latest/download/cortex-win.exe)
+- [macOS](https://github.com/cortex-mcp/server/releases/latest/download/cortex-macos)
+- [Linux](https://github.com/cortex-mcp/server/releases/latest/download/cortex-linux)
+
+Then configure your MCP client to run the executable directly.
+
+## Features
+
+### 16 MCP Tools
+| Tool | Purpose |
+|---|---|
+| `force_recall` | Full brain dump at conversation start (14-layer pipeline) |
+| `recall_memory` | Search memories by topic (FTS + vector + graph) |
+| `store_memory` | Store a decision, correction, convention, or bug fix |
+| `quick_store` | One-liner memory storage with auto-classification |
+| `auto_learn` | Extract memories from AI responses automatically |
+| `scan_project` | Scan project structure, stack, git, exports, architecture |
+| `verify_code` | Check if imports/exports/env vars actually exist |
+| `verify_files` | Check if file paths are real or hallucinated |
+| `get_context` | Get compressed context for current file |
+| `get_stats` | Memory database statistics |
+| `list_memories` | List all active memories |
+| `update_memory` | Update an existing memory |
+| `delete_memory` | Delete a memory |
+| `export_memories` | Export all memories to JSON |
+| `import_memories` | Import memories from JSON |
+| `health_check` | Server health check |
+
+### 14-Layer Brain Pipeline
+
+Every conversation starts with `force_recall`, which runs 14 layers:
+
+| Layer | Feature |
+|:---:|---|
+| 0 | Session management — track what you're working on |
+| 1 | Maintenance — decay old memories, boost corrections, consolidate duplicates |
+| 2 | Attention focus — detect debugging vs coding vs reviewing |
+| 3 | Session continuity — resume from where you left off |
+| 4 | Hot corrections — surface frequently-corrected topics |
+| 5 | Core context — all corrections, decisions, conventions, bug fixes |
+| 6 | Anticipation — proactive recall based on current file |
+| 7 | Temporal — what changed today, yesterday, this week |
+| 8 | Workspace git — branch, recent commits, diffs |
+| 8.5 | Git memory — auto-capture commits + detect file changes |
+| 9 | Topic search — FTS + confidence decay + causal chain traversal |
+| 10 | Knowledge gaps — flag files with zero memories |
+| 11 | Export map — show all available functions/classes (anti-hallucination) |
+| 12 | Architecture graph — show layers, circular deps, API endpoints |
+
+### Cognitive Features
+- **Confidence decay** — old unused memories fade, frequently accessed ones strengthen
+- **Attention ranking** — debugging context boosts bug-fix memories, coding boosts conventions
+- **Contradiction detection** — new memories automatically supersede conflicting old ones
+- **Memory consolidation** — similar memories merge into higher-level insights
+- **Cross-session threading** — related sessions link by topic overlap
+- **Learning rate** — topics corrected 3+ times get CRITICAL priority
+
+### Performance & Reliability
+- **Latency**: <1ms average recall time (local SQLite + WAL).
+- **Throughput**: 1800+ ops/sec (verified via Soak Test).
+- **Stability**: Zero memory leaks over sustained operation.
+- **Protocol**: Full JSON-RPC 2.0 compliance (passed E2E suite).
+
+### Anti-Hallucination
+- Deep export map scans every source file for all exported functions, classes, types
+- When AI references a function that doesn't exist, `verify_code` suggests the closest real match
+- Architecture graph shows actual project layers and dependencies
+
+## Optional: LLM Enhancement
+
+Cortex works fully without any API key. Optionally, add an LLM key for smarter memory extraction:
+
+```bash
+# Option 1: OpenAI
+set OPENAI_API_KEY=sk-your-key
+
+# Option 2: Anthropic
+set ANTHROPIC_API_KEY=sk-ant-your-key
+
+# Option 3: Local (Ollama, free)
+set CORTEX_LLM_KEY=ollama
+set CORTEX_LLM_BASE_URL=http://localhost:11434
+```
+
+## Memory Types
+
+| Type | Use For |
+|---|---|
+| `CORRECTION` | "Don't use var, use const" |
+| `DECISION` | "We chose PostgreSQL over MongoDB" |
+| `CONVENTION` | "All API routes start with /api/v1" |
+| `BUG_FIX` | "Fixed race condition in auth middleware" |
+| `INSIGHT` | "The codebase uses a layered architecture" |
+| `FAILED_SUGGESTION` | "Tried Redis caching, too complex for this project" |
+| `PROVEN_PATTERN` | "useDebounce hook works well for search inputs" |
+
+## Architecture
+
+```
+src/
+├── server/          # MCP handler (14-layer pipeline) + dashboard
+├── memory/          # 17 cognitive modules (decay, attention, anticipation, etc.)
+├── scanners/        # Project scanner, code verifier, export map, architecture graph
+├── db/              # SQLite storage, event log
+├── security/        # Rate limiter, encryption
+├── hooks/           # Git capture
+├── config/          # Configuration
+└── cli/             # Setup wizard
+```
+
+## Pricing & Features
+
+Cortex is open core. The basic version is free forever. To unlock deep cognitive features, upgrade to PRO.
+
+| Feature | FREE (npm install) | PRO ($9/mo) |
+|---|:---:|:---:|
+| **Memory Capacity** | 20 memories | ∞ Unlimited |
+| **Brain Layers** | 3 (Basic) | 14 (Full) |
+| **Project Scan** | Yes | Yes |
+| **Verify Code** | Yes | Yes |
+| **Auto-Learn** | No | Yes |
+| **Export Map (Anti-Hallucination)** | No | Yes |
+| **Architecture Graph** | No | Yes |
+| **Git Memory** | No | Yes |
+| **Confidence Decay** | No | Yes |
+| **Contradiction Detection** | No | Yes |
+
+### Activate PRO
+1. Get a license key from [cortex-mcp.org](https://cortex-mcp.org)
+2. Set it in your environment:
+   ```bash
+   # Option A: Environment variable
+   export CORTEX_LICENSE_KEY=CORTEX-XXXX-XXXX-XXXX-XXXX
+
+   # Option B: License file
+   echo CORTEX-XXXX-XXXX-XXXX-XXXX > ~/.cortex/license
+   ```
+3. Restart your IDE / MCP server.
+
+## License
+
+MIT

package/dist/cli/setup.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * cortex setup — Auto-configures Cortex MCP server for any AI client.
+ *
+ * Usage:
+ *   cortex-setup                      # auto-detect all clients
+ *   cortex-setup --client antigravity
+ *   cortex-setup --client claude
+ *   cortex-setup --client cursor
+ */
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/dist/cli/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG"}

package/dist/cli/setup.js

@@ -0,0 +1,293 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * cortex setup — Auto-configures Cortex MCP server for any AI client.
+ *
+ * Usage:
+ *   cortex-setup                      # auto-detect all clients
+ *   cortex-setup --client antigravity
+ *   cortex-setup --client claude
+ *   cortex-setup --client cursor
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const HOME = os.homedir();
+const CLIENTS = {
+    antigravity: {
+        name: 'Antigravity (Gemini)',
+        configPath: path.join(HOME, '.gemini', 'antigravity', 'mcp_config.json'),
+        configKey: 'mcpServers',
+    },
+    claude: {
+        name: 'Claude Desktop',
+        configPath: process.platform === 'win32'
+            ? path.join(HOME, 'AppData', 'Roaming', 'Claude', 'claude_desktop_config.json')
+            : path.join(HOME, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json'),
+        configKey: 'mcpServers',
+    },
+    cursor: {
+        name: 'Cursor',
+        configPath: path.join(HOME, '.cursor', 'mcp.json'),
+        configKey: 'mcpServers',
+    },
+    copilot: {
+        name: 'GitHub Copilot (VS Code)',
+        configPath: path.join(HOME, '.vscode', 'settings.json'),
+        configKey: 'github.copilot.chat.mcpServers',
+    },
+    windsurf: {
+        name: 'Windsurf',
+        configPath: path.join(HOME, '.codeium', 'windsurf', 'mcp_config.json'),
+        configKey: 'mcpServers',
+    },
+    zed: {
+        name: 'Zed',
+        configPath: process.platform === 'win32'
+            ? path.join(HOME, 'AppData', 'Roaming', 'Zed', 'settings.json')
+            : path.join(HOME, '.config', 'zed', 'settings.json'),
+        configKey: 'mcpServers',
+    },
+};
+// ─── Server Entry ─────────────────────────────────────────────────────────────
+const SERVER_ENTRY = {
+    command: 'npx',
+    args: ['-y', '@cortex-mcp/server'],
+};
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function readJSON(filePath) {
+    try {
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+function writeJSON(filePath, data) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+}
+function setNestedKey(obj, keyPath, value) {
+    const keys = keyPath.split('.');
+    let current = obj;
+    for (let i = 0; i < keys.length - 1; i++) {
+        if (!current[keys[i]])
+            current[keys[i]] = {};
+        current = current[keys[i]];
+    }
+    const lastKey = keys[keys.length - 1];
+    if (!current[lastKey])
+        current[lastKey] = {};
+    current[lastKey]['cortex'] = value;
+    return obj;
+}
+function configureClient(clientKey) {
+    const client = CLIENTS[clientKey];
+    if (!client) {
+        console.error(`Unknown client: ${clientKey}`);
+        console.error(`Available: ${Object.keys(CLIENTS).join(', ')}`);
+        return false;
+    }
+    const config = readJSON(client.configPath);
+    const updated = setNestedKey(config, client.configKey, SERVER_ENTRY);
+    writeJSON(client.configPath, updated);
+    console.log(`[OK] ${client.name} configured!`);
+    console.log(`   Config: ${client.configPath}`);
+    return true;
+}
+function autoDetect() {
+    const detected = [];
+    for (const [key, client] of Object.entries(CLIENTS)) {
+        if (fs.existsSync(path.dirname(client.configPath))) {
+            detected.push(key);
+        }
+    }
+    return detected;
+}
+// ─── Git Hook Installation ────────────────────────────────────────────────────
+const HOOKS = {
+    'post-commit': '#!/bin/sh\n# Cortex — Auto-capture commits\ncortex-capture 2>/dev/null || true\n',
+    'post-checkout': '#!/bin/sh\n# Cortex — Track branch switches\ncortex-hooks checkout "$@" 2>/dev/null || true\n',
+    'post-merge': '#!/bin/sh\n# Cortex — Track merges\ncortex-hooks merge "$@" 2>/dev/null || true\n',
+};
+function installGitHooks(workspaceRoot) {
+    const gitDir = path.join(workspaceRoot, '.git');
+    if (!fs.existsSync(gitDir))
+        return 0;
+    const hookDir = path.join(gitDir, 'hooks');
+    fs.mkdirSync(hookDir, { recursive: true });
+    let installed = 0;
+    for (const [hookName, hookContent] of Object.entries(HOOKS)) {
+        const hookPath = path.join(hookDir, hookName);
+        const marker = hookName === 'post-commit' ? 'cortex-capture' : 'cortex-hooks';
+        if (fs.existsSync(hookPath)) {
+            const existing = fs.readFileSync(hookPath, 'utf-8');
+            if (existing.includes(marker))
+                continue; // Already installed
+            // Append to existing hook
+            const appendLine = hookContent.split('\n').filter(l => l.includes('cortex')).join('\n');
+            fs.appendFileSync(hookPath, `\n# Cortex MCP\n${appendLine}\n`);
+        }
+        else {
+            fs.writeFileSync(hookPath, hookContent, { mode: 0o755 });
+        }
+        installed++;
+    }
+    return installed;
+}
+// ─── Prompt Rules Installation ────────────────────────────────────────────────
+// Each AI client has its own rules file. These tell the AI to auto-call
+// force_recall at conversation start and auto_learn after every response.
+const CORTEX_RULES = `# Cortex Memory Rules — MANDATORY
+
+## At Conversation Start (ALWAYS)
+1. ALWAYS call \`mcp_cortex_force_recall\` with the topic of the user's question
+   - This returns ALL corrections, decisions, conventions, and bug fixes
+   - Plus topic-specific search results
+   - DO NOT skip this step. It is mandatory.
+
+## After EVERY Response (ALWAYS)
+2. ALWAYS call \`mcp_cortex_auto_learn\` with the text of your response
+   - Cortex will automatically extract and store any decisions, corrections, conventions, or bug fixes
+   - This is how Cortex learns passively — zero manual effort required
+   - DO NOT skip this step. It is mandatory.
+
+## When Decisions Are Made
+ALSO call \`mcp_cortex_store_memory\` for high-importance items:
+- A critical architectural decision (type: DECISION)
+- A mistake that must never be repeated (type: CORRECTION)
+- A project-wide coding convention (type: CONVENTION)
+- A tricky bug that was hard to find (type: BUG_FIX)
+
+## Before Suggesting Code
+Call \`mcp_cortex_verify_code\` to check:
+- Are import packages real (exist in package.json)?
+- Are imported functions actually exported?
+- Are env variables defined in .env?
+
+## Before Referencing Files
+Call \`mcp_cortex_verify_files\` to check if file paths are real.
+`;
+// Map of client → rules file path (relative to project root)
+const RULES_FILES = {
+    antigravity: path.join('.gemini', 'GEMINI.md'),
+    cursor: '.cursorrules',
+    copilot: path.join('.github', 'copilot-instructions.md'),
+    windsurf: '.windsurfrules',
+};
+function installPromptRules(workspaceRoot, detectedClients) {
+    let installed = 0;
+    for (const client of detectedClients) {
+        const rulesFile = RULES_FILES[client];
+        if (!rulesFile)
+            continue; // No rules file for this client (e.g. zed, claude)
+        const fullPath = path.join(workspaceRoot, rulesFile);
+        // Don't overwrite — check if Cortex rules already present
+        if (fs.existsSync(fullPath)) {
+            const existing = fs.readFileSync(fullPath, 'utf-8');
+            if (existing.includes('mcp_cortex_force_recall'))
+                continue; // Already installed
+            // Append to existing rules
+            fs.appendFileSync(fullPath, '\n\n' + CORTEX_RULES);
+            console.log(`[OK] Cortex rules appended to ${rulesFile}`);
+        }
+        else {
+            fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+            fs.writeFileSync(fullPath, CORTEX_RULES, 'utf-8');
+            console.log(`[OK] Created ${rulesFile} with Cortex memory rules`);
+        }
+        installed++;
+    }
+    return installed;
+}
+// ─── Main ─────────────────────────────────────────────────────────────────────
+function main() {
+    const args = process.argv.slice(2);
+    const clientFlag = args.indexOf('--client');
+    const clientArg = clientFlag !== -1 ? args[clientFlag + 1] : null;
+    console.log('\nCortex MCP Setup\n');
+    let detectedClients = [];
+    if (clientArg) {
+        configureClient(clientArg);
+        detectedClients = [clientArg];
+    }
+    else {
+        // Auto-detect installed clients
+        detectedClients = autoDetect();
+        if (detectedClients.length === 0) {
+            console.log('No supported AI clients detected.');
+            console.log('Supported clients:', Object.keys(CLIENTS).join(', '));
+            console.log('\nManual setup:');
+            console.log(JSON.stringify({ mcpServers: { cortex: SERVER_ENTRY } }, null, 2));
+        }
+        else {
+            console.log(`Detected clients: ${detectedClients.map(k => CLIENTS[k].name).join(', ')}\n`);
+            for (const key of detectedClients) {
+                configureClient(key);
+            }
+        }
+    }
+    const cwd = process.cwd();
+    // Install prompt rules (tells the AI to use Cortex automatically)
+    if (detectedClients.length > 0) {
+        console.log('');
+        const rulesCount = installPromptRules(cwd, detectedClients);
+        if (rulesCount > 0) {
+            console.log(`   AI will now auto-recall context and auto-learn from every conversation!`);
+        }
+    }
+    // Install git hooks in current directory (if it's a git repo)
+    console.log('');
+    if (fs.existsSync(path.join(cwd, '.git'))) {
+        const count = installGitHooks(cwd);
+        if (count > 0) {
+            console.log(`[OK] ${count} git hook(s) installed (commits, branches, merges)`);
+            console.log('   Every code change will now be auto-captured as a memory!');
+        }
+        else {
+            console.log('[OK] Git hooks already installed');
+        }
+    }
+    else {
+        console.log('[INFO] No git repo detected in current directory.');
+        console.log('   Run "cortex-setup" inside a git repo to enable auto-capture.');
+    }
+    console.log('\nDone! Restart your AI client to activate Cortex.\n');
+}
+main();
+//# sourceMappingURL=setup.js.map

package/dist/cli/setup.js.map

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

package/dist/config/config.d.ts

@@ -0,0 +1,13 @@
+export declare const CONFIG: {
+    TYPE_BOOST: Record<string, number>;
+    INSIGHT_MAX_AGE_DAYS: number;
+    UNUSED_MAX_AGE_DAYS: number;
+    MEMORY_CAP: number;
+    CACHE_TTL: number;
+    CACHE_MAX: number;
+    EMBEDDING_TIMEOUT: number;
+    MAX_CONTEXT_CHARS: number;
+    MAX_RECALL_RESULTS: number;
+    DASHBOARD_PORT: number;
+};
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,MAAM;gBASV,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;;;;;;CAoB9B,CAAC"}

package/dist/config/config.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG = void 0;
+/**
+ * Cortex Configuration — Minimal, focused config for MCP mode.
+ */
+const types_1 = require("../types");
+exports.CONFIG = {
+    // Memory ranking boosts by type
+    TYPE_BOOST: {
+        [types_1.MemoryType.CORRECTION]: 1.5,
+        [types_1.MemoryType.DECISION]: 1.3,
+        [types_1.MemoryType.CONVENTION]: 1.2,
+        [types_1.MemoryType.BUG_FIX]: 1.1,
+        [types_1.MemoryType.INSIGHT]: 1.0,
+        [types_1.MemoryType.DEPENDENCY]: 0.8,
+    },
+    // Memory decay
+    INSIGHT_MAX_AGE_DAYS: 30,
+    UNUSED_MAX_AGE_DAYS: 60,
+    MEMORY_CAP: 500,
+    // Cache
+    CACHE_TTL: 60_000, // 1 minute
+    CACHE_MAX: 50,
+    // Embeddings
+    EMBEDDING_TIMEOUT: 30_000, // 30 seconds
+    // Context
+    MAX_CONTEXT_CHARS: 3000,
+    MAX_RECALL_RESULTS: 10,
+    // Server
+    DASHBOARD_PORT: 3456,
+};
+//# sourceMappingURL=config.js.map

package/dist/config/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,oCAAsC;AAEzB,QAAA,MAAM,GAAG;IAClB,gCAAgC;IAChC,UAAU,EAAE;QACR,CAAC,kBAAU,CAAC,UAAU,CAAC,EAAE,GAAG;QAC5B,CAAC,kBAAU,CAAC,QAAQ,CAAC,EAAE,GAAG;QAC1B,CAAC,kBAAU,CAAC,UAAU,CAAC,EAAE,GAAG;QAC5B,CAAC,kBAAU,CAAC,OAAO,CAAC,EAAE,GAAG;QACzB,CAAC,kBAAU,CAAC,OAAO,CAAC,EAAE,GAAG;QACzB,CAAC,kBAAU,CAAC,UAAU,CAAC,EAAE,GAAG;KACL;IAE3B,eAAe;IACf,oBAAoB,EAAE,EAAE;IACxB,mBAAmB,EAAE,EAAE;IACvB,UAAU,EAAE,GAAG;IAEf,QAAQ;IACR,SAAS,EAAE,MAAM,EAAM,WAAW;IAClC,SAAS,EAAE,EAAE;IAEb,aAAa;IACb,iBAAiB,EAAE,MAAM,EAAE,aAAa;IAExC,UAAU;IACV,iBAAiB,EAAE,IAAI;IACvB,kBAAkB,EAAE,EAAE;IAEtB,SAAS;IACT,cAAc,EAAE,IAAI;CACvB,CAAC"}