dsh-pstack 0.2.0-beta.3 → 0.2.0

package/README.md

@@ -52,7 +52,7 @@ Most upstream pstack skills declare `disable-model-invocation: true`. `poteto-mo
 See [`pstack/README.md`](./pstack/README.md) for the full capability map, gaps, and acceptance status.
 
 > [!IMPORTANT]
-> This release targets DSH `0.2.2-alpha.2` or newer and requires Node.js `>=24.21.1`. `engines.dsh` is the range `>=0.2.2-alpha.2`: newer DSH versions are assumed compatible, and the requirement is only raised after a fix to the port is needed. See [Compatibility](#compatibility) before installing or upgrading.
+> Requires DSH `>=0.2.1-rc.5` and Node.js `>=24.21.1`. Newer DSH versions remain supported by default; only confirmed incompatibilities are listed in [Compatibility](#compatibility).
 
 ## Quick start
 
@@ -72,7 +72,7 @@ See [`pstack/README.md`](./pstack/README.md) for the full capability map, gaps,
    /setup-pstack
    ```
 
-   This command reads the providers, models, and reasoning efforts available in the current deployment. It writes them to `$DSH_HOME/pstack-models.mdc`. Without this file, every role inherits the parent's routing.
+   This command reads the providers, models, and reasoning efforts available in the current deployment. It writes them to `$DSH_HOME/pstack-models.mdc`. Without this file, every role inherits the parent's routing. After setup, the same values can be viewed and edited on **Plugins → Installed plugins → dsh-pstack**.
 
 ### Common entry points
 
@@ -86,6 +86,7 @@ See [`pstack/README.md`](./pstack/README.md) for the full capability map, gaps,
 | `/statechart` | Checks state models with TLA+ and TLC, and outputs a Mermaid state diagram. |
 | `/show-me-your-work` | Maintains a TSV decision log and audits the current work. |
 | `/retro` | Reviews a coding session's environment. |
+| `/docs-drift` | Audits project-discovered documentation; `report` is read-only, while `fix` repairs approved findings. |
 
 ## Capabilities
 
@@ -100,6 +101,12 @@ See [`pstack/README.md`](./pstack/README.md) for the full capability map, gaps,
 
 The `poteto-agent` and `comment-sicko` presets handle implementation delegation and read-only comment review. `pstack_script` can run five bundled scripts: `check-plan`, `watch-pr`, `worktree-audit`, `log`, and `statechart`. The script ids form a closed enum and cannot be used to build arbitrary paths.
 
+### Plugin configuration entry
+
+![Click Configure in the Plugins page header](assets/pstack-config-entry.png)
+
+Open **Plugins → Installed plugins → dsh-pstack** and click **Configure** in the bundle page header to open the configuration dialog.
+
 ## Skills directory
 
 `skills/` is not an upstream pstack directory. It contains skills that pstack does not provide but real projects need. The source directories are `skills/authored/` and `skills/.agents/skills/`. The build publishes them to `dist/skills/authored/` and `dist/skills/vendored/`. `vendored` preserves open-source upstreams verbatim, while this repository maintains `authored`. References from pstack skills do not change these inclusion criteria.
@@ -111,6 +118,7 @@ The `poteto-agent` and `comment-sicko` presets handle implementation delegation
 | `authored` | `decision-write` | Writes, lands, and supersedes decision records in Draft and Land modes, requiring `Status` and `Implemented-by` to appear together. | Adds the decision lifecycle that real projects often lack. |
 | `authored` | `decision-audit` | Read-only audit of decision-record routing, status, scope, anchors, and supersession relationships. | Keeps decision records searchable and reviewable over time. |
 | `authored` | `setup-project-docs` | Sets up architecture, glossary, decisions, and the root `AGENTS.md` pointers, and can be run repeatedly to fill gaps. | Gives a new project a sustainable documentation entry point. |
+| `authored` | `docs-drift` | Discovers maintained documents through project pointers, checks implementation drift, contradictions, terminology, links, redundancy, and unsupported elaboration, and repairs approved findings. | Adds periodic documentation inspection and controlled cleanup without assuming a fixed document layout. |
 
 `vendored` skills come from `mattpocock/skills@59db609eb1e18aaf59b63284d0e52255aff0c63c`. [`skills/skills-lock.json`](./skills/skills-lock.json) records their sources, paths, and hashes. Both skill trees ship with the package, but they do not correspond to upstream pstack versions.
 
