create-merlin-brain 3.22.0 → 3.23.0

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/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

package/files/hooks/statusline.sh

@@ -0,0 +1,148 @@
+#!/usr/bin/env bash
+#
+# Merlin Hook: Notification — HUD Statusline
+#
+# Outputs a single-line statusline for Claude Code's status bar with live
+# Merlin session metrics. Reads only local state files — no network calls.
+#
+# Output JSON:
+#   {"hookSpecificOutput":{"hookEventName":"Notification","statusLine":"..."}}
+#
+# Metrics included:
+#   - Merlin version  (from ~/.claude/merlin/VERSION)
+#   - Active agents   (from ~/.merlin/state/agents.json)
+#   - Task progress   (from ~/.merlin/state/tasks.json)
+#   - Session cost    (from ~/.merlin/state/session-cost.json)
+#   - Git branch      (git rev-parse, fast)
+#   - Context age     (from ~/.merlin/state/last-context.json)
+#   - Rate limit      (from ~/.merlin/state/rate-limit.json)
+#
+# Always exits 0 — purely advisory.
+#
+set -euo pipefail
+trap 'echo "{}"; exit 0' ERR
+
+STATE_DIR="${HOME}/.merlin/state"
+MERLIN_DIR="${HOME}/.claude/merlin"
+
+# ── Version ────────────────────────────────────────────────────────────────
+VERSION_FILE="${MERLIN_DIR}/VERSION"
+if [ -f "${VERSION_FILE}" ]; then
+  MERLIN_VERSION=$(cat "${VERSION_FILE}" 2>/dev/null | tr -d '[:space:]' || echo "--")
+else
+  MERLIN_VERSION="--"
+fi
+
+# ── Active agents ──────────────────────────────────────────────────────────
+AGENTS_FILE="${STATE_DIR}/agents.json"
+if [ -f "${AGENTS_FILE}" ]; then
+  if command -v jq >/dev/null 2>&1; then
+    AGENT_COUNT=$(jq '.active // 0' "${AGENTS_FILE}" 2>/dev/null || echo "0")
+  else
+    AGENT_COUNT=$(grep -o '"active":[0-9]*' "${AGENTS_FILE}" 2>/dev/null | grep -o '[0-9]*$' || echo "0")
+  fi
+else
+  AGENT_COUNT="0"
+fi
+
+# ── Task progress ──────────────────────────────────────────────────────────
+TASKS_FILE="${STATE_DIR}/tasks.json"
+if [ -f "${TASKS_FILE}" ]; then
+  if command -v jq >/dev/null 2>&1; then
+    TASKS_DONE=$(jq '.done // 0' "${TASKS_FILE}" 2>/dev/null || echo "0")
+    TASKS_TOTAL=$(jq '.total // 0' "${TASKS_FILE}" 2>/dev/null || echo "0")
+  else
+    TASKS_DONE=$(grep -o '"done":[0-9]*' "${TASKS_FILE}" 2>/dev/null | grep -o '[0-9]*$' || echo "0")
+    TASKS_TOTAL=$(grep -o '"total":[0-9]*' "${TASKS_FILE}" 2>/dev/null | grep -o '[0-9]*$' || echo "0")
+  fi
+  if [ "${TASKS_TOTAL}" -gt 0 ] 2>/dev/null; then
+    TASKS_DISPLAY="${TASKS_DONE}/${TASKS_TOTAL} tasks"
+  else
+    TASKS_DISPLAY="--"
+  fi
+else
+  TASKS_DISPLAY="--"
+fi
+
+# ── Session cost ───────────────────────────────────────────────────────────
+COST_FILE="${STATE_DIR}/session-cost.json"
+if [ -f "${COST_FILE}" ]; then
+  if command -v jq >/dev/null 2>&1; then
+    COST_RAW=$(jq -r '.total // ""' "${COST_FILE}" 2>/dev/null || echo "")
+  else
+    COST_RAW=$(grep -o '"total":"[^"]*"' "${COST_FILE}" 2>/dev/null | cut -d'"' -f4 || echo "")
+    # Also try numeric total
+    if [ -z "${COST_RAW}" ]; then
+      COST_RAW=$(grep -o '"total":[0-9.]*' "${COST_FILE}" 2>/dev/null | grep -o '[0-9.]*$' || echo "")
+    fi
+  fi
+  if [ -n "${COST_RAW}" ] && [ "${COST_RAW}" != "null" ]; then
+    COST_DISPLAY="\$${COST_RAW}"
+  else
+    COST_DISPLAY="--"
+  fi
+else
+  COST_DISPLAY="--"
+fi
+
+# ── Git branch ─────────────────────────────────────────────────────────────
+GIT_BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "--")
+
+# ── Context freshness ──────────────────────────────────────────────────────
+CTX_FILE="${STATE_DIR}/last-context.json"
+if [ -f "${CTX_FILE}" ]; then
+  if command -v jq >/dev/null 2>&1; then
+    LAST_TS=$(jq -r '.timestamp // ""' "${CTX_FILE}" 2>/dev/null || echo "")
+  else
+    LAST_TS=$(grep -o '"timestamp":[0-9]*' "${CTX_FILE}" 2>/dev/null | grep -o '[0-9]*$' || echo "")
+  fi
+  if [ -n "${LAST_TS}" ] && [ "${LAST_TS}" != "null" ] && [ "${LAST_TS}" != "" ]; then
+    NOW=$(date +%s)
+    ELAPSED=$(( NOW - LAST_TS ))
+    if [ "${ELAPSED}" -lt 60 ]; then
+      CTX_DISPLAY="${ELAPSED}s"
+    elif [ "${ELAPSED}" -lt 3600 ]; then
+      CTX_DISPLAY="$(( ELAPSED / 60 ))m"
+    else
+      CTX_DISPLAY="$(( ELAPSED / 3600 ))h"
+    fi
+  else
+    CTX_DISPLAY="--"
+  fi
+else
+  CTX_DISPLAY="--"
+fi
+
+# ── Rate limit status ──────────────────────────────────────────────────────
+RATE_FILE="${STATE_DIR}/rate-limit.json"
+if [ -f "${RATE_FILE}" ]; then
+  if command -v jq >/dev/null 2>&1; then
+    RATE_STATUS=$(jq -r '.status // "OK"' "${RATE_FILE}" 2>/dev/null || echo "OK")
+  else
+    RATE_STATUS=$(grep -o '"status":"[^"]*"' "${RATE_FILE}" 2>/dev/null | cut -d'"' -f4 || echo "OK")
+  fi
+  # Normalize to OK / WARN / BLOCKED
+  case "${RATE_STATUS}" in
+    OK|ok)       RATE_DISPLAY="OK" ;;
+    WARN|warn)   RATE_DISPLAY="WARN" ;;
+    BLOCKED|blocked) RATE_DISPLAY="BLOCKED" ;;
+    *)           RATE_DISPLAY="OK" ;;
+  esac
+else
+  RATE_DISPLAY="OK"
+fi
+
+# ── Compose statusline ─────────────────────────────────────────────────────
+STATUSLINE="v${MERLIN_VERSION} | ${AGENT_COUNT} agents | ${TASKS_DISPLAY} | ${COST_DISPLAY} | ${GIT_BRANCH} | ctx:${CTX_DISPLAY} | rate:${RATE_DISPLAY}"
+
+# ── Output ─────────────────────────────────────────────────────────────────
+if command -v jq >/dev/null 2>&1; then
+  jq -n --arg sl "${STATUSLINE}" \
+    '{"hookSpecificOutput":{"hookEventName":"Notification","statusLine":$sl}}'
+else
+  # Escape double-quotes in statusline for safe inline embedding
+  SAFE="${STATUSLINE//\"/\\\"}"
+  printf '{"hookSpecificOutput":{"hookEventName":"Notification","statusLine":"%s"}}\n' "${SAFE}"
+fi
+
+exit 0

