kaloko 0.12.2 → 0.13.0

package/src/lib/design-cli.mjs

@@ -3,7 +3,7 @@
 import { readFile, writeFile, mkdir, rm, readdir } from 'node:fs/promises'
 import { gzipSync, gunzipSync } from 'node:zlib'
 import { join, dirname, relative } from 'node:path'
-import { readJson, writeJson, UserError } from './util.mjs'
+import { readJson, writeJson, UserError, UsageError } from './util.mjs'
 import { readCaptures, addCapture, runPaths } from './run.mjs'
 import { latestCaptures, criteriaHash, evaluationSource } from './evaluate.mjs'
 import { captureStep } from './capture.mjs'
@@ -198,7 +198,7 @@ export async function uploadBlobs ({ client, org, files, say }) {
       const raw = await readFile(f.abs)
       const gz = TEXT_TYPES.has(f.ext) && raw.length > 512
       const body = gz ? gzipSync(raw, { level: 6 }) : raw
-      await client.upload(`/orgs/${org}/blobs/${h}`, body, f.abs, { 'X-QAwalk-Type': f.ext, ...(gz ? { 'Content-Encoding': 'gzip' } : {}) })
+      await client.upload(`/orgs/${org}/blobs/${h}`, body, f.abs, { 'X-Kaloko-Type': f.ext, 'X-QAwalk-Type': f.ext, ...(gz ? { 'Content-Encoding': 'gzip' } : {}) })
       bytes += body.length
     }
   }
@@ -267,7 +267,7 @@ export async function syncDesign ({ config, root, run, scenario, env, client, ar
         try { if (await sha256Hex(await readFile(target)) === hash) continue } catch {}
         const res = await client.fetch(`/orgs/${org}/revisions/${rev.id}/files/${p.split('/').map(enc).join('/')}`)
         let buf = Buffer.from(await res.arrayBuffer())
-        if (res.headers.get('X-QAwalk-Encoding') === 'gzip') buf = gunzipSync(buf)
+        if ((res.headers.get('X-Kaloko-Encoding') || res.headers.get('X-QAwalk-Encoding')) === 'gzip') buf = gunzipSync(buf)
         await mkdir(dirname(target), { recursive: true })
         await writeFile(target, buf)
       }
@@ -470,7 +470,7 @@ export async function tokensCmd ({ config, root, env, client, args, say, project
     if (args.json) { say(JSON.stringify(report, null, 2)); return }
     if (!report.offenders.length) say(`✓ Every color, font, size, spacing and radius in ${relative(process.cwd(), dir)} comes from the token set (${report.checked} values).`)
     else { say(`${report.offenders.length} raw value(s) outside the token set:\n  - ${report.offenders.slice(0, 40).map((o) => `${o.file}:${o.line} ${o.property}: ${o.value}${o.deprecated ? ` (deprecated token ${o.deprecated}${o.note ? `: ${o.note}` : ''})` : ''}${o.suggest ? `  → ${o.suggest}` : ''}`).join('\n  - ')}`); process.exitCode = 1 }
-  } else throw new UserError('Usage: kaloko tokens pull|push|check|validate [--project p] [--file tokens.json|tokens.resolver.json] [--mode m] [--json]')
+  } else throw new UsageError('Usage: kaloko tokens pull|push|check|validate [--project p] [--file tokens.json|tokens.resolver.json] [--mode m] [--json]')
 }
 
 /** Writes the live files of a version (or the draft) into a folder: the handoff, or taking back canvas edits. */
