docs: update documentation for Model Orchestrator and Logger

README.md / README_ES.md:
- Add "Intelligent Model Selection" feature section

wiki/Configuration.md / Configuration.es.md:
- Replace "Model" section with "Execution Mode"
- Document Automatic, Economic, and Maximum Quality modes
- Explain how Model Orchestrator classifies tasks
- Update recommended configurations

CLAUDE.md:
- Add Logging section with mandatory logger usage rules
- Document log levels (debug, info, warn, error)
- Update architecture to include new files:
  - model-orchestrator.ts
  - logger.ts
  - context-manager.ts
  - context-storage.ts

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: montfort

CLAUDE.md

@@ -29,9 +29,11 @@ npm run build            # Build producción (minificado)
 ```
 src/
 ├── main.ts                  # Entry point, registra comandos y vistas
-├── settings.ts              # PluginSettingTab con config (API key, modelo, etc.)
+├── settings.ts              # PluginSettingTab con config (API key, modo, etc.)
 ├── claude-client.ts         # Wrapper Anthropic SDK con streaming
 ├── chat-view.ts             # ItemView para panel lateral de chat
+├── model-orchestrator.ts    # Enrutador inteligente de modelos
+├── logger.ts                # Sistema de logging centralizado
 ├── note-creator.ts          # Modal para crear notas desde chat
 ├── note-processor.ts        # Procesamiento de notas existentes
 ├── vault-indexer.ts         # Indexación de bóveda
@@ -43,6 +45,8 @@ src/
 ├── vault-actions.ts         # Ejecutor de acciones sobre bóveda
 ├── agent-mode.ts            # Gestión del modo agente
 ├── confirmation-modal.ts    # Modal de confirmación de acciones
+├── context-manager.ts       # Gestión de contexto de conversación
+├── context-storage.ts       # Almacenamiento temporal de contexto
 ├── i18n/                    # Internationalization system
 │   ├── index.ts             # Public API (t, setLocale, etc.)
 │   ├── types.ts             # TypeScript types and translation keys
@@ -133,6 +137,45 @@ Example of adding German patterns:
 /^fortfahren$/i,       // German: "proceed"
 ```
 
+## Logging
+
+**CRITICAL: Never use `console.log`, `console.warn`, or `console.error` directly.**
+
+All debug and error messages must use the centralized logger from `src/logger.ts`. This ensures:
+- Production builds only show warnings and errors (for user bug reports)
+- Development builds show all log levels for debugging
+- Consistent `[Claudian]` prefix across all messages
+
+```typescript
+// ✅ Correct
+import { logger } from './logger';
+logger.debug('Orchestrator classified task as simple');
+logger.info('Context session initialized');
+logger.warn('Task classification failed, using fallback');
+logger.error('API Error:', error);
+
+// ❌ Wrong - direct console usage
+console.log('[Claudian] Something happened');
+console.error('Error:', error);
+```
+
+**Log levels:**
+
+| Level | Production | Development | Use For |
+|-------|------------|-------------|---------|
+| `debug` | Hidden | Visible | Detailed flow, variable values, orchestrator decisions |
+| `info` | Hidden | Visible | Lifecycle events, successful operations, state changes |
+| `warn` | Visible | Visible | Recoverable errors, fallbacks, deprecated usage |
+| `error` | Visible | Visible | Failures, exceptions, critical issues |
+
+**Guidelines:**
+- Use `debug` for information only developers need during development
+- Use `info` for notable events (migrations, session start/end)
+- Use `warn` for issues that don't break functionality but should be noted
+- Use `error` for failures that users might need to report
+
+The `__DEV__` constant is injected at build time by esbuild to determine the environment.
+
 ## Documentation
 
 **CRITICAL: README.md must always be in English.**

README.md

@@ -66,6 +66,12 @@ Process multiple notes at once with extraction templates:
 ### 🗺️ Concept Maps
 Generate visual concept maps from selected notes, rendered in Mermaid format.
 
