@aura3d/cli 3.0.1 → 4.0.0

package/dist/admission/profiles.d.ts

@@ -0,0 +1,52 @@
+/**
+ * PRD-05 §6.2 — optimize profile table (Phase 0 slice).
+ *
+ * The admission gates (G1 triangle band, G3 PBR completeness) need the profile
+ * triangle floors/ceilings and role→profile resolution inside the CLI, so the
+ * §6.2 table lives here as the single source of truth. Phase 2 adds the full
+ * `AssetOptimizeProfile` (LOD chains, texture encodings, KTX flags) in
+ * `tools/asset-optimize/profiles.ts` re-using these records.
+ */
+import type { AuraCliAssetRole } from "../asset-core-types.js";
+export type AssetOptimizeProfileName = "hero-character" | "npc-character" | "hero-vehicle" | "traffic-vehicle" | "product" | "weapon" | "prop-large" | "prop-small" | "world-chunk" | "track" | "backdrop" | "hdri";
+export interface AdmissionProfile {
+    readonly id: AssetOptimizeProfileName;
+    /** Roles from the §6.2 table that resolve to this profile. */
+    readonly roles: readonly string[];
+    /** G1 admission minimum on LOD0 triangles (undefined = no floor). */
+    readonly trianglesFloor?: number;
+    /** LOD0 optimization target. */
+    readonly trianglesTarget?: number;
+    /** G1 admission maximum on LOD0 triangles. */
+    readonly trianglesCeiling?: number;
+    /** §6.4 default gameplay camera for G2 (entry `gameplayCamera` overrides). */
+    readonly gameplayCamera?: {
+        readonly distance: number;
+        readonly fovDegrees: number;
+    };
+    /** §17.2 derived-file budget (High tier). */
+    readonly fileBytesHigh?: number;
+    /** §17.2 mobile derived-file budget. */
+    readonly fileBytesMobile?: number;
+    /** §17.2 GPU bytes budget (High tier). */
+    readonly gpuBytesHigh?: number;
+    /** §6.4 absolute texel-density floor (px/m effective). */
+    readonly texelFloorPxPerMeter?: number;
+}
+export declare const ADMISSION_PROFILES: Readonly<Record<AssetOptimizeProfileName, AdmissionProfile>>;
+/**
+ * §6.2 role→profile resolution. `bounds` disambiguates `prop` into
+ * `prop-large` (≥ 1 m gameplay-relevant) vs `prop-small` (< 1 m). Roles that
+ * carry no geometry profile (proxy, debug, abstract, unknown, audio,
+ * texture-set, vfx-atlas) return undefined — geometry gates record
+ * `waived-by-role` for them.
+ */
+export declare function profileForRole(role: AuraCliAssetRole | string | undefined, bounds?: readonly number[]): AdmissionProfile | undefined;
+/**
+ * G3 role coverage (PRD-05 §6.4): character/vehicle/product/weapon/world/
+ * track/environment, plus `prop` only when it resolves to `prop-large`
+ * (hero/enemy map onto the character profiles). Takes no free text — the
+ * deleted `requiresTextureEvidence` regex waiver is gone for good.
+ */
+export declare function requiresPbrTextures(role: AuraCliAssetRole | string | undefined, profile: AdmissionProfile | undefined): boolean;
+//# sourceMappingURL=profiles.d.ts.map

package/dist/admission/profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/admission/profiles.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,MAAM,wBAAwB,GAChC,gBAAgB,GAChB,eAAe,GACf,cAAc,GACd,iBAAiB,GACjB,SAAS,GACT,QAAQ,GACR,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,OAAO,GACP,UAAU,GACV,MAAM,CAAC;AAEX,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,wBAAwB,CAAC;IACtC,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,qEAAqE;IACrE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,gCAAgC;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,8CAA8C;IAC9C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,8EAA8E;IAC9E,QAAQ,CAAC,cAAc,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACrF,6CAA6C;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,wCAAwC;IACxC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,0CAA0C;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC;AAID,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,wBAAwB,EAAE,gBAAgB,CAAC,CAa3F,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,EAC3C,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GACzB,gBAAgB,GAAG,SAAS,CA+B9B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAQ/H"}

