@hypersoniclabs/helix-cli 0.1.27-helix3.690 → 0.1.27-helix3.692

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -74,7 +74,7 @@ The token is stored in `~/.helix/credentials.json` (mode `600`). It's sent as
74
74
  | `helix item list-slots [--json]` | Print the Character-Creator vocabulary a wearable declares: the cosmetic slot tags, and the genders. |
75
75
 
76
76
  | `helix item distribution create\|list\|update\|disable …` | Manage Marketplace/World Claim or Buy routes without republishing the item or paying another publish fee. |
77
- | `helix item visual-qa <item-id> [--submit] [--local-critic] [--storage-state <file>] [--host <id…>]` | Render the item's current package version headless in the real runtime (test-grounds world for vehicles and whole avatars, the customiser for add-ons and wearables on every declared host/base, the item viewer for props), measure it, and with `--submit` record the backend's verdict (numeric asserts + vision critic) against that exact version. **The visual check is advisory: it records notes with fix hints and never gates listing, distributions or version moves. Only a technical failure (an unusable file, with its plain reason) or content safety blocks.** See [docs/visual-qa.md](docs/visual-qa.md). |
77
+ | `helix item visual-qa <item-id> [--submit] [--local-critic] [--storage-state <file>] [--host <id…>]` | Render the item's current package version headless in the real runtime (test-grounds world for vehicles and whole avatars, the customiser for add-ons and wearables on every declared host/base, the item viewer for props), measure it, and with `--submit` record the backend's verdict (numeric asserts + vision critic) against that exact version. **The visual check is advisory: it records notes with fix hints and never gates listing, distributions or version moves. Only a technical failure (an unusable file, with its plain reason) or content safety blocks. The vision critic never blocks and never changes the exit code (owner visual check is the gate); only a measured assert (shell, budget, occupant / head_in_wings, triangles) can exit 1.** See [docs/visual-qa.md](docs/visual-qa.md). |
78
78
  | `helix item visual-qa <item-id> --package-version <v> [--vehicle-package <file>]` | Render a version the item is **not pinned to yet** and record advisory notes for it before (or after) the pointer moves; the move itself never waits on it. Vehicles and avatars go through Try Now (vehicles also need the move's vehicle package), add-ons and wearables through the customiser; the bundle names the candidate, and the vehicle checksum is the one the server minted for that trial. Never falls back to the current version. See [docs/visual-qa-candidate-versions.md](docs/visual-qa-candidate-versions.md). With `--submit`, a PASS prints the next command (`helix item set-version …`) for a version not moved yet; a 403 for a non-creator says so on the first line; `--status` also lists the item's pending (sealed, not current) versions. |
79
79
  | `helix item set-version <item-id> --package-version <v> --reason <text> [--expected-current-version-id <uuid>] [--as-admin] [--json]` | Move an item to a sealed Package Version of its own package (pin resolved from the public Package API; `POST /api/v1/universal-items/<id>/versions`). The flow for a **listed** item: `continuum publish-package` seals vN → `item set-version`; the visual check is advisory and never gates the move. A refusal (a technical failure or content safety) prints the server's plain reason first, then the remedy. An unknown version lists the sealed ones. A **vehicle** moves its car with the pin: the version's sealed root (role `vehicle-definition`) is verified against the manifest and sent as `vehiclePackage`, the same rider `vehicle publish --item` sends; a version without one is refused with a pointer to that resume. A version the item **already had** is a rollback: `PUT /api/v1/universal-items/<id>/versions/current { revision, reason }` (the server restores that revision's retained `vehiclePackage`; a pin-only revision has none and is refused). `--as-admin` (platform admins, for an item another account created) posts the same body to `POST /api/v1/admin/universal-items/<id>/versions`: same gates (visual QA included, no override), `--reason` recorded with you as the actor. |
80
80
  | `helix item thumbnail refresh <item-id> [--force] [--dry-run] [--json]` | Re-render a published item's canonical thumbnail from its **active Package Version** with the standard server renderer (`POST /api/v1/universal-items/<id>/thumbnail/regenerate`, owner or admin). Prints the status (`generated` / `current` / `dry-run`), old -> new thumbnail URL, renderer version and the source lane + Package Version. `--dry-run` writes nothing; `--force` re-renders even when the stored thumbnail is current. Moving an item to a new Package Version now refreshes the thumbnail automatically unless you uploaded one. An older backend answers 404 and the CLI says it does not support thumbnail refresh yet. Not the world `helix thumbnail set <slug>` command. |
package/dist/index.js CHANGED
@@ -2436,7 +2436,7 @@ item
2436
2436
  for (const line of (0, moveUx_1.describePendingVersions)(id, st.pendingVersions))
2437
2437
  console.log(line);
2438
2438
  }
2439
- process.exitCode = job && hosted.isTerminal(job.status) ? hosted.exitCodeForJob(job) : 0;
2439
+ process.exitCode = job && hosted.isTerminal(job.status) ? hosted.exitCodeForJob(job, false, (await Promise.resolve().then(() => __importStar(require('./visualQa/verdictText')))).statusVerdictSource(st).blockers) : 0;
2440
2440
  return;
2441
2441
  }
2442
2442
  const token = creds?.token;
@@ -2469,8 +2469,12 @@ item
2469
2469
  job = waited.job;
2470
2470
  timedOut = waited.timedOut;
2471
2471
  }
