[ACC-2.2] Pont MCP Flowdeck → ObsiGate (T0–T5) #20

Open
opened 2026-10-20 21:19:45 -04:00 by bruno · 3 comments
Owner

Brief pour Hermes. Exécuter le plan du pont MCP vers ObsiGate (tests T0–T5), un seul vault au départ.

⛔ Bloqué par Q-A et Q-B (voir Projets/fusion-trois-apps#1) : ne pas démarrer avant les réponses de Bruno. Épopée : Projets/fusion-trois-apps#6.

**Brief pour Hermes.** Exécuter le plan du pont MCP vers ObsiGate (tests T0–T5), **un seul vault au départ**. ⛔ **Bloqué par Q-A et Q-B** (voir Projets/fusion-trois-apps#1) : ne pas démarrer avant les réponses de Bruno. Épopée : Projets/fusion-trois-apps#6.
bruno added this to the Fusion — accès centralisé milestone 2026-10-20 21:19:45 -04:00
bruno added the kanban_Backlog label 2026-10-20 21:19:45 -04:00
bruno added the kanban:agent-task label 2026-10-26 11:29:58 -04:00
bruno added kanban:in_progress and removed kanban_Backlog labels 2026-10-26 11:40:37 -04:00
Author
Owner

🚧 Pris en charge par Spark (2026-10-26) — carte de la colonne « Tâches à traiter » du projet « Flowdeck dev ».\n\nAudit préalable (code 7.82.4, plan pont-mcp-etape1-lectures-seules.md) — deux écarts réels côté Flowdeck, qui font échouer T0 contre un serveur à session comme ObsiGate :\n\n1. Aucune gestion de session MCP : le client (mcp_client._rpc) jette les en-têtes de réponse — le Mcp-Session-Id renvoyé par initialize n'est jamais réémis, et call_tool appelle directement tools/call sans handshake. Contre TikTak (sans état) ça passe ; contre ObsiGate (Streamable HTTP à session, Accept: application/json, text/event-stream, protocole 2025-03-26), T0 échoue.\n2. Garde-fou n° 2 du plan non tenu : les outils MCP dynamiques ne sont jamais classés écrivants — WRITE_TOOLS ne contient que les outils internes, donc un apply_* d'ObsiGate passerait les deux portes (politique d'approbation + rôles) comme une simple lecture. Le plan exige que propose_*/apply_* ne soient pas utilisables silencieusement depuis un agent Flowdeck.\n\nPlan (côté code) : handshake systématique avant tools/call + propagation du Mcp-Session-Id ; parse_body SSE multi-messages (choisir le message de réponse, pas le premier data:) ; classification des outils MCP (annotations readOnlyHint du serveur, sinon heuristique de nom : propose_*, create_*… = écrivant ; apply_* bloqué au client, patron §7.5) branchée sur les deux portes ; preset de connecteur obsigate (comme tiktak en ACC-2.1, URL dérivée de la config dev/prod) pour que le branchement se fasse en un geste ; tests T0 simulés contre un faux serveur ObsiGate à session stricte.\n\nReste à ta charge pour la preuve réelle T0–T5 (inchangé, le plan le prévoit) : créer la clé API ObsiGate dédiée au pont, limitée à un seul vault, et trancher Q-A/Q-B (fusion #1) — je ne peux ni créer la clé à ta place ni décider du vault. Dès la clé posée dans un connecteur « ObsiGate » de Flowdeck, le probe et les outils mcp_obsigate_* seront fonctionnels. Livraison code en Révision avec CI verte.

🚧 **Pris en charge par Spark** (2026-10-26) — carte de la colonne « Tâches à traiter » du projet « Flowdeck dev ».\n\n**Audit préalable (code 7.82.4, plan `pont-mcp-etape1-lectures-seules.md`) — deux écarts réels côté Flowdeck, qui font échouer T0 contre un serveur à session comme ObsiGate :**\n\n1. **Aucune gestion de session MCP** : le client (`mcp_client._rpc`) jette les en-têtes de réponse — le `Mcp-Session-Id` renvoyé par `initialize` n'est jamais réémis, et `call_tool` appelle directement `tools/call` **sans handshake**. Contre TikTak (sans état) ça passe ; contre ObsiGate (Streamable HTTP à session, `Accept: application/json, text/event-stream`, protocole 2025-03-26), T0 échoue.\n2. **Garde-fou n° 2 du plan non tenu** : les outils MCP dynamiques ne sont **jamais classés écrivants** — `WRITE_TOOLS` ne contient que les outils internes, donc un `apply_*` d'ObsiGate passerait les deux portes (politique d'approbation + rôles) comme une simple lecture. Le plan exige que `propose_*`/`apply_*` ne soient pas utilisables silencieusement depuis un agent Flowdeck.\n\n**Plan (côté code)** : handshake systématique avant `tools/call` + propagation du `Mcp-Session-Id` ; `parse_body` SSE multi-messages (choisir le message de réponse, pas le premier `data:`) ; classification des outils MCP (annotations `readOnlyHint` du serveur, sinon heuristique de nom : `propose_*`, `create_*`… = écrivant ; `apply_*` **bloqué** au client, patron §7.5) branchée sur les deux portes ; preset de connecteur `obsigate` (comme `tiktak` en ACC-2.1, URL dérivée de la config dev/prod) pour que le branchement se fasse en un geste ; tests T0 simulés contre un faux serveur ObsiGate à session stricte.\n\n**Reste à ta charge pour la preuve réelle T0–T5** (inchangé, le plan le prévoit) : créer la clé API ObsiGate dédiée au pont, limitée à **un seul vault**, et trancher Q-A/Q-B (fusion #1) — je ne peux ni créer la clé à ta place ni décider du vault. Dès la clé posée dans un connecteur « ObsiGate » de Flowdeck, le probe et les outils `mcp_obsigate_*` seront fonctionnels. Livraison code en Révision avec CI verte.
bruno added kanban:review and removed kanban:in_progress labels 2026-10-26 13:25:46 -04:00
Author
Owner

Livraison code — Flowdeck v7.83.0 (commit 19b2769)

Fait — le côté client du pont MCP Flowdeck → ObsiGate (plan « étape 1 : lectures seules ») :

  • Sessions Streamable HTTP (app/services/mcp_client.py) : le client capture et réémet l'en-tête Mcp-Session-Id d'ObsiGate, fait le handshake complet (initialize → notifications/initialized) avant tools/call, et décode les réponses SSE multi-messages en retenant le message de réponse (id correspondant), pas le premier data:. C'était l'écart T0 : avant, call_tool postait directement, sans session — TikTak (sans état) passait, ObsiGate aurait refusé.
  • Preset connecteur « obsigate » : URL <base ObsiGate>/mcp dérivée de la configuration (dev/prod, comme TikTak), option dans le panneau agent (Panneau → Connecteurs), hint pointant vers la création de la clé dédiée.
  • Garde-fou n° 2 tenu : les outils MCP sont classés à la découverte (annotation readOnlyHint du serveur, sinon heuristique de nom ; lecture par défaut) et la classification est consommée par les deux portes — politique d'approbation (agent_policies.check_tool via is_write_tool dans agent_engine) et rôles (PermissionManager.assert_can). Avant, un mcp_* passait toujours pour une lecture.
  • apply_* bloqué côté client (tool_registry.McpTool) : une écriture croisée ne s'exécute jamais par un simple appel d'outil ; patron §7.5 = propose_* (classé écrivant : rôles + approbation) puis approbation dans l'app propriétaire.

Tests : nouveau tests/test_fusion_pont_obsigate.py — 7 tests verts contre un faux serveur ObsiGate à session stricte branché sur le vrai _rpc (transport httpx simulé) : T0 session + SSE, T1 appels de lecture avec session, classification, portes de gouvernance, blocage apply_*. Aucune régression : les échecs locaux résiduels sont identiques sur le HEAD 7.82.4 (artefacts DNS de cette VM).

CI Gitea : run 2345 (tag v7.83.0) entièrement vert — lint ✓, test ✓, docker ✓.

Release : v7.83.0 publiée → déploiement dev par l'automatisation (redéploiement Docker de Flowdeck requis pour le voir en dev).

Reste à ta charge pour la preuve réelle T0–T5 (inchangé depuis l'audit) :

  1. Créer dans ObsiGate la clé API dédiée au pont, limitée à un seul vault (ObsiGate → Configurations → Clés API & MCP), puis créer le connecteur « ObsiGate » dans Flowdeck avec cette clé et le sonder.
  2. Trancher Q-A/Q-B (fusion-trois-apps #1) — cloisonnement mémoire du pont.

Carte laissée en Révision (Terminé = Bruno).

## Livraison code — Flowdeck v7.83.0 (commit 19b2769) **Fait** — le côté client du pont MCP Flowdeck → ObsiGate (plan « étape 1 : lectures seules ») : - **Sessions Streamable HTTP** (`app/services/mcp_client.py`) : le client capture et réémet l'en-tête `Mcp-Session-Id` d'ObsiGate, fait le handshake complet (initialize → notifications/initialized) avant `tools/call`, et décode les réponses **SSE multi-messages** en retenant le message de réponse (id correspondant), pas le premier `data:`. C'était l'écart T0 : avant, `call_tool` postait directement, sans session — TikTak (sans état) passait, ObsiGate aurait refusé. - **Preset connecteur « obsigate »** : URL `<base ObsiGate>/mcp` dérivée de la configuration (dev/prod, comme TikTak), option dans le panneau agent (Panneau → Connecteurs), hint pointant vers la création de la clé dédiée. - **Garde-fou n° 2 tenu** : les outils MCP sont **classés à la découverte** (annotation `readOnlyHint` du serveur, sinon heuristique de nom ; lecture par défaut) et la classification est consommée par les deux portes — politique d'approbation (`agent_policies.check_tool` via `is_write_tool` dans `agent_engine`) et rôles (`PermissionManager.assert_can`). Avant, un `mcp_*` passait toujours pour une lecture. - **`apply_*` bloqué côté client** (`tool_registry.McpTool`) : une écriture croisée ne s'exécute jamais par un simple appel d'outil ; patron §7.5 = `propose_*` (classé écrivant : rôles + approbation) puis approbation dans l'app propriétaire. **Tests** : nouveau `tests/test_fusion_pont_obsigate.py` — 7 tests verts contre un faux serveur ObsiGate **à session stricte** branché sur le vrai `_rpc` (transport httpx simulé) : T0 session + SSE, T1 appels de lecture avec session, classification, portes de gouvernance, blocage `apply_*`. Aucune régression : les échecs locaux résiduels sont identiques sur le HEAD 7.82.4 (artefacts DNS de cette VM). **CI Gitea** : run **2345** (tag `v7.83.0`) **entièrement vert** — lint ✓, test ✓, docker ✓. **Release** : `v7.83.0` publiée → déploiement dev par l'automatisation (**redéploiement Docker de Flowdeck requis** pour le voir en dev). **Reste à ta charge pour la preuve réelle T0–T5** (inchangé depuis l'audit) : 1. Créer dans ObsiGate la **clé API dédiée au pont, limitée à un seul vault** (ObsiGate → Configurations → Clés API & MCP), puis créer le connecteur « ObsiGate » dans Flowdeck avec cette clé et le sonder. 2. Trancher **Q-A/Q-B** (fusion-trois-apps #1) — cloisonnement mémoire du pont. Carte laissée en **Révision** (Terminé = Bruno).
bruno removed the kanban:agent-task label 2026-10-26 15:35:57 -04:00
Author
Owner

🔧 Correctif d'étiquettes (2026-10-26) — la livraison v7.83.0 est bien complète (voir le commentaire de livraison ci-dessus), mais la carte restait affichée dans « 🤖 Tâches à traiter » sur le board Kanbante : elle portait deux étiquettes kanban reconnues (kanban:agent-task + kanban:review), et la règle de réconciliation de Kanbante est « exactement une étiquette reconnue, sinon l'état local gagne » — le board ne suivait donc pas l'étiquette Révision.

kanban:agent-task vient d'être retirée (la tâche agent est traitée et livrée) : il ne reste que kanban:review, le board adoptera la colonne Révision à sa prochaine synchro.

🔧 **Correctif d'étiquettes (2026-10-26)** — la livraison v7.83.0 est bien complète (voir le commentaire de livraison ci-dessus), mais la carte restait affichée dans « 🤖 Tâches à traiter » sur le board Kanbante : elle portait **deux** étiquettes kanban reconnues (`kanban:agent-task` + `kanban:review`), et la règle de réconciliation de Kanbante est « exactement une étiquette reconnue, sinon l'état local gagne » — le board ne suivait donc pas l'étiquette Révision. `kanban:agent-task` vient d'être retirée (la tâche agent est traitée et livrée) : il ne reste que `kanban:review`, le board adoptera la colonne **Révision** à sa prochaine synchro.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: bruno/flowdeck#20