@aura3d/cli 1.4.5 → 1.5.0

package/dist/asset-screening-effects.js

@@ -0,0 +1,321 @@
+/**
+ * Real bindings for the screening pipeline's injected effects.
+ *
+ * ## Why this file exists separately from the pipeline
+ *
+ * `asset-screening-pipeline.ts` owns *ordering and record-keeping* and takes every external effect as an
+ * injected function. That separation is what makes the part that historically failed -- running the steps
+ * in order and keeping every rejection reason -- testable offline. But an orchestrator with no real
+ * bindings is a library nobody can run: the previous state of this work had 38 passing tests against
+ * injected fakes and no way to actually screen a candidate.
+ *
+ * This module supplies the production wiring: catalog search, download, and structural geometry
+ * inspection read from the pulled file. It deliberately does **not** supply a render probe by default.
+ *
+ * ## Why no default render probe
+ *
+ * Rendering requires a browser (Playwright) and a dev server. Importing that here would make the CLI
+ * package depend on the test harness, and worse, it would tempt a caller into fabricating a "rendered"
+ * verdict from geometry when no browser is present. Omitting `renderProbe` means admission reports
+ * rendered visibility as `unproven` rather than passing -- the honest outcome, and the one the whole
+ * investigation was about. A caller with a working harness injects it explicitly.
+ */
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, statSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join, resolve } from "node:path";
+import { defaultDownloadFile, runSearch } from "./pull-bridge.js";
+/**
+ * Build production screening effects.
+ *
+ * Search failures propagate as thrown errors so the pipeline records them per query rather than treating
+ * an outage as "no candidates exist" -- a distinction that cost a whole pass when I concluded the catalog
+ * was empty without having searched it.
+ */
+export function createScreeningEffects(options = {}) {
+    const staging = options.stagingDir
+        ? (mkdirSync(options.stagingDir, { recursive: true }), options.stagingDir)
+        : mkdtempSync(join(tmpdir(), "aura3d-screening-"));
+    return {
+        async search(query) {
+            const report = await runSearch({
+                query,
+                ...(options.env ? { env: options.env } : {}),
+                limit: options.searchLimit ?? 10
+            });
+            // Rejected candidates are deliberately included: the pipeline's own licence/pullability gates decide
+            // and record why each one fails. Filtering them here would discard exactly the reasons that make a
+            // screening report reviewable.
+            return [...report.candidates, ...report.rejectedCandidates].map(toScreeningCandidate);
+        },
+        async pull(candidate) {
+            const url = candidate.downloadUrl;
+            if (!url)
+                throw new Error("candidate has no download URL");
+            // Content-addressed by id so a re-pull of the same candidate is idempotent within a run.
+            const safeName = candidate.id.replace(/[^a-zA-Z0-9_-]+/g, "_");
+            const destination = join(staging, `${safeName}.glb`);
+            if (existsSync(destination)) {
+                return { localPath: destination, sizeBytes: statSync(destination).size };
+            }
+            const result = await defaultDownloadFile(url, destination);
+            const localPath = result?.path ?? destination;
+            if (!existsSync(localPath))
+                throw new Error(`download produced no file at ${localPath}`);
+            return { localPath, sizeBytes: statSync(localPath).size };
+        },
+        async inspectGeometry(_candidate, pull) {
+            return inspectGlbGeometry(pull.localPath);
+        },
+        ...(options.renderProbe ? { renderProbe: options.renderProbe } : {}),
+        ...(options.register ? { register: options.register } : {})
+    };
+}
+/**
+ * Structural geometry facts read directly from a GLB.
+ *
+ * This is the same measurement the standalone auditor performs, expressed in the admission vocabulary. It
+ * reads accessor min/max composed through the node hierarchy rather than trusting any manifest metadata,
+ * because the whole point of screening is to judge a file that is not registered yet.
+ */
+export function inspectGlbGeometry(file) {
+    const json = readGlbJson(file);
+    const parts = collectNodeWorldBounds(json);
+    const sizeBytes = statSync(file).size;
+    if (parts.length === 0) {
+        return { partCount: 0, triangles: 0, bounds: [0, 0, 0], materialCount: 0, textureCount: 0, drawCallsPerInstance: 0, sizeBytes };
+    }
+    const lo = [0, 1, 2].map((axis) => Math.min(...parts.map((part) => part.lo[axis])));
+    const hi = [0, 1, 2].map((axis) => Math.max(...parts.map((part) => part.hi[axis])));
+    const size = [hi[0] - lo[0], hi[1] - lo[1], hi[2] - lo[2]];
+    const triangles = parts.reduce((sum, part) => sum + part.triangles, 0);
+    const lengthAxis = size[0] >= size[2] ? 0 : 2;
+    const widthAxis = lengthAxis === 0 ? 2 : 0;
+    // Wheel-like parts: roughly circular in side profile, low-mounted, plausibly sized. Mirrors the
+    // standalone auditor's heuristic, because a second heuristic would let the two disagree.
+    const wheelParts = parts.filter((part) => {
+        const extent = [part.hi[0] - part.lo[0], part.hi[1] - part.lo[1], part.hi[2] - part.lo[2]];
+        if (Math.min(...extent) <= 0)
+            return false;
+        const topFraction = (part.hi[1] - lo[1]) / Math.max(size[1], 1e-9);
+        if (topFraction > 0.55)
+            return false;
+        const height = extent[1];
+        const length = extent[lengthAxis];
+        const width = extent[widthAxis];
+        if (Math.min(height, length) / Math.max(height, length) < 0.55)
+            return false;
+        if (width > Math.max(height, length) * 1.25)
+            return false;
+        const relative = Math.max(height, length) / Math.max(size[1], 1e-9);
+        return relative > 0.12 && relative < 0.75;
+    });
+    const midLength = (lo[lengthAxis] + hi[lengthAxis]) / 2;
+    const midWidth = (lo[widthAxis] + hi[widthAxis]) / 2;
+    const corners = new Set(wheelParts.map((part) => {
+        const alongLength = (part.lo[lengthAxis] + part.hi[lengthAxis]) / 2 > midLength ? "f" : "r";
+        const alongWidth = (part.lo[widthAxis] + part.hi[widthAxis]) / 2 > midWidth ? "l" : "r";
+        return `${alongLength}${alongWidth}`;
+    }));
+    const bodyHalfWidth = Math.max(Math.abs(lo[widthAxis]), Math.abs(hi[widthAxis]));
+    const wheelHalfWidth = wheelParts.reduce((widest, part) => Math.max(widest, Math.abs(part.lo[widthAxis]), Math.abs(part.hi[widthAxis])), 0);
+    const wheelsVisibleInSilhouette = wheelParts.length > 0 &&
+        wheelHalfWidth >= bodyHalfWidth - Math.max(size[widthAxis] * 0.02, 1e-6);
+    /*
+     * Per-instance draw cost, approximated as primitives x materials-in-use.
+     *
+     * This axis exists because a triangle budget missed a real regression: a 4.6MB pine cluster rendered
+     * correctly in isolation but carried 42 nodes and 5 materials per instance, driving a route to 840 draw
+     * calls and a blank capture.
+     */
+    const primitiveCount = parts.reduce((sum, part) => sum + part.primitiveCount, 0);
+    const materialCount = (json.materials ?? []).length;
+    const textureCount = (json.textures ?? []).length;
+    return {
+        partCount: parts.length,
+        triangles,
+        bounds: size,
+        materialCount,
+        textureCount,
+        wheelCandidates: wheelParts.length,
+        distinctWheelCorners: corners.size,
+        wheelsVisibleInSilhouette,
+        wheelHalfWidth,
+        bodyHalfWidth,
+        minY: lo[1],
+        drawCallsPerInstance: primitiveCount,
+        sizeBytes
+    };
+}
+/** Map a catalog search line into the pipeline's candidate shape. */
+function toScreeningCandidate(line) {
+    return {
+        id: line.id,
+        title: line.title,
+        provider: line.source,
+        licenseSpdx: line.license,
+        autoPullable: line.autoPullable,
+        ...(line.sourcePage ? { sourcePage: line.sourcePage } : {}),
+        ...(line.downloadUrl ? { downloadUrl: line.downloadUrl } : {}),
+        ...(line.author ? { author: line.author } : {})
+    };
+}
+function readGlbJson(file) {
+    const bytes = readFileSync(file);
+    if (bytes.length < 20 || bytes.readUInt32LE(0) !== 0x46546c67) {
+        throw new Error(`${file} is not a binary GLB`);
+    }
+    const jsonLength = bytes.readUInt32LE(12);
+    return JSON.parse(bytes.subarray(20, 20 + jsonLength).toString("utf8"));
+}
+/** World-space AABB per mesh node, from accessor min/max composed through the node hierarchy. */
+function collectNodeWorldBounds(json) {
+    const nodes = json.nodes ?? [];
+    const parent = new Map();
+    nodes.forEach((node, index) => (node.children ?? []).forEach((child) => parent.set(child, index)));
+    const localMatrix = (node) => {
+        if (Array.isArray(node.matrix))
+            return node.matrix;
+        const [tx = 0, ty = 0, tz = 0] = node.translation ?? [];
+        const [x = 0, y = 0, z = 0, w = 1] = node.rotation ?? [];
+        const [sx = 1, sy = 1, sz = 1] = node.scale ?? [];
+        const r = [
+            1 - 2 * (y * y + z * z), 2 * (x * y + z * w), 2 * (x * z - y * w),
+            2 * (x * y - z * w), 1 - 2 * (x * x + z * z), 2 * (y * z + x * w),
+            2 * (x * z + y * w), 2 * (y * z - x * w), 1 - 2 * (x * x + y * y)
+        ];
+        return [
+            r[0] * sx, r[1] * sx, r[2] * sx, 0,
+            r[3] * sy, r[4] * sy, r[5] * sy, 0,
+            r[6] * sz, r[7] * sz, r[8] * sz, 0,
+            tx, ty, tz, 1
+        ];
+    };
+    const multiply = (a, b) => {
+        const out = new Array(16).fill(0);
+        for (let column = 0; column < 4; column += 1) {
+            for (let row = 0; row < 4; row += 1) {
+                let sum = 0;
+                for (let k = 0; k < 4; k += 1)
+                    sum += a[k * 4 + row] * b[column * 4 + k];
+                out[column * 4 + row] = sum;
+            }
+        }
+        return out;
+    };
+    const worldMatrix = (index) => {
+        let matrix = localMatrix(nodes[index]);
+        let next = parent.get(index);
+        while (next !== undefined) {
+            matrix = multiply(localMatrix(nodes[next]), matrix);
+            next = parent.get(next);
+        }
+        return matrix;
+    };
+    const apply = (m, point) => [
+        m[0] * point[0] + m[4] * point[1] + m[8] * point[2] + m[12],
+        m[1] * point[0] + m[5] * point[1] + m[9] * point[2] + m[13],
+        m[2] * point[0] + m[6] * point[1] + m[10] * point[2] + m[14]
+    ];
+    const out = [];
+    nodes.forEach((node, index) => {
+        if (node.mesh === undefined)
+            return;
+        const mesh = json.meshes?.[node.mesh];
+        if (!mesh)
+            return;
+        let lo = [Infinity, Infinity, Infinity];
+        let hi = [-Infinity, -Infinity, -Infinity];
+        let triangles = 0;
+        let primitiveCount = 0;
+        for (const primitive of mesh.primitives ?? []) {
+            const positionIndex = primitive.attributes?.POSITION;
+            if (positionIndex === undefined)
+                continue;
+            const accessor = json.accessors?.[positionIndex];
+            if (!accessor?.min || !accessor?.max)
+                continue;
+            primitiveCount += 1;
+            lo = lo.map((value, axis) => Math.min(value, accessor.min[axis]));
+            hi = hi.map((value, axis) => Math.max(value, accessor.max[axis]));
+            if (primitive.indices !== undefined) {
+                triangles += Math.floor((json.accessors?.[primitive.indices]?.count ?? 0) / 3);
+            }
+        }
+        if (!lo.every(Number.isFinite))
+            return;
+        const matrix = worldMatrix(index);
+        const corners = [
+            ...[lo[0], hi[0]].flatMap((x) => [lo[1], hi[1]].flatMap((y) => [lo[2], hi[2]].map((z) => apply(matrix, [x, y, z]))))
+        ];
+        out.push({
+            lo: [0, 1, 2].map((axis) => Math.min(...corners.map((corner) => corner[axis]))),
+            hi: [0, 1, 2].map((axis) => Math.max(...corners.map((corner) => corner[axis]))),
+            triangles,
+            primitiveCount
+        });
+    });
+    return out;
+}
+/** sha256 of a staged file, for provenance binding in a screening report. */
+export function hashStagedFile(file) {
+    return `sha256-${createHash("sha256").update(readFileSync(file)).digest("hex")}`;
+}
+/** Resolve a project-relative path, for callers staging into the repository. */
+export function resolveProjectPath(projectDir, relativePath) {
+    return resolve(projectDir ?? process.cwd(), relativePath);
+}
+/**
+ * Build a render probe that reads a *retained* multi-angle visibility report.
+ *
+ * ## Why reading retained evidence is the right binding
+ *
+ * The alternative — launching a browser from inside the CLI — would make this package depend on the test
+ * harness and would put a 30-second render inside a search loop. Worse, a caller without a browser would be
+ * tempted to synthesise a verdict from geometry, which is the conflation that produced a false renderer
+ * diagnosis in the first place.
+ *
+ * Retained reports are produced by `tests/browser/vehicle-wheel-visibility.spec.ts`, which renders an asset
+ * across several azimuths and measures the lower-silhouette wheel band per angle. Reading them means the
+ * pipeline consumes *real rendered proof* while the rendering stays owned by the browser suite.
+ *
+ * A missing report is not treated as a failure: `renderedWheelVisibility` is left undefined so admission
+ * reports `unproven`. That distinction matters — "no evidence" and "evidence of absence" are different, and
+ * conflating them is what made a correctly-drawing asset look broken.
+ */
+export function createRetainedRenderProbe(options = {}) {
+    const reportDir = options.reportDir ?? "tests/reports/vehicle-wheel-visibility";
+    const minBandPixels = options.minBandPixels ?? 2_000;
+    return async (candidate) => {
+        // Reports are keyed by registered asset id, not by provider candidate id.
+        const assetId = candidate.id.includes(":") ? candidate.id.split(":").pop() : candidate.id;
+        const path = resolveProjectPath(options.projectDir, join(reportDir, `${assetId}.json`));
+        if (!existsSync(path))
+            return {};
+        const report = JSON.parse(readFileSync(path, "utf8"));
+        const angles = report.angles ?? [];
+        /*
+         * An angle counts as readable when the wheel band carries real mass in *both* outer thirds.
+         *
+         * Centre-only mass is bodywork seen head-on — precisely the geometry of the misleading dead-astern
+         * probe. Requiring both outer thirds is what distinguishes "wheels read here" from "the car's rear is
+         * filling the frame".
+         */
+        const readable = angles.filter((angle) => {
+            const band = angle.wheelBand;
+            if (!band || (band.pixels ?? 0) < minBandPixels)
+                return false;
+            const outer = Math.min(band.leftThird ?? 0, band.rightThird ?? 0);
+            return outer >= (band.pixels ?? 0) * 0.18;
+        });
+        return {
+            screenshotPath: join(reportDir, `${assetId}-angle-0.png`),
+            renderedWheelVisibility: readable.length > 0,
+            renderedAzimuths: readable
+                .map((angle) => angle.azimuth ?? 0)
+                // A dead-on view is excluded from the evidence set: it is the one angle where bodywork hides wheels.
+                .filter((azimuth) => Math.abs(azimuth) > 0.2)
+        };
+    };
+}
+//# sourceMappingURL=asset-screening-effects.js.map

