TradingAgents/agent_os/frontend
ahmet guzererler 4c14080d73
feat(scanner): Finviz smart money scanner + Golden Overlap strategy
## Summary
- Adds `smart_money_scanner` as a new Phase 1b node that runs sequentially after `sector_scanner`, surfacing institutional footprints via Finviz screeners
- Introduces the **Golden Overlap** strategy in `macro_synthesis`: stocks confirmed by both top-down macro themes and bottom-up Finviz signals are labelled high-conviction
- Fixes model-name badge overflow in AgentGraph (long model IDs like OpenRouter paths were visually spilling into adjacent nodes)
- Completes all documentation: ADR-014, dataflow, architecture, components, glossary, current-state

## Key Decisions (see ADR-014)
- 3 zero-parameter tools (`get_insider_buying_stocks`, `get_unusual_volume_stocks`, `get_breakout_accumulation_stocks`) instead of 1 parameterised tool — prevents LLM hallucinations on string args
- Sequential after `sector_scanner` (not parallel fan-out) — gives access to `sector_performance_report` context and avoids `MAX_TOOL_ROUNDS=5` truncation in market_movers_scanner
- Graceful fallback: `_run_finviz_screen()` catches all exceptions and returns an error string — pipeline never hard-fails on web-scraper failure
- `breakout_accumulation` (52-wk high + 2x vol = O'Neil CAN SLIM institutional signal) replaces `oversold_bounces` (RSI<30 = retail contrarian, not smart money)

## Test Plan
- [x] 6 new mocked tests in `tests/unit/test_scanner_mocked.py` (happy path, empty DF, exception, sort order)
- [x] Fixed `tests/unit/test_scanner_graph.py` — added `smart_money_scanner` mock to compilation test
- [x] 2 pre-existing test failures excluded (verified baseline before changes)
- [x] AgentGraph badge: visually verified truncation with long OpenRouter model identifiers

🤖 Generated with [Claude Code](https://claude.com/claude-code)
2026-03-24 16:03:17 +01:00
..
src feat(scanner): Finviz smart money scanner + Golden Overlap strategy 2026-03-24 16:03:17 +01:00
README.md feat: initialize AgentOS observability foundation 2026-03-22 21:54:13 +01:00
index.html feat: implement AgentOS frontend and live backend integration 2026-03-22 22:12:33 +01:00
package-lock.json packages 2026-03-24 10:14:11 +01:00
package.json packages 2026-03-24 10:14:11 +01:00
postcss.config.js feat: implement AgentOS frontend and live backend integration 2026-03-22 22:12:33 +01:00
tailwind.config.js feat: implement AgentOS frontend and live backend integration 2026-03-22 22:12:33 +01:00
tsconfig.json feat: clickable terminal events, node inspector drawer, stop animation on complete, vite 8 2026-03-23 07:03:48 +00:00
tsconfig.node.json feat: clickable terminal events, node inspector drawer, stop animation on complete, vite 8 2026-03-23 07:03:48 +00:00
vite.config.ts fix: migrate backend to port 8088 and use 127.0.0.1 to avoid macOS system conflicts 2026-03-22 22:51:09 +01:00

README.md

AgentOS Frontend

This is a React-based observability dashboard for TradingAgents.

Tech Stack

  • Framework: React (Vite)
  • UI Library: Chakra UI
  • State Management: React Context / Hooks
  • Communication: Axios (REST) & WebSockets

Getting Started

  1. Initialize the project:

    npm create vite@latest . -- --template react-ts
    npm install @chakra-ui/react @emotion/react @emotion/styled flutter-framer-motion axios lucide-react
    
  2. Run the development server:

    npm run dev
    

Core Components Structure

  • src/components/CommandCenter/: The main terminal and agent map.
  • src/components/Portfolio/: Portfolio holdings and metrics.
  • src/hooks/useAgentStream.ts: Custom hook for WebSocket streaming.
  • src/context/AuthContext.tsx: Mock auth and multi-tenant support.