package/files/merlin/skills/SKILLS-INDEX.md

@@ -0,0 +1,82 @@
+# Merlin Skills Index
+
+When planning or executing a task, search this index to find relevant skills to load.
+Load a skill by reading its full .md file from the matching path. Only load 1-3 skills per task — pick the most relevant ones.
+
+Skills are prompt injections that enhance your capabilities for specific domains. They don't change what tools you have — they change how you think about the problem.
+
+## How to Use
+
+1. Read this index to find skills matching the current task
+2. Load the skill .md file (e.g., `~/.claude/merlin/skills/coding/react-patterns.md`)
+3. Follow the instructions in the skill while executing the task
+4. After the task: if the skill helped, note it. If it was wrong or outdated, improve it.
+
+## Coding > Frontend
+- `coding/react-patterns` — React component patterns, hooks, performance, server components — [react, nextjs, remix, vite]
+- `coding/tailwind-systems` — Design systems with Tailwind CSS, utility patterns, responsive — [tailwind, css, design-system]
+- `coding/css-3d` — Advanced CSS 3D transforms, perspective, immersive effects — [css, 3d, animation]
+- `coding/accessibility` — WCAG compliance, screen readers, keyboard nav, ARIA — [a11y, wcag, accessibility]
+- `coding/performance` — Core Web Vitals, bundle optimization, lazy loading, caching — [performance, lighthouse, web-vitals]
+- `coding/api-design` — RESTful conventions, versioning, OpenAPI specs, pagination — [api, rest, openapi, express]
+
+## Coding > Security
+- `coding/security-hardening` — OWASP top 10, input validation, auth patterns, XSS/CSRF — [security, owasp, auth, validation]
+
+## Testing
+- `testing/tdd-workflow` — Red-green-refactor, write tests first, Jest/Vitest/pytest — [tdd, testing, jest, vitest]
+- `testing/e2e-playwright` — End-to-end browser testing with Playwright — [playwright, e2e, testing, browser]
+
+## DevOps
+- `devops/docker-containers` — Dockerfiles, multi-stage builds, docker-compose, minimal images — [docker, containers, devops]
+- `devops/ci-cd` — GitHub Actions, CI pipelines, automated testing and deployment — [ci, cd, github-actions, deployment]
+
+## Design
+- `design/animation` — Smooth animations with Framer Motion, GSAP, CSS transitions — [animation, framer-motion, gsap, motion]
+
+## Research
+- `research/brainstorm` — Explore 3-5 approaches before committing, present pros/cons — [brainstorm, ideation, exploration]
+- `research/challenge` — Devil's advocate review, poke holes, identify weaknesses — [challenge, review, critique]
+- `research/deep-research` — Study problem domain before proposing, find best practices — [research, analysis, study]
+- `research/step-by-step` — Break task into numbered steps, get approval before building — [planning, steps, breakdown]
+
+## Execution
+- `coding/focus-mode` — GSD mode: minimal questions, maximum speed, make decisions — [focus, gsd, speed, autonomous]
+- `coding/loop` — Test-fix loop: run tests, fix failures, repeat until green — [loop, testing, iteration]
+- `coding/verify` — Validate results: run code, check output, confirm requirements met — [verify, validation, qa]
+- `coding/debug-mode` — Systematic debugging: reproduce, hypothesize, test, fix — [debug, troubleshoot, investigate]
+
+## Communication (Non-Coding)
+- `communication/whatsapp` — Two-way WhatsApp via Business API — direct, no middleware — [whatsapp, messaging, business-api]
+- `communication/telegram` — Telegram bot via Bot API — direct HTTP calls — [telegram, bot, bot-api]
+- `communication/dispatcher` — Central hub: receives from all channels, dispatches to specialists — [dispatcher, hub, routing]
+- `communication/email-gmail` — Gmail read/send/draft/search via API — [email, gmail, mailbox]
+- `communication/discord` — Discord bot: channels, roles, embeds, slash commands — [discord, bot]
+- `communication/slack` — Slack integration: channels, DMs, Block Kit, threads — [slack, messaging, workspace]
+- `communication/email` — Email automation: HTML emails, campaigns, auto-respond — [email, sendgrid, resend, smtp]
+- `communication/sms-voice` — Twilio SMS and voice: notifications, IVR, 2FA — [twilio, sms, voice, phone]
+
+## Automation (Non-Coding)
+- `automation/webhooks` — Receive/send webhooks, parse payloads, validate signatures — [webhooks, http, events]
+- `automation/zapier-make` — Connect 5000+ apps via Zapier/Make automation — [zapier, make, automation, integrations]
+- `automation/scheduled-tasks` — Cron jobs, recurring automations, periodic reports — [cron, scheduling, automation]
+- `automation/monitoring` — Health checks, uptime monitoring, auto-alerts — [monitoring, heartbeat, uptime]
+- `automation/payments` — Stripe: checkout, subscriptions, invoices, webhooks — [stripe, payments, billing]
+
+## Data (Non-Coding)
+- `data/google-sheets` — Read/write Google Sheets, formulas, batch operations — [sheets, google, spreadsheet]
+- `data/airtable` — Airtable CRUD, filters, linked records, attachments — [airtable, database, no-code]
+- `data/notion` — Notion pages, databases, content sync, knowledge base — [notion, wiki, knowledge-base]
+- `data/analytics` — Analytics platforms, dashboards, KPIs, reports — [analytics, mixpanel, amplitude, reporting]
+
+## Marketing (Non-Coding)
+- `marketing/social-media` — Post to Twitter/X, LinkedIn, Instagram, schedule content — [social, twitter, linkedin, instagram]
+
+---
+
+## Evolution
+
+Skills evolve. When you improve a skill after using it:
+1. Update the skill .md file with your improvement
+2. Increment the `version` in the frontmatter
+3. Add a line to `evolution` in the frontmatter describing what changed

