@anthropologies/claudestory 0.1.30 → 0.1.31

package/dist/cli.js

@@ -10239,7 +10239,7 @@ var init_mcp = __esm({
     init_init();
     ENV_VAR2 = "CLAUDESTORY_PROJECT_ROOT";
     CONFIG_PATH2 = ".story/config.json";
-    version = "0.1.30";
+    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.30";
+  const version2 = "0.1.31";
   class HandledError extends Error {
     constructor() {
       super("HANDLED_ERROR");

package/dist/mcp.js

@@ -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.30";
+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.30",
+  "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