@boyingliu01/dsh-plugin-xp-gate 0.19.3 → 0.20.1

package/README.md

@@ -1,14 +1,18 @@
 # @boyingliu01/dsh-plugin-xp-gate
 
-XP-Gate deterministic quality gates + AI workflow skills as a **DeepSeek Harness (DSH)** native plugin.
+XP-Gate 确定性质量门禁 + AI 工作流技能，作为 **DeepSeek Harness (DSH)** 原生插件（bundle）。
+
+> 关联 Issue: #393　设计文档: `docs/plans/2026-08-23-dsh-plugin-design.md`
+> 集成评估: `docs/plans/2026-09-30-dsh-integration-assessment.md`
 
 ## Tools
 
 | Tool | Purpose |
 |------|---------|
 | `gate-check` | Run XP-Gate quality gates (`xp-gate check`) on a file or directory |
-| `gate-principles` | Run the 14 Clean Code/SOLID rules (`xp-gate principles`, Gate 4) |
+| `gate-principles` | Run the Clean Code/SOLID rules (`xp-gate principles`, Gate 4) |
 | `gate-arch` | Run architecture validation (`xp-gate arch`, Gate 6) |
+| `delphi-review` | **多模型交叉评审**：用 3 个不同模型独立评审同一份材料并迭代到共识（见下） |
 
 ## Install
 
