How bharathraajnagarajan/governed-agent-exec works
GAX is a governed, durable incident-remediation system for a simulated streaming platform. An incident enters through the CLI and a Temporal workflow: runbook retrieval informs a Claude proposal, deterministic policy allows, denies, or requests approval, and approved actions are snapshotted, executed against fleet-api, verified, and audited. A separate durable ingestion workflow indexes runbooks for retrieval. The graph preserves the documented Keycard and LOCAL-ONLY credential modes and Voyage/MongoDB retrieval capabilities. Workflow relationships follow the README; source excerpts and the SOURCE INDEX support implementation-level links, while unsampled internals are not inferred.
Main entry points: activities.py Remediation activities · workflows.py Temporal workflows · ingest.py Ingest activities · search.py Context search
Components 19
Workflow orchestration
- CLI
src/gax/cli.py - Temporal workflows
src/gax/workflows.py - Worker runtime
src/gax/worker.py
Remediation domain
- Workflow types
src/gax/remediation/types.py - Remediation activities
src/gax/remediation/activities.py - Domain models
src/gax/models.py - Deterministic policy
src/gax/policy/rules.py - Credential brokers
src/gax/credentials
Runbook retrieval
- Ingest activities
src/gax/retrieval/ingest.py - Corpus chunking
src/gax/retrieval/chunking.py - Context search
src/gax/retrieval/search.py - Retrieval store
src/gax/retrieval/store.py
External systems
- Fleet API
fleet_api/app.py - MongoDB
- Voyage AI
- Claude
- Temporal
- Keycard
Other components
- Operator
Connections 27
- Operator → CLI: starts incident
README.md - CLI → Temporal workflows: starts workflow
README.md - Temporal workflows → Temporal: runs durably
README.md - Worker runtime → Temporal: registers workflows
src/gax/worker.py - Worker runtime → Remediation activities: registers activities
src/gax/worker.py - Temporal workflows → Remediation activities: dispatches steps
README.md - Temporal workflows → Workflow types: uses inputs
src/gax/workflows.py - Remediation activities → Domain models: validates proposals
src/gax/remediation/activities.py - Remediation activities → Deterministic policy: evaluates proposal
src/gax/remediation/activities.py - Remediation activities → Credential brokers: mints credentials
README.md - Remediation activities → Fleet API: reads and mutates
src/gax/remediation/activities.py - Fleet API → MongoDB: stores fleet state
README.md - Remediation activities → MongoDB: records ledger
README.md - Remediation activities → MongoDB: writes audit
src/gax/remediation/activities.py - Temporal workflows → Context search: requests context
README.md - Remediation activities → Context search: calls search
src/gax/worker.py - Context search → Retrieval store: queries vectors
src/gax/retrieval/search.py - Retrieval store → MongoDB: reads and writes
src/gax/retrieval/store.py - Context search → Voyage AI: embeds and reranks
README.md - Remediation activities → Claude: requests proposal
README.md - Worker runtime → Ingest activities: registers ingestion
src/gax/worker.py - Temporal workflows → Ingest activities: dispatches ingestion
src/gax/workflows.py - Ingest activities → Corpus chunking: loads and batches
src/gax/retrieval/ingest.py - Ingest activities → Retrieval store: indexes chunks
src/gax/retrieval/ingest.py - Ingest activities → Voyage AI: embeds batches
README.md - Credential brokers → Keycard: mints tokens
README.md - Fleet API → Keycard: verifies JWKS
README.md