@aura3d/engine 3.0.0 → 4.0.0

package/dist/aura3d-cli/look/rubric.js

@@ -0,0 +1,169 @@
+/**
+ * PRD-13 §7.6 — `look rubric` / `look judge` data model.
+ *
+ * AGENT_LOOK_CATEGORIES is the 12-category agent judging rubric: the subset of
+ * C-32 GAME_VISUAL_CATEGORIES an agent can move from code (the full list also
+ * covers sound, controls, physics feel, ... that screenshots cannot prove).
+ * The ⊆ assertion lives in tests/unit/cli/look-judge.test.ts.
+ *
+ * CATEGORY_HINTS is the next-change hint table the judge reports: keyed by the
+ * weakest rubric category, it names the concrete @aura3d/engine API to touch —
+ * drawn from aura3d-art-direction/references/look-recipes.md and the lookLint
+ * rule inventory. Keep entries in terms of real exported APIs only.
+ */
+export const AGENT_LOOK_CATEGORIES = [
+    "lighting", "shadows", "ibl_reflections", "environment_world", "atmospheric_effects",
+    "material_quality", "modeling_assets", "composition", "camera", "postprocessing",
+    "animation_quality", "ui_hud"
+];
+export const LOOK_JUDGEMENT_SCHEMA = "aura3d.look-judgement/1";
+/** Genre → recipe row (condensed from look-recipes.md; the doc is the narrative). */
+export const GENRE_RECIPE_ROWS = {
+    platformer: { look: "outdoor-day", camera: "follow (side-on), fov 50", subjectPercent: "18–25", keyLight: "sun 48°/35° 3/4 front", palette: "saturated greens + sky blue + warm wood, coin gold accent", atmosphere: "fog 0.0025", post: "daylight-outdoor" },
+    racing: { look: "golden-hour", camera: "chase, fov 60", subjectPercent: "15–25", keyLight: "low sun 12°/35°", palette: "warm asphalt + burnt orange + charcoal, headlight amber", atmosphere: "fog 30–180 m", post: "cinematic-film" },
+    fighting: { look: "arena-fight", camera: "follow (side-on), fov 45", subjectPercent: "20–30 (pair)", keyLight: "top spot 60°/0°", palette: "arena dark + rope colour + crowd shadow, spotlight rim", atmosphere: "haze cone", post: "arena-fight" },
+    "arena shooter": { look: "space", camera: "orthographic top-down 60°, fov 55", subjectPercent: "10–15 (field)", keyLight: "rim 70°/210°", palette: "deep space blue + graphite + teal, laser magenta", atmosphere: "none (space background exception)", post: "space" },
+    "sports/table": { look: "interior-industrial", camera: "orthographic broadcast 70°, fov 40", subjectPercent: "25–40 (table)", keyLight: "flood 55°/45°", palette: "turf green + line white + crowd dark, ball accent", atmosphere: "indoor haze", post: "arena-fight" },
+    product: { look: "product-studio", camera: "orbit autoframe, fov 35", subjectPercent: "45–70", keyLight: "softbox 45°/30°", palette: "neutral grey + white + metal, one brand accent", atmosphere: "none", post: "product-studio" },
+    character: { look: "character-showcase", camera: "orbit, fov 40", subjectPercent: "50–70", keyLight: "3-point 50°/35°", palette: "costume neutrals + rim pick", atmosphere: "light room haze", post: "product-studio" },
+    "outdoor environment": { look: "overcast", camera: "establishing wide, fov 55", subjectPercent: "vista", keyLight: "sun 50°/40°", palette: "muted green + slate + fog blue, wildflower accent", atmosphere: "fog 0.004", post: "daylight-outdoor" },
+    interior: { look: "interior-warm", camera: "medium orbit, fov 45", subjectPercent: "30–50 (anchor)", keyLight: "window 35°/60°", palette: "warm wood + cream + book spines, plant green", atmosphere: "dust shafts", post: "cinematic-film" },
+    "night city": { look: "night-city", camera: "low tele, fov 35", subjectPercent: "20–35 (street)", keyLight: "neon rim 25°/120°", palette: "sodium orange + neon + dark asphalt, cyan accent", atmosphere: "fog 15–90 m wet street", post: "neon-night" },
+    space: { look: "space", camera: "orbit wide, fov 60", subjectPercent: "30–50 (planet)", keyLight: "star key 30°/180°", palette: "void blue + planet limb + star field, aurora accent", atmosphere: "none (background exception)", post: "space" },
+    underwater: { look: "underwater", camera: "follow, fov 50", subjectPercent: "20–40 (creature)", keyLight: "godray 70°/10°", palette: "deep blue + teal + kelp green, coral accent", atmosphere: "scatter 0.03 caustics", post: "underwater" },
+    cinematic: { look: "polar-night", camera: "establishing dolly, fov 35", subjectPercent: "25–40", keyLight: "moon 20°/300°", palette: "aurora green + snow blue + night, lantern amber", atmosphere: "snow mist 0.006", post: "cinematic-film" }
+};
+/**
+ * Weakest-category → concrete next change. APIs are restricted to the public
+ * @aura3d/engine surface (looks.preset overrides, environments.*, lights.*,
+ * camera.*, effects/post ids) so the hint is always actionable.
+ */
+export const CATEGORY_HINTS = {
+    lighting: { category: "lighting", change: "raise key light or soften ambient so lit:shadow ratio reads ~2:1; move the sun to the recipe's azimuth/elevation", api: "looks.preset(id, { sun: { azimuthDeg, elevationDeg } })" },
+    shadows: { category: "shadows", change: "raise shadow strength toward the look target and pull the key light to an angle that throws visible contact shadows", api: "looks.preset(id, { sun: { azimuthDeg, elevationDeg } })" },
+    ibl_reflections: { category: "ibl_reflections", change: "set the look's environment so metals/glossy materials pick up image-based reflections", api: "environments.hdri(url) or the look's preset env" },
+    environment_world: { category: "environment_world", change: "swap to the genre's env preset or lower fog density so the world reads past the subject", api: "environments.<named>(…) builders" },
+    atmospheric_effects: { category: "atmospheric_effects", change: "add the recipe row's atmosphere (fog scale, haze, shafts) at the look's intensity", api: "looks.preset(id, { fogDensityScale })" },
+    material_quality: { category: "material_quality", change: "move flat materials to PBR values and let IBL drive specular response", api: "material.pbr / the look's material defaults" },
+    modeling_assets: { category: "modeling_assets", change: "replace primitives with typed catalog models sized to the recipe", api: "model(assets.x) after assets resolve/add" },
+    composition: { category: "composition", change: "reframe so the subject fills the recipe's frame-height share", api: "camera.perspective / camera.orbit fov + target" },
+    camera: { category: "camera", change: "switch to the recipe row's rig and fov", api: "camera.follow / camera.orbit / camera.dolly" },
+    postprocessing: { category: "postprocessing", change: "apply the recipe row's post preset instead of hand-tuning render passes", api: "the look's post preset (AuraPostPresetId)" },
+    animation_quality: { category: "animation_quality", change: "play the asset's real clips (idle/run/jump) rather than transform tweens", api: "the asset's clip handle (assets.x animations)" },
+    ui_hud: { category: "ui_hud", change: "reduce HUD to genre-minimal elements over the look's palette", api: "HUD layer over the applied look" }
+};
+/** Lint-code → hint prefix so judge output ties a weak category to the failing rule. */
+export const LINT_CODE_HINTS = {
+    "look/no-lights": { change: "the scene has no light nodes at all", api: "looks.preset(id)" },
+    "look/ambient-kills-ibl": { change: "ambient light washes out the look's image-based lighting", api: "drop lights.ambient or set the env's own ambient" },
+    "look/no-ibl": { change: "materials get no specular response without an environment", api: "environments.hdri / preset env" },
+    "look/weak-shadow": { change: "shadows too weak to read", api: "raise shadow strength on the key light" },
+    "look/low-dpr": { change: "pixel ratio under the tier cap", api: "looks.appOptions(id) pixelRatio" },
+    "look/solid-void": { change: "flat void background", api: "the look's sky/gradient background" },
+    "look/primitive-subject": { change: "hero subject is a primitive", api: "model(assets.x)" },
+    "look/flat-palette": { change: "palette lacks the recipe's base+accent structure", api: "looks.preset(id, { accent })" },
+    "look/double-aa": { change: "two AA passes fighting", api: "the look's single AA choice" },
+    "look/debug-overlay": { change: "debug overlay ships in the frame", api: "turn the overlay off before capture" },
+    "look/multiple-looks": { change: "more than one look applied", api: "one looks.preset per scene" },
+    "look/expansion-mismatch": { change: "look resolved differently than declared", api: "re-run capture; pin the look id" },
+    "look/ambient-flattens": { change: "ambient above the look's ceiling flattens shading", api: "lower ambient intensity" },
+    "look/fake-effect-names": { change: "fake effect names in the source", api: "use the engine's real effect ids" },
+    "look/capture-branch": { change: "behaviour branches on capture params", api: "one code path; captures observe it" }
+};
+export function lookHintFor(category, lintCodes = []) {
+    const lint = lintCodes.map((code) => LINT_CODE_HINTS[code]).find((hint) => hint !== undefined);
+    const base = CATEGORY_HINTS[category];
+    if (lint && base) {
+        return { category, change: `${lint.change} — ${base.change}`, api: lint.api };
+    }
+    if (base)
+        return base;
+    if (lint)
+        return { category, change: lint.change, api: lint.api };
+    return { category, change: "iterate inside the look-dev loop", api: "looks.preset(id)" };
+}
+const CATEGORY_SET = new Set(AGENT_LOOK_CATEGORIES);
+export function validateLookJudgement(value) {
+    const errors = [];
+    if (typeof value !== "object" || value === null) {
+        return { ok: false, errors: ["judgement is not an object"] };
+    }
+    const j = value;
+    if (j.schema !== LOOK_JUDGEMENT_SCHEMA)
+        errors.push(`schema must be ${LOOK_JUDGEMENT_SCHEMA}`);
+    if (typeof j.round !== "number" || !Number.isInteger(j.round) || j.round < 1)
+        errors.push("round must be an integer >= 1");
+    if (!Array.isArray(j.shots) || j.shots.length === 0) {
+        errors.push("shots must be a non-empty array");
+    }
+    else {
+        for (const [i, shot] of j.shots.entries()) {
+            if (typeof shot !== "object" || shot === null) {
+                errors.push(`shots[${i}] is not an object`);
+                continue;
+            }
+            const s = shot;
+            if (typeof s.path !== "string" || s.path.length === 0)
+                errors.push(`shots[${i}].path required`);
+            if (typeof s.sha256 !== "string" || !/^[a-f0-9]{64}$/.test(s.sha256))
+                errors.push(`shots[${i}].sha256 must be 64 hex chars`);
+        }
+    }
+    if (!Array.isArray(j.references))
+        errors.push("references must be an array");
+    if (typeof j.scores !== "object" || j.scores === null) {
+        errors.push("scores must be an object");
+    }
+    else {
+        const scores = j.scores;
+        if (Object.keys(scores).length === 0)
+            errors.push("scores must not be empty");
+        for (const [category, score] of Object.entries(scores)) {
+            if (!CATEGORY_SET.has(category))
+                errors.push(`unknown category "${category}" (must be one of AGENT_LOOK_CATEGORIES)`);
+            if (typeof score !== "number" || score < 0 || score > 10 || (score * 2) % 1 !== 0) {
+                errors.push(`score ${category}=${String(score)} must be 0–10 in 0.5 steps`);
+            }
+        }
+    }
+    if (!Array.isArray(j.observations)) {
+        errors.push("observations must be an array");
+    }
+    else if (typeof j.scores === "object" && j.scores !== null) {
+        const scores = j.scores;
+        const observed = new Set(j.observations.map((o) => o.category).filter((c) => typeof c === "string"));
+        for (const [category, score] of Object.entries(scores)) {
+            if (score < 7 && !observed.has(category)) {
+                errors.push(`score ${category}=${score} < 7 requires at least one observation for that category`);
+            }
+        }
+    }
+    const next = j.nextChange;
+    if (typeof next !== "object" || next === null) {
+        errors.push("nextChange required");
+    }
+    else {
+        for (const key of ["category", "change", "api"]) {
+            if (typeof next[key] !== "string" || next[key].length === 0)
+                errors.push(`nextChange.${key} required`);
+        }
+        if (typeof next.category === "string" && !CATEGORY_SET.has(next.category)) {
+            errors.push(`nextChange.category "${next.category}" is not a rubric category`);
+        }
+    }
+    if (j.judge !== "self" && j.judge !== "prism")
+        errors.push('judge must be "self" or "prism"');
+    return { ok: errors.length === 0, errors };
+}
+export function weakestLookCategory(judgement) {
+    let weakest;
+    let low = Number.POSITIVE_INFINITY;
+    for (const [category, score] of Object.entries(judgement.scores)) {
+        if (typeof score === "number" && score < low) {
+            low = score;
+            weakest = category;
+        }
+    }
+    return weakest;
+}
+//# sourceMappingURL=rubric.js.map

