@juangadm/pre-post 1.0.0 → 1.2.0

package/dist/baseline.js

@@ -0,0 +1,413 @@
+/**
+ * Serve the PR's base commit locally, as the "Pre" side.
+ *
+ * This is the baseline that always works: it needs no deployment, no
+ * production URL and no network, so it is what keeps pre-post usable inside a
+ * sandbox — a cloud agent container, a CI job, or any box behind an egress
+ * allowlist. It is also the most honest comparison available, because both
+ * sides then render in the same environment with the same fonts and the same
+ * browser, leaving the diff as the only variable.
+ *
+ * The cost is time: a checkout, an install and a dev-server boot. So callers
+ * reach for it after a reachable deployment, not before one.
+ */
+import { spawn, execFileSync } from 'child_process';
+import fs from 'fs';
+import net from 'net';
+import os from 'os';
+import path from 'path';
+import { NeedsHumanError } from './errors.js';
+import { devScript, readPackage } from './pkg.js';
+import { findAppRoots } from './routes.js';
+const NPM = { bin: 'npm', install: ['install'], retry: { argv: ['install', '--legacy-peer-deps'], when: isPeerConflict }, run: (s, a) => ['run', s, '--', ...a] };
+const PNPM = { bin: 'pnpm', install: ['install', '--prefer-offline'], run: (s, a) => ['run', s, ...a] };
+const YARN = { bin: 'yarn', install: ['install'], run: (s, a) => ['run', s, ...a] };
+const BUN = { bin: 'bun', install: ['install'], run: (s, a) => ['run', s, ...a] };
+const MANAGERS = [
+    { lockfile: 'pnpm-lock.yaml', pm: PNPM },
+    { lockfile: 'yarn.lock', pm: YARN },
+    { lockfile: 'bun.lockb', pm: BUN },
+    { lockfile: 'package-lock.json', pm: NPM },
+];
+const BY_NAME = { npm: NPM, pnpm: PNPM, yarn: YARN, bun: BUN };
+/**
+ * Which package manager this tree *declares*, from its `packageManager` field
+ * or its lockfile. Defaults to npm.
+ *
+ * The field wins over the lockfile because it is the deliberate statement: a
+ * repository mid-migration can carry two lockfiles, but it names one manager.
+ */
+export function detectPackageManager(dir, repoRoot) {
+    for (const candidate of [dir, repoRoot].filter(Boolean)) {
+        const field = readPackage(candidate)?.packageManager;
+        const named = typeof field === 'string' ? BY_NAME[field.split('@')[0].trim()] : undefined;
+        if (named)
+            return named;
+        for (const { lockfile, pm } of MANAGERS) {
+            if (fs.existsSync(path.join(candidate, lockfile)))
+                return pm;
+        }
+    }
+    return NPM;
+}
+/**
+ * Is `bin` runnable here?
+ *
+ * A PATH scan rather than a `--version` subprocess: this answers before every
+ * local baseline, and spawning a process to learn that a process cannot be
+ * spawned is the wrong shape.
+ */
+export function onPath(bin, env = process.env) {
+    const dirs = (env.PATH ?? '').split(path.delimiter).filter(Boolean);
+    const exts = process.platform === 'win32'
+        ? (env.PATHEXT ?? '.COM;.EXE;.BAT;.CMD').split(';').filter(Boolean)
+        : [''];
+    return dirs.some(dir => exts.some(ext => {
+        // throwIfNoEntry keeps the common case (a miss) from constructing an
+        // exception; the catch stays for the rarer EACCES/ELOOP.
+        try {
+            return fs.statSync(path.join(dir, bin + ext), { throwIfNoEntry: false })?.isFile() ?? false;
+        }
+        catch {
+            return false;
+        }
+    }));
+}
+/**
+ * The manager to actually run: what the repository declares, if it is installed.
+ *
+ * Declaring pnpm does not put pnpm on PATH. On a real machine it was not there,
+ * and the local baseline — the fallback that exists for when nothing is
+ * deployed — died on `pnpm install` with no hint that the missing piece was
+ * pnpm itself. The same shell could still build the CLI, so the tool ran while
+ * its last resort could not.
+ *
+ * npm ships with Node, so it is the fallback with the best odds of being
+ * present. It will not honour a pnpm or yarn lockfile, so the baseline it
+ * installs can drift from the locked versions — worth saying out loud, and
+ * still far better than no baseline at all.
+ */
+export function resolvePackageManager(dir, repoRoot, has = onPath) {
+    const declared = detectPackageManager(dir, repoRoot);
+    if (has(declared.bin))
+        return { pm: declared, declared };
+    return { pm: has(NPM.bin) ? NPM : null, declared };
+}
+/**
+ * The directory to actually serve.
+ *
+ * The app root is detected from the files a branch changed, which answers
+ * "which routes moved" — not "which package can be served". A PR touching only
+ * the CLI resolves to the repo root, which has no dev script even though the
+ * site next door does. So prefer the detected directory and otherwise take the
+ * nearest package that can start a server.
+ */
+export function servableDir(treeRoot, appPrefix) {
+    const preferred = appPrefix ? path.join(treeRoot, appPrefix) : treeRoot;
+    const preferredScript = devScript(preferred);
+    if (preferredScript)
+        return { dir: preferred, script: preferredScript };
+    // Deepest first: a workspace app beats the repo root that merely contains it.
+    for (const dir of findAppRoots(treeRoot).sort((a, b) => b.length - a.length)) {
+        const script = devScript(dir);
+        if (script)
+            return { dir, script };
+    }
+    return null;
+}
+/** Local env files, in the order a framework would layer them. */
+const ENV_FILES = ['.env', '.env.local', '.env.development', '.env.development.local'];
+/**
+ * Copy the working checkout's local env files into a throwaway worktree.
+ *
+ * .env files are gitignored, so a fresh worktree of the base commit has none.
+ * An app that needs one to boot then either never starts or serves an error
+ * page — and an error page diffed against the real branch reports a wall of
+ * changes the PR never made, which is worse than reporting no baseline at all.
+ *
+ * Only ever writes inside `to`, and returns names, never values: these files
+ * are exactly the ones that hold secrets.
+ */
+export function copyEnvFiles(from, to, appPrefix) {
+    const copied = [];
+    const root = path.resolve(to);
+    for (const dir of appPrefix ? ['', appPrefix] : ['']) {
+        for (const name of ENV_FILES) {
+            const src = path.join(from, dir, name);
+            const dest = path.resolve(root, dir, name);
+            // The worktree is the only place this may write.
+            if (dest !== root && !dest.startsWith(root + path.sep))
+                continue;
+            if (!fs.existsSync(src) || fs.existsSync(dest))
+                continue;
+            try {
+                fs.mkdirSync(path.dirname(dest), { recursive: true });
+                fs.copyFileSync(src, dest);
+                copied.push(path.posix.join(dir, name));
+            }
+            catch { /* best effort: a missing env file is not fatal on its own */ }
+        }
+    }
+    return copied;
+}
+/** An OS-assigned free port. */
+export function freePort() {
+    return new Promise((resolve, reject) => {
+        const srv = net.createServer();
+        srv.once('error', reject);
+        srv.listen(0, '127.0.0.1', () => {
+            const port = srv.address().port;
+            srv.close(() => resolve(port));
+        });
+    });
+}
+/** Keep the end of the output: managers put the diagnosis last. */
+function tail(text, lines = 24) {
+    const kept = text.replace(/\s+$/, '').split('\n').slice(-lines);
+    return kept.join('\n').trim();
+}
+/**
+ * Room for the noisiest install that still works.
+ *
+ * Node's default is 1 MiB per stream, and exceeding it kills the child with
+ * ENOBUFS — which this code would read as a failed install. A verbose set of
+ * postinstall scripts must not be the reason a baseline cannot be built, and
+ * the buffer is transient and freed as soon as the tail is taken.
+ */
+const MAX_INSTALL_OUTPUT = 64 * 1024 * 1024;
+const runInstall = (bin, argv, cwd, timeoutMs) => {
+    try {
+        execFileSync(bin, argv, { cwd, timeout: Math.max(1, timeoutMs), encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'], maxBuffer: MAX_INSTALL_OUTPUT });
+        // Only a failure has anything to explain, so the successful install's log
+        // is dropped rather than split into lines nothing will read.
+        return { argv, ok: true, output: '' };
+    }
+    catch (err) {
+        const e = err;
+        const output = [e.stdout, e.stderr].map(part => (part ? String(part) : '')).join('');
+        return { argv, ok: false, output: tail(output || e.message || '') };
+    }
+};
+/**
+ * Does this look like npm refusing to resolve a peer range?
+ *
+ * Matched on npm's own error code rather than on prose, so it does not depend
+ * on the wording of a given npm release. The second pattern is the same
+ * failure as reported by older npm, which does not always print the code.
+ */
+export function isPeerConflict(output) {
+    return /ERESOLVE/i.test(output) || /could not resolve dependency/i.test(output);
+}
+/**
+ * Install this app's dependencies, retrying once past a peer-dependency wall.
+ *
+ * The retry is deliberately narrow: only on the specific failure that a looser
+ * resolver would not have had, and only for a manager that has a looser mode.
+ * A baseline installed with `--legacy-peer-deps` is not a perfect reproduction
+ * of the branch's own install — but the alternative is no baseline at all, and
+ * the comparison this tool exists to make is between two renders of the same
+ * app, not between two dependency trees.
+ */
+export function installDeps(pm, cwd, timeoutMs, run = runInstall) {
+    const deadline = Date.now() + timeoutMs;
+    const first = run(pm.bin, pm.install, cwd, timeoutMs);
+    if (first.ok || !pm.retry?.when(first.output))
+        return { ok: first.ok, attempts: [first] };
+    // The remainder of the original budget, not a fresh one: a first attempt
+    // that burned the clock must not let the retry double the wall time.
+    const second = run(pm.bin, pm.retry.argv, cwd, deadline - Date.now());
+    return { ok: second.ok, attempts: [first, second] };
+}
+/**
+ * The install failed and nothing else can rescue this run.
+ *
+ * Its own error rather than a quiet null, for the reason docs/portability.md
+ * §1 gives about base resolution: a run that compared nothing must not exit
+ * clean. A null here fell through to "no baseline", and on a repository with a
+ * configured production URL it fell through to comparing against that instead
+ * — a different answer to a different question, published as if it were this
+ * one.
+ */
+/**
+ * What a reader has to do about a failed install, in one sentence.
+ *
+ * One sentence because that is what `NeedsHumanError` is for (AGENTS.md): the
+ * CLI prints the whole message for exit 3, so pasting a screen of package
+ * manager output here would bury the instruction inside it. The output is
+ * still the thing that answers "why", so it goes to the log instead — above
+ * this line, where it reads as diagnostics rather than as the remedy.
+ *
+ * The command names the caller's own directory, never the worktree: by the
+ * time anyone reads this, cleanup has deleted the worktree, so telling them to
+ * run it there would be an instruction they cannot follow.
+ */
+export function installFailureHint(where, ranIn) {
+    return `Could not install ${where} for the baseline; run \`install\` in ${ranIn} to fix it, or re-run with --no-local-baseline and pass --before <production-url>.`;
+}
+export class BaselineInstallError extends NeedsHumanError {
+    result;
+    constructor(result, where, ranIn) {
+        super(installFailureHint(where, ranIn));
+        this.result = result;
+        this.name = 'BaselineInstallError';
+    }
+}
+async function waitForServer(url, timeoutMs, alive) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (!alive())
+            return false;
+        try {
+            await fetch(url, { signal: AbortSignal.timeout(2000) });
+            return true;
+        }
+        catch {
+            await new Promise(r => setTimeout(r, 500));
+        }
+    }
+    return false;
+}
+/**
+ * Check out `sha` into a throwaway worktree, install, and start its dev server.
+ *
+ * Returns null when this repo cannot be served this way (no dev script, no
+ * install, server never came up). Callers treat that as "try the next option",
+ * so every failure path cleans up after itself and stays quiet.
+ */
+export async function serveBaseCommit(opts) {
+    return serveLocally(opts);
+}
+/**
+ * Boot this repository's dev server without one already running.
+ *
+ * The working tree is what the author is looking at, uncommitted edits and all,
+ * so it is the honest "Post" when nothing is deployed. Serving it needs no
+ * worktree and usually no install, which is why it is cheaper than the base
+ * side it gets paired with.
+ */
+export async function serveWorkingTree(opts) {
+    return serveLocally({ ...opts, sha: undefined });
+}
+async function serveLocally(opts) {
+    const log = opts.log ?? (() => undefined);
+    const what = opts.sha ? `base commit ${opts.sha.slice(0, 7)}` : 'the working tree';
+    /** Every caller treats null as "try the next option", so say why before returning it. */
+    const skip = (detail) => {
+        log(`Could not serve ${what}: ${detail}`);
+        return null;
+    };
+    const timeoutMs = opts.timeoutMs ?? 300_000;
+    const deadline = Date.now() + timeoutMs;
+    const worktree = opts.sha ? fs.mkdtempSync(path.join(os.tmpdir(), 'pre-post-base-')) : opts.repoRoot;
+    let child = null;
+    let stopped = false;
+    // A detached dev server survives Ctrl-C and keeps its port, so tear it down
+    // on the signals that end the run as well as on the normal path.
+    const onSignal = () => { void cleanup(); };
+    const untrap = () => {
+        process.off('SIGINT', onSignal);
+        process.off('SIGTERM', onSignal);
+        process.off('exit', onSignal);
+    };
+    const cleanup = async () => {
+        if (stopped)
+            return;
+        stopped = true;
+        untrap();
+        if (child && child.exitCode === null) {
+            try {
+                process.kill(-child.pid, 'SIGTERM');
+            }
+            catch { /* already gone */ }
+        }
+        // Guard on the thing that actually matters: only a throwaway worktree may be
+        // removed. Checking `opts.sha` instead would let any future caller that
+        // points `worktree` at a real checkout delete uncommitted work.
+        if (worktree === opts.repoRoot)
+            return;
+        try {
+            execFileSync('git', ['worktree', 'remove', '--force', worktree], { cwd: opts.repoRoot, stdio: 'ignore' });
+        }
+        catch {
+            fs.rmSync(worktree, { recursive: true, force: true });
+        }
+    };
+    if (opts.sha) {
+        try {
+            execFileSync('git', ['worktree', 'add', '--detach', '--force', worktree, opts.sha], { cwd: opts.repoRoot, stdio: 'ignore' });
+        }
+        catch {
+            await cleanup();
+            return skip('the worktree checkout failed.');
+        }
+        const copied = copyEnvFiles(opts.repoRoot, worktree, opts.appPrefix);
+        if (copied.length)
+            log(`Using local env file(s) for the baseline: ${copied.join(', ')}`);
+    }
+    const app = servableDir(worktree, opts.appPrefix);
+    if (!app) {
+        await cleanup();
+        return skip('no package with a dev, serve or start script was found.');
+    }
+    const { dir: appDir, script } = app;
+    const { pm, declared } = resolvePackageManager(appDir, worktree, opts.pathHas);
+    const rel = path.relative(worktree, appDir);
+    // The worktree is a throwaway that cleanup deletes on the way out, so every
+    // "run it by hand" below names the same directory in the caller's own
+    // checkout instead — the one that will still be there to run it in.
+    const appIn = path.join(opts.repoRoot, rel);
+    const where = rel || 'the repository';
+    if (!pm) {
+        await cleanup();
+        return skip(`neither ${declared.bin} nor npm is on PATH, so nothing can install ${where}.`);
+    }
+    const install = !fs.existsSync(path.join(appDir, 'node_modules'));
+    // Substituting npm for the declared manager is safe in a throwaway worktree
+    // and not in the caller's own checkout: npm cannot share a node_modules with
+    // pnpm, so installing over their tree leaves the working copy broken — the
+    // state the README tells people to `rm -rf node_modules` out of. Taking
+    // screenshots must not cost someone their install, so this stops instead.
+    // Only the install is dangerous; running a script against a tree that is
+    // already installed is not, which is why this asks about both.
+    if (pm !== declared && install && worktree === opts.repoRoot) {
+        await cleanup();
+        return skip(`${declared.bin} is not on PATH, and installing ${where} with npm instead would leave a node_modules your ${declared.bin} cannot use. Install ${declared.bin}, or run \`${declared.bin} install\` in ${appIn}.`);
+    }
+    if (pm !== declared) {
+        log(`${declared.bin} is not on PATH; installing the baseline with ${pm.bin} instead (it will not honour the ${declared.bin} lockfile).`);
+    }
+    log(`Starting a dev server for ${what} (${pm.bin} ${script}) ...`);
+    if (install) {
+        const result = installDeps(pm, appDir, deadline - Date.now());
+        if (!result.ok) {
+            const tried = result.attempts.map(a => `\`${pm.bin} ${a.argv.join(' ')}\``).join(', then ');
+            log(`${tried} failed${worktree === opts.repoRoot ? '' : ' in a throwaway worktree of the base commit'}:`);
+            log(result.attempts[result.attempts.length - 1].output);
+            await cleanup();
+            throw new BaselineInstallError(result, where, appIn);
+        }
+        const retried = result.attempts[1];
+        if (retried) {
+            log(`\`${pm.bin} ${pm.install.join(' ')}\` hit a peer-dependency conflict; installed the baseline with \`${retried.argv.join(' ')}\` instead.`);
+        }
+    }
+    const port = await freePort();
+    const url = `http://localhost:${port}`;
+    child = spawn(pm.bin, pm.run(script, ['--port', String(port)]), {
+        cwd: appDir,
+        stdio: 'ignore',
+        detached: true,
+        env: { ...process.env, PORT: String(port), BROWSER: 'none' },
+    });
+    child.unref();
+    const ready = await waitForServer(url, Math.max(1, deadline - Date.now()), () => !!child && child.exitCode === null);
+    if (!ready) {
+        await cleanup();
+        return skip(`${pm.bin} ${script} did not start serving within ${Math.round(timeoutMs / 1000)}s (missing env vars are the usual cause).`);
+    }
+    process.once('SIGINT', onSignal);
+    process.once('SIGTERM', onSignal);
+    process.once('exit', onSignal);
+    return { url, stop: cleanup };
+}
+//# sourceMappingURL=baseline.js.map

