app/
  page.tsx              landing + free playground
  pricing/ docs/ dashboard/
  api/
    v1/lookup   POST {url}   → metered, Bearer key
    v1/batch    POST {urls}  → up to 25 URLs
    scan        playground (no key, 3/day per IP)
    key         issue/rotate a user's API key
    stripe/     checkout · portal · webhook
    auth/       Auth.js handlers
lib/
  engine/       detect.ts · curated-list.ts · custom-patterns.ts · fingerprints.json
  api-auth.ts   key auth + atomic monthly metering
  plans.ts keys.ts prisma.ts stripe.ts
packages/mcp/   the published MCP server
scripts/
  build-fingerprints.ts   regenerate fingerprints.json from upstream
  eval-engine.ts          detection accuracy harness (25 known sites)
  test-funnel.ts          end-to-end: key → free tier → 429 → upgrade
  test-mcp.ts             drives the MCP server over stdio

npm install
cp .env.example .env          # fill in the values

# local Postgres
docker run -d --name forency-pg \
  -e POSTGRES_USER=forency -e POSTGRES_PASSWORD=forency -e POSTGRES_DB=forency \
  -p 5433:5432 postgres:16-alpine

npx prisma migrate dev
npm run dev

npx tsx scripts/eval-engine.ts              # detection accuracy (25/25 expected)
npx tsx scripts/eval-engine.ts example.com  # scan one site, full JSON

# with the dev server running:
npx tsx scripts/test-funnel.ts              # billing funnel end to end
cd packages/mcp && npm run build && cd ../..
npx tsx scripts/test-mcp.ts                 # MCP server over stdio

npx tsx scripts/build-fingerprints.ts