package/dist/aura3d-cli/look/rubric.js.map

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

package/dist/aura3d-cli/meshy/import.d.ts

@@ -1,4 +1,4 @@
-import type { AssetCliResult, AuraAssetQuality, AuraCliAssetRole } from "../asset-core-types.js";
+import type { AssetCliResult, AuraAssetQuality, AuraCliAssetEntry, AuraCliAssetRole } from "../asset-core-types.js";
 import { type MeshyAdmissionReport, type MeshyAssetProfile } from "./admission.js";
 export interface ImportMeshyOptions {
     readonly projectDir?: string;
@@ -11,6 +11,8 @@ export interface ImportMeshyOptions {
     readonly quality?: AuraAssetQuality;
     readonly role?: AuraCliAssetRole;
     readonly profile?: MeshyAssetProfile;
+    /** §6.5 release path: candidate entry id whose --from-generated derived bytes are being imported. */
+    readonly sourceEntry?: string;
 }
 export interface ImportMeshyResult extends AssetCliResult {
     readonly typedKey: string;
@@ -21,5 +23,9 @@ export interface ImportMeshyResult extends AssetCliResult {
     readonly admission: MeshyAdmissionReport;
     readonly nextCommands: readonly string[];
 }
+export interface MeshyReleaseContext {
+    /** The source candidate entry this release import republishes (derived output). */
+    readonly entry: AuraCliAssetEntry;
+}
 export declare function importMeshyAsset(options: ImportMeshyOptions): ImportMeshyResult;
 //# sourceMappingURL=import.d.ts.map

package/dist/aura3d-cli/meshy/import.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/meshy/import.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAGjG,OAAO,EAAqF,KAAK,oBAAoB,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAOtK,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC;CACtC;AACD,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAID,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CA2E/E"}
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/meshy/import.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAGpH,OAAO,EAAqF,KAAK,oBAAoB,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAOtK,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IACrC,qGAAqG;IACrG,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AACD,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAID,MAAM,WAAW,mBAAmB;IAClC,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;CACnC;AA4CD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CA+G/E"}

package/dist/aura3d-cli/meshy/import.js

@@ -1,8 +1,9 @@
-import { readdirSync, realpathSync } from "node:fs";
+import { createHash } from "node:crypto";
+import { readdirSync, readFileSync, realpathSync } from "node:fs";
 import { isAbsolute, relative, resolve } from "node:path";
 import { addAsset, inspectAsset } from "../index.js";
 import { DEFAULT_AURA_ASSET_OUTPUT_DIR, DEFAULT_AURA_ASSET_PUBLIC_PATH } from "../asset-constants.js";
-import { readAssetManifest } from "../asset-manifest.js";
+import { readAssetManifest, writeAssetManifest, writeTypedAssets } from "../asset-manifest.js";
 import { inspectGlbGeometry } from "../asset-screening-effects.js";
 import { createMeshyAdmissionReport, inferMeshyAssetProfile, inspectMeshyTextureDimensions } from "./admission.js";
 import { retainMeshyEvidence } from "./evidence.js";
@@ -11,12 +12,51 @@ import { createMeshyProvenance } from "./provenance.js";
 import { retainMeshyThumbnail } from "./thumbnail.js";
 import { resolveConfinedPath, selectMeshyGlb } from "./validation.js";
 const METADATA_NAMES = new Set(["meta.json", "metadata.json", "task.json"]);
+/**
+ * §6.5 release promotion: Meshy imports reach `release` only through bytes
+ * that ARE a `derived` record produced by `assets optimize --from-generated`
+ * on an existing candidate entry, whose release admission already passed
+ * G1–G11 on those same bytes. `--source-entry <id>` identifies the candidate;
+ * every missing link is listed so the caller sees exactly which gates or
+ * records are absent.
+ */
+function meshyReleaseBlockers(projectDir, options, manifest, sourceFile) {
+    const blockers = [];
+    if (!options.sourceEntry) {
+        blockers.push("--source-entry <id> — the candidate entry whose --from-generated derived output is being imported");
+        return { blockers };
+    }
+    const source = manifest.assets.find((a) => a.id === options.sourceEntry);
+    if (!source) {
+        blockers.push(`source entry "${options.sourceEntry}" is not in aura.assets.json`);
+        return { blockers };
+    }
+    const derived = source.derived;
+    if (!derived) {
+        blockers.push(`entry "${source.id}" has no derived record — run \`assets optimize ${source.id} --from-generated\` first`);
+        return { blockers, source };
+    }
+    const stepNames = new Set(derived.steps.map((s) => s.step));
+    const missingSteps = ["sliver-check", "remesh", "bake"].filter((s) => !stepNames.has(s));
+    if (missingSteps.length > 0) {
+        blockers.push(`derived.steps on "${source.id}" lack ${missingSteps.join(", ")} — not a \`--from-generated\` optimize run (§6.5)`);
+    }
+    const importedHash = `sha256:${createHash("sha256").update(readFileSync(sourceFile)).digest("hex")}`;
+    if (derived.hash !== importedHash) {
+        blockers.push(`imported bytes do not match derived output of "${source.id}" (${derived.hash.slice(0, 16)}… vs ${importedHash.slice(0, 16)}…) — import the file optimize wrote`);
+    }
+    const admission = source.admission;
+    const gateFailures = (admission?.checks ?? []).filter((c) => c.verdict === "fail");
+    if (admission?.status !== "admitted" || admission.quality !== "release" || gateFailures.length > 0) {
+        const which = gateFailures.map((c) => c.gate).join(", ") || "release admission missing";
+        blockers.push(`release admission on "${source.id}" — missing/failed gates: ${which} (run \`assets admit ${source.id} --quality release\`)`);
+    }
+    return { blockers, source };
+}
 export function importMeshyAsset(options) {
     const projectDir = realpathSync(resolve(options.projectDir ?? process.cwd()));
     if (!/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(options.name))
         throw new Error("Meshy asset name must be a safe TypeScript key: " + options.name);
-    if (options.quality === "release")
-        throw new Error("Meshy imports cannot certify release quality. Import as candidate, then complete route evidence and independent human review.");
     const allowedRoot = resolve(projectDir, options.allowedRoot ?? "artifacts/meshy");
     const input = resolveConfinedPath(allowedRoot, isAbsolute(options.input) ? options.input : resolve(projectDir, options.input), "input");
     const sourceFile = selectMeshyGlb(input, options.file);
@@ -35,6 +75,15 @@ export function importMeshyAsset(options) {
     const inspection = inspectAsset({ projectDir, file: relative(projectDir, sourceFile), animation: true, humanoid: true, skeleton: true, morphs: true });
     const geometry = inspectGlbGeometry(sourceFile);
     const manifest = readAssetManifest(projectDir);
+    let releaseContext;
+    if (options.quality === "release") {
+        const { blockers, source } = meshyReleaseBlockers(projectDir, options, manifest, sourceFile);
+        if (blockers.length > 0 || !source) {
+            throw new Error("Meshy release import refused (§6.5): release requires a `derived` record from `assets optimize --from-generated` " +
+                "and a passing G1–G11 admission on the same bytes. Missing:\n  - " + blockers.join("\n  - "));
+        }
+        releaseContext = { entry: source };
+    }
     const thumbnail = retainMeshyThumbnail({
         projectDir,
         inputDir: input,
@@ -57,8 +106,9 @@ export function importMeshyAsset(options) {
         file: relative(projectDir, sourceFile),
         name: options.name,
         type: "model",
-        quality: options.quality ?? "candidate",
-        role: options.role ?? roleForProfile(profile),
+        // release entries land as release only after the §6.5 chain verified.
+        quality: options.quality === "release" ? "release" : (options.quality ?? "candidate"),
+        role: options.role ?? releaseContext?.entry.role ?? roleForProfile(profile),
         sourceFamily: "meshy",
         ...(rights.licenseName ? { license: rights.licenseName, licenseName: rights.licenseName } : {}),
         ...(rights.licenseUrl ? { licenseUrl: rights.licenseUrl } : {}),
@@ -69,6 +119,30 @@ export function importMeshyAsset(options) {
         generation,
         ...(thumbnail ? { renderedProbe: thumbnail.renderedProbe } : {})
     });
+    // §6.5: carry the source entry's verified records onto the release entry —
+    // the imported bytes ARE the derived output (hash-verified above), so
+    // derived/admission/lookDev/artDirection transfer; aliasOf marks the
+    // byte-identity for the dedup ledger.
+    if (releaseContext) {
+        const src = releaseContext.entry;
+        const fresh = readAssetManifest(projectDir);
+        const target = fresh.assets.find((a) => a.id === options.name);
+        if (target) {
+            const patched = {
+                ...target,
+                derived: src.derived,
+                admission: src.admission,
+                lookDev: src.lookDev,
+                ...(src.artDirection ? { artDirection: src.artDirection } : {}),
+                aliasOf: src.id,
+            };
+            writeAssetManifest(projectDir, {
+                ...fresh,
+                assets: fresh.assets.map((a) => (a.id === options.name ? patched : a)),
+            });
+            writeTypedAssets(projectDir, fresh);
+        }
+    }
     const nextCommands = [
         "npx @aura3d/cli assets validate --asset " + options.name + " --require-license",
         "npx @aura3d/cli assets validate --asset " + options.name + " --release --require-license"

package/dist/aura3d-cli/meshy/import.js.map

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

package/dist/aura3d-cli/migrate-three/CompatibilityWarnings.d.ts

@@ -0,0 +1,6 @@
+export interface ThreeCompatCompatibilityWarning {
+    readonly code: string;
+    readonly message: string;
+}
+export declare function createThreeCompatCompatibilityWarnings(source: string): readonly ThreeCompatCompatibilityWarning[];
+//# sourceMappingURL=CompatibilityWarnings.d.ts.map

package/dist/aura3d-cli/migrate-three/CompatibilityWarnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompatibilityWarnings.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/migrate-three/CompatibilityWarnings.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,sCAAsC,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,+BAA+B,EAAE,CAQjH"}

package/dist/aura3d-cli/migrate-three/CompatibilityWarnings.js

@@ -0,0 +1,24 @@
+import { THREE_COMPAT_UNSUPPORTED_THREE_IMPORTS } from "./ImportMap.js";
+import { createR3fMigrationWarnings } from "./R3fMigration.js";
+export function createThreeCompatCompatibilityWarnings(source) {
+    return [
+        ...(/WebGLRenderer/.test(source) ? [{ code: "renderer-adapter", message: "WebGLRenderer setup is mapped to ThreeCompatRenderer/createThreeCompatRenderer." }] : []),
+        ...(/OrbitControls/.test(source) ? [{ code: "controls-adapter", message: "OrbitControls import is mapped to A3D controls." }] : []),
+        ...(/GLTFLoader/.test(source) ? [{ code: "loader-adapter", message: "GLTFLoader import is mapped to ThreeCompat loader diagnostics." }] : []),
+        ...createUnsupportedPostprocessWarnings(source),
+        ...createR3fMigrationWarnings(source)
+    ];
+}
+function createUnsupportedPostprocessWarnings(source) {
+    const matched = THREE_COMPAT_UNSUPPORTED_THREE_IMPORTS.filter((specifier) => source.includes(specifier));
+    if (matched.length === 0)
+        return [];
+    return [{
+            code: "postprocessing-unsupported",
+            message: `Three.js postprocessing imports are not migrated and were left unchanged: ${matched.join(", ")}. `
+                + "Aura3D has no GPU render-target composer equivalent yet; the available production passes operate on CPU pixel buffers "
+                + "and would silently change behaviour. Use @aura3d/engine effects.bloom() for emissive bloom, or keep the Three.js "
+                + "postprocessing stack until an Aura3D composer ships."
+        }];
+}
+//# sourceMappingURL=CompatibilityWarnings.js.map

package/dist/aura3d-cli/migrate-three/CompatibilityWarnings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompatibilityWarnings.js","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/migrate-three/CompatibilityWarnings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sCAAsC,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAO5D,MAAM,UAAU,sCAAsC,CAAC,MAAc;IACnE,OAAO;QACL,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,iFAAiF,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnK,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,iDAAiD,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnI,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,gEAAgE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7I,GAAG,oCAAoC,CAAC,MAAM,CAAC;QAC/C,GAAG,0BAA0B,CAAC,MAAM,CAAC;KACtC,CAAC;AACJ,CAAC;AAED,SAAS,oCAAoC,CAAC,MAAc;IAC1D,MAAM,OAAO,GAAG,sCAAsC,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACzG,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,OAAO,CAAC;YACN,IAAI,EAAE,4BAA4B;YAClC,OAAO,EAAE,6EAA6E,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;kBACxG,wHAAwH;kBACxH,mHAAmH;kBACnH,sDAAsD;SAC3D,CAAC,CAAC;AACL,CAAC"}

package/dist/aura3d-cli/migrate-three/ImportMap.d.ts

@@ -0,0 +1,19 @@
+export declare const THREE_COMPAT_THREE_IMPORT_MAP: Readonly<Record<string, string>>;
+/**
+ * Three.js import specifiers this package deliberately does NOT rewrite.
+ *
+ * WS-3.4 deleted the threejs-compatibility postprocess tree because its passes
+ * reported success without touching a GPU. The remaining production passes
+ * (packages/rendering/src/production-runtime/postprocess) operate on CPU
+ * Uint8Array pixel buffers, not on GPU render targets, so they are not a
+ * behavioural substitute for Three.js EffectComposer. Aliasing the subpath to
+ * them would convert working Three.js code into non-working Aura3D code and
+ * report success — the exact failure WS-3.4 removed.
+ *
+ * Per R7, a migration surface must not preserve broken semantics to claim
+ * coverage. These specifiers are reported as unsupported and left untouched so
+ * the developer sees a real compile error at the import site rather than a
+ * silent behavioural regression at runtime.
+ */
+export declare const THREE_COMPAT_UNSUPPORTED_THREE_IMPORTS: readonly string[];
+//# sourceMappingURL=ImportMap.d.ts.map

package/dist/aura3d-cli/migrate-three/ImportMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImportMap.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/migrate-three/ImportMap.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,6BAA6B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM1E,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,sCAAsC,EAAE,SAAS,MAAM,EASnE,CAAC"}

package/dist/aura3d-cli/migrate-three/ImportMap.js

@@ -0,0 +1,35 @@
+/* Moved verbatim from packages/three-compat/src/migration (PRD-15 T6.2); emitted import targets updated from the deleted @aura3d/three-compat package to @aura3d/engine. */
+export const THREE_COMPAT_THREE_IMPORT_MAP = {
+    three: "@aura3d/engine",
+    "three/addons/controls/OrbitControls.js": "@aura3d/engine",
+    "three/examples/jsm/controls/OrbitControls.js": "@aura3d/engine",
+    "three/addons/loaders/GLTFLoader.js": "@aura3d/engine",
+    "three/examples/jsm/loaders/GLTFLoader.js": "@aura3d/engine"
+};
+/**
+ * Three.js import specifiers this package deliberately does NOT rewrite.
+ *
+ * WS-3.4 deleted the threejs-compatibility postprocess tree because its passes
+ * reported success without touching a GPU. The remaining production passes
+ * (packages/rendering/src/production-runtime/postprocess) operate on CPU
+ * Uint8Array pixel buffers, not on GPU render targets, so they are not a
+ * behavioural substitute for Three.js EffectComposer. Aliasing the subpath to
+ * them would convert working Three.js code into non-working Aura3D code and
+ * report success — the exact failure WS-3.4 removed.
+ *
+ * Per R7, a migration surface must not preserve broken semantics to claim
+ * coverage. These specifiers are reported as unsupported and left untouched so
+ * the developer sees a real compile error at the import site rather than a
+ * silent behavioural regression at runtime.
+ */
+export const THREE_COMPAT_UNSUPPORTED_THREE_IMPORTS = [
+    "three/addons/postprocessing/EffectComposer.js",
+    "three/examples/jsm/postprocessing/EffectComposer.js",
+    "three/addons/postprocessing/RenderPass.js",
+    "three/examples/jsm/postprocessing/RenderPass.js",
+    "three/addons/postprocessing/UnrealBloomPass.js",
+    "three/examples/jsm/postprocessing/UnrealBloomPass.js",
+    "three/addons/postprocessing/ShaderPass.js",
+    "three/examples/jsm/postprocessing/ShaderPass.js"
+];
+//# sourceMappingURL=ImportMap.js.map

package/dist/aura3d-cli/migrate-three/ImportMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImportMap.js","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/migrate-three/ImportMap.ts"],"names":[],"mappings":"AAAA,4KAA4K;AAC5K,MAAM,CAAC,MAAM,6BAA6B,GAAqC;IAC7E,KAAK,EAAE,gBAAgB;IACvB,wCAAwC,EAAE,gBAAgB;IAC1D,8CAA8C,EAAE,gBAAgB;IAChE,oCAAoC,EAAE,gBAAgB;IACtD,0CAA0C,EAAE,gBAAgB;CAC7D,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAsB;IACvE,+CAA+C;IAC/C,qDAAqD;IACrD,2CAA2C;IAC3C,iDAAiD;IACjD,gDAAgD;IAChD,sDAAsD;IACtD,2CAA2C;IAC3C,iDAAiD;CAClD,CAAC"}

package/dist/aura3d-cli/migrate-three/R3fMigration.d.ts

@@ -0,0 +1,32 @@
+import type { ThreeCompatCompatibilityWarning } from "./CompatibilityWarnings.js";
+/**
+ * R3F + CSS2D/CSS3D migration notes (muse3jsparity-PRD V1.4 + N4.3).
+ *
+ * Two explicit non-parity positions, documented where importers look:
+ *
+ * 1. No "R3F parity" claim. The covered-path mapping table lives in
+ *    `@aura3d/react` (`R3F_TO_AURA_MIGRATION_TABLE`: Canvas, Model, Lights,
+ *    Camera, Effect plus `useAuraFrame` / `useAuraApp` / suspense / events /
+ *    the three drei recipes). This lab detects R3F/drei source and points at
+ *    that table instead of rewriting imports it cannot honor.
+ * 2. No `CSS2DRenderer` / `CSS3DRenderer` parity (explicit 2.1 decision).
+ *    `CSS2D_CSS3D_MANUAL_MAP` gives the manual mapping per renderer.
+ */
+/** Where the R3F mapping table lives. A pointer, not a copy — one source of truth. */
+export declare const R3F_MIGRATION_TABLE_POINTER: string;
+export interface Css2DCss3DManualMapping {
+    readonly three: "CSS2DRenderer" | "CSS3DRenderer";
+    readonly aura: string;
+    readonly steps: readonly string[];
+}
+/**
+ * Manual CSS2D/3D mapping for importers (N4 task 3).
+ *
+ * CSS2D annotations map onto world-anchored labels. CSS3D has no Aura
+ * equivalent — in-plane 3D text maps onto G1 SDF text, and anything beyond
+ * that keeps its CSS3DRenderer alongside the canvas (it is DOM; it composes).
+ */
+export declare const CSS2D_CSS3D_MANUAL_MAP: readonly Css2DCss3DManualMapping[];
+/** Source-level R3F/drei/CSS2D/CSS3D detection for the migration lab. */
+export declare function createR3fMigrationWarnings(source: string): readonly ThreeCompatCompatibilityWarning[];
+//# sourceMappingURL=R3fMigration.d.ts.map

package/dist/aura3d-cli/migrate-three/R3fMigration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"R3fMigration.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/migrate-three/R3fMigration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAE/E;;;;;;;;;;;;GAYG;AAEH,sFAAsF;AACtF,eAAO,MAAM,2BAA2B,QAEyB,CAAC;AAElE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe,CAAC;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,uBAAuB,EAmBpE,CAAC;AAyBF,yEAAyE;AACzE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,+BAA+B,EAAE,CAErG"}

package/dist/aura3d-cli/migrate-three/R3fMigration.js

@@ -0,0 +1,70 @@
+/**
+ * R3F + CSS2D/CSS3D migration notes (muse3jsparity-PRD V1.4 + N4.3).
+ *
+ * Two explicit non-parity positions, documented where importers look:
+ *
+ * 1. No "R3F parity" claim. The covered-path mapping table lives in
+ *    `@aura3d/react` (`R3F_TO_AURA_MIGRATION_TABLE`: Canvas, Model, Lights,
+ *    Camera, Effect plus `useAuraFrame` / `useAuraApp` / suspense / events /
+ *    the three drei recipes). This lab detects R3F/drei source and points at
+ *    that table instead of rewriting imports it cannot honor.
+ * 2. No `CSS2DRenderer` / `CSS3DRenderer` parity (explicit 2.1 decision).
+ *    `CSS2D_CSS3D_MANUAL_MAP` gives the manual mapping per renderer.
+ */
+/** Where the R3F mapping table lives. A pointer, not a copy — one source of truth. */
+export const R3F_MIGRATION_TABLE_POINTER = "@aura3d/react exports R3F_TO_AURA_MIGRATION_TABLE (AuraCanvas components plus useAuraFrame/useAuraApp/suspense/events/drei recipes). " +
+    "That table maps covered paths; it is not an R3F-parity claim.";
+/**
+ * Manual CSS2D/3D mapping for importers (N4 task 3).
+ *
+ * CSS2D annotations map onto world-anchored labels. CSS3D has no Aura
+ * equivalent — in-plane 3D text maps onto G1 SDF text, and anything beyond
+ * that keeps its CSS3DRenderer alongside the canvas (it is DOM; it composes).
+ */
+export const CSS2D_CSS3D_MANUAL_MAP = [
+    {
+        three: "CSS2DRenderer",
+        aura: "labels.* world-anchored screen-space labels",
+        steps: [
+            "Replace each CSS2DObject with labels.billboard() or labels.anchor() at the same world position.",
+            "Map CSS2DObject.visible = false to offscreenPolicy: \"hide\" (default is \"clamp\").",
+            "Occlusion dimming is on by default (occlusionAware); set occlusionAware: false to keep the old always-on-top CSS behavior."
+        ]
+    },
+    {
+        three: "CSS3DRenderer",
+        aura: "no equivalent — G1 SDF text for in-plane text, otherwise keep CSS3DRenderer",
+        steps: [
+            "For text rendered in a 3D plane, use G1 SDF text (packages/rendering/src/SdfText.ts) with the uppercase alphanumeric catalog.",
+            "For annotations, use labels.* world-anchored labels instead.",
+            "Anything beyond those two keeps its CSS3DRenderer element alongside the AuraCanvas; it is DOM and composes without a migration."
+        ]
+    }
+];
+const R3F_SOURCE_MARKERS = [
+    {
+        marker: "@react-three/fiber",
+        code: "r3f-manual",
+        message: `R3F imports are not rewritten. Map them manually with ${R3F_MIGRATION_TABLE_POINTER}`
+    },
+    {
+        marker: "@react-three/drei",
+        code: "drei-manual",
+        message: `drei imports are not rewritten. The three covered patterns are cameraControlsRecipe, environmentPresetRecipe, and transformGizmoRecipe in @aura3d/react; everything else stays on drei. ${R3F_MIGRATION_TABLE_POINTER}`
+    },
+    {
+        marker: "CSS2DRenderer",
+        code: "css2d-manual",
+        message: `CSS2DRenderer has no Aura parity target by explicit 2.1 decision. ${CSS2D_CSS3D_MANUAL_MAP[0]?.steps.join(" ") ?? ""}`
+    },
+    {
+        marker: "CSS3DRenderer",
+        code: "css3d-manual",
+        message: `CSS3DRenderer has no Aura parity target by explicit 2.1 decision. ${CSS2D_CSS3D_MANUAL_MAP[1]?.steps.join(" ") ?? ""}`
+    }
+];
+/** Source-level R3F/drei/CSS2D/CSS3D detection for the migration lab. */
+export function createR3fMigrationWarnings(source) {
+    return R3F_SOURCE_MARKERS.filter(({ marker }) => source.includes(marker)).map(({ code, message }) => ({ code, message }));
+}
+//# sourceMappingURL=R3fMigration.js.map

package/dist/aura3d-cli/migrate-three/R3fMigration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"R3fMigration.js","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/migrate-three/R3fMigration.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,sFAAsF;AACtF,MAAM,CAAC,MAAM,2BAA2B,GACtC,uIAAuI;IACvI,+DAA+D,CAAC;AAQlE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAuC;IACxE;QACE,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,6CAA6C;QACnD,KAAK,EAAE;YACL,iGAAiG;YACjG,sFAAsF;YACtF,4HAA4H;SAC7H;KACF;IACD;QACE,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,6EAA6E;QACnF,KAAK,EAAE;YACL,+HAA+H;YAC/H,8DAA8D;YAC9D,iIAAiI;SAClI;KACF;CACF,CAAC;AAEF,MAAM,kBAAkB,GAA4F;IAClH;QACE,MAAM,EAAE,oBAAoB;QAC5B,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,yDAAyD,2BAA2B,EAAE;KAChG;IACD;QACE,MAAM,EAAE,mBAAmB;QAC3B,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,2LAA2L,2BAA2B,EAAE;KAClO;IACD;QACE,MAAM,EAAE,eAAe;QACvB,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,qEAAqE,sBAAsB,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE;KACjI;IACD;QACE,MAAM,EAAE,eAAe;QACvB,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,qEAAqE,sBAAsB,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE;KACjI;CACF,CAAC;AAEF,yEAAyE;AACzE,MAAM,UAAU,0BAA0B,CAAC,MAAc;IACvD,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;AAC5H,CAAC"}