Cortex debugging logs cleaned up

.env.logging.example

@@ -0,0 +1,132 @@
+# ============================================================================
+# CORTEX LOGGING CONFIGURATION
+# ============================================================================
+# This file contains all logging-related environment variables for the
+# Cortex reasoning pipeline. Copy this to your .env file and adjust as needed.
+#
+# Log Detail Levels:
+#   minimal  - Only errors and critical events
+#   summary  - Stage completion + errors (DEFAULT - RECOMMENDED FOR PRODUCTION)
+#   detailed - Include raw LLM outputs, RAG results, timing breakdowns
+#   verbose  - Everything including intermediate states, full JSON dumps
+#
+# Quick Start:
+#   - For debugging weak links: LOG_DETAIL_LEVEL=detailed
+#   - For finding performance bottlenecks: LOG_DETAIL_LEVEL=detailed + VERBOSE_DEBUG=true
+#   - For production: LOG_DETAIL_LEVEL=summary
+#   - For silent mode: LOG_DETAIL_LEVEL=minimal
+# ============================================================================
+
+# -----------------------------
+# Primary Logging Level
+# -----------------------------
+# Controls overall verbosity across all components
+LOG_DETAIL_LEVEL=detailed
+
+# Legacy verbose debug flag (kept for compatibility)
+# When true, enables maximum logging including raw data dumps
+VERBOSE_DEBUG=false
+
+# -----------------------------
+# LLM Logging
+# -----------------------------
+# Enable raw LLM response logging (only works with detailed/verbose levels)
+# Shows full JSON responses from each LLM backend call
+# Set to "true" to see exact LLM outputs for debugging weak links
+LOG_RAW_LLM_RESPONSES=true
+
+# -----------------------------
+# Context Logging
+# -----------------------------
+# Show full raw intake data (L1-L30 summaries) in logs
+# WARNING: Very verbose, use only for deep debugging
+LOG_RAW_CONTEXT_DATA=false
+
+# -----------------------------
+# Loop Detection & Protection
+# -----------------------------
+# Enable duplicate message detection to prevent processing loops
+ENABLE_DUPLICATE_DETECTION=true
+
+# Maximum number of messages to keep in session history (prevents unbounded growth)
+# Older messages are trimmed automatically
+MAX_MESSAGE_HISTORY=100
+
+# Session TTL in hours - sessions inactive longer than this are auto-expired
+SESSION_TTL_HOURS=24
+
+# -----------------------------
+# NeoMem / RAG Logging
+# -----------------------------
+# Relevance score threshold for NeoMem results
+RELEVANCE_THRESHOLD=0.4
+
+# Enable NeoMem long-term memory retrieval
+NEOMEM_ENABLED=false
+
+# -----------------------------
+# Autonomous Features
+# -----------------------------
+# Enable autonomous tool invocation (RAG, WEB, WEATHER, CODEBRAIN)
+ENABLE_AUTONOMOUS_TOOLS=true
+
+# Confidence threshold for autonomous tool invocation (0.0 - 1.0)
+AUTONOMOUS_TOOL_CONFIDENCE_THRESHOLD=0.6
+
+# Enable proactive monitoring and suggestions
+ENABLE_PROACTIVE_MONITORING=true
+
+# Minimum priority for proactive suggestions to be included (0.0 - 1.0)
+PROACTIVE_SUGGESTION_MIN_PRIORITY=0.6
+
+# ============================================================================
+# EXAMPLE LOGGING OUTPUT AT DIFFERENT LEVELS
+# ============================================================================
+#
+# LOG_DETAIL_LEVEL=summary (RECOMMENDED):
+# ────────────────────────────────────────────────────────────────────────────
+# ✅ [LLM] PRIMARY | 14:23:45.123 | Reply: Based on your question about...
+# 📊 Context | Session: abc123 | Messages: 42 | Last: 5.2min | RAG: 3 results
+# 🧠 Monologue | question | Tone: curious
+# ✨ PIPELINE COMPLETE | Session: abc123 | Total: 1250ms
+# 📤 Output: 342 characters
+# ────────────────────────────────────────────────────────────────────────────
+#
+# LOG_DETAIL_LEVEL=detailed (FOR DEBUGGING):
+# ────────────────────────────────────────────────────────────────────────────
+# 🚀 PIPELINE START | Session: abc123 | 14:23:45.123
+# 📝 User: What is the meaning of life?
+# ────────────────────────────────────────────────────────────────────────────
+# 🧠 LLM CALL | Backend: PRIMARY | 14:23:45.234
+# ────────────────────────────────────────────────────────────────────────────
+# 📝 Prompt: You are Lyra, a thoughtful AI assistant...
+# 💬 Reply: Based on philosophical perspectives, the meaning...
+# ╭─ RAW RESPONSE ────────────────────────────────────────────────────────────
+# │ {
+# │   "choices": [
+# │     {
+# │       "message": {
+# │         "content": "Based on philosophical perspectives..."
+# │       }
+# │     }
+# │   ]
+# │ }
+# ╰───────────────────────────────────────────────────────────────────────────
+#
+# ✨ PIPELINE COMPLETE | Session: abc123 | Total: 1250ms
+# ⏱️  Stage Timings:
+#    context        :   150ms ( 12.0%)
+#    identity       :    10ms (  0.8%)
+#    monologue      :   200ms ( 16.0%)
+#    reasoning      :   450ms ( 36.0%)
+#    refinement     :   300ms ( 24.0%)
+#    persona        :   140ms ( 11.2%)
+# ────────────────────────────────────────────────────────────────────────────
+#
+# LOG_DETAIL_LEVEL=verbose (MAXIMUM DEBUG):
+# Same as detailed but includes:
+# - Full 50+ line raw JSON dumps
+# - Complete intake data structures
+# - All intermediate processing states
+# - Detailed traceback on errors
+# ============================================================================