Release v2.0.0

[YagoBorba]

📋 Description

This PR consolidates all changes from the develop branch to main, preparing for the v2.0.0 release of StackCode CLI. This release represents a significant milestone with the full implementation of Educational Mode (#35) and several important architectural improvements.

🔗 Related Issues

• Closes Implement an Optional Educational Mode #35 - Implement an Optional Educational Mode
• Closes Generate ARCHITECTURE.md to Document Suggested Structure #32 - Complete documentation translations
• Closes Refactor all hardcoded strings to use i18n keys #47 - GitHub integration translations
• Closes Implementar Autenticação com a API do GitHub via OAuth #44, Add logic to fetch repository issues via GitHub API #45, Create and integrate 'Pending Issues' component into the Dashboard #46 - GitHub OAuth and issues integration

🧪 Type of Change

• ✨ New Feature - Educational Mode implementation
• 💥 Breaking Change - ES Modules migration
• 🌐 Internationalization - Complete Spanish translations
• 📝 Documentation - Comprehensive multilingual docs
• 🔧 Architecture - Major toolchain modernization

🎓 Educational Mode - Complete Implementation

Core Features:

• Global Configuration: stackcode config set educate true/false
• Per-Command Override: --educate flag available on ALL commands
• Contextual Learning: Explains DevOps best practices in real-time
• Smart Behavior: Respects global config with flag override capability
• Fallback System: Robust error handling for missing translations

Educational Integration:

• ✅ init command - Project structure and tooling explanations
• ✅ commit command - Conventional commits and Git best practices
• ✅ validate command - Code quality and validation importance
• ✅ config command - Configuration management principles
• ✅ generate command - Template systems and file organization
• ✅ git commands - Git workflow and branching strategies

Files Added/Modified for Educational Mode:

packages/cli/src/educational-mode.ts        # Core educational system
packages/cli/test/commands/educational-mode.test.ts  # 13 comprehensive tests
packages/cli/src/commands/*.ts             # All commands enhanced
.stackcoderc.json                          # Configuration example

🌍 Complete Internationalization System

Spanish Translations (es.json):

• 433+ lines of comprehensive translations
• Complete educational content in Spanish
• All CLI commands and UI elements translated
• Error messages and help text localized

Enhanced Translations:

• Portuguese (pt.json): Updated with educational mode content
• English (en.json): Enhanced with educational explanations
• Yargs Integration: Help screens fully localized

Documentation Translations:

docs/es/                     # Complete Spanish documentation
docs/pt-BR/                  # Enhanced Portuguese documentation  
docs/EDUCATIONAL_MODE.md     # Educational mode guide (all languages)

🏗️ Major Architecture & Infrastructure Updates

💥 Breaking Changes:

• ES Modules Migration: Complete toolchain modernization
• Node.js Requirements: Updated minimum version support
• Dependency Updates: Major version bumps across ecosystem

🚀 Technology Stack Enhancements:

• 8 Technology Stacks: Complete implementation for project scaffolding
• GitHub Integration: OAuth authentication and issues management
• VS Code Extension: React webview UI with Tailwind CSS
• Monorepo Structure: Optimized build system and workspace management

🧪 Testing & Quality:

• Comprehensive Test Suite: 13 tests for Educational Mode
• CI/CD Pipeline: Enhanced with linting and format checking
• Code Quality: ESLint and Prettier integration
• Type Safety: Full TypeScript coverage

📦 Changes by Package

@stackcode/cli@2.0.0:

• Educational Mode integration
• Spanish language support
• Enhanced command system
• Improved error handling

@stackcode/i18n@2.0.0:

• Complete Spanish translations
• Educational content system
• Fallback mechanisms
• Type-safe translation keys

@stackcode/core@2.0.0:

• ES Modules architecture
• Enhanced template system
• GitHub integration logic
• Dependency validation

@stackcode/vscode-extension@2.0.0:

• React-based webview UI
• GitHub OAuth integration
• Proactive notifications
• CLI integration

📝 How Has This Been Tested?

• Educational Mode: 13 comprehensive unit tests
• Multi-language: Tested in Spanish, Portuguese, and English
• Configuration: Global and per-command config validation
• Integration: All CLI commands tested with educational mode
• CI/CD Pipeline: All checks passing
• Manual Testing: Extensive user workflow validation

🔄 Post-Merge Actions Required

1. NPM Publication:

cd packages/cli && npm publish     # @stackcode/cli@2.0.0
cd packages/core && npm publish    # @stackcode/core@2.0.0  
cd packages/i18n && npm publish    # @stackcode/i18n@2.0.0

2. Release Management:

git tag v2.0.0
git push origin v2.0.0

3. Documentation Updates:

• Update NPM package documentation
• Announce Educational Mode feature
• Create demo videos/tutorials

📊 Impact Summary

• 🎓 Learning Experience: Transforms StackCode into educational platform
• 🌍 Global Reach: Full Spanish language support
• 🏗️ Modern Architecture: ES Modules and updated toolchain
• 🔧 Enhanced Functionality: 8 technology stacks + GitHub integration
• 📈 Developer Experience: Contextual learning and best practices

✅ Semantic Versioning Justification

1.0.3 → 2.0.0 due to:

• BREAKING CHANGE: ES Modules migration requires Node.js and tooling updates
• Major Feature: Educational Mode represents significant functionality expansion
• Architecture Update: Fundamental changes to module system

📚 Additional Notes

This release represents 6 months of development with:

• 80+ commits since last major release
• Multiple issues resolved (Generate ARCHITECTURE.md to Document Suggested Structure #32, Implement an Optional Educational Mode #35, Implementar Autenticação com a API do GitHub via OAuth #44-47)
• Complete feature parity across all supported languages
• Production-ready educational system

Issue References: Closes #35, #32, #47, #44, #45, #46