@aura3d/cli 3.0.1 → 4.0.0

package/dist/library-manifest.d.ts

@@ -0,0 +1,86 @@
+import type { AuraLibraryEntryShape, AuraLibraryManifestShape } from "@aura3d/asset-index";
+import type { AuraCliAssetEntry } from "./asset-core-types.js";
+/**
+ * PRD-05 §6.6 curated library.
+ *
+ * `aura.library.json` at the project root declares kits (the §6.6 table:
+ * characters/humanoid-pbr, vehicles/road, hdri, …) and entries. Each entry is
+ * an admitted asset whose bytes live under `assets/library/<kit>/`; a library
+ * member outranks every remote candidate in `assets search`/`resolve` (the
+ * `library` membership + `lookDevApproved` + `artDirection` terms in
+ * scoring.ts) and resolves by local copy instead of a network pull.
+ */
+export declare const LIBRARY_SCHEMA = "aura3d.library/1.0";
+export declare const LIBRARY_MANIFEST_FILE = "aura.library.json";
+export declare const LIBRARY_DIR = "assets/library";
+export interface AuraLibraryKit {
+    readonly id: string;
+    readonly artDirection?: string;
+    /** Human description of the kit contract (the §6.6 table row). */
+    readonly contents?: string;
+    readonly consumers?: readonly string[];
+}
+/**
+ * Library entry: the manifest-1.1 fields curated intake needs plus the
+ * adapter-facing shape (`AuraLibraryEntryShape`) it must satisfy. Kept as a
+ * standalone interface — `AuraCliAssetEntry` and the adapter shape disagree
+ * on a few field types, and satisfying both structurally is enough.
+ */
+export interface AuraLibraryEntry extends AuraLibraryEntryShape {
+    readonly kit: string;
+    readonly sha256?: string;
+    readonly url?: string;
+    readonly hash?: string;
+    readonly outputPath?: string;
+    readonly role?: AuraCliAssetEntry["role"];
+    readonly quality?: AuraCliAssetEntry["quality"];
+    readonly admission?: AuraCliAssetEntry["admission"];
+    readonly lookDev?: AuraCliAssetEntry["lookDev"];
+    readonly derived?: AuraCliAssetEntry["derived"];
+    readonly provenance?: AuraCliAssetEntry["provenance"];
+    readonly gameplayCamera?: AuraCliAssetEntry["gameplayCamera"];
+    /** §6.7 HDRI environment entries: dominant-light direction (unit, equirect centroid of p99.9 luminance). */
+    readonly sunDirection?: readonly [number, number, number];
+    /** §6.7 HDRI: 99th-percentile relative luminance. */
+    readonly luminanceP99?: number;
+    /** §6.7 HDRI: estimated scene white balance (McCamy CCT). */
+    readonly whiteBalanceK?: number;
+    /**
+     * §6.6 intake record: the §6.2 optimize profile this entry is admitted under
+     * and where it stands (`pending` = optimize not yet run; `done` = derived
+     * written; `not-needed` = non-model formats like .hdr/.zip texture sets).
+     */
+    readonly optimizePlan?: {
+        readonly profile?: string;
+        readonly state: "pending" | "done" | "not-needed";
+        readonly notes?: string;
+    };
+}
+export interface AuraLibraryManifest extends AuraLibraryManifestShape {
+    readonly kits: readonly AuraLibraryKit[];
+    readonly entries: readonly AuraLibraryEntry[];
+}
+export declare function libraryManifestPath(projectDir: string): string;
+export declare function readAuraLibrary(projectDir: string): AuraLibraryManifest | undefined;
+export declare function writeAuraLibrary(projectDir: string, manifest: AuraLibraryManifest): void;
+export interface LibraryAddOptions {
+    readonly projectDir: string;
+    readonly kit: string;
+    readonly entryId: string;
+    readonly sourceFile: string;
+    readonly entry: Omit<AuraLibraryEntry, "id" | "kit" | "libraryPath">;
+    /** Absolute target dir override (defaults to assets/library/<kit>/). */
+    readonly targetDir?: string;
+}
+export declare function addLibraryEntry(options: LibraryAddOptions): AuraLibraryEntry;
+export interface LibrarySyncIssue {
+    readonly entryId: string;
+    readonly kit: string;
+    readonly issue: string;
+}
+/** Verify every entry's bytes exist and hash-match; returns the issue list (empty = clean). */
+export declare function syncAuraLibrary(projectDir: string): {
+    readonly manifest: AuraLibraryManifest;
+    readonly issues: readonly LibrarySyncIssue[];
+};
+//# sourceMappingURL=library-manifest.d.ts.map

