reporelay AGENTS.md

AGENTS.md — RepoRelay

Self-hosted, MCP-native code context engine for any Git repository — public or private. TypeScript (strict ESM), Fastify, Drizzle ORM, tree-sitter, pg-boss, pgvector/ParadeDB.

Build / Dev / Test Commands

pnpm build                  # tsc — TypeScript compilation
pnpm dev                    # Start everything (Postgres + worker + web + UI)
pnpm dev:worker             # tsx watch src/worker/index.ts
pnpm dev:web                # tsx watch src/web/main.ts — REST API on :3001
pnpm dev:mcp                # tsx src/mcp/main.ts — MCP server (HTTP on :3000)
pnpm dev:ui                 # Angular dashboard on :4200

pnpm test                   # All tests (unit + integration)
pnpm test:unit              # Unit tests only
pnpm test:integration       # Integration tests (requires Docker for Testcontainers)
pnpm test:watch             # Vitest watch mode

Running a single test

npx vitest run src/parser/tree-sitter-parser.test.ts          # single unit test file
npx vitest run src/indexer/pipeline.integration.test.ts        # single integration test file
npx vitest run -t "parses TypeScript functions"                # by test name pattern
npx vitest run --project unit src/core/config.test.ts          # single file, unit project only

Database & Codegen

pnpm db:generate            # drizzle-kit generate — create SQL migrations
pnpm db:migrate             # drizzle-kit migrate — run migrations
pnpm generate:api           # Regenerate types/Zod from openapi.yaml (Kubb + openapi-typescript)

Project Structure

src/
  core/        Config (Zod), types, logger (Pino), progress tracker
  storage/     Drizzle schema, repositories (class-based), pg-boss queue
  git/         Git mirror/fetch, worktree, diff, file classifier, credentials
  parser/      tree-sitter pipeline + per-language extractors + markdown parser
  indexer/     Chunker, embedder, orchestration pipeline
  retrieval/   Hybrid search (BM25 + vector via RRF), context builder, semver resolver
  services/    Shared business logic (used by both MCP + web)
  mcp/         MCP server, tools, resources, prompts
  web/         Fastify REST API (17 routes) + Swagger UI at /docs
  worker/      Background indexing worker (pg-boss handler)
  generated/   Auto-generated from openapi.yaml (types, Zod schemas, route paths)
  e2e/         End-to-end integration tests
test/
  fixtures/    Multi-language sample source code
  setup/       Testcontainers (ParadeDB) + temp Git repo helpers
ui/            Angular 21 admin dashboard (see ui/DESIGN.md for UI design spec)