@aura3d/cli 3.0.1 → 4.0.0

package/dist/commands/prd05/optimize.js

@@ -0,0 +1,55 @@
+/**
+ * `aura3d assets optimize` (PRD-05 §6.3, Phase 2).
+ *
+ * Shells to the lane-owned `tools/asset-optimize` pipeline (gltf-transform +
+ * ktx) so the CLI keeps zero new dependencies. The tool's pinned deps live in
+ * `tools/asset-optimize/` (CONTRACTS §4.4); on CI `asset-optimize.yml` runs
+ * `npm ci` there first.
+ */
+import { execFileSync, spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join, resolve } from "node:path";
+function readFlag(argv, name) {
+    const i = argv.indexOf(name);
+    const v = i >= 0 ? argv[i + 1] : undefined;
+    return v && !v.startsWith("--") ? v : undefined;
+}
+export function optimizeAssetsVerb(opts) {
+    const { argv, stdout, stderr } = opts;
+    const repoRoot = resolve(opts.projectDir);
+    const toolEntry = join(repoRoot, "tools", "asset-optimize", "index.ts");
+    if (!existsSync(toolEntry)) {
+        stderr("tools/asset-optimize/index.ts missing — Phase 2 not installed in this checkout.");
+        return 1;
+    }
+    const positional = argv.filter((a) => !a.startsWith("--") && !["--profile", "--geometry", "--ktx", "--report", "--remote", "--blender"].includes(argv[argv.indexOf(a) - 1] ?? ""));
+    const ids = readFlag(argv, "--ids")?.split(",").filter(Boolean) ?? positional;
+    const dryRun = argv.includes("--dry-run");
+    const args = [
+        "--tsconfig", join(repoRoot, "tsconfig.base.json"),
+        toolEntry,
+        ...(ids.length ? ["--ids", ids.join(",")] : []),
+        ...(dryRun ? ["--dry-run"] : []),
+        ...(argv.includes("--allow-local-small") ? ["--allow-local-small"] : []),
+        ...(argv.includes("--from-generated") ? ["--from-generated"] : []),
+        ...["--profile", "--geometry", "--ktx", "--report", "--remote", "--blender"].flatMap((f) => {
+            const v = readFlag(argv, f);
+            return v ? [f, v] : [];
+        })
+    ];
+    const tsx = join(repoRoot, "node_modules", ".bin", process.platform === "win32" ? "tsx.cmd" : "tsx");
+    const toolDeps = join(repoRoot, "tools", "asset-optimize", "node_modules", "@gltf-transform");
+    if (!existsSync(toolDeps)) {
+        stderr("tools/asset-optimize deps not installed — run `npm ci --prefix tools/asset-optimize` (asset-optimize.yml does this on CI).");
+        return 1;
+    }
+    const cmd = existsSync(tsx) ? tsx : "npx";
+    const cmdArgs = existsSync(tsx) ? args : ["-y", "tsx", ...args];
+    const r = spawnSync(cmd, cmdArgs, { cwd: repoRoot, stdio: "inherit" });
+    if (r.error) {
+        stderr(`optimize failed to start: ${String(r.error)}`);
+        return 1;
+    }
+    return r.status ?? 1;
+}
+//# sourceMappingURL=optimize.js.map

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

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

package/dist/commands/prd05/prune.d.ts

@@ -0,0 +1,26 @@
+/**
+ * PRD-05 Phase 6 — `assets prune`: removes files under the manifest
+ * `outputDir` (default `public/aura-assets`) that no manifest entry
+ * references via `outputPath`/`derived.*` URLs. `--dry-run` (the default)
+ * only reports; `--apply` deletes.
+ */
+export interface AssetPruneRow {
+    readonly path: string;
+    readonly bytes: number;
+    readonly lfsPointer: boolean;
+}
+export interface AssetPruneResult {
+    readonly ok: boolean;
+    readonly applied: boolean;
+    readonly removed: readonly AssetPruneRow[];
+    readonly bytesFreed: number;
+    readonly referencedCount: number;
+    readonly scannedCount: number;
+    readonly outputDir: string;
+}
+export declare function assetsPrune(options?: {
+    readonly projectDir?: string;
+    readonly apply?: boolean;
+    readonly stdout?: (line: string) => void;
+}): AssetPruneResult;
+//# sourceMappingURL=prune.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prune.d.ts","sourceRoot":"","sources":["../../../../../../packages/aura3d-cli/src/commands/prd05/prune.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AAEH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,WAAW,CAAC,OAAO,GAAE;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,GAAG,gBAAgB,CAuCxB"}

