# Gito

Gito is a platformless Git control plane for agent-driven development workflows.

It manages registered repositories, workspace leases, Git operations, agent-shell
execution, provider adapters, and normalized events. Git itself stays
platform-neutral; GitHub, GitLab, Gitea, Plane, Jira, and similar systems are
integrated through adapters.

## Direction

- Server: Go
- Control surface: Flutter app and `gitoctl` in future slices
- State: PostgreSQL as source of truth
- Event acceleration: Redis optional, not required for the first slice
- Internal transport: proto-socket first
- REST: health/readiness, smoke/curl, provider callbacks, simple admin bootstrap
- gRPC: intentionally excluded from the initial design

## Runtime Shape

```text
Flutter UI / gitoctl
        |
Control Plane
        |
Core Domain
        |
Worker / Scheduler
        |
Agent Shell / IOP / Git Engine
        |
Provider Adapters
```

## Repository Layout

```text
apps/client/          Flutter control surface scaffold
services/core/        Go control plane, worker, shell commands
packages/contracts/   proto-socket, REST, event, and provider contract notes
docs/                 Architecture and operation notes
bin/                  Root test/lint/build helpers
agent-ops/            Agent operating rules
agent-test/           Local validation rules
```

## First Commands

```sh
bin/test
bin/lint
bin/build
```

The initial Go scaffold is intentionally small but buildable. Flutter platform
directories are not generated yet; `apps/client` currently records the control
surface boundary and a minimal Dart entry point.