@zephyrdeng/pi-review 0.13.0 → 0.15.0

package/README.md

@@ -14,6 +14,55 @@ Works as a standalone CLI, a Pi package (extension + skill), or integrated into
 
 - [Pi CLI](https://pi.dev) installed and configured with at least one model provider
 
+## Run reviews on OrcaRouter
+
+`pi-review` is model-agnostic — it runs on any model provider configured in your
+[Pi](https://pi.dev) installation. To use [OrcaRouter](https://www.orcarouter.ai) as
+the provider behind your reviews:
+
+1. **Get a key** — no account yet? **Sign up with our referral link** <https://www.orcarouter.ai/ref/ref_07ca74b3e41670e5ff36> (also available from the badge below). Already have a key? Skip ahead.
+
+   ```bash
+   export ORCA_KEY="sk-orca-..."
+   ```
+
+2. **Register the provider** — merge [`resources/providers/orcarouter.json`](./resources/providers/orcarouter.json) into `~/.pi/agent/models.json` (OpenAI-compatible), e.g.:
+
+   ```bash
+   # jq not required; the file also works as-is when models.json doesn't exist yet
+   cp resources/providers/orcarouter.json ~/.pi/agent/models.json
+   ```
+
+```json
+{
+  "providers": {
+    "orcarouter": {
+      "baseUrl": "https://api.orcarouter.ai/v1",
+      "api": "openai-completions",
+      "apiKey": "ORCA_KEY",
+      "models": [
+        {
+          "id": "orcarouter/auto",
+          "name": "OrcaRouter Auto",
+          "reasoning": false,
+          "input": ["text"],
+          "contextWindow": 200000,
+          "maxTokens": 8192
+        }
+      ]
+    }
+  }
+}
+```
+
+3. **Pick the model** when you run a review:
+
+```bash
+pi-review --model orcarouter/orcarouter/auto -- @src/foo.ts
+```
+
+[![Powered by OrcaRouter](https://img.shields.io/badge/Powered_by-OrcaRouter-2563eb)](https://www.orcarouter.ai/ref/ref_07ca74b3e41670e5ff36)
+
 ## Features
 
 - **Isolated review sessions** — each review runs in a clean child process with no shared state
@@ -380,7 +429,13 @@ Session flags (`--keep-session`, `--continue`, `--name`) are unsupported by `loo
 
 ## Configuration
 
-Override defaults via environment variables:
+Persistent settings live in the review config file `~/.pi/pi-review/config.json` (override its location with `PI_REVIEW_CONFIG`). The config is advisory and forward-compatible: unknown keys are ignored, `null` counts as unset, and any other problem (wrong-typed value, invalid JSON) only prints a warning and falls back — the config never blocks core functionality, so a config written by a newer pi-review cannot brick an older one. In Pi, `/rv-config` shows the effective configuration (values, sources, warnings, resolved paths).
+
+| Key | Type | Default | Description |
+|-----|------|---------|-------------|
+| `childExtensions` | boolean | `false` | Let review children load host Pi extensions so providers registered only through extensions are usable. Equivalent to per-run `PI_REVIEW_CHILD_EXTENSIONS=1`; `false` keeps children isolated with `--no-extensions` (issue #8). |
+
+Per-process overrides via environment variables (env wins over the config file):
 
 | Variable | Description |
 |----------|-------------|
@@ -391,7 +446,8 @@ Override defaults via environment variables:
 | `PI_REVIEW_SYSTEM_PROMPT` | Path to system prompt file |
 | `PI_REVIEW_SESSION_DIR` | Directory for persisted review sessions |
 | `PI_REVIEW_META_STDOUT` | Set to `1`/`true` to print `PI_REVIEW_META_JSON` on stdout instead of stderr |
-| `PI_REVIEW_CHILD_EXTENSIONS` | Set to `1`/`true`/`keep` to let review children load host Pi extensions (default: children run with `--no-extensions`) |
+| `PI_REVIEW_CHILD_EXTENSIONS` | Per-run override for `childExtensions`: `1`/`true`/`keep` enables host extensions for this process, any other set value (e.g. `0`) forces isolation; an empty value counts as unset. Persistent equivalent: `{ "childExtensions": true }` in the config file. With an explicit `--provider`, pi-review first probes the model catalog and blocks with a hint if the provider only exists via extensions |
+| `PI_REVIEW_CONFIG` | Path to the review config file (default: `~/.pi/pi-review/config.json`) |
 
 ## Pi Package Usage
 
@@ -402,7 +458,7 @@ After installing as a Pi package, use the `/rv` slash command:
 /rv --mode challenge @docs/design.md
 ```
 
-Slash commands inject a task message for the parent agent. Strategy is selected by the command (`/rv`, `/rv-loop`, `/rv-models`); the remainder is the natural-language target. Use plain `/rv @src`, `/rv review the auth changes`, or `/rv-loop fix until clean @src` in Pi — no extra streaming flags needed for panel runs. `--continue`, `--keep-session`, loop, and explicit `--no-stream` retain the shell CLI path.
+Slash commands inject a task message for the parent agent. Strategy is selected by the command (`/rv`, `/rv-loop`, `/rv-models`); the remainder is the natural-language target. `/rv-config` is read-only: it shows the effective configuration (config file, env overrides, resolved paths). Use plain `/rv @src`, `/rv review the auth changes`, or `/rv-loop fix until clean @src` in Pi — no extra streaming flags needed for panel runs. `--continue`, `--keep-session`, loop, and explicit `--no-stream` retain the shell CLI path.
 
 ```
 /rv models
@@ -426,7 +482,8 @@ Completions are a hint layer only; execution remains skill-driven. When the mode
 
 - Each review and every loop round runs in an isolated child Pi session
 - Default runs use `--no-session` — no child context is stored
-- Default runs also pass `--no-extensions` so host usage HUDs / reload bridges cannot crash a reviewer via stale extension context after dispose (see issue #8). Opt out with `PI_REVIEW_CHILD_EXTENSIONS=1` only when a custom provider truly must register inside the child.
+- Children run isolated with `--no-extensions` by default so host usage HUDs / reload bridges cannot crash a reviewer via stale extension context after dispose (see issue #8). Enable host extension loading persistently with `{ "childExtensions": true }` in `~/.pi/pi-review/config.json`, or per run with `PI_REVIEW_CHILD_EXTENSIONS=1` — only when a custom provider truly must register inside the child.
+- Before spawning, pi-review probes the Pi model catalog when an explicit provider is in effect (via `--provider` or the `provider/` prefix of `--model`): if the provider only exists with host extensions loaded, the run is blocked with an actionable hint (`verdictSource: "config_error"`, meta `extensionHint`; panel runs aggregate every affected provider into `extensionHints`) instead of failing with a confusing unknown-provider error — set `childExtensions: true` in the config file or re-run with `PI_REVIEW_CHILD_EXTENSIONS=1`. Catalog probes are cached only on success; a transient probe failure never blocks a review.
 - On reviewer runtime failure, the panel footer and `reviewers[].runtimeError` keep a child stderr/stack tail for diagnosis
 - `--keep-session` stores only the child review session for explicit follow-up
 - The review session is read-only: no file edits, patches, commits, or deployments

package/README.zh-CN.md

@@ -21,6 +21,54 @@
 
 - 已安装并配置好 [Pi CLI](https://pi.dev)，且至少有一个可用模型
 
+## 用 OrcaRouter 运行审查
+
+`pi-review` 与模型无关——它运行在你 [Pi](https://pi.dev) 中配置的任意模型服务商之上。若要
+把 [OrcaRouter](https://www.orcarouter.ai) 作为审查背后的服务商：
+
+1. **获取 key**——还没有账号？**用我们的推荐链接注册** <https://www.orcarouter.ai/ref/ref_07ca74b3e41670e5ff36>（下方徽章亦可）。已有 key？直接下一步。
+
+   ```bash
+   export ORCA_KEY="sk-orca-..."
+   ```
+
+2. **注册服务商**——把 [`resources/providers/orcarouter.json`](./resources/providers/orcarouter.json) 合并进 `~/.pi/agent/models.json`（OpenAI 兼容）：
+
+   ```bash
+   # models.json 不存在时可以直接整个使用；已有内容时用 jq 或手工合并
+   cp resources/providers/orcarouter.json ~/.pi/agent/models.json
+   ```
+
+```json
+{
+  "providers": {
+    "orcarouter": {
+      "baseUrl": "https://api.orcarouter.ai/v1",
+      "api": "openai-completions",
+      "apiKey": "ORCA_KEY",
+      "models": [
+        {
+          "id": "orcarouter/auto",
+          "name": "OrcaRouter Auto",
+          "reasoning": false,
+          "input": ["text"],
+          "contextWindow": 200000,
+          "maxTokens": 8192
+        }
+      ]
+    }
+  }
+}
+```
+
+3. **选择模型**运行审查：
+
+```bash
+pi-review --model orcarouter/orcarouter/auto -- @src/foo.ts
+```
+
+[![Powered by OrcaRouter](https://img.shields.io/badge/Powered_by-OrcaRouter-2563eb)](https://www.orcarouter.ai/ref/ref_07ca74b3e41670e5ff36)
+
 ## 安装
 
 ```bash
@@ -208,13 +256,20 @@ CLI 会在 reviewer 启动前把 `PI_REVIEW_UI_URL: http://127.0.0.1:<port>/run/
 
 提交代码：`npm install` 后会启用 **Husky** 钩子（`.husky/` → `ai-commit` 的 prepare-commit-msg / commit-msg / pre-commit）。也可 `git add` 后直接 `ai-commit commit`。配置见 `.ai-commit.yaml`（英文、`ai_footer: off`，需本机安装 ai-commit ≥ v0.1.45）。
 
-可通过 `PI_REVIEW_HOME`、`PI_REVIEW_PRESETS`、`PI_REVIEW_SYSTEM_PROMPT` 等环境变量覆盖预设与系统提示词路径。预设与审查指令文件内容均为英文。
+持久化设置在评审配置文件 `~/.pi/pi-review/config.json`（可用 `PI_REVIEW_CONFIG` 覆盖其位置）中。配置是建议性的、向前兼容的：未知键被忽略，`null` 视为未设置，其它任何问题（类型错误、无效 JSON）只打印警告并回落——配置绝不阻塞核心功能，新版本写的配置不会弄坏旧版本。在 Pi 中用 `/rv-config` 查看生效配置（取值、来源、警告、解析路径）。
+
+| 键 | 类型 | 默认 | 说明 |
+|-----|------|---------|-------------|
+| `childExtensions` | boolean | `false` | 是否让评审子进程加载宿主 Pi 扩展，以使用仅由扩展注册的 provider。等价于单次运行 `PI_REVIEW_CHILD_EXTENSIONS=1`；`false` 保持子进程隔离（`--no-extensions`，issue #8）。 |
+
+环境变量提供单次进程级覆盖（env 优先于配置文件）：`PI_REVIEW_HOME`、`PI_REVIEW_PRESETS`、`PI_REVIEW_PANEL_PRESETS`、`PI_REVIEW_SYSTEM_PROMPT`、`PI_REVIEW_SESSION_DIR`、`PI_REVIEW_META_STDOUT`、`PI_REVIEW_CHILD_EXTENSIONS`（`1`/`true`/`keep` 开启、其它已设值如 `0` 强制隔离、空值视为未设置；持久化等价写法为配置文件里 `{ "childExtensions": true }`）、`PI_REVIEW_CONFIG`。预设与审查指令文件内容均为英文。
 
 ## 安全
 
 - 每次审查在隔离子进程中运行
 - 默认不保留子会话；`--keep-session` 仅用于显式跟进
-- 默认还会传 `--no-extensions`，避免宿主 usage HUD / reload bridge 在 dispose 后触 stale extension ctx 搞崩 reviewer（见 issue #8）。仅当自定义 provider 必须在子进程内注册时，才用 `PI_REVIEW_CHILD_EXTENSIONS=1` 退出隔离
+- 默认子进程以 `--no-extensions` 隔离运行，避免宿主 usage HUD / reload bridge 在 dispose 后触 stale extension ctx 搞崩 reviewer（见 issue #8）。需要自定义 provider 在子进程内注册时，可在 `~/.pi/pi-review/config.json` 里持久化 `{ "childExtensions": true }`，或单次运行用 `PI_REVIEW_CHILD_EXTENSIONS=1`
+- 显式指定 provider（`--provider` 或 `--model` 的 `provider/` 前缀）时，spawn 前会先探测 Pi 模型目录：若该 provider 仅在加载宿主扩展后才存在，则直接以可执行的提示阻塞运行（`verdictSource: "config_error"`，meta 带 `extensionHint`；panel 运行会把所有受影响的 provider 聚合到 `extensionHints`），而不是抛一个令人困惑的 unknown-provider 错误——在配置文件中设置 `childExtensions: true` 或重跑时加 `PI_REVIEW_CHILD_EXTENSIONS=1`。目录探测仅在成功时缓存，瞬时探测失败不会阻塞审查
 - reviewer 运行时失败时，panel footer 与 `reviewers[].runtimeError` 会保留子进程 stderr/stack 尾部便于诊断
 - 审查会话只读，不编辑、不部署
 

package/dist/child-isolation.test.js

@@ -1,16 +1,34 @@
 import assert from "node:assert/strict";
 import { test } from "vitest";
-import { CHILD_STDERR_DIAGNOSTIC_LIMIT, childIsolationArgs, formatChildRuntimeDetail, } from "./review.js";
+import { CHILD_STDERR_DIAGNOSTIC_LIMIT, childIsolationArgs, formatChildRuntimeDetail, modelsArgs, } from "./review.js";
 import { buildReviewerArgs } from "./panel.js";
 test("childIsolationArgs defaults to --no-extensions for host isolation", () => {
-    assert.deepEqual(childIsolationArgs({}), ["--no-extensions"]);
-    assert.deepEqual(childIsolationArgs({ PI_REVIEW_CHILD_EXTENSIONS: "" }), ["--no-extensions"]);
-    assert.deepEqual(childIsolationArgs({ PI_REVIEW_CHILD_EXTENSIONS: "0" }), ["--no-extensions"]);
+    assert.deepEqual(childIsolationArgs({}, {}), ["--no-extensions"]);
+    assert.deepEqual(childIsolationArgs({ PI_REVIEW_CHILD_EXTENSIONS: "" }, {}), ["--no-extensions"]);
+    assert.deepEqual(childIsolationArgs({ PI_REVIEW_CHILD_EXTENSIONS: "0" }, {}), ["--no-extensions"]);
 });
 test("childIsolationArgs can opt back into host extensions", () => {
-    assert.deepEqual(childIsolationArgs({ PI_REVIEW_CHILD_EXTENSIONS: "1" }), []);
-    assert.deepEqual(childIsolationArgs({ PI_REVIEW_CHILD_EXTENSIONS: "true" }), []);
-    assert.deepEqual(childIsolationArgs({ PI_REVIEW_CHILD_EXTENSIONS: "KEEP" }), []);
+    assert.deepEqual(childIsolationArgs({ PI_REVIEW_CHILD_EXTENSIONS: "1" }, {}), []);
+    assert.deepEqual(childIsolationArgs({ PI_REVIEW_CHILD_EXTENSIONS: "true" }, {}), []);
+    assert.deepEqual(childIsolationArgs({ PI_REVIEW_CHILD_EXTENSIONS: "KEEP" }, {}), []);
+});
+test("childIsolationArgs honors the persistent config childExtensions key", () => {
+    assert.deepEqual(childIsolationArgs({}, { childExtensions: true }), []);
+    assert.deepEqual(childIsolationArgs({}, { childExtensions: false }), ["--no-extensions"]);
+});
+test("childIsolationArgs: env overrides the persistent config in both directions", () => {
+    assert.deepEqual(childIsolationArgs({ PI_REVIEW_CHILD_EXTENSIONS: "0" }, { childExtensions: true }), ["--no-extensions"]);
+    assert.deepEqual(childIsolationArgs({ PI_REVIEW_CHILD_EXTENSIONS: "1" }, { childExtensions: false }), []);
+});
+test("modelsArgs applies the same effective isolation as review children", () => {
+    assert.deepEqual(modelsArgs(["openai"], {}, {}), ["--list-models", "--no-extensions", "openai"]);
+    assert.deepEqual(modelsArgs(["openai"], {}, { childExtensions: true }), ["--list-models", "openai"]);
+    assert.deepEqual(modelsArgs(["openai"], { PI_REVIEW_CHILD_EXTENSIONS: "1" }, {}), ["--list-models", "openai"]);
+    assert.deepEqual(modelsArgs(["openai"], { PI_REVIEW_CHILD_EXTENSIONS: "0" }, { childExtensions: true }), [
+        "--list-models",
+        "--no-extensions",
+        "openai",
+    ]);
 });
 test("formatChildRuntimeDetail preserves a multi-line child stack tail", () => {
     const stack = [

package/dist/child-isolation.test.js.map

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

package/dist/cli.js

@@ -5,12 +5,19 @@ import { readReviewStdin, runModels, runReview, runReviewOnce } from "./review.j
 import { formatLoopSummary, runReviewLoop } from "./loop.js";
 import { runPanelReview, runPanelReviewOnce, runPanelReviewWithUi } from "./panel.js";
 import { resolveConfig } from "./config.js";
+import { currentConfig } from "./pi-config.js";
 import { installSkill, uninstallSkill } from "./skill.js";
 import { runUpdate } from "./update.js";
 import { runInstall } from "./install.js";
 const parsed = parseArgs(process.argv.slice(2));
 if (isInstallHelp(parsed))
     usage(0);
+// The config file is advisory: warn about leniently-ignored values but never
+// block core functionality — a config written by a newer pi-review must not
+// brick an older one.
+for (const warning of currentConfig().warnings) {
+    process.stderr.write(`pi-review: config warning: ${warning}\n`);
+}
 if (parsed.command === "models") {
     const config = resolveConfig();
     runModels(config.piBin, parsed.search || []);

package/dist/cli.js.map

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

package/dist/extensions/review.d.ts

@@ -0,0 +1,2 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export default function piReviewExtension(pi: ExtensionAPI): void;

package/dist/extensions/review.js

@@ -0,0 +1,22 @@
+import { buildRvOrchestrationPrompt, parseRvArgs, RV_COMPLETIONS } from "./rv-prompts.js";
+export default function piReviewExtension(pi) {
+    pi.registerCommand("rv", {
+        description: "Delegate pi-review to the agent (English prompts). Usage: /rv [--mode plan|challenge] [--model id] [--keep-session] @file-or-text | models",
+        getArgumentCompletions: (prefix) => {
+            const filtered = RV_COMPLETIONS.filter((item) => item.value.startsWith(prefix));
+            return filtered.length
+                ? filtered.map(({ value, hint }) => ({ value, label: value, description: hint }))
+                : null;
+        },
+        handler: async (rawArgs, ctx) => {
+            const trimmed = rawArgs.trim();
+            const parsed = parseRvArgs(trimmed);
+            const prompt = buildRvOrchestrationPrompt(parsed);
+            if (!trimmed && !parsed.modelsOnly) {
+                ctx.ui.notify("/rv needs a target or `models`. Try: /rv @path or /rv models", "warning");
+                return;
+            }
+            pi.sendUserMessage(prompt);
+        },
+    });
+}

package/dist/extensions/rv-prompts.d.ts

@@ -0,0 +1,19 @@
+/**
+ * English orchestration prompts for /rv — parent Pi agent runs pi-review per skill.
+ * Child review sessions use presets in resources/review-presets.json (also English).
+ */
+export type RvParsed = {
+    mode: "code" | "plan" | "challenge";
+    model?: string;
+    keepSession: boolean;
+    continueHandle?: string;
+    modelsOnly: boolean;
+    target: string;
+};
+export declare function parseRvArgs(raw: string): RvParsed;
+export declare function buildRvOrchestrationPrompt(parsed: RvParsed): string;
+/** Short labels for TUI completions (English). */
+export declare const RV_COMPLETIONS: {
+    value: string;
+    hint: string;
+}[];

package/dist/extensions/rv-prompts.js

@@ -0,0 +1,132 @@
+/**
+ * English orchestration prompts for /rv — parent Pi agent runs pi-review per skill.
+ * Child review sessions use presets in resources/review-presets.json (also English).
+ */
+export function parseRvArgs(raw) {
+    const tokens = raw.match(/(?:[^\s"']+|"[^"]*"|'[^']*')+/g) ?? [];
+    const cleaned = tokens.map((t) => t.replace(/^['"]|['"]$/g, ""));
+    let mode = "code";
+    let model;
+    let keepSession = false;
+    let continueHandle;
+    let modelsOnly = false;
+    const rest = [];
+    for (let i = 0; i < cleaned.length; i++) {
+        const t = cleaned[i];
+        if (t === "models" && rest.length === 0 && i === cleaned.length - 1) {
+            modelsOnly = true;
+            continue;
+        }
+        if (t === "--keep-session") {
+            keepSession = true;
+            continue;
+        }
+        if (t === "--mode" && cleaned[i + 1]) {
+            const m = cleaned[++i];
+            if (m === "plan" || m === "challenge" || m === "code")
+                mode = m;
+            continue;
+        }
+        if (t === "--model" && cleaned[i + 1]) {
+            model = cleaned[++i];
+            continue;
+        }
+        if (t === "--continue" && cleaned[i + 1]) {
+            continueHandle = cleaned[++i];
+            continue;
+        }
+        rest.push(t);
+    }
+    return {
+        mode,
+        model,
+        keepSession,
+        continueHandle,
+        modelsOnly,
+        target: rest.join(" ").trim(),
+    };
+}
+function baseRules() {
+    return [
+        "Follow the pi-review skill.",
+        "Run pi-review in an isolated child session; return only the review conclusion.",
+        "Do not edit, patch, commit, or implement findings unless the user asks separately.",
+        "Preserve the final PI_REVIEW_META line from pi-review output.",
+    ].join(" ");
+}
+export function buildRvOrchestrationPrompt(parsed) {
+    if (parsed.modelsOnly) {
+        return [
+            "Run the pi-review model catalog step.",
+            baseRules(),
+            "Execute: pi-review models",
+            "Present a short English summary: how many providers, suggest 2–3 IDs suited for code review vs plan/challenge.",
+            "Do not start a review until the user supplies a target (@path or text).",
+        ].join("\n\n");
+    }
+    if (parsed.continueHandle) {
+        return [
+            "Continue a prior pi-review session.",
+            baseRules(),
+            `Execute: pi-review --continue ${parsed.continueHandle} -- ${parsed.target || "follow up on the previous review"}`,
+            "Answer the follow-up in English; keep the same review-only scope.",
+        ].join("\n\n");
+    }
+    if (!parsed.target) {
+        return [
+            "The /rv command needs a review target.",
+            "Tell the user (in English): usage is /rv [--mode code|plan|challenge] [--model provider/model] [--keep-session] -- @files-or-brief",
+            "Examples: /rv @src/foo.ts | /rv --mode challenge @docs/design.md | /rv models",
+        ].join("\n\n");
+    }
+    const modeBlock = {
+        code: [
+            "Mode: code (default).",
+            "Focus: correctness, regressions, security, concurrency, API contracts, edge cases, tests.",
+            "Use read-only inspection via pi-review; no file mutations.",
+        ].join(" "),
+        plan: [
+            "Mode: plan.",
+            "Review architecture, design, or strategy through engineering, product, security, QA, ops, and DX lenses.",
+            "Identify fatal flaws, trade-offs, sequencing risks, and minimal changes to de-risk the plan.",
+        ].join(" "),
+        challenge: [
+            "Mode: challenge (adversarial).",
+            "Pressure-test assumptions, boundaries, dependencies, failure modes, migration, and missing evidence.",
+            "One-shot conclusion; do not run a live Q&A interview.",
+        ].join(" "),
+    };
+    const cliParts = ["pi-review"];
+    if (parsed.mode !== "code")
+        cliParts.push(`--mode ${parsed.mode}`);
+    if (parsed.model)
+        cliParts.push(`--model ${parsed.model}`);
+    if (parsed.keepSession)
+        cliParts.push("--keep-session");
+    cliParts.push("--", parsed.target);
+    const modelStep = parsed.model
+        ? `Use model exactly as given: ${parsed.model} (must appear in pi-review models output).`
+        : "Run pi-review models first if needed; pick a suitable listed ID or omit --model for Pi default.";
+    return [
+        "Run pi-review for the target below.",
+        baseRules(),
+        modeBlock[parsed.mode],
+        modelStep,
+        parsed.keepSession
+            ? "Use --keep-session so the user can follow up with /rv --continue <handle>."
+            : "",
+        `Execute:\n${cliParts.join(" ")}`,
+    ]
+        .filter(Boolean)
+        .join("\n\n");
+}
+/** Short labels for TUI completions (English). */
+export const RV_COMPLETIONS = [
+    { value: "@", hint: "file path after @ (e.g. @src/foo.ts)" },
+    { value: "models", hint: "list pi-review models only" },
+    { value: "--mode code", hint: "code / diff / MR review" },
+    { value: "--mode plan", hint: "architecture or plan review" },
+    { value: "--mode challenge", hint: "adversarial plan review" },
+    { value: "--model ", hint: "provider/model from pi-review models" },
+    { value: "--keep-session", hint: "persist session for follow-up" },
+];

package/dist/index.d.ts

@@ -3,8 +3,8 @@ export { resolveConfig } from "./config.js";
 export type { Config } from "./config.js";
 export { loadPresets, loadPanelPresets, loadSystemPrompt } from "./presets.js";
 export { splitPayload, normalizePayloadRefs, buildPrompt, buildReviewerPrompt, buildAdjudicatorPrompt } from "./prompt.js";
-export { childEnv, childIsolationArgs, childRuntimeError, formatChildRuntimeDetail, readReviewStdin, runModels, runReview, runReviewOnce, CHILD_STDERR_DIAGNOSTIC_LIMIT, } from "./review.js";
-export { buildReviewerArgs, runPanelReview, runPanelReviewOnce, emitPanelFooter, shouldPreserveSubmissionOnAbort, resolvePanelReviewerTools, } from "./panel.js";
+export { childEnv, childIsolationArgs, childRuntimeError, modelsArgs, configBlockForProvider, extensionOnlyHintText, formatChildRuntimeDetail, parseModelCatalog, probeProviderAvailability, readReviewStdin, runModels, runReview, runReviewOnce, unknownProviderHintText, CHILD_STDERR_DIAGNOSTIC_LIMIT, } from "./review.js";
+export { buildReviewerArgs, collectPanelExtensionHints, runPanelReview, runPanelReviewOnce, emitPanelFooter, shouldPreserveSubmissionOnAbort, resolvePanelReviewerTools, } from "./panel.js";
 export { spawnStreamingChild } from "./child-process.js";
 export { createPanelViewState, reducePanelEvent } from "./panel-view.js";
 export type { PanelViewState, PanelReviewerView, PanelPhase, ReviewerViewStatus } from "./panel-view.js";
@@ -20,7 +20,7 @@ export type { FindingMatcher, MatchResult, SemanticAdjudicator, AdjudicationRequ
 export { resolvePanelConfig } from "./panel-config.js";
 export type { ResolvedPanelConfig } from "./panel-config.js";
 export { makeRunSessionDir, newestJsonl } from "./session.js";
-export type { Verdict, ReviewStatus, ReviewFinding, FindingLocation, ParsedArgs, ReviewPreset, VerdictInfo, StructuredReviewResult, ReviewMeta, ReviewRunResult, SplitPayload, ConsensusPolicy, SourceFinding, FindingCluster, PanelHealth, ReviewerOutcome, PanelFields, PanelAggregationResult, PanelReviewMeta, ReviewerSubmission, PanelReviewerSpec, PanelPreset, TokenUsage, } from "./types.js";
+export type { Verdict, ReviewStatus, ReviewFinding, FindingLocation, ParsedArgs, ReviewPreset, VerdictInfo, StructuredReviewResult, ReviewMeta, ReviewRunResult, SplitPayload, ExtensionHint, ConsensusPolicy, SourceFinding, FindingCluster, PanelHealth, ReviewerOutcome, PanelFields, PanelAggregationResult, PanelReviewMeta, ReviewerSubmission, PanelReviewerSpec, PanelPreset, TokenUsage, } from "./types.js";
 export { REVIEW_STATUSES, VERDICTS, CONSENSUS_POLICIES, MAX_REVIEWERS, PANEL_READ_ONLY_TOOLS, DEFAULT_PANEL_MIN_AGREE, REVIEW_META_VERSION, } from "./types.js";
 export { fail, hasPathSeparator, expandMaybeHome, normalizeTools } from "./utils.js";
 export { parseVerdict } from "./verdict.js";
@@ -28,4 +28,6 @@ export { parseReviewResult, reviewExitCode } from "./review-result.js";
 export { formatCost, formatDurationMs, formatTokens, formatUsage, formatReviewMetaAscii, formatReviewMetaJsonLine, formatPanelMetaAscii, formatPanelFindingsMarkdown } from "./meta-footer.js";
 export { DEFAULT_AGENT_SKILL_ARGS, DEFAULT_SKILL_AGENTS, expandSkillAgentArgs, installSkill, listDirectSkillInstallTargets, resolveDirectSkillInstallTargets, runInstallSkill, runUninstallSkill, runUpdateSkill, selectedSkillAgents, uninstallSkill, } from "./skill.js";
 export type { DirectSkillInstallTarget, SkillMethod, SkillOpResult } from "./skill.js";
+export { DEFAULT_CONFIG_PATH, configFilePath, currentConfig, loadReviewConfigFile, parseReviewConfig, resolveChildExtensions, } from "./pi-config.js";
+export type { PiReviewConfig, ConfigSource, ChildExtensionsDecision, ReviewConfigLoad } from "./pi-config.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -2,8 +2,8 @@ export { ArgsParseError, DEFAULT_MAX_ROUNDS, isPanelActive, parseArgs, parseRevi
 export { resolveConfig } from "./config.js";
 export { loadPresets, loadPanelPresets, loadSystemPrompt } from "./presets.js";
 export { splitPayload, normalizePayloadRefs, buildPrompt, buildReviewerPrompt, buildAdjudicatorPrompt } from "./prompt.js";
-export { childEnv, childIsolationArgs, childRuntimeError, formatChildRuntimeDetail, readReviewStdin, runModels, runReview, runReviewOnce, CHILD_STDERR_DIAGNOSTIC_LIMIT, } from "./review.js";
-export { buildReviewerArgs, runPanelReview, runPanelReviewOnce, emitPanelFooter, shouldPreserveSubmissionOnAbort, resolvePanelReviewerTools, } from "./panel.js";
+export { childEnv, childIsolationArgs, childRuntimeError, modelsArgs, configBlockForProvider, extensionOnlyHintText, formatChildRuntimeDetail, parseModelCatalog, probeProviderAvailability, readReviewStdin, runModels, runReview, runReviewOnce, unknownProviderHintText, CHILD_STDERR_DIAGNOSTIC_LIMIT, } from "./review.js";
+export { buildReviewerArgs, collectPanelExtensionHints, runPanelReview, runPanelReviewOnce, emitPanelFooter, shouldPreserveSubmissionOnAbort, resolvePanelReviewerTools, } from "./panel.js";
 export { spawnStreamingChild } from "./child-process.js";
 export { createPanelViewState, reducePanelEvent } from "./panel-view.js";
 export { createReviewEventEmitter, redactReviewEventPayload, redactReviewEventText, REVIEW_EVENT_VERSION, REVIEW_EVENT_TEXT_LIMIT } from "./review-events.js";
@@ -19,4 +19,5 @@ export { parseVerdict } from "./verdict.js";
 export { parseReviewResult, reviewExitCode } from "./review-result.js";
 export { formatCost, formatDurationMs, formatTokens, formatUsage, formatReviewMetaAscii, formatReviewMetaJsonLine, formatPanelMetaAscii, formatPanelFindingsMarkdown } from "./meta-footer.js";
 export { DEFAULT_AGENT_SKILL_ARGS, DEFAULT_SKILL_AGENTS, expandSkillAgentArgs, installSkill, listDirectSkillInstallTargets, resolveDirectSkillInstallTargets, runInstallSkill, runUninstallSkill, runUpdateSkill, selectedSkillAgents, uninstallSkill, } from "./skill.js";
+export { DEFAULT_CONFIG_PATH, configFilePath, currentConfig, loadReviewConfigFile, parseReviewConfig, resolveChildExtensions, } from "./pi-config.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,SAAS,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AACzI,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,WAAW,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC3H,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,eAAe,EACf,SAAS,EACT,SAAS,EACT,aAAa,EACb,6BAA6B,GAC9B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE9J,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1E,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAErE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AA0B9D,OAAO,EACL,eAAe,EACf,QAAQ,EACR,kBAAkB,EAClB,aAAa,EACb,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC/L,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,YAAY,EACZ,6BAA6B,EAC7B,gCAAgC,EAChC,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,cAAc,GACf,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,SAAS,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AACzI,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,WAAW,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC3H,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,yBAAyB,EACzB,eAAe,EACf,SAAS,EACT,SAAS,EACT,aAAa,EACb,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE9J,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1E,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAErE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AA2B9D,OAAO,EACL,eAAe,EACf,QAAQ,EACR,kBAAkB,EAClB,aAAa,EACb,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC/L,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,YAAY,EACZ,6BAA6B,EAC7B,gCAAgC,EAChC,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC"}

package/dist/panel-cli.test.js

@@ -36,6 +36,15 @@ function repoRoot() {
 function writeFakePi(tempDir) {
     const fakePi = path.join(tempDir, "fake-pi");
     fs.writeFileSync(fakePi, `#!/usr/bin/env node
+if (process.argv.includes("--list-models")) {
+  // "configured" is available both with and without extensions; "extonly"
+  // only appears once host extensions are loaded (issue #8 probe fixture).
+  const isolated = process.argv.includes("--no-extensions");
+  const rows = ["provider      model", "configured    explicit-model"];
+  if (!isolated) rows.push("extonly       anything");
+  process.stdout.write(rows.join("\\n") + "\\n");
+  process.exit(0);
+}
 const prompt = process.argv[process.argv.length - 1] || "";
 const scenario = process.env.FAKE_PANEL_SCENARIO || "agree-bug";
 const idMatch = prompt.match(/Reviewer ID:\\s*(\\S+)/);
@@ -177,6 +186,32 @@ test("panel review keeps an explicitly configured reviewer model even when the p
     // The sentinel also reaches the human-readable ASCII footer Model line.
     assert.match(result.stdout, /Model\s+mixed/);
 });
+test("panel review blocks extension-only providers with structured extensionHints (issue #8 probe)", () => {
+    tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "pi-review-panel-cli-"));
+    const fakePi = writeFakePi(tempDir);
+    const result = runPanelCli(fakePi, "agree-bug", [
+        "--reviewers", "3",
+        "--consensus", "quorum", "--min-agree", "2",
+        "--reviewer-model", "r1=extonly/anything",
+    ]);
+    // A blocked reviewer leaves panel health blocked (exit 4) even though the
+    // healthy reviewers still ran; the remaining finding only reached advisory
+    // support (1 < quorum 2), so it cannot confirm.
+    assert.equal(result.status, 4, result.stderr);
+    const meta = metaRecord(result);
+    assert.ok(meta, result.stderr);
+    assert.equal(meta.panelHealth, "blocked");
+    const reviewerMetas = meta.reviewers;
+    const r1 = reviewerMetas.find((r) => r.reviewerId === "r1");
+    assert.equal(r1.verdictSource, "config_error");
+    assert.match(r1.parseError ?? "", /PI_REVIEW_CHILD_EXTENSIONS=1/);
+    // The machine-readable hint survives aggregation so the host agent can
+    // programmatically decide to re-run with PI_REVIEW_CHILD_EXTENSIONS=1.
+    assert.deepEqual(meta.extensionHints, [{ provider: "extonly", availableViaExtension: true }]);
+    // Healthy reviewers were not probed and still ran.
+    const r2 = reviewerMetas.find((r) => r.reviewerId === "r2");
+    assert.notEqual(r2.verdictSource, "config_error");
+});
 test("panel review where all reviewers approve is clean and exits 0", () => {
     tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "pi-review-panel-cli-"));
     const fakePi = writeFakePi(tempDir);