@anthropologies/claudestory 0.1.5 → 0.1.7

package/dist/index.d.ts

@@ -573,6 +573,7 @@ declare function guardPath(target: string, root: string): Promise<void>;
  *
  * CLAUDESTORY_PROJECT_ROOT env var overrides walk-up discovery.
  * Returns the canonical absolute path, or null if not found.
+ * Throws ProjectLoaderError if .story/ exists but is unreadable.
  */
 declare function discoverProjectRoot(startDir?: string): string | null;
 

package/dist/index.js

@@ -971,30 +971,43 @@ async function withLock(wrapDir, fn) {
 }
 
 // src/core/project-root-discovery.ts
-import { existsSync as existsSync3 } from "fs";
+import { existsSync as existsSync3, accessSync, constants } from "fs";
 import { resolve as resolve2, dirname as dirname2, join as join3 } from "path";
 var ENV_VAR = "CLAUDESTORY_PROJECT_ROOT";
+var STORY_DIR = ".story";
 var CONFIG_PATH = ".story/config.json";
 function discoverProjectRoot(startDir) {
   const envRoot = process.env[ENV_VAR];
   if (envRoot) {
     const resolved = resolve2(envRoot);
-    if (existsSync3(join3(resolved, CONFIG_PATH))) {
-      return resolved;
-    }
-    return null;
+    return checkRoot(resolved);
   }
   let current = resolve2(startDir ?? process.cwd());
   for (; ; ) {
-    if (existsSync3(join3(current, CONFIG_PATH))) {
-      return current;
-    }
+    const result = checkRoot(current);
+    if (result) return result;
     const parent = dirname2(current);
     if (parent === current) break;
     current = parent;
   }
   return null;
 }
+function checkRoot(candidate) {
+  if (existsSync3(join3(candidate, CONFIG_PATH))) {
+    return candidate;
+  }
+  if (existsSync3(join3(candidate, STORY_DIR))) {
+    try {
+      accessSync(join3(candidate, STORY_DIR), constants.R_OK);
+    } catch {
+      throw new ProjectLoaderError(
+        "io_error",
+        `Permission denied: cannot read .story/ in ${candidate}`
+      );
+    }
+  }
+  return null;
+}
 
 // src/core/queries.ts
 function nextTicket(state) {

package/dist/mcp.js

@@ -7,30 +7,61 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
 // src/core/project-root-discovery.ts
-import { existsSync } from "fs";
+import { existsSync, accessSync, constants } from "fs";
 import { resolve, dirname, join } from "path";
+
+// src/core/errors.ts
+var CURRENT_SCHEMA_VERSION = 1;
+var ProjectLoaderError = class extends Error {
+  constructor(code, message, cause) {
+    super(message);
+    this.code = code;
+    this.cause = cause;
+  }
+  name = "ProjectLoaderError";
+};
+var INTEGRITY_WARNING_TYPES = [
+  "parse_error",
+  "schema_error",
+  "duplicate_id"
+];
+
+// src/core/project-root-discovery.ts
 var ENV_VAR = "CLAUDESTORY_PROJECT_ROOT";
+var STORY_DIR = ".story";
 var CONFIG_PATH = ".story/config.json";
 function discoverProjectRoot(startDir) {
   const envRoot = process.env[ENV_VAR];
   if (envRoot) {
     const resolved = resolve(envRoot);
-    if (existsSync(join(resolved, CONFIG_PATH))) {
-      return resolved;
-    }
-    return null;
+    return checkRoot(resolved);
   }
   let current = resolve(startDir ?? process.cwd());
   for (; ; ) {
-    if (existsSync(join(current, CONFIG_PATH))) {
-      return current;
-    }
+    const result = checkRoot(current);
+    if (result) return result;
     const parent = dirname(current);
     if (parent === current) break;
     current = parent;
   }
   return null;
 }
+function checkRoot(candidate) {
+  if (existsSync(join(candidate, CONFIG_PATH))) {
+    return candidate;
+  }
+  if (existsSync(join(candidate, STORY_DIR))) {
+    try {
+      accessSync(join(candidate, STORY_DIR), constants.R_OK);
+    } catch {
+      throw new ProjectLoaderError(
+        "io_error",
+        `Permission denied: cannot read .story/ in ${candidate}`
+      );
+    }
+  }
+  return null;
+}
 
 // src/mcp/tools.ts
 import { z as z7 } from "zod";
@@ -365,22 +396,6 @@ var ProjectState = class _ProjectState {
   }
 };
 
-// src/core/errors.ts
-var CURRENT_SCHEMA_VERSION = 1;
-var ProjectLoaderError = class extends Error {
-  constructor(code, message, cause) {
-    super(message);
-    this.code = code;
-    this.cause = cause;
-  }
-  name = "ProjectLoaderError";
-};
-var INTEGRITY_WARNING_TYPES = [
-  "parse_error",
-  "schema_error",
-  "duplicate_id"
-];
-
 // src/core/handover-parser.ts
 import { readdir, readFile } from "fs/promises";
 import { existsSync as existsSync2 } from "fs";
@@ -2476,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.5";
-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.5",
+  "version": "0.1.7",
   "type": "module",
   "exports": {
     ".": {