feat(witness): add gt witness start/stop/status commands

Add the witness monitoring agent command with start, stop, and status subcommands. The witness monitors polecats for stuck/idle states and can nudge blocked workers. Closes gt-kcee 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-19 00:30:15 -08:00
parent e799fe5491
commit 9bf2e91dea
3 changed files with 473 additions and 0 deletions
@@ -0,0 +1,62 @@
+// Package witness provides the polecat monitoring agent.
+package witness
+
+import (
+	"time"
+)
+
+// State represents the witness's running state.
+type State string
+
+const (
+	// StateStopped means the witness is not running.
+	StateStopped State = "stopped"
+
+	// StateRunning means the witness is actively monitoring.
+	StateRunning State = "running"
+
+	// StatePaused means the witness is paused (not monitoring).
+	StatePaused State = "paused"
+)
+
+// Witness represents a rig's polecat monitoring agent.
+type Witness struct {
+	// RigName is the rig this witness monitors.
+	RigName string `json:"rig_name"`
+
+	// State is the current running state.
+	State State `json:"state"`
+
+	// PID is the process ID if running in background.
+	PID int `json:"pid,omitempty"`
+
+	// StartedAt is when the witness was started.
+	StartedAt *time.Time `json:"started_at,omitempty"`
+
+	// MonitoredPolecats tracks polecats being monitored.
+	MonitoredPolecats []string `json:"monitored_polecats,omitempty"`
+
+	// LastCheckAt is when the last health check was performed.
+	LastCheckAt *time.Time `json:"last_check_at,omitempty"`
+
+	// Stats contains cumulative statistics.
+	Stats WitnessStats `json:"stats"`
+}
+
+// WitnessStats contains cumulative witness statistics.
+type WitnessStats struct {
+	// TotalChecks is the total number of health checks performed.
+	TotalChecks int `json:"total_checks"`
+
+	// TotalNudges is the total number of nudges sent to polecats.
+	TotalNudges int `json:"total_nudges"`
+
+	// TotalEscalations is the total number of escalations to mayor.
+	TotalEscalations int `json:"total_escalations"`
+
+	// TodayChecks is the number of checks today.
+	TodayChecks int `json:"today_checks"`
+
+	// TodayNudges is the number of nudges today.
+	TodayNudges int `json:"today_nudges"`
+}