super-dsh 0.1.12 → 0.3.0

package/node_modules/better-dsh/docs/50_test-reports/2026-10-03-schemastery-cosmokit/346/272/220/347/240/201/345/206/205/350/201/224/345/256/236/346/265/213/346/212/245/345/221/212.md

@@ -0,0 +1,63 @@
+# better-dsh：schemastery / cosmokit 源码内联实测报告（2026-10-03）
+
+- **对象**：better-dsh `0.2.5-a`（本地过程版本，未发布）——`@deepseek-ai/schemastery` 从 **optional peer** 改为 **源码内联**（`third_party/`），同批内联其运行时依赖 `@deepseek-ai/cosmokit` 与（类型only的）`@standard-schema/spec`。
+- **裁决**：user，2026-10-03 —— "这两个包直接抄进我们的源码里…这样我们就不必去看真实安装环境下它的上游到底在哪里、能不能够得着、解析路径对不对"。
+- **载体**：本机 dev 树 + 4999 rig（`.test/home/compat`，unit `dsh-4999-test123`，core dsh `0.2.0-rc.2`）。
+
+## 一、为什么要内联（与前序报告的取舍关系）
+
+[2026-10-02-schemastery依赖声明修复实测报告](2026-10-02-better-dsh-schemastery依赖声明修复实测报告.md) 记录过一次事故与一次撤回：
+
+- 事故：schemastery 曾是我们的 **`dependencies`** → pnpm 在 profile 里**实体化出第二份**并被 profile 锁文件冻在 **3.18.2** → `.volatile()`（3.18.3+）缺失 → `failover`/`compaction` 在**模块作用域**建 schema 时抛错，loader 记为 `failed to import`。
+- 撤回：当时结论是"DSH 已自带一份，ride-on-DSH 的插件不该再抄第二份"，改为 optional peer，让解析回落到 harness installation scope。
+
+**本次内联与那次撤回并不矛盾，因为失败模式不同**：
+
+| | 当年（dependencies） | 本次（third_party 源码内联） |
+|---|---|---|
+| 版本从哪来 | profile 锁文件 / 上游解析 | **本仓 `third_party/` 钉死** |
+| 会不会出现两份不同版本 | 会（宿主 3.18.4 vs profile 3.18.2） | 不会：我们只用自己这一份，且**不再声明该依赖** |
+| 解析路径依赖 | 强（walk-up / installation scope） | 无（相对路径 import，构建期内联） |
+
+即：把"解析到哪一份"这个变量彻底消掉，而不是把它交给环境的解析顺序。
+
+## 二、改动
+
+- 新增 `third_party/`（344K）：
+  - `third_party/schemastery/` = `@deepseek-ai/schemastery@3.18.4`（MIT，Copyright (c) 2021-present Shigma）原样副本；
+  - `third_party/schemastery/node_modules/@deepseek-ai/cosmokit/` = `@deepseek-ai/cosmokit@1.8.5`（同版权人）——放这一层是为了让 schemastery 自己的 `import "@deepseek-ai/cosmokit"` **就地解析**，不必改动 vendored 代码；
+  - `third_party/schemastery/node_modules/@standard-schema/spec/` = `1.1.0`（MIT，Copyright (c) 2024 Colin McDonnell），仅类型。
+  - **唯一自加文件**：`third_party/schemastery/lib/index.d.mts`（转发到包自带的 `lib/types/index.d.ts`，因为直接 import `.mjs` 不会走它的 `exports.types` 映射）。
+- `package.json` 增 `imports` 子路径映射 `#schemastery`（→ `./third_party/schemastery/lib/index.mjs`）；9 个源文件（`index` / `runtime` / `web-password` / `web-trust` / `mobile` / `compaction` / `remote` / `failover` / `url-schemes`）统一 `import z from '#schemastery'`。**（后续已改为物理 import 形态并删除 `src/schemastery.ts`：见 [2026-10-03-physical-import与llm-completion-ast相对路径修复实测报告](2026-10-03-physical-import与llm-completion-ast相对路径修复实测报告.md)）**
+- `package.json`：删除 `@deepseek-ai/schemastery` peer 声明与其 `peerDependenciesMeta` 条目（peer 59 条 → 58 条生效面）；`files` 增列 `THIRD_PARTY_NOTICES.md`。
+- 署名：`THIRD_PARTY_NOTICES.md`（包根，随 tarball 发布：清单 + MIT 全文 + 各权利人）、`third_party/README.md`（provenance、布局、升级步骤、为何内联）。
+- `.gitignore`：放行 `third_party/schemastery/node_modules/`（vendored 拷贝要入库）。
+
+## 三、验证
+
+1. **类型**：`tsc --noEmit`（host）与 `tsc -p tsconfig.client.json` 均 **0 错**。
+2. **构建**：`npm run build` 通过。产物 **JS 已内联**（`lib/schemastery-*.js` 分块，含 `createVolatile`/`isVolatile`）；运行时**无任何**裸 `@deepseek-ai/schemastery|cosmokit` 引用（仅 `.d.ts` 里保留裸类型引用——与改动前行为一致，非回归；类型面宿主本就供给该包）。
+3. **单测**：`vitest run` **57 文件 / 649 passed, 1 skipped**。
+4. **4999 rig（第一人称）**：
+   - 安装 `Packages: +1`（仍只加自己）；`deps`/`optional` 均为空，schemastery 已不在 peer 清单。
+   - **把 profile 树里的 `node_modules/@deepseek-ai/` 整个删掉**后启动：**零 `failed to import`、零 `did not activate`**；`--dump-config` 里 `dashr-failover` + `dashr-compaction-tuning` 两行在场——**正是当年挂掉的那两行**。
+   - rig 树里后来重新出现的 `@deepseek-ai/*` 来自 **profile 里的另一个插件 `corti-memory`**（其 `dependencies` 含 `@deepseek-ai/schemastery ^3.18.1`，lockfile 实证），与本插件无关：我们不再贡献该包。
+
+## 四、同批修掉的一个 crash 级 bug（本轮发现，非本次改动的目标）
+
+rig 停机日志出现：
+
+```
+dsh: fatal uncaught exception: Error: write EPIPE
+    at KernelTransport.send (…/better-dsh/lib/index.js)
+    at IpyKernelBridge.dispose
+    at DashrRuntime.teardownKernel
+```
+
+根因：round 2 新写的 `KernelTransport` 在 teardown 往**已死的 bridge stdin** 写 `shutdown`，`EPIPE` 以**异步 error 事件**到达，而没有 `error` 监听 → Node 升级为 uncaught exception（守护进程级）。修法：给 `child.stdin`/`stdout` 挂 error 监听（吞掉并把 transport 标死、结算 waiter），并把写操作收敛到 `writeLine()`：先查 `writable` 再写，失败抛普通 Error 而不是让管道错误逃逸。**实测**：重装后 boot + stop 全程日志零 `EPIPE`/`fatal uncaught`。
+
+## 五、未做 / 限制
+
+- **未发布**：按 AGENTS.md §〇，`npm publish` 需 user 单次明确放行。
+- ~~`.d.ts` 里仍以裸名引用 `@deepseek-ai/schemastery`~~ **已于同日解决**：改为物理 import 后，dts bundler 把 schemastery 类型内联进本地 declaration chunk，`lib/` 里既无 `#schemastery` 也无裸名——运行期与类型面双双自包含。
+- 升级 vendored 版本是**行为变更**（settings/config 全表面）：须跑全量单测 + 4999 第一人称后方可发版（步骤见 `third_party/README.md`）。

