dsh-patch-edit-plus 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -1,15 +1,17 @@
 # Changelog
 
-## [0.2.2] — 2026-09-29
+## [0.2.3] — 2026-09-29
+
+### Fixed
+- **Delete/Move silently degraded to UNSUPPORTED on real 0.1.7 hosts** (defect shipped in 0.2.1): the shell duck-detect looked for `run()`, but DSH renamed `ShellExecutor.run(spec)` → `execute(spec)` (returning a `ShellProcess` handle with a `result()` foreground projection) between 0.1.2 and 0.1.7 — so the detect never matched and Delete/Move always fell back to a structured UNSUPPORTED error. `shellops` now calls `shell.execute(...)` + `await execution.result()` and duck-detects `execute`; shell test mocks moved to the `execute()`/`result()` shape.
 
 ### Changed
-- **DSH line split**: this release serves the `0.1.5-rc` segment only — `peerDependencies`/`engines.dsh` capped to `>=0.1.5-rc.1 <0.1.6-0` (both manifests), published under the `dsh-0.1.5` dist-tag. `0.1.2-rc.1` ~ `0.1.4` remain served by the published `0.1.2` (main); `0.1.7` by `dsh-0.1.7` (v0.2.1+); `0.2.0` by `dsh-0.2.0` (v0.3.0+).
-- devDependencies 4x `@deepseek-ai/dsh-*` `0.1.2-rc.1` → `0.1.5-rc.3`: the type baseline now matches the hosts this line serves (the stale `0.1.2` pin was the "fake green" pattern — a baseline older than the served line can mask real contract breaks).
-- Docs x4 (README/INSTALL): compatibility matrix re-based to the `0.1.5-rc` segment.
+- devDependencies 4x `@deepseek-ai/dsh-*` `0.1.2-rc.1` → `0.1.7-rc.2`: the type baseline now matches the hosts this line serves (the stale pin was the "fake green" pattern — it masked the rename above).
+- Docs x4 (README/INSTALL): compatibility re-based to the `0.1.7` segment; ja/ko matrices were stale at the 0.1.2~0.1.5 wide claim.
+
+## [0.2.1] — 2026-09-25
 
-### Verified
-- No source changes required: `ShellExecutor.run(spec)` is intact across `0.1.5-rc.1`–`rc.3` (the `run` → `execute` rename lands in the 0.1.6→0.1.7 window), and the imperative settings fallback (`settings.register` / `installSection`) still exists on 0.1.5 hosts.
-- build / typecheck / test (94) / lint / smoke / `typecheck:0.1.5` (static proof against real `0.1.5-rc.2` peers) all green; lockfile regenerated against `0.1.5-rc.3`.
+- First release of the 0.1.7 line (`dsh-0.1.7` dist-tag): declarative settings — `allowCodexPatch` marked `.volatile()`, settings form auto-rendered, tool re-registered in place via `loader/volatile-update` (no remount, no registration call).
 
 ## [0.1.2] — 2026-09-19
 

package/CHANGELOG.zh.md

@@ -1,15 +1,17 @@
 # 更新日志
 
-## [0.2.2] — 2026-09-29
+## [0.2.3] — 2026-09-29
+
+### 修复
+- **Delete/Move 在真实 0.1.7 宿主上被静默降级为 UNSUPPORTED**（0.2.1 携带的缺陷）：shell 鸭子探测查的是 `run()`，但 DSH 在 0.1.2→0.1.7 之间把 `ShellExecutor.run(spec)` 改名为 `execute(spec)`（返回 `ShellProcess` 句柄 + `result()` 前台投影）——探测永不命中，Delete/Move 一直落到结构化 UNSUPPORTED 错误。`shellops` 现改用 `shell.execute(...)` + `await execution.result()`，鸭子探测改查 `execute`；shell 测试 mock 同步迁移到 `execute()`/`result()` 形态。
 
 ### 变更
