@quickchatai/pi-quickreview 1.2.0 → 1.3.2

package/dist/src/plugin/args.js

@@ -1,18 +1,59 @@
-// The /review command's arguments, as a person types them after the command:
+// /qcr-review's arguments, as a person types them after the command:
 //
-//   /review                     the current branch against its base
-//   /review 123 | #123 | URL    a pull request
-//   /review --branch [--base R] the current branch (against R)
-//   /review --uncommitted       the uncommitted tree against HEAD
-//   --preview                   the plan and the price; nothing runs
-//   --to pr | --to file | …     where the result goes (reviewdest.ts)
-//   --json                      the result as JSON, nothing asked
-//   --profile NAME              review under that profile
-//   --limit USD                 this run's limit (above it the run asks)
-//   --repo OWNER/NAME           the PR's repo, when it is not the cwd's
-//   --full                      review everything again, ignoring history
-import { parseDestinations } from "../reviewdest.js";
-export const REVIEW_COMMAND_USAGE = "usage: /review [PR number or URL | --branch [--base REF] | --uncommitted] [--preview] [--to terminal|file|json|pr] [--json] [--profile NAME] [--limit USD] [--repo OWNER/NAME] [--full]";
+//   /qcr-review [preset] [target] [flags]
+//
+//   preset    quick | full | security: the first word, when it names one
+//             (else the `quickreview.preset` pi setting, else none)
+//   target    nothing         this branch against its base, with its
+//                             uncommitted changes, as one review
+//             123 | #123 | URL  a pull request
+//             NAME            the branch NAME against its base (its commits)
+//             --uncommitted   the uncommitted changes alone, against HEAD
+//   --base REF      the base a branch is reviewed against
+//   --preview       the plan and the price; nothing runs
+//   --json          the result as JSON (pi's print mode)
+//   --profile NAME  review under that profile
+//   --limit USD     this run's limit (above it the run asks)
+//   --repo O/N      the PR's repo, when it is not the cwd's
+//   --stop          stop the review running in this session
+//
+// A preset is the review options the core already takes, named: a lens plan
+// (`[review] preset`, `skip_lenses`) and a scope (`full`). It is never a code
+// path of its own.
+//
+// Retired spellings stay accepted (tests/legacy-acceptance.test.ts), folded
+// to the current ones and never named in the usage: `--full` is the `full`
+// preset, `--branch` the bare command's branch, and `--to LIST` the old
+// destination list, of which only `json` still means anything (a result is
+// always shown and kept, and a post is the posting rule's).
+import { ALL_PASSES } from "../passes.js";
+/** The lenses the security preset keeps; every other lens is skipped. */
+export const SECURITY_LENSES = [
+    "pass-baseline",
+    "pass-security",
+    "pass-data-safety",
+    "pass-bounds",
+    "pass-contracts",
+    "pass-validate",
+];
+function securitySkips() {
+    return ALL_PASSES.filter((p) => !SECURITY_LENSES.includes(p));
+}
+/** The presets /qcr-review takes, each as the core's review options. */
+export const REVIEW_PRESETS = {
+    /** The default plan at low reasoning: about half the cost and time. */
+    quick: { levers: "review.preset=low", full: false },
+    /** The full lever plan at the highest reasoning, over the whole target
+     * again (what an earlier review left is ignored). */
+    full: { levers: "review.preset=max", full: true },
+    /** Only the risk lenses the change triggers (security, data safety,
+     * bounds, contracts), with the baseline and the validator. */
+    security: { levers: `review.skip_lenses=${securitySkips().join("|")}`, full: false },
+};
+export const REVIEW_PRESET_NAMES = Object.keys(REVIEW_PRESETS);
+export const isPresetName = (w) => w !== undefined && REVIEW_PRESET_NAMES.includes(w);
+export const REVIEW_COMMAND_USAGE = `usage: /qcr-review [${REVIEW_PRESET_NAMES.join("|")}] [PR number or URL | BRANCH | --uncommitted] ` +
+    "[--base REF] [--preview] [--json] [--profile NAME] [--limit USD] [--repo OWNER/NAME] | /qcr-review --stop";
 /** The words of a command line; double quotes group, nothing else is special. */
 export function splitArgs(line) {
     const out = [];
@@ -21,15 +62,30 @@ export function splitArgs(line) {
         out.push(m[1] ?? m[2]);
     return out;
 }
-/** Parse `/review`'s arguments; a usage error is `{ error }`. */
-export function parseReviewCommand(line) {
+/** The destinations the retired `--to` took. */
+const LEGACY_DESTINATIONS = ["terminal", "file", "json", "pr"];
+/** A word that names a pull request: a number, `#N`, or a pull URL. */
+const isPrWord = (w) => /^#?\d+$/.test(w) || /^https?:\/\/\S+\/pull\/\d+/.test(w);
+/**
+ * Parse `/qcr-review`'s arguments; a usage error is `{ error }`, `--stop` is
+ * `{ stop: true }`. `defaultPreset` is the person's own (pi's settings): a
+ * preset typed as the first word wins over it.
+ */
+export function parseReviewCommand(line, defaultPreset = null) {
     const a = splitArgs(line);
-    let pr;
+    if (a.length === 1 && a[0] === "--stop")
+        return { stop: true };
+    let preset = defaultPreset;
+    const typed = isPresetName(a[0]);
+    if (typed)
+        preset = a.shift();
+    let word;
     let repo;
     let base;
-    let branch = false;
     let uncommitted = false;
-    const cmd = { preview: false, json: false, full: false, to: [] };
+    let full = false;
+    let branch = false;
+    const cmd = { preview: false, json: false };
     const value = (i, flag) => {
         const v = a[i + 1];
         if (v === undefined || v.startsWith("--"))
@@ -46,12 +102,6 @@ export function parseReviewCommand(line) {
                 case "--json":
                     cmd.json = true;
                     break;
-                case "--full":
-                    cmd.full = true;
-                    break;
-                case "--branch":
-                    branch = true;
-                    break;
                 case "--uncommitted":
                     uncommitted = true;
                     break;
@@ -64,9 +114,6 @@ export function parseReviewCommand(line) {
                 case "--profile":
                     cmd.profile = value(i++, w);
                     break;
-                case "--to":
-                    cmd.to = [...cmd.to, ...parseDestinations(value(i++, w))];
-                    break;
                 case "--limit": {
                     const n = Number(value(i++, w));
                     if (!Number.isFinite(n) || n <= 0)
@@ -74,12 +121,32 @@ export function parseReviewCommand(line) {
                     cmd.limitUsd = n;
                     break;
                 }
+                case "--full":
+                    full = true;
+                    break;
+                case "--branch":
+                    branch = true;
+                    break;
+                case "--to":
+                    for (const d of value(i++, w)
+                        .split(",")
+                        .map((x) => x.trim())) {
+                        if (!LEGACY_DESTINATIONS.includes(d))
+                            throw new Error(`unknown destination ${d || "(empty)"}`);
+                        if (d === "json")
+                            cmd.json = true;
+                    }
+                    break;
+                case "--stop":
+                    throw new Error("--stop goes alone");
                 default:
                     if (w.startsWith("--"))
                         throw new Error(`unknown flag ${w}`);
-                    if (pr !== undefined)
-                        throw new Error(`one target at a time (got ${pr} and ${w})`);
-                    pr = w;
+                    if (isPresetName(w) && word === undefined && i > 0)
+                        throw new Error(`the preset goes first: /qcr-review ${w} …`);
+                    if (word !== undefined)
+                        throw new Error(`one target at a time (got ${word} and ${w})`);
+                    word = w;
             }
         }
     }
@@ -88,20 +155,50 @@ export function parseReviewCommand(line) {
             error: `${err instanceof Error ? err.message : String(err)}\n${REVIEW_COMMAND_USAGE}`,
         };
     }
-    const kinds = [pr !== undefined, branch, uncommitted].filter(Boolean).length;
-    if (kinds > 1)
+    if (full) {
+        if (typed && preset !== "full")
+            return {
+                error: `--full is the full preset, and ${preset} was asked for: pick one\n${REVIEW_COMMAND_USAGE}`,
+            };
+        preset = "full";
+    }
+    if (branch && (word !== undefined || uncommitted))
         return {
-            error: `a PR, --branch and --uncommitted are each a whole target: pick one\n${REVIEW_COMMAND_USAGE}`,
+            error: `--branch is this branch: a PR, a branch name and --uncommitted are each a whole target\n${REVIEW_COMMAND_USAGE}`,
+        };
+    const pr = word !== undefined && isPrWord(word) ? word : undefined;
+    const head = word !== undefined && pr === undefined ? word : undefined;
+    if (word !== undefined && uncommitted)
+        return {
+            error: `${word} and --uncommitted are each a whole target: pick one\n${REVIEW_COMMAND_USAGE}`,
         };
     if (base !== undefined && (pr !== undefined || uncommitted))
-        return { error: `--base goes with the branch review\n${REVIEW_COMMAND_USAGE}` };
+        return { error: `--base goes with a branch review\n${REVIEW_COMMAND_USAGE}` };
     if (repo !== undefined && pr === undefined)
         return { error: `--repo names the PR's repo: give a PR too\n${REVIEW_COMMAND_USAGE}` };
     const target = pr !== undefined
         ? { kind: "pr", pr, ...(repo !== undefined ? { repo } : {}) }
         : uncommitted
             ? { kind: "uncommitted" }
-            : { kind: "branch", ...(base !== undefined ? { base } : {}) };
-    return { ...cmd, target };
+            : {
+                kind: "branch",
+                ...(base !== undefined ? { base } : {}),
+                ...(head !== undefined ? { head } : { uncommitted: true }),
+            };
+    return { ...cmd, preset, target };
+}
+/** What a review is of, in the words a person reads ("PR #12 (quick)"). */
+export function reviewLabel(cmd) {
+    const t = cmd.target;
+    const what = t.kind === "pr"
+        ? `PR ${/^\d+$/.test(String(t.pr)) ? `#${t.pr}` : String(t.pr)}`
+        : t.kind === "uncommitted"
+            ? "the uncommitted changes"
+            : t.kind === "branch" && t.head !== undefined
+                ? `the branch ${t.head}`
+                : t.kind === "branch"
+                    ? "this branch with its uncommitted changes"
+                    : "the diff";
+    return cmd.preset !== null ? `${what} (${cmd.preset})` : what;
 }
 //# sourceMappingURL=args.js.map

package/dist/src/plugin/args.js.map

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

package/dist/src/plugin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugin/index.ts"],"names":[],"mappings":";AASA,wBAKG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugin/index.ts"],"names":[],"mappings":";AAYA,wBAMG"}

package/dist/src/plugin/index.js

@@ -1,8 +1,11 @@
 // The pi plugin's entry, the file the package's `pi.extensions` names: the
 // one place the process's environment, home and standard output become the
-// plugin's config (extensions/quickreview.ts takes them as data).
+// plugin's config (extensions/quickreview.ts takes them as data), and where
+// the process-wide resolve hook for pi's own packages is registered
+// (src/plugin/peers.ts).
 import { homedir } from "node:os";
 import { createQuickReview } from "../../extensions/quickreview.js";
+import { resolvePeersFrom } from "./peers.js";
 import { nodeRunner } from "./runner.js";
 const env = process.env;
 export default createQuickReview({
@@ -10,5 +13,6 @@ export default createQuickReview({
     home: (env["HOME"] ?? "").trim() || homedir(),
     runner: nodeRunner(env),
     print: (text) => void process.stdout.write(text.endsWith("\n") ? text : `${text}\n`),
+    peers: (piDir) => void resolvePeersFrom(piDir),
 });
 //# sourceMappingURL=index.js.map

package/dist/src/plugin/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugin/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,2EAA2E;AAC3E,kEAAkE;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;AAExB,eAAe,iBAAiB,CAAC;IAC/B,GAAG;IACH,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,OAAO,EAAE;IAC7C,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC;IACvB,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC;CACrF,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugin/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,2EAA2E;AAC3E,4EAA4E;AAC5E,oEAAoE;AACpE,yBAAyB;AACzB,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;AAExB,eAAe,iBAAiB,CAAC;IAC/B,GAAG;IACH,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,OAAO,EAAE;IAC7C,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC;IACvB,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC;IACpF,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,gBAAgB,CAAC,KAAK,CAAC;CAC/C,CAAC,CAAC"}

package/dist/src/plugin/login.d.ts

@@ -1,4 +1,3 @@
-import type { CoreConfig } from "../reviewconfig.js";
 import type { LoginSummary } from "../engine/auth.js";
 /** What the plugin asks of the host pi's auth, by shape (the extension wires
  * it to `ctx.modelRegistry` and the host's auth file). */
@@ -12,9 +11,6 @@ export interface HostAuth {
      * `minValidityMs` more: it refreshes it if not. Rejects when it cannot. */
     refresh(provider: string, minValidityMs: number): Promise<void>;
 }
-/** The providers the review's sessions run on: every model spec's
- * `provider/` prefix, in first-seen order. */
-export declare function reviewProviders(cfg: Pick<CoreConfig, "models">): string[];
 export type BorrowResult = {
     ok: true;
     refreshed: string[];
@@ -27,6 +23,14 @@ export type BorrowResult = {
 };
 /** The hint for a provider pi has no credential for. */
 export declare function noLoginHint(provider: string, keyed: readonly string[]): string;
+/** The providers a run actually uses for the review's `providers`: each one
+ * itself, or its OpenAI twin when only the twin has a credential
+ * (modelroute.ts). One reading for the setup checklist and `borrowLogin`, so
+ * setup never calls a login missing that a review can run on. */
+export declare function routedProviders(providers: readonly string[], host: Pick<HostAuth, "logins" | "configured">): string[];
+/** Can a run use `provider` at all: an OAuth login (pi refreshes a short one
+ * before the run), or any other credential pi has. */
+export declare function canUseProvider(provider: string, host: Pick<HostAuth, "logins" | "configured">): boolean;
 /**
  * Make sure every provider the review needs is usable for `needMs` from now,
  * refreshing a short OAuth login through the host. `marginMs` is added to the

package/dist/src/plugin/login.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../../src/plugin/login.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD;0DAC0D;AAC1D,MAAM,WAAW,QAAQ;IACvB,8EAA8E;IAC9E,MAAM,IAAI,YAAY,CAAC;IACvB;2BACuB;IACvB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACtC;+EAC2E;IAC3E,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAED;8CAC8C;AAC9C,wBAAgB,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,MAAM,EAAE,CAgBzE;AAED,MAAM,MAAM,YAAY,GACpB;IACE,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB;qDACiD;IACjD,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAS9E;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE;IACnC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,YAAY,CAAC,CAyCxB"}
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../../src/plugin/login.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD;0DAC0D;AAC1D,MAAM,WAAW,QAAQ;IACvB,8EAA8E;IAC9E,MAAM,IAAI,YAAY,CAAC;IACvB;2BACuB;IACvB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACtC;+EAC2E;IAC3E,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAED,MAAM,MAAM,YAAY,GACpB;IACE,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB;qDACiD;IACjD,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAS9E;AAED;;;iEAGiE;AACjE,wBAAgB,eAAe,CAC7B,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,YAAY,CAAC,GAC5C,MAAM,EAAE,CAUV;AAED;sDACsD;AACtD,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,YAAY,CAAC,GAC5C,OAAO,CAET;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE;IACnC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,YAAY,CAAC,CAmCxB"}

package/dist/src/plugin/login.js

@@ -1,32 +1,32 @@
 import { routeProvider } from "../modelroute.js";
-/** The providers the review's sessions run on: every model spec's
- * `provider/` prefix, in first-seen order. */
-export function reviewProviders(cfg) {
-    const m = cfg.models;
-    const specs = [
-        m.conversation,
-        m.default,
-        ...Object.values(m.tiers),
-        ...Object.values(m.pass_models),
-    ];
-    const out = [];
-    for (const spec of specs) {
-        const slash = spec.indexOf("/");
-        if (slash <= 0)
-            continue;
-        const p = spec.slice(0, slash);
-        if (!out.includes(p))
-            out.push(p);
-    }
-    return out;
-}
 /** The hint for a provider pi has no credential for. */
 export function noLoginHint(provider, keyed) {
     const keys = keyed.length > 0
         ? ` pi has a key for ${keyed.join(", ")}, and the review does not switch models to use it: to review on that provider, set the review's models to it in your qcr config.`
         : "";
     return (`the review runs on ${provider}, and this pi has no login for it. ` +
-        `Run /login ${provider} in pi, then /review again.${keys}`);
+        `Run /login ${provider} in pi, then /qcr-review again.${keys}`);
+}
+/** The providers a run actually uses for the review's `providers`: each one
+ * itself, or its OpenAI twin when only the twin has a credential
+ * (modelroute.ts). One reading for the setup checklist and `borrowLogin`, so
+ * setup never calls a login missing that a review can run on. */
+export function routedProviders(providers, host) {
+    const logins = host.logins();
+    const out = [];
+    for (const named of providers) {
+        const p = routeProvider(named, "", {
+            hasCredential: (q) => logins[q] !== undefined || host.configured(q),
+        });
+        if (!out.includes(p))
+            out.push(p);
+    }
+    return out;
+}
+/** Can a run use `provider` at all: an OAuth login (pi refreshes a short one
+ * before the run), or any other credential pi has. */
+export function canUseProvider(provider, host) {
+    return host.logins()[provider]?.type === "oauth" || host.configured(provider);
 }
 /**
  * Make sure every provider the review needs is usable for `needMs` from now,
@@ -38,14 +38,7 @@ export async function borrowLogin(o) {
     const want = o.needMs + o.marginMs;
     const refreshed = [];
     let logins = o.host.logins();
-    const providers = [];
-    for (const named of o.providers) {
-        const p = routeProvider(named, "", {
-            hasCredential: (q) => logins[q] !== undefined || o.host.configured(q),
-        });
-        if (!providers.includes(p))
-            providers.push(p);
-    }
+    const providers = routedProviders(o.providers, o.host);
     for (const p of providers) {
         const login = logins[p];
         if (login?.type === "oauth") {
@@ -57,7 +50,7 @@ export async function borrowLogin(o) {
             catch (err) {
                 return {
                     ok: false,
-                    error: `pi could not refresh your ${p} login (${err instanceof Error ? err.message : String(err)}). Run /login ${p} in pi, then /review again.`,
+                    error: `pi could not refresh your ${p} login (${err instanceof Error ? err.message : String(err)}). Run /login ${p} in pi, then /qcr-review again.`,
                 };
             }
             logins = o.host.logins();
@@ -65,7 +58,7 @@ export async function borrowLogin(o) {
             if (after?.type !== "oauth" || after.expires === null || after.expires < now() + want)
                 return {
                     ok: false,
-                    error: `your ${p} login does not last this review's ${Math.round(o.needMs / 60_000)} minutes even after pi refreshed it. Run /login ${p} in pi, then /review again.`,
+                    error: `your ${p} login does not last this review's ${Math.round(o.needMs / 60_000)} minutes even after pi refreshed it. Run /login ${p} in pi, then /qcr-review again.`,
                 };
             refreshed.push(p);
             continue;

package/dist/src/plugin/login.js.map

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

package/dist/src/plugin/messages.d.ts

@@ -0,0 +1,7 @@
+/** The custom message type the review is shown as. */
+export declare const REVIEW_MESSAGE = "qcr-review";
+/** The answers the post question offers: No first, as pi's own confirm
+ * would start on Yes. */
+export declare const KEEP_IT_HERE = "No, keep it here";
+export declare const postAnswer: (dryRun: boolean) => string;
+//# sourceMappingURL=messages.d.ts.map

package/dist/src/plugin/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../src/plugin/messages.ts"],"names":[],"mappings":"AAKA,sDAAsD;AACtD,eAAO,MAAM,cAAc,eAAe,CAAC;AAE3C;yBACyB;AACzB,eAAO,MAAM,YAAY,qBAAqB,CAAC;AAC/C,eAAO,MAAM,UAAU,GAAI,QAAQ,OAAO,KAAG,MAGA,CAAC"}

package/dist/src/plugin/messages.js

@@ -0,0 +1,13 @@
+// What the plugin shows of a review in a pi session, in a module of its own:
+// the custom message type and the post question's answers. A host that only
+// shows a review (the app's home) imports this and never the review's
+// runtime.
+/** The custom message type the review is shown as. */
+export const REVIEW_MESSAGE = "qcr-review";
+/** The answers the post question offers: No first, as pi's own confirm
+ * would start on Yes. */
+export const KEEP_IT_HERE = "No, keep it here";
+export const postAnswer = (dryRun) => dryRun
+    ? "Yes, post it (dry run: the review is recorded, not sent)"
+    : "Yes, post it as a comment-only review";
+//# sourceMappingURL=messages.js.map

package/dist/src/plugin/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../../src/plugin/messages.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,4EAA4E;AAC5E,sEAAsE;AACtE,WAAW;AAEX,sDAAsD;AACtD,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC;AAE3C;yBACyB;AACzB,MAAM,CAAC,MAAM,YAAY,GAAG,kBAAkB,CAAC;AAC/C,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAe,EAAU,EAAE,CACpD,MAAM;IACJ,CAAC,CAAC,0DAA0D;IAC5D,CAAC,CAAC,uCAAuC,CAAC"}

package/dist/src/plugin/peers.d.ts

@@ -0,0 +1,17 @@
+/** The packages the plugin's package.json declares as peers. */
+export declare function declaredPeers(from?: string): string[];
+/** Is `specifier` one of `peers` or a subpath of one? */
+export declare function isPeer(specifier: string, peers: readonly string[]): boolean;
+interface ResolveContext {
+    parentURL?: string | undefined;
+    [key: string]: unknown;
+}
+type NextResolve = (specifier: string, context?: ResolveContext) => unknown;
+/** The resolve hook: Node's own answer first; a peer Node cannot find from the
+ * importer is resolved as if pi at `piDir` imported it. */
+export declare function peerResolve(piDir: string, peers: readonly string[]): (specifier: string, context: ResolveContext, next: NextResolve) => unknown;
+/** Register the hook for this process, once; false where this Node has no
+ * `module.registerHooks` or a hook is already in place. */
+export declare function resolvePeersFrom(piDir: string, peers?: readonly string[]): boolean;
+export {};
+//# sourceMappingURL=peers.d.ts.map

package/dist/src/plugin/peers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peers.d.ts","sourceRoot":"","sources":["../../../src/plugin/peers.ts"],"names":[],"mappings":"AAmBA,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,IAAI,GAAE,MAAwB,GAAG,MAAM,EAAE,CAEtE;AAED,yDAAyD;AACzD,wBAAgB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAE3E;AAED,UAAU,cAAc;IACtB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AACD,KAAK,WAAW,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC;AAE5E;2DAC2D;AAC3D,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAW5E;AAID;2DAC2D;AAC3D,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,SAAS,MAAM,EAAoB,GACzC,OAAO,CAQT"}

package/dist/src/plugin/peers.js

@@ -0,0 +1,55 @@
+// pi's own packages for the modules the plugin loads with Node's import().
+//
+// pi installs a package without its peer dependencies (`--omit=peer`, on
+// purpose) and hands an extension its own modules through its loader's
+// alias table. That covers the modules the loader loads: the entry and its
+// static imports. The review's SDK is imported later with Node's own
+// import() (src/engine/reviewruntime.ts), and Node resolves its bare
+// specifiers from the plugin's install, where no pi is: ERR_MODULE_NOT_FOUND.
+//
+// The hook below resolves the plugin's declared peers (package.json
+// `peerDependencies`) from the running pi's package dir instead, and only
+// where Node found nothing from the importer. A host that installs pi beside
+// the plugin (the qcr app, the image) never reaches the fallback, so its
+// resolution is unchanged. One pi package dir per process: the first wins.
+import * as nodeModule from "node:module";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { declaredPeerRanges } from "./versiongate.js";
+/** The packages the plugin's package.json declares as peers. */
+export function declaredPeers(from = import.meta.url) {
+    return Object.keys(declaredPeerRanges(from));
+}
+/** Is `specifier` one of `peers` or a subpath of one? */
+export function isPeer(specifier, peers) {
+    return peers.some((p) => specifier === p || specifier.startsWith(`${p}/`));
+}
+/** The resolve hook: Node's own answer first; a peer Node cannot find from the
+ * importer is resolved as if pi at `piDir` imported it. */
+export function peerResolve(piDir, peers) {
+    const parentURL = pathToFileURL(join(piDir, "package.json")).href;
+    return (specifier, context, next) => {
+        try {
+            return next(specifier, context);
+        }
+        catch (err) {
+            if (err.code !== "ERR_MODULE_NOT_FOUND" || !isPeer(specifier, peers))
+                throw err;
+            return next(specifier, { ...context, parentURL });
+        }
+    };
+}
+const INSTALLED = Symbol.for("qcr.plugin.piPeers");
+/** Register the hook for this process, once; false where this Node has no
+ * `module.registerHooks` or a hook is already in place. */
+export function resolvePeersFrom(piDir, peers = declaredPeers()) {
+    const g = globalThis;
+    const register = nodeModule
+        .registerHooks;
+    if (g[INSTALLED] !== undefined || typeof register !== "function")
+        return false;
+    register({ resolve: peerResolve(piDir, peers) });
+    g[INSTALLED] = piDir;
+    return true;
+}
+//# sourceMappingURL=peers.js.map

package/dist/src/plugin/peers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peers.js","sourceRoot":"","sources":["../../../src/plugin/peers.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,EAAE;AACF,yEAAyE;AACzE,uEAAuE;AACvE,2EAA2E;AAC3E,qEAAqE;AACrE,qEAAqE;AACrE,8EAA8E;AAC9E,EAAE;AACF,oEAAoE;AACpE,0EAA0E;AAC1E,6EAA6E;AAC7E,yEAAyE;AACzE,2EAA2E;AAC3E,OAAO,KAAK,UAAU,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,gEAAgE;AAChE,MAAM,UAAU,aAAa,CAAC,OAAe,MAAM,CAAC,IAAI,CAAC,GAAG;IAC1D,OAAO,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,MAAM,CAAC,SAAiB,EAAE,KAAwB;IAChE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,KAAK,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7E,CAAC;AAQD;2DAC2D;AAC3D,MAAM,UAAU,WAAW,CACzB,KAAa,EACb,KAAwB;IAExB,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC;IAClE,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QAClC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAAyB,CAAC,IAAI,KAAK,sBAAsB,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC;gBACzF,MAAM,GAAG,CAAC;YACZ,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAEnD;2DAC2D;AAC3D,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EACb,QAA2B,aAAa,EAAE;IAE1C,MAAM,CAAC,GAAG,UAAqC,CAAC;IAChD,MAAM,QAAQ,GAAI,UAA2E;SAC1F,aAAa,CAAC;IACjB,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK,SAAS,IAAI,OAAO,QAAQ,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IAC/E,QAAQ,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;IACrB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/plugin/review.d.ts

@@ -3,14 +3,14 @@ import { type ReviewRuntimeOptions } from "../engine/reviewruntime.js";
 import { preview as corePreview, review as coreReview, type ReviewRuntime } from "../reviewapi.js";
 import type { CoreConfig } from "../reviewconfig.js";
 import type { PluginHost, SessionUi } from "./session.js";
-/** The custom message type the review is shown as. */
-export declare const REVIEW_MESSAGE = "qcr-review";
+import { type QuickReviewSettings } from "./settings.js";
+export { KEEP_IT_HERE, postAnswer, REVIEW_MESSAGE } from "./messages.js";
 /** A review's wall clock, as `qcr review`'s. */
 export declare const REVIEW_TIMEOUT_MS: number;
 /** What a refused login says inside pi: pi's own /login is the fix. */
 export declare const PLUGIN_AUTH_WORDS: AuthCopyWords;
-/** How long a stopped review (Esc, the session ending) gets to wind down
- * before /review gives up waiting on it and returns. */
+/** How long a stopped review (`--stop`, the session ending) gets to wind
+ * down before /qcr-review gives up waiting on it. */
 export declare const STOP_GRACE_MS = 30000;
 /** The seams a test replaces. */
 export interface ReviewCommandDeps {
@@ -22,6 +22,52 @@ export interface ReviewCommandDeps {
     runtime: (cfg: CoreConfig, o: ReviewRuntimeOptions) => ReviewRuntime;
 }
 export declare const REVIEW_DEPS: ReviewCommandDeps;
-/** One run of /review. Never throws: every refusal reaches the person. */
-export declare function runReviewCommand(line: string, host: PluginHost, ui: SessionUi, deps?: ReviewCommandDeps): Promise<void>;
+/** What the status line knows of the review in flight. */
+export interface ReviewProgress {
+    /** What is reviewed ("PR #12 (quick)", args.ts `reviewLabel`). */
+    label: string;
+    stage: "pricing" | "preparing" | "running" | "asking" | "posting";
+    /** When the command started it (ms). */
+    startedAt: number;
+    /** From the round's start (`ReviewIo.started`). */
+    lenses?: number;
+    estimateUsd?: number;
+    capUsd?: number | null;
+    /** What each running lens is doing, from the round's live log
+     * (`liveLensLines`); empty until a lens has started. */
+    running?: readonly string[];
+}
+/** The status line for the review in flight: what it reviews, its stage, and
+ * what the round's start said (lenses, price, hard stop), with the time
+ * since it started. Every status line /qcr-review shows is built here. */
+export declare function reviewStatusLine(p: ReviewProgress, now: number): string;
+/** One line per running lens of the review in `runDir`, read from its live
+ * log: none when the log is missing or unreadable, which never costs the
+ * review its status line. */
+export declare function liveLensLines(runDir: string, now: number): string[];
+/** The one review a session runs at a time. */
+export declare class ReviewSlot {
+    private current;
+    /** What is being reviewed now; null when nothing is. */
+    get running(): string | null;
+    /** Stop the review in flight; what it was reviewing, or null when none runs. */
+    stop(): string | null;
+    /** Resolves once no review runs. */
+    idle(): Promise<void>;
+    /** Hold `done` as the review in flight until it settles. */
+    hold(label: string, stop: AbortController, done: Promise<void>): void;
+}
+/**
+ * /qcr-review. Starts the review and returns at once (pi's print mode and a
+ * preview wait for it); the review then runs in `slot`, one at a time. Never
+ * throws: every refusal reaches the person.
+ */
+export declare function startReviewCommand(line: string, host: PluginHost, ui: SessionUi, o: {
+    slot: ReviewSlot;
+    deps?: ReviewCommandDeps;
+    settings?: QuickReviewSettings;
+}): Promise<void>;
+/** One /qcr-review, waited for to its end (its result shown, its post asked):
+ * the command's work without the background. */
+export declare function runReviewCommand(line: string, host: PluginHost, ui: SessionUi, deps?: ReviewCommandDeps, settings?: QuickReviewSettings): Promise<void>;
 //# sourceMappingURL=review.d.ts.map