@anthropologies/claudestory 0.1.33 → 0.1.34

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();
   }
@@ -5904,7 +5906,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 +8073,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 +8085,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 +8886,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 +10373,7 @@ var init_mcp = __esm({
     init_init();
     ENV_VAR2 = "CLAUDESTORY_PROJECT_ROOT";
     CONFIG_PATH2 = ".story/config.json";
-    version = "0.1.33";
+    version = "0.1.34";
     main().catch((err) => {
       process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}
 `);
@@ -13647,7 +13657,7 @@ async function runCli() {
     registerConfigCommand: registerConfigCommand2,
     registerSessionCommand: registerSessionCommand2
   } = await Promise.resolve().then(() => (init_register(), register_exports));
-  const version2 = "0.1.33";
+  const version2 = "0.1.34";
   class HandledError extends Error {
     constructor() {
       super("HANDLED_ERROR");

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();
   }
@@ -5512,7 +5514,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 +7545,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 +7557,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 +8359,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 +9521,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.34";
 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.34",
   "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": [