feat(cli): add periodic Fuseki TDB2 compaction sidecar to local stack (#1058)

Generated local deployments now include a fuseki-compact service that
periodically calls Fuseki's admin compact endpoint (deleteOld=true) to
reclaim on-disk space from TDB2's retained historical/deleted data and
keep query latency stable.

The cadence is configurable via FUSEKI_COMPACT_INTERVAL_SECONDS
(default: 86400s / 1 day), added to DEFAULT_ENV_VALUES so it is also
backfilled into existing .env files on 'abi deploy local'.

Author: Dr0p42

libs/naas-abi-cli/naas_abi_cli/cli/deploy/local.py

@@ -29,6 +29,9 @@
     "PUBLIC_WEB_HOST": "nexus.localhost",
     "PUBLIC_API_HOST": "api.localhost",
     "RABBITMQ_USER": "abi",
+    # How often (in seconds) the fuseki-compact sidecar compacts the TDB2
+    # database to reclaim disk from historical/deleted data. Default: 1 day.
+    "FUSEKI_COMPACT_INTERVAL_SECONDS": "86400",
     "NEXUS_WEB_IMAGE": "ghcr.io/jupyter-naas/nexus-web",
     "NEXUS_WEB_TAG": "latest",
     "NEXUS_WEB_PORT": "3042",

libs/naas-abi-cli/naas_abi_cli/cli/deploy/templates/local/.env

@@ -52,6 +52,8 @@ RABBITMQ_USER=abi
 RABBITMQ_PASSWORD={{ RABBITMQ_PASSWORD }}
 
 FUSEKI_ADMIN_PASSWORD={{ FUSEKI_ADMIN_PASSWORD }}
+# How often (seconds) the fuseki-compact sidecar compacts the TDB2 store. Default: 1 day.
+FUSEKI_COMPACT_INTERVAL_SECONDS={{ FUSEKI_COMPACT_INTERVAL_SECONDS }}
 
 PUBLIC_WEB_HOST={{ PUBLIC_WEB_HOST }}
 PUBLIC_API_HOST={{ PUBLIC_API_HOST }}

libs/naas-abi-cli/naas_abi_cli/cli/deploy/templates/local/docker-compose.yml

@@ -242,6 +242,36 @@ services:
     networks:
       - abi-network
 
+  # -----------------------------------------------------------------------------
+  # Fuseki Compaction - Periodic TDB2 database compaction
+  # -----------------------------------------------------------------------------
+  # TDB2 retains previous versions of the data after updates/deletes, so the
+  # on-disk database keeps growing. This lightweight sidecar periodically calls
+  # Fuseki's admin compact endpoint (deleteOld=true) to reclaim that space and
+  # keep query latency stable. The cadence is controlled by
+  # FUSEKI_COMPACT_INTERVAL_SECONDS (default: 86400s = 1 day).
+  # NOTE: "$$" is how docker-compose escapes a literal "$" so the shell (not
+  # compose) expands the variable and the "/$/compact" admin path is preserved.
+  fuseki-compact:
+    image: curlimages/curl:latest
+    pull_policy: always
+    restart: unless-stopped
+    depends_on:
+      - fuseki
+    environment:
+      - ADMIN_PASSWORD=${FUSEKI_ADMIN_PASSWORD}
+      - COMPACT_INTERVAL_SECONDS=${FUSEKI_COMPACT_INTERVAL_SECONDS}
+    entrypoint: /bin/sh
+    command: >-
+      -c 'while true; do
+            sleep "$$COMPACT_INTERVAL_SECONDS";
+            echo "[fuseki-compact] triggering TDB2 compaction (deleteOld=true)...";
+            curl -fsS -u "admin:$$ADMIN_PASSWORD" -X POST "http://fuseki:3030/$$/compact/ds?deleteOld=true"
+              || echo "[fuseki-compact] compaction request failed";
+          done'
+    networks:
+      - abi-network
+
   # -----------------------------------------------------------------------------
   # YasGUI - SPARQL Query Interface
   # -----------------------------------------------------------------------------