@@ -154,11 +162,16 @@ Choose one of three browser providers: `@deepseek-ai/dsh-experimental-browser-us
 
 | Item | Version | Notes |
 |---|---|---|
-| DSH | `>=0.2.2-alpha.2` | Baseline `0.2.2-alpha.2`; newer versions are assumed compatible until the port needs a fix |
+| DSH | `>=0.2.1-rc.5` | Minimum supported version; verified through the `0.2.2-alpha.2` baseline |
 | pstack | `0.15.36` | Upstream baseline commit `4dd1d05` |
 | Node.js | `>=24.21.1` | Runtime requirement |
 | Cordis | `~4.0.6-alpha.1` | Peer dependency |
 
+> [!NOTE]
+> **DSH version support:** `engines.dsh` accepts every version `>=0.2.1-rc.5`, including newer prereleases. Routine DSH upgrades require no changes here. Add an entry only when a specific version is confirmed unsupported; raise the minimum only when a port fix requires it.
+>
+> **Known incompatible DSH versions:** None.
+
 Before upgrading DSH, verify experimental plugin package names, tool names, and configuration in a test profile. Upgrading upstream pstack requires regenerating the tree and rechecking the adaptation table.
 
 > [!CAUTION]

package/README.zh.md

@@ -52,7 +52,7 @@
 完整能力映射、缺口和验收状态见 [`pstack/README.md`](./pstack/README.md)。
 
 > [!IMPORTANT]
-> 此版本以 DSH `0.2.2-alpha.2` 为基准、要求 Node.js `>=24.21.1`。`engines.dsh` 为 `>=0.2.2-alpha.2` 范围：默认认为更高版本兼容，只有移植内容需要修复时才提高版本要求。安装或升级前请先查看 [兼容性](#兼容性)。
+> 要求 DSH `>=0.2.1-rc.5`、Node.js `>=24.21.1`。默认支持更高版本的 DSH；只有确认不兼容的版本才会列入 [兼容性](#兼容性)。
 
 ## 快速开始
 
@@ -62,7 +62,7 @@
    dsh plugin --profile web add dsh-pstack
    ```
 
-   也可以在 Web 或 Desktop 的 Plugins 页面安装。
+   也可以在 Web 或 Desktop 的「插件」页面安装。
 
 2. 重启对应的 profile，或新开一个 Session。
 
