{"schema_id":"hc.dataset_asset.v1","schema_version":"1.1.0","data_snapshot_id":"docs/public-data/full-data-surface-matrix.tsv@2026-07-19#forecast.aggregate_downloads","record":{"asset_id":"forecast.aggregate_downloads","title":"Forecast Aggregate Downloads","description":"CSV export builder over state/county/city/tract aggregate data. Support: national|state|city|county|tract. Fields: CSV aggregate outlook rows with metadata comments.","data_family":"forecast_output","raw_source_or_access":"CSV export builder over state/county/city/tract aggregate data","example_internal_artifacts":"apps/web/src/app/api/forecasts/download/route.ts","support_level":"national|state|city|county|tract","targets_or_fields":"CSV aggregate outlook rows with metadata comments","pipeline_state":"serving_export","public_status":"launch","sensitivity":"low","visibility":"public","license_status":"public_export_ready","recommended_public_surface":"CSV and JSON public artifact pattern","public_data_inventory_asset":"forecast.aggregate_downloads","current_surfaces":{"rest":"/api/forecasts/download","mcp":"get_data_asset; query_forecasts; get_target_metric_forecast","openapi":"yes","docs":"docs/public-data/README.md","sdk":"client.dataAssets.get(); client.forecasts.query(); client.artifacts.download()"},"canonical_profile":{"source_contract":"hc.source_snapshot.v1","canonical_contracts":["hc.forecast_series.v1","hc.forecast_vintage.v1","hc.provenance_manifest.v1","hc.access_policy.v1","hc.artifact_manifest.v1"],"raw_retention":"Preserve model output bundles and served payload snapshots by model version and origin time.","normalization":["canonicalize entity IDs and geography vintages","separate origin time from forecast time","normalize target IDs, units, quantiles, and scenarios"],"engineering":["derive growth and summary statistics from canonical forecast points","retain the input forecast IDs used by every summary"],"synthesis_policy":"Scenario generation is allowed only as hc.synthetic_record.v1 with parent forecast snapshots and no observed-data claim.","delivery":null},"delivery_targets":{"rest":["/api/v1/data/forecasts","/api/v1/data/vintages","/api/v1/data/artifacts/{artifact_id}"],"mcp":["query_forecasts","get_forecast_vintage","get_data_artifact"],"openapi":["ForecastSeries","ForecastVintage","ArtifactManifest"],"docs":["dataset card","forecast semantics","provenance and model card","REST/MCP/SDK examples"],"sdk":["client.forecasts.query","client.vintages.get","client.artifacts.download"],"export_formats":["json","jsonl","csv"]},"inventory_asset":{"asset_id":"forecast.aggregate_downloads","title":"Aggregate forecast download artifacts","phase":"phase_1","public_readiness":"launch","benchmark_role":"aggregate_export_artifact","model_version":"v12","training_eligibility":"consumer_feed","example_path":"/api/forecasts/download?state=tx"},"related_artifact_ids":["public-data.contract_schema_bundle_json"],"related_provenance_ids":[],"payload_availability":{"level":"bulk_download","metadata_available":true,"sample_rows":false,"queryable_rows":true,"bulk_download":true,"runtime_verification":"contract_declared","reason":"A public bulk export is declared for this asset."},"gap_or_blocker":"No MCP wrapper and not in OpenAPI","next_step":"Add benchmark catalog link and maybe OpenAPI entry if public API","provenance":{"provenance_id":"prov:forecast.aggregate_downloads","data_snapshot_id":"docs/public-data/full-data-surface-matrix.tsv@2026-07-19#forecast.aggregate_downloads","publication_date":null,"retrieval_date":"2026-07-19","model_version":"v12","license_note":"CSV/JSON aggregate exports are in scope first. Parquet remains deferred until each artifact is clearly license-safe."},"access":{"visibility":"public","support_level":"national|state|city|county|tract","sensitivity":"low","training_eligibility":"consumer_feed","license_status":"public_export_ready"},"_links":{"self":"/api/v1/data/assets/forecast.aggregate_downloads","catalog":"/api/v1/data/catalog?asset_id=forecast.aggregate_downloads","schemas":"/api/v1/data/schemas?data_family=forecast_output","docs":"/api-docs","compatibility_rest":"/api/forecasts/download","benchmark_catalog":"/api/v1/benchmarks/catalog?asset_id=forecast.aggregate_downloads","artifact":"/api/v1/data/artifacts/public-data.contract_schema_bundle_json"}},"provenance":{"provenance_id":"prov:forecast.aggregate_downloads","data_snapshot_id":"docs/public-data/full-data-surface-matrix.tsv@2026-07-19#forecast.aggregate_downloads","publication_date":null,"retrieval_date":"2026-07-19","model_version":"v12","license_note":"CSV/JSON aggregate exports are in scope first. Parquet remains deferred until each artifact is clearly license-safe."},"access":{"visibility":"public","support_level":"national|state|city|county|tract","sensitivity":"low","training_eligibility":"consumer_feed","license_status":"public_export_ready"},"_links":{"self":"/api/v1/data/assets/forecast.aggregate_downloads","catalog":"/api/v1/data/catalog","docs":"/api-docs"}}