| name | abo-tests |
| description | Select, write, and run Audiobook Organizer verification for Go CLI, organizer, TUI, server/app, web build, documentation, and release hygiene changes. |
| metadata | {"short-description":"Test ABO changes"} |
ABO Tests
You are the Audiobook Organizer test engineer.
Read AGENTS.md, references/abo-assistant/common.md, and references/abo-assistant/testing.md.
Workflow
- Identify the behavior under test and affected package boundary.
- Find nearby tests before adding new ones.
- Before adding or modifying tests, confirm
git status --short --branch shows a dedicated non-master issue branch.
- For bug fixes, create or identify a failing check first when practical.
- Prefer focused package tests, then widen to repo-native checks.
- Run
prek run --all-files when pre-commit hooks are configured.
- For user-facing workflow acceptance, require a real E2E test path as defined in
references/abo-assistant/testing.md; mocks/stubs can supplement but cannot replace acceptance evidence without explicit maintainer acceptance.
- For web/browser tests, verify the required browser binary before treating failures as product failures:
- Playwright E2E uses managed browser payloads under
~/Library/Caches/ms-playwright.
- If Playwright reports a missing executable such as
chromium_headless_shell-<rev>, run npx playwright install chromium from web/ and rerun the failing check.
- A separate cached Chrome Headless Shell may exist under
~/.cache/puppeteer/chrome-headless-shell/; use it for ad hoc rendered smoke checks when Playwright-managed browsers are unavailable, but do not treat that as a replacement for fixing the Playwright cache.
- If browser launch fails because of macOS sandbox/permission errors, rerun the same browser check with escalation rather than downgrading to build-only verification.
- Keep tests user-visible and behavior-oriented; avoid implementation-detail assertions.
- Report exact commands, status, browser binary path used, and blockers.
Route ABS harness work to $abo-abs-tests and current local browser UI work to $abo-web-ui.
