@a13xu/lucid 1.12.0 → 1.13.0

package/build/index.js

@@ -21,6 +21,7 @@ import { handleGetContext, GetContextSchema, handleGetRecent, GetRecentSchema, }
 import { handleReward, RewardSchema, handlePenalize, PenalizeSchema, handleShowRewards, ShowRewardsSchema, } from "./tools/reward.js";
 import { handleGetCodingRules, handleCheckCodeQuality, CheckCodeQualitySchema, } from "./tools/coding-guard.js";
 import { handlePlanCreate, PlanCreateSchema, handlePlanList, PlanListSchema, handlePlanGet, PlanGetSchema, handlePlanUpdateTask, PlanUpdateTaskSchema, } from "./tools/plan.js";
+import { UpdateLucidSchema, handleUpdateLucid, checkForUpdatesOnStartup, getCurrentVersion, } from "./tools/updater.js";
 import { GenerateComponentSchema, handleGenerateComponent, ScaffoldPageSchema, handleScaffoldPage, SeoMetaSchema, handleSeoMeta, AccessibilityAuditSchema, handleAccessibilityAudit, ApiClientSchema, handleApiClient, TestGeneratorSchema, handleTestGenerator, ResponsiveLayoutSchema, handleResponsiveLayout, SecurityScanSchema, handleSecurityScan, DesignTokensSchema, handleDesignTokens, PerfHintsSchema, handlePerfHints, } from "./tools/webdev/index.js";
 // ---------------------------------------------------------------------------
 // Init DB
