CI and documentation publishing
CI
.github/workflows/ci.yml runs on pull requests and on preview / main:
- typecheck
- unit tests
- package-boundary check
- production-mail fixture policy
migrate:ci(appliesdatabase/migrationstoDATABASE_URLor ephemeral PGlite and verifies current head, including MAIL-960011)- Next.js production build for
@inbox-agent/web(npm run docs:build)
ENABLE_SEND is false unless the process environment is exactly true. That default is tested for local, preview, production, and test.
Application and docs sites
GitHub Pages cannot publish this private repository. Duckbill™ is hosted on a dedicated Vercel project, inbox-agent-docs, linked to PlatypusDBA/duckbill (formerly inbox-assistant; GitHub redirects the old name). That project is not jasonkoch-io, platypus-software, or any other existing site.
The site is the Next.js app in apps/web (ADR 0007). Markdown in docs/ is rendered as documentation routes. Navigation is owned by apps/web/src/lib/docs-nav.ts. There is no MkDocs publisher.
| Branch | Publisher | Site |
|---|---|---|
preview | Vercel Git integration | https://duckbill-dev.jasonkoch.io |
main | Vercel Git integration | https://duckbill.jasonkoch.io |
.github/workflows/docs.yml builds @inbox-agent/web and uploads the Next.js build output as a CI artifact. It does not publish GitHub Pages.
Vercel settings: framework nextjs, root directory apps/web, install cd ../.. && npm ci, build cd ../.. && npm run build -w @inbox-agent/web. Include files outside the root directory so docs/ and workspace packages are available at build time.
Kill switches
PAUSE_AUTOMATION and PAUSE_AI are default-off configuration keys. They do not enable send or delete.