메뉴
Run and fix E2E tests in a loop for the ebookarr project. Use when the user asks to run E2E tests, fix failing tests, or says "run tests until they pass". Knows common failure modes: Anna's Archive DNS, Selenium Firefox download dir, Gmail app password, ISBN extraction.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Read and interpret ebookarr production logs to debug stuck jobs, pipeline failures, and service issues. Use when investigating a bug using logs, a user reports a job not completing, or when asked to check what happened to a specific request.
Create distinctive, production-grade frontend interfaces with high design quality, and adapt them to this repo's static Alpine.js + Supabase session architecture. Use when building or refining `static/index.html`, improving UI polish, or implementing frontend auth/session flows.
Execute attached plan documents in this repo while keeping existing TodoWrite items synced. Use when the user says to implement an attached `.plan.md` as specified, not edit the plan file, avoid recreating todos, and work through the plan end to end.
| name | run-e2e-tests |
| description | Run and fix E2E tests in a loop for the ebookarr project. Use when the user asks to run E2E tests, fix failing tests, or says "run tests until they pass". Knows common failure modes: Anna's Archive DNS, Selenium Firefox download dir, Gmail app password, ISBN extraction. |
uv run pytest -m e2e -v 2>&1 | tee /tmp/test-output.txt
E2E tests are slow (10–25 minutes each run due to Selenium). Read test output from /tmp/test-output.txt while they run.
When asked to run and fix until passing:
Symptom: aiohttp.ClientConnectorError or DNS lookup failure for annas-archive.*
Fix: The server auto-selects a healthy mirror at startup from settings.annas_archive_mirrors. If all mirrors are down, reorder or add working mirrors in config.py and restart.
Symptom: Test waits forever for file in settings.download_dir, file appears in ~/Downloads or ~
Fix: Ensure Firefox options include:
options.set_preference("browser.download.folderList", 2)
options.set_preference("browser.download.dir", settings.download_dir)
options.set_preference("browser.helperApps.neverAsk.saveToDisk",
"application/epub+zip,application/pdf,application/octet-stream")
driver.close() causing 120-second timeoutSymptom: Test hangs exactly 120 seconds after the download finishes
Fix: Replace driver.close() with driver.quit()
535 Username and Password not acceptedSymptom: EmailDeliveryError / SMTP auth failure
Fix: The Gmail app password has expired. The user must generate a new one at myaccount.google.com → Security → App passwords. Then update GMAIL_PASSWORD in .env.
Symptom: get_book_info returns an isbn like 1738790966 (looks like a Unix timestamp)
Fix: Ensure get_book_info extracts from JSON-LD structured data first, before falling back to regex on raw HTML. Regex can match image URL timestamps. Check the JSON-LD loop in get_book_info in download_flow.py.
Symptom: FileNotFoundError when Selenium tries to download
Fix: Add os.makedirs(settings.download_dir, exist_ok=True) before creating the driver
E2E tests require these .env values:
TEST_GOODREADS_URL — a real Goodreads book URLTEST_KINDLE_EMAIL — real Kindle email to send toGMAIL_PASSWORD — valid Gmail app passwordbooks.log for failuresThe app logs via @log_call decorator. Each function logs its arguments on entry and its result on exit. To trace a failed request:
tail -100 books.log | grep -A5 "get_book_info\|search_aa_all_formats\|download"