Agent PO UI Protheus Generator

Uma extensão para o Visual Studio Code que automatiza a criação de novos projetos Angular com PO UI, pré-configurados para o ecossistema Protheus.

Funcionalidades Principais ✨

• Criação com um Comando: Gere um projeto completo e configurado a partir de um único comando na paleta do VS Code.
• Build e Empacotamento .App: Compile e empacote seu projeto Angular em um arquivo .app pronto para deploy no Protheus com um único comando.
• Scaffold IA Automático: Inicializa automaticamente o contexto de documentação e suporte para agentes IA utilizando o @ai-coders/context.
• Comando Scaffold Manual: Adicionado o comando PO UI: Scaffold para inicializar ou atualizar o contexto de IA em projetos existentes.
• Integração Protheus: Instala e configura automaticamente as dependências essenciais como @totvs/protheus-lib-core e @totvs/po-theme.
• Estrutura Organizada: Move os templates para arquivos externos, mantendo o código da extensão limpo e facilitando futuras atualizações.
• Inicialização Inteligente de Git: A extensão verifica se a pasta de destino já é um repositório Git. O comando git init só é executado se necessário, evitando reinicializações acidentais.
• Fluxo de Trabalho Amigável: Acompanhe todo o processo através de notificações de progresso e, ao final, abra o novo projeto em uma nova janela com apenas um clique.

Como Usar

Criar Novo Projeto

1. Abra a Paleta de Comandos (Ctrl+Shift+P ou Cmd+Shift+P no macOS).
2. Digite PO UI: Criar Novo Projeto Protheus e pressione Enter.
3. Informe o nome do seu novo projeto.
4. Selecione a pasta onde o projeto será criado.
5. A extensão cuidará de todo o resto!

Build e Empacotar Projeto (.app)

Após desenvolver seu projeto, você pode gerar o pacote .app para deploy no Protheus:

1. Abra seu projeto Angular no VS Code.
2. Abra a Paleta de Comandos (Ctrl+Shift+P ou Cmd+Shift+P no macOS).
3. Digite PO UI: Build .App e pressione Enter.
4. Aguarde o processo de build e empacotamento.
5. O arquivo .app será gerado na pasta dist/ do seu projeto.

Inicializar Contexto de IA (Scaffold)

Se você já tem um projeto e deseja inicializar as ferramentas de suporte a IA (agentes e regras):

1. Abra seu projeto no VS Code.
2. Abra a Paleta de Comandos (Ctrl+Shift+P).
3. Digite PO UI: Scaffold e pressione Enter.
4. A extensão executará o npx @ai-coders/context init . para configurar o ambiente de suporte a agentes IA.

O que o comando faz:

• ✅ Executa ng build para compilar o projeto
• ✅ Localiza automaticamente a pasta de distribuição
• ✅ Compacta os arquivos usando PowerShell
• ✅ Renomeia o arquivo para .app (formato esperado pelo Protheus)
• ✅ Compilação Automática (Novo): Se você tiver a extensão TOTVS Developer Studio instalada e conectada a um servidor, o build tentará compilar automaticamente o arquivo .app gerado no repositório (RPO).

Integração com IA 🤖

Esta extensão integra ferramentas de IA baseadas no TOTVS DTA para auxiliar no seu desenvolvimento, separadas em dois fluxos distintos:

1. Agente @poui (Especialista)

O agente @poui é um especialista em PO UI e Protheus. Ele utiliza uma base de conhecimento treinada e fluxos (DTA Flows) para responder perguntas técnicas, sugerir componentes e ajudar na implementação de regras de negócio no ecossistema TOTVS.

Configuração do Agente:

1. Abra a Paleta de Comandos (Ctrl+Shift+P).
2. Digite PO UI: Definir Chave do Flow TOTVS DTA (@poui).
3. Insira sua chave do Flow TOTVS DTA.

2. TOTVS DTA (LLM Proxy)

O TOTVS DTA funciona como um proxy para diversos modelos de linguagem (LLMs) como Gemini, GPT-5, Claude, entre outros. Ele é integrado diretamente ao seletor de modelos de linguagem do VS Code (Language Model API), permitindo seu uso em extensões que consomem IA de forma genérica.

Configuração do Modelo:

1. Abra a Paleta de Comandos (Ctrl+Shift+P).
2. Digite PO UI: Definir Chave de API Modelo.
3. Após inserir a chave, a extensão abrirá automaticamente a lista de modelos (PO UI: Selecionar Modelo AI).
4. Escolha o modelo desejado da lista (ex: TOTVS - gpt-5-mini, TOTVS - gemini-2.5-pro, etc).

3. Configuração de Agentes Locais

Ao criar um novo projeto, arquivos de configuração são gerados automaticamente para otimizar a experiência com IA no contexto do próprio projeto:

• agent-poui.md: Regras de sistema para o agente.
• .github/agents/poui-agent-vscode.md: Configuração para integração com GitHub Copilot.
• .agent/rules/poui-agent-antigravity.md: Regras específicas para agentes autônomos.

Estes arquivos garantem que a IA siga as diretrizes e melhores práticas de PO UI e acessibilidade da TOTVS.

O Que a Extensão Faz? ⚙️

O comando automatiza os seguintes passos para você:

1. Cria um novo projeto Angular com o Angular CLI.
2. Inicializa um repositório Git (se ainda não existir).
3. Adiciona os componentes do PO UI (@po-ui/ng-components).
4. Adiciona os templates do PO UI (@po-ui/ng-templates).
5. Instala a Protheus Lib Core (@totvs/protheus-lib-core).
6. Instala o tema do Protheus (@totvs/po-theme).
7. Gera arquivos de ambiente (environments) e módulos base.
8. Cria interceptores e arquivos essenciais para integração (appConfig.json).
9. Configura o angular.json com os estilos e assets necessários.
10. Instala as dependências (npm install) e configura os templates iniciais.
11. Inicializa o contexto de IA do projeto com o comando npx @ai-coders/context init . (baseado no projeto ai-coders-context).

Ao final, a extensão oferece para abrir o projeto recém-criado em uma nova janela do VS Code.

Pré-requisitos

Antes de usar a extensão, garanta que você tenha as seguintes ferramentas instaladas:

• Node.js (que inclui o npm)
• Angular CLI (npm install -g @angular/cli)
• TOTVS Developer Studio for VSCode (Opcional, mas Recomendado): Importante para funcionalidades avançadas como a compilação automática do .app gerado. Sem ela, o arquivo será apenas criado na pasta, mas não compilado para o Protheus.

Licença

Este projeto é distribuído sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.