-- **DSH 线拆分**：本版本只服务 `0.1.5-rc` 线段——`peerDependencies`/`engines.dsh` 封顶到 `>=0.1.5-rc.1 <0.1.6-0`（双清单），经 `dsh-0.1.5` dist-tag 发布。`0.1.2-rc.1` ~ `0.1.4` 仍由已发布的 `0.1.2`（main）服务；`0.1.7` 由 `dsh-0.1.7`（v0.2.1+）服务；`0.2.0` 由 `dsh-0.2.0`（v0.3.0+）服务。
-- devDependencies 4 项 `@deepseek-ai/dsh-*` `0.1.2-rc.1` → `0.1.5-rc.3`：类型基线与本线服务的宿主对齐（过期的 `0.1.2` 钉版正是「假绿」形态——基线早于服务线会掩盖真实契约断裂）。
-- 文档 ×4（README/INSTALL）：兼容矩阵重基于 `0.1.5-rc` 线段。
+- devDependencies 4 项 `@deepseek-ai/dsh-*` `0.1.2-rc.1` → `0.1.7-rc.2`：类型基线与本线服务的宿主对齐（过期的钉版正是「假绿」形态——它掩盖了上述改名）。
+- 文档 ×4（README/INSTALL）：兼容矩阵重基于 `0.1.7` 线段；ja/ko 矩阵此前停留在 0.1.2~0.1.5 旧态。
+
+## [0.2.1] — 2026-09-25
 
-### 验证
-- 无需源码改动：`ShellExecutor.run(spec)` 在 `0.1.5-rc.1`–`rc.3` 全程未变（`run` → `execute` 改名落在 0.1.6→0.1.7 区间），且 0.1.5 宿主仍有命令式设置回退（`settings.register` / `installSection`）。
-- build / typecheck / test（94）/ lint / smoke / `typecheck:0.1.5`（对真实 `0.1.5-rc.2` peer 静态核验）全绿；lockfile 按 `0.1.5-rc.3` 重新生成。
+- 0.1.7 线首发（`dsh-0.1.7` dist-tag）：声明式设置——`allowCodexPatch` 标记 `.volatile()`，设置表单自动生成，工具经 `loader/volatile-update` 原位重注册（不 remount、无注册调用）。
 
 ## [0.1.2] — 2026-09-19
 

package/README.ja.md

@@ -6,10 +6,12 @@
 
 | DSH バージョン | ステータス | 備考 |
 |---|---|---|
-| `0.1.5-rc.1+` | ✅ サポート対象（本ライン、v0.2.2+） | 型ベースラインを実在の `0.1.5-rc.3` ピアに固定し、`peerDependencies`/`engines.dsh` は `>=0.1.5-rc.1 <0.1.6-0` にキャップ。`dsh-0.1.5` dist-tag で公開。 |
-| `0.1.2-rc.1` ~ `0.1.4` | ↗ メンテナンスライン | 公開済みの `0.1.2`（main ブランチ）が担います。`0.1.6+` は別契約（shell の `run` → `execute`）であり、compat/0.1.7・compat/0.2.0 ラインが担います。 |
+| `0.1.7-rc.1+` | ✅ サポート対象（本ライン、v0.2.1+） | 宣言的設定：`allowCodexPatch` を `.volatile()` とマーク — 設定フォームは自動生成され、`loader/volatile-update` が remount なしでツールをその場で再登録します。v0.2.3 は Delete/Move を修正：shell のダックタイピング検出が `run()` を見ていましたが、実 0.1.7 ホストでは決して一致しません（`run` は 0.1.2→0.1.7 の間に `execute` に改名）、Delete/Move は UNSUPPORTED にサイレント降格していました。現在は `execute()` + `result()` を使用。 |
+| `0.1.2-rc.1` ~ `0.1.4` | ↗ メンテナンスライン | 公開済みの `0.1.2`（main ブランチ）が担います。 |
+| `0.1.5-rc.x` | ↗ メンテナンスライン | `dsh-0.1.5` dist-tag（v0.2.2+）が担います。 |
+| `0.2.0-rc.1+` | ↗ 次ライン | `dsh-0.2.0` dist-tag（v0.3.0+）が担います。 |
 
-設定の登録はデュアル API フォールバック（0.1.2 以降では `settings.installSection`、旧ホストでは `settings.register`）を使用します。
+本ラインの設定は宣言的です：`Config` で `.volatile()` とマークされたフィールドが設定フォームになり、プラグインは登録 hooks を受け取る代わりに `loader/volatile-update` を購読します。
 
 ## そもそもなぜパッチなのか？（ツールルーティングガイド）
 
