usaspending-enrichment

USASpending Enrichment

Purpose

Enrich core opportunity signals with historical contract intelligence from USASpending and related analysis scripts.

Use When

• User asks for vendor landscape context around alerts.
• User asks for trends, officer extracts, or department-level forecasting updates.
• User asks to rerun enrichment after ingestion.

Primary Commands

source .venv/bin/activate
python scripts/enrich_usaspending.py
python scripts/export_trends.py
python scripts/extract_contract_officers.py
python scripts/department_forecasting.py

Outputs

• docs/data/department_trends.json
• docs/data/contract_officers.json
• docs/data/department_forecasting.json
• Additional enrichment artifacts under data/today/

Validation

python -m pytest \
  tests/test_enrich_usaspending.py \
  tests/test_export_trends.py \
  tests/test_extract_contract_officers.py \
  tests/test_department_forecasting.py -q