devscribe-reason 1.0.0 → 1.0.2

package/.claude/settings.local.json

@@ -18,7 +18,11 @@
       "Bash(npm unlink:*)",
       "Bash(GITHUB_TOKEN=ghp_test npm run setup)",
       "Bash(node -c scripts/setup.js)",
-      "Bash(git -C . status --short)"
+      "Bash(git -C . status --short)",
+      "mcp__devscribe-reason__log_intent",
+      "Bash(npm publish:*)",
+      "mcp__devscribe-reason__log_decision",
+      "mcp__devscribe-reason__finalize_reasoning_doc"
     ]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devscribe-reason",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "MCP server that captures engineering decision reasoning and commits structured markdown to GitHub",
   "main": "src/index.js",
   "type": "module",

package/scripts/setup.js

@@ -1,14 +1,11 @@
 #!/usr/bin/env node
 
 import { execSync } from "node:child_process";
-import { existsSync } from "node:fs";
-import { resolve, dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
 import { homedir } from "node:os";
 import { globSync } from "glob";
 
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const serverPath = resolve(__dirname, "../src/index.js");
 const token = process.env.GITHUB_TOKEN || "";
 const repo = process.env.GITHUB_REPO || "";
 const branch = process.env.GITHUB_BRANCH || "main";
@@ -55,6 +52,23 @@ function findClaudeBinary() {
   return null;
 }
 
+// Detect if Claude Code is available
+function isClaudeCodeAvailable() {
+  return findClaudeBinary() !== null;
+}
+
+// Detect if Cursor is available
+function isCursorAvailable() {
+  // Check if .cursor folder exists in current directory or if Cursor.app is installed on macOS
+  const cursorDir = join(process.cwd(), ".cursor");
+  if (existsSync(cursorDir)) return true;
+
+  // Check for Cursor installation on macOS
+  if (existsSync("/Applications/Cursor.app")) return true;
+
+  return false;
+}
+
 // Build env args for the CLI
 const envArgs = [
   token && `-e GITHUB_TOKEN=${token}`,
@@ -64,31 +78,77 @@ const envArgs = [
   .filter(Boolean)
   .join(" ");
 
-const claudeCmd = findClaudeBinary();
+const claudeAvailable = isClaudeCodeAvailable();
+const cursorAvailable = isCursorAvailable();
 
-if (!claudeCmd) {
-  console.error(
-    "\n❌ Could not find the 'claude' command. Please ensure you have:\n"
-  );
-  console.error("  • Claude Code CLI installed (https://claude.com/claude-code)");
-  console.error("  • Or VS Code with the Claude Code extension");
-  console.error("  • Or Cursor with Claude Code support\n");
-  console.error("After installation, run: npm run setup\n");
+if (!claudeAvailable && !cursorAvailable) {
+  console.error("\n❌ Could not find Claude Code or Cursor.\n");
+  console.error("Manual setup required:\n");
+  console.error("📌 For Claude Code:");
+  console.error("  1. Install Claude Code: https://claude.com/claude-code");
+  console.error("  2. Run: GITHUB_TOKEN=your_token npx devscribe-reason\n");
+  console.error("📌 For Cursor:");
+  console.error("  1. Install Cursor: https://cursor.com");
+  console.error("  2. Create .cursor/mcp.json in your project with:");
+  console.error('  {\n    "mcpServers": {\n      "devscribe-reason": {\n        "command": "npx",\n        "args": ["-y", "devscribe-reason"],\n        "env": {\n          "GITHUB_TOKEN": "your_token",\n          "GITHUB_BRANCH": "main"\n        }\n      }\n    }\n  }');
+  console.error("");
   process.exit(1);
 }
 
-const cmd = `${claudeCmd} mcp add --scope user devscribe-reason node ${serverPath} ${envArgs}`;
+// Setup for Claude Code
+if (claudeAvailable) {
+  const claudeCmd = findClaudeBinary();
+  const cmd = `${claudeCmd} mcp add --scope user devscribe-reason npx devscribe-reason ${envArgs}`;
 
-try {
-  execSync(cmd, { stdio: "inherit" });
-  console.log(
-    "\n✅ Setup complete. devscribe-reason is now active in all your Claude Code sessions."
-  );
-  console.log(
-    "\nTo verify: Open Claude Code and check Settings > MCP Servers\n"
-  );
-} catch (err) {
-  console.error("\n❌ Setup failed. Run this command manually:\n");
-  console.error(`  ${cmd}\n`);
-  process.exit(1);
+  try {
+    execSync(cmd, { stdio: "inherit" });
+    console.log("\n✅ Claude Code detected — devscribe-reason registered globally");
+  } catch (err) {
+    console.error("\n❌ Claude Code setup failed. Run this command manually:\n");
+    console.error(`  ${cmd}\n`);
+    if (!cursorAvailable) {
+      process.exit(1);
+    }
+  }
+}
+
+// Setup for Cursor
+if (cursorAvailable) {
+  try {
+    const cursorDir = join(process.cwd(), ".cursor");
+    const mcpJsonPath = join(cursorDir, "mcp.json");
+
+    // Create .cursor directory if it doesn't exist
+    if (!existsSync(cursorDir)) {
+      mkdirSync(cursorDir, { recursive: true });
+    }
+
+    // Create or update mcp.json
+    const mcpConfig = {
+      mcpServers: {
+        "devscribe-reason": {
+          command: "npx",
+          args: ["-y", "devscribe-reason"],
+          env: {
+            ...(token && { GITHUB_TOKEN: token }),
+            ...(repo && { GITHUB_REPO: repo }),
+            GITHUB_BRANCH: branch,
+          },
+        },
+      },
+    };
+
+    writeFileSync(mcpJsonPath, JSON.stringify(mcpConfig, null, 2));
+    console.log("\n✅ Cursor detected — .cursor/mcp.json created in current directory");
+  } catch (err) {
+    console.error("\n❌ Cursor setup failed:", err.message);
+    if (!claudeAvailable) {
+      process.exit(1);
+    }
+  }
+}
+
+if (claudeAvailable || cursorAvailable) {
+  console.log("\n📝 To use devscribe-reason in your sessions:");
+  console.log("   GITHUB_TOKEN=your_token npx devscribe-reason\n");
 }