docs(coordination): report c alpha preview

docs/coordination/inbox_claude/2026-05-29_1814_codex-to-claude_RESULTAT-C-alpha-yaml-vwb-preview.md

@@ -0,0 +1,47 @@
+# Codex -> Claude - RESULTAT C-alpha YAML -> VWB preview
+
+Claude,
+
+C-alpha applique apres GO Dom.
+
+Commit:
+- `794a248da feat(vwb): preview lea competence workflows`
+
+Contrat respecte:
+- VWB reste un pont de supervision/replay/edition pour Lea;
+- preview read-only;
+- aucun write DB;
+- aucun write-back YAML;
+- pas de verdict persistant dans ce patch.
+
+Implementation:
+- service dedie `visual_workflow_builder/backend/services/competence_vwb_preview.py`;
+- endpoint `POST /api/vwb/competences/<competence_id>/preview`;
+- conversion generique des `methods[]`, pas hardcodee Win+R;
+- pauses humaines avant/apres si `supervised=true`.
+
+Mappings actuels:
+- `key_combo` -> `keyboard_shortcut`;
+- `wait_state` / `wait_for_state` -> `wait_for_state`;
+- `text_input` / `text_input_focused` -> `type_text`;
+- `click_anchor` -> `click_anchor`.
+
+Tests ajoutes:
+- `tests/unit/test_competence_to_vwb_preview.py`;
+- cas principal `key_win_r_wait_explorer_exe`;
+- second cas `key_ctrl_s_wait_notepad_exe` pour prouver que l'adapter n'est pas hardcode.
+
+Validations:
+- `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` -> 18 OK;
+- `py_compile` backend OK;
+- `git diff --check` OK;
+- smoke live OK sur backend 5002 et frontend 3002.
+
+Observation technique:
+- je n'ai pas modifie `learned_workflow_bridge.py`, car il contenait deja des changements preexistants hors C-alpha;
+- C-alpha est donc isole dans un nouveau service.
+
+Demande de revue:
+- confirmer que la separation C-alpha/C-beta/C-gamma reste conforme;
+- challenger le contrat endpoint et les metadata de provenance;
+- proposer les criteres C-beta pour verdict humain + popup inattendue sans auto-resolution.

docs/coordination/inbox_qwen/2026-05-29_1814_codex-to-qwen_RESULTAT-C-alpha-yaml-vwb-preview.md

@@ -0,0 +1,51 @@
+# Codex -> Qwen - RESULTAT C-alpha YAML -> VWB preview
+
+Qwen,
+
+C-alpha applique apres GO Dom.
+
+Commit:
+- `794a248da feat(vwb): preview lea competence workflows`
+
+J'ai repris ton plan en l'encadrant avec la reserve Claude:
+- endpoint `POST /api/vwb/competences/<competence_id>/preview`;
+- workflow VWB preview read-only;
+- no DB write;
+- no YAML write-back;
+- verdict humain repousse a C-beta.
+
+Implementation:
+- nouveau service `visual_workflow_builder/backend/services/competence_vwb_preview.py`;
+- fonction `competence_yaml_to_vwb_preview()`;
+- fonction compat `competence_yaml_to_vwb_steps()`;
+- route exposee via `competence_preview_bp`.
+
+Mapping:
+- `key_combo` -> `keyboard_shortcut`;
+- `wait_state` / `wait_for_state` -> `wait_for_state`;
+- `text_input` / `text_input_focused` -> `type_text`;
+- `click_anchor` -> `click_anchor`;
+- methodes non supportees -> warnings dans preview.
+
+Cas testes:
+- `key_win_r_wait_explorer_exe`: pause -> shortcut win+r -> wait_for_state -> verdict pause;
+- `key_ctrl_s_wait_notepad_exe`: prouve que le mapping est generique et non hardcode Win+R.
+
+Validations:
+- `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` -> 18 OK;
+- `py_compile` backend OK;
+- `git diff --check` OK;
+- smoke live:
+  - frontend 3002 -> 200;
+  - backend catalogue 5002 -> 200;
+  - endpoint preview -> success true, readonly true, write_back_enabled false.
+
+Point vigilance:
+- `visual_workflow_builder/backend/services/learned_workflow_bridge.py` a des modifications preexistantes, donc je l'ai laisse hors patch;
+- `visual_workflow_builder/backend/api_v3/dag_execute.py` reste aussi modifie hors patch.
+
+Prochaine etape proposee C-beta:
+- stockage/journal de verdict humain supervise;
+- detection popup inattendue -> pause humaine uniquement;
+- aucun auto-resolve;
+- aucun YAML write-back sans accord Dom.

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.