pack.toml

# gc-toolkit — primary pack for a Gas City city. Native roster, no pack imports.
#
# Every agent this pack runs ships under agents/<name>/ (polecat, refinery,
# witness, deacon, converse, mechanik, polecat-codex, proactive, dog). There is
# no gastown import and there are no cross-pack prompt patches: each agent's
# prompt.template.md is purpose-written and injects shared doctrine from
# template-fragments/ directly.
#
# "No imports" scopes to PACK imports: this file declares no [imports.*] and
# no [rigs.imports.*]. Formula inheritance is a separate mechanism and is
# deliberate: formulas/mol-polecat-work.toml declares
# extends = ["mol-polecat-base"], which resolves through the formula search
# path to the core pack (specs/2026-08-rewrite/plan.md:62).
#
# OVERLAY WIRING. Claude-hook overlays (overlays/cycle-recycle,
# overlays/work-context) are staged into an agent's work dir via
# `overlay_dir`, which the pack format carries only on [[patches.agent]] —
# agent.toml has no overlay key. A patch modifies an EXISTING agent, and a
# pack may patch its own, so each stanza below targets one of our native
# agents and carries nothing but the overlay. Both hooks self-gate by role
# and are safe no-ops elsewhere.

[pack]
name = "gc-toolkit"
schema = 2

[global]
# Ordering is load-bearing: bindings first, then the status-line override,
# which rewrites status-right to gc-toolkit-status-line.sh (composable title
# and indicator slots) while preserving the tier theme and %H:%M time slot.
session_live = [
    "{{.ConfigDir}}/assets/scripts/tmux-bindings.sh {{.ConfigDir}}",
    "{{.ConfigDir}}/assets/scripts/tmux-status-line-override.sh {{.Session}} {{.Agent}} {{.ConfigDir}}",
]

# Deterministic work-bead description delivery: a Claude PostToolUse hook
# injects the claimed work bead's description right after the claim, so the
# spec reaches the worker even on a mid-workflow respawn (tk-osf13). Gates
# itself to claude-provider polecat pools.
[[patches.agent]]
name = "polecat"
overlay_dir = "overlays/work-context"

# Deterministic context recycle for the long-running patrol roles: a Claude
# Stop hook recycles the session past a 200K input-token threshold
# (docs/cycle-recycle.md). Gates itself to witness | deacon | refinery.
[[patches.agent]]
name = "refinery"
overlay_dir = "overlays/cycle-recycle"

[[patches.agent]]
name = "witness"
overlay_dir = "overlays/cycle-recycle"

[[patches.agent]]
name = "deacon"
overlay_dir = "overlays/cycle-recycle"

# Named singletons. The pool templates (polecat, polecat-codex, converse,
# proactive) need no stanza — instance expansion is their lifecycle.
[[named_session]]
template = "mechanik"
scope = "city"
mode = "always"

[[named_session]]
template = "refinery"
scope = "rig"
mode = "on_demand"

[[named_session]]
template = "witness"
scope = "rig"
mode = "always"

[[named_session]]
template = "deacon"
scope = "city"
mode = "always"