@aura3d/cli 3.0.1 → 4.0.0

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * T4.6 (PRD-06 §6.9, C-39) — `aura3d animation validate-hero <glb>
+ * [--profile hero-character|template-hero]`: a lane-owned GLB reader that fills
+ * `AnimationAssetInspection` (triangles, skins, joints, clips, baseColor) plus
+ * a deterministic clip-map derivation for the profile's required actions.
+ * Reuses {@link inspectAnimationClips} (T0.7) — nothing from CLI index.ts.
+ */
+import { type AnimationAssetHeroProfile, type AnimationAssetInspection, type AnimationAssetValidationReport } from "../../animation-asset-validator.js";
+import { type GltfAnimationDocument } from "./inspectAnimationClips.js";
+/** Geometry/texture facts a hero profile needs, straight from the GLB JSON. */
+export declare function inspectHeroGeometry(json: GltfAnimationDocument): Pick<AnimationAssetInspection, "triangleCount" | "skinCount" | "jointCount" | "hasBaseColorTexture">;
+export declare function deriveHeroClipMap(clipNames: readonly string[], requiredActions: readonly string[]): Record<string, string>;
+/** Full GLB → validation report for `aura3d animation validate-hero`. */
+export declare function validateHeroGlb(buffer: Uint8Array, options?: {
+    readonly profile?: AnimationAssetHeroProfile;
+    readonly clipMap?: Readonly<Record<string, string>>;
+}): AnimationAssetValidationReport;
+//# sourceMappingURL=validateHero.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validateHero.d.ts","sourceRoot":"","sources":["../../../../../../packages/aura3d-cli/src/commands/prd06/validateHero.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAGL,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,8BAA8B,EACpC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAA0C,KAAK,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAIhH,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAAC,wBAAwB,EAAE,eAAe,GAAG,WAAW,GAAG,YAAY,GAAG,qBAAqB,CAAC,CAqBrK;AAgCD,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,eAAe,EAAE,SAAS,MAAM,EAAE,GACjC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxB;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,yBAAyB,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAO,GAClH,8BAA8B,CAiBhC"}

package/dist/commands/prd06/validateHero.js

