hiiu verify
Crawl an already-running copy over every declared route and report what rendered and what went unmatched. Exit 5 is expected today.
hiiu verify --url <origin> [path]Crawls a running copy over every declared route and emits the verification document: what rendered, and what tried to leave.
It starts nothing. --url names an already-running loopback server, which
is usually one hiiu dev is running elsewhere.
Arguments and flags
[path] |
The repo or app directory the running server was built from. Default . |
--url <origin> |
The already-running loopback server to crawl |
--decisions <file> |
The confirmed decisions document naming the priority routes |
--deny-log <file> |
The file the interception layer records server-side denials in |
Every global flag also applies.
Expect exit 5
Exit 5 means a route crashed, or a denied request landed on a route the
decisions document marks as a priority. Which routes are priorities is a
decision rather than a heuristic, which is why it comes from --decisions.
It needs a browser
Playwright is the driver, and it is deliberately not a dependency of the
package: declaring it would make npx @hiiu/cli analyze download a
per-platform browser before it could read a directory. A missing browser here
is exit 3 with PLAYWRIGHT_MISSING and an install hint.
hiiu doctor reports it as a warning, never a failure.
Exit codes
| Code | When |
|---|---|
0 |
Every route rendered and no priority route leaked |
3 |
No server at --url, or PLAYWRIGHT_MISSING |
5 |
A route did not render, or a priority route had a denied request |
Example
hiiu verify --url http://127.0.0.1:5173 --json | jq '.routes[] | select(.unmatched > 0)'