ETM-Schurig/etm-powersync-energy-plugin-etm
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
etm-powersync-energy-plugin.../tools
History
Patrick Schurig fb581218c8 feat(outils): etm-powersync-schema-check, validateur du contrat OpenRPC 
Python, bibliothèque standard seule. Sous-ensemble de JSON Schema déclaré ;
un mot-clé non géré est une erreur de schéma, jamais ignoré. Valide un
message, une session NDJSON ou des traces ; --semantic applique
x-etm-semantic-rules dans l'ordre du validateur du moteur (une règle sans
implantation, ou l'inverse, est une erreur).

Test : références du sérialiseur et traces réelles du moteur conformes ;
optimiseur de référence mode par mode, et qui rejette chaque mode mauvais.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-17 21:15:51 +02:00
..
etm-powersync-ref-optimizer
feat(ref-optimizer): --capture de la session et mode wrong-type
2026-10-17 21:15:51 +02:00
audit-controles.py
fix: la contradiction progressMeasurable/regime, et la garde qui la rend sûre
2026-09-03 07:21:13 +02:00
check-simulation-clock.py
[upstream-fix] un verdict de test ne doit pas dépendre de l'heure
2026-08-31 00:10:55 +02:00
ci-quality.sh
[upstream-fix] un verdict de test ne doit pas dépendre de l'heure
2026-08-31 00:10:55 +02:00
etm-powersync-schema-check
feat(outils): etm-powersync-schema-check, validateur du contrat OpenRPC
2026-10-17 21:15:51 +02:00
etm-powersync-trace-replay
fix(tools): trace-replay compare une action state sur son état seul (brief 4 T7)
2026-10-17 13:16:43 +02:00
gen-doc.sh
ci: le contrôle de qualité documentaire — écrit, éprouvé, PAS en service
2026-08-29 11:33:46 +02:00
gen-rules.py
tools: la classe « cadrage » — et « spécifiée seule » veut enfin dire quelque chose
2026-08-29 12:51:55 +02:00
inserer-doc.py
tools: un garde-fou à l'écriture pour le piège d'insertion doxygen
2026-09-03 07:54:24 +02:00
README.md
feat(tools): l'optimiseur de référence s'annonce powersync-optimizer (correctifs brief 4, point 1)
2026-10-17 14:32:51 +02:00
repair_energylogs.py
feat(lot D): libellé jusqu'à l'adaptateur, relais comparés par table, paliers publiés
2026-08-26 10:07:22 +02:00
rules-noncode.txt
docs: retrait du nom « optimiseur ETM » des fichiers publiés (brief 4 T0.5)
2026-10-16 14:18:09 +02:00
rules-retired.txt
docs(règles): dix numéros retirés, deux tables supprimées, l'index câblé à Doxygen
2026-08-29 09:36:18 +02:00

README.md

tools/

Outils de développement et d'exploitation du plugin. Ce fichier ne décrit que etm-powersync-trace-replay ; l'optimiseur de référence a le sien (etm-powersync-ref-optimizer/README.md), les autres scripts portent leur mode d'emploi en en-tête.

Noms d'optimiseur : powersync-optimizer = exemple de référence GPL (ce dépôt) ; etm-optimizer = optimiseur ETM (propriétaire, hors de ce dépôt). L'optimiseur de référence s'annonce powersync-optimizer au handshake ; son fichier garde le préfixe des artefacts.

etm-powersync-trace-replay — rejouer des traces de décision

Python 3, bibliothèque standard seule, GPL-3.0 comme le dépôt.

Le moteur écrit, quand le réglage optimizerTrace est activé (NymeaEnergy.SetOptimizerTrace, défaut : désactivé), une ligne NDJSON par cycle dans <storagePath>/etm-powersync-optimizer-trace-AAAA-MM-JJ.ndjson (format : INTERFACE.md, « Traces de décision » ; protocole : docs/OPTIMIZER_PROTOCOL.md annexe D). L'outil renvoie chaque request d'un de ces fichiers à un optimiseur et compare ses actions au plan enregistré.

# optimiseur local (défaut : unix:///run/powersync/optimizer.sock)
./tools/etm-powersync-trace-replay etm-powersync-optimizer-trace-2026-10-17.ndjson

# optimiseur sur le LAN, avec token, échec si une action diffère
./tools/etm-powersync-trace-replay trace.ndjson --endpoint tcp://nas:7600 \
    --token-file ~/.config/etm-optimizer.token --fail-on-divergence
  • Token : seulement par --token-file (jamais en argument : il se verrait dans ps). Il n'est ni affiché ni écrit.
  • Sorties : <trace>.replay-<horodatage>.ndjson (une ligne par requête rejouée : réponse, latence, écarts) et ….summary.txt, à côté de la trace. Jamais d'écrasement (--out vers un fichier existant est refusé).
  • Comparaison : charge, kind, puissance d'une consigne (setpoint, à --tolerance-w près), état d'une action state — la puissance d'une action state n'est pas comparée (le §6 ne la définit pas, et le plan du rule-based tracé la porte).
  • Résumé : requêtes rejouées, taux d'abstention, computeMs médian et max (s'il est fourni dans diagnostics), cycles non comparables (réponse enregistrée en erreur), cycles dont les actions du créneau courant diffèrent du plan enregistré, avec la liste.
  • Code de sortie : 0 ; 1 avec --fail-on-divergence s'il y a divergence ; 2 sur erreur (fichier, connexion, handshake refusé).
  • Les lignes L2 (strategy: "none") n'ont pas de requête : elles ne sont pas rejouées.

Les traces contiennent des mesures du site : elles restent sur le site. L'export est manuel (copie du fichier par l'installateur) ; l'outil ne parle qu'à l'endpoint donné.

Test : python3 -I tests/tools/etm-powersync-trace-replay-test.py (serveur de test minimal qui renvoie les réponses enregistrées — ce n'est pas l'optimiseur de référence).