feat(cli): Implementar comando envguard init para inicializacao de configuracao e templates #16

Activity

1. joaooncode

   added this to the v0.2.0 milestone on Aug 30, 2026
2. joaooncode

   added

   enhancementNew feature or requestNew feature or request

   on Aug 30, 2026
3. joaooncode commented on Sep 2, 2026

   

   joaooncode

   on Sep 2, 2026

   Last edited by joaooncode

   OwnerAuthor

   More actions

   Especificação Técnica: Subcomando envguard init e Geração de Templates

   1. Visão Geral

   Adição do subcomando init ao �nvguard para inicializar repositórios com o arquivo de configuração .envguard.yaml (comentado e com regras de segurança recomendadas) e, opcionalmente, gerar um template seguro .env.example sanitizado a partir de variáveis locais.

   2. Interface da CLI

   bash envguard init [flags]

   Flags suportadas:

   • -p, --path : Diretório destino para criação dos arquivos (default: ".").
   • -f, --force: Força sobrescrita de arquivos pré-existentes (.envguard.yaml, .env.example).
   • -t, --template: Gera o arquivo de template .env.example.
   • --template-from : Caminho para o arquivo .env fonte a ser sanitizado (opcional; se omitido, procura .env no diretório alvo; se não existir, gera boilerplate seguro).
   • -h, --help: Exibe instruções de ajuda do subcomando init.

   3. Camadas e Arquitetura

   1. Pacote internal/initializer:

      • SanitizeEnv(r io.Reader) string: Extrai chaves e comentários preservando a estrutura visual, esvaziando todos os valores para KEY=.
      • GenerateConfig(targetDir string, force bool) error: Escreve .envguard.yaml comentado com seções explicativas para �ersion, scanner.ignore_dirs, detector.custom_patterns, detector.allowlist e detector.severity_overrides.
      • GenerateTemplate(targetDir, sourceEnvPath string, force bool) error: Gera .env.example sanitizado ou padrão.
      • Proteção de colisões de arquivo com erro explícito na ausência de --force.

   2. Pacote internal/cli:

      • Adiciona init ao roteador de comandos em cli.go.
      • Implementa
        unInitCommand(args []string, stdout, stderr io.Writer) int.
      • Integração das mensagens de ajuda e códigos de saída determinísticos (ExitCodeSuccess, ExitCodeUsageError, ExitCodeGeneralError).

   4. Plano de Validação & TDD

   • Testes unitários do sanitizador e gerador de arquivos em internal/initializer/initializer_test.go.
   • Testes da camada CLI com flags, caminhos relativos/absolutos, flags combinadas e colisões em internal/cli/init_test.go e internal/cli/cli_test.go.
4. joaooncode

   added

   ready-for-agentFully specified, ready for an AFK agentFully specified, ready for an AFK agent

   on Sep 2, 2026
5. joaooncode

   self-assigned this

   on Sep 2, 2026
6. joaooncode

   closed this as completedin #25on Sep 2, 2026