{"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#context.census_building_permits","record":{"asset_id":"context.census_building_permits","title":"Context Census Building Permits","description":"Census Building Permits Survey county-month permits and local permit systems. Support: county|month|place|permit. Fields: permit buildings; permit units; construction value; construction pipeline.","data_family":"context_input","raw_source_or_access":"Census Building Permits Survey county-month permits and local permit systems","example_internal_artifacts":"schema_registry.yaml; docs/ml/v15_source_benchmark_matrix.md; docs/prediction_markets/permit-zoning-data-readiness.md","support_level":"county|month|place|permit","targets_or_fields":"permit buildings; permit units; construction value; construction pipeline","pipeline_state":"normalized_public_bps_rows","public_status":"launch","sensitivity":"low","visibility":"public","license_status":"public_source","recommended_public_surface":"Use normalized Census BPS county-month rows; keep local permit systems metadata-only until normalized","public_data_inventory_asset":null,"current_surfaces":{"rest":"/api/v1/data/permits/census-bps/county-monthly; /api/v1/data/assets/context.census_building_permits","mcp":"get_census_bps_county_monthly; get_data_asset","openapi":"yes","docs":"docs/api/README.md; docs/api/MCP.md; docs/prediction_markets/permit-zoning-data-readiness.md","sdk":"client.permits.queryCensusBpsCountyMonthly(); client.dataAssets.get()"},"canonical_profile":{"source_contract":"hc.source_snapshot.v1","canonical_contracts":["hc.observation.v1","hc.feature_record.v1","hc.panel_row.v1","hc.provenance_manifest.v1","hc.access_policy.v1","hc.artifact_manifest.v1"],"raw_retention":"Keep immutable source extracts or API response snapshots with source-specific cadence and terms metadata.","normalization":["normalize geographies, metric IDs, units, seasonal adjustment, and publication lag","separate event period, publication time, and retrieval time"],"engineering":["apply as-of joins","derive lags, rolling statistics, exposure measures, and geography rollups with transform versions"],"synthesis_policy":"Derived scenarios are allowed; observed context values and simulated context must remain different record types.","delivery":null},"delivery_targets":{"rest":["/api/v1/data/observations","/api/v1/data/features","/api/v1/data/panels"],"mcp":["query_observations","query_features","get_panel_slice"],"openapi":["Observation","FeatureRecord","PanelRow"],"docs":["source card","metric dictionary","publication-lag semantics","feature recipes"],"sdk":["client.observations.query","client.features.query","client.panels.getSlice"],"export_formats":["jsonl","csv","parquet"]},"inventory_asset":null,"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":"Normalized public rows are declared on the asset-specific REST endpoint."},"gap_or_blocker":"Only Census BPS county-month rows are public; local permits, zoning, environmental permits, and entitlement feeds need normalization","next_step":"Add refresh monitor, source-snapshot settlement manifests, and non-BPS permit/zoning row normalization","provenance":{"provenance_id":"prov:context.census_building_permits","data_snapshot_id":"docs/public-data/full-data-surface-matrix.tsv@2026-07-19#context.census_building_permits","publication_date":null,"retrieval_date":"2026-07-19","model_version":null,"license_note":"Policy status: public_source. Recommended public surface: Use normalized Census BPS county-month rows; keep local permit systems metadata-only until normalized."},"access":{"visibility":"public","support_level":"county|month|place|permit","sensitivity":"low","training_eligibility":"benchmark_only","license_status":"public_source"},"_links":{"self":"/api/v1/data/assets/context.census_building_permits","catalog":"/api/v1/data/catalog?asset_id=context.census_building_permits","schemas":"/api/v1/data/schemas?data_family=context_input","docs":"/api-docs","compatibility_rest":"/api/v1/data/permits/census-bps/county-monthly; /api/v1/data/assets/context.census_building_permits","artifact":"/api/v1/data/artifacts/public-data.contract_schema_bundle_json"}},"provenance":{"provenance_id":"prov:context.census_building_permits","data_snapshot_id":"docs/public-data/full-data-surface-matrix.tsv@2026-07-19#context.census_building_permits","publication_date":null,"retrieval_date":"2026-07-19","model_version":null,"license_note":"Policy status: public_source. Recommended public surface: Use normalized Census BPS county-month rows; keep local permit systems metadata-only until normalized."},"access":{"visibility":"public","support_level":"county|month|place|permit","sensitivity":"low","training_eligibility":"benchmark_only","license_status":"public_source"},"_links":{"self":"/api/v1/data/assets/context.census_building_permits","catalog":"/api/v1/data/catalog","docs":"/api-docs"}}