@anthropologies/claudestory 0.1.18 → 0.1.20

package/dist/cli.js

@@ -2993,6 +2993,14 @@ var init_validate = __esm({
 });
 
 // src/cli/commands/handover.ts
+var handover_exports = {};
+__export(handover_exports, {
+  handleHandoverCreate: () => handleHandoverCreate,
+  handleHandoverGet: () => handleHandoverGet,
+  handleHandoverLatest: () => handleHandoverLatest,
+  handleHandoverList: () => handleHandoverList,
+  normalizeSlug: () => normalizeSlug
+});
 import { existsSync as existsSync4 } from "fs";
 import { mkdir as mkdir2 } from "fs/promises";
 import { join as join4, resolve as resolve4 } from "path";
@@ -5144,9 +5152,10 @@ var init_session_types = __esm({
       // Recipe overrides (maxTicketsPerSession: 0 = no limit)
       config: z9.object({
         maxTicketsPerSession: z9.number().min(0).default(3),
+        handoverInterval: z9.number().min(0).default(5),
         compactThreshold: z9.string().default("high"),
         reviewBackends: z9.array(z9.string()).default(["codex", "agent"])
-      }).default({ maxTicketsPerSession: 3, compactThreshold: "high", reviewBackends: ["codex", "agent"] }),
+      }).default({ maxTicketsPerSession: 3, compactThreshold: "high", reviewBackends: ["codex", "agent"], handoverInterval: 5 }),
       // T-123: Issue sweep tracking
       issueSweepState: z9.object({
         remaining: z9.array(z9.string()),
@@ -5269,7 +5278,8 @@ function createSession(root, recipe, workspaceId, configOverrides) {
     config: {
       maxTicketsPerSession: configOverrides?.maxTicketsPerSession ?? 3,
       compactThreshold: configOverrides?.compactThreshold ?? "high",
-      reviewBackends: configOverrides?.reviewBackends ?? ["codex", "agent"]
+      reviewBackends: configOverrides?.reviewBackends ?? ["codex", "agent"],
+      handoverInterval: configOverrides?.handoverInterval ?? 5
     }
   };
   writeSessionSync(dir, state);
@@ -7219,21 +7229,38 @@ var init_complete = __esm({
                 'Call me with completedAction: "handover_written" and include the content in handoverContent.'
               ].join("\n"),
               reminders: [],
-              transitionedFrom: "COMPLETE",
-              contextAdvice: "ok"
+              transitionedFrom: "COMPLETE"
             }
           };
         }
+        const handoverInterval = ctx.state.config.handoverInterval ?? 5;
+        if (handoverInterval > 0 && ticketsDone > 0 && ticketsDone % handoverInterval === 0) {
+          try {
+            const { handleHandoverCreate: handleHandoverCreate3 } = await Promise.resolve().then(() => (init_handover(), handover_exports));
+            const completedIds = ctx.state.completedTickets.map((t) => t.id).join(", ");
+            const content = [
+              `# Checkpoint \u2014 ${ticketsDone} tickets completed`,
+              "",
+              `**Session:** ${ctx.state.sessionId}`,
+              `**Tickets:** ${completedIds}`,
+              "",
+              "This is an automatic mid-session checkpoint. The session is still active."
+            ].join("\n");
+            await handleHandoverCreate3(content, "checkpoint", "md", ctx.root);
+          } catch {
+          }
+          try {
+            const { loadProject: loadProject2 } = await Promise.resolve().then(() => (init_project_loader(), project_loader_exports));
+            const { saveSnapshot: saveSnapshot2 } = await Promise.resolve().then(() => (init_snapshot(), snapshot_exports));
+            const loadResult = await loadProject2(ctx.root);
+            await saveSnapshot2(ctx.root, loadResult);
+          } catch {
+          }
+          ctx.appendEvent("checkpoint", { ticketsDone, interval: handoverInterval });
+        }
         let nextTarget;
