doctor-fix

name	doctor-fix
description	Run Evoloop doctor checks and auto-fix common issues — missing directories, non-executable scripts, missing templates, and provide remediation for manual fixes
disable-model-invocation	true
allowed-tools	["Read","Glob","Grep","Bash","Edit","Write"]

Doctor Auto-Fix

Step 1: Run Doctor

Run ./scripts/doctor.sh --verbose. If missing/not executable → "Run ./scripts/bootstrap-plan.sh".

Step 2: Categorize Issues

Auto-fixable:

Issue	Fix
Missing directory (.log/, .state/, .plan/areas/, .plan/templates/)	mkdir -p
Script not executable	chmod +x
Missing templates in .plan/templates/	Run ./scripts/bootstrap-plan.sh
Malformed JSON (formatting)	Read with jq, rewrite

Manual (provide file:line + remediation):

• TODO/TBD/FIXME in planning docs → show exact location, suggest replacement
• Missing REQ-### IDs → show where to add, reference existing
• Areas not approved → suggest ./orchestrator.sh plan area --area <name>
• Missing planning docs → list which, explain contents
• Dependency cycles → show cycle, suggest removal
• Missing tools (jq, rg) → brew install jq ripgrep
• Missing runner tools → show which CLI per runners.json
• Story schema/deploy contract violations → show story ID + invalid field

Step 3: Confirm & Apply

Show summary (N issues, M auto-fixable, K manual). Ask confirmation. Apply fixes, report each.

Step 4: Manual Guide

For each manual issue: file:line, issue text, concrete fix.

Step 5: Re-Verify

Run ./scripts/doctor.sh again. Report "All passing" or "K remaining (manual)".