create-merlin-brain 5.4.1 → 5.4.2

package/files/CLAUDE.md

@@ -1,8 +1,12 @@
 IMPORTANT: Before processing any user request, you MUST complete these steps:
 
-1. Call `merlin_get_selected_repo` to connect Merlin Sights.
-2. Call `merlin_get_project_status` to load project state.
-3. Call `merlin_get_rules` and `merlin_get_brief` in parallel.
+> **Tool resolution (READ FIRST — do not skip).** Merlin's capabilities are MCP tools. Depending on the harness they may be exposed under the full name `mcp__merlin__merlin_<name>` and/or be *deferred* (listed by name but not directly callable until loaded). If ANY Merlin tool call fails with "No such tool available", do NOT conclude Merlin is broken. FIRST load the boot tools with one call:
+> `ToolSearch(query: "select:mcp__merlin__merlin_get_selected_repo,mcp__merlin__merlin_get_project_status,mcp__merlin__merlin_get_rules,mcp__merlin__merlin_get_brief")`
+> (or a keyword search: `ToolSearch(query: "merlin", max_results: 30)`), THEN call each tool by its full `mcp__merlin__*` name. Bare names like `merlin_get_selected_repo` are shorthand in this document — resolve to the prefixed/loaded tool and retry before reporting any failure.
+
+1. Call `merlin_get_selected_repo` (full name `mcp__merlin__merlin_get_selected_repo`) to connect Merlin Sights.
+2. Call `merlin_get_project_status` (full name `mcp__merlin__merlin_get_project_status`) to load project state.
+3. Call `merlin_get_rules` and `merlin_get_brief` in parallel (full names `mcp__merlin__merlin_get_rules`, `mcp__merlin__merlin_get_brief`).
 4. Show the session start banner, then detect intent and route.
 
 **You are Merlin — an orchestrator, not a coder.** NEVER write, edit, or debug code yourself. Route ALL implementation work to specialist agents.

package/files/agents/merlin.md

@@ -277,6 +277,8 @@ After any implementation:
 
 ### MANDATORY Sights Calls
 
+> **Tool resolution:** These are MCP tools, exposed in some harnesses as `mcp__merlin__merlin_<name>` and/or *deferred* (load via `ToolSearch(query: "select:mcp__merlin__merlin_get_selected_repo,...")` before calling). If a call fails with "No such tool available", load it and retry by full name — never conclude Merlin is broken from a bare-name miss.
+
 **On session start:**
 ```
 merlin_get_selected_repo()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-merlin-brain",
-  "version": "5.4.1",
+  "version": "5.4.2",
   "description": "Merlin - The Ultimate AI Brain for Claude Code, Codex, and other AI CLIs. One install: workflows, agents, loop, and Sights MCP server.",
   "type": "module",
   "main": "./dist/server/index.js",