Add patrol formula YAML files (gt-ingm.1)

Create initial formula definitions for patrol molecules: - mol-deacon-patrol: Mayor daemon loop (8 steps) - mol-witness-patrol: Christmas Ornament pattern with dynamic bonding (9 steps) - mol-refinery-patrol: Merge queue processor with verification gates (10 steps) - mol-polecat-arm: Single polecat inspection cycle for witness bonding (5 steps) These replace the embedded markdown in molecules_patrol.go with proper formula YAML files that can be cooked into proto beads. Generated with Claude Code Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-24 13:00:04 -08:00
parent c116613a72
commit 1ba425eac8
4 changed files with 720 additions and 0 deletions
@@ -0,0 +1,128 @@
+# Polecat Arm: Single polecat inspection cycle
+# Dynamically bonded by mol-witness-patrol for each polecat being monitored.
+
+formula: mol-polecat-arm
+description: |
+  Single polecat inspection and action cycle.
+
+  This molecule is bonded dynamically by mol-witness-patrol's survey-workers step.
+  Each polecat being monitored gets one arm that runs in parallel with other arms.
+
+  ## Variables
+
+  | Variable | Required | Description |
+  |----------|----------|-------------|
+  | polecat_name | Yes | Name of the polecat to inspect |
+  | rig | Yes | Rig containing the polecat |
+version: 1
+
+variables:
+  - name: polecat_name
+    required: true
+    description: Name of the polecat to inspect
+  - name: rig
+    required: true
+    description: Rig containing the polecat
+
+steps:
+  - id: capture
+    description: |
+      Capture recent tmux output for {{polecat_name}}.
+
+      ```bash
+      tmux capture-pane -t gt-{{rig}}-{{polecat_name}} -p | tail -50
+      ```
+
+      Record:
+      - Last activity timestamp (when was last tool call?)
+      - Visible errors or stack traces
+      - Completion indicators ("Done", "Finished", etc.)
+
+  - id: assess
+    needs: [capture]
+    description: |
+      Categorize polecat state based on captured output.
+
+      States:
+      - **working**: Recent tool calls, active processing
+      - **idle**: At prompt, no recent activity
+      - **error**: Showing errors or stack traces
+      - **requesting_shutdown**: Sent LIFECYCLE/Shutdown mail
+      - **done**: Showing completion indicators
+
+      Calculate: minutes since last activity.
+
+  - id: load-history
+    needs: [assess]
+    description: |
+      Read nudge history for {{polecat_name}} from patrol state.
+
+      ```
+      nudge_count = state.nudges[{{polecat_name}}].count
+      last_nudge_time = state.nudges[{{polecat_name}}].timestamp
+      ```
+
+      This data was loaded by the parent patrol's load-state step and passed
+      to the arm via the bonding context.
+
+  - id: decide
+    needs: [load-history]
+    description: |
+      Apply the nudge matrix to determine action for {{polecat_name}}.
+
+      | State | Idle Time | Nudge Count | Action |
+      |-------|-----------|-------------|--------|
+      | working | any | any | none |
+      | idle | <10min | any | none |
+      | idle | 10-15min | 0 | nudge-1 (gentle) |
+      | idle | 15-20min | 1 | nudge-2 (direct) |
+      | idle | 20+min | 2 | nudge-3 (final) |
+      | idle | any | 3 | escalate |
+      | error | any | any | assess-severity |
+      | requesting_shutdown | any | any | pre-kill-verify |
+      | done | any | any | pre-kill-verify |
+
+      Nudge text:
+      1. "How's progress? Need any help?"
+      2. "Please wrap up soon. What's blocking you?"
+      3. "Final check. Will escalate in 5 min if no response."
+
+      Record decision and rationale.
+
+  - id: execute
+    needs: [decide]
+    description: |
+      Take the decided action for {{polecat_name}}.
+
+      **nudge-N**:
+      ```bash
+      tmux send-keys -t gt-{{rig}}-{{polecat_name}} "{{nudge_text}}" Enter
+      ```
+
+      **pre-kill-verify**:
+      ```bash
+      cd polecats/{{polecat_name}}
+      git status                    # Must be clean
+      git log origin/main..HEAD     # Check for unpushed
+      bd show <assigned-issue>      # Verify closed/deferred
+      ```
+      If clean: kill session, remove worktree, delete branch
+      If dirty: record failure, retry next cycle
+
+      **escalate**:
+      ```bash
+      gt mail send mayor/ -s "Escalation: {{polecat_name}} stuck" -m "..."
+      ```
+
+      **none**: No action needed.
+
+      Record: action taken, result, updated nudge count.
+
+      ## Output
+
+      The arm completes with:
+      - action_taken: none | nudge-1 | nudge-2 | nudge-3 | killed | escalated
+      - result: success | failed | pending
+      - updated_state: New nudge count and timestamp for {{polecat_name}}
+
+      This data feeds back to the parent patrol's aggregate step.