release: prepare v0.5.0

Author: mideco-tech

CHANGELOG.md

@@ -2,6 +2,16 @@
 
 ## Unreleased
 
+## v0.5.0 - 2026-05-18
+
+- Repositioned the project from a Telegram-first remote UI to a local Codex Control Plane with Telegram as the first production adapter.
+- Added ADR-019, Control Plane wiki docs, v0.5 feature brief, roadmap, research notes, and theory log.
+- Added `internal/control` with adapter-independent runtime/control interfaces for App Server-backed threads, turns, events, approvals, models, ecosystem discovery, diagnostics, and notifications.
+- Added App Server wrappers for thread fork/name/archive/unarchive/compact/rollback plus skills, hooks, MCP status, app list, config, and plugin skill discovery.
+- Added a schema-backed App Server capability map for installed Codex method detection, including future goal API drift handling.
+- Moved normalized event and notification severity contracts into the control layer while preserving existing Telegram adapter behavior.
+- Added `.DS_Store` ignore rules to keep macOS metadata out of future commits.
+
 ## v0.4.0 - 2026-05-07
 
 - Added macOS user-level service installation through `ctr-go service install`, including friendly first-run prompts, non-interactive flags, LaunchAgent generation, start/stop/restart/status, login toggle, and uninstall.

README.md

@@ -19,7 +19,7 @@ and other private adapters.
 - Thread-first routing keeps replies, tools, Plan Mode, Details, and Final cards attached to the right run.
 - Built toward long-running local coding-agent orchestration and future router-agent workflows.
 
-Current release: `v0.4.0`.
+Current release: `v0.5.0`.
 
 ![codex-tg Telegram Plan Mode demo](docs/assets/telegram-plan-mode-demo.png)
 
@@ -73,7 +73,7 @@ future adapters can consume the same Codex control core.
 ## Platform Status
 
 - Windows: actively tested with the local Codex App Server, Telegram Bot API, observer flows, and live E2E demo.
-- macOS: `v0.4.0` is verified stable on macOS 26.3.1 arm64 with Go 1.26.2, user LaunchAgent service setup, local build, package dry-run, Details binding validation, Telegram command-menu readback, real Chat folder creation, low-noise notification validation, Plan Mode reset validation, and live Telegram readback E2E.
+- macOS: `v0.5.0` preserves the `v0.4.0` verified service/runtime path on macOS 26.3.1 arm64 with Go 1.26.2, and adds validated Codex Control Plane architecture, internal control interfaces, capability mapping, normalized event contracts, and notification severity policy.
 - Linux: CI runs tests/builds on Ubuntu; full local daemon/runtime validation is still pending.
 
 ## Quickstart

docs/release/v0.5.0.md

@@ -0,0 +1,28 @@
+# v0.5.0
+
+`v0.5.0` starts the Codex Control Plane direction for `codex-tg`.
+
+## Highlights
+
+- Repositions the project from a Telegram-first remote UI to a local Codex Control Plane with Telegram as the first production adapter.
+- Adds ADR-019 and a full documentation set for the v0.5 architecture, research, theory log, roadmap, and user-facing Control Plane wiki page.
+- Adds `internal/control`, an adapter-independent Go layer for runtime sessions, threads, turns, approvals, events, ecosystem discovery, diagnostics, and notification severity.
+- Extends the App Server client with control-plane wrappers for thread administration and ecosystem discovery.
+- Adds a schema-backed capability map so future router-agent work can detect installed Codex method support instead of assuming docs and local versions always match.
+
+## Compatibility
+
+- Telegram behavior is intended to remain compatible with `v0.4.0`.
+- App Server remains the authoritative live state source.
+- SDK/MCP are allowed only as orchestration adapters under ADR-019.
+- No public HTTP API, voice adapter, or cloud layer is introduced in this release.
+
+## Validation
+
+- `go test ./internal/control ./internal/appserver ./internal/daemon`
+- `go test ./...`
+- `go build -buildvcs=false ./...`
+- `git diff --check`
+- targeted secret/local scans over edited docs and control code
+
+Live Telegram E2E was not required because this release does not change Telegram-visible behavior.

docs/testing/validation-notes.md

@@ -4,6 +4,10 @@ This file captures validation nuances that are useful for agents and maintainers
 
 For feature-to-test ownership, see `docs/testing/regression-map.md`.
 
+## v0.5.0 control-plane architecture
+
+2026-05-18 PDT: v0.5.0 control-plane architecture validation added ADR-019, Control Plane docs, internal control interfaces, App Server capability mapping, normalized event contracts, and notification severity policy. The slice was validated with targeted `internal/control`, `internal/appserver`, and `internal/daemon` tests, full `go test ./...`, `go build -buildvcs=false ./...`, `git diff --check`, and targeted secret/local scans. Live Telegram E2E was not required because Telegram-visible behavior was not changed.
+
 ## Runtime and documented UX contract
 
 The public docs describe the intended observer/UI contract:

internal/version/version.go

@@ -1,3 +1,3 @@
 package version
 
-const Version = "0.4.0"
+const Version = "0.5.0"