{
  "contract_version": "HRC-API-CONTRACT-v0.3.1",
  "runtime": "HRC_Heart-rate Resonance Control",
  "ko": "심박 공명 제어 시스템",
  "base_url": "https://somatosophy.com",
  "principle": "HRC is a resonance permission engine. Visuals follow runtime.",
  "source_boundaries": {
    "ENGINE_TEST": "deterministic engineering test vector",
    "RECORDED_SESSION": "requires recording_id and anonymized=true",
    "LIVE_DEVICE": "requires valid tenant license and signed packet metadata"
  },
  "key_endpoints": [
    "GET /api/health",
    "GET /api/profiles",
    "GET /api/adapters",
    "GET /api/contract",
    "POST /api/license/verify",
    "POST /api/session/start",
    "POST /api/session/step",
    "GET /api/session/{id}/bundle",
    "POST /api/benchmark/latency"
  ],
  "packet_minimum": {
    "source_type": "ENGINE_TEST | RECORDED_SESSION | LIVE_DEVICE",
    "bio_phase_rad": "number",
    "stimulus_phase_rad": "number",
    "quality_score": "number 0..1",
    "actuator_latency_ms": "number"
  },
  "live_integrity_required": {
    "integrity.device_id": "string",
    "integrity.timestamp": "string",
    "integrity.nonce": "string",
    "integrity.signature": "string"
  },
  "live_signature_contract": {
    "algorithm": "HMAC-SHA256",
    "secret": "tenant license key",
    "canonicalization": "JSON canonical form with sort_keys=true and compact separators",
    "signature_scope": "entire packet except integrity.signature",
    "required_integrity_fields": [
      "device_id",
      "timestamp",
      "nonce",
      "session_id",
      "signature_alg",
      "signature"
    ],
    "session_binding": "integrity.session_id must equal HRC session_id"
  }
}