env.development.template

# ===========================================
# DEVELOPMENT ENVIRONMENT CONFIGURATION
# ===========================================
# This template contains development-specific settings with debugging and hot-reload enabled.
# Copy this file to .env for local development: cp .env.development.template .env
#
# SECURITY NOTE: Never commit .env with real secrets!
# Use .env.local for local overrides (already in .gitignore)
# ===========================================

# ===========================================
# Environment Type
# ===========================================
NODE_ENV=development
BUILD_TARGET=development
DOCKER_ENV=development

# ===========================================
# GPU / CUDA Configuration (Development)
# ===========================================
# Disable GPU features for faster development iteration (uncomment if no GPU available)
# NO_GPU_COMPUTE=true

# NVIDIA_VISIBLE_DEVICES: Controls which GPU(s) are exposed to the Docker container
# - For development, you can use "all" or a specific GPU UUID
# - Find GPU UUID with: nvidia-smi -L
# REQUIRED if using GPU features
NVIDIA_VISIBLE_DEVICES=all

# CUDA_DEVICE: GPU index inside the container (0 for first GPU)
# OPTIONAL - defaults to 0
CUDA_DEVICE=0

# CUDA_ARCH: CUDA compute capability of target GPU
# - 86 for RTX 30-series (Ampere) and RTX A6000
# - 89 for RTX 40-series (Ada)
# REQUIRED if using GPU features
CUDA_ARCH=86

# ===========================================
# GitHub Configuration (Development)
# ===========================================
# REQUIRED: Your GitHub repository details
GITHUB_OWNER=your-github-username
GITHUB_REPO=your-repo-name

# REQUIRED: GitHub Personal Access Token
# Get from: https://github.com/settings/tokens
# Scopes needed: repo (full control)
# SECURITY: Set in .env.local or environment variables
GITHUB_TOKEN=github_pat_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

# OPTIONAL: Base path for repository operations
GITHUB_BASE_PATH=mainKnowledgeGraph/pages

# ===========================================
# RAGFlow Configuration (Development)
# ===========================================
# REQUIRED: RAGFlow API credentials
# SECURITY: Use development/test credentials only
RAGFLOW_API_KEY=ragflow-dev-XXXXXXXXXXXXXXXXXXXXXXXXXXXXX
RAGFLOW_API_BASE_URL=http://localhost:9380
RAGFLOW_AGENT_ID=your-dev-agent-id

# ===========================================
# Perplexity API Configuration (Development)
# ===========================================
# OPTIONAL: Perplexity AI API settings
# Get API key from: https://www.perplexity.ai/settings/api
PERPLEXITY_API_KEY=pplx-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
PERPLEXITY_MODEL=llama-3.1-sonar-small-128k-online
PERPLEXITY_MAX_TOKENS=4096
PERPLEXITY_TEMPERATURE=0.7
PERPLEXITY_TOP_P=0.9
PERPLEXITY_PRESENCE_PENALTY=0.0
PERPLEXITY_FREQUENCY_PENALTY=1.0
PERPLEXITY_API_URL=https://api.perplexity.ai/chat/completions

# ===========================================
# OpenAI Configuration (Development)
# ===========================================
# OPTIONAL: OpenAI API settings
# Get API key from: https://platform.openai.com/api-keys
OPENAI_API_KEY=sk-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
OPENAI_BASE_URL=wss://api.openai.com/v1/realtime
OPENAI_TIMEOUT=30
OPENAI_RATE_LIMIT=100

# ===========================================
# API Client Configuration (Development)
# ===========================================
# Higher concurrency and retries for development testing
MAX_CONCURRENT_REQUESTS=5
MAX_RETRIES=5
RETRY_DELAY=3
API_CLIENT_TIMEOUT=60

# ===========================================
# Data Paths (Development)
# ===========================================
# Local development paths - adjust as needed
DATA_ROOT=./data
MARKDOWN_DIR=./data/markdown
METADATA_DIR=./data/metadata

# ===========================================
# Server Configuration (Development)
# ===========================================
# OPTIONAL: Bind to localhost for security
BIND_ADDRESS=127.0.0.1

