9router-project-checker

Project Checker

Automatically build, test, and review the 9Router project.

Workflow

Follow this exact sequence:

1. Run Build

npm run build

Check for any build errors. Report success or failure immediately.

2. Run Lint (if requested or on commit)

npx eslint . 2>&1 | head -50

Report lint errors if any.

3. Run Tests

npx vitest run

Report test results - passed/failed counts.

4. Review Changes (if git changes exist)

Check for uncommitted or unpushed changes:

git status --short
git diff --cached
git diff

Review the changes following these guidelines:

• Bugs: Logic errors, off-by-one, incorrect conditionals, null/empty/undefined handling
• Security: Injection, auth bypass, data exposure
• Structure: Does code follow existing patterns? Are there established abstractions?
• Performance: Flag if obviously problematic (O(n²), N+1 queries)
• Behavior Changes: Note if changes alter existing behavior

5. Provide Report

Format the report as:

## Project Check Results

### Build: ✅ PASS / ❌ FAIL
[summary]

### Lint: ✅ PASS / ⚠️ WARNINGS / ❌ ERRORS
[count and key issues if any]

### Tests: ✅ PASS (X/Y) / ❌ FAIL (X/Y)
[failed tests if any]

### Code Review: 
[for each file changed]
- **File**: filename
- **Issues**: [list issues found with severity: HIGH/MEDIUM/LOW]
- **Notes**: [behavioral changes, if any]

## Summary
[overall assessment]

Severity Guidelines

• HIGH: Security vulnerability, data loss, complete breakage
• MEDIUM: Feature broken, partial failure, missing router.refresh()
• LOW: Code style, minor improvement, silent error swallowing

Error Handling

If any step fails:

1. Report the failure immediately with error message
2. Do NOT continue to next steps
3. Ask user if they want to fix before continuing

Context

This project uses:

• Next.js 16 with App Router
• Vitest for testing
• ESLint for linting
• lowdb + better-sqlite3 for data persistence
• JWT auth with httpOnly cookies