recipes, examples: shelving a library by what its books printed

The suite could read a cataloguing block and could ask a register, and
nothing showed the two together — which is the only way either is worth
acting on. A title page alone gives up a running head when the scan
starts late; an ISBN alone returns a confidently wrong book when the
catalogue has been carrying the wrong one for years.

The example's title comparison folds to letters and digits rather than
comparing strings. A register and a title page differ over case, over a
curly apostrophe against a straight one, and over whether the subtitle
counts as part of the title. An example that called those disagreements
would teach the wrong lesson, and did until it was fixed.

It runs on this library and finds both of the cases worth finding: a file
called Document5 by -ducati996 that both sources agree is Russell's
Problems of Philosophy, and a Pelikan whose stored ISBN belongs to a book
about sculpture.

examples/README.md

@@ -15,6 +15,7 @@ NASA broadcast, which is a work of the US government.
 | [`shell/03-search-and-rerank.sh`](shell/03-search-and-rerank.sh) | Passages into pgvector, then a search that asks twice and reconciles |
 | [`rust/`](rust/src/main.rs) | The same book walked through in one process, with no pipe anywhere |
 | [`python/book_to_citations.py`](python/book_to_citations.py) | A book to rows a database can take |
+| [`python/shelve_a_library.py`](python/shelve_a_library.py) | What a book says about itself, shelved and checked against a register |
 | [`python/search_and_rerank.py`](python/search_and_rerank.py) | The pgvector search, in the language a pipeline is usually written in |
 | [`typescript/src/episode-to-chapters.ts`](typescript/src/episode-to-chapters.ts) | Captions into chapter marks and deep links for a player |
 | [`typescript/src/search-and-rerank.ts`](typescript/src/search-and-rerank.ts) | Fusing two rankings app-side, and what re-ranking means |
@@ -83,6 +84,20 @@ python examples/python/book_to_citations.py
 pip install catena-corpus psycopg
 DATABASE_URL=postgresql://user@host/db \
     python examples/python/search_and_rerank.py "why did the empire decline"
+
+`shelve_a_library.py` is the metadata half: it reads the cataloguing block a
+book prints in its own front matter, files those subjects onto a closed list
+you supply, and asks the register that assigned the ISBN whether it agrees.
+
+```sh
+python examples/python/shelve_a_library.py converted/*.md
+```
+
+Neither source is worth acting on alone — a scan that starts mid-frontmatter
+gives up a running head where the title should be, and an ISBN a catalogue has
+been carrying wrongly returns a confidently wrong book. The example prints
+`corroborated` only when both said the same thing, and the disagreements are
+the interesting output.
 ```
 
 ## TypeScript