Build a District Cooling Thermal Connection Agreement Compliance Verifier — implementation

## Build
Analyze building management chilled water connection submittals against contractual delta-T agreements. Flag low delta-T syndrome risks and synthesize technical non-conformance notices for regional developers.

## User
District Cooling Utility Contracts Engineer

## Workflow
1. Ingest building primary and secondary chilled water heat exchanger submittals.
2. Extract contractual design delta-T, maximum flow rates, and building design cooling tonnage.
3. Model heat exchanger return water temperatures under partial load using EnergyPlus coil performance logic.
4. Generate formal compliance scorecards and penalty exposure summaries for tenant developers.

## Interface
Contract compliance portal with heat exchanger performance curves and automated bilateral violation notices.

## Data
Use standardized building connection schematics and epJSON PlantLoop heat exchanger records.
Starter examples below are synthetic. They are not downloaded records.

## Source
[EnergyPlus](https://raw.githubusercontent.com/NREL/EnergyPlus/develop/README.md)
Leverages EnergyPlus PlantLoop and HeatExchanger:FluidToFluid schema definitions to audit return water temperatures.

## Tools
haystack, energyplus-schema, pydantic.
Haystack provides modular search and document extraction pipelines over complex technical connection manuals and submittals.
Local or hosted LLM with strong technical contract auditing and engineering parameter extraction.

## Deliverables
Submit runnable source, pinned dependencies, setup commands, a working interface, example outputs, and a recorded end-to-end demo. Include tests and an action log.

## Acceptance
- Extracts secondary supply/return temperatures and design heat transfer coefficients.
- Detects design configurations resulting in return chilled water below contractual 14°C threshold.
- Calculates low delta-T capacity penalty surcharges according to contractual tariff formulas.
- Assembles an engineering notice of non-compliance for client review.

## Starter Examples
```json
[
  {
    "input": {
      "tenant_id": "TOWER-BURJ-04",
      "contract_delta_t_c": 8,
      "contract_return_temp_c": 13.5,
      "submittal_data": {
        "supply_temp_c": 5.5,
        "design_return_temp_c": 11,
        "hex_ua_value": 45000,
        "peak_tons": 1200
      }
    },
    "expected_output": {
      "compliance_status": "NON_COMPLIANT",
      "observed_delta_t_c": 5.5,
      "deficit_c": 2.5,
      "penalty_risk": "HIGH",
      "primary_deficiency": "Submittal return water temperature 11.0C violates contract minimum of 13.5C, inducing plant low delta-T syndrome.",
      "requires_lead_engineer_review": true
    }
  },
  {
    "input": {
      "tenant_id": "TOWER-BURJ-05",
      "contract_delta_t_c": 8,
      "contract_return_temp_c": 13.5,
      "submittal_data": null
    },
    "expected_output": {
      "compliance_status": "INCOMPLETE_SUBMISSION",
      "error": "MISSING_HEAT_EXCHANGER_DATA",
      "requires_lead_engineer_review": true
    }
  }
]
```

## Safety
Advisory contract audit; physical district cooling connection valves are not actuated by this system.
Use mock external writes. Require human review before any real deployment.