spec_version: 1
name: flood_ops
type: space
runtime: fastapi
app: flood_openenv.server:app
port: 7860
description: Run the U.S. Army Corps of Engineers' four flood-control dams on the Cumberland River above Nashville (Wolf Creek, Dale Hollow, Center Hill, J. Percy Priest) through the real February and April 2025 floods, rebuilt from the USACE and USGS record, with the NWS flood stages at Burkesville, Celina and Nashville. Set each dam's release every 6 hours within release, ramp and pool limits; graded once on submit against the exact LP optimum.
version: "0.1.0"
variables:
  FLOOD_TASKS_DIR: ""         # colon-separated pack directories; defaults to every pack in tasks/
  FLOOD_MAX_CHECKS: "10"
  FLOOD_MAX_TOOL_CALLS: "24"
  MAX_CONCURRENT_ENVS: "64"
validation:
  reward:
    range: [0.0, 1.0]
    # oracle/solve.py submits the LP optimum and scores exactly 1.0; any rule broken scores < 0.2
    oracle_tolerance: 0.001
  resources:
    cpu: 1.0
    memory_mb: 1024
    disk_mb: 512
    episode_timeout_s: 3600.0
  network:
    mode: no-network
  capabilities:
    verifier:
      kind: reward_channel
    oracle:
      form: script
      location: oracle/solve.py
    rubric_tree: true
    task_api: true
    declared_tools: [get_situation, check_plan, submit_plan]
  types:
    tags: [simulation, water-resources, flood-control, reservoir-operations, operations-research, mcp, real-world-data]