feat(vision-manager): memory-pressure yield gate (+ retain analysis gate) (#8)

docker-compose.yml

@@ -168,6 +168,14 @@ services:
       START_HEALTH_TIMEOUT: ${VISION_START_HEALTH_TIMEOUT:-300}
       RESPECT_CRAWL_MUTEX: ${VISION_RESPECT_CRAWL_MUTEX:-1}
       MAX_UPTIME: ${VISION_MAX_UPTIME:-0}
+      # Memory-pressure yield — stop vision when the HOST is short on RAM so a
+      # spike elsewhere can finish without the kernel OOM-killer. See
+      # VISION-MEMORY-YIELD.md.
+      MEM_YIELD_ENABLED: ${VISION_MEM_YIELD_ENABLED:-1}
+      MEM_HIGH_WATERMARK_PCT: ${VISION_MEM_HIGH_WATERMARK_PCT:-92}
+      MEM_LOW_WATERMARK_PCT: ${VISION_MEM_LOW_WATERMARK_PCT:-80}
+      MEM_YIELD_COOLDOWN: ${VISION_MEM_YIELD_COOLDOWN:-300}
+      MEM_POLL_INTERVAL: ${VISION_MEM_POLL_INTERVAL:-5}
     networks:
       - default          # reach postgres + the vision container by name
       - vision-internal  # reach the socket-proxy