Complete Deliverable Registry
This is the master deliverable registry for GOVERN engineering. Every surface, its package, how to build it, how to deploy it, and internal engineering notes.
Complete Surface Registry
| # | Surface | Package | Status | Deploy target |
|---|---|---|---|---|
| 1 | GOVERN Dashboard | govern-dashboard | Live | govern-dashboard.pages.dev |
| 2 | GOVERN App | govern-app | Live | govern-app.pages.dev |
| 3 | GOVERN Admin | govern-admin | Live | govern-admin.pages.dev |
| 4 | GOVERN Customer | govern-customer | Live | govern-customer.pages.dev |
| 5 | GOVERN API | api-gateway | Live | CF Worker — jarvis-api-gateway.ben-c1f.workers.dev |
| 6 | GOVERN Probe | Docker image | Live | archetypal/govern-probe:latest |
| 7 | SDK TypeScript | npm | Live | @archetypal-ai/govern |
| 8 | SDK Python | PyPI | Live | archetypal-govern |
| 9 | SDK Go | Go module | In progress | github.com/archetypal-ai/govern-go |
| 10 | GOVERN CLI | npm | Live | @archetypal-ai/govern-cli |
| 11 | GOVERN Docs | govern-docs | Live | govern-docs.pages.dev |
| 12 | Developer Docs | govern-developer-docs | Live | govern-developer-docs.pages.dev |
| 13 | Admin Docs | govern-admin-docs | Live | govern-admin-docs.pages.dev |
| 14 | Internal Docs | govern-internal-docs | Live | Internal only |
| 15 | GitHub Action | govern-action repo | Live | archetypal-ai/govern-action@v1 |
| 16 | Monitoring Agent | Docker image | Live | archetypal/govern-agent:latest |
| 17 | API Spec | OpenAPI 3.1 | Live | docs/products/govern-api-spec.md |
Build commands — all surfaces
Web applications
# Build all web appspnpm --filter @jarvis/govern-dashboard buildpnpm --filter @jarvis/govern-app buildpnpm --filter @jarvis/govern-admin buildpnpm --filter @jarvis/govern-customer buildDocumentation sites
# Build all docs sitespnpm --filter @jarvis/govern-docs buildpnpm --filter @jarvis/govern-developer-docs buildpnpm --filter @jarvis/govern-admin-docs buildpnpm --filter @jarvis/govern-internal-docs buildAPI gateway
cd packages/api-gatewaypnpm typecheck && pnpm test && pnpm deployContainer images (Docker)
# Build Probe imagedocker build -t archetypal/govern-probe:latest packages/govern-probe/
# Build Agent imagedocker build -t archetypal/govern-agent:latest packages/govern-agent/
# Push to registrydocker push archetypal/govern-probe:latestdocker push archetypal/govern-agent:latestDeploy commands — all surfaces
Web apps to Cloudflare Pages
# Dashboardpnpm --filter @jarvis/govern-dashboard buildwrangler pages deploy packages/govern-dashboard/dist --project-name govern-dashboard
# Apppnpm --filter @jarvis/govern-app buildwrangler pages deploy packages/govern-app/dist --project-name govern-app
# Adminpnpm --filter @jarvis/govern-admin buildwrangler pages deploy packages/govern-admin/dist --project-name govern-admin
# Customerpnpm --filter @jarvis/govern-customer buildwrangler pages deploy packages/govern-customer/dist --project-name govern-customerDocs sites to Cloudflare Pages
pnpm --filter @jarvis/govern-docs buildwrangler pages deploy packages/govern-docs/dist --project-name govern-docs
pnpm --filter @jarvis/govern-developer-docs buildwrangler pages deploy packages/govern-developer-docs/dist --project-name govern-developer-docs
pnpm --filter @jarvis/govern-admin-docs buildwrangler pages deploy packages/govern-admin-docs/dist --project-name govern-admin-docs
# Internal docs: deploy only to internal Pages projectpnpm --filter @jarvis/govern-internal-docs buildwrangler pages deploy packages/govern-internal-docs/dist --project-name govern-internal-docsAPI to Cloudflare Workers
cd packages/api-gateway && wrangler deployInternal engineering notes
API gateway
- Durable Objects:
COORDINATOR(WebSocket hub),AUTONOMY_KERNEL(60s heartbeat) - Route registration pattern: all routes are factory functions in
src/routes/, mounted insrc/app.ts - Auth middleware: Bearer token checked against
AUTH_SECRETenv var - Assessment pipeline:
src/lib/assessment-engine.ts→ policy evaluator → scorer chain → verdict
Docs sites (Astro/Starlight)
- All four docs sites share the same CSS variables and Starlight theme (GOVERN brand)
- Custom CSS is in
src/styles/custom.css— copy fromgovern-developer-docsas the source of truth - Content is in
src/content/docs/as Markdown files - Starlight handles routing automatically from the filesystem hierarchy
Monitoring agent
- Agent polls the GOVERN API every 30 seconds to report discoveries and heartbeat
- Discovery scan runs every 5 minutes (configurable via
GOVERN_SCAN_INTERVALenv var) - Agent state (last scan, discovery cache) is stored in a local SQLite database inside the container
Database schema
- Primary schema migrations:
packages/db/supabase/migrations/ - GOVERN-specific migrations: files prefixed
20260410*and20260410060* - Assessment data is partitioned by month for performance at scale
- pgvector is used for semantic search on audit records and policy matching
Known technical debt
- Go SDK is in progress — TypeScript and Python SDKs are the primary integration path
- Probe container does not yet support HTTPS mutual TLS (planned for v1.1)
- Drift detection L3 is partially implemented — distribution comparison works, cross-session correlation is not yet live