woaru

v5.4.0

Published

6 months ago

Universal Project Setup Autopilot - Analyze and automatically configure development tools for ANY programming language

WOARU 🚀 v5.3.6

WorkaroundUltra - Universal Project Setup Autopilot & Production-Readiness Agent

The ultimate "Tech Lead in a Box" - Analyze, monitor, and automatically configure development tools for ANY programming language with real-time quality checks, SOLID architecture analysis, and production-readiness audits.

🆕 Latest Release: v5.3.6 - Enhanced AI Control Center

Release Date: August 4, 2025

🎯 PATCH: Enhanced AI Control Center & UX Improvements

This release focuses on improving user experience for AI provider management and code review functionality.

Key Improvements:

🔛 Enhanced AI Provider Toggle: Clear "Toggle Code Reviews (Currently: enabled/disabled)" functionality
📊 Dynamic Status Display: Real-time status indicators showing current provider state
💬 Improved User Feedback: Clear confirmation messages when toggling code review settings
🎯 Better Provider Management: Easy enable/disable of providers without full reconfiguration

Previous Major Features (v5.3.0):

🚀 Interactive Project Initialization (woaru init): Complete project scaffolding system with Next.js and Python FastAPI templates
📋 Translation Validation System: Production-ready i18n quality assurance with automated validation
📤 Message Handler System: Advanced report management with webhook integration for team collaboration
📚 Enhanced CLI Experience: Improved command help, internationalization, and user-friendly error handling

Revolutionary Features:

Instant Project Setup: Create production-ready projects in seconds with industry best practices
Template Engine: Dynamic content generation with Handlebars for flexible project structures
Quality Assurance: Automated translation validation prevents deployment of incomplete localizations
Team Integration: Share analysis results through Slack/Discord webhooks seamlessly

🔄 Previous Release: v5.2.0 - Enhanced i18n System & Build Optimization

Release Date: July 28, 2025

📚 Previous Release: v5.1.4 - Major Technical Hardening & Modernization

Release Date: July 26, 2025

🚀 MAJOR: Complete ES Modules Migration & Code Quality Overhaul

This release represents a comprehensive technical hardening of the entire codebase, addressing critical issues identified in an external code review.

Key Improvements:

ES Modules Migration: Complete migration from CommonJS to ES Modules for modern, future-proof architecture
Cross-Platform Compatibility: Build system now works seamlessly across Windows, Mac, and Linux
Code Quality: Over 1,000 ESLint violations automatically fixed with consistent formatting
Type Safety: All 144 TypeScript any warnings eliminated with proper type definitions
Complete i18n: All remaining hardcoded strings replaced with proper internationalization

Technical Details:

Zero security vulnerabilities (npm audit clean)
Zero ESLint errors or warnings
Zero TypeScript any types in production code
100% internationalization coverage
Modern ES2022 compilation target

🌟 Previous Release: v5.1.2 - Complete i18n System Overhaul

Release Date: July 19, 2025

🔒 MAJOR: Advanced Multi-Layer Security Analysis Engine

New Feature: Enterprise-grade security vulnerability detection system with comprehensive threat analysis. WOARU now includes professional-grade security scanning capabilities with Semgrep integration and intelligent pattern-based fallback analysis.

🌍 MAJOR: Complete Internationalization (i18n) Implementation

Enhanced Feature: Fully internationalized user interface with comprehensive language support. All hardcoded German strings (100+) have been replaced with proper i18n translation keys, providing seamless German and English language support throughout the entire application.

Revolutionary Solution:

🌍 Complete i18n Architecture:
- Integrated i18next with filesystem backend for scalable translation management
- Created comprehensive localization files for English (🇺🇸) and German (🇩🇪)
- Implemented persistent language preferences in ~/.woaru/config/user.json
- Added automatic first-time language selection with visual flag indicators
🤖 AI Response Localization:
- Enhanced AIReviewAgent to include language instructions in prompts
- LLM responses now automatically generated in user's preferred language
- System prompts dynamically inject language-specific instructions
- Maintains consistency between UI language and AI analysis language
🎯 Interactive Language Commands:
- New woaru language command for intuitive language selection
- Real-time language switching with immediate feedback
- Enhanced woaru config set language <lang> for direct configuration
- Visual indicators with country flags for better user experience
📊 Comprehensive UI Localization:
- Status commands fully translated (woaru status shows localized output)
- Configuration commands with multilingual support
- Error messages and help text in user's preferred language
- Consistent terminology across all CLI interactions

🔧 Technical Implementation

# New i18n Commands
woaru language                    # Interactive language selection
woaru config set language de     # Direct language setting
woaru config show               # Display current language settings

# First-time Setup
🌍 Welcome to WOARU / Willkommen bei WOARU
? Please select your preferred language:
❯ 🇺🇸 English (en)
  🇩🇪 Deutsch (de)

🏗️ Enhanced System Architecture

i18n Framework: src/config/i18n.ts - Complete internationalization system
Language Management: src/config/languageSetup.ts - Interactive language selection
Configuration Extension: src/config/ConfigManager.ts - User preferences persistence
AI Integration: src/ai/AIReviewAgent.ts - Localized AI prompt generation
Translation Resources: locales/en/ and locales/de/ - Comprehensive language files

📊 User Experience Improvements

First-time Setup: Automatic language selection with visual flag indicators
Language Switching: Seamless language changes with immediate effect
Consistent Experience: All text (UI and AI responses) in user's preferred language
Visual Enhancement: Country flags (🇺🇸/🇩🇪) for improved language recognition
Persistent Settings: Language preference saved globally across all WOARU sessions

🌐 Supported Languages

🇺🇸 English - Complete localization with US flag indicator
🇩🇪 Deutsch - Full German translation with German flag indicator
Extensible Architecture - Framework ready for additional languages

🔄 Backward Compatibility

✅ All existing commands work unchanged
✅ Default language is English for new users
✅ No breaking changes to existing functionality
✅ Gradual migration path for existing users

📚 Previous Release: v4.7.1 - AI Control Center Bug Fixes

Release Date: July 16, 2025

🐛 PATCH: Critical AI Control Center Bug Fixes

Problem Solved: v4.7.0 introduced a revolutionary AI Control Center, but contained critical bugs that caused crashes and inconsistent behavior. Users experienced Cannot read properties of null (reading 'enabled') errors and inconsistent CLI documentation.

Professional Solution:

🔧 Fixed Status Display Crash:
- Resolved Cannot read properties of null (reading 'enabled') error in AI Control Center
- Fixed ConfigManager methods to properly filter provider objects vs configuration entries
- Added validation to prevent processing of multi_ai_review_enabled and primary_review_provider_id as providers
🎯 Enhanced Provider Management:
- getConfiguredAiProviders() now correctly filters only actual provider objects
- getEnabledAiProviders() properly ignores metadata and configuration entries
- getConfiguredProviderCount() accurately counts only valid provider configurations
📊 Improved Status Accuracy:
- AI Control Center now correctly displays "X configured | Y enabled" without crashes
- Provider list shows accurate enabled/disabled status and API key validation
- Multi-AI Review status displays correctly with proper primary provider selection
🔄 CLI Consistency:
- All woaru commands documentation now consistently uses ai instead of llm
- Fixed remaining inconsistencies in usage strings and descriptions
- Maintained backward compatibility with deprecation warnings for legacy commands

🔧 Technical Implementation

// Fixed ConfigManager provider filtering
async getConfiguredAiProviders(): Promise<string[]> {
  const providers = [];
  for (const [key, value] of Object.entries(config)) {
    // Skip metadata and configuration entries
    if (key === '_metadata' || key === 'multi_ai_review_enabled' || key === 'primary_review_provider_id') {
      continue;
    }
    // Only include actual provider objects
    if (value && typeof value === 'object' && value.hasOwnProperty('enabled')) {
      providers.push(key);
    }
  }
  return providers;
}

