@zephyrdeng/pi-review 0.6.1 → 0.7.0

package/dist/args.test.js

@@ -0,0 +1,115 @@
+import assert from "node:assert/strict";
+import { test } from "node:test";
+import { ArgsParseError, parseReviewCommand } from "./args.js";
+test("review remains the default and explicit command", () => {
+    assert.equal(parseReviewCommand(["--", "@src"]).command, "review");
+    assert.equal(parseReviewCommand(["review", "--", "@src"]).command, "review");
+});
+test("loop parses max rounds and shared review options", () => {
+    const parsed = parseReviewCommand([
+        "loop",
+        "--max-rounds",
+        "5",
+        "--mode",
+        "challenge",
+        "--model",
+        "provider/model",
+        "--",
+        "@docs/design.md",
+        "focus on rollback",
+    ]);
+    assert.equal(parsed.command, "loop");
+    assert.equal(parsed.maxRounds, 5);
+    assert.equal(parsed.mode, "challenge");
+    assert.equal(parsed.model, "provider/model");
+    assert.deepEqual(parsed.payload, ["@docs/design.md", "focus on rollback"]);
+});
+test("loop uses a small default review budget", () => {
+    const parsed = parseReviewCommand(["loop", "--", "@src"]);
+    assert.equal(parsed.command, "loop");
+    assert.equal(parsed.maxRounds, 3);
+});
+test("loop rejects invalid max-rounds values as usage errors", () => {
+    for (const value of ["0", "-1", "1.5", "many", "9007199254740992"]) {
+        assert.throws(() => parseReviewCommand(["loop", "--max-rounds", value, "--", "@src"]), (error) => error instanceof ArgsParseError
+            && error.exitCode === 2
+            && /positive integer/.test(error.message));
+    }
+});
+test("loop rejects session reuse and review rejects loop-only flags", () => {
+    for (const sessionArgs of [
+        ["--keep-session"],
+        ["--continue", "/tmp/session.jsonl"],
+        ["--name", "gate"],
+    ]) {
+        assert.throws(() => parseReviewCommand(["loop", ...sessionArgs, "--", "@src"]), /loop cannot be used/);
+    }
+    assert.throws(() => parseReviewCommand(["review", "--max-rounds", "2", "--", "@src"]), /only be used with loop/);
+});
+test("panel options parse for review and loop", () => {
+    const parsed = parseReviewCommand([
+        "--reviewers", "3", "--consensus", "quorum", "--min-agree", "2", "--concurrency", "2", "--", "@src",
+    ]);
+    assert.equal(parsed.reviewers, 3);
+    assert.equal(parsed.consensus, "quorum");
+    assert.equal(parsed.minAgree, 2);
+    assert.equal(parsed.concurrency, 2);
+    const loopParsed = parseReviewCommand([
+        "loop", "--reviewers", "3", "--consensus", "quorum", "--min-agree", "2", "--max-rounds", "2", "--", "@src",
+    ]);
+    assert.equal(loopParsed.command, "loop");
+    assert.equal(loopParsed.reviewers, 3);
+    assert.equal(loopParsed.maxRounds, 2);
+    const panelParsed = parseReviewCommand(["--panel", "code-experts", "--consensus", "majority", "--", "@src"]);
+    assert.equal(panelParsed.panel, "code-experts");
+    assert.equal(panelParsed.consensus, "majority");
+});
+test("reviewer count must be a positive integer within the limit", () => {
+    for (const value of ["0", "-1", "1.5", "many"]) {
+        assert.throws(() => parseReviewCommand(["--reviewers", value, "--", "@src"]), (error) => error instanceof ArgsParseError && /positive integer/.test(error.message));
+    }
+    assert.throws(() => parseReviewCommand(["--reviewers", "9", "--", "@src"]), (error) => error instanceof ArgsParseError && /between 1 and 8/.test(error.message));
+});
+test("minimum agreement must be a positive integer and cannot exceed reviewers", () => {
+    assert.throws(() => parseReviewCommand(["--reviewers", "3", "--min-agree", "0", "--", "@src"]), (error) => error instanceof ArgsParseError && /positive integer/.test(error.message));
+    assert.throws(() => parseReviewCommand(["--reviewers", "2", "--consensus", "quorum", "--min-agree", "3", "--", "@src"]), (error) => error instanceof ArgsParseError && /cannot exceed reviewer count 2/.test(error.message));
+});
+test("unsupported consensus policy is a usage error", () => {
+    assert.throws(() => parseReviewCommand(["--reviewers", "3", "--consensus", "supermajority", "--", "@src"]), (error) => error instanceof ArgsParseError && /unknown consensus policy/.test(error.message));
+});
+test("min-agree is only meaningful with quorum consensus", () => {
+    assert.throws(() => parseReviewCommand(["--reviewers", "3", "--consensus", "majority", "--min-agree", "2", "--", "@src"]), (error) => error instanceof ArgsParseError && /only meaningful with --consensus quorum/.test(error.message));
+});
+test("reviewers and panel cannot be combined (any reviewer count)", () => {
+    for (const count of ["3", "1"]) {
+        assert.throws(() => parseReviewCommand(["--reviewers", count, "--panel", "code-experts", "--", "@src"]), (error) => error instanceof ArgsParseError && /cannot be used with --panel/.test(error.message));
+    }
+});
+test("panel options require an active panel (reviewers > 1 or panel)", () => {
+    for (const args of [
+        ["--consensus", "any"],
+        ["--min-agree", "2"],
+        ["--concurrency", "2"],
+        ["--consensus-model", "openai/gpt-5.5"],
+    ]) {
+        assert.throws(() => parseReviewCommand([...args, "--", "@src"]), (error) => error instanceof ArgsParseError && /panel options require/.test(error.message));
+    }
+});
+test("panel cannot be used with session reuse flags", () => {
+    for (const sessionArgs of [
+        ["--keep-session"],
+        ["--continue", "/tmp/session.jsonl"],
+        ["--name", "gate"],
+    ]) {
+        assert.throws(() => parseReviewCommand(["--reviewers", "3", ...sessionArgs, "--", "@src"]), (error) => error instanceof ArgsParseError && /panel cannot be used with/.test(error.message));
+    }
+});
+test("concurrency cannot exceed reviewer count", () => {
+    assert.throws(() => parseReviewCommand(["--reviewers", "2", "--concurrency", "5", "--", "@src"]), (error) => error instanceof ArgsParseError && /--concurrency 5 cannot exceed reviewer count 2/.test(error.message));
+});
+test("single reviewer with no panel flags keeps existing single-review parsing", () => {
+    const parsed = parseReviewCommand(["--reviewers", "1", "--", "@src"]);
+    assert.equal(parsed.reviewers, 1);
+    assert.equal(parsed.panel, undefined);
+});
+//# sourceMappingURL=args.test.js.map

