vaspera-pm 2.10.0 → 2.10.2

package/dist/cli.js

@@ -292,11 +292,13 @@ async function validateApiKey(apiKey) {
         }
       };
     }
+    const errorMessage = error2 instanceof Error ? error2.message : "Unknown error";
+    const isNetworkError = errorMessage.includes("ECONNREFUSED") || errorMessage.includes("ENOTFOUND") || errorMessage.includes("fetch failed") || errorMessage.includes("network");
     return {
       valid: false,
       error: {
-        code: "VPM-INTERNAL-001",
-        message: "Failed to validate API key. Please try again."
+        code: isNetworkError ? "VPM-NETWORK-001" : "VPM-INTERNAL-001",
+        message: isNetworkError ? "Unable to reach VasperaPM servers. Check your internet connection or try again later." : `API key validation failed: ${errorMessage}`
       }
     };
   }
@@ -31713,7 +31715,7 @@ var BANNER = `
 \u2551                                                               \u2551
 \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D\x1B[0m
 `;
-var VERSION7 = true ? "2.10.0" : "2.3.1";
+var VERSION7 = true ? "2.10.1" : "2.3.1";
 var HELP = `
 \x1B[1mUsage:\x1B[0m vaspera-pm <command> [path] [options]
 
@@ -31771,9 +31773,128 @@ var HELP = `
 function getClaudeConfigPath() {
   return join23(homedir2(), ".claude", "claude_desktop_config.json");
 }
+function getCursorConfigPath() {
+  return join23(homedir2(), ".cursor", "mcp.json");
+}
+function getProjectMcpConfigPath() {
+  return join23(process.cwd(), ".mcp.json");
+}
 function getVasperaConfigPath() {
   return join23(homedir2(), ".vasperapm", "config.json");
 }
