create-merlin-brain 3.22.0 → 4.0.0

package/dist/server/tools/dream.js

@@ -0,0 +1,246 @@
+/**
+ * AutoDream Memory Consolidation Tools
+ * Enables/configures Claude Code's AutoDream for Merlin's memory system.
+ * Project memory: ~/.claude/projects/<derived-path>/memory/
+ * Global memory:  ~/.claude/memory/
+ */
+import { z } from 'zod';
+import { existsSync, readFileSync, writeFileSync, readdirSync, statSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { coachWrap } from '../session-coach.js';
+const STALE_DAYS = 30;
+const SETTINGS_PATH = join(homedir(), '.claude', 'settings.json');
+const GLOBAL_MEMORY_DIR = join(homedir(), '.claude', 'memory');
+const PROJECTS_BASE_DIR = join(homedir(), '.claude', 'projects');
+// ── Settings ──────────────────────────────────────────────────────────────────
+function readSettings() {
+    if (!existsSync(SETTINGS_PATH))
+        return {};
+    try {
+        return JSON.parse(readFileSync(SETTINGS_PATH, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+function writeSettings(settings) {
+    const dir = join(homedir(), '.claude');
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(SETTINGS_PATH, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
+}
+// ── Path resolution ───────────────────────────────────────────────────────────
+/** Derive project memory path: replace / with -, strip leading - */
+function deriveProjectMemoryDir(repoRootPath) {
+    const derived = repoRootPath.replace(/\//g, '-').replace(/^-/, '');
+    return join(PROJECTS_BASE_DIR, derived, 'memory');
+}
+async function resolveMemoryDir(scope, getRepoRootPath) {
+    if (scope === 'global')
+        return { dir: GLOBAL_MEMORY_DIR, label: 'global' };
+    if (getRepoRootPath) {
+        const root = await getRepoRootPath();
+        if (root)
+            return { dir: deriveProjectMemoryDir(root), label: `project (${root})` };
+    }
+    // Fallback: find most recently modified project memory dir
+    if (existsSync(PROJECTS_BASE_DIR)) {
+        let newest = null;
+        for (const entry of readdirSync(PROJECTS_BASE_DIR)) {
+            const memDir = join(PROJECTS_BASE_DIR, entry, 'memory');
+            if (existsSync(memDir)) {
+                const st = statSync(memDir);
+                if (!newest || st.mtimeMs > newest.mtime)
+                    newest = { dir: memDir, mtime: st.mtimeMs };
+            }
+        }
+        if (newest)
+            return { dir: newest.dir, label: 'project (auto-detected)' };
+    }
+    return { dir: GLOBAL_MEMORY_DIR, label: 'global (fallback)' };
+}
+// ── Frontmatter parser ────────────────────────────────────────────────────────
+function parseFrontmatter(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match)
+        return { name: '', description: '', type: 'unknown' };
+    const block = match[1];
+    const get = (key) => { const m = block.match(new RegExp(`^${key}:\\s*(.+)$`, 'm')); return m ? m[1].trim() : ''; };
+    return { name: get('name'), description: get('description'), type: get('type') || 'unknown' };
+}
+// ── Memory scanner ────────────────────────────────────────────────────────────
+function scanMemoryFiles(dir) {
+    if (!existsSync(dir))
+        return [];
+    const staleCutoff = STALE_DAYS * 24 * 60 * 60 * 1000;
+    const now = Date.now();
+    const results = [];
+    for (const fname of readdirSync(dir)) {
+        if (!fname.endsWith('.md') || fname === 'MEMORY.md')
+            continue;
+        try {
+            const content = readFileSync(join(dir, fname), 'utf-8');
+            const st = statSync(join(dir, fname));
+            const fm = parseFrontmatter(content);
+            results.push({ name: fname, type: fm.type, description: fm.description || fm.name, modifiedAt: st.mtime, isStale: now - st.mtimeMs > staleCutoff });
+        }
+        catch { /* skip unreadable */ }
+    }
+    return results;
+}
+// ── Index checker ─────────────────────────────────────────────────────────────
+function checkMemoryIndex(dir, files) {
+    const indexPath = join(dir, 'MEMORY.md');
+    const existingNames = new Set(files.map(f => f.name));
+    if (!existsSync(indexPath))
+        return { orphanedEntries: [], unindexedFiles: files.map(f => f.name) };
+    const content = readFileSync(indexPath, 'utf-8');
+    const linked = new Set();
+    for (const m of content.matchAll(/\[.*?\]\(([^)]+\.md)\)/g))
+        linked.add(m[1]);
+    return {
+        orphanedEntries: [...linked].filter(f => !existingNames.has(f)),
+        unindexedFiles: [...existingNames].filter(f => !linked.has(f)),
+    };
+}
+// ── Duplicate detector ────────────────────────────────────────────────────────
+function findPotentialDuplicates(files) {
+    const dupes = [];
+    const baseName = (n) => n.replace(/\.md$/, '').replace(/[-_]\d+$/, '').toLowerCase();
+    for (let i = 0; i < files.length; i++) {
+        for (let j = i + 1; j < files.length; j++) {
+            const a = files[i];
+            const b = files[j];
+            if (a.type === b.type && baseName(a.name) === baseName(b.name)) {
+                dupes.push([a.name, b.name]);
+                continue;
+            }
+            if (a.description && b.description && a.description.length > 10 && b.description.length > 10) {
+                const [shorter, longer] = a.description.length < b.description.length ? [a.description, b.description] : [b.description, a.description];
+                if (longer.toLowerCase().includes(shorter.toLowerCase()))
+                    dupes.push([a.name, b.name]);
+            }
+        }
+    }
+    return dupes;
+}
+// ── Report formatter ──────────────────────────────────────────────────────────
+function formatConsolidationReport(files, indexIssues, label) {
+    const byType = {};
+    for (const f of files) {
+        if (!byType[f.type])
+            byType[f.type] = [];
+        byType[f.type].push(f.name);
+    }
+    const stale = files.filter(f => f.isStale).map(f => f.name);
+    const dupes = findPotentialDuplicates(files);
+    const suggestions = [];
+    if (dupes.length > 0)
+        suggestions.push(`Merge ${dupes.length} potential duplicate(s): ${dupes.map(([a, b]) => `${a} + ${b}`).join('; ')}`);
+    if (stale.length > 0)
+        suggestions.push(`Review ${stale.length} stale file(s) (${STALE_DAYS}+ days): ${stale.join(', ')}`);
+    if (indexIssues.orphanedEntries.length > 0)
+        suggestions.push(`Remove ${indexIssues.orphanedEntries.length} orphaned MEMORY.md link(s): ${indexIssues.orphanedEntries.join(', ')}`);
+    if (indexIssues.unindexedFiles.length > 0)
+        suggestions.push(`Add ${indexIssues.unindexedFiles.length} missing MEMORY.md entry(s): ${indexIssues.unindexedFiles.join(', ')}`);
+    if (suggestions.length === 0)
+        suggestions.push('Memory looks clean — no consolidation needed.');
+    const lines = [`## Memory Consolidation Report — ${label}`, '', `**Total memory files:** ${files.length}`, ''];
+    if (files.length === 0) {
+        lines.push('No memory files found in this directory.');
+    }
+    else {
+        lines.push('### Files by Type');
+        for (const [type, names] of Object.entries(byType))
+            lines.push(`- **${type}** (${names.length}): ${names.join(', ')}`);
+        if (stale.length > 0) {
+            lines.push('', `### Stale Files (${STALE_DAYS}+ days unchanged)`);
+            stale.forEach(f => lines.push(`- ${f}`));
+        }
+        if (dupes.length > 0) {
+            lines.push('', '### Potential Duplicates');
+            dupes.forEach(([a, b]) => lines.push(`- \`${a}\` and \`${b}\``));
+        }
+        if (indexIssues.orphanedEntries.length > 0) {
+            lines.push('', '### Orphaned MEMORY.md Entries');
+            indexIssues.orphanedEntries.forEach(f => lines.push(`- ${f}`));
+        }
+        if (indexIssues.unindexedFiles.length > 0) {
+            lines.push('', '### Unindexed Files (not in MEMORY.md)');
+            indexIssues.unindexedFiles.forEach(f => lines.push(`- ${f}`));
+        }
+    }
+    lines.push('', '### Suggested Actions');
+    suggestions.forEach((s, i) => lines.push(`${i + 1}. ${s}`));
+    return lines.join('\n');
+}
+// ── Tool registration ─────────────────────────────────────────────────────────
+export function registerDreamTools(ctx) {
+    const { server, getRepoRootPath } = ctx;
+    server.tool('merlin_dream', 'Enable, disable, check status, or manually trigger consolidation of Merlin\'s AutoDream memory system. AutoDream keeps Claude Code\'s memory files organized by periodically consolidating them. Use "enable" to turn on automatic consolidation, "status" to inspect memory health, and "consolidate" to get a report with actionable suggestions for merging duplicates, pruning stale entries, and fixing the MEMORY.md index.', {
+        action: z.enum(['enable', 'disable', 'status', 'consolidate']).describe('enable — turn on AutoDream; disable — turn it off; status — check current state and memory stats; consolidate — scan memory and return actionable suggestions'),
+        scope: z.enum(['project', 'global']).optional().describe('"project" (default) uses .claude/projects/<repo>/memory/, "global" uses ~/.claude/memory/'),
+    }, async ({ action, scope = 'project' }) => {
+        try {
+            const { dir: memDir, label } = await resolveMemoryDir(scope, getRepoRootPath);
+            if (action === 'enable') {
+                const settings = readSettings();
+                settings.autoMemoryEnabled = true;
+                writeSettings(settings);
+                const text = [
+                    '## AutoDream Enabled',
+                    '',
+                    'Claude Code will now automatically consolidate memory files over time.',
+                    `**Memory path (${scope}):** \`${memDir}\``,
+                    '',
+                    'Run `merlin_dream` with action "status" to check memory health.',
+                    'Run `merlin_dream` with action "consolidate" to get manual suggestions.',
+                ].join('\n');
+                return { content: [{ type: 'text', text: coachWrap('merlin_dream', text) }] };
+            }
+            if (action === 'disable') {
+                const settings = readSettings();
+                settings.autoMemoryEnabled = false;
+                writeSettings(settings);
+                return { content: [{ type: 'text', text: coachWrap('merlin_dream', '## AutoDream Disabled\n\nAutomatic memory consolidation has been turned off.\nRun `merlin_dream` with action "enable" to re-activate.') }] };
+            }
+            if (action === 'status') {
+                const settings = readSettings();
+                const files = scanMemoryFiles(memDir);
+                const sorted = [...files].sort((a, b) => a.modifiedAt.getTime() - b.modifiedAt.getTime());
+                const lines = [
+                    '## AutoDream Status',
+                    '',
+                    `**Enabled:** ${settings.autoMemoryEnabled === true ? 'Yes' : 'No'}`,
+                    `**Scope:** ${label}`,
+                    `**Memory directory:** \`${memDir}\``,
+                    `**Directory exists:** ${existsSync(memDir) ? 'Yes' : 'No (created on first memory save)'}`,
+                    '',
+                    '### Memory Stats',
+                    `- **Total files:** ${files.length}`,
+                    `- **Stale (${STALE_DAYS}+ days):** ${files.filter(f => f.isStale).length}`,
+                    sorted[0] ? `- **Oldest:** ${sorted[0].name} (${sorted[0].modifiedAt.toLocaleDateString()})` : '',
+                    sorted.at(-1) ? `- **Newest:** ${sorted.at(-1).name} (${sorted.at(-1).modifiedAt.toLocaleDateString()})` : '',
+                ].filter(Boolean);
+                if (settings.autoMemoryEnabled !== true)
+                    lines.push('', 'Run `merlin_dream` with action "enable" to activate AutoDream.');
+                if (files.length > 0)
+                    lines.push('', 'Run `merlin_dream` with action "consolidate" for a full health report.');
+                return { content: [{ type: 'text', text: coachWrap('merlin_dream', lines.join('\n')) }] };
+            }
+            // consolidate
+            const files = scanMemoryFiles(memDir);
+            const indexIssues = checkMemoryIndex(memDir, files);
+            const report = formatConsolidationReport(files, indexIssues, label);
+            return { content: [{ type: 'text', text: coachWrap('merlin_dream', report) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error in merlin_dream: ${error instanceof Error ? error.message : 'Unknown error'}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=dream.js.map

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

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

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

@@ -0,0 +1,3 @@
+import type { ToolContext } from './types.js';
+export declare function registerHelpTools(ctx: ToolContext): void;
+//# sourceMappingURL=help.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/server/tools/help.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAmF9C,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAmDxD"}

package/dist/server/tools/help.js

@@ -0,0 +1,110 @@
+import { z } from 'zod';
+import { coachWrap } from '../session-coach.js';
+function recommendRoute(task) {
+    const lower = task.toLowerCase();
+    if (/\b(resume|continue|pick up|where were we|status|progress|next step)\b/.test(lower)) {
+        return {
+            label: 'Resume and status',
+            why: 'The task is about regaining state, progress, or momentum.',
+            tools: ['merlin_get_project_status', 'merlin_get_brief'],
+            skills: ['merlin-resume', 'merlin-progress'],
+            agents: ['merlin_codebase_mapper'],
+        };
+    }
+    if (/\b(map codebase|understand|explore|onboard|architecture|how does|where is)\b/.test(lower)) {
+        return {
+            label: 'Codebase mapping',
+            why: 'The task needs architectural understanding before edits.',
+            tools: ['merlin_search', 'merlin_get_context', 'merlin_find_files'],
+            skills: ['merlin-map-codebase'],
+            agents: ['merlin_codebase_mapper', 'system_architect'],
+        };
+    }
+    if (/\b(bug|crash|error|failing|fix|debug|broken|exception)\b/.test(lower)) {
+        return {
+            label: 'Debug and repair',
+            why: 'The task is framed as a bug, regression, or failing behavior.',
+            tools: ['merlin_get_context', 'merlin_search', 'merlin_smart_route'],
+            skills: ['merlin-workflow', 'merlin-verify'],
+            agents: ['implementation_dev', 'tests_qa', 'hardening_guard'],
+        };
+    }
+    if (/\b(test|coverage|qa|verify|validation|release confidence)\b/.test(lower)) {
+        return {
+            label: 'Verification',
+            why: 'The task is primarily about validation and confidence.',
+            tools: ['merlin_get_context', 'merlin_find_skill'],
+            skills: ['merlin-verify'],
+            agents: ['tests_qa', 'merlin_verifier'],
+        };
+    }
+    if (/\b(refactor|cleanup|restructure|dedup|dry)\b/.test(lower)) {
+        return {
+            label: 'Refactor safely',
+            why: 'The task should preserve behavior while improving structure.',
+            tools: ['merlin_get_context', 'merlin_smart_route'],
+            skills: ['merlin-workflow', 'merlin-verify'],
+            agents: ['implementation_dev', 'tests_qa', 'system_architect'],
+        };
+    }
+    if (/\b(auth|oauth|stripe|prisma|railway|deploy|integration|sdk|api|graphql)\b/.test(lower)) {
+        return {
+            label: 'Build with recommendations',
+            why: 'The task likely benefits from specialist agents or reference implementations.',
+            tools: ['merlin_recommend_for_task', 'merlin_find_skill', 'merlin_smart_route'],
+            skills: ['merlin-workflow'],
+            agents: ['implementation_dev', 'system_architect', 'merlin_researcher'],
+        };
+    }
+    return {
+        label: 'General implementation',
+        why: 'The task looks like regular product or code work.',
+        tools: ['merlin_get_context', 'merlin_smart_route', 'merlin_find_skill'],
+        skills: ['merlin-workflow', 'merlin-verify'],
+        agents: ['implementation_dev', 'tests_qa'],
+    };
+}
+export function registerHelpTools(ctx) {
+    const { server } = ctx;
+    server.tool('merlin_help', 'Explain what Merlin can do in this repository and recommend the best Merlin workflow for a task. ' +
+        'Use when you want discoverability in Codex, do not know which Merlin tool/skill/agent to use, ' +
+        'or want an explicit route before starting work.', {
+        task: z.string().optional().describe('Optional task description for a tailored route recommendation'),
+    }, async ({ task }) => {
+        let response = '# Merlin Capabilities\n\n';
+        response += '## Boot\n';
+        response += '- `merlin_get_selected_repo` -> identify the active repository\n';
+        response += '- `merlin_get_project_status` -> load project state and active tasks\n';
+        response += '- `merlin_get_rules` and `merlin_get_brief` -> load local operating context\n\n';
+        response += '## Core Merlin Workflows\n';
+        response += '- Understand a repo: `merlin_search`, `merlin_find_files`, `merlin_get_context`, skill `merlin-map-codebase`\n';
+        response += '- Start or plan work: `merlin_smart_route`, `merlin_recommend_for_task`, skill `merlin-workflow`\n';
+        response += '- Find reusable prompts: `merlin_find_skill`\n';
+        response += '- Delegate bounded work: `merlin_route` or Codex custom agents in `.codex/agents`\n';
+        response += '- Verify results: skill `merlin-verify`, agents `tests_qa` or `merlin_verifier`\n';
+        response += '- Resume a repo: skill `merlin-resume`, `merlin_get_project_status`\n\n';
+        response += '## Codex Invocation Examples\n';
+        response += '- "Use Merlin to map this codebase before changing anything."\n';
+        response += '- "Use Merlin to find the best agent, skill, and flow for this task: add OAuth login."\n';
+        response += '- "Use Merlin verify mode on the work you just did."\n';
+        response += '- "Call merlin_help for this task: debug the failing Stripe webhook tests."\n';
+        if (task) {
+            const route = recommendRoute(task);
+            response += `\n## Recommended Route For: ${task}\n`;
+            response += `- Route: ${route.label}\n`;
+            response += `- Why: ${route.why}\n`;
+            response += `- Start with tools: ${route.tools.map((tool) => `\`${tool}\``).join(', ')}\n`;
+            response += `- Relevant skills: ${route.skills.map((skill) => `\`${skill}\``).join(', ')}\n`;
+            response += `- Relevant agents: ${route.agents.map((agent) => `\`${agent}\``).join(', ')}\n`;
+            response += '- Recommended sequence: boot, gather Merlin context, pick the route, execute narrowly, then verify.\n';
+        }
+        else {
+            response += '\n## Tip\n';
+            response += '- Call `merlin_help(task="your task")` to get a task-specific route before you start.\n';
+        }
+        return {
+            content: [{ type: 'text', text: coachWrap('merlin_help', response) }],
+        };
+    });
+}
+//# sourceMappingURL=help.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * HUD Tools
+ * MCP tools for reading and writing live session HUD metrics.
+ *
+ * merlin_hud_status  — read all metrics (agents, tasks, cost, context, rate limit, git)
+ * merlin_hud_update  — write a single metric (called by hooks and agents)
+ *
+ * All state lives in ~/.merlin/state/ as small JSON files.
+ * Missing files are handled gracefully — metrics fall back to null.
+ */
+import type { ToolContext } from './types.js';
+export declare function registerHudTools(ctx: ToolContext): void;
+//# sourceMappingURL=hud.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hud.d.ts","sourceRoot":"","sources":["../../../src/server/tools/hud.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA0K9C,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAgKvD"}