RC-1

.env.example

@@ -2,7 +2,14 @@
 BRAIN_MODE=brain
 
 # HTTP
+# Direct binary listen address. Docker Compose listens internally on :8090 and
+# exposes BRAIN_PORT on the host.
 BRAIN_LISTEN_ADDR=:8090
+# Docker Compose host port (not consumed by the binary itself).
+BRAIN_PORT=8090
+# URL that remote/source-agent containers can actually reach. Do not use
+# localhost/127.0.0.1 here for a separate container.
+BRAIN_PUBLIC_URL=
 BRAIN_DATA_DIR=./data
 BRAIN_API_KEY=
 
@@ -98,6 +105,8 @@ BRAIN_SOURCE_INBOX_ENABLED=true
 BRAIN_SOURCE_INBOX_INTERVAL=30s
 BRAIN_SOURCE_INBOX_BATCH_SIZE=12
 BRAIN_SOURCE_INBOX_MIN_SIMILARITY=0.55
+BRAIN_SOURCE_INBOX_MIN_PRIORITY=0.55
+BRAIN_SOURCE_INBOX_NOVELTY_FLOOR=0.35
 BRAIN_SOURCE_INBOX_MIN_RESULTS=2
 # Freshness-sensitive article queries only reuse inbox documents newer than this.
 BRAIN_SOURCE_INBOX_FRESH_MAX_AGE=168h
@@ -189,6 +198,11 @@ BRAIN_AUTONOMOUS_RESEARCH_OPPORTUNITY_LIMIT=8
 # A local JSON bootstrap file may be used instead of URL/ID/token envs.
 # -----------------------------------------------------------------------------
 # BRAIN_MODE=agent
+# Docker Compose publishes the Agent status UI on BRAIN_AGENT_PORT (default 8092).
+# BRAIN_AGENT_PORT=8092
+# Use the Brain service name on a shared Docker network, a LAN/DNS address, or
+# host.docker.internal:<BRAIN_PORT> for a separate Agent container on the same host.
+# Never use 127.0.0.1/localhost for a separate container.
 # BRAIN_AGENT_BRAIN_URL=https://brain.example.org
 # BRAIN_AGENT_ID=security-news-01
 # BRAIN_AGENT_TOKEN=brain_agent_xxxxxxxxx