@archznn/xavva 3.1.2 → 3.2.0

package/README.md

@@ -2,15 +2,16 @@
 
 > Ultra-fast development toolkit for Java Enterprise (Tomcat) on Windows, Linux & macOS
 
-[![Version](https://img.shields.io/badge/version-3.1.2-blue.svg)](https://github.com/leorsousa05/Xavva)
+[![Version](https://img.shields.io/badge/version-3.2.0-blue.svg)](https://github.com/leorsousa05/Xavva)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
-Xavva is a high-performance CLI built with **Bun** that transforms the Java/Tomcat development experience. It brings modern development workflows (like Node.js/Vite) to the Java Enterprise ecosystem with hot-reload, smart logging, and automated deployment.
+Xavva is a high-performance CLI built with **Bun** that transforms the Java/Tomcat development experience. It brings modern development workflows (like Node.js/Vite) to the Java Enterprise ecosystem with hot-reload, smart logging, automated deployment, and a powerful plugin system.
 
 ---
 
 ## ✨ Features
 
+### Core
 - ⚡ **Hot Reload** — Incremental compilation and class injection without server restart
 - 📊 **Interactive Dashboard** — Real-time TUI with system metrics and shortcuts
 - 🧠 **Smart Log Analyzer** — Stack trace folding and root cause highlighting
@@ -18,19 +19,29 @@ Xavva is a high-performance CLI built with **Bun** that transforms the Java/Tomc
 - 📦 **Dependency Analysis** — Detect conflicts and outdated dependencies
 - 🎯 **Maven & Gradle** — Native support for both build tools
 - 🔧 **Auto-Healing** — Automatic diagnosis and repair of common issues
-- 🐱 **Embedded Tomcat** — Auto-install Tomcat, no manual setup needed
+- 🐱 **Embedded Tomcat** — Auto-install with mirror selection, checksum verification, download resume, and backup/rollback
 - 📦 **WAR Generation** — Build as .war file or exploded directory
+
+### Developer Experience
 - 🔤 **Encoding Converter** — Convert file encodings (UTF-8, Windows-1252, ISO-8859-1) and fix mojibake
 - 🧙 **Interactive Wizard** — `xavva init` for easy project setup
 - 🔔 **Desktop Notifications** — Get notified when builds/deploys complete
 - 📜 **Command History** — Track and replay commands with `xavva history` and `xavva redo`
 - 🏥 **Health Check** — Verify environment (Java, ports, memory, disk) with `xavva health`
+- 🔧 **Auto-Fix** — Automatically fix common issues with `xavva doctor --fix`
+- 🧹 **Clean Command** — Clean cache, build, and logs with `xavva clean`
 - 🔮 **Shell Completions** — Auto-complete for bash, zsh, and fish
+
+### Advanced
 - 🧪 **Test Runner** — Run JUnit/TestNG tests with watch mode and coverage
 - 🗄️ **Database Migrations** — Flyway/Liquibase integration
 - 🌐 **HTTP Client** — Test APIs without leaving the terminal
 - 🐳 **Docker Integration** — Generate configs, build and run containers
 - 🌍 **Multi-Environment** — Dev, test, staging configurations
+- 🔌 **Plugin System** — Extend functionality with custom plugins
+- 💻 **IDE Integration** — Generate configs for VS Code, IntelliJ, Eclipse
+- 📊 **Performance Profiler** — Detailed timing with `--profile`
+- 🛡️ **Security** — Input sanitization, path validation, checksum verification
 
 ---
 
@@ -61,6 +72,9 @@ xavva deploy
 # Build and deploy as .war file
 xavva deploy --war
 
+# Clean everything (cache, build, logs)
+xavva clean
+
 # Analyze dependencies for issues
 xavva deps
 
@@ -70,6 +84,9 @@ xavva deps --update-safe
 # Check for security vulnerabilities
 xavva audit
 
+# Diagnose and auto-fix environment issues
+xavva doctor --fix
+
 # Convert file encoding (UTF-8 → Windows-1252)
 xavva encoding convert --to cp1252 --backup src/main/java/
 
@@ -104,10 +121,21 @@ xavva docker init
 xavva docker build
 xavva docker up
 
+# Generate IDE configuration
+xavva ide --ide vscode
+xavva ide --ide idea
+xavva ide --ide eclipse
+
 # Multi-environment
 xavva deploy --env staging
 xavva dev --env dev
 
+# Profile performance
+xavva build --profile
+
+# Dry-run (simulate without executing)
+xavva deploy --dry-run
+
 # Enable shell completions (bash example)
 eval "$(xavva completion bash)"
 ```
@@ -124,6 +152,7 @@ eval "$(xavva completion bash)"
 | `xavva deploy` | Build and deploy application to Tomcat                 |
 | `xavva build`  | Compile project only                                   |
 | `xavva start`  | Start Tomcat server only                               |
+| `xavva clean`  | Clean cache, build directories, and logs               |
 
 ### Code Execution
 
@@ -191,6 +220,14 @@ eval "$(xavva completion bash)"
 | `xavva docker run` | Run development container |
 | `xavva docker status` | Show container status |
 
+### IDE Integration
+
+| Command | Description |
+|---------|-------------|
+| `xavva ide --ide vscode` | Generate VS Code configuration (.vscode/) |
+| `xavva ide --ide idea` | Generate IntelliJ IDEA configuration (.idea/) |
+| `xavva ide --ide eclipse` | Generate Eclipse configuration (.project) |
+
 ### Multi-Environment
 
 | Command | Description |
@@ -210,9 +247,34 @@ Configure environments in `xavva.json`:
 
 ---
 
+## 🧹 Clean Command
+
+The `xavva clean` command helps you clean up your project:
+
+```bash
+# Clean everything (cache, build, logs, tomcat work)
+xavva clean
+
+# Clean only cache
+xavva clean --cache
+
+# Clean only build directories (target/ build/)
+xavva clean --build
+
+# Clean only logs
+xavva clean --logs
+
+# Clean only Tomcat work directory
+xavva clean --tomcat
+```
+
+---
+
 ## 🐱 Embedded Tomcat
 
-Xavva can automatically download and manage a Tomcat installation for you:
+Xavva can automatically download and manage a Tomcat installation for you with advanced features like automatic mirror selection, checksum verification, download resuming, and backup/rollback:
+
+### Basic Usage
 
 ```bash
 # First time usage - auto-install Tomcat
@@ -240,6 +302,83 @@ xavva tomcat uninstall 9.0.115
 xavva dev --tomcat-version 9.0.115
 ```
 
+### Advanced Installation Features
+
+```bash
+# Install with automatic mirror selection (fastest mirror)
+xavva tomcat install 10.1.52 --mirror auto
+
+# Install with specific mirror
+xavva tomcat install 10.1.52 --mirror "Apache (UK)"
+
+# Install multiple versions in parallel
+xavva tomcat install 9.0.115 10.1.52 11.0.6 --parallel
+
+# Install without cache (force re-download)
+xavva tomcat install 10.1.52 --no-cache
+
+# Install without checksum verification
+xavva tomcat install 10.1.52 --no-checksum
+
+# Silent mode for CI/CD
+xavva tomcat install 10.1.52 --silent
+
+# Force reinstallation
+xavva tomcat install 10.1.52 --force
+
+# Configure timeout and retries
+xavva tomcat install 10.1.52 --timeout 600 --retries 5
+```
+
+### Mirror Management
+
+```bash
+# List all available mirrors
+xavva tomcat mirrors list
+
+# Test mirror speeds
+xavva tomcat mirrors test
+```
+
+### Backup and Restore
+
+```bash
+# List available backups
+xavva tomcat backup list
+
+# List backups for specific version
+xavva tomcat backup list 10.1.52
+
+# Restore from backup
+xavva tomcat backup restore 10.1.52
+```
+
+### Download Cache
+
+```bash
+# View cache statistics
+xavva tomcat cache stats
+
+# Clear download cache
+xavva tomcat cache clear
+```
+
+### Installation Features
+
+| Feature | Description |
+|---------|-------------|
+| **Mirror Selection** | Automatic selection of fastest mirror (US, BR, UK, CN, etc.) |
+| **Checksum Verification** | SHA512 verification for download integrity |
+| **Download Resume** | Resume interrupted downloads from where they stopped |
+| **Retry with Backoff** | Automatic retry with exponential backoff (1s, 2s, 4s) |
+| **Progress Display** | Real-time progress with MB/s, ETA, and percentage |
+| **Download Cache** | Persistent cache shared between projects |
+| **Backup on Update** | Automatic backup before updating existing installation |
+| **Rollback** | Automatic rollback if installation fails |
+| **Compatibility Check** | Validates Tomcat version against project requirements |
+| **Parallel Install** | Install multiple versions simultaneously |
+| **Silent Mode** | CI/CD friendly mode with no interactive output |
+
 ---
 
 ## 🔤 File Encoding
@@ -359,11 +498,19 @@ Create `xavva.json` in your project root:
     "appName": "my-application",
     "buildTool": "maven",
     "profile": "dev",
-    "tui": false
+    "tui": false,
+    "encoding": "utf-8",
+    "plugins": [
+      "@xavva/plugin-sass"
+    ]
   },
   "tomcat": {
     "path": "/home/user/apache-tomcat",
     "port": 8080
+  },
+  "environments": {
+    "dev": { "port": 8080, "profile": "dev" },
+    "staging": { "port": 8081, "profile": "staging" }
   }
 }
 ```
@@ -390,6 +537,8 @@ Create `xavva.json` in your project root:
 | `-y, --yes`            | Auto-install Tomcat (no prompt) |
 | `-V, --verbose`        | Detailed output                 |
 | `-i, --interactive`    | Interactive mode (for config)   |
+| `--profile`            | Show performance profile        |
+| `--dry-run`            | Simulate without executing      |
 
 ---
 
@@ -411,7 +560,7 @@ The wizard will guide you through:
 
 ---
 
-## 🏥 Health Check
+## 🏥 Health Check & Doctor
 
 Verify your development environment:
 
@@ -419,14 +568,22 @@ Verify your development environment:
 # Check all components
 xavva health
 
-# Checks include:
-# - Java version (JDK 11+ recommended)
-# - Maven/Gradle availability
-# - Tomcat configuration
-# - Port availability
-# - Memory and disk space
+# Diagnose and show issues
+xavva doctor
+
+# Auto-fix common issues
+xavva doctor --fix
 ```
 
+Checks include:
+- Java version (JDK 11+ recommended)
+- Maven/Gradle availability
+- Tomcat configuration
+- Port availability
+- Memory and disk space
+- JAR file integrity
+- File encoding (BOM detection)
+
 ---
 
 ## 📜 Command History
@@ -487,6 +644,54 @@ Xavva works on all major platforms:
 
 ---
 
+## 🔌 Plugin System
+
+Extend Xavva with custom plugins:
+
+```bash
+# Install a plugin
+xavva plugin install @xavva/plugin-sass
+
+# List installed plugins
+xavva plugin list
+```
+
+Create a plugin (example: `my-plugin.ts`):
+
+```typescript
+import type { XavvaPlugin } from "@archznn/xavva/plugins";
+
+export default {
+  name: "my-plugin",
+  version: "1.0.0",
+  description: "My custom plugin",
+  
+  hooks: {
+    beforeBuild: async (context) => {
+      console.log("Building...", context.config.project.appName);
+    },
+    afterBuild: async (context, success) => {
+      console.log("Build finished:", success ? "success" : "failed");
+    }
+  }
+} as XavvaPlugin;
+```
+
+Configure in `xavva.json`:
+
+```json
+{
+  "project": {
+    "plugins": [
+      "@xavva/plugin-sass",
+      "./scripts/my-plugin.ts"
+    ]
+  }
+}
+```
+
+---
+
 ## 🏗️ Architecture
 
 Xavva uses a modular service-oriented architecture:
@@ -494,9 +699,13 @@ Xavva uses a modular service-oriented architecture:
 - **DashboardService** — TUI management and interactivity
 - **LogAnalyzer** — Intelligent log processing
 - **DependencyAnalyzerService** — Dependency conflict detection
+- **DependencyCacheService** — Cache parsed dependencies
 - **ProjectService** — Project structure discovery
 - **BuildService** — Maven/Gradle integration
 - **TomcatService** — Server lifecycle management
+- **PluginManager** — Plugin loading and hook execution
+- **PerformanceProfiler** — Performance measurement
+- **ErrorHandler** — Contextual error messages
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@archznn/xavva",
-	"version": "3.1.2",
+	"version": "3.2.0",
 	"description": "Ultra-fast CLI tool for Java/Tomcat development with Hot-Reload and Zero Config. Supports Windows, Linux and macOS.",
 	"module": "src/index.ts",
 	"type": "module",
@@ -43,6 +43,7 @@
 	"dependencies": {
 		"@inquirer/prompts": "^8.3.2",
 		"glob": "^13.0.6",
-		"node-notifier": "^10.0.1"
+		"node-notifier": "^10.0.1",
+		"zod": "^4.3.6"
 	}
 }

package/src/commands/AuditCommand.ts

@@ -3,13 +3,15 @@ import fs from "fs";
 import type { Command } from "./Command";
 import type { AppConfig, CLIArguments } from "../types/config";
 import { AuditService, type JarAuditResult } from "../services/AuditService";
-import { Logger } from "../utils/ui";
+import { Logger } from "../logging";
 
 export class AuditCommand implements Command {
+    private logger = Logger.getInstance();
+
     constructor(private auditService: AuditService) {}
 
     async execute(config: AppConfig, args?: CLIArguments): Promise<void> {
-        Logger.section("Vulnerability & JAR Audit");
+        this.logger.section("Vulnerability & JAR Audit");
 
         let appName = args?.name || config.project.appName;
         
@@ -26,7 +28,7 @@ export class AuditCommand implements Command {
                 if (folders.length === 1) {
                     appName = folders[0].name;
                 } else if (folders.length > 1) {
-                    Logger.error("Vários apps encontrados no Tomcat:");
+                    this.logger.error("Vários apps encontrados no Tomcat:");
                     folders.forEach(f => console.log(`    ${"\x1b[90m"}➜${"\x1b[0m"} ${f.name}`));
                     console.log(`\n  Use ${"\x1b[33m"}xavva audit -n <nome>${"\x1b[0m"} para especificar.`);
                     return;
@@ -35,8 +37,8 @@ export class AuditCommand implements Command {
         }
 
         if (!appName) {
-            Logger.error("Não foi possível identificar o app automaticamente.");
-            Logger.warn("Certifique-se de que o projeto foi buildado ou use -n <nome>.");
+            this.logger.error("Não foi possível identificar o app automaticamente.");
+            this.logger.warn("Certifique-se de que o projeto foi buildado ou use -n <nome>.");
             return;
         }
 
@@ -45,11 +47,11 @@ export class AuditCommand implements Command {
             const vulnerable = results.filter(r => r.vulnerabilities.length > 0);
 
             if (vulnerable.length === 0) {
-                Logger.success(`Nenhuma vulnerabilidade conhecida encontrada em ${results.length} JARs.`);
+                this.logger.success(`Nenhuma vulnerabilidade conhecida encontrada em ${results.length} JARs.`);
                 return;
             }
 
-            Logger.warn(`Encontradas vulnerabilidades em ${vulnerable.length} de ${results.length} dependências.`);
+            this.logger.warn(`Encontradas vulnerabilidades em ${vulnerable.length} de ${results.length} dependências.`);
             console.log("");
 
             for (const res of vulnerable) {
@@ -57,12 +59,12 @@ export class AuditCommand implements Command {
             }
 
             const totalVulns = vulnerable.reduce((acc, r) => acc + r.vulnerabilities.length, 0);
-            Logger.info("Total de Falhas", totalVulns);
-            Logger.info("Relatório gerado via", "OSV.dev (Open Source Vulnerability Database)");
+            this.logger.config("Total de Falhas", totalVulns);
+            this.logger.config("Relatório gerado via", "OSV.dev (Open Source Vulnerability Database)");
 
         } catch (e) {
             const message = e instanceof Error ? e.message : String(e);
-            Logger.error(message);
+            this.logger.error(message);
         }
     }
 

package/src/commands/BuildCommand.ts

@@ -1,24 +1,26 @@
 import type { Command } from "./Command";
 import type { AppConfig } from "../types/config";
 import { BuildService } from "../services/BuildService";
-import { Logger } from "../utils/ui";
+import { Logger } from "../logging";
 import { ProcessManager } from "../utils/processManager";
 
 export class BuildCommand implements Command {
+    private logger = Logger.getInstance();
+
     constructor(private buildService: BuildService) {}
 
     async execute(config: AppConfig): Promise<void> {
-        Logger.section("Build Only");
-        Logger.info("Tool", config.project.buildTool.toUpperCase());
-        if (config.project.profile) Logger.info("Profile", config.project.profile);
+        this.logger.section("Build Only");
+        this.logger.config("Tool", config.project.buildTool.toUpperCase());
+        if (config.project.profile) this.logger.config("Profile", config.project.profile);
         
         try {
             await this.buildService.runBuild();
-            Logger.success("Build completed successfully!");
+            this.logger.success("Build completed successfully!");
         } catch (error) {
             const message = error instanceof Error ? error.message : String(error);
-            Logger.error(message);
+            this.logger.error(message);
             await ProcessManager.getInstance().shutdown(1);
         }
     }
-}
+}

package/src/commands/ChangelogCommand.ts

@@ -1,7 +1,7 @@
 import type { Command } from "./Command";
 import type { AppConfig, CLIArguments } from "../types/config";
 import { ChangelogGenerator } from "../utils/ChangelogGenerator";
-import { Logger } from "../utils/ui";
+import { Logger, C } from "../utils/ui";
 import { existsSync } from "fs";
 
 export class ChangelogCommand implements Command {
@@ -117,12 +117,12 @@ export class ChangelogCommand implements Command {
         Logger.info("Usage: xavva changelog <action> [options]");
         Logger.newline();
         Logger.log("Actions:");
-        Logger.log(`  ${Logger.C.primary}generate${Logger.C.reset}  Generate CHANGELOG.md (default)`);
-        Logger.log(`  ${Logger.C.primary}check${Logger.C.reset}     Validate conventional commits`);
-        Logger.log(`  ${Logger.C.primary}preview${Logger.C.reset}   Preview changelog without saving`);
+        Logger.log(`  ${C.primary}generate${C.reset}  Generate CHANGELOG.md (default)`);
+        Logger.log(`  ${C.primary}check${C.reset}     Validate conventional commits`);
+        Logger.log(`  ${C.primary}preview${C.reset}   Preview changelog without saving`);
         Logger.newline();
         Logger.log("Options:");
-        Logger.log(`  ${Logger.C.primary}-o, --output${Logger.C.reset}  Output file (default: CHANGELOG.md)`);
+        Logger.log(`  ${C.primary}-o, --output${C.reset}  Output file (default: CHANGELOG.md)`);
         Logger.done();
     }
 }