sdods record, har, auth
Record sessions, manage HAR files and capture login state.
record (alias codegen)
sdods record -p <slug> -e <env> [--name <name>] [--url <route|path|url>] [--device <name>] [--user <role>]
[-b <browser>] [--save-har] [--har-glob <glob>] [--viewport <WxH>] [--tag <tag>]... [--no-post-process]
sdods record convert <spec> [--dry-run] [--adapter claude|openai|fake]| Flag | Meaning |
|---|---|
--name <name> | recording name → recorded/<name>.spec.ts (default rec-<timestamp>) |
--url <route|path|url> | route name from the project YAML, a path, or an absolute URL (default /) |
--device <name> | device name, e.g. "iPhone 15" |
--user <role> | lease a pool user of this role and start logged in (storage state) |
-b, --browser <name> | chromium (default), firefox, webkit |
--save-har | also capture network into har/<env>/<name>.har; --har-glob limits the URLs (default **/*) |
--viewport <WxH> | viewport such as 1280x720 (ignored with --device) |
--tag <tag> | extra tag for the recorded spec; repeatable |
--no-post-process | keep the raw codegen output |
Post-processing rewrites the import to the SDODS fixtures, turns absolute URLs of the environment into routes, wraps the test in test.describe with @recorded @ui @regression, adds a header comment with the re-record command and marks CSS/XPath locators as fragile. record convert asks the generator agent for a feature + steps proposal that a person reviews.
har
sdods har record -p <slug> -e <env> [-t <expr>] [-l <layer>]... [-b <browser>]...
sdods har record -p <slug> -e <env> --interactive --name <name> [--url <route|path|url>] [--har-glob <glob>]
sdods har replay -p <slug> -e <env> [-t <expr>] [-l <layer>]... [-b <browser>]... [--strict] [-w <n>]
sdods har list -p <slug> [-e <env>]record runs the @har:<name> scenarios in update mode (or opens codegen with --save-har in interactive mode). replay runs them from their HAR files; --strict aborts requests missing from the HAR and blocks every other network call, which is how CI runs offline. Files live under projects/<slug>/har/<env>/<name>.har with a .har.json sidecar.
auth
sdods auth capture -p <slug> -e <env> [-u <role>] [--index <n> | --all] [--interactive] [-b <browser>] [--headed] [--force]
sdods auth list -p <slug> -e <env>capture logs in as pool users with the project's auth strategy (form, token, oauth-client-credentials; sso needs --interactive) and stores storage state under projects/<slug>/.auth/<env>/<role>-<n>.json with a sidecar recording when it was captured. list shows cached states and their age. Cached states are refreshed automatically when their cookies expire or auth.maxAgeMinutes passes.