@anthropologies/claudestory 0.1.7 → 0.1.8

package/README.md

@@ -95,10 +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 -s user -- npx -y @anthropologies/claudestory --mcp
+npm install -g @anthropologies/claudestory
+claude mcp add claudestory -s user -- 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.
+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

@@ -3652,7 +3652,7 @@ var init_mcp = __esm({
     init_tools();
     ENV_VAR2 = "CLAUDESTORY_PROJECT_ROOT";
     CONFIG_PATH2 = ".story/config.json";
-    version = "0.1.7";
+    version = "0.1.8";
     main().catch((err) => {
       process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}
 `);
@@ -3662,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);
@@ -3689,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,
@@ -3719,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 {
@@ -3733,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?"
+`;
   }
 });
 
@@ -5176,7 +5251,7 @@ async function runCli() {
     registerRecapCommand: registerRecapCommand2,
     registerExportCommand: registerExportCommand2
   } = await Promise.resolve().then(() => (init_register(), register_exports));
-  const version2 = "0.1.7";
+  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,7 +2491,7 @@ function registerAllTools(server, pinnedRoot) {
 // src/mcp/index.ts
 var ENV_VAR2 = "CLAUDESTORY_PROJECT_ROOT";
 var CONFIG_PATH2 = ".story/config.json";
-var version = "0.1.7";
+var version = "0.1.8";
 function tryDiscoverRoot() {
   const envRoot = process.env[ENV_VAR2];
   if (envRoot) {

package/package.json

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