grace-status

Show the current state of the GRACE project.

Report Contents

1. Artifacts Status

Check existence and version of:

• AGENTS.md — GRACE principles
• docs/knowledge-graph.xml — version and module count
• docs/requirements.xml — version and UseCase count
• docs/technology.xml — version and stack summary
• docs/development-plan.xml — version and module count
• docs/verification-plan.xml — version and verification entry count
• docs/operational-packets.xml — optional packet template version

2. Codebase Metrics

Scan source files and report:

• Total source files
• Files WITH MODULE_CONTRACT
• Files WITHOUT MODULE_CONTRACT (warning)
• Total test files
• Test files WITH MODULE_CONTRACT
• Total semantic blocks (START_BLOCK / END_BLOCK pairs)
• Unpaired blocks (integrity violation)
• Files with stable log markers
• Test files that assert log markers or traces when relevant

3. Knowledge Graph and Verification Health

Quick check:

• Modules in graph vs modules in codebase
• Any orphaned or missing entries
• Modules in verification plan vs modules in development plan
• Missing or stale verification refs

If the optional grace CLI is available, you may also run grace lint --path <project-root> as a fast integrity snapshot and include any relevant findings in the report.

When the report needs focused navigation instead of raw artifact dumps, you may also use:

• grace module find <query> --path <project-root> to resolve the relevant module from names, IDs, dependencies, or changed paths
• grace module show M-XXX --path <project-root> --with verification for the shared/public module snapshot
• grace file show <path> --path <project-root> --contracts --blocks for the file-local/private markup snapshot

4. Recent Changes

List the 5 most recent CHANGE_SUMMARY entries across source and substantive test files.

5. Suggested Next Action

Based on the status, suggest what to do next:

• If no requirements — "Define requirements in docs/requirements.xml"
• If requirements but no plan — "Run $grace-plan"
• If plan exists but verification is still thin — "Run $grace-verification"
• If plan and verification are ready but modules are missing — "Run $grace-execute or $grace-multiagent-execute"
• If drift detected — "Run $grace-refresh"
• If fast integrity signals are needed before deeper review — "Run grace lint --path <project-root>"
• If the next step is targeted investigation of one module or file — "Run grace module show M-XXX --path <project-root> --with verification or grace file show <path> --path <project-root> --contracts --blocks"
• If tests or logs are too weak for autonomous work — "Run $grace-verification"
• If everything synced — "Project is healthy"