doctor-beez 1.0.0

package/README.md

@@ -0,0 +1,94 @@
+# 🐝 DOCTOR BEEZ CLI v1.0
+> **El Enjambre de Curación Autónoma de Código**  
+> *Powered by BEEZ DIGITAL*
+
+---
+
+## 📌 ¿Qué es Doctor Beez?
+
+**DOCTOR BEEZ** es un CLI de auditoría y curación automática en 5 niveles para aplicaciones React / TypeScript. Despliega un "enjambre" de motores de análisis estático y pruebas para detectar y corregir problemas de código en lotes pequeños con commits atómicos de Git.
+
+```
+                 .@@%                                                           
+                 #::::*@*@@@@@@@@%                                              
+                                 @                                              
+           .                     @                                              
+         -:::::@==++*#%@#       =@                        +*@   =               
+                         @      @- :%@.                @          =             
+                          @@    @%%%%%%%@*           #     @ .@.   @   %        
+                           @%::@%%%%%%%+-%%        -@     @       @     ..      
+        .%:.=           %%@:..%%%%%%%%% %%:+     =  = .@#       %   %#          
+       @    :+-       .%%%...@%%%%%%%% %%%:@   @    @ #   :#@@#      @          
+       .  *    .    ::#%%%..-%%%%%%%% %%:::@ -    @@#   +@#*%  %      %  @      
+       .  *.#  @@.  # @%%*.:@%%%%%%%%%%:*@:@%%%%%@*+++++*%=+@  -@      .        
+       .@. %-. @      %%%+..%%%%%%%%%%.%#:@%%%%%%%@@   @++#   +  @   #          
+         %     @%..    %%:..*%%%%%*- =*::@%%%%%%%%%%@ .@+@*-.@    @             
+           .#+%-#      @:.....:::.@  %::@%%%%%%%%@-    #.*++++++%               
+           @.*+@  :@.  -..........::::@%%%%%%%%%%-      @@@*+#@@@+              
+           *#@+++@:@@****:...:%@@@@%%%%%%%%%%%%%%%-    #@*+#*#@+*@              
+           :.**+++++++++++*@@%%%%%%%%%%%%%%%%%%%%%@@.%    . %+*=                
+            . .%.     . %++@%%%%%%%%%%%%%%%%%%%%%%@      @%+*#                  
+              @..     -*+*@+@%@%%%%%%%%%%%%%%%%%%%%.    .**@                    
+                    =@+*@@@  *@@%%%%%%%%%%%%%%%%%%%%%-@  @                      
+                  .@+*++++*@.  @@@%%%%%%%%%%%%%%%%%@%.  .                       
+                  @**@+  *++@..   @:@%%%%%%%%%%%%%%@   ..                       
+                        @+*@%* .   #@%%%@@%@%%%%%% :@                           
+                       *+++*#@ @%@@:....:.@%%@###%%#-                           
+                       @@        @:..........-#*#@@@#                           
+                                @%@@@:......... @@@@.                           
+                               .@%%%%%%%%:.......@@@*                           
+                               @%%%%%%%%%%%:.....:@@                            
+                              :.....@%%%%%%%@:::::@                             
+                            =:........*#%%%%@+:::+                              
+                           @%@@@*.......%%@@@@:%                                
+                         @@%%%%%%%@:...::@@@@@                                  
+                        @@%%%%%%%@:::::@@@                                    
+                      @.   .@@@@@@@@-:::@                                       
+                 .@  ..@@  @@@@@@@@@@                                           
+             +#@%                                                               
+
+
+  ██████╗  ██████╗  ██████╗████████╗██████╗ ██████╗     ██████╗ ███████╗███████╗███████╗
+  ██╔══██╗██╔═══██╗██╔════╝╚══██╔══╝██╔══██╗██╔══██╗    ██╔══██╗██╔════╝██╔════╝╚══███╔╝
+  ██║  ██║██║   ██║██║        ██║   ██║  ██║██████╔╝    ██████╔╝█████╗  █████╗    ███╔╝ 
+  ██║  ██║██║   ██║██║        ██║   ██║  ██║██╔══██╗    ██╔══██╗██╔══╝  ██╔══╝   ███╔╝  
+  ██████╔╝╚██████╔╝╚██████╗   ██║   ╚██████╔╝██║  ██║    ██████╔╝███████╗███████╗███████╗
+  ╚═════╝  ╚═════╝  ╚═════╝   ╚═╝    ╚═════╝ ╚═╝  ╚═╝    ╚═════╝ ╚══════╝╚══════╝╚══════╝
+
+ ========================================================================================
+ [ 🐝 KILLA SWARM CODE HEALING PROTOCOL · DOCTOR BEEZ v1.0 · POWERED BY BEEZ DIGITAL 🐝 ]
+ ========================================================================================
+```
+
+---
+
+## 📊 Los 5 Niveles de Auditoría
+
+1. **TypeScript (`tsc --noEmit`):** Verificación estricta de compilación y tipado.
+2. **Suite de Pruebas (`vitest` / `jest` / `react-scripts`):** Ejecución no interactiva con `CI=true`.
+3. **Knip (`knip`):** Detección de código muerto, archivos huérfanos y dependencias no utilizadas.
+4. **Semgrep (`semgrep`):** Escaneo de reglas de seguridad y buenas prácticas.
+5. **DPDM (`dpdm`):** Mapeo y prevención de grafos de dependencias circulares.
+
+---
+
+## 🚀 Instalación y Uso
+
+### 1. En este repositorio:
+```bash
+npm install
+npm run doctor-beez
+```
+
+### 2. Uso Global en tu sistema:
+```bash
+npm link
+# Ahora puedes ejecutar en cualquier carpeta:
+doctor-beez
+```
+
+---
+
+## 📄 Licencia
+
+MIT © **BEEZ DIGITAL**