@@ -16,10 +20,171 @@ XP-Gate deterministic quality gates + AI workflow skills as a **DeepSeek Harness
 dsh plugin --profile <name> add @boyingliu01/dsh-plugin-xp-gate
 ```
 
-The tools require a global `xp-gate` CLI:
+The `gate-*` tools require a global `xp-gate` CLI:
 
 ```bash
 npm install -g @boyingliu01/xp-gate
 ```
 
-When `xp-gate` is missing the tools degrade gracefully (tool-missing → SKIP-style message) rather than erroring.
+When `xp-gate` is missing those tools degrade gracefully (tool-missing → SKIP-style message) rather than erroring.
+
+## 跨平台：shell 方言层
+
+DSH 在非 Windows 上使用 POSIX shell、在 Windows 上使用 **PowerShell executor**
+（`dsh-base` bundle 里 `bash-sandbox` 在 win32 被禁用、`pwsh-sandbox` 启用）。
+
+插件最初硬编码 POSIX 命令串，导致三个工具在 Windows 上**全部解析失败**：
+
+```
+[stderr] ParserError:
+   1 |  if command -v xp-gate >/dev/null 2>&1; then xp-gate principles 'D:\pr …
+     |    ~
+     | if语句中的'if'后缺少"(”。
+[exit code: 1]
+```
+
+现已按平台生成对应方言（`src/dialect.ts`）：
+
+| POSIX | PowerShell |
+|-------|-----------|
+| `command -v X` | `Get-Command X -ErrorAction SilentlyContinue` |
+| `printf '%s\n' '...'` | `Write-Output '...'` |
+| `'\''`（单引号转义） | `''`（单引号内双写） |
+
+实测（Windows + PowerShell executor）：`gate-check` exit 0、`gate-principles` exit 0（`Rules run: 15`）。
+
+## 多模型交叉评审（`delphi-review`）
+
+### 为什么需要它，而不是用 DSH 的 subagent
+
+Delphi 方法的价值**完全建立在「评审者是不同模型」之上**。DSH 的 `subagent` 工具继承宿主
+配置的**单一**模型，因此三个"专家"会是同一个模型的三个实例 —— 按 `delphi-review` skill
+自身的规则必须 BLOCK。
+
+所以本工具**直接调用外部 OpenAI 兼容网关**，每个席位绑定一个不同模型。
+
+> 另一条路线是打开 DSH 的 `subagentModelSelection`（Web GUI → **Plugins**），让 subagent
+> 也能选模型。两者并不冲突：那条路线让 DSH 原生 subagent 具备多模型能力，本工具则在
+> **不依赖宿主配置**的前提下保证不变量成立（包括 CI / 一次性会话）。
+
+### 配置
+
+复用项目既有的 `.delphi-config.json`（skill 与工具**同一份配置**）：
+
+```jsonc
+{
+  "active_profile": "whalecloud",
+  "profiles": {
+    "whalecloud": {
+      "providers": {
+        "whalecloud": {
+          "base_url": "https://<gateway>/gpt-proxy",
+          "api_key": "${WHALECLOUD_API_KEY}"   // 支持 ${VAR} 与 {env:VAR} 两种写法
+        }
+      },
+      "experts": {                              // 对象形式；key 即角色
+        "architecture": { "provider": "whalecloud", "model": "g-glm-5.3-flash" },
+        "technical":    { "provider": "whalecloud", "model": "g-qwen3.8-flash" },
+        "feasibility":  { "provider": "whalecloud", "model": "g-deepseek-flash" }
+      }
+    }
+  },
+  "consensus": { "threshold_percent": 90, "max_review_rounds": 5 }
+}
+```
+
+密钥**只从环境变量读取**，绝不写入配置文件。
+`experts` 同时接受**对象形式**（key 为角色）与**数组形式**（explicit `role` 字段）。
+
+### 强制的不变量（代码强制，非文档约定）
+
+| 不变量 | 违反时 |
+|---|---|
+| 恰好 3 位专家 | `DelphiConfigError` |
+| 3 个 `requested_model` 去空白后两两不同 | `DelphiConfigError` |
+| 模型不得为未展开的 `${...}` 占位符 | `DelphiConfigError`（在网络调用**之前**） |
+| 缺密钥 / 缺 provider / 专家跨网关 | `DelphiSetupError`，报出变量名而非回显配置 |
+| 报告缺 `### VERDICT` 段 | 记为 `INVALID_NO_VERDICT`，**不计入共识**（绝不从散文里猜裁决） |
+| 退出码 0 但内容为空 | 记为 ERROR（推理模型可能把预算全烧在隐藏 token 上） |
+| 共识按**全体席位数**计算 | 一份畸形报告不能靠其余全票"凑"出共识 |
+
+共识阈值为百分比：3 席时 ≥90% 意味着**必须 3/3 通过**。
+
+### 轮次语义
+
+- **Round 1 匿名且并发**：各席位互不可见。
+- **Round 2+**：回传**汇总票型**（`architecture: APPROVED` …）与"已修改项"，
+  各席位据此修正或坚持立场。**个体报告始终匿名** —— 只共享计票，这是方法可信的前提。
+- 达到阈值即停；否则到 `max_review_rounds`（默认 5）为止，并如实返回 `NO CONSENSUS`。
+
+### 已知行为（实测）
+
+用一段**故意有缺陷**的样例代码喂给三个模型，15 次调用（5 轮 × 3 模型）全部成功且
+`resolved_model` 两两不同，三个模型**独立**指出同一个真实缺陷：
+`{ ok: true }` 是**无条件**返回的常量，"把退出码契约换成了一个常量，而不是真正的结果信号"。
+机制**拒绝**给出共识，而不是盖章通过 —— 这正是它该有的行为。
+
+## Skills
+
+本包在 publish 时通过 `scripts/prepack.cjs` 捆绑仓库 `skills/`（当前 12 个）。
+
+要让 DSH 直接看到**仓库版** skill（而非 `~/.agents/skills` 里指向 `~/.qoder/skills` 的 junction），
+运行仓库提供的准备脚本：
+
+```powershell
+pwsh -File plugins/dsh/setup-dsh.ps1           # 全部（skill 链接 + 编译 + 提示）
+pwsh -File plugins/dsh/setup-dsh.ps1 -WhatIf   # 只预览
+```
+
+该脚本在 `$DSH_HOME/skills`（DSH 发现根 rank 400）为仓库每个 skill 建 junction，保持单一真源。
+
+> DSH 只读 skill frontmatter 的 6 个字段：`name`、`description`、`whenToUse`、
+> `metadata`、`disable-model-invocation`、`user-invocable`。
+> 本仓库 skill 里的 `allowed-tools` / `hooks` / `triggers` / `maturity` / `auto_continue`
+> **会被静默忽略**（无害，但不生效）。`references/` 子目录可用 —— DSH 的 `skill` 工具返回
+> base directory，模型按需用 read 工具加载。
+
+## 备选路线：启用 DSH 原生 subagent 模型选择
+
+上面的 `delphi-review` 工具不依赖宿主配置即可保证不变量。若你希望 DSH **原生**
+`subagent` 工具也能指定模型（例如让 Agent Teams 的队友跑不同模型），需显式启用
+（Web GUI → **Plugins** 页面）：
+
+```
+subagent model selection:
+  enabled = true
+  allowedModels = [
+    { provider: 'whalecloud', model: 'g-glm-5.3-flash'  },
+    { provider: 'whalecloud', model: 'g-qwen3.8-flash'  },
+    { provider: 'whalecloud', model: 'g-deepseek-flash' }
+  ]
+```
+
+启用后 `subagent` 工具会新增 `provider` / `model` / `reasoning_effort` 参数，
+并注册 `list_subagent_models` 工具。
+
+> 注意：`dsh-tool-subagent` 的 `modelSelectionSettings: true` **只是能力开关**；
+> 实际策略来自宿主设置 `SubagentModelSelectionConfig`（`enabled` 默认 `false`，
+> `allowedModels` 默认 `[]`）。两者都要满足才会生效。
+
+## Build
+
+```bash
+npm install --ignore-scripts   # --ignore-scripts 绕过 esbuild postinstall（受限环境会 EBUSY）
+npm run build                  # tsc -> lib/
+npm run prepare-skills         # 从仓库 skills/ 复制
+npm test                       # vitest
+```
+
+或在仓库根目录：
+
+```bash
+npm run build:dsh-plugin       # = node scripts/build-plugin.mjs --platform dsh
+```
+
+## 注意
+
+- `lib/` 与 `skills/` 是**构建产物**（已 gitignore），不提交。
+- `scripts/prepack.cjs` 目前硬编码 12 个 skill，**不含 `clipboard-vision`**（仓库有 13 个）。
+- `plugins/dsh/package.json` 的 peerDeps 仍 pin `0.1.1-rc.2`，但实测运行在 `0.2.0-rc.2` 上
+  `defineTool` / `TOOL_ABORTED` / `HarnessError` 签名未变，无需改写。

