diff --git a/.beads/issues.jsonl b/.beads/issues.jsonl index ab7029db..6d5e8241 100644 --- a/.beads/issues.jsonl +++ b/.beads/issues.jsonl @@ -809,6 +809,28 @@ {"id":"gt-qscw","title":"Merge: gt-72so","description":"branch: polecat/Ace\ntarget: main\nsource_issue: gt-72so\nrig: gastown","status":"closed","priority":1,"issue_type":"merge-request","created_at":"2025-12-19T16:20:02.203335-08:00","updated_at":"2025-12-19T18:26:14.105337-08:00","closed_at":"2025-12-19T17:48:09.571107-08:00"} {"id":"gt-qsvq","title":"gt doctor: Detect and clean up orphaned sessions/processes","description":"## Problem\nOrphaned tmux sessions and Claude processes accumulate over time, consuming memory.\n\n## Discovered Orphans\n- gt-deacon: Idle Claude session, not part of any rig\n\n## Proposed Solution\n\n### gt doctor --check (default)\nDetect issues without fixing:\n- Orphan sessions (not matching rig/polecat/crew/witness/refinery/mayor pattern)\n- Claude processes without parent tmux session\n- Tmux sessions without Claude (stuck at bash prompt)\n- Polecats marked 'working' but session idle\n\n### gt doctor --fix\nClean up detected issues:\n- Kill orphan sessions\n- Kill orphan Claude processes\n- Optionally reset stuck polecat state\n\n### gt gc (alternative name)\nShort alias for cleanup operations.\n\n## Acceptance Criteria\n- [ ] Detects orphan sessions\n- [ ] Detects orphan processes\n- [ ] Safe cleanup (doesn't kill active work)\n- [ ] Reports what was cleaned","status":"closed","priority":1,"issue_type":"feature","created_at":"2025-12-20T01:06:39.046959-08:00","updated_at":"2025-12-20T07:54:51.210265-08:00","closed_at":"2025-12-20T07:54:51.210265-08:00"} {"id":"gt-qswb","title":"bd mol current: soft cursor showing current/next step","description":"Add bd mol current command for molecule navigation orientation.\n\n## Usage\n\nbd mol current [mol-id]\n\nIf mol-id given, show status for that molecule.\nIf not given, infer from in_progress issues assigned to current agent.\n\n## Output\n\nYou're working on molecule gt-abc (Feature X)\n\n [checkmark] gt-abc.1: Design\n [checkmark] gt-abc.2: Scaffold \n [checkmark] gt-abc.3: Implement\n [arrow] gt-abc.4: Write tests [in_progress] \u003c- YOU ARE HERE\n [circle] gt-abc.5: Documentation\n [circle] gt-abc.6: Exit decision\n\nProgress: 3/6 steps complete\n\n## Key behaviors\n- Shows full molecule structure with status indicators\n- Highlights current in_progress step\n- If no in_progress, highlights first ready step\n- Works without explicit cursor tracking (inferred from state)\n\n## Implementation notes\n- Query children of mol-id\n- Sort by dependency order\n- Find first in_progress or first ready\n- Format with status indicators\n\n## Beads feature\nThis is a bd command - needs implementation in beads repo.","status":"closed","priority":1,"issue_type":"feature","created_at":"2025-12-22T17:00:47.394852-08:00","updated_at":"2025-12-22T17:04:13.388865-08:00","closed_at":"2025-12-22T17:04:13.388865-08:00","close_reason":"Moved to beads: bd-sal9"} +{"id":"gt-qvn7","title":"Tracer Bullet: Single-Polecat Engine","description":"# Tracer Bullet: Single-Polecat Engine\n\nThe minimal viable Gas Town: one polecat, one issue, one complete cycle.\n\n## Vision\n\n```\nDeacon wakes → checks hook → spawns polecat → polecat works → polecat submits → loop\n```\n\nNo Witness automation. No Refinery automation. Just the core propulsion loop.\n\n## Key Insight: Molecules Are the Logic\n\nGo code is connector/glue. The cognition lives in molecules. When the Deacon\nwakes up, it reads its hook, finds a molecule, and WALKS IT. The molecule\nsays what to do. Go just provides the verbs (spawn, send, close).\n\n## The Propulsion Principle\n\n\u003e If you find something on your hook, YOU RUN IT.\n\nThis is the universal Gas Town rule. Every agent, every wake-up:\n1. Check hook\n2. If mol → execute it\n3. If nothing → wait for assignment\n\n## Critical Path\n\n1. **Slinging Handoff** - `gt sling \u003cbead\u003e` attaches work and restarts\n2. **Hook Execution** - Agent wakes, primes, reads hook, runs hook\n3. **Polecat Work Cycle** - Spawn → work → submit → complete\n4. **Deacon Patrol** - The loop that spawns polecats\n\n## Success Criteria\n\n- `gt sling gt-xxx` restarts agent with work attached\n- Agent wakes up and automatically begins work\n- Single polecat completes one issue end-to-end\n- Deacon can spawn polecats on demand\n\n## Non-Goals (v0.1)\n\n- Autonomous Witness nudging\n- Autonomous Refinery merging\n- Multi-polecat coordination\n- Self-healing from crashes\n\nThese are v0.2+. Tracer bullet first.","status":"open","priority":0,"issue_type":"epic","created_at":"2025-12-24T15:33:45.930555-08:00","updated_at":"2025-12-24T15:33:45.930555-08:00"} +{"id":"gt-qvn7.1","title":"Phase 1: Slinging Handoff","description":"# Phase 1: Slinging Handoff\n\nThe restart-and-resume loop. This is the fundamental propulsion mechanism.\n\n## What It Does\n\n```bash\ngt sling gt-xxx\n```\n\n1. Creates a wisp on the agent's hook containing the bead\n2. Sends handoff mail (optional context)\n3. Triggers session restart (daemon SIGUSR1 or direct respawn)\n4. Fresh Claude wakes up\n5. SessionStart hook runs `gt prime`\n6. Agent reads hook → finds the slung bead\n7. Agent executes the work\n\n## Why Wisp, Not Mol\n\nThe sling is ephemeral scaffolding. It says \"run this bead\" - nothing more.\nOnce the work is picked up, the wisp can be burned. No permanent record needed\nfor the handoff wrapper itself; the actual work is tracked in the bead.\n\n## Implementation\n\n### gt sling command\n\n```go\n// cmd: gt sling \u003cbead-id\u003e [-s subject] [-m message]\nfunc sling(beadID string, subject, message string) {\n // 1. Create wisp on hook\n // - Creates .beads-wisp/hook-\u003cagent\u003e.wisp.yaml\n // - Contains: bead_id, slung_at, context\n \n // 2. Optional: send handoff mail\n // - gt mail send \u003cself\u003e -s \"🤝 HANDOFF: \u003csubject\u003e\" -m \"\u003cmessage\u003e\"\n \n // 3. Trigger restart\n // - For crew: just exit (human restarts)\n // - For polecats: signal daemon (SIGUSR1)\n // - For deacon: signal daemon (SIGUSR1)\n}\n```\n\n### Hook Reading in gt prime\n\n```go\n// In gt prime, after loading context:\nfunc checkHook(agent string) *SlungWork {\n wispPath := \".beads-wisp/hook-\" + agent + \".wisp.yaml\"\n if exists(wispPath) {\n return parseWisp(wispPath)\n }\n return nil\n}\n```\n\n### Agent Response to Slung Work\n\nWhen agent wakes and finds slung work:\n\n1. Read the wisp: `hook-\u003cagent\u003e.wisp.yaml`\n2. Get the bead ID\n3. Show the bead: `bd show \u003cbead-id\u003e`\n4. Begin working on it\n5. Burn the wisp (it's been picked up\n\n## Files Changed\n\n- - New command\n- - Wisp creation/reading\n- - Hook check on startup\n- Role CLAUDE.md files - Instructions for hook processing\n\n## Acceptance Criteria\n\n- [ ] creates wisp on hook\n- [ ] Agent restart picks up the slung work\n- [ ] Work begins automatically (no human nudge)\n- [ ] Wisp is burned after pickup\nEOF\n)","status":"open","priority":0,"issue_type":"epic","created_at":"2025-12-24T15:34:11.051245-08:00","updated_at":"2025-12-24T15:34:11.051245-08:00","dependencies":[{"issue_id":"gt-qvn7.1","depends_on_id":"gt-qvn7","type":"parent-child","created_at":"2025-12-24T15:34:11.053313-08:00","created_by":"daemon"}]} +{"id":"gt-qvn7.1.1","title":"gt sling command implementation","description":"Implement the gt sling command for handoff with attached work.\n\n## Command Signature\n\n```bash\ngt sling \u003cbead-id\u003e [-s subject] [-m message]\n```\n\n## Behavior\n\n1. Validate the bead exists: bd show \u003cbead-id\u003e\n2. Create wisp on agents hook:\n - File: .beads-wisp/hook-\u003cagent\u003e.wisp.yaml\n - Content: bead_id, slung_at, optional context\n3. Optionally send handoff mail with subject/message\n4. Exit cleanly (or signal restart)\n\n## Wisp Format\n\n```yaml\ntype: slung-work\nbead_id: gt-xxx\nslung_at: 2025-12-24T...\nslung_by: crew/joe\ncontext: \"Optional message\"\n```\n\n## Files to Create/Modify\n\n- cmd/gt/sling.go (new)\n- internal/wisp/wisp.go (may need creation)\n- internal/wisp/hook.go (hook reading)\n\n## Notes\n\n- Keep it simple - this is connector code\n- The wisp is burned after pickup\n- Sling should work for any role (crew, polecat, deacon)","status":"open","priority":0,"issue_type":"task","created_at":"2025-12-24T15:36:14.175753-08:00","updated_at":"2025-12-24T15:36:14.175753-08:00","dependencies":[{"issue_id":"gt-qvn7.1.1","depends_on_id":"gt-qvn7.1","type":"parent-child","created_at":"2025-12-24T15:36:14.177841-08:00","created_by":"daemon"},{"issue_id":"gt-qvn7.1.1","depends_on_id":"gt-qvn7.1.2","type":"blocks","created_at":"2025-12-24T15:36:56.672678-08:00","created_by":"daemon"}]} +{"id":"gt-qvn7.1.2","title":"Wisp directory and format","description":"Define and implement the .beads-wisp directory structure.\n\n## Directory Structure\n\n```\n\u003cclone\u003e/.beads-wisp/\n hook-\u003cagent\u003e.wisp.yaml # Slung work for this agent\n patrol-\u003cid\u003e.wisp.yaml # Patrol cycle state (future)\n```\n\n## Wisp File Format\n\n```yaml\ntype: slung-work | patrol-cycle\ncreated_at: ISO timestamp\ncreated_by: entity who created it\n\n# For slung-work:\nbead_id: gt-xxx\ncontext: optional message\n\n# For patrol-cycle (future):\nformula: mol-deacon-patrol\ncurrent_step: inbox-check\nstep_states: {...}\n```\n\n## Key Properties\n\n- NOT git tracked (.beads-wisp/ in .gitignore)\n- Ephemeral - burned after use\n- Local to each clone\n- Fast writes (no sync needed)\n\n## Implementation\n\n- internal/wisp/dir.go - Directory creation/management\n- internal/wisp/types.go - Wisp type definitions\n- internal/wisp/io.go - Read/write operations","status":"open","priority":0,"issue_type":"task","created_at":"2025-12-24T15:36:25.061863-08:00","updated_at":"2025-12-24T15:36:25.061863-08:00","dependencies":[{"issue_id":"gt-qvn7.1.2","depends_on_id":"gt-qvn7.1","type":"parent-child","created_at":"2025-12-24T15:36:25.063924-08:00","created_by":"daemon"}]} +{"id":"gt-qvn7.1.3","title":"Hook reading in gt prime","description":"Enhance gt prime to check and display hook contents.\n\n## Current Behavior\n\ngt prime loads context:\n- Reads CLAUDE.md\n- Injects beads workflow info\n- Shows status\n\n## New Behavior\n\nAfter loading context, check hook:\n\n```go\n// In prime.go\nfunc checkHook(agent string) {\n wispPath := \".beads-wisp/hook-\" + agent + \".wisp.yaml\"\n if wisp := readWisp(wispPath); wisp != nil {\n // Inject hook info into prime output\n showSlungWork(wisp)\n }\n}\n```\n\n## Output Format\n\nWhen hook has slung work:\n\n```markdown\n## Your Hook\n\nYou have work assigned:\n\n**Bead:** gt-xxx\n**Title:** Fix authentication bug\n**Priority:** P1\n\nContext from previous session:\n\u003e Continue where I left off...\n\n**BEGIN WORK NOW.** Claim it with:\n bd update gt-xxx --status=in_progress\n```\n\n## Files Modified\n\n- cmd/gt/prime.go - Add hook checking\n- internal/wisp/hook.go - Hook reading utilities","status":"open","priority":0,"issue_type":"task","created_at":"2025-12-24T15:36:37.061178-08:00","updated_at":"2025-12-24T15:36:37.061178-08:00","dependencies":[{"issue_id":"gt-qvn7.1.3","depends_on_id":"gt-qvn7.1","type":"parent-child","created_at":"2025-12-24T15:36:37.063211-08:00","created_by":"daemon"},{"issue_id":"gt-qvn7.1.3","depends_on_id":"gt-qvn7.1.2","type":"blocks","created_at":"2025-12-24T15:36:56.759282-08:00","created_by":"daemon"}]} +{"id":"gt-qvn7.1.4","title":"Wisp burn after pickup","description":"Implement wisp cleanup after work is picked up.\n\n## When to Burn\n\nAfter agent has picked up slung work:\n- Agent claims the issue (bd update --status=in_progress)\n- Or agent explicitly acknowledges the handoff\n- Wisp file is deleted\n\n## Implementation Options\n\nOption A: Agent burns manually\n```bash\ngt hook burn # Deletes current hook wisp\n```\n\nOption B: Auto-burn on claim\n- bd update detects theres a hook for this issue\n- Burns the wisp automatically\n\nOption C: Burn in prime (after display)\n- Once shown to agent, delete the wisp\n- Simple but might lose info if agent crashes before reading\n\n## Recommendation\n\nUse Option A (manual burn) for v0.1:\n- Explicit is better than implicit\n- Agent controls when theyre done with handoff\n- Add auto-burn in v0.2\n\n## Command\n\n```bash\ngt hook burn\n# Deletes .beads-wisp/hook-\u003cagent\u003e.wisp.yaml\n# Confirms: \"Hook cleared\"\n```","status":"open","priority":1,"issue_type":"task","created_at":"2025-12-24T15:36:48.284445-08:00","updated_at":"2025-12-24T15:36:48.284445-08:00","dependencies":[{"issue_id":"gt-qvn7.1.4","depends_on_id":"gt-qvn7.1","type":"parent-child","created_at":"2025-12-24T15:36:48.286893-08:00","created_by":"daemon"},{"issue_id":"gt-qvn7.1.4","depends_on_id":"gt-qvn7.1.3","type":"blocks","created_at":"2025-12-24T15:36:56.843124-08:00","created_by":"daemon"}]} +{"id":"gt-qvn7.2","title":"Phase 2: Hook Execution Protocol","description":"# Phase 2: Hook Execution Protocol\n\nMaking agents actually RUN what's on their hook.\n\n## The Problem\n\nCurrently, agents wake up, get primed, and... wait. They don't automatically\nexecute their pinned molecule or slung work. The propulsion is missing.\n\n## The Solution\n\ngt prime should end with an ACTION, not just context loading:\n\n```\ngt prime output:\n 1. Load context (existing)\n 2. Check hook\n 3. If hook has work → tell agent to RUN IT NOW\n```\n\n## Hook Types\n\n| Hook Content | Action |\n|--------------|--------|\n| Pinned molecule (mol-*) | Execute current step, advance |\n| Slung bead (gt-xxx) | Show bead, begin work |\n| Nothing | Wait for assignment |\n\n## Molecule Execution Pattern\n\nWhen hook has a molecule:\n\n```markdown\n## Your Hook: mol-deacon-patrol\n\nCurrent step: inbox-check\nStatus: pending\n\n**EXECUTE THIS STEP NOW.**\n\n### Step: inbox-check\nCheck the Mayor's inbox for messages...\n\nWhen complete, run: `bd mol advance mol-deacon-patrol`\n```\n\nThe agent sees this, does the step, advances the molecule.\n\n## Implementation\n\n### gt prime enhancements\n\n1. After loading context, check `bd hook`\n2. If molecule → inject step execution prompt\n3. If slung bead → inject \"work on this bead\" prompt\n4. Include the actual step/bead content inline\n\n### bd mol advance command\n\n```bash\nbd mol advance \u003cmol-id\u003e\n# Marks current step complete\n# Moves to next step (respecting deps)\n# Returns new current step or \"COMPLETE\"\n```\n\n### Molecule State Tracking\n\nMolecules need execution state:\n\n```yaml\n# .beads/molecules/mol-deacon-patrol.state.yaml\nid: mol-deacon-patrol\ncurrent_step: inbox-check\nstep_states:\n inbox-check: pending\n trigger-pending-spawns: blocked\n health-scan: blocked\nsteps_completed: []\nstarted_at: 2025-12-24T...\n```\n\n## Files Changed\n\n- `cmd/gt/prime.go` - Hook check and action injection\n- Beads: `cmd/bd/mol_advance.go` - Step advancement\n- Beads: `internal/mol/state.go` - Molecule execution state\n\n## Acceptance Criteria\n\n- gt prime shows current hook and prompts action\n- bd mol advance moves molecule forward\n- Agent naturally follows the execution flow","status":"open","priority":0,"issue_type":"epic","created_at":"2025-12-24T15:34:32.037329-08:00","updated_at":"2025-12-24T15:34:32.037329-08:00","dependencies":[{"issue_id":"gt-qvn7.2","depends_on_id":"gt-qvn7","type":"parent-child","created_at":"2025-12-24T15:34:32.039415-08:00","created_by":"daemon"},{"issue_id":"gt-qvn7.2","depends_on_id":"gt-qvn7.1","type":"blocks","created_at":"2025-12-24T15:36:00.393831-08:00","created_by":"daemon"}]} +{"id":"gt-qvn7.2.1","title":"bd mol advance command","description":"Implement bd mol advance for stepping through molecules.\n\n## Command\n\n```bash\nbd mol advance \u003cmol-id\u003e\n```\n\n## Behavior\n\n1. Load molecule state from .beads/molecules/\u003cmol-id\u003e.state.yaml\n2. Find current step\n3. Mark current step complete\n4. Find next available step (respecting deps)\n5. Update state file\n6. Output next step info (or COMPLETE)\n\n## State File Format\n\n```yaml\nid: mol-deacon-patrol\nformula: mol-deacon-patrol\nstarted_at: 2025-12-24T...\ncurrent_step: inbox-check\nstep_states:\n inbox-check: in_progress\n trigger-pending-spawns: pending\n health-scan: pending\ncompleted_steps: []\n```\n\n## Step State Machine\n\n```\npending → in_progress → completed\n ↓\n blocked (if deps not met)\n```\n\n## Output\n\n```bash\n$ bd mol advance mol-deacon-patrol\n✓ Step 'inbox-check' completed\n→ Next step: 'trigger-pending-spawns'\n\nTitle: Nudge newly spawned polecats\nDescription: ...\n```\n\nOr if complete:\n```bash\n$ bd mol advance mol-deacon-patrol\n✓ Step 'loop-or-exit' completed\n✓ Molecule COMPLETE\n```\n\n## Files\n\n- Beads repo: cmd/bd/mol_advance.go\n- Beads repo: internal/mol/state.go","status":"open","priority":0,"issue_type":"task","created_at":"2025-12-24T15:37:10.413975-08:00","updated_at":"2025-12-24T15:37:10.413975-08:00","dependencies":[{"issue_id":"gt-qvn7.2.1","depends_on_id":"gt-qvn7.2","type":"parent-child","created_at":"2025-12-24T15:37:10.416191-08:00","created_by":"daemon"},{"issue_id":"gt-qvn7.2.1","depends_on_id":"gt-qvn7.2.2","type":"blocks","created_at":"2025-12-24T15:37:39.740685-08:00","created_by":"daemon"}]} +{"id":"gt-qvn7.2.2","title":"Molecule state file management","description":"Implement molecule execution state tracking.\n\n## State Location\n\n```\n.beads/molecules/\u003cmol-id\u003e.state.yaml\n```\n\n## State Schema\n\n```yaml\nid: mol-deacon-patrol\nformula: mol-deacon-patrol # Source formula\nbonded_at: ISO timestamp\nbonded_by: entity who created this instance\n\n# Execution state\nstatus: running | paused | completed | failed\ncurrent_step: step-id\nstarted_at: ISO timestamp\ncompleted_at: ISO timestamp (if done)\n\n# Per-step state\nsteps:\n inbox-check:\n status: completed\n started_at: ...\n completed_at: ...\n trigger-pending-spawns:\n status: in_progress\n started_at: ...\n health-scan:\n status: pending\n\n# Variables (from formula instantiation)\nvariables:\n rig: gastown\n issue_id: gt-xxx\n```\n\n## Operations\n\n- CreateState(molID, formula, variables) - Initialize state\n- LoadState(molID) - Read current state\n- SaveState(molID, state) - Write state\n- AdvanceStep(molID) - Mark current complete, find next\n\n## Files\n\n- Beads repo: internal/mol/state.go","status":"open","priority":0,"issue_type":"task","created_at":"2025-12-24T15:37:21.389134-08:00","updated_at":"2025-12-24T15:37:21.389134-08:00","dependencies":[{"issue_id":"gt-qvn7.2.2","depends_on_id":"gt-qvn7.2","type":"parent-child","created_at":"2025-12-24T15:37:21.39098-08:00","created_by":"daemon"}]} +{"id":"gt-qvn7.2.3","title":"gt prime molecule execution prompt","description":"Enhance gt prime to show molecule execution prompts.\n\n## When Hook Has Molecule\n\ngt prime should output:\n\n```markdown\n## Your Patrol: mol-deacon-patrol\n\n**Current Step:** inbox-check\n**Status:** pending (ready to execute)\n\n### Step: inbox-check\n\nHandle callbacks from agents.\n\nCheck the Mayor inbox for messages from:\n- Witnesses reporting polecat status\n- Refineries reporting merge results\n...\n\n**EXECUTE THIS STEP NOW.**\n\nWhen complete, run:\n bd mol advance mol-deacon-patrol\n```\n\n## Logic\n\n1. Check if hook has pinned molecule (bd hook --json)\n2. Load molecule state\n3. Get current step details from formula\n4. Format execution prompt\n5. Include advance command\n\n## Different from Slung Work\n\nSlung work (bead) says \"work on this issue\"\nMolecule says \"execute this step of this workflow\"\n\nBoth use the hook, but prompts differ.\n\n## Files\n\n- cmd/gt/prime.go\n- May need to read formula to get step descriptions","status":"open","priority":0,"issue_type":"task","created_at":"2025-12-24T15:37:33.304687-08:00","updated_at":"2025-12-24T15:37:33.304687-08:00","dependencies":[{"issue_id":"gt-qvn7.2.3","depends_on_id":"gt-qvn7.2","type":"parent-child","created_at":"2025-12-24T15:37:33.306622-08:00","created_by":"daemon"},{"issue_id":"gt-qvn7.2.3","depends_on_id":"gt-qvn7.2.2","type":"blocks","created_at":"2025-12-24T15:37:39.825493-08:00","created_by":"daemon"}]} +{"id":"gt-qvn7.3","title":"Phase 3: Polecat Work Cycle","description":"# Phase 3: Polecat Work Cycle\n\nThe complete lifecycle of a single polecat working a single issue.\n\n## The Cycle\n\n```\nspawn → wake → prime → read hook → work → submit → complete → cleanup\n```\n\n## Step by Step\n\n### 1. Spawn (Deacon/Mayor initiates)\n\n```bash\ngt spawn --issue gt-xxx --rig gastown\n```\n\nCreates fresh worktree, assigns issue, creates polecat session.\n\n### 2. Wake (Claude starts)\n\nPolecat Claude session starts. SessionStart hook fires.\n\n### 3. Prime (Context loads)\n\n```bash\ngt prime # Runs automatically via hook\n```\n\nLoads CLAUDE.md, injects beads context, checks hook.\n\n### 4. Read Hook\n\ngt prime finds the assigned issue on the hook:\n\n```\n## Your Hook: gt-xxx\n\nYou have been assigned this issue. Begin work now.\n\nTitle: Fix authentication bug\nPriority: P1\nDescription: ...\n\nClaim it with: bd update gt-xxx --status=in_progress\n```\n\n### 5. Work\n\nPolecat:\n- Claims issue: `bd update gt-xxx --status=in_progress`\n- Reads relevant code\n- Makes changes\n- Commits with issue ID\n\n### 6. Submit\n\nPolecat:\n- Pushes branch\n- Creates MR bead: `bd create \"Merge: gt-xxx\" --type=merge-request`\n- Signals completion\n\n### 7. Complete\n\nPolecat:\n- Closes the issue: `bd close gt-xxx --reason \"Fixed in commit abc123\"`\n- Syncs beads: `bd sync`\n\n### 8. Cleanup\n\nPolecat:\n- Sends completion mail to Witness\n- Session terminates (or awaits next assignment)\n\n## The mol-polecat-work Molecule\n\nThis is already defined. The polecat should be bonded to it on spawn.\n\nKey steps:\n1. orient - Read context, understand codebase\n2. claim - Update issue status\n3. work - Implement the fix\n4. test - Run tests, verify\n5. submit - Push, create MR\n6. handoff - Signal done, sync\n\n## Implementation\n\n### gt spawn enhancements\n\n- Automatically pin mol-polecat-work to new polecat\n- Pass issue ID as variable\n- Ensure hook is set before Claude starts\n\n### Polecat CLAUDE.md\n\nMust include:\n- Hook reading instructions\n- Molecule execution pattern\n- Exit state vocabulary (COMPLETED, BLOCKED, ESCALATE)\n\n## Acceptance Criteria\n\n- gt spawn creates polecat with issue on hook\n- Polecat wakes and begins work automatically\n- Polecat completes issue and submits MR\n- Issue is closed with commit reference","status":"open","priority":0,"issue_type":"epic","created_at":"2025-12-24T15:34:53.710094-08:00","updated_at":"2025-12-24T15:34:53.710094-08:00","dependencies":[{"issue_id":"gt-qvn7.3","depends_on_id":"gt-qvn7","type":"parent-child","created_at":"2025-12-24T15:34:53.712193-08:00","created_by":"daemon"},{"issue_id":"gt-qvn7.3","depends_on_id":"gt-qvn7.2","type":"blocks","created_at":"2025-12-24T15:36:00.479432-08:00","created_by":"daemon"}]} +{"id":"gt-qvn7.3.1","title":"gt spawn pins mol-polecat-work","description":"Enhance gt spawn to automatically pin mol-polecat-work to new polecats.\n\n## Current Behavior\n\ngt spawn --issue gt-xxx creates polecat with issue in mail but no molecule.\n\n## New Behavior\n\ngt spawn should:\n1. Create fresh worktree (existing)\n2. Initialize polecat beads (existing)\n3. Bond mol-polecat-work with issue as variable\n4. Pin the molecule to polecat hook\n5. Create polecat session\n\n## Molecule Bonding\n\n```bash\nbd mol bond mol-polecat-work --var issue_id=gt-xxx --var rig=gastown\n```\n\nCreates .beads/molecules/mol-polecat-work-\u003chash\u003e.state.yaml\n\n## Hook Pinning\n\n```bash\nbd pin mol-polecat-work-\u003chash\u003e --for polecat/\u003cname\u003e\n```\n\nCreates .beads-wisp/hook-polecat-\u003cname\u003e.wisp.yaml pointing to molecule\n\n## Files\n\n- internal/spawn/spawn.go - Add mol-polecat-work bonding\n- Or: internal/cmd/spawn.go depending on structure","status":"open","priority":0,"issue_type":"task","created_at":"2025-12-24T15:37:51.450108-08:00","updated_at":"2025-12-24T15:37:51.450108-08:00","dependencies":[{"issue_id":"gt-qvn7.3.1","depends_on_id":"gt-qvn7.3","type":"parent-child","created_at":"2025-12-24T15:37:51.452167-08:00","created_by":"daemon"}]} +{"id":"gt-qvn7.3.2","title":"Polecat CLAUDE.md update for hook execution","description":"Update polecat role CLAUDE.md to include hook execution instructions.\n\n## Key Additions\n\n### Startup Protocol\n\n```markdown\n## Startup Protocol\n\nWhen you wake up:\n\n1. **Check your hook first**\n Run: gt prime\n This shows your assigned work.\n\n2. **If hook has molecule**\n You are running a workflow. Execute the current step.\n When done: bd mol advance \u003cmol-id\u003e\n\n3. **If hook has slung bead**\n Work on that specific issue.\n Claim it: bd update \u003cid\u003e --status=in_progress\n\n4. **If hook empty**\n Wait for assignment via mail or spawn.\n```\n\n### Work Completion\n\n```markdown\n## Completing Work\n\nWhen you finish your assigned issue:\n\n1. Commit changes: git add \u0026\u0026 git commit -m \"description (issue-id)\"\n2. Push branch: git push -u origin \u003cbranch\u003e\n3. Create MR bead: bd create \"Merge: \u003cissue-id\u003e\" --type=merge-request\n4. Close issue: bd close \u003cissue-id\u003e --reason \"Fixed in commit abc123\"\n5. Sync: bd sync\n6. Signal done: gt mail send witness/ -s \"LIFECYCLE: Done\" -m \"Completed \u003cissue-id\u003e\"\n```\n\n### Exit States\n\n```markdown\n## Exit States\n\nWhen finishing, signal your state:\n\n- COMPLETED: Work done successfully\n- BLOCKED: Cannot proceed, need help\n- ESCALATE: Problem beyond your scope\n- HANDOFF: Passing to successor\n```\n\n## File\n\ntemplates/polecat/CLAUDE.md","status":"open","priority":0,"issue_type":"task","created_at":"2025-12-24T15:38:08.153576-08:00","updated_at":"2025-12-24T15:38:08.153576-08:00","dependencies":[{"issue_id":"gt-qvn7.3.2","depends_on_id":"gt-qvn7.3","type":"parent-child","created_at":"2025-12-24T15:38:08.155584-08:00","created_by":"daemon"}]} +{"id":"gt-qvn7.3.3","title":"mol-polecat-work-v01 minimal formula","description":"Create minimal mol-polecat-work formula for tracer bullet.\n\n## Simplified Steps\n\nFor v0.1, just the essentials:\n\n```yaml\nformula: mol-polecat-work-v01\ndescription: Minimal polecat work cycle for tracer bullet.\nversion: 1\n\nvariables:\n - name: issue_id\n required: true\n - name: rig\n required: true\n\nsteps:\n - id: claim\n title: Claim the issue\n description: |\n Run: bd update {{issue_id}} --status=in_progress\n Read the issue: bd show {{issue_id}}\n Understand what needs to be done.\n\n - id: work\n title: Implement the fix\n needs: [claim]\n description: |\n Do the work described in the issue.\n Make your changes.\n Test them.\n Commit with issue ID: git commit -m \"description ({{issue_id}})\"\n\n - id: submit\n title: Submit for review\n needs: [work]\n description: |\n Push your branch: git push -u origin \u003cbranch\u003e\n Create MR: bd create \"Merge: {{issue_id}}\" --type=merge-request\n Close issue: bd close {{issue_id}}\n Sync: bd sync\n Signal done: gt mail send witness/ -s \"LIFECYCLE: Done\"\n```\n\n## Location\n\n.beads/formulas/mol-polecat-work-v01.formula.yaml\n\n## Notes\n\n- Keep it simple for tracer bullet\n- Full mol-polecat-work can be more elaborate\n- This proves the pattern works","status":"open","priority":0,"issue_type":"task","created_at":"2025-12-24T15:38:20.520847-08:00","updated_at":"2025-12-24T15:38:20.520847-08:00","dependencies":[{"issue_id":"gt-qvn7.3.3","depends_on_id":"gt-qvn7.3","type":"parent-child","created_at":"2025-12-24T15:38:20.52293-08:00","created_by":"daemon"}]} +{"id":"gt-qvn7.4","title":"Phase 4: Deacon Patrol Loop","description":"$(cat /tmp/phase4.md)","status":"open","priority":0,"issue_type":"epic","created_at":"2025-12-24T15:35:32.511322-08:00","updated_at":"2025-12-24T15:35:32.511322-08:00","dependencies":[{"issue_id":"gt-qvn7.4","depends_on_id":"gt-qvn7","type":"parent-child","created_at":"2025-12-24T15:35:32.513848-08:00","created_by":"daemon"},{"issue_id":"gt-qvn7.4","depends_on_id":"gt-qvn7.2","type":"blocks","created_at":"2025-12-24T15:36:00.565162-08:00","created_by":"daemon"}]} +{"id":"gt-qvn7.4.1","title":"Deacon CLAUDE.md for patrol execution","description":"Update Deacon role CLAUDE.md for patrol execution.\n\n## Key Additions\n\n### Role Definition\n\n```markdown\n## Your Role: DEACON\n\nYou are the Deacon - Gas Towns heartbeat process.\nYou run mol-deacon-patrol continuously.\n\nYour job:\n- Check mail for callbacks\n- Spawn polecats for ready work\n- Monitor rig health (basic)\n- Cycle context when full\n```\n\n### Patrol Execution\n\n```markdown\n## Patrol Execution\n\nYou run mol-deacon-patrol on your hook.\n\nOn each heartbeat from the daemon:\n1. Check your current step: bd hook\n2. Execute that step\n3. Advance: bd mol advance mol-deacon-patrol\n4. If COMPLETE: restart the patrol or cycle context\n\nThe daemon keeps you alive. Your job is to run the patrol.\n```\n\n### Heartbeat Response\n\n```markdown\n## Heartbeat Response\n\nWhen you see \"HEARTBEAT: ...\" from the daemon:\n- If idle: check your hook, start/resume patrol\n- If mid-step: continue working\n- If waiting: the heartbeat reminds you to check state\n\nHeartbeats are your clock tick. Use them.\n```\n\n### Context Cycling\n\n```markdown\n## Context Cycling\n\nWhen context is high (\u003e80%):\n1. Write state to molecule\n2. Run: gt handoff -s \"Deacon cycling\" -m \"Context full\"\n3. Exit cleanly\n4. Daemon respawns you\n5. You wake, prime, read hook, continue\n```\n\n## File\n\ndeacon/CLAUDE.md (in town root)","status":"open","priority":0,"issue_type":"task","created_at":"2025-12-24T15:38:35.345899-08:00","updated_at":"2025-12-24T15:38:35.345899-08:00","dependencies":[{"issue_id":"gt-qvn7.4.1","depends_on_id":"gt-qvn7.4","type":"parent-child","created_at":"2025-12-24T15:38:35.347599-08:00","created_by":"daemon"},{"issue_id":"gt-qvn7.4.1","depends_on_id":"gt-qvn7.4.2","type":"blocks","created_at":"2025-12-24T15:39:07.332578-08:00","created_by":"daemon"}]} +{"id":"gt-qvn7.4.2","title":"mol-deacon-patrol-v01 minimal formula","description":"Create minimal mol-deacon-patrol formula for tracer bullet.\n\n## Simplified Patrol\n\nFor v0.1, just the essentials:\n\n```yaml\nformula: mol-deacon-patrol-v01\ndescription: Minimal Deacon patrol for tracer bullet.\nversion: 1\n\nsteps:\n - id: inbox-check\n title: Check inbox\n description: |\n Run: gt mail inbox\n Handle any messages.\n Note any spawn requests or status updates.\n\n - id: spawn-work\n title: Spawn polecat for ready work\n needs: [inbox-check]\n description: |\n Run: bd ready\n If work available:\n gt spawn --issue \u003cfirst-ready\u003e --rig gastown\n If no work: proceed to next step.\n\n - id: loop-decision\n title: Loop or cycle\n needs: [spawn-work]\n description: |\n Check context usage.\n If context \u003c 80%:\n Advance to inbox-check (loop)\n If context \u003e= 80%:\n gt handoff -s \"Deacon cycling\"\n Exit (daemon respawns)\n```\n\n## Loop Behavior\n\nAfter loop-decision completes:\n- bd mol advance should reset to inbox-check\n- Or: create new patrol instance\n\n## Alternative: Reset Instead of Loop\n\nSimpler approach for v0.1:\n- When patrol completes, Deacon runs gt handoff\n- Fresh Deacon wakes with fresh patrol\n- No loop logic needed in molecule\n\n## Location\n\n.beads/formulas/mol-deacon-patrol-v01.formula.yaml","status":"open","priority":0,"issue_type":"task","created_at":"2025-12-24T15:38:48.948745-08:00","updated_at":"2025-12-24T15:38:48.948745-08:00","dependencies":[{"issue_id":"gt-qvn7.4.2","depends_on_id":"gt-qvn7.4","type":"parent-child","created_at":"2025-12-24T15:38:48.950928-08:00","created_by":"daemon"}]} +{"id":"gt-qvn7.4.3","title":"Deacon initialization with patrol molecule","description":"Ensure Deacon always has mol-deacon-patrol on hook.\n\n## The Problem\n\nWhen Deacon starts fresh, it needs:\n1. mol-deacon-patrol bonded\n2. Molecule pinned to hook\n3. Ready to execute\n\n## Solution: Bootstrap in gt prime\n\nWhen gt prime runs for role=deacon:\n\n1. Check if mol-deacon-patrol exists on hook\n2. If not: bond it and pin it\n3. Then show execution prompt\n\n```go\n// In prime.go for deacon role\nif role == \"deacon\" \u0026\u0026 !hasPatrolOnHook() {\n // Bond the patrol formula\n bondDeaconPatrol()\n // Pin to hook\n pinToHook(\"deacon\", patrolMolID)\n}\n```\n\n## Alternative: Deacon Startup Hook\n\nOr handle in Deacon SessionStart hook:\n- Check hook\n- If empty: gt mol bond mol-deacon-patrol \u0026\u0026 gt mol pin\n\n## Files\n\n- cmd/gt/prime.go (if handling in prime)\n- deacon/hooks/session-start.sh (if handling in hook)","status":"open","priority":0,"issue_type":"task","created_at":"2025-12-24T15:39:00.670376-08:00","updated_at":"2025-12-24T15:39:00.670376-08:00","dependencies":[{"issue_id":"gt-qvn7.4.3","depends_on_id":"gt-qvn7.4","type":"parent-child","created_at":"2025-12-24T15:39:00.672391-08:00","created_by":"daemon"},{"issue_id":"gt-qvn7.4.3","depends_on_id":"gt-qvn7.4.2","type":"blocks","created_at":"2025-12-24T15:39:07.418965-08:00","created_by":"daemon"}]} +{"id":"gt-qvn7.5","title":"Phase 5: Integration and Demo","description":"$(cat /tmp/phase5.md)","status":"open","priority":0,"issue_type":"epic","created_at":"2025-12-24T15:35:52.803427-08:00","updated_at":"2025-12-24T15:35:52.803427-08:00","dependencies":[{"issue_id":"gt-qvn7.5","depends_on_id":"gt-qvn7","type":"parent-child","created_at":"2025-12-24T15:35:52.805435-08:00","created_by":"daemon"},{"issue_id":"gt-qvn7.5","depends_on_id":"gt-qvn7.3","type":"blocks","created_at":"2025-12-24T15:36:00.648003-08:00","created_by":"daemon"},{"issue_id":"gt-qvn7.5","depends_on_id":"gt-qvn7.4","type":"blocks","created_at":"2025-12-24T15:36:00.730985-08:00","created_by":"daemon"}]} +{"id":"gt-qvn7.5.1","title":"End-to-end integration test","description":"Create and run end-to-end integration test.\n\n## Test Scenario\n\n1. Clean state: no polecats, fresh beads\n2. Create test issue: simple documentation fix\n3. Verify Deacon sees it: bd ready shows issue\n4. Trigger Deacon: send heartbeat or wait\n5. Verify spawn: gt polecats shows new polecat\n6. Watch polecat work: tmux attach\n7. Verify completion: issue closed, MR created\n\n## Test Script\n\n```bash\n#!/bin/bash\n# e2e-test.sh\n\n# 1. Clean state\ngt polecat remove --all\nbd create \"Test: update README typo\" --type=task --priority=1\n\n# 2. Verify ready\nbd ready | grep \"update README\"\n\n# 3. Wait for Deacon or trigger\n# (manual for v0.1)\n\n# 4. Watch\ngt status\ngt polecats gastown\n\n# 5. Wait for completion\n# (manual observation for v0.1)\n\n# 6. Verify\nbd list --status=closed | grep \"update README\"\n```\n\n## Success Criteria\n\n- Issue created and visible in bd ready\n- Polecat spawned and working\n- Issue closed with commit reference\n- No manual intervention (except observation)","status":"open","priority":0,"issue_type":"task","created_at":"2025-12-24T15:39:20.642596-08:00","updated_at":"2025-12-24T15:39:20.642596-08:00","dependencies":[{"issue_id":"gt-qvn7.5.1","depends_on_id":"gt-qvn7.5","type":"parent-child","created_at":"2025-12-24T15:39:20.64439-08:00","created_by":"daemon"}]} +{"id":"gt-qvn7.5.2","title":"Documentation humility pass","description":"Update documentation with humble framing.\n\n## Changes Needed\n\n### README.md\n\n- Add \"Experimental\" or \"Alpha\" badge\n- Clarify current state vs future vision\n- List what works vs what is planned\n- Include honest limitations section\n\n### Architecture docs\n\n- Mark autonomous features as \"planned\"\n- Distinguish implemented from designed\n- Add \"Current Status\" sections\n\n### CLAUDE.md files\n\n- Remove claims about autonomous operation (where not true)\n- Add \"v0.1\" qualifiers to features\n- Be honest about manual steps required\n\n## Tone\n\nNOT: \"Gas Town automatically manages agent lifecycles\"\nYES: \"Gas Town provides infrastructure for agent lifecycle management.\n v0.1 requires some manual coordination.\"\n\nNOT: \"The Refinery processes merges autonomously\"\nYES: \"The Refinery is designed for autonomous merge processing.\n v0.1 demonstrates the pattern with manual triggering.\"\n\n## Files to Review\n\n- README.md\n- docs/architecture.md\n- docs/quickstart.md (if exists)\n- CLAUDE.md files for all roles","status":"open","priority":1,"issue_type":"task","created_at":"2025-12-24T15:39:32.215796-08:00","updated_at":"2025-12-24T15:39:32.215796-08:00","dependencies":[{"issue_id":"gt-qvn7.5.2","depends_on_id":"gt-qvn7.5","type":"parent-child","created_at":"2025-12-24T15:39:32.217795-08:00","created_by":"daemon"}]} +{"id":"gt-qvn7.5.3","title":"Demo recording","description":"Record a terminal demo of the tracer bullet.\n\n## Recording Tool\n\nUse asciinema:\n```bash\nbrew install asciinema\nasciinema rec gastown-demo.cast\n```\n\n## Demo Script\n\n1. Show gt status (the town)\n2. Show bd ready (available work)\n3. Show Deacon running (tmux session)\n4. Trigger spawn (create issue, Deacon picks it up)\n5. Show polecat working (tmux attach briefly)\n6. Show completion (bd list, issue closed)\n7. Show MR created (bd list --type=merge-request)\n\n## Tips\n\n- Practice run first\n- Keep it under 3 minutes\n- Add commentary (terminal echo or voiceover)\n- Show the key moments clearly\n\n## Output\n\n- gastown-demo.cast (asciinema file)\n- gastown-demo.gif (optional, for embedding)\n- YouTube/Vimeo upload (optional)","status":"open","priority":1,"issue_type":"task","created_at":"2025-12-24T15:39:43.630035-08:00","updated_at":"2025-12-24T15:39:43.630035-08:00","dependencies":[{"issue_id":"gt-qvn7.5.3","depends_on_id":"gt-qvn7.5","type":"parent-child","created_at":"2025-12-24T15:39:43.632383-08:00","created_by":"daemon"}]} {"id":"gt-qwin","title":"Refinery and witness rigs should redirect .beads to mayor rig","description":"The refinery's rig clone and witness rig clones should have their .beads directories redirect to the mayor's rig beads (like polecats do).\n\nCurrent state:\n- Polecats have .beads symlinked/redirected to mayor rig beads\n- Refinery and witness have their own .beads (or none)\n\nDesired state:\n- refinery/rig/.beads -\u003e mayor/rig/.beads (or equivalent redirect)\n- witness/rig/.beads -\u003e mayor/rig/.beads (or equivalent redirect)\n\nThis ensures all rig agents share the same issue tracking state.","status":"open","priority":2,"issue_type":"task","created_at":"2025-12-22T14:27:37.703044-08:00","updated_at":"2025-12-22T14:27:37.703044-08:00"} {"id":"gt-qwyu","title":"Test issue for spawn molecule","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-21T21:58:43.699993-08:00","updated_at":"2025-12-21T21:59:10.936251-08:00","closed_at":"2025-12-21T21:59:10.936251-08:00","close_reason":"test cleanup"} {"id":"gt-qx3k","title":"Merge: gt-jzot","description":"branch: polecat/nux\ntarget: main\nsource_issue: gt-jzot\nrig: gastown","status":"closed","priority":1,"issue_type":"merge-request","created_at":"2025-12-22T22:55:45.3321-08:00","updated_at":"2025-12-22T22:57:00.353151-08:00","closed_at":"2025-12-22T22:57:00.353151-08:00","close_reason":"Merged to main"}