Merge pull request #60 from spencerkit/develop

Merging develop into main after green CI.

Author: pallyoung

.changeset/pretty-tigers-float.md

@@ -0,0 +1,5 @@
+---
+"@spencer-kit/coder-studio": patch
+---
+
+Polish workspace background material rendering so personalized glass and background image settings apply more consistently across the main workspace surfaces.

docs/promotion/releases/README.md

@@ -18,6 +18,10 @@ Add a release narrative when a version is published to GitHub and npm, especiall
 
 ## Current releases
 
+- [v0.4.4](v0.4.4.md)
+- [v0.4.3](v0.4.3.md)
+- [v0.4.2](v0.4.2.md)
+- [v0.4.1](v0.4.1.md)
 - [v0.4.0](v0.4.0.md)
 - [v0.3.6](v0.3.6.md)
 - [v0.3.5](v0.3.5.md)

docs/promotion/releases/v0.4.1.md

@@ -0,0 +1,85 @@
+# Coder Studio v0.4.1
+
+## 中文
+
+### 这个版本为什么重要
+
+`v0.4.1` 从 package changelog 看起来像一次 CI 修补版，但实际发布出去的产品变化更宽。这个版本继续推进统一编辑器工作流，把应用内更新发现入口放进工作区底栏，并补了一轮 session 可视化、设置页和移动端细节打磨，最后再把 Windows 打包和 CI 构建问题收口。
+
+实际体验上，这个版本意味着：
+
+- 文件预览、编辑和 diff 切换更一致，编辑器工具栏行为更连贯
+- 工作区底栏可以发现新版本，并在支持的安装形态下进入应用内更新流程
+- workspace 标签更容易辨认真实 session 状态，回到旧工作区时上下文识别更直观
+- 设置页、移动端底栏、弹层层级和 LSP 路径处理都更稳，同时修复了 Windows 发布构建链路
+
+### 这个版本包含哪些变化
+
+- 统一 editor mode state，并继续收拢 preview、edit、diff 三种编辑器模式的切换行为
+- 修正代码编辑器预览工具栏交互，减少模式切换时的割裂感
+- 新增应用内更新流程、底栏 update rail，以及相关状态目录迁移基础
+- 在 workspace 标签里显示更真实的 session mini-map 和布局背景提示
+- 打磨 Settings About 控件、设置导航对齐、移动端工作区底栏，以及 sheet 和共享 modal 的层级关系
+- 修复通过 workspace symlink 打开的文档在 LSP 路径解析上的问题
+- 改进 GitHub Wiki 发布脚本与维护者发布流程
+- 修复 CI 流水线和 standalone server build 校验，恢复 Windows 包构建稳定性
+
+### 谁最受益
+
+- 频繁在预览、编辑和 diff 之间切换的开发者
+- 希望在产品内部看到新版本并触发更新流程的自托管用户
+- 同时管理多个 workspace，或隔一段时间再返回旧 session 的用户
+- 依赖 Windows 打包链路和项目发布流程稳定性的贡献者
+
+### 安装或升级
+
+```bash
+npm install -g @spencer-kit/coder-studio
+coder-studio open
+```
+
+### 完整变更
+
+- [Compare `v0.4.0...v0.4.1`](https://github.com/spencerkit/coder-studio/compare/v0.4.0...v0.4.1)
+
+## English
+
+### Why this release matters
+
+`v0.4.1` looks like a CI repair patch from the package changelog, but the shipped product changes are broader. This release keeps pushing the unified editor workflow forward, moves update discovery into the workspace footer rail, and adds another round of polish to session visibility, settings surfaces, and mobile behavior before closing out the Windows packaging and CI build issues.
+
+In practice, this release means:
+
+- preview, edit, and diff transitions feel more consistent inside the editor surface
+- the workspace footer can surface new releases and start an in-app update flow where the install shape supports it
+- workspace tabs make live session state easier to recognize when returning to an older workspace
+- settings, mobile footer layout, overlay layering, and LSP path handling are steadier, while the Windows release build path is repaired
+
+### Included in v0.4.1
+
+- unify editor mode state and continue aligning preview, edit, and diff behavior inside the editor surface
+- fix code editor preview toolbar behavior so mode transitions feel less fragmented
+- add the in-app update flow, the footer update rail, and related state-directory migration groundwork
+- show real session presence more clearly in workspace tabs with a session mini-map and layout background treatment
+- polish Settings About controls, settings navigation alignment, the mobile workspace footer, and sheet-versus-modal layering
+- resolve LSP document paths through workspace symlinks
+- improve the GitHub wiki publish workflow for maintainers
+- repair the CI pipeline and standalone server build verification so Windows package publishing works again
+
+### Who benefits most
+
+- developers moving frequently between preview, edit, and diff workflows
+- self-hosters who want in-product visibility into new releases and supported update paths
+- users juggling multiple workspaces or returning to an older session later
+- contributors who depend on stable Windows packaging and cleaner project publishing flows
+
+### Install or upgrade
+
+```bash
+npm install -g @spencer-kit/coder-studio
+coder-studio open
+```
+
+### Full changelog
+
+- [Compare `v0.4.0...v0.4.1`](https://github.com/spencerkit/coder-studio/compare/v0.4.0...v0.4.1)

docs/promotion/releases/v0.4.2.md

@@ -0,0 +1,85 @@
+# Coder Studio v0.4.2
+
+## 中文
+
+### 这个版本为什么重要
+
+`v0.4.2` 把 Markdown 和 HTML 预览真正带进了产品，而不是停留在设计稿里。它同时继续统一终端恢复链路，并补了一轮诊断、刷新恢复、移动端模式切换和 Windows 路径安全修正，让“读文档、看页面、断线恢复、刷新继续”这些高频动作更连贯。
+
+实际体验上，这个版本意味着：
+
+- workspace 里可以直接预览 Markdown 文档和静态 HTML 文件，不必总是切回本地工具
+- 终端恢复协议和 websocket 恢复流程更统一，刷新或重连后的恢复语义更清晰
+- 运行时诊断、supervisor 刷新恢复、关闭 session 后的提示态和移动端文件细节切换都更稳
+- Windows 路径安全和 server CI 构建检查进一步收紧，减少跨平台发布意外
+
+### 这个版本包含哪些变化
+
+- 新增 preview session store、resource loader、HTML preview routes 和 Markdown 渲染链路
+- 在 web 端加入 preview API、文件类型识别，以及 Markdown / HTML 预览界面
+- 收紧 preview asset 路径解析，并补齐 preview 相关 runtime 依赖声明
+- 为终端恢复补上共享协议类型，并统一 websocket recovery flow
+- 细化 diagnostics runtime checks，提升对本地运行时环境的识别质量
+- 修复 supervisor 刷新后的状态 hydration、关闭 session 后的 recovery overlay，以及窄容器下状态 chips 抖动问题
+- 统一移动端文件 detail 和 mode switching 行为，并恢复 standalone UI preview 入口
+- 加固 Windows 路径安全检查，并恢复 server CI build
+
+### 谁最受益
+
+- 希望直接在 workspace 中阅读 Markdown 文档或预览静态 HTML 的用户
+- 依赖浏览器终端持续工作的开发者
+- 经常刷新页面、重连 session 或在移动端查看文件的用户
+- 需要更稳定 Windows 路径处理和 CI 构建链路的维护者
+
+### 安装或升级
+
+```bash
+npm install -g @spencer-kit/coder-studio
+coder-studio open
+```
+
+### 完整变更
+
+- [Compare `v0.4.1...v0.4.2`](https://github.com/spencerkit/coder-studio/compare/v0.4.1...v0.4.2)
+
+## English
+
+### Why this release matters
+
+`v0.4.2` turns Markdown and HTML preview into a shipped product capability instead of a design-only idea. It also keeps tightening terminal recovery, diagnostics, refresh restore, mobile mode switching, and Windows path safety so the common flow of reading docs, previewing pages, reconnecting, and resuming work feels more coherent.
+
+In practice, this release means:
+
+- you can preview Markdown documents and static HTML files directly inside the workspace
+- terminal recovery protocol and websocket recovery behavior are more unified, making refresh and reconnect semantics easier to trust
+- runtime diagnostics, supervisor refresh restore, closed-session recovery states, and mobile file detail switching are more dependable
+- Windows path safety and server CI build checks are stricter, reducing cross-platform release surprises
+
+### Included in v0.4.2
+
+- add the preview session store, resource loader, HTML preview routes, and Markdown rendering pipeline on the server
+- add the preview API, file classification, and Markdown / HTML preview surfaces on the web side
+- tighten preview asset path resolution and declare the required preview runtime dependencies
+- add shared terminal recovery protocol types and unify the websocket recovery flow
+- refine runtime diagnostics checks for clearer local environment detection
+- fix supervisor state hydration after refresh, improve the closed-session recovery overlay, and stabilize status chips in narrow containers
+- unify mobile file detail and mode switching behavior, and restore the standalone UI preview entry
+- harden Windows path safety checks and restore the server CI build
+
+### Who benefits most
+
+- users who want to read Markdown docs or preview static HTML directly inside the workspace
+- developers relying on long-lived browser terminal sessions
+- users who refresh, reconnect, or inspect files from mobile frequently
+- maintainers who need steadier Windows path handling and CI builds
+
+### Install or upgrade
+
+```bash
+npm install -g @spencer-kit/coder-studio
+coder-studio open
+```
+
+### Full changelog
+
+- [Compare `v0.4.1...v0.4.2`](https://github.com/spencerkit/coder-studio/compare/v0.4.1...v0.4.2)

docs/promotion/releases/v0.4.3.md

@@ -0,0 +1,73 @@
+# Coder Studio v0.4.3
+
+## 中文
+
+### 这个版本为什么重要
+
+`v0.4.3` 是一次非常聚焦的可靠性补丁，目标只有一个：让终端恢复在边界情况下也不要把输出弄丢。它修复了 noop / closed reconcile 时 live chunk 被卡住的问题，也修掉了 snapshot hydration 后补刷 live chunk 时意外清空终端内容的回放错误，并顺手加固了更新后的重启交接。
+
+实际体验上，这个版本意味着：
+
+- 短暂断线或恢复后，终端输出更不容易卡住或消失
+- 快照恢复后的后续 live 输出不会再把已有终端内容清空
+- 通过应用内更新触发重启时，交接行为更稳
+
+### 这个版本包含哪些变化
+
+- 完成 terminal recovery replay 对 noop 和 closed reconcile 决策的覆盖
+- 修复 snapshot hydration 之后队列中的 live chunks 回放时重置 xterm 的问题
+- 修复 auto-update restart handoff
+- 补上针对 noop recovery 与 snapshot-plus-pending-chunks 场景的回归覆盖
+
+### 谁最受益
+
+- 运行长时间 AI 编码任务的用户
+- 经常遇到短暂网络抖动、刷新或恢复场景的开发者
+- 使用应用内更新流程并希望重启切换更平滑的自托管用户
+
+### 安装或升级
+
+```bash
+npm install -g @spencer-kit/coder-studio
+coder-studio open
+```
+
+### 完整变更
+
+- [Compare `v0.4.2...v0.4.3`](https://github.com/spencerkit/coder-studio/compare/v0.4.2...v0.4.3)
+
+## English
+
+### Why this release matters
+
+`v0.4.3` is a tightly focused reliability patch with one clear goal: terminal recovery should not lose output in edge cases. It fixes the case where live chunks could get stranded after noop or closed reconcile decisions, prevents snapshot-following live replay from wiping the terminal body, and hardens the restart handoff used by the update flow.
+
+In practice, this release means:
+
+- terminal output is less likely to stall or disappear after a short disconnect or recovery cycle
+- live output flushed after snapshot hydration no longer clears the terminal body
+- restart handoff is steadier when an in-app update triggers a restart
+
+### Included in v0.4.3
+
+- complete terminal recovery replay handling for noop and closed reconcile decisions
+- fix the xterm reset path for queued live chunks flushed after snapshot hydration
+- repair the auto-update restart handoff
+- add regression coverage for noop recovery and snapshot-plus-pending-chunks recovery paths
+
+### Who benefits most
+
+- users running long AI-assisted coding tasks
+- developers frequently hitting reconnect, refresh, or recovery scenarios
+- self-hosters using the in-app update flow and expecting smoother restart transitions
+
+### Install or upgrade
+
+```bash
+npm install -g @spencer-kit/coder-studio
+coder-studio open
+```
+
+### Full changelog
+
+- [Compare `v0.4.2...v0.4.3`](https://github.com/spencerkit/coder-studio/compare/v0.4.2...v0.4.3)

docs/promotion/releases/v0.4.4.md

@@ -0,0 +1,89 @@
+# Coder Studio v0.4.4
+
+## 中文
+
+### 这个版本为什么重要
+
+`v0.4.4` 是一轮围绕 workspace 导航和 open editors 管理的集中整理。它把 desktop workbench sidebar、sidebar search、quick open 和新的移动端搜索/资源管理器面板拼成了一套更统一的导航模型，同时把 Open Editors 真正做成一个可依赖的控制面，让桌面端和移动端在“找文件、切文件、关文件、回到原工作区”这些高频动作上更接近同一个产品。
+
+实际体验上，这个版本意味着：
+
+- 桌面端和移动端都拥有更清晰的 workspace 导航，包含 sidebar search、quick open、mobile search panel 和 explorer sections
+- workspace tab 实例隔离更明确，路由切换后保留当前 active workspace 的能力更稳
+- Open Editors 在桌面端和移动端的排序、路径展示、关闭动作和重开行为更一致，也更不容易被异步加载竞态打乱
+- terminal recovery overlay 的出现时机和状态表达更克制，supervisor 的提示词也更强调计划和交付质量
+
+### 这个版本包含哪些变化
+
+- 新增 desktop workbench sidebar shell、sidebar search、quick open，以及可折叠的搜索结果分组
+- 打磨 quick open 行、workspace search chrome 和 quick jump 搜索可达性
+- 新增 mobile explorer sections、mobile search panel variant，并让移动端三视图结构向桌面端对齐
+- 隔离 workspace tab instances，并修复 route change 后 active workspace 恢复问题
+- 为 Open Editors 新增共享 close decisions 与 close actions，并统一桌面端和移动端控制行为
+- 收紧 Open Editors 的 deterministic ordering、路径截断和相关回归覆盖
+- 修复没有 open buffer 时的关闭回退、晚到的 closed editor load，以及 pending-load reopen races
+- 延后 terminal recovery overlay 的显示时机，并细化 recovery UX states
+- 将 settings activation errors 收口到 session gate，并修复 update restart handoff 的 process tree 问题
+- 将 supervisor prompt 提升为 planner-supervisor 导向，强化 execution planning 和 delivery quality bar
+
+### 谁最受益
+
+- 大量依赖 sidebar、quick open 和搜索在工作区里高频穿梭的用户
+- 在桌面端和移动端之间来回切换的开发者
+- 经常同时打开多个文件、频繁关闭和重开的用户
+- 依赖更稳定恢复体验和更明确 supervisor 执行导向的重度使用者
+
+### 安装或升级
+
+```bash
+npm install -g @spencer-kit/coder-studio
+coder-studio open
+```
+
+### 完整变更
+
+- [Compare `v0.4.3...v0.4.4`](https://github.com/spencerkit/coder-studio/compare/v0.4.3...v0.4.4)
+
+## English
+
+### Why this release matters
+
+`v0.4.4` is a concentrated workspace navigation and open-editors release. It combines the desktop workbench sidebar, sidebar search, quick open, and new mobile search / explorer panels into a more unified navigation model, while turning Open Editors into a control surface you can rely on across desktop and mobile. The result is a steadier experience around finding files, switching files, closing files, and returning to the right workspace.
+
+In practice, this release means:
+
+- both desktop and mobile get clearer workspace navigation with sidebar search, quick open, a mobile search panel, and explorer sections
+- workspace tab instances are isolated more cleanly, and the active workspace survives route changes more reliably
+- Open Editors behaves more consistently across desktop and mobile for ordering, path display, close actions, and reopen behavior, with better protection against async race conditions
+- terminal recovery overlay timing and recovery states feel calmer, while supervisor guidance pushes harder on planning and delivery quality
+
+### Included in v0.4.4
+
+- add the desktop workbench sidebar shell, sidebar search, quick open, and collapsible search result groups
+- refine quick open rows, workspace search chrome, and quick jump accessibility
+- add mobile explorer sections and a mobile search panel variant, and align the mobile three-view structure more closely with desktop
+- isolate workspace tab instances and preserve the active workspace across route changes
+- add shared open-editor close decisions and close actions, then unify the controls across desktop and mobile
+- tighten deterministic open-editor ordering, path truncation, and regression coverage
+- fix close fallback without an open buffer, ignore late closed-editor loads, and repair pending-load reopen races
+- delay terminal recovery overlay presentation and refine recovery UX states
+- route settings activation errors through the session gate and fix the update restart-handoff process tree
+- rework the supervisor prompt toward a planner-supervisor model with a stronger execution and delivery quality bar
+
+### Who benefits most
+
+- users who move through the workspace heavily with sidebar navigation, quick open, and search
+- developers switching between desktop and mobile browser sessions
+- users who keep many files open and frequently close and reopen editors
+- heavy users who depend on steadier recovery behavior and clearer supervisor execution guidance
+
+### Install or upgrade
+
+```bash
+npm install -g @spencer-kit/coder-studio
+coder-studio open
+```
+
+### Full changelog
+
+- [Compare `v0.4.3...v0.4.4`](https://github.com/spencerkit/coder-studio/compare/v0.4.3...v0.4.4)