For Barrot

[Barrot-Agent]

Objective:
Ship a production-usable MVP in one pass:

• Unified search modes: web/code/data
• Citation-backed results
• Connector scaffolding for GitHub, Hugging Face, Databricks
• CSV export endpoint
• Basic usage limiting
• Render deployment config

Repository:

• owner/repo: Barrot-Agent/B-Agent
• branch: main

Required file operations:

1. Create/update:

• package.json
• .env.example
• render.yaml
• src/server.js
• src/routes/health.js
• src/routes/query.js
• src/routes/export.js
• src/services/orchestrator.js
• src/services/connectors/github.js
• src/services/connectors/huggingface.js
• src/services/connectors/databricks.js
• src/services/retrieval/lexical.js
• src/services/retrieval/semantic.js
• src/services/retrieval/rerank.js
• src/services/citations/formatter.js
• src/lib/usageMeter.js
• src/lib/logger.js
• public/index.html
• public/app.js
• public/styles.css
• README.md

2. If repo has existing search modules, preserve compatibility and add adapters rather than breaking old routes.

3. Add npm scripts:

• start
• dev

4. README must include:

• local run steps
• required env vars
• Render deploy steps
• API examples for /api/query, /api/health, /api/export/csv

Acceptance checks (must pass before commit):

• npm install succeeds
• server boots on PORT
• GET /api/health returns connector availability booleans
• POST /api/query with {query, mode} returns results + citations + confidence
• POST /api/export/csv returns downloadable CSV

Security constraints:

• Never print secret values in logs
• Only boolean health status for connectors
• No hardcoded tokens

Commit requirements:

• One clean commit message:
  "feat: launch WebMCP search v2 MVP with connectors, citations, export, and deploy config"

After completion:

• Output changed file list
• Output run instructions
• Output next-step TODOs for Phase 2 (real connector APIs, billing, API keys, observability)