table alias, because
`whereKey()` and `whereRelation()` qualify columns with the table name, which Postgres
rejects under an alias. `tests/Arch/ConventionsTest.php` fails when a public method
outside a model, enum, or `Scope
Spec: `spec/openapi-dashboard.yml`; team reads, template tags, builds, `/v1/management`, deprecated admin team bootstrap
- Talks to Postgres and ClickHouse; never to orchestrators (see `docs/ARCHITECTURE.md`)
- Port: 3010
**Orchestrator (`packages/orchestrator/`)** - Firecracker microVM orchestration
- Entry
guidance to Claude Code (claude.ai/code) when working with code in this repository.
## Overview
postgres-meta is a RESTful API for managing PostgreSQL databases. It provides a normalized interface over
access is routed through Caddy reverse proxy on ports 80/443.
- **Shared secrets**: Core services (Postgres, Valkey (Redis-compatible, container named `redis` for backward compatibility), Caddy) are always included. Other services
crates/test-support/tests/`. They boot the full server in-process against a fresh per-test Postgres database and a dedicated Redis logical DB (1 by default). Each test fn carries `#[ignore
name, and not a run.
- "Where's the auth logic?", "does it use Postgres?", "which file sends the
email?" → `search_repo`, then `read_file` on a hit with `around
First-time setup after clone
```bash
bun install
bun run dev # zero-config: embedded Postgres (pglite), server + web concurrently
```
Or self-host via Docker: `docker compose up` (real Postgres, port
governance platform. It onboards, orchestrates, and secures third-party AI agents using a Postgres-backed message store as the internal message bus. Agents register via the Agent Bridge
Production server on port 8000
just test # Run pytest with marker (e.g., just test postgres)
just lint # ruff format check + ruff check
just format # ruff auto-fix + taplo
```
Available test
overview
Open BSP API — a multi-tenant WhatsApp Business Platform integration built with
Deno, Postgres, and Supabase Edge Functions. See README.md for full details.
## Local checks must match CI (deno
A file Claude Code reads at the start of every session. It holds the commands, conventions and warnings the agent needs for this project.
Where does it go?
At the repository root. Claude Code also reads CLAUDE.md files in subdirectories when it works there.
What should it contain?
Build and test commands, the project's layout, conventions that aren't obvious from the code, and mistakes to avoid. Short files tend to work better than long ones.
CLAUDE.md or AGENTS.md?
Claude Code reads CLAUDE.md; most other agents read AGENTS.md. Many projects keep one and point the other at it.