package/dist/baseline.js.map

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

package/dist/bin/cli.js

@@ -5,7 +5,7 @@ import { runPr } from '../commands/pr.js';
 import { runCompare } from '../commands/compare.js';
 import { runLogin } from '../commands/login.js';
 import { runPrune } from '../commands/prune.js';
-import { runDoctor } from '../commands/doctor.js';
+import { doctorExitCode, runDoctor } from '../commands/doctor.js';
 import { runDetect } from '../commands/detect.js';
 import { NeedsHumanError } from '../errors.js';
 import { buildSummary } from '../report.js';
@@ -21,39 +21,63 @@ const VERSION = (() => {
 const SUBCOMMANDS = ['pr', 'detect', 'login', 'prune', 'doctor', 'compare'];
 const argv = process.argv.slice(2);
 const subcommand = SUBCOMMANDS.includes(argv[0]) ? argv.shift() : null;
-const { values, positionals } = parseArgs({
-    args: argv,
-    allowPositionals: true,
-    options: {
-        help: { type: 'boolean', short: 'h' },
-        version: { type: 'boolean', short: 'v' },
-        before: { type: 'string' },
-        after: { type: 'string' },
-        routes: { type: 'string' },
-        'max-routes': { type: 'string' },
-        framework: { type: 'string' },
-        viewports: { type: 'string' },
-        mobile: { type: 'boolean', short: 'm' },
-        tablet: { type: 'boolean', short: 't' },
-        responsive: { type: 'boolean', short: 'r' },
-        size: { type: 'string' },
-        full: { type: 'boolean', short: 'f' },
-        'viewport-only': { type: 'boolean' },
-        scale: { type: 'string' },
-        threshold: { type: 'string' },
-        'max-height': { type: 'string' },
-        wait: { type: 'string' },
-        header: { type: 'string', multiple: true },
-        cookie: { type: 'string', multiple: true },
-        output: { type: 'string', short: 'o' },
-        'dry-run': { type: 'boolean' },
-        'no-comment': { type: 'boolean' },
-        pr: { type: 'string' },
-        json: { type: 'boolean' },
-        days: { type: 'string' },
-        quiet: { type: 'boolean', short: 'q' },
-    },
-});
+/**
+ * parseArgs throws a TypeError for an unknown flag, and an uncaught one prints
+ * a Node-internal stack trace: eight lines of `node:internal/util/parse_args`
+ * for a typo. The CLI is mostly read by agents, so the first line has to be the
+ * thing to fix, not a frame from Node's parser.
+ *
+ * Only the parse is wrapped, and the message is Node's own — this reformats a
+ * failure, it does not decide what counts as one.
+ */
+function parse() {
+    try {
+        return parseArgs({
+            args: argv,
+            allowPositionals: true,
+            options: OPTIONS,
+        });
+    }
+    catch (err) {
+        const message = err?.message?.split('\n')[0] ?? 'could not parse the arguments';
+        console.error(`pre-post: ${message}`);
+        console.error('Run: pre-post --help');
+        process.exit(2);
+    }
+}
+const OPTIONS = {
+    help: { type: 'boolean', short: 'h' },
+    version: { type: 'boolean', short: 'v' },
+    before: { type: 'string' },
+    after: { type: 'string' },
+    routes: { type: 'string' },
+    'max-routes': { type: 'string' },
+    framework: { type: 'string' },
+    base: { type: 'string' },
+    'no-local-baseline': { type: 'boolean' },
+    viewports: { type: 'string' },
+    mobile: { type: 'boolean', short: 'm' },
+    tablet: { type: 'boolean', short: 't' },
+    responsive: { type: 'boolean', short: 'r' },
+    size: { type: 'string' },
+    full: { type: 'boolean', short: 'f' },
+    'viewport-only': { type: 'boolean' },
+    scale: { type: 'string' },
+    threshold: { type: 'string' },
+    'min-changed-area': { type: 'string' },
+    'max-height': { type: 'string' },
+    wait: { type: 'string' },
+    header: { type: 'string', multiple: true },
+    cookie: { type: 'string', multiple: true },
+    output: { type: 'string', short: 'o' },
+    'dry-run': { type: 'boolean' },
+    'no-comment': { type: 'boolean' },
+    pr: { type: 'string' },
+    json: { type: 'boolean' },
+    days: { type: 'string' },
+    quiet: { type: 'boolean', short: 'q' },
+};
+const { values, positionals } = parse();
 function printHelp() {
     console.log(`pre-post ${VERSION} — before/after screenshots for pull requests
 
@@ -61,6 +85,7 @@ USAGE
   pre-post pr [options]                 Detect routes, capture, diff, publish, comment on the PR
   pre-post <before> <after> [options]   Compare two URLs (or two PNG files)
   pre-post detect                       Print the routes this branch affects (JSON)
+  pre-post ... --base <ref>             Compare against <ref> instead of the detected fork point
   pre-post login <url>                  Sign in once; the session is reused for captures
   pre-post prune [--days 90]            Delete screenshots for PRs closed longer ago
   pre-post doctor                       Check browser, GitHub auth, dev server
@@ -70,16 +95,22 @@ OPTIONS
   --after <url>             Local base URL (auto-detected)
   --routes /a,/b            Explicit routes instead of detection
   --max-routes <n>          Cap on detected routes (default 6)
-  --viewports desktop,mobile,1440x900   Viewports (default desktop,mobile)
+  --viewports desktop,mobile,1440x900   Viewports (default desktop)
+  -r, --responsive          Desktop and mobile
   -m, --mobile  -t, --tablet  --size WxH   Single-viewport shorthands
   -f, --full | --viewport-only          Full page (default for pr) or first screen only
   --scale <n>               Device scale factor (default 2)
-  --threshold <0..1>        Change ratio treated as "no change" (default 0.001)
+  --threshold <0..1>        Changed share of the canvas that counts (default 0.001)
+  --min-changed-area <px2>  Changed area in CSS px² that counts (default 100)
+                            A capture counts as changed when EITHER holds, so
+                            a 0.04% diff on a full page is still a change if it
+                            paints more than 100 CSS px².
   --max-height <px>         Full-page height cap in CSS px (default 2400)
   --wait <ms>               Extra wait after the page settles
   --header k=v              Extra request header (repeatable)
   --cookie name=value       Cookie for the production host (repeatable)
   -o, --output <dir>        Where to write images (default: temp dir)
+  --no-local-baseline       Do not rebuild the baseline from the base commit
   --dry-run                 Capture and diff only; no upload, no comment
   --no-comment              Publish images but do not touch the PR
   --pr <number>             Target a specific PR
@@ -166,6 +197,7 @@ async function main() {
         fullPage: values['viewport-only'] ? false : values.full ? true : undefined,
         scale: num(values.scale, '--scale'),
         threshold: num(values.threshold, '--threshold'),
+        minChangedArea: num(values['min-changed-area'], '--min-changed-area'),
         maxHeight: num(values['max-height'], '--max-height'),
         maxRoutes: num(values['max-routes'], '--max-routes'),
         wait: num(values.wait, '--wait'),
@@ -176,14 +208,21 @@ async function main() {
     const { before, after } = resolveTargets();
     switch (subcommand) {
         case 'pr': {
+            // before/after come from flags here; positionals would be silently dropped.
+            if (positionals.length) {
+                console.error(`pre-post pr takes no positional arguments (got: ${positionals.join(' ')}). Use --before and --after.`);
+                process.exit(2);
+            }
             const cookies = values.cookie ? Object.entries(kv(values.cookie)).map(([name, value]) => ({ name, value })) : undefined;
             const result = await runPr({
                 ...common,
                 before,
                 after,
                 framework: values.framework,
+                base: values.base,
                 cookies,
                 dryRun: values['dry-run'],
+                localBaseline: !values['no-local-baseline'],
                 comment: !values['no-comment'],
                 pr: num(values.pr, '--pr'),
                 version: VERSION,
@@ -194,7 +233,7 @@ async function main() {
             return;
         }
         case 'detect': {
-            const detection = runDetect({ maxRoutes: common.maxRoutes, framework: values.framework });
+            const detection = runDetect({ maxRoutes: common.maxRoutes, framework: values.framework, base: values.base });
             console.log(JSON.stringify(detection, null, values.json ? 2 : 0));
             return;
         }
@@ -214,11 +253,17 @@ async function main() {
         }
         case 'doctor': {
             const checks = await runDoctor();
-            for (const c of checks)
-                console.log(`${c.name.padEnd(10)} ${c.ok ? 'ok' : 'FAIL'}  ${c.detail}`);
-            if (checks.some(c => !c.ok && c.name === 'browser'))
-                process.exit(1);
-            return;
+            for (const c of checks) {
+                // Advisory failures are worth reading and are not failures of the
+                // command, so they must not look like the ones that are.
+                const status = c.ok ? 'ok' : c.required ? 'FAIL' : 'note';
+                console.log(`${c.name.padEnd(10)} ${status.padEnd(4)}  ${c.detail}`);
+            }
+            const code = doctorExitCode(checks);
+            console.log(code === 0
+                ? 'ready — pre-post pr can run'
+                : `not ready — fix: ${checks.filter(c => c.required && !c.ok).map(c => c.name).join(', ')}`);
+            process.exit(code);
         }
         case 'compare':
         default: {