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

5.4 KiB

Delta 0.2.6-pre.001-fix.002 — workflow npm/Tauri Wallet Desk

Base requise

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

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 :

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 :

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 :

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 :

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

deltas/0.2.6/pre.001-fix.002.md

Fichiers modifiés

docs/rules/RULES_KSP.md
docs/plans/013-V0_2_6_WALLET_DESK_PLAN.md

Fichiers supprimés

aucun

Version technique

Conformément à VER-ID-008, ce correctif documentaire ne modifie pas la version Cargo :

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 :

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.