Outils

Les outils Catnip partagent la même grammaire et les mêmes règles d'exécution que le runtime.

Référence

• Serveur MCP — parsing, évaluation, formatage et sessions de debug pour les agents.
• Linter — syntaxe (E1xx), noms (E2xx/W2xx), contrôle de flux (W3xx), types (E3xx) et métriques (I2xx).
• Formatteur — pretty-printer Wadler-Leijen construit depuis le CST tree-sitter.
• Debugger — breakpoints, pas à pas, inspection des variables et intégration MCP.
• Extract Grammar — export de la grammaire et régénération des outils dérivés.
• Lexer Pygments — coloration syntaxique générée depuis la grammaire.

Commandes courantes

# Vérifier puis formater un projet
catnip lint --deep --strict src/
catnip format --check src/
catnip format -i src/

# Déboguer un script
catnip debug -b 5 script.cat

# Régénérer les artefacts après une modification de grammaire
make grammar-deps

make grammar-deps est la commande canonique du dépôt : elle régénère le parser et synchronise Pygments, VSCode et CodeMirror.

La grammaire génère les outils qui vérifient les textes écrits avec cette grammaire. Le circuit est fermé ; les bugs, eux, restent libres de circuler.