Build a Disaster Claim Document Completeness and Adjuster Visit Scheduler — implementation

## Build
Inspect submitted property damage loss documents against declared disaster incident logs and geospatial imagery. Flag missing required evidentiary records and construct prioritized field adjuster inspection routing itineraries.

## User
Claim intake coordinators managing disaster loss inspection queues for commercial and agricultural properties.

## Workflow
1. Ingest property loss notification payloads and cross-check against OpenFEMA disaster declarations for date and jurisdiction validity.
2. Audit submitted document manifests against mandatory evidence checklists including photo proof, itemized estimates, and ownership deeds.
3. Calculate completeness scores and isolate critical missing evidentiary items required for formal adjuster triage.
4. Synthesize structured adjuster site-visit itineraries prioritizing high-severity claims with complete documentation.

## Interface
Multi-pane intake console with checklist reconciliation tables, document gap callouts, and field visit dispatch calendar.

## Data
Combine OpenFEMA v2 DisasterDeclarationsSummaries query responses with synthetic claim file manifests in local JSON fixture format.
Starter examples below are synthetic. They are not downloaded records.

## Source
[FEMA OpenFEMA](https://www.fema.gov/about/openfema/api)
Extracts disasterNumber, incidentType, and declarationDate from OpenFEMA v2 DisasterDeclarationsSummaries to validate incident jurisdiction and timing.

## Tools
mastra-ai, pydantic, dateutil.
Mastra AI provides deterministic workflow orchestration to evaluate sequential document validation rules and generate visit schedules.
Local small LLM (e.g. Mistral 7B via Ollama) or hosted API to draft claimant missing-document notices.

## 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
- Rejects claims where asserted loss dates fall outside the declared OpenFEMA disaster incident window.
- Detects missing mandatory document categories from submitted property claim manifests.
- Generates sorted adjuster inspection itineraries respecting priority triage scores.
- Emits claimant document request notices specifying exact missing attachments.

## Starter Examples
```json
[
  {
    "input": {
      "claim_id": "CLM-2023-8801",
      "policy_holder": "Apex Logistics Yard",
      "county_fips": "22051",
      "asserted_loss_date": "2023-08-30T10:00:00Z",
      "disaster_declaration": {
        "disasterNumber": 4720,
        "incidentType": "Hurricane",
        "incidentBeginDate": "2023-08-28T00:00:00Z",
        "incidentEndDate": "2023-09-02T23:59:59Z"
      },
      "uploaded_documents": [
        "deed_of_ownership.pdf",
        "interior_flood_photos.zip",
        "repair_contractor_estimate.pdf"
      ]
    },
    "expected_output": {
      "claim_id": "CLM-2023-8801",
      "incident_verified": true,
      "completeness_score": 1,
      "missing_mandatory_items": [],
      "adjuster_status": "READY_TO_SCHEDULE",
      "scheduled_priority_tier": "HIGH",
      "visit_window_start": "2023-09-05T09:00:00Z"
    }
  },
  {
    "input": {
      "claim_id": "CLM-2023-9042",
      "policy_holder": "Delta River Marina",
      "county_fips": "22051",
      "asserted_loss_date": "2023-08-30T10:00:00Z",
      "disaster_declaration": {
        "disasterNumber": 4720,
        "incidentType": "Hurricane",
        "incidentBeginDate": "2023-08-28T00:00:00Z",
        "incidentEndDate": "2023-09-02T23:59:59Z"
      },
      "uploaded_documents": [
        "interior_flood_photos.zip"
      ]
    },
    "expected_output": {
      "claim_id": "CLM-2023-9042",
      "incident_verified": true,
      "completeness_score": 0.33,
      "missing_mandatory_items": [
        "deed_of_ownership",
        "repair_contractor_estimate"
      ],
      "adjuster_status": "PENDING_DOCUMENTATION",
      "scheduled_priority_tier": "ON_HOLD",
      "visit_window_start": null
    }
  }
]
```

## Safety
Demonstration intake scheduler only. Does not make final insurance liability determinations, issue claim denials, or authorize payments.
Use mock external writes. Require human review before any real deployment.