# REQUIRED: Enable verbose debugging in development
DEBUG_ENABLED=true
DEBUG_MODE=false

# REQUIRED: Verbose development logging
RUST_LOG=trace,visionflow-server=trace,visionflow-server::config=trace,visionflow-server::models::user_settings=trace,visionflow-server::actors=trace,visionflow-server::handlers=trace,visionflow-server::telemetry=trace,visionflow-server::mcp=trace,visionflow-server::docker_exec=trace,visionflow-server::agent_control=trace

# OPTIONAL: Settings file path
SETTINGS_FILE_PATH=./settings.yaml

# ===========================================
# Cloudflare Tunnel Configuration (Development)
# ===========================================
# OPTIONAL: For exposing local dev to internet
# Get token from: https://dash.cloudflare.com/
CLOUDFLARE_TUNNEL_TOKEN=
TUNNEL_ID=

# ===========================================
# Network Configuration (Development)
# ===========================================
# OPTIONAL: Local development domain
DOMAIN=localhost

# OPTIONAL: Docker registry mirror for faster pulls
DOCKER_REGISTRY_MIRROR=registry-1.docker.io

# ===========================================
# Authentication Configuration (Development)
# ===========================================
# OPTIONAL: Nostr public keys for access control
# Base access control - comma-separated list
APPROVED_PUBKEYS=

# Role-based access control
POWER_USER_PUBKEYS=
SETTINGS_SYNC_ENABLED_PUBKEYS=

# Feature-specific access control
PERPLEXITY_ENABLED_PUBKEYS=
OPENAI_ENABLED_PUBKEYS=
RAGFLOW_ENABLED_PUBKEYS=

# ===========================================
# Claude Flow MCP Configuration (Development)
# ===========================================
# REQUIRED: MCP server connection settings
CLAUDE_FLOW_HOST=localhost
MCP_TCP_PORT=9500
MCP_TRANSPORT=tcp
MCP_RECONNECT_ATTEMPTS=5
MCP_RECONNECT_DELAY=500

# REQUIRED: Management API settings
MANAGEMENT_API_URL=http://localhost:9090
MANAGEMENT_API_KEY=dev-secret-key-change-me
MCP_CONNECTION_TIMEOUT=30000

# ===========================================
# MCP Communication Logging (Development)
# ===========================================
# REQUIRED: Enable all MCP logging for debugging
MCP_LOG_LEVEL=trace
MCP_TCP_DEBUG=true
MCP_CONNECTION_LOGGING=true
MCP_TOOL_CALL_LOGGING=true
MCP_RESPONSE_LOGGING=true
MCP_PROTOCOL_TRACE=true

# ===========================================
# Docker Exec Control Plane Logging (Development)
# ===========================================
# REQUIRED: Enable all Docker exec logging
DOCKER_EXEC_LOGGING=true
DOCKER_EXEC_TRACE=true
DOCKER_COMMAND_DEBUG=true
DOCKER_HIVE_MIND_OPERATIONS=true
DOCKER_PROCESS_LIFECYCLE=true

# ===========================================
# Agent Control System Logging (Development)
# ===========================================
# REQUIRED: Enable all agent control logging
AGENT_CONTROL_LOG_LEVEL=trace
AGENT_SPAWN_LOGGING=true
AGENT_LIFECYCLE_TRACKING=true
AGENT_TELEMETRY_STREAMING=true
AGENT_STATUS_POLLING=true

# ===========================================
# Hybrid Architecture Logging (Development)
# ===========================================
# REQUIRED: Enable all hybrid architecture logging
HYBRID_CONTROL_DEBUG=true
TCP_MCP_DATA_PLANE_LOGGING=true
DOCKER_EXEC_CONTROL_PLANE_LOGGING=true
CROSS_CONTAINER_BRIDGE_LOGGING=true

# ===========================================
# Bots Orchestrator WebSocket (Development)
# ===========================================
# OPTIONAL: Local orchestrator connection
BOTS_ORCHESTRATOR_URL=ws://localhost:3002/ws

# ===========================================
# Security Configuration (Development)
# ===========================================
# JWT Configuration - Use weak secrets for dev (never in production!)
JWT_SECRET=dev-jwt-secret-not-for-production
JWT_EXPIRATION=86400

