SnapOtter/tests/baseline/QUARANTINE.md

# Quarantine List (Phase 4b)

Phase 4b serial-bucket cleanup. Superseded specs removed, quick-win route/auth
fixes applied, intractable specs quarantined with `test.skip()`.

## Removed (superseded by Phase 3 device-emulated specs)

| Spec | Tests | Reason |
|------|-------|--------|
| `gui-visual-mobile.spec.ts` | 27 | Superseded by `device-mobile.spec.ts` (real Pixel 7 / iPhone 14 emulation). Used bare routes that 404 on prod preview. |
| `gui-visual-tablet.spec.ts` | 27 | Superseded by `device-tablet.spec.ts` (real iPad / Galaxy Tab emulation). Same bare-route issue. |
| `gui-responsive.spec.ts` | 82 | Superseded by `device-mobile.spec.ts` + `device-tablet.spec.ts`. All responsive chrome, overflow, layout tests covered by device specs with real touch/DPR. |

## Repaired

| Spec | Tests | Fix |
|------|-------|-----|
| `rbac.spec.ts` | 5 | Fixed `storageState: "test-results/.auth/user.json"` to `authFile` import from `playwright.config.ts` (path is `.playwright/.auth/user.json`). |
| `settings.spec.ts` | 8 | Same auth-path fix in the skipped `API Keys section has generate button` test. |
| `state-bleed-audit.spec.ts` | 8 | Updated all bare tool routes (`/resize` -> `/image/resize`, `/rotate` -> `/image/rotate`, etc.) to match 2.0 `/:modality/:toolId` routing. |
| `gui-file-carry.spec.ts` | 6 | Same bare-route fix + URL assertions (`toHaveURL("/resize")` -> `toHaveURL("/image/resize")`). |
| `full-session.spec.ts` | 8 | Same bare-route fix for resize, rotate, convert, crop, compress, strip-metadata. |
| `gui-settings-rbac.spec.ts` | 39 (2 with bare routes) | Fixed 2 tests that navigated to `/resize` instead of `/image/resize`. |

## Quarantined (skipped via `test.skip()`)

| Spec | Tests | Reason | Tractability | Follow-up |
|------|-------|--------|--------------|-----------|
| `gui-performance.spec.ts` | 62 | 62 tests use bare tool routes (`/resize`, `/compress`, `/rotate`, etc.) that 404 on the 2.0 prod preview. Mechanical route fix is needed, but the file also references selectors (fullscreen grid search, tool-list layout, sidebar tool entries) that need 2.0 UI verification after route fix. | Medium -- route fix is mechanical, selector verification needs UI run | Phase 4 tail |
| `theme.spec.ts` | 3 | Asserts `button[title='Toggle Theme']` in footer and `Privacy Policy` link visibility. The 2.0 UI hides the footer on mobile viewports and may have changed the theme toggle mechanism. | Low -- 3 tests, needs UI verification | Phase 4 tail |

## Still-running serial specs (not quarantined, expected to pass)

These specs use proper role-based/text-based selectors and the `openSettings()` helper.
They were validated by code review and partial test run:

- `gui-settings-general.spec.ts` (56 tests) -- settings dialog navigation, general tab, system settings, about, AI features, tools deep, analytics, audit log
- `gui-settings-expanded.spec.ts` (77 tests) -- dialog state management, extended settings persistence
- `gui-settings-rbac.spec.ts` (39 tests) -- admin/editor/user role visibility, endpoint verification
- `gui-settings-people.spec.ts` (35 tests) -- people tab CRUD, teams tab, roles tab
- `gui-settings-security.spec.ts` (15 tests) -- change password form, API keys tab
- `gui-settings-apikeys.spec.ts` (15 tests) -- API key generation, scoping, deletion
- `gui-settings-tools.spec.ts` (12 tests) -- tool enable/disable, analytics consent
- `settings.spec.ts` (8 tests) -- basic settings dialog open/close
- `rbac.spec.ts` (5 tests) -- admin/user/editor role tab visibility
- `rbac-full.spec.ts` (8 tests) -- people management, roles, audit log, API key scoping, custom roles
- `people.spec.ts` (15 tests) -- people API CRUD + UI table/search/actions
- `security.spec.ts` (21 tests) -- authentication, session, CSRF, API security
- `api.spec.ts` (20 tests) -- API endpoint tests
- `i18n.spec.ts` (15 tests) -- locale detection, switching, persistence, RTL
- `state-bleed-audit.spec.ts` (8 tests) -- cross-tool state isolation (repaired)
- `full-session.spec.ts` (8 tests) -- end-to-end tool workflows (repaired)
- `gui-file-carry.spec.ts` (6 tests) -- file carry between tools (repaired)

## Local doc-binary skips (not quarantine, informational)

The following integration test files skip cleanly via `describe.skipIf`
because `pandoc`, `libreoffice`/`soffice`, `pdfcpu`, and `pdf2docx` are not
installed on this development machine. These pass in CI where the Docker image
provides all binaries:

- `convert-document.test.ts`
- `epub-convert.test.ts`
- `html-to-pdf.test.ts`
- `doc-to-pdf.test.ts`
- `pdf-to-docx.test.ts`
- `compress-pdf.test.ts`
- `pdf-to-image.test.ts`

Total local integration skips: 217 tests across 7 files.

## Summary

| Category | Files | Tests |
|----------|-------|-------|
| Removed (superseded) | 3 | 136 |
| Repaired (route + auth fixes) | 6 | 74 |
| Quarantined (`test.skip`) | 2 | 65 |
| Running (not quarantined) | 17 | 389 |

65 tests remain quarantined for Phase 4 tail follow-up (mostly the
`gui-performance.spec.ts` bare-route bulk fix + UI verification).