@anthropologies/claudestory 0.1.4 → 0.1.5

package/dist/cli.js

@@ -484,6 +484,12 @@ function formatHandoverContent(filename, content, format) {
   }
   return content;
 }
+function formatHandoverCreateResult(filename, format) {
+  if (format === "json") {
+    return JSON.stringify(successEnvelope({ filename }), null, 2);
+  }
+  return `Created handover: ${filename}`;
+}
 function formatSnapshotResult(result, format) {
   if (format === "json") {
     return JSON.stringify(successEnvelope(result), null, 2);
@@ -1119,6 +1125,7 @@ import { readdir, readFile } from "fs/promises";
 import { existsSync } from "fs";
 import { join, relative, extname } from "path";
 var HANDOVER_DATE_REGEX = /^\d{4}-\d{2}-\d{2}/;
+var HANDOVER_SEQ_REGEX = /^(\d{4}-\d{2}-\d{2})-(\d{2})-/;
 async function listHandovers(handoversDir, root, warnings) {
   if (!existsSync(handoversDir)) return [];
   let entries;
@@ -1148,7 +1155,16 @@ async function listHandovers(handoversDir, root, warnings) {
       });
     }
   }
-  conforming.sort((a, b) => b.localeCompare(a));
+  conforming.sort((a, b) => {
+    const dateA = a.slice(0, 10);
+    const dateB = b.slice(0, 10);
+    if (dateA !== dateB) return dateB.localeCompare(dateA);
+    const seqA = a.match(HANDOVER_SEQ_REGEX);
+    const seqB = b.match(HANDOVER_SEQ_REGEX);
+    if (seqA && !seqB) return -1;
+    if (!seqA && seqB) return 1;
+    return b.localeCompare(a);
+  });
   return [...conforming, ...nonConforming];
 }
 async function readHandover(handoversDir, filename) {
@@ -2524,6 +2540,8 @@ function handleValidate(ctx) {
 
 // src/cli/commands/handover.ts
 init_esm_shims();
+import { mkdir as mkdir3 } from "fs/promises";
+import { join as join7, resolve as resolve6 } from "path";
 function handleHandoverList(ctx) {
   return { output: formatHandoverList(ctx.state.handoverFilenames, ctx.format) };
 }
@@ -2575,6 +2593,59 @@ async function handleHandoverGet(filename, ctx) {
     };
   }
 }
+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 = resolve6(root);
+    const handoversDir = join7(absRoot, ".story", "handovers");
+    await mkdir3(handoversDir, { recursive: true });
+    const wrapDir = join7(absRoot, ".story");
+    const datePrefix = `${date}-`;
+    const seqRegex = new RegExp(`^${date}-(\\d{2})-`);
+    let maxSeq = 0;
+    const { readdirSync } = await import("fs");
+    try {
+      for (const f of readdirSync(handoversDir)) {
+        const m = f.match(seqRegex);
+        if (m) {
+          const n = parseInt(m[1], 10);
+          if (n > maxSeq) maxSeq = n;
+        }
+      }
+    } catch {
+    }
+    const nextSeq = maxSeq + 1;
+    if (nextSeq > 99) {
+      throw new CliValidationError(
+        "conflict",
+        `Too many handovers for ${date}; limit is 99 per day`
+      );
+    }
+    const candidate = `${date}-${String(nextSeq).padStart(2, "0")}-${slug}.md`;
+    const candidatePath = join7(handoversDir, candidate);
+    await parseHandoverFilename(candidate, handoversDir);
+    await guardPath(candidatePath, wrapDir);
+    await atomicWrite(candidatePath, content);
+    filename = candidate;
+  });
+  return { output: formatHandoverCreateResult(filename, format) };
+}
 
 // src/cli/commands/blocker.ts
 init_esm_shims();
