create-merlin-brain 3.7.2 → 3.8.0-beta.0

package/dist/server/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4CpE,0CAA0C;AAC1C,wBAAgB,YAAY,IAAI,SAAS,CAm1FxC;AAED,gDAAgD;AAChD,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAoCjD"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4CpE,0CAA0C;AAC1C,wBAAgB,YAAY,IAAI,SAAS,CAs1FxC;AAED,gDAAgD;AAChD,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAoCjD"}

package/dist/server/server.js

@@ -48,10 +48,13 @@ export function createServer() {
         description: 'Merlin Brain. MANDATORY BOOT: Call merlin_get_selected_repo then merlin_get_project_status BEFORE responding to user. Call merlin_get_context before every file edit. Never run claude --agent via Bash — use Skill("merlin:route") instead.',
     });
     const client = getClient();
-    // Tool loading mode: core (15 tools) vs all (67 tools)
-    // Core mode stays under Claude Code's 10% context threshold to avoid Tool Search lazy loading
-    // Set MERLIN_CORE_ONLY=true to load only 22 essential tools (if context is tight)
-    const allToolsMode = process.env.MERLIN_CORE_ONLY !== 'true';
+    // Tool loading tiers:
+    // 1. Core tools (always loaded): get_context, search, find_files, get_brief, etc.
+    // 2. Free/local tools (always loaded): auto-teach, route, lite
+    // 3. Cloud tools (need API key): behaviors, verification, agents-index, sights-index, etc.
+    // Set MERLIN_CORE_ONLY=true to load only core tools (minimal footprint)
+    const coreOnly = process.env.MERLIN_CORE_ONLY === 'true';
+    const hasCloudApi = !!process.env.MERLIN_API_KEY;
     // Cache for resolved repo IDs to avoid repeated git/API calls
     // Key: url or 'auto' for auto-detected, Value: { repoId, expiresAt }
     const repoIdCache = new Map();
@@ -1190,7 +1193,7 @@ export function createServer() {
             throw error;
         }
     });
-    if (allToolsMode) { // Tool: merlin_check_repo_status
+    if (hasCloudApi && !coreOnly) { // Tool: merlin_check_repo_status
         server.tool('merlin_check_repo_status', 'Check if a repository analysis is complete. Use after merlin_connect_repo to poll for completion. Returns status: pending, analyzing, completed, or failed.', {
             repoUrl: z.string().optional().describe('GitHub URL of the repository (uses selected repo if omitted)'),
         }, async ({ repoUrl }) => {
@@ -1291,7 +1294,7 @@ export function createServer() {
                 };
             }
         });
-    } // end allToolsMode: merlin_check_repo_status
+    } // end cloud: merlin_check_repo_status
     // Tool: merlin_connect_repo
     server.tool('merlin_connect_repo', 'Connect a new repository to Merlin Sights for analysis. Use this when working on a repo that is not yet in Sights. Analysis takes 2-5 minutes.', {
         repoUrl: z.string().describe('GitHub URL of the repository (e.g., "https://github.com/user/repo")'),
@@ -1496,7 +1499,7 @@ export function createServer() {
             };
         }
     });
-    if (allToolsMode) { // Tool: merlin_similar_code
+    if (hasCloudApi && !coreOnly) { // Tool: merlin_similar_code
         server.tool('merlin_similar_code', 'Find similar implementations in the codebase BEFORE writing new code. Prevents duplicating existing patterns. Use this when implementing anything — there is likely an existing pattern to follow.', {
             description: z.string().describe('What you\'re trying to implement (e.g., "API endpoint with authentication", "database query with pagination", "React form with validation")'),
             repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
@@ -1526,8 +1529,8 @@ export function createServer() {
                 };
             }
         });
-    } // end allToolsMode: merlin_similar_code
-    if (allToolsMode) { // Tool: merlin_code_examples
+    } // end cloud: merlin_similar_code
+    if (hasCloudApi && !coreOnly) { // Tool: merlin_code_examples
         server.tool('merlin_code_examples', 'Get real code examples from this codebase for common tasks. Shows actual patterns used in this project.', {
             task: z.string().optional().describe('Specific task (e.g., "add endpoint", "add test", "error handling"). Leave empty for all examples.'),
             repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
@@ -1557,7 +1560,7 @@ export function createServer() {
                 };
             }
         });
