@bitmagic/asset-core 0.2.10-dev.4 → 0.2.10

package/dist/index.d.ts

@@ -26,10 +26,10 @@ 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 { MAX_REFERENCE_DESIGN_CHARS, buildReferenceImagePrompt } from './reference-prompt.js';
-export { JUDGE_DIMENSIONS, judgeScorecardSchema } from './judge-scorecard.js';
-export type { JudgeDimension, JudgeScorecard } from './judge-scorecard.js';
-export { JUDGE_GENRE_HINTS, JUDGE_MOBILE_HINT, 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 { JUDGE_DIMENSIONS, deriveOverall, judgeModelResponseSchema, judgeScorecardSchema, } from './judge-scorecard.js';
+export type { JudgeDimension, JudgeModelResponse, JudgeScorecard } from './judge-scorecard.js';
+export { JUDGE_GENRE_HINTS, JUDGE_MOBILE_HINT, JUDGE_RUBRIC, MAX_JUDGE_ART_DIRECTION_CHARS, MAX_JUDGE_DESIGN_CHARS, MAX_JUDGE_SCENE_FACTS_CHARS, MAX_JUDGE_VERIFY_CHARS, buildJudgeRubric, buildJudgeStyleHint, } from './judge-prompt.js';
+export type { JudgePriorVerdict, 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":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -14,8 +14,8 @@ export { generateAnimationAsset, animationParamsSchema, getConfiguredAnimationMo
 export { fetchContentLength } from './http.js';
 export { PIXAR_VOXEL_STYLE, MAX_COVER_DESIGN_CHARS, buildCoverArtPrompt } from './cover-prompt.js';
 export { MAX_REFERENCE_DESIGN_CHARS, buildReferenceImagePrompt } from './reference-prompt.js';
-export { JUDGE_DIMENSIONS, judgeScorecardSchema } from './judge-scorecard.js';
-export { JUDGE_GENRE_HINTS, JUDGE_MOBILE_HINT, JUDGE_RUBRIC, MAX_JUDGE_DESIGN_CHARS, MAX_JUDGE_SCENE_FACTS_CHARS, MAX_JUDGE_VERIFY_CHARS, buildJudgeRubric, } from './judge-prompt.js';
+export { JUDGE_DIMENSIONS, deriveOverall, judgeModelResponseSchema, judgeScorecardSchema, } from './judge-scorecard.js';
+export { JUDGE_GENRE_HINTS, JUDGE_MOBILE_HINT, JUDGE_RUBRIC, MAX_JUDGE_ART_DIRECTION_CHARS, MAX_JUDGE_DESIGN_CHARS, MAX_JUDGE_SCENE_FACTS_CHARS, MAX_JUDGE_VERIFY_CHARS, buildJudgeRubric, buildJudgeStyleHint, } 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,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAExF,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEtF,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAE5F,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAErF,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEtE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEvG,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,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE9E,OAAO,EACL,iBAAiB,EACjB,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"}
+{"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,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAExF,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEtF,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAE5F,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAErF,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEtE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEvG,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,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,6BAA6B,EAC7B,sBAAsB,EACtB,2BAA2B,EAC3B,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,GACpB,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

@@ -14,6 +14,12 @@ export declare const MAX_JUDGE_DESIGN_CHARS = 4000;
 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;
+/**
+ * How much declared art direction reaches the judge. Small on purpose: this is a statement of
+ * intended look, not a second design document, and a creator who pastes their whole art bible
+ * here would push the rubric's own bullets further from the answer.
+ */
+export declare const MAX_JUDGE_ART_DIRECTION_CHARS = 700;
 /**
  * The generic rubric: every dimension with concrete anchors for what a low and
  * a high score look like, so two runs land near each other. Anchors are what
@@ -22,7 +28,21 @@ export declare const MAX_JUDGE_SCENE_FACTS_CHARS = 2500;
  * 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.";
+export declare const JUDGE_RUBRIC = "Score each dimension from 1 to 10.\n\nThe top of this scale is THIS game, in its own art style and on this engine,\nwith nothing left to fix \u2014 not a photorealistic AAA production. 10 is reachable\nand you must award it when the frame earns it. Holding the top of the scale in\nreserve for work of a different budget and medium makes every score below it\nmeaningless, and it tells a developer who has genuinely finished a frame that\ntheir work is mediocre.\n\n- visual-quality: Does the frame look like a finished game?\n  3 = default materials and undressed shapes with no shared palette; harsh, unshadowed lighting.\n  6 = a palette and a lighting intent are evident but applied unevenly \u2014 part of the frame is dressed, part is not.\n  8 = cohesive palette, deliberate lighting, materials and shapes that read as one art style.\n  10 = nothing in the frame reads as unfinished; it could serve as a store screenshot for this game.\n- readability: Could a new player tell from this frame alone what to do and where to go?\n  3 = player, goals and hazards blend into the background.\n  6 = the player reads clearly, but the route or the interactive elements take a moment to find.\n  8 = the player character, the route and the interactive elements pop at a glance.\n  10 = a first-time player would know where to go and what matters without being told.\n- design-fidelity: Does the frame match the game the design document describes?\n  3 = generic scene that could be any game.\n  6 = the setting is recognisable but the mood or the core mechanic is not yet legible on screen.\n  8 = the described setting, mood and core mechanic are recognizably on screen.\n  10 = the frame is unmistakably the game the document describes, mood included.\n- polish:\n  3 = placeholder blocks, floating or intersecting props, empty default skybox, raw default HUD.\n  6 = the obvious placeholders are gone, but edges of the world, prop grounding or HUD styling are unfinished.\n  8 = grounded objects, dressed edges of the world, HUD that belongs to this game.\n  10 = no seam, gap or default asset remains for you to point at.";
+/**
+ * The declared art direction, stated as intent so the judge stops grading the medium.
+ *
+ * This is the same intervention as JUDGE_MOBILE_HINT and it exists for the same reason: a vision
+ * model with no statement of intent measures the frame against photoreal and reports the style
+ * itself as the defect. In the field that produced findings like "blocky character" on a voxel
+ * game and "low-poly mountains" on a deliberately low-poly one — the medium cited as a flaw, run
+ * after run, and unfixable by definition, which is what made creators stop running the judge.
+ *
+ * The final paragraph is the load-bearing one: it keeps the hint from becoming a blanket amnesty.
+ * A style consistently applied is what earns marks; the same style applied unevenly is still a
+ * finding, and that is the distinction the judge has to be handed rather than left to infer.
+ */
+export declare function buildJudgeStyleHint(artDirection: string): string;
 /**
  * What changes when the frame is a phone screenshot rather than a desktop one.
  *
@@ -43,9 +63,44 @@ export declare const JUDGE_MOBILE_HINT = "This frame is a PHONE screen, captured
  * engine implementation docs and never reach the model.
  */
 export declare const JUDGE_GENRE_HINTS: Record<string, string>;
+/**
+ * The previous verdict, replayed to the judge so a second run grades the DELTA.
+ *
+ * Without this every run is a clean room, and two failures follow from that. Findings contradict
+ * each other between runs with nothing to catch it — a glow reported as "barely visible" comes
+ * back as "no glow at all" while plainly in frame — and a shipped improvement is invisible,
+ * because the judge has no idea there was a before. Both were observed in the field across
+ * sixteen runs.
+ *
+ * The record this is built from already exists on disk (`.bitmagic/judge.json`) and the CLI
+ * already reads it for the staleness warning, so this costs nothing to obtain.
+ *
+ * Note the honest limit: each round grades a NEWLY captured screenshot, so a changed observation
+ * is sometimes a changed frame rather than a changed opinion. That is why the instruction below
+ * asks the judge to SAY the frame changed rather than silently reversing itself.
+ */
+export interface JudgePriorVerdict {
+    readonly overall: number;
+    readonly dimensions: readonly {
+        readonly name: string;
+        readonly score: number;
+    }[];
+    readonly findings: readonly {
+        readonly title: string;
+        readonly severity: string;
+    }[];
+}
 export interface JudgeRubricInput {
     /** GAME-DESIGN.md content; empty when the project has none. */
     designText: string;
+    /**
+     * The project's declared art direction — the "Art direction" section of GAME-DESIGN.md.
+     * Absent or empty means no declaration, and the judge grades style as it did before this
+     * existed.
+     */
+    artDirection?: string;
+    /** The previous run's verdict, when there is one to compare against. */
+    previous?: JudgePriorVerdict;
     /** Optional genre key; unknown keys are ignored. */
     genre?: string;
     /**
@@ -69,5 +124,5 @@ export interface JudgeRubricInput {
  * 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, platform, verifySummary, sceneFacts, }: JudgeRubricInput): string;
+export declare function buildJudgeRubric({ designText, artDirection, previous, genre, platform, verifySummary, sceneFacts, }: JudgeRubricInput): string;
 //# sourceMappingURL=judge-prompt.d.ts.map

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

@@ -1 +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;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,i5BAaQ,CAAC;AAElC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,4kCAeW,CAAC;AAE1C;;;;;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;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAChC,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,UAAU,EACV,KAAK,EACL,QAAQ,EACR,aAAa,EACb,UAAU,GACX,EAAE,gBAAgB,GAAG,MAAM,CAwC3B"}
+{"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;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAEjD;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,glEA4ByC,CAAC;AAEnE;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAahE;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,4kCAeW,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmBpD,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClF,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACrF;AAyBD,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAChC,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,aAAa,EACb,UAAU,GACX,EAAE,gBAAgB,GAAG,MAAM,CAiD3B"}

package/dist/judge-prompt.js

@@ -15,6 +15,12 @@ export const MAX_JUDGE_DESIGN_CHARS = 4000;
 export const MAX_JUDGE_VERIFY_CHARS = 4000;
 /** How much engine scene inventory reaches the judge. */
 export const MAX_JUDGE_SCENE_FACTS_CHARS = 2500;
+/**
+ * How much declared art direction reaches the judge. Small on purpose: this is a statement of
+ * intended look, not a second design document, and a creator who pastes their whole art bible
+ * here would push the rubric's own bullets further from the answer.
+ */
+export const MAX_JUDGE_ART_DIRECTION_CHARS = 700;
 /**
  * The generic rubric: every dimension with concrete anchors for what a low and
  * a high score look like, so two runs land near each other. Anchors are what
@@ -23,20 +29,62 @@ export const MAX_JUDGE_SCENE_FACTS_CHARS = 2500;
  * 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:
+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.
+The top of this scale is THIS game, in its own art style and on this engine,
+with nothing left to fix — not a photorealistic AAA production. 10 is reachable
+and you must award it when the frame earns it. Holding the top of the scale in
+reserve for work of a different budget and medium makes every score below it
+meaningless, and it tells a developer who has genuinely finished a frame that
+their work is mediocre.
+
+- visual-quality: Does the frame look like a finished game?
+  3 = default materials and undressed shapes with no shared palette; harsh, unshadowed lighting.
+  6 = a palette and a lighting intent are evident but applied unevenly — part of the frame is dressed, part is not.
+  8 = cohesive palette, deliberate lighting, materials and shapes that read as one art style.
+  10 = nothing in the frame reads as unfinished; it could serve as a store screenshot for this game.
+- 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.
+  6 = the player reads clearly, but the route or the interactive elements take a moment to find.
+  8 = the player character, the route and the interactive elements pop at a glance.
+  10 = a first-time player would know where to go and what matters without being told.
 - 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.`;
+  3 = generic scene that could be any game.
+  6 = the setting is recognisable but the mood or the core mechanic is not yet legible on screen.
+  8 = the described setting, mood and core mechanic are recognizably on screen.
+  10 = the frame is unmistakably the game the document describes, mood included.
+- polish:
+  3 = placeholder blocks, floating or intersecting props, empty default skybox, raw default HUD.
+  6 = the obvious placeholders are gone, but edges of the world, prop grounding or HUD styling are unfinished.
+  8 = grounded objects, dressed edges of the world, HUD that belongs to this game.
+  10 = no seam, gap or default asset remains for you to point at.`;
+/**
+ * The declared art direction, stated as intent so the judge stops grading the medium.
+ *
+ * This is the same intervention as JUDGE_MOBILE_HINT and it exists for the same reason: a vision
+ * model with no statement of intent measures the frame against photoreal and reports the style
+ * itself as the defect. In the field that produced findings like "blocky character" on a voxel
+ * game and "low-poly mountains" on a deliberately low-poly one — the medium cited as a flaw, run
+ * after run, and unfixable by definition, which is what made creators stop running the judge.
+ *
+ * The final paragraph is the load-bearing one: it keeps the hint from becoming a blanket amnesty.
+ * A style consistently applied is what earns marks; the same style applied unevenly is still a
+ * finding, and that is the distinction the judge has to be handed rather than left to infer.
+ */
+export function buildJudgeStyleHint(artDirection) {
+    return `The game's DECLARED ART DIRECTION. This is the intended look, chosen by the developer:
+
+${artDirection}
+
+Grade craft, cohesion and readability WITHIN this style. A trait this art direction calls for is
+never a finding: do not report blocky or cubic geometry on a voxel game, faceted shading or visible
+polygons on a low-poly one, flat colour on a game that asks for flat colour, or a limited palette
+chosen on purpose. Judging the medium is not a critique a developer can act on.
+
+What remains fair game is the style applied INCONSISTENTLY: one asset at a visibly different
+fidelity from everything around it, a texture or hue that fights the declared palette, an object
+that plainly came from a different game. Those are real and worth reporting.`;
+}
 /**
  * What changes when the frame is a phone screenshot rather than a desktop one.
  *
@@ -91,6 +139,28 @@ export const JUDGE_GENRE_HINTS = {
 - Do buildable spots and built towers read differently?
 - Is the economy/wave HUD legible?`,
 };
+/** The prior-verdict section: the scores to beat, and the findings to adjudicate one by one. */
+function buildPriorVerdictSection(previous) {
+    const scores = previous.dimensions.map((d) => `${d.name} ${d.score}`).join(', ');
+    const findings = previous.findings.length > 0
+        ? previous.findings.map((f, i) => `  ${i + 1}. [${f.severity}] ${f.title}`).join('\n')
+        : '  (none reported)';
+    return `YOU ALREADY GRADED THIS GAME. Your previous verdict:
+  overall ${previous.overall} — ${scores}
+Findings you reported last time:
+${findings}
+
+The developer has shipped changes since. Two things follow:
+
+- Adjudicate your own findings. For each one above, say in the relevant dimension's note whether it
+  is fixed, unchanged or worse. Do not silently reverse a prior claim — if you reported something as
+  faint and now see none of it at all, say the frame changed, because it did: this is a newly
+  captured screenshot, not the one you graded before.
+- Move the scores that earned it. If work visibly landed on a dimension, that dimension must go UP.
+  If nothing about a dimension changed, its score must NOT drift — re-rolling the same frame into a
+  different number is noise, and a developer reading these scores in sequence is entitled to treat a
+  change as meaningful.`;
+}
 /** A section's text, trimmed and capped — empty when there is nothing to send. */
 function excerpt(text, maxChars) {
     return text?.trim().slice(0, maxChars) ?? '';
@@ -100,13 +170,18 @@ function excerpt(text, maxChars) {
  * 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, platform, verifySummary, sceneFacts, }) {
+export function buildJudgeRubric({ designText, artDirection, previous, genre, platform, verifySummary, sceneFacts, }) {
     const sections = [JUDGE_RUBRIC];
     // Immediately after the rubric it modifies, and before the genre hints: "this is a phone"
     // changes how every bullet above should be read, so it has to arrive before they are applied
     // rather than as a footnote after them.
     if (platform === 'mobile')
         sections.push(JUDGE_MOBILE_HINT);
+    // Beside the mobile hint and for the same reason — both re-point the rubric's bullets before
+    // they are applied, rather than excusing a verdict already formed.
+    const style = excerpt(artDirection, MAX_JUDGE_ART_DIRECTION_CHARS);
+    if (style)
+        sections.push(buildJudgeStyleHint(style));
     const genreKey = genre?.trim().toLowerCase() ?? '';
     const genreHints = JUDGE_GENRE_HINTS[genreKey];
     if (genreHints) {
@@ -126,7 +201,11 @@ export function buildJudgeRubric({ designText, genre, platform, verifySummary, s
     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(', ')}.`);
+    // Last, so it is the freshest instruction before the model answers — and after the prior
+    // verdict, whose findings it has to adjudicate.
+    if (previous)
+        sections.push(buildPriorVerdictSection(previous));
+    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, and report FEWER when there are fewer: an empty list is the correct, expected answer for a frame whose only remaining flaws are matters of taste. Never pad the list to reach three — a manufactured finding costs a developer a real fix somewhere else, and one that only names the art direction cannot be acted on at all. Dimensions to score: ${JUDGE_DIMENSIONS.join(', ')}.`);
     return sections.join('\n\n');
 }
 //# sourceMappingURL=judge-prompt.js.map

package/dist/judge-prompt.js.map

@@ -1 +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;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;iCAaK,CAAC;AAElC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;yCAeQ,CAAC;AAE1C;;;;;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;AAwBF,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,EAC/B,UAAU,EACV,KAAK,EACL,QAAQ,EACR,aAAa,EACb,UAAU,GACO;IACjB,MAAM,QAAQ,GAAa,CAAC,YAAY,CAAC,CAAC;IAE1C,0FAA0F;IAC1F,6FAA6F;IAC7F,wCAAwC;IACxC,IAAI,QAAQ,KAAK,QAAQ;QAAE,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAE5D,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"}
+{"version":3,"file":"judge-prompt.js","sourceRoot":"","sources":["../src/judge-prompt.ts"],"names":[],"mappings":"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"}

package/dist/judge-scorecard.d.ts

@@ -12,8 +12,23 @@ import { z } from 'zod';
  */
 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;
+/**
+ * What the MODEL is asked to return: the anchored per-dimension scores and the
+ * findings. Deliberately no `overall`.
+ *
+ * A free-floating overall score is the one number on this card a model cannot
+ * produce well. The dimensions have written anchors, so they move when the
+ * frame moves; an overall asked for as its own judgement is a gestalt
+ * impression with nothing behind it, and it behaves like one — it anchors on
+ * the first verdict and then sits there while the sub-scores it supposedly
+ * summarises climb underneath it. That was observed in the field: shipped
+ * improvements moved individual dimensions run over run while the total stayed
+ * flat at 6, which reads to a creator as "nothing I do matters".
+ *
+ * So the server derives it (`deriveOverall`) instead of asking. A dimension
+ * that improves now moves the total by construction.
+ */
+export declare const judgeModelResponseSchema: z.ZodObject<{
     dimensions: z.ZodArray<z.ZodObject<{
         name: z.ZodEnum<["visual-quality", "readability", "design-fidelity", "polish"]>;
         score: z.ZodNumber;
@@ -41,7 +56,6 @@ export declare const judgeScorecardSchema: z.ZodObject<{
         severity: "high" | "medium" | "low";
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
-    overall: number;
     dimensions: {
         name: "visual-quality" | "readability" | "design-fidelity" | "polish";
         score: number;
@@ -53,7 +67,65 @@ export declare const judgeScorecardSchema: z.ZodObject<{
         severity: "high" | "medium" | "low";
     }[];
 }, {
+    dimensions: {
+        name: "visual-quality" | "readability" | "design-fidelity" | "polish";
+        score: number;
+        note: string;
+    }[];
+    topFindings: {
+        title: string;
+        detail: string;
+        severity: "high" | "medium" | "low";
+    }[];
+}>;
+export type JudgeModelResponse = z.infer<typeof judgeModelResponseSchema>;
+/**
+ * The full card: what the server streams back and the CLI records. Shape is
+ * unchanged from before `overall` became derived, so a published CLI validating
+ * an older contract still accepts what a current server sends.
+ */
+export declare const judgeScorecardSchema: z.ZodObject<{
+    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">;
+} & {
+    overall: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    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;
@@ -64,6 +136,23 @@ export declare const judgeScorecardSchema: z.ZodObject<{
         detail: string;
         severity: "high" | "medium" | "low";
     }[];
+    overall: number;
 }>;
 export type JudgeScorecard = z.infer<typeof judgeScorecardSchema>;
+/**
+ * The overall score: the mean of the dimensions actually scored, to one
+ * decimal.
+ *
+ * One decimal rather than an integer is the point. Four dimensions on a 1-10
+ * scale mean a single dimension moving by one changes the mean by 0.25, and
+ * rounding that to an integer throws away exactly the signal a creator is
+ * looking for after shipping one improvement. `6.0 -> 6.3` is a true statement
+ * about a frame that got better; `6 -> 6` is not.
+ *
+ * An unweighted mean is deliberate: the four dimensions are peers, and any
+ * weighting would be a product opinion smuggled in as arithmetic.
+ */
+export declare function deriveOverall(dimensions: readonly {
+    score: number;
+}[]): number;
 //# sourceMappingURL=judge-scorecard.d.ts.map

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsBnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,MAAM,CAI9E"}

package/dist/judge-scorecard.js

@@ -16,8 +16,23 @@ export const JUDGE_DIMENSIONS = [
     'design-fidelity',
     'polish',
 ];
-export const judgeScorecardSchema = z.object({
-    overall: z.number().min(1).max(10),
+/**
+ * What the MODEL is asked to return: the anchored per-dimension scores and the
+ * findings. Deliberately no `overall`.
+ *
+ * A free-floating overall score is the one number on this card a model cannot
+ * produce well. The dimensions have written anchors, so they move when the
+ * frame moves; an overall asked for as its own judgement is a gestalt
+ * impression with nothing behind it, and it behaves like one — it anchors on
+ * the first verdict and then sits there while the sub-scores it supposedly
+ * summarises climb underneath it. That was observed in the field: shipped
+ * improvements moved individual dimensions run over run while the total stayed
+ * flat at 6, which reads to a creator as "nothing I do matters".
+ *
+ * So the server derives it (`deriveOverall`) instead of asking. A dimension
+ * that improves now moves the total by construction.
+ */
+export const judgeModelResponseSchema = z.object({
     dimensions: z
         .array(z.object({
         name: z.enum(JUDGE_DIMENSIONS),
@@ -36,4 +51,31 @@ export const judgeScorecardSchema = z.object({
     }))
         .max(3),
 });
+/**
+ * The full card: what the server streams back and the CLI records. Shape is
+ * unchanged from before `overall` became derived, so a published CLI validating
+ * an older contract still accepts what a current server sends.
+ */
+export const judgeScorecardSchema = judgeModelResponseSchema.extend({
+    overall: z.number().min(1).max(10),
+});
+/**
+ * The overall score: the mean of the dimensions actually scored, to one
+ * decimal.
+ *
+ * One decimal rather than an integer is the point. Four dimensions on a 1-10
+ * scale mean a single dimension moving by one changes the mean by 0.25, and
+ * rounding that to an integer throws away exactly the signal a creator is
+ * looking for after shipping one improvement. `6.0 -> 6.3` is a true statement
+ * about a frame that got better; `6 -> 6` is not.
+ *
+ * An unweighted mean is deliberate: the four dimensions are peers, and any
+ * weighting would be a product opinion smuggled in as arithmetic.
+ */
+export function deriveOverall(dimensions) {
+    if (dimensions.length === 0)
+        return 1;
+    const mean = dimensions.reduce((sum, d) => sum + d.score, 0) / dimensions.length;
+    return Math.round(mean * 10) / 10;
+}
 //# sourceMappingURL=judge-scorecard.js.map

package/dist/judge-scorecard.js.map

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,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;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,wBAAwB,CAAC,MAAM,CAAC;IAClE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;CACnC,CAAC,CAAC;AAIH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAAC,UAAwC;IACpE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC;IACjF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;AACpC,CAAC"}

package/package.json

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