@aura3d/cli 4.0.8 → 4.1.1

package/dist/commands/meshyLedger.js

@@ -0,0 +1,308 @@
+/**
+ * `aura3d meshy ledger` — a local credit ledger for paid Meshy generation.
+ *
+ * Bookkeeping only: this module never talks to Meshy and never reads, prints or stores a credential. A wrapper that
+ * calls Meshy (for example through Kiro Prism) reserves credits here BEFORE a paid call and settles the record after.
+ * Per-game caps and one global cap are enforced under a lock, so many agents or shells can share one ledger.
+ *
+ * Lessons baked in:
+ *  - A rate-limited or timed-out poll does not mean the task failed: the task usually finishes and is charged.
+ *    Such a call settles as `unconfirmed` and keeps counting its estimate until `reconcile` proves otherwise.
+ *  - Only a confirmed no-charge outcome (auth/validation/credit errors, a FAILED task) settles as `failed` (counts 0).
+ *  - Every record carries a required game/project tag, and `prefixedName` makes raw download names game-prefixed so
+ *    two games cannot silently reuse each other's `rocks.raw.glb`.
+ */
+import { appendFileSync, existsSync, mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, resolve } from "node:path";
+/** Meshy's published per-operation credit costs (preview 20, refine 10, remesh 5, rigging 5, animate 3, retexture 10). */
+export const MESHY_CREDIT_ESTIMATES = {
+    preview: 20,
+    refine: 10,
+    remesh: 5,
+    rigging: 5,
+    animate: 3,
+    retexture: 10
+};
+export const DEFAULT_MESHY_GLOBAL_CAP = 1000;
+const GAME_TAG = /^[a-z][a-z0-9-]{1,39}$/;
+const STALE_LOCK_MS = 60_000;
+export class MeshyLedgerError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "MeshyLedgerError";
+    }
+}
+export function defaultLedgerPath() {
+    return process.env.AURA3D_MESHY_LEDGER ?? resolve(homedir(), ".aura3d", "meshy-ledger.jsonl");
+}
+function resolveOptions(options) {
+    const envCap = Number(process.env.AURA3D_MESHY_GLOBAL_CAP);
+    return {
+        ledgerPath: resolve(options.ledgerPath ?? defaultLedgerPath()),
+        globalCap: options.globalCap ?? (Number.isFinite(envCap) && envCap > 0 ? envCap : DEFAULT_MESHY_GLOBAL_CAP),
+        lockTimeoutMs: options.lockTimeoutMs ?? 30_000,
+        now: options.now ?? (() => new Date())
+    };
+}
+export function assertGameTag(game) {
+    if (!GAME_TAG.test(game)) {
+        throw new MeshyLedgerError("BAD_GAME_TAG", `Meshy ledger needs a game/project tag like "drift" or "last-train" (lowercase letters, digits, dashes; got "${game}").`);
+    }
+    return game;
+}
+/**
+ * Raw Meshy downloads must carry the game tag so two games never share `rocks.raw.glb`.
+ * `prefixedName("drift", "lamp")` -> `drift-lamp`; an already-prefixed name is returned unchanged.
+ */
+export function prefixedName(game, name) {
+    assertGameTag(game);
+    if (!/^[A-Za-z][A-Za-z0-9_-]*$/.test(name))
+        throw new MeshyLedgerError("BAD_RECORD", `Asset name "${name}" must start with a letter and use letters, digits, "-" or "_".`);
+    return name === game || name.startsWith(`${game}-`) || name.startsWith(`${game}_`) ? name : `${game}-${name}`;
+}
+function sleepSync(ms) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+function pidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === "EPERM";
+    }
+}
+function withLock(resolved, fn) {
+    mkdirSync(dirname(resolved.ledgerPath), { recursive: true });
+    const lock = `${resolved.ledgerPath}.lock.d`;
+    const started = Date.now();
+    for (;;) {
+        try {
+            mkdirSync(lock);
+            writeFileSync(`${lock}/pid`, String(process.pid));
+            break;
+        }
+        catch (error) {
+            if (error.code !== "EEXIST")
+                throw error;
+            let stale = false;
+            try {
+                const owner = Number(readFileSync(`${lock}/pid`, "utf8"));
+                stale = !Number.isFinite(owner) || !pidAlive(owner) || Date.now() - statSync(lock).mtimeMs > STALE_LOCK_MS;
+            }
+            catch {
+                // pid file not written yet (owner is between mkdir and writeFile) or the lock was just released
+                const info = statSync(lock, { throwIfNoEntry: false });
+                if (!info)
+                    continue;
+                stale = Date.now() - info.mtimeMs > 2_000;
+            }
+            if (stale) {
+                rmSync(lock, { recursive: true, force: true });
+                continue;
+            }
+            if (Date.now() - started > resolved.lockTimeoutMs)
+                throw new MeshyLedgerError("LOCK_TIMEOUT", `Meshy ledger lock ${lock} is held by another process.`);
+            sleepSync(50 + Math.floor(Math.random() * 100));
+        }
+    }
+    try {
+        return fn();
+    }
+    finally {
+        rmSync(lock, { recursive: true, force: true });
+    }
+}
+export function readMeshyLedger(options = {}) {
+    const { ledgerPath } = resolveOptions(options);
+    if (!existsSync(ledgerPath))
+        return [];
+    return readFileSync(ledgerPath, "utf8")
+        .split("\n")
+        .filter(Boolean)
+        .map((line) => JSON.parse(line));
+}
+/** Latest record per reservation id wins (fields merge). failed counts 0; reserved/unconfirmed/ok count actual ?? est. */
+export function meshyLedgerTotals(records) {
+    const byRid = new Map();
+    for (const record of records)
+        byRid.set(record.rid, { ...(byRid.get(record.rid) ?? {}), ...record });
+    let spent = 0;
+    let unconfirmed = 0;
+    const byGame = {};
+    const unconfirmedRids = [];
+    for (const record of byRid.values()) {
+        const cost = record.status === "failed" ? 0 : record.actual ?? record.est ?? 0;
+        spent += cost;
+        if (record.game)
+            byGame[record.game] = (byGame[record.game] ?? 0) + cost;
+        if (record.status === "unconfirmed") {
+            unconfirmed += cost;
+            unconfirmedRids.push(record.rid);
+        }
+    }
+    return { spent, unconfirmed, byGame, unconfirmedRids };
+}
+/** Reserve credits before a paid call. Throws MeshyLedgerError (CAP_GLOBAL / CAP_GAME) without writing when over a cap. */
+export function reserveMeshyCredits(input, options = {}) {
+    const resolved = resolveOptions(options);
+    const game = assertGameTag(input.game);
+    const est = input.est ?? MESHY_CREDIT_ESTIMATES[input.op];
+    if (est === undefined || !Number.isFinite(est) || est < 0)
+        throw new MeshyLedgerError("BAD_RECORD", `No credit estimate for op "${input.op}"; pass an explicit estimate.`);
+    if (!Number.isFinite(input.cap) || input.cap <= 0)
+        throw new MeshyLedgerError("BAD_RECORD", "A positive per-game cap is required.");
+    return withLock(resolved, () => {
+        const totals = meshyLedgerTotals(readMeshyLedger(resolved));
+        const gameSpent = totals.byGame[game] ?? 0;
+        if (totals.spent + est > resolved.globalCap) {
+            throw new MeshyLedgerError("CAP_GLOBAL", `REFUSED: global cap ${resolved.globalCap} would be exceeded (spent ${totals.spent}, need ${est}).`);
+        }
+        if (gameSpent + est > input.cap) {
+            throw new MeshyLedgerError("CAP_GAME", `REFUSED: ${game} cap ${input.cap} would be exceeded (spent ${gameSpent}, need ${est}).`);
+        }
+        const rid = `${resolved.now().getTime()}-${Math.random().toString(36).slice(2, 8)}`;
+        const record = { ts: resolved.now().toISOString(), rid, game, op: input.op, est, status: "reserved" };
+        appendFileSync(resolved.ledgerPath, JSON.stringify(record) + "\n");
+        return rid;
+    });
+}
+const ALLOWED = {
+    reserved: ["ok", "failed", "unconfirmed"],
+    unconfirmed: ["ok", "failed", "unconfirmed"],
+    ok: ["ok"],
+    failed: ["failed"]
+};
+/** Settle (or later reconcile) a reservation. `failed` is final; `ok` only accepts a corrected actual. */
+export function settleMeshyCredits(rid, input, options = {}) {
+    const resolved = resolveOptions(options);
+    return withLock(resolved, () => {
+        const records = readMeshyLedger(resolved).filter((record) => record.rid === rid);
+        if (records.length === 0)
+            throw new MeshyLedgerError("UNKNOWN_RID", `Unknown reservation ${rid}.`);
+        const current = records.reduce((merged, record) => ({ ...merged, ...record }), records[0]);
+        if (!ALLOWED[current.status].includes(input.status)) {
+            throw new MeshyLedgerError("BAD_TRANSITION", `Reservation ${rid} is ${current.status}; it cannot become ${input.status}.`);
+        }
+        const next = {
+            ts: resolved.now().toISOString(),
+            rid,
+            status: input.status,
+            ...(input.task_id ? { task_id: input.task_id } : {}),
+            ...(input.actual !== undefined ? { actual: input.actual } : {}),
+            ...(input.note ? { note: input.note } : {})
+        };
+        appendFileSync(resolved.ledgerPath, JSON.stringify(next) + "\n");
+        return { ...current, ...next };
+    });
+}
+/**
+ * Decide how a finished Meshy call settles. A rate limit or timeout without a confirmed result is NOT a failure:
+ * the task may already be charged, so it stays `unconfirmed` (counted) until a `get` confirms it.
+ */
+export function classifyMeshyOutcome(outcome) {
+    const taskStatus = outcome.taskStatus?.toUpperCase();
+    if (taskStatus === "FAILED" || taskStatus === "CANCELED")
+        return { status: "failed", task_id: outcome.taskId, note: `task ${taskStatus}` };
+    if (taskStatus === "SUCCEEDED")
+        return { status: "ok", task_id: outcome.taskId };
+    if (outcome.exitCode === 0)
+        return { status: "ok", task_id: outcome.taskId };
+    if (outcome.taskId)
+        return { status: "unconfirmed", task_id: outcome.taskId, note: `exit ${outcome.exitCode}; task exists, resume with get before paying again` };
+    if ([3, 4, 9].includes(outcome.exitCode))
+        return { status: "failed", note: `exit ${outcome.exitCode}: rejected before a task was created` };
+    return { status: "unconfirmed", note: `exit ${outcome.exitCode}: no task id seen (rate limit or timeout); verify before treating as failed` };
+}
+export function summarizeMeshyLedger(options = {}) {
+    const resolved = resolveOptions(options);
+    const totals = meshyLedgerTotals(readMeshyLedger(resolved));
+    return { globalCap: resolved.globalCap, spent: totals.spent, left: resolved.globalCap - totals.spent, unconfirmed: totals.unconfirmed, unconfirmedRids: totals.unconfirmedRids, byGame: totals.byGame };
+}
+function flag(argv, name) {
+    const index = argv.indexOf(name);
+    const value = index >= 0 ? argv[index + 1] : undefined;
+    return value && !value.startsWith("--") ? value : undefined;
+}
+const LEDGER_USAGE = "aura3d meshy ledger status|reserve|settle|reconcile|list [--ledger path] [--global-cap N]\n" +
+    "  reserve   --game <tag> --op preview|refine|remesh|rigging|animate|retexture [--est N] --cap N   (prints the reservation id)\n" +
+    "  settle    --rid <id> --status ok|failed|unconfirmed [--task-id T] [--actual N] [--note text]\n" +
+    "  settle    --rid <id> --exit-code N [--task-id T] [--task-status SUCCEEDED|FAILED|...]          (classified: a rate limit stays unconfirmed)\n" +
+    "  reconcile --rid <id> --status ok|failed [--task-id T] [--actual N]\n" +
+    "  list      [--game <tag>]";
+export async function meshyLedgerCommand(argv, io) {
+    const sub = argv[0];
+    const capFlag = flag(argv, "--global-cap");
+    const options = {
+        ...(flag(argv, "--ledger") ? { ledgerPath: resolve(io.cwd, flag(argv, "--ledger")) } : {}),
+        ...(capFlag ? { globalCap: Number(capFlag) } : {})
+    };
+    try {
+        if (sub === "status" || sub === undefined) {
+            io.stdout(JSON.stringify(summarizeMeshyLedger(options)));
+            return 0;
+        }
+        if (sub === "reserve") {
+            const game = flag(argv, "--game");
+            const op = flag(argv, "--op");
+            const cap = Number(flag(argv, "--cap"));
+            if (!game || !op || !Number.isFinite(cap)) {
+                io.stderr(LEDGER_USAGE);
+                return 2;
+            }
+            const est = flag(argv, "--est");
+            io.stdout(reserveMeshyCredits({ game, op, cap, ...(est ? { est: Number(est) } : {}) }, options));
+            return 0;
+        }
+        if (sub === "settle" || sub === "reconcile") {
+            const rid = flag(argv, "--rid");
+            if (!rid) {
+                io.stderr(LEDGER_USAGE);
+                return 2;
+            }
+            const taskId = flag(argv, "--task-id");
+            const exitCode = flag(argv, "--exit-code");
+            const status = flag(argv, "--status");
+            let input;
+            if (sub === "settle" && exitCode !== undefined) {
+                input = classifyMeshyOutcome({ exitCode: Number(exitCode), ...(taskId ? { taskId } : {}), ...(flag(argv, "--task-status") ? { taskStatus: flag(argv, "--task-status") } : {}) });
+            }
+            else if (status === "ok" || status === "failed" || status === "unconfirmed") {
+                if (sub === "reconcile" && status === "unconfirmed") {
+                    io.stderr("reconcile settles an unconfirmed reservation to ok or failed.");
+                    return 2;
+                }
+                input = { status, ...(taskId ? { task_id: taskId } : {}), ...(flag(argv, "--actual") ? { actual: Number(flag(argv, "--actual")) } : {}), ...(flag(argv, "--note") ? { note: flag(argv, "--note") } : {}) };
+            }
+            else {
+                io.stderr(LEDGER_USAGE);
+                return 2;
+            }
+            io.stdout(JSON.stringify(settleMeshyCredits(rid, input, options)));
+            return 0;
+        }
+        if (sub === "list") {
+            const game = flag(argv, "--game");
+            const merged = new Map();
+            for (const record of readMeshyLedger(options))
+                merged.set(record.rid, { ...(merged.get(record.rid) ?? {}), ...record });
+            for (const record of merged.values())
+                if (!game || record.game === game)
+                    io.stdout(JSON.stringify(record));
+            return 0;
+        }
+        io.stderr(LEDGER_USAGE);
+        return 2;
+    }
+    catch (error) {
+        if (error instanceof MeshyLedgerError) {
+            io.stderr(error.message);
+            return error.code === "CAP_GLOBAL" || error.code === "CAP_GAME" ? 3 : 1;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=meshyLedger.js.map

package/dist/commands/meshyLedger.js.map

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

package/dist/commands/prd05/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/aura3d-cli/src/commands/prd05/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoKH,OAAO,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/aura3d-cli/src/commands/prd05/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwKH,OAAO,EAAE,CAAC"}

package/dist/commands/prd05/index.js

@@ -9,6 +9,7 @@ import { registerCliCommand, registerCodemod } from "../../contracts/commands.js
 import { admitAsset, admitAssetMeasured } from "./admit.js";
 import { dispatchLookdevRun } from "./lookdev.js";
 import { optimizeAssetsVerb } from "./optimize.js";
+import { optimizeFileVerb } from "../assets/optimizeVerb.js";
 import { reviewAsset } from "./review.js";
 import { assetsLibraryVerb } from "./library.js";
 import { assetsPrune } from "./prune.js";
@@ -120,8 +121,13 @@ registerCliCommand({
     name: "assets optimize",
     owner: "prd05",
     summary: "Optimize assets through the §6.3 step pipeline (tools/asset-optimize).",
-    usage: "aura3d assets optimize <id...> [--profile <id>] [--geometry meshopt|draco|none] [--dry-run] [--allow-local-small] [--ktx <path>] [--report <file>] [--out-dir <dir>] [--no-manifest]",
-    run: async (argv, io) => optimizeAssetsVerb({ projectDir: io.cwd, argv, stdout: io.stdout, stderr: io.stderr }),
+    usage: "aura3d assets optimize --file in.glb --out out.glb [--role hero|vehicle|character|prop|background] [--max-verts N] [--tex N] [--no-simplify] [--meshopt] [--json] | aura3d assets optimize <id...> [--profile <id>] [--geometry meshopt|draco|none] [--dry-run] [--allow-local-small] [--ktx <path>] [--report <file>] [--out-dir <dir>] [--no-manifest]",
+    run: async (argv, io) => {
+        // Direct-file mode: `assets optimize --file in.glb --out out.glb [--role ...]` (no manifest, no admission pipeline).
+        if (readFlag(argv, "--file") !== undefined)
+            return optimizeFileVerb(argv, io);
+        return optimizeAssetsVerb({ projectDir: io.cwd, argv, stdout: io.stdout, stderr: io.stderr });
+    },
 });
 registerCliCommand({
     name: "assets lookdev",

package/dist/commands/prd05/index.js.map

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

package/dist/commands/registry.d.ts

@@ -15,5 +15,6 @@ import "./prd11/index.js";
 import "./prd13/index.js";
 import "./prd14/index.js";
 import "./prd15/index.js";
+import "./assets/index.js";
 export {};
 //# sourceMappingURL=registry.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/commands/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/commands/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,mBAAmB,CAAC;AAE3B,OAAO,EAAE,CAAC"}

package/dist/commands/registry.js

@@ -15,5 +15,6 @@ import "./prd11/index.js";
 import "./prd13/index.js";
 import "./prd14/index.js";
 import "./prd15/index.js";
+import "./assets/index.js";
 export {};
 //# sourceMappingURL=registry.js.map

package/dist/commands/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/commands/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/commands/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,mBAAmB,CAAC;AAE3B,OAAO,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aura3d/cli",
-  "version": "4.0.8",
+  "version": "4.1.1",
   "type": "module",
   "bin": {
     "aura3d": "dist/cli.js",
@@ -28,10 +28,10 @@
   "types": "./dist/index.d.ts",
   "dependencies": {
     "typescript": "^5.8.3",
-    "@aura3d/asset-index": "4.0.8",
-    "@aura3d/audio": "4.0.8",
-    "@aura3d/rendering": "4.0.8",
-    "create-aura3d": "4.0.8"
+    "@aura3d/asset-index": "4.1.1",
+    "@aura3d/audio": "4.1.1",
+    "@aura3d/rendering": "4.1.1",
+    "create-aura3d": "4.1.1"
   },
   "description": "Bring real GLB/glTF assets into Aura3D browser apps with typed references, provenance, catalog search, validation, screenshots, and deploy checks.",
   "keywords": [

package/skills/aura3d-assets/SKILL.md

@@ -78,23 +78,19 @@ lighting you evaluate materials and silhouettes against.
 
    `--source` scans `src` for raw ids, URLs, and loader code, and lists
    `typedAssetUsages`. Add `--no-placeholders --require-license` for anything
-   public. Refresh stale manifest bounds by re-adding the file. Ensure every
-   admitted entry in `aura.assets.json` and `src/aura-assets.ts` carries a valid
-   64-character `sha256-...` `hash` and `public/aura-assets/...` path for clean
-   look and silhouette so `createAssetProvenance(node.asset).source === "typed-aura-assets-manifest"`
-   preserves PBR lighting, palette, contrast, and reflection in the production
-   glTF bridge. Never omit `hash` in custom `defineAuraAssets(...)` /
-   `defineAssets` declarations (keeps look and shadow intact) and never place
-   unhashed duplicate GLBs in route-local `apps/<route>/public/aura-assets/`
-   that collide with root `public/aura-assets/` (keeps composition readable).
+   public. Refresh stale manifest bounds by re-adding the file. Every admitted
+   entry in `aura.assets.json` and `src/aura-assets.ts` needs a valid 64-character
+   `sha256-...` `hash` and a `public/aura-assets/...` path: the production glTF
+   bridge only accepts `createAssetProvenance(node.asset).source ===
+   "typed-aura-assets-manifest"`. Never omit `hash` in `defineAuraAssets(...)`
+   and never place unhashed duplicate GLBs in route-local
+   `apps/<route>/public/aura-assets/` that collide with root `public/aura-assets/`.
 7. Use the key as generated. Every character, athlete, enemy, vehicle, weapon,
-   tree, and landmark must mount a real 3D GLB via `model(assets.<name>,
-   { targetMaxDimension, role })` for a readable silhouette — use `targetHeight`
-   only for upright humanoids and `targetMaxDimension` for vehicles, rackets,
-   paddles, weapons, and wide props so aspect ratios never stretch vertically;
-   drive rigged characters (`skins > 0`) with `handle.setAnimation({ clip,
-   loop: true, speed })` so limbs articulate under the key light and shadow; and
-   never build stick-figure humans or box cars from primitives.
+   tree, and landmark mounts a real 3D GLB via `model(assets.<name>,
+   { targetMaxDimension, role })`: `targetHeight` only for upright humanoids,
+   `targetMaxDimension` for vehicles, rackets, weapons, and wide props. Drive
+   rigged characters (`skins > 0`) with `handle.setAnimation({ clip, loop: true,
+   speed })`, and never build stick-figure humans or box cars from primitives.
 
    ```ts
    import { createAuraApp, groundedRenderedAssetPlacement, looks, model, scene } from "@aura3d/engine";
@@ -109,7 +105,15 @@ lighting you evaluate materials and silhouettes against.
    });
    ```
 
-8. Hand off: fighters and games to `aura3d-browser-game`
+8. Games and examples without a project manifest declare models with
+   `defineModelAssets` (same-origin URL, `sha256`, license; `?models=0` falls
+   back to a procedural stand-in) and never use an http(s) URL: the production
+   bridge refuses it and the scene draws nothing. Admit generated models in an
+   isolated project: `assets import-meshy <dir> --into <assets-dir> --prefix
+   <game> --name <role>`. Never run `import-meshy`, `validate` or `typegen` from
+   the repo root while other work is open: they rewrite `aura.assets.json`,
+   `src/aura-assets.ts` (a 100k-line diff) and `public/aura-assets/*`.
+9. Hand off: fighters and games to `aura3d-browser-game`
    (`assets validate-game`), rigs and clips to `aura3d-character-animation`
    (`assets validate-animation`), release checks to `aura3d-evidence-review`.
 
@@ -122,10 +126,9 @@ lighting you evaluate materials and silhouettes against.
 - bounds are extreme, pivot is bad, or orientation is unknown and public APIs
   cannot correct it;
 - the hash duplicates another asset without an explanation;
-- a generated Meshy GLB has not been decimated and compressed before admission
-  (`> 20,000` vertices, `> 2 MB`, 32-bit indices instead of 16-bit `Uint16Array`
-  with `byteStride === 0`, or `> 1024x1024` textures that stall glTF parsing and
-  exhaust GPU memory across the scene's look, lighting, and atmosphere);
+- a generated Meshy GLB has not been through `assets optimize --file in.glb --out
+  out.glb --role prop` (role budgets: prop 6k, character 30k, hero or vehicle 40k
+  vertices; textures capped at 1024 to 2048 px; 16-bit indices);
 - it is placeholder-like, or only a generated thumbnail proves it is readable.
 
 ## Stop and report
@@ -134,13 +137,12 @@ lighting you evaluate materials and silhouettes against.
   reject list: stop, list the query, profile, and rejection reasons, and offer
   two options: a user-supplied licensed file, or Meshy generation (load
   `meshy-cli`, dry run first). Do not model the subject from primitives.
-- Search prints a catalog fetch warning (for example an HTTP 404 from the
-  index): report it verbatim, label asset-dependent work `blocked`, and do not
-  treat fallback deep-links as auto-pullable.
+- Search prints a catalog fetch warning (for example an HTTP 404): report it
+  verbatim, label asset-dependent work `blocked`, and never treat fallback
+  deep-links as auto-pullable.
 - `assets validate --release` fails on provenance: keep the route `prototype`
   until durable evidence is added; never weaken the check.
-- A needed key is absent from `src/aura-assets.ts` after typegen: stop and fix
-  the admission.
+- A needed key is absent from `src/aura-assets.ts` after typegen: fix the admission.
 
 ## References
 

package/skills/aura3d-browser-game/SKILL.md

@@ -69,11 +69,11 @@ Genre → recipe row (full table: `../aura3d-art-direction/references/look-recip
 
 2. The look supplies sky light, key shadow, fog, and grade — never stack extra
    `lights.studio()` / `lights.directional()` on top, pass `{ fogDensityScale: 0,
-   exposureEv: -0.1 }` to `looks.preset(...)` and
-   `qualityRebuild: { flags: ["game", "-compiler", "-post", "-vfxFog"] }` on fast
-   arcade routes so contrast and frame pacing stay crisp, and never set
-   `emissive: "#ffffff"` on instanced pool materials (`instanceColors` multiply
-   `u_baseColor`, not `u_emissiveColor`).
+   exposureEv: -0.1 }` to `looks.preset(...)` if fog whitewashes a fast route,
+   and never pin post-processing or the compiler off with a `qualityRebuild` flag
+   list (the engine defaults are right; install the safety net instead), and never
+   set `emissive: "#ffffff"` on instanced pool materials (`instanceColors`
+   multiply `u_baseColor`, not `u_emissiveColor`).
 3. Mount typed 3D GLBs for every character, athlete, enemy, vehicle, weapon,
    tree, and landmark (`model(assets.<name>, { targetMaxDimension, role })`,
    emissive 3–5 on pickups, and explicit `material: material.pbr({ color })` on
@@ -85,8 +85,8 @@ Genre → recipe row (full table: `../aura3d-art-direction/references/look-recip
    instead of sliding rigid statues. Never build stick-figure humans or box cars
    from primitives; ground `model()` actors (`minY = 0`) at `y + sy / 2` of
    centered platforms; wind custom `primitives.mesh` triangles CCW from `+Y`; and
-   decimate/compress Meshy GLBs (`<= 20,000` vertices, `<= 2 MB`, 16-bit indices,
-   `<= 1024x1024` textures, valid 64-char `sha256-...` `hash` for clean look).
+   run Meshy GLBs through `assets optimize --role` before admission and mount
+   them with a valid 64-char `sha256-...` `hash` (`defineModelAssets`).
 4. Camera state drives `app.camera` every frame — size `html, body, #app, canvas`
    to `100vw × 100vh` (`position: fixed; inset: 0`), extend the 3D ground apron
    deep in `+Z`/`-Z` so the bottom frame is never a black void, disable
@@ -117,13 +117,16 @@ Genre → recipe row (full table: `../aura3d-art-direction/references/look-recip
    `assets certify-game-geometry --asset track --category racing`.
 9. Runtime evidence: pause, step one frame, then `game.evidence` over input,
    bodies, events, HUD, and look state — see `aura3d-evidence-review` (one link).
+10. Build the shell from the kits, not by hand: `@aura3d/engine/game` (HUD, touch,
+    session, sound), `installQaHooks` + `createFixedStepLoop` for deterministic
+    replay, `createCueBank` for sound, `installSafetyNet` for `?diag=1` and
+    black-frame self-heal — [kits and hooks](references/kits-and-hooks.md).
 
 ## Look-dev loop
 
-Run the `aura3d look capture` → judge → iterate loop from
-`aura3d-art-direction`: lint first (`aura3d look lint`), then the weakest
-rubric category; one change per round until every category reads 7+, 6
-rounds, or 2 flat rounds.
+Run the `aura3d look capture` → judge → iterate loop from `aura3d-art-direction`:
+lint first (`aura3d look lint`), then the weakest rubric category; one change
+per round until every category reads 7+, 6 rounds, or 2 flat rounds.
 
 ## Stop and report
 
@@ -134,8 +137,7 @@ rounds, or 2 flat rounds.
 - The primary player, vehicle, or world is a primitive stand-in: `prototype`.
 - `assets validate-game` crashes or fails: report the exact message, label
   `blocked` for public claims.
-- A kit is missing a needed rule (fail state, collision semantics, path
-  alignment): write it route-local, say so, file a library gap.
+- A kit is missing a needed rule: write it route-local, say so, file a gap.
 - Benchmark mode without `look capture`: build, stop, label `prototype`.
 
 ## References
@@ -147,3 +149,4 @@ rounds, or 2 flat rounds.
 - [Game example standards](https://github.com/auraoneai/aura3d/blob/main/docs/agents/game-example-standards.md)
 - [Game runtime API](https://github.com/auraoneai/aura3d/blob/main/docs/api/game-runtime.md)
 - [Genre looks in the frame](references/genre-looks.md)
+- [Kits and hooks (4.1)](references/kits-and-hooks.md)