johno/gastown
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

docs(witness): update help text to reflect self-cleaning polecat model

Browse Source 
Remove references to idle state. Polecats self-nuke after work - there is
no idle state. The Witness handles crash recovery and orphan cleanup.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
mayor
2026-01-10 23:18:39 -08:00
committed by beads/crew/giles
parent 8deb5ed1bd
commit 7f4c3201cf
1 changed files with 12 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
internal/cmd/witness.go
View File

@@ -28,8 +28,12 @@ var witnessCmd = &cobra.Command{
RunE: requireSubcommand, RunE: requireSubcommand,
Long: `Manage the Witness monitoring agent for a rig. Long: `Manage the Witness monitoring agent for a rig.
The Witness monitors polecats for stuck/idle state, nudges polecats The Witness monitors polecats for stuck states and orphaned sandboxes,
that seem blocked, and reports status to the mayor.`, nudges polecats that seem blocked, and reports status to the mayor.
In the self-cleaning model, polecats nuke themselves after work completion.
The Witness handles edge cases: crashed sessions, orphaned worktrees, and
stuck polecats that need intervention.`,
} }
var witnessStartCmd = &cobra.Command{ var witnessStartCmd = &cobra.Command{
@@ -38,8 +42,12 @@ var witnessStartCmd = &cobra.Command{
Short: "Start the witness", Short: "Start the witness",
Long: `Start the Witness for a rig. Long: `Start the Witness for a rig.
Launches the monitoring agent which watches polecats for stuck or idle Launches the monitoring agent which watches for stuck polecats and orphaned
states and takes action to keep work flowing. sandboxes, taking action to keep work flowing.
Self-Cleaning Model: Polecats nuke themselves after work. The Witness handles
crash recovery (restart with hooked work) and orphan cleanup (nuke abandoned
sandboxes). There is no "idle" state - polecats either have work or don't exist.
Examples: Examples:
gt witness start greenplace gt witness start greenplace