@duckmind/deepquark-darwin-arm64 0.9.83 → 0.9.90

package/.deepquark/skills/bundled/knowledge-graph/server/docker-compose-falkordb.yml

@@ -0,0 +1,151 @@
+# Docker Compose configuration for Madeinoz Knowledge System with FalkorDB backend
+# Uses a shared public network for both services
+
+name: madeinoz-knowledge-system
+#
+# Services:
+#   - falkordb: Redis-based graph database
+#   - graphiti-mcp: MCP server (exposed to host)
+#   - prometheus: Metrics server (optional, via --profile monitoring)
+#   - grafana: Dashboard (optional, via --profile monitoring)
+#
+# Madeinoz Patches APPLIED:
+#   1. entrypoint.sh - Maps MADEINOZ_KNOWLEDGE_* prefixed variables to unprefixed
+#      container variables. This keeps .env clean while providing what container expects.
+#
+# IMPORTANT NOTE - Docker Compose v2.14 Bug on macOS:
+#   If you get "key cannot contain a space" error, use the workaround:
+#   1. Create file in /tmp: git show HEAD:src/server/docker-compose-falkordb.yml > /tmp/docker-compose-falkordb.yml
+#   2. Run: docker compose -f /tmp/docker-compose-falkordb.yml up -d
+#
+# Usage from pack directory:
+#   1. Configure MADEINOZ_KNOWLEDGE_* variables in $PAI_DIR/.env (or ~/.claude/.env)
+#   2. Build custom image: docker build -t madeinoz-knowledge-system:fixed .
+#   3. Run: bun run server start (PREFERRED - auto-generates env files)
+#      Or legacy: bun run src/server/run.ts OR ./src/server/start.sh
+#   4. MCP server uses HTTP transport at: http://localhost:8000/mcp
+#   5. Access FalkorDB web UI at: http://localhost:3000
+#
+# Monitoring (optional):
+#   docker compose -f src/skills/server/docker-compose-falkordb.yml --profile monitoring up -d
+#   Access:
+#     - Prometheus UI: http://localhost:9092
+#     - Grafana: http://localhost:3002 (admin/admin)
+#
+# NOTE: The preferred 'bun run server start' command auto-generates the required
+#       /tmp/madeinoz-knowledge-*.env files from your PAI configuration.
+
+networks:
+  madeinoz-knowledge-net:
+    driver: bridge
+
+volumes:
+  falkordb-data:
+    driver: local
+  prometheus-data:
+    driver: local
+  grafana-data:
+    driver: local
+
+services:
+  # FalkorDB Graph Database
+  # Redis-based graph database
+  falkordb:
+    image: falkordb/falkordb:latest
+    container_name: madeinoz-knowledge-falkordb
+    restart: unless-stopped
+    networks:
+      - madeinoz-knowledge-net
+    ports:
+      - "3000:3000"  # FalkorDB web UI
+    volumes:
+      - falkordb-data:/data
+    environment:
+      - FALKORDB_PASSWORD=
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+      start_period: 20s
+
+  # Graphiti MCP Server (FalkorDB backend)
+  # Environment variables provided via env_file generated by start.sh
+  graphiti-mcp:
+    image: ghcr.io/madeinoz67/madeinoz-knowledge-system:latest
+    container_name: madeinoz-knowledge-graph-mcp
+    restart: unless-stopped
+    networks:
+      - madeinoz-knowledge-net
+    ports:
+      - "8000:8000"  # MCP HTTP endpoint
+      - "9090:9090"  # Prometheus metrics endpoint
+    env_file:
+      # Generated by start.sh from MADEINOZ_KNOWLEDGE_* prefixed variables
+      - /tmp/madeinoz-knowledge-mcp.env
+    environment:
+      # Logging: INFO for production (set DEBUG manually for troubleshooting)
+      - LOG_LEVEL=INFO
+    depends_on:
+      falkordb:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD", "curl", "-sf", "--max-time", "5", "http://localhost:8000/health"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+
+  # Prometheus Metrics Server (Production)
+  # Only started when --profile monitoring is specified
+  prometheus:
+    image: prom/prometheus:latest
+    container_name: madeinoz-knowledge-prometheus
+    profiles: [monitoring]
+    restart: unless-stopped
+    networks:
+      - madeinoz-knowledge-net
+    ports:
+      - "9092:9090"  # Prometheus UI
+    volumes:
+      - prometheus-data:/prometheus
+      - ../../../config/monitoring/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro
+    command:
+      - '--config.file=/etc/prometheus/prometheus.yml'
+      - '--storage.tsdb.path=/prometheus'
+      - '--web.enable-lifecycle'
+      - '--storage.tsdb.retention.time=30d'
+    depends_on:
+      graphiti-mcp:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD", "wget", "-q", "--spider", "http://localhost:9090/-/healthy"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 10s
+
+  # Grafana Dashboard (Production)
+  # Only started when --profile monitoring is specified
+  grafana:
+    image: grafana/grafana:latest
+    container_name: madeinoz-knowledge-grafana
+    profiles: [monitoring]
+    restart: unless-stopped
+    networks:
+      - madeinoz-knowledge-net
+    ports:
+      - "3002:3000"  # Grafana UI (port offset to avoid FalkorDB UI conflict)
+    volumes:
+      - grafana-data:/var/lib/grafana
+      - ../../../config/monitoring/grafana/provisioning/datasources:/etc/grafana/provisioning/datasources:ro
+      - ../../../config/monitoring/grafana/knowledge-system/dashboards:/etc/grafana/provisioning/dashboards:ro
+      - ../../../config/monitoring/grafana/knowledge-system/dashboards:/var/lib/grafana/dashboards:ro
+    environment:
+      - GF_SECURITY_ADMIN_USER=admin
+      - GF_SECURITY_ADMIN_PASSWORD=${GRAFANA_ADMIN_PASSWORD:-admin}
+      - GF_USERS_ALLOW_SIGN_UP=false
+      - GF_SERVER_ROOT_URL=http://localhost:3002
+    depends_on:
+      prometheus:
+        condition: service_healthy

