picopilot 0.0.0 → 0.1.0

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

@@ -0,0 +1,146 @@
+/**
+ * The `audio render` harness builder (ADR-0009 Part 3): the PURE, CI-testable
+ * core that turns a user's cart + a chosen render TARGET into a THROWAWAY cart
+ * whose `_update` plays the target, records it via `audio_rec`/`audio_end(1)`,
+ * and prints the done-sentinel. This is the audio analogue of the `run`
+ * screenshot harness (the `picopilot-debug` recipe): the author writes NO
+ * playback code and still gets "render sfx 5 -> a WAV".
+ *
+ * Kept pure (cart-text in, cart-text + a record window out) so the harness
+ * construction + the record-duration heuristic are unit-testable WITHOUT the
+ * paid PICO-8 binary; only the actual capture needs a live A/V session (the
+ * manual/opt-in tier, ADR-0009).
+ */
+import { Cart } from '../cart/index.js';
+/**
+ * A render target: a single SFX slot, a single music PATTERN, or the whole song
+ * (pattern 0 onward). This mirrors the audio authoring vocabulary (`sfx from-mml`
+ * writes a slot; `music from-patterns` writes an ordered pattern list), so an
+ * author renders exactly what they composed.
+ */
+export type RenderTarget = {
+    readonly kind: 'sfx';
+    readonly index: number;
+} | {
+    readonly kind: 'pattern';
+    readonly index: number;
+} | {
+    readonly kind: 'song';
+};
+/** The lowest/highest SFX slot a render target may name (finding: 64 slots). */
+export declare const SFX_TARGET_MIN = 0;
+export declare const SFX_TARGET_MAX = 63;
+/** The lowest/highest music PATTERN a render target may name (finding: 64 patterns). */
+export declare const PATTERN_TARGET_MIN = 0;
+export declare const PATTERN_TARGET_MAX = 63;
+/**
+ * The default record window (seconds) for a target whose exact play length
+ * cannot be derived cheaply (a music pattern / whole song: PICO-8 does not store
+ * a per-pattern length, and following loops/flags statically is out of scope for
+ * a render harness). A generous window that captures a typical loop; the author
+ * overrides it with an explicit duration (ADR-0009: render is a real-time
+ * recording, so a fixed window is honest, not a promise of exact length).
+ */
+export declare const DEFAULT_RECORD_SECONDS = 8;
+/** A small tail margin (seconds) appended so the target's final note is not clipped. */
+export declare const RECORD_TAIL_SECONDS = 0.5;
+/**
+ * A structured reason a render harness could not be built. Surfaced by the
+ * command as incur's `error({code,...})` envelope; never a silent guess.
+ */
+export type HarnessErrorCode = 
+/** The target named an SFX/pattern outside the valid 0..63 range. */
+'audio-render-target-out-of-range'
+/** The target SFX slot is empty (all-zero) in the cart: nothing to render. */
+ | 'audio-render-target-empty'
+/** The cart could not be parsed (not a valid .p8). */
+ | 'audio-render-cart-parse-error';
+/** A structured harness-build failure (a target refusal, not a crash). */
+export declare class HarnessError extends Error {
+    readonly code: HarnessErrorCode;
+    constructor(code: HarnessErrorCode, message: string);
+}
+/**
+ * The decoded timing of one authored `__sfx__` row: its `speed` (ticks/row) and
+ * the number of NON-EMPTY leading rows (its play length in rows). Both come from
+ * the friendly text row (finding Part A): header bytes 2..3 = speed, then 32
+ * five-nibble notes; a note is silent when its volume nibble is 0.
+ */
+interface SfxTiming {
+    readonly speed: number;
+    readonly rows: number;
+}
+/**
+ * Decodes a `__sfx__` text row into its {@link SfxTiming}. `speed` is header
+ * byte [2:4]; `rows` is the count of tracker rows up to and including the last
+ * one with a non-zero volume nibble (a trailing silent tail does not extend the
+ * audible length). Returns `rows = 0` for an all-silent row.
+ */
+export declare function decodeSfxTiming(row: string): SfxTiming;
+/**
+ * The record window (seconds) for a render target, given the cart. For an SFX
+ * target the window is derived from that slot's speed + audible row count
+ * (`rows * speed` ticks / {@link PICO8_TICKS_PER_SECOND}) plus a tail margin, so
+ * the recording covers exactly the target's play length without guessing. For a
+ * pattern / whole-song target the length is not cheaply derivable, so the
+ * {@link DEFAULT_RECORD_SECONDS} window is used (overridable by the caller).
+ *
+ * An explicit `override` (the command's `--seconds`) always wins.
+ */
+export declare function recordSeconds(cart: Cart, target: RenderTarget, override?: number): number;
+/** A one-line human description of the target (for the render result + help). */
+export declare function describeTarget(target: RenderTarget): string;
+/** The result of building a render harness: the throwaway cart + its record window. */
+export interface RenderHarness {
+    /** The throwaway `.p8` cart text (same `__sfx__`/`__music__`, injected `__lua__`). */
+    readonly cartText: string;
+    /** The record window in seconds the adapter should let the capture run for. */
+    readonly seconds: number;
+    /** The number of `_update` frames the harness records for (= seconds * 30fps). */
+    readonly frames: number;
+    /** The base filename the harness passes to `extcmd("set_filename")`. */
+    readonly wavBasename: string;
+    /** A human description of what is being rendered (for the result envelope). */
+    readonly description: string;
+}
+/**
+ * Builds the throwaway render harness (ADR-0009 Part 3). Takes the user's cart
+ * text + a render TARGET (+ an optional record-window override) and produces a
+ * new cart with the SAME authored `__sfx__`/`__music__` but a REPLACED `__lua__`
+ * whose `_update`:
+ *  - at frame 1: `extcmd("set_filename", <base>)`, `extcmd("audio_rec")`, plays
+ *    the target (`sfx(N)` / `music(P)` / `music(0)`);
+ *  - at frame `frames`: `extcmd("audio_end", 1)` (save to the current folder,
+ *    which the adapter points at an isolated temp dir);
+ *  - at frame `frames + 1`: `printh` the done-sentinel so the launcher kills
+ *    PICO-8 promptly (a cart cannot self-quit, ADR-0006).
+ *
+ * @throws {HarnessError} an out-of-range/empty target or an unparseable cart.
+ */
+export declare function buildRenderHarness(cartText: string, target: RenderTarget, options?: {
+    seconds?: number;
+    sentinel?: string;
+    wavBasename?: string;
+}): RenderHarness;
+/**
+ * Builds the `audio record <cart>` harness: unlike `render`, this captures the
+ * cart's OWN playback, so it keeps the cart's `__lua__` and only APPENDS a
+ * cooperative recorder tab that starts recording immediately and stops after the
+ * window. The recorder runs as an extra code tab so it does not disturb the
+ * cart's own `_update`/`_draw` (PICO-8 runs all tabs; the appended top-level code
+ * arms the recorder and a hooked `_update` advances the timer).
+ *
+ * Because a general cart may define its own `_update`, the recorder wraps it: it
+ * saves the cart's `_update` and installs one that ticks the record timer then
+ * calls the original. This is the record analogue of the debug skill's "add
+ * capture lines, run, revert" recipe, done on a THROWAWAY copy.
+ *
+ * @throws {HarnessError} an unparseable cart.
+ */
+export declare function buildRecordHarness(cartText: string, options?: {
+    seconds?: number;
+    sentinel?: string;
+    wavBasename?: string;
+}): RenderHarness;
+export {};
+//# sourceMappingURL=harness.d.ts.map