package/dist/asset-screening-effects.js.map

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

package/dist/asset-screening-pipeline.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Orchestrated candidate screening pipeline.
+ *
+ * ## Why an orchestrator rather than a documented procedure
+ *
+ * The individual capabilities exist: search, `--index`/`--candidate-id` selection, geometry auditing,
+ * isolated render probes, role-aware admission, registration and typegen. What did not exist was
+ * anything that *runs them in order and keeps the record*. In practice that meant a human ran a few
+ * steps by hand, formed an impression, and moved on -- which is exactly how three unusable hero vehicles
+ * shipped in a row, and how I once concluded "the catalog has no suitable props" without having searched
+ * it.
+ *
+ * The pipeline's real product is therefore not the accepted asset. It is the **retained record of every
+ * candidate and why it was rejected**. An accepted asset with no record of its rivals cannot be
+ * reviewed, and a rejection with no reason cannot be learned from.
+ *
+ * ## Stages
+ *
+ * search -> enumerate -> select -> pull -> inspect geometry -> render probe -> score role fitness ->
+ * reject with machine-readable reasons -> rank accepted -> register durably -> typegen -> certify.
+ *
+ * ## Deliberate injection seams
+ *
+ * Every external effect (search, pull, geometry inspection, render probe, register) is injected. That is
+ * not test convenience: a render probe needs a browser and a pull needs the network, so a pipeline that
+ * hardcoded them could only ever be tested by running the whole thing. Injection lets the *ordering and
+ * record-keeping logic* -- the part that failed before -- be tested deterministically and offline.
+ */
+import { type AssetAdmissionReport, type AssetGeometryFacts, type AssetRenderedFacts } from "./asset-role-admission.js";
+import { type AssetIntent } from "./asset-intent.js";
+/** A candidate as returned by search, before anything has been downloaded. */
+export interface ScreeningCandidate {
+    /** Provider-qualified id, e.g. `objaverse:ffca09fb...`. */
+    readonly id: string;
+    readonly title?: string | undefined;
+    readonly provider?: string | undefined;
+    readonly licenseSpdx?: string | undefined;
+    readonly author?: string | undefined;
+    readonly sourcePage?: string | undefined;
+    readonly downloadUrl?: string | undefined;
+    /** Provider-reported rank score; used only for tie-breaks, never as fitness. */
+    readonly searchScore?: number | undefined;
+    /** True when the candidate can be fetched without interactive auth. */
+    readonly autoPullable?: boolean | undefined;
+    readonly sizeBytes?: number | undefined;
+}
+/** Result of pulling a candidate to a local path. */
+export interface ScreeningPullResult {
+    readonly localPath: string;
+    readonly sizeBytes?: number | undefined;
+}
+/** Per-instance render cost, which a triangle budget does not capture. */
+export interface ScreeningRenderCost {
+    readonly drawCallsPerInstance?: number | undefined;
+}
+/** Injected effects. Each may throw; a throw rejects that candidate and the pipeline continues. */
+export interface ScreeningEffects {
+    /** Enumerate candidates for a query. */
+    search(query: string): Promise<readonly ScreeningCandidate[]>;
+    /** Download a candidate. */
+    pull(candidate: ScreeningCandidate): Promise<ScreeningPullResult>;
+    /** Structural geometry facts from the pulled file. */
+    inspectGeometry(candidate: ScreeningCandidate, pull: ScreeningPullResult): Promise<AssetGeometryFacts & ScreeningRenderCost>;
+    /**
+     * Render the candidate in isolation and report whether required features read.
+     *
+     * Optional: when absent, admission reports rendered visibility as `unproven` rather than passing,
+     * which is the honest outcome. It must never be synthesised from geometry.
+     */
+    renderProbe?: ((candidate: ScreeningCandidate, pull: ScreeningPullResult) => Promise<AssetRenderedFacts>) | undefined;
+    /** Register the accepted asset durably and generate typed bindings. */
+    register?: ((candidate: ScreeningCandidate, pull: ScreeningPullResult) => Promise<{
+        readonly assetId: string;
+        readonly typedRef: string;
+    }>) | undefined;
+}
+export type ScreeningStage = "search" | "license-policy" | "auto-pullable" | "pull" | "inspect-geometry" | "budget" | "render-probe" | "admission" | "register";
+/** One candidate's outcome, retained whether accepted or not. */
+export interface ScreeningCandidateOutcome {
+    readonly candidate: ScreeningCandidate;
+    /** Zero-based position in the deduplicated enumerated list. */
+    readonly index: number;
+    readonly accepted: boolean;
+    /** Stage at which the candidate was rejected. `undefined` when accepted. */
+    readonly rejectedAtStage?: ScreeningStage | undefined;
+    /** Machine-readable rejection reasons. Never empty for a rejected candidate. */
+    readonly reasons: readonly string[];
+    readonly geometry?: (AssetGeometryFacts & ScreeningRenderCost) | undefined;
+    readonly rendered?: AssetRenderedFacts | undefined;
+    readonly admission?: AssetAdmissionReport | undefined;
+}
+export interface ScreeningReport {
+    readonly schema: "aura3d-asset-screening/1.0";
+    readonly intentId: string;
+    readonly role: string;
+    readonly queries: readonly string[];
+    /** Every candidate seen, in enumeration order, with its outcome. */
+    readonly candidates: readonly ScreeningCandidateOutcome[];
+    /** Accepted candidates, best first. */
+    readonly ranked: readonly ScreeningCandidateOutcome[];
+    /** The selected candidate, when one was accepted or a fallback allowed one. */
+    readonly selected?: ScreeningCandidateOutcome | undefined;
+    /** Set when the selection only satisfied a fallback policy; names what is still unproven. */
+    readonly fallbackApplied?: {
+        readonly policy: string;
+        readonly gaps: readonly string[];
+    } | undefined;
+    readonly registered?: {
+        readonly assetId: string;
+        readonly typedRef: string;
+    } | undefined;
+    /** Counts per stage, so "where do candidates die?" is answerable without reading every entry. */
+    readonly rejectionsByStage: Readonly<Record<string, number>>;
+}
+export interface ScreeningOptions {
+    readonly intent: AssetIntent;
+    readonly effects: ScreeningEffects;
+    /** Maximum candidates to pull. Pulling is the expensive stage, so it is bounded. */
+    readonly maxCandidatesToPull?: number | undefined;
+    /** Stop after the first accepted candidate. Default true; set false to rank the whole set. */
+    readonly stopAtFirstAccepted?: boolean | undefined;
+}
+/**
+ * Run the screening pipeline for an intent.
+ *
+ * Throws only for an incoherent intent -- a request that cannot be satisfied as written is a caller
+ * defect, not a screening outcome. Everything else is reported.
+ */
+export declare function screenAssetCandidates(options: ScreeningOptions): Promise<ScreeningReport>;
+/** Render a screening report as human-readable lines. Every rejection keeps its reason. */
+export declare function formatScreeningReport(report: ScreeningReport): readonly string[];
+//# sourceMappingURL=asset-screening-pipeline.d.ts.map

package/dist/asset-screening-pipeline.d.ts.map

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