@yali-engine/cli 0.0.0-stage → 0.4.0

package/dist/cmd-create.js

@@ -0,0 +1,248 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { basename, dirname, join, relative, resolve, sep } from 'node:path';
+import { YaliError } from '@yali-engine/core';
+import { ok } from "./output.js";
+/** This CLI's version, from its package.json (one directory up from src/ and from dist/). */
+const CLI_VERSION = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version;
+/** The Yali workspace root above `dir` (it has packages/core named @yali-engine/core), or null. */
+function yaliWorkspace(dir) {
+    for (let d = dir;; d = dirname(d)) {
+        const core = join(d, 'packages/core/package.json');
+        if (existsSync(join(d, 'pnpm-workspace.yaml')) && existsSync(core) && JSON.parse(readFileSync(core, 'utf8')).name === '@yali-engine/core')
+            return d;
+        if (dirname(d) === d)
+            return null;
+    }
+}
+/** The template, file by file. `{{name}}`, `{{port}}` and `{{v}}` (dependency range) are filled in. */
+export const TEMPLATE = {
+    'package.json': `{
+  "name": "{{name}}",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "yali dev",
+    "build": "yali build",
+    "test": "yali test",
+    "bench": "yali bench"
+  },
+  "dependencies": {
+    "@yali-engine/core": "{{v}}",
+    "@yali-engine/render": "{{v}}"
+  },
+  "devDependencies": {
+    "@types/node": "^22.14.0",
+    "@webgpu/types": "^0.1.60",
+    "@yali-engine/cli": "{{v}}",
+    "@yali-engine/vite": "{{v}}",
+    "typescript": "^5.9.0",
+    "vite": "^7.0.0"
+  }
+}
+`,
+    'tsconfig.json': `{
+  "compilerOptions": {
+    "target": "ES2023",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["ES2023", "DOM"],
+    "types": ["node", "@webgpu/types", "vite/client", "@yali-engine/vite/client"],
+    "strict": true,
+    "noEmit": true,
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "erasableSyntaxOnly": true,
+    "skipLibCheck": true
+  },
+  "include": ["src", "test", "vite.config.ts", "yali.config.ts"]
+}
+`,
+    'yali.config.ts': `import { defineConfig } from '@yali-engine/vite';
+
+// port: the dev server refuses any other port rather than drifting.
+// threads: COOP/COEP headers, so SharedArrayBuffer (the threaded core, script workers) works.
+export default defineConfig({
+{{portLine}}  threads: true,
+});
+`,
+    'vite.config.ts': `import { yali } from '@yali-engine/vite';
+import { defineConfig } from 'vite';
+
+export default defineConfig({ plugins: [yali()] });
+`,
+    'index.html': `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>{{name}}</title>
+    <style>
+      html, body { margin: 0; height: 100%; background: #09090c; overflow: hidden; }
+      canvas { position: fixed; inset: 0; width: 100vw; height: 100vh; display: block; }
+    </style>
+  </head>
+  <body>
+    <canvas id="view"></canvas>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>
+`,
+    'public/scene.json': `{
+  "lightDir": [0.45, 0.8, 0.4]
+}
+`,
+    'src/game.ts': `import { type Transforms, worldTools, type YaliPlugin } from '@yali-engine/core';
+import { type RenderContext, rgba8 } from '@yali-engine/render';
+
+/** Grid side: SIDE × SIDE cubes. */
+export const SIDE = 64;
+
+/**
+ * The game as a plugin: a grid of cubes in the ECS and a fixed-step system that bobs them.
+ * Every entity with \`render.Mesh\` is drawn by the render plugin. Gameplay writes
+ * Transform at 60 Hz; rendering reads GlobalTransform, interpolated between fixed steps,
+ * so motion is smooth at any display rate.
+ */
+export function gamePlugin(): YaliPlugin {
+  return {
+    name: 'game',
+    version: '0.1.0',
+    dependencies: [
+      { name: '@yali-engine/render', range: '^0.4.0' },
+      { name: '@yali-engine/transforms', range: '^0.4.0' },
+    ],
+    build(b) {
+      // The App owns the world; these systems run in its Rust schedule.
+      const world = b.app.world;
+      const { Transform, bundle } = b.app.resource<Transforms>('transforms');
+      const render = b.app.resource<RenderContext>('render');
+      const Mesh = render.Mesh!;
+      // Identity rotation, scale 1; \`render.Mesh\` zeroed = mesh 0 (the cube), material 0 (white).
+      world.spawnBatch([...bundle, Mesh], SIDE * SIDE);
+      // Agents query and edit the scene through these (\`yali-mcp\`: world_query, world_set).
+      for (const t of worldTools(world)) b.tool(t);
+      const all = world.query({ with: [Transform, Mesh], columns: [[Transform, 't', 'write'], [Transform, 's', 'write'], [Mesh, 'color', 'write']] });
+      let k = 0;
+      all.forEachChunk((c) => {
+        const p = c.f64(0), s = c.f32(1), color = c.u32(2);
+        for (let i = 0; i < c.length; i++, k++) {
+          p[i * 3] = (k % SIDE) * 2 - SIDE;
+          p[i * 3 + 2] = Math.floor(k / SIDE) * 2 - SIDE;
+          s[i] = 0.8;
+          color[i] = rgba8(0.3 + (0.6 * (k % SIDE)) / SIDE, 0.5, 0.3 + (0.6 * Math.floor(k / SIDE)) / SIDE);
+        }
+      });
+
+      // FixedUpdate runs at 60 Hz whatever the display rate.
+      let t = 0;
+      const heights = world.query({ with: [Transform], columns: [[Transform, 't', 'write']] });
+      const bob = (c: { length: number; f64(i: number): Float64Array }) => {
+        const p = c.f64(0);
+        for (let i = 0; i < c.length; i++) p[i * 3 + 1] = Math.sin(t + p[i * 3] * 0.15 + p[i * 3 + 2] * 0.1);
+      };
+      b.system({ name: 'game.bob', stage: 'FixedUpdate', run: (f) => { t += f.time.fixedDelta; heights.forEachChunk(bob); } });
+
+      render.camera.distance = SIDE * 2.2;
+    },
+  };
+}
+`,
+    'src/main.ts': `import { App, type AssetServer, assetsPlugin, jsonLoader, transformsPlugin } from '@yali-engine/core';
+import { type RenderContext, renderPlugin } from '@yali-engine/render';
+import { assetWatch } from 'virtual:yali/assets';
+import { loadCore, threads } from 'virtual:yali/threads';
+
+import { gamePlugin } from './game.ts';
+
+const canvas = document.getElementById('view') as HTMLCanvasElement;
+// Threaded where the page can run threads (yali dev serves COOP/COEP), single-threaded elsewhere.
+const loaded = await loadCore();
+const app = App.create({
+  core: loaded.core,
+  threads: threads(loaded),
+  plugins: [
+    renderPlugin({ canvas }),
+    // In dev, editing public/scene.json hot-reloads it (no page reload).
+    assetsPlugin({ loaders: [jsonLoader], baseUrl: location.href, watch: assetWatch }),
+    transformsPlugin(),
+    gamePlugin(),
+  ],
+});
+await app.init();
+
+const render = app.resource<RenderContext>('render');
+const scene = app.resource<AssetServer>('assets').load<{ lightDir: [number, number, number] } | null>('scene.json');
+scene.onChange(() => {
+  const s = scene.get();
+  if (s) render.camera.lightDir.set(s.lightDir);
+});
+
+// The tools probe: \`yali bench\` and \`yali inspect --live\` read it.
+(globalThis as { __yali?: unknown }).__yali = {
+  app,
+  profile: (window?: number) => app.profiler.snapshot(window),
+  trace: () => app.profiler.trace(),
+  quality: () => app.quality.knobs(),
+  graph: () => render.graph?.describe() ?? null,
+};
+app.start();
+`,
+    'test/game.test.ts': `import assert from 'node:assert/strict';
+import { test } from 'node:test';
+
+import { App, type YaliPlugin } from '@yali-engine/core';
+
+// Headless: no GPU, no browser. The App is stepped by hand.
+test('a FixedUpdate system runs once per fixed step', async () => {
+  let steps = 0;
+  const counter: YaliPlugin = {
+    name: 'counter',
+    version: '0.1.0',
+    build: (b) => b.system({ name: 'counter.tick', stage: 'FixedUpdate', run: () => void steps++ }),
+  };
+  const app = App.create({ plugins: [counter], frames: { request: () => 0, cancel() {} }, pauseWhenHidden: false });
+  await app.init();
+  app.step(3 / 60);
+  assert.equal(steps, 3);
+  const leaks = await app.dispose();
+  assert.deepEqual(leaks, { gpuResources: 0, listeners: 0, workers: 0, handles: 0 });
+});
+`,
+};
+/** `yali create <dir>`: writes the template. Refuses a non-empty directory. */
+export function createCommand(opts) {
+    if (!opts.dir)
+        throw new YaliError('MISSING_ARGUMENT', 'yali create needs a directory.', 'Run `yali create my-game`.');
+    const dir = resolve(opts.dir);
+    if (existsSync(dir) && readdirSync(dir).length > 0) {
+        throw new YaliError('TARGET_NOT_EMPTY', `${dir} is not empty.`, 'Pick a new directory; create never overwrites files.');
+    }
+    let portLine = '';
+    if (opts.port !== undefined) {
+        const p = Number(opts.port);
+        if (!Number.isInteger(p) || p < 1024 || p > 65535)
+            throw new YaliError('BAD_OPTION', `--port must be 1024–65535, got ${opts.port}.`, 'Pick a free port for this project.');
+        portLine = `  port: ${p},\n`;
+    }
+    const workspace = yaliWorkspace(dir);
+    const name = basename(dir).toLowerCase().replace(/[^a-z0-9-]+/g, '-');
+    // Outside the workspace, the release this CLI belongs to: every @yali-engine package is published at
+    // the same version (`^0.0.0` matched no 0.1.0 package, so a fresh app could not install).
+    const v = workspace ? 'workspace:*' : `^${CLI_VERSION}`;
+    const files = [];
+    for (const [rel, body] of Object.entries(TEMPLATE)) {
+        const path = join(dir, rel);
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, body.replaceAll('{{name}}', name).replaceAll('{{v}}', v).replaceAll('{{portLine}}', portLine));
+        files.push(rel);
+    }
+    const warnings = workspace
+        ? workspace && !relative(workspace, dir).split(sep)[0]?.match(/^(examples|bench|packages)$/)
+            ? [`${relative(workspace, dir)} is outside the workspace globs (packages/*, examples/*, bench/*): pnpm will not link it.`]
+            : []
+        : ['The @yali-engine packages are not published yet: outside the Yali workspace, `pnpm install` cannot resolve them.'];
+    const next = [`cd ${relative(process.cwd(), dir) || '.'}`, workspace ? 'pnpm install (from the workspace root)' : 'pnpm install', 'pnpm dev'];
+    return ok('create', { dir, name, files, workspace, dependencyRange: v, warnings, next }, [`created ${dir}`, ...files.map((f) => `  ${f}`), ...warnings.map((w) => `warning: ${w}`), 'next:', ...next.map((n) => `  ${n}`)]);
+}
+//# sourceMappingURL=cmd-create.js.map

