@quickchatai/pi-quickreview 0.0.0-stage → 1.1.0

package/dist/src/promptdoc.js

@@ -0,0 +1,18 @@
+// Maintainer-only text inside prompt files that must never reach a model.
+//
+// Two shapes, both kept in the SOURCE because people and tests read them:
+//   - the leading `> Sandbox file: …` doc header (which file this is, who
+//     loads it, which placeholders it takes) — rendering it sent the
+//     placeholder list a second time, the whole lens plan included;
+//   - the `<!-- RATIFIED … -->` / `<!-- /RATIFIED … -->` fence marker lines,
+//     which tests/invariant-fences.test.ts pins in the source.
+// Every load path that hands a prompt file to a model strips them here.
+const FENCE_MARKER_LINE = /^[ \t]*<!--[ \t]*\/?RATIFIED\b[^\n]*?-->[ \t]*(?:\r?\n|$)/gm;
+// The header blockquote, the blank lines after it, and an optional `---` rule
+// (with its trailing blank lines) that separated it from the body.
+const DOC_HEADER = /(^|\n)> Sandbox file:[^\n]*\n(?:>[^\n]*\n)*(?:[ \t]*\n)*(?:---[ \t]*\n(?:[ \t]*\n)*)?/;
+/** The prompt text a model should read: no doc header, no fence markers. */
+export function stripModelDocs(text) {
+    return text.replace(DOC_HEADER, "$1").replace(FENCE_MARKER_LINE, "");
+}
+//# sourceMappingURL=promptdoc.js.map

package/dist/src/promptdoc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptdoc.js","sourceRoot":"","sources":["../../src/promptdoc.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,EAAE;AACF,0EAA0E;AAC1E,0EAA0E;AAC1E,qEAAqE;AACrE,oEAAoE;AACpE,6EAA6E;AAC7E,+DAA+D;AAC/D,wEAAwE;AAExE,MAAM,iBAAiB,GAAG,6DAA6D,CAAC;AACxF,8EAA8E;AAC9E,mEAAmE;AACnE,MAAM,UAAU,GACd,uFAAuF,CAAC;AAE1F,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;AACvE,CAAC"}

package/dist/src/prtarget.d.ts

@@ -0,0 +1,70 @@
+import { type ExecFn } from "./execfn.js";
+import { type CredentialResolution, type CredentialSource } from "./ghcred.js";
+import { originRepo, type BranchTarget } from "./localreview.js";
+export type PrTargetParse = {
+    ok: true;
+    repo: string;
+    number: number;
+} | {
+    ok: false;
+    error: string;
+};
+/** A PR argument: `12`, `#12` or a github.com pull URL. A PR on a repo other
+ * than the current directory's is refused unless `--repo` names it. */
+export declare function parsePrTarget(arg: string, o: {
+    cwdRepo: string | null;
+    repo?: string;
+}): PrTargetParse;
+export { originRepo };
+export type { CredentialSource };
+export interface PrFetchRequest {
+    repo: string;
+    number: number;
+    /** An empty or absent directory the PR is fetched into. */
+    scratchDir: string;
+    token: string;
+    fetchFn?: typeof fetch;
+    /** Where git fetches from: `<gitBase>/<owner>/<name>.git`. */
+    gitBase?: string;
+    apiBase?: string;
+    /** Stops the fetch: the PR read and the git commands in flight end, and the
+     * result is a refusal. */
+    signal?: AbortSignal;
+    /** Runs git (a test seam). Default: a child process, never blocking the
+     * event loop, so the caller's stop is heard while the fetch runs. */
+    exec?: ExecFn;
+}
+export type PrFetchResult = {
+    ok: true;
+    /** The scratch repository: HEAD is the PR's head, `refs/qcr/base` its base. */
+    gitDir: string;
+    target: BranchTarget;
+    title: string;
+    body: string | null;
+    number: number;
+} | {
+    ok: false;
+    error: string;
+};
+export declare const SCRATCH_BASE_REF = "refs/qcr/base";
+/** Read the PR (title, body, base) and fetch its head and base. Read-only. */
+export declare function fetchPrTarget(req: PrFetchRequest): Promise<PrFetchResult>;
+export interface PrCredentialDeps {
+    env?: Record<string, string | undefined>;
+    mintApp?: (secretsDir: string) => Promise<string>;
+    ghAuthToken?: () => string | null;
+    /** Default: the token handed to this container as a file, if any. */
+    handoff?: string | null;
+}
+/** The local route's credential for `secretsDir`, with the real App, env and
+ * `gh` unless a test says otherwise. */
+export declare function resolvePrCredential(secretsDir: string, o?: PrCredentialDeps): Promise<CredentialResolution>;
+/** The identity a review is posted as: the credential source the repo names
+ * (`post_as` in its review settings), else the one already resolved for
+ * reading the PR. A named source that is not available is an error, never a
+ * silent switch to another identity. */
+export declare function resolvePostCredential(secretsDir: string, postAs: string | null, resolved: {
+    source: CredentialSource;
+    token: string;
+}, o?: PrCredentialDeps): Promise<CredentialResolution>;
+//# sourceMappingURL=prtarget.d.ts.map

