toki
e2bc7aa8b6
Gito를 platformless Git control plane으로 시작할 수 있도록 Go core, Flutter control surface, contracts, ops 규칙, 검증 헬퍼를 함께 구성한다.
59 lines
1.6 KiB
Markdown
59 lines
1.6 KiB
Markdown
# 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.
|
|
|