package/bin/doctor-beez.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { spawn } from 'child_process';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const rootDir = path.resolve(__dirname, '..');
+
+const tsxBin = path.join(rootDir, 'node_modules', '.bin', 'tsx');
+const indexPath = path.join(rootDir, 'src', 'index.ts');
+
+const child = spawn(tsxBin, [indexPath], {
+  cwd: rootDir,
+  stdio: 'inherit',
+  env: process.env,
+});
+
+child.on('exit', (code) => {
+  process.exit(code || 0);
+});

package/dist/auth/github.js

@@ -0,0 +1,32 @@
+import { execa } from 'execa';
+import * as p from '@clack/prompts';
+export async function checkGitHubAuth() {
+    const spinner = p.spinner();
+    spinner.start('🔑 Verificando credenciales de GitHub (gh CLI)...');
+    try {
+        const { stdout } = await execa('gh', ['auth', 'status']);
+        spinner.stop('🟢 Autenticación de GitHub verificada.');
+        return true;
+    }
+    catch (error) {
+        spinner.stop('🔴 No estás autenticado en GitHub CLI (gh).');
+        const shouldLogin = await p.confirm({
+            message: '¿Deseas iniciar sesión en GitHub ahora usando `gh auth login`?',
+            initialValue: true,
+        });
+        if (p.isCancel(shouldLogin) || !shouldLogin) {
+            p.log.warn('Continuando sin autenticación de GitHub...');
+            return false;
+        }
+        p.log.info('Iniciando proceso de login de GitHub...');
+        try {
+            await execa('gh', ['auth', 'login'], { stdio: 'inherit' });
+            p.log.success('¡Autenticación completada con éxito!');
+            return true;
+        }
+        catch (err) {
+            p.log.error('No se pudo completar la autenticación en GitHub.');
+            return false;
+        }
+    }
+}

package/dist/healer/swarm.js

@@ -0,0 +1,26 @@
+import * as p from '@clack/prompts';
+import chalk from 'chalk';
+import { runDiagnosticScan } from '../scanner/doctor.js';
+export async function startSwarmHealingLoop() {
+    p.log.info(chalk.bold.yellow('🐝 ENJAMBRE DESPLEGADO: Iniciando bucle de curación autónoma...'));
+    p.note(`1. Copia las reglas de curación en tu agente (OpenCode / Aider / Antigravity).
+2. El agente procesará lotes de 3 a 5 errores como máximo.
+3. Se verificará compilación tsc y tests tras cada iteración.
+4. Cada lote limpio generará un commit atómico en Git.`, '📋 Instrucciones para el Agente Curador');
+    const confirmStart = await p.confirm({
+        message: '¿Iniciar primera iteración del enjambre de curación ahora?',
+        initialValue: true,
+    });
+    if (p.isCancel(confirmStart) || !confirmStart) {
+        p.log.warn('Bucle de curación en pausa. Puedes ejecutarlo cuando quieras.');
+        return;
+    }
+    p.log.success('🐝 ¡Enjambre trabajando! Re-auditando después del primer lote...');
+    const newResults = await runDiagnosticScan();
+    if (!newResults.hasErrors) {
+        p.outro(chalk.bold.green('🎉 ¡EL PANAL ESTÁ 100% LIMPIO Y SANO! 🐝✨'));
+    }
+    else {
+        p.log.info('Aún quedan observaciones por pulir. Continúa con el siguiente lote.');
+    }
+}

package/dist/index.js

@@ -0,0 +1,48 @@
+import * as p from '@clack/prompts';
+import chalk from 'chalk';
+import { renderBanner } from './ui/banner.js';
+import { checkGitHubAuth } from './auth/github.js';
+import { runDiagnosticScan } from './scanner/doctor.js';
+import { renderDashboard } from './ui/dashboard.js';
+import { startSwarmHealingLoop } from './healer/swarm.js';
+async function main() {
+    // 1. Mostrar Banner Killa Beez
+    renderBanner();
+    p.intro(chalk.bold.yellow('🐝 DOCTOR BEEZ CLI — SISTEMA AUTÓNOMO DE AUDITORÍA Y CURACIÓN'));
+    // 2. Verificar Autenticación GitHub
+    await checkGitHubAuth();
+    // 3. Escaneo Silencioso
+    const results = await runDiagnosticScan();
+    // 4. Renderizar "La Media Cagadita"
+    renderDashboard(results);
+    // 5. Pregunta Interactiva al Usuario
+    if (!results.hasErrors) {
+        p.outro(chalk.bold.green('✨ ¡Tu proyecto está impecable! No hay errores críticos detectados.'));
+        return;
+    }
+    const action = await p.select({
+        message: '¿Qué deseas hacer con las observaciones encontradas?',
+        options: [
+            {
+                value: 'heal',
+                label: '🚀 ¡DALE COLOR! (Desplegar Enjambre de Curación)',
+                hint: 'Inicia el bucle de reparación autónomo',
+            },
+            {
+                value: 'exit',
+                label: '❌ No hermano, me dio miedo (Cancelar por ahora)',
+                hint: 'Mantiene los reportes sin hacer cambios',
+            },
+        ],
+    });
+    if (p.isCancel(action) || action === 'exit') {
+        p.outro(chalk.yellow('🐝 Operación cancelada. El enjambre se mantiene en espera.'));
+        process.exit(0);
+    }
+    // 6. Desplegar Enjambre
+    await startSwarmHealingLoop();
+}
+main().catch((err) => {
+    console.error(chalk.red('Error inesperado en DOCTOR BEEZ:'), err);
+    process.exit(1);
+});

