feat(pcmirror) : le socle Rust de la synchro PC Mirror #2

Merged

foXaCe merged 4 commits from hermes/socle-rust-pcmirror into main 2026-10-16 22:52:20 +02:00

Conversation 2 Commits 4 Files changed 23 +5213 -3

hermes-bot commented 2026-10-15 20:24:37 +02:00

Collaborator

• Copy link
• Copy Markdown

Carte : t_5a9f8dd3 — « PC Mirror 2/6 : socle Rust, CI et outil de synchro pcmirror ».

Ce que fait cette PR

La passe de synchronisation du PC Studio, réécrite en Rust dans crates/pcmirror
(bibliothèque + binaire pcmirror) : configuration TOML, verrou, garde-fous,
exclusions, corbeille datée, rapport JSON et télémétrie. Avec sa documentation
(docs/PCMIRROR-RUST.md), l'exemple config/pcmirror.toml, le CHANGELOG.md du
dépôt et le contrôle CI de la crate.

Rien n'est déployé : le PC exécute toujours sync/pcmirror-sync.sh.

Preuve : l'essai à blanc reproduit la passe en service

pcmirror run --dry-run -c config/pcmirror.toml (sortie complète en commentaire
de la carte). Face au script en service /mnt/Media/Linux/pcmirror-sync.sh
(129 lignes, sha256 cfe3a4b0…, mode 755) :

média — script :

run_rsync -a --delete --partial --exclude-from="$EXCL" --exclude='/_pve-configs/' …
         "$MEDIA/" "$HOST:$REMOTE/"

média — crate :

/usr/bin/rsync -a --delete --partial --exclude-from=/tmp/pcmirror-exclusions-media-….txt
  --exclude=/_rapports/ /mnt/Media/ mirror@192.168.1.210:/mirror/
  --info=progress2 --no-inc-recursive -e 'ssh -i ~/.ssh/pcmirror_ed25519 -o BatchMode=yes …'

Mêmes drapeaux, même fichier de motifs (celui du miroir), mêmes six exclusions
fixes ; la crate ajoute --exclude=/_rapports/ pour ne pas effacer les rapports
qu'elle dépose (écart voulu n° 1).

personnel — script : boucle for d in Documents Images Téléchargements,
--backup --backup-dir="$REMOTE/_corbeille/$TODAY/PC-Home/$d", saut si le dossier
est absent, garde-fou si le dossier local est vide face à une copie pleine.

personnel — crate : une commande par dossier, mêmes --backup --backup-dir,
mêmes saut et garde-fou, avec les phrases du script.

/usr/bin/rsync -a --delete --partial --backup
  --backup-dir=/mirror/_corbeille/2026-10-15/PC-Home/Documents
  /home/…/Documents/ mirror@192.168.1.210:/mirror/PC-Home/Documents/

Même corbeille datée : _corbeille/2026-10-15/PC-Home/<dossier>.

Autres points mesurés : verrou flock -n (un second passage sort 0 sans rien
lancer), _sync-progress.json {"pct":…,"rate":…} toutes les 4 s puis effacé,
_last-sync.json aux mêmes clés que la référence figée
(tests/fixtures/synchro/_last-sync.json), purge de la corbeille
find /mirror/_corbeille -mindepth 1 -maxdepth 1 -type d -mtime +30 -exec rm -rf {} +.

Écarts voulus (documentés dans docs/PCMIRROR-RUST.md)

1. le rapport de passe est déposé sur le miroir dans _rapports/, y compris
   quand la passe a été sautée ; le script n'écrivait que _last-sync.json ;
2. --restaurer-home sort en 1 si une restauration échoue (le script sortait 0) ;
3. une panne de flock autre qu'un verrou occupé remonte en erreur.

Mesures

cargo fmt --check                                   → rien à reformater
cargo clippy --all-targets --locked -- -D warnings  → 0 avertissement
cargo test --release --locked                       → 68 passés, 0 échec
cargo llvm-cov --locked --summary-only              → 89,15 % régions, 87,58 % lignes

CI

Aucun exécutant Forgejo n'est rattaché à foXaCe/pc-mirror (constat de la carte
1/6, revérifié) : les commandes ci-dessus ont été lancées à la main, la CI ne
peut pas les rejouer tant qu'un exécutant n'est pas enregistré pour ce dépôt. Le
workflow .forgejo/workflows/ci.yml est prêt pour ce jour-là.