package/dist/commands/prd05/prune.js

@@ -0,0 +1,104 @@
+import { existsSync, readdirSync, readFileSync, statSync, unlinkSync } from "node:fs";
+import { join, resolve, sep } from "node:path";
+import { readAssetManifest } from "../../asset-manifest.js";
+export function assetsPrune(options = {}) {
+    const projectDir = resolve(options.projectDir ?? process.cwd());
+    const manifest = readAssetManifest(projectDir);
+    const outputDir = resolve(projectDir, manifest.outputDir);
+    const referenced = collectReferencedPaths(projectDir, manifest);
+    const rows = [];
+    let scanned = 0;
+    for (const file of walkFiles(outputDir)) {
+        scanned++;
+        const relativePath = relativeKey(projectDir, file);
+        if (referenced.has(relativePath))
+            continue;
+        const stat = statSync(file);
+        rows.push({ path: relativePath, bytes: stat.size, lfsPointer: isLfsPointer(file, stat.size) });
+    }
+    rows.sort((a, b) => a.path.localeCompare(b.path));
+    if (options.apply) {
+        for (const row of rows)
+            unlinkSync(resolve(projectDir, row.path));
+    }
+    const result = {
+        ok: true,
+        applied: options.apply === true,
+        removed: rows,
+        bytesFreed: rows.reduce((total, row) => total + row.bytes, 0),
+        referencedCount: referenced.size,
+        scannedCount: scanned,
+        outputDir: manifest.outputDir,
+    };
+    options.stdout?.(`${result.applied ? "Removed" : "Would remove"} ${rows.length} file(s) (${formatBytes(result.bytesFreed)}) ` +
+        `from ${manifest.outputDir}; ${scanned} scanned, ${referenced.size} manifest-referenced.` +
+        (result.applied ? "" : " Re-run with --apply to delete."));
+    const lfs = rows.filter((row) => row.lfsPointer);
+    if (lfs.length > 0) {
+        options.stdout?.(`${lfs.length} removed entr${lfs.length === 1 ? "y was" : "ies were"} LFS pointer files; git will stage the deletions.`);
+    }
+    return result;
+}
+/** Every project-relative path a manifest entry may still serve. */
+function collectReferencedPaths(projectDir, manifest) {
+    const referenced = new Set();
+    const push = (value) => {
+        if (!value)
+            return;
+        const normalized = value.startsWith("/")
+            ? join("public", value) // url → public/<url>
+            : value;
+        referenced.add(relativeKey(projectDir, resolve(projectDir, normalized)));
+    };
+    const pushEntry = (asset) => {
+        push(asset.outputPath);
+        push(asset.url); // covers served path when outputPath unset
+        push(asset.thumbnailUrl);
+        const derived = asset.derived;
+        if (!derived)
+            return;
+        push(derived.outputPath);
+        push(derived.url);
+        push(derived.mobileUrl);
+        push(derived.collisionUrl);
+    };
+    for (const asset of manifest.assets)
+        pushEntry(asset);
+    return referenced;
+}
+function* walkFiles(dir) {
+    if (!existsSync(dir))
+        return;
+    const stack = [dir];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        for (const entry of readdirSync(current, { withFileTypes: true })) {
+            const path = join(current, entry.name);
+            if (entry.isDirectory())
+                stack.push(path);
+            else if (entry.isFile())
+                yield path;
+        }
+    }
+}
+function relativeKey(projectDir, path) {
+    return path.slice(projectDir.length + (projectDir.endsWith(sep) ? 0 : 1)).split(sep).join("/");
+}
+function isLfsPointer(path, size) {
+    if (size > 1024)
+        return false;
+    try {
+        return readFileSync(path, "utf8").startsWith("version https://git-lfs.github.com/spec/v1");
+    }
+    catch {
+        return false;
+    }
+}
+function formatBytes(bytes) {
+    if (bytes >= 1_048_576)
+        return `${(bytes / 1_048_576).toFixed(1)} MB`;
+    if (bytes >= 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${bytes} B`;
+}
+//# sourceMappingURL=prune.js.map

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

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

package/dist/commands/prd05/review.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `aura3d assets review <id> --judge human|vision-model --judge-id <id>
+ * --score N --axes k=v,... --notes "..." [--verdict accept|reject]`
+ *
+ * Appends a C-32-shaped review to the entry's `lookDev.reviews` bound to the
+ * derived (or source) hash (PRD-05 §6.4 G9 record; §7.1).
+ */
+export interface ReviewOptions {
+    readonly projectDir: string;
+    readonly assetId: string;
+    readonly judge: "human" | "vision-model";
+    readonly judgeId: string;
+    readonly reviewer: string;
+    readonly score?: number;
+    readonly axes?: Readonly<Record<string, number>>;
+    readonly notes: string;
+    readonly verdict?: "accept" | "reject";
+}
+export declare function reviewAsset(options: ReviewOptions): {
+    readonly ok: boolean;
+    readonly wroteManifest: boolean;
+    readonly message: string;
+};
+//# sourceMappingURL=review.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../../../../../packages/aura3d-cli/src/commands/prd05/review.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CACxC;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA4BvI"}

package/dist/commands/prd05/review.js

@@ -0,0 +1,40 @@
+/**
+ * `aura3d assets review <id> --judge human|vision-model --judge-id <id>
+ * --score N --axes k=v,... --notes "..." [--verdict accept|reject]`
+ *
+ * Appends a C-32-shaped review to the entry's `lookDev.reviews` bound to the
+ * derived (or source) hash (PRD-05 §6.4 G9 record; §7.1).
+ */
+import { resolve } from "node:path";
+import { readAssetManifest, writeAssetManifest, writeTypedAssets } from "../../asset-manifest.js";
+export function reviewAsset(options) {
+    const projectDir = resolve(options.projectDir);
+    const manifest = readAssetManifest(projectDir);
+    const entry = manifest.assets.find((asset) => asset.id === options.assetId);
+    if (!entry)
+        return { ok: false, wroteManifest: false, message: `Asset "${options.assetId}" is not in the manifest.` };
+    const boundHash = entry.derived?.hash ?? entry.hash;
+    const verdict = options.verdict ?? ((options.score ?? 0) >= 6.5 ? "accept" : "reject");
+    const previous = entry.lookDev ?? { runUrl: "", reviews: [] };
+    const lookDev = {
+        ...previous,
+        derivedHash: boundHash,
+        reviews: [
+            ...previous.reviews,
+            {
+                reviewer: options.reviewer,
+                verdict,
+                notes: options.notes,
+                at: new Date().toISOString(),
+                judge: { kind: options.judge, id: options.judgeId },
+                ...(options.score !== undefined ? { score: options.score } : {}),
+                ...(options.axes !== undefined ? { axes: options.axes } : {}),
+            },
+        ],
+    };
+    const next = { ...manifest, assets: manifest.assets.map((asset) => (asset.id === entry.id ? { ...asset, lookDev } : asset)) };
+    writeAssetManifest(projectDir, next);
+    writeTypedAssets(projectDir, next);
+    return { ok: true, wroteManifest: true, message: `${entry.id}: recorded ${verdict} review by ${options.reviewer} bound to ${boundHash.slice(0, 15)}.` };
+}
+//# sourceMappingURL=review.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../../../../../packages/aura3d-cli/src/commands/prd05/review.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAelG,MAAM,UAAU,WAAW,CAAC,OAAsB;IAChD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5E,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,OAAO,CAAC,OAAO,2BAA2B,EAAE,CAAC;IACtH,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC;IACpD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACvF,MAAM,QAAQ,GAA+B,KAAK,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC1F,MAAM,OAAO,GAA+B;QAC1C,GAAG,QAAQ;QACX,WAAW,EAAE,SAAS;QACtB,OAAO,EAAE;YACP,GAAG,QAAQ,CAAC,OAAO;YACnB;gBACE,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,OAAO;gBACP,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAC5B,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,OAAO,CAAC,OAAO,EAAE;gBACnD,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9D;SACF;KACF,CAAC;IACF,MAAM,IAAI,GAAG,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;IAC9H,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACrC,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACnC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,EAAE,cAAc,OAAO,cAAc,OAAO,CAAC,QAAQ,aAAa,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC;AAC1J,CAAC"}

package/dist/commands/prd06/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * C-39 lane command registrations — prd06 registers its `aura3d` commands
+ * here via registerCliCommand (CONTRACTS.md).
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/aura3d-cli/src/commands/prd06/index.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/commands/prd06/index.js

@@ -0,0 +1,86 @@
+/**
+ * C-39 lane command registrations — prd06 registers its `aura3d` commands
+ * here via registerCliCommand (CONTRACTS.md).
+ */
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { registerCliCommand, registerCodemod } from "../../contracts/commands.js";
+import { inspectAnimationClips, readGlbDocument } from "./inspectAnimationClips.js";
+import { validateHeroGlb } from "./validateHero.js";
+import { parseAnimationClipMap } from "../../animation-asset-validator.js";
+/**
+ * T0.7 — `aura3d animation inspect-clips <model.glb>` prints the resolved
+ * `{ name, duration, channelCount, hasRootMotionCandidate, frameRate? }[]`
+ * an agent feeds to `model({ animationClips })` / `animation.resolveAnimationClips`.
+ */
+registerCliCommand({
+    name: "animation inspect-clips",
+    owner: "prd06",
+    summary: "Print resolved GLB animation clip infos (duration, channels, root-motion) as JSON.",
+    usage: "aura3d animation inspect-clips <model.glb>",
+    run: async (argv, io) => {
+        const file = argv.find((arg) => !arg.startsWith("--"));
+        if (!file) {
+            io.stderr("Usage: aura3d animation inspect-clips <model.glb>");
+            return 1;
+        }
+        const { json, bin } = readGlbDocument(new Uint8Array(readFileSync(file)));
+        io.stdout(JSON.stringify(inspectAnimationClips(json, bin), null, 2));
+        return 0;
+    }
+});
+/**
+ * T4.6 — `aura3d animation validate-hero <model.glb> [--profile
+ * hero-character|template-hero] [--map action=clip,...]` runs the §6.9 hero
+ * bar: geometry (triangles/skins/joints), texture, and the profile's required
+ * clip set with durations. Prints the report as JSON; exit 1 on any failure.
+ */
+registerCliCommand({
+    name: "animation validate-hero",
+    owner: "prd06",
+    summary: "Validate a character GLB against the hero-character / template-hero bar (§6.9).",
+    usage: "aura3d animation validate-hero <model.glb> [--profile hero-character|template-hero] [--map idle=Idle,run=Run]",
+    run: async (argv, io) => {
+        const file = argv.find((arg) => !arg.startsWith("--"));
+        if (!file) {
+            io.stderr("Usage: aura3d animation validate-hero <model.glb> [--profile hero-character|template-hero] [--map action=clip,...]");
+            return 1;
+        }
+        const profileArg = argv.find((arg) => arg.startsWith("--profile="))?.slice("--profile=".length)
+            ?? (argv.includes("--profile") ? argv[argv.indexOf("--profile") + 1] : undefined);
+        const profile = profileArg === "template-hero" ? "template-hero" : "hero-character";
+        const mapArg = argv.find((arg) => arg.startsWith("--map="))?.slice("--map=".length)
+            ?? (argv.includes("--map") ? argv[argv.indexOf("--map") + 1] : undefined);
+        const clipMap = mapArg !== undefined ? parseAnimationClipMap(mapArg) : undefined;
+        const report = validateHeroGlb(new Uint8Array(readFileSync(file)), {
+            profile,
+            ...(clipMap !== undefined ? { clipMap } : {})
+        });
+        io.stdout(JSON.stringify({ profile, ok: report.ok, reasonCodes: report.reasonCodes, failures: report.failures, messages: report.messages }, null, 2));
+        return report.ok ? 0 : 1;
+    }
+});
+const requireFromHere = createRequire(import.meta.url);
+let codemodImpl;
+function loadCodemodTransform() {
+    if (codemodImpl === undefined) {
+        try {
+            codemodImpl = requireFromHere("../../../../../tools/codemods/animation-3.1.mjs").transform;
+        }
+        catch (error) {
+            throw new Error("aura3d codemod animation-3.1: implementation module " +
+                `tools/codemods/animation-3.1.mjs is not reachable (${error.message}). ` +
+                "This codemod is only available from the monorepo source tree.");
+        }
+    }
+    return codemodImpl;
+}
+registerCodemod({
+    name: "animation-3.1",
+    owner: "prd06",
+    description: "3.0 → 3.1 animation API drift: non-exact clip names at .animate/.play/resolveGLTFClipName call sites " +
+        "(vs the app's aura-assets clip universe), every `speed:` property (now applied), and " +
+        "bindRuntimeNode({applyPose}) bindings.",
+    transform: (source, fileName) => loadCodemodTransform()(source, fileName)
+});
+//# sourceMappingURL=index.js.map

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

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

package/dist/commands/prd06/inspectAnimationClips.d.ts

@@ -0,0 +1,86 @@
+/**
+ * PRD-06 T0.7 — pure GLB animation-clip inspection for the
+ * `aura3d animation inspect-clips <glb>` C-39 command. Same extraction
+ * `GLTFSceneAnimationRuntime.resolvedClipInfos()` performs at load:
+ *
+ * - `duration` — the max over the clip's samplers of the input accessor's
+ *   `max[0]`; when `max` is absent the accessor data is read instead.
+ * - `channelCount` — the clip's glTF channel count.
+ * - `hasRootMotionCandidate` — a hips/root/pelvis translation track whose
+ *   first↔last XZ displacement exceeds 5 cm (mirrors
+ *   `clipHasRootMotionCandidate` in `GLTFAnimationRuntime.ts`).
+ * - `frameRate?` — the median input-time delta, inverted (omitted when the
+ *   accessor data is unavailable or degenerate).
+ *
+ * Q-05-1 asks lane 05 to call this from `inspectGltfAnimations` and emit C-17
+ * `animationClips` objects in `asset-manifest.ts`; until then this module is
+ * reached through the registered command and lane tests.
+ */
+export interface GltfAnimationDocument {
+    readonly accessors?: readonly {
+        readonly min?: readonly number[];
+        readonly max?: readonly number[];
+        readonly bufferView?: number;
+        readonly byteOffset?: number;
+        readonly componentType?: number;
+        readonly count?: number;
+        readonly type?: string;
+    }[];
+    readonly bufferViews?: readonly {
+        readonly buffer?: number;
+        readonly byteOffset?: number;
+        readonly byteLength?: number;
+        readonly byteStride?: number;
+    }[];
+    readonly animations?: readonly {
+        readonly name?: string;
+        readonly channels?: readonly {
+            readonly sampler?: number;
+            readonly target?: {
+                readonly node?: number;
+                readonly path?: string;
+            };
+        }[];
+        readonly samplers?: readonly {
+            readonly input?: number;
+            readonly output?: number;
+            readonly interpolation?: string;
+        }[];
+    }[];
+    readonly nodes?: readonly {
+        readonly name?: string;
+    }[];
+    /** T4.6 — hero validation needs geometry fields (meshes/skins/materials). */
+    readonly meshes?: readonly {
+        readonly primitives?: readonly {
+            readonly mode?: number;
+            readonly indices?: number;
+            readonly attributes?: {
+                readonly POSITION?: number;
+            };
+        }[];
+    }[];
+    readonly skins?: readonly {
+        readonly joints?: readonly number[];
+    }[];
+    readonly materials?: readonly {
+        readonly pbrMetallicRoughness?: {
+            readonly baseColorTexture?: unknown;
+        };
+    }[];
+}
+export interface AuraCliInspectedAnimationClip {
+    readonly index: number;
+    readonly name: string;
+    readonly duration: number;
+    readonly channelCount: number;
+    readonly hasRootMotionCandidate: boolean;
+    readonly frameRate?: number;
+}
+/** Decode a GLB buffer into its JSON document and BIN chunk. */
+export declare function readGlbDocument(buffer: Uint8Array): {
+    readonly json: GltfAnimationDocument;
+    readonly bin?: Uint8Array;
+};
+export declare function inspectAnimationClips(json: GltfAnimationDocument, bin?: Uint8Array): readonly AuraCliInspectedAnimationClip[];
+//# sourceMappingURL=inspectAnimationClips.d.ts.map

package/dist/commands/prd06/inspectAnimationClips.d.ts.map

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

package/dist/commands/prd06/inspectAnimationClips.js

@@ -0,0 +1,168 @@
+/**
+ * PRD-06 T0.7 — pure GLB animation-clip inspection for the
+ * `aura3d animation inspect-clips <glb>` C-39 command. Same extraction
+ * `GLTFSceneAnimationRuntime.resolvedClipInfos()` performs at load:
+ *
+ * - `duration` — the max over the clip's samplers of the input accessor's
+ *   `max[0]`; when `max` is absent the accessor data is read instead.
+ * - `channelCount` — the clip's glTF channel count.
+ * - `hasRootMotionCandidate` — a hips/root/pelvis translation track whose
+ *   first↔last XZ displacement exceeds 5 cm (mirrors
+ *   `clipHasRootMotionCandidate` in `GLTFAnimationRuntime.ts`).
+ * - `frameRate?` — the median input-time delta, inverted (omitted when the
+ *   accessor data is unavailable or degenerate).
+ *
+ * Q-05-1 asks lane 05 to call this from `inspectGltfAnimations` and emit C-17
+ * `animationClips` objects in `asset-manifest.ts`; until then this module is
+ * reached through the registered command and lane tests.
+ */
+const GLB_MAGIC = 0x46546c67;
+const CHUNK_JSON = 0x4e4f534a;
+const CHUNK_BIN = 0x004e4942;
+const COMPONENT_FLOAT32 = 5126;
+/** Decode a GLB buffer into its JSON document and BIN chunk. */
+export function readGlbDocument(buffer) {
+    const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+    if (buffer.byteLength < 20 || view.getUint32(0, true) !== GLB_MAGIC) {
+        throw new Error("Invalid GLB header. Suggested fix: re-export the asset as binary glTF (.glb).");
+    }
+    const total = view.getUint32(8, true);
+    if (total > buffer.byteLength) {
+        throw new Error("Invalid GLB length. Suggested fix: run assets validate on the original export.");
+    }
+    const jsonLength = view.getUint32(12, true);
+    if (view.getUint32(16, true) !== CHUNK_JSON) {
+        throw new Error("Invalid GLB JSON chunk. Suggested fix: re-export the GLB.");
+    }
+    const json = JSON.parse(new TextDecoder().decode(buffer.subarray(20, 20 + jsonLength)));
+    let bin;
+    const binHeader = 20 + jsonLength;
+    if (binHeader + 8 <= buffer.byteLength && view.getUint32(binHeader + 4, true) === CHUNK_BIN) {
+        const binLength = view.getUint32(binHeader, true);
+        bin = buffer.subarray(binHeader + 8, binHeader + 8 + Math.min(binLength, buffer.byteLength - binHeader - 8));
+    }
+    return { json, bin };
+}
+export function inspectAnimationClips(json, bin) {
+    const accessors = json.accessors ?? [];
+    const nodes = json.nodes ?? [];
+    return (json.animations ?? []).map((animation, index) => {
+        const channels = animation.channels ?? [];
+        const samplers = animation.samplers ?? [];
+        let duration = 0;
+        for (const channel of channels) {
+            const input = samplers[channel.sampler ?? -1]?.input;
+            if (input === undefined)
+                continue;
+            const accessorMax = accessors[input]?.max?.[0];
+            if (typeof accessorMax === "number" && Number.isFinite(accessorMax)) {
+                duration = Math.max(duration, accessorMax);
+                continue;
+            }
+            // `max` absent (legal per spec): read the last input time from accessor data.
+            const count = accessors[input]?.count ?? 0;
+            const last = count > 0 ? readScalar(json, bin, input, count - 1) : undefined;
+            if (last !== undefined)
+                duration = Math.max(duration, last);
+        }
+        const hasRootMotionCandidate = channels.some((channel) => isRootMotionCandidate(json, bin, nodes, samplers, channel));
+        const frameRate = medianFrameRate(json, bin, samplers);
+        return {
+            index,
+            name: animation.name ?? `clip-${index}`,
+            duration,
+            channelCount: channels.length,
+            hasRootMotionCandidate,
+            ...(frameRate !== undefined ? { frameRate } : {})
+        };
+    });
+}
+function isRootMotionCandidate(json, bin, nodes, samplers, channel) {
+    if (channel.target?.path !== "translation")
+        return false;
+    const nodeName = nodes[channel.target.node ?? -1]?.name ?? "";
+    if (!/hips|root|pelvis/i.test(nodeName))
+        return false;
+    const output = samplers[channel.sampler ?? -1]?.output;
+    const count = output === undefined ? 0 : json.accessors?.[output]?.count ?? 0;
+    if (count < 2)
+        return false;
+    const first = readVec3(json, bin, output, 0);
+    const last = readVec3(json, bin, output, count - 1);
+    if (!first || !last)
+        return false;
+    return Math.hypot(last[0] - first[0], last[2] - first[2]) > 0.05;
+}
+function medianFrameRate(json, bin, samplers) {
+    const deltas = [];
+    for (const sampler of samplers) {
+        const times = readFloatAccessor(json, bin, sampler?.input);
+        if (!times || times.length < 2)
+            continue;
+        for (let i = 1; i < times.length; i += 1) {
+            const delta = times[i] - times[i - 1];
+            if (delta > 0)
+                deltas.push(delta);
+        }
+    }
+    if (deltas.length === 0)
+        return undefined;
+    deltas.sort((a, b) => a - b);
+    const median = deltas[Math.floor(deltas.length / 2)];
+    if (median <= 0)
+        return undefined;
+    return 1 / median;
+}
+function readVec3(json, bin, accessorIndex, elementIndex) {
+    if (accessorIndex === undefined)
+        return undefined;
+    const accessor = json.accessors?.[accessorIndex];
+    if (!accessor || accessor.componentType !== COMPONENT_FLOAT32 || accessor.type !== "VEC3")
+        return undefined;
+    const values = readFloatAccessor(json, bin, accessorIndex, 3);
+    if (!values)
+        return undefined;
+    const base = elementIndex * 3;
+    if (base + 2 >= values.length)
+        return undefined;
+    return [values[base], values[base + 1], values[base + 2]];
+}
+function readScalar(json, bin, accessorIndex, elementIndex) {
+    const values = readFloatAccessor(json, bin, accessorIndex, 1);
+    return values && elementIndex < values.length ? values[elementIndex] : undefined;
+}
+const floatAccessorCache = new WeakMap();
+function readFloatAccessor(json, bin, accessorIndex, componentsPerElement = 1) {
+    if (accessorIndex === undefined || !bin)
+        return undefined;
+    const accessor = json.accessors?.[accessorIndex];
+    if (!accessor || accessor.componentType !== COMPONENT_FLOAT32)
+        return undefined;
+    const view = accessor.bufferView === undefined ? undefined : json.bufferViews?.[accessor.bufferView];
+    if (!view)
+        return undefined;
+    const cacheKey = accessorIndex * 16 + componentsPerElement;
+    let perBin = floatAccessorCache.get(bin);
+    if (perBin?.has(cacheKey))
+        return perBin.get(cacheKey);
+    const count = accessor.count ?? 0;
+    const strideBytes = view.byteStride && view.byteStride >= componentsPerElement * 4 ? view.byteStride : componentsPerElement * 4;
+    const base = (view.byteOffset ?? 0) + (accessor.byteOffset ?? 0);
+    const end = base + (count > 0 ? (count - 1) * strideBytes + componentsPerElement * 4 : 0);
+    if (end > bin.byteLength)
+        return undefined;
+    const out = new Float32Array(count * componentsPerElement);
+    for (let i = 0; i < count; i += 1) {
+        const elementBase = base + i * strideBytes;
+        for (let c = 0; c < componentsPerElement; c += 1) {
+            out[i * componentsPerElement + c] = new DataView(bin.buffer, bin.byteOffset + elementBase + c * 4, 4).getFloat32(0, true);
+        }
+    }
+    if (!perBin) {
+        perBin = new Map();
+        floatAccessorCache.set(bin, perBin);
+    }
+    perBin.set(cacheKey, out);
+    return out;
+}
+//# sourceMappingURL=inspectAnimationClips.js.map