@@ -108,8 +110,8 @@ dsh web --dump-config   # verify the plugin row appears
 
 ```bash
 npm install
-npm run typecheck        # against 0.1.5-rc.3 peers (devDependencies)
-npm run typecheck:0.1.5  # 実在の 0.1.5-rc.2 ピアに対する静的クロス検証
+npm run typecheck        # against 0.1.7-rc.2 peers (devDependencies)
+npm run typecheck:0.1.5  # 実在の 0.1.5-rc.2 ピアに対するレガシー交叉検証
 npm test                 # vitest, 90 tests
 npm run lint
 npm run build            # lib/

package/README.ko.md

@@ -6,10 +6,12 @@
 
 | DSH 버전 | 상태 | 비고 |
 |---|---|---|
-| `0.1.5-rc.1+` | ✅ 지원됨(본 라인, v0.2.2+) | 타입 베이스라인을 실제 `0.1.5-rc.3` peer에 고정하고, `peerDependencies`/`engines.dsh`는 `>=0.1.5-rc.1 <0.1.6-0`으로 제한합니다. `dsh-0.1.5` dist-tag로 게시됩니다. |
-| `0.1.2-rc.1` ~ `0.1.4` | ↗ 유지보수 라인 | 게시된 `0.1.2`(main 브랜치)가 담당합니다. `0.1.6+`은 별도 계약(shell `run` → `execute`)이며 compat/0.1.7·compat/0.2.0 라인이 지원합니다. |
+| `0.1.7-rc.1+` | ✅ 지원됨(본 라인, v0.2.1+) | 선언적 설정: `allowCodexPatch`에 `.volatile()` 마크 — 설정 폼이 자동 생성되고, `loader/volatile-update`가 remount 없이 도구를 그 자리에서 재등록합니다. v0.2.3은 Delete/Move를 수정: shell 덕 타이핑 감지가 `run()`을 보았으나 실 0.1.7 호스트에서는 결코 일치하지 않았고(`run`은 0.1.2→0.1.7 사이에 `execute`로 개명), Delete/Move가 UNSUPPORTED로 조용히 강등되었습니다. 이제 `execute()` + `result()` 사용. |
+| `0.1.2-rc.1` ~ `0.1.4` | ↗ 유지보수 라인 | 게시된 `0.1.2`(main 브랜치)가 담당합니다. |
+| `0.1.5-rc.x` | ↗ 유지보수 라인 | `dsh-0.1.5` dist-tag(v0.2.2+)가 담당합니다. |
+| `0.2.0-rc.1+` | ↗ 다음 라인 | `dsh-0.2.0` dist-tag(v0.3.0+)가 담당합니다. |
 
-설정 등록은 이중 API 폴백을 사용합니다(0.1.2+ 에서는 `settings.installSection`, 이전 호스트에서는 `settings.register`).
+본 라인의 설정은 선언적입니다: `Config`에서 `.volatile()`로 마크된 필드가 설정 폼이 되고, 플러그인은 등록 hooks를 받는 대신 `loader/volatile-update`를 구독합니다.
 
 ## 왜 굳이 패치인가? (도구 라우팅 가이드)
 
@@ -108,8 +110,8 @@ dsh web --dump-config   # verify the plugin row appears
 
 ```bash
 npm install
-npm run typecheck        # against 0.1.5-rc.3 peers (devDependencies)
-npm run typecheck:0.1.5  # 실제 0.1.5-rc.2 peer 대상 정적 교차 검증
+npm run typecheck        # against 0.1.7-rc.2 peers (devDependencies)
+npm run typecheck:0.1.5  # 실제 0.1.5-rc.2 peer 대상 레거시 교차 검증
 npm test                 # vitest, 90 tests
 npm run lint
 npm run build            # lib/

package/README.md

