@brainmcp/brainmcp 0.1.0

package/dist/agent-config.js

@@ -0,0 +1,329 @@
+/** Canonical brainMCP endpoint and product identity. */
+export const BRAIN_MCP_ENDPOINT = 'https://mcp.brainmcp.ai/mcp';
+export const BRAIN_MCP_SERVER_NAME = 'brain';
+export const BRAIN_PRODUCT_ALIASES = ['brain', 'brainmcp', 'brAIn'];
+export const BRAIN_DASHBOARD_URL = 'https://dash.brainmcp.ai';
+export const BRAIN_DOCS_URL = 'https://www.brainmcp.ai/docs';
+export const BRAIN_PROACTIVE_DOCS_URL = 'https://www.brainmcp.ai/docs/configure-proactive-use';
+export const BRAIN_TROUBLESHOOTING_DOCS_URL = 'https://www.brainmcp.ai/docs/troubleshooting';
+export const BRAIN_OAUTH_AUTH_METADATA_URL = 'https://dash.brainmcp.ai/.well-known/oauth-authorization-server';
+export const BRAIN_OAUTH_RESOURCE_METADATA_URL = 'https://mcp.brainmcp.ai/.well-known/oauth-protected-resource';
+/** Bump when always-on guidance text changes in a way clients should refresh. */
+export const GUIDANCE_VERSION = '2026.07.10';
+export const MCP_OAUTH_CLIENT_IDS = {
+    claudeCode: 'claude-code',
+    cursor: 'cursor',
+    generic: 'generic-mcp',
+};
+export const MCP_CLIENT_PROFILES = {
+    'claude-code': {
+        id: 'claude-code',
+        label: 'Claude Code',
+        oauthClientId: MCP_OAUTH_CLIENT_IDS.claudeCode,
+        supportsProjectInstructions: true,
+        supportsPlugins: true,
+        supportsHooks: true,
+        notes: 'Best path: plugin (MCP + Skill + SessionStart/post-compaction reminder). Hooks inject context; they do not guarantee a tool call.',
+    },
+    cursor: {
+        id: 'cursor',
+        label: 'Cursor',
+        oauthClientId: MCP_OAUTH_CLIENT_IDS.cursor,
+        supportsProjectInstructions: true,
+        supportsPlugins: true,
+        supportsHooks: false,
+        notes: 'Best path: Marketplace plugin or .cursor/rules/brainmcp-workspace.mdc (named .mdc with frontmatter). Cursor Cloud Agents need a separate Dashboard MCP connection.',
+    },
+    codex: {
+        id: 'codex',
+        label: 'Codex',
+        supportsProjectInstructions: true,
+        supportsPlugins: false,
+        supportsHooks: false,
+        notes: 'Use AGENTS.md / Agent Skills project install plus HTTP MCP config.',
+    },
+    vscode: {
+        id: 'vscode',
+        label: 'VS Code / Copilot',
+        supportsProjectInstructions: true,
+        supportsPlugins: false,
+        supportsHooks: false,
+        notes: 'Use mcp.json + AGENTS.md / Agent Skills. Prefer static OAuth client when available.',
+    },
+    generic: {
+        id: 'generic',
+        label: 'Generic MCP client',
+        oauthClientId: MCP_OAUTH_CLIENT_IDS.generic,
+        supportsProjectInstructions: true,
+        supportsPlugins: false,
+        supportsHooks: false,
+        notes: 'URL-only setup requires Dynamic Client Registration (or Client ID Metadata Documents). Prefer the static generic-mcp client id when the client supports it.',
+    },
+};
+export const CANONICAL_WORKFLOW_STEPS = [
+    'Pick workspace (brain_workspaces_list if needed; overview may omit workspaceId when a default is configured)',
+    'Orient with brain_workspace_overview and follow recommendedNextActions',
+    'Pull context (search / graph_read / node_read / context_handoff; resolve Skills and due Workflows when recommended)',
+    'Do the work outside brain',
+    'Write back durable learnings (brain_change_propose; digest only as disclosed fallback; comments/reports/workflow runs as needed)',
+];
+/** Overview payload canonicalWorkflow strings (stable, short). */
+export const OVERVIEW_CANONICAL_WORKFLOW = [
+    'Start with brain_workspace_overview (workspaceId optional when a default is configured).',
+    'If recommendations include human review, tell the user before relying on stale graph areas.',
+    'Search relevant nodes with brain_node_search using the current task intent.',
+    'Pull scoped context with brain_context_handoff or brain_graph_read.',
+    'Resolve Skills and due Workflows when the overview recommends them.',
+    'Treat rules returned in this overview as binding for the whole session; other read tools do not repeat them.',
+    'Check summaries.recentDecisions and summaries.recentCommentAcks for human feedback on your prior proposals and reports.',
+    'After meaningful work, propose durable graph updates with brain_change_propose.',
+    'Use brain_session_digest only as a disclosed fallback when the user asks to capture unstructured session learnings — not as an automatic dump of every session.',
+];
+/** Short always-on project instruction block (CLAUDE.md / AGENTS.md / Cursor rules). */
+export function buildProjectInstructionBlock(options) {
+    const workspaceId = options?.workspaceId?.trim();
+    const includeEndpoint = options?.includeEndpoint ?? true;
+    const lines = [
+        '## brain — shared project memory',
+        '',
+        'This project uses brain (also called brainmcp or brAIn) as shared, reviewable agent memory over MCP.',
+        'When the user says "brain" or "brainmcp", use these brain_* tools.',
+    ];
+    if (includeEndpoint) {
+        lines.push(`MCP endpoint: ${BRAIN_MCP_ENDPOINT}`);
+    }
+    if (workspaceId) {
+        lines.push(`Workspace id: ${workspaceId}`);
+    }
+    lines.push('', '- Orient at session start: call brain_workspace_overview (workspaceId optional when this authorization has a default). Follow recommendedNextActions and treat returned Rules/Skills/Workflows as binding.', '- If the target workspace is unclear or the user asks to switch, call brain_workspaces_list and pass the chosen workspaceId to later tools. Keep later reads/writes explicit.', '- Before non-trivial work, pull relevant context with brain_node_search, then brain_graph_read / brain_node_read / brain_context_handoff. Resolve Skills and due Workflows when recommended.', '- After meaningful work, propose precise durable changes with brain_change_propose. Use brain_session_digest only as a disclosed fallback when the user asks to capture unstructured session learnings — not as an automatic dump of every session.', '- brain_change_propose is the only precise graph write path; review-required proposals do not change the graph until a human approves them.', '', `Guidance version: ${GUIDANCE_VERSION}`);
+    return lines.join('\n');
+}
+/** Compact proactive reminder injected by SessionStart / post-compaction hooks. */
+export function buildLifecycleOrientationReminder(options) {
+    const workspaceHint = options?.workspaceId?.trim()
+        ? ` Prefer workspaceId ${options.workspaceId.trim()} when calling tools.`
+        : ' Prefer the authorization default workspace when overview omits workspaceId.';
+    return [
+        'brainMCP reminder: orient with brain_workspace_overview, pull context before non-trivial work, follow Rules/Skills/Workflows, and propose precise durable changes after meaningful work.',
+        'Session digests are a disclosed fallback, not an automatic dump.',
+        workspaceHint.trim(),
+        `Guidance ${GUIDANCE_VERSION}.`,
+    ].join(' ');
+}
+export const WRITE_BACK_REMINDER = 'After meaningful work, propose precise durable graph changes with brain_change_propose. Use brain_session_digest only when the user asks to capture unstructured session learnings as a pending digest — not as an automatic dump of every session.';
+export const AGENT_SKILL_NAME = 'using-brainmcp';
+export const AGENT_SKILL_DESCRIPTION = 'Use brain / brainmcp shared project memory: orient, pull context before work, follow Rules/Skills/Workflows, and write durable learnings back as reviewable proposals.';
+export function buildAgentSkillMarkdown(options) {
+    const workspaceId = options?.workspaceId?.trim();
+    return [
+        '---',
+        `name: ${AGENT_SKILL_NAME}`,
+        `description: ${AGENT_SKILL_DESCRIPTION}`,
+        '---',
+        '',
+        '# Using brainMCP',
+        '',
+        'Trigger this skill when the user mentions brain, brainmcp, project memory, shared agent context, durable learnings, workspace overview, or asks you to save/check/update project knowledge.',
+        '',
+        '## Do this',
+        '',
+        '1. Call `brain_workspace_overview`' +
+            (workspaceId ? ` with workspaceId \`${workspaceId}\`` : ' (omit workspaceId only when a default is configured)') +
+            '.',
+        '2. Follow `recommendedNextActions`, Rules, Skills, and due Workflows.',
+        '3. Before non-trivial work: `brain_node_search` → read/handoff tools.',
+        '4. After meaningful work: `brain_change_propose` for precise durable changes.',
+        '5. Use `brain_session_digest` only as a disclosed fallback when asked to capture unstructured session learnings.',
+        '',
+        '## Do not',
+        '',
+        '- Assume MCP server instructions are already in context — still call overview.',
+        '- Dump every session into a digest automatically.',
+        '- Write the graph by any path other than `brain_change_propose`.',
+        '',
+        buildProjectInstructionBlock({ workspaceId, includeEndpoint: true }),
+    ].join('\n');
+}
+export function renderClaudeMdBlock(options) {
+    return buildProjectInstructionBlock(options);
+}
+export function renderAgentsMdBlock(options) {
+    return buildProjectInstructionBlock(options);
+}
+export function renderCursorMdc(options) {
+    const alwaysApply = options?.alwaysApply ?? true;
+    return [
+        '---',
+        'description: Use brainMCP shared project memory proactively',
+        `alwaysApply: ${alwaysApply}`,
+        '---',
+        '',
+        buildProjectInstructionBlock(options),
+    ].join('\n');
+}
+/** Shared HTTP MCP JSON shape used by Cursor, VS Code, and generic clients. */
+export function buildHttpMcpJson(options) {
+    const server = {
+        url: BRAIN_MCP_ENDPOINT,
+    };
+    if (options?.oauthClientId) {
+        server.auth = { CLIENT_ID: options.oauthClientId };
+    }
+    return JSON.stringify({
+        mcpServers: {
+            [BRAIN_MCP_SERVER_NAME]: server,
+        },
+    }, null, 2);
+}
+export function buildCursorMcpJson(options) {
+    return buildHttpMcpJson({
+        oauthClientId: options?.oauthClientId ?? MCP_OAUTH_CLIENT_IDS.cursor,
+    });
+}
+/**
+ * Claude Code `.mcp.json` server entry. URL-only: Claude Code registers itself
+ * via DCR with its exact loopback callback. (A pre-configured client id would
+ * need the `oauth: { clientId }` shape plus a fixed callback port.)
+ */
+export function buildClaudeCodeMcpJson() {
+    return JSON.stringify({
+        mcpServers: {
+            [BRAIN_MCP_SERVER_NAME]: { type: 'http', url: BRAIN_MCP_ENDPOINT },
+        },
+    }, null, 2);
+}
+/**
+ * VS Code project `.vscode/mcp.json` — VS Code uses a top-level `servers` map
+ * (not `mcpServers`). URL-only; the client completes OAuth via DCR.
+ */
+export function buildVscodeMcpJson() {
+    return JSON.stringify({
+        servers: {
+            [BRAIN_MCP_SERVER_NAME]: { type: 'http', url: BRAIN_MCP_ENDPOINT },
+        },
+    }, null, 2);
+}
+/** Generic / custom client JSON with the static `generic-mcp` client id. */
+export function buildGenericMcpJson() {
+    return buildHttpMcpJson({ oauthClientId: MCP_OAUTH_CLIENT_IDS.generic });
+}
+/** Codex `.codex/config.toml` brain server block (display / manual paste). */
+export function buildCodexConfigToml() {
+    return [`[mcp_servers.${BRAIN_MCP_SERVER_NAME}]`, `url = "${BRAIN_MCP_ENDPOINT}"`, ''].join('\n');
+}
+/**
+ * Canonical Claude Code registration. URL-only on purpose: Claude Code's OAuth
+ * callback is `http://localhost:<random-port>/callback`, and the authorization
+ * server gives registered `localhost` redirects no port flexibility (RFC 8252
+ * §8.3), so Dynamic Client Registration — which registers the exact callback —
+ * is the reliable path. Use the static fallback only when DCR is unavailable.
+ */
+export function buildClaudeCodeMcpAddCommand() {
+    return `claude mcp add --transport http ${BRAIN_MCP_SERVER_NAME} ${BRAIN_MCP_ENDPOINT}`;
+}
+/** Fixed callback port registered for the static `claude-code` OAuth client. */
+export const CLAUDE_CODE_STATIC_FALLBACK_CALLBACK_PORT = 8765;
+/** Static-client fallback for environments where DCR is blocked. The pinned
+ *  callback port must match a redirect URI registered on the `claude-code`
+ *  client (see packages/db/scripts/seed-oauth-clients.ts). */
+export function buildClaudeCodeStaticFallbackCommand() {
+    return `claude mcp add --transport http ${BRAIN_MCP_SERVER_NAME} ${BRAIN_MCP_ENDPOINT} --client-id ${MCP_OAUTH_CLIENT_IDS.claudeCode} --callback-port ${CLAUDE_CODE_STATIC_FALLBACK_CALLBACK_PORT}`;
+}
+/** npm package name for the publishable setup CLI (`npx @brainmcp/brainmcp`). */
+export const BRAINMCP_CLI_PACKAGE = '@brainmcp/brainmcp';
+export function buildBrainmcpInitCommand(options) {
+    const parts = [`npx ${BRAINMCP_CLI_PACKAGE} init`];
+    if (options?.client)
+        parts.push(`--client ${options.client}`);
+    if (options?.workspaceId)
+        parts.push(`--workspace ${options.workspaceId}`);
+    parts.push('--yes');
+    return parts.join(' ');
+}
+export function buildBrainmcpDoctorCommand(options) {
+    const parts = [`npx ${BRAINMCP_CLI_PACKAGE} doctor`];
+    if (options?.workspaceId)
+        parts.push(`--workspace ${options.workspaceId}`);
+    if (options?.client)
+        parts.push(`--client ${options.client}`);
+    return parts.join(' ');
+}
+export function buildServerInstructions() {
+    return [
+        'brain is this project\'s shared, persistent, reviewable memory MCP. It is also called brainmcp; every tool is prefixed brain_. When the user says "use brain", "check brain", "save this to brain", or "use brainmcp", they mean this server.',
+        '',
+        'WHAT IT IS: a graph-native knowledge base for THIS project that outlives a single chat. Knowledge lives as a graph of Cores (major areas) and Neurons (durable notes) joined by described links, plus reusable Skills and scheduled Workflows. It is shared across every agent and session connected to this workspace, and a human reviews changes and overall project state/context in a dashboard.',
+        'WHY USE IT: pull durable project context instead of rediscovering it each session, and write hard-won learnings back so the next agent has them. Graph writes are reviewable proposals with full history — never silent database writes. Comments, session digests, digest claims, workflow-run recording, and clipboard copies are immediate audited side effects (not proposals).',
+        '',
+        'SESSION LOOP:',
+        '1. Pick the target workspace — MCP OAuth is account-scoped, so one authorization can access consented workspaces only. If you do not know the target workspaceId, or the user says to switch/change/use another workspace, call brain_workspaces_list and choose by name, slug, or id. brain_workspace_overview may omit workspaceId when this authorization has a default workspace; keep later reads/writes explicit.',
+        '2. Orient — call brain_workspace_overview for the chosen workspace. It returns identity, review policy, graph health, pending review, due work, writeBackReminder, and ordered recommendedNextActions; follow them.',
+        '3. Pull — brain_node_search to find nodes by task intent, brain_graph_read for surrounding structure, brain_node_read for one node in full, brain_context_handoff to bundle selected nodes into a task packet. Resolve Skills (brain_skill_resolve) and due Workflows (brain_workflow_due) when the overview recommends them.',
+        '4. Do the work outside brain.',
+        '5. Write back — brain_change_propose for precise durable graph learnings (reviewable proposals); brain_session_digest only when the user asks you to capture unstructured session learnings as a pending digest (disclosed fallback, not an automatic dump); brain_tags_set to organize via proposals; brain_comment_create to leave the human a note or report after completing a user task or Workflow run (immediate); brain_workflow_record_run after running a due Workflow (immediate). To create and link new nodes in one proposal, pre-assign UUID targetIds on create_node and reference them from later operations.',
+        '',
+        'CROSS-AGENT CLIPBOARD: brain_copy immediately stores the current relevant message/output (or something the user names) on an account-wide clipboard; brain_paste retrieves the latest clip or the last N (newest first, max 10). No workspaceId is required. Use this to move working context between agents or workspaces without manual copy/paste.',
+        '',
+        'RULES: brain_change_propose is the ONLY way to write the graph — never assume direct mutation. Review-required proposals do not change the graph until a human approves them; auto-apply proposals still record full history. When targetRef is omitted, proposals follow the workspace activeRef returned by read tools; pass targetRef.type=live to force live, or targetRef.type=branch with branchId for a draft (always review-required). brain_digest_pending claims digests (mutating). Read tools redact hidden and encrypted-secret content; large responses truncate with a hint to narrow scope.',
+        '',
+        'BE PROACTIVE: orient at session start without being asked, pull relevant context before non-trivial work, and offer to save durable decisions, conventions, and fixes back to brain after meaningful work. If the workspace is empty, offer to bootstrap it; if work is due or proposals await review, surface it to the user. MCP server instructions are a protocol hint — still call overview even if you already saw this text.',
+        '',
+        'MODELING: use the brain://guide/modeling resource and the overview\'s modelingGuidelines when creating or reshaping graph structure.',
+        'HANDLES: dashboard copy buttons produce brain://node/<id> and brain://comment/<id>; resolve node handles with brain_node_read and comment handles with brain_comment_list using commentId.',
+        'REPORTING: use brain://guide/reporting before authoring rich HTML reports; post failure reports with outcome=\'failure\'.',
+        '',
+        `Guidance version: ${GUIDANCE_VERSION}`,
+    ].join('\n');
+}
+/** Precomputed server instructions string for MCP connect handshake. */
+export const BRAIN_MCP_SERVER_INSTRUCTIONS = buildServerInstructions();
+export function buildCanonicalWorkflowMarkdown(options) {
+    const task = options?.task?.trim();
+    const taskSection = task
+        ? [
+            '## Current task',
+            task,
+            '',
+            'Before working on it: call `brain_workspace_overview`, then `brain_node_search` and/or `brain_context_handoff` for nodes relevant to this task. Resolve skills and due workflows when the overview recommends them.',
+            '',
+        ]
+        : [];
+    return [
+        '# brain session workflow',
+        '',
+        'brain (alias **brainmcp**) is shared, persistent, reviewable project memory. Every tool is prefixed `brain_`.',
+        '',
+        ...taskSection,
+        '## Session loop',
+        '1. **Pick workspace** — OAuth is account-scoped and limited to consented workspaces. If `workspaceId` is unknown or the user wants to switch, call `brain_workspaces_list`. `brain_workspace_overview` may omit `workspaceId` when a default is configured; keep later reads/writes explicit.',
+        '2. **Orient** — `brain_workspace_overview` returns identity, review policy, graph health, pending review, due work, `writeBackReminder`, and `recommendedNextActions`. Follow them.',
+        '3. **Pull** — `brain_node_search` (intent/tags), `brain_graph_read` (structure), `brain_node_read` (one node), `brain_context_handoff` (task packet). Use `brain_skill_resolve` and `brain_workflow_due` when recommended.',
+        '4. **Work** — do the task outside brain.',
+        '5. **Write back** — `brain_change_propose` for precise durable graph learnings; `brain_session_digest` only when the user asks to capture unstructured session learnings (disclosed fallback, not an automatic dump); `brain_tags_set` to organize via proposals; `brain_comment_create` for human notes/reports; `brain_workflow_record_run` after a due workflow.',
+        '',
+        '## Cross-agent clipboard',
+        '- `brain_copy` — immediately store the last relevant message/output (or something the user names) on the account clipboard.',
+        '- `brain_paste` — retrieve the latest clip or the last N (newest first, max 10). No `workspaceId` required.',
+        '',
+        '## Rules',
+        '- `brain_change_propose` is the **only** graph write path — never assume silent mutation.',
+        '- Review-required proposals wait for human approval; auto-apply still records full history.',
+        '- Omit `targetRef` to follow workspace `activeRef` from reads; use `{ type: "live" }` to force live, or `{ type: "branch", branchId }` for a draft (always review-required).',
+        '- Comments, digest capture/claims, workflow-run recording, and clipboard writes are **immediate audited side effects**, not reviewable proposals.',
+        '- `brain_session_digest` never mutates graph memory directly; a later processing session turns candidates into reviewed suggested updates.',
+        '- `brain_digest_pending` is a mutating claim (not read-only).',
+        '- Reads redact hidden and encrypted-secret content; large responses truncate with narrowing hints.',
+        '',
+        '## First calls (typical)',
+        '`brain_workspaces_list` (if needed) → `brain_workspace_overview` → search / read / handoff → work → propose / tags / comments / workflow run',
+        '',
+        '## Handles and reports',
+        '- Resolve `brain://node/<id>` with `brain_node_read` and `brain://comment/<id>` with `brain_comment_list` using `commentId`.',
+        '- Use `brain://guide/reporting` before writing rich HTML reports. Scheduled workflow reports should be posted first with `targetNodeId=<workflowId>`, then linked from `brain_workflow_record_run` with `reportCommentId`.',
+        '',
+        '## Empty workspace',
+        'If the graph is empty, offer to bootstrap: study the repo and propose initial Cores/Neurons/links in one reviewable `brain_change_propose`, using pre-assigned UUID `targetId`s for nodes referenced by same-proposal edges/tags/moves.',
+        '',
+        `Guidance version: ${GUIDANCE_VERSION}`,
+    ].join('\n');
+}

