From a57087b8eafcda20f63134836eab135b69c24300 Mon Sep 17 00:00:00 2001
From: Pier-Jean Malandrino <pierjean.malandrino@scub.net>
Date: Wed, 6 May 2026 09:55:51 +0200
Subject: [PATCH] chore(#254): wire WITH_REASONING + HF cache volume in compose

- Forward WITH_REASONING from the host environment to the document-parser
  build args so `WITH_REASONING=true docker compose up --build` produces
  the reasoning-enabled local image without editing the compose file.
- Mount a named hf_cache volume at /home/appuser/.cache/huggingface so
  Docling / HF model checkpoints survive container restarts and the first
  conversion does not re-download every cold start.
---
 docker-compose.dev.yml | 9 +++++++++
 docker-compose.yml     | 9 +++++++++
 2 files changed, 18 insertions(+)

diff --git a/docker-compose.dev.yml b/docker-compose.dev.yml
index 9a23fff..4253a9d 100644
--- a/docker-compose.dev.yml
+++ b/docker-compose.dev.yml
@@ -82,12 +82,20 @@ services:
     build:
       context: ./document-parser
       target: ${CONVERSION_MODE:-local}
+      args:
+        # Opt in to the R&D reasoning-trace deps (docling-agent + mellea).
+        # Off by default — keeps the standard `local` image lean. See
+        # docs/design/254-optim-taille-image-latest-local.md.
+        WITH_REASONING: ${WITH_REASONING:-false}
     ports:
       - "8000:8000"
     volumes:
       - ./document-parser:/app
       - uploads_data:/app/uploads
       - db_data:/app/data
+      # Persists Docling / HF model checkpoints across container restarts so
+      # the first conversion does not re-download every cold start.
+      - hf_cache:/home/appuser/.cache/huggingface
     environment:
       CORS_ORIGINS: ${CORS_ORIGINS:-http://localhost:3000,http://localhost:5173}
       DOCLING_SERVE_URL: ${DOCLING_SERVE_URL:-}
@@ -135,3 +143,4 @@ volumes:
   uploads_data:
   db_data:
   frontend_node_modules:
+  hf_cache:
diff --git a/docker-compose.yml b/docker-compose.yml
index d4022cf..85eaabb 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -89,11 +89,19 @@ services:
     build:
       context: ./document-parser
       target: ${CONVERSION_MODE:-local}
+      args:
+        # Opt in to the R&D reasoning-trace deps (docling-agent + mellea).
+        # Off by default — keeps the standard `local` image lean. See
+        # docs/design/254-optim-taille-image-latest-local.md.
+        WITH_REASONING: ${WITH_REASONING:-false}
     expose:
       - "8000"
     volumes:
       - uploads_data:/app/uploads
       - db_data:/app/data
+      # Persists Docling / HF model checkpoints across container restarts so
+      # the first conversion does not re-download every cold start.
+      - hf_cache:/home/appuser/.cache/huggingface
     environment:
       CORS_ORIGINS: ${CORS_ORIGINS:-http://localhost:3000,http://localhost:5173}
       DOCLING_SERVE_URL: ${DOCLING_SERVE_URL:-}
@@ -128,3 +136,4 @@ volumes:
   neo4j_logs:
   uploads_data:
   db_data:
+  hf_cache: