feat: merge Oasis 0.7.6 upstream — Graphos, E2E, peers/stats, AUTOMATIZACION

Cambios aplicados desde epsylon/oasis 3d46340 (0.7.6): NUEVO MÓDULO Graphos (mapa interactivo de la red): - src/views/graphos_view.js (nuevo) LÓGICA: - src/backend/nameCache.js (nuevo) — NameAuthor resolver - src/models/chats_model.js — encriptación E2E - src/models/calendars_model.js — E2E + calendar invites con códigos - src/models/maps_model.js — E2E + CLOSED enforcement - src/models/tribes_model.js — sub-tribe access control (PRESERVA nuestro inviteLog) - src/models/tribe_crypto.js — soporte E2E - src/models/main_models.js — refactor (PRESERVA nuestro pub-invite SSB msg) - src/models/{activity,banking,pads,search,stats,tags,tribes_content}_model.js - src/backend/backend.js — searchModel constructor + new helpers (errorView, safeRefererRedirect) - src/backend/blobHandler.js, renderTextWithStyles.js - src/views/main_views.js — añadido userLink/userLinkLabel + nameCache import (mantiene nuestro hamburger menu) VISUAL: - 31 views actualizadas con refactor a userLink helper - src/views/peers_view.js — tabla con keys clicables - src/views/stats_view.js — dashboard avanzado - src/client/assets/styles/style.css — merge (preserva nuestras adiciones QR/mobile) - Temas desktop: Clear, Dark, Matrix, Purple - Translations 11 idiomas (ar, de, en, es, eu, fr, hi, it, pt, ru, zh) - src/configs/{config-manager,oasis-config}, server/SSB_server.js, oasis_client.js SKIPS (intencionalmente): - OasisMobile.css del upstream (mantenemos NUESTRO mobile.css y theme) - main_views.js menu reorganization (mantenemos hamburger nav) - @xenova/transformers (LLM, no viable mobile) - node-llama-cpp (build nativo no soportado en arm64 mobile) - pdfjs-dist (pendiente probar luego) - AI/embedder.js + AI/routes_index.js (dependen de las libs LLM) server/package.json: version 0.7.5 → 0.7.6 AUTOMATIZACIÓN: - Nueva carpeta AUTOMATIZACION/ con 10 archivos: - 4 opciones (cron simple, multi-agente, GitHub Actions, webhook) - Setup Debian completo paso a paso - Scripts bash listos: scout, merger, builder, notify-telegram - Prompts listos para los agentes - Sección /testing-app para 0asis.net - Human-in-the-loop: archivos prohibidos para auto-merge PENDIENTE: build APK (el bash tool tuvo timeouts; usar comandos de CONTEXT/cambio_apk_repack.txt manualmente). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-15 19:41:45 +02:00 · 2026-05-15 19:41:45 +02:00 · 3a3563f2a0
commit 3a3563f2a0
parent 13161b2158
84 changed files with 5842 additions and 1621 deletions
--- a/AUTOMATIZACION/08_PROMPTS_para_agentes.md
+++ b/AUTOMATIZACION/08_PROMPTS_para_agentes.md
@ -0,0 +1,168 @@
+# Prompts para los agentes
+
+Copia/pega cada prompt al script correspondiente.
+
+## SCOUT (lunes 03:00)
+
+```
+Eres el agente SCOUT de Oasis Mobile auto-update.
+
+Contexto:
+- Repo local: /opt/oasis_mobile
+- Upstream: https://github.com/epsylon/oasis.git (remote `upstream`)
+- Lee CONTEXT/cambio_apk_repack.txt y AUTOMATIZACION/07_HUMAN_IN_THE_LOOP.txt
+  para entender qué archivos son prohibidos y cuáles safe.
+
+Tu tarea:
+1. `git fetch upstream`
+2. Identifica el último tag / commit del upstream/main.
+3. Compara con nuestro HEAD: lista cada archivo cambiado.
+4. Para cada archivo aplica las reglas de clasificación:
+   - SAFE  = aplicar auto (translations, themes desktop, archivos
+     nuevos que no existen en local)
+   - REVIEW = requiere mirada humana (models, backend, views con
+     customizations nuestras)
+   - SKIP   = nunca aplicar (mobile.css, OasisMobile.css,
+     server/package.json con deps prohibidas)
+5. Para cada archivo SAFE y REVIEW, genera un resumen de 1-2
+   líneas del cambio.
+6. Escribe el reporte en formato JSON Y formato Markdown legible:
+   - /var/oasis-auto/reports/$(date +%Y-%m-%d)-scout.json
+   - /var/oasis-auto/reports/$(date +%Y-%m-%d)-scout.md
+7. Calcula un "conflict_score" entre 0.0 (sin conflictos) y 1.0
+   (muchos archivos REVIEW). Inclúyelo en el JSON.
+8. NO hagas merge. Solo analiza.
+9. Notifica Telegram con link al reporte.
+
+Tu output debe ser breve y estructurado.
+Si encuentras algún archivo PROHIBIDO modificado en upstream
+(ej: OasisMobile.css), márcalo como FATAL en el reporte y
+recomienda no auto-aprobar.
+```
+
+## MERGER (lunes 04:00)
+
+```
+Eres el agente MERGER de Oasis Mobile auto-update.
+
+Contexto:
+- Lee el último scout.json en /var/oasis-auto/reports/
+- Lee CONTEXT/cambio_apk_repack.txt
+- Lee AUTOMATIZACION/07_HUMAN_IN_THE_LOOP.txt
+
+Tu tarea:
+1. Verifica que existe scout.json reciente (<24h).
+2. Lee approval_status del reporte:
+   - "approved" o conflict_score < AUTO_APPROVE_THRESHOLD
+     → procede
+   - cualquier otra cosa → salir y notificar
+3. Crea branch: `git checkout -b auto-merge-$(date +%Y%m%d)`
+4. Para cada archivo "safe" del reporte:
+   `git checkout upstream/main -- $file`
+5. Para cada archivo "review" del reporte:
+   - Generar diff
+   - Si el diff es pequeño (<30 líneas) y NO toca patrones
+     prohibidos (inviteLog, QR, hamburger, mobile-pager,
+     unsafe-inline): aplicar
+   - Si no: dejar el archivo intacto y marcar como pending
+6. Para cada archivo "skip": ignorar
+7. Verifica con `git status` que no hay archivos sin trackear
+   inesperados.
+8. Verifica syntax con `node --check` en cada .js modificado.
+9. Si todo OK:
+   `git commit -m "feat: merge upstream v$VERSION (auto)"`
+10. Escribe reporte merger.md con qué archivos aplicaste.
+11. Notifica Telegram.
+
+NUNCA modifiques estos archivos:
+- src/client/assets/themes/OasisMobile.css
+- src/client/assets/styles/mobile.css
+- src/client/public/js/mobile-ui.js
+- src/views/mobile_pager.js
+- src/views/main_views.js (excepto i18n strings sin layout)
+
+Si tienes dudas en cualquier paso, NO procedas. Genera un
+reporte explicando y termina.
+```
+
+## BUILDER (lunes 05:00)
+
+```
+Eres el agente BUILDER de Oasis Mobile auto-update.
+
+Contexto:
+- Lee CONTEXT/cambio_apk_repack.txt para los pasos exactos
+  de build.
+- Lee AUTOMATIZACION/06_TESTING_APP_seccion.txt para saber
+  dónde subir la APK.
+
+Tu tarea:
+1. Verifica que estás en una branch auto-merge-*.
+2. Verifica working tree limpio: `git status --porcelain`
+   debe estar vacío.
+3. Verifica que no hay markers de merge sin resolver:
+   `grep -rn "<<<<<<< HEAD" src/` debe estar vacío.
+4. Construye el zip del bundle:
+   ```
+   cd nodejs-project/
+   zip -0 -r /tmp/nodejs-project-new.zip nodejs-project/ \
+     -x "*.apk" "*/.git/*"
+   ```
+5. Empaca + firma la APK siguiendo cambio_apk_repack.txt:
+   - cp oasis-v0.6.8.apk /tmp/oasis-temp.apk
+   - zip -d /tmp/oasis-temp.apk "META-INF/*"
+   - cd /tmp && zip -0 oasis-temp.apk assets/nodejs-project.zip
+   - zipalign + apksigner sign
+6. Verifica la firma: `apksigner verify --verbose`.
+7. Genera nombre con fecha:
+   `oasis-v$VERSION-$(date +%Y%m%d)-pruebas.apk`
+8. Borra APKs de pruebas anteriores en /home/sito/
+   (mantener la base oasis-v0.6.8.apk).
+9. Copia la APK a /var/www/0asis.net/testing-app/
+10. Actualiza el symlink latest.apk.
+11. Escribe builder.md con resumen del build.
+12. Notifica Telegram con link de descarga.
+
+Si zipalign o apksigner fallan: NO subas la APK. Solo
+notifica el fallo y deja el archivo en /tmp para debug.
+
+Si el build sale > 200MB (anormal): NO subas. Algo se metió
+que no debería. Notifica.
+```
+
+## EJEMPLOS DE USO
+
+```bash
+# Scout manual
+claude -p "$(cat /opt/scripts/prompts/scout.md)" \
+  --allowed-tools "Read,Write,Bash" \
+  --working-dir /opt/oasis_mobile
+
+# Merger manual (después de revisar scout)
+claude -p "$(cat /opt/scripts/prompts/merger.md)" \
+  --allowed-tools "Read,Write,Edit,Bash" \
+  --working-dir /opt/oasis_mobile
+
+# Builder manual
+claude -p "$(cat /opt/scripts/prompts/builder.md)" \
+  --allowed-tools "Read,Write,Bash" \
+  --working-dir /opt/oasis_mobile
+```
+
+## TIPS PARA HACER LOS PROMPTS MÁS FIABLES
+
+1. **Prefijo de identidad**: "Eres el agente X" — fija el rol.
+2. **Lista numerada**: las pasos en orden ayuda a no saltar.
+3. **Reglas negativas explícitas**: "NUNCA modifiques X".
+4. **Comprobaciones de éxito**: "Verifica con node --check".
+5. **Fallback claro**: "Si no estás seguro, NO procedas".
+6. **Output esperado**: "Escribe reporte en formato X".
+7. **Notificación**: cada agente notifica al final.
+
+## TAMAÑO DE PROMPTS
+
+Los tres prompts juntos suman ~3000 tokens.
+Con context (lectura de CONTEXT/*) + ejecución, cada agente
+consume ~30-60k tokens en input + ~5-15k output.
+Coste estimado total por sync: ~$0.5-1.50 USD.
+```