picopilot 0.0.0 → 0.1.0

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

@@ -0,0 +1,69 @@
+import { type CountReport, type LintReport, type MinifyReport, type ShrinkoAdapter, type ShrinkoResult } from './adapter.js';
+/**
+ * The result of running one child process: its exit `code` (null when killed by
+ * a signal), captured `stdout`/`stderr`, and `spawnError` set when the binary
+ * could not be launched AT ALL (ENOENT etc.) rather than launched-and-exited.
+ * `spawnError` is how the shell adapter distinguishes "shrinko is not installed"
+ * from "shrinko ran and failed".
+ */
+export interface ChildResult {
+    readonly code: number | null;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly spawnError: NodeJS.ErrnoException | undefined;
+}
+/**
+ * The child-process seam. The real implementation shells out with the CALLER's
+ * `env` (so a test overrides the child's `PATH` and nothing else). Tests inject
+ * a stub runner to simulate shrinko present/absent WITHOUT ever requiring the
+ * real binary, and to assert exactly what argv/env the adapter would spawn.
+ */
+export type ChildRunner = (file: string, args: string[], env: NodeJS.ProcessEnv) => Promise<ChildResult>;
+/**
+ * The default {@link ChildRunner}: an `execFile` that captures stdout/stderr and
+ * NEVER rejects. A failed spawn (ENOENT) becomes `spawnError`; a nonzero exit
+ * becomes a `code`, so both outcomes are data the adapter maps to a structured
+ * result. The child inherits ONLY the `env` it is handed (the command layer
+ * passes the incur-resolved env, whose `PATH` a test can override) so there is
+ * no ambient-environment leak.
+ */
+export declare const execFileRunner: ChildRunner;
+/** Options for {@link ShellShrinkoAdapter}. */
+export interface ShellShrinkoOptions {
+    /**
+     * The environment handed to the child process. The command layer passes the
+     * incur-resolved env here; its `PATH` is the isolation lever a test overrides
+     * (an empty/`PATH`-less env makes every invocation ENOENT ⇒ shrinko-absent).
+     */
+    readonly env: NodeJS.ProcessEnv;
+    /** The child runner (defaults to {@link execFileRunner}); tests inject a stub. */
+    readonly run?: ChildRunner;
+}
+/**
+ * The v1 {@link ShrinkoAdapter}: shells out to a user-installed Python
+ * `shrinko8` (ADR-0001). It is the ONLY place that knows shrinko is an external
+ * process; every command talks to the {@link ShrinkoAdapter} interface, so a
+ * future native-TS adapter replaces this class without touching a command.
+ *
+ * Presence detection and invocation are the SAME act: the adapter tries each
+ * {@link SHRINKO_INVOCATIONS} candidate and uses the first that spawns. If every
+ * candidate ENOENTs, shrinko is absent and the method returns the structured
+ * {@link shrinkoNotFound} value (never a throw, never a hollow success).
+ */
+export declare class ShellShrinkoAdapter implements ShrinkoAdapter {
+    private readonly env;
+    private readonly run;
+    constructor(options: ShellShrinkoOptions);
+    count(cartPath: string): Promise<ShrinkoResult<CountReport>>;
+    lint(cartPath: string): Promise<ShrinkoResult<LintReport>>;
+    minify(cartPath: string, outPath: string): Promise<ShrinkoResult<MinifyReport>>;
+    exportSpritesheet(cartPath: string, pngPath: string): Promise<ShrinkoResult<void>>;
+    importSpritesheet(srcCartPath: string, pngPath: string, outCartPath: string): Promise<ShrinkoResult<void>>;
+    /**
+     * Runs shrinko with the given trailing args, trying each invocation candidate
+     * until one SPAWNS. Returns the {@link ChildResult} of the first candidate
+     * that launched, or `undefined` when every candidate ENOENTs (shrinko absent).
+     */
+    private invoke;
+}
+//# sourceMappingURL=shell.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/engine/shrinko/shell.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,YAAY,EAGjB,KAAK,cAAc,EACnB,KAAK,aAAa,EAElB,MAAM,cAAc,CAAC;AAEtB;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,cAAc,GAAG,SAAS,CAAC;CACvD;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,CAAC,UAAU,KAClB,OAAO,CAAC,WAAW,CAAC,CAAC;AAE1B;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,WAmB1B,CAAC;AAcJ,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IACnC;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,kFAAkF;IAClF,QAAQ,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IACzD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;gBAEtB,OAAO,EAAE,mBAAmB;IAKlC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;IAa5D,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAe1D,MAAM,CACX,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IAgCjC,iBAAiB,CACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAOzB,iBAAiB,CACtB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAgB/B;;;;OAIG;YACW,MAAM;CAapB"}