🏗️ Enhanced System Architecture

Provider Validation: Robust filtering of provider objects vs configuration entries
Status Display: Safe rendering of AI Control Center status without crashes
Configuration Management: Proper separation of provider data and global settings
Error Handling: Comprehensive validation to prevent null reference errors

📊 User Experience Improvements

Crash-Free Operation: AI Control Center now runs without Cannot read properties of null errors
Accurate Status: Provider counts and status display correctly reflect actual configuration
Consistent CLI: All commands use unified ai terminology throughout documentation
Reliable Navigation: AI Control Center menus work correctly with proper provider filtering

📚 Previous Release: v4.7.0 - Multi-AI Review Control Center

Release Date: July 16, 2025

🎯 MINOR: Multi-AI Review Control Center & Single-AI Mode

New Feature: Advanced AI provider management with granular control over Multi-AI vs Single-AI Review modes. Users can now choose between comprehensive multi-provider analysis or focused single-provider reviews for faster, cost-effective code analysis.

Key Features:

🎛️ AI Control Center Dashboard:
- Interactive management of all configured AI providers
- Real-time status display with API key validation
- Provider enable/disable controls with visual feedback
- Comprehensive overview: "3 configured | 2 enabled" with detailed breakdown
🔄 Multi-AI Review Mode:
- Contact all enabled AI providers for comprehensive analysis
- Cross-provider consensus detection and comparison
- Aggregated findings with LLM agreement scoring
🎯 Single-AI Review Mode:
- Select one primary provider for focused analysis
- Significant cost reduction (1/3 of multi-provider cost)
- Faster analysis with maintained quality
- Configurable primary provider selection
⚙️ Intelligent Configuration Management:
- Automatic fallback logic when primary provider not set
- Validation of provider availability and API keys
- Dynamic configuration updates with live feedback

🔧 Technical Implementation

# New AI Control Center
npx woaru ai                         # Interactive AI provider dashboard
npx woaru ai setup                   # Enhanced provider setup with onboarding

# Multi-AI Review Configuration
"multi_ai_review_enabled": true      # Enable multi-provider analysis
"primary_review_provider_id": "anthropic"  # Set primary for single-AI mode

🏗️ Enhanced System Architecture

AI Control Center: src/cli.ts:300-450 - Interactive dashboard with context-sensitive menus
Multi-AI Review Config: src/config/ConfigManager.ts:315-366 - Global review mode management
Smart Provider Filtering: src/ai/ConfigLoader.ts:105-155 - Dynamic provider selection logic
Configuration Validation: Automatic primary provider validation with fallback handling

📊 User Experience Improvements

Status Display: Clear visual indicators for provider configuration state
Mode Selection: Intuitive toggle between Multi-AI and Single-AI modes
Cost Transparency: Clear messaging about analysis costs and provider contact
Onboarding Flow: Smooth introduction to Multi-AI Review features during setup

📚 Previous Release: v4.6.1 - AI Setup Dialog Bugfixes

Release Date: July 16, 2025

🐛 PATCH: AI Setup Dialog Bugfixes & UX Improvements

Problem Solved: v4.6.0 introduced a new AI setup dialog that had critical usability issues: incorrect prompt order (API key before model selection), broken interactive navigation, and configuration migration failures that caused users to lose their existing AI provider settings.

Professional Solution:

🔧 Fixed Prompt Order:
- Corrected provider configuration sequence: 1. Model Selection → 2. API Key → 3. Activation
- Dynamic model loading from ai-models.json with rich descriptions
- Proper default selection for latest/recommended models
🎯 Enhanced Setup Loop:
- Replaced problematic checkbox prompts with robust list/confirm prompts
- Added dynamic status indicators: "Anthropic Claude (AKTIV: claude-4-opus)" vs "OpenAI GPT (NICHT KONFIGURIERT)"
- Implemented intuitive "Setup Another Provider?" workflow
🔄 Configuration Migration:
- Added automatic llm_config.json → ai_config.json migration logic
- Preserves existing user configurations during terminology updates
- Clear user notification when migration occurs
⚡ Improved UX Flow:
- Streamlined provider selection with live status updates
- Better error handling and validation for API keys
- Clearer German/English mixed messaging for better accessibility

🔧 Technical Implementation

# Fixed setup workflow
npx woaru ai setup              # New, working interactive setup
npx woaru setup llm             # Backward compatibility maintained

# Configuration migration
~/.woaru/config/llm_config.json → ~/.woaru/config/ai_config.json

🏗️ Enhanced System Architecture

Setup Loop: src/cli.ts:349-450 - Complete rewrite with proper prompt sequencing
Configuration Migration: src/config/ConfigManager.ts:433-461 - Automatic legacy config migration
Dynamic Model Loading: Integration with ai-models.json for up-to-date provider information
Robust Error Handling: Graceful fallbacks for missing configurations or network issues

📚 Previous Release: v4.6.0 - AI-First User Experience

Release Date: July 16, 2025

🤖 MINOR: AI-First User Experience & Terminology Optimization

Problem Solved: v4.5.0 used technical "LLM" terminology throughout the CLI, which was confusing for non-technical users and created barriers to adoption. The term "LLM" (Large Language Model) is industry jargon that doesn't clearly communicate the value to end users.

User-Centric Solution:

🎯 AI-First Terminology:
- Replaced all "LLM" references with user-friendly "AI" terminology
- woaru llm setup → woaru ai setup (with backward compatibility)
- woaru analyze llm → woaru analyze ai
- woaru review git llm → woaru review git ai
- All help text and documentation updated to use accessible language
🚀 Enhanced User Onboarding:
- Proactive explanation for woaru docu ai with German localization
- Interactive confirmation with educational context
- Real-world examples showing AI documentation benefits
- Step-by-step guidance for AI provider configuration
🔄 Backward Compatibility:
- All legacy llm commands still work with deprecation warnings
- Smooth migration path for existing users
- ConfigManager maintains compatibility with old method names
📁 Configuration Architecture:
- Migrated from llm_config.json to ai_config.json
- Improved file naming for better user understanding
- Updated all internal references while maintaining API compatibility
💡 User Experience Improvements:
- Clear explanations of what AI analysis provides
- German-language help text for better accessibility
- Interactive prompts guide users through setup process
- Educational content explains AI benefits in practical terms

🔧 Technical Implementation

# New AI-first commands
woaru ai setup                    # Configure AI providers
woaru ai                          # View AI configuration status
woaru analyze ai                  # AI-powered code analysis
woaru review git ai               # AI analysis of git changes
woaru docu ai                     # AI documentation generation

# Legacy commands (still work)
woaru setup llm                   # Shows deprecation warning
woaru analyze llm                 # Shows deprecation warning

🏗️ Enhanced System Architecture

User-Friendly Command Structure: Complete rename from technical "LLM" to accessible "AI"
Proactive User Education: Built-in explanations for AI features in German
Backward Compatibility Layer: Seamless migration for existing users
Configuration Management: Improved file naming and structure
Interactive Setup Experience: Guided AI provider configuration

📚 Previous Release: v4.5.0 - Cross-Platform ASCII Art System

Release Date: July 15, 2025

🚀 MINOR: Cross-Platform Pure JavaScript ASCII Art Generator

Problem Solved: v4.4.0 used image-to-ascii library which required external system dependencies (GraphicsMagick/ImageMagick) that weren't guaranteed on user systems, causing installation failures and poor user experience.

Revolutionary Solution:

