From 9dd123e1d25325f09167134e98c04fd6d7e91970 Mon Sep 17 00:00:00 2001
From: skal <pascal.massimino@gmail.com>
Date: Thu, 12 Feb 2026 12:23:17 +0100
Subject: Update docs and help messages for CNN v2 completion

Updated:
- HOWTO.md: Complete pipeline, storage buffer, --validate mode
- TODO.md: Mark CNN v2 complete, add QAT TODO
- PROJECT_CONTEXT.md: Update Effects status
- CNN_V2.md: Mark complete, add storage buffer notes
- train_cnn_v2_full.sh: Add --help message

All documentation now reflects:
- Storage buffer architecture
- Binary weight format
- Live training progress
- Validation-only mode
- 8-bit quantization TODO
---
 scripts/train_cnn_v2_full.sh | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

(limited to 'scripts/train_cnn_v2_full.sh')

diff --git a/scripts/train_cnn_v2_full.sh b/scripts/train_cnn_v2_full.sh
index b3ece8a..fc9355a 100755
--- a/scripts/train_cnn_v2_full.sh
+++ b/scripts/train_cnn_v2_full.sh
@@ -1,7 +1,18 @@
 #!/bin/bash
 # Complete CNN v2 Training Pipeline
 # Train → Export → Build → Validate
-# Usage: ./train_cnn_v2_full.sh [--validate [checkpoint.pth]]
+# Usage: ./train_cnn_v2_full.sh [OPTIONS]
+#
+# OPTIONS:
+#   (none)                    Run complete pipeline: train → export → build → validate
+#   --validate                Validate only (skip training, use existing weights)
+#   --validate CHECKPOINT     Validate with specific checkpoint file
+#   --help                    Show this help message
+#
+# Examples:
+#   ./train_cnn_v2_full.sh
+#   ./train_cnn_v2_full.sh --validate
+#   ./train_cnn_v2_full.sh --validate checkpoints/checkpoint_epoch_50.pth
 
 set -e
 
@@ -12,6 +23,11 @@ cd "$PROJECT_ROOT"
 VALIDATE_ONLY=false
 VALIDATE_CHECKPOINT=""
 
+if [ "$1" = "--help" ] || [ "$1" = "-h" ]; then
+    head -20 "$0" | grep "^#" | grep -v "^#!/" | sed 's/^# *//'
+    exit 0
+fi
+
 if [ "$1" = "--validate" ]; then
     VALIDATE_ONLY=true
     if [ -n "$2" ]; then
-- 
cgit v1.2.3