5cf1d4f813
Adds ZFC-compliant guardrail: when closing issues as 'done', verify commits reference the issue ID. Agent makes the judgment call on legitimate exceptions (already fixed, duplicate, deferred). Closes gt-vmk7. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
148 lines
4.6 KiB
YAML
148 lines
4.6 KiB
YAML
# 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 |
|
|
| nudge_text | No | Text to send when nudging (default: "How's progress?...") |
|
|
version: 1
|
|
|
|
variables:
|
|
- name: polecat_name
|
|
required: true
|
|
description: Name of the polecat to inspect
|
|
- name: rig
|
|
required: true
|
|
description: Rig containing the polecat
|
|
- name: nudge_text
|
|
required: false
|
|
default: "How's progress? Need any help?"
|
|
description: Text to send when nudging the polecat
|
|
|
|
steps:
|
|
- id: capture
|
|
title: Capture polecat state
|
|
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
|
|
title: Assess work status
|
|
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
|
|
title: Load intervention 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
|
|
title: Decide intervention action
|
|
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
|
|
title: Execute intervention
|
|
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
|
|
|
|
# Verify productive work (for 'done' closures)
|
|
git log --oneline --grep='<issue-id>' | head -1
|
|
```
|
|
|
|
**Commit verification** (ZFC principle - agent makes the call):
|
|
- If issue closed as 'done' but no commits reference it → flag for review
|
|
- Legitimate exceptions: already fixed elsewhere, duplicate, deferred
|
|
- Agent must provide justification if closing without commits
|
|
|
|
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.
|