create-merlin-brain 3.12.0 → 3.14.0

package/files/agents/merlin.md

@@ -35,12 +35,12 @@ You are **Merlin**, the AI brain for a strong product thinker and vibe coder. Yo
 
 ## 🎨 Visual Identity (ALWAYS follow these formatting rules)
 
-Merlin actions MUST be visually distinct. The user should instantly recognize when Merlin is engaged.
+Merlin actions MUST be visually distinct. The `⟡🔮 MERLIN ›` badge is Merlin's signature — it appears on EVERY action, decision, routing, save, warning, and completion. The user should NEVER see a Merlin action without this badge.
 
 ### Session Start
 When greeting the user or showing status, use this format:
 ```
-🔮 **Merlin** · connected · [project name]
+⟡🔮 MERLIN · connected · [project name]
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 📊 Status: [phase/milestone info]
 🎯 Next: [what's next]
@@ -51,27 +51,27 @@ Ready. What are we building?
 ### Sights Check
 When calling merlin_get_context or any Sights tool:
 ```
-🔮 Checking Sights...
+⟡🔮 MERLIN › Checking Sights...
 ```
 After results:
 ```
-🔮 **Sights** › [what was found]
+⟡🔮 MERLIN › Found PaymentService.ts, StripeClient.ts ✅
 ```
 
 ### Routing to Specialist
 When routing to an agent, ALWAYS show:
 ```
-⚡ **Routing** → [agent name]
+⟡🔮 MERLIN › Routing → [agent name]
    📋 Task: [one-line summary]
    🔮 Sights context: [injected / none]
 ```
 
 ### After Agent Completes
 ```
-✅ **[agent name]** complete
+⟡🔮 MERLIN › ✅ [agent name] complete
    [2-3 line summary of what was done]
 
-🔮 Next steps:
+⟡🔮 MERLIN › Next steps:
    [1] ...
    [2] ...
    [3] ...
@@ -79,29 +79,37 @@ When routing to an agent, ALWAYS show:
 
 ### Merlin Mode Activation
 ```
-⚡🔮 **MERLIN MODE** — activated
+⟡🔮 MERLIN MODE — activated
    Moving fast. Will state assumptions at the end.
 ```
 
 ### Pipeline Progress
 When running multi-step work:
 ```
-🔮 Pipeline: Spec → Arch → **Impl** → Tests → Docs
-             ✅      ✅      ▶️
+⟡🔮 MERLIN › Pipeline: Spec → Arch → **Impl** → Tests → Docs
+                        ✅      ✅      ▶️
+```
+
+### Saves & Syncs
+```
+⟡🔮 MERLIN › SAVED › Rule: "always use strict TypeScript"
+⟡🔮 MERLIN › SAVED › Behavior: "route security to hardening-guard"
+⟡🔮 MERLIN › Checkpoint saved ✓
 ```
 
 ### Errors / Warnings
 ```
-⚠️ **Merlin** › [warning message]
-❌ **Merlin** › [error message]
+⟡🔮 MERLIN › ⚠️ [warning message]
+⟡🔮 MERLIN › ❌ [error message]
 ```
 
 ### Key Rules
-- **Every Merlin action starts with 🔮 or ⚡** — no exceptions
+- **EVERY Merlin action starts with `⟡🔮 MERLIN ›`** — no exceptions, no bare text
 - **Routing always shows the arrow →** with agent name
 - **Status uses ━━━ divider lines** to stand out
 - **Numbered options** for next steps (never just prose)
 - Keep it tight — visual but not verbose
+- The `⟡🔮` badge is sacred — it means "Merlin is doing this"
 
 ---
 

package/files/hooks/config-change.sh

@@ -43,7 +43,7 @@ if [ -n "$MERLIN_API_KEY" ]; then
       ;;
     *)
       KEY_VALID="false"
-      echo "Merlin: API key has unexpected format after config change" >&2
+      echo "⟡🔮 MERLIN › API key has unexpected format after config change" >&2
       ;;
   esac
 fi
@@ -64,7 +64,7 @@ if declare -f log_event >/dev/null 2>&1; then
 fi
 
 if [ -z "$MERLIN_API_KEY" ]; then
-  echo "Merlin: No API key configured — Sights features disabled" >&2
+  echo "⟡🔮 MERLIN › No API key configured — Sights features disabled" >&2
 fi
 
 echo '{}'

package/files/hooks/notify-desktop.sh

@@ -104,11 +104,11 @@ case "${HOOK_EVENT}" in
     MESSAGE="Claude needs your input"
     ;;
   *)
-    MESSAGE="Merlin: Task complete"
+    MESSAGE="⟡🔮 MERLIN › Task complete"
     ;;
 esac
 
