doctor

name	doctor
description	Health check for next-level — verifies config, dependencies, hooks, and state directories
user-invocable	true

/next-level:doctor

You are running the next-level health check. Verify everything is properly configured and report status.

Checks to Run

Run each check and collect results. Use these status indicators:

• OK — check passed
• WARN — non-critical issue, things will work but not optimally
• FAIL — critical issue, feature will not work

Check 1: Configuration File

python3 -c "
import sys
sys.path.insert(0, '${CLAUDE_PLUGIN_ROOT}/lib')
from config import exists, read
if not exists():
    print('FAIL: No config found at ~/.next-level/config.json')
    print('FIX: Run /next-level:setup')
else:
    cfg = read()
    if not cfg.get('setup_complete'):
        print('FAIL: Config exists but setup_complete is false')
        print('FIX: Run /next-level:setup')
    else:
        print('OK: Config found, setup complete')
        print('Last updated: ' + cfg.get('last_updated', 'unknown'))
        print('Languages: ' + ', '.join(cfg.get('languages_detected', [])))
"

Check 2: Dependencies Still Present

python3 -c "
import sys
sys.path.insert(0, '${CLAUDE_PLUGIN_ROOT}/lib')
from dependencies import full_dependency_check, check_binary
from config import read

cfg = read()
project_root = cfg.get('project_root', '.')
result = full_dependency_check(project_root)

if result['missing_tools']:
    for t in result['missing_tools']:
        print(f\"WARN: {t['language']}/{t['tool']} not found — {t['install']}\")
else:
    print('OK: All language tools available')

if not check_binary('jq'):
    print('WARN: jq not installed (needed for bash hooks)')
    print('FIX: brew install jq')
else:
    print('OK: jq available')
"

Check 3: Hook Scripts Executable

Check that all hook scripts in ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/ are executable:

found_issue=false
for script in "${CLAUDE_PLUGIN_ROOT}"/hooks/scripts/*.sh "${CLAUDE_PLUGIN_ROOT}"/hooks/scripts/*.py; do
  if [ -f "$script" ] && [ ! -x "$script" ]; then
    echo "WARN: $script is not executable"
    echo "FIX: chmod +x $script"
    found_issue=true
  fi
done
if [ "$found_issue" = false ]; then
  echo "OK: All hook scripts are executable"
fi

Check 4: State Directories

state_dir="${HOME}/.next-level"
if [ -d "$state_dir" ]; then
  echo "OK: State directory exists at $state_dir"
  if [ -w "$state_dir" ]; then
    echo "OK: State directory is writable"
  else
    echo "FAIL: State directory is not writable"
    echo "FIX: chmod u+w $state_dir"
  fi
else
  echo "WARN: State directory does not exist (will be created on first use)"
fi

# Check specs and sessions subdirs
for subdir in specs sessions; do
  if [ -d "$state_dir/$subdir" ]; then
    echo "OK: $state_dir/$subdir exists"
  else
    echo "WARN: $state_dir/$subdir does not exist (will be created on first use)"
  fi
done

Check 5: Stale Config Detection

python3 -c "
import sys, os
sys.path.insert(0, '${CLAUDE_PLUGIN_ROOT}/lib')
from config import read
from dependencies import detect_languages

cfg = read()
project_root = cfg.get('project_root', '.')
current_langs = detect_languages(project_root)
config_langs = cfg.get('languages_detected', [])

if set(current_langs) != set(config_langs):
    print(f'WARN: Language mismatch — config has {config_langs}, project has {current_langs}')
    print('FIX: Run /next-level:setup to refresh')
else:
    print('OK: Config languages match project')
"

Check 6: Coding Agent Configuration

AGENT_FILE="${CLAUDE_PLUGIN_ROOT}/agents/coding-agent.md"
if [ -f "$AGENT_FILE" ]; then
  echo "OK: coding-agent.md exists"
  if head -20 "$AGENT_FILE" | grep -q "hooks:"; then
    echo "OK: coding-agent.md has hooks in frontmatter"
  else
    echo "WARN: coding-agent.md missing hooks in frontmatter — team enforcement won't work"
  fi
else
  echo "WARN: coding-agent.md not found — team-execute will use general-purpose agents"
fi

Check 7: Hook Events Registered

HOOKS_FILE="${CLAUDE_PLUGIN_ROOT}/hooks/hooks.json"
if [ ! -f "$HOOKS_FILE" ]; then
  echo "FAIL: hooks.json not found"
else
  expected_events="SessionStart PreToolUse PostToolUse Stop PreCompact SessionEnd SubagentStart SubagentStop TeammateIdle TaskCompleted"
  missing=""
  for event in $expected_events; do
    if ! grep -q "\"$event\"" "$HOOKS_FILE"; then
      missing="$missing $event"
    fi
  done
  if [ -z "$missing" ]; then
    echo "OK: All expected hook events registered (10 events)"
  else
    echo "WARN: Missing hook events:$missing"
  fi
fi

Check 8: Plugin Status

python3 -c "
import sys
sys.path.insert(0, '${CLAUDE_PLUGIN_ROOT}/lib')
from dependencies import detect_plugins

plugins = detect_plugins()
for name, available in plugins.items():
    status = 'OK' if available else 'WARN'
    state = 'installed' if available else 'not installed (optional)'
    print(f'{status}: {name} — {state}')
"

Report Format

After running all checks, present a summary:

next-level doctor report
========================

Configuration:  OK
Dependencies:   OK (2 warnings)
Hook Scripts:   OK
State Dirs:     OK
Config Fresh:   OK
Coding Agent:   OK
Hook Events:    OK (10 events)
Plugins:        WARN (omega-memory not installed)

Warnings:
  - omega-memory not installed (optional — enhanced session memory)
  - coderabbit not installed (optional — AI code review)

Overall: HEALTHY (2 optional warnings)

Use HEALTHY if no FAIL results, DEGRADED if any WARN results exist, and UNHEALTHY if any FAIL results exist.

For each FAIL or WARN, include the fix command or action.