@anthropologies/claudestory 0.1.34 → 0.1.35

package/dist/cli.js

@@ -3382,7 +3382,20 @@ function validateParentTicket(parentId, ticketId, state) {
     throw new CliValidationError("invalid_input", `Parent ticket ${parentId} not found`);
   }
 }
+function buildErrorMultiset(findings) {
+  const counts = /* @__PURE__ */ new Map();
+  const messages = /* @__PURE__ */ new Map();
+  for (const f of findings) {
+    if (f.level !== "error") continue;
+    const key = `${f.code}|${f.entity ?? ""}|${f.message}`;
+    counts.set(key, (counts.get(key) ?? 0) + 1);
+    messages.set(key, f.message);
+  }
+  return { counts, messages };
+}
 function validatePostWriteState(candidate, state, isCreate) {
+  const preResult = validateProject(state);
+  const { counts: preErrors } = buildErrorMultiset(preResult.findings);
   const existingTickets = [...state.tickets];
   if (isCreate) {
     existingTickets.push(candidate);
@@ -3399,11 +3412,17 @@ function validatePostWriteState(candidate, state, isCreate) {
     config: state.config,
     handoverFilenames: [...state.handoverFilenames]
   });
-  const result = validateProject(postState);
-  if (!result.valid) {
-    const errors = result.findings.filter((f) => f.level === "error");
-    const msg = errors.map((f) => f.message).join("; ");
-    throw new CliValidationError("validation_failed", `Write would create invalid state: ${msg}`);
+  const postResult = validateProject(postState);
+  const { counts: postErrors, messages: postMessages } = buildErrorMultiset(postResult.findings);
+  const newErrors = [];
+  for (const [key, postCount] of postErrors) {
+    const preCount = preErrors.get(key) ?? 0;
+    if (postCount > preCount) {
+      newErrors.push(postMessages.get(key) ?? key);
+    }
+  }
+  if (newErrors.length > 0) {
+    throw new CliValidationError("validation_failed", `Write would create invalid state: ${newErrors.join("; ")}`);
   }
 }
 async function handleTicketCreate(args, format, root) {
@@ -3587,7 +3606,20 @@ function validateRelatedTickets(ids, state) {
     }
   }
 }