🎨 Pure JavaScript PNG-to-ASCII Conversion:
- Replaced image-to-ascii with jimp - 100% Pure JavaScript solution
- No external system dependencies (GraphicsMagick/ImageMagick) required
- Real-time generation from PNG logo files with custom pixel-to-ANSI conversion
- Professional terminal-optimized rendering with ANSI-256 color support
🌈 Advanced Color & Character Mapping:
- Custom RGB-to-ANSI-256 color conversion algorithm
- Brightness-based character selection (░▒▓█)
- Multiple character sets (block, ASCII, high-contrast)
- Automatic aspect ratio correction for terminal characters
📐 Adaptive Terminal Sizing:
- Customizable width/height with automatic scaling
- Multiple rendering modes (compact, terminal-optimized, high-contrast)
- Intelligent aspect ratio handling (2:1 for terminal character proportions)
- Graceful fallback to simple box design when image loading fails
🛡️ Platform Independence:
- 100% cross-platform compatibility (Windows, macOS, Linux)
- No external binaries or system dependencies required
- Reliable installation on all Node.js environments
- Zero configuration needed for users
⚡ Performance Optimized:
- Efficient jimp-based image processing
- Smart pixel-to-character conversion algorithms
- Minimal memory footprint with automatic cleanup
- Fast ANSI color code generation

🔧 Technical Implementation

# Updated dependencies
- Removed: image-to-ascii (external deps)
+ Added: jimp (pure JavaScript)

# Enhanced file structure
src/utils/asciiArtGenerator.ts     # Pure JS ASCII generation with jimp
src/assets/splash_logo.ts          # Updated splash screen integration

# New capabilities
woaru                              # Shows cross-platform ASCII art logo
woaru --help                       # Shows help (unchanged)

🏗️ Enhanced System Architecture

Pure JavaScript ASCII Art Generator: src/utils/asciiArtGenerator.ts
- rgbToAnsi256() - Custom RGB-to-ANSI-256 color conversion
- getBrightness() - Pixel brightness calculation for character selection
- intToRGBA() - Color extraction from jimp pixel data
- generateTerminalOptimizedAsciiArt() - 70x20 colored output
- generateCompactAsciiArt() - 40x12 monochrome output
- generateHighContrastAsciiArt() - 50x15 block-character output
- generateFallbackAsciiArt() - Emergency fallback (unchanged)
Cross-Platform Compatibility: Zero external dependencies, works everywhere

📚 Previous Release: v4.3.1 - ANSI Art Splash Screen Bugfix

Release Date: July 15, 2025

🐛 PATCH: Critical ANSI Logo Display Fix

Problem Solved: The ANSI art splash screen was displaying raw escape codes instead of colored graphics due to incorrect escape sequence format and console output method.

Professional Solution:

🔧 ANSI Escape Sequence Fix:
- Corrected \e to \x1b for proper JavaScript interpretation
- Fixed all 6 lines of ANSI art with proper color codes
- Ensures terminal compatibility across all platforms
⚡ Output Method Optimization:
- Replaced console.log() with process.stdout.write() for ANSI codes
- Prevents additional formatting that breaks color sequences
- Direct stream writing for pixel-perfect logo display
🛡️ Terminal Compatibility Check:
- Added TTY detection for ANSI support validation
- Fallback to compact logo for non-TTY environments
- Graceful degradation maintains functionality everywhere

🎯 Technical Implementation

# Fixed ANSI art display
woaru                    # Now shows proper colored logo
woaru --help            # Shows full help as before

🔧 Files Modified

src/assets/splash_logo.ts - ANSI sequence correction and output method fix
All ANSI escape sequences converted from \e to \x1b format
Terminal compatibility detection added for robust display

📚 Previous Release: v4.3.0 - Visual Identity & ANSI Art Splash Screen

Release Date: July 15, 2025

🎨 MINOR: Visual Identity & ANSI Art Splash Screen

Problem Solved: WOARU needed a distinctive visual identity and better user experience when launched without arguments, replacing the generic help output with a branded splash screen.

Professional Solution:

🎭 ANSI Art Splash Screen:
- High-quality ANSI art representation of the WOARU robot logo
- Displays automatically when woaru is called without arguments
- Compact 6-line display for optimal terminal integration
- Preserves all existing command functionality
🎯 Enhanced User Experience:
- Clear branding with "🤖 WOARU - Tech Lead in a Box"
- Dynamic version display from package.json
- Quick command overview for immediate productivity
- Professional visual identity for CLI tool
⚡ Smart Display Logic:
- Splash screen only for woaru without arguments
- Normal help display for --help and -h flags
- All existing commands work unchanged

🔧 Technical Implementation

# New splash screen behavior
woaru                    # Shows ANSI art + quick commands
woaru --help            # Shows full help as before
woaru version           # Shows version as before
woaru analyze           # Runs analysis as before

🎯 New Visual Identity Structure

src/assets/
└── splash_logo.ts      # ANSI art and splash screen logic

📚 Previous Release: v4.2.0 - Robust Test & Quality Assurance Framework

Release Date: January 15, 2025

🚀 MINOR: Robust Test & Quality Assurance Framework

Problem Solved: Based on comprehensive project audit, WOARU needed professional-grade testing infrastructure to prevent critical bugs like hardcoded model lists and premature releases that occurred in previous versions.

Professional Solution:

🧪 Comprehensive Test Infrastructure:
- Jest optimized for TypeScript and async operations
- Custom matchers for AI providers and JSON validation
- Test fixtures with mock data for consistent testing
- Isolated test environment with temp directories
🔬 Critical Integration Tests:
- ToolsDatabaseManager tests covering all database operations
- AI Models Database loading with local file priority verification
- Setup LLM process tests with mocked interactive dialogs
- Error handling tests for corrupted files and network failures
🛡️ Anti-Regression Framework:
- Tests specifically designed to prevent hardcoded model lists
- Dynamic model loading verification across all providers
- Fallback mechanism testing for robustness
- API key storage and configuration validation
📋 Pre-Release Quality Gate:
- Comprehensive PRE_RELEASE_CHECKLIST.md with audit-based requirements
- Automated checks for hardcoded values in codebase
- Manual smoke tests for critical CLI commands
- Version consistency validation across all files

🎯 New Test Framework Structure

# Test Infrastructure
npm test                              # Run all tests including new integration tests
npm run test:watch                    # Watch mode for development

# Test Categories:
- Unit Tests: Existing CodeAnalyzer and ProjectAnalyzer tests
- Integration Tests: ToolsDatabaseManager and Setup LLM process tests
- Mock Data: tests/fixtures/ with consistent test data
- Quality Gates: PRE_RELEASE_CHECKLIST.md for manual verification

# Test Coverage:
tests/
├── fixtures/                         # Mock data for consistent testing
│   ├── mock-ai-models.json          # AI models test data
│   ├── mock-tools.json              # Tools database test data
│   └── mock-woaru-config.js         # Configuration test data
├── integration/                      # Integration tests
│   ├── ToolsDatabaseManager.integration.test.ts
│   └── setup-llm.integration.test.ts
└── setup.ts                         # Test utilities and custom matchers

🔄 Migration Guide

NEW: Comprehensive test infrastructure for developers
Enhanced: Quality assurance process with pre-release checklist
Improved: Anti-regression framework prevents critical bugs
Compatible: All existing functionality remains unchanged

📚 Previous Release: v4.1.0 - Enhanced AI Models Database with Claude 4 & DeepSeek

Release Date: January 15, 2025

Complete AI Models Database Implementation

Fixed local ai-models.json loading priority in ToolsDatabaseManager
Removed ALL hardcoded model references from setup functions
Added latest models: Claude 4 Opus, GPT-4.1, Gemini 2.5 Pro
16+ models across 5 LLM providers now properly loaded dynamically

📚 v4.0.0 - Revolutionary AI Models Database System

Release Date: January 15, 2025

Initial database-driven LLM configuration implementation

Introduced ai-models.json for centralized model management
Added DeepSeek AI provider support
Enhanced local Ollama model integration
Replaced hardcoded model lists with dynamic loading

📚 v3.9.0 - Revolutionary Review Commands Refactoring

Release Date: July 15, 2025

🚀 MAJOR: Professional Version Management

