# Validacion en entorno limpio (OpenCode)

Objetivo: verificar que `opencode-browser-tool` puede instalarse y usarse desde cero en una maquina con OpenCode.

## Alcance de la validacion

- Instalacion de dependencias y Chromium gestionado por Playwright.
- Compilacion del servidor MCP.
- Conexion MCP visible para OpenCode.
- Ejecucion de una prueba minima end-to-end.

## Prerrequisitos

- Node.js 20+ y npm.
- OpenCode CLI instalado y funcional.
- Acceso a internet para instalar dependencias y Chromium.

## Pasos

1) Copiar el proyecto completo en una carpeta local, por ejemplo:

```bash
cp -R opencode-browser-tool "$HOME/opencode-browser-tool"
```

2) Instalar:

```bash
cd "$HOME/opencode-browser-tool"
./install.sh
```

Alternativa neutral:

```bash
npm run setup
```

3) Verificacion basica:

```bash
./check.sh
```

4) Configurar MCP para OpenCode con la ruta local real de `dist/server.js`:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "browser-tool": {
      "type": "local",
      "command": [
        "node",
        "/ABSOLUTE/PATH/opencode-browser-tool/dist/server.js"
      ]
    }
  }
}
```

5) Comprobar que OpenCode detecta el MCP:

```bash
opencode mcp list
```

Resultado esperado: `browser-tool` aparece como `connected`.

6) Prueba minima desde OpenCode:

- abrir navegador visible
- navegar a `https://example.com`
- tomar snapshot con label `clean-env-smoke`
- cerrar navegador

7) Verificar artifacts:

- Debe existir una captura en `artifacts/`.

## Criterios de aceptacion

- `install.sh` termina sin error.
- `npm run build` termina sin error.
- `opencode mcp list` muestra `browser-tool` conectado.
- La prueba minima produce screenshot en `artifacts/`.

## Resultado de la ejecucion

Rellenar al completar la validacion real:

- Fecha:
- Equipo/SO:
- Version Node:
- Version OpenCode:
- Resultado: pendiente | ok | fallo
- Evidencia (capturas/logs):
- Notas: