chore: bump version 0.1.1 → 0.1.2

.gitea/workflows/ci.yml

@@ -0,0 +1,57 @@
+name: CI/CD Awesome Pipeline
+
+on:
+  push:
+    branches: [main]
+    tags:
+      - 'v*.*.*'
+  pull_request:
+    branches: [main]
+
+env:
+  REGISTRY_URL: ${{ vars.REGISTRY_URL || 'gitea.iswearihadsomethingforthis.net' }}
+  REGISTRY_USER: ${{ vars.REGISTRY_USER || 'francwa' }}
+
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Build and run tests
+        env:
+          DEEPSEEK_API_KEY: ${{ secrets.DEEPSEEK_API_KEY }}
+          TMDB_API_KEY: ${{ secrets.TMDB_API_KEY }}
+        run: make _ci-run-tests
+
+  build-and-push:
+    name: Build & Push to Registry
+    runs-on: ubuntu-latest
+    needs: test
+    if: startsWith(github.ref, 'refs/tags/v')
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Load config from Makefile
+        id: config
+        run: |
+          eval "$(make _ci-image-name)"
+          echo "image_name=${IMAGE_NAME}" >> $GITHUB_OUTPUT
+
+      - name: Extract version from tag
+        id: version
+        run: echo "version=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
+
+      - name: Build production image
+        run: make build
+
+      - name: Tag and push to registry
+        run: |
+          docker tag ${{ steps.config.outputs.image_name }}:latest ${{ env.REGISTRY_URL }}/${{ env.REGISTRY_USER }}/${{ steps.config.outputs.image_name }}:${{ steps.version.outputs.version }}
+          docker tag ${{ steps.config.outputs.image_name }}:latest ${{ env.REGISTRY_URL }}/${{ env.REGISTRY_USER }}/${{ steps.config.outputs.image_name }}:latest
+          echo "${{ secrets.GITEA_TOKEN }}" | docker login ${{ env.REGISTRY_URL }} -u ${{ env.REGISTRY_USER }} --password-stdin
+          docker push ${{ env.REGISTRY_URL }}/${{ env.REGISTRY_USER }}/${{ steps.config.outputs.image_name }}:${{ steps.version.outputs.version }}
+          docker push ${{ env.REGISTRY_URL }}/${{ env.REGISTRY_USER }}/${{ steps.config.outputs.image_name }}:latest

.pre-commit-config.yaml

@@ -18,18 +18,18 @@ repos:
     hooks:
       - id: ruff-check
         name: Ruff Linter
-        entry: bash -c 'cd brain && poetry run ruff check --fix'
+        entry: bash -c 'make lint'
         language: system
         types: [python]
 
       - id: ruff-format
         name: Ruff Formatter
-        entry: bash -c 'cd brain && poetry run ruff format'
+        entry: bash -c 'make format'
         language: system
         types: [python]
 
       - id: system-pytest
         name: Pytest
-        entry: bash -c 'cd brain && poetry run pytest -n auto --dist=loadscope'
+        entry: bash -c 'make test'
         language: system
         always_run: true

Makefile

