Add book_slate_recommendation template (Graph + Prescriptive CSP)

v1/README.md

@@ -8,6 +8,7 @@ This directory contains the templates for v1. Each template folder includes its
 | --- | --- |
 | [ad_spend_allocation](./ad_spend_allocation/) | Allocate marketing budget across channels and campaigns to maximize conversions. |
 | [bom-reachability](./bom-reachability/) | Trace transitive dependencies through a bill of materials to identify which raw materials each finished product depends on and which components are structural bottlenecks. |
+| [book_slate_recommendation](./book_slate_recommendation/) | Recommend K books per reader and order them by slot, under diversity, freshness, and explainability constraints. |
 | [campaign_roi](./campaign_roi/) | Reallocate marketing campaign budgets across regions to maximize conversions, with per-campaign floor and cap constraints and a regional cap on a paused region. |
 | [cicd_runner_allocation](./cicd_runner_allocation/) | Assign CI/CD workflow jobs to the cheapest compatible runner type, subject to concurrency limits, with scenario analysis across capacity levels. |
 | [commercial_underwriting](./commercial_underwriting/) | Run rules-based eligibility checks and risk-tier classification across a four-level commercial property/casualty hierarchy (insured entity, policy, location, coverage). |
@@ -39,7 +40,7 @@ This directory contains the templates for v1. Each template folder includes its
 | [supply_chain_transport](./supply_chain_transport/) | Minimize inventory holding and transport costs with TL/LTL mode selection. |
 | [synthetic_eligibility_records](./synthetic_eligibility_records/) | Generate K distinct, internally consistent member eligibility records per solve using a CSP solver in multi-solution mode: each record satisfies CMS Medicare-eligibility, age-by-plan-type CFDs, and PCP-network attribution. |
 | [synthetic_order_lifecycle](./synthetic_order_lifecycle/) | Generate synthetic order-lifecycle event traces (PLACE / MODIFY / CANCEL / FILL) that satisfy MiFID II / Reg NMS-flavour sequencing rules using a CSP solver. |
-| [telco_network_recovery](./telco_network_recovery/) | Multi-reasoner template: GNN demand forecasting, declarative critical-tower rules, call-graph blast radius, and tower-upgrade optimization on a shared telco ontology. |
+| [telco_network_recovery](./telco_network_recovery/) | Multi-reasoner template: equipment-failure GNN over a heterogeneous graph (with manufacturer advisories), declarative critical-tower rules, call-graph blast radius, and tower-upgrade optimization on a shared telco ontology. |
 | [test_data_generation](./test_data_generation/) | Determine optimal row counts for test database tables satisfying schema and referential integrity constraints. |
 | [traveling_salesman](./traveling_salesman/) | Find the shortest route visiting all cities exactly once using the MTZ formulation. |
 | [warehouse_allocation](./warehouse_allocation/) | Allocate inventory across a distribution network using graph centrality, weakly-connected-components, and bridge-route detection to prioritize critical hubs. |

v1/book_slate_recommendation/.gitignore

@@ -0,0 +1,5 @@
+data/_cache/
+*.egg-info/
+__pycache__/
+build/
+debug.jsonl

v1/book_slate_recommendation/data/authors.csv

@@ -0,0 +1,53 @@
+id,name
+1,Eva Kumar
+2,Samuel Luke Fildes
+3,Evelynn D. Smith
+4,Charlotte Brontë
+5,John Cuming Walters
+6,Emma Orczy
+7,H. G. Wells
+8,Onésimo Colavidas
+9,Chavdar Georgiev
+10,Arthur Conan Doyle
+11,Alexandre Dumas
+12,Thomas Hardy
+13,Daniel Defoe
+14,Mark Twain
+15,Όμηρος
+16,Gilbert Keith Chesterton
+17,John Buchan
+18,Henry David Thoreau
+19,Washington Irving
+20,Aldous Huxley
+21,Oscar Wilde
+22,Henry James
+23,Jane Austen
+24,Lewis Carroll
+25,Фёдор Михайлович Достоевский
+26,Niccolò Machiavelli
+27,L. Frank Baum
+28,Jonathan Swift
+29,Stephen Crane
+30,Emily Brontë
+31,Charles Dickens
+32,Charles Bernard Derosne
+33,Mary Shelley
+34,Robert Louis Stevenson
+35,Лев Толстой
+36,Lionel Giles
+37,F. Scott Fitzgerald
+38,Agatha Christie
+39,Stephen F. Kaufman
+40,Dashiell Hammett
+41,Dante Alighieri
+42,孙武 (Sun Tzu)
+43,Bram Stoker
+44,Antoine de Saint-Exupéry
+45,Voltaire
+46,Charlotte Perkins Gilman
+47,J. J. Grandville
+48,Petrus Borel
+49,Sheridan Le Fanu
+50,N. C. Wyeth
+51,Miguel de Cervantes Saavedra
+52,William Shakespeare

v1/book_slate_recommendation/data/book_author.csv

@@ -0,0 +1,72 @@
+book_id,author_id
+1,45
+2,44
+3,26
+4,4
+5,6
+6,24
+7,24
+8,24
+9,25
+10,27
+11,28
+12,29
+13,25
+14,30
+15,34
+16,8
+16,36
+16,39
+16,42
+17,27
+18,10
+19,10
+20,10
+21,10
+22,10
+23,10
+24,10
+25,10
+26,35
+27,35
+28,22
+29,1
+29,3
+29,9
+29,46
+30,21
+31,49
+32,52
+33,11
+34,33
+35,13
+35,47
+35,48
+35,50
+36,37
+37,38
+38,40
+39,38
+40,51
+41,7
+42,7
+43,14
+44,18
+45,15
+46,19
+47,20
+48,23
+49,23
+50,23
+51,16
+52,17
+53,12
+54,31
+55,43
+56,43
+57,2
+57,5
+57,31
+57,32
+58,52
+59,41