Files
khadhroony-solana-project/deltas/0.2.6/pre.001-fix.002.md

151 lines
5.4 KiB
Markdown

<!-- file: deltas/0.2.6/pre.001-fix.002.md -->
<!-- version: 1 -->
# Delta `0.2.6-pre.001-fix.002` — workflow npm/Tauri Wallet Desk
## Base requise
```text
0.2.6-pre.001-fix.001 appliquée
workspace.package.version = 0.2.6-pre.1
```
Le plan opérateur `docs/plans/013-V0_2_6_WALLET_DESK_PLAN.md` fourni pour ce correctif est la base documentaire retenue ; son alignement manuel des tableaux est conservé.
## Type de livraison
```text
ksp-doc-0.2.6-pre.001-fix.002.zip
```
Le correctif reste strictement documentaire. Aucun `Cargo.toml`, fichier Rust, `package.json`, configuration Tauri ou fichier runtime n'est modifié.
## Objet
Corriger la règle KSP et le plan Wallet Desk afin d'appliquer le workflow frontend Tauri retenu : npm direct sert uniquement à installer ou mettre à jour les dépendances déclarées ; les scripts de développement et de build sont déclenchés par Tauri via `beforeDevCommand` / `beforeBuildCommand`.
## Correction normative
`KSP-APP-025` indiquait déjà que npm est utilisé directement uniquement pour installer ou mettre à jour les dépendances. `KSP-APP-034` conservait cependant encore une validation frontend standalone par script npm, créant une contradiction normative.
`KSP-APP-034` est corrigée pour imposer :
```text
npm direct : npm i -D ou npm update lorsque package.json est créé/modifié
cycle dev : cargo tauri dev -c crates/<app>/tauri.conf.json
cycle build : cargo tauri build -c crates/<app>/tauri.conf.json
beforeDevCommand / beforeBuildCommand déclenchés automatiquement par Tauri
aucun script npm applicatif de contrôle/dev/build lancé directement dans la validation opérateur
cargo tauri build toujours en toute dernière opération
```
La version de `docs/rules/RULES_KSP.md` passe de `35` à `36`, conformément au contrat de versionnement des règles documentaires.
## Corrections du plan Wallet Desk
Le plan opérateur `version: 3` passe à `version: 4` sans reformater ses tableaux.
Les prescriptions de validation frontend standalone par script npm sont supprimées dans :
```text
gabarit Tauri
validation frontend
pre.002
pre.014
validation continue
candidate finale
critères de sortie
```
La validation frontend est désormais décrite par le parcours :
```text
package.json créé/modifié
-> npm i -D ou npm update si nécessaire
-> retour racine workspace
-> cargo tauri dev -c crates/ksp-app-wallet-desk/tauri.conf.json
-> Tauri exécute beforeDevCommand
```
La validation finale devient :
```text
cargo fmt --all
python3 scripts/audit_rust_workspace_rules.py
cargo check --workspace
cargo clippy --workspace --all-targets
cargo test -p ksp-app-wallet-desk
cargo test --workspace
cargo tauri dev -c crates/ksp-app-wallet-desk/tauri.conf.json
cargo tauri build -c crates/ksp-app-wallet-desk/tauri.conf.json
```
Le dernier `cargo tauri build` déclenche lui-même le build frontend via `beforeBuildCommand` et reste la toute dernière opération.
## Contrôle mécanique futur
Aucun script d'audit n'est modifié dans ce correctif documentaire. La possibilité d'ajouter un contrôle mécanique de cette règle sera évaluée au démarrage technique de `pre.002`, avant de propager le nouveau gabarit dans `ksp-app-wallet-desk`. Si ce contrôle modifie l'outillage consommé par le workflow, il appartiendra à une tranche technique avec le signal de version correspondant.
## Fichiers ajoutés
```text
deltas/0.2.6/pre.001-fix.002.md
```
## Fichiers modifiés
```text
docs/rules/RULES_KSP.md
docs/plans/013-V0_2_6_WALLET_DESK_PLAN.md
```
## Fichiers supprimés
```text
aucun
```
## Version technique
Conformément à `VER-ID-008`, ce correctif documentaire ne modifie pas la version Cargo :
```text
workspace.package.version = 0.2.6-pre.1 (inchangé)
commit = v0.2.6-pre.001-fix.002
```
Aucun `Cargo.toml` n'est livré dans le delta.
## Validations de la base
Les validations opérateur de `pre.001` restent les preuves de la base technique :
```text
cargo fmt --all vert
python3 scripts/audit_rust_workspace_rules.py clean
cargo check --workspace vert
cargo clippy --workspace --all-targets vert
```
Le présent correctif ne revendique aucune nouvelle validation Cargo, puisqu'il ne modifie aucun fichier consommé par Cargo ou le runtime.
## Contrôles documentaires exécutés
- conservation du fichier opérateur aligné comme base du plan ;
- `docs/plans/013-V0_2_6_WALLET_DESK_PLAN.md` passé de `version: 3` à `version: 4` ;
- `docs/rules/RULES_KSP.md` passé de `version: 35` à `version: 36` ;
- suppression des prescriptions de validation frontend standalone par script npm dans le plan actif ;
- maintien des scripts frontend de dev/build uniquement derrière les hooks Tauri, jamais comme commandes opérateur directes ;
- contrôle qu'aucun `Cargo.toml`, fichier Rust, frontend ou runtime n'est présent dans l'archive.
## Décisions prises
- aucune validation frontend standalone par script npm n'appartient au workflow Wallet Desk ;
- npm direct est réservé à l'installation/mise à jour des dépendances de `package.json` ;
- le développement passe par `cargo tauri dev -c ...` ;
- Tauri déclenche les scripts frontend configurés ;
- le build de production passe exclusivement par `cargo tauri build -c ...` ;
- `cargo tauri build` reste la toute dernière opération de validation ;
- `workspace.package.version` reste `0.2.6-pre.1` ;
- la prochaine tranche technique reste `pre.002` après commit du présent fix.