Build a Heat-Aware Steel Erection Shift Planner — implementation

## Build
Evaluate ambient temperature, wind gusts, and thermal steel expansion to schedule structural steel lifting and bolt-torquing. Assemble safety-compliant work rosters to protect site rigging crews from extreme heat hazards.

## User
Site Structural Construction Superintendent

## Workflow
1. Ingest heavy structural lift manifests, crane lift radius capacities, and hourly microclimate heat forecasts.
2. Calculate thermal expansion allowances on critical long-span trusses to avoid alignment binding.
3. Apply wet-bulb globe temperature worker exposure thresholds to establish mandatory rest-work cycles.
4. Synthesize a daily steel erection shift plan scheduling heavy rigging during cool nocturnal and early dawn hours.

## Interface
Daily rigging board showing hourly crane wind limits, thermal expansion risk indicators, and crew work-rest rotations.

## Data
Synthesize structural lift lists with steel member lengths, weights, and forecasted 24-hour weather station feeds.
Starter examples below are synthetic. They are not downloaded records.

## Source
[EnergyPlus](https://raw.githubusercontent.com/NREL/EnergyPlus/develop/README.md)
Draws on EnergyPlus weather parsing and design-day thermal concepts to structure microclimate hourly ambient boundary inputs.

## Tools
agno, pydantic, fastapi.
Agno provides lightweight agent workflows for synthesizing complex shift schedules under multi-variable engineering constraints.
Hosted Claude API for evaluating trade-offs between crane availability and worker heat safety limits.

## 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
- Restricts heavy crane lifts when forecasted ambient temperatures exceed 44 degrees Celsius or wind exceeds safe boom speeds.
- Schedules high-precision structural bolt connections during hours where thermal expansion variance is below 3 mm.
- Produces an hourly rigging schedule with assigned mandatory shaded rest intervals.

## Starter Examples
```json
[
  {
    "input": {
      "lift_id": "LIFT-TRUSS-01",
      "truss_length_m": 42,
      "weight_tons": 18.5,
      "forecast": [
        {
          "hour": "04:00",
          "temp_c": 31,
          "wind_ms": 3.2
        },
        {
          "hour": "08:00",
          "temp_c": 38,
          "wind_ms": 5.1
        },
        {
          "hour": "12:00",
          "temp_c": 46,
          "wind_ms": 7.8
        }
      ]
    },
    "expected_output": {
      "approved_window": "04:00 - 07:00",
      "thermal_expansion_mm": 6.2,
      "work_rest_ratio": "50_10",
      "shift_status": "APPROVED_EARLY_DAWN",
      "prohibited_hours": [
        "11:00",
        "12:00",
        "13:00",
        "14:00",
        "15:00"
      ]
    }
  },
  {
    "input": {
      "lift_id": "LIFT-TRUSS-02",
      "truss_length_m": 20,
      "weight_tons": 8,
      "forecast": [
        {
          "hour": "04:00",
          "temp_c": 35,
          "wind_ms": 14.5
        },
        {
          "hour": "08:00",
          "temp_c": 42,
          "wind_ms": 12
        }
      ]
    },
    "expected_output": {
      "approved_window": "NONE",
      "thermal_expansion_mm": 4.1,
      "work_rest_ratio": "UNSAFE",
      "shift_status": "POSTPONED",
      "prohibited_hours": [
        "04:00",
        "08:00"
      ]
    }
  }
]
```

## Safety
Rigging plans are operational proposals; certified crane lift supervisors must conduct physical wind and rigging inspections prior to hoisting.
Use mock external writes. Require human review before any real deployment.