chore: expand 2.0.3 release notes

Author: dux-web

CHANGELOG.md

@@ -12,20 +12,32 @@ All notable changes to this project will be documented in this file.
 
 ### Added
 
-- Added agent worktree orchestration with `codux-worktree` so AI tools can create isolated child worktrees, stream the child terminal, review, merge, and remove the task worktree from one workflow.
-- Added Oh My Pi runtime support, including wrappers, managed config, runtime probing, session restore, and AI usage/history parsing.
-- Added project-level custom environment variables in the project create/edit dialog. New local, WSL, remote, and AI CLI terminals inherit these variables when opened.
+- Added agent worktree orchestration with `codux-worktree`, allowing AI tools to create isolated child worktrees, run the child terminal, review changes, merge results, and remove the task worktree in one workflow.
+- Added worktree task persistence and hosted-runtime routing for desktop, WSL, remote hosts, and headless Agents so child-task terminals remain inspectable while the parent task waits.
+- Added Oh My Pi runtime support, including shell wrappers, managed config, runtime probing, session restore, and AI usage/history parsing.
+- Added Kimi Code 0.27 compatibility for runtime detection, wrapper launch, session paths, and token usage parsing.
+- Added project-level custom environment variables in the project create/edit dialog. New local, WSL, remote, and AI CLI terminals inherit these variables.
+- Added protection for Codux runtime protocol variables so project environment variables cannot override reserved `CODUX_*` and `DMUX_*` values.
+
+### Changed
+
+- Reworked the AI history and token accounting pipeline to use normalized session sources, external session paths, cache buckets, hosted runtime metadata, and restored sessions consistently.
+- Aligned mobile terminal restoration with the shared desktop/headless Agent baseline and output-watermark protocol.
+- Updated Homebrew cask publishing to use stable public DMG asset names for download URLs and SHA256 generation.
+- Prepared the mobile 2.0.3 release notes for the terminal restoration fixes included with this desktop release.
 
 ### Fixed
 
-- Fixed Kimi Code 0.27 runtime detection, wrapper launch, and usage-history parsing.
-- Fixed AI history and token accounting across external session paths, restored sessions, Codex/Claude/Kimi/Oh My Pi records, cache buckets, and hosted runtimes.
+- Fixed duplicated or stale mobile terminal output after switching projects, worktrees, and running terminals, including blank regions, stale fragments, and sequence-gapped output.
+- Fixed cached terminal switching so existing mobile sessions do not replay their full baseline unless an authoritative baseline is required.
+- Fixed remote and mobile viewport ownership recovery after project/worktree changes, host reconnects, and running-terminal switches.
+- Fixed agent worktree child-task permissions so nested AI tasks can run with the expected launch mode without repeated manual approval.
+- Fixed agent worktree semantic idempotency so retrying the same branch/task reuses the existing operation instead of creating duplicate worktrees or unusable operation IDs.
+- Fixed agent worktree merge/remove cleanup, terminal persistence, and command routing for local, remote, WSL, and headless Agent targets.
+- Fixed AI usage totals across Codex, Claude Code, Kimi, Oh My Pi, cached input buckets, hosted runtimes, and restored external sessions.
 - Fixed automatic memory extraction churn when no eligible provider is configured, preserving queued work until a provider becomes available.
-- Fixed agent worktree terminal persistence, viewport handoff, child-task permissions, semantic idempotency, merge/remove cleanup, and remote/WSL runtime command routing.
-- Fixed mobile and remote terminal synchronization after switching projects, worktrees, and running terminals, including stale baseline output and viewport ownership recovery.
-- Fixed redundant terminal workspace redraws that could push the UI into high CPU and frozen-looking frames during long-running terminal activity.
-- Fixed Homebrew cask download URLs and SHA256 generation to use the stable public DMG asset names.
-- Prevented project environment variables from overriding Codux runtime protocol variables reserved under `CODUX_*` and `DMUX_*`.
+- Fixed terminal workspace redundant redraws that could push CPU high and make the GUI appear frozen during long-running terminal activity.
+- Fixed Homebrew release metadata generated from versioned/debug assets instead of the stable public DMG files.
 
 ## [2.0.2] - 2026-07-16
 

CHANGELOG.zh-CN.md

@@ -12,20 +12,32 @@
 
 ### 新增
 
-- 新增 Agent worktree 编排能力，AI 工具可通过 `codux-worktree` 创建隔离子 worktree、接管子终端、评审、合并并移除任务 worktree，形成完整闭环。
-- 新增 Oh My Pi runtime 支持，包括 wrapper、托管配置、runtime 探测、会话恢复，以及 AI 用量/历史解析。
+- 新增 Agent worktree 编排能力，AI 工具可通过 `codux-worktree` 创建隔离子 worktree、运行子终端、评审变更、合并结果并移除任务 worktree，形成完整闭环。
+- 新增 worktree 任务持久化与 hosted runtime 路由，桌面端、WSL、远程主机和 headless Agent 的子任务终端都可以在父任务等待时继续查看。
+- 新增 Oh My Pi runtime 支持，包括 shell wrapper、托管配置、runtime 探测、会话恢复，以及 AI 用量/历史解析。
+- 新增 Kimi Code 0.27 兼容，包括 runtime 探测、wrapper 启动、会话路径和 Token 用量解析。
 - 项目创建/编辑窗口新增项目级自定义环境变量，新开的本地、WSL、远程与 AI CLI 终端会继承这些变量。