package/files/merlin/skills/automation/payments.md

@@ -0,0 +1,14 @@
+---
+id: payments
+name: Stripe Payments
+domain: non-coding
+category: automation
+tags: [stripe, payments, billing, subscriptions, checkout]
+version: 1
+source: builtin
+successRate: 0
+usageCount: 0
+evolution: []
+---
+# Stripe Payments
+Interact with Stripe for payment processing. Create Checkout Sessions for one-time payments. Manage Subscriptions with billing cycles. Handle webhooks for payment events (payment_intent.succeeded, invoice.paid, customer.subscription.updated). Process refunds. Generate invoices. Always use Stripe's official SDK, never raw API calls with card numbers.

package/files/merlin/skills/automation/webhooks.md

@@ -0,0 +1,14 @@
+---
+id: webhooks
+name: Webhooks
+domain: non-coding
+category: automation
+tags: [webhooks, http, events, callbacks, integrations]
+version: 1
+source: builtin
+successRate: 0
+usageCount: 0
+evolution: []
+---
+# Webhooks
+Set up webhook endpoints to receive events from external services (GitHub, Stripe, Shopify, etc.) and send outgoing webhooks to trigger actions in other systems. Parse payloads, validate signatures (HMAC-SHA256), handle retries with idempotency keys, and route events to appropriate handlers. Always verify webhook authenticity before processing.