@@ -0,0 +1,249 @@
+.POSIX:
+.SUFFIXES:
+.DEFAULT_GOAL := help
+
+# --- SETTINGS ---
+PYTHON_VERSION = 3.12.7
+PYTHON_VERSION_SHORT = $(shell echo $(PYTHON_VERSION) | cut -d. -f1,2)
+# Change to 'uv' when ready.
+RUNNER ?= poetry
+
+export PYTHON_VERSION
+export PYTHON_VERSION_SHORT
+export RUNNER
+export IMAGE_NAME
+
+# --- VARIABLES ---
+CORE_DIR     = brain
+SERVICE_NAME = agent_media
+IMAGE_NAME   = agent_media
+
+# --- ADAPTERS ---
+# UV uses "sync", Poetry uses "install". Both install DEV deps by default.
+INSTALL_CMD = $(if $(filter uv,$(RUNNER)),sync,install)
+
+# --- MACROS ---
+ARGS           = $(filter-out $@,$(MAKECMDGOALS))
+BUMP_CMD       = cd $(CORE_DIR) && $(RUNNER) run bump-my-version bump
+COMPOSE_CMD    = docker-compose
+DOCKER_CMD     = docker build \
+ --build-arg PYTHON_VERSION=$(PYTHON_VERSION) \
+ --build-arg PYTHON_VERSION_SHORT=$(PYTHON_VERSION_SHORT) \
+ --build-arg RUNNER=$(RUNNER) \
+ -f $(CORE_DIR)/Dockerfile \
+ -t $(IMAGE_NAME):latest .
+
+RUNNER_ADD     = cd $(CORE_DIR) && $(RUNNER) add
+RUNNER_HOOKS   = cd $(CORE_DIR) && $(RUNNER) run pre-commit install -c ../.pre-commit-config.yaml
+RUNNER_INSTALL = cd $(CORE_DIR) && $(RUNNER) $(INSTALL_CMD)
+RUNNER_RUN     = cd $(CORE_DIR) && $(RUNNER) run
+RUNNER_UPDATE  = cd $(CORE_DIR) && $(RUNNER) update
+
+# --- STYLES ---
+B = \033[1m
+G = \033[32m
+T = \033[36m
+R = \033[0m
+
+# --- TARGETS ---
+.PHONY: add build build-test check-docker check-runner clean coverage down format help init-dotenv install install-hooks lint logs major minor patch prune ps restart run shell test up update _check_branch _ci-image-name _ci-run-tests
+
+# Catch-all for args
+%:
+	@:
+
+add: check-runner
+	@echo "$(T)➕ Adding dependency ($(RUNNER)): $(ARGS)$(R)"
+	$(RUNNER_ADD) $(ARGS)
+
+build: check-docker
+	@echo "$(T)🐳 Building Docker image...$(R)"
+	$(DOCKER_CMD)
+	@echo "✅ Image $(IMAGE_NAME):latest ready."
+
+build-test: check-docker
+	@echo "$(T)🐳 Building test image (with dev deps)...$(R)"
+	docker build \
+		--build-arg RUNNER=$(RUNNER) \
+		--build-arg PYTHON_VERSION=$(PYTHON_VERSION) \
+		--build-arg PYTHON_VERSION_SHORT=$(PYTHON_VERSION_SHORT) \
+		-f $(CORE_DIR)/Dockerfile \
+		--target test \
+		-t $(IMAGE_NAME):test .
+	@echo "✅ Test image $(IMAGE_NAME):test ready."
+
+check-docker:
+	@command -v docker >/dev/null 2>&1 || { echo "$(R)❌ Docker not installed$(R)"; exit 1; }
+	@docker info >/dev/null 2>&1 || { echo "$(R)❌ Docker daemon not running$(R)"; exit 1; }
+
+check-runner:
+	@command -v $(RUNNER) >/dev/null 2>&1 || { echo "$(R)❌ $(RUNNER) not installed$(R)"; exit 1; }
+
+clean:
+	@echo "$(T)🧹 Cleaning caches...$(R)"
+	cd $(CORE_DIR) && rm -rf .ruff_cache __pycache__ .pytest_cache
+	find $(CORE_DIR) -type d -name "__pycache__" -exec rm -rf {} + 2>/dev/null || true
+	find $(CORE_DIR) -type d -name ".pytest_cache" -exec rm -rf {} + 2>/dev/null || true
+	find $(CORE_DIR) -type f -name "*.pyc" -delete 2>/dev/null || true
+	@echo "✅ Caches cleaned."
+
+coverage: check-runner
+	@echo "$(T)📊 Running tests with coverage...$(R)"
+	$(RUNNER_RUN) pytest --cov=. --cov-report=html --cov-report=term $(ARGS)
+	@echo "✅ Report generated in htmlcov/"
+
+down: check-docker
+	@echo "$(T)🛑 Stopping containers...$(R)"
+	$(COMPOSE_CMD) down
+	@echo "✅ System stopped."
+
+format: check-runner
+	@echo "$(T)✨ Formatting with Ruff...$(R)"
+	$(RUNNER_RUN) ruff format .
+	$(RUNNER_RUN) ruff check --fix .
+	@echo "✅ Code cleaned."
+
+help:
+	@echo "$(B)Available commands:$(R)"
+	@echo ""
+	@echo "$(G)Setup:$(R)"
+	@echo "  $(T)check-docker 		$(R)  Verify Docker is installed and running."
+	@echo "  $(T)check-runner 		$(R)  Verify package manager ($(RUNNER))."
+	@echo "  $(T)init-dotenv  		$(R)  Create .env from .env.example with generated secrets."
+	@echo "  $(T)install      		$(R)  Install ALL dependencies (Prod + Dev)."
+	@echo "  $(T)install-hooks		$(R)  Install git pre-commit hooks."
+	@echo ""
+	@echo "$(G)Docker:$(R)"
+	@echo "  $(T)build        		$(R)  Build the docker image (production)."
+	@echo "  $(T)build-test   		$(R)  Build the docker image (with dev deps for testing)."
+	@echo "  $(T)down         		$(R)  Stop and remove containers."
+	@echo "  $(T)logs         		$(R)  Follow logs."
+	@echo "  $(T)prune        		$(R)  Clean Docker system."
+	@echo "  $(T)ps           		$(R)  Show container status."
+	@echo "  $(T)restart      		$(R)  Restart all containers."
+	@echo "  $(T)shell        		$(R)  Open shell in container."
+	@echo "  $(T)up           		$(R)  Start the agent."
+	@echo ""
+	@echo "$(G)Development:$(R)"
+	@echo "  $(T)add ...      		$(R)  Add dependency (use --group dev or --dev if needed)."
+	@echo "  $(T)clean        		$(R)  Clean caches."
+	@echo "  $(T)coverage     		$(R)  Run tests with coverage."
+	@echo "  $(T)format       		$(R)  Format code (Ruff)."
+	@echo "  $(T)lint         		$(R)  Lint code without fixing."
+	@echo "  $(T)test ...     		$(R)  Run tests (local with $(RUNNER))."
+	@echo "  $(T)update       		$(R)  Update dependencies."
+	@echo ""
+	@echo "$(G)Versioning:$(R)"
+	@echo "  $(T)major/minor/patch	$(R)  Bump version."
+
+init-dotenv:
+	@echo "$(T)🔑 Initializing .env file...$(R)"
+	@if [ -f .env ]; then \
+		echo "$(R)⚠️  .env already exists. Skipping.$(R)"; \
+		exit 0; \
+	fi
+	@if [ ! -f .env.example ]; then \
+		echo "$(R)❌ .env.example not found$(R)"; \
+		exit 1; \
+	fi
+	@if ! command -v openssl >/dev/null 2>&1; then \
+		echo "$(R)❌ openssl not found. Please install it first.$(R)"; \
+		exit 1; \
+	fi
+	@echo "$(T)  → Copying .env.example...$(R)"
+	@cp .env.example .env
+	@echo "$(T)  → Generating secrets...$(R)"
+	@sed -i.bak "s|JWT_SECRET=.*|JWT_SECRET=$$(openssl rand -base64 32)|" .env
+	@sed -i.bak "s|JWT_REFRESH_SECRET=.*|JWT_REFRESH_SECRET=$$(openssl rand -base64 32)|" .env
+	@sed -i.bak "s|CREDS_KEY=.*|CREDS_KEY=$$(openssl rand -hex 16)|" .env
+	@sed -i.bak "s|CREDS_IV=.*|CREDS_IV=$$(openssl rand -hex 8)|" .env
+	@sed -i.bak "s|MEILI_MASTER_KEY=.*|MEILI_MASTER_KEY=$$(openssl rand -base64 32)|" .env
+	@sed -i.bak "s|AGENT_BRAIN_API_KEY=.*|AGENT_BRAIN_API_KEY=$$(openssl rand -base64 24)|" .env
+	@rm -f .env.bak
+	@echo "$(G)✅ .env created with generated secrets!$(R)"
+	@echo "$(T)⚠️  Don't forget to add your API keys:$(R)"
+	@echo "   - OPENAI_API_KEY"
+	@echo "   - DEEPSEEK_API_KEY"
+	@echo "   - TMDB_API_KEY (optional)"
+
+install: check-runner
+	@echo "$(T)📦 Installing FULL environment ($(RUNNER))...$(R)"
+	$(RUNNER_INSTALL)
+	@echo "✅ Environment ready (Prod + Dev)."
+
+install-hooks: check-runner
+	@echo "$(T)🔧 Installing hooks...$(R)"
+	$(RUNNER_HOOKS)
+	@echo "✅ Hooks ready."
+
+lint: check-runner
+	@echo "$(T)🔍 Linting code...$(R)"
+	$(RUNNER_RUN) ruff check .
+
+logs: check-docker
+	@echo "$(T)📋 Following logs...$(R)"
+	$(COMPOSE_CMD) logs -f
+
+major: _check_branch
+	@echo "$(T)💥 Bumping major...$(R)"
+	SKIP=all $(BUMP_CMD) major
+
+minor: _check_branch
+	@echo "$(T)✨ Bumping minor...$(R)"
+	SKIP=all $(BUMP_CMD) minor
+
+patch: _check_branch
+	@echo "$(T)🚀 Bumping patch...$(R)"
+	SKIP=all $(BUMP_CMD) patch
+
+prune: check-docker
+	@echo "$(T)🗑️  Pruning Docker resources...$(R)"
+	docker system prune -af
+	@echo "✅ Docker cleaned."
+
+ps: check-docker
+	@echo "$(T)📋 Container status:$(R)"
+	@$(COMPOSE_CMD) ps
+
+restart: check-docker
+	@echo "$(T)🔄 Restarting containers...$(R)"
+	$(COMPOSE_CMD) restart
+	@echo "✅ Containers restarted."
+
+run: check-runner
+	$(RUNNER_RUN) $(ARGS)
+
+shell: check-docker
+	@echo "$(T)🐚 Opening shell in $(SERVICE_NAME)...$(R)"
+	$(COMPOSE_CMD) exec $(SERVICE_NAME) /bin/sh
+
+test: check-runner
+	@echo "$(T)🧪 Running tests...$(R)"
+	$(RUNNER_RUN) pytest $(ARGS)
+
+up: check-docker
+	@echo "$(T)🚀 Starting Agent Media...$(R)"
+	$(COMPOSE_CMD) up -d
+	@echo "✅ System is up."
+
+update: check-runner
+	@echo "$(T)🔄 Updating dependencies...$(R)"
+	$(RUNNER_UPDATE)
+	@echo "✅ All packages up to date."
+
+_check_branch:
+	@curr=$$(git rev-parse --abbrev-ref HEAD); \
+	if [ "$$curr" != "main" ]; then \
+	   echo "❌ Error: not on the main branch"; exit 1; \
+	fi
+
+_ci-image-name:
+	@echo "IMAGE_NAME=$(IMAGE_NAME)"
+
+_ci-run-tests: build-test
+	@echo "$(T)🧪 Running tests in Docker...$(R)"
+	docker run --rm \
+		-e DEEPSEEK_API_KEY \
+		-e TMDB_API_KEY \
+		$(IMAGE_NAME):test pytest
+	@echo "✅ Tests passed."

brain/.bumpversion.toml

@@ -0,0 +1,18 @@
+[tool.bumpversion]
+current_version = "0.1.2"
+parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
+serialize = ["{major}.{minor}.{patch}"]
+search = "{current_version}"
+replace = "{new_version}"
+regex = false
+ignore_missing_version = false
+tag = true
+sign_tags = false
+tag_name = "v{new_version}"
+tag_message = "Bump version: {current_version} → {new_version}"
+allow_dirty = false
+commit = true
+message = "chore: bump version {current_version} → {new_version}"
+
+[[tool.bumpversion.files]]
+filename = "pyproject.toml"

brain/Dockerfile

@@ -1,47 +1,85 @@
 # Dockerfile for Agent Media
 # Multi-stage build for smaller image size
-
+ARG PYTHON_VERSION
+ARG PYTHON_VERSION_SHORT
+ARG RUNNER
 # ===========================================
 # Stage 1: Builder
 # ===========================================
-FROM python:3.12.7-slim as builder
+FROM python:${PYTHON_VERSION}-slim-bookworm as builder
 
-# STFU (please)
+# Re-declare ARGs after FROM to make them available in this stage
-ENV DEBIAN_FRONTEND=noninteractive
+ARG RUNNER
+
+# STFU - No need - Write logs asap
+ENV DEBIAN_FRONTEND=noninteractive \
+    PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1
 
 # Install build dependencies (needs root)
 RUN apt-get update && apt-get install -y --no-install-recommends \
     build-essential \
     && rm -rf /var/lib/apt/lists/*
 
-# Install Poetry globally (needs root)
+# Install runner globally (needs root) - Save cache for future
-RUN pip install --no-cache-dir poetry
+RUN --mount=type=cache,target=/root/.cache/pip \
+    pip install $RUNNER
 
-# Copy dependency files (as root for now)
+# Set working directory for dependency installation
-COPY pyproject.toml poetry.lock* /tmp/
+WORKDIR /tmp
+
+# Copy dependency files
+COPY brain/pyproject.toml brain/poetry.lock* brain/uv.lock* Makefile ./
 
 # Install dependencies as root (to avoid permission issues with system packages)
-WORKDIR /tmp
+RUN --mount=type=cache,target=/root/.cache/pip \
-RUN poetry config virtualenvs.create false \
+    --mount=type=cache,target=/root/.cache/pypoetry \
-    && poetry install --only main --no-root --no-cache
+    --mount=type=cache,target=/root/.cache/uv \
-
+    if [ "$RUNNER" = "poetry" ]; then \
-# Create non-root user
+        poetry config virtualenvs.create false && \
-RUN useradd -m -u 1000 -s /bin/bash appuser
+        poetry install --only main --no-root; \
-
+    elif [ "$RUNNER" = "uv" ]; then \
-# Switch to non-root user
+        uv pip install --system -r pyproject.toml; \
-USER appuser
+    fi
-
-# Set working directory (owned by appuser)
-WORKDIR /home/appuser/app
 
 # ===========================================
-# Stage 2: Runtime
+# Stage 2: Testing
 # ===========================================
-FROM python:3.12.7-slim as runtime
+FROM builder as test
+
+ARG RUNNER
+
+RUN --mount=type=cache,target=/root/.cache/pip \
+    --mount=type=cache,target=/root/.cache/pypoetry \
+    --mount=type=cache,target=/root/.cache/uv \
+    if [ "$RUNNER" = "poetry" ]; then \
+        poetry install --no-root; \
+    elif [ "$RUNNER" = "uv" ]; then \
+        uv pip install --system -e .[dev]; \
+    fi
+
+COPY brain/agent/ ./agent/
+COPY brain/application/ ./application/
+COPY brain/domain/ ./domain/
+COPY brain/infrastructure/ ./infrastructure/
+COPY brain/tests/ ./tests/
+COPY brain/app.py .
+
+# ===========================================
+# Stage 3: Runtime
+# ===========================================
+FROM python:${PYTHON_VERSION}-slim-bookworm as runtime
+
+ARG PYTHON_VERSION_SHORT
+
+ENV LLM_PROVIDER=deepseek \
+    MEMORY_STORAGE_DIR=/data/memory \
+    PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONPATH=/home/appuser/app \
+    PYTHONUNBUFFERED=1
 
 # Install runtime dependencies (needs root)
 RUN apt-get update && apt-get install -y --no-install-recommends \
-    curl \
     ca-certificates \
     && rm -rf /var/lib/apt/lists/* \
     && apt-get clean
@@ -60,15 +98,15 @@ USER appuser
 WORKDIR /home/appuser/app
 
 # Copy Python packages from builder stage
-COPY --from=builder /usr/local/lib/python3.12/site-packages /usr/local/lib/python3.12/site-packages
+COPY --from=builder /usr/local/lib/python${PYTHON_VERSION_SHORT}/site-packages /usr/local/lib/python${PYTHON_VERSION_SHORT}/site-packages
 COPY --from=builder /usr/local/bin /usr/local/bin
 
 # Copy application code (already owned by appuser)
-COPY --chown=appuser:appuser agent/ ./agent/
+COPY --chown=appuser:appuser brain/agent/ ./agent/
-COPY --chown=appuser:appuser application/ ./application/
+COPY --chown=appuser:appuser brain/application/ ./application/
-COPY --chown=appuser:appuser domain/ ./domain/
+COPY --chown=appuser:appuser brain/domain/ ./domain/
-COPY --chown=appuser:appuser infrastructure/ ./infrastructure/
+COPY --chown=appuser:appuser brain/infrastructure/ ./infrastructure/
-COPY --chown=appuser:appuser app.py .
+COPY --chown=appuser:appuser brain/app.py .
 
 # Create volumes for persistent data
 VOLUME ["/data/memory", "/data/logs"]
@@ -78,14 +116,7 @@ EXPOSE 8000
 
 # Health check
 HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
-    CMD curl -f http://localhost:8000/health || exit 1
+    CMD python -c "import requests; requests.get('http://localhost:8000/health', timeout=5).raise_for_status()" || exit 1
-
-# Environment variables (can be overridden)
-ENV PYTHONUNBUFFERED=1 \
-    PYTHONDONTWRITEBYTECODE=1 \
-    PYTHONPATH=/home/appuser/app \
-    LLM_PROVIDER=deepseek \
-    MEMORY_STORAGE_DIR=/data/memory
 
 # Run the application
 CMD ["python", "-m", "uvicorn", "app:app", "--host", "0.0.0.0", "--port", "8000"]

brain/poetry.lock

@@ -40,6 +40,39 @@ typing_extensions = {version = ">=4.5", markers = "python_version < \"3.13\""}
 [package.extras]
 trio = ["trio (>=0.31.0)", "trio (>=0.32.0)"]
 
+[[package]]
+name = "bracex"
+version = "2.6"
+description = "Bash style brace expander."
+optional = false
+python-versions = ">=3.9"
+files = [
+    {file = "bracex-2.6-py3-none-any.whl", hash = "sha256:0b0049264e7340b3ec782b5cb99beb325f36c3782a32e36e876452fd49a09952"},
+    {file = "bracex-2.6.tar.gz", hash = "sha256:98f1347cd77e22ee8d967a30ad4e310b233f7754dbf31ff3fceb76145ba47dc7"},
+]
+
+[[package]]
+name = "bump-my-version"
+version = "1.2.5"
+description = "Version bump your Python project"
+optional = false
+python-versions = ">=3.8"
+files = [
+    {file = "bump_my_version-1.2.5-py3-none-any.whl", hash = "sha256:57e5718d9fe7d7b6f5ceb68e70cd3c4bd0570d300b4aade15fd1e355febdd351"},
+    {file = "bump_my_version-1.2.5.tar.gz", hash = "sha256:827af6c7b13111c62b45340f25defd105f566fe0cdbbb70e2c4b2f005b667e1f"},
+]
+
+[package.dependencies]
+click = "<8.2.2"
+httpx = ">=0.28.1"
+pydantic = ">=2.0.0"
+pydantic-settings = "*"
+questionary = "*"
+rich = "*"
+rich-click = "*"
+tomlkit = "*"
+wcmatch = ">=8.5.1"
+
 [[package]]
 name = "certifi"
 version = "2025.11.12"
@@ -186,13 +219,13 @@ files = [
 
 [[package]]
 name = "click"
-version = "8.3.1"
+version = "8.2.1"
 description = "Composable command line interface toolkit"
 optional = false
 python-versions = ">=3.10"
 files = [
-    {file = "click-8.3.1-py3-none-any.whl", hash = "sha256:981153a64e25f12d547d3426c367a4857371575ee7ad18df2a6183ab0545b2a6"},
+    {file = "click-8.2.1-py3-none-any.whl", hash = "sha256:61a3265b914e850b85317d0b3109c7f8cd35a670f963866005d6ef1d5175a12b"},
-    {file = "click-8.3.1.tar.gz", hash = "sha256:12ff4785d337a1bb490bb7e9c2b1ee5da3112e94a8622f26a6c77f5d2fc6842a"},
+    {file = "click-8.2.1.tar.gz", hash = "sha256:27c491cc05d968d271d5a1db13e3b5a184636d9d930f148c50b038f0d0646202"},
 ]
 
 [package.dependencies]
@@ -405,13 +438,13 @@ trio = ["trio (>=0.22.0,<1.0)"]
 
 [[package]]
 name = "httpx"
-version = "0.27.2"
+version = "0.28.1"
 description = "The next generation HTTP client."
 optional = false
 python-versions = ">=3.8"
 files = [
-    {file = "httpx-0.27.2-py3-none-any.whl", hash = "sha256:7bb2708e112d8fdd7829cd4243970f0c223274051cb35ee80c03301ee29a3df0"},
+    {file = "httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad"},
-    {file = "httpx-0.27.2.tar.gz", hash = "sha256:f7c2be1d2f3c3c3160d441802406b206c2b76f5947b11115e6df10c6c65e66c2"},
+    {file = "httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc"},
 ]
 
 [package.dependencies]
@@ -419,7 +452,6 @@ anyio = "*"
 certifi = "*"
 httpcore = "==1.*"
 idna = "*"
-sniffio = "*"
 
 [package.extras]
 brotli = ["brotli", "brotlicffi"]
@@ -467,6 +499,40 @@ files = [
     {file = "iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730"},
 ]
 
+[[package]]
+name = "markdown-it-py"
+version = "4.0.0"
+description = "Python port of markdown-it. Markdown parsing, done right!"
+optional = false
+python-versions = ">=3.10"
+files = [
+    {file = "markdown_it_py-4.0.0-py3-none-any.whl", hash = "sha256:87327c59b172c5011896038353a81343b6754500a08cd7a4973bb48c6d578147"},
+    {file = "markdown_it_py-4.0.0.tar.gz", hash = "sha256:cb0a2b4aa34f932c007117b194e945bd74e0ec24133ceb5bac59009cda1cb9f3"},
+]
+
+[package.dependencies]
+mdurl = ">=0.1,<1.0"
+
+[package.extras]
+benchmarking = ["psutil", "pytest", "pytest-benchmark"]
+compare = ["commonmark (>=0.9,<1.0)", "markdown (>=3.4,<4.0)", "markdown-it-pyrs", "mistletoe (>=1.0,<2.0)", "mistune (>=3.0,<4.0)", "panflute (>=2.3,<3.0)"]
+linkify = ["linkify-it-py (>=1,<3)"]
+plugins = ["mdit-py-plugins (>=0.5.0)"]
+profiling = ["gprof2dot"]
+rtd = ["ipykernel", "jupyter_sphinx", "mdit-py-plugins (>=0.5.0)", "myst-parser", "pyyaml", "sphinx", "sphinx-book-theme (>=1.0,<2.0)", "sphinx-copybutton", "sphinx-design"]
+testing = ["coverage", "pytest", "pytest-cov", "pytest-regressions", "requests"]
+
+[[package]]
+name = "mdurl"
+version = "0.1.2"
+description = "Markdown URL utilities"
+optional = false
+python-versions = ">=3.7"
+files = [
+    {file = "mdurl-0.1.2-py3-none-any.whl", hash = "sha256:84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8"},
+    {file = "mdurl-0.1.2.tar.gz", hash = "sha256:bb413d29f5eea38f31dd4754dd7377d4465116fb207585f97bf925588687c1ba"},
+]
+
 [[package]]
 name = "nodeenv"
 version = "1.9.1"
@@ -538,6 +604,20 @@ nodeenv = ">=0.11.1"
 pyyaml = ">=5.1"
 virtualenv = ">=20.10.0"
 
+[[package]]
+name = "prompt-toolkit"
+version = "3.0.52"
+description = "Library for building powerful interactive command lines in Python"
+optional = false
+python-versions = ">=3.8"
+files = [
+    {file = "prompt_toolkit-3.0.52-py3-none-any.whl", hash = "sha256:9aac639a3bbd33284347de5ad8d68ecc044b91a762dc39b7c21095fcd6a19955"},
+    {file = "prompt_toolkit-3.0.52.tar.gz", hash = "sha256:28cde192929c8e7321de85de1ddbe736f1375148b02f2e17edd840042b1be855"},
+]
+
+[package.dependencies]
+wcwidth = "*"
+
 [[package]]
 name = "pydantic"
 version = "2.12.5"
@@ -692,6 +772,29 @@ files = [
 [package.dependencies]
 typing-extensions = ">=4.14.1"
 
+[[package]]
+name = "pydantic-settings"
+version = "2.12.0"
+description = "Settings management using Pydantic"
+optional = false
+python-versions = ">=3.10"
+files = [
+    {file = "pydantic_settings-2.12.0-py3-none-any.whl", hash = "sha256:fddb9fd99a5b18da837b29710391e945b1e30c135477f484084ee513adb93809"},
+    {file = "pydantic_settings-2.12.0.tar.gz", hash = "sha256:005538ef951e3c2a68e1c08b292b5f2e71490def8589d4221b95dab00dafcfd0"},
+]
+
+[package.dependencies]
+pydantic = ">=2.7.0"
+python-dotenv = ">=0.21.0"
+typing-inspection = ">=0.4.0"
+
+[package.extras]
+aws-secrets-manager = ["boto3 (>=1.35.0)", "boto3-stubs[secretsmanager]"]
+azure-key-vault = ["azure-identity (>=1.16.0)", "azure-keyvault-secrets (>=4.8.0)"]
+gcp-secret-manager = ["google-cloud-secret-manager (>=2.23.1)"]
+toml = ["tomli (>=2.0.1)"]
+yaml = ["pyyaml (>=6.0.1)"]
+
 [[package]]
 name = "pygments"
 version = "2.19.2"
@@ -879,6 +982,20 @@ files = [
     {file = "pyyaml-6.0.3.tar.gz", hash = "sha256:d76623373421df22fb4cf8817020cbb7ef15c725b9d5e45f17e189bfc384190f"},
 ]
 
+[[package]]
+name = "questionary"
+version = "2.1.1"
+description = "Python library to build pretty command line user prompts ⭐️"
+optional = false
+python-versions = ">=3.9"
+files = [
+    {file = "questionary-2.1.1-py3-none-any.whl", hash = "sha256:a51af13f345f1cdea62347589fbb6df3b290306ab8930713bfae4d475a7d4a59"},
+    {file = "questionary-2.1.1.tar.gz", hash = "sha256:3d7e980292bb0107abaa79c68dd3eee3c561b83a0f89ae482860b181c8bd412d"},
+]
+
+[package.dependencies]
+prompt_toolkit = ">=2.0,<4.0"
+
 [[package]]
 name = "requests"
 version = "2.32.5"
@@ -900,6 +1017,44 @@ urllib3 = ">=1.21.1,<3"
 socks = ["PySocks (>=1.5.6,!=1.5.7)"]
 use-chardet-on-py3 = ["chardet (>=3.0.2,<6)"]
 
+[[package]]
+name = "rich"
+version = "14.2.0"
+description = "Render rich text, tables, progress bars, syntax highlighting, markdown and more to the terminal"
+optional = false
+python-versions = ">=3.8.0"
+files = [
+    {file = "rich-14.2.0-py3-none-any.whl", hash = "sha256:76bc51fe2e57d2b1be1f96c524b890b816e334ab4c1e45888799bfaab0021edd"},
+    {file = "rich-14.2.0.tar.gz", hash = "sha256:73ff50c7c0c1c77c8243079283f4edb376f0f6442433aecb8ce7e6d0b92d1fe4"},
+]
+
+[package.dependencies]
+markdown-it-py = ">=2.2.0"
+pygments = ">=2.13.0,<3.0.0"
+
+[package.extras]
+jupyter = ["ipywidgets (>=7.5.1,<9)"]
+
+[[package]]
+name = "rich-click"
+version = "1.9.4"
+description = "Format click help output nicely with rich"
+optional = false
+python-versions = ">=3.8"
+files = [
+    {file = "rich_click-1.9.4-py3-none-any.whl", hash = "sha256:d70f39938bcecaf5543e8750828cbea94ef51853f7d0e174cda1e10543767389"},
+    {file = "rich_click-1.9.4.tar.gz", hash = "sha256:af73dc68e85f3bebb80ce302a642b9fe3b65f3df0ceb42eb9a27c467c1b678c8"},
+]
+
+[package.dependencies]
+click = ">=8"
+colorama = {version = "*", markers = "platform_system == \"Windows\""}
+rich = ">=12"
+
+[package.extras]
+dev = ["inline-snapshot (>=0.24)", "jsonschema (>=4)", "mypy (>=1.14.1)", "nodeenv (>=1.9.1)", "packaging (>=25)", "pre-commit (>=3.5)", "pytest (>=8.3.5)", "pytest-cov (>=5)", "rich-codex (>=1.2.11)", "ruff (>=0.12.4)", "typer (>=0.15)", "types-setuptools (>=75.8.0.20250110)"]
+docs = ["markdown-include (>=0.8.1)", "mike (>=2.1.3)", "mkdocs-github-admonitions-plugin (>=0.1.1)", "mkdocs-glightbox (>=0.4)", "mkdocs-include-markdown-plugin (>=7.1.7)", "mkdocs-material-extensions (>=1.3.1)", "mkdocs-material[imaging] (>=9.5.18,<9.6.0)", "mkdocs-redirects (>=1.2.2)", "mkdocs-rss-plugin (>=1.15)", "mkdocs[docs] (>=1.6.1)", "mkdocstrings[python] (>=0.26.1)", "rich-codex (>=1.2.11)", "typer (>=0.15)"]
+
 [[package]]
 name = "ruff"
 version = "0.14.9"
@@ -928,17 +1083,6 @@ files = [
     {file = "ruff-0.14.9.tar.gz", hash = "sha256:35f85b25dd586381c0cc053f48826109384c81c00ad7ef1bd977bfcc28119d5b"},
 ]
 
-[[package]]
-name = "sniffio"
-version = "1.3.1"
-description = "Sniff out which async library your code is running under"
-optional = false
-python-versions = ">=3.7"
-files = [
-    {file = "sniffio-1.3.1-py3-none-any.whl", hash = "sha256:2f6da418d1f1e0fddd844478f41680e794e6051915791a034ff65e5f100525a2"},
-    {file = "sniffio-1.3.1.tar.gz", hash = "sha256:f4324edc670a0f49750a81b895f35c3adb843cca46f0530f79fc1babb23789dc"},
-]
-
 [[package]]
 name = "starlette"
 version = "0.50.0"
@@ -957,6 +1101,17 @@ typing-extensions = {version = ">=4.10.0", markers = "python_version < \"3.13\""
 [package.extras]
 full = ["httpx (>=0.27.0,<0.29.0)", "itsdangerous", "jinja2", "python-multipart (>=0.0.18)", "pyyaml"]
 
+[[package]]
+name = "tomlkit"
+version = "0.13.3"
+description = "Style preserving TOML library"
+optional = false
+python-versions = ">=3.8"
+files = [
+    {file = "tomlkit-0.13.3-py3-none-any.whl", hash = "sha256:c89c649d79ee40629a9fda55f8ace8c6a1b42deb912b2a8fd8d942ddadb606b0"},
+    {file = "tomlkit-0.13.3.tar.gz", hash = "sha256:430cf247ee57df2b94ee3fbe588e71d362a941ebb545dec29b53961d61add2a1"},
+]
+
 [[package]]
 name = "typing-extensions"
 version = "4.15.0"
@@ -1037,7 +1192,32 @@ platformdirs = ">=3.9.1,<5"
 docs = ["furo (>=2023.7.26)", "proselint (>=0.13)", "sphinx (>=7.1.2,!=7.3)", "sphinx-argparse (>=0.4)", "sphinxcontrib-towncrier (>=0.2.1a0)", "towncrier (>=23.6)"]
 test = ["covdefaults (>=2.3)", "coverage (>=7.2.7)", "coverage-enable-subprocess (>=1)", "flaky (>=3.7)", "packaging (>=23.1)", "pytest (>=7.4)", "pytest-env (>=0.8.2)", "pytest-freezer (>=0.4.8)", "pytest-mock (>=3.11.1)", "pytest-randomly (>=3.12)", "pytest-timeout (>=2.1)", "setuptools (>=68)", "time-machine (>=2.10)"]
 
+[[package]]
+name = "wcmatch"
+version = "10.1"
+description = "Wildcard/glob file name matcher."
+optional = false
+python-versions = ">=3.9"
+files = [
+    {file = "wcmatch-10.1-py3-none-any.whl", hash = "sha256:5848ace7dbb0476e5e55ab63c6bbd529745089343427caa5537f230cc01beb8a"},
+    {file = "wcmatch-10.1.tar.gz", hash = "sha256:f11f94208c8c8484a16f4f48638a85d771d9513f4ab3f37595978801cb9465af"},
+]
+
+[package.dependencies]
+bracex = ">=2.1.1"
+
+[[package]]
+name = "wcwidth"
+version = "0.2.14"
+description = "Measures the displayed width of unicode strings in a terminal"
+optional = false
+python-versions = ">=3.6"
+files = [
+    {file = "wcwidth-0.2.14-py2.py3-none-any.whl", hash = "sha256:a7bb560c8aee30f9957e5f9895805edd20602f2d7f720186dfd906e82b4982e1"},
+    {file = "wcwidth-0.2.14.tar.gz", hash = "sha256:4d478375d31bc5395a3c55c40ccdf3354688364cd61c4f6adacaa9215d0b3605"},
+]
+
 [metadata]
 lock-version = "2.0"
 python-versions = "^3.12"
-content-hash = "5c2c904faa103594a47a0636395967d0d37b2692c2c79be914f7d6adaf0beea9"
+content-hash = "b6cec0647accef2c235cededb06cab49f30033fb5e5ce1f6b589a4da5d2a2d8d"

brain/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "agent-media"
-version = "0.1.0"
+version = "0.1.2"
 description = "AI agent for managing a local media library"
 authors = ["Francwa <francois.hodiaumont@gmail.com>"]
 readme = "README.md"
@@ -14,14 +14,15 @@ fastapi = "^0.121.1"
 pydantic = "^2.12.4"
 uvicorn = "^0.38.0"
 pytest-xdist = "^3.8.0"
+httpx = "^0.28.1"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^8.0.0"
 pytest-cov = "^4.1.0"
 pytest-asyncio = "^0.23.0"
-httpx = "^0.27.0"
 ruff = "^0.14.7"
 pre-commit = "^4.5.1"
+bump-my-version = "^1.2.5"
 
 [build-system]
 requires = ["poetry-core"]
@@ -46,6 +47,7 @@ addopts = [
     #"--cov-report=xml",            # Génère un rapport XML (pour CI/CD)
     #"--cov-fail-under=80",         # Échoue si coverage < 80%
     "-n=auto",                     # --numprocesses=auto : parallélise les tests (pytest-xdist)
+    "--dist=loadscope",            # Distribution strategy: group tests by module
     "--strict-markers",            # Erreur si un marker non déclaré est utilisé
     "--disable-warnings",          # Désactive l'affichage des warnings (sauf erreurs)
 ]

docker-compose.yml

@@ -6,6 +6,8 @@ services:
     build:
       context: ./brain
       dockerfile: Dockerfile
+      args:
+        RUNNER: ${RUNNER} # Get it from Makefile
     container_name: agent-brain
     restart: unless-stopped
     env_file: .env
@@ -49,21 +51,21 @@ services:
     environment:
       # MongoDB connection (no auth, matching LibreChat default)
       MONGO_URI: mongodb://mongodb:27017/LibreChat
-      
+
       # App configuration
       HOST: 0.0.0.0
       PORT: 3080
-      
+
       # Security
       JWT_SECRET: ${JWT_SECRET:-your-super-secret-jwt-key-change-this-in-production}
       JWT_REFRESH_SECRET: ${JWT_REFRESH_SECRET:-your-super-secret-refresh-key-change-this-too}
       CREDS_KEY: ${CREDS_KEY:-your-32-character-secret-key-here}
       CREDS_IV: ${CREDS_IV:-your-16-character-iv-here}
-      
+
       # Session
       SESSION_EXPIRY: ${SESSION_EXPIRY:-1000 * 60 * 15}
       REFRESH_TOKEN_EXPIRY: ${REFRESH_TOKEN_EXPIRY:-1000 * 60 * 60 * 24 * 7}
-      
+
       # Domain
       DOMAIN_CLIENT: ${DOMAIN_CLIENT:-http://localhost:3080}
       DOMAIN_SERVER: ${DOMAIN_SERVER:-http://localhost:3080}
@@ -201,4 +203,4 @@ volumes:
 # Network for inter-service communication
 networks:
   agent-network:
-    driver: bridge
+    driver: bridge