package/dist/admission/profiles.js

@@ -0,0 +1,91 @@
+/**
+ * PRD-05 §6.2 — optimize profile table (Phase 0 slice).
+ *
+ * The admission gates (G1 triangle band, G3 PBR completeness) need the profile
+ * triangle floors/ceilings and role→profile resolution inside the CLI, so the
+ * §6.2 table lives here as the single source of truth. Phase 2 adds the full
+ * `AssetOptimizeProfile` (LOD chains, texture encodings, KTX flags) in
+ * `tools/asset-optimize/profiles.ts` re-using these records.
+ */
+const MB = 1_000_000;
+export const ADMISSION_PROFILES = {
+    "hero-character": { id: "hero-character", roles: ["character", "hero"], trianglesFloor: 5_000, trianglesTarget: 25_000, trianglesCeiling: 60_000, gameplayCamera: { distance: 4, fovDegrees: 50 }, fileBytesHigh: 6 * MB, fileBytesMobile: 2.5 * MB, gpuBytesHigh: 20 * MB, texelFloorPxPerMeter: 256 },
+    "npc-character": { id: "npc-character", roles: ["enemy"], trianglesFloor: 2_000, trianglesTarget: 10_000, trianglesCeiling: 25_000, gameplayCamera: { distance: 4, fovDegrees: 50 }, fileBytesHigh: 2 * MB, fileBytesMobile: 1 * MB, gpuBytesHigh: 6 * MB, texelFloorPxPerMeter: 256 },
+    "hero-vehicle": { id: "hero-vehicle", roles: ["vehicle"], trianglesFloor: 8_000, trianglesTarget: 40_000, trianglesCeiling: 80_000, gameplayCamera: { distance: 7, fovDegrees: 55 }, fileBytesHigh: 5 * MB, fileBytesMobile: 2 * MB, gpuBytesHigh: 20 * MB, texelFloorPxPerMeter: 128 },
+    "traffic-vehicle": { id: "traffic-vehicle", roles: [], trianglesFloor: 3_000, trianglesTarget: 12_000, trianglesCeiling: 25_000, gameplayCamera: { distance: 7, fovDegrees: 55 }, fileBytesHigh: 1.5 * MB, fileBytesMobile: 0.8 * MB, gpuBytesHigh: 5 * MB, texelFloorPxPerMeter: 128 },
+    "product": { id: "product", roles: ["product"], trianglesFloor: 10_000, trianglesTarget: 60_000, trianglesCeiling: 150_000, gameplayCamera: { distance: 1.5, fovDegrees: 30 }, fileBytesHigh: 8 * MB, fileBytesMobile: 3 * MB, gpuBytesHigh: 32 * MB, texelFloorPxPerMeter: 128 },
+    "weapon": { id: "weapon", roles: ["weapon"], trianglesFloor: 1_500, trianglesTarget: 6_000, trianglesCeiling: 15_000, gameplayCamera: { distance: 1.2, fovDegrees: 60 }, fileBytesHigh: 1 * MB, fileBytesMobile: 0.5 * MB, gpuBytesHigh: 4 * MB, texelFloorPxPerMeter: 96 },
+    "prop-large": { id: "prop-large", roles: ["prop"], trianglesFloor: 500, trianglesTarget: 4_000, trianglesCeiling: 15_000, gameplayCamera: { distance: 6, fovDegrees: 50 }, fileBytesHigh: 1 * MB, fileBytesMobile: 0.5 * MB, gpuBytesHigh: 4 * MB, texelFloorPxPerMeter: 96 },
+    "prop-small": { id: "prop-small", roles: ["prop", "set-dressing"], trianglesFloor: 100, trianglesTarget: 1_000, trianglesCeiling: 5_000, gameplayCamera: { distance: 3, fovDegrees: 50 }, fileBytesHigh: 0.3 * MB, fileBytesMobile: 0.15 * MB, gpuBytesHigh: 1.5 * MB, texelFloorPxPerMeter: 96 },
+    "world-chunk": { id: "world-chunk", roles: ["world", "environment"], trianglesTarget: 120_000, trianglesCeiling: 250_000, gameplayCamera: { distance: 15, fovDegrees: 55 }, fileBytesHigh: 8 * MB, fileBytesMobile: 4 * MB, gpuBytesHigh: 32 * MB, texelFloorPxPerMeter: 64 },
+    "track": { id: "track", roles: ["track"], trianglesTarget: 60_000, trianglesCeiling: 150_000, gameplayCamera: { distance: 15, fovDegrees: 55 }, fileBytesHigh: 6 * MB, fileBytesMobile: 3 * MB, gpuBytesHigh: 24 * MB, texelFloorPxPerMeter: 64 },
+    "backdrop": { id: "backdrop", roles: ["backdrop"], trianglesFloor: 4, trianglesCeiling: 2_000, gameplayCamera: { distance: 30, fovDegrees: 55 }, fileBytesHigh: 1.5 * MB, fileBytesMobile: 0.6 * MB, gpuBytesHigh: 6 * MB },
+    "hdri": { id: "hdri", roles: ["hdri", "environment"], fileBytesHigh: 7 * MB, fileBytesMobile: 1.7 * MB },
+};
+/**
+ * §6.2 role→profile resolution. `bounds` disambiguates `prop` into
+ * `prop-large` (≥ 1 m gameplay-relevant) vs `prop-small` (< 1 m). Roles that
+ * carry no geometry profile (proxy, debug, abstract, unknown, audio,
+ * texture-set, vfx-atlas) return undefined — geometry gates record
+ * `waived-by-role` for them.
+ */
+export function profileForRole(role, bounds) {
+    switch (role) {
+        case "character":
+        case "hero":
+            return ADMISSION_PROFILES["hero-character"];
+        case "enemy":
+            return ADMISSION_PROFILES["npc-character"];
+        case "vehicle":
+            return ADMISSION_PROFILES["hero-vehicle"];
+        case "product":
+            return ADMISSION_PROFILES["product"];
+        case "weapon":
+            return ADMISSION_PROFILES["weapon"];
+        case "prop": {
+            const maxDimension = bounds !== undefined && bounds.length > 0 ? Math.max(...bounds) : 0;
+            return maxDimension >= 1 ? ADMISSION_PROFILES["prop-large"] : ADMISSION_PROFILES["prop-small"];
+        }
+        case "set-dressing":
+            return ADMISSION_PROFILES["prop-small"];
+        case "world":
+        case "environment":
+            return ADMISSION_PROFILES["world-chunk"];
+        case "track":
+            return ADMISSION_PROFILES["track"];
+        case "backdrop":
+            return ADMISSION_PROFILES["backdrop"];
+        case "hdri":
+            return ADMISSION_PROFILES["hdri"];
+        default:
+            return undefined;
+    }
+}
+/**
+ * G3 role coverage (PRD-05 §6.4): character/vehicle/product/weapon/world/
+ * track/environment, plus `prop` only when it resolves to `prop-large`
+ * (hero/enemy map onto the character profiles). Takes no free text — the
+ * deleted `requiresTextureEvidence` regex waiver is gone for good.
+ */
+export function requiresPbrTextures(role, profile) {
+    // Fail-safe: an undeclared/unknown role can claim no exemption — release
+    // admission treats it as texture-required. Roles that resolve to a real
+    // non-PBR profile (prop-small via prop/set-dressing, backdrop, hdri) or no
+    // profile at all (proxy, debug, abstract, texture-set, vfx-atlas, audio)
+    // are legitimately waived.
+    if (role === undefined || role === "unknown")
+        return true;
+    return profile !== undefined && PBR_REQUIRED_PROFILES.has(profile.id);
+}
+const PBR_REQUIRED_PROFILES = new Set([
+    "hero-character",
+    "npc-character",
+    "hero-vehicle",
+    "traffic-vehicle",
+    "product",
+    "weapon",
+    "prop-large",
+    "world-chunk",
+    "track",
+]);
+//# sourceMappingURL=profiles.js.map

