Skip to content

Upstreams (gastownhall): reference only, do not hack

Read reference/gastownhall-upstreams.md and the manifest upstreams/upstreams.yaml.

Gas City vs Gas Town (say it crisply): Gas Town is the original multi-agent app (gt); Gas City is the reusable SDK/runtime extracted from it (gc, primitive-first: city/pack/formula/order/agent/bead). Bluefly composes Gas City, learns from Gas Town, ports neither, as the Constitution requires.

Commands:

scripts/upstreams.sh list           # every repo + role + Constitution domain
scripts/upstreams.sh sync [DIR]      # clone/pull the read-only mirror (default ~/Sites/blueflyio/UPstreams-DO-NOT-HACK/gastownhall)
scripts/upstreams.sh status [DIR]    # latest tag/commit per repo
scripts/upstreams.sh latest <name>   # latest release tag for one repo

Rules: these are read-only learning sources: never edit a clone, never depend on a fork, never rebuild a Gas City capability (scheduler/supervisor/formula engine). Install runtime from upstream (brew install gastownhall/gascity/gascity, brew install beads, gascity-otel via docker compose). When asked "where does X belong," map it to a Constitution domain via the manifest's constitution_domain, and route any actual install/sync as a Bash step.