{
  "schema_version": "document-semantic-surfaces/v1",
  "required_statuses": ["reviewed", "verified", "published-ready"],
  "always_required_source_types": ["project-note"],
  "explicit_gate_field": "semantic_gate",
  "exclusion_field": "semantic_surface_exclusions",
  "documents": {
    "project-note": {
      "mode": "hub",
      "roots": ["raw/project-notes"],
      "required_surfaces": [
        {"section_id": "project-decisions", "legacy_heading": "^(안정 결정 레지스트리|기술 결정)$"},
        {"section_id": "artifact-registry", "legacy_heading": "^Artifact Registry$"},
        {"section_id": "contract-gate-registry", "legacy_heading": "^Contract/Gate Registry$"},
        {"section_id": "flow-stage-registry", "legacy_heading": "^Flow/Stage Registry$"},
        {"section_id": "architecture-components", "legacy_heading": "^(컴포넌트 책임 분담|구성요소)$"},
        {"section_id": "runtime-flow", "legacy_heading": "^(핵심 시퀀스|요청 처리 흐름|Runtime Flow)$"},
        {"section_id": "sequence", "legacy_heading": "^(시퀀스|Sequence)$"},
        {"section_id": "implementation-boundaries", "legacy_heading": "^(비기능 요구사항|구현 경계)$"},
        {"section_id": "work-items", "section_aliases": ["project-work-items"], "legacy_heading": "^(실행계획|Work Items?)$"}
      ]
    },
    "branch-note": {
      "mode": "local",
      "roots": ["raw/branch-notes"],
      "required_surfaces": [
        {"section_id": "branch-contract-packet", "legacy_heading": "^브랜치 계약 패킷$"},
        {"section_id": "scope", "section_aliases": ["branch-scope"], "legacy_heading": "^범위$"},
        {"section_id": "decision-evidence", "legacy_heading": "^(결정-근거 매핑|Decision Evidence Map)$"},
        {"section_id": "implementation", "legacy_heading": "^구현 가이드$"},
        {"section_id": "edge-failure-dependency", "legacy_heading": "^(엣지·실패·의존|Edge, Failure, Dependency)$"},
        {"section_id": "claims-to-verify", "legacy_heading": "^(검증해야 할 주장|Claims to Verify)$"}
      ]
    }
  }
}