-    } // end allToolsMode: merlin_code_examples
+    } // end cloud: merlin_code_examples
     // Tool: merlin_ask
     server.tool('merlin_ask', 'Ask ANY question about the codebase in natural language. Uses AI-powered semantic search + RAG to find relevant context and generate accurate answers with source citations. Perfect for questions like "How does authentication work?", "Where should I add a new API endpoint?", "Why is X structured this way?"', {
         question: z.string().describe('Your question in natural language (e.g., "How does the payment flow work?", "Where is user validation handled?", "What patterns are used for error handling?")'),
@@ -1772,7 +1775,7 @@ export function createServer() {
             };
         }
     });
-    if (allToolsMode) { // Tool: merlin_log_activity
+    if (hasCloudApi && !coreOnly) { // Tool: merlin_log_activity
         server.tool('merlin_log_activity', 'Log an activity event to the team timeline. Use for tracking progress, milestones, and decisions.', {
             eventType: z.string().describe('Event type (e.g., "phase_started", "task_completed", "blocker_hit", "decision_made")'),
             eventData: z.any().optional().describe('Additional event data (JSON object)'),
@@ -1820,8 +1823,8 @@ export function createServer() {
                 };
             }
         });
-    } // end allToolsMode: merlin_log_activity
-    if (allToolsMode) { // Tool: merlin_sync_task
+    } // end cloud: merlin_log_activity
+    if (hasCloudApi && !coreOnly) { // Tool: merlin_sync_task
         server.tool('merlin_sync_task', 'Sync a task to Merlin cloud. Use to track work items, their status, and dependencies for team visibility.', {
             title: z.string().describe('Task title'),
             status: z.enum(['pending', 'in_progress', 'completed', 'blocked', 'skipped']).optional().describe('Task status'),
@@ -1887,8 +1890,8 @@ export function createServer() {
                 };
             }
         });
-    } // end allToolsMode: merlin_sync_task
-    if (allToolsMode) { // Tool: merlin_get_tasks
+    } // end cloud: merlin_sync_task
+    if (hasCloudApi && !coreOnly) { // Tool: merlin_get_tasks
         server.tool('merlin_get_tasks', 'Get tasks synced to Merlin. Shows work items from all agents for team coordination.', {
             status: z.string().optional().describe('Filter by status (pending, in_progress, completed, blocked)'),
             phase: z.string().optional().describe('Filter by phase'),
@@ -1950,8 +1953,8 @@ export function createServer() {
                 };
             }
         });
-    } // end allToolsMode: merlin_get_tasks
-    if (allToolsMode) { // Tool: merlin_report_blocker
+    } // end cloud: merlin_get_tasks
+    if (hasCloudApi && !coreOnly) { // Tool: merlin_report_blocker
         server.tool('merlin_report_blocker', 'Report a blocker that requires human attention. The blocker will appear in the team dashboard for resolution.', {
             title: z.string().describe('Brief description of the blocker'),
             blockerType: z.enum(['human_verify', 'auth_required', 'clarification', 'decision_point', 'external', 'error', 'other']).describe('Type of blocker'),
@@ -2003,8 +2006,8 @@ export function createServer() {
                 };
             }
         });
-    } // end allToolsMode: merlin_report_blocker
-    if (allToolsMode) { // Tool: merlin_get_blockers
+    } // end cloud: merlin_report_blocker
+    if (hasCloudApi && !coreOnly) { // Tool: merlin_get_blockers
         server.tool('merlin_get_blockers', 'Get open blockers awaiting resolution. Check before starting work to see if there are issues to resolve.', {
             status: z.string().optional().default('open').describe('Filter by status (open, resolved, all)'),
             repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
@@ -2055,8 +2058,8 @@ export function createServer() {
                 };
             }
         });
-    } // end allToolsMode: merlin_get_blockers
-    if (allToolsMode) { // Tool: merlin_create_checkpoint
+    } // end cloud: merlin_get_blockers
+    if (hasCloudApi && !coreOnly) { // Tool: merlin_create_checkpoint
         server.tool('merlin_create_checkpoint', 'Create a checkpoint requiring human verification or decision. Pauses agent work until human responds.', {
             title: z.string().describe('Checkpoint title'),
             checkpointType: z.enum(['human_verify', 'auth_gate', 'decision_point', 'approval', 'review']).describe('Type of checkpoint'),
@@ -2114,8 +2117,8 @@ export function createServer() {
                 };
             }
         });