package/dist/args.test.js.map

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

package/dist/cli-exit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli-exit.test.d.ts.map

package/dist/cli-exit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-exit.test.d.ts","sourceRoot":"","sources":["../src/cli-exit.test.ts"],"names":[],"mappings":""}

package/dist/cli-exit.test.js

@@ -0,0 +1,84 @@
+import assert from "node:assert/strict";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { test } from "node:test";
+function tsxLoaderArgs() {
+    const args = [];
+    for (let index = 0; index < process.execArgv.length - 1; index += 1) {
+        const flag = process.execArgv[index];
+        const value = process.execArgv[index + 1];
+        if ((flag === "--require" || flag === "--import") && value?.includes("tsx")) {
+            args.push(flag, value);
+            index += 1;
+        }
+    }
+    return args;
+}
+function runCli(fakePi, verdict, childExit = "0") {
+    const cliPath = fileURLToPath(new URL("./cli.ts", import.meta.url));
+    return spawnSync(process.execPath, [...tsxLoaderArgs(), cliPath, "--no-stream", "--", "@src"], {
+        cwd: path.dirname(fileURLToPath(new URL("../package.json", import.meta.url))),
+        env: {
+            ...process.env,
+            PI_BIN: fakePi,
+            FAKE_REVIEW_VERDICT: verdict,
+            FAKE_REVIEW_EXIT: childExit,
+        },
+        encoding: "utf8",
+        timeout: 30_000,
+    });
+}
+test("invalid loop arguments print usage and exit 2", () => {
+    const cliPath = fileURLToPath(new URL("./cli.ts", import.meta.url));
+    const result = spawnSync(process.execPath, [...tsxLoaderArgs(), cliPath, "loop", "--max-rounds", "0", "--", "@src"], { encoding: "utf8", timeout: 30_000 });
+    assert.equal(result.error, undefined);
+    assert.equal(result.status, 2);
+    assert.match(result.stderr, /--max-rounds must be a positive integer/);
+    assert.match(result.stderr, /Usage:/);
+    assert.match(result.stderr, /pi-review loop/);
+});
+test("single-review CLI maps structured status to gate exit codes", (t) => {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "pi-review-cli-exit-"));
+    t.after(() => fs.rmSync(tempDir, { recursive: true, force: true }));
+    const fakePi = path.join(tempDir, "fake-pi");
+    fs.writeFileSync(fakePi, `#!/usr/bin/env node
+const verdict = process.env.FAKE_REVIEW_VERDICT;
+const findings = verdict === "request_changes"
+  ? "### F1: Fix the gate\\n- Severity: high\\n- Path: src/cli.ts\\n- Actionable: yes"
+  : "No material findings.";
+const text = "## Verdict\\n" + verdict + "\\n\\n## Summary\\n- Fixture.\\n\\n## Findings\\n" + findings + "\\n\\n## Risks and Blind Spots\\nNone.\\n\\n## Open Questions\\nNone.\\n";
+function line(obj) { process.stdout.write(JSON.stringify(obj) + "\\n"); }
+line({ type: "session", version: 3, id: "s1" });
+line({ type: "agent_start" });
+line({ type: "turn_start" });
+line({ type: "message_start", message: { role: "user", content: [{ type: "text", text: "review" }] } });
+line({ type: "message_end", message: { role: "user", content: [{ type: "text", text: "review" }] } });
+line({ type: "message_start", message: { role: "assistant", content: [], model: "fake/model", usage: { input: 100, output: 50, cacheRead: 0, cacheWrite: 0, reasoning: 0, totalTokens: 150 } } });
+line({ type: "message_update", assistantMessageEvent: { type: "text_delta", delta: text, partial: { role: "assistant" } } });
+line({ type: "message_update", assistantMessageEvent: { type: "text_end", content: text, partial: { role: "assistant" } } });
+line({ type: "message_end", message: { role: "assistant", content: [{ type: "text", text }], model: "fake/model", usage: { input: 100, output: 50, cacheRead: 0, cacheWrite: 0, reasoning: 0, totalTokens: 150 }, stopReason: "stop" } });
+line({ type: "turn_end", message: { role: "assistant", content: [{ type: "text", text }], usage: { input: 100, output: 50, totalTokens: 150 } } });
+line({ type: "agent_end", messages: [{ role: "user", content: [{ type: "text", text: "review" }] }, { role: "assistant", content: [{ type: "text", text }], responseModel: "fake/model" }] });
+process.exit(Number(process.env.FAKE_REVIEW_EXIT ?? "0"));
+`);
+    fs.chmodSync(fakePi, 0o755);
+    const scenarios = [
+        { verdict: "approve", childExit: "0", expectedStatus: "clean", expectedExit: 0 },
+        { verdict: "request_changes", childExit: "0", expectedStatus: "has_findings", expectedExit: 1 },
+        { verdict: "needs_clarification", childExit: "0", expectedStatus: "needs_human", expectedExit: 3 },
+        { verdict: "approve", childExit: "9", expectedStatus: "blocked", expectedExit: 4 },
+    ];
+    for (const scenario of scenarios) {
+        const result = runCli(fakePi, scenario.verdict, scenario.childExit);
+        assert.equal(result.error, undefined);
+        assert.equal(result.status, scenario.expectedExit, result.stderr);
+        const metaLine = result.stderr.split("\n").find((line) => line.startsWith("PI_REVIEW_META_JSON: "));
+        assert.ok(metaLine, result.stderr);
+        const meta = JSON.parse(metaLine.slice("PI_REVIEW_META_JSON: ".length));
+        assert.equal(meta.status, scenario.expectedStatus);
+    }
+});
+//# sourceMappingURL=cli-exit.test.js.map

