1
Market Evidence
Provider adapters stage quotes, news, events, and historical context. Research and arena packets freeze the exact evidence set before any model sees it.
Architecture
Traceable AI agents with a hard broker boundary.
MockStock separates evidence gathering, model output, agent policy, risk validation, sandbox execution, and accounting. The design is intentionally conservative because financial-looking systems need clear ownership, repeatable data, and audit trails.
2
Model Signal
LLMs produce structured signals or research reviews. They do not own cash, positions, orders, or portfolio state.
3
Agent Policy
Application policy interprets the signal, applies mandate and constraints, and records the action separately from the raw model output.
4
Risk Engine
Risk validation checks confidence, cash, position sizing, lifecycle state, and market-session rules before a sandbox order can proceed.
5
Mock Broker
The broker adapter records simulated orders, fills, queues, expirations, and cancellations. MockStock never connects to a real brokerage.
6
Accounting and Ops
Ledger rows, performance snapshots, reconciliation, cost events, queue metrics, and app alerts make results auditable.
Execution model
Queue-backed workers are the default for provider and LLM work.
The browser should not fan out model calls or broker workflows. User actions create stored intent, durable jobs claim that work, and read-only pages show status from database rows. This keeps retries, cancellation, cost tracking, and failure review explicit.
Private investment workspace
Reference portfolios, watchlists, thesis notes, committee reviews, and personal decisions stay authenticated and private.
Benchmark arena lab
Four agents receive equal inputs and compete in isolated sandbox accounts for model-behavior evaluation.
Public engineering showcase
External pages use static architecture content and selected sanitized historical artifacts, not current private state.
Durable execution
UI actions enqueue expensive provider/model work. Workers claim jobs, heartbeat locks, retry safely, and record idempotent results.
Data Boundaries
Private portfolio and research records are excluded from public routes, public analytics payloads, and hosted summary sync.
Operational Signals
Provider health, queue status, app alerts, accounting reconciliation, and smoke tests exist to keep the system honest before trusting results.
No Real Brokerage
The broker is a sandbox adapter. There are no real orders, no account linking, no trade execution, and no investment advice.