@anthropologies/claudestory 0.1.33 → 0.1.35

package/dist/cli.js

@@ -298,7 +298,9 @@ var init_config = __esm({
       recipeOverrides: z7.object({
         maxTicketsPerSession: z7.number().min(0).optional(),
         compactThreshold: z7.string().optional(),
-        reviewBackends: z7.array(z7.string()).optional()
+        reviewBackends: z7.array(z7.string()).optional(),
+        handoverInterval: z7.number().min(0).optional(),
+        stages: z7.record(z7.record(z7.unknown())).optional()
       }).optional()
     }).passthrough();
   }
@@ -3380,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);
@@ -3397,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) {
@@ -3585,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);
@@ -3602,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) {
@@ -5904,7 +5944,19 @@ function resolveRecipe(recipeName, projectOverrides) {
     }
   }
   let pipeline = raw.pipeline ? [...raw.pipeline] : [...DEFAULT_PIPELINE];
-  const stages2 = raw.stages ?? {};
+  const recipeStages = raw.stages ?? {};
+  const stageOverrides = projectOverrides?.stages ?? {};
+  const stages2 = {};
+  for (const [key, value] of Object.entries(recipeStages)) {
+    const override = stageOverrides[key];
+    const safeOverride = override && typeof override === "object" && !Array.isArray(override) ? override : {};
+    stages2[key] = { ...value, ...safeOverride };
+  }
+  for (const [key, value] of Object.entries(stageOverrides)) {
+    if (!stages2[key] && value && typeof value === "object" && !Array.isArray(value)) {
+      stages2[key] = { ...value };
+    }
+  }
   if (stages2.WRITE_TESTS?.enabled) {
     const implementIdx = pipeline.indexOf("IMPLEMENT");
     if (implementIdx !== -1 && !pipeline.includes("WRITE_TESTS")) {
@@ -8059,6 +8111,9 @@ async function handleStart(root, args) {
       if (typeof overrides.compactThreshold === "string") sessionConfig.compactThreshold = overrides.compactThreshold;
       if (Array.isArray(overrides.reviewBackends)) sessionConfig.reviewBackends = overrides.reviewBackends;
       if (typeof overrides.handoverInterval === "number") sessionConfig.handoverInterval = overrides.handoverInterval;
+      if (overrides.stages && typeof overrides.stages === "object") {
+        sessionConfig.stageOverrides = overrides.stages;
+      }
     }
   } catch {
   }
@@ -8068,7 +8123,8 @@ async function handleStart(root, args) {
   const resolvedRecipe = resolveRecipe(recipe, {
     maxTicketsPerSession: sessionConfig.maxTicketsPerSession,
     compactThreshold: sessionConfig.compactThreshold,
-    reviewBackends: sessionConfig.reviewBackends
+    reviewBackends: sessionConfig.reviewBackends,
+    stages: sessionConfig.stageOverrides
   });
   const session = createSession(root, recipe, wsId, sessionConfig);
   const dir = sessionDir(root, session.sessionId);
@@ -8868,14 +8924,6 @@ async function handleCancel(root, args) {
   if (info.state.state === "SESSION_END" || info.state.status === "completed") {
     return guideError(new Error("Session already ended."));
   }
-  const CANCELLABLE_STATES = /* @__PURE__ */ new Set(["PICK_TICKET", "COMPLETE", "HANDOVER"]);
-  if (info.state.recipe === "coding" && !CANCELLABLE_STATES.has(info.state.state)) {
-    const sessionMode = info.state.mode ?? "auto";
-    const modeGuidance = sessionMode === "plan" ? "Plan mode sessions end after plan review approval \u2014 continue to that step." : sessionMode === "review" ? "Review mode sessions end after code review approval \u2014 continue to that step." : sessionMode === "guided" ? "Guided mode sessions end after ticket completion \u2014 continue to FINALIZE." : "Complete the current ticket and write a handover to end the session.";
-    return guideError(new Error(
-      `Cannot cancel a coding session from ${info.state.state}. ${modeGuidance}`
-    ));
-  }
   await recoverPendingMutation(info.dir, info.state, root);
   const cancelInfo = findSessionById(root, args.sessionId) ?? info;
   let ticketReleased = false;
@@ -10363,7 +10411,7 @@ var init_mcp = __esm({
     init_init();
     ENV_VAR2 = "CLAUDESTORY_PROJECT_ROOT";
     CONFIG_PATH2 = ".story/config.json";
-    version = "0.1.33";
+    version = "0.1.35";
     main().catch((err) => {
       process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}
 `);
@@ -10511,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) {
@@ -11595,6 +11739,7 @@ __export(register_exports, {
   registerRecapCommand: () => registerRecapCommand,
   registerRecommendCommand: () => registerRecommendCommand,
   registerReferenceCommand: () => registerReferenceCommand,
+  registerRepairCommand: () => registerRepairCommand,
   registerSelftestCommand: () => registerSelftestCommand,
   registerSessionCommand: () => registerSessionCommand,
   registerSetupSkillCommand: () => registerSetupSkillCommand,
@@ -11625,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",
@@ -13596,6 +13782,7 @@ var init_register = __esm({
     init_output_formatter();
     init_status();
     init_validate();
+    init_repair();
     init_handover();
     init_blocker();
     init_ticket2();
@@ -13645,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.33";
+  const version2 = "0.1.35";
   class HandledError extends Error {
     constructor() {
       super("HANDLED_ERROR");
@@ -13679,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/index.d.ts

@@ -348,14 +348,20 @@ declare const ConfigSchema: z.ZodObject<{
         maxTicketsPerSession: z.ZodOptional<z.ZodNumber>;
         compactThreshold: z.ZodOptional<z.ZodString>;
         reviewBackends: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        handoverInterval: z.ZodOptional<z.ZodNumber>;
+        stages: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     }, "strip", z.ZodTypeAny, {
         maxTicketsPerSession?: number | undefined;
         compactThreshold?: string | undefined;
         reviewBackends?: string[] | undefined;
+        handoverInterval?: number | undefined;
+        stages?: Record<string, Record<string, unknown>> | undefined;
     }, {
         maxTicketsPerSession?: number | undefined;
         compactThreshold?: string | undefined;
         reviewBackends?: string[] | undefined;
+        handoverInterval?: number | undefined;
+        stages?: Record<string, Record<string, unknown>> | undefined;
     }>>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     version: z.ZodNumber;
@@ -387,14 +393,20 @@ declare const ConfigSchema: z.ZodObject<{
         maxTicketsPerSession: z.ZodOptional<z.ZodNumber>;
         compactThreshold: z.ZodOptional<z.ZodString>;
         reviewBackends: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        handoverInterval: z.ZodOptional<z.ZodNumber>;
+        stages: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     }, "strip", z.ZodTypeAny, {
         maxTicketsPerSession?: number | undefined;
         compactThreshold?: string | undefined;
         reviewBackends?: string[] | undefined;
+        handoverInterval?: number | undefined;
+        stages?: Record<string, Record<string, unknown>> | undefined;
     }, {
         maxTicketsPerSession?: number | undefined;
         compactThreshold?: string | undefined;
         reviewBackends?: string[] | undefined;
+        handoverInterval?: number | undefined;
+        stages?: Record<string, Record<string, unknown>> | undefined;
     }>>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     version: z.ZodNumber;
@@ -426,14 +438,20 @@ declare const ConfigSchema: z.ZodObject<{
         maxTicketsPerSession: z.ZodOptional<z.ZodNumber>;
         compactThreshold: z.ZodOptional<z.ZodString>;
         reviewBackends: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        handoverInterval: z.ZodOptional<z.ZodNumber>;
+        stages: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     }, "strip", z.ZodTypeAny, {
         maxTicketsPerSession?: number | undefined;
         compactThreshold?: string | undefined;
         reviewBackends?: string[] | undefined;
+        handoverInterval?: number | undefined;
+        stages?: Record<string, Record<string, unknown>> | undefined;
     }, {
         maxTicketsPerSession?: number | undefined;
         compactThreshold?: string | undefined;
         reviewBackends?: string[] | undefined;
+        handoverInterval?: number | undefined;
+        stages?: Record<string, Record<string, unknown>> | undefined;
     }>>;
 }, z.ZodTypeAny, "passthrough">>;
 type Config = z.infer<typeof ConfigSchema>;
@@ -950,14 +968,20 @@ declare const SnapshotV1Schema: z.ZodObject<{
             maxTicketsPerSession: z.ZodOptional<z.ZodNumber>;
             compactThreshold: z.ZodOptional<z.ZodString>;
             reviewBackends: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            handoverInterval: z.ZodOptional<z.ZodNumber>;
+            stages: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         }, "strip", z.ZodTypeAny, {
             maxTicketsPerSession?: number | undefined;
             compactThreshold?: string | undefined;
             reviewBackends?: string[] | undefined;
+            handoverInterval?: number | undefined;
+            stages?: Record<string, Record<string, unknown>> | undefined;
         }, {
             maxTicketsPerSession?: number | undefined;
             compactThreshold?: string | undefined;
             reviewBackends?: string[] | undefined;
+            handoverInterval?: number | undefined;
+            stages?: Record<string, Record<string, unknown>> | undefined;
         }>>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         version: z.ZodNumber;
@@ -989,14 +1013,20 @@ declare const SnapshotV1Schema: z.ZodObject<{
             maxTicketsPerSession: z.ZodOptional<z.ZodNumber>;
             compactThreshold: z.ZodOptional<z.ZodString>;
             reviewBackends: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            handoverInterval: z.ZodOptional<z.ZodNumber>;
+            stages: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         }, "strip", z.ZodTypeAny, {
             maxTicketsPerSession?: number | undefined;
             compactThreshold?: string | undefined;
             reviewBackends?: string[] | undefined;
+            handoverInterval?: number | undefined;
+            stages?: Record<string, Record<string, unknown>> | undefined;
         }, {
             maxTicketsPerSession?: number | undefined;
             compactThreshold?: string | undefined;
             reviewBackends?: string[] | undefined;
+            handoverInterval?: number | undefined;
+            stages?: Record<string, Record<string, unknown>> | undefined;
         }>>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
         version: z.ZodNumber;
@@ -1028,14 +1058,20 @@ declare const SnapshotV1Schema: z.ZodObject<{
             maxTicketsPerSession: z.ZodOptional<z.ZodNumber>;
             compactThreshold: z.ZodOptional<z.ZodString>;
             reviewBackends: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            handoverInterval: z.ZodOptional<z.ZodNumber>;
+            stages: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         }, "strip", z.ZodTypeAny, {
             maxTicketsPerSession?: number | undefined;
             compactThreshold?: string | undefined;
             reviewBackends?: string[] | undefined;
+            handoverInterval?: number | undefined;
+            stages?: Record<string, Record<string, unknown>> | undefined;
         }, {
             maxTicketsPerSession?: number | undefined;
             compactThreshold?: string | undefined;
             reviewBackends?: string[] | undefined;
+            handoverInterval?: number | undefined;
+            stages?: Record<string, Record<string, unknown>> | undefined;
         }>>;
     }, z.ZodTypeAny, "passthrough">>;
     roadmap: z.ZodObject<{
@@ -1334,40 +1370,15 @@ declare const SnapshotV1Schema: z.ZodObject<{
         file: z.ZodString;
         message: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        type: string;
         message: string;
+        type: string;
         file: string;
     }, {
-        type: string;
         message: string;
+        type: string;
         file: string;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
-    version: 1;
-    config: {
-        version: number;
-        type: string;
-        language: string;
-        project: string;
-        features: {
-            issues: boolean;
-            tickets: boolean;
-            handovers: boolean;
-            roadmap: boolean;
-            reviews: boolean;
-        } & {
-            [k: string]: unknown;
-        };
-        schemaVersion?: number | undefined;
-        recipe?: string | undefined;
-        recipeOverrides?: {
-            maxTicketsPerSession?: number | undefined;
-            compactThreshold?: string | undefined;
-            reviewBackends?: string[] | undefined;
-        } | undefined;
-    } & {
-        [k: string]: unknown;
-    };
     issues: z.objectOutputType<{
         id: z.ZodString;
         title: z.ZodString;
@@ -1404,8 +1415,8 @@ declare const SnapshotV1Schema: z.ZodObject<{
         claimedBySession: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.ZodTypeAny, "passthrough">[];
     roadmap: {
-        date: string;
         title: string;
+        date: string;
         phases: z.objectOutputType<{
             id: z.ZodString;
             label: z.ZodString;
@@ -1423,6 +1434,7 @@ declare const SnapshotV1Schema: z.ZodObject<{
     } & {
         [k: string]: unknown;
     };
+    version: 1;
     project: string;
     notes: z.objectOutputType<{
         id: z.ZodString;
@@ -1448,19 +1460,11 @@ declare const SnapshotV1Schema: z.ZodObject<{
         status: z.ZodEnum<["active", "deprecated", "superseded"]>;
     }, z.ZodTypeAny, "passthrough">[];
     createdAt: string;
-    handoverFilenames: string[];
-    warnings?: {
-        type: string;
-        message: string;
-        file: string;
-    }[] | undefined;
-}, {
-    version: 1;
     config: {
-        version: number;
         type: string;
-        language: string;
+        version: number;
         project: string;
+        language: string;
         features: {
             issues: boolean;
             tickets: boolean;
@@ -1476,10 +1480,19 @@ declare const SnapshotV1Schema: z.ZodObject<{
             maxTicketsPerSession?: number | undefined;
             compactThreshold?: string | undefined;
             reviewBackends?: string[] | undefined;
+            handoverInterval?: number | undefined;
+            stages?: Record<string, Record<string, unknown>> | undefined;
         } | undefined;
     } & {
         [k: string]: unknown;
     };
+    handoverFilenames: string[];
+    warnings?: {
+        message: string;
+        type: string;
+        file: string;
+    }[] | undefined;
+}, {
     issues: z.objectInputType<{
         id: z.ZodString;
         title: z.ZodString;
@@ -1516,8 +1529,8 @@ declare const SnapshotV1Schema: z.ZodObject<{
         claimedBySession: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.ZodTypeAny, "passthrough">[];
     roadmap: {
-        date: string;
         title: string;
+        date: string;
         phases: z.objectInputType<{
             id: z.ZodString;
             label: z.ZodString;
@@ -1535,8 +1548,35 @@ declare const SnapshotV1Schema: z.ZodObject<{
     } & {
         [k: string]: unknown;
     };
+    version: 1;
     project: string;
     createdAt: string;
+    config: {
+        type: string;
+        version: number;
+        project: string;
+        language: string;
+        features: {
+            issues: boolean;
+            tickets: boolean;
+            handovers: boolean;
+            roadmap: boolean;
+            reviews: boolean;
+        } & {
+            [k: string]: unknown;
+        };
+        schemaVersion?: number | undefined;
+        recipe?: string | undefined;
+        recipeOverrides?: {
+            maxTicketsPerSession?: number | undefined;
+            compactThreshold?: string | undefined;
+            reviewBackends?: string[] | undefined;
+            handoverInterval?: number | undefined;
+            stages?: Record<string, Record<string, unknown>> | undefined;
+        } | undefined;
+    } & {
+        [k: string]: unknown;
+    };
     notes?: z.objectInputType<{
         id: z.ZodString;
         title: z.ZodNullable<z.ZodString>;
@@ -1561,8 +1601,8 @@ declare const SnapshotV1Schema: z.ZodObject<{
         status: z.ZodEnum<["active", "deprecated", "superseded"]>;
     }, z.ZodTypeAny, "passthrough">[] | undefined;
     warnings?: {
-        type: string;
         message: string;
+        type: string;
         file: string;
     }[] | undefined;
     handoverFilenames?: string[] | undefined;

package/dist/index.js

@@ -140,7 +140,9 @@ var ConfigSchema = z6.object({
   recipeOverrides: z6.object({
     maxTicketsPerSession: z6.number().min(0).optional(),
     compactThreshold: z6.string().optional(),
-    reviewBackends: z6.array(z6.string()).optional()
+    reviewBackends: z6.array(z6.string()).optional(),
+    handoverInterval: z6.number().min(0).optional(),
+    stages: z6.record(z6.record(z6.unknown())).optional()
   }).optional()
 }).passthrough();
 

package/dist/mcp.js

@@ -240,7 +240,9 @@ var init_config = __esm({
       recipeOverrides: z7.object({
         maxTicketsPerSession: z7.number().min(0).optional(),
         compactThreshold: z7.string().optional(),
-        reviewBackends: z7.array(z7.string()).optional()
+        reviewBackends: z7.array(z7.string()).optional(),
+        handoverInterval: z7.number().min(0).optional(),
+        stages: z7.record(z7.record(z7.unknown())).optional()
       }).optional()
     }).passthrough();
   }
@@ -2982,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);
@@ -2999,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) {
@@ -4203,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);
@@ -4220,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) {
@@ -5512,7 +5552,19 @@ function resolveRecipe(recipeName, projectOverrides) {
     }
   }
   let pipeline = raw.pipeline ? [...raw.pipeline] : [...DEFAULT_PIPELINE];
-  const stages2 = raw.stages ?? {};
+  const recipeStages = raw.stages ?? {};
+  const stageOverrides = projectOverrides?.stages ?? {};
+  const stages2 = {};
+  for (const [key, value] of Object.entries(recipeStages)) {
+    const override = stageOverrides[key];
+    const safeOverride = override && typeof override === "object" && !Array.isArray(override) ? override : {};
+    stages2[key] = { ...value, ...safeOverride };
+  }
+  for (const [key, value] of Object.entries(stageOverrides)) {
+    if (!stages2[key] && value && typeof value === "object" && !Array.isArray(value)) {
+      stages2[key] = { ...value };
+    }
+  }
   if (stages2.WRITE_TESTS?.enabled) {
     const implementIdx = pipeline.indexOf("IMPLEMENT");
     if (implementIdx !== -1 && !pipeline.includes("WRITE_TESTS")) {
@@ -7531,6 +7583,9 @@ async function handleStart(root, args) {
       if (typeof overrides.compactThreshold === "string") sessionConfig.compactThreshold = overrides.compactThreshold;
       if (Array.isArray(overrides.reviewBackends)) sessionConfig.reviewBackends = overrides.reviewBackends;
       if (typeof overrides.handoverInterval === "number") sessionConfig.handoverInterval = overrides.handoverInterval;
+      if (overrides.stages && typeof overrides.stages === "object") {
+        sessionConfig.stageOverrides = overrides.stages;
+      }
     }
   } catch {
   }
@@ -7540,7 +7595,8 @@ async function handleStart(root, args) {
   const resolvedRecipe = resolveRecipe(recipe, {
     maxTicketsPerSession: sessionConfig.maxTicketsPerSession,
     compactThreshold: sessionConfig.compactThreshold,
-    reviewBackends: sessionConfig.reviewBackends
+    reviewBackends: sessionConfig.reviewBackends,
+    stages: sessionConfig.stageOverrides
   });
   const session = createSession(root, recipe, wsId, sessionConfig);
   const dir = sessionDir(root, session.sessionId);
@@ -8341,14 +8397,6 @@ async function handleCancel(root, args) {
   if (info.state.state === "SESSION_END" || info.state.status === "completed") {
     return guideError(new Error("Session already ended."));
   }
-  const CANCELLABLE_STATES = /* @__PURE__ */ new Set(["PICK_TICKET", "COMPLETE", "HANDOVER"]);
-  if (info.state.recipe === "coding" && !CANCELLABLE_STATES.has(info.state.state)) {
-    const sessionMode = info.state.mode ?? "auto";
-    const modeGuidance = sessionMode === "plan" ? "Plan mode sessions end after plan review approval \u2014 continue to that step." : sessionMode === "review" ? "Review mode sessions end after code review approval \u2014 continue to that step." : sessionMode === "guided" ? "Guided mode sessions end after ticket completion \u2014 continue to FINALIZE." : "Complete the current ticket and write a handover to end the session.";
-    return guideError(new Error(
-      `Cannot cancel a coding session from ${info.state.state}. ${modeGuidance}`
-    ));
-  }
   await recoverPendingMutation(info.dir, info.state, root);
   const cancelInfo = findSessionById(root, args.sessionId) ?? info;
   let ticketReleased = false;
@@ -9511,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.33";
+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.33",
+  "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": [