[ACC-5.1] Serveur MCP Flowdeck en lecture #24

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

Brief pour Hermes. Serveur MCP Flowdeck en lecture (catalogue du §7.2 de l'architecture v2.0). Hors outils réunions tant que la décision Meetings A/B n'est pas tranchée par Bruno.

Épopée : Projets/fusion-trois-apps#9. Débloque ACC-4.3 (2e direction) et ACC-5.2 côté ObsiGate.

**Brief pour Hermes.** Serveur MCP Flowdeck **en lecture** (catalogue du §7.2 de l'architecture v2.0). **Hors outils réunions** tant que la décision Meetings A/B n'est pas tranchée par Bruno. Épopée : Projets/fusion-trois-apps#9. Débloque ACC-4.3 (2e direction) et ACC-5.2 côté ObsiGate.
bruno added this to the Fusion — accès centralisé milestone 2026-10-20 21:19:48 -04:00
bruno added the kanban_Backlog label 2026-10-20 21:19:48 -04:00
bruno added the kanban:agent-task label 2026-10-26 11:28:46 -04:00
bruno added kanban:in_progress and removed kanban_Backlog labels 2026-10-26 11:40:42 -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) : le serveur MCP existe déjà (7.75.0+, périmètre du jeton en 7.78.0, outils d'écriture ajoutés ensuite) mais il ne couvre pas le catalogue §7.2 de l'architecture v2.0 et ne respecte pas encore deux exigences du §7.4 :\n\n- manquent list_projects / get_project (le « projet » du contrat de liens profonds = une collection, /collections/<id>), read_page (contenu tronqué proprement + URL profonde) et list_project_tasks (collections is_task) ;\n- search_pages ne cherche que dans les titres des lignes de collections — pas de plein texte, pas de pages classiques, pas d'URL profonde (pourtant « systématique » au §7.2) ;\n- aucune journalisation des appels d'outils (le §7.4 l'exige : app cliente, outil, horodatage) ;\n- les portées du jeton (scopes de api_tokens) ne sont pas appliquées : un jeton read peut aujourd'hui écrire via MCP.\n\nPlan : ajouter les 4 outils de lecture du catalogue avec URL profondes partout, étendre la recherche (plein texte, pages + lignes), journaliser chaque tools/call dans api_audit_log, appliquer la portée du jeton (écritures refusées sans write), tests dédiés. Hors périmètre : list_meetings/get_meeting (décision Meetings A/B toujours ouverte). Livraison 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)** : le serveur MCP existe déjà (7.75.0+, périmètre du jeton en 7.78.0, outils d'écriture ajoutés ensuite) mais il **ne couvre pas le catalogue §7.2** de l'architecture v2.0 et ne respecte pas encore deux exigences du §7.4 :\n\n- manquent `list_projects` / `get_project` (le « projet » du contrat de liens profonds = une collection, `/collections/<id>`), `read_page` (contenu tronqué proprement + URL profonde) et `list_project_tasks` (collections `is_task`) ;\n- `search_pages` ne cherche que dans les titres des lignes de collections — pas de plein texte, pas de pages classiques, pas d'URL profonde (pourtant « systématique » au §7.2) ;\n- **aucune journalisation** des appels d'outils (le §7.4 l'exige : app cliente, outil, horodatage) ;\n- les **portées du jeton** (`scopes` de `api_tokens`) ne sont pas appliquées : un jeton `read` peut aujourd'hui écrire via MCP.\n\n**Plan** : ajouter les 4 outils de lecture du catalogue avec URL profondes partout, étendre la recherche (plein texte, pages + lignes), journaliser chaque `tools/call` dans `api_audit_log`, appliquer la portée du jeton (écritures refusées sans `write`), tests dédiés. Hors périmètre : `list_meetings`/`get_meeting` (décision Meetings A/B toujours ouverte). Livraison en Révision avec CI verte.
bruno added kanban:review and removed kanban:in_progress labels 2026-10-26 13:25:42 -04:00
Author
Owner

Livraison — Flowdeck v7.83.0 (commit 19b2769)

Fait — le serveur MCP de Flowdeck couvre le catalogue §7.2 et les exigences §7.4 de la spec d'accès centralisé :

  • Nouveaux outils de lecture : list_projects, get_project (métadonnées + schéma + titres seuls), read_page (page classique ou ligne de collection, contenu tronqué proprement à 20 000 car. avec drapeau truncated), list_project_tasks.
  • search_pages devient une recherche plein texte (titre + contenu des pages ; titre + propriétés des lignes de collection), périmètre du workspace du jeton, plafond 50. Chaque résultat porte kind et son lien profond url (contrat figé : projet = collection).
  • Scopes appliqués (§7.4) : un jeton sans scope write se voit refuser les outils d'écriture (erreur JSON-RPC -32002 « Jeton en lecture seule »).
  • Journalisation (§7.4) : chaque tools/call est écrit dans api_audit_log (action mcp:<outil>, nom du jeton, statut ok/erreur/refusé — clés d'arguments seulement, jamais les valeurs).
  • list_meetings/get_meeting restent exclus tant que la décision Meetings A/B n'est pas tranchée.

Tests : tests/test_fusion_mcp_server.py — 18 tests verts (catalogue, troncature, jeton lecture seule, journalisation).

CI Gitea : run 2345 (tag v7.83.0) entièrement vert — lint ✓, test ✓, docker ✓. (Les premiers échecs lint/test des runs de cet après-midi venaient du runner : erreurs du démon Docker de l'hôte — mkdirat var/run, pools d'adresses épuisés — corrigées par relances une fois les réseaux libérés.)

Release : v7.83.0 publiée → déploiement dev déclenché par l'automatisation. Redéploiement Docker de Flowdeck requis pour voir le résultat en dev si l'automatisation ne l'a pas déjà fait.

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

## Livraison — Flowdeck v7.83.0 (commit 19b2769) **Fait** — le serveur MCP de Flowdeck couvre le catalogue §7.2 et les exigences §7.4 de la spec d'accès centralisé : - Nouveaux outils de lecture : `list_projects`, `get_project` (métadonnées + schéma + titres seuls), `read_page` (page classique ou ligne de collection, contenu tronqué proprement à 20 000 car. avec drapeau `truncated`), `list_project_tasks`. - `search_pages` devient une recherche **plein texte** (titre + contenu des pages ; titre + propriétés des lignes de collection), périmètre du workspace du jeton, plafond 50. Chaque résultat porte `kind` et son **lien profond** `url` (contrat figé : projet = collection). - **Scopes appliqués (§7.4)** : un jeton sans scope `write` se voit refuser les outils d'écriture (erreur JSON-RPC -32002 « Jeton en lecture seule »). - **Journalisation (§7.4)** : chaque `tools/call` est écrit dans `api_audit_log` (action `mcp:<outil>`, nom du jeton, statut ok/erreur/refusé — clés d'arguments seulement, jamais les valeurs). - `list_meetings`/`get_meeting` restent **exclus** tant que la décision Meetings A/B n'est pas tranchée. **Tests** : `tests/test_fusion_mcp_server.py` — 18 tests verts (catalogue, troncature, jeton lecture seule, journalisation). **CI Gitea** : run **2345** (tag `v7.83.0`) **entièrement vert** — lint ✓, test ✓, docker ✓. (Les premiers échecs lint/test des runs de cet après-midi venaient du runner : erreurs du démon Docker de l'hôte — `mkdirat var/run`, pools d'adresses épuisés — corrigées par relances une fois les réseaux libérés.) **Release** : `v7.83.0` publiée → déploiement dev déclenché par l'automatisation. **Redéploiement Docker de Flowdeck requis** pour voir le résultat en dev si l'automatisation ne l'a pas déjà fait. Carte laissée en **Révision** (Terminé = Bruno).
bruno removed the kanban:agent-task label 2026-10-26 15:36:00 -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#24