Lucas WintherandClaude Opus 5.5
be04fab098
Captures the owner's requirements and decisions from the planning conversation, current branch/worktree state, open tasks 17-19, pending owner decisions and the controller's rulings so a new agent can resume. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1.4 KiB
Task 11 report: Hardcover plugin
Built plugins/hardcover: index.ts (definePlugin; pull, pullChanges, lookup), src/graphql.ts, src/map.ts, index.test.ts, test/fixtures/{page-short,lists,errors}.json.
Commit c099680 on task/11.
TDD: tests and implementation were written together; RED was shown after the fact by removing index.ts (0 pass, 1 fail, import error). GREEN: bun test plugins/hardcover 9 pass, 0 fail. Typecheck clean. No DB involved.
Decisions: token read from credentials.token, falling back to config.token. user_books ordered by id for stable paging. pullChanges uses where updated_at > cursor and stores max updated_at; pull also sets the cursor. Lists only in pull. Merge record reuses the entry fields with a work hint of hardcover_book = original_book_id. GraphQL errors throw HttpError(200, body).
Concerns: ratePerMinute 50 is exported as RATE_PER_MINUTE but the SDK ctx.http is host-built, so the host must apply it. The lookup search response shape (results.hits[].document) is from memory and untested against the real API.
Fix round 1
Added lookup tests (hit mapping incl. year/creators/coverUrl/externalIds, results:null -> [], non-book mediaType -> [] with no request) and a table-driven status test (1-6 and null -> none). No production code changed; the lookup shape is now pinned by fixtures only (still unverified against the live API). Result: all plugins/hardcover tests pass, typecheck clean.