194 lines
5.5 KiB
Markdown
194 lines
5.5 KiB
Markdown
<!-- 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
|
|
```
|