Skip to content

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

#SurfacePackageStatusDeploy target
1GOVERN Dashboardgovern-dashboardLivegovern-dashboard.pages.dev
2GOVERN Appgovern-appLivegovern-app.pages.dev
3GOVERN Admingovern-adminLivegovern-admin.pages.dev
4GOVERN Customergovern-customerLivegovern-customer.pages.dev
5GOVERN APIapi-gatewayLiveCF Worker — jarvis-api-gateway.ben-c1f.workers.dev
6GOVERN ProbeDocker imageLivearchetypal/govern-probe:latest
7SDK TypeScriptnpmLive@archetypal-ai/govern
8SDK PythonPyPILivearchetypal-govern
9SDK GoGo moduleIn progressgithub.com/archetypal-ai/govern-go
10GOVERN CLInpmLive@archetypal-ai/govern-cli
11GOVERN Docsgovern-docsLivegovern-docs.pages.dev
12Developer Docsgovern-developer-docsLivegovern-developer-docs.pages.dev
13Admin Docsgovern-admin-docsLivegovern-admin-docs.pages.dev
14Internal Docsgovern-internal-docsLiveInternal only
15GitHub Actiongovern-action repoLivearchetypal-ai/govern-action@v1
16Monitoring AgentDocker imageLivearchetypal/govern-agent:latest
17API SpecOpenAPI 3.1Livedocs/products/govern-api-spec.md

Build commands — all surfaces

Web applications

expressiveCode.terminalWindowFallbackTitle
# Build all web apps
pnpm --filter @jarvis/govern-dashboard build
pnpm --filter @jarvis/govern-app build
pnpm --filter @jarvis/govern-admin build
pnpm --filter @jarvis/govern-customer build

Documentation sites

expressiveCode.terminalWindowFallbackTitle
# Build all docs sites
pnpm --filter @jarvis/govern-docs build
pnpm --filter @jarvis/govern-developer-docs build
pnpm --filter @jarvis/govern-admin-docs build
pnpm --filter @jarvis/govern-internal-docs build

API gateway

expressiveCode.terminalWindowFallbackTitle
cd packages/api-gateway
pnpm typecheck && pnpm test && pnpm deploy

Container images (Docker)

expressiveCode.terminalWindowFallbackTitle
# Build Probe image
docker build -t archetypal/govern-probe:latest packages/govern-probe/
# Build Agent image
docker build -t archetypal/govern-agent:latest packages/govern-agent/
# Push to registry
docker push archetypal/govern-probe:latest
docker push archetypal/govern-agent:latest

Deploy commands — all surfaces

Web apps to Cloudflare Pages

expressiveCode.terminalWindowFallbackTitle
# Dashboard
pnpm --filter @jarvis/govern-dashboard build
wrangler pages deploy packages/govern-dashboard/dist --project-name govern-dashboard
# App
pnpm --filter @jarvis/govern-app build
wrangler pages deploy packages/govern-app/dist --project-name govern-app
# Admin
pnpm --filter @jarvis/govern-admin build
wrangler pages deploy packages/govern-admin/dist --project-name govern-admin
# Customer
pnpm --filter @jarvis/govern-customer build
wrangler pages deploy packages/govern-customer/dist --project-name govern-customer

Docs sites to Cloudflare Pages

expressiveCode.terminalWindowFallbackTitle
pnpm --filter @jarvis/govern-docs build
wrangler pages deploy packages/govern-docs/dist --project-name govern-docs
pnpm --filter @jarvis/govern-developer-docs build
wrangler pages deploy packages/govern-developer-docs/dist --project-name govern-developer-docs
pnpm --filter @jarvis/govern-admin-docs build
wrangler pages deploy packages/govern-admin-docs/dist --project-name govern-admin-docs
# Internal docs: deploy only to internal Pages project
pnpm --filter @jarvis/govern-internal-docs build
wrangler pages deploy packages/govern-internal-docs/dist --project-name govern-internal-docs

API to Cloudflare Workers

expressiveCode.terminalWindowFallbackTitle
cd packages/api-gateway && wrangler deploy

Internal 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 in src/app.ts
  • Auth middleware: Bearer token checked against AUTH_SECRET env 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 from govern-developer-docs as 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_INTERVAL env 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* and 20260410060*
  • 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