From 404d39bcd3bde0216f49a4ba5bf7e4ffc1cdbf8e Mon Sep 17 00:00:00 2001 From: bolbol Date: Thu, 2 Jul 2026 21:34:54 +0000 Subject: [PATCH] protocol: verification API obligatoire avant ecriture nas-runbooks + decision gstack --- common/PROTOCOL-INFRA.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/common/PROTOCOL-INFRA.md b/common/PROTOCOL-INFRA.md index 42b9d49..d2f3367 100644 --- a/common/PROTOCOL-INFRA.md +++ b/common/PROTOCOL-INFRA.md @@ -69,3 +69,37 @@ Quand une lecon apprise doit etre appliquee automatiquement par l agent (pas jus 4. Documenter quand meme via le protocole standard (runbook common/, _INDEX.md, note NyoraNotes) — le skill rend la regle automatique, le runbook garde la tracabilite Exemples deployes le 02/07/2026 : desactivation des skills concurrents a nyora-doc-api (docx/pdf/pptx/xlsx), et skill generation-contenu-volumineux (chunking obligatoire pour eviter la troncature DeepSeek V4 Flash sur les taches lourdes). + +--- + +## Verification obligatoire avant toute lecture/ecriture sur nas-runbooks depuis mcp-nas + +Git est ABSENT du container mcp-nas (confirme le 02/07/2026). Toute ecriture sur +bolbol/nas-runbooks depuis une session mcp-nas passe par l API Gitea (curl + token, +PUT/POST /api/v1/repos/bolbol/nas-runbooks/contents/, avec le sha courant +recupere par un GET prealable) — jamais par un dossier local suppose a jour. + +Piege decouvert le 02/07/2026 : /mnt/docker/nas-runbooks etait un clone git reel +mais sur branche locale master, alors que le remote n a qu une branche main. 14 +commits locaux (15-23 juin, jamais pousses) contenaient du contenu reel absent du +remote. Cause probable : le binaire git a disparu de mcp-nas avant l etape push. +Fix applique : recuperation des 14 fichiers via l API vers main, _INDEX.md corrige, +clone local renomme en nas-runbooks.STALE-clone-local-jamais-pousse-20260702 +(conserve pour inspection, plus utilise comme source). + +Regle : avant de lire ou modifier un fichier sous /mnt/docker/nas-runbooks (ou tout +repo Gitea) depuis mcp-nas, verifier d abord via l API que le contenu local +correspond au remote reel : + GET /api/v1/repos/bolbol//branches + GET /api/v1/repos/bolbol//contents/ +Si un vrai clone git fonctionnel est necessaire (multi-fichiers, historique), +le faire depuis le Mac ou git est present, chemin partage /Volumes/docker == +/volume1/docker. + +## gstack (garrytan/gstack) — decision actee le 02/07/2026 + +Installation prevue sur le futur MacBook M5 Pro via Claude Code natif, PAS sur +hermes-perso (mem_limit container 600m incompatible Chromium/Playwright, routing +Sonnet/Opus incompatible regle DeepSeek exclusif Hermes, bug upstream #2015 +AskUserQuestion/clarify non resolu sur --host hermes). Detail complet : +common/GSTACK-EVALUATION-MACBOOK-VS-HERMES.md.