sasedev-knowledge/history/0.0.2/alpha.2.md

History 0.0.2-alpha.2 — contrats minimaux et backend process Git

Statut

FAIL

La gate opérateur de 0.0.2-alpha.2 exécutée le 2026-09-28 échoue avant validation fonctionnelle du nouveau backend Git.

Baseline opérateur

alpha.1.fix.1 a été historisé PASS, committé et poussé avant application d'alpha.2 :

history/0.0.2/alpha.1.fix.1.md  PASS
commit                           84c01eb
message                          0.0.2-alpha.1.fix.1
branch                           master
push                             origin/master PASS

Le push observé a avancé origin/master de ab1e5fd à 84c01eb.

Version et contrôles initiaux

Les contrôles de version passent :

VERSION                  0.0.2-alpha.2
Cargo workspace version  0.0.2-alpha.2
history alpha.1.fix.1     PASS

En revanche, l'hygiène Git échoue immédiatement :

git diff --check
    docs/validation/001-VALIDATION_MATRIX.md:574: new blank line at EOF.

Ce défaut est bloquant pour la tranche.

Audit structurel du delta

L'audit structurel embarqué échoue sur un fichier généré sous node_modules :

AssertionError: Web/knowledge-template-lab/node_modules/sync-child-process/README.md

Le défaut vient de la gate elle-même : elle parcourt récursivement tous les *.md du workspace et n'exclut que .git, alors que node_modules ne fait pas partie du corpus Markdown gouverné par Knowledge.

L'intention de contrôle des headers Markdown reste valide, mais la gate doit ignorer les arbres générés/non gouvernés tels que node_modules.

Audits Rust structurels

Les audits structurels passent :

Rust test-layout audit: clean (8 crate(s))
Rust blank-line audit: clean (22 file(s))
Rust item-spacing audit: clean (22 file(s))
Rust module-order audit: clean (22 file(s))
Rust trait-import-block audit: clean (22 file(s))
Rust re-export-block audit: clean (22 file(s))
Rust export completeness audit: 0 candidate(s) across 8 package(s)

Ils confirment la présence cohérente de la huitième crate, mais ne remplacent pas cargo fmt, la compilation, Clippy et les tests.

Formatage Rust

cargo fmt --all -- --check échoue sur les nouveaux fichiers de knowledge-git-lib.

Les écarts sont uniquement des différences de formatage rustfmt dans :

crates/knowledge-git-lib/src/backend.rs
crates/knowledge-git-lib/src/error.rs
crates/knowledge-git-lib/src/lib.rs
crates/knowledge-git-lib/unit_tests/backend.rs

La tranche n'est donc pas formatée conformément à la gate Rust du projet.

Compilation et tests

cargo metadata --format-version 1 --no-deps produit correctement les métadonnées attendues, mais cargo check --workspace échoue avec E0423 :

crates/knowledge-git-lib/src/backend.rs:126
return crate::GitSourceKey(value);

GitSourceKey est réexporté publiquement depuis crate, mais son champ tuple reste privé au module backend. La construction doit donc être effectuée depuis le module propriétaire, par exemple via crate::backend::GitSourceKey(value), ou par un constructeur privé équivalent.

Le même défaut bloque :

cargo check --workspace
cargo clippy --workspace --all-targets --all-features -- -D warnings
cargo test -p knowledge-git-lib --all-targets --all-features
cargo test --workspace --all-targets --all-features

Aucun résultat de test knowledge-git-lib n'est donc présenté comme exécuté avec succès.

Métadonnées et limites de scope

L'audit des métadonnées Cargo passe :

Knowledge 0.0.2-alpha.2 Cargo metadata audit: clean

Il confirme huit packages exactement, dont knowledge-git-lib.

Les contrôles de frontière passent également :

Web/                                      sans diff
crates/knowledge-git-api                  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
Cargo.lock                                ignoré et non suivi

Le git status --short final n'a pas été exécuté à cause d'une faute de frappe opérateur (it status --short). Cette faute de frappe n'influence pas la décision : git diff --cached --check venait déjà d'échouer sur la ligne vide finale de la matrice de validation.

Diagnostic

alpha.2 reste dans son scope prévu ; aucun REPLAN n'est nécessaire.

Le correctif doit uniquement :

• supprimer la ligne vide terminale fautive de la matrice de validation ;
• corriger la gate Markdown pour exclure les arbres générés/non gouvernés ;
• appliquer le formatage rustfmt attendu aux quatre fichiers Rust signalés ;
• corriger la construction privée de GitSourceKey sans élargir l'API publique ;
• conserver inchangés le scope, les dépendances et les responsabilités du backend ;
• ne pas introduire refresh, résolution de révision ou snapshot fonctionnel avant alpha.3.

Décision

0.0.2-alpha.2 est FAIL.

La transition autorisée est :

appliquer ce history
-> git add / diff --cached --check / status
-> commit exact "0.0.2-alpha.2"
-> push origin master
-> vérifier le workspace propre
-> appliquer seulement ensuite 0.0.2-alpha.2.fix.1