ed-donner · aratabekov · Aug 7, 2026 · Aug 7, 2026 · Aug 7, 2026 · Aug 8, 2026
diff --git a/.env.example b/.env.example
@@ -0,0 +1,18 @@
+# Required: OpenRouter API key for LLM chat functionality
+OPENROUTER_API_KEY=your-openrouter-api-key-here
+
+# Optional: Massive (Polygon.io) API key for real market data
+# If not set, the built-in market simulator is used (recommended for most users)
+MASSIVE_API_KEY=
+
+# Optional: Set to "true" for deterministic mock LLM responses (testing)
+LLM_MOCK=false
+
+# Optional: override the Massive poll interval in seconds (default 15)
+MASSIVE_POLL_SECONDS=15
+
+# Optional: seed the market simulator for deterministic output (tests/dev)
+SIM_SEED=
+
+# Optional: override how often the SSE stream flushes the cache, in seconds (default 0.5)
+SSE_PUSH_SECONDS=0.5
diff --git a/.github/workflows/claude.yml b/.github/workflows/claude.yml
@@ -46,5 +46,6 @@ jobs:
           # Optional: Add claude_args to customize behavior and configuration
           # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
           # or https://code.claude.com/docs/en/cli-reference for available options
-          # claude_args: '--allowed-tools Bash(gh pr:*)'
+          # claude_args: '--allowed-tools Bash(gh pr *)'
 
+          claude_args: "--model claude-opus-4-8"
diff --git a/.gitignore b/.gitignore
@@ -205,3 +205,8 @@ cython_debug/
 marimo/_static/
 marimo/_lsp/
 __marimo__/
+
+# FinAlly runtime database (volume-mounted; keep the directory, ignore the file)
+db/*.db
+db/*.db-journal
+!db/.gitkeep
diff --git a/backend/CLAUDE.md b/backend/CLAUDE.md
diff --git a/backend/README.md b/backend/README.md
diff --git a/backend/app/__init__.py b/backend/app/__init__.py
diff --git a/backend/app/market/__init__.py b/backend/app/market/__init__.py
diff --git a/backend/app/market/cache.py b/backend/app/market/cache.py
diff --git a/backend/app/market/factory.py b/backend/app/market/factory.py
diff --git a/backend/app/market/interface.py b/backend/app/market/interface.py