wayfinder-mcp 0.1.0 → 0.1.2

package/README.md

@@ -29,7 +29,10 @@ the plan lives in `~/.wayfinder/wayfinder-plan.json`, the bridge binds
   JSON-RPC over stdin/stdout. No network, no auth dance.
 - **Tools** are named functions with a JSON schema: `get_summary`,
   `get_plan`, `add_node`, `update_node`, `remove_node`, `connect`,
-  `disconnect`, `complete_node`, `set_text`, `replace_plan`.
+  `disconnect`, `complete_node`, `set_text`, `replace_plan`, `layout`.
+  New nodes are auto-placed (after their prerequisites, nudged until free,
+  so siblings never stack), and `layout` arranges the whole map by depth —
+  agents should call it after building a fresh map.
 - **Validation is shared** with the site: `graph.js` is a byte-identical copy
   of `wayfinder/dist/graph.js` (enforced by `npm run check`), so agent edits
   obey the same rules as the UI (version 1, ≤2000 nodes, ≤10000 edges,
@@ -40,17 +43,16 @@ the plan lives in `~/.wayfinder/wayfinder-plan.json`, the bridge binds
   (`WAYFINDER_NO_BRIDGE=1` disables it). It answers Chrome's private-network
   preflight so the **deployed site** can reach each visitor's own bridge.
 
-## For the site owner: publish once
+## For the site owner: releasing a new version
 
-`wayfinder-mcp` is free on npm at the time of writing. One-time, from `mcp/`:
+Releases are manual (two commands, ~2 minutes). From `mcp/`:
 
-```sh
-npm login
-npm publish --access public
-```
+1. Bump `version` in `mcp/package.json`.
+2. Create a short-lived granular token: npmjs.com → Access Tokens → Generate New Token → Granular, scoped to `wayfinder-mcp`, Read + Write.
+3. `npm config set //registry.npmjs.org/:_authToken 'paste-token-here' && npm publish --access public`
+4. Revoke the token on the website and clear it locally: `npm config delete //registry.npmjs.org/:_authToken`
 
-Then redeploy the site so the dialog's `npx -y wayfinder-mcp` snippet resolves.
-Bump `version` in `mcp/package.json` for later releases (`0.1.0` now).
+(Browser `npm login` tokens cannot publish — always use a granular token.)
 
 ## For developers (repo clone)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wayfinder-mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Local MCP server + loopback bridge so AI agents can read and edit Wayfinder life-map DAGs",
   "license": "MIT",
   "repository": {

package/server.js

@@ -19,7 +19,7 @@ import {
   CallToolRequestSchema,
   ListToolsRequestSchema,
 } from '@modelcontextprotocol/sdk/types.js';
-import { validatePlan, canConnect } from './graph.js';
+import { validatePlan, canConnect, layoutNodes } from './graph.js';
 import { resolvePlanPath } from './paths.js';
 import { loadPlan, startBridge } from './bridge.js';
 
@@ -141,6 +141,11 @@ const TOOLS = [
       properties: { plan: { type: 'object', description: 'Full version-1 plan JSON' } },
     },
   },
+  {
+    name: 'layout',
+    description: 'Auto-arrange every node by graph depth (same as the site Arrange button). Call after building or importing a fresh map so nothing overlaps.',
+    inputSchema: { type: 'object', properties: {} },
+  },
 ];
 
 const server = new Server({ name: 'wayfinder', version: '1.0.0' }, { capabilities: { tools: {} } });
@@ -180,7 +185,12 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
         const ps = nodes.filter((n) => parents.includes(n.id));
         node.x = Math.max(...ps.map((p) => p.x)) + 270;
         node.y = ps.reduce((t, p) => t + p.y, 0) / ps.length;
+      } else {
+        // First free grid slot, so parentless nodes never stack on each other.
+        node.x = 55; node.y = 55;
       }
+      // Nudge down until free: siblings sharing parents would otherwise overlap exactly.
+      while (nodes.some((n) => Math.abs(n.x - node.x) < 235 && Math.abs(n.y - node.y) < 165)) node.y += 184;
       return text({ ok: true, node: savePlan({ ...plan, nodes, edges }).nodes.find((n) => n.id === id) });
     }
 
@@ -252,6 +262,12 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
       return text({ ok: true, plan: savePlan(args.plan) });
     }
 
+    if (name === 'layout') {
+      layoutNodes(plan.nodes, plan.edges);
+      savePlan(plan);
+      return text({ ok: true, nodes: plan.nodes.length });
+    }
+
     throw new Error(`unknown tool ${name}`);
   } catch (err) {
     return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };