0.0.3-alpha.2

history/0.0.3/alpha.2.md

@@ -0,0 +1,142 @@
+<!-- file: history/0.0.3/alpha.2.md -->
+<!-- version: 1 -->
+
+# History 0.0.3-alpha.2 — contrat d'écriture Git provider-neutral
+
+## Statut
+
+PASS
+
+La gate opérateur de `0.0.3-alpha.2` exécutée le `2026-09-29` est complète et propre. Elle valide la frontière publique d'écriture Git provider-neutral et autorise `0.0.3-alpha.3` pour le worktree d'écriture isolé et la création réelle du commit candidat.
+
+## Baseline opérateur
+
+`alpha.1.fix.2` `PASS` a été historisé, committé et poussé avant application de `alpha.2` :
+
+```text
+history/0.0.3/alpha.1.fix.2.md  PASS
+commit                           3004e4b
+message                          0.0.3-alpha.1.fix.2
+branch                           master
+push                             origin/master PASS
+workspace après push             propre
+```
+
+Le push observé a avancé `origin/master` de `dd63e85` à `3004e4b`.
+
+## Version et documentation
+
+Les contrôles de version et Markdown passent :
+
+```text
+VERSION                         0.0.3-alpha.2
+Cargo workspace version         0.0.3-alpha.2
+git diff --check                PASS
+Markdown header audit           clean (106 file(s))
+Markdown link audit             clean (78 local link(s), 106 file(s))
+Markdown table audit            clean (4 table(s), 106 file(s))
+```
+
+## Formatage et audits Rust
+
+La séquence locale imposée a été respectée :
+
+```text
+cargo fmt --all                         PASS
+cargo fmt --all -- --check              PASS
+Rust test-layout audit                  clean (9 crate(s))
+Rust blank-line audit                   clean (33 file(s))
+Rust item-spacing audit                 clean (33 file(s))
+Rust module-order audit                 clean (33 file(s))
+Rust trait-import-block audit           clean (33 file(s))
+Rust re-export-block audit              clean (33 file(s))
+Rust crate-root facade audit            clean (6 crate root(s))
+Rust export completeness audit          0 candidate(s) across 9 package(s)
+```
+
+## Cargo, Clippy et tests
+
+Les neuf packages compilent en `0.0.3-alpha.2` et Clippy ne produit aucun warning avec `-D warnings`.
+
+```text
+cargo metadata --format-version 1 --no-deps                 PASS
+cargo check --workspace                                     PASS
+cargo clippy --workspace --all-targets --all-features
+    -- -D warnings                                          PASS
+cargo test -p knowledge-git-api --all-targets --all-features PASS (7)
+cargo test --workspace --all-targets --all-features         PASS
+```
+
+Tests workspace observés :
+
+```text
+knowledge-app-lib       3 PASS
+knowledge-domain-lib    3 PASS
+knowledge-git-api       7 PASS
+knowledge-git-lib       8 unit PASS + 2 integration PASS
+knowledge-sync-api      1 PASS
+knowledge-web-lib       4 PASS
+launchers                0 test chacun
+```
+
+Les sept tests `knowledge-git-api` valident notamment :
+
+- la séparation du contrat d'écriture du contrat de lecture ;
+- l'absence de dépendance à une forge ;
+- la validation des chemins de mutation et la protection de `.git` ;
+- l'identité de commit explicite ;
+- les branches bornées à `refs/heads/...` ;
+- les états distants absent/révision ;
+- le rejet des requêtes sans mutation, messages invalides et chemins dupliqués.
+
+## Audit spécifique d'écriture
+
+L'audit de tranche passe :
+
+```text
+Knowledge 0.0.3-alpha.2 write-contract audit: clean
+```
+
+Il confirme notamment :
+
+- la présence et le réexport des dix types/traits d'écriture attendus ;
+- `GitRepository` de lecture inchangé et sans méthodes `create_candidate` / `push_candidate` ;
+- la validation `refs/heads/...`, `ProtectedGitPath` et `DuplicateMutationPath` ;
+- l'absence de dépendances Actix, Tokio, forge, PostgreSQL ou ORM dans `knowledge-git-api` ;
+- `CHANGELOG.md` toujours sans section prématurée `0.0.3` ;
+- absence de history `alpha.2` avant staging ;
+- absence de crates Gitea/PostgreSQL et de migrations.
+
+## Hygiène et scope
+
+```text
+Knowledge 0.0.3-alpha.2 text hygiene: clean (106 file(s))
+```
+
+La gate confirme également :
+
+- aucun diff sous `crates/knowledge-git-lib`, `crates/knowledge-app-lib` ou `Web/` ;
+- `Cargo.lock` local présent, ignoré et non suivi ;
+- `Web/knowledge-template-lab/package-lock.json` présent ;
+- `git diff --cached --check` propre.
+
+Le staging final contient exactement les changements attendus de la tranche :
+
+```text
+M  Cargo.toml
+M  README.md
+M  VERSION
+M  crates/knowledge-git-api/src/lib.rs
+A  crates/knowledge-git-api/src/write.rs
+M  crates/knowledge-git-api/unit_tests/lib.rs
+A  deltas/0.0.3/alpha.2.md
+M  docs/architecture/002-KNOWLEDGE_ARCHITECTURE.md
+M  docs/plans/003-V0_0_3_GIT_WRITE_PLAN.md
+M  docs/validation/001-VALIDATION_MATRIX.md
+```
+
+## Décision
+
+`0.0.3-alpha.2` est `PASS`.
+
+La frontière provider-neutral est acquise. La tranche suivante peut implémenter dans `knowledge-git-lib` le worktree d'écriture isolé, les mutations confinées, l'identité explicite, la neutralisation des hooks/configurations pertinentes et la création d'une révision candidate vérifiée. Le push distant gardé reste réservé à `alpha.4`.