Source: docs/guides/CONTINUOUS_LINT_MONITOR.md

🔍 Continuous Lint & Error Monitoring System

Purpose: Automated monitoring and error detection for apps/backend/ and frontend applications

📁 Monitored Locations

Backend

Path: /apps/backend/
Language: Python 3.11+
Framework: FastAPI
Key Files:
- server.py - Main application entry
- services/ - Business logic
- tools/ - MCP tool implementations
- routes/ - API route handlers

Frontend

Path: /clients/frontend-001-nextjs-ui-grok-chat-polymarket-micro-betting-altsport-opportunities/
Language: TypeScript/JavaScript
Framework: Next.js 15.5.3
Key Directories:
- app/ - Next.js App Router pages
- lib/ - Utility functions
- components/ - React components

🛠️ Linting Tools & Commands

Backend (Python)

Syntax Check

cd apps/backend
python -m py_compile server.py
python -m py_compile services/**/*.py

Type Checking (if using mypy)

cd apps/backend
mypy server.py --ignore-missing-imports

Code Style (flake8/black)

cd apps/backend
flake8 . --max-line-length=120 --exclude=venv,__pycache__
black . --check

Import Sorting (isort)

cd apps/backend
isort . --check-only

Frontend (Next.js/TypeScript)

TypeScript Type Check

cd clients/frontend-001-nextjs-ui-grok-chat-polymarket-micro-betting-altsport-opportunities
npm run type-check  # or: tsc --noEmit

ESLint

cd clients/frontend-001-nextjs-ui-grok-chat-polymarket-micro-betting-altsport-opportunities
npx eslint . --ext .ts,.tsx,.js,.jsx

Build Check (catches most errors)

cd clients/frontend-001-nextjs-ui-grok-chat-polymarket-micro-betting-altsport-opportunities
npm run build

🤖 Automated Monitoring Script

Quick Lint Script (`lint-all.sh`)

#!/bin/bash
 
echo "🔍 Starting Continuous Lint Check..."
echo ""
 
# Backend linting
echo "📦 Checking Backend (Python)..."
cd apps/backend
python -m py_compile server.py 2>&1
if [ $? -eq 0 ]; then
  echo "✅ Backend: No syntax errors"
else
  echo "❌ Backend: Syntax errors detected!"
fi
echo ""
 
# Frontend linting
echo "🎨 Checking Frontend (Next.js)..."
cd ../../clients/frontend-001-nextjs-ui-grok-chat-polymarket-micro-betting-altsport-opportunities
npm run build 2>&1 | tail -20
if [ $? -eq 0 ]; then
  echo "✅ Frontend: Build successful"
else
  echo "❌ Frontend: Build failed!"
fi
echo ""
 
echo "🏁 Lint check complete"

Watch Mode Script (`watch-lint.sh`)

#!/bin/bash
 
echo "👀 Starting watch mode (checks every 30 seconds)..."
 
while true; do
  clear
  echo "🔍 Continuous Lint Monitor - $(date)"
  echo "========================================="
  echo ""
 
  # Backend check
  cd apps/backend
  python -m py_compile server.py 2>&1
  BACKEND_STATUS=$?
 
  # Frontend check (quick type check only)
  cd ../../clients/frontend-001-nextjs-ui-grok-chat-polymarket-micro-betting-altsport-opportunities
  npm run type-check 2>&1 | tail -5
  FRONTEND_STATUS=$?
 
  echo ""
  echo "========================================="
  if [ $BACKEND_STATUS -eq 0 ] && [ $FRONTEND_STATUS -eq 0 ]; then
    echo "✅ All systems operational"
  else
    echo "⚠️  Issues detected - review above output"
  fi
  echo ""
  echo "Next check in 30 seconds... (Ctrl+C to stop)"
 
  sleep 30
done

🚨 Common Issues & Fixes

Backend Issues

Import Errors

Symptom: ModuleNotFoundError or ImportError Fix:

cd apps/backend
pip install -r requirements.txt
# or with uv:
uv pip install -r requirements.txt

Environment Variables

Symptom: Missing .env file warnings Fix:

cd /path/to/project/root
cp .env.example .env
# Edit .env with actual values

Frontend Issues

