whygraph 0.1.1 → 0.1.2

package/dist/platform/rules.js

@@ -59,10 +59,15 @@ function generateInstructions(config) {
         "",
         `Allowed tags: ${tagList}`,
         "",
-        "### MCP Server",
+        "### MCP Server (preferred)",
         "",
-        `Use the \`whygraph\` MCP server for decision capture tools.`,
-        "If the server is unreachable, write decision files directly to `.whygraph/graph/`.",
+        `Use the \`whygraph\` MCP server for decision capture tools when available.`,
+        "",
+        "### Direct File Write (fallback)",
+        "",
+        "If the MCP server is unreachable or MCP is blocked by your environment,",
+        "write the decision file directly to `.whygraph/graph/` using the format above.",
+        "The file will be picked up automatically on next server start.",
         "",
         "### Server Status",
         "",
@@ -89,7 +94,7 @@ function upsertMarkedSection(existing, content) {
 // ============================================================
 function registerMcpWithClaude(projectDir) {
     try {
-        execSync("claude mcp add --scope project whygraph -- whygraph mcp", {
+        execSync("claude mcp add --scope project whygraph -- npx whygraph mcp", {
             cwd: projectDir,
             stdio: "ignore",
         });
@@ -106,7 +111,7 @@ function registerMcpWithClaude(projectDir) {
             }
             const servers = (mcpJson.mcpServers ?? {});
             if (!servers.whygraph) {
-                servers.whygraph = { type: "stdio", command: "whygraph", args: ["mcp"] };
+                servers.whygraph = { type: "stdio", command: "npx", args: ["whygraph", "mcp"] };
                 mcpJson.mcpServers = servers;
                 writeFileSync(mcpJsonPath, JSON.stringify(mcpJson, null, 2) + "\n", "utf-8");
             }
@@ -129,7 +134,7 @@ function registerMcpWithCursor(projectDir) {
         }
         const servers = (mcp.mcpServers ?? {});
         if (!servers.whygraph) {
-            servers.whygraph = { command: "whygraph", args: ["mcp"] };
+            servers.whygraph = { command: "npx", args: ["whygraph", "mcp"] };
             mcp.mcpServers = servers;
             writeFileSync(mcpPath, JSON.stringify(mcp, null, 2) + "\n", "utf-8");
         }
@@ -150,7 +155,7 @@ function registerMcpWithCopilot(projectDir) {
         }
         const servers = (mcp.servers ?? {});
         if (!servers.whygraph) {
-            servers.whygraph = { type: "stdio", command: "whygraph", args: ["mcp"] };
+            servers.whygraph = { type: "stdio", command: "npx", args: ["whygraph", "mcp"] };
             mcp.servers = servers;
             writeFileSync(mcpPath, JSON.stringify(mcp, null, 2) + "\n", "utf-8");
         }
@@ -167,16 +172,16 @@ function writeMcpSetupMd(projectDir, environment) {
     const lines = ["# Whygraph MCP Setup", ""];
     switch (environment) {
         case "claude-code":
-            lines.push("Run the following command in your project root:", "", "```bash", "claude mcp add --scope project whygraph -- whygraph mcp", "```");
+            lines.push("Run the following command in your project root:", "", "```bash", "claude mcp add --scope project whygraph -- npx whygraph mcp", "```");
             break;
         case "cursor":
-            lines.push("Add the following to `.cursor/mcp.json` in your project root:", "", "```json", JSON.stringify({ mcpServers: { whygraph: { command: "whygraph", args: ["mcp"] } } }, null, 2), "```");
+            lines.push("Add the following to `.cursor/mcp.json` in your project root:", "", "```json", JSON.stringify({ mcpServers: { whygraph: { command: "npx", args: ["whygraph", "mcp"] } } }, null, 2), "```");
             break;
         case "copilot":
-            lines.push("Add the following to `.vscode/mcp.json` in your project root:", "", "```json", JSON.stringify({ servers: { whygraph: { type: "stdio", command: "whygraph", args: ["mcp"] } } }, null, 2), "```");
+            lines.push("Add the following to `.vscode/mcp.json` in your project root:", "", "```json", JSON.stringify({ servers: { whygraph: { type: "stdio", command: "npx", args: ["whygraph", "mcp"] } } }, null, 2), "```");
             break;
         default:
-            lines.push("Add the whygraph MCP server to your AI assistant's MCP configuration.", "", "**Command:** `whygraph mcp`", "**Transport:** stdio", "", "Refer to your AI assistant's documentation for how to register MCP servers.");
+            lines.push("Add the whygraph MCP server to your AI assistant's MCP configuration.", "", "**Command:** `npx whygraph mcp`", "**Transport:** stdio", "", "Refer to your AI assistant's documentation for how to register MCP servers.");
     }
     writeFileSync(filePath, lines.join("\n") + "\n", "utf-8");
     return filePath;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "whygraph",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "The graph of why. So your agent knows before it touches anything.",
   "author": "Geovanie Ruiz",
   "license": "MIT",