package/dist/scanner/doctor.js

@@ -0,0 +1,80 @@
+import { execa } from 'execa';
+import * as p from '@clack/prompts';
+import fs from 'fs';
+export async function runDiagnosticScan() {
+    const spinner = p.spinner();
+    spinner.start('🐝 Desplegando abejas exploradoras para la auditoría de código...');
+    try {
+        // Run doctor.sh
+        await execa('bash', ['doctor.sh']);
+        spinner.stop('🐝 Auditoría inicial completada. Analizando reportes...');
+    }
+    catch (error) {
+        spinner.stop('🐝 Auditoría finalizada con observaciones.');
+    }
+    // Parse report-1-types.log
+    let typeErrorsCount = 0;
+    if (fs.existsSync('report-1-types.log')) {
+        const content = fs.readFileSync('report-1-types.log', 'utf-8');
+        const matches = content.match(/error TS\d+/g);
+        if (matches) {
+            typeErrorsCount = matches.length;
+        }
+    }
+    // Parse report-2-tests.log
+    let testFailuresCount = 0;
+    if (fs.existsSync('report-2-tests.log')) {
+        const content = fs.readFileSync('report-2-tests.log', 'utf-8');
+        if (content.includes('FAIL') || content.includes('FAILED')) {
+            const matches = content.match(/FAIL/g);
+            testFailuresCount = matches ? matches.length : 1;
+        }
+    }
+    // Parse report-3-knip.json
+    let knipIssuesCount = 0;
+    if (fs.existsSync('report-3-knip.json')) {
+        try {
+            const raw = fs.readFileSync('report-3-knip.json', 'utf-8');
+            const data = JSON.parse(raw);
+            if (data && typeof data === 'object') {
+                const unused = data.unused || {};
+                knipIssuesCount = Object.keys(unused).reduce((acc, key) => acc + (Array.isArray(unused[key]) ? unused[key].length : 1), 0);
+            }
+        }
+        catch (e) {
+            knipIssuesCount = 0;
+        }
+    }
+    // Parse report-4-semgrep.json
+    let semgrepIssuesCount = 0;
+    if (fs.existsSync('report-4-semgrep.json')) {
+        try {
+            const raw = fs.readFileSync('report-4-semgrep.json', 'utf-8');
+            const data = JSON.parse(raw);
+            if (data && data.results && Array.isArray(data.results)) {
+                semgrepIssuesCount = data.results.length;
+            }
+        }
+        catch (e) {
+            semgrepIssuesCount = 0;
+        }
+    }
+    // Parse report-5-dpdm.log
+    let circularDepsCount = 0;
+    if (fs.existsSync('report-5-dpdm.log')) {
+        const content = fs.readFileSync('report-5-dpdm.log', 'utf-8');
+        const matches = content.match(/Circular/gi);
+        if (matches) {
+            circularDepsCount = matches.length;
+        }
+    }
+    const hasErrors = typeErrorsCount > 0 || testFailuresCount > 0 || knipIssuesCount > 0 || semgrepIssuesCount > 0 || circularDepsCount > 0;
+    return {
+        typeErrorsCount,
+        testFailuresCount,
+        knipIssuesCount,
+        semgrepIssuesCount,
+        circularDepsCount,
+        hasErrors,
+    };
+}

package/dist/ui/banner.js