package/dist/engine/shrinko/shell.js

@@ -0,0 +1,156 @@
+import { execFile } from 'node:child_process';
+import { parseCount, parseLint, shrinkoNotFound, } from './adapter.js';
+/**
+ * The default {@link ChildRunner}: an `execFile` that captures stdout/stderr and
+ * NEVER rejects. A failed spawn (ENOENT) becomes `spawnError`; a nonzero exit
+ * becomes a `code`, so both outcomes are data the adapter maps to a structured
+ * result. The child inherits ONLY the `env` it is handed (the command layer
+ * passes the incur-resolved env, whose `PATH` a test can override) so there is
+ * no ambient-environment leak.
+ */
+export const execFileRunner = (file, args, env) => new Promise((resolve) => {
+    execFile(file, args, { env, encoding: 'utf8' }, (error, stdout, stderr) => {
+        const err = error;
+        resolve({
+            // `execFile` sets error.code to the string 'ENOENT' on spawn failure and
+            // to the numeric exit code on a nonzero exit; separate the two.
+            code: err !== null && typeof err.code === 'number'
+                ? err.code
+                : err === null
+                    ? 0
+                    : null,
+            stdout,
+            stderr,
+            spawnError: err !== null && typeof err.code === 'string' ? err : undefined,
+        });
+    });
+});
+/**
+ * The candidate ways to invoke shrinko, tried in order. First the `shrinko8`
+ * entry-point on `PATH`, then `python -m shrinko8` / `python3 -m shrinko8` as
+ * fallbacks (the module is `shrinko8`; the pip package is `shrinko`). The first
+ * candidate that SPAWNS (does not ENOENT) is the one shrinko is reached through.
+ */
+const SHRINKO_INVOCATIONS = [
+    ['shrinko8'],
+    ['python', '-m', 'shrinko8'],
+    ['python3', '-m', 'shrinko8'],
+];
+/**
+ * The v1 {@link ShrinkoAdapter}: shells out to a user-installed Python
+ * `shrinko8` (ADR-0001). It is the ONLY place that knows shrinko is an external
+ * process; every command talks to the {@link ShrinkoAdapter} interface, so a
+ * future native-TS adapter replaces this class without touching a command.
+ *
+ * Presence detection and invocation are the SAME act: the adapter tries each
+ * {@link SHRINKO_INVOCATIONS} candidate and uses the first that spawns. If every
+ * candidate ENOENTs, shrinko is absent and the method returns the structured
+ * {@link shrinkoNotFound} value (never a throw, never a hollow success).
+ */
+export class ShellShrinkoAdapter {
+    env;
+    run;
+    constructor(options) {
+        this.env = options.env;
+        this.run = options.run ?? execFileRunner;
+    }
+    async count(cartPath) {
+        const outcome = await this.invoke([cartPath, '--count']);
+        if (outcome === undefined) {
+            return shrinkoNotFound();
+        }
+        // shrinko prints the count report; some builds send it to stderr, so parse
+        // the combined stream. parseCount throws on unparseable output (ShrinkoParseError).
+        return {
+            ok: true,
+            value: parseCount(`${outcome.stdout}\n${outcome.stderr}`),
+        };
+    }
+    async lint(cartPath) {
+        // `-l` lints; it exits nonzero (2) WHEN it finds warnings, which is a normal
+        // result (findings are data), NOT a spawn failure. Only a spawnError means
+        // shrinko is absent, so we key absence off `outcome === undefined`, and parse
+        // the warnings regardless of the (0-or-2) exit code.
+        const outcome = await this.invoke([cartPath, '-l']);
+        if (outcome === undefined) {
+            return shrinkoNotFound();
+        }
+        return {
+            ok: true,
+            value: parseLint(`${outcome.stdout}\n${outcome.stderr}`),
+        };
+    }
+    async minify(cartPath, outPath) {
+        // Count the source first (the "before"): if shrinko is absent, this returns
+        // the not-found value and we never write anything.
+        const before = await this.count(cartPath);
+        if (!before.ok)
+            return before;
+        // Minify SAFE-only (ADR-0007): the three safe-only knobs keep rename/reorder/
+        // builtins behaviour-preserving. Output goes to a SEPARATE cart (outPath).
+        const out = await this.invoke([
+            cartPath,
+            '-m',
+            '--rename-safe-only',
+            '--reorder-safe-only',
+            '--builtins-safe-only',
+            outPath,
+        ]);
+        if (out === undefined)
+            return shrinkoNotFound();
+        // Count the artifact (the "after"). It exists now, so this is a normal count.
+        const after = await this.count(outPath);
+        if (!after.ok)
+            return after;
+        return {
+            ok: true,
+            value: {
+                beforeTokens: before.value.tokens,
+                afterTokens: after.value.tokens,
+                outPath,
+            },
+        };
+    }
+    async exportSpritesheet(cartPath, pngPath) {
+        // `<cart> <out.png> -f spritesheet` writes the 128x128 spritesheet PNG.
+        const outcome = await this.invoke([cartPath, pngPath, '-f', 'spritesheet']);
+        if (outcome === undefined)
+            return shrinkoNotFound();
+        return { ok: true, value: undefined };
+    }
+    async importSpritesheet(srcCartPath, pngPath, outCartPath) {
+        // `<cart> <out.p8> --merge <png> gfx spritesheet` merges ONLY the gfx section
+        // from the PNG into the source cart, preserving code/map/sfx/music. (A plain
+        // `-F spritesheet` would drop everything but gfx, wiping the user's code.)
+        const outcome = await this.invoke([
+            srcCartPath,
+            outCartPath,
+            '--merge',
+            pngPath,
+            'gfx',
+            'spritesheet',
+        ]);
+        if (outcome === undefined)
+            return shrinkoNotFound();
+        return { ok: true, value: undefined };
+    }
+    /**
+     * Runs shrinko with the given trailing args, trying each invocation candidate
+     * until one SPAWNS. Returns the {@link ChildResult} of the first candidate
+     * that launched, or `undefined` when every candidate ENOENTs (shrinko absent).
+     */
+    async invoke(args) {
+        for (const inv of SHRINKO_INVOCATIONS) {
+            const [file, ...prefix] = inv;
+            const result = await this.run(file, [...prefix, ...args], this.env);
+            if (result.spawnError === undefined) {
+                return result;
+            }
+            // ENOENT on this candidate: fall through to the next. Any other spawn
+            // error (EACCES etc.) also falls through, so a broken candidate never
+            // masks a working one.
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=shell.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * The skills-install engine behind `picopilot init --install-skills`, the one
+ * picopilot path that writes to a shared/global location. Every install-target
+ * knob is a parameter here so tests redirect it to a temp dir and the real agent
+ * skill dirs stay byte-untouched. See `skills.ts` for the isolation contract.
+ */
+export { installSkills, type InstallSkillsOptions, type InstallSkillsResult, SKILL_NAMES, skillsSourceDir, type WiredAgent, } from './skills.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACN,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,WAAW,EACX,eAAe,EACf,KAAK,UAAU,GACf,MAAM,aAAa,CAAC"}

package/dist/engine/skills/index.js

@@ -0,0 +1,8 @@
+/**
+ * The skills-install engine behind `picopilot init --install-skills`, the one
+ * picopilot path that writes to a shared/global location. Every install-target
+ * knob is a parameter here so tests redirect it to a temp dir and the real agent
+ * skill dirs stay byte-untouched. See `skills.ts` for the isolation contract.
+ */
+export { installSkills, SKILL_NAMES, skillsSourceDir, } from './skills.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACN,aAAa,EAGb,WAAW,EACX,eAAe,GAEf,MAAM,aAAa,CAAC"}

package/dist/engine/skills/skills.d.ts

@@ -0,0 +1,104 @@
+import { Cli } from 'incur';
+/**
+ * The engine behind `picopilot init --install-skills`: the ONE picopilot path
+ * that writes to a SHARED/GLOBAL location. incur's `skills add` defaults to a
+ * GLOBAL install (into `~/.agents/skills` plus symlinks into detected agent
+ * dirs like `~/.claude/skills`), so this module is where the work-contract's
+ * shared-write isolation obligation is discharged: every knob that decides the
+ * install TARGET (`global`, `cwd`) is a parameter a test can redirect to a temp
+ * dir, so installing skills can never pollute the real environment in tests.
+ *
+ * The install runs IN-PROCESS through incur's `SyncSkills.sync`. NOTE (incur
+ * 0.4.10): `SyncSkills.sync` / the `skills add` built-in resolve their target
+ * from `os.homedir()` and `process.env` captured AT MODULE LOAD, NOT from the
+ * `env` DI you can pass to `cli.serve(argv, { env })`, so overriding the serve
+ * env does NOT move the install target. The effective in-process lever is
+ * `global: false` + `cwd: <temp dir>`, which installs under `<cwd>/.agents/skills`
+ * (and `<cwd>/.claude/skills` etc.) and leaves the real dirs byte-untouched.
+ */
+/**
+ * The authored picopilot skills (US #20 discipline skills + the game skills),
+ * as SKILL.md files under {@link skillsSourceDir}. They load on-demand by
+ * concern and carry the hard-won workflow knowledge (the `#include` discipline,
+ * the token breakdown, the `gfx render`→look→`gfx set`→fix loop incl. the
+ * non-multimodal fallback, composing in picopilot-MML) so an agent gets it
+ * without bloating every turn.
+ *
+ * The GAME skills are a composed pair (grilled design in
+ * work/notes/ideas/game-jam-design-skill.md): `game-jam` (model-invoked, the
+ * clock+theme discipline) POINTS AT `game-design-reference` (a user-invoked
+ * reference body of universal design principles, `disable-model-invocation`, so
+ * it costs no per-turn context and is reached only by pointer, not fired on a
+ * vague trigger). Both ship engine-packaged here; `game-design-reference`'s
+ * CONTENT is engine-agnostic.
+ *
+ * They ship ALONGSIDE the per-command skills incur auto-generates from the
+ * command surface (`sync: { depth: 1 }`), pulled in via an `include` glob; the
+ * command surface is still growing, so the named discipline skills are authored
+ * rather than tied to a command-group shape that does not exist yet.
+ */
+export declare const SKILL_NAMES: readonly ["picopilot-overview", "picopilot-code", "picopilot-art", "picopilot-audio", "picopilot-debug", "game-design-reference", "game-jam"];
+/**
+ * Resolves the on-disk directory that holds the authored `picopilot-*` SKILL.md
+ * files (`<packageRoot>/src/skills`). The files ship in the npm package (the
+ * package `files` includes `src`), so the same path works from the built
+ * `dist/` runtime and from `src/` under tsx: we walk up from THIS module to the
+ * package root (the nearest ancestor with a `package.json`) and join `src/skills`,
+ * rather than a `dist`-relative path that would not exist (SKILL.md is not
+ * compiled).
+ */
+export declare function skillsSourceDir(): string;
+/** One agent whose skill dir picopilot's install wired up (from incur's result). */
+export interface WiredAgent {
+    readonly agent: string;
+    readonly path: string;
+    readonly mode: string;
+}
+/** The outcome of installing picopilot's skills. */
+export interface InstallSkillsResult {
+    /** Canonical install paths (one per skill, under `<base>/.agents/skills`). */
+    readonly paths: string[];
+    /** Non-universal agents whose dirs were symlinked/copied to the canonical skills. */
+    readonly agents: WiredAgent[];
+    /** The skill names that were installed. */
+    readonly skills: string[];
+}
+/** Options controlling WHERE and HOW picopilot's skills are installed. */
+export interface InstallSkillsOptions {
+    /**
+     * The picopilot CLI whose command surface the per-command skills are generated
+     * from. Its command map (via {@link Cli.toCommands}) is handed to incur.
+     */
+    readonly cli: Cli.Cli;
+    /**
+     * Install globally (the real default, into `~/.agents/skills` + detected agent
+     * dirs) when true; install project-locally (into `<cwd>/.agents/skills`) when
+     * false. This is the shared-write isolation lever: tests pass `false`.
+     */
+    readonly global: boolean;
+    /**
+     * The install base for a project-local (`global: false`) install and, when a
+     * non-universal agent is detected, the base its symlinks are written under.
+     * Ignored for a global install (that goes to the real home). Tests point this
+     * at a temp dir.
+     */
+    readonly cwd?: string;
+    /**
+     * Override the authored-skills source dir. Defaults to {@link skillsSourceDir}.
+     * Exists so a test can prove isolation using its own fixture skills.
+     */
+    readonly sourceDir?: string;
+}
+/**
+ * Installs picopilot's skills (the authored `picopilot-*` discipline skills plus
+ * the per-command skills incur generates from the CLI) via incur's
+ * `SyncSkills.sync`. This is the real work `init --install-skills` performs.
+ *
+ * The authored skills are pulled in with an ABSOLUTE `include` glob into
+ * {@link skillsSourceDir}, DECOUPLED from `cwd` on purpose: `cwd` selects the
+ * install TARGET, the include glob selects the skills SOURCE. That decoupling is
+ * what lets a test install to a temp `cwd` while still reading the real authored
+ * skills (or its own fixtures), the crux of the isolation contract.
+ */
+export declare function installSkills(options: InstallSkillsOptions): Promise<InstallSkillsResult>;
+//# sourceMappingURL=skills.d.ts.map

package/dist/engine/skills/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/engine/skills/skills.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,GAAG,EAAa,MAAM,OAAO,CAAC;AAEtC;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,WAAW,+IAQd,CAAC;AAEX;;;;;;;;GAQG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAcxC;AAED,oFAAoF;AACpF,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED,oDAAoD;AACpD,MAAM,WAAW,mBAAmB;IACnC,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACzB,qFAAqF;IACrF,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;IAC9B,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACpC;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAClC,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,mBAAmB,CAAC,CA6C9B"}

package/dist/engine/skills/skills.js

@@ -0,0 +1,149 @@
+import { cpSync, existsSync, readdirSync } from 'node:fs';
+import { basename, dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Cli, SyncSkills } from 'incur';
+/**
+ * The engine behind `picopilot init --install-skills`: the ONE picopilot path
+ * that writes to a SHARED/GLOBAL location. incur's `skills add` defaults to a
+ * GLOBAL install (into `~/.agents/skills` plus symlinks into detected agent
+ * dirs like `~/.claude/skills`), so this module is where the work-contract's
+ * shared-write isolation obligation is discharged: every knob that decides the
+ * install TARGET (`global`, `cwd`) is a parameter a test can redirect to a temp
+ * dir, so installing skills can never pollute the real environment in tests.
+ *
+ * The install runs IN-PROCESS through incur's `SyncSkills.sync`. NOTE (incur
+ * 0.4.10): `SyncSkills.sync` / the `skills add` built-in resolve their target
+ * from `os.homedir()` and `process.env` captured AT MODULE LOAD, NOT from the
+ * `env` DI you can pass to `cli.serve(argv, { env })`, so overriding the serve
+ * env does NOT move the install target. The effective in-process lever is
+ * `global: false` + `cwd: <temp dir>`, which installs under `<cwd>/.agents/skills`
+ * (and `<cwd>/.claude/skills` etc.) and leaves the real dirs byte-untouched.
+ */
+/**
+ * The authored picopilot skills (US #20 discipline skills + the game skills),
+ * as SKILL.md files under {@link skillsSourceDir}. They load on-demand by
+ * concern and carry the hard-won workflow knowledge (the `#include` discipline,
+ * the token breakdown, the `gfx render`→look→`gfx set`→fix loop incl. the
+ * non-multimodal fallback, composing in picopilot-MML) so an agent gets it
+ * without bloating every turn.
+ *
+ * The GAME skills are a composed pair (grilled design in
+ * work/notes/ideas/game-jam-design-skill.md): `game-jam` (model-invoked, the
+ * clock+theme discipline) POINTS AT `game-design-reference` (a user-invoked
+ * reference body of universal design principles, `disable-model-invocation`, so
+ * it costs no per-turn context and is reached only by pointer, not fired on a
+ * vague trigger). Both ship engine-packaged here; `game-design-reference`'s
+ * CONTENT is engine-agnostic.
+ *
+ * They ship ALONGSIDE the per-command skills incur auto-generates from the
+ * command surface (`sync: { depth: 1 }`), pulled in via an `include` glob; the
+ * command surface is still growing, so the named discipline skills are authored
+ * rather than tied to a command-group shape that does not exist yet.
+ */
+export const SKILL_NAMES = [
+    'picopilot-overview',
+    'picopilot-code',
+    'picopilot-art',
+    'picopilot-audio',
+    'picopilot-debug',
+    'game-design-reference',
+    'game-jam',
+];
+/**
+ * Resolves the on-disk directory that holds the authored `picopilot-*` SKILL.md
+ * files (`<packageRoot>/src/skills`). The files ship in the npm package (the
+ * package `files` includes `src`), so the same path works from the built
+ * `dist/` runtime and from `src/` under tsx: we walk up from THIS module to the
+ * package root (the nearest ancestor with a `package.json`) and join `src/skills`,
+ * rather than a `dist`-relative path that would not exist (SKILL.md is not
+ * compiled).
+ */
+export function skillsSourceDir() {
+    let dir = dirname(fileURLToPath(import.meta.url));
+    const seen = new Set();
+    while (!seen.has(dir)) {
+        seen.add(dir);
+        if (existsSync(join(dir, 'package.json'))) {
+            return join(dir, 'src', 'skills');
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    // Fallback: two levels up from src/engine/skills is the package root.
+    return join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'skills');
+}
+/**
+ * Installs picopilot's skills (the authored `picopilot-*` discipline skills plus
+ * the per-command skills incur generates from the CLI) via incur's
+ * `SyncSkills.sync`. This is the real work `init --install-skills` performs.
+ *
+ * The authored skills are pulled in with an ABSOLUTE `include` glob into
+ * {@link skillsSourceDir}, DECOUPLED from `cwd` on purpose: `cwd` selects the
+ * install TARGET, the include glob selects the skills SOURCE. That decoupling is
+ * what lets a test install to a temp `cwd` while still reading the real authored
+ * skills (or its own fixtures), the crux of the isolation contract.
+ */
+export async function installSkills(options) {
+    const commands = Cli.toCommands.get(options.cli);
+    if (commands === undefined) {
+        throw new Error('installSkills: the given CLI has no command map (was it built by Cli.create?)');
+    }
+    const source = options.sourceDir ?? skillsSourceDir();
+    const result = await SyncSkills.sync('picopilot', commands, {
+        depth: 1,
+        description: 'An agent-first toolchain for PICO-8 game development.',
+        global: options.global,
+        cwd: options.cwd,
+        // Absolute glob → resolves against `source`, independent of `cwd`.
+        include: [join(source, '*')],
+    });
+    // Ship skill RESOURCE files (everything a skill dir carries besides SKILL.md).
+    // incur 0.4.10's SyncSkills.sync copies ONLY SKILL.md and drops sibling files
+    // (see work/notes/observations/incur-syncskills-drops-skill-resource-files.md),
+    // so genre code references under e.g. `picopilot-code/reference/` would never
+    // reach the installed skill. We backfill them here: for each installed skill
+    // path (canonical + each wired agent), copy the matching source skill's
+    // non-SKILL.md contents in. This stays inside the already-isolated installSkills
+    // seam, so the shared-write isolation test still governs it, and it becomes a
+    // no-op (safe to delete) once incur copies full skill dirs.
+    const installPaths = [...result.paths, ...result.agents.map((a) => a.path)];
+    for (const installedSkillDir of installPaths) {
+        copySkillResources(join(source, basename(installedSkillDir)), installedSkillDir);
+    }
+    return {
+        paths: result.paths,
+        agents: result.agents.map((a) => ({
+            agent: a.agent,
+            path: a.path,
+            mode: a.mode,
+        })),
+        skills: result.skills.map((s) => s.name),
+    };
+}
+/**
+ * Copies a source skill directory's RESOURCE files (everything except SKILL.md)
+ * into an already-installed skill directory. This is the workaround for incur
+ * 0.4.10 shipping only SKILL.md (see the observation referenced in installSkills):
+ * SKILL.md is left to incur (it is already written and may be transformed), and
+ * only the sibling resources are backfilled, recursively, preserving structure.
+ *
+ * Both the source skill and any resources are optional: a skill with no resource
+ * files, or a source dir that does not exist (a command-generated skill with no
+ * authored source), is a silent no-op. Nothing here reaches outside `destDir`,
+ * which is one of the install paths SyncSkills already chose, so it inherits the
+ * shared-write isolation of installSkills (tests redirect those paths to a temp).
+ */
+function copySkillResources(sourceSkillDir, destDir) {
+    if (!existsSync(sourceSkillDir) || !existsSync(destDir))
+        return;
+    for (const entry of readdirSync(sourceSkillDir)) {
+        if (entry === 'SKILL.md')
+            continue; // incur owns the manifest; do not clobber it
+        cpSync(join(sourceSkillDir, entry), join(destDir, entry), {
+            recursive: true,
+        });
+    }
+}
+//# sourceMappingURL=skills.js.map

package/dist/engine/skills/skills.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import type { Cli } from 'incur';
+export { createCli } from './cli.js';
+export { VERSION } from './version.js';
+/**
+ * The default CLI instance, exported for `incur gen` (typed CTAs) and for
+ * embedding picopilot as a Fetch API handler / MCP server.
+ */
+declare const cli: Cli.Cli;
+export default cli;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAC,SAAS,EAAC,MAAM,UAAU,CAAC;AACnC,OAAO,EAAC,OAAO,EAAC,MAAM,cAAc,CAAC;AAErC;;;GAGG;AACH,QAAA,MAAM,GAAG,EAAE,GAAG,CAAC,GAAiB,CAAC;AAEjC,eAAe,GAAG,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+import { createCli } from './cli.js';
+export { createCli } from './cli.js';
+export { VERSION } from './version.js';
+/**
+ * The default CLI instance, exported for `incur gen` (typed CTAs) and for
+ * embedding picopilot as a Fetch API handler / MCP server.
+ */
+const cli = createCli();
+export default cli;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,SAAS,EAAC,MAAM,UAAU,CAAC;AAEnC,OAAO,EAAC,SAAS,EAAC,MAAM,UAAU,CAAC;AACnC,OAAO,EAAC,OAAO,EAAC,MAAM,cAAc,CAAC;AAErC;;;GAGG;AACH,MAAM,GAAG,GAAY,SAAS,EAAE,CAAC;AAEjC,eAAe,GAAG,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,OAAO,QAAgB,CAAC"}

package/dist/version.js

@@ -0,0 +1,19 @@
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * The installed picopilot version, read from the package manifest at load time.
+ *
+ * Single source of truth: the version lives only in `package.json`. The manifest
+ * sits one level above the compiled module (`dist/version.js` → `package.json`)
+ * and one level above the source module (`src/version.ts` → `package.json`), so
+ * the same relative lookup works for both the built binary and `tsx` dev runs.
+ */
+function readVersion() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const manifestPath = join(here, '..', 'package.json');
+    const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+    return manifest.version ?? '0.0.0';
+}
+export const VERSION = readVersion();
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,SAAS,CAAC;AACrC,OAAO,EAAC,OAAO,EAAE,IAAI,EAAC,MAAM,WAAW,CAAC;AACxC,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAC;AAEvC;;;;;;;GAOG;AACH,SAAS,WAAW;IACnB,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAE7D,CAAC;IACF,OAAO,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC"}

package/package.json

@@ -1,4 +1,50 @@
 {
   "name": "picopilot",
-  "version": "0.0.0"
-}
+  "version": "0.1.0",
+  "description": "An agent-first toolchain for PICO-8 game development, built on the incur CLI framework.",
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wighawag/picopilot.git",
+    "directory": "packages/picopilot"
+  },
+  "homepage": "https://github.com/wighawag/picopilot#readme",
+  "bugs": "https://github.com/wighawag/picopilot/issues",
+  "type": "module",
+  "bin": {
+    "picopilot": "./dist/bin.js"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "incur": "0.4.10"
+  },
+  "devDependencies": {
+    "@types/node": "22.12.0",
+    "as-soon": "^0.1.5",
+    "tsx": "4.21.0",
+    "typescript": "5.9.3",
+    "vitest": "3.2.4"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "as-soon -w src pnpm build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "picopilot": "node --import tsx src/bin.ts"
+  }
+}