@anthropologies/claudestory 0.1.6 → 0.1.7

package/README.md

@@ -95,16 +95,10 @@ The MCP server provides 19 tools for Claude Code integration. It imports the sam
 ### Setup with Claude Code
 
 ```bash
-claude mcp add claudestory -- npx -y @anthropologies/claudestory --mcp
+claude mcp add claudestory -s user -- npx -y @anthropologies/claudestory --mcp
 ```
 
-That's it. No global install required. Claude Code will spawn the MCP server automatically.
-
-For a specific project root (recommended when working across multiple projects):
-
-```bash
-claude mcp add claudestory -- env CLAUDESTORY_PROJECT_ROOT=/path/to/project npx -y @anthropologies/claudestory --mcp
-```
+That's it. One command, global — works in every project that has a `.story/` directory. No global install required. The MCP server auto-discovers the project root by walking up from the working directory.
 
 ### MCP Tools
 

package/dist/cli.js

@@ -3590,50 +3590,58 @@ import { realpathSync, existsSync as existsSync5 } from "fs";
 import { resolve as resolve7, join as join8, isAbsolute } from "path";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-function pinProjectRoot() {
+function tryDiscoverRoot() {
   const envRoot = process.env[ENV_VAR2];
   if (envRoot) {
     if (!isAbsolute(envRoot)) {
-      process.stderr.write(`Error: ${ENV_VAR2} must be an absolute path, got: ${envRoot}
+      process.stderr.write(`Warning: ${ENV_VAR2} must be an absolute path, got: ${envRoot}
 `);
-      process.exit(1);
+      return null;
     }
     const resolved = resolve7(envRoot);
-    let canonical;
     try {
-      canonical = realpathSync(resolved);
-    } catch {
-      process.stderr.write(`Error: ${ENV_VAR2} path does not exist: ${resolved}
+      const canonical = realpathSync(resolved);
+      if (existsSync5(join8(canonical, CONFIG_PATH2))) {
+        return canonical;
+      }
+      process.stderr.write(`Warning: No .story/config.json at ${canonical}
 `);
-      process.exit(1);
-    }
-    if (!existsSync5(join8(canonical, CONFIG_PATH2))) {
-      process.stderr.write(`Error: No .story/config.json at ${canonical}
+    } catch {
+      process.stderr.write(`Warning: ${ENV_VAR2} path does not exist: ${resolved}
 `);
-      process.exit(1);
     }
-    return canonical;
+    return null;
   }
-  const root = discoverProjectRoot();
-  if (!root) {
-    process.stderr.write("Error: No .story/ project found. Set CLAUDESTORY_PROJECT_ROOT or run from a project directory.\n");
-    process.exit(1);
+  try {
+    const root = discoverProjectRoot();
+    return root ? realpathSync(root) : null;
+  } catch {
+    return null;
   }
-  return realpathSync(root);
 }
 async function main() {
-  const root = pinProjectRoot();
+  const root = tryDiscoverRoot();
   const server = new McpServer(
     { name: "claudestory", version },
     {
-      instructions: "Start with claudestory_status for a project overview, then claudestory_ticket_next for the highest-priority work, then claudestory_handover_latest for session context."
+      instructions: root ? "Start with claudestory_status for a project overview, then claudestory_ticket_next for the highest-priority work, then claudestory_handover_latest for session context." : "No .story/ project found in the current directory. Navigate to a project with a .story/ directory, or set CLAUDESTORY_PROJECT_ROOT."
     }
   );
-  registerAllTools(server, root);
+  if (root) {
+    registerAllTools(server, root);
+    process.stderr.write(`claudestory MCP server running (root: ${root})
+`);
+  } else {
+    server.registerTool("claudestory_status", {
+      description: "Project summary \u2014 returns error if no .story/ project found"
+    }, () => Promise.resolve({
+      content: [{ type: "text", text: "No .story/ project found. Navigate to a directory containing .story/ or set CLAUDESTORY_PROJECT_ROOT." }],
+      isError: true
+    }));
+    process.stderr.write("claudestory MCP server running (no project found \u2014 tools will report errors)\n");
+  }
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  process.stderr.write(`claudestory MCP server running (root: ${root})
-`);
 }
 var ENV_VAR2, CONFIG_PATH2, version;
 var init_mcp = __esm({
@@ -3644,7 +3652,7 @@ var init_mcp = __esm({
     init_tools();
     ENV_VAR2 = "CLAUDESTORY_PROJECT_ROOT";
     CONFIG_PATH2 = ".story/config.json";
-    version = "0.1.6";
+    version = "0.1.7";
     main().catch((err) => {
       process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}
 `);
@@ -5168,7 +5176,7 @@ async function runCli() {
     registerRecapCommand: registerRecapCommand2,
     registerExportCommand: registerExportCommand2
   } = await Promise.resolve().then(() => (init_register(), register_exports));
-  const version2 = "0.1.6";
+  const version2 = "0.1.7";
   class HandledError extends Error {
     constructor() {
       super("HANDLED_ERROR");

package/dist/mcp.js

@@ -2491,51 +2491,59 @@ function registerAllTools(server, pinnedRoot) {
 // src/mcp/index.ts
 var ENV_VAR2 = "CLAUDESTORY_PROJECT_ROOT";
 var CONFIG_PATH2 = ".story/config.json";
-var version = "0.1.6";
-function pinProjectRoot() {
+var version = "0.1.7";
+function tryDiscoverRoot() {
   const envRoot = process.env[ENV_VAR2];
   if (envRoot) {
     if (!isAbsolute(envRoot)) {
-      process.stderr.write(`Error: ${ENV_VAR2} must be an absolute path, got: ${envRoot}
+      process.stderr.write(`Warning: ${ENV_VAR2} must be an absolute path, got: ${envRoot}
 `);
-      process.exit(1);
+      return null;
     }
     const resolved = resolve7(envRoot);
-    let canonical;
     try {
-      canonical = realpathSync(resolved);
-    } catch {
-      process.stderr.write(`Error: ${ENV_VAR2} path does not exist: ${resolved}
+      const canonical = realpathSync(resolved);
+      if (existsSync5(join8(canonical, CONFIG_PATH2))) {
+        return canonical;
+      }
+      process.stderr.write(`Warning: No .story/config.json at ${canonical}
 `);
-      process.exit(1);
-    }
-    if (!existsSync5(join8(canonical, CONFIG_PATH2))) {
-      process.stderr.write(`Error: No .story/config.json at ${canonical}
+    } catch {
+      process.stderr.write(`Warning: ${ENV_VAR2} path does not exist: ${resolved}
 `);
-      process.exit(1);
     }
-    return canonical;
+    return null;
   }
-  const root = discoverProjectRoot();
-  if (!root) {
-    process.stderr.write("Error: No .story/ project found. Set CLAUDESTORY_PROJECT_ROOT or run from a project directory.\n");
-    process.exit(1);
+  try {
+    const root = discoverProjectRoot();
+    return root ? realpathSync(root) : null;
+  } catch {
+    return null;
   }
-  return realpathSync(root);
 }
 async function main() {
-  const root = pinProjectRoot();
+  const root = tryDiscoverRoot();
   const server = new McpServer(
     { name: "claudestory", version },
     {
-      instructions: "Start with claudestory_status for a project overview, then claudestory_ticket_next for the highest-priority work, then claudestory_handover_latest for session context."
+      instructions: root ? "Start with claudestory_status for a project overview, then claudestory_ticket_next for the highest-priority work, then claudestory_handover_latest for session context." : "No .story/ project found in the current directory. Navigate to a project with a .story/ directory, or set CLAUDESTORY_PROJECT_ROOT."
     }
   );
-  registerAllTools(server, root);
+  if (root) {
+    registerAllTools(server, root);
+    process.stderr.write(`claudestory MCP server running (root: ${root})
+`);
+  } else {
+    server.registerTool("claudestory_status", {
+      description: "Project summary \u2014 returns error if no .story/ project found"
+    }, () => Promise.resolve({
+      content: [{ type: "text", text: "No .story/ project found. Navigate to a directory containing .story/ or set CLAUDESTORY_PROJECT_ROOT." }],
+      isError: true
+    }));
+    process.stderr.write("claudestory MCP server running (no project found \u2014 tools will report errors)\n");
+  }
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  process.stderr.write(`claudestory MCP server running (root: ${root})
-`);
 }
 main().catch((err) => {
   process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropologies/claudestory",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "type": "module",
   "exports": {
     ".": {