LightCraft TUI 📷⚡

LightCraft TUI es una terminal gráfica interactiva de alto rendimiento y grado profesional para revelado, graduación de color y exportación por lotes de fotografía digital (incluyendo Canon CR3 RAW). Combina un motor de renderizado asíncrono en Rust con integración mediante el protocolo Model Context Protocol (MCP) para automatización con agentes de Inteligencia Artificial.

---

🌟 Características Principales

• 🖼️ Interfaz TUI de 3 Paneles Sincronizados:
  • 1. Biblioteca (Library): Exploración de catálogo con scroll viewport activo, selección de fotos ([Space]) y filtrado/etiquetado ([P] Pick, [X] Reject, [U] Unflag).
  • 2. Previsualizador (Preview Canvas):
    • Vista Hero principal ([1]).
    • Matriz de Variantes 2 slots ([2]), 2×2 ([4]) y 3×2 ([6]) con navegación bidimensional [↑/↓/←/→] o Vim [h/j/k/l].
    • Modo Split-View Wiper ([S]) para comparativa Antes/Después (Before & After) y cambio instantáneo A/B ([\\]).
    • Promoción de variante a receta de trabajo activa ([Enter]) y marcado de favoritos ([Space]).
  • 3. Inspector de Receta y Metadatos: Histograma de 4 canales en tiempo real (<2ms) y ajuste fino de intensidad de presets ([[] / []]).
• 🚀 Exportación Secuencial de Máxima Calidad ([E]):
  • Exportación inmediata de la variante seleccionada con un solo toque:
    • Archival Master: TIFF de 16 bits sin pérdida.
    • Full-Resolution: JPEG a 100% de calidad.
• 🔄 Cola de Procesamiento por Lotes (Modo B):
  • Cambio inmediato de modo sin pérdida de estado ([M] o [F10]).
  • Pausa/Reanudación ([Space]), reintento de fallidos ([R]) y cancelación ([C]).
• 🔒 Integridad Criptográfica Inmutable (Non-Destructive RAW):
  • Verificación SHA-256 pre-flight y post-flight.
  • Veto estricto a nivel de motor para garantizar cero modificaciones o sobreescritura accidental en los archivos RAW maestros (DRAW/*.CR3).
• ⚡ Motor Asíncrono Tokio Multihilo:
  • Despacho reactivo de variantes en segundo plano (tokio::spawn_blocking).
  • Protección de timeout preventivo para evitar bloqueos en decodificación de imagen.
• 🤖 MCP Server / Client Bridge:
  • Soporte para operar conectado a un servidor MCP o en modo autónomo / mock offline.

---

🛠️ Comandos de Compilación y Ejecución

1. Modo Debug (Desarrollo y Pruebas Rápidas)

Ideal mientras se realizan cambios en el código, con símbolos de depuración completos:

# Compilar en modo debug
cargo build

# Ejecutar el TUI interactivo en modo debug
cargo run -- --tui

# Ejecutar con protocolo gráfico Halfblocks (universalmente compatible en Windows Terminal)
cargo run -- --tui --graphics halfblocks

# Ejecutar en modo offline/mock (sin depender del servidor MCP externo)
cargo run -- --tui --mock

2. Modo Release (Máximo Rendimiento / Producción)

Aplica optimizaciones opt-level = 3, LTO y vectorización:

# Compilar binario optimizado para release
cargo build --release

# Ejecutar el binario compilado en release
cargo run --release -- --tui

# O ejecutar directamente el ejecutable generado:
.\target\release\lightcraft-tui.exe --tui

3. Ejecución por CLI (Sin TUI / Automatización Batch)

# Verificar la integridad SHA-256 de los archivos RAW en DRAW/
cargo run --release -- --verify-integrity

# Listar presets disponibles (Built-in y de usuario)
cargo run --release -- --list-presets

# Ver detalles de un preset en formato TOML o JSON
cargo run --release -- --show-preset Cinema --format toml

# Exportación secuencial batch de máxima calidad por línea de comandos
cargo run --release -- --sequential-export --output-dir dist/galeria_maxima

4. Quality Gates y Suite de Pruebas

# Verificación rápida de tipos y compilación
cargo check --all-targets

# Ejecutar toda la suite de pruebas unitarias, de integración y adversariales
cargo test

# Ejecutar pruebas específicas del TUI y navegación
cargo test --test tier1_mode_a_tests
cargo test --test tier1_tui_layout_tests

# Análisis de linter (Clippy)
cargo clippy --all-targets

---

⌨️ Atajos de Teclado en el TUI

Navegación Global y Modos

Panel 1: Biblioteca (Library)

Panel 2: Previsualizador (Preview Canvas - Modo A)

Panel 3: Inspector de Receta y Metadatos

Modo B: Cola de Lotes (Batch Queue)

---

🏛️ Arquitectura del Sistema

lightcraft-tui/
├── src/
│   ├── main.rs            # Entry point y CLI parser (Clap)
│   ├── app.rs             # Controlador principal y bucle de eventos Ratatui
│   ├── engine/            # Motor de presets, recetas fotográficas y colorimetría
│   ├── export/            # Pipeline de exportación multi-formato (TIFF 16b, JPEG, PNG)
│   ├── graphics/          # Adaptadores de renderizado terminal (Halfblocks, Sixel, Kitty)
│   ├── mcp/               # Cliente/servidor Model Context Protocol (JSON-RPC 2.0)
│   ├── queue/             # Cola de procesamiento por lotes concurrente y resiliente
│   ├── storage/           # Almacenamiento atómico de presets (TOML / JSON)
│   └── tui/               # Componentes visuales, layout responsivo y gestión de eventos
├── DRAW/                  # Directorio protegido de negativos digitales Canon CR3 RAW
└── tests/                 # Suites de pruebas estructuradas por Tiers (1 a 4) y Adversariales

---

📄 Licencia y Comunidad

• Licencia: Distribuido bajo licencia dual MIT o Apache-2.0.
• Guía de Contribución: Consulta CONTRIBUTING.md para configurar el entorno y enviar PRs.
• Seguridad: Revisa nuestra política de divulgación en SECURITY.md.
• Código de Conducta: Adherido a CODE_OF_CONDUCT.md.
• Historial de Cambios: Consulta CHANGELOG.md.