package/dist/library-manifest.d.ts.map

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

package/dist/library-manifest.js

@@ -0,0 +1,95 @@
+import { createHash } from "node:crypto";
+import { copyFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync, } from "node:fs";
+import { extname, join, resolve } from "node:path";
+/**
+ * PRD-05 §6.6 curated library.
+ *
+ * `aura.library.json` at the project root declares kits (the §6.6 table:
+ * characters/humanoid-pbr, vehicles/road, hdri, …) and entries. Each entry is
+ * an admitted asset whose bytes live under `assets/library/<kit>/`; a library
+ * member outranks every remote candidate in `assets search`/`resolve` (the
+ * `library` membership + `lookDevApproved` + `artDirection` terms in
+ * scoring.ts) and resolves by local copy instead of a network pull.
+ */
+export const LIBRARY_SCHEMA = "aura3d.library/1.0";
+export const LIBRARY_MANIFEST_FILE = "aura.library.json";
+export const LIBRARY_DIR = "assets/library";
+export function libraryManifestPath(projectDir) {
+    return join(projectDir, LIBRARY_MANIFEST_FILE);
+}
+export function readAuraLibrary(projectDir) {
+    const path = libraryManifestPath(projectDir);
+    if (!existsSync(path))
+        return undefined;
+    const parsed = JSON.parse(readFileSync(path, "utf8"));
+    if (parsed.schema !== LIBRARY_SCHEMA) {
+        throw new Error(`aura.library.json: unsupported schema "${parsed.schema}" (expected ${LIBRARY_SCHEMA})`);
+    }
+    return parsed;
+}
+export function writeAuraLibrary(projectDir, manifest) {
+    const path = libraryManifestPath(projectDir);
+    const out = {
+        ...manifest,
+        schema: LIBRARY_SCHEMA,
+        kits: [...manifest.kits],
+        entries: [...manifest.entries],
+    };
+    writeFileSync(path, `${JSON.stringify(out, null, 2)}\n`);
+}
+export function addLibraryEntry(options) {
+    const manifest = readAuraLibrary(options.projectDir) ?? {
+        schema: LIBRARY_SCHEMA,
+        kits: [],
+        entries: [],
+    };
+    const kit = manifest.kits.find((k) => k.id === options.kit);
+    if (!kit) {
+        throw new Error(`aura.library.json has no kit "${options.kit}" — declare it in kits[] first (§6.6 table).`);
+    }
+    if (manifest.entries.some((e) => e.kit === options.kit && e.id === options.entryId)) {
+        throw new Error(`library entry "${options.entryId}" already exists in kit "${options.kit}"`);
+    }
+    const ext = extname(options.sourceFile);
+    const targetDir = options.targetDir ?? join(options.projectDir, LIBRARY_DIR, options.kit);
+    mkdirSync(targetDir, { recursive: true });
+    const fileName = `${options.entryId}${ext}`;
+    const dest = join(targetDir, fileName);
+    copyFileSync(resolve(options.sourceFile), dest);
+    const libraryPath = `${LIBRARY_DIR}/${options.kit}/${fileName}`;
+    const bytes = statSync(dest).size;
+    const sha256 = createHash("sha256").update(readFileSync(dest)).digest("hex");
+    const entry = {
+        ...options.entry,
+        id: options.entryId,
+        kit: options.kit,
+        libraryPath,
+        sizeBytes: bytes,
+        sha256,
+    };
+    writeAuraLibrary(options.projectDir, {
+        ...manifest,
+        entries: [...manifest.entries, entry],
+    });
+    return entry;
+}
+/** Verify every entry's bytes exist and hash-match; returns the issue list (empty = clean). */
+export function syncAuraLibrary(projectDir) {
+    const manifest = readAuraLibrary(projectDir);
+    if (!manifest)
+        throw new Error(`no ${LIBRARY_MANIFEST_FILE} found under ${projectDir}`);
+    const issues = [];
+    for (const entry of manifest.entries) {
+        const file = join(projectDir, entry.libraryPath);
+        if (!existsSync(file)) {
+            issues.push({ entryId: entry.id, kit: entry.kit, issue: `missing file ${entry.libraryPath}` });
+            continue;
+        }
+        const sha = createHash("sha256").update(readFileSync(file)).digest("hex");
+        if (entry.sha256 && sha !== entry.sha256) {
+            issues.push({ entryId: entry.id, kit: entry.kit, issue: `sha256 drift: manifest ${entry.sha256.slice(0, 12)}… vs file ${sha.slice(0, 12)}…` });
+        }
+    }
+    return { manifest, issues };
+}
+//# sourceMappingURL=library-manifest.js.map