@@ -0,0 +1,91 @@
+/**
+ * T4.6 (PRD-06 §6.9, C-39) — `aura3d animation validate-hero <glb>
+ * [--profile hero-character|template-hero]`: a lane-owned GLB reader that fills
+ * `AnimationAssetInspection` (triangles, skins, joints, clips, baseColor) plus
+ * a deterministic clip-map derivation for the profile's required actions.
+ * Reuses {@link inspectAnimationClips} (T0.7) — nothing from CLI index.ts.
+ */
+import { validateAnimationAssets, ANIMATION_ASSET_HERO_PROFILES } from "../../animation-asset-validator.js";
+import { inspectAnimationClips, readGlbDocument } from "./inspectAnimationClips.js";
+const MODE_TRIANGLES = 4;
+/** Geometry/texture facts a hero profile needs, straight from the GLB JSON. */
+export function inspectHeroGeometry(json) {
+    const accessors = json.accessors ?? [];
+    let triangles = 0;
+    for (const mesh of json.meshes ?? []) {
+        for (const primitive of mesh.primitives ?? []) {
+            if ((primitive.mode ?? MODE_TRIANGLES) !== MODE_TRIANGLES)
+                continue;
+            const indexAccessor = primitive.indices === undefined ? undefined : accessors[primitive.indices];
+            const positionAccessor = primitive.attributes?.POSITION === undefined ? undefined : accessors[primitive.attributes.POSITION];
+            const count = indexAccessor?.count ?? positionAccessor?.count ?? 0;
+            triangles += Math.floor(count / 3);
+        }
+    }
+    const skins = json.skins ?? [];
+    return {
+        triangleCount: triangles,
+        skinCount: skins.length,
+        jointCount: skins.reduce((max, skin) => Math.max(max, skin.joints?.length ?? 0), 0),
+        hasBaseColorTexture: (json.materials ?? []).some((material) => material?.pbrMetallicRoughness?.baseColorTexture !== undefined)
+    };
+}
+/**
+ * Deterministic action→clip derivation for `validate-hero` when no `--map`
+ * override is given: normalise names (lowercase, non-alphanumeric runs → "-"),
+ * then match an action to the first clip whose normalised name contains the
+ * action (via its alias list — e.g. "jump-start" matches "JumpStart" and
+ * "Jump_Start"). Unmatched actions stay unmapped → HERO_MISSING_CLIP.
+ */
+const ACTION_ALIASES = {
+    "jump-start": ["jump-start", "jumpstart", "jump-up", "jumpbegin", "jump-begin"],
+    "jump-loop": ["jump-loop", "jumploop", "airborne", "fall-loop", "fallloop", "jump-air", "in-air"],
+    land: ["land", "landing"],
+    "turn-l": ["turn-l", "turnl", "turn-left", "turnleft", "turn-90l", "turnl90", "turn-left-90"],
+    "turn-r": ["turn-r", "turnr", "turn-right", "turnright", "turn-90r", "turnr90", "turn-right-90"],
+    "hit-react": ["hit-react", "hitreact", "hit", "flinch", "impact"],
+    interact: ["interact", "use", "pickup", "pick-up"],
+    attack: ["attack", "punch", "kick", "slash", "swing"],
+    idle: ["idle", "tpose", "t-pose", "stance"],
+    walk: ["walk", "walkcycle", "walk-cycle"],
+    run: ["run", "runcycle", "run-cycle", "jog"],
+    sprint: ["sprint", "dash"]
+};
+function normalizeClipName(name) {
+    return name
+        .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+export function deriveHeroClipMap(clipNames, requiredActions) {
+    const normalized = clipNames.map((name) => ({ raw: name, norm: normalizeClipName(name) }));
+    const map = {};
+    for (const action of requiredActions) {
+        const aliases = (ACTION_ALIASES[action] ?? [action]).map(normalizeClipName);
+        const hit = normalized.find((clip) => aliases.some((alias) => clip.norm.includes(alias)));
+        if (hit)
+            map[action] = hit.raw;
+    }
+    return map;
+}
+/** Full GLB → validation report for `aura3d animation validate-hero`. */
+export function validateHeroGlb(buffer, options = {}) {
+    const { json, bin } = readGlbDocument(buffer);
+    const profile = options.profile ?? "hero-character";
+    const definition = ANIMATION_ASSET_HERO_PROFILES[profile];
+    const clips = inspectAnimationClips(json, bin).map((clip) => ({ name: clip.name, duration: clip.duration }));
+    const inspection = {
+        ...inspectHeroGeometry(json),
+        clips
+    };
+    const clipMap = options.clipMap ?? deriveHeroClipMap(clips.map((c) => c.name), definition.requiredActions);
+    return validateAnimationAssets({
+        availableClips: clips.map((c) => c.name),
+        clipMap,
+        requiredActions: definition.requiredActions,
+        profile,
+        inspection
+    });
+}
+//# sourceMappingURL=validateHero.js.map

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

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

package/dist/commands/prd07/codemods.d.ts

@@ -0,0 +1,28 @@
+import type { AuraCodemod } from "../../contracts/commands.js";
+type CodemodRow = {
+    readonly file: string;
+    readonly line: number;
+    readonly construct: string;
+    readonly mapping: "exact" | "approximate" | "none";
+    readonly target?: string;
+    readonly note?: string;
+};
+/** End index of the balanced (...) region starting at `open` (index of "("). */
+export declare function matchParens(source: string, open: number): number;
+interface ChainMatch {
+    readonly start: number;
+    readonly end: number;
+    readonly primitive: "box" | "sphere";
+}
+/**
+ * Match `primitives.box|sphere(<args>) [.<method>(<args>)]* .runtime(<args>)`
+ * with balanced-paren skipping (nested calls inside args are legal).
+ */
+export declare function findPooledPrimitiveChains(source: string): readonly ChainMatch[];
+export declare function vfxPoolsToEffectsTransform(source: string, fileName: string): {
+    readonly code: string;
+    readonly rows: readonly CodemodRow[];
+};
+export declare function vfxPoolsToEffectsCodemod(): AuraCodemod;
+export {};
+//# sourceMappingURL=codemods.d.ts.map

package/dist/commands/prd07/codemods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codemods.d.ts","sourceRoot":"","sources":["../../../../../../packages/aura3d-cli/src/commands/prd07/codemods.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,KAAK,UAAU,GAAG;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,GAAG,MAAM,CAAC;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAWhE;AAED,UAAU,UAAU;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,QAAQ,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,UAAU,EAAE,CAqC/E;AAID,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,CAAC;CACtC,CA8EA;AAED,wBAAgB,wBAAwB,IAAI,WAAW,CAStD"}

package/dist/commands/prd07/codemods.js

@@ -0,0 +1,155 @@
+// PRD-07 P6-T5 — `vfx-pools-to-effects` codemod (C-39). Two jobs:
+//   1. Report E25 route-local spark/burst pools — pooled primitives created
+//      once, hidden, then re-driven per frame via handle.setScale(life).
+//   2. Rewrite the simple patterns to the prd07 effects surface:
+//      `effects.spawnLoop(x)` → `effects.spawn(x)` and pooled
+//      `primitives.box/sphere(...)…​.runtime(...)` builders →
+//      `app.effects.burst(...)` (marked approximate: pool bookkeeping moves to
+//      the burst handle, which a human still has to wire in).
+/** End index of the balanced (...) region starting at `open` (index of "("). */
+export function matchParens(source, open) {
+    let depth = 0;
+    for (let i = open; i < source.length; i += 1) {
+        const c = source[i];
+        if (c === "(")
+            depth += 1;
+        else if (c === ")") {
+            depth -= 1;
+            if (depth === 0)
+                return i;
+        }
+    }
+    return -1;
+}
+/**
+ * Match `primitives.box|sphere(<args>) [.<method>(<args>)]* .runtime(<args>)`
+ * with balanced-paren skipping (nested calls inside args are legal).
+ */
+export function findPooledPrimitiveChains(source) {
+    const out = [];
+    const re = /primitives\.(box|sphere)\s*\(/g;
+    let m;
+    while ((m = re.exec(source))) {
+        const primitive = m[1];
+        const open = m.index + m[0].length - 1;
+        const close = matchParens(source, open);
+        if (close < 0)
+            continue;
+        let cursor = close + 1;
+        let runtimeEnd = -1;
+        // Walk `.method(...)` chains; stop at the first `.runtime(` (its end), or
+        // at anything that is not a chain link.
+        for (;;) {
+            const skip = source.slice(cursor);
+            const ws = skip.match(/^\s*/);
+            cursor += ws?.[0].length ?? 0;
+            const link = source.slice(cursor).match(/^\.(\w+)\s*\(/);
+            if (!link)
+                break;
+            const method = link[1];
+            const argOpen = cursor + link[0].length - 1;
+            const argClose = matchParens(source, argOpen);
+            if (argClose < 0)
+                break;
+            cursor = argClose + 1;
+            if (method === "runtime") {
+                runtimeEnd = cursor;
+                break;
+            }
+        }
+        if (runtimeEnd > 0) {
+            out.push({ start: m.index, end: runtimeEnd, primitive });
+            re.lastIndex = runtimeEnd;
+        }
+        else {
+            re.lastIndex = close + 1;
+        }
+    }
+    return out;
+}
+const lineOf = (source, index) => source.slice(0, index).split("\n").length;
+export function vfxPoolsToEffectsTransform(source, fileName) {
+    const rows = [];
+    let code = source;
+    // --- E25 report sites -----------------------------------------------------
+    const poolRe = /Array\.from\s*\(\s*\{\s*length/g;
+    let pm;
+    while ((pm = poolRe.exec(source))) {
+        // Only report when the Array.from body plausibly builds pooled primitives.
+        const window = source.slice(pm.index, pm.index + 2000);
+        if (/primitives\.(box|sphere)/.test(window) && /\.runtime\s*\(/.test(window)) {
+            rows.push({
+                file: fileName,
+                line: lineOf(source, pm.index),
+                construct: "E25 pooled-primitive array",
+                mapping: "approximate",
+                target: "app.effects.burst / effects.spawn",
+                note: "E25: route-local spark/burst pool; migrate to the prd07 effects API"
+            });
+        }
+    }
+    const scaleRe = /\b\w+\.setScale\s*\(/g;
+    let sm;
+    while ((sm = scaleRe.exec(source))) {
+        // Only flag scale calls driven by a life/age term (the E25 signature).
+        const window = source.slice(Math.max(0, sm.index - 400), sm.index + 200);
+        if (/\b(life|age|SHARD_LIFETIME|LIFETIME)\b/.test(window)) {
+            rows.push({
+                file: fileName,
+                line: lineOf(source, sm.index),
+                construct: "E25 life-driven setScale",
+                mapping: "none",
+                note: "E25: per-frame scale drive on a pooled primitive; burst handles this internally"
+            });
+        }
+    }
+    // --- Rewrites -------------------------------------------------------------
+    // effects.spawnLoop(x) → effects.spawn(x) — loop lifetime moves to the handle.
+    const spawnLoopRe = /effects\.spawnLoop\s*\(\s*([^,)]*)/g;
+    let lm;
+    while ((lm = spawnLoopRe.exec(code))) {
+        rows.push({
+            file: fileName,
+            line: lineOf(code, lm.index),
+            construct: lm[0],
+            mapping: "approximate",
+            target: `effects.spawn(${lm[1].trim()}`,
+            note: "loop lifetime: move to spawned-instance handle.stop()"
+        });
+    }
+    code = code.replace(/effects\.spawnLoop\s*\(/g, "effects.spawn(");
+    // Pooled primitives.box/sphere chains ending in .runtime(...) → burst stubs.
+    // Approximate: the burst replaces the pool per-burst, not the pooled node.
+    const chains = findPooledPrimitiveChains(code);
+    if (chains.length > 0) {
+        let rewritten = "";
+        let cursor = 0;
+        for (const chain of chains) {
+            rewritten += code.slice(cursor, chain.start);
+            rewritten += 'app.effects.burst("explosion-small", [0, 0, 0], { count: 8 })';
+            rows.push({
+                file: fileName,
+                line: lineOf(code, chain.start),
+                construct: `primitives.${chain.primitive}(…).runtime(…)`,
+                mapping: "approximate",
+                target: 'app.effects.burst("explosion-small", …)',
+                note: "E25 rewrite: pooled primitive → effects.burst; pool bookkeeping moves to the burst handle"
+            });
+            cursor = chain.end;
+        }
+        rewritten += code.slice(cursor);
+        code = rewritten;
+    }
+    rows.sort((a, b) => a.line - b.line);
+    return { code, rows };
+}
+export function vfxPoolsToEffectsCodemod() {
+    return {
+        name: "vfx-pools-to-effects",
+        owner: "prd07",
+        description: "Report E25 route-local spark/burst pools and rewrite the simple patterns: " +
+            "effects.spawnLoop → effects.spawn; pooled primitives.box/sphere + .runtime → app.effects.burst",
+        transform: vfxPoolsToEffectsTransform
+    };
+}
+//# sourceMappingURL=codemods.js.map

package/dist/commands/prd07/codemods.js.map

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

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

@@ -0,0 +1,2 @@
+export declare function registerPrd07Cli(): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/aura3d-cli/src/commands/prd07/index.ts"],"names":[],"mappings":"AAMA,wBAAgB,gBAAgB,IAAI,IAAI,CA8HvC"}

package/dist/commands/prd07/index.js

@@ -0,0 +1,151 @@
+// PRD-07 P1-T19 — lane CLI commands and codemods (C-39).
+// P6-T5: the codemod itself lives in ./codemods.ts (E25 report + rewrites).
+import { registerCliCommand, registerCodemod } from "../../contracts/commands.js";
+import { vfxPoolsToEffectsCodemod } from "./codemods.js";
+export function registerPrd07Cli() {
+    try {
+        registerCliCommand({
+            name: "vfx validate-atlas",
+            owner: "prd07",
+            summary: "Check a flipbook atlas JSON against the frame-grid contract",
+            usage: "aura3d vfx validate-atlas <atlas.json>",
+            async run(argv, io) {
+                const file = argv[0];
+                if (!file) {
+                    io.stderr("usage: aura3d vfx validate-atlas <atlas.json|manifest.json>");
+                    return 2;
+                }
+                try {
+                    const { readFile } = await import("node:fs/promises");
+                    const path = await import("node:path");
+                    const zlib = await import("node:zlib");
+                    const raw = await readFile(`${io.cwd}/${file}`, "utf8");
+                    const atlas = JSON.parse(raw);
+                    const errors = [];
+                    // Flat per-sequence JSON (legacy path): grid checks only.
+                    if (!atlas.pages) {
+                        if (!Number.isInteger(atlas.columns) || (atlas.columns ?? 0) < 1)
+                            errors.push("columns must be an integer >= 1");
+                        if (!Number.isInteger(atlas.rows) || (atlas.rows ?? 0) < 1)
+                            errors.push("rows must be an integer >= 1");
+                        if (atlas.frames !== undefined && atlas.frames > (atlas.columns ?? 0) * (atlas.rows ?? 0))
+                            errors.push("frames exceeds columns*rows");
+                    }
+                    else {
+                        // AuraVfxAtlasManifest v1: pages premultiplied + POT, rects inside
+                        // page, ≥1px cell gutter, integral frames.
+                        const dir = path.dirname(path.resolve(io.cwd, file));
+                        const pageById = new Map((atlas.pages ?? []).map((p) => [p.id, p]));
+                        const decodePng = (buf) => {
+                            const width = buf.readUInt32BE(16);
+                            const height = buf.readUInt32BE(20);
+                            let offset = 8;
+                            const idat = [];
+                            while (offset < buf.length) {
+                                const len = buf.readUInt32BE(offset);
+                                if (buf.toString("ascii", offset + 4, offset + 8) === "IDAT")
+                                    idat.push(buf.subarray(offset + 8, offset + 8 + len));
+                                offset += 12 + len;
+                            }
+                            const rawScan = zlib.inflateSync(Buffer.concat(idat));
+                            const stride = width * 4;
+                            const rgba = Buffer.alloc(stride * height);
+                            for (let y = 0; y < height; y++) {
+                                if (rawScan[y * (stride + 1)] !== 0)
+                                    throw new Error("unsupported PNG filter (bake writes filter-0 rows)");
+                                rawScan.copy(rgba, y * stride, y * (stride + 1) + 1, (y + 1) * (stride + 1));
+                            }
+                            return { width, height, rgba };
+                        };
+                        for (const page of atlas.pages ?? []) {
+                            const uriPng = page.uri.replace(/\.ktx2$/, ".png");
+                            if (!page.uri.endsWith(".ktx2") && !page.uri.endsWith(".png"))
+                                errors.push(`${page.id}: uri must be .png or .ktx2`);
+                            const pngPath = path.join(dir, page.uri.endsWith(".ktx2") ? uriPng : page.uri);
+                            let decoded;
+                            try {
+                                decoded = decodePng(await readFile(pngPath));
+                            }
+                            catch (error) {
+                                errors.push(`${page.id}: cannot decode ${pngPath} (${error.message})`);
+                                continue;
+                            }
+                            const pot = (n) => n > 0 && (n & (n - 1)) === 0;
+                            if (!pot(decoded.width) || !pot(decoded.height))
+                                errors.push(`${page.id}: ${decoded.width}×${decoded.height} not power-of-two`);
+                            if (decoded.width !== page.size || decoded.height !== page.size)
+                                errors.push(`${page.id}: pixel size ${decoded.width}×${decoded.height} ≠ manifest size ${page.size}`);
+                            let over = 0;
+                            for (let i = 0; i < decoded.rgba.length; i += 4) {
+                                const a = decoded.rgba[i + 3];
+                                over = Math.max(over, decoded.rgba[i] - a, decoded.rgba[i + 1] - a, decoded.rgba[i + 2] - a);
+                            }
+                            if (over > 0)
+                                errors.push(`${page.id}: not premultiplied (rgb exceeds alpha by ${over})`);
+                        }
+                        const rects = [];
+                        for (const [name, seq] of Object.entries(atlas.sequences ?? {})) {
+                            const page = pageById.get(seq.page);
+                            if (!page) {
+                                errors.push(`${name}: unknown page ${seq.page}`);
+                                continue;
+                            }
+                            const [x, y, w, h] = seq.rect;
+                            if (x < 0 || y < 0 || w <= 0 || h <= 0 || x + w > page.size || y + h > page.size)
+                                errors.push(`${name}: rect outside page ${seq.page}`);
+                            if (!Number.isInteger(w / seq.columns) || !Number.isInteger(h / seq.rows))
+                                errors.push(`${name}: non-integral cell size`);
+                            if (seq.frames > seq.columns * seq.rows)
+                                errors.push(`${name}: frames exceeds grid`);
+                            rects.push({ name, x0: x, y0: y, x1: x + w, y1: y + h });
+                        }
+                        for (let i = 0; i < rects.length; i++) {
+                            for (let j = i + 1; j < rects.length; j++) {
+                                const a = rects[i], b = rects[j];
+                                const overlapX = a.x0 < b.x1 && b.x0 < a.x1;
+                                const overlapY = a.y0 < b.y1 && b.y0 < a.y1;
+                                if (overlapX && overlapY) {
+                                    errors.push(`${a.name}/${b.name}: rects overlap`);
+                                    continue;
+                                }
+                                const gap = overlapX
+                                    ? Math.max(b.y0 - a.y1, a.y0 - b.y1)
+                                    : overlapY
+                                        ? Math.max(b.x0 - a.x1, a.x0 - b.x1)
+                                        : Math.min(Math.max(b.x0 - a.x1, a.x0 - b.x1), Math.max(b.y0 - a.y1, a.y0 - b.y1));
+                                if (gap < 1)
+                                    errors.push(`${a.name}/${b.name}: gutter ${gap}px < 1px`);
+                            }
+                        }
+                    }
+                    if (errors.length) {
+                        for (const e of errors)
+                            io.stderr(`invalid atlas: ${e}`);
+                        return 1;
+                    }
+                    if (!atlas.pages)
+                        io.stdout(`atlas ok: ${atlas.columns}x${atlas.rows} (${atlas.frames ?? atlas.columns * atlas.rows} frames)`);
+                    else
+                        io.stdout(`manifest ok: ${atlas.pages.length} page(s), ${Object.keys(atlas.sequences ?? {}).length} sequences`);
+                    return 0;
+                }
+                catch (error) {
+                    io.stderr(`atlas read failed: ${error.message}`);
+                    return 1;
+                }
+            }
+        });
+    }
+    catch (error) {
+        if (!(error instanceof Error && error.message.startsWith("CLI_COMMAND_DUPLICATE")))
+            throw error;
+    }
+    try {
+        registerCodemod(vfxPoolsToEffectsCodemod());
+    }
+    catch (error) {
+        if (!(error instanceof Error && error.message.startsWith("CODEMOD_DUPLICATE")))
+            throw error;
+    }
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/commands/prd08/feelLint.d.ts

@@ -0,0 +1,13 @@
+export declare const feelLintRule: {
+    readonly code: string;
+    readonly owner: string;
+    check(file: {
+        readonly path: string;
+        readonly text: string;
+    }): readonly {
+        readonly line: number;
+        readonly severity: "error" | "warning";
+        readonly message: string;
+    }[];
+};
+//# sourceMappingURL=feelLint.d.ts.map

package/dist/commands/prd08/feelLint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feelLint.d.ts","sourceRoot":"","sources":["../../../../../../packages/aura3d-cli/src/commands/prd08/feelLint.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,YAAY,EAAE;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAuB9J,CAAC"}

package/dist/commands/prd08/feelLint.js

@@ -0,0 +1,32 @@
+/**
+ * F-7a C-39 doctor rule `feel/evidence-only` — wraps the lane-08 source scan
+ * (`agent-api/feel/lint/feelSourceScan.ts`) plus the capture-gate and
+ * Math.random heuristics from the original rule. Registered from
+ * `commands/prd08/index.ts`; hosted by `aura3d doctor --look` (PRD 13).
+ */
+import { scanFeelSource } from "../../../../engine/dist/agent-api/feel/lint/feelSourceScan.js";
+export const feelLintRule = {
+    code: "feel/evidence-only",
+    owner: "prd08",
+    check(file) {
+        const rows = [...scanFeelSource(file.text)];
+        const src = file.text;
+        const gated = /(capture|evidence|VISUAL_CAPTURE|screenshot|diagnostic)/i;
+        let m;
+        const lineOf = (i) => src.slice(0, i).split("\n").length;
+        const gateRe = /if\s*\(([^)]{0,160})\)\s*\{[^}]{0,900}?\b(shake|punch|fovKick|trauma|hitStop)\b/g;
+        while ((m = gateRe.exec(src))) {
+            if (!gated.test(m[1]))
+                continue;
+            rows.push({ line: lineOf(m.index), severity: "warning", message: "feel call gated behind a capture/evidence branch — feel must reach pixels every frame, not only during captures (PRD-08 §9.5)" });
+        }
+        if (/\b(shake|trauma|punch|juice)\b/.test(src)) {
+            const rndRe = /Math\.random\(\)/g;
+            while ((m = rndRe.exec(src))) {
+                rows.push({ line: lineOf(m.index), severity: "error", message: "Math.random() in a file applying camera feel — use seeded feel/Noise (determinism, repo rule)" });
+            }
+        }
+        return rows;
+    }
+};
+//# sourceMappingURL=feelLint.js.map

package/dist/commands/prd08/feelLint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feelLint.js","sourceRoot":"","sources":["../../../../../../packages/aura3d-cli/src/commands/prd08/feelLint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAE9F,MAAM,CAAC,MAAM,YAAY,GAIrB;IACF,IAAI,EAAE,oBAAoB;IAC1B,KAAK,EAAE,OAAO;IACd,KAAK,CAAC,IAAsD;QAC1D,MAAM,IAAI,GAAG,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,MAAM,KAAK,GAAG,0DAA0D,CAAC;QACzE,IAAI,CAAyB,CAAC;QAC9B,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QACjE,MAAM,MAAM,GAAG,kFAAkF,CAAC;QAClG,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC;gBAAE,SAAS;YACjC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,+HAA+H,EAAE,CAAC,CAAC;QACtM,CAAC;QACD,IAAI,gCAAgC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,MAAM,KAAK,GAAG,mBAAmB,CAAC;YAClC,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC7B,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,+FAA+F,EAAE,CAAC,CAAC;YACpK,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACO,CAAC"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/aura3d-cli/src/commands/prd08/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,CAAC"}

package/dist/commands/prd08/index.js

@@ -0,0 +1,16 @@
+/**
+ * C-39 lane command registrations — prd08.
+ *
+ * Registers the `camera-cast` codemod and the `feel/evidence-only` doctor rule
+ * (CONTRACTS.md C-39; implementations live in tools/camera-cast-codemod/).
+ * and `prd08 motion-report` (S9: renders the motion-scene capture report).
+ */
+import { registerCliCommand, registerCodemod, registerDoctorRule } from "../../contracts/commands.js";
+import { cameraCastCodemod } from "../../../../../tools/camera-cast-codemod/index.js";
+import { feelLintRule } from "./feelLint.js";
+import { motionReportCommand } from "./motionReport.js";
+registerCodemod(cameraCastCodemod);
+registerDoctorRule(feelLintRule);
+registerCliCommand(motionReportCommand);
+export {};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/aura3d-cli/src/commands/prd08/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtG,OAAO,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,eAAe,CAAC,iBAAiB,CAAC,CAAC;AACnC,kBAAkB,CAAC,YAAY,CAAC,CAAC;AACjC,kBAAkB,CAAC,mBAAmB,CAAC,CAAC;AAExC,OAAO,EAAE,CAAC"}