Develop

.github/workflows/ci.yml

@@ -46,7 +46,7 @@ jobs:
 
       - name: Check format
         run: |
-          find src test example \( -name '*.c' -o -name '*.h' \) -print0 | \
+          find src test examples \( -name '*.c' -o -name '*.h' \) -print0 | \
             xargs -0 clang-format-21 --dry-run -Werror
 
   c-build-and-test:
@@ -159,7 +159,15 @@ jobs:
           path: |
             examples/har_classifier/data/raw
             examples/ecg_anomaly_ae/data/raw
-          key: datasets-raw-${{ hashFiles('examples/har_classifier/prepare_data.py', 'examples/ecg_anomaly_ae/prepare_data.py') }}
+            examples/mnist_mlp/data/raw
+            examples/mnist_cnn/data/raw
+          key: datasets-raw-${{ hashFiles('examples/har_classifier/prepare_data.py', 'examples/ecg_anomaly_ae/prepare_data.py', 'examples/mnist_mlp/prepare_data.py', 'examples/mnist_cnn/prepare_data.py') }}
+
+      - name: Cache SpeechCommands raw download (shared, ~2.3 GB)
+        uses: actions/cache@v4
+        with:
+          path: examples/_shared/data/speech_commands
+          key: speechcommands-raw-${{ hashFiles('examples/_shared/speechcommands_data.py') }}
 
       - name: Prepare HAR data
         run: uv run examples/har_classifier/prepare_data.py
@@ -173,36 +181,117 @@ jobs:
       - name: Train PyTorch ECG (produces reference reconstructions + weights)
         run: uv run examples/ecg_anomaly_ae/train_pytorch.py
 
+      - name: Prepare MNIST MLP data
+        run: uv run examples/mnist_mlp/prepare_data.py
+
+      - name: Train PyTorch MNIST MLP (produces reference predictions + weights)
+        run: uv run examples/mnist_mlp/train_pytorch.py
+
+      - name: Prepare MNIST CNN data
+        run: uv run examples/mnist_cnn/prepare_data.py
+
+      - name: Train PyTorch MNIST CNN (produces reference predictions + weights)
+        run: uv run examples/mnist_cnn/train_pytorch.py
+
+      - name: Cache kws_mfcc processed data (6-class)
+        id: kws-mfcc-cache
+        uses: actions/cache@v4
+        with:
+          path: examples/kws_mfcc/data/6class
+          key: kws-mfcc-6class-${{ hashFiles('examples/kws_mfcc/prepare_data.py', 'examples/_shared/speechcommands_data.py') }}
+
+      - name: Prepare kws_mfcc data (6-class; only on cache miss)
+        if: steps.kws-mfcc-cache.outputs.cache-hit != 'true'
+        run: uv run examples/kws_mfcc/prepare_data.py
+
+      - name: Train PyTorch kws_mfcc (produces reference predictions + weights)
+        run: uv run examples/kws_mfcc/train_pytorch.py
+
+      - name: Cache kws_raw processed data (6-class)
+        id: kws-raw-cache
+        uses: actions/cache@v4
+        with:
+          path: examples/kws_raw/data/6class
+          key: kws-raw-6class-${{ hashFiles('examples/kws_raw/prepare_data.py', 'examples/_shared/speechcommands_data.py') }}
+
+      - name: Prepare kws_raw data (6-class; only on cache miss)
+        if: steps.kws-raw-cache.outputs.cache-hit != 'true'
+        run: uv run examples/kws_raw/prepare_data.py
+
+      - name: Train PyTorch kws_raw (produces reference predictions + weights)
+        run: uv run examples/kws_raw/train_pytorch.py
+
       - name: Configure
         run: cmake --preset examples
 
-      - name: Build v2 binaries
-        run: |
-          cmake --build --preset examples --target train_c_har_classifier_v2
-          cmake --build --preset examples --target train_c_ecg_anomaly_ae_v2
+      - name: Build ALL example binaries (rot guard — any broken example fails CI)
+        # Builds the default `all` target so every example executable is compiled,
+        # not just the two run below. Closes the gap that let example/MnistExperiment
+        # (#235) and the legacy v1 trainers silently rot — nothing built them.
+        run: cmake --build --preset examples
 
