workflow-repair

/workflow repair - State Recovery Command

Use when:

• /feature continue or /epic continue fails unexpectedly
• state.yaml has invalid phase or status
• domain-memory.yaml has stale locks
• Workflow appears stuck with no clear error
• Need to reset to a known good state

Active Workflows: !find specs epics -name "state.yaml" -exec dirname {} \; 2>/dev/null | head -5

Recent State Files: !find specs epics -name "state.yaml" -mmin -60 2>/dev/null | head -3

Locked Features (potential stale locks): !grep -l "locked_by:" specs/*/domain-memory.yaml epics/*/domain-memory.yaml epics/*/sprints/*/domain-memory.yaml 2>/dev/null | head -5

auto (Default)

Automatically diagnose and fix common issues:

1. Detect workflow type and location
2. Run all diagnostic checks
3. Apply safe fixes automatically
4. Report what was fixed

diagnose

Only diagnose - don't fix anything:

1. Check state.yaml validity
2. Check domain-memory.yaml consistency
3. Check artifact presence vs phase claims
4. Report issues found

reset-phase <phase_name>

Reset workflow to specific phase:

1. Update state.yaml to specified phase
2. Clear phase completion markers after that phase
3. Preserve artifacts from completed phases

clear-locks

Clear all stale locks in domain-memory.yaml:

1. Find all locked features
2. Remove lock metadata
3. Reset feature status to previous state

rebuild-state

Rebuild state.yaml from artifacts:

1. Scan for existing artifacts (spec.md, plan.md, tasks.md)
2. Infer completed phases from presence
3. Generate new state.yaml

Step 1: Detect Active Workflow

# Find most recent active workflow
WORKFLOW_INFO=$(bash .spec-flow/scripts/utils/detect-workflow-paths.sh 2>/dev/null)

if [ -z "$WORKFLOW_INFO" ]; then
    echo "No active workflow detected."
    echo "Looking for any workflow with state.yaml..."

    # Fallback: find any state.yaml
    STATE_FILE=$(find specs epics -name "state.yaml" -type f 2>/dev/null | head -1)

    if [ -z "$STATE_FILE" ]; then
        echo "No workflows found. Nothing to repair."
        exit 0
    fi

    WORKFLOW_DIR=$(dirname "$STATE_FILE")
else
    WORKFLOW_DIR=$(echo "$WORKFLOW_INFO" | jq -r '"\(.base_dir)/\(.slug)"')
fi

echo "Repairing workflow at: $WORKFLOW_DIR"