PACK OVERLAYS AND NAMED SESSIONS¶
Official spec: pack-spec
Current configuration (BluCity)¶
[imports.gastown]is REMOVED (2026-09-16). Do not re-add. Do not add[[patches.agent]]targetinggastown.*.- Mayor is
organization.mayor— declared as[[named_session]]inpack.toml, not via a patch. - BLU session:
[[named_session]] template = "kingstown-core.blu" - Harbormaster session:
[[named_session]] template = "organization.harbormaster"
Rules¶
- Do not put imports in
[defaults.rig.imports.*]— that applies the import to every rig (cartesian expansion: every pack × every rig × every agent). [[named_session]]for Mayor, BLU, and Harbormaster must setscope = "city". Omitting scope instantiates the session on every rig.- Bare
mayor/witness/refinerydo not match after expansion — use the fully-qualified pack name (organization.mayor,kingstown-core.blu). - Do not duplicate pack-composed agents under
agents/. - After changing
pack.toml: rungc import install. Nevergc init.
Files in scope for this fragment¶
pack.tomloverlays/**agents/**