Versão 5.1.0

📚 Documentação do FASE

Versão: 5.1.0 ✅ | Última atualização: 2026-04-24 | Status: 414/414 testes passando (Issue #9: Error Handling Standardization Completo)

Bem-vindo ao centro de documentação do FASE! Aqui você encontra tudo que precisa para instalar, usar e contribuir ao projeto.

📖 Documentos Principais

Para Usuários

Documento	Descrição
Guia do Usuário	Guia completo de instalação e uso do FASE
Comandos	Lista com todos os 34 comandos disponíveis
NPM Registry	Configuração do npm registry e instalação
Verificação de Versão	Sistema automático de verificação de atualizações

Para Desenvolvedores

Documento	Descrição
Guia de Contribuição	Como contribuir para o FASE (bugs, features, traduções)
Guia de Testes	Estrutura de testes, cobertura de providers, TUI interaction
Git Hooks	Git hooks e verificações de segurança
Padronização de Caminhos	Mecanismo de padronização de caminhos

Começar Por Aqui

Sou um Usuário

Leia Guia do Usuário para instalação
Explore Comandos para ver o que está disponível

Quero Contribuir

Abra uma issue descrevendo sua ideia
Leia Guia de Contribuição
Siga o setup local
Abra um Pull Request

Encontrei um Bug

Procure em GitHub Issues por issue similar
Abra uma nova issue com os detalhes

Estrutura de Arquivos

docs/
├── README.md              # Este arquivo (índice)
├── guia-do-usuario.md     # Guia para usuários
├── COMANDOS.md            # Lista de comandos
├── CONTRIBUINDO.md        # Guia de contribuição
├── TESTING.md             # Guia de testes (novo!)
├── HOOKS.md               # Git hooks documentation
├── NPM-REGISTRY.md        # Configuração npm
├── technical/
│   └── padronizacao-caminhos.md   # Path standardization
└── maintainers/
    └── MANTENEDORES.md     # Informações para maintainers

🌐 Documentos em Português

Toda documentação do FASE é em português brasileiro:

Guias de usuário
Documentação de development
Comentários no código
Mensagens de erro e output

Exceções (em inglês):

Termos técnicos consagrados (framework, hook, commit)
Comandos e código
Nomes de pacotes npm

🆘 Precisa de Ajuda?

Problema técnico: Abra uma issue com tag [help]
Bug descoberto: Reporte com template bug_report.md
Sugestão: Use template feature_request.md

Melhorias Documentadas

v5.0.1 (Abril 2026)

Testes de Interação com TUI para Todos os 6 Providers

Novo framework de testes test/tmux/tui-interaction.test.cjs para validar comandos em cada provider
Testes automatizados usando tmux para simular interação do usuário
Cobertura completa: Claude, OpenCode, Gemini, Codex, GitHub Copilot, Qwen
11 novos testes mocha validando: launch, command input, instalação local, padrões
Qwen provider demonstra captura bem-sucedida de comandos FASE em TUI
Suite instalação expandida: agora 9/9 testes de install/uninstall com todos os providers
Documentação atualizada: Guia de Testes

Correções:

Fixed: Qwen config path em tmux-test-helper (era .claude, agora .qwen)
Fixed: Path resolution em test/tmux/run-all-tests.sh
Added: GitHub Copilot provider ao test matrix

Como executar:

npm run test:tmux              # 9 testes de instalação (97s)
npm run test:tmux:interaction  # 11 testes de TUI (60s)

v5.0.0 (Abril 2026)

Multi-Provider Architecture Completa

Suporte nativo para 6 code assistants: Claude, OpenCode, Gemini, Codex, GitHub Copilot, Qwen
Cada provider com sua própria estrutura de diretórios padronizada
34 comandos FASE disponíveis em todos os providers

v3.3.0 (Abril 2026)

Verificação Automática de Versão

Hook SessionStart verifica automaticamente por atualizações no npm
Notificação estilizada mostra versão atual vs disponível
Prompt interativo pergunta se deseja atualizar
Statusline mostra indicador ⬆ /fase:atualizar quando há atualização
Cache local em ~/.claude/cache/fase-update-check.json

v3.2.0 (Março 2026)

Path Standardization & Multi-Runtime Architecture

Todos os comandos e agentes agora usam padrão universal @./.fase-ai/
Installer converte automaticamente para caminhos específicos de cada runtime
129 testes unitários com cobertura completa
Documentação expandida sobre path standardization
Renomeação de arquivos: .pt.md → .md para consistência

Novos Documentos:

📚 Padronização de Caminhos - Explicação do mecanismo de padronização de caminhos
📚 Seções expandidas em bin/test/README.md e bin/test/TESTING.md

Ver também: CHANGELOG.md para histórico completo de versões

v2.4.0 (Março 2026)

Adicionado pre-commit hooks para validação de pacote npm
Criado GitHub Actions para publicação automática
Templates de issues para bug reports e features
CONTRIBUTING.md com instruções detalhadas
Este índice de documentação

📞 Contato

GitHub: isaaceliape/FASE
Issues: GitHub Issues
Email: Via issue (por favor, não compartilhar emails publicamente)

Versão: 5.1.0 Última atualização: 2026-03-13