@anthropologies/claudestory 0.1.6 → 0.1.8

package/README.md

@@ -95,16 +95,11 @@ 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
+npm install -g @anthropologies/claudestory
+claude mcp add claudestory -s user -- 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
-```
+Two commands: install globally, register as MCP server. Works in every project that has a `.story/` directory. 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.8";
     main().catch((err) => {
       process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}
 `);
@@ -3654,7 +3662,8 @@ var init_mcp = __esm({
 });
 
 // src/core/init.ts
-import { mkdir as mkdir3, stat as stat2 } from "fs/promises";
+import { mkdir as mkdir3, stat as stat2, writeFile as writeFile2 } from "fs/promises";
+import { existsSync as existsSync6 } from "fs";
 import { join as join9, resolve as resolve8 } from "path";
 async function initProject(root, options) {
   const absRoot = resolve8(root);
@@ -3681,6 +3690,13 @@ async function initProject(root, options) {
   await mkdir3(join9(wrapDir, "tickets"), { recursive: true });
   await mkdir3(join9(wrapDir, "issues"), { recursive: true });
   await mkdir3(join9(wrapDir, "handovers"), { recursive: true });
+  const created = [
+    ".story/config.json",
+    ".story/roadmap.json",
+    ".story/tickets/",
+    ".story/issues/",
+    ".story/handovers/"
+  ];
   const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
   const config = {
     version: 2,
@@ -3711,6 +3727,13 @@ async function initProject(root, options) {
   };
   await writeConfig(config, absRoot);
   await writeRoadmap(roadmap, absRoot);
+  const skillDir = join9(absRoot, ".claude", "skills", "prime");
+  const skillPath = join9(skillDir, "SKILL.md");
+  if (!existsSync6(skillPath)) {
+    await mkdir3(skillDir, { recursive: true });
+    await writeFile2(skillPath, PRIME_SKILL_CONTENT, "utf-8");
+    created.push(".claude/skills/prime/SKILL.md");
+  }
   const warnings = [];
   if (options.force && exists) {
     try {
@@ -3725,22 +3748,82 @@ async function initProject(root, options) {
   }
   return {
     root: absRoot,
-    created: [
-      ".story/config.json",
-      ".story/roadmap.json",
-      ".story/tickets/",
-      ".story/issues/",
-      ".story/handovers/"
-    ],
+    created,
     warnings
   };
 }
+var PRIME_SKILL_CONTENT;
 var init_init = __esm({
   "src/core/init.ts"() {
     "use strict";
     init_esm_shims();
     init_project_loader();
     init_errors();
+    PRIME_SKILL_CONTENT = `---
+name: prime
+description: Load full claudestory project context. Use at session start for any project with a .story/ directory.
+---
+
+# Prime: Load Project Context
+
+Get full project context in one command for any project using claudestory.
+
+## Step 0: Check Setup
+
+First, check if the claudestory MCP tools are available by looking for \`claudestory_status\` in your available tools.
+
+**If MCP tools ARE available**, proceed to Step 1.
+
+**If MCP tools are NOT available**, help the user set up:
+
+1. Check if the \`claudestory\` CLI is installed by running: \`claudestory --version\`
+2. If NOT installed, tell the user:
+   \`\`\`
+   claudestory CLI not found. To set up:
+   npm install -g @anthropologies/claudestory
+   claude mcp add claudestory -s user -- claudestory --mcp
+   Then restart Claude Code and run /prime again.
+   \`\`\`
+3. If CLI IS installed but MCP not registered, offer to register it for them.
+   With user permission, run: \`claude mcp add claudestory -s user -- claudestory --mcp\`
+   Tell the user to restart Claude Code and run /prime again.
+
+**If MCP tools are unavailable and user doesn't want to set up**, fall back to CLI:
+- Run \`claudestory status\` via Bash
+- Run \`claudestory recap\` via Bash
+- Run \`claudestory handover latest\` via Bash
+- Then continue to Steps 4-6 below.
+
+## Step 1: Project Status
+Call the \`claudestory_status\` MCP tool.
+
+## Step 2: Session Recap
+Call the \`claudestory_recap\` MCP tool.
+
+## Step 3: Latest Handover
+Call the \`claudestory_handover_latest\` MCP tool.
+
+## Step 4: Development Rules
+Read \`RULES.md\` if it exists in the project root.
+
+## Step 5: Lessons Learned
+Read \`WORK_STRATEGIES.md\` if it exists in the project root.
+
+## Step 6: Recent Commits
+Run \`git log --oneline -10\`.
+
+## After Loading
+
+Present a concise summary:
+- Project progress (X/Y tickets, current phase)
+- What changed since last snapshot
+- What the last session accomplished
+- Next ticket to work on
+- Any high-severity issues or blockers
+- Key process rules (if WORK_STRATEGIES.md exists)
+
+Then ask: "What would you like to work on?"
+`;
   }
 });
 
@@ -5168,7 +5251,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.8";
   class HandledError extends Error {
     constructor() {
       super("HANDLED_ERROR");

package/dist/index.js

@@ -1382,7 +1382,8 @@ function dfsBlocked(id, state, visited, inStack, findings) {
 }
 
 // src/core/init.ts
-import { mkdir, stat as stat2 } from "fs/promises";
+import { mkdir, stat as stat2, writeFile as writeFile2 } from "fs/promises";
+import { existsSync as existsSync4 } from "fs";
 import { join as join4, resolve as resolve3 } from "path";
 async function initProject(root, options) {
   const absRoot = resolve3(root);
@@ -1409,6 +1410,13 @@ async function initProject(root, options) {
   await mkdir(join4(wrapDir, "tickets"), { recursive: true });
   await mkdir(join4(wrapDir, "issues"), { recursive: true });
   await mkdir(join4(wrapDir, "handovers"), { recursive: true });
+  const created = [
+    ".story/config.json",
+    ".story/roadmap.json",
+    ".story/tickets/",
+    ".story/issues/",
+    ".story/handovers/"
+  ];
   const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
   const config = {
     version: 2,
@@ -1439,6 +1447,13 @@ async function initProject(root, options) {
   };
   await writeConfig(config, absRoot);
   await writeRoadmap(roadmap, absRoot);
+  const skillDir = join4(absRoot, ".claude", "skills", "prime");
+  const skillPath = join4(skillDir, "SKILL.md");
+  if (!existsSync4(skillPath)) {
+    await mkdir(skillDir, { recursive: true });
+    await writeFile2(skillPath, PRIME_SKILL_CONTENT, "utf-8");
+    created.push(".claude/skills/prime/SKILL.md");
+  }
   const warnings = [];
   if (options.force && exists) {
     try {
@@ -1453,20 +1468,79 @@ async function initProject(root, options) {
   }
   return {
     root: absRoot,
-    created: [
-      ".story/config.json",
-      ".story/roadmap.json",
-      ".story/tickets/",
-      ".story/issues/",
-      ".story/handovers/"
-    ],
+    created,
     warnings
   };
 }
+var PRIME_SKILL_CONTENT = `---
+name: prime
+description: Load full claudestory project context. Use at session start for any project with a .story/ directory.
+---
+
+# Prime: Load Project Context
+
+Get full project context in one command for any project using claudestory.
+
+## Step 0: Check Setup
+
+First, check if the claudestory MCP tools are available by looking for \`claudestory_status\` in your available tools.
+
+**If MCP tools ARE available**, proceed to Step 1.
+
+**If MCP tools are NOT available**, help the user set up:
+
+1. Check if the \`claudestory\` CLI is installed by running: \`claudestory --version\`
+2. If NOT installed, tell the user:
+   \`\`\`
+   claudestory CLI not found. To set up:
+   npm install -g @anthropologies/claudestory
+   claude mcp add claudestory -s user -- claudestory --mcp
+   Then restart Claude Code and run /prime again.
+   \`\`\`
+3. If CLI IS installed but MCP not registered, offer to register it for them.
+   With user permission, run: \`claude mcp add claudestory -s user -- claudestory --mcp\`
+   Tell the user to restart Claude Code and run /prime again.
+
+**If MCP tools are unavailable and user doesn't want to set up**, fall back to CLI:
+- Run \`claudestory status\` via Bash
+- Run \`claudestory recap\` via Bash
+- Run \`claudestory handover latest\` via Bash
+- Then continue to Steps 4-6 below.
+
+## Step 1: Project Status
+Call the \`claudestory_status\` MCP tool.
+
+## Step 2: Session Recap
+Call the \`claudestory_recap\` MCP tool.
+
+## Step 3: Latest Handover
+Call the \`claudestory_handover_latest\` MCP tool.
+
+## Step 4: Development Rules
+Read \`RULES.md\` if it exists in the project root.
+
+## Step 5: Lessons Learned
+Read \`WORK_STRATEGIES.md\` if it exists in the project root.
+
+## Step 6: Recent Commits
+Run \`git log --oneline -10\`.
+
+## After Loading
+
+Present a concise summary:
+- Project progress (X/Y tickets, current phase)
+- What changed since last snapshot
+- What the last session accomplished
+- Next ticket to work on
+- Any high-severity issues or blockers
+- Key process rules (if WORK_STRATEGIES.md exists)
+
+Then ask: "What would you like to work on?"
+`;
 
 // src/core/snapshot.ts
 import { readdir as readdir3, readFile as readFile3, mkdir as mkdir2, unlink as unlink2 } from "fs/promises";
-import { existsSync as existsSync4 } from "fs";
+import { existsSync as existsSync5 } from "fs";
 import { join as join5, resolve as resolve4 } from "path";
 import { z as z6 } from "zod";
 var LoadWarningSchema = z6.object({
@@ -1519,7 +1593,7 @@ async function saveSnapshot(root, loadResult) {
 }
 async function loadLatestSnapshot(root) {
   const snapshotsDir = join5(resolve4(root), ".story", "snapshots");
-  if (!existsSync4(snapshotsDir)) return null;
+  if (!existsSync5(snapshotsDir)) return null;
   const files = await listSnapshotFiles(snapshotsDir);
   if (files.length === 0) return null;
   for (const filename of files) {

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.8";
+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.8",
   "type": "module",
   "exports": {
     ".": {