Problem Solved: Development teams need reliable, automated version management and environment validation to maintain consistent, up-to-date toolchains across projects and team members.

Revolutionary Solution:

🔄 Smart Version Commands:
- woaru version - Display current version
- woaru version check - Check for updates with release dates
- woaru update - One-command update to latest version
⚡ Proactive Startup Checks:
- Automatic version checking with 24-hour intelligent caching
- Interactive update prompts when new versions are available
- Environment validation for Git, Docker, and Snyk dependencies
🛡️ Enterprise-Grade Reliability:
- Secure update process with process isolation
- Robust error handling and graceful degradation
- Non-blocking startup checks that don't interrupt workflow
💡 Professional User Experience:
- Clear version information and update recommendations
- Transparent control over update decisions
- Comprehensive environment dependency validation

🎯 Version Management in Action

# Check current version
woaru version
# Output: WOARU Version: 3.8.0

# Check for updates
woaru version check
# Output: 📦 Eine neue Version (v3.8.1) ist verfügbar!
#         Veröffentlicht am: 16.07.2025

# Update to latest version
woaru update
# Output: 🚀 Updating WOARU to latest version...
#         ✅ Update erfolgreich abgeschlossen!

# Automatic startup checks
woaru analyze
# Output: 📋 Hinweise:
#         💡 Eine neue Version ist verfügbar. Führe 'woaru update' aus.
#         💡 TIPP: Docker ist nicht verfügbar. Containerisierung-Checks werden übersprungen.

🔍 Environment Validation

WOARU now automatically validates your development environment on startup:

✅ Git Detection: Critical for woaru review git functionality
💡 Docker Detection: Optional for containerization checks
🔒 Snyk Detection: Optional for enhanced security analysis

📚 Previous Release: v3.7.1 - Critical Bug-Fix Release

Release Date: July 15, 2025

🐛 CRITICAL BUG FIXES: Production-Ready Stability

Problem Solved: After extensive testing, we identified and fixed six critical bugs that could impact production usage. This PATCH release ensures WOARU is fully stable and ready for enterprise deployment.

Critical Fixes:

🔧 Setup Dialog Fix: Eliminated user confusion by replacing misleading "environment variable" instructions with clear success message
📁 Prompt Template Resolution: Fixed template loading from installation directory instead of current working directory
🛡️ JSON Escaping: Resolved API crashes from control characters in code analysis with proper JSON escaping
📚 Command Documentation: Added missing docu subcommands to comprehensive command reference
🔍 File Filtering: Implemented smart filtering to analyze only code files (no more .yml, .md, .json in LLM analysis)
💾 Storage Robustness: Enhanced UsageTracker with bulletproof error handling for corrupted usage files

🎯 Production Impact

This release transforms WOARU from "feature-complete" to "production-ready" with:

Zero Setup Confusion: Clear, actionable user guidance
Bulletproof File Handling: Robust error recovery and file processing
Optimized LLM Usage: Smart filtering reduces API costs and improves analysis quality
Enterprise Reliability: Comprehensive error handling prevents crashes

📚 Previous Release: v3.7.0 - Revolutionary AI-Optimized Documentation System

Release Date: July 15, 2025

🧠 REVOLUTIONARY: Machine-Readable Documentation for AI/LLM Comprehension

Problem Solved: As AI-powered development tools become ubiquitous, codebases need documentation that machines can understand as well as humans. Traditional documentation formats are optimized for human readability but lack the structured metadata that AI systems need for optimal code comprehension.

Revolutionary Solution:

🤖 AI Context Headers:
- New woaru docu ai command generates machine-readable YAML headers
- 13 structured categories optimized for AI/LLM understanding
- Comprehensive metadata about file purpose, architecture, and relationships
- First tool worldwide to generate AI-optimized code documentation
📋 Complete Documentation Suite:
- woaru docu nopro - Human-friendly "Explain-for-humans" comments
- woaru docu pro - Technical TSDoc/JSDoc documentation
- woaru docu ai - Machine-readable YAML context headers (NEW!)
🎯 Intelligent File Processing:
- Support for --path-only, --local, and --git options
- Preview mode with --preview flag
- Force mode with --force for CI/CD integration
- Multi-language support (TypeScript, JavaScript, Python, Java, etc.)
🏗️ Enterprise Configuration:
- All documentation constants centralized in APP_CONFIG
- Configurable schema versions and check limits
- No hardcoded values in the documentation system

🏗️ Technical Implementation

Example AI Context Header Generated by WOARU:

/*
woaru_context:
  file_purpose: "Core service class for secure API key management and environment configuration"
  file_type: "service_class"
  complexity_level: "medium"
  main_responsibilities:
    - "Secure storage of API keys in ~/.woaru/.env"
    - "Environment variable management with automatic gitignore"
    - "Multi-provider LLM configuration handling"
  tech_stack:
    language: "typescript"
    framework: "node.js"
  key_dependencies:
    external:
      - "dotenv: Environment variable loading"
      - "fs-extra: File system operations"
    internal:
      - "src/config/constants.ts: Central configuration"
  architectural_role: "utility_layer"
  business_impact: "critical"
  security_critical: true
  generated_by: "woaru docu ai"
  schema_version: "1.0"
*/

💡 Use Cases for AI Documentation

AI Code Reviews: LLMs can better understand code context and relationships
Automated Refactoring: AI tools can make safer changes with structured metadata
Code Search: Enhanced semantic search with machine-readable context
Documentation Generation: Future AI tools can build on existing context headers
Team Onboarding: New developers AND their AI assistants understand code faster

📚 Previous Release: v3.6.1 - REFACTOR: Comprehensive Hardcode Elimination & Central Configuration

Release Date: July 14, 2025

🔧 MAJOR REFACTOR: Enterprise-Grade Configuration Management

Problem Solved: WOARU had scattered hardcoded values across the codebase making maintenance difficult and configuration inconsistent. Magic numbers, API URLs, and tool commands were duplicated throughout the code.

Revolutionary Solution:

🏗️ Complete Hardcode Elimination:
- All ESLint rules centralized (no-var, eqeqeq, etc.)
- SOLID principle thresholds unified in central config
- API endpoints for all LLM providers standardized
- Tool commands (npx eslint, npm run lint) centralized
📋 Enhanced constants.ts Architecture:
- ESLINT_RULES - All linter rules in one place
- SOLID_THRESHOLDS - Configurable complexity limits
- QUALITY_THRESHOLDS - Adjustable quality standards
- TOOL_COMMANDS - Standardized CLI commands
- API_ENDPOINTS - Central API URL management
⚡ Maintenance Benefits:
- Single source of truth for all configuration values
- Easy threshold adjustments without code changes
- Consistent tool command usage across the codebase
- Type-safe configuration with TypeScript support

🏗️ Technical Implementation Examples

Before Refactoring (Scattered Hardcodes):

// ❌ Multiple files with hardcoded values
// CodeSmellAnalyzer.ts
rule: 'no-var'
severity: complexity > 15 ? 'error' : 'warning'

// SRPChecker.ts  
const thresholds = { low: 8, medium: 15, high: 25 };

// cli.ts
baseUrl: "https://api.anthropic.com/v1/messages"

// QualityRunner.ts
await execAsync(`npx eslint "${filePath}"`);

After Refactoring (Centralized Configuration):

// ✅ Single source of truth in constants.ts
// All files now import from central config
rule: APP_CONFIG.ESLINT_RULES.NO_VAR
severity: complexity > APP_CONFIG.QUALITY_THRESHOLDS.COMPLEXITY_WARNING
const thresholds = APP_CONFIG.SOLID_THRESHOLDS.METHODS_PER_CLASS
baseUrl: APP_CONFIG.API.ANTHROPIC
await execAsync(`${APP_CONFIG.TOOL_COMMANDS.ESLINT.BASE} "${filePath}"`);

🎯 Configuration Categories Centralized