-        let advice = "ok";
         if (maxTickets > 0 && ticketsDone >= maxTickets) {
           nextTarget = "HANDOVER";
-        } else if (pressure === "critical") {
-          advice = "compact-now";
-          nextTarget = "PICK_TICKET";
-        } else if (pressure === "high") {
-          advice = "consider-compact";
-          nextTarget = "PICK_TICKET";
         } else {
           nextTarget = "PICK_TICKET";
         }
@@ -7262,7 +7289,7 @@ var init_complete = __esm({
               ].join("\n"),
               reminders: [],
               transitionedFrom: "COMPLETE",
-              contextAdvice: advice
+              contextAdvice: "ok"
             }
           };
         }
@@ -7730,6 +7757,7 @@ async function handleStart(root, args) {
       if (typeof overrides.maxTicketsPerSession === "number") sessionConfig.maxTicketsPerSession = overrides.maxTicketsPerSession;
       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;
     }
   } catch {
   }
@@ -8580,7 +8608,7 @@ function guideResult(state, currentState, opts) {
     transitionedFrom: opts.transitionedFrom,
     instruction: opts.instruction,
     reminders: opts.reminders ?? [],
-    contextAdvice: opts.contextAdvice ?? "ok",
+    contextAdvice: "ok",
     sessionSummary: summary
   };
   const parts = [
@@ -8594,7 +8622,6 @@ function guideResult(state, currentState, opts) {
     `**Completed:** ${summary.completed.length > 0 ? summary.completed.join(", ") : "none"}`,
     `**Tickets done:** ${summary.completed.length}`,
     summary.branch ? `**Branch:** ${summary.branch}` : "",
-    output.contextAdvice !== "ok" ? `**Context:** ${output.contextAdvice}` : "",
     output.reminders.length > 0 ? `
 **Reminders:**
 ${output.reminders.map((r) => `- ${r}`).join("\n")}` : ""
@@ -9996,7 +10023,7 @@ var init_mcp = __esm({
     init_init();
     ENV_VAR2 = "CLAUDESTORY_PROJECT_ROOT";
     CONFIG_PATH2 = ".story/config.json";
-    version = "0.1.18";
+    version = "0.1.20";
     main().catch((err) => {
       process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}
 `);
@@ -13274,7 +13301,7 @@ async function runCli() {
     registerConfigCommand: registerConfigCommand2,
     registerSessionCommand: registerSessionCommand2
   } = await Promise.resolve().then(() => (init_register(), register_exports));
-  const version2 = "0.1.18";
+  const version2 = "0.1.20";
   class HandledError extends Error {
     constructor() {
       super("HANDLED_ERROR");

package/dist/index.d.ts

@@ -1331,15 +1331,40 @@ declare const SnapshotV1Schema: z.ZodObject<{
         file: z.ZodString;
         message: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        message: string;
         type: string;
+        message: string;
         file: string;
     }, {
-        message: string;
         type: string;
+        message: 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;
@@ -1376,8 +1401,8 @@ declare const SnapshotV1Schema: z.ZodObject<{
         claimedBySession: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.ZodTypeAny, "passthrough">[];
     roadmap: {
-        title: string;
         date: string;
+        title: string;
         phases: z.objectOutputType<{
             id: z.ZodString;
             label: z.ZodString;
@@ -1395,7 +1420,6 @@ declare const SnapshotV1Schema: z.ZodObject<{
     } & {
         [k: string]: unknown;
     };
-    version: 1;
     project: string;
     notes: z.objectOutputType<{
         id: z.ZodString;
@@ -1421,11 +1445,19 @@ declare const SnapshotV1Schema: z.ZodObject<{
         status: z.ZodEnum<["active", "deprecated", "superseded"]>;
     }, z.ZodTypeAny, "passthrough">[];
     createdAt: string;
-    config: {
+    handoverFilenames: string[];
+    warnings?: {
         type: string;
+        message: string;
+        file: string;
+    }[] | undefined;
+}, {
+    version: 1;
+    config: {
         version: number;
-        project: string;
+        type: string;
         language: string;
+        project: string;
         features: {
             issues: boolean;
             tickets: boolean;
@@ -1445,13 +1477,6 @@ declare const SnapshotV1Schema: z.ZodObject<{
     } & {
         [k: string]: unknown;
     };
-    handoverFilenames: string[];
-    warnings?: {
-        message: string;
-        type: string;
-        file: string;
-    }[] | undefined;
-}, {
     issues: z.objectInputType<{
         id: z.ZodString;
         title: z.ZodString;
@@ -1488,8 +1513,8 @@ declare const SnapshotV1Schema: z.ZodObject<{
         claimedBySession: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.ZodTypeAny, "passthrough">[];
     roadmap: {
-        title: string;
         date: string;
+        title: string;
         phases: z.objectInputType<{
             id: z.ZodString;
             label: z.ZodString;
@@ -1507,33 +1532,8 @@ 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;
-        } | undefined;
-    } & {
-        [k: string]: unknown;
-    };
     notes?: z.objectInputType<{
         id: z.ZodString;
         title: z.ZodNullable<z.ZodString>;
@@ -1558,8 +1558,8 @@ declare const SnapshotV1Schema: z.ZodObject<{
         status: z.ZodEnum<["active", "deprecated", "superseded"]>;
     }, z.ZodTypeAny, "passthrough">[] | undefined;
     warnings?: {
-        message: string;
         type: string;
+        message: string;
         file: string;
     }[] | undefined;
     handoverFilenames?: string[] | undefined;

package/dist/mcp.js

@@ -2689,6 +2689,157 @@ var init_validation = __esm({
   }
 });
 
+// src/cli/commands/handover.ts
+var handover_exports = {};
+__export(handover_exports, {
+  handleHandoverCreate: () => handleHandoverCreate,
+  handleHandoverGet: () => handleHandoverGet,
+  handleHandoverLatest: () => handleHandoverLatest,
+  handleHandoverList: () => handleHandoverList,
+  normalizeSlug: () => normalizeSlug
+});
+import { existsSync as existsSync4 } from "fs";
+import { mkdir as mkdir2 } from "fs/promises";
+import { join as join4, resolve as resolve4 } from "path";
+function handleHandoverList(ctx) {
+  return { output: formatHandoverList(ctx.state.handoverFilenames, ctx.format) };
+}
+async function handleHandoverLatest(ctx, count = 1) {
+  if (ctx.state.handoverFilenames.length === 0) {
+    return {
+      output: formatError("not_found", "No handovers found", ctx.format),
+      exitCode: ExitCode.USER_ERROR,
+      errorCode: "not_found"
+    };
+  }
+  const filenames = ctx.state.handoverFilenames.slice(0, count);
+  const parts = [];
+  for (const filename of filenames) {
+    await parseHandoverFilename(filename, ctx.handoversDir);
+    try {
+      const content = await readHandover(ctx.handoversDir, filename);
+      parts.push(formatHandoverContent(filename, content, ctx.format));
+    } catch (err) {
+      if (err.code === "ENOENT") {
+        if (count > 1) continue;
+        return {
+          output: formatError("not_found", `Handover file not found: ${filename}`, ctx.format),
+          exitCode: ExitCode.USER_ERROR,
+          errorCode: "not_found"
+        };
+      }
+      return {
+        output: formatError("io_error", `Cannot read handover: ${err.message}`, ctx.format),
+        exitCode: ExitCode.USER_ERROR,
+        errorCode: "io_error"
+      };
+    }
+  }
+  if (parts.length === 0) {
+    return {
+      output: formatError("not_found", "No handovers found", ctx.format),
+      exitCode: ExitCode.USER_ERROR,
+      errorCode: "not_found"
+    };
+  }
+  const separator = ctx.format === "json" ? "\n" : "\n\n---\n\n";
+  return { output: parts.join(separator) };
+}
+async function handleHandoverGet(filename, ctx) {
+  await parseHandoverFilename(filename, ctx.handoversDir);
+  try {
+    const content = await readHandover(ctx.handoversDir, filename);
+    return { output: formatHandoverContent(filename, content, ctx.format) };
+  } catch (err) {
+    if (err.code === "ENOENT") {
+      return {
+        output: formatError("not_found", `Handover not found: ${filename}`, ctx.format),
+        exitCode: ExitCode.USER_ERROR,
+        errorCode: "not_found"
+      };
+    }
+    return {
+      output: formatError("io_error", `Cannot read handover: ${err.message}`, ctx.format),
+      exitCode: ExitCode.USER_ERROR,
+      errorCode: "io_error"
+    };
+  }
+}
+function normalizeSlug(raw) {
+  let slug = raw.trim().toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "").replace(/-+/g, "-").replace(/^-|-$/g, "");
+  if (slug.length > 60) slug = slug.slice(0, 60).replace(/-$/, "");
+  if (!slug) {
+    throw new CliValidationError(
+      "invalid_input",
+      `Slug is empty after normalization: "${raw}"`
+    );
+  }
+  return slug;
+}
+async function handleHandoverCreate(content, slugRaw, format, root) {
+  if (!content.trim()) {
+    throw new CliValidationError("invalid_input", "Handover content is empty");
+  }
+  const slug = normalizeSlug(slugRaw);
+  const date = todayISO();
+  let filename;
+  await withProjectLock(root, { strict: false }, async () => {
+    const absRoot = resolve4(root);
+    const handoversDir = join4(absRoot, ".story", "handovers");
+    await mkdir2(handoversDir, { recursive: true });
+    const wrapDir = join4(absRoot, ".story");
+    const datePrefix = `${date}-`;
+    const seqRegex = new RegExp(`^${date}-(\\d{2})-`);
+    let maxSeq = 0;
+    const { readdirSync: readdirSync2 } = await import("fs");
+    try {
+      for (const f of readdirSync2(handoversDir)) {
+        const m = f.match(seqRegex);
+        if (m) {
+          const n = parseInt(m[1], 10);
+          if (n > maxSeq) maxSeq = n;
+        }
+      }
+    } catch {
+    }
+    let nextSeq = maxSeq + 1;
+    if (nextSeq > 99) {
+      throw new CliValidationError(
+        "conflict",
+        `Too many handovers for ${date}; limit is 99 per day`
+      );
+    }
+    let candidate = `${date}-${String(nextSeq).padStart(2, "0")}-${slug}.md`;
+    let candidatePath = join4(handoversDir, candidate);
+    while (existsSync4(candidatePath)) {
+      nextSeq++;
+      if (nextSeq > 99) {
+        throw new CliValidationError(
+          "conflict",
+          `Too many handovers for ${date}; limit is 99 per day`
+        );
+      }
+      candidate = `${date}-${String(nextSeq).padStart(2, "0")}-${slug}.md`;
+      candidatePath = join4(handoversDir, candidate);
+    }
+    await parseHandoverFilename(candidate, handoversDir);
+    await guardPath(candidatePath, wrapDir);
+    await atomicWrite(candidatePath, content);
+    filename = candidate;
+  });
+  return { output: formatHandoverCreateResult(filename, format) };
+}
+var init_handover = __esm({
+  "src/cli/commands/handover.ts"() {
+    "use strict";
+    init_esm_shims();
+    init_handover_parser();
+    init_output_formatter();
+    init_project_loader();
+    init_helpers();
+  }
+});
+
 // src/core/id-allocation.ts
 function nextTicketID(tickets) {
   let max = 0;
@@ -3445,9 +3596,10 @@ var init_session_types = __esm({
       // Recipe overrides (maxTicketsPerSession: 0 = no limit)
       config: z9.object({
         maxTicketsPerSession: z9.number().min(0).default(3),
+        handoverInterval: z9.number().min(0).default(5),
         compactThreshold: z9.string().default("high"),
         reviewBackends: z9.array(z9.string()).default(["codex", "agent"])
-      }).default({ maxTicketsPerSession: 3, compactThreshold: "high", reviewBackends: ["codex", "agent"] }),
+      }).default({ maxTicketsPerSession: 3, compactThreshold: "high", reviewBackends: ["codex", "agent"], handoverInterval: 5 }),
       // T-123: Issue sweep tracking
       issueSweepState: z9.object({
         remaining: z9.array(z9.string()),
@@ -3570,7 +3722,8 @@ function createSession(root, recipe, workspaceId, configOverrides) {
     config: {
       maxTicketsPerSession: configOverrides?.maxTicketsPerSession ?? 3,
       compactThreshold: configOverrides?.compactThreshold ?? "high",
-      reviewBackends: configOverrides?.reviewBackends ?? ["codex", "agent"]
+      reviewBackends: configOverrides?.reviewBackends ?? ["codex", "agent"],
+      handoverInterval: configOverrides?.handoverInterval ?? 5
     }
   };
   writeSessionSync(dir, state);
@@ -3926,143 +4079,8 @@ function handleValidate(ctx) {
   };
 }
 
-// src/cli/commands/handover.ts
-init_esm_shims();
-init_handover_parser();
-init_output_formatter();
-init_project_loader();
-init_helpers();
-import { existsSync as existsSync4 } from "fs";
-import { mkdir as mkdir2 } from "fs/promises";
-import { join as join4, resolve as resolve4 } from "path";
-function handleHandoverList(ctx) {
-  return { output: formatHandoverList(ctx.state.handoverFilenames, ctx.format) };
-}
-async function handleHandoverLatest(ctx, count = 1) {
-  if (ctx.state.handoverFilenames.length === 0) {
-    return {
-      output: formatError("not_found", "No handovers found", ctx.format),
-      exitCode: ExitCode.USER_ERROR,
-      errorCode: "not_found"
-    };
-  }
-  const filenames = ctx.state.handoverFilenames.slice(0, count);
-  const parts = [];
-  for (const filename of filenames) {
-    await parseHandoverFilename(filename, ctx.handoversDir);
-    try {
-      const content = await readHandover(ctx.handoversDir, filename);
-      parts.push(formatHandoverContent(filename, content, ctx.format));
-    } catch (err) {
-      if (err.code === "ENOENT") {
-        if (count > 1) continue;
-        return {
-          output: formatError("not_found", `Handover file not found: ${filename}`, ctx.format),
-          exitCode: ExitCode.USER_ERROR,
-          errorCode: "not_found"
-        };
-      }
-      return {
-        output: formatError("io_error", `Cannot read handover: ${err.message}`, ctx.format),
-        exitCode: ExitCode.USER_ERROR,
-        errorCode: "io_error"
-      };
-    }
-  }
-  if (parts.length === 0) {
-    return {
-      output: formatError("not_found", "No handovers found", ctx.format),
-      exitCode: ExitCode.USER_ERROR,
-      errorCode: "not_found"
-    };
-  }
-  const separator = ctx.format === "json" ? "\n" : "\n\n---\n\n";
-  return { output: parts.join(separator) };
-}
-async function handleHandoverGet(filename, ctx) {
-  await parseHandoverFilename(filename, ctx.handoversDir);
-  try {
-    const content = await readHandover(ctx.handoversDir, filename);
-    return { output: formatHandoverContent(filename, content, ctx.format) };
-  } catch (err) {
-    if (err.code === "ENOENT") {
-      return {
-        output: formatError("not_found", `Handover not found: ${filename}`, ctx.format),
-        exitCode: ExitCode.USER_ERROR,
-        errorCode: "not_found"
-      };
-    }
-    return {
-      output: formatError("io_error", `Cannot read handover: ${err.message}`, ctx.format),
-      exitCode: ExitCode.USER_ERROR,
-      errorCode: "io_error"
-    };
-  }
-}
-function normalizeSlug(raw) {
-  let slug = raw.trim().toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "").replace(/-+/g, "-").replace(/^-|-$/g, "");
-  if (slug.length > 60) slug = slug.slice(0, 60).replace(/-$/, "");
-  if (!slug) {
-    throw new CliValidationError(
-      "invalid_input",
-      `Slug is empty after normalization: "${raw}"`
-    );
-  }
-  return slug;
-}
-async function handleHandoverCreate(content, slugRaw, format, root) {
-  if (!content.trim()) {
-    throw new CliValidationError("invalid_input", "Handover content is empty");
-  }
-  const slug = normalizeSlug(slugRaw);
-  const date = todayISO();
-  let filename;
-  await withProjectLock(root, { strict: false }, async () => {
-    const absRoot = resolve4(root);
-    const handoversDir = join4(absRoot, ".story", "handovers");
-    await mkdir2(handoversDir, { recursive: true });
-    const wrapDir = join4(absRoot, ".story");
-    const datePrefix = `${date}-`;
-    const seqRegex = new RegExp(`^${date}-(\\d{2})-`);
-    let maxSeq = 0;
-    const { readdirSync: readdirSync2 } = await import("fs");
-    try {
-      for (const f of readdirSync2(handoversDir)) {
-        const m = f.match(seqRegex);
-        if (m) {
-          const n = parseInt(m[1], 10);
-          if (n > maxSeq) maxSeq = n;
-        }
-      }
-    } catch {
-    }
-    let nextSeq = maxSeq + 1;
-    if (nextSeq > 99) {
-      throw new CliValidationError(
-        "conflict",
-        `Too many handovers for ${date}; limit is 99 per day`
-      );
-    }
-    let candidate = `${date}-${String(nextSeq).padStart(2, "0")}-${slug}.md`;
-    let candidatePath = join4(handoversDir, candidate);
-    while (existsSync4(candidatePath)) {
-      nextSeq++;
-      if (nextSeq > 99) {
-        throw new CliValidationError(
-          "conflict",
-          `Too many handovers for ${date}; limit is 99 per day`
-        );
-      }
-      candidate = `${date}-${String(nextSeq).padStart(2, "0")}-${slug}.md`;
-      candidatePath = join4(handoversDir, candidate);
-    }
-    await parseHandoverFilename(candidate, handoversDir);
-    await guardPath(candidatePath, wrapDir);
-    await atomicWrite(candidatePath, content);
-    filename = candidate;
-  });
-  return { output: formatHandoverCreateResult(filename, format) };
-}
+// src/mcp/tools.ts
+init_handover();
 
 // src/cli/commands/blocker.ts
 init_esm_shims();
@@ -5149,6 +5167,9 @@ function errMsg(err) {
   return err instanceof Error ? err.message : String(err);
 }
 
+// src/mcp/tools.ts
+init_handover();
+
 // src/autonomous/guide.ts
 init_esm_shims();
 init_session_types();
@@ -6722,21 +6743,38 @@ var CompleteStage = class {
             'Call me with completedAction: "handover_written" and include the content in handoverContent.'
           ].join("\n"),
           reminders: [],
-          transitionedFrom: "COMPLETE",
-          contextAdvice: "ok"
+          transitionedFrom: "COMPLETE"
         }
       };
     }
+    const handoverInterval = ctx.state.config.handoverInterval ?? 5;
+    if (handoverInterval > 0 && ticketsDone > 0 && ticketsDone % handoverInterval === 0) {
+      try {
+        const { handleHandoverCreate: handleHandoverCreate3 } = await Promise.resolve().then(() => (init_handover(), handover_exports));
+        const completedIds = ctx.state.completedTickets.map((t) => t.id).join(", ");
+        const content = [
+          `# Checkpoint \u2014 ${ticketsDone} tickets completed`,
+          "",
+          `**Session:** ${ctx.state.sessionId}`,
+          `**Tickets:** ${completedIds}`,
+          "",
+          "This is an automatic mid-session checkpoint. The session is still active."
+        ].join("\n");
+        await handleHandoverCreate3(content, "checkpoint", "md", ctx.root);
+      } catch {
+      }
+      try {
+        const { loadProject: loadProject2 } = await Promise.resolve().then(() => (init_project_loader(), project_loader_exports));
+        const { saveSnapshot: saveSnapshot2 } = await Promise.resolve().then(() => (init_snapshot(), snapshot_exports));
+        const loadResult = await loadProject2(ctx.root);
+        await saveSnapshot2(ctx.root, loadResult);
+      } catch {
+      }
+      ctx.appendEvent("checkpoint", { ticketsDone, interval: handoverInterval });
+    }
     let nextTarget;
-    let advice = "ok";
     if (maxTickets > 0 && ticketsDone >= maxTickets) {
       nextTarget = "HANDOVER";
-    } else if (pressure === "critical") {
-      advice = "compact-now";
-      nextTarget = "PICK_TICKET";
-    } else if (pressure === "high") {
-      advice = "consider-compact";
-      nextTarget = "PICK_TICKET";
     } else {
       nextTarget = "PICK_TICKET";
     }
@@ -6765,7 +6803,7 @@ var CompleteStage = class {
           ].join("\n"),
           reminders: [],
           transitionedFrom: "COMPLETE",
-          contextAdvice: advice
+          contextAdvice: "ok"
         }
       };
     }
