picopilot 0.1.4 → 0.2.0

package/dist/commands/label-cart.d.ts

@@ -0,0 +1,72 @@
+import { type DriveOptions, type Pico8DriveResult } from '../engine/pico8/index.js';
+/**
+ * The remedy for both label-image errors (`label-wrong-size`,
+ * `label-unsupported-png`): the screenshot `run`/`playtest` already wrote is a
+ * valid label as-is, so point at that rather than at an external image tool.
+ */
+export declare const LABEL_FIX_CTA: {
+    description: string;
+    commands: {
+        command: string;
+        description: string;
+    }[];
+};
+/** Where the exported cart's `__label__` came from. */
+export type LabelSource = 'cart' | 'image' | 'frame' | 'none';
+/** A cart ready to hand to PICO-8's export, plus how to tidy up after it. */
+export interface LabeledCart {
+    readonly ok: true;
+    /** The cart to export: the original, or a labeled throwaway copy. */
+    readonly cartPath: string;
+    /**
+     * Where the label comes from: the cart's own (`cart`), `--label` (`image`),
+     * `--label-frame` (`frame`), or nowhere (`none`, the cart stays labelless).
+     */
+    readonly labelSource: LabelSource;
+    /** Removes the throwaway copy (if one was made). Best-effort, idempotent. */
+    readonly cleanup: () => void;
+}
+/** A label-preparation failure, shaped for incur's `error({...})`. */
+export interface LabelCartFailure {
+    readonly ok: false;
+    readonly code: string;
+    readonly message: string;
+    readonly cta?: {
+        description: string;
+        commands: {
+            command: string;
+            description: string;
+        }[];
+    };
+}
+/** The label flags `export` and `serve` share. */
+export interface LabelOptions {
+    /** `--label <png>`: an image (a run/playtest screenshot as-is, or 128x128). */
+    readonly label?: string;
+    /** `--label-frame <n>`: capture frame `n` of the running cart, no input. */
+    readonly labelFrame?: number;
+    /** The backstop for the `--label-frame` capture run. */
+    readonly backstopMs: number;
+}
+/**
+ * The `--label` / `--label-frame` step shared by `export` and `serve` (ADR-0013,
+ * ADR-0015, ADR-0016): give a labelless cart a `__label__` (the export splash)
+ * without an interactive F7 capture.
+ *
+ *  - `--label <png>`: decode an image (a `run`/`playtest` screenshot as-is, any
+ *    square integer multiple of 128x128, or any 128x128 PNG).
+ *  - `--label-frame <n>`: RUN the cart headlessly through the playtest drive
+ *    harness (ADR-0011) with NO input, advance `n` frames, screenshot that frame,
+ *    and decode it. Needs PICO-8 (`drive`); an arbitrary cart does not have to
+ *    cooperate, since the harness owns its frame loop.
+ *
+ * The two flags are mutually exclusive (`label-flags-conflict`). The user's cart
+ * is NEVER mutated: a labeled copy is written NEXT TO it (same dir, so
+ * `#include main.lua` still resolves) and the caller exports that, then calls
+ * `cleanup()`. A cart that ALREADY has a label wins (the flags are a fallback,
+ * not an override): it is returned untouched and nothing is run.
+ *
+ * @param drive the adapter's `drive`, only called for `--label-frame`.
+ */
+export declare function prepareLabeledCart(cartPath: string, options: LabelOptions, drive: (options: DriveOptions) => Promise<Pico8DriveResult>): Promise<LabeledCart | LabelCartFailure>;
+//# sourceMappingURL=label-cart.d.ts.map

package/dist/commands/label-cart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-cart.d.ts","sourceRoot":"","sources":["../../src/commands/label-cart.ts"],"names":[],"mappings":"AAWA,OAAO,EAGN,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,MAAM,0BAA0B,CAAC;AAGlC;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;;CAezB,CAAC;AAEF,uDAAuD;AACvD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9D,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAC,EAAE,CAAC;KACnD,CAAC;CACF;AAED,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC5B;AAKD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,kBAAkB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,gBAAgB,CAAC,GACzD,OAAO,CAAC,WAAW,GAAG,gBAAgB,CAAC,CAwGzC"}

package/dist/commands/label-cart.js

