0.0.4-alpha.2.fix.1

history/0.0.4/alpha.2.fix.1.md

@@ -0,0 +1,155 @@
+<!-- file: history/0.0.4/alpha.2.fix.1.md -->
+<!-- version: 1 -->
+
+# History 0.0.4-alpha.2.fix.1 — documentation de la crate de test PostgreSQL
+
+## Statut
+
+PASS
+
+La gate opérateur de `0.0.4-alpha.2.fix.1` exécutée le `2026-10-01` est complète et propre. Le fix corrige uniquement le lint `missing_docs` observé sur la target d'intégration PostgreSQL de `alpha.2`, sans modifier le code produit, le schéma SQL, les dépendances ni la façade publique.
+
+## Baseline opérateur
+
+`alpha.2` historisée `FAIL` a été committée puis poussée avant application du fix :
+
+```text
+history/0.0.4/alpha.2.md  FAIL
+commit                     095ac37
+message                    0.0.4-alpha.2
+branch                     master
+push                       origin/master PASS
+```
+
+La première tentative de `git push origin master` a été interrompue pendant la saisie d'identifiants. La seconde a réussi et a avancé `origin/master` de `b55eb23` à `095ac37`.
+
+## Correction bornée
+
+Les contrôles initiaux confirment :
+
+```text
+VERSION                                  0.0.4-alpha.2.fix.1
+Cargo workspace version                  0.0.4-alpha.2.fix.1
+history/0.0.4/alpha.2.md                 présent, suivi, FAIL
+history/0.0.4/alpha.2.fix.1.md avant gate absent
+documentation de crate //!               présente
+git diff --check                         PASS
+scope négatif                            PASS
+```
+
+Le plan actif conserve explicitement `alpha.2 = FAIL` et n'autorise `alpha.3` qu'après `PASS` complet du présent fix.
+
+Aucun diff n'est observé sous :
+
+```text
+crates/knowledge-store-postgres-lib/src/
+crates/knowledge-store-postgres-lib/unit_tests/
+crates/knowledge-store-postgres-lib/migrations/
+crates/knowledge-store-postgres-lib/Cargo.toml
+README.md
+RULES.md
+ROADMAP.md
+CHANGELOG.md
+docs/architecture/
+docs/studies/
+docs/validation/
+Web/
+prompts/
+```
+
+## Markdown, formatage et audits Rust
+
+```text
+Markdown header audit                  clean (132 file(s))
+Markdown link audit                    clean (86 local link(s), 132 file(s))
+Markdown table audit                   clean (5 table(s), 132 file(s))
+cargo fmt --all                        PASS
+cargo fmt --all -- --check             PASS
+Rust test-layout audit                 clean (10 crate(s))
+Rust blank-line audit                  clean (42 file(s))
+Rust item-spacing audit                clean (42 file(s))
+Rust module-order audit                clean (42 file(s))
+Rust trait-import-block audit          clean (42 file(s))
+Rust re-export-block audit             clean (42 file(s))
+Rust crate-root facade audit           clean (7 crate root(s))
+Rust export completeness audit         0 candidate(s) across 10 package(s)
+```
+
+## Cargo, Clippy et tests
+
+```text
+cargo metadata --format-version 1 --no-deps   PASS
+cargo check --workspace                       PASS
+cargo clippy --workspace --all-targets
+  --all-features -- -D warnings               PASS
+workspace_members                              10
+```
+
+Le défaut `missing_docs` de `alpha.2` est donc fermé par Clippy strict.
+
+Tests ciblés de la crate PostgreSQL :
+
+```text
+config unit tests                    3 PASS
+postgres_migration                   1 ignored, gate explicite requise
+doc-tests                            0
+```
+
+Tests workspace :
+
+```text
+knowledge-app-lib                 3 PASS
+knowledge-domain-lib              3 PASS
+knowledge-git-api                 7 PASS
+knowledge-git-lib                 8 unit + 6 integration PASS
+knowledge-sync-api                1 PASS
+knowledge-web-lib                 4 PASS
+knowledge-store-postgres-lib      3 PASS + 1 intégration ignorée
+launchers                         0 test chacun
+```
+
+Aucun warning `missing_docs` n'est observé pendant ces commandes.
+
+## Preuve PostgreSQL réelle
+
+La précondition opérateur `KNOWLEDGE_POSTGRES_TEST_URL` est présente pendant la gate du fix.
+
+La commande obligatoire :
+
+```text
+cargo test -p knowledge-store-postgres-lib --test postgres_migration -- --ignored --nocapture
+```
+
+produit :
+
+```text
+initial_migration_runs_in_isolated_schema   PASS
+1 passed; 0 failed
+```
+
+La migration initiale, le schéma temporaire isolé et son nettoyage restent donc prouvés sur PostgreSQL réel après la correction documentaire.
+
+## Hygiène et lockfiles
+
+```text
+Knowledge 0.0.4-alpha.2.fix.1 text hygiene   clean (187 file(s))
+Cargo.lock                                    présent localement, ignoré, non suivi
+Web package-lock.json                         présent et inchangé
+git diff --cached --check                    PASS
+```
+
+Le staging final observé avant ajout du présent history est exactement :
+
+```text
+M  Cargo.toml
+M  VERSION
+M  crates/knowledge-store-postgres-lib/tests/postgres_migration.rs
+A  deltas/0.0.4/alpha.2.fix.1.md
+M  docs/plans/004-V0_0_4_POSTGRES_FOUNDATION_PLAN.md
+```
+
+## Décision
+
+`0.0.4-alpha.2.fix.1` est `PASS`.
+
+Le défaut de validation de `alpha.2` est fermé sans changement fonctionnel. `0.0.4-alpha.3` peut maintenant matérialiser la persistance minimale de configuration de source et d'état de synchronisation sur le schéma PostgreSQL déjà validé.