Institutional Capital Governance Platform (SilhouetteSE)

The core intelligence layer for machine governance of institutional capital. Designed for deterministic mandate generation, structural risk analysis, and capital behavior authorization.

System Architecture

1. Structural Regime Layer (Classification)

The RegimeClassifier performs high-density analysis of market volatility, liquidity, and correlation to identify the dominant structural regime (e.g., STABLE, FRAGILE, DISLOCATED).

2. Governance Layer (Multi-Agent Committee)

Four autonomous agents evaluate the structural regime from distinct institutional perspectives:

• SystemicRiskAgent: Monitors for hidden correlation spikes and tail risk loading.
• LiquidityConditionsAgent: Assesses operational exit velocity and liquidity depth.
• VolatilityRegimeAgent: Evaluates term structure stability and realized volatility.
• DeploymentConditionsAgent: Evaluates operational capacity and environmental compatibility.

The CommitteeEngine synthesizes these inputs into a final Capital Directive.

3. Capital Posture Layer (Execution Authorization)

The PostureEngine generates specific execution parameters:

• Authorized Net Exposure: Maximum directional authorization.
• Execution Leverage Cap: Hard leverage limit.
• Authorized Execution Classes: Lists of permitted and restricted execution vehicles.
• Output: CapitalPosture (e.g., "Capital Preservation Mode").
• Verification: verify_posture.py

4. Interface Layer (Institutional Command)

• Frontend: React + Vite + Tailwind v4 (Institutional "Risk Office" Aesthetic).
• Design: Low-latency clarity, dense information, no retail/startup aesthetics.

---

Installation

Backend (Python/FastAPI)

# Install dependencies
pip install -r requirements.txt

# Run Tests
pytest tests/

Frontend (React)

cd frontend
npm install
npm run dev

---

Quick Start

The most reliable way to launch the full infrastructure is using the stabilized developer script:

.\start_dev.bat

This script handles port synchronization (Backend: 8001, Frontend: 5173).

---

Usage

Running the API (Manual)

uvicorn app.main:app --reload --port 8001

Triggering Decision Cycles

# Standard Cycle (Baseline)
POST /api/v1/decision-cycle/run

# Stress Scenario (Result: HALT)
POST /api/v1/decision-cycle/run?scenario=VOLATILITY_SHOCK

---

Verification Scripts

Run these scripts to inspect the deterministic logic trace:

• py verify_regime.py: Inspects regime classification logic.
• py verify_governance.py: Inspects committee debate and synthesis.
• py verify_posture.py: Inspects capital allocation rules.
• py verify_scenarios.py: Runs full stress tests (Vol Shock, Liquidity Collapse).