Carte : t_5a9f8dd3 — « PC Mirror 2/6 : socle Rust, CI et outil de synchro pcmirror ». ## Ce que fait cette PR La passe de synchronisation du PC Studio, réécrite en Rust dans `crates/pcmirror` (bibliothèque + binaire `pcmirror`) : configuration TOML, verrou, garde-fous, exclusions, corbeille datée, rapport JSON et télémétrie. Avec sa documentation (`docs/PCMIRROR-RUST.md`), l'exemple `config/pcmirror.toml`, le `CHANGELOG.md` du dépôt et le contrôle CI de la crate. Rien n'est déployé : le PC exécute toujours `sync/pcmirror-sync.sh`. ## Preuve : l'essai à blanc reproduit la passe en service `pcmirror run --dry-run -c config/pcmirror.toml` (sortie complète en commentaire de la carte). Face au script en service `/mnt/Media/Linux/pcmirror-sync.sh` (129 lignes, sha256 `cfe3a4b0…`, mode 755) : média — script : run_rsync -a --delete --partial --exclude-from="$EXCL" --exclude='/_pve-configs/' … "$MEDIA/" "$HOST:$REMOTE/" média — crate : /usr/bin/rsync -a --delete --partial --exclude-from=/tmp/pcmirror-exclusions-media-….txt --exclude=/_rapports/ /mnt/Media/ mirror@192.168.1.210:/mirror/ --info=progress2 --no-inc-recursive -e 'ssh -i ~/.ssh/pcmirror_ed25519 -o BatchMode=yes …' Mêmes drapeaux, même fichier de motifs (celui du miroir), mêmes six exclusions fixes ; la crate ajoute `--exclude=/_rapports/` pour ne pas effacer les rapports qu'elle dépose (écart voulu n° 1). personnel — script : boucle `for d in Documents Images Téléchargements`, `--backup --backup-dir="$REMOTE/_corbeille/$TODAY/PC-Home/$d"`, saut si le dossier est absent, garde-fou si le dossier local est vide face à une copie pleine. personnel — crate : une commande par dossier, mêmes `--backup --backup-dir`, mêmes saut et garde-fou, avec les phrases du script. /usr/bin/rsync -a --delete --partial --backup --backup-dir=/mirror/_corbeille/2026-10-15/PC-Home/Documents /home/…/Documents/ mirror@192.168.1.210:/mirror/PC-Home/Documents/ Même corbeille datée : `_corbeille/2026-10-15/PC-Home/<dossier>`. Autres points mesurés : verrou `flock -n` (un second passage sort 0 sans rien lancer), `_sync-progress.json` `{"pct":…,"rate":…}` toutes les 4 s puis effacé, `_last-sync.json` aux mêmes clés que la référence figée (`tests/fixtures/synchro/_last-sync.json`), purge de la corbeille `find /mirror/_corbeille -mindepth 1 -maxdepth 1 -type d -mtime +30 -exec rm -rf {} +`. ## Écarts voulus (documentés dans `docs/PCMIRROR-RUST.md`) 1. le rapport de passe est déposé sur le miroir dans `_rapports/`, y compris quand la passe a été sautée ; le script n'écrivait que `_last-sync.json` ; 2. `--restaurer-home` sort en 1 si une restauration échoue (le script sortait 0) ; 3. une panne de `flock` autre qu'un verrou occupé remonte en erreur. ## Mesures cargo fmt --check → rien à reformater cargo clippy --all-targets --locked -- -D warnings → 0 avertissement cargo test --release --locked → 68 passés, 0 échec cargo llvm-cov --locked --summary-only → 89,15 % régions, 87,58 % lignes ## CI Aucun exécutant Forgejo n'est rattaché à `foXaCe/pc-mirror` (constat de la carte 1/6, revérifié) : les commandes ci-dessus ont été lancées à la main, la CI ne peut pas les rejouer tant qu'un exécutant n'est pas enregistré pour ce dépôt. Le workflow `.forgejo/workflows/ci.yml` est prêt pour ce jour-là.

hermes-bot added 8 commits 2026-10-15 20:24:38 +02:00

test(fixtures): enregistrer les réponses de référence du serveur d'état et de la synchro ... 5a9a88dc97

19 sondages contre le serveur d'état du LXC 108 (codes, en-têtes, corps), la
copie de référence du script de synchro déployé, ses unités systemd, la ligne
de cron périmée et les fichiers de télémétrie lus dans le miroir.