package/dist/library-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"library-manifest.js","sourceRoot":"","sources":["../../../../packages/aura3d-cli/src/library-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,YAAY,EACZ,UAAU,EACV,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAInD;;;;;;;;;GASG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,oBAAoB,CAAC;AACnD,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,CAAC;AACzD,MAAM,CAAC,MAAM,WAAW,GAAG,gBAAgB,CAAC;AAoD5C,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,OAAO,IAAI,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,UAAkB;IAChD,MAAM,IAAI,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAwB,CAAC;IAC7E,IAAI,MAAM,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,0CAA0C,MAAM,CAAC,MAAM,eAAe,cAAc,GAAG,CAAC,CAAC;IAC3G,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAkB,EAAE,QAA6B;IAChF,MAAM,IAAI,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG;QACV,GAAG,QAAQ;QACX,MAAM,EAAE,cAAc;QACtB,IAAI,EAAE,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC;QACxB,OAAO,EAAE,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC;KAC/B,CAAC;IACF,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC;AAYD,MAAM,UAAU,eAAe,CAAC,OAA0B;IACxD,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI;QACtD,MAAM,EAAE,cAAc;QACtB,IAAI,EAAE,EAAE;QACR,OAAO,EAAE,EAAE;KACZ,CAAC;IACF,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5D,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,iCAAiC,OAAO,CAAC,GAAG,8CAA8C,CAC3F,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACpF,MAAM,IAAI,KAAK,CAAC,kBAAkB,OAAO,CAAC,OAAO,4BAA4B,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1F,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,GAAG,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACvC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,IAAI,QAAQ,EAAE,CAAC;IAChE,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;IAClC,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7E,MAAM,KAAK,GAAqB;QAC9B,GAAG,OAAO,CAAC,KAAK;QAChB,EAAE,EAAE,OAAO,CAAC,OAAO;QACnB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,WAAW;QACX,SAAS,EAAE,KAAK;QAChB,MAAM;KACP,CAAC;IACF,gBAAgB,CAAC,OAAO,CAAC,UAAU,EAAE;QACnC,GAAG,QAAQ;QACX,OAAO,EAAE,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;KACtC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAQD,+FAA+F;AAC/F,MAAM,UAAU,eAAe,CAAC,UAAkB;IAChD,MAAM,QAAQ,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,MAAM,qBAAqB,gBAAgB,UAAU,EAAE,CAAC,CAAC;IACxF,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QACjD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,gBAAgB,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAC/F,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1E,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,0BAA0B,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QACjJ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC"}

package/dist/look/capture.d.ts

@@ -0,0 +1,51 @@
+/**
+ * PRD-13 T2.16 — `look capture` command body.
+ * Registered as C-39 command `look capture` from commands/prd13/index.ts.
+ *
+ * `--runner gh-actions` (default): dispatches the scaffolded project's own
+ * `.github/workflows/aura3d-lookdev.yml` through the user's `gh` CLI auth —
+ * the command never sets or reads tokens itself — polls the run, then
+ * downloads the `lookdev` artifact into `--out` (default dist/lookdev/<round>).
+ *
+ * `--runner local`: runs the project's Playwright screenshot spec directly.
+ * Available only where the local environment permits it (Playwright package
+ * installed); the lane-wide remote-execution rule makes gh-actions the
+ * supported path on Devin/CI machines.
+ *
+ * Always exits 0 on a completed capture even when lint findings exist —
+ * lint.json is evidence, not a gate (the judge consumes it).
+ */
+import type { AuraCliCommand } from "../contracts/commands.js";
+export interface LookCaptureDeps {
+    /** Injected process runner (tests mock it); default spawns real commands. */
+    readonly exec?: (command: string, args: readonly string[], cwd: string) => {
+        readonly status: number;
+        readonly stdout: string;
+        readonly stderr: string;
+    };
+    /** Poll delay between gh run status checks (ms); tests pass 0. */
+    readonly pollMs?: number;
+    /** Max polls before giving up on a dispatched run. */
+    readonly maxPolls?: number;
+    /** Sleep implementation (tests inject a no-op). */
+    readonly sleep?: (ms: number) => void;
+}
+export interface LookCaptureResult {
+    readonly ok: boolean;
+    readonly runner: "gh-actions" | "local";
+    readonly outDir: string;
+    readonly pngs: readonly string[];
+    readonly appliedLookPath?: string;
+    readonly lintPath?: string;
+    readonly lintErrors: number;
+    readonly error?: string;
+}
+/** Next free round number under <cwd>/dist/lookdev/. */
+export declare function nextLookdevRound(cwd: string): number;
+export declare function runLookCapture(argv: readonly string[], io: {
+    readonly cwd: string;
+    stdout(s: string): void;
+    stderr(s: string): void;
+}, deps?: LookCaptureDeps): Promise<number>;
+export declare const lookCaptureCommand: AuraCliCommand;
+//# sourceMappingURL=capture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/look/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACzJ,kEAAkE;IAClE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AA8BD,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOpD;AAqDD,wBAAsB,cAAc,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,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsGzL;AAED,eAAO,MAAM,kBAAkB,EAAE,cAMhC,CAAC"}

