picopilot 0.0.0 → 0.1.0

package/dist/cli.d.ts

@@ -0,0 +1,15 @@
+import { Cli } from 'incur';
+/**
+ * Builds the root picopilot CLI.
+ *
+ * One `Cli.create()` definition yields the CLI, an MCP server, auto-installable
+ * skills, TOON output, Zod schemas, CTAs, and the structured error envelope.
+ * Command groups are mounted here through their `register*` helpers; each group
+ * owns its own module under `src/commands/` and its engine under `src/engine/`,
+ * so later tasks add a line here without restructuring.
+ *
+ * Exposed as a factory (not a module-level singleton) so tests can build a fresh
+ * CLI and drive it with `cli.serve(argv, { stdout, exit, env })` DI overrides.
+ */
+export declare function createCli(): Cli.Cli;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,EAAC,MAAM,OAAO,CAAC;AAiB1B;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,IAAI,GAAG,CAAC,GAAG,CA+BnC"}

package/dist/cli.js

@@ -0,0 +1,59 @@
+import { Cli } from 'incur';
+import { registerAudio } from './commands/audio.js';
+import { registerExport } from './commands/export.js';
+import { registerGfx } from './commands/gfx.js';
+import { registerInit } from './commands/init.js';
+import { registerLint } from './commands/lint.js';
+import { registerMinify } from './commands/minify.js';
+import { registerMusic } from './commands/music.js';
+import { registerPlaytest } from './commands/playtest.js';
+import { registerRun } from './commands/run.js';
+import { registerServe } from './commands/serve.js';
+import { registerSfx } from './commands/sfx.js';
+import { registerTokens } from './commands/tokens.js';
+import { registerVerify } from './commands/verify.js';
+import { registerVersion } from './commands/version.js';
+import { VERSION } from './version.js';
+/**
+ * Builds the root picopilot CLI.
+ *
+ * One `Cli.create()` definition yields the CLI, an MCP server, auto-installable
+ * skills, TOON output, Zod schemas, CTAs, and the structured error envelope.
+ * Command groups are mounted here through their `register*` helpers; each group
+ * owns its own module under `src/commands/` and its engine under `src/engine/`,
+ * so later tasks add a line here without restructuring.
+ *
+ * Exposed as a factory (not a module-level singleton) so tests can build a fresh
+ * CLI and drive it with `cli.serve(argv, { stdout, exit, env })` DI overrides.
+ */
+export function createCli() {
+    const cli = Cli.create('picopilot', {
+        version: VERSION,
+        description: 'An agent-first toolchain for PICO-8 game development.',
+        // `depth: 1` yields one skill file per top-level command group (US #20).
+        sync: {
+            depth: 1,
+        },
+        // Per-cart policy config (e.g. `allowMapOverlap`); precedence argv > config > defaults.
+        config: {
+            flag: 'config',
+            files: ['picopilot.json'],
+        },
+    });
+    registerVersion(cli);
+    registerInit(cli);
+    registerGfx(cli);
+    registerTokens(cli);
+    registerLint(cli);
+    registerMinify(cli);
+    registerVerify(cli);
+    registerRun(cli);
+    registerExport(cli);
+    registerServe(cli);
+    registerPlaytest(cli);
+    registerSfx(cli);
+    registerMusic(cli);
+    registerAudio(cli);
+    return cli;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,EAAC,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAC,gBAAgB,EAAC,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAC,OAAO,EAAC,MAAM,cAAc,CAAC;AAErC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS;IACxB,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,uDAAuD;QACpE,yEAAyE;QACzE,IAAI,EAAE;YACL,KAAK,EAAE,CAAC;SACR;QACD,wFAAwF;QACxF,MAAM,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,CAAC,gBAAgB,CAAC;SACzB;KACD,CAAC,CAAC;IAEH,eAAe,CAAC,GAAG,CAAC,CAAC;IACrB,YAAY,CAAC,GAAG,CAAC,CAAC;IAClB,WAAW,CAAC,GAAG,CAAC,CAAC;IACjB,cAAc,CAAC,GAAG,CAAC,CAAC;IACpB,YAAY,CAAC,GAAG,CAAC,CAAC;IAClB,cAAc,CAAC,GAAG,CAAC,CAAC;IACpB,cAAc,CAAC,GAAG,CAAC,CAAC;IACpB,WAAW,CAAC,GAAG,CAAC,CAAC;IACjB,cAAc,CAAC,GAAG,CAAC,CAAC;IACpB,aAAa,CAAC,GAAG,CAAC,CAAC;IACnB,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACtB,WAAW,CAAC,GAAG,CAAC,CAAC;IACjB,aAAa,CAAC,GAAG,CAAC,CAAC;IACnB,aAAa,CAAC,GAAG,CAAC,CAAC;IAEnB,OAAO,GAAG,CAAC;AACZ,CAAC"}

package/dist/commands/audio.d.ts

@@ -0,0 +1,17 @@
+import { Cli } from 'incur';
+import { type Pico8Adapter } from '../engine/pico8/index.js';
+/**
+ * Injects the PICO-8 adapter the audio commands use (defaults to the shell
+ * adapter over native `pico8 -run`). Mirrors `run`'s `Pico8AdapterFactory` seam:
+ * a test passes a fake to drive the record orchestration + the absent path
+ * WITHOUT the paid binary, and to isolate the child `env`.
+ */
+export type Pico8AdapterFactory = (env: NodeJS.ProcessEnv) => Pico8Adapter;
+/**
+ * Registers the `audio` command group (`audio record`, `audio render`) on the
+ * root CLI. PICO-8-gated (ADR-0009): audio-to-WAV is a record of a running
+ * session, never an offline export. `adapterFactory` is injected so tests drive
+ * the orchestration against a fake runner (no paid binary in CI).
+ */
+export declare function registerAudio(cli: Cli.Cli, adapterFactory?: Pico8AdapterFactory): void;
+//# sourceMappingURL=audio.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../src/commands/audio.ts"],"names":[],"mappings":"AASA,OAAO,EAAC,GAAG,EAAI,MAAM,OAAO,CAAC;AAE7B,OAAO,EAKN,KAAK,YAAY,EAGjB,MAAM,0BAA0B,CAAC;AAElC;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,YAAY,CAAC;AAmX3E;;;;;GAKG;AACH,wBAAgB,aAAa,CAC5B,GAAG,EAAE,GAAG,CAAC,GAAG,EACZ,cAAc,GAAE,mBAA2C,GACzD,IAAI,CAEN"}

package/dist/commands/audio.js

@@ -0,0 +1,315 @@
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, writeFileSync, } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { isAbsolute, join, resolve } from 'node:path';
+import { Cli, z } from 'incur';
+import { buildRecordHarness, buildRenderHarness, DONE_SENTINEL, HarnessError, ShellPico8Adapter, } from '../engine/pico8/index.js';
+const defaultAdapterFactory = (env) => new ShellPico8Adapter({ env });
+/**
+ * The default record backstop: kill a capture that never signals after this many
+ * ms. Larger than `run`'s default because a record window is a real-time playback
+ * (up to several seconds) plus PICO-8 startup, not a quick screenshot pass.
+ */
+const DEFAULT_BACKSTOP_MS = 30_000;
+/** The honest one-liner both `record` and `render` carry (ADR-0009): not offline. */
+const HONEST_CAVEAT = 'This is a REAL-TIME recording of playback (needs a real audio+video session, not headless), NOT a deterministic offline export.';
+/** Resolves a path argument to an absolute path (relative to cwd). */
+function resolvePath(p) {
+    return isAbsolute(p) ? p : resolve(process.cwd(), p);
+}
+/**
+ * Chooses (and creates) the isolated dir PICO-8 records the WAV into. Because
+ * `extcmd("audio_end", 1)` writes to PICO-8's CURRENT folder (steered via
+ * `-root_path`), the WAV MUST land here, never `~/Desktop` or the carts root
+ * (the shared-write discipline, the `audio_end(1)` trap). A user-given path is
+ * honoured; otherwise a fresh temp dir.
+ */
+function chooseWavDir(given) {
+    const dir = given !== undefined
+        ? isAbsolute(given)
+            ? given
+            : resolve(process.cwd(), given)
+        : mkdtempSync(join(tmpdir(), 'picopilot-audio-'));
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    return dir;
+}
+/** The env schema both audio subcommands share (locates the binary, in isolation). */
+const AUDIO_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 structured output shape shared by `record` and `render`. */
+const AUDIO_OUTPUT = z.object({
+    wav: z
+        .string()
+        .optional()
+        .describe('Absolute path of the recorded WAV, or omitted if no audio was captured (e.g. a headless session with no audio device).'),
+    captured: z
+        .boolean()
+        .describe('Whether a non-empty WAV was captured (false = silent/empty run).'),
+    exitReason: z
+        .enum(['sentinel', 'timeout', 'exit'])
+        .describe('sentinel = the harness signalled done; timeout = backstop fired; exit = PICO-8 quit.'),
+    target: z
+        .string()
+        .describe('What was recorded (the running cart, or the render target).'),
+    seconds: z
+        .number()
+        .describe('The record window in seconds the capture ran for.'),
+    printh: z.string().describe('Captured stdout from the session.'),
+});
+/** The message a `pico8-not-found` error carries (mirrors `run`): exact remedy + needs. */
+function pico8NotFoundMessage(notFound) {
+    return `PICO-8 is not installed. ${notFound.remedy} (needs: ${notFound.needs.join(', ')})`;
+}
+/**
+ * The advisory CTA when a record/render run captured NO audio (a headless /
+ * no-audio-device session): the orchestration worked, there is just nothing to
+ * hear (ADR-0009's live-tier caveat), so it is a nudge, not a hard error.
+ */
+function noAudioCta(caveat) {
+    return {
+        description: `No audio was captured (${caveat}) Recording needs a real audio+video session:`,
+        commands: [
+            {
+                command: 'audio render --sfx <n>',
+                description: 'Run on a developer machine with a display + audio device (not headless CI).',
+            },
+        ],
+    };
+}
+/** Shapes an adapter record report into the structured output object. */
+function recordOutput(report, harness) {
+    return {
+        wav: report.wavPath,
+        captured: report.wavPath !== undefined,
+        exitReason: report.exitReason,
+        target: harness.description,
+        seconds: harness.seconds,
+        printh: report.printh,
+    };
+}
+/**
+ * Builds the `audio` command group: `audio record <cart>` (the record primitive)
+ * and `audio render` (US #13, the convenience harness over it). Both are
+ * PICO-8-gated (ADR-0009): PICO-8 absent returns the structured `pico8-not-found`
+ * + nonzero exit. Both are record-based, real-time captures, NOT offline exports.
+ */
+function buildAudioGroup(adapterFactory) {
+    const audio = Cli.create('audio', {
+        description: 'Get a WAV out of a cart by RECORDING a running session (ADR-0009). PICO-8 has no working offline WAV export, so both commands are REAL-TIME recordings that need a real audio+video session (not headless), NOT deterministic offline exports. Requires PICO-8.',
+    });
+    // --- audio record <cart> ---------------------------------------------------
+    audio.command('record', {
+        description: `Record a running cart's own audio to a WAV. Injects a throwaway cooperative recorder (audio_rec/audio_end) around the cart, runs it in a real A/V session, and returns the WAV path. ${HONEST_CAVEAT} Requires PICO-8.`,
+        args: z.object({
+            cart: z
+                .string()
+                .default('main.p8')
+                .describe('The .p8 cart to run and record. Defaults to main.p8 in the current folder.'),
+        }),
+        options: z.object({
+            seconds: z.coerce
+                .number()
+                .positive()
+                .default(8)
+                .describe('How long (seconds) to record the running cart.'),
+            wavDir: z
+                .string()
+                .optional()
+                .describe('Where PICO-8 writes the WAV. Defaults to an isolated temp dir; NEVER ~/Desktop or the carts root.'),
+            sentinel: z
+                .string()
+                .default(DONE_SENTINEL)
+                .describe('The stdout line that ends the recording.'),
+            backstopMs: z
+                .number()
+                .int()
+                .positive()
+                .default(DEFAULT_BACKSTOP_MS)
+                .describe('Safety backstop: kill PICO-8 after this many ms if it never signals.'),
+        }),
+        env: AUDIO_ENV,
+        output: AUDIO_OUTPUT,
+        examples: [
+            { description: 'Record 8 seconds of main.p8' },
+            {
+                description: 'Record a specific cart for 4 seconds',
+                args: { cart: 'game.p8' },
+                options: { seconds: 4 },
+            },
+        ],
+        async run({ args, options, env, error, ok }) {
+            const cartPath = resolvePath(args.cart);
+            if (!existsSync(cartPath)) {
+                return error({
+                    code: 'cart-not-found',
+                    message: `no cart at ${cartPath}`,
+                    exitCode: 1,
+                });
+            }
+            let harness;
+            try {
+                harness = buildRecordHarness(readFileSync(cartPath, 'utf8'), {
+                    seconds: options.seconds,
+                    sentinel: options.sentinel,
+                });
+            }
+            catch (e) {
+                if (e instanceof HarnessError) {
+                    return error({ code: e.code, message: e.message, exitCode: 1 });
+                }
+                throw e;
+            }
+            // The throwaway harness cart + the WAV both live in the isolated dir, so a
+            // record run never mutates the user's cart or writes outside the temp dir.
+            const wavDir = chooseWavDir(options.wavDir);
+            const harnessCart = join(wavDir, 'record-harness.p8');
+            writeFileSync(harnessCart, harness.cartText);
+            const adapter = adapterFactory(env);
+            const result = await adapter.record({
+                cartPath: harnessCart,
+                wavDir,
+                wavBasename: harness.wavBasename,
+                sentinel: options.sentinel,
+                backstopMs: options.backstopMs,
+            });
+            if (!result.ok) {
+                return error({
+                    code: 'pico8-not-found',
+                    message: pico8NotFoundMessage(result),
+                    exitCode: 1,
+                });
+            }
+            const out = recordOutput(result.value, harness);
+            return ok(out, out.captured ? undefined : { cta: noAudioCta(HONEST_CAVEAT) });
+        },
+    });
+    // --- audio render ----------------------------------------------------------
+    audio.command('render', {
+        description: `Render an authored target (sfx / music pattern / the whole song) to a WAV by injecting a play-harness, recording it, and returning the WAV path (US #13). The author writes NO playback code. ${HONEST_CAVEAT} With no --sfx/--pattern it renders the whole song (music 0). Requires PICO-8.`,
+        args: z.object({
+            cart: z
+                .string()
+                .default('main.p8')
+                .describe('The .p8 cart whose authored __sfx__/__music__ to render. Defaults to main.p8.'),
+        }),
+        options: z.object({
+            sfx: z.coerce
+                .number()
+                .int()
+                .min(0)
+                .max(63)
+                .optional()
+                .describe('Render this SFX slot (0-63). Mutually exclusive with --pattern.'),
+            pattern: z.coerce
+                .number()
+                .int()
+                .min(0)
+                .max(63)
+                .optional()
+                .describe('Render this music pattern (0-63). Mutually exclusive with --sfx.'),
+            seconds: z.coerce
+                .number()
+                .positive()
+                .optional()
+                .describe('Override the record window (seconds). Default: derived from the SFX speed+rows for --sfx, else 8s for a pattern/song.'),
+            wavDir: z
+                .string()
+                .optional()
+                .describe('Where PICO-8 writes the WAV. Defaults to an isolated temp dir; NEVER ~/Desktop or the carts root.'),
+            sentinel: z
+                .string()
+                .default(DONE_SENTINEL)
+                .describe('The stdout line that ends the recording.'),
+            backstopMs: z
+                .number()
+                .int()
+                .positive()
+                .default(DEFAULT_BACKSTOP_MS)
+                .describe('Safety backstop: kill PICO-8 after this many ms if it never signals.'),
+        }),
+        env: AUDIO_ENV,
+        output: AUDIO_OUTPUT,
+        examples: [
+            { description: 'Render the whole song (music 0) of main.p8' },
+            { description: 'Render SFX slot 5', options: { sfx: 5 } },
+            {
+                description: 'Render music pattern 2 of a cart for 6 seconds',
+                args: { cart: 'game.p8' },
+                options: { pattern: 2, seconds: 6 },
+            },
+        ],
+        async run({ args, options, env, error, ok }) {
+            if (options.sfx !== undefined && options.pattern !== undefined) {
+                return error({
+                    code: 'ambiguous-target',
+                    message: 'pass EITHER --sfx OR --pattern, not both (a render targets one of: an SFX slot, a music pattern, or the whole song).',
+                    exitCode: 1,
+                });
+            }
+            const target = options.sfx !== undefined
+                ? { kind: 'sfx', index: options.sfx }
+                : options.pattern !== undefined
+                    ? { kind: 'pattern', index: options.pattern }
+                    : { kind: 'song' };
+            const cartPath = resolvePath(args.cart);
+            if (!existsSync(cartPath)) {
+                return error({
+                    code: 'cart-not-found',
+                    message: `no cart at ${cartPath}`,
+                    exitCode: 1,
+                });
+            }
+            let harness;
+            try {
+                harness = buildRenderHarness(readFileSync(cartPath, 'utf8'), target, {
+                    seconds: options.seconds,
+                    sentinel: options.sentinel,
+                });
+            }
+            catch (e) {
+                if (e instanceof HarnessError) {
+                    // A target refusal (out-of-range / empty slot / bad cart): structured,
+                    // never a silent recording of silence.
+                    return error({ code: e.code, message: e.message, exitCode: 1 });
+                }
+                throw e;
+            }
+            const wavDir = chooseWavDir(options.wavDir);
+            const harnessCart = join(wavDir, 'render-harness.p8');
+            writeFileSync(harnessCart, harness.cartText);
+            const adapter = adapterFactory(env);
+            const result = await adapter.record({
+                cartPath: harnessCart,
+                wavDir,
+                wavBasename: harness.wavBasename,
+                sentinel: options.sentinel,
+                backstopMs: options.backstopMs,
+            });
+            if (!result.ok) {
+                return error({
+                    code: 'pico8-not-found',
+                    message: pico8NotFoundMessage(result),
+                    exitCode: 1,
+                });
+            }
+            const out = recordOutput(result.value, harness);
+            return ok(out, out.captured ? undefined : { cta: noAudioCta(HONEST_CAVEAT) });
+        },
+    });
+    return audio;
+}
+/**
+ * Registers the `audio` command group (`audio record`, `audio render`) on the
+ * root CLI. PICO-8-gated (ADR-0009): audio-to-WAV is a record of a running
+ * session, never an offline export. `adapterFactory` is injected so tests drive
+ * the orchestration against a fake runner (no paid binary in CI).
+ */
+export function registerAudio(cli, adapterFactory = defaultAdapterFactory) {
+    cli.command(buildAudioGroup(adapterFactory));
+}
+//# sourceMappingURL=audio.js.map