@@ -0,0 +1,58 @@
+import chalk from 'chalk';
+import gradient from 'gradient-string';
+const killaGradient = gradient(['#FFE600', '#FFB300', '#FF8C00']);
+export const ASCII_BEE = `
+                 .@@%                                                           
+                 #::::*@*@@@@@@@@%                                              
+                                 @                                              
+           .                     @                                              
+         -:::::@==++*#%@#       =@                        +*@   =               
+                         @      @- :%@.                @          =             
+                          @@    @%%%%%%%@*           #     @ .@.   @   %        
+                           @%::@%%%%%%%+-%%        -@     @       @     ..      
+        .%:.=           %%@:..%%%%%%%%% %%:+     =  = .@#       %   %#          
+       @    :+-       .%%%...@%%%%%%%% %%%:@   @    @ #   :#@@#      @          
+       .  *    .    ::#%%%..-%%%%%%%% %%:::@ -    @@#   +@#*%  %      %  @      
+       .  *.#  @@.  # @%%*.:@%%%%%%%%%%:*@:@%%%%%@*+++++*%=+@  -@      .        
+       .@. %-. @      %%%+..%%%%%%%%%%.%#:@%%%%%%%@@   @++#   +  @   #          
+         %     @%..    %%:..*%%%%%*- =*::@%%%%%%%%%%@ .@+@*-.@    @             
+           .#+%-#      @:.....:::.@  %::@%%%%%%%%@-    #.*++++++%               
+           @.*+@  :@.  -..........::::@%%%%%%%%%%-      @@@*+#@@@+              
+           *#@+++@:@@****:...:%@@@@%%%%%%%%%%%%%%%-    #@*+#*#@+*@              
+           :.**+++++++++++*@@%%%%%%%%%%%%%%%%%%%%%@@.%    . %+*=                
+            . .%.     . %++@%%%%%%%%%%%%%%%%%%%%%%@      @%+*#                  
+              @..     -*+*@+@%@%%%%%%%%%%%%%%%%%%%%.    .**@                    
+                    =@+*@@@  *@@%%%%%%%%%%%%%%%%%%%%%-@  @                      
+                  .@+*++++*@.  @@@%%%%%%%%%%%%%%%%%@%.  .                       
+                  @**@+  *++@..   @:@%%%%%%%%%%%%%%@   ..                       
+                        @+*@%* .   #@%%%@@%@%%%%%% :@                           
+                       *+++*#@ @%@@:....:.@%%@###%%#-                           
+                       @@        @:..........-#*#@@@#                           
+                                @%@@@:......... @@@@.                           
+                               .@%%%%%%%%:.......@@@*                           
+                               @%%%%%%%%%%%:.....:@@                            
+                              :.....@%%%%%%%@:::::@                             
+                            =:........*#%%%%@+:::+                              
+                           @%%%@*.......%%@@@@:%                                
+                         @@%%%%%%%@:...::@@@@@                                  
+                        @@%%%%%%%@:::::@@@                                    
+                      @.   .@@@@@@@@-:::@                                       
+                 .@  ..@@  @@@@@@@@@@                                           
+             +#@%                                                               
+`;
+export const ASCII_TITLE = `
+  ██████╗  ██████╗  ██████╗████████╗██████╗ ██████╗     ██████╗ ███████╗███████╗███████╗
+  ██╔══██╗██╔═══██╗██╔════╝╚══██╔══╝██╔══██╗██╔══██╗    ██╔══██╗██╔════╝██╔════╝╚══███╔╝
+  ██║  ██║██║   ██║██║        ██║   ██║  ██║██████╔╝    ██████╔╝█████╗  █████╗    ███╔╝ 
+  ██║  ██║██║   ██║██║        ██║   ██║  ██║██╔══██╗    ██╔══██╗██╔══╝  ██╔══╝   ███╔╝  
+  ██████╔╝╚██████╔╝╚██████╗   ██║   ╚██████╔╝██║  ██║    ██████╔╝███████╗███████╗███████╗
+  ╚═════╝  ╚═════╝  ╚═════╝   ╚═╝    ╚═════╝ ╚═╝  ╚═╝    ╚═════╝ ╚══════╝╚══════╝╚══════╝
+`;
+export function renderBanner() {
+    console.clear();
+    console.log(killaGradient(ASCII_BEE));
+    console.log(killaGradient(ASCII_TITLE));
+    console.log(chalk.bold.yellow(' ========================================================================================'));
+    console.log(chalk.bold.yellow(' [ 🐝 KILLA SWARM CODE HEALING PROTOCOL · DOCTOR BEEZ v1.0 · POWERED BY BEEZ DIGITAL 🐝 ]'));
+    console.log(chalk.bold.yellow(' ========================================================================================\n'));
+}

package/dist/ui/dashboard.js

@@ -0,0 +1,29 @@
+import chalk from 'chalk';
+export function renderDashboard(results) {
+    console.log(chalk.bold.yellow(' ┌──────────────────────────────────────────────────────────────────────────────────┐'));
+    console.log(chalk.bold.yellow(' │ 📊 RESUMEN DE SALUD DEL PANAL ("LA MEDIA CAGADITA")                               │'));
+    console.log(chalk.bold.yellow(' ├─────────────────────────────────────────────┬───────────┬────────────────────────┤'));
+    console.log(chalk.bold.yellow(' │ Motor de Auditoría                          │ Estado    │ Observaciones          │'));
+    console.log(chalk.bold.yellow(' ├─────────────────────────────────────────────┼───────────┼────────────────────────┤'));
+    const statusType = results.typeErrorsCount > 0
+        ? chalk.bold.red(` 🚨 ${results.typeErrorsCount} err  `)
+        : chalk.bold.green(' 🟢 0 err   ');
+    console.log(` │ 1. TypeScript (Compilación)                  │ ${statusType}│ Errores de Tipado      │`);
+    const statusTests = results.testFailuresCount > 0
+        ? chalk.bold.red(` 🚨 ${results.testFailuresCount} fallos `)
+        : chalk.bold.green(' 🟢 0 fallos');
+    console.log(` │ 2. Suite de Pruebas (Vitest/Jest)            │ ${statusTests}│ Regresiones en Tests   │`);
+    const statusKnip = results.knipIssuesCount > 0
+        ? chalk.bold.yellow(` ⚠️  ${results.knipIssuesCount} obs   `)
+        : chalk.bold.green(' 🟢 0 obs   ');
+    console.log(` │ 3. Knip (Código Muerto y Deps)             │ ${statusKnip}│ Variables/Exports      │`);
+    const statusSemgrep = results.semgrepIssuesCount > 0
+        ? chalk.bold.red(` 🛡️  ${results.semgrepIssuesCount} warn  `)
+        : chalk.bold.green(' 🟢 0 warn  ');
+    console.log(` │ 4. Semgrep (Seguridad)                      │ ${statusSemgrep}│ Reglas de Seguridad    │`);
+    const statusDpdm = results.circularDepsCount > 0
+        ? chalk.bold.yellow(` 🔄 ${results.circularDepsCount} circ  `)
+        : chalk.bold.green(' 🟢 0 circ  ');
+    console.log(` │ 5. DPDM (Dependencias Circulares)            │ ${statusDpdm}│ Grafos Cíclicos        │`);
+    console.log(chalk.bold.yellow(' └─────────────────────────────────────────────┴───────────┴────────────────────────┘\n'));
+}

