bolbol
/
nas-runbooks
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

protocol: verification API obligatoire avant ecriture nas-runbooks + decision gstack

This commit is contained in:
bolbol 2026-07-02 21:34:54 +00:00
parent ff0fab0a45
commit 404d39bcd3
1 changed files with 34 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
common/PROTOCOL-INFRA.md
View File

@ -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/<chemin>, 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/<repo>/branches
GET /api/v1/repos/bolbol/<repo>/contents/<chemin>
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.