@hypersoniclabs/helix-cli 0.1.7 → 0.1.24-helix3.438

package/dist/visualQa/critic.js

@@ -0,0 +1,179 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOCATION_CABIN_PARTS = exports.LOCATION_BODY_PARTS = exports.CRITIC_SYSTEM = void 0;
+exports.parseCriticLocation = parseCriticLocation;
+exports.runCritic = runCritic;
+// Vision critic: Claude looks at the rendered frames with a category checklist and must answer pass/fail per check.
+// FAIL CLOSED — a refusal, an unparseable answer, a missing check, `cannot_judge`, or no credentials is never a pass.
+//
+// Credentials: ANTHROPIC_API_KEY (first-party, `claude-opus-5-5`) or OPENROUTER_API_KEY (OpenRouter's
+// Anthropic-compatible Messages endpoint, `anthropic/claude-opus-5.5`). Same SDK, same request either way.
+// The backend runs the authoritative copy of this; this one powers `--local-critic` dry runs.
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const checklists_1 = require("./checklists");
+exports.CRITIC_SYSTEM = [
+    'You are a strict visual QA inspector for a 3D virtual-world marketplace. You are shown rendered frames of ONE item',
+    'in the real game runtime, each preceded by its caption, then a checklist.',
+    'Judge only what is visible in the frames. Any defect a player would notice is a fail. If you are unsure whether',
+    'something is a defect, fail it and say what you saw. Use cannot_judge only when no frame shows what the check needs.',
+    'Do not judge art direction: stylised, low-poly, blocky and flat-coloured items are legitimate design choices. Fail',
+    'defects — things that are broken, misplaced, missing, torn, clipping, floating or placeholder — not taste.',
+    'Answer every check id exactly once, with a one-sentence reason that names the frame(s) you used.',
+    'For every failing check whose id starts with vehicle.occupant., give its location: the seat key from the',
+    'occupant frame id (occupant.<seat>.<view>, null if not one seat), the body part, the cabin part it meets, and',
+    'the exact id of the frame where it is most visible. Give location null for a passing check. A light touch or a',
+    'near-contact that does not visibly pass through the surface is not a fail.',
+].join(' ');
+/** Mirrors the backend's `VISUAL_QA_LOCATION_*` (helix-backend-api src/continuum/visual-qa/visual-qa.critic.ts). */
+exports.LOCATION_BODY_PARTS = ['head', 'torso', 'arm', 'hand', 'hip', 'thigh', 'knee', 'leg', 'foot', 'other'];
+exports.LOCATION_CABIN_PARTS = ['roof', 'pillar', 'door', 'seat', 'dash', 'wheel', 'pedals', 'floor', 'console', 'other'];
+const LOCATION_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    required: ['seat', 'bodyPart', 'cabinPart', 'frame'],
+    properties: {
+        seat: { anyOf: [{ type: 'string' }, { type: 'null' }] },
+        bodyPart: { type: 'string', enum: exports.LOCATION_BODY_PARTS },
+        cabinPart: { type: 'string', enum: exports.LOCATION_CABIN_PARTS },
+        frame: { type: 'string' },
+    },
+};
+/** Strict parse of one `location` (the schema's shape, nothing more); null when it does not match. */
+function parseCriticLocation(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return null;
+    const r = value;
+    if (Object.keys(r).some((k) => !['seat', 'bodyPart', 'cabinPart', 'frame'].includes(k)))
+        return null;
+    if (r.seat !== null && typeof r.seat !== 'string')
+        return null;
+    if (typeof r.bodyPart !== 'string' || !exports.LOCATION_BODY_PARTS.includes(r.bodyPart))
+        return null;
+    if (typeof r.cabinPart !== 'string' || !exports.LOCATION_CABIN_PARTS.includes(r.cabinPart))
+        return null;
+    if (typeof r.frame !== 'string' || !r.frame.length)
+        return null;
+    return { seat: typeof r.seat === 'string' ? r.seat.slice(0, 160) : null, bodyPart: r.bodyPart, cabinPart: r.cabinPart, frame: r.frame.slice(0, 200) };
+}
+const SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    required: ['checks', 'overall', 'summary'],
+    properties: {
+        checks: {
+            type: 'array',
+            items: {
+                type: 'object',
+                additionalProperties: false,
+                required: ['id', 'verdict', 'reason', 'location'],
+                properties: {
+                    id: { type: 'string' },
+                    verdict: { type: 'string', enum: ['pass', 'fail', 'cannot_judge'] },
+                    reason: { type: 'string' },
+                    location: { anyOf: [LOCATION_SCHEMA, { type: 'null' }] },
+                },
+            },
+        },
+        overall: { type: 'string', enum: ['pass', 'fail'] },
+        summary: { type: 'string' },
+    },
+};
+function client() {
+    if (process.env.ANTHROPIC_API_KEY) {
+        return { client: new sdk_1.default(), model: process.env.VISUAL_QA_CRITIC_MODEL ?? 'claude-opus-5-5', provider: 'anthropic' };
+    }
+    if (process.env.OPENROUTER_API_KEY) {
+        return {
+            client: new sdk_1.default({ apiKey: process.env.OPENROUTER_API_KEY, baseURL: 'https://openrouter.ai/api' }),
+            model: process.env.VISUAL_QA_CRITIC_MODEL ?? 'anthropic/claude-opus-5.5',
+            provider: 'openrouter',
+        };
+    }
+    return null;
+}
+const failAll = (input, model, provider, reason, t0) => ({
+    model,
+    provider,
+    checks: (0, checklists_1.criticChecklistFor)(input.category, input.frames).map((c) => ({ id: c.id, verdict: 'fail', reason })),
+    overall: 'fail',
+    summary: reason,
+    usage: { inputTokens: 0, outputTokens: 0, costUsd: null },
+    durationMs: Date.now() - t0,
+});
+async function runCritic(input) {
+    const t0 = Date.now();
+    const c = client();
+    if (!c)
+        return failAll(input, 'none', 'anthropic', 'critic unavailable: set ANTHROPIC_API_KEY or OPENROUTER_API_KEY', t0);
+    const checklist = (0, checklists_1.criticChecklistFor)(input.category, input.frames);
+    const content = [];
+    for (const f of input.frames) {
+        const bytes = f.bytes ?? (f.data ? Buffer.from(f.data, 'base64') : node_fs_1.default.readFileSync(node_path_1.default.join(input.bundleDir ?? '.', f.file)));
+        content.push({ type: 'text', text: `Frame ${f.id}: ${f.label}${f.subject ? ` (subject ${f.subject})` : ''}` });
+        content.push({ type: 'image', source: { type: 'base64', media_type: 'image/jpeg', data: bytes.toString('base64') } });
+    }
+    content.push({
+        type: 'text',
+        text: [
+            `Item: "${input.title}" — category ${input.category}.`,
+            input.context ?? '',
+            'Checklist (answer every id):',
+            ...checklist.map((k) => `- ${k.id}: ${k.question}`),
+        ].filter(Boolean).join('\n'),
+    });
+    try {
+        const res = await c.client.messages.create({
+            model: c.model,
+            max_tokens: 8000,
+            system: exports.CRITIC_SYSTEM,
+            output_config: { effort: process.env.VISUAL_QA_CRITIC_EFFORT ?? 'low', format: { type: 'json_schema', schema: SCHEMA } },
+            messages: [{ role: 'user', content }],
+        });
+        const usage = res.usage;
+        const costUsd = typeof usage.cost === 'number' ? usage.cost : (usage.input_tokens * 4 + usage.output_tokens * 20) / 1e6;
+        if (res.stop_reason === 'refusal')
+            return { ...failAll(input, c.model, c.provider, 'critic refused the request', t0), usage: { inputTokens: usage.input_tokens, outputTokens: usage.output_tokens, costUsd } };
+        const text = res.content.map((b) => (b.type === 'text' ? b.text : '')).join('');
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            return { ...failAll(input, c.model, c.provider, `critic answer was not valid JSON (stop_reason ${res.stop_reason})`, t0), usage: { inputTokens: usage.input_tokens, outputTokens: usage.output_tokens, costUsd } };
+        }
+        // Fail closed on omissions and on cannot_judge; keep the model's reasons.
+        const byId = new Map(parsed.checks.map((k) => [k.id, k]));
+        const checks = checklist.map((k) => {
+            const got = byId.get(k.id);
+            if (!got)
+                return { id: k.id, verdict: 'fail', reason: 'critic did not answer this check' };
+            // `location` is required by the schema; absent reads as null, present-but-malformed fails the check (as the server does)
+            if (got.location !== undefined && got.location !== null) {
+                const loc = parseCriticLocation(got.location);
+                if (!loc)
+                    return { id: k.id, verdict: 'fail', reason: `critic answered with a malformed location: ${got.reason}` };
+                return { id: got.id, verdict: got.verdict, reason: got.reason, location: loc };
+            }
+            return { id: got.id, verdict: got.verdict, reason: got.reason, location: null };
+        });
+        const allPass = checks.every((k) => k.verdict === 'pass');
+        return {
+            model: c.model,
+            provider: c.provider,
+            checks,
+            overall: allPass && parsed.overall === 'pass' ? 'pass' : 'fail',
+            summary: parsed.summary,
+            usage: { inputTokens: usage.input_tokens, outputTokens: usage.output_tokens, costUsd: +costUsd.toFixed(4) },
+            durationMs: Date.now() - t0,
+        };
+    }
+    catch (error) {
+        return failAll(input, c.model, c.provider, `critic call failed: ${String(error?.message ?? error).slice(0, 300)}`, t0);
+    }
+}
+//# sourceMappingURL=critic.js.map

