verify

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 4").
  • Generation fires a browser download — grab page.waitForEvent("download") before clicking Generar.
  • Confirmar's optional cover letter/preguntas actions swap the wizard's own body+footer for a takeover (own Cancelar/Guardar) — getByRole("button", { name: "Atrás" }) disappears while one is open; wait on the takeover's own heading (e.g. getByText("Nueva pregunta")) instead of the step counter.

Flows worth driving

• Wizard: card "Nueva aplicación" → step 1 empresa → step 2 opcionales (fork "Registrar sin CV" lives here; canal Email + empty email disables both exits) → 3 idioma/foco → 4 confirmar (code preview + folder). Confirmar's end has two optional cards, "Cover letter" and "Preguntas" — clicking their button silently creates the Borrador row (reusing the code already shown in the folder preview) then opens the same takeover the row detail drawer uses; cancelling out of the cover letter form there does not create a Drive doc or download (no data/cvs/ cleanup needed) as long as you stop before "Generar y entregar".
• 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>/.