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

package/dist/visualQa/checklists.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORLD_WALK_CRITIC_CHECKS = exports.WALK_FRAME_PREFIX = exports.VEHICLE_OCCUPANT_CRITIC_CHECKS = exports.OCCUPANT_FRAME_PREFIX = exports.CRITIC_CHECKLISTS = exports.WORLD_WALK_REQUIRED_ASSERTS = exports.REQUIRED_ASSERTS = exports.COMMON_REQUIRED_ASSERTS = void 0;
+exports.requiredAssertsFor = requiredAssertsFor;
+exports.criticChecklistFor = criticChecklistFor;
+exports.COMMON_REQUIRED_ASSERTS = ['frame.non_empty', 'scene.no_nan_or_invisible', 'render.textured', 'scale.sane_for_category'];
+exports.REQUIRED_ASSERTS = {
+    vehicle: [
+        'vehicle.wheels.at_hubs',
+        'vehicle.wheels.arch_clearance',
+        'vehicle.wheels.spin_with_speed',
+        'vehicle.steering.wheel_rotates',
+        'vehicle.articulation.reaches_limits',
+        'vehicle.seats.addressable',
+        'vehicle.drive.responds_with_audio',
+        ...exports.COMMON_REQUIRED_ASSERTS,
+    ],
+    'vehicle-addon': ['addon.at_socket', ...exports.COMMON_REQUIRED_ASSERTS],
+    'character-addon': ['addon.at_socket', 'wear.on_body_bounds', 'wear.not_floating', ...exports.COMMON_REQUIRED_ASSERTS],
+    wearable: ['wear.on_body_bounds', 'wear.not_floating', ...exports.COMMON_REQUIRED_ASSERTS],
+    avatar: [
+        'avatar.skinned',
+        'avatar.grounded',
+        'avatar.materials_resolved',
+        'avatar.no_emissive_washout',
+        'avatar.colour_matches_albedo',
+        'avatar.limbs_untwisted',
+        'avatar.skin_intact',
+        // avatar@3: the Marketplace preview walk (avatarPreview.ts)
+        'avatar.preview.arms_clear',
+        'avatar.preview.surface_closed',
+        'avatar.preview.silhouette',
+        'avatar.preview.posture',
+        'avatar.mesh.no_strands',
+        'avatar.bind_pose',
+        ...exports.COMMON_REQUIRED_ASSERTS,
+    ],
+    animation: [
+        'anim.clip.bound',
+        'anim.skeleton.animates',
+        'anim.not_t_pose',
+        'anim.no_nan',
+        'anim.bounds_sane',
+        'anim.root_grounded',
+        ...exports.COMMON_REQUIRED_ASSERTS,
+    ],
+    scene: [
+        'scene.identity',
+        'scene.spawn_valid',
+        'scene.bounds_plausible',
+        'scene.walkable',
+        ...exports.COMMON_REQUIRED_ASSERTS,
+    ],
+    prop: [...exports.COMMON_REQUIRED_ASSERTS],
+};
+/**
+ * Measured during the world walk (wearables, character add-ons, avatars; per base). The backend requires them behind its
+ * `VISUAL_QA_WORLD_WALK` flag; with `worldWalk: true` this local copy does the same (`requiredAssertsFor`).
+ *
+ * Not for avatars (avatar@3): a single-surface avatar has no garment/body pair for them to measure, and reporting that as
+ * a pass is how Cream Hoodie Anime Girl 1.0.6 passed with a torn hoodie. They are now "not measured" (warn) there, and the
+ * avatar's own required asserts measure the same defects on any avatar (avatar.preview.surface_closed / arms_clear). A
+ * layered avatar's measured wear.walk asserts still block when they fail.
+ */
+exports.WORLD_WALK_REQUIRED_ASSERTS = ['wear.walk.no_holes', 'wear.walk.no_poke_through'];
+const WORLD_WALK_CATEGORIES = new Set(['wearable', 'character-addon', 'avatar']);
+const WORLD_WALK_REQUIRED_CATEGORIES = new Set(['wearable', 'character-addon']);
+/** The required asserts for a category; with `worldWalk`, the walk asserts too for the categories that are worn. */
+function requiredAssertsFor(category, opts = {}) {
+    const base = exports.REQUIRED_ASSERTS[category];
+    return opts.worldWalk && WORLD_WALK_REQUIRED_CATEGORIES.has(category) ? [...base, ...exports.WORLD_WALK_REQUIRED_ASSERTS] : base;
+}
+const COMMON = [
+    { id: 'item.matches_title', question: "What the frames show is recognisably the thing the item's title and category name, with every defining feature the title names present in its SHAPE, not only painted on as a texture: 'Pumps' and 'Thick Heel' shoes have a raised heel (flat slippers are not pumps), 'Wedge Sandals' a wedge sole, 'Calf Slouch Boots' reach the calf and slouch, 'Curly' or 'Afro' hair has a voluminous silhouette whose curls break its outline and a natural hairline (a smooth helmet- or cap-like shell with a hard, flat lower edge and curls only drawn on its surface is not curly hair), a 'Wedding Dress' reads as a wedding dress. Fail when it is a different kind of thing or lacks a feature the title names. A title written as a slug (lowercase words, dashes, a number) still names the thing: judge it by its words. Colours, materials and styling the title does not name are the creator's choice." },
+    { id: 'frame.nonempty', question: 'The item is clearly visible; no frame is blank, black, white-out, or shows only the environment.' },
+    { id: 'render.textured', question: 'Surfaces render with materials and lighting; nothing shows magenta or checkerboard missing-texture, pure black, or the default untextured white/grey of a placeholder. Deliberate flat colours (a tan table, a green plant) are fine.' },
+    { id: 'render.intact', question: 'No missing parts, holes, inside-out faces, exploded or stretched geometry, jagged spikes or torn edges, flickering bands, or stray fragments away from the item. Simple or blocky modelling by design is not a defect.' },
+    { id: 'scale.plausible', question: "The item's size looks right for what it is relative to its surroundings (ground, character, vehicle)." },
+];
+const VEHICLE = [
+    { id: 'vehicle.wheels.seated', question: 'Every wheel sits centred in its wheel arch at its corner, tyre on the ground, with visible tyre-to-arch clearance. No wheel is sunk or tucked deep into the body, clipping through bodywork, sticking out beyond it, or floating.' },
+    { id: 'vehicle.wheels.count', question: "One wheel at every corner/axle position; none missing; no extra or stray wheel elsewhere (e.g. under the car's centre)." },
+    { id: 'vehicle.ride_height', question: 'The body sits at a plausible ride height for this kind of vehicle: not touching or sunk into the ground, not hovering.' },
+    { id: 'vehicle.symmetry', question: 'Left and right sides match: doors, mirrors, wheels, lamps.' },
+    { id: 'vehicle.cabin', question: 'The interior frame shows seats, steering wheel and dashboard in place, and nothing blocks the view (black bands, back faces).' },
+    { id: 'vehicle.articulation', question: 'Each opened door or lid is swung open on a plausible hinge and still attached to the body. (Clear or wound-down glass is not a defect.)' },
+    { id: 'vehicle.steering', question: 'The steering frame shows the front wheels turned and the steering wheel rotated.' },
+    { id: 'vehicle.motion', question: 'In the moving frame the vehicle is upright on its wheels on the ground.' },
+];
+const VEHICLE_ADDON = [
+    { id: 'addon.placement', question: "The part is mounted where it belongs on the host (wheels at every hub, a wing on the rear deck/lid, an exhaust at the rear), not floating, not at the host's centre/origin or under it, not several copies stacked in one spot." },
+    { id: 'addon.fit', question: 'The part fits the host: no large gaps, no deep clipping, correct orientation and scale.' },
+    { id: 'addon.replaces', question: 'Where the part replaces a stock part (wheels, exhaust, bumper), the stock part is hidden and does not show through.' },
+];
+const WEAR = [
+    { id: 'wear.on_body', question: 'The item sits on the body where it belongs (ears on the head, shoes on the feet, a shirt on the torso) and follows it; not floating, not at the feet/origin, not offset.' },
+    { id: 'wear.size', question: 'The item is the right size for the body and slot — not a tiny lump, not a giant shell.' },
+    { id: 'wear.clipping', question: 'No large body poke-through, and no holes or see-through openings where the body is hidden but the item does not cover it.' },
+    { id: 'wear.each_base', question: "On every base shown, the item fits that base's proportions." },
+];
+const AVATAR = [
+    { id: 'avatar.skinning', question: 'In every pose shown (standing turnaround and the walking frames) the body stays whole and proportioned: head, torso, arms, hands, legs and feet are connected, with no stretched or spiky polygons, torn joints, collapsed limbs, or parts left behind or detached when it moves.' },
+    { id: 'avatar.stance', question: 'The avatar stands upright on the ground with its feet planted and facing the front view; it is not floating, sunk into the floor, tilted, or facing backwards.' },
+    { id: 'avatar.textures', question: "Compare the lit frames with the frame captioned 'Reference: unlit base colour': the avatar's surfaces show the same colours, patterns and texture detail (face, eyes, hair colour, clothing print and seams) under lighting. Fail if the avatar or any part of it renders flat white, glowing or washed out, uniform grey, black, or clearly different colours from the reference, or if one part is untextured while the rest is textured." },
+    { id: 'avatar.rig_distortion', question: "In the walking frames and the frames captioned 'stride' (the walk frozen mid-step), every limb bends naturally: knees bend forward, feet point in the direction of travel, elbows bend the right way, and no arm, leg, wrist, ankle, neck or waist is twisted around its own axis, pinched thin like a wrung cloth (candy-wrapper), turned backwards or sideways, or stretched. Fail on any twisted or wrongly bending limb even if the rest of the body looks right." },
+    { id: 'avatar.walk_preview', question: "In the frames captioned 'Marketplace walk preview' (the item page's walk, paused with an arm swung fully back, seen from the true left side, the true right side and the back): hair, clothing and accessories drape and follow the body; arms and hands stay outside the torso and hips; the surface is closed. Fail if hair, cloth or a strand stands stiffly away from the body like a rigid slab or sticks out, if a forearm or hand is sunk inside the torso, hips or a pocket, if a hole, slit or see-through gap opens in the clothing or skin where a limb swings, or if the head hangs forward or down unnaturally. These are defects even though they appear only in this pose: the walk is what buyers see. Natural differences that follow the clip (arm swing height, stride length) and a stylised or robot body's own proportions are not defects." },
+];
+const PROP = [
+    { id: 'prop.grounded', question: 'The prop stands in its natural upright orientation with a level base; not tilted, upside-down, or rotated wrongly. The item viewer may show no floor; then judge orientation and a level base only.' },
+];
+const ANIMATION = [
+    { id: 'anim.pose_changes', question: 'The clip is really posing the body. Across the frames (start, 25%, 50%, 75%, end) the body either visibly moves between frames, or holds ONE deliberate pose (sitting, lying down, a standing idle or a stance) that is clearly not the stiff default T-pose or A-pose of an unanimated body. A held pose with little or no change between frames is NOT a failure. Fail only if every frame shows the same stiff default T-pose/A-pose.' },
+    { id: 'anim.body_intact', question: 'In every frame the body stays whole and proportioned: head, torso, arms, hands, legs and feet are connected, with no stretched or spiky polygons, torn joints, twisted or inside-out limbs, collapsed or exploded geometry.' },
+    { id: 'anim.grounded', question: 'The body is plausibly placed relative to the ground: feet planted, or deliberately lifted (a jump), sitting or lying down. No chair, bed or other prop is drawn for a sitting or lying emote, and that is expected: judge the posture alone, not the missing furniture. Fail only if the body is buried in the floor, flung far from where it started, or held in a balance no body could hold.' },
+    { id: 'anim.each_base', question: 'On both bodies shown (Base Male and Base Female) the same motion reads correctly and fits the body: hands meet where they should, limbs do not pass through the torso or head.' },
+];
+const SCENE = [
+    { id: 'scene.complete', question: 'The place reads as a complete, finished space: walls, floors, roofs, windows and doors are present and connected (furniture is not expected: Homes are shown empty); no missing wall or floor sections, no holes in the shell showing the void, no floating or detached chunks.' },
+    { id: 'scene.interior', question: 'Interior views show rooms with floors, walls and ceilings; nothing is blacked out, looked at through back faces (inside-out), or flickering with overlapping surfaces. Homes are shown EMPTY (unfurnished) by design, so bare rooms, plain painted walls and empty floors are normal and NOT a failure; fixed furniture and fittings that the scene does include should look right.' },
+    { id: 'scene.grounded', question: 'The building and its props sit on the ground or terrain: not floating above it, sunk deep into it, tilted, or intersecting the terrain in an obvious way. The visitor stands on a floor, not inside geometry or in the void.' },
+    { id: 'scene.lighting', question: 'Lighting is plausible: not pitch black, not blown out white, no large black voids or hard-edged light leaks; materials are lit and legible.' },
+];
+exports.CRITIC_CHECKLISTS = {
+    vehicle: [...COMMON, ...VEHICLE],
+    'vehicle-addon': [...COMMON, ...VEHICLE_ADDON],
+    'character-addon': [...COMMON, ...WEAR],
+    wearable: [...COMMON, ...WEAR],
+    avatar: [...COMMON, ...AVATAR],
+    animation: [...COMMON, ...ANIMATION],
+    scene: [...COMMON, ...SCENE],
+    prop: [...COMMON, ...PROP],
+};
+/** Frame id prefix of the seated-occupant frames the vehicle route takes. Mirrors the backend's `OCCUPANT_FRAME_PREFIX`. */
+exports.OCCUPANT_FRAME_PREFIX = 'occupant.';
+/** Asked only when the bundle carries occupant frames (the backend does the same; this copy is for local dry runs). */
+exports.VEHICLE_OCCUPANT_CRITIC_CHECKS = [
+    { id: 'vehicle.occupant.head_clearance', question: 'In the occupant frames (side, head_roof, door_open, cutaway) every seated person has visible clearance between the top of the head (hair or hat included) and the roof, headliner or window frame. No part of the head pokes through the roof, headliner or pillar, and the head is not jammed flat against it.' },
+    { id: 'vehicle.occupant.seat_contact', question: 'In the occupant frames (cutaway, hips, door_open) every seated person sits ON the seat: pelvis and thighs rest on the cushion and the back against the backrest. They do not sink visibly into the cushion or backrest, do not hover above the seat, and are not detached from it or offset to one side. (Frames captioned "door panel hidden" are a deliberate cutaway, not a defect.)' },
+    { id: 'vehicle.occupant.no_clipping', question: 'In the occupant frames no part of any occupant (head, shoulders, arms, hands, hips, legs, feet) visibly passes through the seat, dashboard, door, pillar, console, floor or roof. Feet rest on the floor or on the pedals; they are not sunk into the floor or cut off at the ankle, and not hanging in mid air.' },
+    { id: 'vehicle.occupant.hands_on_wheel', question: 'In the frames of the occupant captioned "(driver)" both hands hold the steering wheel rim: not floating away from it, not pushed through the dash or the wheel hub, not resting in the lap.' },
+];
+/** Frame id prefix of the world-walk frames (`walk.<view>.<subject>`: front, side, back, turn, close; group `walk`). */
+exports.WALK_FRAME_PREFIX = 'walk.';
+/** Asked only when the bundle carries world-walk frames (mirrors the backend's walk questions; this copy is for local dry runs). */
+exports.WORLD_WALK_CRITIC_CHECKS = [
+    { id: 'wear.walk.covered', question: "In the frames captioned 'walking' and 'turning' (the walk held mid-stride), the item still covers what it covers standing still: no hole, tear or see-through opening appears in it as the legs and arms move (a skirt or gown splitting open, a gap opening at the waist, hips or shoulders through which the background or the inside of the item shows), and no part of the body it covers goes missing (a leg vanishing inside a gown, leaving a foot floating on its own)." },
+    { id: 'wear.walk.follows', question: "In the frames captioned 'walking' and 'turning', no part of the body (feet, toes, knees, thighs, hips, hands, elbows, shoulders) pokes out through the item, and the item moves with the body: it is not left behind, stretched into spikes or long strands, or detached from the body as it moves." },
+];
+/** The checklist for a bundle: the category's list, plus the occupant checks for a vehicle that carries occupant frames,
+ *  plus the walk checks when it carries world-walk frames. */
+function criticChecklistFor(category, frames) {
+    let list = exports.CRITIC_CHECKLISTS[category];
+    const fs = frames ?? [];
+    if (category === 'vehicle' && fs.some((f) => f.id.startsWith(exports.OCCUPANT_FRAME_PREFIX)))
+        list = [...list, ...exports.VEHICLE_OCCUPANT_CRITIC_CHECKS];
+    if (WORLD_WALK_CATEGORIES.has(category) && fs.some((f) => f.id.startsWith(exports.WALK_FRAME_PREFIX)))
+        list = [...list, ...exports.WORLD_WALK_CRITIC_CHECKS];
+    return list;
+}
+//# sourceMappingURL=checklists.js.map

