@anthropologies/claudestory 0.1.26 → 0.1.28

package/dist/cli.js

@@ -5002,6 +5002,7 @@ var init_session_types = __esm({
       "VERIFY",
       "FINALIZE",
       "COMPACT",
+      "LESSON_CAPTURE",
       "ISSUE_SWEEP"
     ]);
     IDLE_STATES = /* @__PURE__ */ new Set([
@@ -5028,6 +5029,7 @@ var init_session_types = __esm({
       "COMPACT",
       "HANDOVER",
       "COMPLETE",
+      "LESSON_CAPTURE",
       "ISSUE_SWEEP",
       "SESSION_END"
     ];
@@ -5594,6 +5596,8 @@ var init_state_machine = __esm({
       // pass → FINALIZE, fail → IMPLEMENT, retry
       FINALIZE: ["COMPLETE"],
       COMPLETE: ["PICK_TICKET", "HANDOVER", "ISSUE_SWEEP", "SESSION_END"],
+      LESSON_CAPTURE: ["ISSUE_SWEEP", "HANDOVER", "LESSON_CAPTURE"],
+      // advance → ISSUE_SWEEP, retry self, done → HANDOVER
       ISSUE_SWEEP: ["ISSUE_SWEEP", "HANDOVER", "PICK_TICKET"],
       // retry (next issue), done → HANDOVER, loop → PICK_TICKET
       HANDOVER: ["COMPACT", "SESSION_END", "PICK_TICKET"],
@@ -5967,6 +5971,18 @@ function findFirstPostComplete(postComplete, ctx) {
   }
   return { kind: "exhausted" };
 }
+function findNextPostComplete(postComplete, currentId, ctx) {
+  const currentIndex = postComplete.indexOf(currentId);
+  const startIndex = currentIndex >= 0 ? currentIndex + 1 : 0;
+  for (let i = startIndex; i < postComplete.length; i++) {
+    const id = postComplete[i];
+    const stage = stages.get(id);
+    if (!stage) return { kind: "unregistered", id };
+    if (stage.skip?.(ctx)) continue;
+    return { kind: "found", stage };
+  }
+  return { kind: "exhausted" };
+}
 var stages;
 var init_registry = __esm({
   "src/autonomous/stages/registry.ts"() {
@@ -7403,6 +7419,74 @@ var init_complete = __esm({
   }
 });
 
+// src/autonomous/stages/lesson-capture.ts
+var LessonCaptureStage;
+var init_lesson_capture = __esm({
+  "src/autonomous/stages/lesson-capture.ts"() {
+    "use strict";
+    init_esm_shims();
+    LessonCaptureStage = class {
+      id = "LESSON_CAPTURE";
+      skip(ctx) {
+        const config = ctx.recipe.stages?.LESSON_CAPTURE;
+        return !config?.enabled;
+      }
+      async enter(ctx) {
+        const planReviews = ctx.state.reviews.plan ?? [];
+        const codeReviews = ctx.state.reviews.code ?? [];
+        const ticketsDone = ctx.state.completedTickets.length;
+        const planFindings = planReviews.reduce((sum, r) => sum + (r.findingCount ?? 0), 0);
+        const planCritical = planReviews.reduce((sum, r) => sum + (r.criticalCount ?? 0), 0);
+        const planMajor = planReviews.reduce((sum, r) => sum + (r.majorCount ?? 0), 0);
+        const codeFindings = codeReviews.reduce((sum, r) => sum + (r.findingCount ?? 0), 0);
+        const codeCritical = codeReviews.reduce((sum, r) => sum + (r.criticalCount ?? 0), 0);
+        const codeMajor = codeReviews.reduce((sum, r) => sum + (r.majorCount ?? 0), 0);
+        const totalFindings = planFindings + codeFindings;
+        if (totalFindings === 0) {
+          ctx.appendEvent("lesson_capture", { result: "no_findings", ticketsDone });
+          return { action: "advance" };
+        }
+        ctx.appendEvent("lesson_capture", {
+          result: "started",
+          ticketsDone,
+          planFindings,
+          codeFindings
+        });
+        return {
+          instruction: [
+            "# Capture Lessons from Review Findings",
+            "",
+            `This session completed ${ticketsDone} ticket(s). Review summary:`,
+            `- **Plan reviews:** ${planReviews.length} round(s), ${planCritical} critical, ${planMajor} major, ${planFindings} total findings`,
+            `- **Code reviews:** ${codeReviews.length} round(s), ${codeCritical} critical, ${codeMajor} major, ${codeFindings} total findings`,
+            "",
+            "Review these findings for recurring patterns worth capturing as lessons:",
+            "",
+            "1. Call `claudestory_lesson_list` to see existing lessons",
+            "2. For each pattern that recurred or was critical/major:",
+            "   - If it matches an existing lesson \u2192 call `claudestory_lesson_reinforce`",
+            '   - If it\'s a new pattern \u2192 call `claudestory_lesson_create` with `source: "review"`',
+            "3. Skip patterns that are one-off or already well-covered",
+            `4. Call \`claudestory_autonomous_guide\` with completedAction: "lessons_captured"`,
+            "",
+            "```json",
+            `{ "sessionId": "${ctx.state.sessionId}", "action": "report", "report": { "completedAction": "lessons_captured" } }`,
+            "```"
+          ].join("\n"),
+          reminders: [
+            "Check existing lessons first \u2014 reinforce before creating duplicates.",
+            "Only capture patterns worth remembering across sessions."
+          ]
+        };
+      }
+      async report(ctx, _report) {
+        ctx.appendEvent("lesson_capture", { result: "completed" });
+        return { action: "advance" };
+      }
+    };
+  }
+});
+
 // src/autonomous/stages/issue-sweep.ts
 var IssueSweepStage;
 var init_issue_sweep = __esm({
@@ -7611,6 +7695,7 @@ var init_stages = __esm({
     init_verify();
     init_finalize();
     init_complete();
+    init_lesson_capture();
     init_issue_sweep();
     init_handover2();
     registerStage(new PickTicketStage());
@@ -7623,6 +7708,7 @@ var init_stages = __esm({
     registerStage(new VerifyStage());
     registerStage(new FinalizeStage());
     registerStage(new CompleteStage());
+    registerStage(new LessonCaptureStage());
     registerStage(new IssueSweepStage());
     registerStage(new HandoverStage());
   }
@@ -8238,7 +8324,8 @@ async function processAdvance(ctx, currentStage, advance, depth = 0) {
       }
       if (next.kind === "exhausted") {
         const postComplete = ctx.state.resolvedPostComplete ?? ctx.recipe.postComplete;
-        const post = findFirstPostComplete(postComplete, ctx);
+        const isInPostComplete = postComplete.includes(currentStage.id);
+        const post = isInPostComplete ? findNextPostComplete(postComplete, currentStage.id, ctx) : findFirstPostComplete(postComplete, ctx);
         if (post.kind === "found") {
           assertTransition(currentStage.id, post.stage.id);
           ctx.writeState({ state: post.stage.id, previousState: currentStage.id });
@@ -8384,6 +8471,7 @@ async function handleResume(root, args) {
       // T-128: tests invalidated by HEAD change
       CODE_REVIEW: { state: "PLAN", resetPlan: true, resetCode: true },
       FINALIZE: { state: "IMPLEMENT", resetPlan: false, resetCode: true },
+      LESSON_CAPTURE: { state: "PICK_TICKET", resetPlan: false, resetCode: false },
       ISSUE_SWEEP: { state: "PICK_TICKET", resetPlan: false, resetCode: false }
       // T-128: post-complete, restart sweep
     };
@@ -8538,6 +8626,34 @@ ${driftPreamble}Recovered to state: **${mapping.state}**. Continue from here.`,
   }
   const resumeMode = written.mode ?? "auto";
   const modeContext = resumeMode === "auto" ? "You are in autonomous mode \u2014 continue working." : resumeMode === "review" ? "You are in review mode \u2014 session ends after code review approval." : resumeMode === "plan" ? "You are in plan mode \u2014 session ends after plan review approval." : "You are in guided mode \u2014 single ticket, full pipeline.";
+  const resumeStage = getStage(resumeState);
+  if (resumeStage) {
+    const recipe = resolveRecipeFromState(written);
+    const ctx = new StageContext(root, info.dir, written, recipe);
+    const enterResult = await resumeStage.enter(ctx);
+    if (isStageAdvance(enterResult)) {
+      return processAdvance(ctx, resumeStage, enterResult);
+    }
+    return guideResult(ctx.state, resumeState, {
+      instruction: [
+        "# Resumed After Compact",
+        "",
+        `Session restored at state: **${resumeState}**.`,
+        written.ticket ? `Working on: **${written.ticket.id}: ${written.ticket.title}**` : "",
+        "",
+        modeContext,
+        "",
+        "---",
+        "",
+        enterResult.instruction
+      ].filter(Boolean).join("\n"),
+      reminders: [
+        ...enterResult.reminders ?? [],
+        ...resumeMode === "auto" ? ["Do NOT use plan mode.", "Do NOT stop or summarize."] : [`This is ${resumeMode} mode.`],
+        "Call autonomous_guide after completing each step."
+      ]
+    });
+  }
   return guideResult(written, resumeState, {
     instruction: [
       "# Resumed After Compact",
@@ -10101,7 +10217,7 @@ var init_mcp = __esm({
     init_init();
     ENV_VAR2 = "CLAUDESTORY_PROJECT_ROOT";
     CONFIG_PATH2 = ".story/config.json";
-    version = "0.1.26";
+    version = "0.1.28";
     main().catch((err) => {
       process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}
 `);
@@ -13379,7 +13495,7 @@ async function runCli() {
     registerConfigCommand: registerConfigCommand2,
     registerSessionCommand: registerSessionCommand2
   } = await Promise.resolve().then(() => (init_register(), register_exports));
-  const version2 = "0.1.26";
+  const version2 = "0.1.28";
   class HandledError extends Error {
     constructor() {
       super("HANDLED_ERROR");

package/dist/mcp.js

@@ -3472,6 +3472,7 @@ var init_session_types = __esm({
       "COMPACT",
       "HANDOVER",
       "COMPLETE",
+      "LESSON_CAPTURE",
       "ISSUE_SWEEP",
       "SESSION_END"
     ];
@@ -5200,6 +5201,8 @@ var TRANSITIONS = {
   // pass → FINALIZE, fail → IMPLEMENT, retry
   FINALIZE: ["COMPLETE"],
   COMPLETE: ["PICK_TICKET", "HANDOVER", "ISSUE_SWEEP", "SESSION_END"],
+  LESSON_CAPTURE: ["ISSUE_SWEEP", "HANDOVER", "LESSON_CAPTURE"],
+  // advance → ISSUE_SWEEP, retry self, done → HANDOVER
   ISSUE_SWEEP: ["ISSUE_SWEEP", "HANDOVER", "PICK_TICKET"],
   // retry (next issue), done → HANDOVER, loop → PICK_TICKET
   HANDOVER: ["COMPACT", "SESSION_END", "PICK_TICKET"],
@@ -5559,6 +5562,18 @@ function findFirstPostComplete(postComplete, ctx) {
   }
   return { kind: "exhausted" };
 }
+function findNextPostComplete(postComplete, currentId, ctx) {
+  const currentIndex = postComplete.indexOf(currentId);
+  const startIndex = currentIndex >= 0 ? currentIndex + 1 : 0;
+  for (let i = startIndex; i < postComplete.length; i++) {
+    const id = postComplete[i];
+    const stage = stages.get(id);
+    if (!stage) return { kind: "unregistered", id };
+    if (stage.skip?.(ctx)) continue;
+    return { kind: "found", stage };
+  }
+  return { kind: "exhausted" };
+}
 
 // src/autonomous/stages/types.ts
 init_esm_shims();
@@ -6915,6 +6930,68 @@ var CompleteStage = class {
   }
 };
 
+// src/autonomous/stages/lesson-capture.ts
+init_esm_shims();
+var LessonCaptureStage = class {
+  id = "LESSON_CAPTURE";
+  skip(ctx) {
+    const config = ctx.recipe.stages?.LESSON_CAPTURE;
+    return !config?.enabled;
+  }
+  async enter(ctx) {
+    const planReviews = ctx.state.reviews.plan ?? [];
+    const codeReviews = ctx.state.reviews.code ?? [];
+    const ticketsDone = ctx.state.completedTickets.length;
+    const planFindings = planReviews.reduce((sum, r) => sum + (r.findingCount ?? 0), 0);
+    const planCritical = planReviews.reduce((sum, r) => sum + (r.criticalCount ?? 0), 0);
+    const planMajor = planReviews.reduce((sum, r) => sum + (r.majorCount ?? 0), 0);
+    const codeFindings = codeReviews.reduce((sum, r) => sum + (r.findingCount ?? 0), 0);
+    const codeCritical = codeReviews.reduce((sum, r) => sum + (r.criticalCount ?? 0), 0);
+    const codeMajor = codeReviews.reduce((sum, r) => sum + (r.majorCount ?? 0), 0);
+    const totalFindings = planFindings + codeFindings;
+    if (totalFindings === 0) {
+      ctx.appendEvent("lesson_capture", { result: "no_findings", ticketsDone });
+      return { action: "advance" };
+    }
+    ctx.appendEvent("lesson_capture", {
+      result: "started",
+      ticketsDone,
+      planFindings,
+      codeFindings
+    });
+    return {
+      instruction: [
+        "# Capture Lessons from Review Findings",
+        "",
+        `This session completed ${ticketsDone} ticket(s). Review summary:`,
+        `- **Plan reviews:** ${planReviews.length} round(s), ${planCritical} critical, ${planMajor} major, ${planFindings} total findings`,
+        `- **Code reviews:** ${codeReviews.length} round(s), ${codeCritical} critical, ${codeMajor} major, ${codeFindings} total findings`,
+        "",
+        "Review these findings for recurring patterns worth capturing as lessons:",
+        "",
+        "1. Call `claudestory_lesson_list` to see existing lessons",
+        "2. For each pattern that recurred or was critical/major:",
+        "   - If it matches an existing lesson \u2192 call `claudestory_lesson_reinforce`",
+        '   - If it\'s a new pattern \u2192 call `claudestory_lesson_create` with `source: "review"`',
+        "3. Skip patterns that are one-off or already well-covered",
+        `4. Call \`claudestory_autonomous_guide\` with completedAction: "lessons_captured"`,
+        "",
+        "```json",
+        `{ "sessionId": "${ctx.state.sessionId}", "action": "report", "report": { "completedAction": "lessons_captured" } }`,
+        "```"
+      ].join("\n"),
+      reminders: [
+        "Check existing lessons first \u2014 reinforce before creating duplicates.",
+        "Only capture patterns worth remembering across sessions."
+      ]
+    };
+  }
+  async report(ctx, _report) {
+    ctx.appendEvent("lesson_capture", { result: "completed" });
+    return { action: "advance" };
+  }
+};
+
 // src/autonomous/stages/issue-sweep.ts
 init_esm_shims();
 var IssueSweepStage = class {
@@ -7105,6 +7182,7 @@ registerStage(new CodeReviewStage());
 registerStage(new VerifyStage());
 registerStage(new FinalizeStage());
 registerStage(new CompleteStage());
+registerStage(new LessonCaptureStage());
 registerStage(new IssueSweepStage());
 registerStage(new HandoverStage());
 
@@ -7728,7 +7806,8 @@ async function processAdvance(ctx, currentStage, advance, depth = 0) {
       }
       if (next.kind === "exhausted") {
         const postComplete = ctx.state.resolvedPostComplete ?? ctx.recipe.postComplete;
-        const post = findFirstPostComplete(postComplete, ctx);
+        const isInPostComplete = postComplete.includes(currentStage.id);
+        const post = isInPostComplete ? findNextPostComplete(postComplete, currentStage.id, ctx) : findFirstPostComplete(postComplete, ctx);
         if (post.kind === "found") {
           assertTransition(currentStage.id, post.stage.id);
           ctx.writeState({ state: post.stage.id, previousState: currentStage.id });
@@ -7874,6 +7953,7 @@ async function handleResume(root, args) {
       // T-128: tests invalidated by HEAD change
       CODE_REVIEW: { state: "PLAN", resetPlan: true, resetCode: true },
       FINALIZE: { state: "IMPLEMENT", resetPlan: false, resetCode: true },
+      LESSON_CAPTURE: { state: "PICK_TICKET", resetPlan: false, resetCode: false },
       ISSUE_SWEEP: { state: "PICK_TICKET", resetPlan: false, resetCode: false }
       // T-128: post-complete, restart sweep
     };
@@ -8028,6 +8108,34 @@ ${driftPreamble}Recovered to state: **${mapping.state}**. Continue from here.`,
   }
   const resumeMode = written.mode ?? "auto";
   const modeContext = resumeMode === "auto" ? "You are in autonomous mode \u2014 continue working." : resumeMode === "review" ? "You are in review mode \u2014 session ends after code review approval." : resumeMode === "plan" ? "You are in plan mode \u2014 session ends after plan review approval." : "You are in guided mode \u2014 single ticket, full pipeline.";
+  const resumeStage = getStage(resumeState);
+  if (resumeStage) {
+    const recipe = resolveRecipeFromState(written);
+    const ctx = new StageContext(root, info.dir, written, recipe);
+    const enterResult = await resumeStage.enter(ctx);
+    if (isStageAdvance(enterResult)) {
+      return processAdvance(ctx, resumeStage, enterResult);
+    }
+    return guideResult(ctx.state, resumeState, {
+      instruction: [
+        "# Resumed After Compact",
+        "",
+        `Session restored at state: **${resumeState}**.`,
+        written.ticket ? `Working on: **${written.ticket.id}: ${written.ticket.title}**` : "",
+        "",
+        modeContext,
+        "",
+        "---",
+        "",
+        enterResult.instruction
+      ].filter(Boolean).join("\n"),
+      reminders: [
+        ...enterResult.reminders ?? [],
+        ...resumeMode === "auto" ? ["Do NOT use plan mode.", "Do NOT stop or summarize."] : [`This is ${resumeMode} mode.`],
+        "Call autonomous_guide after completing each step."
+      ]
+    });
+  }
   return guideResult(written, resumeState, {
     instruction: [
       "# Resumed After Compact",
@@ -9266,7 +9374,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.26";
+var version = "0.1.28";
 function tryDiscoverRoot() {
   const envRoot = process.env[ENV_VAR2];
   if (envRoot) {

package/package.json

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