@anthropologies/claudestory 0.1.62 → 0.1.64

package/dist/index.d.ts

@@ -550,12 +550,13 @@ declare class ProjectState {
     readonly totalTicketCount: number;
     readonly openTicketCount: number;
     readonly completeTicketCount: number;
-    readonly openIssueCount: number;
+    readonly activeIssueCount: number;
     readonly issuesBySeverity: ReadonlyMap<IssueSeverity, number>;
     readonly activeNoteCount: number;
     readonly archivedNoteCount: number;
     readonly activeLessonCount: number;
     readonly deprecatedLessonCount: number;
+    readonly lessonTags: readonly string[];
     constructor(input: {
         tickets: Ticket[];
         issues: Issue[];
@@ -748,6 +749,12 @@ declare function readHandover(handoversDir: string, filename: string): Promise<s
  * Returns the date string or null if the filename does not conform.
  */
 declare function extractHandoverDate(filename: string): string | null;
+/**
+ * Extracts the human-readable title from a handover filename.
+ * Strips `.md` extension and YYYY-MM-DD date prefix, converts remaining
+ * hyphens to spaces, and trims whitespace. Mirrors Swift parseHandoverFilename.
+ */
+declare function extractHandoverTitle(filename: string): string;
 
 interface UmbrellaProgress {
     readonly total: number;
@@ -1385,6 +1392,7 @@ declare const SnapshotV1Schema: z.ZodObject<{
         type: string;
         file: string;
     }>, "many">>;
+    gitHead: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     issues: z.objectOutputType<{
         id: z.ZodString;
@@ -1430,6 +1438,7 @@ declare const SnapshotV1Schema: z.ZodObject<{
     } & {
         [k: string]: unknown;
     };
+    createdAt: string;
     tickets: z.objectOutputType<{
         id: z.ZodString;
         title: z.ZodString;
@@ -1492,13 +1501,13 @@ declare const SnapshotV1Schema: z.ZodObject<{
         supersedes: z.ZodNullable<z.ZodString>;
         status: z.ZodEnum<["active", "deprecated", "superseded"]>;
     }, z.ZodTypeAny, "passthrough">[];
-    createdAt: string;
     handoverFilenames: string[];
     warnings?: {
         message: string;
         type: string;
         file: string;
     }[] | undefined;
+    gitHead?: string | undefined;
 }, {
     issues: z.objectInputType<{
         id: z.ZodString;
@@ -1544,6 +1553,7 @@ declare const SnapshotV1Schema: z.ZodObject<{
     } & {
         [k: string]: unknown;
     };
+    createdAt: string;
     tickets: z.objectInputType<{
         id: z.ZodString;
         title: z.ZodString;
@@ -1583,7 +1593,6 @@ declare const SnapshotV1Schema: z.ZodObject<{
     };
     version: 1;
     project: string;
-    createdAt: string;
     notes?: z.objectInputType<{
         id: z.ZodString;
         title: z.ZodNullable<z.ZodString>;
@@ -1613,6 +1622,7 @@ declare const SnapshotV1Schema: z.ZodObject<{
         file: string;
     }[] | undefined;
     handoverFilenames?: string[] | undefined;
+    gitHead?: string | undefined;
 }>;
 type SnapshotV1 = z.infer<typeof SnapshotV1Schema>;
 /**
@@ -1739,6 +1749,12 @@ interface SnapshotDiff {
         removed: string[];
     };
 }
+interface RecapStaleness {
+    status: "behind" | "diverged";
+    snapshotSha: string;
+    currentSha: string;
+    commitsBehind?: number;
+}
 interface RecapResult {
     snapshot: {
         filename: string;
@@ -1759,6 +1775,7 @@ interface RecapResult {
         recentlyClearedBlockers: string[];
     };
     partial: boolean;
+    staleness?: RecapStaleness;
 }
 /**
  * Computes the diff between a snapshot state and the current state.
@@ -1770,7 +1787,7 @@ declare function diffStates(snapshotState: ProjectState, currentState: ProjectSt
 declare function buildRecap(currentState: ProjectState, snapshotInfo: {
     snapshot: SnapshotV1;
     filename: string;
-} | null): RecapResult;
+} | null, root: string): Promise<RecapResult>;
 
 interface ActiveSessionSummary {
     readonly sessionId: string;
@@ -1854,4 +1871,4 @@ declare function formatRecap(recap: RecapResult, state: ProjectState, format: Ou
 declare function formatExport(state: ProjectState, mode: "all" | "phase", phaseId: string | null, format: OutputFormat): string;
 declare function formatRecommendations(result: RecommendResult, state: ProjectState, format: OutputFormat): string;
 
-export { type Blocker, BlockerSchema, CURRENT_SCHEMA_VERSION, type Config, ConfigSchema, DATE_REGEX, DateSchema, EMPTY_SCAFFOLD_HEADING, 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, NOTE_ID_REGEX, NOTE_STATUSES, type NextTicketAllBlocked, type NextTicketAllComplete, type NextTicketEmpty, type NextTicketOutcome, type NextTicketResult, type Note, NoteIdSchema, NoteSchema, type NoteStatus, OUTPUT_FORMATS, type OutputFormat, type PartialEnvelope, type Phase, PhaseSchema, type PhaseStatus, type PhaseWithStatus, ProjectLoaderError, ProjectState, type RecapResult, type RecommendCategory, type RecommendItemKind, type RecommendResult, type Recommendation, 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, deleteNote, deleteTicket, descendantLeaves, diffStates, discoverProjectRoot, errorEnvelope, escapeMarkdownInline, extractHandoverDate, fencedBlock, formatBlockedTickets, formatBlockerList, formatError, formatExport, formatHandoverContent, formatHandoverCreateResult, formatHandoverList, formatInitResult, formatIssue, formatIssueList, formatNextTicketOutcome, formatPhaseList, formatPhaseTickets, formatRecap, formatRecommendations, formatSnapshotResult, formatStatus, formatTicket, formatTicketList, formatValidation, guardPath, initProject, isBlockerCleared, listHandovers, loadLatestSnapshot, loadProject, mergeValidation, nextIssueID, nextNoteID, nextOrder, nextTicket, nextTicketID, nextTickets, partialEnvelope, phasesWithStatus, readHandover, recommend, runTransaction, runTransactionUnlocked, saveSnapshot, serializeJSON, sortKeysDeep, successEnvelope, ticketsUnblockedBy, umbrellaProgress, validateProject, withProjectLock, writeConfig, writeIssue, writeIssueUnlocked, writeNote, writeNoteUnlocked, writeRoadmap, writeRoadmapUnlocked, writeTicket, writeTicketUnlocked };
+export { type Blocker, BlockerSchema, CURRENT_SCHEMA_VERSION, type Config, ConfigSchema, DATE_REGEX, DateSchema, EMPTY_SCAFFOLD_HEADING, 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, NOTE_ID_REGEX, NOTE_STATUSES, type NextTicketAllBlocked, type NextTicketAllComplete, type NextTicketEmpty, type NextTicketOutcome, type NextTicketResult, type Note, NoteIdSchema, NoteSchema, type NoteStatus, OUTPUT_FORMATS, type OutputFormat, type PartialEnvelope, type Phase, PhaseSchema, type PhaseStatus, type PhaseWithStatus, ProjectLoaderError, ProjectState, type RecapResult, type RecapStaleness, type RecommendCategory, type RecommendItemKind, type RecommendResult, type Recommendation, 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, deleteNote, deleteTicket, descendantLeaves, diffStates, discoverProjectRoot, errorEnvelope, escapeMarkdownInline, extractHandoverDate, extractHandoverTitle, fencedBlock, formatBlockedTickets, formatBlockerList, formatError, formatExport, formatHandoverContent, formatHandoverCreateResult, formatHandoverList, formatInitResult, formatIssue, formatIssueList, formatNextTicketOutcome, formatPhaseList, formatPhaseTickets, formatRecap, formatRecommendations, formatSnapshotResult, formatStatus, formatTicket, formatTicketList, formatValidation, guardPath, initProject, isBlockerCleared, listHandovers, loadLatestSnapshot, loadProject, mergeValidation, nextIssueID, nextNoteID, nextOrder, nextTicket, nextTicketID, nextTickets, partialEnvelope, phasesWithStatus, readHandover, recommend, runTransaction, runTransactionUnlocked, saveSnapshot, serializeJSON, sortKeysDeep, successEnvelope, ticketsUnblockedBy, umbrellaProgress, validateProject, withProjectLock, writeConfig, writeIssue, writeIssueUnlocked, writeNote, writeNoteUnlocked, writeRoadmap, writeRoadmapUnlocked, writeTicket, writeTicketUnlocked };

package/dist/index.js

@@ -173,12 +173,13 @@ var ProjectState = class _ProjectState {
   totalTicketCount;
   openTicketCount;
   completeTicketCount;
-  openIssueCount;
+  activeIssueCount;
   issuesBySeverity;
   activeNoteCount;
   archivedNoteCount;
   activeLessonCount;
   deprecatedLessonCount;
+  lessonTags;
   constructor(input) {
     this.tickets = input.tickets;
     this.issues = input.issues;
@@ -259,19 +260,19 @@ var ProjectState = class _ProjectState {
       lByID.set(l.id, l);
     }
     this.lessonsByID = lByID;
-    this.totalTicketCount = input.tickets.length;
-    this.openTicketCount = input.tickets.filter(
+    this.totalTicketCount = this.leafTickets.length;
+    this.openTicketCount = this.leafTickets.filter(
       (t) => t.status !== "complete"
     ).length;
-    this.completeTicketCount = input.tickets.filter(
+    this.completeTicketCount = this.leafTickets.filter(
       (t) => t.status === "complete"
     ).length;
-    this.openIssueCount = input.issues.filter(
-      (i) => i.status === "open"
+    this.activeIssueCount = input.issues.filter(
+      (i) => i.status !== "resolved"
     ).length;
     const bySev = /* @__PURE__ */ new Map();
     for (const i of input.issues) {
-      if (i.status === "open") {
+      if (i.status !== "resolved") {
         bySev.set(i.severity, (bySev.get(i.severity) ?? 0) + 1);
       }
     }
@@ -288,6 +289,7 @@ var ProjectState = class _ProjectState {
     this.deprecatedLessonCount = this.lessons.filter(
       (l) => l.status === "deprecated" || l.status === "superseded"
     ).length;
+    this.lessonTags = [...new Set(this.lessons.flatMap((l) => l.tags ?? []))].sort();
   }
   // --- Query Methods ---
   isUmbrella(ticket) {
@@ -502,6 +504,20 @@ function extractHandoverDate(filename) {
   const match = filename.match(HANDOVER_DATE_REGEX);
   return match ? match[0] : null;
 }
+function extractHandoverTitle(filename) {
+  let name = filename;
+  if (name.endsWith(".md")) {
+    name = name.slice(0, -3);
+  }
+  if (HANDOVER_DATE_REGEX.test(name)) {
+    let title = name.slice(10);
+    if (title.startsWith("-")) {
+      title = title.slice(1);
+    }
+    return title.replace(/-/g, " ").trim();
+  }
+  return name;
+}
 
 // src/core/project-loader.ts
 async function loadProject(root, options) {
@@ -2095,6 +2111,75 @@ import { readdir as readdir3, readFile as readFile4, mkdir as mkdir3, unlink as
 import { existsSync as existsSync4 } from "fs";
 import { join as join5, resolve as resolve4 } from "path";
 import { z as z8 } from "zod";
+
+// src/autonomous/git-inspector.ts
+import { execFile } from "child_process";
+var GIT_TIMEOUT = 1e4;
+async function git(cwd, args, parse) {
+  return new Promise((resolve5) => {
+    execFile("git", args, { cwd, timeout: GIT_TIMEOUT, maxBuffer: 10 * 1024 * 1024 }, (err, stdout, stderr) => {
+      if (err) {
+        const message = stderr?.trim() || err.message || "unknown git error";
+        resolve5({ ok: false, reason: "git_error", message });
+        return;
+      }
+      try {
+        resolve5({ ok: true, data: parse(stdout) });
+      } catch (parseErr) {
+        resolve5({ ok: false, reason: "parse_error", message: parseErr.message });
+      }
+    });
+  });
+}
+var SAFE_REF = /^[0-9a-f]{4,40}$/i;
+async function gitIsAncestor(cwd, ancestor, descendant) {
+  if (!SAFE_REF.test(ancestor) || !SAFE_REF.test(descendant)) {
+    return { ok: false, reason: "git_error", message: "invalid ref format" };
+  }
+  return new Promise((resolve5) => {
+    execFile(
+      "git",
+      ["merge-base", "--is-ancestor", ancestor, descendant],
+      { cwd, timeout: GIT_TIMEOUT },
+      (err) => {
+        if (!err) {
+          resolve5({ ok: true, data: true });
+          return;
+        }
+        const code = err.code;
+        if (code === 1) {
+          resolve5({ ok: true, data: false });
+          return;
+        }
+        resolve5({ ok: false, reason: "git_error", message: err.message });
+      }
+    );
+  });
+}
+async function gitHeadHash(cwd) {
+  return new Promise((resolve5) => {
+    execFile("git", ["rev-parse", "HEAD"], { cwd, timeout: 3e3 }, (err, stdout) => {
+      if (err) {
+        const message = err.stderr?.trim() || err.message || "unknown git error";
+        resolve5({ ok: false, reason: "git_error", message });
+        return;
+      }
+      resolve5({ ok: true, data: stdout.trim() });
+    });
+  });
+}
+async function gitCommitDistance(cwd, fromSha, toSha) {
+  if (!SAFE_REF.test(fromSha) || !SAFE_REF.test(toSha)) {
+    return { ok: false, reason: "git_error", message: "invalid ref format" };
+  }
+  return git(cwd, ["rev-list", "--count", `${fromSha}..${toSha}`], (out) => {
+    const n = parseInt(out.trim(), 10);
+    if (Number.isNaN(n)) throw new Error(`unexpected rev-list output: ${out}`);
+    return n;
+  });
+}
+
+// src/core/snapshot.ts
 var LoadWarningSchema = z8.object({
   type: z8.string(),
   file: z8.string(),
@@ -2111,7 +2196,8 @@ var SnapshotV1Schema = z8.object({
   notes: z8.array(NoteSchema).optional().default([]),
   lessons: z8.array(LessonSchema).optional().default([]),
   handoverFilenames: z8.array(z8.string()).optional().default([]),
-  warnings: z8.array(LoadWarningSchema).optional()
+  warnings: z8.array(LoadWarningSchema).optional(),
+  gitHead: z8.string().optional()
 });
 var MAX_SNAPSHOTS = 20;
 async function saveSnapshot(root, loadResult) {
@@ -2140,6 +2226,10 @@ async function saveSnapshot(root, loadResult) {
       }))
     } : {}
   };
+  const headResult = await gitHeadHash(absRoot);
+  if (headResult.ok) {
+    snapshot.gitHead = headResult.data;
+  }
   const json = JSON.stringify(snapshot, null, 2) + "\n";
   const targetPath = join5(snapshotsDir, filename);
   const wrapDir = join5(absRoot, ".story");
@@ -2335,7 +2425,7 @@ function diffStates(snapshotState, currentState) {
     handovers: { added: handoversAdded, removed: handoversRemoved }
   };
 }
-function buildRecap(currentState, snapshotInfo) {
+async function buildRecap(currentState, snapshotInfo, root) {
   const next = nextTicket(currentState);
   const nextTicketAction = next.kind === "found" ? { id: next.ticket.id, title: next.ticket.title, phase: next.ticket.phase } : null;
   const highSeverityIssues = currentState.issues.filter(
@@ -2365,6 +2455,30 @@ function buildRecap(currentState, snapshotInfo) {
   });
   const changes = diffStates(snapshotState, currentState);
   const recentlyClearedBlockers = changes.blockers.cleared;
+  let staleness;
+  if (snapshot.gitHead) {
+    const currentHeadResult = await gitHeadHash(root);
+    if (currentHeadResult.ok) {
+      const snapshotSha = snapshot.gitHead;
+      const currentSha = currentHeadResult.data;
+      if (snapshotSha !== currentSha) {
+        const ancestorResult = await gitIsAncestor(root, snapshotSha, currentSha);
+        if (ancestorResult.ok && ancestorResult.data) {
+          const distResult = await gitCommitDistance(root, snapshotSha, currentSha);
+          if (distResult.ok) {
+            staleness = {
+              status: "behind",
+              snapshotSha,
+              currentSha,
+              commitsBehind: distResult.data
+            };
+          }
+        } else if (ancestorResult.ok && !ancestorResult.data) {
+          staleness = { status: "diverged", snapshotSha, currentSha };
+        }
+      }
+    }
+  }
   return {
     snapshot: { filename, createdAt: snapshot.createdAt },
     changes,
@@ -2373,7 +2487,8 @@ function buildRecap(currentState, snapshotInfo) {
       highSeverityIssues,
       recentlyClearedBlockers
     },
-    partial: (snapshot.warnings ?? []).length > 0
+    partial: (snapshot.warnings ?? []).length > 0,
+    ...staleness ? { staleness } : {}
   };
 }
 function formatSnapshotFilename(date) {
@@ -2457,7 +2572,7 @@ function formatStatus(state, format, activeSessions = []) {
     completeTickets: state.completeLeafTicketCount,
     openTickets: state.leafTicketCount - state.completeLeafTicketCount,
     blockedTickets: state.blockedCount,
-    openIssues: state.openIssueCount,
+    openIssues: state.activeIssueCount,
     activeNotes: state.activeNoteCount,
     archivedNotes: state.archivedNoteCount,
     activeLessons: state.activeLessonCount,
@@ -2479,7 +2594,7 @@ function formatStatus(state, format, activeSessions = []) {
     `# ${escapeMarkdownInline(state.config.project)}`,
     "",
     `Tickets: ${state.completeLeafTicketCount}/${state.leafTicketCount} complete, ${state.blockedCount} blocked`,
-    `Issues: ${state.openIssueCount} open`,
+    `Issues: ${state.activeIssueCount} open`,
     `Notes: ${state.activeNoteCount} active, ${state.archivedNoteCount} archived`,
     `Lessons: ${state.activeLessonCount} active, ${state.deprecatedLessonCount} deprecated`,
     `Handovers: ${state.handoverFilenames.length}`,
@@ -2764,7 +2879,7 @@ function formatRecap(recap, state, format) {
     lines.push("No snapshot found. Run `claudestory snapshot` to enable session diffs.");
     lines.push("");
     lines.push(`Tickets: ${state.completeLeafTicketCount}/${state.leafTicketCount} complete, ${state.blockedCount} blocked`);
-    lines.push(`Issues: ${state.openIssueCount} open`);
+    lines.push(`Issues: ${state.activeIssueCount} open`);
   } else {
     lines.push(`# ${escapeMarkdownInline(state.config.project)} \u2014 Recap`);
     lines.push("");
@@ -2772,6 +2887,13 @@ function formatRecap(recap, state, format) {
     if (recap.partial) {
       lines.push("**Note:** Snapshot was taken from a project with integrity warnings. Diff may be incomplete.");
     }
+    if (recap.staleness) {
+      if (recap.staleness.status === "diverged") {
+        lines.push("**Warning:** Snapshot commit is not an ancestor of current HEAD (history diverged; possible rebase, force-push, or branch switch).");
+      } else if (recap.staleness.status === "behind" && recap.staleness.commitsBehind) {
+        lines.push(`**Warning:** Snapshot is ${recap.staleness.commitsBehind} commit(s) behind HEAD -- context may be stale.`);
+      }
+    }
     const changes = recap.changes;
     const hasChanges = hasAnyChanges(changes);
     if (!hasChanges) {
@@ -3033,7 +3155,7 @@ function formatFullExport(state, format) {
   lines.push(`# ${escapeMarkdownInline(state.config.project)} \u2014 Full Export`);
   lines.push("");
   lines.push(`Tickets: ${state.completeLeafTicketCount}/${state.leafTicketCount} complete`);
-  lines.push(`Issues: ${state.openIssueCount} open`);
+  lines.push(`Issues: ${state.activeIssueCount} open`);
   lines.push(`Notes: ${state.activeNoteCount} active, ${state.archivedNoteCount} archived`);
   lines.push(`Lessons: ${state.activeLessonCount} active, ${state.deprecatedLessonCount} deprecated`);
   lines.push("");
@@ -3175,6 +3297,7 @@ export {
   errorEnvelope,
   escapeMarkdownInline,
   extractHandoverDate,
+  extractHandoverTitle,
   fencedBlock,
   formatBlockedTickets,
   formatBlockerList,