{"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.address_h3","record":{"asset_id":"forecast.address_h3","title":"Forecast Address H3","description":"Homecastr geocoding plus forecast serving tables. Support: address|h3; Houston best coverage. Fields: home value p10/p25/p50/p75/p90; appreciation; fan chart.","data_family":"forecast_output","raw_source_or_access":"Homecastr geocoding plus forecast serving tables","example_internal_artifacts":"apps/web/src/app/api/v1/forecast/route.ts; h3 serving path","support_level":"address|h3; Houston best coverage","targets_or_fields":"home value p10/p25/p50/p75/p90; appreciation; fan chart","pipeline_state":"serving","public_status":"launch","sensitivity":"medium","visibility":"public","license_status":"public_api_terms","recommended_public_surface":"Keep as API surface, not bulk data","public_data_inventory_asset":"forecast.aggregate_surfaces","current_surfaces":{"rest":"/api/v1/forecast","mcp":"forecast_by_address","openapi":"yes","docs":"docs/api/README.md; apps/web public docs","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_surfaces","title":"Aggregate forecast API surfaces","phase":"phase_1","public_readiness":"launch","benchmark_role":"public_forecast_surface","model_version":"v12","training_eligibility":"consumer_feed","example_path":"/api/v1/forecast/state?fips=48"},"related_artifact_ids":["public-data.contract_schema_bundle_json"],"related_provenance_ids":[],"payload_availability":{"level":"queryable_rows","metadata_available":true,"sample_rows":false,"queryable_rows":true,"bulk_download":false,"runtime_verification":"contract_declared","reason":"Forecast rows are declared on an asset-specific public REST endpoint."},"gap_or_blocker":"Payload is public API output but address-level use is more sensitive than aggregates","next_step":"Add provenance labels to docs and keep benchmark catalog focused on aggregate outputs","provenance":{"provenance_id":"prov:forecast.address_h3","data_snapshot_id":"docs/public-data/full-data-surface-matrix.tsv@2026-07-19#forecast.address_h3","publication_date":null,"retrieval_date":"2026-07-19","model_version":"v12","license_note":"Public API surface under Homecastr API terms. Keep benchmark and training reuse at aggregate geography only until parcel and unit provenance review is explicit."},"access":{"visibility":"public","support_level":"address|h3; Houston best coverage","sensitivity":"medium","training_eligibility":"consumer_feed","license_status":"public_api_terms"},"_links":{"self":"/api/v1/data/assets/forecast.address_h3","catalog":"/api/v1/data/catalog?asset_id=forecast.address_h3","schemas":"/api/v1/data/schemas?data_family=forecast_output","docs":"/api-docs","compatibility_rest":"/api/v1/forecast","benchmark_catalog":"/api/v1/benchmarks/catalog?asset_id=forecast.aggregate_surfaces","artifact":"/api/v1/data/artifacts/public-data.contract_schema_bundle_json"}},"provenance":{"provenance_id":"prov:forecast.address_h3","data_snapshot_id":"docs/public-data/full-data-surface-matrix.tsv@2026-07-19#forecast.address_h3","publication_date":null,"retrieval_date":"2026-07-19","model_version":"v12","license_note":"Public API surface under Homecastr API terms. Keep benchmark and training reuse at aggregate geography only until parcel and unit provenance review is explicit."},"access":{"visibility":"public","support_level":"address|h3; Houston best coverage","sensitivity":"medium","training_eligibility":"consumer_feed","license_status":"public_api_terms"},"_links":{"self":"/api/v1/data/assets/forecast.address_h3","catalog":"/api/v1/data/catalog","docs":"/api-docs"}}