# CISA ICS Advisory Seed Data

This directory is reserved for **seed data** sourced from the community-maintained [ICS Advisory Project](https://github.com/icsadvprj/ICS-Advisory-Project). The project republishes CISA ICS advisories under the **Open Database License (ODbL) v1.0**. StellaOps uses these CSV snapshots to bootstrap offline environments before the official GovDelivery credentials arrive.

> ⚠️ **Licence notice** – By downloading and using the CSV files you agree to the ODbL requirements (attribution, share-alike, and notice preservation). See [`LICENSE-ODBL.md`](https://github.com/icsadvprj/ICS-Advisory-Project/blob/main/LICENSE.md) for the full text.

## Usage

1. Run `scripts/fetch-ics-cisa-seed.sh` (or the PowerShell variant) to download the latest snapshots into this directory.
2. The files are ignored by Git to avoid committing third-party data; include them explicitly when building an Offline Update Kit.
3. When you later switch to live GovDelivery ingestion, keep the CSVs around as historical fixtures—do **not** treat them as an authoritative source once the live connector is enabled.

### Suggested Artefacts

- `CISA_ICS_ADV_Master.csv` – cumulative advisory dataset (2010 → present)
- `CISA_ICS_ADV_<YYYY_MM_DD>.csv` – point-in-time snapshots
- `ICSMA_CSV_<YYYY>.xlsx` – medical device advisories (optional, sourced from the community mirror)

Keep the generated SHA-256 files alongside the CSVs so Offline Kit packaging can verify integrity.
