0.0.2-alpha.4

docs/plans/002-V0_0_2_GIT_SYNC_PLAN.md

@@ -1,5 +1,5 @@
 <!-- file: docs/plans/002-V0_0_2_GIT_SYNC_PLAN.md -->
-<!-- version: 7 -->
+<!-- version: 8 -->
 
 # Plan 0.0.2 — Git générique et synchronisation de lecture
 
@@ -164,7 +164,7 @@ Si la surface « configuration + runner + mirror » ne peut plus être validée
 
 ### alpha.3 — refresh, résolution et snapshot réel
 
-Statut opérateur initial : **FAIL**.
+Statut initial : **FAIL**. `alpha.3.fix.1` : **PASS**. Tranche fermée.
 
 La tranche a matérialisé et prouvé sur de vrais repositories temporaires :
 
@@ -186,27 +186,29 @@ La revue de tranche a déclenché un REPLAN explicite : l'autonomie normative ap
 
 ### alpha.4 — autonomie normative et structure interne des crates
 
-Finaliser l'adoption PGR `v0.1.3` comme migration ponctuelle, sans transformer PGR en dépendance documentaire permanente :
+Finaliser l'adoption PGR `v0.1.3` comme migration ponctuelle et rendre Knowledge autonome pour les sessions suivantes.
 
-- inventorier les owners/contrats PGR réellement retenus par Knowledge ;
-- produire un mapping durable `ADOPT / KEEP-LOCAL / OVERRIDE / DEFER` fondé sur la baseline locale actuelle ;
-- pour chaque `ADOPT`, identifier l'owner local qui possède effectivement le contrat ;
-- adapter et matérialiser localement uniquement les règles, templates/configurations et audits nécessaires au développement de Knowledge ;
-- ne pas recopier mécaniquement l'arborescence ou les textes PGR lorsque `RULES.md` ou un owner local plus adapté suffit ;
-- faire de PGR `v0.1.3` une provenance d'adoption figée, et non une « baseline courante » à recharger ;
-- établir que les futurs prompts de démarrage partent de la baseline Knowledge locale et ne demandent une consultation PGR que si une réévaluation PGR est explicitement dans leur scope ;
-- vérifier que les règles de gouvernance, workflow, documentation, validation, Rust/Cargo et Web réellement nécessaires sont compréhensibles et applicables depuis le dépôt Knowledge seul.
+Scope :
 
-La même tranche audite l'organisation interne des crates :
+- matérialiser six owners locaux : gouvernance, workflow, documentation, validation, Rust/Cargo et frontend Web, avec les contrats opérationnels réellement nécessaires (lifecycle/versioning, fixes/REPLAN, delta/history/handoff, rôles documentaires et catégories de preuve) ;
+- produire `docs/architecture/003-PGR_ADOPTION_MAP.md` avec le mapping `ADOPT / KEEP-LOCAL / OVERRIDE / DEFER` et les owners Knowledge réels ;
+- conserver PGR `v0.1.3` uniquement comme provenance de l'adoption ;
+- fournir des templates locaux de nouvelle session, plan de release, handoff opérateur et crate bibliothèque ;
+- adopter localement les audits Markdown headers/liens/tables utiles au dépôt ;
+- ajouter un audit Knowledge garantissant que les `src/lib.rs` des crates bibliothèque restent des façades ;
+- réorganiser `knowledge-git-api` en modules `reference`, `revision`, `snapshot`, `repository` sans modifier son API crate-root ;
+- réorganiser `knowledge-sync-api` en modules `signal` et `event_source` sans modifier son API crate-root ;
+- auditer les autres crates et ne pas les découper davantage lorsqu'elles respectent déjà le contrat de façade ;
+- conserver inchangée la sémantique Git prouvée par `alpha.3`.
 
-- `lib.rs` reste la façade publique/documentation de crate ;
-- les types, traits et implémentations sont déplacés vers des modules nommés selon leur responsabilité lorsqu'ils forment une responsabilité distincte ;
-- les crates `knowledge-git-api` et `knowledge-sync-api` sont examinées en priorité ;
-- `api.rs` n'est pas imposé comme nom générique : préférer des modules tels que `reference`, `revision`, `snapshot`, `repository`, `signal` ou autre ownership réel ;
-- les petites crates/fichiers ne sont pas découpés artificiellement uniquement pour satisfaire une forme ;
-- les réexports publics restent centralisés à la crate root et les consommateurs externes continuent d'utiliser la façade stable.
+Hors scope :
 
-Cette tranche ne change pas la sémantique Git prouvée par `alpha.3` et ne matérialise pas encore le cas d'usage `Changed` / `Unchanged`.
+- aucune consultation d'une version PGR postérieure à `v0.1.3` ;
+- aucune copie mécanique de tous les owners/skeletons/templates PGR ;
+- aucun changement de comportement Git, forge, PostgreSQL, auth/admin ou Web runtime ;
+- aucun `knowledge-app-lib` ni cas d'usage `Changed` / `Unchanged` avant `alpha.5`.
+
+Gate attendue : audits Markdown locaux, audit d'autonomie, audits Rust incluant la façade crate-root, rustfmt/check/Clippy, tests ciblés des deux crates `-api` et `knowledge-git-lib`, puis tests workspace. `Web/` doit rester sans diff.
 
 ### alpha.5 — cas d'usage de synchronisation