dsh-doublecheck 0.9.29 → 0.9.30

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.9.30] - 2026-11-05
+
+### Changed
+
+- Align with the DSH **0.2.2** host line. Every `@deepseek-ai/dsh-*` devDependency that publishes a 0.2.2 release moves from `0.2.1-rc.2` to `0.2.2-rc.1`; `@deepseek-ai/dsh-invariants` stays at `0.2.0-rc.2` because that package has no 0.2.2 release. The cordis family moves to the vendors of 0.2.2 (`^4.1.0` / `^1.1.0`), `@deepseek-ai/schemastery` moves to `~3.19.0`, and `@deepseek-ai/dsh-package-manifest@0.2.2-rc.1` joins the devDependencies (0.2.2's published `dsh-llm` types import it without declaring it). `engines.dsh` gains the `>=0.2.2-0 <0.3.0` clause and `engines.node` gains the `>=24.9.0` clause. Peer ranges only widen: no host line is dropped, and the cordis/schemastery peer ranges stay at their old loose values.
+- Add `@deepseek-ai/dsh-tool-executor-native@0.2.2-rc.1` as a devDependency. 0.2.2 moved raw batch execution behind a pluggable executor, so the test harnesses mount it after `ToolRuntime`.
+
+### Fixed
+
+- `ctx.tools.execute()` in the grill and guard test harnesses uses the 0.2.2 batch contract (`calls: [{ type: 'tool-call', … }]` plus `signal`/`agent`, settling through `batch.results[0].result`). The batch-level `additionalContexts` is asserted where the removed single-call field used to carry it.
+- The `doublecheck` session projection awaits the now-asynchronous `ctx.sessionProjections.register()` inside its effect, holds the returned handle, and releases it with `handle.dispose()` on unload. A new regression test mounts the REAL 0.2.2 registry and proves the key goes live and disappears on dispose.
+- `ptcSettle()` matches both `tool/ptc-dispatch` and its predecessor `tool/code-dispatch` structurally. The 0.2.2 tools contract retires the typed PTC event while persistence still recognizes both labels, so a restored pre-upgrade log keeps folding.
+
 ## [0.9.29] - 2026-10-19
 
 ### Fixed

package/PRIVACY.md

@@ -0,0 +1,11 @@
+# Privacy
+
+`dsh-doublecheck` is a local DeepSeek Harness plugin.
+
+- It reads only the workspace files, configuration and tool inputs needed for its documented features.
+- It does not add telemetry, analytics, advertising or a hosted account, and it sends no data to PerryLink.
+- Any network access or external service used by the plugin is documented in its README and is controlled by the user's own configuration.
+- It writes no data outside the DSH profile, the workspace, and the host's own session/log storage. The host controls that storage and its retention.
+- Removing the package removes its code; it does not delete host logs, workspace files or documents you already created.
+
+This statement covers the npm package, not the DSH host or any other plugin in the profile.

package/README-es.md

@@ -55,9 +55,10 @@ La puerta de calidad de entrega para DeepSeek Harness: interroga los requisitos,
 
 Los requisitos se interrogan antes de la primera edición; la entrega se demuestra, nunca se afirma.
 
-![Demostración de terminal de dsh-doublecheck: dsh-doublecheck — /gate report (example block from the README)](https://raw.githubusercontent.com/PerryLink/dsh-doublecheck/main/docs/assets/dsh-doublecheck-hero.png)
+![Diagrama de flujo de dsh-doublecheck: solicitud → política/revisión → veredicto.](docs/assets/dsh-doublecheck-flow.svg)
+
+*Resumen del flujo: solicitud → política/revisión → veredicto. Los ejemplos siguientes usan la superficie de comandos real.*
 
-![Animated terminal demo of dsh-doublecheck](https://raw.githubusercontent.com/PerryLink/dsh-doublecheck/main/docs/assets/dsh-doublecheck-demo.gif)
 
 *La misma ejecución, animada.*
 
@@ -65,8 +66,8 @@ Los requisitos se interrogan antes de la primera edición; la entrega se demuest
 
 | Superficie | Estado |
 |---|---|
-| Harness | DeepSeek Harness `dsh-v0.2.1-rc.2` (verified 2026-10-18): `engines.dsh >=0.2.1-0 <0.3.0`; the gate and projection paths are covered by the rc.2 test suite. |
-| Node | `^22.19.0 \|\| >=24.0.0` |
+| Harness | DeepSeek Harness `dsh-v0.2.2-rc.1` (adapted 2026-11-05): `engines.dsh` gains `>=0.2.2-0 <0.3.0` (every earlier line stays admitted); the gate and projection paths are covered by the rc.1 test suite. |
+| Node | `^22.19.0 \|\| >=24.9.0` |
 | Plataformas | Todas (host puro; sin código nativo, sin solicitudes de red directas propias) |
 | Modelo | Cualquiera (el guard nunca llama a un modelo; las fases de crítico y revisor se ejecutan como subagentes del harness) |
 
@@ -114,6 +115,50 @@ dsh --profile web --dump-config | grep -E -A3 'id: doublecheck-(grill|guard)'
 
 Ambas filas (`doublecheck-grill` y `doublecheck-guard`) se activan automáticamente con el perfil.
 
+### Ejemplos
+
+Son los puntos de entrada reales; instala y llama a uno.
+
+#### Ejemplo detallado
+
+**Comando**
+
+~~~sh
+/gate run
+~~~
+
+**Salida**
+
+~~~text
+# Delivery gate report
+
+> **Verdict: rework required** — 2 red item(s)
+> The gate is red. Re-open the work in plan mode to re-check the open items before delivering.
+~~~
+
+*Observado en `README.md §Example report (lines 243-251)`*
+
+#### Rama de fallo
+
+**Entrada**
+
+~~~text
+/doublecheck maybe
+~~~
+
+**Salida**
+
+~~~text
+Unknown /doublecheck argument "maybe". Usage: /doublecheck status|report|on|off
+~~~
+
+*Observado en `plugins/dsh-doublecheck/src/guard/prose.ts:191-192; plugins/dsh-doublecheck/src/guard/command.ts:156; plugins/dsh-doublecheck/tests/command.spec.ts:201-208`*
+
+#### Ejemplos breves
+
+- `doublecheck_skills`
+- `doublecheck_spec`
+
 ## Configuración
 
 Todos los ajustes son campos `Config` de Schemastery (modificables desde cordis.yml). Una sobrescritura dirigida por id reemplaza la fila completa — vuelve a declarar cada clave que necesites. `cordis.patch.yml` documenta cada clave en línea; los valores por defecto del Schema son la única fuente de los valores de ajuste.
@@ -339,7 +384,7 @@ Este plugin **no interfiere** con otros plugins, incluidos los de más estrellas
 
 Evidencia estática: `dsh-plugin-doctor` K10–K13 dan `pass` en todas las comprobaciones de este repositorio.
 
-## Familia de plugins DSH de PerryLink
+## PerryLink DSH Plugin Family
 
 Este proyecto forma parte de la familia de plugins de DeepSeek Harness de [PerryLink](https://github.com/PerryLink). El registro permanece plegado abajo para que cada README conserve una primera pantalla corta; expándelo para ver cada fila y su estado.
 
@@ -444,6 +489,8 @@ Este proyecto forma parte de la familia de plugins de DeepSeek Harness de [Perry
 | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 RETIRADO — ver el README del repositorio |
 | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 RETIRADO — ver el README del repositorio |
 
-</details>## Licencia
+</details>
+
+## Licencia
 
 [Apache License 2.0](LICENSE) © 2026 dsh-doublecheck contributors

package/README-hi.md

@@ -55,9 +55,10 @@ DeepSeek Harness के लिए डिलीवरी गुणवत्ता
 
 पहली एडिट से पहले आवश्यकताओं की पड़ताल होती है; डिलीवरी साबित की जाती है, दावा नहीं किया जाता।
 
-![dsh-doublecheck का टर्मिनल डेमो: dsh-doublecheck — /gate report (example block from the README)](https://raw.githubusercontent.com/PerryLink/dsh-doublecheck/main/docs/assets/dsh-doublecheck-hero.png)
+![dsh-doublecheck कार्यप्रवाह आरेख: अनुरोध → नीति/समीक्षा → निर्णय।](docs/assets/dsh-doublecheck-flow.svg)
+
+*कार्यप्रवाह: अनुरोध → नीति/समीक्षा → निर्णय। नीचे के उदाहरण वास्तविक कमांड सतह का उपयोग करते हैं।*
 
-![Animated terminal demo of dsh-doublecheck](https://raw.githubusercontent.com/PerryLink/dsh-doublecheck/main/docs/assets/dsh-doublecheck-demo.gif)
 
 *वही रन, एनिमेटेड।*
 
@@ -65,8 +66,8 @@ DeepSeek Harness के लिए डिलीवरी गुणवत्ता
 
 | सतह | स्थिति |
 |---|---|
-| Harness | DeepSeek Harness `dsh-v0.2.1-rc.2` (verified 2026-10-18): `engines.dsh >=0.2.1-0 <0.3.0`; the gate and projection paths are covered by the rc.2 test suite. |
-| Node | `^22.19.0 \|\| >=24.0.0` |
+| Harness | DeepSeek Harness `dsh-v0.2.2-rc.1` (adapted 2026-11-05): `engines.dsh` gains `>=0.2.2-0 <0.3.0` (every earlier line stays admitted); the gate and projection paths are covered by the rc.1 test suite. |
+| Node | `^22.19.0 \|\| >=24.9.0` |
 | प्लेटफ़ॉर्म | सभी (शुद्ध host; कोई नेटिव कोड नहीं, स्वयं का कोई सीधा नेटवर्क अनुरोध नहीं) |
 | मॉडल | कोई भी (guard स्वयं कभी मॉडल नहीं बुलाता; critic और reviewer चरण harness subagent के रूप में चलते हैं) |
 
@@ -114,6 +115,50 @@ dsh --profile web --dump-config | grep -E -A3 'id: doublecheck-(grill|guard)'
 
 दोनों पंक्तियाँ (`doublecheck-grill` और `doublecheck-guard`) प्रोफ़ाइल के साथ स्वतः सक्रिय हो जाती हैं।
 
+### उदाहरण
+
+ये वास्तविक प्रवेश बिंदु हैं; इंस्टॉल के बाद एक चलाएँ।
+
+#### विस्तृत उदाहरण
+
+**कमांड**
+
+~~~sh
+/gate run
+~~~
+
+**आउटपुट**
+
+~~~text
+# Delivery gate report
+
+> **Verdict: rework required** — 2 red item(s)
+> The gate is red. Re-open the work in plan mode to re-check the open items before delivering.
+~~~
+
+*स्रोत `README.md §Example report (lines 243-251)`*
+
+#### विफलता शाखा
+
+**इनपुट**
+
+~~~text
+/doublecheck maybe
+~~~
+
+**आउटपुट**
+
+~~~text
+Unknown /doublecheck argument "maybe". Usage: /doublecheck status|report|on|off
+~~~
+
+*स्रोत `plugins/dsh-doublecheck/src/guard/prose.ts:191-192; plugins/dsh-doublecheck/src/guard/command.ts:156; plugins/dsh-doublecheck/tests/command.spec.ts:201-208`*
+
+#### संक्षिप्त उदाहरण
+
+- `doublecheck_skills`
+- `doublecheck_spec`
+
 ## कॉन्फ़िगरेशन
 
 सभी ट्यून करने योग्य चीज़ें Schemastery `Config` फ़ील्ड हैं (cordis.yml से बदलने योग्य)। id-लक्षित ओवरराइड पूरी पंक्ति बदल देता है — आपको जो भी कुंजी चाहिए उसे दोबारा घोषित करें। `cordis.patch.yml` हर कुंजी को इनलाइन दस्तावेज़ित करता है; Schema डिफ़ॉल्ट ही ट्यूनिंग डिफ़ॉल्ट का एकमात्र स्रोत हैं।
@@ -339,7 +384,7 @@ pnpm run pack:check      # build + pack the tarball
 
 स्थैतिक प्रमाण: इस रिपॉज़िटरी पर `dsh-plugin-doctor` के K10–K13 सभी `pass` हैं।
 
-## PerryLink DSH प्लगइन परिवार
+## PerryLink DSH Plugin Family
 
 यह प्रोजेक्ट [PerryLink](https://github.com/PerryLink) के DeepSeek Harness प्लगइन परिवार का हिस्सा है। पूरी सूची नीचे संक्षिप्त रखी गई है ताकि हर README की पहली स्क्रीन छोटी रहे; हर पंक्ति और उसकी स्थिति देखने के लिए इसे खोलें।
 
@@ -444,6 +489,8 @@ pnpm run pack:check      # build + pack the tarball
 | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 सेवानिवृत्त — रिपॉज़िटरी README देखें |
 | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 सेवानिवृत्त — रिपॉज़िटरी README देखें |
 
-</details>## लाइसेंस
+</details>
+
+## लाइसेंस
 
 [Apache License 2.0](LICENSE) © 2026 dsh-doublecheck contributors

package/README-pt.md

@@ -46,9 +46,10 @@ O portão de qualidade de entrega para o DeepSeek Harness: interrogue os requisi
 
 Os requisitos são interrogados antes da primeira edição; a entrega é comprovada, nunca afirmada.
 
-![Demonstração de terminal do dsh-doublecheck: dsh-doublecheck — /gate report (example block from the README)](https://raw.githubusercontent.com/PerryLink/dsh-doublecheck/main/docs/assets/dsh-doublecheck-hero.png)
+![Diagrama de fluxo de dsh-doublecheck: solicitação → política/revisão → veredito.](docs/assets/dsh-doublecheck-flow.svg)
+
+*Visão geral do fluxo: solicitação → política/revisão → veredito. Os exemplos abaixo usam a superfície real de comandos.*
 
-![Animated terminal demo of dsh-doublecheck](https://raw.githubusercontent.com/PerryLink/dsh-doublecheck/main/docs/assets/dsh-doublecheck-demo.gif)
 
 *A mesma execução, animada.*
 
@@ -56,8 +57,8 @@ Os requisitos são interrogados antes da primeira edição; a entrega é comprov
 
 | Superfície | Status |
 |---|---|
-| Harness | DeepSeek Harness `dsh-v0.2.1-rc.2` (verified 2026-10-18): `engines.dsh >=0.2.1-0 <0.3.0`; the gate and projection paths are covered by the rc.2 test suite. |
-| Node | `^22.19.0 \|\| >=24.0.0` |
+| Harness | DeepSeek Harness `dsh-v0.2.2-rc.1` (adapted 2026-11-05): `engines.dsh` gains `>=0.2.2-0 <0.3.0` (every earlier line stays admitted); the gate and projection paths are covered by the rc.1 test suite. |
+| Node | `^22.19.0 \|\| >=24.9.0` |
 | Plataformas | Todas (host puro; sem código nativo, sem requisições de rede diretas próprias) |
 | Modelo | Qualquer (o guard nunca chama um modelo; as fases de crítico e revisor rodam como subagentes do harness) |
 
@@ -114,6 +115,50 @@ Ambas as linhas (`doublecheck-grill` e `doublecheck-guard`) são ativadas automa
 
 Para um modo estrito sem configuração (cada portão ativo com intensidade `block`, cobertura do portão exigida), aplique a camada de sobreposição incluída sobre o patch do bundle: `dsh --profile web --patch ./node_modules/dsh-doublecheck/strict.patch.yml`.
 
+### Exemplos
+
+São os pontos de entrada reais; instale e chame um.
+
+#### Exemplo detalhado
+
+**Comando**
+
+~~~sh
+/gate run
+~~~
+
+**Saída**
+
+~~~text
+# Delivery gate report
+
+> **Verdict: rework required** — 2 red item(s)
+> The gate is red. Re-open the work in plan mode to re-check the open items before delivering.
+~~~
+
+*Observado em `README.md §Example report (lines 243-251)`*
+
+#### Ramo de falha
+
+**Entrada**
+
+~~~text
+/doublecheck maybe
+~~~
+
+**Saída**
+
+~~~text
+Unknown /doublecheck argument "maybe". Usage: /doublecheck status|report|on|off
+~~~
+
+*Observado em `plugins/dsh-doublecheck/src/guard/prose.ts:191-192; plugins/dsh-doublecheck/src/guard/command.ts:156; plugins/dsh-doublecheck/tests/command.spec.ts:201-208`*
+
+#### Exemplos breves
+
+- `doublecheck_skills`
+- `doublecheck_spec`
+
 ## Configuração
 
 Todos os ajustes são campos `Config` do Schemastery (alteráveis a partir do cordis.yml). Uma sobrescrita direcionada por id substitui a linha inteira — redeclare cada chave de que você precisa. `cordis.patch.yml` documenta cada chave inline; os padrões do Schema são a única fonte dos padrões de ajuste.
@@ -339,7 +384,7 @@ Este plugin **não interfere** em outros plugins, incluindo os de mais estrelas:
 
 Evidência estática: `dsh-plugin-doctor` K10–K13 retornam `pass` em todas as verificações deste repositório.
 
-## Família de plugins DSH da PerryLink
+## PerryLink DSH Plugin Family
 
 Este projeto faz parte da família de plugins do DeepSeek Harness da [PerryLink](https://github.com/PerryLink). O registro fica recolhido abaixo para que cada README mantenha uma primeira tela curta; expanda para ver cada linha e seu status.
 
@@ -444,6 +489,8 @@ Este projeto faz parte da família de plugins do DeepSeek Harness da [PerryLink]
 | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 RETIRADO — ver o README do repositório |
 | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 RETIRADO — ver o README do repositório |
 
-</details>## Licença
+</details>
+
+## Licença
 
 [Apache License 2.0](LICENSE) © 2026 dsh-doublecheck contributors

package/README-zh.md

@@ -46,9 +46,10 @@ DeepSeek Harness 的交付质量门禁：先拷问需求，再测试实现，最
 
 需求在第一次改动之前就被拷问清楚；交付是被证明的，而不是被口头宣称的。
 
-![dsh-doublecheck 终端演示：dsh-doublecheck — /gate report (example block from the README)](https://raw.githubusercontent.com/PerryLink/dsh-doublecheck/main/docs/assets/dsh-doublecheck-hero.png)
+![dsh-doublecheck 工作流图：请求 → 策略/复核 → 判定。](docs/assets/dsh-doublecheck-flow.svg)
+
+*工作流概览：请求 → 策略/复核 → 判定。下面的示例使用实际命令面。*
 
-![Animated terminal demo of dsh-doublecheck](https://raw.githubusercontent.com/PerryLink/dsh-doublecheck/main/docs/assets/dsh-doublecheck-demo.gif)
 
 *同一次运行，动图版。*
 
@@ -56,8 +57,8 @@ DeepSeek Harness 的交付质量门禁：先拷问需求，再测试实现，最
 
 | 方面 | 状态 |
 |---|---|
-| Harness | DeepSeek Harness `dsh-v0.2.1-rc.2` (verified 2026-10-18): `engines.dsh >=0.2.1-0 <0.3.0`; the gate and projection paths are covered by the rc.2 test suite. |
-| Node | `^22.19.0 \|\| >=24.0.0` |
+| Harness | DeepSeek Harness `dsh-v0.2.2-rc.1` (adapted 2026-11-05): `engines.dsh` gains `>=0.2.2-0 <0.3.0` (every earlier line stays admitted); the gate and projection paths are covered by the rc.1 test suite. |
+| Node | `^22.19.0 \|\| >=24.9.0` |
 | 平台 | 全部（纯宿主；无原生代码，自身无直接网络请求） |
 | 模型 | 任意（守卫本身从不调用模型；评审与批评阶段作为宿主 subagent 运行） |
 
@@ -114,6 +115,50 @@ dsh --profile web --dump-config | grep -E -A3 'id: doublecheck-(grill|guard)'
 
 如需零配置的严格模式（每个门禁都以 `block` 强度开启、要求门禁覆盖率），在捆绑补丁之上应用随附的覆盖层：`dsh --profile web --patch ./node_modules/dsh-doublecheck/strict.patch.yml`。
 
+### 示例
+
+以下为插件真实入口；安装后调用一个即可。
+
+#### 详细示例
+
+**命令**
+
+~~~sh
+/gate run
+~~~
+
+**输出**
+
+~~~text
+# Delivery gate report
+
+> **Verdict: rework required** — 2 red item(s)
+> The gate is red. Re-open the work in plan mode to re-check the open items before delivering.
+~~~
+
+*来源 `README.md §Example report (lines 243-251)`*
+
+#### 失败分支
+
+**输入**
+
+~~~text
+/doublecheck maybe
+~~~
+
+**输出**
+
+~~~text
+Unknown /doublecheck argument "maybe". Usage: /doublecheck status|report|on|off
+~~~
+
+*来源 `plugins/dsh-doublecheck/src/guard/prose.ts:191-192; plugins/dsh-doublecheck/src/guard/command.ts:156; plugins/dsh-doublecheck/tests/command.spec.ts:201-208`*
+
+#### 简短示例
+
+- `doublecheck_skills`
+- `doublecheck_spec`
+
 ## 配置
 
 所有可调项都是 Schemastery 的 `Config` 字段（可在 cordis.yml 中修改）。按 id 定位的覆盖会替换整行——请重新声明你需要的每一个键。`cordis.patch.yml` 逐键内联说明；Schema 默认值是调优默认值的唯一来源。
@@ -339,7 +384,7 @@ pnpm run pack:check      # build + pack the tarball
 
 静态证据：`dsh-plugin-doctor` 的 K10–K13 在本仓全部为 `pass`。
 
-## PerryLink DSH 插件家族
+## PerryLink DSH Plugin Family
 
 本项目是 [PerryLink](https://github.com/PerryLink) 维护的 DeepSeek Harness 插件家族成员。完整名单默认折叠，避免每个 README 的首屏被长表淹没；点击展开可查看每一行及其状态。
 
@@ -444,6 +489,8 @@ pnpm run pack:check      # build + pack the tarball
 | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 已退役 — 见仓库 README |
 | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 已退役 — 见仓库 README |
 
-</details>## 许可证
+</details>
+
+## 许可证
 
 [Apache License 2.0](LICENSE) © 2026 dsh-doublecheck contributors

package/README.md

@@ -56,18 +56,18 @@ The delivery quality gate for DeepSeek Harness: grill the requirements, test the
 
 Requirements get interrogated before the first edit; delivery is proven, never claimed.
 
-![Terminal demo of dsh-doublecheck: dsh-doublecheck — /gate report (example block from the README)](https://raw.githubusercontent.com/PerryLink/dsh-doublecheck/main/docs/assets/dsh-doublecheck-hero.png)
+![Workflow diagram for dsh-doublecheck: request → policy / review → verdict.](docs/assets/dsh-doublecheck-flow.svg)
+
+*Workflow overview: request → policy / review → verdict. The examples below use the real command surface.*
 
-![Animated terminal demo of dsh-doublecheck](https://raw.githubusercontent.com/PerryLink/dsh-doublecheck/main/docs/assets/dsh-doublecheck-demo.gif)
 
-*The same run, animated.*
 
 ## Compatibility
 
 | Surface | Status |
 |---|---|
-| Harness | DeepSeek Harness `dsh-v0.2.1-rc.2` (verified 2026-10-18): `engines.dsh >=0.2.1-0 <0.3.0`; the gate and projection paths are covered by the rc.2 test suite. |
-| Node | `^22.19.0 \|\| >=24.0.0` |
+| Harness | DeepSeek Harness `dsh-v0.2.2-rc.1` (adapted 2026-11-05): `engines.dsh` gains `>=0.2.2-0 <0.3.0` (every earlier line stays admitted); the gate and projection paths are covered by the rc.1 test suite. |
+| Node | `^22.19.0 \|\| >=24.9.0` |
 | Platforms | All (pure host; no native code, no direct network requests of its own) |
 | Model | Any (the guard itself never calls a model; the critic and reviewer phases run as harness subagents) |
 
@@ -115,6 +115,50 @@ dsh --profile web --dump-config | grep -E -A3 'id: doublecheck-(grill|guard)'
 
 Both rows (`doublecheck-grill` and `doublecheck-guard`) activate automatically with the profile.
 
+### Examples
+
+These are the plugin's real entry points; install once, then call one.
+
+#### Detailed example
+
+**Command**
+
+~~~sh
+/gate run
+~~~
+
+**Output**
+
+~~~text
+# Delivery gate report
+
+> **Verdict: rework required** — 2 red item(s)
+> The gate is red. Re-open the work in plan mode to re-check the open items before delivering.
+~~~
+
+*Observed from `README.md §Example report (lines 243-251)`*
+
+#### Failure branch
+
+**Input**
+
+~~~text
+/doublecheck maybe
+~~~
+
+**Output**
+
+~~~text
+Unknown /doublecheck argument "maybe". Usage: /doublecheck status|report|on|off
+~~~
+
+*Observed from `plugins/dsh-doublecheck/src/guard/prose.ts:191-192; plugins/dsh-doublecheck/src/guard/command.ts:156; plugins/dsh-doublecheck/tests/command.spec.ts:201-208`*
+
+#### Brief examples
+
+- `doublecheck_skills`
+- `doublecheck_spec`
+
 ## Configuration
 
 All tunables are Schemastery `Config` fields (changeable from cordis.yml). An id-targeted override replaces the whole row — restate every key you need. `cordis.patch.yml` documents each key inline; Schema defaults are the single source of tuning defaults.
@@ -359,10 +403,10 @@ This project is part of the DeepSeek Harness plugin family from [PerryLink](http
 | **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** |  |
 | **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** |  |
 | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** |  |
-| **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** |  |
+| **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 FROZEN — see the repo README |
 | **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** |  |
 | **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** |  |
-| **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** |  |
+| **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | 🧊 FROZEN — see the repo README |
 | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** |  |
 | **[dsh-click](https://github.com/PerryLink/dsh-click)** |  |
 | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** |  |
@@ -452,6 +496,8 @@ This project is part of the DeepSeek Harness plugin family from [PerryLink](http
 | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 RETIRED — see the repo README |
 | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 RETIRED — see the repo README |
 
-</details>## License
+</details>
+
+## License
 
 [Apache License 2.0](LICENSE) © 2026 dsh-doublecheck contributors

package/icon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" role="img" aria-label="dsh-doublecheck"><rect width="128" height="128" rx="24" fill="#0f172a"/><circle cx="64" cy="64" r="44" fill="none" stroke="#ce3ebb" stroke-width="6"/><text x="64" y="78" fill="#f8fafc" text-anchor="middle" font-family="ui-monospace,monospace" font-size="38" font-weight="700">D</text></svg>

package/lib/domain/evidence.d.ts

@@ -67,12 +67,13 @@ export interface PtcSettle {
  * Normalize one settled PTC sub-dispatch event, across the event-vocabulary
  * rename at the session-format V2→V3 edge.
  *
- * The current line names the settled sub-dispatch `tool/ptc-dispatch` (the
- * host's V2→V3 migration renames the predecessor `tool/code-dispatch`, keeping
- * the payload values), so a stored V2 log arrives under the new label. A host
- * on the older release line still emits the predecessor label, which is outside
- * this line's `SessionEventMap`; it is matched structurally instead of as a
- * switch case, so the fold never depends on which generation wrote the log.
+ * The V3 line names the settled sub-dispatch `tool/ptc-dispatch` (the host's
+ * V2→V3 migration renames the predecessor `tool/code-dispatch`, keeping the
+ * payload values), so a stored V2 log arrives under the new label. Neither
+ * label is a member of this host line's `SessionEventMap` — the 0.2.2 tools
+ * contract retires the PTC declaration while persistence still recognizes both
+ * names — so both are matched structurally instead of as switch cases. The
+ * fold therefore never depends on which generation wrote the log.
  *
  * @param event - one committed session event.
  * @returns the settled payload, or `undefined` when the event is not a settled sub-dispatch.

package/lib/domain/evidence.js

@@ -60,35 +60,29 @@ export function emptyDetection() {
  * Normalize one settled PTC sub-dispatch event, across the event-vocabulary
  * rename at the session-format V2→V3 edge.
  *
- * The current line names the settled sub-dispatch `tool/ptc-dispatch` (the
- * host's V2→V3 migration renames the predecessor `tool/code-dispatch`, keeping
- * the payload values), so a stored V2 log arrives under the new label. A host
- * on the older release line still emits the predecessor label, which is outside
- * this line's `SessionEventMap`; it is matched structurally instead of as a
- * switch case, so the fold never depends on which generation wrote the log.
+ * The V3 line names the settled sub-dispatch `tool/ptc-dispatch` (the host's
+ * V2→V3 migration renames the predecessor `tool/code-dispatch`, keeping the
+ * payload values), so a stored V2 log arrives under the new label. Neither
+ * label is a member of this host line's `SessionEventMap` — the 0.2.2 tools
+ * contract retires the PTC declaration while persistence still recognizes both
+ * names — so both are matched structurally instead of as switch cases. The
+ * fold therefore never depends on which generation wrote the log.
  *
  * @param event - one committed session event.
  * @returns the settled payload, or `undefined` when the event is not a settled sub-dispatch.
  */
 export function ptcSettle(event) {
-    if (event.type === 'tool/ptc-dispatch') {
-        return {
-            name: event.data.name,
-            arguments: event.data.arguments,
-            isError: event.data.isError,
-            content: event.data.content,
-        };
-    }
-    if (event.type !== 'tool/code-dispatch')
+    const type = event.type;
+    if (type !== 'tool/ptc-dispatch' && type !== 'tool/code-dispatch')
         return undefined;
-    const legacy = event.data;
-    if (legacy === null || legacy === undefined || typeof legacy.name !== 'string')
+    const settled = event.data;
+    if (settled === null || settled === undefined || typeof settled.name !== 'string')
         return undefined;
     return {
-        name: legacy.name,
-        arguments: legacy.arguments,
-        isError: legacy.isError === true,
-        content: Array.isArray(legacy.content) ? legacy.content : [],
+        name: settled.name,
+        arguments: settled.arguments,
+        isError: settled.isError === true,
+        content: Array.isArray(settled.content) ? settled.content : [],
     };
 }
 /**

package/lib/guard/index.js

@@ -585,31 +585,36 @@ export function apply(ctx, config) {
         const registry = projectionCtx.get('sessionProjections');
         if (registry === undefined)
             return;
-        // The registry returns the disposer that unregisters this projection; it
-        // MUST be owned by an effect. Registering without holding it left the old
-        // closure live after a config hot-reload: turning `gate` (or any detection
-        // knob) off and on again kept judging with the stale definitions — a
-        // silent false-safety window, and a hard throw once the state version moved.
-        projectionCtx.effect(() => registry.register({
-            key: 'doublecheck',
-            stateSchema: doublecheckStateSchema,
-            init: emptyDoublecheckState,
-            apply: (state, event) => applyDoublecheckEvent(state, event, detection),
-            wire: {
-                viewSchema: doublecheckViewSchema,
-                view: viewDoublecheck,
-            },
-            // v3: the wire value changed type (object -> one bounded line). The
-            // bump is the persisted-cache invalidation the registry documents, and
-            // it IS the backward-compatibility story: the state fields themselves
-            // are unchanged and still pass `doublecheckStateSchema`, but a row
-            // written at `ver: 2` is discarded on a `ver: 3` unit and the key
-            // refolds from `init` over the full log (the host's `restoreFloor`
-            // drops to seq 0 on any version mismatch). No migration code, and a
-            // pre-upgrade session degrades to a recomputed line instead of a
-            // stale one or a crash.
-            stateVersion: 3,
-        }), 'dsh-doublecheck: projection');
+        // Registration is asynchronous on the 0.2.2 line and returns a ready
+        // handle; awaiting it inside the effect keeps the fiber from publishing a
+        // half-registered unit. The handle's `dispose()` is the unregistration
+        // path and MUST be owned by an effect. Registering without holding it left
+        // the old closure live after a config hot-reload: turning `gate` (or any
+        // detection knob) off and on again kept judging with the stale
+        // definitions — a silent false-safety window, and a hard throw once the
+        // state version moved.
+        projectionCtx.effect(async () => {
+            const handle = await registry.register({
+                key: 'doublecheck',
+                stateSchema: doublecheckStateSchema,
+                init: emptyDoublecheckState,
+                apply: (state, event) => applyDoublecheckEvent(state, event, detection),
+                wire: {
+                    viewSchema: doublecheckViewSchema,
+                    view: viewDoublecheck,
+                },
+                // stateVersion is the persisted-cache invalidation the registry
+                // documents, and it IS the backward-compatibility story: the state
+                // fields themselves are unchanged and still pass
+                // `doublecheckStateSchema`, but a row written at `ver: 2` is
+                // discarded on a `ver: 3` unit and the key refolds from `init` over
+                // the full log (the host's `restoreFloor` drops to seq 0 on any
+                // version mismatch). No migration code, and a pre-upgrade session
+                // degrades to a recomputed line instead of a stale one or a crash.
+                stateVersion: 3,
+            });
+            return () => handle.dispose();
+        }, 'dsh-doublecheck: projection');
     });
     // The invariant companion, registered from the main plugin so its checks
     // see the live detection knobs. Activates only when an invariant registry

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-doublecheck",
-  "version": "0.9.29",
+  "version": "0.9.30",
   "description": "Delivery quality gate for DeepSeek Harness: grill the requirements, test the implementation, prove the delivery, and gate the handoff with a deliverable/rework decision.",
   "packageManager": "pnpm@11.7.0",
   "repository": {
@@ -51,7 +51,9 @@
     "README-es.md",
     "README-pt.md",
     "README-hi.md",
-    "LICENSE"
+    "LICENSE",
+    "PRIVACY.md",
+    "icon.svg"
   ],
   "scripts": {
     "build": "tsc --noEmitOnError && node scripts/fix-dts.mjs",
@@ -83,14 +85,18 @@
   "author": "PerryLink",
   "license": "Apache-2.0",
   "engines": {
-    "node": "^22.19.0 || >=24.0.0",
-    "dsh": ">=0.1.6-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0"
+    "node": "^22.19.0 || >=24.9.0",
+    "dsh": ">=0.1.6-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0 || >=0.2.2-0 <0.3.0"
   },
   "dsh": {
     "manifestVersion": 1,
     "bundle": {
       "patch": "./cordis.patch.yml"
-    }
+    },
+    "capabilities": [
+      "tools:register"
+    ],
+    "labels": []
   },
   "dshWorkshop": {
     "schema": "omdsh-workshop-package/v1",
@@ -137,46 +143,49 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5-alpha.1",
-    "@deepseek-ai/dsh-agent": ">=0.1.6-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0",
-    "@deepseek-ai/dsh-commands": ">=0.1.6-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0",
+    "@deepseek-ai/dsh-agent": ">=0.1.6-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0 || >=0.2.2-0 <0.3.0",
+    "@deepseek-ai/dsh-commands": ">=0.1.6-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0 || >=0.2.2-0 <0.3.0",
     "@deepseek-ai/dsh-invariants": ">=0.1.6-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0",
-    "@deepseek-ai/dsh-llm": ">=0.1.6-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0",
-    "@deepseek-ai/dsh-session": ">=0.1.6-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0",
-    "@deepseek-ai/dsh-session-projection": ">=0.1.6-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0",
-    "@deepseek-ai/dsh-skill": ">=0.1.6-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0",
-    "@deepseek-ai/dsh-tools": ">=0.1.6-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0",
+    "@deepseek-ai/dsh-llm": ">=0.1.6-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0 || >=0.2.2-0 <0.3.0",
+    "@deepseek-ai/dsh-session": ">=0.1.6-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0 || >=0.2.2-0 <0.3.0",
+    "@deepseek-ai/dsh-session-projection": ">=0.1.6-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0 || >=0.2.2-0 <0.3.0",
+    "@deepseek-ai/dsh-skill": ">=0.1.6-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0 || >=0.2.2-0 <0.3.0",
+    "@deepseek-ai/dsh-tools": ">=0.1.6-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0 || >=0.2.2-0 <0.3.0",
     "@deepseek-ai/schemastery": "^3.18.5-alpha.1"
   },
   "dependencies": {
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.5-alpha.1",
-    "@deepseek-ai/cordis-plugin-loader": "^1.0.6-alpha.1",
-    "@deepseek-ai/dsh-agent": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-commands": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-fs": "0.2.1-rc.2",
+    "@deepseek-ai/cordis": "^4.1.0",
+    "@deepseek-ai/cordis-plugin-loader": "^1.1.0",
+    "@deepseek-ai/dsh-agent": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-commands": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-fs": "0.2.2-rc.1",
     "@deepseek-ai/dsh-invariants": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-llm": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-session": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-session-projection": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-settings": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-skill": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-subagent": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-tools": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-workflow": "0.2.1-rc.2",
-    "@deepseek-ai/schemastery": "^3.18.5-alpha.1",
+    "@deepseek-ai/dsh-llm": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-session": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-session-projection": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-settings": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-skill": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-subagent": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-tool-executor-native": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-tools": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-workflow": "0.2.2-rc.1",
+    "@deepseek-ai/schemastery": "~3.19.0",
     "@eslint/js": "^9.30.0",
     "@types/node": "^22.15.0",
     "@vitest/coverage-v8": "^3.2.0",
     "eslint": "^9.30.0",
     "typescript-eslint": "^8.35.0",
     "vitest": "^3.2.0",
-    "typescript": "^5.7.0"
+    "typescript": "^5.7.0",
+    "@deepseek-ai/dsh-package-manifest": "0.2.2-rc.1"
   },
   "funding": {
     "type": "individual",
     "url": "https://github.com/sponsors/PerryLink"
-  }
+  },
+  "icon": "icon.svg"
 }