oracle: add fixed four-epoch final protocol

run_easycom_oracle_information.sh

@@ -72,18 +72,13 @@ variant_local_args() {
   fi
 }
 
-train_and_screen() {
+train_variants() {
   mkdir -p "${CHECKPOINT_ROOT}" "${RESULT_ROOT}"
   for seed in "${seeds[@]}"; do
     for variant in "${variants[@]}"; do
       checkpoint="${CHECKPOINT_ROOT}/${variant}_seed${seed}.pth"
-      result="${RESULT_ROOT}/${variant}_seed${seed}"
-      local_feature_root="${ORACLE_ROOT}/${variant}"
-      if [[ "${variant}" == "audio" ]]; then
-        local_feature_root="${LOCAL_ROOT}"
-      fi
-      if [[ -e "${checkpoint}" || -e "${result}" ]]; then
-        echo "Refusing to overwrite ${checkpoint} or ${result}" >&2
+      if [[ -e "${checkpoint}" ]]; then
+        echo "Refusing to overwrite ${checkpoint}" >&2
         exit 1
       fi
       local_args=()
@@ -111,7 +106,28 @@ train_and_screen() {
         --expected-mode "${EXPECTED_MODE}" \
         --seed "${seed}" \
         --device cuda:0
+    done
+  done
+}
 
+screen_variants() {
+  mkdir -p "${RESULT_ROOT}"
+  for seed in "${seeds[@]}"; do
+    for variant in "${variants[@]}"; do
+      checkpoint="${CHECKPOINT_ROOT}/${variant}_seed${seed}.pth"
+      result="${RESULT_ROOT}/${variant}_seed${seed}"
+      local_feature_root="${ORACLE_ROOT}/${variant}"
+      if [[ "${variant}" == "audio" ]]; then
+        local_feature_root="${LOCAL_ROOT}"
+      fi
+      if [[ ! -f "${checkpoint}" ]]; then
+        echo "Missing checkpoint: ${checkpoint}" >&2
+        exit 1
+      fi
+      if [[ -e "${result}" ]]; then
+        echo "Refusing to overwrite ${result}" >&2
+        exit 1
+      fi
       echo "$(date): screening ${variant}, seed=${seed} on ${screen_sessions[*]}"
       "${PYTHON_BIN}" infer_turn_head.py \
         --feature-root "${FEATURE_ROOT}" \
@@ -130,6 +146,30 @@ train_and_screen() {
     --protocol causal_valid_only
 }
 
+train_all_fixed_and_test() {
+  if [[ "${EPOCHS}" != "4" ]]; then
+    echo "The final protocol requires EPOCHS=4, got ${EPOCHS}" >&2
+    exit 2
+  fi
+
+  normalized_train=()
+  for session in "${train_sessions[@]}"; do
+    normalized_train+=("${session#Session_}")
+  done
+  if [[ "${normalized_train[*]}" != "4 5 6 7 8 9 10 11 12" ]]; then
+    echo "The final protocol requires exactly EasyCom Sessions 4--12 for training" >&2
+    exit 2
+  fi
+
+  # No development checkpoint selection: the final epoch is fixed in advance.
+  # Keep these artifacts separate from the historical Session-12 screen.
+  dev_sessions=()
+  CHECKPOINT_ROOT="${FINAL_CHECKPOINT_ROOT:-${CHECKPOINT_ROOT}_train4_12_fixed4}"
+  RESULT_ROOT="${FINAL_RESULT_ROOT:-${RESULT_ROOT}_train4_12_fixed4}"
+  train_variants
+  test_selected
+}
+
 test_selected() {
   mkdir -p "${RESULT_ROOT}_test"
   for seed in "${seeds[@]}"; do
@@ -170,11 +210,17 @@ case "${stage}" in
     prepare_oracles
     ;;
   screen)
-    train_and_screen
+    train_variants
+    screen_variants
     ;;
   all)
     prepare_oracles
-    train_and_screen
+    train_variants
+    screen_variants
+    ;;
+  final)
+    prepare_oracles
+    train_all_fixed_and_test
     ;;
   test)
     test_selected
@@ -186,7 +232,7 @@ case "${stage}" in
       --protocol causal_valid_only
     ;;
   *)
-    echo "Usage: $0 {prepare|screen|all|test|summarize} [seed ...]" >&2
+    echo "Usage: $0 {prepare|screen|all|final|test|summarize} [seed ...]" >&2
     exit 2
     ;;
 esac