package/lib/command.d.ts

@@ -1,3 +1,5 @@
+import { type ShellDialect } from "./dialect.js";
+export { type ShellDialect, detectDialect, shellQuote, shq } from "./dialect.js";
 /** Shown when the global `xp-gate` CLI is not on PATH. */
 export declare const FALLBACK_MESSAGE = "[XP-Gate] xp-gate CLI not installed. Install it with: npm install -g @boyingliu01/xp-gate";
 /**
@@ -7,19 +9,22 @@ export declare const FALLBACK_MESSAGE = "[XP-Gate] xp-gate CLI not installed. In
  */
 export declare const GATE_WHITELIST: readonly ["duplicates", "complexity", "principles", "arch", "architecture", "iac", "secrets", "sast"];
 export type GateId = (typeof GATE_WHITELIST)[number];
-/** POSIX single-quote shell escaping: `'` becomes `'\''`. */
-export declare function shq(value: string): string;
 export declare function isGateAllowed(gate: string): boolean;
 export interface BuildCommandOptions {
     subcommand: "check" | "principles" | "arch";
     target?: string;
     gates?: readonly string[];
     config?: string;
+    /**
+     * Executor dialect. Defaults to `"posix"` so existing callers keep working;
+     * callers running under DSH on Windows must pass `"powershell"`.
+     */
+    dialect?: ShellDialect;
 }
 /**
  * Build a single guarded shell command: runs `xp-gate …` when the global CLI
  * is present, otherwise prints the graceful-degradation hint. A single
- * `if command -v` avoids a separate probe/run race.
+ * presence check avoids a separate probe/run race.
  */
 export declare function buildCommand(options: BuildCommandOptions): string;
 /** Resolve a model-supplied path against the session cwd; absolutes pass through. */

package/lib/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAEA,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,8FACgE,CAAA;AAE7F;;;;GAIG;AACH,eAAO,MAAM,cAAc,uGASjB,CAAA;AAEV,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpD,6DAA6D;AAC7D,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,OAAO,GAAG,YAAY,GAAG,MAAM,CAAA;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAuBD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAGjE;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAElE"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,YAAY,EAAc,MAAM,cAAc,CAAA;AAI5D,OAAO,EAAE,KAAK,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAEhF,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,8FACgE,CAAA;AAE7F;;;;GAIG;AACH,eAAO,MAAM,cAAc,uGASjB,CAAA;AAEV,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,OAAO,GAAG,YAAY,GAAG,MAAM,CAAA;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAA;CACvB;AAwBD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAmBjE;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAElE"}

package/lib/command.js

@@ -1,4 +1,8 @@
 import { isAbsolute, resolve } from "node:path";
