What problem does it solve?
Provides a concise health assessment for GRACE repositories to surface drift, missing contracts, unpaired semantic blocks, and gaps between the knowledge graph and codebase so teams can prioritize fixes and next steps.
Core Features & Use Cases
- Artifacts Status: Verifies presence and versions of AGENTS.md and key docs such as docs/knowledge-graph.xml, docs/requirements.xml, docs/technology.xml, and docs/development-plan.xml.
- Codebase Metrics: Counts total source files, files with and without MODULE_CONTRACT, total semantic blocks, and reports unpaired blocks as integrity violations.
- Knowledge Graph Health: Compares modules declared in the knowledge graph with modules found in the codebase and highlights orphaned or missing entries.
- Recent Changes & Suggestions: Extracts the most recent CHANGE_SUMMARY entries and recommends targeted actions like running grace-plan, grace-generate, grace-execute, grace-multiagent-execute, grace-refresh, or grace-verification based on detected issues.
Quick Start
Generate a project health report for the current GRACE repository and suggest the next actions to resolve detected issues.