@anthropologies/claudestory 0.1.0 → 0.1.2

package/README.md

@@ -5,7 +5,7 @@ Cross-session context persistence for AI coding assistants. Tracks tickets, issu
 ## Installation
 
 ```bash
-npm install -g claudestory
+npm install -g @anthropologies/claudestory
 ```
 
 Requires Node.js 20+.
@@ -140,7 +140,7 @@ This gives the AI full project context from the first message.
 ## Library Usage
 
 ```typescript
-import { loadProject, ProjectState } from "claudestory";
+import { loadProject, ProjectState } from "@anthropologies/claudestory";
 
 const { state, warnings } = await loadProject("/path/to/project");
 console.log(state.tickets.length); // all tickets

package/dist/cli.js

@@ -224,9 +224,9 @@ function formatStatus(state, format) {
   const phases = phasesWithStatus(state);
   const data = {
     project: state.config.project,
-    totalTickets: state.totalTicketCount,
-    completeTickets: state.completeTicketCount,
-    openTickets: state.openTicketCount,
+    totalTickets: state.leafTicketCount,
+    completeTickets: state.completeLeafTicketCount,
+    openTickets: state.leafTicketCount - state.completeLeafTicketCount,
     blockedTickets: state.blockedCount,
     openIssues: state.openIssueCount,
     handovers: state.handoverFilenames.length,
@@ -243,7 +243,7 @@ function formatStatus(state, format) {
   const lines = [
     `# ${escapeMarkdownInline(state.config.project)}`,
     "",
-    `Tickets: ${state.completeTicketCount}/${state.totalTicketCount} complete, ${state.blockedCount} blocked`,
+    `Tickets: ${state.completeLeafTicketCount}/${state.leafTicketCount} complete, ${state.blockedCount} blocked`,
     `Issues: ${state.openIssueCount} open`,
     `Handovers: ${state.handoverFilenames.length}`,
     "",