package/dist/commands/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../../src/commands/audio.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,UAAU,EACV,SAAS,EACT,WAAW,EACX,YAAY,EACZ,aAAa,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAC,MAAM,EAAC,MAAM,SAAS,CAAC;AAC/B,OAAO,EAAC,UAAU,EAAE,IAAI,EAAE,OAAO,EAAC,MAAM,WAAW,CAAC;AACpD,OAAO,EAAC,GAAG,EAAE,CAAC,EAAC,MAAM,OAAO,CAAC;AAE7B,OAAO,EACN,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,YAAY,EAGZ,iBAAiB,GACjB,MAAM,0BAA0B,CAAC;AAUlC,MAAM,qBAAqB,GAAwB,CAAC,GAAG,EAAE,EAAE,CAC1D,IAAI,iBAAiB,CAAC,EAAC,GAAG,EAAC,CAAC,CAAC;AAE9B;;;;GAIG;AACH,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEnC,qFAAqF;AACrF,MAAM,aAAa,GAClB,iIAAiI,CAAC;AAEnI,sEAAsE;AACtE,SAAS,WAAW,CAAC,CAAS;IAC7B,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,YAAY,CAAC,KAAyB;IAC9C,MAAM,GAAG,GACR,KAAK,KAAK,SAAS;QAClB,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC;YAClB,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC;QAChC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,SAAS,CAAC,GAAG,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC;IACxD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,sFAAsF;AACtF,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,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;AAEH,mEAAmE;AACnE,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,GAAG,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACR,wHAAwH,CACxH;IACF,QAAQ,EAAE,CAAC;SACT,OAAO,EAAE;SACT,QAAQ,CACR,kEAAkE,CAClE;IACF,UAAU,EAAE,CAAC;SACX,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;SACrC,QAAQ,CACR,sFAAsF,CACtF;IACF,MAAM,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,6DAA6D,CAAC;IACzE,OAAO,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,mDAAmD,CAAC;IAC/D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;CAChE,CAAC,CAAC;AAEH,2FAA2F;AAC3F,SAAS,oBAAoB,CAAC,QAG7B;IACA,OAAO,4BAA4B,QAAQ,CAAC,MAAM,YAAY,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAC5F,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU,CAAC,MAAc;IACjC,OAAO;QACN,WAAW,EAAE,0BAA0B,MAAM,+CAA+C;QAC5F,QAAQ,EAAE;YACT;gBACC,OAAO,EAAE,wBAAwB;gBACjC,WAAW,EACV,6EAA6E;aAC9E;SACD;KACD,CAAC;AACH,CAAC;AAED,yEAAyE;AACzE,SAAS,YAAY,CACpB,MAIC,EACD,OAA+C;IAE/C,OAAO;QACN,GAAG,EAAE,MAAM,CAAC,OAAO;QACnB,QAAQ,EAAE,MAAM,CAAC,OAAO,KAAK,SAAS;QACtC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,MAAM,EAAE,OAAO,CAAC,WAAW;QAC3B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,MAAM,CAAC,MAAM;KACrB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CAAC,cAAmC;IAC3D,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE;QACjC,WAAW,EACV,iQAAiQ;KAClQ,CAAC,CAAC;IAEH,8EAA8E;IAC9E,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE;QACvB,WAAW,EAAE,wLAAwL,aAAa,mBAAmB;QACrO,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,IAAI,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,OAAO,CAAC,SAAS,CAAC;iBAClB,QAAQ,CACR,4EAA4E,CAC5E;SACF,CAAC;QACF,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;YACjB,OAAO,EAAE,CAAC,CAAC,MAAM;iBACf,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,OAAO,CAAC,CAAC,CAAC;iBACV,QAAQ,CAAC,gDAAgD,CAAC;YAC5D,MAAM,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACR,mGAAmG,CACnG;YACF,QAAQ,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,OAAO,CAAC,aAAa,CAAC;iBACtB,QAAQ,CAAC,0CAA0C,CAAC;YACtD,UAAU,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,OAAO,CAAC,mBAAmB,CAAC;iBAC5B,QAAQ,CACR,sEAAsE,CACtE;SACF,CAAC;QACF,GAAG,EAAE,SAAS;QACd,MAAM,EAAE,YAAY;QACpB,QAAQ,EAAE;YACT,EAAC,WAAW,EAAE,6BAA6B,EAAC;YAC5C;gBACC,WAAW,EAAE,sCAAsC;gBACnD,IAAI,EAAE,EAAC,IAAI,EAAE,SAAS,EAAC;gBACvB,OAAO,EAAE,EAAC,OAAO,EAAE,CAAC,EAAC;aACrB;SACD;QACD,KAAK,CAAC,GAAG,CAAC,EAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAC;YACxC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3B,OAAO,KAAK,CAAC;oBACZ,IAAI,EAAE,gBAAgB;oBACtB,OAAO,EAAE,cAAc,QAAQ,EAAE;oBACjC,QAAQ,EAAE,CAAC;iBACX,CAAC,CAAC;YACJ,CAAC;YAED,IAAI,OAA8C,CAAC;YACnD,IAAI,CAAC;gBACJ,OAAO,GAAG,kBAAkB,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;oBAC5D,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;iBAC1B,CAAC,CAAC;YACJ,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACZ,IAAI,CAAC,YAAY,YAAY,EAAE,CAAC;oBAC/B,OAAO,KAAK,CAAC,EAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAC,CAAC,CAAC;gBAC/D,CAAC;gBACD,MAAM,CAAC,CAAC;YACT,CAAC;YAED,2EAA2E;YAC3E,2EAA2E;YAC3E,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;YACtD,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;YAE7C,MAAM,OAAO,GAAG,cAAc,CAAC,GAAwB,CAAC,CAAC;YACzD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC;gBACnC,QAAQ,EAAE,WAAW;gBACrB,MAAM;gBACN,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;aAC9B,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBAChB,OAAO,KAAK,CAAC;oBACZ,IAAI,EAAE,iBAAiB;oBACvB,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC;oBACrC,QAAQ,EAAE,CAAC;iBACX,CAAC,CAAC;YACJ,CAAC;YAED,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAChD,OAAO,EAAE,CACR,GAAG,EACH,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAC,GAAG,EAAE,UAAU,CAAC,aAAa,CAAC,EAAC,CAC3D,CAAC;QACH,CAAC;KACD,CAAC,CAAC;IAEH,8EAA8E;IAC9E,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE;QACvB,WAAW,EAAE,iMAAiM,aAAa,gFAAgF;QAC3S,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,IAAI,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,OAAO,CAAC,SAAS,CAAC;iBAClB,QAAQ,CACR,+EAA+E,CAC/E;SACF,CAAC;QACF,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;YACjB,GAAG,EAAE,CAAC,CAAC,MAAM;iBACX,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,EAAE,CAAC;iBACP,QAAQ,EAAE;iBACV,QAAQ,CACR,iEAAiE,CACjE;YACF,OAAO,EAAE,CAAC,CAAC,MAAM;iBACf,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,EAAE,CAAC;iBACP,QAAQ,EAAE;iBACV,QAAQ,CACR,kEAAkE,CAClE;YACF,OAAO,EAAE,CAAC,CAAC,MAAM;iBACf,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,EAAE;iBACV,QAAQ,CACR,uHAAuH,CACvH;YACF,MAAM,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACR,mGAAmG,CACnG;YACF,QAAQ,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,OAAO,CAAC,aAAa,CAAC;iBACtB,QAAQ,CAAC,0CAA0C,CAAC;YACtD,UAAU,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,OAAO,CAAC,mBAAmB,CAAC;iBAC5B,QAAQ,CACR,sEAAsE,CACtE;SACF,CAAC;QACF,GAAG,EAAE,SAAS;QACd,MAAM,EAAE,YAAY;QACpB,QAAQ,EAAE;YACT,EAAC,WAAW,EAAE,4CAA4C,EAAC;YAC3D,EAAC,WAAW,EAAE,mBAAmB,EAAE,OAAO,EAAE,EAAC,GAAG,EAAE,CAAC,EAAC,EAAC;YACrD;gBACC,WAAW,EAAE,gDAAgD;gBAC7D,IAAI,EAAE,EAAC,IAAI,EAAE,SAAS,EAAC;gBACvB,OAAO,EAAE,EAAC,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAC;aACjC;SACD;QACD,KAAK,CAAC,GAAG,CAAC,EAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAC;YACxC,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBAChE,OAAO,KAAK,CAAC;oBACZ,IAAI,EAAE,kBAAkB;oBACxB,OAAO,EACN,sHAAsH;oBACvH,QAAQ,EAAE,CAAC;iBACX,CAAC,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GACX,OAAO,CAAC,GAAG,KAAK,SAAS;gBACxB,CAAC,CAAC,EAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,EAAC;gBACnC,CAAC,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS;oBAC9B,CAAC,CAAC,EAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,EAAC;oBAC3C,CAAC,CAAC,EAAC,IAAI,EAAE,MAAM,EAAC,CAAC;YAEpB,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3B,OAAO,KAAK,CAAC;oBACZ,IAAI,EAAE,gBAAgB;oBACtB,OAAO,EAAE,cAAc,QAAQ,EAAE;oBACjC,QAAQ,EAAE,CAAC;iBACX,CAAC,CAAC;YACJ,CAAC;YAED,IAAI,OAA8C,CAAC;YACnD,IAAI,CAAC;gBACJ,OAAO,GAAG,kBAAkB,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE;oBACpE,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;iBAC1B,CAAC,CAAC;YACJ,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACZ,IAAI,CAAC,YAAY,YAAY,EAAE,CAAC;oBAC/B,uEAAuE;oBACvE,uCAAuC;oBACvC,OAAO,KAAK,CAAC,EAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAC,CAAC,CAAC;gBAC/D,CAAC;gBACD,MAAM,CAAC,CAAC;YACT,CAAC;YAED,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;YACtD,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;YAE7C,MAAM,OAAO,GAAG,cAAc,CAAC,GAAwB,CAAC,CAAC;YACzD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC;gBACnC,QAAQ,EAAE,WAAW;gBACrB,MAAM;gBACN,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;aAC9B,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBAChB,OAAO,KAAK,CAAC;oBACZ,IAAI,EAAE,iBAAiB;oBACvB,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC;oBACrC,QAAQ,EAAE,CAAC;iBACX,CAAC,CAAC;YACJ,CAAC;YAED,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAChD,OAAO,EAAE,CACR,GAAG,EACH,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAC,GAAG,EAAE,UAAU,CAAC,aAAa,CAAC,EAAC,CAC3D,CAAC;QACH,CAAC;KACD,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC5B,GAAY,EACZ,iBAAsC,qBAAqB;IAE3D,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/commands/export.d.ts