package/.deepquark/skills/bundled/knowledge-graph/server/docker-compose-neo4j-dev-local.yml

@@ -0,0 +1,161 @@
+# Docker Compose configuration for Madeinoz Knowledge System with Neo4j backend
+# Alternative to FalkorDB - uses Neo4j for the graph database
+
+name: madeinoz-knowledge-system
+#
+# Services:
+#   - neo4j: Graph database backend (Cypher queries)
+#   - graphiti-mcp: MCP server (exposed to host)
+#   - prometheus: Metrics server (optional, via --profile monitoring)
+#   - grafana: Dashboard (optional, via --profile monitoring)
+#
+# Madeinoz Patches APPLIED:
+#   1. entrypoint.sh - Maps MADEINOZ_KNOWLEDGE_* prefixed variables to unprefixed
+#      container variables. This keeps .env clean while providing what container expects.
+#
+# IMPORTANT NOTE - Docker Compose v2.14 Bug on macOS:
+#   If you get "key cannot contain a space" error, use the workaround:
+#   1. Create file in /tmp: git show HEAD:src/server/docker-compose-neo4j.yml > /tmp/docker-compose-neo4j.yml
+#   2. Run: docker compose -f /tmp/docker-compose-neo4j.yml up -d
+#
+# Usage from pack directory:
+#   1. Configure MADEINOZ_KNOWLEDGE_* variables in $PAI_DIR/.env (or ~/.claude/.env)
+#   2. Build custom image: docker build -t madeinoz-knowledge-system:fixed .
+#   3. Run: bun run server start (PREFERRED - auto-generates env files)
+#      Or legacy: bun run src/server/run.ts OR ./src/server/start.sh
+#   4. MCP server uses HTTP transport at: http://localhost:8000/mcp
+#   5. Access Neo4j Browser at: http://localhost:7474
+#
+# Monitoring (optional):
+#   docker compose -f src/skills/server/docker-compose-neo4j.yml --profile monitoring up -d
+#   Access:
+#     - Prometheus UI: http://localhost:9092
+#     - Grafana: http://localhost:3001 (admin/admin)
+#
+# NOTE: The preferred 'bun run server start' command auto-generates the required
+#       /tmp/madeinoz-knowledge-*.env files from your PAI configuration.
+
+networks:
+  madeinoz-knowledge-net:
+    driver: bridge
+
+volumes:
+  neo4j-data:
+    driver: local
+  neo4j-logs:
+    driver: local
+  prometheus-data:
+    driver: local
+  grafana-data:
+    driver: local
+
+services:
+  # Neo4j Graph Database
+  # Native graph database with Cypher query language
+  neo4j:
+    image: neo4j:latest
+    container_name: madeinoz-knowledge-neo4j
+    restart: unless-stopped
+    networks:
+      - madeinoz-knowledge-net
+    ports:
+      - "7474:7474"  # Neo4j Browser HTTP
+      - "7687:7687"  # Bolt protocol
+    volumes:
+      - neo4j-data:/data
+      - neo4j-logs:/logs
+    environment:
+      # NEO4J_PASSWORD interpolated from host env (start.sh exports it)
+      - NEO4J_AUTH=neo4j/${NEO4J_PASSWORD:-madeinozknowledge}
+      - NEO4J_server_memory_heap_initial__size=512m
+      - NEO4J_server_memory_heap_max__size=1G
+      - NEO4J_server_memory_pagecache_size=512m
+      - NEO4J_dbms_usage__report_enabled=false
+    healthcheck:
+      test: ["CMD", "wget", "-O", "/dev/null", "http://localhost:7474"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+      start_period: 60s
+
+  # Graphiti MCP Server (Neo4j backend)
+  # Environment variables provided via env_file generated by start.sh
+  graphiti-mcp:
+    image: madeinozknowledge-system:local
+    container_name: madeinoz-knowledge-graph-mcp
+    restart: unless-stopped
+    networks:
+      - madeinoz-knowledge-net
+    ports:
+      - "8000:8000"  # MCP HTTP endpoint
+      - "9090:9090"  # Prometheus metrics endpoint
+    env_file:
+      # Generated by start.sh from MADEINOZ_KNOWLEDGE_* prefixed variables
+      - /tmp/madeinoz-knowledge-mcp.env
+    environment:
+      # Logging: INFO for production (set DEBUG manually for troubleshooting)
+      - LOG_LEVEL=INFO
+    depends_on:
+      neo4j:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD", "curl", "-sf", "--max-time", "5", "http://localhost:8000/health"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+    command: ["uv", "run", "main.py"]
+
+  # Prometheus Metrics Server (Production)
+  # Only started when --profile monitoring is specified
+  prometheus:
+    image: prom/prometheus:latest
+    container_name: madeinoz-knowledge-prometheus
+    profiles: [monitoring]
+    restart: unless-stopped
+    networks:
+      - madeinoz-knowledge-net
+    ports:
+      - "9092:9090"  # Prometheus UI
+    volumes:
+      - prometheus-data:/prometheus
+      - ../../../config/monitoring/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro
+    command:
+      - '--config.file=/etc/prometheus/prometheus.yml'
+      - '--storage.tsdb.path=/prometheus'
+      - '--web.enable-lifecycle'
+      - '--storage.tsdb.retention.time=30d'
+    depends_on:
+      graphiti-mcp:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD", "wget", "-q", "--spider", "http://localhost:9090/-/healthy"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 10s
+
+  # Grafana Dashboard (Production)
+  # Only started when --profile monitoring is specified
+  grafana:
+    image: grafana/grafana:latest
+    container_name: madeinoz-knowledge-grafana
+    profiles: [monitoring]
+    restart: unless-stopped
+    networks:
+      - madeinoz-knowledge-net
+    ports:
+      - "3001:3000"  # Grafana UI
+    volumes:
+      - grafana-data:/var/lib/grafana
+      - ../../../config/monitoring/grafana/provisioning/datasources:/etc/grafana/provisioning/datasources:ro
+      - ../../../config/monitoring/grafana/knowledge-system/dashboards:/etc/grafana/provisioning/dashboards:ro
+      - ../../../config/monitoring/grafana/knowledge-system/dashboards:/var/lib/grafana/dashboards:ro
+    environment:
+      - GF_SECURITY_ADMIN_USER=admin
+      - GF_SECURITY_ADMIN_PASSWORD=${GRAFANA_ADMIN_PASSWORD:-admin}
+      - GF_USERS_ALLOW_SIGN_UP=false
+      - GF_SERVER_ROOT_URL=http://localhost:3001
+    depends_on:
+      prometheus:
+        condition: service_healthy

package/.deepquark/skills/bundled/knowledge-graph/server/docker-compose-neo4j-dev.yml

@@ -0,0 +1,161 @@
+# Docker Compose configuration for Madeinoz Knowledge System - DEVELOPMENT
+# Uses locally-built Docker image for testing code changes (Feature 009 memory decay scoring)
+#
+# Differences from production:
+#   - Uses local image: madeinoz-knowledge-system:local
+#   - Dev ports: Neo4j Browser 7475, MCP 8001, Metrics 9091
+#   - Dev container names with -dev suffix
+#   - Dev env files: /tmp/madeinoz-knowledge-*-dev.env
+#   - Dev volumes: dev-* prefixed to isolate from production
+#   - Dev network: madeinoz-knowledge-dev-net
+#
+# Build local image:
+#   docker build -t madeinoz-knowledge-system:local -f docker/Dockerfile .
+#
+# Start dev server:
+#   bun run server-cli start --dev
+#
+# Access points:
+#   - Neo4j Browser: http://localhost:7475
+#   - MCP Server: http://localhost:8001
+#   - Prometheus Metrics: http://localhost:9091/metrics
+#   - Prometheus UI: http://localhost:9093
+#   - Grafana: http://localhost:3002 (admin/admin)
+#
+# Port Mapping (Dev vs Prod):
+#   Dev  -> Prod
+#   7475 -> 7474  (Neo4j Browser)
+#   7688 -> 7687  (Neo4j Bolt)
+#   8001 -> 8000  (MCP Server)
+#   9091 -> 9090  (Prometheus Metrics)
+#   9093 -> 9092  (Prometheus UI)
+#   3002 -> 3001  (Grafana)
+
+name: madeinoz-knowledge-system-dev
+
+networks:
+  madeinoz-knowledge-dev-net:
+    driver: bridge
+
+volumes:
+  dev-neo4j-data:
+    driver: local
+  dev-neo4j-logs:
+    driver: local
+  dev-prometheus-data:
+    driver: local
+  dev-grafana-data:
+    driver: local
+
+services:
+  # Neo4j Graph Database (Development)
+  neo4j:
+    image: neo4j:latest
+    container_name: madeinoz-knowledge-neo4j-dev
+    restart: unless-stopped
+    networks:
+      - madeinoz-knowledge-dev-net
+    ports:
+      - "7475:7474"  # Neo4j Browser HTTP (dev port)
+      - "7688:7687"  # Bolt protocol (dev port)
+    volumes:
+      - dev-neo4j-data:/data
+      - dev-neo4j-logs:/logs
+    environment:
+      # Hardcoded dev password for development
+      - NEO4J_AUTH=neo4j/devpassword
+      - NEO4J_server_memory_heap_initial__size=256m
+      - NEO4J_server_memory_heap_max__size=512m
+      - NEO4J_server_memory_pagecache_size=256m
+      - NEO4J_dbms_usage__report_enabled=false
+    healthcheck:
+      test: ["CMD", "wget", "-O", "/dev/null", "http://localhost:7474"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+      start_period: 60s
+
+  # Graphiti MCP Server (Development)
+  # Uses locally built image with Feature 009 memory decay scoring
+  graphiti-mcp:
+    image: madeinoz-knowledge-system:local
+    container_name: madeinoz-knowledge-graph-mcp-dev
+    restart: unless-stopped
+    networks:
+      - madeinoz-knowledge-dev-net
+    ports:
+      - "8001:8000"  # MCP HTTP endpoint (dev port)
+      - "9091:9090"  # Prometheus metrics endpoint (dev port)
+    env_file:
+      # Generated by start.sh from MADEINOZ_KNOWLEDGE_* prefixed variables
+      - /tmp/madeinoz-knowledge-mcp-dev.env
+    environment:
+      # Hardcoded dev password for development (overrides env_file)
+      - NEO4J_PASSWORD=devpassword
+      # Logging: DEBUG for development (verbose output)
+      - LOG_LEVEL=DEBUG
+      # Enable prompt caching for development/testing
+      - PROMPT_CACHE_ENABLED=true
+      - PROMPT_CACHE_METRICS_ENABLED=true
+    depends_on:
+      neo4j:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD", "curl", "-sf", "--max-time", "5", "http://localhost:8000/health"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+    command: ["uv", "run", "main.py"]
+
+  # Prometheus Metrics Server (Development)
+  # Scrapes metrics from graphiti-mcp service
+  prometheus:
+    image: prom/prometheus:latest
+    container_name: madeinoz-knowledge-prometheus-dev
+    restart: unless-stopped
+    networks:
+      - madeinoz-knowledge-dev-net
+    ports:
+      - "9093:9090"  # Prometheus UI (dev port)
+    volumes:
+      - dev-prometheus-data:/prometheus
+      - ../../../config/monitoring/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro
+    command:
+      - '--config.file=/etc/prometheus/prometheus.yml'
+      - '--storage.tsdb.path=/prometheus'
+      - '--web.enable-lifecycle'
+      - '--storage.tsdb.retention.time=15d'
+    depends_on:
+      graphiti-mcp:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD", "wget", "-q", "--spider", "http://localhost:9090/-/healthy"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 10s
+
+  # Grafana Dashboard (Development)
+  # Pre-configured with Prometheus datasource and dashboards
+  grafana:
+    image: grafana/grafana:latest
+    container_name: madeinoz-knowledge-grafana-dev
+    restart: unless-stopped
+    networks:
+      - madeinoz-knowledge-dev-net
+    ports:
+      - "3002:3000"  # Grafana UI (dev port)
+    volumes:
+      - dev-grafana-data:/var/lib/grafana
+      - ../../../config/monitoring/grafana/provisioning/datasources:/etc/grafana/provisioning/datasources:ro
+      - ../../../config/monitoring/grafana/knowledge-system/dashboards:/etc/grafana/provisioning/dashboards:ro
+      - ../../../config/monitoring/grafana/knowledge-system/dashboards:/var/lib/grafana/dashboards:ro
+    environment:
+      - GF_SECURITY_ADMIN_USER=admin
+      - GF_SECURITY_ADMIN_PASSWORD=${GRAFANA_ADMIN_PASSWORD:-admin}
+      - GF_USERS_ALLOW_SIGN_UP=false
+      - GF_SERVER_ROOT_URL=http://localhost:3002
+    depends_on:
+      prometheus:
+        condition: service_healthy

package/.deepquark/skills/bundled/knowledge-graph/server/docker-compose-neo4j.yml

@@ -0,0 +1,169 @@
+# Docker Compose configuration for Madeinoz Knowledge System with Neo4j backend
+# Alternative to FalkorDB - uses Neo4j for the graph database
+
+name: madeinoz-knowledge-system
+#
+# Services:
+#   - neo4j: Graph database backend (Cypher queries)
+#   - graphiti-mcp: MCP server (exposed to host)
+#   - prometheus: Metrics server (optional, via --profile monitoring)
+#   - grafana: Dashboard (optional, via --profile monitoring)
+#
+# Madeinoz Patches APPLIED:
+#   1. entrypoint.sh - Maps MADEINOZ_KNOWLEDGE_* prefixed variables to unprefixed
+#      container variables. This keeps .env clean while providing what container expects.
+#
+# IMPORTANT NOTE - Docker Compose v2.14 Bug on macOS:
+#   If you get "key cannot contain a space" error, use the workaround:
+#   1. Create file in /tmp: git show HEAD:src/server/docker-compose-neo4j.yml > /tmp/docker-compose-neo4j.yml
+#   2. Run: docker compose -f /tmp/docker-compose-neo4j.yml up -d
+#
+# Usage from pack directory:
+#   1. Configure MADEINOZ_KNOWLEDGE_* variables in $PAI_DIR/.env (or ~/.claude/.env)
+#   2. Build custom image: docker build -t madeinoz-knowledge-system:fixed .
+#   3. Run: bun run server start (PREFERRED - auto-generates env files)
+#      Or legacy: bun run src/server/run.ts OR ./src/server/start.sh
+#   4. MCP server uses HTTP transport at: http://localhost:8000/mcp
+#   5. Access Neo4j Browser at: http://localhost:7474
+#
+# Monitoring (optional):
+#   docker compose -f src/skills/server/docker-compose-neo4j.yml --profile monitoring up -d
+#   Access:
+#     - Prometheus UI: http://localhost:9092
+#     - Grafana: http://localhost:3001 (admin/admin)
+#
+# NOTE: The preferred 'bun run server start' command auto-generates the required
+#       /tmp/madeinoz-knowledge-*.env files from your PAI configuration.
+
+networks:
+  madeinoz-knowledge-net:
+    driver: bridge
+
+volumes:
+  neo4j-data:
+    driver: local
+  neo4j-logs:
+    driver: local
+  prometheus-data:
+    driver: local
+  grafana-data:
+    driver: local
+
+services:
+  # Neo4j Graph Database
+  # Native graph database with Cypher query language
+  neo4j:
+    image: neo4j:latest
+    container_name: madeinoz-knowledge-neo4j
+    restart: unless-stopped
+    networks:
+      - madeinoz-knowledge-net
+    ports:
+      - "7474:7474" # Neo4j Browser HTTP
+      - "7687:7687" # Bolt protocol
+    volumes:
+      - neo4j-data:/data
+      - neo4j-logs:/logs
+    environment:
+      # NEO4J_PASSWORD interpolated from host env (start.sh exports it)
+      - NEO4J_AUTH=neo4j/${NEO4J_PASSWORD:-madeinozknowledge}
+      - NEO4J_server_memory_heap_initial__size=512m
+      - NEO4J_server_memory_heap_max__size=1G
+      - NEO4J_server_memory_pagecache_size=512m
+      - NEO4J_dbms_usage__report_enabled=false
+    healthcheck:
+      test: ["CMD", "wget", "-O", "/dev/null", "http://localhost:7474"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+      start_period: 60s
+
+  # Graphiti MCP Server (Neo4j backend)
+  # Environment variables provided via env_file generated by start.sh
+  graphiti-mcp:
+    image: ghcr.io/madeinoz67/madeinoz-knowledge-system:1.8.3
+    container_name: madeinoz-knowledge-graph-mcp
+    restart: unless-stopped
+    networks:
+      - madeinoz-knowledge-net
+    ports:
+      - "8000:8000" # MCP HTTP endpoint
+      - "9090:9090" # Prometheus metrics endpoint
+    env_file:
+      # Generated by start.sh from MADEINOZ_KNOWLEDGE_* prefixed variables
+      - /tmp/madeinoz-knowledge-mcp.env
+    environment:
+      # Logging: INFO for production (set DEBUG manually for troubleshooting)
+      - LOG_LEVEL=INFO
+    depends_on:
+      neo4j:
+        condition: service_healthy
+    healthcheck:
+      test:
+        [
+          "CMD",
+          "curl",
+          "-sf",
+          "--max-time",
+          "5",
+          "http://localhost:8000/health",
+        ]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+    command: ["uv", "run", "main.py"]
+
+  # Prometheus Metrics Server (Production)
+  # Only started when --profile monitoring is specified
+  prometheus:
+    image: prom/prometheus:latest
+    container_name: madeinoz-knowledge-prometheus
+    profiles: [monitoring]
+    restart: unless-stopped
+    networks:
+      - madeinoz-knowledge-net
+    ports:
+      - "9092:9090" # Prometheus UI
+    volumes:
+      - prometheus-data:/prometheus
+      - ../../../config/monitoring/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro
+    command:
+      - "--config.file=/etc/prometheus/prometheus.yml"
+      - "--storage.tsdb.path=/prometheus"
+      - "--web.enable-lifecycle"
+      - "--storage.tsdb.retention.time=30d"
+    depends_on:
+      graphiti-mcp:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD", "wget", "-q", "--spider", "http://localhost:9090/-/healthy"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 10s
+
+  # Grafana Dashboard (Production)
+  # Only started when --profile monitoring is specified
+  grafana:
+    image: grafana/grafana:latest
+    container_name: madeinoz-knowledge-grafana
+    profiles: [monitoring]
+    restart: unless-stopped
+    networks:
+      - madeinoz-knowledge-net
+    ports:
+      - "3001:3000" # Grafana UI
+    volumes:
+      - grafana-data:/var/lib/grafana
+      - ../../../config/monitoring/grafana/provisioning/datasources:/etc/grafana/provisioning/datasources:ro
+      - ../../../config/monitoring/grafana/knowledge-system/dashboards:/etc/grafana/provisioning/dashboards:ro
+      - ../../../config/monitoring/grafana/knowledge-system/dashboards:/var/lib/grafana/dashboards:ro
+    environment:
+      - GF_SECURITY_ADMIN_USER=admin
+      - GF_SECURITY_ADMIN_PASSWORD=${GRAFANA_ADMIN_PASSWORD:-admin}
+      - GF_USERS_ALLOW_SIGN_UP=false
+      - GF_SERVER_ROOT_URL=http://localhost:3001
+    depends_on:
+      prometheus:
+        condition: service_healthy