@productbrain/mcp 0.0.1-beta.0 → 0.0.1-beta.10

package/README.md

@@ -1,238 +0,0 @@
-# ProductBrain
-
-The single source of truth for product knowledge — glossary, business rules, tensions, decisions, labels, and relations — accessible as an MCP server in [Claude Desktop](https://claude.ai/download), [Cursor](https://cursor.com), and any MCP-compatible AI assistant.
-
-ProductBrain connects your AI assistant to your team's knowledge base. Ask questions, capture decisions, and build a living knowledge graph without leaving your editor.
-
-## Quick Start (Cloud)
-
-### Option A: Guided setup (recommended)
-
-```bash
-npx productbrain setup
-```
-
-This opens SynergyOS → Settings → API Keys, prompts you to paste your key, and writes the config for Cursor or Claude Desktop.
-
-### Option B: Manual config
-
-**1. Get your API key**
-
-Go to **SynergyOS → Settings → API Keys** and click **Generate Key**. Copy the `pb_sk_...` key.
-
-**2. Configure your AI assistant**
-
-**Claude Desktop** — edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "productbrain": {
-      "command": "npx",
-      "args": ["-y", "productbrain"],
-      "env": {
-        "PRODUCTBRAIN_API_KEY": "pb_sk_your_key_here"
-      }
-    }
-  }
-}
-```
-
-**Cursor** — edit `.cursor/mcp.json` in your project:
-
-```json
-{
-  "mcpServers": {
-    "productbrain": {
-      "command": "npx",
-      "args": ["-y", "productbrain"],
-      "env": {
-        "PRODUCTBRAIN_API_KEY": "pb_sk_your_key_here"
-      }
-    }
-  }
-}
-```
-
-**3. Restart your assistant and verify**
-
-Ask:
-
-> "Use the health tool to check ProductBrain connectivity"
-
-You should see your workspace ID, collection count, and latency.
-
-## Self-Hosted Setup
-
-If you're running your own Convex deployment, use the three-variable config:
-
-```json
-{
-  "mcpServers": {
-    "productbrain": {
-      "command": "npx",
-      "args": ["-y", "productbrain"],
-      "env": {
-        "CONVEX_SITE_URL": "https://your-deployment.convex.site",
-        "MCP_API_KEY": "your-shared-api-key",
-        "WORKSPACE_SLUG": "your-workspace-slug"
-      }
-    }
-  }
-}
-```
-
-| Variable | Where to find it |
-|----------|-----------------|
-| `CONVEX_SITE_URL` | Convex dashboard → Settings → URL (use `*.convex.site`, not `*.convex.cloud`) |
-| `MCP_API_KEY` | Must match the `MCP_API_KEY` env var in your Convex deployment |
-| `WORKSPACE_SLUG` | Your workspace slug from the SynergyOS URL |
-
-## Dev vs Production
-
-Set `PRODUCTBRAIN_URL` to switch between environments:
-
-```json
-{
-  "env": {
-    "PRODUCTBRAIN_API_KEY": "pb_sk_your_key_here",
-    "PRODUCTBRAIN_URL": "http://localhost:3210"
-  }
-}
-```
-
-Omit `PRODUCTBRAIN_URL` to default to production.
-
-## What You Can Do
-
-### Search and explore
-
-- *"Search the glossary for 'tension'"*
-- *"List all business rules in the Governance domain"*
-- *"What is the canonical definition of 'supplier'?"*
-
-### Capture knowledge
-
-- *"Capture a tension: our MCP entry creation takes too many steps"*
-- *"Draft a decision record for choosing Convex over Supabase"*
-- *"Create a business rule about API key rotation"*
-
-### Navigate the knowledge graph
-
-- *"Gather full context around FEAT-001"*
-- *"What entries are related to GT-019?"*
-- *"Suggest links for this new tension"*
-
-### Check quality
-
-- *"Run a quality check on TEN-graph-db"*
-- *"Review business rules for the AI & MCP Integration domain"*
-- *"Verify the glossary against the codebase"*
-
-## Tools (20+)
-
-| Tool | What it does |
-|------|-------------|
-| `health` | Verify connectivity and get workspace stats |
-| `kb-search` | Full-text search across all knowledge entries |
-| `list-collections` | Browse all collection schemas |
-| `list-entries` | Browse entries with optional filters |
-| `get-entry` | Full record with data, labels, relations, history |
-| `smart-capture` | One-call entry creation with auto-linking and quality scoring |
-| `create-entry` | Create with full field control |
-| `update-entry` | Partial update (merges with existing data) |
-| `gather-context` | Multi-hop graph traversal around an entry |
-| `suggest-links` | Discover potential connections |
-| `relate-entries` | Create typed relations between entries |
-| `find-related` | List direct relations for an entry |
-| `quality-check` | Score an entry against collection-specific criteria |
-| `review-rules` | Surface business rules for a domain |
-| `verify` | Check knowledge entries against the actual codebase |
-| `list-labels` | Browse workspace labels |
-| `manage-labels` | Create, update, or delete labels |
-| `label-entry` | Apply or remove labels from entries |
-| `quick-capture` | Minimal-ceremony entry creation |
-| `mcp-audit` | Session audit log with call statistics |
-
-## Resources
-
-| URI | Content |
-|-----|---------|
-| `productbrain://orientation` | System map: architecture, data model, rules, analytics |
-| `productbrain://terminology` | Glossary + standards summary |
-| `productbrain://collections` | All collection schemas with field definitions |
-| `productbrain://{slug}/entries` | All entries in a given collection |
-| `productbrain://labels` | Workspace labels with hierarchy |
-
-## Prompts
-
-| Prompt | Purpose |
-|--------|---------|
-| `review-against-rules` | Structured compliance review against business rules |
-| `name-check` | Check variable/field names against the glossary |
-| `draft-decision-record` | Draft a decision record from context |
-| `draft-rule-from-context` | Draft a business rule from an observation |
-
-## Security
-
-- **Your data stays yours.** The MCP server connects only to your authenticated Convex deployment. No data is shared with third parties.
-- **API key handling.** Cloud keys (`pb_sk_...`) are SHA-256 hashed before storage. Only the prefix is persisted for display. Keys are sent as Bearer tokens over HTTPS.
-- **Workspace scoping.** Each API key is bound to a single workspace. No cross-workspace access is possible.
-- **Analytics are opt-in.** Set `POSTHOG_MCP_KEY` to enable usage analytics. Omit it entirely to disable all tracking.
-
-## Troubleshooting
-
-### "Missing API key" or "Invalid API key"
-
-Your `PRODUCTBRAIN_API_KEY` is missing or incorrect. Generate a new key from SynergyOS Settings → API Keys.
-
-### "CONVEX_SITE_URL environment variable is required"
-
-You're using self-hosted mode but missing the `env` block. Make sure all three variables are set.
-
-### "Workspace not found"
-
-For self-hosted: check your `WORKSPACE_SLUG`. For cloud: your API key may have been revoked.
-
-### "MCP call network error"
-
-The backend is unreachable. If using `PRODUCTBRAIN_URL`, verify the URL is correct and the server is running.
-
-### Server doesn't appear in Claude Desktop / Cursor
-
-Restart the application after editing the config file. In Cursor, check the MCP panel (Cmd+Shift+P → "MCP: Show Panel") for startup errors.
-
-### Enable debug logging
-
-Set `MCP_DEBUG=1` in your config's `env` block to see audit logs in stderr.
-
-## Development
-
-```bash
-# Clone and install
-git clone https://github.com/synergyai-os/productbrain.git
-cd productbrain
-npm install
-
-# Copy env template and fill in your values
-cp .env.mcp.example .env.mcp
-
-# Run in dev mode (TypeScript, hot reload)
-npm run dev
-
-# Build for production
-npm run build
-
-# Run the built version
-npm start
-
-# Typecheck
-npm run typecheck
-
-# Publish beta
-npm run publish:beta
-```
-
-## License
-
-MIT