@@ -0,0 +1,36 @@
+import { type Cli } from 'incur';
+import { type Pico8Adapter } from '../engine/pico8/index.js';
+/**
+ * Injects the PICO-8 adapter `export` uses (defaults to the shell adapter over
+ * native `pico8 <cart> -export <name>.html -x`). Mirrors the `run` seam: a test
+ * passes a stub to drive the present/absent paths without the paid binary, and
+ * to isolate the child `env` (its `PICO8_PATH`/`PATH`).
+ */
+export type Pico8AdapterFactory = (env: NodeJS.ProcessEnv) => Pico8Adapter;
+/**
+ * Registers `picopilot export`, the THIN structured wrapper over PICO-8's HTML
+ * export (`pico8 <cart> -export <name>.html -x`, the headless `-x` path, no
+ * display needed). It is NOT a `pico8` reimplementation: PICO-8 owns the bundle
+ * (an Emscripten runtime `.js` with the cart baked in, plus a shell `.html`).
+ * The value picopilot adds is the glue an agent should not hand-roll: resolve
+ * the cart, pick/create the output dir, name the pair `index.html` + `index.js`
+ * so a dest folder is directly serveable/showcase-ready, and return ONE
+ * structured result (output dir + file paths + the labelless-cart warning). It
+ * hard-requires PICO-8; absence is a first-class `pico8-not-found` value + a
+ * nonzero exit (mirrors `run`), never a crash or a hang. Live export is the
+ * manual/opt-in tier; the absent path is the CI-testable one.
+ *
+ * Two shapes, one command:
+ *  - default (standalone): keep the `index.html` + `index.js` pair; the html
+ *    references its sibling by name, so the dir plays directly (and `serve`
+ *    uses this internally).
+ *  - `--payload-only`: keep only the `.js` runtime payload; drop the shell page.
+ *    For a website that provides its OWN player shell (a Svelte component that
+ *    ports PICO-8's small bootstrap and loads the exported `.js`). The split is
+ *    a post-export file op the command owns, never the PICO-8 binary's concern.
+ *
+ * @param adapterFactory injects the adapter (defaults to the shell adapter);
+ *   tests pass a stub to drive present/absent without the real binary.
+ */
+export declare function registerExport(cli: Cli.Cli, adapterFactory?: Pico8AdapterFactory): void;
+//# sourceMappingURL=export.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAWA,OAAO,EAAC,KAAK,GAAG,EAAI,MAAM,OAAO,CAAC;AAGlC,OAAO,EAEN,KAAK,YAAY,EAEjB,MAAM,0BAA0B,CAAC;AAElC;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,YAAY,CAAC;AAQ3E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAC7B,GAAG,EAAE,GAAG,CAAC,GAAG,EACZ,cAAc,GAAE,mBAA2C,GACzD,IAAI,CAqPN"}