Market Watch: multiplayer GARP paper trading simulator

- Game engine with multiplayer support (create games, join, leaderboard)
- GARP stock screener (S&P 500 + 400 MidCap, 900+ tickers)
- Automated trading logic for AI player (Case)
- Web portal at marketwatch.local:8889 with dark theme
- Systemd timer for Mon-Fri market hours
- Telegram alerts on trades and daily summary
- Stock analysis deep dive data (BAC, CFG, FITB, INCY)
- Expanded scan results (22 GARP candidates)
- Craigslist account setup + credentials

projects/market-watch/README.md

@@ -0,0 +1,86 @@
+# Market Watch - Multiplayer GARP Paper Trading Simulator
+
+Multiplayer paper trading simulator implementing a **Growth at a Reasonable Price (GARP)** strategy. Compete against Case (AI) and other players.
+
+## How It Works
+
+- **Create or join a game** with configurable starting cash
+- **Trade manually** via the web portal or Telegram
+- **Case (AI)** trades autonomously using the GARP strategy
+- **Leaderboard** tracks who's winning by % return
+
+## GARP Filter Criteria
+
+| Metric | Threshold |
+|--------|-----------|
+| Revenue Growth | ≥ 10% |
+| Trailing P/E | < 25 |
+| Forward P/E | < 15 |
+| PEG Ratio | < 1.2 (if available) |
+| EPS Growth | > 15% |
+| ROE | > 5% |
+| Quick Ratio | > 1.5 (if available) |
+| Debt/Equity | < 35% (if available) |
+| Market Cap | > $5B |
+
+### Case's Trading Rules
+- **Buy:** GARP filter pass + RSI < 70 + not within 2% of 52wk high + max 10% per position + max 15 positions
+- **Sell:** Fails GARP rescan OR 10% trailing stop-loss OR RSI > 80
+- **Universe:** S&P 500 + S&P 400 MidCap (~900 stocks)
+
+## Architecture
+
+| File | Description |
+|------|-------------|
+| `game_engine.py` | Multiplayer game/player/portfolio engine |
+| `scanner.py` | GARP scanner across S&P 500 + 400 |
+| `trader.py` | Case's autonomous trading logic |
+| `run_daily.py` | Daily orchestrator (scan → trade → snapshot → alert) |
+| `portfolio.py` | Backward-compatible wrapper for single-player |
+| `portal/server.py` | Web dashboard with multiplayer UI |
+
+### Data Structure
+```
+data/games/{game_id}/
+├── game.json                    # Game config, players, rules
+└── players/{username}/
+    ├── portfolio.json           # Current positions & cash
+    ├── trades.json              # Trade history
+    └── snapshots.json           # Daily value snapshots
+```
+
+## Web Portal
+
+**URL:** http://marketwatch.local (or http://localhost:8889)
+
+- **Home:** List of games, create new game
+- **Game page:** Leaderboard, join game
+- **Player page:** Portfolio, trade form, performance chart, trade history
+
+### API Endpoints
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| POST | `/api/games` | Create game (form: name, starting_cash, end_date) |
+| POST | `/api/games/{id}/join` | Join game (form: username) |
+| POST | `/api/games/{id}/players/{user}/trade` | Trade (form: action, ticker, shares) |
+| GET | `/api/games/{id}/leaderboard` | Get leaderboard JSON |
+| GET | `/api/games/{id}/players/{user}/portfolio` | Get portfolio JSON |
+
+## Systemd Services
+
+| Service | Schedule |
+|---------|----------|
+| `market-watch.timer` | Mon-Fri 9:00 AM + 3:30 PM CST |
+| `market-watch-portal.service` | Always running (port 8889) |
+
+```bash
+systemctl --user status market-watch.timer
+systemctl --user status market-watch-portal
+journalctl --user -u market-watch -f
+```
+
+## Telegram
+
+Players can trade via: `buy AAPL 10` or `sell BAC 50`
+Daily summaries with leaderboard sent automatically.