package/dist/cmd-create.js.map

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

package/dist/cmd-dev.d.ts

@@ -0,0 +1,9 @@
+import { type Outcome } from './output.ts';
+/**
+ * `yali dev`: starts the Vite dev server with `@yali-engine/vite` and keeps running. The outcome
+ * (printed once the server listens) carries the URL; Ctrl+C stops it.
+ */
+export declare function devCommand(opts: {
+    root?: string;
+    json: boolean;
+}): Promise<Outcome>;

package/dist/cmd-dev.js

@@ -0,0 +1,24 @@
+import { yali } from '@yali-engine/vite';
+import { createServer } from 'vite';
+import { ok } from "./output.js";
+import { loadProject } from "./project.js";
+/**
+ * `yali dev`: starts the Vite dev server with `@yali-engine/vite` and keeps running. The outcome
+ * (printed once the server listens) carries the URL; Ctrl+C stops it.
+ */
+export async function devCommand(opts) {
+    const project = await loadProject(opts.root);
+    const server = await createServer({
+        root: project.root,
+        configFile: project.viteConfig ?? false,
+        plugins: project.viteConfig ? [] : [yali()],
+        logLevel: opts.json ? 'silent' : 'info',
+    });
+    await server.listen();
+    const url = server.resolvedUrls?.local[0] ?? `http://localhost:${server.config.server.port}/`;
+    const stop = () => void server.close().then(() => process.exit(0));
+    process.once('SIGINT', stop);
+    process.once('SIGTERM', stop);
+    return ok('dev', { url, port: server.config.server.port, root: project.root, threads: project.config.threads }, [`dev server: ${url}`, 'Ctrl+C to stop']);
+}
+//# sourceMappingURL=cmd-dev.js.map

