24
Deploy a governed workflow to production
Guides & tutorials2 min read
Ship with signed webhooks, non-mutating deploy proof, and full observability wired in.
Pass the full quality gate, make your webhook receiver idempotent, run non-mutating deployment readiness, and wire observability so agent quality is evaluated from evidence, not vibes. Prerequisites: Railway and Cloudflare access for the services you own.
$ pnpm hooks:install$ pnpm format:check$ pnpm lint$ pnpm typecheck$ pnpm testpnpm quality:fullHandle webhook deliveries safely
- Verify the signature against the raw request body before you parse it as JSON.
- Deduplicate by delivery identifier before applying any side effect.
- Return a successful response only after the delivery is durably accepted on your side.
- Expect exponential retry and out-of-order delivery; reconcile from canonical resource state, not delivery order.
| Resource | Endpoints | Notes |
|---|---|---|
| Webhooks | /v1/webhooks · /v1/webhook-deliveries | Signed and retried |
Run deployment readiness
$ pnpm readiness:railway$ pnpm readiness:railway:variables$ pnpm readiness:railway:source$ pnpm readiness:cloudflare$ pnpm cloudflare:inventoryDeployment proof
A build, push, dry run, or dashboard badge is not live proof. Verify deployed source, service variables, health endpoints, and the exact public route that changed.
Wire observability and gate on evaluations
- OpenTelemetry
- Cross-service spans for API, tools, sandboxes, and on-chain execution.
- Langfuse
- Prompt and model traces where policy permits.
- Braintrust
- Datasets, prompt operations, evaluation, and improvement cycles.
- Sentry
- Exceptions and production failure diagnosis.
- Run ledger
- Canonical event sequence for status, approvals, artifacts, and receipts.
$ pnpm eval:agent-harness$ pnpm test:policy$ pnpm readiness:provider-smokes$ pnpm braintrust:improvement-cycleWas this page helpful?
Edit on GitHub