package/dist/admission/profiles.js.map

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

package/dist/admission/qrFlags.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `A3D_QR_ASSETS` env resolution for CLI write paths (CONTRACTS §5.2).
+ *
+ * The engine's `resolveQrFlags` lives in `@aura3d/engine` which `@aura3d/cli`
+ * does not depend on, so this mirrors its env-source semantics exactly:
+ * `A3D_QR` list (`all`, `none`, comma tokens with `-name` negations and
+ * `name=value`) applies first, then per-flag `A3D_QR_ASSETS`, with first-set
+ * winning — identical to `applyList`/`applyPerFlagEnv`/`setEntry` in
+ * `packages/engine/src/contracts/flags.ts`.
+ */
+export declare function qrAssetsFlagEnabled(env?: Readonly<Record<string, string | undefined>>): boolean;
+//# sourceMappingURL=qrFlags.d.ts.map

package/dist/admission/qrFlags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qrFlags.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/admission/qrFlags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,GAAG,OAAO,CAsB5G"}

package/dist/admission/qrFlags.js

@@ -0,0 +1,48 @@
+/**
+ * `A3D_QR_ASSETS` env resolution for CLI write paths (CONTRACTS §5.2).
+ *
+ * The engine's `resolveQrFlags` lives in `@aura3d/engine` which `@aura3d/cli`
+ * does not depend on, so this mirrors its env-source semantics exactly:
+ * `A3D_QR` list (`all`, `none`, comma tokens with `-name` negations and
+ * `name=value`) applies first, then per-flag `A3D_QR_ASSETS`, with first-set
+ * winning — identical to `applyList`/`applyPerFlagEnv`/`setEntry` in
+ * `packages/engine/src/contracts/flags.ts`.
+ */
+const LANE_FLAG = "A3D_QR_ASSETS";
+function truthy(value) {
+    if (value === undefined)
+        return undefined;
+    if (value === "0" || value === "off" || value === "false" || value === "")
+        return false;
+    if (value === "1" || value === "on" || value === "true")
+        return true;
+    return true;
+}
+export function qrAssetsFlagEnabled(env = process.env) {
+    let resolved;
+    const list = env.A3D_QR ?? env.VITE_A3D_QR;
+    if (list !== undefined) {
+        const trimmed = list.trim();
+        if (trimmed === "all")
+            resolved = true;
+        else if (trimmed === "none" || trimmed === "")
+            resolved = false;
+        else {
+            for (const token of trimmed.split(",")) {
+                const t = token.trim();
+                if (!t)
+                    continue;
+                const negated = t.startsWith("-");
+                const body = negated ? t.slice(1) : t;
+                const eq = body.indexOf("=");
+                const name = eq >= 0 ? body.slice(0, eq) : body;
+                if (name.toLowerCase() !== "assets")
+                    continue;
+                resolved ??= negated ? false : truthy(eq >= 0 ? body.slice(eq + 1) : "1");
+            }
+        }
+    }
+    resolved ??= truthy(env[LANE_FLAG]);
+    return resolved === true;
+}
+//# sourceMappingURL=qrFlags.js.map