package/dist/chunk-DGUM43GV.js

@@ -1,11 +0,0 @@
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
-export {
-  __require
-};
-//# sourceMappingURL=chunk-DGUM43GV.js.map

package/dist/setup-K757L5KR.js

@@ -1,227 +0,0 @@
-#!/usr/bin/env node
-import {
-  __require
-} from "./chunk-DGUM43GV.js";
-
-// src/cli/setup.ts
-import { createInterface } from "readline";
-
-// src/cli/config-writer.ts
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
-import { join, dirname } from "path";
-import { homedir, platform } from "os";
-var SERVER_ENTRY_KEY = "productbrain";
-function buildServerEntry(apiKey) {
-  return {
-    command: "npx",
-    args: ["-y", "productbrain"],
-    env: { PRODUCTBRAIN_API_KEY: apiKey }
-  };
-}
-function getCursorConfigPath() {
-  return join(process.cwd(), ".cursor", "mcp.json");
-}
-function getClaudeDesktopConfigPath() {
-  const os = platform();
-  if (os === "darwin") {
-    return join(
-      homedir(),
-      "Library",
-      "Application Support",
-      "Claude",
-      "claude_desktop_config.json"
-    );
-  }
-  if (os === "win32") {
-    const appData = process.env.APPDATA ?? join(homedir(), "AppData", "Roaming");
-    return join(appData, "Claude", "claude_desktop_config.json");
-  }
-  return null;
-}
-function isCursorProject() {
-  return existsSync(join(process.cwd(), ".cursor")) || existsSync(join(process.cwd(), ".cursorignore"));
-}
-function isClaudeDesktopInstalled() {
-  const configPath = getClaudeDesktopConfigPath();
-  if (!configPath) return false;
-  return existsSync(dirname(configPath));
-}
-function detectClients() {
-  const clients = [];
-  if (isCursorProject()) {
-    clients.push({ name: "Cursor", configPath: getCursorConfigPath() });
-  }
-  if (isClaudeDesktopInstalled()) {
-    clients.push({
-      name: "Claude Desktop",
-      configPath: getClaudeDesktopConfigPath()
-    });
-  }
-  return clients;
-}
-function readJsonSafe(path) {
-  if (!existsSync(path)) return {};
-  try {
-    return JSON.parse(readFileSync(path, "utf-8"));
-  } catch {
-    return {};
-  }
-}
-async function writeClientConfig(client, apiKey) {
-  const config = readJsonSafe(client.configPath);
-  const serversKey = "mcpServers";
-  if (!config[serversKey]) config[serversKey] = {};
-  if (config[serversKey][SERVER_ENTRY_KEY]) {
-    return false;
-  }
-  config[serversKey][SERVER_ENTRY_KEY] = buildServerEntry(apiKey);
-  const dir = dirname(client.configPath);
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
-  }
-  writeFileSync(client.configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
-  return true;
-}
-
-// src/cli/setup.ts
-var SYNERGYOS_APP_URL = process.env.SYNERGYOS_APP_URL ?? process.env.PRODUCTBRAIN_APP_URL ?? "http://localhost:5173";
-function bold(s) {
-  return `\x1B[1m${s}\x1B[0m`;
-}
-function green(s) {
-  return `\x1B[32m${s}\x1B[0m`;
-}
-function dim(s) {
-  return `\x1B[2m${s}\x1B[0m`;
-}
-function orange(s) {
-  return `\x1B[33m${s}\x1B[0m`;
-}
-function log(msg) {
-  process.stdout.write(`${msg}
-`);
-}
-function openBrowser(url) {
-  const { execSync } = __require("child_process");
-  const platform2 = process.platform;
-  try {
-    if (platform2 === "darwin") execSync(`open "${url}"`);
-    else if (platform2 === "win32") execSync(`start "" "${url}"`);
-    else execSync(`xdg-open "${url}"`);
-  } catch {
-    log(dim(`  Could not open browser automatically.`));
-    log(`  Open this URL manually: ${url}`);
-  }
-}
-function prompt(question) {
-  return new Promise((resolve) => {
-    const rl = createInterface({ input: process.stdin, output: process.stdout });
-    rl.question(question, (answer) => {
-      rl.close();
-      resolve(answer.trim());
-    });
-  });
-}
-function promptChoice(question, choices) {
-  return new Promise((resolve) => {
-    log("");
-    log(bold(question));
-    choices.forEach((c, i) => log(`  ${i + 1}) ${c}`));
-    const rl = createInterface({ input: process.stdin, output: process.stdout });
-    rl.question(`
-  ${dim("Choice [1]:")} `, (line) => {
-      rl.close();
-      const n = parseInt(line.trim(), 10);
-      if (isNaN(n) || n < 1 || n > choices.length) {
-        resolve(0);
-      } else {
-        resolve(n - 1);
-      }
-    });
-  });
-}
-async function runSetup() {
-  log("");
-  log(bold(`  Product${orange("Brain")} Setup`));
-  log(dim("  Connect your AI assistant to your knowledge base\n"));
-  const apiKeysUrl = `${SYNERGYOS_APP_URL}/settings/api-keys`;
-  log(`  ${dim("1. Get your API key from SynergyOS")}`);
-  log(`     ${dim(apiKeysUrl)}
-`);
-  const openNow = await prompt(`  Open this URL in your browser? [Y/n]: `);
-  if (openNow.toLowerCase() !== "n" && openNow.toLowerCase() !== "no") {
-    openBrowser(apiKeysUrl);
-  }
-  log("");
-  log(`  ${dim("2. Generate a key (if you don't have one), then copy it.\n")}`);
-  const apiKey = await prompt(`  Paste your API key (pb_sk_...): `);
-  if (!apiKey || !apiKey.startsWith("pb_sk_")) {
-    log(`  ${orange("!")} Invalid key format. Keys start with pb_sk_.`);
-    log(`  Get one at ${apiKeysUrl}
-`);
-    process.exit(1);
-  }
-  log(`  ${green("\u2713")} Key received
-`);
-  const clients = detectClients();
-  if (clients.length === 0) {
-    log(bold("  No supported MCP clients detected.\n"));
-    printConfigSnippet(apiKey);
-    return;
-  }
-  const clientNames = clients.map((c) => c.name);
-  const allOption = clients.length > 1 ? [...clientNames, "All of the above", "Just show me the config"] : [...clientNames, "Just show me the config"];
-  const choice = await promptChoice("Which AI assistant should I configure?", allOption);
-  if (choice === allOption.length - 1) {
-    printConfigSnippet(apiKey);
-  } else if (clients.length > 1 && choice === allOption.length - 2) {
-    for (const client of clients) {
-      await writeConfig(client, apiKey);
-    }
-  } else {
-    await writeConfig(clients[choice], apiKey);
-  }
-  log("");
-  log(
-    `  ${green("\u2713")} Done! Restart your AI assistant and try: ${bold('"Use the health tool"')}`
-  );
-  log("");
-}
-async function writeConfig(client, apiKey) {
-  try {
-    const wrote = await writeClientConfig(client, apiKey);
-    if (wrote) {
-      log(`  ${green("\u2713")} Wrote config to ${dim(client.configPath)}`);
-    } else {
-      log(`  ${dim("\u2139")} ${client.name} already configured \u2014 skipped`);
-    }
-  } catch (err) {
-    log(`  ${orange("!")} Could not write ${client.name} config: ${err.message}`);
-    printConfigSnippet(apiKey);
-  }
-}
-function printConfigSnippet(apiKey) {
-  log("");
-  log(bold("  Add this to your MCP client config:\n"));
-  const snippet = JSON.stringify(
-    {
-      mcpServers: {
-        productbrain: {
-          command: "npx",
-          args: ["-y", "productbrain"],
-          env: { PRODUCTBRAIN_API_KEY: apiKey }
-        }
-      }
-    },
-    null,
-    2
-  );
-  for (const line of snippet.split("\n")) {
-    log(`    ${line}`);
-  }
-  log("");
-}
-export {
-  runSetup
-};
-//# sourceMappingURL=setup-K757L5KR.js.map