package/node_modules/better-dsh/docs/50_test-reports/2026-10-03-zero-npm-runtime-deps/345/256/236/346/265/213/346/212/245/345/221/212.md

@@ -0,0 +1,82 @@
+# better-dsh 归零 npm 运行时依赖 — 实测报告
+
+日期：2026-10-03 ｜ 规格：`docs/specs/zero-npm-runtime-deps/spec.md` ｜ 目标版本：`0.2.5-a`（本地过程版本，未发布）
+
+## 0. 一句话
+
+better-dsh 的 `dependencies` / `optionalDependencies` / `postinstall` **全部为空**（60 条 `peerDependencies` 契约保留）；真实安装器（DSH Plugin Manager 底层 pnpm）安装本插件现在只加 **1 个包**；REPL 的原生 ZMQ 依赖被换成 venv 内的 Python bridge；AST 的原生 `.node` 与 browser 的 puppeteer 由**我们自己的代码**在首次使用时自装/内联；任何一项失败只让该组件不可用。
+
+## 1. 起因（user 报告的真实现象）
+
+DSH UI Plugin Manager 安装 better-dsh 时卡住并显示：
+
+```
++ better-dsh 0.2.5-a
+Packages: +15 -71
+node_modules/zeromq install$ node ./script/install.js     ← 我们的 REPL 原生依赖（cmake 构建）
+Done in 3.7s using pnpm v11.7.0
+[WARN] GET …/@oven/bun-linux-aarch64-android/-/…-1.4.2.tgz error (UND_ERR_SOCKET). Will retry in 10 seconds.
+dsh: pnpm printed nothing for 600000ms and was terminated
+```
+
+定性：**不是构建错误，是超时**。Plugin Manager 对每条捕获输出的 pnpm 运行挂 600000 ms 静默上限（`packages/boot/plugin-manager/src/index.ts:184`），超时杀树并打印 `operations.ts:453` 那句。卡住的下载（Android/arm64 的 Bun 二进制）来自**同一 profile 里另一个插件**（`super-dsh@0.1.9 → bun@1.4.2`）：插件 profile 是一个共享 pnpm 工程，"装插件 X" = "重解整个 profile"，于是**别人的安装步骤能拖死我们的安装**。user 裁决：不再 declare 任何运行时依赖、不要 postinstall、不碰 npm/pnpm，二进制由组件自己按需自装。
+
+## 2. 改动清单
+
+| 组件 | 原依赖 | 现处置 |
+|---|---|---|
+| hashline（`diff`/`file-type`/`xxhash-wasm`） | npm 依赖 | `tsdown noExternal` 内联进 `lib/`（`file-type` 经 A/B 构建证明在改动前就已被 tree-shake，直接删） |
+| client（`use-sync-external-store`） | npm 依赖 | 早已内联进 `lib/client/index.js`，删除声明 |
+| REPL（`zeromq`） | npm 依赖 + **顶层静态 import**（缺原生模块 → **整个插件加载死**） | 声明删除；新增 `src/kernel-bridge.py`（venv 内 pyzmq/jupyter_client，stdio JSON lines）+ `src/kernel-transport.ts` |
+| browser（`puppeteer-core`） | npm 依赖 | 构建期内联（实测可拉起 Chrome）；保留 vendor 自装兜底 |
+| AST（`@oh-my-pi/pi-natives-*`） | 5 条 `optionalDependencies` | 声明删除；新增 `src/vendor.ts`，首次使用时自装到 `<packageRoot>/.vendor` |
+
+新增：`src/vendor.ts`（零依赖自装器：registry packument → sha512/shasum 校验 → 自写 tar+pax 解包 → `createRequire` 解析入口 → 递归闭包 + `os/cpu/libc` 平台过滤 → staging+rename 原子落盘）、`scripts/copy-kernel-bridge.mjs`（把 .py 拷进 `lib/`）。**全程无 `child_process`、无 npm/pnpm/npx 调用**。
+
+供给触发点：**守护进程 spin-up 自检**（原有，fire-and-forget）+ **首次使用 lazy**（`ensurePiNatives()` / `loadPuppeteer()` / venv lazy）。无 postinstall。
+
+## 3. 实测证据
+
+### 3.1 安装（真实安装器，rig profile）
+
+```
+web       Packages: +1   Done in 1.8s using pnpm v11.7.0
+headless  Packages: +1   Done in 858ms using pnpm v11.7.0
+```
+
+安装前后 profile 物理树零 `zeromq` / 零 `@oh-my-pi` / 零 `puppeteer`；插件照常加载，启动日志零错误，composed tree 含 `dashr-repl`。**这同时证明 fail-open：REPL 的原生依赖不在场，插件不再跟着死。**
+
+### 3.2 REPL（新传输层）
+
+- 直连冒烟（真实 ipykernel）：kernel_info ✅ / `print("SMOKE",6*7)` → `"SMOKE 42\n"` 流式 ✅ / 到 idle ✅ / **KERNEL_BOOTSTRAP 单元执行无错** ✅ / interrupt ✅ / dispose ✅。
+- host-request comm（新传输唯一未覆盖路径）：内核 `create_comm('dashr.host')` → iopub → Node → **control 通道** `comm_msg` 回包 → 内核 control-thread handler 解 future；cell 打印 `HOSTREPLY {'pong': True, ...}` ✅。
+- **4999 第一人称**（`dsh headless` 真实 session）：
+  - `eval` → `REPL_OK 42`；
+  - 同一 Python session 内 `await tool.bash({...})` → `HOST_OK\n`（宿主参数校验失败路径亦被触发）。
+
+### 3.3 AST（自装器）
+
+- 自装器单测：provision `@oh-my-pi/pi-natives-linux-x64@18.0.6`（2×163MB `.node`）→ **dlopen 成功**（exports `astGrep`/`astEdit`/…）→ 二次调用 reuse → `^18.0.0 -> 18.4.12`。
+- **4999 第一人称（最终产物）**：`dsh headless` 让 agent 用 `dvc://ast_grep` 搜 `loadPiNatives` → `totalMatches: 3 / filesWithMatches: 2 / filesSearched: 189`；同一时刻 `<plugin>/.vendor` 出现 **314MB** 的 `@oh-my-pi/pi-natives-linux-x64`，而 **profile 树里没有 `@oh-my-pi`** —— 证明二进制是我们自己下的。
+
+### 3.4 browser（puppeteer 内联）
+
+`lib/puppeteer-core-*.js` 导出 206 项（含 `launch`/`connect`）；用系统 Chrome 实测 `launch()` → `setContent` → `evaluate` 取回 `BUNDLED_PUPPETEER_OK`。
+
+### 3.5 构建卫生
+
+`tsc --noEmit` 0 错；`npm run build` 通过；产物除 peer 契约外无外部包引用（`zeromq` 彻底消失）；全量单测 **57 files / 649 passed, 1 skipped**。
+
+## 4. 过程中修掉的两个真 bug（都是本轮暴露、本轮修复）
+
+1. **bridge 静默死通道**：jupyter_client 反序列化后的 header `date` 是 `datetime`，`json.dumps` 抛异常且**在 pump 线程里静默打死整条通道**（现象："桥 ready 了但一条消息都没有"）。修法：`default=str` + 单条消息失败不许杀通道。
+2. **自装器锚点逃逸**：`findPackageDir(name, VENDOR_ROOT)` 会从 `.vendor` **向上走出**到 `node_modules`，破坏加载器"锚点有界"契约（单测 `ast-device.spec.ts` 抓到）。修法：vendor 走精确路径 `VENDOR_ROOT/node_modules/<name>`，且显式 `fromDir` 探测时**永不 provision**。
+   另修正 round 2 我引入的 `package.json` **重复 `puppeteer-core` 键**（已在清空依赖块时一并消除）。
+
+## 5. 未做 / 已知限制
+
+- **未发布**。按本仓红线，`npm publish` 需 user 单次明确放行。
+- 自装代码自担：版本钉死、sha512 校验、平台探测、并发去重（当前无锁：两个进程同时首用可能重复下载，后者被 rename 覆盖）、代理/离线行为。
+- AST 首次使用要下 ~314MB（上游包内含 baseline+modern 两个 CPU 变体，无法只取其一）。
+- `.vendor`/`.venv-kernel` 都在包目录内，**重装插件会重下**（与既有 venv 行为一致）。
+- 本机 rig 树里残留的旧 `@puppeteer`/`@oh-my-pi` 目录已手工清除（pnpm hoisted 树不回收无引用目录）。