package/dist/visualQa/critic.js.map

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

package/dist/visualQa/emotePage.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Collects every three.js AnimationMixer the page creates (its constructor assigns `_actionsByClip`), the same
+ * Object.prototype-setter trick browser.ts uses for scenes and cameras. Installed as an extra init script.
+ */
+export declare const MIXER_HOOK = "(() => {\n  if (globalThis.__vqeMixers) return;\n  const list = []; globalThis.__vqeMixers = list;\n  try {\n    Object.defineProperty(Object.prototype, '_actionsByClip', {\n      configurable: true, enumerable: false,\n      set(v) {\n        try { Object.defineProperty(this, '_actionsByClip', { value: v, writable: true, configurable: true, enumerable: true }); } catch (e) {}\n        if (this && typeof this.clipAction === 'function' && !list.includes(this)) list.push(this);\n      },\n      get() { return undefined; },\n    });\n  } catch (e) {}\n})();";
+/**
+ * Installs `globalThis.__vqe` in the frame. Requires INSTALL_SCENE_STATS (commonAsserts.ts) and INSTALL_VIEWER_PAGE
+ * (viewerPage.ts) to be installed first.
+ */
+export declare const INSTALL_EMOTE_PAGE = "globalThis.__vqe = (function () {\n  const r4 = (v) => Math.round(v * 10000) / 10000;\n  const fresh = () => ({ mixer: null, action: null, root: null, meshes: [], restPts: null, restBox: null, restHeight: 0, ptsAt0: null, duration: 0 });\n  /** One state per performer: 'main' (the viewer's body) and 'partner' (the companion body of a two-person emote). */\n  const T = {};\n  let S = fresh();\n  function use(key) { if (!T[key]) return false; S = T[key]; return true; }\n  const scene = () => (globalThis.__vqa && globalThis.__vqa.scene) || null;\n  const chainVisible = (o) => { for (let p = o; p; p = p.parent) if (p.visible === false) return false; return true; };\n  const isUnder = (o, root) => { for (let p = o; p; p = p.parent) if (p === root) return true; return false; };\n\n  /** Every mixer's actions, for the facts. */\n  function inventory() {\n    const out = [];\n    for (const m of (globalThis.__vqeMixers || [])) {\n      const root = m.getRoot && m.getRoot();\n      let skinned = 0; if (root && root.traverse) root.traverse((o) => { if (o.isSkinnedMesh) skinned++; });\n      const acts = [];\n      for (const a of (m._actions || [])) {\n        const c = a.getClip();\n        acts.push({ name: c.name, duration: r4(c.duration), tracks: c.tracks.length, weight: r4(a.getEffectiveWeight()), enabled: a.enabled, paused: a.paused, running: a.isRunning(), time: r4(a.time), loop: a.loop });\n      }\n      out.push({ root: root ? (root.name || root.type) : null, skinned, timeScale: m.timeScale, actions: acts });\n    }\n    return out;\n  }\n\n  /**\n   * Find the action playing the pinned clip: same duration (\u00B10.05 s) and, when several match, the same name, then the\n   * most tracks. Remembers the mixer, the action and the avatar root it drives.\n   */\n  function locate(name, duration, key, notMixer) {\n    let best = null;\n    const taken = new Set(Object.values(T).map((t) => t.mixer));\n    for (const m of (globalThis.__vqeMixers || [])) {\n      if (taken.has(m) && !(T[key] && T[key].mixer === m)) continue;\n      for (const a of (m._actions || [])) {\n        const c = a.getClip();\n        if (Math.abs(c.duration - duration) > 0.05) continue;\n        const score = (c.name === name ? 1000 : 0) + c.tracks.length;\n        if (!best || score > best.score) best = { m, a, score };\n      }\n    }\n    if (!best) return null;\n    key = key || 'main';\n    S = T[key] = fresh();\n    S.duration = best.a.getClip().duration;\n    S.mixer = best.m; S.action = best.a; S.root = best.m.getRoot();\n    S.meshes = []; S.root.traverse((o) => { if (o.isSkinnedMesh && o.geometry) S.meshes.push(o); });\n    return { clip: best.a.getClip().name, duration: r4(best.a.getClip().duration), tracks: best.a.getClip().tracks.length, skinnedMeshes: S.meshes.length, root: S.root.name || S.root.type };\n  }\n\n  /** How many of the clip's tracks resolved to a node of the avatar (an unresolved track animates nothing). */\n  function binding() {\n    const a = S.action; if (!a) return null;\n    const clip = a.getClip();\n    const pms = a._propertyBindings || [];\n    let bound = 0; const unbound = [];\n    for (let i = 0; i < pms.length; i++) {\n      const b = pms[i] && pms[i].binding;\n      if (b && b.node) bound++; else if (unbound.length < 12) unbound.push(clip.tracks[i] ? clip.tracks[i].name : String(i));\n    }\n    // Track data must be finite: a NaN/Infinity key explodes the skin the moment it is sampled.\n    let nonFinite = 0; let quatOff = 0; let maxPos = 0;\n    for (const t of clip.tracks) {\n      const v = t.values; let bad = false;\n      for (let i = 0; i < v.length; i++) { if (!Number.isFinite(v[i])) { bad = true; break; } }\n      if (bad) { nonFinite++; continue; }\n      if (/\\.quaternion$/.test(t.name)) {\n        for (let i = 0; i + 3 < v.length; i += 4) { const l = Math.hypot(v[i], v[i + 1], v[i + 2], v[i + 3]); if (Math.abs(l - 1) > 0.05) { quatOff++; break; } }\n      } else if (/\\.position$/.test(t.name)) {\n        for (let i = 0; i < v.length; i++) maxPos = Math.max(maxPos, Math.abs(v[i]));\n      }\n    }\n    return { tracks: clip.tracks.length, bindings: pms.length, bound, unbound, nonFiniteTracks: nonFinite, unnormalisedQuatTracks: quatOff, maxPositionKey: r4(maxPos) };\n  }\n\n  const meshRef = (m) => {\n    const g = m.geometry; const pos = g.attributes.position; const idx = g.index ? g.index.array : null;\n    const n = idx ? idx.length : pos.count;\n    const start = (g.drawRange && g.drawRange.start) || 0;\n    const count = Math.min(n - start, (g.drawRange && Number.isFinite(g.drawRange.count)) ? g.drawRange.count : n);\n    const used = new Set();\n    if (idx) { for (let k = start; k < start + count; k++) used.add(idx[k]); } else { for (let k = start; k < start + count; k++) used.add(k); }\n    return { m, pos, used: [...used].sort((a, b) => a - b) };\n  };\n\n  /** Fixed-index sample of the drawn vertices (world space). skinned=true applies the CURRENT pose; false = bind pose. */\n  function samplePoints(maxPoints, skinned) {\n    const refs = S.meshes.filter(chainVisible).map(meshRef);\n    let total = 0; for (const r of refs) total += r.used.length;\n    const step = Math.max(1, Math.ceil(total / maxPoints));\n    const out = []; let nonFinite = 0;\n    for (const { m, pos, used } of refs) {\n      const e = m.matrixWorld.elements;\n      const tmp = new (m.position.constructor)();\n      for (let j = 0; j < used.length; j += step) {\n        const i = used[j];\n        let x, y, z;\n        if (skinned) { m.getVertexPosition(i, tmp); x = tmp.x; y = tmp.y; z = tmp.z; } else { x = pos.getX(i); y = pos.getY(i); z = pos.getZ(i); }\n        if (!Number.isFinite(x) || !Number.isFinite(y) || !Number.isFinite(z)) { nonFinite++; out.push(NaN, NaN, NaN); continue; }\n        out.push(e[0] * x + e[4] * y + e[8] * z + e[12], e[1] * x + e[5] * y + e[9] * z + e[13], e[2] * x + e[6] * y + e[10] * z + e[14]);\n      }\n    }\n    return { pts: out, nonFinite };\n  }\n  const boxOf = (pts) => {\n    const mn = [Infinity, Infinity, Infinity], mx = [-Infinity, -Infinity, -Infinity];\n    for (let i = 0; i + 2 < pts.length; i += 3) for (let k = 0; k < 3; k++) { const v = pts[i + k]; if (!Number.isFinite(v)) continue; if (v < mn[k]) mn[k] = v; if (v > mx[k]) mx[k] = v; }\n    if (mn[0] > mx[0]) return null;\n    return { min: mn.map(r4), max: mx.map(r4), size: mx.map((v, k) => r4(v - mn[k])) };\n  };\n\n  /** The avatar's own bind pose: bounds of the geometry as authored, the reference every pose is judged against. */\n  function rest() {\n    const s = scene(); if (s) s.updateMatrixWorld(true);\n    const { pts } = samplePoints(5000, false);\n    S.restPts = pts; S.restBox = boxOf(pts);\n    S.restHeight = S.restBox ? Math.max(S.restBox.size[1], 1e-6) : 0;\n    return { box: S.restBox, height: S.restHeight, skeletonBones: (S.meshes[0] && S.meshes[0].skeleton ? S.meshes[0].skeleton.bones.length : 0) };\n  }\n\n  /** Freeze the page's clock: every mixer stops; on each performer only the pinned clip's action stays on, paused at its own time. */\n  function freeze() {\n    for (const m of (globalThis.__vqeMixers || [])) m.timeScale = 0;\n    for (const key of Object.keys(T)) {\n      const m = T[key].mixer, a = T[key].action;\n      for (const o of (m._actions || [])) { if (o !== a) { o.enabled = false; } }\n      a.enabled = true; a.setEffectiveWeight(1); a.setEffectiveTimeScale(1); a.paused = true;\n    }\n    return Object.keys(T);\n  }\n\n  /** Seek every performer to the same FRACTION of its own clip (no measuring): what a frame shows. */\n  function seekAll(f) {\n    for (const key of Object.keys(T)) { const t = T[key]; t.action.time = f * t.duration; t.mixer.update(0); }\n    const s = scene(); if (s) s.updateMatrixWorld(true);\n    for (const key of Object.keys(T)) for (const mesh of T[key].meshes) if (mesh.skeleton) mesh.skeleton.update();\n    return true;\n  }\n\n  /** Bone names of the performer's skeleton. */\n  function boneNames() { const out = []; for (const m of S.meshes) if (m.skeleton) for (const b of m.skeleton.bones) if (b && b.name && !out.includes(b.name)) out.push(b.name); return out; }\n\n  /** Rotation (degrees) of bone skinning transform i against bind: angle of bindMatrixInverse * (bone.matrixWorld * boneInverse) * bindMatrix. */\n  function skinAngles() {\n    const out = []; const s = scene(); if (s) s.updateMatrixWorld(true);\n    for (const m of S.meshes) {\n      const sk = m.skeleton; if (!sk) continue;\n      const M4 = m.matrixWorld.constructor; const Q = m.quaternion.constructor; const V = m.position.constructor;\n      const bi = m.bindMatrixInverse, bm = m.bindMatrix;\n      const q = new Q(), p = new V(), sc = new V(); const t = new M4();\n      for (let i = 0; i < sk.bones.length; i++) {\n        const bone = sk.bones[i]; if (!bone || !sk.boneInverses[i]) continue;\n        t.multiplyMatrices(bone.matrixWorld, sk.boneInverses[i]); t.premultiply(bi); t.multiply(bm);\n        t.decompose(p, q, sc);\n        const w = Math.min(1, Math.abs(q.w));\n        const ang = 2 * Math.acos(w) * 180 / Math.PI;\n        out.push({ bone: bone.name, deg: Number.isFinite(ang) ? ang : NaN, move: Math.hypot(p.x, p.y, p.z) });\n      }\n    }\n    return out;\n  }\n\n  /** Seek the clip to t seconds and measure the avatar as drawn. */\n  function poseAt(t) {\n    const m = S.mixer, a = S.action; if (!m || !a) return null;\n    a.time = t; m.update(0);\n    const s = scene(); if (s) s.updateMatrixWorld(true);\n    for (const mesh of S.meshes) if (mesh.skeleton) { mesh.skeleton.update(); }\n    const { pts, nonFinite } = samplePoints(5000, true);\n    const box = boxOf(pts);\n    let maxMove = 0; let sumMove = 0; let nMove = 0;\n    if (S.ptsAt0 && S.ptsAt0.length === pts.length) {\n      for (let i = 0; i + 2 < pts.length; i += 3) {\n        const d = Math.hypot(pts[i] - S.ptsAt0[i], pts[i + 1] - S.ptsAt0[i + 1], pts[i + 2] - S.ptsAt0[i + 2]);\n        if (Number.isFinite(d)) { if (d > maxMove) maxMove = d; sumMove += d; nMove++; }\n      }\n    }\n    // Farthest drawn vertex from the avatar's own hips-height centre: an exploded skin throws vertices metres away.\n    const cx = S.restBox ? (S.restBox.min[0] + S.restBox.max[0]) / 2 : 0, cz = S.restBox ? (S.restBox.min[2] + S.restBox.max[2]) / 2 : 0;\n    let far = 0; for (let i = 0; i + 2 < pts.length; i += 3) { const d = Math.hypot(pts[i] - cx, pts[i + 2] - cz); if (Number.isFinite(d) && d > far) far = d; }\n    // Vertex-versus-rest displacement (bind pose) \u2014 how far the pose is from the T/A-pose it started as.\n    let restDisp = 0; let restSum = 0; let restN = 0;\n    if (S.restPts && S.restPts.length === pts.length) {\n      for (let i = 0; i + 2 < pts.length; i += 3) {\n        const d = Math.hypot(pts[i] - S.restPts[i], pts[i + 1] - S.restPts[i + 1], pts[i + 2] - S.restPts[i + 2]);\n        if (Number.isFinite(d)) { if (d > restDisp) restDisp = d; restSum += d; restN++; }\n      }\n    }\n    const angs = skinAngles().map((x) => x.deg).filter(Number.isFinite).sort((x, y) => x - y);\n    const q = (f) => angs.length ? angs[Math.min(angs.length - 1, Math.floor(f * angs.length))] : 0;\n    return { t: r4(t), box, nonFinite, maxMoveFromStart: r4(maxMove), meanMoveFromStart: r4(nMove ? sumMove / nMove : 0),\n      maxFromRest: r4(restDisp), meanFromRest: r4(restN ? restSum / restN : 0), farHorizontal: r4(far),\n      bones: angs.length, angleP50: r4(q(0.5)), angleP90: r4(q(0.9)), angleMax: r4(angs.length ? angs[angs.length - 1] : 0) };\n  }\n\n  /** Remember the pose at t = 0 as the reference for \"how far has it moved\". */\n  function mark0() { const p = poseAt(0); S.ptsAt0 = samplePoints(5000, true).pts; return p; }\n\n  /** Skinned-mesh stats of the avatar as it stands now (materials, textures, drawn bounds) for the shared asserts. */\n  function avatarStats() {\n    const s = scene(); if (s) s.updateMatrixWorld(true);\n    const list = S.meshes.filter(chainVisible);\n    const fake = { updateMatrixWorld() {}, traverse(cb) { for (const m of list) cb(m); } };\n    return globalThis.__vqaStats(fake);\n  }\n\n  /** The page's own \"clip could not be applied\" banner and \"animation unavailable\" states. */\n  function pageNotices() {\n    const t = (document.body && document.body.innerText) || '';\n    return { shownStatic: /Shown static/i.test(t), unavailable: /Animation unavailable/i.test(t), loading: /Loading animation/i.test(t) };\n  }\n\n  return { inventory, locate, use, boneNames, seekAll, binding, rest, freeze, poseAt, mark0, avatarStats, pageNotices,\n    meshCount: () => S.meshes.length, root: () => (S.root ? (S.root.name || S.root.type) : null) };\n})();";

