@quickchatai/pi-quickreview 0.0.0-stage → 1.1.0

package/dist/src/plugin/review.js

@@ -0,0 +1,298 @@
+// /review inside a user's pi: the production review (the core's `review()`,
+// the same pipeline `qcr review` runs) hosted in this pi process.
+//
+// - The repo is pi's cwd. The config is the person's qcr config when one is
+//   there (`$QCR_CONFIG`, or the install's config home), else the shipped
+//   defaults; it is only read.
+// - The login is the host pi's, borrowed (login.ts): the host refreshes a
+//   short one first, and the run reads a refresh-disabled copy.
+// - The run's sessions are nested SDK sessions in this process, isolated
+//   from the person's own pi setup (their extensions, skills and settings
+//   never reach a reviewer session), and the person's own session gets no
+//   tool from the review: the lens tools exist only inside the engine's
+//   sessions. Nothing here owns the process: a wedged turn ends its own
+//   sessions, never pi.
+// - Esc (or the session ending) stops the run.
+// - Where the result goes follows the destination rule (reviewdest.ts): flags,
+//   else the repo's saved default, else asked each time, else printed. A post
+//   goes through the one MutationGate with the install's dry_run; nothing
+//   here sets it.
+// - The result's JSON is kept in the run's directory under the qcr state
+//   home, as `qcr review` keeps its runs.
+import { execFileSync } from "node:child_process";
+import { appendFileSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { assetRoot } from "../assetroot.js";
+import { PI_REFRESH_MARGIN_MS } from "../engine/auth.js";
+import { contextFrom } from "../engine/context.js";
+import { lazyReviewRuntime } from "../engine/reviewruntime.js";
+import { homeProfilePlaces, loadOneShotConfig, stateHome } from "../homes.js";
+import { preview as corePreview, review as coreReview, } from "../reviewapi.js";
+import { loadDefaultDestinationsIn, planDestinations, saveDefaultDestinationsIn, } from "../reviewdest.js";
+import { prepareReviewHost } from "../reviewhost.js";
+import { parseReviewCommand } from "./args.js";
+import { borrowLogin, reviewProviders } from "./login.js";
+/** The custom message type the review is shown as. */
+export const REVIEW_MESSAGE = "qcr-review";
+/** A review's wall clock, as `qcr review`'s. */
+export const REVIEW_TIMEOUT_MS = 60 * 60_000;
+/** What a refused login says inside pi: pi's own /login is the fix. */
+export const PLUGIN_AUTH_WORDS = {
+    missing: (src) => `no pi login at ${src}: run /login in pi, then /review again`,
+    expiring: ({ provider, expiresAt, needMs }) => `your ${provider ?? "pi"} login expires at ${new Date(expiresAt).toISOString()}, inside this review's ${Math.round(needMs / 60_000)}-minute window, and pi did not renew it. Run /login${provider ? ` ${provider}` : ""} in pi, then /review again.`,
+};
+/** How long a stopped review (Esc, the session ending) gets to wind down
+ * before /review gives up waiting on it and returns. */
+export const STOP_GRACE_MS = 30_000;
+export const REVIEW_DEPS = {
+    review: coreReview,
+    preview: corePreview,
+    root: assetRoot,
+    runtime: lazyReviewRuntime,
+};
+const fence = (lang, text) => `\`\`\`${lang}\n${text.trimEnd()}\n\`\`\``;
+/** One run of /review. Never throws: every refusal reaches the person. */
+export async function runReviewCommand(line, host, ui, deps = REVIEW_DEPS) {
+    const fail = (message) => {
+        if (ui.mode === "print")
+            ui.print(`✗ ${message}`);
+        ui.notify(message, "error");
+    };
+    const cmd = parseReviewCommand(line);
+    if ("error" in cmd)
+        return fail(cmd.error);
+    const env = { ...host.env, HOME: host.home };
+    const warn = (l) => ui.notify(l, "warning");
+    let root;
+    let cfg;
+    let ecosystem;
+    let configPath;
+    const profileHomes = homeProfilePlaces(env);
+    try {
+        root = deps.root();
+        const loaded = loadOneShotConfig({ root, env, warn });
+        configPath = loaded.path;
+        ({ cfg, ecosystem } = contextFrom(root, loaded, cmd.profile ?? loaded.cfg.review.profile, "", { homes: profileHomes }, warn));
+    }
+    catch (err) {
+        return fail(err instanceof Error ? err.message : String(err));
+    }
+    const state = stateHome(env);
+    const storeDir = join(state, "review");
+    const target = cmd.target;
+    let destinations = [];
+    // Posting goes through the one gate with the install's dry_run: a config
+    // that keeps dry_run on (the shipped defaults do) would record the post and
+    // send nothing, so posting is neither offered nor accepted, and that is said
+    // before the review is paid for.
+    const postBlocked = cfg.dry_run &&
+        (configPath === null
+            ? "posting needs a qcr config with dry_run = false, and there is none: the shipped defaults keep dry_run on"
+            : `posting needs dry_run = false, and ${configPath} keeps dry_run on`);
+    if (!cmd.preview && target.kind !== "diff" && target.kind !== "pr" && !isGitWorkTree(host.cwd))
+        return fail(`${host.cwd} is not inside a git repository: /review reviews a git checkout`);
+    if (!cmd.preview) {
+        // The borrowed login first: refreshed by the host when short, refused
+        // with a hint when pi has none for a provider the review runs on, before
+        // the person is asked anything.
+        const borrowed = await borrowLogin({
+            providers: reviewProviders(cfg),
+            host: host.auth,
+            needMs: REVIEW_TIMEOUT_MS,
+            marginMs: PI_REFRESH_MARGIN_MS,
+        });
+        if (!borrowed.ok)
+            return fail(borrowed.error);
+        if (postBlocked && cmd.to.includes("pr"))
+            return fail(`${postBlocked}; the review was not started.`);
+        const plan = planDestinations({
+            explicit: cmd.to,
+            json: cmd.json,
+            interactive: ui.interactive,
+            saved: loadDefaultDestinationsIn(storeDir, host.cwd),
+            target: { pr: target.kind === "pr" && !postBlocked },
+            surface: "session",
+        });
+        if (plan.kind === "ask" && target.kind === "pr" && postBlocked)
+            ui.notify(`${postBlocked}: the review is not offered for posting.`, "info");
+        if (plan.kind === "fixed")
+            destinations = plan.destinations;
+        else {
+            const labels = plan.menu.map((m) => m.label);
+            const picked = await ui.select("Where should the review go?", labels, host.shutdown);
+            const item = plan.menu.find((m) => m.label === picked);
+            if (item === undefined)
+                return ui.notify("review cancelled", "info");
+            destinations = item.pick.destinations;
+            if (item.pick.remember) {
+                const kept = saveDefaultDestinationsIn(storeDir, host.cwd, destinations);
+                ui.notify(kept
+                    ? "kept as this repo's default: pass --to to choose otherwise"
+                    : `this choice could not be kept as a default: ${host.cwd} is not in a git repo`, kept ? "info" : "warning");
+            }
+        }
+    }
+    // A turn that ignores its abort and dispose cannot be killed here: the
+    // process is the person's pi. The budget's last resort (and a stop that does
+    // not end the run within its grace) abandons the run instead, so /review
+    // returns and pi keeps running.
+    let abandon = () => { };
+    const abandoned = new Promise((_, reject) => {
+        abandon = (why) => reject(new Error(why));
+    });
+    abandoned.catch(() => undefined);
+    let graceTimer;
+    const stop = new AbortController();
+    stop.signal.addEventListener("abort", () => {
+        graceTimer = setTimeout(() => abandon("the review did not stop in time: it was abandoned, and pi keeps running"), STOP_GRACE_MS);
+        graceTimer.unref?.();
+    }, { once: true });
+    const onShutdown = () => stop.abort();
+    host.shutdown.addEventListener("abort", onShutdown, { once: true });
+    const offEscape = ui.onEscape(() => {
+        if (!stop.signal.aborted)
+            ui.notify("stopping the review…", "warning");
+        stop.abort();
+    });
+    let runDir = null;
+    const logFile = join(storeDir, "plugin.log");
+    const log = (l) => {
+        try {
+            mkdirSync(storeDir, { recursive: true });
+            appendFileSync(logFile, `${new Date().toISOString()} ${l}\n`);
+        }
+        catch {
+            // a diagnostics line that cannot be kept never costs the review
+        }
+    };
+    const opts = {
+        repoDir: host.cwd,
+        root,
+        agentDir: host.agentDir,
+        runsDir: join(storeDir, "runs"),
+        dryrunDir: join(storeDir, "dryrun"),
+        storeDir,
+        config: cfg,
+        ecosystem,
+        profileHomes,
+        runtime: (req) => {
+            runDir = req.runDir;
+            return deps.runtime(cfg, {
+                hostPi: true,
+                // The host pi renewed the login for this run's whole window just now.
+                authMarginMs: 0,
+                warn: log,
+                homeDir: host.home,
+                fenceDirs: [host.agentDir],
+                backstop: (reason) => {
+                    stop.abort();
+                    abandon(`a review session did not stop at its ${reason === "cap" ? "dollar cap" : "time limit"}: the review was abandoned, and pi keeps running`);
+                },
+            });
+        },
+        // Only the review's providers ride into the run, as borrowLogin renewed
+        // them: a person's pi holds other logins, which neither go along nor
+        // refuse the run.
+        prepareHost: (req) => prepareReviewHost({
+            ...req,
+            profile: req.profile,
+            authWords: PLUGIN_AUTH_WORDS,
+            authProviders: reviewProviders(cfg),
+        }),
+        memory: null,
+        destinations,
+        full: cmd.full,
+        limits: {
+            route: "laptop",
+            ...(cmd.limitUsd !== undefined ? { limitUsd: cmd.limitUsd } : {}),
+            timeoutMs: REVIEW_TIMEOUT_MS,
+        },
+    };
+    const io = {
+        confirm: ui.interactive ? (q, o) => ui.confirm("QuickReview", q, o?.signal) : null,
+        progress: (l) => ui.notify(l, "info"),
+        started: (s) => ui.status(`QuickReview: ${s.lenses.length} lenses, about $${s.estimateUsd.toFixed(2)}` +
+            `${s.capUsd !== null ? `, stops at $${s.capUsd.toFixed(2)}` : ""}` +
+            `${ui.mode === "tui" ? " — Esc stops it" : ""}`),
+        warn,
+        log,
+        signal: stop.signal,
+    };
+    ui.status(cmd.preview ? "QuickReview: pricing…" : "QuickReview: preparing…");
+    let result;
+    try {
+        result = await Promise.race([
+            cmd.preview ? deps.preview(target, opts, io) : deps.review(target, opts, io),
+            abandoned,
+        ]);
+    }
+    catch (err) {
+        return fail(err instanceof Error ? err.message : String(err));
+    }
+    finally {
+        clearTimeout(graceTimer);
+        offEscape();
+        host.shutdown.removeEventListener("abort", onShutdown);
+        ui.status(undefined);
+    }
+    deliver(result, { cmd, destinations, runDir, ui });
+}
+/** Is `dir` inside a git work tree? */
+function isGitWorkTree(dir) {
+    try {
+        return (execFileSync("git", ["rev-parse", "--is-inside-work-tree"], {
+            cwd: dir,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim() === "true");
+    }
+    catch {
+        return false;
+    }
+}
+/** Put a finished run where it goes. */
+function deliver(r, o) {
+    const { ui } = o;
+    const json = JSON.stringify(r.data, null, 2);
+    const saved = [];
+    // The run's JSON beside its other files, under the state home.
+    if (o.runDir !== null) {
+        try {
+            writeFileSync(join(o.runDir, "review.json"), json + "\n");
+            saved.push(join(o.runDir, "review.json"));
+        }
+        catch {
+            // the run left no directory (a refusal): nothing to keep
+        }
+    }
+    const report = typeof r.data["report"] === "string" ? r.data["report"] : null;
+    if (report !== null) {
+        const beside = join(dirname(report), "review.json");
+        if (!saved.includes(beside)) {
+            try {
+                writeFileSync(beside, json + "\n");
+                saved.push(beside);
+            }
+            catch {
+                // the report's own line says where it is
+            }
+        }
+        saved.unshift(report);
+    }
+    const human = r.markdown ?? fence("text", r.text);
+    if (ui.mode === "print") {
+        ui.print(o.cmd.json || o.destinations.includes("json") ? JSON.stringify(r.data) : human);
+        return;
+    }
+    const dests = new Set(o.destinations);
+    const savedNote = saved.length > 0 ? `\n\nSaved: ${saved.map((p) => `\`${p}\``).join(", ")}` : "";
+    if (dests.has("json"))
+        ui.show(fence("json", json), r.data);
+    if (o.cmd.preview || dests.has("terminal") || (!dests.has("json") && r.markdown === null))
+        ui.show(human + savedNote, r.data);
+    else if (dests.has("file"))
+        ui.notify(`review saved: ${saved.join(", ")}`, "info");
+    if (r.exitCode !== 0)
+        ui.notify(r.text.split("\n")[0] ?? "the review did not finish", "error");
+}
+//# sourceMappingURL=review.js.map

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

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

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

@@ -0,0 +1,6 @@
+import type { Runner } from "./session.js";
+/** The first executable `cmd` on `path` (a PATH value); null when none. */
+export declare function whichOn(cmd: string, path: string | undefined): string | null;
+/** A Runner over node's child_process, looking programs up on `env.PATH`. */
+export declare function nodeRunner(env: Readonly<Record<string, string | undefined>>): Runner;
+//# sourceMappingURL=runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/plugin/runner.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAa,MAAM,cAAc,CAAC;AAEtD,2EAA2E;AAC3E,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAQ5E;AAYD,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,MAAM,CA8BpF"}

package/dist/src/plugin/runner.js

@@ -0,0 +1,65 @@
+// The plugin's way to run a program: a PATH lookup over the env it is given,
+// and a child that the command's stop kills. Output is collected whole; the
+// programs it runs (qcr, git, gh, npm) answer in one object or a few lines.
+import { spawn } from "node:child_process";
+import { accessSync, constants, statSync } from "node:fs";
+import { delimiter, isAbsolute, join } from "node:path";
+/** The first executable `cmd` on `path` (a PATH value); null when none. */
+export function whichOn(cmd, path) {
+    if (isAbsolute(cmd))
+        return executable(cmd) ? cmd : null;
+    for (const dir of (path ?? "").split(delimiter)) {
+        if (dir === "")
+            continue;
+        const file = join(dir, cmd);
+        if (executable(file))
+            return file;
+    }
+    return null;
+}
+function executable(file) {
+    try {
+        if (!statSync(file).isFile())
+            return false;
+        accessSync(file, constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** A Runner over node's child_process, looking programs up on `env.PATH`. */
+export function nodeRunner(env) {
+    return {
+        which: (cmd) => whichOn(cmd, env["PATH"]),
+        run: (cmd, args, o) => new Promise((done) => {
+            let stdout = "";
+            let stderr = "";
+            let settled = false;
+            const finish = (r) => {
+                if (settled)
+                    return;
+                settled = true;
+                o.signal?.removeEventListener("abort", kill);
+                done(r);
+            };
+            const child = spawn(cmd, [...args], {
+                cwd: o.cwd,
+                env: { ...(o.env ?? env) },
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+            const kill = () => {
+                child.kill("SIGTERM");
+            };
+            if (o.signal?.aborted)
+                kill();
+            else
+                o.signal?.addEventListener("abort", kill, { once: true });
+            child.stdout.on("data", (d) => (stdout += d.toString()));
+            child.stderr.on("data", (d) => (stderr += d.toString()));
+            child.on("error", (err) => finish({ code: 127, stdout, stderr: stderr + String(err) }));
+            child.on("close", (code) => finish({ code: code ?? 1, stdout, stderr }));
+        }),
+    };
+}
+//# sourceMappingURL=runner.js.map

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

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

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

@@ -0,0 +1,79 @@
+import type { PluginHost, SessionUi } from "./session.js";
+/** The npm package that carries the `qcr` CLI. */
+export declare const QCR_PACKAGE = "@quickchatai/quickreview";
+/** The `qcr scan` subcommands passed through as typed. */
+export declare const SCAN_SUBCOMMANDS: readonly ["preview", "start", "status", "stop", "findings", "matches", "match", "suggestions", "stage2", "dismiss", "units", "login", "doctor", "rebuild"];
+/** Subcommands that need a terminal of their own: `login` drives pi's
+ * interactive /login, `rebuild` a long docker build. /scan names the shell
+ * command instead of running them with no terminal. */
+export declare const TERMINAL_SUBCOMMANDS: readonly string[];
+export declare const SCAN_COMMAND_USAGE = "usage: /scan [--sandbox docker] [--delta] [--sha REF] | /scan <qcr scan subcommand> \u2026";
+export declare const NO_QCR: string;
+/** A scan finding as `qcr scan findings --json` lists it (the fields used here). */
+export interface ScanFinding {
+    fingerprint: string;
+    file: string | null;
+    range?: {
+        start: number | null;
+        end: number | null;
+    } | null;
+    lens?: string;
+    severity?: string | null;
+    claim?: string;
+    [k: string]: unknown;
+}
+/** The guided run's options. */
+export interface ScanOptions {
+    sandbox?: string;
+    delta: boolean;
+    sha?: string;
+}
+/** `/scan`'s arguments: the guided run's flags, or a subcommand to pass on. */
+export declare function parseScanCommand(line: string): {
+    kind: "guided";
+    o: ScanOptions;
+} | {
+    kind: "pass";
+    argv: string[];
+} | {
+    error: string;
+};
+/** This repo's own scan state home, under the person's qcr state home: the
+ * repo's directory name and a hash of its real path, so two repos never share
+ * a unit cut, a ledger or a findings store. */
+export declare function repoScanHome(env: NodeJS.ProcessEnv, cwd: string): string;
+/** The env a `qcr scan` child runs under: the person's, with the repo pi
+ * stands in named as the reviewed repo, that repo's own state home (unless
+ * the person set one), and the shipped defaults as the config when the
+ * person has no qcr config. */
+export declare function scanEnv(host: PluginHost): NodeJS.ProcessEnv;
+/** The findings as markdown, worst first as qcr lists them. */
+export declare function renderScanFindings(findings: readonly ScanFinding[], total: number): string;
+/** What a guided run ended with. */
+export type GuidedScan = {
+    ok: true;
+    sha: string | null;
+    findings: ScanFinding[];
+    total: number;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Price, ask, start, wait, list: the guided scan. The person confirms the
+ * price; with nobody to ask, nothing is started. Esc (or the session ending)
+ * stops the run through `qcr scan stop`.
+ */
+export declare function guidedScan(host: PluginHost, ui: SessionUi, o: ScanOptions): Promise<GuidedScan>;
+/** /scan. */
+export declare function runScanCommand(line: string, host: PluginHost, ui: SessionUi): Promise<void>;
+/** The message /selfimprove hands the agent: the fix loop, then the findings. */
+export declare function selfImproveBrief(o: {
+    cwd: string;
+    sha: string | null;
+    findings: readonly ScanFinding[];
+    total: number;
+}): string;
+/** /selfimprove: scan the repo, then hand the agent the findings and the fix loop. */
+export declare function runSelfImproveCommand(line: string, host: PluginHost, ui: SessionUi): Promise<void>;
+//# sourceMappingURL=scan.d.ts.map

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

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