ruch/CHANGELOG.md

Revolutionary React TypeScript CLI with hexagonal architecture & AI-powered development assistance. Create maintainable, scalable applications with domain-driven design and integrated AI tooling.

# Changelog

All notable changes to this project 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).

## [1.1.3] - 2025-01-20

### 🚨 Critical Anti-Pattern Prevention

- **NEW**: Added critical rules to prevent common development mistakes
- **ENHANCED**: Guide-AI now includes comprehensive anti-pattern detection:
  - NEVER create local mock implementations of domain hooks in components
  - NEVER mock functions or hooks - use MSW to mock API responses instead
  - NEVER create barrel export files (index.ts) with mock implementations
  - Always import actual domain hooks from their designated locations
- **IMPROVED**: Enhanced testing guidelines emphasizing MSW over function mocking
- **ADDED**: Detailed examples showing correct vs incorrect patterns

### 🛡️ New Rules Added

- `no_function_mocks`: Prevents function and hook mocking
- `no_local_hook_mocks`: Prevents local hook implementations in components
- `no_barrel_mocks`: Prevents mock implementations in barrel files

### 📚 Enhanced Documentation

- **NEW**: Comprehensive examples showing anti-patterns and correct solutions
- **ENHANCED**: Testing strategy with MSW-first approach
- **IMPROVED**: Clear guidelines for hook usage and import patterns

## [1.1.2] - 2025-01-20

### 🏗️ Architecture Improvements

- **ENHANCED**: Guide-AI now recommends organizing MSW mocks in domain-specific `mocks/` folders
- **IMPROVED**: Better mock data organization with domain isolation principles
- **ADDED**: Examples showing domain-specific mock data and handlers structure
- **UPDATED**: File structure documentation to include `{domain}/mocks/` folders
- **CLARIFIED**: Global vs domain-specific mock organization guidelines

### 📚 Documentation

- **NEW**: Domain Mock Data Organization section in AI guides
- **ENHANCED**: MSW configuration examples with domain-specific structure
- **IMPROVED**: Testing strategy documentation with better mock organization

## [1.1.1] - 2025-01-20

### 🐛 Bug Fixes

- **FIXED**: Removed sourcemap warnings in CLI by disabling sourcemap generation for production build
- **IMPROVED**: Cleaner CLI output without development warnings

## [1.1.0] - 2025-01-20

### 🎉 Major Features

#### 🤖 AI-Powered Development (Flagship Feature)

- **NEW**: `guide-ai` command with comprehensive AI tool integration
- **UPDATED**: Cursor rules now use 2025 `.mdc` format in `.cursor/rules/`
- **NEW**: GitHub Copilot repository custom instructions format
- **ENHANCED**: Windsurf configuration with improved 2025 standards
- **NEW**: Juni AI integration with comprehensive instructions

#### 🏗️ Enhanced Architecture Support

- **IMPROVED**: Better hexagonal architecture enforcement
- **NEW**: Enhanced code examples in AI configurations
- **ADDED**: Anti-pattern detection and prevention
- **ENHANCED**: Domain isolation principles

### ✨ New Features

- **NEW**: Revolutionary README.md with comprehensive documentation
- **NEW**: Enhanced package.json with better metadata and scripts
- **NEW**: Improved CLI command descriptions and help
- **NEW**: Better error handling and user feedback
- **ADDED**: Architecture visualization improvements
- **NEW**: Enhanced testing strategies documentation

### 🔧 Improvements

- **ENHANCED**: MSW integration with better templates
- **IMPROVED**: Service context generation
- **UPDATED**: TypeScript configurations
- **BETTER**: Code generation templates
- **ENHANCED**: Domain structure consistency

### 🛠️ Technical Changes

- **MIGRATION**: From legacy `.cursorrules` to `.cursor/rules/*.mdc` format
- **UPDATED**: AI tool configurations for 2025 compatibility
- **IMPROVED**: Build and deployment processes
- **ENHANCED**: Testing framework integration
- **BETTER**: Code quality enforcement

### 📚 Documentation

- **MAJOR**: Complete README.md overhaul with modern design
- **NEW**: Comprehensive usage examples
- **ADDED**: Real-world project workflows
- **ENHANCED**: Architecture principles explanation
- **NEW**: Testing strategy documentation

### 🔄 Breaking Changes

- **BREAKING**: Cursor configuration now uses `.mdc` format instead of `.cursorrules`
- **MIGRATION**: Old `.cursorrules` files are automatically removed
- **UPDATED**: AI tool configuration file locations

### 🐛 Bug Fixes

- **FIXED**: Guide-ai generation with proper YAML frontmatter
- **IMPROVED**: File path handling across different systems
- **BETTER**: Error handling in CLI commands
- **FIXED**: Template generation consistency

## [0.1.0] - 2024-12-XX

### Initial Release

- Basic domain creation functionality
- Hexagonal architecture structure generation
- MSW integration
- Service context management
- Basic CLI commands

---

## Migration Guide: 1.0.x → 1.1.0

### Cursor Users

Your old `.cursorrules` file will be automatically migrated to the new `.cursor/rules/ruch-architecture.mdc` format when you run:

```bash
npx ruch@1.1.0 guide-ai --tools cursor
```

### AI Tool Integration

To take advantage of the new AI features:

```bash
# Update all AI tool configurations
npx ruch@1.1.0 guide-ai --tools cursor,copilot,windsurf,juni
```

### New Recommended Workflow

```bash
# Create domains as before
npx ruch create user

# Generate enhanced AI documentation (NEW!)
npx ruch guide-ai

# Your AI assistant now understands your architecture!
```