Refine env example and Render defaults

Author: baum777

.env.example

@@ -1,84 +1,110 @@
 # =============================================================================
-# Core deploy runtime
+# Core runtime / deploy
 # =============================================================================
 
-# X OAuth2 user refresh flow (required for polling and posting)
-X_CLIENT_ID=
-X_CLIENT_SECRET=
-X_REFRESH_TOKEN=
-X_REFRESH_BUFFER_SECONDS=300
-X_OAUTH_TOKEN_URL=https://api.x.com/2/oauth2/token
+NODE_ENV=production
+# Web-service only; the worker path ignores this.
+PORT=10000
+DATA_DIR=/data
+LOG_LEVEL=INFO
 
-# xAI LLM path used by the Render deploy
-XAI_API_KEY=
-XAI_BASE_URL=https://api.x.ai/v1
-XAI_MODEL_PRIMARY=grok-3
-XAI_MODEL_FALLBACKS=grok-3-mini
+# =============================================================================
+# Launch / activation / polling
+# =============================================================================
 
-# Render / worker runtime
 LAUNCH_MODE=prod
-# Legacy fallback; LAUNCH_MODE is the primary switch now.
+# Optional legacy fallback for local scripts/tests when LAUNCH_MODE is unset.
 # DRY_RUN=false
-LOG_LEVEL=INFO
-USE_REDIS=true
-KV_URL=
-REDIS_KEY_PREFIX=ORGANOID:
-DATA_DIR=/data
-
-# Bot runtime
+# Runtime handle used by polling/posting.
 BOT_USERNAME=organoid_on_sol
+# Conservative base; render.yaml keeps the production override explicit.
 BOT_ACTIVATION_MODE=global
-BOT_DENY_REPLY_MODE=silent
-ADAPTIVE_POLLING_ENABLED=true
-MENTIONS_SOURCE=search
+# Optional allowlist used only when LAUNCH_MODE=staging
+# ALLOWLIST_HANDLES=
+# Optional activation whitelist when BOT_ACTIVATION_MODE=whitelist
+# BOT_WHITELIST_USERNAMES=
+# BOT_WHITELIST_USER_IDS=
 POLL_INTERVAL_MS=30000
+MENTIONS_SOURCE=search
 
 # =============================================================================
-# Optional X OAuth bootstrap state
+# X / Twitter API
 # =============================================================================
-# X_ACCESS_TOKEN=
+
+# Required for X OAuth refresh flow and live posting.
+X_CLIENT_ID=
+X_CLIENT_SECRET=
+X_REFRESH_TOKEN=
+# Optional access token cache; refresh still works without it.
+X_ACCESS_TOKEN=
+X_REFRESH_BUFFER_SECONDS=300
+X_OAUTH_TOKEN_URL=https://api.x.com/2/oauth2/token
+# Optional bootstrap/cache state for local OAuth helper scripts; keep these out of Render secrets unless needed.
 # X_EXPIRES_IN=7200
 # X_TOKEN_CREATED_AT=
 # X_BOT_USER_ID=
+# X_BOT_USERNAME=
+
+# =============================================================================
+# Storage / state / redis / kv
+# =============================================================================
+
+# Conservative base; Render overrides this to true and requires KV_URL.
+USE_REDIS=false
+# Only if USE_REDIS=true.
+KV_URL=
+REDIS_KEY_PREFIX=ORGANOID:
+# Optional overrides.
+# MAX_LLM_CALLS_PER_MINUTE=30
+# COST_WEIGHT_THREAD=2
+# COST_WEIGHT_REPLY=1
+# RATE_LIMIT_BACKEND=store
+# POLL_LOCK_ENABLED=true
+# DEBUG_ARTIFACTS=false
 
 # =============================================================================
-# Optional launch and provider overrides
+# Networking / fetch
 # =============================================================================
-# LLM_PROVIDER=xai
+
+# Optional HTTP retry tuning used by shared fetch helpers.
+# FETCH_TIMEOUT_MS=30000
+# FETCH_BACKOFF_BASE_MS=5000
+# FETCH_BACKOFF_MAX_MS=300000
+# FETCH_RETRY_JITTER_MS=500
+
+# =============================================================================
+# LLM / provider keys
+# =============================================================================
+
+LLM_PROVIDER=xai
+# Only for optional provider fallback if the primary is unavailable.
 # LLM_FALLBACK_PROVIDER=