package/node_modules/better-dsh/docs/50_test-reports/2026-10-04-ast-engine-deomp-0.2.5-d/345/217/221/345/270/203/351/252/214/346/224/266/346/212/245/345/221/212.md

@@ -0,0 +1,220 @@
+# better-dsh 0.2.5-d 发布验收报告（2026-10-04，rig 4998）
+
+- **被测物**: `better-dsh@0.2.5-d`（commit `4981254`，`feat(ast): surface silent failure modes as diagnostic fields`）
+- **环境**: 交付形态 tarball 安装位 rig，端口 **4998**，`DSH_HOME=.test/home/compat`，profile `web`；驱动 = 第一人称真实 session（HTTP RPC 两段形，与《2026-10-03-ast-engine-deomp-4999实测报告》§四/§五 同款 password-gate + `/api` 信封）
+- **发布状态**: **未发布**。`npm publish` 需 user 单独明确放行（AGENTS §〇 红线）；本报告 §五 给出 pre-flight checklist 与 `--dry-run` 证据，发布动作不在本任务内。
+
+---
+
+## 0. 一句话
+
+0.2.5-d 在 4998 rig 以交付形态（tarball remove→add）完成第一人称 live 验收：诊断契约三字段 `pathNotFound` / `overlapping` / `patternErrors` 全部在真实 session 里以原样 JSON 落实，`.vendor` 全程不重建、日志零 OMP/registry 行；一处处方偏差（任务给的"旧静默 pattern"实为单根 pattern，不触发 `patternErrors`）已用真 multi-root pattern 补测闭环，并给出引擎级根因。
+
+## 1. 0.2.5-d 内容物
+
+### 1.1 引擎替换回顾（0.2.5 系已完成，0.2.5-d 继承）
+
+- 原生 addon（`@oh-my-pi` / pi_natives，静默供给）→ **包内 WASM ast-grep 引擎**：`lib/ast-assets/` 16 文件（ast-grep.wasm + tree-sitter.wasm + 14 语言 grammar wasm），冷启动零外部供给——`.vendor` 目录全程不出现，rig 日志 `omp|oh-my-pi|registry` **0 命中**（本轮全文件 grep，40 行）。
+- 交付物延续 docs-packaging-trim 形态：tarball 5.1 MB / **733 文件**（shasum `5b3e3e35e25aaa34ef160035e027767975912217`）。
+- 引擎行为面已被 0.2.5 系列锁定：对齐 pattern 34/8/11（4999 首测 §4.4 / 4998 复测 §4.8.3 逐字段一致）、dryRun 默认拦截、真写盘-回滚闭环、14 语言 match matrix（`a2d32a5`）。
+
+### 1.2 诊断契约增量（0.2.5-d 本体 = commit `4981254`）
+
+对原生前辈三类静默失败（契约报告 A1/A3/A6）的**有意分歧**，契约见 `docs/20_specs/ast/spec.md` §41：
+
+| 字段 | 设备 | 语义 | 对应旧静默行为 |
+|---|---|---|---|
+| `patternErrors?: string[]` | 两者 | pattern 编译不成单根 AST 节点时逐条透出（`pattern <index> ("<pattern>"): <底层消息>`），健康 pattern 的 matches 照常返回；硬语法错误仍抛 `DVC_DEVICE_ERROR` | A1：multi-root pattern 伪装成 0 命中 |
+| `pathNotFound?: boolean` | 两者 | 解析后的 target root 不在盘上 → `true` | A3：路径不存在与真 0 命中不可区分 |
+| `overlapping?: number` | `ast_edit` | 重叠守卫丢弃的编辑计数（先入列 op 胜），仅 >0 时出现 | A6：守卫存在但计数不可见，遮蔽 op 静默消失 |
+
+另：两设备 summary 明示**无 workspace 边界检查**（边界 = approval/policy 层；A5 文档化处理）。
+
+## 2. 安装与站点证据
+
+- 构建：`npm run build`（tsdown + build-client + kernel-bridge + ast-assets，输出 `ast-assets: 16 files, 14.4 MB`）→ `npm pack` → `better-dsh-0.2.5-d.tgz`。
+- 安装（file: tarball 不刷新，**remove→add 一个来回**）：`plugin --profile web remove better-dsh` → `add …/better-dsh-0.2.5-d.tgz` → `Packages: +1`（pnpm 11.7.0）→ `PORT=4998 bash .test/seed/test123/start.sh`（unit `dsh-4998-test123` + `test123-lan-4998-relay`）。
+- 安装位核验：`package.json` version → **`"0.2.5-d"`**；`lib/ast-assets` → **16 文件**；`.vendor` → **ABSENT**（`ls` exit 2）。profile `package.json` 依赖行 `file:/home/u1/workspaces/dashr/better-dsh/better-dsh-0.2.5-d.tgz`。
+- 站点：password gate `POST / -d password=admin` → **303** + `dsh-auth-<hash>` cookie（HttpOnly）；boot graph 含 `"id":"better-dsh"`；`/plugins/??better-dsh/client.js&rev=4b9802368848` → **200**（29,700 B，= 安装位 `lib/client/index.js` 29,633 B + 服务端追加 sourceMappingURL 行，`cmp` 前缀逐字节一致）。
+
+## 3. 第一人称 live 实测（真实 session，六项）
+
+### 3.1 驱动过程与环境事件（透明记录）
+
+- 驱动：§四/§五 同款两段形——`POST /api/session/create`（`client-request` 信封，`request.cwd=/home/u1/workspaces/dashr`）→ `POST /api/session/prompt`（`mode:'queue'`）。会话日志 `.test/home/compat/sessions/--home-u1-workspaces-dashr--/session-f4122ee1-3dab-498b-9ff0-280b470afd2b/session.v4.jsonl.zstd`，全部结果为 `tool/result` 事件原样 JSON。
+- **QUOTA 事件**：前两个 session（`session-ac7f2999…`、`session-2ca4edea…`）首 turn 即 `Insufficient Balance`（HTTP 402 QUOTA）——rig 既有三条 LLM 路由全部欠费（`zai` ZAI_API_KEY / `deepseek-official` DEEPSEEK_API_KEY / `deepseek-openai` 存储 key）。**供给修复**：直连探测发现 ZAI **Anthropic 协议端点**（plan 订阅）可用而 paas 计费端点欠费，遂在 rig home patch（`cordis.patch.yml`，测试资产）新增 `zai-plan` provider 行（`api: anthropic-messages`，`baseURL: https://open.bigmodel.cn/api/anthropic`，`apiKeyEnv: ZAI_PLAN_API_KEY`，model `glm-4.7`），重启 rig 后 `session/selectModel` 指定该路由，turn 正常完成。**此为环境供给修复，不触及被测面**（被测面 = 包内 WASM 引擎 + 宿主 write dvc:// 路径，与 LLM 路由无关）。
+- 有效会话 `session-f4122ee1…`：2 turn、8 次工具调用（write dvc://×5 / bash×3），turn 1 与 turn 2 均 `reason.kind = "completed"`。
+
+### 3.2 (a) 旧静默处方 pattern —— 结果与任务预期不符（引擎级根因，见 §3.3）
+
+`write dvc://ast_grep`，content `{"patterns":["export function $NAME($$$ARGS)"],"path":"better-dsh/src/devices/ast"}`（seq 21 原样）：
+
+```json
+{
+  "matches": [],
+  "totalMatches": 0,
+  "filesWithMatches": 0,
+  "filesSearched": 11,
+  "limitReached": false
+}
+```
+
+**无 `patternErrors`，且这是 0.2.5-d 的正确行为**：该 pattern 在 WASM ast-grep 里编译为**单根**（`export function $NAME($$$ARGS)` 解析为一个合法但永不匹配的声明节点），不抛 `Multiple AST nodes are detected`，因此不属于 patternErrors 契约面。独立对拍：本地以 0.2.5-d 源码（vitest 直驱 `dispatchDvcWrite`，同 pattern 同形 fixture）返回**逐字段一致**的静默形态——rig 与源码零漂移。旧契约报告 §7 把此 pattern 的 0.2.5-c 静默归因为 MULTI_NODE 吞噬，系排除法推断，对 WASM 引擎不成立（真正的静默机制是该 pattern 单根但结构不全，永不匹配）。**规避口径不变：pattern 必须写完整节点**。
+
+### 3.3 (a2) 补充：真 multi-root pattern → `patternErrors` live（A1 分歧验收）
+
+`write dvc://ast_grep`，content `{"patterns":["const $A = $B\nconst $C = $D"],"path":"better-dsh/src/devices/ast"}`（两语句 = 双根；seq 74 原样）：
+
+```json
+{
+  "matches": [],
+  "totalMatches": 0,
+  "filesWithMatches": 0,
+  "filesSearched": 11,
+  "limitReached": false,
+  "patternErrors": [
+    "pattern 0 (\"const $A = $B\nconst $C = $D\"): Multiple AST nodes are detected. Please check the pattern source `const µA = µB\nconst µC = µD`."
+  ]
+}
+```
+
+`patternErrors` 1 条（index + pattern 原文 + 底层消息）、0 matches——与单测（`ast-device.spec.ts:258`）及 spec §45 的 WHEN/THEN 一致，A1 分歧在 live 落实。
+
+### 3.4 (b) 完整节点 pattern → 真命中
+
+`write dvc://ast_grep`，content `{"patterns":["export function $NAME($$$ARGS): $RET { $$$BODY }"],"path":"better-dsh/src/devices/ast","includeMeta":true,"limit":3}`（seq 28 原样，节选）：
+
+```json
+{
+  "matches": [
+    {
+      "path": "better-dsh/src/devices/ast/ast-device.ts",
+      "text": "export function registerAstDevices(registry: DvcRegistry = { registerDvcDevice }): void { … }",
+      "byteStart": 13399, "byteEnd": 13688,
+      "startLine": 310, "startColumn": 1, "endLine": 313, "endColumn": 2,
+      "metaVariables": { "NAME": "registerAstDevices", "ARGS": "[registry: DvcRegistry = { registerDvcDevice }]", "RET": "void", "BODY": "[registry.registerDvcDevice('ast_edit', …), registry.registerDvcDevice('ast_grep', …)]" }
+    },
+    { "path": "better-dsh/src/devices/ast/ast-reminder.ts", "text": "export function disposeAstReminders(sessionId: string): void { … }", "byteStart": 2063, "byteEnd": 2156, "startLine": 42, "…": "…（第 3 条 astFileNotice byteStart 3169，页共 3 条）" }
+  ],
+  "totalMatches": 13,
+  "filesWithMatches": 8,
+  "filesSearched": 11,
+  "limitReached": true
+}
+```
+
+**13/8/11 + `limitReached:true`（`limit:3` 分页）**，与旧契约报告 §7 对照实验的完整节点 13/8 完全一致；元变量四类捕获（NAME/ARGS/RET/BODY）齐全。
+
+### 3.5 (c) 不存在路径 → `pathNotFound`（A3 分歧验收）
+
+`write dvc://ast_grep`，content `{"patterns":["export function $N($$$A)"],"path":"no/such/dir"}`（seq 35 原样）：
+
+```json
+{
+  "matches": [],
+  "totalMatches": 0,
+  "filesWithMatches": 0,
+  "filesSearched": 0,
+  "limitReached": false,
+  "pathNotFound": true
+}
+```
+
+`pathNotFound:true` + `filesSearched:0`——与真 0 命中（§3.2 的 11 文件形态）可区分。✅
+
+### 3.6 (d) 重叠双 op → `overlapping:1`，仅首 op 落盘（A6 分歧验收）
+
+夹具 `.scratch/ast-tool-test/overlap-026.ts`（写前 md5 `fd021aa9ffa0389ba92a1320c6b9e4f3`，内容 `export function overlapTarget(x: number): number {\n  return x * 2\n}`）。`write dvc://ast_edit`，content `{"ops":[{pat:"export function $NAME($$$ARGS): $RET { $$$BODY }", out:"… { /*op1-applied*/ $$$BODY }"},{pat:"function $NAME($$$ARGS): $RET { $$$BODY }", out:"… { /*op2-dropped-overlap*/ $$$BODY }"}],"paths":[".scratch/ast-tool-test/overlap-026.ts"],"dryRun":false}`（seq 42 原样）：
+
+```json
+{
+  "changes": [
+    {
+      "path": ".scratch/ast-tool-test/overlap-026.ts",
+      "before": "export function overlapTarget(x: number): number {\n  return x * 2\n}",
+      "after": "export function overlapTarget(x: number): number { /*op1-applied*/ return x * 2 }",
+      "byteStart": 0, "byteEnd": 67, "deletedLength": 67,
+      "startLine": 1, "startColumn": 1, "endLine": 3, "endColumn": 2
+    }
+  ],
+  "fileChanges": [{ "path": ".scratch/ast-tool-test/overlap-026.ts", "count": 1 }],
+  "totalReplacements": 1,
+  "filesTouched": 1,
+  "filesSearched": 1,
+  "applied": true,
+  "limitReached": false,
+  "overlapping": 1
+}
+```
+
+`changes[]` 只含 op1；盘面复核（seq 49 会话内 `cat` + 会话外 md5 `eab9de680da668fbabe79c22a575c67c`）：
+
+```text
+export function overlapTarget(x: number): number { /*op1-applied*/ return x * 2 }
+```
+
+仅 `/*op1-applied*/` 在场，`/*op2-dropped-overlap*/` 未出现——先入列 op 胜 + 丢弃计数透出，与引擎守卫（`engine/edit.ts` 按 start 升序线性扫描）及单测（`ast-device.spec.ts:299`）一致。✅
+
+### 3.7 (e) `.vendor` 供给链复核
+
+全部 dvc 调用之后：`.test/home/compat/profiles/web/node_modules/better-dsh/.vendor` → **ABSENT**（会话内 seq 56 `ls` 报 `No such file or directory`；会话外复核 exit 2）；`lib/ast-assets` 仍 **16 文件**（seq 56 会话内 `wc -l` = 16）。rig 日志 `grep -icE "omp|oh-my-pi|registry"` → **0**。✅
+
+### 3.8 源码树不变量
+
+`git status --short -- better-dsh/src better-dsh/test better-dsh/package.json` → **空**（live 写盘仅落在 gitignored `.scratch/` 夹具，符合预期）。
+
+## 4. 构建卫生（非验收，记录用）
+
+| 项 | 结果 |
+|---|---|
+| `tsc --noEmit`（host） | **0 错误**（exit 0） |
+| `tsc -p tsconfig.client.json`（client） | **0 错误**（exit 0） |
+| `npx vitest run` | **65 文件 / 705 passed + 1 skipped（706）**，169 s |
+
+## 5. `npm publish` pre-flight checklist（发布闸门，未执行发布）
+
+按 AGENTS §〇：a（本报告第一人称实测）✅ → b（报告落盘）✅ → c（**user 明确放行，待办**）→ d（publish）。当前到 b 为止。
+
+- [x] **registry 目标**: `npm config get registry` → `https://registry.npmjs.org/`；whoami → `pgmi-builds`
+- [x] **版本**: `package.json` `name: better-dsh`, `version: 0.2.5-d`（与安装位一致）
+- [x] **files 列表**: `lib`、`THIRD_PARTY_NOTICES.md`、`docs`、`dsh-docs`、`cordis.patch.yml`、`eval-description.md`、`url-schemes-instruction.md`、`scripts/kernel-provision.mjs`
+- [x] **`npm publish --dry-run`**（未发布，输出尾 8 行原样）：
+
+```text
+npm notice === Tarball Details ===
+npm notice name:          better-dsh
+npm notice version:       0.2.5-d
+npm notice filename:      better-dsh-0.2.5-d.tgz
+npm notice package size:  5.1 MB
+npm notice unpacked size:  27.0 MB
+npm notice shasum:        5b3e3e35e25aaa34ef160035e027767975912217
+npm notice total files:   733
+npm notice
+npm notice Publishing to https://registry.npmjs.org/ with tag latest and default access (dry-run)
+```
+
+- [x] 干跑确认：尾行带 `(dry-run)`，registry 无任何足迹。
+- [ ] **user 放行后**：`npm publish`（真实动作）→ tag `v0.2.5-d`（GitHub 侧可逆，随发布节奏）。
+
+## 6. 偏差与关注项
+
+1. **处方 (a) 预期未按字面达成（已闭环）**：任务处方的 `export function $NAME($$$ARGS)` 不触发 `patternErrors`——单根 pattern 永不匹配≠multi-root 编译失败；本地 0.2.5-d 源码对拍逐字段一致，判定为**处方对旧 §7 根因推断的继承误差**，非产品缺陷。A1 验收由 (a2) 真 multi-root pattern 补齐。建议：后续文档/指引里把"完整节点"口径与"multi-root 才报 patternErrors"口径并列写清（单根残缺 pattern 仍是静默 0 命中，属引擎语义）。
+2. **rig LLM 路由欠费**：三条既有路由 402 QUOTA；本轮以 `zai-plan`（Anthropic 端点）provider 行修复并留作 rig 默认（`agent-default-model` 现为 `zai-plan/glm-4.7`，原 `zai/glm-5.3-flash` 已欠费不可用）。rig home patch 为测试资产，该行建议保留至 paas 路由充值。
+3. **`filesSearched` 双形态口径**（旧 A4，未变）：目录遍历跳过非代码文件、显式单文件计入——§3.2（11）与 §3.6（1）的数字口径不同属设计内。
+4. 首个 QUOTA 失败 turn 的会话（`ac7f2999`/`2ca4edea`）留在 rig home sessions 内，随 home 复用自然沉淀。
+
+## 7. 复现
+
+```bash
+cd ~/workspaces/dashr/better-dsh && npm run build && npm pack
+cd ~/workspaces/dashr
+DSH_HOME=$PWD/.test/home/compat node upstream/deepseek-harness/apps/cli/lib/bin.js plugin --profile web remove better-dsh
+DSH_HOME=$PWD/.test/home/compat node upstream/deepseek-harness/apps/cli/lib/bin.js plugin --profile web add $PWD/better-dsh/better-dsh-0.2.5-d.tgz
+PORT=4998 bash .test/seed/test123/start.sh
+# 认证 + RPC 两段形：POST /（password gate 铸 cookie）→ /api/session/create → /api/session/selectModel（zai-plan/glm-4.7）→ /api/session/prompt（queue）
+# 会话日志：.test/home/compat/sessions/--home-u1-workspaces-dashr--/session-f4122ee1-…/session.v4.jsonl.zstd（seq 21/28/35/42/49/56/74）
+```
+
+## 0.2.5-d 重打包说明（无重验）
+
+版本串按 user 指令从 0.2.6 改为 0.2.5-d。**未重跑 rig 验证**：改动仅为 `package.json` 的 `version` 字段，不触及任何已验证面。等价性证据：重打包后 tgz 内 `lib/` 65 个文件与 0.2.6 验证轮的构建产物 sha256 逐文件一致（清单比对），即发布的就是验证过的那个产物。

