ZFC #10: Polecat self-reports cleanup status

Instead of Go code checking git state to decide if polecat removal is safe,
the polecat now self-reports its cleanup_status via its agent bead.

Changes:
- Add CleanupStatus field to AgentFields struct
- Update FormatAgentDescription and ParseAgentFields for cleanup_status
- Add UpdateAgentCleanupStatus function to beads package
- Update gt done to compute and report git cleanup status
- Update RemoveWithOptions to read cleanup_status from agent bead first,
  falling back to git check for backward compatibility

Valid cleanup_status values:
- clean: no uncommitted work
- has_uncommitted: has uncommitted changes
- has_stash: has stashed changes
- has_unpushed: has unpushed commits
- unknown: git check failed

This follows ZFC (Zero Figuring in Code) principles - the polecat is the
authority on its own state, not Go code inferring it from external signals.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

internal/beads/beads.go

@@ -514,11 +514,12 @@ func (b *Beads) IsBeadsRepo() bool {
 // AgentFields holds structured fields for agent beads.
 // These are stored as "key: value" lines in the description.
 type AgentFields struct {
-	RoleType   string // polecat, witness, refinery, deacon, mayor
-	Rig        string // Rig name (empty for global agents like mayor/deacon)
-	AgentState string // spawning, working, done, stuck
-	HookBead   string // Currently pinned work bead ID
-	RoleBead   string // Role definition bead ID (canonical location; may not exist yet)
+	RoleType      string // polecat, witness, refinery, deacon, mayor
+	Rig           string // Rig name (empty for global agents like mayor/deacon)
+	AgentState    string // spawning, working, done, stuck
+	HookBead      string // Currently pinned work bead ID
+	RoleBead      string // Role definition bead ID (canonical location; may not exist yet)
+	CleanupStatus string // ZFC: polecat self-reports git state (clean, has_uncommitted, has_stash, has_unpushed)
 }
 
 // FormatAgentDescription creates a description string from agent fields.
@@ -552,6 +553,12 @@ func FormatAgentDescription(title string, fields *AgentFields) string {
 		lines = append(lines, "role_bead: null")
 	}
 
+	if fields.CleanupStatus != "" {
+		lines = append(lines, fmt.Sprintf("cleanup_status: %s", fields.CleanupStatus))
+	} else {
+		lines = append(lines, "cleanup_status: null")
+	}
+
 	return strings.Join(lines, "\n")
 }
 
@@ -587,6 +594,8 @@ func ParseAgentFields(description string) *AgentFields {
 			fields.HookBead = value
 		case "role_bead":
 			fields.RoleBead = value
+		case "cleanup_status":
+			fields.CleanupStatus = value
 		}
 	}
 
@@ -640,6 +649,26 @@ func (b *Beads) UpdateAgentState(id string, state string, hookBead *string) erro
 	return b.Update(id, UpdateOptions{Description: &description})
 }
 
+// UpdateAgentCleanupStatus updates the cleanup_status field in an agent bead.
+// This is called by the polecat to self-report its git state (ZFC compliance).
+// Valid statuses: clean, has_uncommitted, has_stash, has_unpushed
+func (b *Beads) UpdateAgentCleanupStatus(id string, cleanupStatus string) error {
+	// First get current issue to preserve other fields
+	issue, err := b.Show(id)
+	if err != nil {
+		return err
+	}
+
+	// Parse existing fields
+	fields := ParseAgentFields(issue.Description)
+	fields.CleanupStatus = cleanupStatus
+
+	// Format new description
+	description := FormatAgentDescription(issue.Title, fields)
+
+	return b.Update(id, UpdateOptions{Description: &description})
+}
+
 // DeleteAgentBead permanently deletes an agent bead.
 // Uses --hard --force for immediate permanent deletion (no tombstone).
 func (b *Beads) DeleteAgentBead(id string) error {