@@ -3000,7 +3071,7 @@ async function handleIssueDelete(id, format, root) {
 
 // src/cli/commands/phase.ts
 init_esm_shims();
-import { join as join7, resolve as resolve6 } from "path";
+import { join as join8, resolve as resolve7 } from "path";
 var PHASE_ID_REGEX = /^[a-z0-9]+(-[a-z0-9]+)*$/;
 var PHASE_ID_MAX_LENGTH = 40;
 function validatePhaseId(id) {
@@ -3183,7 +3254,7 @@ async function handlePhaseDelete(id, reassign, format, root) {
       }
       const targetLeaves = state.phaseTickets(reassign);
       let maxOrder = targetLeaves.length > 0 ? targetLeaves[targetLeaves.length - 1].order : 0;
-      const wrapDir = resolve6(root, ".story");
+      const wrapDir = resolve7(root, ".story");
       const operations = [];
       const sortedTickets = [...affectedTickets].sort((a, b) => a.order - b.order);
       for (const ticket of sortedTickets) {
@@ -3191,21 +3262,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 = join7(wrapDir, "tickets", `${parsed.id}.json`);
+        const target = join8(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 = join7(wrapDir, "issues", `${parsed.id}.json`);
+        const target = join8(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 = join7(wrapDir, "roadmap.json");
+      const roadmapTarget = join8(wrapDir, "roadmap.json");
       operations.push({ op: "write", target: roadmapTarget, content: roadmapContent });
       await runTransactionUnlocked(root, operations);
     } else {
@@ -3383,7 +3454,83 @@ function registerHandoverCommand(yargs2) {
           (ctx) => handleHandoverGet(filename, ctx)
         );
       }
-    ).demandCommand(1, "Specify a handover subcommand: list, latest, get").strict(),
+    ).command(
+      "create",
+      "Create a new handover document",
+      (y2) => addFormatOption(
+        y2.option("content", {
+          type: "string",
+          describe: "Handover content (markdown string)"
+        }).option("stdin", {
+          type: "boolean",
+          describe: "Read content from stdin"
+        }).option("slug", {
+          type: "string",
+          default: "session",
+          describe: "Slug for filename (e.g. phase5b-wrapup)"
+        }).conflicts("content", "stdin").check((argv) => {
+          if (!argv.content && !argv.stdin) {
+            throw new Error(
+              "Specify either --content or --stdin"
+            );
+          }
+          return true;
+        })
+      ),
+      async (argv) => {
+        const format = parseOutputFormat(argv.format);
+        const root = (await Promise.resolve().then(() => (init_project_root_discovery(), project_root_discovery_exports))).discoverProjectRoot();
+        if (!root) {
+          writeOutput(
+            formatError("not_found", "No .story/ project found.", format)
+          );
+          process.exitCode = ExitCode.USER_ERROR;
+          return;
+        }
+        let content;
+        if (argv.stdin) {
+          if (process.stdin.isTTY) {
+            writeOutput(
+              formatError("invalid_input", "Cannot read from stdin: no pipe detected. Use --content instead.", format)
+            );
+            process.exitCode = ExitCode.USER_ERROR;
+            return;
+          }
+          const chunks = [];
+          for await (const chunk of process.stdin) {
+            chunks.push(chunk);
+          }
+          content = Buffer.concat(chunks).toString("utf-8");
+        } else {
+          content = argv.content;
+        }
+        try {
+          const result = await handleHandoverCreate(
+            content,
+            argv.slug,
+            format,
+            root
+          );
+          writeOutput(result.output);
+          process.exitCode = result.exitCode ?? ExitCode.OK;
+        } catch (err) {
+          if (err instanceof CliValidationError) {
+            writeOutput(formatError(err.code, err.message, format));
+            process.exitCode = ExitCode.USER_ERROR;
+            return;
+          }
+          const { ProjectLoaderError: ProjectLoaderError2 } = await Promise.resolve().then(() => (init_errors(), errors_exports));
+          if (err instanceof ProjectLoaderError2) {
+            writeOutput(formatError(err.code, err.message, format));
+            process.exitCode = ExitCode.USER_ERROR;
+            return;
+          }
+          const message = err instanceof Error ? err.message : String(err);
+          writeOutput(formatError("io_error", message, format));
+          process.exitCode = ExitCode.USER_ERROR;
+        }
+      }
+    ).demandCommand(1, "Specify a handover subcommand: list, latest, get, create").strict(),
     () => {
     }
   );
@@ -4396,7 +4543,7 @@ function registerExportCommand(yargs2) {
 }
 
 // src/cli/index.ts
-var version = "0.1.4";
+var version = "0.1.5";
 var HandledError = class extends Error {
   constructor() {
     super("HANDLED_ERROR");

package/dist/index.d.ts

@@ -1364,6 +1364,7 @@ declare function formatInitResult(result: {
 }, format: OutputFormat): string;
 declare function formatHandoverList(filenames: readonly string[], format: OutputFormat): string;
 declare function formatHandoverContent(filename: string, content: string, format: OutputFormat): string;
+declare function formatHandoverCreateResult(filename: string, format: OutputFormat): string;
 
 declare function formatSnapshotResult(result: {
     filename: string;
@@ -1373,4 +1374,4 @@ declare function formatSnapshotResult(result: {
 declare function formatRecap(recap: RecapResult, state: ProjectState, format: OutputFormat): string;
 declare function formatExport(state: ProjectState, mode: "all" | "phase", phaseId: string | null, format: OutputFormat): string;
 
-export { type Blocker, BlockerSchema, CURRENT_SCHEMA_VERSION, type Config, ConfigSchema, DATE_REGEX, DateSchema, ERROR_CODES, type ErrorCode, type ErrorEnvelope, ExitCode, type ExitCodeValue, type Features, FeaturesSchema, INTEGRITY_WARNING_TYPES, ISSUE_ID_REGEX, ISSUE_SEVERITIES, ISSUE_STATUSES, type InitOptions, type InitResult, type Issue, IssueIdSchema, IssueSchema, type IssueSeverity, type IssueStatus, type LoadOptions, type LoadResult, type LoadWarning, type LoadWarningType, type NextTicketAllBlocked, type NextTicketAllComplete, type NextTicketEmpty, type NextTicketOutcome, type NextTicketResult, OUTPUT_FORMATS, type OutputFormat, type PartialEnvelope, type Phase, PhaseSchema, type PhaseStatus, type PhaseWithStatus, ProjectLoaderError, ProjectState, type RecapResult, type Roadmap, RoadmapSchema, type SnapshotDiff, type SnapshotV1, SnapshotV1Schema, type SuccessEnvelope, TICKET_ID_REGEX, TICKET_STATUSES, TICKET_TYPES, type Ticket, TicketIdSchema, TicketSchema, type TicketStatus, type TicketType, type UmbrellaProgress, type UnblockImpact, type ValidationFinding, type ValidationLevel, type ValidationResult, type WithProjectLockOptions, atomicWrite, blockedTickets, buildRecap, currentPhase, deleteIssue, deleteTicket, diffStates, discoverProjectRoot, errorEnvelope, escapeMarkdownInline, extractHandoverDate, fencedBlock, formatBlockedTickets, formatBlockerList, formatError, formatExport, formatHandoverContent, formatHandoverList, formatInitResult, formatIssue, formatIssueList, formatNextTicketOutcome, formatPhaseList, formatPhaseTickets, formatRecap, formatSnapshotResult, formatStatus, formatTicket, formatTicketList, formatValidation, guardPath, initProject, isBlockerCleared, listHandovers, loadLatestSnapshot, loadProject, mergeValidation, nextIssueID, nextOrder, nextTicket, nextTicketID, partialEnvelope, phasesWithStatus, readHandover, runTransaction, runTransactionUnlocked, saveSnapshot, serializeJSON, sortKeysDeep, successEnvelope, ticketsUnblockedBy, umbrellaProgress, validateProject, withProjectLock, writeConfig, writeIssue, writeIssueUnlocked, writeRoadmap, writeRoadmapUnlocked, writeTicket, writeTicketUnlocked };
+export { type Blocker, BlockerSchema, CURRENT_SCHEMA_VERSION, type Config, ConfigSchema, DATE_REGEX, DateSchema, ERROR_CODES, type ErrorCode, type ErrorEnvelope, ExitCode, type ExitCodeValue, type Features, FeaturesSchema, INTEGRITY_WARNING_TYPES, ISSUE_ID_REGEX, ISSUE_SEVERITIES, ISSUE_STATUSES, type InitOptions, type InitResult, type Issue, IssueIdSchema, IssueSchema, type IssueSeverity, type IssueStatus, type LoadOptions, type LoadResult, type LoadWarning, type LoadWarningType, type NextTicketAllBlocked, type NextTicketAllComplete, type NextTicketEmpty, type NextTicketOutcome, type NextTicketResult, OUTPUT_FORMATS, type OutputFormat, type PartialEnvelope, type Phase, PhaseSchema, type PhaseStatus, type PhaseWithStatus, ProjectLoaderError, ProjectState, type RecapResult, type Roadmap, RoadmapSchema, type SnapshotDiff, type SnapshotV1, SnapshotV1Schema, type SuccessEnvelope, TICKET_ID_REGEX, TICKET_STATUSES, TICKET_TYPES, type Ticket, TicketIdSchema, TicketSchema, type TicketStatus, type TicketType, type UmbrellaProgress, type UnblockImpact, type ValidationFinding, type ValidationLevel, type ValidationResult, type WithProjectLockOptions, atomicWrite, blockedTickets, buildRecap, currentPhase, deleteIssue, deleteTicket, diffStates, discoverProjectRoot, errorEnvelope, escapeMarkdownInline, extractHandoverDate, fencedBlock, formatBlockedTickets, formatBlockerList, formatError, formatExport, formatHandoverContent, formatHandoverCreateResult, formatHandoverList, formatInitResult, formatIssue, formatIssueList, formatNextTicketOutcome, formatPhaseList, formatPhaseTickets, formatRecap, formatSnapshotResult, formatStatus, formatTicket, formatTicketList, formatValidation, guardPath, initProject, isBlockerCleared, listHandovers, loadLatestSnapshot, loadProject, mergeValidation, nextIssueID, nextOrder, nextTicket, nextTicketID, partialEnvelope, phasesWithStatus, readHandover, runTransaction, runTransactionUnlocked, saveSnapshot, serializeJSON, sortKeysDeep, successEnvelope, ticketsUnblockedBy, umbrellaProgress, validateProject, withProjectLock, writeConfig, writeIssue, writeIssueUnlocked, writeRoadmap, writeRoadmapUnlocked, writeTicket, writeTicketUnlocked };

package/dist/index.js

@@ -358,6 +358,7 @@ import { readdir, readFile } from "fs/promises";
 import { existsSync } from "fs";
 import { join, relative, extname } from "path";
 var HANDOVER_DATE_REGEX = /^\d{4}-\d{2}-\d{2}/;
+var HANDOVER_SEQ_REGEX = /^(\d{4}-\d{2}-\d{2})-(\d{2})-/;
 async function listHandovers(handoversDir, root, warnings) {
   if (!existsSync(handoversDir)) return [];
   let entries;
@@ -387,7 +388,16 @@ async function listHandovers(handoversDir, root, warnings) {
       });
     }
   }
-  conforming.sort((a, b) => b.localeCompare(a));
+  conforming.sort((a, b) => {
+    const dateA = a.slice(0, 10);
+    const dateB = b.slice(0, 10);
+    if (dateA !== dateB) return dateB.localeCompare(dateA);
+    const seqA = a.match(HANDOVER_SEQ_REGEX);
+    const seqB = b.match(HANDOVER_SEQ_REGEX);
+    if (seqA && !seqB) return -1;
+    if (!seqA && seqB) return 1;
+    return b.localeCompare(a);
+  });
   return [...conforming, ...nonConforming];
 }
 async function readHandover(handoversDir, filename) {
@@ -1974,6 +1984,12 @@ function formatHandoverContent(filename, content, format) {
   }
   return content;
 }
+function formatHandoverCreateResult(filename, format) {
+  if (format === "json") {
+    return JSON.stringify(successEnvelope({ filename }), null, 2);
+  }
+  return `Created handover: ${filename}`;
+}
 function formatSnapshotResult(result, format) {
   if (format === "json") {
     return JSON.stringify(successEnvelope(result), null, 2);
@@ -2298,6 +2314,7 @@ export {
   formatError,
   formatExport,
   formatHandoverContent,
+  formatHandoverCreateResult,
   formatHandoverList,
   formatInitResult,
   formatIssue,

package/dist/mcp.js

@@ -2,7 +2,7 @@
 
 // src/mcp/index.ts
 import { realpathSync, existsSync as existsSync5 } from "fs";
-import { resolve as resolve6, join as join7, isAbsolute } from "path";
+import { resolve as resolve7, join as join8, isAbsolute } from "path";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
@@ -34,7 +34,7 @@ function discoverProjectRoot(startDir) {
 
 // src/mcp/tools.ts
 import { z as z7 } from "zod";
-import { join as join6 } from "path";
+import { join as join7 } from "path";
 
 // src/core/project-loader.ts
 import {
@@ -386,6 +386,7 @@ import { readdir, readFile } from "fs/promises";
 import { existsSync as existsSync2 } from "fs";
 import { join as join2, relative, extname } from "path";
 var HANDOVER_DATE_REGEX = /^\d{4}-\d{2}-\d{2}/;
+var HANDOVER_SEQ_REGEX = /^(\d{4}-\d{2}-\d{2})-(\d{2})-/;
 async function listHandovers(handoversDir, root, warnings) {
   if (!existsSync2(handoversDir)) return [];
   let entries;
@@ -415,7 +416,16 @@ async function listHandovers(handoversDir, root, warnings) {
       });
     }
   }
-  conforming.sort((a, b) => b.localeCompare(a));
+  conforming.sort((a, b) => {
+    const dateA = a.slice(0, 10);
+    const dateB = b.slice(0, 10);
+    if (dateA !== dateB) return dateB.localeCompare(dateA);
+    const seqA = a.match(HANDOVER_SEQ_REGEX);
+    const seqB = b.match(HANDOVER_SEQ_REGEX);
+    if (seqA && !seqB) return -1;
+    if (!seqA && seqB) return 1;
+    return b.localeCompare(a);
+  });
   return [...conforming, ...nonConforming];
 }
 async function readHandover(handoversDir, filename) {
@@ -778,6 +788,13 @@ var CliValidationError = class extends Error {
     this.name = "CliValidationError";
   }
 };
+function todayISO() {
+  const d = /* @__PURE__ */ new Date();
+  const y = d.getFullYear();
+  const m = String(d.getMonth() + 1).padStart(2, "0");
+  const day = String(d.getDate()).padStart(2, "0");
+  return `${y}-${m}-${day}`;
+}
 async function parseHandoverFilename(raw, handoversDir) {
   if (raw.includes("/") || raw.includes("\\") || raw.includes("..") || raw.includes("\0")) {
     throw new CliValidationError(
@@ -1201,6 +1218,12 @@ function formatHandoverContent(filename, content, format) {
   }
   return content;
 }
+function formatHandoverCreateResult(filename, format) {
+  if (format === "json") {
+    return JSON.stringify(successEnvelope({ filename }), null, 2);
+  }
+  return `Created handover: ${filename}`;
+}
 function formatSnapshotResult(result, format) {
   if (format === "json") {
     return JSON.stringify(successEnvelope(result), null, 2);
@@ -1740,6 +1763,8 @@ function handleValidate(ctx) {
 }
 
 // src/cli/commands/handover.ts
+import { mkdir } from "fs/promises";
+import { join as join4, resolve as resolve4 } from "path";
 function handleHandoverList(ctx) {
   return { output: formatHandoverList(ctx.state.handoverFilenames, ctx.format) };
 }
@@ -1791,6 +1816,59 @@ async function handleHandoverGet(filename, ctx) {
     };
   }
 }
+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 mkdir(handoversDir, { recursive: true });
+    const wrapDir = join4(absRoot, ".story");
+    const datePrefix = `${date}-`;
+    const seqRegex = new RegExp(`^${date}-(\\d{2})-`);
+    let maxSeq = 0;
+    const { readdirSync } = await import("fs");
+    try {
+      for (const f of readdirSync(handoversDir)) {
+        const m = f.match(seqRegex);
+        if (m) {
+          const n = parseInt(m[1], 10);
+          if (n > maxSeq) maxSeq = n;
+        }
+      }
+    } catch {
+    }
+    const nextSeq = maxSeq + 1;
+    if (nextSeq > 99) {
+      throw new CliValidationError(
+        "conflict",
+        `Too many handovers for ${date}; limit is 99 per day`
+      );
+    }
+    const candidate = `${date}-${String(nextSeq).padStart(2, "0")}-${slug}.md`;
+    const candidatePath = join4(handoversDir, candidate);
+    await parseHandoverFilename(candidate, handoversDir);
+    await guardPath(candidatePath, wrapDir);
+    await atomicWrite(candidatePath, content);
+    filename = candidate;
+  });
+  return { output: formatHandoverCreateResult(filename, format) };
+}
 
 // src/cli/commands/blocker.ts
 function handleBlockerList(ctx) {
@@ -1883,9 +1961,9 @@ function handleIssueGet(id, ctx) {
 }
 
 // src/core/snapshot.ts
-import { readdir as readdir3, readFile as readFile3, mkdir, unlink as unlink2 } from "fs/promises";
+import { readdir as readdir3, readFile as readFile3, mkdir as mkdir2, unlink as unlink2 } from "fs/promises";
 import { existsSync as existsSync4 } from "fs";
-import { join as join4, resolve as resolve4 } from "path";
+import { join as join5, resolve as resolve5 } from "path";
 import { z as z6 } from "zod";
 var LoadWarningSchema = z6.object({
   type: z6.string(),
@@ -1904,9 +1982,9 @@ var SnapshotV1Schema = z6.object({
 });
 var MAX_SNAPSHOTS = 20;
 async function saveSnapshot(root, loadResult) {
-  const absRoot = resolve4(root);
-  const snapshotsDir = join4(absRoot, ".story", "snapshots");
-  await mkdir(snapshotsDir, { recursive: true });
+  const absRoot = resolve5(root);
+  const snapshotsDir = join5(absRoot, ".story", "snapshots");
+  await mkdir2(snapshotsDir, { recursive: true });
   const { state, warnings } = loadResult;
   const now = /* @__PURE__ */ new Date();
   const filename = formatSnapshotFilename(now);
@@ -1927,8 +2005,8 @@ async function saveSnapshot(root, loadResult) {
     } : {}
   };
   const json = JSON.stringify(snapshot, null, 2) + "\n";
-  const targetPath = join4(snapshotsDir, filename);
-  const wrapDir = join4(absRoot, ".story");
+  const targetPath = join5(snapshotsDir, filename);
+  const wrapDir = join5(absRoot, ".story");
   await guardPath(targetPath, wrapDir);
   await atomicWrite(targetPath, json);
   const pruned = await pruneSnapshots(snapshotsDir);
@@ -1936,13 +2014,13 @@ async function saveSnapshot(root, loadResult) {
   return { filename, retained: entries.length, pruned };
 }
 async function loadLatestSnapshot(root) {
-  const snapshotsDir = join4(resolve4(root), ".story", "snapshots");
+  const snapshotsDir = join5(resolve5(root), ".story", "snapshots");
   if (!existsSync4(snapshotsDir)) return null;
   const files = await listSnapshotFiles(snapshotsDir);
   if (files.length === 0) return null;
   for (const filename of files) {
     try {
-      const content = await readFile3(join4(snapshotsDir, filename), "utf-8");
+      const content = await readFile3(join5(snapshotsDir, filename), "utf-8");
       const parsed = JSON.parse(content);
       const snapshot = SnapshotV1Schema.parse(parsed);
       return { snapshot, filename };
@@ -2103,7 +2181,7 @@ async function pruneSnapshots(dir) {
   const toRemove = files.slice(MAX_SNAPSHOTS);
   for (const f of toRemove) {
     try {
-      await unlink2(join4(dir, f));
+      await unlink2(join5(dir, f));
     } catch {
     }
   }
@@ -2141,7 +2219,7 @@ function handleExport(ctx, mode, phaseId) {
 }
 
 // src/cli/commands/phase.ts
-import { join as join5, resolve as resolve5 } from "path";
+import { join as join6, resolve as resolve6 } from "path";
 function handlePhaseList(ctx) {
   return { output: formatPhaseList(ctx.state, ctx.format) };
 }
@@ -2200,7 +2278,7 @@ function formatMcpError(code, message) {
 async function runMcpReadTool(pinnedRoot, handler) {
   try {
     const { state, warnings } = await loadProject(pinnedRoot);
-    const handoversDir = join6(pinnedRoot, ".story", "handovers");
+    const handoversDir = join7(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)) {
@@ -2375,12 +2453,30 @@ function registerAllTools(server, pinnedRoot) {
     const phaseId = args.phase ?? null;
     return runMcpReadTool(pinnedRoot, (ctx) => handleExport(ctx, mode, phaseId));
   });
+  server.registerTool("claudestory_handover_create", {
+    description: "Create a handover document from markdown content",
+    inputSchema: {
+      content: z7.string().describe("Markdown content of the handover"),
+      slug: z7.string().optional().describe("Slug for filename (e.g. phase5b-wrapup). Default: session")
+    }
+  }, (args) => {
+    if (!args.content?.trim()) {
+      return Promise.resolve({
+        content: [{ type: "text", text: formatMcpError("invalid_input", "Handover content is empty") }],
+        isError: true
+      });
+    }
+    return runMcpWriteTool(
+      pinnedRoot,
+      (root) => handleHandoverCreate(args.content, args.slug ?? "session", "md", root)
+    );
+  });
 }
 
 // src/mcp/index.ts
 var ENV_VAR2 = "CLAUDESTORY_PROJECT_ROOT";
 var CONFIG_PATH2 = ".story/config.json";
-var version = "0.1.4";
+var version = "0.1.5";
 function pinProjectRoot() {
   const envRoot = process.env[ENV_VAR2];
   if (envRoot) {
@@ -2389,7 +2485,7 @@ function pinProjectRoot() {
 `);
       process.exit(1);
     }
-    const resolved = resolve6(envRoot);
+    const resolved = resolve7(envRoot);
     let canonical;
     try {
       canonical = realpathSync(resolved);
@@ -2398,7 +2494,7 @@ function pinProjectRoot() {
 `);
       process.exit(1);
     }
-    if (!existsSync5(join7(canonical, CONFIG_PATH2))) {
+    if (!existsSync5(join8(canonical, CONFIG_PATH2))) {
       process.stderr.write(`Error: No .story/config.json at ${canonical}
 `);
       process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropologies/claudestory",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "type": "module",
   "exports": {
     ".": {