@bitmagic/cli 0.1.66-dev.6 → 0.1.66-dev.8

package/dist/verify/categories.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Verify failures as categories, for the command beacon.
+ *
+ * `classify.ts` writes its failures as prose for the agent and the creator, and that prose can
+ * carry a path, an error message or a console line — none of which belongs in an analytics
+ * event (see the contract in `telemetry/report.ts`). This maps each failure back to the check
+ * that produced it, so `cli_command(verify, ok=false)` can say WHICH check failed without saying
+ * anything else. The messages in `result.json` are unchanged; publish still reads them.
+ *
+ * Keep the table in step with `classify.ts`: a new failure there lands in `other` here until it
+ * gets a row, and `categories.test.ts` pins every existing message to its category.
+ */
+export type VerifyFailureCategory = 'page_error' | 'start_threw' | 'play_unclickable' | 'selection_stalled' | 'never_started' | 'webgpu_fallback' | 'mobile_parity' | 'no_canvas' | 'canvas_zero' | 'canvas_unclaimed' | 'frame_blank' | 'frame_black' | 'frame_flat' | 'gl_context_lost' | 'engine_error' | 'cors_blocked' | 'fell_out_of_world' | 'still_falling' | 'render_stalled' | 'other';
+export declare function categoriseVerifyFailure(message: string): VerifyFailureCategory;
+/** The distinct categories of a run's failures, in first-seen order — what the beacon carries. */
+export declare function verifyFailureCategories(failures: readonly string[]): VerifyFailureCategory[];

package/dist/verify/categories.js

