Congratulations on your new Raycast extension! 🚀

We're currently experiencing a high volume of incoming requests. As a result, the initial review may take up to 10-15 business days.

Once the PR is approved and merged, the extension will be available on our Store.

Greptile Summary

This PR adds a new calibre-search Raycast extension with two commands: Search Calibre (browse/search a Calibre library via direct SQLite access) and Add to Calibre Library (scan configured folders for ebook files and add them via calibredb). The extension includes cover thumbnail extraction for EPUB and PDF files, a comprehensive unit-test suite, and the standard Raycast extension scaffolding.

• Search command reads metadata.db via useSQL, maps rows through a JOIN query that uses ' & ' as the GROUP_CONCAT separator to safely handle "Last, First" author names, and displays book detail with cover, metadata, and actions (open in Calibre, open file, synopsis, copy, show in Finder).
• Add command scans up to three configurable directories for ebook files, renders a filterable list with per-file cover thumbnails, and adds selected books using async calibredb invocation — with a graceful fallback that hands off to the running Calibre GUI when its lock is held.
• Thumbnail loading currently spawns a child process (unzip or qlmanage) for every ebook simultaneously on mount, and the directory scan runs synchronously inside useMemo, both of which can cause noticeable UI lag on large Downloads folders.

Confidence Score: 4/5

Safe to merge after addressing the synchronous scan and unbounded thumbnail spawning in the Add command; the Search command is clean.

The core logic — SQL query, row mapping, calibredb invocation, EPUB cover extraction — is correct and well-tested. The two concerns in add-to-library.tsx (blocking useMemo scan and spawning a process per ebook on mount) are performance/UX issues rather than correctness failures, but they can make the Add command feel frozen or unresponsive on first load with a populated Downloads folder.

extensions/calibre-search/src/add-to-library.tsx — the synchronous directory scan inside useMemo and the unbounded concurrent thumbnail process spawning both warrant a second look before merging.

Important Files Changed

Fix the following 2 code review issues. Work through them one at a time, proposing concise fixes.

---

### Issue 1 of 2
extensions/calibre-search/src/add-to-library.tsx:237-246
**Unbounded concurrent thumbnail processes on load**

`useEffect` calls `loadThumbnail` for every ebook simultaneously. Each uncached EPUB spawns a `unzip` process, and each uncached PDF/other spawns a `qlmanage` process. On a first load of a Downloads folder that contains 50+ ebooks, this creates a burst of 50+ concurrent child processes at once, which can spike CPU and memory noticeably. Consider processing thumbnails lazily (only for the currently-visible items) or batching them through a small concurrency pool.

### Issue 2 of 2
extensions/calibre-search/src/add-to-library.tsx:221-226
**Synchronous blocking I/O inside `useMemo`**

`useMemo` runs synchronously during React's render phase. `scanDirectories` calls `readdirSync` and `statSync` on every file in each configured directory — also synchronously. For a Downloads folder with hundreds of mixed files, this blocks the React render thread until all `stat` calls complete, causing a noticeable freeze on mount. Moving the scan into a `useEffect` + `useState` pair (or using `useAsync` from `@raycast/utils`) keeps the UI responsive while the scan runs.

_{Reviews (3): Last reviewed commit: "Fix author name truncation and align ext..." | Re-trigger Greptile}

Addressed all Greptile feedback: replaced spawnSync with async execFileAsync, added error handler on qlmanage, removed manual Preferences interface, fixed eslint.config.js, Title Case on preference titles, and {PR_MERGE_DATE} in CHANGELOG.

This pull request has been automatically marked as stale because it did not have any recent activity.

It will be closed if no further activity occurs in the next 7 days to keep our backlog clean 😊

All feedback from the Greptile review has been addressed in commit 4580d07:

• spawnSync → async: replaced with execFileAsync (promisified execFile) so the UI stays responsive during calibredb calls
• qlmanage error handler: added proc.on('error', () => {}) to prevent uncaught exceptions on spawn failure
• Manual Preferences interface: removed from both types.ts and add-to-library.tsx; using auto-generated types via getPreferenceValues<Preferences>()
• eslint.config.js: updated to use defineConfig from eslint/config
• Preference titles: updated to Title Case (Add Books, Add Books (Optional))
• CHANGELOG.md: updated to use {PR_MERGE_DATE} placeholder

Would appreciate a re-review when time allows. Thanks!