@anthropologies/claudestory 0.1.32 → 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();
   }
@@ -5021,6 +5023,7 @@ var init_session_types = __esm({
       "WRITE_TESTS",
       "TEST",
       "CODE_REVIEW",
+      "BUILD",
       "VERIFY",
       "FINALIZE",
       "COMPACT",
@@ -5046,6 +5049,7 @@ var init_session_types = __esm({
       "WRITE_TESTS",
       "TEST",
       "CODE_REVIEW",
+      "BUILD",
       "VERIFY",
       "FINALIZE",
       "COMPACT",
@@ -5196,6 +5200,7 @@ var init_session_types = __esm({
       }).nullable().default(null),
       testRetryCount: z9.number().default(0),
       writeTestsRetryCount: z9.number().default(0),
+      buildRetryCount: z9.number().default(0),
       verifyRetryCount: z9.number().default(0),
       verifyAutoDetected: z9.boolean().default(false),
       // T-128: Resolved recipe (frozen at session start, survives compact/resume)
@@ -5901,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")) {
@@ -5914,6 +5931,12 @@ function resolveRecipe(recipeName, projectOverrides) {
       pipeline.splice(codeReviewIdx + 1, 0, "VERIFY");
     }
   }
+  if (stages2.BUILD?.enabled) {
+    const finalizeIdx = pipeline.indexOf("FINALIZE");
+    if (finalizeIdx !== -1 && !pipeline.includes("BUILD")) {
+      pipeline.splice(finalizeIdx, 0, "BUILD");
+    }
+  }
   if (stages2.TEST?.enabled) {
     const implementIdx = pipeline.indexOf("IMPLEMENT");
     if (implementIdx !== -1 && !pipeline.includes("TEST")) {
@@ -6526,7 +6549,8 @@ var init_implement = __esm({
           ].join("\n"),
           reminders: [
             "Follow the plan exactly. Do NOT deviate without re-planning.",
-            "Do NOT ask the user for confirmation."
+            "Do NOT ask the user for confirmation.",
+            "If you discover pre-existing bugs, failing tests not caused by your changes, or other out-of-scope problems, file them as issues using claudestory_issue_create. Do not fix them inline."
           ],
           transitionedFrom: ctx.state.previousState ?? void 0
         };
@@ -6804,12 +6828,16 @@ var init_code_review = __esm({
             "",
             `Capture the diff with: ${diffCommand}`,
             "",
-            "**IMPORTANT:** Pass the FULL unified diff output to the reviewer. Do NOT summarize, compress, or truncate the diff.",
+            "**IMPORTANT:** Pass the FULL unified diff to the reviewer. For diffs over ~500 lines, use file-scoped chunks (`git diff <mergebase> -- <filepath>`) across separate calls (pass the same session_id). Do NOT summarize or truncate any individual chunk.",
             "",
             `Run a code review using **${reviewer}**.`,
             "When done, report verdict and findings."
           ].join("\n"),
-          reminders: [diffReminder, "Do NOT compress or summarize the diff."],
+          reminders: [
+            diffReminder,
+            "Do NOT compress or summarize the diff.",
+            "If the reviewer flags pre-existing issues unrelated to your changes, file them as issues using claudestory_issue_create with severity and impact. Do not fix them in this ticket."
+          ],
           transitionedFrom: ctx.state.previousState ?? void 0
         };
       }
@@ -6924,6 +6952,95 @@ var init_code_review = __esm({
   }
 });
 
+// src/autonomous/stages/build.ts
+var MAX_BUILD_RETRIES, BuildStage;
+var init_build = __esm({
+  "src/autonomous/stages/build.ts"() {
+    "use strict";
+    init_esm_shims();
+    MAX_BUILD_RETRIES = 2;
+    BuildStage = class {
+      id = "BUILD";
+      skip(ctx) {
+        const buildConfig = ctx.recipe.stages?.BUILD;
+        return !buildConfig?.enabled;
+      }
+      async enter(ctx) {
+        const buildConfig = ctx.recipe.stages?.BUILD;
+        const command = buildConfig?.command ?? "npm run build";
+        const retryCount = ctx.state.buildRetryCount ?? 0;
+        return {
+          instruction: [
+            `# Build${retryCount > 0 ? ` (retry ${retryCount}/${MAX_BUILD_RETRIES})` : ""}`,
+            "",
+            `Run the build: \`${command}\``,
+            "",
+            "Report the results with:",
+            "```json",
+            `{ "sessionId": "${ctx.state.sessionId}", "action": "report", "report": { "completedAction": "build_done", "notes": "<exit code and summary>" } }`,
+            "```",
+            "",
+            "Include the exit code (0 = pass, non-0 = fail) and any error output in notes."
+          ].join("\n"),
+          reminders: ["Run the FULL build, not a partial or dev-mode build."],
+          transitionedFrom: ctx.state.previousState ?? void 0
+        };
+      }
+      async report(ctx, report) {
+        const notes = report.notes ?? "";
+        const retryCount = ctx.state.buildRetryCount ?? 0;
+        const exitCodeMatch = notes.match(/exit\s*(?:code[:\s]*)?\s*(\d+)/i);
+        if (!exitCodeMatch) {
+          const nextRetry = retryCount + 1;
+          if (nextRetry > MAX_BUILD_RETRIES) {
+            ctx.writeState({ buildRetryCount: 0 });
+            ctx.appendEvent("build_parse_exhausted", { retryCount: nextRetry });
+            return {
+              action: "advance",
+              result: {
+                instruction: `Could not parse build exit code after ${MAX_BUILD_RETRIES} retries. Proceeding, but build status is unknown.`,
+                reminders: ["Mention unknown build status in the commit message."]
+              }
+            };
+          }
+          ctx.writeState({ buildRetryCount: nextRetry });
+          return { action: "retry", instruction: 'Could not parse exit code from notes. Include "exit code: 0" (or non-zero) in your notes.' };
+        }
+        const exitCode = parseInt(exitCodeMatch[1], 10);
+        if (exitCode === 0) {
+          ctx.writeState({ buildRetryCount: 0 });
+          ctx.appendEvent("build_passed", { retryCount, notes: notes.slice(0, 200) });
+          return { action: "advance" };
+        }
+        if (retryCount < MAX_BUILD_RETRIES) {
+          ctx.writeState({ buildRetryCount: retryCount + 1 });
+          ctx.appendEvent("build_failed_retry", { retryCount: retryCount + 1, notes: notes.slice(0, 200) });
+          return {
+            action: "back",
+            target: "IMPLEMENT",
+            reason: `Build failed (attempt ${retryCount + 1}/${MAX_BUILD_RETRIES}). Fix the build errors.`
+          };
+        }
+        ctx.writeState({ buildRetryCount: 0 });
+        ctx.appendEvent("build_failed_exhausted", { retryCount, notes: notes.slice(0, 200) });
+        return {
+          action: "advance",
+          result: {
+            instruction: [
+              "# Build Failed - Proceeding",
+              "",
+              `Build failed after ${MAX_BUILD_RETRIES} retries. Proceeding but build errors remain.`,
+              "",
+              "Document the build failure in the commit message."
+            ].join("\n"),
+            reminders: ["Mention build failure in the commit message."]
+          }
+        };
+      }
+    };
+  }
+});
+
 // src/autonomous/stages/verify.ts
 function exhaustionAction2(ctx) {
   ctx.writeState({ verifyRetryCount: 0 });
@@ -7733,6 +7850,7 @@ var init_stages = __esm({
     init_write_tests();
     init_test();
     init_code_review();
+    init_build();
     init_verify();
     init_finalize();
     init_complete();
@@ -7746,6 +7864,7 @@ var init_stages = __esm({
     registerStage(new WriteTestsStage());
     registerStage(new TestStage());
     registerStage(new CodeReviewStage());
+    registerStage(new BuildStage());
     registerStage(new VerifyStage());
     registerStage(new FinalizeStage());
     registerStage(new CompleteStage());
@@ -7954,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 {
   }
@@ -7963,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);
@@ -8763,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;
@@ -10258,7 +10373,7 @@ var init_mcp = __esm({
     init_init();
     ENV_VAR2 = "CLAUDESTORY_PROJECT_ROOT";
     CONFIG_PATH2 = ".story/config.json";
-    version = "0.1.32";
+    version = "0.1.34";
     main().catch((err) => {
       process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}
 `);
@@ -13542,7 +13657,7 @@ async function runCli() {
     registerConfigCommand: registerConfigCommand2,
     registerSessionCommand: registerSessionCommand2
   } = await Promise.resolve().then(() => (init_register(), register_exports));
-  const version2 = "0.1.32";
+  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<{
@@ -1444,6 +1480,8 @@ 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;
@@ -1533,6 +1571,8 @@ 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;

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();
   }
@@ -3488,6 +3490,7 @@ var init_session_types = __esm({
       "WRITE_TESTS",
       "TEST",
       "CODE_REVIEW",
+      "BUILD",
       "VERIFY",
       "FINALIZE",
       "COMPACT",
@@ -3638,6 +3641,7 @@ var init_session_types = __esm({
       }).nullable().default(null),
       testRetryCount: z9.number().default(0),
       writeTestsRetryCount: z9.number().default(0),
+      buildRetryCount: z9.number().default(0),
       verifyRetryCount: z9.number().default(0),
       verifyAutoDetected: z9.boolean().default(false),
       // T-128: Resolved recipe (frozen at session start, survives compact/resume)
@@ -5510,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")) {
@@ -5523,6 +5539,12 @@ function resolveRecipe(recipeName, projectOverrides) {
       pipeline.splice(codeReviewIdx + 1, 0, "VERIFY");
     }
   }
+  if (stages2.BUILD?.enabled) {
+    const finalizeIdx = pipeline.indexOf("FINALIZE");
+    if (finalizeIdx !== -1 && !pipeline.includes("BUILD")) {
+      pipeline.splice(finalizeIdx, 0, "BUILD");
+    }
+  }
   if (stages2.TEST?.enabled) {
     const implementIdx = pipeline.indexOf("IMPLEMENT");
     if (implementIdx !== -1 && !pipeline.includes("TEST")) {
@@ -6079,7 +6101,8 @@ var ImplementStage = class {
       ].join("\n"),
       reminders: [
         "Follow the plan exactly. Do NOT deviate without re-planning.",
-        "Do NOT ask the user for confirmation."
+        "Do NOT ask the user for confirmation.",
+        "If you discover pre-existing bugs, failing tests not caused by your changes, or other out-of-scope problems, file them as issues using claudestory_issue_create. Do not fix them inline."
       ],
       transitionedFrom: ctx.state.previousState ?? void 0
     };
@@ -6338,12 +6361,16 @@ var CodeReviewStage = class {
         "",
         `Capture the diff with: ${diffCommand}`,
         "",
-        "**IMPORTANT:** Pass the FULL unified diff output to the reviewer. Do NOT summarize, compress, or truncate the diff.",
+        "**IMPORTANT:** Pass the FULL unified diff to the reviewer. For diffs over ~500 lines, use file-scoped chunks (`git diff <mergebase> -- <filepath>`) across separate calls (pass the same session_id). Do NOT summarize or truncate any individual chunk.",
         "",
         `Run a code review using **${reviewer}**.`,
         "When done, report verdict and findings."
       ].join("\n"),
-      reminders: [diffReminder, "Do NOT compress or summarize the diff."],
+      reminders: [
+        diffReminder,
+        "Do NOT compress or summarize the diff.",
+        "If the reviewer flags pre-existing issues unrelated to your changes, file them as issues using claudestory_issue_create with severity and impact. Do not fix them in this ticket."
+      ],
       transitionedFrom: ctx.state.previousState ?? void 0
     };
   }
@@ -6456,6 +6483,89 @@ var CodeReviewStage = class {
   }
 };
 
+// src/autonomous/stages/build.ts
+init_esm_shims();
+var MAX_BUILD_RETRIES = 2;
+var BuildStage = class {
+  id = "BUILD";
+  skip(ctx) {
+    const buildConfig = ctx.recipe.stages?.BUILD;
+    return !buildConfig?.enabled;
+  }
+  async enter(ctx) {
+    const buildConfig = ctx.recipe.stages?.BUILD;
+    const command = buildConfig?.command ?? "npm run build";
+    const retryCount = ctx.state.buildRetryCount ?? 0;
+    return {
+      instruction: [
+        `# Build${retryCount > 0 ? ` (retry ${retryCount}/${MAX_BUILD_RETRIES})` : ""}`,
+        "",
+        `Run the build: \`${command}\``,
+        "",
+        "Report the results with:",
+        "```json",
+        `{ "sessionId": "${ctx.state.sessionId}", "action": "report", "report": { "completedAction": "build_done", "notes": "<exit code and summary>" } }`,
+        "```",
+        "",
+        "Include the exit code (0 = pass, non-0 = fail) and any error output in notes."
+      ].join("\n"),
+      reminders: ["Run the FULL build, not a partial or dev-mode build."],
+      transitionedFrom: ctx.state.previousState ?? void 0
+    };
+  }
+  async report(ctx, report) {
+    const notes = report.notes ?? "";
+    const retryCount = ctx.state.buildRetryCount ?? 0;
+    const exitCodeMatch = notes.match(/exit\s*(?:code[:\s]*)?\s*(\d+)/i);
+    if (!exitCodeMatch) {
+      const nextRetry = retryCount + 1;
+      if (nextRetry > MAX_BUILD_RETRIES) {
+        ctx.writeState({ buildRetryCount: 0 });
+        ctx.appendEvent("build_parse_exhausted", { retryCount: nextRetry });
+        return {
+          action: "advance",
+          result: {
+            instruction: `Could not parse build exit code after ${MAX_BUILD_RETRIES} retries. Proceeding, but build status is unknown.`,
+            reminders: ["Mention unknown build status in the commit message."]
+          }
+        };
+      }
+      ctx.writeState({ buildRetryCount: nextRetry });
+      return { action: "retry", instruction: 'Could not parse exit code from notes. Include "exit code: 0" (or non-zero) in your notes.' };
+    }
+    const exitCode = parseInt(exitCodeMatch[1], 10);
+    if (exitCode === 0) {
+      ctx.writeState({ buildRetryCount: 0 });
+      ctx.appendEvent("build_passed", { retryCount, notes: notes.slice(0, 200) });
+      return { action: "advance" };
+    }
+    if (retryCount < MAX_BUILD_RETRIES) {
+      ctx.writeState({ buildRetryCount: retryCount + 1 });
+      ctx.appendEvent("build_failed_retry", { retryCount: retryCount + 1, notes: notes.slice(0, 200) });
+      return {
+        action: "back",
+        target: "IMPLEMENT",
+        reason: `Build failed (attempt ${retryCount + 1}/${MAX_BUILD_RETRIES}). Fix the build errors.`
+      };
+    }
+    ctx.writeState({ buildRetryCount: 0 });
+    ctx.appendEvent("build_failed_exhausted", { retryCount, notes: notes.slice(0, 200) });
+    return {
+      action: "advance",
+      result: {
+        instruction: [
+          "# Build Failed - Proceeding",
+          "",
+          `Build failed after ${MAX_BUILD_RETRIES} retries. Proceeding but build errors remain.`,
+          "",
+          "Document the build failure in the commit message."
+        ].join("\n"),
+        reminders: ["Mention build failure in the commit message."]
+      }
+    };
+  }
+};
+
 // src/autonomous/stages/verify.ts
 init_esm_shims();
 var MAX_VERIFY_RETRIES = 3;
@@ -7219,6 +7329,7 @@ registerStage(new ImplementStage());
 registerStage(new WriteTestsStage());
 registerStage(new TestStage());
 registerStage(new CodeReviewStage());
+registerStage(new BuildStage());
 registerStage(new VerifyStage());
 registerStage(new FinalizeStage());
 registerStage(new CompleteStage());
@@ -7434,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 {
   }
@@ -7443,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);
@@ -8244,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;
@@ -9414,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.32";
+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.32",
+  "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": [