+import { shellQuote } from "./dialect.js";
+// Re-exported so existing importers of this module keep working; the dialect
+// primitives themselves live in ./dialect.ts.
+export { detectDialect, shellQuote, shq } from "./dialect.js";
 /** Shown when the global `xp-gate` CLI is not on PATH. */
 export const FALLBACK_MESSAGE = "[XP-Gate] xp-gate CLI not installed. Install it with: npm install -g @boyingliu01/xp-gate";
 /**
@@ -16,44 +20,51 @@ export const GATE_WHITELIST = [
     "secrets",
     "sast",
 ];
-/** POSIX single-quote shell escaping: `'` becomes `'\''`. */
-export function shq(value) {
-    return `'${value.replace(/'/g, "'\\''")}'`;
-}
 export function isGateAllowed(gate) {
     return GATE_WHITELIST.includes(gate);
 }
-function buildInner(options) {
+function buildInner(options, dialect) {
     const { subcommand, target, gates, config } = options;
+    const q = (value) => shellQuote(value, dialect);
     if (subcommand === "check") {
         const tokens = ["xp-gate", "check"];
         if (target !== undefined)
-            tokens.push(shq(target));
+            tokens.push(q(target));
         if (gates !== undefined && gates.length > 0) {
             // Defense-in-depth: the JSON-schema enum already rejects unknown gate ids,
             // but we also whitelist here so a non-whitelisted value can never reach the shell.
             const allowed = gates.filter(isGateAllowed);
             if (allowed.length > 0)
-                tokens.push("--gates", shq(allowed.join(",")));
+                tokens.push("--gates", q(allowed.join(",")));
         }
         return tokens.join(" ");
     }
     if (subcommand === "principles") {
         const tokens = ["xp-gate", "principles"];
         if (target !== undefined)
-            tokens.push(shq(target));
+            tokens.push(q(target));
         return tokens.join(" ");
     }
-    return ["xp-gate", "arch", "--config", shq(config ?? "architecture.yaml")].join(" ");
+    return ["xp-gate", "arch", "--config", q(config ?? "architecture.yaml")].join(" ");
 }
 /**
  * Build a single guarded shell command: runs `xp-gate …` when the global CLI
  * is present, otherwise prints the graceful-degradation hint. A single
- * `if command -v` avoids a separate probe/run race.
+ * presence check avoids a separate probe/run race.
  */
 export function buildCommand(options) {
-    const inner = buildInner(options);
-    return `if command -v xp-gate >/dev/null 2>&1; then ${inner}; else printf '%s\\n' ${shq(FALLBACK_MESSAGE)}; fi`;
+    const dialect = options.dialect ?? "posix";
+    const inner = buildInner(options, dialect);
+    if (dialect === "posix") {
+        return `if command -v xp-gate >/dev/null 2>&1; then ${inner}; else printf '%s\\n' ${shellQuote(FALLBACK_MESSAGE, dialect)}; fi`;
+    }
+    // PowerShell: `Get-Command` resolves the .cmd/.ps1 shims npm writes to
+    // %APPDATA%\npm. Those shims are invisible to a Git-Bash PATH lookup, so this
+    // branch is more reliable than `command -v` on Windows.
+    //
+    // The hint branch leaves $LASTEXITCODE untouched at 0, matching the POSIX
+    // branch's `printf` behaviour.
+    return `if (Get-Command xp-gate -ErrorAction SilentlyContinue) { ${inner} } else { Write-Output ${shellQuote(FALLBACK_MESSAGE, dialect)} }`;
 }
 /** Resolve a model-supplied path against the session cwd; absolutes pass through. */
 export function resolveTarget(rawPath, cwd) {

package/lib/command.js.map

@@ -1 +1 @@
-{"version":3,"file":"command.js","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAE/C,0DAA0D;AAC1D,MAAM,CAAC,MAAM,gBAAgB,GAC3B,2FAA2F,CAAA;AAE7F;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,MAAM;IACN,cAAc;IACd,KAAK;IACL,SAAS;IACT,MAAM;CACE,CAAA;AAIV,6DAA6D;AAC7D,MAAM,UAAU,GAAG,CAAC,KAAa;IAC/B,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAA;AAC5C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAQ,cAAoC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;AAC7D,CAAC;AASD,SAAS,UAAU,CAAC,OAA4B;IAC9C,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IACrD,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QACnC,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,2EAA2E;YAC3E,mFAAmF;YACnF,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;YAC3C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACxE,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACzB,CAAC;IACD,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,CAAC,SAAS,EAAE,YAAY,CAAC,CAAA;QACxC,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QAClD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACzB,CAAC;IACD,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,IAAI,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACtF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,OAA4B;IACvD,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;IACjC,OAAO,+CAA+C,KAAK,yBAAyB,GAAG,CAAC,gBAAgB,CAAC,MAAM,CAAA;AACjH,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,GAAW;IACxD,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;AAC9D,CAAC"}
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"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"}

package/lib/delphi-config.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Delphi configuration loading for the DSH plugin.
+ *
+ * Reads the same `.delphi-config.json` the xp-gate skill already uses, so a
+ * project configures its reviewers once and both the skill and the DSH tool
+ * agree on who they are.
+ *
+ * @test REQ-DSH-016
+ * @intent 复用项目既有的 .delphi-config.json，把 provider/api_key/专家席位解析成
+ *         DSH 工具可用的结构，并对 ${ENV} 占位符与缺失密钥给出可操作的报错。
+ * @covers AC-DSH-016-02
+ */
+import type { ExpertSeat, DelphiOptions } from "./delphi.js";
+/** Shape of one expert entry in .delphi-config.json. */
+interface RawExpert {
+    id?: string;
+    role?: string;
+    name?: string;
+    model?: string;
+    requested_model?: string;
+    max_tokens?: number;
+    maxTokens?: number;
+    /** Per-expert provider override; falls back to the profile default. */
+    provider?: string;
+}
+interface RawProfile {
+    provider?: string;
+    providers?: Record<string, {
+        base_url?: string;
+        baseUrl?: string;
+        api_key?: string;
+        apiKey?: string;
+    }>;
+    /**
+     * Experts appear in two shapes in the wild: an object keyed by role (what
+     * xp-gate actually writes) and an array. Both are accepted.
+     */
+    experts?: RawExpert[] | Record<string, RawExpert>;
+    consensus?: {
+        threshold_percent?: number;
+        max_review_rounds?: number;
+    };
+}
+export interface RawDelphiConfig extends RawProfile {
+    active_profile?: string;
+    profiles?: Record<string, RawProfile>;
+}
+export interface ResolvedDelphiConfig {
+    readonly seats: ExpertSeat[];
+    readonly baseUrl: string;
+    readonly apiKey: string;
+    readonly thresholdPercent: number;
+    readonly maxRounds: number;
+    readonly provider: string;
+}
+/** Raised when config on disk cannot be turned into a usable review setup. */
+export declare class DelphiSetupError extends Error {
+}
+/**
+ * Expand `${VAR}` and `{env:VAR}` placeholders from the environment.
+ * Supports the two spellings already present in xp-gate config files.
+ */
+export declare function expandEnv(value: string, env?: NodeJS.ProcessEnv): string;
+/**
+ * Turn raw config into a ready-to-run review setup.
+ * Fails loudly and specifically: a missing key or an unexpanded placeholder is
+ * the most common way a Delphi run silently degrades.
+ */
+export declare function resolveConfig(cfg: RawDelphiConfig, env?: NodeJS.ProcessEnv): ResolvedDelphiConfig;
+/** Read and resolve `.delphi-config.json` from a project root. */
+export declare function loadDelphiConfig(cwd: string, env?: NodeJS.ProcessEnv): ResolvedDelphiConfig;
+/** Build the transport options a round needs from a resolved config. */
+export declare function toDelphiOptions(cfg: ResolvedDelphiConfig): DelphiOptions;
+export {};
+//# sourceMappingURL=delphi-config.d.ts.map

package/lib/delphi-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delphi-config.d.ts","sourceRoot":"","sources":["../src/delphi-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAG5D,wDAAwD;AACxD,UAAU,SAAS;IACjB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,UAAU,UAAU;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACtG;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACjD,SAAS,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACvE;AAED,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CACtC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,8EAA8E;AAC9E,qBAAa,gBAAiB,SAAQ,KAAK;CAAG;AAE9C;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAIrF;AAkCD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,eAAe,EACpB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,oBAAoB,CAiFtB;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,oBAAoB,CAetB;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,GAAG,EAAE,oBAAoB,GAAG,aAAa,CAQxE"}

package/lib/delphi-config.js

@@ -0,0 +1,155 @@
+/**
+ * Delphi configuration loading for the DSH plugin.
+ *
+ * Reads the same `.delphi-config.json` the xp-gate skill already uses, so a
+ * project configures its reviewers once and both the skill and the DSH tool
+ * agree on who they are.
+ *
+ * @test REQ-DSH-016
+ * @intent 复用项目既有的 .delphi-config.json，把 provider/api_key/专家席位解析成
+ *         DSH 工具可用的结构，并对 ${ENV} 占位符与缺失密钥给出可操作的报错。
+ * @covers AC-DSH-016-02
+ */
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { validateSeats } from "./delphi.js";
+/** Raised when config on disk cannot be turned into a usable review setup. */
+export class DelphiSetupError extends Error {
+}
+/**
+ * Expand `${VAR}` and `{env:VAR}` placeholders from the environment.
+ * Supports the two spellings already present in xp-gate config files.
+ */
+export function expandEnv(value, env = process.env) {
+    return value
+        .replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g, (_m, name) => env[name] ?? "")
+        .replace(/\{env:([A-Za-z_][A-Za-z0-9_]*)\}/g, (_m, name) => env[name] ?? "");
+}
+/** Pick the active profile, falling back to the top level. */
+function selectProfile(cfg) {
+    const active = cfg.active_profile;
+    if (active && cfg.profiles?.[active])
+        return cfg.profiles[active];
+    if (cfg.profiles && Object.keys(cfg.profiles).length > 0) {
+        throw new DelphiSetupError(`No active_profile set. Available: ${Object.keys(cfg.profiles).join(", ")}`);
+    }
+    return cfg;
+}
+function seatFromRaw(raw, index, fallbackRole) {
+    const model = raw.model ?? raw.requested_model ?? "";
+    return {
+        id: raw.id ?? raw.name ?? `Expert ${String.fromCharCode(65 + index)}`,
+        role: raw.role ?? fallbackRole,
+        model,
+        maxTokens: raw.max_tokens ?? raw.maxTokens,
+    };
+}
+/** Normalize either experts shape into an ordered list with roles attached. */
+function normalizeExperts(experts) {
+    if (!experts)
+        return [];
+    if (Array.isArray(experts)) {
+        return experts.map((raw, i) => ({ raw, role: raw.role ?? `expert${i}` }));
+    }
+    // Object form: the KEY is the role, which is how xp-gate writes it.
+    return Object.entries(experts).map(([role, raw]) => ({ raw, role }));
+}
+/**
+ * Turn raw config into a ready-to-run review setup.
+ * Fails loudly and specifically: a missing key or an unexpanded placeholder is
+ * the most common way a Delphi run silently degrades.
+ */
+export function resolveConfig(cfg, env = process.env) {
+    const profile = selectProfile(cfg);
+    const normalized = normalizeExperts(profile.experts);
+    // An expert may name its own provider; otherwise there must be a profile-wide
+    // default. Resolve base_url/api_key per provider so mixed setups work.
+    const providerNames = new Set(normalized.map((e) => e.raw.provider ?? profile.provider).filter((p) => !!p));
+    if (providerNames.size === 0) {
+        throw new DelphiSetupError('No provider configured. Set "provider" on the profile or on each expert.');
+    }
+    const providerTable = profile.providers ?? {};
+    const resolvedProviders = new Map();
+    for (const name of providerNames) {
+        const entry = providerTable[name];
+        if (!entry) {
+            throw new DelphiSetupError(`Provider "${name}" is not defined under "providers". ` +
+                `Known: ${Object.keys(providerTable).join(", ") || "(none)"}`);
+        }
+        const baseUrl = entry.base_url ?? entry.baseUrl ?? "";
+        if (!baseUrl)
+            throw new DelphiSetupError(`Provider "${name}" has no base_url.`);
+        const rawKey = entry.api_key ?? entry.apiKey ?? "";
+        const apiKey = expandEnv(rawKey, env);
+        if (!apiKey) {
+            // Name the variable rather than echoing config, which may hold a literal key.
+            const varName = /\$\{([A-Za-z_][A-Za-z0-9_]*)\}/.exec(rawKey)?.[1] ??
+                /\{env:([A-Za-z_][A-Za-z0-9_]*)\}/.exec(rawKey)?.[1];
+            throw new DelphiSetupError(varName
+                ? `API key variable ${varName} is not set in the environment.`
+                : `Provider "${name}" has no api_key.`);
+        }
+        resolvedProviders.set(name, { baseUrl, apiKey });
+    }
+    const seats = normalized.map((e, i) => seatFromRaw(e.raw, i, e.role));
+    // Surface an unexpanded placeholder as a config error, not a provider 404.
+    for (const s of seats) {
+        if (s.model.includes("${") || s.model.includes("{env:")) {
+            throw new DelphiSetupError(`Expert "${s.id}" model "${s.model}" is an unexpanded placeholder.`);
+        }
+    }
+    validateSeats(seats);
+    // All seats share one gateway in the supported setup; require agreement so a
+    // mixed list cannot silently send one seat's key to another host.
+    const chosen = resolvedProviders.get(normalized[0].raw.provider ?? profile.provider ?? "");
+    if (!chosen)
+        throw new DelphiSetupError("Unable to resolve a provider for the first expert.");
+    for (const e of normalized) {
+        const name = e.raw.provider ?? profile.provider ?? "";
+        const other = resolvedProviders.get(name);
+        if (!other || other.baseUrl !== chosen.baseUrl) {
+            throw new DelphiSetupError(`All experts must share one gateway base_url; "${name}" differs. ` +
+                `Split the review or align the providers.`);
+        }
+    }
+    // consensus may sit on the profile or at the document root; both occur.
+    const consensus = profile.consensus ?? cfg.consensus;
+    return {
+        seats,
+        baseUrl: chosen.baseUrl,
+        apiKey: chosen.apiKey,
+        thresholdPercent: consensus?.threshold_percent ?? 90,
+        maxRounds: consensus?.max_review_rounds ?? 5,
+        provider: normalized[0].raw.provider ?? profile.provider ?? "",
+    };
+}
+/** Read and resolve `.delphi-config.json` from a project root. */
+export function loadDelphiConfig(cwd, env = process.env) {
+    const path = resolve(cwd, ".delphi-config.json");
+    let raw;
+    try {
+        raw = readFileSync(path, "utf8");
+    }
+    catch {
+        throw new DelphiSetupError(`No .delphi-config.json found at ${path}.`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (e) {
+        throw new DelphiSetupError(`.delphi-config.json is not valid JSON: ${e.message}`);
+    }
+    return resolveConfig(parsed, env);
+}
+/** Build the transport options a round needs from a resolved config. */
+export function toDelphiOptions(cfg) {
+    return {
+        baseUrl: cfg.baseUrl,
+        apiKey: cfg.apiKey,
+        seats: cfg.seats,
+        thresholdPercent: cfg.thresholdPercent,
+        maxRounds: cfg.maxRounds,
+    };
+}
+//# sourceMappingURL=delphi-config.js.map

package/lib/delphi-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delphi-config.js","sourceRoot":"","sources":["../src/delphi-config.ts"],"names":[],"mappings":"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"}

package/lib/delphi-run.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Delphi review orchestration: iterate rounds until consensus or the cap.
+ *
+ * @test REQ-DSH-016
+ * @intent 编排多轮交叉评审：首轮匿名独立评审，后续轮次反馈上一轮汇总，
+ *         直到达到共识阈值（默认 90%）或触及轮次上限（默认 5），
+ *         并把结果整理成可写成 .code-walkthrough-result.json 的证据。
+ * @covers AC-DSH-016-03
+ */
+import type { DelphiOptions, RoundResult } from "./delphi.js";
+export interface ReviewOutcome {
+    readonly rounds: readonly RoundResult[];
+    readonly consensus: boolean;
+    readonly finalRatio: number;
+    readonly totalRounds: number;
+}
+/**
+ * Run a full review. Round 1 is anonymous; each later round sees the aggregate
+ * plus whatever the caller says was addressed, then re-votes.
+ */
+export declare function runReview(opts: DelphiOptions, subject: string, addressed?: string): Promise<ReviewOutcome>;
+/** Human-readable transcript for the tool result. */
+export declare function formatOutcome(outcome: ReviewOutcome): string;
+//# sourceMappingURL=delphi-run.d.ts.map

package/lib/delphi-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delphi-run.d.ts","sourceRoot":"","sources":["../src/delphi-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAc,WAAW,EAAE,MAAM,aAAa,CAAA;AAOzE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAA;IACvC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AA0CD;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,MAAM,EACf,SAAS,SAAK,GACb,OAAO,CAAC,aAAa,CAAC,CAoCxB;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAiB5D"}