create-merlin-brain 3.21.0 → 3.23.0

package/dist/server/tools/team-workers.js

@@ -0,0 +1,271 @@
+/**
+ * Team Workers Tools — Spawn parallel AI CLI workers in tmux panes.
+ * Job state persisted to ~/.merlin/state/team/ for status/cleanup queries.
+ */
+import { z } from 'zod';
+import { execFile } from 'child_process';
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, unlinkSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import { promisify } from 'util';
+const execFileAsync = promisify(execFile);
+const TEAM_STATE_DIR = join(homedir(), '.merlin', 'state', 'team');
+// ── Internal helpers ──────────────────────────────────────────────────────
+async function isTmuxAvailable() {
+    try {
+        await execFileAsync('which', ['tmux']);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function generateJobId() {
+    return `merlin-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+}
+async function ensureTmuxSession(session) {
+    try {
+        await execFileAsync('tmux', ['has-session', '-t', session]);
+        return true;
+    }
+    catch {
+        try {
+            await execFileAsync('tmux', ['new-session', '-d', '-s', session]);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+/** Split a new pane in the session, send command, return pane ID. */
+async function createTmuxPane(session, command) {
+    await execFileAsync('tmux', ['split-window', '-d', '-t', session]);
+    const { stdout } = await execFileAsync('tmux', [
+        'list-panes', '-t', session, '-F', '#{session_name}:#{window_index}.#{pane_index}',
+    ]);
+    const panes = stdout.trim().split('\n').filter(Boolean);
+    if (panes.length === 0)
+        throw new Error('No panes found after split-window');
+    const paneId = panes[panes.length - 1];
+    await execFileAsync('tmux', ['send-keys', '-t', paneId, command, 'Enter']);
+    return paneId;
+}
+async function capturePaneOutput(paneId, lines = 50) {
+    try {
+        const { stdout } = await execFileAsync('tmux', [
+            'capture-pane', '-t', paneId, '-p', '-J', '-S', String(-lines),
+        ]);
+        return stdout;
+    }
+    catch {
+        return '(pane output unavailable)';
+    }
+}
+async function isPaneAlive(paneId) {
+    try {
+        await execFileAsync('tmux', ['list-panes', '-t', paneId]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Build provider CLI command. Escapes task string for send-keys shell boundary. */
+function buildProviderCommand(provider, task, agent) {
+    const t = task.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+    switch (provider) {
+        case 'claude': return `claude ${agent ? `--agent ${agent} ` : ''}-p "${t}" --output-format text`;
+        case 'codex': return `codex exec "${t}"`;
+        case 'gemini': return `gemini -p "${t}"`;
+    }
+}
+// ── State helpers ─────────────────────────────────────────────────────────
+function ensureStateDir() {
+    if (!existsSync(TEAM_STATE_DIR))
+        mkdirSync(TEAM_STATE_DIR, { recursive: true });
+}
+function stateFilePath(teamName) {
+    return join(TEAM_STATE_DIR, `${teamName}.json`);
+}
+function saveJobState(state) {
+    ensureStateDir();
+    writeFileSync(stateFilePath(state.teamName), JSON.stringify(state, null, 2), 'utf-8');
+}
+function loadJobState(teamName) {
+    try {
+        const p = stateFilePath(teamName);
+        if (!existsSync(p))
+            return null;
+        return JSON.parse(readFileSync(p, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function listAllJobs() {
+    try {
+        ensureStateDir();
+        return readdirSync(TEAM_STATE_DIR)
+            .filter(f => f.endsWith('.json'))
+            .flatMap(f => {
+            try {
+                return [JSON.parse(readFileSync(join(TEAM_STATE_DIR, f), 'utf-8'))];
+            }
+            catch {
+                return [];
+            }
+        });
+    }
+    catch {
+        return [];
+    }
+}
+function resolveJobs(teamName, jobId) {
+    if (teamName) {
+        const j = loadJobState(teamName);
+        return j ? [j] : [];
+    }
+    if (jobId) {
+        const j = listAllJobs().find(x => x.jobId === jobId);
+        return j ? [j] : [];
+    }
+    return listAllJobs();
+}
+// ── Tool registration ─────────────────────────────────────────────────────
+export function registerTeamWorkerTools(ctx) {
+    const { server } = ctx;
+    server.tool('merlin_spawn_workers', 'Spawn parallel AI CLI workers in tmux panes for burst execution. Each worker gets its own ' +
+        'tmux pane running a claude/codex/gemini CLI instance. Use for maximum parallelism on ' +
+        'independent tasks. Persists job state for status queries and cleanup. ' +
+        'Requires tmux. Returns jobId and per-worker pane assignments.', {
+        workers: z.array(z.object({
+            provider: z.enum(['claude', 'codex', 'gemini']).default('claude'),
+            task: z.string().describe('Task or prompt for this worker'),
+            agent: z.string().optional().describe('For claude: agent name (e.g. implementation-dev)'),
+        })).min(1).describe('Workers to spawn'),
+        teamName: z.string().optional().default('merlin-team').describe('Logical team name for state tracking'),
+        sessionName: z.string().optional().describe('tmux session name — defaults to teamName'),
+    }, async ({ workers, teamName, sessionName }) => {
+        const resolvedTeam = teamName ?? 'merlin-team';
+        const tmuxSession = sessionName ?? resolvedTeam;
+        if (!(await isTmuxAvailable())) {
+            return {
+                content: [{ type: 'text',
+                        text: 'tmux not found. Install: macOS `brew install tmux` / Linux `apt install tmux`' }],
+                isError: true,
+            };
+        }
+        if (!(await ensureTmuxSession(tmuxSession))) {
+            return {
+                content: [{ type: 'text', text: `Failed to create tmux session "${tmuxSession}".` }],
+                isError: true,
+            };
+        }
+        const jobId = generateJobId();
+        const workerStates = [];
+        const errors = [];
+        for (const w of workers) {
+            try {
+                const paneId = await createTmuxPane(tmuxSession, buildProviderCommand(w.provider, w.task, w.agent));
+                workerStates.push({ paneId, provider: w.provider, task: w.task, agent: w.agent, status: 'running' });
+            }
+            catch (err) {
+                errors.push(`${w.provider} / ${w.task.slice(0, 40)}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        saveJobState({ jobId, teamName: resolvedTeam, tmuxSession, workers: workerStates, startedAt: new Date().toISOString() });
+        const lines = [
+            `Team spawned — jobId: ${jobId}`,
+            `tmux session: ${tmuxSession}`,
+            `workers started: ${workerStates.length} / ${workers.length}`,
+            '',
+            'Workers:',
+            ...workerStates.map((w, i) => `  [${i + 1}] pane=${w.paneId}  provider=${w.provider}${w.agent ? `  agent=${w.agent}` : ''}  task="${w.task.slice(0, 60)}"`),
+            ...(errors.length ? ['', 'Errors:', ...errors.map(e => `  ! ${e}`)] : []),
+            '',
+            `Status: merlin_team_status(teamName="${resolvedTeam}")`,
+            `Attach:  tmux attach-session -t ${tmuxSession}`,
+            `Cleanup: merlin_team_cleanup(teamName="${resolvedTeam}")`,
+        ];
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+    });
+    server.tool('merlin_team_status', 'Check status of running tmux team workers. Shows pane liveness and captures recent terminal ' +
+        'output per worker. Provide teamName or jobId to target a specific job; omit both for all jobs.', {
+        teamName: z.string().optional().describe('Team name used at spawn time'),
+        jobId: z.string().optional().describe('Specific job ID'),
+    }, async ({ teamName, jobId }) => {
+        const jobs = resolveJobs(teamName, jobId);
+        if (jobs.length === 0) {
+            return { content: [{ type: 'text', text: 'No team jobs found. Use merlin_spawn_workers first.' }] };
+        }
+        const sections = [];
+        for (const job of jobs) {
+            sections.push(`Job: ${job.jobId}  team: ${job.teamName}  session: ${job.tmuxSession}`);
+            sections.push(`Started: ${job.startedAt}`, '');
+            for (const [i, worker] of job.workers.entries()) {
+                const alive = await isPaneAlive(worker.paneId);
+                sections.push(`Worker ${i + 1}: pane=${worker.paneId}  status=${alive ? 'running' : 'completed/dead'}`);
+                sections.push(`  provider=${worker.provider}${worker.agent ? `  agent=${worker.agent}` : ''}`);
+                sections.push(`  task="${worker.task.slice(0, 80)}"`);
+                const out = (await capturePaneOutput(worker.paneId, 50)).trim();
+                if (out) {
+                    sections.push('  --- recent output ---');
+                    out.split('\n').slice(-20).forEach(l => sections.push(`  ${l}`));
+                    sections.push('  ---');
+                }
+                sections.push('');
+            }
+        }
+        return { content: [{ type: 'text', text: sections.join('\n') }] };
+    });
+    server.tool('merlin_team_cleanup', 'Clean up tmux team workers — kills panes and removes persisted job state. ' +
+        'Optionally kills the entire tmux session. Omit teamName/jobId to clean up all jobs.', {
+        teamName: z.string().optional().describe('Team name used at spawn time'),
+        jobId: z.string().optional().describe('Specific job ID'),
+        killSession: z.boolean().optional().default(false).describe('Kill the entire tmux session instead of individual panes'),
+    }, async ({ teamName, jobId, killSession }) => {
+        const jobs = resolveJobs(teamName, jobId);
+        if (jobs.length === 0) {
+            return { content: [{ type: 'text', text: 'No team jobs found. Nothing to clean up.' }] };
+        }
+        const report = [];
+        for (const job of jobs) {
+            report.push(`Cleaning job: ${job.jobId}  team: ${job.teamName}`);
+            if (killSession) {
+                try {
+                    await execFileAsync('tmux', ['kill-session', '-t', job.tmuxSession]);
+                    report.push(`  session "${job.tmuxSession}" killed`);
+                }
+                catch {
+                    report.push(`  session "${job.tmuxSession}" already gone`);
+                }
+            }
+            else {
+                for (const w of job.workers) {
+                    try {
+                        await execFileAsync('tmux', ['kill-pane', '-t', w.paneId]);
+                        report.push(`  pane ${w.paneId} killed`);
+                    }
+                    catch {
+                        report.push(`  pane ${w.paneId} already gone`);
+                    }
+                }
+            }
+            try {
+                const p = stateFilePath(job.teamName);
+                if (existsSync(p)) {
+                    unlinkSync(p);
+                    report.push('  state file removed');
+                }
+            }
+            catch {
+                report.push('  warning: could not remove state file');
+            }
+            report.push('');
+        }
+        report.push('Cleanup complete.');
+        return { content: [{ type: 'text', text: report.join('\n') }] };
+    });
+}
+//# sourceMappingURL=team-workers.js.map

