@anthropologies/claudestory 0.1.25 → 0.1.27

package/dist/cli.js

@@ -7200,6 +7200,16 @@ var init_finalize = __esm({
             }
           }
         }
+        const ticketId = ctx.state.ticket?.id;
+        if (ticketId) {
+          const ticketPath = `.story/tickets/${ticketId}.json`;
+          if (!stagedResult.data.includes(ticketPath)) {
+            return {
+              action: "retry",
+              instruction: `Pre-commit hooks may have modified the staged set. Ticket file ${ticketPath} is no longer staged. Run \`git add ${ticketPath}\` and call me again with completedAction: "files_staged".`
+            };
+          }
+        }
         ctx.writeState({ finalizeCheckpoint: "precommit_passed" });
         return {
           action: "retry",
@@ -7769,7 +7779,7 @@ async function handleStart(root, args) {
         return guideError(new Error(
           `Stale compacted session ${existing.state.sessionId} found (prepared ${Math.round((Date.now() - preparedAt) / 6e4)} minutes ago, never resumed). SessionStart hook is no longer prompting for this session.
 - To resume anyway: call action "resume" with sessionId "${existing.state.sessionId}"
-- To abandon and start fresh: run "claudestory session clear-compact ${existing.state.sessionId}"`
+- To abandon and start fresh: run "claudestory session stop ${existing.state.sessionId}"`
         ));
       }
       return guideError(new Error(
@@ -7790,7 +7800,7 @@ async function handleStart(root, args) {
       return guideError(new Error(
         `${resumable.stale ? "Stale c" : "C"}ompacted session ${sid} found (prepared ${Math.round((Date.now() - preparedAt) / 6e4)} minutes ago, lease expired but not resumed).
 - To resume: call action "resume" with sessionId "${sid}"
-- To abandon: run "claudestory session clear-compact ${sid}"`
+- To abandon: run "claudestory session stop ${sid}"`
       ));
     }
   }
@@ -8309,7 +8319,7 @@ async function handleReport(root, args) {
   const report = args.report;
   if (state.compactPending && currentState !== "COMPACT") {
     return guideError(new Error(
-      `Session has pending compaction in inconsistent state (${currentState}). Call action: "resume" or run "claudestory session clear-compact ${args.sessionId}".`
+      `Session has pending compaction in inconsistent state (${currentState}). Call action: "resume" or run "claudestory session stop ${args.sessionId}".`
     ));
   }
   const recipe = resolveRecipeFromState(state);
@@ -8338,7 +8348,7 @@ async function handleResume(root, args) {
   const resumeState = info.state.preCompactState;
   if (!resumeState || !WORKFLOW_STATES.includes(resumeState)) {
     return guideError(new Error(
-      `Session ${args.sessionId} has invalid preCompactState: ${resumeState}. Run "claudestory session clear-compact ${args.sessionId}" to recover.`
+      `Session ${args.sessionId} has invalid preCompactState: ${resumeState}. Run "claudestory session stop ${args.sessionId}" to terminate.`
     ));
   }
   const headResult = await gitHead(root);
@@ -8355,7 +8365,7 @@ async function handleResume(root, args) {
       data: { reason: "cannot_validate_head", expectedHead: expectedHead ?? null, gitAvailable: headResult.ok }
     });
     return guideError(new Error(
-      `Cannot validate git state for session ${args.sessionId}. Check git status and try "resume" again, or run "claudestory session clear-compact ${args.sessionId}" to end the session.`
+      `Cannot validate git state for session ${args.sessionId}. Check git status and try "resume" again, or run "claudestory session stop ${args.sessionId}" to end the session.`
     ));
   }
   if (expectedHead && headResult.data.hash !== expectedHead) {
@@ -8528,6 +8538,34 @@ ${driftPreamble}Recovered to state: **${mapping.state}**. Continue from here.`,
   }
   const resumeMode = written.mode ?? "auto";
   const modeContext = resumeMode === "auto" ? "You are in autonomous mode \u2014 continue working." : resumeMode === "review" ? "You are in review mode \u2014 session ends after code review approval." : resumeMode === "plan" ? "You are in plan mode \u2014 session ends after plan review approval." : "You are in guided mode \u2014 single ticket, full pipeline.";
+  const resumeStage = getStage(resumeState);
+  if (resumeStage) {
+    const recipe = resolveRecipeFromState(written);
+    const ctx = new StageContext(root, info.dir, written, recipe);
+    const enterResult = await resumeStage.enter(ctx);
+    if (isStageAdvance(enterResult)) {
+      return processAdvance(ctx, resumeStage, enterResult);
+    }
+    return guideResult(ctx.state, resumeState, {
+      instruction: [
+        "# Resumed After Compact",
+        "",
+        `Session restored at state: **${resumeState}**.`,
+        written.ticket ? `Working on: **${written.ticket.id}: ${written.ticket.title}**` : "",
+        "",
+        modeContext,
+        "",
+        "---",
+        "",
+        enterResult.instruction
+      ].filter(Boolean).join("\n"),
+      reminders: [
+        ...enterResult.reminders ?? [],
+        ...resumeMode === "auto" ? ["Do NOT use plan mode.", "Do NOT stop or summarize."] : [`This is ${resumeMode} mode.`],
+        "Call autonomous_guide after completing each step."
+      ]
+    });
+  }
   return guideResult(written, resumeState, {
     instruction: [
       "# Resumed After Compact",
@@ -10091,7 +10129,7 @@ var init_mcp = __esm({
     init_init();
     ENV_VAR2 = "CLAUDESTORY_PROJECT_ROOT";
     CONFIG_PATH2 = ".story/config.json";
-    version = "0.1.25";
+    version = "0.1.27";
     main().catch((err) => {
       process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}
 `);
