@a13xu/lucid 1.1.0 → 1.4.0

package/build/tools/init.js

@@ -0,0 +1,110 @@
+import { z } from "zod";
+import { resolve, join } from "path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { indexProject } from "../indexer/project.js";
+export const InitProjectSchema = z.object({
+    directory: z.string().optional(),
+});
+// ---------------------------------------------------------------------------
+// Instalează PostToolUse hook în .claude/settings.json
+// ---------------------------------------------------------------------------
+function installHook(dir) {
+    const claudeDir = join(dir, ".claude");
+    const settingsPath = join(claudeDir, "settings.json");
+    const HOOK_CMD = 'node -e "const p=process.argv[1]; if(p) require(\'child_process\').execSync(\'node \'+require(\'path\').resolve(\'node_modules/.bin/lucid\'||\'\')+\' --noop\', {stdio:\'ignore\'})" "$TOOL_INPUT_PATH" 2>/dev/null || true';
+    // Hook mai simplu și portabil: apelează sync_file prin claude mcp
+    const HOOK = {
+        matcher: "Write|Edit|NotebookEdit",
+        command: "echo '{\"tool\":\"sync_file\",\"path\":\"'\"$TOOL_INPUT_PATH\"'\"}' | true",
+    };
+    // Citim sau cream settings.json
+    let settings = {};
+    if (existsSync(settingsPath)) {
+        try {
+            settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
+        }
+        catch {
+            return { installed: false, reason: "Could not parse .claude/settings.json" };
+        }
+    }
+    // Verifică dacă hook-ul e deja instalat
+    const hooks = settings["hooks"] ?? {};
+    const postToolUse = hooks["PostToolUse"] ?? [];
+    const alreadyInstalled = postToolUse.some((h) => h.matcher?.includes("Write") && String(h).includes("lucid"));
+    if (alreadyInstalled) {
+        return { installed: false, reason: "already installed" };
+    }
+    // Adaugă hook-ul — notifică Claude să cheme sync_file
+    const lucidHook = {
+        matcher: "Write|Edit|NotebookEdit",
+        command: "echo '🔄 Lucid: call sync_file(path) to keep knowledge graph up to date'",
+    };
+    hooks["PostToolUse"] = [...postToolUse, lucidHook];
+    settings["hooks"] = hooks;
+    mkdirSync(claudeDir, { recursive: true });
+    writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
+    return { installed: true, reason: "hook added to .claude/settings.json" };
+}
+// ---------------------------------------------------------------------------
+// Adaugă instrucțiune în CLAUDE.md
+// ---------------------------------------------------------------------------
+const LUCID_SYNC_INSTRUCTION = `
+<!-- LUCID_SYNC -->
+## 🔄 Lucid — Auto-sync after file changes
+
+After EVERY Write, Edit, or NotebookEdit tool call, you MUST immediately call:
+\`\`\`
+sync_file(path="<path of the file you just wrote/edited>")
+\`\`\`
+
+This keeps the Lucid knowledge graph up to date with the latest code.
+If multiple files changed (refactor, git pull), call sync_project() instead.
+<!-- /LUCID_SYNC -->
+`;
+function injectClaudeMdInstruction(dir) {
+    const claudeMdPath = join(dir, "CLAUDE.md");
+    if (!existsSync(claudeMdPath))
+        return false;
+    const content = readFileSync(claudeMdPath, "utf-8");
+    if (content.includes("LUCID_SYNC"))
+        return false; // already injected
+    writeFileSync(claudeMdPath, content.trimEnd() + "\n" + LUCID_SYNC_INSTRUCTION, "utf-8");
+    return true;
+}
+// ---------------------------------------------------------------------------
+// Main handler
+// ---------------------------------------------------------------------------
+export function handleInitProject(stmts, input) {
+    const dir = resolve(input.directory ?? process.cwd());
+    const results = indexProject(dir, stmts);
+    const lines = [`✅ Project indexed: ${dir}`, ``];
+    if (results.length === 0) {
+        lines.push("No indexable files found.");
+        lines.push("Expected: CLAUDE.md, package.json, README.md, src/");
+    }
+    else {
+        lines.push(`Indexed ${results.length} source(s):`);
+        for (const r of results) {
+            lines.push(`  • [${r.type}] "${r.entity}" — ${r.observations} observation(s) from ${r.source}`);
+        }
+    }
+    // Instalează hook PostToolUse
+    lines.push(``);
+    const hookResult = installHook(dir);
+    if (hookResult.installed) {
+        lines.push(`🔗 Claude Code hook installed (.claude/settings.json)`);
+        lines.push(`   After every Write/Edit, you will see a reminder to call sync_file().`);
+    }
+    else {
+        lines.push(`🔗 Hook: ${hookResult.reason}`);
+    }
+    // Injectează instrucțiune în CLAUDE.md
+    const injected = injectClaudeMdInstruction(dir);
+    if (injected) {
+        lines.push(`📋 CLAUDE.md updated with sync_file() instruction`);
+    }
+    lines.push(``);
+    lines.push(`From now on, call sync_file(path) after every file you write or edit.`);
+    lines.push(`Use recall() to query accumulated project knowledge.`);
+    return lines.join("\n");
+}