-      - name: Run HAR v2 in BIT_PARITY mode
-        run: BIT_PARITY=1 build/examples/examples/har_classifier_v2/train_c_har_classifier_v2
+      - name: Run HAR in BIT_PARITY mode
+        run: BIT_PARITY=1 build/examples/examples/har_classifier/train_c_har_classifier
 
-      - name: Run ECG v2 in BIT_PARITY mode
-        run: BIT_PARITY=1 build/examples/examples/ecg_anomaly_ae_v2/train_c_ecg_anomaly_ae_v2
+      - name: Run ECG in BIT_PARITY mode
+        run: BIT_PARITY=1 build/examples/examples/ecg_anomaly_ae/train_c_ecg_anomaly_ae
 
       - name: Diff HAR predictions (int32, exact match required)
         run: |
           uv run examples/_shared/compare_predictions.py \
             --pytorch examples/har_classifier/outputs/pytorch_predictions.npy \
-            --c examples/har_classifier_v2/outputs/c_predictions.npy \
+            --c examples/har_classifier/outputs/c_predictions.npy \
             --dtype int32
 
       - name: Diff ECG reconstructions (float32, allclose)
         run: |
           uv run examples/_shared/compare_predictions.py \
             --pytorch examples/ecg_anomaly_ae/outputs/pytorch_reconstructions.npy \
-            --c examples/ecg_anomaly_ae_v2/outputs/c_reconstructions.npy \
+            --c examples/ecg_anomaly_ae/outputs/c_reconstructions.npy \
             --dtype float32 \
             --rtol 1e-4 \
             --atol 1e-5
 
+      - name: Run MNIST MLP in BIT_PARITY mode
+        run: BIT_PARITY=1 build/examples/examples/mnist_mlp/train_c_mnist_mlp
+
+      - name: Diff MNIST MLP predictions (int32, exact match required)
+        run: |
+          uv run examples/_shared/compare_predictions.py \
+            --pytorch examples/mnist_mlp/outputs/pytorch_predictions.npy \
+            --c examples/mnist_mlp/outputs/c_predictions.npy \
+            --dtype int32
+
+      - name: Run MNIST CNN in BIT_PARITY mode
+        run: BIT_PARITY=1 build/examples/examples/mnist_cnn/train_c_mnist_cnn
+
+      - name: Diff MNIST CNN predictions (int32, exact match required)
+        run: |
+          uv run examples/_shared/compare_predictions.py \
+            --pytorch examples/mnist_cnn/outputs/pytorch_predictions.npy \
+            --c examples/mnist_cnn/outputs/c_predictions.npy \
+            --dtype int32
+
+      - name: Run kws_mfcc in BIT_PARITY mode
+        run: BIT_PARITY=1 build/examples/examples/kws_mfcc/train_c_kws_mfcc
+
+      - name: Diff kws_mfcc predictions (int32, exact match required)
+        run: |
+          uv run examples/_shared/compare_predictions.py \
+            --pytorch examples/kws_mfcc/outputs/6class/pytorch_predictions.npy \
+            --c examples/kws_mfcc/outputs/6class/c_predictions.npy \
+            --dtype int32
+
+      - name: Run kws_raw in BIT_PARITY mode
+        run: BIT_PARITY=1 build/examples/examples/kws_raw/train_c_kws_raw
+
+      - name: Diff kws_raw predictions (int32, exact match required)
+        run: |
+          uv run examples/_shared/compare_predictions.py \
+            --pytorch examples/kws_raw/outputs/6class/pytorch_predictions.npy \
+            --c examples/kws_raw/outputs/6class/c_predictions.npy \
+            --dtype int32
+
   python-test:
     runs-on: ubuntu-latest
 

CMakeLists.txt

@@ -39,7 +39,6 @@ if(ODT_TOP_LEVEL_PROJECT)
     add_ctest()
 
     add_subdirectory(test/unit)
-    add_subdirectory(example)
     if(BUILD_EXAMPLES)
         add_subdirectory(examples)
     endif()

devenv.nix

@@ -97,7 +97,7 @@ in
 					echo "$matches"
 					exit 1
 				fi
-				find src test example \( -name '*.c' -o -name '*.h' \) -print0 \
+				find src test examples \( -name '*.c' -o -name '*.h' \) -print0 \
 					| xargs -0 clang-format --dry-run -Werror
 				CC=gcc cmake --preset unit_test
 				cmake --build --preset unit_test