Skip to content

A local-first multi-agent app development platform, built on PenguinHarness

release: 0.2.8 (#522)

Yaowei Zheng07984cdfe51a
diff --git a/CHANGELOG.md b/CHANGELOG.md
index ef6ab454..fabd9243 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,7 @@
One brief line per release. Per-release detail lives in [`changelog/<version>/`](changelog/).
+- **0.2.8** — 2026-08-27. The release where a bound chat channel stops being a text pipe. Pictures and documents travel both ways on Feishu and Telegram — inbound as the input the web composer submits, outbound as the files a finished run both mentioned and produced, which is the pair of filters that picks the one output that was the point while keeping a steerable reply from becoming a read primitive. Replies arrive as formatting rather than literal `**bold**`: a per-binding `renderMarkdown`, on by default, renders each reply in the channel's own markup — Telegram HTML, a Feishu card's JSON 2.0 rich-text component, QQ `msg_type: 2` — transforming what a channel cannot draw instead of leaking it, chunking without splitting an entity or a code fence, and retrying as plain text when a platform refuses the formatting, so a reply is never lost to it. Two more per-binding switches decide how a run reaches the chat: one message per non-blank line, and hold the working notes to deliver only the run's last reply. QQ joins as a third channel, bound by scanning a QR code, over a passive-reply budget the connector rations because the platform will not let a bot speak first. Alongside the messaging work: an extension seam (`activate(ctx)` plus two typed events, re-delivered on every App creation), `penguin auth` for terminal sign-in with the fixed seed password retired in favour of a printed first-login link, red-dot to-dos for Skill and preset-model updates and unexpected errors that can each be put down, LaTeX on every Markdown surface, a bot account that is no longer owned by one Session forever, a binding panel that separates the three different causes of "nothing happened", Qwen 3.8 Flash in the TokenDance group, and CI fanned out into parallel shards. ([details](changelog/0.2.8/))
- **0.2.7** — 2026-08-27. A fix release for what 0.2.6 shipped. The messaging bindings it introduced now work from the desktop app — whose bundles declared `require` but not `__filename` or `__dirname`, so the Feishu SDK's read of its own `package.json` failed every connect with `__dirname is not defined` — survive a Telegram poller conflict, whose recovery was gated on a `getMe` that never conflicts and so re-polled once a second forever instead of backing off, and run a redelivered message once, keyed on the channel's own message id rather than on the text. The desktop app also puts its bundled `penguin` command on PATH by itself and repairs it at every launch, never touching a `penguin` it did not write and never installing from a location that will not persist. A command whose Workspace has been deleted now names the directory instead of reporting `spawn bash ENOENT`, and the POSIX shell resolver gained the fallback chain the Windows branch already had, so a machine without bash no longer fails every command before it runs. Plus a queued follow-up that is recallable however it was queued, landing and README copy corrected where it had stopped being true with the Skill lists now pinned by tests, CI verification of the packed CLI, and tests pinning both `web.db` upgrade directions. ([details](changelog/0.2.7/))
- **0.2.6** — 2026-08-27. Two Flash models (`glm-5.3-flash`, listed once per route that sells it, and `qwen3.8-flash`) beside a new TokenDance gateway group whose **Authorize key** action mints a key onto your account without a trip to a console, plus app attribution for OpenRouter and TokenDance; subagents you talk to instead of watch — mid-run steering from the model and from the panel's own composer, a per-run `abort` replacing `kill_subagent`, and child approvals that escalate to you; the `penguin` CLI rebuilt as an HTTP/SSE client of the running server with a read-and-move command family, control-env injection into every Agent command and the `penguin-orchestration` Skill over it; a Session bindable to a self-built Feishu app or a Telegram bot with no public URL on either side; a clickable context ring that breaks the context into six parts; update badges that lead from the outermost menu to the control performing the update; draggable sidebar and provider groups with per-group sidebar paging; the standalone Trace page removed in favour of the conversation's Trace panel, with import moved into System settings; Agents created from library or project-directory Skills or straight from a snapshot package; a kernel update whose unit is a settings tab; and atomic replacement for every Harness state file; plus the Windows signing identity corrected to `NaisNet Technology Co., Ltd.` and recorded as a list that keeps the previous identity beside it, which an installed 0.2.4 Windows desktop client still has to be reinstalled to follow. 0.2.5 was tagged for this same set: it published the npm packages and then failed on the Windows desktop job, before any GitHub Release or installer existed — so 0.2.5 is on npm only, and has no folder here. ([details](changelog/0.2.6/))
- **0.2.4** — 2026-08-21. A DeepSeek vision model (`deepseek-v4-flash-vision-exp`, and DeepSeek moved onto the Responses protocol) with a direct `claude-opus-5` preset and an add-group dialog that imports an endpoint's whole model listing, the chat page rebuilt around two tabbed docks holding every side panel and any number of server-side terminals whose screens survive a reload, background execution with harness-injected completion reports, kill tools and service links on the process list, a Project-level sandbox command policy that denies destructive shell commands under every approval mode, usage charts rebuilt as time series with range and precision controls, Memory groups that export and import whole plus in-chat memory-change lists and a prompt that names when to save, one System settings dialog with explanations behind a circled "?", draft-screen examples that fill the composer beside a folder of the user's own saved prompts, per-server MCP permission, and desktop installers built from bundles that import the login shell's environment on GUI launches. ([details](changelog/0.2.4/))
diff --git a/CHANGELOG.zh.md b/CHANGELOG.zh.md
index bcadd936..e1186a4a 100644
--- a/CHANGELOG.zh.md
+++ b/CHANGELOG.zh.md
@@ -4,6 +4,7 @@
每个版本一行简述。逐版本的细节见 [`changelog/<version>/`](changelog/)。
+- **0.2.8** — 2026-08-27。这一版让绑定的聊天渠道不再只是一根文本管道。图片与文件在飞书、Telegram 上双向流动——进来时就是网页端输入框提交的那种输入,出去的是一次运行「既提到又产出」的文件,这一对判据既挑出了那个真正是重点的产物,也让可被引导的回复不至于变成读取原语。回复以排版而非字面 `**bold**` 抵达:新增按绑定保存的 `renderMarkdown`(默认开启),用各渠道自己的标记渲染——Telegram 用 HTML,飞书用卡片的 JSON 2.0 富文本组件,QQ 用 `msg_type: 2`;渠道画不出来的构造会被转换而不是漏成原文,分段不会切断实体或代码围栏,平台拒绝排版时自动退回纯文本重发,因此回复绝不会因排版而丢失。另有两个按绑定保存的开关决定一次运行如何抵达聊天:每个非空行各发一条,以及压住过程记录、只发这次运行的最后一条回复。QQ 作为第三个渠道加入,扫码即可绑定;由于该平台不允许机器人主动发言,连接器按被动回复额度进行配给。消息之外:扩展机制(一个 `activate(ctx)` 加两个带类型的事件,每次 App 创建都会重新投递)、`penguin auth` 终端登录并以首次登录链接取代固定初始密码、技能与预置模型更新及未预期错误的红点待办且都能解除、所有 Markdown 界面渲染 LaTeX、机器人账号不再被某个 Session 永久占有、绑定面板把「什么都没发生」的三种不同成因分开、TokenDance 分组新增 Qwen 3.8 Flash,以及 CI 改为并行分片。([细则](changelog/0.2.8/))
- **0.2.7** — 2026-08-27。针对 0.2.6 所发内容的修复版本。0.2.6 引入的消息绑定现在可以在桌面端使用——桌面端的产物此前只声明了 `require`,没有声明 `__filename` 与 `__dirname`,飞书 SDK 读取自身 `package.json` 时因此以 `__dirname is not defined` 让每次连接失败;Telegram 也能从轮询冲突中恢复,此前恢复判定挂在从不冲突的 `getMe` 上,于是每秒重试一次、永远走不到退避;被渠道重复投递的消息也只会执行一次,判重依据是渠道自己的消息 id,而不是文本。桌面端还会自行把随包的 `penguin` 命令放上 PATH,并在每次启动时修复它——绝不改动不是自己写的 `penguin`,也绝不从留不住的位置安装。Workspace 已被删除时,命令会指名那个目录,而不再报 `spawn bash ENOENT`;POSIX 的 shell 解析补上了 Windows 分支早就有的回退链,没有 bash 的机器不会再让每条命令在执行前就失败。此外:排队中的跟进消息无论经哪条路径入队都可撤回;落地页与 README 中已不成立的文案得到更正,技能清单改由测试钉住;随包 CLI 纳入 CI 校验;`web.db` 的两个升级方向都有测试钉住。([细则](changelog/0.2.7/))
- **0.2.6** — 2026-08-27。两个 Flash 模型(`glm-5.3-flash` 按售卖它的每条线路各列一行,以及 `qwen3.8-flash`),旁边是新的 TokenDance 网关分组——它的「授权密钥」会直接在你的账号上签发一把密钥,不必再去控制台复制;同时为 OpenRouter 与 TokenDance 加上应用归属标识。子 Agent 从「看着」变成「对话」:模型与面板自带的输入框都能在运行中改向,逐轮的 `abort` 取代了 `kill_subagent`,子会话的审批会上浮给用户。`penguin` CLI 重建为运行中服务端的 HTTP/SSE 客户端,配一套读取与调度整台安装的命令族、注入到每条 Agent 命令的控制环境变量,以及架在其上的 `penguin-orchestration` 技能。Session 可绑定自建的飞书应用或 Telegram 机器人,两侧都不需要公网 URL。上下文圆环可点开,把当前上下文拆成六个部分。更新红点从最外层菜单一路指到执行更新的那个控件。侧边栏分组与模型分组都可拖动排序,侧边栏各分组独立翻页。独立的 Trace 页移除,改由对话的 Trace 面板阅读,导入迁至系统设置。新建 Agent 可选装技能库或项目目录中的技能,也可直接从快照包初始化。内核更新的单位改为设置页签。以及所有 Harness 状态文件均改为原子替换。另将 Windows 签名主体更正为 `NaisNet Technology Co., Ltd.`,并改为同时保留上一个主体的名单;已安装的 0.2.4 Windows 桌面端仍需手动重装才能跟上。0.2.5 曾为同一批改动打过标签:它发布了 npm 包,随后在 Windows 桌面任务上失败,未产出任何 GitHub Release 或安装包——因此 0.2.5 只存在于 npm,本目录中没有它。([细则](changelog/0.2.6/))
- **0.2.4** — 2026-08-21。会读图的 DeepSeek 模型(`deepseek-v4-flash-vision-exp`,同时 DeepSeek 客户端换用 Responses 协议),补上直连的 `claude-opus-5` 预设,新建分组时可一次导入端点提供的全部模型;聊天页重构为右侧与底部两个标签式 Dock,所有侧边面板与任意数量的服务端终端都是其中的标签页,终端画面在刷新后原样恢复;后台执行带回由 harness 注入的完成报告,配 kill 工具与进程列表上的服务链接;Project 级的沙箱命令策略在所有审批模式下都拒绝破坏性 shell 命令;用量图表重做为带时间范围与精度控件的时间序列;Memory 支持按作用域整组导出导入,并在对话中列出本次改动的记忆、提示词也写明了何时该记;系统设置合并为一个对话框,解释收进标题旁的圆圈问号;草稿页的示例改为填入输入框,旁边多了用户自己保存的提示词文件夹;MCP Server 支持逐服务器的权限档位;桌面安装包改由 bundle 打包,并在图形界面启动时导入登录 shell 的环境变量。([细则](changelog/0.2.4/))
diff --git a/changelog/unreleased/2026-08-22-extension-mechanism.md b/changelog/0.2.8/2026-08-22-extension-mechanism.md
similarity index 100%
rename from changelog/unreleased/2026-08-22-extension-mechanism.md
rename to changelog/0.2.8/2026-08-22-extension-mechanism.md
diff --git a/changelog/unreleased/2026-08-22-extension-mechanism.zh.md b/changelog/0.2.8/2026-08-22-extension-mechanism.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-22-extension-mechanism.zh.md
rename to changelog/0.2.8/2026-08-22-extension-mechanism.zh.md
diff --git a/changelog/unreleased/2026-08-23-double-fault-upgrade-channel-is-covered.md b/changelog/0.2.8/2026-08-23-double-fault-upgrade-channel-is-covered.md
similarity index 100%
rename from changelog/unreleased/2026-08-23-double-fault-upgrade-channel-is-covered.md
rename to changelog/0.2.8/2026-08-23-double-fault-upgrade-channel-is-covered.md
diff --git a/changelog/unreleased/2026-08-23-double-fault-upgrade-channel-is-covered.zh.md b/changelog/0.2.8/2026-08-23-double-fault-upgrade-channel-is-covered.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-23-double-fault-upgrade-channel-is-covered.zh.md
rename to changelog/0.2.8/2026-08-23-double-fault-upgrade-channel-is-covered.zh.md
diff --git a/changelog/unreleased/2026-08-24-chat-empty-state.md b/changelog/0.2.8/2026-08-24-chat-empty-state.md
similarity index 100%
rename from changelog/unreleased/2026-08-24-chat-empty-state.md
rename to changelog/0.2.8/2026-08-24-chat-empty-state.md
diff --git a/changelog/unreleased/2026-08-24-chat-empty-state.zh.md b/changelog/0.2.8/2026-08-24-chat-empty-state.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-24-chat-empty-state.zh.md
rename to changelog/0.2.8/2026-08-24-chat-empty-state.zh.md
diff --git a/changelog/unreleased/2026-08-24-penguin-auth.md b/changelog/0.2.8/2026-08-24-penguin-auth.md
similarity index 100%
rename from changelog/unreleased/2026-08-24-penguin-auth.md
rename to changelog/0.2.8/2026-08-24-penguin-auth.md
diff --git a/changelog/unreleased/2026-08-24-penguin-auth.zh.md b/changelog/0.2.8/2026-08-24-penguin-auth.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-24-penguin-auth.zh.md
rename to changelog/0.2.8/2026-08-24-penguin-auth.zh.md
diff --git a/changelog/unreleased/2026-08-24-spa-caching.md b/changelog/0.2.8/2026-08-24-spa-caching.md
similarity index 100%
rename from changelog/unreleased/2026-08-24-spa-caching.md
rename to changelog/0.2.8/2026-08-24-spa-caching.md
diff --git a/changelog/unreleased/2026-08-24-spa-caching.zh.md b/changelog/0.2.8/2026-08-24-spa-caching.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-24-spa-caching.zh.md
rename to changelog/0.2.8/2026-08-24-spa-caching.zh.md
diff --git a/changelog/unreleased/2026-08-26-backward-compatibility.md b/changelog/0.2.8/2026-08-26-backward-compatibility.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-backward-compatibility.md
rename to changelog/0.2.8/2026-08-26-backward-compatibility.md
diff --git a/changelog/unreleased/2026-08-26-backward-compatibility.zh.md b/changelog/0.2.8/2026-08-26-backward-compatibility.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-backward-compatibility.zh.md
rename to changelog/0.2.8/2026-08-26-backward-compatibility.zh.md
diff --git a/changelog/unreleased/2026-08-26-context-menu-scroll-dismiss.md b/changelog/0.2.8/2026-08-26-context-menu-scroll-dismiss.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-context-menu-scroll-dismiss.md
rename to changelog/0.2.8/2026-08-26-context-menu-scroll-dismiss.md
diff --git a/changelog/unreleased/2026-08-26-context-menu-scroll-dismiss.zh.md b/changelog/0.2.8/2026-08-26-context-menu-scroll-dismiss.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-context-menu-scroll-dismiss.zh.md
rename to changelog/0.2.8/2026-08-26-context-menu-scroll-dismiss.zh.md
diff --git a/changelog/unreleased/2026-08-26-install-scoped-local-state.md b/changelog/0.2.8/2026-08-26-install-scoped-local-state.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-install-scoped-local-state.md
rename to changelog/0.2.8/2026-08-26-install-scoped-local-state.md
diff --git a/changelog/unreleased/2026-08-26-install-scoped-local-state.zh.md b/changelog/0.2.8/2026-08-26-install-scoped-local-state.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-install-scoped-local-state.zh.md
rename to changelog/0.2.8/2026-08-26-install-scoped-local-state.zh.md
diff --git a/changelog/unreleased/2026-08-26-markdown-math.md b/changelog/0.2.8/2026-08-26-markdown-math.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-markdown-math.md
rename to changelog/0.2.8/2026-08-26-markdown-math.md
diff --git a/changelog/unreleased/2026-08-26-markdown-math.zh.md b/changelog/0.2.8/2026-08-26-markdown-math.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-markdown-math.zh.md
rename to changelog/0.2.8/2026-08-26-markdown-math.zh.md
diff --git a/changelog/unreleased/2026-08-26-messaging-bind-by-enable.md b/changelog/0.2.8/2026-08-26-messaging-bind-by-enable.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-messaging-bind-by-enable.md
rename to changelog/0.2.8/2026-08-26-messaging-bind-by-enable.md
diff --git a/changelog/unreleased/2026-08-26-messaging-bind-by-enable.zh.md b/changelog/0.2.8/2026-08-26-messaging-bind-by-enable.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-messaging-bind-by-enable.zh.md
rename to changelog/0.2.8/2026-08-26-messaging-bind-by-enable.zh.md
diff --git a/changelog/unreleased/2026-08-26-messaging-delivery-observability.md b/changelog/0.2.8/2026-08-26-messaging-delivery-observability.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-messaging-delivery-observability.md
rename to changelog/0.2.8/2026-08-26-messaging-delivery-observability.md
diff --git a/changelog/unreleased/2026-08-26-messaging-delivery-observability.zh.md b/changelog/0.2.8/2026-08-26-messaging-delivery-observability.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-messaging-delivery-observability.zh.md
rename to changelog/0.2.8/2026-08-26-messaging-delivery-observability.zh.md
diff --git a/changelog/unreleased/2026-08-26-messaging-inbound-mentions.md b/changelog/0.2.8/2026-08-26-messaging-inbound-mentions.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-messaging-inbound-mentions.md
rename to changelog/0.2.8/2026-08-26-messaging-inbound-mentions.md
diff --git a/changelog/unreleased/2026-08-26-messaging-inbound-mentions.zh.md b/changelog/0.2.8/2026-08-26-messaging-inbound-mentions.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-messaging-inbound-mentions.zh.md
rename to changelog/0.2.8/2026-08-26-messaging-inbound-mentions.zh.md
diff --git a/changelog/unreleased/2026-08-26-messaging-inbound-watermark.md b/changelog/0.2.8/2026-08-26-messaging-inbound-watermark.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-messaging-inbound-watermark.md
rename to changelog/0.2.8/2026-08-26-messaging-inbound-watermark.md
diff --git a/changelog/unreleased/2026-08-26-messaging-inbound-watermark.zh.md b/changelog/0.2.8/2026-08-26-messaging-inbound-watermark.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-messaging-inbound-watermark.zh.md
rename to changelog/0.2.8/2026-08-26-messaging-inbound-watermark.zh.md
diff --git a/changelog/unreleased/2026-08-26-messaging-line-per-message.md b/changelog/0.2.8/2026-08-26-messaging-line-per-message.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-messaging-line-per-message.md
rename to changelog/0.2.8/2026-08-26-messaging-line-per-message.md
diff --git a/changelog/unreleased/2026-08-26-messaging-line-per-message.zh.md b/changelog/0.2.8/2026-08-26-messaging-line-per-message.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-messaging-line-per-message.zh.md
rename to changelog/0.2.8/2026-08-26-messaging-line-per-message.zh.md
diff --git a/changelog/unreleased/2026-08-26-messaging-media.md b/changelog/0.2.8/2026-08-26-messaging-media.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-messaging-media.md
rename to changelog/0.2.8/2026-08-26-messaging-media.md
diff --git a/changelog/unreleased/2026-08-26-messaging-media.zh.md b/changelog/0.2.8/2026-08-26-messaging-media.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-messaging-media.zh.md
rename to changelog/0.2.8/2026-08-26-messaging-media.zh.md
diff --git a/changelog/unreleased/2026-08-26-model-oauth-desktop-callback.md b/changelog/0.2.8/2026-08-26-model-oauth-desktop-callback.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-model-oauth-desktop-callback.md
rename to changelog/0.2.8/2026-08-26-model-oauth-desktop-callback.md
diff --git a/changelog/unreleased/2026-08-26-model-oauth-desktop-callback.zh.md b/changelog/0.2.8/2026-08-26-model-oauth-desktop-callback.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-model-oauth-desktop-callback.zh.md
rename to changelog/0.2.8/2026-08-26-model-oauth-desktop-callback.zh.md
diff --git a/changelog/unreleased/2026-08-26-portal-panel-scroll-dismiss.md b/changelog/0.2.8/2026-08-26-portal-panel-scroll-dismiss.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-portal-panel-scroll-dismiss.md
rename to changelog/0.2.8/2026-08-26-portal-panel-scroll-dismiss.md
diff --git a/changelog/unreleased/2026-08-26-portal-panel-scroll-dismiss.zh.md b/changelog/0.2.8/2026-08-26-portal-panel-scroll-dismiss.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-portal-panel-scroll-dismiss.zh.md
rename to changelog/0.2.8/2026-08-26-portal-panel-scroll-dismiss.zh.md
diff --git a/changelog/unreleased/2026-08-26-schedule-target-current-session.md b/changelog/0.2.8/2026-08-26-schedule-target-current-session.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-schedule-target-current-session.md
rename to changelog/0.2.8/2026-08-26-schedule-target-current-session.md
diff --git a/changelog/unreleased/2026-08-26-schedule-target-current-session.zh.md b/changelog/0.2.8/2026-08-26-schedule-target-current-session.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-schedule-target-current-session.zh.md
rename to changelog/0.2.8/2026-08-26-schedule-target-current-session.zh.md
diff --git a/changelog/unreleased/2026-08-26-telegram-forum-topics.md b/changelog/0.2.8/2026-08-26-telegram-forum-topics.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-telegram-forum-topics.md
rename to changelog/0.2.8/2026-08-26-telegram-forum-topics.md
diff --git a/changelog/unreleased/2026-08-26-telegram-forum-topics.zh.md b/changelog/0.2.8/2026-08-26-telegram-forum-topics.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-telegram-forum-topics.zh.md
rename to changelog/0.2.8/2026-08-26-telegram-forum-topics.zh.md
diff --git a/changelog/unreleased/2026-08-26-telegram-group-privacy.md b/changelog/0.2.8/2026-08-26-telegram-group-privacy.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-telegram-group-privacy.md
rename to changelog/0.2.8/2026-08-26-telegram-group-privacy.md
diff --git a/changelog/unreleased/2026-08-26-telegram-group-privacy.zh.md b/changelog/0.2.8/2026-08-26-telegram-group-privacy.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-telegram-group-privacy.zh.md
rename to changelog/0.2.8/2026-08-26-telegram-group-privacy.zh.md
diff --git a/changelog/unreleased/2026-08-26-title-prompt-language.md b/changelog/0.2.8/2026-08-26-title-prompt-language.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-title-prompt-language.md
rename to changelog/0.2.8/2026-08-26-title-prompt-language.md
diff --git a/changelog/unreleased/2026-08-26-title-prompt-language.zh.md b/changelog/0.2.8/2026-08-26-title-prompt-language.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-title-prompt-language.zh.md
rename to changelog/0.2.8/2026-08-26-title-prompt-language.zh.md
diff --git a/changelog/unreleased/2026-08-26-trace-panel-turn-refresh.md b/changelog/0.2.8/2026-08-26-trace-panel-turn-refresh.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-trace-panel-turn-refresh.md
rename to changelog/0.2.8/2026-08-26-trace-panel-turn-refresh.md
diff --git a/changelog/unreleased/2026-08-26-trace-panel-turn-refresh.zh.md b/changelog/0.2.8/2026-08-26-trace-panel-turn-refresh.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-26-trace-panel-turn-refresh.zh.md
rename to changelog/0.2.8/2026-08-26-trace-panel-turn-refresh.zh.md
diff --git a/changelog/unreleased/2026-08-27-backward-compatibility.md b/changelog/0.2.8/2026-08-27-backward-compatibility.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-backward-compatibility.md
rename to changelog/0.2.8/2026-08-27-backward-compatibility.md
diff --git a/changelog/unreleased/2026-08-27-backward-compatibility.zh.md b/changelog/0.2.8/2026-08-27-backward-compatibility.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-backward-compatibility.zh.md
rename to changelog/0.2.8/2026-08-27-backward-compatibility.zh.md
diff --git a/changelog/unreleased/2026-08-27-catalog-tokendance-qwen38-flash.md b/changelog/0.2.8/2026-08-27-catalog-tokendance-qwen38-flash.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-catalog-tokendance-qwen38-flash.md
rename to changelog/0.2.8/2026-08-27-catalog-tokendance-qwen38-flash.md
diff --git a/changelog/unreleased/2026-08-27-catalog-tokendance-qwen38-flash.zh.md b/changelog/0.2.8/2026-08-27-catalog-tokendance-qwen38-flash.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-catalog-tokendance-qwen38-flash.zh.md
rename to changelog/0.2.8/2026-08-27-catalog-tokendance-qwen38-flash.zh.md
diff --git a/changelog/unreleased/2026-08-27-ci-parallel-gates.md b/changelog/0.2.8/2026-08-27-ci-parallel-gates.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-ci-parallel-gates.md
rename to changelog/0.2.8/2026-08-27-ci-parallel-gates.md
diff --git a/changelog/unreleased/2026-08-27-ci-parallel-gates.zh.md b/changelog/0.2.8/2026-08-27-ci-parallel-gates.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-ci-parallel-gates.zh.md
rename to changelog/0.2.8/2026-08-27-ci-parallel-gates.zh.md
diff --git a/changelog/unreleased/2026-08-27-community-standards.md b/changelog/0.2.8/2026-08-27-community-standards.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-community-standards.md
rename to changelog/0.2.8/2026-08-27-community-standards.md
diff --git a/changelog/unreleased/2026-08-27-community-standards.zh.md b/changelog/0.2.8/2026-08-27-community-standards.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-community-standards.zh.md
rename to changelog/0.2.8/2026-08-27-community-standards.zh.md
diff --git a/changelog/unreleased/2026-08-27-messaging-error-kinds.md b/changelog/0.2.8/2026-08-27-messaging-error-kinds.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-messaging-error-kinds.md
rename to changelog/0.2.8/2026-08-27-messaging-error-kinds.md
diff --git a/changelog/unreleased/2026-08-27-messaging-error-kinds.zh.md b/changelog/0.2.8/2026-08-27-messaging-error-kinds.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-messaging-error-kinds.zh.md
rename to changelog/0.2.8/2026-08-27-messaging-error-kinds.zh.md
diff --git a/changelog/unreleased/2026-08-27-messaging-final-reply-only.md b/changelog/0.2.8/2026-08-27-messaging-final-reply-only.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-messaging-final-reply-only.md
rename to changelog/0.2.8/2026-08-27-messaging-final-reply-only.md
diff --git a/changelog/unreleased/2026-08-27-messaging-final-reply-only.zh.md b/changelog/0.2.8/2026-08-27-messaging-final-reply-only.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-messaging-final-reply-only.zh.md
rename to changelog/0.2.8/2026-08-27-messaging-final-reply-only.zh.md
diff --git a/changelog/unreleased/2026-08-27-messaging-inbound-files.md b/changelog/0.2.8/2026-08-27-messaging-inbound-files.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-messaging-inbound-files.md
rename to changelog/0.2.8/2026-08-27-messaging-inbound-files.md
diff --git a/changelog/unreleased/2026-08-27-messaging-inbound-files.zh.md b/changelog/0.2.8/2026-08-27-messaging-inbound-files.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-messaging-inbound-files.zh.md
rename to changelog/0.2.8/2026-08-27-messaging-inbound-files.zh.md
diff --git a/changelog/unreleased/2026-08-27-messaging-markdown.md b/changelog/0.2.8/2026-08-27-messaging-markdown.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-messaging-markdown.md
rename to changelog/0.2.8/2026-08-27-messaging-markdown.md
diff --git a/changelog/unreleased/2026-08-27-messaging-markdown.zh.md b/changelog/0.2.8/2026-08-27-messaging-markdown.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-messaging-markdown.zh.md
rename to changelog/0.2.8/2026-08-27-messaging-markdown.zh.md
diff --git a/changelog/unreleased/2026-08-27-messaging-mention-no-file.md b/changelog/0.2.8/2026-08-27-messaging-mention-no-file.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-messaging-mention-no-file.md
rename to changelog/0.2.8/2026-08-27-messaging-mention-no-file.md
diff --git a/changelog/unreleased/2026-08-27-messaging-mention-no-file.zh.md b/changelog/0.2.8/2026-08-27-messaging-mention-no-file.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-messaging-mention-no-file.zh.md
rename to changelog/0.2.8/2026-08-27-messaging-mention-no-file.zh.md
diff --git a/changelog/unreleased/2026-08-27-messaging-qq-scan.md b/changelog/0.2.8/2026-08-27-messaging-qq-scan.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-messaging-qq-scan.md
rename to changelog/0.2.8/2026-08-27-messaging-qq-scan.md
diff --git a/changelog/unreleased/2026-08-27-messaging-qq-scan.zh.md b/changelog/0.2.8/2026-08-27-messaging-qq-scan.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-messaging-qq-scan.zh.md
rename to changelog/0.2.8/2026-08-27-messaging-qq-scan.zh.md
diff --git a/changelog/unreleased/2026-08-27-messaging-qq.md b/changelog/0.2.8/2026-08-27-messaging-qq.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-messaging-qq.md
rename to changelog/0.2.8/2026-08-27-messaging-qq.md
diff --git a/changelog/unreleased/2026-08-27-messaging-qq.zh.md b/changelog/0.2.8/2026-08-27-messaging-qq.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-messaging-qq.zh.md
rename to changelog/0.2.8/2026-08-27-messaging-qq.zh.md
diff --git a/changelog/unreleased/2026-08-27-shell-line-fallback-follows-the-shell.md b/changelog/0.2.8/2026-08-27-shell-line-fallback-follows-the-shell.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-shell-line-fallback-follows-the-shell.md
rename to changelog/0.2.8/2026-08-27-shell-line-fallback-follows-the-shell.md
diff --git a/changelog/unreleased/2026-08-27-shell-line-fallback-follows-the-shell.zh.md b/changelog/0.2.8/2026-08-27-shell-line-fallback-follows-the-shell.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-shell-line-fallback-follows-the-shell.zh.md
rename to changelog/0.2.8/2026-08-27-shell-line-fallback-follows-the-shell.zh.md
diff --git a/changelog/unreleased/2026-08-27-telegram-botfather-link.md b/changelog/0.2.8/2026-08-27-telegram-botfather-link.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-telegram-botfather-link.md
rename to changelog/0.2.8/2026-08-27-telegram-botfather-link.md
diff --git a/changelog/unreleased/2026-08-27-telegram-botfather-link.zh.md b/changelog/0.2.8/2026-08-27-telegram-botfather-link.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-telegram-botfather-link.zh.md
rename to changelog/0.2.8/2026-08-27-telegram-botfather-link.zh.md
diff --git a/changelog/unreleased/2026-08-27-terminal-resync-flake.md b/changelog/0.2.8/2026-08-27-terminal-resync-flake.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-terminal-resync-flake.md
rename to changelog/0.2.8/2026-08-27-terminal-resync-flake.md
diff --git a/changelog/unreleased/2026-08-27-terminal-resync-flake.zh.md b/changelog/0.2.8/2026-08-27-terminal-resync-flake.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-terminal-resync-flake.zh.md
rename to changelog/0.2.8/2026-08-27-terminal-resync-flake.zh.md
diff --git a/changelog/unreleased/2026-08-27-todo-badges.md b/changelog/0.2.8/2026-08-27-todo-badges.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-todo-badges.md
rename to changelog/0.2.8/2026-08-27-todo-badges.md
diff --git a/changelog/unreleased/2026-08-27-todo-badges.zh.md b/changelog/0.2.8/2026-08-27-todo-badges.zh.md
similarity index 100%
rename from changelog/unreleased/2026-08-27-todo-badges.zh.md
rename to changelog/0.2.8/2026-08-27-todo-badges.zh.md
diff --git a/changelog/0.2.8/RELEASE.md b/changelog/0.2.8/RELEASE.md
new file mode 100644
index 00000000..720c01fa
--- /dev/null
+++ b/changelog/0.2.8/RELEASE.md
@@ -0,0 +1,60 @@
+PenguinHarness 0.2.8 — the release where a bound chat channel stops being a text pipe. Pictures and documents travel both ways on Feishu and Telegram, replies arrive as formatted Markdown rather than literal `**bold**`, QQ joins as a third channel you bind by scanning a QR code, and how a run reaches the chat is now three per-binding switches. Alongside that: an extension seam for the harness itself, and terminal sign-in with `penguin auth`.
+
+## Install
+
+**Desktop app**: grab your platform's installer from [penguin.ooo/download](https://penguin.ooo/download) — the page measures both sources on every visit and keeps GitHub unless the OSS mirror is measurably faster, with a manual selector beside the result. The macOS builds are Developer ID signed and notarized and the Windows installers are Authenticode-signed, so neither platform needs a first-launch unblock.
+
+CLI / server (Linux, macOS; bundled Node runtime):
+
+```sh
+curl -fsSL https://penguin.ooo/install.sh | sh
+penguin web
+```
+
+Windows (PowerShell):
+
+```powershell
+irm https://penguin.ooo/install.ps1 | iex
+penguin web
+```
+
+Or via npm (needs Node >= 24):
+
+```sh
+npm install -g @prismshadow/penguin-cli
+```
+
+## Highlights
+
+**A chat channel carries pictures and files, both ways.** A picture pasted into Feishu or Telegram reaches the Agent as the input the web composer submits — the caption as user text, one `image_url` part per image — and a document reaches it as the composer's other shape: written into the Session scratchpad and handed over as an `[attached file: <path>]` line the model opens with its ordinary file tools, under the same admin-settable caps an authenticated upload answers to, narrowed by any tighter ceiling the channel itself has. Telegram serves a bot no file over 20MB, so that is the number its refusal names. Outbound, a finished run's reply is followed by the files it **mentioned and produced** — path-like tokens that resolve inside the Workspace, exist, and were written at or after the run started. Both filters are load-bearing: the reply's own words are what pick the one output that was the point out of the dozen a run writes, and the mtime is what keeps a steerable reply from becoming a read primitive, since a reply that declines to paste a file still names it. Pictures go as pictures and everything else as attachments, classified by the file the read actually reached rather than by the name the reply spelled.
+
+**Replies arrive as formatting, not as Markdown source.** The bridge sent plain text on every channel, so `## heading` and code fences landed literally. A per-binding `renderMarkdown` now renders each reply in the channel's own markup — Telegram as HTML entities, Feishu as an interactive card's JSON 2.0 rich-text component, QQ as `msg_type: 2` — and the three subsets genuinely differ, so what a channel cannot draw is transformed rather than leaked: Telegram has no headings, lists or tables and gets a bold line, literal markers and a `<pre>` block; QQ has no code spans and gets escaped plain lines. Parsing and chunking are shared, because which constructs a reply contains is a fact about the text and where a long reply may be cut has to be identical everywhere; chunking cuts between blocks, snaps container cuts to line starts so `> ` and `- ` survive, and re-fences a code block that spans the boundary. **A formatted send the platform refuses is retried as plain text**, so a reply is never lost to formatting — the failure Telegram answers with a 400 for one malformed entity.
+
+**Three switches decide how a run reaches the chat.** Each is a per-binding delivery preference, saved beside the credentials and available on all three channels. `linePerMessage` sends each non-blank line of a reply as its own message, capped and paced inside the tightest channel's per-chat allowance, with the remainder combined rather than dropped. `finalReplyOnly` holds a run's working notes and delivers only its last completed assistant text, when the run ends — the answer without the work. `renderMarkdown` is the one above, and the only one that defaults on.
+
+**QQ, bound by scanning a QR code.** A Session's third channel sits behind the same connector seam as the other two, over the platform's WebSocket gateway, so binding one asks for no public callback URL. It did not copy the other two, because QQ does not work like them: every send is a **passive reply** anchored to an inbound message, valid for a few minutes and rationed to a handful per message, so the connector carries a reply budget and combines a run's tail rather than letting the platform drop it. Credentials no longer have to be copied out of the developer console by hand — scan, and the App ID and Secret arrive.
+
+**An extension seam.** An extension package exports one `activate(ctx)` that the server runs once per process while reading `<root>/extensions.json`; everything after that arrives as two typed events, re-delivered on every App creation so a hot swap can never seed registrations into a replaced instance. Which extensions a deployment runs is configuration rather than capability compiled into the platform, and a file that exists but cannot be read fails the boot instead of presenting as a healthy server with every configured capability silently missing.
+
+**Terminal sign-in, and an account bootstrap that stops printing a password.** `penguin auth` signs in from a terminal. A fresh server prints a first-login link instead of a fixed seed password, and a forgotten admin password is recovered offline.
+
+## Notable in this release
+
+- **Breaking — the fixed seed password retires.** A fresh server prints a first-login link; claim the account through it. See [`2026-08-24-penguin-auth`](2026-08-24-penguin-auth.md).
+- **Breaking — existing bindings start rendering Markdown.** `renderMarkdown` defaults on, which changes how every relayed message looks. The per-binding switch turns it off. See [`2026-08-27-messaging-markdown`](2026-08-27-messaging-markdown.md).
+- **Breaking, on downgrade only.** Two `web.db` changes are one-way in practice; both are stated with what happens and what to do in [`2026-08-26-backward-compatibility`](2026-08-26-backward-compatibility.md) and [`2026-08-27-backward-compatibility`](2026-08-27-backward-compatibility.md).
+- **A bot account is no longer owned by one Session forever.** Enabling the connection is the binding; saving credentials never opens or closes one.
+- **A binding says what it has actually seen.** "I sent the bot a message and nothing happened" had three different causes and one status word; the panel now separates them, and a Telegram bot that cannot hear a group says so instead of looking healthy and silent.
+- **Red-dot to-dos with a way to put them down.** Skill-library updates, model-library preset updates and unexpected errors in the cost center each raise a dot that leads to the control that deals with it. A dismissal stores the signature of what was waved away, so anything new raises it again.
+- **A messaging refusal the chat already explained is no longer counted as a defect.** A Feishu scope that has not been granted, and a file QQ structurally cannot carry, are `expected` — the person who can act has already been handed the fix in the chat. A reply that merely *mentions* a file the Workspace does not have is logged rather than announced.
+- **LaTeX renders on every Markdown surface**, through one shared pipeline.
+- **Scheduled tasks target the current Session by default**, so a task arranged in conversation reports back into it.
+- **Deleting the data root clears the browser state that belonged to it** — `localStorage` had no relationship to the data root, so a wipe-and-restart brought the old Workspace back.
+- **Qwen 3.8 Flash joins the TokenDance group**, at that gateway's own rates. The same id also sits under Qwen pay-as-you-go at Qwen's direct price: one model reached two ways.
+- **CI fans out into parallel shards**, and the community health files GitHub looks for now live under `.github/`.
+
+## Requirements
+
+Linux or macOS (x64 / arm64), or Windows 10+ (x64). The desktop app and the CLI installers bundle their own runtime; installing from npm needs Node >= 24. All data stays under `~/.penguin/data`.
+
+Full detail: [changelog/0.2.8/](https://github.com/Prism-Shadow/penguin-harness/tree/main/changelog/0.2.8).
diff --git a/package.json b/package.json
index 275a0e8e..ed9619c5 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "penguin-harness",
- "version": "0.2.7",
+ "version": "0.2.8",
"private": true,
"type": "module",
"description": "PenguinHarness \u2014 TypeScript AI Agent (SDK + CLI).",
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 8d609f4a..46b211c7 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
{
"name": "@prismshadow/penguin-cli",
- "version": "0.2.7",
+ "version": "0.2.8",
"type": "module",
"description": "PenguinHarness CLI: interactive REPL and single-task runner over @prismshadow/penguin-core.",
"license": "Apache-2.0",
diff --git a/packages/core/package.json b/packages/core/package.json
index c72bd900..f3e3df12 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
{
"name": "@prismshadow/penguin-core",
- "version": "0.2.7",
+ "version": "0.2.8",
"type": "module",
"engines": {
"node": ">=24"
diff --git a/packages/core/src/index.ts b/packages/core/src/index.ts
index 66ef8816..f72ff67f 100644
--- a/packages/core/src/index.ts
+++ b/packages/core/src/index.ts
@@ -77,7 +77,7 @@ export type {
} from "./agent.js";
/** SDK version number. */
-export const VERSION = "0.2.7";
+export const VERSION = "0.2.8";
/** Release build date (UTC yyyy-mm-dd), stamped by the release workflow next to VERSION; null in a dev/source build. */
export const BUILD_DATE: string | null = null;
/** Full commit sha the release was built from, stamped by the release workflow next to VERSION; null in a dev/source build. */
diff --git a/packages/desktop/package.json b/packages/desktop/package.json
index c368dd63..880e1bdd 100644
--- a/packages/desktop/package.json
+++ b/packages/desktop/package.json
@@ -1,6 +1,6 @@
{
"name": "@prismshadow/penguin-desktop",
- "version": "0.2.7",
+ "version": "0.2.8",
"private": true,
"type": "module",
"description": "PenguinHarness desktop app: Electron shell running @prismshadow/penguin-server as a utilityProcess, window on http://localhost (same-origin HTTP/SSE, no private IPC).",
diff --git a/packages/docs/package.json b/packages/docs/package.json
index 2c6d39c2..6ecd3624 100644
--- a/packages/docs/package.json
+++ b/packages/docs/package.json
@@ -1,6 +1,6 @@
{
"name": "@prismshadow/penguin-docs",
- "version": "0.2.7",
+ "version": "0.2.8",
"private": true,
"type": "module",
"description": "PenguinHarness documentation site (React + Vite + Tailwind CSS): bilingual zh/en Markdown pages with light/dark themes and per-page Copy Markdown, deployed to GitHub Pages under /docs/ next to the landing page.",
diff --git a/packages/landing/package.json b/packages/landing/package.json
index a241fd50..60db9efd 100644
--- a/packages/landing/package.json
+++ b/packages/landing/package.json
@@ -1,6 +1,6 @@
{
"name": "@prismshadow/penguin-landing",
- "version": "0.2.7",
+ "version": "0.2.8",
"private": true,
"type": "module",
"description": "PenguinHarness landing page (React + Vite + Tailwind CSS): multilingual, light/dark themes, benchmark showcase, and a local Markdown blog, deployed to GitHub Pages via GitHub Actions.",
diff --git a/packages/server/package.json b/packages/server/package.json
index 2875cdd5..ee9a1caa 100644
--- a/packages/server/package.json
+++ b/packages/server/package.json
@@ -1,6 +1,6 @@
{
"name": "@prismshadow/penguin-server",
- "version": "0.2.7",
+ "version": "0.2.8",
"type": "module",
"description": "PenguinHarness web server: multi-user authentication and authorization, Session execution with SSE streaming, and usage accounting, built on @prismshadow/penguin-core.",
"license": "Apache-2.0",
diff --git a/packages/skills/package.json b/packages/skills/package.json
index 5f51ca92..00d93af8 100644
--- a/packages/skills/package.json
+++ b/packages/skills/package.json
@@ -1,6 +1,6 @@
{
"name": "@prismshadow/penguin-skills",
- "version": "0.2.7",
+ "version": "0.2.8",
"type": "module",
"engines": {
"node": ">=24"
diff --git a/packages/web/package.json b/packages/web/package.json
index 4103e315..d26631a7 100644
--- a/packages/web/package.json
+++ b/packages/web/package.json
@@ -1,6 +1,6 @@
{
"name": "@prismshadow/penguin-web",
- "version": "0.2.7",
+ "version": "0.2.8",
"private": true,
"type": "module",
"description": "PenguinHarness web frontend SPA: React + Vite + Tailwind CSS, rendering conversations streamed over the OmniMessage protocol, plus Agent configuration, model configuration, usage stats, and Traces.",
diff --git a/packages/web/src/lib/nav-group-collapse.ts b/packages/web/src/lib/nav-group-collapse.ts
index b7f28d3e..a2d7e16f 100644
--- a/packages/web/src/lib/nav-group-collapse.ts
+++ b/packages/web/src/lib/nav-group-collapse.ts
@@ -40,9 +40,22 @@ export type NavGroupKey = (typeof NAV_GROUP_KEYS)[number];
*/
const ADMIN_ONLY_NAV_KEYS: ReadonlySet<NavGroupKey> = new Set<NavGroupKey>(["machines"]);
+/**
+ * Entries built but not yet offered. They keep their place in the manifest — the page, its
+ * route and its server routes all still exist and are reachable from a test — and are simply
+ * not put in front of anyone, so releasing one is deleting its name from this set rather than
+ * restoring code.
+ *
+ * `machines` installs this build onto another host over ssh with the server account's keys.
+ * That is a capability worth shipping deliberately rather than as a row that happens to appear,
+ * so it waits for a release that means to introduce it.
+ */
+const UNRELEASED_NAV_KEYS: ReadonlySet<NavGroupKey> = new Set<NavGroupKey>(["machines"]);
+
/** The manifest as this user sees it. */
export function navKeysFor(isAdmin: boolean): readonly NavGroupKey[] {
- return isAdmin ? NAV_GROUP_KEYS : NAV_GROUP_KEYS.filter((key) => !ADMIN_ONLY_NAV_KEYS.has(key));
+ const offered = NAV_GROUP_KEYS.filter((key) => !UNRELEASED_NAV_KEYS.has(key));
+ return isAdmin ? offered : offered.filter((key) => !ADMIN_ONLY_NAV_KEYS.has(key));
}
/**
diff --git a/packages/web/src/router.tsx b/packages/web/src/router.tsx
index 695fd509..2f466ac2 100644
--- a/packages/web/src/router.tsx
+++ b/packages/web/src/router.tsx
@@ -14,7 +14,6 @@ import { AgentsPage } from "./features/agents/agents-page";
import { AgentSettingsPage } from "./features/agents/agent-settings-page";
import { SkillsPage } from "./features/skills/skills-page";
import { ModelsPage } from "./features/models/models-page";
-import { MachinesPage } from "./features/machines/machines-page";
import { UsagePage } from "./features/usage/usage-page";
import { BenchmarkPage } from "./features/benchmark/benchmark-page";
import { TerminalPage } from "./features/terminal/terminal-page";
@@ -74,7 +73,6 @@ export function AppRouter() {
<Route path="/models" element={<ModelsPage />} />
{/* Admin-only server-side (403 otherwise); the sidebar hides the row for
everyone else, so a member only ever reaches this by typing the URL. */}
- <Route path="/machines" element={<MachinesPage />} />
<Route path="/usage" element={<UsagePage />} />
<Route path="/benchmark" element={<BenchmarkPage />} />
{/* System settings and user management live in the settings dialog now (see
diff --git a/packages/web/test/nav-group-collapse.test.ts b/packages/web/test/nav-group-collapse.test.ts
index d38c70d8..6a81e08f 100644
--- a/packages/web/test/nav-group-collapse.test.ts
+++ b/packages/web/test/nav-group-collapse.test.ts
@@ -73,13 +73,16 @@ describe("navKeysFor", () => {
// /api/machines is admin-gated server-side (it spawns ssh with the server account's
// keys), so offering a member the row would only ever produce a 403.
expect([...navKeysFor(false)]).toEqual(["agents", "skills", "models", "usage", "benchmark"]);
- expect(navKeysFor(true)).toEqual(NAV_GROUP_KEYS);
+ // An admin sees the manifest minus what is built but not yet offered — `machines` today,
+ // which is why neither answer contains it and the two are equal for now.
+ expect([...navKeysFor(true)]).toEqual(["agents", "skills", "models", "usage", "benchmark"]);
+ expect(NAV_GROUP_KEYS as readonly string[]).toContain("machines");
});
});
describe("visibleNavKeys", () => {
it("expanded shows the whole group; collapsed leaves no entry visible or reachable (the sidebar renders the mounted rows inert at zero height)", () => {
- expect(visibleNavKeys(false)).toEqual(NAV_GROUP_KEYS);
+ expect(visibleNavKeys(false)).toEqual(navKeysFor(true));
expect(visibleNavKeys(true)).toEqual([]);
});
@@ -120,7 +123,7 @@ describe("persisted collapse state (one global localStorage key)", () => {
storeNavGroupCollapsed(false, s);
expect(s.map.get(NAV_GROUP_COLLAPSED_KEY)).toBe("expanded");
expect(initialNavGroupCollapsed(s)).toBe(false);
- expect(visibleNavKeys(initialNavGroupCollapsed(s))).toEqual(NAV_GROUP_KEYS);
+ expect(visibleNavKeys(initialNavGroupCollapsed(s))).toEqual(navKeysFor(true));
});
it("unrecognized stored values fall back to expanded", () => {