package/dist/visualQa/checklists.js.map

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

package/dist/visualQa/command.d.ts

@@ -0,0 +1,110 @@
+import { type CandidateConfig } from './candidate';
+import { type ResolvedItem } from './resolve';
+import { type VisualQaAssert, type VisualQaBundle, type VisualQaCriticResult, type VisualQaVerdict } from './types';
+export declare const HARNESS_REVISION = "vqa-1";
+export interface VisualQaOptions {
+    apiBase: string;
+    webBase: string;
+    token?: string | null;
+    out?: string;
+    storageState?: string;
+    hostIds?: string[];
+    chrome?: string;
+    submit?: boolean;
+    localCritic?: boolean;
+    cliVersion: string;
+    quiet?: boolean;
+    /** Hosted runner: submit against this job's lease (`?jobId=&leaseToken=`) instead of as a plain creator run. A run
+     *  with harness errors is NOT submitted — the caller reports it with the job's `/fail` so the job is retried. */
+    lease?: {
+        jobId: string;
+        leaseToken: string;
+    };
+    /** Hosted runner: called once the item is resolved, before anything is rendered; throw to stop (e.g. version moved). */
+    onResolved?: (resolved: ResolvedItem) => void;
+    /** Do not wait for the CDN mirror to serve the pinned model before rendering (specs; a harness that serves its own bytes). */
+    skipMirrorWait?: boolean;
+    /** Render THIS version of the item's pinned package instead of the pin (`--package-version`): a version move judged
+     *  before the pointer moves. Equal to the pin = the normal run. */
+    packageVersion?: string | null;
+    /** Vehicles, with `packageVersion`: the version move's vehicle package, served by Try Now after server-side preparation. */
+    vehiclePackage?: Record<string, unknown> | null;
+    /** The world-walk stage (wearables, character add-ons, avatars). False = skip it (`--no-world-walk`). Default on. */
+    worldWalk?: boolean;
+}
+export interface VisualQaOutcome {
+    verdict: VisualQaVerdict;
+    reasons: string[];
+    bundleDir: string;
+    bundle: VisualQaBundle;
+    critic: VisualQaCriticResult | null;
+    contactSheet: string | null;
+    /** Set when a version the item is not pinned to yet was rendered (`--package-version`). */
+    candidate?: {
+        currentVersion: string | null;
+    } | null;
+    server?: {
+        runId?: string;
+        verdict?: VisualQaVerdict;
+        contactSheetUrl?: string;
+        reasons?: string[];
+        hostedJob?: unknown;
+    } | null;
+    /** Why a requested submit did not happen (hosted runner reads this to call `/fail`). */
+    submitSkipped?: 'exempt' | 'no_frames' | 'harness_errors';
+    timings: {
+        renderMs: number;
+        criticMs: number;
+        submitMs: number;
+        totalMs: number;
+    };
+}
+/** The local verdict rule — identical to the backend's: no harness errors, every required assert present and
+ *  passing, and (when a critic ran) every critic check passing. */
+export declare function deriveVerdict(category: VisualQaBundle['item']['category'], asserts: VisualQaAssert[], errors: string[], critic: VisualQaCriticResult | null): {
+    verdict: VisualQaVerdict;
+    reasons: string[];
+};
+/** What the critic cannot see in a frame but must know: the measured size (a prop viewer has no ground or person
+ *  for scale) and which host/base each frame shows, and that only this one part is fitted. */
+/** Errors that mean the BROWSER failed (renderer crash, frame torn down), not the item: the route is retried once. */
+export declare const BROWSER_CRASH_RE: RegExp;
+/** How long one render (the attempt plus its crash retry) may run before the harness aborts its own browsers and reports a
+ *  harness error. The hosted runner already sets its own (possibly shorter) deadline around the whole render; this backstops
+ *  the local CLI so a hung Chromium (e.g. a browser-slot wait on a loaded box) never sits silent with an empty bundle. */
+export declare function renderWatchdogMs(env?: NodeJS.ProcessEnv): number;
+export declare function criticContext(bundle: VisualQaBundle): string;
+export type RouteName = 'vehicle' | 'avatar' | 'viewer' | 'animation' | 'scene';
+/** Which render route judges a category. Whole vehicles and whole avatars are rendered in the hosted test grounds (Try Now). An
+ *  emote has no body of its own (it is played on the base bodies on its item page) and a scene is walked through the way a
+ *  visitor does (the Home preview), so neither can use the prop viewer; the rest use the customiser / item viewer. */
+export declare function routeFor(category: VisualQaBundle['item']['category']): RouteName;
+/**
+ * Point the runtime at a candidate version and collect what it was served. Try Now categories must see a
+ * `trial.candidate` that matches the sealed version (it also completes the identity: version row id, and for a vehicle
+ * the checksum the server minted); customiser categories must have had their add-ons list and the add-on's own item
+ * read rewritten, and any version those name must be the candidate. Anything else is a harness error: a candidate run
+ * never silently renders the current version.
+ */
+export declare function candidateWatch(resolved: ResolvedItem, token?: string | null, opts?: {
+    worldWalk?: boolean;
+    apiBase?: string;
+    webBase?: string;
+}): {
+    config: CandidateConfig;
+    finish(): {
+        errors: string[];
+        facts: Record<string, unknown>;
+    };
+};
+/** Thrown when the backend will not serve this login a version the item is not pinned to: a refusal, not a harness
+ *  error, and it is decided before any browser starts. */
+export declare class CandidateRefusedError extends Error {
+}
+/** Ask the backend, before rendering, whether this login may see the candidate (the add-on/item preview read has the
+ *  same creator / admin / leased-runner rule as Try Now). A refusal surfaces first and alone instead of after a
+ *  browser launch as one of several harness errors. */
+export declare function assertCandidateAllowed(apiBase: string, itemId: string, version: string, token: string | null): Promise<void>;
+/** The account's own copy of the item (inventory instance id), or null. Best effort: no copy = a normal Try Now. */
+export declare function ownedInstanceOf(apiBase: string, itemId: string, token: string): Promise<string | null>;
+export declare function runVisualQa(itemId: string, opts: VisualQaOptions): Promise<VisualQaOutcome>;