docs(coordination): report vwb catalog patch

This commit is contained in:
Dom
2026-05-29 17:11:02 +02:00
parent 45b6da5e3f
commit 488d14240a
3 changed files with 127 additions and 0 deletions

View File

@@ -0,0 +1,64 @@
# RESULTAT Codex - Patch A VWB catalogue/palette
Date: 2026-05-29 17:09
Auteur: Codex
Contexte: Dom a valide l'orientation `wait_for_state` comme primitive d'apprentissage Lea distincte de `wait_for_anchor`.
## Decision produit confirmee
VWB reste une interface de supervision / replay / edition controlee pour les micro-competences Lea.
Ce n'est pas un pivot vers un constructeur de workflow autonome.
`wait_for_state` est valide comme action semantique d'attente d'etat:
- apres un clic, un raccourci clavier ou une action systeme;
- verification par titre de fenetre, process actif, ou critere d'ecran;
- distinct de `wait_for_anchor`, qui attend un element visuel localisable.
## Patch A applique
Commit: `45b6da5e3 feat(vwb): load palette from catalog`
Changements principaux:
- backend `/api/vwb/catalog/actions` expose maintenant `keyboard_shortcut`, `wait_for_state`, `pause_for_human`;
- les actions `lea_competence_*` sont masquees par defaut et disponibles seulement avec `show_competences=1`;
- categories catalogue ajoutees: `keyboard`, `wait`, `logic`;
- frontend ToolPalette charge le catalogue backend avec fallback statique;
- frontend PropertiesPanel permet d'editer `wait_for_state`;
- correction TypeScript minimale sur `ConfidenceDashboard` pour accepter le mode `verified`;
- tests unitaires ajoutes sur l'exposition des actions et l'opt-in des competences Lea.
## Validations
Passe:
- `python3 -m pytest tests/unit/test_competence_catalog_loader.py -q`
- `npm run build` dans `visual_workflow_builder/frontend_v4`
Verification runtime locale deja effectuee:
- frontend VWB: `http://localhost:3002`
- backend VWB: `http://localhost:5002`
- `/api/vwb/catalog/actions` retourne 10 actions, 0 competence Lea par defaut;
- `/api/vwb/catalog/actions?show_competences=1` retourne les competences Lea en opt-in.
## Hors scope volontaire du Patch A
Non implemente encore:
- execution runtime reelle de `wait_for_state`;
- adaptateur YAML competence -> workflow VWB;
- endpoint de verdict humain;
- write-back YAML apres validation humaine;
- separation dashboard "reflexes natifs" vs "competences apprises".
## Suite proposee
Patch B minimal:
1. brancher `wait_for_state` dans le runtime VWB avec verification titre/process mockable;
2. ajouter un test unitaire runtime `wait_for_state` succes/timeout;
3. definir le contrat exact de preuve renvoyee par l'action.
Patch C ensuite seulement:
1. adaptateur YAML -> workflow VWB pour `key_win_r_wait_explorer_exe`;
2. verdict humain;
3. write-back YAML.
Point ouvert a arbitrer avec Claude/Qwen:
- normalisation des touches: YAML actuel utilise `win`, Qwen propose `super`; garder `win` en facade Windows et normaliser en interne vers la representation executor.