@quickchatai/quickreview 1.2.0 → 1.3.2

package/dist/src/home/launch.js

@@ -0,0 +1,202 @@
+// A bare `qcr`: the home. The app's pinned pi (src/picli.ts), with the plugin
+// and the home's extension loaded, on the person's own pi home.
+//
+//   pi home    the person's own: $PI_CODING_AGENT_DIR as the person set it,
+//              else ~/.pi/agent. The launch never sets it, so the chat, the
+//              panel's login line (which reads the same dir) and every review
+//              use one login.
+//   quiet      no logo, resource list, trust prompt, changelog or model
+//              warning, and nothing written to the person's global pi
+//              settings: the quiet start is project settings in the home's
+//              own working directory (in the app's state home), the per-run
+//              trust flag `--approve`, and an explicit `--model`. The
+//              project settings also carry the pinned pi's version as the
+//              last changelog seen, or pi would record it in the global
+//              settings on a first run.
+//   resume     the sessions live in the state home (`--session-dir`), and
+//              `--continue` opens the most recent one there, or a new one.
+//   tools      `[home] tools = "reviewer"` (the default) names the allowed
+//              tools (src/home/toolnames.ts) and starts no MCP server;
+//              "full" leaves pi's own defaults.
+//   GitHub     the person's own `gh`. In the image (scripts/qcr-host.sh's
+//              home mode) there is no gh config: the wrapper hands the token
+//              over as a file (packages/pi-plugin/src/ghcred.ts), src/cli.ts
+//              takes it at startup, and the home passes it to pi as GH_TOKEN,
+//              in its environment only.
+//
+// `-ne` keeps the person's own extensions out: a plugin they installed in pi
+// themselves would otherwise register its commands twice.
+//
+// Everything effectful is injected; `homeRunDeps()` is the real assembly.
+import { spawnSync } from "node:child_process";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { parse } from "smol-toml";
+import { HOME_DEFAULTS, parseHomeSection } from "../config.js";
+import { pluginPackageDir } from "../coreext.js";
+import { locateConfig, stateHome } from "../homes.js";
+import { piCliPath, piPackageDir } from "../picli.js";
+import { HOME_MODEL_ENV, HOME_TOOLS_ENV } from "./adapters.js";
+import { reviewerToolAllowlist } from "./toolnames.js";
+/** The home's places in the state home. */
+export function homePaths(state) {
+    const cwd = join(state, "home");
+    return {
+        cwd,
+        settings: join(cwd, ".pi", "settings.json"),
+        sessions: join(cwd, "sessions"),
+    };
+}
+/** The env shim pi loads for the home, in the app at `appRoot`. */
+export function homeExtensionPath(appRoot) {
+    return join(appRoot, "extensions", "cli", "home.ts");
+}
+/** The home's project settings, over whatever the file already holds. */
+export function homeProjectSettings(existing, piVersion) {
+    const base = typeof existing === "object" && existing !== null && !Array.isArray(existing)
+        ? existing
+        : {};
+    return {
+        ...base,
+        quietStartup: true,
+        ...(piVersion === null ? {} : { lastChangelogVersion: piVersion }),
+    };
+}
+/** What a bare `qcr` runs. */
+export function homeLaunch(o) {
+    const p = homePaths(o.stateHome);
+    const tools = o.home.tools === "reviewer" ? ["--tools", reviewerToolAllowlist().join(","), "--no-mcp"] : [];
+    return {
+        args: [
+            o.piCli,
+            "--approve",
+            "--no-extensions",
+            "-e",
+            o.pluginDir,
+            "-e",
+            homeExtensionPath(o.appRoot),
+            "--model",
+            o.home.model,
+            ...tools,
+            "--session-dir",
+            p.sessions,
+            "--continue",
+        ],
+        cwd: p.cwd,
+        // PI_CODING_AGENT_DIR passes through as the person set it, or stays unset
+        env: {
+            ...o.env,
+            PI_SKIP_VERSION_CHECK: "1",
+            [HOME_MODEL_ENV]: o.home.model,
+            [HOME_TOOLS_ENV]: o.home.tools,
+            ...(o.githubToken ? { GH_TOKEN: o.githubToken } : {}),
+        },
+    };
+}
+/** A bare `qcr`: open the home. pi's exit code. */
+export function runHome(deps) {
+    let piCli;
+    let pluginDir;
+    try {
+        piCli = deps.piCli();
+        pluginDir = deps.pluginDir();
+    }
+    catch (err) {
+        deps.err(`qcr: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+    const { home, problem } = deps.homeConfig();
+    if (problem)
+        deps.err(`qcr: ${problem}; the home opens on its defaults.`);
+    const p = homePaths(deps.stateHome);
+    try {
+        deps.mkdir(p.sessions);
+        deps.mkdir(dirname(p.settings));
+        let existing = undefined;
+        let before = null;
+        try {
+            before = deps.readFile(p.settings);
+            existing = JSON.parse(before);
+        }
+        catch {
+            // no settings yet, or not ours to read: written fresh below
+        }
+        const text = `${JSON.stringify(homeProjectSettings(existing, deps.piVersion()), null, 2)}\n`;
+        if (text !== before)
+            deps.writeFile(p.settings, text);
+    }
+    catch (err) {
+        deps.err(`qcr: can't prepare the home in ${p.cwd}: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+    const launch = homeLaunch({
+        piCli,
+        pluginDir,
+        appRoot: deps.appRoot,
+        stateHome: deps.stateHome,
+        home,
+        env: deps.env,
+        githubToken: deps.githubToken(),
+    });
+    const r = deps.run(deps.execPath, launch.args, { cwd: launch.cwd, env: launch.env });
+    if (r.error) {
+        deps.err(`qcr: pi could not start: ${r.error.message}`);
+        return 1;
+    }
+    return r.status ?? 1;
+}
+/** The config's `[home]`, read on its own: the home opens even when the rest
+ * of the config would not load. */
+export function readHomeConfig(env, read = (p) => readFileSync(p, "utf8")) {
+    const path = locateConfig({ env }).path;
+    let raw;
+    try {
+        raw = read(path);
+    }
+    catch (err) {
+        if (err?.code === "ENOENT")
+            return { home: { ...HOME_DEFAULTS } };
+        return { home: { ...HOME_DEFAULTS }, problem: `can't read ${path}` };
+    }
+    try {
+        return { home: parseHomeSection(parse(raw)["home"]) };
+    }
+    catch (err) {
+        return {
+            home: { ...HOME_DEFAULTS },
+            problem: `${path}: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+export function homeRunDeps(appRoot, env = process.env) {
+    return {
+        env,
+        appRoot,
+        stateHome: stateHome(env),
+        piCli: () => piCliPath(),
+        pluginDir: () => pluginPackageDir(),
+        piVersion: () => {
+            try {
+                const pkg = JSON.parse(readFileSync(join(piPackageDir(), "package.json"), "utf8"));
+                return typeof pkg.version === "string" ? pkg.version : null;
+            }
+            catch {
+                return null;
+            }
+        },
+        // the person's own gh; the image's `qcr home` (src/cli.ts) passes the
+        // token the wrapper handed over
+        githubToken: () => null,
+        homeConfig: () => readHomeConfig(env),
+        readFile: (p) => readFileSync(p, "utf8"),
+        writeFile: (p, t) => writeFileSync(p, t),
+        mkdir: (p) => mkdirSync(p, { recursive: true }),
+        run: (cmd, args, opts) => {
+            const r = spawnSync(cmd, [...args], { stdio: "inherit", cwd: opts.cwd, env: opts.env });
+            return { status: r.status, ...(r.error ? { error: r.error } : {}) };
+        },
+        execPath: process.execPath,
+        err: (l) => console.error(l),
+    };
+}
+//# sourceMappingURL=launch.js.map

package/dist/src/home/launch.js.map

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

package/dist/src/home/loginowner.js

@@ -0,0 +1,205 @@
+// One login per box, as the home sees it: who refreshes
+// the OpenAI login the home signed in to, whether it still works, and the
+// re-login that replaces it safely.
+//
+//   owner     the daemon's refresher holds the login while auto-review runs
+//             on this machine (its single-instance lock, beside auth.json in
+//             the home's own pi agent dir, which the stack mounts:
+//             src/onboard/steps/loginshare.ts). Otherwise the home's pi refreshes it
+//             itself, by pi's own rule: a token inside pi's 5-minute window,
+//             under pi's own lock. While the refresher runs no token gets
+//             near that window, so the home's pi never refreshes: it borrows.
+//   expired   the refresher's record says its refresh fails and the token is
+//             past its expiry (or the grant was refused); or the chat itself
+//             was refused for the login (extensions/home.ts reads pi's error);
+//             or auto-review is paused on it. The login line then says "login
+//             expired", with one key that signs in again.
+//   re-login  pi's own device login (src/home/devicelogin.ts), with the
+//             entrypoint's handover around it (src/loginrefresh/handover.ts):
+//             a running refresher is paused first, and keeps its lock, so its
+//             refresh can never land on top of the new login; the pause is
+//             lifted after, and the refresher re-reads the new login at once,
+//             so auto-review resumes on it.
+//
+// Nothing here reads or prints a token: the refresher's status file carries
+// expiry times and redacted errors only.
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { PI_AUTH_ERROR_RE } from "@quickchatai/pi-quickreview/src/authwatch.js";
+import { holdRefresher, refresherRuns } from "../loginrefresh/handover.js";
+import { STATUS_FILE } from "../loginrefresh/refresher.js";
+import { providerLabel } from "./model.js";
+import { known, unknown, } from "./ports.js";
+import { DEVICE_LOGIN_PROVIDERS, loginFailureText, } from "./setup.js";
+/** What the login line says of a login that no longer works. */
+export const LOGIN_EXPIRED = "login expired";
+/** The key that signs in again, while typing (the panel's is `l`). */
+export const RELOGIN_KEY = "alt+l";
+const isObj = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+const message = (err) => (err instanceof Error ? err.message : String(err));
+/** A refresh refused for good: the grant is gone, not a network blip. */
+const REFUSED = /invalid_grant|revoked|refresh_token_(?:reused|expired|invalidated)/i;
+/** Why the refresher's record (its loginrefresh.status.json) says the login
+ * no longer works, or null. Pure. */
+export function expiredWhy(record, now) {
+    if (!isObj(record))
+        return null;
+    const err = record["last_error"];
+    if (typeof err !== "string" || err === "")
+        return null;
+    if (REFUSED.test(err))
+        return LOGIN_EXPIRED;
+    const expires = typeof record["expires_at"] === "string" ? Date.parse(record["expires_at"]) : NaN;
+    return Number.isFinite(expires) && expires <= now ? LOGIN_EXPIRED : null;
+}
+/** An error pi showed in the chat that is the login's (pi-ai's refresh
+ * failure, or the provider refusing the token). */
+export function isLoginError(text) {
+    return PI_AUTH_ERROR_RE.test(text) || /OAuth refresh failed/i.test(text);
+}
+/** The login in the home's own pi agent dir, beside the refresher that may
+ * hold it. */
+export function hostLoginOwner(o) {
+    const read = o.read ?? ((p) => readFileSync(p, "utf8"));
+    const probe = {
+        ...(o.flockBin ? { flockBin: o.flockBin } : {}),
+        ...(o.daemonRuns ? { refresherRuns: o.daemonRuns } : {}),
+    };
+    return {
+        health: async () => {
+            const runs = await refresherRuns(o.loginDir, probe);
+            if (runs === null)
+                return unknown("can't tell whether auto-review's login refresher runs");
+            if (!runs)
+                return known({ refresher: "home" });
+            let record;
+            try {
+                record = JSON.parse(read(join(o.loginDir, STATUS_FILE)));
+            }
+            catch {
+                // it has not written one yet: nothing says the login fails
+                return known({ refresher: "auto-review" });
+            }
+            const why = expiredWhy(record, o.now());
+            const checked = isObj(record) && typeof record["checked_at"] === "string"
+                ? Date.parse(record["checked_at"])
+                : NaN;
+            return known({
+                refresher: "auto-review",
+                ...(why ? { expired: why } : {}),
+                ...(Number.isFinite(checked) ? { checkedAt: checked } : {}),
+            });
+        },
+        hold: () => holdRefresher(o.loginDir, { ...probe, ...(o.waitMs ? { waitMs: o.waitMs } : {}) }),
+    };
+}
+/** "login expired" → one key, or `home_relogin`: sign in again. */
+export class Relogin {
+    o;
+    signing = null;
+    closed = false;
+    constructor(o) {
+        this.o = o;
+    }
+    /** A re-login in flight: its code once pi has one. */
+    running() {
+        return this.signing === null ? null : this.signing.code ? { code: this.signing.code } : {};
+    }
+    changed() {
+        this.o.onChange?.();
+    }
+    /** Sign in again. The answer comes once the code is shown (or the login
+     * ended): the sign-in goes on in the background. */
+    async start() {
+        const m = this.o.model;
+        const s = this.signing;
+        if (s !== null)
+            return s.code
+                ? `Still waiting: open ${s.code.verificationUri} and enter ${s.code.userCode}.`
+                : "The sign-in is starting: the code shows in a moment.";
+        if (this.closed)
+            return "the home has closed";
+        const provider = m.chatProvider();
+        const label = providerLabel(provider);
+        const port = DEVICE_LOGIN_PROVIDERS.has(provider) ? this.o.deviceLogin() : undefined;
+        if (port === undefined) {
+            const why = `sign in to ${label} again with pi's own /login (switch auto-review off first, so its refresher does not write over the new login)`;
+            m.say(`${why[0].toUpperCase()}${why.slice(1)}.`, "warn");
+            return why;
+        }
+        const signing = { ac: new AbortController() };
+        this.signing = signing;
+        this.changed();
+        // the refresher first, when one runs: it keeps its lock and stops writing
+        let hold;
+        try {
+            hold = this.o.owner
+                ? await this.o.owner.hold()
+                : { ok: true, held: false, release: () => { } };
+        }
+        catch (err) {
+            hold = { ok: false, why: message(err) };
+        }
+        if (!hold.ok) {
+            this.signing = null;
+            m.say(`Couldn't sign in again: ${hold.why}. Nothing changed.`, "warn");
+            this.changed();
+            return `the sign-in did not start: ${hold.why}`;
+        }
+        const release = hold.release;
+        const held = hold.held;
+        if (signing.ac.signal.aborted) {
+            release();
+            this.signing = null;
+            return "the home has closed";
+        }
+        m.say(`Signing in to ${label} again with pi's device code.`);
+        let answer;
+        const answered = new Promise((r) => (answer = r));
+        signing.onCode = (c) => {
+            m.say(`Open ${c.verificationUri} and enter the code ${c.userCode}.`);
+            answer(`Open ${c.verificationUri} and enter the code ${c.userCode}. The home finishes the sign-in once you approve it.`);
+        };
+        void (async () => {
+            let outcome;
+            try {
+                outcome = await port.login({
+                    provider,
+                    signal: signing.ac.signal,
+                    onCode: (code) => {
+                        signing.code = code;
+                        signing.onCode?.(code);
+                        this.changed();
+                    },
+                });
+            }
+            catch (err) {
+                outcome = { ok: false, kind: "failed", why: message(err) };
+            }
+            finally {
+                // the pause is lifted whatever happened: the refresher re-reads the file
+                release();
+                this.signing = null;
+            }
+            if (outcome.ok) {
+                m.signedInAgain();
+                await m.refresh();
+                m.say(`Signed in to ${label} again.${held ? " Auto-review's refresher has the new login, and auto-review resumes." : ""}`, "ok");
+                answer(`signed in to ${label} again`);
+            }
+            else {
+                if (outcome.kind !== "cancelled")
+                    m.say(loginFailureText(outcome, RELOGIN_KEY), "warn");
+                answer(`the sign-in did not finish: ${outcome.why}`);
+            }
+            this.changed();
+        })();
+        return answered;
+    }
+    /** The session ends: a re-login in flight stops, and its pause is lifted. */
+    close() {
+        this.closed = true;
+        this.signing?.ac.abort();
+    }
+}
+//# sourceMappingURL=loginowner.js.map

