@anthropologies/claudestory 0.1.40 → 0.1.42

package/dist/cli.js

@@ -5855,7 +5855,8 @@ var init_state_machine = __esm({
       // start does INIT + LOAD_CONTEXT internally
       LOAD_CONTEXT: ["PICK_TICKET"],
       // internal (never seen by Claude)
-      PICK_TICKET: ["PLAN", "ISSUE_FIX", "SESSION_END"],
+      PICK_TICKET: ["PLAN", "ISSUE_FIX", "COMPLETE", "SESSION_END"],
+      // COMPLETE for ISS-075 (nothing left to do)
       PLAN: ["PLAN_REVIEW"],
       PLAN_REVIEW: ["IMPLEMENT", "WRITE_TESTS", "PLAN", "PLAN_REVIEW", "SESSION_END"],
       // approve → IMPLEMENT/WRITE_TESTS, reject → PLAN, stay for next round; SESSION_END for tiered exit
@@ -6444,6 +6445,9 @@ var init_pick_ticket = __esm({
         }
         const topCandidate = candidates.kind === "found" ? candidates.candidates[0] : null;
         const hasIssues = highIssues.length > 0;
+        if (!topCandidate && candidates.kind !== "found" && !hasIssues) {
+          return { action: "goto", target: "COMPLETE" };
+        }
         return {
           instruction: [
             "# Pick a Ticket or Issue",
@@ -6730,7 +6734,7 @@ var init_plan_review = __esm({
         const risk = ctx.state.ticket?.risk ?? "low";
         const minRounds = requiredRounds(risk);
         const hasCriticalOrMajor = findings.some(
-          (f) => f.severity === "critical" || f.severity === "major"
+          (f) => (f.severity === "critical" || f.severity === "major") && f.disposition !== "addressed" && f.disposition !== "deferred"
         );
         if (verdict === "approve" && hasCriticalOrMajor) {
           return { action: "retry", instruction: "Contradictory review payload: verdict is 'approve' but critical/major findings are present. Re-run the review or correct the verdict." };
@@ -7178,7 +7182,7 @@ var init_code_review = __esm({
         const risk = ctx.state.ticket?.realizedRisk ?? ctx.state.ticket?.risk ?? "low";
         const minRounds = requiredRounds(risk);
         const hasCriticalOrMajor = findings.some(
-          (f) => f.severity === "critical" || f.severity === "major"
+          (f) => (f.severity === "critical" || f.severity === "major") && f.disposition !== "addressed" && f.disposition !== "deferred"
         );
         const planRedirect = findings.some((f) => f.recommendedNextState === "PLAN");
         if (verdict === "approve" && hasCriticalOrMajor) {
@@ -8323,24 +8327,64 @@ var init_stages = __esm({
   }
 });
 
+// src/autonomous/version-check.ts
+import { readFileSync as readFileSync6 } from "fs";
+import { join as join13, dirname as dirname4 } from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
+function checkVersionMismatch(runningVersion, installedVersion) {
+  if (!installedVersion) return null;
+  if (runningVersion === "0.0.0-dev") return null;
+  if (runningVersion === installedVersion) return null;
+  return `claudestory MCP server is running v${runningVersion} but v${installedVersion} is installed. Restart Claude Code to load the updated version.`;
+}
+function getInstalledVersion() {
+  try {
+    const thisFile = fileURLToPath3(import.meta.url);
+    const candidates = [
+      join13(dirname4(thisFile), "..", "..", "package.json"),
+      join13(dirname4(thisFile), "..", "package.json")
+    ];
+    for (const candidate of candidates) {
+      try {
+        const raw = readFileSync6(candidate, "utf-8");
+        const pkg = JSON.parse(raw);
+        if (pkg.version) return pkg.version;
+      } catch {
+      }
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function getRunningVersion() {
+  return "0.1.42";
+}
+var init_version_check = __esm({
+  "src/autonomous/version-check.ts"() {
+    "use strict";
+    init_esm_shims();
+  }
+});
+
 // src/autonomous/guide.ts
-import { readFileSync as readFileSync6, writeFileSync as writeFileSync3, readdirSync as readdirSync4 } from "fs";
-import { join as join13 } from "path";
+import { readFileSync as readFileSync7, writeFileSync as writeFileSync3, readdirSync as readdirSync4 } from "fs";
+import { join as join14 } from "path";
 function buildGuideRecommendOptions(root) {
   const opts = {};
   try {
-    const handoversDir = join13(root, ".story", "handovers");
+    const handoversDir = join14(root, ".story", "handovers");
     const files = readdirSync4(handoversDir, "utf-8").filter((f) => f.endsWith(".md")).sort();
     if (files.length > 0) {
-      opts.latestHandoverContent = readFileSync6(join13(handoversDir, files[files.length - 1]), "utf-8");
+      opts.latestHandoverContent = readFileSync7(join14(handoversDir, files[files.length - 1]), "utf-8");
     }
   } catch {
   }
   try {
-    const snapshotsDir = join13(root, ".story", "snapshots");
+    const snapshotsDir = join14(root, ".story", "snapshots");
     const snapFiles = readdirSync4(snapshotsDir, "utf-8").filter((f) => f.endsWith(".json")).sort();
     if (snapFiles.length > 0) {
-      const raw = readFileSync6(join13(snapshotsDir, snapFiles[snapFiles.length - 1]), "utf-8");
+      const raw = readFileSync7(join14(snapshotsDir, snapFiles[snapFiles.length - 1]), "utf-8");
       const snap = JSON.parse(raw);
       if (snap.issues) {
         opts.previousOpenIssueCount = snap.issues.filter((i) => i.status !== "resolved").length;
@@ -8527,6 +8571,7 @@ async function handleStart(root, args) {
   for (const stale of staleSessions) {
     writeSessionSync(stale.dir, { ...stale.state, status: "superseded" });
   }
+  const versionWarning = checkVersionMismatch(getRunningVersion(), getInstalledVersion());
   const wsId = deriveWorkspaceId(root);
   const mode = args.mode ?? "auto";
   if (mode !== "auto" && !args.ticketId) {
@@ -8721,7 +8766,7 @@ Staged: ${stagedResult.data.join(", ")}`
       }
     }
     const { state: projectState, warnings } = await loadProject(root);
-    const handoversDir = join13(root, ".story", "handovers");
+    const handoversDir = join14(root, ".story", "handovers");
     const ctx = { state: projectState, warnings, root, handoversDir, format: "md" };
     let handoverText = "";
     try {
@@ -8738,7 +8783,7 @@ Staged: ${stagedResult.data.join(", ")}`
       }
     } catch {
     }
-    const rulesText = readFileSafe2(join13(root, "RULES.md"));
+    const rulesText = readFileSafe2(join14(root, "RULES.md"));
     const lessonDigest = buildLessonDigest(projectState.lessons);
     const digestParts = [
       handoverText ? `## Recent Handovers
@@ -8754,7 +8799,7 @@ ${rulesText}` : "",
     ].filter(Boolean);
     const digest = digestParts.join("\n\n---\n\n");
     try {
-      writeFileSync3(join13(dir, "context-digest.md"), digest, "utf-8");
+      writeFileSync3(join14(dir, "context-digest.md"), digest, "utf-8");
     } catch {
     }
     if (mode !== "auto" && args.ticketId) {
@@ -8946,7 +8991,8 @@ ${ticket.description}` : "",
         "Do NOT use Claude Code's plan mode \u2014 write plans as markdown files.",
         "Do NOT ask the user for confirmation or approval.",
         "Do NOT stop or summarize between tickets \u2014 call autonomous_guide IMMEDIATELY.",
-        "You are in autonomous mode \u2014 continue working until done."
+        "You are in autonomous mode \u2014 continue working until done.",
+        ...versionWarning ? [`**Warning:** ${versionWarning}`] : []
       ],
       transitionedFrom: "INIT"
     });
@@ -9472,7 +9518,7 @@ function guideError(err) {
 }
 function readFileSafe2(path2) {
   try {
-    return readFileSync6(path2, "utf-8");
+    return readFileSync7(path2, "utf-8");
   } catch {
     return "";
   }
@@ -9498,6 +9544,7 @@ var init_guide = __esm({
     init_snapshot();
     init_queries();
     init_recommend();
+    init_version_check();
     init_handover();
     RECOVERY_MAPPING = {
       PICK_TICKET: { state: "PICK_TICKET", resetPlan: false, resetCode: false },
@@ -9724,8 +9771,8 @@ var init_session_report_formatter = __esm({
 });
 
 // src/cli/commands/session-report.ts
-import { readFileSync as readFileSync7, existsSync as existsSync10 } from "fs";
-import { join as join14 } from "path";
+import { readFileSync as readFileSync8, existsSync as existsSync10 } from "fs";
+import { join as join15 } from "path";
 async function handleSessionReport(sessionId, root, format = "md") {
   if (!UUID_REGEX.test(sessionId)) {
     return {
@@ -9744,7 +9791,7 @@ async function handleSessionReport(sessionId, root, format = "md") {
       isError: true
     };
   }
-  const statePath2 = join14(dir, "state.json");
+  const statePath2 = join15(dir, "state.json");
   if (!existsSync10(statePath2)) {
     return {
       output: `Error: Session ${sessionId} corrupt \u2014 state.json missing.`,
@@ -9754,7 +9801,7 @@ async function handleSessionReport(sessionId, root, format = "md") {
     };
   }
   try {
-    const rawJson = JSON.parse(readFileSync7(statePath2, "utf-8"));
+    const rawJson = JSON.parse(readFileSync8(statePath2, "utf-8"));
     if (rawJson && typeof rawJson === "object" && "schemaVersion" in rawJson && rawJson.schemaVersion !== CURRENT_SESSION_SCHEMA_VERSION) {
       return {
         output: `Error: Session ${sessionId} \u2014 unsupported session schema version ${rawJson.schemaVersion}.`,
@@ -9783,7 +9830,7 @@ async function handleSessionReport(sessionId, root, format = "md") {
   const events = readEvents(dir);
   let planContent = null;
   try {
-    planContent = readFileSync7(join14(dir, "plan.md"), "utf-8");
+    planContent = readFileSync8(join15(dir, "plan.md"), "utf-8");
   } catch {
   }
   let gitLog = null;
@@ -9812,7 +9859,7 @@ var init_session_report = __esm({
 });
 
 // src/cli/commands/phase.ts
-import { join as join15, resolve as resolve6 } from "path";
+import { join as join16, resolve as resolve6 } from "path";
 function validatePhaseId(id) {
   if (id.length > PHASE_ID_MAX_LENGTH) {
     throw new CliValidationError("invalid_input", `Phase ID "${id}" exceeds ${PHASE_ID_MAX_LENGTH} characters`);
@@ -10001,21 +10048,21 @@ async function handlePhaseDelete(id, reassign, format, root) {
         const updated = { ...ticket, phase: reassign, order: maxOrder };
         const parsed = TicketSchema.parse(updated);
         const content = serializeJSON(parsed);
-        const target = join15(wrapDir, "tickets", `${parsed.id}.json`);
+        const target = join16(wrapDir, "tickets", `${parsed.id}.json`);
         operations.push({ op: "write", target, content });
       }
       for (const issue of affectedIssues) {
         const updated = { ...issue, phase: reassign };
         const parsed = IssueSchema.parse(updated);
         const content = serializeJSON(parsed);
-        const target = join15(wrapDir, "issues", `${parsed.id}.json`);
+        const target = join16(wrapDir, "issues", `${parsed.id}.json`);
         operations.push({ op: "write", target, content });
       }
       const newPhases = state.roadmap.phases.filter((p) => p.id !== id);
       const newRoadmap = { ...state.roadmap, phases: newPhases };
       const parsedRoadmap = RoadmapSchema.parse(newRoadmap);
       const roadmapContent = serializeJSON(parsedRoadmap);
-      const roadmapTarget = join15(wrapDir, "roadmap.json");
+      const roadmapTarget = join16(wrapDir, "roadmap.json");
       operations.push({ op: "write", target: roadmapTarget, content: roadmapContent });
       await runTransactionUnlocked(root, operations);
     } else {
@@ -10048,14 +10095,14 @@ var init_phase = __esm({
 
 // src/mcp/tools.ts
 import { z as z10 } from "zod";
-import { join as join16 } from "path";
+import { join as join17 } from "path";
 function formatMcpError(code, message) {
   return `[${code}] ${message}`;
 }
 async function runMcpReadTool(pinnedRoot, handler) {
   try {
     const { state, warnings } = await loadProject(pinnedRoot);
-    const handoversDir = join16(pinnedRoot, ".story", "handovers");
+    const handoversDir = join17(pinnedRoot, ".story", "handovers");
     const ctx = { state, warnings, root: pinnedRoot, handoversDir, format: "md" };
     const result = await handler(ctx);
     if (result.errorCode && INFRASTRUCTURE_ERROR_CODES.includes(result.errorCode)) {
@@ -10643,10 +10690,10 @@ var init_tools = __esm({
 
 // src/core/init.ts
 import { mkdir as mkdir4, stat as stat2, readFile as readFile4, writeFile as writeFile2 } from "fs/promises";
-import { join as join17, resolve as resolve7 } from "path";
+import { join as join18, resolve as resolve7 } from "path";
 async function initProject(root, options) {
   const absRoot = resolve7(root);
-  const wrapDir = join17(absRoot, ".story");
+  const wrapDir = join18(absRoot, ".story");
   let exists = false;
   try {
     const s = await stat2(wrapDir);
@@ -10666,11 +10713,11 @@ async function initProject(root, options) {
       ".story/ already exists. Use --force to overwrite config and roadmap."
     );
   }
-  await mkdir4(join17(wrapDir, "tickets"), { recursive: true });
-  await mkdir4(join17(wrapDir, "issues"), { recursive: true });
-  await mkdir4(join17(wrapDir, "handovers"), { recursive: true });
-  await mkdir4(join17(wrapDir, "notes"), { recursive: true });
-  await mkdir4(join17(wrapDir, "lessons"), { recursive: true });
+  await mkdir4(join18(wrapDir, "tickets"), { recursive: true });
+  await mkdir4(join18(wrapDir, "issues"), { recursive: true });
+  await mkdir4(join18(wrapDir, "handovers"), { recursive: true });
+  await mkdir4(join18(wrapDir, "notes"), { recursive: true });
+  await mkdir4(join18(wrapDir, "lessons"), { recursive: true });
   const created = [
     ".story/config.json",
     ".story/roadmap.json",
@@ -10710,7 +10757,7 @@ async function initProject(root, options) {
   };
   await writeConfig(config, absRoot);
   await writeRoadmap(roadmap, absRoot);
-  const gitignorePath = join17(wrapDir, ".gitignore");
+  const gitignorePath = join18(wrapDir, ".gitignore");
   await ensureGitignoreEntries(gitignorePath, STORY_GITIGNORE_ENTRIES);
   const warnings = [];
   if (options.force && exists) {
@@ -10758,7 +10805,7 @@ var init_init = __esm({
 // src/mcp/index.ts
 var mcp_exports = {};
 import { realpathSync as realpathSync2, existsSync as existsSync11 } from "fs";
-import { resolve as resolve8, join as join18, isAbsolute } from "path";
+import { resolve as resolve8, join as join19, isAbsolute } from "path";
 import { z as z11 } from "zod";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -10773,7 +10820,7 @@ function tryDiscoverRoot() {
     const resolved = resolve8(envRoot);
     try {
       const canonical = realpathSync2(resolved);
-      if (existsSync11(join18(canonical, CONFIG_PATH2))) {
+      if (existsSync11(join19(canonical, CONFIG_PATH2))) {
         return canonical;
       }
       process.stderr.write(`Warning: No .story/config.json at ${canonical}
@@ -10876,7 +10923,7 @@ var init_mcp = __esm({
     init_init();
     ENV_VAR2 = "CLAUDESTORY_PROJECT_ROOT";
     CONFIG_PATH2 = ".story/config.json";
-    version = "0.1.40";
+    version = "0.1.42";
     main().catch((err) => {
       process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}
 `);
@@ -10912,7 +10959,7 @@ __export(run_exports, {
   runReadCommand: () => runReadCommand,
   writeOutput: () => writeOutput
 });
-import { join as join19 } from "path";
+import { join as join20 } from "path";
 function writeOutput(text) {
   try {
     process.stdout.write(text + "\n");
@@ -10940,7 +10987,7 @@ async function runReadCommand(format, handler) {
       return;
     }
     const { state, warnings } = await loadProject(root);
-    const handoversDir = join19(root, ".story", "handovers");
+    const handoversDir = join20(root, ".story", "handovers");
     const result = await handler({ state, warnings, root, handoversDir, format });
     writeOutput(result.output);
     let exitCode = result.exitCode ?? ExitCode.OK;
@@ -10975,7 +11022,7 @@ async function runDeleteCommand(format, force, handler) {
       return;
     }
     const { state, warnings } = await loadProject(root);
-    const handoversDir = join19(root, ".story", "handovers");
+    const handoversDir = join20(root, ".story", "handovers");
     if (!force && hasIntegrityWarnings(warnings)) {
       writeOutput(
         formatError(
@@ -11489,19 +11536,19 @@ __export(setup_skill_exports, {
 });
 import { mkdir as mkdir5, writeFile as writeFile3, readFile as readFile5, rm, rename as rename2, unlink as unlink3 } from "fs/promises";
 import { existsSync as existsSync12 } from "fs";
-import { join as join20, dirname as dirname4 } from "path";
+import { join as join21, dirname as dirname5 } from "path";
 import { homedir } from "os";
 import { execFileSync } from "child_process";
-import { fileURLToPath as fileURLToPath3 } from "url";
+import { fileURLToPath as fileURLToPath4 } from "url";
 function log(msg) {
   process.stdout.write(msg + "\n");
 }
 function resolveSkillSourceDir() {
-  const thisDir = dirname4(fileURLToPath3(import.meta.url));
-  const bundledPath = join20(thisDir, "..", "src", "skill");
-  if (existsSync12(join20(bundledPath, "SKILL.md"))) return bundledPath;
-  const sourcePath = join20(thisDir, "..", "..", "skill");
-  if (existsSync12(join20(sourcePath, "SKILL.md"))) return sourcePath;
+  const thisDir = dirname5(fileURLToPath4(import.meta.url));
+  const bundledPath = join21(thisDir, "..", "src", "skill");
+  if (existsSync12(join21(bundledPath, "SKILL.md"))) return bundledPath;
+  const sourcePath = join21(thisDir, "..", "..", "skill");
+  if (existsSync12(join21(sourcePath, "SKILL.md"))) return sourcePath;
   throw new Error(
     `Cannot find bundled skill files. Checked:
   ${bundledPath}
@@ -11514,7 +11561,7 @@ function isHookWithCommand(entry, command) {
   return e.type === "command" && typeof e.command === "string" && e.command.trim() === command;
 }
 async function registerHook(hookType, hookEntry, settingsPath, matcher) {
-  const path2 = settingsPath ?? join20(homedir(), ".claude", "settings.json");
+  const path2 = settingsPath ?? join21(homedir(), ".claude", "settings.json");
   let raw = "{}";
   if (existsSync12(path2)) {
     try {
@@ -11586,7 +11633,7 @@ async function registerHook(hookType, hookEntry, settingsPath, matcher) {
   }
   const tmpPath = `${path2}.${process.pid}.tmp`;
   try {
-    const dir = dirname4(path2);
+    const dir = dirname5(path2);
     await mkdir5(dir, { recursive: true });
     await writeFile3(tmpPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
     await rename2(tmpPath, path2);
@@ -11612,7 +11659,7 @@ async function registerStopHook(settingsPath) {
   return registerHook("Stop", { type: "command", command: STOP_HOOK_COMMAND, async: true }, settingsPath);
 }
 async function removeHook(hookType, command, settingsPath) {
-  const path2 = settingsPath ?? join20(homedir(), ".claude", "settings.json");
+  const path2 = settingsPath ?? join21(homedir(), ".claude", "settings.json");
   let raw = "{}";
   if (existsSync12(path2)) {
     try {
@@ -11644,7 +11691,7 @@ async function removeHook(hookType, command, settingsPath) {
   if (!removed) return "not_found";
   const tmpPath = `${path2}.${process.pid}.tmp`;
   try {
-    const dir = dirname4(path2);
+    const dir = dirname5(path2);
     await mkdir5(dir, { recursive: true });
     await writeFile3(tmpPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
     await rename2(tmpPath, path2);
@@ -11659,7 +11706,7 @@ async function removeHook(hookType, command, settingsPath) {
 }
 async function handleSetupSkill(options = {}) {
   const { skipHooks = false } = options;
-  const skillDir = join20(homedir(), ".claude", "skills", "story");
+  const skillDir = join21(homedir(), ".claude", "skills", "story");
   await mkdir5(skillDir, { recursive: true });
   let srcSkillDir;
   try {
@@ -11672,19 +11719,19 @@ async function handleSetupSkill(options = {}) {
     process.exitCode = 1;
     return;
   }
-  const oldPrimeDir = join20(homedir(), ".claude", "skills", "prime");
+  const oldPrimeDir = join21(homedir(), ".claude", "skills", "prime");
   if (existsSync12(oldPrimeDir)) {
     await rm(oldPrimeDir, { recursive: true, force: true });
     log("Removed old /prime skill (migrated to /story)");
   }
-  const existed = existsSync12(join20(skillDir, "SKILL.md"));
-  const skillContent = await readFile5(join20(srcSkillDir, "SKILL.md"), "utf-8");
-  await writeFile3(join20(skillDir, "SKILL.md"), skillContent, "utf-8");
+  const existed = existsSync12(join21(skillDir, "SKILL.md"));
+  const skillContent = await readFile5(join21(srcSkillDir, "SKILL.md"), "utf-8");
+  await writeFile3(join21(skillDir, "SKILL.md"), skillContent, "utf-8");
   let referenceWritten = false;
-  const refSrcPath = join20(srcSkillDir, "reference.md");
+  const refSrcPath = join21(srcSkillDir, "reference.md");
   if (existsSync12(refSrcPath)) {
     const refContent = await readFile5(refSrcPath, "utf-8");
-    await writeFile3(join20(skillDir, "reference.md"), refContent, "utf-8");
+    await writeFile3(join21(skillDir, "reference.md"), refContent, "utf-8");
     referenceWritten = true;
   }
   log(`${existed ? "Updated" : "Installed"} /story skill at ${skillDir}/`);
@@ -11798,8 +11845,8 @@ var hook_status_exports = {};
 __export(hook_status_exports, {
   handleHookStatus: () => handleHookStatus
 });
-import { readFileSync as readFileSync8, writeFileSync as writeFileSync4, renameSync as renameSync2, unlinkSync as unlinkSync4 } from "fs";
-import { join as join21 } from "path";
+import { readFileSync as readFileSync9, writeFileSync as writeFileSync4, renameSync as renameSync2, unlinkSync as unlinkSync4 } from "fs";
+import { join as join22 } from "path";
 async function readStdinSilent() {
   try {
     const chunks = [];
@@ -11849,10 +11896,10 @@ function activePayload(session) {
   };
 }
 function ensureGitignore(root) {
-  const gitignorePath = join21(root, ".story", ".gitignore");
+  const gitignorePath = join22(root, ".story", ".gitignore");
   let existing = "";
   try {
-    existing = readFileSync8(gitignorePath, "utf-8");
+    existing = readFileSync9(gitignorePath, "utf-8");
   } catch {
   }
   const lines = existing.split("\n").map((l) => l.trim());
@@ -11868,7 +11915,7 @@ function ensureGitignore(root) {
 }
 function writeStatus(root, payload) {
   ensureGitignore(root);
-  const statusPath = join21(root, ".story", "status.json");
+  const statusPath = join22(root, ".story", "status.json");
   const content = JSON.stringify(payload, null, 2) + "\n";
   atomicWriteSync(statusPath, content);
 }
@@ -11927,8 +11974,8 @@ var config_update_exports = {};
 __export(config_update_exports, {
   handleConfigSetOverrides: () => handleConfigSetOverrides
 });
-import { readFileSync as readFileSync9 } from "fs";
-import { join as join22 } from "path";
+import { readFileSync as readFileSync10 } from "fs";
+import { join as join23 } from "path";
 async function handleConfigSetOverrides(root, format, options) {
   const { json: jsonArg, clear } = options;
   if (!clear && !jsonArg) {
@@ -11956,8 +12003,8 @@ async function handleConfigSetOverrides(root, format, options) {
   }
   let resultOverrides = null;
   await withProjectLock(root, { strict: false }, async () => {
-    const configPath = join22(root, ".story", "config.json");
-    const rawContent = readFileSync9(configPath, "utf-8");
+    const configPath = join23(root, ".story", "config.json");
+    const rawContent = readFileSync10(configPath, "utf-8");
     const raw = JSON.parse(rawContent);
     if (clear) {
       delete raw.recipeOverrides;
@@ -14300,7 +14347,7 @@ async function runCli() {
     registerSessionCommand: registerSessionCommand2,
     registerRepairCommand: registerRepairCommand2
   } = await Promise.resolve().then(() => (init_register(), register_exports));
-  const version2 = "0.1.40";
+  const version2 = "0.1.42";
   class HandledError extends Error {
     constructor() {
       super("HANDLED_ERROR");

package/dist/mcp.js

@@ -4096,7 +4096,7 @@ var init_session = __esm({
 // src/mcp/index.ts
 init_esm_shims();
 import { realpathSync as realpathSync2, existsSync as existsSync11 } from "fs";
-import { resolve as resolve8, join as join18, isAbsolute } from "path";
+import { resolve as resolve8, join as join19, isAbsolute } from "path";
 import { z as z11 } from "zod";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -4149,7 +4149,7 @@ init_errors();
 init_helpers();
 init_types();
 import { z as z10 } from "zod";
-import { join as join16 } from "path";
+import { join as join17 } from "path";
 
 // src/cli/commands/status.ts
 init_esm_shims();
@@ -5443,8 +5443,8 @@ init_handover();
 init_esm_shims();
 init_session_types();
 init_session();
-import { readFileSync as readFileSync6, writeFileSync as writeFileSync3, readdirSync as readdirSync4 } from "fs";
-import { join as join13 } from "path";
+import { readFileSync as readFileSync7, writeFileSync as writeFileSync3, readdirSync as readdirSync4 } from "fs";
+import { join as join14 } from "path";
 
 // src/autonomous/state-machine.ts
 init_esm_shims();
@@ -5453,7 +5453,8 @@ var TRANSITIONS = {
   // start does INIT + LOAD_CONTEXT internally
   LOAD_CONTEXT: ["PICK_TICKET"],
   // internal (never seen by Claude)
-  PICK_TICKET: ["PLAN", "ISSUE_FIX", "SESSION_END"],
+  PICK_TICKET: ["PLAN", "ISSUE_FIX", "COMPLETE", "SESSION_END"],
+  // COMPLETE for ISS-075 (nothing left to do)
   PLAN: ["PLAN_REVIEW"],
   PLAN_REVIEW: ["IMPLEMENT", "WRITE_TESTS", "PLAN", "PLAN_REVIEW", "SESSION_END"],
   // approve → IMPLEMENT/WRITE_TESTS, reject → PLAN, stay for next round; SESSION_END for tiered exit
@@ -6013,6 +6014,9 @@ var PickTicketStage = class {
     }
     const topCandidate = candidates.kind === "found" ? candidates.candidates[0] : null;
     const hasIssues = highIssues.length > 0;
+    if (!topCandidate && candidates.kind !== "found" && !hasIssues) {
+      return { action: "goto", target: "COMPLETE" };
+    }
     return {
       instruction: [
         "# Pick a Ticket or Issue",
@@ -6285,7 +6289,7 @@ var PlanReviewStage = class {
     const risk = ctx.state.ticket?.risk ?? "low";
     const minRounds = requiredRounds(risk);
     const hasCriticalOrMajor = findings.some(
-      (f) => f.severity === "critical" || f.severity === "major"
+      (f) => (f.severity === "critical" || f.severity === "major") && f.disposition !== "addressed" && f.disposition !== "deferred"
     );
     if (verdict === "approve" && hasCriticalOrMajor) {
       return { action: "retry", instruction: "Contradictory review payload: verdict is 'approve' but critical/major findings are present. Re-run the review or correct the verdict." };
@@ -6706,7 +6710,7 @@ var CodeReviewStage = class {
     const risk = ctx.state.ticket?.realizedRisk ?? ctx.state.ticket?.risk ?? "low";
     const minRounds = requiredRounds(risk);
     const hasCriticalOrMajor = findings.some(
-      (f) => f.severity === "critical" || f.severity === "major"
+      (f) => (f.severity === "critical" || f.severity === "major") && f.disposition !== "addressed" && f.disposition !== "deferred"
     );
     const planRedirect = findings.some((f) => f.recommendedNextState === "PLAN");
     if (verdict === "approve" && hasCriticalOrMajor) {
@@ -7779,6 +7783,43 @@ init_project_loader();
 init_snapshot();
 init_snapshot();
 init_queries();
+
+// src/autonomous/version-check.ts
+init_esm_shims();
+import { readFileSync as readFileSync6 } from "fs";
+import { join as join13, dirname as dirname4 } from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
+function checkVersionMismatch(runningVersion, installedVersion) {
+  if (!installedVersion) return null;
+  if (runningVersion === "0.0.0-dev") return null;
+  if (runningVersion === installedVersion) return null;
+  return `claudestory MCP server is running v${runningVersion} but v${installedVersion} is installed. Restart Claude Code to load the updated version.`;
+}
+function getInstalledVersion() {
+  try {
+    const thisFile = fileURLToPath3(import.meta.url);
+    const candidates = [
+      join13(dirname4(thisFile), "..", "..", "package.json"),
+      join13(dirname4(thisFile), "..", "package.json")
+    ];
+    for (const candidate of candidates) {
+      try {
+        const raw = readFileSync6(candidate, "utf-8");
+        const pkg = JSON.parse(raw);
+        if (pkg.version) return pkg.version;
+      } catch {
+      }
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function getRunningVersion() {
+  return "0.1.42";
+}
+
+// src/autonomous/guide.ts
 init_handover();
 var RECOVERY_MAPPING = {
   PICK_TICKET: { state: "PICK_TICKET", resetPlan: false, resetCode: false },
@@ -7800,18 +7841,18 @@ var RECOVERY_MAPPING = {
 function buildGuideRecommendOptions(root) {
   const opts = {};
   try {
-    const handoversDir = join13(root, ".story", "handovers");
+    const handoversDir = join14(root, ".story", "handovers");
     const files = readdirSync4(handoversDir, "utf-8").filter((f) => f.endsWith(".md")).sort();
     if (files.length > 0) {
-      opts.latestHandoverContent = readFileSync6(join13(handoversDir, files[files.length - 1]), "utf-8");
+      opts.latestHandoverContent = readFileSync7(join14(handoversDir, files[files.length - 1]), "utf-8");
     }
   } catch {
   }
   try {
-    const snapshotsDir = join13(root, ".story", "snapshots");
+    const snapshotsDir = join14(root, ".story", "snapshots");
     const snapFiles = readdirSync4(snapshotsDir, "utf-8").filter((f) => f.endsWith(".json")).sort();
     if (snapFiles.length > 0) {
-      const raw = readFileSync6(join13(snapshotsDir, snapFiles[snapFiles.length - 1]), "utf-8");
+      const raw = readFileSync7(join14(snapshotsDir, snapFiles[snapFiles.length - 1]), "utf-8");
       const snap = JSON.parse(raw);
       if (snap.issues) {
         opts.previousOpenIssueCount = snap.issues.filter((i) => i.status !== "resolved").length;
@@ -8004,6 +8045,7 @@ async function handleStart(root, args) {
   for (const stale of staleSessions) {
     writeSessionSync(stale.dir, { ...stale.state, status: "superseded" });
   }
+  const versionWarning = checkVersionMismatch(getRunningVersion(), getInstalledVersion());
   const wsId = deriveWorkspaceId(root);
   const mode = args.mode ?? "auto";
   if (mode !== "auto" && !args.ticketId) {
@@ -8198,7 +8240,7 @@ Staged: ${stagedResult.data.join(", ")}`
       }
     }
     const { state: projectState, warnings } = await loadProject(root);
-    const handoversDir = join13(root, ".story", "handovers");
+    const handoversDir = join14(root, ".story", "handovers");
     const ctx = { state: projectState, warnings, root, handoversDir, format: "md" };
     let handoverText = "";
     try {
@@ -8215,7 +8257,7 @@ Staged: ${stagedResult.data.join(", ")}`
       }
     } catch {
     }
-    const rulesText = readFileSafe2(join13(root, "RULES.md"));
+    const rulesText = readFileSafe2(join14(root, "RULES.md"));
     const lessonDigest = buildLessonDigest(projectState.lessons);
     const digestParts = [
       handoverText ? `## Recent Handovers
@@ -8231,7 +8273,7 @@ ${rulesText}` : "",
     ].filter(Boolean);
     const digest = digestParts.join("\n\n---\n\n");
     try {
-      writeFileSync3(join13(dir, "context-digest.md"), digest, "utf-8");
+      writeFileSync3(join14(dir, "context-digest.md"), digest, "utf-8");
     } catch {
     }
     if (mode !== "auto" && args.ticketId) {
@@ -8423,7 +8465,8 @@ ${ticket.description}` : "",
         "Do NOT use Claude Code's plan mode \u2014 write plans as markdown files.",
         "Do NOT ask the user for confirmation or approval.",
         "Do NOT stop or summarize between tickets \u2014 call autonomous_guide IMMEDIATELY.",
-        "You are in autonomous mode \u2014 continue working until done."
+        "You are in autonomous mode \u2014 continue working until done.",
+        ...versionWarning ? [`**Warning:** ${versionWarning}`] : []
       ],
       transitionedFrom: "INIT"
     });
@@ -8950,7 +8993,7 @@ function guideError(err) {
 }
 function readFileSafe2(path2) {
   try {
-    return readFileSync6(path2, "utf-8");
+    return readFileSync7(path2, "utf-8");
   } catch {
     return "";
   }
@@ -8960,8 +9003,8 @@ function readFileSafe2(path2) {
 init_esm_shims();
 init_session();
 init_session_types();
-import { readFileSync as readFileSync7, existsSync as existsSync10 } from "fs";
-import { join as join14 } from "path";
+import { readFileSync as readFileSync8, existsSync as existsSync10 } from "fs";
+import { join as join15 } from "path";
 
 // src/core/session-report-formatter.ts
 init_esm_shims();
@@ -9175,7 +9218,7 @@ async function handleSessionReport(sessionId, root, format = "md") {
       isError: true
     };
   }
-  const statePath2 = join14(dir, "state.json");
+  const statePath2 = join15(dir, "state.json");
   if (!existsSync10(statePath2)) {
     return {
       output: `Error: Session ${sessionId} corrupt \u2014 state.json missing.`,
@@ -9185,7 +9228,7 @@ async function handleSessionReport(sessionId, root, format = "md") {
     };
   }
   try {
-    const rawJson = JSON.parse(readFileSync7(statePath2, "utf-8"));
+    const rawJson = JSON.parse(readFileSync8(statePath2, "utf-8"));
     if (rawJson && typeof rawJson === "object" && "schemaVersion" in rawJson && rawJson.schemaVersion !== CURRENT_SESSION_SCHEMA_VERSION) {
       return {
         output: `Error: Session ${sessionId} \u2014 unsupported session schema version ${rawJson.schemaVersion}.`,
@@ -9214,7 +9257,7 @@ async function handleSessionReport(sessionId, root, format = "md") {
   const events = readEvents(dir);
   let planContent = null;
   try {
-    planContent = readFileSync7(join14(dir, "plan.md"), "utf-8");
+    planContent = readFileSync8(join15(dir, "plan.md"), "utf-8");
   } catch {
   }
   let gitLog = null;
@@ -9239,7 +9282,7 @@ init_issue();
 init_roadmap();
 init_output_formatter();
 init_helpers();
-import { join as join15, resolve as resolve6 } from "path";
+import { join as join16, resolve as resolve6 } from "path";
 var PHASE_ID_REGEX = /^[a-z0-9]+(-[a-z0-9]+)*$/;
 var PHASE_ID_MAX_LENGTH = 40;
 function validatePhaseId(id) {
@@ -9348,7 +9391,7 @@ function formatMcpError(code, message) {
 async function runMcpReadTool(pinnedRoot, handler) {
   try {
     const { state, warnings } = await loadProject(pinnedRoot);
-    const handoversDir = join16(pinnedRoot, ".story", "handovers");
+    const handoversDir = join17(pinnedRoot, ".story", "handovers");
     const ctx = { state, warnings, root: pinnedRoot, handoversDir, format: "md" };
     const result = await handler(ctx);
     if (result.errorCode && INFRASTRUCTURE_ERROR_CODES.includes(result.errorCode)) {
@@ -9906,10 +9949,10 @@ init_esm_shims();
 init_project_loader();
 init_errors();
 import { mkdir as mkdir4, stat as stat2, readFile as readFile4, writeFile as writeFile2 } from "fs/promises";
-import { join as join17, resolve as resolve7 } from "path";
+import { join as join18, resolve as resolve7 } from "path";
 async function initProject(root, options) {
   const absRoot = resolve7(root);
-  const wrapDir = join17(absRoot, ".story");
+  const wrapDir = join18(absRoot, ".story");
   let exists = false;
   try {
     const s = await stat2(wrapDir);
@@ -9929,11 +9972,11 @@ async function initProject(root, options) {
       ".story/ already exists. Use --force to overwrite config and roadmap."
     );
   }
-  await mkdir4(join17(wrapDir, "tickets"), { recursive: true });
-  await mkdir4(join17(wrapDir, "issues"), { recursive: true });
-  await mkdir4(join17(wrapDir, "handovers"), { recursive: true });
-  await mkdir4(join17(wrapDir, "notes"), { recursive: true });
-  await mkdir4(join17(wrapDir, "lessons"), { recursive: true });
+  await mkdir4(join18(wrapDir, "tickets"), { recursive: true });
+  await mkdir4(join18(wrapDir, "issues"), { recursive: true });
+  await mkdir4(join18(wrapDir, "handovers"), { recursive: true });
+  await mkdir4(join18(wrapDir, "notes"), { recursive: true });
+  await mkdir4(join18(wrapDir, "lessons"), { recursive: true });
   const created = [
     ".story/config.json",
     ".story/roadmap.json",
@@ -9973,7 +10016,7 @@ async function initProject(root, options) {
   };
   await writeConfig(config, absRoot);
   await writeRoadmap(roadmap, absRoot);
-  const gitignorePath = join17(wrapDir, ".gitignore");
+  const gitignorePath = join18(wrapDir, ".gitignore");
   await ensureGitignoreEntries(gitignorePath, STORY_GITIGNORE_ENTRIES);
   const warnings = [];
   if (options.force && exists) {
@@ -10012,7 +10055,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.40";
+var version = "0.1.42";
 function tryDiscoverRoot() {
   const envRoot = process.env[ENV_VAR2];
   if (envRoot) {
@@ -10024,7 +10067,7 @@ function tryDiscoverRoot() {
     const resolved = resolve8(envRoot);
     try {
       const canonical = realpathSync2(resolved);
-      if (existsSync11(join18(canonical, CONFIG_PATH2))) {
+      if (existsSync11(join19(canonical, CONFIG_PATH2))) {
         return canonical;
       }
       process.stderr.write(`Warning: No .story/config.json at ${canonical}

package/package.json

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