package/node_modules/better-dsh/docs/50_test-reports/2026-10-04-ast_grep/344/270/216ast_edit/345/245/221/347/272/246/344/270/216/350/276/271/347/225/214/345/256/236/346/265/213/346/212/245/345/221/212.md

@@ -0,0 +1,151 @@
+# `dvc://ast_grep` / `dvc://ast_edit` 契约与边界实测报告（2026-10-04，4998 rig）
+
+- **被测面**: `dvc://ast_grep`、`dvc://ast_edit`（better-dsh ast 设备）
+- **环境**: trimmed 安装位 rig，端口 **4998**，`DSH_HOME=.test/home/compat`，安装位 `better-dsh@0.2.5-c`（docs 已瘦身）；文件策略 `danger-full-access`、approval `never`（无审批/沙箱旁路干扰，探针所见即设备行为）
+- **方法**: 在一次性夹具上跑 **20 项探针**，每项都做**盘面复核**（`cat` / `md5sum`）而非只看返回值
+- **与前序报告的关系**: `2026-10-03-better-dsh-tool-surface-repl-dvc-browser-ast-lsp-4999实测报告.md` 的 §4/§5 是**面**的覆盖（设备能不能用）；本篇是**契约与边界**面（参数语义、错误路径、跨语言、越界、分页），并关闭其 §9 遗留项 `dvc://ast_edit 相对路径未复测`
+- **判定**: 两设备功能面 **全绿**（19/20 行为符合预期）；新增 1 条**错误静默**行为面（A1），非功能缺陷但属可用性/可诊断性缺口
+
+---
+
+## 0. 一句话
+
+`ast_grep` / `ast_edit` 在 trimmed 安装位上功能完整（AST 级匹配、元变量、分页、多语言、目录递归、dryRun 默认安全、真写盘字节级正确）；主要风险不在功能而在**失败模式的静默**——0 命中、坏 pattern、路径不存在三者返回值不可区分。
+
+## 1. 被测面口径
+
+两个设备都用「对设备 URI 执行 `write`」的方式驱动，args 为 JSON 对象：
+
+- `ast_grep`: `{patterns: string[], path?, offset?, limit?, includeMeta?}`
+- `ast_edit`: `{ops: [{pat, out}], paths: string[], dryRun?}`
+
+## 2. 夹具与不变量
+
+夹具 `.scratch/ast-tool-test/`：`sample.ts`（TS，含 interface/function/箭头函数/legacy function）、`sample.py`（def/class/print）、`notes.md`、`data.json`。
+
+| 文件 | 初始 md5 | 终态 md5 |
+|---|---|---|
+| `sample.ts` | `adfa9abc6ac2e1340cb8812a6b07e6ff` | `0af459a01c4eae5619950ca88ae3160f` |
+| `sample.py` | `e75c4312a714c0e9dd4f05da0146fa05`（首改后） | `e75c4312a714c0e9dd4f05da0146fa05` |
+| `notes.md` / `data.json` | — | 全程未变 |
+
+**不变量结论**：dryRun 期盘面零改动；真写盘期仅目标文件变化；**零命中真写盘后 md5 与写前逐字节相同**（无空改/重排版）。
+
+## 3. `ast_grep` 探针矩阵
+
+| # | 探针 | 结果 |
+|---|---|---|
+| 1 | 5 pattern 同发（其一带故意不匹配项），`includeMeta:true` | ✅ 4 命中，`totalMatches:4`；`metaVariables` 正确（`NAME`/`MEMBERS`/`A`/`ARGS`/`BODY`） |
+| 2 | 省略 `path` | ✅ 基准 = **进程 cwd**，扫 **313** 文件；`node_modules` / `.git` 被静默跳过 |
+| 3 | 目录 + 正命中 pattern | ✅ 196 文件扫出 15 命中；`limit:3` 时 `limitReached:true` |
+| 4 | `offset:3, limit:3` | ✅ 返回**第 4–6 条**，与第 1 页不相交（分页真实生效） |
+| 5 | Python 语法 pattern（`def`/`print`） | ✅ 命中；**语言由扩展名推断** |
+| 6 | `includeMeta` false / true | ✅ 两形态均正确 |
+| 7 | 不存在的文件 | ⚠️ **不报错**，`filesSearched:0`、零命中 |
+| 8 | 畸形 pattern | ⚠️ **不报错**，零命中，`filesSearched:1` |
+| 9 | 缺 `patterns` | ✅ 硬报错：`` `patterns` must be a non-empty array of strings `` |
+
+**目录扫描语义**（由 #2 #3 与 §5 交叉验证）：
+
+- 目录遍历时 `.md` / `.json` **不进搜索集**（`better-dsh/src` 196 文件 vs 显式传单文件时把非代码文件也算 1）
+- 显式传单个非代码文件时会计入 `filesSearched`（**计数语义在两种调用形态下不可比**，见 A4）
+- `totalMatches` = 全量命中数；`limitReached:true` 只表示**返回页被截断**
+
+## 4. `ast_edit` 探针矩阵
+
+| # | 探针 | 结果 |
+|---|---|---|
+| 10 | **省略 `dryRun`** | ✅ 默认 `true`：`applied:false`，md5 未变（fail-safe 默认） |
+| 11 | `dryRun:false`，2 条 op | ✅ 两条均落盘；md5 `adfa…`→`0af4…`，`cat` 复核 `console.log(msg)`→`logger.info(msg)`、`function legacyThing` → 箭头函数 |
+| 12 | Python 文件 | ✅ `print(...)` → `sys.stderr.write(...)` |
+| 13 | `paths` 传**目录** | ✅ 递归生效，`filesSearched:2` |
+| 14 | `paths` 传**绝对路径（workspace 之外 `/tmp`）** | ✅ 直接写入成功；返回 `path` 为未规范化的 `../../../../tmp/…` |
+| 15 | **重叠** op（两 pattern 命中同一节点） | ✅ 先入列者胜；**遮蔽的 op 静默消失**（源码有重叠守卫，见 A6） |
+| 16 | 不存在的路径 | ⚠️ `applied:true`、零改动、**不报错** |
+| 17 | 畸形 pattern | ⚠️ `applied:true`、零改动、**不报错** |
+| 18 | 缺 `paths` | ✅ 硬报错：`` `paths` must be a non-empty array of strings `` |
+| 19 | 真写盘但零命中 | ✅ 文件**逐字节未变**（无重排版/空改） |
+
+## 5. 交叉验证（防假阴性）
+
+对 #3 的**零命中**结果做了独立 ground truth 核对，防止把「工具坏了」误判成「确实没有」：
+
+```bash
+grep -rn 'console\.log' better-dsh/src | wc -l     # → 0（与 ast_grep 结论一致，非假阴性）
+grep -rn 'export function' better-dsh/src/devices/ast | wc -l  # → 10
+```
+
+经验法则：**`totalMatches:0` 但 `filesSearched>0` 时，先 grep 证明目标是否存在，再检查 pattern 是否完整节点。**
+
+## 6. 发现清单
+
+| ID | 严重度 | 面 | 现象 | 建议 |
+|---|---|---|---|---|
+| **A1** | 中（可诊断性） | 两者 | **不完整 AST 节点 pattern 静默零命中**。见 §7 根因分析 | 把 `Multiple AST nodes are detected` 透出为 `unavailable`/`patternError` 字段，而非回落空结果 |
+| **A2** | 低（语义） | `ast_edit` | `applied` = 「本次不是 dryRun」，**不等于「有文件被改」**：#16/#17 零改动仍回 `applied:true` | 改名或补 `changed:boolean`；判定用 `filesTouched`/`totalReplacements` |
+| **A3** | 中（可诊断性） | 两者 | **三类失败不可区分**：真实零命中 / 坏 pattern / 路径不存在，返回值形状一致 | 至少区分「路径不存在」（#7 #16 已有 `filesSearched:0` 可作信号，但未标错） |
+| **A4** | 低（语义） | `ast_grep` | `filesSearched` 两形态不可比：目录遍历跳过非代码文件，显式传单文件却计入 | help 里明确计数口径 |
+| **A5** | 中（安全面） | `ast_edit` | **无 workspace 边界**：绝对路径可写 workspace 之外（#14 `/tmp` 实测成功），且返回路径未规范化 | 明确「设备无沙箱，边界由 approval/policy 层负责」；或规范化显示路径 |
+| **A6** | 观察（正面） | `ast_edit` | 重叠编辑有**显式守卫**（`src/devices/ast/engine/edit.ts` 内按 start 升序线性扫描 + `overlapping` 计数），先入列 pattern 胜——**非未定义行为**；但该计数**未出现在设备返回体中**，故从 API 看仍表现为静默 | 把 `overlapping` 透出到返回值 |
+
+## 7. A1 根因分析（不完整节点 pattern）
+
+**触发**：`{"patterns":["export function $NAME($$$ARGS)"],"path":"better-dsh/src/devices/ast"}` → `totalMatches:0`、`filesSearched:11`。
+
+**根因（代码路径排除法）**：`src/devices/ast/engine/match.ts` 中 `findInSource` 的 `root.findAll(pattern)` 外包了一层 catch：
+
+```ts
+} catch (error) {
+  if (error instanceof Error && error.message.includes(MULTI_NODE)) return { matches: [], unavailable: false }
+  throw error
+}
+```
+
+`MULTI_NODE = 'Multiple AST nodes are detected'`（同文件 :13）。该 catch 是**唯一**回落为空的分支，其余错误一律 rethrow（设备层会显式报错，如 #9/#18 所见）。既然 #A1 与 #17 都没有报错、只回空结果，**只能**是命中该分支：pattern 只写了签名（缺函数体），不是完整 AST 节点，ast-grep 抛 `MULTI_NODE` 后被吞掉并伪装成「无命中」。同族处理见 `engine/edit.ts:55`（`continue` 跳过）。
+
+**对照实验（同目录，同一设备）**：
+
+| pattern | 结果 |
+|---|---|
+| `export function $NAME($$$ARGS)`（用户处方，不完整节点） | `totalMatches: 0`（静默） |
+| `export function $NAME($$$ARGS) { $$$BODY }` 等三条完整节点 | **`totalMatches: 13` / `filesWithMatches: 8`** |
+
+**规避**：pattern 必须写成**完整 AST 节点**；0 命中时先按 §5 交叉验证。
+
+## 8. 相对路径基准（前序 F1 复验）
+
+前序报告 F1 记录：相对 `path` 基准 = harness 进程 cwd，`"better-dsh/src"` 直接 `Path not found`。该问题已在 `2026-10-03-physical-import与llm-completion-ast相对路径修复实测报告.md` §三 修复（基准改为会话 workspace）。
+
+**本轮复验（trimmed 安装位 0.2.5-c）**：`path:"better-dsh/src"`、`path:".scratch/ast-tool-test/..."` 等**相对路径全部直接可用**，扫 196 / 1 文件均符合 workspace 基准预期；`paths` 侧同样通过。**F1 判定：已修复，本轮无回归。** 前序 §9 遗留项「`dvc://ast_edit` 相对路径未复测」**关闭**。
+
+## 9. 未覆盖 / 遗留
+
+- 未测 `.tsx/.jsx/.go/.rs` 等其余 grammar（仅验 TS + Python 两语言）
+- 未测 `include`/`glob` 过滤与 `maxFiles`(默认 1000) 上限边界
+- 未测 `parseErrors[]` 路径（未构造语法错误文件）
+- 未测超大文件/超多文件下的性能与截断行为
+- **未改任何源码**：本篇只记录行为面；A1/A2/A3/A5/A6 若要收，属 `better-dsh/` 源码变更，须走 build → rig 实测 → 报告 → 发布的老闸门
+
+## 10. 复现
+
+```bash
+# 夹具
+mkdir -p .scratch/ast-tool-test && cat > .scratch/ast-tool-test/sample.ts <<'EOF'
+export function describeProbe(cfg: { name: string }): string {
+  console.log(cfg.name)
+  return cfg.name
+}
+function legacyThing(a, b) { return a + b }
+EOF
+
+# A1 对照：不完整节点 vs 完整节点（在任意 4998/4999 会话内对 dvc:// 设备 write）
+# ① {"patterns":["export function $NAME($$$ARGS)"],"path":"better-dsh/src/devices/ast"}          → totalMatches:0（静默）
+# ② {"patterns":["export function $NAME($$$ARGS) { $$$BODY }"],"path":"better-dsh/src/devices/ast"} → totalMatches:13
+
+# dryRun 默认安全复验：省略 dryRun → applied:false，随后 md5sum 应不变
+# {"ops":[{"pat":"console.log($A)","out":"logger.info($A)"}],"paths":[".scratch/ast-tool-test/sample.ts"]}
+```
+
+---
+
+**发布闸状态**：本篇为**观察性实测**，不含 `better-dsh` 版本变更；`npm publish` 不在范围内（按根 AGENTS.md 〇节，仍需 user 单次明确放行）。