package/doctor.sh

@@ -0,0 +1,103 @@
+#!/bin/bash
+
+# Color codes
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+NC='\033[0m'
+
+echo "============================================="
+echo "   INICIANDO AUDITORÍA TOTAL DE EXCELENCIA   "
+echo "============================================="
+
+# Clean old reports
+rm -f report-1-types.log report-2-tests.log report-3-knip.json report-4-semgrep.json report-5-dpdm.log doctor-summary.txt
+
+# Helper para ejecutar binarios locales ultra-rápido sin overhead de npx
+run_bin() {
+    if [ -f "./node_modules/.bin/$1" ]; then
+        "./node_modules/.bin/$@"
+    else
+        npx --no-install "$@"
+    fi
+}
+
+# ---------------------------------------------------------
+# 1. VERIFICACIÓN DE TIPOS (TypeScript)
+# ---------------------------------------------------------
+echo -n "[1/5] Verificando compilación de tipos (tsc)... "
+if run_bin tsc --noEmit > report-1-types.log 2>&1; then
+    echo -e "${GREEN}PASÓ${NC}"
+else
+    echo -e "${RED}FALLÓ (Revisar report-1-types.log)${NC}"
+fi
+
+# ---------------------------------------------------------
+# 2. PRUEBAS UNITARIAS (Detección previa + Ejecución)
+# ---------------------------------------------------------
+echo -n "[2/5] Ejecutando suite de pruebas... "
+
+TEST_RUNNER=""
+TEST_ARGS=""
+
+if [ -f "./node_modules/.bin/vitest" ]; then
+    TEST_RUNNER="vitest"
+    TEST_ARGS="run --passWithNoTests"
+elif [ -f "./node_modules/.bin/jest" ]; then
+    TEST_RUNNER="jest"
+    TEST_ARGS="--passWithNoTests"
+elif [ -f "./node_modules/.bin/react-scripts" ]; then
+    TEST_RUNNER="react-scripts"
+    TEST_ARGS="test --watchAll=false"
+fi
+
+if [ -n "$TEST_RUNNER" ]; then
+    if CI=true run_bin $TEST_RUNNER $TEST_ARGS > report-2-tests.log 2>&1; then
+        echo -e "${GREEN}PASÓ ($TEST_RUNNER)${NC}"
+    else
+        echo -e "${RED}FALLÓ (Revisar report-2-tests.log)${NC}"
+    fi
+else
+    echo "Omitido (No se encontró Vitest, Jest ni react-scripts)"
+fi
+
+# ---------------------------------------------------------
+# 3. CÓDIGO MUERTO Y DEPENDENCIAS (Knip)
+# ---------------------------------------------------------
+echo -n "[3/5] Analizando código muerto (Knip)... "
+run_bin knip --no-exit-code --formatter json > report-3-knip.json 2>&1
+echo -e "${GREEN}COMPLETADO${NC}"
+
+# ---------------------------------------------------------
+# 4. SEGURIDAD Y REGLAS DE LÓGICA (Semgrep)
+# ---------------------------------------------------------
+echo -n "[4/5] Auditando seguridad (Semgrep)... "
+if command -v semgrep &> /dev/null; then
+    semgrep scan --config auto --json --output report-4-semgrep.json 2>/dev/null
+else
+    run_bin semgrep scan --config auto --json --output report-4-semgrep.json 2>/dev/null
+fi
+echo -e "${GREEN}COMPLETADO${NC}"
+
+# ---------------------------------------------------------
+# 5. DEPENDENCIAS CIRCULARES (dpdm)
+# ---------------------------------------------------------
+ENTRY_POINT=""
+for file in src/main.tsx src/main.ts src/index.tsx src/index.js src/app/layout.tsx app/layout.tsx; do
+    if [ -f "$file" ]; then
+        ENTRY_POINT="$file"
+        break
+    fi
+done
+
+if [ -n "$ENTRY_POINT" ]; then
+    echo -n "[5/5] Analizando grafos circulares en $ENTRY_POINT... "
+    run_bin dpdm "$ENTRY_POINT" --exit-code circular:0 > report-5-dpdm.log 2>&1
+    echo -e "${GREEN}COMPLETADO${NC}"
+else
+    echo "Omitido (No se encontró punto de entrada estándar en src/)"
+fi
+
+echo ""
+echo "============================================="
+echo "   AUDITORÍA FINALIZADA. REVISA LOS LOGS.   "
+echo "============================================="

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "doctor-beez",
+  "version": "1.0.0",
+  "description": "El Enjambre de Curación Autónoma de Código - Powered by BEEZ DIGITAL",
+  "main": "dist/index.js",
+  "bin": {
+    "doctor-beez": "bin/doctor-beez.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "start": "tsx src/index.ts",
+    "doctor-beez": "tsx src/index.ts"
+  },
+  "files": [
+    "bin",
+    "src",
+    "dist",
+    "doctor.sh",
+    "README.md"
+  ],
+  "keywords": [
+    "cli",
+    "doctor",
+    "beez",
+    "refactor",
+    "linter",
+    "swapping"
+  ],
+  "author": "BEEZ DIGITAL",
+  "license": "MIT",
+  "dependencies": {
+    "@clack/prompts": "^0.8.2",
+    "chalk": "^5.3.0",
+    "execa": "^9.1.0",
+    "figlet": "^1.7.0",
+    "gradient-string": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/figlet": "^1.7.0",
+    "@types/node": "^20.11.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3"
+  },
+  "type": "module"
+}