package/files/merlin/skills/coding/accessibility.md

@@ -0,0 +1,14 @@
+---
+id: accessibility
+name: Accessibility (a11y)
+domain: coding
+category: frontend
+tags: [a11y, wcag, accessibility, screen-reader, keyboard]
+version: 1
+source: builtin
+successRate: 0
+usageCount: 0
+evolution: []
+---
+# Accessibility (a11y)
+Ensure all UI elements are accessible. Add ARIA labels to interactive elements without visible text. Support full keyboard navigation (Tab, Enter, Escape, Arrow keys). Maintain color contrast ratios (WCAG AA: 4.5:1 for text, 3:1 for large text). Use semantic HTML (button not div, nav not div, heading hierarchy). Test with screen reader patterns. Every image needs alt text. Focus management on route changes and modal open/close.

package/files/merlin/skills/coding/api-design.md

@@ -0,0 +1,14 @@
+---
+id: api-design
+name: REST API Design
+domain: coding
+category: backend
+tags: [api, rest, openapi, express, fastify, pagination]
+version: 1
+source: builtin
+successRate: 0
+usageCount: 0
+evolution: []
+---
+# REST API Design
+Design RESTful APIs following best practices: proper HTTP verbs (GET=read, POST=create, PUT=replace, PATCH=update, DELETE=remove), meaningful status codes (200, 201, 204, 400, 401, 403, 404, 409, 500), cursor-based pagination for lists, consistent error response shape `{ error: string, code: string }`, API versioning via URL prefix (/v1/), and OpenAPI/Swagger documentation for every endpoint.

