@aura3d/cli 3.0.1 → 4.0.0

package/dist/look/judge.js

@@ -0,0 +1,151 @@
+/**
+ * PRD-13 T2.17 — `look judge` + `look rubric` command bodies.
+ * Registered as C-39 commands from commands/prd13/index.ts.
+ *
+ * `look judge --validate <file>` validates a LookJudgement and reports the
+ * per-category scores, weakest category and next-change hint.
+ * `--judge prism` delegates to C-32 judgeWithPrism when the provider ships it;
+ * while the export is absent the command exits 2 with `judge-unavailable`
+ * rather than fabricating a score (no new provider code here).
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { AGENT_LOOK_CATEGORIES, GENRE_RECIPE_ROWS, LOOK_JUDGEMENT_SCHEMA, lookHintFor, validateLookJudgement, weakestLookCategory } from "./rubric.js";
+function parseArgs(argv) {
+    const flags = new Map();
+    const switches = new Set();
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg.startsWith("--")) {
+            const next = argv[i + 1];
+            if (next !== undefined && !next.startsWith("--")) {
+                flags.set(arg.slice(2), next);
+                i += 1;
+            }
+            else {
+                switches.add(arg.slice(2));
+            }
+        }
+    }
+    return { flags, switches };
+}
+export async function runLookJudge(argv, io) {
+    const { flags, switches } = parseArgs(argv);
+    const judge = flags.get("judge") ?? "self";
+    const asJson = switches.has("json");
+    if (judge === "prism") {
+        // C-32 provider slot: tools/quality-gate exports judgeWithPrism when PRD 12
+        // lands the provider. Absent → exit 2 `judge-unavailable` (spec'd behaviour).
+        try {
+            const mod = (await import("../../../../tools/quality-gate/src/types.js"));
+            if (typeof mod.judgeWithPrism !== "function") {
+                io.stderr("judge-unavailable: C-32 judgeWithPrism is not exported by tools/quality-gate yet");
+                return 2;
+            }
+            // Provider path for when PRD 12 lands: delegate and pass through.
+            const result = await mod.judgeWithPrism({ argv, cwd: io.cwd });
+            io.stdout(asJson ? JSON.stringify(result, null, 2) : String(result));
+            return 0;
+        }
+        catch {
+            io.stderr("judge-unavailable: C-32 judgeWithPrism is not exported by tools/quality-gate yet");
+            return 2;
+        }
+    }
+    const validatePath = flags.get("validate");
+    if (!validatePath) {
+        io.stderr("look judge requires --validate <look-judgement.json>");
+        return 2;
+    }
+    const file = resolve(io.cwd, validatePath);
+    if (!existsSync(file)) {
+        io.stderr(`judgement file not found: ${file}`);
+        return 2;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(file, "utf8"));
+    }
+    catch {
+        io.stderr(`judgement file is not valid JSON: ${file}`);
+        return 2;
+    }
+    const validation = validateLookJudgement(parsed);
+    if (!validation.ok) {
+        for (const error of validation.errors)
+            io.stderr(`invalid judgement: ${error}`);
+        return 1;
+    }
+    const judgement = parsed;
+    const weakest = weakestLookCategory(judgement);
+    const hint = weakest ? lookHintFor(weakest) : undefined;
+    if (asJson) {
+        io.stdout(JSON.stringify({
+            ok: true,
+            schema: LOOK_JUDGEMENT_SCHEMA,
+            judge: judgement.judge,
+            round: judgement.round,
+            scores: judgement.scores,
+            weakestCategory: weakest ?? null,
+            hint: hint ?? null
+        }, null, 2));
+        return 0;
+    }
+    io.stdout(`judgement ${LOOK_JUDGEMENT_SCHEMA} round ${judgement.round} (${judgement.judge}) is valid`);
+    for (const category of AGENT_LOOK_CATEGORIES) {
+        const score = judgement.scores[category];
+        if (score !== undefined)
+            io.stdout(`  ${category}: ${score}`);
+    }
+    if (weakest) {
+        io.stdout(`weakest category: ${weakest}`);
+        io.stdout(`next change: ${hint.change}`);
+        io.stdout(`api: ${hint.api}`);
+    }
+    return 0;
+}
+export function runLookRubric(argv, io) {
+    const { flags, switches } = parseArgs(argv);
+    const genre = flags.get("genre");
+    const asJson = switches.has("json");
+    const rubric = {
+        schema: "aura3d.look-rubric/1",
+        categories: AGENT_LOOK_CATEGORIES,
+        judgementSchema: LOOK_JUDGEMENT_SCHEMA,
+        genre: genre ?? null,
+        recipe: genre ? GENRE_RECIPE_ROWS[genre] ?? null : null,
+        genres: Object.keys(GENRE_RECIPE_ROWS)
+    };
+    if (genre && !rubric.recipe) {
+        io.stderr(`unknown genre "${genre}"; genres: ${rubric.genres.join(", ")}`);
+        return 2;
+    }
+    if (asJson) {
+        io.stdout(JSON.stringify(rubric, null, 2));
+        return 0;
+    }
+    io.stdout("Agent look rubric (subset of the C-32 visual categories):");
+    for (const category of AGENT_LOOK_CATEGORIES)
+        io.stdout(`  - ${category}`);
+    io.stdout(`judgement schema: ${LOOK_JUDGEMENT_SCHEMA} (scores 0–10 in 0.5 steps; N/A omitted; >= 1 observation per score < 7)`);
+    if (genre && rubric.recipe) {
+        const row = rubric.recipe;
+        io.stdout(`genre ${genre}: look ${row.look} · ${row.camera} · subject ${row.subjectPercent}% · key ${row.keyLight} · palette ${row.palette} · atmosphere ${row.atmosphere} · post ${row.post}`);
+    }
+    return 0;
+}
+export const lookJudgeCommand = {
+    name: "look judge",
+    owner: "prd13",
+    summary: "Validate a LookJudgement, print scores, weakest category and next-change hint",
+    usage: "aura3d look judge --validate <look-judgement.json> [--judge self|prism] [--json]",
+    run: (argv, io) => runLookJudge(argv, io)
+};
+export const lookRubricCommand = {
+    name: "look rubric",
+    owner: "prd13",
+    summary: "Print the agent look rubric and (with --genre) the genre recipe row",
+    usage: "aura3d look rubric [--genre platformer|racing|...] [--json]",
+    run: async (argv, io) => runLookRubric(argv, io)
+};
+//# sourceMappingURL=judge.js.map

package/dist/look/judge.js.map

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

package/dist/look/lint-static.d.ts

@@ -0,0 +1,45 @@
+/**
+ * PRD-13 T2.18 — `look lint` command body + the `look-from-ambient` codemod.
+ * Registered as C-39 command `look lint` and codemod `look-from-ambient` from
+ * commands/prd13/index.ts.
+ *
+ * The command is a static TypeScript AST scan over src/** that flags the
+ * look-hostile constructs §11.5 lists, then runs every rule other lanes
+ * registered through C-39 `registerDoctorRule` (PRD 08 feel/evidence-only,
+ * PRD 09 look/capture-branch, ...). PRD 13's own default capture-branch rule
+ * covers `look/capture-branch` when PRD 09 has not registered one — it is
+ * implemented as a builtin AST rule, so a lane registering the same code later
+ * just adds (the C-39 duplicate guard keeps codes unique).
+ */
+import { type AuraCliCommand, type AuraCodemod, type AuraDoctorRule } from "../contracts/commands.js";
+export interface LookLintFinding {
+    readonly file: string;
+    readonly line: number;
+    readonly rule: string;
+    readonly severity: "error" | "warning";
+    readonly message: string;
+}
+export interface LookLintReport {
+    readonly ok: boolean;
+    readonly scannedFiles: number;
+    readonly findings: readonly LookLintFinding[];
+    readonly errors: number;
+    readonly warnings: number;
+    readonly doctorRules: readonly string[];
+}
+export declare function lookLintFiles(cwd: string): readonly {
+    readonly path: string;
+    readonly text: string;
+}[];
+export declare function runLookLintScan(cwd: string): LookLintReport;
+export declare function runLookLint(argv: readonly string[], io: {
+    readonly cwd: string;
+    stdout(s: string): void;
+    stderr(s: string): void;
+}): Promise<number>;
+export declare const lookLintCommand: AuraCliCommand;
+export declare const lookFromAmbientCodemod: AuraCodemod;
+/** Default PRD-13 capture-branch doctor rule — registered only when no lane
+ *  already registered `look/capture-branch` (PRD 09 owns that code when it lands). */
+export declare const defaultCaptureBranchRule: AuraDoctorRule;
+//# sourceMappingURL=lint-static.d.ts.map

