intervalsicugptcoach-public

# Montis.icu **Data access is not coaching intelligence.** Montis.icu is a deterministic endurance coaching engine built around Intervals.icu data. It validates athlete evidence, resolves physiological and training context through explicit coaching logic, and produces a governed coaching state before conversational AI enters the dialogue. `Intervals.icu → Montis intelligence → governed athlete state / decision → AI dialogue` A direct API or MCP connection can expose useful athlete data. Montis adds the missing intelligence layer: longitudinal context, validation, performance behaviour, adaptation progression, phase/event governance and deterministic decision logic. ## Core principle Montis controls the coaching intelligence. AI explains and discusses the result — it does not independently invent the athlete's training state or coaching decision. The language model is downstream of the engine. It receives governed semantic output and turns that result into useful conversation across supported interfaces. ## Current architecture ```mermaid flowchart LR ICU[Intervals.icu] --> EDGE[Cloudflare Edge Services] EDGE --> ENGINE[Railway Engine] ENGINE --> T0[Tier-0 Data & Normalization] T0 --> T1[Tier-1 Integrity] T1 --> T2[Tier-2 Metrics & Actions] T2 --> PI[Performance Intelligence] PI --> ESPE[ESPE] ESPE --> FORECAST[Future Forecast] FORECAST --> ADE[Adaptive Decision Engine] ADE --> JSON[Governed Semantic Output] JSON --> AI[Montis App / ChatGPT / Claude / API] ``` ### Execution entry points - **Railway:** `app.py` is the backend service entry point and dispatches into `audit_core/report_controller.py`. - **Local CLI:** `report.py` is the local report execution entry point. It obtains a prefetched dataset through Cloudflare Edge, then runs the Montis coaching engine locally through `audit_core/report_controller.py`. - **Canonical controller:** `audit_core/report_controller.py` executes the deterministic audit and intelligence chain. `app.py` imports `run_report` directly from `audit_core.report_controller`; the current Railway execution path does not load the historical `all-modules.md` manifest. ## Engine pipeline The current controller resolves athlete evidence in the following implementation stages: | Stage | Role | Key modules | |---|---|---| | **Tier-0** | Data acquisition, normalization and canonical windows | `audit_core/tier0_pre_audit.py` | | **Tier-1** | Dataset integrity and audit preparation | `audit_core/tier1_controller.py` | | **Tier-2** | Event-only totals, derived metrics, extended metrics and deterministic actions | `tier2_*` modules | | **Tier-3 PI** | Performance Intelligence: durability, repeatability and performance behaviour | `audit_core/tier3_performance_intelligence.py` | | **Tier-3 ESPE** | Longitudinal energy-system / power-curve progression | `audit_core/tier3_espe.py` | | **Tier-3 Forecast** | Forward training-load and event context | `audit_core/tier3_future_forecast.py` | | **Tier-3 ADE** | Adaptive coaching decision and governance | `audit_core/tier3_adaptive_decision_engine.py` | | **Semantic output** | Assemble the governed machine-readable result | `semantic_json_builder.py` | Current source versions: - **Performance Intelligence:** `PI_v1.62` - **ESPE:** `espe_v1.21` - **Adaptive Decision Engine:** `ade_v2.21` - **Unified Reporting Framework:** v5.1 ## Montis Intelligence Stack The product-level intelligence model is intentionally separate from the internal implementation tier names. 1. **Training Load** — recent load, stress pattern and capacity context. 2. **Physiology Response** — recovery, wellness and physiological response to training. 3. **Performance Intelligence** — how capability behaves under real training stress. 4. **Adaptation Progression (ESPE)** — how performance capability changes longitudinally. 5. **Adaptive Decision Engine (ADE)** — current capacity resolved with recovery, phase and event governance into the next coaching decision. The AI interface is not a sixth intelligence tier. It communicates the governed result. ## Data integrity and authority Intervals.icu remains the athlete-data authority. Montis validates and structures the available evidence before the coaching intelligence layers operate. Key implementation principles include: - event-level totals and explicit validation rather than silent reconstruction; - explicit handling of missing or degraded evidence; - separation of computation from language rendering; - semantic output as the downstream contract for reports and conversational interfaces; - deterministic coaching logic before LLM interpretation; - confidence and evidence limits rather than unsupported physiological claims. ## Interfaces Montis exposes the same governed intelligence through multiple interfaces: - **Montis App** — browser/PWA interface. - **ChatGPT** — GPT Actions / Montis integration. - **Claude and other MCP clients** — through the Montis MCP service. - **REST/API clients** — structured backend endpoints. - **Local tools** — CLI The interfaces can differ in presentation, but they do not become the computational or physiological authority. ## AI integration resources The `OPENAI/` directory contains configuration and knowledge resources used by the Montis ChatGPT integration. These files are not part of the deterministic coaching engine execution path. Some shared knowledge resources are also published separately for MCP clients: https://github.com/revo2wheels/montis-mcp-resources See [`runtime-list.md`](runtime-list.md) for the protected OpenAI integration files. ## Documentation The current documentation index is [`docs/README.md`](docs/README.md). Key documents: - [Usage Guide](docs/USAGE_GUIDE.md) - [Audit Chain Overview](docs/audit_chain_overview.md) - [Compliance Log Guide](docs/COMPLIANCE_LOG_GUIDE.md) - [Unified Reporting Framework v5.1](Unified%20Reporting%20Framework.md) Product documentation: - [Montis.icu](https://www.montis.icu/) - [Science](https://www.montis.icu/science.html) - [Technical Design](https://www.montis.icu/pipeline.html) - [Public repository](https://github.com/revo2wheels/intervalsicugptcoach-public) ## Support If Montis.icu is useful to you, you can support the project through [Buy Me a Coffee](https://www.buymeacoffee.com/revo2wheels). ## License The software in this repository is licensed under the [MIT License](LICENSE). See [NOTICE.txt](NOTICE.txt) for the distinction between the software license and Montis.icu names, branding, logos, hosted services and service identifiers. ## Open-source scope The MIT-licensed repository contains the Montis coaching engine, local CLI, public interface contracts, documentation and AI integration resources. The hosted Montis service also uses private infrastructure that is not part of this repository or the MIT package. ### Included in the MIT package - Railway/Python coaching engine - Local CLI - Public interface and semantic contracts - Documentation and AI integration resources included in this repository ### Private hosted infrastructure The following remain part of the private Montis service infrastructure: - Cloudflare Edge implementation - `MONTIS_INTERNAL_KEY` - KV / D1 bindings - OAuth client secrets - JWT signing secrets - Hosted LLM API keys - Webhook secrets No internal secret values are included in the open-source repository. Copyright © 2026 Clive King.