ESLint Rules: NO_VAR, EQEQEQ, PREFER_CONST, NO_CONSOLE
SOLID Thresholds: Method counts, line limits, parameter counts
Quality Standards: Complexity warnings, error thresholds
Tool Commands: NPM scripts, ESLint commands, Prettier commands
API Endpoints: All LLM provider URLs centralized

📚 Previous Release: v3.6.0 - AI-Powered Code Documentation System

💡 Real-World Examples

Human-Friendly Documentation (nopro):

// Explain-for-humans: This function calculates the total cost including tax for customer purchases.
function calculateTotal(items, taxRate) {
  const subtotal = items.reduce((sum, item) => sum + item.price, 0);
  const tax = subtotal * taxRate;
  return subtotal + tax;
}

Technical Documentation (pro):

/**
 * Calculates the total cost including tax for a collection of items
 * 
 * @param {Array<Object>} items - Array of items with price property
 * @param {number} taxRate - Tax rate as decimal (e.g., 0.08 for 8%)
 * @returns {number} Total cost including tax
 * @example
 * // Calculate total for $100 worth of items with 8% tax
 * const total = calculateTotal([{price: 100}], 0.08); // returns 108
 */
function calculateTotal(items, taxRate) {
  const subtotal = items.reduce((sum, item) => sum + item.price, 0);
  const tax = subtotal * taxRate;
  return subtotal + tax;
}

🎯 Usage Examples

# Generate human-friendly documentation for uncommitted changes
woaru docu nopro --local

# Generate technical documentation for all files in src/
woaru docu pro --path-only src/

# Preview documentation changes before applying
woaru docu nopro --git main --preview

# Force documentation without interactive confirmation
woaru docu pro --local --force

📚 Previous Release: v3.5.0 - Dynamic & Customizable AI Prompt Templates System

🏗️ MAJOR: Complete Prompt Management Architecture

📚 Template Library - Professional prompt templates in templates/prompts/
- Each template includes system prompts, user prompts, parameters, and output formats
- Variable interpolation for context-aware analysis
- Structured YAML format for easy customization
🏠 User Customization - Personal templates in ~/.woaru/config/woaru_llm_prompts/[provider]/
- Automatic template copying during woaru setup llm
- Edit templates to match your team's standards
- Provider-specific optimization capabilities
⚡ Seamless Integration - Works with all LLM commands
- woaru analyze llm --prompt security_audit
- woaru review git llm --prompt performance_optimization
- woaru review local llm --prompt refactoring_suggestions
- woaru review path llm --prompt testing_strategy

🚀 User Experience Revolution

Before (Limited & Inflexible):

❌ Single generic prompt for all analyses
❌ No focus control for specific concerns
❌ Same analysis whether checking security or performance

After (Dynamic & Powerful):

✅ Choose specialized analysis focus with --prompt flag
✅ Security audits find vulnerabilities, not style issues
✅ Performance analysis targets bottlenecks, not formatting
✅ Customize prompts for your team's specific needs

🔧 Technical Implementation

🏗️ PromptManager Class - src/ai/PromptManager.ts handles all prompt operations
- Template loading and validation
- Variable interpolation system
- Provider-specific prompt management
- Fallback mechanisms for stability
🔄 Enhanced AIReviewAgent - Dynamic prompt injection per provider
- Provider-specific template selection
- Context-aware variable substitution
- Backwards compatibility maintained
📋 Professional Templates - 5 expert-crafted analysis templates
- Comprehensive documentation and examples
- Industry best practices embedded
- Extensible structure for custom additions

🎉 Impact & Benefits

🎯 Targeted Analysis - Get exactly the insights you need, when you need them
📈 Improved Accuracy - Specialized prompts yield more relevant findings
🔧 Team Customization - Adapt analysis to your coding standards
💡 Transparent AI - See and control exactly what the AI is asked to analyze

📚 Usage Examples

# Security-focused analysis
woaru analyze llm --prompt security_audit

# Performance optimization review  
woaru review git llm --prompt performance_optimization

# Refactoring suggestions for specific files
woaru review path src/api --prompt refactoring_suggestions

# Test coverage analysis
woaru analyze llm --prompt testing_strategy

# List available prompts
ls ~/.woaru/config/woaru_llm_prompts/[provider]/

🛡️ Available Prompt Templates

default_review.yaml - Balanced code quality analysis
security_audit.yaml - OWASP-aligned security scanning
performance_optimization.yaml - Bottleneck and efficiency analysis
refactoring_suggestions.yaml - Clean code and pattern recommendations
testing_strategy.yaml - Coverage and test quality assessment

🔍 Previous Release: v3.4.0 - MAJOR: Revolutionary Secure API Key Management System

Release Date: July 14, 2025

🚀 GAME-CHANGING: Complete Setup UX Revolution

Problem Solved: Users were confused by the old setup dialog asking for "environment variable names" instead of actual API keys, leading to setup failures and frustration.

Revolutionary Solution:

🎯 Direct API Key Input - Setup now asks directly: "Bitte füge deinen OpenAI API-Key ein (beginnt mit 'sk-'):"
🔐 Password-Masked Input - API keys are hidden during typing for security
✅ Smart Validation - Automatic format checking (sk- prefix, length validation)
⚡ Instant Availability - Keys work immediately after setup, no shell restarts required

🛡️ MAJOR: Revolutionary ConfigManager Architecture

🏠 Global .env Management - Secure API key storage in ~/.woaru/.env
- 600 File Permissions - Owner-only read/write access for maximum security
- Automatic .gitignore Protection - Prevents accidental commits to version control
- Cross-Session Persistence - Keys survive system restarts and terminal sessions
🔄 Automatic Environment Loading - dotenv integration loads keys on WOARU startup
- Zero Configuration - No manual shell setup or environment variable management
- Silent Fallback - Graceful handling when configuration is missing
- Universal Compatibility - Works across all terminals, IDEs, and environments

🎯 User Experience Transformation

Before (Confusing & Error-Prone):

❓ "Environment variable name for API key:"
→ User types: "sk-proj-abc123..." (WRONG!)
→ Result: ❌ API key not found in all LLM commands

After (Intuitive & Bulletproof):

✨ "Bitte füge deinen OpenAI API-Key ein (beginnt mit 'sk-'):"
→ User types: "sk-proj-abc123..." (CORRECT!)
→ Result: ✅ API key stored securely! 🚀 Ready for immediate use!

🔧 Technical Implementation

🏗️ New ConfigManager Class - src/config/ConfigManager.ts with enterprise-grade security
🔐 Secure Storage System - Automatic directory creation and permission management
⚡ Race Condition Fixes - Proper async/await initialization prevents startup errors
🛡️ Security by Default - Multiple layers of protection against accidental exposure

🎉 Impact & Benefits

📈 Setup Success Rate - Eliminates 100% of API key configuration confusion
🚀 Time to Productivity - From minutes of troubleshooting to instant success
🛡️ Security Enhancement - Professional-grade key management with automatic protection
💡 User Confidence - Clear, intuitive interface builds trust and reduces support burden

🔍 Previous Release: v3.3.1 - Production Polish & Legacy Cleanup

Release Date: July 14, 2025

🔧 Hotfix: Legacy References & Initialization

🧹 Complete Legacy Cleanup - Removed all outdated "WAU" references throughout codebase
- Updated notifications, error messages, and user-facing text to "WOARU"
- Fixed GitHub URLs pointing to old repository names
- Consistent branding across all components
⚡ ConfigManager Initialization Fix - Resolved race condition in environment loading
- Proper async/await structure ensures configuration loads before commands
- Eliminates "API key not found" issues on first startup
- Guaranteed environment variable availability across all commands
🛡️ First-Time User Experience - Enhanced startup behavior for new users
- Automatic directory creation (~/.woaru/) on first run
- Graceful handling of missing configuration files
- Clear guidance for setup without crashes or confusion

