services`
(`py-run-tests` = `uv sync --locked && uv run --no-sync python run-tests.py`).
- Postgres is reachable locally with `username:password`; EE DB name is `agenta_ee_core`.
- Tests mint ephemeral
Listen to realtime updates from a Supabase PostgreSQL database. Handles channels, presence, broadcast, and Postgres CDC subscriptions.
When helping a user work with this package:
- **Usage and quick start**: [`README.md
users only.
- Recommended local app dev is `bun run dev:docker`; it boots local Postgres and Redis with shared Clerk dev defaults from `.env.dev`.
- Maintainer dev is `bun dev` with
Test Commands
- Install: `just install` or `pip install -e ".[dev]"`
- Run all tests (SQLite + Postgres): `just test`
- Run all tests against SQLite: `just test-sqlite`
- Run all tests against Postgres
task")` with current status
## Provider Pipeline (Context Engine)
External data sources (GitHub, GitLab, Jira, Postgres, MCP bridges, custom REST) are first-class citizens.
All provider data flows through the same
modules/` for the relevant family (e.g., CheckpointStore
backends: `InMemory` + `Sqlite` ship in `modules/checkpoint/src/main/**`, and `Postgres`
ships as the separate `modules/checkpoint-postgres` reactor module; Redis is pluggable
prevent infinite hook loops
3. Enable transactions for MongoDB (requires replica set) and Postgres
4. Use `beforeValidate` for data formatting
5. Use `beforeChange` for business logic
### Type Safety
migrations** live in `observal-server/clickhouse/migrations/*.sql` and run through `services.clickhouse.migrations`. Keep Alembic for Postgres only. Never add ClickHouse DDL to startup code. The init container runs ClickHouse migrations after
against an expected string.
4. **Dialect Compatibility**: If the feature syntax varies by database (Postgres vs MySQL):
- Add a method to the `Dialect` interface in `core/internal/dialect`.
- Implement it in `postgres.go
credentials are required:
```bash
pnpm run test:e2e:event-log-race-repro:local # world-postgres
pnpm run test:e2e:event-log-race-repro:local --world local # world-local
```
The script
interface,
update this file first — the test cases here become the spec the
Redis / Postgres adapters must also satisfy.
## Coding conventions
- Use named exports throughout. No default exports
state in PostgreSQL using
the [`pg`](https://www.npmjs.com/package/pg) client. Pick this adapter when:
- Postgres is already your primary datastore and you don't want to
add Redis
Repository Guidelines
Postgres logical-replication engine. `etl` is the library, `etl-replicator` is
the standalone binary, and `etl-destinations` holds built-in destinations.
Product docs: https://supabase.github.io/etl/. Human walkthrough
docs/mcp_protocol_specs.md` for any questions about the MCP protocol in general. For anything relating to Postgres, be sure to read `third_party_docs/POSTGRES18_AND_PYTHON_BEST_PRACTICES.md`.
We load all configuration details from the existing