@archznn/xavva 2.0.0 → 2.0.1

package/README.md

@@ -1,4 +1,4 @@
-# XAVVA 🚀 (Windows Only) `v2.0.0`
+# XAVVA 🚀 (Windows Only) `v2.0.1`
 
 Xavva é uma CLI de alto desempenho construída com **Bun** para automatizar o ciclo de desenvolvimento de aplicações Java (Maven/Gradle) rodando no Apache Tomcat. Ela foi desenhada especificamente para desenvolvedores que buscam a velocidade de ambientes modernos (como Node.js/Vite) dentro do ecossistema Java Enterprise.
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@archznn/xavva",
-	"version": "2.0.0",
+	"version": "2.0.1",
 	"description": "Ultra-fast CLI tool for Java/Tomcat development on Windows with Hot-Reload and Zero Config.",
 	"module": "src/index.ts",
 	"type": "module",

package/src/commands/HelpCommand.ts

@@ -1,50 +1,48 @@
 import type { Command } from "./Command";
-import type { AppConfig } from "../types/config";
+import type { AppConfig, CLIArguments } from "../types/config";
 import pkg from "../../package.json";
 
 export class HelpCommand implements Command {
-    async execute(_config: AppConfig): Promise<void> {
+    async execute(_config: AppConfig, _args?: CLIArguments): Promise<void> {
         console.log(`
-🛠️  Xavva CLI v${pkg.version}
--------------------------------
-A Xavva automatiza o ciclo de vida de aplicações Java (Tomcat).
-Se nenhum comando for fornecido, 'deploy' será executado por padrão.
+🛠️  XAVVA CLI v${pkg.version} 🚀
+---------------------------------------
+Automatização de alta performance para Java Enterprise (Tomcat) no Windows.
+Detecta automaticamente Maven/Gradle e otimiza o ciclo de desenvolvimento.
 
 Comandos principais:
-  dev           🚀 MODO COMPLETO: Deploy + Watch + Debug + Clean.
-  deploy        (Padrão) Builda o projeto, move para webapps e inicia o Tomcat.
-  start         Apenas inicia o servidor (útil quando o .war já foi gerado).
-  build         Executa apenas a compilação (mvn package ou gradle build).
-  doctor        🩺 Verifica o ambiente (Java, Tomcat, Maven, etc).
-  docs          📖 Swagger-like: Exibe endpoints e URLs de JSPs.
-  audit         🛡️ JAR Audit: Busca vulnerabilidades (CVEs) nas dependências.
-  run           🚀 Executa uma classe main (Uso: xavva run NomeDaClasse).
-  debug         🐞 Debuga uma classe main (Uso: xavva debug NomeDaClasse).
-  logs          📋 Monitora o catalina.out do Tomcat em tempo real.
+  dev           🚀 MODO COMPLETO: Build + Deploy + Watch + Debug.
+  deploy        (Padrão) Compila, sincroniza e inicia o servidor.
+  logs          📋 Tail inteligente (catalina.out) com Smart Folding.
+  run / debug   🚀 Executa classes standalone com Pathing JAR (Windows).
+  doctor        🩺 Diagnóstico e reparo de ambiente (DCEVM, JAVA_HOME).
+  audit         🛡️ Auditoria de segurança em JARs via OSV.dev.
+  docs          📖 Mapeamento estático de Endpoints e JSPs.
+  build / start Comandos granulares de compilação ou startup.
 
-Opções:
-  -w, --watch   👀 Hot Reload: monitora arquivos e redeploya automaticamente.
-  -d, --debug   🐞 Habilita debug Java (JPDA).
-  --dp [porta]  🔌 Porta do Debugger (padrão: 5005).
-  -c, --clean   🧹 Logs coloridos e simplificados (recomendado).
-  -q, --quiet   🤫 Mostra apenas mensagens essenciais nos logs.
-  -V, --verbose 📣 Mostra logs completos do Maven/Gradle.
-  -s, --no-build Pula o build (usa o que já estiver na pasta target/build).
-  -P, --profile Define o profile (ex: -P prod).
-  --fix         🔧 Corrige problemas automaticamente no 'doctor'.
+Opções de Interface:
+  --tui         🖥️  Ativa o Dashboard Interativo (Interface TUI).
+                No modo TUI use: [R] Restart, [L] Clear, [Q] Quit.
+  -w, --watch   👀 Hot Reload: Redeploy incremental de classes e recursos.
+  -c, --clean   🧹 Logs coloridos e simplificados (Recomendado).
+  -V, --verbose 📣 Exibe logs completos do Maven/Gradle.
 
-Exemplos de uso:
-  xavva dev           A melhor experiência de dev local.
-  xavva -w -c         Inicia com auto-reload e logs limpos.
-  xavva deploy -d     Builda e inicia com debugger habilitado.
-  xavva start -c      Apenas sobe o servidor com logs limpos.
-  xavva build -P dev  Apenas compila usando o profile 'dev'.
+Opções de Runtime:
+  -d, --debug   🐞 Habilita JPDA Debugging (Porta 5005).
+  -P, --profile Define o profile de build (ex: -P prod).
+  -s, --no-build Pula o build inicial.
+  --fix         🔧 Corrige problemas automaticamente (Doctor).
 
-Opções de Configuração:
-  -p, --path    Caminho do Tomcat (padrão via config.ts)
-  -t, --tool    Ferramenta (maven/gradle)
-  -n, --name    Nome do .war (ex: -n ROOT)
-  --port        Porta HTTP (padrão: 8080)
+Configuração:
+  O Xavva prioriza o arquivo 'xavva.json' na raiz do projeto.
+  Flags de linha de comando: -p (Tomcat Path), -t (Build Tool), -n (WAR Name).
+
+Exemplos:
+  xavva dev --tui      Experiência completa com Dashboard.
+  xavva run MyClass    Execução standalone com classpath automático.
+  xavva audit          Verifica vulnerabilidades conhecidas.
+
+*Transformando o legado em produtivo.*
         `);
     }
 }

package/src/index.ts

@@ -55,6 +55,7 @@ async function main() {
 	// Xavva 2.0: Dashboard & LogAnalyzer
 	const logAnalyzer = new LogAnalyzer(config.project);
 	const dashboard = new DashboardService(config);
+	Logger.setDashboard(dashboard);
 
 	// 2. Registrar Comandos
 	const registry = new CommandRegistry();
@@ -75,6 +76,14 @@ async function main() {
 
 	// Caso especial: Watch Mode para Deploy/Dev
 	if ((commandName === "deploy" || commandName === "dev") && values.watch) {
+		// Registrar ação de restart manual na TUI
+		if (dashboard.isTuiActive()) {
+			dashboard.onAction("r", () => {
+				dashboard.log(Logger.C.yellow + "Restart manual solicitado via TUI...");
+				deployCmd.execute(config, false, true); // Executa deploy completo mas mantém o watch
+			});
+		}
+
 		const watcher = new WatcherService(config, deployCmd);
 		await watcher.start();
 	} else {

package/src/services/DashboardService.ts

@@ -8,17 +8,29 @@ export class DashboardService {
     private maxLogLines: number = 0;
     private status: string = "IDLE";
     private statusColor: string = Logger.C.dim;
+    private gitContext: any = null;
+    private actions: Map<string, () => void> = new Map();
 
     constructor(private config: AppConfig) {
         this.isTui = config.project.tui;
         if (this.isTui) {
-            this.maxLogLines = process.stdout.rows - 10;
+            this.gitContext = Logger.getGitContext();
+            this.maxLogLines = process.stdout.rows - 6;
             this.setupTui();
         }
     }
 
+    public isTuiActive(): boolean {
+        return this.isTui;
+    }
+
+    public onAction(key: string, callback: () => void) {
+        this.actions.set(key.toLowerCase(), callback);
+    }
+
     private setupTui() {
         process.stdout.write("\x1B[?1049h"); // Switch to alternate buffer
+        process.stdout.write("\x1B[2J"); // Clear screen
         process.stdout.write("\x1B[?25l"); // Hide cursor
         
         process.stdin.setRawMode(true);
@@ -26,14 +38,19 @@ export class DashboardService {
         process.stdin.setEncoding("utf8");
 
         process.stdin.on("data", (key: string) => {
+            const input = key.toLowerCase();
             // Ctrl+C ou Q para sair
-            if (key === "\u0003" || key.toLowerCase() === "q") {
+            if (key === "\u0003" || input === "q") {
                 this.exit();
             }
-            if (key.toLowerCase() === "l") {
+            if (input === "l") {
                 this.logLines = [];
                 this.render();
+                return;
             }
+            
+            const action = this.actions.get(input);
+            if (action) action();
         });
 
         process.on("SIGINT", () => this.exit());
@@ -43,14 +60,6 @@ export class DashboardService {
         setInterval(() => this.render(), 1000);
     }
 
-    public onKey(key: string, callback: () => void) {
-        process.stdin.on("data", (input: string) => {
-            if (input.toLowerCase() === key.toLowerCase()) {
-                callback();
-            }
-        });
-    }
-
     public setStatus(status: string, color: string = Logger.C.cyan) {
         this.status = status;
         this.statusColor = color;
@@ -75,32 +84,29 @@ export class DashboardService {
     private render() {
         if (!this.isTui) return;
 
-        this.maxLogLines = process.stdout.rows - 8;
+        this.maxLogLines = process.stdout.rows - 6;
         
         let output = "\x1B[H"; // Move to 0,0
         
         // Header
         const name = (process.cwd().split(/[/\\]/).pop() || "PROJECT").toUpperCase();
-        const git = Logger.getGitContext();
         const mem = Math.round((os.totalmem() - os.freemem()) / 1024 / 1024 / 1024 * 10) / 10;
         const totalMem = Math.round(os.totalmem() / 1024 / 1024 / 1024);
 
-        output += `${Logger.C.bold}${Logger.C.cyan} X A V V A  2.0 ${Logger.C.reset} ${Logger.C.dim}│${Logger.C.reset} ${Logger.C.white}${Logger.C.bold}${name}${Logger.C.reset}\n`;
-        output += `${Logger.C.dim} STATUS: ${this.statusColor}${this.status.padEnd(10)}${Logger.C.reset} ${Logger.C.dim}│ MEM: ${Logger.C.yellow}${mem}G/${totalMem}G${Logger.C.reset} ${Logger.C.dim}│ BRANCH: ${Logger.C.magenta}${git.branch || "unknown"}${Logger.C.reset}\n`;
-        output += `${Logger.C.dim}──────────────────────────────────────────────────────────────────────────${Logger.C.reset}\n`;
+        output += `${Logger.C.bold}${Logger.C.cyan} X A V V A  2.0 ${Logger.C.reset} ${Logger.C.dim}│${Logger.C.reset} ${Logger.C.white}${Logger.C.bold}${name}${Logger.C.reset}\x1B[K\n`;
+        output += `${Logger.C.dim} STATUS: ${this.statusColor}${this.status.padEnd(10)}${Logger.C.reset} ${Logger.C.dim}│ MEM: ${Logger.C.yellow}${mem}G/${totalMem}G${Logger.C.reset} ${Logger.C.dim}│ BRANCH: ${Logger.C.magenta}${this.gitContext?.branch || "unknown"}${Logger.C.reset}\x1B[K\n`;
+        output += `${Logger.C.dim}──────────────────────────────────────────────────────────────────────────${Logger.C.reset}\x1B[K\n`;
 
         // Logs
         const visibleLogs = this.logLines.slice(-this.maxLogLines);
         for (let i = 0; i < this.maxLogLines; i++) {
             const line = visibleLogs[i] || "";
-            // Limpa a linha antes de escrever (ANSI escape EL)
             output += line.substring(0, process.stdout.columns) + "\x1B[K\n";
         }
 
         // Footer
-        output += `\x1B[${process.stdout.rows - 1};1H`; // Move to last rows
-        output += `${Logger.C.dim}──────────────────────────────────────────────────────────────────────────${Logger.C.reset}\n`;
-        output += ` ${Logger.C.bold}${Logger.C.white}R${Logger.C.reset} Restart  ${Logger.C.bold}${Logger.C.white}L${Logger.C.reset} Clear  ${Logger.C.bold}${Logger.C.white}Q${Logger.C.reset} Quit    ${Logger.C.dim} (Xavva 2.0 TUI Mode)${Logger.C.reset}`;
+        output += `\x1B[${process.stdout.rows};1H`; // Move to last row
+        output += ` ${Logger.C.bold}${Logger.C.white}R${Logger.C.reset} Restart  ${Logger.C.bold}${Logger.C.white}L${Logger.C.reset} Clear  ${Logger.C.bold}${Logger.C.white}Q${Logger.C.reset} Quit    ${Logger.C.dim} (Xavva 2.0 TUI Mode)${Logger.C.reset}\x1B[K`;
 
         process.stdout.write(output);
     }

package/src/utils/ui.ts

@@ -22,8 +22,18 @@ export class Logger {
     private static lastDomain = "";
     private static lastHotswapMsg = "";
     private static activeSpinnerMsg = "";
+    private static dashboard: any = null;
+
+    static setDashboard(dashboard: any) {
+        this.dashboard = dashboard;
+    }
 
     private static write(message: string, isError: boolean = false) {
+        if (this.dashboard && this.dashboard.isTuiActive()) {
+            this.dashboard.log(message);
+            return;
+        }
+
         if (this.activeSpinnerMsg) {
             process.stdout.write("\r\x1B[K"); // Limpa a linha do spinner
         }
@@ -126,6 +136,17 @@ export class Logger {
     static dim(msg: string) { this.write(`  ${this.C.dim}${msg}${this.C.reset}`); }
 
     static spinner(msg: string) {
+        if (this.dashboard && this.dashboard.isTuiActive()) {
+            this.dashboard.log(`${this.C.cyan}⠋${this.C.reset} ${msg}...`);
+            return (success = true) => {
+                if (success) {
+                    this.dashboard.log(`${this.C.green}✔${this.C.reset} ${msg}`);
+                } else {
+                    this.dashboard.log(`${this.C.red}✖${this.C.reset} Falha em ${msg}`);
+                }
+            };
+        }
+
         this.activeSpinnerMsg = msg;
         const frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
         let i = 0;