Quick Start: Dependency & Code Quality Tools

This repository now has comprehensive dependency and code quality detection.

Installation

First, install the new dependencies in each app:

# Controller
cd controller && bun install

# CLI
cd cli && bun install

# Frontend
cd frontend && npm install

Run All Checks

# Controller (6 checks total)
cd controller && bun run check
# ✅ Type check (tsc)
# ✅ Lint (ESLint)
# ✅ Dead code detection (knip)
# ✅ Duplicate code detection (jscpd)
# ✅ Unused dependencies (depcheck)
# ✅ Tests (vitest)

# CLI (6 checks total)
cd cli && bun run check
# Same 6 checks

# Frontend (4 checks)
cd frontend && npm run check
# ✅ Type check (Next.js)
# ✅ Dead code detection (knip)
# ✅ Duplicate code detection (jscpd)
# ✅ Unused dependencies (depcheck)
# Tests run separately: npm test

What Each Tool Does

CI Pipeline

All checks run automatically on every PR:

Pull Request → CI Pipeline → 6 Checks → Pass/Fail
                                    ↓
                        2-3 minutes (parallel jobs)

Quick Commands

# Check for issues before committing
bun run check

# Auto-fix what's possible
bun run check:fix

# Run specific tools
bunx knip           # Dead code
bunx depcheck        # Unused deps
bunx jscpd src       # Duplication
bun run lint:fix     # Code style

What Gets Checked

Dead Code (knip)

• Unused exports
• Unused files
• Unused dependencies
• Unlisted dependencies (used but not in package.json)

Unused Dependencies (depcheck)

• npm packages not imported in code
• Missing dependencies (used but not listed)

Duplicate Code (jscpd)

• Copy-pasted functions
• Similar logic blocks
• Repeated patterns

Stats

Before: No automated dependency detection After: 3 tools, 6 checks per app, 100% coverage

Next Steps

1. Install dependencies: cd controller && bun install
2. Run checks: bun run check
3. Fix any issues found
4. Commit with confidence! 🚀

---

Generated: 2025-01-25