package/dist/visualQa/emotePage.js

@@ -0,0 +1,249 @@
+"use strict";
+// Page-side helpers for the animation (emote) route. Plain JS strings: the CLI compiles without the DOM lib, and these
+// run inside the website's own item-page viewer, where a three.js AnimationMixer plays the emote clip on an avatar.
+//
+// Nothing here changes what the page draws except TIME: the route freezes the mixer and seeks the clip to exact times,
+// so frames and measurements are taken at the clip's start / 25 / 50 / 75 % / end, not at whatever the wall clock says.
+// The numbers come from the live skeleton and the skinned vertices as drawn.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INSTALL_EMOTE_PAGE = exports.MIXER_HOOK = void 0;
+/**
+ * Collects every three.js AnimationMixer the page creates (its constructor assigns `_actionsByClip`), the same
+ * Object.prototype-setter trick browser.ts uses for scenes and cameras. Installed as an extra init script.
+ */
+exports.MIXER_HOOK = `(() => {
+  if (globalThis.__vqeMixers) return;
+  const list = []; globalThis.__vqeMixers = list;
+  try {
+    Object.defineProperty(Object.prototype, '_actionsByClip', {
+      configurable: true, enumerable: false,
+      set(v) {
+        try { Object.defineProperty(this, '_actionsByClip', { value: v, writable: true, configurable: true, enumerable: true }); } catch (e) {}
+        if (this && typeof this.clipAction === 'function' && !list.includes(this)) list.push(this);
+      },
+      get() { return undefined; },
+    });
+  } catch (e) {}
+})();`;
+/**
+ * Installs `globalThis.__vqe` in the frame. Requires INSTALL_SCENE_STATS (commonAsserts.ts) and INSTALL_VIEWER_PAGE
+ * (viewerPage.ts) to be installed first.
+ */
+exports.INSTALL_EMOTE_PAGE = `globalThis.__vqe = (function () {
+  const r4 = (v) => Math.round(v * 10000) / 10000;
+  const fresh = () => ({ mixer: null, action: null, root: null, meshes: [], restPts: null, restBox: null, restHeight: 0, ptsAt0: null, duration: 0 });
+  /** One state per performer: 'main' (the viewer's body) and 'partner' (the companion body of a two-person emote). */
+  const T = {};
+  let S = fresh();
+  function use(key) { if (!T[key]) return false; S = T[key]; return true; }
+  const scene = () => (globalThis.__vqa && globalThis.__vqa.scene) || null;
+  const chainVisible = (o) => { for (let p = o; p; p = p.parent) if (p.visible === false) return false; return true; };
+  const isUnder = (o, root) => { for (let p = o; p; p = p.parent) if (p === root) return true; return false; };
+
+  /** Every mixer's actions, for the facts. */
+  function inventory() {
+    const out = [];
+    for (const m of (globalThis.__vqeMixers || [])) {
+      const root = m.getRoot && m.getRoot();
+      let skinned = 0; if (root && root.traverse) root.traverse((o) => { if (o.isSkinnedMesh) skinned++; });
+      const acts = [];
+      for (const a of (m._actions || [])) {
+        const c = a.getClip();
+        acts.push({ name: c.name, duration: r4(c.duration), tracks: c.tracks.length, weight: r4(a.getEffectiveWeight()), enabled: a.enabled, paused: a.paused, running: a.isRunning(), time: r4(a.time), loop: a.loop });
+      }
+      out.push({ root: root ? (root.name || root.type) : null, skinned, timeScale: m.timeScale, actions: acts });
+    }
+    return out;
+  }
+
+  /**
+   * Find the action playing the pinned clip: same duration (±0.05 s) and, when several match, the same name, then the
+   * most tracks. Remembers the mixer, the action and the avatar root it drives.
+   */
+  function locate(name, duration, key, notMixer) {
+    let best = null;
+    const taken = new Set(Object.values(T).map((t) => t.mixer));
+    for (const m of (globalThis.__vqeMixers || [])) {
+      if (taken.has(m) && !(T[key] && T[key].mixer === m)) continue;
+      for (const a of (m._actions || [])) {
+        const c = a.getClip();
+        if (Math.abs(c.duration - duration) > 0.05) continue;
+        const score = (c.name === name ? 1000 : 0) + c.tracks.length;
+        if (!best || score > best.score) best = { m, a, score };
+      }
+    }
+    if (!best) return null;
+    key = key || 'main';
+    S = T[key] = fresh();
+    S.duration = best.a.getClip().duration;
+    S.mixer = best.m; S.action = best.a; S.root = best.m.getRoot();
+    S.meshes = []; S.root.traverse((o) => { if (o.isSkinnedMesh && o.geometry) S.meshes.push(o); });
+    return { clip: best.a.getClip().name, duration: r4(best.a.getClip().duration), tracks: best.a.getClip().tracks.length, skinnedMeshes: S.meshes.length, root: S.root.name || S.root.type };
+  }
+
+  /** How many of the clip's tracks resolved to a node of the avatar (an unresolved track animates nothing). */
+  function binding() {
+    const a = S.action; if (!a) return null;
+    const clip = a.getClip();
+    const pms = a._propertyBindings || [];
+    let bound = 0; const unbound = [];
+    for (let i = 0; i < pms.length; i++) {
+      const b = pms[i] && pms[i].binding;
+      if (b && b.node) bound++; else if (unbound.length < 12) unbound.push(clip.tracks[i] ? clip.tracks[i].name : String(i));
+    }
+    // Track data must be finite: a NaN/Infinity key explodes the skin the moment it is sampled.
+    let nonFinite = 0; let quatOff = 0; let maxPos = 0;
+    for (const t of clip.tracks) {
+      const v = t.values; let bad = false;
+      for (let i = 0; i < v.length; i++) { if (!Number.isFinite(v[i])) { bad = true; break; } }
+      if (bad) { nonFinite++; continue; }
+      if (/\\.quaternion$/.test(t.name)) {
+        for (let i = 0; i + 3 < v.length; i += 4) { const l = Math.hypot(v[i], v[i + 1], v[i + 2], v[i + 3]); if (Math.abs(l - 1) > 0.05) { quatOff++; break; } }
+      } else if (/\\.position$/.test(t.name)) {
+        for (let i = 0; i < v.length; i++) maxPos = Math.max(maxPos, Math.abs(v[i]));
+      }
+    }
+    return { tracks: clip.tracks.length, bindings: pms.length, bound, unbound, nonFiniteTracks: nonFinite, unnormalisedQuatTracks: quatOff, maxPositionKey: r4(maxPos) };
+  }
+
+  const meshRef = (m) => {
+    const g = m.geometry; const pos = g.attributes.position; const idx = g.index ? g.index.array : null;
+    const n = idx ? idx.length : pos.count;
+    const start = (g.drawRange && g.drawRange.start) || 0;
+    const count = Math.min(n - start, (g.drawRange && Number.isFinite(g.drawRange.count)) ? g.drawRange.count : n);
+    const used = new Set();
+    if (idx) { for (let k = start; k < start + count; k++) used.add(idx[k]); } else { for (let k = start; k < start + count; k++) used.add(k); }
+    return { m, pos, used: [...used].sort((a, b) => a - b) };
+  };
+
+  /** Fixed-index sample of the drawn vertices (world space). skinned=true applies the CURRENT pose; false = bind pose. */
+  function samplePoints(maxPoints, skinned) {
+    const refs = S.meshes.filter(chainVisible).map(meshRef);
+    let total = 0; for (const r of refs) total += r.used.length;
+    const step = Math.max(1, Math.ceil(total / maxPoints));
+    const out = []; let nonFinite = 0;
+    for (const { m, pos, used } of refs) {
+      const e = m.matrixWorld.elements;
+      const tmp = new (m.position.constructor)();
+      for (let j = 0; j < used.length; j += step) {
+        const i = used[j];
+        let x, y, z;
+        if (skinned) { m.getVertexPosition(i, tmp); x = tmp.x; y = tmp.y; z = tmp.z; } else { x = pos.getX(i); y = pos.getY(i); z = pos.getZ(i); }
+        if (!Number.isFinite(x) || !Number.isFinite(y) || !Number.isFinite(z)) { nonFinite++; out.push(NaN, NaN, NaN); continue; }
+        out.push(e[0] * x + e[4] * y + e[8] * z + e[12], e[1] * x + e[5] * y + e[9] * z + e[13], e[2] * x + e[6] * y + e[10] * z + e[14]);
+      }
+    }
+    return { pts: out, nonFinite };
+  }
+  const boxOf = (pts) => {
+    const mn = [Infinity, Infinity, Infinity], mx = [-Infinity, -Infinity, -Infinity];
+    for (let i = 0; i + 2 < pts.length; i += 3) for (let k = 0; k < 3; k++) { const v = pts[i + k]; if (!Number.isFinite(v)) continue; if (v < mn[k]) mn[k] = v; if (v > mx[k]) mx[k] = v; }
+    if (mn[0] > mx[0]) return null;
+    return { min: mn.map(r4), max: mx.map(r4), size: mx.map((v, k) => r4(v - mn[k])) };
+  };
+
+  /** The avatar's own bind pose: bounds of the geometry as authored, the reference every pose is judged against. */
+  function rest() {
+    const s = scene(); if (s) s.updateMatrixWorld(true);
+    const { pts } = samplePoints(5000, false);
+    S.restPts = pts; S.restBox = boxOf(pts);
+    S.restHeight = S.restBox ? Math.max(S.restBox.size[1], 1e-6) : 0;
+    return { box: S.restBox, height: S.restHeight, skeletonBones: (S.meshes[0] && S.meshes[0].skeleton ? S.meshes[0].skeleton.bones.length : 0) };
+  }
+
+  /** Freeze the page's clock: every mixer stops; on each performer only the pinned clip's action stays on, paused at its own time. */
+  function freeze() {
+    for (const m of (globalThis.__vqeMixers || [])) m.timeScale = 0;
+    for (const key of Object.keys(T)) {
+      const m = T[key].mixer, a = T[key].action;
+      for (const o of (m._actions || [])) { if (o !== a) { o.enabled = false; } }
+      a.enabled = true; a.setEffectiveWeight(1); a.setEffectiveTimeScale(1); a.paused = true;
+    }
+    return Object.keys(T);
+  }
+
+  /** Seek every performer to the same FRACTION of its own clip (no measuring): what a frame shows. */
+  function seekAll(f) {
+    for (const key of Object.keys(T)) { const t = T[key]; t.action.time = f * t.duration; t.mixer.update(0); }
+    const s = scene(); if (s) s.updateMatrixWorld(true);
+    for (const key of Object.keys(T)) for (const mesh of T[key].meshes) if (mesh.skeleton) mesh.skeleton.update();
+    return true;
+  }
+
+  /** Bone names of the performer's skeleton. */
+  function boneNames() { const out = []; for (const m of S.meshes) if (m.skeleton) for (const b of m.skeleton.bones) if (b && b.name && !out.includes(b.name)) out.push(b.name); return out; }
+
+  /** Rotation (degrees) of bone skinning transform i against bind: angle of bindMatrixInverse * (bone.matrixWorld * boneInverse) * bindMatrix. */
+  function skinAngles() {
+    const out = []; const s = scene(); if (s) s.updateMatrixWorld(true);
+    for (const m of S.meshes) {
+      const sk = m.skeleton; if (!sk) continue;
+      const M4 = m.matrixWorld.constructor; const Q = m.quaternion.constructor; const V = m.position.constructor;
+      const bi = m.bindMatrixInverse, bm = m.bindMatrix;
+      const q = new Q(), p = new V(), sc = new V(); const t = new M4();
+      for (let i = 0; i < sk.bones.length; i++) {
+        const bone = sk.bones[i]; if (!bone || !sk.boneInverses[i]) continue;
+        t.multiplyMatrices(bone.matrixWorld, sk.boneInverses[i]); t.premultiply(bi); t.multiply(bm);
+        t.decompose(p, q, sc);
+        const w = Math.min(1, Math.abs(q.w));
+        const ang = 2 * Math.acos(w) * 180 / Math.PI;
+        out.push({ bone: bone.name, deg: Number.isFinite(ang) ? ang : NaN, move: Math.hypot(p.x, p.y, p.z) });
+      }
+    }
+    return out;
+  }
+
+  /** Seek the clip to t seconds and measure the avatar as drawn. */
+  function poseAt(t) {
+    const m = S.mixer, a = S.action; if (!m || !a) return null;
+    a.time = t; m.update(0);
+    const s = scene(); if (s) s.updateMatrixWorld(true);
+    for (const mesh of S.meshes) if (mesh.skeleton) { mesh.skeleton.update(); }
+    const { pts, nonFinite } = samplePoints(5000, true);
+    const box = boxOf(pts);
+    let maxMove = 0; let sumMove = 0; let nMove = 0;
+    if (S.ptsAt0 && S.ptsAt0.length === pts.length) {
+      for (let i = 0; i + 2 < pts.length; i += 3) {
+        const d = Math.hypot(pts[i] - S.ptsAt0[i], pts[i + 1] - S.ptsAt0[i + 1], pts[i + 2] - S.ptsAt0[i + 2]);
+        if (Number.isFinite(d)) { if (d > maxMove) maxMove = d; sumMove += d; nMove++; }
+      }
+    }
+    // Farthest drawn vertex from the avatar's own hips-height centre: an exploded skin throws vertices metres away.
+    const cx = S.restBox ? (S.restBox.min[0] + S.restBox.max[0]) / 2 : 0, cz = S.restBox ? (S.restBox.min[2] + S.restBox.max[2]) / 2 : 0;
+    let far = 0; for (let i = 0; i + 2 < pts.length; i += 3) { const d = Math.hypot(pts[i] - cx, pts[i + 2] - cz); if (Number.isFinite(d) && d > far) far = d; }
+    // Vertex-versus-rest displacement (bind pose) — how far the pose is from the T/A-pose it started as.
+    let restDisp = 0; let restSum = 0; let restN = 0;
+    if (S.restPts && S.restPts.length === pts.length) {
+      for (let i = 0; i + 2 < pts.length; i += 3) {
+        const d = Math.hypot(pts[i] - S.restPts[i], pts[i + 1] - S.restPts[i + 1], pts[i + 2] - S.restPts[i + 2]);
+        if (Number.isFinite(d)) { if (d > restDisp) restDisp = d; restSum += d; restN++; }
+      }
+    }
+    const angs = skinAngles().map((x) => x.deg).filter(Number.isFinite).sort((x, y) => x - y);
+    const q = (f) => angs.length ? angs[Math.min(angs.length - 1, Math.floor(f * angs.length))] : 0;
+    return { t: r4(t), box, nonFinite, maxMoveFromStart: r4(maxMove), meanMoveFromStart: r4(nMove ? sumMove / nMove : 0),
+      maxFromRest: r4(restDisp), meanFromRest: r4(restN ? restSum / restN : 0), farHorizontal: r4(far),
+      bones: angs.length, angleP50: r4(q(0.5)), angleP90: r4(q(0.9)), angleMax: r4(angs.length ? angs[angs.length - 1] : 0) };
+  }
+
+  /** Remember the pose at t = 0 as the reference for "how far has it moved". */
+  function mark0() { const p = poseAt(0); S.ptsAt0 = samplePoints(5000, true).pts; return p; }
+
+  /** Skinned-mesh stats of the avatar as it stands now (materials, textures, drawn bounds) for the shared asserts. */
+  function avatarStats() {
+    const s = scene(); if (s) s.updateMatrixWorld(true);
+    const list = S.meshes.filter(chainVisible);
+    const fake = { updateMatrixWorld() {}, traverse(cb) { for (const m of list) cb(m); } };
+    return globalThis.__vqaStats(fake);
+  }
+
+  /** The page's own "clip could not be applied" banner and "animation unavailable" states. */
+  function pageNotices() {
+    const t = (document.body && document.body.innerText) || '';
+    return { shownStatic: /Shown static/i.test(t), unavailable: /Animation unavailable/i.test(t), loading: /Loading animation/i.test(t) };
+  }
+
+  return { inventory, locate, use, boneNames, seekAll, binding, rest, freeze, poseAt, mark0, avatarStats, pageNotices,
+    meshCount: () => S.meshes.length, root: () => (S.root ? (S.root.name || S.root.type) : null) };
+})();`;
+//# sourceMappingURL=emotePage.js.map

