Files
meow/ROADMAP.md
T
2026-11-20 21:47:33 +01:00

180 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Meow v2 (Rust) — Roadmap
Le travail est découpé en **lots** indépendants. Chaque lot :
* tient dans une session de travail (≈ une demi-journée d'agent) ;
* laisse le workspace dans un état qui compile, avec `cargo test` vert ;
* a un **critère de fin** vérifiable.
Légende : ✅ fait · 🟡 partiel · ⬜ à faire. L'architecture cible est décrite dans
[`ARCHITECTURE.md`](ARCHITECTURE.md).
Pour reprendre le travail : lire ce fichier, prendre le premier lot ⬜ dont les dépendances sont
✅, puis mettre à jour ce fichier à la fin du lot. Avant de clore un lot, `scripts/check.sh` **et**
`tests/e2e.sh` doivent passer.
### Ordre conseillé pour la suite
1. **3.8** livraison au moins une fois (correction de fond, petit lot).
2. **4.1 → 4.5** `meow-store` (prérequis du mobile).
3. **5.5, 5.6, 5.9** file d'envoi, accusés, flux d'événements (prérequis de l'UI).
4. **7.1 → 7.3** FFI et intégration dans bastet.
5. Le reste (phases 8–10) selon les priorités.
### Journal
| Date | Lots | Notes |
|---|---|---|
| 2026-11-20 | 0.x, 1.1–1.4, 2.1–2.4, 3.1–3.4, 4.0, 5.1–5.4, 6.1–6.5 | Squelette complet et fonctionnel. 29 tests Rust + `tests/e2e.sh` (≈ 60 appels CLI, 2 serveurs, mémoire et Redis, bascule quand un serveur tombe). Décision : protocole v2 sans compatibilité v1. |
---
## Phase 0 — Fondations
| Lot | Contenu | Fin | État |
|---|---|---|---|
| 0.1 | Workspace Cargo, conventions (fmt, clippy, `forbid(unsafe)`), `.gitignore` | `cargo build` OK | ✅ |
| 0.2 | `proto/meow.proto` v2 + crate `meow-proto` (prost + protox, **sans protoc**) | Les types sont générés au build | ✅ |
| 0.3 | Script `scripts/check.sh` (fmt + clippy + test) | Le script passe | ✅ |
## Phase 1 — `meow-crypto`
| Lot | Contenu | Fin | État |
|---|---|---|---|
| 1.1 | Types de clés (Ed25519, X25519), sérialisation, `zeroize`, `MailboxId` | Tests aller-retour | ✅ |
| 1.2 | AEAD XChaCha20-Poly1305, HKDF à labels, sealed box avec clé de réponse | Tests : chiffrement, altération, mauvaise clé | ✅ |
| 1.3 | Chiffrement au repos par mot de passe (Argon2id) | Tests | ✅ |
| 1.4 | Double Ratchet (spécification Signal), messages hors ordre, `MAX_SKIP`, état sérialisable | Tests : ping-pong, désordre, rejeu refusé, état persisté puis rechargé | ✅ |
| 1.5 | Vecteurs de test figés (KAT) pour les labels v2, et fuzzing des décodeurs (`cargo-fuzz`) | CI fuzz 5 min sans crash | ⬜ |
| 1.6 | Montée de version vers ed25519/x25519-dalek 3.x, chacha20poly1305 0.11 et rand_core 0.10 (on est volontairement sur la génération précédente, stable et cohérente) | Tests verts | ⬜ |
## Phase 2 — `meow-core` (protocole pur, sans E/S)
| Lot | Contenu | Fin | État |
|---|---|---|---|
| 2.1 | Modèle : `ContactKeys`, `Contact`, `ServerInfo`, `ContactCard` ↔ proto | Tests | ✅ |
| 2.2 | Invitation 4 étapes (Offer, Answer, Confirm, Ack) avec transcript signé | Test du flux complet et des falsifications | ✅ |
| 2.3 | Codec des messages : `UserMessage` → padding → DR → `PeerEnvelope` | Aller-retour, désordre | ✅ |
| 2.4 | Requêtes serveur : construction, scellement, ouverture des réponses, `MailboxAuth` | Tests | ✅ |
| 2.5 | Rotation des clés de mailbox (`my_next_identity` v1) et révocation de contact | Tests | ⬜ |
## Phase 3 — `meow-server` (`meowsrv`)
| Lot | Contenu | Fin | État |
|---|---|---|---|
| 3.1 | axum : `/v2/card`, `/v2/rpc`, `/healthz`, configuration TOML + variables d'env, `server.key` en 0600 | Le serveur démarre | ✅ |
| 3.2 | `MemoryStore` : post, pull, long-poll (`Notify`), invitations (shortcode, mot de passe, 3 essais, TTL) | Tests d'intégration en mémoire | ✅ |
| 3.3 | Vérification de `MailboxAuth` (fenêtre de temps, signature, anti-rejeu) | Tests : rejet d'un pull volé ou rejoué | ✅ |
| 3.4 | `RedisStore` (même trait), sélectionné par `storage = "redis://..."` | Tests avec `redis-server` local (ignorés si absent) | ✅ |
| 3.5 | Limites : taille de corps, nombre de dépôts par requête, quota par mailbox, rate limiting par IP | Tests | 🟡 taille de corps et nombre de dépôts faits |
| 3.6 | Packaging : Dockerfile multi-stage, unité systemd, deb/rpm (`cargo-deb`, `cargo-generate-rpm`) | Image < 30 Mo | ⬜ |
| 3.7 | Statistiques agrégées `/v2/stats` (sans métadonnées par utilisateur) | | ⬜ |
| 3.8 | **Livraison au moins une fois** : aujourd'hui `Pull` *vide* la mailbox (comme en v1), donc un message est perdu si le client tombe entre la réponse et la sauvegarde. Il faut un pull qui renvoie des ids, puis un `Ack { ids }` au pull suivant pour supprimer, avec déduplication côté client par id de message | Test : coupure réseau simulée sans perte | ⬜ **prioritaire** |
| 3.9 | Chiffrer l'offre publiée sur le serveur avec une clé placée dans le fragment de l'URL (`…/inv/<code>#<clé>`) : le serveur ne verrait plus le nom ni le message de l'initiateur | Test | ⬜ |
## Phase 4 — `meow-store` (persistance client)
| Lot | Contenu | Fin | État |
|---|---|---|---|
| 4.0 | *Provisoire* : fichier d'identité chiffré unique (`*.mwid2`) dans `meow-client`, avec écriture atomique et verrou exclusif | La CLI fonctionne | ✅ |
| 4.1 | Schéma SQLite (identité, serveurs, contacts, sessions DR, messages, fichiers, file d'envoi) + migrations | Tests | ⬜ |
| 4.2 | Chiffrement applicatif des colonnes (AAD `table‖id`), changement de mot de passe | Tests | ⬜ |
| 4.3 | Contacts cachés : emplacements de taille fixe, déverrouillage par mot de passe secondaire | Tests d'indiscernabilité de taille | ⬜ |
| 4.4 | Pagination de l'historique, recherche, aperçus de fichiers | Tests | ⬜ |
| 4.5 | Bascule de `meow-client` du fichier `.mwid2` vers `meow-store` | e2e vert | ⬜ |
## Phase 5 — `meow-client` (façade asynchrone)
| Lot | Contenu | Fin | État |
|---|---|---|---|
| 5.1 | Transport HTTP (`reqwest`, rustls), ajout de serveur avec épinglage de la carte | | ✅ |
| 5.2 | Invitation par fichier et par serveur (shortcode et mot de passe) | e2e | ✅ |
| 5.3 | Envoi : dépôt sur tous les serveurs de pull du contact, repli en cas d'échec | e2e | ✅ |
| 5.4 | Réception : un pull par serveur regroupant toutes les mailbox, long-poll, traitement, événements | e2e | ✅ |
| 5.5 | File d'envoi persistante avec retries et backoff, envoi hors ligne | Tests | ⬜ |
| 5.6 | Accusés de réception et de lecture chiffrés (dans le ratchet) | e2e | ⬜ |
| 5.7 | Fichiers : découpage en morceaux, reprise, déduplication, limite de taille | e2e (`send-file`) | 🟡 envoi en un seul morceau |
| 5.8 | Trafic leurre : mailbox fictives dans les pulls, ordre aléatoire, padding des requêtes | Tests | ⬜ |
| 5.9 | Stream d'événements (`tokio::broadcast`) et tâche de synchronisation en arrière-plan | | ⬜ |
## Phase 6 — `meow-cli` (`meow`)
| Lot | Contenu | Fin | État |
|---|---|---|---|
| 6.1 | `identity create/show`, `server add/list/remove`, `contact list/show` | | ✅ |
| 6.2 | `invitation create/check/answer/accept/finalize` (fichiers) | e2e | ✅ |
| 6.3 | `server-invitation create/get` | e2e | ✅ |
| 6.4 | `send`, `send-file`, `sync` (commande par défaut), `longpoll` | e2e | ✅ |
| 6.5 | `tests/e2e.sh` : parité avec `meowcli/test.sh` | Script vert | ✅ |
| 6.6 | Sortie `--json` pour l'automatisation, et import d'identité v1 (pseudo et serveurs) | | ⬜ |
## Phase 7 — `meow-ffi` + intégration Flutter
| Lot | Contenu | Fin | État |
|---|---|---|---|
| 7.1 | Crate `meow-ffi` (cdylib) avec `flutter_rust_bridge` v2, API miroir de `meow-client` | Génération Dart OK | ⬜ |
| 7.2 | Build Android (`cargo-ndk` arm64-v8a, armeabi-v7a, x86_64) et Linux, script `deploy.sh` | `libmeow_ffi.so` chargé par bastet | ⬜ |
| 7.3 | Adaptateur Dart dans bastet (`lib/meow2/`), remplacement écran par écran de `meowwrapper.dart` | Chat fonctionnel sur Linux | ⬜ |
| 7.4 | Arrière-plan Android : WorkManager + `client.sync()` | Notifications | ⬜ |
| 7.5 | Suppression de `meowjsonlib` et de `meowwrapper.dart` | | ⬜ |
Correspondance des 63 exports actuels de `meowjsonlib` → API v2 : voir l'annexe A.
## Phase 8 — Fonctionnalités avancées
| Lot | Contenu | État |
|---|---|---|
| 8.1 | Chiffrement des en-têtes DR (variante « header encryption » de Signal) | ⬜ |
| 8.2 | Matriochka (multi-saut) : `Forward { next_server, sealed }`, délais aléatoires | ⬜ |
| 8.3 | Multi-appareils (mailbox d'appareil, synchronisation chiffrée) | ⬜ |
| 8.4 | Push WebSocket (`/v2/ws`) en plus du long-poll | ⬜ |
| 8.5 | Visio : émission de jetons LiveKit côté serveur (`VideoRoomRequest`) | ⬜ |
| 8.6 | Groupes (fan-out par paire, puis évaluation de MLS / `openmls`) | ⬜ |
| 8.7 | Portage de `peer_secure` (SAS) : canal Rust + vérification de l'empreinte `transcript` | ⬜ |
| 8.8 | Liste de serveurs connus, échange de cartes, fédération | ⬜ |
## Phase 9 — Durcissement et livraison
| Lot | Contenu | État |
|---|---|---|
| 9.1 | Fuzzing continu (décodeurs proto, `open_sealed`, `ratchet_decrypt`, RPC serveur) | ⬜ |
| 9.2 | Mémoire verrouillée pour la clé maîtresse (`memsec`), `zeroize` audité | ⬜ |
| 9.3 | Revue de sécurité externe du protocole v2 (document de spécification formelle) | ⬜ |
| 9.4 | Benchmarks (`criterion`) : v1 Go vs v2 Rust (chiffrement, débit serveur) | ⬜ |
| 9.5 | Builds reproductibles, SBOM, `cargo-audit` / `cargo-deny` en CI | ⬜ |
## Phase 10 — Migration
| Lot | Contenu | État |
|---|---|---|
| 10.1 | Déploiement d'un `meowsrv` v2 en parallèle du v1 (port distinct) | ⬜ |
| 10.2 | Import v1 → v2 : pseudo, serveurs, historique des messages (lecture Badger/SQLite v1 via un petit outil Go d'export JSON) | ⬜ |
| 10.3 | Ré-invitation assistée des contacts v1 (message v1 « je passe en v2 » contenant une Offer v2) | ⬜ |
| 10.4 | Arrêt de la v1 | ⬜ |
---
## Annexe A — Correspondance meowjsonlib → API v2
| meowjsonlib (v1) | v2 (`meow-client` / FFI) |
|---|---|
| `InitConfig`, `LoadConfig`, `SetConfig`, `SetMemPass`, `GetStoragePath` | `MeowClient::open(path, password)` / `MeowClient::create(...)` |
| `IdentityCreate`, `LoadIdentity`, `GetIdentity` | `MeowClient::create`, `client.identity()` |
| `*Avatar*` | `client.identity().set_avatar(bytes)` (phase 4.4) |
| `MessageServerCard*`, `MessageServerRemove`, `MessageServerSetBackup` | `client.servers().add/list/remove/update` |
| `ContactsList`, `ContactGet`, `ContactUpdate`, `ContactRemove`, `ContactNameExists` | `client.contacts().list/get/update/remove/find_by_name` |
| `InvitationFile*`, `InvitationMessage*`, `InvitationCheck` | `client.invitations().create/answer/accept/finalize/inspect` (octets indépendants du transport) |
| `InvitationServer*` (8 fonctions) | `client.invitations().publish(offer, opts)` / `fetch(url)` : 2 appels |
| `PollServer`, `LongPollAllServerJobs`, `SaveCheckJobs`, `ConsumeInboxFile` | `client.sync(wait)` + `client.subscribe()` (plus de fichiers inbox) |
| `CreateUserMessageAndSendJob`, `ProcessSendQueues`, `ProcessSentMessages`, `CreateAndStoreUserMessage`, `SendMessage` | `client.messages().send(contact, Outgoing{…})` (la file d'envoi est interne) |
| `LoadMessagesHistory`, `GetMessagePreview`, `GetFilePreview`, `MarkMessageProcessed` | `client.messages().history(contact, page)`, `.mark_read(id)` |
| `Test*`, `TestDb`, `ActivateRemoteLogger` | supprimés |
## Annexe B — Points v1 à ne pas oublier
* Repérés pendant l'analyse, à corriger dans le dépôt Go tant que la v1 tourne :
* `meowsrv/config/meowsrv.json` versionne la clé privée du serveur **et** `api_key`/`api_secret` LiveKit. **Ces secrets sont à changer.**
* `meowsrv` envoie ses logs en dur à `https://log.redroom.link/loki`.
* Les pulls ne sont pas authentifiés (n'importe qui peut vider une mailbox dont il connaît la clé).
* Le suivi de livraison serveur est cassé (`dvyrq:` vs `msg:`).
* Le TTL des invitations est faux (millisecondes au lieu de secondes ; `mwiv:` n'expire jamais).