🔍 Previous Release: v3.3.0 - Secure API Key Management & Revolutionary Setup Experience

Release Date: July 14, 2025

🔐 MAJOR: Secure ConfigManager System

🛡️ Global .env Management - New ConfigManager class handles secure API key storage
- API keys stored in ~/.woaru/.env with 600 permissions (owner-only access)
- Automatic gitignore protection to prevent accidental commits
- Centralized configuration for all WOARU tools
🔄 Dotenv Integration - Automatic environment variable loading on startup
- No more manual shell configuration required
- Keys instantly available across all WOARU commands
- Silent fallback for missing configuration

🚀 Completely Overhauled Setup Process

💬 Intuitive User Interface - Revolutionary setup dialog experience
- Direct API key input: "Bitte füge deinen OpenAI API-Key ein"
- Password-masked input for security during typing
- Smart validation (checks for 'sk-' prefix for OpenAI/Anthropic)
- Immediate feedback and helpful error messages
⚡ One-Click Configuration - No more complex shell setup required
- Keys stored securely and automatically
- Ready to use immediately after setup
- Cross-session persistence without manual configuration

🛡️ Enhanced Security Features

🔒 File Permissions - Automatic 600 permissions on sensitive files
🚫 Git Protection - Automatic gitignore entries for .woaru/.env
⚠️ Safety Warnings - Alerts if no global gitignore is configured
🔐 Input Validation - Comprehensive API key format checking

🐛 Bulletproof Error Handling

💪 Super-Robust UsageTracker - Enhanced resilience against corrupted files
- Empty file detection and handling
- Invalid JSON recovery with automatic recreation
- Size-based validation before parsing
- Multiple fallback strategies
🔄 Graceful Degradation - System continues working even with missing components

🔧 Previous Features (v3.2.0):

📦 Unified Version System - Dynamic version loading from package.json
🔄 Update Command - woaru update for easy updates
🏗️ Architecture Refactoring - Centralized configuration system

🆕 Enhanced Commands:

# Secure, one-click LLM setup:
woaru setup llm

# Update WOARU to the latest version:
woaru update

# Check stored API keys:
ls ~/.woaru/.env  # (securely stored)

🎯 User Experience Revolution:

🔥 Zero-Configuration - API keys work immediately after setup
🛡️ Security by Default - Automatic protection against accidental commits
💡 Intuitive Interface - Clear prompts and helpful guidance
⚡ Instant Availability - No shell restarts or manual configuration required
🔄 Cross-Session Persistence - Configuration survives system restarts

🔍 Previous Release: v1.3.0 - Comprehensive Audit & Transparency System

Release Date: July 14, 2025

🔍 MAJOR: Complete Audit & Transparency System

📋 Standardized Report Filenames - All reports now use sortable timestamp format: woaru_[command]_report_[YYYY]-[MM]-[DD]_[HH]-[MM]-[SS]_[TZ].md
📊 Comprehensive Activity Logging - Every WOARU action is tracked with timestamps, context, and performance metrics in ~/.woaru/logs/woaru_actions.log
🔍 Advanced Log Management - New woaru logs command with filtering, export, and analysis capabilities
🎯 Message System Enhancement - woaru message latest now uses proper timestamp-based sorting for report delivery
⚡ Performance Tracking - Memory usage, execution time, and success/failure metrics for all operations

🚀 New Commands & Features:

woaru logs - View recent activity logs with filtering options
woaru logs --tail 100 - Show last 100 log entries
woaru logs --project /path - Filter logs by project path
woaru logs --action analyze - Filter logs by specific action type
woaru logs --since 2024-01-01 - Time-based log filtering
woaru logs --export json - Export logs in JSON, CSV, or TXT format
woaru logs clear - Clear all activity logs (with confirmation)
woaru logs stats - Show log file statistics and active actions

🔧 Technical Improvements:

Standardized Filename Generation - New FilenameHelper class for consistent report naming
Singleton Activity Logger - Comprehensive tracking system with start/complete cycles
Enhanced Report Generator - Automatic fallback to standardized filenames
Input Validation - Comprehensive validation and error handling across all new systems
TypeScript Quality - Full TSDoc documentation and type safety improvements

🛡️ Audit & Transparency Features:

Complete Action Tracking - Every command execution is logged with context and performance data
Sortable Report History - Chronological organization of all generated reports
Detailed Performance Metrics - Memory usage, execution time, and success rates
Flexible Log Analysis - Filter by time, project, action type, or export for external analysis
Secure Logging - No sensitive data logged, only operational context and metrics

📊 Previous Major Feature (v1.2.0):

SOLID Principles Checking - Complete SRP (Single Responsibility Principle) analysis for TypeScript/JavaScript
Architecture Scoring - 0-100 SOLID score with severity-weighted violations
Smart Detection - Method count, complexity, concern diversity, class size, parameter analysis
Seamless Integration - Automatic SOLID checks during woaru review commands
Detailed Reporting - Location-specific violations with explanations and solutions

WOARU is an intelligent CLI tool that scans your actual codebase, detects issues, provides live quality monitoring, checks SOLID principles compliance, and ensures your project is production-ready with specific explanations based on what it finds in your code.

⚡ Quick Start - Zero Installation Required

# Check what tools you have active:
npx woaru helpers

# Analyze your project:
npx woaru analyze

# Start intelligent monitoring with live quality checks:
npx woaru watch

# Perfect for Claude Code sessions:
# 1. Open any project in Claude
# 2. Type: npx woaru helpers  
# 3. See all active tools and missing recommendations
# 4. Type: npx woaru watch (for continuous monitoring)

🔧 Or Install Globally for Clean Commands

# Install once:
npm install -g woaru

# Then use anywhere:
woaru helpers
woaru analyze
woaru watch
woaru setup

🎯 Core Features

🔍 Phase 1: Live Quality Agent

Real-time code quality monitoring with file watchers
Instant feedback on every file save with 🚨 critical warnings
Smart linting that only checks what you're actually editing
Claude-optimized output for seamless AI development

🌍 Phase 2: Universal Language Support

WOARU supports 8 major programming languages with intelligent detection:

JavaScript/TypeScript - ESLint with auto-fix suggestions
Python - Ruff with automatic formatting
Go - gofmt + go vet integration
Rust - rustfmt + clippy warnings
C#/.NET - dotnet format compliance
Java - google-java-format + checkstyle
PHP - PHP_CodeSniffer (PSR-12 standard)
Ruby - RuboCop with auto-correct hints

🏗️ Phase 3: Production-Readiness Auditor

🔍 Error Monitoring Detection - Sentry, Rollbar, Bugsnag
🧪 Testing Framework Audits - Jest, Vitest, pytest, RSpec
🐳 Containerization Checks - Dockerfile, .dockerignore
🔒 Security Validation - Helmet.js, HTTPS enforcement, Snyk integration
⚙️ Configuration Management - .env.example, secrets validation
📊 Priority-based recommendations (Critical → High → Medium → Low)

🛡️ NEW: Comprehensive Security Expert with Snyk Integration

🚨 Critical Vulnerability Detection - Real-time dependency scanning
🔒 Code Security Analysis - Static analysis for security issues
⚡ Live Security Monitoring - Proactive security alerts during development
📊 Security Health Score - Quantified security posture measurement
🎯 Automated Security Recommendations - Framework-specific security advice

🏗️ NEW: SOLID Architecture Analysis (v1.2.0)

WOARU now includes comprehensive SOLID principles checking to make it a true "Tech Lead in a Box":

🎯 Single Responsibility Principle (SRP) - Detects classes with too many methods, high complexity, or multiple concerns
📊 SOLID Score (0-100) - Quantified architecture quality with severity-weighted scoring
🔍 Detailed Violation Analysis - Precise location, explanation, impact, and solution for each issue
🚀 Smart Recommendations - Context-aware architectural improvement suggestions
⚙️ Seamless Integration - Automatically runs during woaru review commands
🌍 Multi-language Support - TypeScript/JavaScript (Python, Go, Rust coming soon)