@@ -0,0 +1,228 @@
+import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync, } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { Cart, CartParseError } from '../engine/cart/index.js';
+import { labelHexFromPng, LabelError } from '../engine/gfx/index.js';
+import { buildDriveHarness, DriveError, } from '../engine/pico8/index.js';
+import { makeReadInclude } from './cart-includes.js';
+/**
+ * The remedy for both label-image errors (`label-wrong-size`,
+ * `label-unsupported-png`): the screenshot `run`/`playtest` already wrote is a
+ * valid label as-is, so point at that rather than at an external image tool.
+ */
+export const LABEL_FIX_CTA = {
+    description: 'Pass a picopilot screenshot directly; it is scaled for you (any 128*k square: 128x128, 256x256, 384x384, ...). No image tool needed:',
+    commands: [
+        {
+            command: 'run <cart> --shot-dir shots',
+            description: 'Capture a frame (the cart calls extcmd("screen")), then pass shots/<name>.png to --label unchanged.',
+        },
+        {
+            command: 'export <cart> <dest> --label shots/<name>.png',
+            description: 'Bake that screenshot in as the label splash (`serve --label` takes it the same way). playtest screenshots work too.',
+        },
+    ],
+};
+/** The base filename the `--label-frame` capture names its screenshot. */
+const LABEL_FRAME_BASENAME = 'label';
+/**
+ * The `--label` / `--label-frame` step shared by `export` and `serve` (ADR-0013,
+ * ADR-0015, ADR-0016): give a labelless cart a `__label__` (the export splash)
+ * without an interactive F7 capture.
+ *
+ *  - `--label <png>`: decode an image (a `run`/`playtest` screenshot as-is, any
+ *    square integer multiple of 128x128, or any 128x128 PNG).
+ *  - `--label-frame <n>`: RUN the cart headlessly through the playtest drive
+ *    harness (ADR-0011) with NO input, advance `n` frames, screenshot that frame,
+ *    and decode it. Needs PICO-8 (`drive`); an arbitrary cart does not have to
+ *    cooperate, since the harness owns its frame loop.
+ *
+ * The two flags are mutually exclusive (`label-flags-conflict`). The user's cart
+ * is NEVER mutated: a labeled copy is written NEXT TO it (same dir, so
+ * `#include main.lua` still resolves) and the caller exports that, then calls
+ * `cleanup()`. A cart that ALREADY has a label wins (the flags are a fallback,
+ * not an override): it is returned untouched and nothing is run.
+ *
+ * @param drive the adapter's `drive`, only called for `--label-frame`.
+ */
+export async function prepareLabeledCart(cartPath, options, drive) {
+    const keep = (labelSource) => ({
+        ok: true,
+        cartPath,
+        labelSource,
+        cleanup: () => { },
+    });
+    if (options.label !== undefined && options.labelFrame !== undefined) {
+        return {
+            ok: false,
+            code: 'label-flags-conflict',
+            message: 'pass either --label <png> (an image) or --label-frame <n> (capture a frame of the running cart), not both',
+        };
+    }
+    // With no label flag the cart is only read to REPORT `labelSource`; anything
+    // odd about it (unreadable, unparseable) is left for PICO-8 to judge, exactly
+    // as before the label flags existed.
+    const noFlag = options.label === undefined && options.labelFrame === undefined;
+    let cart;
+    try {
+        cart = Cart.parse(readFileSync(cartPath, 'utf8'));
+    }
+    catch (e) {
+        if (noFlag)
+            return keep('none');
+        if (e instanceof CartParseError) {
+            return {
+                ok: false,
+                code: `cart-${e.code}`,
+                message: `could not parse the cart to inject a label: ${e.message}`,
+            };
+        }
+        throw e;
+    }
+    const existingLabel = cart.getSection('label');
+    if (existingLabel !== undefined && existingLabel.trim() !== '') {
+        return keep('cart');
+    }
+    let png;
+    let labelSource;
+    if (options.label !== undefined) {
+        const labelPath = isAbsolute(options.label)
+            ? options.label
+            : resolve(process.cwd(), options.label);
+        if (!existsSync(labelPath)) {
+            return {
+                ok: false,
+                code: 'label-not-found',
+                message: `no label image at ${labelPath}`,
+            };
+        }
+        png = readFileSync(labelPath);
+        labelSource = 'image';
+    }
+    else if (options.labelFrame !== undefined) {
+        const captured = await captureFrame(cartPath, options.labelFrame, options.backstopMs, drive);
+        if (!captured.ok)
+            return captured;
+        png = captured.png;
+        labelSource = 'frame';
+    }
+    else {
+        return keep('none');
+    }
+    let hex;
+    try {
+        hex = labelHexFromPng(png);
+    }
+    catch (e) {
+        if (e instanceof LabelError) {
+            return {
+                ok: false,
+                code: `label-${e.code}`,
+                message: e.message,
+                cta: LABEL_FIX_CTA,
+            };
+        }
+        throw e;
+    }
+    cart.setSection('label', hex);
+    const copy = join(dirname(cartPath), `.picopilot-export-${process.pid}-${Date.now()}.p8`);
+    writeFileSync(copy, cart.serialize());
+    return {
+        ok: true,
+        cartPath: copy,
+        labelSource,
+        cleanup: () => {
+            try {
+                rmSync(copy, { force: true });
+            }
+            catch {
+                // A leftover dotfile is not fatal.
+            }
+        },
+    };
+}
+/**
+ * Runs the cart through the playtest drive harness with NO input for `frame + 1`
+ * frames, screenshotting after frame `frame` (0 = the first drawn frame), and
+ * returns that PNG. The driven cart and PICO-8's screenshot dir live in a temp
+ * dir that is removed before returning.
+ */
+async function captureFrame(cartPath, frame, backstopMs, drive) {
+    let harness;
+    try {
+        harness = buildDriveHarness(readFileSync(cartPath, 'utf8'), {
+            presses: [],
+            frames: frame + 1,
+            shotFrames: [frame],
+            shotBasename: LABEL_FRAME_BASENAME,
+            readInclude: makeReadInclude(cartPath),
+        });
+    }
+    catch (e) {
+        if (e instanceof DriveError) {
+            return { ok: false, code: e.code, message: e.message };
+        }
+        throw e;
+    }
+    const shotDir = mkdtempSync(join(tmpdir(), 'picopilot-label-frame-'));
+    try {
+        const drivenCart = join(shotDir, 'driven.p8');
+        writeFileSync(drivenCart, harness.cartText);
+        const result = await drive({
+            cartPath: drivenCart,
+            shotDir,
+            blocks: harness.blocks,
+            backstopMs,
+        });
+        if (!result.ok) {
+            return {
+                ok: false,
+                code: result.reason,
+                message: `PICO-8 is not installed, so --label-frame cannot capture a frame. ${result.remedy} (needs: ${result.needs.join(', ')})`,
+            };
+        }
+        const shot = result.value.screenshots[0];
+        if (shot === undefined) {
+            const { exitReason } = result.value;
+            const tail = result.value.printh.trim().split('\n').slice(-5).join('\n');
+            const commands = [
+                {
+                    command: 'verify',
+                    description: 'Run the static gate (tokens + lint + integrity).',
+                },
+                {
+                    command: 'playtest start <cart>',
+                    description: 'Reproduce the SAME no-input frame to look at it: start a paused session (nothing held), then step and shoot.',
+                },
+                {
+                    command: `playtest step <id> --frames ${frame + 1}`,
+                    description: `Advance to frame ${frame}, as --label-frame ${frame} does.`,
+                },
+                {
+                    command: 'playtest shot <id>',
+                    description: 'Screenshot it; if it looks right, pass that PNG with --label <png> (then `playtest stop <id>`).',
+                },
+            ];
+            if (exitReason === 'timeout') {
+                commands.push({
+                    command: `export <cart> --label-frame ${frame} --backstop-ms <more>`,
+                    description: 'The capture hit the backstop (it runs about one frame per PICO-8 tick): allow more time, or pick an earlier frame.',
+                });
+            }
+            return {
+                ok: false,
+                code: 'label-frame-not-captured',
+                message: `the cart produced no frame ${frame} screenshot (exit: ${exitReason}).${tail === '' ? '' : ` Last output:\n${tail}`}`,
+                cta: {
+                    description: 'The cart did not reach that frame. Check it boots, or look at the frame first:',
+                    commands,
+                },
+            };
+        }
+        return { ok: true, png: readFileSync(shot) };
+    }
+    finally {
+        rmSync(shotDir, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=label-cart.js.map

package/dist/commands/label-cart.js.map

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

package/dist/commands/lint.d.ts

@@ -1,7 +1,7 @@
 import { type Cli } from 'incur';
-import { type ShrinkoAdapter } from '../engine/shrinko/index.js';
+import { type ShrinkoAdapterFactory } from './shrinko-env.js';
 /** See {@link import('./tokens.js').ShrinkoAdapterFactory}: lint reuses the same seam. */
-export type ShrinkoAdapterFactory = (env: NodeJS.ProcessEnv) => ShrinkoAdapter;
+export type { ShrinkoAdapterFactory } from './shrinko-env.js';
 /**
  * Registers `picopilot lint` (US #4): surface PICO-8-specific issues (undefined
  * globals, unused/duplicate locals, and, via the parsed findings, the classic

package/dist/commands/lint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/commands/lint.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,KAAK,GAAG,EAAI,MAAM,OAAO,CAAC;AAClC,OAAO,EACN,KAAK,cAAc,EAEnB,MAAM,4BAA4B,CAAC;AAEpC,0FAA0F;AAC1F,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,cAAc,CAAC;AAK/E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC3B,GAAG,EAAE,GAAG,CAAC,GAAG,EACZ,cAAc,GAAE,qBAA6C,GAC3D,IAAI,CAqFN"}
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/commands/lint.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,KAAK,GAAG,EAAI,MAAM,OAAO,CAAC;AAElC,OAAO,EAEN,KAAK,qBAAqB,EAC1B,MAAM,kBAAkB,CAAC;AAE1B,0FAA0F;AAC1F,YAAY,EAAC,qBAAqB,EAAC,MAAM,kBAAkB,CAAC;AAK5D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC3B,GAAG,EAAE,GAAG,CAAC,GAAG,EACZ,cAAc,GAAE,qBAA6C,GAC3D,IAAI,CAqFN"}

package/dist/commands/lint.js

@@ -1,8 +1,9 @@
 import { existsSync } from 'node:fs';
 import { isAbsolute, resolve } from 'node:path';
 import { z } from 'incur';
-import { ShellShrinkoAdapter, } from '../engine/shrinko/index.js';
-const defaultAdapterFactory = (env) => new ShellShrinkoAdapter({ env });
+import {} from '../engine/shrinko/index.js';
+import { createShellShrinkoFactory, } from './shrinko-env.js';
+const defaultAdapterFactory = createShellShrinkoFactory();
 /**
  * Registers `picopilot lint` (US #4): surface PICO-8-specific issues (undefined
  * globals, unused/duplicate locals, and, via the parsed findings, the classic

package/dist/commands/lint.js.map

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

package/dist/commands/minify.d.ts

@@ -1,7 +1,7 @@
 import { type Cli } from 'incur';
-import { type ShrinkoAdapter } from '../engine/shrinko/index.js';
+import { type ShrinkoAdapterFactory } from './shrinko-env.js';
 /** See {@link import('./tokens.js').ShrinkoAdapterFactory}: minify reuses the same seam. */
-export type ShrinkoAdapterFactory = (env: NodeJS.ProcessEnv) => ShrinkoAdapter;
+export type { ShrinkoAdapterFactory } from './shrinko-env.js';
 /**
  * Registers `picopilot minify` (US #5, ADR-0007): run shrinko8's SAFE
  * minification and write the result to a SEPARATE artifact (`<name>.min.p8` by

package/dist/commands/minify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"minify.d.ts","sourceRoot":"","sources":["../../src/commands/minify.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,KAAK,GAAG,EAAI,MAAM,OAAO,CAAC;AAClC,OAAO,EACN,KAAK,cAAc,EAEnB,MAAM,4BAA4B,CAAC;AAEpC,4FAA4F;AAC5F,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,cAAc,CAAC;AAoB/E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC7B,GAAG,EAAE,GAAG,CAAC,GAAG,EACZ,cAAc,GAAE,qBAA6C,GAC3D,IAAI,CA6GN"}
+{"version":3,"file":"minify.d.ts","sourceRoot":"","sources":["../../src/commands/minify.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,KAAK,GAAG,EAAI,MAAM,OAAO,CAAC;AAElC,OAAO,EAEN,KAAK,qBAAqB,EAC1B,MAAM,kBAAkB,CAAC;AAE1B,4FAA4F;AAC5F,YAAY,EAAC,qBAAqB,EAAC,MAAM,kBAAkB,CAAC;AAoB5D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC7B,GAAG,EAAE,GAAG,CAAC,GAAG,EACZ,cAAc,GAAE,qBAA6C,GAC3D,IAAI,CA6GN"}

package/dist/commands/minify.js

@@ -1,8 +1,9 @@
 import { existsSync } from 'node:fs';
 import { dirname, isAbsolute, join, resolve } from 'node:path';
 import { z } from 'incur';
-import { ShellShrinkoAdapter, } from '../engine/shrinko/index.js';
-const defaultAdapterFactory = (env) => new ShellShrinkoAdapter({ env });
+import {} from '../engine/shrinko/index.js';
+import { createShellShrinkoFactory, } from './shrinko-env.js';
+const defaultAdapterFactory = createShellShrinkoFactory();
 /**
  * Derives the default output path `<name>.min.p8` next to the source cart:
  * `main.p8` -> `main.min.p8`, `game.p8.png` -> `game.min.p8.png` is NOT the

package/dist/commands/minify.js.map

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

package/dist/commands/pico8-env.d.ts

@@ -0,0 +1,76 @@
+import { z } from 'incur';
+import { type DisplayMode, type Pico8Adapter, type SpawnRunner, type VirtualDisplayDeps } from '../engine/pico8/index.js';
+/**
+ * The env schema every PICO-8-gated command declares. These are the values
+ * picopilot itself RESOLVES (incur reads them from its env source, which tests
+ * override); they are NOT the whole child environment. The child gets the
+ * parent environment with these overlaid ({@link pico8ChildEnv}), so PICO-8
+ * still sees DISPLAY, HOME, XDG_RUNTIME_DIR, SDL_* and the rest.
+ */
+export declare const PICO8_ENV: z.ZodObject<{
+    PICO8_PATH: z.ZodOptional<z.ZodString>;
+    PATH: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** What a command knows beyond the env when it builds an adapter. */
+export interface Pico8AdapterContext {
+    /** The resolved display mode for `-run` sessions (ADR-0017). */
+    readonly display: DisplayMode;
+}
+/**
+ * Injects the PICO-8 adapter a command uses. A test passes a stub to drive the
+ * sentinel/backstop/absent paths without the paid binary; the default is
+ * {@link createShellAdapterFactory}.
+ */
+export type Pico8AdapterFactory = (env: NodeJS.ProcessEnv, context?: Pico8AdapterContext) => Pico8Adapter;
+/** Dependencies for {@link createShellAdapterFactory}, injectable for tests. */
+export interface ShellAdapterFactoryDeps {
+    /** The parent environment PICO-8 inherits (defaults to `process.env`). */
+    readonly parentEnv?: NodeJS.ProcessEnv;
+    /** The PICO-8 spawn seam (defaults to the real spawn). */
+    readonly spawn?: SpawnRunner;
+    /** The virtual-display seam (Xvfb lookup + spawn). */
+    readonly virtualDisplay?: VirtualDisplayDeps;
+}
+/**
+ * The default adapter factory: the shell adapter over the user's PICO-8, with
+ * the child env = parent env + the command's resolved values, and the display
+ * mode from the context.
+ */
+export declare function createShellAdapterFactory(deps?: ShellAdapterFactoryDeps): Pico8AdapterFactory;
+/**
+ * The display mode a command handler sees. The root middleware in `createCli`
+ * resolves it (flag > env > config > default) into the `display` var; a command
+ * mounted on a bare CLI (some tests) has no var and gets the default.
+ */
+export declare function displayModeOf(vars: unknown): DisplayMode;
+/**
+ * The `error(...)` payload for a `display-unavailable` result (ADR-0017): the
+ * session needs a display, there is none, and no Xvfb is installed to provide a
+ * virtual one. The message and CTA name the fix, so the agent never has to
+ * discover it by a silent timeout.
+ */
+export declare function displayUnavailableError(what: string, result: {
+    detail: string;
+    remedy: string;
+}): {
+    code: "display-unavailable";
+    message: string;
+    exitCode: number;
+    cta: {
+        description: string;
+        commands: {
+            command: string;
+            description: string;
+        }[];
+    };
+};
+/** The `error(...)` payload for a `pico8-not-found` result (the exact remedy + needs). */
+export declare function pico8NotFoundError(result: {
+    remedy: string;
+    needs: readonly string[];
+}): {
+    code: "pico8-not-found";
+    message: string;
+    exitCode: number;
+};
+//# sourceMappingURL=pico8-env.d.ts.map

package/dist/commands/pico8-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pico8-env.d.ts","sourceRoot":"","sources":["../../src/commands/pico8-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,OAAO,CAAC;AACxB,OAAO,EAEN,KAAK,WAAW,EAEhB,KAAK,YAAY,EAGjB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,MAAM,0BAA0B,CAAC;AAElC;;;;;;GAMG;AACH,eAAO,MAAM,SAAS;;;iBAMpB,CAAC;AAEH,qEAAqE;AACrE,MAAM,WAAW,mBAAmB;IACnC,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,CACjC,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,OAAO,CAAC,EAAE,mBAAmB,KACzB,YAAY,CAAC;AAElB,gFAAgF;AAChF,MAAM,WAAW,uBAAuB;IACvC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACvC,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,cAAc,CAAC,EAAE,kBAAkB,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACxC,IAAI,GAAE,uBAA4B,GAChC,mBAAmB,CAWrB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CAMxD;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACtC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC;;;;;;;;;;;EAiBxC;AAED,0FAA0F;AAC1F,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACzB;;;;EAMA"}

package/dist/commands/pico8-env.js

@@ -0,0 +1,71 @@
+import { z } from 'incur';
+import { DEFAULT_DISPLAY_MODE, isDisplayMode, pico8ChildEnv, ShellPico8Adapter, } from '../engine/pico8/index.js';
+/**
+ * The env schema every PICO-8-gated command declares. These are the values
+ * picopilot itself RESOLVES (incur reads them from its env source, which tests
+ * override); they are NOT the whole child environment. The child gets the
+ * parent environment with these overlaid ({@link pico8ChildEnv}), so PICO-8
+ * still sees DISPLAY, HOME, XDG_RUNTIME_DIR, SDL_* and the rest.
+ */
+export const PICO8_ENV = z.object({
+    PICO8_PATH: z
+        .string()
+        .optional()
+        .describe('Explicit path to the PICO-8 binary (else `pico8` on PATH).'),
+    PATH: z.string().optional().describe('Used to locate `pico8`.'),
+});
+/**
+ * The default adapter factory: the shell adapter over the user's PICO-8, with
+ * the child env = parent env + the command's resolved values, and the display
+ * mode from the context.
+ */
+export function createShellAdapterFactory(deps = {}) {
+    return (env, context) => new ShellPico8Adapter({
+        env: pico8ChildEnv(env, deps.parentEnv ?? process.env),
+        spawn: deps.spawn,
+        display: context?.display ?? DEFAULT_DISPLAY_MODE,
+        virtualDisplay: deps.virtualDisplay,
+    });
+}
+/**
+ * The display mode a command handler sees. The root middleware in `createCli`
+ * resolves it (flag > env > config > default) into the `display` var; a command
+ * mounted on a bare CLI (some tests) has no var and gets the default.
+ */
+export function displayModeOf(vars) {
+    const value = vars !== null && typeof vars === 'object'
+        ? vars.display
+        : undefined;
+    return isDisplayMode(value) ? value : DEFAULT_DISPLAY_MODE;
+}
+/**
+ * The `error(...)` payload for a `display-unavailable` result (ADR-0017): the
+ * session needs a display, there is none, and no Xvfb is installed to provide a
+ * virtual one. The message and CTA name the fix, so the agent never has to
+ * discover it by a silent timeout.
+ */
+export function displayUnavailableError(what, result) {
+    return {
+        code: 'display-unavailable',
+        message: `${what} needs a display (a real audio+video -run session): ${result.detail}. Remedy: ${result.remedy}.`,
+        exitCode: 1,
+        cta: {
+            description: `No display and no Xvfb on this machine. Fix: ${result.remedy}. Then re-run; picopilot starts a private virtual display by itself (--display auto). Check what this machine can do:`,
+            commands: [
+                {
+                    command: 'doctor',
+                    description: 'Report PICO-8, shrinko8 and display capabilities, and which commands are available here.',
+                },
+            ],
+        },
+    };
+}
+/** The `error(...)` payload for a `pico8-not-found` result (the exact remedy + needs). */
+export function pico8NotFoundError(result) {
+    return {
+        code: 'pico8-not-found',
+        message: `PICO-8 is not installed. ${result.remedy} (needs: ${result.needs.join(', ')})`,
+        exitCode: 1,
+    };
+}
+//# sourceMappingURL=pico8-env.js.map

package/dist/commands/pico8-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pico8-env.js","sourceRoot":"","sources":["../../src/commands/pico8-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,OAAO,CAAC;AACxB,OAAO,EACN,oBAAoB,EAEpB,aAAa,EAEb,aAAa,EACb,iBAAiB,GAGjB,MAAM,0BAA0B,CAAC;AAElC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,UAAU,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4DAA4D,CAAC;IACxE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CAC/D,CAAC,CAAC;AA4BH;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACxC,OAAgC,EAAE;IAElC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CACvB,IAAI,iBAAiB,CAAC;QACrB,GAAG,EAAE,aAAa,CACjB,GAAyC,EACzC,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAC7B;QACD,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,oBAAoB;QACjD,cAAc,EAAE,IAAI,CAAC,cAAc;KACnC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAa;IAC1C,MAAM,KAAK,GACV,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QACxC,CAAC,CAAE,IAA4B,CAAC,OAAO;QACvC,CAAC,CAAC,SAAS,CAAC;IACd,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,oBAAoB,CAAC;AAC5D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACtC,IAAY,EACZ,MAAwC;IAExC,OAAO;QACN,IAAI,EAAE,qBAA8B;QACpC,OAAO,EAAE,GAAG,IAAI,uDAAuD,MAAM,CAAC,MAAM,aAAa,MAAM,CAAC,MAAM,GAAG;QACjH,QAAQ,EAAE,CAAC;QACX,GAAG,EAAE;YACJ,WAAW,EAAE,gDAAgD,MAAM,CAAC,MAAM,uHAAuH;YACjM,QAAQ,EAAE;gBACT;oBACC,OAAO,EAAE,QAAQ;oBACjB,WAAW,EACV,0FAA0F;iBAC3F;aACD;SACD;KACD,CAAC;AACH,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,kBAAkB,CAAC,MAGlC;IACA,OAAO;QACN,IAAI,EAAE,iBAA0B;QAChC,OAAO,EAAE,4BAA4B,MAAM,CAAC,MAAM,YAAY,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QACxF,QAAQ,EAAE,CAAC;KACX,CAAC;AACH,CAAC"}

package/dist/commands/playtest.d.ts

@@ -1,12 +1,12 @@
 import { type Cli } from 'incur';
-import { type Pico8Adapter } from '../engine/pico8/index.js';
+import { type Pico8AdapterFactory } from './pico8-env.js';
 /**
  * Injects the PICO-8 adapter `playtest` uses (defaults to the shell adapter over
  * native `pico8 -x`). Mirrors `run`'s `Pico8AdapterFactory` seam: a test passes a
  * stub to drive the drive-orchestration + the absent path WITHOUT the paid
  * binary, and to isolate the child `env` (its `PICO8_PATH`/`PATH`).
  */
-export type Pico8AdapterFactory = (env: NodeJS.ProcessEnv) => Pico8Adapter;
+export type { Pico8AdapterFactory } from './pico8-env.js';
 /**
  * Registers `picopilot playtest`, the driven-playtest command group (ADR-0011).
  * The ROOT command (`playtest <cart>`) is the ONE-SHOT driver (US #1-5,7-11): it

package/dist/commands/playtest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playtest.d.ts","sourceRoot":"","sources":["../../src/commands/playtest.ts"],"names":[],"mappings":"AASA,OAAO,EAAC,KAAK,GAAG,EAAqB,MAAM,OAAO,CAAC;AACnD,OAAO,EAMN,KAAK,YAAY,EAajB,MAAM,0BAA0B,CAAC;AAElC;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,YAAY,CAAC;AAiD3E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,GAAG,CAAC,GAAG,EACZ,cAAc,GAAE,mBAA2C,GACzD,IAAI,CAEN"}
+{"version":3,"file":"playtest.d.ts","sourceRoot":"","sources":["../../src/commands/playtest.ts"],"names":[],"mappings":"AASA,OAAO,EAAC,KAAK,GAAG,EAAqB,MAAM,OAAO,CAAC;AAoBnD,OAAO,EAGN,KAAK,mBAAmB,EACxB,MAAM,gBAAgB,CAAC;AAGxB;;;;;GAKG;AACH,YAAY,EAAC,mBAAmB,EAAC,MAAM,gBAAgB,CAAC;AA0BxD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,GAAG,CAAC,GAAG,EACZ,cAAc,GAAE,mBAA2C,GACzD,IAAI,CAEN"}