package/dist/engine/pico8/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../../src/engine/pico8/harness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAC,IAAI,EAAC,MAAM,kBAAkB,CAAC;AAStC;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GACrB;IAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAC,GAC9C;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAC,GAClD;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAC,CAAC;AAE3B,gFAAgF;AAChF,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,wFAAwF;AACxF,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,wFAAwF;AACxF,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC;;;GAGG;AACH,MAAM,MAAM,gBAAgB;AAC3B,qEAAqE;AACnE,kCAAkC;AACpC,8EAA8E;GAC5E,2BAA2B;AAC7B,sDAAsD;GACpD,+BAA+B,CAAC;AAEnC,0EAA0E;AAC1E,qBAAa,YAAa,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;gBACpB,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM;CAKnD;AAKD;;;;;GAKG;AACH,UAAU,SAAS;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAoBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAUtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC5B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,YAAY,EACpB,QAAQ,CAAC,EAAE,MAAM,GACf,MAAM,CAaR;AAcD,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAS3D;AAED,uFAAuF;AACvF,MAAM,WAAW,aAAa;IAC7B,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B;AAkCD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAM,GACvE,aAAa,CA4Cf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAM,GACvE,aAAa,CA6Cf"}

package/dist/engine/pico8/harness.js

@@ -0,0 +1,251 @@
+/**
+ * The `audio render` harness builder (ADR-0009 Part 3): the PURE, CI-testable
+ * core that turns a user's cart + a chosen render TARGET into a THROWAWAY cart
+ * whose `_update` plays the target, records it via `audio_rec`/`audio_end(1)`,
+ * and prints the done-sentinel. This is the audio analogue of the `run`
+ * screenshot harness (the `picopilot-debug` recipe): the author writes NO
+ * playback code and still gets "render sfx 5 -> a WAV".
+ *
+ * Kept pure (cart-text in, cart-text + a record window out) so the harness
+ * construction + the record-duration heuristic are unit-testable WITHOUT the
+ * paid PICO-8 binary; only the actual capture needs a live A/V session (the
+ * manual/opt-in tier, ADR-0009).
+ */
+import { Cart } from '../cart/index.js';
+import { DONE_SENTINEL, PICO8_FRAMES_PER_SECOND, PICO8_TICKS_PER_SECOND, RECORD_WAV_BASENAME, } from './adapter.js';
+import { SFX_ROW_LENGTH } from '../audio/sfx.js';
+/** The lowest/highest SFX slot a render target may name (finding: 64 slots). */
+export const SFX_TARGET_MIN = 0;
+export const SFX_TARGET_MAX = 63;
+/** The lowest/highest music PATTERN a render target may name (finding: 64 patterns). */
+export const PATTERN_TARGET_MIN = 0;
+export const PATTERN_TARGET_MAX = 63;
+/**
+ * The default record window (seconds) for a target whose exact play length
+ * cannot be derived cheaply (a music pattern / whole song: PICO-8 does not store
+ * a per-pattern length, and following loops/flags statically is out of scope for
+ * a render harness). A generous window that captures a typical loop; the author
+ * overrides it with an explicit duration (ADR-0009: render is a real-time
+ * recording, so a fixed window is honest, not a promise of exact length).
+ */
+export const DEFAULT_RECORD_SECONDS = 8;
+/** A small tail margin (seconds) appended so the target's final note is not clipped. */
+export const RECORD_TAIL_SECONDS = 0.5;
+/** A structured harness-build failure (a target refusal, not a crash). */
+export class HarnessError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'HarnessError';
+        this.code = code;
+    }
+}
+/** An all-zero `__sfx__` row: the canonical "empty slot" (mirrors section.ts). */
+const EMPTY_SFX_ROW = '0'.repeat(SFX_ROW_LENGTH);
+/** Reads slot `index`'s row from a `__sfx__` body, or undefined if absent/empty. */
+function sfxRow(sfxBody, index) {
+    if (sfxBody === undefined)
+        return undefined;
+    const rows = sfxBody.split(/\r?\n/).filter((l) => l.length > 0);
+    const row = rows[index];
+    if (row === undefined ||
+        row.length !== SFX_ROW_LENGTH ||
+        row === EMPTY_SFX_ROW) {
+        return undefined;
+    }
+    return row;
+}
+/**
+ * Decodes a `__sfx__` text row into its {@link SfxTiming}. `speed` is header
+ * byte [2:4]; `rows` is the count of tracker rows up to and including the last
+ * one with a non-zero volume nibble (a trailing silent tail does not extend the
+ * audible length). Returns `rows = 0` for an all-silent row.
+ */
+export function decodeSfxTiming(row) {
+    const speed = Number.parseInt(row.slice(2, 4), 16) || 1;
+    let lastAudible = 0;
+    for (let r = 0; r < 32; r++) {
+        const noteStart = 8 + r * 5;
+        // Note layout: PP (pitch, 2) W (waveform, 1) V (volume, 1) E (effect, 1).
+        const vol = Number.parseInt(row.charAt(noteStart + 3), 16);
+        if (!Number.isNaN(vol) && vol > 0)
+            lastAudible = r + 1;
+    }
+    return { speed, rows: lastAudible };
+}
+/**
+ * The record window (seconds) for a render target, given the cart. For an SFX
+ * target the window is derived from that slot's speed + audible row count
+ * (`rows * speed` ticks / {@link PICO8_TICKS_PER_SECOND}) plus a tail margin, so
+ * the recording covers exactly the target's play length without guessing. For a
+ * pattern / whole-song target the length is not cheaply derivable, so the
+ * {@link DEFAULT_RECORD_SECONDS} window is used (overridable by the caller).
+ *
+ * An explicit `override` (the command's `--seconds`) always wins.
+ */
+export function recordSeconds(cart, target, override) {
+    if (override !== undefined)
+        return override;
+    if (target.kind === 'sfx') {
+        const row = sfxRow(cart.getSection('sfx'), target.index);
+        if (row !== undefined) {
+            const { speed, rows } = decodeSfxTiming(row);
+            const ticks = rows * speed;
+            const seconds = ticks / PICO8_TICKS_PER_SECOND + RECORD_TAIL_SECONDS;
+            // A degenerate (0-row) slot still records a short window rather than 0s.
+            return Math.max(seconds, RECORD_TAIL_SECONDS + 0.5);
+        }
+    }
+    return DEFAULT_RECORD_SECONDS;
+}
+/** The Lua expression that PLAYS the target once, at harness start. */
+function playCall(target) {
+    switch (target.kind) {
+        case 'sfx':
+            return `sfx(${target.index})`;
+        case 'pattern':
+            return `music(${target.index})`;
+        case 'song':
+            return 'music(0)';
+    }
+}
+/** A one-line human description of the target (for the render result + help). */
+export function describeTarget(target) {
+    switch (target.kind) {
+        case 'sfx':
+            return `sfx ${target.index}`;
+        case 'pattern':
+            return `music pattern ${target.index}`;
+        case 'song':
+            return 'the whole song (music 0)';
+    }
+}
+/**
+ * Validates a render target against the cart's authored content, refusing an
+ * out-of-range index or an empty SFX slot (nothing to render) with a structured
+ * {@link HarnessError} rather than recording silence.
+ */
+function validateTarget(cart, target) {
+    if (target.kind === 'sfx') {
+        if (target.index < SFX_TARGET_MIN || target.index > SFX_TARGET_MAX) {
+            throw new HarnessError('audio-render-target-out-of-range', `SFX target ${target.index} is out of range ${SFX_TARGET_MIN}..${SFX_TARGET_MAX}.`);
+        }
+        if (sfxRow(cart.getSection('sfx'), target.index) === undefined) {
+            throw new HarnessError('audio-render-target-empty', `SFX slot ${target.index} is empty in this cart, there is nothing to render. Author it first with \`sfx from-mml ${target.index} "<mml>"\`.`);
+        }
+    }
+    else if (target.kind === 'pattern') {
+        if (target.index < PATTERN_TARGET_MIN ||
+            target.index > PATTERN_TARGET_MAX) {
+            throw new HarnessError('audio-render-target-out-of-range', `music pattern target ${target.index} is out of range ${PATTERN_TARGET_MIN}..${PATTERN_TARGET_MAX}.`);
+        }
+    }
+}
+/**
+ * Builds the throwaway render harness (ADR-0009 Part 3). Takes the user's cart
+ * text + a render TARGET (+ an optional record-window override) and produces a
+ * new cart with the SAME authored `__sfx__`/`__music__` but a REPLACED `__lua__`
+ * whose `_update`:
+ *  - at frame 1: `extcmd("set_filename", <base>)`, `extcmd("audio_rec")`, plays
+ *    the target (`sfx(N)` / `music(P)` / `music(0)`);
+ *  - at frame `frames`: `extcmd("audio_end", 1)` (save to the current folder,
+ *    which the adapter points at an isolated temp dir);
+ *  - at frame `frames + 1`: `printh` the done-sentinel so the launcher kills
+ *    PICO-8 promptly (a cart cannot self-quit, ADR-0006).
+ *
+ * @throws {HarnessError} an out-of-range/empty target or an unparseable cart.
+ */
+export function buildRenderHarness(cartText, target, options = {}) {
+    let cart;
+    try {
+        cart = Cart.parse(cartText);
+    }
+    catch (e) {
+        throw new HarnessError('audio-render-cart-parse-error', `cart does not parse: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    validateTarget(cart, target);
+    const seconds = recordSeconds(cart, target, options.seconds);
+    const frames = Math.max(1, Math.round(seconds * PICO8_FRAMES_PER_SECOND));
+    const sentinel = options.sentinel ?? DONE_SENTINEL;
+    const wavBasename = options.wavBasename ?? RECORD_WAV_BASENAME;
+    const play = playCall(target);
+    // Replace __lua__ with the record harness; keep every OTHER section (crucially
+    // __sfx__/__music__) byte-identical so the target plays exactly as authored.
+    const lua = [
+        '-- picopilot audio render harness (throwaway; ADR-0009).',
+        '-- Real-time recording of playback, NOT an offline export.',
+        't=0',
+        'function _update()',
+        ' t+=1',
+        ` if t==1 then extcmd("set_filename","${wavBasename}") extcmd("audio_rec") ${play} end`,
+        ` if t==${frames} then extcmd("audio_end",1) end`,
+        ` if t==${frames + 1} then printh("${sentinel}") end`,
+        'end',
+        'function _draw() cls() print("rendering "..t,0,0,7) end',
+        '',
+    ].join('\n');
+    cart.setSection('lua', lua);
+    return {
+        cartText: cart.serialize(),
+        seconds,
+        frames,
+        wavBasename,
+        description: describeTarget(target),
+    };
+}
+/**
+ * Builds the `audio record <cart>` harness: unlike `render`, this captures the
+ * cart's OWN playback, so it keeps the cart's `__lua__` and only APPENDS a
+ * cooperative recorder tab that starts recording immediately and stops after the
+ * window. The recorder runs as an extra code tab so it does not disturb the
+ * cart's own `_update`/`_draw` (PICO-8 runs all tabs; the appended top-level code
+ * arms the recorder and a hooked `_update` advances the timer).
+ *
+ * Because a general cart may define its own `_update`, the recorder wraps it: it
+ * saves the cart's `_update` and installs one that ticks the record timer then
+ * calls the original. This is the record analogue of the debug skill's "add
+ * capture lines, run, revert" recipe, done on a THROWAWAY copy.
+ *
+ * @throws {HarnessError} an unparseable cart.
+ */
+export function buildRecordHarness(cartText, options = {}) {
+    let cart;
+    try {
+        cart = Cart.parse(cartText);
+    }
+    catch (e) {
+        throw new HarnessError('audio-render-cart-parse-error', `cart does not parse: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    const seconds = options.seconds ?? DEFAULT_RECORD_SECONDS;
+    const frames = Math.max(1, Math.round(seconds * PICO8_FRAMES_PER_SECOND));
+    const sentinel = options.sentinel ?? DONE_SENTINEL;
+    const wavBasename = options.wavBasename ?? RECORD_WAV_BASENAME;
+    const existing = cart.getSection('lua') ?? '';
+    // Append the recorder AFTER the cart's own code. It wraps _update so it works
+    // whether or not the cart defines one, and never edits the cart's own logic.
+    const recorder = [
+        '',
+        '-->8',
+        '-- picopilot audio record harness (throwaway; ADR-0009).',
+        "-- Records the cart's own audio; real-time capture, NOT an offline export.",
+        '__pp_rec_update=_update',
+        '__pp_rec_t=0',
+        'function _update()',
+        ' __pp_rec_t+=1',
+        ` if __pp_rec_t==1 then extcmd("set_filename","${wavBasename}") extcmd("audio_rec") end`,
+        ` if __pp_rec_t==${frames} then extcmd("audio_end",1) end`,
+        ` if __pp_rec_t==${frames + 1} then printh("${sentinel}") end`,
+        ' if __pp_rec_update then __pp_rec_update() end',
+        'end',
+        '',
+    ].join('\n');
+    cart.setSection('lua', existing + recorder);
+    return {
+        cartText: cart.serialize(),
+        seconds,
+        frames,
+        wavBasename,
+        description: 'the running cart',
+    };
+}
+//# sourceMappingURL=harness.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harness.js","sourceRoot":"","sources":["../../../src/engine/pico8/harness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAC,IAAI,EAAC,MAAM,kBAAkB,CAAC;AACtC,OAAO,EACN,aAAa,EACb,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAC,cAAc,EAAC,MAAM,iBAAiB,CAAC;AAa/C,gFAAgF;AAChF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAChC,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAEjC,wFAAwF;AACxF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAExC,wFAAwF;AACxF,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAcvC,0EAA0E;AAC1E,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC7B,IAAI,CAAmB;IAChC,YAAY,IAAsB,EAAE,OAAe;QAClD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,CAAC;CACD;AAED,kFAAkF;AAClF,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;AAajD,oFAAoF;AACpF,SAAS,MAAM,CACd,OAA2B,EAC3B,KAAa;IAEb,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAChE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACxB,IACC,GAAG,KAAK,SAAS;QACjB,GAAG,CAAC,MAAM,KAAK,cAAc;QAC7B,GAAG,KAAK,aAAa,EACpB,CAAC;QACF,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,0EAA0E;QAC1E,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;YAAE,WAAW,GAAG,CAAC,GAAG,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,EAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAC5B,IAAU,EACV,MAAoB,EACpB,QAAiB;IAEjB,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC5C,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACzD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,EAAC,KAAK,EAAE,IAAI,EAAC,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;YAC3C,MAAM,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;YAC3B,MAAM,OAAO,GAAG,KAAK,GAAG,sBAAsB,GAAG,mBAAmB,CAAC;YACrE,yEAAyE;YACzE,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,mBAAmB,GAAG,GAAG,CAAC,CAAC;QACrD,CAAC;IACF,CAAC;IACD,OAAO,sBAAsB,CAAC;AAC/B,CAAC;AAED,uEAAuE;AACvE,SAAS,QAAQ,CAAC,MAAoB;IACrC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,KAAK;YACT,OAAO,OAAO,MAAM,CAAC,KAAK,GAAG,CAAC;QAC/B,KAAK,SAAS;YACb,OAAO,SAAS,MAAM,CAAC,KAAK,GAAG,CAAC;QACjC,KAAK,MAAM;YACV,OAAO,UAAU,CAAC;IACpB,CAAC;AACF,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAAC,MAAoB;IAClD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,KAAK;YACT,OAAO,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC;QAC9B,KAAK,SAAS;YACb,OAAO,iBAAiB,MAAM,CAAC,KAAK,EAAE,CAAC;QACxC,KAAK,MAAM;YACV,OAAO,0BAA0B,CAAC;IACpC,CAAC;AACF,CAAC;AAgBD;;;;GAIG;AACH,SAAS,cAAc,CAAC,IAAU,EAAE,MAAoB;IACvD,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,KAAK,GAAG,cAAc,IAAI,MAAM,CAAC,KAAK,GAAG,cAAc,EAAE,CAAC;YACpE,MAAM,IAAI,YAAY,CACrB,kCAAkC,EAClC,cAAc,MAAM,CAAC,KAAK,oBAAoB,cAAc,KAAK,cAAc,GAAG,CAClF,CAAC;QACH,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;YAChE,MAAM,IAAI,YAAY,CACrB,2BAA2B,EAC3B,YAAY,MAAM,CAAC,KAAK,2FAA2F,MAAM,CAAC,KAAK,aAAa,CAC5I,CAAC;QACH,CAAC;IACF,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACtC,IACC,MAAM,CAAC,KAAK,GAAG,kBAAkB;YACjC,MAAM,CAAC,KAAK,GAAG,kBAAkB,EAChC,CAAC;YACF,MAAM,IAAI,YAAY,CACrB,kCAAkC,EAClC,wBAAwB,MAAM,CAAC,KAAK,oBAAoB,kBAAkB,KAAK,kBAAkB,GAAG,CACpG,CAAC;QACH,CAAC;IACF,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CACjC,QAAgB,EAChB,MAAoB,EACpB,UAAuE,EAAE;IAEzE,IAAI,IAAU,CAAC;IACf,IAAI,CAAC;QACJ,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,MAAM,IAAI,YAAY,CACrB,+BAA+B,EAC/B,wBAAwB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACpE,CAAC;IACH,CAAC;IAED,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAE7B,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,uBAAuB,CAAC,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,aAAa,CAAC;IACnD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,mBAAmB,CAAC;IAC/D,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE9B,+EAA+E;IAC/E,6EAA6E;IAC7E,MAAM,GAAG,GAAG;QACX,0DAA0D;QAC1D,4DAA4D;QAC5D,KAAK;QACL,oBAAoB;QACpB,OAAO;QACP,wCAAwC,WAAW,0BAA0B,IAAI,MAAM;QACvF,UAAU,MAAM,iCAAiC;QACjD,UAAU,MAAM,GAAG,CAAC,iBAAiB,QAAQ,QAAQ;QACrD,KAAK;QACL,yDAAyD;QACzD,EAAE;KACF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAE5B,OAAO;QACN,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE;QAC1B,OAAO;QACP,MAAM;QACN,WAAW;QACX,WAAW,EAAE,cAAc,CAAC,MAAM,CAAC;KACnC,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CACjC,QAAgB,EAChB,UAAuE,EAAE;IAEzE,IAAI,IAAU,CAAC;IACf,IAAI,CAAC;QACJ,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,MAAM,IAAI,YAAY,CACrB,+BAA+B,EAC/B,wBAAwB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACpE,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,sBAAsB,CAAC;IAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,uBAAuB,CAAC,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,aAAa,CAAC;IACnD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,mBAAmB,CAAC;IAE/D,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC9C,8EAA8E;IAC9E,6EAA6E;IAC7E,MAAM,QAAQ,GAAG;QAChB,EAAE;QACF,MAAM;QACN,0DAA0D;QAC1D,4EAA4E;QAC5E,yBAAyB;QACzB,cAAc;QACd,oBAAoB;QACpB,gBAAgB;QAChB,iDAAiD,WAAW,4BAA4B;QACxF,mBAAmB,MAAM,iCAAiC;QAC1D,mBAAmB,MAAM,GAAG,CAAC,iBAAiB,QAAQ,QAAQ;QAC9D,gDAAgD;QAChD,KAAK;QACL,EAAE;KACF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAC;IAE5C,OAAO;QACN,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE;QAC1B,OAAO;QACP,MAAM;QACN,WAAW;QACX,WAAW,EAAE,kBAAkB;KAC/B,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * The PICO-8 engine seam: launch + capture over the user's PICO-8 binary
+ * (ADR-0006, native `pico8 -x` path). Barrel re-export so the command layer and
+ * later PICO-8-gated features (`audio render`, `export`) import from one place.
+ *
+ * - `adapter`:  the `Pico8Adapter` interface, `Pico8Result`, the structured
+ *               `pico8-not-found` value, and the run-report shapes.
+ * - `sentinel`: the pure sentinel-watch core (CI-testable without the binary).
+ * - `shell`:    the v1 adapter shelling out to native `pico8 -x`, with an
+ *               injectable spawn seam for isolation-testing.
+ */
+export * from './adapter.js';
+export * from './drive.js';
+export * from './harness.js';
+export * from './sentinel.js';
+export * from './session.js';
+export * from './session-daemon.js';
+export * from './session-daemon-main.js';
+export * from './shell.js';
+export * from './supervisor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/pico8/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/pico8/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/engine/pico8/index.js

@@ -0,0 +1,21 @@
+/**
+ * The PICO-8 engine seam: launch + capture over the user's PICO-8 binary
+ * (ADR-0006, native `pico8 -x` path). Barrel re-export so the command layer and
+ * later PICO-8-gated features (`audio render`, `export`) import from one place.
+ *
+ * - `adapter`:  the `Pico8Adapter` interface, `Pico8Result`, the structured
+ *               `pico8-not-found` value, and the run-report shapes.
+ * - `sentinel`: the pure sentinel-watch core (CI-testable without the binary).
+ * - `shell`:    the v1 adapter shelling out to native `pico8 -x`, with an
+ *               injectable spawn seam for isolation-testing.
+ */
+export * from './adapter.js';
+export * from './drive.js';
+export * from './harness.js';
+export * from './sentinel.js';
+export * from './session.js';
+export * from './session-daemon.js';
+export * from './session-daemon-main.js';
+export * from './shell.js';
+export * from './supervisor.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/pico8/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

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

@@ -0,0 +1,63 @@
+/**
+ * The pure sentinel-watch core (ADR-0006): scan a stdout stream line by line and
+ * decide WHEN to kill PICO-8. A cart cannot self-quit the app, so it signals
+ * "done" by printing a sentinel line via `printh`; the launcher kills the moment
+ * it matches. This is strictly better than a blind timeout (no guessing the
+ * duration), which stays only as a backstop in the shell layer.
+ *
+ * Kept PURE and stream-shaped on purpose: it is the load-bearing logic and the
+ * one piece testable in CI WITHOUT the paid PICO-8 binary. The shell layer feeds
+ * it real child stdout; a test feeds it a fake array of lines.
+ */
+/**
+ * Splits a raw stdout chunk into complete lines plus a trailing remainder,
+ * so sentinel matching works on whole lines even when the OS delivers stdout in
+ * arbitrary chunks. The remainder (an unterminated final line) is carried to the
+ * next chunk by the caller.
+ *
+ * Handles both `\n` and `\r\n`; the `\r` is stripped so a sentinel matches
+ * regardless of platform line endings.
+ */
+export declare function splitLines(chunk: string): {
+    lines: string[];
+    rest: string;
+};
+/**
+ * Scans `lines` for the `sentinel` and reports whether it appeared and at which
+ * index. A match means the caller should kill PICO-8 now (exit reason
+ * `sentinel`); no match means keep streaming until the backstop or a natural
+ * exit. The comparison is an EXACT line match (the cart prints the sentinel on
+ * its own line), so incidental substrings in other output never trip it.
+ */
+export declare function findSentinel(lines: readonly string[], sentinel?: string): {
+    matched: boolean;
+    index: number;
+};
+/**
+ * A stateful line accumulator for a streaming run: feed it raw stdout chunks;
+ * it buffers partial lines, exposes the complete lines seen so far, and reports
+ * the moment the sentinel is matched. This is the exact glue the shell adapter
+ * drives (feed chunks, stop on `sentinelSeen`), and a test drives it with
+ * synthetic chunks to assert prompt-kill vs. no-match without a real process.
+ */
+export declare class SentinelWatcher {
+    private readonly sentinel;
+    private buffer;
+    private readonly linesSeen;
+    private matched;
+    constructor(sentinel?: string);
+    /**
+     * Feeds one raw stdout chunk. Returns `true` the first time the sentinel is
+     * matched (the caller should kill PICO-8 then); once matched it stays matched.
+     */
+    push(chunk: string): boolean;
+    /** Whether the sentinel has been seen on a complete line so far. */
+    get sentinelSeen(): boolean;
+    /**
+     * The full captured stdout as text (complete lines plus any unterminated
+     * trailing buffer), for the run report's `printh`. The sentinel line itself
+     * is KEPT (it is real cart output); the command decides whether to show it.
+     */
+    get text(): string;
+}
+//# sourceMappingURL=sentinel.d.ts.map

package/dist/engine/pico8/sentinel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentinel.d.ts","sourceRoot":"","sources":["../../../src/engine/pico8/sentinel.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,CAOzE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC3B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,QAAQ,GAAE,MAAsB,GAC9B;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,CAGnC;AAED;;;;;;GAMG;AACH,qBAAa,eAAe;IAKf,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJrC,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,OAAO,CAAS;gBAEK,QAAQ,GAAE,MAAsB;IAE7D;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAU5B,oEAAoE;IACpE,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;;;OAIG;IACH,IAAI,IAAI,IAAI,MAAM,CAMjB;CACD"}

package/dist/engine/pico8/sentinel.js

@@ -0,0 +1,86 @@
+import { DONE_SENTINEL } from './adapter.js';
+/**
+ * The pure sentinel-watch core (ADR-0006): scan a stdout stream line by line and
+ * decide WHEN to kill PICO-8. A cart cannot self-quit the app, so it signals
+ * "done" by printing a sentinel line via `printh`; the launcher kills the moment
+ * it matches. This is strictly better than a blind timeout (no guessing the
+ * duration), which stays only as a backstop in the shell layer.
+ *
+ * Kept PURE and stream-shaped on purpose: it is the load-bearing logic and the
+ * one piece testable in CI WITHOUT the paid PICO-8 binary. The shell layer feeds
+ * it real child stdout; a test feeds it a fake array of lines.
+ */
+/**
+ * Splits a raw stdout chunk into complete lines plus a trailing remainder,
+ * so sentinel matching works on whole lines even when the OS delivers stdout in
+ * arbitrary chunks. The remainder (an unterminated final line) is carried to the
+ * next chunk by the caller.
+ *
+ * Handles both `\n` and `\r\n`; the `\r` is stripped so a sentinel matches
+ * regardless of platform line endings.
+ */
+export function splitLines(chunk) {
+    const parts = chunk.split('\n');
+    const rest = parts.pop() ?? '';
+    return {
+        lines: parts.map((l) => (l.endsWith('\r') ? l.slice(0, -1) : l)),
+        rest,
+    };
+}
+/**
+ * Scans `lines` for the `sentinel` and reports whether it appeared and at which
+ * index. A match means the caller should kill PICO-8 now (exit reason
+ * `sentinel`); no match means keep streaming until the backstop or a natural
+ * exit. The comparison is an EXACT line match (the cart prints the sentinel on
+ * its own line), so incidental substrings in other output never trip it.
+ */
+export function findSentinel(lines, sentinel = DONE_SENTINEL) {
+    const index = lines.findIndex((l) => l === sentinel);
+    return { matched: index !== -1, index };
+}
+/**
+ * A stateful line accumulator for a streaming run: feed it raw stdout chunks;
+ * it buffers partial lines, exposes the complete lines seen so far, and reports
+ * the moment the sentinel is matched. This is the exact glue the shell adapter
+ * drives (feed chunks, stop on `sentinelSeen`), and a test drives it with
+ * synthetic chunks to assert prompt-kill vs. no-match without a real process.
+ */
+export class SentinelWatcher {
+    sentinel;
+    buffer = '';
+    linesSeen = [];
+    matched = false;
+    constructor(sentinel = DONE_SENTINEL) {
+        this.sentinel = sentinel;
+    }
+    /**
+     * Feeds one raw stdout chunk. Returns `true` the first time the sentinel is
+     * matched (the caller should kill PICO-8 then); once matched it stays matched.
+     */
+    push(chunk) {
+        const { lines, rest } = splitLines(this.buffer + chunk);
+        this.buffer = rest;
+        for (const line of lines) {
+            this.linesSeen.push(line);
+            if (line === this.sentinel)
+                this.matched = true;
+        }
+        return this.matched;
+    }
+    /** Whether the sentinel has been seen on a complete line so far. */
+    get sentinelSeen() {
+        return this.matched;
+    }
+    /**
+     * The full captured stdout as text (complete lines plus any unterminated
+     * trailing buffer), for the run report's `printh`. The sentinel line itself
+     * is KEPT (it is real cart output); the command decides whether to show it.
+     */
+    get text() {
+        const all = this.buffer.length > 0
+            ? [...this.linesSeen, this.buffer]
+            : this.linesSeen;
+        return all.join('\n');
+    }
+}
+//# sourceMappingURL=sentinel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sentinel.js","sourceRoot":"","sources":["../../../src/engine/pico8/sentinel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,cAAc,CAAC;AAE3C;;;;;;;;;;GAUG;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACvC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IAC/B,OAAO;QACN,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,IAAI;KACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC3B,KAAwB,EACxB,WAAmB,aAAa;IAEhC,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC;IACrD,OAAO,EAAC,OAAO,EAAE,KAAK,KAAK,CAAC,CAAC,EAAE,KAAK,EAAC,CAAC;AACvC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;IAKE;IAJrB,MAAM,GAAG,EAAE,CAAC;IACH,SAAS,GAAa,EAAE,CAAC;IAClC,OAAO,GAAG,KAAK,CAAC;IAExB,YAA6B,WAAmB,aAAa;QAAhC,aAAQ,GAAR,QAAQ,CAAwB;IAAG,CAAC;IAEjE;;;OAGG;IACH,IAAI,CAAC,KAAa;QACjB,MAAM,EAAC,KAAK,EAAE,IAAI,EAAC,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,IAAI,IAAI,KAAK,IAAI,CAAC,QAAQ;gBAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACjD,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,oEAAoE;IACpE,IAAI,YAAY;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACH,IAAI,IAAI;QACP,MAAM,GAAG,GACR,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YACrB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;YAClC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;QACnB,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;CACD"}

package/dist/engine/pico8/session-daemon-entry.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The detached daemon process ENTRY (ADR-0011, prd US #6). `playtest start`
+ * spawns this file (via `process.execPath [+ execArgv] <this> <configJson>`, so
+ * it re-uses the exact loader the parent ran under, dev `tsx` or built `dist`) as
+ * a DETACHED background process that owns the live driven PICO-8 for the session's
+ * lifetime. It just decodes its JSON config and hands off to {@link daemonMain};
+ * all the logic lives in `session-daemon-main.ts` (so it stays unit-testable).
+ */
+export {};
+//# sourceMappingURL=session-daemon-entry.d.ts.map

package/dist/engine/pico8/session-daemon-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-daemon-entry.d.ts","sourceRoot":"","sources":["../../../src/engine/pico8/session-daemon-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/engine/pico8/session-daemon-entry.js

@@ -0,0 +1,11 @@
+/**
+ * The detached daemon process ENTRY (ADR-0011, prd US #6). `playtest start`
+ * spawns this file (via `process.execPath [+ execArgv] <this> <configJson>`, so
+ * it re-uses the exact loader the parent ran under, dev `tsx` or built `dist`) as
+ * a DETACHED background process that owns the live driven PICO-8 for the session's
+ * lifetime. It just decodes its JSON config and hands off to {@link daemonMain};
+ * all the logic lives in `session-daemon-main.ts` (so it stays unit-testable).
+ */
+import { daemonMain } from './session-daemon-main.js';
+daemonMain(process.argv.slice(2));
+//# sourceMappingURL=session-daemon-entry.js.map