Ajoute capturer.sh (rejoue la capture, en lecture seule) et
verifier_contrat.py (20 contrôles du contrat du serveur vivant).

docs(comportement): cartographier la synchro et le serveur d'état ... 7f4dfdd25f

Documente pcmirror-sync.sh tel qu'il tourne (sources, exclusions, options
rsync, verrou, garde-fous, journaux, codes de sortie, minuteur systemd horaire
à la place du cron périmé, télémétrie, mode restauration) et chaque route de
status-server/server.py avec les fichiers qu'elle lit et écrit.

Relève les écarts : sync/pcmirror-sync.sh du dépôt est la version du 4 juillet
alors que celle déployée date du 12 octobre ; les seuils de santé affichés ne
correspondent pas au code ; POST /exclude supprime le dossier du miroir.

ci: contrôler les réponses de référence à chaque poussée ... 3db9522adc

Le dépôt n'avait aucun workflow : la carte demandait une CI verte et il n'y
avait rien à passer. Ajoute un métier léger sur l'exécutant du PC (étiquette
`studio`, mode host) : les scripts Python compilent, les 19 réponses de
référence sont complètes et conformes (tests/verifier_reference.py), les
fichiers de télémétrie se relisent. Aucun accès réseau, aucun secret.

Le socle Rust de la carte 2/6 viendra s'ajouter à ce même fichier.

ci: demander l'étiquette pc-lourd pour vérifier l'exécutant disponible 68a87b2acb

docs: notes de reference sur la synchro pcmirror (depot vs version en service) ... 4166906e46

Cause : le script du depot (sync/pcmirror-sync.sh, 79 lignes) et celui en service
(tests/fixtures/synchro/pcmirror-sync.sh.deploye, 129 lignes) ont diverge (verrou,
garde-fous disque/hote, --partial, exclusions PC-Home, code de sortie, corbeille).
Mesure : avec rsync 3.5.1 et LC_ALL=C, la progression est ecrite en octets a
separateurs de milliers, illisible par l'expression de la ligne 69 du script en
service ; l'expression du depot (l. 50) ne lit jamais le debit.

Remede : inventaire ligne par ligne des deux versions, ecarts, mesures rejouables et
correctif propose (-h, en gardant LC_ALL=C), a integrer dans docs/COMPORTEMENT.md.

tests: capturer les routes qui écrivent et vérifier leurs effets de bord ... 3da9d160f7

Les instantanés de référence ne couvraient que les routes en lecture : sonder
POST /exclude sur le serveur du LXC 108 supprime un dossier du miroir, donc la
capture en ligne ne pouvait pas montrer ces routes sans détruire des données.

capturer_local.py monte un miroir factice dans /tmp, y écrit un dossier illisible
et exécute le server.py du dépôt — seules trois lignes changent (racine, adresse
d'écoute, message de démarrage), le diff est affiché et vérifié à chaque
exécution. Il rejoue 17 sondes et contrôle les effets de bord : /exclude supprime
bien le dossier du miroir, conserve le motif existant de _exclusions.txt et
laisse les fichiers voisins intacts ; /include retire le motif sans restaurer le
dossier. --verifier rejoue les mêmes sondes et compare les codes au manifeste
attendu.json, sans rien réécrire : c'est ce que lance la CI.

Complètent le jeu en ligne les deux sondes qui manquaient (HEAD et DELETE par
capturer.sh), et verifier_reference.py relit désormais les deux jeux
d'instantanés (trios présents, codes conformes au manifeste, en-têtes en
HTTP/1.0, couverture du vérificateur en ligne).

Deux défauts mesurés sont documentés dans docs/COMPORTEMENT.md : HEAD répond 501
et annonce un Content-Length sans écrire aucun corps (vérifié sur la socket nue),
et le confinement de /files, sans séparateur, accepte un dossier voisin dont le
nom prolonge la racine. Le comportement du serveur n'est pas modifié.

docs: sourcer et corriger l'état mesuré de COMPORTEMENT.md ... ea9c9dfafb

La section « écart dépôt / version en service » et la méthode s'appuyaient sur
des copies et des dates non nommées, et trois affirmations étaient fausses.

