https://github.com/terrene-foundation/pact
PACT Platform — governed AI operations with D/T/R accountability, operating envelopes, and verification gradient (Apache 2.0)
https://github.com/terrene-foundation/pact
ai-agents governance pact terrene-foundation trust
Last synced: 2 months ago
JSON representation
PACT Platform — governed AI operations with D/T/R accountability, operating envelopes, and verification gradient (Apache 2.0)
- Host: GitHub
- URL: https://github.com/terrene-foundation/pact
- Owner: terrene-foundation
- License: apache-2.0
- Created: 2026-03-13T04:18:21.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-02T05:29:40.000Z (2 months ago)
- Last Synced: 2026-04-02T18:53:28.628Z (2 months ago)
- Topics: ai-agents, governance, pact, terrene-foundation, trust
- Language: Python
- Size: 45.5 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# PACT Platform
[](https://opensource.org/licenses/Apache-2.0)
[](https://www.python.org/downloads/)
[]()
**Human judgment surface for governed AI operations.**
PACT Platform is a Layer 3 application built on kailash-pact governance primitives and kaizen-agents autonomous execution. It provides the org definition, approval UX, work management, dashboard, and deployment that turn governance rules into an operational system.
> **Not a generic agent orchestrator.** Every agent action passes through a governance pipeline -- D/T/R accountability, operating envelopes, knowledge clearance, and verification gradient -- before execution.
---
## Quick Start
```bash
pip install pact-platform[all]
pact quickstart --example university
```
This loads the university demo org, registers 3 agents, seeds sample data, and starts the API server at `http://localhost:8000`.
### What you'll see:
- **Dashboard** at `http://localhost:3000` -- objectives, requests, approvals, cost tracking
- **1 HELD action** in the approval queue (researcher needs CONFIDENTIAL clearance)
- **$0.10 total cost** across 3 demo agent runs
- **API** at `http://localhost:8000/docs` -- 42+ endpoints
---
## Architecture
```
┌─────────────────────────────────────────────────────┐
│ L3: pact-platform (this package) │
│ ┌────────┐ ┌────────┐ ┌─────┐ ┌──────────────┐ │
│ │ Models │ │ API │ │ CLI │ │ Integrations │ │
│ │ (11) │ │ (42+) │ │ │ │ Slack/Teams │ │
│ └────────┘ └────────┘ └─────┘ └──────────────┘ │
│ ┌─────────────────────────────────────────────┐ │
│ │ Engine: Envelope Adapter, Governed Delegate, │ │
│ │ Approval Bridge, Supervisor Orchestrator │ │
│ └─────────────────────────────────────────────┘ │
├─────────────────────────────────────────────────────┤
│ L2: kaizen-agents (GovernedSupervisor) │
├─────────────────────────────────────────────────────┤
│ L1: kailash-pact (GovernanceEngine, D/T/R grammar) │
│ L1: kailash[trust] (EATP SDK, trust chains) │
│ L1: kailash-dataflow (auto-generated CRUD nodes) │
├─────────────────────────────────────────────────────┤
│ L0: Kailash Core SDK (workflow runtime, 140+ nodes) │
└─────────────────────────────────────────────────────┘
```
## Key Concepts
| Concept | What it means |
| ------------------------- | ----------------------------------------------------------------------------------------- |
| **D/T/R Grammar** | Department → Team → Role. Every address resolves to exactly one governance envelope. |
| **Operating Envelope** | Five constraint dimensions: Financial, Operational, Temporal, Data Access, Communication. |
| **Knowledge Clearance** | Five levels: PUBLIC → RESTRICTED → CONFIDENTIAL → SECRET → TOP_SECRET. |
| **Verification Gradient** | Four zones: AUTO_APPROVED → FLAGGED → HELD → BLOCKED. |
| **GovernedSupervisor** | Autonomous agent execution within governance constraints. |
## CLI Reference
```bash
pact quickstart --example university # Demo with seeded data
pact org create my-org.yaml # Load org from YAML
pact org list # List compiled orgs
pact role assign D1-T1-R1 agent-001 # Assign agent to role
pact clearance grant D1-T1-R1 CONFIDENTIAL # Grant clearance
pact bridge create D1-R1 D2-R1 # Cross-functional bridge
pact envelope show D1-T1-R1 # Show effective envelope
pact agent register agent-001 D1-T1-R1 # Register agent
pact audit export --format json # Export audit trail
```
## API Endpoints
| Group | Prefix | Endpoints |
| ---------- | -------------------------- | ----------------------------------------------------- |
| Objectives | `/api/v1/objectives` | create, list, detail, update, cancel, requests, cost |
| Requests | `/api/v1/requests` | submit, list, detail, cancel, sessions, artifacts |
| Sessions | `/api/v1/sessions` | list, detail, pause, resume |
| Decisions | `/api/v1/decisions` | list, detail, approve, reject, stats |
| Pools | `/api/v1/pools` | create, list, detail, add/remove members, capacity |
| Reviews | `/api/v1/reviews` | list, detail, add finding, finalize |
| Metrics | `/api/v1/platform/metrics` | cost, throughput, governance, budget |
| Governance | `/api/v1/` | teams, agents, envelopes, trust-chains, bridges, etc. |
## Docker Deployment
```bash
docker compose up
```
Services:
- **api** — FastAPI server (port 8000)
- **web** — Next.js dashboard (port 3000)
## Development
```bash
git clone https://github.com/terrene-foundation/pact.git
cd pact
pip install -e ".[all,dev]"
pytest # 1838 tests
```
## License
Apache 2.0 — Terrene Foundation (Singapore CLG). Fully independent, irrevocably open.
## The Quartet
| Standard | Purpose | License |
| -------- | ---------------------------------------------------- | --------- |
| **CARE** | Governance philosophy (Dual Plane Model) | CC BY 4.0 |
| **PACT** | Architecture (D/T/R, envelopes, clearance, gradient) | CC BY 4.0 |
| **EATP** | Protocol (trust chains, delegation, verification) | CC BY 4.0 |
| **CO** | Methodology (human-AI collaboration) | CC BY 4.0 |