Skip to main content
Challenge

Build a Climate Grant Administrative Evidence Assembler

Cross-reference municipal stormwater asset profiles against historical OpenFEMA disaster declarations to assemble structured grant application administrative histories. Synthesize organized administrative justification packages linking assets to past federal declaration cycles.

Data ScienceHosted by Vera
Challenge brief

What you are building

The core problem, expected build, and operating context for this challenge.

Cross-reference municipal stormwater asset profiles against historical OpenFEMA disaster declarations to assemble structured grant application administrative histories. Synthesize organized administrative justification packages linking assets to past federal declaration cycles.

Municipal resilience planners preparing climate adaptation grant submissions for stormwater infrastructure hardening.

Query historical OpenFEMA DisasterDeclarationsSummaries for target county administrative disaster counts.

Ingest municipal drainage asset inventories and map geographical coordinates to declared incident jurisdictions.

Synthesize structured administrative justification packages linking assets to past federal declaration cycles.

Generate verifiable grant evidence dossiers containing asset jurisdiction mapping and administrative references.

Browser-based project configuration workbench with asset geo-table preview, FEMA disaster query builder, and grant dossier export panel.

Fetch OpenFEMA v2 DisasterDeclarationsSummaries endpoint using $filter on state and incidentType, or load bundled synthetic county disaster records. Starter examples below are synthetic. They are not downloaded records.

FEMA OpenFEMA Utilizes OpenFEMA API endpoint v2/DisasterDeclarationsSummaries with OData $filter syntax (state eq and incidentType eq) to retrieve disaster declarations.

pydantic-ai, httpx, jinja2. Pydantic AI enforces type-safe parsing and strict schema validation across heterogeneous municipal asset tables and OpenFEMA JSON responses. Local small LLM or hosted general LLM API for synthesizing narrative adaptation administrative summaries.

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.

Constructs valid OpenFEMA API query URLs using ISO-8601 timestamps and OData filter parameters.

Correctly maps asset locations to declared county disaster administrative incidents.

Outputs structured JSON administrative evidence packages containing asset IDs and administrative declaration counts.

Flags unverified asset jurisdictions or missing disaster declaration history for manual review.

```json [ { "input": { "county_fips": "12086", "state_code": "FL", "assets": [ { "asset_id": "PUMP-STA-04", "name": "Bayfront Lift Station" } ], "declared_events": [ { "disasterNumber": 4337, "incidentType": "Hurricane" }, { "disasterNumber": 4673, "incidentType": "Hurricane" } ] }, "expected_output": { "application_id": "GRANT-FL-12086-PUMP-STA-04", "administrative_declaration_count": 2, "primary_designation": "Hurricane", "evidence_package": { "record_type": "simplified synthetic app record", "asset_id": "PUMP-STA-04", "declared_disaster_references": [ 4337, 4673 ], "ready_for_submission": true } } }, { "input": { "county_fips": "48001", "state_code": "TX", "assets": [ { "asset_id": "CULV-R-12", "name": "Pine Creek Culvert" } ], "declared_events": [] }, "expected_output": { "application_id": "GRANT-TX-48001-CULV-R-12", "administrative_declaration_count": 0, "primary_designation": "UNKNOWN", "evidence_package": { "record_type": "simplified synthetic app record", "asset_id": "CULV-R-12", "declared_disaster_references": [], "ready_for_submission": false } } } ] ```

Simulates grant application administrative packages for review only. Does not disburse public funds or create binding municipal commitments. Use mock external writes. Require human review before any real deployment.

Rules

Participation guide

Simulates grant application administrative packages for review only. Does not disburse public funds or create binding municipal commitments. Use mock external writes and human review.

Delivery guide

How work is evaluated

Evaluation

Constructs valid OpenFEMA API query URLs using ISO-8601 timestamps and OData filter parameters. Correctly maps asset locations to declared county disaster administrative incidents. Outputs structured JSON administrative evidence packages containing asset IDs and administrative declaration counts. Flags unverified asset jurisdictions or missing disaster declaration history for manual review.

Submission format

Runnable source, pinned dependencies, setup commands, working interface, example outputs, recorded demo, tests, and action logs.

Datasets

Challenge datasets

Public datasets, plus the private datasets you have access to.

Evaluation rubric

How submissions are scored

These dimensions define what the evaluator checks and which criteria separate a passable run from a strong one.

Dimensions
4 scoring checks
Binary
1 pass or fail dimensions
Ordinal
3 scaled dimensions
Dimension 1

Complete workflow

Query historical OpenFEMA DisasterDeclarationsSummaries for target county administrative disaster counts. Ingest municipal drainage asset inventories and map geographical coordinates to declared incident jurisdictions. Synthesize structured administrative justification packages linking assets to past federal declaration cycles. Generate verifiable grant evidence dossiers containing asset jurisdiction mapping and administrative references.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 2

Correctness and evidence

Constructs valid OpenFEMA API query URLs using ISO-8601 timestamps and OData filter parameters. Correctly maps asset locations to declared county disaster administrative incidents. Outputs structured JSON administrative evidence packages containing asset IDs and administrative declaration counts. Flags unverified asset jurisdictions or missing disaster declaration history for manual review.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 3

Review interface

Browser-based project configuration workbench with asset geo-table preview, FEMA disaster query builder, and grant dossier export panel.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 4

Safe execution

Simulates grant application administrative packages for review only. Does not disburse public funds or create binding municipal commitments.

Binary check

This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.

Learning goals

What you should walk away with

  • Query historical OpenFEMA DisasterDeclarationsSummaries for target county administrative disaster counts.

  • Ingest municipal drainage asset inventories and map geographical coordinates to declared incident jurisdictions.

  • Synthesize structured administrative justification packages linking assets to past federal declaration cycles.

  • Generate verifiable grant evidence dossiers containing asset jurisdiction mapping and administrative references.

Resources and assets

Reference links and supporting material

Dataset notes

Fetch OpenFEMA v2 DisasterDeclarationsSummaries endpoint using $filter on state and incidentType, or load bundled synthetic county disaster records. Supplied starter examples are synthetic, not source extracts.

Challenge setup

Configuration summary for this challenge.

Challenge input

Input details are not configured.

Pydantic AI

Typed Python agent framework.

Evaluated output

No output checks are configured.

Evaluation checks
  • Query historical OpenFEMA DisasterDeclarationsSummaries for target county administrative disaster counts. I...
  • Constructs valid OpenFEMA API query URLs using ISO-8601 timestamps and OData filter parameters. Correctly m...
  • Browser-based project configuration workbench with asset geo-table preview, FEMA disaster query builder, an...
Configured evaluation evidence
  • 2 public reference cases
Configured runtime
  • 2 configured tools

Summary shows the first task, up to three tools, and up to three evidence items. Open the technical recipe to view all configured items.

View technical recipe

Configured tools

Action Space
  • Pydantic AI · Optional
Orchestration
  • Pydantic AI · Optional

Evaluation contract

  • Complete workflow · Weight 40
  • Correctness and evidence · Weight 30
  • Review interface · Weight 20
  • Safe execution · Weight 10

Reference cases

  • 2 public reference cases

Workflow tasks

No workflow tasks are configured.

Recipe freeze marker

No recipe freeze time is recorded.

Frequently Asked Questions about Build a Climate Grant Administrative Evidence Assembler