-# LLM_API_KEY=
+XAI_API_KEY=
+XAI_BASE_URL=https://api.x.ai/v1
+XAI_MODEL_PRIMARY=grok-3
+XAI_MODEL_FALLBACKS=grok-3-mini
+# Optional alternative provider credentials.
 # OPENAI_API_KEY=
 # OPENAI_MODEL=gpt-4o-mini
 # OPENAI_BASE_URL=https://api.openai.com/v1
 # ANTHROPIC_API_KEY=
 # ANTHROPIC_MODEL=claude-3-5-sonnet-latest
 # ANTHROPIC_BASE_URL=https://api.anthropic.com/v1
-# LLM_TEMPERATURE=0.7
-# LLM_MAX_TOKENS=350
+# Optional runtime tuning.
 # LLM_TIMEOUT_MS=30000
+# LLM_MAX_TOKENS=350
+# LLM_TEMPERATURE=0.7
 # LLM_CANNED_FALLBACK=Sorry, gerade keine Antwort moeglich
 
 # =============================================================================
-# Optional storage and rate-limit tuning
+# Safety / engagement / feature flags
 # =============================================================================
-# MAX_LLM_CALLS_PER_MINUTE=30
-# COST_WEIGHT_THREAD=2
-# COST_WEIGHT_REPLY=1
-# REDIS_URL=
-# RATE_LIMIT_BACKEND=store
-# POLL_LOCK_ENABLED=true
-# SKIP_ENV_VALIDATION=false
-# DEBUG_ARTIFACTS=false
 
-# =============================================================================
-# Optional whitelist and engagement controls
-# =============================================================================
-# ALLOWLIST_HANDLES=
-# BOT_WHITELIST_USERNAMES=
-# BOT_WHITELIST_USER_IDS=
+# Optional compliance gate for proactive engagement.
 # ENGAGEMENT_AI_APPROVED=false
 # ENGAGEMENT_OPT_IN_HANDLES=
 # ENGAGEMENT_OPT_OUT_HANDLES=
+# Only for the proactive timeline loop.
 # TIMELINE_ENGAGEMENT_ENABLED=false
 # TIMELINE_ENGAGEMENT_INTERVAL_MS=600000
 # TIMELINE_ENGAGEMENT_MAX_PER_RUN=2
@@ -93,8 +119,33 @@ POLL_INTERVAL_MS=30000
 # TIMELINE_CONVERSATION_COOLDOWN_MINUTES=120
 
 # =============================================================================
-# Optional memory and semantic layers
+# Orchestration / embodiments / hybrid runtime
 # =============================================================================
+
+# EMBODIMENTS_ENABLED=true
+# DEFAULT_SAFE_EMBODIMENT=stillhalter
+# EMBODIMENT_ROUTING_DEBUG=false
+# Conservative base; render.yaml keeps orchestration off explicitly.
+# EMBODIMENT_ORCHESTRATION_ENABLED=false
+# EMBODIMENT_CONTINUITY_ENABLED=true
+# EMBODIMENT_SWARM_ENABLED=false
+# EMBODIMENT_MAX_CAMEOS=2
+# Optional embodiment feature flags that stay false unless explicitly enabled.
+# EMBODIMENT_MEMORY_ENABLED=false
+# EMBODIMENT_EVOLUTION_ENABLED=false
+# EMBODIMENT_RUNNING_JOKES_ENABLED=false
+# EMBODIMENT_TRAIT_DRIFT_LIMIT=0.25
+# EMBODIMENT_ENSEMBLE_ENABLED=false
+# EMBODIMENT_AUTONOMY_ENABLED=false
+# EMBODIMENT_ARC_ENGINE_ENABLED=false
+# EMBODIMENT_WORLD_ENABLED=false
+# EMBODIMENT_WORLD_EVENTS_ENABLED=false
+# EMBODIMENT_FACTIONS_ENABLED=false
+# EMBODIMENT_RITUALS_ENABLED=false
+# EMBODIMENT_LORE_EXPANSION_ENABLED=false
+# Optional governance ceilings for world/ritual overlays.
+# EMBODIMENT_MAX_ACTIVE_WORLD_EVENTS=2
+# EMBODIMENT_MAX_ACTIVE_RITUAL_OVERLAYS=1
 # HYBRID_RUNTIME_MODE=hybrid
 # HYBRID_MEMORY_STORE_PATH=
 # HYBRID_MEMORY_FILE_PATH=
@@ -108,60 +159,21 @@ POLL_INTERVAL_MS=30000
 # HYBRID_RUNTIME_MAX_REASONS=4
 # HYBRID_RUNTIME_MAX_CONTEXT_CHARS=720
 
