sapphire-core

name	sapphire-core
description	Shared library — risk kernel, circuit breaker, position sizing, trade models, logging
type	library
runtime	python
deploy_target	none
dependencies	[]
entry_point	src/sapphire_core/__init__.py
test_command	pytest tests/unit/

Sapphire Core

Purpose

Foundation library imported by all Sapphire services. Provides risk management, position sizing, circuit breakers, trade models, health checks, and structured logging.

Key Files

• src/sapphire_core/risk_kernel.py — Risk calculations and portfolio limits
• src/sapphire_core/circuit_breaker.py — Automatic trading halt on anomalies
• src/sapphire_core/position_sizing.py — Kelly criterion and fractional sizing
• src/sapphire_core/health.py — Health check endpoints
• src/sapphire_core/telegram_bot.py — Base Telegram bot client
• src/sapphire_core/gateway.py — OpenClaw gateway client

API Surface

All modules export public functions. No CLI or HTTP endpoints — this is a library.