AGENTS.md — Projet n8n / Home Assistant / EVCS Solaire

🎯 Environnement

Serveur n8n : https://n8n.airtria.pro (API v1)
Accès n8n via le MCP n8n-mcp (lecture/écriture de workflows).
Pilotage énergie via MCP dédiés. Modèle local : Qwen3.6-35B (contexte limité).

🔧 OUTILS — RÈGLES STRICTES

Noms d'outils MCP (TIRETS, jamais underscores)

ha-get-state · lire un état Home Assistant
ha-set-helper · écrire un helper HA
grid-set-state · piloter le grid
victron-set-charge-limits · limites de charge Victron
pv-get-forecast · prévision solaire
n8n-mcp · workflows n8n ⚠️ Recopie ces noms EXACTEMENT. N'invente jamais un nom d'outil.

Interdictions

JAMAIS de curl / wget / appel HTTP direct vers HA, n8n, Victron. Tout passe par les MCP (le shell bloque curl de toute façon).
JAMAIS d'IP, d'URL ni de token inventés. Info manquante → utilise le MCP ou demande-moi. Ne devine pas.
ripgrep/rg N'EST PAS installé. Utilise grep.

📂 LIRE UN WORKFLOW n8n (méthode obligatoire)

Le MCP n8n-mcp_get_workflow renvoie le workflow ENTIER (~357K, trop gros pour le contexte). opencode l'écrit alors dans un fichier ~/.local/share/opencode/tool-output/tool_* et te le tronque.

⚠️ Ce fichier commence par une ligne de texte Retrieved workflow: <nom> AVANT le JSON. Donc :

N'utilise JAMAIS json.load(f) ni json.loads(text) directement → ÉCHEC garanti (JSONDecodeError, le fichier ne commence pas par {).

MÉTHODE VALIDÉE pour extraire UN nœud (ex: DECISION_ENGINEV2) :

Localise-le : grep -n '"name": "NOM_DU_NOEUD"' <fichier_tool-output>
Extrais sa section : sed -n 'DEBUT,FINp' <fichier_tool-output> (repère les bornes d'accolades autour du nœud avec le grep). Si tu tiens à Python, retire d'abord le préfixe texte : text = open(f).read(); json_text = text[text.index('{'):]

🧭 MÉTHODE DE TRAVAIL

UN nœud / UNE tâche à la fois. Ne charge JAMAIS le workflow complet.
Avant toute écriture (patch/PUT/set) : backup ou dry-run, puis attends ma validation. Applique une seule action, vérifie, puis continue.
Si un outil ou un parse échoue 2 fois : ARRÊTE et demande-moi comment procéder. Ne pars jamais en boucle de réessais.
Toutes les valeurs d'énergie (SOC, PV, charge, grid, courant EVCS) se lisent via ha-get-state, jamais en dur.

⚡ CONTEXTE MÉTIER — Workflow "HA Snapshot EVCS Surplus Controller V2.6"

ID: ATswvGfG4KJUls0K (les V1/V1.2/V2.0 sont INACTIFS, ne pas y toucher). Nœud central de décision : DECISION_ENGINEV2 (id 1a8271fd-...). Stratégies (entrées via strategy.userStrategy) → context.sourceMode :

auto_solar → sourceMode solar_only / solar_potential
force_grid_now → strategy.forceGridRequested=true → grid_forced / grid_hc_allowed Garde-fous connus : effectiveSocStartFloor, commonSafetyStartOk, gridAllowedBySoc (SOC<=35 OU forceGridRequested → bypass), batteryAssistSolarStartOk (SOC>=90).

Quand tu analyses le pipeline complet (plusieurs nœuds), n'extrais que les lignes pertinentes (grep -n "name"/"jsCode" puis sed sur la plage), jamais le workflow JSON entier en mémoire Python. Traite un nœud, résume, libère.

3.2 KiB Raw Blame History