# Session Configuration
SESSION_SECRET=dev-session-secret-not-for-production
SESSION_TIMEOUT=3600

# WebSocket Security - Disabled for easier development
WS_AUTH_ENABLED=false
WS_AUTH_TOKEN=dev-ws-token
WS_MAX_CONNECTIONS=50
WS_CONNECTION_TIMEOUT=600000
TCP_MAX_CONNECTIONS=25
TCP_CONNECTION_TIMEOUT=600000

# CORS Configuration - Permissive for development
CORS_ALLOWED_ORIGINS=http://localhost:3000,http://localhost:3001,http://127.0.0.1:3000
CORS_ALLOWED_METHODS=GET,POST,PUT,DELETE,OPTIONS,PATCH
CORS_ALLOWED_HEADERS=Content-Type,Authorization,X-Requested-With

# Rate Limiting - Relaxed for development
RATE_LIMIT_WINDOW_MS=60000
RATE_LIMIT_MAX_REQUESTS=1000

# ===========================================
# Input Validation Configuration (Development)
# ===========================================
# Relaxed limits for development testing
MAX_REQUEST_SIZE=52428800
MAX_FIELD_SIZE=5242880
ALLOWED_FILE_TYPES=.jpg,.jpeg,.png,.gif,.pdf,.txt,.md,.json,.xml,.csv,.log
SANITIZE_HTML=true

# ===========================================
# Monitoring and Logging (Development)
# ===========================================
# REQUIRED: Verbose development logging
LOG_LEVEL=trace
LOG_FORMAT=pretty
ENABLE_ACCESS_LOGS=true
ENABLE_ERROR_LOGS=true
LOG_RETENTION_DAYS=7
LOG_STRUCTURED_JSON=false

# ===========================================
# Performance Monitoring (Development)
# ===========================================
# REQUIRED: Enable all performance monitoring
PERFORMANCE_MONITORING=true
PERFORMANCE_TRACE_ENABLED=true
BOTTLENECK_DETECTION=true
LATENCY_TRACKING=true

# ===========================================
# Telemetry System (Development)
# ===========================================
# REQUIRED: Enable comprehensive telemetry
TELEMETRY_ENABLED=true
TELEMETRY_LOG_LEVEL=trace
TELEMETRY_METRICS_INTERVAL=1000
TELEMETRY_GPU_MONITORING=true
TELEMETRY_NETWORK_MONITORING=true

# ===========================================
# Network State Monitoring (Development)
# ===========================================
# REQUIRED: Enable all network monitoring
NETWORK_STATE_MONITORING=true
CONNECTION_HEALTH_CHECKS=true
RETRY_OPERATION_LOGGING=true
CIRCUIT_BREAKER_LOGGING=true

# ===========================================
# Health Check (Development)
# ===========================================
# OPTIONAL: Health check endpoint
HEALTH_CHECK_ENABLED=true
HEALTH_CHECK_PORT=9501
HEALTH_CHECK_PATH=/health

# ===========================================
# Hot Reload Configuration (Development)
# ===========================================
# OPTIONAL: Enable hot reload for faster development
HOT_RELOAD_ENABLED=true
WATCH_FILE_CHANGES=true
AUTO_RESTART_ON_CHANGE=true

# ===========================================
# Development Tools
# ===========================================
# OPTIONAL: Enable development tools and debugging endpoints
DEV_TOOLS_ENABLED=true
ENABLE_PROFILING=true
ENABLE_DEBUG_ENDPOINTS=true
MOCK_EXTERNAL_APIS=false

# ===========================================
# Resource Limits (Development)
# ===========================================
# Relaxed limits for development
MAX_MEMORY_MB=4096
MAX_CPU_CORES=4
MAX_WORKERS=4
MAX_CONNECTIONS=100

# ===========================================
# Feature Flags (Development)
# ===========================================
# Enable experimental features in development
FEATURE_FLAG_EXPERIMENTAL=true
FEATURE_FLAG_BETA_FEATURES=true
FEATURE_FLAG_DEBUG_UI=true