-    } // end allToolsMode: merlin_create_checkpoint
-    if (allToolsMode) { // Tool: merlin_get_team_state
+    } // end cloud: merlin_create_checkpoint
+    if (hasCloudApi && !coreOnly) { // Tool: merlin_get_team_state
         server.tool('merlin_get_team_state', 'Get consolidated team state: active sessions, pending checkpoints, open blockers, task summary. Use at session start to see what others are working on.', {
             repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
         }, async ({ repoUrl }) => {
@@ -2209,8 +2212,8 @@ export function createServer() {
                 };
             }
         });
-    } // end allToolsMode: merlin_get_team_state
-    if (allToolsMode) { // Tool: merlin_update_session
+    } // end cloud: merlin_get_team_state
+    if (hasCloudApi && !coreOnly) { // Tool: merlin_update_session
         server.tool('merlin_update_session', 'Update your session status. Use to track your work progress and enable pause/resume across context resets.', {
             sessionId: z.string().describe('Unique session identifier'),
             agentId: z.string().describe('Agent identifier'),
@@ -2270,11 +2273,11 @@ export function createServer() {
                 };
             }
         });
-    } // end allToolsMode: merlin_update_session
+    } // end cloud: merlin_update_session
     // ============================================================
     // CODING RULES
     // ============================================================
-    if (allToolsMode) { // Tool: merlin_save_rule
+    if (hasCloudApi && !coreOnly) { // Tool: merlin_save_rule
         server.tool('merlin_save_rule', 'Save a coding rule or preference to Merlin. Rules are returned with every context query and must be followed. Use when user expresses a preference that should persist.', {
             rule: z.string().describe('The rule to save (e.g., "max 400 lines per file", "always use async/await", "no console.log in production")'),
             category: z.enum(['file_size', 'testing', 'style', 'patterns', 'custom']).optional().default('custom').describe('Rule category for organization'),
@@ -2334,8 +2337,8 @@ export function createServer() {
                 };
             }
         });
-    } // end allToolsMode: merlin_save_rule
-    if (allToolsMode) { // Tool: merlin_get_rules
+    } // end cloud: merlin_save_rule
+    if (hasCloudApi && !coreOnly) { // Tool: merlin_get_rules
         server.tool('merlin_get_rules', 'Get all coding rules for this project. Returns rules that must be followed when writing code.', {
             repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
         }, async ({ repoUrl }) => {
@@ -2383,8 +2386,8 @@ export function createServer() {
                 };
             }
         });
-    } // end allToolsMode: merlin_get_rules
-    if (allToolsMode) { // Tool: merlin_remove_rule
+    } // end cloud: merlin_get_rules
+    if (hasCloudApi && !coreOnly) { // Tool: merlin_remove_rule
         server.tool('merlin_remove_rule', 'Remove a coding rule from this project.', {
             rule: z.string().describe('The exact rule text to remove'),
             repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
@@ -2447,7 +2450,7 @@ export function createServer() {
                 };
             }
         });
-    } // end allToolsMode: merlin_remove_rule
+    } // end cloud: merlin_remove_rule
     // ============================================================
     // RESOURCES
     // ============================================================