package/dist/cli-exit.test.js.map

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

package/dist/cli.js

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
-import { parseArgs, usage } from "./args.js";
 import { isInstallHelp } from "./install-args.js";
-import { runModels, runReview } from "./review.js";
+import { isPanelActive, parseArgs, usage } from "./args.js";
+import { readReviewStdin, runModels, runReview, runReviewOnce } from "./review.js";
+import { formatLoopSummary, runReviewLoop } from "./loop.js";
+import { runPanelReview, runPanelReviewOnce } from "./panel.js";
 import { resolveConfig } from "./config.js";
 import { installSkill, uninstallSkill } from "./skill.js";
 import { runUpdate } from "./update.js";
@@ -29,6 +31,18 @@ else if (parsed.command === "install-skill") {
 else if (parsed.command === "uninstall-skill") {
     uninstallSkill(parsed.extraArgs);
 }
+else if (parsed.command === "loop") {
+    const stdinText = readReviewStdin();
+    const runOne = isPanelActive(parsed)
+        ? () => runPanelReviewOnce(parsed, stdinText)
+        : () => runReviewOnce(parsed, stdinText);
+    const result = await runReviewLoop(parsed.maxRounds, runOne);
+    process.stdout.write(`${formatLoopSummary(result)}\n`);
+    process.exit(result.exitCode);
+}
+else if (isPanelActive(parsed)) {
+    await runPanelReview(parsed);
+}
 else {
     await runReview(parsed);
 }

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAChD,IAAI,aAAa,CAAC,MAAM,CAAC;IAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AAEpC,IAAI,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;AAC/C,CAAC;KAAM,IAAI,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;IACvC,SAAS,EAAE,CAAC;AACd,CAAC;KAAM,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;IACxC,UAAU,CAAC;QACT,EAAE,EAAE,MAAM,CAAC,SAAS,KAAK,KAAK;QAC9B,MAAM,EAAE,MAAM,CAAC,aAAa,KAAK,KAAK;QACtC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;KAClC,CAAC,CAAC;AACL,CAAC;KAAM,IAAI,MAAM,CAAC,OAAO,KAAK,eAAe,EAAE,CAAC;IAC9C,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC;KAAM,IAAI,MAAM,CAAC,OAAO,KAAK,iBAAiB,EAAE,CAAC;IAChD,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC;KAAM,CAAC;IACN,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAuB,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAChD,IAAI,aAAa,CAAC,MAAM,CAAC;IAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AAEpC,IAAI,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;AAC/C,CAAC;KAAM,IAAI,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;IACvC,SAAS,EAAE,CAAC;AACd,CAAC;KAAM,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;IACxC,UAAU,CAAC;QACT,EAAE,EAAE,MAAM,CAAC,SAAS,KAAK,KAAK;QAC9B,MAAM,EAAE,MAAM,CAAC,aAAa,KAAK,KAAK;QACtC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;KAClC,CAAC,CAAC;AACL,CAAC;KAAM,IAAI,MAAM,CAAC,OAAO,KAAK,eAAe,EAAE,CAAC;IAC9C,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC;KAAM,IAAI,MAAM,CAAC,OAAO,KAAK,iBAAiB,EAAE,CAAC;IAChD,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC;KAAM,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;IACrC,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;QAClC,CAAC,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC;QAC7C,CAAC,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,SAAU,EAAE,MAAM,CAAC,CAAC;IAC9D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;KAAM,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;IACjC,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;KAAM,CAAC;IACN,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC"}

package/dist/config.d.ts

@@ -1,6 +1,7 @@
 export interface Config {
     piBin: string;
     presetsFile: string;
+    panelPresetsFile: string;
     systemPromptFile: string;
     sessionsRoot: string;
     reviewHome: string;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,aAAa,IAAI,MAAM,CAStC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,aAAa,IAAI,MAAM,CAUtC"}

package/dist/config.js

@@ -11,6 +11,7 @@ export function resolveConfig() {
         piBin: process.env.PI_BIN || "pi",
         reviewHome,
         presetsFile: process.env.PI_REVIEW_PRESETS || path.join(reviewHome, "review-presets.json"),
+        panelPresetsFile: process.env.PI_REVIEW_PANEL_PRESETS || path.join(reviewHome, "panel-presets.json"),
         systemPromptFile: process.env.PI_REVIEW_SYSTEM_PROMPT || path.join(reviewHome, "system-prompt.md"),
         sessionsRoot: process.env.PI_REVIEW_SESSION_DIR || path.join(DEFAULT_DATA_DIR, "sessions"),
     };

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AACnD,MAAM,oBAAoB,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;AAClE,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;AAUrE,MAAM,UAAU,aAAa;IAC3B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,oBAAoB,CAAC;IACtE,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,IAAI;QACjC,UAAU;QACV,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,qBAAqB,CAAC;QAC1F,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC;QAClG,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC;KAC3F,CAAC;AACJ,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AACnD,MAAM,oBAAoB,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;AAClE,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;AAWrE,MAAM,UAAU,aAAa;IAC3B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,oBAAoB,CAAC;IACtE,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,IAAI;QACjC,UAAU;QACV,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,qBAAqB,CAAC;QAC1F,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC;QACpG,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC;QAClG,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC;KAC3F,CAAC;AACJ,CAAC"}

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

@@ -1,14 +1,24 @@
-export { parseArgs } from "./args.js";
+export { ArgsParseError, DEFAULT_MAX_ROUNDS, isPanelActive, parseArgs, parseReviewCommand } from "./args.js";
 export { resolveConfig } from "./config.js";
 export type { Config } from "./config.js";
-export { loadPresets, loadSystemPrompt } from "./presets.js";
-export { splitPayload, buildPrompt } from "./prompt.js";
-export { runModels, runReview } from "./review.js";
+export { loadPresets, loadPanelPresets, loadSystemPrompt } from "./presets.js";
+export { splitPayload, buildPrompt, buildReviewerPrompt, buildAdjudicatorPrompt } from "./prompt.js";
+export { readReviewStdin, runModels, runReview, runReviewOnce } from "./review.js";
+export { runPanelReview, runPanelReviewOnce, emitPanelFooter } from "./panel.js";
+export { formatLoopSummary, runReviewLoop } from "./loop.js";
+export type { LoopReviewResult, LoopRoundSummary, LoopRoundPanelSummary, LoopStopReason, RunOneReview } from "./loop.js";
+export { aggregatePanel, effectiveThreshold } from "./panel-aggregate.js";
+export type { PanelAggregationInput } from "./panel-aggregate.js";
+export { DeterministicMatcher, SemanticMatcher } from "./matcher.js";
+export type { FindingMatcher, MatchResult, SemanticAdjudicator, AdjudicationRequest, AdjudicationResponse, AdjudicationMerge, AdjudicationCandidate } from "./matcher.js";
+export { resolvePanelConfig } from "./panel-config.js";
+export type { ResolvedPanelConfig } from "./panel-config.js";
 export { makeRunSessionDir, newestJsonl } from "./session.js";
-export type { Verdict, ParsedArgs, ReviewPreset, VerdictInfo, ReviewMeta, SplitPayload, } from "./types.js";
-export { VERDICTS } from "./types.js";
+export type { Verdict, ReviewStatus, ReviewFinding, ParsedArgs, ReviewPreset, VerdictInfo, StructuredReviewResult, ReviewMeta, ReviewRunResult, SplitPayload, ConsensusPolicy, SourceFinding, FindingCluster, PanelHealth, ReviewerOutcome, PanelFields, PanelAggregationResult, PanelReviewMeta, ReviewerSubmission, PanelReviewerSpec, PanelPreset, TokenUsage, } from "./types.js";
+export { REVIEW_STATUSES, VERDICTS, CONSENSUS_POLICIES, MAX_REVIEWERS, DEFAULT_PANEL_MIN_AGREE, } from "./types.js";
 export { fail, hasPathSeparator, expandMaybeHome, normalizeTools } from "./utils.js";
 export { parseVerdict } from "./verdict.js";
-export { formatDurationMs, formatReviewMetaAscii, formatReviewMetaJsonLine } from "./meta-footer.js";
+export { parseReviewResult, reviewExitCode } from "./review-result.js";
+export { formatDurationMs, formatTokens, formatUsage, formatReviewMetaAscii, formatReviewMetaJsonLine, formatPanelMetaAscii, formatPanelFindingsMarkdown } from "./meta-footer.js";
 export { installSkill, uninstallSkill } from "./skill.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":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC9D,YAAY,EACV,OAAO,EACP,UAAU,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACrG,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC7G,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrG,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzH,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACrE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1K,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC9D,YAAY,EACV,OAAO,EACP,YAAY,EACZ,aAAa,EACb,UAAU,EACV,YAAY,EACZ,WAAW,EACX,sBAAsB,EACtB,UAAU,EACV,eAAe,EACf,YAAY,EACZ,eAAe,EACf,aAAa,EACb,cAAc,EACd,WAAW,EACX,eAAe,EACf,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,QAAQ,EACR,kBAAkB,EAClB,aAAa,EACb,uBAAuB,GACxB,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,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AACnL,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,12 +1,18 @@
-export { parseArgs } from "./args.js";
+export { ArgsParseError, DEFAULT_MAX_ROUNDS, isPanelActive, parseArgs, parseReviewCommand } from "./args.js";
 export { resolveConfig } from "./config.js";
-export { loadPresets, loadSystemPrompt } from "./presets.js";
-export { splitPayload, buildPrompt } from "./prompt.js";
-export { runModels, runReview } from "./review.js";
+export { loadPresets, loadPanelPresets, loadSystemPrompt } from "./presets.js";
+export { splitPayload, buildPrompt, buildReviewerPrompt, buildAdjudicatorPrompt } from "./prompt.js";
+export { readReviewStdin, runModels, runReview, runReviewOnce } from "./review.js";
+export { runPanelReview, runPanelReviewOnce, emitPanelFooter } from "./panel.js";
+export { formatLoopSummary, runReviewLoop } from "./loop.js";
+export { aggregatePanel, effectiveThreshold } from "./panel-aggregate.js";
+export { DeterministicMatcher, SemanticMatcher } from "./matcher.js";
+export { resolvePanelConfig } from "./panel-config.js";
 export { makeRunSessionDir, newestJsonl } from "./session.js";
-export { VERDICTS } from "./types.js";
+export { REVIEW_STATUSES, VERDICTS, CONSENSUS_POLICIES, MAX_REVIEWERS, DEFAULT_PANEL_MIN_AGREE, } from "./types.js";
 export { fail, hasPathSeparator, expandMaybeHome, normalizeTools } from "./utils.js";
 export { parseVerdict } from "./verdict.js";
-export { formatDurationMs, formatReviewMetaAscii, formatReviewMetaJsonLine } from "./meta-footer.js";
+export { parseReviewResult, reviewExitCode } from "./review-result.js";
+export { formatDurationMs, formatTokens, formatUsage, formatReviewMetaAscii, formatReviewMetaJsonLine, formatPanelMetaAscii, formatPanelFindingsMarkdown } from "./meta-footer.js";
 export { installSkill, uninstallSkill } from "./skill.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,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAS9D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACrG,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,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,MAAM,WAAW,CAAC;AAC7G,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,WAAW,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrG,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE7D,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;AAyB9D,OAAO,EACL,eAAe,EACf,QAAQ,EACR,kBAAkB,EAClB,aAAa,EACb,uBAAuB,GACxB,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,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AACnL,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/json-events.d.ts

@@ -1,7 +1,52 @@
+import type { TokenUsage } from "./types.js";
 export interface ExtractedFinalText {
     text: string;
     error?: string;
     fatal?: boolean;
 }
+export interface ExtractedUsage {
+    usage?: TokenUsage;
+    /** The model id pi reported for the final assistant message, if any. */
+    responseModel?: string;
+}
 export declare function extractFinalText(jsonLinesText: string): ExtractedFinalText;
+/**
+ * Extract token usage and the response model from a pi `--mode json` event
+ * stream. Usage is accumulated from assistant message/turn/agent_end events.
+ * Degrades gracefully (returns undefined) when usage fields are absent.
+ */
+export declare function extractUsage(jsonLinesText: string): ExtractedUsage;
+export interface StreamEventEmitter {
+    /** Called for every text chunk that should be shown to the human. */
+    onText(chunk: string): void;
+    /** Called for every semantic milestone (already formatted, ends with \n). */
+    onMilestone(line: string): void;
+}
+export interface StreamedUsage {
+    usage?: TokenUsage;
+    responseModel?: string;
+}
+/**
+ * Feed one chunk of stdout from pi --mode json. Splits on newlines, buffers
+ * partial lines, and emits text deltas + milestone notices + usage updates.
+ * Returns nothing; the caller reads final usage via `streamedUsage()`.
+ */
+export declare class JsonEventStream {
+    private buffer;
+    private readonly emit;
+    private readonly accumulate;
+    private sawAnyUsage;
+    private responseModel;
+    private turn;
+    private inAssistantTurn;
+    constructor(emit: StreamEventEmitter);
+    /** Feed a raw stdout chunk (may contain partial JSON lines). */
+    feed(chunk: string): void;
+    /** Flush any trailing partial line (call at end of stream). */
+    flush(): void;
+    /** Final accumulated token usage (undefined if no usage seen). */
+    usage(): StreamedUsage;
+    private processLine;
+    private handle;
+}
 //# sourceMappingURL=json-events.d.ts.map

package/dist/json-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-events.d.ts","sourceRoot":"","sources":["../src/json-events.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAcD,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,kBAAkB,CAsD1E"}
+{"version":3,"file":"json-events.d.ts","sourceRoot":"","sources":["../src/json-events.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA4CD,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,kBAAkB,CAsD1E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,CA4ClE;AAQD,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,6EAA6E;IAC7E,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAaD;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,eAAe,CAAS;gBAEpB,IAAI,EAAE,kBAAkB;IAKpC,gEAAgE;IAChE,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAUzB,+DAA+D;IAC/D,KAAK,IAAI,IAAI;IAKb,kEAAkE;IAClE,KAAK,IAAI,aAAa;IAOtB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,MAAM;CAkDf"}