imbi-common 0.1.0__tar.gz

imbi_common-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,53 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - 'justfile'
+      - 'mkdocs.yml'
+      - 'pyproject.toml'
+      - '.github/workflows/docs.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v5
+      - name: Install just
+        uses: extractions/setup-just@v2
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: 3.14
+          enable-cache: true
+      - name: Build documentation
+        run: just docs
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./site
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

imbi_common-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,45 @@
+name: Publish to PyPI
+on:
+  release:
+    types: [published]
+
+permissions:
+  id-token: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python
+        run: uv python install 3.14
+
+      - name: Build
+        run: uv build
+
+      - name: Upload dist
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - name: Download dist
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish package
+        uses: pypa/gh-action-pypi-publish@release/v1

imbi_common-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,54 @@
+name: Testing
+on:
+  pull_request:
+  push:
+    branches: [ "main" ]
+    paths-ignore:
+      - 'docs/**'
+      - '*.md'
+    tags-ignore: [ "*" ]
+
+jobs:
+  lint:
+    name: "Static Analysis"
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v5
+      - name: Install just
+        uses: extractions/setup-just@v2
+        with:
+          just-version: '1.47.1'
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+      - name: Run linters
+        run: just lint
+
+  test:
+    name: "Automated Tests"
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python: [ "3.14" ]
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v5
+      - name: Install just
+        uses: extractions/setup-just@v2
+        with:
+          just-version: '1.47.1'
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "${{ matrix.python }}"
+          enable-cache: true
+      - name: Test with python ${{ matrix.python }}
+        run: just test
+      - name: Upload Coverage
+        uses: codecov/codecov-action@v5
+        with:
+          files: ./build/coverage.xml
+          flags: unittests

imbi_common-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+.*
+/build
+/dist
+/docs/superpowers
+/public
+/site
+VERSION
+!/.github
+!/.gitignore
+!/.pre-commit-config.yaml

imbi_common-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,36 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+      - id: check-merge-conflict
+      - id: check-toml
+      - id: debug-statements
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.6
+    hooks:
+      - id: ruff-check
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/tombi-toml/tombi-pre-commit
+    rev: v0.7.25
+    hooks:
+      - id: tombi-format
+
+  - repo: local
+    hooks:
+      - id: mypy
+        name: mypy
+        language: system
+        types: [python]
+        pass_filenames: false
+        entry: uv
+        args:
+          - run
+          - mypy
+          - src

imbi_common-0.1.0/CLAUDE.md