- planification : cron n'est pas installé sur le PC (« le paquet cronie n'a pas
  été trouvé », `cronie.service` inconnu) ; les unités systemd --user sont
  identiques dans la sauvegarde kde-backup (81326f75…/d10a93c8…) et dans les
  fixtures, et l'en-tête du script en service (l. 14) les déclare ; deux
  horodatages de `_last-sync.json` à ~:03 de l'heure pleine corroborent la
  cadence horaire.
- provenance nommée : `/mnt/Media/Nas/scripts/` (fichiers des 3 et 4 juillet)
  pour la copie périmée de `sync/`, `kde-backup` pour les unités, et
  `/mnt/Media/Nas/scripts/mirror-status-server.py` (4 juillet, 814360fb…,
  889 lignes, 0 `aria-hidden`, 0 `class="vh"`) pour la version qui précède le
  dépôt ; l'unité `mirror-status.service` (de36f6c0…) est lue dans le même
  dossier.
- corrections : la ligne ssh est passée par `-e "$RSH"` (pas `RSYNC_RSH`) ; les
  exclusions fixes sont ajoutées après la dérivation d'`EXCL2`, donc portées par
  le seul rsync média ; les dossiers personnels partent en un seul rsync aplati
  et le code de sortie vient du dernier rsync (un échec média est masqué) ; le
  script du dépôt écrit aussi `rc` dans `_last-sync.json`.
- mesure ajoutée : `/dl?p=_pve-configs/.last-backup` → 404 le 2026-10-15, ce qui
  explique le champ vide `backup_pve_dernier` du tableau de bord ; relevé du
  serveur à 17:31 (89,7 s de scan, 3 255 290 fichiers, 152,4 Go).

Tests : `tests/verifier_reference.py` 21/21 en ligne et 17/17 hors ligne,
`tests/fixtures/capturer_local.py --verifier` 0 incident,
`tests/fixtures/verifier_contrat.py` 22/22 sur 192.168.1.210:9090.

feat(pcmirror): socle Rust de la synchro PC Mirror ... c250e5ac1d

La passe de synchronisation du PC Studio est réécrite en Rust : crate
`crates/pcmirror` (bibliothèque et binaire), configuration TOML, verrou,
garde-fous, exclusions, corbeille datée, rapport JSON et télémétrie aux mêmes
clés que le script en service.

La référence reste `sync/pcmirror-sync.sh`, que le PC exécute toujours : rien
n'est déployé. `pcmirror run --dry-run` affiche les commandes `rsync` prévues et
reproduit la passe décrite dans `docs/COMPORTEMENT-SYNCHRO.md`.

- verrou `flock` sans attente, comme `flock -n` : un second passage n'attend pas
  et sort en 0 ; une panne de `flock` autre qu'un verrou occupé remonte au lieu
  de se faire passer pour une passe déjà en cours ;
- garde-fous : média absent ou vide, hôte injoignable, dossier personnel vide
  face à une copie pleine, dossier personnel absent ignoré,
  `--ignorer-garde-fous` pour outrepasser un essai à la main ;
- exclusions : les six motifs fixes du script, `_exclusions.txt` du miroir pour
  le transfert média, `/_rapports/` pour ne pas effacer les rapports déposés ;
- rapport JSON de passe, déposé sur le miroir dans `_rapports/` ; télémétrie
  `_last-sync.json` et `_sync-progress.json` (`{"pct":…,"rate":…}` toutes les
  4 s), aux clés du script ;
- CI Forgejo : formatage, `clippy` sans avertissement, tests lançant un vrai
  `rsync` dans `/tmp`, relecture des fichiers de référence.

Mesures : 68 tests passés (`cargo test --release --locked`), `clippy
--all-targets -D warnings` sans avertissement, couverture 89,15 % des régions /
87,58 % des lignes. Référence de parité : le script en service
`/mnt/Media/Linux/pcmirror-sync.sh` (129 lignes, sha256 `cfe3a4b0…`).

hermes-bot added 1 commit 2026-10-15 20:27:56 +02:00

ci(pcmirror): mesurer la couverture, documenter les variables d'environnement ... 3bb407d7a7

La carte 2/6 demande la couverture dans la CI et une configuration sans secret.
L'étape `cargo llvm-cov --locked --summary-only --fail-under-lines 80` est ajoutée
au contrôle de la crate : elle mesure quand `cargo-llvm-cov` est installé sur
l'exécutant, et l'écrit sans échouer sinon (l'outil n'est pas garanti partout).
Vérifié à la main : la commande sort 0 (87,58 % des lignes, seuil 80).

