5.3 - Release v4.0.0

[isaaceliape]

Descrição

Preparar e publicar release v4.0.0 com todas as melhorias de qualidade.

Tarefas

• Bump version para 4.0.0 em package.json
• Atualizar CHANGELOG.md com breaking changes
• Criar git tag v4.0.0
• Publicar no npm: npm publish
• Criar release notes no GitHub
• Anunciar em canais apropriados

Breaking Changes

• Error handling: agora lança erros em vez de process.exit()
• Nova estrutura de módulos em src/install/
• Logging com pino em vez de console.*
• Input validation mais restritiva

Critérios de Aceite

• Version 4.0.0 no package.json
• CHANGELOG.md atualizado
• Git tag v4.0.0
• Publicado no npm
• Release notes no GitHub

Riscos

• Usuários podem não ler migration guide
• Issues podem surgir pós-release

Estimativa

0.5 dias

Sprint

Sprint 5: Polimento & Release

---

Plano: #155 (Fase 01: Qualidade e Refatoração do Código)
Priority: Critical
Sprint: 5

[isaaceliape]

Breaking Changes — Updated List

Based on completed work in Sprint 1:

Error Handling (Issue #9 ✅)

• Error handling: agora lança erros em vez de process.exit()
• New error classes: FaseError, ConfigError, FileError, ValidationError, PathTraversalError, etc.
• Hooks that relied on process.exit(1) behavior may need updates

Modular Structure (Issue #10 ✅)

• NEW: Modular install structure in src/install/
• NEW: 8 new modules: providers, settings, attribution, analytics, hooks, frontmatter-convert, uninstall
• Internal API changes for install logic
• install.ts reduced from 2,751 lines to modular structure

Logging (Issue #11 🔄)

• Logging com pino em vez de console.*
• Log files em .fase-ai/logs/
• Configuração via .fase-ai/config.json

Input Validation (Issue #13 ⬜)

• Input validation mais restritiva
• Path depth limits
• Schema validation com zod

---

Note: Breaking changes marked with ✅ are already implemented and tested.

[isaaceliape]

✅ RELEASED v4.0.0

Released: April 18, 2026

Deliverables:

• Version bumped to 4.0.0
• CHANGELOG.md updated
• Git tag v4.0.0 created
• Pushed to GitHub
• Ready for npm publish

Breaking Changes Documented:

• Error handling (throw vs exit)
• Modular structure
• Logging system

Next: Publish to npm when ready