{
  "description": "Schema example only. Inspect trusted caches first; replace exact key paths and identity fields from the observed schema. No raw AQ compatibility has been verified.",
  "trusted_joblib": true,
  "root": "/root/disk_3tb/earlywarning/30072026",
  "faculties": ["REPLACE_WITH_FACULTY_FILENAME"],
  "folds": [1, 2, 3, 4, 5, 6, 7],
  "cache_pattern": "results/cross_faculty_residual_moe/cache/{faculty}_fold_{fold}.joblib",
  "key_paths": {
    "Xtr": "Xtr",
    "Xte": "Xte",
    "ytr": "ytr",
    "yte": "yte",
    "train_frame": "train_frame",
    "test_frame": "test_frame",
    "feature_names": "feature_names",
    "cf_covered_mask": "cf_covered_mask"
  },
  "xtr_coverage": "covered",
  "ytr_coverage": "covered",
  "expected_total_features": null,
  "feature_count_note": "Set expected_total_features to 153 when that is the declared complete input. An existing complete 153-feature cache must keep structured_features.enabled=false. A 136-feature cache may explicitly append the 17 aligned sidecar columns below; no feature count is inferred.",
  "columns": {
    "student_id": "IDSV",
    "course_id": "IDMH",
    "semester": "target_NHHK"
  },
  "identity_fields": ["student_id", "course_id", "semester", "faculty"],
  "identity_note": "Prefer columns.row_id mapped to an actual stable registration/attempt key. Add attempt identity when multiple attempts share these fields; duplicates fail.",
  "calendar": {
    "path": "data/suite35_calendar.csv",
    "read_csv": {"encoding": "utf-8"},
    "columns": {
      "semester": "semester",
      "order": "order",
      "origin_at": "origin_at",
      "labels_available_at": "labels_available_at"
    },
    "timestamp_timezone": "Asia/Ho_Chi_Minh"
  },
  "sidecar_pattern": null,
  "sidecar_key_paths": {
    "train_course_target": "REPLACE_WITH_EXACT_TRAIN_COURSE_TARGET_KEY_PATH",
    "test_course_target": "REPLACE_WITH_EXACT_TEST_COURSE_TARGET_KEY_PATH",
    "train_row_index": "REPLACE_WITH_EXACT_TRAIN_ROW_INDEX_KEY_PATH"
  },
  "structured_features": {
    "enabled": false,
    "train_key_path": "REPLACE_WITH_EXACT_TRAIN_STRUCTURED_MATRIX_KEY_PATH",
    "test_key_path": "REPLACE_WITH_EXACT_TEST_STRUCTURED_MATRIX_KEY_PATH",
    "feature_names_key_path": "REPLACE_WITH_EXACT_ORDERED_STRUCTURED_FEATURE_NAMES_KEY_PATH",
    "expected_count": 17
  },
  "structured_note": "Optional, disabled by default. Enable only for explicitly declared additional features after inspecting the actual trusted sidecar keys. Train structured rows must align exactly to train_row_index=flatnonzero(cf_covered_mask); test structured rows must align to all test_frame rows in order. With full Xtr, uncovered structured rows receive NaN and are retained for downstream missing indicators. Feature names must be unique across canonical and structured inputs.",
  "sidecar_note": "When frame IDMH is absent, set sidecar_pattern to the observed results/suite12_structured_cache/.../{faculty}/...fold...joblib pattern and set all exact sidecar_key_paths. train_row_index must exactly equal flatnonzero(cf_covered_mask). No sidecar row order is inferred. Full Xtr needs explicit courses even for uncovered rows.",
  "output_note": "One train/test snapshot per faculty and fold; manifest.json entries declare paths and exact numeric feature order. Events with actual numeric grades are extracted separately. No global enrollment collapse is performed."
}
