[ADN] Fase 10: Saneamiento y Consolidación - Un solo punto de verdad

- S1: Eliminar 'triggers' duplicado en run (líneas 109/131) - S2: Eliminar cli/commit.rb (truncado, sin uso) - S3: Eliminar cli/inicio.rb y cli/cierre.rb (legacy, jornada.rb los reemplaza) - S4: Mover 4 planes obsoletos de docs/plan/adn/ a docs/_hist/plan/adn/ - S5: Mover 14 backups de planes y 3 docs técnicos a docs/_hist/ - S6: Eliminar manifiesto vacío P2604_proyecto_p2604.md - S7: Corregir referencia a plan obsoleto en run - S8: Dejar de cargar core/validador.rb obsoleto en run - S9: Limpiar progreso duplicado en P2604_mejoras_ADN.md - Agregar Fase 10 al plan P2604 con 10 tareas - Un solo punto de verdad: adn/README.md - Un solo plan: docs/proy/p2604_mejoras_ADN/P2604_mejoras_ADN.md - Registro en bitácora: evento 1073
2026-03-15 14:33:32 -03:00
parent b13a389568
commit cfd0e8452a
36 changed files with 1563 additions and 238 deletions
@@ -0,0 +1,73 @@
+# Integración MSP-ADN
+
+> Documento de integración entre MSPs (NotebookLM) y el flujo de trabajo ADN
+
+## Estado
+
+| Componente | Estado |
+|------------|--------|
+| MCPs configurados | ✅ 3 activos |
+| Ejecutable NotebookLM | ✅ Existe |
+| Autenticación | ✅ Configurada |
+| Herramienta CLI | ✅ Implementada |
+
+## Herramientas CLI
+
+### `msp auditar`
+Verifica el estado de conexión con NotebookLM MCP.
+
+```bash
+./adn/tools/run msp auditar
+```
+
+**Salida:**
+- MCPs configurados
+- Ejecutable NotebookLM
+- Estado de autenticación
+- MSPs locales encontrados
+
+### `msp listar`
+Lista MSPs disponibles en el proyecto.
+
+```bash
+./adn/tools/run msp listar
+```
+
+### `msp registrar`
+Registra un MSP descargado en el sistema.
+
+```bash
+./adn/tools/run msp registrar --archivo /ruta/al/msp.md --titulo "Título"
+```
+
+## Limitaciones
+
+El MCP de NotebookLM **NO** incluye herramienta para generar MSPs. Los MSPs deben generarse desde la UI web:
+
+1. Ir a https://notebooklm.google.com
+2. Crear/abrir un cuaderno con fuentes
+3. Click en "More" → "Generate MSP"
+4. Descargar y guardar en `docs/mcps/`
+5. Registrar con `./adn/tools/run msp registrar --archivo <ruta>`
+
+## Flujo de Trabajo
+
+```
+┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
+│ NotebookLM UI  │────▶│ Descargar MSP   │────▶│ Registrar en ADN│
+└─────────────────┘     └─────────────────┘     └─────────────────┘
+                                                      │
+                                          ./adn/tools/run msp registrar
+                                                      │
+                                                      ▼
+                                         ┌─────────────────────────┐
+                                         │ docs/mcps/*.md         │
+                                         │ Asimilar como conocimiento│
+                                         └─────────────────────────┘
+```
+
+## Referencias
+
+- Configuración MCP: `~/.gemini/antigravity/mcp_config.json`
+- Documentación general: `docs/mcps/MSPs-Antigravity.md`
+- CLI herramientas: `adn/tools/cli/msp.rb`
@@ -0,0 +1,218 @@
+# MSPs en Antigravity - Guía de Referencia
+
+## ¿Qué son los MSPs?
+
+Los **MSP (Markdown Style Papers)** son documentos generados por NotebookLM en formato de paper académico con:
+- Título y autores
+- Resumen estructurado
+- Secciones temáticas
+- Citas y referencias
+- Formato académico profesional
+
+## MCPs Actualmente Configurados en Antigravity
+
+Archivo de configuración: `~/.gemini/antigravity/mcp_config.json`
+
+### 1. NotebookLM MCP
+
+```json
+"notebooklm": {
+  "command": "bash",
+  "args": ["-c", "/home/rmonla/.local/share/notebooklm-mcp/bin/notebooklm-mcp"],
+  "env": {},
+  "disabled": false
+}
+```
+
+| Campo | Valor |
+|-------|-------|
+| Tipo | MCP Server (stdio) |
+| Ejecutable | `/home/rmonla/.local/share/notebooklm-mcp/bin/notebooklm-mcp` |
+| Estado | Habilitado |
+| Soporta MSP | **No** (solo desde UI web) |
+
+### 2. Firebase MCP Server
+
+```json
+"firebase-mcp-server": {
+  "command": "npx",
+  "args": ["-y", "firebase-tools@latest", "mcp"],
+  "env": {},
+  "disabled": false
+}
+```
+
+| Campo | Valor |
+|-------|-------|
+| Tipo | MCP Server (npx) |
+| Paquete | `firebase-tools@latest` |
+| Estado | Habilitado |
+| Herramientas | Auto-detección basada en firebase.json |
+
+**Herramientas disponibles** (según contexto del proyecto):
+- Core: deploy, init, login, logout, projects:list
+- Firestore: firestore:indexes, firestore:rules
+- Hosting: hosting:deploy
+- Functions: functions:deploy
+- Storage: storage:rules
+
+### 3. Google Stitch MCP
+
+```json
+"stitch": {
+  "serverUrl": "https://stitch.googleapis.com/mcp",
+  "headers": {
+    "X-Goog-Api-Key": "AQ.Ab8RN6KSXqPMkt6b6-l9-fOF_L6MFDobit1k2uCZark0orUM0g"
+  }
+}
+```
+
+| Campo | Valor |
+|-------|-------|
+| Tipo | HTTP MCP Server |
+| URL | `https://stitch.googleapis.com/mcp` |
+| Estado | Habilitado |
+| API Key | Configurada |
+
+### Verificar MCPs configurados
+
+```bash
+# Ver configuración actual
+cat ~/.gemini/antigravity/mcp_config.json | jq '.mcpServers | keys'
+
+# Probar cada MCP
+~/.local/share/notebooklm-mcp/bin/notebooklm-mcp --transport http --port 8765
+npx -y firebase-tools@latest mcp --help
+```
+
+## Configuración de NotebookLM MCP
+
+### Verificar conexión
+
+```bash
+# 1. Verificar ejecutable
+ls -la ~/.local/share/notebooklm-mcp/bin/notebooklm-mcp
+
+# 2. Probar inicio del servidor
+~/.local/share/notebooklm-mcp/bin/notebooklm-mcp --transport http --port 8765
+
+# 3. Verificar en Antigravity
+# Abrir "Manage MCP servers" → buscar "notebooklm" → estado "conectado"
+```
+
+### Autenticación
+
+```bash
+# Ejecutar autenticación via navegador
+notebooklm-mcp-auth
+
+# O configurar manualmente con variables de entorno
+export NOTEBOOKLM_COOKIES="..."
+export NOTEBOOKLM_CSRF_TOKEN="..."
+export NOTEBOOKLM_SESSION_ID="..."
+```
+
+### Ubicaciones importantes
+
+| Recurso | Ruta |
+|---------|------|
+| Executable | `~/.local/share/notebooklm-mcp/bin/notebooklm-mcp` |
+| Auth cache | `~/.notebooklm-mcp/auth.json` |
+| Logs | `~/.config/Antigravity/logs/` |
+| Config MCP | `~/.gemini/antigravity/mcp_config.json` |
+
+## Herramientas MCP Disponibles (32 herramientas)
+
+### Notebooks
+- `notebook_create` - Crear nuevo cuaderno
+- `notebook_list` - Listar cuadernos
+- `notebook_get` - Obtener cuaderno
+- `notebook_delete` - Eliminar cuaderno
+- `notebook_rename` - Renombrar cuaderno
+- `notebook_add_text` - Añadir texto
+- `notebook_add_url` - Añadir URL
+- `notebook_add_drive` - Añadir archivo de Drive
+- `notebook_query` - Consultar cuaderno
+
+### Fuentes
+- `source_get_content` - Obtener contenido
+- `source_delete` - Eliminar fuente
+- `source_describe` - Describir fuente
+- `source_list_drive` - Listar archivos de Drive
+- `source_sync_drive` - Sincronizar Drive
+
+### Studio (generación de contenido)
+- `audio_overview_create` - Audio overview
+- `video_overview_create` - Video overview
+- `slide_deck_create` - Presentación
+- `infographic_create` - Infografía
+- `flashcards_create` - Tarjetas
+- `quiz_create` - Cuestionario
+- `mind_map_create` - Mapa mental
+- `data_table_create` - Tabla de datos
+- `report_create` - Reporte
+
+### Investigación
+- `research_start` - Iniciar investigación
+- `research_status` - Estado de investigación
+- `research_import` - Importar investigación
+
+## IMPORTANTE: MSPs no están en el MCP
+
+**Limitación**: El MCP de NotebookLM NO incluye herramienta para generar MSP.
+
+### Cómo generar un MSP manualmente
+
+1. **Ir a**: https://notebooklm.google.com
+2. **Crear/abrir** un cuaderno con fuentes
+3. **En el cuaderno**, hacer clic en **"More"** (tres puntos)
+4. Seleccionar **"Generate MSP"** o **"Create paper"**
+5. Esperar generación y descargar
+
+### Alternativas para automatizar
+
+- Usar la API de Google NotebookLM (si está disponible)
+- Integrar con Vertex AI para generación de documentos
+- Crear custom skill en Antigravity que use la web
+
+## Verificar estado de conexión en código
+
+```python
+import subprocess
+import json
+
+def check_notebooklm_mcp():
+    # Verificar ejecutable existe
+    result = subprocess.run(
+        ["ls", "-la", "/home/rmonla/.local/share/notebooklm-mcp/bin/notebooklm-mcp"],
+        capture_output=True
+    )
+    
+    if result.returncode != 0:
+        return {"status": "error", "message": "Executable not found"}
+    
+    # Verificar auth
+    with open("/home/rmonla/.notebooklm-mcp/auth.json") as f:
+        auth = json.load(f)
+    
+    has_auth = bool(auth.get("cookies") and auth.get("csrf_token"))
+    
+    return {
+        "status": "ok" if has_auth else "needs_auth",
+        "auth": auth
+    }
+```
+
+## Troubleshooting
+
+| Problema | Solución |
+|----------|----------|
+| MCP no aparece conectado | Reiniciar Antigravity |
+| Error de autenticación | Ejecutar `notebooklm-mcp-auth` |
+| No hay herramientas disponibles | Verificar tokens en `~/.notebooklm-mcp/auth.json` |
+| Timeout en requests | Aumentar `NOTEBOOKLM_QUERY_TIMEOUT` |
+
+## Referencias
+
+- Docs MCP: `docs/promp/Configuracion-MCP-Antigravity.md`
+- Prompt NotebookLM: `docs/promp/Prompt NotebookLM MCP X Antigravity.md`