+- 新增 Codux runtime 协议变量保护，项目环境变量不能覆盖 `CODUX_*` 和 `DMUX_*` 保留值。
+
+### 调整
+
+- 重构 AI 历史与 Token 统计链路，统一处理标准化会话来源、外部会话路径、缓存桶、hosted runtime 元数据和恢复会话。
+- 移动端终端恢复对齐桌面端与 headless Agent 使用的共享 baseline 和输出水位协议。
+- Homebrew cask 发布改为使用稳定公开的 DMG 文件名生成下载地址和 SHA256。
+- 补充移动端 2.0.3 更新说明，对齐本次桌面端发布中的终端恢复修复。
 
 ### 修复
 
-- 修复 Kimi Code 0.27 的 runtime 探测、wrapper 启动和用量历史解析。
-- 修复外部会话路径、恢复会话、Codex/Claude/Kimi/Oh My Pi 记录、缓存桶和托管 runtime 下的 AI 历史与 Token 统计。
+- 修复移动端切换项目、worktree 和运行中终端后出现历史重复、旧内容残留、空白区域和输出序列缺口的问题。
+- 修复移动端缓存终端切换时重复回放完整 baseline 的问题，只有无缓存或序列缺口时才请求权威 baseline。
+- 修复远程与移动端在项目/worktree 变化、主机重连、切换运行中终端后的 viewport ownership 恢复。
+- 修复 Agent worktree 子任务权限继承问题，嵌套 AI 任务可按预期启动，不再反复要求手动审批。
+- 修复 Agent worktree 语义幂等问题，同一分支/同一任务重试会复用已有 operation，不再创建重复 worktree 或返回不可交付的 operationId。
+- 修复 Agent worktree 合并/移除清理、终端持久化，以及本地、远程、WSL、headless Agent 目标下的命令路由。
+- 修复 Codex、Claude Code、Kimi、Oh My Pi、缓存输入桶、hosted runtime 和恢复的外部会话下的 AI 用量汇总。
 - 修复未配置可用记忆提取 Provider 时自动提取队列反复失败的问题，并保留待处理任务直到 Provider 可用。
-- 修复 Agent worktree 终端持久化、viewport 接管、子任务权限、语义幂等、合并/移除清理，以及远程/WSL runtime 命令路由。
-- 修复移动端与远程终端在切换项目、worktree 和运行中终端后的同步问题，包括过期 baseline 输出和 viewport owner 恢复。
-- 修复长时间终端活动中重复重绘导致 UI CPU 升高、界面看起来卡死的问题。
-- 修复 Homebrew cask 下载地址和 SHA256 生成逻辑，统一使用稳定的公开 DMG 文件名。
-- 阻止项目环境变量覆盖 `CODUX_*` 和 `DMUX_*` 这些 Codux 运行时协议保留变量。
+- 修复终端 workspace 重复重绘导致 CPU 升高、长任务运行时 GUI 看起来卡死的问题。
+- 修复 Homebrew 发布元数据误从带版本号或 debug 产物生成，而不是使用稳定公开 DMG 文件的问题。
 
 ## [2.0.2] - 2026-07-16
 

apps/mobile/CHANGELOG.md

@@ -9,11 +9,14 @@ Important changes to this project are documented here.
 ### Changed
 
 - Aligned mobile terminal restoration with the shared atomic baseline and output-watermark protocol used by desktop and headless Agent hosts.
+- Reused cached terminal sessions during project, worktree, and terminal switches instead of replaying a full baseline every time.
 
 ### Fixed
 
 - Fixed duplicated terminal history, stale fragments, blank regions, and inconsistent screen restores after scrolling, resizing, folding or unfolding a device, and rapidly switching projects, worktrees, or running terminals.
 - Fixed cached terminal switching so existing sessions are reused without unconditionally replaying their full baseline; uncached or sequence-gapped sessions still request an authoritative baseline.
+- Fixed viewport owner recovery after reconnecting to a desktop or Agent host and switching back into an already-running terminal.
+- Fixed mobile compatibility with the desktop 2.0.3 terminal synchronization and hosted worktree routing changes.
 
 ## [2.0.0] - 2026-07-13
 

apps/mobile/CHANGELOG.zh-CN.md

@@ -9,11 +9,14 @@
 ### 调整
 
 - 移动端终端恢复对齐桌面端与 headless Agent Host 使用的共享原子 baseline 和输出水位协议。
+- 切换项目、worktree 和终端时优先复用已有缓存终端会话，不再每次都重复回放完整 baseline。
 
 ### 修复
 
 - 修复滚动、调整尺寸、折叠屏开合，以及快速切换项目、worktree 或运行中终端后出现历史重复、顶部残片、空白区域和屏幕恢复不一致的问题。
 - 修复终端缓存切换，已有会话不再无条件重复回放完整 baseline；无缓存或存在输出序列缺口的会话仍会请求权威 baseline。
+- 修复重连桌面端或 Agent Host 后，切回已有运行中终端时的 viewport owner 恢复问题。
+- 修复移动端与桌面端 2.0.3 终端同步和 hosted worktree 路由改动的兼容性。
 
 ## [2.0.0] - 2026-07-13