History

Dhruv Sharma d623ab28b7 docs: document backend code structure (#41 )		2026-06-04 02:32:18 +05:30
..
agent	Add agent adapters and wire per-session agents into the session manager (#65 )	2026-06-02 16:51:32 +05:30
cli	refactor: simplify session lifecycle and zellij runtime (#62 )	2026-06-01 08:42:49 +05:30
README.md	docs: document backend code structure (#41 )	2026-06-04 02:32:18 +05:30
architecture.md	refactor: move session status assembly to service (#62 ) (#67 )	2026-06-01 23:31:21 +05:30
backend-code-structure.md	docs: document backend code structure (#41 )	2026-06-04 02:32:18 +05:30
stack.md	docs: document AO technical stack (#25 )	2026-06-04 02:24:19 +05:30
status.md	refactor: move session status assembly to service (#62 ) (#67 )	2026-06-01 23:31:21 +05:30

README.md

agent-orchestrator rewrite docs

The agent-orchestrator is being rebuilt as a long-running Go backend daemon
(backend/) plus an Electron + TypeScript frontend (frontend/). The backend
supervises coding-agent sessions and exposes daemon control, project/session
state, terminal streaming, and CDC/event infrastructure.

Start with architecture.md for the current backend model and
cli/README.md for the CLI surface.

Reference docs

Doc	What it covers
architecture.md	Current backend model, package layout, status derivation, persistence/CDC, and load-bearing rules.
backend-code-structure.md	Package ownership rules for the Go backend: domain, services, ports, adapters, storage, HTTP, CLI, and daemon wiring.
cli/README.md	CLI commands and daemon control surface.
status.md	Current implementation shape, build/test command, and next integration work.
stack.md	Accepted library/runtime choices, pending stack decisions, and dependencies explicitly avoided for V1.

Mental model

Persist durable facts, derive display status:

session table: activity_state, is_terminated, identity, metadata
PR tables: PR/CI/review facts
derived read model: service.Session computes display status from session + PR facts