231d6e92e0
This implements the ephemeral polecat model where polecats are spawned fresh for each task and deleted upon completion. Key changes: **Spawn (internal/cmd/spawn.go):** - Always create fresh worktree from main branch - Run bd init in new worktree to initialize beads - Remove --create flag (now implicit) - Replace stale polecats with fresh worktrees **Handoff (internal/cmd/handoff.go):** - Add rig/polecat detection from environment and tmux session - Send shutdown requests to correct witness (rig/witness) - Include polecat name in lifecycle request body **Witness (internal/witness/manager.go):** - Add mail checking in monitoring loop - Process LIFECYCLE shutdown requests - Implement full cleanup sequence: - Kill tmux session - Remove git worktree - Delete polecat branch **Polecat state machine (internal/polecat/types.go):** - Primary states: working, done, stuck - Deprecate idle/active (kept for backward compatibility) - New polecats start in working state - ClearIssue transitions to done (not idle) **Polecat commands (internal/cmd/polecat.go):** - Update list to show "Active Polecats" - Normalize legacy states for display - Add deprecation warnings to wake/sleep commands Closes gt-7ik 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
82 lines
2.3 KiB
Go
82 lines
2.3 KiB
Go
// Package polecat provides polecat lifecycle management.
|
|
package polecat
|
|
|
|
import "time"
|
|
|
|
// State represents the current state of a polecat.
|
|
// In the ephemeral model, polecats exist only while working.
|
|
type State string
|
|
|
|
const (
|
|
// StateWorking means the polecat is actively working on an issue.
|
|
// This is the initial and primary state for ephemeral polecats.
|
|
StateWorking State = "working"
|
|
|
|
// StateDone means the polecat has completed its assigned work
|
|
// and is ready for cleanup by the Witness.
|
|
StateDone State = "done"
|
|
|
|
// StateStuck means the polecat needs assistance.
|
|
StateStuck State = "stuck"
|
|
|
|
// Legacy states for backward compatibility during transition.
|
|
// New code should not use these.
|
|
StateIdle State = "idle" // Deprecated: use StateWorking
|
|
StateActive State = "active" // Deprecated: use StateWorking
|
|
)
|
|
|
|
// IsWorking returns true if the polecat is currently working.
|
|
func (s State) IsWorking() bool {
|
|
return s == StateWorking
|
|
}
|
|
|
|
// IsActive returns true if the polecat session is actively working.
|
|
// For ephemeral polecats, this is true for working state and
|
|
// legacy idle/active states (treated as working).
|
|
func (s State) IsActive() bool {
|
|
return s == StateWorking || s == StateIdle || s == StateActive
|
|
}
|
|
|
|
// Polecat represents a worker agent in a rig.
|
|
type Polecat struct {
|
|
// Name is the polecat identifier.
|
|
Name string `json:"name"`
|
|
|
|
// Rig is the rig this polecat belongs to.
|
|
Rig string `json:"rig"`
|
|
|
|
// State is the current lifecycle state.
|
|
State State `json:"state"`
|
|
|
|
// ClonePath is the path to the polecat's clone of the rig.
|
|
ClonePath string `json:"clone_path"`
|
|
|
|
// Branch is the current git branch.
|
|
Branch string `json:"branch"`
|
|
|
|
// Issue is the currently assigned issue ID (if any).
|
|
Issue string `json:"issue,omitempty"`
|
|
|
|
// CreatedAt is when the polecat was created.
|
|
CreatedAt time.Time `json:"created_at"`
|
|
|
|
// UpdatedAt is when the polecat was last updated.
|
|
UpdatedAt time.Time `json:"updated_at"`
|
|
}
|
|
|
|
// Summary provides a concise view of polecat status.
|
|
type Summary struct {
|
|
Name string `json:"name"`
|
|
State State `json:"state"`
|
|
Issue string `json:"issue,omitempty"`
|
|
}
|
|
|
|
// Summary returns a Summary for this polecat.
|
|
func (p *Polecat) Summary() Summary {
|
|
return Summary{
|
|
Name: p.Name,
|
|
State: p.State,
|
|
Issue: p.Issue,
|
|
}
|
|
}
|