| name | sprang-health |
| description | Full structural health report โ health grade, code smells, security issues, risk nodes, orphans, circular dependencies. Use when the user says "/sprang-health", "health report", "code smells", "show risks", "what's broken", "security issues", or "architectural health". |
Full structural health report for the knowledge graph.
- Call
sprang_health to retrieve the full health report.
- Lead with the health grade: display
health_grade (AโF) and health_score (0โ100) prominently. Show the grade breakdown (which factors cost the most points).
- Display graph phase (
skeleton or complete), generated_at timestamp, total nodes, and total edges.
- Present the risk distribution table: high, medium, and low counts. Note if high-risk nodes exceed 10% of total.
- List the top 10 risky nodes with label, type, risk score, and risk factors. Call
sprang_node on any with god_node or circular_dependency warnings for detail.
- List all detected code smell categories from
smell_summary with counts and a one-sentence description of each smell type.
- Report security findings from
security_summary: total count, breakdown by severity (high/medium/low) and by category (hardcoded_secret, sql_injection, xss_risk, etc.). Flag any high severity findings as immediate priorities.
- Report
orphan_count (isolated nodes) and nodes_without_tests as actionable gaps to address.
- If
history has entries, show the score trend (first vs latest snapshot) to indicate whether health is improving or degrading.
- Recommend a prioritized action list: security issues first (if high severity), then smells to address, then nodes to add tests for, then when to re-run
/sprang-analyze.