package/src/auth/github.ts

@@ -0,0 +1,36 @@
+import { execa } from 'execa';
+import * as p from '@clack/prompts';
+import chalk from 'chalk';
+
+export async function checkGitHubAuth(): Promise<boolean> {
+  const spinner = p.spinner();
+  spinner.start('🔑 Verificando credenciales de GitHub (gh CLI)...');
+
+  try {
+    const { stdout } = await execa('gh', ['auth', 'status']);
+    spinner.stop('🟢 Autenticación de GitHub verificada.');
+    return true;
+  } catch (error) {
+    spinner.stop('🔴 No estás autenticado en GitHub CLI (gh).');
+
+    const shouldLogin = await p.confirm({
+      message: '¿Deseas iniciar sesión en GitHub ahora usando `gh auth login`?',
+      initialValue: true,
+    });
+
+    if (p.isCancel(shouldLogin) || !shouldLogin) {
+      p.log.warn('Continuando sin autenticación de GitHub...');
+      return false;
+    }
+
+    p.log.info('Iniciando proceso de login de GitHub...');
+    try {
+      await execa('gh', ['auth', 'login'], { stdio: 'inherit' });
+      p.log.success('¡Autenticación completada con éxito!');
+      return true;
+    } catch (err) {
+      p.log.error('No se pudo completar la autenticación en GitHub.');
+      return false;
+    }
+  }
+}

package/src/healer/swarm.ts

@@ -0,0 +1,34 @@
+import * as p from '@clack/prompts';
+import chalk from 'chalk';
+import { runDiagnosticScan } from '../scanner/doctor.js';
+
+export async function startSwarmHealingLoop(): Promise<void> {
+  p.log.info(chalk.bold.yellow('🐝 ENJAMBRE DESPLEGADO: Iniciando bucle de curación autónoma...'));
+
+  p.note(
+    `1. Copia las reglas de curación en tu agente (OpenCode / Aider / Antigravity).
+2. El agente procesará lotes de 3 a 5 errores como máximo.
+3. Se verificará compilación tsc y tests tras cada iteración.
+4. Cada lote limpio generará un commit atómico en Git.`,
+    '📋 Instrucciones para el Agente Curador'
+  );
+
+  const confirmStart = await p.confirm({
+    message: '¿Iniciar primera iteración del enjambre de curación ahora?',
+    initialValue: true,
+  });
+
+  if (p.isCancel(confirmStart) || !confirmStart) {
+    p.log.warn('Bucle de curación en pausa. Puedes ejecutarlo cuando quieras.');
+    return;
+  }
+
+  p.log.success('🐝 ¡Enjambre trabajando! Re-auditando después del primer lote...');
+  const newResults = await runDiagnosticScan();
+  
+  if (!newResults.hasErrors) {
+    p.outro(chalk.bold.green('🎉 ¡EL PANAL ESTÁ 100% LIMPIO Y SANO! 🐝✨'));
+  } else {
+    p.log.info('Aún quedan observaciones por pulir. Continúa con el siguiente lote.');
+  }
+}

package/src/index.ts

@@ -0,0 +1,58 @@
+import * as p from '@clack/prompts';
+import chalk from 'chalk';
+import { renderBanner } from './ui/banner.js';
+import { checkGitHubAuth } from './auth/github.js';
+import { runDiagnosticScan } from './scanner/doctor.js';
+import { renderDashboard } from './ui/dashboard.js';
+import { startSwarmHealingLoop } from './healer/swarm.js';
+
+async function main() {
+  // 1. Mostrar Banner Killa Beez
+  renderBanner();
+
+  p.intro(chalk.bold.yellow('🐝 DOCTOR BEEZ CLI — SISTEMA AUTÓNOMO DE AUDITORÍA Y CURACIÓN'));
+
+  // 2. Verificar Autenticación GitHub
+  await checkGitHubAuth();
+
+  // 3. Escaneo Silencioso
+  const results = await runDiagnosticScan();
+
+  // 4. Renderizar "La Media Cagadita"
+  renderDashboard(results);
+
+  // 5. Pregunta Interactiva al Usuario
+  if (!results.hasErrors) {
+    p.outro(chalk.bold.green('✨ ¡Tu proyecto está impecable! No hay errores críticos detectados.'));
+    return;
+  }
+
+  const action = await p.select({
+    message: '¿Qué deseas hacer con las observaciones encontradas?',
+    options: [
+      {
+        value: 'heal',
+        label: '🚀 ¡DALE COLOR! (Desplegar Enjambre de Curación)',
+        hint: 'Inicia el bucle de reparación autónomo',
+      },
+      {
+        value: 'exit',
+        label: '❌ No hermano, me dio miedo (Cancelar por ahora)',
+        hint: 'Mantiene los reportes sin hacer cambios',
+      },
+    ],
+  });
+
+  if (p.isCancel(action) || action === 'exit') {
+    p.outro(chalk.yellow('🐝 Operación cancelada. El enjambre se mantiene en espera.'));
+    process.exit(0);
+  }
+
+  // 6. Desplegar Enjambre
+  await startSwarmHealingLoop();
+}
+
+main().catch((err) => {
+  console.error(chalk.red('Error inesperado en DOCTOR BEEZ:'), err);
+  process.exit(1);
+});

package/src/scanner/doctor.ts