Missing Dependencies

Symptom: Cannot find module errors Fix:

cd clients/frontend-001-nextjs-ui-grok-chat-polymarket-micro-betting-altsport-opportunities
npm install --legacy-peer-deps

Type Errors

Symptom: TypeScript compilation errors Fix: Check the specific error message and:

Add missing type definitions
Fix incorrect type usage
Add // @ts-ignore as last resort for third-party issues

Build Warnings (Non-blocking)

Current Warnings:

Missing exports (resolved with fallback implementations)
Deprecated Next.js lint command (informational only)

📊 Pre-Commit Checks

Recommended Git Hook (`.git/hooks/pre-commit`)

#!/bin/bash
 
echo "🔍 Running pre-commit checks..."
 
# Backend syntax check
cd apps/backend
python -m py_compile server.py
if [ $? -ne 0 ]; then
  echo "❌ Backend has syntax errors. Commit aborted."
  exit 1
fi
 
# Frontend type check (fast)
cd ../../clients/frontend-001-nextjs-ui-grok-chat-polymarket-micro-betting-altsport-opportunities
npm run type-check > /dev/null 2>&1
if [ $? -ne 0 ]; then
  echo "⚠️  Frontend has type errors. Consider fixing before committing."
  # Don't abort, just warn
fi
 
echo "✅ Pre-commit checks passed"
exit 0

🔄 CI/CD Integration

GitHub Actions Example (`.github/workflows/lint.yml`)

name: Lint & Type Check
 
on: [push, pull_request]
 
jobs:
  backend-lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-python@v4
        with:
          python-version: '3.11'
      - name: Install dependencies
        run: |
          cd apps/backend
          pip install -r requirements.txt
      - name: Check syntax
        run: |
          cd apps/backend
          python -m py_compile server.py
 
  frontend-lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
        with:
          node-version: '18'
      - name: Install dependencies
        run: |
          cd clients/frontend-001-nextjs-ui-grok-chat-polymarket-micro-betting-altsport-opportunities
          npm install --legacy-peer-deps
      - name: Type check
        run: |
          cd clients/frontend-001-nextjs-ui-grok-chat-polymarket-micro-betting-altsport-opportunities
          npm run type-check
      - name: Build check
        run: |
          cd clients/frontend-001-nextjs-ui-grok-chat-polymarket-micro-betting-altsport-opportunities
          npm run build

📈 Monitoring Dashboard

Key Metrics to Track

Metric	Backend	Frontend
Syntax Errors	`py_compile` exit code	TypeScript errors count
Build Status	N/A	`npm run build` success
Import Issues	ImportError count	Module not found count
Type Coverage	N/A	Types vs any ratio
Dependency Health	`pip check`	`npm audit`

Quick Status Check Command

# One-line health check
cd apps/backend && python -m py_compile server.py && echo "✅ Backend OK" || echo "❌ Backend Error"
 
cd clients/frontend-001-nextjs-ui-grok-chat-polymarket-micro-betting-altsport-opportunities && npm run type-check && echo "✅ Frontend OK" || echo "❌ Frontend Error"

🎯 Best Practices

For Backend Development

Always run python -m py_compile before committing
Test with python server.py locally before deploying
Use type hints consistently
Keep imports organized (use isort)

For Frontend Development

Always run npm run build before pushing
Fix TypeScript errors immediately (don't accumulate tech debt)
Use proper types instead of any
Run Vercel preview deployments for each PR

Error Response Protocol

Syntax Error: Fix immediately (blocks deployment)
Type Error: Fix within 1 day (affects reliability)
Lint Warning: Fix within 1 week (affects maintainability)
Deprecation Warning: Track but don't block (plan migration)

🔧 Tools Installation

Backend Tools

pip install flake8 black mypy isort

Frontend Tools

npm install -g eslint typescript

📞 Quick Reference

Current Status: ✅ All systems operational (as of 2025-09-30)

Backend:

No syntax errors
FastAPI server running
All core endpoints functional

Frontend:

Build successful (1m 13s)
105 pages deployed
0 critical errors
12 non-blocking warnings

Last updated: 2025-09-30 Monitoring: Active

Continuous Deployment & Improvement System AltSports Demo Video Script