# Changelog

All notable changes to Bangstack will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [0.3.1] - 2025-10-15

### Added
- **Auth0 Authentication Generator**: Complete Auth0 integration with OAuth redirect flow, JWT validation, and role-based authorization
- **Supabase Authentication Generator**: Full Supabase auth support with email/password, OAuth providers, and Row Level Security (RLS)
- **Performance Benchmarks**: Comprehensive performance documentation with benchmarks across small (25 files), medium (150 files), and large (218 files) workflows
- **Video Tutorial Platform Example**: Complex real-world example demonstrating courses, lessons, enrollments, progress tracking, and reviews
- **Enhanced Troubleshooting Documentation**: Expanded troubleshooting template with 8 new comprehensive scenario categories:
  - Environment setup issues (Node.js, env vars, package managers)
  - Port conflicts and resolution
  - Docker container issues
  - Dependency management problems
  - Performance optimization tips
  - React-specific issues (hooks, re-renders, hydration)
  - Express backend issues (middleware, CORS, async/await)
  - Prisma database issues (migrations, types, client generation)

### Documentation
- Added `docs/PERFORMANCE.md` with detailed performance analysis and optimization recommendations
- Performance benchmarks show excellent memory efficiency (O(1) constant ~137 MB)
- Identified I/O bottleneck as primary optimization opportunity for medium/large workflows

### Examples
- Added `examples/video-tutorial-platform.workflow.yaml` demonstrating complex application with 6 models and relationships

## [0.3.0] - 2025-10-13

### Added
- **Intent-Based Documentation System**: Declarative approach to documentation generation
  - Specify WHAT documentation is needed, generators determine HOW to create it
  - Support for multiple documentation types: tutorials, methodology, troubleshooting, API reference, setup guides, best practices, architecture
  - Smart regeneration with overwrite policies (always, if-missing, never)
  - Multi-language documentation support
- **Comprehensive Documentation Templates**:
  - Architecture documentation with system overview and component diagrams
  - API reference documentation with endpoint details and examples
  - Tutorial documentation with step-by-step guides
  - Best practices documentation with coding standards and patterns
  - Troubleshooting documentation with common issues and solutions
- **Drizzle ORM Support**: Added Drizzle as an alternative to Prisma for database management
- **Enhanced Backend Generator**: Improved TypeScript/Express generator with Prisma schema generation
- **Modernized Testing Infrastructure**: Updated Jest configuration and removed deprecation warnings

### Fixed
- Critical React generator bugs preventing compilation
- Critical backend generator bugs preventing compilation
- TypeScript errors and linting issues
- Flaky timing test in retry-manager

### Changed
- Made `ExtendedWorkflow.technology` field optional for greater flexibility
- Made `ExtendedWorkflow.models` optional to support cache-only workflows
- Improved error messages and validation feedback

### Documentation
- Updated README with Intent-Based Documentation System overview
- Added comprehensive integration tests for documentation generation

## [0.2.0] - 2025-10-10

### Added
- Extended UI Schema Support for advanced frontend generation
- Checkpoint system for resumable code generation
- Retry logic for transient failures
- Error handling and recovery mechanisms
- Performance optimizations for file I/O operations

### Changed
- Refactored generator architecture for better extensibility
- Improved validation and error messages

## [0.1.0] - 2025-10-08

### Added
- Initial release of Bangstack
- Workflow-based code generation
- TypeScript/Express backend generator
- React frontend generator
- Prisma database generator
- Docker Compose generator
- GitHub Actions CI/CD generator
- Environment configuration generator
- Basic documentation generation
- CLI with generate, validate, init commands

[0.3.1]: https://github.com/yourusername/bangstack/compare/v0.3.0...v0.3.1
[0.3.0]: https://github.com/yourusername/bangstack/compare/v0.2.0...v0.3.0
[0.2.0]: https://github.com/yourusername/bangstack/compare/v0.1.0...v0.2.0
[0.1.0]: https://github.com/yourusername/bangstack/releases/tag/v0.1.0
