create-merlin-brain 3.11.0 → 3.13.0

package/dist/server/tools/promote.js

@@ -0,0 +1,315 @@
+/**
+ * Behavior → Skill Promotion
+ * MCP tool for promoting high-confidence learned behaviors into reusable skills/agents.
+ * Behaviors at confidence >= 0.85 are flagged as promotion candidates.
+ *
+ * Clustering: behaviors with overlapping trigger keywords are grouped into
+ * a single skill with multiple actions, keeping the agent catalog focused.
+ */
+import { z } from 'zod';
+/** Promotion confidence threshold — behaviors above this are ready */
+const PROMOTION_THRESHOLD = 0.85;
+// ── Clustering helpers ───────────────────────────────────────────────────────
+/**
+ * Extract meaningful keywords from pattern text.
+ * Strips stop words and short tokens.
+ */
+function extractKeywords(text) {
+    const STOP_WORDS = new Set([
+        'the', 'a', 'an', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
+        'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'should',
+        'can', 'could', 'may', 'might', 'must', 'shall', 'to', 'of', 'in',
+        'on', 'at', 'by', 'for', 'with', 'about', 'and', 'or', 'but', 'not',
+        'this', 'that', 'these', 'those', 'it', 'its', 'user', 'always',
+        'when', 'after', 'before', 'if', 'then', 'any', 'all', 'new',
+    ]);
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s\/\-_]/g, ' ')
+        .split(/\s+/)
+        .filter(w => w.length > 2 && !STOP_WORDS.has(w));
+}
+/**
+ * Compute Jaccard similarity between two keyword sets.
+ * Returns 0–1 where 1 = identical.
+ */
+function jaccardSimilarity(a, b) {
+    const setA = new Set(a);
+    const setB = new Set(b);
+    const intersection = [...setA].filter(w => setB.has(w));
+    const union = new Set([...setA, ...setB]);
+    return union.size === 0 ? 0 : intersection.length / union.size;
+}
+/**
+ * Cluster behaviors by keyword overlap.
+ * Threshold of 0.3 similarity puts behaviors into the same cluster.
+ * Single-item clusters remain as standalone skills.
+ */
+function clusterBehaviors(behaviors) {
+    const SIMILARITY_THRESHOLD = 0.3;
+    const keywords = behaviors.map(b => extractKeywords(`${b.pattern} ${b.action} ${b.context ?? ''}`));
+    const assigned = new Set();
+    const clusters = [];
+    for (let i = 0; i < behaviors.length; i++) {
+        if (assigned.has(i))
+            continue;
+        const cluster = {
+            behaviors: [behaviors[i]],
+            sharedKeywords: keywords[i],
+        };
+        assigned.add(i);
+        for (let j = i + 1; j < behaviors.length; j++) {
+            if (assigned.has(j))
+                continue;
+            const sim = jaccardSimilarity(keywords[i], keywords[j]);
+            if (sim >= SIMILARITY_THRESHOLD) {
+                cluster.behaviors.push(behaviors[j]);
+                // Intersect shared keywords to keep only truly common terms
+                const setJ = new Set(keywords[j]);
+                cluster.sharedKeywords = cluster.sharedKeywords.filter(w => setJ.has(w));
+                assigned.add(j);
+            }
+        }
+        clusters.push(cluster);
+    }
+    return clusters;
+}
+// ── Skill draft generation ───────────────────────────────────────────────────
+/**
+ * Derive a PascalCase skill name from shared keywords.
+ */
+function deriveSkillName(cluster) {
+    const topWords = cluster.sharedKeywords.slice(0, 3);
+    if (topWords.length === 0) {
+        // Fallback: use first few words of the primary pattern
+        const fallback = extractKeywords(cluster.behaviors[0].pattern).slice(0, 2);
+        return fallback.map(w => w.charAt(0).toUpperCase() + w.slice(1)).join('') || 'LearnedSkill';
+    }
+    return topWords.map(w => w.charAt(0).toUpperCase() + w.slice(1)).join('');
+}
+/**
+ * Determine trigger conditions from cluster behavior patterns.
+ */
+function deriveTriggers(cluster) {
+    if (cluster.behaviors.length === 1) {
+        return cluster.behaviors[0].pattern;
+    }
+    const triggers = cluster.behaviors.map(b => `- ${b.pattern}`).join('\n');
+    return `Any of the following:\n${triggers}`;
+}
+/**
+ * Determine the context scope for the skill.
+ */
+function deriveContext(cluster) {
+    const contexts = cluster.behaviors
+        .map(b => b.context)
+        .filter((c) => Boolean(c));
+    if (contexts.length === 0)
+        return 'General development tasks';
+    if (contexts.length === 1)
+        return contexts[0];
+    return contexts.join('; ');
+}
+/**
+ * Generate a SKILL.md draft from a behavior cluster.
+ */
+function generateSkillDraft(cluster) {
+    const name = deriveSkillName(cluster);
+    const avgConfidence = cluster.behaviors.reduce((s, b) => s + b.confidence, 0) / cluster.behaviors.length;
+    const totalApplications = cluster.behaviors.reduce((s, b) => s + b.timesApplied, 0);
+    const behaviorIds = cluster.behaviors.map(b => b.id).join(', ');
+    const actions = cluster.behaviors.length === 1
+        ? cluster.behaviors[0].action
+        : cluster.behaviors.map((b, i) => `${i + 1}. ${b.action}`).join('\n');
+    const exampleUsage = cluster.behaviors[0].pattern;
+    return `---
+name: ${name}
+type: skill
+promoted-from-behaviors: [${behaviorIds}]
+avg-confidence: ${avgConfidence.toFixed(2)}
+total-applications: ${totalApplications}
+created: ${new Date().toISOString().slice(0, 10)}
+---
+
+# ${name}
+
+## Description
+A reusable skill promoted from ${cluster.behaviors.length} learned behavior pattern${cluster.behaviors.length > 1 ? 's' : ''} that proved effective (avg confidence: ${(avgConfidence * 100).toFixed(0)}%).
+
+## Trigger Conditions
+${deriveTriggers(cluster)}
+
+## Actions
+${actions}
+
+## Context / Scope
+${deriveContext(cluster)}
+
+## Example Usage
+> "${exampleUsage}"
+${cluster.behaviors.length > 1 ? '\n## Source Behaviors\n' + cluster.behaviors.map(b => `- **${b.pattern}** → ${b.action} _(confidence: ${b.confidence})_`).join('\n') : ''}
+
+## Notes
+- Promoted from learned behaviors — edit to refine trigger conditions or actions.
+- Re-save to the agent catalog via merlin_promote_behavior if you make changes.
+`;
+}
+// ── Tool registration ────────────────────────────────────────────────────────
+export function registerPromoteTools(ctx) {
+    const { server, client, resolveRepoId } = ctx;
+    // ── DEFERRED tool: loaded on-demand for skill promotion workflow ──────────
+    // Tool: merlin_promote_behavior
+    server.tool('merlin_promote_behavior', 'Promote a learned behavior into a reusable skill or agent. Use when a behavior pattern has proven effective (confidence >= 0.85) and should become a permanent tool. Generates SKILL.md from behavior data. Accepts a behavior ID or a pattern keyword to find matching candidates. Related behaviors are automatically clustered into a single skill. Returns the draft for user review.', {
+        behaviorId: z.string().optional().describe('ID of the specific behavior to promote'),
+        patternKeyword: z.string().optional().describe('Keyword to search for in behavior patterns (if no ID)'),
+        approved: z.boolean().optional().describe('Set true to finalize and save the skill draft (after reviewing)'),
+        skillDraft: z.string().optional().describe('Edited skill draft to save (used with approved=true)'),
+        repoUrl: z.string().optional().describe('GitHub URL of the repository'),
+    }, async ({ behaviorId, patternKeyword, approved, skillDraft, repoUrl }) => {
+        try {
+            const repoId = await resolveRepoId(repoUrl);
+            if (!repoId) {
+                return {
+                    content: [{ type: 'text', text: 'Could not find repository. Select a repo first.' }],
+                    isError: true,
+                };
+            }
+            // ── Approval path: save an already-reviewed draft ──────────────────
+            if (approved && skillDraft) {
+                // Extract skill name from frontmatter for a stable filename
+                const nameMatch = skillDraft.match(/^name:\s*(.+)$/m);
+                const skillName = nameMatch ? nameMatch[1].trim() : `promoted-skill-${Date.now()}`;
+                const fileName = `${skillName.toLowerCase().replace(/[^a-z0-9]+/g, '-')}.md`;
+                // Extract description from the draft body
+                const descSection = skillDraft.split('## Description\n')[1];
+                const description = descSection
+                    ? descSection.split('\n\n')[0]?.trim() ?? skillName
+                    : skillName;
+                // Persist skill via Sights discovery endpoint.
+                // We encode the full SKILL.md as the "summary" and tag the query so it's
+                // retrievable later with merlin_get_context("skill: <name>").
+                await client.saveDiscovery(repoId, {
+                    query: `skill: ${skillName}`,
+                    summary: skillDraft,
+                    patterns: [`promoted-skill`, `skill:${skillName}`, fileName],
+                    relatedTopics: ['skills', 'promoted-behaviors', 'agent-catalog'],
+                    agentId: 'merlin-promote',
+                });
+                let response = `# Skill Saved: ${skillName}\n\n`;
+                response += `${description}\n\n`;
+                response += `**Catalog file:** ${fileName}\n`;
+                response += `**Retrievable via:** merlin_get_context("skill: ${skillName}")\n`;
+                response += `\nThe skill is now part of this project's Sights index.`;
+                return { content: [{ type: 'text', text: response }] };
+            }
+            // ── Discovery path: find and draft the skill ───────────────────────
+            const allResult = await client.getBehaviors(repoId, { minConfidence: PROMOTION_THRESHOLD });
+            const candidates = allResult.behaviors;
+            if (candidates.length === 0) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `No behaviors have reached the promotion threshold (confidence >= ${PROMOTION_THRESHOLD}) yet.\n\nKeep applying behaviors — confidence grows by +0.05 per successful application.`,
+                        }],
+                };
+            }
+            // Filter to the requested behavior or keyword
+            let selected = candidates;
+            if (behaviorId) {
+                selected = candidates.filter(b => b.id === behaviorId);
+                if (selected.length === 0) {
+                    return {
+                        content: [{ type: 'text', text: `Behavior "${behaviorId}" not found or has not reached confidence >= ${PROMOTION_THRESHOLD}.` }],
+                        isError: true,
+                    };
+                }
+            }
+            else if (patternKeyword) {
+                const kw = patternKeyword.toLowerCase();
+                selected = candidates.filter(b => b.pattern.toLowerCase().includes(kw) ||
+                    b.action.toLowerCase().includes(kw) ||
+                    (b.context ?? '').toLowerCase().includes(kw));
+                if (selected.length === 0) {
+                    return {
+                        content: [{ type: 'text', text: `No promotion-ready behaviors matched keyword "${patternKeyword}".` }],
+                    };
+                }
+            }
+            // Cluster and generate drafts
+            const clusters = clusterBehaviors(selected);
+            const drafts = clusters.map(generateSkillDraft);
+            let response = `# Skill Promotion Draft${drafts.length > 1 ? 's' : ''}\n\n`;
+            response += `Found **${selected.length}** promotion-ready behavior${selected.length > 1 ? 's' : ''} clustered into **${clusters.length}** skill${clusters.length > 1 ? 's' : ''}.\n\n`;
+            response += `---\n\n`;
+            drafts.forEach((draft, i) => {
+                const cluster = clusters[i];
+                response += `## Draft ${i + 1}${drafts.length > 1 ? ` of ${drafts.length}` : ''}\n`;
+                if (cluster.behaviors.length > 1) {
+                    response += `_Clusters ${cluster.behaviors.length} related behaviors._\n`;
+                }
+                response += `\n\`\`\`markdown\n${draft}\n\`\`\`\n\n`;
+            });
+            response += `---\n`;
+            response += `**To save:** Call merlin_promote_behavior again with:\n`;
+            response += `- \`approved: true\`\n`;
+            response += `- \`skillDraft\`: the markdown above (edit first if needed)\n`;
+            return { content: [{ type: 'text', text: response }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error in promote_behavior: ${error instanceof Error ? error.message : 'Unknown'}` }],
+                isError: true,
+            };
+        }
+    });
+    // ── DEFERRED tool: list all promotion candidates ──────────────────────────
+    // Tool: merlin_list_promotion_candidates
+    server.tool('merlin_list_promotion_candidates', 'List all learned behaviors that have reached the promotion threshold (confidence >= 0.85) and are ready to become permanent skills. Shows behavior ID, pattern, confidence, and application count. Use before running /merlin:promote to see what is available.', {
+        repoUrl: z.string().optional().describe('GitHub URL of the repository'),
+    }, async ({ repoUrl }) => {
+        try {
+            const repoId = await resolveRepoId(repoUrl);
+            if (!repoId) {
+                return {
+                    content: [{ type: 'text', text: 'Could not find repository. Select a repo first.' }],
+                    isError: true,
+                };
+            }
+            const result = await client.getBehaviors(repoId, { minConfidence: PROMOTION_THRESHOLD });
+            const candidates = result.behaviors;
+            if (candidates.length === 0) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `No behaviors have reached the promotion threshold yet (confidence >= ${PROMOTION_THRESHOLD}).\n\nCurrent highest-confidence behaviors:\n_Run merlin_get_behaviors to see all patterns._`,
+                        }],
+                };
+            }
+            let response = `# Promotion Candidates\n\n`;
+            response += `_${candidates.length} behavior${candidates.length > 1 ? 's' : ''} ready for promotion (confidence >= ${PROMOTION_THRESHOLD})_\n\n`;
+            candidates.forEach((b, i) => {
+                response += `### ${i + 1}. ${b.pattern}\n`;
+                response += `**ID:** \`${b.id}\`\n`;
+                response += `**Action:** ${b.action}\n`;
+                if (b.context)
+                    response += `**Context:** ${b.context}\n`;
+                response += `**Confidence:** ${b.confidence} | **Applied:** ${b.timesApplied}x | **Corrected:** ${b.timesCorrected}x\n\n`;
+            });
+            // Show clustering preview
+            const clusters = clusterBehaviors(candidates);
+            if (clusters.length < candidates.length) {
+                response += `---\n`;
+                response += `_These ${candidates.length} behaviors will be clustered into ${clusters.length} skill${clusters.length > 1 ? 's' : ''} on promotion._\n`;
+            }
+            response += `\nRun \`/merlin:promote\` or call \`merlin_promote_behavior\` to generate skill drafts.`;
+            return { content: [{ type: 'text', text: response }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error listing candidates: ${error instanceof Error ? error.message : 'Unknown'}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=promote.js.map

package/dist/server/tools/promote.js.map

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

package/dist/server/tools/route-helpers.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Route Helpers — Agent frontmatter parsing, effort levels, and role constants.
+ *
+ * Extracted from route.ts to keep the main routing file focused on
+ * tool registration and orchestration logic.
+ */
+/** Valid effort levels for agent definitions */
+export type EffortLevel = 'high' | 'medium' | 'low';
+/** Valid isolation modes for agent definitions */
+export type IsolationMode = 'worktree' | null;
+/**
+ * Parse the YAML frontmatter block from an agent .md file.
+ * Returns the raw frontmatter string or null if not present.
+ */
+export declare function parseFrontmatter(agentPath: string): string | null;
+/**
+ * Read the effort field from an agent's .md frontmatter.
+ * Returns 'medium' as the safe default if not found or unreadable.
+ */
+export declare function readAgentEffort(agentPath: string): EffortLevel;
+/**
+ * Read the isolation field from an agent's .md frontmatter.
+ * Returns 'worktree' if isolation: worktree is set, otherwise null.
+ */
+export declare function readAgentIsolation(agentPath: string): IsolationMode;
+/**
+ * Read the background field from an agent's .md frontmatter.
+ * Returns true if background: true is set.
+ */
+export declare function readAgentBackground(agentPath: string): boolean;
+/**
+ * Build the task prompt prefix based on effort level.
+ * - high: prepend ultrathink for deep reasoning
+ * - low: append concise note to avoid unnecessary exploration
+ * - medium: no prefix (default behavior)
+ */
+export declare function buildEffortPrefix(effort: EffortLevel): {
+    prefix: string;
+    suffix: string;
+};
+/** Known specialist agents and their roles */
+export declare const AGENT_ROLES: Record<string, string>;
+/** Merlin internal workflow agents */
+export declare const WORKFLOW_AGENTS: string[];
+//# sourceMappingURL=route-helpers.d.ts.map

package/dist/server/tools/route-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-helpers.d.ts","sourceRoot":"","sources":["../../../src/server/tools/route-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,gDAAgD;AAChD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEpD,kDAAkD;AAClD,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,IAAI,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQjE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAM9D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAKnE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAI9D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAWzF;AAED,8CAA8C;AAC9C,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAS9C,CAAC;AAEF,sCAAsC;AACtC,eAAO,MAAM,eAAe,UAM3B,CAAC"}

package/dist/server/tools/route-helpers.js

@@ -0,0 +1,93 @@
+/**
+ * Route Helpers — Agent frontmatter parsing, effort levels, and role constants.
+ *
+ * Extracted from route.ts to keep the main routing file focused on
+ * tool registration and orchestration logic.
+ */
+import { readFileSync } from 'fs';
+/**
+ * Parse the YAML frontmatter block from an agent .md file.
+ * Returns the raw frontmatter string or null if not present.
+ */
+export function parseFrontmatter(agentPath) {
+    try {
+        const content = readFileSync(agentPath, 'utf-8');
+        const match = content.match(/^---\n([\s\S]*?)\n---/);
+        return match ? match[1] : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read the effort field from an agent's .md frontmatter.
+ * Returns 'medium' as the safe default if not found or unreadable.
+ */
+export function readAgentEffort(agentPath) {
+    const frontmatter = parseFrontmatter(agentPath);
+    if (!frontmatter)
+        return 'medium';
+    const match = frontmatter.match(/^effort:\s*(high|medium|low)\s*$/m);
+    if (!match)
+        return 'medium';
+    return match[1];
+}
+/**
+ * Read the isolation field from an agent's .md frontmatter.
+ * Returns 'worktree' if isolation: worktree is set, otherwise null.
+ */
+export function readAgentIsolation(agentPath) {
+    const frontmatter = parseFrontmatter(agentPath);
+    if (!frontmatter)
+        return null;
+    const match = frontmatter.match(/^isolation:\s*(worktree)\s*$/m);
+    return match ? match[1] : null;
+}
+/**
+ * Read the background field from an agent's .md frontmatter.
+ * Returns true if background: true is set.
+ */
+export function readAgentBackground(agentPath) {
+    const frontmatter = parseFrontmatter(agentPath);
+    if (!frontmatter)
+        return false;
+    return /^background:\s*true\s*$/m.test(frontmatter);
+}
+/**
+ * Build the task prompt prefix based on effort level.
+ * - high: prepend ultrathink for deep reasoning
+ * - low: append concise note to avoid unnecessary exploration
+ * - medium: no prefix (default behavior)
+ */
+export function buildEffortPrefix(effort) {
+    if (effort === 'high') {
+        return { prefix: 'ultrathink\n\n', suffix: '' };
+    }
+    if (effort === 'low') {
+        return {
+            prefix: '',
+            suffix: '\n\n> **Note:** Be concise and efficient. Focus on output over exploration.',
+        };
+    }
+    return { prefix: '', suffix: '' };
+}
+/** Known specialist agents and their roles */
+export const AGENT_ROLES = {
+    'product-spec': 'Feature specification and product definition',
+    'system-architect': 'Architecture decisions and system design',
+    'implementation-dev': 'Code implementation and feature building',
+    'dry-refactor': 'Code cleanup, DRY refactoring, file organization',
+    'hardening-guard': 'Security hardening, input validation, error handling',
+    'tests-qa': 'Testing and quality assurance',
+    'ops-railway': 'Deployment, ops, Railway, Google Cloud',
+    'docs-keeper': 'Documentation updates',
+};
+/** Merlin internal workflow agents */
+export const WORKFLOW_AGENTS = [
+    'merlin-planner', 'merlin-executor', 'merlin-codebase-mapper',
+    'merlin-debugger', 'merlin-researcher', 'merlin-reviewer',
+    'merlin-work-verifier', 'merlin-milestone-auditor',
+    'merlin-frontend', 'merlin-api-designer', 'merlin-security',
+    'merlin-performance', 'merlin-migrator', 'merlin-integration-checker',
+];
+//# sourceMappingURL=route-helpers.js.map

package/dist/server/tools/route-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-helpers.js","sourceRoot":"","sources":["../../../src/server/tools/route-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAQlC;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QACrD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,MAAM,WAAW,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAChD,IAAI,CAAC,WAAW;QAAE,OAAO,QAAQ,CAAC;IAClC,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACrE,IAAI,CAAC,KAAK;QAAE,OAAO,QAAQ,CAAC;IAC5B,OAAO,KAAK,CAAC,CAAC,CAAgB,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,MAAM,WAAW,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAChD,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACjE,OAAO,KAAK,CAAC,CAAC,CAAE,KAAK,CAAC,CAAC,CAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,MAAM,WAAW,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAChD,IAAI,CAAC,WAAW;QAAE,OAAO,KAAK,CAAC;IAC/B,OAAO,0BAA0B,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AACtD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAmB;IACnD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAClD,CAAC;IACD,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACrB,OAAO;YACL,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,6EAA6E;SACtF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AACpC,CAAC;AAED,8CAA8C;AAC9C,MAAM,CAAC,MAAM,WAAW,GAA2B;IACjD,cAAc,EAAE,8CAA8C;IAC9D,kBAAkB,EAAE,0CAA0C;IAC9D,oBAAoB,EAAE,0CAA0C;IAChE,cAAc,EAAE,kDAAkD;IAClE,iBAAiB,EAAE,sDAAsD;IACzE,UAAU,EAAE,+BAA+B;IAC3C,aAAa,EAAE,wCAAwC;IACvD,aAAa,EAAE,uBAAuB;CACvC,CAAC;AAEF,sCAAsC;AACtC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,gBAAgB,EAAE,iBAAiB,EAAE,wBAAwB;IAC7D,iBAAiB,EAAE,mBAAmB,EAAE,iBAAiB;IACzD,sBAAsB,EAAE,0BAA0B;IAClD,iBAAiB,EAAE,qBAAqB,EAAE,iBAAiB;IAC3D,oBAAoB,EAAE,iBAAiB,EAAE,4BAA4B;CACtE,CAAC"}

package/dist/server/tools/route.d.ts

@@ -7,9 +7,10 @@
  *
  * 1. Verifies agent exists
  * 2. Fetches Sights context for the task
- * 3. Builds structured handoff
- * 4. Spawns a fresh `claude --agent <name> -p` process
- * 5. Captures and returns the result
+ * 3. Discovers cloud agent augmentation
+ * 4. Builds structured handoff with domain expertise
+ * 5. Spawns a fresh `claude --agent <name> -p` process
+ * 6. Captures and returns the result
  *
  * Claude just calls `merlin_route(agent, task)` — no bash generation needed.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../src/server/tools/route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA2M9C,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,QAgRlD"}
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../src/server/tools/route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAY9C,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,QAoLlD"}