@a13xu/lucid 1.9.4 → 1.9.5

package/README.md

@@ -1,8 +1,14 @@
 # @a13xu/lucid
 
+[![npm version](https://img.shields.io/npm/v/@a13xu/lucid)](https://www.npmjs.com/package/@a13xu/lucid)
+[![npm downloads](https://img.shields.io/npm/dm/@a13xu/lucid)](https://www.npmjs.com/package/@a13xu/lucid)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+> **MCP server for Claude Code** — persistent memory, smart code indexing, and code quality validation. Works out of the box with zero configuration.
+
 Token-efficient memory, code indexing, and validation for Claude Code agents — backed by **SQLite + FTS5**.
 
-Stores a persistent knowledge graph (entities, relations, observations), indexes source files as compressed binary with change detection, retrieves minimal relevant context via TF-IDF or Qdrant, and validates code for LLM drift patterns.
+Stores a persistent knowledge graph (entities, relations, observations), indexes source files as compressed binary with change detection, retrieves minimal relevant context via TF-IDF or Qdrant, and validates code for LLM drift patterns. Supports TypeScript, JavaScript, Python, **Vue, Nuxt**.
 
 ## Install
 
@@ -226,6 +232,15 @@ echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"capabilities":{},
 
 In Claude Code: run `/mcp` — you should see `lucid` with 20 tools.
 
+## Contributing
+
+Bug reports and pull requests are welcome on [GitHub](https://github.com/a13xu/lucid).
+
+1. Fork the repo
+2. `npm install` → `npm run build`
+3. Test locally: `claude mcp add --transport stdio lucid-dev -- node /path/to/lucid/build/index.js`
+4. Open a PR
+
 ## Tech stack
 
 - **Runtime:** Node.js 18+, TypeScript, ES modules

package/build/index.js

@@ -52,7 +52,7 @@ else {
 // ---------------------------------------------------------------------------
 // MCP Server
 // ---------------------------------------------------------------------------
-const server = new Server({ name: "lucid", version: "1.9.4" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "lucid", version: "1.9.5" }, { capabilities: { tools: {} } });
 // ---------------------------------------------------------------------------
 // Tool definitions
 // ---------------------------------------------------------------------------

package/build/indexer/file.d.ts

@@ -6,6 +6,8 @@ export interface FileIndex {
     todos: string[];
     language: string;
 }
+/** Build a FileIndex from already-read source — no IO. */
+export declare function buildFileIndex(filepath: string, source: string): FileIndex;
 export declare function indexFile(filepath: string): FileIndex | null;
 export interface UpsertResult {
     observations: string[];

package/build/indexer/file.js

@@ -73,14 +73,8 @@ function extractGeneric(source) {
     }
     return { exports: [], description: "", todos };
 }
-export function indexFile(filepath) {
-    let source;
-    try {
-        source = readFileSync(filepath, { encoding: "utf-8" });
-    }
-    catch {
-        return null;
-    }
+/** Build a FileIndex from already-read source — no IO. */
+export function buildFileIndex(filepath, source) {
     const ext = extname(filepath).toLowerCase();
     const module = filepath.replace(/\\/g, "/");
     let extracted;
@@ -103,6 +97,16 @@ export function indexFile(filepath) {
     }
     return { module, language, ...extracted };
 }
+export function indexFile(filepath) {
+    let source;
+    try {
+        source = readFileSync(filepath, { encoding: "utf-8" });
+    }
+    catch {
+        return null;
+    }
+    return buildFileIndex(filepath, source);
+}
 export function upsertFileIndex(index, source, stmts) {
     const fileHash = sha256(source);
     // Change detection — skip everything se hash-ul e identic

package/build/indexer/project.js

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync, readdirSync, statSync } from "fs";
 import { join, extname, basename } from "path";
+import { buildFileIndex, upsertFileIndex } from "./file.js";
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
@@ -232,54 +233,23 @@ const MAX_SOURCE_FILES = 10_000;
 function indexSourceFile(filepath, rootDir, projectName, stmts) {
     const content = readFile(filepath);
     if (!content)
-        return [];
-    const exports = [];
-    const lang = extname(filepath);
-    // TypeScript / JavaScript
-    if ([".ts", ".tsx", ".js", ".jsx"].includes(lang)) {
-        for (const m of content.matchAll(/export\s+(?:async\s+)?(?:function|class|const|type|interface)\s+(\w+)/g)) {
-            exports.push(m[1]);
-        }
-    }
-    // Python
-    if (lang === ".py") {
-        for (const m of content.matchAll(/^(?:def|class|async def)\s+(\w+)/gm)) {
-            if (!m[1].startsWith("_"))
-                exports.push(m[1]);
-        }
-    }
-    // Vue SFC — extract component name + defineExpose + named exports from <script>
-    if (lang === ".vue") {
-        // Component name from filename (always present)
-        exports.push(basename(filepath, ".vue"));
-        const scriptMatch = content.match(/<script[^>]*>([\s\S]*?)<\/script>/);
-        if (scriptMatch) {
-            const sc = scriptMatch[1];
-            // defineExpose({ foo, bar }) — what the component exposes to parents via template refs
-            const exposeMatch = sc.match(/defineExpose\(\s*\{([^}]+)\}/);
-            if (exposeMatch) {
-                for (const m of exposeMatch[1].matchAll(/\b([a-zA-Z_]\w*)\b/g)) {
-                    if (!["true", "false", "null", "undefined"].includes(m[1]))
-                        exports.push(m[1]);
-                }
-            }
-            // Named exports (composables, types re-exported from SFC)
-            for (const m of sc.matchAll(/export\s+(?:async\s+)?(?:function|class|const|type|interface)\s+(\w+)/g)) {
-                exports.push(m[1]);
-            }
-        }
-    }
-    if (exports.length === 0)
-        return [];
-    // Cale relativă față de rădăcina proiectului
-    const relPath = filepath.replace(/\\/g, "/").replace(rootDir.replace(/\\/g, "/") + "/", "");
-    const obs = [`exports from ${relPath}: ${exports.slice(0, 10).join(", ")}`];
-    upsert(stmts, projectName, "project", obs);
-    return exports;
+        return { exports: [], stored: false };
+    // Build structured index (language-aware, single read)
+    const fileIdx = buildFileIndex(filepath, content);
+    // Store compressed content in source file index → enables get_context() + grep_code()
+    const result = upsertFileIndex(fileIdx, content, stmts);
+    // Add exports to knowledge graph (for recall())
+    if (fileIdx.exports.length > 0) {
+        const relPath = filepath.replace(/\\/g, "/").replace(rootDir.replace(/\\/g, "/") + "/", "");
+        const obs = [`exports from ${relPath}: ${fileIdx.exports.slice(0, 10).join(", ")}`];
+        upsert(stmts, projectName, "project", obs);
+    }
+    return { exports: fileIdx.exports, stored: result.stored };
 }
 function scanSources(dir, projectName, stmts, results) {
     const rootDir = dir.replace(/\\/g, "/");
     let fileCount = 0;
+    let storedCount = 0;
     const exportedSymbols = [];
     function walk(d) {
         if (fileCount >= MAX_SOURCE_FILES)
@@ -306,9 +276,11 @@ function scanSources(dir, projectName, stmts, results) {
                 walk(full);
             }
             else if (SOURCE_EXTS.has(extname(entry).toLowerCase())) {
-                const syms = indexSourceFile(full, rootDir, projectName, stmts);
+                const { exports: syms, stored } = indexSourceFile(full, rootDir, projectName, stmts);
                 exportedSymbols.push(...syms);
                 fileCount++;
+                if (stored)
+                    storedCount++;
                 if (fileCount >= MAX_SOURCE_FILES)
                     return;
             }
@@ -320,7 +292,7 @@ function scanSources(dir, projectName, stmts, results) {
             entity: projectName,
             type: "project",
             observations: fileCount,
-            source: `${fileCount} source files (${exportedSymbols.length} exports)`,
+            source: `${fileCount} source files (${storedCount} compressed, ${exportedSymbols.length} exports)`,
         });
     }
 }

package/build/tools/sync.js

@@ -6,7 +6,7 @@ import { indexProject } from "../indexer/project.js";
 import { computeDiff } from "../retrieval/context.js";
 import { decompress } from "../store/content.js";
 import { implicitRewardFromSync } from "../memory/experience.js";
-const SUPPORTED_EXTS = new Set([".ts", ".tsx", ".js", ".jsx", ".py", ".go", ".rs"]);
+const SUPPORTED_EXTS = new Set([".ts", ".tsx", ".js", ".jsx", ".vue", ".py", ".go", ".rs"]);
 // ---------------------------------------------------------------------------
 // sync_file
 // ---------------------------------------------------------------------------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a13xu/lucid",
-  "version": "1.9.4",
+  "version": "1.9.5",
   "description": "Token-efficient memory, code indexing, and validation for Claude Code agents — SQLite + FTS5, TF-IDF + Qdrant retrieval, AST skeleton pruning, diff-aware context, Logic Guardian drift detection",
   "type": "module",
   "bin": {
@@ -39,6 +39,9 @@
     "url": "https://github.com/a13xu/lucid.git"
   },
   "homepage": "https://github.com/a13xu/lucid#readme",
+  "publishConfig": {
+    "access": "public"
+  },
   "engines": {
     "node": ">=18"
   },