diff --git a/CHANGELOG.md b/CHANGELOG.md
index 729c77e1..e2d68673 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,4 +1,55 @@
 # Changelog
+## [0.5.0] - 2026-06-29
+
+
+### Bug Fixes
+
+- **bot**: Strip bot token from download errors; reuse bot client; test with_retry
+- **bot**: Preserve teloxide behavior — ignore edited msgs, restore per-min throttle cap, don't throttle edits, drop dead send_html
+- **bot**: Address code-review findings on frankenstein migration
+
+### Documentation
+
+- **bot**: Phase3 — refresh stale teloxide references to webhook/Telegram bot
+
+### Features
+
+- **bot**: Add TgError for frankenstein client wrapper
+- **bot**: Add Throttle (global + per-chat rate gate) for RightBot
+- **bot**: RightBot frankenstein wrapper (send/edit/answer/download/commands/media/forum/webhook)
+- **bot**: Manual BotCommand parser replacing teloxide derive
+- **bot**: Callback-route + webhook-outcome decision fns for the update router
+- **bot**: [**breaking**] Replace teloxide with frankenstein — green build (all targets)
+
+### Miscellaneous
+
+- **bot**: Phase2 green gate — visibility + clippy cleanup, no new warnings
+
+### Refactor
+
+- **bot**: Pub(crate) for command/router items (unreachable_pub)
+- **bot**: Drop dead auth-flow HandlerCtx fields + orphan markers; doc fixups
+
+### Build
+
+- **bot**: Add frankenstein + governor deps alongside teloxide
+
+### Wip
+
+- **bot**: Phase2 foundation — RightBot extras, msg_ext helpers, BotType alias flip, build_bot
+- **bot**: Phase2 task 2.2 — mention/session/filter type sweep
+- **bot**: Phase2 task 2.5 — handler.rs to HandlerCtx + frankenstein
+- **bot**: Phase2 task 2.4a — error_details/bootstrap_photo/model_command
+- **bot**: Phase2 task 2.4b — mode_command to HandlerCtx + frankenstein
+- **bot**: Phase2 task 2.4c — debug/allowlist command handlers
+- **bot**: Phase2 task 2.6a — progress.rs to RightBot
+- **bot**: Phase2 task 2.6b — async_delivery.rs to RightBot
+- **bot**: Phase2 task 2.3 — attachments.rs to frankenstein/RightBot; tg_bot media html param
+- **bot**: Phase2 task 2.6c — worker.rs to RightBot/frankenstein
+- **bot**: Phase2 misc — sandbox_runtime/focus to i64/RightBot
+- **bot**: Phase2 task 2.7/2.8 — dispatch setup_telegram split, webhook router, lib.rs wiring, delete shutdown_listener
+- **bot**: Phase2 — lib compiles; archive/menu/Update-path/User-fields fixes
+
 ## [0.4.2] - 2026-06-17
 
 ### Skill Curator
diff --git a/Cargo.lock b/Cargo.lock
index 7d11a7be..e09b7fc5 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -3586,7 +3586,7 @@ dependencies = [
 
 [[package]]
 name = "right"
-version = "0.4.2"
+version = "0.5.0"
 dependencies = [
  "anyhow",
  "assert_cmd",
@@ -3638,7 +3638,7 @@ dependencies = [
 
 [[package]]
 name = "right-agent"
-version = "0.4.2"
+version = "0.5.0"
 dependencies = [
  "chrono",
  "const_format",
@@ -3678,7 +3678,7 @@ dependencies = [
 
 [[package]]
 name = "right-agent-config"
-version = "0.4.2"
+version = "0.5.0"
 dependencies = [
  "miette",
  "serde",
@@ -3688,7 +3688,7 @@ dependencies = [
 
 [[package]]
 name = "right-bot"
-version = "0.4.2"
+version = "0.5.0"
 dependencies = [
  "anyhow",
  "arc-swap",
@@ -3752,7 +3752,7 @@ dependencies = [
 
 [[package]]
 name = "right-codegen"
-version = "0.4.2"
+version = "0.5.0"
 dependencies = [
  "dirs",
  "include_dir",
@@ -3779,7 +3779,7 @@ dependencies = [
 
 [[package]]
 name = "right-config"
-version = "0.4.2"
+version = "0.5.0"
 dependencies = [
  "dirs",
  "miette",
@@ -3792,7 +3792,7 @@ dependencies = [
 
 [[package]]
 name = "right-dashboard"
-version = "0.4.2"
+version = "0.5.0"
 dependencies = [
  "chrono",
  "chrono-tz",
@@ -3816,7 +3816,7 @@ dependencies = [
 
 [[package]]
 name = "right-db"
-version = "0.4.2"
+version = "0.5.0"
 dependencies = [
  "chrono",
  "fs4 1.1.0",
@@ -3830,7 +3830,7 @@ dependencies = [
 
 [[package]]
 name = "right-hostpath"
-version = "0.4.2"
+version = "0.5.0"
 dependencies = [
  "tempfile",
  "thiserror 2.0.18",
@@ -3838,7 +3838,7 @@ dependencies = [
 
 [[package]]
 name = "right-lifecycle"
-version = "0.4.2"
+version = "0.5.0"
 dependencies = [
  "chrono",
  "right-db",
@@ -3851,7 +3851,7 @@ dependencies = [
 
 [[package]]
 name = "right-mcp"
-version = "0.4.2"
+version = "0.5.0"
 dependencies = [
  "axum",
  "base64",
@@ -3885,7 +3885,7 @@ dependencies = [
 
 [[package]]
 name = "right-memory"
-version = "0.4.2"
+version = "0.5.0"
 dependencies = [
  "chrono",
  "fastrand",
@@ -3903,7 +3903,7 @@ dependencies = [
 
 [[package]]
 name = "right-openshell"
-version = "0.4.2"
+version = "0.5.0"
 dependencies = [
  "chrono",
  "dirs",
@@ -3934,11 +3934,11 @@ dependencies = [
 
 [[package]]
 name = "right-platform-knobs"
-version = "0.4.2"
+version = "0.5.0"
 
 [[package]]
 name = "right-platform-store"
-version = "0.4.2"
+version = "0.5.0"
 dependencies = [
  "futures",
  "miette",
@@ -3951,7 +3951,7 @@ dependencies = [
 
 [[package]]
 name = "right-process"
-version = "0.4.2"
+version = "0.5.0"
 dependencies = [
  "nix",
  "tempfile",
@@ -3961,14 +3961,14 @@ dependencies = [
 
 [[package]]
 name = "right-prompt-safety"
-version = "0.4.2"
+version = "0.5.0"
 dependencies = [
  "ironclaw_safety",
 ]
 
 [[package]]
 name = "right-runtime-state"
-version = "0.4.2"
+version = "0.5.0"
 dependencies = [
  "base64",
  "miette",
@@ -3980,7 +3980,7 @@ dependencies = [
 
 [[package]]
 name = "right-stt"
-version = "0.4.2"
+version = "0.5.0"
 dependencies = [
  "futures",
  "reqwest",
@@ -3994,7 +3994,7 @@ dependencies = [
 
 [[package]]
 name = "right-ui"
-version = "0.4.2"
+version = "0.5.0"
 dependencies = [
  "inquire",
  "miette",
diff --git a/Cargo.toml b/Cargo.toml
index c92b3a62..9e7be08c 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -24,7 +24,7 @@ members = [
 resolver = "3"
 
 [workspace.package]
-version = "0.4.2"
+version = "0.5.0"
 edition = "2024"
 license = "Apache-2.0"