package/node_modules/better-dsh/docs/50_test-reports/2026-10-06-authentication-only-web-admission-4999.md

@@ -0,0 +1,63 @@
+# 2026-10-06 authentication-only Web admission — 4999 实测
+
+## 结果与范围
+
+本地测试包 `better-dsh@0.2.5-e` 已通过 tarball 的 `dsh plugin add` 安装到
+`.test/home/compat/profiles/web`。运行实例为 `dsh-4999-test123`，原测试 home、
+会话和共享 credential seed 保留，未触碰生产 3080/3081 或 Caddy 配置。
+未发布 npm；user 于 2026-10-06 确认测试「looks good」并授权在本地 main 提交。
+
+测试开启 `dashr-web-trust.config.trustAllHosts: true`。该模式仅包装原生
+Connection 实例的 `requestRejection`，通过公开 `authorizeIndex` 接口委托
+cookie 校验，不复制认证实现、不访问 private 字段、不修改上游。传入真实
+Host/Cookie 与固定无 query 的 index 路径，API 准入不会执行 token 铸 cookie。
+
+浏览器初始化脚本在任意 hostname 设置 `ownsHost: true`，已有 transport 保留。
+默认仍为 `trustAllHosts: false`。关闭/卸载模式恢复原生地址检查，页面能力需刷新。
+
+## 网络与登录
+
+- 原生服务器监听 `127.0.0.1:4999`；现有 socat 中继监听 `192.168.31.130:4999`。
+- 实际运行 argv 无 `--trusted-host`，没有给测试进程传入 `DSH_TRUSTED_HOSTS`。
+- HTTPS 入口为 `https://test.pc.randomhash.app/`，沿用已有 Caddy。
+- 本 test profile 禁用 `dashr-web-password`，以验证原生 token URL 登录；生产未变。
+- launcher 允许 `TRUSTED_HOSTS=''` 显式省略 CLI 名单。原生/clean rig 默认仍由
+  CLI 放行 loopback、LAN 与测试域名。
+
+## 运行时验证
+
+每个入口先以本次 launch token 完成原生 303 cookie 交换，再读取 HTML 与 RPC。
+额外的 unlisted Host 通过 loopback 连接模拟，未修改 DNS、服务器名单或代理。
+
+| 入口 | 页面 | 模型列表/可配置 provider | 插件列表 | 设置描述 |
+|---|---|---|---|---|
+| loopback | 200 | 通过 | 通过 | 通过 |
+| LAN | 200 | 通过 | 通过 | 通过 |
+| unlisted | 200 | 通过 | 通过 | 通过 |
+| HTTPS | 200 | 通过 | 通过 | 通过 |
+
+- 各入口 HTML 均有 all-host `ownsHost` 初始化脚本。
+- 未列入名单的请求携带不匹配 Origin 与 cross-site Fetch-Metadata，认证后仍成功。
+- LAN 与 unlisted 请求分别验证：缺失、篡改、其他 authority 的 cookie 均为 401。
+- 真实 `/api/remote.mux` WebSocket upgrade：unlisted Host + 跨域 Origin，认证后 101，
+  未认证 401。
+- HTTPS `settings/mutate` 将测试字体 17 改为 18，描述接口读回 18 且 profile 文件
+  持久化；之后按 revision 恢复 17 并复验。未改模型凭据。
+
+## 静态与自动测试
+
+- LSP 核实 Connection capability 定义、web-trust 的引用；TypeScript AST 核实脚本
+  生成与插件 apply 结构。
+- TDD：新增准入测试先复现 403，页面全地址测试先复现缺失 ownsHost；实现后通过。
+- 定向测试 16/16；包含原生 Connection 的认证、native cookie lifetime 与卸载恢复。
+- 全量 66 个测试文件通过：709 passed、1 skipped。
+- host/client typecheck 通过，构建与 pack 通过，launcher `bash -n` 通过。
+- 构建保留既有 puppeteer 相关 `eval` / 可选 `yauzl` 警告；不在本次准入改动范围。
+
+## 验收与交接
+
+当前 Computer Use 没有可用浏览器，接口验证不等于 UI 操作验收。
+user 已确认测试效果可接受。4999 实例保持运行，测试 tarball 是 profile 的本地依赖来源，
+交接时保留但不入库。仅提交本次代码、测试、rig 指引与文档，不发布 npm。
+生产 profile 仅移除旧 `dashr-repl` trustedPageAuthorities 覆盖，Python 配置继承 bundle，
+不安装测试包、不重启生产。备份保存在 `/tmp/dashr-prod-cordis.patch.before-cleanup-20261006.yml`。