Documentation Index
Fetch the complete documentation index at: https://docs.gascityhall.com/llms.txt
Use this file to discover all available pages before exploring further.
Top-Level Layout
| Path | What it contains |
|---|---|
cmd/gc/ | CLI entrypoints, controller wiring, runtime assembly, and command handlers |
internal/runtime/ | Runtime provider abstraction plus tmux, subprocess, exec, ACP, K8s, and hybrid implementations |
internal/config/ | city.toml schema, validation, composition, packs, patches, and override resolution |
internal/beads/ | Store abstraction and provider implementations used for work, mail, molecules, and waits |
internal/session/ | Session bead metadata, wait lifecycle helpers, and session identity utilities |
internal/orders/ | Order parsing and scanning for periodic dispatch |
internal/convergence/ | Bounded iterative refinement loops and gate handling |
internal/api/ | HTTP API handlers and resource views |
docs/ | Mintlify docs site (tutorials, guides, reference) |
engdocs/ | Contributor-facing architecture, design docs, proposals, and archive |
examples/ | Example cities, packs, formulas, and reference topologies |
contrib/ | Helper scripts, Dockerfiles, and integration support assets |
test/ | Integration and support test packages |
Where to Start
- CLI behavior: start in
cmd/gc/, then follow the command-specific helper it calls. - Runtime/provider work: start in
internal/runtime/runtime.goand the provider package you are changing. - Config and pack behavior: start in
internal/config/config.go,internal/config/compose.go, andinternal/config/pack.go. - Work routing and molecule creation: start in
cmd/gc/cmd_sling.goandinternal/beads/. - Supervisor, sessions, and wake/sleep behavior: start in
cmd/gc/,internal/session/, andinternal/runtime/.
engdocs/contributors/codebase-map).