package/dist/admission/qrFlags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qrFlags.js","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/admission/qrFlags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,SAAS,GAAG,eAAe,CAAC;AAElC,SAAS,MAAM,CAAC,KAAyB;IACvC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACxF,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACrE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAoD,OAAO,CAAC,GAAG;IACjG,IAAI,QAA6B,CAAC;IAClC,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,WAAW,CAAC;IAC3C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,OAAO,KAAK,KAAK;YAAE,QAAQ,GAAG,IAAI,CAAC;aAClC,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,EAAE;YAAE,QAAQ,GAAG,KAAK,CAAC;aAC3D,CAAC;YACJ,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;gBACvB,IAAI,CAAC,CAAC;oBAAE,SAAS;gBACjB,MAAM,OAAO,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;gBAClC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACtC,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC7B,MAAM,IAAI,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBAChD,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,QAAQ;oBAAE,SAAS;gBAC9C,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;IACH,CAAC;IACD,QAAQ,KAAK,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IACpC,OAAO,QAAQ,KAAK,IAAI,CAAC;AAC3B,CAAC"}

package/dist/admission/routeGates.d.ts

@@ -0,0 +1,36 @@
+import type { AssetQualityCheck } from "../contracts/assetManifest.js";
+export interface RouteAssetResult {
+    readonly assetId: string;
+    readonly files: readonly string[];
+    readonly quality?: string;
+    readonly role?: string;
+    readonly checks: readonly AssetQualityCheck[];
+    readonly failures: readonly string[];
+    readonly rendererIssues: readonly string[];
+}
+export interface RouteValidationReport {
+    readonly ok: boolean;
+    /** CLI print contract: failures, else a summary line. */
+    readonly messages: readonly string[];
+    readonly route: string;
+    readonly release: boolean;
+    readonly assets: readonly RouteAssetResult[];
+    /** Route-level failures (missing assets, quality bar, proxy roles, G10 mix). */
+    readonly failures: readonly string[];
+    readonly warnings: readonly string[];
+    /** Distinct art-direction ids seen; >1 without `mix` groups fails G10 route coherence. */
+    readonly artDirectionIds: readonly string[];
+    readonly needsGroupSheet: boolean;
+}
+/**
+ * Validates every `assets.<id>` referenced under `route` against the full
+ * §6.4 gate set. `release=true` requires `quality === "release"` AND all
+ * gates green; without `--release` the same table is reported as warnings.
+ */
+export declare function validateRouteAssets(options: {
+    readonly projectDir: string;
+    readonly route: string;
+    readonly release?: boolean;
+    readonly repoRoot?: string;
+}): Promise<RouteValidationReport>;
+//# sourceMappingURL=routeGates.d.ts.map

