v0.4.3

Changes

Features

• test(redlines): B20a 补「合成器与声明一致」（变异验证）；B30 已知限制拍板落纸 (#60) @zlZayn
• test(tools): D1 描述骨架断言收敛（保 B20a 照不到的一半）与 D4 重夹具工厂化 (#58) @zlZayn
• refactor(lib,tools): 清单剩余 src 侧轻度项 —— B10/B7/B8/A2 收敛、A7/D5 判定不修 (#57) @zlZayn
• refactor(lib,tools): A1/A3/A4 收敛到 errors.ts；修两处文档预存债 (#56) @zlZayn
• refactor(tools): B3 守卫兜底 keyText 与 B6 跨实例重试参数各归一处 (#54) @zlZayn
• refactor(tools): B4 spawn 失败判定与 B1/B2 取消语义各归一处 (#53) @zlZayn
• refactor(lib,tools): B5 relaunch 措辞与 A6 取错误码各归一处；B30 升级为落点映射 (#52) @zlZayn
• refactor(tools): 跨工具重复的渲染与通用助手收进 shared.ts (#50) @zlZayn

Documentation

• docs(notes): duplication-inventory 清单闭环 —— 全部项落地或判定 (#59) @zlZayn
• docs(notes): 修正 4 处状态行/状态与正文矛盾（doc-audit 发现） (#55) @zlZayn
• docs(shape): 技能冻结状态落纸并收敛到唯一真源；补 restart 不给参数的理由 (#51) @zlZayn
• docs: state per-tool carrier availability; correct the skill freeze (#49) @zlZayn

v0.4.2

Changes

Bug Fixes

• fix(restart): refuse on the Desktop carrier before writing anything (#48) @zlZayn

Documentation

• fix(restart): refuse on the Desktop carrier before writing anything (#48) @zlZayn
• chore(facade): add the banner to both READMEs, and adopt the new icon (#47) @zlZayn
• Distill the AGENTS.md pitfall ledger: one line each, evidence into notes (#46) @zlZayn

v0.4.1

Changes

Documentation

• Maintainer docs: finish the pnpm migration, add an index, move history into notes (#45) @zlZayn

v0.4.0

Changes

• feat: land dsh_restart, fix two fabricated conclusions, speed up port scanning (#40) @zlZayn
• feat(tools): add dsh_list_instances, fix timeout/diagnose/home, land the restart library half (#38) @zlZayn
• docs: rewrite the shape/architecture/host-contract set and correct the falsified claims (#39) @zlZayn
• docs: correct the falsified fiber claim, the redline wording, and drifting counts (#37) @zlZayn
• fix(dump-config): screen every diagnostic source, not just the ones that finished (#36) @zlZayn

Features

• Restart gate + settings card, and an English skill payload (#43) @zlZayn
• Give the two silent failures a way to speak up: win32 port fallback, restart recovery (#42) @zlZayn
• Migrate to pnpm; fix model-visible text and the restart verdict (#41) @zlZayn
• refactor(test): collapse duplicated helpers; feat(skill): document the write-side tools (#34) @zlZayn
• feat(ports): identify listeners on Windows, Linux and macOS (#33) @zlZayn
• feat(tools): dsh_sign_cookie — sign a browser-session cookie with the local key (#32) @zlZayn

Bug Fixes

• Give the two silent failures a way to speak up: win32 port fallback, restart recovery (#42) @zlZayn
• Migrate to pnpm; fix model-visible text and the restart verdict (#41) @zlZayn
• fix(release): retire the drafter's next draft after publishing (#35) @zlZayn
• fix(startup-log): parse double-quoted util.inspect args and never assign undefined (#30) @zlZayn

Documentation

• Restart gate + settings card, and an English skill payload (#43) @zlZayn
• Migrate to pnpm; fix model-visible text and the restart verdict (#41) @zlZayn
• refactor(test): collapse duplicated helpers; feat(skill): document the write-side tools (#34) @zlZayn
• docs: sync the redline ledger and align B26's lossless-JSON oracle with the host (#31) @zlZayn

v0.3.0

Changes

• fix(tools): diagnose 返回值非 lossless JSON（宿主拒收）+ B18a 堵「带 tool 空 args」死路 (#29) @zlZayn
• fix(tools): 守卫合成的兜底必须可渲染 —— 三处 keyText 不再抛（+ 红线 B25） (#28) @zlZayn
• test(redlines): 批 2b —— B17/B20a/B20b/B18a/B21/B24（含契约承载条件 B24） (#27) @zlZayn
• refactor(describe): 参数描述删掉上界（≤100），只判两条下界；质量归人工评审 (#26) @zlZayn
• feat(contract)!: 工具结果契约收敛为 {verdict,key,audit}，五个工具同批迁移 (#25) @zlZayn

v0.2.1

Changes

• release: 0.2.1（修 0.2.0 发空包的事故） (#23) @zlZayn
• docs(facade): 换 tagline —— 定位改成「让 agent 自检自修运行时」 (#24) @zlZayn
• fix(release): 发布链路补上 build —— 0.2.0 发出去的包里没有代码 (#22) @zlZayn
• docs(post-release): 挂上 SLSA 徽章 + 把「provenance 怎么验」写成判据 (#21) @zlZayn

v0.2.0

This is a Deprecated Release

Changes

• release: 0.2.0（bump，发布走 workflow） (#20) @zlZayn
• docs: 文档职责重排（计划/台账/设计拆开）+ 修过期事实与死指针 (#19) @zlZayn
• docs: 记真机两则 —— actionable 的字段是宿主按需带的；变异测试第二次用 (#18) @zlZayn
• docs(facade): 补 npm 版本徽标 + tagline 去掉「只读」这个已过期的定语 (#17) @zlZayn
• feat(contract): ToolFail 加可选 evidence —— 补上「失败分支没有放观测事实的地方」 (#16) @zlZayn
• docs(agents): 记坑 37 —— 「断言症状消失」不等于「断言根因修好」 (#15) @zlZayn
• test(hot-reload): 断言「缓存放回成功」，而不只是「没变成 internal」 (#14) @zlZayn
• fix(hot-reload): import 期失败不再被吞成 internal（根因确证到行）+ 剥 include: 前缀 (#13) @zlZayn
• test(redlines): 行号对齐修复（stripComments 保留换行）+ AGENTS 坑 36 (#12) @zlZayn
• test(redlines): 补 B15 的两条「已知限度」（共用逻辑与作用域边界） (#11) @zlZayn
• test(redlines): B10 改名（诊断半边只读）+ 新增 B15（写侧只许碰进程内树） (#10) @zlZayn
• chore(icon): 换用维护者提供的新版插件页图标 (#9) @zlZayn
• feat(v1.1): dsh_hot_reload —— 写侧第一个工具（+ 连带同步点） (#8) @zlZayn
• docs(notes): 写侧工具的工具边界 —— 分离为主，三处内聚 (#7) @zlZayn
• docs(plan): 收真机实验A 结论（三条判据全过）+ 四条实现陷阱；坑 20 按实测改写 (#6) @zlZayn
• test(redlines): B14 守住「src/** 的模型可见字符串不含 CJK」，并修掉它抓到的 3 处 (#5) @zlZayn
• docs(plan): 收真机实验B与契约核实结论；拉起形态按实测改写为两级 detached / 交给外部 (#4) @zlZayn
• docs(plan): 补读参考实现源码 + 本机运行时核对，把推断升级成可引用事实 (#3) @zlZayn
• docs(plan): v1.1 写侧两工具的设计计划与参考实现索引 (#2) @zlZayn

v0.1.0

dsh-plugin-debugging v0.1.0

First release. A read-only debugging toolkit for a running DSH instance: one skill plus four tools that answer "why did my change not take effect", "did that plugin actually load", "is this a dead port or a 401", and "what did the composition resolve to".

Tools

Tool	In one line
dsh_check_effect_mode	Which live-effect tier your change falls under — config, host code, or client code — and whether this profile's hmr is actually watching the patch files
dsh_diagnose_plugin_load	Whether a plugin is in bundles, how it is mounted, and what the Loader tree says; observed evidence (fiber.state, import-time failure) is kept separate from inferred evidence
dsh_check_auth	Connection refused (not running) versus 401 (running, not authenticated); the authority is a literal host:port match
dsh_dump_config	The composed config tree and its diagnostics; --dump-config always exits 0, so its exit code is not a gate

Skill

dsh-plugin-debugging (v2.1.4) carries the reasoning behind every check: the three live-effect tiers, installation forms, credential acquisition, process identification, and isolated instances. The tools are accelerators; where one is ambiguous, the skill text wins.

Verification

• 187 tests across 10 files pass; lint, format:check and the release-state checks are green; CI is green on main.
• "Read-only" is a redline rather than a slogan: v1 never edits a profile, never writes $DSH_HOME, and never kills a process.

Provenance

0.1.0 was published manually, so it carries no npm provenance attestation. Build provenance and the SLSA badge start with the next version, which ships through .github/workflows/release.yml and npm Trusted Publishing (OIDC).

---

dsh-plugin-debugging v0.1.0（中文）

首个版本。 给正在跑的 DSH 实例排障的只读工具包：1 个技能 + 4 个工具，回答「改完为什么没生效」「那个插件到底加载了没有」「这是端口没人听还是 401」「组合最后解析成了什么」。

工具

工具	一句话
dsh_check_effect_mode	你的改动属于哪一档生效方式（配置 / 宿主代码 / 客户端代码），以及这个 profile 的 hmr 是否真的在 watch patch 文件
dsh_diagnose_plugin_load	插件在不在 bundles、以什么形态挂上、Loader 树怎么说；观测到的证据（fiber.state、import 期失败）与推断出的证据分开报
dsh_check_auth	连接被拒（没启动）还是 401（服务在、认证没过）；authority 是逐字匹配的 host:port
dsh_dump_config	组合后的配置树与诊断；--dump-config 退出码恒 0，不能当门禁

技能

dsh-plugin-debugging（v2.1.4）载着每条判据背后的推理：三档生效方式、安装形态、凭证获取、进程识别、隔离实例。工具是加速器；工具含糊时以技能正文为准。

验证

• 187 个测试（10 个文件）全过；lint、format:check 与发布态不变量检查均绿；main 上 CI 绿。
• 「只读」是红线而不是口号：v1 不改 profile、不写 $DSH_HOME、不杀进程。

溯源

0.1.0 是手动发布的，因此没有 npm provenance 证明。构建溯源与 SLSA 徽章从下一个版本开始，那个版本走 .github/workflows/release.yml 与 npm Trusted Publishing（OIDC）。