# Profil du projet Knowledge ## Baseline autoritaire La stable produit depuis laquelle `0.0.2` est ouverte est : ```text Knowledge stable tag v0.0.1 Knowledge stable commit 98ec46fe73bd50dacbe6be220650d87dd2000b74 Knowledge archive SHA-256 1f0b2cfaecee1cbee621abb9c3c95811773ebfc17c374c4369fdc220bcf7d72d Knowledge publish report sasedev-knowledge-0.0.1-publish.001-report.md = PASS Knowledge start prompt prompts/002-V0_0_2_START_PROMPT.md ``` La fondation `0.0.1` a été construite sous PGR `v0.1.1`. Cette identité reste historique dans les artefacts `0.0.1`. Le démarrage explicite de `0.0.2` a réévalué PGR et a retenu la stable suivante comme source d'adoption : ```text PGR stable tag v0.1.3 PGR stable commit fe80dbbb737390a7ea99df27d979bd59ccfb86e3 PGR archive SHA-256 f3a7dffd5fe0fd3542e6b5207fda0b94bca2bd05bd5a54542d0a08d635a5d6ee PGR publish report pgr-0.1.3-publish.001-report.md = PASS ``` Cette référence est une provenance d'adoption figée. Après matérialisation des contrats retenus, la baseline normative de Knowledge est constituée des artefacts locaux du dépôt Knowledge. Une version ou session future ne consulte pas automatiquement le PGR courant ; une nouvelle comparaison PGR exige une réévaluation explicitement engagée. `0.0.2-alpha.4` matérialise les owners locaux nécessaires et ferme cette adoption comme migration ponctuelle. Le mapping durable est [`003-PGR_ADOPTION_MAP.md`](003-PGR_ADOPTION_MAP.md). L'archive PGR `v0.1.3` vérifiée possède `VERSION = 0.1.3`, `332` entrées ZIP, `290` fichiers, `42` répertoires, une racine unique `pgr/`, aucun symlink et aucun `.git`. Son rapport post-tag indique `48/48` tests Python et les audits Markdown propres. Cette prévalidation ne remplace aucune gate opérateur Knowledge. ## Nature de l'adoption Knowledge n'est plus un nouveau dépôt à instancier : `0.0.2-alpha.1` migre un projet existant de la baseline PGR `v0.1.1` vers `v0.1.3`. L'owner PGR `230-ADOPTION` devient applicable à cette migration ; son contrat est instancié localement par les décisions suivantes : - partir d'une baseline autoritaire observée ; - sélectionner uniquement les owners réellement applicables ; - classifier `ADOPT / KEEP-LOCAL / OVERRIDE / DEFER` ; - préserver les décisions locales compatibles ; - ne pas réécrire les commits, deltas, histories ou documents historiques pour simuler une conformité rétroactive ; - valider proportionnellement la migration. Les classifications locales restent : - `ADOPT` — contrat PGR applicable retenu ; - `KEEP-LOCAL` — choix propre à Knowledge, compatible et non possédé par un owner PGR plus spécifique ; - `OVERRIDE` — règle PGR applicable remplacée ou raffinée localement avec justification ; - `DEFER` — choix volontairement reporté avec condition de reprise. ## Owners locaux après adoption Les responsabilités quotidiennes sont désormais possédées par : ```text docs/rules/200-GOVERNANCE.md docs/rules/210-WORKFLOW.md docs/rules/300-DOCUMENTATION.md docs/rules/400-VALIDATION.md docs/rules/510-RUST_CARGO.md docs/rules/530-WEB_FRONTEND.md ``` Le détail de la migration depuis les owners PGR `v0.1.3`, y compris les décisions `KEEP-LOCAL`, les éléments non applicables et les skeletons uniquement historiques, est conservé dans [`003-PGR_ADOPTION_MAP.md`](003-PGR_ADOPTION_MAP.md). Aucun de ces owners locaux ne nécessite de consulter PGR pour être interprété. ## Matrice des décisions importantes | Décision | Classification | Contrat retenu / condition de reprise | |----------------------------------------|-------------------------------|------------------------------------------------------------------------------------------------------------------| | Dépôt applicatif | `KEEP-LOCAL` | `sasedev-knowledge` ; workspace unique de la plateforme | | Nom court / préfixe crates | `KEEP-LOCAL` | `knowledge` / `knowledge-` | | Dépôt normatif | `KEEP-LOCAL` | dépôt existant `pgr`, jamais fusionné dans le dépôt applicatif | | Dépôt HOWTO | `KEEP-LOCAL` | dépôt séparé `howtos` | | Dépôt snippets | `KEEP-LOCAL` | dépôt séparé `snippets` | | Nombre de sources Git | `KEEP-LOCAL` | au moins trois sources initiales, sans limite codée à trois | | Git comme backend du contenu | `KEEP-LOCAL` | invariant d'architecture Knowledge | | Implémentation Git de `0.0.2` | `KEEP-LOCAL` | processus `git` contrôlé derrière `knowledge-git-api` ; décision réévaluable derrière le contrat | | Configuration physique Git | `KEEP-LOCAL` | `knowledge-git-lib` matérialisée en `0.0.2-alpha.2` ; source locale/remote + racine d'état ; pas dans le domaine | | Copies Git générées | `KEEP-LOCAL` | racine d'état explicite hors dépôt source, mirrors et snapshots adressés par clé sûre/révision | | Partage du cache Git entre processus | `DEFER` | état root exclusif à une instance backend en `0.0.2` ; reprendre avec verrouillage inter-processus réel | | Forge | `KEEP-LOCAL` | capacité optionnelle derrière adapter ; aucune API de forge dans le domaine | | Gitea | `DEFER` | premier adapter candidat ; reprendre lorsque des capacités forge-only sont implémentées | | Synchronisation sans webhook | `KEEP-LOCAL` | explicite/périodique convergent vers le même cas d'usage ; hooks/webhooks restent accélérateurs | | Scheduler périodique concret | `DEFER` | créer seulement lorsque son owner runtime/lifecycle est démontré | | Dernière révision observée en `0.0.2` | `KEEP-LOCAL` | fournie par l'appelant et retournée par le cas d'usage ; pas de pseudo-persistance locale | | PostgreSQL | `KEEP-LOCAL` | une base logique partagée future pour état transversal/projections ; jamais vérité du contenu Git publié | | Rust stable / édition 2024 | `ADOPT` | owner local `docs/rules/510-RUST_CARGO.md` | | Workspace Cargo | `ADOPT` | configuration locale + owner `510-RUST_CARGO.md` | | `Cargo.lock` | `KEEP-LOCAL` | généré localement et ignoré ; manifests Cargo versionnés | | Actix Web | `KEEP-LOCAL` | trois launchers existants et composition partagée dans `knowledge-web-lib` | | Maud | `KEEP-LOCAL` | rendu SSR commun dans `knowledge-web-lib` | | TypeScript | `ADOPT` | owner local `docs/rules/530-WEB_FRONTEND.md` | | Package manager frontend | `KEEP-LOCAL` | npm ; `package-lock.json` versionné | | Vite | `KEEP-LOCAL` + contrat adopté | owner local Web ; build/preview de références et manifest consommé par Maud | | Sass | `KEEP-LOCAL` + contrat adopté | owner local Web ; styles source et assets réellement servis | | Bootstrap | `KEEP-LOCAL` | framework CSS local Knowledge, jamais règle PGR universelle | | Racine frontend | `KEEP-LOCAL` | package partagé `Web/knowledge-template-lab/` | | Templates statiques Web | `KEEP-LOCAL` | harness de conception/validation ; rendu runtime Maud | | Intégration manifest Vite / Maud | `KEEP-LOCAL` | matérialisée dans `knowledge-web-lib` | | Driver/ORM PostgreSQL | `DEFER` | reprendre à la première implémentation persistante réelle | | Migrations PostgreSQL | `DEFER` | reprendre avec le premier schéma réel | | Moteur de recherche | `DEFER` | commencer par capacités PostgreSQL/index applicatif lorsque ce scope sera engagé | | Fournisseur d'auth externe | `DEFER` | reprendre lorsque le workflow utilisateur l'exige | | Surface admin par application | `KEEP-LOCAL` | chaque serveur protège ses opérations privilégiées ; URL exacte différée | | Quatrième application d'administration | `DEFER` | agréger seulement si une responsabilité transverse apparaît | | Modèle rôles/capabilities | `DEFER` | reprendre avec les cas d'usage d'autorisation réels | | Formats finaux HOWTO/snippet | `DEFER` | définir avec corpus réel | | Autres noms de crates | `DEFER` | créer uniquement lorsque l'ownership est démontré | ## Nomenclature de crates Les packages matérialisés sont : ```text knowledge-domain-lib types métier stables de famille/source knowledge-git-api contrat passif GitRepository provider-neutral knowledge-git-lib implémentation Git générique + mirror/refresh/resolve/snapshot + état local contrôlé knowledge-sync-api contrat passif RepositoryEventSource knowledge-web-lib composition Actix/Maud/Vite partagée knowledge-pgr-server launcher PGR mince knowledge-howtos-server launcher HOWTOs mince knowledge-snippets-server launcher snippets mince ``` `knowledge-git-lib` devient réelle en `0.0.2-alpha.2` puis implémente le chemin de lecture Git dans `alpha.3`. `knowledge-app-lib` reste seulement l'owner candidat du cas d'usage de synchronisation partagé et ne sera matérialisée que si l'orchestration réelle démontre cette responsabilité. Les responsabilités suivantes restent candidates et non matérialisées : ```text knowledge-store-postgres-lib état applicatif PostgreSQL partagé knowledge-forge-gitea-lib adapter Gitea optionnel knowledge-logging-lib diagnostics partagés, seulement sur besoin multi-runtime réel ``` Règles de création : - ne pas créer une crate uniquement pour refléter un diagramme ; - ne pas utiliser `-api` sans frontière de contrat indépendante réellement nécessaire ; - garder le domaine indépendant d'Actix, Gitea, Git process et PostgreSQL ; - garder les adapters/implémentations dépendants des contrats, jamais l'inverse ; - ne pas dupliquer dans les trois serveurs une logique qui possède clairement un owner commun ; - ne pas créer un service réseau supplémentaire lorsqu'une crate partagée suffit. ## Corpus auth/admin étudié en 0.0.1 Les archives historiques `actix-auth-app-master.zip` et `amahil-project-master.zip` restent des sources d'inspiration non autoritaires. Leur analyse est conservée dans [`../studies/001-AUTH_ADMIN_CORPUS_STUDY.md`](../studies/001-AUTH_ADMIN_CORPUS_STUDY.md). Elles justifient de conserver séparées l'identité/authentification partagée, l'autorisation privilégiée propre à chaque application et une éventuelle façade transverse ultérieure. Elles ne justifient toujours pas de créer une crate auth, de figer `/admin` ou `/login`, ni d'adopter OAuth2/OIDC/MFA pendant `0.0.2`. ## Résultat de l'adoption PGR 0.1.3 `0.0.2-alpha.4` ferme l'adoption comme migration ponctuelle : - les owners nécessaires sont adaptés et possédés localement ; - les règles Web externes applicables sont consolidées en un owner Knowledge plutôt que copiées en quatre documents ; - les skeletons restent une provenance d'instanciation, pas des dépendances normatives ; - les scripts génériques utiles sont sélectionnés localement et les variantes locales restent autoritaires ; - les futurs prompts de session repartent de Knowledge seul ; - une nouvelle stable PGR n'a aucun effet tant qu'une réévaluation n'est pas explicitement planifiée ; - les artefacts historiques `0.0.1` et les tranches antérieures de `0.0.2` restent inchangés. ## Décisions à rouvrir La release `0.0.2` rouvre uniquement l'implémentation Git générique et la synchronisation réelle de lecture. Restent différés : adapter Gitea, PostgreSQL/migrations, moteur de recherche, auth/admin complète, quatrième application d'administration, modèle détaillé rôles/capabilities, formats finaux HOWTO/snippet, écriture/publication Git et partage concurrent de la même racine Git entre plusieurs processus. Un changement de scope produit, un besoin mesuré ou une contrainte d'exploitation peut déclencher un REPLAN ; il ne justifie pas un choix anticipé.