PowerShell dans Maguyva : des graphes de code pour scripts et modules

Là où PowerShell fait trébucher les outils d’IA superficiels

Vos fonctions et les cmdlets intégrées suivent le même style de nommage. Get-Invoice et Get-ChildItem se ressemblent : un outil qui écarte les commandes « intégrées » d’après leur verbe jette aussi vos propres fonctions. Les scripts mélangent en outre du code de niveau module, des fonctions, des classes et des blocs de script dans un même fichier, ce qui rend difficile de savoir à quelle fonction appartient une ligne.

Maguyva conserve les deux types d’appels et rattache chacun à la fonction qui le contient.

Ce que Maguyva extrait en PowerShell

Maguyva couvre les fichiers .ps1, .psm1 et .psd1. Les fonctions et les méthodes de classe sont extraites comme appelables, les classes et les enums comme types. Les paramètres de script et de méthode sont suivis, et les lectures et écritures dans une fonction sont rattachées à cette fonction plutôt qu’au module.

Les appels de cmdlets restent dans le graphe. PowerShell n’applique pas le filtre de bibliothèque standard utilisé par la plupart des langages : Write-Host, Get-ChildItem et Restart-Service apparaissent donc comme des arêtes d’appel à côté de vos propres fonctions Get-* et Set-*. Un agent peut demander quels scripts redémarrent un service, ou quelles fonctions écrivent dans la console, et obtenir une réponse structurelle.

Aucun type de relation n’est marqué comme non applicable pour PowerShell : le graphe enregistre donc aussi l’héritage de classes et l’implémentation d’interfaces, l’instanciation, le flux de contrôle et les lectures et écritures.

Exemples de prompts pour agents

• « Qui appelle Invoke-Backup, et depuis quels scripts planifiés ? » (find_symbol, puis dependency_search en incoming)
• « Quelles fonctions appellent Restart-Service ? » (dependency_search)
• « Retrace ce que fait Deploy-Site du début à la fin. » (get_task_context)

Limites connues

• Comme les appels de cmdlets sont conservés, les plus courants comme Write-Host et Select-Object ont un très grand nombre d’arêtes entrantes. Partez de votre propre fonction si vous voulez un graphe d’appels ciblé.
• Import-Module et le dot-sourcing sont des commandes ordinaires : le preset imports de structural_search ne sélectionne donc rien. Utilisez text_pattern_search pour les lister.

Étapes suivantes

Connectez un dépôt avec le démarrage rapide, puis consultez la matrice de prise en charge sur la page de compatibilité. Pour le code .NET appelé par vos scripts, lisez le guide C#.