Bugno CLI

CLI para usar Bugno desde tu repo: comprobar entorno, inicializar config y AGENTS.md, y ejecutar REPRO por ticket.

¿A qué se conecta el CLI?

El CLI se conecta a la app Bugno (este repo: la app Next.js de tickets). Esa app es la API: no hay un “BugNo Cloud API” separado. La misma app que ves en el navegador expone las rutas /api/tickets, /api/tickets/generate-test, etc.

• BUGNO_API_URL → URL donde está corriendo esta app Bugno (por ejemplo http://localhost:3000 si hacés bun run dev en el repo Bugno).
• Si tenés otro proyecto (por ejemplo un dashboard de reportes de Playwright/Maestro), ese no es la API de Bugno. El CLI debe apuntar a la instancia de la app Bugno (este repo), no a ese dashboard.

Instalación

Desde el monorepo:

cd packages/cli && npm link

Desde otro repo (cuando se publique):

npm i -g bugno-cli
# o
bunx bugno doctor

Requisitos

• Node >= 18 (o Bun).
• Playwright en el repo bajo test: el CLI ejecuta el REPRO en ese repo, por lo que necesitás @playwright/test instalado y Chromium (npx playwright install chromium).

Variables de entorno

• BUGNO_API_URL: URL de la app Bugno (tickets y API). Solo desde env; no se lee de .bugno/config.json. Default: http://localhost:3000. Si Bugno está desplegado, usá la URL que te dé tu equipo.
• BUGNO_BASE_URL: URL de tu app bajo test (para E2E). Opcional: se puede usar .bugno/config.json (baseUrl) o el valor que trae el ticket (base_url).

La API acepta el header X-User-Id para devolver solo tickets de proyectos del usuario (útil en desarrollo; en el futuro se usará sesión).

Comandos

| Comando | Descripción | |--------|-------------| | bugno doctor | Comprueba Playwright, Chromium, base URL y AGENTS.md. No bloquea; muestra advertencias y remediación. | | bugno init | Pide base URL (opcional), crea .bugno/config.json y copia .bugno/AGENTS.md. --force para sobrescribir. | | bugno run <ticket-id> | Obtiene el ticket, resuelve base URL y ejecuta REPRO: page.goto(baseUrl), login (si hay username/password), y pasos del ticket. Resultado: REPRODUCED / NOT_REPRODUCED / FAILED. | | bugno tickets | Lista 10 tickets por prioridad, elegís uno y se genera test + fix con IA (máx. 2 intentos de fix). | | bugno config | Muestra BUGNO_API_URL, BUGNO_BASE_URL y si existe config local. |

Uso típico

1. En el repo bajo test: bugno init (opcional pero recomendado).
2. Asegurá que la app Bugno esté levantada y que BUGNO_API_URL apunte a ella (o usá el default).
3. bugno doctor para verificar el entorno.
4. bugno run <uuid-del-ticket> para ejecutar el REPRO.

La IA (generación de test y fix) corre en el servidor Bugno; no necesitás API keys de IA en tu máquina.