khadhroony-bot3/docs/DELTA_WORKFLOW.md

Workflow de livraison delta

Les règles normatives de livraison sont définies dans ../RULES_GENERAL.md. Ce document décrit leur application pratique.

Nommage

Delta multi-module ou racine :

khadhroony-bot3_vX.Y.Z-pre.abc-delta.zip

Delta limité à un package :

kb-modulename_vX.Y.Z-pre.abc-delta.zip

Correctif d’une prerelease déjà livrée :

khadhroony-bot3_vX.Y.Z-pre.abc-delta-fix-001.zip

La numérotation des correctifs recommence à fix-001 pour chaque nouvelle prerelease.

Contenu

Chaque archive contient uniquement :

• les fichiers ajoutés ;
• les fichiers modifiés ;
• un delta.md non versionné à la racine.

Elle exclut :

• les fichiers inchangés ;
• Cargo.lock ;
• package-lock.json ;
• node_modules/, target/, dist/ et les autres sorties de build ;
• gen/, les bindings TS-RS générés et tout autre code régénérable ;
• les logs, caches, PID, bases et données locales ;
• les fichiers .env réels et toute configuration contenant des secrets ;
• les fichiers d’IDE ou propres à la machine ;
• les empreintes SHA256 ;
• les fichiers supprimés, qui doivent être indiqués comme suppressions manuelles.

.env.example, .gitignore et les autres fichiers source explicitement maintenus peuvent être livrés. delta.md est généré spécialement pour le ZIP et reste obligatoire même si les documents delta*.md sont ignorés dans le dépôt.

Contrat de delta.md

delta.md indique obligatoirement :

• la base requise ;
• les correctifs antérieurs requis ;
• les fichiers ajoutés ;
• les fichiers modifiés ;
• les fichiers à supprimer manuellement ;
• les validations exécutées ;
• les validations non exécutées ;
• les remarques d’application et de compatibilité.

Application

1. Partir de la base indiquée.
2. Appliquer les deltas et correctifs antérieurs dans l’ordre indiqué.
3. Extraire l’archive à la racine du workspace.
4. Effectuer les suppressions manuelles listées dans delta.md.
5. Lancer les validations demandées.

Une archive déjà livrée ne doit jamais être remplacée silencieusement sous le même nom.