@anthropologies/claudestory 0.1.10 → 0.1.12

package/dist/index.d.ts

@@ -104,25 +104,25 @@ type Issue = z.infer<typeof IssueSchema>;
 
 declare const NoteSchema: z.ZodObject<{
     id: z.ZodString;
-    title: z.ZodEffects<z.ZodNullable<z.ZodString>, string | null, unknown>;
+    title: z.ZodNullable<z.ZodString>;
     content: z.ZodEffects<z.ZodString, string, string>;
-    tags: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>;
+    tags: z.ZodArray<z.ZodString, "many">;
     status: z.ZodEnum<["active", "archived"]>;
     createdDate: z.ZodEffects<z.ZodString, string, string>;
     updatedDate: z.ZodEffects<z.ZodString, string, string>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     id: z.ZodString;
-    title: z.ZodEffects<z.ZodNullable<z.ZodString>, string | null, unknown>;
+    title: z.ZodNullable<z.ZodString>;
     content: z.ZodEffects<z.ZodString, string, string>;
-    tags: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>;
+    tags: z.ZodArray<z.ZodString, "many">;
     status: z.ZodEnum<["active", "archived"]>;
     createdDate: z.ZodEffects<z.ZodString, string, string>;
     updatedDate: z.ZodEffects<z.ZodString, string, string>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     id: z.ZodString;
-    title: z.ZodEffects<z.ZodNullable<z.ZodString>, string | null, unknown>;
+    title: z.ZodNullable<z.ZodString>;
     content: z.ZodEffects<z.ZodString, string, string>;
-    tags: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>;
+    tags: z.ZodArray<z.ZodString, "many">;
     status: z.ZodEnum<["active", "archived"]>;
     createdDate: z.ZodEffects<z.ZodString, string, string>;
     updatedDate: z.ZodEffects<z.ZodString, string, string>;
@@ -340,6 +340,7 @@ declare const ConfigSchema: z.ZodObject<{
         roadmap: z.ZodBoolean;
         reviews: z.ZodBoolean;
     }, z.ZodTypeAny, "passthrough">>;
+    recipe: z.ZodOptional<z.ZodString>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     version: z.ZodNumber;
     schemaVersion: z.ZodOptional<z.ZodNumber>;
@@ -365,6 +366,7 @@ declare const ConfigSchema: z.ZodObject<{
         roadmap: z.ZodBoolean;
         reviews: z.ZodBoolean;
     }, z.ZodTypeAny, "passthrough">>;
+    recipe: z.ZodOptional<z.ZodString>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     version: z.ZodNumber;
     schemaVersion: z.ZodOptional<z.ZodNumber>;
@@ -390,6 +392,7 @@ declare const ConfigSchema: z.ZodObject<{
         roadmap: z.ZodBoolean;
         reviews: z.ZodBoolean;
     }, z.ZodTypeAny, "passthrough">>;
+    recipe: z.ZodOptional<z.ZodString>;
 }, z.ZodTypeAny, "passthrough">>;
 type Config = z.infer<typeof ConfigSchema>;
 
@@ -806,6 +809,7 @@ interface InitOptions {
     force?: boolean;
     type?: string;
     language?: string;
+    phases?: Phase[];
 }
 interface InitResult {
     readonly root: string;
@@ -848,6 +852,7 @@ declare const SnapshotV1Schema: z.ZodObject<{
             roadmap: z.ZodBoolean;
             reviews: z.ZodBoolean;
         }, z.ZodTypeAny, "passthrough">>;
+        recipe: z.ZodOptional<z.ZodString>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         version: z.ZodNumber;
         schemaVersion: z.ZodOptional<z.ZodNumber>;
@@ -873,6 +878,7 @@ declare const SnapshotV1Schema: z.ZodObject<{
             roadmap: z.ZodBoolean;
             reviews: z.ZodBoolean;
         }, z.ZodTypeAny, "passthrough">>;
+        recipe: z.ZodOptional<z.ZodString>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
         version: z.ZodNumber;
         schemaVersion: z.ZodOptional<z.ZodNumber>;
@@ -898,6 +904,7 @@ declare const SnapshotV1Schema: z.ZodObject<{
             roadmap: z.ZodBoolean;
             reviews: z.ZodBoolean;
         }, z.ZodTypeAny, "passthrough">>;
+        recipe: z.ZodOptional<z.ZodString>;
     }, z.ZodTypeAny, "passthrough">>;
     roadmap: z.ZodObject<{
         title: z.ZodString;
@@ -1123,43 +1130,64 @@ declare const SnapshotV1Schema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">>, "many">;
     notes: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
-        title: z.ZodEffects<z.ZodNullable<z.ZodString>, string | null, unknown>;
+        title: z.ZodNullable<z.ZodString>;
         content: z.ZodEffects<z.ZodString, string, string>;
-        tags: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>;
+        tags: z.ZodArray<z.ZodString, "many">;
         status: z.ZodEnum<["active", "archived"]>;
         createdDate: z.ZodEffects<z.ZodString, string, string>;
         updatedDate: z.ZodEffects<z.ZodString, string, string>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         id: z.ZodString;
-        title: z.ZodEffects<z.ZodNullable<z.ZodString>, string | null, unknown>;
+        title: z.ZodNullable<z.ZodString>;
         content: z.ZodEffects<z.ZodString, string, string>;
-        tags: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>;
+        tags: z.ZodArray<z.ZodString, "many">;
         status: z.ZodEnum<["active", "archived"]>;
         createdDate: z.ZodEffects<z.ZodString, string, string>;
         updatedDate: z.ZodEffects<z.ZodString, string, string>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
         id: z.ZodString;
-        title: z.ZodEffects<z.ZodNullable<z.ZodString>, string | null, unknown>;
+        title: z.ZodNullable<z.ZodString>;
         content: z.ZodEffects<z.ZodString, string, string>;
-        tags: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>;
+        tags: z.ZodArray<z.ZodString, "many">;
         status: z.ZodEnum<["active", "archived"]>;
         createdDate: z.ZodEffects<z.ZodString, string, string>;
         updatedDate: z.ZodEffects<z.ZodString, string, string>;
     }, z.ZodTypeAny, "passthrough">>, "many">>>;