🚨 Live Quality Monitoring

When you run woaru watch, WOARU becomes your personal code quality guardian:

🚨 CRITICAL QUALITY CHECK FAILED 🚨
File: src/components/UserProfile.tsx
Tool: ESLint
──────────────────────────────────────────────────
/src/components/UserProfile.tsx
  15:7   error  'userdata' is assigned a value but never used
  23:1   error  'console' is not defined
  45:10  error  'validateEmail' is defined but never used

✖ 3 problems (2 errors, 1 warning)
──────────────────────────────────────────────────
💡 Fix these issues before continuing development
Run the tool manually to see detailed output

🏗️ Production-Readiness Audits

WOARU automatically audits your project for production best practices:

🏗️ Production-Readiness-Audit:

🔴 CRITICAL - Muss behoben werden:
   ⚠️ WARNUNG: Kein Testing-Framework gefunden
     → Tests sind essentiell für Code-Qualität
     📦 jest, vitest, @testing-library/react

🟡 HIGH PRIORITY - Sollte behoben werden:
   💡 PRO-TIPP: Kein Error-Monitoring gefunden
     → Installiere Sentry für Production-Error-Tracking
     📦 @sentry/react

🔵 MEDIUM - Verbesserung empfohlen:
   🐳 Kein Dockerfile gefunden
     → Containerisierung vereinfacht Deployment

🎪 Framework Intelligence

WOARU automatically detects your framework and provides specific recommendations:

Next.js - Suggests @sentry/nextjs, next/eslint, proper production configs
React - Recommends @testing-library/react, React-specific ESLint rules
Express - Suggests helmet.js, morgan logging, compression middleware
Django - Recommends django-environ, pytest-django, gunicorn setup
Spring Boot - Suggests actuator endpoints, logback configuration

📋 Available Commands

Core Commands

woaru analyze        # Deep project analysis with security audit + SOLID analysis
woaru setup          # Auto-setup recommended tools
woaru helpers        # Show active vs missing tools (★ most useful)
woaru watch          # Start live quality monitoring with security (★ supervisor mode)
woaru review         # Code review with universal directory analysis (★ REFACTORED v3.9.0!)
woaru docu           # AI-powered code documentation generator
woaru commands       # Show detailed command reference

🔄 Review Commands (★ REFACTORED v3.9.0!)

# Git-independent directory analysis
woaru review local                    # Analyze current directory (no Git required)
woaru review local src/components     # Analyze specific directory (no Git required)
woaru review local llm                # AI analysis of current directory

# Git-specific analysis
woaru review local git                # Analyze uncommitted changes (requires Git)
woaru review git                      # Analyze changes since main branch
woaru review path src/file.ts         # Analyze specific files or directories

Version & Update Management (★ NEW v3.8.0!)

woaru version        # Show current WOARU version
woaru version check  # Check for updates from NPM registry
woaru update         # Update WOARU to latest version

Status and Management

woaru status         # Show supervisor status
woaru recommendations # Show current recommendations
woaru stop           # Stop supervisor
woaru update-db      # Update tools database
woaru logs           # Show activity logs with filtering options (★ NEW!)
woaru message        # Send reports from history to configured channels

Utility Commands

woaru ignore <tool>  # Ignore specific tools
woaru rollback <tool> # Rollback tool configurations

🆕 Audit & Transparency Commands (v1.3.0)

woaru logs                    # Show recent activity logs
woaru logs --tail 100        # Show last 100 log entries
woaru logs --project /path   # Filter logs by project path
woaru logs --action analyze  # Filter logs by action type
woaru logs --since 2024-01-01 # Time-based filtering
woaru logs --export json     # Export logs (json, csv, txt)
woaru logs clear             # Clear all activity logs
woaru logs stats             # Show log statistics

woaru message all            # Send all reports from history
woaru message latest         # Send latest report (with timestamp sorting)

🔍 NEW: Revolutionary Review Sub-Commands (v1.1.0)

The woaru review command now features three specialized sub-commands for maximum flexibility and precision in code analysis:

🎯 Three Powerful Review Modes

1. Git Diff Reviews - Perfect for Pull Requests

# Analyze changes since main branch
woaru review git

# Compare against different branch  
woaru review git --branch develop

# Generate JSON report for CI/CD
woaru review git --json

# Custom output file
woaru review git --output pr-review.md

2. Local Changes - Pre-commit Quality Gates

# Analyze all uncommitted changes (staged + unstaged)
woaru review local

# Perfect before git commit
woaru review local --json

3. Path-Specific Analysis - Deep-dive into Components

# Analyze specific directory
woaru review path src/components

# Analyze single file
woaru review path src/api/users.ts

# Multi-file analysis
woaru review path "src/**/*.tsx"

🚀 Why Sub-Commands are Game-Changing

🎯 Ultra-Precise: Each mode targets exactly what you need to review
⚡ Lightning Fast: No wasted analysis on irrelevant files
🔄 CI-Ready: Different modes for different automation scenarios
👥 Team-Friendly: Clear intent makes collaboration seamless

Real Example Output

🔍 Analyzing changes since branch: main
📋 Found 3 changed files:
   • src/components/UserProfile.tsx
   • package.json
   • src/api/users.ts

🔍 Running quality checks on changed files...

✅ Review report generated: woaru-review.md
📊 ⚠️ Gefunden: 2 Qualitäts-Probleme, 1 Produktions-Empfehlungen

Sample Review Report (woaru-review.md)

# WOARU Code Review
**Änderungen seit Branch: `main`**

## 🚨 Kritische Qualitäts-Probleme

### `src/components/UserProfile.tsx`
**ESLint:**
- Zeile 23: 'userData' is assigned a value but never used
- Zeile 45: Missing dependency in useEffect hook

## 🏗️ SOLID Architecture Analysis

📊 **SOLID Score: 65/100** (3 Verstöße gefunden)

### 🔴 Single Responsibility Principle (3 Verstöße)

#### 🟡 HOCH (2)

**1. Klasse UserManager hat 18 Methoden**
📍 **Klasse:** UserManager:15
💡 **Problem:** Klassen mit vielen Methoden haben oft mehrere Verantwortlichkeiten
⚠️ **Auswirkung:** Schwer zu testen, zu verstehen und zu warten
🔨 **Lösung:** Teile die Klasse UserManager in kleinere, fokussierte Klassen auf

**2. Klasse UserManager importiert aus 4 verschiedenen Bereichen: database, http, validation, email**
📍 **Klasse:** UserManager:15
💡 **Problem:** Imports aus verschiedenen Bereichen deuten auf multiple Verantwortlichkeiten hin
🔨 **Lösung:** Separiere die verschiedenen Concerns in eigene Services

### 💡 SOLID-Empfehlungen
1. 🎯 1 Klassen mit zu vielen Methoden - teile diese in kleinere Services auf
2. 📦 1 Klassen mit zu vielen verschiedenen Concerns - verwende Dependency Injection

## 🟡 Empfehlungen zur Produktionsreife

### `package.json`
**Du hast `react-spring` hinzugefügt**
→ Kein Error-Monitoring konfiguriert. Erwäge @sentry/react für Production-Apps
📦 `@sentry/react`

Why `woaru review` is Game-Changing

⚡ 10x Faster: Only checks changed files, not entire project
🎯 Focused: Relevant feedback for current work
🔄 CI-Ready: Perfect for automated Pull Request checks
📊 Actionable: Specific recommendations with package names
🤝 Team-Friendly: Consistent review standards across the team

📚 NEW: Self-Documenting Commands Reference

Never forget what WOARU can do! The new woaru commands provides comprehensive documentation for every command:

# Show complete command reference
woaru commands

✨ Rich Command Documentation

📚 WOARU Command Reference
══════════════════════════════════════════════════

