156 lines
5.0 KiB
Markdown
156 lines
5.0 KiB
Markdown
<!-- 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é.
|