# Known Issues

## ❌ TUI Interface Critical Issues

### Issue Description

The TUI application has multiple critical issues that make it unusable:

```
- Multiple re-renders causing screen flicker and corruption
- Layout corruption with overlapping menu boxes
- Configuration errors preventing proper operation
- PowerShell crashes on exit
- Garbled text display and unreadable interface
- Infinite rendering loops
```

### Root Cause

The TUI implementation has fundamental architectural issues:

- React rendering lifecycle incompatible with terminal environment
- State management causing infinite re-renders
- Layout calculations not working with Windows PowerShell
- Improper cleanup causing PowerShell crashes on exit
- Component lifecycle issues with Ink 6.x and React 19.x

### Current Status

- **CLI Functionality**: ✅ **FULLY FUNCTIONAL** - All core features work perfectly
- **TUI Functionality**: ❌ **NOT FUNCTIONAL** - Critical issues make it unusable

### Recommended Solution

**Use the CLI interface** which provides 100% of the functionality:

#### CLI Interface (Fully Functional)

```bash
# Run price updates
npm run update

# Run rollbacks
npm run rollback

# Debug tags
npm run debug-tags

# View help and options
node src/index.js --help

# Main application
npm start
```

#### TUI Interface Status

```bash
# ❌ DO NOT USE - Has critical issues
npm run tui  # Will cause screen corruption and PowerShell crashes
```

### Technical Analysis

The TUI issues stem from:

1. **Rendering Problems**: Multiple re-render cycles causing screen corruption
2. **State Management**: Infinite loops in React state updates
3. **Platform Compatibility**: Ink components not working properly on Windows PowerShell
4. **Memory Leaks**: Improper cleanup causing crashes on exit
5. **Layout Engine**: Box calculations causing overlapping elements

### Verification

Core functionality verification (all working):

- ✅ Price updates and rollbacks
- ✅ Shopify API integration
- ✅ Configuration management
- ✅ Scheduled operations
- ✅ Tag analysis and debugging
- ✅ Progress logging and reporting
- ✅ Error handling and recovery

The application is fully functional via CLI interface.