@grainulation/wheat 1.0.8 → 1.0.10

package/README.md

@@ -39,11 +39,13 @@ Works with [Claude Code](https://claude.com/claude-code), [Cursor](https://curso
 For native tool access in Claude Code:
 
 ```bash
-claude mcp add wheat -- npx -y @grainulation/wheat mcp
+claude mcp add wheat -- npx -y @grainulation/wheat-mcp
 ```
 
 This gives Claude direct access to wheat's claims engine — add-claim, compile, search, status — without shelling out.
 
+> **Note:** `wheat mcp` still works as a subcommand, but the dedicated `wheat-mcp` entry point is recommended for MCP integrations — it bypasses CLI dispatch and starts the server directly.
+
 ## See it in 30 seconds
 
 ```bash

package/bin/wheat-mcp.cjs

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * wheat-mcp (CJS) — Dedicated MCP server entry point
+ *
+ * CJS wrapper that dynamically imports the ESM serve-mcp module.
+ * Claude Code's plugin transport reliably keeps CJS-spawned processes
+ * alive but drops ESM processes. This file bridges the gap.
+ */
+
+const dirIdx = process.argv.indexOf("--dir");
+const dir = dirIdx !== -1 && process.argv[dirIdx + 1]
+  ? process.argv[dirIdx + 1]
+  : process.cwd();
+
+// Dynamic import of ESM module from CJS
+import("../lib/serve-mcp.js").then((mod) => {
+  mod.startServer(dir);
+});

package/bin/wheat-mcp.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+/**
+ * wheat-mcp — Dedicated MCP server entry point
+ *
+ * Skips the CLI dispatch chain (bin/wheat.js) and starts the MCP server
+ * directly. This avoids the async import overhead, install-prompt, and
+ * arg parsing that can cause connection timeouts in Claude Code's
+ * plugin transport (30s stdio initialization timeout).
+ *
+ * Usage:
+ *   node bin/wheat-mcp.js [--dir <path>]
+ *   npx @grainulation/wheat-mcp [--dir <path>]
+ *
+ * Zero npm dependencies.
+ */
+
+import { startServer } from "../lib/serve-mcp.js";
+
+const dirIdx = process.argv.indexOf("--dir");
+const dir = dirIdx !== -1 && process.argv[dirIdx + 1]
+  ? process.argv[dirIdx + 1]
+  : process.cwd();
+
+startServer(dir);

package/lib/init.js

@@ -344,7 +344,7 @@ function writeMcpJson(dir) {
   const mcpPath = target(dir, ".mcp.json");
   const wheatEntry = {
     command: "npx",
-    args: ["-y", "@grainulation/wheat", "mcp"],
+    args: ["-y", "@grainulation/wheat-mcp"],
   };
 
   let config = { mcpServers: {} };
@@ -577,10 +577,24 @@ export async function run(dir, args) {
   fs.renameSync(tmpClaims, claimsPath);
   console.log("  \x1b[32m+\x1b[0m claims.json");
 
-  // CLAUDE.md
+  // CLAUDE.md (preserve existing content unless --force)
   const claudePath = target(dir, "CLAUDE.md");
-  fs.writeFileSync(claudePath, claudeMd);
-  console.log("  \x1b[32m+\x1b[0m CLAUDE.md");
+  const claudeExists = fs.existsSync(claudePath);
+  if (claudeExists && flags.force) {
+    // --force with existing file: back up before overwriting
+    fs.copyFileSync(claudePath, claudePath + ".bak");
+    fs.writeFileSync(claudePath, claudeMd);
+    console.log("  \x1b[32m+\x1b[0m CLAUDE.md (backed up existing to CLAUDE.md.bak)");
+  } else if (claudeExists) {
+    // Existing file, no --force: append wheat section with separator
+    const existing = fs.readFileSync(claudePath, "utf8");
+    fs.writeFileSync(claudePath, existing + "\n\n---\n\n" + claudeMd);
+    console.log("  \x1b[32m+\x1b[0m CLAUDE.md (appended wheat sprint section)");
+  } else {
+    // No existing file: write normally
+    fs.writeFileSync(claudePath, claudeMd);
+    console.log("  \x1b[32m+\x1b[0m CLAUDE.md");
+  }
 
   // .claude/commands/wheat/
   const copied = copyCommands(dir);

package/lib/serve-mcp.js

@@ -22,7 +22,10 @@
  *
  * Protocol: MCP over stdio (JSON-RPC 2.0, newline-delimited)
  *
- * Install:
+ * Install (recommended):
+ *   claude mcp add wheat -- npx @grainulation/wheat-mcp
+ *
+ * Legacy (still works, but routes through CLI dispatch):
  *   claude mcp add wheat -- npx @grainulation/wheat mcp
  *
  * Zero npm dependencies.
@@ -850,10 +853,11 @@ export async function run(dir, args) {
     console.log(`wheat mcp -- Local MCP server for Claude Code
 
 Usage:
-  wheat mcp [--dir <path>]
+  wheat-mcp [--dir <path>]      (recommended)
+  wheat mcp [--dir <path>]      (legacy, still works)
 
 Install in Claude Code:
-  claude mcp add wheat -- npx @grainulation/wheat mcp
+  claude mcp add wheat -- npx @grainulation/wheat-mcp
 
 Tools exposed:
   wheat/compile     Run the compiler

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grainulation/wheat",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "Research-driven development framework — structured claims, compiled evidence, deterministic output",
   "license": "MIT",
   "author": "grainulation contributors",
@@ -36,7 +36,8 @@
     "./load-claims": "./lib/load-claims.js"
   },
   "bin": {
-    "wheat": "bin/wheat.js"
+    "wheat": "bin/wheat.js",
+    "wheat-mcp": "bin/wheat-mcp.js"
   },
   "files": [
     "bin/",
@@ -46,7 +47,7 @@
     "templates/"
   ],
   "scripts": {
-    "test": "node --test test/cli.test.js test/compiler.test.js test/guard.test.js test/init.test.js test/migration.test.js"
+    "test": "node --test test/cli.test.js test/compiler.test.js test/guard.test.js test/init.test.js test/migration.test.js test/mcp.test.js"
   },
   "engines": {
     "node": ">=20"