picopilot 0.1.4 → 0.2.0

package/dist/engine/pico8/shell.js

@@ -1,8 +1,11 @@
 import { spawn } from 'node:child_process';
-import { existsSync, mkdirSync, mkdtempSync, readdirSync, statSync, } from 'node:fs';
+import { existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync, statSync, } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { EXPORT_HTML_NAME, pico8NotFound, RECORD_WAV_BASENAME, } from './adapter.js';
+import { DEFAULT_DISPLAY_MODE, findExecutable, needsVirtualDisplay, startVirtualDisplay, } from './display.js';
+import { overlayEnv } from '../child-env.js';
+import { killOnAbort } from './cleanup.js';
 import { SentinelWatcher } from './sentinel.js';
 /**
  * The default {@link SpawnRunner}: `spawn` with stdin detached (`ignore`) so the
@@ -39,6 +42,63 @@ export function withPico8Home(args) {
     mkdirSync(home, { recursive: true });
     return ['-home', home, ...args];
 }
+/**
+ * The environment PICO-8 is spawned with: the parent env overlaid with the
+ * picopilot-resolved values ({@link overlayEnv}). A `-run` session cannot open a
+ * window or an audio device without DISPLAY, HOME, XDG_RUNTIME_DIR, SDL_*, ...
+ */
+export function pico8ChildEnv(resolved, parent) {
+    return overlayEnv(resolved, parent);
+}
+/**
+ * A private `XDG_RUNTIME_DIR` (mode 0700, one per picopilot process) for a
+ * PICO-8 launched without one. SDL logs "XDG_RUNTIME_DIR is invalid or not set"
+ * otherwise, which is noise in every headless report.
+ */
+let cachedRuntimeDir;
+export function pico8RuntimeDir() {
+    if (cachedRuntimeDir !== undefined && existsSync(cachedRuntimeDir)) {
+        return cachedRuntimeDir;
+    }
+    cachedRuntimeDir = mkdtempSync(join(tmpdir(), 'picopilot-xdg-runtime-'));
+    return cachedRuntimeDir;
+}
+/** `env` with a private {@link pico8RuntimeDir} filled in when XDG_RUNTIME_DIR is absent. */
+export function withRuntimeDir(env) {
+    const current = env.XDG_RUNTIME_DIR;
+    if (current !== undefined && current.trim() !== '')
+        return env;
+    return { ...env, XDG_RUNTIME_DIR: pico8RuntimeDir() };
+}
+/** How many lines of PICO-8's `log.txt` a failed record reports. */
+const LOG_TAIL_LINES = 25;
+/** The last lines of PICO-8's `log.txt` in the isolated `-home`, or undefined if absent. */
+export function readPico8LogTail(home = pico8HomeDir(), lines = LOG_TAIL_LINES) {
+    try {
+        const text = readFileSync(join(home, 'log.txt'), 'utf8');
+        const all = text.trimEnd().split('\n');
+        return all.slice(-lines).join('\n');
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Says WHY a record run produced no WAV, from how it ended. The sentinel is the
+ * harness's last act (after `audio_end`), so anything other than a sentinel
+ * means the harness never finished; a sentinel with no WAV means `audio_end`
+ * saved nothing usable.
+ */
+export function explainNoWav(exitReason, ctx) {
+    switch (exitReason) {
+        case 'timeout':
+            return `the backstop fired after ${ctx.backstopMs}ms before the record harness printed its done-sentinel: the cart never reached audio_end (it failed to load, errored at runtime, or its game loop never ran). See pico8LogTail and printh.`;
+        case 'exit':
+            return 'PICO-8 exited before the record harness printed its done-sentinel: the cart failed to load or crashed, or PICO-8 itself could not start (e.g. no display or audio device). See pico8LogTail and printh.';
+        case 'sentinel':
+            return `the record harness reached its done-sentinel but no non-empty ${ctx.basename}.wav was written to ${ctx.wavDir}: audio_end saved nothing usable (an empty 0-frame capture).`;
+    }
+}
 export const spawnRunner = (file, args, env, options) => {
     // `drive` pipes fixed-size command blocks to stdin; `run`/`record` detach it so
     // the cart never blocks on console input.
@@ -69,14 +129,14 @@ export const spawnRunner = (file, args, env, options) => {
                 // A closed stdin (the cart exited) is not fatal to the run.
             }
         },
-        kill() {
+        kill(signal = 'SIGKILL') {
             try {
                 // Negative pid kills the process GROUP (detached), so any child dies too.
                 if (child.pid !== undefined)
-                    process.kill(-child.pid, 'SIGKILL');
+                    process.kill(-child.pid, signal);
             }
             catch {
-                child.kill('SIGKILL'); // fall back to killing just the process
+                child.kill(signal); // fall back to killing just the process
             }
         },
     };
@@ -143,6 +203,8 @@ function collectWav(wavDir, basename) {
     }
     return path;
 }
+/** The default SIGTERM-to-SIGKILL grace for a gracefully-ended run. */
+export const DEFAULT_KILL_GRACE_MS = 2_000;
 /**
  * The v1 {@link Pico8Adapter}: shells out to the user's native `pico8 -x`
  * (ADR-0006, native path first). It owns the ORCHESTRATION the command should
@@ -156,9 +218,15 @@ function collectWav(wavDir, basename) {
 export class ShellPico8Adapter {
     env;
     spawnRun;
+    display;
+    virtualDisplay;
+    killGraceMs;
     constructor(options) {
+        this.killGraceMs = options.killGraceMs ?? DEFAULT_KILL_GRACE_MS;
         this.env = options.env;
         this.spawnRun = options.spawn ?? spawnRunner;
+        this.display = options.display ?? DEFAULT_DISPLAY_MODE;
+        this.virtualDisplay = options.virtualDisplay ?? {};
     }
     run(options) {
         const [file] = pico8Candidates(this.env);
@@ -246,20 +314,80 @@ export class ShellPico8Adapter {
         });
     }
     record(options) {
+        if (needsVirtualDisplay(this.display, this.env)) {
+            return this.recordOnVirtualDisplay(options);
+        }
+        return this.recordWith(options, 'native');
+    }
+    /**
+     * The record session on a private virtual display (ADR-0017): start Xvfb
+     * (or fall back to `xvfb-run`), run PICO-8 on it with a dummy SDL audio
+     * driver (unless the caller chose one; `audio_rec` captures PICO-8's own
+     * mixer, not the device), and ALWAYS stop the display afterwards, however
+     * the run ended (sentinel, backstop, crash, spawn failure).
+     */
+    async recordOnVirtualDisplay(options) {
+        const [file] = pico8Candidates(this.env);
+        // Absent PICO-8 is reported as such BEFORE paying for (or failing on) a
+        // display, and wrapped in xvfb-run a missing binary would not ENOENT.
+        const find = this.virtualDisplay.find ?? findExecutable;
+        if (find(file, this.env) === undefined)
+            return pico8NotFound();
+        const started = await startVirtualDisplay(this.env, this.virtualDisplay);
+        if (!started.ok)
+            return started;
+        const vd = started.display;
+        try {
+            const env = { ...this.env, ...vd.env };
+            const audioDriver = env.SDL_AUDIODRIVER;
+            if (audioDriver === undefined || audioDriver.trim() === '') {
+                env.SDL_AUDIODRIVER = 'dummy';
+            }
+            return await this.recordWith(options, vd.backend, {
+                env,
+                wrap: (f, a) => vd.wrap(f, a),
+                // xvfb-run's Xvfb lives in PICO-8's process group: SIGTERM first so it
+                // removes its /tmp/.X<n>-lock and socket (a SIGKILL leaves them behind).
+                endGracefully: vd.backend === 'xvfb-run',
+            });
+        }
+        finally {
+            await vd.stop();
+        }
+    }
+    /** The record launch itself, natively or under a virtual display's env/wrapper. */
+    recordWith(options, display, launch) {
         const [file] = pico8Candidates(this.env);
         const basename = options.wavBasename ?? RECORD_WAV_BASENAME;
         // `-root_path <wavDir>` steers the `audio_end(1)`-to-current-folder WAV into
         // the isolated temp dir (never ~/Desktop or the carts root). `-run` is a real
         // A/V session (recording needs audio to capture; `-x` yields an empty WAV).
         const args = ['-root_path', options.wavDir, '-run', options.cartPath];
-        return this.orchestrate(file, args, { sentinel: options.sentinel, backstopMs: options.backstopMs }, (exitReason, printh) => ({
-            ok: true,
-            value: {
-                wavPath: collectWav(options.wavDir, basename),
-                printh,
-                exitReason,
-            },
-        }));
+        // The `-home` is shared by every launch in this process: drop the previous
+        // log.txt so a failed record never reports another run's log as its own.
+        rmSync(join(pico8HomeDir(), 'log.txt'), { force: true });
+        return this.orchestrate(file, args, { sentinel: options.sentinel, backstopMs: options.backstopMs }, (exitReason, printh) => {
+            const wavPath = collectWav(options.wavDir, basename);
+            if (wavPath !== undefined) {
+                return { ok: true, value: { wavPath, printh, exitReason, display } };
+            }
+            const pico8LogTail = readPico8LogTail();
+            return {
+                ok: true,
+                value: {
+                    wavPath,
+                    printh,
+                    exitReason,
+                    display,
+                    noWavReason: explainNoWav(exitReason, {
+                        backstopMs: options.backstopMs,
+                        wavDir: options.wavDir,
+                        basename,
+                    }),
+                    ...(pico8LogTail !== undefined ? { pico8LogTail } : {}),
+                },
+            };
+        }, launch);
     }
     /**
      * The shared launch/sentinel-watch/backstop/collect loop behind both
@@ -274,16 +402,49 @@ export class ShellPico8Adapter {
         return new Promise((resolve) => {
             let settled = false;
             let backstop;
-            const proc = this.spawnRun(file, withPico8Home(args), this.env, {
-                stdin: spawnOpts?.stdin,
-            });
-            const finish = (exitReason) => {
+            const homeArgs = withPico8Home(args);
+            const launch = spawnOpts?.wrap !== undefined
+                ? spawnOpts.wrap(file, homeArgs)
+                : { file, args: homeArgs };
+            const proc = this.spawnRun(launch.file, launch.args, withRuntimeDir(spawnOpts?.env ?? this.env), { stdin: spawnOpts?.stdin });
+            // If picopilot itself is stopped mid-run, take PICO-8 down with it.
+            const disposeAbort = killOnAbort(() => proc.kill());
+            let onClosed;
+            /**
+             * Ends the run once. `kill` = PICO-8 is still running (sentinel/backstop):
+             * SIGKILL its group, or for a graceful end SIGTERM it and resolve when it
+             * has closed (SIGKILL after the grace period).
+             */
+            const finish = (exitReason, kill = false) => {
                 if (settled)
                     return;
                 settled = true;
                 if (backstop !== undefined)
                     clearTimeout(backstop);
-                resolve(buildOk(exitReason, watcher.text));
+                let resolved = false;
+                const done = () => {
+                    if (resolved)
+                        return;
+                    resolved = true;
+                    // Only now: a signal during the graceful wait must still kill PICO-8.
+                    disposeAbort();
+                    resolve(buildOk(exitReason, watcher.text));
+                };
+                if (!kill)
+                    return done();
+                if (spawnOpts?.endGracefully !== true) {
+                    proc.kill();
+                    return done();
+                }
+                proc.kill('SIGTERM');
+                const hard = setTimeout(() => {
+                    proc.kill();
+                    done();
+                }, this.killGraceMs);
+                onClosed = () => {
+                    clearTimeout(hard);
+                    done();
+                };
             };
             proc.onError((err) => {
                 // A spawn ENOENT ⇒ PICO-8 is absent (a bad PICO8_PATH surfaces as absence
@@ -293,6 +454,7 @@ export class ShellPico8Adapter {
                     return;
                 if (err.code === 'ENOENT') {
                     settled = true;
+                    disposeAbort();
                     if (backstop !== undefined)
                         clearTimeout(backstop);
                     resolve(pico8NotFound());
@@ -302,12 +464,15 @@ export class ShellPico8Adapter {
                 }
             });
             proc.onStdout((chunk) => {
-                if (watcher.push(chunk) && !settled) {
-                    proc.kill(); // sentinel matched: end the run promptly
-                    finish('sentinel');
-                }
+                // sentinel matched: end the run promptly
+                if (watcher.push(chunk) && !settled)
+                    finish('sentinel', true);
+            });
+            proc.onClose(() => {
+                if (onClosed !== undefined)
+                    return onClosed();
+                finish('exit'); // PICO-8 exited on its own
             });
-            proc.onClose(() => finish('exit')); // PICO-8 exited on its own
             // For `drive`: write the command blocks to the live stdin now that it is
             // spawned. A spawn ENOENT resolves via onError before this matters.
             spawnOpts?.onSpawn?.(proc);
@@ -315,8 +480,7 @@ export class ShellPico8Adapter {
             backstop = setTimeout(() => {
                 if (settled)
                     return;
-                proc.kill();
-                finish('timeout');
+                finish('timeout', true);
             }, opts.backstopMs);
         });
     }

package/dist/engine/pico8/shell.js.map

@@ -1 +1 @@
-{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../../src/engine/pico8/shell.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../../src/engine/pico8/shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,oBAAoB,CAAC;AACzC,OAAO,EACN,UAAU,EACV,SAAS,EACT,WAAW,EACX,WAAW,EACX,YAAY,EACZ,MAAM,EACN,QAAQ,GACR,MAAM,SAAS,CAAC;AACjB,OAAO,EAAC,MAAM,EAAC,MAAM,SAAS,CAAC;AAC/B,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,EAGN,gBAAgB,EAGhB,aAAa,EAKb,mBAAmB,GAInB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,oBAAoB,EAEpB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,GAEnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAC,UAAU,EAAC,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AACzC,OAAO,EAAC,eAAe,EAAC,MAAM,eAAe,CAAC;AAsC9C;;;;;GAKG;AACH;;;;;;;;;;;;GAYG;AACH,IAAI,UAA8B,CAAC;AACnC,MAAM,UAAU,YAAY;IAC3B,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IAC1E,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAClE,OAAO,UAAU,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAc;IAC3C,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;IAC5B,SAAS,CAAC,IAAI,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC;IACnC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC5B,QAAsD,EACtD,MAAyB;IAEzB,OAAO,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,IAAI,gBAAoC,CAAC;AACzC,MAAM,UAAU,eAAe;IAC9B,IAAI,gBAAgB,KAAK,SAAS,IAAI,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACpE,OAAO,gBAAgB,CAAC;IACzB,CAAC;IACD,gBAAgB,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,wBAAwB,CAAC,CAAC,CAAC;IACzE,OAAO,gBAAgB,CAAC;AACzB,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,cAAc,CAAC,GAAsB;IACpD,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,CAAC;IACpC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,GAAG,CAAC;IAC/D,OAAO,EAAC,GAAG,GAAG,EAAE,eAAe,EAAE,eAAe,EAAE,EAAC,CAAC;AACrD,CAAC;AAED,oEAAoE;AACpE,MAAM,cAAc,GAAG,EAAE,CAAC;AAE1B,4FAA4F;AAC5F,MAAM,UAAU,gBAAgB,CAC/B,OAAe,YAAY,EAAE,EAC7B,QAAgB,cAAc;IAE9B,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;QACzD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC3B,UAAsB,EACtB,GAA2D;IAE3D,QAAQ,UAAU,EAAE,CAAC;QACpB,KAAK,SAAS;YACb,OAAO,4BAA4B,GAAG,CAAC,UAAU,4LAA4L,CAAC;QAC/O,KAAK,MAAM;YACV,OAAO,yMAAyM,CAAC;QAClN,KAAK,UAAU;YACd,OAAO,iEAAiE,GAAG,CAAC,QAAQ,uBAAuB,GAAG,CAAC,MAAM,8DAA8D,CAAC;IACtL,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE;IACpE,gFAAgF;IAChF,0CAA0C;IAC1C,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE;QAC/B,GAAG;QACH,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;QAC9B,QAAQ,EAAE,IAAI;KACd,CAAC,CAAC;IACH,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,OAAO;QACN,QAAQ,CAAC,EAAE;YACV,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC7B,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,CAAC,EAAE;YACT,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,CAAC,EAAE;YACT,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,EAAwB,CAAC,CAAC;QAC7C,CAAC;QACD,UAAU,CAAC,KAAK;YACf,IAAI,CAAC;gBACJ,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YACxC,CAAC;YAAC,MAAM,CAAC;gBACR,4DAA4D;YAC7D,CAAC;QACF,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,SAAS;YACtB,IAAI,CAAC;gBACJ,0EAA0E;gBAC1E,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;oBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAC/D,CAAC;YAAC,MAAM,CAAC;gBACR,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,wCAAwC;YAC7D,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC,CAAC;AAEF,iGAAiG;AACjG,MAAM,UAAU,eAAe,CAAC,GAAsB;IACrD,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;IACvC,OAAO,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QACjD,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC;QACpB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,MAAc;IACzC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO,WAAW,CAAC,MAAM,CAAC;SACxB,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;SAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACb,IAAI,CAAC;YACJ,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC,CAAC,CAAC;AACL,CAAC;AAED,sFAAsF;AACtF,SAAS,kBAAkB,CAAC,OAAe;IAC1C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,OAAO,WAAW,CAAC,OAAO,CAAC;SACzB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;SAC/C,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,SAAS,UAAU,CAAC,MAAc,EAAE,QAAgB;IACnD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC7C,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAChC,CAAC;IACF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,QAAQ,GAAG,GAAG,QAAQ,MAAM,CAAC;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAE,CAAC;IACpE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,6EAA6E;IAC7E,IAAI,CAAC;QACJ,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE;YAAE,OAAO,SAAS,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAuBD,uEAAuE;AACvE,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAE3C;;;;;;;;;GASG;AACH,MAAM,OAAO,iBAAiB;IACZ,GAAG,CAAoB;IACvB,QAAQ,CAAc;IACtB,OAAO,CAAc;IACrB,cAAc,CAAqB;IACnC,WAAW,CAAS;IAErC,YAAY,OAA0B;QACrC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,qBAAqB,CAAC;QAChE,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC;QAC7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,oBAAoB,CAAC;QACvD,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC;IACpD,CAAC;IAED,GAAG,CAAC,OAAmB;QACtB,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAA0B,CAAC;QAClE,MAAM,IAAI,GAAG;YACZ,UAAU;YACV,OAAO,CAAC,OAAO;YACf,IAAI;YACJ,OAAO,CAAC,QAAQ;YAChB,8EAA8E;YAC9E,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7D,CAAC;QACF,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YACrE,EAAE,EAAE,IAAI;YACR,KAAK,EAAE;gBACN,WAAW,EAAE,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC;gBAChD,MAAM;gBACN,UAAU;aACV;SACD,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH;;;;;;;;OAQG;IACH,KAAK,CAAC,OAAqB;QAC1B,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAA0B,CAAC;QAClE,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC,WAAW,CACtB,IAAI,EACJ,IAAI,EACJ,EAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAC,EAC5D,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YACxB,EAAE,EAAE,IAAI;YACR,KAAK,EAAE;gBACN,WAAW,EAAE,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC;gBAChD,MAAM;gBACN,UAAU;aACV;SACD,CAAC,EACF,EAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,EAAC,CACnE,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,OAAsB;QAC5B,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAA0B,CAAC;QAClE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,gBAAgB,CAAC;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC/C,6EAA6E;QAC7E,2EAA2E;QAC3E,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC,WAAW,CACtB,IAAI,EACJ,IAAI;QACJ,0EAA0E;QAC1E,uEAAuE;QACvE,EAAC,UAAU,EAAE,OAAO,CAAC,UAAU,EAAC,EAChC,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE;YACvB,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACjD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YACxD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;YACpD,OAAO;gBACN,EAAE,EAAE,IAAI;gBACR,KAAK,EAAE;oBACN,QAAQ;oBACR,MAAM;oBACN,KAAK;oBACL,wEAAwE;oBACxE,YAAY,EAAE,+BAA+B,CAAC,IAAI,CAAC,MAAM,CAAC;iBAC1D;aACD,CAAC;QACH,CAAC,CACD,CAAC;IACH,CAAC;IAED,MAAM,CAAC,OAAsB;QAC5B,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACjD,OAAO,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,sBAAsB,CACnC,OAAsB;QAEtB,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAA0B,CAAC;QAClE,wEAAwE;QACxE,sEAAsE;QACtE,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,IAAI,cAAc,CAAC;QACxD,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,OAAO,aAAa,EAAE,CAAC;QAE/D,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QACzE,IAAI,CAAC,OAAO,CAAC,EAAE;YAAE,OAAO,OAAO,CAAC;QAChC,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;QAC3B,IAAI,CAAC;YACJ,MAAM,GAAG,GAAsB,EAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,EAAC,CAAC;YACxD,MAAM,WAAW,GAAG,GAAG,CAAC,eAAe,CAAC;YACxC,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBAC5D,GAAG,CAAC,eAAe,GAAG,OAAO,CAAC;YAC/B,CAAC;YACD,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE;gBACjD,GAAG;gBACH,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC7B,uEAAuE;gBACvE,yEAAyE;gBACzE,aAAa,EAAE,EAAE,CAAC,OAAO,KAAK,UAAU;aACxC,CAAC,CAAC;QACJ,CAAC;gBAAS,CAAC;YACV,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;QACjB,CAAC;IACF,CAAC;IAED,mFAAmF;IAC3E,UAAU,CACjB,OAAsB,EACtB,OAAgC,EAChC,MAIC;QAED,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAA0B,CAAC;QAClE,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,IAAI,mBAAmB,CAAC;QAC5D,6EAA6E;QAC7E,8EAA8E;QAC9E,4EAA4E;QAC5E,MAAM,IAAI,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QACtE,2EAA2E;QAC3E,yEAAyE;QACzE,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,SAAS,CAAC,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,WAAW,CACtB,IAAI,EACJ,IAAI,EACJ,EAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAC,EAC5D,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE;YACtB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACrD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC3B,OAAO,EAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAC,EAAC,CAAC;YAClE,CAAC;YACD,MAAM,YAAY,GAAG,gBAAgB,EAAE,CAAC;YACxC,OAAO;gBACN,EAAE,EAAE,IAAI;gBACR,KAAK,EAAE;oBACN,OAAO;oBACP,MAAM;oBACN,UAAU;oBACV,OAAO;oBACP,WAAW,EAAE,YAAY,CAAC,UAAU,EAAE;wBACrC,UAAU,EAAE,OAAO,CAAC,UAAU;wBAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;wBACtB,QAAQ;qBACR,CAAC;oBACF,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAC,YAAY,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;iBACrD;aACD,CAAC;QACH,CAAC,EACD,MAAM,CACN,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACK,WAAW,CAClB,IAAY,EACZ,IAAc,EACd,IAA6C,EAC7C,OAAsD,EACtD,SAYC;QAED,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEnD,OAAO,IAAI,OAAO,CAAuC,CAAC,OAAO,EAAE,EAAE;YACpE,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,IAAI,QAAoC,CAAC;YACzC,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;YACrC,MAAM,MAAM,GACX,SAAS,EAAE,IAAI,KAAK,SAAS;gBAC5B,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;gBAChC,CAAC,CAAC,EAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAC,CAAC;YAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CACzB,MAAM,CAAC,IAAI,EACX,MAAM,CAAC,IAAI,EACX,cAAc,CAAC,SAAS,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,EAC1C,EAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAC,CACzB,CAAC;YAEF,oEAAoE;YACpE,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACpD,IAAI,QAAkC,CAAC;YAEvC;;;;eAIG;YACH,MAAM,MAAM,GAAG,CAAC,UAAsB,EAAE,IAAI,GAAG,KAAK,EAAQ,EAAE;gBAC7D,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,IAAI,QAAQ,KAAK,SAAS;oBAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;gBACnD,IAAI,QAAQ,GAAG,KAAK,CAAC;gBACrB,MAAM,IAAI,GAAG,GAAG,EAAE;oBACjB,IAAI,QAAQ;wBAAE,OAAO;oBACrB,QAAQ,GAAG,IAAI,CAAC;oBAChB,sEAAsE;oBACtE,YAAY,EAAE,CAAC;oBACf,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC5C,CAAC,CAAC;gBACF,IAAI,CAAC,IAAI;oBAAE,OAAO,IAAI,EAAE,CAAC;gBACzB,IAAI,SAAS,EAAE,aAAa,KAAK,IAAI,EAAE,CAAC;oBACvC,IAAI,CAAC,IAAI,EAAE,CAAC;oBACZ,OAAO,IAAI,EAAE,CAAC;gBACf,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACrB,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;oBACZ,IAAI,EAAE,CAAC;gBACR,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;gBACrB,QAAQ,GAAG,GAAG,EAAE;oBACf,YAAY,CAAC,IAAI,CAAC,CAAC;oBACnB,IAAI,EAAE,CAAC;gBACR,CAAC,CAAC;YACH,CAAC,CAAC;YAEF,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBACpB,0EAA0E;gBAC1E,0EAA0E;gBAC1E,gCAAgC;gBAChC,IAAI,OAAO;oBAAE,OAAO;gBACpB,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC3B,OAAO,GAAG,IAAI,CAAC;oBACf,YAAY,EAAE,CAAC;oBACf,IAAI,QAAQ,KAAK,SAAS;wBAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;oBACnD,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;gBAC1B,CAAC;qBAAM,CAAC;oBACP,MAAM,CAAC,MAAM,CAAC,CAAC;gBAChB,CAAC;YACF,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE;gBACvB,yCAAyC;gBACzC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO;oBAAE,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YAC/D,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;gBACjB,IAAI,QAAQ,KAAK,SAAS;oBAAE,OAAO,QAAQ,EAAE,CAAC;gBAC9C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,2BAA2B;YAC5C,CAAC,CAAC,CAAC;YAEH,yEAAyE;YACzE,oEAAoE;YACpE,SAAS,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;YAE3B,+DAA+D;YAC/D,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC1B,IAAI,OAAO;oBAAE,OAAO;gBACpB,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACzB,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;IACJ,CAAC;CACD"}

package/dist/engine/pico8/supervisor.d.ts

@@ -1,5 +1,5 @@
 /**
- * The playtest SESSION SUPERVISOR (ADR-0011, prd US #6): the daemon that keeps a
+ * The playtest SESSION SUPERVISOR (ADR-0011, spec US #6): the daemon that keeps a
  * driven PICO-8 process ALIVE + PAUSED across the agent's separate CLI turns, and
  * the client the per-verb sub-invocations use to address it BY ID.
  *

package/dist/engine/pico8/supervisor.js

@@ -1,5 +1,5 @@
 /**
- * The playtest SESSION SUPERVISOR (ADR-0011, prd US #6): the daemon that keeps a
+ * The playtest SESSION SUPERVISOR (ADR-0011, spec US #6): the daemon that keeps a
  * driven PICO-8 process ALIVE + PAUSED across the agent's separate CLI turns, and
  * the client the per-verb sub-invocations use to address it BY ID.
  *

package/dist/engine/shrinko/adapter.d.ts

@@ -23,7 +23,7 @@ export declare const SHRINKO_REMEDY: "uv pip install shrinko";
 export declare const SHRINKO_NEEDS: readonly ["python>=3.8"];
 /**
  * The structured "shrinko is not installed" failure (ADR-0002). Its shape is
- * fixed by the prd's two-tier contract (US #17): `ok:false`, a machine-readable
+ * fixed by the spec's two-tier contract (US #17): `ok:false`, a machine-readable
  * `reason`, the EXACT `remedy` string, and the `needs` list. A command turns
  * this into an incur `error({ code: reason, ... })` with a nonzero exit.
  */

package/dist/engine/shrinko/shell.d.ts

@@ -23,9 +23,9 @@ export type ChildRunner = (file: string, args: string[], env: NodeJS.ProcessEnv)
  * The default {@link ChildRunner}: an `execFile` that captures stdout/stderr and
  * NEVER rejects. A failed spawn (ENOENT) becomes `spawnError`; a nonzero exit
  * becomes a `code`, so both outcomes are data the adapter maps to a structured
- * result. The child inherits ONLY the `env` it is handed (the command layer
- * passes the incur-resolved env, whose `PATH` a test can override) so there is
- * no ambient-environment leak.
+ * result. The child gets exactly the `env` it is handed and reads nothing
+ * ambiently; the command layer builds that env as the parent env overlaid with
+ * the resolved `PATH` (`commands/shrinko-env.ts`), and a test injects its own.
  */
 export declare const execFileRunner: ChildRunner;
 /** Options for {@link ShellShrinkoAdapter}. */

package/dist/engine/shrinko/shell.js

@@ -4,9 +4,9 @@ import { parseCount, parseLint, shrinkoNotFound, } from './adapter.js';
  * The default {@link ChildRunner}: an `execFile` that captures stdout/stderr and
  * NEVER rejects. A failed spawn (ENOENT) becomes `spawnError`; a nonzero exit
  * becomes a `code`, so both outcomes are data the adapter maps to a structured
- * result. The child inherits ONLY the `env` it is handed (the command layer
- * passes the incur-resolved env, whose `PATH` a test can override) so there is
- * no ambient-environment leak.
+ * result. The child gets exactly the `env` it is handed and reads nothing
+ * ambiently; the command layer builds that env as the parent env overlaid with
+ * the resolved `PATH` (`commands/shrinko-env.ts`), and a test injects its own.
  */
 export const execFileRunner = (file, args, env) => new Promise((resolve) => {
     execFile(file, args, { env, encoding: 'utf8' }, (error, stdout, stderr) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "picopilot",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "An agent-first toolchain for PICO-8 game development, built on the incur CLI framework.",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -42,6 +42,7 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json",
     "dev": "as-soon -w src pnpm build",
     "test": "vitest run",
     "test:watch": "vitest",

package/src/cli.test.ts

@@ -0,0 +1,188 @@
+import {mkdtempSync, rmSync, writeFileSync} from 'node:fs';
+import {tmpdir} from 'node:os';
+import {join} from 'node:path';
+import {z} from 'incur';
+import {afterEach, beforeEach, describe, expect, it} from 'vitest';
+import {createCli} from './cli.js';
+import {displayModeOf} from './commands/pico8-env.js';
+
+/**
+ * The display mode (ADR-0017) is resolved ONCE, globally, by the root CLI:
+ * `--display` > `PICOPILOT_DISPLAY` > picopilot.json `display` > `auto`. A probe
+ * command mounted on the real CLI reports what a command handler sees.
+ */
+
+let dir: string;
+beforeEach(() => {
+	dir = mkdtempSync(join(tmpdir(), 'picopilot-cli-'));
+});
+afterEach(() => rmSync(dir, {recursive: true, force: true}));
+
+async function probe(
+	argv: string[],
+	env: Record<string, string | undefined> = {},
+	config?: unknown,
+) {
+	const cli = createCli();
+	cli.command('probe-display', {
+		run: (c) => ({display: displayModeOf(c.var)}),
+	});
+	const args = [...argv];
+	if (config !== undefined) {
+		const path = join(dir, 'picopilot.json');
+		writeFileSync(path, JSON.stringify(config));
+		args.push('--config', path);
+	}
+	let stdout = '';
+	let exitCode = 0;
+	await cli.serve([...args, '--json'], {
+		stdout(s) {
+			stdout += s;
+		},
+		exit(code) {
+			exitCode = code;
+		},
+		env,
+	});
+	return {out: JSON.parse(stdout), exitCode};
+}
+
+describe('display mode resolution through the CLI', () => {
+	it('defaults to auto', async () => {
+		expect((await probe(['probe-display'])).out.display).toBe('auto');
+	});
+
+	it('reads picopilot.json "display"', async () => {
+		const {out} = await probe(['probe-display'], {}, {display: 'native'});
+		expect(out.display).toBe('native');
+	});
+
+	it('PICOPILOT_DISPLAY beats picopilot.json', async () => {
+		const {out} = await probe(
+			['probe-display'],
+			{PICOPILOT_DISPLAY: 'xvfb'},
+			{display: 'native'},
+		);
+		expect(out.display).toBe('xvfb');
+	});
+
+	it('--display beats both, before or after the command', async () => {
+		for (const argv of [
+			['--display', 'native', 'probe-display'],
+			['probe-display', '--display', 'native'],
+		]) {
+			const {out} = await probe(
+				argv,
+				{PICOPILOT_DISPLAY: 'xvfb'},
+				{display: 'xvfb'},
+			);
+			expect(out.display).toBe('native');
+		}
+	});
+
+	it('an invalid PICOPILOT_DISPLAY is an error for a display command, not a silent auto', async () => {
+		const cli = createCli();
+		let stdout = '';
+		let exitCode = 0;
+		await cli.serve(['run', join(dir, 'none.p8'), '--json'], {
+			stdout(s) {
+				stdout += s;
+			},
+			exit(code) {
+				exitCode = code;
+			},
+			env: {PICOPILOT_DISPLAY: 'xfvb'},
+		});
+		expect(exitCode).not.toBe(0);
+		const out = JSON.parse(stdout);
+		expect(out.code).toBe('invalid-display-mode');
+		expect(out.message).toContain('PICOPILOT_DISPLAY');
+	});
+
+	it('an invalid value does not break commands that never use the display', async () => {
+		const cli = createCli();
+		let stdout = '';
+		let exitCode = 0;
+		await cli.serve(['version', '--json'], {
+			stdout(s) {
+				stdout += s;
+			},
+			exit(code) {
+				exitCode = code;
+			},
+			env: {PICOPILOT_DISPLAY: 'xfvb'},
+		});
+		expect(exitCode).toBe(0);
+		expect(JSON.parse(stdout).name).toBe('picopilot');
+	});
+
+	it('--no-config ignores the picopilot.json display key', async () => {
+		const path = join(dir, 'picopilot.json');
+		writeFileSync(path, JSON.stringify({display: 'native'}));
+		// First load it (so a stale value could leak), then disable config.
+		const cli = createCli();
+		cli.command('probe-display', {
+			run: (c) => ({display: displayModeOf(c.var)}),
+		});
+		const outs: string[] = [];
+		for (const argv of [
+			['probe-display', '--config', path, '--json'],
+			['probe-display', '--no-config', '--json'],
+		]) {
+			let stdout = '';
+			await cli.serve(argv, {
+				stdout(s) {
+					stdout += s;
+				},
+				exit() {},
+				env: {},
+			});
+			outs.push(JSON.parse(stdout).display);
+		}
+		expect(outs).toEqual(['native', 'auto']);
+	});
+
+	it('--config naming a missing file is an error', async () => {
+		const cli = createCli();
+		let stdout = '';
+		let exitCode = 0;
+		await cli.serve(['version', '--config', join(dir, 'nope.json'), '--json'], {
+			stdout(s) {
+				stdout += s;
+			},
+			exit(code) {
+				exitCode = code;
+			},
+			env: {},
+		});
+		expect(exitCode).not.toBe(0);
+		expect(stdout).toContain('not found');
+	});
+
+	it('a per-command config option still loads next to the display key', async () => {
+		// The custom config loader must keep incur's per-command option defaults.
+		const cli = createCli();
+		let seen: unknown;
+		cli.command('probe-opt', {
+			options: z.object({flag: z.boolean().default(false)}),
+			run: (c) => {
+				seen = c.options.flag;
+				return {};
+			},
+		});
+		const path = join(dir, 'picopilot.json');
+		writeFileSync(
+			path,
+			JSON.stringify({
+				display: 'native',
+				commands: {'probe-opt': {options: {flag: true}}},
+			}),
+		);
+		await cli.serve(['probe-opt', '--config', path, '--json'], {
+			stdout() {},
+			exit() {},
+			env: {},
+		});
+		expect(seen).toBe(true);
+	});
+});