gastownhall/gascity v0.15.0-rc1 on GitHub

Highlights

v0.15.0-rc1 is the PackV2 / Track 1 release candidate.

This release is centered on a new package model and better configuration structure for Gas City: named imports, convention-based pack layout, and the migration tooling needed to move real cities forward.

If you maintain a city or pack, start with the migration guide:

Migrating to PackV2

If you are using an agent to do the upgrade work, point it at that guide first. It is the shortest path to understanding what changed, what breaks if you stay on the old layout, and what you need to rewrite to keep your setup running.

Upgrade Notes

Older 0.14.x cities and packs should expect migration work. This rollout moves Gas City away from the old "everything in city.toml" model and toward PackV2 conventions.
The intended operator flow is:
- gc doctor
- gc doctor --fix
- gc doctor
Portable pack/city definition now belongs in pack.toml plus pack-owned directories. city.toml should increasingly hold deployment and site-binding state.
Include-based composition should move to named imports:
- city-wide composition in [imports.<name>] in pack.toml
- rig-specific composition in [rigs.imports.<name>] in city.toml
Inline agent definitions should move into convention-based directories such as:
- agents/<name>/prompt.template.md
- agents/<name>/agent.toml
- agents/<name>/overlay/
Pack-owned artifacts should move to canonical locations such as:
- formulas/<name>.toml
- orders/<name>.toml
- commands/<name>/command.toml
- doctor/<name>/doctor.toml
- top-level template-fragments/
Skills/MCP-oriented pack surfaces are planned follow-on work, but they are not shipping in this release.
Gastown should continue using includes rather than imports for now while that migration path is finished.

PackV2 and Extensibility

Added the mainline schema 2 / PackV2 loader with convention-based discovery for agents, commands, doctor checks, orders, overlays, and template fragments.
Added named imports and rig-scoped composition so packs are composed by stable bindings instead of textual include expansion.
Added the core PackV2 CLI and migration surfaces:
- gc import ...
- gc migrate ...
- gc doctor / gc doctor --fix
- gc commands
Removed formula/order filename infixes from the canonical layout and pushed the codebase toward a flatter, more predictable pack structure.
Migrated example packs, embedded packs, and public docs to the new layout so the docs now match the loader users are running.
This release lays groundwork for future Skills and MCP support, but does not ship first-class runtime support for them yet.

Runtime and Operator Improvements

Fixed a class of workflow control reconciliation stalls so control beads do not get stuck pending forever.
Fixed gc session logs for churned or asleep sessions by resolving transcripts through the transcript manager instead of assuming the stored session key still maps 1:1 to a file.
Added gc register --name and preserved workspace names during registration.
Fixed gc session attach resume command generation so default args and --settings survive resume paths.
Synced newer Agent fields across patch, override, and pool code paths, and tightened provider readiness and attachment filtering behavior.
Restored the legacy formula aliases needed for bd compatibility while the PackV2 rollout finishes.

Reliability and Release Quality

Tightened tutorial environment isolation so tutorial and acceptance coverage stop depending on contaminated shared state.
Stabilized managed Dolt init and recovery behavior in tests.
Parallelized and sharded integration coverage to keep CI runtime within budget.
Added docs and Mint navigation for the migration path so the public customer journey is explicit and testable.
Hardened several pre-existing test and lint blockers that were obscuring PackV2 rollout signal on main.

New Contributors

@donbox made their first contribution in #516
@mk-imagine made their first contribution in #658
@nikrich made their first contribution in #557

Full Changelog: v0.14.0...v0.15.0-rc1