# End-to-end acceptance

ForgeFlow 0.8 includes a read-only acceptance harness for the real Local ->
Gitea -> Server chain. It never deploys unless an execution flag is supplied.

Set `FORGEFLOW_GITEA_URL`, `FORGEFLOW_GITEA_TOKEN`, `FORGEFLOW_REPOSITORY`
(`owner/repository`), `FORGEFLOW_LOCAL_PATH`, `FORGEFLOW_BRANCH`,
`FORGEFLOW_STATUS_URL` and `FORGEFLOW_HEALTH_URL` locally. Optional variables
are `FORGEFLOW_WORKFLOW`, `FORGEFLOW_ROLLBACK_WORKFLOW` and
`FORGEFLOW_ENVIRONMENT`. Never commit the token.

```powershell
npm run acceptance
npm run acceptance -- --execute-deployment
npm run acceptance -- --execute-rollback
```

The first command is read-only. The mutation flags require every read-only
check to pass, dispatch a controlled exact-SHA workflow with a unique request
ID, and wait for matching status plus a successful health endpoint.