create-merlin-brain 5.3.8 → 5.4.1

package/dist/server/tools/context.js

@@ -1,614 +0,0 @@
-/**
- * Context and Search Tools
- * Tools for getting codebase context, searching, and asking questions
- */
-import { z } from 'zod';
-import { writeFileSync, mkdirSync } from 'fs';
-import { join } from 'path';
-import { homedir } from 'os';
-import { detectLanguage } from '../lang/detector.js';
-import { getLanguageRules } from '../lang/rules.js';
-/**
- * Record that Sights was just consulted.
- * Writes epoch timestamp to ~/.claude/merlin/.last-sights-check
- * so that pre-edit hooks know context is fresh.
- * Also notifies the guardian HTTP sidecar if running.
- */
-function recordSightsCall() {
-    try {
-        const dir = join(homedir(), '.claude', 'merlin');
-        mkdirSync(dir, { recursive: true });
-        writeFileSync(join(dir, '.last-sights-check'), Math.floor(Date.now() / 1000).toString());
-    }
-    catch {
-        // Non-fatal — hooks will fall back to stale detection
-    }
-}
-/** Module-level cache: repoId → detected language profile */
-const langProfileCache = new Map();
-/** Detect language for a repo, using cached result if available */
-async function resolveLanguageProfile(repoId, client) {
-    if (langProfileCache.has(repoId))
-        return langProfileCache.get(repoId);
-    try {
-        const manifest = await client.getManifest(repoId).catch(() => null);
-        if (!manifest)
-            return null;
-        const profile = detectLanguage(manifest);
-        langProfileCache.set(repoId, profile);
-        return profile;
-    }
-    catch {
-        return null;
-    }
-}
-export function registerContextTools(ctx) {
-    const { server, client, resolveRepoId } = ctx;
-    // ── CORE tool: always loaded, used at every session start ──────────────
-    // Tool: merlin_get_brief
-    server.tool('merlin_get_brief', 'CALL AFTER merlin_get_selected_repo to orient yourself. Returns ~500-token project brief: product purpose, tech stack, architecture pattern, service map, active tasks (in-progress/pending/completed counts), shipped APIs you must not duplicate, and top coding rules. Use at session start, before planning a new feature, or when joining an unfamiliar project.', {
-        repoUrl: z.string().optional().describe('GitHub URL of the repository (uses selected repo if omitted)'),
-    }, async ({ repoUrl }) => {
-        try {
-            const repoId = await resolveRepoId(repoUrl);
-            if (!repoId) {
-                return {
-                    content: [{ type: 'text', text: 'Could not find repository. Select a repo first with merlin_select_repo.' }],
-                };
-            }
-            const [quickstart, projectState, rulesState, tasks, manifest] = await Promise.all([
-                client.getQuickstart(repoId).catch(() => null),
-                client.readState(repoId, 'project').catch(() => null),
-                client.readState(repoId, 'coding_rules').catch(() => null),
-                client.getTasks(repoId, {}).catch(() => ({ tasks: [], summary: {} })),
-                client.getManifest(repoId).catch(() => null),
-            ]);
-            let brief = `# Project Brief\n\n`;
-            // 1. PRODUCT SUMMARY
-            brief += `## What We're Building\n`;
-            if (projectState?.value) {
-                const proj = projectState.value;
-                brief += proj.oneLiner || proj.description || proj.name || 'See PROJECT.md';
-                if (proj.targetUser)
-                    brief += `\nFor: ${proj.targetUser}`;
-                if (proj.coreValue)
-                    brief += `\nValue: ${proj.coreValue}`;
-            }
-            else if (manifest) {
-                const projName = manifest.project?.name || 'Unknown';
-                const projDesc = manifest.project?.description || '';
-                brief += `${projName}: ${projDesc}`;
-            }
-            else if (quickstart) {
-                const lines = quickstart.split('\n').filter((l) => l.trim() && !l.startsWith('#'));
-                brief += lines.slice(0, 2).join(' ');
-            }
-            else {
-                brief += 'No product info stored. Run /merlin:new-project to set up.';
-            }
-            brief += '\n\n';
-            // 2. ARCHITECTURE SUMMARY
-            brief += `## How It's Built\n`;
-            if (manifest) {
-                const techStack = manifest.project?.techStack;
-                brief += `Stack: ${Array.isArray(techStack) && techStack.length > 0 ? techStack.join(', ') : 'Not detected'}\n`;
-                brief += `Architecture: ${manifest.project?.architecturePattern || 'Not detected'}\n`;
-                const services = manifest.serviceMap;
-                if (Array.isArray(services) && services.length > 0) {
-                    brief += `Services: ${services.map((m) => m.name).join(', ')}\n`;
-                }
-            }
-            else if (quickstart) {
-                brief += 'See quickstart for details.\n';
-            }
-            else {
-                brief += 'Not analyzed yet.\n';
-            }
-            brief += '\n';
-            // 3. STATUS
-            brief += `## Status\n`;
-            if (tasks.tasks && tasks.tasks.length > 0) {
-                const completed = tasks.tasks.filter((t) => t.status === 'completed').length;
-                const inProgress = tasks.tasks.filter((t) => t.status === 'in_progress').length;
-                const pending = tasks.tasks.filter((t) => t.status === 'pending').length;
-                brief += `Tasks: ${completed} done, ${inProgress} in progress, ${pending} pending\n`;
-                const active = tasks.tasks.filter((t) => t.status === 'in_progress');
-                if (active.length > 0) {
-                    brief += `Working on: ${active.map((t) => t.title).join(', ')}\n`;
-                }
-            }
-            else {
-                brief += 'No tasks tracked. Use /merlin:plan-phase to create tasks.\n';
-            }
-            brief += '\n';
-            // 4. PRODUCT FEATURES (Skills, Shipped Assets)
-            const productAssets = manifest?.productAssets || [];
-            const shippedAssets = manifest?.shippedAssets || [];
-            const discoveredFeatures = manifest?.discoveredFeatures || [];
-            if (productAssets.length > 0 || discoveredFeatures.length > 0) {
-                brief += `## Product Features\n`;
-                // Show discovered features first
-                if (discoveredFeatures.length > 0) {
-                    discoveredFeatures.slice(0, 5).forEach((f) => {
-                        brief += `- **${f.name}**: ${f.description}\n`;
-                    });
-                }
-                // Show skills/agents
-                const skills = productAssets.filter((a) => a.type === 'skill' || a.type === 'agent');
-                if (skills.length > 0) {
-                    brief += `\n**Skills/Agents (${skills.length}):** ${skills.map((s) => s.name).join(', ')}\n`;
-                }
-                brief += '\n';
-            }
-            // 5. WHAT USERS GET (Shipped Assets)
-            if (shippedAssets.length > 0) {
-                brief += `## What Users Get When They Install\n`;
-                shippedAssets.forEach((pkg) => {
-                    brief += `**${pkg.package}** (${pkg.installCommand || 'npm install'}):\n`;
-                    pkg.assets?.slice(0, 5).forEach((a) => {
-                        brief += `  - ${a.name}: ${a.description?.slice(0, 50) || a.type}\n`;
-                    });
-                });
-                brief += '\n';
-            }
-            // 6. KEY APIS & SERVICES
-            brief += `## Existing APIs & Services\n`;
-            const entryPoints = manifest?.entryPoints;
-            if (Array.isArray(entryPoints) && entryPoints.length > 0) {
-                entryPoints.slice(0, 5).forEach((ep) => {
-                    brief += `- ${ep.name}: ${ep.purpose}\n`;
-                });
-                brief += `\nDO NOT duplicate these. Query Sights before adding new endpoints.\n`;
-            }
-            else {
-                brief += 'Run merlin_get_context for specific areas.\n';
-            }
-            brief += '\n';
-            // 7. RULES
-            if (rulesState?.value && rulesState.value.rules?.length > 0) {
-                brief += `## Your Rules\n`;
-                rulesState.value.rules.slice(0, 5).forEach((r) => {
-                    brief += `- ${r}\n`;
-                });
-                brief += '\n';
-            }
-            brief += `---\n*Brief generated ${new Date().toISOString()}*`;
-            return { content: [{ type: 'text', text: brief }] };
-        }
-        catch (error) {
-            return {
-                content: [{ type: 'text', text: `Error getting brief: ${error instanceof Error ? error.message : 'Unknown error'}` }],
-                isError: true,
-            };
-        }
-    });
-    // ── CORE tool: MANDATORY before every file edit or code modification ────
-    // Tool: merlin_get_context
-    server.tool('merlin_get_context', 'MANDATORY before every file edit, code modification, or feature implementation. Call before EACH file you modify. Returns: codebase conventions, relevant file paths with exports, step-by-step how-to guide, anti-patterns to avoid, auto-apply behavior patterns, language-specific rules (TypeScript/Python/Go/etc.), and current project blockers. Without this you WILL duplicate existing code or violate established patterns. Re-call every few minutes — the codebase changes. Works in both cloud (Sights) and offline Lite mode.', {
-        task: z.string().describe('What you want to know or do'),
-        repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
-    }, async ({ task, repoUrl }) => {
-        try {
-            const repoId = await resolveRepoId(repoUrl);
-            if (!repoId) {
-                return {
-                    content: [{ type: 'text', text: 'Could not find repository. Make sure:\n1. You are in a git repository\n2. The repository has been analyzed on merlin.build\n3. Or provide the repoUrl parameter explicitly' }],
-                };
-            }
-            // Fetch all context in parallel, including behaviors
-            const [howTo, files, conventions, behaviorsResult] = await Promise.all([
-                client.getHowTo(repoId, task),
-                client.getFiles(repoId, { purpose: task }),
-                client.getConventions(repoId),
-                client.getRelevantBehaviors(repoId, task).catch(() => ({ behaviors: [], count: 0 })),
-            ]);
-            let context = `# Context for: ${task}\n\n`;
-            // AUTO-INJECT: High-confidence behaviors (auto-apply patterns)
-            const autoApplyBehaviors = behaviorsResult.behaviors.filter(b => b.autoApply);
-            if (autoApplyBehaviors.length > 0) {
-                context += `## 🎯 Auto-Apply Patterns (FOLLOW THESE)\n`;
-                context += `_These patterns have been learned from your preferences. Apply them automatically._\n\n`;
-                autoApplyBehaviors.forEach(b => {
-                    context += `**When:** ${b.pattern}\n`;
-                    context += `**Do:** ${b.action}\n`;
-                    context += `_Confidence: ${(b.confidence * 100).toFixed(0)}%_\n\n`;
-                });
-            }
-            // Suggested behaviors (lower confidence)
-            const suggestedBehaviors = behaviorsResult.behaviors.filter(b => !b.autoApply && b.confidence >= 0.4);
-            if (suggestedBehaviors.length > 0) {
-                context += `## 💡 Suggested Patterns (Consider These)\n`;
-                suggestedBehaviors.slice(0, 3).forEach(b => {
-                    context += `- **${b.pattern}** → ${b.action}\n`;
-                });
-                context += '\n';
-            }
-            context += `## How To Guide\n${howTo}\n\n`;
-            if (files.files.length > 0) {
-                context += `## Relevant Files (${files.count} total)\n`;
-                files.files.forEach(f => {
-                    context += `- **${f.path}**: ${f.purpose}\n`;
-                    if (f.exports.length > 0) {
-                        context += `  Exports: ${f.exports.map(e => e.name).join(', ')}\n`;
-                    }
-                });
-                context += '\n';
-            }
-            if (conventions.conventions.length > 0) {
-                context += `## Conventions to Follow\n`;
-                conventions.conventions.forEach(c => {
-                    context += `- **${c.category}**: ${c.rule}\n`;
-                    if (c.example)
-                        context += `  Example: ${c.example}\n`;
-                });
-                context += '\n';
-            }
-            if (conventions.antiPatterns.length > 0) {
-                context += `## Anti-Patterns to Avoid\n`;
-                conventions.antiPatterns.forEach(ap => {
-                    context += `- ❌ ${ap.pattern}\n  → Instead: ${ap.instead}\n`;
-                });
-            }
-            // LANGUAGE INTELLIGENCE: Inject language-specific rules
-            try {
-                const langProfile = await resolveLanguageProfile(repoId, client);
-                if (langProfile && langProfile.primary !== 'unknown') {
-                    const langRules = getLanguageRules(langProfile);
-                    if (langRules) {
-                        const langLabel = langProfile.primary.charAt(0).toUpperCase() + langProfile.primary.slice(1);
-                        const confidence = langProfile.confidence >= 0.7 ? 'auto-detected' : 'inferred';
-                        context += `\n## 🗣️ Language: ${langLabel} (${confidence})\n`;
-                        context += langRules + '\n';
-                    }
-                }
-            }
-            catch {
-                // Silently skip if language detection fails
-            }
-            // AUTO-DETECT: Recommend approach based on task keywords
-            const taskLower = task.toLowerCase();
-            let recommendedApproach = '';
-            if (taskLower.includes('review') || taskLower.includes('check') || taskLower.includes('audit')) {
-                recommendedApproach = 'code-review';
-            }
-            else if (taskLower.includes('fix') || taskLower.includes('bug') || taskLower.includes('error') || taskLower.includes('debug')) {
-                recommendedApproach = 'debugging';
-            }
-            else if (taskLower.includes('refactor') || taskLower.includes('clean') || taskLower.includes('organize')) {
-                recommendedApproach = 'refactoring';
-            }
-            else if (taskLower.includes('test') || taskLower.includes('spec')) {
-                recommendedApproach = 'testing';
-            }
-            else if (taskLower.includes('security') || taskLower.includes('auth') || taskLower.includes('permission')) {
-                recommendedApproach = 'security-review';
-            }
-            else if (taskLower.includes('api') || taskLower.includes('endpoint') || taskLower.includes('route')) {
-                recommendedApproach = 'api-design';
-            }
-            if (recommendedApproach) {
-                context += `\n## 🤖 Recommended Approach: ${recommendedApproach}\n`;
-                context += `_Based on your task, consider using a ${recommendedApproach} mindset._\n`;
-            }
-            // AUTO-INJECT: Relevant public Sights for reference
-            try {
-                const publicSights = await client.recommendSights(task, 3);
-                if (publicSights.length > 0) {
-                    context += '\n## 📚 Related Open Source Sights\n';
-                    context += '_These public codebases have been analyzed and may contain useful patterns:_\n\n';
-                    publicSights.forEach(s => {
-                        context += `- **${s.owner}/${s.repo}** ⭐${s.stars.toLocaleString()} — ${s.description}\n`;
-                        context += `  → \`merlin_get_public_sight_context\` with owner="${s.owner}" repo="${s.repo}" to explore\n`;
-                    });
-                    context += '\n';
-                }
-            }
-            catch {
-                // Silently skip if public sights unavailable
-            }
-            // AUTO-INJECT: Current project state (tasks, blockers, plans)
-            try {
-                const teamState = await client.getTeamState(repoId);
-                if (teamState) {
-                    const activeTaskCount = (teamState.taskSummary?.in_progress || 0) + (teamState.taskSummary?.pending || 0);
-                    const blockerCount = teamState.openBlockers?.length || 0;
-                    const stateKeys = Object.keys(teamState.state || {});
-                    if (activeTaskCount > 0 || blockerCount > 0 || stateKeys.length > 0) {
-                        context += '\n## 📋 Current Project State\n';
-                        context += '_Synced from your Merlin dashboard — DO NOT ignore this data._\n\n';
-                        if (activeTaskCount > 0) {
-                            context += `**Active Tasks:** ${activeTaskCount} (${teamState.taskSummary?.in_progress || 0} in progress, ${teamState.taskSummary?.pending || 0} pending)\n`;
-                        }
-                        if (blockerCount > 0) {
-                            context += `\n**⚠️ Blockers:** ${blockerCount} open blockers need attention\n`;
-                            (teamState.openBlockers || []).slice(0, 3).forEach((b) => {
-                                context += `- ${b.title || b.description} (${b.severity || 'medium'})\n`;
-                            });
-                        }
-                        const importantKeys = stateKeys.filter((k) => k.toLowerCase().includes('project') || k.toLowerCase().includes('roadmap') || k.toLowerCase().includes('todo'));
-                        if (importantKeys.length > 0) {
-                            context += `\n**Planning Artifacts:** ${importantKeys.join(', ')}\n`;
-                        }
-                        context += '\n';
-                    }
-                }
-            }
-            catch {
-                // Silently skip if team state unavailable
-            }
-            // ── Phase 9 Wave 4: Project Picture augmentation ─────────────────────
-            // Gated by MERLIN_CROSS_BRANCH_ENABLED — always best-effort, never blocking
-            if (process.env.MERLIN_CROSS_BRANCH_ENABLED === 'true') {
-                try {
-                    let currentBranch = null;
-                    try {
-                        const { execFile } = await import('child_process');
-                        const { promisify } = await import('util');
-                        const execFileAsync = promisify(execFile);
-                        const { stdout } = await execFileAsync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { timeout: 3000 });
-                        const b = stdout.trim();
-                        if (b && b !== 'HEAD')
-                            currentBranch = b;
-                    }
-                    catch { /* non-fatal */ }
-                    const apiBase = process.env.MERLIN_API_URL ?? 'https://auth.merlin.build';
-                    const ppUrl = new URL(`/api/repos/${repoId}/project-picture`, apiBase);
-                    if (currentBranch)
-                        ppUrl.searchParams.set('branch', currentBranch);
-                    if (task)
-                        ppUrl.searchParams.set('task', task.slice(0, 200));
-                    const ppHeaders = { 'Content-Type': 'application/json' };
-                    const ppKey = process.env.MERLIN_API_KEY;
-                    if (ppKey)
-                        ppHeaders['Authorization'] = `Bearer ${ppKey}`;
-                    const ppResp = await fetch(ppUrl.toString(), {
-                        headers: ppHeaders,
-                        signal: AbortSignal.timeout(5000),
-                    });
-                    if (ppResp.ok) {
-                        const pp = await ppResp.json();
-                        context += `\n## 🌿 Project Picture (cross-branch)\n`;
-                        context += `_${pp.disclaimer}_\n\n`;
-                        context += `**Current Branch:** \`${pp.currentBranch}\`\n`;
-                        if (pp.liveBranches && pp.liveBranches.length > 0) {
-                            context += `**Live Branches (${pp.liveBranches.length}):** ${pp.liveBranches.slice(0, 8).map((b) => `\`${b.name}\``).join(', ')}\n`;
-                        }
-                        else {
-                            context += `**Live Branches:** _(none — single-branch workspace)_\n`;
-                        }
-                        if (pp.signals && pp.signals.length > 0) {
-                            const topSignals = pp.signals.slice(0, 5);
-                            context += `\n**Signals (top ${topSignals.length}):**\n`;
-                            for (const s of topSignals) {
-                                const emoji = s.kind === 'drift' ? '⚠️' : '💡';
-                                context += `${emoji} **${s.kind}** \`${s.filePath}\` severity=${s.severity.toFixed(2)} — ${s.summary}\n`;
-                                context += `  _(${s.sourceBranch} → ${s.targetBranch})_\n`;
-                            }
-                        }
-                        else {
-                            context += `**Signals:** _(none — no cross-branch conflicts detected)_\n`;
-                        }
-                        context += '\n';
-                    }
-                }
-                catch {
-                    // Strictly best-effort — never break context delivery
-                }
-            }
-            // ── End Project Picture augmentation ─────────────────────────────────
-            // Bridge: update file-based timestamp so pre-edit hooks know Sights is fresh
-            recordSightsCall();
-            return { content: [{ type: 'text', text: context }] };
-        }
-        catch (error) {
-            return {
-                content: [{ type: 'text', text: `Error getting context: ${error instanceof Error ? error.message : 'Unknown error'}` }],
-                isError: true,
-            };
-        }
-    });
-    // ── CORE tool: always loaded, used before reading or modifying any file ─
-    // Tool: merlin_find_files
-    server.tool('merlin_find_files', 'Find files by purpose, description, or architectural layer. Call BEFORE creating any new file to check if something similar already exists. Returns file paths, exports, dependencies, and which files to modify for a given task. Supports layer filters: routes, services, models, utils, components, hooks, middleware, config, tests. Always re-fetch before editing — files may have moved. Use to locate existing functions before adding duplicates.', {
-        query: z.string().describe('What you are looking for'),
-        layer: z.string().optional().describe('Filter by layer (routes, services, models, utils, components, etc.)'),
-        repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
-    }, async ({ query, layer, repoUrl }) => {
-        try {
-            const repoId = await resolveRepoId(repoUrl);
-            if (!repoId) {
-                return {
-                    content: [{ type: 'text', text: 'Could not find repository. Make sure the repo is analyzed on merlin.build.' }],
-                };
-            }
-            const files = await client.getFiles(repoId, { layer, purpose: query });
-            if (files.files.length > 0) {
-                let result = `# Files matching "${query}"${layer ? ` in ${layer} layer` : ''}\n\n`;
-                result += `Found ${files.count} files:\n\n`;
-                files.files.forEach(f => {
-                    result += `## ${f.path}\n`;
-                    result += `- **Purpose**: ${f.purpose}\n`;
-                    result += `- **Layer**: ${f.layer}\n`;
-                    if (f.exports.length > 0) {
-                        result += `- **Exports**: ${f.exports.map(e => `${e.name} (${e.type})`).join(', ')}\n`;
-                    }
-                    if (f.modifyFor.length > 0) {
-                        result += `- **Modify for**: ${f.modifyFor.join(', ')}\n`;
-                    }
-                    result += '\n';
-                });
-                recordSightsCall();
-                return { content: [{ type: 'text', text: result }] };
-            }
-            const findResult = await client.findFiles(repoId, query);
-            recordSightsCall();
-            return { content: [{ type: 'text', text: findResult }] };
-        }
-        catch (error) {
-            return {
-                content: [{ type: 'text', text: `Error finding files: ${error instanceof Error ? error.message : 'Unknown error'}` }],
-                isError: true,
-            };
-        }
-    });
-    // ── DEFERRED tool: loaded on-demand for style/rule questions ────────────
-    // Tool: merlin_get_conventions
-    server.tool('merlin_get_conventions', 'Get ALL coding conventions, anti-patterns, style rules, naming guidelines, and step-by-step change guides for the codebase. Returns rules organized by category (naming, structure, error handling, testing, etc.) with code examples and example files. Use when reviewing code quality, auditing for style violations, understanding what patterns to avoid, or learning the full rulebook before a major refactor.', {
-        repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
-    }, async ({ repoUrl }) => {
-        try {
-            const repoId = await resolveRepoId(repoUrl);
-            if (!repoId) {
-                return {
-                    content: [{ type: 'text', text: 'Could not find repository. Make sure the repo is analyzed on merlin.build.' }],
-                };
-            }
-            const conventions = await client.getConventions(repoId);
-            let result = '# Coding Conventions\n\n';
-            if (conventions.conventions.length > 0) {
-                result += '## Conventions\n\n';
-                conventions.conventions.forEach(c => {
-                    result += `### ${c.category}\n${c.rule}\n`;
-                    if (c.example)
-                        result += `\n**Example:**\n\`\`\`\n${c.example}\n\`\`\`\n`;
-                    if (c.exampleFiles.length > 0)
-                        result += `\n**See**: ${c.exampleFiles.join(', ')}\n`;
-                    result += '\n';
-                });
-            }
-            if (conventions.antiPatterns.length > 0) {
-                result += '## Anti-Patterns (Avoid These)\n\n';
-                conventions.antiPatterns.forEach(ap => {
-                    result += `### ❌ ${ap.pattern}\n`;
-                    result += `**Reason**: ${ap.reason}\n**Instead**: ${ap.instead}\n**Severity**: ${ap.severity}\n\n`;
-                });
-            }
-            if (conventions.changeGuides.length > 0) {
-                result += '## Change Guides\n\n';
-                conventions.changeGuides.slice(0, 5).forEach(cg => {
-                    result += `### ${cg.task}\n${cg.description}\n\n**Steps:**\n`;
-                    cg.steps.forEach(s => {
-                        result += `${s.order}. ${s.file}: ${s.description}\n`;
-                    });
-                    result += '\n';
-                });
-            }
-            // LANGUAGE INTELLIGENCE: Append language-specific rules
-            try {
-                const langProfile = await resolveLanguageProfile(repoId, client);
-                if (langProfile && langProfile.primary !== 'unknown') {
-                    const langRules = getLanguageRules(langProfile);
-                    if (langRules) {
-                        const langLabel = langProfile.primary.charAt(0).toUpperCase() + langProfile.primary.slice(1);
-                        const confidence = langProfile.confidence >= 0.7 ? 'auto-detected' : 'inferred';
-                        result += `## 🗣️ Language Rules: ${langLabel} (${confidence})\n\n`;
-                        result += langRules + '\n';
-                    }
-                }
-            }
-            catch {
-                // Silently skip if language detection fails
-            }
-            return { content: [{ type: 'text', text: result }] };
-        }
-        catch (error) {
-            return {
-                content: [{ type: 'text', text: `Error getting conventions: ${error instanceof Error ? error.message : 'Unknown error'}` }],
-                isError: true,
-            };
-        }
-    });
-    // ── DEFERRED tool: loaded on-demand for onboarding/orientation ──────────
-    // Tool: merlin_quickstart
-    server.tool('merlin_quickstart', 'Get a 60-second onboarding guide for a new contributor or agent. Returns the project quickstart document: repo folder structure, entry points, development commands (install/build/test/run), environment setup, key concepts, and where to start. Use when first encountering an unfamiliar codebase, onboarding a new team member, or needing a fast orientation without reading the code.', {
-        repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
-    }, async ({ repoUrl }) => {
-        try {
-            const repoId = await resolveRepoId(repoUrl);
-            if (!repoId) {
-                return {
-                    content: [{ type: 'text', text: 'Could not find repository. Make sure the repo is analyzed on merlin.build.' }],
-                };
-            }
-            const quickstart = await client.getQuickstart(repoId);
-            return { content: [{ type: 'text', text: quickstart }] };
-        }
-        catch (error) {
-            return {
-                content: [{ type: 'text', text: `Error getting quickstart: ${error instanceof Error ? error.message : 'Unknown error'}` }],
-                isError: true,
-            };
-        }
-    });
-    // ── CORE tool: always loaded, used for searching documentation ──────────
-    // Tool: merlin_search
-    server.tool('merlin_search', 'Keyword search across project documentation, wiki, architecture notes, API docs, and knowledge base. Returns matching doc sections with real-time content from the latest commit. Use to find specific functions, API endpoints, configuration options, architecture decisions, or any documented behavior. Complement to merlin_get_context — use this for targeted keyword lookup when you know what you\'re searching for.', {
-        query: z.string().describe('What you want to find'),
-        repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
-    }, async ({ query, repoUrl }) => {
-        try {
-            const repoId = await resolveRepoId(repoUrl);
-            if (!repoId) {
-                return {
-                    content: [{ type: 'text', text: 'Could not find repository. Make sure the repo is analyzed on merlin.build.' }],
-                };
-            }
-            const results = await client.search(repoId, query);
-            recordSightsCall();
-            return { content: [{ type: 'text', text: results }] };
-        }
-        catch (error) {
-            return {
-                content: [{ type: 'text', text: `Error searching: ${error instanceof Error ? error.message : 'Unknown error'}` }],
-                isError: true,
-            };
-        }
-    });
-    // ── DEFERRED tool: loaded on-demand for natural language codebase Q&A ──
-    // Tool: merlin_ask
-    server.tool('merlin_ask', 'Ask a natural language question about the codebase and get an AI-generated answer with source citations. Uses semantic search + RAG across docs, code, conventions, and history. Use when you need a direct explanation rather than raw file paths — e.g., "how does authentication work?", "where is billing handled?", "what pattern is used for error handling?", "why does X exist?". Returns answer with high/medium relevance sources.', {
-        question: z.string().describe('Your question in natural language'),
-        quick: z.boolean().optional().default(false).describe('If true, returns a faster but shorter answer without detailed sources'),
-        repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
-    }, async ({ question, quick, repoUrl }) => {
-        try {
-            const repoId = await resolveRepoId(repoUrl);
-            if (!repoId) {
-                return {
-                    content: [{ type: 'text', text: 'Could not find repository. Make sure the repo is analyzed on merlin.build.' }],
-                };
-            }
-            const response = await client.ask(repoId, question, { quick });
-            let result = `# Answer\n\n${response.answer}\n`;
-            if (response.sources && response.sources.length > 0 && !quick) {
-                result += `\n## Sources\n`;
-                const highRelevance = response.sources.filter(s => s.relevance === 'high');
-                const mediumRelevance = response.sources.filter(s => s.relevance === 'medium');
-                if (highRelevance.length > 0) {
-                    result += `\n**Key Sources:**\n`;
-                    highRelevance.forEach(s => {
-                        result += `- ${s.path || s.name} (${s.type})\n`;
-                    });
-                }
-                if (mediumRelevance.length > 0) {
-                    result += `\n**Related:**\n`;
-                    mediumRelevance.slice(0, 5).forEach(s => {
-                        result += `- ${s.path || s.name}\n`;
-                    });
-                }
-            }
-            if (response.confidence) {
-                const confidenceEmoji = response.confidence === 'high' ? '✓' : response.confidence === 'medium' ? '~' : '?';
-                result += `\n---\n_Confidence: ${confidenceEmoji} ${response.confidence} | Method: ${response.searchMethod || 'unknown'}_`;
-            }
-            return { content: [{ type: 'text', text: result }] };
-        }
-        catch (error) {
-            return {
-                content: [{ type: 'text', text: `Error answering question: ${error instanceof Error ? error.message : 'Unknown error'}` }],
-                isError: true,
-            };
-        }
-    });
-}
-//# sourceMappingURL=context.js.map