@alecsibilia/luca 13.0.0-alpha.5 → 13.0.0-alpha.6

package/dist/chunks/muninn-mcp.mjs

@@ -1,36 +1,10 @@
-import { homedir } from 'node:os';
-import { join } from 'node:path';
+import { i as isMuninnRegistered } from '../shared/luca.ChU85KSu.mjs';
+import 'node:os';
+import '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, {

package/dist/chunks/vault-init.mjs

@@ -12,6 +12,7 @@ import { defineCommand } from 'citty';
 import { join, basename } from 'pathe';
 import { z } from 'zod';
 import { d as checkMuninndbService, c as resolveMuninndbPort } from '../shared/luca.BfjhRHhj.mjs';
+import { i as isMuninnRegistered } from '../shared/luca.ChU85KSu.mjs';
 import 'node:os';
 import '../shared/luca.DTomPq7I.mjs';
 import 'semver';
@@ -84,8 +85,14 @@ function sanitizeJsonParse(json) {
 const VaultConfigSchema = z.object({
   /** Sanitized vault name in lowercase kebab-case. */
   vaultName: z.string().min(1),
-  /** MuninnDB API key for authentication. */
-  apiKey: z.string().min(1)
+  /**
+   * MuninnDB API key. OPTIONAL — it is an instance-level credential needed
+   * only ONCE to register the MuninnDB MCP server, which then reaches every
+   * vault (the vault is a per-tool-call parameter). When a `muninn` MCP
+   * server is already registered, the wizard records just the vault name and
+   * leaves this unset.
+   */
+  apiKey: z.string().min(1).optional()
 });
 function muninndbWebUiUrl() {
   return `http://127.0.0.1:${resolveMuninndbPort()}`;
@@ -123,16 +130,26 @@ async function runVaultWizard(context, cwd = process.cwd()) {
   });
   if (p.isCancel(vaultName)) return null;
   const finalVaultName = sanitizeVaultName(String(vaultName));
+  if (await isMuninnRegistered(cwd)) {
+    p.log.success(
+      "MuninnDB MCP server already registered \u2014 it reaches every vault, so no API key is needed here."
+    );
+    return { vaultName: finalVaultName };
+  }
   p.note(
     [
-      "To generate an API key, open the MuninnDB Web UI:",
+      "No MuninnDB MCP server is registered with Claude Code yet. The key",
+      "below is an INSTANCE-level credential, captured once to register",
+      "the server \u2014 that single registration then reaches every vault.",
+      "",
+      "Generate one in the MuninnDB Web UI:",
       "",
       `  ${muninndbWebUiUrl()}`,
       "",
-      "Navigate to Settings > API Keys and create a new key.",
-      "If MuninnDB is not running, you can set this up later."
+      "Settings > API Keys > create a new key. You can also skip this and",
+      "register the server later (see `luca doctor`)."
     ].join("\n"),
-    "API Key"
+    "API Key (one-time)"
   );
   const apiKey = await p.password({
     message: "MuninnDB API key (leave empty to skip)"
@@ -141,12 +158,12 @@ async function runVaultWizard(context, cwd = process.cwd()) {
   const trimmedKey = String(apiKey ?? "").trim();
   if (trimmedKey.length === 0) {
     p.log.warn(
-      "No API key provided. You can set MUNINN_API_KEY in .env later."
+      "No API key provided. Vault name recorded; register the MuninnDB MCP server later (see `luca doctor`)."
     );
-    return null;
+    return { vaultName: finalVaultName };
   }
   const confirmed = await p.confirm({
-    message: `Set vault "${finalVaultName}" with the provided API key?`,
+    message: `Set vault "${finalVaultName}" and write the API key to .env?`,
     initialValue: true
   });
   if (p.isCancel(confirmed) || !confirmed) return null;
@@ -173,14 +190,8 @@ async function writeVaultConfig(vaultName, configPath) {
   config.muninn = { ...existing, vault: vaultName };
   await Bun.write(configPath, JSON.stringify(config, null, 2) + "\n");
 }
-async function writeApiKeyToEnv(apiKey, envPath, vaultName) {
-  const vaultKey = vaultName ? `MUNINN_DB_${vaultName.toUpperCase().replace(/[^A-Z0-9]/g, "_")}_API_KEY` : "MUNINN_DB_API_KEY";
-  const envLines = [
-    `${vaultKey}=${apiKey}`,
-    // Default vault key is always needed for cross-cutting memories
-    ...vaultName && vaultName !== "default" ? [`MUNINN_DB_DEFAULT_API_KEY=${apiKey}`] : [],
-    `MUNINN_DB_API_KEY=${apiKey}`
-  ];
+async function writeApiKeyToEnv(apiKey, envPath) {
+  const envLines = [`MUNINN_DB_API_KEY=${apiKey}`];
   const file = Bun.file(envPath);
   if (await file.exists()) {
     let content = await file.text();
@@ -277,14 +288,14 @@ const vaultInitCommand = defineCommand({
     const envPath = join(cwd, ".env");
     await writeVaultConfig(vaultResult.vaultName, configPath);
     p.log.success("Vault name written to .luca/config.json");
-    await writeApiKeyToEnv(
-      vaultResult.apiKey,
-      envPath,
-      vaultResult.vaultName
-    );
-    p.log.success("API key written to .env");
-    await ensureEnvInGitignore(cwd);
-    p.log.success(".env protected in .gitignore");
+    if (vaultResult.apiKey) {
+      await writeApiKeyToEnv(vaultResult.apiKey, envPath);
+      p.log.success("API key written to .env");
+    }
+    if (existsSync(envPath)) {
+      await ensureEnvInGitignore(cwd);
+      p.log.success(".env protected in .gitignore");
+    }
     const reachable = await verifyVaultConnection(vaultResult.vaultName);
     if (reachable) {
       p.log.success(

package/dist/index.mjs

@@ -2,7 +2,7 @@ import { defineCommand, runMain as runMain$1 } from 'citty';
 import 'pathe';
 
 async function resolveVersion() {
-  return "13.0.0-alpha.5";
+  return "13.0.0-alpha.6";
 }
 const LUCA_VERSION = await resolveVersion();
 

package/dist/shared/luca.ChU85KSu.mjs

@@ -0,0 +1,32 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+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;
+}
+
+export { isMuninnRegistered as i };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@alecsibilia/luca",
   "description": "Luca — spec-driven agentic development workflow for Claude Code (umbrella; bundles luca-cli, luca-core, luca-tools)",
-  "version": "13.0.0-alpha.5",
+  "version": "13.0.0-alpha.6",
   "license": "Apache-2.0",
   "author": "Alec Sibilia <sibilia.alec@gmail.com>",
   "homepage": "https://github.com/asibilia/luca-framework#readme",