package/dist/look/capture.js

@@ -0,0 +1,229 @@
+/**
+ * PRD-13 T2.16 — `look capture` command body.
+ * Registered as C-39 command `look capture` from commands/prd13/index.ts.
+ *
+ * `--runner gh-actions` (default): dispatches the scaffolded project's own
+ * `.github/workflows/aura3d-lookdev.yml` through the user's `gh` CLI auth —
+ * the command never sets or reads tokens itself — polls the run, then
+ * downloads the `lookdev` artifact into `--out` (default dist/lookdev/<round>).
+ *
+ * `--runner local`: runs the project's Playwright screenshot spec directly.
+ * Available only where the local environment permits it (Playwright package
+ * installed); the lane-wide remote-execution rule makes gh-actions the
+ * supported path on Devin/CI machines.
+ *
+ * Always exits 0 on a completed capture even when lint findings exist —
+ * lint.json is evidence, not a gate (the judge consumes it).
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import { join, resolve } from "node:path";
+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 };
+}
+function defaultExec(command, args, cwd) {
+    const result = spawnSync(command, [...args], { cwd, encoding: "utf8", shell: process.platform === "win32" });
+    return { status: result.status ?? 1, stdout: String(result.stdout ?? ""), stderr: String(result.stderr ?? "") };
+}
+/** Next free round number under <cwd>/dist/lookdev/. */
+export function nextLookdevRound(cwd) {
+    const root = resolve(cwd, "dist/lookdev");
+    if (!existsSync(root))
+        return 1;
+    const rounds = readdirSync(root, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory() && /^\d+$/.test(entry.name))
+        .map((entry) => Number(entry.name));
+    return rounds.length === 0 ? 1 : Math.max(...rounds) + 1;
+}
+/** Collect .png files anywhere under dir (artifacts may nest). */
+function collectPngs(dir) {
+    const out = [];
+    const visit = (d) => {
+        for (const entry of readdirSync(d, { withFileTypes: true })) {
+            const path = join(d, entry.name);
+            if (entry.isDirectory())
+                visit(path);
+            else if (entry.name.endsWith(".png"))
+                out.push(path);
+        }
+    };
+    if (existsSync(dir))
+        visit(dir);
+    return out.sort();
+}
+/**
+ * Emit appliedLook.json + lint.json next to the captures. Sources, in order:
+ * tests/reports/screenshot.json profile fields (the T3.12 screenshot spec
+ * writes lint findings into the report), then any lint.json/appLook.json the
+ * artifact already carried.
+ */
+function emitLookReports(outDir) {
+    let appliedLook;
+    let lint;
+    const screenshotJson = join(outDir, "screenshot.json");
+    if (existsSync(screenshotJson)) {
+        try {
+            const report = JSON.parse(readFileSync(screenshotJson, "utf8"));
+            const profile = report.profile ?? {};
+            appliedLook = profile.appliedLook ?? profile.look;
+            lint = profile.lint;
+        }
+        catch { /* tolerate malformed report; emit empty files below */ }
+    }
+    for (const name of ["appliedLook.json", "applied-look.json"]) {
+        const candidate = join(outDir, name);
+        if (appliedLook === undefined && existsSync(candidate)) {
+            try {
+                appliedLook = JSON.parse(readFileSync(candidate, "utf8"));
+            }
+            catch { /* ignore */ }
+        }
+    }
+    const lintCandidate = join(outDir, "lint.json");
+    if (lint === undefined && existsSync(lintCandidate)) {
+        try {
+            lint = JSON.parse(readFileSync(lintCandidate, "utf8"));
+        }
+        catch { /* ignore */ }
+    }
+    const appliedLookPath = join(outDir, "appliedLook.json");
+    writeFileSync(appliedLookPath, `${JSON.stringify(appliedLook ?? {}, null, 2)}\n`);
+    const lintPath = join(outDir, "lint.json");
+    writeFileSync(lintPath, `${JSON.stringify(lint ?? { findings: [] }, null, 2)}\n`);
+    const findings = lint?.findings ?? [];
+    const lintErrors = findings.filter((finding) => finding.severity === "error").length;
+    return { appliedLookPath, lintPath, lintErrors };
+}
+export async function runLookCapture(argv, io, deps = {}) {
+    const { flags, switches } = parseArgs(argv);
+    const asJson = switches.has("json");
+    const runner = flags.get("runner") ?? "gh-actions";
+    if (runner !== "gh-actions" && runner !== "local") {
+        io.stderr(`unknown --runner "${runner}"; use gh-actions or local`);
+        return 2;
+    }
+    const exec = deps.exec ?? defaultExec;
+    const sleepBuffer = new Int32Array(new SharedArrayBuffer(4));
+    const sleep = deps.sleep ?? ((ms) => Atomics.wait(sleepBuffer, 0, 0, ms));
+    const pollMs = deps.pollMs ?? 5000;
+    const maxPolls = deps.maxPolls ?? 120;
+    const outDir = resolve(io.cwd, flags.get("out") ?? `dist/lookdev/${nextLookdevRound(io.cwd)}`);
+    mkdirSync(outDir, { recursive: true });
+    const shots = flags.get("shots");
+    const viewports = flags.get("viewports");
+    const finish = (result) => {
+        if (asJson) {
+            io.stdout(JSON.stringify(result, null, 2));
+        }
+        else {
+            if (!result.ok)
+                io.stderr(result.error ?? "capture failed");
+            for (const png of result.pngs)
+                io.stdout(`png: ${png}`);
+            if (result.appliedLookPath)
+                io.stdout(`appliedLook: ${result.appliedLookPath}`);
+            if (result.lintPath)
+                io.stdout(`lint: ${result.lintPath} (${result.lintErrors} error findings — reported, not gating)`);
+        }
+        // Spec: exit 0 on completed capture even when lint has errors.
+        return result.ok ? 0 : 2;
+    };
+    if (runner === "local") {
+        const playwrightBin = join(io.cwd, "node_modules", ".bin", process.platform === "win32" ? "playwright.cmd" : "playwright");
+        if (!existsSync(playwrightBin) && exec("pnpm", ["exec", "playwright", "--version"], io.cwd).status !== 0) {
+            return finish({ ok: false, runner, outDir, pngs: [], lintErrors: 0, error: "local runner unavailable: playwright is not installed in this project (use --runner gh-actions)" });
+        }
+        // shots/viewports reach the spec through the same env vars the
+        // aura3d-lookdev.yml workflow sets (A3D_LOOKDEV_SHOTS/VIEWPORTS); exec()
+        // spawns with inherited env, so callers/tests set them on the process.
+        void shots;
+        void viewports;
+        const result = exec("pnpm", ["exec", "playwright", "test", "tests/screenshot.spec.ts", "--reporter=line", "--workers=1"], io.cwd);
+        if (result.status !== 0) {
+            return finish({ ok: false, runner, outDir, pngs: [], lintErrors: 0, error: `local playwright run failed: ${result.stderr || result.stdout}` });
+        }
+        const reportsDir = resolve(io.cwd, "tests/reports");
+        for (const file of collectPngs(reportsDir)) {
+            const dest = join(outDir, file.slice(reportsDir.length + 1));
+            mkdirSync(join(dest, ".."), { recursive: true });
+            writeFileSync(dest, readFileSync(file));
+        }
+        for (const json of ["screenshot.json", "appliedLook.json", "lint.json"]) {
+            const src = join(reportsDir, json);
+            if (existsSync(src))
+                writeFileSync(join(outDir, json), readFileSync(src));
+        }
+        const reports = emitLookReports(outDir);
+        return finish({ ok: true, runner, outDir, pngs: collectPngs(outDir), ...reports });
+    }
+    // --runner gh-actions: use the user's gh auth; never set/read tokens.
+    if (exec("gh", ["--version"], io.cwd).status !== 0) {
+        return finish({ ok: false, runner, outDir, pngs: [], lintErrors: 0, error: "gh CLI not found; install https://cli.github.com or use --runner local" });
+    }
+    const workflowFile = resolve(io.cwd, ".github/workflows/aura3d-lookdev.yml");
+    if (!existsSync(workflowFile)) {
+        return finish({ ok: false, runner, outDir, pngs: [], lintErrors: 0, error: "no .github/workflows/aura3d-lookdev.yml in this project (templates ship it by default)" });
+    }
+    const dispatchArgs = ["workflow", "run", "aura3d-lookdev.yml"];
+    if (shots)
+        dispatchArgs.push("-f", `shots=${shots}`);
+    if (viewports)
+        dispatchArgs.push("-f", `viewports=${viewports}`);
+    const dispatch = exec("gh", dispatchArgs, io.cwd);
+    if (dispatch.status !== 0) {
+        return finish({ ok: false, runner, outDir, pngs: [], lintErrors: 0, error: `gh workflow run failed: ${dispatch.stderr || dispatch.stdout}` });
+    }
+    // Poll the newest run of the workflow until it completes.
+    let runId;
+    for (let poll = 0; poll < maxPolls; poll++) {
+        const list = exec("gh", ["run", "list", "--workflow=aura3d-lookdev.yml", "--limit", "1", "--json", "databaseId,status,conclusion"], io.cwd);
+        if (list.status === 0) {
+            try {
+                const [run] = JSON.parse(list.stdout);
+                if (run?.databaseId !== undefined) {
+                    runId = String(run.databaseId);
+                    if (run.status === "completed") {
+                        if (run.conclusion === "success")
+                            break;
+                        return finish({ ok: false, runner, outDir, pngs: [], lintErrors: 0, error: `look-dev run ${runId} concluded ${run.conclusion}` });
+                    }
+                }
+            }
+            catch { /* gh emitted non-JSON; keep polling */ }
+        }
+        sleep(pollMs);
+    }
+    if (!runId) {
+        return finish({ ok: false, runner, outDir, pngs: [], lintErrors: 0, error: "no aura3d-lookdev run appeared after dispatch" });
+    }
+    // Completed? Re-check status once more after the loop exits on success only.
+    const download = exec("gh", ["run", "download", runId, "--name", "lookdev", "--dir", outDir], io.cwd);
+    if (download.status !== 0) {
+        return finish({ ok: false, runner, outDir, pngs: [], lintErrors: 0, error: `gh run download failed: ${download.stderr || download.stdout}` });
+    }
+    const reports = emitLookReports(outDir);
+    return finish({ ok: true, runner, outDir, pngs: collectPngs(outDir), ...reports });
+}
+export const lookCaptureCommand = {
+    name: "look capture",
+    owner: "prd13",
+    summary: "Capture look-dev screenshots via the project's lookdev workflow (gh-actions) or local Playwright",
+    usage: "aura3d look capture [--route /] [--shots opening,mid,action] [--viewports desktop,mobile] [--runner gh-actions|local] [--out dist/lookdev/<n>] [--json]",
+    run: (argv, io) => runLookCapture(argv, io)
+};
+//# sourceMappingURL=capture.js.map

package/dist/look/capture.js.map

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

package/dist/look/judge.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 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 type { AuraCliCommand } from "../contracts/commands.js";
+export declare function runLookJudge(argv: readonly string[], io: {
+    readonly cwd: string;
+    stdout(s: string): void;
+    stderr(s: string): void;
+}): Promise<number>;
+export declare function runLookRubric(argv: readonly string[], io: {
+    readonly cwd: string;
+    stdout(s: string): void;
+    stderr(s: string): void;
+}): number;
+export declare const lookJudgeCommand: AuraCliCommand;
+export declare const lookRubricCommand: AuraCliCommand;
+//# sourceMappingURL=judge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"judge.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/look/judge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAyB/D,wBAAsB,YAAY,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,CAwE3J;AAED,wBAAgB,aAAa,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,MAAM,CA4B7I;AAED,eAAO,MAAM,gBAAgB,EAAE,cAM9B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAM/B,CAAC"}