docs(coordination): report c alpha preview

docs/coordination/syntheses/2026-05-29_1814_codex_RESULTAT-C-alpha-yaml-vwb-preview.md

@@ -0,0 +1,77 @@
+# Codex - RESULTAT C-alpha YAML -> VWB preview
+
+Date: 2026-05-29 18:14
+Branche: `backup/post-demo-2026-05-19`
+
+## Decision Dom
+
+Dom a donne son GO pour C-alpha.
+
+Cadre confirme:
+- finalite Lea = apprentissage par demonstration;
+- VWB = pont de supervision, replay et edition, pas produit workflow-builder separe;
+- pas de write-back YAML sans validation explicite de Dom;
+- Claude et Qwen restent garde-fous fonctionnels et techniques.
+
+## Implementation
+
+Commit:
+- `794a248da feat(vwb): preview lea competence workflows`
+
+Ajoute:
+- service `visual_workflow_builder/backend/services/competence_vwb_preview.py`;
+- endpoint `POST /api/vwb/competences/<competence_id>/preview`;
+- tests `tests/unit/test_competence_to_vwb_preview.py`.
+
+Contrat C-alpha:
+- lecture YAML competence Lea;
+- conversion generique des `methods[]` en steps VWB;
+- insertion optionnelle de pauses humaines avant/apres;
+- workflow preview read-only;
+- aucun write DB;
+- aucun write-back YAML;
+- metadata de provenance sur les steps.
+
+Mappings supportes:
+- `key_combo` -> `keyboard_shortcut`;
+- `wait_state` / `wait_for_state` -> `wait_for_state`;
+- `text_input` / `text_input_focused` -> `type_text`;
+- `click_anchor` -> `click_anchor`.
+
+## Validations
+
+Tests:
+- `python3 -m pytest tests/unit/test_competence_to_vwb_preview.py tests/unit/test_competence_catalog_loader.py tests/unit/test_vwb_wait_for_state.py -q`
+- resultat: 18 tests OK.
+
+Controles:
+- `python3 -m py_compile visual_workflow_builder/backend/services/competence_vwb_preview.py visual_workflow_builder/backend/catalog_routes_v2_vlm.py visual_workflow_builder/backend/app.py` OK;
+- `git diff --check` OK.
+
+Smoke live:
+- frontend `http://localhost:3002` -> 200;
+- backend catalogue `http://localhost:5002/api/vwb/catalog/actions` -> 200;
+- preview `key_win_r_wait_explorer_exe` -> `pause_for_human`, `keyboard_shortcut`, `wait_for_state`, `pause_for_human`;
+- keys preservees: `["win", "r"]`;
+- expected_state preserve: `{"process_active": "explorer.exe", "window_title_in": ["Ex\\u00e9cuter"]}`.
+
+## Point important worktree
+
+Les fichiers suivants restent modifies mais n'ont pas ete embarques dans C-alpha:
+- `visual_workflow_builder/backend/api_v3/dag_execute.py`;
+- `visual_workflow_builder/backend/services/learned_workflow_bridge.py`.
+
+J'ai volontairement cree un service dedie au preview au lieu d'empiler dans `learned_workflow_bridge.py`, car ce fichier avait deja des changements preexistants.
+
+## Suite proposee
+
+C-beta:
+- enregistrer un verdict humain supervise sur le replay;
+- journaliser le resultat de supervision;
+- detecter les popups inattendues et mettre en pause, sans auto-resolution;
+- toujours pas de write-back YAML automatique.
+
+C-gamma seulement apres accord Dom:
+- promotion/write-back YAML eventuel;
+- criteres d'acceptation plus stricts;
+- trajectoire apprentissage Lea.