@@ -2470,7 +2473,7 @@ export function createServer() {
     // ============================================================
     registerProjectTools(server, () => client, resolveRepoId, getRepoRootPath);
     // ============================================================
-    if (allToolsMode) {
+    if (hasCloudApi && !coreOnly) {
         // LEARNED BEHAVIORS TOOLS
         // ============================================================
         registerBehaviorTools({
@@ -2478,9 +2481,9 @@ export function createServer() {
             client,
             resolveRepoId,
         });
-    } // end allToolsMode: registerBehaviorTools
+    } // end cloud: registerBehaviorTools
     // ============================================================
-    if (allToolsMode) {
+    if (hasCloudApi && !coreOnly) {
         // VERIFICATION CHECKPOINTS TOOLS
         // ============================================================
         registerVerificationTools({
@@ -2489,9 +2492,9 @@ export function createServer() {
             resolveRepoId,
             getRepoRootPath,
         });
-    } // end allToolsMode: registerVerificationTools
+    } // end cloud: registerVerificationTools
     // ============================================================
-    if (allToolsMode) {
+    if (hasCloudApi && !coreOnly) {
         // ADAPTIVE CONTEXT DISCOVERY TOOLS
         // ============================================================
         registerAdaptiveTools({
@@ -2499,9 +2502,9 @@ export function createServer() {
             client,
             resolveRepoId,
         });
-    } // end allToolsMode: registerAdaptiveTools
+    } // end cloud: registerAdaptiveTools
     // ============================================================
-    if (allToolsMode) {
+    if (hasCloudApi && !coreOnly) {
         // STRUCTURED AGENT TOOLS
         // ============================================================
         registerAgentTools({
@@ -2509,9 +2512,9 @@ export function createServer() {
             client,
             resolveRepoId,
         });
-    } // end allToolsMode: registerAgentTools
+    } // end cloud: registerAgentTools
     // ============================================================
-    if (allToolsMode) {
+    if (hasCloudApi && !coreOnly) {
         // DISCOVERY TOOLS - Teach Sights what Claude learns
         // ============================================================
         registerDiscoveryTools({
@@ -2519,20 +2522,20 @@ export function createServer() {
             client,
             resolveRepoId,
         });
-    } // end allToolsMode: registerDiscoveryTools
+    } // end cloud: registerDiscoveryTools
     // ============================================================
-    if (allToolsMode) {
-        // AUTO-TEACH TOOLS - Confidence detection + teach-back loop
+    if (!coreOnly) {
+        // AUTO-TEACH TOOLS - Confidence detection + teach-back loop (works locally)
         // ============================================================
         registerAutoTeachTools({
             server,
             client,
             resolveRepoId,
         });
-    } // end allToolsMode: registerAutoTeachTools
+    } // end free: registerAutoTeachTools
     // ============================================================
-    if (allToolsMode) {
-        // AGENT ROUTE TOOLS - Fresh process spawning for specialists
+    if (!coreOnly) {
+        // AGENT ROUTE TOOLS - Fresh process spawning for specialists (local)
         // ============================================================
         registerRouteTools({
             server,
@@ -2540,9 +2543,9 @@ export function createServer() {
             resolveRepoId,
             getRepoRootPath,
         });
-    } // end allToolsMode: registerRouteTools
+    } // end free: registerRouteTools
     // ============================================================
-    if (allToolsMode) {
+    if (hasCloudApi && !coreOnly) {
         // PUBLIC SIGHTS INDEX - Browse open source analyzed codebases
         // ============================================================
         registerSightsIndexTools({
@@ -2550,9 +2553,9 @@ export function createServer() {
             client,
             resolveRepoId,
         });
-    } // end allToolsMode: registerSightsIndexTools
+    } // end cloud: registerSightsIndexTools
     // ============================================================
-    if (allToolsMode) {
+    if (hasCloudApi && !coreOnly) {
         // AGENTS INDEX - Browse discovered AI agents catalog
         // ============================================================
         registerAgentsIndexTools({
@@ -2560,10 +2563,10 @@ export function createServer() {
             client,
             resolveRepoId,
         });
-    } // end allToolsMode: registerAgentsIndexTools
+    } // end cloud: registerAgentsIndexTools
     // ============================================================
-    if (allToolsMode) {
-        // LITE MODE TOOLS - Local file-based context for small repos
+    if (!coreOnly) {
+        // LITE MODE TOOLS - Local file-based context for small repos (always available)
         // ============================================================
         registerLiteTools({
             server,
@@ -2574,9 +2577,9 @@ export function createServer() {
                 return config?.apiKey || null;
             },
         });
-    } // end allToolsMode: registerLiteTools
+    } // end free: registerLiteTools
     // ============================================================
-    if (allToolsMode) {
+    if (hasCloudApi && !coreOnly) {
         // CONFIG SYNC TOOLS - Sync CLAUDE.md across team
         // ============================================================
         registerConfigSyncTools({
@@ -2586,7 +2589,7 @@ export function createServer() {
                 return config?.apiKey || null;
             },
         });
-    } // end allToolsMode: registerConfigSyncTools
+    } // end cloud: registerConfigSyncTools
     return server;
 }
 /** Start the MCP server with stdio transport */