Architecture
Orbit is an event-driven service that converts repository changes into a continuously updated knowledge layer.
System overview
Orbit receives repository events, maps changed symbols and publishes one consistent documentation revision. Each generated statement remains connected to its source.
Runtime topology
| Service | Responsibility | State |
|---|---|---|
web | Workspace and API | Stateless |
worker | Analysis and generation | Queued |
database | Pages and revisions | Persistent |
Request lifecycle
A signed webhook records the target commit and queues an incremental job. Files with an unchanged blob SHA are skipped before any model call.
Only changed files and affected pages are regenerated, keeping every sync fast and reviewable.