release: prepare v0.2.1

Author: mideco-tech

CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## Unreleased
 
+## 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.
+- Added a live E2E regression case that exercises two long-running progress-printing commands and fails if `[Tool]` reverts to an older completed command while the newer tool is still running.
+- Split Codex UI `Documents/Codex` chats into a dedicated `Chats` navigation area under `/projects`, with recency sorting, pagination, `/newchat <prompt>`, and configurable preview/page limits.
+- Improved `/projects` readability: project buttons now use `N. Project name`, Chat buttons use `Chat N. Thread name`, and visible internal `key:` rows were replaced with `last thread:`.
+- Updated contract, regression, validation, quickstart, and Telegram UX docs for the Projects/Chats navigation and v0.2.1 live validation.
+
 ## v0.2.0 - 2026-05-04
 
 - Added a normalized App Server live event layer for `item/*`, `turn/*`, `thread/status/changed`, and legacy `codex/event/*` notifications.

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.0`.
+Current release: `v0.2.1`.
 
 ![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.0` 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.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.
 - Linux: CI runs tests/builds on Ubuntu; full local daemon/runtime validation is still pending.
 
 ## Quickstart

docs/release/v0.2.1.md

@@ -0,0 +1,27 @@
+# v0.2.1 Release Notes
+
+## Highlights
+
+- Telegram-origin `[Tool]` no longer falls back to an older completed command while a newer live current tool is running.
+- `/projects` now separates Codex UI `Documents/Codex` chats into a dedicated `Chats` navigation path with recency sorting and pagination.
+- Project buttons use `N. Project name`; Chat buttons use `Chat N. Thread name`.
+- Project rows no longer expose internal `key:` values and instead show `last thread:`.
+- `/newchat <prompt>` starts a new App Server thread without selecting a project cwd.
+
+## Validation
+
+- `go test ./internal/daemon ./internal/config ./internal/model ./internal/storage ./tests`
+- `go test ./...`
+- `go build -buildvcs=false ./...`
+- `git diff --check`
+- targeted secret/local scan
+- macOS LaunchAgent rebuild/restart
+- live Telegram readback:
+  - Projects/Chats label smoke
+  - `current_tool_priority`
+
+## Notes
+
+- `v0.2.0` remains the live App Server event refactor release.
+- `v0.2.1` is a patch release for current-tool stability plus Projects/Chats UX polish.
+- No App Server protocol changes were required.

internal/version/version.go

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