GoatGit / ABH

# ABH — Agentic Business Harness
English | 简体中文
ABH is a runtime harness for AI agents that do real work in a business. An agent answering questions can rely on itself; the moment it spends money, calls external services, or acts on someone's behalf, the business needs to know who authorized it, what it is allowed to do, what it actually did, and how to recover when something breaks halfway. ABH wires those answers into the runtime itself, and stays domain-neutral so any line of business can build on it.
The repo is a pnpm workspace monorepo: a contract layer, a core engine, adapters for HTTP ingress / queues / the Pi Agent runtime, a CLI, and an optional admin console.
> **Status: 0.1.0 preview.** The local engineering loop is roughly 90% done — contracts, types, tests and builds pass end to end. Still missing: production hosting, a real identity provider, and an independent security review. The itemized state lives in the gap list (Chinese).
## What it does
- **Contract-first.** The public API, state machines, error model and ports are declared once in a registry. TypeScript types, validators, an OpenAPI 3.1 document and SQL constraints are generated from it, and CI fails on drift.
- **Authorization on every command.** Grant, purpose, tenant scope and version fence are re-checked inside each database transaction. No rights, no execution.
- **Full lifecycle.** Missions run create → activate → pause/resume → close. Runs form a task graph with idempotency receipts and recovery. Capability packs move through staged → enabled → suspended → retired, with signature verification on the way in.
- **Humans in the loop.** Decision approvals, corrections, exceptions and safety stops all land in an immutable audit trail.
- **A swappable agent runtime.** Core has no dependency on any agent framework. The Pi adapter keeps model and tool calls inside injected gateways; other runtimes can plug in through the same ports.
- **Domain-neutral core.** Business logic lives in packs, not in the engine. The marketing domain is developed separately in lime-ads.
## Packages
| Package | Role |
| --- | --- |
| `@abh/contracts` | Generated contracts: schemas, states, errors, HTTP protocol, ports |
| `@abh/core` | The engine: missions, runs, the authorization chain, ledger, durable execution |
| `@abh/adapter-pi` | Pi Agent runtime adapter — models and tools forced through gateways |
| `@abh/adapter-fastify` | HTTP ingress adapter |
| `@abh/adapter-pg-boss` | Queue delivery on PostgreSQL (pg-boss) |
| `@abh/cli` | The `abh` command line |
| `@abh/workbench` | Optional Next.js admin console |
## Getting started
You need Node.js 24 (pinned in `.nvmrc`), pnpm 10.28 through corepack, and Docker if you want to run the integration tests.
 [code] 
`pnpm check` is the whole gate: contract regeneration with drift check, type checks, the test suite (a thousand-plus tests against a real PostgreSQL 16 managed by Testcontainers), builds, and the public API report. Contract generation run