package/dist/src/prtarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prtarget.d.ts","sourceRoot":"","sources":["../../src/prtarget.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmC,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,UAAU,EAAiB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhF,MAAM,MAAM,aAAa,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAI5E;uEACuE;AACvE,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,CAAC,EAAE;IAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3C,aAAa,CA0Bf;AAED,OAAO,EAAE,UAAU,EAAE,CAAC;AACtB,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;8BAC0B;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;yEACqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAOD,MAAM,MAAM,aAAa,GACrB;IACE,EAAE,EAAE,IAAI,CAAC;IACT,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,eAAO,MAAM,gBAAgB,kBAAkB,CAAC;AAGhD,8EAA8E;AAC9E,wBAAsB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAqG/E;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,WAAW,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAClC,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;wCACwC;AACxC,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,CAAC,GAAE,gBAAqB,GACvB,OAAO,CAAC,oBAAoB,CAAC,CAQ/B;AAED;;;wCAGwC;AACxC,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,QAAQ,EAAE;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EACrD,CAAC,GAAE,gBAAqB,GACvB,OAAO,CAAC,oBAAoB,CAAC,CAoB/B"}

package/dist/src/prtarget.js

@@ -0,0 +1,181 @@
+// `qcr review <number|URL>`: which PR, and its head and base fetched into a
+// scratch repository for a read-only review. The credential comes from the
+// local route's chain (packages/pi-plugin/src/ghcred.ts); it is handed to git through the
+// environment, never written into a config file or a URL.
+import { mkdirSync } from "node:fs";
+import { ExecError, nodeExec, runOrThrow } from "./execfn.js";
+import { CREDENTIAL_SOURCES, resolveGithubCredential, ghAuthTokenFromCli, handedToken, } from "./ghcred.js";
+import { TokenMinter } from "./githubAuth.js";
+import { originRepo, resolveBranch } from "./localreview.js";
+const REPO_RE = /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/;
+/** A PR argument: `12`, `#12` or a github.com pull URL. A PR on a repo other
+ * than the current directory's is refused unless `--repo` names it. */
+export function parsePrTarget(arg, o) {
+    if (o.repo !== undefined && !REPO_RE.test(o.repo))
+        return { ok: false, error: `--repo ${o.repo}: expected owner/name` };
+    const num = arg.match(/^#?(\d+)$/);
+    if (num) {
+        const repo = o.repo ?? o.cwdRepo;
+        if (!repo)
+            return {
+                ok: false,
+                error: `PR ${arg}: this directory has no GitHub remote — pass --repo owner/name`,
+            };
+        return { ok: true, repo, number: Number(num[1]) };
+    }
+    const url = arg.match(/^https:\/\/github\.com\/([^/\s]+\/[^/\s]+)\/pull\/(\d+)(?:[/?#].*)?$/);
+    if (!url)
+        return { ok: false, error: `${arg}: not a PR number or a github.com pull request URL` };
+    const repo = url[1];
+    if (o.repo !== undefined && o.repo.toLowerCase() !== repo.toLowerCase())
+        return { ok: false, error: `${arg} is on ${repo} but --repo says ${o.repo}` };
+    if (o.repo === undefined && (o.cwdRepo ?? "").toLowerCase() !== repo.toLowerCase())
+        return {
+            ok: false,
+            error: `${arg} is on ${repo}, not this directory's repository` +
+                `${o.cwdRepo ? ` (${o.cwdRepo})` : ""} — pass --repo ${repo} to review it anyway`,
+        };
+    return { ok: true, repo, number: Number(url[2]) };
+}
+export { originRepo };
+/** How long the network fetch of a PR's head and base may take. */
+const FETCH_TIMEOUT_MS = 30 * 60_000;
+/** How long a local git step of the fetch may take. */
+const LOCAL_GIT_TIMEOUT_MS = 2 * 60_000;
+export const SCRATCH_BASE_REF = "refs/qcr/base";
+const HEAD_REF = "refs/qcr/head";
+/** Read the PR (title, body, base) and fetch its head and base. Read-only. */
+export async function fetchPrTarget(req) {
+    const label = `${req.repo}#${req.number}`;
+    const fetchFn = req.fetchFn ?? fetch;
+    const apiBase = req.apiBase ?? "https://api.github.com";
+    let pr;
+    try {
+        const res = await fetchFn(`${apiBase}/repos/${req.repo}/pulls/${req.number}`, {
+            signal: req.signal
+                ? AbortSignal.any([req.signal, AbortSignal.timeout(60_000)])
+                : AbortSignal.timeout(60_000),
+            headers: {
+                authorization: `Bearer ${req.token}`,
+                accept: "application/vnd.github+json",
+                "x-github-api-version": "2022-11-28",
+            },
+        });
+        if (res.status === 401 || res.status === 403)
+            return {
+                ok: false,
+                error: `GitHub rejected the credential reading ${label} (${res.status}): check it can read ${req.repo}, or run \`gh auth login\``,
+            };
+        if (res.status === 404)
+            return {
+                ok: false,
+                error: `${label} was not found — wrong number or repo, or the credential cannot see ${req.repo}`,
+            };
+        if (!res.ok)
+            return { ok: false, error: `GitHub answered ${res.status} for ${label}` };
+        pr = (await res.json());
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: `could not read ${label} from GitHub: ${String(err).slice(0, 200)}`,
+        };
+    }
+    const baseRef = pr.base?.ref;
+    if (!baseRef || !pr.head?.sha)
+        return { ok: false, error: `${label}: GitHub's answer had no head or base` };
+    mkdirSync(req.scratchDir, { recursive: true });
+    const header = `Authorization: Basic ${Buffer.from(`x-access-token:${req.token}`).toString("base64")}`;
+    const exec = req.exec ?? nodeExec;
+    const run = async (args, timeoutMs, auth = false) => {
+        await runOrThrow(exec, "git", args, {
+            cwd: req.scratchDir,
+            env: {
+                ...process.env,
+                GIT_TERMINAL_PROMPT: "0",
+                ...(auth
+                    ? {
+                        GIT_CONFIG_COUNT: "1",
+                        GIT_CONFIG_KEY_0: "http.extraheader",
+                        GIT_CONFIG_VALUE_0: header,
+                    }
+                    : {}),
+            },
+            timeoutMs,
+            ...(req.signal ? { signal: req.signal } : {}),
+        });
+    };
+    try {
+        await run(["init", "-q"], LOCAL_GIT_TIMEOUT_MS);
+        await run([
+            "fetch",
+            "-q",
+            "--no-tags",
+            `${req.gitBase ?? "https://github.com"}/${req.repo}.git`,
+            `+refs/pull/${req.number}/head:${HEAD_REF}`,
+            `+refs/heads/${baseRef}:${SCRATCH_BASE_REF}`,
+        ], FETCH_TIMEOUT_MS, true);
+        await run(["update-ref", "--no-deref", "HEAD", HEAD_REF], LOCAL_GIT_TIMEOUT_MS);
+    }
+    catch (err) {
+        if (req.signal?.aborted)
+            return { ok: false, error: `the fetch of ${label} was stopped` };
+        // a killed git (its time ran out) exits with no code of its own
+        const words = err instanceof ExecError
+            ? err.result.code === -1
+                ? "git took too long and was stopped"
+                : err.result.stderr.trim() || err.message
+            : String(err);
+        const msg = words.replaceAll(req.token, "***").slice(0, 300);
+        return { ok: false, error: `git could not fetch ${label}: ${msg}` };
+    }
+    const resolved = resolveBranch(req.scratchDir, SCRATCH_BASE_REF);
+    if (!resolved.ok)
+        return { ok: false, error: `${label}: ${resolved.error}` };
+    return {
+        ok: true,
+        gitDir: req.scratchDir,
+        target: { ...resolved.target, repo: req.repo, branch: `PR #${req.number}`, base: baseRef },
+        title: pr.title ?? `PR #${req.number}`,
+        body: pr.body ?? null,
+        number: req.number,
+    };
+}
+/** The local route's credential for `secretsDir`, with the real App, env and
+ * `gh` unless a test says otherwise. */
+export function resolvePrCredential(secretsDir, o = {}) {
+    return resolveGithubCredential({
+        secretsDir,
+        env: o.env ?? process.env,
+        mintApp: o.mintApp ?? ((dir) => new TokenMinter(dir).installationToken()),
+        ghAuthToken: o.ghAuthToken ?? ghAuthTokenFromCli,
+        handoff: o.handoff === undefined ? handedToken() : o.handoff,
+    });
+}
+/** The identity a review is posted as: the credential source the repo names
+ * (`post_as` in its review settings), else the one already resolved for
+ * reading the PR. A named source that is not available is an error, never a
+ * silent switch to another identity. */
+export async function resolvePostCredential(secretsDir, postAs, resolved, o = {}) {
+    if (postAs === null)
+        return { ok: true, ...resolved };
+    const known = CREDENTIAL_SOURCES;
+    if (!known.includes(postAs)) {
+        return {
+            ok: false,
+            error: `post_as is ${postAs} but that credential is not available (expected one of ${known.join(", ")})`,
+        };
+    }
+    const env = o.env ?? process.env;
+    const r = await resolveGithubCredential({
+        secretsDir: postAs === "app" ? secretsDir : "",
+        env: postAs.startsWith("env:") ? { [postAs.slice(4)]: env[postAs.slice(4)] } : {},
+        mintApp: o.mintApp ?? ((dir) => new TokenMinter(dir).installationToken()),
+        ghAuthToken: postAs === "gh" ? (o.ghAuthToken ?? ghAuthTokenFromCli) : () => null,
+        handoff: postAs === "handoff" ? (o.handoff === undefined ? handedToken() : o.handoff) : null,
+    });
+    return r.ok
+        ? r
+        : { ok: false, error: `post_as is ${postAs} but that credential is not available: ${r.error}` };
+}
+//# sourceMappingURL=prtarget.js.map

package/dist/src/prtarget.js.map

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

package/dist/src/recheckorder.d.ts

@@ -0,0 +1,32 @@
+/** What woke the recheck. `author_reply` is listed because it is a decided
+ * trigger — its handling is "hand it to ping-pong and do nothing else". */
+export type RecheckTrigger = "push" | "ci" | "base_advance" | "author_reply";
+/** Why a file was judged not worth re-reviewing. */
+export type TrivialReason = "base-merge" | "migration-renumber" | "pure-rename" | "version-bump" | "formatting" | "no-content-change";
+export interface FileClass {
+    filename: string;
+    class: "trivial" | "significant";
+    /** The trivial rule that fired, or "content" for a real change. */
+    reason: TrivialReason | "content";
+}
+/** The recheck's own order kind — deliberately NOT a RoundOrder: no round is
+ * started, no pass plan exists, and the session is asked one question. */
+export interface RecheckOrder {
+    pr: number;
+    title: string;
+    trigger: RecheckTrigger;
+    /** Always APPROVE — the only standing verdict this path can act on. */
+    standing_verdict: "APPROVE";
+    last_reviewed_sha: string;
+    head_sha: string;
+    worktree: string;
+    evidence: string;
+    files: FileClass[];
+    /** Files hand-resolved inside merge commits of this delta — the session
+     * must audit each against BOTH merge parents. */
+    resolved_files: string[];
+    /** Relative name of the decision file the session must write. */
+    decision_file: string;
+    issued_at: string;
+}
+//# sourceMappingURL=recheckorder.d.ts.map

package/dist/src/recheckorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recheckorder.d.ts","sourceRoot":"","sources":["../../src/recheckorder.ts"],"names":[],"mappings":"AAIA;2EAC2E;AAC3E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,IAAI,GAAG,cAAc,GAAG,cAAc,CAAC;AAE7E,oDAAoD;AACpD,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,oBAAoB,GACpB,aAAa,GACb,cAAc,GACd,YAAY,GACZ,mBAAmB,CAAC;AAExB,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,GAAG,aAAa,CAAC;IACjC,mEAAmE;IACnE,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;CACnC;AAED;0EAC0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,cAAc,CAAC;IACxB,uEAAuE;IACvE,gBAAgB,EAAE,SAAS,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB;qDACiD;IACjD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/src/recheckorder.js

@@ -0,0 +1,5 @@
+// The post-approval recheck's order: what woke it, the delta's file
+// classes and the one question handed to the session. The core renders it
+// (packages/pi-plugin/src/templates.ts); src/recheck.ts builds it and re-exports these.
+export {};
+//# sourceMappingURL=recheckorder.js.map

package/dist/src/recheckorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recheckorder.js","sourceRoot":"","sources":["../../src/recheckorder.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,0EAA0E;AAC1E,wFAAwF"}

package/dist/src/reviewapi.d.ts

@@ -0,0 +1,207 @@
+import type { CoreConfig } from "./reviewconfig.js";
+import type { Ecosystem } from "./ecosystem.js";
+import { type ReviewMemoryPort } from "./memoryport.js";
+import type { ProfilePlace } from "./profilelookup.js";
+import type { ProfileLookup } from "./profiles.js";
+import { type PrCredentialDeps, type PrFetchRequest } from "./prtarget.js";
+import { type Destination, type DestinationChoice } from "./reviewdest.js";
+import { type OneShotResult } from "./oneshot.js";
+import type { RoundSpec } from "./engine/round.js";
+import type { Runtime } from "./engine/port.js";
+/** What is reviewed. */
+export type ReviewTarget = 
+/** The repo dir's current branch against its base (`base`, else origin's
+ * default branch, main, master). */
+{
+    kind: "branch";
+    base?: string;
+}
+/** The uncommitted working tree (staged, unstaged and new files) against
+ * HEAD. Never posted anywhere. */
+ | {
+    kind: "uncommitted";
+}
+/** A pull request: `12`, `#12` or a github.com pull URL. A PR on another
+ * repo than the repo dir's needs `repo` (owner/name). */
+ | {
+    kind: "pr";
+    pr: string | number;
+    repo?: string;
+}
+/** A unified diff: its text, or a reader the run calls when it gets there
+ * (a reader's Error message is the refusal, word for word). `name` says
+ * where it came from: a file name, or "-" (or nothing) for a piped diff.
+ * The repo dir is optional and only read; a diff is never posted. */
+ | {
+    kind: "diff";
+    diff: string | (() => Promise<string>);
+    name?: string;
+};
+/** Who is asking. "laptop" previews the estimate, asks above the limit and
+ * stops hard at twice the estimate. "action" never asks and has no cap of its
+ * own: only a given limit stops the run. */
+export type ReviewRoute = "laptop" | "action";
+/** What the host's isolation of one run is given: core's is
+ * packages/pi-plugin/src/reviewhost.ts `prepareReviewHost`, which a host calls with its own words
+ * for a refused login (`qcr review`'s: src/hostroute.ts `prepareHostRun`). */
+export interface ReviewHostRequest {
+    root: string;
+    /** The operator's pi agent dir (its login). Read, never written. */
+    srcAgentDir: string;
+    /** Where the run's private agent dir goes: `<runDir>/agent`. */
+    agentDir: string;
+    /** The run's out dir: pi's cwd. */
+    cwd: string;
+    cfg: CoreConfig;
+    /** The review's time budget: a login that expires inside it is refused
+     * with `AuthExpiring` (packages/pi-plugin/src/engine/auth.ts). */
+    needMs: number;
+    /** Checkouts the cwd must stay out of: the asset tree, the reviewed repo. */
+    checkouts: readonly string[];
+    /** A profile's replacements for the lens agents. */
+    profile: {
+        readFile?: (path: string) => string;
+        lookup: ProfileLookup;
+    };
+}
+/** The isolated run the host prepared. */
+export interface ReviewHostRun {
+    /** pi's agent dir for the run. It goes with the run. */
+    agentDir: string;
+    /** Where pi runs. */
+    cwd: string;
+    /** Context files above `cwd` that pi would load too. */
+    strayContext: string[];
+}
+export interface ReviewLimits {
+    route?: ReviewRoute;
+    /** The limit for this run, over the repo's own (`auto_limit_usd`); on the
+     * "action" route it is the hard stop. */
+    limitUsd?: number;
+    /** Start over the limit without asking, quoting the key a preview showed. */
+    key?: string;
+    /** The round's wall clock. */
+    timeoutMs: number;
+}
+/** A runtime for one run. `dispose`, when it has one, is called when the run
+ * ends (packages/pi-plugin/src/engine/reviewsdk.ts disposes the hosts it built). */
+export type ReviewRuntime = Runtime & {
+    dispose?: () => Promise<void> | void;
+};
+/** What a run's runtime is built for. */
+export interface ReviewRuntimeRequest {
+    /** The run's own directory. */
+    runDir: string;
+}
+export interface ReviewOptions {
+    /** The repository (or a directory in it) the review stands in. A diff
+     * needs none there: it is then only read for context. */
+    repoDir: string;
+    /** The asset tree: prompts/, extensions/, agents/ (packages/pi-plugin/src/assetroot.ts). */
+    root: string;
+    /** The operator's pi agent dir (its login): only read. */
+    agentDir: string;
+    /** Where each run keeps its throwaway tree and its files. */
+    runsDir: string;
+    /** Where a dry-run install records the review it would have posted. */
+    dryrunDir: string;
+    /** The review home: each repo's delta history and saved destination
+     * (packages/pi-plugin/src/reviewstore.ts). Null: nothing is remembered, so every run is a full
+     * review and no destination is saved. */
+    storeDir: string | null;
+    config: CoreConfig;
+    ecosystem: Ecosystem;
+    /** Where profiles are looked up before the asset tree's examples. */
+    profileHomes?: readonly ProfilePlace[];
+    /** Builds the runtime that hosts one run's review session. Called once per
+     * run, when the round is about to start (a preview, a refusal or an
+     * unchanged head builds none), and the runtime is disposed when the run
+     * ends. A runtime carries the run's lens board and lens runner, so it hosts
+     * one run at a time: a runtime still hosting another run is refused. */
+    runtime: (run: ReviewRuntimeRequest) => ReviewRuntime;
+    /** Isolates the run from the operator's pi home and every checkout.
+     * Absent: core's isolation (packages/pi-plugin/src/reviewhost.ts) with the engine's words for
+     * a refused login. */
+    prepareHost?: (req: ReviewHostRequest) => ReviewHostRun;
+    /** Runs the round inside interactive pi instead of on `runtime` (a debug
+     * round: no live log, no cap, nothing posted, no destination asked). */
+    debugRound?: (spec: RoundSpec) => Promise<OneShotResult>;
+    /** The install's memory. Absent or null: the review runs without memory
+     * and says so once. */
+    memory?: ReviewMemoryPort | null;
+    /** Where the result goes, for this run. Absent or empty: the repo's saved
+     * default, else the person is asked (`io.choose`), else the fallback. */
+    destinations?: readonly Destination[];
+    /** Write the markdown report to this file (implies "file"); a relative path
+     * is the repo dir's. */
+    reportFile?: string;
+    /** Review the whole target again, ignoring what an earlier review left. */
+    full?: boolean;
+    limits: ReviewLimits;
+    /** The GitHub credential sources and where GitHub is (a test seam). */
+    github?: PrCredentialDeps & Pick<PrFetchRequest, "fetchFn" | "gitBase" | "apiBase">;
+}
+/** What a prompt port is given beside its question: the run's stop, which
+ * closes the question unanswered. */
+export interface AskOptions {
+    signal?: AbortSignal;
+}
+/** The round that is about to start, for a UI to show while it runs. */
+export interface ReviewStarted {
+    /** The run's directory: the round's live log is under it (src/live/). */
+    runDir: string;
+    /** Where the round writes its files. */
+    outDir: string;
+    /** The round's session name (the live log's key). */
+    sessionName: string;
+    lenses: readonly string[];
+    estimateUsd: number;
+    /** The hard stop in dollars; null: none. */
+    capUsd: number | null;
+}
+/** The ports: everything that reaches a person. */
+export interface ReviewIo {
+    /** Ask a yes/no question. Null or absent: nobody to ask. A stop closes the
+     * question: the run ends stopped, whatever the port answers. */
+    confirm?: ((question: string, o?: AskOptions) => Promise<boolean>) | null;
+    /** Ask the person to pick one option. Absent: not interactive, so the
+     * destination question is never asked. A stop closes it, as for `confirm`. */
+    choose?: (question: string, options: DestinationChoice[], o?: AskOptions) => Promise<Destination>;
+    /** The run's own progress lines for a person (the preview before the run,
+     * the memory notice). */
+    progress?: (line: string) => void;
+    /** The round is about to start: where it runs and what it plans. */
+    started?: (run: ReviewStarted) => void;
+    /** A warning said before the run. */
+    warn?: (line: string) => void;
+    /** The round's diagnostics. */
+    log?: (line: string) => void;
+    /** Stops the review: it returns a stopped result and cleans up after itself. */
+    signal?: AbortSignal;
+}
+/** The versioned JSON object (`qcr review --json`, schemas/review-result.v1.json). */
+export type ReviewData = Record<string, unknown> & {
+    schema_version: number;
+    ok: boolean;
+};
+export interface ReviewResult {
+    /** The versioned JSON object, `schema_version` first. */
+    data: ReviewData;
+    /** The rendered review; null when the run made none (a refusal, a preview,
+     * a review that did not finish). */
+    markdown: string | null;
+    /** What a terminal shows a person. */
+    text: string;
+    /** 0 done; 1 refused, declined, failed, stopped or partial; 2 usage. */
+    exitCode: 0 | 1 | 2;
+    /** Where the result goes, as settled; null when the run ended before that
+     * (the caller's own fallback applies). */
+    destinations: readonly Destination[] | null;
+}
+/** Run the review of `target`: the plan, the price, the round, the record and,
+ * when asked, the post. Never throws for a refusal; the result says it. */
+export declare function review(target: ReviewTarget, opts: ReviewOptions, io?: ReviewIo): Promise<ReviewResult>;
+/** The plan, the price and the key `review` would run under; starts nothing,
+ * asks nothing and saves no destination. */
+export declare function preview(target: ReviewTarget, opts: ReviewOptions, io?: ReviewIo): Promise<ReviewResult>;
+//# sourceMappingURL=reviewapi.d.ts.map

package/dist/src/reviewapi.d.ts.map

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