@@ -0,0 +1,75 @@
+# AGENTS.md
+
+This file provides guidance to Agents (eg, Claude Code) when working with code in this repository.
+
+## Commands
+
+This project uses `just` as a task runner and `uv` for Python package management.
+
+```bash
+just setup        # Install dependencies and pre-commit hooks
+just docker       # Bootstrap the docker environment and setup database schema
+just test         # Run full test suite with coverage (requires Docker)
+just test <file>  # Run specific test file(s) without coverage
+just lint         # Run all linters via pre-commit
+just format       # Reformat code (ruff + tombi)
+just docs         # Generate documentation into `site`
+just clean        # Tear down Docker, remove .env and build artifacts
+just real-clean   # Remove .venv and all caches (prompts for confirmation)
+```
+
+The `just test` target automatically starts Docker services (PostgreSQL with AGE + ClickHouse), creates a `.env` file with connection URLs, and runs coverage. When running specific files, the `.env` must already exist or env vars must be set.
+
+Running individual tests (e.g., during iteration):
+
+```bash
+just test tests/path/to/test_file.py
+just test tests/path/to/test_file.py::TestClass::test_method
+```
+
+## Architecture
+
+`imbi-common` is a shared library consumed by `imbi-api`, `imbi-gateway`, and `imbi-mcp`. Source lives in `src/imbi_common/`, tests in `tests/`.
+
+### Module map
+
+| Module               | Purpose                                                                                                                                                                                                     |
+| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `graph/`             | Apache AGE subpackage — re-exports `Graph`, `Pool`, `SearchResult`, `parse_agtype`, `graph_lifespan` from `__init__.py`                                                                                    |
+| `graph/client.py`    | `Graph` class with psycopg v3 pool and high-level methods (`create`, `delete`, `match`, `merge`, `execute`)                                                                                                |
+| `graph/cypher.py`    | Cypher query generation from Pydantic models — `create`, `delete`, `match`, `merge` return `Statement` named tuples with templates and parameters                                                          |
+| `graph/embeddings.py`| fastembed `TextEmbedding` wrapper for generating vector embeddings                                                                                                                                          |
+| `graph/chunk.py`     | Text chunking utilities for embedding pipelines                                                                                                                                                             |
+| `graph/initializer.py`| Graph database initialization from `schemata.toml` — creates extensions, graphs, vlabels, indexes, embeddings table, and functions                                                                         |
+| `clickhouse/`        | ClickHouse async client singleton with `query()` / `insert()`, schema setup via `schemata.toml`, and privacy utilities                                                                                     |
+| `valkey.py`          | Valkey async client integration — exposes `valkey_lifespan` and `Client` (FastAPI DI alias) wrapping `valkey.asyncio.Valkey`                                                                              |
+| `models.py`          | Pydantic domain models (`Project`, `Team`, `Environment`, `Organization`, `ProjectType`, `Blueprint`) with `Edge` dataclass metadata for graph relationships                                                |
+| `blueprints.py`      | Runtime schema extension system — loads `Blueprint` nodes from the graph and uses `pydantic.create_model` to dynamically add fields to existing models                                                      |
+| `settings.py`        | Pydantic Settings classes (`Postgres`, `Clickhouse`, `Valkey`, `Auth`) plus `Configuration` for TOML file loading. Settings pick up env vars with prefixes `POSTGRES_`, `CLICKHOUSE_`, `VALKEY_`, `IMBI_AUTH_` |
+| `auth/core.py`       | JWT creation (`create_access_token`, `create_refresh_token`) and verification (`verify_token`)                                                                                                              |
+| `auth/encryption.py` | Fernet symmetric encryption for sensitive tokens via `TokenEncryption` singleton; module-level `encrypt_token`/`decrypt_token` helpers                                                                      |
+| `server.py`          | Typer/uvicorn `serve()` command and `bind_entrypoint()` helper for building service CLIs                                                                                                                    |
+| `logging.py`         | Logging configuration loader using `log-config.toml`                                                                                                                                                        |
+| `helpers.py`         | Small utility functions                                                                                                                                                                                     |
+
+### Key patterns
+
+**Singletons**: `Clickhouse.get_instance()`, `TokenEncryption.get_instance()`, and `settings.get_auth_settings()` all use class-level singletons. Tests that need clean state must reset them explicitly (e.g., `TokenEncryption.reset_instance()`). `Graph` is instantiated directly (no singleton).
+
+**Graph + edges**: Models use `typing.Annotated` with `models.Edge(rel_type=..., direction=...)` metadata to declare graph relationships. `graph/client.py` tries `model_validate()` first when deserializing raw node data; if that raises `ValidationError` (e.g. due to missing edge fields stored as separate relationships), it falls back to `model_construct()`.
+
+**Blueprint system**: `blueprints.get_model(database, MyModel)` accepts a `Graph` instance and a model class, fetches `Blueprint` nodes from the graph whose `type` matches the model class name, then calls `pydantic.create_model` to return a dynamically extended subclass.
+
+**Settings loading order**: Each `BaseSettings` subclass reads from `.env` file and environment variables with its prefix. `Configuration` additionally supports `config.toml` checked in order: `./config.toml` → `~/.config/imbi/config.toml` → `/etc/imbi/config.toml`.
+
+**ClickHouse schema**: DDL is defined in `src/imbi_common/clickhouse/schemata.toml` and executed via `Clickhouse.setup_schema()` (called explicitly during setup, not on every startup).
+
+**PostgreSQL schema**: Database init scripts live in `schema/postgres/` and are mounted into the Docker container's `/docker-entrypoint-initdb.d/`.
+
+## Code style
+
+- Line length: 79 characters
+- Quote style: single quotes
+- Type checking: strict (basedpyright + mypy)
+- Test coverage minimum: 90%
+- `ruff` rules include bandit (`S`), but `S` rules are disabled in test files

