0.1.0

docs/VERSION_HEADER_AUDIT.md

@@ -0,0 +1,30 @@
+<!-- file: docs/VERSION_HEADER_AUDIT.md -->
+<!-- version: 1 -->
+
+# Audit des en-têtes de version
+
+Ce document regroupe les commandes utiles pour vérifier les en-têtes `file:` et `version:`.
+
+## Lignes `version` différentes de 1
+
+La commande suivante utilise deux passes pour éviter les problèmes de lookahead et d'expansion d'historique Bash :
+
+```bash
+rg -n -P '^\s*(//|#|<!--|--|/\*)\s*version\s*:\s*[0-9]+'   -g '!target/**'   -g '!node_modules/**'   -g '!dist/**'   -g '!idls/**/*.json'   . | rg -v -P 'version\s*:\s*1\s*(-->|\*/)?\s*$'
+```
+
+## Fichiers concernés uniquement
+
+```bash
+rg -n -P '^\s*(//|#|<!--|--|/\*)\s*version\s*:\s*[0-9]+'   -g '!target/**'   -g '!node_modules/**'   -g '!dist/**'   -g '!idls/**/*.json'   . | rg -v -P 'version\s*:\s*1\s*(-->|\*/)?\s*$' | cut -d: -f1 | sort -u
+```
+
+## Fichiers commentables sans ligne `version`
+
+```bash
+find .   -path './target' -prune -o   -path './node_modules' -prune -o   -path './dist' -prune -o   -path './idls' -prune -o   -type f   \( -name '*.rs' -o -name '*.toml' -o -name '*.sql' -o -name '*.md' -o -name '*.ts' -o -name '*.js' -o -name '*.html' -o -name '*.scss' -o -name '*.sass' \)   -print | while read -r f; do
+    if ! head -n 5 "$f" | rg -q 'version\s*:'; then
+      echo "$f"
+    fi
+  done
+```