{
  "contract": "conceptual-join-plan-v1",
  "blueprints": [
    {
      "title": "Cost, Completion, Wages, and Rent",
      "question": "How do net price, completion, field earnings, and local rent relate for a program at an institution?",
      "source_profiles": [
        "college",
        "labor",
        "housing"
      ],
      "keys": [
        "UNITID",
        "CIP version",
        "county FIPS",
        "ACS vintage",
        "award year",
        "cohort"
      ],
      "grain": "institution x CIP x county x year",
      "cardinality_checks": [
        "One row per institution and CIP per year",
        "Verify one rent row per county/vintage before a many-to-one attachment; do not sum repeated county statistics across institutions or programs",
        "Earnings population documented separately from completion cohort",
        "Verify source revisions and licensing compatibility",
        "Preserve unmatched and suppressed cells",
        "Validate many-to-many bridge weights and pre/post-join totals",
        "Bound dry-run bytes and execution cost before any query"
      ],
      "interpretation_limit": "Populations differ by measure; no causal or personalized claim.",
      "id": "JOIN-001",
      "state": "conceptual_not_executable",
      "execution_enabled": false
    },
    {
      "title": "Firms, Energy, and Jobs",
      "question": "How do establishment counts, electricity prices, and industry employment move together by county?",
      "source_profiles": [
        "census",
        "energy",
        "labor"
      ],
      "keys": [
        "county FIPS",
        "NAICS version",
        "state",
        "year or month"
      ],
      "grain": "county x NAICS x year",
      "cardinality_checks": [
        "Energy prices are state level and fan out to counties",
        "Monthly energy aggregated to year before join",
        "Suppressed QCEW cells preserved as unknown",
        "Verify source revisions and licensing compatibility",
        "Preserve unmatched and suppressed cells",
        "Validate many-to-many bridge weights and pre/post-join totals",
        "Bound dry-run bytes and execution cost before any query",
        "State energy prices are contextual, non-additive across counties; resolve industry classification and temporal versions"
      ],
      "interpretation_limit": "State prices cannot explain county employment.",
      "id": "JOIN-002",
      "state": "conceptual_not_executable",
      "execution_enabled": false
    },
    {
      "title": "Grants and Need",
      "question": "Where do federal grant obligations land relative to indicators of need?",
      "source_profiles": [
        "finance",
        "census"
      ],
      "keys": [
        "county FIPS",
        "program number",
        "fiscal year",
        "ACS vintage"
      ],
      "grain": "county x program x fiscal year",
      "cardinality_checks": [
        "Place of performance used, not recipient address",
        "Fiscal year mapped to ACS period explicitly",
        "Subaward incompleteness flagged",
        "Verify source revisions and licensing compatibility",
        "Preserve unmatched and suppressed cells",
        "Validate many-to-many bridge weights and pre/post-join totals",
        "Bound dry-run bytes and execution cost before any query"
      ],
      "interpretation_limit": "Obligations are not delivered services.",
      "id": "JOIN-003",
      "state": "conceptual_not_executable",
      "execution_enabled": false
    },
    {
      "title": "Transport and Access",
      "question": "Which campuses and health facilities have transit stops nearby, with what service coverage?",
      "source_profiles": [
        "transport",
        "college",
        "health"
      ],
      "keys": [
        "stop ID",
        "feed version",
        "UNITID",
        "facility ID",
        "geography vintage"
      ],
      "grain": "site x stop",
      "cardinality_checks": [
        "Spatial join bounded by radius, not Cartesian",
        "Feed version date recorded",
        "Duplicate stops collapsed by stop ID",
        "Verify source revisions and licensing compatibility",
        "Preserve unmatched and suppressed cells",
        "Validate many-to-many bridge weights and pre/post-join totals",
        "Bound dry-run bytes and execution cost before any query"
      ],
      "interpretation_limit": "Spatial proximity is not accessibility. Check pedestrian barriers, route calendars, frequency and time of day before claiming travel access.",
      "id": "JOIN-004",
      "state": "conceptual_not_executable",
      "execution_enabled": false
    },
    {
      "title": "Healthcare and Workforce",
      "question": "How do shortage area designations compare with health occupation employment and program completions?",
      "source_profiles": [
        "health",
        "labor",
        "college"
      ],
      "keys": [
        "area ID",
        "county FIPS",
        "SOC version",
        "CIP version",
        "year"
      ],
      "grain": "county x discipline x year",
      "cardinality_checks": [
        "CIP to SOC fanout audited",
        "Designation areas mapped to counties with overlap share",
        "Employment counts jobs, not persons",
        "Verify source revisions and licensing compatibility",
        "Preserve unmatched and suppressed cells",
        "Validate many-to-many bridge weights and pre/post-join totals",
        "Bound dry-run bytes and execution cost before any query"
      ],
      "interpretation_limit": "Designation is administrative; completions are not local hires.",
      "id": "JOIN-005",
      "state": "conceptual_not_executable",
      "execution_enabled": false
    },
    {
      "title": "Research and Industry",
      "question": "How do research expenditure, industry co-authorship, and regional industry employment relate by field?",
      "source_profiles": [
        "research",
        "labor",
        "census"
      ],
      "keys": [
        "institution ID",
        "field code",
        "CBSA code",
        "NAICS version",
        "year"
      ],
      "grain": "institution x field x metro x year",
      "cardinality_checks": [
        "Field to NAICS mapping documented as many-to-many",
        "Affiliation matching coverage reported",
        "Observation date fixed for citations",
        "Verify source revisions and licensing compatibility",
        "Preserve unmatched and suppressed cells",
        "Validate many-to-many bridge weights and pre/post-join totals",
        "Bound dry-run bytes and execution cost before any query",
        "A validated research-field-to-industry crosswalk is a prerequisite; no mapping or executable join is supplied"
      ],
      "interpretation_limit": "Co-occurrence is not technology transfer.",
      "id": "JOIN-006",
      "state": "conceptual_not_executable",
      "execution_enabled": false
    },
    {
      "title": "Housing and Income",
      "question": "How do permits, rent burden, and income distribution relate by county over time?",
      "source_profiles": [
        "housing",
        "census"
      ],
      "keys": [
        "county FIPS",
        "ACS vintage",
        "income band",
        "year"
      ],
      "grain": "county x income band x year",
      "cardinality_checks": [
        "ACS one-year versus five-year not mixed",
        "Margins of error carried through",
        "Permit counts aligned to calendar year",
        "Verify source revisions and licensing compatibility",
        "Preserve unmatched and suppressed cells",
        "Validate many-to-many bridge weights and pre/post-join totals",
        "Bound dry-run bytes and execution cost before any query"
      ],
      "interpretation_limit": "Permits are not completions; no housing advice.",
      "id": "JOIN-007",
      "state": "conceptual_not_executable",
      "execution_enabled": false
    },
    {
      "title": "Sports and Schedule",
      "question": "How do schedule density, travel distance, and postponements vary by team and week?",
      "source_profiles": [
        "sports",
        "transport"
      ],
      "keys": [
        "league",
        "season",
        "team ID",
        "venue ID",
        "game date",
        "schedule version"
      ],
      "grain": "team x week",
      "cardinality_checks": [
        "Unique league, season, game ID, team ID and schedule revision before team-week aggregation",
        "Venue coordinates joined one-to-one",
        "Postponed games retained with status",
        "Verify source revisions and licensing compatibility",
        "Preserve unmatched and suppressed cells",
        "Validate many-to-many bridge weights and pre/post-join totals",
        "Bound dry-run bytes and execution cost before any query"
      ],
      "interpretation_limit": "Venue-to-venue distances are proxies, not verified travel itineraries. No roster or betting actions.",
      "id": "JOIN-008",
      "state": "conceptual_not_executable",
      "execution_enabled": false
    }
  ]
}