feat: lessons as a typed artifact with follow-through tracking (#428)

CHANGELOG.md

@@ -26,6 +26,17 @@ All notable changes to vouch are documented here. Format follows
   the catalogue without restarting the server, and is surfaced on
   `kb.capabilities.mcp.publish_skills` so clients can detect the gate. An
   existing KB with no `mcp:` block stays default-on (#235).
+- `lesson` claim type (`ClaimType.LESSON`) and `kb.mark_lesson_followed` —
+  an append-only observation of whether a surfaced lesson was actually
+  followed in a given turn. Never edits the claim; appends a
+  `lesson.followed` event to `audit.log.jsonl` with `followed`, optional
+  `context`, and `claim_type`. Registered across CLI (`mark-lesson-followed`),
+  MCP, JSONL, and `capabilities.METHODS`. Lessons resurface through the
+  normal retrieval path with no special-casing, and get the propose-time
+  repeat guard (#147) for free, since `propose_claim` already runs
+  `find_similar_on_propose` for every claim type. Not restricted to
+  `ClaimType.LESSON` — any claim id can carry a follow-through observation.
+  (#428)
 - `vouch console`: serve the vendored React web console straight from the
   installed package — a same-origin `/proxy` bridge (loopback-guarded) to
   `vouch serve --transport http` backends, reimplementing the vite dev-proxy
@@ -98,14 +109,13 @@ All notable changes to vouch are documented here. Format follows
   and pending proposals, never updated as drafts were accepted within the
   batch. Approving the second proposal would silently route through
   `update_page()` and overwrite the first. (#439)
-
-### Fixed
 - claude-code: the `UserPromptSubmit` context hook computed retrieval but
   never fed the entity-salience reflex (#223) — `salience.record_query`
   was never called from the hook path, leaving the reflex permanently
   dormant for every claude-code session. OpenClaw's context engine already
   called it correctly; cursor's `beforeSubmitPrompt` hook cannot accept
   injected context at all, so it is not wired. (#425)
+
 ## [1.2.2] — 2026-07-07
 
 ### Packaging

schemas/claim.schema.json

@@ -56,7 +56,8 @@
         "workflow",
         "observation",
         "question",
-        "warning"
+        "warning",
+        "lesson"
       ],
       "title": "ClaimType",
       "type": "string"

src/vouch/capabilities.py

@@ -66,6 +66,7 @@
     "kb.contradict",
     "kb.archive",
     "kb.confirm",
+    "kb.mark_lesson_followed",
     "kb.clear_claims",
     "kb.cite",
     "kb.source_verify",
@@ -126,6 +127,7 @@ def capabilities(*, publish_skills: bool = True) -> Capabilities:
     retrieval = ["fts5", "substring"]
     try:
         from .embeddings import get_embedder
+
         get_embedder()
         retrieval.append("embedding")
         retrieval.append("hybrid")