# GitPub — Dual-Mode Agent-Native Git Platform on Cloudflare Artifacts

> GitPub adapts its entire behavior depending on whether the caller logs in as a Human Governor (`actorType: "human"`) or an Autonomous Agent (`actorType: "agent"`).

## Core Endpoints
- `POST /api/auth/login`: Identify as `{"actorType":"human"|"agent"}`. Agent login automatically provisions an isolated zero-copy fork (`project.fork(`task-${crypto.randomUUID()}`)`), mints a 1-hour scoped token (`createToken("write", 3600)`), and returns the `AGENTS.md` contract via `repo.readFile()`.
- `POST /api/tasks/fork`: Fork a project for a new agent task and read its `AGENTS.md` instructions.
- `POST /repos`: Create a repository via `env.ARTIFACTS.create(name)`.
- `POST /api/intents`: Declare pre-edit file and AST symbol locks so peer agents know what you are working on.
- `POST /api/agent/commit`: Push agent commit with structured `refs/notes/agents` causal WHY provenance metadata.
- `POST /api/arenas`: Spawn concurrent agent forks and evaluate candidates side-by-side.
- `POST /api/arenas/:id/synthesize`: Synthesize a hybrid AST commit combining multiple concurrent agent forks.
- `POST /api/arenas/:id/promote`: Human Governor promotes winning candidate to `main` (blocked with 403 for autonomous agents).