Competitor AI Visibility Gap Tool

Each client gets a separate account and workspace: register or sign in, then set brand and competitors at /settings/brand. Pipeline runs, trends, scheduler jobs, and CSV exports are stored per workspace. Copy .env.example to .env, run migrations and seed for a demo user.

• npm install
• npx prisma migrate deploy && npm run db:seed
• Quality gate (lint + TypeScript + Vitest): npm run check
• Optional: npm run test:all runs check plus Playwright; use E2E_AUTH=1 with a seeded DB for the signed-in smoke paths.
• npm run dev
• Phase 3 debug: /api/debug/extract-cluster?text=best%20seo%20tool%20vs%20alternatives
• Phase 4 dashboard: /dashboard
• Phase 5 reports: /reports and POST /api/debug/trends/run
• Unified run: POST /api/debug/pipeline/run?query=seo%20tool&limit=2
• Ops monitor: /ops and POST /api/debug/scheduler/run
• Sign in: /login · Brand form: /settings/brand