+var VASPERA_PM_INSTRUCTIONS = `
+# VasperaPM Integration
+
+This project uses VasperaPM for AI-powered product management.
+
+## Available MCP Tools
+When VasperaPM MCP server is connected, you have access to these tools:
+- \`synthesize_requirements\` - Extract requirements from documents
+- \`infer_prd_from_code\` - Reverse-engineer PRD from code
+- \`verify_docs_code\` - Detect documentation drift
+- \`generate_api_docs\` - Create OpenAPI specifications
+- \`generate_test_specs\` - Generate test plans
+- \`sync_to_tracker\` - Export to Jira/Linear/GitHub/ADO
+- \`explode_backlog\` - Break features into user stories
+- \`review_prd\` - Quality review PRDs
+
+## Usage Tips
+- Use \`verify_docs_code\` to check if documentation is in sync with code
+- Use \`generate_api_docs\` to auto-generate API documentation
+- Use \`sync_to_tracker\` to export requirements to your project tracker
+`;
+function updateProjectInstructions(projectId) {
+  const cwd = process.cwd();
+  const claudeMdPath = join23(cwd, "CLAUDE.md");
+  const cursorRulesPath = join23(cwd, ".cursorrules");
+  let targetFile;
+  let existingContent = null;
+  if (existsSync19(claudeMdPath)) {
+    targetFile = claudeMdPath;
+    existingContent = readFileSync15(claudeMdPath, "utf-8");
+  } else if (existsSync19(cursorRulesPath)) {
+    targetFile = cursorRulesPath;
+    existingContent = readFileSync15(cursorRulesPath, "utf-8");
+  } else {
+    targetFile = claudeMdPath;
+  }
+  if (existingContent?.includes("# VasperaPM Integration")) {
+    return { updated: false, file: targetFile, action: "Skipped" };
+  }
+  const projectSection = `
+## Project ID
+\`${projectId}\`
+`;
+  const newContent = existingContent ? existingContent.trimEnd() + "\n\n---\n" + VASPERA_PM_INSTRUCTIONS + projectSection : VASPERA_PM_INSTRUCTIONS.trim() + projectSection;
+  writeFileSync6(targetFile, newContent);
+  return {
+    updated: true,
+    file: targetFile.split("/").pop() || targetFile,
+    action: existingContent ? "Updated" : "Created"
+  };
+}
+function detectMcpConfigLocations() {
+  const locations = [
+    { path: getCursorConfigPath(), name: "Cursor (global)" },
+    { path: getClaudeConfigPath(), name: "Claude Desktop (global)" },
+    { path: getProjectMcpConfigPath(), name: "Project (.mcp.json)" }
+  ];
+  return locations.map((loc) => {
+    const config = readJsonFile(loc.path);
+    return {
+      ...loc,
+      exists: config !== null,
+      hasVasperaPm: config?.mcpServers?.["vaspera-pm"] !== void 0
+    };
+  });
+}
+function mergeMcpConfig(configPath, vasperaApiKey, anthropicApiKey) {
+  try {
+    let config = readJsonFile(configPath);
+    const existed = config !== null;
+    if (!config) {
+      config = { mcpServers: {} };
+    }
+    if (!config.mcpServers) {
+      config.mcpServers = {};
+    }
+    const existingVpm = config.mcpServers["vaspera-pm"];
+    if (existingVpm?.env?.VASPERA_API_KEY === vasperaApiKey) {
+      return {
+        success: true,
+        path: configPath,
+        action: "unchanged",
+        message: "vaspera-pm already configured with same API key"
+      };
+    }
+    const mcpEnv = {};
+    if (vasperaApiKey && vasperaApiKey.startsWith("vpm_")) {
+      mcpEnv.VASPERA_API_KEY = vasperaApiKey;
+    }
+    if (anthropicApiKey) {
+      mcpEnv.ANTHROPIC_API_KEY = anthropicApiKey;
+    }
+    config.mcpServers["vaspera-pm"] = {
+      command: "npx",
+      args: ["-y", "vaspera-pm@latest", "serve"],
+      env: mcpEnv
+    };
+    writeJsonFile(configPath, config);
+    return {
+      success: true,
+      path: configPath,
+      action: existed ? "updated" : "created",
+      message: existed ? `Added vaspera-pm to existing config (${Object.keys(config.mcpServers).length} servers total)` : "Created new config with vaspera-pm"
+    };
+  } catch (err) {
+    return {
+      success: false,
+      path: configPath,
+      action: "error",
+      message: err instanceof Error ? err.message : "Unknown error"
+    };
+  }
+}
 function readJsonFile(path7) {
   try {
     if (!existsSync19(path7)) return null;
@@ -31816,23 +31937,20 @@ function warn(message) {
 async function install() {
   console.log(BANNER);
   console.log("\x1B[1mInstalling VasperaPM for Claude Code...\x1B[0m\n");
-  const configPath = getClaudeConfigPath();
-  let config = readJsonFile(configPath);
-  if (!config) {
-    config = { mcpServers: {} };
-    info("Creating Claude Code configuration...");
-  }
-  if (!config.mcpServers) {
-    config.mcpServers = {};
-  }
-  if (config.mcpServers["vaspera-pm"]) {
-    warn("VasperaPM is already installed in Claude Code.");
-    const answer = await prompt("\nDo you want to reinstall? (y/N): ");
-    if (answer.toLowerCase() !== "y") {
-      info("Installation cancelled.");
-      return;
+  console.log("\x1B[1m1. Detecting MCP configurations...\x1B[0m\n");
+  const configLocations = detectMcpConfigLocations();
+  for (const loc of configLocations) {
+    if (loc.exists) {
+      if (loc.hasVasperaPm) {
+        info(`${loc.name}: Found (vaspera-pm already configured)`);
+      } else {
+        success(`${loc.name}: Found (will add vaspera-pm)`);
+      }
+    } else {
+      console.log(`  \x1B[90m${loc.name}: Not found\x1B[0m`);
     }
   }
+  console.log("\n\x1B[1m2. Checking API keys...\x1B[0m\n");
   const vasperaConfig = readJsonFile(getVasperaConfigPath());
   let vasperaApiKey = vasperaConfig?.apiKey || process.env.VASPERA_API_KEY || "";
   let anthropicApiKey = process.env.ANTHROPIC_API_KEY || "";
@@ -31844,7 +31962,7 @@ async function install() {
     info("Using local mode with your Anthropic API key");
     vasperaApiKey = "";
   } else {
-    console.log("\n\x1B[1mAPI Key Setup\x1B[0m");
+    console.log("\x1B[1mAPI Key Setup\x1B[0m");
     console.log("\nVasperaPM needs an API key to work. Choose one:\n");
     console.log("  \x1B[32mOption 1:\x1B[0m Connect to VasperaPM (recommended)");
     console.log("           Run: \x1B[36mvasperapm connect\x1B[0m");
@@ -31866,19 +31984,43 @@ async function install() {
       return;
     }
   }
-  const mcpEnv = {};
-  if (vasperaApiKey && vasperaApiKey.startsWith("vpm_live_")) {
-    mcpEnv.VASPERA_API_KEY = vasperaApiKey;
+  console.log("\n\x1B[1m3. Select configurations to update\x1B[0m\n");
+  const existingConfigs = configLocations.filter((c) => c.exists || c.name.includes("Project"));
+  const configurableConfigs = existingConfigs.length > 0 ? existingConfigs : configLocations.slice(0, 2);
+  console.log("Which MCP configurations should be updated?\n");
+  for (let i = 0; i < configurableConfigs.length; i++) {
+    const loc = configurableConfigs[i];
+    const status2 = loc.hasVasperaPm ? " (already has vaspera-pm)" : "";
+    console.log(`  [${i + 1}] ${loc.name}${status2}`);
   }
-  if (anthropicApiKey) {
-    mcpEnv.ANTHROPIC_API_KEY = anthropicApiKey;
+  console.log(`  [a] All of the above`);
+  console.log(`  [n] None (just show instructions)
+`);
+  const configChoice = await prompt("Select option(s) [1,2,a,n]: ");
+  let selectedConfigs = [];
+  if (configChoice.toLowerCase() === "a") {
+    selectedConfigs = configurableConfigs;
+  } else if (configChoice.toLowerCase() === "n") {
+    selectedConfigs = [];
+  } else {
+    const indices = configChoice.split(",").map((s) => parseInt(s.trim(), 10) - 1);
+    selectedConfigs = indices.filter((i) => i >= 0 && i < configurableConfigs.length).map((i) => configurableConfigs[i]);
+  }
+  if (selectedConfigs.length > 0) {
+    console.log("\n\x1B[1m4. Applying configurations...\x1B[0m\n");
+    for (const loc of selectedConfigs) {
+      const result = mergeMcpConfig(loc.path, vasperaApiKey, anthropicApiKey);
+      if (result.success) {
+        if (result.action === "unchanged") {
+          info(`${loc.name}: ${result.message}`);
+        } else {
+          success(`${loc.name}: ${result.message}`);
+        }
+      } else {
+        error(`${loc.name}: ${result.message}`);
+      }
+    }
   }
-  config.mcpServers["vaspera-pm"] = {
-    command: "vasperapm",
-    args: ["serve"],
-    env: mcpEnv
-  };
-  writeJsonFile(configPath, config);
   if (vasperaApiKey && vasperaApiKey.startsWith("vpm_live_")) {
     const vasperaDir = join23(homedir2(), ".vasperapm");
     if (!existsSync19(vasperaDir)) {
@@ -31887,11 +32029,27 @@ async function install() {
     writeJsonFile(getVasperaConfigPath(), { apiKey: vasperaApiKey });
   }
   console.log("\n");
-  success("VasperaPM installed successfully!");
+  success("VasperaPM installation complete!");
   console.log("\n\x1B[1mNext steps:\x1B[0m");
-  console.log("  1. Restart Claude Code (or VSCode)");
-  console.log("  2. Look for VasperaPM tools in the MCP panel");
-  console.log('  3. Try: "Generate a PRD for a todo app"\n');
+  if (selectedConfigs.length > 0) {
+    console.log("  1. Restart your IDE (Cursor/VSCode/Claude Desktop)");
+    console.log("  2. Look for VasperaPM tools in the MCP panel");
+    console.log('  3. Try: "Generate a PRD for a todo app"\n');
+  } else {
+    console.log("  To manually configure MCP, add this to your mcp.json:\n");
+    console.log('  \x1B[36m"vaspera-pm": {\x1B[0m');
+    console.log('  \x1B[36m  "command": "npx",\x1B[0m');
+    console.log('  \x1B[36m  "args": ["-y", "vaspera-pm@latest", "serve"],\x1B[0m');
+    console.log('  \x1B[36m  "env": {\x1B[0m');
+    if (vasperaApiKey) {
+      console.log(`  \x1B[36m    "VASPERA_API_KEY": "${vasperaApiKey}"\x1B[0m`);
+    }
+    if (anthropicApiKey) {
+      console.log(`  \x1B[36m    "ANTHROPIC_API_KEY": "${anthropicApiKey.substring(0, 10)}..."\x1B[0m`);
+    }
+    console.log("  \x1B[36m  }\x1B[0m");
+    console.log("  \x1B[36m}\x1B[0m\n");
+  }
   console.log("\x1B[1mAvailable Tools (30 total):\x1B[0m");
   console.log("  \x1B[33m\u2022\x1B[0m synthesize_requirements - Extract requirements from docs");
   console.log("  \x1B[33m\u2022\x1B[0m infer_prd_from_code     - Reverse-engineer PRD from code");
@@ -32100,6 +32258,10 @@ async function connect() {
       success("Added .vaspera/ to .gitignore");
     }
   }
+  const claudeMdResult = updateProjectInstructions(projectId);
+  if (claudeMdResult.updated) {
+    success(`${claudeMdResult.action} ${claudeMdResult.file} with VasperaPM context`);
+  }
   console.log("\n");
   success("Project connected successfully!");
   console.log("\n\x1B[1mConfiguration saved to:\x1B[0m .vaspera/config.json");
@@ -32207,13 +32369,25 @@ function parseOptions(args) {
   }
   return { path: path7, output, ci, verbose, agents, debate, format, files, noCache };
 }
+function hasAIKey() {
+  const vasperaKey = process.env.VASPERA_API_KEY;
+  const anthropicKey = process.env.ANTHROPIC_API_KEY;
+  return !!(vasperaKey && vasperaKey.startsWith("vpm_")) || !!anthropicKey;
+}
+function showAIKeyError() {
+  error("API key required for AI-powered analysis");
+  console.log("\nChoose one of these options:\n");
+  console.log("  \x1B[32mOption 1:\x1B[0m Use your VasperaPM account (recommended)");
+  console.log("           Run: \x1B[36mvasperapm connect\x1B[0m");
+  console.log("           Then retry your command.\n");
+  console.log("  \x1B[32mOption 2:\x1B[0m Use your own Anthropic API key");
+  console.log("           \x1B[36mexport ANTHROPIC_API_KEY=sk-ant-xxx\x1B[0m");
+  console.log("           Get one at: https://console.anthropic.com\n");
+}
 async function runAnalyze(args) {
   const options = parseOptions(args);
-  if (!process.env.ANTHROPIC_API_KEY) {
-    error("ANTHROPIC_API_KEY environment variable is required");
-    console.log("\nSet your API key:");
-    console.log("  export ANTHROPIC_API_KEY=sk-ant-xxx");
-    console.log("\nOr get one at: https://console.anthropic.com\n");
+  if (!hasAIKey()) {
+    showAIKeyError();
     process.exit(1);
   }
   if (options.agents) {
@@ -32497,8 +32671,8 @@ async function runVerify(args) {
       fixPreference = args[++i];
     }
   }
-  if (!process.env.ANTHROPIC_API_KEY) {
-    error("ANTHROPIC_API_KEY environment variable is required");
+  if (!hasAIKey()) {
+    showAIKeyError();
     process.exit(1);
   }
   if (options.format === "json" && suggestFixes) {
@@ -32610,8 +32784,8 @@ function formatFixSuggestionsForJSON(suggestions) {
 }
 async function runFix(args) {
   const options = parseOptions(args);
-  if (!process.env.ANTHROPIC_API_KEY) {
-    error("ANTHROPIC_API_KEY environment variable is required");
+  if (!hasAIKey()) {
+    showAIKeyError();
     process.exit(1);
   }
   let interactive = false;
@@ -32926,20 +33100,20 @@ async function runInit() {
   };
   writeJsonFile(configPath, config);
   const mcpConfigPath = join23(process.cwd(), ".mcp.json");
-  if (!existsSync19(mcpConfigPath)) {
-    const mcpConfig = {
-      mcpServers: {
-        "vaspera-pm": {
-          command: "npx",
-          args: ["vaspera-pm@latest", "serve"],
-          env: {
-            ANTHROPIC_API_KEY: "${ANTHROPIC_API_KEY}"
-          }
-        }
-      }
-    };
-    writeJsonFile(mcpConfigPath, mcpConfig);
-    success("Created .mcp.json for Claude Code integration");
+  const mcpResult = mergeMcpConfig(
+    mcpConfigPath,
+    "",
+    // No VasperaPM API key in init (uses ANTHROPIC_API_KEY)
+    anthropicKey || "${ANTHROPIC_API_KEY}"
+  );
+  if (mcpResult.success) {
+    if (mcpResult.action === "created") {
+      success("Created .mcp.json for Claude Code integration");
+    } else if (mcpResult.action === "updated") {
+      success("Added vaspera-pm to existing .mcp.json (preserved other servers)");
+    } else {
+      info(".mcp.json already has vaspera-pm configured");
+    }
   }
   console.log("\n");
   success("VasperaPM initialized successfully!");