release: prepare v0.2.2

Author: mideco-tech

CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## Unreleased
 
+## v0.2.2 - 2026-05-05
+
+- Fixed a Details binding regression where pressing `Details` on an older completed run could render the latest run and `Back` could replace the older Final Card with the newer one.
+- Bound Details callbacks to their original panel/card using `panel_id`, thread, turn, chat/topic, and message-id guards, with stale callbacks failing closed instead of falling back to the current panel.
+- Restored Details rendering for older turns when App Server raw payloads use the nested `{ "thread": { "turns": [...] } }` shape.
+- Added unit coverage for old/new completed run panels, missing `panel_id`, mismatched message ids, and mismatched `Tools file` routes.
+- Added the checked-in `details_binding` live Telegram E2E case and validation notes for Details, `Tool on`, `Tools file`, and `Back`.
+
 ## v0.2.1 - 2026-05-05
 
 - Preserved the live `Current tool:` display for Telegram-origin turns when durable polling temporarily reports an older completed tool from the same turn.

README.md

@@ -4,7 +4,7 @@ Codex Telegram bot and remote UI for local OpenAI Codex App Server, built in Go.
 
 `codex-tg` turns a Telegram bot into a mobile control surface for local Codex threads: it watches Codex GUI/CLI activity, keeps thread identity visible, routes replies back to the right thread, and exposes high-signal controls such as Plan Mode prompts, Stop, Steer, Details, Tools file, and Get full log.
 
-Current release: `v0.2.1`.
+Current release: `v0.2.2`.
 
 ![codex-tg Telegram Plan Mode demo](docs/assets/telegram-plan-mode-demo.png)
 
@@ -47,7 +47,7 @@ The demo flow is documented in [docs/demo/telegram-plan-mode-demo.md](docs/demo/
 ## Platform Status
 
 - Windows: actively tested with the local Codex App Server, Telegram Bot API, observer flows, and live E2E demo.
-- macOS: `v0.2.1` is verified stable on macOS 26.3.1 arm64 with Go 1.26.2, LaunchAgent daemon startup, local build, and live Telegram readback E2E.
+- macOS: `v0.2.2` is verified stable on macOS 26.3.1 arm64 with Go 1.26.2, LaunchAgent daemon startup, local build, Details binding validation, and live Telegram readback E2E.
 - Linux: CI runs tests/builds on Ubuntu; full local daemon/runtime validation is still pending.
 
 ## Quickstart

docs/release/v0.2.2.md

@@ -0,0 +1,25 @@
+# v0.2.2 Release Notes
+
+## Highlights
+
+- Fixed a Telegram Details binding regression for multiple completed runs in the same thread.
+- Older Final Cards now keep their own Details, Tool view, Tools file export, and Back behavior.
+- Stale or mismatched Details callbacks fail closed instead of rendering the latest run.
+- Details can resolve older turns from nested App Server `thread/read` payloads.
+
+## Validation
+
+- `go test ./internal/daemon ./internal/storage`
+- `go test ./...`
+- `go build -buildvcs=false ./...`
+- `git diff --check`
+- targeted secret/local scan
+- macOS LaunchAgent rebuild/restart
+- live Telegram readback:
+  - checked-in `details_binding` case
+
+## Notes
+
+- No App Server protocol changes were required.
+- No database migration is required.
+- `v0.2.2` is a patch release on top of `v0.2.1`.

internal/version/version.go

@@ -1,3 +1,3 @@
 package version
 
-const Version = "0.2.1"
+const Version = "0.2.2"