claude-eidetic 0.1.2 → 0.1.4

package/dist/tool-schemas.js

@@ -1,58 +1,58 @@
-const READ_FILE_DESCRIPTION = `\
-Read a file and return raw content without line-number overhead (~15-20% fewer tokens than built-in Read for code, more for short-line files).
-
-Use offset and limit to page through large files. \
+const READ_FILE_DESCRIPTION = `\
+Read a file and return raw content without line-number overhead (~15-20% fewer tokens than built-in Read for code, more for short-line files).
+
+Use offset and limit to page through large files. \
 Add lineNumbers=true only when you need line references for editing.`;
-const INDEX_DOCUMENT_DESCRIPTION = `\
-Cache external documentation (from query-docs, WebFetch, etc.) for cheap semantic search later.
-
-After fetching documentation from an external source, call this tool to store it. \
-Subsequent queries about the same library will use search_documents (~20 tokens/result) \
-instead of re-fetching (~5K+ tokens).
-
-The content is split into chunks, embedded, and stored in a vector collection grouped by library. \
+const INDEX_DOCUMENT_DESCRIPTION = `\
+Cache external documentation (from query-docs, WebFetch, etc.) for cheap semantic search later.
+
+After fetching documentation from an external source, call this tool to store it. \
+Subsequent queries about the same library will use search_documents (~20 tokens/result) \
+instead of re-fetching (~5K+ tokens).
+
+The content is split into chunks, embedded, and stored in a vector collection grouped by library. \
 A TTL tracks staleness — stale docs still return results but are flagged.`;
-const SEARCH_DOCUMENTS_DESCRIPTION = `\
-Search cached documentation using natural language queries.
-
-Returns results from previously cached documentation (via index_document). \
-Much cheaper than re-fetching docs (~20 tokens/result vs ~5K+ tokens/fetch).
-
-If a specific library is provided, searches only that library's collection. \
+const SEARCH_DOCUMENTS_DESCRIPTION = `\
+Search cached documentation using natural language queries.
+
+Returns results from previously cached documentation (via index_document). \
+Much cheaper than re-fetching docs (~20 tokens/result vs ~5K+ tokens/fetch).
+
+If a specific library is provided, searches only that library's collection. \
 Otherwise searches across all cached documentation. Results include staleness indicators.`;
-const CLEANUP_DESCRIPTION = `\
-Remove orphaned vectors for files that no longer exist on disk. Lightweight alternative to re-indexing — no embedding cost.
-
-Provide either \`path\` (absolute) or \`project\` (name). Use \`list_indexed\` to see registered projects.
-
+const CLEANUP_DESCRIPTION = `\
+Remove orphaned vectors for files that no longer exist on disk. Lightweight alternative to re-indexing — no embedding cost.
+
+Provide either \`path\` (absolute) or \`project\` (name). Use \`list_indexed\` to see registered projects.
+
 Use \`dryRun=true\` first to preview which files would be cleaned without making any changes.`;
-const INDEX_DESCRIPTION = `\
-Index a codebase directory to enable semantic search using a configurable code splitter.
-
-Provide either \`path\` (absolute) or \`project\` (name). Use \`list_indexed\` to see registered projects.
-
-Usage Guidance:
-- Use dryRun=true first to preview what files would be indexed and catch configuration issues before committing to a full index.
-- This tool is typically used when search fails due to an unindexed codebase.
-- If indexing is attempted on an already indexed path, and a conflict is detected, \
+const INDEX_DESCRIPTION = `\
+Index a codebase directory to enable semantic search using a configurable code splitter.
+
+Provide either \`path\` (absolute) or \`project\` (name). Use \`list_indexed\` to see registered projects.
+
+Usage Guidance:
+- Use dryRun=true first to preview what files would be indexed and catch configuration issues before committing to a full index.
+- This tool is typically used when search fails due to an unindexed codebase.
+- If indexing is attempted on an already indexed path, and a conflict is detected, \
 you MUST prompt the user to confirm whether to proceed with a force index.`;
