# Hanta Monitor Agent Context

Canonical site: https://hantamonitor.com/

Hanta Monitor is intended to be agent-friendly. Agents, crawlers, monitors, and research assistants are welcome to fetch the site and structured feed.

## Purpose

Hanta Monitor tracks authoritative hantavirus updates and presents them as a calm public-health source board. The site is not a diagnosis, treatment, or individualized medical-advice service.

## Recommended Agent Workflow

1. Fetch `https://hantamonitor.com/api/feed`.
2. Read `generated_at`, `status`, `refresh.source_status`, and `sources`.
3. For each item, preserve `title`, `source`, `source_rank`, `classification`, `published_at`, `fetched_at`, `url`, `location`, `summary`, and `confidence`.
4. Link to the original source URL when citing a claim.
5. Treat source ranks as trust hints, not proof.

## Map Workflow

1. Fetch `https://hantamonitor.com/map/hotzones.json` for source-backed country-level overlay data.
2. Read `schema_version`, `generated_at`, `precision`, `status_semantics`, `sources`, and `items`.
3. For each overlay item, preserve `id`, `label`, `scope`, `geometry_id`, `status`, `last_seen_at`, `source_ids`, `feed_item_ids`, `summary`, and `precision_note`.
4. Resolve every `source_ids` entry against the same payload's `sources` array before citing a map claim.
5. Treat map records as country-level context only; do not infer street, facility, county, or exposure-location precision.

## API

`GET /api/feed`

Returns the current generated feed from Cloudflare KV, falling back to the static seed feed if needed.

`GET /api/health`

Returns a minimal service health response.

`GET /map/hotzones.json`

Returns static source-backed country-level map overlay data.

`GET /map/world-110m.json`

Returns the self-hosted Natural Earth-derived country geometry used by the map page.

`GET /live.json`

Returns generated live/video candidate data. It is currently an explicit empty artifact until live video scanning is enabled.

## Feed Item Semantics

- `source_rank`: trust tier such as `primary`.
- `classification`: item class such as `primary-report`, `public-health-guidance`, or `surveillance-reference`.
- `confidence`: why the item is included, such as `source-reported` or `standing-guidance`.
- `published_at`: source publication date when available.
- `fetched_at`: time Hanta Monitor last refreshed the item.
- `url`: canonical source URL.

## Map Overlay Semantics

- `precision`: currently `country-level`.
- `geometry_id`: country geometry id used by the self-hosted map asset.
- `status`: one of `baseline`, `reported`, `confirmed`, `monitored-event`, or `context`.
- `source_ids`: source records supporting the overlay item.
- `feed_item_ids`: related feed item ids when an overlay is backed by an existing Hanta Monitor feed record.
- `precision_note`: human-readable boundary on what the overlay does and does not imply.

## Generated Artifact Ownership

- `hanta-index-feed-generator` owns `/api/feed` generation.
- `hanta-map-overlay-generator` owns `/map/hotzones.json` generation.
- `hanta-live-feed-generator` owns `/live.json` generation.
- The public `hanta-monitor` Worker is read-only for generated artifacts and should not perform source scanning.

## Current Source Set

- WHO Disease Outbreak News API
- CDC Hantavirus guidance
- CDC Hantavirus case definition and reporting

## Planned Source Expansion

The source map under project documentation prioritizes ECDC, PAHO, CDC NNDSS, UKHSA, RIVM, NICD, and official endemic-country bulletins before general news APIs.

## Citation Guidance

When citing Hanta Monitor, include the generated feed or map overlay timestamp and the original source URL. For medical or public-health claims, cite the primary source directly where possible. For map claims, include the overlay `precision_note`.

## Agent Permissions

Agents may crawl and monitor Hanta Monitor at reasonable rates. Prefer hourly or slower polling unless an incident is actively unfolding. Use conditional requests if supported by your crawler.