dsh-loop-engine 1.0.0-rc2 → 1.0.0-rc3

package/README.md

@@ -22,9 +22,21 @@ without changing anything in the main repository.
 - **Extensible.** Adding an engine is one driver module plus one entry in the
   settings schema.
 - **Zero main-repo changes.** Installed purely as a profile dependency plus one
-  composition row.
+  bundle layer, with no edits to the main repository.
 
-## Requirements
+## Install
+
+```sh
+dsh plugin --profile web add dsh-loop-engine
+```
+
+Restart `dsh web`, then open **Settings → Loop engine**.
+
+`dsh plugin add` installs the package into the web profile and registers it as
+a bundle layer — the package declares `dsh.bundle.patch`, so no manual edit of
+`cordis.patch.yml` is needed. It is published on npm as `dsh-loop-engine`.
+
+### Requirements
 
 - dsh `0.1.1-rc.2` (or a build whose peer packages match).
 - For the Claude Code engine: the Claude Code CLI installed and logged in on
@@ -40,46 +52,22 @@ without changing anything in the main repository.
   (the profile's `shims/` directory). A deployed install with one published
   `node_modules` needs no shims.
 
-## Configuration
-
-1. Build the plugin:
-
-   ```sh
-   pnpm install && pnpm run build
-   ```
-
-2. Add the dependency in `$DSH_HOME/profiles/web/package.json`:
-
-   ```json
-   "dependencies": {
-     "dsh-loop-engine": "1.0.0-rc2",
-     "...keep existing deps"
-   }
-   ```
-
-   The package is published on npm as `dsh-loop-engine`. For local
-   development, use a `file:` reference to your checkout instead of the version
-   string.
-
-3. Append one composition row in `$DSH_HOME/profiles/web/cordis.patch.yml`:
-
-   ```yaml
-   - insert:
-       - id: loop-engine
-         name: 'dsh-loop-engine'
-   ```
+> Switching engines rewrites a small managed block in `cordis.patch.yml`.
+> Everything else you wrote in that file is preserved; only the plugin's own
+> span changes.
 
-4. Install and restart:
+### Local development
 
-   ```sh
-   cd $DSH_HOME/profiles/web && pnpm install
-   ```
+To work against a checkout instead of the published package, add it with a
+`file:` reference (build it first — the package has no `prepare` script, so
+pnpm will not build it for you):
 
-   Restart `dsh web` once so the plugin is picked up.
+```sh
+cd /path/to/dsh-loop-engine && pnpm install && pnpm run build
+dsh plugin --profile web add file:/path/to/dsh-loop-engine
+```
 
-> Switching engines rewrites a small managed block in `cordis.patch.yml`.
-> Everything else you wrote in that file is preserved; only the plugin's own
-> span changes.
+Or, from inside the checkout: `dsh plugin --profile web add .`
 
 ## Usage
 
@@ -91,9 +79,8 @@ without changing anything in the main repository.
    - **Pi CLI** — the Pi (earendil-works/pi) driver.
 3. Switching between these applies after restarting `dsh web`. To return
    to the default, pick **In-process** and restart again.
-4. To remove the plugin: delete the `loop-engine` row from
-   `cordis.patch.yml`, drop the dependency from `package.json`, then
-   `pnpm install` and restart `dsh web`.
+4. To remove the plugin: `dsh plugin --profile web remove dsh-loop-engine`, then
+   restart `dsh web`.
 
 ### Codex engine details
 

package/README.zh.md

@@ -11,9 +11,19 @@
 - **Codex 执行。** 驱动 spawn `codex app-server` 并把其 token 级增量流式转发进会话日志,每一步一个 turn。
 - **Pi 执行。** 驱动 spawn `pi --mode rpc` 并把其 `message_update` 增量流式转发进会话日志,每一步一个无状态 `new_session` + `prompt`。
 - **可扩展。** 新增引擎只需加一个驱动模块 + 设置 schema 里加一个枚举值。
-- **零主仓改动。** 仅作为 profile 依赖 + 一行组合配置安装。
+- **零主仓改动。** 仅作为 profile 依赖 + 一个 bundle 层安装,无需改动主仓库。
 
-## 环境要求
+## 安装
+
+```sh
+dsh plugin --profile web add dsh-loop-engine
+```
+
+重启 `dsh web`,然后打开 **Settings → Loop engine**。
+
+`dsh plugin add` 会把包装进 web profile,并注册为 bundle 层——包声明了 `dsh.bundle.patch`,所以无需手动改 `cordis.patch.yml`。包已发布到 npm,名称 `dsh-loop-engine`。
+
+### 环境要求
 
 - dsh `0.1.1-rc.2`(或 peer 包版本匹配的构建)。
 - 使用 Claude Code 引擎时需要本机已安装并登录 Claude Code CLI。
@@ -21,42 +31,18 @@
 - 使用 Pi 引擎时需要以 `pi` 要求的方式完成认证(其自身的 `~/.pi/agent/auth.json`,或提供方的 API-key 环境变量,如 `ANTHROPIC_API_KEY`)。
 - 当 harness 以**源码方式**运行(如在 `deepseek-harness` 仓库内执行 `pnpm dsh`)时,profile 需要把本插件的 harness peer 包解析到主仓 **源码**,通过 profile 的 `shims/` 目录里的本地 `file:` 垫片实现;正式部署(单一发布版 `node_modules`)则无需垫片。
 
-## 配置方法
-
-1. 构建插件:
-
-   ```sh
-   pnpm install && pnpm run build
-   ```
-
-2. 在 `$DSH_HOME/profiles/web/package.json` 添加依赖:
-
-   ```json
-   "dependencies": {
-     "dsh-loop-engine": "1.0.0-rc2",
-     "...保留其余依赖"
-   }
-   ```
-
-   包已发布到 npm,名称 `dsh-loop-engine`。本地开发时改用指向你本地代码副本的 `file:` 引用。
-
-3. 在 `$DSH_HOME/profiles/web/cordis.patch.yml` 追加一行组合:
-
-   ```yaml
-   - insert:
-       - id: loop-engine
-         name: 'dsh-loop-engine'
-   ```
+> 切换引擎会重写 `cordis.patch.yml` 中一小段受管理的内容,文件里你写的其它部分都会保留,只改动插件自己的区间。
 
-4. 安装并重启:
+### 本地开发
 
-   ```sh
-   cd $DSH_HOME/profiles/web && pnpm install
-   ```
+要加载本地 checkout 而非已发布包时,用 `file:` 引用添加(需先构建——本包没有 `prepare` 脚本,pnpm 不会替你构建):
 
-   重启一次 `dsh web` 使插件生效。
+```sh
+cd /path/to/dsh-loop-engine && pnpm install && pnpm run build
+dsh plugin --profile web add file:/path/to/dsh-loop-engine
+```
 
-> 切换引擎会重写 `cordis.patch.yml` 中一小段受管理的内容,文件里你写的其它部分都会保留,只改动插件自己的区间。
+或者,在 checkout 目录内直接 `dsh plugin --profile web add .`
 
 ## 使用方法
 
@@ -67,7 +53,7 @@
    - **Codex CLI** —— OpenAI Codex 驱动;
    - **Pi CLI** —— Pi(earendil-works/pi)驱动。
 3. 引擎之间切换在**重启 `dsh web` 后生效**;切回默认时选择 **In-process** 并再次重启即可。
-4. 卸载插件:从 `cordis.patch.yml` 删除 `loop-engine` 行,并从 `package.json` 移除依赖,然后 `pnpm install` 并重启 `dsh web`。
+4. 卸载插件:`dsh plugin --profile web remove dsh-loop-engine`,然后重启 `dsh web`。
 
 ### Codex 引擎的实现细节
 

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: loop-engine
+      name: 'dsh-loop-engine'

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-loop-engine",
   "description": "Web-switchable agent loop engine selection for the DeepSeek Harness - out-of-tree plugin (Claude Code / Codex drivers) maintained by @kuun993, zero main-repo changes",
-  "version": "1.0.0-rc2",
+  "version": "1.0.0-rc3",
   "publishConfig": {
     "access": "public"
   },
@@ -29,7 +29,8 @@
     "lib/index.js",
     "lib/invariant.js",
     "lib/client.js",
-    "lib/types/**/*.d.ts"
+    "lib/types/**/*.d.ts",
+    "cordis.patch.yml"
   ],
   "license": "MIT",
   "scripts": {