4nk/ia_dev
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
ia_dev/.cursor/agents/setup-host.md
Nicolas Cantu fea263b87a docs(cursor): lint if not run during agent; min 5 fixes out of scope 
**Motivations:**
- Align ia_dev agents with lecoffre_ng_test: if no lint was executed during the run, run it on project build_dirs and fix at least five issues (errors + warnings), including outside task scope.

**Root causes:**
- N/A

**Correctifs:**
- N/A

**Evolutions:**
- cloture-lint.mdc: minimum-corrections block expanded; new section when no lint was run (repository_root / build_dirs via conf.json)
- All .cursor/agents/*.md: Rationalisation Lint bullet

**Pages affectées:**
- .cursor/rules/cloture-lint.mdc
- .cursor/agents/*.md
2026-03-24 22:56:05 +01:00

2.4 KiB
Raw Blame History

name description model is_background
setup-host Préparation OS/paquets sur la cible via le script normalisé deploy/scripts_v2/run-setup-host.sh (hors deploy.sh), depuis le repository_root du projet (conf.json). inherit false

Rationalisation tokens

  • Contexte minimal : résoudre projects/<id>/conf.json → deploy.repository_root, puis exécuter le script normalisé sous cette racine.

  • Pas de fallback : si repository_root ou le script manque, erreur explicite.

  • Lint : si aucun lint (npm run lint ou équivalent sur les build_dirs du dépôt projet : projects/<id>/conf.json → repository_root) n’a été exécuté durant ce run, le lancer puis tenter de corriger au moins 5 diagnostics (erreurs et warnings cumulés), même hors périmètre de la tâche — voir .cursor/rules/cloture-lint.mdc (section Si aucun lint n’a été exécuté pendant l’agent).

Agent setup-host (générique ia_dev)

Règle d’exécution intégrale

  1. Horodatage et contexte : début/fin — date/heure ISO, branche git du dépôt ia_dev, pwd, project id (IA_PROJECT_ID, premier argument, ou résolution MAIL_TO / AI_AGENT_TOKEN selon projects/README.md).
  2. Résolution : lire projects/<id>/conf.json avec jq si disponible ; exiger deploy.repository_root (répertoire existant).
  3. Contrat script : sous repository_root, le point d’entrée normalisé est :
    • deploy/scripts_v2/run-setup-host.sh
  4. Invocation : depuis la racine du dépôt projet (cd "$(jq -r '.deploy.repository_root' conf.json)" ou équivalent) :
    • bash deploy/scripts_v2/run-setup-host.sh <test|pprod|prod>
    • L’environnement doit être passé explicitement (pas de valeur par défaut métier).
  5. Secrets : le script charge .secrets/<env>/.env.<env> via SECRETS_BASE / repo-and-secrets.sh comme deploy.sh ; s’assurer que le répertoire secrets attendu existe côté poste qui lance la commande.
  6. Sortie : ne pas masquer stdout/stderr ; en échec, relire les messages sudo / SSH.
  7. Clôture : appliquer .cursor/rules/cloture-evolution.mdc en fin d’exécution agent (horodatage, questions 3–11 selon périmètre touché).

Projets sans script normalisé

Si run-setup-host.sh est absent : documenter l’écart et ajouter le script (ou wrapper) dans le dépôt projet avant de prétendre l’agent terminé.