@anthropologies/claudestory 0.1.29 → 0.1.31

package/dist/cli.js

@@ -5175,11 +5175,11 @@ var init_session_types = __esm({
       stealReason: z9.string().optional(),
       // Recipe overrides (maxTicketsPerSession: 0 = no limit)
       config: z9.object({
-        maxTicketsPerSession: z9.number().min(0).default(0),
-        handoverInterval: z9.number().min(0).default(5),
+        maxTicketsPerSession: z9.number().min(0).default(5),
+        handoverInterval: z9.number().min(0).default(3),
         compactThreshold: z9.string().default("high"),
         reviewBackends: z9.array(z9.string()).default(["codex", "agent"])
-      }).default({ maxTicketsPerSession: 0, compactThreshold: "high", reviewBackends: ["codex", "agent"], handoverInterval: 5 }),
+      }).default({ maxTicketsPerSession: 5, compactThreshold: "high", reviewBackends: ["codex", "agent"], handoverInterval: 3 }),
       // T-123: Issue sweep tracking
       issueSweepState: z9.object({
         remaining: z9.array(z9.string()),
@@ -5300,10 +5300,10 @@ function createSession(root, recipe, workspaceId, configOverrides) {
     startedAt: now,
     guideCallCount: 0,
     config: {
-      maxTicketsPerSession: configOverrides?.maxTicketsPerSession ?? 0,
+      maxTicketsPerSession: configOverrides?.maxTicketsPerSession ?? 5,
       compactThreshold: configOverrides?.compactThreshold ?? "high",
       reviewBackends: configOverrides?.reviewBackends ?? ["codex", "agent"],
-      handoverInterval: configOverrides?.handoverInterval ?? 5
+      handoverInterval: configOverrides?.handoverInterval ?? 3
     }
   };
   writeSessionSync(dir, state);
@@ -8275,7 +8275,7 @@ ${ticket.description}` : "",
     });
     const topCandidate = nextResult.kind === "found" ? nextResult.candidates[0] : null;
     const maxTickets = updated.config.maxTicketsPerSession;
-    const interval = updated.config.handoverInterval ?? 5;
+    const interval = updated.config.handoverInterval ?? 3;
     const sessionDesc = maxTickets > 0 ? `Work continuously until all tickets are done or you reach ${maxTickets} tickets.` : "Work continuously until all tickets are done.";
     const checkpointDesc = interval > 0 ? ` A checkpoint handover will be saved every ${interval} tickets.` : "";
     const instruction = [
@@ -10239,7 +10239,7 @@ var init_mcp = __esm({
     init_init();
     ENV_VAR2 = "CLAUDESTORY_PROJECT_ROOT";
     CONFIG_PATH2 = ".story/config.json";
-    version = "0.1.29";
+    version = "0.1.31";
     main().catch((err) => {
       process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}
 `);
@@ -10733,6 +10733,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 +13523,7 @@ async function runCli() {
     registerConfigCommand: registerConfigCommand2,
     registerSessionCommand: registerSessionCommand2
   } = await Promise.resolve().then(() => (init_register(), register_exports));
-  const version2 = "0.1.29";
+  const version2 = "0.1.31";
   class HandledError extends Error {
     constructor() {
       super("HANDLED_ERROR");

package/dist/mcp.js

@@ -3617,11 +3617,11 @@ var init_session_types = __esm({
       stealReason: z9.string().optional(),
       // Recipe overrides (maxTicketsPerSession: 0 = no limit)
       config: z9.object({
-        maxTicketsPerSession: z9.number().min(0).default(0),
-        handoverInterval: z9.number().min(0).default(5),
+        maxTicketsPerSession: z9.number().min(0).default(5),
+        handoverInterval: z9.number().min(0).default(3),
         compactThreshold: z9.string().default("high"),
         reviewBackends: z9.array(z9.string()).default(["codex", "agent"])
-      }).default({ maxTicketsPerSession: 0, compactThreshold: "high", reviewBackends: ["codex", "agent"], handoverInterval: 5 }),
+      }).default({ maxTicketsPerSession: 5, compactThreshold: "high", reviewBackends: ["codex", "agent"], handoverInterval: 3 }),
       // T-123: Issue sweep tracking
       issueSweepState: z9.object({
         remaining: z9.array(z9.string()),
@@ -3742,10 +3742,10 @@ function createSession(root, recipe, workspaceId, configOverrides) {
     startedAt: now,
     guideCallCount: 0,
     config: {
-      maxTicketsPerSession: configOverrides?.maxTicketsPerSession ?? 0,
+      maxTicketsPerSession: configOverrides?.maxTicketsPerSession ?? 5,
       compactThreshold: configOverrides?.compactThreshold ?? "high",
       reviewBackends: configOverrides?.reviewBackends ?? ["codex", "agent"],
-      handoverInterval: configOverrides?.handoverInterval ?? 5
+      handoverInterval: configOverrides?.handoverInterval ?? 3
     }
   };
   writeSessionSync(dir, state);
@@ -7755,7 +7755,7 @@ ${ticket.description}` : "",
     });
     const topCandidate = nextResult.kind === "found" ? nextResult.candidates[0] : null;
     const maxTickets = updated.config.maxTicketsPerSession;
-    const interval = updated.config.handoverInterval ?? 5;
+    const interval = updated.config.handoverInterval ?? 3;
     const sessionDesc = maxTickets > 0 ? `Work continuously until all tickets are done or you reach ${maxTickets} tickets.` : "Work continuously until all tickets are done.";
     const checkpointDesc = interval > 0 ? ` A checkpoint handover will be saved every ${interval} tickets.` : "";
     const instruction = [
@@ -9395,7 +9395,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.29";
+var version = "0.1.31";
 function tryDiscoverRoot() {
   const envRoot = process.env[ENV_VAR2];
   if (envRoot) {

package/package.json

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