0.0.1-alpha.3.fix.3

deltas/0.0.1/alpha.3.fix.3.md

@@ -0,0 +1,192 @@
+<!-- file: deltas/0.0.1/alpha.3.fix.3.md -->
+<!-- version: 1 -->
+
+# Delta 0.0.1-alpha.3.fix.3 — hygiène Markdown de la matrice de validation
+
+## Base requise
+
+État `0.0.1-alpha.3.fix.2` committé et poussé après application du history :
+
+```text
+history/0.0.1/alpha.3.fix.2.md = FAIL
+```
+
+La version devient :
+
+```text
+0.0.1-alpha.3.fix.3
+```
+
+## Cause du troisième fix
+
+`alpha.3.fix.2` a corrigé la documentation publique de `ContentFamily`.
+
+Les preuves opérateur confirment :
+
+```text
+cargo check --workspace                                  PASS
+cargo clippy --workspace --all-targets --all-features    PASS
+knowledge-domain-lib tests                               3 PASS
+knowledge-git-api tests                                  1 PASS
+knowledge-sync-api tests                                 1 PASS
+Cargo metadata audit                                     PASS
+```
+
+La tranche reste néanmoins `FAIL` parce que :
+
+```text
+git diff --check
+```
+
+signale :
+
+```text
+docs/validation/001-VALIDATION_MATRIX.md:216: new blank line at EOF.
+```
+
+## Correctif
+
+Le présent fix supprime uniquement la ligne vide supplémentaire en fin de :
+
+```text
+docs/validation/001-VALIDATION_MATRIX.md
+```
+
+La matrice conserve une fin de ligne POSIX normale, sans ligne blanche supplémentaire.
+
+Le plan vivant enregistre le `FAIL` réel de `alpha.3.fix.2` et la transition vers `alpha.3.fix.3`.
+
+## Non-régression
+
+Le correctif ne modifie pas :
+
+- les quatre doc-comments de `ContentFamily` ;
+- `SourceId` ;
+- `GitRepository` ;
+- `RepositoryEventSource` ;
+- `RepositorySyncSignal` ;
+- les dépendances entre crates ;
+- le cadrage Web/Maud/Vite ;
+- les décisions PostgreSQL/forge.
+
+Aucun frontend, serveur Actix, adapter de forge, schéma PostgreSQL ou nouvelle crate n'est ajouté.
+
+## Fichiers remplacés
+
+```text
+VERSION
+Cargo.toml
+docs/plans/001-V0_0_1_FOUNDATION_PLAN.md
+docs/validation/001-VALIDATION_MATRIX.md
+```
+
+## Fichier ajouté
+
+```text
+deltas/0.0.1/alpha.3.fix.3.md
+```
+
+Aucun fichier n'est supprimé.
+
+## `Cargo.lock`
+
+Le delta ne préfabrique pas `Cargo.lock`.
+
+La version workspace passant à `0.0.1-alpha.3.fix.3`, Cargo peut mettre à jour le lockfile dans le workspace opérateur. Toute modification réelle reste versionnée.
+
+## Validation attendue
+
+Après application du history `alpha.3.fix.2 FAIL`, commit/push de `alpha.3.fix.2`, puis extraction du présent delta :
+
+```bash
+test "$(cat VERSION)" = "0.0.1-alpha.3.fix.3"
+
+git diff --check
+
+python3 - <<'PY'
+from pathlib import Path
+import tomllib
+
+with Path("Cargo.toml").open("rb") as handle:
+    manifest = tomllib.load(handle)
+
+assert manifest["workspace"]["package"]["version"] == "0.0.1-alpha.3.fix.3"
+
+matrix_path = Path("docs/validation/001-VALIDATION_MATRIX.md")
+matrix_bytes = matrix_path.read_bytes()
+
+assert matrix_bytes.endswith(b"\n")
+assert not matrix_bytes.endswith(b"\n\n")
+
+content = Path(
+    "crates/knowledge-domain-lib/src/content_family.rs"
+).read_text(encoding="utf-8")
+
+for variant in ("Pgr", "Howto", "Snippet", "ProjectLocal"):
+    marker = f"    {variant},"
+    index = content.index(marker)
+    prefix = content[:index].rstrip().splitlines()
+    assert prefix[-1].lstrip().startswith("///"), variant
+
+assert "allow(missing_docs)" not in content
+assert 'missing_docs = "warn"' in Path("Cargo.toml").read_text(encoding="utf-8")
+
+print("Knowledge 0.0.1-alpha.3.fix.3 structural audit: clean")
+PY
+
+cargo metadata --format-version 1 --no-deps     > /tmp/sasedev-knowledge-alpha3-fix3-metadata.json
+
+cargo fmt --all
+cargo fmt --all -- --check
+
+python3 -B scripts/audit_rust_blank_lines.py crates
+python3 -B scripts/audit_rust_item_spacing.py crates
+python3 -B scripts/audit_rust_module_order.py crates
+python3 -B scripts/audit_rust_trait_import_blocks.py crates
+python3 -B scripts/audit_rust_reexport_blocks.py crates
+python3 -B scripts/audit_rust_export_completeness.py --root .
+
+cargo check --workspace
+
+cargo clippy     --workspace     --all-targets     --all-features     --     -D warnings
+
+cargo test -p knowledge-domain-lib --all-targets --all-features
+cargo test -p knowledge-git-api --all-targets --all-features
+cargo test -p knowledge-sync-api --all-targets --all-features
+
+test -f Cargo.lock
+if git check-ignore -q Cargo.lock; then
+    echo 'Cargo.lock must remain versioned' >&2
+    exit 1
+fi
+
+python3 - <<'PY'
+import json
+from pathlib import Path
+
+metadata = json.loads(
+    Path("/tmp/sasedev-knowledge-alpha3-fix3-metadata.json").read_text(encoding="utf-8")
+)
+
+packages = {package["name"] for package in metadata["packages"]}
+assert packages == {
+    "knowledge-domain-lib",
+    "knowledge-git-api",
+    "knowledge-sync-api",
+}, packages
+
+for package in metadata["packages"]:
+    assert package["version"] == "0.0.1-alpha.3.fix.3", (
+        package["name"],
+        package["version"],
+    )
+
+print("Knowledge 0.0.1-alpha.3.fix.3 Cargo metadata audit: clean")
+PY
+
+git add -A
+git diff --cached --check
+git status --short
+```
+
+Ne pas committe `alpha.3.fix.3` avant production de son history à partir des résultats opérateur.