How amruth-143/aegis-alpha works
Aegis Alpha is a paper-trading research system: a bounded invocation reads market/account evidence, proposes defined-risk options spreads, subjects them to adversarial committee review and deterministic risk veto, and permits only a dry-run preview. Monitoring, durable provenance/replay, optional read-only MCP diagnostics, and the read-only Judge Mode dashboard are important supporting capabilities. Edges use README statements and shown callers/import references; several subsystem internals are unsampled, so uncertain wiring is omitted.
Main entry points: coordinator.py Cycle coordinator · alpaca Paper account and data · engine.py Investment committee · strategy_engine.py Spread proposals
Components 18
Market evidence
- Paper account and data
app/alpaca - Options scanner
app/scanner/options_scanner.py - Market signals
app/signals/signal_engine.py
Trade decisions
- Spread proposals
app/strategies/strategy_engine.py - Investment committee
app/committee/engine.py - Deterministic risk
app/risk/risk_engine.py - Optional AI advice
app/ai/reasoning_engine.py
Safe operations
- Cycle coordinator
app/orchestration/coordinator.py - Dry-run preview
app/execution/executor.py - Bounded runtime
app/runtime/runtime.py - Account monitoring
app/monitoring/monitor_engine.py - Read-only MCP
app/mcp/service.py
Audit and visibility
- SQLite journal
app/database/state_store.py - Certificates and replay
app/committee - Judge dashboard
dashboard/streamlit_app.py
Other components
- Operator
- Alpaca market service
- Official MCP server
Connections 27
- Operator → Cycle coordinator: starts cycle
- Cycle coordinator → Paper account and data: reads account
app/orchestration/coordinator.py - Cycle coordinator → Options scanner: requests scan
- Cycle coordinator → Market signals: requests signal
app/orchestration/coordinator.py - Cycle coordinator → Spread proposals: requests proposals
app/orchestration/coordinator.py - Market signals → Paper account and data: fetches bars
app/signals/signal_engine.py - Options scanner → Paper account and data: reads options
app/scanner/options_scanner.py - Spread proposals → Options scanner: scans contracts
app/strategies/strategy_engine.py - Spread proposals → Market signals: uses direction
app/strategies/strategy_engine.py - Cycle coordinator → Investment committee: evaluates proposal
app/orchestration/coordinator.py - Cycle coordinator → Deterministic risk: requests approval
app/orchestration/coordinator.py - Investment committee → Deterministic risk: reviews risk decision
app/committee/engine.py - Investment committee → Optional AI advice: may request advocates
- Cycle coordinator → Dry-run preview: requests preview
app/orchestration/coordinator.py - Dry-run preview → Paper account and data: checks account
app/execution/executor.py - Cycle coordinator → Account monitoring: builds snapshot
app/orchestration/coordinator.py - Account monitoring → Paper account and data: reads positions
app/monitoring/monitor_engine.py - Bounded runtime → Cycle coordinator: delegates cycles
app/runtime/runtime.py - Cycle coordinator → Read-only MCP: may query diagnostics
app/orchestration/coordinator.py - Read-only MCP → Official MCP server: opens stdio session
app/mcp/service.py - Paper account and data → Alpaca market service: requests market data
- Cycle coordinator → SQLite journal: persists outcomes
app/orchestration/coordinator.py - Investment committee → Certificates and replay: records provenance
app/committee/engine.py - Certificates and replay → SQLite journal: stores certificates
- Judge dashboard → SQLite journal: reads evidence
- Operator → Bounded runtime: starts runtime
- Operator → Judge dashboard: opens views