dsh-oc-tui 0.1.2 → 0.1.4

package/docs//347/224/250/346/210/267/346/211/213/345/206/214.md

@@ -17,7 +17,7 @@
   - [5.2 斜杠命令](#52-斜杠命令)
   - [5.3 交互式提示：授权与提问](#53-交互式提示授权与提问)
   - [5.4 思考强度](#54-思考强度)
-  - [5.5 上下文仪表与遥测](#55-上下文仪表与遥测)
+  - [5.5 会话统计与上下文仪表](#55-会话统计与上下文仪表)
   - [5.6 设置菜单](#56-设置菜单)
   - [5.7 程序内更新](#57-程序内更新)
 - [6. 工作原理](#6-工作原理)
@@ -36,8 +36,9 @@
 | **工具活动** | 工具卡片带一行摘要（`read src/app.ts`、`run npm test`），运行中显示流动 spinner，结果按 Markdown 渲染。 |
 | **交互式提问** | 模型可以暂停并向你提问——选项列表、多选、自由文本、可滚动的计划评审，全部在终端内完成。 |
 | **内联授权** | `approval/request` 询问用 `y` / `n` 直接回答，无需离开界面。 |
-| **遥测页脚** | 会话 token、平均首 token 时间（TTFT）、解码吞吐、KV 缓存命中率，均由持久事件折叠得出。 |
-| **上下文仪表** | 实时上下文占用（`ctx ▓▓░░ 32K/128K 25%`），点击可展开构成明细。 |
+| **遥测页脚** | 会话统计条：轮次/步数、LLM 与工具耗时、平均首 token 时间（TTFT）、解码吞吐、KV 缓存命中率与输入/输出 token，均由持久事件折叠得出。 |
+| **统计窗口** | 点击统计条或上下文仪表条，或输入 `/stats`，打开会话统计与 token 用量明细窗口。 |
+| **上下文仪表** | 实时上下文占用（`ctx ▓▓░░ 32K/128K 25%`），明细窗口内含按系统提示词/工具/消息拆分的构成占比。 |
 | **思考强度** | `Tab` 循环切换当前模型真实支持的推理等级；`Ctrl+E` 打开滑块。选择按请求应用并持久化。 |
 | **共享设置** | 与 WebUI 相同的 Host 设置命名空间——通用、会话、各 provider 模型配置、凭据——持久化到 `$DSH_HOME/settings.yaml`。 |
 | **程序内更新** | 在 TUI 内检测并切换 `@deepseek-ai/dsh` 与 `dsh-oc-tui` 版本，Windows 上采用延迟安装避免静默损坏。 |
@@ -199,14 +200,17 @@ dsh-oc-tui --version       # 启动器版本
 | `Up` / `Down` | 在多行输入中上下移动光标；位于第一行/最后一行时改为浏览输入历史 |
 | `Left` / `Right` | 在输入框中左右移动光标 |
 | `PgUp` / `PgDn` | 滚动转录区 |
-| `Esc` | 关闭上下文仪表盘 / 关闭强度滑块 / 关闭帮助 / 取消授权询问 |
+| `Esc` | 关闭会话统计窗口 / 关闭强度滑块 / 关闭帮助 / 取消授权询问 / 中断正在运行的轮次 / 清空正在输入的提示词 |
+| `Esc Esc` | 空闲且输入框为空时打开 rewind 选择器 |
 | `y` / `n` | 回答界面内的授权询问 |
 
-**鼠标**：滚轮滚动页面——会话页滚动转录区，设置窗口打开时滚动设置窗口。在转录区按住左键拖动可选中文字，随后按右键把所选文字复制到剪贴板。
+**鼠标**：滚轮滚动页面——会话页滚动转录区，设置窗口打开时滚动设置窗口。在转录区按住左键拖动可选中文字，随后按右键把所选文字复制到剪贴板。会话页的统计条与上下文仪表条都是点击目标（见 [5.5](#55-会话统计与上下文仪表)）。
 
 ### 5.2 斜杠命令
 
-内建命令：`/help` `/settings` `/new` `/resume <id>` `/model <id>` `/provider <route>` `/clear` `/cancel` `/quit`（`/exit` 等效）。
+内建命令：`/help` `/settings` `/new` `/resume <id>` `/model <id>` `/provider <route>` `/rewind` `/stats` `/clear` `/cancel` `/quit`（`/exit` 等效）。
+
+**Rewind（回退）**：`Esc Esc`（或 `/rewind`）列出当前会话的提示词。选择"恢复对话"会以所选提示词之前的事件**分叉出一个新会话**，父会话完整留在磁盘上——与 dsh 自身的 `session/fork` 行为一致；选择器默认停在最近一条真实提示词上，因此连按两次 `Enter` 即回退最后一轮。`/rewind <n|last> [conversation|code|both]` 可跳过选择器直接执行。分叉出的新会话从**空 inbox** 开始：切点落在某轮 turn 之前，也会切掉那一轮对 inbox 的认领，因此父会话里排队过的输入（**包括你这次要丢掉的那条提示词**）不会被再次投递，它们仍留在父会话日志里；若有此类输入，结果行会显示 `dropped N inherited pending input`。**恢复文件**是尽力而为且有护栏的：必须在 git 工作区中（否则提示 `files not restored (not a git worktree)` 且不改动任何文件）；已跟踪文件用 `HEAD` 覆盖且不触碰索引；只有当日志中该路径的首次写入发生在回退点之后时，才会删除未跟踪文件。所有被覆盖或删除的内容都会先复制到 `$DSH_HOME/rewind-backups/<sessionId>/<时间戳>/`，结果行会给出该目录。由于日志不保存文件内容，已跟踪文件回到的是最近一次提交，而非回退点当时的状态。
 
 dsh 的人类命令（`/compact`、`/goal`、`/plan` 等）会转发给 `ctx.commands`，不经过模型轮次执行。**这些命令需要有活动会话**：在标题屏上敲会得到 `/<name>: start a session first` 提示，而不是被静默丢弃。因此想用 `/plan` 进入计划模式，请先随便发一条消息建立会话。
 
@@ -242,11 +246,23 @@ dsh 的人类命令（`/compact`、`/goal`、`/plan` 等）会转发给 `ctx.com
 
 选择通过 `agent/request` waterfall 应用到该会话的请求，并保存到 `agent-default-model.reasoningEffort`。
 
-### 5.5 上下文仪表与遥测
+### 5.5 会话统计与上下文仪表
+
+输入框上方一行是**会话统计条**，对应 Web 界面输入框下方的统计行——用 `│` 分隔、按同样的顺序列出同一批数字：
 
-状态栏带实时上下文占用条，数据来自 token-meter 的 `contextPressure` 投影（与 Web 界面输入框右侧的环形仪表同源）：当前上下文长度 / 模型上下文窗口，占用升高时转入警示色与错误色。点击占用条会打开明细面板（再次点击或 `Esc` 关闭），显示占用读数与按启发式拆分的构成占比——系统提示词、工具、对话消息——对应 WebUI 的 ContextMeter 弹窗。当 profile 缺少 token-meter 投影时，占用条自动隐藏，不影响其它功能。
+```
+▤ 1 turn · 2 steps│LLM 1.3s · tools 1.2s│TTFT avg 400ms · 20.0 tok/s│cache 55%│in 110 · out 30
+```
 
-页脚报告会话 token、平均首 token 时间、解码吞吐与缓存命中率，均由持久的 step/chunk/message 事件折叠得出。
+- `turns` / `steps` 统计**已结束的步**（`step/end`）：失败、取消、触顶的步同样计入；`LLM` 是 `step/start` → 组装完成的回复，`tools` 是配对的 `tool/call` → `tool/result`。
+- `TTFT avg` 是每步首 token 延迟的平均值，`tok/s` 是解码吞吐（首 token → 组装完成之间的输出 token）。
+- `cache` 是提示词侧缓存命中率（缓存读取 ÷ 全部计费输入），`in` / `out` 是本次会话累计的计费输入与输出 token。
+- 极窄终端会**整组**丢弃放不下的尾部数字并标出 `│…`，不会把某个数字截成两半；完整数字始终在明细窗口里。
+- 会话还没有任何已结束的步、也没有任何 token 计费时，统计条整行隐藏，把该行还给转录区。
+
+统计条整行是点击目标：点击它（或点击状态栏右端的上下文仪表条 `ctx ▓▓░░ 32K/128K 25%`，或输入 `/stats`）打开**会话统计窗口**，再次点击、点击别处或按 `Esc` 关闭。窗口把同一个统计条拆成明细行（`usage` / `duration` / `speed` / `tokens` / `cache`），并附上上下文占用读数与按启发式拆分的构成占比——系统提示词、工具、对话消息——对应 WebUI 的 ContextMeter 弹窗。
+
+数据来源与 Web 界面一致，优先级为**投影优先、本地折叠兜底**：token-meter 的 `tokenUsage`、`contextPressure`、`contextBreakdown` 投影由 `dsh-base` 挂载；`sessionStats` 投影只有 Web 应用层 bundle 才挂载，因此 TUI 自己按同样的规则折叠持久日志里的 `step` / `chunk` / `message` / `tool` 事件。profile 缺少某个投影时，对应数字自动退回本地折叠而不影响其它功能；两者都不存在时（例如尚无任何事件）该行/该组自动隐藏。
 
 ### 5.6 设置菜单
 
@@ -264,6 +280,8 @@ dsh 的人类命令（`/compact`、`/goal`、`/plan` 等）会转发给 `ctx.com
 
 WebUI 专属选项（`ui-theme` 外观、`locale` 语言）不在 TUI 中显示，因为它们在终端里没有效果。
 
+**第三方插件的设置页分区（目前尚不支持）**：`@dsh-std` 生态里有 `ui.dsh/v1alpha1` 的 `ContributionHost` / `UiContribution` 协议，本意是让第三方插件往宿主的设置面追加只读分区（`host-rendered` 模式，即宿主自己渲染对方给的数据）。TUI **目前不托管**这类贡献，所以设置页只显示上面列出的内置分区：本插件的 `@dsh-std` facet 无法注册贡献宿主——adapter 对 facet 提交的实现有强制校验（必须有 `handle` 函数，字段名必须是 `protocol`），而协议里的 `UiContributionProvider` 两条都不满足，提交它会让 adapter 在挂载时回滚整个 profile；真正的注册入口是 adapter 的实例方法 `registerUiContributionProvider`，facet 拿不到 adapter 实例。需要宿主自己执行第三方 JS 的 `local-module` 模式则永久不在计划内（TUI 无沙箱，且协议说明没有同一 page realm 的 TUI 不需要实现它）。另需注意：本插件的 facet 在当前上游下**一条协议 support 都不暂存**——Community v0.15 清单无法声明 supports，而 lifecycle 要求先声明才能暂存——所以它不只是不托管贡献宿主，Presentation 与 CommandRuntime 同样处于休眠状态。详见 [dsh-std 接入说明](dsh-std-接入说明.md) 开头的「阻断性发现」。
+
 ### 5.7 程序内更新
 
 `Ctrl+P → Update` 页面负责检测并切换 dsh 与 TUI 自身的版本，所有检查与安装都通过 `npm` / `dsh plugin`（即 pnpm）执行，因此会尊重你配置的 registry 与镜像。状态行**只以稳定版为目标**：
@@ -289,8 +307,8 @@ macOS/Linux 没有 DLL 锁，但检测到其它 dsh 进程运行时也会拒绝
 
 - 插件是用 `tui` profile 加载的 Cordis 函数插件。`lib/startup.js` 解析本应用的命令行参数并提供 `tuiStartup` 服务；`lib/index.js` 拥有 UI 主循环。
 - `lib/term.js` 是零依赖终端引擎：raw 模式、备用屏幕、差分单元缓冲、按键解码（真彩 ANSI、CJK 宽度感知）。它把隐藏的终端光标停在输入光标处，使系统 IME 的候选窗锚定在输入框内；同时理解 SGR 与旧式 X10 两种鼠标编码，滚轮/点击字节不会漏进输入文本。
-- `lib/ui.js` 是响应式视图模型与渲染器（DeepSeek 蓝白主题、会话栏、转录区、多行输入框、命令建议、遥测页脚）。转录行按块缓存，每帧只实体化可见窗口，流式绘制合并，活动块按短节流重绘——因此渲染成本有界，输出速度不随历史增长而下降。思考内容折叠以保持转录可读，运行中的工具与思考块用流动 spinner 提示。
-- `lib/metrics.js` 把持久的 step/chunk/message 事件折叠为 token、TTFT、吞吐与缓存命中指标。
+- `lib/ui.js` 是响应式视图模型与渲染器（DeepSeek 蓝白主题、会话栏、转录区、多行输入框、命令建议、会话统计条、状态栏）。转录行按块缓存，每帧只实体化可见窗口，流式绘制合并，活动块按短节流重绘——因此渲染成本有界，输出速度不随历史增长而下降。思考内容折叠以保持转录可读，运行中的工具与思考块用流动 spinner 提示。
+- `lib/metrics.js` 把持久的 step/chunk/message/tool 事件折叠为整场会话的轮次/步数、耗时、TTFT、吞吐、缓存命中与计费 token（与 Web 界面的 `sessionStats` / `tokenUsage` 投影同规则），并在 profile 提供投影时以投影值为准。
 - `lib/interrupt.js` 管理 stdin 与 `SIGINT` 共用的清空/取消/二次退出状态机。
 - `lib/markdown.js` 把模型输出（标题、列表、引用、代码、行内样式）渲染为带样式的行。
 - `lib/updates.js` 隔离 Update 页面的全部 npm/pnpm 交互——registry 查询、无依赖 semver 比较、dsh 安装探测、异步安装——一律走 `child_process.spawn`，从不使用 `spawnSync`。
@@ -355,9 +373,9 @@ dsh --profile tui --dump-config   # 先初始化 base profile
 # $DSH_HOME/profiles/tui/cordis.patch.yml
 - insert:
     - id: tui-startup
-      name: 'file:///D:/Projects/DeepSeekHarnessPlugins/dsh-oc-tui/lib/startup.js'
+      name: 'file:///path/to/dsh-oc-tui/lib/startup.js'
     - id: tui-app
-      name: 'file:///D:/Projects/DeepSeekHarnessPlugins/dsh-oc-tui/lib/index.js'
+      name: 'file:///path/to/dsh-oc-tui/lib/index.js'
       config:
         sidebar: true
         showReasoning: true
@@ -367,12 +385,12 @@ dsh --profile tui --dump-config   # 先初始化 base profile
 
 ## 9. 已知限制
 
-- 零依赖终端引擎尚未暴露 IME 组字与 bracketed-paste 图片附件。
+- 零依赖终端引擎尚未暴露 IME 组字；图片附件已支持：bracketed paste 的原始图片字节、`data:image/...;base64,...` 数据 URL、本地图片路径或图片 URL 都会变成 `[Image N]` 附件，而粘贴一段无法识别的文本时会向终端请求剪贴板（OSC 52）。
 - 插件不支持热重载：profile 的 HMR 根是 profile 目录，运行中的 TUI 保持它启动时的那份副本。
 - `dsh tui` 作为裸子命令需要 shell 别名——原版启动器只硬编码了 `web` 与 `plugin`。
 - dsh 的人类斜杠命令需要活动会话；标题屏上会提示先建立会话。
 - `Esc` 让出问题不会取消工具调用，而是委托；没有其它应答者时该工具调用会失败。WebUI composer 支持的**逐题跳过**尚未实现。
-- `--resume`、设置 → 管理会话、上下文仪表依赖 `@deepseek-ai/dsh-base` 挂载的服务（`sessionQuery`、`sessionProjections`）；手工搭建的 profile 需自行提供。
+- `--resume`、设置 → 管理会话、会话统计条与上下文仪表依赖 `@deepseek-ai/dsh-base` 挂载的服务（`sessionQuery`、`sessionProjections`）；手工搭建的 profile 需自行提供。`sessionStats` 投影只由 Web 应用层 bundle 挂载，缺少时 TUI 自行从会话日志折叠同样的数字。
 - Windows 上的延迟 dsh 安装只等待**调度它的那个 TUI**，不是机器上所有 dsh 进程；执行前请关掉其它 TUI 窗口（以及 `dsh web`）。
 
 ## 10. 目录结构
@@ -382,17 +400,22 @@ lib/index.js        插件入口：agents、事件、输入、命令、授权、
 lib/startup.js      命令行参数提供者（tuiStartup 服务）
 lib/term.js         终端引擎（raw 模式、屏幕、按键解码）
 lib/ui.js           响应式视图模型 + 渲染器（含问答弹窗）
-lib/metrics.js      持久事件遥测统计
+lib/metrics.js      整场会话统计 + token 用量折叠（Web 统计条 / tokenUsage 投影同规则）
 lib/interrupt.js    Ctrl+C 生命周期状态机
 lib/web-settings.js WebUI 设置投影
 lib/updates.js      程序内更新（npm registry + 安装）
 lib/markdown.js     Markdown -> 带样式文本行
 lib/util.js         文本/显示工具
+lib/bridge.js       活体 TUI 注册表（@dsh-std facet 的转发目标）
+lib/facet.js        @dsh-std facet 入口（互操作外壳，不启动 TUI）
+lib/std/            @dsh-std 协议适配（adapt、presentation、commands、command-list）
 bin/dsh-oc-tui.js   便捷启动器
 install.sh          一键安装脚本（Linux/macOS）
 install.ps1         一键安装脚本（Windows）
+dsh-plugin.json     @dsh-std 组件清单（仅用于发现与预检）
 cordis.patch.yml    bundle 补丁层（TUI 行、预设名册、提问工具）
 docs/用户手册.md     本手册
+docs/dsh-std-接入说明.md  @dsh-std 接入范围与约束
 tests/smoke.test.mjs 独立冒烟测试
 ```
 

package/dsh-plugin.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://raw.githubusercontent.com/Yan-Zero/dsh-std/main/packages/manifest/schema/dsh-plugin-0.15.schema.json",
+  "manifestVersion": "0.15",
+  "id": "io.github.rayafriandion.dsh-oc-tui",
+  "name": "dsh-oc-tui",
+  "version": "0.1.4",
+  "license": "LGPL-3.0-or-later",
+  "source": { "repository": "https://github.com/rayafriandion/dsh-oc-tui" },
+  "facets": { "host": { "entry": "lib/facet.js", "apiVersion": "v1alpha1" } },
+  "requires": {
+    "contracts": [
+      { "apiVersion": "commands.dsh/v1alpha1", "kind": "Command", "optional": true }
+    ]
+  },
+  "permissions": [
+    { "name": "storage.local.read", "scope": "io.github.rayafriandion.dsh-oc-tui",
+      "reason": "Read TUI settings from the host settings store." },
+    { "name": "storage.local.write", "scope": "io.github.rayafriandion.dsh-oc-tui",
+      "reason": "Persist TUI settings chosen in the Settings pages." }
+  ],
+  "contributes": {
+    "x-dev.dsh-std.extensions": [
+      { "id": "io.github.rayafriandion.dsh-oc-tui.settings",
+        "apiVersion": "commands.dsh/v1alpha1", "kind": "Command", "name": "settings",
+        "spec": { "title": "Open the TUI settings pages",
+                  "placements": [{ "apiVersion": "tui.dsh/v1alpha1", "kind": "CommandLine" }] } },
+      { "id": "io.github.rayafriandion.dsh-oc-tui.help",
+        "apiVersion": "commands.dsh/v1alpha1", "kind": "Command", "name": "help",
+        "spec": { "title": "Show the TUI key and command reference",
+                  "placements": [{ "apiVersion": "tui.dsh/v1alpha1", "kind": "CommandLine" }] } },
+      { "id": "io.github.rayafriandion.dsh-oc-tui.stats",
+        "apiVersion": "commands.dsh/v1alpha1", "kind": "Command", "name": "stats",
+        "spec": { "title": "Show session token and cache statistics",
+                  "placements": [{ "apiVersion": "tui.dsh/v1alpha1", "kind": "CommandLine" }] } },
+      { "id": "io.github.rayafriandion.dsh-oc-tui.new",
+        "apiVersion": "commands.dsh/v1alpha1", "kind": "Command", "name": "new",
+        "spec": { "title": "Start a new session",
+                  "placements": [{ "apiVersion": "tui.dsh/v1alpha1", "kind": "CommandLine" }] } },
+      { "id": "io.github.rayafriandion.dsh-oc-tui.resume",
+        "apiVersion": "commands.dsh/v1alpha1", "kind": "Command", "name": "resume",
+        "spec": { "title": "Resume a persisted session",
+                  "placements": [{ "apiVersion": "tui.dsh/v1alpha1", "kind": "CommandLine" }] } },
+      { "id": "io.github.rayafriandion.dsh-oc-tui.clear",
+        "apiVersion": "commands.dsh/v1alpha1", "kind": "Command", "name": "clear",
+        "spec": { "title": "Clear the transcript",
+                  "placements": [{ "apiVersion": "tui.dsh/v1alpha1", "kind": "CommandLine" }] } },
+      { "id": "io.github.rayafriandion.dsh-oc-tui.cancel",
+        "apiVersion": "commands.dsh/v1alpha1", "kind": "Command", "name": "cancel",
+        "spec": { "title": "Cancel the running turn",
+                  "placements": [{ "apiVersion": "tui.dsh/v1alpha1", "kind": "CommandLine" }] } },
+      { "id": "io.github.rayafriandion.dsh-oc-tui.rewind",
+        "apiVersion": "commands.dsh/v1alpha1", "kind": "Command", "name": "rewind",
+        "spec": { "title": "Rewind the session to an earlier point",
+                  "placements": [{ "apiVersion": "tui.dsh/v1alpha1", "kind": "CommandLine" }] } },
+      { "id": "io.github.rayafriandion.dsh-oc-tui.quit",
+        "apiVersion": "commands.dsh/v1alpha1", "kind": "Command", "name": "quit",
+        "spec": { "title": "Leave the TUI", "aliases": ["exit"],
+                  "placements": [{ "apiVersion": "tui.dsh/v1alpha1", "kind": "CommandLine" }] } }
+    ]
+  },
+  "overrides": [
+    { "target": "@deepseek-ai/dsh-base", "kind": "patch",
+      "description": "cordis.patch.yml inserts the tui-startup, tui-app, agent-presets and tool-ask-user rows." }
+  ]
+}

package/lib/bridge.js

@@ -0,0 +1,33 @@
+// The live-TUI registry: the one place that answers "is a TUI instance running,
+// and how do I reach it".
+//
+// The @dsh-std facet (lib/facet.js) does not own the TUI's lifecycle — the
+// cordis bundle rows in cordis.patch.yml do. The facet only publishes protocol
+// implementations whose handlers forward here. Because the adapter's mount
+// order relative to the bundle rows is not guaranteed, handlers must look the
+// handle up at call time (late binding) rather than capture it at activation.
+//
+// No dependencies: lib/index.js imports this, so it must stay free of anything
+// that could fail to resolve in a lean profile.
+
+let active = null
+
+// Register the running TUI. Returns an idempotent release function that only
+// clears the registry if this registration is still the current one — a newer
+// registration must survive an older one's teardown.
+export function registerLiveTui(handle) {
+  active = handle
+  let released = false
+  return () => {
+    if (released) return
+    released = true
+    if (active === handle) active = null
+  }
+}
+
+// The current TUI handle, or null when no TUI is running. Callers must handle
+// null: it is the normal state when the facet is mounted in a profile whose
+// bundle rows did not load.
+export function liveTui() {
+  return active
+}

package/lib/facet.js

@@ -0,0 +1,129 @@
+// The @dsh-std facet entry declared by dsh-plugin.json.
+//
+// HARD CONSTRAINT: this module must never start the TUI. The TUI's lifecycle
+// belongs to the cordis bundle rows in cordis.patch.yml; the adapter mounts
+// this facet in ADDITION to those rows, and the TUI seizes the terminal
+// (raw mode, alt screen, mouse tracking), so a second instance would fight the
+// first rather than merely duplicate it.
+//
+// The facet is therefore an interop surface: it publishes protocol
+// implementations whose handlers forward through lib/bridge.js to whichever TUI
+// instance is live, and reports `degraded` when none is.
+//
+// The optional peers that can throw are @dsh-std/presentation and
+// @dsh-std/command, imported dynamically by activateProtocols. A throw from
+// this module makes the adapter's mountProfileComponents roll back EVERY
+// component it had already mounted in the profile, so those imports are
+// guarded and a missing peer degrades, never throws.
+
+const DEGRADED_MESSAGE =
+  'dsh-oc-tui is activated by its cordis bundle rows (cordis.patch.yml); '
+  + 'no live TUI instance is registered, so no protocol support is published.'
+
+const NO_DECLARED_SUPPORTS_MESSAGE =
+  'a Community v0.15 manifest cannot declare protocol supports, and the lifecycle '
+  + 'requires a declared support before a facet may stage one; no protocol support '
+  + 'is published. See the plan\'s blocking-findings section.'
+
+// Whether the last activate() staged nothing because the facet declares no
+// supports. Assigned on every activate path so a later activation with declared
+// supports clears it.
+let stagedNothing = false
+
+export default {
+  async activate(context) {
+    // A facet may only stage protocols that its OWN projection declares as
+    // supports: LifecycleCoordinator.stageProtocol throws
+    // `facet attempted to implement undeclared protocol ...` for anything else,
+    // and a throw here makes the adapter's mountProfileComponents roll back
+    // every component in the profile.
+    //
+    // A Community v0.15 manifest cannot declare supports at all — the schema
+    // rejects both `requires.supports` and a top-level `supports`, and
+    // projectManifest emits only `protocols.requires` — and nothing in
+    // adapter-dsh writes protocols.supports onto a facet either. So for this
+    // plugin the declared list is empty, and staging anything would throw. We
+    // therefore stage nothing and let snapshot() report why. If upstream ever
+    // lets a v0.15 component declare supports, this same code stages normally.
+    //
+    // No presence probe for @dsh-std/sdk: nothing in lib/ consumes it, and the
+    // only optional peer that can actually throw is @dsh-std/presentation,
+    // which activateProtocols guards itself. A probe here would silently
+    // suppress the registration whenever sdk alone is absent, even though
+    // nothing needs it.
+    if (declaredSupports(context).length === 0) {
+      stagedNothing = true
+      return
+    }
+    stagedNothing = false
+    const dispose = await activateProtocols(context)
+    context.scope.add(dispose)
+  },
+
+  async deactivate() {
+    // Everything is registered through context.scope, which the lifecycle
+    // coordinator disposes on deactivation. Nothing to do here.
+  },
+
+  async snapshot() {
+    const { liveTui } = await import('./bridge.js')
+    if (!liveTui()) return { state: 'degraded', message: DEGRADED_MESSAGE }
+    if (stagedNothing) return { state: 'degraded', message: NO_DECLARED_SUPPORTS_MESSAGE }
+    return { state: 'active' }
+  },
+}
+
+// The supports this facet's own projection declares, or [] when it declares
+// none. Matched on participantId first because it is unique per activation,
+// falling back to the facet name.
+function declaredSupports(context) {
+  const selected = context?.plan?.selected ?? []
+  const mine = selected.find((row) => row?.participantId === context?.identity?.participantId)
+    ?? selected.find((row) => row?.identity?.facet === context?.identity?.facet)
+  return mine?.facet?.protocols?.supports ?? []
+}
+
+// Each protocol lands in its own task; the list grows as they do.
+async function activateProtocols(context) {
+  const disposers = []
+  const disposeAll = () => {
+    for (const dispose of disposers.reverse()) {
+      try { dispose() } catch { /* teardown must not mask the original failure */ }
+    }
+  }
+
+  // Imported dynamically so a missing @dsh-std/presentation degrades this facet
+  // instead of throwing: a throw here makes the adapter's
+  // mountProfileComponents roll back every component it had already mounted.
+  let createPresentationImplementations
+  try {
+    ({ createPresentationImplementations } = await import('./std/presentation.js'))
+  } catch {
+    return disposeAll
+  }
+  // The adapter validates each staged implementation: it must expose `handle`,
+  // its participantId must equal this facet's activation participant id, and
+  // its protocol must equal the support it is staged with
+  // (packages/adapter-dsh/src/index.ts:1774).
+  for (const implementation of createPresentationImplementations(context.identity.participantId)) {
+    disposers.push(context.protocols.implement(implementation.protocol, implementation))
+  }
+
+  // lib/std/commands.js statically imports @dsh-std/command, which npm does not
+  // install (optional peer). A failed import degrades the command surface only:
+  // presentation stays published, and the disposer returned below still tears
+  // those registrations down.
+  let createCommandRuntimeImplementation
+  try {
+    ({ createCommandRuntimeImplementation } = await import('./std/commands.js'))
+  } catch {
+    return disposeAll
+  }
+  // The adapter validates the staged implementation and requires its
+  // participantId to equal this facet's activation participant id
+  // (packages/adapter-dsh/src/index.ts:1774).
+  const commandRuntime = createCommandRuntimeImplementation(context.identity.participantId)
+  disposers.push(context.protocols.implement(commandRuntime.protocol, commandRuntime))
+
+  return disposeAll
+}