COC_END_TO_END_WORKFLOW.md

# Generic City of Calgary SWMR workflow

Kincora Phase 2 is a regression fixture only. Production functions do not
contain Kincora object IDs, values, geometry, or report conclusions.

## MCP sequence

1. `upload_model` — immutable EPA SWMM INP upload and inventory.
2. `set_report_details` — project, consultant, professional, site, objective,
   methodology and administrative information.
3. `set_report_configuration` — project-specific criteria, major routes,
   special flow limits, facility classifications, drawing inventory,
   applicable reports and checklist overrides.
4. `run_simulation` — legacy-default normalization where required, isolated
   execution, execution-integrity gate, database creation and RPT reconciliation.
5. `get_table_catalog` / `query_results` — complete tokenized input and result
   review rather than top-N-only evidence.
6. `preliminary_design_review`, `get_reconciliation`, `calgary_screening` —
   deterministic QA/QC and preliminary City screening.
7. `get_timeseries` and controlled `run_scenario` calls where authorized.
8. `generate_report` — editable SWMR DOCX plus immutable audit ZIP, model
   listings, model schematic, depth-velocity figure and readiness registers.

## Execution and readiness gates

- An invalid hydraulic run produces an Input/Configuration Review and no
  hydraulic screening conclusions.
- Missing drawings, approved criteria, boundary conditions, current-source
  verification, or professional fields remain explicit readiness gaps.
- Generated figures do not replace drawing-to-model reconciliation.
- The output is never represented as approved, authenticated, or submission
  ready solely because the automated workflow completed.

## Project-neutral design

- Object selection is derived from each uploaded INP or explicit project
  configuration.
- Unit labels and effective solver defaults follow the model unit system.
- Coordinates and vertices drive schematic geometry; incomplete coordinate
  sets receive a deterministic topology fallback.
- Criteria and facility classifications are session-scoped and archived with
  the report package.
- Kincora-specific numerical pins remain only in regression tests.