@bitmagic/asset-core 0.2.7-dev.0 → 0.2.7-dev.2

package/dist/index.d.ts

@@ -17,6 +17,10 @@ export { generateAnimationAsset, animationParamsSchema, getConfiguredAnimationMo
 export type { AnimationParams, AnimationResult } from './generators/animation.js';
 export { fetchContentLength } from './http.js';
 export { PIXAR_VOXEL_STYLE, MAX_COVER_DESIGN_CHARS, buildCoverArtPrompt } from './cover-prompt.js';
+export { JUDGE_DIMENSIONS, judgeScorecardSchema } from './judge-scorecard.js';
+export type { JudgeDimension, JudgeScorecard } from './judge-scorecard.js';
+export { JUDGE_GENRE_HINTS, JUDGE_RUBRIC, MAX_JUDGE_DESIGN_CHARS, MAX_JUDGE_SCENE_FACTS_CHARS, MAX_JUDGE_VERIFY_CHARS, buildJudgeRubric, } from './judge-prompt.js';
+export type { JudgeRubricInput } from './judge-prompt.js';
 export { TERMINAL_FAILURE_CODES, TERMINAL_FAILURE_VERSION, buildTerminalFailure, isTerminalFailureCode, legacyErrorTypeFor, parseTerminalFailure, } from './terminal-failure.js';
 export type { BuildTerminalFailureInput, LegacyErrorType, TerminalFailure, TerminalFailureCode, TerminalFailureDetail, } from './terminal-failure.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,UAAU,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5F,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACnF,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACrF,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACtE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,EAC3B,gCAAgC,EAChC,gCAAgC,EAChC,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAMnG,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,yBAAyB,EACzB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,UAAU,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5F,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACnF,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACrF,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACtE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,EAC3B,gCAAgC,EAChC,gCAAgC,EAChC,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,2BAA2B,EAC3B,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAM1D,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,yBAAyB,EACzB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -9,6 +9,8 @@ export { generateProp, propParamsSchema } from './generators/prop.js';
 export { generateAnimationAsset, animationParamsSchema, getConfiguredAnimationModel, ANIMATION_MODEL_TEXT_TO_MOTION_3, ANIMATION_MODEL_TEXT_TO_MOTION_2, ANIMATION_MODEL_OLDER, } from './generators/animation.js';
 export { fetchContentLength } from './http.js';
 export { PIXAR_VOXEL_STYLE, MAX_COVER_DESIGN_CHARS, buildCoverArtPrompt } from './cover-prompt.js';
+export { JUDGE_DIMENSIONS, judgeScorecardSchema } from './judge-scorecard.js';
+export { JUDGE_GENRE_HINTS, JUDGE_RUBRIC, MAX_JUDGE_DESIGN_CHARS, MAX_JUDGE_SCENE_FACTS_CHARS, MAX_JUDGE_VERIFY_CHARS, buildJudgeRubric, } from './judge-prompt.js';
 // The agent↔client terminal-failure contract. Also published as the
 // `@bitmagic/asset-core/terminal-failure` subpath: this barrel eagerly pulls in
 // the generators (and therefore zod, the forger client, and node http helpers),

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5E,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAE5F,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAErF,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEtE,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,EAC3B,gCAAgC,EAChC,gCAAgC,EAChC,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEnG,oEAAoE;AACpE,gFAAgF;AAChF,gFAAgF;AAChF,oEAAoE;AACpE,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5E,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAE5F,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAErF,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEtE,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,EAC3B,gCAAgC,EAChC,gCAAgC,EAChC,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE9E,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,2BAA2B,EAC3B,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAG3B,oEAAoE;AACpE,gFAAgF;AAChF,gFAAgF;AAChF,oEAAoE;AACpE,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC"}

package/dist/judge-prompt.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Quality-judge rubric composition for `bitmagic judge`. Like cover-prompt.ts
+ * this module composes strings only — no network, no credentials — and lives
+ * here so any lane that judges a game frame grades against the same rubric.
+ *
+ * Split of responsibilities: the CLI composes everything project-derived (the
+ * design excerpt, the genre hint, the verify summary) via buildJudgeRubric;
+ * the api-server owns the fixed judge instructions and the output-schema
+ * directive, so the instructions and judgeScorecardSchema cannot drift apart.
+ */
+/** How much of GAME-DESIGN.md reaches the judge; the rest is dropped. */
+export declare const MAX_JUDGE_DESIGN_CHARS = 4000;
+/** How much verify context (run state + console tail) reaches the judge. */
+export declare const MAX_JUDGE_VERIFY_CHARS = 4000;
+/** How much engine scene inventory reaches the judge. */
+export declare const MAX_JUDGE_SCENE_FACTS_CHARS = 2500;
+/**
+ * The generic rubric: every dimension with concrete anchors for what a low and
+ * a high score look like, so two runs of a small model land near each other.
+ * Keep anchors about what is VISIBLE IN A FRAME — the judge sees screenshots,
+ * not gameplay.
+ */
+export declare const JUDGE_RUBRIC = "Score each dimension from 1 to 10:\n\n- visual-quality: Does the frame look like a finished game? 3 = flat default\n  materials, untextured primitives, harsh unshadowed lighting. 8 = cohesive\n  palette, deliberate lighting, materials and shapes that read as one art style.\n- readability: Could a new player tell from this frame alone what to do and\n  where to go? 3 = player, goals and hazards blend into the background. 8 = the\n  player character, the route and the interactive elements pop at a glance.\n- design-fidelity: Does the frame match the game the design document describes?\n  3 = generic scene that could be any game. 8 = the described setting, mood and\n  core mechanic are recognizably on screen.\n- polish: 3 = placeholder blocks, floating or intersecting props, empty default\n  skybox, raw default HUD. 8 = grounded objects, dressed edges of the world,\n  HUD that belongs to this game.";
+/**
+ * Genre-specific bullets, keyed loosely on the engine's mechanic recipe names
+ * (mechanic-platformer.md and friends). Deliberately short: these steer the
+ * judge's attention, they do not restate the recipes — the full recipes are
+ * engine implementation docs and never reach the model.
+ */
+export declare const JUDGE_GENRE_HINTS: Record<string, string>;
+export interface JudgeRubricInput {
+    /** GAME-DESIGN.md content; empty when the project has none. */
+    designText: string;
+    /** Optional genre key; unknown keys are ignored. */
+    genre?: string;
+    /** One-paragraph verify summary: run state plus a console tail. */
+    verifySummary?: string;
+    /**
+     * A deterministic inventory of the scene (object counts and spread, assets,
+     * world settings), composed in code from world.json. The frame shows one
+     * camera angle; this is the whole world — the rubric tells the judge to
+     * trust it over inference from pixels, which is what stops findings like
+     * "the world is empty" when the content is simply behind the camera.
+     */
+    sceneFacts?: string;
+}
+/**
+ * Compose the project-derived half of the judge prompt. The result is sent as
+ * the text part alongside the screenshot(s); the server prepends its fixed
+ * judging instructions and appends the JSON output directive.
+ */
+export declare function buildJudgeRubric({ designText, genre, verifySummary, sceneFacts }: JudgeRubricInput): string;
+//# sourceMappingURL=judge-prompt.d.ts.map

package/dist/judge-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"judge-prompt.d.ts","sourceRoot":"","sources":["../src/judge-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,yEAAyE;AACzE,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,4EAA4E;AAC5E,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,yDAAyD;AACzD,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,YAAY,i5BAaQ,CAAC;AAElC;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmBpD,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,EAAE,gBAAgB,GAAG,MAAM,CAmC3G"}

package/dist/judge-prompt.js

@@ -0,0 +1,97 @@
+/**
+ * Quality-judge rubric composition for `bitmagic judge`. Like cover-prompt.ts
+ * this module composes strings only — no network, no credentials — and lives
+ * here so any lane that judges a game frame grades against the same rubric.
+ *
+ * Split of responsibilities: the CLI composes everything project-derived (the
+ * design excerpt, the genre hint, the verify summary) via buildJudgeRubric;
+ * the api-server owns the fixed judge instructions and the output-schema
+ * directive, so the instructions and judgeScorecardSchema cannot drift apart.
+ */
+import { JUDGE_DIMENSIONS } from './judge-scorecard.js';
+/** How much of GAME-DESIGN.md reaches the judge; the rest is dropped. */
+export const MAX_JUDGE_DESIGN_CHARS = 4000;
+/** How much verify context (run state + console tail) reaches the judge. */
+export const MAX_JUDGE_VERIFY_CHARS = 4000;
+/** How much engine scene inventory reaches the judge. */
+export const MAX_JUDGE_SCENE_FACTS_CHARS = 2500;
+/**
+ * The generic rubric: every dimension with concrete anchors for what a low and
+ * a high score look like, so two runs of a small model land near each other.
+ * Keep anchors about what is VISIBLE IN A FRAME — the judge sees screenshots,
+ * not gameplay.
+ */
+export const JUDGE_RUBRIC = `Score each dimension from 1 to 10:
+
+- visual-quality: Does the frame look like a finished game? 3 = flat default
+  materials, untextured primitives, harsh unshadowed lighting. 8 = cohesive
+  palette, deliberate lighting, materials and shapes that read as one art style.
+- readability: Could a new player tell from this frame alone what to do and
+  where to go? 3 = player, goals and hazards blend into the background. 8 = the
+  player character, the route and the interactive elements pop at a glance.
+- design-fidelity: Does the frame match the game the design document describes?
+  3 = generic scene that could be any game. 8 = the described setting, mood and
+  core mechanic are recognizably on screen.
+- polish: 3 = placeholder blocks, floating or intersecting props, empty default
+  skybox, raw default HUD. 8 = grounded objects, dressed edges of the world,
+  HUD that belongs to this game.`;
+/**
+ * Genre-specific bullets, keyed loosely on the engine's mechanic recipe names
+ * (mechanic-platformer.md and friends). Deliberately short: these steer the
+ * judge's attention, they do not restate the recipes — the full recipes are
+ * engine implementation docs and never reach the model.
+ */
+export const JUDGE_GENRE_HINTS = {
+    platformer: `- Is the traversal route readable — can you see where to jump next?
+- Do platforms and hazards contrast with the backdrop?
+- Does the camera frame the player with room in the direction of travel?`,
+    racing: `- Is the track boundary unmistakable at speed?
+- Do track, walls and scenery separate visually?
+- Is there a sense of direction — where the next corner goes?`,
+    shooter: `- Are potential targets visible against the environment?
+- Is there a usable crosshair/aim affordance and ammo/health HUD?
+- Does the scene offer readable cover and sightlines?`,
+    combat: `- Do combatants stand out from the arena?
+- Are health/stamina affordances present and legible?
+- Does the arena read as a bounded fighting space?`,
+    driving: `- Is the drivable surface clearly distinct from off-road?
+- Does the vehicle sit convincingly on the ground?
+- Are speed cues (road markings, scenery density) present?`,
+    'tower-defense': `- Is the creep path readable end to end?
+- Do buildable spots and built towers read differently?
+- Is the economy/wave HUD legible?`,
+};
+/** A section's text, trimmed and capped — empty when there is nothing to send. */
+function excerpt(text, maxChars) {
+    return text?.trim().slice(0, maxChars) ?? '';
+}
+/**
+ * Compose the project-derived half of the judge prompt. The result is sent as
+ * the text part alongside the screenshot(s); the server prepends its fixed
+ * judging instructions and appends the JSON output directive.
+ */
+export function buildJudgeRubric({ designText, genre, verifySummary, sceneFacts }) {
+    const sections = [JUDGE_RUBRIC];
+    const genreKey = genre?.trim().toLowerCase() ?? '';
+    const genreHints = JUDGE_GENRE_HINTS[genreKey];
+    if (genreHints) {
+        sections.push(`Genre-specific checks (${genreKey}):\n${genreHints}`);
+    }
+    const design = excerpt(designText, MAX_JUDGE_DESIGN_CHARS);
+    sections.push(design
+        ? `The game's design document (judge design-fidelity against this):\n${design}`
+        : 'No design document was provided; score design-fidelity on internal coherence — does the frame look like one deliberate game rather than assorted parts?');
+    const facts = excerpt(sceneFacts, MAX_JUDGE_SCENE_FACTS_CHARS);
+    if (facts) {
+        sections.push('Ground truth from the engine — the frame shows ONE camera angle of this world. Trust these '
+            + 'facts over anything you infer from the frame, and never report a finding they '
+            + `contradict (e.g. "the world is empty" when objects exist off-camera):\n${facts}`);
+    }
+    const verify = excerpt(verifySummary, MAX_JUDGE_VERIFY_CHARS);
+    if (verify) {
+        sections.push(`Context from the automated boot check of this exact build:\n${verify}`);
+    }
+    sections.push(`Findings must be specific, visible in the frame, and actionable by a developer — name the object or region and say what to change. Report at most 3, most severe first. Dimensions to score: ${JUDGE_DIMENSIONS.join(', ')}.`);
+    return sections.join('\n\n');
+}
+//# sourceMappingURL=judge-prompt.js.map

package/dist/judge-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"judge-prompt.js","sourceRoot":"","sources":["../src/judge-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,yEAAyE;AACzE,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C,4EAA4E;AAC5E,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C,yDAAyD;AACzD,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;iCAaK,CAAC;AAElC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD,UAAU,EAAE;;yEAE2D;IACvE,MAAM,EAAE;;8DAEoD;IAC5D,OAAO,EAAE;;sDAE2C;IACpD,MAAM,EAAE;;mDAEyC;IACjD,OAAO,EAAE;;2DAEgD;IACzD,eAAe,EAAE;;mCAEgB;CAClC,CAAC;AAmBF,kFAAkF;AAClF,SAAS,OAAO,CAAC,IAAwB,EAAE,QAAgB;IACzD,OAAO,IAAI,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAoB;IACjG,MAAM,QAAQ,GAAa,CAAC,YAAY,CAAC,CAAC;IAE1C,MAAM,QAAQ,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;IACnD,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,UAAU,EAAE,CAAC;QACf,QAAQ,CAAC,IAAI,CAAC,0BAA0B,QAAQ,OAAO,UAAU,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAC;IAC3D,QAAQ,CAAC,IAAI,CACX,MAAM;QACJ,CAAC,CAAC,qEAAqE,MAAM,EAAE;QAC/E,CAAC,CAAC,yJAAyJ,CAC9J,CAAC;IAEF,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,EAAE,2BAA2B,CAAC,CAAC;IAC/D,IAAI,KAAK,EAAE,CAAC;QACV,QAAQ,CAAC,IAAI,CACX,6FAA6F;cACzF,gFAAgF;cAChF,0EAA0E,KAAK,EAAE,CACtF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,sBAAsB,CAAC,CAAC;IAC9D,IAAI,MAAM,EAAE,CAAC;QACX,QAAQ,CAAC,IAAI,CAAC,+DAA+D,MAAM,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,QAAQ,CAAC,IAAI,CACX,gMAAgM,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC/N,CAAC;IAEF,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/judge-scorecard.d.ts

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+/**
+ * The quality-judge scorecard contract, shared by the api-server judge route
+ * (which validates what the vision model returned) and the CLI (which
+ * validates the terminal frame before writing `.bitmagic/judge.json`). It
+ * lives here so the two sides can never drift: a scorecard the server accepts
+ * is by construction one the CLI can record and render.
+ *
+ * Dimension names are a fixed enum, not free text, so scores stay comparable
+ * run over run — "readability: 4 → 7" only means something if both runs were
+ * grading the same axis.
+ */
+export declare const JUDGE_DIMENSIONS: readonly ["visual-quality", "readability", "design-fidelity", "polish"];
+export type JudgeDimension = (typeof JUDGE_DIMENSIONS)[number];
+export declare const judgeScorecardSchema: z.ZodObject<{
+    overall: z.ZodNumber;
+    dimensions: z.ZodArray<z.ZodObject<{
+        name: z.ZodEnum<["visual-quality", "readability", "design-fidelity", "polish"]>;
+        score: z.ZodNumber;
+        note: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: "visual-quality" | "readability" | "design-fidelity" | "polish";
+        score: number;
+        note: string;
+    }, {
+        name: "visual-quality" | "readability" | "design-fidelity" | "polish";
+        score: number;
+        note: string;
+    }>, "many">;
+    topFindings: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        detail: z.ZodString;
+        severity: z.ZodEnum<["high", "medium", "low"]>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        detail: string;
+        severity: "high" | "medium" | "low";
+    }, {
+        title: string;
+        detail: string;
+        severity: "high" | "medium" | "low";
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    overall: number;
+    dimensions: {
+        name: "visual-quality" | "readability" | "design-fidelity" | "polish";
+        score: number;
+        note: string;
+    }[];
+    topFindings: {
+        title: string;
+        detail: string;
+        severity: "high" | "medium" | "low";
+    }[];
+}, {
+    overall: number;
+    dimensions: {
+        name: "visual-quality" | "readability" | "design-fidelity" | "polish";
+        score: number;
+        note: string;
+    }[];
+    topFindings: {
+        title: string;
+        detail: string;
+        severity: "high" | "medium" | "low";
+    }[];
+}>;
+export type JudgeScorecard = z.infer<typeof judgeScorecardSchema>;
+//# sourceMappingURL=judge-scorecard.d.ts.map

package/dist/judge-scorecard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"judge-scorecard.d.ts","sourceRoot":"","sources":["../src/judge-scorecard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,gBAAgB,yEAKnB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuB/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/judge-scorecard.js

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+/**
+ * The quality-judge scorecard contract, shared by the api-server judge route
+ * (which validates what the vision model returned) and the CLI (which
+ * validates the terminal frame before writing `.bitmagic/judge.json`). It
+ * lives here so the two sides can never drift: a scorecard the server accepts
+ * is by construction one the CLI can record and render.
+ *
+ * Dimension names are a fixed enum, not free text, so scores stay comparable
+ * run over run — "readability: 4 → 7" only means something if both runs were
+ * grading the same axis.
+ */
+export const JUDGE_DIMENSIONS = [
+    'visual-quality',
+    'readability',
+    'design-fidelity',
+    'polish',
+];
+export const judgeScorecardSchema = z.object({
+    overall: z.number().min(1).max(10),
+    dimensions: z
+        .array(z.object({
+        name: z.enum(JUDGE_DIMENSIONS),
+        score: z.number().min(1).max(10),
+        note: z.string().max(300),
+    }))
+        .min(1)
+        .max(JUDGE_DIMENSIONS.length),
+    topFindings: z
+        .array(z.object({
+        title: z.string().max(120),
+        // The detail must say what to CHANGE, not just what is wrong; the
+        // prompt enforces the intent, the length cap enforces the discipline.
+        detail: z.string().max(500),
+        severity: z.enum(['high', 'medium', 'low']),
+    }))
+        .max(3),
+});
+//# sourceMappingURL=judge-scorecard.js.map

package/dist/judge-scorecard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"judge-scorecard.js","sourceRoot":"","sources":["../src/judge-scorecard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,gBAAgB;IAChB,aAAa;IACb,iBAAiB;IACjB,QAAQ;CACA,CAAC;AAIX,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAClC,UAAU,EAAE,CAAC;SACV,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;QAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;KAC1B,CAAC,CACH;SACA,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,gBAAgB,CAAC,MAAM,CAAC;IAC/B,WAAW,EAAE,CAAC;SACX,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;QAC1B,kEAAkE;QAClE,sEAAsE;QACtE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;QAC3B,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;KAC5C,CAAC,CACH;SACA,GAAG,CAAC,CAAC,CAAC;CACV,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitmagic/asset-core",
-  "version": "0.2.7-dev.0",
+  "version": "0.2.7-dev.2",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Bitmagic Oy",
   "type": "module",