Compiler et lancer
Tout part des sources. Il n’y a ni binaire, ni installeur, ni canal de mise à jour aujourd’hui : c’est donc aussi le chemin d’installation.
Prérequis
- macOS, Apple silicon ou Intel. C’est la seule plateforme prise en charge pour l’instant.
- Node.js 22.18 ou plus récent, avec npm.
- Une chaîne Rust, installée avec rustup.
- Les outils en ligne de commande de Xcode.
Développement
npm ci # installe depuis le verrou
npm run tauri -- dev # l'application, avec Vite sur 127.0.0.1:1420
npm run dev # Vite seul, pour ouvrir le rendu dans un navigateur
npm run sidecar # reconstruit le pont MCP (debug)npm run tauri -- devest la boucle normale : Vite démarre sur le port 1420 et la fenêtre Tauri s’ouvre.- Un changement Rust déclenche un rebuild et un redémarrage de la fenêtre ; l’espace est restauré au lancement suivant.
npm run sidecarn’est nécessaire que si le pont, le protocole ou la liste d’outils changent.
Vérifications avant de rendre
npm run typecheck
npm run lint
npm test
cargo fmt --manifest-path src-tauri/Cargo.toml -- --check
cargo test --manifest-path src-tauri/Cargo.toml --lib
cargo build --manifest-path src-tauri/Cargo.toml --no-default-featuresnpm test tourne avec node --experimental-strip-types. Éviter les énumérations, les propriétés de paramètres et les décorateurs dans tout fichier importé par les tests : ils ne sont pas retirés.
Les tests Node couvrent l’espace de travail, le registre, les extensions, le brief, les tuiles Données, OpenAlex, les versions et la navigation du Store. Les tests Rust couvrent le stockage, les paquets (dossier, zip, empreinte, source), le terminal, les agents, l’explorateur, le PDF et les migrations.
Après un changement MCP
Si src-tauri/src/bin/spark-mcp.rs, le protocole ou la liste d’outils changent, reconstruire le pont pour que les clients aient le nouveau binaire :
npm run sidecarUn client déjà connecté garde sa liste d’outils en cache et peut avoir besoin d’une nouvelle session pour voir un nouvel outil noyau.
Release
npm run sidecar:release
npm run tauri -- build --bundles dmgLe DMG n’est ni signé ni notarié. macOS demande une confirmation au premier lancement, et il n’y a aucun canal de mise à jour : une nouvelle version, c’est une nouvelle compilation.
Formatage
npm run format
cargo fmt --manifest-path src-tauri/Cargo.tomlChanger un contrat
Le code fait foi, mais un changement de contrat (SDK, manifeste, index de dépôt, commande Tauri, format de stockage) met à jour le document correspondant dans doc/ dans le même changement. Une décision structurante ajoute une entrée dansdoc/decisions/.