🔍 woaru analyze
  Description: Comprehensive project analysis including security audit
  Usage: woaru analyze [options]
  Purpose: Performs a full analysis of your project including code quality, 
          security vulnerabilities, production readiness, and tool recommendations. 
          Perfect for understanding the overall health of your codebase.

🔄 woaru review <subcommand>
  Description: Code review and analysis tools
  Usage: woaru review <git|local|path> [options]
  Purpose: Focused analysis tools for code reviews. Choose from git diff 
          analysis, uncommitted changes review, or specific file/directory analysis.
  Subcommands:
    • woaru review git
      Purpose: Analyzes changes between your current branch and a base branch...
    • woaru review local  
      Purpose: Reviews your uncommitted changes before you commit them...
    • woaru review path
      Purpose: Focused analysis of specific files or directories...

🎯 Perfect for Teams & Onboarding

📖 Complete Reference: Every command, option, and use case documented
🎓 Learning Tool: New team members can explore WOARU's capabilities
🔍 Quick Lookup: Find the right command for any situation
💡 Usage Examples: Real-world scenarios for each command

✅ Rock-Solid Stability & Reliability

🛡️ Watch Command - Now 100% Stable

The woaru watch command has been completely reengineered for bulletproof reliability:

# Now runs indefinitely without timeouts in ANY environment
woaru watch

✅ WOARU Supervisor started successfully!
📍 Project: /your/project/path
👁️ Starting continuous monitoring...
👁️  WOARU is watching your project - Press Ctrl+C to stop

⏱️  Watching... (5s elapsed, 14:32:15)
⏱️  Watching... (10s elapsed, 14:32:20)
📊 Status: 42 files monitored, Health: 85/100
👁️  WOARU is watching your project - Press Ctrl+C to stop

🔧 Technical Improvements

⚡ 1-Second Heartbeat: Aggressive keep-alive system prevents any timeouts
🔄 Smart Process Management: Automatically detects and adapts to environment constraints
🛡️ Bulletproof Architecture: Never loses connection or stops unexpectedly
🧪 Extensively Tested: Works reliably across terminals, IDEs, and remote connections

🌍 Universal Compatibility

✅ Native Terminals: macOS Terminal, Windows Terminal, Linux shells
✅ IDE Integration: VS Code, Claude Code, JetBrains IDEs
✅ Remote Sessions: SSH, Docker containers, CI/CD environments
✅ Cloud Environments: GitHub Codespaces, GitLab WebIDE, AWS Cloud9

🛠️ Evidence-Based Recommendations

Unlike other tools that guess, WOARU scans your actual code and provides evidence:

ESLint recommended because:
  → 12 console.log statements found in src/
  → 3 unused variables detected
  → Inconsistent formatting in 8 files
  
Prettier recommended because:  
  → Mixed quote styles detected
  → Inconsistent indentation found
  
Jest recommended because:
  → No test files found
  → React components without tests: 5

🚀 Perfect for AI Development

WOARU is specifically optimized for Claude Code and AI-assisted development:

Structured JSON output for AI consumption
Clear terminal feedback that AI can read and act on
Immediate context - AI knows exactly what tools are active
Real-time problem detection - AI gets instant feedback on code quality

⚠️ Important: Environment Requirements

WOARU works best in proper terminal environments:

✅ Recommended:

Native Terminal (macOS Terminal, Windows Terminal, Linux Terminal)
VS Code Integrated Terminal
Claude Code IDE Integration
SSH Terminals

❌ Not Recommended:

Claude Chat Web Interface (timeout restrictions)
Claude MCP Chat (timeout restrictions)
Browser-based terminals (limited process management)

Why? Long-running commands like woaru watch require persistent process management that browser environments can't provide reliably.

📦 Zero Configuration

WOARU works out of the box with intelligent defaults:

Auto-detects your langu

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

WOARU 🚀 v5.3.6

🆕 Latest Release: v5.3.6 - Enhanced AI Control Center

🎯 PATCH: Enhanced AI Control Center & UX Improvements

🔄 Previous Release: v5.2.0 - Enhanced i18n System & Build Optimization

📚 Previous Release: v5.1.4 - Major Technical Hardening & Modernization

🚀 MAJOR: Complete ES Modules Migration & Code Quality Overhaul

🌟 Previous Release: v5.1.2 - Complete i18n System Overhaul

🔒 MAJOR: Advanced Multi-Layer Security Analysis Engine

🌍 MAJOR: Complete Internationalization (i18n) Implementation

🔧 Technical Implementation

🏗️ Enhanced System Architecture

📊 User Experience Improvements

🌐 Supported Languages

🔄 Backward Compatibility

📚 Previous Release: v4.7.1 - AI Control Center Bug Fixes

🐛 PATCH: Critical AI Control Center Bug Fixes

🔧 Technical Implementation

🏗️ Enhanced System Architecture

📊 User Experience Improvements

📚 Previous Release: v4.7.0 - Multi-AI Review Control Center

🎯 MINOR: Multi-AI Review Control Center & Single-AI Mode

🔧 Technical Implementation

🏗️ Enhanced System Architecture

📊 User Experience Improvements

📚 Previous Release: v4.6.1 - AI Setup Dialog Bugfixes

🐛 PATCH: AI Setup Dialog Bugfixes & UX Improvements

🔧 Technical Implementation

🏗️ Enhanced System Architecture

📚 Previous Release: v4.6.0 - AI-First User Experience

🤖 MINOR: AI-First User Experience & Terminology Optimization

🔧 Technical Implementation

🏗️ Enhanced System Architecture

📚 Previous Release: v4.5.0 - Cross-Platform ASCII Art System

🚀 MINOR: Cross-Platform Pure JavaScript ASCII Art Generator

🔧 Technical Implementation

🏗️ Enhanced System Architecture

📚 Previous Release: v4.3.1 - ANSI Art Splash Screen Bugfix

🐛 PATCH: Critical ANSI Logo Display Fix

🎯 Technical Implementation

🔧 Files Modified

📚 Previous Release: v4.3.0 - Visual Identity & ANSI Art Splash Screen

🎨 MINOR: Visual Identity & ANSI Art Splash Screen

🔧 Technical Implementation

🎯 New Visual Identity Structure

📚 Previous Release: v4.2.0 - Robust Test & Quality Assurance Framework

🚀 MINOR: Robust Test & Quality Assurance Framework

🎯 New Test Framework Structure

🔄 Migration Guide

📚 Previous Release: v4.1.0 - Enhanced AI Models Database with Claude 4 & DeepSeek

Complete AI Models Database Implementation

📚 v4.0.0 - Revolutionary AI Models Database System

Initial database-driven LLM configuration implementation

📚 v3.9.0 - Revolutionary Review Commands Refactoring

🚀 MAJOR: Professional Version Management

🎯 Version Management in Action

🔍 Environment Validation

📚 Previous Release: v3.7.1 - Critical Bug-Fix Release

🐛 CRITICAL BUG FIXES: Production-Ready Stability

🎯 Production Impact

📚 Previous Release: v3.7.0 - Revolutionary AI-Optimized Documentation System

🧠 REVOLUTIONARY: Machine-Readable Documentation for AI/LLM Comprehension

🏗️ Technical Implementation

💡 Use Cases for AI Documentation

📚 Previous Release: v3.6.1 - REFACTOR: Comprehensive Hardcode Elimination & Central Configuration

🔧 MAJOR REFACTOR: Enterprise-Grade Configuration Management

🏗️ Technical Implementation Examples

🎯 Configuration Categories Centralized

📚 Previous Release: v3.6.0 - AI-Powered Code Documentation System

💡 Real-World Examples

🎯 Usage Examples

📚 Previous Release: v3.5.0 - Dynamic & Customizable AI Prompt Templates System

🏗️ MAJOR: Complete Prompt Management Architecture

🚀 User Experience Revolution

🔧 Technical Implementation