@@ -6,10 +6,12 @@ Patch-style file editing for [DeepSeek Harness (DSH)](https://github.com/deepsee
 
 | DSH version | Status | Notes |
 |---|---|---|
-| `0.1.5-rc.1+` | ✅ supported (this line, v0.2.2+) | Type baseline pinned to the real `0.1.5-rc.3` peers; `peerDependencies`/`engines.dsh` capped to `>=0.1.5-rc.1 <0.1.6-0`. Published under the `dsh-0.1.5` dist-tag. |
-| `0.1.2-rc.1` ~ `0.1.4` | ↗ maintenance line | Served by the published `0.1.2` (main branch). `0.1.6+` is a different contract (shell `run` → `execute`) and is served by the compat/0.1.7 and compat/0.2.0 lines. |
+| `0.1.7-rc.1+` | ✅ supported (this line, v0.2.1+) | Declarative settings: `allowCodexPatch` is marked `.volatile()` — the settings form renders automatically and `loader/volatile-update` re-registers the tool without a remount. v0.2.3 fixes Delete/Move: the shell `run()` duck-detect never matched real 0.1.7 hosts (`run` was renamed `execute` between 0.1.2 and 0.1.7), silently degrading them to UNSUPPORTED; now uses `execute()` + `result()`. |
+| `0.1.2-rc.1` ~ `0.1.4` | ↗ maintenance line | Served by the published `0.1.2` (main branch). |
+| `0.1.5-rc.x` | ↗ maintenance line | Served by the `dsh-0.1.5` dist-tag (v0.2.2+). |
+| `0.2.0-rc.1+` | ↗ next line | Served by the `dsh-0.2.0` dist-tag (v0.3.0+). |
 
-Settings registration uses the dual-API fallback (`settings.installSection` on 0.1.2+, `settings.register` on older hosts).
+Settings are declarative on this line: fields marked `.volatile()` in `Config` become the settings form; the plugin subscribes to `loader/volatile-update` instead of receiving registration hooks.
 
 ## Why patch at all? (tool routing guide)
 
@@ -108,8 +110,8 @@ Enable with `allowCodexPatch: true`. When a Codex patch arrives while disabled,
 
 ```bash
 npm install
-npm run typecheck        # against 0.1.5-rc.3 peers (devDependencies)
-npm run typecheck:0.1.5  # static cross-proof against real 0.1.5-rc.2 peers
+npm run typecheck        # against 0.1.7-rc.2 peers (devDependencies)
+npm run typecheck:0.1.5  # legacy cross-proof against real 0.1.5-rc.2 peers
 npm test                 # vitest, 90 tests
 npm run lint
 npm run build            # lib/

package/README.zh.md

@@ -6,10 +6,12 @@
 
 | DSH 版本 | 状态 | 说明 |
 |---|---|---|
-| `0.1.5-rc.1+` | ✅ 支持（本线，v0.2.2+） | 类型基线钉在真实 `0.1.5-rc.3` peer 包；`peerDependencies`/`engines.dsh` 封顶到 `>=0.1.5-rc.1 <0.1.6-0`。经 `dsh-0.1.5` dist-tag 发布。 |
-| `0.1.2-rc.1` ~ `0.1.4` | ↗ 维护线 | 由已发布的 `0.1.2`（main 分支）服务。`0.1.6+` 是另一套契约（shell `run` → `execute`），由 compat/0.1.7 与 compat/0.2.0 线服务。 |
+| `0.1.7-rc.1+` | ✅ 支持（本线，v0.2.1+） | 声明式设置：`allowCodexPatch` 标记 `.volatile()`——设置表单自动生成，`loader/volatile-update` 驱动工具原位重注册（不 remount）。v0.2.3 修复 Delete/Move：shell 鸭子探测查 `run()` 在真实 0.1.7 宿主永不命中（`run` 在 0.1.2→0.1.7 间改名为 `execute`），Delete/Move 被静默降级为 UNSUPPORTED；现改用 `execute()` + `result()`。 |
+| `0.1.2-rc.1` ~ `0.1.4` | ↗ 维护线 | 由已发布的 `0.1.2`（main 分支）服务。 |
+| `0.1.5-rc.x` | ↗ 维护线 | 由 `dsh-0.1.5` dist-tag（v0.2.2+）服务。 |
+| `0.2.0-rc.1+` | ↗ 下一线 | 由 `dsh-0.2.0` dist-tag（v0.3.0+）服务。 |
 
-settings 注册走双 API 回退：0.1.2+ 的 `settings.installSection` 优先，旧版回退 `settings.register`。
+本线的 settings 是声明式的：`Config` 中标记 `.volatile()` 的字段即设置表单；插件订阅 `loader/volatile-update`，不再接收注册 hooks。
 
 ## 工具路由指引（为什么该用谁）
 
@@ -107,8 +109,8 @@ dsh web --dump-config   # 确认插件行出现
 
 ```bash
 npm install
-npm run typecheck        # 针对 0.1.5-rc.3 peer 包（devDependencies）
-npm run typecheck:0.1.5  # 对真实 0.1.5-rc.2 peer 包做交叉静态核验
+npm run typecheck        # 针对 0.1.7-rc.2 peer 包（devDependencies）
+npm run typecheck:0.1.5  # 对真实 0.1.5-rc.2 peer 包的遗留交叉核验
 npm test                 # vitest，90 个用例
 npm run lint
 npm run build            # lib/

package/dsh.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dsh-patch-edit-plus",
   "name": "dsh-patch-edit-plus",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": {
     "en": "Patch-style file editing: one apply_patch tool for git/unified diff (default) and Codex apply_patch syntax (opt-in), with all-or-nothing application and sandbox-aware delete/move.",
     "zh": "补丁风格文件编辑：单个 apply_patch 工具，接受 git/unified diff（默认）与 Codex apply_patch 语法（可选开启），全量验证后原子应用，删除/移动走沙箱感知 shell。"
@@ -13,7 +13,7 @@
   },
   "license": "MIT",
   "engines": {
-    "dsh": ">=0.1.5-rc.1 <0.1.6-0"
+    "dsh": ">=0.1.7-rc.1 <0.1.8-0"
   },
   "components": {
     "host": "lib/index.js"

package/lib/config.js

@@ -12,7 +12,7 @@ export const Config = z.object({
     conflictPolicy: z.union(['rename', 'skip', 'fail']).default('rename'),
     renameSuffix: z.string().default('_1'),
     allowUnifiedDiff: z.boolean().default(true),
-    allowCodexPatch: z.boolean().default(false),
+    allowCodexPatch: z.boolean().default(false).volatile(),
     deleteBackend: z.union(['shell', 'none']).default('shell'),
     shellDialect: z.union(['auto', 'posix', 'pwsh']).default('auto'),
     deleteCommand: z.string(),
@@ -23,6 +23,14 @@ export const Config = z.object({
     maxPatchBytes: z.number().step(1).min(1024).default(512 * 1024),
     maxDiffBytes: z.number().step(1).min(256).default(16 * 1024),
 });
+/** Read a `.volatile()` field: a live ref on 0.1.7+, a plain boolean otherwise. */
+export function readVolatileBoolean(value, fallback) {
+    if (typeof value === 'boolean')
+        return value;
+    if (value && typeof value.get === 'function')
+        return Boolean(value.get());
+    return fallback;
+}
 /** Fill user config with defaults; `undefined`/null entries fall back too. */
 export function resolveConfig(config) {
     const c = config ?? {};
@@ -31,7 +39,7 @@ export function resolveConfig(config) {
         conflictPolicy: c.conflictPolicy ?? 'rename',
         renameSuffix: typeof c.renameSuffix === 'string' ? c.renameSuffix : '_1',
         allowUnifiedDiff: c.allowUnifiedDiff ?? true,
-        allowCodexPatch: c.allowCodexPatch ?? false,
+        allowCodexPatch: readVolatileBoolean(c.allowCodexPatch, false),
         deleteBackend: c.deleteBackend ?? 'shell',
         shellDialect: c.shellDialect ?? 'auto',
         deleteCommand: typeof c.deleteCommand === 'string' && c.deleteCommand !== '' ? c.deleteCommand : undefined,

package/lib/index.js

@@ -4,14 +4,15 @@
  * One `apply_patch` tool accepting git/unified diff (default) and Codex
  * `apply_patch` syntax (opt-in). All-or-nothing application through the
  * official fs write-intent dance; delete/move through the sandbox-aware
- * shell. Compatible with DSH 0.1.2-rc.1 through 0.1.5-rc.2: the tool
- * authoring contract is byte-identical across those versions, so a single
- * code path serves both; only settings registration needs the dual-API
- * fallback (`installSection` first, `register` second).
+ * shell. Targets DSH 0.1.7+: settings are declarative — the fields marked
+ * `.volatile()` in `Config` render the settings form automatically (no
+ * registration call), and `loader/volatile-update` drives re-registration
+ * without a plugin remount. This line drops the pre-0.1.7 hosts; the
+ * 0.1.2-rc.1 ~ 0.1.5-rc.2 line stays on its maintenance branch.
  *
  * @module dsh-patch-edit-plus
  */
-import { Config, resolveConfig } from './config.js';
+import { resolveConfig } from './config.js';
 import { registerApplyPatchTool } from './register.js';
 /** Cordis plugin name used by Loader diagnostics. */
 export const name = 'dsh-patch-edit-plus';
@@ -31,26 +32,21 @@ export const name = 'dsh-patch-edit-plus';
  * in every profile that has no shell capability.
  */
 export const inject = ['tools', 'fs'];
+export { Config } from './config.js';
 /**
- * Settings namespace. Must match dsh-settings `NAMESPACE_PATTERN`
- * (`/^[a-z][a-z0-9-]*$/`) on every target version: letters, digits and
- * hyphens only — an underscore made `register()` throw before anything
- * persisted, so no migration is needed.
+ * Register the tool from the current config snapshot.
+ *
+ * 登记级 key。工具「描述」把可用语法固化进去了（tool.ts 拼 `Accepts ${styles}`），
+ * 所以判定必须覆盖整份 resolved config，而不是只看 allowCodexPatch。
  */
-export const SETTINGS_NAMESPACE = 'patch-edit-plus';
-export { Config };
-/** Register the tool and the settings namespace. Every registration is scoped to this plugin. */
 export function apply(ctx, config) {
+    // 组合条目（0.1.7 起 volatile 字段在其中是 live 引用）：rejudge 每次整体
+    // 重解析一次，一次调用内是同一份快照；跨调用的最新值由事件驱动重取。
     const compositionEntry = config ?? {};
-    // 权威来源：设置层挂载时是解析后的 scope，否则是组合条目。
-    // installSection 保证在每次匹配的 onChange 之前先调用 setSource（attach 与 detach 各一次）。
-    let readSource = () => compositionEntry;
     let disposer = null;
-    // 登记级 key。工具「描述」把可用语法固化进去了（tool.ts 拼 `Accepts ${styles}`），
-    // 所以判定必须覆盖整份 resolved config，而不是只看 allowCodexPatch。
     let registeredKey = null;
     const rejudge = () => {
-        const next = resolveConfig(readSource());
+        const next = resolveConfig(compositionEntry);
         const key = JSON.stringify(next);
         if (key === registeredKey)
             return;
@@ -66,23 +62,9 @@ export function apply(ctx, config) {
             registeredKey = null;
         };
     });
-    ctx.inject(['settings'], (settingsCtx) => {
-        const settings = settingsCtx.settings
-            ?? settingsCtx;
-        if (typeof settings?.installSection === 'function') {
-            settings.installSection(ctx, SETTINGS_NAMESPACE, Config, compositionEntry, {
-                setSource: (current) => { readSource = current; },
-                onChange: () => { rejudge(); },
-            });
-            return;
-        }
-        if (typeof settings?.register === 'function') {
-            const scope = settings.register(SETTINGS_NAMESPACE, Config, { base: compositionEntry });
-            if (scope !== undefined) {
-                readSource = () => scope.get();
-                scope.watch(() => { rejudge(); });
-                rejudge();
-            }
-        }
+    // 0.1.7+: 只有 volatile 字段变更才走这里（不 remount）；普通字段变更会整体
+    // remount 插件，新一次 `apply` 自然读到全部新值。等值变更宿主不通知。
+    ctx.on('loader/volatile-update', () => {
+        rejudge();
     });
 }

package/lib/shellops.js

@@ -36,7 +36,7 @@ export function moveTemplate(cfg) {
 export function resolveShell(ctx) {
     try {
         const shell = ctx.shell;
-        return shell !== undefined && typeof shell.run === 'function' && typeof shell.resolve === 'function' ? shell : undefined;
+        return shell !== undefined && typeof shell.execute === 'function' && typeof shell.resolve === 'function' ? shell : undefined;
     }
     catch {
         return undefined;
@@ -87,7 +87,8 @@ function requireShell(ctx, cfg) {
 }
 async function runShell(shell, request) {
     try {
-        return await shell.run(shell.resolve(request));
+        const execution = await shell.execute(shell.resolve(request));
+        return await execution.result();
     }
     catch (error) {
         const detail = error instanceof Error ? error.message : String(error);

package/lib/types/config.d.ts

@@ -6,6 +6,7 @@
  * @module dsh-patch-edit-plus/config
  */
 import z from '@deepseek-ai/schemastery';
+import type { Volatile } from '@deepseek-ai/cosmokit';
 /** What to do when the configured tool name is already taken at registration. */
 export type ConflictPolicy = 'rename' | 'skip' | 'fail';
 /** Backend used for Delete/Move operations (`ctx.fs` has no delete/move). */
@@ -22,8 +23,10 @@ export interface Config {
     renameSuffix?: string;
     /** Accept git/unified diff patches. Defaults to true. */
     allowUnifiedDiff?: boolean;
-    /** Accept Codex `apply_patch` syntax. Defaults to false. */
-    allowCodexPatch?: boolean;
+    /** Accept Codex `apply_patch` syntax. Defaults to false.
+     * 0.1.7 `.volatile()`: the loader hands `apply` a live `Volatile` ref for this
+     * field — always read it through `readVolatileBoolean`, never cache the ref. */
+    allowCodexPatch?: boolean | Volatile<boolean>;
     /** Delete/Move backend. Defaults to `shell`. `none` rejects Delete/Move with a structured error. */
     deleteBackend?: DeleteBackend;
     /** Shell dialect for the constant delete/move templates. Defaults to `auto` (pwsh on win32). */
@@ -44,7 +47,37 @@ export interface Config {
     maxDiffBytes?: number;
 }
 /** Schemastery schema for Loader defaults and generated configuration docs. */
-export declare const Config: z<Config>;
+export declare const Config: z<Schemastery.ObjectS<NoInfer<{
+    toolName: z<string, string, "defined">;
+    conflictPolicy: z<"rename" | "skip" | "fail", "rename" | "skip" | "fail", "defined">;
+    renameSuffix: z<string, string, "defined">;
+    allowUnifiedDiff: z<boolean, boolean, "defined">;
+    allowCodexPatch: z<boolean, boolean, "volatile-defined">;
+    deleteBackend: z<"shell" | "none", "shell" | "none", "defined">;
+    shellDialect: z<"auto" | "posix" | "pwsh", "auto" | "posix" | "pwsh", "defined">;
+    deleteCommand: z<string, string, "plain">;
+    moveCommand: z<string, string, "plain">;
+    dryRunByDefault: z<boolean, boolean, "defined">;
+    followSymlinks: z<boolean, boolean, "defined">;
+    maxFiles: z<number, number, "defined">;
+    maxPatchBytes: z<number, number, "defined">;
+    maxDiffBytes: z<number, number, "defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    toolName: z<string, string, "defined">;
+    conflictPolicy: z<"rename" | "skip" | "fail", "rename" | "skip" | "fail", "defined">;
+    renameSuffix: z<string, string, "defined">;
+    allowUnifiedDiff: z<boolean, boolean, "defined">;
+    allowCodexPatch: z<boolean, boolean, "volatile-defined">;
+    deleteBackend: z<"shell" | "none", "shell" | "none", "defined">;
+    shellDialect: z<"auto" | "posix" | "pwsh", "auto" | "posix" | "pwsh", "defined">;
+    deleteCommand: z<string, string, "plain">;
+    moveCommand: z<string, string, "plain">;
+    dryRunByDefault: z<boolean, boolean, "defined">;
+    followSymlinks: z<boolean, boolean, "defined">;
+    maxFiles: z<number, number, "defined">;
+    maxPatchBytes: z<number, number, "defined">;
+    maxDiffBytes: z<number, number, "defined">;
+}>>, "plain">;
 /** Fully-resolved configuration used by the tool body. */
 export interface ResolvedConfig {
     toolName: string;
@@ -62,5 +95,7 @@ export interface ResolvedConfig {
     maxPatchBytes: number;
     maxDiffBytes: number;
 }
+/** Read a `.volatile()` field: a live ref on 0.1.7+, a plain boolean otherwise. */
+export declare function readVolatileBoolean(value: boolean | Volatile<boolean> | undefined, fallback: boolean): boolean;
 /** Fill user config with defaults; `undefined`/null entries fall back too. */
 export declare function resolveConfig(config: Config | undefined): ResolvedConfig;

package/lib/types/index.d.ts

@@ -4,16 +4,21 @@
  * One `apply_patch` tool accepting git/unified diff (default) and Codex
  * `apply_patch` syntax (opt-in). All-or-nothing application through the
  * official fs write-intent dance; delete/move through the sandbox-aware
- * shell. Compatible with DSH 0.1.2-rc.1 through 0.1.5-rc.2: the tool
- * authoring contract is byte-identical across those versions, so a single
- * code path serves both; only settings registration needs the dual-API
- * fallback (`installSection` first, `register` second).
+ * shell. Targets DSH 0.1.7+: settings are declarative — the fields marked
+ * `.volatile()` in `Config` render the settings form automatically (no
+ * registration call), and `loader/volatile-update` drives re-registration
+ * without a plugin remount. This line drops the pre-0.1.7 hosts; the
+ * 0.1.2-rc.1 ~ 0.1.5-rc.2 line stays on its maintenance branch.
  *
  * @module dsh-patch-edit-plus
  */
 import type { Context } from '@deepseek-ai/cordis';
-import { Config } from './config.js';
 import type { Config as PluginConfig } from './config.js';
+declare module '@deepseek-ai/cordis' {
+    interface Events {
+        'loader/volatile-update': (paths: string[]) => void;
+    }
+}
 /** Cordis plugin name used by Loader diagnostics. */
 export declare const name = "dsh-patch-edit-plus";
 /**
@@ -32,13 +37,11 @@ export declare const name = "dsh-patch-edit-plus";
  * in every profile that has no shell capability.
  */
 export declare const inject: string[];
+export { Config } from './config.js';
 /**
- * Settings namespace. Must match dsh-settings `NAMESPACE_PATTERN`
- * (`/^[a-z][a-z0-9-]*$/`) on every target version: letters, digits and
- * hyphens only — an underscore made `register()` throw before anything
- * persisted, so no migration is needed.
+ * Register the tool from the current config snapshot.
+ *
+ * 登记级 key。工具「描述」把可用语法固化进去了（tool.ts 拼 `Accepts ${styles}`），
+ * 所以判定必须覆盖整份 resolved config，而不是只看 allowCodexPatch。
  */
-export declare const SETTINGS_NAMESPACE = "patch-edit-plus";
-export { Config };
-/** Register the tool and the settings namespace. Every registration is scoped to this plugin. */
 export declare function apply(ctx: Context, config?: PluginConfig): void;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-patch-edit-plus",
-  "version": "0.2.2",
-  "description": "Patch-style file editing for DeepSeek Harness: one apply_patch tool accepting git/unified diff (default) and Codex apply_patch syntax (opt-in), with all-or-nothing application, read-before-write intent dance, sandbox-aware delete/move, and 0.1.5-rc line compatibility (dsh-0.1.5 dist-tag).",
+  "version": "0.2.3",
+  "description": "Patch-style file editing for DeepSeek Harness: one apply_patch tool accepting git/unified diff (default) and Codex apply_patch syntax (opt-in), with all-or-nothing application, read-before-write intent dance, sandbox-aware delete/move, with a DSH 0.1.7+ line (declarative volatile settings).",
   "type": "module",
   "repository": {
     "type": "git",
@@ -47,7 +47,7 @@
   },
   "engines": {
     "node": ">=20",
-    "dsh": ">=0.1.5-rc.1 <0.1.6-0"
+    "dsh": ">=0.1.7-rc.1 <0.1.8-0"
   },
   "license": "MIT",
   "keywords": [
@@ -62,10 +62,10 @@
   ],
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-fs": ">=0.1.5-rc.1 <0.1.6-0",
-    "@deepseek-ai/dsh-sandbox": ">=0.1.5-rc.1 <0.1.6-0",
-    "@deepseek-ai/dsh-shell": ">=0.1.5-rc.1 <0.1.6-0",
-    "@deepseek-ai/dsh-tools": ">=0.1.5-rc.1 <0.1.6-0"
+    "@deepseek-ai/dsh-fs": ">=0.1.7-rc.1 <0.1.8-0",
+    "@deepseek-ai/dsh-sandbox": ">=0.1.7-rc.1 <0.1.8-0",
+    "@deepseek-ai/dsh-shell": ">=0.1.7-rc.1 <0.1.8-0",
+    "@deepseek-ai/dsh-tools": ">=0.1.7-rc.1 <0.1.8-0"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/cordis": {
@@ -85,19 +85,23 @@
     }
   },
   "dependencies": {
-    "@deepseek-ai/schemastery": "^3.18.2"
+    "@deepseek-ai/schemastery": "^3.18.4"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-fs": "0.1.5-rc.3",
-    "@deepseek-ai/dsh-sandbox": "0.1.5-rc.3",
-    "@deepseek-ai/dsh-shell": "0.1.5-rc.3",
-    "@deepseek-ai/dsh-tools": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-fs": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-sandbox": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-shell": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-tools": "0.1.7-rc.2",
     "@eslint/js": "^9.0.0",
     "@types/node": "^22.0.0",
     "eslint": "^9.0.0",
     "typescript": "^5.6.0",
     "typescript-eslint": "^8.0.0",
-    "vitest": "^3.0.0"
+    "vitest": "^3.0.0",
+    "@deepseek-ai/schemastery": "^3.18.4"
+  },
+  "publishConfig": {
+    "tag": "dsh-0.1.7"
   }
 }