@@ -0,0 +1,96 @@
+import { execa } from 'execa';
+import * as p from '@clack/prompts';
+import fs from 'fs';
+import path from 'path';
+
+export interface AuditResults {
+  typeErrorsCount: number;
+  testFailuresCount: number;
+  knipIssuesCount: number;
+  semgrepIssuesCount: number;
+  circularDepsCount: number;
+  hasErrors: boolean;
+}
+
+export async function runDiagnosticScan(): Promise<AuditResults> {
+  const spinner = p.spinner();
+  spinner.start('🐝 Desplegando abejas exploradoras para la auditoría de código...');
+
+  try {
+    // Run doctor.sh
+    await execa('bash', ['doctor.sh']);
+    spinner.stop('🐝 Auditoría inicial completada. Analizando reportes...');
+  } catch (error) {
+    spinner.stop('🐝 Auditoría finalizada con observaciones.');
+  }
+
+  // Parse report-1-types.log
+  let typeErrorsCount = 0;
+  if (fs.existsSync('report-1-types.log')) {
+    const content = fs.readFileSync('report-1-types.log', 'utf-8');
+    const matches = content.match(/error TS\d+/g);
+    if (matches) {
+      typeErrorsCount = matches.length;
+    }
+  }
+
+  // Parse report-2-tests.log
+  let testFailuresCount = 0;
+  if (fs.existsSync('report-2-tests.log')) {
+    const content = fs.readFileSync('report-2-tests.log', 'utf-8');
+    if (content.includes('FAIL') || content.includes('FAILED')) {
+      const matches = content.match(/FAIL/g);
+      testFailuresCount = matches ? matches.length : 1;
+    }
+  }
+
+  // Parse report-3-knip.json
+  let knipIssuesCount = 0;
+  if (fs.existsSync('report-3-knip.json')) {
+    try {
+      const raw = fs.readFileSync('report-3-knip.json', 'utf-8');
+      const data = JSON.parse(raw);
+      if (data && typeof data === 'object') {
+        const unused = data.unused || {};
+        knipIssuesCount = Object.keys(unused).reduce((acc, key) => acc + (Array.isArray(unused[key]) ? unused[key].length : 1), 0);
+      }
+    } catch (e) {
+      knipIssuesCount = 0;
+    }
+  }
+
+  // Parse report-4-semgrep.json
+  let semgrepIssuesCount = 0;
+  if (fs.existsSync('report-4-semgrep.json')) {
+    try {
+      const raw = fs.readFileSync('report-4-semgrep.json', 'utf-8');
+      const data = JSON.parse(raw);
+      if (data && data.results && Array.isArray(data.results)) {
+        semgrepIssuesCount = data.results.length;
+      }
+    } catch (e) {
+      semgrepIssuesCount = 0;
+    }
+  }
+
+  // Parse report-5-dpdm.log
+  let circularDepsCount = 0;
+  if (fs.existsSync('report-5-dpdm.log')) {
+    const content = fs.readFileSync('report-5-dpdm.log', 'utf-8');
+    const matches = content.match(/Circular/gi);
+    if (matches) {
+      circularDepsCount = matches.length;
+    }
+  }
+
+  const hasErrors = typeErrorsCount > 0 || testFailuresCount > 0 || knipIssuesCount > 0 || semgrepIssuesCount > 0 || circularDepsCount > 0;
+
+  return {
+    typeErrorsCount,
+    testFailuresCount,
+    knipIssuesCount,
+    semgrepIssuesCount,
+    circularDepsCount,
+    hasErrors,
+  };
+}

package/src/ui/banner.ts

