PowerShell no Maguyva: grafos de código para scripts e módulos

Onde PowerShell derruba ferramentas de IA superficiais

Suas funções e os cmdlets embutidos seguem o mesmo estilo de nomes. Get-Invoice e Get-ChildItem parecem iguais, então uma ferramenta que descarta comandos “embutidos” pelo verbo joga fora as suas funções também. Os scripts ainda misturam código no nível do módulo, funções, classes e blocos de script em um só arquivo, o que dificulta saber a qual função uma linha pertence.

O Maguyva mantém os dois tipos de chamada e atribui cada uma à função em que ela está.

O que o Maguyva extrai em PowerShell

O Maguyva cobre arquivos .ps1, .psm1 e .psd1. Funções e métodos de classe são extraídos como invocáveis, e classes e enums como tipos. Parâmetros de script e de método são rastreados, e leituras e escritas dentro de uma função são atribuídas a essa função, não ao módulo.

As chamadas de cmdlets ficam no grafo. O PowerShell não aplica o filtro de biblioteca padrão que a maioria das linguagens usa, então Write-Host, Get-ChildItem e Restart-Service aparecem como arestas de chamada ao lado das suas funções Get-* e Set-*. Um agente pode perguntar quais scripts reiniciam um serviço, ou quais funções escrevem no console, e receber uma resposta estrutural.

Nenhum tipo de relação está marcado como não aplicável para PowerShell, então o grafo também registra herança de classes e implementação de interfaces, instanciação, fluxo de controle e leituras e escritas.

Exemplos de prompts para agentes

• “Quem chama Invoke-Backup, e de quais scripts agendados?” (find_symbol, depois dependency_search incoming)
• “Quais funções chamam Restart-Service?” (dependency_search)
• “Rastreie o que Deploy-Site faz do começo ao fim.” (get_task_context)

Limitações conhecidas

• Como as chamadas de cmdlets são mantidas, as muito comuns, como Write-Host e Select-Object, têm um número enorme de arestas de entrada. Comece pela sua própria função quando quiser um grafo de chamadas focado.
• Import-Module e o dot-sourcing são comandos comuns, então o preset imports do structural_search não seleciona nada. Use text_pattern_search para listá-los.

Próximos passos

Conecte um repositório pelo início rápido e depois confira a matriz de suporte na página de compatibilidade. Para o código .NET que seus scripts chamam, leia o guia de C#.