package/dist/look/lint-static.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-static.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/look/lint-static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAkB,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAEtH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAgID,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAEtG;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAmB3D;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAa1J;AAED,eAAO,MAAM,eAAe,EAAE,cAM7B,CAAC;AAOF,eAAO,MAAM,sBAAsB,EAAE,WAuCpC,CAAC;AAEF;sFACsF;AACtF,eAAO,MAAM,wBAAwB,EAAE,cAatC,CAAC"}

package/dist/look/lint-static.js

@@ -0,0 +1,241 @@
+/**
+ * PRD-13 T2.18 — `look lint` command body + the `look-from-ambient` codemod.
+ * Registered as C-39 command `look lint` and codemod `look-from-ambient` from
+ * commands/prd13/index.ts.
+ *
+ * The command is a static TypeScript AST scan over src/** that flags the
+ * look-hostile constructs §11.5 lists, then runs every rule other lanes
+ * registered through C-39 `registerDoctorRule` (PRD 08 feel/evidence-only,
+ * PRD 09 look/capture-branch, ...). PRD 13's own default capture-branch rule
+ * covers `look/capture-branch` when PRD 09 has not registered one — it is
+ * implemented as a builtin AST rule, so a lane registering the same code later
+ * just adds (the C-39 duplicate guard keeps codes unique).
+ */
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join, relative, resolve } from "node:path";
+import * as ts from "typescript";
+import { doctorRulesAll } from "../contracts/commands.js";
+// ---------------------------------------------------------------------------
+// Source collection
+function listSourceFiles(cwd) {
+    const root = resolve(cwd, "src");
+    if (!existsSync(root))
+        return [];
+    const out = [];
+    const visit = (dir) => {
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            const path = join(dir, entry.name);
+            if (entry.isDirectory())
+                visit(path);
+            else if (/\.(ts|tsx|mts)$/.test(entry.name))
+                out.push(path);
+        }
+    };
+    visit(root);
+    return out.sort();
+}
+// ---------------------------------------------------------------------------
+// AST helpers
+function lineOf(sourceFile, node) {
+    return sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile)).line + 1;
+}
+function callExpressionName(node) {
+    if (!ts.isCallExpression(node))
+        return undefined;
+    const expr = node.expression;
+    if (ts.isPropertyAccessExpression(expr)) {
+        const left = callExpressionRootName(expr.expression);
+        return left ? `${left}.${expr.name.text}` : expr.name.text;
+    }
+    if (ts.isIdentifier(expr))
+        return expr.text;
+    return undefined;
+}
+function callExpressionRootName(expr) {
+    if (ts.isIdentifier(expr))
+        return expr.text;
+    if (ts.isPropertyAccessExpression(expr)) {
+        const base = callExpressionRootName(expr.expression);
+        return base ? `${base}.${expr.name.text}` : undefined;
+    }
+    if (ts.isCallExpression(expr))
+        return callExpressionRootName(expr.expression);
+    return undefined;
+}
+/** Evidence-style property names whose `true` literal is a frozen claim. */
+const EVIDENCE_TRUE_KEY = /(?:Aligned|InFrame|Framed|Applied|Reached|Visible|Grounded|Anchored|OnTrack|OnFloor|Clamped|Ready|Loaded|Enabled|Attached|Collected|Completed)(?:[A-Z][\w]*)*$/;
+/** Overlay/debug-ish defaults that must not ship in a captured frame. */
+const OVERLAY_TRUE_KEY = /^(?:debug|overlay|showOverlay|showHud|hud|stats|showStats|helpers|showHelpers|showGrid|grid|showAxes|axes|wireframe|showBounds)$/;
+function collectFileFacts(sourceFile) {
+    let usesEnvironment = false;
+    let usesLooks = false;
+    const visit = (node) => {
+        const name = callExpressionName(node);
+        if (name?.startsWith("environments."))
+            usesEnvironment = true;
+        if (name === "looks.preset" || name === "looks.nodes" || name === "scene.look")
+            usesLooks = true;
+        ts.forEachChild(node, visit);
+    };
+    visit(sourceFile);
+    return { usesEnvironment, usesLooks };
+}
+function scanFile(path, relativeFile, source) {
+    const sourceFile = ts.createSourceFile(relativeFile, source, ts.ScriptTarget.Latest, true);
+    const facts = collectFileFacts(sourceFile);
+    const findings = [];
+    const hasEnv = facts.usesEnvironment || facts.usesLooks; // a look supplies its own env
+    const push = (node, rule, severity, message) => {
+        findings.push({ file: relativeFile, line: lineOf(sourceFile, node), rule, severity, message });
+    };
+    const visit = (node) => {
+        // lights.ambient(...) with no env/look in the same scene flattens shading.
+        if (callExpressionName(node) === "lights.ambient" && !hasEnv) {
+            push(node, "look/ambient-without-env", "error", "lights.ambient() with no environment or look in this file — pick a look (looks.preset) instead of bare ambient fill");
+        }
+        // lean imports bypass the look pipeline entirely.
+        if (ts.isImportDeclaration(node) && ts.isStringLiteral(node.moduleSpecifier) && node.moduleSpecifier.text.startsWith("@aura3d/lean")) {
+            push(node, "look/lean-import", "error", `import from ${node.moduleSpecifier.text} bypasses looks — use @aura3d/engine with looks.preset`);
+        }
+        // renderer overrides fight the look's own render config.
+        if (ts.isPropertyAccessExpression(node) && ts.isIdentifier(node.expression) && node.expression.text === "renderer") {
+            const prop = node.name.text;
+            if (prop === "toneMapping" || prop === "toneMappingExposure" || prop === "outputColorSpace" || prop === "setPixelRatio") {
+                push(node, "look/renderer-override", "error", `renderer.${prop} overrides the look's render config — set it through the look instead`);
+            }
+        }
+        // capture branches: behaviour keyed on capture/screenshot URL params.
+        if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression)) {
+            const callee = callExpressionName(node) ?? "";
+            if (/\.get$/.test(callee) && node.arguments.length > 0 && ts.isStringLiteral(node.arguments[0])) {
+                const param = node.arguments[0].text;
+                if (param === "capture" || param === "screenshot" || param === "snapshot" || param === "lookdev") {
+                    push(node, "look/capture-branch", "error", `code branches on the "${param}" URL param — one code path; captures observe it`);
+                }
+            }
+        }
+        if (ts.isStringLiteral(node) && /\bcapture\b|\bscreenshot\b|\bsnapshot\b|\blookdev\b/.test(node.text) && node.text.includes("=")) {
+            push(node, "look/capture-branch", "warning", `URL fragment "${node.text}" may carry a capture flag`);
+        }
+        // `x: true` evidence/overlay literals.
+        if (ts.isPropertyAssignment(node) && node.initializer.kind === ts.SyntaxKind.TrueKeyword && ts.isIdentifier(node.name)) {
+            const key = node.name.text;
+            if (OVERLAY_TRUE_KEY.test(key)) {
+                push(node, "look/overlay-default", "error", `${key}: true ships an overlay/debug element — remove it or default false`);
+            }
+            else if (EVIDENCE_TRUE_KEY.test(key)) {
+                push(node, "look/evidence-constant", "warning", `${key}: true is a constant evidence claim — compute it from the real state`);
+            }
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sourceFile);
+    return findings;
+}
+// ---------------------------------------------------------------------------
+// Command
+export function lookLintFiles(cwd) {
+    return listSourceFiles(cwd).map((path) => ({ path, text: readFileSync(path, "utf8") }));
+}
+export function runLookLintScan(cwd) {
+    const files = lookLintFiles(cwd);
+    const findings = [];
+    for (const file of files) {
+        findings.push(...scanFile(file.path, relative(cwd, file.path), file.text));
+    }
+    // C-39 doctor rules from every lane run over the same files.
+    const doctorCodes = [];
+    for (const rule of doctorRulesAll()) {
+        doctorCodes.push(rule.code);
+        for (const file of files) {
+            for (const hit of rule.check({ path: relative(cwd, file.path), text: file.text })) {
+                findings.push({ file: relative(cwd, file.path), line: hit.line, rule: rule.code, severity: hit.severity, message: hit.message });
+            }
+        }
+    }
+    const errors = findings.filter((f) => f.severity === "error").length;
+    const warnings = findings.length - errors;
+    return { ok: errors === 0, scannedFiles: files.length, findings, errors, warnings, doctorRules: doctorCodes };
+}
+export async function runLookLint(argv, io) {
+    const switches = new Set(argv.filter((a) => a.startsWith("--")));
+    const report = runLookLintScan(io.cwd);
+    if (switches.has("--json")) {
+        io.stdout(JSON.stringify(report, null, 2));
+    }
+    else {
+        io.stdout(`look lint scanned ${report.scannedFiles} files under src/ (doctor rules: ${report.doctorRules.join(", ") || "none registered"})`);
+        for (const finding of report.findings) {
+            io.stdout(`  ${finding.severity} ${finding.file}:${finding.line} [${finding.rule}] ${finding.message}`);
+        }
+        io.stdout(`${report.errors} errors, ${report.warnings} warnings`);
+    }
+    return report.ok ? 0 : 1;
+}
+export const lookLintCommand = {
+    name: "look lint",
+    owner: "prd13",
+    summary: "Static look-lint over src/** (AST) plus every C-39 registerDoctorRule rule",
+    usage: "aura3d look lint [--json]",
+    run: (argv, io) => runLookLint(argv, io)
+};
+// ---------------------------------------------------------------------------
+// look-from-ambient codemod (§11.5)
+const DEFAULT_LOOK_ID = "outdoor-day";
+export const lookFromAmbientCodemod = {
+    name: "look-from-ambient",
+    owner: "prd13",
+    description: "Replace bare lights.ambient() (no env/look in file) with looks.preset + TODO; drop renderer qualityProfile 'safe-basic'; move report.visualSystems consumers to report.appliedEffects",
+    transform(source, fileName) {
+        const sourceFile = ts.createSourceFile(fileName, source, ts.ScriptTarget.Latest, true);
+        const facts = collectFileFacts(sourceFile);
+        const rows = [];
+        const edits = [];
+        const visit = (node) => {
+            // lights.ambient(...) with no env node in the same scene → look preset + TODO.
+            if (ts.isCallExpression(node) && callExpressionName(node) === "lights.ambient" && !facts.usesEnvironment && !facts.usesLooks) {
+                edits.push({ start: node.getStart(sourceFile), end: node.getEnd(), text: `looks.preset("${DEFAULT_LOOK_ID}") /* TODO: pick the scene's genre look — see aura3d look rubric */` });
+                rows.push({ file: fileName, line: lineOf(sourceFile, node), construct: "lights.ambient", mapping: "approximate", target: `looks.preset("${DEFAULT_LOOK_ID}")`, note: "ambient light replaced by a look; confirm the genre look id" });
+            }
+            // renderer.qualityProfile: "safe-basic" → property removed.
+            if (ts.isPropertyAssignment(node) && ts.isIdentifier(node.name) && node.name.text === "qualityProfile" && ts.isStringLiteral(node.initializer) && node.initializer.text === "safe-basic") {
+                // Remove the property including a trailing comma when present.
+                let end = node.getEnd();
+                while (end < source.length && /\s/.test(source[end]))
+                    end += 1;
+                if (source[end] === ",")
+                    end += 1;
+                edits.push({ start: node.getStart(sourceFile), end, text: "" });
+                rows.push({ file: fileName, line: lineOf(sourceFile, node), construct: 'renderer.qualityProfile: "safe-basic"', mapping: "exact", note: "safe-basic removed; the look sets the render profile" });
+            }
+            // report.visualSystems → report.appliedEffects (V2 consumers).
+            if (ts.isPropertyAccessExpression(node) && node.name.text === "visualSystems") {
+                edits.push({ start: node.name.getStart(sourceFile), end: node.name.getEnd(), text: "appliedEffects" });
+                rows.push({ file: fileName, line: lineOf(sourceFile, node), construct: ".visualSystems", mapping: "approximate", target: ".appliedEffects", note: "apply when the consumer moves to compilePromptPlanV2" });
+            }
+            ts.forEachChild(node, visit);
+        };
+        visit(sourceFile);
+        const code = edits
+            .sort((a, b) => b.start - a.start)
+            .reduce((text, edit) => `${text.slice(0, edit.start)}${edit.text}${text.slice(edit.end)}`, source);
+        return { code, rows };
+    }
+};
+/** Default PRD-13 capture-branch doctor rule — registered only when no lane
+ *  already registered `look/capture-branch` (PRD 09 owns that code when it lands). */
+export const defaultCaptureBranchRule = {
+    code: "look/capture-branch",
+    owner: "prd13",
+    check(file) {
+        const hits = [];
+        const lines = file.text.split("\n");
+        for (const [index, line] of lines.entries()) {
+            if (/searchParams\.get\(["'](?:capture|screenshot|snapshot|lookdev)["']\)/.test(line) || /[?&](?:capture|screenshot|snapshot|lookdev)=/.test(line)) {
+                hits.push({ line: index + 1, message: "behaviour branches on a capture/screenshot URL param — one code path; captures observe it", severity: "error" });
+            }
+        }
+        return hits;
+    }
+};
+//# sourceMappingURL=lint-static.js.map

package/dist/look/lint-static.js.map

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

package/dist/look/rubric.d.ts

@@ -0,0 +1,70 @@
+/**
+ * PRD-13 §7.6 — `look rubric` / `look judge` data model.
+ *
+ * AGENT_LOOK_CATEGORIES is the 12-category agent judging rubric: the subset of
+ * C-32 GAME_VISUAL_CATEGORIES an agent can move from code (the full list also
+ * covers sound, controls, physics feel, ... that screenshots cannot prove).
+ * The ⊆ assertion lives in tests/unit/cli/look-judge.test.ts.
+ *
+ * CATEGORY_HINTS is the next-change hint table the judge reports: keyed by the
+ * weakest rubric category, it names the concrete @aura3d/engine API to touch —
+ * drawn from aura3d-art-direction/references/look-recipes.md and the lookLint
+ * rule inventory. Keep entries in terms of real exported APIs only.
+ */
+export declare const AGENT_LOOK_CATEGORIES: readonly ["lighting", "shadows", "ibl_reflections", "environment_world", "atmospheric_effects", "material_quality", "modeling_assets", "composition", "camera", "postprocessing", "animation_quality", "ui_hud"];
+export type AgentLookCategory = (typeof AGENT_LOOK_CATEGORIES)[number];
+export declare const LOOK_JUDGEMENT_SCHEMA: "aura3d.look-judgement/1";
+export interface LookJudgement {
+    readonly schema: typeof LOOK_JUDGEMENT_SCHEMA;
+    readonly round: number;
+    readonly shots: readonly {
+        readonly path: string;
+        readonly sha256: string;
+    }[];
+    readonly references: readonly string[];
+    readonly scores: Readonly<Partial<Record<AgentLookCategory, number>>>;
+    readonly observations: readonly {
+        readonly category: string;
+        readonly seen: string;
+    }[];
+    readonly nextChange: {
+        readonly category: string;
+        readonly change: string;
+        readonly api: string;
+    };
+    readonly judge: "self" | "prism";
+}
+/** Genre → recipe row (condensed from look-recipes.md; the doc is the narrative). */
+export declare const GENRE_RECIPE_ROWS: Readonly<Record<string, {
+    readonly look: string;
+    readonly camera: string;
+    readonly subjectPercent: string;
+    readonly keyLight: string;
+    readonly palette: string;
+    readonly atmosphere: string;
+    readonly post: string;
+}>>;
+export interface LookHint {
+    readonly category: string;
+    readonly change: string;
+    readonly api: string;
+}
+/**
+ * Weakest-category → concrete next change. APIs are restricted to the public
+ * @aura3d/engine surface (looks.preset overrides, environments.*, lights.*,
+ * camera.*, effects/post ids) so the hint is always actionable.
+ */
+export declare const CATEGORY_HINTS: Readonly<Record<string, LookHint>>;
+/** Lint-code → hint prefix so judge output ties a weak category to the failing rule. */
+export declare const LINT_CODE_HINTS: Readonly<Record<string, {
+    readonly change: string;
+    readonly api: string;
+}>>;
+export declare function lookHintFor(category: string, lintCodes?: readonly string[]): LookHint;
+export interface LookJudgementValidation {
+    readonly ok: boolean;
+    readonly errors: readonly string[];
+}
+export declare function validateLookJudgement(value: unknown): LookJudgementValidation;
+export declare function weakestLookCategory(judgement: LookJudgement): AgentLookCategory | undefined;
+//# sourceMappingURL=rubric.d.ts.map

package/dist/look/rubric.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rubric.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/look/rubric.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,qBAAqB,kNAIxB,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,eAAO,MAAM,qBAAqB,EAAG,yBAAkC,CAAC;AAExE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,qBAAqB,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9E,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACtE,QAAQ,CAAC,YAAY,EAAE,SAAS;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvF,QAAQ,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAClG,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAClC;AAED,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzG,CAAC,CAcD,CAAC;AAEF,MAAM,WAAW,QAAQ;IAAG,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE;AAEtG;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAa7D,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBvG,CAAC;AAEF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,SAAS,MAAM,EAAO,GAAG,QAAQ,CASzF;AAKD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAID,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CAyD7E;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,aAAa,GAAG,iBAAiB,GAAG,SAAS,CAU3F"}