@chriswiegman/hugo-tools 0.2.2 → 0.3.0

package/CHANGELOG.md

@@ -5,6 +5,18 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html),
 and is generated by [Changie](https://github.com/miniscruff/changie).
 
+## 0.3.0 - 2026-07-19
+
+### Features
+
+* book: populate reference.isbn and reference.asin in book front matter, backfilling existing files and looking up ASIN via Open Library, Google Books, or a configured Amazon Product Advertising API
+* book: add opt-in cover art fetching (--covers) — downloads cover images from Open Library or Google Books by ISBN, saves them under coversDir, and sets the cover front matter field
+* book: flag books where Goodreads' "Read Count" exceeds the number of finished dates on file, since the CSV export only ever carries the most recent read date — a printed NOTE nudges you to add earlier read dates by hand
+
+### Bug Fixes
+
+* book: strip a UTF-8 byte-order mark from the Goodreads CSV if present, so exports saved with a BOM no longer fail column detection
+
 ## 0.2.2 - 2026-07-19
 
 ### Bug Fixes

package/README.md

@@ -78,6 +78,7 @@ Or create `.hugo-tools.json` manually:
   "notesDir": "content/notes",
   "booksDir": "content/books",
   "imagesDir": "assets/images",
+  "coversDir": "assets/images/books",
   "vscodeDir": ".vscode"
 }
 ```
@@ -243,16 +244,41 @@ Clipboard support (no-content-file mode): macOS (`pbcopy`), Windows (`clip`), Li
 Imports books from a [Goodreads CSV export](https://www.goodreads.com/review/import) into Hugo content files under `booksDir`.
 
 ```sh
-import-books path/to/goodreads_library_export.csv
+import-books path/to/goodreads_library_export.csv [--covers]
 ```
 
 **What it does:**
 
 - Creates `content/books/<author-slug>/<title-slug>.md` for each book on your "read" shelf
-- Front matter includes title, author, star rating, finish date(s), and links to Amazon, Open Library, and Goodreads
+- Front matter includes title, author, star rating, finish date(s), links to Amazon, Open Library, and Goodreads, a `reference: { isbn, asin }` block, and a `cover` field
 - Any Goodreads review text becomes the file body
 - Safe to re-run: existing files are matched by Goodreads ID or ISBN, finish dates are merged, and unchanged files are skipped
 - If a book's title changed in Goodreads, the file is renamed automatically
+- `reference.isbn`/`reference.asin` are backfilled onto existing files that are missing them — a value already in the file (e.g. entered by hand) is never overwritten
+
+**Re-reads:** Goodreads' CSV export only ever contains the *most recent* "Date Read" for a book, even when its "Read Count" shows it was finished more than once. So if you re-read a book, the next export will carry the new completion date and it's automatically added to `finished` — nothing is ever overwritten or removed, dates only accumulate. What the export can't give you is *earlier* read dates for a book you'd already read more than once before you started tracking it here. When "Read Count" is higher than the number of dates already on file, the import prints a line like:
+
+```
+NOTE: king-stephen/the-gunslinger.md shows 3x read on Goodreads but only 1 date(s) on file — Goodreads only exports the latest read date, so add earlier ones to 'finished' by hand.
+```
+
+This is informational only — the file isn't touched, and nothing else about the import is blocked. Add the missing date(s) to the file's `finished:` list yourself; the note stops appearing once the counts match. A run's summary also reports how many books were flagged this way (`Rereads needing dates`).
+
+**ASIN lookup:** Goodreads exports don't include an ASIN, so it's looked up per ISBN from Open Library, then Google Books, and left blank (`""`) if neither has one. To use the official Amazon Product Advertising API as a final fallback, add credentials to `.hugo-tools.json`:
+
+```json
+{
+  "amazonPaApi": {
+    "accessKey": "",
+    "secretKey": "",
+    "partnerTag": ""
+  }
+}
+```
+
+This requires an approved Amazon Associates account with Product Advertising API access.
+
+**Cover art:** off by default — pass `--covers` to fetch it. When enabled, each book's ISBN is looked up against Open Library's cover API, then Google Books, and left blank if neither has one. Downloaded images are saved to `coversDir` (default `assets/images/books/<author-slug>/<title-slug>.<ext>`) and the `cover` field is set to the corresponding Hugo URL path (e.g. `/images/books/king-stephen/it.jpg`). On existing files, only a blank `cover` field is backfilled — a cover already set (e.g. entered by hand) is never overwritten, and no network requests are made at all unless `--covers` is passed.
 
 **To export from Goodreads:** Account → My Books → Import and Export → Export Library.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chriswiegman/hugo-tools",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "A set of tools to make blogging easier with Hugo.",
   "keywords": [
     "hugo",