package/dist/setup-K757L5KR.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/cli/setup.ts","../src/cli/config-writer.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * `npx productbrain setup`\n *\n * Guided onboarding: get API key from SynergyOS, paste it, and write MCP config.\n * No GitHub — keys come from SynergyOS → Settings → API Keys.\n */\n\nimport { createInterface } from \"node:readline\";\nimport { detectClients, writeClientConfig, type McpClientInfo } from \"./config-writer.js\";\n\nconst SYNERGYOS_APP_URL =\n  process.env.SYNERGYOS_APP_URL ?? process.env.PRODUCTBRAIN_APP_URL ?? \"http://localhost:5173\";\n\n// ── Helpers ─────────────────────────────────────────────────────────────\n\nfunction bold(s: string) {\n  return `\\x1b[1m${s}\\x1b[0m`;\n}\nfunction green(s: string) {\n  return `\\x1b[32m${s}\\x1b[0m`;\n}\nfunction dim(s: string) {\n  return `\\x1b[2m${s}\\x1b[0m`;\n}\nfunction orange(s: string) {\n  return `\\x1b[33m${s}\\x1b[0m`;\n}\n\nfunction log(msg: string) {\n  process.stdout.write(`${msg}\\n`);\n}\n\nfunction openBrowser(url: string) {\n  const { execSync } = require(\"node:child_process\") as typeof import(\"node:child_process\");\n  const platform = process.platform;\n  try {\n    if (platform === \"darwin\") execSync(`open \"${url}\"`);\n    else if (platform === \"win32\") execSync(`start \"\" \"${url}\"`);\n    else execSync(`xdg-open \"${url}\"`);\n  } catch {\n    log(dim(`  Could not open browser automatically.`));\n    log(`  Open this URL manually: ${url}`);\n  }\n}\n\nfunction prompt(question: string): Promise<string> {\n  return new Promise((resolve) => {\n    const rl = createInterface({ input: process.stdin, output: process.stdout });\n    rl.question(question, (answer) => {\n      rl.close();\n      resolve(answer.trim());\n    });\n  });\n}\n\nfunction promptChoice(question: string, choices: string[]): Promise<number> {\n  return new Promise((resolve) => {\n    log(\"\");\n    log(bold(question));\n    choices.forEach((c, i) => log(`  ${i + 1}) ${c}`));\n    const rl = createInterface({ input: process.stdin, output: process.stdout });\n    rl.question(`\\n  ${dim(\"Choice [1]:\")} `, (line) => {\n      rl.close();\n      const n = parseInt(line.trim(), 10);\n      if (isNaN(n) || n < 1 || n > choices.length) {\n        resolve(0);\n      } else {\n        resolve(n - 1);\n      }\n    });\n  });\n}\n\n// ── Main ────────────────────────────────────────────────────────────────\n\nexport async function runSetup() {\n  log(\"\");\n  log(bold(`  Product${orange(\"Brain\")} Setup`));\n  log(dim(\"  Connect your AI assistant to your knowledge base\\n\"));\n\n  const apiKeysUrl = `${SYNERGYOS_APP_URL}/settings/api-keys`;\n\n  log(`  ${dim(\"1. Get your API key from SynergyOS\")}`);\n  log(`     ${dim(apiKeysUrl)}\\n`);\n\n  const openNow = await prompt(`  Open this URL in your browser? [Y/n]: `);\n  if (openNow.toLowerCase() !== \"n\" && openNow.toLowerCase() !== \"no\") {\n    openBrowser(apiKeysUrl);\n  }\n\n  log(\"\");\n  log(`  ${dim(\"2. Generate a key (if you don't have one), then copy it.\\n\")}`);\n\n  const apiKey = await prompt(`  Paste your API key (pb_sk_...): `);\n\n  if (!apiKey || !apiKey.startsWith(\"pb_sk_\")) {\n    log(`  ${orange(\"!\")} Invalid key format. Keys start with pb_sk_.`);\n    log(`  Get one at ${apiKeysUrl}\\n`);\n    process.exit(1);\n  }\n\n  log(`  ${green(\"✓\")} Key received\\n`);\n\n  // 3. Detect MCP clients and write config\n  const clients = detectClients();\n\n  if (clients.length === 0) {\n    log(bold(\"  No supported MCP clients detected.\\n\"));\n    printConfigSnippet(apiKey);\n    return;\n  }\n\n  const clientNames = clients.map((c) => c.name);\n  const allOption =\n    clients.length > 1\n      ? [...clientNames, \"All of the above\", \"Just show me the config\"]\n      : [...clientNames, \"Just show me the config\"];\n\n  const choice = await promptChoice(\"Which AI assistant should I configure?\", allOption);\n\n  if (choice === allOption.length - 1) {\n    printConfigSnippet(apiKey);\n  } else if (clients.length > 1 && choice === allOption.length - 2) {\n    for (const client of clients) {\n      await writeConfig(client, apiKey);\n    }\n  } else {\n    await writeConfig(clients[choice], apiKey);\n  }\n\n  log(\"\");\n  log(\n    `  ${green(\"✓\")} Done! Restart your AI assistant and try: ${bold('\"Use the health tool\"')}`,\n  );\n  log(\"\");\n}\n\nasync function writeConfig(client: McpClientInfo, apiKey: string) {\n  try {\n    const wrote = await writeClientConfig(client, apiKey);\n    if (wrote) {\n      log(`  ${green(\"✓\")} Wrote config to ${dim(client.configPath)}`);\n    } else {\n      log(`  ${dim(\"ℹ\")} ${client.name} already configured — skipped`);\n    }\n  } catch (err: any) {\n    log(`  ${orange(\"!\")} Could not write ${client.name} config: ${err.message}`);\n    printConfigSnippet(apiKey);\n  }\n}\n\nfunction printConfigSnippet(apiKey: string) {\n  log(\"\");\n  log(bold(\"  Add this to your MCP client config:\\n\"));\n  const snippet = JSON.stringify(\n    {\n      mcpServers: {\n        productbrain: {\n          command: \"npx\",\n          args: [\"-y\", \"productbrain\"],\n          env: { PRODUCTBRAIN_API_KEY: apiKey },\n        },\n      },\n    },\n    null,\n    2,\n  );\n  for (const line of snippet.split(\"\\n\")) {\n    log(`    ${line}`);\n  }\n  log(\"\");\n}\n","/**\n * Multi-client MCP config detection and writer.\n *\n * Supports:\n *  - Cursor: .cursor/mcp.json in cwd (project-level)\n *  - Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)\n *                    %APPDATA%/Claude/claude_desktop_config.json (Windows)\n *\n * The writer reads existing config, merges the new server entry (never\n * overwrites existing entries), and writes back. Falls back to printing\n * a snippet for unsupported OS or unknown formats.\n */\n\nimport { existsSync, readFileSync, writeFileSync, mkdirSync } from \"node:fs\";\nimport { join, dirname } from \"node:path\";\nimport { homedir, platform } from \"node:os\";\n\nexport interface McpClientInfo {\n  name: string;\n  configPath: string;\n}\n\nconst SERVER_ENTRY_KEY = \"productbrain\";\n\nfunction buildServerEntry(apiKey: string) {\n  return {\n    command: \"npx\",\n    args: [\"-y\", \"productbrain\"],\n    env: { PRODUCTBRAIN_API_KEY: apiKey },\n  };\n}\n\n// ── Detection ───────────────────────────────────────────────────────────\n\nfunction getCursorConfigPath(): string {\n  return join(process.cwd(), \".cursor\", \"mcp.json\");\n}\n\nfunction getClaudeDesktopConfigPath(): string | null {\n  const os = platform();\n  if (os === \"darwin\") {\n    return join(\n      homedir(),\n      \"Library\",\n      \"Application Support\",\n      \"Claude\",\n      \"claude_desktop_config.json\",\n    );\n  }\n  if (os === \"win32\") {\n    const appData = process.env.APPDATA ?? join(homedir(), \"AppData\", \"Roaming\");\n    return join(appData, \"Claude\", \"claude_desktop_config.json\");\n  }\n  // Linux: no official Claude Desktop location yet\n  return null;\n}\n\nfunction isCursorProject(): boolean {\n  return existsSync(join(process.cwd(), \".cursor\")) || existsSync(join(process.cwd(), \".cursorignore\"));\n}\n\nfunction isClaudeDesktopInstalled(): boolean {\n  const configPath = getClaudeDesktopConfigPath();\n  if (!configPath) return false;\n  // Check if the Claude directory exists (config file may not exist yet)\n  return existsSync(dirname(configPath));\n}\n\nexport function detectClients(): McpClientInfo[] {\n  const clients: McpClientInfo[] = [];\n\n  if (isCursorProject()) {\n    clients.push({ name: \"Cursor\", configPath: getCursorConfigPath() });\n  }\n\n  if (isClaudeDesktopInstalled()) {\n    clients.push({\n      name: \"Claude Desktop\",\n      configPath: getClaudeDesktopConfigPath()!,\n    });\n  }\n\n  return clients;\n}\n\n// ── Writing ─────────────────────────────────────────────────────────────\n\nfunction readJsonSafe(path: string): Record<string, any> {\n  if (!existsSync(path)) return {};\n  try {\n    return JSON.parse(readFileSync(path, \"utf-8\"));\n  } catch {\n    return {};\n  }\n}\n\n/**\n * Write or merge the productbrain server entry into a client config file.\n * Returns true if the config was written, false if already present.\n */\nexport async function writeClientConfig(\n  client: McpClientInfo,\n  apiKey: string,\n): Promise<boolean> {\n  const config = readJsonSafe(client.configPath);\n\n  const serversKey = \"mcpServers\";\n  if (!config[serversKey]) config[serversKey] = {};\n\n  // Don't overwrite an existing productbrain entry\n  if (config[serversKey][SERVER_ENTRY_KEY]) {\n    return false;\n  }\n\n  config[serversKey][SERVER_ENTRY_KEY] = buildServerEntry(apiKey);\n\n  const dir = dirname(client.configPath);\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true });\n  }\n\n  writeFileSync(client.configPath, JSON.stringify(config, null, 2) + \"\\n\", \"utf-8\");\n  return true;\n}\n"],"mappings":"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","names":["platform"]}