# google/cybernetic-agent-governance-engine architecture

> Architecture diagram of the GitHub repository google/cybernetic-agent-governance-engine, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/google/cybernetic-agent-governance-engine
- Repository: https://github.com/google/cybernetic-agent-governance-engine

## Overview

CAGE is a domain-agnostic runtime governance platform: requests enter through the gateway, are evaluated by the governance runtime and its safety mechanisms, then receive a decision that can gate execution, defer for human review, and produce sealed evidence. Domain plugins and regional postures extend the kernel; the compliance bridge exposes audit and evidence workflows. The financial advisor is an illustrative application, not part of the core. Some links below follow README-level descriptions because their implementation was not sampled.

Main entry points: [`src/gateway/governance/governor/pipeline.py`](https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/governor/pipeline.py) (Stage pipeline), [`src/gateway/server/governance_middleware.py`](https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/server/governance_middleware.py) (Governance middleware), [`src/gateway/governance/governor/governor.py`](https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/governor/governor.py) (Governor runtime), [`src/gateway/server/hybrid_server.py`](https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/server/hybrid_server.py) (Gateway server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingress["Gateway ingress"]
  node_gateway["Gateway server<br/>[hybrid_server.py]"]
  node_middleware["Governance middleware"]
end

subgraph group_kernel["Governance kernel"]
  node_governor["Governor runtime<br/>[governor.py]"]
  node_pipeline["Stage pipeline<br/>[pipeline.py]"]
  node_contracts["Action contracts<br/>[contracts.py]"]
  node_verdicts["Decision verdicts<br/>[verdicts.py]"]
  node_safety["Safety mechanisms<br/>[cbf_engine.py]"]
  node_consensus["Consensus arbitration<br/>[engine.py]"]
  node_defer["Deferred review<br/>[defer_queue.py]"]
  node_sealing["Routing seal<br/>[routing_seal.py]"]
end

subgraph group_extensions["Policies and extensions"]
  node_plugins["Domain plugins<br/>[plugin.py]"]
  node_posture["Regional posture<br/>[env_posture.py]"]
end

subgraph group_evidence["Evidence and compliance"]
  node_evidence[("Evidence stream<br/>[stream.py]")]
  node_coldstore[("Evidence cold store<br/>[cold_store.py]")]
  node_compliance["Compliance bridge<br/>[main.py]"]
  node_audit["Audit workflow<br/>[audit_workflow.py]"]
end

subgraph group_examples["Reference application"]
  node_advisor["Financial advisor<br/>[server.py]"]
  node_advisor_graph["Advisor graph<br/>[graph.py]"]
end

node_client(("Agent caller"))

node_client -->|"submits request"| node_gateway
node_gateway -->|"routes through"| node_middleware
node_middleware -->|"enforces governance"| node_governor
node_governor -->|"orchestrates stages"| node_pipeline
node_pipeline -->|"evaluates actions"| node_contracts
node_governor -->|"routes decisions"| node_verdicts
node_pipeline -.->|"checks safety"| node_safety
node_pipeline -.->|"arbitrates actions"| node_consensus
node_verdicts -->|"defers review"| node_defer
node_middleware -->|"seals evidence"| node_sealing
node_middleware -->|"records refusal proof"| node_evidence
node_evidence -.->|"archives evidence"| node_coldstore
node_pipeline -->|"loads domain tiers"| node_plugins
node_governor -->|"selects posture"| node_posture
node_compliance -->|"serves audit workflow"| node_audit
node_advisor -->|"invokes graph"| node_advisor_graph

click node_gateway "https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/server/hybrid_server.py"
click node_middleware "https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/server/governance_middleware.py"
click node_governor "https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/governor/governor.py"
click node_pipeline "https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/governor/pipeline.py"
click node_contracts "https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/contracts.py"
click node_verdicts "https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/governor/verdicts.py"
click node_safety "https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/safety/cbf_engine.py"
click node_consensus "https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/consensus/engine.py"
click node_defer "https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/defer_queue.py"
click node_sealing "https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/routing_seal.py"
click node_plugins "https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/cage_finance/plugin.py"
click node_posture "https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/env_posture.py"
click node_evidence "https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/evidence/stream.py"
click node_coldstore "https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/evidence/cold_store.py"
click node_compliance "https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/compliance_bridge/main.py"
click node_audit "https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/compliance_bridge/audit_workflow.py"
click node_advisor "https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/governed_financial_advisor/server.py"
click node_advisor_graph "https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/governed_financial_advisor/graph/graph.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gateway,node_middleware toneBlue
class node_governor,node_pipeline,node_contracts,node_verdicts,node_safety,node_consensus,node_defer,node_sealing toneAmber
class node_plugins,node_posture toneMint
class node_evidence,node_coldstore,node_compliance,node_audit toneRose
class node_advisor,node_advisor_graph,node_client toneIndigo
```

## Components

### Gateway ingress

- [Gateway server](https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/server/hybrid_server.py): `src/gateway/server/hybrid_server.py`
- [Governance middleware](https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/server/governance_middleware.py): `src/gateway/server/governance_middleware.py`

### Governance kernel

- [Governor runtime](https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/governor/governor.py): `src/gateway/governance/governor/governor.py`
- [Stage pipeline](https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/governor/pipeline.py): `src/gateway/governance/governor/pipeline.py`
- [Action contracts](https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/contracts.py): `src/gateway/governance/contracts.py`
- [Decision verdicts](https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/governor/verdicts.py): `src/gateway/governance/governor/verdicts.py`
- [Safety mechanisms](https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/safety/cbf_engine.py): `src/gateway/governance/safety/cbf_engine.py`
- [Consensus arbitration](https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/consensus/engine.py): `src/gateway/governance/consensus/engine.py`
- [Deferred review](https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/defer_queue.py): `src/gateway/governance/defer_queue.py`
- [Routing seal](https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/routing_seal.py): `src/gateway/governance/routing_seal.py`

### Policies and extensions

- [Domain plugins](https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/cage_finance/plugin.py): `src/cage_finance/plugin.py`
- [Regional posture](https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/env_posture.py): `src/gateway/governance/env_posture.py`

### Evidence and compliance

- [Evidence stream](https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/evidence/stream.py): `src/gateway/governance/evidence/stream.py`
- [Evidence cold store](https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/gateway/governance/evidence/cold_store.py): `src/gateway/governance/evidence/cold_store.py`
- [Compliance bridge](https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/compliance_bridge/main.py): `src/compliance_bridge/main.py`
- [Audit workflow](https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/compliance_bridge/audit_workflow.py): `src/compliance_bridge/audit_workflow.py`

### Reference application

- [Financial advisor](https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/governed_financial_advisor/server.py): `src/governed_financial_advisor/server.py`
- [Advisor graph](https://github.com/google/cybernetic-agent-governance-engine/blob/main/src/governed_financial_advisor/graph/graph.py): `src/governed_financial_advisor/graph/graph.py`

### Other components

- **Agent caller**

## Connections

- Agent caller → Gateway server: submits request (evidence: `README.md`)
- Gateway server → Governance middleware: routes through (evidence: `README.md`)
- Governance middleware → Governor runtime: enforces governance (evidence: `README.md`)
- Governor runtime → Stage pipeline: orchestrates stages (evidence: `README.md`)
- Stage pipeline → Action contracts: evaluates actions (evidence: `src/gateway/governance/governor/pipeline.py`)
- Governor runtime → Decision verdicts: routes decisions (evidence: `README.md`)
- Stage pipeline → Safety mechanisms: checks safety
- Stage pipeline → Consensus arbitration: arbitrates actions
- Decision verdicts → Deferred review: defers review (evidence: `README.md`)
- Governance middleware → Routing seal: seals evidence (evidence: `README.md`)
- Governance middleware → Evidence stream: records refusal proof (evidence: `README.md`)
- Evidence stream → Evidence cold store: archives evidence
- Stage pipeline → Domain plugins: loads domain tiers (evidence: `README.md`)
- Governor runtime → Regional posture: selects posture (evidence: `README.md`)
- Compliance bridge → Audit workflow: serves audit workflow (evidence: `src/compliance_bridge/main.py`)
- Financial advisor → Advisor graph: invokes graph (evidence: `src/governed_financial_advisor/server.py`)
