feat: SMARTS trading pipeline with Telegram notifications and Miro visualization

.claude/commands/update-docs.md

@@ -49,6 +49,14 @@ Update project documentation after making changes.
    - Task completed (mark with ✅ and timestamp)
    - New tasks discovered (add to appropriate phase)
 
+8. Update SMARTS pipeline diagram (if SMARTS agents changed):
+   ```bash
+   python scripts/update_smarts_diagram.py
+   ```
+   - This auto-updates the Miro board with current architecture
+   - Requires MIRO_ACCESS_TOKEN and MIRO_BOARD_ID environment variables
+   - Use `--dry-run` to test without updating Miro
+
 ## Format for Changelog Entry
 
 ```markdown

.env.example

@@ -110,3 +110,31 @@ OTEL_EXPORTER_OTLP_PROTOCOL=grpc
 
 # Metrics export interval in milliseconds (default: 60 seconds)
 OTEL_METRIC_EXPORT_INTERVAL=60000
+
+# ===========================================
+# MIRO INTEGRATION (Optional - for architecture diagrams)
+# ===========================================
+
+# Miro access token for auto-generating architecture diagrams
+# Get from: https://miro.com/app/settings/user-profile/apps
+# Create "Miro App" → Copy token from "API Token" section
+MIRO_ACCESS_TOKEN=
+
+# Miro board ID for SMARTS pipeline ARCHITECTURE diagram
+# Shows static pipeline structure (agents, connections, data flow)
+# Found in board URL: https://miro.com/app/board/{BOARD_ID}/
+MIRO_BOARD_ID=
+
+# Miro board ID for SMARTS ANALYSIS FLOWS (separate board recommended)
+# Shows live execution data from Supabase integration_context
+# Create a second board to keep architecture and flows separate
+MIRO_FLOW_BOARD_ID=
+
+# ===========================================
+# SUPABASE (Optional - for SMARTS flow visualization)
+# ===========================================
+
+# Supabase project URL and keys for querying integration_context
+# Get from: https://supabase.com/dashboard/project/<project>/settings/api
+SUPABASE_URL=
+SUPABASE_ANON_KEY=

.gitignore

@@ -130,3 +130,6 @@ config/agent-templates/**/memory/
 config/agent-templates/**/outputs/
 config/agent-templates/**/metrics.json
 .playwright-mcp/
+
+# SMARTS flow data exports (contains live trading data)
+data/smarts-flows/*.json

config/agent-templates/analysis/.mcp.json.template

@@ -0,0 +1,29 @@
+{
+  "mcpServers": {
+    "alpaca": {
+      "command": "uvx",
+      "args": ["alpaca-mcp-server", "serve"],
+      "env": {
+        "ALPACA_API_KEY": "${ALPACA_API_KEY}",
+        "ALPACA_SECRET_KEY": "${ALPACA_SECRET_KEY}"
+      }
+    },
+    "supabase": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@supabase/mcp-server-postgrest@latest",
+        "--apiUrl", "${SUPABASE_URL}/rest/v1",
+        "--apiKey", "${SUPABASE_SERVICE_KEY}",
+        "--schema", "public"
+      ]
+    },
+    "massive": {
+      "command": "npx",
+      "args": ["-y", "@anthropic/massive-mcp"],
+      "env": {
+        "MASSIVE_FOLDER": "${MASSIVE_FOLDER:-/shared}"
+      }
+    }
+  }
+}