+### 🧠 Intelligent Model Selection
+Automatic model orchestration routes each task to the optimal Claude model:
+- Simple tasks → Haiku (fast & economical)
+- Content creation → Sonnet (balanced)
+- Deep analysis → Opus (maximum quality)
+
 ### 🌍 Multilingual
 Full support for **English** and **Spanish**. More languages coming soon.
 

README_ES.md

@@ -66,6 +66,12 @@ Procesa múltiples notas a la vez con plantillas de extracción:
 ### 🗺️ Mapas de Conceptos
 Genera mapas de conceptos visuales a partir de notas seleccionadas, renderizados en formato Mermaid.
 
+### 🧠 Selección Inteligente de Modelo
+Orquestación automática de modelos que enruta cada tarea al modelo óptimo de Claude:
+- Tareas simples → Haiku (rápido y económico)
+- Creación de contenido → Sonnet (equilibrado)
+- Análisis profundo → Opus (máxima calidad)
+
 ### 🌍 Multilingüe
 Soporte completo para **Inglés** y **Español**. Más idiomas próximamente.
 

wiki/Configuration.es.md

@@ -32,23 +32,35 @@ Obtén tu clave API en [console.anthropic.com](https://console.anthropic.com). L
 
 ---
 
-### Modelo
+### Modo de Ejecución
 
 | Ajuste | Descripción |
 |--------|-------------|
-| **Nombre** | Modelo |
-| **Descripción** | Modelo de Claude a usar para las respuestas |
-| **Por defecto** | Claude Sonnet 4 |
-| **Opciones** | Claude Sonnet 4, Claude Opus 4, Claude 3.5 Sonnet, Claude 3.5 Haiku |
+| **Nombre** | Modo de Ejecución |
+| **Descripción** | Cómo Claudian selecciona el modelo óptimo para cada tarea |
+| **Por defecto** | Automático |
+| **Opciones** | Automático, Económico, Máxima Calidad |
 
-**Comparación de Modelos:**
+**Comparación de Modos:**
 
-| Modelo | Mejor Para | Velocidad | Costo |
-|--------|------------|-----------|-------|
-| Claude Sonnet 4 | Uso general, rendimiento equilibrado | Rápido | Medio |
-| Claude Opus 4 | Razonamiento complejo, documentos largos | Más lento | Mayor |
-| Claude 3.5 Sonnet | Generación anterior, confiable | Rápido | Medio |
-| Claude 3.5 Haiku | Tareas rápidas, consultas simples | Más rápido | Menor |
+| Modo | Descripción | Mejor Para |
+|------|-------------|------------|
+| **Automático** | Haiku analiza cada tarea y la enruta al modelo óptimo | La mayoría de usuarios - equilibra costo y calidad |
+| **Económico** | Todas las tareas usan Haiku | Usuarios conscientes del presupuesto, tareas simples |
+| **Máxima Calidad** | Todas las tareas usan Opus | Razonamiento complejo, trabajo crítico |
+
+**Cómo Funciona el Modo Automático:**
+
+El Orquestador de Modelos usa Haiku (rápido y económico) para clasificar la complejidad de cada tarea:
+
+| Complejidad | Modelo Usado | Tareas de Ejemplo |
+|-------------|--------------|-------------------|
+| Simple | Haiku 4.5 | Listar archivos, copiar, mover, eliminar, contenido placeholder |
+| Moderada | Sonnet 4 | Escribir contenido, resumir, traducir, explicar |
+| Compleja | Sonnet 4 | Operaciones multi-archivo, procesamiento batch, refactorización |
+| Profunda | Opus 4 | Análisis, planificación estratégica, síntesis de conocimiento |
+
+Este enrutamiento inteligente optimiza costos mientras asegura calidad donde importa.
 
 ---
 
@@ -308,15 +320,19 @@ Este archivo contiene tu configuración incluyendo la clave API. **No compartas
 ## Configuración Recomendada
 
 ### Para Uso General
-- Modelo: Claude Sonnet 4
+- Modo de Ejecución: Automático
 - Tokens máximos: 4096
 - Confirmar acciones destructivas: Activado
 
 ### Para Bóvedas Grandes (1000+ notas)
+- Modo de Ejecución: Automático
 - Notas en contexto: 200-300
 - Tags en contexto: 100
-- Considera usar Claude Opus 4 para consultas complejas
 
-### Para Tareas Rápidas
-- Modelo: Claude 3.5 Haiku
+### Para Usuarios Conscientes del Presupuesto
+- Modo de Ejecución: Económico
 - Tokens máximos: 2048
+
+### Para Trabajo Crítico
+- Modo de Ejecución: Máxima Calidad
+- Tokens máximos: 8192

wiki/Configuration.md

@@ -32,23 +32,35 @@ Get your API key from [console.anthropic.com](https://console.anthropic.com). Th
 
 ---
 
-### Model
+### Execution Mode
 
 | Setting | Description |
 |---------|-------------|
-| **Name** | Model |
-| **Description** | Claude model to use for responses |
-| **Default** | Claude Sonnet 4 |
-| **Options** | Claude Sonnet 4, Claude Opus 4, Claude 3.5 Sonnet, Claude 3.5 Haiku |
+| **Name** | Execution Mode |
+| **Description** | How Claudian selects the optimal model for each task |
+| **Default** | Automatic |
+| **Options** | Automatic, Economic, Maximum Quality |
 
-**Model Comparison:**
+**Mode Comparison:**
 
-| Model | Best For | Speed | Cost |
-|-------|----------|-------|------|
-| Claude Sonnet 4 | General use, balanced performance | Fast | Medium |
-| Claude Opus 4 | Complex reasoning, long documents | Slower | Higher |
-| Claude 3.5 Sonnet | Previous generation, reliable | Fast | Medium |
-| Claude 3.5 Haiku | Quick tasks, simple queries | Fastest | Lower |
+| Mode | Description | Best For |
+|------|-------------|----------|
+| **Automatic** | Haiku analyzes each task and routes to the optimal model | Most users - balances cost and quality |
+| **Economic** | All tasks use Haiku | Budget-conscious users, simple tasks |
+| **Maximum Quality** | All tasks use Opus | Complex reasoning, critical work |
+
+**How Automatic Mode Works:**
+
+The Model Orchestrator uses Haiku (fast and cheap) to classify each task's complexity:
+
+| Complexity | Model Used | Example Tasks |
+|------------|------------|---------------|
+| Simple | Haiku 4.5 | List files, copy, move, delete, placeholder content |
+| Moderate | Sonnet 4 | Write content, summarize, translate, explain |
+| Complex | Sonnet 4 | Multi-file operations, batch processing, refactoring |
+| Deep | Opus 4 | Analysis, strategic planning, knowledge synthesis |
+
+This intelligent routing optimizes costs while ensuring quality where it matters.
 
 ---
 
@@ -308,15 +320,19 @@ This file contains your configuration including the API key. **Do not share this
 ## Recommended Configuration
 
 ### For General Use
-- Model: Claude Sonnet 4
+- Execution Mode: Automatic
 - Max tokens: 4096
 - Confirm destructive actions: On
 
 ### For Large Vaults (1000+ notes)
+- Execution Mode: Automatic
 - Notes in context: 200-300
 - Tags in context: 100
-- Consider using Claude Opus 4 for complex queries
 
-### For Quick Tasks
-- Model: Claude 3.5 Haiku
+### For Budget-Conscious Users
+- Execution Mode: Economic
 - Max tokens: 2048
+
+### For Critical Work
+- Execution Mode: Maximum Quality
+- Max tokens: 8192