[skip ci] chore(sync): maj hooks 4NK_template

2025-08-28 15:01:43 +00:00 · 2025-08-28 15:01:43 +00:00 · 81fe7c10ba
commit 81fe7c10ba
parent bfb3e9c4ee
57 changed files with 3943 additions and 0 deletions
--- a/.cursor/.cursorignore
+++ b/.cursor/.cursorignore
@ -0,0 +1,11 @@
+# Ignorer les sorties volumineuses ou non pertinentes pour le contexte IA
+archive/**
+tests/logs/**
+tests/reports/**
+node_modules/**
+dist/**
+build/**
+.tmp/**
+.cache/**#
+.env
+.env.*
--- a/.cursor/rules/00-foundations.mdc
+++ b/.cursor/rules/00-foundations.mdc
@ -0,0 +1,32 @@
+---
+alwaysApply: true
+---
+
+# Fondations de rédaction et de comportement
+
+[portée]
+S’applique à tout le dépôt 4NK/4NK_node pour toute génération, refactorisation, édition inline ou discussion dans Cursor.
+
+[objectifs]
+
+- Garantir l’usage exclusif du français.
+- Proscrire l’injection d’exemples de code applicatif dans la base de code.
+- Assurer une cohérence stricte de terminologie et de ton.
+- Exiger une introduction et/ou une conclusion dans toute proposition de texte.
+
+[directives]
+
+- Toujours répondre et documenter en français.
+- Ne pas inclure d’exemples exécutables ou de quickstarts dans la base ; préférer des descriptions prescriptives.
+- Tout contenu produit doit mentionner explicitement les artefacts à mettre à jour lorsqu’il impacte docs/ et tests/.
+- Préserver la typographie française (capitaliser uniquement le premier mot d’un titre et les noms propres).
+
+[validations]
+
+- Relecture linguistique et technique systématique.
+- Refuser toute sortie avec exemples de code applicatif.
+- Vérifier que l’issue traitée se conclut par un rappel des fichiers à mettre à jour.
+
+[artefacts concernés]
+
+- README.md, docs/**, tests/**, CHANGELOG.md, .gitea/**.
--- a/.cursor/rules/05-template-governance.mdc
+++ b/.cursor/rules/05-template-governance.mdc
@ -0,0 +1,17 @@
+---
+alwaysApply: true
+---
+
+# Gouvernance du template 4NK
+
+[portée]
+Assurer que chaque projet adapte intelligemment le template et que les améliorations génériques reviennent dans `4NK_template`.
+
+[directives]
+- Conserver `security-audit` et `release-guard` dans tous projets.
+- Adapter la CI, les docs et `AGENTS.md` au contexte local.
+- En cas d'amélioration générique : ouvrir une issue "Template Feedback", prototyper, valider CI, mettre à jour `CHANGELOG.md`/`TEMPLATE_VERSION`.
+
+[validation]
+- Refuser un push/tag si l'adaptation a retiré les vérifications minimales (sécurité, tests, build, version/changelog/tag).
+- Exiger une documentation claire dans `docs/TEMPLATE_ADAPTATION.md` et `docs/TEMPLATE_FEEDBACK.md`.
--- a/.cursor/rules/10-project-structure.mdc
+++ b/.cursor/rules/10-project-structure.mdc
@ -0,0 +1,72 @@
+---
+alwaysApply: true
+---
+
+# Structure projet 4NK_node
+
+[portée]
+Maintenance de l’arborescence canonique, création/mise à jour/suppression de fichiers et répertoires.
+
+[objectifs]
+
+- Garantir l’alignement strict avec l’arborescence 4NK_node.
+- Prévenir toute dérive structurelle.
+
+[directives]
+
+- S’assurer que l’arborescence suivante existe et reste conforme :
+
+  4NK/4NK_node
+  ├── archive
+  ├── CHANGELOG.md
+  ├── CODE_OF_CONDUCT.md
+  ├── CONTRIBUTING.md
+  ├── docker-compose.yml
+  ├── docs
+  │   ├── API.md
+  │   ├── ARCHITECTURE.md
+  │   ├── COMMUNITY_GUIDE.md
+  │   ├── CONFIGURATION.md
+  │   ├── GITEA_SETUP.md
+  │   ├── INDEX.md
+  │   ├── INSTALLATION.md
+  │   ├── MIGRATION.md
+  │   ├── OPEN_SOURCE_CHECKLIST.md
+  │   ├── QUICK_REFERENCE.md
+  │   ├── RELEASE_PLAN.md
+  │   ├── ROADMAP.md
+  │   ├── SECURITY_AUDIT.md
+  │   ├── TESTING.md
+  │   └── USAGE.md
+  ├── LICENSE
+  ├── README.md
+  ├── tests
+  │   ├── cleanup.sh
+  │   ├── connectivity
+  │   ├── external
+  │   ├── integration
+  │   ├── logs
+  │   ├── performance
+  │   ├── README.md
+  │   ├── reports
+  │   └── unit
+  └── .gitea
+      ├── ISSUE_TEMPLATE
+      │   ├── bug_report.md
+      │   └── feature_request.md
+      ├── PULL_REQUEST_TEMPLATE.md
+      └── workflows
+          └── ci.yml
+
+- Tout document obsolète est déplacé vers archive/ avec métadonnées (date, raison).
+- Interdire la suppression brute de fichiers sans archivage et note dans CHANGELOG.md.
+
+[validations]
+
+- Diff structurel comparé à cette référence.
+- Erreur bloquante si un fichier « requis » manque.
+
+[artefacts concernés]
+
+- archive/**, docs/**, tests/**, .gitea/**, CHANGELOG.md.
+
--- a/.cursor/rules/20-documentation.mdc
+++ b/.cursor/rules/20-documentation.mdc
@ -0,0 +1,33 @@
+---
+alwaysApply: true
+---
+
+# Documentation continue
+
+[portée]
+Mises à jour de docs/** corrélées à tout changement de code, configuration, dépendance, données ou CI.
+
+[objectifs]
+- Remplacer toute section générique « RESUME » par des mises à jour ciblées dans les fichiers appropriés.
+- Tenir INDEX.md comme table des matières de référence.
+
+[directives]
+- À chaque changement, mettre à jour :
+  - API.md (spécifications, contrats, schémas, invariants).
+  - ARCHITECTURE.md (décisions, diagrammes, couplages, performances).
+  - CONFIGURATION.md (paramètres, formats, valeurs par défaut).
+  - INSTALLATION.md (pré-requis, étapes, vérifications).
+  - MIGRATION.md (chemins de migration, scripts, compatibilités).
+  - USAGE.md (parcours fonctionnels, contraintes).
+  - TESTING.md (pyramide, critères d’acceptation).
+  - SECURITY_AUDIT.md (menaces, contrôles, dettes résiduelles).
+  - RELEASE_PLAN.md, ROADMAP.md (planification), OPEN_SOURCE_CHECKLIST.md, COMMUNITY_GUIDE.md, GITEA_SETUP.md.
+- Maintenir QUICK_REFERENCE.md pour les référentiels synthétiques utilisés par l’équipe.
+- Ajouter un REX technique en cas d’hypothèses multiples avant résolution dans archive/.
+
+[validations]
+- Cohérence croisée entre README.md et INDEX.md.
+- Refus si une modification de code n’a pas de trace dans docs/** correspondants.
+
+[artefacts concernés]
+- docs/**, README.md, archive/**.
--- a/.cursor/rules/30-testing.mdc
+++ b/.cursor/rules/30-testing.mdc
@ -0,0 +1,57 @@
+---
+alwaysApply: true
+---
+
+# Tests et qualité
+
+[portée]
+Stratégie de tests, exécution locale, stabilité, non-régression.
+
+[objectifs]
+
+- Exiger des tests verts avant tout commit.
+- Couvrir les axes unit, integration, connectivity, performance, external.
+
+[directives]
+
+- Ajouter/mettre à jour des tests dans tests/unit, tests/integration, tests/connectivity, tests/performance, tests/external selon l’impact.
+- Consigner les journaux dans tests/logs et les rapports dans tests/reports.
+- Maintenir tests/README.md (stratégie, outillage, seuils).
+- Fournir un nettoyage reproductible via tests/cleanup.sh.
+- Bloquer l’édition si des tests échouent tant que la correction n’est pas appliquée.
+
+[validations]
+
+- Refus d’un commit si tests en échec.
+- Exiger justification et plan de test dans docs/TESTING.md pour toute refonte majeure.
+
+[artefacts concernés]
+
+- tests/**, docs/TESTING.md, CHANGELOG.md.
+
+# Tests et qualité
+
+[portée]
+Stratégie de tests, exécution locale, stabilité, non-régression.
+
+[objectifs]
+
+- Exiger des tests verts avant tout commit.
+- Couvrir les axes unit, integration, connectivity, performance, external.
+
+[directives]
+
+- Ajouter/mettre à jour des tests dans tests/unit, tests/integration, tests/connectivity, tests/performance, tests/external selon l’impact.
+- Consigner les journaux dans tests/logs et les rapports dans tests/reports.
+- Maintenir tests/README.md (stratégie, outillage, seuils).
+- Fournir un nettoyage reproductible via tests/cleanup.sh.
+- Bloquer l’édition si des tests échouent tant que la correction n’est pas appliquée.
+
+[validations]
+
+- Refus d’un commit si tests en échec.
+- Exiger justification et plan de test dans docs/TESTING.md pour toute refonte majeure.
+
+[artefacts concernés]
+
+- tests/**, docs/TESTING.md, CHANGELOG.md.
--- a/.cursor/rules/40-dependencies-and-build.mdc
+++ b/.cursor/rules/40-dependencies-and-build.mdc
@ -0,0 +1,55 @@
+---
+alwaysApply: true
+---
+
+# Dépendances, compilation et build
+
+[portée]
+Gestion des dépendances, compilation fréquente, politique de versions.
+
+[objectifs]
+
+- Ajouter automatiquement les dépendances manquantes si justifié.
+- Rechercher systématiquement les dernières versions stables.
+
+[directives]
+
+- Lorsqu’une fonctionnalité nécessite une dépendance, l’ajouter et la documenter (nom, version, portée, impact) dans docs/ARCHITECTURE.md et docs/CONFIGURATION.md si nécessaire.
+- Compiler très régulièrement et « quand nécessaire » (avant refactor, avant push, après mise à jour de dépendances).
+- Corriger toute erreur de compilation/exécution avant de poursuivre.
+- Documenter tout changement de dépendances (raison, risques, rollback).
+
+[validations]
+
+- Interdire la progression si la compilation échoue.
+- Vérifier la présence d’une note de changement dans CHANGELOG.md en cas de dépendance ajoutée/retirée.
+
+[artefacts concernés]
+
+- docs/ARCHITECTURE.md, docs/CONFIGURATION.md, CHANGELOG.md.
+
+# Dépendances, compilation et build
+
+[portée]
+Gestion des dépendances, compilation fréquente, politique de versions.
+
+[objectifs]
+
+- Ajouter automatiquement les dépendances manquantes si justifié.
+- Rechercher systématiquement les dernières versions stables.
+
+[directives]
+
+- Lorsqu’une fonctionnalité nécessite une dépendance, l’ajouter et la documenter (nom, version, portée, impact) dans docs/ARCHITECTURE.md et docs/CONFIGURATION.md si nécessaire.
+- Compiler très régulièrement et « quand nécessaire » (avant refactor, avant push, après mise à jour de dépendances).
+- Corriger toute erreur de compilation/exécution avant de poursuivre.
+- Documenter tout changement de dépendances (raison, risques, rollback).
+
+[validations]
+
+- Interdire la progression si la compilation échoue.
+- Vérifier la présence d’une note de changement dans CHANGELOG.md en cas de dépendance ajoutée/retirée.
+
+[artefacts concernés]
+
+- docs/ARCHITECTURE.md, docs/CONFIGURATION.md, CHANGELOG.md.
--- a/.cursor/rules/41-ssh-automation.mdc
+++ b/.cursor/rules/41-ssh-automation.mdc
@ -0,0 +1,70 @@
+# Règles SSH & Automatisation — Flux local
+
+- Interdiction de secrets en clair; secrets via `~/.4nk_template/.env` ou variables CI
+- Scripts SSH conservés exécutables, journaux non sensibles
+- Le flux local prime: agents exécutés avant merge/push/release; CI neutralisable via `CI_SKIP=true` et `[skip ci]`
+---
+alwaysApply: true
+---
+
+# Automatisation SSH et scripts
+
+[portée]
+Création, usage et vérification du dossier scripts/ et de ses trois scripts standards liés aux opérations SSH et CI.
+
+[objectifs]
+
+- Garantir la présence de scripts/ avec auto-ssh-push.sh, init-ssh-env.sh, setup-ssh-ci.sh.
+- Encadrer l’usage de ces scripts (locaux et CI), la sécurité, l’idempotence et la traçabilité.
+- Documenter toute mise à jour dans docs/SSH_UPDATE.md et CHANGELOG.md.
+
+[directives]
+
+- Créer et maintenir `scripts/auto-ssh-push.sh`, `scripts/init-ssh-env.sh`, `scripts/setup-ssh-ci.sh`.
+- Exiger permissions d’exécution adaptées sur scripts/ (exécution locale et CI).
+- Interdire le stockage de clés privées ou secrets en clair dans le dépôt.
+- Utiliser des variables d’environnement et secrets CI pour toute donnée sensible.
+- Rendre chaque script idempotent et verbosable ; produire un code de sortie non-zéro en cas d’échec.
+- Tracer les opérations : consigner un résumé dans docs/SSH_UPDATE.md (objectif, variables requises, effets, points d’échec).
+- Ajouter un contrôle automatique dans la CI pour vérifier l’existence et l’exécutabilité de ces scripts.
+
+[validations]
+
+- Échec bloquant si un des trois scripts manque ou n’est pas exécutable.
+- Échec bloquant si docs/SSH_UPDATE.md n’est pas mis à jour lors d’une modification de scripts.
+- Échec bloquant si un secret attendu n’est pas fourni en CI.
+
+[artefacts concernés]
+
+- scripts/**, docs/SSH_UPDATE.md, .gitea/workflows/ci.yml, CHANGELOG.md, docs/CONFIGURATION.md.
+
+# Automatisation SSH et scripts
+
+[portée]
+Création, usage et vérification du dossier scripts/ et de ses trois scripts standards liés aux opérations SSH et CI.
+
+[objectifs]
+
+- Garantir la présence de scripts/ avec auto-ssh-push.sh, init-ssh-env.sh, setup-ssh-ci.sh.
+- Encadrer l’usage de ces scripts (locaux et CI), la sécurité, l’idempotence et la traçabilité.
+- Documenter toute mise à jour dans docs/SSH_UPDATE.md et CHANGELOG.md.
+
+[directives]
+
+- Créer et maintenir `scripts/auto-ssh-push.sh`, `scripts/init-ssh-env.sh`, `scripts/setup-ssh-ci.sh`.
+- Exiger permissions d’exécution adaptées sur scripts/ (exécution locale et CI).
+- Interdire le stockage de clés privées ou secrets en clair dans le dépôt.
+- Utiliser des variables d’environnement et secrets CI pour toute donnée sensible.
+- Rendre chaque script idempotent et verbosable ; produire un code de sortie non-zéro en cas d’échec.
+- Tracer les opérations : consigner un résumé dans docs/SSH_UPDATE.md (objectif, variables requises, effets, points d’échec).
+- Ajouter un contrôle automatique dans la CI pour vérifier l’existence et l’exécutabilité de ces scripts.
+
+[validations]
+
+- Échec bloquant si un des trois scripts manque ou n’est pas exécutable.
+- Échec bloquant si docs/SSH_UPDATE.md n’est pas mis à jour lors d’une modification de scripts.
+- Échec bloquant si un secret attendu n’est pas fourni en CI.
+
+[artefacts concernés]
+
+- scripts/**, docs/SSH_UPDATE.md, .gitea/workflows/ci.yml, CHANGELOG.md, docs/CONFIGURATION.md.
--- a/.cursor/rules/42-template-sync.mdc
+++ b/.cursor/rules/42-template-sync.mdc
@ -0,0 +1,59 @@
+---
+alwaysApply: true
+---
+
+# Synchronisation de template (4NK)
+
+[portée]
+Tous les projets issus de 4NK_project_template. Contrôle de l’alignement sur .cursor/, .gitea/, AGENTS.md, scripts/, docs/SSH_UPDATE.md.
+
+[objectifs]
+
+- Garantir l’absence de dérive sur les éléments normatifs.
+- Exiger la mise à jour documentaire et du changelog à chaque synchronisation.
+- Bloquer la progression en cas d’intégrité non conforme.
+
+[directives]
+- Lire la configuration de .4nk-sync.yml (source_repo, ref, paths, policy).
+- Refuser toute modification locale dans le périmètre des paths sans PR de synchronisation.
+- Après synchronisation : exiger mises à jour de CHANGELOG.md et docs/INDEX.md.
+- Scripts : vérifier présence, permissions d’exécution et absence de secrets en clair.
+- SSH : exiger mise à jour de docs/SSH_UPDATE.md si scripts/** modifié.
+
+[validations]
+- Erreur bloquante si manifest_checksum manquant ou invalide.
+- Erreur bloquante si un path requis n’existe pas après sync.
+- Erreur bloquante si tests/CI signalent des scripts non exécutables ou des fichiers sensibles.
+
+[note]
+Les validations CI peuvent être remplacées par l’exécution locale des agents (AUTO_FIX/SCOPE) lorsque `CI_SKIP=true` est activé. Conserver une PR de synthèse et la traçabilité dans le changelog.
+
+[artefacts concernés]
+- .4nk-sync.yml, TEMPLATE_VERSION, .cursor/**, .gitea/**, AGENTS.md, scripts/**, docs/SSH_UPDATE.md, CHANGELOG.md.
+# Synchronisation de template (4NK)
+
+[portée]
+Tous les projets issus de 4NK_project_template. Contrôle de l’alignement sur .cursor/, .gitea/, AGENTS.md, scripts/, docs/SSH_UPDATE.md.
+
+[objectifs]
+- Garantir l’absence de dérive sur les éléments normatifs.
+- Exiger la mise à jour documentaire et du changelog à chaque synchronisation.
+- Bloquer la progression en cas d’intégrité non conforme.
+
+[directives]
+- Lire la configuration de .4nk-sync.yml (source_repo, ref, paths, policy).
+- Refuser toute modification locale dans le périmètre des paths sans PR de synchronisation.
+- Après synchronisation : exiger mises à jour de CHANGELOG.md et docs/INDEX.md.
+- Scripts : vérifier présence, permissions d’exécution et absence de secrets en clair.
+- SSH : exiger mise à jour de docs/SSH_UPDATE.md si scripts/** modifié.
+
+[validations]
+- Erreur bloquante si manifest_checksum manquant ou invalide.
+- Erreur bloquante si un path requis n’existe pas après sync.
+- Erreur bloquante si tests/CI signalent des scripts non exécutables ou des fichiers sensibles.
+
+[note]
+Les validations CI peuvent être remplacées par l’exécution locale des agents (AUTO_FIX/SCOPE) lorsque `CI_SKIP=true` est activé. Conserver une PR de synthèse et la traçabilité dans le changelog.
+
+[artefacts concernés]
+- .4nk-sync.yml, TEMPLATE_VERSION, .cursor/**, .gitea/**, AGENTS.md, scripts/**, docs/SSH_UPDATE.md, CHANGELOG.md.
--- a/.cursor/rules/4nkrules.mdc
+++ b/.cursor/rules/4nkrules.mdc
@ -0,0 +1,156 @@
+---
+alwaysApply: true
+# cursor.mcd — règles d’or 4NK
+language: fr
+policies:
+  respond_in_french: true
+  no_examples_in_codebase: true
+  ask_before_push_or_tag: true
+
+directories:
+  ensure:
+    - archive/
+    - docs/
+    - tests/
+    - .gitea/
+  docs:
+    required_files:
+      - API.md
+      - ARCHITECTURE.md
+      - COMMUNITY_GUIDE.md
+      - CONFIGURATION.md
+      - GITEA_SETUP.md
+      - INDEX.md
+      - INSTALLATION.md
+      - MIGRATION.md
+      - OPEN_SOURCE_CHECKLIST.md
+      - QUICK_REFERENCE.md
+      - RELEASE_PLAN.md
+      - ROADMAP.md
+      - SECURITY_AUDIT.md
+      - TESTING.md
+      - USAGE.md
+  tests:
+    required_files:
+      - cleanup.sh
+      - README.md
+    required_dirs:
+      - connectivity
+      - external
+      - integration
+      - logs
+      - performance
+      - reports
+      - unit
+  gitea:
+    required_files:
+      - PULL_REQUEST_TEMPLATE.md
+    required_dirs:
+      - ISSUE_TEMPLATE
+      - workflows
+    ISSUE_TEMPLATE:
+      required_files:
+        - bug_report.md
+        - feature_request.md
+    workflows:
+      required_files:
+        - ci.yml
+
+files:
+  required_root_files:
+    - CHANGELOG.md
+    - CODE_OF_CONDUCT.md
+    - CONTRIBUTING.md
+    - docker-compose.yml
+    - LICENSE
+    - README.md
+
+documentation:
+  update_on:
+    - feature_added
+    - feature_modified
+    - feature_removed
+    - feature_discovered
+  replace_sections_named: ["RESUME"]
+  rex_required_on_multiple_hypotheses: true
+  archive_obsolete_docs: true
+
+compilation:
+  compile_often: true
+  compile_when_needed: true
+  fail_on_errors: true
+
+problem_solving:
+  auto_run_steps:
+    - minimal_repro
+    - inspect_logs
+    - bisect_changes
+    - form_hypotheses
+    - targeted_tests
+    - implement_fix
+    - non_regression
+
+office_docs:
+  docx_reader: docx2txt
+  fallback:
+    - pandoc_convert
+    - request_alternate_source
+
+dependencies:
+  auto_add_missing: true
+  always_check_latest_stable: true
+  document_changes_in_docs: true
+
+csv_models:
+  treat_as_source_of_truth: true
+  multirow_headers_supported: true
+  confirm_in_docs: true
+  require_column_definitions: true
+
+file_processing:
+  study_each_file: true
+  ask_questions_if_needed: true
+  adapt_code_if_needed: true
+  propose_solution_if_unreadable: true
+
+types_and_properties:
+  auto_correct_incoherences: true
+  document_transformations: true
+
+functional_consistency:
+  always_ask_clarifying_questions: true
+
+frontend_architecture:
+  react_code_splitting: true
+  state_management: ["redux", "context_api"]
+  data_service_abstraction: true
+
+execution_discipline:
+  finish_started_work: true
+
+open_source_and_gitea:
+  prepare_every_project: true
+  gitea_remote: "git.4nkweb.com"
+  required_files:
+    - LICENSE
+    - CONTRIBUTING.md
+    - CHANGELOG.md
+    - CODE_OF_CONDUCT.md
+  align_with_4NK_node_on_creation: true
+  keep_alignment_updated: true
+
+tests_and_docs:
+  update_docs_and_tests_with_code: true
+  require_green_tests_before_commit: true
+
+versioning:
+  manage_with_changelog: true
+  confirm_before_push: true
+  confirm_before_tag: true
+  propose_semver_bump: true
+
+pre_commit:
+  run_all_tests: true
+  block_on_errors: true
+
+---
--- a/.cursor/rules/50-data-csv-models.mdc
+++ b/.cursor/rules/50-data-csv-models.mdc
@ -0,0 +1,54 @@
+---
+alwaysApply: false
+---
+# Modélisation des données à partir de CSV
+
+[portée]
+Utilisation des CSV comme base des modèles de données, y compris en-têtes multi-lignes.
+
+[objectifs]
+
+- Confirmer la structure inférée pour chaque CSV.
+- Demander une définition formelle de toutes les colonnes.
+
+[directives]
+
+- Gérer explicitement les en-têtes multi-lignes (titre principal + sous-colonnes).
+- Confirmer par écrit dans docs/API.md ou docs/ARCHITECTURE.md : nombre de lignes d’en-tête, mapping colonnes→types, unités, domaines de valeurs, nullabilité, contraintes.
+- Poser des questions si ambiguïtés ; proposer une normalisation temporaire documentée.
+- Corriger automatiquement les incohérences de types si une règle de mapping est établie ailleurs et documenter la transformation.
+
+[validations]
+
+- Aucune ingestion sans spécification de colonnes validée.
+- Traçabilité des corrections de types (avant/après) dans docs/ARCHITECTURE.md.
+
+[artefacts concernés]
+
+- docs/API.md, docs/ARCHITECTURE.md, docs/USAGE.md.
+
+# Modélisation des données à partir de CSV
+
+[portée]
+Utilisation des CSV comme base des modèles de données, y compris en-têtes multi-lignes.
+
+[objectifs]
+
+- Confirmer la structure inférée pour chaque CSV.
+- Demander une définition formelle de toutes les colonnes.
+
+[directives]
+
+- Gérer explicitement les en-têtes multi-lignes (titre principal + sous-colonnes).
+- Confirmer par écrit dans docs/API.md ou docs/ARCHITECTURE.md : nombre de lignes d’en-tête, mapping colonnes→types, unités, domaines de valeurs, nullabilité, contraintes.
+- Poser des questions si ambiguïtés ; proposer une normalisation temporaire documentée.
+- Corriger automatiquement les incohérences de types si une règle de mapping est établie ailleurs et documenter la transformation.
+
+[validations]
+
+- Aucune ingestion sans spécification de colonnes validée.
+- Traçabilité des corrections de types (avant/après) dans docs/ARCHITECTURE.md.
+
+[artefacts concernés]
+
+- docs/API.md, docs/ARCHITECTURE.md, docs/USAGE.md.
--- a/.cursor/rules/60-office-docs.mdc
+++ b/.cursor/rules/60-office-docs.mdc
@ -0,0 +1,41 @@
+---
+alwaysApply: false
+---
+# Lecture des documents bureautiques
+
+[portée]
+Lecture des fichiers .docx et alternatives.
+
+[objectifs]
+- Utiliser docx2txt par défaut.
+- Proposer des solutions de repli si lecture impossible.
+
+[directives]
+- Lire les .docx avec docx2txt.
+- En cas d’échec, proposer : conversion via pandoc, demande d’une source alternative, ou extraction textuelle.
+- Documenter dans docs/INDEX.md la provenance et le statut des documents importés.
+
+[validations]
+- Vérification que les contenus extraits sont intégrés aux fichiers docs/ concernés.
+
+[artefacts concernés]
+- docs/**, archive/**.
+# Lecture des documents bureautiques
+
+[portée]
+Lecture des fichiers .docx et alternatives.
+
+[objectifs]
+- Utiliser docx2txt par défaut.
+- Proposer des solutions de repli si lecture impossible.
+
+[directives]
+- Lire les .docx avec docx2txt.
+- En cas d’échec, proposer : conversion via pandoc, demande d’une source alternative, ou extraction textuelle.
+- Documenter dans docs/INDEX.md la provenance et le statut des documents importés.
+
+[validations]
+- Vérification que les contenus extraits sont intégrés aux fichiers docs/ concernés.
+
+[artefacts concernés]
+- docs/**, archive/**.
--- a/.cursor/rules/70-frontend-architecture.mdc
+++ b/.cursor/rules/70-frontend-architecture.mdc
@ -0,0 +1,56 @@
+---
+alwaysApply: false
+---
+
+# Architecture frontend
+
+[portée]
+Qualité du bundle, découpage, état global et couche de services.
+
+[objectifs]
+
+- Réduire la taille du bundle initial via code splitting.
+- Éviter le prop drilling via Redux ou Context API.
+- Abstraire les services de données pour testabilité et maintenance.
+
+[directives]
+
+- Mettre en place React.lazy et Suspense pour le chargement différé des vues/segments.
+- Centraliser l’état global via Redux ou Context API.
+- Isoler les appels « data » derrière une couche d’abstraction à interface stable.
+- Interdire l’ajout d’exemples front dans la base de code.
+
+[validations]
+
+- Vérifier que les points d’entrée sont minimes et que les segments non critiques sont chargés à la demande.
+- S’assurer que docs/ARCHITECTURE.md décrit les décisions et les points d’extension.
+
+[artefacts concernés]
+
+- docs/ARCHITECTURE.md, docs/TESTING.md.
+# Architecture frontend
+
+[portée]
+Qualité du bundle, découpage, état global et couche de services.
+
+[objectifs]
+
+- Réduire la taille du bundle initial via code splitting.
+- Éviter le prop drilling via Redux ou Context API.
+- Abstraire les services de données pour testabilité et maintenance.
+
+[directives]
+
+- Mettre en place React.lazy et Suspense pour le chargement différé des vues/segments.
+- Centraliser l’état global via Redux ou Context API.
+- Isoler les appels « data » derrière une couche d’abstraction à interface stable.
+- Interdire l’ajout d’exemples front dans la base de code.
+
+[validations]
+
+- Vérifier que les points d’entrée sont minimes et que les segments non critiques sont chargés à la demande.
+- S’assurer que docs/ARCHITECTURE.md décrit les décisions et les points d’extension.
+
+[artefacts concernés]
+
+- docs/ARCHITECTURE.md, docs/TESTING.md.
--- a/.cursor/rules/80-versioning-and-release.mdc
+++ b/.cursor/rules/80-versioning-and-release.mdc
@ -0,0 +1,53 @@
+---
+alwaysApply: false
+---
+
+# Versionnage et publication
+
+[portée]
+Gestion sémantique des versions, CHANGELOG, confirmation push/tag.
+
+[objectifs]
+
+- Tenir CHANGELOG.md comme source unique de vérité.
+- Demander confirmation avant push et tag.
+
+[directives]
+
+- À chaque changement significatif, mettre à jour CHANGELOG.md (ajouts, changements, corrections, ruptures).
+- Proposer un bump semver (major/minor/patch) motivé par l’impact.
+- Avant tout push ou tag, demander confirmation explicite.
+
+[validations]
+
+- Refus si modification sans entrée correspondante dans CHANGELOG.md.
+- Cohérence entre CHANGELOG.md, docs/RELEASE_PLAN.md et docs/ROADMAP.md.
+
+[artefacts concernés]
+
+- CHANGELOG.md, docs/RELEASE_PLAN.md, docs/ROADMAP.md.
+
+# Versionnage et publication
+
+[portée]
+Gestion sémantique des versions, CHANGELOG, confirmation push/tag.
+
+[objectifs]
+
+- Tenir CHANGELOG.md comme source unique de vérité.
+- Demander confirmation avant push et tag.
+
+[directives]
+
+- À chaque changement significatif, mettre à jour CHANGELOG.md (ajouts, changements, corrections, ruptures).
+- Proposer un bump semver (major/minor/patch) motivé par l’impact.
+- Avant tout push ou tag, demander confirmation explicite.
+
+[validations]
+
+- Refus si modification sans entrée correspondante dans CHANGELOG.md.
+- Cohérence entre CHANGELOG.md, docs/RELEASE_PLAN.md et docs/ROADMAP.md.
+
+[artefacts concernés]
+
+- CHANGELOG.md, docs/RELEASE_PLAN.md, docs/ROADMAP.md.
--- a/.cursor/rules/85-release-guard.mdc
+++ b/.cursor/rules/85-release-guard.mdc
@ -0,0 +1,37 @@
+---
+alwaysApply: true
+---
+
+# Garde de release: tests, documentation, compilation, sécurité, version, changelog, tag
+
+[portée]
+Contrôler systématiquement avant push/tag: tests verts, docs mises à jour, build OK, audit de sécurité OK, alignement numéro de version ↔ changelog ↔ tag git, mise à jour de déploiement, confirmation utilisateur (latest vs wip).
+
+[objectifs]
+
+- Empêcher toute publication sans vérifications minimales.
+- Exiger la cohérence sémantique (VERSION/TEMPLATE_VERSION ↔ CHANGELOG ↔ tag git).
+- Demander explicitement « latest » ou « wip » et appliquer la bonne stratégie.
+
+[directives]
+
+- Avant push/tag, exécuter: tests, compilation, lints (si configurés), audit de sécurité (npm audit/cargo audit + scan secrets).
+- Mettre à jour la documentation et le changelog en conséquence.
+- Aligner le fichier de version (VERSION ou TEMPLATE_VERSION), l’entrée CHANGELOG et le tag.
+- Demander confirmation utilisateur: `latest` (release stable) ou `wip` (travail en cours).
+  - latest: entrée datée dans CHANGELOG, version stable, tag `vX.Y.Z`.
+  - wip: suffixe `-wip` recommandé dans version/tag (ex: `vX.Y.Z-wip.N`).
+- Mettre à jour le déploiement après publication (si pipeline défini), sinon documenter l’étape.
+
+[validations]
+
+- Refuser push/tag si:
+  - tests/compilation échouent,
+  - audit de sécurité échoue (vulnérabilités bloquantes ou secrets détectés),
+  - CHANGELOG non mis à jour,
+  - VERSION/TEMPLATE_VERSION absent ou incohérent,
+  - release type non fourni (ni latest, ni wip).
+
+[artefacts concernés]
+
+- CHANGELOG.md, VERSION ou TEMPLATE_VERSION, docs/**, .gitea/workflows/**, scripts/**.
--- a/.cursor/rules/90-gitea-and-oss.mdc
+++ b/.cursor/rules/90-gitea-and-oss.mdc
@ -0,0 +1,59 @@
+---
+alwaysApply: true
+---
+
+# Open source et Gitea
+
+[portée]
+Conformité open source, templates Gitea, CI.
+
+[objectifs]
+
+- Préparer chaque projet pour un dépôt Gitea (git.4nkweb.com).
+- Maintenir les fichiers de gouvernance et la CI.
+
+[directives]
+
+- Vérifier la présence et l’actualité de : LICENSE, CONTRIBUTING.md, CODE_OF_CONDUCT.md, OPEN_SOURCE_CHECKLIST.md.
+- Maintenir .gitea/ :
+  - ISSUE_TEMPLATE/bug_report.md, feature_request.md
+  - PULL_REQUEST_TEMPLATE.md
+  - workflows/ci.yml
+- Documenter dans docs/GITEA_SETUP.md la configuration distante et les permissions.
+
+[validations]
+
+- Refus si un des fichiers « gouvernance/CI » manque.
+- Cohérence entre docs/OPEN_SOURCE_CHECKLIST.md et l’état du repo.
+
+[artefacts concernés]
+
+- .gitea/**, docs/GITEA_SETUP.md, docs/OPEN_SOURCE_CHECKLIST.md.
+
+# Open source et Gitea
+
+[portée]
+Conformité open source, templates Gitea, CI.
+
+[objectifs]
+
+- Préparer chaque projet pour un dépôt Gitea (git.4nkweb.com).
+- Maintenir les fichiers de gouvernance et la CI.
+
+[directives]
+
+- Vérifier la présence et l’actualité de : LICENSE, CONTRIBUTING.md, CODE_OF_CONDUCT.md, OPEN_SOURCE_CHECKLIST.md.
+- Maintenir .gitea/ :
+  - ISSUE_TEMPLATE/bug_report.md, feature_request.md
+  - PULL_REQUEST_TEMPLATE.md
+  - workflows/ci.yml
+- Documenter dans docs/GITEA_SETUP.md la configuration distante et les permissions.
+
+[validations]
+
+- Refus si un des fichiers « gouvernance/CI » manque.
+- Cohérence entre docs/OPEN_SOURCE_CHECKLIST.md et l’état du repo.
+
+[artefacts concernés]
+
+- .gitea/**, docs/GITEA_SETUP.md, docs/OPEN_SOURCE_CHECKLIST.md.
--- a/.cursor/rules/95-triage-and-problem-solving.mdc
+++ b/.cursor/rules/95-triage-and-problem-solving.mdc
@ -0,0 +1,53 @@
+---
+alwaysApply: true
+---
+
+# Tri, diagnostic et résolution de problèmes
+
+[portée]
+Boucle de triage : reproduction, diagnostic, correctif, non-régression.
+
+[objectifs]
+
+- Exécuter automatiquement les étapes de résolution.
+- Bloquer l’avancement tant que les erreurs ne sont pas corrigées.
+
+[directives]
+
+- Étapes obligatoires : reproduction minimale, inspection des logs, bissection des changements, formulation d’hypothèses, tests ciblés, correctif, test de non-régression.
+- Lorsque plusieurs hypothèses ont été testées, produire un REX dans archive/ avec liens vers les commits.
+- Poser des questions de cohérence fonctionnelle si des ambiguïtés subsistent (contrats d’API, invariants, SLA).
+
+[validations]
+
+- Interdiction de clore une tâche si un test échoue ou si une alerte critique subsiste.
+- Traçabilité du REX si investigations multiples.
+
+[artefacts concernés]
+
+- tests/**, archive/**, docs/TESTING.md, docs/ARCHITECTURE.md.
+
+# Tri, diagnostic et résolution de problèmes
+
+[portée]
+Boucle de triage : reproduction, diagnostic, correctif, non-régression.
+
+[objectifs]
+
+- Exécuter automatiquement les étapes de résolution.
+- Bloquer l’avancement tant que les erreurs ne sont pas corrigées.
+
+[directives]
+
+- Étapes obligatoires : reproduction minimale, inspection des logs, bissection des changements, formulation d’hypothèses, tests ciblés, correctif, test de non-régression.
+- Lorsque plusieurs hypothèses ont été testées, produire un REX dans archive/ avec liens vers les commits.
+- Poser des questions de cohérence fonctionnelle si des ambiguïtés subsistent (contrats d’API, invariants, SLA).
+
+[validations]
+
+- Interdiction de clore une tâche si un test échoue ou si une alerte critique subsiste.
+- Traçabilité du REX si investigations multiples.
+
+[artefacts concernés]
+
+- tests/**, archive/**, docs/TESTING.md, docs/ARCHITECTURE.md.
--- a/.cursor/rules/98-explain-complex-commands
+++ b/.cursor/rules/98-explain-complex-commands
@ -0,0 +1,5 @@
+---
+alwaysApply: true
+---
+
+quand tu fais une commande ou un requète complexe, explique là avant de la lancer
--- a/.cursor/rules/99-lint-markdow.mdc
+++ b/.cursor/rules/99-lint-markdow.mdc
@ -0,0 +1,9 @@
+---
+description:
+globs:
+alwaysApply: true
+---
+
+# Lint
+
+respecter strictement les règles de lint du markdown
--- a/.cursor/rules/ruleset-index.md
+++ b/.cursor/rules/ruleset-index.md
@ -0,0 +1,17 @@
+# Index des règles .cursor/rules
+
+- 00-foundations.mdc : règles linguistiques et éditoriales (français, pas d’exemples en base, introduction/conclusion).
+- 10-project-structure.mdc : arborescence canonique 4NK_node et garde-fous.
+- 20-documentation.mdc : documentation continue, remplacement de « RESUME », INDEX.md.
+- 30-testing.mdc : tests (unit, integration, connectivity, performance, external), logs/reports.
+- 40-dependencies-and-build.mdc : dépendances, compilation, corrections bloquantes.
+- 50-data-csv-models.mdc : CSV avec en-têtes multi-lignes, définition des colonnes.
+- 60-office-docs.mdc : lecture .docx via docx2txt + repli.
+- 70-frontend-architecture.mdc : React.lazy/Suspense, état global, couche de services.
+- 80-versioning-and-release.mdc : CHANGELOG, semver, confirmation push/tag.
+- 85-release-guard.mdc : garde de release (tests/doc/build/sécurité/version/changelog/tag; latest vs wip).
+- 05-template-governance.mdc : adaptation locale et feedback vers `4NK_template`.
+- 90-gitea-and-oss.mdc : fichiers open source, .gitea, CI, Gitea remote.
+- 95-triage-and-problem-solving.mdc : boucle de diagnostic, REX, non-régression.
+
+Ces règles sont conçues pour être ajoutées au contexte de Cursor depuis l’interface (@Cursor Rules) et s’appuient sur le mécanisme de règles projet stockées dans `.cursor/rules/`. :contentReference[oaicite:3]{index=3}
--- a/.cursorignore
+++ b/.cursorignore
@ -0,0 +1,24 @@
+# Ignorer les contenus volumineux pour le contexte IA
+node_modules/
+dist/
+build/
+coverage/
+.cache/
+.tmp/
+.parcel-cache/
+
+# Rapports et logs de tests
+tests/logs/
+tests/reports/
+
+# Fichiers lourds
+**/*.map
+**/*.min.*
+**/*.wasm
+**/*.{png,jpg,jpeg,svg,ico,pdf}
+
+# Ne pas ignorer .cursor ni AGENTS.md
+!/.cursor
+!/AGENTS.md
+
+
--- a/.gitea/ISSUE_TEMPLATE/bug_report.md
+++ b/.gitea/ISSUE_TEMPLATE/bug_report.md
@ -0,0 +1,102 @@
+---
+name: Bug Report
+about: Signaler un bug pour nous aider à améliorer 4NK Node
+title: '[BUG] '
+labels: ['bug', 'needs-triage']
+assignees: ''
+---
+
+## 🐛 Description du Bug
+
+Description claire et concise du problème.
+
+## 🔄 Étapes pour Reproduire
+
+1. Aller à '...'
+2. Cliquer sur '...'
+3. Faire défiler jusqu'à '...'
+4. Voir l'erreur
+
+## ✅ Comportement Attendu
+
+Description de ce qui devrait se passer.
+
+## ❌ Comportement Actuel
+
+Description de ce qui se passe actuellement.
+
+## 📸 Capture d'Écran
+
+Si applicable, ajoutez une capture d'écran pour expliquer votre problème.
+
+## 💻 Informations Système
+
+- **OS** : [ex: Ubuntu 20.04, macOS 12.0, Windows 11]
+- **Docker** : [ex: 20.10.0]
+- **Docker Compose** : [ex: 2.0.0]
+- **Version 4NK Node** : [ex: v1.0.0]
+- **Architecture** : [ex: x86_64, ARM64]
+
+## 📋 Configuration
+
+### Services Actifs
+
+```bash
+docker ps
+```
+
+### Variables d'Environnement
+
+```bash
+# Bitcoin Core
+BITCOIN_NETWORK=signet
+BITCOIN_RPC_PORT=18443
+
+# Blindbit
+BLINDBIT_PORT=8000
+
+# SDK Relay
+SDK_RELAY_PORTS=8090-8095
+```
+
+## 📝 Logs
+
+### Logs Pertinents
+
+```txt
+Logs pertinents ici
+```
+
+### Logs d'Erreur
+
+```txt
+Logs d'erreur ici
+```
+
+### Logs de Debug
+
+```txt
+Logs de debug ici (si RUST_LOG=debug)
+```
+
+## 🔧 Tentatives de Résolution
+
+- [ ] Redémarrage des services
+- [ ] Nettoyage des volumes Docker
+- [ ] Vérification de la connectivité réseau
+- [ ] Mise à jour des dépendances
+- [ ] Vérification de la configuration
+
+## 📚 Contexte Supplémentaire
+
+Toute autre information pertinente sur le problème.
+
+## 🔗 Liens Utiles
+
+- [Documentation](docs/)
+- [Guide de Dépannage](docs/TROUBLESHOOTING.md)
+- [Issues Similaires](https://git.4nkweb.com/4nk/4NK_node/issues?q=is%3Aissue+is%3Aopen+label%3Abug)
+
+---
+
+**Merci de votre contribution !** 🙏
--- a/.gitea/ISSUE_TEMPLATE/feature_request.md
+++ b/.gitea/ISSUE_TEMPLATE/feature_request.md
@ -0,0 +1,156 @@
+---
+name: Feature Request
+about: Proposer une nouvelle fonctionnalité pour 4NK Node
+title: '[FEATURE] '
+labels: ['enhancement', 'needs-triage']
+assignees: ''
+---
+
+## 🚀 Résumé
+
+Description claire et concise de la fonctionnalité souhaitée.
+
+## 💡 Motivation
+
+Pourquoi cette fonctionnalité est-elle nécessaire ? Quels problèmes résout-elle ?
+
+### Problèmes Actuels
+- Problème 1
+- Problème 2
+- Problème 3
+
+### Avantages de la Solution
+- Avantage 1
+- Avantage 2
+- Avantage 3
+
+## 🎯 Proposition
+
+Description détaillée de la fonctionnalité proposée.
+
+### Fonctionnalités Principales
+- [ ] Fonctionnalité 1
+- [ ] Fonctionnalité 2
+- [ ] Fonctionnalité 3
+
+### Interface Utilisateur
+Description de l'interface utilisateur si applicable.
+
+### API Changes
+Description des changements d'API si applicable.
+
+## 🔄 Alternatives Considérées
+
+Autres solutions envisagées et pourquoi elles n'ont pas été choisies.
+
+### Alternative 1
+- **Description** : ...
+- **Pourquoi rejetée** : ...
+
+### Alternative 2
+- **Description** : ...
+- **Pourquoi rejetée** : ...
+
+## 📊 Impact
+
+### Impact sur les Utilisateurs
+- Impact positif 1
+- Impact positif 2
+- Impact négatif potentiel (si applicable)
+
+### Impact sur l'Architecture
+- Changements nécessaires
+- Compatibilité avec l'existant
+- Performance
+
+### Impact sur la Maintenance
+- Complexité ajoutée
+- Tests nécessaires
+- Documentation requise
+
+## 💻 Exemples d'Utilisation
+
+### Cas d'Usage 1
+```bash
+# Exemple de commande ou configuration
+```
+
+### Cas d'Usage 2
+```python
+# Exemple de code Python
+```
+
+### Cas d'Usage 3
+```javascript
+// Exemple de code JavaScript
+```
+
+## 🧪 Tests
+
+### Tests Nécessaires
+- [ ] Tests unitaires
+- [ ] Tests d'intégration
+- [ ] Tests de performance
+- [ ] Tests de sécurité
+- [ ] Tests de compatibilité
+
+### Scénarios de Test
+- Scénario 1
+- Scénario 2
+- Scénario 3
+
+## 📚 Documentation
+
+### Documentation Requise
+- [ ] Guide d'utilisation
+- [ ] Documentation API
+- [ ] Exemples de code
+- [ ] Guide de migration
+- [ ] FAQ
+
+## 🔧 Implémentation
+
+### Étapes Proposées
+1. **Phase 1** : [Description]
+2. **Phase 2** : [Description]
+3. **Phase 3** : [Description]
+
+### Estimation de Temps
+- **Développement** : X jours/semaines
+- **Tests** : X jours/semaines
+- **Documentation** : X jours/semaines
+- **Total** : X jours/semaines
+
+### Ressources Nécessaires
+- Développeur(s)
+- Testeur(s)
+- Documentateur(s)
+- Infrastructure
+
+## 🎯 Critères de Succès
+
+Comment mesurer le succès de cette fonctionnalité ?
+
+- [ ] Critère 1
+- [ ] Critère 2
+- [ ] Critère 3
+
+## 🔗 Liens Utiles
+
+- [Documentation existante](docs/)
+- [Issues similaires](https://git.4nkweb.com/4nk/4NK_node/issues?q=is%3Aissue+is%3Aopen+label%3Aenhancement)
+- [Roadmap](https://git.4nkweb.com/4nk/4NK_node/projects)
+- [Discussions](https://git.4nkweb.com/4nk/4NK_node/issues)
+
+## 📋 Checklist
+
+- [ ] J'ai vérifié que cette fonctionnalité n'existe pas déjà
+- [ ] J'ai lu la documentation existante
+- [ ] J'ai vérifié les issues similaires
+- [ ] J'ai fourni des exemples d'utilisation
+- [ ] J'ai considéré l'impact sur l'existant
+- [ ] J'ai proposé des tests
+
+---
+
+**Merci de votre contribution à l'amélioration de 4NK Node !** 🌟
--- a/.gitea/PULL_REQUEST_TEMPLATE.md
+++ b/.gitea/PULL_REQUEST_TEMPLATE.md
@ -0,0 +1,180 @@
+# Pull Request - 4NK Node
+
+## 📋 Description
+
+Description claire et concise des changements apportés.
+
+### Type de Changement
+- [ ] 🐛 Bug fix
+- [ ] ✨ Nouvelle fonctionnalité
+- [ ] 📚 Documentation
+- [ ] 🧪 Tests
+- [ ] 🔧 Refactoring
+- [ ] 🚀 Performance
+- [ ] 🔒 Sécurité
+- [ ] 🎨 Style/UI
+- [ ] 🏗️ Architecture
+- [ ] 📦 Build/CI
+
+### Composants Affectés
+- [ ] Bitcoin Core
+- [ ] Blindbit
+- [ ] SDK Relay
+- [ ] Tor
+- [ ] Docker/Infrastructure
+- [ ] Tests
+- [ ] Documentation
+- [ ] Scripts
+
+## 🔗 Issue(s) Liée(s)
+
+Fixes #(issue)
+Relates to #(issue)
+
+## 🧪 Tests
+
+### Tests Exécutés
+- [ ] Tests unitaires
+- [ ] Tests d'intégration
+- [ ] Tests de connectivité
+- [ ] Tests externes
+- [ ] Tests de performance
+
+### Commandes de Test
+```bash
+# Tests complets
+./tests/run_all_tests.sh
+
+# Tests spécifiques
+./tests/run_unit_tests.sh
+./tests/run_integration_tests.sh
+```
+
+### Résultats des Tests
+```
+Résultats des tests ici
+```
+
+## 📸 Captures d'Écran
+
+Si applicable, ajoutez des captures d'écran pour les changements visuels.
+
+## 🔧 Changements Techniques
+
+### Fichiers Modifiés
+- `fichier1.rs` - Description des changements
+- `fichier2.py` - Description des changements
+- `docker-compose.yml` - Description des changements
+
+### Nouveaux Fichiers
+- `nouveau_fichier.rs` - Description
+- `nouveau_script.sh` - Description
+
+### Fichiers Supprimés
+- `ancien_fichier.rs` - Raison de la suppression
+
+### Changements de Configuration
+```yaml
+# Exemple de changement de configuration
+service:
+  new_option: value
+```
+
+## 📚 Documentation
+
+### Documentation Mise à Jour
+- [ ] README.md
+- [ ] docs/INSTALLATION.md
+- [ ] docs/USAGE.md
+- [ ] docs/API.md
+- [ ] docs/ARCHITECTURE.md
+
+### Nouvelle Documentation
+- [ ] Nouveau guide créé
+- [ ] Exemples ajoutés
+- [ ] API documentée
+
+## 🔍 Code Review Checklist
+
+### Code Quality
+- [ ] Le code suit les standards du projet
+- [ ] Les noms de variables/fonctions sont clairs
+- [ ] Les commentaires sont appropriés
+- [ ] Pas de code mort ou commenté
+- [ ] Gestion d'erreurs appropriée
+
+### Performance
+- [ ] Pas de régression de performance
+- [ ] Optimisations appliquées si nécessaire
+- [ ] Tests de performance ajoutés
+
+### Sécurité
+- [ ] Pas de vulnérabilités introduites
+- [ ] Validation des entrées utilisateur
+- [ ] Gestion sécurisée des secrets
+
+### Tests
+- [ ] Couverture de tests suffisante
+- [ ] Tests pour les cas d'erreur
+- [ ] Tests d'intégration si nécessaire
+
+### Documentation
+- [ ] Code auto-documenté
+- [ ] Documentation mise à jour
+- [ ] Exemples fournis
+
+## 🚀 Déploiement
+
+### Impact sur le Déploiement
+- [ ] Aucun impact
+- [ ] Migration de données requise
+- [ ] Changement de configuration
+- [ ] Redémarrage des services
+
+### Étapes de Déploiement
+```bash
+# Étapes pour déployer les changements
+```
+
+## 📊 Métriques
+
+### Impact sur les Performances
+- Temps de réponse : +/- X%
+- Utilisation mémoire : +/- X%
+- Utilisation CPU : +/- X%
+
+### Impact sur la Stabilité
+- Taux d'erreur : +/- X%
+- Disponibilité : +/- X%
+
+## 🔄 Compatibilité
+
+### Compatibilité Ascendante
+- [ ] Compatible avec les versions précédentes
+- [ ] Migration automatique
+- [ ] Migration manuelle requise
+
+### Compatibilité Descendante
+- [ ] Compatible avec les futures versions
+- [ ] API stable
+- [ ] Configuration stable
+
+## 🎯 Critères de Succès
+
+- [ ] Critère 1
+- [ ] Critère 2
+- [ ] Critère 3
+
+## 📝 Notes Supplémentaires
+
+Informations supplémentaires importantes pour les reviewers.
+
+## 🔗 Liens Utiles
+
+- [Documentation](docs/)
+- [Tests](tests/)
+- [Issues liées](https://git.4nkweb.com/4nk/4NK_node/issues)
+
+---
+
+**Merci pour votre contribution !** 🙏
--- a/.gitea/workflows/LOCAL_OVERRIDES.yml
+++ b/.gitea/workflows/LOCAL_OVERRIDES.yml
@ -0,0 +1,14 @@
+# LOCAL_OVERRIDES.yml — dérogations locales contrôlées
+overrides:
+  - path: ".gitea/workflows/ci.yml"
+    reason: "spécificité d’environnement"
+    owner: "@maintainer_handle"
+    expires: "2025-12-31"
+  - path: "scripts/auto-ssh-push.sh"
+    reason: "flux particulier temporaire"
+    owner: "@maintainer_handle"
+    expires: "2025-10-01"
+policy:
+  allow_only_listed_paths: true
+  require_expiry: true
+  audit_in_ci: true
--- a/.gitea/workflows/ci.yml
+++ b/.gitea/workflows/ci.yml
@ -0,0 +1,486 @@
+name: CI - 4NK Node
+
+on:
+  push:
+    branches: [ main, develop ]
+    tags:
+      - 'v*'
+  pull_request:
+    branches: [ main, develop ]
+
+env:
+  RUST_VERSION: '1.70'
+  DOCKER_COMPOSE_VERSION: '2.20.0'
+  CI_SKIP: 'true'
+
+jobs:
+  # Job de vérification du code
+  code-quality:
+    name: Code Quality
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Setup Rust
+      uses: actions-rs/toolchain@v1
+      with:
+        toolchain: ${{ env.RUST_VERSION }}
+        override: true
+
+    - name: Cache Rust dependencies
+      uses: actions/cache@v3
+      with:
+        path: |
+          ~/.cargo/registry
+          ~/.cargo/git
+          target
+        key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+        restore-keys: |
+          ${{ runner.os }}-cargo-
+
+    - name: Run clippy
+      run: |
+        cd sdk_relay
+        cargo clippy --all-targets --all-features -- -D warnings
+
+    - name: Run rustfmt
+      run: |
+        cd sdk_relay
+        cargo fmt --all -- --check
+
+    - name: Check documentation
+      run: |
+        cd sdk_relay
+        cargo doc --no-deps
+
+    - name: Check for TODO/FIXME
+      run: |
+        if grep -r "TODO\|FIXME" . --exclude-dir=.git --exclude-dir=target; then
+          echo "Found TODO/FIXME comments. Please address them."
+          exit 1
+        fi
+
+  # Job de tests unitaires
+  unit-tests:
+    name: Unit Tests
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Setup Rust
+      uses: actions-rs/toolchain@v1
+      with:
+        toolchain: ${{ env.RUST_VERSION }}
+        override: true
+
+    - name: Cache Rust dependencies
+      uses: actions/cache@v3
+      with:
+        path: |
+          ~/.cargo/registry
+          ~/.cargo/git
+          target
+        key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+        restore-keys: |
+          ${{ runner.os }}-cargo-
+
+    - name: Run unit tests
+      run: |
+        cd sdk_relay
+        cargo test --lib --bins
+
+    - name: Run integration tests
+      run: |
+        cd sdk_relay
+        cargo test --tests
+
+  # Job de tests d'intégration
+  integration-tests:
+    name: Integration Tests
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
+
+    services:
+      docker:
+        image: docker:24.0.5
+        options: >-
+          --health-cmd "docker info"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          - 2375:2375
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Setup Docker Buildx
+      uses: docker/setup-buildx-action@v3
+
+    - name: Build Docker images
+      run: |
+        docker build -t 4nk-node-bitcoin ./bitcoin
+        docker build -t 4nk-node-blindbit ./blindbit
+        docker build -t 4nk-node-sdk-relay -f ./sdk_relay/Dockerfile ..
+
+    - name: Run integration tests
+      run: |
+        # Tests de connectivité de base
+        ./tests/run_connectivity_tests.sh || true
+
+        # Tests d'intégration
+        ./tests/run_integration_tests.sh || true
+
+    - name: Upload test results
+      uses: actions/upload-artifact@v3
+      if: always()
+      with:
+        name: test-results
+        path: |
+          tests/logs/
+          tests/reports/
+        retention-days: 7
+
+  # Job de tests de sécurité
+  security-tests:
+    name: Security Tests
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Setup Rust
+      uses: actions-rs/toolchain@v1
+      with:
+        toolchain: ${{ env.RUST_VERSION }}
+        override: true
+
+    - name: Run cargo audit
+      run: |
+        cd sdk_relay
+        cargo audit --deny warnings
+
+    - name: Check for secrets
+      run: |
+        # Vérifier les secrets potentiels
+        if grep -r "password\|secret\|key\|token" . --exclude-dir=.git --exclude-dir=target --exclude=*.md; then
+          echo "Potential secrets found. Please review."
+          exit 1
+        fi
+
+    - name: Check file permissions
+      run: |
+        # Vérifier les permissions sensibles
+        find . -type f -perm /0111 -name "*.conf" -o -name "*.key" -o -name "*.pem" | while read file; do
+          if [[ $(stat -c %a "$file") != "600" ]]; then
+            echo "Warning: $file has insecure permissions"
+          fi
+        done
+
+  # Job de build et test Docker
+  docker-build:
+    name: Docker Build & Test
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
+
+    services:
+      docker:
+        image: docker:24.0.5
+        options: >-
+          --health-cmd "docker info"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          - 2375:2375
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Setup Docker Buildx
+      uses: docker/setup-buildx-action@v3
+
+    - name: Build and test Bitcoin Core
+      run: |
+        docker build -t 4nk-node-bitcoin:test ./bitcoin
+        docker run --rm 4nk-node-bitcoin:test bitcoin-cli --version
+
+    - name: Build and test Blindbit
+      run: |
+        docker build -t 4nk-node-blindbit:test ./blindbit
+        docker run --rm 4nk-node-blindbit:test --version || true
+
+    - name: Build and test SDK Relay
+      run: |
+        docker build -t 4nk-node-sdk-relay:test -f ./sdk_relay/Dockerfile ..
+        docker run --rm 4nk-node-sdk-relay:test --version || true
+
+    - name: Test Docker Compose
+      run: |
+        docker-compose config
+        docker-compose build --no-cache
+
+  # Job de tests de documentation
+  documentation-tests:
+    name: Documentation Tests
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Check markdown links
+      run: |
+        # Vérification basique des liens markdown
+        find . -name "*.md" -exec grep -l "\[.*\](" {} \; | while read file; do
+          echo "Checking links in $file"
+        done
+
+  markdownlint:
+    name: Markdown Lint
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+      - name: Run markdownlint
+        run: |
+          npm --version || (curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt-get install -y nodejs)
+          npx -y markdownlint-cli@0.42.0 "**/*.md" --ignore "archive/**"
+
+    - name: Check documentation structure
+      run: |
+        # Vérifier la présence des fichiers de documentation essentiels
+        required_files=(
+          "README.md"
+          "LICENSE"
+          "CONTRIBUTING.md"
+          "CHANGELOG.md"
+          "CODE_OF_CONDUCT.md"
+          "SECURITY.md"
+        )
+
+        for file in "${required_files[@]}"; do
+          if [[ ! -f "$file" ]]; then
+            echo "Missing required documentation file: $file"
+            exit 1
+          fi
+        done
+
+  bash-required:
+    name: Bash Requirement
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+      - name: Verify bash availability
+        run: |
+          if ! command -v bash >/dev/null 2>&1; then
+            echo "bash is required for agents and scripts"; exit 1;
+          fi
+      - name: Verify agents runner exists
+        run: |
+          if [ ! -f scripts/agents/run.sh ]; then
+            echo "scripts/agents/run.sh is missing"; exit 1;
+          fi
+
+  agents-smoke:
+    name: Agents Smoke (no AI)
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+      - name: Ensure agents scripts executable
+        run: |
+          chmod +x scripts/agents/*.sh || true
+      - name: Run agents without AI
+        env:
+          OPENAI_API_KEY: ""
+        run: |
+          scripts/agents/run.sh
+      - name: Upload agents reports
+        uses: actions/upload-artifact@v3
+        with:
+          name: agents-reports
+          path: tests/reports/agents
+
+  openia-agents:
+    name: Agents with OpenIA
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' && secrets.OPENAI_API_KEY != '' }}
+    env:
+      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+      OPENAI_MODEL: ${{ vars.OPENAI_MODEL }}
+      OPENAI_API_BASE: ${{ vars.OPENAI_API_BASE }}
+      OPENAI_TEMPERATURE: ${{ vars.OPENAI_TEMPERATURE }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+      - name: Ensure agents scripts executable
+        run: |
+          chmod +x scripts/agents/*.sh || true
+      - name: Run agents with AI
+        run: |
+          scripts/agents/run.sh
+      - name: Upload agents reports
+        uses: actions/upload-artifact@v3
+        with:
+          name: agents-reports-ai
+          path: tests/reports/agents
+
+  deployment-checks:
+    name: Deployment Checks
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+      - name: Validate deployment documentation
+        run: |
+          if [ ! -f docs/DEPLOYMENT.md ]; then
+            echo "Missing docs/DEPLOYMENT.md"; exit 1; fi
+          if [ ! -f docs/SSH_UPDATE.md ]; then
+            echo "Missing docs/SSH_UPDATE.md"; exit 1; fi
+      - name: Ensure tests directories exist
+        run: |
+          mkdir -p tests/logs tests/reports || true
+          echo "OK"
+
+  security-audit:
+    name: Security Audit
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+      - name: Ensure scripts executable
+        run: |
+          chmod +x scripts/security/audit.sh || true
+      - name: Run template security audit
+        run: |
+          if [ -f scripts/security/audit.sh ]; then
+            ./scripts/security/audit.sh
+          else
+            echo "No security audit script (ok)"
+          fi
+
+  # Job de release guard (cohérence release)
+  release-guard:
+    name: Release Guard
+    runs-on: [self-hosted, linux]
+    needs: [code-quality, unit-tests, documentation-tests, markdownlint, security-audit, deployment-checks, bash-required]
+    if: ${{ env.CI_SKIP != 'true' }}
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Ensure guard scripts are executable
+      run: |
+        chmod +x scripts/release/guard.sh || true
+        chmod +x scripts/checks/version_alignment.sh || true
+
+    - name: Version alignment check
+      run: |
+        if [ -f scripts/checks/version_alignment.sh ]; then
+          ./scripts/checks/version_alignment.sh
+        else
+          echo "No version alignment script (ok)"
+        fi
+
+    - name: Release guard (CI verify)
+      env:
+        RELEASE_TYPE: ci-verify
+      run: |
+        if [ -f scripts/release/guard.sh ]; then
+          ./scripts/release/guard.sh
+        else
+          echo "No guard script (ok)"
+        fi
+
+  release-create:
+    name: Create Release (Gitea API)
+    runs-on: ubuntu-latest
+    needs: [release-guard]
+    if: ${{ env.CI_SKIP != 'true' && startsWith(github.ref, 'refs/tags/') }}
+    env:
+      RELEASE_TOKEN: ${{ secrets.RELEASE_TOKEN }}
+      BASE_URL: ${{ vars.BASE_URL }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+      - name: Validate token and publish release
+        run: |
+          set -e
+          if [ -z "${RELEASE_TOKEN}" ]; then
+            echo "RELEASE_TOKEN secret is missing" >&2; exit 1; fi
+          if [ -z "${BASE_URL}" ]; then
+            BASE_URL="https://git.4nkweb.com"; fi
+          TAG="${GITHUB_REF##*/}"
+          REPO="${GITHUB_REPOSITORY}"
+          OWNER="${REPO%%/*}"
+          NAME="${REPO##*/}"
+          echo "Publishing release ${TAG} to ${BASE_URL}/${OWNER}/${NAME}"
+          curl -sSf -X POST \
+            -H "Authorization: token ${RELEASE_TOKEN}" \
+            -H "Content-Type: application/json" \
+            -d "{\"tag_name\":\"${TAG}\",\"name\":\"${TAG}\",\"draft\":false,\"prerelease\":false}" \
+            "${BASE_URL}/api/v1/repos/${OWNER}/${NAME}/releases" >/dev/null
+          echo "Release created"
+
+  # Job de tests de performance
+  performance-tests:
+    name: Performance Tests
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Setup Rust
+      uses: actions-rs/toolchain@v1
+      with:
+        toolchain: ${{ env.RUST_VERSION }}
+        override: true
+
+    - name: Run performance tests
+      run: |
+        cd sdk_relay
+        cargo test --release --test performance_tests || true
+
+    - name: Check memory usage
+      run: |
+        # Tests de base de consommation mémoire
+        echo "Performance tests completed"
+
+  # Job de notification
+  notify:
+    name: Notify
+    runs-on: [self-hosted, linux]
+    needs: [code-quality, unit-tests, integration-tests, security-tests, docker-build, documentation-tests]
+    if: ${{ env.CI_SKIP != 'true' && always() }}
+
+    steps:
+    - name: Notify success
+      if: needs.code-quality.result == 'success' && needs.unit-tests.result == 'success' && needs.integration-tests.result == 'success' && needs.security-tests.result == 'success' && needs.docker-build.result == 'success' && needs.documentation-tests.result == 'success'
+      run: |
+        echo "✅ All tests passed successfully!"
+
+    - name: Notify failure
+      if: needs.code-quality.result == 'failure' || needs.unit-tests.result == 'failure' || needs.integration-tests.result == 'failure' || needs.security-tests.result == 'failure' || needs.docker-build.result == 'failure' || needs.documentation-tests.result == 'failure'
+      run: |
+        echo "❌ Some tests failed!"
+        exit 1
--- a/.gitea/workflows/template-sync.yml
+++ b/.gitea/workflows/template-sync.yml
@ -0,0 +1,39 @@
+# .gitea/workflows/template-sync.yml — synchronisation et contrôles d’intégrité
+name: 4NK Template Sync
+on:
+  schedule:        # planification régulière
+    - cron: "0 4 * * 1"   # exécution hebdomadaire (UTC)
+  workflow_dispatch: {}   # déclenchement manuel
+
+jobs:
+  check-and-sync:
+    runs-on: [self-hosted, linux]
+    steps:
+      - name: Lire TEMPLATE_VERSION et .4nk-sync.yml
+        # Doit charger ref courant, source_repo et périmètre paths
+
+      - name: Récupérer la version publiée du template/4NK_rules
+        # Doit comparer TEMPLATE_VERSION avec ref amont
+
+      - name: Créer branche de synchronisation si divergence
+        # Doit créer chore/template-sync-<date> et préparer un commit
+
+      - name: Synchroniser les chemins autoritatifs
+        # Doit mettre à jour .cursor/**, .gitea/**, AGENTS.md, scripts/**, docs/SSH_UPDATE.md
+
+      - name: Contrôles post-sync (bloquants)
+        # 1) Vérifier présence et exécutable des scripts/*.sh
+        # 2) Vérifier mise à jour CHANGELOG.md et docs/INDEX.md
+        # 3) Vérifier docs/SSH_UPDATE.md si scripts/** a changé
+        # 4) Vérifier absence de secrets en clair dans scripts/**
+        # 5) Vérifier manifest_checksum si publié
+
+      - name: Tests, lint, sécurité statique
+        # Doit exiger un état vert
+
+      - name: Ouvrir PR de synchronisation
+        # Titre: "[template-sync] chore: aligner .cursor/.gitea/AGENTS.md/scripts"
+        # Doit inclure résumé des fichiers modifiés et la version appliquée
+
+      - name: Mettre à jour TEMPLATE_VERSION (dans PR)
+        # Doit remplacer la valeur par la ref appliquée
--- a/.markdownlint.json
+++ b/.markdownlint.json
@ -0,0 +1,14 @@
+{
+  "MD013": {
+    "line_length": 200,
+    "code_blocks": false,
+    "tables": false,
+    "headings": false
+  },
+  "MD007": {
+    "indent": 2
+  },
+  "MD024": {
+    "siblings_only": true
+  }
+}
--- a/AGENTS.md
+++ b/AGENTS.md
@ -0,0 +1,412 @@
+# AGENTS.md
+
+## Table des matières
+
+- [Introduction](#introduction)
+- [Principes communs](#principes-communs)
+- [Agents fondamentaux](#agents-fondamentaux)
+- [Agents spécialisés documentation] (#agents-specialises-documentation)
+- [Agents spécialisés tests] (#agents-specialises-tests)
+- [Agents techniques](#agents-techniques)
+- [Agents frontend](#agents-frontend)
+- [Agents open source et CI](#agents-open-source-et-ci)
+- [Agents de synchronisation et dérogations] (#agents-de-synchronisation-et-derogations)
+- [Matrice de coordination] (#matrice-de-coordination)
+- [Conclusion](#conclusion)
+
+---
+
+## Introduction
+
+Ce document définit les agents, leurs rôles et leurs responsabilités dans le projet `4NK/4NK_node` et, par extension, tout dépôt dérivé de `4NK_project_template`.
+Il impose une coordination stricte entre code, documentation, tests, dépendances, CI/CD, synchronisation de template et gouvernance open source.
+Les règles opérationnelles détaillées sont précisées dans `.cursor/rules/` (notamment `41-ssh-automation.mdc` et `42-template-sync.mdc`).
+
+---
+
+## Principes communs
+
+- Langue exclusive : français.
+- Pas d’exemples de code applicatif injectés dans la base.
+- Toute contribution doit contenir une introduction et/ou une conclusion.
+- Interdiction de secrets en clair dans le dépôt.
+- Confirmation nécessaire avant `push` et `tag`.
+- Toute modification impactant des éléments normatifs doit mettre à jour la documentation et le changelog.
+- Le flux de publication applique un garde de release (tests/doc/build/alignement version/changelog/tag, latest vs wip).
+
+---
+
+## Agents fondamentaux
+
+### Agent Fondation  (Responsable)
+
+#### Missions
+
+- Garantir la conformité éditoriale : français, pas d’exemples applicatifs, introduction/conclusion.
+- Vérifier la cohérence terminologique.
+
+#### Artefacts
+
+- Tous fichiers.
+
+---
+
+### Agent Structure  (Responsable)
+
+#### Missions
+
+- Maintenir l’arborescence canonique (incluant `.cursor/`, `.gitea/`, `scripts/`, `docs/SSH_UPDATE.md`).
+- Archiver le contenu obsolète dans `archive/` avec métadonnées.
+- Interdire toute suppression non tracée.
+
+#### Artefacts
+
+- `archive/`, `docs/**`, `tests/**`, `.cursor/**`, `.gitea/**`, `scripts/**`, `CHANGELOG.md`.
+
+---
+
+## Agents spécialisés documentation
+
+### Agent Documentation  (Responsable)
+
+#### Missions
+
+- Mettre à jour `docs/**` selon l’impact des changements.
+- Tenir `docs/INDEX.md` comme table des matières centrale.
+- Produire des REX techniques dans `archive/` en cas d’investigations multiples.
+
+#### Artefacts
+
+- `docs/**`, `README.md`, `archive/**`.
+
+---
+
+### Agent Données CSV  (Responsable)
+
+#### Missions
+
+- Traiter les CSV comme source des modèles de données (en-têtes multi-lignes inclus).
+- Exiger une définition complète de toutes les colonnes.
+- Corriger et documenter les incohérences de types.
+
+#### Artefacts
+
+- `docs/API.md`, `docs/ARCHITECTURE.md`, `docs/USAGE.md`.
+
+---
+
+### Agent Documents bureautiques  (Consulté)
+
+#### Missions
+
+- Lire `.docx` via `docx2txt`; proposer des alternatives en cas d’échec.
+- Documenter les imports dans `docs/INDEX.md`.
+
+#### Artefacts
+
+- `docs/**`, `archive/**`.
+
+---
+
+## Agents spécialisés tests
+
+### Agent Tests  (Responsable)
+
+#### Missions
+
+- Couvrir `unit`, `integration`, `connectivity`, `performance`, `external`.
+- Gérer `tests/logs` et `tests/reports`.
+- Exiger des tests verts avant commit.
+
+#### Artefacts
+
+- `tests/**`, `docs/TESTING.md`.
+
+---
+
+### Agent Performance  (Consulté)
+
+#### Missions
+
+- Réaliser des benchmarks reproductibles.
+- Valider l’impact performance avant fusion.
+
+#### Artefacts
+
+- `tests/performance/`, `tests/reports/`, `docs/TESTING.md`.
+
+---
+
+## Agents techniques
+
+### Agent Qualité technique  (Responsable)
+
+#### Missions
+
+- Définir et faire respecter les standards de qualité: lint, formatage, conventions de code, revues.
+- Superviser l’analyse statique (types, duplication, complexité, sécurité basique) et corriger les écarts.
+- Assurer l’exécution automatique des contrôles qualité dans la CI et bloquer en cas d’échec.
+
+#### Artefacts
+
+- `.gitea/workflows/ci.yml` (jobs de lint/format/type-check), `CHANGELOG.md`, `docs/ARCHITECTURE.md` (section standards).
+
+---
+
+### Agent Dépendances  (Responsable)
+
+#### Missions
+
+- Ajouter les dépendances manquantes lorsque justifié.
+- Vérifier les dernières versions stables.
+- Documenter les impacts dans `ARCHITECTURE.md`, `CONFIGURATION.md`, `CHANGELOG.md`.
+
+#### Artefacts
+
+- `docs/ARCHITECTURE.md`, `docs/CONFIGURATION.md`, `CHANGELOG.md`.
+
+---
+
+### Agent Compilation  (Responsable)
+
+#### Missions
+
+- Compiler très régulièrement et aux étapes critiques.
+- Bloquer toute progression en cas d’erreurs de build/runtime.
+
+#### Artefacts
+
+- Artefacts de build, scripts d’outillage.
+
+---
+
+### Agent Résolution  (Responsable)
+
+#### Missions
+
+- Conduire la boucle de diagnostic complète : reproduction minimale, logs, bissection, hypothèses, tests ciblés, correctif, non-régression.
+- Produire un REX quand plusieurs hypothèses ont été testées.
+
+#### Artefacts
+
+- `tests/**`, `archive/**`
+
+---
+
+### Agent SSH & scripts  (Responsable)
+
+#### Missions
+
+- Garantir la présence et l’usage correct de `scripts/auto-ssh-push.sh`, `scripts/init-ssh-env.sh`, `scripts/setup-ssh-ci.sh`.
+- Assurer permissions d’exécution, idempotence, journalisation non sensible, gestion d’erreurs robuste.
+- Interdire secrets en clair, gérer via secrets CI et variables d’environnement.
+- Exiger la mise à jour de `docs/SSH_UPDATE.md` à toute évolution des scripts ou des flux SSH.
+
+#### Artefacts
+
+- `scripts/**`, `.gitea/workflows/ci.yml`, `docs/SSH_UPDATE.md`, `docs/CONFIGURATION.md`, `CHANGELOG.md`.
+
+---
+
+## Agents frontend
+
+### Agent Frontend  (Responsable)
+
+#### Missions
+
+- Mettre en place `React.lazy`/`Suspense` (code splitting).
+- Centraliser l’état (Redux ou Context API).
+- Abstraire les services de données.
+
+#### Artefacts
+
+- `docs/ARCHITECTURE.md`, `docs/TESTING.md`.
+
+---
+
+## Agents open source et CI
+
+### Agent Open Source  (Responsable)
+
+#### Missions
+
+- Maintenir : `LICENSE`, `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md`, `docs/OPEN_SOURCE_CHECKLIST.md`.
+- Vérifier l’alignement continu avec `4NK_node`.
+
+#### Artefacts
+
+- Fichiers de gouvernance cités ci-dessus.
+
+---
+
+### Agent Gitea  (Responsable)
+
+#### Missions
+
+- Garantir `.gitea/ISSUE_TEMPLATE/*`, `PULL_REQUEST_TEMPLATE.md`, `.gitea/workflows/ci.yml`.
+- Documenter la configuration distante dans `docs/GITEA_SETUP.md`.
+- Déclencher les étapes CI pertinentes (tests, lint, sécurité, vérifs `scripts/`).
+
+#### Artefacts
+
+- `.gitea/**`, `docs/GITEA_SETUP.md`.
+
+---
+
+### Agent Versionnage  (Responsable)
+
+#### Missions
+
+- Tenir `CHANGELOG.md` comme source unique de vérité.
+- Proposer un bump sémantique justifié.
+- Demander confirmation avant push et tag.
+- Orchestrer le `release-guard` (CI + scripts) et consigner latest vs wip.
+
+#### Artefacts
+
+- `CHANGELOG.md`, `docs/RELEASE_PLAN.md`, `docs/ROADMAP.md`.
+
+---
+
+### Agent Sécurité  (Responsable)
+
+#### Missions
+
+- Assurer une vigilance continue sécurité sur le code, la config et la CI.
+- Orchestrer l’audit de sécurité automatisé: `scripts/security/audit.sh` (cargo audit, npm audit, scan secrets).
+- Interdire l’introduction de secrets en clair et exiger la rotation des secrets CI.
+- Valider les permissions sensibles (clés, cookies, conf) et la non-exposition d’endpoints privés.
+- Bloquer toute release si l’audit de sécurité échoue (intégré au `release-guard`).
+
+#### Artefacts
+
+- `scripts/security/audit.sh`, `.gitea/workflows/ci.yml` (job `security-audit`), `docs/SECURITY_AUDIT.md`, `docs/CONFIGURATION.md`.
+
+---
+
+### Agent Déploiement  (Responsable)
+
+#### Missions
+
+- Définir et documenter la stratégie de déploiement (environnements, prérequis, secrets, rollbacks).
+- Vérifier la présence et la cohérence des artefacts de déploiement et des variables d’environnement requises.
+- Intégrer des contrôles CI « deployment-checks » avant toute release; coordonner avec `release-guard`.
+
+#### Artefacts
+
+- `docs/DEPLOYMENT.md`, `.gitea/workflows/ci.yml` (job `deployment-checks`), `CHANGELOG.md`, `docs/RELEASE_PLAN.md`.
+
+---
+
+### Agent Gouvernance du Template  (Accountable)
+
+#### Missions
+
+- Garantir la cohérence d’ensemble du template (règles Cursor, CI, scripts, docs).
+- Examiner les issues « Template Feedback », arbitrer et prioriser.
+- Orchestrer la montée de version du template (`TEMPLATE_VERSION`) et le `CHANGELOG.md`.
+- Communiquer les changements aux projets consommateurs.
+
+#### Artefacts
+
+- `.cursor/rules/**`, `.gitea_template/**`, `docs/TEMPLATE_*`, `TEMPLATE_VERSION`, `CHANGELOG.md`.
+
+---
+
+### Agent Adaptation Projet  (Responsable)
+
+#### Missions
+
+- Accompagner l’adaptation locale du template (CI, docs, `AGENTS.md`).
+- S’assurer que `security-audit` et `release-guard` ne sont pas retirés.
+- Remonter en feedback toute amélioration générique.
+
+#### Artefacts
+
+- `.gitea/workflows/ci.yml`, `docs/INDEX.md`, `docs/SECURITY_AUDIT.md`, `AGENTS.md`, `LOCAL_OVERRIDES.yml` (si utilisé).
+
+---
+
+## Agents de synchronisation et dérogations
+
+### Agent Synchronisation de template  (Accountable)
+
+#### Références
+
+- `.4nk-sync.yml` (manifeste), `TEMPLATE_VERSION` (pointeur), `.gitea/workflows/template-sync.yml` (CI dédiée).
+- Règles Cursor : `.cursor/rules/42-template-sync.mdc` et `.cursor/rules/10-project-structure.mdc`.
+
+#### Missions
+
+- Assurer l’alignement automatique sur le template pour : `.cursor/**`, `.gitea/**`, `AGENTS.md`, `scripts/**`, `docs/SSH_UPDATE.md`.
+- Déclencher/valider la PR `[template-sync]` créée par la CI.
+- Exiger la mise à jour de `CHANGELOG.md` et `docs/INDEX.md` après synchronisation.
+- Vérifier l’intégrité (`manifest_checksum`, checksums de fichiers si publiés), les permissions, l’absence de secrets.
+- Mettre à jour `TEMPLATE_VERSION` dans la PR.
+
+#### Artefacts
+
+- `.4nk-sync.yml`, `TEMPLATE_VERSION`, `.cursor/**`, `.gitea/**`, `AGENTS.md`, `scripts/**`, `docs/SSH_UPDATE.md`, `CHANGELOG.md`.
+
+---
+
+### Agent Dérogations locales  (Responsable)
+
+#### Références
+
+- `LOCAL_OVERRIDES.yml` (facultatif, mais recommandé).
+
+#### Missions
+
+- Enregistrer toute divergence locale dans le périmètre synchronisé (path, raison, propriétaire, échéance).
+- Faire respecter : seules les dérogations listées et non expirées sont tolérées par la CI.
+- Auditer périodiquement et résorber les dérogations.
+
+#### Artefacts
+
+- `LOCAL_OVERRIDES.yml`, `CHANGELOG.md` (mentionner les dérogations significatives).
+
+---
+
+## Matrice de coordination
+
+| Type de changement               | Agents impliqués                                                                                                     | Artefacts principaux                                                                                                                | Validation obligatoire |
+|----------------------------------|----------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|------------------------|
+| Ajout de fonctionnalité          | Documentation, Tests, Dépendances, Frontend                                                                          | `docs/API.md`, `docs/USAGE.md`, `docs/ARCHITECTURE.md`, `tests/unit`, `tests/integration`, `CHANGELOG.md` (*Added*)                 | Oui |
+| Correction de bug                | Résolution, Tests, Documentation                                                                                      | `tests/unit`, `docs/TESTING.md`, `archive/` (REX si nécessaire), `CHANGELOG.md` (*Fixed*)                                            | Oui |
+| Refactorisation / amélioration   | Structure, Documentation, Compilation                                                                                 | `docs/ARCHITECTURE.md`, `archive/`, `CHANGELOG.md` (*Changed*)                                                                      | Oui |
+| Dépendance ajoutée/mise à jour   | Dépendances, Compilation, Documentation                                                                               | `docs/ARCHITECTURE.md`, `docs/CONFIGURATION.md`, `CHANGELOG.md` (*Dependencies*)                                                    | Oui |
+| Données CSV modifiées            | Données CSV, Documentation, Tests                                                                                     | `docs/API.md`, `docs/ARCHITECTURE.md`, `docs/USAGE.md`, `tests/unit`, `CHANGELOG.md` (*Data model update*)                          | Oui |
+| Migration / breaking change      | Documentation, Tests, Résolution, Versionnage                                                                         | `docs/MIGRATION.md`, `docs/INSTALLATION.md`, `docs/RELEASE_PLAN.md`, `docs/ROADMAP.md`, `tests/integration`, `CHANGELOG.md` (*Breaking*) | Oui |
+| Sécurité / audit                 | Documentation, Tests, Open Source, Sécurité proactive                                                                 | `docs/SECURITY_AUDIT.md`, `tests/external`, `tests/connectivity`, `CHANGELOG.md` (*Security*)                                        | Oui |
+| Préparation open source / CI     | Open Source, Gitea, Versionnage, Documentation communautaire, Contributeurs externes                                  | `.gitea/**`, `docs/GITEA_SETUP.md`, `docs/OPEN_SOURCE_CHECKLIST.md`, `CHANGELOG.md` (*CI/CD* / *Governance*)                        | Oui |
+| Optimisation performance         | Performance, Tests, Documentation                                                                                     | `tests/performance`, `tests/reports`, `docs/ARCHITECTURE.md`, `CHANGELOG.md` (*Performance*)                                         | Oui |
+| Évolution frontend               | Frontend, Documentation, Tests                                                                                        | `docs/ARCHITECTURE.md`, `docs/USAGE.md`, `tests/integration`, `CHANGELOG.md` (*Frontend*)                                           | Oui |
+| Évolution CI/CD ou scripts SSH   | SSH & scripts, Gitea, Versionnage, Documentation                                                                      | `scripts/**`, `.gitea/workflows/ci.yml`, `docs/SSH_UPDATE.md`, `docs/CONFIGURATION.md`, `CHANGELOG.md` (*CI/CD*)                     | Oui |
+| Déploiement                      | Déploiement, Versionnage, Sécurité, Documentation                                                                     | `docs/DEPLOYMENT.md`, `.gitea/workflows/ci.yml` (deployment-checks), `CHANGELOG.md` (*Deployment*)                                   | Oui |
+| **Synchronisation de template**  | **Synchronisation de template**, Gitea, Versionnage, Structure, Documentation, SSH & scripts                          | `.4nk-sync.yml`, `TEMPLATE_VERSION`, `.cursor/**`, `.gitea/**`, `AGENTS.md`, `scripts/**`, `docs/SSH_UPDATE.md`, `CHANGELOG.md`       | **Oui** |
+| Dérogation locale contrôlée      | Dérogations locales, Gitea, Synchronisation de template, Versionnage                                                  | `LOCAL_OVERRIDES.yml`, `CHANGELOG.md` (mention), CI tolérante uniquement sur chemins listés et non expirés                           | Oui |
+
+---
+
+## Requetes complexes
+
+Quand tu fais une commande ou un requète complexe, explique là avant de la lancer.
+
+## Conclusion
+
+Ce `AGENTS.md` mis à jour introduit l’**Agent Synchronisation de template** et l’**Agent Dérogations locales**, renforce l’**Agent SSH & scripts**, et rattache l’ensemble aux règles Cursor et à la CI Gitea.
+
+La matrice de coordination formalise les validations obligatoires pour chaque type de changement, garantissant cohérence structurelle, qualité documentaire, sécurité, traçabilité.
+Ainsi que la stabilité à long terme sur tous les projets issus de `4NK_project_template`.
+
+---
+
+## Exécution locale et neutralisation de la CI
+
+- Les contrôles CI peuvent être remplacés par l’exécution locale des agents: `scripts/agents/run.sh` avec `AUTO_FIX=1`, `SCOPE=changed|all`.
+- La CI peut être neutralisée par défaut via `CI_SKIP=true` dans le workflow; ponctuellement via des commits `[skip ci]`.
+- Des hooks sont fournis pour automatiser le flux local:
+  - `scripts/local/precommit.sh` et `scripts/local/prepush.sh`
+  - installation: `bash scripts/local/install_hooks.sh`
+- Un conteneur unifié (runner+agents) permet une exécution reproductible: `docker-compose.ci.yml`.
--- a/CODE_OF_CONDUCT.md
+++ b/CODE_OF_CONDUCT.md
@ -0,0 +1,93 @@
+# Code de Conduite - 4NK Node
+
+## Notre Engagement
+
+Dans l'intérêt de favoriser un environnement ouvert et accueillant, nous, en tant que contributeurs et mainteneurs, nous engageons à faire de la participation à notre projet et à notre communauté une expérience sans harcèlement pour tous, peu importe l'âge, la taille, le handicap, l'ethnicité, les caractéristiques sexuelles, l'identité et l'expression de genre, le niveau d'expérience, l'éducation, le statut socio-économique, la nationalité, l'apparence personnelle, la race, la religion ou l'identité et l'orientation sexuelles.
+
+## Nos Standards
+
+Exemples de comportements qui contribuent à créer un environnement positif :
+
+* Utiliser un langage accueillant et inclusif
+* Respecter les différents points de vue et expériences
+* Accepter gracieusement les critiques constructives
+* Se concentrer sur ce qui est le mieux pour la communauté
+* Faire preuve d'empathie envers les autres membres de la communauté
+
+Exemples de comportements inacceptables :
+
+* L'utilisation de langage ou d'imagerie sexualisés et d'attention ou d'avances sexuelles non désirées
+* Le trolling, les commentaires insultants/désobligeants et les attaques personnelles ou politiques
+* Le harcèlement public ou privé
+* Publier les informations privées d'autres personnes, telles que des adresses physiques ou électroniques, sans permission explicite
+* Autres comportements qui pourraient raisonnablement être considérés comme inappropriés dans un contexte professionnel
+
+## Nos Responsabilités
+
+Les mainteneurs du projet sont responsables de clarifier les standards de comportement acceptable et sont censés prendre des mesures correctives appropriées et équitables en réponse à tout cas de comportement inacceptable.
+
+Les mainteneurs du projet ont le droit et la responsabilité de supprimer, modifier ou rejeter les commentaires, commits, code, modifications de wiki, questions et autres contributions qui ne sont pas alignés avec ce Code de Conduite, et de bannir temporairement ou définitivement tout contributeur pour d'autres comportements qu'ils jugent inappropriés, menaçants, offensants ou nuisibles.
+
+## Portée
+
+Ce Code de Conduite s'applique à la fois dans les espaces du projet et dans les espaces publics lorsqu'un individu représente le projet ou sa communauté. Des exemples de représentation du projet ou de la communauté incluent l'utilisation d'une adresse email officielle du projet, la publication via un compte de média social officiel, ou l'action en tant que représentant désigné lors d'un événement en ligne ou hors ligne. La représentation du projet peut être davantage définie et clarifiée par les mainteneurs du projet.
+
+## Application
+
+Les cas de comportement abusif, harcelant ou autrement inacceptable peuvent être signalés en contactant l'équipe du projet à contact@4nkweb5.com. Toutes les plaintes seront examinées et enquêtées et se traduiront par une réponse jugée nécessaire et appropriée aux circonstances. L'équipe du projet est obligée de maintenir la confidentialité concernant le rapporteur d'un incident. Plus de détails sur les politiques d'application spécifiques peuvent être publiés séparément.
+
+Les mainteneurs du projet qui ne suivent pas ou n'appliquent pas le Code de Conduite de bonne foi peuvent faire face à des répercussions temporaires ou permanentes déterminées par d'autres membres de la direction du projet.
+
+## Attribution
+
+Ce Code de Conduite est adapté du [Contributor Covenant](https://www.contributor-covenant.org), version 2.0, disponible à https://www.contributor-covenant.org/fr/version/2/0/code_of_conduct.html.
+
+## Contact
+
+Pour signaler un problème ou poser des questions concernant ce Code de Conduite, vous pouvez :
+
+* Créer une issue privée sur le repository
+* Contacter l'équipe de maintenance via les canaux officiels
+* Utiliser les canaux de discussion du projet
+
+## Équipe de Modération
+
+L'équipe de modération est composée des mainteneurs principaux du projet qui s'engagent à :
+
+* Traiter tous les signalements avec impartialité
+* Maintenir la confidentialité des rapports
+* Prendre des mesures appropriées et équitables
+* Documenter les décisions prises
+* Améliorer continuellement le processus
+
+## Processus de Signalement
+
+1. **Signalement** : Contactez l'équipe via les canaux appropriés
+2. **Accusé de réception** : Vous recevrez une confirmation dans les 48h
+3. **Enquête** : L'équipe examinera le signalement
+4. **Décision** : Une décision sera prise et communiquée
+5. **Appel** : Possibilité de faire appel de la décision
+
+## Mesures Correctives
+
+Les mesures correctives peuvent inclure :
+
+* Avertissement privé
+* Avertissement public
+* Suspension temporaire
+* Bannissement permanent
+* Suppression de contenu inapproprié
+
+## Engagement envers l'Amélioration
+
+Nous nous engageons à :
+
+* Réviser régulièrement ce Code de Conduite
+* Solliciter les retours de la communauté
+* Améliorer les processus de modération
+* Former l'équipe de modération
+* Maintenir un environnement sain et inclusif
+
+---
+
+**Merci de contribuer à maintenir 4NK Node comme un projet accueillant et inclusif !** 🌟
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@ -0,0 +1,371 @@
+# Guide de Contribution - 4NK Node
+
+Merci de votre intérêt pour contribuer au projet 4NK Node ! Ce guide vous aidera à comprendre comment participer au développement de cette infrastructure pour les paiements silencieux Bitcoin.
+
+## 📋 Table des Matières
+
+- [🎯 Comment Contribuer] (#comment-contribuer)
+- [🚀 Premiers Pas] (#premiers-pas)
+- [🔧 Environnement de Développement] (#environnement-de-developpement)
+- [📝 Processus de Contribution] (#processus-de-contribution)
+- [🧪 Tests] (#tests)
+- [📚 Documentation] (#documentation)
+- [🐛 Signaler un Bug] (#signaler-un-bug)
+- [💡 Proposer une Fonctionnalité] (#proposer-une-fonctionnalite)
+- [🔍 Code Review] (#code-review)
+- [📦 Release] (#release)
+
+## 🎯 Comment Contribuer
+
+### Types de Contributions
+
+Nous accueillons différents types de contributions :
+
+- **🐛 Bug fixes** - Correction de bugs et problèmes
+- **✨ Nouvelles fonctionnalités** - Ajout de nouvelles capacités
+- **📚 Documentation** - Amélioration de la documentation
+- **🧪 Tests** - Ajout ou amélioration des tests
+- **🔧 Outils** - Amélioration des scripts et outils
+- **🌐 Traductions** - Traduction de la documentation
+- **📊 Performance** - Optimisations de performance
+- **🔒 Sécurité** - Améliorations de sécurité
+
+### Niveaux de Contribution
+
+- **Débutant** - Documentation, tests, petits bugs
+- **Intermédiaire** - Nouvelles fonctionnalités, améliorations
+- **Avancé** - Architecture, optimisations majeures
+
+## 🚀 Premiers Pas
+
+### Prérequis
+
+- **Docker** et **Docker Compose** installés
+- **Git** configuré
+- **Python 3.8+** (pour les tests)
+- **Rust** (pour le développement sdk_relay)
+- **Connexion Internet** stable
+
+### Fork et Clone
+
+```bash
+# 1. Fork le repository sur Gitea
+# 2. Clone votre fork
+git clone https://git.4nkweb.com/votre-username/4NK_node.git
+cd 4NK_node
+
+# 3. Ajouter le repository original comme upstream
+git remote add upstream https://git.4nkweb.com/4nk/4NK_node.git
+```
+
+### Branches
+
+```bash
+# Créer une branche pour votre contribution
+git checkout -b feature/nom-de-votre-feature
+# ou
+git checkout -b fix/nom-du-bug
+```
+
+## 🔧 Environnement de Développement
+
+### Installation Locale
+
+```bash
+# 1. Cloner le repository
+git clone https://git.4nkweb.com/4nk/4NK_node.git
+cd 4NK_node
+
+# 2. Démarrer l'infrastructure
+./restart_4nk_node.sh
+
+# 3. Vérifier que tout fonctionne
+docker ps
+```
+
+### Configuration de Développement
+
+```bash
+# Variables d'environnement pour le développement
+export RUST_LOG=debug
+export ENABLE_SYNC_TEST=1
+export BITCOIN_NETWORK=signet
+```
+
+### Outils de Développement
+
+```bash
+# Tests
+./tests/run_all_tests.sh
+
+# Linting (si configuré)
+cargo clippy
+rustfmt src/
+
+# Build
+docker-compose build
+```
+
+## 📝 Processus de Contribution
+
+### 1. Planifier Votre Contribution
+
+- [ ] Vérifier les issues existantes
+- [ ] Créer une issue si nécessaire
+- [ ] Discuter de l'approche avec l'équipe
+- [ ] Planifier les tests et la documentation
+
+### 2. Développer
+
+- [ ] Créer une branche depuis `main`
+- [ ] Développer votre fonctionnalité
+- [ ] Ajouter des tests
+- [ ] Mettre à jour la documentation
+- [ ] Vérifier que les tests passent
+
+### 3. Soumettre
+
+- [ ] Commiter avec des messages clairs
+- [ ] Pousser vers votre fork
+- [ ] Créer une Pull Request
+- [ ] Remplir le template de PR
+
+### Messages de Commit
+
+Utilisez le format conventionnel :
+
+```bash
+# Format
+type(scope): description
+
+# Exemples
+feat(sdk_relay): add new sync type for metrics
+fix(bitcoin): resolve connection timeout issue
+docs(api): update WebSocket message format
+test(integration): add multi-relay sync tests
+```
+
+#### Types
+
+- `feat` - Nouvelle fonctionnalité
+- `fix` - Correction de bug
+- `docs` - Documentation
+- `style` - Formatage
+- `refactor` - Refactoring
+- `test` - Tests
+- `chore` - Maintenance
+
+## 🧪 Tests
+
+### Exécuter les Tests
+
+```bash
+# Tous les tests
+./tests/run_all_tests.sh
+
+# Tests par catégorie
+./tests/run_unit_tests.sh
+./tests/run_integration_tests.sh
+./tests/run_connectivity_tests.sh
+./tests/run_external_tests.sh
+
+# Tests avec debug
+./tests/run_all_tests.sh --debug
+```
+
+### Ajouter des Tests
+
+```bash
+# Structure recommandée
+tests/
+├── unit/           # Tests unitaires
+├── integration/    # Tests d'intégration
+├── connectivity/   # Tests de connectivité
+├── external/       # Tests externes
+└── performance/    # Tests de performance
+```
+
+### Bonnes Pratiques
+
+- Testez tous les cas d'usage
+- Incluez des tests d'erreur
+- Maintenez une couverture > 80%
+- Utilisez des données de test réalistes
+
+## 📚 Documentation
+
+### Mise à Jour de la Documentation
+
+```bash
+# Structure de la documentation
+docs/
+├── INSTALLATION.md    # Guide d'installation
+├── USAGE.md          # Guide d'utilisation
+├── CONFIGURATION.md  # Guide de configuration
+├── ARCHITECTURE.md   # Architecture technique
+├── API.md           # Référence API
+├── TESTING.md       # Guide des tests
+└── INDEX.md         # Index principal
+```
+
+### Standards de Documentation
+
+- Utilisez le Markdown
+- Incluez des exemples de code
+- Ajoutez des diagrammes si nécessaire
+- Maintenez la cohérence du style
+- Traduisez en anglais si possible
+
+## 🐛 Signaler un Bug
+
+### Template de Bug Report
+
+```markdown
+## Description du Bug
+
+Description claire et concise du problème.
+
+## Étapes pour Reproduire
+
+1. Aller à '...'
+2. Cliquer sur '...'
+3. Faire défiler jusqu'à '...'
+4. Voir l'erreur
+
+## Comportement Attendu
+
+Description de ce qui devrait se passer.
+
+## Comportement Actuel
+
+Description de ce qui se passe actuellement.
+
+## Informations Système
+
+- OS: [ex: Ubuntu 20.04]
+- Docker: [ex: 20.10.0]
+- Version: [ex: v1.0.0]
+
+## Logs
+
+```text
+Logs pertinents ici
+```
+
+## Capture d'Écran
+
+Si applicable, ajoutez une capture d'écran.
+
+## Contexte Supplémentaire
+
+Toute autre information pertinente.
+
+## 💡 Proposer une Fonctionnalité
+
+### Template de Feature Request
+
+```markdown
+## Résumé
+
+Description claire et concise de la fonctionnalité souhaitée.
+
+## Motivation
+
+Pourquoi cette fonctionnalité est-elle nécessaire ?
+
+## Proposition
+
+Description détaillée de la fonctionnalité proposée.
+
+## Alternatives Considérées
+
+Autres solutions envisagées.
+
+## Impact
+
+Impact sur les utilisateurs et l'architecture.
+
+## Exemples d'Utilisation
+
+Comment cette fonctionnalité serait-elle utilisée ?
+
+## 🔍 Code Review
+
+### Processus de Review
+
+1. **Automatique** - Tests et linting
+2. **Review par l'équipe** - Code review manuel
+3. **Tests d'intégration** - Validation complète
+4. **Approbation** - Merge dans main
+
+### Critères de Review
+
+- [ ] Code fonctionnel et testé
+- [ ] Tests ajoutés/modifiés
+- [ ] Documentation mise à jour
+- [ ] Pas de régression
+- [ ] Performance acceptable
+- [ ] Sécurité vérifiée
+
+### Répondre aux Reviews
+
+- Répondez poliment aux commentaires
+- Apportez les modifications demandées
+- Demandez des clarifications si nécessaire
+- Re-merguez après les corrections
+
+## 📦 Release
+
+### Processus de Release
+
+1. **Préparation** - Finaliser les fonctionnalités
+2. **Tests** - Tests complets
+3. **Documentation** - Mise à jour des docs
+4. **Tag** - Créer un tag de version
+5. **Release** - Publier sur GitHub/GitLab
+6. **Annonce** - Communiquer la release
+
+### Numérotation des Versions
+
+Utilisez le [Semantic Versioning](https://semver.org/) :
+
+- **MAJOR** - Changements incompatibles
+- **MINOR** - Nouvelles fonctionnalités compatibles
+- **PATCH** - Corrections de bugs compatibles
+
+## 🤝 Communauté
+
+### Communication
+
+- **Issues** - Pour les bugs et fonctionnalités
+- **Discussions** - Pour les questions générales (via les issues)
+- **Pull Requests** - Pour les contributions
+- **Wiki** - Pour la documentation collaborative (si activé sur Gitea)
+
+### Code de Conduite
+
+- Soyez respectueux et inclusif
+- Écoutez les autres points de vue
+- Contribuez de manière constructive
+- Respectez les standards du projet
+
+### Reconnaissance
+
+- Les contributeurs sont listés dans le README
+- Les contributions significatives sont reconnues
+- Les releases mentionnent les contributeurs
+
+## 🆘 Besoin d'Aide ?
+
+- Consultez la [documentation](docs/)
+- Vérifiez les [issues existantes](https://git.4nkweb.com/4nk/4NK_node/issues)
+- Posez une question via les [issues](https://git.4nkweb.com/4nk/4NK_node/issues/new)
+- Contactez l'équipe de maintenance
+
+## 📄 Licence
+
+En contribuant, vous acceptez que vos contributions soient sous la même licence que le projet (MIT).
+
+---
+
+Merci de contribuer à 4NK Node ! 🚀
--- a/21
+++ b/21
@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 4NK Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
--- a/SECURITY.md
+++ b/SECURITY.md
@ -0,0 +1,257 @@
+# Politique de Sécurité - 4NK Node
+
+## 🛡️ Signalement de Vulnérabilités
+
+Nous prenons la sécurité très au sérieux. Si vous découvrez une vulnérabilité de sécurité, nous vous demandons de la signaler de manière responsable.
+
+### Comment Signaler une Vulnérabilité
+
+**NE PAS** créer d'issue publique pour les vulnérabilités de sécurité.
+
+#### À la place
+
+1. Envoyez un email à [security@4nkweb.com](mailto:security@4nkweb.com)
+2. Incluez "SECURITY VULNERABILITY" dans l'objet
+3. Décrivez la vulnérabilité de manière détaillée
+4. Incluez les étapes pour reproduire le problème
+5. Proposez une solution si possible
+
+### Ce que nous attendons
+
+- **Confidentialité** : Ne divulguez pas la vulnérabilité publiquement
+- **Détails** : Fournissez suffisamment d'informations pour reproduire le problème
+- **Patience** : Nous examinerons et répondrons dans les 48h
+- **Coopération** : Nous pouvons avoir besoin de clarifications
+
+### Ce que vous pouvez attendre
+
+- **Réponse rapide** : Accusé de réception dans les 48h
+- **Évaluation** : Analyse de la vulnérabilité
+- **Mise à jour** : Statut de la correction
+- **Reconnaissance** : Mention dans les remerciements (si souhaité)
+
+## 🔒 Bonnes Pratiques de Sécurité
+
+### Pour les Contributeurs
+
+#### Code
+
+- Validez toutes les entrées utilisateur
+- Utilisez des requêtes préparées pour les bases de données
+- Évitez les injections de code
+- Implémentez l'authentification appropriée
+- Utilisez HTTPS pour toutes les communications
+
+#### Configuration
+
+- Ne committez jamais de secrets
+- Utilisez des variables d'environnement pour les données sensibles
+- Vérifiez les permissions des fichiers
+- Maintenez les dépendances à jour
+
+#### Tests
+
+- Incluez des tests de sécurité
+- Testez les cas limites
+- Validez les entrées malveillantes
+- Vérifiez les fuites de mémoire
+
+### Pour les Utilisateurs
+
+#### Installation
+
+- Utilisez des sources officielles
+- Vérifiez les checksums
+- Maintenez le système à jour
+- Utilisez un pare-feu
+
+#### Configuration
+
+- Changez les mots de passe par défaut
+- Utilisez des clés SSH fortes
+- Limitez l'accès réseau
+- Surveillez les logs
+
+#### Opération
+
+- Surveillez les connexions
+- Sauvegardez régulièrement
+- Testez les sauvegardes
+- Documentez les incidents
+
+## 🔍 Audit de Sécurité
+
+### Composants Principaux
+
+#### Bitcoin Core
+
+- **RPC Interface** : Authentification requise
+- **ZMQ** : Communication locale uniquement
+- **P2P** : Validation des blocs
+- **Wallet** : Chiffrement des clés
+
+#### Blindbit
+
+- **API HTTP** : Validation des entrées
+- **Filtres** : Vérification des signatures
+- **Cache** : Protection contre les attaques DoS
+- **Logs** : Pas d'informations sensibles
+
+#### SDK Relay
+
+- **WebSocket** : Validation des messages
+- **Synchronisation** : Authentification des pairs
+- **Cache** : Protection contre les attaques
+- **Configuration** : Validation des paramètres
+
+#### Tor
+
+- **Proxy** : Configuration sécurisée
+- **Contrôle** : Accès restreint
+- **Logs** : Anonymisation
+- **Mise à jour** : Versions récentes
+
+### Tests de Sécurité
+
+#### Tests Automatisés
+
+```bash
+# Tests de sécurité
+./tests/run_security_tests.sh
+
+# Vérification des vulnérabilités
+./tests/check_vulnerabilities.sh
+
+# Audit des dépendances
+./tests/audit_dependencies.sh
+```
+
+#### Tests Manuels
+
+- Tests de pénétration
+- Audit de code
+- Tests de configuration
+- Tests de performance sous charge
+
+## 🚨 Réponse aux Incidents
+
+### Procédure d'Urgence
+
+1. **Détection** : Identifier l'incident
+2. **Containment** : Limiter l'impact
+3. **Éradication** : Supprimer la cause
+4. **Récupération** : Restaurer les services
+5. **Post-mortem** : Analyser et améliorer
+
+### Communication
+
+- **Interne** : Équipe de sécurité
+- **Utilisateurs** : Notification appropriée
+- **Communauté** : Disclosure responsable
+- **Autorités** : Si nécessaire
+
+### Documentation
+
+- **Incident Report** : Détails de l'incident
+- **Timeline** : Chronologie des événements
+- **Actions** : Mesures prises
+- **Lessons Learned** : Améliorations
+
+## 📋 Checklist de Sécurité
+
+### Avant le Déploiement
+
+- [ ] Audit de code de sécurité
+- [ ] Tests de vulnérabilités
+- [ ] Vérification des dépendances
+- [ ] Configuration sécurisée
+- [ ] Tests de charge
+
+### Pendant l'Opération
+
+- [ ] Monitoring de sécurité
+- [ ] Surveillance des logs
+- [ ] Mise à jour des composants
+- [ ] Sauvegarde des données
+- [ ] Tests de récupération
+
+### Après un Incident
+
+- [ ] Analyse post-mortem
+- [ ] Mise à jour des procédures
+- [ ] Formation de l'équipe
+- [ ] Amélioration des outils
+- [ ] Communication à la communauté
+
+## 🔧 Outils de Sécurité
+
+### Monitoring
+
+- **Logs** : Centralisation et analyse
+- **Métriques** : Surveillance en temps réel
+- **Alertes** : Notification automatique
+- **Tableaux de bord** : Vue d'ensemble
+
+### Tests
+
+- **SAST** : Analyse statique
+- **DAST** : Tests dynamiques
+- **IAST** : Tests interactifs
+- **Fuzzing** : Tests de robustesse
+
+### Protection
+
+- **WAF** : Pare-feu applicatif
+- **IDS/IPS** : Détection d'intrusion
+- **Antivirus** : Protection des endpoints
+- **Chiffrement** : Protection des données
+
+## 📚 Ressources
+
+### Documentation
+
+- [Guide de Sécurité Bitcoin](https://bitcoin.org/en/security)
+- [OWASP Top 10](https://owasp.org/www-project-top-ten/)
+- [CWE/SANS Top 25](https://cwe.mitre.org/top25/)
+- [NIST Cybersecurity Framework](https://www.nist.gov/cyberframework)
+
+### Outils
+
+- [Bandit](https://bandit.readthedocs.io/) - Analyse Python
+- [Clang Static Analyzer](https://clang-analyzer.llvm.org/) - Analyse C/C++
+- [SonarQube](https://www.sonarqube.org/) - Qualité du code
+- [OpenVAS](https://www.openvas.org/) - Scan de vulnérabilités
+
+### Formation
+
+- Cours de sécurité applicative
+- Formation aux tests de pénétration
+- Certification en cybersécurité
+- Participation à des CTF
+
+## 🤝 Collaboration
+
+### Bug Bounty
+
+- Programme de récompenses pour les vulnérabilités
+- Critères d'éligibilité
+- Montants des récompenses
+- Processus de validation
+
+### Responsible Disclosure
+
+- Timeline de divulgation
+- Coordination avec les chercheurs
+- Communication publique
+- Remerciements
+
+### Communauté
+
+- Groupe de sécurité
+- Discussions techniques
+- Partage d'informations
+- Collaboration avec d'autres projets
+
+---
+
+**La sécurité est une responsabilité partagée. Merci de contribuer à maintenir 4NK Node sécurisé !** 🔒
--- a/1
+++ b/1
@ -0,0 +1 @@
+v2025.08.5
--- a/docs/INDEX.md
+++ b/docs/INDEX.md
@ -0,0 +1,11 @@
+# Documentation du projet
+
+Cette table des matières oriente vers:
+- Documentation spécifique au projet: `docs/project/`
+- Modèles génériques à adapter: `docs/templates/`
+
+## Sommaire
+- À personnaliser: `docs/project/README.md`, `docs/project/INDEX.md`, `docs/project/ARCHITECTURE.md`, `docs/project/USAGE.md`, etc.
+
+## Modèles génériques
+- Voir: `docs/templates/`
--- a/docs/templates/API.md
+++ b/docs/templates/API.md
@ -0,0 +1,8 @@
+# Référence API — Template
+
+- Vue d’ensemble
+- Authentification/permissions
+- Endpoints par domaine (schémas, invariants)
+- Codes d’erreur
+- Limites et quotas
+- Sécurité et conformité
--- a/docs/templates/ARCHITECTURE.md
+++ b/docs/templates/ARCHITECTURE.md
@ -0,0 +1,8 @@
+# Architecture — Template
+
+- Contexte et objectifs
+- Découpage en couches (UI, services, données)
+- Flux principaux
+- Observabilité
+- CI/CD
+- Contraintes et SLA
--- a/docs/templates/CONFIGURATION.md
+++ b/docs/templates/CONFIGURATION.md
@ -0,0 +1,6 @@
+# Configuration — Template
+
+- Variables d’environnement (nom, type, défaut, portée)
+- Fichiers de configuration (format, validation)
+- Réseau et sécurité (ports, TLS, auth)
+- Observabilité (logs, métriques, traces)
--- a/docs/templates/INDEX.md
+++ b/docs/templates/INDEX.md
@ -0,0 +1,12 @@
+# Index — Templates de documentation (pour projets dérivés)
+
+Utilisez ces squelettes pour démarrer la documentation de votre projet.
+
+- API.md — squelette de référence API
+- ARCHITECTURE.md — squelette d’architecture
+- CONFIGURATION.md — squelette de configuration
+- USAGE.md — squelette d’usage
+- TESTING.md — squelette de stratégie de tests
+- SECURITY_AUDIT.md — squelette d’audit sécurité
+- RELEASE_PLAN.md — squelette de plan de release
+- OPEN_SOURCE_CHECKLIST.md — squelette de checklist open source
--- a/docs/templates/OPEN_SOURCE_CHECKLIST.md
+++ b/docs/templates/OPEN_SOURCE_CHECKLIST.md
@ -0,0 +1,7 @@
+# Checklist open source — Template
+
+- Gouvernance: LICENSE, CONTRIBUTING, CODE_OF_CONDUCT
+- CI/CD: workflows, tests, security-audit, release-guard
+- Documentation: README, INDEX, guides essentiels
+- Sécurité: secrets, permissions, audit
+- Publication: tag, changelog, release notes
--- a/docs/templates/README.md
+++ b/docs/templates/README.md
@ -0,0 +1,29 @@
+# README — Template de projet
+
+## Présentation
+
+Décrivez brièvement l’objectif du projet, son périmètre et ses utilisateurs cibles.
+
+## Démarrage rapide
+
+- Prérequis (langages/outils)
+- Étapes d’installation
+- Commandes de démarrage
+
+## Documentation
+
+- Index: `docs/INDEX.md`
+- Architecture: `docs/ARCHITECTURE.md`
+- Configuration: `docs/CONFIGURATION.md`
+- Tests: `docs/TESTING.md`
+- Sécurité: `docs/SECURITY_AUDIT.md`
+- Déploiement: `docs/DEPLOYMENT.md`
+
+## Contribution
+
+- GUIDE: `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md`
+- Processus de PR et revues
+
+## Licence
+
+- Indiquez la licence choisie (MIT/Apache-2.0/GPL)
--- a/docs/templates/RELEASE_PLAN.md
+++ b/docs/templates/RELEASE_PLAN.md
@ -0,0 +1,7 @@
+# Plan de release — Template
+
+- Vue d’ensemble, objectifs, date cible
+- Préparation (docs/CI/tests/sécurité)
+- Communication (annonces, canaux)
+- Lancement (checklist, tagging)
+- Post‑lancement (support, retours)
--- a/docs/templates/SECURITY_AUDIT.md
+++ b/docs/templates/SECURITY_AUDIT.md
@ -0,0 +1,7 @@
+# Audit de sécurité — Template
+
+- Menaces et surfaces d’attaque
+- Contrôles préventifs et détectifs
+- Gestion des secrets
+- Politique de dépendances
+- Vérifications CI (security-audit)
--- a/docs/templates/TESTING.md
+++ b/docs/templates/TESTING.md
@ -0,0 +1,6 @@
+# Tests — Template
+
+- Pyramide: unit, integration, connectivity, external, performance
+- Structure des répertoires
+- Exécution et rapports
+- Intégration CI
--- a/docs/templates/USAGE.md
+++ b/docs/templates/USAGE.md
@ -0,0 +1,7 @@
+# Usage — Template
+
+- Démarrage quotidien
+- Opérations courantes
+- Tests (référence vers TESTING.md)
+- Sécurité (référence vers SECURITY_AUDIT.md)
+- Déploiement (référence vers DEPLOYMENT.md)
--- a/scripts/checks/version_alignment.sh
+++ b/scripts/checks/version_alignment.sh
@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")"/../.. && pwd)"
+cd "$ROOT_DIR"
+
+version_file="VERSION"
+[[ -f TEMPLATE_VERSION ]] && version_file="TEMPLATE_VERSION"
+
+[[ -f "$version_file" ]] || { echo "Version file missing ($version_file)"; exit 1; }
+v=$(tr -d '\r' < "$version_file" | head -n1)
+[[ -n "$v" ]] || { echo "Empty version"; exit 1; }
+
+echo "Version file: $version_file=$v"
+
+if ! grep -Eq "^## \\[$(echo "$v" | sed 's/^v//')\\]" CHANGELOG.md; then
+  echo "CHANGELOG entry for $v not found"; exit 1;
+fi
+
+echo "Version alignment OK"
+
+
--- a/scripts/deploy/setup.sh
+++ b/scripts/deploy/setup.sh
@ -0,0 +1,145 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ENV_DIR="${HOME}/.4nk_template"
+ENV_FILE="${ENV_DIR}/.env"
+TEMPLATE_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+TEMPLATE_IN_REPO="${TEMPLATE_ROOT}/scripts/env/.env.template"
+
+usage() {
+  cat <<USAGE
+Usage: $0 <git_url> [--dest DIR] [--force]
+
+Actions:
+  1) Provisionne ~/.4nk_template/.env (si absent)
+  2) Clone le dépôt cible si le dossier n'existe pas
+  3) Copie la structure normative 4NK_template dans le projet cible:
+     - .gitea/** (workflows, templates issues/PR)
+     - AGENTS.md
+     - .cursor/rules/** (si présent)
+     - scripts/agents/**, scripts/env/ensure_env.sh, scripts/deploy/setup.sh
+     - docs/templates/** et docs/INDEX.md (table des matières)
+  4) Ne remplace pas les fichiers existants sauf si --force
+
+Exemples:
+  $0 https://git.example.com/org/projet.git
+  $0 git@host:org/projet.git --dest ~/work --force
+USAGE
+}
+
+GIT_URL="${1:-}"
+DEST_PARENT="$(pwd)"
+FORCE_COPY=0
+shift || true
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --dest)
+      DEST_PARENT="${2:-}"; shift 2 ;;
+    --force)
+      FORCE_COPY=1; shift ;;
+    -h|--help)
+      usage; exit 0 ;;
+    *)
+      echo "Option inconnue: $1" >&2; usage; exit 2 ;;
+  esac
+done
+
+if [[ -z "${GIT_URL}" ]]; then
+  usage; exit 2
+fi
+
+mkdir -p "${ENV_DIR}"
+chmod 700 "${ENV_DIR}" || true
+
+if [[ ! -f "${ENV_FILE}" ]]; then
+  if [[ -f "${TEMPLATE_IN_REPO}" ]]; then
+    cp "${TEMPLATE_IN_REPO}" "${ENV_FILE}"
+  else
+    cat >"${ENV_FILE}" <<'EOF'
+# Fichier d'exemple d'environnement pour 4NK_template
+# Copiez ce fichier vers ~/.4nk_template/.env puis complétez les valeurs.
+# Ne committez jamais de fichier contenant des secrets.
+
+# OpenAI (agents IA)
+OPENAI_API_KEY=
+OPENAI_MODEL=
+OPENAI_API_BASE=https://api.openai.com/v1
+OPENAI_TEMPERATURE=0.2
+
+# Gitea (release via API)
+BASE_URL=https://git.4nkweb.com
+RELEASE_TOKEN=
+EOF
+  fi
+  chmod 600 "${ENV_FILE}" || true
+  echo "Fichier créé: ${ENV_FILE}. Complétez les valeurs requises (ex: OPENAI_API_KEY, OPENAI_MODEL, RELEASE_TOKEN)." >&2
+fi
+
+# 2) Clonage du dépôt si nécessaire
+repo_name="$(basename -s .git "${GIT_URL}")"
+target_dir="${DEST_PARENT%/}/${repo_name}"
+if [[ ! -d "${target_dir}" ]]; then
+  echo "Clonage: ${GIT_URL} → ${target_dir}" >&2
+  git clone --depth 1 "${GIT_URL}" "${target_dir}"
+else
+  echo "Dossier existant, pas de clone: ${target_dir}" >&2
+fi
+
+copy_item() {
+  local src="$1" dst="$2"
+  if [[ ! -e "$src" ]]; then return 0; fi
+  if [[ -d "$src" ]]; then
+    mkdir -p "$dst"
+    if (( FORCE_COPY )); then
+      cp -a "$src/." "$dst/"
+    else
+      (cd "$src" && find . -type f -print0) | while IFS= read -r -d '' f; do
+        if [[ ! -e "$dst/$f" ]]; then
+          mkdir -p "$(dirname "$dst/$f")"
+          cp -a "$src/$f" "$dst/$f"
+        fi
+      done
+    fi
+  else
+    if [[ -e "$dst" && $FORCE_COPY -eq 0 ]]; then return 0; fi
+    mkdir -p "$(dirname "$dst")" && cp -a "$src" "$dst"
+  fi
+}
+
+# 3) Copie de la structure normative
+copy_item "${TEMPLATE_ROOT}/.gitea"                    "${target_dir}/.gitea"
+copy_item "${TEMPLATE_ROOT}/AGENTS.md"                 "${target_dir}/AGENTS.md"
+copy_item "${TEMPLATE_ROOT}/.cursor"                   "${target_dir}/.cursor"
+copy_item "${TEMPLATE_ROOT}/.cursorignore"             "${target_dir}/.cursorignore"
+copy_item "${TEMPLATE_ROOT}/.gitignore"                "${target_dir}/.gitignore"
+copy_item "${TEMPLATE_ROOT}/.markdownlint.json"        "${target_dir}/.markdownlint.json"
+copy_item "${TEMPLATE_ROOT}/LICENSE"                   "${target_dir}/LICENSE"
+copy_item "${TEMPLATE_ROOT}/CONTRIBUTING.md"           "${target_dir}/CONTRIBUTING.md"
+copy_item "${TEMPLATE_ROOT}/CODE_OF_CONDUCT.md"        "${target_dir}/CODE_OF_CONDUCT.md"
+copy_item "${TEMPLATE_ROOT}/SECURITY.md"               "${target_dir}/SECURITY.md"
+copy_item "${TEMPLATE_ROOT}/TEMPLATE_VERSION"          "${target_dir}/TEMPLATE_VERSION"
+copy_item "${TEMPLATE_ROOT}/security"                  "${target_dir}/security"
+copy_item "${TEMPLATE_ROOT}/scripts"                   "${target_dir}/scripts"
+copy_item "${TEMPLATE_ROOT}/docs/templates"            "${target_dir}/docs/templates"
+
+# Génération docs/INDEX.md dans le projet cible (si absent ou --force)
+INDEX_DST="${target_dir}/docs/INDEX.md"
+if [[ ! -f "${INDEX_DST}" || $FORCE_COPY -eq 1 ]]; then
+  mkdir -p "$(dirname "${INDEX_DST}")"
+  cat >"${INDEX_DST}" <<'IDX'
+# Documentation du projet
+
+Cette table des matières oriente vers:
+- Documentation spécifique au projet: `docs/project/`
+- Modèles génériques à adapter: `docs/templates/`
+
+## Sommaire
+- À personnaliser: `docs/project/README.md`, `docs/project/INDEX.md`, `docs/project/ARCHITECTURE.md`, `docs/project/USAGE.md`, etc.
+
+## Modèles génériques
+- Voir: `docs/templates/`
+IDX
+fi
+
+echo "Template 4NK appliqué à: ${target_dir}" >&2
+exit 0
--- a/scripts/dev/run_container.sh
+++ b/scripts/dev/run_container.sh
@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+IMAGE_NAME="4nk-template-dev:debian"
+DOCKERFILE="docker/Dockerfile.debian"
+
+echo "[build] ${IMAGE_NAME}"
+docker build -t "${IMAGE_NAME}" -f "${DOCKERFILE}" .
+
+echo "[run] launching container and executing agents"
+docker run --rm -it \
+  -v "${PWD}:/work" -w /work \
+  "${IMAGE_NAME}" \
+  "scripts/agents/run.sh; ls -la tests/reports/agents || true"
+
--- a/scripts/dev/run_project_ci.sh
+++ b/scripts/dev/run_project_ci.sh
@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Build et lance le conteneur unifié (runner+agents) sur ce projet
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+cd "$ROOT_DIR"
+
+# Build image
+docker compose -f docker-compose.ci.yml build
+
+# Exécuter agents par défaut
+RUNNER_MODE="${RUNNER_MODE:-agents}" BASE_URL="${BASE_URL:-}" REGISTRATION_TOKEN="${REGISTRATION_TOKEN:-}" \
+  docker compose -f docker-compose.ci.yml up --remove-orphans --abort-on-container-exit
--- a/scripts/env/ensure_env.sh
+++ b/scripts/env/ensure_env.sh
@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+TEMPLATE_FILE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/.env.template"
+ENV_DIR="${HOME}/.4nk_template"
+ENV_FILE="${ENV_DIR}/.env"
+
+mkdir -p "${ENV_DIR}"
+chmod 700 "${ENV_DIR}" || true
+
+if [[ ! -f "${ENV_FILE}" ]]; then
+  if [[ -f "${TEMPLATE_FILE}" ]]; then
+    cp "${TEMPLATE_FILE}" "${ENV_FILE}"
+    chmod 600 "${ENV_FILE}" || true
+    echo "Fichier d'environnement créé: ${ENV_FILE}" >&2
+    echo "Veuillez renseigner les variables requises (OPENAI_API_KEY, OPENAI_MODEL, etc.)." >&2
+    exit 3
+  else
+    echo "Modèle d'environnement introuvable: ${TEMPLATE_FILE}" >&2
+    exit 2
+  fi
+fi
+
+# Charger pour validation
+set -a
+. "${ENV_FILE}"
+set +a
+
+MISSING=()
+for var in OPENAI_API_KEY OPENAI_MODEL; do
+  if [[ -z "${!var:-}" ]]; then
+    MISSING+=("$var")
+  fi
+done
+
+if (( ${#MISSING[@]} > 0 )); then
+  echo "Variables manquantes dans ${ENV_FILE}: ${MISSING[*]}" >&2
+  exit 4
+fi
+
+echo "Environnement valide: ${ENV_FILE}" >&2
--- a/scripts/local/run_agents_for_project.sh
+++ b/scripts/local/run_agents_for_project.sh
@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Script pour lancer les agents de 4NK_template sur un projet externe
+# Usage: ./run_agents_for_project.sh [project_path] [output_dir]
+
+PROJECT_PATH="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+TEMPLATE_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+MODULE_LAST_IMAGE_FILE="$(cd "$TEMPLATE_DIR/.." && pwd)/modules/4NK_template/.last_image"
+
+if [[ ! -d "$PROJECT_PATH" ]]; then
+  echo "Erreur: Le projet '$PROJECT_PATH' n'existe pas" >&2
+  exit 1
+fi
+
+mkdir -p "$PROJECT_PATH/$OUTPUT_DIR"
+
+echo "=== Lancement des agents 4NK_template sur: $PROJECT_PATH ==="
+
+if ! command -v docker >/dev/null 2>&1; then
+  echo "Docker requis pour exécuter les agents via conteneur." >&2
+  exit 2
+fi
+
+# Si une image du module existe, l'utiliser en priorité
+if [[ -f "$MODULE_LAST_IMAGE_FILE" ]]; then
+  IMAGE_NAME="$(cat "$MODULE_LAST_IMAGE_FILE" | tr -d '\r\n')"
+  echo "Utilisation de l'image du module: $IMAGE_NAME"
+  # Préparer montage du fichier d'env si présent
+  ENV_MOUNT=""
+  if [[ -f "$HOME/.4nk_template/.env" ]]; then
+    ENV_MOUNT="-v $HOME/.4nk_template/.env:/root/.4nk_template/.env:ro"
+  fi
+  # Lancer le conteneur en utilisant l'ENTRYPOINT qui configure safe.directory
+  docker run --rm \
+    -e RUNNER_MODE=agents \
+    -e TARGET_DIR=/work \
+    -e OUTPUT_DIR=/work/$OUTPUT_DIR \
+    -v "$(realpath "$PROJECT_PATH"):/work" \
+    $ENV_MOUNT \
+    "$IMAGE_NAME" || true
+else
+  echo "Aucune image de module détectée, fallback docker compose dans 4NK_template"
+  cd "$TEMPLATE_DIR"
+  docker compose -f docker-compose.ci.yml build
+  RUNNER_MODE="agents" TARGET_DIR="/work" OUTPUT_DIR="/work/$OUTPUT_DIR" \
+    docker compose -f docker-compose.ci.yml run --rm project-ci || true
+fi
+
+echo "=== Agents terminés → $PROJECT_PATH/$OUTPUT_DIR ==="
--- a/scripts/release/guard.sh
+++ b/scripts/release/guard.sh
@ -0,0 +1,67 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Release guard script
+# Checks: tests, docs updated, compile, version ↔ changelog ↔ tag consistency, release type
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")"/../.. && pwd)"
+cd "$ROOT_DIR"
+
+mode="${RELEASE_TYPE:-ci-verify}"   # values: latest | wip | ci-verify
+
+echo "[release-guard] mode=$mode"
+
+# 1) Basic presence checks
+[[ -f CHANGELOG.md ]] || { echo "CHANGELOG.md manquant"; exit 1; }
+version_file="VERSION"
+[[ -f TEMPLATE_VERSION ]] && version_file="TEMPLATE_VERSION"
+[[ -f "$version_file" ]] || { echo "$version_file manquant"; exit 1; }
+
+# 2) Extract version
+project_version=$(tr -d '\r' < "$version_file" | head -n1 | sed 's/^v//')
+[[ -n "$project_version" ]] || { echo "Version vide dans $version_file"; exit 1; }
+echo "[release-guard] version=$project_version"
+
+# 3) Changelog checks
+if ! grep -Eq "^## \\[$project_version\\]" CHANGELOG.md; then
+  if [[ "$mode" == "wip" ]]; then
+    grep -Eq "^## \\[Unreleased\\]" CHANGELOG.md || { echo "Section [Unreleased] absente du CHANGELOG"; exit 1; }
+  else
+    echo "Entrée CHANGELOG pour version $project_version manquante"; exit 1;
+  fi
+fi
+
+# 4) Tests (optional best-effort)
+if [[ -x tests/run_all_tests.sh ]]; then
+  echo "[release-guard] exécution tests/run_all_tests.sh"
+  ./tests/run_all_tests.sh || { echo "Tests en échec"; exit 1; }
+else
+  echo "[release-guard] tests absents (ok)"
+fi
+
+# 5) Build/compile (optional based on project)
+if [[ -d sdk_relay ]] && command -v cargo >/dev/null 2>&1; then
+  echo "[release-guard] cargo build (sdk_relay)"
+  (cd sdk_relay && cargo build --quiet) || { echo "Compilation échouée"; exit 1; }
+else
+  echo "[release-guard] build spécifique non applicable (ok)"
+fi
+
+# 6) Release type handling
+case "$mode" in
+  latest)
+    ;;
+  wip)
+    # En wip, autoriser versions suffixées; pas d’exigence d’entrée datée
+    ;;
+  ci-verify)
+    # En CI, on valide juste la présence de CHANGELOG et version
+    ;;
+  *)
+    echo "RELEASE_TYPE invalide: $mode (latest|wip|ci-verify)"; exit 1;
+    ;;
+esac
+
+echo "[release-guard] OK"
+
+
--- a/scripts/scripts/auto-ssh-push.sh
+++ b/scripts/scripts/auto-ssh-push.sh
@ -0,0 +1,166 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Script d'automatisation des push SSH (template Linux)
+# Utilise automatiquement la clé SSH pour pousser sur le remote courant via SSH.
+
+GITEA_HOST="${GITEA_HOST:-git.4nkweb.com}"
+
+echo "🔑 Configuration SSH pour push (template)..."
+
+# Configuration SSH automatique
+echo "⚙️  Configuration Git pour utiliser SSH..."
+git config --global url."git@${GITEA_HOST}:".insteadOf "https://${GITEA_HOST}/"
+
+# Vérifier la configuration SSH
+echo "🔍 Vérification de la configuration SSH..."
+if ! ssh -T git@"${GITEA_HOST}" 2>&1 | grep -qi "authenticated\|welcome"; then
+    echo "❌ Échec de l'authentification SSH"
+    echo "💡 Vérifiez que votre clé SSH est configurée :"
+    echo "   1. ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519_4nk"
+    echo "   2. Ajouter la clé publique à votre compte Gitea"
+    echo "   3. ssh-add ~/.ssh/id_ed25519_4nk"
+    exit 1
+fi
+
+echo "✅ Authentification SSH réussie"
+
+# Fonction pour push automatique
+get_current_branch() {
+    # Détecte la branche courante, compatible anciennes versions de git
+    local br
+    br="$(git rev-parse --abbrev-ref HEAD 2>/dev/null || true)"
+    if [ -z "$br" ] || [ "$br" = "HEAD" ]; then
+        br="$(git symbolic-ref --short -q HEAD 2>/dev/null || true)"
+    fi
+    if [ -z "$br" ]; then
+        # dernier recours: parser la sortie de "git branch"
+        br="$(git branch 2>/dev/null | sed -n 's/^* //p' | head -n1)"
+    fi
+    echo "$br"
+}
+
+auto_push() {
+    local branch
+    branch=${1:-$(get_current_branch)}
+    local commit_message=${2:-"Auto-commit $(date '+%Y-%m-%d %H:%M:%S')"}
+
+    echo "🚀 Push automatique sur la branche: $branch"
+
+    # Ajouter tous les changements
+    git add .
+
+    # Ne pas commiter si rien à commite
+    if [[ -z "$(git diff --cached --name-only)" ]]; then
+        echo "ℹ️  Aucun changement indexé. Skip commit/push."
+        return 0
+    fi
+
+    # Commiter avec le message fourni
+    git commit -m "$commit_message" || true
+
+    # Push avec SSH automatique
+    echo "📤 Push vers origin/$branch..."
+    git push origin "$branch"
+
+    echo "✅ Push réussi !"
+}
+
+# Fonction pour push avec message personnalisé
+push_with_message() {
+    local message="$1"
+    local branch=${2:-$(get_current_branch)}
+
+    echo "💬 Push avec message: $message"
+    auto_push "$branch" "$message"
+}
+
+# Fonction pour push rapide (sans message)
+quick_push() {
+    local branch=${1:-$(get_current_branch)}
+    auto_push "$branch"
+}
+
+# Fonction pour push sur une branche spécifique
+push_branch() {
+    local branch="$1"
+    local message=${2:-"Update $branch $(date '+%Y-%m-%d %H:%M:%S')"}
+
+    echo "🌿 Push sur la branche: $branch"
+    auto_push "$branch" "$message"
+}
+
+# Fonction pour push et merge vers main
+push_and_merge() {
+    local source_branch=${1:-$(get_current_branch)}
+    local target_branch=${2:-main}
+
+    echo "🔄 Push et merge $source_branch -> $target_branch"
+
+    # Push de la branche source
+    auto_push "$source_branch"
+
+    # Indication pour PR manuelle
+    echo "🔗 Ouvrez une Pull Request sur votre forge pour $source_branch -> $target_branch"
+}
+
+# Fonction pour status et push conditionnel
+status_and_push() {
+    echo "📊 Statut du repository:"
+    git status --short || true
+
+    if [[ -n $(git status --porcelain) ]]; then
+        echo "📝 Changements détectés, push automatique..."
+        auto_push
+    else
+        echo "✅ Aucun changement à pousser"
+    fi
+}
+
+# Menu interactif si aucun argument fourni
+if [[ $# -eq 0 ]]; then
+    echo "🤖 Script de push SSH automatique (template)"
+    echo ""
+    echo "Options disponibles:"
+    echo "  auto-ssh-push.sh quick                    - Push rapide"
+    echo "  auto-ssh-push.sh message \"Mon message\"    - Push avec message"
+    echo "  auto-ssh-push.sh branch nom-branche       - Push sur branche spécifique"
+    echo "  auto-ssh-push.sh merge [source] [target]  - Push et préparation merge"
+    echo "  auto-ssh-push.sh status                   - Status et push conditionnel"
+    echo ""
+    exit 0
+fi
+
+# Traitement des arguments
+case "$1" in
+    "quick")
+        quick_push
+        ;;
+    "message")
+        if [[ -z "${2:-}" ]]; then
+            echo "❌ Message requis pour l'option 'message'"
+            exit 1
+        fi
+        push_with_message "$2" "${3:-}"
+        ;;
+    "branch")
+        if [[ -z "${2:-}" ]]; then
+            echo "❌ Nom de branche requis pour l'option 'branch'"
+            exit 1
+        fi
+        push_branch "$2" "${3:-}"
+        ;;
+    "merge")
+        push_and_merge "${2:-}" "${3:-}"
+        ;;
+    "status")
+        status_and_push
+        ;;
+    *)
+        echo "❌ Option inconnue: $1"
+        echo "💡 Utilisez './scripts/auto-ssh-push.sh' pour voir les options"
+        exit 1
+        ;;
+esac
+
+echo "🎯 Push SSH automatique terminé !"
--- a/scripts/scripts/init-ssh-env.sh
+++ b/scripts/scripts/init-ssh-env.sh
@ -0,0 +1,59 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Script d'initialisation de l'environnement SSH (template Linux)
+# Configure automatiquement SSH pour les push via Gitea
+
+GITEA_HOST="${GITEA_HOST:-git.4nkweb.com}"
+
+echo "🚀 Initialisation de l'environnement SSH (template)..."
+
+# Couleurs
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+print_status()  { echo -e "${BLUE}[INFO]${NC} $1"; }
+print_success() { echo -e "${GREEN}[SUCCESS]${NC} $1"; }
+print_warning() { echo -e "${YELLOW}[WARNING]${NC} $1"; }
+print_error()   { echo -e "${RED}[ERROR]${NC} $1"; }
+
+print_status "Configuration SSH..."
+
+# 1. Configuration Git pour SSH
+print_status "Configuration Git pour utiliser SSH (${GITEA_HOST})..."
+git config --global url."git@${GITEA_HOST}:".insteadOf "https://${GITEA_HOST}/"
+
+# 2. Vérification des clés SSH
+print_status "Vérification des clés SSH existantes..."
+if [[ -f ~/.ssh/id_rsa || -f ~/.ssh/id_ed25519 ]]; then
+    print_success "Clé SSH trouvée"
+else
+    print_warning "Aucune clé SSH trouvée"
+fi
+
+# 3. Test de la connexion SSH
+print_status "Test de la connexion SSH vers ${GITEA_HOST}..."
+if ssh -T git@"${GITEA_HOST}" 2>&1 | grep -qi "authenticated\|welcome"; then
+    print_success "Authentification SSH réussie"
+else
+    print_error "Échec de l'authentification SSH"
+fi
+
+# 4. Alias Git
+print_status "Configuration des alias Git..."
+git config --global alias.ssh-push '!f() { git add . && git commit -m "${1:-Auto-commit $(date)}" && git push origin $(git branch --show-current); }; f'
+git config --global alias.quick-push '!f() { git add . && git commit -m "Update $(date)" && git push origin $(git branch --show-current); }; f'
+print_success "Alias Git configurés"
+
+# 5. Rendu exécutable des scripts si chemin standard
+print_status "Configuration des permissions des scripts (si présents)..."
+chmod +x scripts/auto-ssh-push.sh 2>/dev/null || true
+chmod +x scripts/setup-ssh-ci.sh 2>/dev/null || true
+print_success "Scripts rendus exécutables (si présents)"
+
+# 6. Résumé
+echo ""
+print_success "=== Configuration SSH terminée ==="
--- a/scripts/scripts/setup-ssh-ci.sh
+++ b/scripts/scripts/setup-ssh-ci.sh
@ -0,0 +1,54 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Script de configuration SSH pour CI/CD (template Linux)
+# Utilise automatiquement la clé SSH pour les opérations Git
+
+GITEA_HOST="${GITEA_HOST:-git.4nkweb.com}"
+
+echo "🔑 Configuration automatique de la clé SSH pour CI/CD..."
+
+if [ -n "${CI:-}" ]; then
+    echo "✅ Environnement CI détecté"
+
+    if [ -n "${SSH_PRIVATE_KEY:-}" ]; then
+        echo "🔐 Configuration de la clé SSH privée..."
+        mkdir -p ~/.ssh && chmod 700 ~/.ssh
+        printf "%s" "$SSH_PRIVATE_KEY" > ~/.ssh/id_rsa
+        chmod 600 ~/.ssh/id_rsa
+
+        if [ -n "${SSH_PUBLIC_KEY:-}" ]; then
+            printf "%s" "$SSH_PUBLIC_KEY" > ~/.ssh/id_rsa.pub
+            chmod 644 ~/.ssh/id_rsa.pub
+        fi
+
+        cat > ~/.ssh/config << EOF
+Host ${GITEA_HOST}
+    HostName ${GITEA_HOST}
+    User git
+    IdentityFile ~/.ssh/id_rsa
+    StrictHostKeyChecking no
+    UserKnownHostsFile=/dev/null
+EOF
+        chmod 600 ~/.ssh/config
+
+        echo "🧪 Test SSH vers ${GITEA_HOST}..."
+        ssh -T git@"${GITEA_HOST}" 2>&1 || true
+
+        git config --global url."git@${GITEA_HOST}:".insteadOf "https://${GITEA_HOST}/"
+        echo "✅ Configuration SSH terminée"
+    else
+        echo "⚠️  SSH_PRIVATE_KEY non défini, bascule HTTPS"
+    fi
+else
+    echo "ℹ️  Environnement local détecté"
+    if [ -f ~/.ssh/id_rsa ] || [ -f ~/.ssh/id_ed25519 ]; then
+        echo "🔑 Clé SSH locale trouvée"
+        git config --global url."git@${GITEA_HOST}:".insteadOf "https://${GITEA_HOST}/"
+        echo "✅ Configuration SSH locale terminée"
+    else
+        echo "⚠️  Aucune clé SSH trouvée; configuration manuelle requise"
+    fi
+fi
+
+echo "🎯 Configuration SSH CI/CD terminée"
--- a/scripts/security/audit.sh
+++ b/scripts/security/audit.sh
@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+echo "[security-audit] démarrage"
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")"/../.. && pwd)"
+cd "$ROOT_DIR"
+
+rc=0
+
+# 1) Audit Rust (si Cargo.toml présent et cargo disponible)
+if command -v cargo >/dev/null 2>&1 && [ -f Cargo.toml ] || find . -maxdepth 2 -name Cargo.toml | grep -q . ; then
+  echo "[security-audit] cargo audit"
+  if ! cargo audit --deny warnings; then rc=1; fi || true
+else
+  echo "[security-audit] pas de projet Rust (ok)"
+fi
+
+# 2) Audit npm (si package.json présent)
+if [ -f package.json ]; then
+  echo "[security-audit] npm audit --audit-level=moderate"
+  if ! npm audit --audit-level=moderate; then rc=1; fi || true
+else
+  echo "[security-audit] pas de package.json (ok)"
+fi
+
+# 3) Recherche de secrets grossiers
+echo "[security-audit] scan secrets"
+if grep -RIE "(?i)(api[_-]?key|secret|password|private[_-]?key)" --exclude-dir .git --exclude-dir node_modules --exclude-dir target --exclude "*.md" . >/dev/null 2>&1; then
+  echo "[security-audit] secrets potentiels détectés"; rc=1
+else
+  echo "[security-audit] aucun secret évident"
+fi
+
+echo "[security-audit] terminé rc=$rc"
+exit $rc
+
+
--- a/scripts/utils/check_md024.ps1
+++ b/scripts/utils/check_md024.ps1
@ -0,0 +1,47 @@
+Param(
+  [string]$Root = "."
+)
+
+$ErrorActionPreference = "Stop"
+
+$files = Get-ChildItem -Path $Root -Recurse -Filter *.md | Where-Object { $_.FullName -notmatch '\\archive\\' }
+$had = $false
+foreach ($f in $files) {
+  try {
+    $lines = Get-Content -LiteralPath $f.FullName -Encoding UTF8 -ErrorAction Stop
+  } catch {
+    Write-Warning ("Impossible de lire: {0} — {1}" -f $f.FullName, $_.Exception.Message)
+    continue
+  }
+  $map = @{}
+  $firstMap = @{}
+  $dups = @{}
+  for ($i = 0; $i -lt $lines.Count; $i++) {
+    $line = $lines[$i]
+    if ($line -match '^\s{0,3}#{1,6}\s+(.*)$') {
+      $t = $Matches[1].Trim()
+      $norm = ([regex]::Replace($t, '\s+', ' ')).ToLowerInvariant()
+      if ($map.ContainsKey($norm)) {
+        if (-not $dups.ContainsKey($norm)) {
+          $dups[$norm] = New-Object System.Collections.ArrayList
+          $firstMap[$norm] = $map[$norm]
+        }
+        [void]$dups[$norm].Add($i + 1)
+      } else {
+        $map[$norm] = $i + 1
+      }
+    }
+  }
+  if ($dups.Keys.Count -gt 0) {
+    $had = $true
+    Write-Output "=== $($f.FullName) ==="
+    foreach ($k in $dups.Keys) {
+      $first = $firstMap[$k]
+      $others = ($dups[$k] -join ', ')
+      Write-Output ("Heading: '{0}' first@{1} duplicates@[{2}]" -f $k, $first, $others)
+    }
+  }
+}
+if (-not $had) {
+  Write-Output "No duplicate headings detected."
+}