package/dist/admission/routeGates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeGates.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/admission/routeGates.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AASvE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,0FAA0F;IAC1F,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AA+BD;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAqFjC"}

package/dist/admission/routeGates.js

@@ -0,0 +1,144 @@
+/**
+ * PRD-05 §6.4 route admission — `assets validate --release --route apps/<app>`.
+ *
+ * AST-scans the route's sources for `assets.<id>` usages (the same scan
+ * `assets validate` already runs) and applies every admission gate G1–G11
+ * per referenced asset. The route fails when a referenced asset:
+ *   - holds `quality` below the requested bar (`release` here),
+ *   - holds role `proxy` (builder-provenance stand-in), or
+ *   - fails any gate that could be measured now.
+ *
+ * G10 route coherence: more than one distinct `artDirection` id across the
+ * route's assets requires each doc to declare a `mix` group (and the route
+ * needs a group contact sheet ≥ 6 frames — recorded as `needsGroupSheet`).
+ */
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { readAssetManifest } from "../asset-manifest.js";
+import { validateAssetSource } from "../asset-source-validation.js";
+import { hasStylizedFlatApproval, readArtDirectionDocument } from "./artDirection.js";
+import { admissionModelFromGltf, readAdmissionGltf } from "./glb.js";
+import { runAdmissionGates } from "./gates.js";
+import { measureTexelDensity } from "./texel.js";
+import { measureTextureSanity } from "./textureStats.js";
+import { profileForRole } from "./profiles.js";
+function entryContext(entry, projectDir) {
+    return {
+        id: entry.id,
+        role: entry.role,
+        quality: entry.quality,
+        sourcePath: entry.provenance?.sourcePath ?? entry.source,
+        generationProvider: entry.provenance?.generation?.provider,
+        derivedPresent: entry.derived !== undefined,
+        stylizedFlatApproved: hasStylizedFlatApproval(projectDir, entry),
+        artDirection: entry.artDirection,
+    };
+}
+async function measuredFor(projectDir, entry, model, file, bin, json, repoRoot) {
+    const profile = profileForRole(entry.role, model.boundsSize);
+    const camera = entry.gameplayCamera ?? profile?.gameplayCamera;
+    return {
+        texelDensity: camera ? measureTexelDensity(json, bin, { distance: camera.distance, fovDegrees: camera.fovDegrees, viewportWidth: 1920, viewportHeight: 1080 }) : undefined,
+        texelDensityMobile: camera ? measureTexelDensity(json, bin, { distance: camera.distance, fovDegrees: camera.fovDegrees, viewportWidth: 390, viewportHeight: 844 }) : undefined,
+        textureSanity: await measureTextureSanity(json, bin, dirname(file), repoRoot),
+        derivedFileBytes: entry.derived?.measurements?.after?.fileBytes ?? entry.derived?.measurements?.after?.downloadBytes,
+        gpuBytesHigh: entry.derived?.measurements?.after?.gpuBytesByTier?.high,
+        drawCalls: entry.derived?.measurements?.after?.drawCalls,
+        lookDev: entry.lookDev,
+        auraScore: typeof entry.lookDev?.metrics?.["auraScore"] === "number" ? entry.lookDev.metrics["auraScore"] : undefined,
+        artDirectionDoc: entry.artDirection ? readArtDirectionDocument(projectDir, entry.artDirection) ?? undefined : undefined,
+    };
+}
+/**
+ * Validates every `assets.<id>` referenced under `route` against the full
+ * §6.4 gate set. `release=true` requires `quality === "release"` AND all
+ * gates green; without `--release` the same table is reported as warnings.
+ */
+export async function validateRouteAssets(options) {
+    const projectDir = resolve(options.projectDir);
+    const routeDir = resolve(projectDir, options.route);
+    const release = options.release === true;
+    const manifest = readAssetManifest(projectDir);
+    const failures = [];
+    const warnings = [];
+    if (!existsSync(routeDir)) {
+        const missing = `Route directory does not exist: ${options.route}`;
+        return { ok: false, messages: [missing], route: options.route, release, assets: [], failures: [missing], warnings, artDirectionIds: [], needsGroupSheet: false };
+    }
+    const source = validateAssetSource(projectDir, options.route, manifest);
+    failures.push(...source.failures);
+    warnings.push(...source.warnings);
+    const assetIds = Object.keys(source.filesByAsset).sort();
+    const results = [];
+    const repoRoot = options.repoRoot ?? projectDir;
+    for (const assetId of assetIds) {
+        const files = source.filesByAsset[assetId] ?? [];
+        const entry = manifest.assets.find((asset) => asset.id === assetId);
+        if (!entry) {
+            results.push({ assetId, files, checks: [], failures: [`${assetId}: referenced by ${files.join(", ")} but absent from the manifest.`], rendererIssues: [] });
+            continue;
+        }
+        const entryFailures = [];
+        if (release && entry.quality !== "release") {
+            entryFailures.push(`${assetId}: quality "${entry.quality ?? "unknown"}" is below release — run \`assets admit ${assetId} --quality release\`.`);
+        }
+        if (release && entry.role === "proxy") {
+            entryFailures.push(`${assetId}: role "proxy" (builder provenance) cannot ship on a release route.`);
+        }
+        const file = resolve(projectDir, entry.derived?.outputPath ?? entry.outputPath);
+        let checks = [];
+        let rendererIssues = [];
+        if ((entry.format === "glb" || entry.format === "gltf") && existsSync(file)) {
+            const glb = readAdmissionGltf(file);
+            const model = admissionModelFromGltf(glb.json);
+            const measured = await measuredFor(projectDir, entry, model, file, glb.bin, glb.json, repoRoot);
+            checks = runAdmissionGates(model, entryContext(entry, projectDir), measured);
+            entryFailures.push(...checks.filter((c) => c.verdict === "fail").map((c) => `${assetId}: ${c.message}`));
+            rendererIssues = checks.filter((c) => c.rendererIssue === true).map((c) => `${assetId}: ${c.message}`);
+        }
+        else if (!existsSync(file)) {
+            entryFailures.push(`${assetId}: missing file ${entry.outputPath}`);
+        }
+        results.push({
+            assetId,
+            files,
+            quality: entry.quality,
+            role: entry.role,
+            checks,
+            failures: entryFailures,
+            rendererIssues,
+        });
+        failures.push(...entryFailures);
+    }
+    // G10 route coherence: multiple art-direction ids need mix grouping.
+    const artDirectionIds = [...new Set(results.flatMap((r) => {
+            const entry = manifest.assets.find((a) => a.id === r.assetId);
+            return entry?.artDirection ? [entry.artDirection] : [];
+        }))].sort();
+    let needsGroupSheet = false;
+    if (artDirectionIds.length > 1) {
+        needsGroupSheet = true;
+        const missing = artDirectionIds.filter((id) => {
+            const doc = readArtDirectionDocument(projectDir, id);
+            return !doc?.mix;
+        });
+        if (missing.length > 0) {
+            failures.push(`G10 route coherence: ${missing.join(", ")} lack a "mix" group entry — routes mixing >1 art directions need mix groups + a group contact sheet (≥6 frames).`);
+        }
+    }
+    const report = {
+        ok: failures.length === 0,
+        messages: failures.length === 0
+            ? [`Route ${options.route}: ${results.length} referenced asset(s) passed the §6.4 admission table.`]
+            : failures,
+        route: options.route,
+        release,
+        assets: results,
+        failures,
+        warnings,
+        artDirectionIds,
+        needsGroupSheet,
+    };
+    return report;
+}
+//# sourceMappingURL=routeGates.js.map

