gpd-health

Run project health checks by executing the health command, which validates environment, structure, and git status, returning structured JSON with totals, passes, warnings, and failures. Append --fix to automatically repair detected issues.

A repository health check covers environment validation, project structure consistency, storage-path policy compliance, state validity, plan integrity, and git status across typical development workflows to maintain healthy repos.

Yes, you can automatically fix detected project structure and configuration validation errors by running the health command with the --fix option, which reports applied repairs alongside the summary of passes, warnings, and failures.

Validate plan integrity and git status by running the project health check, which executes finite checks for plan frontmatter, checkpoint tags, and git status, then returns a structured JSON report detailing any warnings or failures.

The best way to maintain healthy repos is running comprehensive health checks that validate storage-path policy, state validity, and convention lock integrity, optionally using --fix to auto-repair detected issues and ensure compliance.

Project health check warnings for state validity and config.json occur when the finite checks detect non-compliance or invalid structures. The returned JSON report details these warnings, which can be auto-fixed using the --fix option.