package/dist/cmd-dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmd-dev.js","sourceRoot":"","sources":["../src/cmd-dev.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEpC,OAAO,EAAE,EAAE,EAAgB,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAsC;IACrE,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;QAChC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK;QACvC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM;KACxC,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;IACtB,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,oBAAoB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC;IAC9F,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,eAAe,GAAG,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAC5J,CAAC"}

package/dist/cmd-game.d.ts

@@ -0,0 +1,24 @@
+import { type Outcome } from './output.ts';
+/** One compiler message from cargo, as the result and the stderr stream carry it. */
+export interface GameDiagnostic {
+    readonly level: string;
+    readonly message: string;
+    readonly file?: string;
+    readonly line?: number;
+    readonly column?: number;
+    /** rustc's own rendering, for display. */
+    readonly rendered?: string;
+}
+export interface GameBuildOptions {
+    readonly crate?: string;
+    readonly out?: string;
+    readonly threads: boolean;
+    readonly dev: boolean;
+    /** Runtime plugins to compile in (ADR-0082): `anim`, `physics`, comma-separated. They are
+     *  `yali-core-wasm` features, enabled through the game crate's dependency on it. */
+    readonly features?: string;
+    readonly json: boolean;
+    /** Where --json's event lines go (default stderr). */
+    readonly emit?: (line: string) => void;
+}
+export declare function gameCommand(opts: GameBuildOptions): Promise<Outcome>;

