docs: fold exit codes into the API Reference index page

Author: smonn

docs.json

@@ -390,8 +390,7 @@
                   "qawolf/libraries/cli/api-reference/index",
                   "qawolf/libraries/cli/api-reference/commands",
                   "qawolf/libraries/cli/api-reference/configuration",
-                  "qawolf/libraries/cli/api-reference/environment-variables",
-                  "qawolf/libraries/cli/api-reference/exit-codes"
+                  "qawolf/libraries/cli/api-reference/environment-variables"
                 ]
               },
               {

qawolf/libraries/cli/api-reference/commands.mdx

@@ -62,7 +62,7 @@ Options:
 - `--headed` — show the browser window instead of running headless. Default: `false`.
 - `--env <env>` — environment ID. When set, missing flows are pulled before the run.
 
-Exit codes: `0` when all flows pass, `1` when one or more flows fail, `2` for invalid arguments or an unrecognized flow target. See [Exit codes](/qawolf/libraries/cli/api-reference/exit-codes).
+Exit codes: `0` when all flows pass, `1` when one or more flows fail, `2` for invalid arguments or an unrecognized flow target. See [Exit codes](/qawolf/libraries/cli/api-reference/index#exit-codes).
 
 ### `flows list [pattern]`
 

qawolf/libraries/cli/api-reference/exit-codes.mdx

@@ -31,3 +31,16 @@ The following flags apply to every command:
 - `--agent` — formats output for agent consumption.
 
 When a recognized CI environment is detected (`CI`, `GITHUB_ACTIONS`, `GITLAB_CI`, `CIRCLECI`, `JENKINS_URL`, `BUILDKITE`), output defaults to JSON. When a recognized agent environment is detected (`CLAUDE_CODE`, `CURSOR_SESSION_ID`), output defaults to agent mode.
+
+## Exit Codes
+
+Every qawolf CLI command exits with one of the codes below.
+
+| Code | Name | Meaning |
+| --- | --- | --- |
+| `0` | `success` | The command completed successfully. |
+| `1` | `testFailure` | One or more flows failed. |
+| `2` | `invalidArgs` | A Commander parse error, an unknown subcommand, or a bad flag value. |
+| `3` | `auth` | `QAWOLF_API_KEY` is missing or invalid. |
+| `4` | `network` | The QA Wolf API was unreachable, a download from storage failed, or a registry was unreachable. |
+| `5` | `config` | `qawolf.config.ts` is invalid, or a file collision occurred during `qawolf init`. |

qawolf/libraries/cli/api-reference/index.mdx

@@ -102,7 +102,7 @@ The CLI discovers flows matching `**/*.flow.{ts,js}` in the current directory an
 
 ## Exit codes
 
-`qawolf flows run` exits with `0` when every flow passes and `1` when one or more fail. See [Exit codes](/qawolf/libraries/cli/api-reference/exit-codes) for the full list.
+`qawolf flows run` exits with `0` when every flow passes and `1` when one or more fail. See [Exit codes](/qawolf/libraries/cli/api-reference/index#exit-codes) for the full list.
 
 ## Current limitations