package cmd import ( "fmt" "os" "github.com/spf13/cobra" "github.com/steveyegge/gastown/internal/doctor" "github.com/steveyegge/gastown/internal/workspace" ) var ( doctorFix bool doctorVerbose bool doctorRig string ) var doctorCmd = &cobra.Command{ Use: "doctor", GroupID: GroupDiag, Short: "Run health checks on the workspace", Long: `Run diagnostic checks on the Gas Town workspace. Doctor checks for common configuration issues, missing files, and other problems that could affect workspace operation. Infrastructure checks: - daemon Check if daemon is running (fixable) - boot-health Check Boot watchdog health (vet mode) Cleanup checks (fixable): - orphan-sessions Detect orphaned tmux sessions - orphan-processes Detect orphaned Claude processes - wisp-gc Detect and clean abandoned wisps (>1h) Clone divergence checks: - persistent-role-branches Detect crew/witness/refinery not on main - clone-divergence Detect clones significantly behind origin/main Routing checks (fixable): - routes-config Check beads routing configuration Patrol checks: - patrol-molecules-exist Verify patrol molecules exist - patrol-hooks-wired Verify daemon triggers patrols - patrol-not-stuck Detect stale wisps (>1h) - patrol-plugins-accessible Verify plugin directories - patrol-roles-have-prompts Verify role prompts exist Use --fix to attempt automatic fixes for issues that support it. Use --rig to check a specific rig instead of the entire workspace.`, RunE: runDoctor, } func init() { doctorCmd.Flags().BoolVar(&doctorFix, "fix", false, "Attempt to automatically fix issues") doctorCmd.Flags().BoolVarP(&doctorVerbose, "verbose", "v", false, "Show detailed output") doctorCmd.Flags().StringVar(&doctorRig, "rig", "", "Check specific rig only") rootCmd.AddCommand(doctorCmd) } func runDoctor(cmd *cobra.Command, args []string) error { // Find town root townRoot, err := workspace.FindFromCwdOrError() if err != nil { return fmt.Errorf("not in a Gas Town workspace: %w", err) } // Create check context ctx := &doctor.CheckContext{ TownRoot: townRoot, RigName: doctorRig, Verbose: doctorVerbose, } // Create doctor and register checks d := doctor.NewDoctor() // Register built-in checks d.Register(doctor.NewTownGitCheck()) d.Register(doctor.NewDaemonCheck()) d.Register(doctor.NewBootHealthCheck()) d.Register(doctor.NewBeadsDatabaseCheck()) d.Register(doctor.NewPrefixConflictCheck()) d.Register(doctor.NewRoutesCheck()) d.Register(doctor.NewOrphanSessionCheck()) d.Register(doctor.NewOrphanProcessCheck()) d.Register(doctor.NewWispGCCheck()) d.Register(doctor.NewBranchCheck()) d.Register(doctor.NewBeadsSyncOrphanCheck()) d.Register(doctor.NewCloneDivergenceCheck()) d.Register(doctor.NewIdentityCollisionCheck()) d.Register(doctor.NewLinkedPaneCheck()) d.Register(doctor.NewThemeCheck()) // Patrol system checks d.Register(doctor.NewPatrolMoleculesExistCheck()) d.Register(doctor.NewPatrolHooksWiredCheck()) d.Register(doctor.NewPatrolNotStuckCheck()) d.Register(doctor.NewPatrolPluginsAccessibleCheck()) d.Register(doctor.NewPatrolRolesHavePromptsCheck()) d.Register(doctor.NewAgentBeadsCheck()) // NOTE: StaleAttachmentsCheck removed - staleness detection belongs in Deacon molecule // See gt-gaxo epic for ZFC cleanup rationale // Config architecture checks d.Register(doctor.NewSettingsCheck()) d.Register(doctor.NewRuntimeGitignoreCheck()) d.Register(doctor.NewLegacyGastownCheck()) // Crew workspace checks d.Register(doctor.NewCrewStateCheck()) // Lifecycle hygiene checks d.Register(doctor.NewLifecycleHygieneCheck()) // Hook attachment checks d.Register(doctor.NewHookAttachmentValidCheck()) d.Register(doctor.NewHookSingletonCheck()) d.Register(doctor.NewOrphanedAttachmentsCheck()) // Run checks var report *doctor.Report if doctorFix { report = d.Fix(ctx) } else { report = d.Run(ctx) } // Print report report.Print(os.Stdout, doctorVerbose) // Exit with error code if there are errors if report.HasErrors() { return fmt.Errorf("doctor found %d error(s)", report.Summary.Errors) } return nil }