@@ -72,7 +72,7 @@
    /setup-pstack
    ```
 
-   该命令读取当前部署提供的 provider、model 与 reasoning effort，并写入 `$DSH_HOME/pstack-models.mdc`。缺少这个文件时，所有角色继承父级路由。
+   该命令读取当前部署提供的 provider、model 与 reasoning effort，并写入 `$DSH_HOME/pstack-models.mdc`。缺少这个文件时，所有角色继承父级路由。初始化后可在 **插件 → 已安装插件 → dsh-pstack** 查看和编辑同一份配置。
 
 ### 常用入口
 
@@ -86,6 +86,7 @@
 | `/statechart` | 用 TLA+ 与 TLC 检查状态模型，输出 Mermaid 状态图 |
 | `/show-me-your-work` | 维护 TSV 决策日志，审计当前工作 |
 | `/retro` | 对一次编码会话做环境复盘 |
+| `/docs-drift` | 巡检项目自身指针发现的文档；`report` 只读，`fix` 仅修复获批项。 |
 
 ## 能力
 
@@ -100,6 +101,12 @@
 
 `poteto-agent` 和 `comment-sicko` 两个 preset 分别负责实现型委派与只读评论审查。`pstack_script` 可以运行 `check-plan`、`watch-pr`、`worktree-audit`、`log`、`statechart` 五个随包脚本，脚本 id 是封闭枚举，不能拼任意路径。
 
+### 插件配置入口
+
+![在插件页头右上角点击「配置」入口](assets/pstack-config-entry.png)
+
+打开 **插件 → 已安装插件 → dsh-pstack**，点击 bundle 页头右上角的 **配置** 按钮即可打开配置弹窗。
+
 ## skills 目录
 
 `skills/` 不是 pstack 上游目录。它只收 pstack 没提供、真实项目开发中又需要的技能。源目录是 `skills/authored/` 和 `skills/.agents/skills/`，构建后分别发布到 `dist/skills/authored/` 和 `dist/skills/vendored/`。`vendored` 逐字保留开源上游，`authored` 由本仓维护。pstack 技能对它们的引用只是使用关系，不改变收录标准。
@@ -111,12 +118,13 @@
 | `authored` | `decision-write` | 决策记录的写入、落地和取代，Draft 与 Land 两种模式，`Status` 与 `Implemented-by` 必须成对。 | 补上真实项目常缺的决策生命周期。 |
 | `authored` | `decision-audit` | 只读审计决策记录的路由、状态、Scope、锚点与取代关系。 | 让决策记录持续可检索、可复核。 |
 | `authored` | `setup-project-docs` | 搭建 architecture、glossary、decisions 与根 `AGENTS.md` 指针，可重复补齐。 | 给新项目一套可持续的项目文档入口。 |
+| `authored` | `docs-drift` | 从项目指针发现维护文档，检查实现漂移、矛盾、术语、链接、冗余与无依据扩写，仅修复获批项。 | 不依赖固定文档布局，补充周期性文档巡检与受控清理。 |
 
 `vendored` 技能来自 `mattpocock/skills@59db609eb1e18aaf59b63284d0e52255aff0c63c`，来源、路径和哈希记录在 [`skills/skills-lock.json`](./skills/skills-lock.json)。两棵技能树都随包发布，但和 pstack 上游版本没有对应关系。
 
 ## 可选 DSH 插件
 
-以下插件随 DSH 提供，默认关闭。安装 dsh-pstack 时不要求安装这些插件，但部分 pstack 流程需要它们才能完整执行。要启用插件，在 Plugins 页面用 **Add plugin** 输入包名。也可以运行 `dsh plugin --profile <profile> add <package>`，然后重启 profile。除 `@deepseek-ai/dsh-mcp-client` 外，本节列出的 bundle 与 provider 都是实验性的。
+以下插件随 DSH 提供，默认关闭。安装 dsh-pstack 时不要求安装这些插件，但部分 pstack 流程需要它们才能完整执行。要启用插件，在「插件」页面用**添加插件**输入包名。也可以运行 `dsh plugin --profile <profile> add <package>`，然后重启 profile。除 `@deepseek-ai/dsh-mcp-client` 外，本节列出的 bundle 与 provider 都是实验性的。
 
 > [!NOTE]
 > 未启用可选插件时，pstack 技能仍可加载。需要插件的步骤会输出 `Skipped in DeepSeek Harness: <step>. <reason>.` 后继续。缺少 `gh`、Java/TLC 或视频工具时，对应步骤会报告 blocked 或降级为截图。dsh-pstack 不会把未运行的步骤标记为通过。
@@ -154,11 +162,16 @@
 
 | 项目 | 版本 | 说明 |
 |---|---|---|
-| DSH | `>=0.2.2-alpha.2` | 基准 `0.2.2-alpha.2`；默认认为更高版本兼容，移植内容需要修复时再提高要求 |
+| DSH | `>=0.2.1-rc.5` | 最低支持版本；已验证至 `0.2.2-alpha.2` 基线 |
 | pstack | `0.15.36` | 上游基线提交 `4dd1d05` |
 | Node.js | `>=24.21.1` | 运行时要求 |
 | Cordis | `~4.0.6-alpha.1` | peer dependency |
 
+> [!NOTE]
+> **DSH 版本支持：** `engines.dsh` 接受所有 `>=0.2.1-rc.5` 的版本，包括更高的预发布版。DSH 正常升级时无需修改此处；只有确认某个版本不受支持时才添加条目，只有移植修复需要时才提高最低版本。
+>
+> **已知不兼容的 DSH 版本：** 暂无。
+
 升级 DSH 前，先在测试 profile 中验证实验性插件的包名、工具名和配置。升级上游 pstack 需要重新生成树并复核适配表。
 
 > [!CAUTION]

package/cordis.patch.yml

@@ -3,6 +3,8 @@
 # `pstack` registers the bundled skill provider and `pstack_skill`, the trusted loader
 # that can reach skills hidden with `disable-model-invocation`.
 # `pstack-models` registers the read-only model/effort directory used by `/setup-pstack`.
+# `pstack-roles` exposes the same role file to the Plugins configuration page through a
+# Typert Remote service; its browser half is declared by `dsh.client` in package.json.
 # `pstack-subagent` registers `pstack_subagent`, which re-reads the role file on every
 # delegation and selects one of the pstack agent presets below.
 # `pstack-script` registers `pstack_script`, the only supported way to run the bundled
@@ -17,6 +19,8 @@
       name: dsh-pstack
     - id: pstack-models
       name: dsh-pstack/models
+    - id: pstack-roles
+      name: dsh-pstack/roles
     - id: pstack-subagent
       name: dsh-pstack/subagent
       config:
@@ -46,6 +50,8 @@
             name: "@deepseek-ai/dsh-tool-fs"
           - id: tool-fs-search
             name: "@deepseek-ai/dsh-tool-fs-search"
+            config:
+              sampleOverCapGlobResults: false
           - id: tool-todo
             name: "@deepseek-ai/dsh-tool-todo"
             config:
@@ -107,3 +113,5 @@
               edit: false
           - id: tool-fs-search
             name: "@deepseek-ai/dsh-tool-fs-search"
+            config:
+              sampleOverCapGlobResults: false