package/files/merlin/skills/coding/debug-mode.md

@@ -0,0 +1,14 @@
+---
+id: debug-mode
+name: Debug Mode
+domain: coding
+category: execution
+tags: [debug, troubleshoot, investigate, hypothesis]
+version: 1
+source: builtin
+successRate: 0
+usageCount: 0
+evolution: []
+---
+# Debug Mode
+Use systematic debugging: 1) Reproduce the issue with a minimal test case, 2) Form a hypothesis about the root cause, 3) Test the hypothesis with targeted investigation, 4) Fix or form new hypothesis. Show your reasoning at each step. Never shotgun-debug (changing random things hoping something works).

package/files/merlin/skills/coding/focus-mode.md

@@ -0,0 +1,14 @@
+---
+id: focus-mode
+name: Focus Mode (GSD)
+domain: coding
+category: execution
+tags: [focus, gsd, speed, autonomous, minimal-questions]
+version: 1
+source: builtin
+successRate: 0
+usageCount: 0
+evolution: []
+---
+# Focus Mode (GSD)
+Work in Get Stuff Done mode. Make reasonable decisions without asking. Build quickly and show results. Only ask questions when truly blocked. Prefer action over deliberation. If two approaches seem equally valid, pick the simpler one and move on.

package/files/merlin/skills/coding/loop.md

@@ -0,0 +1,14 @@
+---
+id: loop
+name: Test-Fix Loop
+domain: coding
+category: execution
+tags: [loop, testing, iteration, fix]
+version: 1
+source: builtin
+successRate: 0
+usageCount: 0
+evolution: []
+---
+# Test-Fix Loop
+After implementing, run tests. If tests fail, fix the issues and re-run. Repeat until all tests pass. Show the test results at each iteration. Maximum 5 iterations — if still failing after 5, stop and explain what's wrong.

package/files/merlin/skills/coding/performance.md

@@ -0,0 +1,14 @@
+---
+id: performance
+name: Performance Optimization
+domain: coding
+category: frontend
+tags: [performance, lighthouse, web-vitals, bundle, lazy-loading]
+version: 1
+source: builtin
+successRate: 0
+usageCount: 0
+evolution: []
+---
+# Performance Optimization
+Optimize for performance. Use code splitting and dynamic imports for route-level chunks. Lazy load below-fold images and heavy components. Set proper Cache-Control headers for static assets. Minimize main thread blocking (defer non-critical JS). Target Core Web Vitals: LCP < 2.5s, FID < 100ms, CLS < 0.1. Use `next/image` or equivalent for automatic image optimization.