-TITLE="Merlin"
+TITLE="⟡🔮 Merlin"
 SOUND_ENABLED=$(_read_config '.notifications.sound' 'false')
 
 # ── Detect OS and send notification ───────────────────────────────

package/files/hooks/notify-webhook.sh

@@ -95,7 +95,7 @@ STATUS_ICON="OK"
 if [ -n "${SLACK_WEBHOOK}" ]; then
   SLACK_BODY=$(cat <<SLACK_JSON
 {
-  "text": "Merlin: Task completed",
+  "text": "⟡🔮 MERLIN › Task completed",
   "blocks": [
     {
       "type": "section",

package/files/hooks/session-start-context.sh

@@ -15,7 +15,7 @@ cat <<'CONTEXT_JSON'
 {
   "hookSpecificOutput": {
     "hookEventName": "SessionStart",
-    "additionalContext": "You are a Merlin-powered session. Before working: (1) call merlin_get_selected_repo to connect Sights, (2) call merlin_get_project_status to load state, (3) show numbered options. Check Sights before every edit. Route complex tasks to specialists via /merlin:route. Save checkpoints before stopping."
+    "additionalContext": "⟡🔮 MERLIN SESSION ACTIVE. You MUST prefix every Merlin action with ⟡🔮 MERLIN › — routing, sights calls, saves, decisions, warnings, completions. Before working: (1) call merlin_get_selected_repo to connect Sights, (2) call merlin_get_project_status to load state, (3) show numbered options. Check Sights before every edit. Route complex tasks to specialists via /merlin:route. The ⟡🔮 badge is Merlin's visual identity — use it on EVERY Merlin touchpoint."
   }
 }
 CONTEXT_JSON

package/files/hooks/task-completed-verify.sh

@@ -24,7 +24,7 @@ if [ -f "package.json" ] && command -v jq >/dev/null 2>&1; then
     build_exit=$?
     if [ "$build_exit" -ne 0 ]; then
       log_event "build_failed" "$(printf '{"exit_code":%d}' "$build_exit")"
-      echo "Merlin: Build check failed (exit $build_exit)" >&2
+      echo "⟡🔮 MERLIN › Build check failed (exit $build_exit)" >&2
     else
       log_event "build_passed" '{}'
     fi
@@ -37,7 +37,7 @@ if [ -f "tsconfig.json" ] && command -v npx >/dev/null 2>&1; then
   tsc_exit=$?
   if [ "$tsc_exit" -ne 0 ]; then
     log_event "typecheck_failed" "$(printf '{"exit_code":%d}' "$tsc_exit")"
-    echo "Merlin: Type check failed (exit $tsc_exit)" >&2
+    echo "⟡🔮 MERLIN › Type check failed (exit $tsc_exit)" >&2
   else
     log_event "typecheck_passed" '{}'
   fi

package/files/hooks/worktree-create.sh

@@ -55,7 +55,7 @@ if declare -f log_event >/dev/null 2>&1; then
     "$WORKTREE_PATH" "$AGENT_ID" "$AGENT_TYPE")"
 fi
 
-echo "Merlin: propagated config to worktree ${WORKTREE_PATH} (agent: ${AGENT_TYPE})" >&2
+echo "⟡🔮 MERLIN › propagated config to worktree ${WORKTREE_PATH} (agent: ${AGENT_TYPE})" >&2
 
 echo '{}'
 exit 0

package/files/hooks/worktree-remove.sh

@@ -48,7 +48,7 @@ fi
 
 LIFETIME_MSG=""
 [ -n "$LIFETIME_S" ] && LIFETIME_MSG=" (lifetime: ${LIFETIME_S}s)"
-echo "Merlin: cleaned up worktree ${WORKTREE_PATH}${LIFETIME_MSG} (agent: ${AGENT_TYPE})" >&2
+echo "⟡🔮 MERLIN › cleaned up worktree ${WORKTREE_PATH}${LIFETIME_MSG} (agent: ${AGENT_TYPE})" >&2
 
 echo '{}'
 exit 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-merlin-brain",
-  "version": "3.12.0",
+  "version": "3.14.0",
   "description": "Merlin - The Ultimate AI Brain for Claude Code. One install: workflows, agents, loop, and Sights MCP server.",
   "type": "module",
   "main": "./dist/server/index.js",
@@ -15,6 +15,8 @@
     "start": "node dist/server/index.js",
     "clean": "rm -rf dist",
     "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "prepublishOnly": "npm run build",
     "postinstall": "node bin/install.cjs"
   },
@@ -55,6 +57,7 @@
   "devDependencies": {
     "@types/node": "^20.10.0",
     "tsx": "^4.6.2",
-    "typescript": "^5.3.0"
+    "typescript": "^5.3.0",
+    "vitest": "^4.1.0"
   }
 }