From 2ea2008f36bf081ea2ee24dcc709c49970b74c00 Mon Sep 17 00:00:00 2001
From: oddkit-agent <agent@oddkit.dev>
Date: Mon, 20 Apr 2026 13:25:06 +0000
Subject: [PATCH] =?UTF-8?q?chore:=20release=200.22.0=20=E2=80=94=20backfil?=
 =?UTF-8?q?l=20CHANGELOG,=20bump=20version?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Bumps version in package.json, workers/package.json, and both lockfiles.
Fills CHANGELOG [Unreleased] with 0.22.0 entries covering PR #124
(telemetry_public envelope conformance) and PR #125 (catalog
debug.generated_at response time + new index_built_at field).

MINOR bump: both fixes add envelope fields consumers can rely on.

Both bugs caught during the v0.21.1 regression test sweep. Pre-commit
hook verified version sync and typecheck pass.

No code or test changes in this PR — documentation + version only.
---
 CHANGELOG.md              | 14 ++++++++++++++
 package-lock.json         |  4 ++--
 package.json              |  2 +-
 workers/package-lock.json |  4 ++--
 workers/package.json      |  2 +-
 5 files changed, 20 insertions(+), 6 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 282a667..df35b0f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.22.0] - 2026-04-20
+
+### Added
+
+- **`index_built_at` on `oddkit_catalog` debug envelope** — catalog now surfaces the index build timestamp under an accurately-named field, preserving the cache-freshness diagnostic alongside the response-time `generated_at`. Landed via klappy/oddkit#125.
+
+### Fixed
+
+- **`telemetry_public` envelope conformance** — previously returned a bare `{action, result}` envelope, missing `server_time`, `assistant_text`, and `debug`. Every other tool — including `telemetry_policy` after PR #108 — already emitted the full envelope. This fix brings `telemetry_public` into conformance with the E0008.2 canon (`klappy://docs/appendices/epoch-8-2`) and adds the missing three fields on both the success path and the not-configured error path. `assistant_text` on success is derived from the row count when the result carries data rows. `result.generated_at` preserved unchanged. Landed via klappy/oddkit#124.
+
+- **`oddkit_catalog` `debug.generated_at` is response time, not cached index timestamp** — `runCatalog` previously returned `generated_at: index.generated_at` — the cached index build timestamp — producing up to 48-minute drift from envelope `server_time` in the same response. Every other handler uses `new Date().toISOString()` for this field. Fix aligns catalog with the same pattern; the cache-build timestamp is preserved as a separate, accurately-named `index_built_at` field (see Added). Landed via klappy/oddkit#125.
+
+Both bugs caught during the v0.21.1 regression test sweep.
+
 ## [0.21.1] - 2026-04-20
 
 ### Fixed
diff --git a/package-lock.json b/package-lock.json
index c65dc19..0e0dd1a 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "oddkit",
-  "version": "0.18.0",
+  "version": "0.22.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "oddkit",
-      "version": "0.18.0",
+      "version": "0.22.0",
       "license": "MIT",
       "dependencies": {
         "@modelcontextprotocol/sdk": "^1.0.0",
diff --git a/package.json b/package.json
index d4da3ba..d377ab3 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "oddkit",
-  "version": "0.21.1",
+  "version": "0.22.0",
   "description": "Agent-first CLI for ODD-governed repos. Epistemic terrain rendering with portable baseline.",
   "type": "module",
   "bin": {
diff --git a/workers/package-lock.json b/workers/package-lock.json
index e0021e7..a7994f0 100644
--- a/workers/package-lock.json
+++ b/workers/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "oddkit-mcp-worker",
-  "version": "0.21.1",
+  "version": "0.22.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "oddkit-mcp-worker",
-      "version": "0.21.1",
+      "version": "0.22.0",
       "dependencies": {
         "agents": "^0.4.1",
         "fflate": "^0.8.2",
diff --git a/workers/package.json b/workers/package.json
index 400c8e5..ecf3988 100644
--- a/workers/package.json
+++ b/workers/package.json
@@ -1,6 +1,6 @@
 {
   "name": "oddkit-mcp-worker",
-  "version": "0.21.1",
+  "version": "0.22.0",
   "private": true,
   "type": "module",
   "scripts": {