imbi_common-0.1.0/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, AWeber
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

imbi_common-0.1.0/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: imbi-common
+Version: 0.1.0
+Summary: Shared library for the Imbi ecosystem providing core data access, authentication primitives, and domain models
+Author-email: "Gavin M. Roy" <gavinr@aweber.com>, Dave Shawley <daves@aweber.com>
+License-Expression: BSD-3-Clause
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.14
+Requires-Dist: cryptography>=42.0.4
+Requires-Dist: jsonschema-models
+Requires-Dist: markdown-it-py>=3.0
+Requires-Dist: nanoid>=2.0.0
+Requires-Dist: orjson
+Requires-Dist: pydantic-settings
+Requires-Dist: pydantic[email]>=2.0
+Requires-Dist: pyjwt>=2.10.1
+Requires-Dist: python-slugify
+Requires-Dist: typer>=0.21.1
+Provides-Extra: databases
+Requires-Dist: clickhouse-connect[async]==0.12rc1; extra == 'databases'
+Requires-Dist: fastembed>=0.6; extra == 'databases'
+Requires-Dist: pgvector>=0.3; extra == 'databases'
+Requires-Dist: psycopg[binary,pool]>=3.3; extra == 'databases'
+Requires-Dist: valkey>=6; extra == 'databases'
+Provides-Extra: server
+Requires-Dist: fastapi>=0.115.0; extra == 'server'
+Requires-Dist: uvicorn[standard]>=0.40.0; extra == 'server'
+Description-Content-Type: text/markdown
+
+# Imbi Common Library
+
+Shared library for the Imbi ecosystem providing core data access, authentication primitives, and domain models.
+
+## Overview
+
+`imbi-common` is a Python library that provides common functionality for all Imbi services including:
+
+- **Database Clients**: Apache AGE/PostgreSQL (graph database) and ClickHouse (analytics database) with connection management
+- **Domain Models**: Pydantic models for Projects, Organizations, Teams, Environments, ProjectTypes, and more
+- **Authentication**: JWT token creation/verification, token encryption
+- **Configuration**: Pydantic Settings-based configuration management with TOML file support
+- **Blueprint System**: Dynamic schema extension system for runtime model customization
+- **Logging**: Consistent logging configuration across all services
+
+## Services Using imbi-common
+
+- **imbi-api**: Main API service for service management
+- **imbi-gateway**: Webhook processing service
+- **imbi-mcp**: Model Context Protocol server for Claude integration
+
+## Documentation
+
+Full documentation is available at: [https://aweber-imbi.github.io/imbi-common/](https://aweber-imbi.github.io/imbi-common/)
+
+## Development
+
+### Prerequisites
+
+- [just](https://just.systems/man/en/packages.html) — task runner
+- [uv](https://docs.astral.sh/uv/getting-started/installation/) — Python package manager
+
+### Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/AWeber-Imbi/imbi-common.git
+cd imbi-common
+
+# Install dependencies and pre-commit hooks
+just setup
+```
+
+### Running Tests
+
+```bash
+just test           # Full test suite with coverage (requires Docker)
+just test <file>    # Run specific test file(s)
+```
+
+### Code Quality
+
+```bash
+just lint    # Run all linters
+just format  # Reformat code
+```
+
+## License
+
+BSD-3-Clause - See [LICENSE](LICENSE) file for details.
+
+## Authors
+
+- Dave Shawley <daves@aweber.com>
+- Gavin M. Roy <gavinr@aweber.com>
+
+## Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

imbi_common-0.1.0/PROGRESS.md

@@ -0,0 +1,126 @@
+# imbi-common Creation Progress
+
+## Completed Tasks ✅
+
+### 1. Repository Structure
+- ✅ Created `src/imbi_common/` package structure (simple package with underscore)
+- ✅ Created subdirectories: `neo4j/`, `clickhouse/`, `auth/`
+- ✅ Created test structure: `tests/` with matching subdirectories
+- ✅ Created docs structure: `docs/api/`, `docs/guides/`, `docs/adr/`
+- ✅ Created `.github/workflows/` for CI/CD
+
+### 2. Configuration Files
+- ✅ `pyproject.toml` - Hatchling build system matching imbi-api patterns
+- ✅ `.gitignore` - Copied from imbi-api
+- ✅ `.pre-commit-config.yaml` - Ruff, mypy configuration
+- ✅ `LICENSE` - BSD-3-Clause
+- ✅ `README.md` - Comprehensive project overview
+
+### 3. Extracted Modules
+- ✅ `settings.py` - Complete configuration management (standalone)
+- ✅ `neo4j/` - Client, constants, public API (imports updated to imbi_common)
+- ✅ `clickhouse/` - Client, privacy utilities, base schemas (imports updated)
+- ✅ `models.py` - All core domain and auth models (imports updated)
+- ✅ `blueprints.py` - Blueprint system (imports updated)
+- ✅ `auth/core.py` - Password hashing, JWT (imports updated)
+- ✅ `auth/encryption.py` - Token encryption (imports updated)
+- ✅ `logging.py` - Log configuration with dictConfig support (new module)
+- ✅ `log-config.toml` - Logging configuration
+
+### 4. Base Schemas
+- ✅ Created minimal `clickhouse/schemata.toml` with only shared tables:
+  - `session_activity` - Used by API and MCP
+  - `mfa_events` - MFA tracking
+- ✅ API-specific schemas (api_key_usage, rate_limit_events, email_audit) remain in imbi-api
+
+### 5. Code Quality
+- ✅ All imports updated from `imbi` to `imbi_common`
+- ✅ Fixed version import in neo4j client
+- ✅ All ruff checks passing (no linting errors)
+- ✅ Line length issues fixed (79 character limit)
+- ✅ Proper module imports following project conventions
+
+### 6. Public API
+- ✅ Created `__init__.py` with proper exports
+- ✅ Version string: `0.1.0`
+- ✅ Exposes all main modules: settings, models, neo4j, clickhouse, auth, blueprints, logging
+
+## Next Steps 📋
+
+### Documentation
+- [ ] Set up MkDocs with mkdocs.yml
+- [ ] Write docs/index.md (home page)
+- [ ] Write docs/installation.md
+- [ ] Write docs/quickstart.md
+- [ ] Write docs/configuration.md
+- [ ] Write API reference docs (docs/api/*.md)
+- [ ] Write guides (docs/guides/*.md)
+- [ ] Create ADR 0001 documenting all decisions
+
+### Testing
+- [ ] Create unittest test structure
+- [ ] Write unit tests for settings module
+- [ ] Write unit tests for auth module
+- [ ] Write unit tests for logging module
+- [ ] Write integration tests for neo4j (with Docker)
+- [ ] Write integration tests for clickhouse (with Docker)
+- [ ] Create test base classes (Neo4jTestCase, ClickHouseTestCase)
+
+### CI/CD
+- [ ] Create .github/workflows/test.yml (test, lint, type check)
+- [ ] Create .github/workflows/docs.yml (build and deploy to GitHub Pages)
+- [ ] Create .github/workflows/publish.yml (publish to PyPI on release)
+
+### Final Steps
+- [ ] Install dependencies with uv
+- [ ] Run full test suite
+- [ ] Build package: `python -m build`
+- [ ] Test installation
+- [ ] Publish v0.1.0
+
+## File Structure Summary
+
+```
+imbi-common/
+├── src/imbi_common/
+│   ├── __init__.py              ✅ Public API
+│   ├── py.typed                 ✅ Type hints marker
+│   ├── settings.py              ✅ Configuration
+│   ├── models.py                ✅ Domain models
+│   ├── blueprints.py            ✅ Blueprint system
+│   ├── logging.py               ✅ Log configuration
+│   ├── log-config.toml          ✅ Logging config
+│   ├── neo4j/
+│   │   ├── __init__.py          ✅ Public API
+│   │   ├── client.py            ✅ Neo4j client
+│   │   └── constants.py         ✅ Indexes/constraints
+│   ├── clickhouse/
+│   │   ├── __init__.py          ✅ Public API
+│   │   ├── client.py            ✅ ClickHouse client
+│   │   ├── privacy.py           ✅ GDPR utilities
+│   │   └── schemata.toml        ✅ Base schemas
+│   └── auth/
+│       ├── __init__.py          ✅ Auth package
+│       ├── core.py              ✅ Password/JWT
+│       └── encryption.py        ✅ Token encryption
+├── tests/                       ✅ Test structure created
+├── docs/                        ✅ Docs structure created
+├── pyproject.toml               ✅ Build configuration
+├── README.md                    ✅ Project overview
+├── LICENSE                      ✅ BSD-3-Clause
+├── .gitignore                   ✅ From imbi-api
+└── .pre-commit-config.yaml      ✅ From imbi-api
+```
+
+## Import Pattern
+
+All imports updated to use `imbi_common`:
+
+```python
+from imbi_common import settings, models, neo4j, clickhouse, auth, blueprints, logging
+from imbi_common.auth import core, encryption
+```
+
+## Status: ~40% Complete
+
+Core extraction is done. Documentation and testing remain.

imbi_common-0.1.0/README.md

@@ -0,0 +1,69 @@
+# Imbi Common Library
+
+Shared library for the Imbi ecosystem providing core data access, authentication primitives, and domain models.
+
+## Overview
+
+`imbi-common` is a Python library that provides common functionality for all Imbi services including:
+
+- **Database Clients**: Apache AGE/PostgreSQL (graph database) and ClickHouse (analytics database) with connection management
+- **Domain Models**: Pydantic models for Projects, Organizations, Teams, Environments, ProjectTypes, and more
+- **Authentication**: JWT token creation/verification, token encryption
+- **Configuration**: Pydantic Settings-based configuration management with TOML file support
+- **Blueprint System**: Dynamic schema extension system for runtime model customization
+- **Logging**: Consistent logging configuration across all services
+
+## Services Using imbi-common
+
+- **imbi-api**: Main API service for service management
+- **imbi-gateway**: Webhook processing service
+- **imbi-mcp**: Model Context Protocol server for Claude integration
+
+## Documentation
+
+Full documentation is available at: [https://aweber-imbi.github.io/imbi-common/](https://aweber-imbi.github.io/imbi-common/)
+
+## Development
+
+### Prerequisites
+
+- [just](https://just.systems/man/en/packages.html) — task runner
+- [uv](https://docs.astral.sh/uv/getting-started/installation/) — Python package manager
+
+### Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/AWeber-Imbi/imbi-common.git
+cd imbi-common
+
+# Install dependencies and pre-commit hooks
+just setup
+```
+
+### Running Tests
+
+```bash
+just test           # Full test suite with coverage (requires Docker)
+just test <file>    # Run specific test file(s)
+```
+
+### Code Quality
+
+```bash
+just lint    # Run all linters
+just format  # Reformat code
+```
+
+## License
+
+BSD-3-Clause - See [LICENSE](LICENSE) file for details.
+
+## Authors
+
+- Dave Shawley <daves@aweber.com>
+- Gavin M. Roy <gavinr@aweber.com>
+
+## Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

imbi_common-0.1.0/compose.yaml

@@ -0,0 +1,32 @@
+services:
+  clickhouse:
+    image: clickhouse/clickhouse-server:latest
+    ports:
+      - "8123"
+      - "9000"
+    environment:
+      - CLICKHOUSE_DB=default
+      - CLICKHOUSE_USER=default
+      - CLICKHOUSE_PASSWORD=password
+    healthcheck:
+      test: ["CMD-SHELL", "wget -qO- http://localhost:8123/ping | grep -q 'Ok'"]
+
+  postgres:
+    image: ghcr.io/aweber-imbi/postgres:latest
+    ports:
+      - "5432"
+    environment:
+      POSTGRES_PASSWORD: secret
+      POSTGRES_DB: imbi
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres"]
+
+  valkey:
+    image: valkey/valkey:8-alpine
+    ports:
+      - "6379"
+    healthcheck:
+      test: ["CMD-SHELL", "valkey-cli ping"]
+      interval: 5s
+      timeout: 5s
+      retries: 10