Internal Architecture & Design

Corral is engineered for deterministic execution without race conditions.

+-------------------+     +--------------------+     +---------------------+
| Corral.toml Ingest| --> | Tokio Async Pool   | --> | Git Engine Workers  |
| (Manifest Parser) |     | (Bounded Channels) |     | (Pipelined Cloner)  |
+-------------------+     +--------------------+     +---------------------+
  1. Manifest Ingestion: Validates the TOML workspace schema.
  2. Async Task Scheduler: Distributes repository clone/fetch jobs across a bounded worker queue.
  3. Execution Pipeline: Executes Git CLI operations using direct process spawning and piped stdio with zero runtime memory bloat.
Back to the top ↑