@@ -6911,6 +6949,7 @@ Impact: ${nextIssue.impact}` : ""}` : `Fix issue ${next}.`,
 
 // src/autonomous/stages/handover.ts
 init_esm_shims();
+init_handover();
 import { writeFileSync as writeFileSync2 } from "fs";
 import { join as join10 } from "path";
 var HandoverStage = class {
@@ -7005,6 +7044,7 @@ init_project_loader();
 init_snapshot();
 init_snapshot();
 init_queries();
+init_handover();
 async function recoverPendingMutation(dir, state, root) {
   const mutation = state.pendingProjectMutation;
   if (!mutation || typeof mutation !== "object") return state;
@@ -7206,6 +7246,7 @@ async function handleStart(root, args) {
       if (typeof overrides.maxTicketsPerSession === "number") sessionConfig.maxTicketsPerSession = overrides.maxTicketsPerSession;
       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;
     }
   } catch {
   }
@@ -8057,7 +8098,7 @@ function guideResult(state, currentState, opts) {
     transitionedFrom: opts.transitionedFrom,
     instruction: opts.instruction,
     reminders: opts.reminders ?? [],
-    contextAdvice: opts.contextAdvice ?? "ok",
+    contextAdvice: "ok",
     sessionSummary: summary
   };
   const parts = [
@@ -8071,7 +8112,6 @@ function guideResult(state, currentState, opts) {
     `**Completed:** ${summary.completed.length > 0 ? summary.completed.join(", ") : "none"}`,
     `**Tickets done:** ${summary.completed.length}`,
     summary.branch ? `**Branch:** ${summary.branch}` : "",
-    output.contextAdvice !== "ok" ? `**Context:** ${output.contextAdvice}` : "",
     output.reminders.length > 0 ? `
 **Reminders:**
 ${output.reminders.map((r) => `- ${r}`).join("\n")}` : ""
@@ -9148,7 +9188,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.18";
+var version = "0.1.20";
 function tryDiscoverRoot() {
   const envRoot = process.env[ENV_VAR2];
   if (envRoot) {

package/package.json

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