package/dist/visualQa/emotePage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emotePage.js","sourceRoot":"","sources":["../../src/visualQa/emotePage.ts"],"names":[],"mappings":";AAAA,uHAAuH;AACvH,oHAAoH;AACpH,EAAE;AACF,uHAAuH;AACvH,wHAAwH;AACxH,6EAA6E;;;AAE7E;;;GAGG;AACU,QAAA,UAAU,GAAG;;;;;;;;;;;;;MAapB,CAAC;AAEP;;;GAGG;AACU,QAAA,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAwN5B,CAAC"}

package/dist/visualQa/evidenceOverlay.d.ts

@@ -0,0 +1,74 @@
+import type { Vec3 } from './vehicleMath';
+export interface Overlay {
+    polys: Array<{
+        pts: Vec3[];
+        fill: string;
+        opacity: number;
+        stroke?: string;
+    }>;
+    lines: Array<{
+        pts: Vec3[];
+        stroke: string;
+        width: number;
+    }>;
+    dots: Array<{
+        p: Vec3;
+        r: number;
+        fill: string;
+    }>;
+    legend: Array<{
+        colour: string;
+        text: string;
+    }>;
+}
+export declare const emptyOverlay: () => Overlay;
+/** Penetration: the cluster's points red over the clashing mesh's triangles within `reach` of the clash, translucent cyan. */
+export declare function penetrationOverlay(points: Vec3[], centroid: Vec3, cabin: {
+    tris: ArrayLike<number>;
+    mesh: ArrayLike<number>;
+    names: string[];
+} | null, meshName: string | null, legend: {
+    body: string;
+    mesh: string;
+}, reach?: number, maxTris?: number): Overlay;
+/**
+ * Wheel cross-section: the tyre circle at its centre plane, the body's section in the plane across the tread where it
+ * reaches deepest into the tyre, and, per 2 degree sector, the part of the tyre the body reaches into in ANY of five
+ * planes across the tread (the arch lip intrudes at the outer shoulder, not at the centre plane), filled red: from the
+ * body's innermost point (outside the rim barrel) out to the tyre's radius. Returns the overlay and the deepest intrusion.
+ */
+export declare function wheelSectionOverlay(centre: Vec3, axle: Vec3, radius: number, bodyTris: ArrayLike<number>, hubZoneFraction?: number, legend?: {
+    tyre: string;
+    body: string;
+    overlap: string;
+}, width?: number): {
+    overlay: Overlay;
+    maxIntrusionM: number;
+    sectors: number;
+};
+/** Every 3D point an overlay needs projected, flat, in a fixed order (see `renderOverlay`). */
+export declare function overlayPoints(o: Overlay): number[];
+export interface Projection {
+    /** NDC x, y, z per overlay point, in `overlayPoints` order. */
+    ndc: number[];
+    /** The canvas rect inside its frame, and the frame's offset in the page (CSS px). */
+    rect: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    frameOffset: {
+        x: number;
+        y: number;
+    };
+    /** Captured image px per CSS px. */
+    scale: number;
+}
+/** The overlay as an SVG of the captured image's size. Points behind the camera are dropped (and polys touching them). */
+export declare function overlaySvg(o: Overlay, pr: Projection, width: number, height: number): string;
+/** Draw the overlay onto the captured JPEG in place. Returns how many of its points landed in front of the camera. */
+export declare function annotateFrame(file: string, o: Overlay, pr: Projection): Promise<{
+    drawn: number;
+    total: number;
+}>;