@@ -54,7 +55,7 @@ else {
 // ---------------------------------------------------------------------------
 // MCP Server
 // ---------------------------------------------------------------------------
-const server = new Server({ name: "lucid", version: "1.12.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "lucid", version: "1.13.0" }, { capabilities: { tools: {} } });
 // ---------------------------------------------------------------------------
 // Tool definitions
 // ---------------------------------------------------------------------------
@@ -393,6 +394,23 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 required: ["task_id", "status"],
             },
         },
+        // ── Updater ──────────────────────────────────────────────────────────────
+        {
+            name: "update_lucid",
+            description: "Check for a newer version of Lucid on npm and update automatically. " +
+                "For global npm installs: runs npm install -g @a13xu/lucid@latest. " +
+                "For local source installs: shows git pull + npm run build instructions. " +
+                "After updating, restart Claude Code to load the new version.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    force: {
+                        type: "boolean",
+                        description: "Force reinstall even if already on latest version (default false)",
+                    },
+                },
+            },
+        },
         // ── Web Dev Skills ───────────────────────────────────────────────────────
         {
             name: "generate_component",
@@ -654,6 +672,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case "plan_update_task":
                 text = handlePlanUpdateTask(stmts, PlanUpdateTaskSchema.parse(args));
                 break;
+            // Updater
+            case "update_lucid":
+                text = await handleUpdateLucid(UpdateLucidSchema.parse(args));
+                break;
             // Web Dev Skills
             case "generate_component":
                 text = handleGenerateComponent(GenerateComponentSchema.parse(args));
@@ -703,4 +725,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 // ---------------------------------------------------------------------------
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.error("[lucid] Server started on stdio.");
+console.error(`[lucid] Server v${getCurrentVersion()} started on stdio.`);
+// Non-blocking — logs to stderr if update is available
+checkForUpdatesOnStartup().catch(() => { });

package/build/tools/init.js

@@ -29,6 +29,7 @@ export const InitProjectSchema = z.object({
     projectName: z.string().optional(),
 });
 const LUCID_MARKER = "Lucid: call sync_file";
+const LUCID_UPDATE_MARKER = "lucid-update-check";
 const LUCID_HOOK = {
     matcher: "Write|Edit|NotebookEdit",
     hooks: [
@@ -38,7 +39,27 @@ const LUCID_HOOK = {
         },
     ],
 };
-function installHook(dir) {
+// SessionStart hook: checks npm registry and notifies if update is available.
+// Uses only Node.js built-in https module — no external dependencies required.
+const LUCID_UPDATE_HOOK = {
+    hooks: [
+        {
+            type: "command",
+            command: `node -e "const h=require('https');` +
+                `h.get('https://registry.npmjs.org/@a13xu/lucid/latest',` +
+                `function(r){var d='';r.on('data',function(c){d+=c});` +
+                `r.on('end',function(){` +
+                `try{var v=JSON.parse(d).version;` +
+                `var s=require('child_process').execSync(` +
+                `'npm list -g @a13xu/lucid --depth=0 2>/dev/null',{encoding:'utf8'});` +
+                `var m=s.match(/lucid@([\\d.]+)/);` +
+                `if(m&&m[1]&&v!==m[1])` +
+                `console.log('[Lucid] Update available: v'+m[1]+' → v'+v+'. Call update_lucid().')}` +
+                `catch(e){}})}).on('error',function(){})" 2>/dev/null || true`,
+        },
+    ],
+};
+function installHooks(dir) {
     const claudeDir = join(dir, ".claude");
     const settingsPath = join(claudeDir, "settings.json");
     let settings = {};
@@ -51,20 +72,34 @@ function installHook(dir) {
         }
     }
     const hooks = (settings["hooks"] ?? {});
+    let changed = false;
+    // ── PostToolUse: sync_file reminder ──────────────────────────────────────
     const postToolUse = hooks["PostToolUse"] ?? [];
-    // Detectează atât formatul vechi cât și cel nou
-    const alreadyInstalled = postToolUse.some((h) => {
+    const syncAlreadyInstalled = postToolUse.some((h) => {
         const cmd = h.command ?? h.hooks?.[0]?.command ?? "";
         return cmd.includes(LUCID_MARKER);
     });
-    if (alreadyInstalled) {
+    if (!syncAlreadyInstalled) {
+        hooks["PostToolUse"] = [...postToolUse, LUCID_HOOK];
+        changed = true;
+    }
+    // ── SessionStart: version check ───────────────────────────────────────────
+    const sessionStart = hooks["SessionStart"] ?? [];
+    const updateAlreadyInstalled = sessionStart.some((h) => {
+        const cmd = h.command ?? h.hooks?.[0]?.command ?? "";
+        return cmd.includes(LUCID_UPDATE_MARKER);
+    });
+    if (!updateAlreadyInstalled) {
+        hooks["SessionStart"] = [...sessionStart, LUCID_UPDATE_HOOK];
+        changed = true;
+    }
+    if (!changed) {
         return { installed: false, reason: "already installed" };
     }
-    hooks["PostToolUse"] = [...postToolUse, LUCID_HOOK];
     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" };
+    return { installed: true, reason: "hooks added to .claude/settings.json" };
 }
 // ---------------------------------------------------------------------------
 // Adaugă instrucțiune în CLAUDE.md
@@ -111,13 +146,14 @@ export async function handleInitProject(stmts, input) {
     }
     // ── Hook PostToolUse ──────────────────────────────────────────────────────
     lines.push(``);
-    const hookResult = installHook(dir);
+    const hookResult = installHooks(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().`);
+        lines.push(`🔗 Claude Code hooks installed (.claude/settings.json)`);
+        lines.push(`   PostToolUse: reminder to call sync_file() after every Write/Edit`);
+        lines.push(`   SessionStart: auto-check for Lucid updates on session start`);
     }
     else {
-        lines.push(`🔗 Hook: ${hookResult.reason}`);
+        lines.push(`🔗 Hooks: ${hookResult.reason}`);
     }
     // ── Skills ────────────────────────────────────────────────────────────────
     const skillsResult = installSkills(dir);

package/build/tools/updater.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+export declare function getCurrentVersion(): string;
+export declare function checkForUpdatesOnStartup(): Promise<void>;
+export declare const UpdateLucidSchema: z.ZodObject<{
+    force: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    force?: boolean | undefined;
+}, {
+    force?: boolean | undefined;
+}>;
+export declare function handleUpdateLucid(args: z.infer<typeof UpdateLucidSchema>): Promise<string>;

package/build/tools/updater.js

@@ -0,0 +1,133 @@
+import { z } from "zod";
+import { join } from "path";
+import { readFileSync, existsSync } from "fs";
+import { fileURLToPath } from "url";
+import { execSync } from "child_process";
+// ---------------------------------------------------------------------------
+// Package root resolution
+// ---------------------------------------------------------------------------
+// build/tools/updater.js → ../../ = package root
+const PACKAGE_ROOT = join(fileURLToPath(new URL(".", import.meta.url)), "../..");
+export function getCurrentVersion() {
+    try {
+        const pkg = JSON.parse(readFileSync(join(PACKAGE_ROOT, "package.json"), "utf-8"));
+        return pkg.version ?? "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
+// ---------------------------------------------------------------------------
+// npm registry check
+// ---------------------------------------------------------------------------
+async function fetchLatestVersion() {
+    try {
+        const res = await fetch("https://registry.npmjs.org/@a13xu/lucid/latest", { signal: AbortSignal.timeout(5000) });
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        return data.version ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function compareVersions(a, b) {
+    const pa = a.split(".").map(Number);
+    const pb = b.split(".").map(Number);
+    for (let i = 0; i < 3; i++) {
+        const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (diff !== 0)
+            return diff;
+    }
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// Install method detection
+// ---------------------------------------------------------------------------
+function detectInstallMethod() {
+    // If the package root is inside node_modules, it's npm-installed
+    if (PACKAGE_ROOT.includes("node_modules")) {
+        return "global-npm";
+    }
+    // Check if there's a .git folder — local source checkout
+    if (existsSync(join(PACKAGE_ROOT, ".git"))) {
+        return "local-source";
+    }
+    return "global-npm";
+}
+// ---------------------------------------------------------------------------
+// Startup check (non-blocking — call from index.ts without await)
+// ---------------------------------------------------------------------------
+export async function checkForUpdatesOnStartup() {
+    const current = getCurrentVersion();
+    const latest = await fetchLatestVersion();
+    if (latest && compareVersions(latest, current) > 0) {
+        console.error(`[lucid] ⬆️  Update available: v${current} → v${latest}. ` +
+            `Call update_lucid() to update, or: npm install -g @a13xu/lucid@latest`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Schema & handler
+// ---------------------------------------------------------------------------
+export const UpdateLucidSchema = z.object({
+    force: z
+        .boolean()
+        .optional()
+        .describe("Force reinstall even if already on latest version"),
+});
+// Example call:
+//   handleUpdateLucid({ force: false })
+export async function handleUpdateLucid(args) {
+    const current = getCurrentVersion();
+    const lines = [`🔍 Checking for updates... (current: v${current})`];
+    const latest = await fetchLatestVersion();
+    if (!latest) {
+        return lines.concat("❌ Could not reach npm registry. Check your internet connection.").join("\n");
+    }
+    lines.push(`📦 Latest on npm: v${latest}`);
+    const upToDate = compareVersions(latest, current) <= 0;
+    if (upToDate && !args.force) {
+        lines.push(`✅ Lucid is up to date.`);
+        return lines.join("\n");
+    }
+    if (upToDate && args.force) {
+        lines.push(`⚠️  Already on v${latest}, reinstalling (force=true)...`);
+    }
+    else {
+        lines.push(`🔄 Updating v${current} → v${latest}...`);
+    }
+    const method = detectInstallMethod();
+    if (method === "local-source") {
+        lines.push(``);
+        lines.push(`📁 Local source installation detected (${PACKAGE_ROOT}).`);
+        lines.push(`Run these commands to update:`);
+        lines.push(`  cd "${PACKAGE_ROOT}"`);
+        lines.push(`  git pull`);
+        lines.push(`  npm run build`);
+        lines.push(`Then restart Claude Code.`);
+        return lines.join("\n");
+    }
+    // Global npm install
+    try {
+        lines.push(`Running: npm install -g @a13xu/lucid@${latest}`);
+        execSync(`npm install -g @a13xu/lucid@${latest}`, {
+            timeout: 120_000,
+            stdio: "pipe",
+        });
+        lines.push(`✅ Updated to v${latest}`);
+        lines.push(``);
+        lines.push(`⚠️  Restart Claude Code to load the new version:`);
+        lines.push(`   • VS Code: Cmd/Ctrl+Shift+P → "Restart Claude Code"`);
+        lines.push(`   • CLI: exit and re-run \`claude\``);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        lines.push(`❌ Auto-update failed: ${msg}`);
+        lines.push(`   Run manually: npm install -g @a13xu/lucid@${latest}`);
+        if (process.platform !== "win32") {
+            lines.push(`   Or with sudo: sudo npm install -g @a13xu/lucid@${latest}`);
+        }
+    }
+    return lines.join("\n");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a13xu/lucid",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "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": {