@@ -0,0 +1,62 @@
+import chalk from 'chalk';
+import gradient from 'gradient-string';
+
+const killaGradient = gradient(['#FFE600', '#FFB300', '#FF8C00']);
+
+export const ASCII_BEE = `
+                 .@@%                                                           
+                 #::::*@*@@@@@@@@%                                              
+                                 @                                              
+           .                     @                                              
+         -:::::@==++*#%@#       =@                        +*@   =               
+                         @      @- :%@.                @          =             
+                          @@    @%%%%%%%@*           #     @ .@.   @   %        
+                           @%::@%%%%%%%+-%%        -@     @       @     ..      
+        .%:.=           %%@:..%%%%%%%%% %%:+     =  = .@#       %   %#          
+       @    :+-       .%%%...@%%%%%%%% %%%:@   @    @ #   :#@@#      @          
+       .  *    .    ::#%%%..-%%%%%%%% %%:::@ -    @@#   +@#*%  %      %  @      
+       .  *.#  @@.  # @%%*.:@%%%%%%%%%%:*@:@%%%%%@*+++++*%=+@  -@      .        
+       .@. %-. @      %%%+..%%%%%%%%%%.%#:@%%%%%%%@@   @++#   +  @   #          
+         %     @%..    %%:..*%%%%%*- =*::@%%%%%%%%%%@ .@+@*-.@    @             
+           .#+%-#      @:.....:::.@  %::@%%%%%%%%@-    #.*++++++%               
+           @.*+@  :@.  -..........::::@%%%%%%%%%%-      @@@*+#@@@+              
+           *#@+++@:@@****:...:%@@@@%%%%%%%%%%%%%%%-    #@*+#*#@+*@              
+           :.**+++++++++++*@@%%%%%%%%%%%%%%%%%%%%%@@.%    . %+*=                
+            . .%.     . %++@%%%%%%%%%%%%%%%%%%%%%%@      @%+*#                  
+              @..     -*+*@+@%@%%%%%%%%%%%%%%%%%%%%.    .**@                    
+                    =@+*@@@  *@@%%%%%%%%%%%%%%%%%%%%%-@  @                      
+                  .@+*++++*@.  @@@%%%%%%%%%%%%%%%%%@%.  .                       
+                  @**@+  *++@..   @:@%%%%%%%%%%%%%%@   ..                       
+                        @+*@%* .   #@%%%@@%@%%%%%% :@                           
+                       *+++*#@ @%@@:....:.@%%@###%%#-                           
+                       @@        @:..........-#*#@@@#                           
+                                @%@@@:......... @@@@.                           
+                               .@%%%%%%%%:.......@@@*                           
+                               @%%%%%%%%%%%:.....:@@                            
+                              :.....@%%%%%%%@:::::@                             
+                            =:........*#%%%%@+:::+                              
+                           @%%%@*.......%%@@@@:%                                
+                         @@%%%%%%%@:...::@@@@@                                  
+                        @@%%%%%%%@:::::@@@                                    
+                      @.   .@@@@@@@@-:::@                                       
+                 .@  ..@@  @@@@@@@@@@                                           
+             +#@%                                                               
+`;
+
+export const ASCII_TITLE = `
+  ██████╗  ██████╗  ██████╗████████╗██████╗ ██████╗     ██████╗ ███████╗███████╗███████╗
+  ██╔══██╗██╔═══██╗██╔════╝╚══██╔══╝██╔══██╗██╔══██╗    ██╔══██╗██╔════╝██╔════╝╚══███╔╝
+  ██║  ██║██║   ██║██║        ██║   ██║  ██║██████╔╝    ██████╔╝█████╗  █████╗    ███╔╝ 
+  ██║  ██║██║   ██║██║        ██║   ██║  ██║██╔══██╗    ██╔══██╗██╔══╝  ██╔══╝   ███╔╝  
+  ██████╔╝╚██████╔╝╚██████╗   ██║   ╚██████╔╝██║  ██║    ██████╔╝███████╗███████╗███████╗
+  ╚═════╝  ╚═════╝  ╚═════╝   ╚═╝    ╚═════╝ ╚═╝  ╚═╝    ╚═════╝ ╚══════╝╚══════╝╚══════╝
+`;
+
+export function renderBanner(): void {
+  console.clear();
+  console.log(killaGradient(ASCII_BEE));
+  console.log(killaGradient(ASCII_TITLE));
+  console.log(chalk.bold.yellow(' ========================================================================================'));
+  console.log(chalk.bold.yellow(' [ 🐝 KILLA SWARM CODE HEALING PROTOCOL · DOCTOR BEEZ v1.0 · POWERED BY BEEZ DIGITAL 🐝 ]'));
+  console.log(chalk.bold.yellow(' ========================================================================================\n'));
+}

package/src/ui/dashboard.ts

@@ -0,0 +1,37 @@
+import chalk from 'chalk';
+import { AuditResults } from '../scanner/doctor.js';
+
+export function renderDashboard(results: AuditResults): void {
+  console.log(chalk.bold.yellow(' ┌──────────────────────────────────────────────────────────────────────────────────┐'));
+  console.log(chalk.bold.yellow(' │ 📊 RESUMEN DE SALUD DEL PANAL ("LA MEDIA CAGADITA")                               │'));
+  console.log(chalk.bold.yellow(' ├─────────────────────────────────────────────┬───────────┬────────────────────────┤'));
+  console.log(chalk.bold.yellow(' │ Motor de Auditoría                          │ Estado    │ Observaciones          │'));
+  console.log(chalk.bold.yellow(' ├─────────────────────────────────────────────┼───────────┼────────────────────────┤'));
+
+  const statusType = results.typeErrorsCount > 0 
+    ? chalk.bold.red(` 🚨 ${results.typeErrorsCount} err  `) 
+    : chalk.bold.green(' 🟢 0 err   ');
+  console.log(` │ 1. TypeScript (Compilación)                  │ ${statusType}│ Errores de Tipado      │`);
+
+  const statusTests = results.testFailuresCount > 0 
+    ? chalk.bold.red(` 🚨 ${results.testFailuresCount} fallos `) 
+    : chalk.bold.green(' 🟢 0 fallos');
+  console.log(` │ 2. Suite de Pruebas (Vitest/Jest)            │ ${statusTests}│ Regresiones en Tests   │`);
+
+  const statusKnip = results.knipIssuesCount > 0 
+    ? chalk.bold.yellow(` ⚠️  ${results.knipIssuesCount} obs   `) 
+    : chalk.bold.green(' 🟢 0 obs   ');
+  console.log(` │ 3. Knip (Código Muerto y Deps)             │ ${statusKnip}│ Variables/Exports      │`);
+
+  const statusSemgrep = results.semgrepIssuesCount > 0 
+    ? chalk.bold.red(` 🛡️  ${results.semgrepIssuesCount} warn  `) 
+    : chalk.bold.green(' 🟢 0 warn  ');
+  console.log(` │ 4. Semgrep (Seguridad)                      │ ${statusSemgrep}│ Reglas de Seguridad    │`);
+
+  const statusDpdm = results.circularDepsCount > 0 
+    ? chalk.bold.yellow(` 🔄 ${results.circularDepsCount} circ  `) 
+    : chalk.bold.green(' 🟢 0 circ  ');
+  console.log(` │ 5. DPDM (Dependencias Circulares)            │ ${statusDpdm}│ Grafos Cíclicos        │`);
+
+  console.log(chalk.bold.yellow(' └─────────────────────────────────────────────┴───────────┴────────────────────────┘\n'));
+}