Nestor Orchestra para VS Code

Extensão local para explorar agentes e skills, criar agentes com a Forja, mapear projetos, executar agentes e importar ou exportar pacotes ZIP.

Requer Node.js, npm e Python 3.10+ instalado localmente. Configure agentOrchestra.pythonPath caso Python não esteja no PATH.

npm ci
npm test
npm run check
npm run vscode:prepublish

Abra esta pasta no VS Code e pressione F5 para testar. vscode:prepublish inclui o núcleo Python de ../nestor_forge/ no pacote. Para gerar o VSIX com o publicador 011BrasilCentrodeTeconologia e o site, execute python scripts/build_distros.py na raiz do repositório. A saída padrão fica em /mnt/z/projetos/Forja/DISTROS; FORJA_DISTROS_DIR permite escolher outro destino. O ícone i na barra lateral abre a tela Sobre, com Nestor, versão e copyright da 011Brasil.

Documentação Graphy

Na área Documentação do painel lateral, o fluxo aparece em um terminal integrado, sem cartões por etapa nem painel separado. A extensão pede permissão antes de cada comando. O primeiro passo após instalar a CLI é init --from-discovery, que prepara graphy.toml, as instruções do Codex e os comandos do Claude. Depois vêm levantamento, validação da configuração, geração e documentação. Nas etapas com IA, a sessão espera a revisão do resultado antes de prosseguir. Se a configuração falhar, é possível executar o refinamento com IA e validar novamente.

Concluir o fluxo não encerra a manutenção: Verificar novas mudanças reabre a verificação incremental (status-context) e permite atualizar somente os módulos afetados (update-context), sem repetir geração e documentação completas. Depois da atualização e validação, a pipeline segue para a simulação da vault e pede aprovação antes de sincronizar. O atalho Terminal livre abre um terminal integrado independente para usar ferramentas e comandos sem interromper a sessão Graphy. O botão Explorador abre o relatório interativo em um painel do VS Code, inclusive em ambientes remotos como WSL.

A publicação é opcional. Informe a raiz da vault na mesma área, em caminho Windows, WSL ou Linux conforme o ambiente. A extensão converte o caminho Windows no WSL, verifica a montagem e a pasta .obsidian, e mostra instruções de montagem quando necessário. Ela executa uma simulação antes de pedir uma segunda permissão para a publicação real. A CLI e a extensão não executam os comandos de montagem automaticamente.

A versão publicada da CLI é consultada nas tags do repositório Git configurado. O número mostrado como instalado vem do executável local; o botão ↻ consulta a publicação novamente.

O terminal usa node-pty no host da extensão e xterm na webview. Ao empacotar um VSIX para outra plataforma, inclua ou reconstrua o binário nativo de node-pty para esse host.

Para atualizar pelo GitLab Pages, publique o manifesto updates/agentorchestra.json e o VSIX na mesma origem HTTPS. Configure agentOrchestra.updateManifestUrl com a URL completa e agentOrchestra.updateMode como notify ou auto. O padrão é off; sem endpoint acessível sem login, instale o VSIX manualmente.