wayfind 2.0.63 → 2.0.65

package/bin/mcp-server.js

@@ -228,7 +228,7 @@ async function proxyGetEntry(id) {
 const TOOLS = [
   {
     name: 'search_context',
-    description: 'Search team context by natural language or keyword. Returns ranked journal entries, decisions, and signals. Use this to answer questions about past work, architectural decisions, and team activity.',
+    description: 'Search the team\'s full decision history across all repos and all engineers. Returns ranked journal entries, decisions, and signals. Use this — not file reads — to answer any question about past work, architectural decisions, what was decided, or team activity. The content store covers history that state files cannot.',
     inputSchema: {
       type: 'object',
       properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wayfind",
-  "version": "2.0.63",
+  "version": "2.0.65",
   "description": "Team decision trail for AI-assisted development. The connective tissue between product, engineering, and strategy.",
   "bin": {
     "wayfind": "./bin/team-context.js",

package/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "wayfind",
-  "version": "2.0.63",
+  "version": "2.0.65",
   "description": "Team decision trail for AI-assisted development. Session memory, decision journals, and team digests.",
   "author": {
     "name": "Wayfind",

package/setup.sh

@@ -441,15 +441,22 @@ PYEOF
             fi
         fi
 
-        # MCP server — register wayfind-mcp in settings.json
+        # MCP server — register wayfind-mcp in settings.json using absolute path
+        # (Claude Code spawns MCP servers with a minimal env; bare command may not resolve)
+        MCP_BIN="$(command -v wayfind-mcp 2>/dev/null || true)"
+        if [ -z "$MCP_BIN" ]; then
+            NPM_PREFIX="$(npm config get prefix 2>/dev/null || true)"
+            [ -n "$NPM_PREFIX" ] && MCP_BIN="$NPM_PREFIX/bin/wayfind-mcp"
+        fi
         MCP_REGISTERED=false
         grep -q '"wayfind"' "$SETTINGS" 2>/dev/null && MCP_REGISTERED=true
-        if [ "$MCP_REGISTERED" = false ]; then
-            if [ "$DRY_RUN" = false ]; then
-                TMP_SETTINGS="$(mktemp)"
-                if python3 - "$SETTINGS" "$TMP_SETTINGS" <<'PYEOF' 2>/dev/null; then
+        if [ -n "$MCP_BIN" ] && [ -f "$MCP_BIN" ]; then
+            if [ "$MCP_REGISTERED" = false ]; then
+                if [ "$DRY_RUN" = false ]; then
+                    TMP_SETTINGS="$(mktemp)"
+                    if python3 - "$SETTINGS" "$MCP_BIN" "$TMP_SETTINGS" <<'PYEOF' 2>/dev/null; then
 import json, sys
-settings_path, out_path = sys.argv[1], sys.argv[2]
+settings_path, mcp_bin, out_path = sys.argv[1], sys.argv[2], sys.argv[3]
 try:
     with open(settings_path) as f:
         settings = json.load(f)
@@ -457,23 +464,26 @@ except (json.JSONDecodeError, IOError):
     sys.exit(1)
 mcp = settings.setdefault("mcpServers", {})
 if "wayfind" not in mcp:
-    mcp["wayfind"] = {"command": "wayfind-mcp"}
+    mcp["wayfind"] = {"command": mcp_bin}
 with open(out_path, "w") as f:
     json.dump(settings, f, indent=2)
     f.write("\n")
 PYEOF
-                    mv "$TMP_SETTINGS" "$SETTINGS"
-                    log "Registered wayfind MCP server in ~/.claude/settings.json"
+                        mv "$TMP_SETTINGS" "$SETTINGS"
+                        log "Registered wayfind MCP server in ~/.claude/settings.json"
+                    else
+                        rm -f "$TMP_SETTINGS"
+                        warn "Could not register MCP server — add manually to ~/.claude/settings.json:"
+                        warn "  \"mcpServers\": { \"wayfind\": { \"command\": \"$MCP_BIN\" } }"
+                    fi
                 else
-                    rm -f "$TMP_SETTINGS"
-                    warn "Could not register MCP server — add manually to ~/.claude/settings.json:"
-                    warn '  "mcpServers": { "wayfind": { "command": "wayfind-mcp" } }'
+                    info "[dry-run] Would register wayfind MCP server ($MCP_BIN) in $SETTINGS"
                 fi
             else
-                info "[dry-run] Would register wayfind MCP server in $SETTINGS"
+                info "MCP server already registered in settings.json — skipped"
             fi
         else
-            info "MCP server already registered in settings.json — skipped"
+            warn "wayfind-mcp binary not found — skipping MCP registration. Re-run after npm install."
         fi
 
         ;;
@@ -506,21 +516,27 @@ PYEOF
             fi
         fi
 
-        # MCP server — register wayfind-mcp in ~/.cursor/mcp.json
+        # MCP server — register wayfind-mcp in ~/.cursor/mcp.json using absolute path
+        CURSOR_MCP_BIN="$(command -v wayfind-mcp 2>/dev/null || true)"
+        if [ -z "$CURSOR_MCP_BIN" ]; then
+            NPM_PREFIX="$(npm config get prefix 2>/dev/null || true)"
+            [ -n "$NPM_PREFIX" ] && CURSOR_MCP_BIN="$NPM_PREFIX/bin/wayfind-mcp"
+        fi
         CURSOR_MCP="$HOME/.cursor/mcp.json"
         run mkdir -p "$HOME/.cursor"
         CURSOR_MCP_REGISTERED=false
         grep -q '"wayfind"' "$CURSOR_MCP" 2>/dev/null && CURSOR_MCP_REGISTERED=true
-        if [ "$CURSOR_MCP_REGISTERED" = false ]; then
-            if [ "$DRY_RUN" = false ]; then
-                if [ ! -f "$CURSOR_MCP" ]; then
-                    printf '{\n  "mcpServers": {\n    "wayfind": {\n      "command": "wayfind-mcp",\n      "args": []\n    }\n  }\n}\n' > "$CURSOR_MCP"
-                    log "Created ~/.cursor/mcp.json with wayfind MCP server"
-                else
-                    TMP_MCP="$(mktemp)"
-                    if python3 - "$CURSOR_MCP" "$TMP_MCP" <<'PYEOF' 2>/dev/null; then
+        if [ -n "$CURSOR_MCP_BIN" ] && [ -f "$CURSOR_MCP_BIN" ]; then
+            if [ "$CURSOR_MCP_REGISTERED" = false ]; then
+                if [ "$DRY_RUN" = false ]; then
+                    if [ ! -f "$CURSOR_MCP" ]; then
+                        printf '{\n  "mcpServers": {\n    "wayfind": {\n      "command": "%s",\n      "args": []\n    }\n  }\n}\n' "$CURSOR_MCP_BIN" > "$CURSOR_MCP"
+                        log "Created ~/.cursor/mcp.json with wayfind MCP server"
+                    else
+                        TMP_MCP="$(mktemp)"
+                        if python3 - "$CURSOR_MCP" "$CURSOR_MCP_BIN" "$TMP_MCP" <<'PYEOF' 2>/dev/null; then
 import json, sys
-mcp_path, out_path = sys.argv[1], sys.argv[2]
+mcp_path, mcp_bin, out_path = sys.argv[1], sys.argv[2], sys.argv[3]
 try:
     with open(mcp_path) as f:
         config = json.load(f)
@@ -528,24 +544,27 @@ except (json.JSONDecodeError, IOError):
     config = {}
 mcp = config.setdefault("mcpServers", {})
 if "wayfind" not in mcp:
-    mcp["wayfind"] = {"command": "wayfind-mcp", "args": []}
+    mcp["wayfind"] = {"command": mcp_bin, "args": []}
 with open(out_path, "w") as f:
     json.dump(config, f, indent=2)
     f.write("\n")
 PYEOF
-                        mv "$TMP_MCP" "$CURSOR_MCP"
-                        log "Registered wayfind MCP server in ~/.cursor/mcp.json"
-                    else
-                        rm -f "$TMP_MCP"
-                        warn "Could not register MCP server — add manually to ~/.cursor/mcp.json:"
-                        warn '  "mcpServers": { "wayfind": { "command": "wayfind-mcp", "args": [] } }'
+                            mv "$TMP_MCP" "$CURSOR_MCP"
+                            log "Registered wayfind MCP server in ~/.cursor/mcp.json"
+                        else
+                            rm -f "$TMP_MCP"
+                            warn "Could not register MCP server — add manually to ~/.cursor/mcp.json:"
+                            warn "  \"mcpServers\": { \"wayfind\": { \"command\": \"$CURSOR_MCP_BIN\", \"args\": [] } }"
+                        fi
                     fi
+                else
+                    info "[dry-run] Would register wayfind MCP server ($CURSOR_MCP_BIN) in ~/.cursor/mcp.json"
                 fi
             else
-                info "[dry-run] Would register wayfind MCP server in ~/.cursor/mcp.json"
+                info "MCP server already registered in ~/.cursor/mcp.json — skipped"
             fi
         else
-            info "MCP server already registered in ~/.cursor/mcp.json — skipped"
+            warn "wayfind-mcp binary not found — skipping Cursor MCP registration. Re-run after npm install."
         fi
         ;;
 

package/specializations/claude-code/CLAUDE.md-global-fragment.md

@@ -27,6 +27,18 @@
 3. Check the Memory Files table in global-state.md — load any `~/.claude/memory/` files whose keywords match this session's topic
 4. Summarize current state, then ask: **"What's the goal for this session? What does success look like?"**
 
+### Using the Wayfind MCP Server
+
+The `search_context` MCP tool is the right way to answer questions about past decisions, architectural choices, and team activity. **Do not read state files or repo files to answer these questions** — the content store covers the entire team's decision history across all repos and all engineers, which state files cannot.
+
+Use `search_context` when asked about:
+- What was decided about X
+- What work has been done on X
+- What the team's approach to X is
+- Recent activity in a repo or area
+
+State files (`team-state.md`, `personal-state.md`) are for **current status** — who's working on what right now. The content store is for **decision history** — what was decided and why.
+
 ### Mid-Session
 
 If work drifts from the stated goal, flag it: *"Quick check — we set out to [goal]. This feels like [tangent]. Stay the course or pivot?"*