0.0.2-alpha.2.fix.1

This commit is contained in:
2026-09-28 16:25:25 +02:00
parent bdbd6a51a4
commit ffb47214af
10 changed files with 528 additions and 81 deletions

View File

@@ -0,0 +1,193 @@
<!-- file: history/0.0.2/alpha.2.fix.1.md -->
<!-- version: 1 -->
# History 0.0.2-alpha.2.fix.1 — correction de gate, formatage et construction interne
## Statut
FAIL
La gate opérateur de `0.0.2-alpha.2.fix.1` exécutée le `2026-09-28` corrige les défauts initiaux d'`alpha.2`, mais reste bloquée par une violation Clippy unique dans un test de `knowledge-git-lib`.
## Baseline opérateur
`alpha.2` `FAIL` a été historisé, committé et poussé avant application du fix :
```text
history/0.0.2/alpha.2.md FAIL
commit bdbd6a5
message 0.0.2-alpha.2
branch master
push origin/master PASS
workspace après push propre
```
Le push observé a avancé `origin/master` de `84c01eb` à `bdbd6a5`.
## Version et prérequis
Les contrôles passent :
```text
VERSION 0.0.2-alpha.2.fix.1
Cargo workspace version 0.0.2-alpha.2.fix.1
history alpha.2 FAIL
```
`git diff --check` est propre.
## Audit structurel et documentaire
L'audit corrigé passe :
```text
Knowledge 0.0.2-alpha.2.fix.1 structural audit: clean (61 Markdown file(s))
```
Il confirme notamment :
- la présence des artefacts attendus de `knowledge-git-lib` ;
- huit membres workspace avec dépendances minimales inchangées ;
- `GitSourceKey` construit via `Self(value)` tout en conservant son champ tuple privé ;
- le runner process sans shell, les protections d'environnement Git et les arguments `--mirror` / `--no-local` ;
- l'absence de `refresh`, `resolve_revision`, worktree/snapshot et `knowledge-app-lib` ;
- l'exclusion de `.git`, `node_modules`, `target` et `builds` de l'audit Markdown gouverné.
Les audits Rust structurels passent :
```text
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)
```
## Formatage et compilation
Les contrôles suivants passent :
```text
cargo fmt --all -- --check PASS
cargo metadata --format-version 1 --no-deps PASS
cargo check --workspace PASS
```
La compilation du workspace est donc restaurée par rapport à `alpha.2`.
## Clippy
La gate reste `FAIL` sur :
```text
cargo clippy --workspace --all-targets --all-features -- -D warnings
```
Erreur observée :
```text
crates/knowledge-git-lib/unit_tests/backend.rs:85
missing `return` statement
clippy::implicit_return
```
La closure passée à `Iterator::all` retourne implicitement son expression booléenne :
```text
|character| character.is_ascii_alphanumeric() || character == '-'
```
La configuration workspace interdit explicitement `clippy::implicit_return`. Le correctif attendu est uniquement de rendre ce retour explicite dans la closure.
## Tests
Malgré l'échec Clippy, les tests ciblés passent :
```text
cargo test -p knowledge-git-lib --all-targets --all-features
7 passed; 0 failed
```
Tests observés :
```text
backend_configuration_requires_non_empty_paths PASS
local_source_clone_uses_mirror_no_local_and_argument_separator PASS
invalid_existing_mirror_is_rejected_without_deleting_it PASS
existing_mirror_is_inspected_without_clone PASS
source_key_never_interpolates_raw_source_identifier_as_a_path PASS
process_errors_do_not_expose_remote_location_or_credentials PASS
remote_source_clone_does_not_add_no_local PASS
```
Les tests workspace passent également :
```text
knowledge-domain-lib : 3 PASS
knowledge-git-api : 1 PASS
knowledge-git-lib : 7 PASS
knowledge-sync-api : 1 PASS
knowledge-web-lib : 4 PASS
launchers : 0 test chacun
```
## Métadonnées, lockfile et frontières
L'audit Cargo passe :
```text
Knowledge 0.0.2-alpha.2.fix.1 Cargo metadata audit: clean
```
Les contrôles de frontière passent :
```text
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 présent localement, ignoré et non suivi
```
Après staging, `git diff --cached --check` passe. Le staging observé avant ajout du présent history est :
```text
M Cargo.toml
M VERSION
M crates/knowledge-git-lib/src/backend.rs
M crates/knowledge-git-lib/src/error.rs
M crates/knowledge-git-lib/src/lib.rs
M crates/knowledge-git-lib/unit_tests/backend.rs
A deltas/0.0.2/alpha.2.fix.1.md
M docs/plans/002-V0_0_2_GIT_SYNC_PLAN.md
M docs/validation/001-VALIDATION_MATRIX.md
```
## Diagnostic
`alpha.2.fix.1` reste dans le scope prévu et restaure l'hygiène, le formatage et la compilation. Aucun déclencheur de REPLAN n'est atteint.
Le nouveau fix doit uniquement :
- rendre explicite le retour de la closure signalée par Clippy dans `unit_tests/backend.rs` ;
- conserver l'API, les dépendances et le comportement Git inchangés ;
- rejouer la gate complète d'`alpha.2` afin de confirmer qu'aucun autre warning Clippy n'est masqué.
## Décision
`0.0.2-alpha.2.fix.1` est `FAIL`.
La transition autorisée est :
```text
appliquer ce history
-> git add / diff --cached --check / status
-> commit exact "0.0.2-alpha.2.fix.1"
-> push origin master
-> vérifier le workspace propre
-> appliquer seulement ensuite 0.0.2-alpha.2.fix.2
```