`.env.example` recense les trois variables lues par la crate — `PCMIRROR_CONFIG`,
`HOME`, `XDG_RUNTIME_DIR` — sans aucun secret ; la clé SSH reste dans `~/.ssh`,
hors du dépôt. Le README pointe ce fichier.

hermes-bot commented 2026-10-15 20:29:11 +02:00

Author

Collaborator

• Copy link
• Copy Markdown

Note pour la relecture : la branche part de hermes/cartographie-pc-mirror (la carte 1/6, PR #1), comme le prévoit l'atelier. main n'ayant encore que l'import initial, le diff contient donc les 8 commits de la carte 1/6 (fixtures, docs de comportement, workflow) en plus des deux commits de cette carte. Fusionner cette PR fusionne l'ensemble ; la PR #1 devient alors redondante.

Contenu propre à cette carte : crates/pcmirror/ (12 modules + tests/passe_complete.rs), Cargo.toml/Cargo.lock, config/pcmirror.toml, docs/PCMIRROR-RUST.md, CHANGELOG.md, .env.example, et la partie Rust de .forgejo/workflows/ci.yml.

Mesures sur le poste (CI non exécutable, voir le corps de la PR) :

cargo fmt --check                                              -> rien à reformater
cargo clippy --all-targets --locked -- -D warnings             -> 0 avertissement
cargo test --release --locked                                  -> 68 passés, 0 échec
cargo llvm-cov --locked --summary-only --fail-under-lines 80   -> EXIT=0 (87,58 % des lignes)

Note pour la relecture : la branche part de `hermes/cartographie-pc-mirror` (la carte 1/6, PR #1), comme le prévoit l'atelier. `main` n'ayant encore que l'import initial, le diff contient donc les 8 commits de la carte 1/6 (fixtures, docs de comportement, workflow) en plus des deux commits de cette carte. Fusionner cette PR fusionne l'ensemble ; la PR #1 devient alors redondante. Contenu propre à cette carte : `crates/pcmirror/` (12 modules + `tests/passe_complete.rs`), `Cargo.toml`/`Cargo.lock`, `config/pcmirror.toml`, `docs/PCMIRROR-RUST.md`, `CHANGELOG.md`, `.env.example`, et la partie Rust de `.forgejo/workflows/ci.yml`. Mesures sur le poste (CI non exécutable, voir le corps de la PR) : cargo fmt --check -> rien à reformater cargo clippy --all-targets --locked -- -D warnings -> 0 avertissement cargo test --release --locked -> 68 passés, 0 échec cargo llvm-cov --locked --summary-only --fail-under-lines 80 -> EXIT=0 (87,58 % des lignes)

hermes-bot added the

operateur

label 2026-10-15 20:50:06 +02:00

hermes-fusion added the

ci-rouge

label 2026-10-16 10:25:02 +02:00

hermes-fusion commented 2026-10-16 10:25:02 +02:00

Collaborator

• Copy link
• Copy Markdown

fusion-auto : pas de fusion, la CI est rouge (Crate pcmirror, Crate pcmirror). Le chef de l'atelier renvoie la carte à l'agent ; l'étiquette tombera d'elle-même une fois corrigé.

`fusion-auto` : pas de fusion, la CI est rouge (Crate pcmirror, Crate pcmirror). Le chef de l'atelier renvoie la carte à l'agent ; l'étiquette tombera d'elle-même une fois corrigé.

foXaCe added 1 commit 2026-10-16 22:43:35 +02:00

CI : le cargo du runner est dans /usr/bin et les navigateurs Playwright sont deja installes 671480bf9f

foXaCe added 1 commit 2026-10-16 22:44:28 +02:00

CI : le relevé des outils ne casse plus le pipeline (SIGPIPE 141) 9f9b15038f

hermes-fusion removed the

ci-rouge

label 2026-10-16 22:45:02 +02:00

foXaCe merged commit d15f5a4b0a into main 2026-10-16 22:52:20 +02:00

foXaCe referenced this pull request from a commit 2026-10-16 22:52:21 +02:00

Merge pull request 'feat(pcmirror) : le socle Rust de la synchro PC Mirror' (#2) from hermes/socle-rust-pcmirror into main

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels   

ci-rouge

  

conflit

  

operateur

  

relu

No labels

ci-rouge

conflit

operateur

relu

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

3 participants

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

foXaCe/pc-mirror!2

No description provided.