@@ -465,7 +465,11 @@ function formatInitResult(result, format) {
   if (format === "json") {
     return JSON.stringify(successEnvelope(result), null, 2);
   }
-  return [`Initialized .story/ at ${escapeMarkdownInline(result.root)}`, "", ...result.created.map((f) => `  ${f}`)].join("\n");
+  const lines = [`Initialized .story/ at ${escapeMarkdownInline(result.root)}`, "", ...result.created.map((f) => `  ${f}`)];
+  if (result.warnings.length > 0) {
+    lines.push("", `Warning: ${result.warnings.length} corrupt file(s) found. Run \`claudestory validate\` to inspect.`);
+  }
+  return lines.join("\n");
 }
 function formatHandoverList(filenames, format) {
   if (format === "json") {
@@ -509,6 +513,8 @@ var ProjectState = class _ProjectState {
   // --- Derived (public readonly) ---
   umbrellaIDs;
   leafTickets;
+  leafTicketCount;
+  completeLeafTicketCount;
   // --- Derived (private) ---
   leafTicketsByPhase;
   childrenByParent;
@@ -535,6 +541,10 @@ var ProjectState = class _ProjectState {
     }
     this.umbrellaIDs = parentIDs;
     this.leafTickets = input.tickets.filter((t) => !parentIDs.has(t.id));
+    this.leafTicketCount = this.leafTickets.length;
+    this.completeLeafTicketCount = this.leafTickets.filter(
+      (t) => t.status === "complete"
+    ).length;
     const byPhase = /* @__PURE__ */ new Map();
     for (const t of this.leafTickets) {
       const phase = t.phase;
@@ -640,7 +650,7 @@ var ProjectState = class _ProjectState {
     });
   }
   get blockedCount() {
-    return this.tickets.filter((t) => this.isBlocked(t)).length;
+    return this.leafTickets.filter((t) => t.status !== "complete" && this.isBlocked(t)).length;
   }
   ticketByID(id) {
     return this.ticketsByID.get(id);
@@ -1699,7 +1709,7 @@ function dfsBlocked(id, state, visited, inStack, findings) {
 
 // src/core/init.ts
 init_esm_shims();
-import { mkdir, stat as stat2 } from "fs/promises";
+import { mkdir, stat as stat2, readdir as readdir3, readFile as readFile3 } from "fs/promises";
 import { join as join4, resolve as resolve3 } from "path";
 init_errors();
 async function initProject(root, options) {
@@ -1757,6 +1767,25 @@ async function initProject(root, options) {
   };
   await writeConfig(config, absRoot);
   await writeRoadmap(roadmap, absRoot);
+  const warnings = [];
+  if (options.force && exists) {
+    for (const subdir of ["tickets", "issues"]) {
+      const dir = join4(wrapDir, subdir);
+      try {
+        const files = await readdir3(dir);
+        for (const f of files) {
+          if (!f.endsWith(".json")) continue;
+          try {
+            const content = await readFile3(join4(dir, f), "utf-8");
+            JSON.parse(content);
+          } catch {
+            warnings.push(`.story/${subdir}/${f}`);
+          }
+        }
+      } catch {
+      }
+    }
+  }
   return {
     root: absRoot,
     created: [
@@ -1765,7 +1794,8 @@ async function initProject(root, options) {
       ".story/tickets/",
       ".story/issues/",
       ".story/handovers/"
-    ]
+    ],
+    warnings
   };
 }
 
@@ -3759,8 +3789,13 @@ function registerPhaseCommand(yargs2) {
 }
 
 // src/cli/index.ts
-var version = "0.1.0";
-var HANDLED_ERROR = /* @__PURE__ */ Symbol("HANDLED_ERROR");
+var version = "0.1.2";
+var HandledError = class extends Error {
+  constructor() {
+    super("HANDLED_ERROR");
+    this.name = "HandledError";
+  }
+};
 var rawArgs = hideBin(process.argv);
 function sniffFormat(args) {
   for (let i = 0; i < args.length; i++) {
@@ -3774,7 +3809,7 @@ var cli = yargs(rawArgs).scriptName("claudestory").version(version).strict().dem
   if (err) throw err;
   writeOutput(formatError("invalid_input", msg ?? "Unknown error", errorFormat));
   process.exitCode = ExitCode.USER_ERROR;
-  throw HANDLED_ERROR;
+  throw new HandledError();
 });
 cli = registerInitCommand(cli);
 cli = registerStatusCommand(cli);
@@ -3784,9 +3819,14 @@ cli = registerIssueCommand(cli);
 cli = registerHandoverCommand(cli);
 cli = registerBlockerCommand(cli);
 cli = registerValidateCommand(cli);
-await cli.parseAsync().catch((err) => {
-  if (err === HANDLED_ERROR) return;
+function handleUnexpectedError(err) {
+  if (err instanceof HandledError) return;
   const message = err instanceof Error ? err.message : String(err);
   writeOutput(formatError("io_error", message, errorFormat));
   process.exitCode = ExitCode.USER_ERROR;
-});
+}
+try {
+  await cli.parseAsync().catch(handleUnexpectedError);
+} catch (err) {
+  handleUnexpectedError(err);
+}

package/dist/index.d.ts

@@ -400,6 +400,8 @@ declare class ProjectState {
     readonly handoverFilenames: readonly string[];
     readonly umbrellaIDs: ReadonlySet<string>;
     readonly leafTickets: readonly Ticket[];
+    readonly leafTicketCount: number;
+    readonly completeLeafTicketCount: number;
     private readonly leafTicketsByPhase;
     private readonly childrenByParent;
     private readonly reverseBlocksMap;
@@ -697,6 +699,7 @@ interface InitOptions {
 interface InitResult {
     readonly root: string;
     readonly created: readonly string[];
+    readonly warnings: readonly string[];
 }
 /**
  * Scaffolds a new .story/ directory structure.
@@ -762,6 +765,7 @@ declare function formatError(code: ErrorCode, message: string, format: OutputFor
 declare function formatInitResult(result: {
     root: string;
     created: readonly string[];
+    warnings: readonly string[];
 }, format: OutputFormat): string;
 declare function formatHandoverList(filenames: readonly string[], format: OutputFormat): string;
 declare function formatHandoverContent(filename: string, content: string, format: OutputFormat): string;

package/dist/index.js

@@ -127,6 +127,8 @@ var ProjectState = class _ProjectState {
   // --- Derived (public readonly) ---
   umbrellaIDs;
   leafTickets;
+  leafTicketCount;
+  completeLeafTicketCount;
   // --- Derived (private) ---
   leafTicketsByPhase;
   childrenByParent;
@@ -153,6 +155,10 @@ var ProjectState = class _ProjectState {
     }
     this.umbrellaIDs = parentIDs;
     this.leafTickets = input.tickets.filter((t) => !parentIDs.has(t.id));
+    this.leafTicketCount = this.leafTickets.length;
+    this.completeLeafTicketCount = this.leafTickets.filter(
+      (t) => t.status === "complete"
+    ).length;
     const byPhase = /* @__PURE__ */ new Map();
     for (const t of this.leafTickets) {
       const phase = t.phase;
@@ -258,7 +264,7 @@ var ProjectState = class _ProjectState {
     });
   }
   get blockedCount() {
-    return this.tickets.filter((t) => this.isBlocked(t)).length;
+    return this.leafTickets.filter((t) => t.status !== "complete" && this.isBlocked(t)).length;
   }
   ticketByID(id) {
     return this.ticketsByID.get(id);
@@ -1353,7 +1359,7 @@ function dfsBlocked(id, state, visited, inStack, findings) {
 }
 
 // src/core/init.ts
-import { mkdir, stat as stat2 } from "fs/promises";
+import { mkdir, stat as stat2, readdir as readdir3, readFile as readFile3 } from "fs/promises";
 import { join as join4, resolve as resolve3 } from "path";
 async function initProject(root, options) {
   const absRoot = resolve3(root);
@@ -1410,6 +1416,25 @@ async function initProject(root, options) {
   };
   await writeConfig(config, absRoot);
   await writeRoadmap(roadmap, absRoot);
+  const warnings = [];
+  if (options.force && exists) {
+    for (const subdir of ["tickets", "issues"]) {
+      const dir = join4(wrapDir, subdir);
+      try {
+        const files = await readdir3(dir);
+        for (const f of files) {
+          if (!f.endsWith(".json")) continue;
+          try {
+            const content = await readFile3(join4(dir, f), "utf-8");
+            JSON.parse(content);
+          } catch {
+            warnings.push(`.story/${subdir}/${f}`);
+          }
+        }
+      } catch {
+      }
+    }
+  }
   return {
     root: absRoot,
     created: [
@@ -1418,7 +1443,8 @@ async function initProject(root, options) {
       ".story/tickets/",
       ".story/issues/",
       ".story/handovers/"
-    ]
+    ],
+    warnings
   };
 }
 
@@ -1467,9 +1493,9 @@ function formatStatus(state, format) {
   const phases = phasesWithStatus(state);
   const data = {
     project: state.config.project,
-    totalTickets: state.totalTicketCount,
-    completeTickets: state.completeTicketCount,
-    openTickets: state.openTicketCount,
+    totalTickets: state.leafTicketCount,
+    completeTickets: state.completeLeafTicketCount,
+    openTickets: state.leafTicketCount - state.completeLeafTicketCount,
     blockedTickets: state.blockedCount,
     openIssues: state.openIssueCount,
     handovers: state.handoverFilenames.length,
@@ -1486,7 +1512,7 @@ function formatStatus(state, format) {
   const lines = [
     `# ${escapeMarkdownInline(state.config.project)}`,
     "",
-    `Tickets: ${state.completeTicketCount}/${state.totalTicketCount} complete, ${state.blockedCount} blocked`,
+    `Tickets: ${state.completeLeafTicketCount}/${state.leafTicketCount} complete, ${state.blockedCount} blocked`,
     `Issues: ${state.openIssueCount} open`,
     `Handovers: ${state.handoverFilenames.length}`,
     "",
@@ -1708,7 +1734,11 @@ function formatInitResult(result, format) {
   if (format === "json") {
     return JSON.stringify(successEnvelope(result), null, 2);
   }
-  return [`Initialized .story/ at ${escapeMarkdownInline(result.root)}`, "", ...result.created.map((f) => `  ${f}`)].join("\n");
+  const lines = [`Initialized .story/ at ${escapeMarkdownInline(result.root)}`, "", ...result.created.map((f) => `  ${f}`)];
+  if (result.warnings.length > 0) {
+    lines.push("", `Warning: ${result.warnings.length} corrupt file(s) found. Run \`claudestory validate\` to inspect.`);
+  }
+  return lines.join("\n");
 }
 function formatHandoverList(filenames, format) {
   if (format === "json") {

package/dist/mcp.js

@@ -171,6 +171,8 @@ var ProjectState = class _ProjectState {
   // --- Derived (public readonly) ---
   umbrellaIDs;
   leafTickets;
+  leafTicketCount;
+  completeLeafTicketCount;
   // --- Derived (private) ---
   leafTicketsByPhase;
   childrenByParent;
@@ -197,6 +199,10 @@ var ProjectState = class _ProjectState {
     }
     this.umbrellaIDs = parentIDs;
     this.leafTickets = input.tickets.filter((t) => !parentIDs.has(t.id));
+    this.leafTicketCount = this.leafTickets.length;
+    this.completeLeafTicketCount = this.leafTickets.filter(
+      (t) => t.status === "complete"
+    ).length;
     const byPhase = /* @__PURE__ */ new Map();
     for (const t of this.leafTickets) {
       const phase = t.phase;
@@ -302,7 +308,7 @@ var ProjectState = class _ProjectState {
     });
   }
   get blockedCount() {
-    return this.tickets.filter((t) => this.isBlocked(t)).length;
+    return this.leafTickets.filter((t) => t.status !== "complete" && this.isBlocked(t)).length;
   }
   ticketByID(id) {
     return this.ticketsByID.get(id);
@@ -853,9 +859,9 @@ function formatStatus(state, format) {
   const phases = phasesWithStatus(state);
   const data = {
     project: state.config.project,
-    totalTickets: state.totalTicketCount,
-    completeTickets: state.completeTicketCount,
-    openTickets: state.openTicketCount,
+    totalTickets: state.leafTicketCount,
+    completeTickets: state.completeLeafTicketCount,
+    openTickets: state.leafTicketCount - state.completeLeafTicketCount,
     blockedTickets: state.blockedCount,
     openIssues: state.openIssueCount,
     handovers: state.handoverFilenames.length,
@@ -872,7 +878,7 @@ function formatStatus(state, format) {
   const lines = [
     `# ${escapeMarkdownInline(state.config.project)}`,
     "",
-    `Tickets: ${state.completeTicketCount}/${state.totalTicketCount} complete, ${state.blockedCount} blocked`,
+    `Tickets: ${state.completeLeafTicketCount}/${state.leafTicketCount} complete, ${state.blockedCount} blocked`,
     `Issues: ${state.openIssueCount} open`,
     `Handovers: ${state.handoverFilenames.length}`,
     "",
@@ -1702,7 +1708,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.0";
+var version = "0.1.2";
 function pinProjectRoot() {
   const envRoot = process.env[ENV_VAR2];
   if (envRoot) {

package/package.json

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