@anthropologies/claudestory 0.1.30 → 0.1.32

package/dist/cli.js

@@ -7158,6 +7158,19 @@ var init_finalize = __esm({
         };
       }
       async handleStage(ctx, report) {
+        const checkpoint = ctx.state.finalizeCheckpoint;
+        if (checkpoint === "staged" || checkpoint === "staged_override") {
+          return {
+            action: "retry",
+            instruction: [
+              "Files staged. Now run pre-commit checks.",
+              "",
+              'Run any pre-commit hooks or linting, then call me with completedAction: "precommit_passed".',
+              'If pre-commit fails, fix the issues, re-stage, and call me with completedAction: "files_staged" again.'
+            ].join("\n"),
+            reminders: ["Verify staged set is intact after pre-commit hooks."]
+          };
+        }
         const stagedResult = await gitDiffCachedNames(ctx.root);
         if (!stagedResult.ok || stagedResult.data.length === 0) {
           const headResult = await gitHead(ctx.root);
@@ -7182,7 +7195,10 @@ var init_finalize = __esm({
         const baselineUntracked = ctx.state.git.baseline?.untrackedPaths ?? [];
         let overlapOverridden = false;
         if (baselineUntracked.length > 0) {
-          const overlap = stagedResult.data.filter((f) => baselineUntracked.includes(f));
+          const sessionTicketPath = ctx.state.ticket?.id ? `.story/tickets/${ctx.state.ticket.id}.json` : null;
+          const overlap = stagedResult.data.filter(
+            (f) => baselineUntracked.includes(f) && f !== sessionTicketPath
+          );
           if (overlap.length > 0) {
             if (report.overrideOverlap) {
               overlapOverridden = true;
@@ -7231,7 +7247,10 @@ var init_finalize = __esm({
         if (checkpoint !== "staged_override") {
           const baselineUntracked = ctx.state.git.baseline?.untrackedPaths ?? [];
           if (baselineUntracked.length > 0) {
-            const overlap = stagedResult.data.filter((f) => baselineUntracked.includes(f));
+            const sessionTicketPath = ctx.state.ticket?.id ? `.story/tickets/${ctx.state.ticket.id}.json` : null;
+            const overlap = stagedResult.data.filter(
+              (f) => baselineUntracked.includes(f) && f !== sessionTicketPath
+            );
             if (overlap.length > 0) {
               ctx.writeState({ finalizeCheckpoint: null });
               return { action: "retry", instruction: `Pre-commit hooks staged pre-existing untracked files: ${overlap.join(", ")}. Unstage them and re-stage, then call with completedAction: "files_staged".` };
@@ -10239,7 +10258,7 @@ var init_mcp = __esm({
     init_init();
     ENV_VAR2 = "CLAUDESTORY_PROJECT_ROOT";
     CONFIG_PATH2 = ".story/config.json";
-    version = "0.1.30";
+    version = "0.1.32";
     main().catch((err) => {
       process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}
 `);
@@ -10733,6 +10752,12 @@ var init_reference = __esm({
       { name: "claudestory_issue_create", description: "Create issue", params: ["title", "severity", "impact", "components?", "relatedTickets?", "location?", "phase?"] },
       { name: "claudestory_issue_update", description: "Update issue", params: ["id", "status?", "title?", "severity?", "impact?", "resolution?", "components?", "relatedTickets?", "location?", "order?", "phase?"] },
       { name: "claudestory_phase_create", description: "Create phase in roadmap", params: ["id", "name", "label", "description", "summary?", "after?", "atStart?"] },
+      { name: "claudestory_lesson_list", description: "List lessons", params: ["status?", "tag?", "source?"] },
+      { name: "claudestory_lesson_get", description: "Get lesson by ID", params: ["id"] },
+      { name: "claudestory_lesson_digest", description: "Ranked digest of active lessons for context loading" },
+      { name: "claudestory_lesson_create", description: "Create lesson", params: ["title", "content", "context", "source", "tags?", "supersedes?"] },
+      { name: "claudestory_lesson_update", description: "Update lesson", params: ["id", "title?", "content?", "context?", "tags?", "status?", "supersedes?"] },
+      { name: "claudestory_lesson_reinforce", description: "Reinforce lesson \u2014 increment count and update lastValidated", params: ["id"] },
       { name: "claudestory_selftest", description: "Integration smoke test \u2014 create/update/delete cycle" }
     ];
   }
@@ -13517,7 +13542,7 @@ async function runCli() {
     registerConfigCommand: registerConfigCommand2,
     registerSessionCommand: registerSessionCommand2
   } = await Promise.resolve().then(() => (init_register(), register_exports));
-  const version2 = "0.1.30";
+  const version2 = "0.1.32";
   class HandledError extends Error {
     constructor() {
       super("HANDLED_ERROR");

package/dist/mcp.js

@@ -6678,6 +6678,19 @@ var FinalizeStage = class {
     };
   }
   async handleStage(ctx, report) {
+    const checkpoint = ctx.state.finalizeCheckpoint;
+    if (checkpoint === "staged" || checkpoint === "staged_override") {
+      return {
+        action: "retry",
+        instruction: [
+          "Files staged. Now run pre-commit checks.",
+          "",
+          'Run any pre-commit hooks or linting, then call me with completedAction: "precommit_passed".',
+          'If pre-commit fails, fix the issues, re-stage, and call me with completedAction: "files_staged" again.'
+        ].join("\n"),
+        reminders: ["Verify staged set is intact after pre-commit hooks."]
+      };
+    }
     const stagedResult = await gitDiffCachedNames(ctx.root);
     if (!stagedResult.ok || stagedResult.data.length === 0) {
       const headResult = await gitHead(ctx.root);
@@ -6702,7 +6715,10 @@ var FinalizeStage = class {
     const baselineUntracked = ctx.state.git.baseline?.untrackedPaths ?? [];
     let overlapOverridden = false;
     if (baselineUntracked.length > 0) {
-      const overlap = stagedResult.data.filter((f) => baselineUntracked.includes(f));
+      const sessionTicketPath = ctx.state.ticket?.id ? `.story/tickets/${ctx.state.ticket.id}.json` : null;
+      const overlap = stagedResult.data.filter(
+        (f) => baselineUntracked.includes(f) && f !== sessionTicketPath
+      );
       if (overlap.length > 0) {
         if (report.overrideOverlap) {
           overlapOverridden = true;
@@ -6751,7 +6767,10 @@ var FinalizeStage = class {
     if (checkpoint !== "staged_override") {
       const baselineUntracked = ctx.state.git.baseline?.untrackedPaths ?? [];
       if (baselineUntracked.length > 0) {
-        const overlap = stagedResult.data.filter((f) => baselineUntracked.includes(f));
+        const sessionTicketPath = ctx.state.ticket?.id ? `.story/tickets/${ctx.state.ticket.id}.json` : null;
+        const overlap = stagedResult.data.filter(
+          (f) => baselineUntracked.includes(f) && f !== sessionTicketPath
+        );
         if (overlap.length > 0) {
           ctx.writeState({ finalizeCheckpoint: null });
           return { action: "retry", instruction: `Pre-commit hooks staged pre-existing untracked files: ${overlap.join(", ")}. Unstage them and re-stage, then call with completedAction: "files_staged".` };
@@ -9395,7 +9414,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.30";
+var version = "0.1.32";
 function tryDiscoverRoot() {
   const envRoot = process.env[ENV_VAR2];
   if (envRoot) {

package/package.json

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

package/src/skill/SKILL.md

@@ -232,6 +232,14 @@ Then ask: **"What would you like to work on?"**
 
 Before writing a handover at the end of a session, run `claudestory snapshot` first. This ensures the next session's recap can show what changed. If `setup-skill` has been run, a PreCompact hook auto-takes snapshots before context compaction.
 
+**Lessons** capture non-obvious process learnings that should carry forward across sessions. At the end of a significant session, review what you learned and create lessons via `claudestory_lesson_create` for:
+- Patterns that worked (or failed) and why
+- Architecture decisions with non-obvious rationale
+- Tool/framework quirks discovered during implementation
+- Process improvements (review workflows, testing strategies)
+
+Don't duplicate what's already in the handover — lessons are structured, tagged, and ranked. Handovers are narrative. Use `claudestory_lesson_digest` to check existing lessons before creating duplicates. Use `claudestory_lesson_reinforce` when an existing lesson proves true again.
+
 ## Ticket and Issue Discipline
 
 **Tickets** are planned work — features, tasks, refactors. They represent intentional, scoped commitments.

package/src/skill/reference.md

@@ -320,6 +320,12 @@ claudestory setup-skill
 - **claudestory_issue_create** (title, severity, impact, components?, relatedTickets?, location?, phase?) — Create issue
 - **claudestory_issue_update** (id, status?, title?, severity?, impact?, resolution?, components?, relatedTickets?, location?, order?, phase?) — Update issue
 - **claudestory_phase_create** (id, name, label, description, summary?, after?, atStart?) — Create phase in roadmap
+- **claudestory_lesson_list** (status?, tag?, source?) — List lessons
+- **claudestory_lesson_get** (id) — Get lesson by ID
+- **claudestory_lesson_digest** — Ranked digest of active lessons for context loading
+- **claudestory_lesson_create** (title, content, context, source, tags?, supersedes?) — Create lesson
+- **claudestory_lesson_update** (id, title?, content?, context?, tags?, status?, supersedes?) — Update lesson
+- **claudestory_lesson_reinforce** (id) — Reinforce lesson — increment count and update lastValidated
 - **claudestory_selftest** — Integration smoke test — create/update/delete cycle
 
 ## Common Workflows