Project Health Check

Run a comprehensive health check across the full stack and report any issues.

Usage

/health

Checks

Run all checks and collect results. Do NOT stop on first failure — run everything and present a full report.

1. Lint

bash

bun run lint

2. Type Check

bash

bunx tsc --noEmit

3. Unit Tests

bash

bun run test

4. Git Status

bash

git status

Report: uncommitted changes, untracked files, divergence from remote.

5. Dependencies

bash

bun install --dry-run --frozen-lockfile

Check whether the lockfile would change on install. A non-zero exit indicates a lockfile mismatch — does not verify on-disk node_modules state.

6. Convex Status

Check if Convex is configured (never print the actual values):

bash

test -f .env.local && grep -q '^CONVEX_DEPLOYMENT=' .env.local

Report whether CONVEX_DEPLOYMENT is set or missing — do NOT print its value.

Report Format

Present results as a checklist:

code

## Health Report

- [x] Lint — passed
- [x] Typecheck — passed
- [ ] Tests — 2 failing (describe briefly)
- [x] Git — clean, up to date with remote
- [x] Dependencies — in sync
- [x] Convex — configured

For any failing check, include a brief summary of what's wrong (first few lines of error output, not the full log).

Notes

•Run all checks in parallel where possible for speed
•This is read-only — never fix issues automatically
•If the user wants to fix issues, suggest the appropriate command (e.g., bun run lint:fix, /test)