---
name: verify
description: How to build, run and drive cv-builder to verify a change end-to-end (dev server, Playwright recipe, data hygiene, cleanup).
---

# Verifying cv-builder changes

## Build / launch

- `npm test` (vitest) and `npm run build` are CI checks — the real surface is
  the web app.
- Dev server: `npm run dev` (port 3000). **Next 16 refuses a second dev server
  for the same dir** — if one is already running (check
  `lsof -nP -iTCP:3000 -sTCP:LISTEN`), drive that one: it hot-reloads the
  working tree, so it already serves your changes.

## Data hygiene (important)

- Local dev uses the user's REAL data: `data/registry.json` (private
  applications) and `data/cvs/`. Create test rows with obviously fake company
  names, then clean up: `curl -X DELETE localhost:3000/api/registry/<code>`
  and `rm -rf data/cvs/<folder>`.
- `.env.local` may have `GDOCS_*` set — a real generation then creates REAL
  Google Docs in the user's Drive. The app cannot delete them; capture
  `driveFolder` from the row before deleting it and tell the user to remove
  the folder manually (or unset the env vars first and restart the server).

## Driving the UI (Playwright)

- Playwright isn't a project dep. A working copy lives in the npx cache:
  `find ~/.npm/_npx -maxdepth 3 -name playwright -type d` → import
  `<that-path>/index.mjs` directly from a scratchpad `.mjs` script
  (NODE_PATH does not work for ESM).
- Selector gotchas:
  - "Empresa" label is ambiguous (table cells carry aria-labels) — use
    `#company`, `#email`, etc.
  - `IconSelect` dropdowns (Canal, Foco…) are DS DropdownMenus: options are
    `getByRole("menuitemcheckbox", { name: ... })`, not `option`.
  - Toasts: `[data-sonner-toast]` filtered by text.
  - Wizard steps: wait on `getByText("Paso N de 5")`.
  - Generation fires a browser download — grab `page.waitForEvent("download")`
    before clicking Generar.

## Flows worth driving

- Wizard: card "Generar un CV" → step 1 empresa → step 2 opcionales (fork
  "Guardar sin CV" lives here; canal Email + empty email disables both exits)
  → 3 idioma/foco → 4 carta → 5 confirmar (code preview) → Generar.
- Pending flow: row shows muted FileClock in Seguimiento; drawer → card
  Entrega → "Generar CV" opens the deferred wizard at step 3 with the
  reserved code.
- Delivery archive: `GET /api/cvs/<folder>/<file>.docx` (200 attachment),
  invalid paths → 400, missing → 404; files land in `data/cvs/<folder>/`.