databid CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

Context on Call (running on DataBid infrastructure at databid.io) is an agent-native company intelligence platform. AI agents buy structured, verified company context (capabilities, certifications, capacity, standards) on demand via API. Companies list themselves to get discovered by agents worldwide — "SEO for the agent era."

Current phase: Validation. Seeding first 100 company contexts in manufacturing/supply chain vertical. 13 companies live (3 seeded, 10 scraped). No paying customers yet. See ACTION_PLAN.md for milestones.

Future product: A Context Constructor — guided flow that asks companies the right questions and generates standardized, token-efficient context packs (chunked files + navigation index) sized for agent context windows.

Commands

Requires Node 20+.

# Dev server
npm run dev          # Start dev server (http://localhost:3000)
npm run build        # Production build (runs prisma generate automatically)
npm run lint         # ESLint (flat config, v9)

# Prisma
npx prisma generate                   # Regenerate client after schema changes
npx prisma migrate dev --name <name>  # Create and apply a migration (local dev)
npx prisma db push                    # Push schema to Neon (no advisory lock issues)

# Company scraper (requires ANTHROPIC_API_KEY in .env)
npx tsx scripts/scrape-company.ts "Company Name" "https://example.com"

# List all companies in DB
npx tsx scripts/list-companies.ts

# Seed test companies (3 hardcoded)
npx tsx prisma/seed-companies.ts

No test framework is set up. No test runner commands exist.

Architecture

• Framework: Next.js 16 (App Router) with TypeScript and Tailwind CSS v4. next.config.ts sets output: "standalone" for Docker/containerized deployments. Check node_modules/next/dist/docs/ for breaking changes vs older Next.js.
• Database: PostgreSQL via Prisma ORM v7 (requires @prisma/adapter-pg)
• Auth: NextAuth.js with credentials + Google OAuth, JWT sessions
• Styling: Tailwind v4 CSS-first config (@import "tailwindcss" in globals.css, no tailwind.config.js). Zinc/emerald color palette.
• No component library: src/components/ui/ exists but is empty. All UI is plain Tailwind.
• No middleware: Auth is checked per-route via getServerSession(authOptions), not via Next.js middleware.
• Schema validation: Zod used in MCP tool definitions; API routes use manual if checks.