@@ -13255,7 +13293,7 @@ function registerSessionCommand(yargs) {
         await handleSessionResumePrompt2();
       }
     ).command(
-      "clear-compact",
+      "clear-compact [sessionId]",
       "Clear stale compact marker (admin)",
       (y2) => y2.positional("sessionId", {
         type: "string",
@@ -13280,7 +13318,7 @@ function registerSessionCommand(yargs) {
         }
       }
     ).command(
-      "stop",
+      "stop [sessionId]",
       "Stop an active session (admin)",
       (y2) => y2.positional("sessionId", {
         type: "string",
@@ -13369,7 +13407,7 @@ async function runCli() {
     registerConfigCommand: registerConfigCommand2,
     registerSessionCommand: registerSessionCommand2
   } = await Promise.resolve().then(() => (init_register(), register_exports));
-  const version2 = "0.1.25";
+  const version2 = "0.1.27";
   class HandledError extends Error {
     constructor() {
       super("HANDLED_ERROR");

package/dist/mcp.js

@@ -6722,6 +6722,16 @@ var FinalizeStage = class {
         }
       }
     }
+    const ticketId = ctx.state.ticket?.id;
+    if (ticketId) {
+      const ticketPath = `.story/tickets/${ticketId}.json`;
+      if (!stagedResult.data.includes(ticketPath)) {
+        return {
+          action: "retry",
+          instruction: `Pre-commit hooks may have modified the staged set. Ticket file ${ticketPath} is no longer staged. Run \`git add ${ticketPath}\` and call me again with completedAction: "files_staged".`
+        };
+      }
+    }
     ctx.writeState({ finalizeCheckpoint: "precommit_passed" });
     return {
       action: "retry",
@@ -7258,7 +7268,7 @@ async function handleStart(root, args) {
         return guideError(new Error(
           `Stale compacted session ${existing.state.sessionId} found (prepared ${Math.round((Date.now() - preparedAt) / 6e4)} minutes ago, never resumed). SessionStart hook is no longer prompting for this session.
 - To resume anyway: call action "resume" with sessionId "${existing.state.sessionId}"
-- To abandon and start fresh: run "claudestory session clear-compact ${existing.state.sessionId}"`
+- To abandon and start fresh: run "claudestory session stop ${existing.state.sessionId}"`
         ));
       }
       return guideError(new Error(
@@ -7279,7 +7289,7 @@ async function handleStart(root, args) {
       return guideError(new Error(
         `${resumable.stale ? "Stale c" : "C"}ompacted session ${sid} found (prepared ${Math.round((Date.now() - preparedAt) / 6e4)} minutes ago, lease expired but not resumed).
 - To resume: call action "resume" with sessionId "${sid}"
-- To abandon: run "claudestory session clear-compact ${sid}"`
+- To abandon: run "claudestory session stop ${sid}"`
       ));
     }
   }
@@ -7799,7 +7809,7 @@ async function handleReport(root, args) {
   const report = args.report;
   if (state.compactPending && currentState !== "COMPACT") {
     return guideError(new Error(
-      `Session has pending compaction in inconsistent state (${currentState}). Call action: "resume" or run "claudestory session clear-compact ${args.sessionId}".`
+      `Session has pending compaction in inconsistent state (${currentState}). Call action: "resume" or run "claudestory session stop ${args.sessionId}".`
     ));
   }
   const recipe = resolveRecipeFromState(state);
@@ -7828,7 +7838,7 @@ async function handleResume(root, args) {
   const resumeState = info.state.preCompactState;
   if (!resumeState || !WORKFLOW_STATES.includes(resumeState)) {
     return guideError(new Error(
-      `Session ${args.sessionId} has invalid preCompactState: ${resumeState}. Run "claudestory session clear-compact ${args.sessionId}" to recover.`
+      `Session ${args.sessionId} has invalid preCompactState: ${resumeState}. Run "claudestory session stop ${args.sessionId}" to terminate.`
     ));
   }
   const headResult = await gitHead(root);
@@ -7845,7 +7855,7 @@ async function handleResume(root, args) {
       data: { reason: "cannot_validate_head", expectedHead: expectedHead ?? null, gitAvailable: headResult.ok }
     });
     return guideError(new Error(
-      `Cannot validate git state for session ${args.sessionId}. Check git status and try "resume" again, or run "claudestory session clear-compact ${args.sessionId}" to end the session.`
+      `Cannot validate git state for session ${args.sessionId}. Check git status and try "resume" again, or run "claudestory session stop ${args.sessionId}" to end the session.`
     ));
   }
   if (expectedHead && headResult.data.hash !== expectedHead) {
@@ -8018,6 +8028,34 @@ ${driftPreamble}Recovered to state: **${mapping.state}**. Continue from here.`,
   }
   const resumeMode = written.mode ?? "auto";
   const modeContext = resumeMode === "auto" ? "You are in autonomous mode \u2014 continue working." : resumeMode === "review" ? "You are in review mode \u2014 session ends after code review approval." : resumeMode === "plan" ? "You are in plan mode \u2014 session ends after plan review approval." : "You are in guided mode \u2014 single ticket, full pipeline.";
+  const resumeStage = getStage(resumeState);
+  if (resumeStage) {
+    const recipe = resolveRecipeFromState(written);
+    const ctx = new StageContext(root, info.dir, written, recipe);
+    const enterResult = await resumeStage.enter(ctx);
+    if (isStageAdvance(enterResult)) {
+      return processAdvance(ctx, resumeStage, enterResult);
+    }
+    return guideResult(ctx.state, resumeState, {
+      instruction: [
+        "# Resumed After Compact",
+        "",
+        `Session restored at state: **${resumeState}**.`,
+        written.ticket ? `Working on: **${written.ticket.id}: ${written.ticket.title}**` : "",
+        "",
+        modeContext,
+        "",
+        "---",
+        "",
+        enterResult.instruction
+      ].filter(Boolean).join("\n"),
+      reminders: [
+        ...enterResult.reminders ?? [],
+        ...resumeMode === "auto" ? ["Do NOT use plan mode.", "Do NOT stop or summarize."] : [`This is ${resumeMode} mode.`],
+        "Call autonomous_guide after completing each step."
+      ]
+    });
+  }
   return guideResult(written, resumeState, {
     instruction: [
       "# Resumed After Compact",
@@ -9256,7 +9294,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.25";
+var version = "0.1.27";
 function tryDiscoverRoot() {
   const envRoot = process.env[ENV_VAR2];
   if (envRoot) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropologies/claudestory",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "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": [