package/dist/commands/index.d.ts

@@ -0,0 +1,17 @@
+import { type ClientId, type Scope } from '../lib/config.js';
+export type CommandOptions = {
+    root: string;
+    client?: ClientId;
+    workspace?: string;
+    scope: Scope;
+    yes: boolean;
+    fetch?: typeof fetch;
+    confirm?: (message: string) => Promise<boolean>;
+    output: (message: string) => void;
+};
+export declare function detectClients(root: string): Promise<ClientId[]>;
+export declare function chooseClient(options: CommandOptions): Promise<ClientId>;
+export declare function init(options: CommandOptions): Promise<void>;
+export declare function remove(options: CommandOptions): Promise<void>;
+export declare function printConfig(options: CommandOptions): Promise<void>;
+export declare function doctor(options: CommandOptions): Promise<void>;

package/dist/commands/index.js

@@ -0,0 +1,153 @@
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { BRAIN_MCP_ENDPOINT } from '../agent-config.js';
+import { clientLabel, renderGuidance, resolveWorkspace, targetFor } from '../lib/config.js';
+import { applyChanges, exists, readText, renderDiff, toAbsolute } from '../lib/files.js';
+import { parseJsonc, removeJsonServer, removeMarkdownBlock, removeTomlBlock, upsertJsonServer, upsertMarkdownBlock, upsertTomlBlock } from '../lib/managed.js';
+export async function detectClients(root) {
+    const candidates = [
+        ['cursor', ['.cursor', '.cursor/mcp.json']],
+        ['claude-code', ['CLAUDE.md', '.mcp.json']],
+        ['codex', ['.codex', '.codex/config.toml']],
+        ['vscode', ['.vscode', '.vscode/mcp.json']],
+    ];
+    const detected = [];
+    for (const [client, paths] of candidates) {
+        if (await Promise.all(paths.map((path) => exists(resolve(root, path)))).then((values) => values.some(Boolean)))
+            detected.push(client);
+    }
+    return detected;
+}
+export async function chooseClient(options) {
+    if (options.client)
+        return options.client;
+    const clients = await detectClients(options.root);
+    if (clients.length === 1)
+        return clients[0];
+    if (clients.length === 0)
+        return 'generic';
+    throw new Error(`Detected multiple clients (${clients.join(', ')}). Choose one with --client.`);
+}
+export async function init(options) {
+    const client = await chooseClient(options);
+    const workspace = resolveWorkspace(options.workspace);
+    const changes = await plannedChanges(options.root, client, options.scope, workspace, 'init');
+    await previewAndApply(changes, options);
+    options.output(`BrainMCP configured for ${clientLabel(client)}. OAuth is discovered at first client connection; no OAuth secret was written.`);
+}
+export async function remove(options) {
+    const client = await chooseClient(options);
+    const changes = await plannedChanges(options.root, client, options.scope, undefined, 'remove');
+    if (changes.every((change) => change.before === change.after)) {
+        options.output('No BrainMCP-managed configuration found.');
+        return;
+    }
+    await previewAndApply(changes, options);
+    options.output(`Removed BrainMCP-managed ${clientLabel(client)} configuration.`);
+}
+export async function printConfig(options) {
+    const client = await chooseClient(options);
+    const workspace = resolveWorkspace(options.workspace);
+    const target = resolveTarget(options.root, targetFor(client, options.scope), options.scope);
+    options.output(`# ${clientLabel(client)} (${options.scope} scope)\n\nMCP configuration: ${target.configPath}\n\n${target.format === 'toml' ? upsertTomlBlock(undefined, client) : upsertJsonServer(undefined, client, target.rootKey)}\nGuidance: ${target.guidancePath}\n\n${renderGuidance(client, workspace)}`);
+}
+export async function doctor(options) {
+    const client = await chooseClient(options);
+    const target = resolveTarget(options.root, targetFor(client, options.scope), options.scope);
+    const checks = [];
+    const config = await readText(target.configPath);
+    const guidance = await readText(target.guidancePath);
+    checks.push(['configuration placement', config !== undefined, config ? target.configPath : `missing ${target.configPath}`]);
+    checks.push(['guidance placement', guidance !== undefined, guidance ? target.guidancePath : `missing ${target.guidancePath}`]);
+    if (config !== undefined) {
+        try {
+            if (target.format === 'jsonc') {
+                const json = parseJsonc(config);
+                const server = json[target.rootKey]?.brain;
+                checks.push(['configuration syntax and endpoint', server?.url === BRAIN_MCP_ENDPOINT, server?.url ?? 'brain server missing']);
+            }
+            else {
+                checks.push(['configuration syntax and endpoint', /\[mcp_servers\.brain\][\s\S]*url\s*=\s*"https:\/\/mcp\.brainmcp\.ai\/mcp"/.test(config), 'brain TOML block']);
+            }
+        }
+        catch (error) {
+            checks.push(['configuration syntax and endpoint', false, error instanceof Error ? error.message : String(error)]);
+        }
+    }
+    if (guidance !== undefined) {
+        const occurrences = (guidance.match(/brainmcp:managed:start/g) ?? []).length;
+        checks.push(['managed guidance markers', occurrences === 1 || client === 'cursor', occurrences === 1 ? 'one managed block' : `${occurrences} managed blocks`]);
+        checks.push(['workspace binding', !options.workspace || guidance.includes(`Workspace id: ${resolveWorkspace(options.workspace)}`), options.workspace ? 'requested workspace binding' : 'no workspace requested']);
+    }
+    const fetchImpl = options.fetch ?? fetch;
+    try {
+        const discovery = await fetchImpl('https://mcp.brainmcp.ai/.well-known/oauth-authorization-server', { headers: { accept: 'application/json' } });
+        checks.push(['OAuth discovery', discovery.ok, `HTTP ${discovery.status}`]);
+    }
+    catch (error) {
+        checks.push(['OAuth discovery', false, error instanceof Error ? error.message : String(error)]);
+    }
+    try {
+        const challenge = await fetchImpl(BRAIN_MCP_ENDPOINT, { headers: { accept: 'application/json, text/event-stream' } });
+        checks.push(['endpoint challenge', challenge.ok || challenge.status === 401 || challenge.status === 405, `HTTP ${challenge.status}`]);
+    }
+    catch (error) {
+        checks.push(['endpoint challenge', false, error instanceof Error ? error.message : String(error)]);
+    }
+    const duplicate = await duplicateGuidance(options.root);
+    checks.push(['duplicate guidance', duplicate.length <= 1, duplicate.length ? duplicate.join(', ') : 'none found']);
+    for (const [name, passed, detail] of checks)
+        options.output(`${passed ? '✓' : '✗'} ${name}: ${detail}`);
+    if (checks.some(([, passed]) => !passed))
+        throw new Error('BrainMCP doctor found configuration issues.');
+}
+async function plannedChanges(root, client, scope, workspace, mode) {
+    const target = resolveTarget(root, targetFor(client, scope), scope);
+    const [config, guidance] = await Promise.all([readText(target.configPath), readText(target.guidancePath)]);
+    return [
+        {
+            path: target.configPath,
+            before: config,
+            after: mode === 'init'
+                ? target.format === 'toml' ? upsertTomlBlock(config, client) : upsertJsonServer(config, client, target.rootKey)
+                : target.format === 'toml' ? removeTomlBlock(config) : removeJsonServer(config, target.rootKey),
+        },
+        {
+            path: target.guidancePath,
+            before: guidance,
+            after: mode === 'init' ? upsertMarkdownBlock(guidance, renderGuidance(client, workspace)) : removeMarkdownBlock(guidance),
+        },
+    ];
+}
+function resolveTarget(root, target, scope) {
+    const base = scope === 'user' ? homedir() : root;
+    return {
+        ...target,
+        configPath: toAbsolute(base, target.configPath),
+        guidancePath: toAbsolute(base, target.guidancePath),
+        format: target.configFormat,
+        rootKey: target.configRootKey,
+    };
+}
+async function previewAndApply(changes, options) {
+    const changed = changes.filter((change) => change.before !== change.after);
+    if (!changed.length) {
+        options.output('BrainMCP configuration is already up to date.');
+        return;
+    }
+    options.output(changed.map(renderDiff).join('\n\n'));
+    if (!options.yes && !(await options.confirm?.('Apply these changes?') ?? false)) {
+        throw new Error('Aborted. Re-run with --yes after reviewing the preview.');
+    }
+    const backups = await applyChanges(changed);
+    options.output(backups.length ? `Backups: ${backups.join(', ')}` : 'Applied new files atomically.');
+}
+async function duplicateGuidance(root) {
+    const paths = ['CLAUDE.md', 'AGENTS.md', '.cursor/rules/brainmcp-workspace.mdc'];
+    const matches = [];
+    for (const path of paths)
+        if ((await readText(join(root, path)))?.includes('brainmcp:managed:start'))
+            matches.push(path);
+    return matches;
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAuB,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,SAAS,EAA6B,MAAM,kBAAkB,CAAC;AACvH,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAmB,MAAM,iBAAiB,CAAC;AAC1G,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAa/J,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY;IAC9C,MAAM,UAAU,GAAgC;QAC9C,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;QAC3C,CAAC,aAAa,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAC3C,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;QAC3C,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;KAC5C,CAAC;IACF,MAAM,QAAQ,GAAe,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;QACzC,IAAI,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxI,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAuB;IACxD,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,CAAC,CAAE,CAAC;IAC7C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAAuB;IAChD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC7F,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,OAAO,CAAC,MAAM,CAAC,2BAA2B,WAAW,CAAC,MAAM,CAAC,gFAAgF,CAAC,CAAC;AACjJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAuB;IAClD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC/F,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9D,OAAO,CAAC,MAAM,CAAC,0CAA0C,CAAC,CAAC;QAC3D,OAAO;IACT,CAAC;IACD,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,OAAO,CAAC,MAAM,CAAC,4BAA4B,WAAW,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAuB;IACvD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5F,OAAO,CAAC,MAAM,CAAC,KAAK,WAAW,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,KAAK,iCAAiC,MAAM,CAAC,UAAU,OAAO,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,eAAe,MAAM,CAAC,YAAY,OAAO,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;AACrT,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAuB;IAClD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5F,MAAM,MAAM,GAAqC,EAAE,CAAC;IACpD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAErD,MAAM,CAAC,IAAI,CAAC,CAAC,yBAAyB,EAAE,MAAM,KAAK,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAC5H,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAoB,EAAE,QAAQ,KAAK,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAC/H,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;gBAC9B,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;gBAChC,MAAM,MAAM,GAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAyC,EAAE,KAAqC,CAAC;gBACpH,MAAM,CAAC,IAAI,CAAC,CAAC,mCAAmC,EAAE,MAAM,EAAE,GAAG,KAAK,kBAAkB,EAAE,MAAM,EAAE,GAAG,IAAI,sBAAsB,CAAC,CAAC,CAAC;YAChI,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,CAAC,mCAAmC,EAAE,2EAA2E,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC;YACnK,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,CAAC,mCAAmC,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpH,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,yBAAyB,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QAC7E,MAAM,CAAC,IAAI,CAAC,CAAC,0BAA0B,EAAE,WAAW,KAAK,CAAC,IAAI,MAAM,KAAK,QAAQ,EAAE,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,WAAW,iBAAiB,CAAC,CAAC,CAAC;QAC/J,MAAM,CAAC,IAAI,CAAC,CAAC,mBAAmB,EAAE,CAAC,OAAO,CAAC,SAAS,IAAI,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC;IACpN,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,gEAAgE,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;QACjJ,MAAM,CAAC,IAAI,CAAC,CAAC,iBAAiB,EAAE,SAAS,CAAC,EAAE,EAAE,QAAQ,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC7E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,CAAC,iBAAiB,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,kBAAkB,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,qCAAqC,EAAE,EAAE,CAAC,CAAC;QACtH,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAoB,EAAE,SAAS,CAAC,EAAE,IAAI,SAAS,CAAC,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,MAAM,KAAK,GAAG,EAAE,QAAQ,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACxI,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAoB,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACrG,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAoB,EAAE,SAAS,CAAC,MAAM,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;IACnH,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM;QAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC;IACxG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;AAC3G,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,IAAY,EAAE,MAAgB,EAAE,KAAY,EAAE,SAA6B,EAAE,IAAuB;IAChI,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IACpE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC3G,OAAO;QACL;YACE,IAAI,EAAE,MAAM,CAAC,UAAU;YACvB,MAAM,EAAE,MAAM;YACd,KAAK,EAAE,IAAI,KAAK,MAAM;gBACpB,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC;gBAC/G,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC;SAClG;QACD;YACE,IAAI,EAAE,MAAM,CAAC,YAAY;YACzB,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,QAAQ,EAAE,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,QAAQ,CAAC;SAC1H;KACF,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,IAAY,EAAE,MAAoC,EAAE,KAAY;IACrF,MAAM,IAAI,GAAG,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACjD,OAAO;QACL,GAAG,MAAM;QACT,UAAU,EAAE,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC;QAC/C,YAAY,EAAE,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC;QACnD,MAAM,EAAE,MAAM,CAAC,YAAY;QAC3B,OAAO,EAAE,MAAM,CAAC,aAAa;KAC9B,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,OAAqB,EAAE,OAAuB;IAC3E,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3E,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO,CAAC,MAAM,CAAC,+CAA+C,CAAC,CAAC;QAChE,OAAO;IACT,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,sBAAsB,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAChF,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC;AACtG,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAC3C,MAAM,KAAK,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,sCAAsC,CAAC,CAAC;IACjF,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,IAAI,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,wBAAwB,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+import { argv, cwd, stdin, stdout } from 'node:process';
+import { createInterface } from 'node:readline/promises';
+import { doctor, init, printConfig, remove } from './commands/index.js';
+import { assertClientId } from './lib/config.js';
+const HELP = `brainmcp — configure BrainMCP for an agent project
+
+Usage:
+  brainmcp init [--client <client>] [--workspace <id>] [--scope project|user] [--yes]
+  brainmcp doctor [--client <client>] [--workspace <id>] [--scope project|user]
+  brainmcp print [--client <client>] [--workspace <id>] [--scope project|user]
+  brainmcp remove [--client <client>] [--scope project|user] [--yes]
+
+Clients: claude-code, cursor, codex, vscode, generic
+Project scope is the default. User scope is explicit and writes under your home directory.
+Every mutation previews a diff and needs confirmation unless --yes is supplied.`;
+async function main() {
+    const [command, ...rawOptions] = argv.slice(2);
+    if (!command || command === '--help' || command === '-h' || command === 'help') {
+        console.log(HELP);
+        return;
+    }
+    const values = parseOptions(rawOptions);
+    const options = {
+        root: values.root ?? cwd(),
+        client: values.client,
+        workspace: values.workspace,
+        scope: values.scope ?? 'project',
+        yes: values.yes,
+        output: console.log,
+        confirm: confirm,
+    };
+    switch (command) {
+        case 'init':
+            await init(options);
+            return;
+        case 'doctor':
+            await doctor(options);
+            return;
+        case 'print':
+            await printConfig(options);
+            return;
+        case 'remove':
+            await remove(options);
+            return;
+        default:
+            throw new Error(`Unknown command: ${command}\n\n${HELP}`);
+    }
+}
+function parseOptions(args) {
+    const result = { yes: false };
+    for (let index = 0; index < args.length; index += 1) {
+        const option = args[index];
+        if (option === '--yes' || option === '-y')
+            result.yes = true;
+        else if (option === '--client')
+            result.client = assertClientId(readValue(args, ++index, option));
+        else if (option === '--workspace')
+            result.workspace = readValue(args, ++index, option);
+        else if (option === '--scope') {
+            const scope = readValue(args, ++index, option);
+            if (scope !== 'project' && scope !== 'user')
+                throw new Error('--scope must be project or user.');
+            result.scope = scope;
+        }
+        else if (option === '--root')
+            result.root = readValue(args, ++index, option);
+        else
+            throw new Error(`Unknown option: ${option}`);
+    }
+    return result;
+}
+function readValue(args, index, option) {
+    const value = args[index];
+    if (!value || value.startsWith('-'))
+        throw new Error(`${option} requires a value.`);
+    return value;
+}
+async function confirm(message) {
+    if (!stdin.isTTY || !stdout.isTTY)
+        return false;
+    const readline = createInterface({ input: stdin, output: stdout });
+    try {
+        return (await readline.question(`${message} [y/N] `)).trim().toLowerCase() === 'y';
+    }
+    finally {
+        readline.close();
+    }
+}
+main().catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAY,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAuB,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAE,cAAc,EAA6B,MAAM,iBAAiB,CAAC;AAE5E,MAAM,IAAI,GAAG;;;;;;;;;;gFAUmE,CAAC;AAEjF,KAAK,UAAU,IAAI;IACjB,MAAM,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/C,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QAC/E,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IACxC,MAAM,OAAO,GAAmB;QAC9B,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE;QAC1B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,SAAS;QAChC,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,MAAM,EAAE,OAAO,CAAC,GAAG;QACnB,OAAO,EAAE,OAAO;KACjB,CAAC;IACF,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM;YACT,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;YACpB,OAAO;QACT,KAAK,QAAQ;YACX,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO;QACT,KAAK,OAAO;YACV,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;YAC3B,OAAO;QACT,KAAK,QAAQ;YACX,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO;QACT;YACE,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,OAAO,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,IAAc;IAClC,MAAM,MAAM,GAA0F,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IACrH,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,IAAI;YAAE,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC;aACxD,IAAI,MAAM,KAAK,UAAU;YAAE,MAAM,CAAC,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;aAC5F,IAAI,MAAM,KAAK,aAAa;YAAE,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;aAClF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YAC/C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;YACjG,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QACvB,CAAC;aAAM,IAAI,MAAM,KAAK,QAAQ;YAAE,MAAM,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;;YAC1E,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,SAAS,CAAC,IAAc,EAAE,KAAa,EAAE,MAAc;IAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,oBAAoB,CAAC,CAAC;IACpF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,OAAe;IACpC,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAChD,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACnE,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC;IACrF,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/lib/config.d.ts

@@ -0,0 +1,24 @@
+import { type McpClientProfileId } from '@braincp/agent-config';
+export type ClientId = McpClientProfileId;
+export type Scope = 'project' | 'user';
+export declare const BRAIN_ENDPOINT = "https://mcp.brainmcp.ai/mcp";
+export declare const CLIENT_IDS: readonly ClientId[];
+export declare function assertClientId(value: string): ClientId;
+export type ClientTarget = {
+    client: ClientId;
+    configPath: string;
+    guidancePath: string;
+    configFormat: 'jsonc' | 'toml';
+    /** Top-level server map key: VS Code uses `servers`, everything else `mcpServers`. */
+    configRootKey: 'mcpServers' | 'servers';
+};
+export declare const MARKER_START = "<!-- brainmcp:managed:start version=2026.07.10 -->";
+export declare const MARKER_END = "<!-- brainmcp:managed:end -->";
+export declare const TOML_MARKER_START = "# brainmcp:managed:start version=2026.07.10";
+export declare const TOML_MARKER_END = "# brainmcp:managed:end";
+export declare function targetFor(client: ClientId, scope: Scope): ClientTarget;
+export declare function clientLabel(client: ClientId): string;
+export declare function resolveWorkspace(value: string | undefined): string | undefined;
+export declare function renderGuidance(client: ClientId, workspaceId?: string): string;
+export declare function brainServerConfig(client: ClientId): Record<string, unknown>;
+export declare function renderTomlServer(client: ClientId): string;

package/dist/lib/config.js

@@ -0,0 +1,105 @@
+import { BRAIN_MCP_ENDPOINT, MCP_CLIENT_PROFILES, buildCodexConfigToml, buildProjectInstructionBlock, renderCursorMdc, } from '../agent-config.js';
+export const BRAIN_ENDPOINT = BRAIN_MCP_ENDPOINT;
+export const CLIENT_IDS = ['claude-code', 'cursor', 'codex', 'vscode', 'generic'];
+export function assertClientId(value) {
+    if (CLIENT_IDS.includes(value))
+        return value;
+    throw new Error(`Unknown --client "${value}". Expected one of: ${CLIENT_IDS.join(', ')}.`);
+}
+export const MARKER_START = '<!-- brainmcp:managed:start version=2026.07.10 -->';
+export const MARKER_END = '<!-- brainmcp:managed:end -->';
+export const TOML_MARKER_START = '# brainmcp:managed:start version=2026.07.10';
+export const TOML_MARKER_END = '# brainmcp:managed:end';
+export function targetFor(client, scope) {
+    const home = scope === 'user';
+    const prefix = home ? '~/' : '';
+    switch (client) {
+        case 'cursor':
+            return {
+                client,
+                configPath: `${prefix}.cursor/mcp.json`,
+                guidancePath: `${prefix}.cursor/rules/brainmcp-workspace.mdc`,
+                configFormat: 'jsonc',
+                configRootKey: 'mcpServers',
+            };
+        case 'claude-code':
+            return {
+                client,
+                configPath: `${prefix}.mcp.json`,
+                guidancePath: `${prefix}CLAUDE.md`,
+                configFormat: 'jsonc',
+                configRootKey: 'mcpServers',
+            };
+        case 'codex':
+            return {
+                client,
+                configPath: `${prefix}.codex/config.toml`,
+                guidancePath: `${prefix}AGENTS.md`,
+                configFormat: 'toml',
+                configRootKey: 'mcpServers',
+            };
+        case 'vscode':
+            return {
+                client,
+                configPath: `${prefix}.vscode/mcp.json`,
+                guidancePath: `${prefix}AGENTS.md`,
+                configFormat: 'jsonc',
+                configRootKey: 'servers',
+            };
+        case 'generic':
+            return {
+                client,
+                configPath: `${prefix}.mcp.json`,
+                guidancePath: `${prefix}AGENTS.md`,
+                configFormat: 'jsonc',
+                configRootKey: 'mcpServers',
+            };
+    }
+}
+export function clientLabel(client) {
+    return MCP_CLIENT_PROFILES[client].label;
+}
+export function resolveWorkspace(value) {
+    const workspace = value?.trim();
+    if (!workspace)
+        return undefined;
+    if (!/^[a-zA-Z0-9_-]+$/.test(workspace)) {
+        throw new Error('--workspace must contain only letters, numbers, underscores, or hyphens.');
+    }
+    return workspace;
+}
+export function renderGuidance(client, workspaceId) {
+    if (client === 'cursor') {
+        const rendered = renderCursorMdc({ workspaceId });
+        const frontmatter = rendered.match(/^---\n[\s\S]*?\n---\n*/)?.[0];
+        if (!frontmatter)
+            throw new Error('Cursor guidance renderer did not return frontmatter.');
+        return `${frontmatter}\n${MARKER_START}\n${rendered.slice(frontmatter.length)}\n${MARKER_END}\n`;
+    }
+    return `${MARKER_START}\n${buildProjectInstructionBlock({ workspaceId })}\n${MARKER_END}\n`;
+}
+export function brainServerConfig(client) {
+    switch (client) {
+        case 'cursor':
+        case 'generic':
+            // Cursor's documented static-client shape; also the shape we document for
+            // generic clients that support a pre-registered CLIENT_ID.
+            return {
+                url: BRAIN_MCP_ENDPOINT,
+                auth: { CLIENT_ID: MCP_CLIENT_PROFILES[client].oauthClientId },
+            };
+        case 'claude-code':
+        case 'vscode':
+        case 'codex':
+            // URL-only: these clients complete OAuth via DCR with their own exact
+            // loopback callback; a static client id cannot match their random ports.
+            return { type: 'http', url: BRAIN_MCP_ENDPOINT };
+    }
+}
+export function renderTomlServer(client) {
+    // Codex is the only TOML client today; keep markers around the canonical block.
+    void client;
+    const body = buildCodexConfigToml().trimEnd();
+    return `${TOML_MARKER_START}\n${body}\n${TOML_MARKER_END}\n`;
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"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"}

package/dist/lib/files.d.ts

@@ -0,0 +1,10 @@
+export type FileChange = {
+    path: string;
+    before: string | undefined;
+    after: string | undefined;
+};
+export declare function readText(path: string): Promise<string | undefined>;
+export declare function exists(path: string): Promise<boolean>;
+export declare function toAbsolute(root: string, path: string): string;
+export declare function renderDiff(change: FileChange): string;
+export declare function applyChanges(changes: FileChange[]): Promise<string[]>;

package/dist/lib/files.js

@@ -0,0 +1,58 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { access, copyFile, mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+export async function readText(path) {
+    try {
+        return await readFile(path, 'utf8');
+    }
+    catch (error) {
+        if (isNotFound(error))
+            return undefined;
+        throw error;
+    }
+}
+export async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function toAbsolute(root, path) {
+    return resolve(root, path.replace(/^~\//, ''));
+}
+export function renderDiff(change) {
+    const before = change.before?.split('\n') ?? [];
+    const after = change.after?.split('\n') ?? [];
+    const header = `--- ${change.before === undefined ? '/dev/null' : change.path}\n+++ ${change.after === undefined ? '/dev/null' : change.path}`;
+    const removed = before.filter((line) => !after.includes(line)).map((line) => `-${line}`);
+    const added = after.filter((line) => !before.includes(line)).map((line) => `+${line}`);
+    return [header, ...removed, ...added].join('\n');
+}
+export async function applyChanges(changes) {
+    const backups = [];
+    for (const change of changes) {
+        if (change.before === change.after)
+            continue;
+        await mkdir(dirname(change.path), { recursive: true });
+        if (change.before !== undefined && (await exists(change.path))) {
+            const backup = `${change.path}.brainmcp.bak-${Date.now()}-${createHash('sha1').update(change.path).digest('hex').slice(0, 6)}`;
+            await copyFile(change.path, backup);
+            backups.push(backup);
+        }
+        if (change.after === undefined) {
+            await rm(change.path, { force: true });
+            continue;
+        }
+        const temporary = `${change.path}.brainmcp-tmp-${randomUUID()}`;
+        await writeFile(temporary, change.after, 'utf8');
+        await rename(temporary, change.path);
+    }
+    return backups;
+}
+function isNotFound(error) {
+    return typeof error === 'object' && error !== null && 'code' in error && error.code === 'ENOENT';
+}
+//# sourceMappingURL=files.js.map

package/dist/lib/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/lib/files.ts"],"names":[],"mappings":"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"}

package/dist/lib/managed.d.ts

@@ -0,0 +1,10 @@
+import { type ClientId } from './config.js';
+export declare function hasManagedBlock(text: string, format: 'markdown' | 'toml'): boolean;
+export declare function assertNoConflictingManagedBlock(text: string, format: 'markdown' | 'toml'): void;
+export declare function upsertMarkdownBlock(existing: string | undefined, block: string): string;
+export declare function removeMarkdownBlock(existing: string | undefined): string | undefined;
+export declare function upsertTomlBlock(existing: string | undefined, client: ClientId): string;
+export declare function removeTomlBlock(existing: string | undefined): string | undefined;
+export declare function upsertJsonServer(existing: string | undefined, client: ClientId, rootKey?: 'mcpServers' | 'servers'): string;
+export declare function removeJsonServer(existing: string | undefined, rootKey?: 'mcpServers' | 'servers'): string | undefined;
+export declare function parseJsonc(source: string): Record<string, unknown>;

package/dist/lib/managed.js

@@ -0,0 +1,139 @@
+import { BRAIN_ENDPOINT, brainServerConfig, renderTomlServer, MARKER_END, MARKER_START, TOML_MARKER_END, TOML_MARKER_START } from './config.js';
+export function hasManagedBlock(text, format) {
+    return text.includes(format === 'toml' ? TOML_MARKER_START : MARKER_START);
+}
+export function assertNoConflictingManagedBlock(text, format) {
+    const [start, end] = format === 'toml' ? [TOML_MARKER_START, TOML_MARKER_END] : [MARKER_START, MARKER_END];
+    const startCount = text.split(start).length - 1;
+    const endCount = text.split(end).length - 1;
+    if ((startCount !== 0 || endCount !== 0) && (startCount !== 1 || endCount !== 1 || text.indexOf(end) < text.indexOf(start))) {
+        throw new Error(`Refusing to modify conflicting manual BrainMCP markers. Repair ${start} / ${end} first.`);
+    }
+}
+export function upsertMarkdownBlock(existing, block) {
+    const current = existing ?? '';
+    assertNoConflictingManagedBlock(current, 'markdown');
+    if (hasManagedBlock(current, 'markdown')) {
+        return current.replace(new RegExp(`${escapeRegex(MARKER_START)}[\\s\\S]*?${escapeRegex(MARKER_END)}\\n?`), block);
+    }
+    return `${current}${current && !current.endsWith('\n') ? '\n' : ''}${current ? '\n' : ''}${block}`;
+}
+export function removeMarkdownBlock(existing) {
+    if (existing === undefined)
+        return undefined;
+    assertNoConflictingManagedBlock(existing, 'markdown');
+    const result = existing.replace(new RegExp(`\\n?${escapeRegex(MARKER_START)}[\\s\\S]*?${escapeRegex(MARKER_END)}\\n?`), '').replace(/\n{3,}/g, '\n\n');
+    return result.trim() ? result : undefined;
+}
+export function upsertTomlBlock(existing, client) {
+    const current = existing ?? '';
+    assertNoConflictingManagedBlock(current, 'toml');
+    const block = renderTomlServer(client);
+    if (hasManagedBlock(current, 'toml')) {
+        return current.replace(new RegExp(`${escapeRegex(TOML_MARKER_START)}[\\s\\S]*?${escapeRegex(TOML_MARKER_END)}\\n?`), block);
+    }
+    if (/\[mcp_servers\.brain\]/.test(current)) {
+        throw new Error('Refusing to overwrite a manually-managed [mcp_servers.brain] block. Remove it or use BrainMCP markers.');
+    }
+    return `${current}${current && !current.endsWith('\n') ? '\n' : ''}${current ? '\n' : ''}${block}`;
+}
+export function removeTomlBlock(existing) {
+    if (existing === undefined)
+        return undefined;
+    assertNoConflictingManagedBlock(existing, 'toml');
+    const result = existing.replace(new RegExp(`\\n?${escapeRegex(TOML_MARKER_START)}[\\s\\S]*?${escapeRegex(TOML_MARKER_END)}\\n?`), '').replace(/\n{3,}/g, '\n\n');
+    return result.trim() ? result : undefined;
+}
+export function upsertJsonServer(existing, client, rootKey = 'mcpServers') {
+    const source = existing?.trim() || `{\n  "${rootKey}": {}\n}\n`;
+    const parsed = parseJsonc(source);
+    const servers = parsed[rootKey];
+    if (servers !== undefined && (typeof servers !== 'object' || servers === null || Array.isArray(servers))) {
+        throw new Error(`${rootKey} must be an object.`);
+    }
+    const existingBrain = servers?.brain;
+    if (existingBrain !== undefined && !isBrainConfig(existingBrain)) {
+        throw new Error('Refusing to overwrite a manually-managed "brain" MCP server entry.');
+    }
+    if (existingBrain !== undefined)
+        return source;
+    if (servers !== undefined)
+        return insertJsonServer(source, brainServerConfig(client), rootKey);
+    const next = { ...parsed, [rootKey]: { brain: brainServerConfig(client) } };
+    return `${JSON.stringify(next, null, 2)}\n`;
+}
+export function removeJsonServer(existing, rootKey = 'mcpServers') {
+    if (existing === undefined)
+        return undefined;
+    const parsed = parseJsonc(existing);
+    const parsedServers = parsed[rootKey];
+    if (!parsedServers || typeof parsedServers !== 'object' || Array.isArray(parsedServers))
+        return existing;
+    const servers = { ...parsedServers };
+    if (!isBrainConfig(servers.brain)) {
+        if (servers.brain !== undefined)
+            throw new Error('Refusing to remove a manually-managed "brain" MCP server entry.');
+        return existing;
+    }
+    delete servers.brain;
+    const next = { ...parsed, [rootKey]: servers };
+    if (Object.keys(next).length === 1 && Object.keys(servers).length === 0)
+        return undefined;
+    return `${JSON.stringify(next, null, 2)}\n`;
+}
+export function parseJsonc(source) {
+    try {
+        return JSON.parse(source.replace(/\/\*[\s\S]*?\*\//g, '').replace(/(^|[^:])\/\/.*$/gm, '$1').replace(/,\s*([}\]])/g, '$1'));
+    }
+    catch (error) {
+        throw new Error(`Invalid JSON/JSONC configuration: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function isBrainConfig(value) {
+    return typeof value === 'object' && value !== null && value.url === BRAIN_ENDPOINT;
+}
+function escapeRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** Adds a server without reformatting existing JSONC comments or sibling entries. */
+function insertJsonServer(source, server, rootKey) {
+    const match = new RegExp(`"${rootKey}"\\s*:\\s*\\{`).exec(source);
+    if (!match)
+        throw new Error(`Could not locate the ${rootKey} object.`);
+    const open = source.indexOf('{', match.index);
+    const close = matchingBrace(source, open);
+    const inner = source.slice(open + 1, close);
+    const baseIndent = source.match(new RegExp(`\\n(\\s+)"${rootKey}"`))?.[1] ?? '';
+    const entryIndent = `${baseIndent}  `;
+    const rendered = `"brain": ${JSON.stringify(server, null, 2).replace(/\n/g, `\n${entryIndent}`)}`;
+    if (!inner.trim())
+        return `${source.slice(0, open + 1)}\n${entryIndent}${rendered}\n${baseIndent}${source.slice(close)}`;
+    const end = open + 1 + inner.search(/\s*$/);
+    const comma = source.slice(open + 1, end).trimEnd().endsWith(',') ? '' : ',';
+    return `${source.slice(0, end)}${comma}\n${entryIndent}${rendered}${source.slice(end)}`;
+}
+function matchingBrace(source, open) {
+    let depth = 0;
+    let quote = false;
+    let escaped = false;
+    for (let index = open; index < source.length; index += 1) {
+        const character = source[index];
+        if (quote) {
+            if (escaped)
+                escaped = false;
+            else if (character === '\\')
+                escaped = true;
+            else if (character === '"')
+                quote = false;
+            continue;
+        }
+        if (character === '"')
+            quote = true;
+        else if (character === '{')
+            depth += 1;
+        else if (character === '}' && --depth === 0)
+            return index;
+    }
+    throw new Error('Unterminated mcpServers object.');
+}
+//# sourceMappingURL=managed.js.map

package/dist/lib/managed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed.js","sourceRoot":"","sources":["../../src/lib/managed.ts"],"names":[],"mappings":"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"}

package/dist/types/agent-config-stub.d.ts

@@ -0,0 +1,33 @@
+/** Emit stub — replaced by bundled agent-config.js after `tsc`. */
+export type McpClientProfileId = 'claude-code' | 'cursor' | 'codex' | 'vscode' | 'generic';
+export declare const BRAIN_MCP_ENDPOINT = "https://mcp.brainmcp.ai/mcp";
+export declare const GUIDANCE_VERSION = "2026.07.10";
+export declare const MCP_CLIENT_PROFILES: Record<McpClientProfileId, {
+    id: McpClientProfileId;
+    label: string;
+    oauthClientId?: string;
+    supportsProjectInstructions: boolean;
+    supportsPlugins: boolean;
+    supportsHooks: boolean;
+    notes: string;
+}>;
+export declare function buildProjectInstructionBlock(_options?: {
+    workspaceId?: string;
+    includeEndpoint?: boolean;
+}): string;
+export declare function renderCursorMdc(_options?: {
+    workspaceId?: string;
+    alwaysApply?: boolean;
+}): string;
+export declare function buildCursorMcpJson(_options?: {
+    oauthClientId?: string;
+}): string;
+export declare function buildClaudeCodeMcpAddCommand(): string;
+export declare function buildBrainmcpInitCommand(_options?: {
+    workspaceId?: string;
+    client?: McpClientProfileId;
+}): string;
+export declare function buildAgentSkillMarkdown(_options?: {
+    workspaceId?: string;
+}): string;
+export declare function buildCodexConfigToml(): string;

package/dist/types/agent-config-stub.js

@@ -0,0 +1,25 @@
+export const BRAIN_MCP_ENDPOINT = 'https://mcp.brainmcp.ai/mcp';
+export const GUIDANCE_VERSION = '2026.07.10';
+export const MCP_CLIENT_PROFILES = {};
+export function buildProjectInstructionBlock(_options) {
+    return '';
+}
+export function renderCursorMdc(_options) {
+    return '';
+}
+export function buildCursorMcpJson(_options) {
+    return '{}';
+}
+export function buildClaudeCodeMcpAddCommand() {
+    return '';
+}
+export function buildBrainmcpInitCommand(_options) {
+    return '';
+}
+export function buildAgentSkillMarkdown(_options) {
+    return '';
+}
+export function buildCodexConfigToml() {
+    return '';
+}
+//# sourceMappingURL=agent-config-stub.js.map

package/dist/types/agent-config-stub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-config-stub.js","sourceRoot":"","sources":["../../src/types/agent-config-stub.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,kBAAkB,GAAG,6BAA6B,CAAC;AAChE,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAC7C,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAWlC,CAAC;AAEF,MAAM,UAAU,4BAA4B,CAAC,QAG5C;IACC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAA0D;IACxF,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAqC;IACtE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAGxC;IACC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAAmC;IACzE,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@brainmcp/brainmcp",
+  "version": "0.1.0",
+  "description": "Safely configure BrainMCP project guidance and MCP connections",
+  "type": "module",
+  "bin": {
+    "brainmcp": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.build.json && node scripts/bundle-agent-config.mjs && chmod +x dist/index.js",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "node --import tsx --test 'src/**/*.test.ts'",
+    "prepublishOnly": "pnpm run build"
+  },
+  "devDependencies": {
+    "@braincp/agent-config": "workspace:*",
+    "@types/node": "^26.1.0",
+    "tsx": "^4.23.0",
+    "typescript": "6.0.3"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "license": "MIT"
+}