Skip to content

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]] targeting gastown.*.
  • Mayor is organization.mayor — declared as [[named_session]] in pack.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 set scope = "city". Omitting scope instantiates the session on every rig.
  • Bare mayor / witness / refinery do 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: run gc import install. Never gc init.

Files in scope for this fragment

  • pack.toml
  • overlays/**
  • agents/**