@@ -488,7 +488,7 @@ export async function exportLive ({ config, scenarioId, client, args, say, out }
       try { if (await sha256Hex(await readFile(target)) === hash) continue } catch {}
       const res = await client.fetch(`/orgs/${config.org}/revisions/${s.revision}/files/${p.split('/').map(enc).join('/')}`)
       let buf = Buffer.from(await res.arrayBuffer())
-      if (res.headers.get('X-QAwalk-Encoding') === 'gzip') buf = gunzipSync(buf)
+      if ((res.headers.get('X-Kaloko-Encoding') || res.headers.get('X-QAwalk-Encoding')) === 'gzip') buf = gunzipSync(buf)
       await mkdir(dirname(target), { recursive: true })
       await writeFile(target, buf)
       written++
@@ -510,13 +510,13 @@ export async function branchCmd ({ config, scenarioId, client, args, say }) {
     return
   }
   if (action === 'create') {
-    if (!name) throw new UserError('Usage: kaloko branch create <name> [--from vN|draft] [--git <branch>]')
+    if (!name) throw new UsageError('Usage: kaloko branch create <name> [--from vN|draft] [--git <branch>]')
     const r = await client.request('POST', base, { name, ...(typeof args.from === 'string' ? { from: args.from } : {}), ...(typeof args.git === 'string' ? { git_branch: args.git } : {}) })
     say(`Branch ${r.branch} created from ${r.based_on_version || 'the draft'} (${r.steps} step×locale). Work on it with --branch ${r.branch}.`)
     return
   }
   if (action === 'merge') {
-    if (!name) throw new UserError('Usage: kaloko branch merge <name> [--take-branch a,b] [--keep-main c]')
+    if (!name) throw new UsageError('Usage: kaloko branch merge <name> [--take-branch a,b] [--keep-main c]')
     const choices = {}
     try {
       const r = await client.request('POST', `${base}/${enc(name)}/merge`, { choices: await choicesFrom(args, client, config, scenarioId, name) })
@@ -528,7 +528,7 @@ export async function branchCmd ({ config, scenarioId, client, args, say }) {
     }
     return choices
   }
-  throw new UserError('Usage: kaloko branch list | create <name> [--from vN] [--git <branch>] | merge <name> [--take-branch a,b] [--keep-main c]')
+  throw new UsageError('Usage: kaloko branch list | create <name> [--from vN] [--git <branch>] | merge <name> [--take-branch a,b] [--keep-main c]')
 }
 
 async function choicesFrom (args, client, config, scenarioId, name) {
@@ -556,7 +556,7 @@ async function forkViews ({ config, client, args, say, out, data }) {
     for (const [p] of Object.entries(v.files)) {
       const res = await client.fetch(`/orgs/${config.org}/revisions/${v.revision}/files/${p.split('/').map(enc).join('/')}`)
       let buf = Buffer.from(await res.arrayBuffer())
-      if (res.headers.get('X-QAwalk-Encoding') === 'gzip') buf = gunzipSync(buf)
+      if ((res.headers.get('X-Kaloko-Encoding') || res.headers.get('X-QAwalk-Encoding')) === 'gzip') buf = gunzipSync(buf)
       const target = join(out, prefix, p)
       await mkdir(dirname(target), { recursive: true })
       await writeFile(target, buf)

package/src/lib/design-export.mjs

@@ -136,7 +136,7 @@ export async function exportDesign ({ config, scenarioId, client, ref = 'design'
   for (const [p, { revision }] of paths) {
     const res = await client.fetch(`/orgs/${org}/revisions/${revision}/files/${p.split('/').map(enc).join('/')}`)
     let buf = Buffer.from(await res.arrayBuffer())
-    if (res.headers.get('X-QAwalk-Encoding') === 'gzip') buf = gunzipSync(buf)
+    if ((res.headers.get('X-Kaloko-Encoding') || res.headers.get('X-QAwalk-Encoding')) === 'gzip') buf = gunzipSync(buf)
     await sink.put(p, buf)
   }
   const steps = []

package/src/lib/integrations-cli.mjs

@@ -4,7 +4,7 @@
 import { readFile, writeFile, mkdir } from 'node:fs/promises'
 import { existsSync } from 'node:fs'
 import { resolve, relative, dirname, join } from 'node:path'
-import { UserError, NO_ORG } from './util.mjs'
+import { UserError, UsageError, NO_ORG } from './util.mjs'
 import { gateOf, accountFor } from './access.mjs'
 import { secret } from './secrets.mjs'
 import { runner } from './ci.mjs'
@@ -31,7 +31,7 @@ export async function issueCmd ({ args, config, client, runId, say }) {
     say(items.length ? items.map(issueLine).join('\n') : 'No issues created from steps yet.')
     return items
   }
-  if (sub !== 'create') throw new UserError('Usage: kaloko issue create --step <id> --to jira|linear [--criterion AC2] [--title "…"] [--note "…"] [--run id]\n       kaloko issue list [--run id] [--scenario id] [--state open|done|canceled] [--json]')
+  if (sub !== 'create') throw new UsageError('Usage: kaloko issue create --step <id> --to jira|linear [--criterion AC2] [--title "…"] [--note "…"] [--run id]\n       kaloko issue list [--run id] [--scenario id] [--state open|done|canceled] [--json]')
   const to = String(args.to || '')
   if (!['jira', 'linear'].includes(to)) throw new UserError('--to jira or --to linear says where the issue goes.')
   if (typeof args.step !== 'string' || !args.step) throw new UserError('--step <id> names the step the issue is about.')
@@ -145,7 +145,7 @@ export async function scheduleCmd ({ args, config, root, say, deps }) {
   const org = config.org
   const client = () => deps.service(config)
   if (sub === 'export') {
-    if (id !== 'github') throw new UserError('Usage: kaloko schedule export github --scenario <file> --env <name> [--every day|week] [--at 5] [--weekday mon] [--out file] [--print] [--force]')
+    if (id !== 'github') throw new UsageError('Usage: kaloko schedule export github --scenario <file> --env <name> [--every day|week] [--at 5] [--weekday mon] [--out file] [--print] [--force]')
     const file = typeof args.scenario === 'string' ? resolve(root, args.scenario) : null
     if (!file) throw new UserError('--scenario <file> names the scenario to walk.')
     const envName = typeof args.env === 'string' ? args.env : null
@@ -202,10 +202,10 @@ export async function scheduleCmd ({ args, config, root, say, deps }) {
     if ((s.skipped || []).length) say('  Steps that click or type need the full walk: kaloko schedule export github')
     return s
   }
-  if (!id) throw new UserError(`Usage: kaloko schedule ${sub} <schedule id> (kaloko schedule list shows them)`)
+  if (!id) throw new UsageError(`Usage: kaloko schedule ${sub} <schedule id> (kaloko schedule list shows them)`)
   const path = `/orgs/${org}/schedules/${encodeURIComponent(id)}`
   if (sub === 'run') { await client().request('POST', `${path}/run`); say(`✓ ${id} starts within 15 minutes; the run lands in your inbox.`); return }
   if (sub === 'pause' || sub === 'resume') { const s = await client().request('PATCH', path, { enabled: sub === 'resume' }); say(`✓ ${id} ${s.enabled ? `resumed: ${when(s)}` : 'paused'}`); return s }
   if (sub === 'remove') { await client().request('DELETE', path); say(`✓ ${id} removed; its runs stay.`); return }
-  throw new UserError('Usage: kaloko schedule add|list|run|pause|resume|remove|export github (kaloko help)')
+  throw new UsageError('Usage: kaloko schedule add|list|run|pause|resume|remove|export github (kaloko help)')
 }

package/src/lib/screens-cli.mjs

@@ -1,6 +1,6 @@
 // `kaloko screens`: the screen library from the terminal (batch G): the newest capture of every step of the
 // organization's flows, searched on the service (GET /orgs/<org>/screens), one line per screen with its canvas link.
-import { UserError } from './util.mjs'
+import { UserError, NO_ORG } from './util.mjs'
 
 const FILTERS = ['project', 'product', 'module', 'scenario', 'locale', 'viewport', 'device', 'status', 'environment', 'limit', 'cursor']
 
@@ -10,6 +10,8 @@ export function screensQuery (args) {
   const q = (args._ || []).join(' ').trim() || (typeof args.q === 'string' ? args.q : '')
   if (q) p.set('q', q)
   for (const k of FILTERS) if (typeof args[k] === 'string' || typeof args[k] === 'number') p.set(k, String(args[k]))
+  // --env is the environment, as in every other command (--environment still works)
+  if (typeof args.env === 'string') p.set('environment', args.env)
   if (args.designs || args.source === 'all') p.set('source', 'all')
   else if (args.source === 'design') p.set('source', 'design')
   if (args.all) p.set('group', 'none')
@@ -29,7 +31,7 @@ export function formatScreens (r) {
 }
 
 export async function screensCmd ({ config, client, args, say }) {
-  if (!config.org) throw new UserError('Set org: in kaloko.config.yml (or run kaloko login) to search the screen library.')
+  if (!config.org) throw new UserError(NO_ORG)
   const r = await client.request('GET', `/orgs/${config.org}/screens?${screensQuery(args)}`)
   say(args.json ? JSON.stringify(r, null, 2) : formatScreens(r))
   return r

package/src/lib/service.mjs

@@ -1,5 +1,5 @@
 // Client of the Kaloko service API (kaloko.app or KALOKO_URL) with the organization token.
-import { UserError } from './util.mjs'
+import { UserError, NO_ORG } from './util.mjs'
 
 /** Base URL of the service; configs written before the rename name app.qawalk.com, which now means kaloko.app. */
 export function serviceUrl (config, vars = process.env) {
@@ -19,8 +19,20 @@ export function ciName (vars = process.env) {
   return vars.CI && vars.CI !== 'false' ? 'ci' : null
 }
 
-/** What to do after the service answered `status`; '' when its own message says enough. */
-export function nextStepFor (status, { tokenEnv = 'KALOKO_TOKEN', url = 'https://kaloko.app' } = {}) {
+/** Plan & billing of the organization on the service (the service names it for 402 answers). */
+export const billingUrl = (url, org) => `${url}${org ? `/${org}` : ''}/billing`
+
+/**
+ * What to do after the service answered `status` (and `code`, when it names the reason); '' when its own message
+ * says enough. `message` is the service's message: a link it already holds is not repeated.
+ */
+export function nextStepFor (status, { tokenEnv = 'KALOKO_TOKEN', url = 'https://kaloko.app', code = null, billing = null, org = null, message = '' } = {}) {
+  const plan = billing || billingUrl(url, org)
+  const link = message.includes(plan) ? '' : ` Plan & billing: ${plan}`
+  if (code === 'billing_restricted') return `Billing of the organization is restricted until the payment is fixed; an admin updates it.${link}`
+  if (code === 'seat_limit') return `An admin buys seats or upgrades the plan.${link}`
+  if (code === 'sso_required') return 'Sign in through your company sign-in on kaloko.app in the browser, then run kaloko login.'
+  if (status === 402 || code === 'plan') return `Your plan does not include this.${link}`
   if (status === 401) return `The token in ${tokenEnv} is invalid, expired or revoked. Run kaloko login for a new one (or put a fresh token from Settings → API tokens into .env).`
   if (status === 403) return 'Your role or the token\'s scopes do not allow this; ask an admin of the organization, or use a token that may do it.'
   if (status === 413) return 'The file is larger than the service takes; leave it out of the run or make it smaller.'
@@ -30,10 +42,11 @@ export function nextStepFor (status, { tokenEnv = 'KALOKO_TOKEN', url = 'https:/
 }
 
 /** A UserError for an HTTP answer: what failed, the service's message, what to do next; `status` kept for callers. */
-export function httpError (what, status, message, opts) {
-  const err = new UserError([`${what} → HTTP ${status}: ${message}`, nextStepFor(status, opts)].filter(Boolean).join(' '))
+export function httpError (what, status, message, opts = {}) {
+  const err = new UserError(`${what} → HTTP ${status}: ${message}`, { next: nextStepFor(status, { ...opts, message: String(message || '') }) })
   err.status = status
   err.serviceMessage = message
+  if (opts.code) err.code = opts.code
   return err
 }
 
@@ -51,15 +64,23 @@ export function service (config) {
   const tokenEnv = config.share?.token_env || 'KALOKO_TOKEN'
   const token = process.env[tokenEnv]
   if (!token) throw new UserError(`${tokenEnv} is not set, so the CLI cannot reach your organization on ${root}. Run kaloko login, or create a token in Settings → API tokens and put ${tokenEnv}=… into .env.`)
-  const opts = { tokenEnv, url: root }
-  // an agent names itself (KALOKO_AGENT, e.g. "claude-code"); the service shows it in presence, history and audit (#42)
+  const opts = { tokenEnv, url: root, org: config.org || null }
+  // an agent names itself (KALOKO_AGENT, e.g. "claude-code"); the service shows it in presence, history and audit (#42).
+  // Both header names: services before the rename read X-QAwalk-Agent only
   const ci = ciName()
-  const headers = { Authorization: `Bearer ${token}`, ...(process.env.KALOKO_AGENT ? { 'X-QAwalk-Agent': process.env.KALOKO_AGENT.slice(0, 60) } : {}), ...(ci ? { 'X-Kaloko-CI': ci } : {}) }
+  const agent = process.env.KALOKO_AGENT ? process.env.KALOKO_AGENT.slice(0, 60) : null
+  const headers = { Authorization: `Bearer ${token}`, ...(agent ? { 'X-Kaloko-Agent': agent, 'X-QAwalk-Agent': agent } : {}), ...(ci ? { 'X-Kaloko-CI': ci } : {}) }
+  // an error answer: its message, and the reason code and billing link the service adds ({ error, code?, billing_url? })
+  const failed = async (res, what) => {
+    const body = await res.json().catch(() => ({}))
+    return httpError(what, res.status, body.error || res.statusText, { ...opts, code: body.code || null, billing: body.billing_url || null })
+  }
   const check = async (res, what) => {
     if (res.ok) return res.json()
-    const body = await res.json().catch(() => ({}))
-    throw httpError(what, res.status, body.error || res.statusText, opts)
+    throw await failed(res, what)
   }
+  // no org: in the config would ask for /orgs/undefined/…: say where the slug comes from instead
+  const orgOf = (path) => { if (/^\/orgs\/(?:undefined|null)?(?:[/?]|$)/.test(path)) throw new UserError(NO_ORG) }
   // fetch rejects without an answer (offline, refused, DNS): say so instead of a stack trace
   const call = (send) => send().catch((e) => { if (e instanceof UserError) throw e; throw unreachable(root, e) })
   // the service limits requests per token (HTTP 429, nothing was processed): wait as told and try again
@@ -76,21 +97,25 @@ export function service (config) {
   }
   return {
     async request (method, path, body) {
+      orgOf(path)
       const res = await call(() => limited(() => fetch(base + path, { method, headers: { ...headers, ...(body ? { 'Content-Type': 'application/json' } : {}) }, body: body ? JSON.stringify(body) : undefined })))
       return check(res, `${method} ${path}`)
     },
     /** A request whose answer is not JSON (an export): the response, or an error with the service's message. */
     async raw (method, path, body) {
+      orgOf(path)
       const res = await call(() => limited(() => fetch(base + path, { method, headers: { ...headers, ...(body ? { 'Content-Type': 'application/json' } : {}) }, body: body ? JSON.stringify(body) : undefined })))
-      if (!res.ok) { const b = await res.json().catch(() => ({})); throw httpError(`${method} ${path}`, res.status, b.error || res.statusText, opts) }
+      if (!res.ok) throw await failed(res, `${method} ${path}`)
       return res
     },
     async fetch (path) {
+      orgOf(path)
       const res = await call(() => limited(() => fetch(base + path, { headers })))
-      if (!res.ok) { const body = await res.json().catch(() => ({})); throw httpError(`GET ${path}`, res.status, body.error || res.statusText, opts) }
+      if (!res.ok) throw await failed(res, `GET ${path}`)
       return res
     },
     async upload (path, data, name, extra = {}) {
+      orgOf(path)
       for (let attempt = 0; ; attempt++) {
         // a dropped connection (flaky Wi-Fi, CI runner hiccup) is tried again like a 5xx; the next share resumes otherwise
         let res

package/src/lib/signoff.mjs

@@ -3,7 +3,7 @@
 // record someone handed over, without a token. The keys come from <service>/.well-known/kaloko-signoff.json.
 import { readFile, writeFile, mkdir } from 'node:fs/promises'
 import { join, resolve } from 'node:path'
-import { UserError } from './util.mjs'
+import { UserError, UsageError } from './util.mjs'
 import { serviceUrl } from './service.mjs'
 import { verifyRecord, recordSha256, extractRecordFromPdf, canonicalJson } from './signoff-core.mjs'
 
@@ -64,7 +64,7 @@ export async function signoffCmd ({ config, args, say, client = null, runId = nu
     if (!check.ok) throw new UserError(`The sign-off record in ${args.verify} does not verify: ${check.reason}`)
     return check
   }
-  if (!runId) throw new UserError('Usage: kaloko signoff <run-id> [--out dir] [--lang cs|en] | kaloko signoff --verify <file.json|file.pdf> [--key file|url]')
+  if (!runId) throw new UsageError('Usage: kaloko signoff <run-id> [--out dir] [--lang cs|en] | kaloko signoff --verify <file.json|file.pdf> [--key file|url]')
   if (!client) throw new UserError('Downloading a sign-off record needs the service token (KALOKO_TOKEN).')
   const base = `/orgs/${config.org}/runs/${encodeURIComponent(runId)}`
   const lang = args.lang === 'cs' ? 'cs' : 'en'

package/src/lib/spec-cli.mjs

@@ -3,7 +3,7 @@
 // interaction states). The spec comes from the service (design reference, draft, a version or a shared run) or from
 // a local run's captures; drift compares the local implementation run with the reference from the service.
 import { join } from 'node:path'
-import { readJson, UserError } from './util.mjs'
+import { readJson, UserError, UsageError } from './util.mjs'
 import { readCaptures } from './run.mjs'
 import { latestCaptures } from './evaluate.mjs'
 import { specText, specDrift, driftText } from './devspec.mjs'
@@ -31,7 +31,7 @@ export async function specCmd ({ config, client, run, scenario, scenarioId, args
   // a step state (#46): its captures (keys <viewport>.state-<name>); default otherwise
   const state = typeof args.state === 'string' ? args.state : null
   const steps = step ? [step] : (scenario?.nodes || []).filter((n) => n.kind !== 'decision' && n.kind !== 'external').map((n) => n.id)
-  if (!steps.length) throw new UserError('Usage: kaloko spec <step> [--ref design|draft|vN|<run id>] [--locale l] [--viewport v] [--state s] [--local] [--json]')
+  if (!steps.length) throw new UsageError('Usage: kaloko spec <step> [--ref design|draft|vN|<run id>] [--locale l] [--viewport v] [--state s] [--local] [--json]')
   const out = []
   for (const s of steps) {
     if (args.local || !client) {
@@ -66,7 +66,7 @@ export async function driftCmd ({ config, client, run, scenarioId, args, say })
   if (!client) throw new UserError('kaloko drift compares with the approved design on the service: set org and a token (kaloko login).')
   const results = []
   if (args.remote) {
-    if (!step) throw new UserError('Usage: kaloko drift <step> --remote <run id|latest>')
+    if (!step) throw new UsageError('Usage: kaloko drift <step> --remote <run id|latest>')
     const q = new URLSearchParams(Object.entries({ run: typeof args.remote === 'string' ? args.remote : 'latest', ref, locale, viewport }).filter(([, v]) => v))
     const d = await client.request('GET', `/orgs/${config.org}/scenarios/${enc(scenarioId)}/steps/${enc(step)}/drift?${q}`)
     results.push({ node: step, locale: d.locale, viewport: d.viewport, ref: d.ref, findings: d.findings, text: d.text })

package/src/lib/upload.mjs

@@ -71,7 +71,7 @@ export async function uploadRunFiles ({ client, org, runId, dir, entries, missin
     const tick = progressLine(write, 'uploaded')
     await pool([...byHash.values()], workers, async (e) => {
       const { data, gz } = encode(e.path, await readFile(join(dir, e.path)))
-      await client.upload(`/orgs/${org}/blobs/${e.hash}`, data, e.path, { 'X-QAwalk-Type': e.ext, ...(gz ? { 'Content-Encoding': 'gzip' } : {}) })
+      await client.upload(`/orgs/${org}/blobs/${e.hash}`, data, e.path, { 'X-Kaloko-Type': e.ext, 'X-QAwalk-Type': e.ext, ...(gz ? { 'Content-Encoding': 'gzip' } : {}) })
       sent += data.length
     }, () => tick(++done, byHash.size, sent))
     // 2. the run's file list points at the blobs; a service that does not know references says so by leaving out `blobs`

package/src/lib/util.mjs

@@ -65,7 +65,20 @@ export function globToRegExp (glob) {
   return new RegExp('^' + out + '$')
 }
 
-export class UserError extends Error {}
+/**
+ * An error the person can act on: what happened, then (`next`) what to do about it, in one format for every command:
+ * "<what happened> <what to do next>". `reason` and `next` stay apart for callers that show them separately.
+ */
+export class UserError extends Error {
+  constructor (message, { next = '', ...options } = {}) {
+    super([message, next].filter(Boolean).join(' '), options)
+    this.reason = message
+    this.next = next || ''
+  }
+}
+
+/** A command used the wrong way (unknown option, missing argument): exit code 2 and the command's help, no support line. */
+export class UsageError extends UserError {}
 
 /** Every CLI error ends with a way to a person (docs/HARDENING.md phase 6, item 12). */
 export const SUPPORT_EMAIL = 'support@sinfin.cz'

package/src/lib/video-cli.mjs

@@ -8,7 +8,7 @@ import { resolveRun, addCapture } from './run.mjs'
 import { loadScenario } from './scenario.mjs'
 import { buildManifest } from './build.mjs'
 import { launchEphemeral } from './browser.mjs'
-import { readJson, localized, UserError } from './util.mjs'
+import { readJson, localized, UserError, UsageError } from './util.mjs'
 import { videoTools, encoderCaps, ffmpeg, preset, installHint, outputSize } from './video.mjs'
 import { formatTrace } from './trace.mjs'
 
@@ -189,7 +189,7 @@ export async function videoCmd ({ config, root, args, say }) {
   if (sub === 'trace') {
     const step = typeof args.step === 'string' ? args.step : null
     const n = manifest.nodes.find((x) => x.id === step)
-    if (!n) throw new UserError(`Usage: kaloko video trace --step <id> [--locale l] [--viewport v] [--json]. Steps: ${manifest.nodes.map((x) => x.id).join(', ')}`)
+    if (!n) throw new UsageError(`Usage: kaloko video trace --step <id> [--locale l] [--viewport v] [--json]. Steps: ${manifest.nodes.map((x) => x.id).join(', ')}`)
     const loc = typeof args.locale === 'string' ? args.locale : Object.keys(n.captures || {})[0]
     const vps = n.captures?.[loc] || {}
     const vp = typeof args.viewport === 'string' ? args.viewport : Object.keys(vps).find((v) => vps[v]?.trace)