9bf2e91dea
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>
63 lines
1.7 KiB
Go
63 lines
1.7 KiB
Go
// 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"`
|
|
}
|