+function buildErrorMultiset2(findings) {
+  const counts = /* @__PURE__ */ new Map();
+  const messages = /* @__PURE__ */ new Map();
+  for (const f of findings) {
+    if (f.level !== "error") continue;
+    const key = `${f.code}|${f.entity ?? ""}|${f.message}`;
+    counts.set(key, (counts.get(key) ?? 0) + 1);
+    messages.set(key, f.message);
+  }
+  return { counts, messages };
+}
 function validatePostWriteIssueState(candidate, state, isCreate) {
+  const preResult = validateProject(state);
+  const { counts: preErrors } = buildErrorMultiset2(preResult.findings);
   const existingIssues = [...state.issues];
   if (isCreate) {
     existingIssues.push(candidate);
@@ -3604,11 +3636,17 @@ function validatePostWriteIssueState(candidate, state, isCreate) {
     config: state.config,
     handoverFilenames: [...state.handoverFilenames]
   });
-  const result = validateProject(postState);
-  if (!result.valid) {
-    const errors = result.findings.filter((f) => f.level === "error");
-    const msg = errors.map((f) => f.message).join("; ");
-    throw new CliValidationError("validation_failed", `Write would create invalid state: ${msg}`);
+  const postResult = validateProject(postState);
+  const { counts: postErrors, messages: postMessages } = buildErrorMultiset2(postResult.findings);
+  const newErrors = [];
+  for (const [key, postCount] of postErrors) {
+    const preCount = preErrors.get(key) ?? 0;
+    if (postCount > preCount) {
+      newErrors.push(postMessages.get(key) ?? key);
+    }
+  }
+  if (newErrors.length > 0) {
+    throw new CliValidationError("validation_failed", `Write would create invalid state: ${newErrors.join("; ")}`);
   }
 }
 async function handleIssueCreate(args, format, root) {
@@ -10373,7 +10411,7 @@ var init_mcp = __esm({
     init_init();
     ENV_VAR2 = "CLAUDESTORY_PROJECT_ROOT";
     CONFIG_PATH2 = ".story/config.json";
-    version = "0.1.34";
+    version = "0.1.35";
     main().catch((err) => {
       process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}
 `);
@@ -10521,6 +10559,102 @@ var init_run = __esm({
   }
 });
 
+// src/cli/commands/repair.ts
+function computeRepairs(state, warnings) {
+  const integrityWarning = warnings.find(
+    (w) => INTEGRITY_WARNING_TYPES.includes(w.type)
+  );
+  if (integrityWarning) {
+    return {
+      fixes: [],
+      error: `Cannot repair: data integrity issue in ${integrityWarning.file}: ${integrityWarning.message}. Fix the corrupt file first, then retry.`,
+      tickets: [],
+      issues: []
+    };
+  }
+  const fixes = [];
+  const modifiedTickets = [];
+  const modifiedIssues = [];
+  const ticketIDs = new Set(state.tickets.map((t) => t.id));
+  const phaseIDs = new Set(state.roadmap.phases.map((p) => {
+    const id = p.id;
+    return typeof id === "object" && id !== null ? id.rawValue ?? String(id) : String(id);
+  }));
+  for (const ticket of state.tickets) {
+    let modified = false;
+    let blockedBy = [...ticket.blockedBy];
+    let parentTicket = ticket.parentTicket;
+    let phase = ticket.phase;
+    const validBlockedBy = blockedBy.filter((ref) => ticketIDs.has(ref));
+    if (validBlockedBy.length < blockedBy.length) {
+      const removed = blockedBy.filter((ref) => !ticketIDs.has(ref));
+      blockedBy = validBlockedBy;
+      modified = true;
+      fixes.push({ entity: ticket.id, field: "blockedBy", description: `Removed stale refs: ${removed.join(", ")}` });
+    }
+    if (parentTicket && !ticketIDs.has(parentTicket)) {
+      fixes.push({ entity: ticket.id, field: "parentTicket", description: `Cleared stale ref: ${parentTicket}` });
+      parentTicket = null;
+      modified = true;
+    }
+    const phaseRaw = typeof phase === "object" && phase !== null ? phase.rawValue ?? String(phase) : phase != null ? String(phase) : null;
+    if (phaseRaw && !phaseIDs.has(phaseRaw)) {
+      fixes.push({ entity: ticket.id, field: "phase", description: `Cleared stale phase: ${phaseRaw}` });
+      phase = null;
+      modified = true;
+    }
+    if (modified) {
+      modifiedTickets.push({ ...ticket, blockedBy, parentTicket, phase });
+    }
+  }
+  for (const issue of state.issues) {
+    let modified = false;
+    let relatedTickets = [...issue.relatedTickets];
+    let phase = issue.phase;
+    const validRelated = relatedTickets.filter((ref) => ticketIDs.has(ref));
+    if (validRelated.length < relatedTickets.length) {
+      const removed = relatedTickets.filter((ref) => !ticketIDs.has(ref));
+      relatedTickets = validRelated;
+      modified = true;
+      fixes.push({ entity: issue.id, field: "relatedTickets", description: `Removed stale refs: ${removed.join(", ")}` });
+    }
+    const issuePhaseRaw = typeof phase === "object" && phase !== null ? phase.rawValue ?? String(phase) : phase != null ? String(phase) : null;
+    if (issuePhaseRaw && !phaseIDs.has(issuePhaseRaw)) {
+      fixes.push({ entity: issue.id, field: "phase", description: `Cleared stale phase: ${issuePhaseRaw}` });
+      phase = null;
+      modified = true;
+    }
+    if (modified) {
+      modifiedIssues.push({ ...issue, relatedTickets, phase });
+    }
+  }
+  return { fixes, tickets: modifiedTickets, issues: modifiedIssues };
+}
+function handleRepair(ctx, dryRun) {
+  const { fixes, error } = computeRepairs(ctx.state, ctx.warnings);
+  if (error) {
+    return { output: error, errorCode: "project_corrupt" };
+  }
+  if (fixes.length === 0) {
+    return { output: "No stale references found. Project is clean." };
+  }
+  const lines = [`Found ${fixes.length} stale reference(s)${dryRun ? " (dry run)" : ""}:`, ""];
+  for (const fix of fixes) {
+    lines.push(`- ${fix.entity}.${fix.field}: ${fix.description}`);
+  }
+  if (dryRun) {
+    lines.push("", "Run without --dry-run to apply fixes.");
+  }
+  return { output: lines.join("\n") };
+}
+var init_repair = __esm({
+  "src/cli/commands/repair.ts"() {
+    "use strict";
+    init_esm_shims();
+    init_errors();
+  }
+});
+
 // src/cli/commands/init.ts
 import { basename as basename2 } from "path";
 function registerInitCommand(yargs) {
@@ -11605,6 +11739,7 @@ __export(register_exports, {
   registerRecapCommand: () => registerRecapCommand,
   registerRecommendCommand: () => registerRecommendCommand,
   registerReferenceCommand: () => registerReferenceCommand,
+  registerRepairCommand: () => registerRepairCommand,
   registerSelftestCommand: () => registerSelftestCommand,
   registerSessionCommand: () => registerSessionCommand,
   registerSetupSkillCommand: () => registerSetupSkillCommand,
@@ -11635,6 +11770,47 @@ function registerValidateCommand(yargs) {
     }
   );
 }
+function registerRepairCommand(yargs) {
+  return yargs.command(
+    "repair",
+    "Fix stale references in .story/ data",
+    (y) => y.option("dry-run", { type: "boolean", default: false, describe: "Show what would be fixed without writing" }),
+    async (argv) => {
+      const dryRun = argv["dry-run"];
+      if (dryRun) {
+        await runReadCommand("md", (ctx) => handleRepair(ctx, true));
+      } else {
+        const { withProjectLock: withProjectLock2, writeTicketUnlocked: writeTicketUnlocked2, writeIssueUnlocked: writeIssueUnlocked2, runTransactionUnlocked: runTransactionUnlocked2 } = await Promise.resolve().then(() => (init_project_loader(), project_loader_exports));
+        const root = (await Promise.resolve().then(() => (init_project_root_discovery(), project_root_discovery_exports))).discoverProjectRoot();
+        await withProjectLock2(root, { strict: false }, async ({ state, warnings }) => {
+          const result = computeRepairs(state, warnings);
+          if (result.error) {
+            writeOutput(result.error);
+            process.exitCode = ExitCode.USER_ERROR;
+            return;
+          }
+          if (result.fixes.length === 0) {
+            writeOutput("No stale references found. Project is clean.");
+            return;
+          }
+          await runTransactionUnlocked2(root, async () => {
+            for (const ticket of result.tickets) {
+              await writeTicketUnlocked2(ticket, root);
+            }
+            for (const issue of result.issues) {
+              await writeIssueUnlocked2(issue, root);
+            }
+          });
+          const lines = [`Fixed ${result.fixes.length} stale reference(s):`, ""];
+          for (const fix of result.fixes) {
+            lines.push(`- ${fix.entity}.${fix.field}: ${fix.description}`);
+          }
+          writeOutput(lines.join("\n"));
+        });
+      }
+    }
+  );
+}
 function registerHandoverCommand(yargs) {
   return yargs.command(
     "handover",
@@ -13606,6 +13782,7 @@ var init_register = __esm({
     init_output_formatter();
     init_status();
     init_validate();
+    init_repair();
     init_handover();
     init_blocker();
     init_ticket2();
@@ -13655,9 +13832,10 @@ async function runCli() {
     registerSetupSkillCommand: registerSetupSkillCommand2,
     registerHookStatusCommand: registerHookStatusCommand2,
     registerConfigCommand: registerConfigCommand2,
-    registerSessionCommand: registerSessionCommand2
+    registerSessionCommand: registerSessionCommand2,
+    registerRepairCommand: registerRepairCommand2
   } = await Promise.resolve().then(() => (init_register(), register_exports));
-  const version2 = "0.1.34";
+  const version2 = "0.1.35";
   class HandledError extends Error {
     constructor() {
       super("HANDLED_ERROR");
@@ -13689,6 +13867,7 @@ async function runCli() {
   cli = registerHandoverCommand2(cli);
   cli = registerBlockerCommand2(cli);
   cli = registerValidateCommand2(cli);
+  cli = registerRepairCommand2(cli);
   cli = registerSnapshotCommand2(cli);
   cli = registerRecapCommand2(cli);
   cli = registerExportCommand2(cli);

package/dist/mcp.js

@@ -2984,7 +2984,20 @@ function validateRelatedTickets(ids, state) {
     }
   }
 }
+function buildErrorMultiset2(findings) {
+  const counts = /* @__PURE__ */ new Map();
+  const messages = /* @__PURE__ */ new Map();
+  for (const f of findings) {
+    if (f.level !== "error") continue;
+    const key = `${f.code}|${f.entity ?? ""}|${f.message}`;
+    counts.set(key, (counts.get(key) ?? 0) + 1);
+    messages.set(key, f.message);
+  }
+  return { counts, messages };
+}
 function validatePostWriteIssueState(candidate, state, isCreate) {
+  const preResult = validateProject(state);
+  const { counts: preErrors } = buildErrorMultiset2(preResult.findings);
   const existingIssues = [...state.issues];
   if (isCreate) {
     existingIssues.push(candidate);
@@ -3001,11 +3014,17 @@ function validatePostWriteIssueState(candidate, state, isCreate) {
     config: state.config,
     handoverFilenames: [...state.handoverFilenames]
   });
-  const result = validateProject(postState);
-  if (!result.valid) {
-    const errors = result.findings.filter((f) => f.level === "error");
-    const msg = errors.map((f) => f.message).join("; ");
-    throw new CliValidationError("validation_failed", `Write would create invalid state: ${msg}`);
+  const postResult = validateProject(postState);
+  const { counts: postErrors, messages: postMessages } = buildErrorMultiset2(postResult.findings);
+  const newErrors = [];
+  for (const [key, postCount] of postErrors) {
+    const preCount = preErrors.get(key) ?? 0;
+    if (postCount > preCount) {
+      newErrors.push(postMessages.get(key) ?? key);
+    }
+  }
+  if (newErrors.length > 0) {
+    throw new CliValidationError("validation_failed", `Write would create invalid state: ${newErrors.join("; ")}`);
   }
 }
 async function handleIssueCreate(args, format, root) {
@@ -4205,7 +4224,20 @@ function validateParentTicket(parentId, ticketId, state) {
     throw new CliValidationError("invalid_input", `Parent ticket ${parentId} not found`);
   }
 }
+function buildErrorMultiset(findings) {
+  const counts = /* @__PURE__ */ new Map();
+  const messages = /* @__PURE__ */ new Map();
+  for (const f of findings) {
+    if (f.level !== "error") continue;
+    const key = `${f.code}|${f.entity ?? ""}|${f.message}`;
+    counts.set(key, (counts.get(key) ?? 0) + 1);
+    messages.set(key, f.message);
+  }
+  return { counts, messages };
+}
 function validatePostWriteState(candidate, state, isCreate) {
+  const preResult = validateProject(state);
+  const { counts: preErrors } = buildErrorMultiset(preResult.findings);
   const existingTickets = [...state.tickets];
   if (isCreate) {
     existingTickets.push(candidate);
@@ -4222,11 +4254,17 @@ function validatePostWriteState(candidate, state, isCreate) {
     config: state.config,
     handoverFilenames: [...state.handoverFilenames]
   });
-  const result = validateProject(postState);
-  if (!result.valid) {
-    const errors = result.findings.filter((f) => f.level === "error");
-    const msg = errors.map((f) => f.message).join("; ");
-    throw new CliValidationError("validation_failed", `Write would create invalid state: ${msg}`);
+  const postResult = validateProject(postState);
+  const { counts: postErrors, messages: postMessages } = buildErrorMultiset(postResult.findings);
+  const newErrors = [];
+  for (const [key, postCount] of postErrors) {
+    const preCount = preErrors.get(key) ?? 0;
+    if (postCount > preCount) {
+      newErrors.push(postMessages.get(key) ?? key);
+    }
+  }
+  if (newErrors.length > 0) {
+    throw new CliValidationError("validation_failed", `Write would create invalid state: ${newErrors.join("; ")}`);
   }
 }
 async function handleTicketCreate(args, format, root) {
@@ -9521,7 +9559,7 @@ async function ensureGitignoreEntries(gitignorePath, entries) {
 // src/mcp/index.ts
 var ENV_VAR2 = "CLAUDESTORY_PROJECT_ROOT";
 var CONFIG_PATH2 = ".story/config.json";
-var version = "0.1.34";
+var version = "0.1.35";
 function tryDiscoverRoot() {
   const envRoot = process.env[ENV_VAR2];
   if (envRoot) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropologies/claudestory",
-  "version": "0.1.34",
+  "version": "0.1.35",
   "license": "UNLICENSED",
   "description": "Cross-session context persistence for AI coding projects. Tracks tickets, issues, roadmap, and handovers so every session builds on the last.",
   "keywords": [