flow.doctor

User Input

$ARGUMENTS

Arguments:

• Empty: Run diagnostics only (detect version, health check)
• migrate: Run full migration with intelligent analysis
• --dry-run: Preview migration without changes

You MUST consider the user input before proceeding (if not empty).

Goal

Diagnose SpecFlow project state and optionally guide through migration:

1. Detect current version (v1.0, v2.0, v3.0, or uninitialized)
2. Analyze project health and compliance
3. If migrating: run CLI upgrade + intelligent analysis
4. Generate actionable migration guide with findings

---

Step 1: Detect Project Version

Run version detection:

specflow upgrade --dry-run --json

Parse the JSON to understand:

• detection.version: Current version (v1.0, v2.0, v3.0, uninitialized)
• detection.confidence: How certain we are (high, medium, low)
• detection.indicators: What signals were found

Handle Special Cases

If uninitialized:

No SDD artifacts found in this repository.

This project has not been initialized with SpecFlow.

Would you like to:
1. Initialize as a new SpecFlow project → Run /flow.init
2. Exit and initialize manually

Use AskUserQuestion to get user choice.

If already v3.0:

This project is already at SpecFlow v3.0.

Run `specflow check` to validate project health.

Stop unless migrate was specified (to re-run analysis).

---

Step 2: Show Version Analysis

Display current state:

# Project Diagnosis

## Version Detection

| Property        | Value        |
| --------------- | ------------ |
| Current Version | {version}    |
| Confidence      | {confidence} |
| Target Version  | v3.0         |

## Indicators Found

{list indicators}

## Required Migration Steps

{list steps from getMigrationSteps()}

If just running diagnostics (no migrate argument), show this and ask:

• "Run full migration?" → Proceed to Step 3
• "Exit" → Stop

---

Step 3: Run CLI Upgrade

If migrating, run the CLI upgrade command: