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 -- dev est 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 sidecar n’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-features

npm 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 sidecar

Un 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 dmg

Le 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.toml

Changer 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/.