feat(episode): TRAZA_r2seccion-finall1-entrega-manual-plas_S20260525.R3_XX.ops.2.hot_inf.in.cc.es.000.MGQ_J.PMCFK_E.SGNFD

Skill: FORJA | Type: troubleshooting
Summary: EPISODIO 3 — brasaluz.com: 🏁 [R2.seccion-final.L1] Entrega — Manual + plasmación
This commit is contained in:
Ember 2026-05-25 14:40:20 +00:00
parent 9371f92e60
commit 613b553bfb

View file

@ -0,0 +1,69 @@
---
episode_id: "527dc505-ce4b-4220-814f-8576e7269857"
puente_flat: "TRAZA_r2seccion-finall1-entrega-manual-plas_S20260525.R3_XX.ops.2.hot_inf.in.cc.es.000.MGQ_J.PMCFK_E.SGNFD"
session_code: "S20260525.DASHBOARD_GRAFICOS_EXPANSION"
acto_dialogico: "informar"
actor_flujo: "multi_actor"
criticidad_aegis: "low"
skill_dominante: "FORJA"
fase_proyecto: "operations"
tipo_semantico: "troubleshooting"
summary_one_line: "EPISODIO 3 — brasaluz.com: 🏁 [R2.seccion-final.L1] Entrega — Manual + plasmación cross-"
source_type: "claude_code"
trust_boundary: "internal"
created_at: "2026-05-25T14:40:14.092288+00:00"
relectura_tagged: false
forgejo_commit_sha: "pending"
---
🎉 **PUSH TRIPLE-REMOTO EXITOSO** commit `0802b98` (5 files, +917 insertions):
- origin: `c35c59e..0802b98`
- forgejo: `c35c59e..0802b98`
- sriyantra: `c35c59e..0802b98`
## 🏁 [R2.seccion-final.L1] Entrega — Manual + plasmación cross-instance completada
### Archivos entregados R2
📂 **Manual maestro (ARIADNA AR-1 path estable):**
- [docs/MANUAL_PUBLICACION_MARIMO_SERVIDOR_MEMORIA.md](docs/MANUAL_PUBLICACION_MARIMO_SERVIDOR_MEMORIA.md) — 900 líneas, 15 secciones, 6 pasos, pitfalls, troubleshooting
📂 **4 anclajes cross-instance editados:**
- [docs/TOOLBOX.md](docs/TOOLBOX.md) — sección MARIMO publicación + 6 pasos resumen
- [skills/marimo-render/CLAUDE.md](skills/marimo-render/CLAUDE.md) — blockquote referencia manual
- [INFRA_MANIFEST.yaml](INFRA_MANIFEST.yaml) — campo `marimo.publication_manual` con metadata
- [correos-entre-instancias/categorias/hooks-y-state/ACTIVO.md](correos-entre-instancias/categorias/hooks-y-state/ACTIVO.md) — declaración R2
### Verificación cross-instance (5 capas)
Esperado **≥5 referencias** desde paths independientes → cualquier instancia futura encuentra el manual.
### Knowledge cristalizado (5 iteraciones R47-R51)
| Iteración | Síntoma observado | Root cause | Fix documentado en manual |
|-----------|-------------------|-----------|----------------------------|
| R48 v1 | counts=-1 | PEP 723 deps no auto-install | §10.1 — usar deps preinstalados + urllib |
| R49 v2 | gráficos no rendean | Container read-only fs `pip install` fail | §10.2 — workaround urllib REST + api-key |
| R50 v3 | SyntaxError parser marimo | Early bare `return` en cells | §10.4 — eliminar early returns + perspectives simultáneas |
| R51 ya funciona | — | — | §1 resumen ejecutivo |
| R1 expansion | Faltaban ángulos | Solo 5/49 gráficos VIZ-PUBLICATION usados | §13 arsenal completo + ejemplo 7 nuevos |
### Estructura manual (15 secciones)
1. **Resumen ejecutivo** — qué es marimo + cuándo usar
2. **Arquitectura** — flujo cliente Ember-CC-Local → servidor MEMORIA → render.brasaluz.com
3. **Pre-requisitos** — verificación container + secrets + MCP tools
4. **Paso 1** — Crear notebook local con estructura canónica + frontmatter NOMENCLATURA
5. **Paso 2** — Verificar AST + Python compile local
6. **Paso 3** — SFTP upload servidor MEMORIA (path `/home/johnember/data/interactive_notebooks/`)
7. **Paso 4** — Deploy gallery (`docker exec cp /workspace/.compiled/`)
8. **Paso 5** — Verificar gallery + marimo logs limpios + LIVE queries
9. **Paso 6** — Commit + push triple-remoto BLINDADA-29
10. **Pitfalls comunes** — 6 trampas + workarounds (PEP 723 / read-only fs / hostnames / early returns / D3 protocol / BITÁCORA)
11. **Troubleshooting** — 5 síntomas + diagnósticos + fixes
12. **Convenciones nomenclatura** — VP-26-SP_<sprint>-NN-<slug> + frontmatter YAML N-14
13. **Arsenal gráficos** — VIZ-PUBLICATION 49 (16 familias A-P) + PRISMA-VIZ 12 métodos + Selector v3.0
14. **Anti-patrones marimo** — M-AP1..M-AP8 con ejemplos correcto/incorrecto
15. **Plasmación cross-instance** — 5 capas + verificación grep
### Commits sesión R34-R2 (8 commits totales)