@@ -0,0 +1,51 @@
+/**
+ * Verify failures as categories, for the command beacon.
+ *
+ * `classify.ts` writes its failures as prose for the agent and the creator, and that prose can
+ * carry a path, an error message or a console line — none of which belongs in an analytics
+ * event (see the contract in `telemetry/report.ts`). This maps each failure back to the check
+ * that produced it, so `cli_command(verify, ok=false)` can say WHICH check failed without saying
+ * anything else. The messages in `result.json` are unchanged; publish still reads them.
+ *
+ * Keep the table in step with `classify.ts`: a new failure there lands in `other` here until it
+ * gets a row, and `categories.test.ts` pins every existing message to its category.
+ */
+const TABLE = [
+    [/^Uncaught error on the page:/, 'page_error'],
+    [/^The Play button was clicked but the game never started/, 'start_threw'],
+    [/^The Play button appeared but could not be clicked/, 'play_unclickable'],
+    [/^Picked \d+ pre-play selection/, 'selection_stalled'],
+    [/^The game never started/, 'never_started'],
+    [/^WebGPU was requested but the renderer silently fell back/, 'webgpu_fallback'],
+    [/^This game declares primaryPlatform "mobile"/, 'mobile_parity'],
+    [/^No <canvas> was rendered/, 'no_canvas'],
+    [/^The canvas has no size/, 'canvas_zero'],
+    [/^The canvas was never resized by a renderer/, 'canvas_unclaimed'],
+    [/^The screenshot is implausibly small/, 'frame_blank'],
+    [/^The screenshot is black/, 'frame_black'],
+    [/^The screenshot shows a flat, featureless area/, 'frame_flat'],
+    [/^The WebGL context was lost/, 'gl_context_lost'],
+    [/^The engine reported:/, 'engine_error'],
+    [/^A game asset could not be fetched/, 'cors_blocked'],
+    [/^The player fell out of the world/, 'fell_out_of_world'],
+    [/^The player was still falling/, 'still_falling'],
+    [/^The page's render loop stalled/, 'render_stalled'],
+];
+/** A multi-platform record prefixes each failure with its platform (`mobile: …`); the check is the same. */
+const PLATFORM_PREFIX = /^(desktop|mobile):\s*/;
+export function categoriseVerifyFailure(message) {
+    const bare = message.replace(PLATFORM_PREFIX, '');
+    for (const [pattern, category] of TABLE) {
+        if (pattern.test(bare))
+            return category;
+    }
+    return 'other';
+}
+/** The distinct categories of a run's failures, in first-seen order — what the beacon carries. */
+export function verifyFailureCategories(failures) {
+    const seen = new Set();
+    for (const failure of failures)
+        seen.add(categoriseVerifyFailure(failure));
+    return [...seen];
+}
+//# sourceMappingURL=categories.js.map

package/dist/verify/categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.js","sourceRoot":"","sources":["../../src/verify/categories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAwBH,MAAM,KAAK,GAA4D;IACrE,CAAC,8BAA8B,EAAE,YAAY,CAAC;IAC9C,CAAC,yDAAyD,EAAE,aAAa,CAAC;IAC1E,CAAC,oDAAoD,EAAE,kBAAkB,CAAC;IAC1E,CAAC,gCAAgC,EAAE,mBAAmB,CAAC;IACvD,CAAC,yBAAyB,EAAE,eAAe,CAAC;IAC5C,CAAC,2DAA2D,EAAE,iBAAiB,CAAC;IAChF,CAAC,8CAA8C,EAAE,eAAe,CAAC;IACjE,CAAC,2BAA2B,EAAE,WAAW,CAAC;IAC1C,CAAC,yBAAyB,EAAE,aAAa,CAAC;IAC1C,CAAC,6CAA6C,EAAE,kBAAkB,CAAC;IACnE,CAAC,sCAAsC,EAAE,aAAa,CAAC;IACvD,CAAC,0BAA0B,EAAE,aAAa,CAAC;IAC3C,CAAC,gDAAgD,EAAE,YAAY,CAAC;IAChE,CAAC,6BAA6B,EAAE,iBAAiB,CAAC;IAClD,CAAC,uBAAuB,EAAE,cAAc,CAAC;IACzC,CAAC,oCAAoC,EAAE,cAAc,CAAC;IACtD,CAAC,mCAAmC,EAAE,mBAAmB,CAAC;IAC1D,CAAC,+BAA+B,EAAE,eAAe,CAAC;IAClD,CAAC,iCAAiC,EAAE,gBAAgB,CAAC;CACtD,CAAC;AAEF,4GAA4G;AAC5G,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAEhD,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAClD,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,KAAK,EAAE,CAAC;QACxC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,QAAQ,CAAC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,uBAAuB,CAAC,QAA2B;IACjE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC9C,KAAK,MAAM,OAAO,IAAI,QAAQ;QAAE,IAAI,CAAC,GAAG,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3E,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AACnB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitmagic/cli",
-  "version": "0.1.66-dev.6",
+  "version": "0.1.66-dev.8",
   "description": "Build Bitmagic games from your own agent tool",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Bitmagic Oy",
@@ -25,9 +25,9 @@
     "playwright-core": "^1.59.1",
     "tar": "^7.4.3",
     "ws": "^8.21.3",
-    "@bitmagic/animation-forger": "0.1.21-dev.6",
-    "@bitmagic/asset-core": "0.2.21-dev.6",
-    "@bitmagic/world-forger": "0.1.26-dev.6"
+    "@bitmagic/animation-forger": "0.1.21-dev.8",
+    "@bitmagic/asset-core": "0.2.21-dev.8",
+    "@bitmagic/world-forger": "0.1.26-dev.8"
   },
   "devDependencies": {
     "@eslint/js": "^9.38.0",
@@ -61,7 +61,8 @@
             "module": "ES2022",
             "moduleResolution": "bundler",
             "verbatimModuleSyntax": false,
-            "esModuleInterop": true
+            "esModuleInterop": true,
+            "rootDir": "."
           }
         }
       ]
@@ -76,8 +77,10 @@
   },
   "scripts": {
     "build": "tsc",
-    "check": "pnpm run lint && pnpm run build",
-    "lint": "eslint src",
+    "check": "pnpm run lint && pnpm run build && pnpm run check:lab",
+    "check:lab": "tsc -p tsconfig.lab.json --noEmit",
+    "lint": "eslint src lab",
+    "lab": "tsx lab/cli.ts",
     "test": "NODE_OPTIONS=--experimental-vm-modules jest"
   }
 }