package/dist/src/home/loginowner.js.map

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

package/dist/src/home/memory.js

@@ -0,0 +1,122 @@
+import { OnboardingEngine } from "../onboard/engine.js";
+import { BROUGHT_UP_CHOICE_KEY } from "../onboard/steps/bringup.js";
+import { DAEMON_SERVICE, MEMORY_SERVICE, composeArgs, readEnvText, } from "../onboard/steps/compose.js";
+import { readEnvKey } from "../onboard/steps/ingress.js";
+import { MEMORY_CHOICE_KEY, MEMORY_STEP_ID, waitsOnServer } from "../onboard/steps/memory.js";
+import { MEMORY_KEYS_STEP_ID } from "../onboard/steps/memorykeys.js";
+import { serviceState } from "./autoreview.js";
+import { known, } from "./ports.js";
+import { MACHINE_CHECKS_STEP_ID, memoryPhaseB, runSteps, switchOnInput, switchOnRegistry, } from "./switchon.js";
+/** compose's memory cap when the project `.env` names none
+ * (docker-compose.yml `mem_limit: ${QCR_MEMORY_LIMIT:-4g}`). */
+export const DEFAULT_MEMORY_LIMIT = "4g";
+/** "4g" → "up to 4 GB of RAM"; a value compose would not read is said as is. */
+export function ramCostOf(limit) {
+    const m = /^\s*(\d+(?:\.\d+)?)\s*([kmgt])?b?\s*$/i.exec(limit);
+    if (!m)
+        return `up to ${limit.trim()} of RAM`;
+    const unit = { k: "KB", m: "MB", g: "GB", t: "TB" }[(m[2] ?? "").toLowerCase()] ?? "bytes";
+    return `up to ${m[1]} ${unit} of RAM`;
+}
+/** The memory engine's state from its container's. */
+export function memoryStateOf(c) {
+    if (c.kind === "unknown")
+        return c;
+    return known(c.value === "running" ? "on" : c.value === "restarting" ? "starting" : "off");
+}
+const firstLine = (s) => s.trim().split("\n")[0]?.trim() || "no output";
+/** The memory step's answer when the person turns memory on. */
+const MEMORY_YES = switchOnInput(MEMORY_STEP_ID, {
+    answers: { memory: true, confirmed: false },
+    repo: null,
+});
+/**
+ * Memory on, on a stack brought up before. Set up when it never was (or was
+ * declined): phase A places the root key, and when the engine does not run
+ * yet that is all it can do, so the engine is started (it reads the key at
+ * boot) and phase B runs once it answers (memoryPhaseB). Otherwise the engine
+ * is started as it is. Then its user keys, when that step is not done.
+ */
+export async function memoryOnStack(e, o) {
+    const configured = e.list().find((s) => s.id === MEMORY_STEP_ID);
+    let waits = false;
+    if (configured?.status !== "done" || e.choices()[MEMORY_CHOICE_KEY] === "declined") {
+        o.progress?.("Setting memory up…");
+        const r = await e.runStep(MEMORY_STEP_ID, MEMORY_YES);
+        if (!r.ok && !waitsOnServer(r.checks))
+            return { ok: false, detail: r.failures.join("; ") };
+        waits = !r.ok;
+    }
+    if (waits) {
+        const b = await memoryPhaseB({ ...o, checklist: e }, MEMORY_YES);
+        if (!b.ok)
+            return { ok: false, detail: b.detail };
+    }
+    else {
+        const up = await o.startMemory();
+        if (!up.ok)
+            return up;
+    }
+    const keys = e.list().find((s) => s.id === MEMORY_KEYS_STEP_ID);
+    if (keys && keys.status !== "done" && keys.status !== "disabled") {
+        const r = await e.runStep(MEMORY_KEYS_STEP_ID);
+        if (!r.ok)
+            return { ok: false, detail: `the engine runs, but ${r.failures.join("; ")}` };
+    }
+    return { ok: true, detail: "Memory is on." };
+}
+export function composeMemory(o) {
+    const compose = async (args, what) => {
+        const r = await o.runner.run("docker", composeArgs(o.root, args));
+        return r.code === 0
+            ? { ok: true, detail: what }
+            : {
+                ok: false,
+                detail: `docker compose ${args.join(" ")} exited ${r.code}: ${firstLine(r.stderr || r.stdout)}`,
+            };
+    };
+    const engine = (log) => new OnboardingEngine(switchOnRegistry(o), o.stepAdapters(log));
+    const startMemory = () => compose(["up", "-d", MEMORY_SERVICE], "the memory engine runs");
+    return {
+        status: async () => memoryStateOf(await serviceState(o.runner, o.root, MEMORY_SERVICE)),
+        control: {
+            ramCost: () => ramCostOf((readEnvKey(readEnvText(o.root), "QCR_MEMORY_LIMIT") ?? "").trim() ||
+                DEFAULT_MEMORY_LIMIT),
+            switchOn: async (progress) => {
+                const e = engine((l) => progress?.(l));
+                if (typeof e.choices()[BROUGHT_UP_CHOICE_KEY] !== "string") {
+                    // No stack yet: switch-on's steps bring it up with memory, and the
+                    // daemon is put back as it was (off), so auto-review stays off.
+                    const daemonWas = await serviceState(o.runner, o.root, DAEMON_SERVICE);
+                    const checks = await e.runStep(MACHINE_CHECKS_STEP_ID);
+                    if (!checks.ok)
+                        return { ok: false, detail: checks.failures.join("; ") };
+                    const steps = [];
+                    const walked = await runSteps({
+                        checklist: e,
+                        memory: true,
+                        repo: await o.repo(),
+                        startMemory,
+                        ...(o.sleep ? { sleep: o.sleep } : {}),
+                        ...(progress ? { progress } : {}),
+                    }, steps);
+                    if (!walked.ok)
+                        return { ok: false, detail: walked.detail };
+                    if (daemonWas.kind === "known" && daemonWas.value !== "running") {
+                        const stopped = await compose(["stop", DAEMON_SERVICE], "");
+                        if (!stopped.ok)
+                            return { ok: false, detail: `memory is on, but ${stopped.detail}` };
+                    }
+                    return { ok: true, detail: "Memory is on." };
+                }
+                return memoryOnStack(e, {
+                    startMemory,
+                    ...(o.sleep ? { sleep: o.sleep } : {}),
+                    ...(progress ? { progress } : {}),
+                });
+            },
+            switchOff: () => compose(["stop", MEMORY_SERVICE], "Memory is off. What it learned is kept."),
+        },
+    };
+}
+//# sourceMappingURL=memory.js.map

package/dist/src/home/memory.js.map

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