package/dist/admission/routeGates.js.map

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

package/dist/admission/texel.d.ts

@@ -0,0 +1,50 @@
+/**
+ * PRD-05 §6.4 G2 — texel-density measurement over real accessor data.
+ *
+ * For every TRIANGLES primitive with POSITION + TEXCOORD_0 (+ indices), the
+ * per-triangle density is:
+ *
+ *   texelsPerMeter(tri) = sqrt(uvArea × textureW × textureH) / sqrt(worldArea)
+ *   texelsPerPixel(tri) = texelsPerMeter × metersPerPixel(camera, viewport)
+ *   metersPerPixel      = 2 × distance × tan(fovY / 2) / viewportHeightPx
+ *
+ * Quantiles (p10/p50/p90) are area-weighted across triangles sharing a
+ * material's base-colour texture, per §6.4 "the ratio of texels per screen
+ * pixel on the asset's median-area triangles ... reported as p10/p50/p90".
+ *
+ * Texture dimensions are sniffed from image headers inside the GLB binary
+ * chunk (PNG IHDR / JPEG SOF / KTX2 header) — no image decode, no deps.
+ * Untextured materials contribute no triangles to the report (G3/G5 already
+ * cover missing textures).
+ */
+import type { AdmissionGltfJson } from "./glb.js";
+export interface TexelCamera {
+    /** Camera-to-bounds-centre distance (m). */
+    readonly distance: number;
+    readonly fovDegrees: number;
+    readonly viewportWidth: number;
+    readonly viewportHeight: number;
+}
+export interface TexelDensityReport {
+    readonly trianglesMeasured: number;
+    /** Triangles skipped (no UVs, non-triangle mode, or untextured material). */
+    readonly trianglesSkipped: number;
+    /** texels/screen-pixel quantiles at the evaluated camera+viewport. */
+    readonly p10?: number;
+    readonly p50?: number;
+    readonly p90?: number;
+    /** Median texels/metre (camera-independent density of the mesh). */
+    readonly texelsPerMeterP50?: number;
+    readonly camera: TexelCamera;
+    /** Texture resolution the median was measured against. */
+    readonly textureSize?: readonly [number, number];
+}
+/** Image header sniff: PNG IHDR (BE u32 @16,20), JPEG SOF (BE u16 height/width), KTX2 (LE u32 @20,24). */
+export declare function sniffImageSize(bytes: Buffer, mime?: string): readonly [number, number] | undefined;
+/**
+ * Measures the texel-density report for a GLB against `camera`. Returns a
+ * report with `trianglesMeasured: 0` when no primitive can be measured —
+ * the gate treats that as "no evidence" rather than a pass.
+ */
+export declare function measureTexelDensity(json: AdmissionGltfJson, bin: Buffer | undefined, camera: TexelCamera): TexelDensityReport;
+//# sourceMappingURL=texel.d.ts.map

package/dist/admission/texel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"texel.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/admission/texel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,6EAA6E;IAC7E,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,sEAAsE;IACtE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClD;AA0DD,0GAA0G;AAC1G,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAyBlG;AAwBD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,kBAAkB,CAgF7H"}