sc-doctor

name	sc-doctor
description	Diagnose Content Search backend availability by probing the health endpoint, then surface connectivity issues between Flutter and backend when unhealthy. Use when the user says "is the backend up", "check health", "backend unreachable", "debug backend", or "check connectivity".

SC Doctor

Find out whether the Smart Classroom RAG system is healthy and what's broken. Agent: execute every command below directly using your terminal tool and relay the result. If the backend is not up, hand off to sc-up.

Set $BASE = "http://127.0.0.1:9011" (or the value in utils/flutter/assets/.env).

---

1. Is the backend reachable?

$BASE = "http://127.0.0.1:9011"
try {
    $r = Invoke-WebRequest -Uri "$BASE/api/v1/system/health" `
         -UseBasicParsing -TimeoutSec 5
    Write-Host "Status: $($r.StatusCode)"
    $r.Content
} catch {
    Write-Host "UNREACHABLE — $($_.Exception.Message)"
}

• {"status":"ok"} → backend healthy, continue to step 2.
• Connection refused / timeout → nothing is running on port 9011. Use sc-up to start the backend.
• Non-200 status → backend is running but unhealthy. Continue to step 3.

---

2. What services are reported by health?

A detailed health response includes per-service status. Parse it:

$health = Invoke-WebRequest -Uri "$BASE/api/v1/system/health" -UseBasicParsing
$health.Content | ConvertFrom-Json | ConvertTo-Json -Depth 5

Look for any service with "status": "error" or "status": "degraded". Common sub-services: vector store, LLM endpoint, object storage.