@alecsibilia/luca 13.0.0-alpha.1 → 13.0.0-alpha.2

package/dist/chunks/doctor.mjs

@@ -7,7 +7,10 @@ async function executeDoctor(options = {}) {
   logger.info("Running environment diagnostics...\n");
   const { bunRuntimeCheck } = await import('./bun-runtime.mjs');
   const { muninndbHealthCheck } = await import('./muninndb-health.mjs');
+  const { muninnMcpCheck } = await import('./muninn-mcp.mjs');
   const { staleMcpServerCheck } = await import('./stale-mcp-server.mjs');
+  const { staleGlobalSymlinksCheck } = await import('./stale-global-symlinks.mjs');
+  const { legacyPackageCheck } = await import('./legacy-package.mjs');
   const { strayLocalInstallCheck } = await import('./stray-local-install.mjs');
   const allChecks = [
     // Prerequisites
@@ -15,6 +18,9 @@ async function executeDoctor(options = {}) {
     staleMcpServerCheck,
     // Global
     muninndbHealthCheck,
+    muninnMcpCheck,
+    staleGlobalSymlinksCheck,
+    legacyPackageCheck,
     // Project (cwd-dependent)
     strayLocalInstallCheck
   ];

package/dist/chunks/init.mjs

@@ -10,9 +10,9 @@ import 'node:url';
 import 'node:child_process';
 import { g as generateRunId } from '../shared/luca.naWEcQ4B.mjs';
 import { LUCA_VERSION } from '../index.mjs';
-import { d as defaultClaudeHome, r as resolveBundledArtifactsForHooks, i as installSkills } from '../shared/luca.B3saVjJm.mjs';
+import { d as defaultClaudeHome, r as resolveBundledArtifactsForHooks, i as installSkills } from '../shared/luca.BHov6l1O.mjs';
 import { l as logger } from '../shared/luca.dM-MKlNE.mjs';
-import { M as MuninndbInstallResultSchema, r as resolvePlatformTarget, g as getLucaHomePaths, a as MUNINNDB_BINARY_NAME, b as getCommonBinaryPaths, c as resolveMuninndbPort, d as checkMuninndbService, e as MuninndbServiceStatusSchema, w as waitForMuninndbHealthy, f as ensureLucaHome, h as checkMuninndbBinary, i as MUNINNDB_DEFAULT_PORT } from '../shared/luca.BYdjkfnz.mjs';
+import { M as MuninndbInstallResultSchema, r as resolvePlatformTarget, g as getLucaHomePaths, a as MUNINNDB_BINARY_NAME, b as getCommonBinaryPaths, c as resolveMuninndbPort, d as checkMuninndbService, e as MuninndbServiceStatusSchema, w as waitForMuninndbHealthy, f as ensureLucaHome, h as checkMuninndbBinary } from '../shared/luca.BfjhRHhj.mjs';
 import { join as join$1 } from 'pathe';
 import { c as checkPrerequisites, p as promptBunInstall } from '../shared/luca.DTomPq7I.mjs';
 import 'zod';
@@ -689,12 +689,11 @@ const initCommand = defineCommand({
     readout.push(
       "     stores them in MuninnDB; downstream pipeline modes consult them)"
     );
-    const mcpPort = muninndbPort ?? MUNINNDB_DEFAULT_PORT;
     readout.push(
       "  To expose MuninnDB to Claude Code: register it as an MCP server,"
     );
     readout.push(
-      `    e.g. claude mcp add --transport http muninn http://localhost:${mcpPort}/mcp \\`
+      `    e.g. claude mcp add --transport sse muninn http://localhost:8750/mcp \\`
     );
     readout.push(
       '         --header "Authorization: Bearer <your-muninn-api-key>"'

package/dist/chunks/legacy-package.mjs

@@ -0,0 +1,47 @@
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+const CHECK_NAME = "Legacy global package";
+const LEGACY = "@alecsibilia/luca-framework";
+const UMBRELLA = "@alecsibilia/luca";
+function bunGlobalNodeModules() {
+  const bunInstall = process.env.BUN_INSTALL ?? join(homedir(), ".bun");
+  return join(bunInstall, "install", "global", "node_modules");
+}
+function isInstalled(nodeModules, pkg) {
+  return existsSync(join(nodeModules, pkg, "package.json"));
+}
+const legacyPackageCheck = {
+  name: CHECK_NAME,
+  scope: "global",
+  async run() {
+    const nm = bunGlobalNodeModules();
+    const legacyInstalled = isInstalled(nm, LEGACY);
+    if (!legacyInstalled) {
+      return {
+        name: CHECK_NAME,
+        status: "pass",
+        message: `no legacy ${LEGACY} global install`,
+        fixCommand: null,
+        details: null
+      };
+    }
+    const umbrellaInstalled = isInstalled(nm, UMBRELLA);
+    const conflict = umbrellaInstalled ? `Both ${UMBRELLA} and ${LEGACY} are installed globally \u2014 they provide the same \`luca\` binary, so the active one is whichever was installed last.` : `The pre-v13 ${LEGACY} is still installed globally; install ${UMBRELLA} for the v13 CLI.`;
+    const message = umbrellaInstalled ? `legacy ${LEGACY} installed globally (conflicts with ${UMBRELLA})` : `legacy ${LEGACY} still installed globally (pre-v13)`;
+    return {
+      name: CHECK_NAME,
+      status: "warning",
+      message,
+      fixCommand: `bun rm -g ${LEGACY}`,
+      details: [
+        conflict,
+        `Remove the legacy package: bun rm -g ${LEGACY}`,
+        `(reversible \u2014 \`bun add -g ${LEGACY}\` reinstalls it).`
+      ].join("\n  ")
+    };
+  }
+};
+
+export { legacyPackageCheck };

package/dist/chunks/muninn-mcp.mjs

@@ -0,0 +1,104 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+const CHECK_NAME = "MuninnDB MCP wiring";
+const MCP_URL = "http://127.0.0.1:8750/mcp";
+const ADD_COMMAND = 'claude mcp add --transport sse muninn http://localhost:8750/mcp --header "Authorization: Bearer <your-muninn-api-key>"';
+async function readJsonObject(path) {
+  try {
+    const file = Bun.file(path);
+    if (!await file.exists()) return null;
+    const parsed = JSON.parse(await file.text());
+    return parsed !== null && typeof parsed === "object" ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function hasMuninnEntry(mcpServers) {
+  return mcpServers !== null && typeof mcpServers === "object" && "muninn" in mcpServers;
+}
+async function isMuninnRegistered(cwd) {
+  const projectMcp = await readJsonObject(join(cwd, ".mcp.json"));
+  if (hasMuninnEntry(projectMcp?.mcpServers)) return true;
+  const userConfig = await readJsonObject(join(homedir(), ".claude.json"));
+  if (hasMuninnEntry(userConfig?.mcpServers)) return true;
+  const projects = userConfig?.projects;
+  if (projects !== null && typeof projects === "object") {
+    const project = projects[cwd];
+    if (project !== null && typeof project === "object" && hasMuninnEntry(project.mcpServers)) {
+      return true;
+    }
+  }
+  return false;
+}
+async function isMcpReachable() {
+  try {
+    const res = await fetch(MCP_URL, {
+      method: "GET",
+      signal: AbortSignal.timeout(2500)
+    });
+    return res.status >= 200 && res.status < 300 || res.status === 401 || res.status === 403;
+  } catch {
+    return false;
+  }
+}
+const muninnMcpCheck = {
+  name: CHECK_NAME,
+  scope: "global",
+  async run() {
+    const [reachable, registered] = await Promise.all([
+      isMcpReachable(),
+      isMuninnRegistered(process.cwd())
+    ]);
+    if (reachable && registered) {
+      return {
+        name: CHECK_NAME,
+        status: "pass",
+        message: "muninn MCP registered and reachable on :8750",
+        fixCommand: null,
+        details: null
+      };
+    }
+    if (reachable && !registered) {
+      return {
+        name: CHECK_NAME,
+        status: "warning",
+        message: "MuninnDB MCP is up but not registered with Claude Code",
+        fixCommand: ADD_COMMAND,
+        details: [
+          "The MCP endpoint on :8750 is reachable, but no `muninn`",
+          "server is registered, so the pipeline cannot use memory.",
+          "Register it (use the key from `luca vault:init` / .env):",
+          `  ${ADD_COMMAND}`
+        ].join("\n  ")
+      };
+    }
+    if (!reachable && registered) {
+      return {
+        name: CHECK_NAME,
+        status: "warning",
+        message: "muninn MCP registered but endpoint unreachable on :8750",
+        fixCommand: "luca init",
+        details: [
+          "A `muninn` server is registered, but nothing is answering",
+          "on :8750. Is MuninnDB running? Start it with `luca init`",
+          "or `muninn start`, then restart Claude Code."
+        ].join("\n  ")
+      };
+    }
+    return {
+      name: CHECK_NAME,
+      status: "warning",
+      message: "MuninnDB MCP not running and not registered (optional)",
+      fixCommand: ADD_COMMAND,
+      details: [
+        "MuninnDB provides cross-session memory for the pipeline. It is",
+        "optional, but recommended. Start it (`luca init`) and register",
+        "the MCP server:",
+        `  ${ADD_COMMAND}`
+      ].join("\n  ")
+    };
+  }
+};
+
+export { muninnMcpCheck };

package/dist/chunks/muninndb-health.mjs

@@ -1,4 +1,4 @@
-import { h as checkMuninndbBinary, d as checkMuninndbService } from '../shared/luca.BYdjkfnz.mjs';
+import { h as checkMuninndbBinary, d as checkMuninndbService } from '../shared/luca.BfjhRHhj.mjs';
 import 'pathe';
 import 'node:fs';
 import 'node:fs/promises';

package/dist/chunks/stale-global-symlinks.mjs

@@ -0,0 +1,78 @@
+import { lstat, rm, readdir, stat } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+const CHECK_NAME = "Global ~/.claude symlinks";
+const SCANNED_SUBDIRS = ["skills", "commands", "agents", "hooks"];
+async function findBrokenSymlinks() {
+  const claudeRoot = join(homedir(), ".claude");
+  const broken = [];
+  for (const sub of SCANNED_SUBDIRS) {
+    const dir = join(claudeRoot, sub);
+    let entries;
+    try {
+      entries = await readdir(dir, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      if (!entry.isSymbolicLink()) continue;
+      const path = join(dir, entry.name);
+      const resolves = await stat(path).then(
+        () => true,
+        () => false
+      );
+      if (!resolves) broken.push(path);
+    }
+  }
+  return broken;
+}
+function label(path) {
+  return path.replace(homedir(), "~");
+}
+const staleGlobalSymlinksCheck = {
+  name: CHECK_NAME,
+  scope: "global",
+  async run() {
+    const broken = await findBrokenSymlinks();
+    if (broken.length === 0) {
+      return {
+        name: CHECK_NAME,
+        status: "pass",
+        message: "no broken symlinks in ~/.claude",
+        fixCommand: null,
+        details: null
+      };
+    }
+    return {
+      name: CHECK_NAME,
+      status: "warning",
+      message: `${broken.length} broken symlink(s) in ~/.claude (can block 'luca init')`,
+      fixCommand: "luca doctor --fix",
+      details: [
+        "Dangling symlinks (target no longer exists) left by an older",
+        "dev install. They make 'luca init' fail with EEXIST when it",
+        "tries to create a skill/command/agent at the same path:",
+        ...broken.map((p) => `- ${label(p)}`)
+      ].join("\n  ")
+    };
+  },
+  async fix() {
+    const applied = [];
+    const errors = [];
+    for (const path of await findBrokenSymlinks()) {
+      try {
+        await lstat(path);
+        await rm(path, { force: true });
+        applied.push(`removed broken symlink ${label(path)}`);
+      } catch (err) {
+        errors.push(
+          `could not remove ${label(path)}: ${err.message}`
+        );
+      }
+    }
+    return { applied, errors };
+  }
+};
+
+export { staleGlobalSymlinksCheck };

package/dist/chunks/stray-local-install.mjs

@@ -1,4 +1,4 @@
-import { existsSync } from 'node:fs';
+import { existsSync, lstatSync } from 'node:fs';
 import { rm, writeFile, readdir, rmdir } from 'node:fs/promises';
 import { join } from 'node:path';
 import '../shared/luca.CRmaAfXR.mjs';
@@ -7,13 +7,21 @@ import 'node:module';
 import 'node:url';
 import 'node:child_process';
 import '../index.mjs';
-import { l as listBundledArtifacts } from '../shared/luca.B3saVjJm.mjs';
+import { l as listBundledArtifacts } from '../shared/luca.BHov6l1O.mjs';
 import 'zod';
 import 'node:os';
 import 'citty';
 import 'pathe';
 
 const CHECK_NAME = "Stray local install";
+function pathPresent(p) {
+  try {
+    lstatSync(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
 async function readJsonObject(path) {
   try {
     const file = Bun.file(path);
@@ -43,7 +51,7 @@ async function scanStray(cwd) {
   if (bundled) {
     for (const name of bundled.commands) {
       const path = join(claudeDir, "commands", name);
-      if (existsSync(path)) {
+      if (pathPresent(path)) {
         items.push({
           path,
           label: `.claude/commands/${name}`,
@@ -53,7 +61,7 @@ async function scanStray(cwd) {
     }
     for (const name of bundled.agents) {
       const path = join(claudeDir, "agents", name);
-      if (existsSync(path)) {
+      if (pathPresent(path)) {
         items.push({
           path,
           label: `.claude/agents/${name}`,
@@ -63,7 +71,7 @@ async function scanStray(cwd) {
     }
     for (const name of bundled.skills) {
       const path = join(claudeDir, "skills", name);
-      if (existsSync(path)) {
+      if (pathPresent(path)) {
         items.push({
           path,
           label: `.claude/skills/${name}/`,
@@ -73,7 +81,7 @@ async function scanStray(cwd) {
     }
   }
   const hookScript = join(claudeDir, "hooks", "stage-gate.sh");
-  if (existsSync(hookScript)) {
+  if (pathPresent(hookScript)) {
     items.push({
       path: hookScript,
       label: ".claude/hooks/stage-gate.sh",

package/dist/chunks/vault-init.mjs

@@ -11,7 +11,7 @@ import * as p from '@clack/prompts';
 import { defineCommand } from 'citty';
 import { join, basename } from 'pathe';
 import { z } from 'zod';
-import { d as checkMuninndbService, c as resolveMuninndbPort } from '../shared/luca.BYdjkfnz.mjs';
+import { d as checkMuninndbService, c as resolveMuninndbPort } from '../shared/luca.BfjhRHhj.mjs';
 import 'node:os';
 import '../shared/luca.DTomPq7I.mjs';
 import 'semver';
@@ -87,7 +87,9 @@ const VaultConfigSchema = z.object({
   /** MuninnDB API key for authentication. */
   apiKey: z.string().min(1)
 });
-const MUNINNDB_WEB_UI_URL = "http://localhost:8477";
+function muninndbWebUiUrl() {
+  return `http://127.0.0.1:${resolveMuninndbPort()}`;
+}
 function suggestVaultName(context, cwd = process.cwd()) {
   const raw = context.projectName ?? basename(cwd);
   return sanitizeVaultName(raw);
@@ -125,7 +127,7 @@ async function runVaultWizard(context, cwd = process.cwd()) {
     [
       "To generate an API key, open the MuninnDB Web UI:",
       "",
-      `  ${MUNINNDB_WEB_UI_URL}`,
+      `  ${muninndbWebUiUrl()}`,
       "",
       "Navigate to Settings > API Keys and create a new key.",
       "If MuninnDB is not running, you can set this up later."