package/dist/cmd-game.js

@@ -0,0 +1,127 @@
+// `yali game`: builds a game crate (ADR-0077) — a cdylib that depends on yali-core-wasm — into
+// the one module the page loads, the core plus the game's Rust systems: `game.wasm`, or
+// `game.threads.wasm` with --threads. Release builds run binaryen's `wasm-opt -O3` (ADR-0074);
+// --dev skips it (the dev server's rebuild on a Rust edit).
+//
+// Scriptable for a CLI, CI or an editor: no prompts, and with --json the result is the one
+// envelope on stdout while progress and cargo's diagnostics stream to stderr as NDJSON
+// (`{ "event": "progress" | "diagnostic", … }`), so a caller can show them as they happen.
+import { spawn, spawnSync } from 'node:child_process';
+import { copyFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { join, resolve } from 'node:path';
+import { createInterface } from 'node:readline';
+import { brotliCompressSync, constants } from 'node:zlib';
+import { YaliError } from '@yali-engine/core';
+import { ok } from "./output.js";
+/** Runtime plugins a core variant can carry (ADR-0082; `yali-core-wasm`'s Cargo features). */
+const CORE_FEATURES = ['anim', 'physics'];
+const TARGET = { single: 'wasm32-unknown-unknown', threads: 'wasm32-wasip1-threads' };
+// The threaded build exports the per-thread setup symbols the host needs to give each worker
+// instance its own stack and TLS (it spawns workers itself, not via std::thread).
+const THREAD_EXPORTS = ['__stack_pointer', '__wasm_init_tls', '__tls_size', '__tls_align'];
+// The features rustc enables for these targets, listed: a game crate's module may carry no
+// target_features section for wasm-opt to detect them from.
+const WASM_FEATURES = ['simd', 'bulk-memory', 'bulk-memory-opt', 'sign-ext', 'nontrapping-float-to-int', 'mutable-globals', 'multivalue', 'reference-types'];
+export async function gameCommand(opts) {
+    const emit = (event) => {
+        if (opts.json)
+            (opts.emit ?? ((l) => process.stderr.write(l)))(`${JSON.stringify(event)}\n`);
+    };
+    if (!opts.crate)
+        throw new YaliError('BAD_OPTION', 'yali game needs --crate <dir>: the game crate.', 'Usage: yali game --crate rust --out wasm [--threads] [--dev].');
+    if (!opts.out)
+        throw new YaliError('BAD_OPTION', 'yali game needs --out <dir>: where game.wasm goes.', 'Usage: yali game --crate rust --out wasm [--threads] [--dev].');
+    const manifest = resolve(opts.crate, 'Cargo.toml');
+    if (!existsSync(manifest))
+        throw new YaliError('NO_CRATE', `No Cargo.toml in ${resolve(opts.crate)}.`, 'Point --crate at the game crate, the directory with its Cargo.toml.');
+    if (spawnSync('cargo', ['--version'], { encoding: 'utf8' }).status !== 0) {
+        throw new YaliError('NO_CARGO', 'cargo is not on PATH.', 'Install Rust with rustup (https://rustup.rs); the toolchain in rust-toolchain.toml is then fetched by itself.');
+    }
+    const target = opts.threads ? TARGET.threads : TARGET.single;
+    const plugins = (opts.features ?? '').split(',').map((f) => f.trim()).filter(Boolean);
+    const unknown = plugins.filter((f) => !CORE_FEATURES.includes(f));
+    if (unknown.length > 0) {
+        throw new YaliError('BAD_OPTION', `Unknown --features ${unknown.join(', ')}.`, `Core features are ${CORE_FEATURES.join(', ')} (ADR-0082), comma-separated.`);
+    }
+    const meta = spawnSync('cargo', ['metadata', '--format-version', '1', '--no-deps', '--manifest-path', manifest], { encoding: 'utf8', maxBuffer: 64 << 20 });
+    if (meta.status !== 0)
+        throw new YaliError('CARGO_METADATA', `cargo metadata failed: ${meta.stderr.trim().split('\n').slice(-3).join(' ')}`, 'Fix the crate manifest; the message is cargo\'s.');
+    const m = JSON.parse(meta.stdout);
+    const name = m.packages.find((p) => resolve(p.manifest_path) === manifest)?.name;
+    if (!name)
+        throw new YaliError('CARGO_METADATA', `cargo metadata did not list ${manifest}.`, 'Make the crate a package (a [package] table), not only a workspace.');
+    emit({ event: 'progress', step: 'cargo', target });
+    const t0 = performance.now();
+    const rustflags = ['-C target-feature=+simd128', ...(opts.threads ? THREAD_EXPORTS.map((s) => `-C link-arg=--export=${s}`) : [])].join(' ');
+    const diagnostics = [];
+    const stderrTail = [];
+    // A dependency's features, named from the selected package: the game depends on yali-core-wasm.
+    const cargoFeatures = plugins.length > 0 ? ['--features', plugins.map((f) => `yali-core-wasm/${f}`).join(',')] : [];
+    const cargo = spawn('cargo', ['build', '--manifest-path', manifest, '-p', name, '--target', target, '--release', '--message-format=json', ...cargoFeatures], {
+        env: { ...process.env, RUSTFLAGS: rustflags },
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    const lines = createInterface({ input: cargo.stdout });
+    lines.on('line', (line) => {
+        let msg;
+        try {
+            msg = JSON.parse(line);
+        }
+        catch {
+            return;
+        }
+        if (msg.reason === 'compiler-message' && msg.message) {
+            const span = msg.message.spans?.find((s) => s.is_primary);
+            const d = { level: msg.message.level, message: msg.message.message, rendered: msg.message.rendered, ...(span ? { file: span.file_name, line: span.line_start, column: span.column_start } : {}) };
+            diagnostics.push(d);
+            emit({ event: 'diagnostic', ...d });
+            // Plain json leaves the rendering to us: shown as cargo would without --json.
+            if (!opts.json && d.rendered)
+                process.stderr.write(d.rendered);
+        }
+        else if (msg.reason === 'compiler-artifact' && msg.target) {
+            emit({ event: 'progress', step: 'compiled', crate: msg.target.name, fresh: msg.fresh === true });
+        }
+    });
+    // cargo's own status lines (Compiling …) and its errors: shown as they come without --json.
+    createInterface({ input: cargo.stderr }).on('line', (line) => {
+        if (line.trim())
+            stderrTail.push(line);
+        if (stderrTail.length > 20)
+            stderrTail.shift();
+        if (!opts.json)
+            process.stderr.write(`${line}\n`);
+    });
+    const code = await new Promise((done) => cargo.on('close', (c) => done(c ?? 1)));
+    if (code !== 0) {
+        const errors = diagnostics.filter((d) => d.level === 'error');
+        const first = errors[0];
+        const where = first?.file ? ` (${first.file}:${first.line})` : '';
+        throw Object.assign(new YaliError('CARGO_BUILD', first ? `${errors.length} error(s); first: ${first.message}${where}` : `cargo build failed: ${stderrTail.slice(-3).join(' ')}`, 'Fix the Rust errors; with --json each one is a diagnostic event on stderr.'), first?.file ? { path: first.file } : {});
+    }
+    const cargoMs = Math.round(performance.now() - t0);
+    const built = join(m.target_directory, target, 'release', `${name.replaceAll('-', '_')}.wasm`);
+    // Named like the core variants (ADR-0084): game[.anim][.physics][.threads].wasm.
+    const outName = `game${CORE_FEATURES.filter((f) => plugins.includes(f)).map((f) => `.${f}`).join('')}${opts.threads ? '.threads' : ''}.wasm`;
+    const outDir = resolve(opts.out);
+    const out = join(outDir, outName);
+    mkdirSync(outDir, { recursive: true });
+    if (opts.dev) {
+        copyFileSync(built, out);
+    }
+    else {
+        emit({ event: 'progress', step: 'wasm-opt' });
+        const wasmOpt = createRequire(import.meta.url).resolve('binaryen/bin/wasm-opt');
+        const features = [...WASM_FEATURES, ...(opts.threads ? ['threads'] : [])];
+        const r = spawnSync(process.execPath, [wasmOpt, '-O3', ...features.map((f) => `--enable-${f}`), built, '-o', out], { encoding: 'utf8' });
+        if (r.status !== 0)
+            throw new YaliError('WASM_OPT', `wasm-opt failed: ${r.stderr.trim().split('\n').slice(-2).join(' ')}`, 'Report it with the message; `--dev` builds without wasm-opt meanwhile.');
+    }
+    const bytes = readFileSync(out);
+    const brotliBytes = brotliCompressSync(bytes, { params: { [constants.BROTLI_PARAM_QUALITY]: 11 } }).length;
+    const warnings = diagnostics.filter((d) => d.level === 'warning').length;
+    const result = { wasm: out, crate: name, target, threads: opts.threads, features: plugins, optimized: !opts.dev, rawBytes: bytes.length, brotliBytes, cargoMs, warnings, diagnostics };
+    return ok('game', result, [`built ${out} (${name}, ${target}) in ${cargoMs} ms: ${(brotliBytes / 1024).toFixed(1)} KB br${opts.dev ? ', not optimized' : ''}${warnings ? `, ${warnings} warning(s)` : ''}`]);
+}
+//# sourceMappingURL=cmd-game.js.map

package/dist/cmd-game.js.map

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

package/dist/cmd-headless.d.ts

@@ -0,0 +1,15 @@
+import { type Outcome } from './output.ts';
+/**
+ * `yali headless`: runs the project's headless entry (`yali.config.ts` → `headless`) for
+ * `--frames` fixed frames with `--seed`, optionally replaying an input recording, and
+ * reports the world hash, the render stub's checksum and the costliest systems
+ * (`runHeadless`, ADR-0041). The same inputs give the same hashes, so a run is a test.
+ */
+export declare function headlessCommand(opts: {
+    root?: string;
+    frames?: string;
+    seed?: string;
+    query?: string;
+    recording?: string;
+    expect?: string;
+}): Promise<Outcome>;

package/dist/cmd-headless.js

@@ -0,0 +1,59 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { runHeadless, YaliError } from '@yali-engine/core';
+import { ok } from "./output.js";
+import { loadProject } from "./project.js";
+/**
+ * `yali headless`: runs the project's headless entry (`yali.config.ts` → `headless`) for
+ * `--frames` fixed frames with `--seed`, optionally replaying an input recording, and
+ * reports the world hash, the render stub's checksum and the costliest systems
+ * (`runHeadless`, ADR-0041). The same inputs give the same hashes, so a run is a test.
+ */
+export async function headlessCommand(opts) {
+    const project = await loadProject(opts.root);
+    const rel = project.config.headless;
+    if (!rel) {
+        throw new YaliError('NO_HEADLESS_ENTRY', 'yali.config has no `headless` entry.', "Add headless: 'src/headless.ts' to yali.config.ts, exporting (ctx: HeadlessContext) => App (see @yali-engine/core).");
+    }
+    const file = resolve(project.root, rel);
+    if (!existsSync(file))
+        throw new YaliError('NO_HEADLESS_ENTRY', `The headless entry ${rel} does not exist.`, 'Fix the `headless` path in yali.config.ts.');
+    const mod = (await import(__rewriteRelativeImportExtension(pathToFileURL(file).href)));
+    if (typeof mod.default !== 'function') {
+        throw new YaliError('BAD_HEADLESS_ENTRY', `${rel} has no default export function.`, 'Export default (ctx: HeadlessContext) => App | Promise<App>.');
+    }
+    const frames = Number(opts.frames ?? 240);
+    const seed = Number(opts.seed ?? 1);
+    if (!Number.isInteger(seed))
+        throw new YaliError('BAD_OPTION', `--seed must be an integer, got ${opts.seed}.`, 'Pass e.g. --seed 1.');
+    const options = Object.fromEntries(new URLSearchParams(opts.query ?? ''));
+    let recording;
+    if (opts.recording) {
+        try {
+            recording = JSON.parse(readFileSync(resolve(opts.recording), 'utf8'));
+        }
+        catch (err) {
+            throw new YaliError('BAD_RECORDING', `Could not read the recording ${opts.recording}: ${err instanceof Error ? err.message : String(err)}`, 'Pass a JSON file written from input.stop_recording.');
+        }
+    }
+    const r = await runHeadless(mod.default, { frames, seed, options, root: project.root, recording });
+    if (opts.expect && r.worldHash !== opts.expect) {
+        throw new YaliError('HASH_MISMATCH', `The world hash is ${r.worldHash}, expected ${opts.expect}.`, 'A change altered the simulation. If it was meant to, update the expected hash.');
+    }
+    const leaked = Object.values(r.leaks).some((n) => n > 0);
+    return ok('headless', r, [
+        `${rel}: ${r.frames} frames, seed ${r.seed}${r.replayed !== null ? `, replayed ${r.replayed} recorded frames` : ''} in ${(r.ms / 1000).toFixed(2)} s`,
+        `world hash ${r.worldHash ?? '(no world)'}  entities ${r.entities ?? '-'}${r.render ? `  render checksum ${r.render.checksum.toString(16)} (${r.render.instances} instances)` : ''}`,
+        `cpu p50 ${r.cpu.p50.toFixed(2)} ms  ${Object.keys(r.systemErrors).length ? `systems that threw: ${JSON.stringify(r.systemErrors)}` : 'no system errors'}${leaked ? `  LEAKS ${JSON.stringify(r.leaks)}` : ''}`,
+    ]);
+}
+//# sourceMappingURL=cmd-headless.js.map

package/dist/cmd-headless.js.map

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

package/dist/cmd-inspect.d.ts

@@ -0,0 +1,13 @@
+import { type Outcome } from './output.ts';
+/**
+ * `yali inspect`: the project as the tools see it — config, build steps and whether they
+ * are stale, budgets, Yali dependencies. With `--live`, also the running app over CDP:
+ * lifecycle state and recent events, profiler snapshot, governor knobs, frame graph.
+ */
+export declare function inspectCommand(opts: {
+    root?: string;
+    live?: boolean;
+    url?: string;
+    cdpPort?: string;
+    probe?: string;
+}): Promise<Outcome>;

package/dist/cmd-inspect.js

@@ -0,0 +1,64 @@
+import { readFileSync } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+import { isStale } from '@yali-engine/vite';
+import { loadBudgets } from "./budgets.js";
+import { openPage } from "./cdp.js";
+import { ok } from "./output.js";
+import { cdpPort, loadProject, pageUrl } from "./project.js";
+/**
+ * `yali inspect`: the project as the tools see it — config, build steps and whether they
+ * are stale, budgets, Yali dependencies. With `--live`, also the running app over CDP:
+ * lifecycle state and recent events, profiler snapshot, governor knobs, frame graph.
+ */
+export async function inspectCommand(opts) {
+    const project = await loadProject(opts.root);
+    const rel = (p) => (p ? relative(project.root, p).split(sep).join('/') : null);
+    const pkg = JSON.parse(readFileSync(join(project.root, 'package.json'), 'utf8'));
+    const yaliDeps = Object.fromEntries(Object.entries({ ...pkg.dependencies, ...pkg.devDependencies }).filter(([k]) => k.startsWith('@yali-engine/')));
+    const builds = project.config.builds.map((s) => ({ name: s.name, stale: isStale(project.root, s), outputs: s.outputs }));
+    const { budgets, file: budgetsFile } = loadBudgets(project.root);
+    const result = {
+        root: project.root,
+        name: pkg.name ?? null,
+        configFile: rel(project.configFile),
+        viteConfig: rel(project.viteConfig),
+        config: { port: project.config.port ?? null, threads: project.config.threads, assetsDir: project.config.assetsDir ?? null },
+        builds,
+        budgets: { file: budgetsFile, ...budgets },
+        dependencies: yaliDeps,
+    };
+    const text = [
+        `${pkg.name ?? '(unnamed)'} at ${project.root}`,
+        `config: ${rel(project.configFile) ?? 'none'}  port ${project.config.port ?? 'auto'}  threads ${project.config.threads}`,
+        ...builds.map((b) => `build step ${b.name}: ${b.stale ? 'STALE' : 'fresh'}`),
+        `budgets: ${budgetsFile ?? 'engine defaults'} (size ${budgets.size_brotli_kb.core_runtime_total} KB, threaded ${budgets.size_brotli_kb.core_runtime_threaded ?? budgets.size_brotli_kb.core_runtime_total} KB, frame ${budgets.frame_ms.desktop} ms)`,
+        `@yali-engine deps: ${Object.entries(yaliDeps).map(([k, v]) => `${k}@${v}`).join(', ') || 'none'}`,
+    ];
+    if (opts.live) {
+        const url = pageUrl(project, opts.url, undefined);
+        const probe = JSON.stringify(opts.probe ?? '__yali');
+        const page = await openPage(url, cdpPort(opts.cdpPort));
+        try {
+            await new Promise((r) => setTimeout(r, 2500));
+            const live = await page.evaluate(`(() => {
+        const p = globalThis[${probe}];
+        if (!p) return null;
+        const app = p.app;
+        return {
+          state: app?.lifecycle?.state ?? null,
+          events: app?.lifecycle?.history?.slice(-10).map((e) => e.type) ?? [],
+          profile: p.profile ? p.profile(60) : null,
+          quality: p.quality ? p.quality() : null,
+          graph: p.graph ? p.graph() : null,
+        };
+      })()`);
+            result.live = live ? { url, ...live, consoleErrors: [...page.errors] } : { url, error: 'no tools probe in the page' };
+            text.push(live ? `live ${url}: ${String(live.state)}, ${live.events.join(' → ')}` : `live ${url}: no tools probe in the page`);
+        }
+        finally {
+            await page.close();
+        }
+    }
+    return ok('inspect', result, text);
+}
+//# sourceMappingURL=cmd-inspect.js.map