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

CHANGELOG.md

@@ -60,6 +60,17 @@ All notable changes to vouch are documented here. Format follows
 ## [1.3.0] — 2026-07-14
 
 ### Added
+- `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
@@ -246,6 +257,21 @@ All notable changes to vouch are documented here. Format follows
 - `context` and `lifecycle` catch only the exceptions they can handle
   (sqlite errors on fts5 fallback, missing-artifact on citation lookup)
   instead of blanket `except Exception`.
+
+## [1.2.2] — 2026-07-07
+
+### Packaging
+- published to the mcp registry (`registry.modelcontextprotocol.io`, mirrored
+  at `github.com/mcp/vouchdev/vouch`) as `io.github.vouchdev/vouch`. a
+  `server.json` at the repo root carries the metadata; the pypi `vouch-kb`
+  package is the artifact, run over stdio via `uvx vouch-kb serve`.
+- `vouch-kb` console-script alias (alongside `vouch`) so `uvx vouch-kb serve`
+  resolves — the registry launches a package by its pypi identifier, which
+  otherwise wouldn't match the `vouch` script name.
+- README carries an `<!-- mcp-name: io.github.vouchdev/vouch -->` marker;
+  the registry verifies package ownership by matching it against `server.json`.
+
+### Fixed
 - `vouch install-mcp <host>` (codex `toml_merge`): a `config.toml` the minimal
   serializer couldn't faithfully re-emit (a non-BMP string value, a `nan`/`inf`
   float) was bucketed as `skipped` and printed as `(already present)` with a

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",
@@ -127,6 +128,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")