Architecture

Audit-first decision machinery.

FFE is organized around a simple rule: every decision must be explainable after the fact. The public map below is intentionally high-level and omits credentials, private infrastructure, and live routing details.

Public-safe abstractionSource: docs/architecture/README.mdNo live account state
Market data + sentiment
        │
        ▼
Multi-timeframe pulse ──► Regime / volatility classification
        │                                  │
        ▼                                  ▼
Decision context ───────► LLM debate / candidate actions
        │                                  │
        ▼                                  ▼
Policy scoring / rerank ─► Risk gatekeeper ─► Execution adapter
        │                                  │
        └──────────────► Decision store / audit spine ◄──── Trade monitor

Public components

Perception

Market context

Market-data adapters, multi-timeframe pulse generation, and regime/volatility labels prepare the evidence packet for decision-making.

Reasoning

Debate and candidate actions

AI providers can produce candidate actions. Debate metadata and decision origin are preserved so later reports can separate judged decisions from skip or fallback paths.

Control

Risk gatekeeper

Risk checks, legal-action enforcement, stale-data protection, and audit logging constrain the decision before any execution adapter is considered.

Memory

Persistence and evaluation

Decision artifacts, trade outcomes, and experiment metadata support replay, regression checks, and public-safe summary generation.

Audit spine invariants