{"bin":"simforge","command":"","commands":[{"arguments":[],"command":"login","flags":[{"commandIndex":1,"help":"SimForge host to sign in to. Default: SIMFORGE_HOST, then the host of the last login, then simforge.ai. Later commands use the host signed in to","name":"--host","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"HOST"},{"commandIndex":1,"help":"Sign in with a code instead of a local browser: print a URL and a short code to approve from any browser (SSH, headless machines)","name":"--device","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"help":"A scope to request on top of the defaults (repeatable), such as keys:admin to manage API keys. The defaults cover map/runtime downloads and scenario/cloud jobs","name":"--scope","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"SCOPE"},{"commandIndex":1,"help":"Where to keep the tokens. Default: SIMFORGE_CREDENTIAL_STORE, then auto (the OS keychain, else a 0600 file; the output says which and why)","name":"--credential-store","positional":false,"possibleValues":["auto","keyring","file"],"required":false,"takesValue":true,"type":"enum","valueName":"STORE"},{"commandIndex":1,"help":"The name the approval page and the CLI sessions list show for this machine. Default: the host name","name":"--device-name","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"NAME"},{"commandIndex":1,"default":"600","help":"Seconds to wait for the approval","minimum":0,"name":"--timeout","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"SECONDS"},{"commandIndex":1,"help":"With --device: print the URL and code and exit at once instead of waiting; after the approval, `simforge login poll` (from any shell, even after this one closed) stores the login","name":"--no-wait","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":[],"status":"available","summary":"Sign in to a SimForge host (browser approval, or --device for a URL and code)","usage":"simforge login [OPTIONS]\n       simforge login <COMMAND>"},{"arguments":[],"command":"login poll","flags":[{"commandIndex":1,"help":"SimForge host to sign in to. Default: SIMFORGE_HOST, then the host of the last login, then simforge.ai. Later commands use the host signed in to","name":"--host","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"HOST"},{"commandIndex":1,"help":"Sign in with a code instead of a local browser: print a URL and a short code to approve from any browser (SSH, headless machines)","name":"--device","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"help":"A scope to request on top of the defaults (repeatable), such as keys:admin to manage API keys. The defaults cover map/runtime downloads and scenario/cloud jobs","name":"--scope","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"SCOPE"},{"commandIndex":1,"help":"Where to keep the tokens. Default: SIMFORGE_CREDENTIAL_STORE, then auto (the OS keychain, else a 0600 file; the output says which and why)","name":"--credential-store","positional":false,"possibleValues":["auto","keyring","file"],"required":false,"takesValue":true,"type":"enum","valueName":"STORE"},{"commandIndex":1,"help":"The name the approval page and the CLI sessions list show for this machine. Default: the host name","name":"--device-name","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"NAME"},{"commandIndex":1,"default":"600","help":"Seconds to wait for the approval","minimum":0,"name":"--timeout","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"SECONDS"},{"commandIndex":1,"help":"With --device: print the URL and code and exit at once instead of waiting; after the approval, `simforge login poll` (from any shell, even after this one closed) stores the login","name":"--no-wait","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"help":"SimForge host the sign-in was started on. Default: SIMFORGE_HOST, then the host of the last login, then simforge.ai","name":"--host","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"HOST"},{"commandIndex":2,"default":"600","help":"Seconds to wait for the approval; the code stays valid until it expires, so a timeout (`login_pending`) can be polled again","minimum":0,"name":"--timeout","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"SECONDS"}],"globals":[],"status":"available","summary":"Finish a device sign-in started by `login --device --no-wait` (or one whose terminal closed while it waited): wait for the approval, then store the login","usage":"simforge login poll [OPTIONS]"},{"arguments":[],"command":"logout","flags":[{"commandIndex":1,"help":"SimForge host. Default: SIMFORGE_HOST, then the host of the last login, then simforge.ai","name":"--host","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"HOST"}],"globals":[],"status":"available","summary":"Sign out of a host: revoke this machine's session and delete its stored tokens","usage":"simforge logout [OPTIONS]"},{"arguments":[],"command":"auth status","flags":[{"commandIndex":2,"help":"SimForge host. Default: SIMFORGE_HOST, then the host of the last login, then simforge.ai","name":"--host","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"HOST"}],"globals":[],"status":"available","summary":"The account, organization, scopes, expiry, host and credential store of this machine's login, checked with the host (tokenValid), and the account's email verification; with SIMFORGE_API_KEY set, the key's account, workspace and scopes","usage":"simforge auth status [OPTIONS]"},{"arguments":[],"command":"whoami","flags":[{"commandIndex":1,"help":"SimForge host. Default: SIMFORGE_HOST, then the host of the last login, then simforge.ai","name":"--host","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"HOST"}],"globals":[],"status":"available","summary":"The account, workspace and scopes acting here: the signed-in login, or SIMFORGE_API_KEY when it is set","usage":"simforge whoami [OPTIONS]"},{"arguments":[],"command":"runtime install","flags":[{"commandIndex":2,"default":"host target","help":"The platform to download for (a Rust target triple). Default: this machine's","name":"--target","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TARGET"},{"commandIndex":2,"help":"The exact runtime release to install. Default: the one this CLI pins","name":"--version","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"VERSION"},{"commandIndex":2,"help":"Where to install the runtime. Default: SIMFORGE_RUNTIME_ROOT, then the root of the last install, then <data home>/simforge/runtime. The root is recorded in the CLI config, so `runtime status`, `doctor` and every local command find it; the download and its unpacking stay inside it","name":"--root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"ROOT"},{"commandIndex":2,"help":"What to install the runtime for: `2d` (authoring, simulation and 2D renders: the runtime without the 3D actor models and sky, about 1/30 of the download) or `3d` (also local 3D renders). Default: what is installed, else `2d`","name":"--for","positional":false,"possibleValues":["2d","3d"],"required":false,"takesValue":true,"type":"enum","valueName":"LEVEL"},{"commandIndex":2,"help":"Explicitly accept the current license and terms (agreement version and SHA) before downloading","name":"--accept-license","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":["--workspace","--api-url","--dry-run"],"status":"available","summary":"Download and install the closed runtime (PolyForm Noncommercial 1.0.0) after accepting its license and SimForge's account and download terms","usage":"simforge runtime install [OPTIONS]"},{"arguments":[],"command":"runtime status","flags":[{"commandIndex":2,"help":"Also list the runtime releases this account can install for this machine (`2d`, `3d`), each with its version, download and installed size; works before any runtime is installed","name":"--available","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":[],"status":"available","summary":"Report the installed runtime's protocol and engine identity; `--available` also lists what `runtime install` would download, with sizes","usage":"simforge runtime status [OPTIONS]"},{"arguments":[],"command":"runtime license","flags":[],"globals":["--workspace","--api-url"],"status":"available","summary":"Read the runtime license (PolyForm Noncommercial 1.0.0) and SimForge's account and download terms without accepting them","usage":"simforge runtime license [OPTIONS]"},{"arguments":[],"command":"maps list","flags":[{"commandIndex":2,"default":"20","help":"At most this many items on the page","maximum":100,"minimum":1,"name":"--limit","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"LIMIT"},{"commandIndex":2,"help":"The next page: the `nextCursor` of the page before it","name":"--cursor","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"CURSOR"}],"globals":["--workspace","--api-url"],"status":"available","summary":"List the hosted maps your workspace can use (signed out: the public catalogue), each with the packs `maps pull` installs (`packs`: variant, version, download and installed bytes) and what is installed locally (`installed`: `2d`, `3d` or null)","usage":"simforge maps list [OPTIONS]"},{"arguments":[{"commandIndex":2,"help":"The id","name":"id","positional":true,"required":true,"type":"string","valueName":"ID"}],"command":"maps show","flags":[],"globals":["--workspace","--api-url"],"status":"available","summary":"One hosted map (signed out: a public one), with its packs' sizes and what is installed locally","usage":"simforge maps show [OPTIONS] <ID>"},{"arguments":[{"commandIndex":2,"help":"SimForge-owned map name, optionally pinned as NAME@VERSION","name":"map","positional":true,"required":true,"type":"string","valueName":"MAP"}],"command":"maps pull","flags":[{"commandIndex":2,"help":"What to install the map for: `2d` (authoring, simulation and 2D renders: a few MB) or `3d` (also local 3D renders; the whole map, GB). Default: `3d` when this map is already installed for 3D, else `2d`. Cloud renders (`--cloud`) need neither","name":"--for","positional":false,"possibleValues":["2d","3d"],"required":false,"takesValue":true,"type":"enum","valueName":"LEVEL"},{"commandIndex":2,"help":"Map cache directory. Default: the SimForge maps cache","name":"--cache-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"CACHE_ROOT"},{"commandIndex":2,"help":"Explicitly accept the current license and terms, which include the map pack terms, before downloading","name":"--accept-license","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":["--workspace","--api-url","--dry-run"],"status":"available","summary":"Download a map your signed-in account is entitled to into the local cache, sha256-verified","usage":"simforge maps pull [OPTIONS] <MAP>"},{"arguments":[{"commandIndex":2,"help":"Only this map","name":"map","positional":true,"required":false,"type":"string","valueName":"MAP"}],"command":"maps status","flags":[{"commandIndex":2,"help":"Map cache directory. Default: the SimForge maps cache","name":"--cache-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"CACHE_ROOT"}],"globals":[],"status":"available","summary":"The maps installed in the local cache and what each is installed for (`2d` or `3d`). Reads no network","usage":"simforge maps status [OPTIONS] [MAP]"},{"arguments":[{"commandIndex":1,"help":"Scenario JSON file or materialized workspace; identical input for local and cloud","name":"target","positional":true,"required":true,"type":"path","valueName":"TARGET"},{"commandIndex":1,"help":"Runtime-specific options; forwarded without shell interpolation","name":"extra","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"EXTRA"}],"cloudOnlyGlobals":["--workspace","--api-url","--idempotency-key","--dry-run","--map-version"],"command":"render","flags":[{"commandIndex":1,"help":"Output folder; local requires it, cloud waits and downloads when it is given","name":"--out","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"OUT"},{"commandIndex":1,"default":"2d","help":"`2d` (top-down map video on the CPU), `schematic` (the flat OpenDRIVE view, GPU) or `3d` (photoreal camera sensors, GPU)","name":"--mode","positional":false,"possibleValues":["2d","schematic","3d"],"required":false,"takesValue":true,"type":"enum","valueName":"MODE"},{"commandIndex":1,"help":"Sensor rig JSON (`simforge rig init`). Default: the `basic-dash-camera` rig on the ego","name":"--rig","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"RIG"},{"commandIndex":1,"help":"Render preset","name":"--preset","positional":false,"possibleValues":["training","showcase","schematic"],"required":false,"takesValue":true,"type":"enum","valueName":"PRESET"},{"commandIndex":1,"help":"Local native render only: authored instantaneous HDR detector response JSON","name":"--camera-detector","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":1,"help":"Local native render only: bounded exact-time HDR exposure request JSON","name":"--camera-temporal","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":1,"help":"Local bounded offline measurement delivery or controlled delivery-only resume","name":"--camera-delivery","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":1,"help":"Frame rate every camera records (2d: the video's), over the render preset's own rate; 3d takes 5 to 60","name":"--fps","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"FPS"},{"commandIndex":1,"help":"Wait for a submitted cloud job to finish","name":"--wait","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"help":"Download a succeeded cloud job into --out; implies --wait","name":"--download","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"help":"Explicit maximum cloud cost in cents; required for billable cloud jobs","minimum":0,"name":"--max-cost","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"CENTS"},{"commandIndex":1,"help":"Immutable revision for an existing hosted scenario target","name":"--revision","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"REVISION"},{"commandIndex":1,"help":"With --cloud: save a scenario file to the workspace as an immutable revision (free) and price the run on it; starts nothing. --dry-run saves nothing","name":"--stage","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"help":"Cloud 3d render: the drive a succeeded closed_loop run scored (its episode timeline), rendered on the target's revision that run drove","name":"--replay-of","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"RUN_ID"},{"commandIndex":1,"help":"Ego dynamics model for this run: `dynamic-v1` (the engine's own model, today's behaviour), `kinematic-bicycle` (Helios episodes only) or `full-car-v1` (reserved, refused until admitted). Outranks the scenario's `physics.egoDynamics`. Omitted: the run-mode default, which the result records","name":"--ego-dynamics","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"MODEL"},{"commandIndex":1,"help":"The vehicle for an ego actor, `ACTOR=CATALOG_ID`, repeatable. A vehicle pack needs pack profiles, which are not enabled yet: refused `ego_vehicle_unsupported`, never run on the class profile","name":"--ego-vehicle","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"ACTOR=CATALOG_ID"},{"commandIndex":1,"default":"follow-ego","execution":"local-runtime","help":"2d engine: the camera","name":"--camera","positional":false,"possibleValues":["follow-ego","overview"],"required":false,"takesValue":true,"type":"enum","valueName":"CAMERA"},{"commandIndex":1,"execution":"local-runtime","help":"2d engine, follow-ego: keep north up (looking ahead of the ego) instead of turning the view with it","name":"--north-up","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"execution":"local-runtime","help":"2d engine: also draw signal heads the timeline has no phases for (hollow grey rings)","name":"--debug-signals","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"execution":"local-runtime","help":"2d engine: no HUD (header, legend, clock, speed); the map fills the whole frame","name":"--no-hud","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"execution":"local-runtime","help":"2d engine: tags to draw next to actors, a JSON object `{actorId: text}` (e.g. a labelling page's candidate numbers). An id that is not an actor of the timeline fails the render","name":"--actor-labels","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"LABELS.JSON"},{"commandIndex":1,"default":"standard","execution":"local-runtime","help":"2d engine: icon legibility; `high` is for labelling clips (larger props, light people, faint untagged parked vehicles, no edge chevrons or collision marks, non-overlapping tag badges)","name":"--legibility","positional":false,"possibleValues":["standard","high"],"required":false,"takesValue":true,"type":"enum","valueName":"LEGIBILITY"},{"commandIndex":1,"execution":"local-runtime","help":"2d engine: a fixed map scale in pixels per metre. Default: 14 to 9 by the ego's speed (follow-ego); the scenario actors fitted, 5 to 12 (overview)","name":"--px-per-m","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"PX"},{"commandIndex":1,"default":"1280x720","execution":"local-runtime","help":"2d engine: the frame size","name":"--size","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"WxH"},{"commandIndex":1,"execution":"local-runtime","help":"2d engine: the ego actor. Default: the workspace's metric subject","name":"--ego","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"ACTOR_ID"},{"commandIndex":1,"execution":"local-runtime","help":"Render a timeline instead of simulating the workspace, on the same map","name":"--timeline","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"TIMELINE.JSON"},{"commandIndex":1,"execution":"local-runtime","help":"2d engine: the clip, `START:END` seconds of the timeline. Default: the whole timeline","name":"--clip","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"START:END"},{"commandIndex":1,"execution":"local-runtime","help":"2d engine: draw building footprints when the map has them","name":"--buildings","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"execution":"local-runtime","help":"2d engine: the header's title. Default: the map's name (its id in words) and the scenario's title from the package (else the workspace directory); render.json keeps the ids","name":"--title","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":1,"default":"legacy","execution":"local-runtime","help":"Native LiDAR model. `legacy` is the byte-identical default","name":"--lidar-model","positional":false,"possibleValues":["legacy","physical"],"required":false,"takesValue":true,"type":"enum","valueName":"LIDAR_MODEL"},{"commandIndex":1,"execution":"local-runtime","help":"Physical profile name (built-in) or a JSON profile file","name":"--lidar-profile","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"NAME|FILE"},{"commandIndex":1,"default":"0","execution":"local-runtime","help":"Physical-model deterministic noise seed","minimum":0,"name":"--lidar-seed","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"LIDAR_SEED"},{"commandIndex":1,"execution":"local-runtime","help":"Express physical returns in the sensor pose at sweep start","name":"--lidar-motion-compensated","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"execution":"local-runtime","help":"Derive each logged four-wheeler's body pitch and roll from its recorded track (log replays only; any other input is refused `ego_visual_dynamics_input_invalid`). The timeline key changes; without the flag the timeline is unchanged","name":"--visual-dynamics","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"execution":"local-runtime","help":"With --visual-dynamics: the rate the log's poses were recorded at, Hz. Default: 50. A rate the poses contradict (a resampled lower-rate log declared higher) is refused, and so is a pose-only log below 10 Hz","name":"--vd-rate-hz","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"HZ"},{"commandIndex":1,"default":"rgb","execution":"local-runtime","help":"Camera passes, comma-separated. The shared render output contract defaults to RGB only","name":"--passes","positional":false,"possibleValues":["rgb","hdr","id","depth","semantic"],"repeatable":true,"required":false,"takesValue":true,"type":"enum","valueName":"PASSES"},{"commandIndex":1,"execution":"local-runtime","help":"Capture renderer-relative HDR before postprocess, with capture-owned provenance","name":"--camera-capture-stage","positional":false,"possibleValues":["scene-pre-postprocess/v1"],"required":false,"takesValue":true,"type":"enum","valueName":"CAMERA_CAPTURE_STAGE"},{"commandIndex":1,"execution":"local-runtime","help":"Render-config overrides on the preset (`key=value`, e.g. `aa.mode=fxaa`); repeatable","name":"--set","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"KEY=VALUE"},{"commandIndex":1,"execution":"local-runtime","help":"The staged texture tier (photoreal presets). Default: uastc-full","name":"--textures","positional":false,"possibleValues":["uastc-full","bc7-512"],"required":false,"takesValue":true,"type":"enum","valueName":"TEXTURES"},{"commandIndex":1,"default":"auto","execution":"local-runtime","help":"Encode videos with ffmpeg","name":"--video","positional":false,"possibleValues":["auto","required","off"],"required":false,"takesValue":true,"type":"enum","valueName":"VIDEO"},{"commandIndex":1,"conflictsWith":["--first-frame"],"execution":"local-runtime","help":"Simulate only (native): the same timeline, scene state, rig schedule and job as a render, each tick applied and observed in a device-free world (`observed-frames.jsonl`, the parity gate, `results.json`), with no frame drawn, no video and no GPU","name":"--simulate-only","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"execution":"local-runtime","help":"Render the first frame only (native): tick 0 of the same job, every camera as its RGB PNG (no video). Every camera must capture tick 0","name":"--first-frame","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"default":"on","execution":"local-runtime","help":"Native: `on` (default) lowers each four-wheeler's body pitch and roll and the road attitude into the frames (cameras and sensors on a body mount tilt with it); `off` lowers yaw-only rotations, the rigid twin of the same render. Recorded as `lowering.attitude`","name":"--attitude","positional":false,"possibleValues":["on","off"],"required":false,"takesValue":true,"type":"enum","valueName":"ATTITUDE"},{"commandIndex":1,"execution":"local-runtime","help":"A texture budget in bytes; without it the device capacity is unmeasured and admission is skipped (reported)","minimum":0,"name":"--vram-budget","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"BYTES"},{"commandIndex":1,"execution":"local-runtime","help":"Render on a software (CPU) Vulkan adapter such as lavapipe, explicitly. Slow; pixels differ from a GPU's","name":"--allow-software-adapter","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"execution":"local-runtime","help":"Write `render.progress` events to stderr (the step, and frames done of the total while drawing)","name":"--progress","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"execution":"local-runtime","help":"Use this native map directory (`.corpus/<map>`) instead of the installed map found by content","name":"--map-dir","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":1,"execution":"local-runtime","help":"Map cache root to search. Default: SIMFORGE_MAPS_CACHE_ROOT, then $XDG_DATA_HOME/simforge/maps","name":"--cache-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":1,"execution":"local-runtime","help":"Actor-asset root. Default: SIMFORGE_ACTOR_ASSETS_ROOT, then $XDG_DATA_HOME/simforge/actor-assets","name":"--assets-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":1,"execution":"local-runtime","help":"The actor closure to bind, instead of the workspace's `catalog.actorClosureDigest`","name":"--actor-closure","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":1,"execution":"local-runtime","help":"The workspace's private model layer (an actor closure in the same store) for `workspace.*` models, instead of the workspace's `simforge.actorLayer` extension","name":"--actor-layer","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":1,"execution":"local-runtime","help":"Render on the installed map release even where its members differ from the workspace's map closure (recorded in the result; the default refuses)","name":"--allow-map-drift","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":["--cloud","--workspace","--api-url","--idempotency-key","--dry-run","--map-version"],"status":"available","summary":"Render the same scenario file locally or with --cloud","usage":"simforge render [OPTIONS] <TARGET> [EXTRA]..."},{"arguments":[{"commandIndex":1,"help":"Scenario JSON file or materialized workspace; identical input for local and cloud","name":"target","positional":true,"required":true,"type":"path","valueName":"TARGET"},{"commandIndex":1,"help":"Runtime-specific options; forwarded without shell interpolation","name":"extra","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"EXTRA"}],"cloudOnlyGlobals":["--workspace","--api-url","--idempotency-key","--dry-run","--map-version"],"command":"simulate","flags":[{"commandIndex":1,"help":"Output folder; local requires it, cloud waits and downloads when it is given","name":"--out","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"OUT"},{"commandIndex":1,"default":"2d","help":"`2d` (top-down map video on the CPU), `schematic` (the flat OpenDRIVE view, GPU) or `3d` (photoreal camera sensors, GPU)","name":"--mode","positional":false,"possibleValues":["2d","schematic","3d"],"required":false,"takesValue":true,"type":"enum","valueName":"MODE"},{"commandIndex":1,"help":"Sensor rig JSON (`simforge rig init`). Default: the `basic-dash-camera` rig on the ego","name":"--rig","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"RIG"},{"commandIndex":1,"help":"Render preset","name":"--preset","positional":false,"possibleValues":["training","showcase","schematic"],"required":false,"takesValue":true,"type":"enum","valueName":"PRESET"},{"commandIndex":1,"help":"Local native render only: authored instantaneous HDR detector response JSON","name":"--camera-detector","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":1,"help":"Local native render only: bounded exact-time HDR exposure request JSON","name":"--camera-temporal","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":1,"help":"Local bounded offline measurement delivery or controlled delivery-only resume","name":"--camera-delivery","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":1,"help":"Frame rate every camera records (2d: the video's), over the render preset's own rate; 3d takes 5 to 60","name":"--fps","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"FPS"},{"commandIndex":1,"help":"Wait for a submitted cloud job to finish","name":"--wait","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"help":"Download a succeeded cloud job into --out; implies --wait","name":"--download","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"help":"Explicit maximum cloud cost in cents; required for billable cloud jobs","minimum":0,"name":"--max-cost","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"CENTS"},{"commandIndex":1,"help":"Immutable revision for an existing hosted scenario target","name":"--revision","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"REVISION"},{"commandIndex":1,"help":"With --cloud: save a scenario file to the workspace as an immutable revision (free) and price the run on it; starts nothing. --dry-run saves nothing","name":"--stage","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"help":"Cloud 3d render: the drive a succeeded closed_loop run scored (its episode timeline), rendered on the target's revision that run drove","name":"--replay-of","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"RUN_ID"},{"commandIndex":1,"help":"Ego dynamics model for this run: `dynamic-v1` (the engine's own model, today's behaviour), `kinematic-bicycle` (Helios episodes only) or `full-car-v1` (reserved, refused until admitted). Outranks the scenario's `physics.egoDynamics`. Omitted: the run-mode default, which the result records","name":"--ego-dynamics","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"MODEL"},{"commandIndex":1,"help":"The vehicle for an ego actor, `ACTOR=CATALOG_ID`, repeatable. A vehicle pack needs pack profiles, which are not enabled yet: refused `ego_vehicle_unsupported`, never run on the class profile","name":"--ego-vehicle","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"ACTOR=CATALOG_ID"},{"commandIndex":1,"execution":"local-runtime","help":"Override the resolution's seed (the trace is then expected to differ)","name":"--seed","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SEED"},{"commandIndex":1,"execution":"local-runtime","help":"Use this map directory instead of the installed map found by content (map.xodr[.gz] sha256 = the manifest's map.xodrSha256)","name":"--map-dir","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":1,"execution":"local-runtime","help":"Map cache root to search. Default: SIMFORGE_MAPS_CACHE_ROOT, then $XDG_DATA_HOME/simforge/maps","name":"--cache-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":1,"execution":"local-runtime","help":"Instance mode (the positional is an instance file): also write the trace here (gzip JSON)","name":"--trace","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":1,"execution":"local-runtime","help":"Simulate without map colliders when the map publishes none (recorded in the result; the default refuses)","name":"--allow-no-colliders","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":["--cloud","--workspace","--api-url","--idempotency-key","--dry-run","--map-version"],"status":"available","summary":"Simulate the same scenario file locally or with --cloud","usage":"simforge simulate [OPTIONS] <TARGET> [EXTRA]..."},{"arguments":[{"commandIndex":2,"help":"Scenario JSON file or materialized workspace; identical input for local and cloud","name":"target","positional":true,"required":true,"type":"path","valueName":"TARGET"},{"commandIndex":2,"help":"Runtime-specific options; forwarded without shell interpolation","name":"extra","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"EXTRA"}],"cloudOnlyGlobals":["--workspace","--api-url","--idempotency-key","--dry-run","--map-version"],"command":"preview frame","flags":[{"commandIndex":2,"help":"Output file (PNG for a frame, MP4 for a clip)","name":"--out","positional":false,"required":true,"takesValue":true,"type":"path","valueName":"OUT"},{"commandIndex":2,"default":"2d","help":"`2d` (top-down map video on the CPU), `schematic` (the flat OpenDRIVE view, GPU) or `3d` (photoreal camera sensors, GPU)","name":"--mode","positional":false,"possibleValues":["2d","schematic","3d"],"required":false,"takesValue":true,"type":"enum","valueName":"MODE"},{"commandIndex":2,"help":"Sensor rig JSON (`simforge rig init`). Default: the `basic-dash-camera` rig on the ego","name":"--rig","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"RIG"},{"commandIndex":2,"help":"The rig camera to look through","name":"--camera","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"CAMERA"},{"commandIndex":2,"default":"0","help":"Scenario time in seconds","name":"--at","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"AT"},{"commandIndex":2,"help":"Clip length in seconds","name":"--seconds","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"SECONDS"},{"commandIndex":2,"help":"Render preset","name":"--preset","positional":false,"possibleValues":["training","showcase","schematic"],"required":false,"takesValue":true,"type":"enum","valueName":"PRESET"},{"commandIndex":2,"help":"Overwrite an existing output file","name":"--force","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"help":"Explicit maximum cloud cost in cents; required for billable cloud jobs","minimum":0,"name":"--max-cost","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"CENTS"},{"commandIndex":2,"help":"Immutable revision for an existing hosted scenario target","name":"--revision","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"REVISION"},{"commandIndex":2,"help":"With --cloud: save a scenario file to the workspace as an immutable revision (free) and price the preview on it; starts nothing. --dry-run saves nothing","name":"--stage","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"help":"Wait for a submitted cloud job to finish","name":"--wait","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"help":"Download a succeeded cloud job into --out; implies --wait","name":"--download","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"execution":"local-runtime","help":"Render on this native map directory (`.corpus/<map>`) instead of the installed map found by content","name":"--map-dir","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"execution":"local-runtime","help":"The 2D camera's ego actor; otherwise the workspace or scenario selects it","name":"--ego","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"ACTOR_ID"},{"commandIndex":2,"execution":"local-runtime","help":"The staged texture tier of a photoreal preview (as `render --textures`). Default: uastc-full","name":"--textures","positional":false,"possibleValues":["uastc-full","bc7-512"],"required":false,"takesValue":true,"type":"enum","valueName":"TEXTURES"}],"globals":["--cloud","--workspace","--api-url","--idempotency-key","--dry-run","--map-version"],"status":"available","summary":"One still frame of a scenario at --at seconds (PNG), locally or with --cloud","usage":"simforge preview frame [OPTIONS] --out <OUT> <TARGET> [EXTRA]..."},{"arguments":[{"commandIndex":2,"help":"Scenario JSON file or materialized workspace; identical input for local and cloud","name":"target","positional":true,"required":true,"type":"path","valueName":"TARGET"},{"commandIndex":2,"help":"Runtime-specific options; forwarded without shell interpolation","name":"extra","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"EXTRA"}],"cloudOnlyGlobals":["--workspace","--api-url","--idempotency-key","--dry-run","--map-version"],"command":"preview clip","flags":[{"commandIndex":2,"help":"Output file (PNG for a frame, MP4 for a clip)","name":"--out","positional":false,"required":true,"takesValue":true,"type":"path","valueName":"OUT"},{"commandIndex":2,"default":"2d","help":"`2d` (top-down map video on the CPU), `schematic` (the flat OpenDRIVE view, GPU) or `3d` (photoreal camera sensors, GPU)","name":"--mode","positional":false,"possibleValues":["2d","schematic","3d"],"required":false,"takesValue":true,"type":"enum","valueName":"MODE"},{"commandIndex":2,"help":"Sensor rig JSON (`simforge rig init`). Default: the `basic-dash-camera` rig on the ego","name":"--rig","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"RIG"},{"commandIndex":2,"help":"The rig camera to look through","name":"--camera","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"CAMERA"},{"commandIndex":2,"default":"0","help":"Scenario time in seconds","name":"--at","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"AT"},{"commandIndex":2,"help":"Clip length in seconds","name":"--seconds","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"SECONDS"},{"commandIndex":2,"help":"Render preset","name":"--preset","positional":false,"possibleValues":["training","showcase","schematic"],"required":false,"takesValue":true,"type":"enum","valueName":"PRESET"},{"commandIndex":2,"help":"Overwrite an existing output file","name":"--force","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"help":"Explicit maximum cloud cost in cents; required for billable cloud jobs","minimum":0,"name":"--max-cost","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"CENTS"},{"commandIndex":2,"help":"Immutable revision for an existing hosted scenario target","name":"--revision","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"REVISION"},{"commandIndex":2,"help":"With --cloud: save a scenario file to the workspace as an immutable revision (free) and price the preview on it; starts nothing. --dry-run saves nothing","name":"--stage","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"help":"Wait for a submitted cloud job to finish","name":"--wait","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"help":"Download a succeeded cloud job into --out; implies --wait","name":"--download","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"execution":"local-runtime","help":"Render on this native map directory (`.corpus/<map>`) instead of the installed map found by content","name":"--map-dir","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"execution":"local-runtime","help":"The 2D camera's ego actor; otherwise the workspace or scenario selects it","name":"--ego","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"ACTOR_ID"},{"commandIndex":2,"execution":"local-runtime","help":"The staged texture tier of a photoreal preview (as `render --textures`). Default: uastc-full","name":"--textures","positional":false,"possibleValues":["uastc-full","bc7-512"],"required":false,"takesValue":true,"type":"enum","valueName":"TEXTURES"}],"globals":["--cloud","--workspace","--api-url","--idempotency-key","--dry-run","--map-version"],"status":"available","summary":"A short clip of a scenario from --at for --seconds (MP4), locally or with --cloud","usage":"simforge preview clip [OPTIONS] --out <OUT> <TARGET> [EXTRA]..."},{"arguments":[],"command":"mcp","flags":[{"commandIndex":1,"help":"Working directory for tool calls that do not pass `cwd` (default: this process's)","name":"--cwd","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":1,"conflictsWith":["--only"],"default":"core","help":"Which tools to list: `core` (the authoring, render and run loop, plus the `simforge` tool that runs any command) or `full` (every command as its own tool)","name":"--profile","positional":false,"possibleValues":["core","full"],"required":false,"takesValue":true,"type":"enum","valueName":"PROFILE"},{"commandIndex":1,"help":"Expose only the commands under these command paths, from the full surface (repeatable, e.g. `--only render --only \"scenario apply\"`)","name":"--only","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"COMMAND"},{"commandIndex":1,"help":"Also expose the internal (staff and research) commands that `help` lists only with `--all`; an `--only` naming one exposes it too","name":"--all","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":["--cloud","--workspace","--idempotency-key","--dry-run","--api-url","--map-version"],"status":"available","summary":"Expose this command surface as MCP tools over stdio","usage":"simforge mcp [OPTIONS]"},{"arguments":[],"command":"rig schema","flags":[],"globals":[],"status":"available","summary":"Print the Platform-generated render-rig/v1 JSON Schema; cross-field checks also run in validate","usage":"simforge rig schema [OPTIONS]"},{"arguments":[],"command":"rig capabilities","flags":[],"globals":[],"status":"available","summary":"Print the generated native camera declaration; support tiers do not imply device qualification","usage":"simforge rig capabilities [OPTIONS]"},{"arguments":[],"command":"rig reported-schema","flags":[],"globals":[],"status":"available","summary":"Print the reported-only calibration JSON Schema; hash integrity is checked by the consumer parser","usage":"simforge rig reported-schema [OPTIONS]"},{"arguments":[],"command":"rig consumer-schema","flags":[],"globals":[],"status":"available","summary":"Print the v2 consumer acquisition sidecar schema; timestamps are scheduled render instants","usage":"simforge rig consumer-schema [OPTIONS]"},{"arguments":[],"command":"rig consumer-video-schema","flags":[],"globals":[],"status":"available","summary":"Print the legacy v1 consumer video sidecar schema, which has no acquisition timestamps","usage":"simforge rig consumer-video-schema [OPTIONS]"},{"arguments":[{"commandIndex":2,"help":"The `simforge.render-rig/v1` file","name":"rig","positional":true,"required":true,"type":"path","valueName":"RIG.JSON"}],"command":"rig effective-config","flags":[{"commandIndex":2,"help":"Require a camera feature; repeat for each requirement. Unsupported combinations fail closed","name":"--require","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"CAMERA.FEATURE"}],"globals":[],"status":"available","summary":"Resolve camera identity and required features without executing a renderer","usage":"simforge rig effective-config [OPTIONS] <RIG.JSON>"},{"arguments":[],"command":"rig init","flags":[{"commandIndex":2,"help":"The built-in rig","name":"--preset","positional":false,"possibleValues":["basic-dash-camera","tesla-hw3","waymo-5th-gen","surround-7cam-1lidar","roof-8cam-6lidar-4radar","alpamayo-2cam","alpamayo-4cam","alpamayo-6cam","alpamayo-6cam-vqa","front-4cam-wide-cross-tele","physicalai-av-7cam","drone-inspection-wide","drone-inspection-wide-zoom","drone-mapping-nadir","drone-fpv-forward","qwen-drive-3cam"],"required":true,"takesValue":true,"type":"enum","valueName":"PRESET"},{"commandIndex":2,"default":"car","help":"The carrier class whose default box the mounts are fitted to: car, truck or van for a road rig, drone for a drone rig; a calibrated rig takes only its own class","name":"--class","positional":false,"possibleValues":["car","truck","van","drone"],"required":false,"takesValue":true,"type":"enum","valueName":"CLASS"},{"commandIndex":2,"help":"The render profile whose capture (size and frame rate) every camera of a fitted rig records, showcase when omitted; a calibrated rig records its native capture and refuses one","name":"--profile","positional":false,"possibleValues":["training","showcase"],"required":false,"takesValue":true,"type":"enum","valueName":"PROFILE"},{"commandIndex":2,"default":"ego","help":"The actor named in the file (every source's `actorId`); a render re-hosts a placeholder on the scenario's ego and refuses a file naming another of its roles","name":"--actor","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":2,"help":"Where to write the rig","name":"--out","positional":false,"required":true,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":2,"help":"Overwrite an existing file","name":"--force","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":[],"status":"available","summary":"Write a built-in rig, fitted to a carrier class's default box or as calibrated on one vehicle, as a `simforge.render-rig/v1` file","usage":"simforge rig init [OPTIONS] --preset <PRESET> --out <FILE>"},{"arguments":[{"commandIndex":2,"help":"A `simforge.render-rig/v1` file","name":"rig","positional":true,"required":true,"type":"path","valueName":"RIG.JSON"}],"command":"rig validate","flags":[],"globals":[],"status":"available","summary":"Check a `simforge.render-rig/v1` file as a render reads it; the installed runtime plans a camera lens (cameraModel). Exit 2 with the finding","usage":"simforge rig validate [OPTIONS] <RIG.JSON>"},{"arguments":[{"commandIndex":2,"help":"A `simforge.render-rig/v1` file","name":"rig","positional":true,"required":true,"type":"path","valueName":"RIG.JSON"}],"command":"rig show","flags":[],"globals":[],"status":"available","summary":"What a rig captures: each source's mount, the way it faces and its field of view, and the cameras' horizontal coverage; the installed runtime shows a rig with a camera lens","usage":"simforge rig show [OPTIONS] <RIG.JSON>"},{"arguments":[{"commandIndex":2,"help":"The model, a binary glTF (.glb)","name":"model","positional":true,"required":true,"type":"path","valueName":"MODEL.GLB"}],"command":"vehicle validate","flags":[{"commandIndex":2,"default":"car","help":"The road-vehicle class it will drive as: car, van, truck or bus (sets the plausible size)","name":"--class","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"CLASS"},{"commandIndex":2,"help":"Its real length, width and height in metres (`4.6,1.85,1.45`); the model must match within 10%","name":"--dims","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"L,W,H"}],"globals":[],"status":"available","summary":"Check a .glb against the vehicle model contract (frame, size, wheel and body nodes, triangle budget, materials, textures); exit 2 on any error","usage":"simforge vehicle validate [OPTIONS] <MODEL.GLB>"},{"arguments":[],"cloudOnlyGlobals":["--workspace","--api-url","--idempotency-key"],"command":"vehicle list","flags":[],"globals":["--cloud","--workspace","--api-url","--idempotency-key"],"status":"available","summary":"The vehicles a scenario can bind by catalogId: the shared catalog's and, signed in, the workspace's own (`workspace.<id>`)","usage":"simforge vehicle list [OPTIONS]"},{"arguments":[{"commandIndex":2,"help":"The model, a binary glTF (.glb)","name":"model","positional":true,"required":true,"type":"path","valueName":"MODEL.GLB"}],"command":"vehicle import","flags":[{"commandIndex":2,"help":"Its id within the workspace: scenarios bind it as `workspace.<id>` (lowercase letters, digits, `_`, `-`; at most 48)","name":"--id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":2,"help":"Its licence: an SPDX id (`CC-BY-4.0`) or `LicenseRef-<name>` with --license-text","name":"--license","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"SPDX"},{"commandIndex":2,"help":"The licence's text, for a `LicenseRef-*` licence","name":"--license-text","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":2,"help":"The credit the licence asks for (author, title, link)","name":"--attribution","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":2,"help":"Where the model came from (URL or text)","name":"--source","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":2,"help":"Its display name. Default: the id","name":"--name","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":2,"default":"car","help":"The road-vehicle class it drives as: car, van, truck or bus","name":"--class","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"CLASS"},{"commandIndex":2,"help":"Its real length, width and height in metres; the model must match within 10%","name":"--dims","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"L,W,H"}],"globals":["--cloud","--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Validate a .glb here, upload it and store it as the workspace's own `workspace.<id>` (private to the workspace); the licence and attribution travel with every render","usage":"simforge vehicle import [OPTIONS] --id <ID> --license <SPDX> --attribution <TEXT> <MODEL.GLB>"},{"arguments":[],"command":"skills list","flags":[],"globals":[],"status":"available","summary":"List the skills bundled with this binary","usage":"simforge skills list [OPTIONS]"},{"arguments":[],"command":"skills install","flags":[{"commandIndex":2,"help":"Install into ~/.claude/skills (Claude Code)","name":"--claude","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"help":"Install into $CODEX_HOME/skills, else ~/.codex/skills (Codex)","name":"--codex","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"help":"Install into this directory","name":"--dir","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"PATH"},{"commandIndex":2,"help":"Overwrite files that differ from what an earlier install wrote","name":"--force","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":[],"groups":[{"args":["--claude","--codex","--dir"],"multiple":false,"required":true}],"status":"available","summary":"Copy the bundled skills into an agent's skill directory; agentHost says how to register simforge mcp with that host and which instructions to add","usage":"simforge skills install [OPTIONS] <--claude|--codex|--dir <PATH>>"},{"arguments":[],"command":"telemetry show","flags":[],"globals":[],"status":"available","summary":"Print the pending usage batches exactly as the runtime will send them","usage":"simforge telemetry show [OPTIONS]"},{"arguments":[],"command":"usage","flags":[{"commandIndex":1,"help":"Start of the period (ISO 8601 date or time)","name":"--from","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"FROM"},{"commandIndex":1,"help":"End of the period (ISO 8601 date or time)","name":"--to","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TO"}],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Hosted usage and spend of the signed-in workspace","usage":"simforge usage [OPTIONS]"},{"arguments":[],"command":"keys create","flags":[{"commandIndex":2,"help":"A name to recognize the key by (1-200 characters)","name":"--name","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"NAME"},{"commandIndex":2,"help":"A scope the key holds (repeatable). Default: maps:read scenarios:read scenarios:write datasets:read runs:read runs:write artifacts:read usage:read","name":"--scope","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"SCOPE"},{"commandIndex":2,"help":"Expire the key after this many days (1-3650). Default: no expiry","maximum":3650,"minimum":1,"name":"--expires-in-days","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"DAYS"}],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Create an API key for this workspace; its secret is printed once","usage":"simforge keys create [OPTIONS] --name <NAME>"},{"arguments":[],"command":"keys list","flags":[],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"List the workspace's API keys (never their secrets)","usage":"simforge keys list [OPTIONS]"},{"arguments":[{"commandIndex":2,"help":"The key's id (`key_…`, from `simforge keys list`)","name":"id","positional":true,"required":true,"type":"string","valueName":"ID"}],"command":"keys revoke","flags":[],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Revoke an API key now; requests with it stop resolving immediately","usage":"simforge keys revoke [OPTIONS] <ID>"},{"arguments":[{"commandIndex":2,"help":"The draft's document id (from its receipt)","name":"draft_id","positional":true,"required":true,"type":"string","valueName":"DRAFT_ID"}],"command":"drafts show","flags":[],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"The draft's current receipt and content: version, digest, map/actor/recording pins","usage":"simforge drafts show [OPTIONS] <DRAFT_ID>"},{"arguments":[{"commandIndex":2,"help":"The draft's document id (from its receipt)","name":"draft_id","positional":true,"required":true,"type":"string","valueName":"DRAFT_ID"}],"command":"drafts save","flags":[{"commandIndex":2,"help":"The draftVersion of the receipt this change is based on","minimum":0,"name":"--expected-version","positional":false,"required":true,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"The contentDigest of the receipt this change is based on","name":"--expected-digest","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"SHA256"}],"globals":["--workspace","--api-url","--idempotency-key","--dry-run"],"status":"available","summary":"Save the draft through the workspace store at an explicit version and digest","usage":"simforge drafts save [OPTIONS] --expected-version <N> --expected-digest <SHA256> <DRAFT_ID>"},{"arguments":[{"commandIndex":2,"help":"The draft's document id (from its receipt)","name":"draft_id","positional":true,"required":true,"type":"string","valueName":"DRAFT_ID"}],"command":"drafts freeze","flags":[{"commandIndex":2,"help":"The draftVersion of the receipt this change is based on","minimum":0,"name":"--expected-version","positional":false,"required":true,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"The contentDigest of the receipt this change is based on","name":"--expected-digest","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"The revision's name","name":"--name","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"NAME"}],"globals":["--workspace","--api-url","--idempotency-key","--dry-run"],"status":"available","summary":"Freeze the draft as an immutable revision (revisionId, revisionContentDigest) for simulate/render","usage":"simforge drafts freeze [OPTIONS] --expected-version <N> --expected-digest <SHA256> <DRAFT_ID>"},{"arguments":[],"command":"authoring catalogue","flags":[],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"The host's operation catalogue (simforge.authoring-operations/v1)","usage":"simforge authoring catalogue [OPTIONS]"},{"arguments":[],"command":"authoring capabilities","flags":[],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"What this credential may do on this host: operation, host-operation, feature and worker status","usage":"simforge authoring capabilities [OPTIONS]"},{"arguments":[{"commandIndex":2,"help":"One operation id (camelCase or its kebab-case command); absent, every operation","name":"operation","positional":true,"required":false,"type":"string","valueName":"OP_ID"}],"command":"authoring operations","flags":[],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Every operation with its `scenario apply` flags, result schema and the host's status for this credential","usage":"simforge authoring operations [OPTIONS] [OP_ID]"},{"arguments":[],"command":"authoring discover","description":"One page of map discovery without the map package: locations, lanes, movements or the actor catalogue.\n\nEvery kind prints `{mapPin, kind, total, records, nextCursor, warnings}`: `total` counts every match of the filters, and `--cursor <nextCursor>` with the same --map, --kind and filters prints the next page (`nextCursor` is null on the last one). A lane record's `carS` is the range of stations along travel where a car fits and `place` the exact `add-actor --lane-rsl --s` that put one there (nearest `--near` when given). A crosswalk location's `crossing` gives its two kerb `endpoints` (scene x,z) and every driving lane through it (`approaches`: `laneRsl`, `stopS`/`conflictS` along travel, as `--s` takes them, `forward`, `rightEndpoint`, and for a junction's connecting lane the `fromLaneRsl` and `turnRelation` that feed it).","flags":[{"commandIndex":2,"help":"The exact map version to look up (`maps list` names them)","name":"--map","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"MAP_VERSION_ID"},{"commandIndex":2,"help":"lanes, movements (junction connectors), locations (crosswalks, junctions, ...) or catalogue (built-in actors)","name":"--kind","positional":false,"possibleValues":["locations","lanes","movements","catalogue"],"required":true,"takesValue":true,"type":"enum","valueName":"KIND"},{"commandIndex":2,"default":"20","help":"Records per page (1 to 100)","maximum":100,"minimum":1,"name":"--limit","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"Nearest first from this scene point, metres (`x` east, `z` minus north); not with --kind catalogue","name":"--near","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"X,Z"},{"commandIndex":2,"help":"Only records within this many metres of --near (> 0)","name":"--within-m","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"M"},{"commandIndex":2,"help":"Only records on this OpenDRIVE road: its lanes, movements entering, leaving or on it, locations anchored on it; not with --kind catalogue","name":"--road","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"ROAD_ID"},{"commandIndex":2,"help":"Only locations of this type (with --kind locations)","name":"--type","positional":false,"possibleValues":["junction","junction_movement","driving_corridor","bike_corridor","walking_corridor","midblock_segment","merge_zone","lane_drop","parking_lane","parking_space","parking_area","parking_access_point","driveway","loading_zone","bus_stop","crosswalk","sidewalk","curb","median","refuge_island","building_entrance","school_zone","work_zone_suitable","occlusion_zone","conflict_zone","poi_frontage","address"],"required":false,"takesValue":true,"type":"enum","valueName":"TYPE"},{"commandIndex":2,"help":"The previous page's `nextCursor`, with the same --map, --kind and filters","name":"--cursor","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"CURSOR"}],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"One page of map discovery without the map package: locations, lanes, movements or the actor catalogue","usage":"simforge authoring discover [OPTIONS] --map <MAP_VERSION_ID> --kind <KIND>"},{"arguments":[],"command":"authoring spawn","flags":[{"commandIndex":2,"help":"The exact map version to place on","name":"--map","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"MAP_VERSION_ID"},{"commandIndex":2,"help":"The actor's catalog id (`authoring discover --kind catalogue`)","name":"--catalog-id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":2,"conflictsWith":["--x","--z"],"help":"A lane handle from `authoring discover --kind lanes` (with --s)","name":"--lane-rsl","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"RSL"},{"commandIndex":2,"help":"Metres along the lane from its start (with --lane-rsl)","name":"--s","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"S"},{"commandIndex":2,"help":"A scene point (with --z)","name":"--x","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"X"},{"commandIndex":2,"help":"The scene point's z in metres (with --x)","name":"--z","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"Z"},{"commandIndex":2,"help":"The heading in radians in the scene frame. Default: the lane's direction","name":"--heading-rad","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"HEADING_RAD"},{"commandIndex":2,"help":"Sideways offset from the lane centre in metres (positive left)","name":"--lateral-m","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"LATERAL_M"},{"commandIndex":2,"help":"Face against the lane's direction","name":"--opposing","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"help":"Place a parked (static) actor","name":"--static","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"help":"Check overlap against this draft's actors (needs --expected-version and --expected-digest)","name":"--draft","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"DRAFT_ID"},{"commandIndex":2,"help":"The draftVersion of the receipt the check is based on (with --draft)","minimum":0,"name":"--expected-version","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"The contentDigest of the receipt the check is based on (with --draft)","name":"--expected-digest","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"}],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Whether an actor can be placed at a lane position or scene point, optionally against a draft's actors","usage":"simforge authoring spawn [OPTIONS] --map <MAP_VERSION_ID> --catalog-id <ID>"},{"arguments":[],"command":"scenarios list","flags":[{"commandIndex":2,"default":"20","help":"At most this many items on the page","maximum":100,"minimum":1,"name":"--limit","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"LIMIT"},{"commandIndex":2,"help":"The next page: the `nextCursor` of the page before it","name":"--cursor","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"CURSOR"}],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"List the hosted scenarios of your workspace","usage":"simforge scenarios list [OPTIONS]"},{"arguments":[{"commandIndex":2,"help":"The id","name":"id","positional":true,"required":true,"type":"string","valueName":"ID"}],"command":"scenarios show","flags":[],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"One hosted scenario and its revisions","usage":"simforge scenarios show [OPTIONS] <ID>"},{"arguments":[],"command":"scenarios create","flags":[{"commandIndex":2,"conflictsWith":["--template"],"help":"A recording (`simforge.recording/v1`, or a `simforge.log-scene/v1` file), JSON or gzipped","name":"--log","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"LOG"},{"commandIndex":2,"conflictsWith":["--log"],"help":"A scenario template, instantiated at a site of the map","name":"--template","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"TEMPLATE"},{"commandIndex":2,"help":"The map: a map version id, a map name or `name@vN`","name":"--map","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"MAP"},{"commandIndex":2,"help":"The site to instantiate a template at; absent, its own pin or the first intent-preserving match","name":"--site","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SITE"},{"commandIndex":2,"help":"`simulation.seed` of the instantiated scenario","name":"--seed","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"SEED"},{"commandIndex":2,"help":"The new scenario's name","name":"--name","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"NAME"},{"commandIndex":2,"help":"Explicit maximum cloud cost in cents; required for billable cloud jobs","minimum":0,"name":"--max-cost","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"CENTS"},{"commandIndex":2,"help":"With --log: upload the recording and price its import, starting nothing. --dry-run uploads nothing","name":"--stage","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"help":"MCAP only: the lidar topic, when the log has several","name":"--lidar-topic","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TOPIC"},{"commandIndex":2,"help":"MCAP only: the GNSS topic, when the log has several","name":"--gnss-topic","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TOPIC"},{"commandIndex":2,"help":"MCAP only: the ego's box in metres, length,width,height (perceive's default otherwise)","name":"--ego-dims","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"number","valueName":"L,W,H"},{"commandIndex":2,"help":"MCAP only: how far the ego box's centre is ahead of base_link (the rear axle), metres","name":"--ego-rear-axle-to-centre","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"METRES"}],"globals":["--workspace","--api-url","--idempotency-key","--dry-run"],"status":"available","summary":"Create a hosted scenario from a recording or a template on a map","usage":"simforge scenarios create [OPTIONS] --map <MAP> --name <NAME>"},{"arguments":[{"commandIndex":2,"help":"The hosted scenario to copy","name":"id","positional":true,"required":true,"type":"string","valueName":"ID"}],"command":"scenarios copy","flags":[{"commandIndex":2,"help":"The dataset to copy into. Default: the scenario's own, else your default dataset","name":"--dataset","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"DATASET_ID"},{"commandIndex":2,"help":"The copy's name. Default: \"<name> (copy)\", or \"(copy 2)\", ... when taken","name":"--name","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"NAME"}],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Copy a hosted scenario to edit: its current draft as a new scenario; renders and runs stay","usage":"simforge scenarios copy [OPTIONS] <ID>"},{"arguments":[],"command":"datasets list","flags":[{"commandIndex":2,"default":"20","help":"At most this many items on the page","maximum":100,"minimum":1,"name":"--limit","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"LIMIT"},{"commandIndex":2,"help":"The next page: the `nextCursor` of the page before it","name":"--cursor","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"CURSOR"},{"commandIndex":2,"help":"Only the datasets SimForge shares with every workspace (read-only; `datasets copy` copies their scenarios)","name":"--shared","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"List your workspace's hosted datasets and the ones SimForge shares with every workspace (`shared`, `readOnly`, `owner`)","usage":"simforge datasets list [OPTIONS]"},{"arguments":[{"commandIndex":2,"help":"The id","name":"id","positional":true,"required":true,"type":"string","valueName":"ID"}],"command":"datasets show","flags":[],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"One hosted dataset","usage":"simforge datasets show [OPTIONS] <ID>"},{"arguments":[{"commandIndex":2,"help":"The dataset id (`simforge datasets list`)","name":"dataset","positional":true,"required":true,"type":"string","valueName":"DATASET"}],"command":"datasets pull","flags":[{"commandIndex":2,"help":"Library filters as `key:value` (repeat a key or comma-separate values), e.g. 'grade:A tag:cut-in'","name":"--filter","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"FILTER"},{"commandIndex":2,"help":"Free-text search, as in the library's search box","name":"--q","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"Q"},{"commandIndex":2,"help":"Only the scenarios of one recorded drive (its recording digest or source id)","name":"--source-log","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SOURCE_LOG"},{"commandIndex":2,"conflictsWith":["--filter","--q","--source-log"],"help":"Exactly these scenarios (document ids, comma-separated)","name":"--ids","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"IDS"},{"commandIndex":2,"help":"Beside each scenario's document, OpenSCENARIO, trace and resolution: renders[:training|showcase|schematic], labels, gt, recordings, generated (Factory clips); default renders:training, `scenarios` alone for nothing else","name":"--include","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"INCLUDE"},{"commandIndex":2,"help":"Keep only these render modalities: rgb, depth, semantic, instance, lidar, radar","name":"--passes","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"PASSES"},{"commandIndex":2,"help":"The folder to pull into (required unless --dry-run). Pulling again into it resumes","name":"--out","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"OUT"},{"commandIndex":2,"default":"8","help":"Parallel downloads","maximum":64,"minimum":1,"name":"--jobs","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"JOBS"},{"commandIndex":2,"default":"1800","help":"Seconds to wait for files the platform is still preparing before giving up on them","minimum":0,"name":"--wait-pending","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"WAIT_PENDING"}],"globals":["--workspace","--api-url","--idempotency-key","--dry-run"],"status":"available","summary":"Download a dataset, a filter of it or chosen scenarios as files (resumable; --dry-run sizes it)","usage":"simforge datasets pull [OPTIONS] <DATASET>"},{"arguments":[{"commandIndex":2,"help":"The pulled folder","name":"dir","positional":true,"required":true,"type":"path","valueName":"DIR"}],"command":"datasets verify","flags":[],"globals":[],"status":"available","summary":"Check a pulled folder against its manifest.json and SHA256SUMS (offline)","usage":"simforge datasets verify [OPTIONS] <DIR>"},{"arguments":[{"commandIndex":2,"help":"The dataset id","name":"dataset","positional":true,"required":true,"type":"string","valueName":"DATASET"}],"command":"datasets copy","flags":[{"commandIndex":2,"help":"Library filters as `key:value` (repeat a key or comma-separate values), e.g. 'grade:A tag:cut-in'","name":"--filter","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"FILTER"},{"commandIndex":2,"help":"Free-text search, as in the library's search box","name":"--q","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"Q"},{"commandIndex":2,"help":"Only the scenarios of one recorded drive (its recording digest or source id)","name":"--source-log","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SOURCE_LOG"},{"commandIndex":2,"conflictsWith":["--filter","--q","--source-log"],"help":"Exactly these scenarios (document ids, comma-separated)","name":"--ids","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"IDS"},{"commandIndex":2,"help":"Copy into this dataset of your workspace (its id). This or --new is required, except with --dry-run","name":"--into","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"INTO"},{"commandIndex":2,"help":"Copy into a new dataset of this name. This or --into is required, except with --dry-run","name":"--new","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"NEW"},{"commandIndex":2,"help":"Start the copy and print it without waiting","name":"--detach","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":["--workspace","--api-url","--idempotency-key","--dry-run"],"groups":[{"args":["--into","--new"],"multiple":false,"required":false}],"status":"available","summary":"Copy scenarios of a dataset shared with every workspace (SIMLOG-25k) into one of your datasets","usage":"simforge datasets copy [OPTIONS] <DATASET>"},{"arguments":[{"commandIndex":2,"help":"The id","name":"id","positional":true,"required":true,"type":"string","valueName":"ID"}],"command":"datasets copy-status","flags":[],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"One copy: its state and counts (copied, skipped as already there, failed)","usage":"simforge datasets copy-status [OPTIONS] <ID>"},{"arguments":[{"commandIndex":2,"help":"Directory containing the family's declared safetensors files","name":"directory","positional":true,"required":true,"type":"path","valueName":"DIRECTORY"}],"command":"models upload","flags":[{"commandIndex":2,"help":"Base model family (for example `qwen-drive-1.0`)","name":"--family","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"FAMILY"},{"commandIndex":2,"help":"Workspace-unique fine-tune name","name":"--name","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"NAME"},{"commandIndex":2,"help":"Override a parameter (`name=value`), repeatable","name":"--param","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"PARAMS"},{"commandIndex":2,"help":"Wait for qualification to finish","name":"--wait","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Register, upload and finalize a safetensors fine-tune directory","usage":"simforge models upload [OPTIONS] --family <FAMILY> --name <NAME> <DIRECTORY>"},{"arguments":[],"command":"models list","flags":[],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"List this workspace's fine-tunes","usage":"simforge models list [OPTIONS]"},{"arguments":[{"commandIndex":2,"help":"Fine-tune model version id (`mv_...`)","name":"id","positional":true,"required":true,"type":"string","valueName":"ID"}],"command":"models show","flags":[],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Show one fine-tune","usage":"simforge models show [OPTIONS] <ID>"},{"arguments":[{"commandIndex":2,"help":"Fine-tune model version id (`mv_...`)","name":"id","positional":true,"required":true,"type":"string","valueName":"ID"}],"command":"models delete","flags":[],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Retire one fine-tune","usage":"simforge models delete [OPTIONS] <ID>"},{"arguments":[],"command":"factory params","flags":[],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Every generator parameter: what a scenario clip and a raw generation may set, what is fixed and why, and what one raw generation costs","usage":"simforge factory params [OPTIONS]"},{"arguments":[],"command":"factory looks","flags":[],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"The looks a scenario clip can be made with (an experimental look may not apply well)","usage":"simforge factory looks [OPTIONS]"},{"arguments":[],"command":"factory clip create","flags":[{"commandIndex":3,"conflictsWith":["--dataset","--raw"],"help":"A scenario to make clips of (repeatable)","name":"--scenario","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":3,"conflictsWith":["--raw"],"help":"Every scenario of this dataset of yours","name":"--dataset","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":3,"conflictsWith":["--prompt","--raw"],"help":"A look from `simforge factory looks` (repeatable). Exactly one of --look and --prompt","name":"--look","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":3,"help":"Your own conditions in place of a look, sent as written; with --raw, the request's overall prompt","name":"--prompt","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":3,"help":"One camera's whole prompt, as CAMERA=TEXT (repeatable). A raw generation needs one for every camera","name":"--camera-prompt","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"CAMERA=TEXT"},{"commandIndex":3,"help":"A camera to generate (repeatable): any of the 4-camera rig for scenario clips (default all four), or with --raw each camera you give a control video, in your order","name":"--camera","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"CAMERA"},{"commandIndex":3,"help":"The generator's seed (repeatable for scenario clips: a clip per seed; one with --raw). Default: derived from the request, so the same request makes the same clip","maximum":2147483647,"minimum":0,"name":"--seed","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":3,"conflictsWith":["--seed","--raw"],"help":"Clips per scenario and look, each on its own seed (default 1). Not with --seed","minimum":0,"name":"--seeds-per-look","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":3,"help":"positions: the generator sees the layout and the prompts; simulator: also each camera's first frame, so the clip keeps its lighting","name":"--mode","positional":false,"possibleValues":["positions","simulator"],"required":false,"takesValue":true,"type":"enum","valueName":"MODE"},{"commandIndex":3,"help":"Denoising steps (fixed at 4 by the model)","minimum":0,"name":"--steps","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":3,"help":"Guidance scale (fixed at 1 by the model)","name":"--guidance","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"SCALE"},{"commandIndex":3,"help":"Frames per camera (a scenario clip is fixed at 601 generated, 600 kept: 20 s at 30 fps; with --raw, default the server's own)","minimum":0,"name":"--frames","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":3,"help":"Frame rate (a scenario clip is fixed at 30 fps)","minimum":0,"name":"--fps","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"FPS"},{"commandIndex":3,"help":"The generator's resolution bucket (fixed at 480 by the model)","name":"--resolution","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"BUCKET"},{"commandIndex":3,"help":"The output's aspect bucket, as W,H (16,9 is 832x480; a scenario clip is fixed at 16,9; with --raw, default the bucket closest to the first control video)","name":"--aspect","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"W,H"},{"commandIndex":3,"help":"Whether a vision image conditions as one image (fixed at true by the model)","name":"--condition-video-as-image","positional":false,"possibleValues":["true","false"],"required":false,"takesValue":true,"type":"enum","valueName":"BOOL"},{"commandIndex":3,"help":"A negative prompt (the model takes none)","name":"--negative-prompt","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":3,"help":"The model variant (one is deployed: `simforge factory params` names it)","name":"--model","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"MODEL"},{"commandIndex":3,"help":"One raw generation from your own control videos: no scenario, no labels, no check, charged whatever it shows","name":"--raw","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":3,"help":"With --raw: a camera's control (layout) video, as CAMERA=FILE.mp4 (repeatable, one per camera)","name":"--control","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"CAMERA=FILE"},{"commandIndex":3,"help":"With --raw in simulator mode: a camera's first frame, as CAMERA=FILE.png or .jpg (repeatable, one per camera)","name":"--vision","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"CAMERA=FILE"},{"commandIndex":3,"conflictsWith":["--prompt","--camera-prompt","--camera","--seed","--mode","--steps","--guidance","--frames","--fps","--resolution","--aspect","--condition-video-as-image","--negative-prompt","--model","--control","--vision"],"help":"With --raw: a request.json used with a local Sim-Auto server (or one a generation delivered), sent as it is; its files are read beside it","name":"--from-request","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":3,"help":"The most this may charge, in cents. Default: its quote","minimum":0,"name":"--max-cost-cents","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"CENTS"},{"commandIndex":3,"help":"Start without asking (the quote is still shown); needed when nothing can prompt","name":"--yes","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":3,"help":"Wait until every clip is done, as `simforge factory clip wait`","name":"--wait","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":["--workspace","--api-url","--idempotency-key","--dry-run"],"status":"available","summary":"Make clips of scenarios (--scenario or --dataset, with --look or --prompt), or one raw generation from your own control videos (--raw); priced and confirmed first","usage":"simforge factory clip create [OPTIONS]"},{"arguments":[],"command":"factory clip list","flags":[{"commandIndex":3,"default":"20","help":"At most this many, newest first","maximum":100,"minimum":1,"name":"--limit","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"LIMIT"}],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Your Factory runs and raw generations, newest first, with their clip counts and status","usage":"simforge factory clip list [OPTIONS]"},{"arguments":[{"commandIndex":3,"help":"The run id (`run_...`) of a Factory run or a raw generation","name":"id","positional":true,"required":true,"type":"string","valueName":"ID"}],"command":"factory clip get","flags":[],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"One Factory run or raw generation: each clip's status, verdict, prompt, waiting message, warnings and cost","usage":"simforge factory clip get [OPTIONS] <ID>"},{"arguments":[{"commandIndex":3,"help":"The run id (`run_...`) of a Factory run or a raw generation","name":"id","positional":true,"required":true,"type":"string","valueName":"ID"}],"command":"factory clip wait","flags":[],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Wait until every clip of a run (or a raw generation) is done, showing what each waits for; exits non-zero when any failed","usage":"simforge factory clip wait [OPTIONS] <ID>"},{"arguments":[{"commandIndex":3,"help":"The run id (`run_...`) of a Factory run or a raw generation","name":"id","positional":true,"required":true,"type":"string","valueName":"ID"}],"command":"factory clip cancel","flags":[],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Cancel a Factory run or raw generation; clips already checked stay charged","usage":"simforge factory clip cancel [OPTIONS] <ID>"},{"arguments":[{"commandIndex":3,"help":"The run id (`run_...`) of a Factory run or a raw generation","name":"id","positional":true,"required":true,"type":"string","valueName":"ID"}],"command":"factory clip retry","flags":[{"commandIndex":3,"help":"Retry the run's flagged clips, on new seeds","name":"--flagged","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":3,"help":"Retry the run's failed clips, on their own seeds","name":"--failed","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":3,"help":"Retry the run's cancelled clips, on their own seeds","name":"--cancelled","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":3,"help":"The most the retry may charge, in cents. Default: its quote","minimum":0,"name":"--max-cost-cents","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"CENTS"},{"commandIndex":3,"help":"Start without asking (the quote is still shown); needed when nothing can prompt","name":"--yes","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":["--workspace","--api-url","--idempotency-key","--dry-run"],"status":"available","summary":"Make a run's failed, cancelled or flagged clips again, or a failed or cancelled raw generation; priced and confirmed first","usage":"simforge factory clip retry [OPTIONS] <ID>"},{"arguments":[{"commandIndex":3,"help":"The run id (`run_...`) of a Factory run or a raw generation","name":"id","positional":true,"required":true,"type":"string","valueName":"ID"}],"command":"factory clip download","flags":[{"commandIndex":3,"default":".","help":"The folder to download into: the files go under OUT/<id>/. Default: the current folder","name":"--out","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"OUT"},{"commandIndex":3,"help":"Write only OUT/<id>/manifest.json, the signed link, sha256 and size of every file, and download nothing","name":"--links-only","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Download a run's delivered clips or a raw generation's files, with a manifest of signed links (sha256-checked, resumable)","usage":"simforge factory clip download [OPTIONS] <ID>"},{"arguments":[{"commandIndex":2,"help":"The rows: a JSON or YAML list (or an object with `rows`), each a scenario clip run or a raw generation","name":"file","positional":true,"required":true,"type":"path","valueName":"FILE"}],"command":"factory batch","flags":[{"commandIndex":2,"help":"Start without asking (the total is still shown); needed when nothing can prompt","name":"--yes","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"help":"Wait until every row's clips are done","name":"--wait","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":["--workspace","--api-url","--idempotency-key","--dry-run"],"status":"available","summary":"Submit every row of a JSON or YAML file as its own run, priced and confirmed once; running the same file again submits nothing new","usage":"simforge factory batch [OPTIONS] <FILE>"},{"arguments":[{"commandIndex":2,"help":"The driving videos to ask about, in order (MP4, QuickTime or WebM, at most 2 GiB each; 1 to 10)","name":"videos","positional":true,"repeatable":true,"required":true,"type":"path","valueName":"VIDEO"}],"command":"oracle ask","description":"Ask SimForge Oracle a question about driving videos: uploads them, waits and prints the answer and its cost ($0.05 per second of video, at least $0.50 per clip).\n\nstdout is the run's public output: answers, clips, usage, relevance, model and costCents. At a terminal the answer and its cost in cents and dollars are also written to stderr; --json prints the document only. A question that is not about the driving scene is refused (prompt_out_of_scope) and nothing is charged; a run that gives no answer prints the run (exit 2) with its failure code, such as content_blocked, video_unreadable or cost_cap_exceeded, and is not charged.","flags":[{"commandIndex":2,"help":"The question about the driving scene (1 to 4,000 characters)","name":"--prompt","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":2,"help":"Facts the answer may use, such as ego speed, route intent or camera names (at most 16,000 characters)","name":"--context","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":2,"help":"The kind of answer (default driving-qa)","name":"--preset","positional":false,"possibleValues":["driving-qa","causal-chain","hazards","scene-describe"],"required":false,"takesValue":true,"type":"enum","valueName":"PRESET"},{"commandIndex":2,"help":"How long SimForge Oracle reasons before it answers (default medium)","name":"--thinking","positional":false,"possibleValues":["low","medium","high"],"required":false,"takesValue":true,"type":"enum","valueName":"THINKING"},{"commandIndex":2,"help":"How much of each frame SimForge Oracle sees: high reads finer detail (default standard)","name":"--detail","positional":false,"possibleValues":["standard","high"],"required":false,"takesValue":true,"type":"enum","valueName":"DETAIL"},{"commandIndex":2,"help":"Frames per second read from every video, 0.1 to 5 (default 1)","name":"--fps","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":2,"help":"Where every video's clip starts, in seconds (default 0)","name":"--start","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"S"},{"commandIndex":2,"help":"Where every video's clip ends, in seconds (default the video's end)","name":"--end","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"S"},{"commandIndex":2,"help":"A JSON schema file (a JSON object, at most 16 KB): each answer is also returned as JSON of that shape","name":"--schema","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":2,"help":"Independent answers to the same question, 1 to 4 (default 1); each is charged","maximum":4,"minimum":1,"name":"--samples","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"The longest answer, in tokens, 256 to 16,384 (default 8,192)","name":"--max-output-tokens","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"The most this question may charge, in cents: samples x each clip's max(50, 5 per second)","minimum":0,"name":"--max-cost","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"CENTS"},{"commandIndex":2,"conflictsWith":["--no-wait"],"help":"Save the answer's result.json in this folder","name":"--out","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"help":"Print the submitted run and return; follow it with `simforge runs watch`","name":"--no-wait","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Ask SimForge Oracle a question about driving videos: uploads them, waits and prints the answer and its cost ($0.05 per second of video, at least $0.50 per clip)","usage":"simforge oracle ask [OPTIONS] --prompt <TEXT> <VIDEO>..."},{"arguments":[],"command":"oracle serve","description":"Serve SimForge Oracle on a local HTTP endpoint (POST /v1/oracle, GET /healthz) with this machine's sign-in; runs until stopped.\n\nPOST /v1/oracle takes multipart/form-data: one `video` part per video, in order, and one `request` part, the question as JSON: prompt, context, preset, params, under `videos` each video's startS, endS and fps (no uploadId), and maxCostCents (default --max-cost). It answers 200 with the run's public output, or {error: {code, reason, retryable}} with the API's own status, code and Retry-After: an admission refusal such as prompt_out_of_scope, cost_cap_exceeded, relevance_check_unavailable or oracle_capacity_paused, or 422 with the failure code of a run that gave no answer. GET /healthz answers {\"status\": \"ok\"}. A request carrying an Origin header (a web page) is refused.","flags":[{"commandIndex":2,"default":"127.0.0.1","help":"The address to listen on; 127.0.0.1 is this machine only","name":"--bind","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"BIND"},{"commandIndex":2,"default":"8787","help":"The port to listen on","minimum":0,"name":"--port","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"PORT"},{"commandIndex":2,"help":"The most one question may charge, in cents, when its request sets no maxCostCents","minimum":0,"name":"--max-cost","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"CENTS"},{"commandIndex":2,"default":"4","help":"Questions answered at once; later ones wait their turn (1 to 32)","maximum":32,"minimum":1,"name":"--concurrency","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"CONCURRENCY"}],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Serve SimForge Oracle on a local HTTP endpoint (POST /v1/oracle, GET /healthz) with this machine's sign-in; runs until stopped","usage":"simforge oracle serve [OPTIONS]"},{"arguments":[],"command":"runs list","flags":[{"commandIndex":2,"default":"20","help":"At most this many items on the page","maximum":100,"minimum":1,"name":"--limit","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"LIMIT"},{"commandIndex":2,"help":"The next page: the `nextCursor` of the page before it","name":"--cursor","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"CURSOR"},{"commandIndex":2,"help":"Only runs in this status; `active` is queued or running","name":"--status","positional":false,"possibleValues":["queued","running","succeeded","partial","failed","cancelled","active"],"required":false,"takesValue":true,"type":"enum","valueName":"STATUS"},{"commandIndex":2,"help":"Only runs of this type (`render`, `closed_loop`, `scenario_from_log`, ...)","name":"--type","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TYPE"},{"commandIndex":2,"help":"Only runs you submitted: none of your teammates' and none published from other workspaces","name":"--mine","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"help":"Full run objects (input, jobs, billing, result) instead of one summary row per run; `runs show ID` reads one","name":"--full","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"List your workspace's hosted runs, newest first, one summary row each","usage":"simforge runs list [OPTIONS]"},{"arguments":[{"commandIndex":2,"help":"The id","name":"id","positional":true,"required":true,"type":"string","valueName":"ID"}],"command":"runs show","flags":[],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"One hosted run: status, cost, jobs and artifacts","usage":"simforge runs show [OPTIONS] <ID>"},{"arguments":[{"commandIndex":2,"help":"The id","name":"id","positional":true,"required":true,"type":"string","valueName":"ID"}],"command":"runs watch","flags":[],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Follow a hosted run until it succeeds, fails, is partial or is cancelled","usage":"simforge runs watch [OPTIONS] <ID>"},{"arguments":[{"commandIndex":2,"help":"The id","name":"id","positional":true,"required":true,"type":"string","valueName":"ID"}],"command":"runs cancel","flags":[],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Cancel a hosted run; artifacts it already produced are kept","usage":"simforge runs cancel [OPTIONS] <ID>"},{"arguments":[{"commandIndex":2,"help":"The hosted run","name":"run_id","positional":true,"required":true,"type":"string","valueName":"RUN_ID"}],"command":"results download","flags":[{"commandIndex":2,"default":".","help":"Directory to write the artifacts into","name":"--out","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"OUT"}],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Download a hosted run's artifacts, sha256-checked","usage":"simforge results download [OPTIONS] <RUN_ID>"},{"arguments":[{"commandIndex":1,"help":"The hosted scenario","name":"scenario_id","positional":true,"required":true,"type":"string","valueName":"SCENARIO_ID"}],"command":"closed-loop","flags":[{"commandIndex":1,"help":"Its immutable revision","name":"--revision","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"REVISION_ID"},{"commandIndex":1,"default":"scripted","help":"The policy that drives the ego","name":"--policy","positional":false,"possibleValues":["scripted","trajectory"],"required":false,"takesValue":true,"type":"enum","valueName":"POLICY"},{"commandIndex":1,"help":"Simulation steps to run","minimum":0,"name":"--steps","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"STEPS"},{"commandIndex":1,"help":"Simulation seed, 0 to 2^53-1","maximum":9007199254740991,"minimum":0,"name":"--seed","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"SEED"},{"commandIndex":1,"help":"Wait for the run to finish","name":"--wait","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"help":"Download a succeeded run's artifacts into --out; implies --wait","name":"--download","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"help":"Wait and download a succeeded run's artifacts here","name":"--out","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":1,"help":"Explicit maximum cloud cost in cents; required for billable cloud jobs","minimum":0,"name":"--max-cost","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"CENTS"},{"commandIndex":1,"help":"Ego dynamics model: `dynamic-v1` (today's behaviour) or `full-car-v1` (reserved, refused until admitted). Omitted: the run-mode default, which the result records","name":"--ego-dynamics","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"MODEL"},{"commandIndex":1,"help":"The vehicle for an ego actor, `ACTOR=CATALOG_ID`, repeatable. Refused `ego_vehicle_unsupported` until pack profiles are enabled","name":"--ego-vehicle","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"ACTOR=CATALOG_ID"}],"globals":["--cloud","--workspace","--api-url","--idempotency-key","--dry-run"],"status":"unknown","statusReason":{"code":"not_logged_in","hint":"Run simforge login (or set SIMFORGE_API_KEY), then ask for this help again.","reason":"Not signed in, so the host was not asked whether this command is open for you."},"summary":"Run a hosted closed-loop evaluation of a scripted or trajectory policy on a scenario revision; launch requires an allowlisted workspace; contact SimForge. The workspace gate runs before input validation","usage":"simforge closed-loop [OPTIONS] --revision <REVISION_ID> <SCENARIO_ID>"},{"arguments":[{"commandIndex":2,"help":"The scenario to evaluate","name":"scenario_id","positional":true,"required":true,"type":"string","valueName":"SCENARIO_ID"}],"command":"open-loop run","flags":[{"commandIndex":2,"help":"The model that predicts, by name (case-insensitive) or id: one of the models the host offers for open loop now (`GET /api/v1/evaluation-options`, each model's `loops.openLoop`; run without it to list them). Required","name":"--model","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"MODEL"},{"commandIndex":2,"help":"Model sampling seed (the model's `seed` parameter). Default: the model's","minimum":0,"name":"--seed","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"SEED"},{"commandIndex":2,"help":"Trajectory samples drawn by the model (its `numTrajSamples` parameter). Default: the model's; a model with a fixed count accepts only that","maximum":64,"minimum":1,"name":"--samples","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"One of the model's parameters, as NAME=VALUE (repeatable): the options' `params` of the model, typed as listed (e.g. --param temperature=0.8). Absent ones take their defaults","name":"--param","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"NAME=VALUE"},{"commandIndex":2,"help":"Explicit maximum cloud cost in cents; required, also with --dry-run","minimum":0,"name":"--max-cost","positional":false,"required":true,"takesValue":true,"type":"integer","valueName":"CENTS"},{"commandIndex":2,"help":"Wait for the evaluation to finish","name":"--wait","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":["--cloud","--workspace","--api-url","--idempotency-key","--dry-run"],"models":"unknown","status":"unknown","statusReason":{"code":"not_logged_in","hint":"Run simforge login (or set SIMFORGE_API_KEY), then ask for this help again.","reason":"Not signed in, so the host was not asked whether this command is open for you."},"summary":"Score a scenario's authored episode with a driving model the host offers for open loop, named by --model (requires --cloud, --model, --max-cost and --idempotency-key, also with --dry-run). The help's `models` lists the host's open-loop models","usage":"simforge open-loop run [OPTIONS] --max-cost <CENTS> <SCENARIO_ID>"},{"arguments":[],"command":"open-loop list","flags":[{"commandIndex":2,"default":"20","help":"At most this many items on the page","maximum":100,"minimum":1,"name":"--limit","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"LIMIT"},{"commandIndex":2,"help":"The next page: the `nextCursor` of the page before it","name":"--cursor","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"CURSOR"},{"commandIndex":2,"help":"Only evaluations in these statuses (comma-separated)","name":"--status","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"STATUS"},{"commandIndex":2,"help":"Only one model's evaluations, by name (case-insensitive) or id: a model the host lists (`GET /api/v1/evaluation-options`), or a model version of your own by id. Default: every model's","name":"--model","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"MODEL"}],"globals":["--cloud","--workspace","--api-url","--idempotency-key"],"status":"available","summary":"List the workspace's evaluations, whichever model ran them","usage":"simforge open-loop list [OPTIONS]"},{"arguments":[{"commandIndex":2,"help":"The evaluation (`run_...`, or `cmpj_...` from before cloud runs)","name":"id","positional":true,"required":true,"type":"string","valueName":"EVALUATION_ID"}],"command":"open-loop show","flags":[],"globals":["--cloud","--workspace","--api-url","--idempotency-key"],"status":"available","summary":"One evaluation: status, cost and attempts","usage":"simforge open-loop show [OPTIONS] <EVALUATION_ID>"},{"arguments":[{"commandIndex":2,"help":"The evaluation (`run_...`, or `cmpj_...` from before cloud runs)","name":"id","positional":true,"required":true,"type":"string","valueName":"EVALUATION_ID"}],"command":"open-loop watch","flags":[],"globals":["--cloud","--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Follow an evaluation until it succeeds, is partial, fails or is cancelled","usage":"simforge open-loop watch [OPTIONS] <EVALUATION_ID>"},{"arguments":[{"commandIndex":2,"help":"The evaluation (`run_...`, or `cmpj_...` from before cloud runs)","name":"id","positional":true,"required":true,"type":"string","valueName":"EVALUATION_ID"}],"command":"open-loop result","flags":[],"globals":["--cloud","--workspace","--api-url","--idempotency-key"],"status":"available","summary":"The evaluation's result manifest: scored metrics, artifacts, model/render/source pins and compute cost","usage":"simforge open-loop result [OPTIONS] <EVALUATION_ID>"},{"arguments":[{"commandIndex":2,"help":"The evaluation (`run_...`, or `cmpj_...` from before cloud runs)","name":"id","positional":true,"required":true,"type":"string","valueName":"EVALUATION_ID"},{"commandIndex":2,"help":"The artifact, by its id in the result manifest","name":"artifact_id","positional":true,"required":true,"type":"string","valueName":"ARTIFACT_ID"}],"command":"open-loop artifacts","flags":[],"globals":["--cloud","--workspace","--api-url","--idempotency-key"],"status":"available","summary":"A download grant ({url, sha256, bytes, ...}) for one artifact of the evaluation's result","usage":"simforge open-loop artifacts [OPTIONS] <EVALUATION_ID> <ARTIFACT_ID>"},{"arguments":[],"command":"challenge status","flags":[],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Your team, the submissions you have left and your registry repository","usage":"simforge challenge status [OPTIONS]"},{"arguments":[{"commandIndex":2,"help":"A local docker image (name:tag or id) implementing the challenge driver interface","name":"image","positional":true,"required":true,"type":"string","valueName":"IMAGE"}],"command":"challenge submit","flags":[{"commandIndex":2,"default":"dev","help":"The track to submit to: `dev` (scored nightly in closed loop) or `final` (the final-track simulator, a few times a month)","name":"--track","positional":false,"possibleValues":["dev","final"],"required":false,"takesValue":true,"type":"enum","valueName":"TRACK"}],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Push a driver image to your team's repository and submit it for the next nightly batch","usage":"simforge challenge submit [OPTIONS] <IMAGE>"},{"arguments":[],"command":"challenge submissions","flags":[],"globals":["--workspace","--api-url","--idempotency-key"],"status":"available","summary":"Your team's submissions, their status and scores","usage":"simforge challenge submissions [OPTIONS]"},{"arguments":[{"commandIndex":2,"help":"Arguments for `simforge-challenge` (see `simforge-challenge --help`)","name":"argv","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"ARGV"}],"command":"challenge validate","flags":[],"globals":[],"status":"available","summary":"Validate a driver image against the submission contract, in the nightly batch's sandbox","usage":"simforge challenge validate [OPTIONS] [ARGV]..."},{"arguments":[{"commandIndex":2,"help":"Arguments for `simforge-challenge` (see `simforge-challenge --help`)","name":"argv","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"ARGV"}],"command":"challenge eval","flags":[],"globals":[],"status":"available","summary":"Evaluate a driver image in the final-track simulator on scenes you downloaded (`--local`)","usage":"simforge challenge eval [OPTIONS] [ARGV]..."},{"arguments":[],"command":"doctor","flags":[{"commandIndex":1,"help":"Make no network request: the sign-in is read from this machine only and the map-catalogue check is skipped","name":"--offline","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":[],"status":"available","summary":"Check this machine: sign-in, the runtime and its disk, the GPU (supported, and free now), ffmpeg, the map cache and the host's map catalogue, each with a fix. Runs without the runtime; with it, also the runtime's own checks (GPU adapter, sky plates, open files, actor assets)","usage":"simforge doctor [OPTIONS]"},{"arguments":[{"commandIndex":1,"help":"What you tried and what happened (the command, its error code, what you expected). Without it, a terminal asks for one","name":"message","positional":true,"required":false,"type":"string","valueName":"MESSAGE"}],"command":"feedback","flags":[{"commandIndex":1,"default":"bug","help":"What this is","name":"--kind","positional":false,"possibleValues":["bug","idea","question"],"required":false,"takesValue":true,"type":"enum","valueName":"KIND"},{"commandIndex":1,"conflictsWith":["--no-attach-last-error"],"help":"Attach the last command's failure on this machine: its command and option names, error code and reason, exit code, map and request id. Default: on when the previous command failed in the last 24 h","name":"--attach-last-error","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"help":"Attach no command failure, even when the previous command failed","name":"--no-attach-last-error","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"help":"Attach `simforge doctor`'s checks (each check's id, status, summary and fix; never its detail)","name":"--include-doctor","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"help":"Signed out: an email SimForge may answer at (optional; a terminal asks). Signed in, SimForge answers the account","name":"--email","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"EMAIL"}],"globals":["--workspace","--api-url","--idempotency-key","--dry-run"],"status":"available","summary":"Send SimForge a bug report, idea or question, signed in or not: with the last command's failure and doctor's checks attached on request; --dry-run prints exactly what would be sent","usage":"simforge feedback [OPTIONS] [MESSAGE]"},{"arguments":[],"command":"world serve","flags":[{"commandIndex":2,"help":"The installed map to serve (its name or directory)","name":"--map","positional":false,"required":true,"takesValue":true,"type":"path","valueName":"MAP"},{"commandIndex":2,"help":"A scenario file whose actors start in the world","name":"--scenario","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"SCENARIO"},{"commandIndex":2,"help":"The seed for traffic population and every seeded draw","minimum":0,"name":"--seed","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"SEED"},{"commandIndex":2,"help":"`realtime` advances at 50 Hz wall clock, `fast` unpaced, `paused` only on world.time.advanceTicks","name":"--pacing","positional":false,"possibleValues":["realtime","fast","paused"],"required":false,"takesValue":true,"type":"enum","valueName":"PACING"},{"commandIndex":2,"help":"The Unix socket (named pipe on Windows) to serve runtime protocol v1 on","name":"--socket","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"SOCKET"},{"commandIndex":2,"help":"A loopback HOST:PORT for the authenticated /commands and /truth WebSocket endpoints","name":"--listen","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"LISTEN"},{"commandIndex":2,"help":"A mode-0600 file of 32-512 bytes holding the host token clients authenticate with","name":"--token-file","positional":false,"required":true,"takesValue":true,"type":"path","valueName":"TOKEN_FILE"},{"commandIndex":2,"help":"How many population vehicles to keep in the world","minimum":0,"name":"--vehicles","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"VEHICLES"},{"commandIndex":2,"help":"How many population pedestrians to keep in the world","minimum":0,"name":"--pedestrians","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"PEDESTRIANS"},{"commandIndex":2,"help":"Record the session as a simforge.recording/v1 file here","name":"--record","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"RECORD"},{"commandIndex":2,"help":"The durable journal directory (command log segments and checkpoints)","name":"--journal-dir","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"JOURNAL_DIR"},{"commandIndex":2,"help":"Also write the readiness JSON to this file","name":"--ready-file","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"READY_FILE"},{"commandIndex":2,"help":"Restore a host checkpoint (`*.host-checkpoint.msgpack`) at launch","name":"--restore","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"RESTORE"},{"commandIndex":2,"help":"Map cache root to search. Default: SIMFORGE_MAPS_CACHE_ROOT, then $XDG_DATA_HOME/simforge/maps","name":"--cache-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"CACHE_ROOT"},{"commandIndex":2,"help":"Serve a map that ships no colliders (actors can then pass through static geometry)","name":"--allow-no-colliders","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"help":"Explicit browser origins allowed by the closed host (repeatable)","name":"--allow-origin","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"ALLOW_ORIGIN"}],"globals":[],"status":"available","summary":"Serve a persistent local realtime world and its authenticated drive/state endpoints","usage":"simforge world serve [OPTIONS] --map <MAP> --token-file <TOKEN_FILE>"},{"arguments":[],"command":"wheel serve","flags":[{"commandIndex":2,"default":"127.0.0.1:8767","help":"Address to listen on: 127.0.0.1 or [::1], with a port; port 0 picks a free one, which the ready document prints","name":"--listen","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"ADDR"},{"commandIndex":2,"help":"The token a page must present. Default: wheel-token in the CLI config directory, created owner-only on first use; a file named here must already exist with mode 0600. Delete it and restart to revoke every page","name":"--token-file","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":2,"help":"Also allow pages from this exact origin, scheme://host[:port] (repeatable). Always allowed: https://simforge.ai, the configured development host, http://127.0.0.1:5199, http://localhost:5199","name":"--allow-origin","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"ORIGIN"}],"globals":[],"status":"available","summary":"Hold a Logitech wheel's centring spring for Drive pages on this computer (ws://127.0.0.1:8767/wheel) until Ctrl+C","usage":"simforge wheel serve [OPTIONS]"},{"arguments":[],"command":"engine-info","execution":{"cloud":false,"default":"local-runtime"},"flags":[],"globals":[],"status":"available","summary":"What this binary is: package version, engine semver, commit and its own sha256 (to record with results)","usage":"simforge engine-info [OPTIONS]"},{"arguments":[],"command":"assets pull","execution":{"cloud":false,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"Pull only this closure. Default: both the actor closure and the sky plates","name":"--only","positional":false,"possibleValues":["actors","sky"],"required":false,"takesValue":true,"type":"enum","valueName":"ONLY"},{"commandIndex":2,"help":"The actor closure digest (sha256). Default: the closure this build is pinned to","name":"--closure","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"Asset store base URL (https:// or file://). Default: SIMFORGE_ACTOR_ASSETS_BASE_URL, then the public store","name":"--base-url","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"URL"},{"commandIndex":2,"help":"Local asset root. Default: SIMFORGE_ACTOR_ASSETS_ROOT, then $XDG_DATA_HOME/simforge/actor-assets","name":"--root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"default":"60","help":"Seconds to wait for a connection or for a response to start","minimum":0,"name":"--timeout","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"SECONDS"}],"globals":[],"status":"available","summary":"Pull the actor-asset closure and its ATTRIBUTION.json, verifying every blob's sha256","usage":"simforge assets pull [OPTIONS]"},{"arguments":[{"commandIndex":2,"help":"The workspace directory (an imported scenario package). Omit it and pass --trace instead","name":"workspace","positional":true,"required":false,"type":"path","valueName":"WORKSPACE"}],"command":"timeline build","execution":{"cloud":false,"default":"local-runtime"},"flags":[{"commandIndex":2,"conflictsWith":["workspace"],"help":"A trace file (JSON or gzip; any released trace format) instead of a workspace","name":"--trace","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":2,"conflictsWith":["workspace"],"help":"The identity recorded next to the stored trace (bound to an upgraded trace; checked against a current one)","name":"--recorded-trace-sha256","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"conflictsWith":["workspace"],"help":"Actor-catalog closure digest to key the timeline by (a workspace supplies its own)","name":"--catalog-digest","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"default":"auto","help":"The height source","name":"--height","positional":false,"possibleValues":["auto","ground","flat"],"required":false,"takesValue":true,"type":"enum","valueName":"HEIGHT"},{"commandIndex":2,"help":"Elevation of the plane for --height flat","name":"--flat-z","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"METRES"},{"commandIndex":2,"help":"Use this map directory (map.xodr + derived/ground/ground-mesh.bin) instead of the installed map found by content","name":"--map-dir","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"help":"Map cache root to search. Default: SIMFORGE_MAPS_CACHE_ROOT, then $XDG_DATA_HOME/simforge/maps","name":"--cache-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"help":"Write the canonical timeline here (`.gz` compresses). Default: the workspace's timeline/<sha256>.json; with --trace, nothing is written","name":"--out","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":2,"help":"Derive each logged four-wheeler's body pitch and roll from its recorded track (log replays only; any other input is refused `ego_visual_dynamics_input_invalid`). The timeline key changes; without the flag the timeline is unchanged","name":"--visual-dynamics","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"help":"With --visual-dynamics: the rate the log's poses were recorded at, Hz. Default: 50. A rate the poses contradict (a resampled lower-rate log declared higher) is refused, and so is a pose-only log below 10 Hz","name":"--vd-rate-hz","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"HZ"}],"globals":[],"status":"available","summary":"Build the render timeline for a workspace's trace (deterministic, content-keyed)","usage":"simforge timeline build [OPTIONS] [WORKSPACE]"},{"arguments":[],"command":"bench","execution":{"cloud":false,"default":"local-runtime"},"flags":[{"commandIndex":1,"default":"quick","help":"Which scenes to run","name":"--suite","positional":false,"possibleValues":["quick","full"],"required":false,"takesValue":true,"type":"enum","valueName":"SUITE"},{"commandIndex":1,"help":"Only these scene ids (comma-separated), from the suite's pack","name":"--scenes","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":1,"help":"Diagnostics: a render-config override (`simforge render --set` keys) on every scene. It changes the workload, so the result is recorded with its overrides and has no score (status `modified`)","name":"--set","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"KEY=VALUE"},{"commandIndex":1,"help":"The GPU to benchmark: its index in `nvidia-smi` (NVIDIA) or in the adapter list `simforge doctor` prints. Default: the renderer's choice (the first discrete GPU)","minimum":0,"name":"--gpu","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":1,"help":"Write the result JSON here too (default: `simforge-bench-<time>.json` in the current directory)","name":"--out","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":1,"help":"A local pack directory instead of the pinned pack (maintainers; also SIMFORGE_BENCH_PACK)","name":"--pack","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":1,"help":"Keep every sampled frame and the session logs in this directory","name":"--keep","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":1,"help":"Download and verify the suite's inputs (pack, map tier, actors, sky), then exit without rendering","name":"--download-only","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"help":"Run even when another process is using the GPU (the result is flagged `gpu-shared`)","name":"--allow-busy","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"default":"300","help":"Kill a scene session that makes no progress for this long (a hung GPU submission); the scene is reported failed and the remaining scenes run in a new session","minimum":0,"name":"--stall-timeout-s","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"SECONDS"},{"commandIndex":1,"help":"No progress or table on stderr (the JSON result on stdout is unchanged)","name":"--quiet","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"help":"Map cache root. Default: SIMFORGE_MAPS_CACHE_ROOT, then $XDG_DATA_HOME/simforge/maps","name":"--cache-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":1,"help":"Actor-asset root. Default: SIMFORGE_ACTOR_ASSETS_ROOT, then $XDG_DATA_HOME/simforge/actor-assets","name":"--assets-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"}],"globals":[],"status":"available","summary":"Benchmark the renderer on this machine: the Helios Score, per-factor sub-scores, frame correctness","usage":"simforge bench [OPTIONS]\n       simforge bench <COMMAND>"},{"arguments":[],"command":"bench run","execution":{"cloud":false,"default":"local-runtime"},"flags":[{"commandIndex":1,"default":"quick","help":"Which scenes to run","name":"--suite","positional":false,"possibleValues":["quick","full"],"required":false,"takesValue":true,"type":"enum","valueName":"SUITE"},{"commandIndex":1,"help":"Only these scene ids (comma-separated), from the suite's pack","name":"--scenes","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":1,"help":"Diagnostics: a render-config override (`simforge render --set` keys) on every scene. It changes the workload, so the result is recorded with its overrides and has no score (status `modified`)","name":"--set","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"KEY=VALUE"},{"commandIndex":1,"help":"The GPU to benchmark: its index in `nvidia-smi` (NVIDIA) or in the adapter list `simforge doctor` prints. Default: the renderer's choice (the first discrete GPU)","minimum":0,"name":"--gpu","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":1,"help":"Write the result JSON here too (default: `simforge-bench-<time>.json` in the current directory)","name":"--out","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":1,"help":"A local pack directory instead of the pinned pack (maintainers; also SIMFORGE_BENCH_PACK)","name":"--pack","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":1,"help":"Keep every sampled frame and the session logs in this directory","name":"--keep","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":1,"help":"Download and verify the suite's inputs (pack, map tier, actors, sky), then exit without rendering","name":"--download-only","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"help":"Run even when another process is using the GPU (the result is flagged `gpu-shared`)","name":"--allow-busy","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"default":"300","help":"Kill a scene session that makes no progress for this long (a hung GPU submission); the scene is reported failed and the remaining scenes run in a new session","minimum":0,"name":"--stall-timeout-s","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"SECONDS"},{"commandIndex":1,"help":"No progress or table on stderr (the JSON result on stdout is unchanged)","name":"--quiet","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"help":"Map cache root. Default: SIMFORGE_MAPS_CACHE_ROOT, then $XDG_DATA_HOME/simforge/maps","name":"--cache-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":1,"help":"Actor-asset root. Default: SIMFORGE_ACTOR_ASSETS_ROOT, then $XDG_DATA_HOME/simforge/actor-assets","name":"--assets-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"default":"quick","help":"Which scenes to run","name":"--suite","positional":false,"possibleValues":["quick","full"],"required":false,"takesValue":true,"type":"enum","valueName":"SUITE"},{"commandIndex":2,"help":"Only these scene ids (comma-separated), from the suite's pack","name":"--scenes","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":2,"help":"Diagnostics: a render-config override (`simforge render --set` keys) on every scene. It changes the workload, so the result is recorded with its overrides and has no score (status `modified`)","name":"--set","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"KEY=VALUE"},{"commandIndex":2,"help":"The GPU to benchmark: its index in `nvidia-smi` (NVIDIA) or in the adapter list `simforge doctor` prints. Default: the renderer's choice (the first discrete GPU)","minimum":0,"name":"--gpu","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"Write the result JSON here too (default: `simforge-bench-<time>.json` in the current directory)","name":"--out","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":2,"help":"A local pack directory instead of the pinned pack (maintainers; also SIMFORGE_BENCH_PACK)","name":"--pack","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"help":"Keep every sampled frame and the session logs in this directory","name":"--keep","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"help":"Download and verify the suite's inputs (pack, map tier, actors, sky), then exit without rendering","name":"--download-only","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"help":"Run even when another process is using the GPU (the result is flagged `gpu-shared`)","name":"--allow-busy","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"default":"300","help":"Kill a scene session that makes no progress for this long (a hung GPU submission); the scene is reported failed and the remaining scenes run in a new session","minimum":0,"name":"--stall-timeout-s","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"SECONDS"},{"commandIndex":2,"help":"No progress or table on stderr (the JSON result on stdout is unchanged)","name":"--quiet","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"help":"Map cache root. Default: SIMFORGE_MAPS_CACHE_ROOT, then $XDG_DATA_HOME/simforge/maps","name":"--cache-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"help":"Actor-asset root. Default: SIMFORGE_ACTOR_ASSETS_ROOT, then $XDG_DATA_HOME/simforge/actor-assets","name":"--assets-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"}],"globals":[],"status":"available","summary":"Run the benchmark (the default when no subcommand is given)","usage":"simforge bench run [OPTIONS]"},{"arguments":[{"commandIndex":2,"help":"The baseline result","name":"a","positional":true,"required":true,"type":"path","valueName":"A.json"},{"commandIndex":2,"help":"The candidate result","name":"b","positional":true,"required":true,"type":"path","valueName":"B.json"}],"command":"bench compare","execution":{"cloud":false,"default":"local-runtime"},"flags":[{"commandIndex":1,"default":"quick","help":"Which scenes to run","name":"--suite","positional":false,"possibleValues":["quick","full"],"required":false,"takesValue":true,"type":"enum","valueName":"SUITE"},{"commandIndex":1,"help":"Only these scene ids (comma-separated), from the suite's pack","name":"--scenes","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":1,"help":"Diagnostics: a render-config override (`simforge render --set` keys) on every scene. It changes the workload, so the result is recorded with its overrides and has no score (status `modified`)","name":"--set","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"KEY=VALUE"},{"commandIndex":1,"help":"The GPU to benchmark: its index in `nvidia-smi` (NVIDIA) or in the adapter list `simforge doctor` prints. Default: the renderer's choice (the first discrete GPU)","minimum":0,"name":"--gpu","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":1,"help":"Write the result JSON here too (default: `simforge-bench-<time>.json` in the current directory)","name":"--out","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":1,"help":"A local pack directory instead of the pinned pack (maintainers; also SIMFORGE_BENCH_PACK)","name":"--pack","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":1,"help":"Keep every sampled frame and the session logs in this directory","name":"--keep","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":1,"help":"Download and verify the suite's inputs (pack, map tier, actors, sky), then exit without rendering","name":"--download-only","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"help":"Run even when another process is using the GPU (the result is flagged `gpu-shared`)","name":"--allow-busy","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"default":"300","help":"Kill a scene session that makes no progress for this long (a hung GPU submission); the scene is reported failed and the remaining scenes run in a new session","minimum":0,"name":"--stall-timeout-s","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"SECONDS"},{"commandIndex":1,"help":"No progress or table on stderr (the JSON result on stdout is unchanged)","name":"--quiet","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"help":"Map cache root. Default: SIMFORGE_MAPS_CACHE_ROOT, then $XDG_DATA_HOME/simforge/maps","name":"--cache-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":1,"help":"Actor-asset root. Default: SIMFORGE_ACTOR_ASSETS_ROOT, then $XDG_DATA_HOME/simforge/actor-assets","name":"--assets-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"}],"globals":[],"status":"available","summary":"Compare two results: per-scene time deltas against the noise of both runs, and frame identity","usage":"simforge bench compare [OPTIONS] <A.json> <B.json>"},{"arguments":[{"commandIndex":2,"help":"The recording (JSON, optionally gzipped). With --cloud: The log: a recording (JSON, optionally gzipped) or a ROS 2 MCAP lidar log","name":"recording","positional":true,"required":true,"type":"path","valueName":"RECORDING"}],"cloudOnlyGlobals":["--workspace","--api-url","--idempotency-key","--dry-run"],"command":"import log","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"The installed map: a map directory, or name[@version] under the maps cache (semantic profile)","name":"--map","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"DIR|NAME@VERSION"},{"commandIndex":2,"help":"The package directory to write (created; must be empty if it exists)","name":"--out","positional":false,"required":true,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"help":"The register step's import report (`simforge.import-report/v1` fields: methods, registration, laneMatch, droppedActors), merged into the package's","name":"--report","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"REPORT.JSON"},{"commandIndex":2,"help":"Map cache root to search for NAME@VERSION. Default: SIMFORGE_MAPS_CACHE_ROOT, then $XDG_DATA_HOME/simforge/maps","name":"--cache-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"help":"Actor-asset root whose closure restricts catalog binding to renderable models. Default: SIMFORGE_ACTOR_ASSETS_ROOT, then $XDG_DATA_HOME/simforge/actor-assets","name":"--assets-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"help":"The actor closure the package pins (default: this CLI's pinned public closure)","name":"--actor-closure","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"Simulate without map colliders when the map publishes none (recorded; the default refuses)","name":"--allow-no-colliders","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"help":"Also write the opt-in ego feasibility report (simforge.ego-feasibility/v1) to this file: the logged ego track against its class's dynamic-v1 envelope. Never changes the trace or the workspace","name":"--feasibility-report","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":2,"help":"Opt in to a tracked replay of the ego: instead of placing it on the log, drive its dynamic-v1 plant along the logged path (the engine's timed-path tracker) and write the tracking report (simforge.ego-tracking/v1) to this file. Changes the trace; other actors still replay exactly. Recorded in the package notes","name":"--tracked-replay","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":2,"execution":"cloud","help":"The scenario's name. Default: the file's name","name":"--name","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"NAME"},{"commandIndex":2,"execution":"cloud","help":"Explicit maximum cloud cost in cents","minimum":0,"name":"--max-cost","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"CENTS"},{"commandIndex":2,"execution":"cloud","help":"Wait for the import to finish and print its scenario","name":"--wait","positional":false,"possibleValues":["true","false"],"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"execution":"cloud","help":"Download a finished import's scenario document, import report and Event Timeline into --out; implies --wait","name":"--download","positional":false,"possibleValues":["true","false"],"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"execution":"cloud","help":"Upload the log and price its import, starting nothing (the host prices an import from the uploaded log). --dry-run uploads nothing","name":"--stage","positional":false,"possibleValues":["true","false"],"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"execution":"cloud","help":"MCAP only: the lidar topic, when the log has several","name":"--lidar-topic","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TOPIC"},{"commandIndex":2,"execution":"cloud","help":"MCAP only: the GNSS topic, when the log has several","name":"--gnss-topic","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TOPIC"},{"commandIndex":2,"execution":"cloud","help":"MCAP only: the ego's box in metres, length,width,height (perceive's default otherwise)","name":"--ego-dims","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"number","valueName":"L,W,H"},{"commandIndex":2,"execution":"cloud","help":"MCAP only: how far the ego box's centre is ahead of base_link (the rear axle), metres","name":"--ego-rear-axle-to-centre","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"METRES"}],"globals":["--cloud","--workspace","--api-url","--idempotency-key","--dry-run"],"status":"available","summary":"A recording (simforge.recording/v1 or log-scene/v1) as a scenario package: scenario, recording, trace, import report","usage":"simforge import log [OPTIONS] --map <DIR|NAME@VERSION> --out <DIR> <RECORDING>"},{"arguments":[{"commandIndex":2,"help":"The OpenSCENARIO 1.x XML file; its catalogs and OpenDRIVE are read beside it. With --cloud: The OpenSCENARIO 1.x file (its OpenDRIVE and catalogs are bundled from the paths it names), or a ready .zip bundle","name":"file","positional":true,"required":true,"type":"path","valueName":"FILE.xosc"}],"cloudOnlyGlobals":["--workspace","--api-url","--idempotency-key","--dry-run"],"command":"import openscenario","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"The package directory to write (created; must be empty if it exists)","name":"--out","positional":false,"required":true,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"help":"The map version: a map directory, or name[@version] under the maps cache. It must hold the file's OpenDRIVE. Default: the installed map whose OpenDRIVE has the file's sha256","name":"--map-version","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"DIR|NAME@VERSION"},{"commandIndex":2,"help":"The ego entity (default: one named ego or hero, else the first vehicle)","name":"--ego","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"ENTITY"},{"commandIndex":2,"help":"The clip, when the storyboard does not stop at a simulation time","name":"--clip-seconds","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"S"},{"commandIndex":2,"help":"Map cache root to search. Default: SIMFORGE_MAPS_CACHE_ROOT, then $XDG_DATA_HOME/simforge/maps","name":"--cache-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"help":"Actor-asset root whose closure restricts catalog binding to renderable models. Default: SIMFORGE_ACTOR_ASSETS_ROOT, then $XDG_DATA_HOME/simforge/actor-assets","name":"--assets-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"help":"The actor closure the package pins (default: this CLI's pinned public closure)","name":"--actor-closure","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"Simulate without map colliders when the map publishes none (recorded; the default refuses)","name":"--allow-no-colliders","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"default":"auto","execution":"cloud","help":"The map: a map version id, a name, `name@vN`, or `auto` (the map whose OpenDRIVE the file names)","name":"--map","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"NAME@VERSION|auto"},{"commandIndex":2,"execution":"cloud","help":"The scenario's name. Default: the file's name","name":"--name","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"NAME"},{"commandIndex":2,"execution":"cloud","help":"The `.xosc` inside a .zip bundle that holds several","name":"--xosc-path","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"PATH"},{"commandIndex":2,"execution":"cloud","help":"Explicit maximum cloud cost in cents","minimum":0,"name":"--max-cost","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"CENTS"},{"commandIndex":2,"execution":"cloud","help":"Wait for the import to finish and print its scenario","name":"--wait","positional":false,"possibleValues":["true","false"],"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"execution":"cloud","help":"Download a finished import's scenario document, import report and Event Timeline into --out; implies --wait","name":"--download","positional":false,"possibleValues":["true","false"],"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"execution":"cloud","help":"Upload the bundle and price its import, starting nothing: the host resolves the map first, so this shows `osc_map_unknown` for free. --dry-run uploads nothing","name":"--stage","positional":false,"possibleValues":["true","false"],"required":false,"takesValue":false,"type":"bool"}],"globals":["--cloud","--workspace","--api-url","--idempotency-key","--dry-run"],"status":"available","summary":"An OpenSCENARIO 1.x XML file as a scenario package; its map is found by the OpenDRIVE's sha256, and every element it cannot represent is refused by name","usage":"simforge import openscenario [OPTIONS] --out <DIR> <FILE.xosc>"},{"arguments":[{"commandIndex":2,"help":"The trace (`trace.json[.gz]`), or a workspace/package directory (its `simulation/trace.json.gz`)","name":"trace","positional":true,"required":true,"type":"path","valueName":"TRACE|DIR"}],"command":"recording from-trace","execution":{"cloud":false,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"The recording to write (gzipped canonical JSON; the conventional name is `<sha256>.rec.json.gz`)","name":"--out","positional":false,"required":true,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":2,"help":"The producer recorded in `source.producer` (id and version)","name":"--producer","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"PRODUCER"},{"commandIndex":2,"default":"","help":"An opaque reference to the rollout (`source.clipRef`)","name":"--clip-ref","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"CLIP_REF"},{"commandIndex":2,"help":"The licence of the rollout's inputs, when it carries one","name":"--license","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"LICENSE"},{"commandIndex":2,"help":"The ego actor id (default: the trace's metricSubject)","name":"--ego","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"EGO"},{"commandIndex":2,"help":"The map release version the trace ran on (`map.version`), when known","name":"--map-version","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"MAP_VERSION"}],"globals":["--map-version"],"status":"available","summary":"Save a simulation's trace (a rollout) as a simforge.recording/v1 recording","usage":"simforge recording from-trace [OPTIONS] --out <FILE> --producer <PRODUCER> <TRACE|DIR>"},{"arguments":[{"commandIndex":2,"help":"The recording (simforge.recording/v1 or log-scene/v1, optionally gzipped)","name":"recording","positional":true,"required":true,"type":"path","valueName":"RECORDING"}],"command":"recording inspect","execution":{"cloud":false,"default":"local-runtime"},"flags":[],"globals":[],"status":"available","summary":"Read a recording through the contract: its digest, map, size and lineage","usage":"simforge recording inspect [OPTIONS] <RECORDING>"},{"arguments":[{"commandIndex":2,"help":"The recording (simforge.recording/v1 or log-scene/v1, optionally gzipped); registered on the map","name":"recording","positional":true,"required":true,"type":"path","valueName":"RECORDING"}],"command":"recording scaffold","execution":{"cloud":false,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"The map the recording was registered on: a map directory, or name[@version] under the maps cache (semantic profile)","name":"--map","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"DIR|NAME@VERSION"},{"commandIndex":2,"help":"The package directory to write (created; must be empty if it exists)","name":"--out","positional":false,"required":true,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"help":"The scenario's name (`meta.name`; default \"<producer> <clipRef>\")","name":"--title","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"NAME"},{"commandIndex":2,"help":"The report the recording's `derivedFrom.reportSha256` names, packaged byte for byte (`transfer-report.json` or `import-report.json`, by its schema)","name":"--report","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"REPORT.JSON"},{"commandIndex":2,"help":"Map cache root to search for NAME@VERSION. Default: SIMFORGE_MAPS_CACHE_ROOT, then $XDG_DATA_HOME/simforge/maps","name":"--cache-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"help":"Actor-asset root whose closure restricts catalog binding to renderable models. Default: SIMFORGE_ACTOR_ASSETS_ROOT, then $XDG_DATA_HOME/simforge/actor-assets","name":"--assets-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"help":"The actor closure the package pins (default: this CLI's pinned public closure)","name":"--actor-closure","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"}],"globals":[],"status":"available","summary":"A registered recording as a scenario package that carries no simulation: the scaffolded scenario, the recording it pins and the report of the operation that made it","usage":"simforge recording scaffold [OPTIONS] --map <DIR|NAME@VERSION> --out <DIR> <RECORDING>"},{"arguments":[{"commandIndex":2,"help":"The recording (simforge.recording/v1 or log-scene/v1, optionally gzipped)","name":"recording","positional":true,"required":true,"type":"path","valueName":"RECORDING"}],"command":"recording feasibility","execution":{"cloud":false,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"Also write the report here (it is always printed)","name":"--out","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"}],"globals":[],"status":"available","summary":"Opt-in feasibility report for a recording's ego: the inverse single-track model against the vehicle's dynamic-v1 envelope. Reads only; the recording replays exactly either way","usage":"simforge recording feasibility [OPTIONS] <RECORDING>"},{"arguments":[{"commandIndex":2,"help":"The scenario package or workspace directory (a package without a simulation is compiled from its document and recordings)","name":"workspace","positional":true,"required":true,"type":"path","valueName":"WORKSPACE"}],"command":"env serve","execution":{"cloud":false,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"Local endpoint path; Windows derives a same-user named pipe from this path","name":"--socket","positional":false,"required":true,"takesValue":true,"type":"path","valueName":"PATH"},{"commandIndex":2,"help":"The sensor rig (`simforge.render-rig/v1`, as `simforge render` takes it)","name":"--rig","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"RIG.JSON"},{"commandIndex":2,"conflictsWith":["--rig"],"help":"Serve the episode without a renderer (observations are the engine's only)","name":"--no-sensors","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"help":"Restrict observations to state, sensors, or both; omission preserves the native layout","name":"--observation-profile","positional":false,"possibleValues":["state","sensors","both"],"required":false,"takesValue":true,"type":"enum","valueName":"OBSERVATION_PROFILE"},{"commandIndex":2,"default":"training","help":"The render preset for observations (`schematic` is offline `simforge render` only)","name":"--preset","positional":false,"possibleValues":["training","showcase"],"required":false,"takesValue":true,"type":"enum","valueName":"PRESET"},{"commandIndex":2,"help":"Renderer overrides, including textureMaxSize=1024|2048|4096|full","name":"--set","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"KEY=VALUE"},{"commandIndex":2,"default":"rgb","help":"Camera passes rendered per observation, comma-separated","name":"--passes","positional":false,"possibleValues":["rgb","hdr","id","depth","semantic"],"repeatable":true,"required":false,"takesValue":true,"type":"enum","valueName":"PASSES"},{"commandIndex":2,"default":"uastc-full","help":"The staged texture tier","name":"--textures","positional":false,"possibleValues":["uastc-full","bc7-512"],"required":false,"takesValue":true,"type":"enum","valueName":"TEXTURES"},{"commandIndex":2,"help":"Episode configuration (camelCase `EpisodeConfig`, as the gym's episode specs carry it)","name":"--episode","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"EPISODE.JSON"},{"commandIndex":2,"help":"Policy decisions per second (overrides the episode's `decisionHz`)","minimum":0,"name":"--decision-hz","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"HZ"},{"commandIndex":2,"default":"64","help":"Rows of the `objects` observation","minimum":0,"name":"--max-objects","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"Render on a software (CPU) Vulkan adapter such as lavapipe, explicitly","name":"--allow-software-adapter","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"help":"Use this map directory instead of the installed map found by content","name":"--map-dir","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"help":"Map cache root to search. Default: SIMFORGE_MAPS_CACHE_ROOT, then $XDG_DATA_HOME/simforge/maps","name":"--cache-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"help":"Actor-asset root. Default: SIMFORGE_ACTOR_ASSETS_ROOT, then $XDG_DATA_HOME/simforge/actor-assets","name":"--assets-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"help":"The actor closure to bind, instead of the workspace's `catalog.actorClosureDigest`","name":"--actor-closure","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"The workspace's private model layer (an actor closure in the same store) for `workspace.*` models, instead of the workspace's `simforge.actorLayer` extension","name":"--actor-layer","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"A texture budget in bytes; without it admission is skipped (reported)","minimum":0,"name":"--vram-budget","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"BYTES"},{"commandIndex":2,"help":"Ego dynamics model for this run: `dynamic-v1` (the engine's own model, today's behaviour), `kinematic-bicycle` (Helios episodes only) or `full-car-v1` (reserved, refused until admitted). Outranks the scenario's `physics.egoDynamics`. Omitted: the run-mode default, which the result records","name":"--ego-dynamics","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"MODEL"},{"commandIndex":2,"help":"The vehicle for an ego actor, `ACTOR=CATALOG_ID`, repeatable. A vehicle pack needs pack profiles, which are not enabled yet: refused `ego_vehicle_unsupported`, never run on the class profile","name":"--ego-vehicle","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"ACTOR=CATALOG_ID"},{"commandIndex":2,"help":"Where the renderer's diagnostics go. Default: `<socket>.log`","name":"--log","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":2,"help":"Render on the installed map release even where its members differ from the workspace's map closure (recorded; the default refuses)","name":"--allow-map-drift","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"default":"8","help":"Maximum concurrent client sessions sharing one prewarmed renderer. Training defaults to eight sessions per map renderer","minimum":0,"name":"--max-sessions","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"default":"512","help":"Size of the renderer's shared-memory frame ring, MiB","minimum":0,"name":"--shm-size-mb","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"MIB"}],"globals":[],"status":"available","summary":"Serve reset/step/observe episodes over a local socket or named pipe","usage":"simforge env serve [OPTIONS] --socket <PATH> <WORKSPACE>"},{"arguments":[{"commandIndex":2,"help":"The package file","name":"package","positional":true,"required":true,"type":"path","valueName":"PACKAGE.ZIP"}],"command":"package inspect","execution":{"cloud":false,"default":"local-runtime"},"flags":[],"globals":[],"status":"available","summary":"Print a package's manifest, producer and members without unpacking it","usage":"simforge package inspect [OPTIONS] <PACKAGE.ZIP>"},{"arguments":[{"commandIndex":2,"help":"The package file","name":"package","positional":true,"required":true,"type":"path","valueName":"PACKAGE.ZIP"}],"command":"package verify","execution":{"cloud":false,"default":"local-runtime"},"flags":[],"globals":[],"status":"available","summary":"Verify the manifest and every member digest; exit 2 on any mismatch","usage":"simforge package verify [OPTIONS] <PACKAGE.ZIP>"},{"arguments":[{"commandIndex":2,"help":"The package file","name":"package","positional":true,"required":true,"type":"path","valueName":"PACKAGE.ZIP"}],"command":"package import","execution":{"cloud":false,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"The workspace directory to create (must not exist, or be empty)","name":"--into","positional":false,"required":true,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"help":"Map cache root to check for the package's map. Default: SIMFORGE_MAPS_CACHE_ROOT, then $XDG_DATA_HOME/simforge/maps","name":"--cache-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"help":"Actor-asset root to check for the package's actor closure. Default: SIMFORGE_ACTOR_ASSETS_ROOT, then $XDG_DATA_HOME/simforge/actor-assets","name":"--assets-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":2,"help":"Fetch nothing: report the map and actor closure this machine still lacks","name":"--offline","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"conflictsWith":["--offline"],"help":"Install no map: the package's map must already be in the cache (`--cache-root`), else the import fails with `package_closure_unavailable`. Nothing is pulled into the cache or installed from the package's own blobs; the actor closure and sky plates are still fetched. A cloud worker's job passes it: the worker's parent process is the only writer of its maps cache","name":"--installed-map-only","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"help":"Map registry to resolve the package's map from (https:// or file://). Default: SIMFORGE_MAPS_REGISTRY","name":"--registry","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"URL"},{"commandIndex":2,"default":"full","help":"How to install a map the cache lacks: `full` (every profile) or `planar` (`maps pull --profile planar --with ground`: the road network, its planar derivatives, the static colliders and the ground, enough to simulate and render in 2D; a 3D render needs `full`). Either satisfies a planar import; only a full install satisfies a full one","name":"--profile","positional":false,"possibleValues":["full","planar"],"required":false,"takesValue":true,"type":"enum","valueName":"PROFILE"},{"commandIndex":2,"help":"Asset store for the actor closure. Default: SIMFORGE_ACTOR_ASSETS_BASE_URL, then the public store","name":"--assets-base-url","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"URL"}],"globals":[],"status":"available","summary":"Verify, then unpack into a local workspace","usage":"simforge package import [OPTIONS] --into <DIR> <PACKAGE.ZIP>"},{"arguments":[],"command":"locations find","execution":{"cloud":false,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"The installed map","name":"--map","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"MAP"},{"commandIndex":2,"help":"Location types, comma-separated (any of)","name":"--type","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"TYPES"},{"commandIndex":2,"help":"Subtypes, comma-separated (any of)","name":"--subtype","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"SUBTYPES"},{"commandIndex":2,"help":"Tags, comma-separated (any of)","name":"--tags","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"TAGS"},{"commandIndex":2,"help":"Affordances, comma-separated (any of)","name":"--affordances","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"AFFORDANCES"},{"commandIndex":2,"help":"Fact predicates, comma-separated, all of: `k=v`, `k>=v`, `k<=v`, `k!=v`, `k>v`, `k<v`, `k~v`, `k=?`, `k=!?`","name":"--facts","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"FACTS"},{"commandIndex":2,"help":"Only locations within --within-m of this handle or id, nearest first","name":"--near","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"HANDLE"},{"commandIndex":2,"help":"Radius for --near, metres (default 250)","name":"--within-m","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"M"},{"commandIndex":2,"help":"At most this many records (default 25, cap 200)","name":"--limit","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"N"},{"commandIndex":2,"help":"The next page: the `nextCursor` of the page before it","name":"--cursor","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"CURSOR"},{"commandIndex":2,"help":"Drop results within this many metres of an already selected one","name":"--diversity-m","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"M"}],"globals":[],"status":"available","summary":"Structured query: type, subtype, tags, affordances, facts, proximity","usage":"simforge locations find [OPTIONS] --map <MAP>"},{"arguments":[{"commandIndex":2,"help":"A handle (`junction/rd-38-rd-34`) or id (`loc_...`)","name":"ref","positional":true,"required":true,"type":"string","valueName":"HANDLE_OR_ID"}],"command":"locations get","execution":{"cloud":false,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"The installed map","name":"--map","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"MAP"},{"commandIndex":2,"help":"Add the natural-language description an agent reads before authoring","name":"--describe","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":[],"status":"available","summary":"One location by handle or id (optionally with a description paragraph)","usage":"simforge locations get [OPTIONS] --map <MAP> <HANDLE_OR_ID>"},{"arguments":[{"commandIndex":2,"help":"Free text (\"the crosswalk by the school\")","name":"text","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"TEXT"}],"command":"locations resolve","execution":{"cloud":false,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"The installed map","name":"--map","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"MAP"},{"commandIndex":2,"help":"At most this many results (default 8)","name":"--limit","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"N"}],"globals":[],"status":"available","summary":"Free text -> ranked handles (exit 2 when nothing matched)","usage":"simforge locations resolve [OPTIONS] --map <MAP> [TEXT]..."},{"arguments":[{"commandIndex":1,"help":"The source: a recording (simforge.recording/v1 or log-scene/v1, optionally gzipped), a v2 scenario, or a package directory holding one","name":"source","positional":true,"required":true,"type":"path","valueName":"SOURCE"}],"cloudOnlyGlobals":["--workspace","--api-url","--idempotency-key","--dry-run","--map-version"],"command":"transfer","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":1,"help":"The target map: a map directory, or name[@version] under the maps cache (semantic profile)","name":"--map","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"DIR|NAME@VERSION"},{"commandIndex":1,"help":"The source's map (default: the map the source names): a map directory, name[@version], or a bare OpenDRIVE file for a recording","name":"--source-map","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"DIR|NAME@VERSION|FILE.xodr"},{"commandIndex":1,"help":"A recording the scenario's replay routes pin (repeatable)","name":"--recording","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":1,"help":"Transfer from the source's root: follow its recording's `derivedFrom` (a transfer's warped recording, a scenario's rollout of the one recording it replays) through the `--recording` files to the recording it started from, and transfer that onto the map. The source's own scenario content (its edits) is not carried; the report records the chain in `source.root`","name":"--from-root","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"default":"network","help":"Where recorded motion looks for sites","name":"--sites","positional":false,"possibleValues":["network","corridor","same"],"required":false,"takesValue":true,"type":"enum","valueName":"SITES"},{"commandIndex":1,"default":"pure","help":"Which recorded actors transfer","name":"--profile","positional":false,"possibleValues":["pure","generalized","key-only"],"required":false,"takesValue":true,"type":"enum","valueName":"PROFILE"},{"commandIndex":1,"default":"any","help":"How a crosswalk crossing must land","name":"--crossing","positional":false,"possibleValues":["any","faithful"],"required":false,"takesValue":true,"type":"enum","valueName":"CROSSING"},{"commandIndex":1,"help":"Sites tried (transferred, gated and simulated) before giving up [default: 6 per --max-sites]","minimum":0,"name":"--max-try","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":1,"default":"1","help":"Distinct accepted sites to transfer onto (recorded motion), ranked; more than one writes each to site-<rank>/ under --out","minimum":1,"name":"--max-sites","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":1,"help":"With --max-sites: one site per cell of this size (metres) and heading quadrant [default: 200]. Smaller admits near-copies of the same drive","name":"--site-cell-m","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"M"},{"commandIndex":1,"help":"With --max-sites: no two placements whose egos' target paths come within this distance (metres) [default: 10]","name":"--min-path-separation-m","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"M"},{"commandIndex":1,"help":"The output directory (created; must be empty if it exists)","name":"--out","positional":false,"required":true,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":1,"help":"Map cache root to search for NAME@VERSION. Default: SIMFORGE_MAPS_CACHE_ROOT, then $XDG_DATA_HOME/simforge/maps","name":"--cache-root","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"DIR"},{"commandIndex":1,"help":"Simulate without map colliders when the map publishes none (recorded; the default refuses)","name":"--allow-no-colliders","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"default":"32400","help":"Last-resort wall-clock limit, seconds: a transfer still running then fails whole (`transfer_budget_exceeded`, nothing written). Set far above any healthy transfer (about 10x the slowest seen); what a transfer tries is bounded by --max-try and the import's rounds, never by time, so its result does not depend on the machine","minimum":1,"name":"--budget-s","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"SECONDS"},{"commandIndex":1,"default":"motion","help":"How the scenario moves to the target map","name":"--mode","positional":false,"possibleValues":["motion","semantic"],"required":false,"takesValue":true,"type":"enum","valueName":"MODE"},{"commandIndex":1,"help":"Allow an experimental --mode","name":"--experimental","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"default":"as-source","help":"Semantic mode: the target approach classes accepted, comma separated (two_way_stop_minor, two_way_stop_major, all_way_stop, signal, yield_minor, yield_major, stop_line_only, uncontrolled, mixed), or `as-source`. A class other than the source's is recorded as a requested substitution","name":"--target-control","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"CLASS,...|as-source"},{"commandIndex":1,"help":"Semantic mode: also fit a four-arm source onto a T-junction whose stem is the ego's approach; the roles on the source's opposite arm are left out (recorded), and each such placement is tagged `t_junction`","name":"--t-junction","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"conflictsWith":["--policy-version"],"help":"A transfer policy JSON file to transfer with, instead of a registered version","name":"--policy","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":1,"conflictsWith":["--policy"],"help":"A registered transfer policy version (sdk/contracts/transfer-policies.json, e.g. `transfer-v2`). Default: the registry's active version","name":"--policy-version","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"VERSION"},{"commandIndex":1,"execution":"cloud","help":"The immutable revision of a hosted scenario SOURCE","name":"--revision","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"REVISION_ID"},{"commandIndex":1,"execution":"cloud","help":"The new scenario's name. Default: `<source title> · <target map>`","name":"--name","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"NAME"},{"commandIndex":1,"execution":"cloud","help":"Explicit maximum cloud cost in cents","minimum":0,"name":"--max-cost","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"CENTS"},{"commandIndex":1,"execution":"cloud","help":"Wait for the transfer to finish","name":"--wait","positional":false,"possibleValues":["true","false"],"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"execution":"cloud","help":"Download a finished transfer's new scenario, report and receipt into --out; implies --wait","name":"--download","positional":false,"possibleValues":["true","false"],"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"execution":"cloud","help":"Save a SOURCE file to the workspace as an immutable revision (free) and price the transfer on it; starts nothing. --dry-run saves nothing","name":"--stage","positional":false,"possibleValues":["true","false"],"required":false,"takesValue":false,"type":"bool"}],"globals":["--cloud","--workspace","--api-url","--idempotency-key","--dry-run","--map-version"],"status":"available","summary":"Move a scenario or recording onto another map: recorded tracks warped through lane frames, behaviour re-bound by the matcher; simulated and gated, with a transfer report. Locally it needs the map's odr derivative, which `simforge maps pull` does not install yet: run it with --cloud","usage":"simforge transfer [OPTIONS] --map <DIR|NAME@VERSION> --out <DIR> <SOURCE>"},{"arguments":[{"commandIndex":1,"help":"The trace (`.trace.json` or `.trace.json.gz`, any released format)","name":"trace","positional":true,"required":true,"type":"path","valueName":"TRACE"}],"cloudOnlyGlobals":["--workspace","--api-url","--idempotency-key","--dry-run"],"command":"evaluate","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":1,"help":"Reject filters: critical | negative-control | all","name":"--filter","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"MODE"},{"commandIndex":1,"help":"The trivially-safe TTC threshold, seconds","name":"--trivial-ttc","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"S"},{"commandIndex":1,"help":"Reject any collision","name":"--reject-collisions","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"help":"The motion-plausibility audit to run. Default: `declared-speed-v1`","name":"--motion-audit-version","positional":false,"possibleValues":["declared-speed-v1","pose-motion-v2"],"required":false,"takesValue":true,"type":"enum","valueName":"MOTION_AUDIT_VERSION"},{"commandIndex":1,"help":"An intent rubric (IntentRubric JSON) evaluated alongside criticality","name":"--rubric","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":1,"help":"Write the context-blind review packet here (needs --rubric)","name":"--blind-review-out","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":1,"help":"Measure red-light and stop-bar compliance on this installed map directory (`map.xodr`, `derived/odr/locations-v2.json.gz`); reported as `trafficLaw`","name":"--traffic-law","positional":false,"required":false,"takesValue":true,"type":"path","valueName":"MAP_DIR"},{"commandIndex":1,"help":"An actor to measure (repeatable; default: the trace's metric subject)","name":"--traffic-law-actor","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"ACTOR"},{"commandIndex":1,"execution":"cloud","help":"The model that drives, by name (case-insensitive) or id: one of the models the host offers now (run without it to list them). Required","name":"--model","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"MODEL"},{"commandIndex":1,"execution":"cloud","help":"Your dataset of saved scenarios, by name (case-insensitive) or id. Required","name":"--dataset","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"DATASET"},{"commandIndex":1,"execution":"cloud","help":"Only these scenarios of the dataset, by name or id (comma-separated). Default: all of them","name":"--scenarios","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"SCENARIOS"},{"commandIndex":1,"execution":"cloud","help":"One of the model's parameters, as NAME=VALUE (repeatable): the options' `params` of the model, typed as listed (e.g. --param seed=7). Absent ones take their defaults","name":"--param","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"string","valueName":"NAME=VALUE"},{"commandIndex":1,"execution":"cloud","help":"Simulation seed for every scenario, 0 to 2^53-1. Default: 0","maximum":9007199254740991,"minimum":0,"name":"--seed","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"SEED"},{"commandIndex":1,"execution":"cloud","help":"Start at the quoted price without asking; required when no one can answer the prompt","name":"--yes","positional":false,"possibleValues":["true","false"],"required":false,"takesValue":false,"type":"bool"},{"commandIndex":1,"execution":"cloud","help":"Follow the run until it finishes","name":"--wait","positional":false,"possibleValues":["true","false"],"required":false,"takesValue":false,"type":"bool"}],"globals":["--cloud","--workspace","--api-url","--idempotency-key","--dry-run"],"status":"available","summary":"The reject filters (and an optional intent rubric) over a trace; exit 2 when it rejects. With --cloud: test a model by letting it drive your saved scenarios: simforge evaluate --cloud --model MODEL --dataset NAME [--scenarios A,B] [--yes] [--wait]. It is priced first and starts only once you confirm the total (--yes when nothing can prompt); no TRACE is read","usage":"simforge evaluate [OPTIONS] <TRACE>"},{"arguments":[],"cloudOnlyGlobals":["--workspace","--api-url","--dry-run","--map-version"],"command":"scenario new","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"The installed map (`simforge maps pull <map>@<version>`)","name":"--map","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"MAP"},{"commandIndex":2,"help":"Where to write the scenario document","name":"--out","positional":false,"required":true,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":2,"default":"Untitled scenario","help":"Scenario name","name":"--name","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"NAME"},{"commandIndex":2,"default":"20","help":"Clip length, seconds (3 to 120)","name":"--clip-seconds","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"S"},{"commandIndex":2,"help":"Creation timestamp `YYYY-MM-DDTHH:MM:SS.mmmZ` (default: now), for reproducible documents","name":"--created-at","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TIME"},{"commandIndex":2,"help":"Overwrite an existing file","name":"--force","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":2,"execution":"cloud","help":"The writable dataset the hosted draft goes in; absent, the credential's default dataset (named in the receipt)","name":"--dataset","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"DATASET_ID"}],"globals":["--cloud","--workspace","--api-url","--dry-run","--map-version"],"status":"available","summary":"Create an empty scenario on an installed map (revision 0)","usage":"simforge scenario new [OPTIONS] --map <MAP> --out <FILE>"},{"arguments":[],"command":"scenario ops list","flags":[],"globals":[],"status":"available","summary":"Every authoring operation: id, command, summary, required map context","usage":"simforge scenario ops list [OPTIONS]"},{"arguments":[{"commandIndex":3,"help":"Operation id (`addActor`) or command (`add-actor`)","name":"operation","positional":true,"required":true,"type":"string","valueName":"OPERATION"}],"command":"scenario ops show","flags":[],"globals":[],"status":"available","summary":"One operation: input and result schemas, flags, applicability and refusal codes","usage":"simforge scenario ops show [OPTIONS] <OPERATION>"},{"arguments":[],"command":"scenario actors","flags":[],"globals":[],"status":"available","summary":"The built-in actors operations place: class, dimensions, ego and static eligibility","usage":"simforge scenario actors [OPTIONS]"},{"arguments":[{"commandIndex":2,"help":"The scenario document (edited in place, atomically)","name":"file","positional":true,"required":true,"type":"path","valueName":"FILE"},{"commandIndex":3,"help":"Further operations of the same transaction, each after `--`.","last":true,"name":"more_operations","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"OPERATION"}],"cloudOnlyGlobals":["--workspace","--api-url","--dry-run","--map-version"],"command":"scenario apply add-actor","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"Refuse unless the document is at this revision (`stale_version`)","minimum":0,"name":"--expect-version","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"Refuse unless the document content has this digest (`stale_digest`); also accepts an edit made outside simforge","name":"--expect-digest","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"The transaction's undo label, at most 256 characters (default: the operation ids, e.g. `addActor×2, setEgo`)","name":"--transaction-label","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":3,"help":"With movementRsl: distance before the junction (default 40). [1..500 m]","name":"--before-m","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"Presentation body colour `#rrggbb`.","name":"--body-color","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"BODY_COLOR"},{"commandIndex":3,"help":"Built-in actor (`simforge scenario actors`): vehicle.sedan, pedestrian.adult, ...","name":"--catalog-id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"CATALOG_ID"},{"commandIndex":3,"help":"Heading in the scene frame; default: the lane heading or the actor class default. [rad]","name":"--heading-rad","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"New actor id (never allocated implicitly).","name":"--id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":3,"help":"Display label.","name":"--label","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"LABEL"},{"commandIndex":3,"help":"Lateral offset in the lane, positive to the left of travel. [m]","name":"--lateral-m","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"Snap to the nearest genuinely opposing lane.","name":"--opposing","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":3,"help":"Accept overlap with another actor (free/static actors only; refused for moving road vehicles).","name":"--overlap-override","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":3,"help":"Initial speed; default: posted limit for road vehicles. [0..160 km/h]","name":"--speed-kph","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"Place as a static actor (no motion, zero speed).","name":"--static","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":3,"help":"Explicit height; otherwise the map ground at (x,z) is used and refused without ground. [m]","name":"--y","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"conflictsWith":["--x","--z","--movement-rsl"],"help":"Semantic lane `road:section:lane` (with s).","name":"--lane-rsl","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"LANE_RSL"},{"commandIndex":3,"conflictsWith":["--x","--z","--movement-rsl"],"help":"Metres along laneRsl in its direction of travel, from where traffic enters it: the same s a location's anchor.road.s and a crossing approach's stopS report. [>= 0 m]","name":"--s","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"conflictsWith":["--lane-rsl","--s","--movement-rsl"],"help":"Scene-frame x (east). [m]","name":"--x","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"conflictsWith":["--lane-rsl","--s","--movement-rsl"],"help":"Scene-frame z (minus north). [m]","name":"--z","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"conflictsWith":["--lane-rsl","--s","--x","--z"],"help":"A junction movement's connecting lane (a junction_movement location's anchor.road.rsl): place the actor beforeM up its approach and turn it through that movement.","name":"--movement-rsl","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"MOVEMENT_RSL"}],"globals":["--cloud","--workspace","--api-url","--dry-run","--map-version"],"groups":[{"args":["--lane-rsl","--x","--movement-rsl"],"multiple":false,"required":true}],"status":"available","summary":"Place a new actor: a road vehicle on a semantic lane or before a junction movement, or a pedestrian/free static actor at a scene point.","usage":"simforge scenario apply <FILE> add-actor [OPTIONS] --catalog-id <CATALOG_ID> --id <ID> <--lane-rsl <LANE_RSL>|--x <N>|--movement-rsl <MOVEMENT_RSL>> [-- [OPERATION]...]"},{"arguments":[{"commandIndex":2,"help":"The scenario document (edited in place, atomically)","name":"file","positional":true,"required":true,"type":"path","valueName":"FILE"},{"commandIndex":3,"help":"Further operations of the same transaction, each after `--`.","last":true,"name":"more_operations","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"OPERATION"}],"cloudOnlyGlobals":["--workspace","--api-url","--dry-run","--map-version"],"command":"scenario apply move-actor","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"Refuse unless the document is at this revision (`stale_version`)","minimum":0,"name":"--expect-version","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"Refuse unless the document content has this digest (`stale_digest`); also accepts an edit made outside simforge","name":"--expect-digest","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"The transaction's undo label, at most 256 characters (default: the operation ids, e.g. `addActor×2, setEgo`)","name":"--transaction-label","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":3,"help":"Heading in the scene frame; default: the lane heading or the actor class default. [rad]","name":"--heading-rad","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"Actor to move.","name":"--id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":3,"help":"Lateral offset in the lane, positive to the left of travel. [m]","name":"--lateral-m","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"Accept overlap with another actor (free/static actors only; refused for moving road vehicles).","name":"--overlap-override","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":3,"help":"Explicit height; otherwise the map ground at (x,z) is used and refused without ground. [m]","name":"--y","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"conflictsWith":["--x","--z"],"help":"Semantic lane `road:section:lane` (with s).","name":"--lane-rsl","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"LANE_RSL"},{"commandIndex":3,"conflictsWith":["--x","--z"],"help":"Metres along laneRsl in its direction of travel, from where traffic enters it: the same s a location's anchor.road.s and a crossing approach's stopS report. [>= 0 m]","name":"--s","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"conflictsWith":["--lane-rsl","--s"],"help":"Scene-frame x (east). [m]","name":"--x","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"conflictsWith":["--lane-rsl","--s"],"help":"Scene-frame z (minus north). [m]","name":"--z","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"}],"globals":["--cloud","--workspace","--api-url","--dry-run","--map-version"],"groups":[{"args":["--lane-rsl","--x"],"multiple":false,"required":true}],"status":"available","summary":"Move an actor to a lane station or scene point, keeping identity, class, static state and speed.","usage":"simforge scenario apply <FILE> move-actor [OPTIONS] --id <ID> <--lane-rsl <LANE_RSL>|--x <N>> [-- [OPERATION]...]"},{"arguments":[{"commandIndex":2,"help":"The scenario document (edited in place, atomically)","name":"file","positional":true,"required":true,"type":"path","valueName":"FILE"},{"commandIndex":3,"help":"Further operations of the same transaction, each after `--`.","last":true,"name":"more_operations","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"OPERATION"}],"cloudOnlyGlobals":["--workspace","--api-url","--dry-run","--map-version"],"command":"scenario apply duplicate-actor","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"Refuse unless the document is at this revision (`stale_version`)","minimum":0,"name":"--expect-version","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"Refuse unless the document content has this digest (`stale_digest`); also accepts an edit made outside simforge","name":"--expect-digest","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"The transaction's undo label, at most 256 characters (default: the operation ids, e.g. `addActor×2, setEgo`)","name":"--transaction-label","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":3,"help":"Heading in the scene frame; default: the lane heading or the actor class default. [rad]","name":"--heading-rad","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"Source actor.","name":"--id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":3,"help":"Lateral offset in the lane, positive to the left of travel. [m]","name":"--lateral-m","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"New actor id.","name":"--new-id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"NEW_ID"},{"commandIndex":3,"help":"Accept overlap with another actor (free/static actors only; refused for moving road vehicles).","name":"--overlap-override","positional":false,"required":false,"takesValue":false,"type":"bool"},{"commandIndex":3,"help":"Explicit height; otherwise the map ground at (x,z) is used and refused without ground. [m]","name":"--y","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"conflictsWith":["--x","--z"],"help":"Semantic lane `road:section:lane` (with s).","name":"--lane-rsl","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"LANE_RSL"},{"commandIndex":3,"conflictsWith":["--x","--z"],"help":"Metres along laneRsl in its direction of travel, from where traffic enters it: the same s a location's anchor.road.s and a crossing approach's stopS report. [>= 0 m]","name":"--s","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"conflictsWith":["--lane-rsl","--s"],"help":"Scene-frame x (east). [m]","name":"--x","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"conflictsWith":["--lane-rsl","--s"],"help":"Scene-frame z (minus north). [m]","name":"--z","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"}],"globals":["--cloud","--workspace","--api-url","--dry-run","--map-version"],"groups":[{"args":["--lane-rsl","--x"],"multiple":false,"required":true}],"status":"available","summary":"Copy an actor with its presentation and own events under a new id at a new position.","usage":"simforge scenario apply <FILE> duplicate-actor [OPTIONS] --id <ID> --new-id <NEW_ID> <--lane-rsl <LANE_RSL>|--x <N>> [-- [OPERATION]...]"},{"arguments":[{"commandIndex":2,"help":"The scenario document (edited in place, atomically)","name":"file","positional":true,"required":true,"type":"path","valueName":"FILE"},{"commandIndex":3,"help":"Further operations of the same transaction, each after `--`.","last":true,"name":"more_operations","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"OPERATION"}],"cloudOnlyGlobals":["--workspace","--api-url","--dry-run","--map-version"],"command":"scenario apply remove-role","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"Refuse unless the document is at this revision (`stale_version`)","minimum":0,"name":"--expect-version","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"Refuse unless the document content has this digest (`stale_digest`); also accepts an edit made outside simforge","name":"--expect-digest","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"The transaction's undo label, at most 256 characters (default: the operation ids, e.g. `addActor×2, setEgo`)","name":"--transaction-label","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":3,"help":"Actor to delete.","name":"--id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"ID"}],"globals":["--cloud","--workspace","--api-url","--dry-run","--map-version"],"status":"available","summary":"Delete an actor with dependent events, reasoning and ego handoff.","usage":"simforge scenario apply <FILE> remove-role [OPTIONS] --id <ID> [-- [OPERATION]...]"},{"arguments":[{"commandIndex":2,"help":"The scenario document (edited in place, atomically)","name":"file","positional":true,"required":true,"type":"path","valueName":"FILE"},{"commandIndex":3,"help":"Further operations of the same transaction, each after `--`.","last":true,"name":"more_operations","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"OPERATION"}],"cloudOnlyGlobals":["--workspace","--api-url","--dry-run","--map-version"],"command":"scenario apply set-ego","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"Refuse unless the document is at this revision (`stale_version`)","minimum":0,"name":"--expect-version","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"Refuse unless the document content has this digest (`stale_digest`); also accepts an edit made outside simforge","name":"--expect-digest","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"The transaction's undo label, at most 256 characters (default: the operation ids, e.g. `addActor×2, setEgo`)","name":"--transaction-label","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":3,"help":"Actor to make ego.","name":"--role-id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"ROLE_ID"}],"globals":["--cloud","--workspace","--api-url","--dry-run","--map-version"],"status":"available","summary":"Make an actor the ego vehicle.","usage":"simforge scenario apply <FILE> set-ego [OPTIONS] --role-id <ROLE_ID> [-- [OPERATION]...]"},{"arguments":[{"commandIndex":2,"help":"The scenario document (edited in place, atomically)","name":"file","positional":true,"required":true,"type":"path","valueName":"FILE"},{"commandIndex":3,"help":"Further operations of the same transaction, each after `--`.","last":true,"name":"more_operations","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"OPERATION"}],"cloudOnlyGlobals":["--workspace","--api-url","--dry-run","--map-version"],"command":"scenario apply set-actor-speed","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"Refuse unless the document is at this revision (`stale_version`)","minimum":0,"name":"--expect-version","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"Refuse unless the document content has this digest (`stale_digest`); also accepts an edit made outside simforge","name":"--expect-digest","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"The transaction's undo label, at most 256 characters (default: the operation ids, e.g. `addActor×2, setEgo`)","name":"--transaction-label","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":3,"help":"Actor.","name":"--id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":3,"help":"Initial speed. [0..160 km/h]","name":"--speed-kph","positional":false,"required":true,"takesValue":true,"type":"number","valueName":"N"}],"globals":["--cloud","--workspace","--api-url","--dry-run","--map-version"],"status":"available","summary":"Set an actor's initial speed.","usage":"simforge scenario apply <FILE> set-actor-speed [OPTIONS] --id <ID> --speed-kph <N> [-- [OPERATION]...]"},{"arguments":[{"commandIndex":2,"help":"The scenario document (edited in place, atomically)","name":"file","positional":true,"required":true,"type":"path","valueName":"FILE"},{"commandIndex":3,"help":"Further operations of the same transaction, each after `--`.","last":true,"name":"more_operations","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"OPERATION"}],"cloudOnlyGlobals":["--workspace","--api-url","--dry-run","--map-version"],"command":"scenario apply set-actor-static","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"Refuse unless the document is at this revision (`stale_version`)","minimum":0,"name":"--expect-version","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"Refuse unless the document content has this digest (`stale_digest`); also accepts an edit made outside simforge","name":"--expect-digest","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"The transaction's undo label, at most 256 characters (default: the operation ids, e.g. `addActor×2, setEgo`)","name":"--transaction-label","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":3,"help":"Actor.","name":"--id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":3,"help":"true: static; false: mobile.","name":"--static","positional":false,"possibleValues":["true","false"],"required":true,"takesValue":true,"type":"enum","valueName":"BOOL"}],"globals":["--cloud","--workspace","--api-url","--dry-run","--map-version"],"status":"available","summary":"Make an actor static (clears its route and motion events) or mobile again.","usage":"simforge scenario apply <FILE> set-actor-static [OPTIONS] --id <ID> --static <BOOL> [-- [OPERATION]...]"},{"arguments":[{"commandIndex":2,"help":"The scenario document (edited in place, atomically)","name":"file","positional":true,"required":true,"type":"path","valueName":"FILE"},{"commandIndex":3,"help":"Further operations of the same transaction, each after `--`.","last":true,"name":"more_operations","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"OPERATION"}],"cloudOnlyGlobals":["--workspace","--api-url","--dry-run","--map-version"],"command":"scenario apply add-lane-change","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"Refuse unless the document is at this revision (`stale_version`)","minimum":0,"name":"--expect-version","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"Refuse unless the document content has this digest (`stale_digest`); also accepts an edit made outside simforge","name":"--expect-digest","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"The transaction's undo label, at most 256 characters (default: the operation ids, e.g. `addActor×2, setEgo`)","name":"--transaction-label","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":3,"help":"Actor.","name":"--actor-id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"ACTOR_ID"},{"commandIndex":3,"help":"Target lane side.","name":"--direction","positional":false,"possibleValues":["left","right"],"required":true,"takesValue":true,"type":"enum","valueName":"DIRECTION"},{"commandIndex":3,"help":"Lane-change duration. [> 0 s] (default 3)","name":"--duration-s","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"Clip time the event ends. [>= 0 s]","name":"--end-s","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"New event id.","name":"--id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":3,"help":"Clip time the change starts. [>= 0 s]","name":"--start-s","positional":false,"required":true,"takesValue":true,"type":"number","valueName":"N"}],"globals":["--cloud","--workspace","--api-url","--dry-run","--map-version"],"status":"available","summary":"Add a timed lane change for a mobile lane-bound road actor.","usage":"simforge scenario apply <FILE> add-lane-change [OPTIONS] --actor-id <ACTOR_ID> --direction <DIRECTION> --id <ID> --start-s <N> [-- [OPERATION]...]"},{"arguments":[{"commandIndex":2,"help":"The scenario document (edited in place, atomically)","name":"file","positional":true,"required":true,"type":"path","valueName":"FILE"},{"commandIndex":3,"help":"Further operations of the same transaction, each after `--`.","last":true,"name":"more_operations","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"OPERATION"}],"cloudOnlyGlobals":["--workspace","--api-url","--dry-run","--map-version"],"command":"scenario apply add-next-junction-turn","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"Refuse unless the document is at this revision (`stale_version`)","minimum":0,"name":"--expect-version","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"Refuse unless the document content has this digest (`stale_digest`); also accepts an edit made outside simforge","name":"--expect-digest","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"The transaction's undo label, at most 256 characters (default: the operation ids, e.g. `addActor×2, setEgo`)","name":"--transaction-label","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":3,"help":"Actor.","name":"--actor-id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"ACTOR_ID"},{"commandIndex":3,"help":"Movement at the next junction.","name":"--direction","positional":false,"possibleValues":["left","right","straight"],"required":true,"takesValue":true,"type":"enum","valueName":"DIRECTION"},{"commandIndex":3,"help":"Clip time the event ends. [>= 0 s]","name":"--end-s","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"New event id.","name":"--id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":3,"help":"Clip time the choice applies from. [>= 0 s]","name":"--start-s","positional":false,"required":true,"takesValue":true,"type":"number","valueName":"N"}],"globals":["--cloud","--workspace","--api-url","--dry-run","--map-version"],"status":"available","summary":"Choose the turn an actor takes at its next junction.","usage":"simforge scenario apply <FILE> add-next-junction-turn [OPTIONS] --actor-id <ACTOR_ID> --direction <DIRECTION> --id <ID> --start-s <N> [-- [OPERATION]...]"},{"arguments":[{"commandIndex":2,"help":"The scenario document (edited in place, atomically)","name":"file","positional":true,"required":true,"type":"path","valueName":"FILE"},{"commandIndex":3,"help":"Further operations of the same transaction, each after `--`.","last":true,"name":"more_operations","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"OPERATION"}],"cloudOnlyGlobals":["--workspace","--api-url","--dry-run","--map-version"],"command":"scenario apply add-u-turn","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"Refuse unless the document is at this revision (`stale_version`)","minimum":0,"name":"--expect-version","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"Refuse unless the document content has this digest (`stale_digest`); also accepts an edit made outside simforge","name":"--expect-digest","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"The transaction's undo label, at most 256 characters (default: the operation ids, e.g. `addActor×2, setEgo`)","name":"--transaction-label","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":3,"help":"A moving road vehicle on a lane.","name":"--actor-id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"ACTOR_ID"},{"commandIndex":3,"help":"New event id.","name":"--id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":3,"help":"A U-turn movement's connecting lane on the actor's route (authoring discover --kind movements, turnRelation UTurnLeft/UTurnRight); default: the first place it can turn.","name":"--movement-rsl","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"MOVEMENT_RSL"}],"globals":["--cloud","--workspace","--api-url","--dry-run","--map-version"],"status":"available","summary":"Make an actor (the ego too) turn back the way it came at the first place ahead on its route where it can: a junction's mapped U-turn movement, else a path drawn through a junction or across a road wide enough for its turning circle.","usage":"simforge scenario apply <FILE> add-u-turn [OPTIONS] --actor-id <ACTOR_ID> --id <ID> [-- [OPERATION]...]"},{"arguments":[{"commandIndex":2,"help":"The scenario document (edited in place, atomically)","name":"file","positional":true,"required":true,"type":"path","valueName":"FILE"},{"commandIndex":3,"help":"Further operations of the same transaction, each after `--`.","last":true,"name":"more_operations","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"OPERATION"}],"cloudOnlyGlobals":["--workspace","--api-url","--dry-run","--map-version"],"command":"scenario apply set-waypoint-route","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"Refuse unless the document is at this revision (`stale_version`)","minimum":0,"name":"--expect-version","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"Refuse unless the document content has this digest (`stale_digest`); also accepts an edit made outside simforge","name":"--expect-digest","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"The transaction's undo label, at most 256 characters (default: the operation ids, e.g. `addActor×2, setEgo`)","name":"--transaction-label","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":3,"help":"Actor.","name":"--actor-id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"ACTOR_ID"},{"commandIndex":3,"help":"Route duration. [> 0 s]","name":"--duration-s","positional":false,"required":true,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"Clip time the event ends. [>= 0 s]","name":"--end-s","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"New event id.","name":"--id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":3,"help":"Scene points `X,Z` in metres (x east, z minus north; the height follows the map ground), the actor's current position first. One `--point X,Z` per item (comma-separated numbers), at least 2.","name":"--point","positional":false,"repeatable":true,"required":true,"takesValue":true,"type":"string","valueName":"X,Z"},{"commandIndex":3,"help":"Clip time the route starts. [>= 0 s]","name":"--start-s","positional":false,"required":true,"takesValue":true,"type":"number","valueName":"N"}],"globals":["--cloud","--workspace","--api-url","--dry-run","--map-version"],"status":"available","summary":"Give an actor a smooth stop-to-stop timed route through scene points (two points: a crossing).","usage":"simforge scenario apply <FILE> set-waypoint-route [OPTIONS] --actor-id <ACTOR_ID> --duration-s <N> --id <ID> --point <X,Z> --start-s <N> [-- [OPERATION]...]"},{"arguments":[{"commandIndex":2,"help":"The scenario document (edited in place, atomically)","name":"file","positional":true,"required":true,"type":"path","valueName":"FILE"},{"commandIndex":3,"help":"Further operations of the same transaction, each after `--`.","last":true,"name":"more_operations","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"OPERATION"}],"cloudOnlyGlobals":["--workspace","--api-url","--dry-run","--map-version"],"command":"scenario apply add-speed-change","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"Refuse unless the document is at this revision (`stale_version`)","minimum":0,"name":"--expect-version","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"Refuse unless the document content has this digest (`stale_digest`); also accepts an edit made outside simforge","name":"--expect-digest","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"The transaction's undo label, at most 256 characters (default: the operation ids, e.g. `addActor×2, setEgo`)","name":"--transaction-label","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":3,"help":"Actor.","name":"--actor-id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"ACTOR_ID"},{"commandIndex":3,"help":"Clip time the event ends. [>= 0 s]","name":"--end-s","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"New event id.","name":"--id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":3,"help":"Acceleration or deceleration (default 4, at most the class limit: a car brakes at up to 8, speeds up at up to 3). [0.1..20 m/s²]","name":"--rate-mps2","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"Clip time the change starts. [>= 0 s]","name":"--start-s","positional":false,"required":true,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"Speed to reach; 0 brakes to a stop. [0..160 km/h]","name":"--target-kph","positional":false,"required":true,"takesValue":true,"type":"number","valueName":"N"}],"globals":["--cloud","--workspace","--api-url","--dry-run","--map-version"],"status":"available","summary":"Change an actor's speed from a clip time: brake to a stop, slow down, speed up or start moving.","usage":"simforge scenario apply <FILE> add-speed-change [OPTIONS] --actor-id <ACTOR_ID> --id <ID> --start-s <N> --target-kph <N> [-- [OPERATION]...]"},{"arguments":[{"commandIndex":2,"help":"The scenario document (edited in place, atomically)","name":"file","positional":true,"required":true,"type":"path","valueName":"FILE"},{"commandIndex":3,"help":"Further operations of the same transaction, each after `--`.","last":true,"name":"more_operations","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"OPERATION"}],"cloudOnlyGlobals":["--workspace","--api-url","--dry-run","--map-version"],"command":"scenario apply add-encounter","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"Refuse unless the document is at this revision (`stale_version`)","minimum":0,"name":"--expect-version","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"Refuse unless the document content has this digest (`stale_digest`); also accepts an edit made outside simforge","name":"--expect-digest","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"The transaction's undo label, at most 256 characters (default: the operation ids, e.g. `addActor×2, setEgo`)","name":"--transaction-label","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":3,"help":"Clip time of the moment: lead-brake brake start (default 3), cut-in lane-change start (3), crossing time on the target's lane (4), reversing start (1), pull-out start (2). [>= 0 s]","name":"--at-s","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"Built-in actor; default vehicle.sedan (box truck for reversing, pedestrian.adult for crossing).","name":"--catalog-id","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"CATALOG_ID"},{"commandIndex":3,"help":"lead-brake deceleration (default 5.5, a hard stop that stays within comfort checks). [0.5..12 m/s²]","name":"--decel-mps2","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"Centre-to-centre distance ahead of the target: at the start (lead-brake 20, slow-lead 30, stopped 25, reversing 25, pull-out 30, u-turn 25) or when the cut-in starts (7). [0..500 m]","name":"--gap-m","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"New actor id.","name":"--id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":3,"help":"lead-brake: ahead in the target's lane, brakes to a stop at atS. slow-lead: ahead, slower. stopped: standing ahead in the lane. cut-in: from the lane on the target's side, into its lane from atS, starting gapM in front. crossing: a pedestrian on the target's path at atS (or at x,z), ttcS before the target. oncoming / cross-traffic: a car on the opposite / a crossing approach of a junction ahead crosses its path ttcS before it (the first junction whose movement enters within 30° of straight against / square to the target's heading, else the nearest to it). reversing: standing ahead, reverses toward the target from atS. pull-out: parked at the side edge of the target's lane gapM ahead, pulls into the lane at atS. u-turn: ahead in the target's lane gapM ahead, makes a U-turn at the first place it can (a mapped U-turn movement, else a path through a junction or across a road wide enough).","name":"--kind","positional":false,"possibleValues":["lead-brake","slow-lead","stopped","cut-in","crossing","oncoming","cross-traffic","reversing","pull-out","u-turn"],"required":true,"takesValue":true,"type":"enum","valueName":"KIND"},{"commandIndex":3,"help":"cut-in: the target's side the car comes from (required). crossing: the side the pedestrian starts on (default right). pull-out: the lane edge the car is parked at (default right).","name":"--side","positional":false,"possibleValues":["left","right"],"required":false,"takesValue":true,"type":"enum","valueName":"SIDE"},{"commandIndex":3,"help":"The new actor's speed: lead-brake the target's, slow-lead half of it, cut-in 10 faster, crossing walk 4.5, oncoming/cross-traffic the posted limit, reversing 6, pull-out 20, u-turn the target's within 15-30. [0..160 km/h]","name":"--speed-kph","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"The actor the encounter is with: a moving road vehicle on a lane. (default \"ego\")","name":"--target","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TARGET"},{"commandIndex":3,"help":"crossing, oncoming, cross-traffic: the target's time to the conflict point when the new actor is on it (crossing default 2, junctions 1.5; negative: after the target). [-10..30 s]","name":"--ttc-s","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"oncoming / cross-traffic: the new car's movement through the junction (default straight).","name":"--turn","positional":false,"possibleValues":["left","right","straight"],"required":false,"takesValue":true,"type":"enum","valueName":"TURN"},{"commandIndex":3,"help":"crossing: a scene point on the target's path where the pedestrian crosses (a crosswalk), with z; replaces atS. [m]","name":"--x","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"crossing: the point's scene z (minus north). [m]","name":"--z","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"}],"globals":["--cloud","--workspace","--api-url","--dry-run","--map-version"],"status":"available","summary":"Add an actor that meets the target (the ego by default) the way --kind says, placed and timed from the road graph: lead-brake, slow-lead, stopped, cut-in, crossing, oncoming, cross-traffic, reversing, pull-out, u-turn.","usage":"simforge scenario apply <FILE> add-encounter [OPTIONS] --id <ID> --kind <KIND> [-- [OPERATION]...]"},{"arguments":[{"commandIndex":2,"help":"The scenario document (edited in place, atomically)","name":"file","positional":true,"required":true,"type":"path","valueName":"FILE"},{"commandIndex":3,"help":"Further operations of the same transaction, each after `--`.","last":true,"name":"more_operations","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"OPERATION"}],"cloudOnlyGlobals":["--workspace","--api-url","--dry-run","--map-version"],"command":"scenario apply set-event-timing","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"Refuse unless the document is at this revision (`stale_version`)","minimum":0,"name":"--expect-version","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"Refuse unless the document content has this digest (`stale_digest`); also accepts an edit made outside simforge","name":"--expect-digest","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"The transaction's undo label, at most 256 characters (default: the operation ids, e.g. `addActor×2, setEgo`)","name":"--transaction-label","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":3,"help":"End clip time. [>= 0 s]","name":"--end-s","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"Event.","name":"--id","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":3,"help":"Start clip time. [>= 0 s]","name":"--start-s","positional":false,"required":true,"takesValue":true,"type":"number","valueName":"N"}],"globals":["--cloud","--workspace","--api-url","--dry-run","--map-version"],"status":"available","summary":"Retime an event's start and optional end.","usage":"simforge scenario apply <FILE> set-event-timing [OPTIONS] --id <ID> --start-s <N> [-- [OPERATION]...]"},{"arguments":[{"commandIndex":2,"help":"The scenario document (edited in place, atomically)","name":"file","positional":true,"required":true,"type":"path","valueName":"FILE"},{"commandIndex":3,"help":"Further operations of the same transaction, each after `--`.","last":true,"name":"more_operations","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"OPERATION"}],"cloudOnlyGlobals":["--workspace","--api-url","--dry-run","--map-version"],"command":"scenario apply set-weather","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"Refuse unless the document is at this revision (`stale_version`)","minimum":0,"name":"--expect-version","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"Refuse unless the document content has this digest (`stale_digest`); also accepts an edit made outside simforge","name":"--expect-digest","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"The transaction's undo label, at most 256 characters (default: the operation ids, e.g. `addActor×2, setEgo`)","name":"--transaction-label","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":3,"help":"Canonical scenario weather.","name":"--weather","positional":false,"possibleValues":["clear","cloudy","overcast","light_rain","heavy_rain","wet_road","fog_light","fog_dense","snow","sleet"],"required":true,"takesValue":true,"type":"enum","valueName":"WEATHER"}],"globals":["--cloud","--workspace","--api-url","--dry-run","--map-version"],"status":"available","summary":"Set the scenario weather.","usage":"simforge scenario apply <FILE> set-weather [OPTIONS] --weather <WEATHER> [-- [OPERATION]...]"},{"arguments":[{"commandIndex":2,"help":"The scenario document (edited in place, atomically)","name":"file","positional":true,"required":true,"type":"path","valueName":"FILE"},{"commandIndex":3,"help":"Further operations of the same transaction, each after `--`.","last":true,"name":"more_operations","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"OPERATION"}],"cloudOnlyGlobals":["--workspace","--api-url","--dry-run","--map-version"],"command":"scenario apply set-clock","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"Refuse unless the document is at this revision (`stale_version`)","minimum":0,"name":"--expect-version","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"Refuse unless the document content has this digest (`stale_digest`); also accepts an edit made outside simforge","name":"--expect-digest","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"The transaction's undo label, at most 256 characters (default: the operation ids, e.g. `addActor×2, setEgo`)","name":"--transaction-label","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":3,"help":"Minutes after local midnight. [0..1439 min]","maximum":1439,"minimum":0,"name":"--minutes","positional":false,"required":true,"takesValue":true,"type":"integer","valueName":"N"}],"globals":["--cloud","--workspace","--api-url","--dry-run","--map-version"],"status":"available","summary":"Set the precise scene clock; the time of day becomes the label of the sun at the map's site on the scenario's day.","usage":"simforge scenario apply <FILE> set-clock [OPTIONS] --minutes <N> [-- [OPERATION]...]"},{"arguments":[{"commandIndex":2,"help":"The scenario document (edited in place, atomically)","name":"file","positional":true,"required":true,"type":"path","valueName":"FILE"},{"commandIndex":3,"help":"Further operations of the same transaction, each after `--`.","last":true,"name":"more_operations","positional":true,"repeatable":true,"required":false,"type":"string","valueName":"OPERATION"}],"cloudOnlyGlobals":["--workspace","--api-url","--dry-run","--map-version"],"command":"scenario apply set-clip","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"Refuse unless the document is at this revision (`stale_version`)","minimum":0,"name":"--expect-version","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"Refuse unless the document content has this digest (`stale_digest`); also accepts an edit made outside simforge","name":"--expect-digest","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"},{"commandIndex":2,"help":"The transaction's undo label, at most 256 characters (default: the operation ids, e.g. `addActor×2, setEgo`)","name":"--transaction-label","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":3,"help":"Clip length. [3..120 s]","name":"--clip-seconds","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"},{"commandIndex":3,"help":"Warm-up before the clip. [0..30 s]","name":"--warmup-seconds","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"N"}],"globals":["--cloud","--workspace","--api-url","--dry-run","--map-version"],"groups":[{"args":["--clip-seconds","--warmup-seconds"],"multiple":true,"required":true}],"status":"available","summary":"Set the clip length and/or warm-up; out-of-clip events are refused, never truncated.","usage":"simforge scenario apply <FILE> set-clip [OPTIONS] <--clip-seconds <N>|--warmup-seconds <N>> [-- [OPERATION]...]"},{"arguments":[{"commandIndex":2,"help":"The scenario document","name":"file","positional":true,"required":true,"type":"path","valueName":"FILE"}],"cloudOnlyGlobals":["--workspace","--api-url","--dry-run","--map-version"],"command":"scenario check","execution":{"cloud":true,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"What fails the check (exit 2)","name":"--strictness","positional":false,"possibleValues":["errors","warnings"],"required":true,"takesValue":true,"type":"enum","valueName":"STRICTNESS"},{"commandIndex":2,"help":"Also materialize and run every actor on the engine (collisions, quality, input identity)","name":"--preview","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":["--cloud","--workspace","--api-url","--dry-run","--map-version"],"status":"available","summary":"Full validation on the document's map (exit 2 per --strictness); --preview also runs every actor on the engine and flags an actor the ego never sees or meets. The installed map's own findings (mapDiagnostics) never fail it","usage":"simforge scenario check [OPTIONS] --strictness <STRICTNESS> <FILE>"},{"arguments":[{"commandIndex":2,"help":"The scenario document","name":"file","positional":true,"required":true,"type":"path","valueName":"FILE"}],"command":"scenario drive","execution":{"cloud":false,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"Run on this installed map instead of the document's own","name":"--map","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"MAP"},{"commandIndex":2,"default":"document","help":"Generated traffic","name":"--ambient","positional":false,"possibleValues":["document","off"],"required":false,"takesValue":true,"type":"enum","valueName":"AMBIENT"},{"commandIndex":2,"help":"Exit 2 when any road vehicle has a driving finding","name":"--strict","positional":false,"required":false,"takesValue":false,"type":"bool"}],"globals":[],"status":"available","summary":"Run the editor preview's engine pass over a scenario and report how each road vehicle drove","usage":"simforge scenario drive [OPTIONS] <FILE>"},{"arguments":[{"commandIndex":2,"help":"The scenario document (edited in place, atomically, as the next revision)","name":"file","positional":true,"required":true,"type":"path","valueName":"FILE"}],"command":"scenario motion","execution":{"cloud":false,"default":"local-runtime"},"flags":[{"commandIndex":2,"help":"The actor (role id) to convert","name":"--actor","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"ID"},{"commandIndex":2,"help":"The motion to convert it to","name":"--to","positional":false,"possibleValues":["follow-path","behave","reset-to-recording"],"required":true,"takesValue":true,"type":"enum","valueName":"TO"},{"commandIndex":2,"help":"A recording the document pins (plain or gzipped; log-scene/v1 reads as one). Repeatable","name":"--recording","positional":false,"repeatable":true,"required":false,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":2,"help":"Use this installed map instead of the document's own","name":"--map","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"MAP"},{"commandIndex":2,"help":"Refuse unless the document is at this revision (`stale_version`)","minimum":0,"name":"--expect-version","positional":false,"required":false,"takesValue":true,"type":"integer","valueName":"N"},{"commandIndex":2,"help":"Refuse unless the document content has this digest (`stale_digest`); also accepts an edit made outside simforge","name":"--expect-digest","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"SHA256"}],"globals":[],"status":"available","summary":"Change how one actor moves: Replay to Follow path (engine-owned speed), Follow path to Behave (lanes)","usage":"simforge scenario motion [OPTIONS] --actor <ID> --to <TO> <FILE>"},{"arguments":[{"commandIndex":1,"help":"The instance: a scenario cell, a pinned scenario, a bare SimScenarioInput, or a `log import` workspace directory (XML formats replay its recorded trace)","name":"instance","positional":true,"required":true,"type":"path","valueName":"INSTANCE"}],"command":"export","execution":{"cloud":false,"default":"local-runtime"},"flags":[{"commandIndex":1,"help":"xosc-1.4 | xosc-1.3-esmini | osc-2.2","name":"--format","positional":false,"required":true,"takesValue":true,"type":"string","valueName":"FORMAT"},{"commandIndex":1,"help":"Write the document here","name":"--out","positional":false,"required":true,"takesValue":true,"type":"path","valueName":"FILE"},{"commandIndex":1,"help":"The road-network file the document references (default `<mapId>.xodr`)","name":"--road-file","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"FILE"},{"commandIndex":1,"help":"FileHeader author","name":"--author","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"NAME"},{"commandIndex":1,"help":"FileHeader description","name":"--description","positional":false,"required":false,"takesValue":true,"type":"string","valueName":"TEXT"},{"commandIndex":1,"help":"Maximum distance between exported route waypoints, metres (default 20)","name":"--route-sample-m","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"M"},{"commandIndex":1,"help":"XML: omit trajectory vertices that interpolation reproduces within this many metres, 0.1 deg and 0.1 m/s (default: every sample)","name":"--trajectory-tolerance-m","positional":false,"required":false,"takesValue":true,"type":"number","valueName":"M"}],"globals":[],"status":"available","summary":"A concrete instance as ASAM OpenSCENARIO XML 1.4, XML 1.3 (esmini) or DSL 2.2, with a capability report","usage":"simforge export [OPTIONS] --format <FORMAT> --out <FILE> <INSTANCE>"},{"arguments":[{"help":"The hosted scenario document id","name":"id","required":true,"type":"string","valueName":"ID"}],"command":"scenario pull","flags":[{"help":"Output file. Default: <ID>.scenario.json","name":"--out","required":false,"takesValue":true,"type":"path","valueName":"OUT"},{"help":"SimForge host. Default: SIMFORGE_HOST, then the host of the last login, then simforge.ai","name":"--host","required":false,"takesValue":true,"type":"string","valueName":"HOST"},{"help":"Overwrite an existing output file","name":"--force","required":false,"takesValue":false,"type":"bool"},{"help":"Print help","name":"--help","required":false,"takesValue":false,"type":"bool"}],"globals":[],"status":"available","summary":"Download a hosted scenario document as a local scenario JSON file","usage":"simforge scenario pull [OPTIONS] <ID>"}],"error":{"fields":{"code":"stable snake_case error code","detail":"structured extras (allowed values, the host's issues, ids); never a second hint","hint":"what to do next","httpStatus":"the host's HTTP status, when a host answered","path":"the flag, argument or input path the error is about","reason":"what went wrong","requestId":"the host's request id, for support"},"required":["code","reason","hint"],"schema":"simforge.error/v1"},"exitCodes":{"0":"ok","1":"command error: the command could not run","2":"findings: the command ran and found something wrong with its input"},"globalFlags":[{"global":true,"help":"Indent the JSON result for humans (the same document, never a different one)","name":"--pretty","required":false,"takesValue":false,"type":"bool"},{"global":true,"help":"Explicit machine-readable JSON output (also the default)","name":"--json","required":false,"takesValue":false,"type":"bool"},{"global":true,"help":"Execute locally by default; submit the same input as an authenticated cloud job","name":"--cloud","required":false,"takesValue":false,"type":"bool"},{"env":"SIMFORGE_WORKSPACE_ID","global":true,"help":"With --cloud: the workspace you expect the login to act in; a different one is refused (workspace_mismatch)","name":"--workspace","required":false,"takesValue":true,"type":"string","valueName":"cloud_workspace"},{"global":true,"help":"With --cloud: a key that makes resending a lost submission safe (the host answers with the original run and charges once)","name":"--idempotency-key","required":false,"takesValue":true,"type":"string","valueName":"IDEMPOTENCY_KEY"},{"global":true,"help":"With --cloud: price the job (costEstimateCents) and start nothing","name":"--dry-run","required":false,"takesValue":false,"type":"bool"},{"global":true,"help":"Hosted API base URL for API-key use. Default: SIMFORGE_API_URL, then the signed-in host's /api/v1","name":"--api-url","required":false,"takesValue":true,"type":"string","valueName":"API_URL"},{"global":true,"help":"Exact hosted map version for a scenario file. Default: the installed release's, else the one hosted version carrying the file's OpenDRIVE digest","name":"--map-version","required":false,"takesValue":true,"type":"string","valueName":"MAP_VERSION"},{"global":true,"help":"Print machine-readable command help.","name":"--help","required":false,"takesValue":false,"type":"bool"}],"output":"stdout: one JSON document (indented with --pretty); stderr: one simforge.error/v1 line {code, path?, reason, hint, detail?, httpStatus?, requestId?} on failure","schema":"simforge.cli-surface/v1","version":"0.2.0-rc.9"}