Cerebrovascular CO2 Reactivity (CVR) & Breath-Holding Index Skill

A sovereign personal agent capability for computational neurovascular hemodynamics, evaluating cerebrovascular CO2 reactivity (CVR), Transcranial Doppler Breath-Holding Index (BHI), and cerebral microvascular reserve.

Architecture

flowchart TD
    ApneaData["TCD CBFv: Baseline & Hypercapnic Peak Velocity (cm/s) + Duration (s)"] --> PercentSurge["Percentage Flow Velocity Surge: ((Peak - Base) / Base) * 100%"]
    PercentSurge --> BHIEngine["Breath-Holding Index (BHI = % Surge / Apnea Duration in seconds)"]
    BHIEngine --> CVRI["Cerebrovascular Vasomotor Reserve Index (CVRI: 0 - 100)"]
    CVRI --> Guidance["OpenClaw / Hermes Cerebrovascular Health & Aerobic Conditioning Guidance"]

Quickstart

from client import CerebrovascularReactivityClient

client = CerebrovascularReactivityClient()

# Assess 30-second breath-holding challenge
res = client.calculate_breath_holding_index(
    baseline_cbfv_cm_s=62.0,
    hypercapnia_peak_cbfv_cm_s=91.5,
    apnea_duration_sec=30.0
)

print("Velocity Increase:", res["percentage_velocity_increase"], "%")
print("BHI:", res["breath_holding_index_pct_s"], "%/s")
print("Reserve Index:", res["cerebrovascular_reserve_index"], "/ 100")
print("Classification:", res["classification"])

MCP Server Integration

Add to your claude_desktop_config.json or OpenClaw tool registry:

{
  "mcpServers": {
    "cerebrovascular-reactivity": {
      "command": "python",
      "args": ["/path/to/genpark-personal-agent-cerebrovascular-co2-reactivity-cvr-skill/mcp_server.py"]
    }
  }
}

License

MIT License.