🗒️ Minimal Notes CLI

Typer CLI inteligente para gestión de notas con SQLite3 y procesamiento de IA

---

🎯 ¿Qué es Minimal Notes?

Sistema de notas (Typer CLI) production-ready que combina persistencia local (SQLite3) con capacidades de IA para automatizar mejoras, resúmenes y procesamiento de contenido. Arquitectura modular diseñada para escalabilidad y mantenibilidad.

# Workflow típico
mnctl crear "Arquitectura microservicios: API Gateway + Redis cache"
mnctl listar                    # ID | Fecha | Preview
mnctl buscar "microservicios"   # Búsqueda full-text
mnctl mejorar 1                 # IA optimiza estructura y contenido
mnctl traducir 1 "english"     # Deploy internacional

📸 Vista Superficial

⚡ Features Core

🔧 CRUD Completo	Create, Read, Update, Delete con indexación SQLite
🔍 Búsqueda Integrada	Full-text search
📁 Import/Export	Interoperabilidad con ecosistema de archivos
🤖 IA Integrada	Mejora, resumen, Q&A y traducción automática
⚙️ Zero Config	Funciona out-of-the-box, sin setup complejo
💾 Local-First	SQLite embebido, sin dependencias cloud

🚀 Instalación

Requisitos:

• Dependencias Python 3.10+: pip install -r requirements.txt
• Gemini API: GEMINI_API_KEY dentro de .env en raíz del proyecto.

Nota: Hay un .env.example de ejemplo que podes copiar.

Linux/macOS

git clone https://github.com/uCoders-Devs/minimal-notes.git
cd minimal-notes
chmod +x mnctl
./mnctl --help

Windows

git clone https://github.com/uCoders-Devs/minimal-notes.git
cd minimal-notes
python cli/mnctl.py --help

Windows users: Usa python cli/mnctl.py en lugar de ./mnctl

💡 Demo Rápida

# Gestión básica
mnctl crear "Bug crítico: memory leak en auth middleware"
mnctl leer 1
mnctl modificar 1 "FIXED: memory leak resuelto con proper cleanup"

# Funciones avanzadas
mnctl buscar "memory leak"
mnctl exportar 1 --filename "hotfix-log.txt"
mnctl importar "requirements.txt"

# IA Pipeline
mnctl mejorar 2                           # Optimiza estructura
mnctl resumir 2                          # Executive summary
mnctl preguntar 2 "¿Cuáles son los TODOs?" # Context-aware Q&A
mnctl traducir 2 "english"               # i18n ready

🏗️ Arquitectura

• Separation of Concerns: Database -> Handler -> Router -> CLI (layers)
• Modular Design: Componentes reutilizables e intercambiables
• UNIX Philosophy: Do one thing, do it well

📚 Documentación

• Uso completo: docs/MNCTL.md
• Detalles técnicos: Rama testing
• Testing logs: data/log/

🔧 Development

# Setup dev environment
git checkout testing
chmod +x mnctl
./mnctl --test           # Run bash test suite

---

👥 Team

Tomas-SC Architecture & Backend

Blu CLI & Integration

---

📄 MIT License • 🐍 Python 3.10+ • 🔄 v0.1.0-alpha