2472
+ // A failed/errored job whose only blockers are the critic's is advisory (older backends still record those).
2473
+ const jobBlockers = job && (job.status === 'failed' || job.status === 'error')
2474
+ ? (await Promise.resolve().then(() => __importStar(require('./visualQa/verdictText')))).statusVerdictSource(await hosted.getItemVisualQaStatus(apiBase, id).catch(() => null)).blockers
2475
+ : [];
2472
2476
  if (opts.json)
2473
- console.log(JSON.stringify({ ...req, job, timedOut }, null, 2));
2477
+ console.log(JSON.stringify({ ...req, job, timedOut, advisory: (await Promise.resolve().then(() => __importStar(require('./visualQa/verdictText')))).ADVISORY_NOTE }, null, 2));
2474
2478
  else if (job && hosted.isTerminal(job.status)) {
2475
2479
  const warned = job.status === 'passed' && job.verdict === 'warn';
2476
2480
  console.log(`${warned ? '!' : job.status === 'passed' ? '✔' : '✖'} visual QA ${warned ? 'WARN' : job.status.toUpperCase()}`);
@@ -2480,10 +2484,10 @@ item
2480
2484
  console.log(` error: ${job.error}`);
2481
2485
  if (job.contactSheetUrl)
2482
2486
  console.log(` contact sheet: ${job.contactSheetUrl}`);
2483
- if (warned || job.status === 'failed') {
2487
+ {
2484
2488
  const { describeVerdictBody, statusVerdictSource } = await Promise.resolve().then(() => __importStar(require('./visualQa/verdictText')));
2485
2489
  const st = await hosted.getItemVisualQaStatus(apiBase, id).catch(() => null);
2486
- for (const line of describeVerdictBody(warned ? 'warn' : 'fail', statusVerdictSource(st)))
2490
+ for (const line of describeVerdictBody(warned ? 'warn' : job.status === 'passed' ? 'pass' : 'fail', statusVerdictSource(st)))
2487
2491
  console.log(line);
2488
2492
  }
2489
2493
  }
@@ -2491,7 +2495,7 @@ item
2491
2495
  console.log(`… still ${job?.status ?? 'queued'} after ${opts.timeout ?? 30} min; check later with: helix item visual-qa ${id} --status`);
2492
2496
  else if (job)
2493
2497
  console.log(` check later with: helix item visual-qa ${id} --status`);
2494
- process.exitCode = req.alreadyPassed || req.exempt ? 0 : job && !hosted.isTerminal(job.status) && opts.wait === false ? 0 : hosted.exitCodeForJob(job, timedOut);
2498
+ process.exitCode = req.alreadyPassed || req.exempt ? 0 : job && !hosted.isTerminal(job.status) && opts.wait === false ? 0 : hosted.exitCodeForJob(job, timedOut, jobBlockers);
2495
2499
  return;
2496
2500
  }
2497
2501
  const { runVisualQa } = await Promise.resolve().then(() => __importStar(require('./visualQa/command')));
@@ -2512,7 +2516,7 @@ item
2512
2516
  quiet: opts.json,
2513
2517
  });
2514
2518
  if (opts.json) {
2515
- console.log(JSON.stringify({ verdict: outcome.verdict, reasons: outcome.reasons, warnings: outcome.warnings, blockers: outcome.blockers, nextStep: (0, moveUx_1.nextStepAfterPass)({ itemId: id, packageVersion: outcome.bundle.item.packageVersion, candidate: !!outcome.candidate, submitted: !!outcome.server, verdict: outcome.verdict, vehiclePackageFile: opts.vehiclePackage })[0]?.replace(/^\s*next:\s*/, '') ?? null, bundleDir: outcome.bundleDir, contactSheet: outcome.contactSheet, server: outcome.server, critic: outcome.critic, timings: outcome.timings }, null, 2));
2519
+ console.log(JSON.stringify({ verdict: outcome.verdict, advisory: (await Promise.resolve().then(() => __importStar(require('./visualQa/verdictText')))).ADVISORY_NOTE, reasons: outcome.reasons, warnings: outcome.warnings, blockers: outcome.blockers, nextStep: (0, moveUx_1.nextStepAfterPass)({ itemId: id, packageVersion: outcome.bundle.item.packageVersion, candidate: !!outcome.candidate, submitted: !!outcome.server, verdict: outcome.verdict, vehiclePackageFile: opts.vehiclePackage })[0]?.replace(/^\s*next:\s*/, '') ?? null, bundleDir: outcome.bundleDir, contactSheet: outcome.contactSheet, server: outcome.server, critic: outcome.critic, timings: outcome.timings }, null, 2));
2516
2520
  }
2517
2521
  else {
2518
2522
  const { describeVerdictBody, exitCodeForVerdict, verdictMark } = await Promise.resolve().then(() => __importStar(require('./visualQa/verdictText')));
@@ -2533,7 +2537,7 @@ item
2533
2537
  console.log(` ${(outcome.timings.totalMs / 1000).toFixed(1)} s (render ${(outcome.timings.renderMs / 1000).toFixed(1)} s)`);
2534
2538
  }
2535
2539
  // pass 0 · warn 0 (advisory notes only, nothing blocks) · fail 1 · error 2
2536
- process.exitCode = (await Promise.resolve().then(() => __importStar(require('./visualQa/verdictText')))).exitCodeForVerdict(outcome.verdict);
2540
+ process.exitCode = (await Promise.resolve().then(() => __importStar(require('./visualQa/verdictText')))).exitCodeForVerdict(outcome.verdict, outcome.blockers);
2537
2541
  }
2538
2542
  catch (error) {
2539
2543
  fail(error instanceof lib_1.ApiError ? error.render() : String(error?.message ?? error));