opencode-browser-tool-installer/docs/PLAN_CIERRE_INSTALABLE.md

Plan de cierre - Instalable v1

Objetivo: dejar opencode-browser-tool listo para puesta en marcha facil en otro PC con OpenCode, sin rutas fijas.

Orden de ejecucion acordado

1. Ejecutar una prueba funcional final (smoke de aceptacion).
2. Cerrar empaquetado/instalacion portable para Linux.
3. Ejecutar validacion en entorno limpio con checklist.
4. Documentar estado final y criterios de cierre v1.

Alcance de cierre (Linux primero)

• Instalacion robusta con install.sh + verificaciones claras.
• Configuracion MCP sin rutas hardcodeadas.
• Defaults seguros por maquina (testing por defecto, perfil persistente opcional).
• Soporte de rutas variables:
  • directorio del proyecto
  • binario de navegador del sistema
  • ruta de perfil persistente
  • ubicacion de OpenCode
• Guia de arranque para operario en equipo nuevo.

Checklist tecnico de empaquetado

• install.sh:
  • valida node y npm
  • instala dependencias
  • compila TypeScript
  • instala navegador testing de Playwright
  • emite mensaje final de estado
• check.sh:
  • valida build
  • valida carga de config
  • valida arranque basico MCP
• Plantilla MCP:
  • sin rutas absolutas fijas
  • instrucciones para reemplazar path local en cada PC
• Configuracion runtime:
  • perfil persistente configurable por ruta local
  • navegador system opcional por ruta local

Validacion en entorno limpio

Usar como referencia operativa:

• docs/VALIDACION_ENTORNO_LIMPIO.md

Criterio de aceptacion:

• instalacion completa sin error
• MCP conectado en OpenCode
• prueba minima de apertura/navegacion/snapshot
• prueba Google objetivo completable

Nota sobre Windows (evaluacion pendiente)

La v1 se cierra primero en Linux. Despues se evaluara soporte Windows con enfoque cross-platform (scripts npm + Node).