@aura3d/cli 1.3.3 → 1.4.0

package/dist/asset-source-validation.js

@@ -0,0 +1,200 @@
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { relative, resolve } from "node:path";
+import { DEFAULT_AURA_ASSET_MANIFEST, DEFAULT_AURA_ASSET_TYPEGEN, } from "./asset-constants.js";
+import { scanAssetSourceAst } from "./asset-source-ast.js";
+export function shouldScanSource(options) {
+    return options.source !== undefined || options.release === true;
+}
+export function validateAssetSource(projectDir, sourceOption, manifest) {
+    const roots = resolveSourceValidationRoots(projectDir, sourceOption);
+    const files = roots.flatMap((root) => collectSourceValidationFiles(projectDir, root));
+    const failures = [];
+    const warnings = [];
+    const usageCounts = new Map();
+    const assetIds = new Set(manifest.assets.map((asset) => asset.id));
+    for (const file of files) {
+        const relativeFile = normalizeRelativePath(relative(projectDir, file));
+        const source = readFileSync(file, "utf8");
+        const scanText = stripSourceComments(source);
+        const pushFailure = (message) => {
+            pushUnique(failures, `${relativeFile}: ${message}`);
+        };
+        const pushWarning = (message) => {
+            pushUnique(warnings, `${relativeFile}: ${message}`);
+        };
+        const astScan = scanAssetSourceAst(relativeFile, source);
+        for (const failure of astScan.failures)
+            pushFailure(failure);
+        for (const warning of astScan.warnings)
+            pushWarning(warning);
+        for (const match of scanText.matchAll(/\bmodel\s*\(\s*(["'`])([^"'`]*?)\1/g)) {
+            pushFailure(`raw model string id "${match[2]}" passed to model(). Use generated typed assets, for example model(assets.${sanitizeAssetId(match[2] ?? "asset")}).`);
+        }
+        for (const url of findRawGlbUrls(scanText)) {
+            pushFailure(`raw GLB/glTF URL or path "${url}" found in source. Add it with assets add/resolve and use model(assets.x).`);
+        }
+        if (/\bunsafeModelUrl\b/.test(scanText)) {
+            pushFailure("unsafeModelUrl is not allowed in public examples. Preserve typed asset safety with generated assets from ./src/aura-assets.");
+        }
+        if (/\bGLTFLoader\b/.test(scanText)) {
+            pushFailure("GLTFLoader is not allowed in public examples. Use model(assets.x) from @aura3d/engine.");
+        }
+        if (/(?:from\s*["']three(?:\/examples[^"']*)?["']|import\s*["']three(?:\/examples[^"']*)?["']|require\s*\(\s*["']three(?:\/examples[^"']*)?["']\s*\))/.test(scanText)) {
+            pushFailure("direct three imports are not allowed in public examples. Use @aura3d/engine public APIs.");
+        }
+        if (hasPrimitiveOnlyPrimaryRoleIndicator(scanText)) {
+            pushWarning("primary-role scene appears primitive-only: source mentions character/world/vehicle/product/environment roles and uses primitives.* without typed model(assets.x).");
+        }
+        for (const warning of findPrimitivePrimaryRoleWarnings(scanText)) {
+            pushWarning(warning);
+        }
+        for (const usage of astScan.typedAssetUsages) {
+            const key = `${usage.assetId}\0${usage.typedAsset}\0${relativeFile}`;
+            const current = usageCounts.get(key);
+            usageCounts.set(key, {
+                ...usage,
+                file: relativeFile,
+                occurrences: (current?.occurrences ?? 0) + 1,
+            });
+        }
+    }
+    const typedAssetUsages = [...usageCounts.values()].sort((a, b) => a.assetId.localeCompare(b.assetId) ||
+        a.file.localeCompare(b.file) ||
+        a.typedAsset.localeCompare(b.typedAsset));
+    const filesByAsset = typedAssetUsages.reduce((acc, usage) => {
+        acc[usage.assetId] ??= [];
+        if (!acc[usage.assetId].includes(usage.file))
+            acc[usage.assetId].push(usage.file);
+        return acc;
+    }, {});
+    for (const filesForAsset of Object.values(filesByAsset)) {
+        filesForAsset.sort((a, b) => a.localeCompare(b));
+    }
+    for (const usage of typedAssetUsages) {
+        if (!assetIds.has(usage.assetId)) {
+            failures.push(`${usage.file}: typed asset ${usage.typedAsset} is not present in ${DEFAULT_AURA_ASSET_MANIFEST}. Add it with aura3d assets add/resolve and regenerate ${DEFAULT_AURA_ASSET_TYPEGEN}.`);
+        }
+    }
+    return {
+        enabled: true,
+        roots: roots.map((root) => normalizeRelativePath(relative(projectDir, root))),
+        files: files.map((file) => normalizeRelativePath(relative(projectDir, file))),
+        typedAssetUsages,
+        filesByAsset,
+        failures,
+        warnings,
+    };
+}
+function resolveSourceValidationRoots(projectDir, sourceOption) {
+    if (typeof sourceOption === "string" && sourceOption.trim()) {
+        return [resolve(projectDir, sourceOption)];
+    }
+    const defaultRoots = ["src", "app", "apps", "examples", "templates"]
+        .map((entry) => resolve(projectDir, entry))
+        .filter((entry) => existsSync(entry));
+    return defaultRoots.length > 0 ? defaultRoots : [projectDir];
+}
+function collectSourceValidationFiles(projectDir, root) {
+    if (!existsSync(root))
+        return [];
+    if (statSync(root).isFile())
+        return isSourceValidationFile(projectDir, root) ? [root] : [];
+    const files = [];
+    const visit = (directory) => {
+        for (const entry of readdirSync(directory, { withFileTypes: true })) {
+            const path = resolve(directory, entry.name);
+            if (entry.isDirectory()) {
+                if (isSkippedSourceValidationDirectory(entry.name))
+                    continue;
+                visit(path);
+            }
+            else if (entry.isFile() && isSourceValidationFile(projectDir, path)) {
+                files.push(path);
+            }
+        }
+    };
+    visit(root);
+    return files.sort((a, b) => a.localeCompare(b));
+}
+function isSkippedSourceValidationDirectory(name) {
+    return [
+        "node_modules",
+        "dist",
+        "build",
+        "coverage",
+        ".git",
+        ".next",
+        ".vite",
+        "public",
+        "assets",
+        "artifacts",
+    ].includes(name);
+}
+function isSourceValidationFile(projectDir, path) {
+    const relativePath = normalizeRelativePath(relative(projectDir, path));
+    if (/(^|\/)aura-assets\.ts$/.test(relativePath))
+        return false;
+    if (/(^|\/)(?:dist|build|coverage|node_modules|public|assets|artifacts)\//.test(relativePath))
+        return false;
+    return /\.(?:ts|tsx|js|jsx|mjs|cjs)$/.test(path);
+}
+function stripSourceComments(source) {
+    return source
+        .replace(/\/\*[\s\S]*?\*\//g, (value) => value.replace(/[^\n]/g, " "))
+        .replace(/(^|[^:])\/\/.*$/gm, "$1");
+}
+function findRawGlbUrls(source) {
+    const matches = new Set();
+    for (const match of source.matchAll(/(["'`])([^"'`]*?(?:https?:\/\/|\/)[^"'`]*?\.gl(?:b|tf)(?:\?[^"'`]*)?)\1/gi)) {
+        matches.add(match[2] ?? "");
+    }
+    for (const match of source.matchAll(/(["'`])([^"'`]*?\.gl(?:b|tf)(?:\?[^"'`]*)?)\1/gi)) {
+        const value = match[2] ?? "";
+        if (/^(?:\.{0,2}\/|https?:\/\/|\/|[a-z]:[\\/])/i.test(value))
+            matches.add(value);
+    }
+    return [...matches].filter(Boolean).sort();
+}
+function hasPrimitiveOnlyPrimaryRoleIndicator(source) {
+    if (!/\bprimitives\.[a-zA-Z_][\w]*/.test(source))
+        return false;
+    if (/\bmodel\s*\(/.test(source) || /\bassets\.[a-zA-Z_][\w]*/.test(source))
+        return false;
+    if (hasProceduralGamePrimitiveContract(source))
+        return false;
+    const searchable = source
+        .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+        .replace(/[_-]+/g, " ");
+    return /\b(character|fighter|player|avatar|vehicle|car|kart|ship|world|level|stage|environment|terrain|hero\s+product|product|creature|weapon|primary)\b/i.test(searchable);
+}
+function hasProceduralGamePrimitiveContract(source) {
+    return /\bgame\.fallingBlocks\s*\(/.test(source) &&
+        /\bprocedural(?:\s+Aura3D)?\s+falling-block\b/i.test(source);
+}
+function findPrimitivePrimaryRoleWarnings(source) {
+    if (!/\bprimitives\.[a-zA-Z_][\w]*/.test(source))
+        return [];
+    const warnings = new Set();
+    const primaryIdentifier = /\b(?:character|fighter|player|avatar|vehicle|car|kart|ship|world|level|stage|environment|terrain|hero|product|creature|weapon|track)\b/i;
+    for (const match of source.matchAll(/\b(?:const|let|var)\s+([A-Za-z_$][\w$]*)\s*=\s*primitives\.[a-zA-Z_][\w]*/g)) {
+        const name = match[1] ?? "";
+        const readable = name
+            .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+            .replace(/[_-]+/g, " ");
+        if (primaryIdentifier.test(readable)) {
+            warnings.add(`primitive "${name}" appears assigned to a primary-role object. Primary characters, vehicles, worlds, tracks, products, and weapons must use typed model(assets.x) assets or be marked abstract/prototype.`);
+        }
+    }
+    return [...warnings].sort();
+}
+function pushUnique(target, value) {
+    if (!target.includes(value))
+        target.push(value);
+}
+function normalizeRelativePath(path) {
+    return path.split("\\").join("/");
+}
+function sanitizeAssetId(value) {
+    return value.replace(/[^a-zA-Z0-9_]/g, "_").replace(/^(\d)/, "_$1");
+}
+//# sourceMappingURL=asset-source-validation.js.map

package/dist/asset-source-validation.js.map

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

package/dist/character-assembly-types.d.ts

@@ -0,0 +1,39 @@
+import type { AuraCliAssetType } from "./asset-core-types.js";
+import type { AuraCliHumanoidInspection } from "./asset-inspection-types.js";
+export interface CharacterAssemblyPlanOptions {
+    readonly projectDir?: string;
+    readonly name: string;
+    readonly body: string;
+    readonly parts?: readonly CharacterAssemblyPartInput[];
+    readonly scale?: number;
+    readonly output?: string;
+}
+export interface CharacterAssemblyPartInput {
+    readonly slot: string;
+    readonly asset: string;
+    readonly attachTo?: string;
+}
+export interface CharacterAssemblyPlanResult {
+    readonly ok: boolean;
+    readonly schema: "aura3d.character-assembly/1.0";
+    readonly name: string;
+    readonly output: string;
+    readonly body: CharacterAssemblyResolvedPart;
+    readonly parts: readonly CharacterAssemblyResolvedPart[];
+    readonly validation: {
+        readonly failures: readonly string[];
+        readonly warnings: readonly string[];
+    };
+    readonly messages: readonly string[];
+}
+export interface CharacterAssemblyResolvedPart {
+    readonly slot: string;
+    readonly asset: string;
+    readonly url: string;
+    readonly type: AuraCliAssetType;
+    readonly format: string;
+    readonly animations: readonly string[];
+    readonly humanoid?: AuraCliHumanoidInspection;
+    readonly attachTo: string;
+}
+//# sourceMappingURL=character-assembly-types.d.ts.map

package/dist/character-assembly-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-assembly-types.d.ts","sourceRoot":"","sources":["../../../../packages/aura3d-cli/src/character-assembly-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAE7E,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,+BAA+B,CAAC;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,6BAA6B,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,SAAS,6BAA6B,EAAE,CAAC;IACzD,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;QACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;KACtC,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B"}

package/dist/character-assembly-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=character-assembly-types.js.map

package/dist/character-assembly-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-assembly-types.js","sourceRoot":"","sources":["../../../../packages/aura3d-cli/src/character-assembly-types.ts"],"names":[],"mappings":""}

package/dist/cli-help.d.ts

@@ -0,0 +1,4 @@
+export declare const assetRoleUsage = "character|vehicle|world|environment|track|product|weapon|prop|set-dressing|debug|abstract|unknown";
+export declare function assetsAddHelp(): string;
+export declare function mainHelp(profileUsage: string): string;
+//# sourceMappingURL=cli-help.d.ts.map

package/dist/cli-help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-help.d.ts","sourceRoot":"","sources":["../../../../packages/aura3d-cli/src/cli-help.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,sGAC0E,CAAC;AAEtG,wBAAgB,aAAa,IAAI,MAAM,CAsBtC;AAED,wBAAgB,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAsBrD"}

package/dist/cli-help.js

@@ -0,0 +1,48 @@
+export const assetRoleUsage = "character|vehicle|world|environment|track|product|weapon|prop|set-dressing|debug|abstract|unknown";
+export function assetsAddHelp() {
+    return `Usage: aura3d assets add ./model.glb --name robot [options]
+
+Options:
+  --type model|texture|environment|audio
+  --license CC0-1.0
+  --license-name "CC0 1.0 Universal"
+  --license-url URL
+  --license-raw TEXT
+  --source-page URL
+  --download-url URL
+  --source-url URL
+  --author NAME
+  --source-family NAME
+  --attribution TEXT
+  --quality ungraded|blocked|prototype|candidate|release
+  --role ${assetRoleUsage}
+  --suitability TEXT
+  --rendered-probe-json tests/reports/asset.probe.json
+  --rendered-probe /aura-assets/probe.png
+  --public-path /aura-assets/name.glb
+  --output public/aura-assets`;
+}
+export function mainHelp(profileUsage) {
+    return `Aura3D CLI
+
+Commands:
+  aura3d assets add ./model.glb --name robot [--type model|texture|environment|audio] [--license CC0-1.0] [--license-url URL] [--source-page URL] [--download-url URL] [--source-url URL] [--author NAME] [--quality ungraded|blocked|prototype|candidate|release] [--role ${assetRoleUsage}] [--suitability TEXT] [--rendered-probe-json tests/reports/asset.probe.json] [--rendered-probe /aura-assets/probe.png]
+  aura3d assets scan ./assets
+  aura3d assets inspect ./model.glb [--animation] [--humanoid] [--skeleton] [--morphs] [--license]
+  aura3d assets validate [--asset assetId|--no-assets] [--source [src]] [--release] [--no-placeholders] [--require-license] [--provenance evidence.json]
+  aura3d assets validate-game [--profile fighting-character] [--asset fighter] [--output artifacts/aura3d/game-assets.json] [--no-placeholders] [--require-license] [--provenance evidence.json]
+  aura3d assets validate-animation-studio [--episode] [--asset character] [--output artifacts/aura3d/animation-studio-assets.json] [--no-placeholders] [--require-license] [--provenance evidence.json]
+  aura3d assets validate-animation --clips Idle_Loop,Walk_Loop,Sprint_Loop --map idle=Idle_Loop,walk=Walk_Loop,run=Sprint_Loop [--require idle,walk,run] [--require-rig]
+  aura3d assets assemble-character --name hero --body bodyAsset --part hair=hairAsset
+  aura3d assets list
+  aura3d assets typegen
+  aura3d assets thumbnail
+  aura3d assets search <query> [--profile ${profileUsage}] [--license cc0|cc-by] [--max-tris N] [--animated] [--json]
+  aura3d assets resolve <query> --name <name> [--profile ${profileUsage}] [--license cc0|cc-by] [--max-tris N] [--animated]
+  aura3d animation plan|preview|render|package|review|verify [--dry-run]
+  aura3d animation scene <new|show|cast add|prop add|set|block|camera|shot|dialogue|render|...>  (agent-native Scene-Tool CLI)
+  aura3d doctor
+  aura3d check-deploy --dist dist [--release] [--source [src]] [--asset assetId|--no-assets]
+  aura3d init --agent all`;
+}
+//# sourceMappingURL=cli-help.js.map

package/dist/cli-help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-help.js","sourceRoot":"","sources":["../../../../packages/aura3d-cli/src/cli-help.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GACzB,mGAAmG,CAAC;AAEtG,MAAM,UAAU,aAAa;IAC3B,OAAO;;;;;;;;;;;;;;;WAeE,cAAc;;;;;8BAKK,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,YAAoB;IAC3C,OAAO;;;6QAGoQ,cAAc;;;;;;;;;;;4CAW/O,YAAY;2DACG,YAAY;;;;;0BAK7C,CAAC;AAC3B,CAAC"}

package/dist/cli-options.d.ts

@@ -0,0 +1,66 @@
+import { type AuraAssetQuality, type AuraCliAssetRole, type AuraCliRenderedProbe } from "./index.js";
+import type { CliAssetSearchProfile, CliResolveConstraints } from "./pull-bridge.js";
+export declare function createCliOptionReaders(args: readonly string[]): {
+    hasFlag: (name: string) => boolean;
+    readAssetQuality: () => AuraAssetQuality | undefined;
+    readAssetRole: () => AuraCliAssetRole | undefined;
+    readAssetType: () => "model" | "texture" | "environment" | "audio" | undefined;
+    readAssetValidationOptions: () => {
+        readonly episode?: boolean;
+        readonly noPlaceholders?: boolean;
+        readonly requireLicense?: boolean;
+        readonly provenanceFile?: string;
+        readonly assetIds?: readonly string[];
+        readonly source?: boolean | string;
+        readonly release?: boolean;
+    };
+    readCliAssetProfile: () => CliAssetSearchProfile;
+    readEvidenceOutput: () => string | undefined;
+    readInspectFile: () => string | undefined;
+    readOption: (name: string) => string | undefined;
+    readParts: (name: string) => readonly {
+        readonly slot: string;
+        readonly asset: string;
+    }[];
+    readRenderedProbe: () => AuraCliRenderedProbe | undefined;
+    readResolveConstraints: () => CliResolveConstraints;
+};
+export declare function profileUsage(): string;
+export declare function printSearchReport(report: {
+    readonly query: string;
+    readonly profile: CliAssetSearchProfile;
+    readonly candidates: readonly {
+        readonly id: string;
+        readonly source: string;
+        readonly title: string;
+        readonly license: string;
+        readonly autoPullable: boolean;
+        readonly sourcePage?: string;
+        readonly profile?: {
+            readonly suitable: boolean;
+            readonly rejectionReasons: readonly string[];
+            readonly warnings: readonly string[];
+        };
+    }[];
+    readonly rejectedCandidates?: readonly {
+        readonly id: string;
+        readonly source: string;
+        readonly title: string;
+        readonly license: string;
+        readonly autoPullable: boolean;
+        readonly sourcePage?: string;
+        readonly profile?: {
+            readonly suitable: boolean;
+            readonly rejectionReasons: readonly string[];
+            readonly warnings: readonly string[];
+        };
+    }[];
+    readonly deepLinks: readonly {
+        readonly id: string;
+        readonly title: string;
+        readonly sourcePage?: string;
+    }[];
+    readonly warnings: readonly string[];
+    readonly messages: readonly string[];
+}): void;
+//# sourceMappingURL=cli-options.d.ts.map

package/dist/cli-options.d.ts.map

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

package/dist/cli-options.js

@@ -0,0 +1,234 @@
+import { readRenderedProbeMetadata, } from "./index.js";
+export function createCliOptionReaders(args) {
+    function readOption(name) {
+        const index = args.indexOf(name);
+        return index >= 0 ? args[index + 1] : undefined;
+    }
+    function readOptionalOption(name) {
+        const index = args.indexOf(name);
+        if (index < 0)
+            return undefined;
+        const value = args[index + 1];
+        return value && !value.startsWith("--") ? value : undefined;
+    }
+    function hasFlag(name) {
+        return args.includes(name);
+    }
+    function readInspectFile() {
+        return args.slice(2).find((value) => !value.startsWith("--"));
+    }
+    function readEvidenceOutput() {
+        if (hasFlag("--output")) {
+            const output = readOption("--output");
+            if (!output || output.startsWith("--"))
+                throw new Error("Expected --output <path>.");
+            return output;
+        }
+        if (hasFlag("--evidence")) {
+            const evidence = readOption("--evidence");
+            if (!evidence || evidence.startsWith("--"))
+                throw new Error("Expected --evidence <path>.");
+            return evidence;
+        }
+        return undefined;
+    }
+    function readAssetValidationOptions() {
+        const options = {};
+        if (hasFlag("--episode"))
+            options.episode = true;
+        if (hasFlag("--no-placeholders"))
+            options.noPlaceholders = true;
+        if (hasFlag("--require-license"))
+            options.requireLicense = true;
+        if (hasFlag("--release"))
+            options.release = true;
+        if (hasFlag("--source"))
+            options.source = readOptionalOption("--source") ?? true;
+        const assetIds = readRepeatedOptions("--asset").flatMap((value) => value.split(",").map((entry) => entry.trim()).filter(Boolean));
+        if (hasFlag("--no-assets") && assetIds.length > 0)
+            throw new Error("Use either --asset <id> or --no-assets, not both.");
+        if (hasFlag("--no-assets"))
+            options.assetIds = [];
+        else if (assetIds.length > 0)
+            options.assetIds = assetIds;
+        if (hasFlag("--provenance")) {
+            const provenanceFile = readOption("--provenance");
+            if (!provenanceFile || provenanceFile.startsWith("--"))
+                throw new Error("Expected --provenance <path>.");
+            options.provenanceFile = provenanceFile;
+        }
+        return options;
+    }
+    function readRepeatedOptions(name) {
+        const values = [];
+        for (let index = 0; index < args.length; index += 1) {
+            if (args[index] !== name)
+                continue;
+            const value = args[index + 1];
+            if (!value || value.startsWith("--"))
+                throw new Error(`Expected ${name} <value>.`);
+            values.push(value);
+        }
+        return values;
+    }
+    function readParts(name) {
+        const parts = [];
+        for (let index = 0; index < args.length; index += 1) {
+            if (args[index] !== name)
+                continue;
+            const value = args[index + 1];
+            if (!value || value.startsWith("--"))
+                throw new Error(`Expected ${name} slot=asset`);
+            const [slot, asset] = value.split("=");
+            if (!slot || !asset)
+                throw new Error(`Expected ${name} slot=asset, got "${value}"`);
+            parts.push({ slot, asset });
+        }
+        return parts;
+    }
+    function readAssetType() {
+        const value = readOption("--type");
+        if (!value)
+            return undefined;
+        if (value === "model" || value === "texture" || value === "environment" || value === "audio")
+            return value;
+        throw new Error(`Unsupported --type value "${value}". Use model, texture, environment, or audio.`);
+    }
+    function readAssetQuality() {
+        const value = readOption("--quality");
+        if (!value)
+            return undefined;
+        if (value === "ungraded" || value === "blocked" || value === "prototype" || value === "candidate" || value === "release")
+            return value;
+        throw new Error(`Unsupported --quality value "${value}". Use ungraded, blocked, prototype, candidate, or release.`);
+    }
+    function readAssetRole() {
+        const value = readOption("--role");
+        if (!value)
+            return undefined;
+        if (value === "character" ||
+            value === "vehicle" ||
+            value === "world" ||
+            value === "environment" ||
+            value === "track" ||
+            value === "product" ||
+            value === "weapon" ||
+            value === "prop" ||
+            value === "set-dressing" ||
+            value === "debug" ||
+            value === "abstract" ||
+            value === "unknown")
+            return value;
+        throw new Error(`Unsupported --role value "${value}". Use character, vehicle, world, environment, track, product, weapon, prop, set-dressing, debug, abstract, or unknown.`);
+    }
+    function readRenderedProbe() {
+        const metadataFile = readOption("--rendered-probe-json");
+        const url = readOption("--rendered-probe");
+        if (metadataFile && url)
+            throw new Error("Use either --rendered-probe-json or --rendered-probe, not both.");
+        if (metadataFile) {
+            if (metadataFile.startsWith("--"))
+                throw new Error("Expected --rendered-probe-json <metadata.json>.");
+            return readRenderedProbeMetadata({ file: metadataFile });
+        }
+        if (!url)
+            return undefined;
+        if (url.startsWith("--"))
+            throw new Error("Expected --rendered-probe <url-or-public-path>.");
+        return {
+            url,
+            kind: "browser-screenshot",
+            checkedAt: new Date().toISOString(),
+        };
+    }
+    function readResolveConstraints() {
+        const constraints = {};
+        const license = readOption("--license");
+        if (license) {
+            const normalized = license.toLowerCase();
+            if (normalized === "cc0")
+                constraints.license = ["CC0"];
+            else if (normalized === "cc-by" || normalized === "ccby")
+                constraints.license = ["CC-BY"];
+            else
+                throw new Error(`Unsupported --license value "${license}". Use cc0 or cc-by.`);
+        }
+        const maxTris = readOption("--max-tris");
+        if (maxTris) {
+            const parsed = Number.parseInt(maxTris, 10);
+            if (!Number.isFinite(parsed) || parsed <= 0)
+                throw new Error(`--max-tris must be a positive integer (got "${maxTris}").`);
+            constraints.maxTriangles = parsed;
+        }
+        if (hasFlag("--animated"))
+            constraints.animated = true;
+        const profile = readCliAssetProfile();
+        return profile === "general" ? constraints : { ...constraints, profile };
+    }
+    function readCliAssetProfile() {
+        const value = readOption("--profile");
+        if (!value)
+            return "general";
+        if (isSupportedAssetProfile(value))
+            return value;
+        throw new Error(`Unsupported --profile value "${value}". Use ${profileUsage()}.`);
+    }
+    return {
+        hasFlag,
+        readAssetQuality,
+        readAssetRole,
+        readAssetType,
+        readAssetValidationOptions,
+        readCliAssetProfile,
+        readEvidenceOutput,
+        readInspectFile,
+        readOption,
+        readParts,
+        readRenderedProbe,
+        readResolveConstraints,
+    };
+}
+function isSupportedAssetProfile(value) {
+    return (value === "fighting-character" ||
+        value === "animation-character" ||
+        value === "animation-prop" ||
+        value === "animation-set" ||
+        value === "animation-environment");
+}
+export function profileUsage() {
+    return "fighting-character|animation-character|animation-prop|animation-set|animation-environment";
+}
+export function printSearchReport(report) {
+    for (const message of report.messages)
+        console.log(message);
+    for (const candidate of report.candidates) {
+        const profileTag = candidate.profile
+            ? candidate.profile.suitable
+                ? ", profile-ready"
+                : ", profile-rejected"
+            : "";
+        const tag = candidate.autoPullable ? `auto-pullable${profileTag}` : `manual license check required${profileTag}`;
+        console.log(`  [${candidate.source}] ${candidate.id}  "${candidate.title}"  ${candidate.license}  (${tag})`);
+        if (candidate.profile && !candidate.profile.suitable) {
+            for (const reason of candidate.profile.rejectionReasons)
+                console.log(`    rejects: ${reason}`);
+        }
+    }
+    if (report.rejectedCandidates && report.rejectedCandidates.length > 0) {
+        console.log("Rejected by profile:");
+        for (const candidate of report.rejectedCandidates) {
+            console.log(`  [${candidate.source}] ${candidate.id}  "${candidate.title}"  ${candidate.license}`);
+            for (const reason of candidate.profile?.rejectionReasons ?? [])
+                console.log(`    rejects: ${reason}`);
+        }
+    }
+    if (report.deepLinks.length > 0) {
+        console.log("Marketplace deep-links (manual download, license check required):");
+        for (const link of report.deepLinks) {
+            console.log(`  ${link.id}  "${link.title}"  ${link.sourcePage ?? ""}`.trimEnd());
+        }
+    }
+    for (const warning of report.warnings)
+        console.error(`warning: ${warning}`);
+}
+//# sourceMappingURL=cli-options.js.map