PowerShell in Maguyva: codegrafen voor scripts en modules

Waar PowerShell oppervlakkige AI-tools laat struikelen

Je eigen functies en de ingebouwde cmdlets volgen dezelfde naamgeving. Get-Invoice en Get-ChildItem zien er hetzelfde uit, dus een tool die “ingebouwde” commando’s op werkwoord wegfiltert, gooit je eigen functies ook weg. Scripts mengen bovendien code op moduleniveau, functies, klassen en scriptblokken in één bestand, waardoor moeilijk te zien is bij welke functie een regel hoort.

Maguyva houdt beide soorten aanroepen vast en wijst elke aanroep toe aan de functie waarin hij staat.

Wat Maguyva in PowerShell extraheert

Maguyva dekt .ps1-, .psm1- en .psd1-bestanden. Functies en klassemethoden worden als callables geëxtraheerd, klassen en enums als types. Script- en methodeparameters worden gevolgd, en lees- en schrijfacties binnen een functie worden aan die functie toegewezen in plaats van aan de module.

Cmdlet-aanroepen blijven in de graaf. PowerShell past het standaardbibliotheekfilter dat de meeste talen gebruiken niet toe, dus Write-Host, Get-ChildItem en Restart-Service verschijnen als aanroepedges naast je eigen Get-*- en Set-*-functies. Een agent kan vragen welke scripts een service herstarten, of welke functies naar de console schrijven, en krijgt een structureel antwoord.

Voor PowerShell is geen relatietype als niet van toepassing gemarkeerd, dus de graaf legt ook klasse-overerving en interface-implementatie, instantiatie, control flow en lees- en schrijfacties vast.

Voorbeeldprompts voor agents

• “Wie roept Invoke-Backup aan, en vanuit welke geplande scripts?” (find_symbol, daarna dependency_search incoming)
• “Welke functies roepen Restart-Service aan?” (dependency_search)
• “Volg wat Deploy-Site van begin tot eind doet.” (get_task_context)

Bekende beperkingen

• Omdat cmdlet-aanroepen behouden blijven, hebben zeer gangbare zoals Write-Host en Select-Object enorm veel inkomende edges. Begin bij je eigen functie als je een gerichte aanroepgraaf wilt.
• Import-Module en dot-sourcing zijn gewone commando’s, dus de preset imports in structural_search selecteert niets. Gebruik text_pattern_search om ze op te sommen.

Volgende stappen

Koppel een repository via de snelstart en bekijk daarna de ondersteuningsmatrix op de compatibiliteitspagina. Lees voor .NET-code die je scripts aanroepen de C#-gids.