package/build/tools/sync.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import type { Statements } from "../database.js";
+export declare const SyncFileSchema: z.ZodObject<{
+    path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+}, {
+    path: string;
+}>;
+export declare function handleSyncFile(stmts: Statements, args: z.infer<typeof SyncFileSchema>): string;
+export declare const SyncProjectSchema: z.ZodObject<{
+    directory: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    directory?: string | undefined;
+}, {
+    directory?: string | undefined;
+}>;
+export declare function handleSyncProject(stmts: Statements, args: z.infer<typeof SyncProjectSchema>): string;

package/build/tools/sync.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import { resolve, extname } from "path";
+import { existsSync, readFileSync } from "fs";
+import { indexFile, upsertFileIndex } from "../indexer/file.js";
+import { indexProject } from "../indexer/project.js";
+const SUPPORTED_EXTS = new Set([".ts", ".tsx", ".js", ".jsx", ".py", ".go", ".rs"]);
+// ---------------------------------------------------------------------------
+// sync_file
+// ---------------------------------------------------------------------------
+export const SyncFileSchema = z.object({
+    path: z.string().min(1),
+});
+export function handleSyncFile(stmts, args) {
+    const filepath = resolve(args.path);
+    if (!existsSync(filepath))
+        return `File not found: ${filepath}`;
+    if (!SUPPORTED_EXTS.has(extname(filepath).toLowerCase())) {
+        return `Unsupported file type: ${extname(filepath)}. Supported: ${[...SUPPORTED_EXTS].join(", ")}`;
+    }
+    const index = indexFile(filepath);
+    if (!index)
+        return `Could not read file: ${filepath}`;
+    const source = readFileSync(filepath, "utf-8");
+    const result = upsertFileIndex(index, source, stmts);
+    if (!result.stored) {
+        return `⏭️  Unchanged: ${filepath} (hash match — skipped)`;
+    }
+    const ratio = Math.round((1 - (result.savedBytes + Buffer.byteLength(source, "utf-8") - result.savedBytes) / Buffer.byteLength(source, "utf-8")) * 100);
+    const saved = Math.round(result.savedBytes / 1024 * 10) / 10;
+    const lines = [
+        `✅ Synced: ${filepath}`,
+        `   exports: ${index.exports.join(", ") || "none"}`,
+        `   compressed: saved ${saved}KB`,
+    ];
+    if (index.description)
+        lines.push(`   description: ${index.description}`);
+    if (index.todos.length > 0)
+        lines.push(`   TODOs: ${index.todos.length} open`);
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// sync_project
+// ---------------------------------------------------------------------------
+export const SyncProjectSchema = z.object({
+    directory: z.string().optional(),
+});
+export function handleSyncProject(stmts, args) {
+    const dir = resolve(args.directory ?? process.cwd());
+    const results = indexProject(dir, stmts);
+    if (results.length === 0)
+        return `No changes indexed in: ${dir}`;
+    const stats = stmts.fileStorageStats.get();
+    const ratio = stats.total_original > 0
+        ? Math.round((1 - stats.total_compressed / stats.total_original) * 100)
+        : 0;
+    return [
+        `✅ Project re-synced: ${dir}`,
+        `   ${results.length} source(s) updated`,
+        `   Storage: ${Math.round(stats.total_compressed / 1024)}KB compressed / ${Math.round(stats.total_original / 1024)}KB original (${ratio}% saved)`,
+    ].join("\n");
+}

package/package.json

@@ -1,48 +1,48 @@
-{
-  "name": "@a13xu/lucid",
-  "version": "1.1.0",
-  "description": "Persistent memory for Claude Code agents — SQLite + FTS5 knowledge graph via MCP",
-  "type": "module",
-  "bin": {
-    "lucid": "./build/index.js"
-  },
-  "files": [
-    "build/**/*.js",
-    "build/**/*.d.ts",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "mcp",
-    "claude",
-    "claude-code",
-    "memory",
-    "sqlite",
-    "knowledge-graph",
-    "ai",
-    "anthropic"
-  ],
-  "author": "a13xu",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/a13xu/lucid.git"
-  },
-  "homepage": "https://github.com/a13xu/lucid#readme",
-  "engines": {
-    "node": ">=18"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "better-sqlite3": "^11.0.0",
-    "zod": "^3.23.8"
-  },
-  "devDependencies": {
-    "@types/better-sqlite3": "^7.6.11",
-    "@types/node": "^20.0.0",
-    "typescript": "^5.4.0"
-  }
-}
+{
+  "name": "@a13xu/lucid",
+  "version": "1.4.0",
+  "description": "Persistent memory for Claude Code agents — SQLite + FTS5 knowledge graph via MCP",
+  "type": "module",
+  "bin": {
+    "lucid": "./build/index.js"
+  },
+  "files": [
+    "build/**/*.js",
+    "build/**/*.d.ts",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "claude",
+    "claude-code",
+    "memory",
+    "sqlite",
+    "knowledge-graph",
+    "ai",
+    "anthropic"
+  ],
+  "author": "a13xu",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/a13xu/lucid.git"
+  },
+  "homepage": "https://github.com/a13xu/lucid#readme",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "better-sqlite3": "^11.0.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.11",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0"
+  }
+}