# History 0.0.2-alpha.3 — refresh, résolution et snapshot Git réels ## Statut FAIL La gate opérateur de `0.0.2-alpha.3` exécutée le `2026-09-28` confirme le comportement fonctionnel du chemin Git réel, mais la tranche reste bloquée par trois défauts de conformité : hygiène Git, formatage rustfmt et documentation de la crate de test d'intégration sous Clippy strict. ## Baseline opérateur `alpha.2.fix.2` a été historisé `PASS`, committé et poussé avant application d'`alpha.3` : ```text history/0.0.2/alpha.2.fix.2.md PASS commit 3802526 message 0.0.2-alpha.2.fix.2 branch master push origin/master PASS workspace après push propre ``` Le push observé a avancé `origin/master` de `ffb4721` à `3802526`. ## Version et audit structurel Les contrôles initiaux passent : ```text VERSION 0.0.2-alpha.3 Cargo workspace version 0.0.2-alpha.3 history alpha.2.fix.2 PASS Knowledge 0.0.2-alpha.3 structural audit: clean ``` Les audits Rust structurels passent également : ```text Rust test-layout audit: clean (8 crate(s)) Rust blank-line audit: clean (23 file(s)) Rust item-spacing audit: clean (23 file(s)) Rust module-order audit: clean (23 file(s)) Rust trait-import-block audit: clean (23 file(s)) Rust re-export-block audit: clean (23 file(s)) Rust export completeness audit: 0 candidate(s) across 8 package(s) ``` ## Hygiène Git et formatage `git diff --check` échoue sur : ```text docs/validation/001-VALIDATION_MATRIX.md:639: new blank line at EOF. ``` `cargo fmt --all -- --check` échoue uniquement sur `crates/knowledge-git-api/unit_tests/lib.rs`, où rustfmt compacte l'assertion finale `GitSnapshot` sur une seule ligne. Ces deux défauts sont bloquants même si la compilation réussit ensuite. ## Compilation et Clippy `cargo metadata --format-version 1 --no-deps` et `cargo check --workspace` passent. Clippy strict échoue sur : ```text crates/knowledge-git-lib/tests/git_read_path.rs missing documentation for the crate -D missing-docs ``` Le test d'intégration constitue une crate Cargo indépendante ; il doit donc posséder une documentation de crate explicite compatible avec la politique `missing_docs` du workspace. ## Tests fonctionnels Git Le contrat provider-neutral compile et son test passe : ```text cargo test -p knowledge-git-api --all-targets --all-features 1 passed; 0 failed ``` `knowledge-git-lib` exécute huit tests unitaires et deux tests d'intégration avec de vrais repositories Git temporaires : ```text 8 unit tests PASS 2 integration tests PASS ``` Les preuves observées couvrent notamment : - enregistrement de source et rejet des doublons ; - refresh du mirror réel ; - résolution de `refs/heads/main` ; - matérialisation d'un snapshot par révision ; - second commit source puis nouvelle révision/snapshot ; - rejet d'une référence inexistante ; - rejet d'un snapshot existant rendu sale. Le test d'intégration ciblé `cargo test -p knowledge-git-lib --test git_read_path` passe également avec `2 passed; 0 failed`. Les tests workspace passent intégralement malgré le warning `missing_docs` non promu en erreur par `cargo test` : ```text knowledge-domain-lib : 3 PASS knowledge-git-api : 1 PASS knowledge-git-lib : 8 unit PASS + 2 integration PASS knowledge-sync-api : 1 PASS knowledge-web-lib : 4 PASS launchers : 0 test chacun ``` ## Métadonnées et frontières L'audit Cargo passe : ```text Knowledge 0.0.2-alpha.3 Cargo metadata audit: clean ``` Les contrôles de frontière passent : ```text Web/ sans diff crates/knowledge-sync-api sans diff crates/knowledge-app-lib absent crates/knowledge-forge-gitea-lib absent crates/knowledge-store-postgres-lib absent history/0.0.2/alpha.3.md absent avant clôture Cargo.lock présent localement, ignoré et non suivi ``` Le `git diff --cached --check` final échoue pour la même ligne vide terminale déjà signalée dans la matrice. La commande finale `git status --short` n'a pas été exécutée en raison d'une faute de frappe opérateur (`it status --short`), sans effet sur la décision déjà acquise. ## Replanification décidée Pendant la revue de la tranche, deux besoins structurels ont été confirmés sans remettre en cause les primitives Git d'`alpha.3` : 1. Knowledge doit devenir autonome après son adoption PGR : seules les règles réellement retenues doivent être adaptées et matérialisées localement ; PGR `v0.1.3` reste une provenance d'adoption et ne doit pas être rechargé automatiquement au début de chaque version, session ou tranche. 2. Les crates Rust doivent être auditées afin que `lib.rs` reste une façade de crate et que les définitions soient possédées par des modules nommés selon leur responsabilité lorsque la taille/structure le justifie, en particulier pour les crates `-api`. Ces sujets ne corrigent pas le comportement Git d'`alpha.3` et ne doivent donc pas être absorbés dans son implémentation. Le plan `0.0.2` est replanifié pour insérer une tranche `alpha.4` dédiée à cette autonomie normative et à l'organisation interne des crates ; l'ancien cas d'usage de synchronisation devient `alpha.5`. ## Diagnostic `alpha.3` est fonctionnellement probante mais ne satisfait pas la gate complète. Le correctif doit uniquement : - supprimer la ligne vide terminale fautive de la matrice ; - appliquer le formatage rustfmt attendu au test de `knowledge-git-api` ; - ajouter la documentation de crate requise au test d'intégration `git_read_path` ; - enregistrer explicitement le REPLAN `alpha.4` / `alpha.5` et la règle d'autonomie PGR ; - ne pas élargir le comportement Git déjà validé par les tests. ## Décision `0.0.2-alpha.3` est `FAIL`. La transition autorisée est : ```text appliquer ce history -> git add / diff --cached --check / status -> commit exact "0.0.2-alpha.3" -> push origin master -> vérifier le workspace propre -> appliquer seulement ensuite 0.0.2-alpha.3.fix.1 ```