package/dist/server/tools/team-workers.js.map

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

package/dist/server/utils/merlin-manifest.d.ts

@@ -7,7 +7,7 @@
  *
  * Discovery chain:
  *   1. .merlin.json (local file, 0 tokens, any agent)
- *   2. CLAUDE.md comment (agent-specific, already loaded)
+ *   2. Instruction file comment (CLAUDE.md / AGENTS.md / GEMINI.md)
  *   3. git remote → API lookup (network call, MCP required)
  */
 /** Filename for the manifest */
@@ -26,6 +26,8 @@ export declare const MERLIN_MCP_SERVER = "merlin-mcp-server";
 export declare const MERLIN_DEFAULT_CAPABILITIES: readonly ["context", "search", "conventions", "files", "ask"];
 /** CLAUDE.md comment marker for Sight URL injection */
 export declare const CLAUDEMD_SIGHT_MARKER = "MERLIN_SIGHT";
+export declare const AGENTSMD_SIGHT_MARKER = "MERLIN_SIGHT";
+export declare const GEMINIMD_SIGHT_MARKER = "MERLIN_SIGHT";
 /** MCP configuration for the manifest */
 export interface MerlinManifestMcp {
     /** npm install command (e.g., "npx create-merlin-brain") */
@@ -95,4 +97,7 @@ export declare function buildManifest(sightId: string, repoUrl: string): MerlinM
  * @returns true if injected, false if already present or no CLAUDE.md
  */
 export declare function injectSightIntoClaudeMd(repoRoot: string, sightUrl: string): boolean;
+export declare function injectSightIntoAgentsMd(repoRoot: string, sightUrl: string): boolean;
+export declare function injectSightIntoGeminiMd(repoRoot: string, sightUrl: string): boolean;
+export declare function injectSightIntoInstructionFiles(repoRoot: string, sightUrl: string): boolean;
 //# sourceMappingURL=merlin-manifest.d.ts.map

package/dist/server/utils/merlin-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merlin-manifest.d.ts","sourceRoot":"","sources":["../../../src/server/utils/merlin-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,gCAAgC;AAChC,eAAO,MAAM,wBAAwB,iBAAiB,CAAC;AAEvD,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,gDAAgD,CAAC;AAE/E,0BAA0B;AAC1B,eAAO,MAAM,kBAAkB,gCAAgC,CAAC;AAEhE,qEAAqE;AACrE,eAAO,MAAM,eAAe,2CAA2C,CAAC;AAExE,0BAA0B;AAC1B,eAAO,MAAM,kBAAkB,4BAA4B,CAAC;AAE5D,sBAAsB;AACtB,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD,gCAAgC;AAChC,eAAO,MAAM,2BAA2B,+DAM9B,CAAC;AAEX,uDAAuD;AACvD,eAAO,MAAM,qBAAqB,iBAAiB,CAAC;AAEpD,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,GAAG,EAAE,iBAAiB,CAAC;IACvB,kGAAkG;IAClG,GAAG,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ9D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAqC1E;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAKpF;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAkB9E;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAyBnF"}
+{"version":3,"file":"merlin-manifest.d.ts","sourceRoot":"","sources":["../../../src/server/utils/merlin-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,gCAAgC;AAChC,eAAO,MAAM,wBAAwB,iBAAiB,CAAC;AAEvD,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,gDAAgD,CAAC;AAE/E,0BAA0B;AAC1B,eAAO,MAAM,kBAAkB,gCAAgC,CAAC;AAEhE,qEAAqE;AACrE,eAAO,MAAM,eAAe,2CAA2C,CAAC;AAExE,0BAA0B;AAC1B,eAAO,MAAM,kBAAkB,4BAA4B,CAAC;AAE5D,sBAAsB;AACtB,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD,gCAAgC;AAChC,eAAO,MAAM,2BAA2B,+DAM9B,CAAC;AAEX,uDAAuD;AACvD,eAAO,MAAM,qBAAqB,iBAAiB,CAAC;AACpD,eAAO,MAAM,qBAAqB,iBAAiB,CAAC;AACpD,eAAO,MAAM,qBAAqB,iBAAiB,CAAC;AAEpD,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,GAAG,EAAE,iBAAiB,CAAC;IACvB,kGAAkG;IAClG,GAAG,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ9D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAqC1E;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAKpF;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAkB9E;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAyBnF;AAqBD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEnF;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEnF;AAED,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAQ3F"}

package/dist/server/utils/merlin-manifest.js

@@ -7,7 +7,7 @@
  *
  * Discovery chain:
  *   1. .merlin.json (local file, 0 tokens, any agent)
- *   2. CLAUDE.md comment (agent-specific, already loaded)
+ *   2. Instruction file comment (CLAUDE.md / AGENTS.md / GEMINI.md)
  *   3. git remote → API lookup (network call, MCP required)
  */
 import { existsSync, readFileSync, writeFileSync } from 'fs';
@@ -34,6 +34,8 @@ export const MERLIN_DEFAULT_CAPABILITIES = [
 ];
 /** CLAUDE.md comment marker for Sight URL injection */
 export const CLAUDEMD_SIGHT_MARKER = 'MERLIN_SIGHT';
+export const AGENTSMD_SIGHT_MARKER = 'MERLIN_SIGHT';
+export const GEMINIMD_SIGHT_MARKER = 'MERLIN_SIGHT';
 /**
  * Extract the UUID sight ID from a Merlin Sights URL.
  *
@@ -161,4 +163,35 @@ export function injectSightIntoClaudeMd(repoRoot, sightUrl) {
         return false;
     }
 }
+function injectSightMarker(filePath, markerPrefix, sightUrl) {
+    if (!existsSync(filePath)) {
+        return false;
+    }
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        if (content.includes(markerPrefix)) {
+            return false;
+        }
+        writeFileSync(filePath, `${markerPrefix}: ${sightUrl}\n${content}`, 'utf-8');
+        console.error(`[merlin-manifest] Injected Sight URL into ${filePath}`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function injectSightIntoAgentsMd(repoRoot, sightUrl) {
+    return injectSightMarker(join(repoRoot, 'AGENTS.md'), '# MERLIN_SIGHT', sightUrl);
+}
+export function injectSightIntoGeminiMd(repoRoot, sightUrl) {
+    return injectSightMarker(join(repoRoot, 'GEMINI.md'), '# MERLIN_SIGHT', sightUrl);
+}
+export function injectSightIntoInstructionFiles(repoRoot, sightUrl) {
+    const results = [
+        injectSightIntoClaudeMd(repoRoot, sightUrl),
+        injectSightIntoAgentsMd(repoRoot, sightUrl),
+        injectSightIntoGeminiMd(repoRoot, sightUrl),
+    ];
+    return results.some(Boolean);
+}
 //# sourceMappingURL=merlin-manifest.js.map

package/dist/server/utils/merlin-manifest.js.map

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

package/files/CLAUDE.md

@@ -65,3 +65,25 @@ When user corrects you → `merlin_save_behavior`. When user says "always/never/
 - Never kill user processes (Xcode, VS Code, browsers) without explicit confirmation.
 - Never claim "done" without actually building/compiling/testing.
 - Badge on EVERY action — if the user can't see `⟡🔮 MERLIN ›`, you're not doing your job.
+
+## New Capabilities (March 2026)
+
+### Auto Mode — `merlin loop yolo`
+Enable autonomous tool approval. Call `merlin_auto_mode(action: "enable", level: "yolo")` for full autonomy or `level: "safe"` for read-only mode. Disable with `merlin_auto_mode(action: "disable")`.
+- "loop yolo" / "auto mode" / "go autonomous" → `merlin_auto_mode(action: "enable", level: "yolo")`
+
+### AutoDream — Memory Consolidation
+Keep memory files clean and organized. Call `merlin_dream(action: "enable")` to turn on auto-dream, or `action: "consolidate"` to manually review and clean up memory.
+- "dream" / "consolidate memory" / "clean up memory" → `merlin_dream(action: "consolidate")`
+
+### Computer Use — Desktop Control
+Take over and control desktop apps. Call `merlin_computer_use(action: "launch", app: "AppName")` to open an app, or `merlin_screenshot()` to capture the screen.
+- "take over [app]" / "open [app]" / "control [app]" → `merlin_computer_use(action: "launch", app: "[app]")`
+- "screenshot" / "what's on screen" → `merlin_screenshot()`
+
+### Self-Evolving Skills — The Brain Gets Smarter
+Skills are prompt injections that enhance your capabilities. They live at `~/.claude/merlin/skills/`.
+- **Before any task**: Call `merlin_find_skill("what you need")` to discover relevant skills. Load 1-3 by reading their .md files.
+- **After any task**: Call `merlin_track_skill(skillId, success)` to record whether the skill helped.
+- **When a skill is wrong or missing**: Call `merlin_evolve_skill(...)` to improve it or create a new one. The improvement syncs to all users.
+- Skills auto-improve over time. High success rate skills get recommended more. Failed skills get flagged for evolution.

package/files/hooks/post-edit-logger.sh

@@ -52,6 +52,52 @@ if [ -f "$PORT_FILE" ] && command -v jq >/dev/null 2>&1; then
   fi
 fi
 
-# Claude Code command hooks must output valid JSON to stdout
-echo '{}'
+# ─────────────────────────────────────────────────────────────────────────────
+# SECRET DETECTION (PostToolUse — advisory only, edit already happened)
+# Scans the written file for common credential patterns and warns via
+# additionalContext. Never blocks — always exits 0.
+# ─────────────────────────────────────────────────────────────────────────────
+SECRET_WARNING=""
+if [ -n "$file_path" ] && [ -f "$file_path" ]; then
+  # Read file content once into a variable (cap at first 500 lines for speed)
+  file_content=$(head -500 "$file_path" 2>/dev/null || true)
+
+  if [ -n "$file_content" ]; then
+    found_secrets=""
+
+    # AWS access key (AKIA...)
+    if echo "$file_content" | grep -qE 'AKIA[0-9A-Z]{16}' 2>/dev/null; then
+      found_secrets="${found_secrets}AWS-KEY "
+    fi
+
+    # OpenAI / Anthropic / generic sk- API keys (sk- followed by 20+ alphanum chars)
+    if echo "$file_content" | grep -qE 'sk-[A-Za-z0-9]{20,}' 2>/dev/null; then
+      found_secrets="${found_secrets}API-KEY(sk-) "
+    fi
+
+    # PEM private keys
+    if echo "$file_content" | grep -qF 'BEGIN PRIVATE KEY' 2>/dev/null || \
+       echo "$file_content" | grep -qF 'BEGIN RSA PRIVATE KEY' 2>/dev/null; then
+      found_secrets="${found_secrets}PRIVATE-KEY "
+    fi
+
+    # Hardcoded password assignments (password = "..." or password: "...")
+    if echo "$file_content" | grep -qiE '(password|passwd|pwd)\s*[:=]\s*["'"'"'][^'"'"'"]{6,}["'"'"']' 2>/dev/null; then
+      found_secrets="${found_secrets}HARDCODED-PASSWORD "
+    fi
+
+    if [ -n "$found_secrets" ]; then
+      SECRET_WARNING="WARNING: Possible secrets detected in ${file_path}: ${found_secrets}— review before committing."
+    fi
+  fi
+fi
+
+# Output with optional secret warning as additionalContext
+if [ -n "$SECRET_WARNING" ] && command -v jq >/dev/null 2>&1; then
+  jq -n --arg warn "$SECRET_WARNING" '{
+    additionalContext: $warn
+  }'
+else
+  echo '{}'
+fi
 exit 0

package/files/hooks/pre-compact.sh

@@ -47,17 +47,29 @@ if [ -f "$PORT_FILE" ] && command -v jq >/dev/null 2>&1; then
   fi
 fi
 
+# Detect current project name (fast, no network)
+PROJECT_NAME=""
+# Try git remote name first (works in most Merlin project dirs)
+if command -v git >/dev/null 2>&1; then
+  PROJECT_NAME=$(git remote get-url origin 2>/dev/null | sed 's|.*/||; s|\.git$||' || true)
+fi
+# Fall back to current directory basename
+if [ -z "$PROJECT_NAME" ]; then
+  PROJECT_NAME=$(basename "$PWD" 2>/dev/null || echo "unknown")
+fi
+
 # Build the protocol reminder that survives compaction
 SESSION_INFO=""
 if [ -n "$GUARDIAN_STATE" ] && command -v jq >/dev/null 2>&1; then
   HEALTH=$(echo "$GUARDIAN_STATE" | jq -r '.health // "?"' 2>/dev/null || echo "?")
   DRIFT=$(echo "$GUARDIAN_STATE" | jq -r '.driftLevel // "?"' 2>/dev/null || echo "?")
   EDITS=$(echo "$GUARDIAN_STATE" | jq -r '.editsSinceContext // "?"' 2>/dev/null || echo "?")
-  SESSION_INFO=" Session health: ${HEALTH}%, drift level: ${DRIFT}, edits since context: ${EDITS}."
+  SESSION_INFO=" Health:${HEALTH}% drift:${DRIFT} edits:${EDITS}."
 fi
 
 # The protocol rules that MUST survive compaction
-CONTEXT="MERLIN PROTOCOL REMINDER (post-compaction): You are Merlin, an orchestrator. You NEVER write code — you route to agents. MANDATORY RULES: (1) YOU answer codebase questions using merlin_get_context/merlin_search — never Explore agents. (2) YOU route implementation to agents via Skill(merlin:workflow) or merlin_route(). (3) Call merlin_get_context BEFORE any file edit or codebase question. (4) Prefix EVERY action with the badge. (5) After every agent completes: show result, run verification, surface one skill, detect next intent. (6) Run agents in PARALLEL. (7) ROUTING: Bug=bug-fix workflow, Feature=feature-dev workflow, Refactor=refactor workflow, Small task=merlin_smart_route then merlin_route. (8) Save behaviors when user corrects you.${SESSION_INFO}"
+# Keep under 500 chars so injection stays lean
+CONTEXT="MERLIN POST-COMPACTION: Project=${PROJECT_NAME}. Mode=AI Automation. You are an ORCHESTRATOR — NEVER write code. RULES: (1) Route ALL code work to agents via Skill(merlin:workflow) or merlin_route(). (2) 1 MESSAGE = ALL OPERATIONS — run independent agents in PARALLEL, never sequential. (3) Call merlin_get_context BEFORE edits. (4) Badge EVERY action. (5) ROUTING: Bug=bug-fix, Feature=feature-dev, Refactor=refactor, Small=merlin_smart_route. (6) Save corrections via merlin_save_behavior.${SESSION_INFO}"
 
 if command -v jq >/dev/null 2>&1; then
   jq -n --arg ctx "$CONTEXT" '{

package/files/hooks/rate-limit-watch.sh

@@ -0,0 +1,120 @@
+#!/usr/bin/env bash
+#
+# Merlin Hook: PostToolUse — Rate-Limit Watcher
+# Detects rate-limit signals in tool output and writes state to ~/.merlin/state/rate-limit.json.
+# Sends a desktop notification on first detection (fire-and-forget).
+#
+# Always exits 0 — advisory only, never blocks.
+#
+set -euo pipefail
+trap 'echo "{}"; exit 0' ERR
+
+STATE_DIR="${HOME}/.merlin/state"
+STATE_FILE="${STATE_DIR}/rate-limit.json"
+
+# ── Ensure state directory exists ────────────────────────────────────────────
+mkdir -p "${STATE_DIR}"
+
+# ── Read stdin event ──────────────────────────────────────────────────────────
+input=$(cat)
+
+# ── Extract tool_result (jq with grep/sed fallback) ──────────────────────────
+if command -v jq >/dev/null 2>&1; then
+  tool_result=$(echo "${input}" | jq -r '.tool_result // ""')
+else
+  tool_result=$(echo "${input}" | grep -o '"tool_result":"[^"]*"' | cut -d'"' -f4 || true)
+fi
+
+# Lowercase for case-insensitive matching
+tool_result_lower=$(echo "${tool_result}" | tr '[:upper:]' '[:lower:]')
+
+# ── Rate-limit pattern matching ───────────────────────────────────────────────
+is_rate_limited=false
+trigger_label=""
+
+if echo "${tool_result_lower}" | grep -qE 'rate.?limit|429|too many requests|quota exceeded|overloaded'; then
+  is_rate_limited=true
+
+  if echo "${tool_result_lower}" | grep -q '429'; then
+    trigger_label="429 response"
+  elif echo "${tool_result_lower}" | grep -q 'quota exceeded'; then
+    trigger_label="quota exceeded"
+  elif echo "${tool_result_lower}" | grep -q 'overloaded'; then
+    trigger_label="overloaded"
+  elif echo "${tool_result_lower}" | grep -q 'too many requests'; then
+    trigger_label="too many requests"
+  else
+    trigger_label="rate limit"
+  fi
+fi
+
+NOW=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+# ── Compute estimated reset time (5 min from now) ────────────────────────────
+# macOS date -v; Linux date -d fallback
+if date -v+5M >/dev/null 2>&1; then
+  RESET_AT=$(date -u -v+5M +"%Y-%m-%dT%H:%M:%SZ")
+else
+  RESET_AT=$(date -u -d "+5 minutes" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || echo "${NOW}")
+fi
+
+# ── If rate-limited: write blocked state ─────────────────────────────────────
+if [ "${is_rate_limited}" = "true" ]; then
+  # Only notify on new detection (when previous state wasn't already blocked)
+  prev_status=""
+  if [ -f "${STATE_FILE}" ]; then
+    if command -v jq >/dev/null 2>&1; then
+      prev_status=$(jq -r '.status // ""' "${STATE_FILE}" 2>/dev/null || true)
+    else
+      prev_status=$(grep -o '"status":"[^"]*"' "${STATE_FILE}" | cut -d'"' -f4 || true)
+    fi
+  fi
+
+  cat > "${STATE_FILE}" <<EOF
+{
+  "status": "blocked",
+  "detectedAt": "${NOW}",
+  "trigger": "${trigger_label}",
+  "estimatedResetAt": "${RESET_AT}"
+}
+EOF
+
+  # Desktop notification only on transition to blocked (macOS)
+  if [ "${prev_status}" != "blocked" ] && command -v osascript >/dev/null 2>&1; then
+    osascript -e 'display notification "Rate limit detected — will auto-resume" with title "⟡🔮 Merlin"' &
+  fi
+
+  echo "{}"
+  exit 0
+fi
+
+# ── If not rate-limited: check if we should clear a previous blocked state ───
+if [ -f "${STATE_FILE}" ]; then
+  if command -v jq >/dev/null 2>&1; then
+    prev_status=$(jq -r '.status // ""' "${STATE_FILE}" 2>/dev/null || true)
+    detected_at=$(jq -r '.detectedAt // ""' "${STATE_FILE}" 2>/dev/null || true)
+  else
+    prev_status=$(grep -o '"status":"[^"]*"' "${STATE_FILE}" | cut -d'"' -f4 || true)
+    detected_at=$(grep -o '"detectedAt":"[^"]*"' "${STATE_FILE}" | cut -d'"' -f4 || true)
+  fi
+
+  if [ "${prev_status}" = "blocked" ] && [ -n "${detected_at}" ]; then
+    # Calculate elapsed seconds using python3 (available on macOS/Linux)
+    elapsed=$(python3 -c "
+import datetime
+try:
+  d = datetime.datetime.fromisoformat('${detected_at}'.replace('Z','+00:00'))
+  print(int((datetime.datetime.now(datetime.timezone.utc) - d).total_seconds()))
+except Exception:
+  print(0)
+" 2>/dev/null || echo "0")
+
+    # Clear blocked state only after 2+ minutes have elapsed
+    if [ "${elapsed}" -ge 120 ] 2>/dev/null; then
+      printf '{\n  "status": "ok",\n  "clearedAt": "%s"\n}\n' "${NOW}" > "${STATE_FILE}"
+    fi
+  fi
+fi
+
+echo "{}"
+exit 0