-const SEARCH_DESCRIPTION = `\
-Search the indexed codebase using natural language queries.
-Prefer over Grep for conceptual/semantic queries — returns ~20 tokens/result vs ~100+ for Grep.
-Try before launching an Explore agent — faster and cheaper for understanding code.
-
-Provide either \`path\` (absolute) or \`project\` (name). Use \`list_indexed\` to see registered projects.
-
-When to Use:
-- Code search: Find specific functions, classes, or implementations
-- Context-aware assistance: Gather relevant code context before making changes
-- Issue identification: Locate problematic code sections or bugs
-- Code review: Understand existing implementations and patterns
-- Refactoring: Find all related code pieces that need to be updated
-- Feature development: Understand existing architecture and similar implementations
-- Duplicate detection: Identify redundant or duplicated code patterns
-
-If the codebase is not indexed, this tool will return a clear error message \
+const SEARCH_DESCRIPTION = `\
+Search the indexed codebase using natural language queries.
+Prefer over Grep for conceptual/semantic queries — returns ~20 tokens/result vs ~100+ for Grep.
+Try before launching an Explore agent — faster and cheaper for understanding code.
+
+Provide either \`path\` (absolute) or \`project\` (name). Use \`list_indexed\` to see registered projects.
+
+When to Use:
+- Code search: Find specific functions, classes, or implementations
+- Context-aware assistance: Gather relevant code context before making changes
+- Issue identification: Locate problematic code sections or bugs
+- Code review: Understand existing implementations and patterns
+- Refactoring: Find all related code pieces that need to be updated
+- Feature development: Understand existing architecture and similar implementations
+- Duplicate detection: Identify redundant or duplicated code patterns
+
+If the codebase is not indexed, this tool will return a clear error message \
 indicating that indexing is required first.`;
 export const TOOL_DEFINITIONS = [
     {
@@ -289,20 +289,43 @@ export const TOOL_DEFINITIONS = [
     },
     {
         name: 'add_memory',
-        description: 'Extract and store developer knowledge from text. Uses LLM to identify facts about coding style, tools, architecture, conventions, debugging insights, and workflow preferences. Automatically deduplicates against existing memories.',
+        description: 'Store pre-extracted developer knowledge facts. Before calling, extract facts yourself from the relevant content. Each fact should be a concise, self-contained statement about coding style, tools, architecture, conventions, debugging insights, or workflow preferences. Automatically deduplicates against existing memories.',
         inputSchema: {
             type: 'object',
             properties: {
-                content: {
-                    type: 'string',
-                    description: 'Text containing developer knowledge to extract and store (conversation snippets, notes, preferences).',
+                facts: {
+                    type: 'array',
+                    description: 'Array of facts to store. Extract these yourself before calling. Each fact must be a concise, self-contained statement.',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            fact: {
+                                type: 'string',
+                                description: 'A concise, self-contained statement of a developer preference or convention.',
+                            },
+                            category: {
+                                type: 'string',
+                                description: 'Category: coding_style, tools, architecture, conventions, debugging, workflow, or preferences.',
+                                enum: [
+                                    'coding_style',
+                                    'tools',
+                                    'architecture',
+                                    'conventions',
+                                    'debugging',
+                                    'workflow',
+                                    'preferences',
+                                ],
+                            },
+                        },
+                        required: ['fact', 'category'],
+                    },
                 },
                 source: {
                     type: 'string',
                     description: 'Optional source identifier (e.g., "conversation", "claude-code", "user-note").',
                 },
             },
-            required: ['content'],
+            required: ['facts'],
         },
     },
     {

package/dist/tools.js

@@ -257,12 +257,12 @@ export class ToolHandlers {
     async handleAddMemory(args) {
         if (!this.memoryStore)
             return textResult('Error: Memory system not initialized.');
-        const content = args.content;
-        if (!content)
-            return textResult('Error: "content" is required. Provide text containing developer knowledge to extract.');
+        const facts = args.facts;
+        if (!facts || !Array.isArray(facts) || facts.length === 0)
+            return textResult('Error: "facts" is required. Provide an array of pre-extracted facts with fact and category fields.');
         const source = args.source;
         try {
-            const actions = await this.memoryStore.addMemory(content, source);
+            const actions = await this.memoryStore.addMemory(facts, source);
             return textResult(formatMemoryActions(actions));
         }
         catch (err) {

package/messages.yaml

@@ -1,50 +1,50 @@
-# Eidetic user-facing messages — edit here, everything else reads from this file.
-
-setup:
-  missing:
-    header: "Eidetic setup required: No API key configured."
-    diagnosis: >
-      `OPENAI_API_KEY` is not set and no alternative provider is configured.
-    step1: "**Get an API key**: https://platform.openai.com/api-keys"
-
-  invalid:
-    header: "Eidetic setup failed: {error}"
-    diagnosis: >
-      Key/provider is configured but initialization failed.
-      The key may be invalid, expired, or the provider may be unreachable.
-    step1: "**Verify your key** is valid and has embedding permissions"
-
-  unknown:
-    header: "Eidetic setup failed: {error}"
-    diagnosis: ""
-    step1: "**Get an API key**: https://platform.openai.com/api-keys"
-
-  # Shared across all contexts
-  config_instructions: |
-    ### Windows
-    ```
-      setx OPENAI_API_KEY sk-your-key-here
-    ```
-
-    ### macOS / Linux
-    Add to your shell profile (`~/.bashrc`, `~/.zshrc`, etc.):
-    ```
-      export OPENAI_API_KEY="sk-your-key-here"
-    ```
-
-    ### Manual
-
-    Edit `~/.claude/plugins/claude-eidetic/config.json`:
-    ```json
-    {
-      "env": {
-        "OPENAI_API_KEY": "sk-your-key-here"
-      }
-    }
-    ```
-
-    ### Using Ollama instead (free, local)
-
-    Set `EMBEDDING_PROVIDER=ollama` in the same env block (requires Ollama running locally with `nomic-embed-text`).
-
-  footer: "**Restart Claude Code** for changes to take effect."
+# Eidetic user-facing messages — edit here, everything else reads from this file.
+
+setup:
+  missing:
+    header: "Eidetic setup required: No API key configured."
+    diagnosis: >
+      `OPENAI_API_KEY` is not set and no alternative provider is configured.
+    step1: "**Get an API key**: https://platform.openai.com/api-keys"
+
+  invalid:
+    header: "Eidetic setup failed: {error}"
+    diagnosis: >
+      Key/provider is configured but initialization failed.
+      The key may be invalid, expired, or the provider may be unreachable.
+    step1: "**Verify your key** is valid and has embedding permissions"
+
+  unknown:
+    header: "Eidetic setup failed: {error}"
+    diagnosis: ""
+    step1: "**Get an API key**: https://platform.openai.com/api-keys"
+
+  # Shared across all contexts
+  config_instructions: |
+    ### Windows
+    ```
+      setx OPENAI_API_KEY sk-your-key-here
+    ```
+
+    ### macOS / Linux
+    Add to your shell profile (`~/.bashrc`, `~/.zshrc`, etc.):
+    ```
+      export OPENAI_API_KEY="sk-your-key-here"
+    ```
+
+    ### Manual
+
+    Edit `~/.claude/plugins/claude-eidetic/config.json`:
+    ```json
+    {
+      "env": {
+        "OPENAI_API_KEY": "sk-your-key-here"
+      }
+    }
+    ```
+
+    ### Using Ollama instead (free, local)
+
+    Set `EMBEDDING_PROVIDER=ollama` in the same env block (requires Ollama running locally with `nomic-embed-text`).
+
+  footer: "**Restart Claude Code** for changes to take effect."

package/package.json

@@ -1,87 +1,86 @@
-{
-  "name": "claude-eidetic",
-  "version": "0.1.2",
-  "description": "Semantic code search MCP server — lean, correct, fast",
-  "type": "module",
-  "main": "dist/index.js",
-  "bin": {
-    "claude-eidetic": "dist/index.js"
-  },
-  "files": [
-    "dist/**/*.js",
-    "dist/**/*.d.ts",
-    "!dist/**/*.test.*",
-    "!dist/__tests__/**",
-    "!dist/**/tests/**",
-    "!dist/e2e/**",
-    "messages.yaml"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx --watch src/index.ts",
-    "start": "node dist/index.js",
-    "clean": "rimraf dist",
-    "lint": "eslint src/",
-    "lint:fix": "eslint src/ --fix",
-    "format": "prettier --write \"src/**/*.ts\"",
-    "format:check": "prettier --check \"src/**/*.ts\"",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "test:integration": "vitest run --config vitest.integration.config.ts",
-    "test:all": "vitest run && vitest run --config vitest.integration.config.ts",
-    "test:eval": "tsx scripts/eval/recall-at-k.ts && tsx scripts/eval/fusion-lift.ts && tsx scripts/eval/ndcg.ts",
-    "test:eval:generate": "tsx scripts/eval/generate-queries.ts",
-    "prepublishOnly": "npm run clean && npm run build",
-    "release": "bash scripts/release.sh"
-  },
-  "dependencies": {
-    "@anthropic-ai/sdk": "^0.78.0",
-    "@modelcontextprotocol/sdk": "^1.12.1",
-    "@qdrant/js-client-rest": "^1.13.0",
-    "better-sqlite3": "^12.6.2",
-    "glob": "^11.0.0",
-    "openai": "^5.1.1",
-    "tree-sitter": "^0.21.1",
-    "tree-sitter-c-sharp": "^0.21.0",
-    "tree-sitter-cpp": "^0.22.0",
-    "tree-sitter-go": "^0.21.0",
-    "tree-sitter-java": "^0.21.0",
-    "tree-sitter-javascript": "^0.21.0",
-    "tree-sitter-python": "^0.21.0",
-    "tree-sitter-rust": "^0.21.0",
-    "tree-sitter-typescript": "^0.21.0",
-    "yaml": "^2.8.2",
-    "zod": "^3.25.0"
-  },
-  "optionalDependencies": {
-    "@zilliz/milvus2-sdk-node": "^2.5.10"
-  },
-  "devDependencies": {
-    "@eslint/js": "^9.39.3",
-    "@types/better-sqlite3": "^7.6.13",
-    "@types/node": "^20.0.0",
-    "@vitest/coverage-v8": "^4.0.18",
-    "eslint": "^9.39.3",
-    "eslint-config-prettier": "^10.1.8",
-    "prettier": "^3.8.1",
-    "rimraf": "^6.0.1",
-    "tsx": "^4.19.4",
-    "typescript": "^5.8.3",
-    "typescript-eslint": "^8.56.0",
-    "vitest": "^4.0.18"
-  },
-  "overrides": {
-    "minimatch": "^10.2.1",
-    "@grpc/grpc-js": "^1.8.22"
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/eidetics/claude-eidetic"
-  },
-  "license": "MIT"
-}
+{
+  "name": "claude-eidetic",
+  "version": "0.1.4",
+  "description": "Semantic code search MCP server — lean, correct, fast",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "claude-eidetic": "dist/index.js"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "!dist/**/*.test.*",
+    "!dist/__tests__/**",
+    "!dist/**/tests/**",
+    "!dist/e2e/**",
+    "messages.yaml"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx --watch src/index.ts",
+    "start": "node dist/index.js",
+    "clean": "rimraf dist",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "test:all": "vitest run && vitest run --config vitest.integration.config.ts",
+    "test:eval": "tsx scripts/eval/recall-at-k.ts && tsx scripts/eval/fusion-lift.ts && tsx scripts/eval/ndcg.ts",
+    "test:eval:generate": "tsx scripts/eval/generate-queries.ts",
+    "prepublishOnly": "npm run clean && npm run build",
+    "release": "bash scripts/release.sh"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@qdrant/js-client-rest": "^1.13.0",
+    "better-sqlite3": "^12.6.2",
+    "glob": "^11.0.0",
+    "openai": "^5.1.1",
+    "tree-sitter": "^0.21.1",
+    "tree-sitter-c-sharp": "^0.21.0",
+    "tree-sitter-cpp": "^0.22.0",
+    "tree-sitter-go": "^0.21.0",
+    "tree-sitter-java": "^0.21.0",
+    "tree-sitter-javascript": "^0.21.0",
+    "tree-sitter-python": "^0.21.0",
+    "tree-sitter-rust": "^0.21.0",
+    "tree-sitter-typescript": "^0.21.0",
+    "yaml": "^2.8.2",
+    "zod": "^3.25.0"
+  },
+  "optionalDependencies": {
+    "@zilliz/milvus2-sdk-node": "^2.5.10"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.3",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^20.0.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "eslint": "^9.39.3",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.8.1",
+    "rimraf": "^6.0.1",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.56.0",
+    "vitest": "^4.0.18"
+  },
+  "overrides": {
+    "minimatch": "^10.2.1",
+    "@grpc/grpc-js": "^1.8.22"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eidetics/claude-eidetic.git"
+  },
+  "license": "MIT"
+}

package/dist/memory/llm.d.ts

@@ -1,2 +0,0 @@
-export declare function chatCompletion(systemPrompt: string, userMessage: string): Promise<string>;
-//# sourceMappingURL=llm.d.ts.map

package/dist/memory/llm.js

@@ -1,56 +0,0 @@
-import OpenAI from 'openai';
-import Anthropic from '@anthropic-ai/sdk';
-import { getConfig } from '../config.js';
-import { MemoryError } from '../errors.js';
-export async function chatCompletion(systemPrompt, userMessage) {
-    const config = getConfig();
-    if (config.memoryLlmProvider === 'anthropic') {
-        const apiKey = config.memoryLlmApiKey ?? config.anthropicApiKey ?? config.openaiApiKey;
-        if (!apiKey) {
-            throw new MemoryError('No API key configured for memory LLM. Set MEMORY_LLM_API_KEY, ANTHROPIC_API_KEY, or OPENAI_API_KEY.');
-        }
-        const client = new Anthropic({ apiKey });
-        try {
-            const response = await client.messages.create({
-                model: config.memoryLlmModel,
-                max_tokens: 2048,
-                system: systemPrompt,
-                messages: [{ role: 'user', content: userMessage }],
-            });
-            const block = response.content[0];
-            return block?.type === 'text' ? block.text : '{}';
-        }
-        catch (err) {
-            throw new MemoryError('Memory LLM call failed', err);
-        }
-    }
-    // OpenAI / Ollama path
-    const apiKey = config.memoryLlmApiKey ?? config.openaiApiKey;
-    if (!apiKey) {
-        throw new MemoryError('No API key configured for memory LLM. Set MEMORY_LLM_API_KEY or OPENAI_API_KEY.');
-    }
-    let baseURL;
-    if (config.memoryLlmBaseUrl) {
-        baseURL = config.memoryLlmBaseUrl;
-    }
-    else if (config.memoryLlmProvider === 'ollama') {
-        baseURL = config.ollamaBaseUrl;
-    }
-    const client = new OpenAI({ apiKey, ...(baseURL ? { baseURL } : {}) });
-    try {
-        const response = await client.chat.completions.create({
-            model: config.memoryLlmModel,
-            messages: [
-                { role: 'system', content: systemPrompt },
-                { role: 'user', content: userMessage },
-            ],
-            temperature: 0,
-            response_format: { type: 'json_object' },
-        });
-        return response.choices[0]?.message?.content ?? '{}';
-    }
-    catch (err) {
-        throw new MemoryError('Memory LLM call failed', err);
-    }
-}
-//# sourceMappingURL=llm.js.map

package/dist/memory/prompts.d.ts

@@ -1,5 +0,0 @@
-export declare const FACT_EXTRACTION_SYSTEM_PROMPT = "You are a developer knowledge extractor. Your job is to extract discrete, factual statements from conversations about software development.\n\nExtract facts about:\n- **coding_style**: Formatting preferences (tabs/spaces, naming conventions, line length), code style rules\n- **tools**: Preferred tools, frameworks, libraries, test runners, bundlers, linters, editors\n- **architecture**: Design patterns, architectural decisions, system design preferences\n- **conventions**: Project conventions, commit message formats, branch naming, PR workflows\n- **debugging**: Solutions to specific bugs, debugging techniques, known issues\n- **workflow**: Development habits, deployment processes, review preferences\n- **preferences**: General preferences, opinions, requirements that don't fit other categories\n\nRules:\n1. Extract only factual, concrete statements \u2014 not vague observations\n2. Each fact should be a single, self-contained statement\n3. Use third person (\"The user prefers...\" or state the fact directly)\n4. If the input contains no extractable facts, return an empty array\n5. Do NOT extract facts about the conversation itself (e.g., \"the user asked about...\")\n6. Do NOT extract temporary or session-specific information\n7. Prefer specific facts over general ones\n\nRespond with JSON: { \"facts\": [{ \"fact\": \"...\", \"category\": \"...\" }] }\n\nCategories: coding_style, tools, architecture, conventions, debugging, workflow, preferences";
-export declare const FACT_EXTRACTION_USER_TEMPLATE = "Extract developer knowledge facts from this text:\n\n<text>\n{content}\n</text>";
-export declare function buildSystemPrompt(): string;
-export declare function buildExtractionPrompt(content: string): string;
-//# sourceMappingURL=prompts.d.ts.map

package/dist/memory/prompts.js

@@ -1,36 +0,0 @@
-export const FACT_EXTRACTION_SYSTEM_PROMPT = `You are a developer knowledge extractor. Your job is to extract discrete, factual statements from conversations about software development.
-
-Extract facts about:
-- **coding_style**: Formatting preferences (tabs/spaces, naming conventions, line length), code style rules
-- **tools**: Preferred tools, frameworks, libraries, test runners, bundlers, linters, editors
-- **architecture**: Design patterns, architectural decisions, system design preferences
-- **conventions**: Project conventions, commit message formats, branch naming, PR workflows
-- **debugging**: Solutions to specific bugs, debugging techniques, known issues
-- **workflow**: Development habits, deployment processes, review preferences
-- **preferences**: General preferences, opinions, requirements that don't fit other categories
-
-Rules:
-1. Extract only factual, concrete statements — not vague observations
-2. Each fact should be a single, self-contained statement
-3. Use third person ("The user prefers..." or state the fact directly)
-4. If the input contains no extractable facts, return an empty array
-5. Do NOT extract facts about the conversation itself (e.g., "the user asked about...")
-6. Do NOT extract temporary or session-specific information
-7. Prefer specific facts over general ones
-
-Respond with JSON: { "facts": [{ "fact": "...", "category": "..." }] }
-
-Categories: coding_style, tools, architecture, conventions, debugging, workflow, preferences`;
-export const FACT_EXTRACTION_USER_TEMPLATE = `Extract developer knowledge facts from this text:
-
-<text>
-{content}
-</text>`;
-export function buildSystemPrompt() {
-    const today = new Date().toISOString().slice(0, 10);
-    return `${FACT_EXTRACTION_SYSTEM_PROMPT}\n- Today's date is ${today}.`;
-}
-export function buildExtractionPrompt(content) {
-    return FACT_EXTRACTION_USER_TEMPLATE.replace('{content}', content);
-}
-//# sourceMappingURL=prompts.js.map