-# SEMANTIC_ENABLED=false
-# SEMANTIC_MODE=shadow
-# SEMANTIC_TOPK=20
-# SEMANTIC_CLUSTER_SIM=0.82
-# SEMANTIC_QUERY_MAX_RESULTS=50
-# SEMANTIC_MEMORY_TTL_DAYS=14
-# SEMANTIC_INDEX_TTL_DAYS=7
-# SEMANTIC_INDEX_MAX_DOCS=2000
-
 # =============================================================================
-# Optional identity and Solana verification
+# Identity / Solana
 # =============================================================================
-# BOT_TOKEN_MINT=
+
+# BOT_TOKEN_MINT=So11111111111111111111111111111111111111112
 # BOT_TREASURY_WALLET=
 # BOT_TICKER=Organoid
 # BOT_PROGRAM_ID=
 # SOLANA_RPC_PRIMARY_URL=https://api.mainnet-beta.solana.com
 # SOLANA_RPC_FALLBACK_URL=https://solana-api.projectserum.com
 
 # =============================================================================
-# Embodiment runtime
+# Observability / pulse heart
 # =============================================================================
-# EMBODIMENTS_ENABLED=true
-# DEFAULT_SAFE_EMBODIMENT=stillhalter
-# EMBODIMENT_MEMORY_ENABLED=false
-# EMBODIMENT_ROUTING_DEBUG=false
-# EMBODIMENT_CONTINUITY_ENABLED=true
-# EMBODIMENT_EVOLUTION_ENABLED=false
-# EMBODIMENT_RUNNING_JOKES_ENABLED=false
-# EMBODIMENT_SWARM_ENABLED=false
-# EMBODIMENT_TRAIT_DRIFT_LIMIT=0.25
-# EMBODIMENT_ENSEMBLE_ENABLED=false
-# EMBODIMENT_AUTONOMY_ENABLED=false
-# EMBODIMENT_ARC_ENGINE_ENABLED=false
-# EMBODIMENT_MAX_CAMEOS=2
-# EMBODIMENT_WORLD_ENABLED=false
-# EMBODIMENT_FACTIONS_ENABLED=false
-# EMBODIMENT_WORLD_EVENTS_ENABLED=false
-# EMBODIMENT_RITUALS_ENABLED=false
-# EMBODIMENT_LORE_EXPANSION_ENABLED=false
-# EMBODIMENT_MAX_ACTIVE_WORLD_EVENTS=2
-# EMBODIMENT_MAX_ACTIVE_RITUAL_OVERLAYS=1
-# EMBODIMENT_SAFE_MODE=false
 
-# =============================================================================
-# Optional local tooling
-# =============================================================================
-# REPLICATE_API_KEY=
-# REPLICATE_IMAGE_MODEL=black-forest-labs/flux-schnell
-# REPLICATE_RUN_TIMEOUT_MS=45000
-# REPLICATE_DOWNLOAD_TIMEOUT_MS=20000
-# AGGRESSIVE_MODE=analyst
-# TEST_MODE=true
-# FULL_SPECTRUM_PROMPT=true
-# DEMO_OUTPUT_DIR=out
-# DEMO_INPUT_IMAGE=assets/demo_base.png
-# EMBODIMENT_SEMANTIC_VERSION=v1
+# Optional console/terminal tap controls for pulse-heart telemetry.
+# ORGANOID_PULSE_HEART_TERMINAL=true
+# ORGANOID_PULSE_HEART_CONSOLE_TAP=false

render.yaml

@@ -52,6 +52,8 @@ services:
         value: https://api.x.com/2/oauth2/token
 
       # LLM Provider (xAI)
+      - key: LLM_PROVIDER
+        value: xai
       - key: XAI_API_KEY
         sync: false
       - key: XAI_BASE_URL
@@ -68,14 +70,14 @@ services:
         value: prod
       - key: BOT_ACTIVATION_MODE
         value: global
+      - key: EMBODIMENT_ORCHESTRATION_ENABLED
+        value: "false"
 
       # Polling
       - key: POLL_INTERVAL_MS
         value: "30000"
       - key: MENTIONS_SOURCE
         value: search
-      - key: ADAPTIVE_POLLING_ENABLED
-        value: "true"
 
       # Logging
       - key: LOG_LEVEL

src/state/storeFactory.ts

@@ -38,7 +38,7 @@ export function getStateStore(): StateStore {
     }
 
     logInfo("[StateStore] ✅ Redis Backend aktiv (Production Default)", {
-      prefix: process.env.REDIS_KEY_PREFIX ?? "organoid:",
+      prefix: process.env.REDIS_KEY_PREFIX ?? "ORGANOID:",
     });
     cachedStore = getRedisStore(kvUrl);
   } else {