+    handoverFilenames: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
     warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
         type: z.ZodString;
         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;
+    } & {
+        [k: string]: unknown;
+    };
     issues: z.objectOutputType<{
         id: z.ZodString;
         title: z.ZodString;
@@ -1195,8 +1223,8 @@ declare const SnapshotV1Schema: z.ZodObject<{
         lastModifiedBy: 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;
@@ -1214,23 +1242,30 @@ declare const SnapshotV1Schema: z.ZodObject<{
     } & {
         [k: string]: unknown;
     };
-    version: 1;
     project: string;
     notes: z.objectOutputType<{
         id: z.ZodString;
-        title: z.ZodEffects<z.ZodNullable<z.ZodString>, string | null, unknown>;
+        title: z.ZodNullable<z.ZodString>;
         content: z.ZodEffects<z.ZodString, string, string>;
-        tags: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>;
+        tags: z.ZodArray<z.ZodString, "many">;
         status: z.ZodEnum<["active", "archived"]>;
         createdDate: z.ZodEffects<z.ZodString, string, string>;
         updatedDate: z.ZodEffects<z.ZodString, string, string>;
     }, 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;
@@ -1241,15 +1276,10 @@ declare const SnapshotV1Schema: z.ZodObject<{
             [k: string]: unknown;
         };
         schemaVersion?: number | undefined;
+        recipe?: string | undefined;
     } & {
         [k: string]: unknown;
     };
-    warnings?: {
-        message: string;
-        type: string;
-        file: string;
-    }[] | undefined;
-}, {
     issues: z.objectInputType<{
         id: z.ZodString;
         title: z.ZodString;
@@ -1285,8 +1315,8 @@ declare const SnapshotV1Schema: z.ZodObject<{
         lastModifiedBy: 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;
@@ -1304,41 +1334,23 @@ 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;
-    } & {
-        [k: string]: unknown;
-    };
     notes?: z.objectInputType<{
         id: z.ZodString;
-        title: z.ZodEffects<z.ZodNullable<z.ZodString>, string | null, unknown>;
+        title: z.ZodNullable<z.ZodString>;
         content: z.ZodEffects<z.ZodString, string, string>;
-        tags: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>;
+        tags: z.ZodArray<z.ZodString, "many">;
         status: z.ZodEnum<["active", "archived"]>;
         createdDate: z.ZodEffects<z.ZodString, string, string>;
         updatedDate: z.ZodEffects<z.ZodString, string, string>;
     }, z.ZodTypeAny, "passthrough">[] | undefined;
     warnings?: {
-        message: string;
         type: string;
+        message: string;
         file: string;
     }[] | undefined;
+    handoverFilenames?: string[] | undefined;
 }>;
 type SnapshotV1 = z.infer<typeof SnapshotV1Schema>;
 /**
@@ -1438,6 +1450,10 @@ interface SnapshotDiff {
         }>;
         updated: NoteChange[];
     };
+    handovers: {
+        added: string[];
+        removed: string[];
+    };
 }
 interface RecapResult {
     snapshot: {

package/dist/index.js

@@ -79,15 +79,9 @@ var IssueSchema = z3.object({
 import { z as z4 } from "zod";
 var NoteSchema = z4.object({
   id: NoteIdSchema,
-  title: z4.preprocess((v) => v ?? null, z4.string().nullable()),
+  title: z4.string().nullable(),
   content: z4.string().refine((v) => v.trim().length > 0, "Content cannot be empty"),
-  tags: z4.preprocess(
-    (v) => {
-      const raw = Array.isArray(v) ? v : [];
-      return raw.filter((t) => typeof t === "string").map((t) => t.trim().toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "").replace(/-+/g, "-").replace(/^-|-$/g, "")).filter((t) => t.length > 0).filter((t, i, a) => a.indexOf(t) === i);
-    },
-    z4.array(z4.string())
-  ),
+  tags: z4.array(z4.string()),
   status: z4.enum(NOTE_STATUSES),
   createdDate: DateSchema,
   updatedDate: DateSchema
@@ -134,7 +128,8 @@ var ConfigSchema = z6.object({
   project: z6.string().min(1),
   type: z6.string(),
   language: z6.string(),
-  features: FeaturesSchema
+  features: FeaturesSchema,
+  recipe: z6.string().optional()
 }).passthrough();
 
 // src/core/project-state.ts
@@ -1782,7 +1777,7 @@ function nextOrder(phaseId, state) {
 }
 
 // src/core/init.ts
-import { mkdir as mkdir2, stat as stat2 } from "fs/promises";
+import { mkdir as mkdir2, stat as stat2, readFile as readFile3, writeFile as writeFile2 } from "fs/promises";
 import { join as join4, resolve as resolve3 } from "path";
 async function initProject(root, options) {
   const absRoot = resolve3(root);
@@ -1836,7 +1831,7 @@ async function initProject(root, options) {
   const roadmap = {
     title: options.name,
     date: today,
-    phases: [
+    phases: options.phases ?? [
       {
         id: "p0",
         label: "PHASE 0",
@@ -1848,6 +1843,8 @@ async function initProject(root, options) {
   };
   await writeConfig(config, absRoot);
   await writeRoadmap(roadmap, absRoot);
+  const gitignorePath = join4(wrapDir, ".gitignore");
+  await ensureGitignoreEntries(gitignorePath, STORY_GITIGNORE_ENTRIES);
   const warnings = [];
   if (options.force && exists) {
     try {
@@ -1866,9 +1863,24 @@ async function initProject(root, options) {
     warnings
   };
 }
+var STORY_GITIGNORE_ENTRIES = ["snapshots/", "status.json", "sessions/"];
+async function ensureGitignoreEntries(gitignorePath, entries) {
+  let existing = "";
+  try {
+    existing = await readFile3(gitignorePath, "utf-8");
+  } catch {
+  }
+  const lines = existing.split("\n").map((l) => l.trim());
+  const missing = entries.filter((e) => !lines.includes(e));
+  if (missing.length === 0) return;
+  let content = existing;
+  if (content.length > 0 && !content.endsWith("\n")) content += "\n";
+  content += missing.join("\n") + "\n";
+  await writeFile2(gitignorePath, content, "utf-8");
+}
 
 // src/core/snapshot.ts
-import { readdir as readdir3, readFile as readFile3, mkdir as mkdir3, unlink as unlink2 } from "fs/promises";
+import { readdir as readdir3, readFile as readFile4, mkdir as mkdir3, unlink as unlink2 } from "fs/promises";
 import { existsSync as existsSync4 } from "fs";
 import { join as join5, resolve as resolve4 } from "path";
 import { z as z7 } from "zod";
@@ -1886,6 +1898,7 @@ var SnapshotV1Schema = z7.object({
   tickets: z7.array(TicketSchema),
   issues: z7.array(IssueSchema),
   notes: z7.array(NoteSchema).optional().default([]),
+  handoverFilenames: z7.array(z7.string()).optional().default([]),
   warnings: z7.array(LoadWarningSchema).optional()
 });
 var MAX_SNAPSHOTS = 20;
@@ -1905,6 +1918,7 @@ async function saveSnapshot(root, loadResult) {
     tickets: [...state.tickets],
     issues: [...state.issues],
     notes: [...state.notes],
+    handoverFilenames: [...state.handoverFilenames],
     ...warnings.length > 0 ? {
       warnings: warnings.map((w) => ({
         type: w.type,
@@ -1929,7 +1943,7 @@ async function loadLatestSnapshot(root) {
   if (files.length === 0) return null;
   for (const filename of files) {
     try {
-      const content = await readFile3(join5(snapshotsDir, filename), "utf-8");
+      const content = await readFile4(join5(snapshotsDir, filename), "utf-8");
       const parsed = JSON.parse(content);
       const snapshot = SnapshotV1Schema.parse(parsed);
       return { snapshot, filename };
@@ -2057,12 +2071,23 @@ function diffStates(snapshotState, currentState) {
       notesRemoved.push({ id, title: snap.title });
     }
   }
+  const snapHandovers = new Set(snapshotState.handoverFilenames);
+  const curHandovers = new Set(currentState.handoverFilenames);
+  const handoversAdded = [];
+  const handoversRemoved = [];
+  for (const h of curHandovers) {
+    if (!snapHandovers.has(h)) handoversAdded.push(h);
+  }
+  for (const h of snapHandovers) {
+    if (!curHandovers.has(h)) handoversRemoved.push(h);
+  }
   return {
     tickets: { added: ticketsAdded, removed: ticketsRemoved, statusChanged: ticketsStatusChanged, descriptionChanged: ticketsDescriptionChanged },
     issues: { added: issuesAdded, resolved: issuesResolved, statusChanged: issuesStatusChanged, impactChanged: issuesImpactChanged },
     blockers: { added: blockersAdded, cleared: blockersCleared },
     phases: { added: phasesAdded, removed: phasesRemoved, statusChanged: phasesStatusChanged },
-    notes: { added: notesAdded, removed: notesRemoved, updated: notesUpdated }
+    notes: { added: notesAdded, removed: notesRemoved, updated: notesUpdated },
+    handovers: { added: handoversAdded, removed: handoversRemoved }
   };
 }
 function buildRecap(currentState, snapshotInfo) {
@@ -2090,7 +2115,7 @@ function buildRecap(currentState, snapshotInfo) {
     notes: snapshot.notes ?? [],
     roadmap: snapshot.roadmap,
     config: snapshot.config,
-    handoverFilenames: []
+    handoverFilenames: snapshot.handoverFilenames ?? []
   });
   const changes = diffStates(snapshotState, currentState);
   const recentlyClearedBlockers = changes.blockers.cleared;
@@ -2536,6 +2561,16 @@ function formatRecap(recap, state, format) {
           lines.push(`- ${escapeMarkdownInline(name)} \u2014 **new**`);
         }
       }
+      if (changes.handovers && (changes.handovers.added.length > 0 || changes.handovers.removed.length > 0)) {
+        lines.push("");
+        lines.push("## Handovers");
+        for (const h of changes.handovers.added) {
+          lines.push(`- ${h} \u2014 **new**`);
+        }
+        for (const h of changes.handovers.removed) {
+          lines.push(`- ${h} \u2014 removed`);
+        }
+      }
       if (changes.notes && (changes.notes.added.length > 0 || changes.notes.removed.length > 0 || changes.notes.updated.length > 0)) {
         lines.push("");
         lines.push("## Notes");
@@ -2757,7 +2792,7 @@ function formatFullExport(state, format) {
   return lines.join("\n");
 }
 function hasAnyChanges(diff) {
-  return diff.tickets.added.length > 0 || diff.tickets.removed.length > 0 || diff.tickets.statusChanged.length > 0 || diff.tickets.descriptionChanged.length > 0 || diff.issues.added.length > 0 || diff.issues.resolved.length > 0 || diff.issues.statusChanged.length > 0 || diff.issues.impactChanged.length > 0 || diff.blockers.added.length > 0 || diff.blockers.cleared.length > 0 || diff.phases.added.length > 0 || diff.phases.removed.length > 0 || diff.phases.statusChanged.length > 0 || (diff.notes?.added.length ?? 0) > 0 || (diff.notes?.removed.length ?? 0) > 0 || (diff.notes?.updated.length ?? 0) > 0;
+  return diff.tickets.added.length > 0 || diff.tickets.removed.length > 0 || diff.tickets.statusChanged.length > 0 || diff.tickets.descriptionChanged.length > 0 || diff.issues.added.length > 0 || diff.issues.resolved.length > 0 || diff.issues.statusChanged.length > 0 || diff.issues.impactChanged.length > 0 || diff.blockers.added.length > 0 || diff.blockers.cleared.length > 0 || diff.phases.added.length > 0 || diff.phases.removed.length > 0 || diff.phases.statusChanged.length > 0 || (diff.notes?.added.length ?? 0) > 0 || (diff.notes?.removed.length ?? 0) > 0 || (diff.notes?.updated.length ?? 0) > 0 || (diff.handovers?.added.length ?? 0) > 0 || (diff.handovers?.removed.length ?? 0) > 0;
 }
 function truncate(text, maxLen) {
   if (text.length <= maxLen) return text;