Sync from GitHub

FIELD_NOTES.md

@@ -77,6 +77,33 @@ contextual "did you know?" nudge at the moment of contact). The nudges aren't de
 — they're the mechanism that attacks the #1 barrier (awareness of breadth), and the
 trace log tells Jack which ones actually convert.
 
+## The Hive re-think: exclusion → provenance
+
+Our first rule was "never touch thehiveworcester.org — it goes stale". Working
+with Jack's team showed that rule threw away the only public description of
+Worcester's biggest library asset: The Hive is Europe's first joint
+university+public library, open 8:30am–10pm every day, home to the
+Worcestershire Archive & Archaeology Service, 800+ study spaces, a Business &
+IP Centre and a Youth Hub — and almost none of that lives on the council site.
+**Staleness isn't a reason to exclude a source; it's a reason to tag it.** So
+we crawl all 57 pages (`build_hive_kb.py`), record the *exact* offering of each
+page, stamp every fact with its source URL + crawl date, and apply one
+precedence rule: where the Hive and council sites conflict (hours, prices,
+membership), the council wins and the answer says so. The site even flags its
+own events page as static — so live events still come only from the council.
+
+## Going copy-level: "do you have it?" → "here's how you get it"
+
+A catalogue hit isn't an outcome; a borrowed book is. `where_to_get` extends
+item search down to the **individual copies**: it reads the item's detail page
+for per-branch holdings (which branch, shelf mark, on-shelf or out), and offers
+the fastest route per format — walk in at the named branch, reserve free, or
+borrow the eBook on BorrowBox *tonight* (the Atom feed's `Electronic Access`
+field often carries the direct link). The detail page is the most fragile
+markup we touch, so there are two independent parsers (holdings table, then a
+branch-name-anchored text scan) and a hard honesty rule: **if neither parses,
+say so and link the item page — never guess availability.**
+
 ## What surprised us
 
 - A **single Atom endpoint** saved the hardest integration.
@@ -90,10 +117,12 @@ trace log tells Jack which ones actually convert.
 
 ```bash
 pip install -r requirements.txt gradio
-python build_kb.py && python graph_build.py   # refresh data + graph (live)
+python build_kb.py && python build_hive_kb.py && python graph_build.py
 python app.py                                  # run (no-LLM mode without HF_TOKEN)
+python library_sources.py                      # live self-test incl. copy-level §5
 ```
 
-Everything reads only `worcestershire.gov.uk` and the council catalogue — we deliberately
-exclude the out-of-date Hive website. Public data, public good, on a model that fits on
+Everything reads official sources — `worcestershire.gov.uk` and the catalogue live,
+plus every page of `thehiveworcester.org` with per-fact provenance and the council
+taking precedence on conflicts. Public data, public good, on a model that fits on
 a laptop.

JOURNEYS.md

@@ -12,6 +12,7 @@ The design loop for each journey:
 
 | # | Who & what they ask | Intent | Tool | The answer must hand them |
 |---|---|---|---|---|
+| 0 | "How do I **get** Wolf Hall?" | Walk out with (or download) THIS title today | `where_to_get` | Every format held, then the fastest route per format: **on the shelf at a named branch with shelf mark** (copy-level, live) → free reservation steps → **BorrowBox tonight** (direct link when the catalogue carries one) · eligibility per route |
 | 1 | "Do you have Harry Potter audiobooks?" | Borrow a specific title | `search_catalogue` | Matches with format/year + detail links · **To borrow:** join-online / digital-membership links · full-results link |
 | 2 | "Any good new crime novels?" | Discover something to read | `whats_new` | Newest titles · the same **To borrow** join link · see-more link |
 | 3 | "Is Malvern library open now?" | Visit a branch today | `find_library` | 🟢/🔴 open-now + today's hours · address · facilities · **Libraries Unlocked hours + how to get access** · branch page |
@@ -23,6 +24,7 @@ The design loop for each journey:
 | 9 | "What do I need to sign up?" | Join (right tier, least effort) | `membership_help` | Each tier **linked to its own page** — digital membership links straight to instant sign-up |
 | 10 | "Can I get in after work?" | Use the library out of hours | `libraries_unlocked` | Hours · the 11 branches · induction requirement · **join-online link for non-members** |
 | 11 | Greeting / off-topic | Find out what this thing does | none (`HELP`) | Capability list + four starter chips |
+| 12 | "What can I do at The Hive?" / "the archives" / "hire a room" | Use Worcester's flagship — incl. its uni-grade extras | `hive_info` | The exact offering of the relevant Hive **page(s)** (offerings, what-you-need, prices, level in building) · extended-capability gems · 8:30am–10pm hours · **provenance footer: Hive pages, crawl date, council-wins-on-conflict** |
 
 ## Journey-chaining (the chips)
 
@@ -35,7 +37,8 @@ alludes to — the nudge itself stays short.
 ## Cross-journey guarantees
 
 - **Provenance:** every answer footer shows when it was checked, which tool
-  ran, and a source link.
+  ran, and a source link. Hive answers additionally name the crawl date and
+  defer to the council on conflicts (hours, prices, membership).
 - **Value receipt:** borrowing/online/printing answers show the £ saved
   (`value_receipt`).
 - **Tone:** lead with what the person *can* do — never open with a bare "no"

PLAN.md

@@ -6,10 +6,21 @@ Companion docs: [README](README.md) · [SUBMISSION](SUBMISSION.md) · [IDEAS](ID
 ## Goal
 
 Give Worcestershire Libraries one conversational voice that answers any resident
-question from **live, official, source-cited data**, tells them **exactly what they
-need to sign up**, and **surfaces the services they never knew existed** — on a ≤32B
-model, locally-capable. The DCMS-evidenced answer to "the library doesn't shout
-about what it offers."
+question from **official, source-cited data at every granularity** — down to
+*which branch has the copy on its shelf right now* and *exactly what every page
+of the Hive offers* — tells them **exactly what they need to sign up**, and
+**surfaces the services they never knew existed** — on a ≤32B model,
+locally-capable. The DCMS-evidenced answer to "the library doesn't shout about
+what it offers." Built with/for Jack's library-resources team.
+
+The granularity ladder:
+
+| Level | Data | Tool |
+|---|---|---|
+| Service | 87 council service pages, eligibility-first | KB tools |
+| Page | all 57 pages of thehiveworcester.org, exact offerings + provenance | `hive_info` |
+| Item | live catalogue (Atom feed), incl. BorrowBox deep links | `search_catalogue` |
+| Copy | per-branch holdings + status from the item's detail page | `where_to_get` |
 
 ## Architecture
 
@@ -19,14 +30,19 @@ about what it offers."
                        │            fallback (no-token safe)        │
                        └───────────────┬────────────────────────────┘
                                        ▼
-        ┌──────────────── 10 tools ─────────────────┐   ┌── GraphRAG ──┐
-        │ search_catalogue   (SirsiDynix Atom feed) │   │ local_search │
-        │ whats_new          (newest titles)         │   │ global_search│
-        │ find_library       (hours/open-now/facils) │◀──│ multi-hop    │
-        │ mobile_library     (154 villages)          │   │ over graph   │
-        │ library_events     (live events)           │   └──────────────┘
-        │ online_hub         (PressReader/BorrowBox…) │   library_graph.json
-        │ libraries_unlocked · printing · membership  │   320 nodes/465 edges
+        ┌──────────────── 12 tools ─────────────────┐   ┌── GraphRAG ──┐
+        │ where_to_get       (copy-level: shelf @    │   │ local_search │
+        │                     branch → reserve →     │   │ global_search│
+        │                     BorrowBox tonight)     │   │ multi-hop    │
+        │ hive_info          (57 Hive pages, exact   │◀──│ over graph   │
+        │                     offer + provenance)    │   └──────────────┘
+        │ search_catalogue   (SirsiDynix Atom feed)  │   library_graph.json
+        │ whats_new          (newest titles)         │   349 nodes/502 edges
+        │ find_library       (hours/open-now/facils) │   incl. 26 HiveService
+        │ mobile_library     (154 villages)          │
+        │ library_events     (live events)           │
+        │ online_hub         (PressReader/BorrowBox…)│
+        │ libraries_unlocked · printing · membership │
         └───────────────────┬────────────────────────┘
                             ▼
         synthesise (≤32B)  +  eligibility  +  £-receipt  +  EAST nudge
@@ -40,8 +56,9 @@ about what it offers."
 | Layer | File | Role |
 |---|---|---|
 | Ingestion | `build_kb.py` → `library_kb.json` | Crawl all 218 library URLs → 87 services / 23 branches / 17 resources, with eligibility & facilities |
-| Graph | `graph_build.py` → `library_graph.json` | Deterministic GraphRAG: entities → relationships → communities → reports |
-| Sources | `library_sources.py` | 10 live/KB tools + curated hub access + membership tiers |
+| Hive ingestion | `build_hive_kb.py` → `hive_kb.json` | Crawl all 57 Hive pages → exact per-page offerings, what-you-need, prices, levels; curated `hive_profile` of 26 extended capabilities, every fact source-tagged |
+| Graph | `graph_build.py` → `library_graph.json` | Deterministic GraphRAG over BOTH KBs: entities → relationships → communities → reports (incl. 26 HiveService nodes; offline rebuild keeps villages) |
+| Sources | `library_sources.py` | 12 live/KB tools + curated hub access + membership tiers + copy-level availability parser |
 | Retrieval | `graph_rag.py` | local/global graph search (multi-hop) |
 | Traces | `trace.py` → `traces.jsonl` | per-turn structured agent trace (Open Trace badge) |
 | App | `app.py` | router, renders, behaviour-change layer, Gradio UI |
@@ -56,8 +73,16 @@ about what it offers."
 - [x] **P5 — Behaviour-change layer.** EAST nudges, £-saved value receipt, quick-reply chips (DCMS/COM-B grounded).
 - [x] **P6 — Traces.** JSONL logging + in-chat "how I answered" panel.
 - [x] **P7 — KB refinement.** Curate all 17 hub resources, filter time-bound junk, tag seasonal pages.
-- [ ] **P8 — Deploy** to the Space + `HF_TOKEN` + smoke-test (user action).
-- [ ] **P9 — Stretch:** custom `gr.Server` frontend; a small fine-tune (🎯 badge); llama.cpp local run (🔌🦙).
+- [x] **P8 — The Hive, page-level.** Reverse the exclusion: crawl all 57 pages
+  with provenance (`build_hive_kb.py`), `hive_info` tool, Hive in the graph
+  (open-late, archives, 26 capabilities), council-wins-on-conflict rule.
+- [x] **P9 — Copy-level "where to get it".** `where_to_get`: per-branch
+  holdings/status from the item detail page (two parse strategies, fail-soft),
+  free-reservation steps, BorrowBox deep links from the Atom feed's
+  Electronic Access field. *Live-verify with `python library_sources.py`.*
+- [ ] **P10 — Deploy** to the Space + `HF_TOKEN` + smoke-test (user action),
+  incl. the new self-test §5 (copy-level) against the live catalogue.
+- [ ] **P11 — Stretch:** custom `gr.Server` frontend; a small fine-tune (🎯 badge); llama.cpp local run (🔌🦙).
 
 ## The behaviour-change layer (why, not just what)
 
@@ -90,6 +115,8 @@ source correctness.
 | HF Inference flaky / no token | **No-LLM fallback** renders raw live data — demo never breaks |
 | Council site HTML changes | Re-run `build_kb.py` (re-crawl) any time; tools fail soft |
 | SirsiDynix slow/timeouts | per-call try/except; app degrades gracefully |
+| Hive site goes stale again | every Hive fact shows its crawl date; council wins on conflict; `build_hive_kb.py` re-crawls in minutes |
+| Detail-page holdings markup shifts | two independent parse strategies (table + branch-name text scan); if both miss, the answer says so and links the item page — never guesses |
 | Gradio 6 needs Py3.10+ | tested logic locally; boot-test on the Space first |
 | Facility data sparse (e.g. "study space") | multi-hop honest about coverage; lead demo on café+meeting |
 

README.md

@@ -14,7 +14,9 @@ short_description: Live, source-cited answers about your local library
 # 📚 Worcestershire Libraries — Live Assistant
 
 A small-model (**≤ 32B**) agent that answers real questions about Worcestershire
-Libraries by **mining live data at question time** from official sources only.
+Libraries from official data **at every granularity** — service pages → every
+page of the Hive's site → catalogue items → the individual copies on a branch's
+shelf — mined live at question time wherever the source allows it.
 
 > Built for the [Build Small Hackathon](https://huggingface.co/build-small-hackathon)
 > · **Backyard AI** track. The "someone I know" is **Jack, a library resources
@@ -28,7 +30,9 @@ back from the council's own systems, and explains it:
 
 | You ask… | It mines… | Source |
 |---|---|---|
+| 📚 “How do I **get** Wolf Hall?” | the item's **copy-level holdings** — which branch has it on the shelf *now*, free reservation, or the eBook on BorrowBox tonight | `wcc.ent.sirsidynix.net.uk` |
 | 📖 “Do you have Harry Potter audiobooks?” | the **SirsiDynix catalogue** (books, eBooks, audio, DVDs) | `wcc.ent.sirsidynix.net.uk` |
+| 🐝 “What can I do at The Hive?” | **every page of the Hive's site** — archives & archaeology, 800+ study spaces, room hire, open 8:30am–10pm daily | `thehiveworcester.org` |
 | 🚐 “When does the mobile library visit Abberley?” | the **mobile-library timetable** (154 villages) | `worcestershire.gov.uk` |
 | 📅 “What's on this week?” | **events & activities** | `worcestershire.gov.uk` |
 | 🖨️ “How do I print from my phone?” | **Print Your Way** steps & prices | `worcestershire.gov.uk` |
@@ -52,11 +56,21 @@ know a catalogue it was never trained on.
   mode* — deterministic keyword routing + the raw live data. The demo never
   breaks.
 
-## Why not "the Hive"?
+## The Hive, with provenance
 
-We deliberately **avoid scraping thehiveworcester.org** — that content is
-unreliable and often years out of date. Only the council website and the live
-catalogue are used, so answers are trustworthy and current.
+We originally excluded thehiveworcester.org because parts of it run stale. The
+re-think: **include it page-by-page, but tag every fact with its source** —
+because the Hive's site is the *only* place much of Worcester's extended offer
+is described (Explore the Past archives & archaeology, Europe's first joint
+university+public library, 800+ study spaces, room hire, the BIPC, the Youth
+Hub). The rules that keep answers trustworthy:
+
+- every Hive fact carries its **source page + crawl date** (`hive_kb.json`,
+  rebuilt by `build_hive_kb.py`)
+- where Hive and council pages conflict (hours, prices, membership), the
+  **council page wins** — and the answer says which source it used
+- the Hive's own events page is static, so **live events always come from the
+  council site**
 
 ## Architecture
 
@@ -64,13 +78,16 @@ catalogue are used, so answers are trustworthy and current.
 question ──▶ route()  (LLM JSON router, keyword fallback)
                  │
                  ▼
-        library_sources.py  ──▶  live HTTP to council + catalogue
-                 │                 • search_catalogue()  (Atom feed)
-                 │                 • mobile_library()     (village pages)
-                 │                 • library_events()     (events page)
-                 │                 • printing_help()      (printing page)
+        library_sources.py  ──▶  the granularity ladder
+                 │   service • 87 council service pages     (library_kb.json)
+                 │   page    • 57 Hive pages, exact offer   (hive_kb.json)
+                 │   item    • search_catalogue()           (live Atom feed)
+                 │   copy    • where_to_get()               (live holdings:
+                 │             shelf @ branch → reserve → BorrowBox tonight)
+                 │   plus    • mobile_library() · library_events()
+                 │           • find_library() · hive_info() · printing_help()
                  ▼
-        synthesize() ──▶ warm, grounded answer + live source footer
+        synthesize() ──▶ warm, grounded answer + named-source footer
 ```
 
 `library_sources.py` has **zero** Gradio/LLM dependencies and is independently
@@ -82,6 +99,11 @@ testable against the live sites: `python library_sources.py`.
 pip install -r requirements.txt gradio
 export HF_TOKEN=hf_xxx            # optional — omit for no-LLM mode
 python app.py                    # http://localhost:7860
+
+# refresh the knowledge bases + graph any time:
+python build_kb.py               # council pages   -> library_kb.json
+python build_hive_kb.py          # every Hive page -> hive_kb.json
+python graph_build.py            # both KBs        -> library_graph.json
 ```
 
 ## Bonus quests in reach

SUBMISSION.md

@@ -95,22 +95,23 @@ Backyard entries **lead with a face + a quote** → the demo opens on Jack.
 
 ```
 question → route (LLM JSON + keyword fallback)
-        → 10 live/KB tools  ── SirsiDynix catalogue (Atom)
+        → 12 live/KB tools  ── SirsiDynix catalogue (Atom) down to COPY level
+        →                   ── all 57 Hive pages, exact offer (provenance‑tagged)
         → GraphRAG search   ── council pages (87 services / 23 branches / 17 resources)
-        → synthesise (≤32B)    library_graph.json: 320 nodes · 465 edges · 8 communities
+        → synthesise (≤32B)    library_graph.json: 349 nodes · 502 edges · 26 Hive services
         → answer + eligibility + £‑receipt + EAST nudge + source + open trace
 ```
 
 - **Inspiration:** microsoft/graphrag, microsoft/markitdown, IBM Docling.
 - **Evidence spine:** DCMS/Ipsos *What works to engage non‑users* (COM‑B) + BIT **EAST**.
 - **Honest constraint fit:** small model + big graph; **no‑LLM fallback** so the demo never breaks.
-- **Sources:** worcestershire.gov.uk only — the out‑of‑date Hive site is deliberately excluded.
+- **Sources:** worcestershire.gov.uk + the live catalogue (checked at question time), plus every page of thehiveworcester.org crawled with per‑fact provenance — council wins on conflicts.
 
 ## 8. Go‑live checklist (for Jack, Friday AM)
 
 - [ ] Create Space `build-small-hackathon/wpl-discovery` (Gradio, public).
 - [ ] Push: `app.py`, `library_sources.py`, `graph_rag.py`, `trace.py`,
-      `library_kb.json`, `library_graph.json`, `requirements.txt`, `README.md`, `LICENSE`.
+      `library_kb.json`, `hive_kb.json`, `library_graph.json`, `requirements.txt`, `README.md`, `LICENSE`.
       *(build_kb.py / graph_build.py are build‑time only — optional to include.)*
 - [ ] Add Space secret **`HF_TOKEN`** (read scope) → enables the model. *Without it the
       app still runs in no‑LLM mode, so a missing token won't block Jack's test.*

app.py

@@ -2,9 +2,15 @@
 Worcestershire Libraries — Live Assistant  (Build Small Hackathon)
 
 A small-model (<=32B) civic agent that answers real questions about
-Worcestershire Libraries from LIVE official data + a local knowledge graph.
+Worcestershire Libraries from official data at EVERY granularity:
+service pages -> every page of the Hive site -> catalogue items -> the
+individual copies on a branch's shelf.
 
   • Live tools  — catalogue, mobile library, events, branch hours/facilities
+  • where_to_get — the full "how do I actually get this title" journey:
+    on-shelf copy at a named branch / free reservation / BorrowBox tonight
+  • hive_info   — The Hive (Worcester) page-by-page: archives & archaeology,
+    800+ study spaces, room hire, BIPC, Youth Hub, 8:30am–10pm every day
   • Knowledge graph (GraphRAG-style) — multi-hop "which late library has a café?"
   • Curated detail — exactly what you need to sign up for each service
   • Behaviour-change layer — EAST nudges + £-saved "value receipt" (DCMS-evidenced)
@@ -54,9 +60,21 @@ def llm(messages, *, max_tokens=512, temperature=0.3, stream=False):
 
 TOOLS = {
     "search_catalogue": {
-        "desc": "Find a specific book, eBook, audiobook or DVD the library holds. "
+        "desc": "Browse/search what the library holds (book, eBook, audiobook, DVD). "
                 "args: {\"query\": \"<title / author / subject>\"}",
         "fn": lambda a: ls.search_catalogue(a.get("query", ""), limit=6)},
+    "where_to_get": {
+        "desc": "User wants to actually GET/borrow/obtain a specific title — gives "
+                "the exact route: which branch has it on the shelf NOW (copy-level), "
+                "free reservation steps, or borrow tonight on BorrowBox. "
+                "args: {\"query\": \"<title / author>\"}",
+        "fn": lambda a: ls.where_to_get(a.get("query") or a.get("title", ""))},
+    "hive_info": {
+        "desc": "The Hive — Worcester's library (joint university+public): hours "
+                "(8:30am-10pm daily), Explore the Past archives & archaeology, study "
+                "spaces, room hire, café, getting there, children's library, business "
+                "support. Page-level detail. args: {\"topic\": \"<optional topic>\"}",
+        "fn": lambda a: ls.hive_info(a.get("topic") or a.get("query"))},
     "whats_new": {
         "desc": "Newest titles in a genre, for fun recommendations. "
                 "args: {\"genre\": \"<genre/topic>\"}",
@@ -114,6 +132,25 @@ def keyword_route(q: str) -> tuple[str, dict]:
                     if w in t)
     if re.search(r"\b(print|printing|photocopy|photocopies|scan|copier)\b", t):
         return "printing_help", {}
+    # The Hive / its extended offer (archives, archaeology, rooms, Worcester city)
+    if re.search(r"\b(the )?hive\b|archiv|archaeolog|explore the past|"
+                 r"worcester city librar|hire (a |the )?(room|space)|"
+                 r"(room|space) (for )?hire|book a (room|space|study)", t):
+        topic = re.sub(r"\b(the|hive|at|in|about|tell|me|what|can|i|do|you|"
+                       r"know|is|are|there)\b", " ", t)
+        return "hive_info", {"topic": topic.strip(" ?.") or None}
+    # "how do I actually GET it" — the full per-copy journey
+    if (re.search(r"\b(where|how) (can|do|could|would) i (get|borrow|find|read|"
+                  r"listen to)\b|\bget hold of\b|\bi want to (read|borrow)\b|"
+                  r"\bis .{3,60} (available|in stock|on the shelf)\b|"
+                  r"\b(nearest|closest) copy\b", t)
+            and not re.search(r"\bcard|member|join|sign ?up\b", t)):
+        q2 = re.sub(r"\b(where|how|can|do|could|would|i|get|borrow|find|read|"
+                    r"listen|to|hold|of|want|is|available|in stock|on the shelf|"
+                    r"a copy of|the book|nearest|closest|copy)\b", " ", t)
+        q2 = q2.strip(" ?.")
+        if q2:
+            return "where_to_get", {"query": q2}
     if (re.search(r"\b(which|what) librar|librar(y|ies) (with|that has)\b", t)
             or feat_hits >= 2 or "overall" in t):
         return "graph_search", {"query": q}
@@ -124,8 +161,8 @@ def keyword_route(q: str) -> tuple[str, dict]:
                  r"facilit|where is|near me|study space)\b", t):
         m = re.findall(r"\b([A-Z][a-z]+(?:[ -][A-Z][a-z]+)*)\b", q)
         return "find_library", {"name": (m[-1] if m else "")}
-    if re.search(r"\b(unlocked|8pm|after hours|out of hours|evening access|"
-                 r"open late)\b", t):
+    if re.search(r"\b(unlocked|8pm|after hours|after work|out of hours|"
+                 r"evening access|open late|get in (early|late))\b", t):
         return "libraries_unlocked", {}
     platform = re.search(r"\b(borrowbox|pressreader|ancestry|espacenet|ebsco|oxford|"
                          r"theory test|bfi|cobra|digital library|online (library )?hub)\b", t)
@@ -364,8 +401,96 @@ def render_graph(r):
     return "\n".join(out)
 
 
+def render_where_to_get(r):
+    if not r.get("found"):
+        rt = r["routes"][0]
+        return (f"I couldn't find **{r['query']}** in the catalogue. {rt['advice']}\n\n"
+                f"🔎 [Try the catalogue yourself]({r['search_url']})")
+    out = [f"**{r['best_title']}**" + (f" — {r['author']}" if r["author"] else "")
+           + f" · held as: {', '.join(r['formats_held'])}\n"]
+    for rt in r["routes"]:
+        if rt["route"] == "digital":
+            link = ("[Open it in BorrowBox]" if rt["direct_link"]
+                    else "[Open BorrowBox (Worcestershire)]")
+            out.append(f"💻 **Borrow the {rt['format']} free tonight** — "
+                       f"{link}({rt['url']})")
+            out += [f"  {i}. {s}" for i, s in enumerate(rt["steps"], 1)]
+            out.append(f"  - ✅ {rt['need']}")
+        elif rt["route"] == "shelf":
+            out.append(f"📚 **{rt['format']} — on the shelf right now at:**")
+            for c in rt["copies"]:
+                call = f" · shelf mark `{c['call_number']}`" if c["call_number"] else ""
+                out.append(f"  - **{c['branch']}**{call} — _{c['status']}_")
+            out.append(f"  - ✅ {rt['need']}")
+            out.append(f"  - 🔎 [Item page / all copies]({rt['url']})")
+        elif rt["route"] == "reserve":
+            out.append(f"🔖 **{rt['format']} — no copy on a shelf just now: "
+                       f"reserve it free.**")
+            if rt.get("copies"):
+                spots = "; ".join(f"{c['branch']}: {c['status']}"
+                                  for c in rt["copies"][:5])
+                out.append(f"  - Current copies — {spots}")
+            elif not rt.get("availability_parsed"):
+                out.append("  - _(I couldn't read live copy status this time — "
+                           "the item page below shows it.)_")
+            out += [f"  {i}. {s}" for i, s in enumerate(rt["steps"], 1)]
+            out.append(f"  - ✅ {rt['need']}")
+            out.append(f"  - 🔎 [Reserve here]({rt['url']})")
+        else:
+            out.append(f"✋ {rt.get('advice', '')}")
+    if r.get("other_matches"):
+        out.append(f"\n_Similar in the catalogue:_ {' · '.join(r['other_matches'])}")
+    out.append(f"\n🔎 [Full search results]({r['search_url']})")
+    return "\n".join(out)
+
+
+def render_hive(r):
+    hours = r.get("opening_hours", "")
+    out = [f"🐝 **{r['name']}** — Worcester's library, run jointly by the "
+           f"University of Worcester and Worcestershire County Council."]
+    if hours:
+        out.append(f"🕗 **{hours}**")
+    if r.get("kind") == "overview":
+        out.append(f"{r.get('address', '')}\n")
+        out.append("**More than a branch:**")
+        for c in r.get("capabilities", [])[:9]:
+            if isinstance(c, dict):
+                src = f" — [source]({c['source']})" if c.get("source") else ""
+                out.append(f"- **{c.get('capability', '')}** — "
+                           f"{c.get('detail', '')[:160]}{src}")
+        out.append(f"\n✅ {ls.ELIGIBILITY['hive_visit']}")
+    else:
+        for p in r.get("pages", []):
+            out.append(f"\n**[{p['title']}]({p['url']})** — {p['summary'][:180]}")
+            for o in p.get("offerings", [])[:6]:
+                out.append(f"  - {o}")
+            for n in p.get("what_you_need", [])[:2]:
+                out.append(f"  - ✅ {n}")
+            d = p.get("details", {})
+            for k, label in (("hours", "🕗"), ("prices", "💷"),
+                             ("location_in_building", "📍"), ("contact", "☎️")):
+                if d.get(k):
+                    out.append(f"  - {label} {d[k][:140]}")
+            if p.get("notes"):
+                out.append(f"  - ⚠️ _{p['notes']}_")
+        for c in r.get("capabilities", [])[:3]:
+            if isinstance(c, dict):
+                out.append(f"\n💎 **{c.get('capability', '')}** — "
+                           f"{c.get('detail', '')[:160]}")
+        if not r.get("pages") and not r.get("capabilities"):
+            out.append("\nI don't have a Hive page on that — try the council "
+                       f"pages, or browse [thehiveworcester.org]({r['page_url']}).")
+    as_of = (r.get("as_of") or "")[:10]
+    out.append(f"\n<sub>ℹ️ From the Hive's own pages (crawled {as_of}). For live "
+               "events, membership and prices the council site is the "
+               "authority — ask me and I'll check it live.</sub>")
+    out.append(f"🔎 [thehiveworcester.org]({r['page_url']})")
+    return "\n".join(out)
+
+
 RENDER = {
     "search_catalogue": render_catalogue, "whats_new": render_whats_new,
+    "where_to_get": render_where_to_get, "hive_info": render_hive,
     "find_library": render_find_library, "mobile_library": render_mobile,
     "library_events": render_events, "online_hub": render_online_hub,
     "libraries_unlocked": render_unlocked, "membership_help": render_membership,
@@ -380,6 +505,8 @@ RENDER = {
 def value_receipt(tool, raw):
     if tool in ("search_catalogue", "whats_new") and raw.get("items"):
         return "💷 _Borrowing instead of buying ≈ **£9–��20 saved** per title._"
+    if tool == "where_to_get" and raw.get("found"):
+        return "💷 _Getting it from the library instead of buying ≈ **£9–£20 saved**._"
     if tool == "online_hub":
         return ("💷 _Free with your card — a newspaper or eBook subscription is "
                 "**~£8–£12/month** you don't pay._")
@@ -410,8 +537,12 @@ NUDGES = {
                         ["Set up digital membership", "What's the difference?", "What can I borrow online?"]),
     "graph_search": ("💡 Tell me what matters (late, café, study space) and I'll match a branch.",
                      ["Late-opening + café", "Find a book", "What's on this week?"]),
+    "where_to_get": ("💡 Reservations are free — collect at any branch, or the van.",
+                     ["Is it on BorrowBox?", "Which branch is nearest?", "How do I join?"]),
+    "hive_info": ("💡 The Hive is open 8:30am–10pm every single day — and anyone can walk in.",
+                  ["The Hive's archives", "Hire a room at the Hive", "Is the Hive open now?"]),
 }
-HELP_CHIPS = ["Do you have Harry Potter?", "Mobile library near me",
+HELP_CHIPS = ["How do I get Wolf Hall?", "What's at The Hive?",
               "What's on this week?", "How do I print from my phone?"]
 
 
@@ -426,6 +557,7 @@ SYNTH_SYSTEM = (
     "data. Lead with what the person CAN do: if a service meets their need in a "
     "different way (e.g. they can't print AT home, but can send a job from home "
     "and collect it at any branch), open with that — never with a bare 'no'. "
+    "Keep any provenance footnote (e.g. 'From the Hive's own pages') intact. "
     "If the data doesn't answer it, say so and point to the source link.")
 
 
@@ -453,14 +585,18 @@ def synthesize_stream(question, rendered):
 HELP = (
     "👋 I'm the **Worcestershire Libraries assistant**. I check the council site "
     "and catalogue *live* and can help you:\n\n"
-    "- 📚 **Find a book / eBook / audiobook**\n"
+    "- 📚 **Get a specific book** — which branch has it on the shelf *right now*, "
+    "or borrow the eBook tonight\n"
     "- 📍 **Branch hours, 'open now?', toilets, parking**\n"
+    "- 🐝 **The Hive** (Worcester) — archives & archaeology, study spaces, room "
+    "hire, open 8:30am–10pm daily\n"
     "- 🚐 **Mobile library** times for your village\n"
     "- 📅 **What's on** this week\n"
     "- 💻 **Free online** — newspapers, magazines, family history\n"
     "- 🖨️ **Printing** from your phone\n\n"
-    "_Every answer is checked live against official Worcestershire County "
-    "Council sources._")
+    "_Answers come from official sources — the council site and catalogue "
+    "checked live, plus every page of the Hive's own site — and each answer "
+    "names its source._")
 
 
 # --------------------------------------------------------------------------- #
@@ -505,7 +641,9 @@ def respond(message, history):
     value = value_receipt(tool, raw)
     nudge, chips = NUDGES.get(tool, ("", []))
     checked = raw.get("checked", "")
-    footer = (f"\n\n<sub>🔎 Checked **live**"
+    label = ("page-level KB" if tool == "hive_info" and raw.get("as_of")
+             else "**live**")
+    footer = (f"\n\n<sub>🔎 Checked {label}"
               + (f" · {checked}" if checked else "")
               + f" · tool `{tool}` ({how})"
               + (f" · [source]({source})" if source else "") + "</sub>")
@@ -545,9 +683,10 @@ def build_demo():
     with gr.Blocks(title="Worcestershire Libraries — Live Assistant") as demo:
         gr.HTML("<div id='hero'><span class='live'>● live data</span>"
                 "<h1>Worcestershire Libraries — Live Assistant</h1>"
-                "<p>Books, mobile library, events, printing and what's free online — "
-                "answered live from the council site & catalogue, with exactly what "
-                "you need to sign up.</p></div>")
+                "<p>Exactly where to get the book you want, everything The Hive "
+                "offers, mobile library, events, printing and what's free online — "
+                "from the council site, catalogue & every Hive page, with exactly "
+                "what you need to sign up.</p></div>")
 
         chat = gr.Chatbot(height=460, show_label=False,
                           placeholder="📚 Ask me anything about your local library…",
@@ -561,12 +700,14 @@ def build_demo():
                      for _ in range(3)]
 
         gr.Examples(
-            ["Do you have Harry Potter audiobooks?",
+            ["How do I get Wolf Hall by Hilary Mantel?",
+             "Do you have Harry Potter audiobooks?",
+             "What can I do at The Hive?",
+             "Tell me about the archives at the Hive",
              "Is Malvern library open now?",
              "A late-opening library with a café and meeting rooms",
              "When does the mobile library visit Abberley?",
-             "Can I read newspapers for free?",
-             "What do I need to sign up?"],
+             "Can I read newspapers for free?"],
             inputs=box, label="Try one")
 
         if not HF_TOKEN:

build_hive_kb.py

@@ -0,0 +1,264 @@
+"""
+build_hive_kb.py — crawl EVERY page of thehiveworcester.org into hive_kb.json.
+
+The Hive is Worcester city's library — Europe's first joint university + public
+library — and its website is the only place much of its extended offer is
+described (Explore the Past archives & archaeology, 800+ study spaces, room
+hire, BIPC business support, the Youth Hub...). We crawl it page-by-page and
+record the EXACT offering of each page, with provenance on every fact.
+
+Provenance policy (the re-think of our old "never touch the Hive site" rule):
+  • every page object carries its source URL + last_seen date
+  • whats-on.html is flagged static/under-construction by the site itself —
+    live events still come from worcestershire.gov.uk
+  • where the Hive site and the council site conflict (hours, prices,
+    membership), the COUNCIL page wins — answers must say which source they used
+
+Output: hive_kb.json
+  {generated, source, note, page_count, hive_profile, pages: [...]}
+
+Each page: {url, title, section, summary, offerings[], what_you_need[],
+            details{hours,prices,contact,location_in_building}, links_out[],
+            last_seen}
+
+`hive_profile.extended_capabilities` is a CURATED list (capability, detail,
+source) — re-crawling refreshes every page but PRESERVES the curated list from
+the existing hive_kb.json unless you pass --rebuild-capabilities, in which case
+a best-effort automatic list is generated for you to re-curate.
+
+Run:  python build_hive_kb.py            (refresh pages, keep curated profile)
+      python build_hive_kb.py --rebuild-capabilities
+"""
+
+from __future__ import annotations
+
+import json
+import re
+import sys
+import time
+from datetime import datetime, timezone, date
+from urllib.parse import urljoin, urlparse
+
+import requests
+from bs4 import BeautifulSoup
+
+HIVE = "https://www.thehiveworcester.org"
+OUT = "hive_kb.json"
+HEADERS = {"User-Agent": "WorcsLibrariesKB/3.0 (Hive pages; charitable project)"}
+TIMEOUT = 20
+DELAY = 0.3
+MAX_PAGES = 90
+
+SEEDS = [
+    "/", "/collections.html", "/services.html", "/whats-on.html",
+    "/plan-your-visit.html", "/learn.html", "/about-the-hive.html",
+    "/opening-hours.html", "/getting-here.html", "/contact-us.html",
+    "/fines-renewals.html", "/how-to-find-things.html",
+    "/borrowing-reservations.html", "/how-to-get-a-library-card.html",
+    "/explore-the-past.html", "/book-a-space.html", "/space-for-hire.html",
+    "/catalogue-search.html",
+]
+
+# URL slug -> nav section. Anything unmatched inherits from its referrer.
+SECTION_HINTS = {
+    "collections": "collections", "catalogue": "collections",
+    "services": "services", "printing": "services", "computer": "services",
+    "whats-on": "whats-on", "event": "whats-on",
+    "plan-your-visit": "plan-your-visit", "getting-here": "plan-your-visit",
+    "opening-hours": "plan-your-visit", "cafe": "plan-your-visit",
+    "learn": "learn", "school": "learn", "student": "learn", "youth": "learn",
+    "about": "about", "contact": "about", "facts": "about", "creating": "about",
+    "library-card": "using-the-library", "borrowing": "using-the-library",
+    "fines": "using-the-library", "using-the-library": "using-the-library",
+    "how-to-find": "using-the-library", "explore-the-past": "learn",
+    "book-a-space": "plan-your-visit", "space-for-hire": "plan-your-visit",
+}
+
+NEED_TRIGGERS = re.compile(
+    r"\b(you('| wi)?ll need|you need|to (join|use|access|book|register|sign ?up)|"
+    r"who can|available to|free (to|for)|eligible|membership|library card|"
+    r"\bPIN\b|register|sign ?up|aged \d+|bring|photo(graphic)? ID|proof of)\b", re.I)
+
+HOURS_RE = re.compile(
+    r"((?:open\s+)?(?:from\s+)?\d{1,2}[:.]\d{2}\s*(?:am|pm)?\s*(?:-|to|–)\s*"
+    r"\d{1,2}(?:[:.]\d{2})?\s*(?:am|pm)[^.]{0,60})", re.I)
+PRICE_RE = re.compile(r"((?:£\d+(?:\.\d{2})?|\d+p)\b[^.]{0,80})")
+PHONE_RE = re.compile(r"(0\d{4}\s?\d{6}|\d{5}\s\d{6})")
+EMAIL_RE = re.compile(r"[\w.+-]+@[\w-]+\.[\w.-]+")
+LEVEL_RE = re.compile(r"\b([Ll]evel \d)\b")
+
+
+def canon(url: str) -> str:
+    url = urljoin(HIVE + "/", url).split("#")[0].split("?")[0]
+    url = url.replace("http://", "https://").replace("://thehive", "://www.thehive")
+    if url.rstrip("/") in (HIVE, HIVE + "/index.html"):
+        return HIVE + "/"
+    return url
+
+
+def is_internal_page(url: str) -> bool:
+    p = urlparse(url)
+    return (p.netloc == "www.thehiveworcester.org"
+            and (p.path.endswith(".html") or p.path in ("", "/")))
+
+
+def section_of(url: str, referrer_section: str) -> str:
+    slug = urlparse(url).path.lower()
+    for hint, sec in SECTION_HINTS.items():
+        if hint in slug:
+            return sec
+    return referrer_section or "other"
+
+
+def main_text(soup: BeautifulSoup):
+    main = (soup.find("main") or soup.find(id="content")
+            or soup.find(class_="container") or soup.body or soup)
+    for bad in main.select("nav, header, footer, script, style, .navbar, .carousel"):
+        bad.decompose()
+    return main
+
+
+def extract_page(url: str, html: str, referrer_section: str) -> dict:
+    soup = BeautifulSoup(html, "html.parser")
+    main = main_text(soup)
+    h1 = main.find(["h1", "h2"])
+    title = (h1.get_text(" ", strip=True) if h1 else
+             (soup.title.get_text(strip=True).strip(" -") if soup.title else url))
+
+    paras = [re.sub(r"\s+", " ", p.get_text(" ", strip=True))
+             for p in main.find_all("p")]
+    paras = [p for p in paras if len(p) > 30]
+    summary = paras[0][:300] if paras else ""
+
+    # EXACT offerings: headings + list items + lead sentences, near-verbatim.
+    offerings, seen = [], set()
+    for el in main.find_all(["h2", "h3", "h4", "li"]):
+        t = re.sub(r"\s+", " ", el.get_text(" ", strip=True))
+        if 4 < len(t) <= 200 and t.lower() not in seen:
+            seen.add(t.lower())
+            offerings.append(t)
+    for p in paras[:6]:
+        first = p.split(". ")[0].strip()
+        if 15 < len(first) <= 200 and first.lower() not in seen:
+            seen.add(first.lower())
+            offerings.append(first)
+
+    blob = " ".join(paras)
+    need = []
+    for m in re.finditer(r"[^.!?]*[.!?]", blob):
+        seg = m.group(0).strip()
+        if 15 <= len(seg) <= 220 and NEED_TRIGGERS.search(seg):
+            if seg.lower() not in (n.lower() for n in need):
+                need.append(seg)
+        if len(need) >= 5:
+            break
+
+    details = {}
+    if (m := HOURS_RE.search(blob)):
+        details["hours"] = m.group(1).strip()
+    prices = PRICE_RE.findall(blob)[:6]
+    if prices:
+        details["prices"] = "; ".join(p.strip() for p in prices)
+    contact = PHONE_RE.findall(blob)[:2] + EMAIL_RE.findall(blob)[:3]
+    if contact:
+        details["contact"] = ", ".join(dict.fromkeys(contact))
+    if (m := LEVEL_RE.search(blob)):
+        details["location_in_building"] = m.group(1)
+
+    links_out = sorted({a["href"] for a in main.find_all("a", href=True)
+                        if a["href"].startswith("http")
+                        and "thehiveworcester.org" not in a["href"]})[:15]
+
+    page = {"url": url, "title": title,
+            "section": section_of(url, referrer_section),
+            "summary": summary, "offerings": offerings[:30],
+            "last_seen": date.today().isoformat()}
+    if need:
+        page["what_you_need"] = need
+    if details:
+        page["details"] = details
+    if links_out:
+        page["links_out"] = links_out
+    if "whats-on" in url:
+        page["notes"] = ("Site flags this page as static/under construction — "
+                         "use worcestershire.gov.uk for live events.")
+    return page, soup
+
+
+def auto_capabilities(pages: list[dict]) -> list[dict]:
+    """Best-effort automatic capability list (for --rebuild-capabilities)."""
+    KEY = ("archive", "archaeolog", "study space", "business", "youth",
+           "children", "room", "hire", "university", "special collection",
+           "research", "café", "cafe", "catalogue")
+    out = []
+    for p in pages:
+        hits = [o for o in p.get("offerings", [])
+                if any(k in o.lower() for k in KEY)]
+        for h in hits[:2]:
+            out.append({"capability": p["title"], "detail": h, "source": p["url"]})
+    return out[:40]
+
+
+def main():
+    rebuild_caps = "--rebuild-capabilities" in sys.argv
+
+    # preserve the curated profile unless told otherwise
+    old_profile = {}
+    try:
+        with open(OUT, encoding="utf-8") as f:
+            old_profile = json.load(f).get("hive_profile", {})
+    except FileNotFoundError:
+        pass
+
+    queue = [(canon(s), "other") for s in SEEDS]
+    done: dict[str, dict] = {}
+    while queue and len(done) < MAX_PAGES:
+        url, ref_sec = queue.pop(0)
+        if url in done:
+            continue
+        try:
+            r = requests.get(url, headers=HEADERS, timeout=TIMEOUT)
+            r.raise_for_status()
+        except Exception as e:
+            done[url] = {"url": url, "error": str(e),
+                         "last_seen": date.today().isoformat()}
+            continue
+        page, soup = extract_page(url, r.text, ref_sec)
+        done[url] = page
+        for a in soup.find_all("a", href=True):
+            u = canon(a["href"])
+            if is_internal_page(u) and u not in done:
+                queue.append((u, page["section"]))
+        if len(done) % 10 == 0:
+            print(f"  ...{len(done)} pages")
+        time.sleep(DELAY)
+
+    pages = sorted(done.values(), key=lambda p: p["url"])
+    profile = old_profile if (old_profile and not rebuild_caps) else {
+        "name": "The Hive, Worcester",
+        "extended_capabilities": auto_capabilities(pages),
+        "note": "Auto-generated — please re-curate against the pages.",
+    }
+
+    out = {
+        "generated": datetime.now(timezone.utc).isoformat(timespec="seconds"),
+        "source": HIVE,
+        "method": "requests BFS crawl, every internal .html page",
+        "note": ("Built page-by-page from thehiveworcester.org. Every fact "
+                 "carries its source page. Where the Hive site and "
+                 "worcestershire.gov.uk conflict (hours, prices, membership), "
+                 "the council page wins; the site itself flags whats-on.html "
+                 "as static/under-construction."),
+        "page_count": len(pages),
+        "hive_profile": profile,
+        "pages": pages,
+    }
+    with open(OUT, "w", encoding="utf-8") as f:
+        json.dump(out, f, indent=2, ensure_ascii=False)
+    print(f"wrote {OUT}: {len(pages)} pages, "
+          f"{len(profile.get('extended_capabilities', []))} capabilities "
+          f"({'auto' if rebuild_caps or not old_profile else 'curated, preserved'})")
+
+
+if __name__ == "__main__":
+    main()

graph_build.py

@@ -29,9 +29,26 @@ except Exception:
     CURATED_HUB = {}
 
 KB_PATH = "library_kb.json"
+HIVE_KB_PATH = "hive_kb.json"
 OUT_PATH = "library_graph.json"
 GOV = "https://www.worcestershire.gov.uk"
 
+# Facility signals scanned across the Hive pages (same idea as build_kb.py).
+HIVE_FACILITY_VOCAB = {
+    "café": r"\bcaf[eé]\b",
+    "meeting rooms": r"\bmeeting rooms?|rooms? (for|to) hire|space for hire\b",
+    "study space": r"\bstudy (space|area|room)\b",
+    "free Wi-Fi": r"\bwi-?fi\b",
+    "public computers": r"\b(public )?computers?\b",
+    "printing": r"\bprint(ing)?|photocopy",
+    "public toilets": r"\btoilets?\b",
+    "baby changing": r"\bbaby chang",
+    "wheelchair access": r"\bwheelchair|step-?free|level access|accessib",
+    "archives": r"\barchives?\b",
+    "children's library": r"\bchildren'?s (library|area)\b",
+    "exhibition space": r"\bexhibition\b",
+}
+
 POSTCODE = re.compile(r"[A-Z]{1,2}\d[A-Z\d]?\s*\d[A-Z]{2}")
 
 
@@ -117,17 +134,76 @@ def build_graph(kb: dict) -> nx.Graph:
         if f"tier::{tier}" in G:
             G.add_edge(rid, f"tier::{tier}", rel="REQUIRES")
 
-    # --- Mobile library villages (best-effort live fetch) ---
+    # --- Mobile library villages (live fetch; falls back to the last graph) ---
     mob = add("service::Mobile library", "Service", "Mobile library",
               category="access",
               url=f"{GOV}/council-services/libraries/your-library-membership/mobile-library")
+    villages: dict[str, str] = {}
     try:
         from library_sources import _village_index
-        for name, url in list(_village_index().items()):
-            vid = add(f"village::{name}", "Village", name.title(), url=url)
-            G.add_edge(vid, mob, rel="SERVED_BY")
+        villages = dict(_village_index())
     except Exception as e:
-        print(f"  (mobile villages skipped: {e})")
+        try:  # offline rebuild: keep the villages from the previous graph
+            with open(OUT_PATH, encoding="utf-8") as f:
+                for n in json.load(f).get("nodes", []):
+                    if n.get("type") == "Village":
+                        villages[n["label"].lower()] = n.get("url", "")
+            print(f"  (mobile villages: live fetch failed [{e}]; "
+                  f"kept {len(villages)} from previous graph)")
+        except Exception:
+            print(f"  (mobile villages skipped: {e})")
+    for name, url in villages.items():
+        vid = add(f"village::{name}", "Village", name.title(), url=url)
+        G.add_edge(vid, mob, rel="SERVED_BY")
+
+    # --- The Hive: page-level KB -> enrich the branch + capability nodes ---
+    try:
+        with open(HIVE_KB_PATH, encoding="utf-8") as f:
+            hive = json.load(f)
+    except FileNotFoundError:
+        hive = {}
+    if hive:
+        prof = hive.get("hive_profile", {})
+        pages = [p for p in hive.get("pages", []) if not p.get("error")]
+        hive_id = next((n for n in G.nodes
+                        if n.startswith("branch::") and "hive" in n.lower()), None)
+        blob = " ".join(o for p in pages for o in p.get("offerings", []))
+        facilities = [name for name, pat in HIVE_FACILITY_VOCAB.items()
+                      if re.search(pat, blob, re.I)]
+        hours = (prof.get("opening_hours") or {}).get("building", "")
+        attrs = dict(
+            open_late=True,  # 8:30am–10pm, seven days — later than Unlocked
+            hive_hours=hours, source="thehiveworcester.org",
+            partnership=prof.get("partnership", "")[:200],
+            summary="Worcester city's library — Europe's first joint university "
+                    "+ public library, open 8:30am–10pm every day.",
+        )
+        if hive_id:  # enrich the council-crawled branch node
+            G.nodes[hive_id].update(attrs)
+            facs = set(G.nodes[hive_id].get("facilities", [])) | set(facilities)
+            G.nodes[hive_id]["facilities"] = sorted(facs)
+            for fac in facs:
+                fid = add(f"facility::{fac}", "Facility", fac)
+                G.add_edge(hive_id, fid, rel="HAS_FACILITY")
+        else:
+            hive_id = add("branch::The Hive", "Branch", "The Hive",
+                          address=prof.get("address", ""), facilities=facilities,
+                          url="https://www.thehiveworcester.org", **attrs)
+            for fac in facilities:
+                fid = add(f"facility::{fac}", "Facility", fac)
+                G.add_edge(hive_id, fid, rel="HAS_FACILITY")
+        aid = add("area::Worcester", "Area", "Worcester")
+        G.add_edge(hive_id, aid, rel="LOCATED_IN")
+        for cap in prof.get("extended_capabilities", []):
+            if not isinstance(cap, dict):
+                continue
+            label = cap.get("capability", "")[:80]
+            if not label:
+                continue
+            cid = add(f"hive::{label}", "HiveService", label,
+                      summary=cap.get("detail", ""), url=cap.get("source", ""),
+                      source="thehiveworcester.org")
+            G.add_edge(hive_id, cid, rel="OFFERS")
 
     return G
 
@@ -166,7 +242,7 @@ def main():
 
     out = {
         "generated": datetime.now(timezone.utc).isoformat(timespec="seconds"),
-        "built_from": KB_PATH,
+        "built_from": f"{KB_PATH} + {HIVE_KB_PATH}",
         "method": "deterministic GraphRAG-style graph (entities->relationships->"
                   "communities->reports); inspired by microsoft/graphrag",
         "stats": {"nodes": G.number_of_nodes(), "edges": G.number_of_edges(),

graph_rag.py

@@ -29,6 +29,8 @@ FACILITY_TERMS = {
     "wheelchair": "wheelchair", "accessible": "accessible", "disabled": "accessible",
     "meeting room": "meeting", "meeting": "meeting", "print": "printing",
     "photocopy": "printing", "self-service": "self",
+    "archive": "archive", "archives": "archive", "archaeology": "archive",
+    "children": "child", "kids": "child", "exhibition": "exhibition",
 }
 LATE_TERMS = ["late", "unlocked", "8pm", "evening", "after work", "after hours",
               "open late", "out of hours"]
@@ -80,7 +82,7 @@ def local_search(query: str) -> dict:
     if wanted or want_late or (area and "librar" in q):
         results = []
         for b in g["by_type"].get("Branch", []):
-            if want_late and not b.get("libraries_unlocked"):
+            if want_late and not (b.get("libraries_unlocked") or b.get("open_late")):
                 continue
             if area and area.lower() not in (b.get("address", "")).lower():
                 continue
@@ -93,6 +95,8 @@ def local_search(query: str) -> dict:
             "late": want_late, "area": area,
             "branches": [{"name": b["label"], "facilities": b.get("facilities", []),
                           "libraries_unlocked": b.get("libraries_unlocked", False),
+                          "open_late": b.get("open_late", False),
+                          "late_hours": b.get("hive_hours", ""),
                           "address": b.get("address", ""), "url": b.get("url", "")}
                          for b in results],
             "count": len(results),

index.html

@@ -74,9 +74,10 @@
   <header>
     <span class="live">● live data</span>
     <h1>Worcestershire Libraries</h1>
-    <p>Ask about books, the mobile library, events, printing and what's free
-       online — answered live from the council site &amp; catalogue, with exactly
-       what you need to sign up.</p>
+    <p>Exactly where to get the book you want, everything The Hive offers,
+       the mobile library, events, printing and what's free online — from the
+       council site, catalogue &amp; every Hive page, with exactly what you
+       need to sign up.</p>
   </header>
 
   <main id="log">
@@ -86,19 +87,19 @@
   </main>
 
   <div class="chips" id="chips">
+    <div class="chip">How do I get Wolf Hall?</div>
+    <div class="chip">What can I do at The Hive?</div>
     <div class="chip">Is Malvern library open now?</div>
     <div class="chip">A late-opening library with a café and meeting rooms</div>
     <div class="chip">Can I read newspapers for free?</div>
-    <div class="chip">When does the mobile library visit Abberley?</div>
-    <div class="chip">What do I need to sign up?</div>
   </div>
 
   <form id="form" autocomplete="off">
     <input id="box" placeholder="Ask anything about your local library…" autofocus />
     <button id="send" type="submit">Ask</button>
   </form>
-  <footer>Checked live against official council sources ·
-    runs on a ≤32B model</footer>
+  <footer>Official sources only — council site &amp; catalogue checked live,
+    plus every page of the Hive's own site · runs on a ≤32B model</footer>
 </div>
 
 <script type="module">

library_graph.json

@@ -1,21 +1,22 @@
 {
-  "generated": "2026-06-11T22:51:11+00:00",
-  "built_from": "library_kb.json",
+  "generated": "2026-06-12T21:47:08+00:00",
+  "built_from": "library_kb.json + hive_kb.json",
   "method": "deterministic GraphRAG-style graph (entities->relationships->communities->reports); inspired by microsoft/graphrag",
   "stats": {
-    "nodes": 320,
-    "edges": 465,
-    "communities": 8,
+    "nodes": 349,
+    "edges": 502,
+    "communities": 9,
     "node_types": {
       "Membership": 3,
       "Hub": 1,
       "Branch": 23,
-      "Facility": 11,
+      "Facility": 14,
       "Area": 17,
       "Service": 87,
       "Topic": 7,
       "Resource": 17,
-      "Village": 154
+      "Village": 154,
+      "HiveService": 26
     }
   },
   "nodes": [
@@ -875,9 +876,26 @@
           "staffed": "8:30am to 10:00pm"
         }
       },
-      "facilities": [],
+      "facilities": [
+        "archives",
+        "café",
+        "children's library",
+        "exhibition space",
+        "free Wi-Fi",
+        "meeting rooms",
+        "printing",
+        "public computers",
+        "public toilets",
+        "study space",
+        "wheelchair access"
+      ],
       "libraries_unlocked": false,
-      "url": "https://www.worcestershire.gov.uk/council-services/libraries/find-library/hive"
+      "url": "https://www.worcestershire.gov.uk/council-services/libraries/find-library/hive",
+      "open_late": true,
+      "hive_hours": "The Hive is open from 8:30am - 10pm, Monday to Sunday (opening-hours.html; plan-your-visit.html states 'Monday to Sunday 8.30am - 10.00 pm')",
+      "source": "thehiveworcester.org",
+      "partnership": "Joint venture of the University of Worcester and Worcestershire County Council - 'The Hive is the first joint public and university library in Europe' (services.html, using-the-library.html). Built wi",
+      "summary": "Worcester city's library — Europe's first joint university + public library, open 8:30am–10pm every day."
     },
     {
       "id": "branch::Upton-Upon-Severn Library",
@@ -2152,7 +2170,7 @@
       "summary": "Free eBooks & eAudiobooks — latest titles, award winners, non-fiction, classics and children's, plus the curated 'Worcestershire Reads' picks.",
       "what_you_need": "Library card number + PIN; choose 'Worcestershire' in the app.",
       "access": [
-        "Download the BorrowBox app.",
+        "Download the BorrowBox app — [iPhone/iPad](https://apps.apple.com/app/borrowbox-library/id562843562) or [Android](https://play.google.com/store/apps/details?id=com.bolindadigital.BorrowBoxLibrary).",
         "Select 'Worcestershire' as your library service.",
         "Sign in with your card number + PIN."
       ],
@@ -2277,7 +2295,7 @@
       "summary": "7,000+ full-page newspapers & magazines, 60+ languages, 120+ countries.",
       "what_you_need": "Worcestershire library card number + PIN (free full membership, residents). No separate PressReader account needed.",
       "access": [
-        "Get the PressReader app (or use pressreader.com).",
+        "Get the PressReader app — [iPhone/iPad](https://apps.apple.com/app/pressreader/id313904711) or [Android](https://play.google.com/store/apps/details?id=com.newspaperdirect.pressreader.android) — or read in your browser at [pressreader.com](https://www.pressreader.com).",
         "Tap 'Libraries & Groups' and search/select 'Worcestershire'.",
         "Sign in with your library card number + PIN.",
         "At home you get a 30-day pass (re-confirm monthly); on library Wi-Fi it's 7 days."
@@ -3252,6 +3270,229 @@
       "type": "Village",
       "label": "Wychbold",
       "url": "https://www.worcestershire.gov.uk/council-services/worcestershire-libraries/your-library-membership/mobile-library/wychbold"
+    },
+    {
+      "id": "facility::exhibition space",
+      "type": "Facility",
+      "label": "exhibition space"
+    },
+    {
+      "id": "facility::children's library",
+      "type": "Facility",
+      "label": "children's library"
+    },
+    {
+      "id": "facility::archives",
+      "type": "Facility",
+      "label": "archives"
+    },
+    {
+      "id": "hive::First joint public and university library in Europe",
+      "type": "HiveService",
+      "label": "First joint public and university library in Europe",
+      "summary": "Community members and university students get the same user experience; no segregation - university stock shelved alongside public stock; staff from both university and council work throughout the library; all users access the same services.",
+      "url": "https://www.thehiveworcester.org/using-the-library.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::Exceptionally long opening hours",
+      "type": "HiveService",
+      "label": "Exceptionally long opening hours",
+      "summary": "Open 8:30am - 10pm, Monday to Sunday (every day of the week).",
+      "url": "https://www.thehiveworcester.org/opening-hours.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::Explore the Past - Worcestershire Archive & Archaeology Service (Level 2)",
+      "type": "HiveService",
+      "label": "Explore the Past - Worcestershire Archive & Archaeology Service (Level 2)",
+      "summary": "Home to the Worcestershire Archive and Archaeology Service; thousands of archaeological sites, historic buildings and landscapes recorded; 12 miles of original archives collected and preserved. Offers: area for consulting original archives on level 2; guidance from knowledgeable staff; facility to talk to archaeologists and access the archaeological record; large self-service area for microform and internet sources; local studies and archaeology library; a conservation room for the repair and preservation of documents; prearranged 'behind the scenes' group visits; programme of history and archaeology events for all ages. Original-document viewings (e.g. Stuart Collection) take place in the original documents examination room within 'access to original archives' opening hours.",
+      "url": "https://www.thehiveworcester.org/explore-the-past.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::Historic Environment Record (HER) access",
+      "type": "HiveService",
+      "label": "Historic Environment Record (HER) access",
+      "summary": "Searchable database with digital mapping of all known archaeological sites, historic buildings and landscapes in the county; online search via Heritage Gateway; for detailed enquiries you can book to see an HER officer at The Hive.",
+      "url": "https://www.thehiveworcester.org/catalogue-search.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::Three online catalogues",
+      "type": "HiveService",
+      "label": "Three online catalogues",
+      "summary": "Library catalogue search (quarter of a million titles plus all County branches, via wcc.ent.sirsidynix.net.uk), Archaeology report search (Heritage Gateway) and Archives search (CalmView at e-services.worcestershire.gov.uk).",
+      "url": "https://www.thehiveworcester.org/catalogue-search.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::Business & IP Centre (BIPC) Worcestershire (Level 2)",
+      "type": "HiveService",
+      "label": "Business & IP Centre (BIPC) Worcestershire (Level 2)",
+      "summary": "The Business Centre at The Hive is home to BIPC Worcestershire, providing free and accessible business advice, support, information and resources, plus well-appointed meeting rooms with the latest technology. Free business databases COBRA (Complete Business Reference Adviser), Statista and FAME are accessible from any public computer in The Hive; start-up support, Intellectual Property information and funding signposted via the BIPC Worcestershire website.",
+      "url": "https://www.thehiveworcester.org/business-centre.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::Careers Worcs Youth Hub (Level 1)",
+      "type": "HiveService",
+      "label": "Careers Worcs Youth Hub (Level 1)",
+      "summary": "Dedicated space for young people aged 15-24, open Monday-Friday 9am-4pm, with careers advisors providing 1-1 advice, CV writing, job search, interview preparation, apprenticeships/training routes, plus finance and health & wellbeing services. Careers Helpline 0300 666 3666.",
+      "url": "https://www.thehiveworcester.org/youthhub.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::800+ study spaces and bookable study spaces for students",
+      "type": "HiveService",
+      "label": "800+ study spaces and bookable study spaces for students",
+      "summary": "Over 800 study spaces across The Hive available to use for study; Level 0 can be used for group study; Level 4 is the silent study floor; 250 new computers bookable in advance (students page).",
+      "url": "https://www.thehiveworcester.org/book-a-space.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::Room hire / Space for hire with online booking and video conferencing",
+      "type": "HiveService",
+      "label": "Room hire / Space for hire with online booking and video conferencing",
+      "summary": "From small huddle rooms to large function rooms at competitive prices; online booking system (librarybookings.worcestershire.gov.uk) with 360-degree virtual tours; new video-conferencing technology in many meeting rooms; concessionary rates for not-for-profit organisations; minimum one-hour charge with additional half hours; all prices include public liability insurance; University of Worcester members can book Hive rooms free for specific purposes; exhibition space also available for hire.",
+      "url": "https://www.thehiveworcester.org/space-for-hire.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::On-site hospitality catering (Bellrock)",
+      "type": "HiveService",
+      "label": "On-site hospitality catering (Bellrock)",
+      "summary": "The Hive has its own onsite catering company (also manages the cafe) offering hospitality menus - buffets, platters, canapes, business breakfasts - for meetings, corporate training and conferences; special diets catered for; minimum 2 working days' notice.",
+      "url": "https://www.thehiveworcester.org/catering.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::Cafe at The Hive (Level 1)",
+      "type": "HiveService",
+      "label": "Cafe at The Hive (Level 1)",
+      "summary": "Open Monday-Sunday 8.30am-9pm; hot and cold snacks, light meals, deli bar with made-to-order baguettes/sandwiches/salads; 10% student discount; five-star hygiene rating; fully accessible; Urban Eat ranges including vegan, vegetarian, gluten free and halal options.",
+      "url": "https://www.thehiveworcester.org/cafe.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::Children's library - one of the largest in the country (Level 1)",
+      "type": "HiveService",
+      "label": "Children's library - one of the largest in the country (Level 1)",
+      "summary": "Designed for children to find their own level; Story Pit recessed seating area for readings, performances and group work; access to 'Story Island', a unique outdoor teaching space for children accessed through the children's library; children-only PCs and printer/copier.",
+      "url": "https://www.thehiveworcester.org/children-young-people-families.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::Walk-in academic research databases",
+      "type": "HiveService",
+      "label": "Walk-in academic research databases",
+      "summary": "Free walk-in access inside the building for all library members to ~37 databases including Ancestry Library Edition, JSTOR, Academic Search Complete, Business Source Complete, CINAHL Complete, BMJ Journals, Oxford English Dictionary, Dictionary of National Biography, Times Digital Archive, Gale British newspapers, House of Commons Parliamentary Papers, Cambridge/Oxford/SAGE/Taylor & Francis journals, ScienceDirect, Project Muse, Drama Online and more.",
+      "url": "https://www.thehiveworcester.org/research-databases.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::Special collections",
+      "type": "HiveService",
+      "label": "Special collections",
+      "summary": "The Stuart Collection (over one-thousand books on Stuart-period Britain 1603-1714, bequeathed by John Grainger in 1900, many first/last surviving copies); the Palfrey Collection (antiquarian studies and first editions key to Worcestershire study); the Stanbrook Abbey Press Collection (closed access on level 4); extensive Local Studies and Archaeology libraries.",
+      "url": "https://www.thehiveworcester.org/special-collections.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::Research collections for family and local history",
+      "type": "HiveService",
+      "label": "Research collections for family and local history",
+      "summary": "Maps and plans (historic Ordnance Survey, tithe, inclosure and estate plans, many digital); census returns, International Genealogical Index, GRO Index of Births Marriages and Deaths, local newspapers, wills and probate; Worcestershire Photographic Survey and aerial photographic collections; archives of local families/businesses including the Earls of Coventry of Croome; Quarter Sessions, County and District Council records and the Worcester City Archive; Diocese of Worcester, parish and Non-conformist records.",
+      "url": "https://www.thehiveworcester.org/research-collections.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::Commissioned public art collection",
+      "type": "HiveService",
+      "label": "Commissioned public art collection",
+      "summary": "Kaleidoscope by Robert Orchardson (aluminium, 2012, visible from all three main floors); Rack Alley by Clare Woods (600x500cm enamel and oil on aluminium, 2012, commissioned for the atrium); two John Clare-inspired paintings by James Fisher (2008).",
+      "url": "https://www.thehiveworcester.org/art-collections.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::BorrowBox digital library (eBooks/eAudio)",
+      "type": "HiveService",
+      "label": "BorrowBox digital library (eBooks/eAudio)",
+      "summary": "eBook and eAudiobook service free to all library members 24/7 via library.bolindadigital.com/worcestershire or the BorrowBox app; borrow up to six eBooks and six eAudiobooks at a time; loans auto-expire with no late fees; syncs across up to six devices; requires library card number and PIN.",
+      "url": "https://www.thehiveworcester.org/ebooks.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::School and college visit packages",
+      "type": "HiveService",
+      "label": "School and college visit packages",
+      "summary": "More than 8,000 students hosted since 2012. Free 'Package 1' visits (library tour plus activities such as Storytime, Book Blitz, Coding with Scratch, research skills, referencing) for Early Years through Sixth Form; charged 'Package 2' Explore the Past history/archive/archaeology workshops from a minimum of £40 per hour/class (individual WAAS workshops around £80, 90-120 minutes, e.g. Romans in Worcester, Anglo-Saxons, Tudor Worcester, Civil War, Victorian public health, WWI, WWII archaeology); webinars available; classroom resource packs £20 each; teacher training days hosted.",
+      "url": "https://www.thehiveworcester.org/10252.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::Archaeology planning advice for developers (professional service)",
+      "type": "HiveService",
+      "label": "Archaeology planning advice for developers (professional service)",
+      "summary": "The Archive and Archaeology Service provides advice to landowners, developers and consultants on archaeological implications and opportunities of development in the County; advice on management and conservation of the rural and urban historic environment; workshops and training on heritage topics; plus professional services including digitisation, document conservation and a wide range of professional archaeological services.",
+      "url": "https://www.thehiveworcester.org/supporting-business.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::WAAS learning and outreach programme",
+      "type": "HiveService",
+      "label": "WAAS learning and outreach programme",
+      "summary": "Local history research groups, talks, workshops, tours, school activities, community excavations, archive film screenings, family history fairs, guided walks and a geology trail around The Hive.",
+      "url": "https://www.thehiveworcester.org/worcestershire-archive-archaeology.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::IT, gaming and printing on every level",
+      "type": "HiveService",
+      "label": "IT, gaming and printing on every level",
+      "summary": "Public access PCs with internet and Microsoft Office on Levels 0-4; group study screen with 46-inch HDMI display (L0); two PS4 gaming zones (L0); high-speed printers/copiers on every level with credit-card top-up kiosks (cash kiosk only at the L1 Hub); A4 scanners on request (L3); privacy filters available (L1 Hub); dedicated catalogue search stations.",
+      "url": "https://www.thehiveworcester.org/it-equipment-printing.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::The Studio theatre, exhibition spaces and Worcestershire Hub (Level 1)",
+      "type": "HiveService",
+      "label": "The Studio theatre, exhibition spaces and Worcestershire Hub (Level 1)",
+      "summary": "Level 1 'Discover' holds the children's library, the cafe, exhibition spaces and The Studio theatre as well as The Worcestershire Hub (county council customer services) and quick choice books; Level 2 also has meeting rooms and a Business Centre with a suite of three rooms, informal networking space and 24-hour newsfeed; secure archives on Level 0 with occasional special tours.",
+      "url": "https://www.thehiveworcester.org/inside-the-hive.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::Accessibility provision",
+      "type": "HiveService",
+      "label": "Accessibility provision",
+      "summary": "Fully accessible to wheelchairs, mobility scooters and pushchairs; lifts to all five public floors with Braille signage; Meet & Greet service bookable in advance; personal care suite on Level 1 with shower and lifting facilities (access card from staff); height-adjustable workstations and archive/microfilm tables; automated microfilm machine with foot pedal; induction loops in Meeting rooms 2, 3 and The Studio; 21 blue badge bays free for 3 hours in Cattlemarket car park; pre-arranged close access via Level 0; DisabledGo accessibility guide.",
+      "url": "https://www.thehiveworcester.org/physical-accessibility.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::Prayer space",
+      "type": "HiveService",
+      "label": "Prayer space",
+      "summary": "Rooms within The Hive can be used by customers to pray - ask a member of staff to be directed to an available room; Worcestershire County Council policy is to be equally supportive of all faiths.",
+      "url": "https://www.thehiveworcester.org/inside-the-hive.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::Award-winning sustainable landmark building",
+      "type": "HiveService",
+      "label": "Award-winning sustainable landmark building",
+      "summary": "Biomass boilers, River Severn river-water cooling, rainwater harvesting for WC flushing and archaeological washing, natural ventilation, water meadows for flood attenuation and 4000m2+ of biodiversity landscape; winner of 20+ awards including BREEAM Outstanding (2012), RIBA National Award (2013), SCONUL Library Design Award (2016) and ARA Record Keeping Service of the Year (2017); distinctive golden honeycomb cladding by Feilden Clegg Bradley Studios.",
+      "url": "https://www.thehiveworcester.org/sustainability.html",
+      "source": "thehiveworcester.org"
+    },
+    {
+      "id": "hive::Membership without barriers",
+      "type": "HiveService",
+      "label": "Membership without barriers",
+      "summary": "Instant free digital membership online (eBooks, eAudio, eMagazines and online resources) upgradeable to full membership with proof of name and address; UW students/staff use their university ID as their library card; dedicated Children's library card (designed by Liz Pichon) and Young Person's library card for ages 13-19; instant membership for ages 8-16 allows borrowing 2 books without a parent signature; full members get free computer/Wi-Fi access, DVD/Blu-ray hire, library activities and adult and family learning courses.",
+      "url": "https://www.thehiveworcester.org/how-to-get-a-library-card.html",
+      "source": "thehiveworcester.org"
     }
   ],
   "edges": [
@@ -3720,6 +3961,11 @@
       "target": "branch::Woodrow Library",
       "rel": "HAS_FACILITY"
     },
+    {
+      "source": "facility::public toilets",
+      "target": "branch::The Hive",
+      "rel": "HAS_FACILITY"
+    },
     {
       "source": "facility::accessible toilet",
       "target": "branch::Catshill Community Library",
@@ -3960,6 +4206,11 @@
       "target": "branch::Wythall Library",
       "rel": "HAS_FACILITY"
     },
+    {
+      "source": "facility::wheelchair access",
+      "target": "branch::The Hive",
+      "rel": "HAS_FACILITY"
+    },
     {
       "source": "facility::free Wi-Fi",
       "target": "branch::Bewdley Library",
@@ -4060,6 +4311,11 @@
       "target": "branch::Wythall Library",
       "rel": "HAS_FACILITY"
     },
+    {
+      "source": "facility::free Wi-Fi",
+      "target": "branch::The Hive",
+      "rel": "HAS_FACILITY"
+    },
     {
       "source": "facility::meeting rooms",
       "target": "branch::Bromsgrove Library",
@@ -4115,6 +4371,11 @@
       "target": "branch::Woodrow Library",
       "rel": "HAS_FACILITY"
     },
+    {
+      "source": "facility::meeting rooms",
+      "target": "branch::The Hive",
+      "rel": "HAS_FACILITY"
+    },
     {
       "source": "facility::printing",
       "target": "branch::Bewdley Library",
@@ -4210,6 +4471,11 @@
       "target": "branch::Wythall Library",
       "rel": "HAS_FACILITY"
     },
+    {
+      "source": "facility::printing",
+      "target": "branch::The Hive",
+      "rel": "HAS_FACILITY"
+    },
     {
       "source": "area::Birmingham",
       "target": "branch::Rubery Library",
@@ -4250,6 +4516,11 @@
       "target": "branch::Malvern Library",
       "rel": "HAS_FACILITY"
     },
+    {
+      "source": "facility::public computers",
+      "target": "branch::The Hive",
+      "rel": "HAS_FACILITY"
+    },
     {
       "source": "area::Bromsgrove",
       "target": "branch::Catshill Community Library",
@@ -4295,6 +4566,11 @@
       "target": "branch::Warndon Library",
       "rel": "HAS_FACILITY"
     },
+    {
+      "source": "facility::study space",
+      "target": "branch::The Hive",
+      "rel": "HAS_FACILITY"
+    },
     {
       "source": "branch::Hagley Library",
       "target": "area::Stourbridge",
@@ -4320,6 +4596,11 @@
       "target": "branch::Wythall Library",
       "rel": "HAS_FACILITY"
     },
+    {
+      "source": "facility::café",
+      "target": "branch::The Hive",
+      "rel": "HAS_FACILITY"
+    },
     {
       "source": "branch::Martley Library",
       "target": "area::Martley",
@@ -4365,6 +4646,151 @@
       "target": "area::Wells",
       "rel": "LOCATED_IN"
     },
+    {
+      "source": "branch::The Hive",
+      "target": "facility::exhibition space",
+      "rel": "HAS_FACILITY"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "facility::children's library",
+      "rel": "HAS_FACILITY"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "facility::archives",
+      "rel": "HAS_FACILITY"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::First joint public and university library in Europe",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::Exceptionally long opening hours",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::Explore the Past - Worcestershire Archive & Archaeology Service (Level 2)",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::Historic Environment Record (HER) access",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::Three online catalogues",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::Business & IP Centre (BIPC) Worcestershire (Level 2)",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::Careers Worcs Youth Hub (Level 1)",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::800+ study spaces and bookable study spaces for students",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::Room hire / Space for hire with online booking and video conferencing",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::On-site hospitality catering (Bellrock)",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::Cafe at The Hive (Level 1)",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::Children's library - one of the largest in the country (Level 1)",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::Walk-in academic research databases",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::Special collections",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::Research collections for family and local history",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::Commissioned public art collection",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::BorrowBox digital library (eBooks/eAudio)",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::School and college visit packages",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::Archaeology planning advice for developers (professional service)",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::WAAS learning and outreach programme",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::IT, gaming and printing on every level",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::The Studio theatre, exhibition spaces and Worcestershire Hub (Level 1)",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::Accessibility provision",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::Prayer space",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::Award-winning sustainable landmark building",
+      "rel": "OFFERS"
+    },
+    {
+      "source": "branch::The Hive",
+      "target": "hive::Membership without barriers",
+      "rel": "OFFERS"
+    },
     {
       "source": "branch::Upton-Upon-Severn Library",
       "target": "area::Upton-Upon-Severn",
@@ -5587,382 +6013,419 @@
       "title": "Cluster 1: 1 service",
       "size": 155,
       "members": [
-        "village::norton",
-        "village::white ladies aston",
-        "village::crowle",
-        "village::wolverley",
-        "village::guarlford",
-        "village::rock",
-        "village::callow hill redditch",
-        "village::abberley",
-        "village::stoke prior",
-        "village::eldersfield",
-        "village::newnham bridge",
-        "village::kyre",
-        "service::Mobile library",
-        "village::uckinghall",
-        "village::pendock",
+        "village::rushock",
         "village::sneachill",
-        "village::habberley",
-        "village::honeybourne",
-        "village::fernhill heath",
-        "village::westmancote",
-        "village::grafton flyford",
-        "village::rous lench",
-        "village::caunsall",
-        "village::romsley",
+        "village::grimley",
+        "village::ripple",
+        "village::new end",
+        "village::ryall",
+        "village::flyford flavell",
+        "village::harvington evesham",
+        "village::hanley childe",
+        "village::earls common",
+        "village::charlton",
+        "village::sytchampton",
+        "village::overbury",
+        "village::shatterford",
+        "village::newnham bridge",
+        "village::peopleton",
+        "village::ombersley",
+        "village::pirton",
+        "village::south littleton",
+        "village::church lench",
+        "village::cleeve prior",
+        "village::sledge green",
         "village::aston somerville",
-        "village::suckley",
-        "village::blakedown",
-        "village::pound green",
-        "village::himbleton",
-        "village::newland",
-        "village::astley",
-        "village::netherton",
-        "village::bayton",
-        "village::bliss gate",
-        "village::broad green",
-        "village::leigh",
-        "village::portway",
-        "village::stoke bliss",
+        "village::stoke prior",
+        "village::norchard",
+        "village::honeybourne",
+        "village::sedgeberrow",
+        "village::throckmorton",
         "village::dunley",
-        "village::eardiston",
-        "village::wychbold",
-        "village::astwood bank",
-        "village::bradley green",
-        "village::fladbury",
-        "village::clows top",
-        "village::cookley",
-        "village::drayton",
-        "village::holt heath",
-        "village::littleworth",
+        "village::pound green",
         "village::ashton under hill",
-        "village::clifton teme",
-        "village::stone",
-        "village::leigh sinton",
-        "village::hunnington",
-        "village::hatfield",
-        "village::bredicot",
-        "village::belbroughton",
-        "village::pensax",
-        "village::little witley",
-        "village::church lench",
-        "village::pebworth",
-        "village::wadborough",
-        "village::shatterford",
-        "village::bickmarsh",
-        "village::overbury",
-        "village::inkberrow",
         "village::kemerton",
-        "village::naunton",
-        "village::far forest",
-        "village::grimley",
-        "village::sale green",
-        "village::shrawley",
-        "village::south littleton",
-        "village::bishampton",
-        "village::harpley",
-        "village::ombersley",
-        "village::callow hill stourport",
-        "village::ab lench",
-        "village::hanbury",
-        "village::hallow",
-        "village::harvington stourport",
-        "village::ockeridge",
-        "village::bransford",
+        "village::belbroughton",
         "village::north littleton",
-        "village::new end",
+        "village::clifton teme",
+        "village::romsley",
+        "village::fernhill heath",
+        "village::middle littleton",
+        "village::crowle",
+        "village::kington",
+        "village::drayton",
+        "village::netherton",
+        "service::Mobile library",
+        "village::bickmarsh",
+        "village::severn stoke",
+        "village::broughton hackett",
+        "village::lower sapey",
+        "village::uckinghall",
+        "village::chatley",
+        "village::kempsey",
+        "village::broadwas",
+        "village::longley green",
+        "village::norton",
+        "village::bretforton",
+        "village::pinvin",
+        "village::littleworth",
+        "village::dormston",
+        "village::feckenham",
+        "village::white ladies aston",
+        "village::bliss gate",
+        "village::broad green",
+        "village::lower moor",
         "village::hook",
-        "village::childswickham",
         "village::collets green",
-        "village::radford",
-        "village::kinsham",
-        "village::eckington",
-        "village::button oak",
+        "village::westmancote",
+        "village::alfrick",
         "village::newtown",
-        "village::norchard",
-        "village::flyford flavell",
-        "village::earls common",
-        "village::broadwas",
+        "village::elmbridge",
         "village::bredon",
+        "village::hunnington",
+        "village::radford",
+        "village::castlemorton",
+        "village::cropthorne",
+        "village::eckington",
+        "village::great witley",
+        "village::astley",
+        "village::eardiston",
+        "village::upton snodsbury",
+        "village::kinnersley",
+        "village::little witley",
+        "village::hanbury",
+        "village::callow hill stourport",
+        "village::ab lench",
+        "village::kinsham",
+        "village::habberley",
+        "village::stock green",
+        "village::callow end",
+        "village::kyre",
+        "village::sale green",
+        "village::wichenford",
+        "village::beckford",
+        "village::bayton",
+        "village::suckley",
         "village::hadley",
-        "village::sledge green",
+        "village::clows top",
+        "village::stoke bliss",
+        "village::portway",
+        "village::tibberton",
+        "village::wadborough",
+        "village::naunton",
+        "village::inkberrow",
         "village::summerfield",
-        "village::pirton",
-        "village::powick",
+        "village::shrawley",
         "village::mamble",
-        "village::lye head",
-        "village::bredons norton",
-        "village::sedgeberrow",
-        "village::hanley childe",
-        "village::cropthorne",
-        "village::woodgate",
-        "village::tibberton",
-        "village::longley green",
-        "village::kinnersley",
-        "village::pinvin",
+        "village::bishampton",
         "village::drakes broughton",
-        "village::broughton hackett",
-        "village::stock green",
+        "village::caunsall",
+        "village::far forest",
         "village::lower broadheath",
-        "village::beckford",
-        "village::sytchampton",
-        "village::severn stoke",
-        "village::elmbridge",
-        "village::feckenham",
-        "village::longdon",
+        "village::leigh",
+        "village::stone",
+        "village::harvington stourport",
         "village::bushley",
-        "village::ripple",
-        "village::charlton",
-        "village::corse lawn",
-        "village::middle littleton",
-        "village::alfrick",
-        "village::menith wood",
-        "village::stoulton",
-        "village::castlemorton",
+        "village::hallow",
+        "village::hanley swan",
         "village::cookhill",
-        "village::callow end",
-        "village::dormston",
-        "village::kington",
+        "village::pensax",
+        "village::bredicot",
+        "village::cookley",
+        "village::harpley",
+        "village::menith wood",
         "village::chaddesley corbett",
-        "village::rushock",
-        "village::wichenford",
-        "village::cleeve prior",
-        "village::hanley swan",
-        "village::lower sapey",
-        "village::upton snodsbury",
-        "village::lower moor",
-        "village::throckmorton",
-        "village::ryall",
-        "village::great witley",
-        "village::bretforton",
+        "village::corse lawn",
+        "village::astwood bank",
+        "village::longdon",
+        "village::himbleton",
+        "village::eldersfield",
+        "village::blakedown",
+        "village::bradley green",
+        "village::pendock",
+        "village::wolverley",
+        "village::bredons norton",
+        "village::guarlford",
+        "village::leigh sinton",
+        "village::pebworth",
+        "village::childswickham",
+        "village::holt heath",
+        "village::rous lench",
         "village::bridges stone",
-        "village::kempsey",
-        "village::peopleton",
+        "village::callow hill redditch",
+        "village::wychbold",
+        "village::hatfield",
+        "village::lye head",
+        "village::powick",
+        "village::newland",
+        "village::rock",
+        "village::bransford",
+        "village::ockeridge",
         "village::little clevelode",
-        "village::chatley",
-        "village::harvington evesham"
+        "village::grafton flyford",
+        "village::abberley",
+        "village::button oak",
+        "village::woodgate",
+        "village::fladbury",
+        "village::stoulton"
       ],
       "report": "Service: Mobile library | Village: Ab Lench, Abberley, Alfrick, Ashton Under Hill, Astley, Aston Somerville, Astwood Bank, Bayton, Beckford, Belbroughton, Bickmarsh, Bishampton"
     },
     {
       "id": "community::1",
-      "title": "Cluster 2: 23 branchs, 17 areas, 2 services",
-      "size": 54,
+      "title": "Cluster 2: 22 branchs, 17 areas, 11 facilitys",
+      "size": 50,
       "members": [
-        "area::Wells",
-        "area::Kidderminster",
-        "area::Spa",
-        "branch::Rubery Library",
+        "branch::Tenbury Wells Library",
+        "branch::Kidderminster Library",
+        "facility::public computers",
+        "branch::Bewdley Library",
+        "area::Redditch",
         "branch::Martley Library",
-        "area::Worcester",
+        "facility::self-service",
+        "area::Birmingham",
+        "branch::Pershore Library",
+        "branch::Droitwich Spa Library",
+        "branch::Catshill Community Library",
+        "area::Broadway",
+        "branch::Upton-Upon-Severn Library",
+        "facility::wheelchair access",
         "area::Bewdley",
-        "facility::public toilets",
-        "tier::Libraries Unlocked",
         "branch::Malvern Library",
-        "branch::Warndon Library",
-        "branch::Welland Library",
-        "area::Birmingham",
-        "area::Bromsgrove",
-        "branch::Broadway Library",
+        "facility::study space",
+        "area::Wells",
         "area::Pershore",
+        "branch::Warndon Library",
+        "branch::Stourport-on-Severn Library",
+        "branch::Alvechurch Library",
+        "branch::Bromsgrove Library",
+        "area::Worcester",
+        "area::Welland",
+        "branch::Redditch Library",
         "area::Severn",
-        "facility::meeting rooms",
-        "area::Malvern",
-        "area::Redditch",
-        "facility::baby changing",
-        "branch::Bewdley Library",
-        "area::Upton-Upon-Severn",
-        "facility::free Wi-Fi",
-        "area::Broadway",
-        "area::Martley",
         "branch::Evesham Library",
-        "branch::Bromsgrove Library",
-        "branch::Upton-Upon-Severn Library",
-        "facility::public computers",
-        "facility::café",
-        "branch::Alvechurch Library",
-        "branch::Kidderminster Library",
-        "branch::Droitwich Spa Library",
         "branch::St. John's Library",
-        "service::Great news for Malvern’s library members as Libraries Unlocked launches next week",
-        "facility::self-service",
-        "branch::Woodrow Library",
-        "branch::Hagley Library",
+        "area::Spa",
+        "facility::public toilets",
+        "branch::Broadway Library",
         "area::Evesham",
-        "facility::wheelchair access",
-        "facility::accessible toilet",
-        "area::Welland",
-        "branch::Pershore Library",
+        "facility::free Wi-Fi",
+        "branch::Wythall Library",
+        "branch::Welland Library",
         "facility::printing",
-        "facility::study space",
-        "branch::Redditch Library",
-        "branch::Tenbury Wells Library",
-        "branch::The Hive",
-        "branch::Stourport-on-Severn Library",
-        "service::Libraries",
+        "facility::baby changing",
+        "facility::meeting rooms",
+        "facility::accessible toilet",
+        "branch::Hagley Library",
+        "facility::café",
+        "branch::Woodrow Library",
         "area::Stourbridge",
-        "branch::Catshill Community Library",
-        "branch::Wythall Library"
+        "area::Martley",
+        "area::Kidderminster",
+        "area::Malvern",
+        "area::Bromsgrove",
+        "area::Upton-Upon-Severn",
+        "branch::Rubery Library"
       ],
-      "report": "Area: Bewdley, Birmingham, Broadway, Bromsgrove, Evesham, Kidderminster, Malvern, Martley, Pershore, Redditch, Severn, Spa | Branch: Alvechurch Library, Bewdley Library, Broadway Library, Bromsgrove Library, Catshill Community Library, Droitwich Spa Library, Evesham Library, Hagley Library, Kidderminster Library, Malvern Library, Martley Library, Pershore Library | Facility: accessible toilet, baby changing, café, free Wi-Fi, meeting rooms, printing, public computers, public toilets, self-service, study space, wheelchair access | Membership: Libraries Unlocked | Service: Great news for Malvern’s library members as Libraries Unlocked launches next week, Libraries"
+      "report": "Area: Bewdley, Birmingham, Broadway, Bromsgrove, Evesham, Kidderminster, Malvern, Martley, Pershore, Redditch, Severn, Spa | Branch: Alvechurch Library, Bewdley Library, Broadway Library, Bromsgrove Library, Catshill Community Library, Droitwich Spa Library, Evesham Library, Hagley Library, Kidderminster Library, Malvern Library, Martley Library, Pershore Library | Facility: accessible toilet, baby changing, café, free Wi-Fi, meeting rooms, printing, public computers, public toilets, self-service, study space, wheelchair access"
     },
     {
       "id": "community::2",
       "title": "Cluster 3: 18 services, 17 resources, 2 memberships",
       "size": 40,
       "members": [
-        "resource::Ancestry",
-        "resource::Borrowbox",
-        "service::Emails and updates",
-        "resource::Theory Test Pro",
-        "resource::Oxford Dictionary of National Biography",
-        "resource::The Times Digital Archive",
-        "service::Business database reference resources",
+        "service::Renew a loan",
+        "tier::Digital membership",
+        "service::Join the library",
+        "topic::membership",
         "resource::Oxford English Dictionary",
-        "service::Explore free online library resources for learning, research and business",
-        "resource::Oxford Research Encyclopaedias",
-        "resource::Pressreader",
-        "service::Start or grow a business",
+        "service::Business facilities at Worcestershire libraries",
         "resource::Online events",
-        "resource::Oxford Reference",
-        "resource::Access to Research",
+        "service::Business networking",
+        "resource::Oxford Research Encyclopaedias",
         "service::Login to my library account",
-        "service::Renew a loan",
-        "service::Your library membership",
-        "service::Protect your business",
-        "service::Pay fees and charges",
-        "topic::membership",
+        "resource::Which?",
+        "resource::Access to Research",
+        "resource::Ancestry",
+        "service::Printing and photocopying services",
         "resource::British Film Institution (BFI Replay)",
-        "service::Library Service at Home",
+        "topic::business",
         "hub::online",
-        "service::Printing and photocopying services",
-        "resource::COBRA (Business Support)",
+        "service::Protect your business",
         "resource::EBSCO",
-        "service::Business facilities at Worcestershire libraries",
-        "tier::Digital membership",
-        "topic::business",
-        "tier::Full membership",
-        "service::Reserve your library books",
-        "service::Book a computer",
         "resource::ESPACENET",
-        "resource::Which?",
-        "service::About BIPC Worcestershire",
-        "service::Business networking",
+        "service::Pay fees and charges",
+        "resource::Pressreader",
         "resource::Digital library membership",
-        "service::Join the library",
-        "service::Get business books online"
+        "service::Library Service at Home",
+        "resource::Theory Test Pro",
+        "service::Emails and updates",
+        "service::Start or grow a business",
+        "resource::Oxford Dictionary of National Biography",
+        "service::About BIPC Worcestershire",
+        "service::Book a computer",
+        "resource::COBRA (Business Support)",
+        "resource::Borrowbox",
+        "resource::Oxford Reference",
+        "service::Get business books online",
+        "tier::Full membership",
+        "service::Business database reference resources",
+        "resource::The Times Digital Archive",
+        "service::Explore free online library resources for learning, research and business",
+        "service::Your library membership",
+        "service::Reserve your library books"
       ],
       "report": "Hub: Online library hub | Membership: Digital membership, Full membership | Resource: Access to Research, Ancestry, Borrowbox, British Film Institution (BFI Replay), COBRA (Business Support), Digital library membership, EBSCO, ESPACENET, Online events, Oxford Dictionary of National Biography, Oxford English Dictionary, Oxford Reference | Service: About BIPC Worcestershire, Book a computer, Business database reference resources, Business facilities at Worcestershire libraries, Business networking, Emails and updates, Explore free online library resources for learning, research and business, Get business books online, Join the library, Library Service at Home, Login to my library account, Pay fees and charges | Topic: Business, Membership"
     },
     {
       "id": "community::3",
-      "title": "Cluster 4: 33 services",
-      "size": 34,
+      "title": "Cluster 4: 35 services, 1 membership",
+      "size": 37,
       "members": [
-        "service::Find a library",
-        "service::No Printer? No Problem. Libraries Launch ‘Print Your Way’!",
+        "service::Hop into Spring with Easter-themed activities at your local library!",
+        "service::Survey launched to help shape library services across the county",
+        "service::Worcestershire’s Library Service at Home is changing lives",
         "service::Spine-tingling events this autumn at your local library",
-        "service::Alvechurch Library - New layout for all library pages V2",
-        "service::Alvechurch Library - New layout for all library pages V1",
         "service::Worcestershire’s Libraries inspire local primary school teachers",
+        "service::Library volunteering provides a new chapter for retiree Paul",
+        "service::Libraries Unlocked Launches Next Week at Redditch Library!",
         "service::Acclaimed Authors Set to Visit Worcestershire’s Libraries This Autumn",
-        "service::Early years information library",
-        "service::Worcestershire libraries get prepared for emergencies this ‘Save a Life September’",
         "service::Rooms for hire at your local library – book online today",
-        "service::Libraries Unlocked",
-        "service::Coming Soon: Free Dementia Events at Worcestershire's Libraries",
-        "topic::general",
+        "service::Early years information library",
         "service::Libraries Unlocked Launches Next Week at Tenbury Library!",
-        "service::Worcestershire’s Free Online Library - Perfect for the Festive Season",
-        "service::Survey launched to help shape library services across the county",
-        "service::Library events and activities",
-        "service::Discover the stories that shaped our town this May at Kidderminster Library!",
-        "service::2026 Libraries closing dates",
-        "service::Worcestershire’s Library Service at Home is changing lives",
-        "service::Improve Your Digital Skills at your Local Library",
-        "service::Hire a library meeting room",
-        "service::Libraries Unlocked is coming soon to Tenbury Library!",
-        "service::Exciting STEAM themed event coming to The Hive Library!",
         "service::Worcestershire library closures announced over Easter holidays",
-        "service::Library volunteering provides a new chapter for retiree Paul",
         "service::Worcestershire Libraries to Host Second ‘Power of Libraries Conference’ for Early Years Professionals",
-        "service::Discover Volunteering Opportunities at your local library",
-        "service::Libraries Unlocked is coming soon to Redditch Library!",
-        "service::Memories and Me",
-        "service::Libraries Unlocked Launches Next Week at Redditch Library!",
         "service::Online library hub",
+        "service::Discover Volunteering Opportunities at your local library",
+        "service::2026 Libraries closing dates",
+        "service::Improve Your Digital Skills at your Local Library",
+        "service::Libraries Unlocked",
+        "service::No Printer? No Problem. Libraries Launch ‘Print Your Way’!",
         "service::New library book collection to guide families through pregnancy and early parenthood",
-        "service::Hop into Spring with Easter-themed activities at your local library!"
+        "service::Memories and Me",
+        "service::Find a library",
+        "tier::Libraries Unlocked",
+        "service::Worcestershire’s Free Online Library - Perfect for the Festive Season",
+        "service::Alvechurch Library - New layout for all library pages V1",
+        "service::Libraries",
+        "service::Coming Soon: Free Dementia Events at Worcestershire's Libraries",
+        "service::Libraries Unlocked is coming soon to Redditch Library!",
+        "service::Discover the stories that shaped our town this May at Kidderminster Library!",
+        "service::Hire a library meeting room",
+        "service::Exciting STEAM themed event coming to The Hive Library!",
+        "service::Alvechurch Library - New layout for all library pages V2",
+        "topic::general",
+        "service::Worcestershire libraries get prepared for emergencies this ‘Save a Life September’",
+        "service::Library events and activities",
+        "service::Great news for Malvern’s library members as Libraries Unlocked launches next week",
+        "service::Libraries Unlocked is coming soon to Tenbury Library!"
       ],
-      "report": "Service: 2026 Libraries closing dates, Acclaimed Authors Set to Visit Worcestershire’s Libraries This Autumn, Alvechurch Library - New layout for all library pages V1, Alvechurch Library - New layout for all library pages V2, Coming Soon: Free Dementia Events at Worcestershire's Libraries, Discover Volunteering Opportunities at your local library, Discover the stories that shaped our town this May at Kidderminster Library!, Early years information library, Exciting STEAM themed event coming to The Hive Library!, Find a library, Hire a library meeting room, Hop into Spring with Easter-themed activities at your local library! | Topic: General"
+      "report": "Membership: Libraries Unlocked | Service: 2026 Libraries closing dates, Acclaimed Authors Set to Visit Worcestershire’s Libraries This Autumn, Alvechurch Library - New layout for all library pages V1, Alvechurch Library - New layout for all library pages V2, Coming Soon: Free Dementia Events at Worcestershire's Libraries, Discover Volunteering Opportunities at your local library, Discover the stories that shaped our town this May at Kidderminster Library!, Early years information library, Exciting STEAM themed event coming to The Hive Library!, Find a library, Great news for Malvern’s library members as Libraries Unlocked launches next week, Hire a library meeting room | Topic: General"
     },
     {
       "id": "community::4",
-      "title": "Cluster 5: 13 services",
+      "title": "Cluster 5: 1 branch, 3 facilitys",
+      "size": 30,
+      "members": [
+        "hive::Prayer space",
+        "hive::Walk-in academic research databases",
+        "hive::Room hire / Space for hire with online booking and video conferencing",
+        "facility::children's library",
+        "hive::Special collections",
+        "hive::Three online catalogues",
+        "hive::Commissioned public art collection",
+        "facility::exhibition space",
+        "hive::On-site hospitality catering (Bellrock)",
+        "hive::Accessibility provision",
+        "hive::Award-winning sustainable landmark building",
+        "hive::Explore the Past - Worcestershire Archive & Archaeology Service (Level 2)",
+        "hive::Children's library - one of the largest in the country (Level 1)",
+        "hive::Cafe at The Hive (Level 1)",
+        "facility::archives",
+        "hive::Careers Worcs Youth Hub (Level 1)",
+        "hive::Research collections for family and local history",
+        "hive::The Studio theatre, exhibition spaces and Worcestershire Hub (Level 1)",
+        "hive::800+ study spaces and bookable study spaces for students",
+        "hive::First joint public and university library in Europe",
+        "branch::The Hive",
+        "hive::WAAS learning and outreach programme",
+        "hive::Membership without barriers",
+        "hive::Archaeology planning advice for developers (professional service)",
+        "hive::BorrowBox digital library (eBooks/eAudio)",
+        "hive::Business & IP Centre (BIPC) Worcestershire (Level 2)",
+        "hive::Historic Environment Record (HER) access",
+        "hive::Exceptionally long opening hours",
+        "hive::IT, gaming and printing on every level",
+        "hive::School and college visit packages"
+      ],
+      "report": "Branch: The Hive | Facility: archives, children's library, exhibition space | HiveService: 800+ study spaces and bookable study spaces for students, Accessibility provision, Archaeology planning advice for developers (professional service), Award-winning sustainable landmark building, BorrowBox digital library (eBooks/eAudio), Business & IP Centre (BIPC) Worcestershire (Level 2), Cafe at The Hive (Level 1), Careers Worcs Youth Hub (Level 1), Children's library - one of the largest in the country (Level 1), Commissioned public art collection, Exceptionally long opening hours, Explore the Past - Worcestershire Archive & Archaeology Service (Level 2)"
+    },
+    {
+      "id": "community::5",
+      "title": "Cluster 6: 13 services",
       "size": 14,
       "members": [
-        "service::Volunteering, training and work experience",
-        "service::Adult Learning Courses in libraries",
         "service::Digital Inclusion - Helping You Online",
         "service::Key Stage 1 and 2 (years 1 to 6)",
-        "service::Key Stage 3 and 4 (years 7 to 11)",
-        "service::Learn, upskill and find work",
-        "service::Job clubs",
         "service::Learning Outside the Classroom",
-        "service::Early Years and Reception",
-        "service::Online job-seeking support",
-        "service::Sixth form and college library support",
-        "service::Study Happy",
+        "service::Key Stage 3 and 4 (years 7 to 11)",
         "topic::learning",
-        "service::Book a visit"
+        "service::Study Happy",
+        "service::Sixth form and college library support",
+        "service::Adult Learning Courses in libraries",
+        "service::Online job-seeking support",
+        "service::Early Years and Reception",
+        "service::Job clubs",
+        "service::Book a visit",
+        "service::Learn, upskill and find work",
+        "service::Volunteering, training and work experience"
       ],
       "report": "Service: Adult Learning Courses in libraries, Book a visit, Digital Inclusion - Helping You Online, Early Years and Reception, Job clubs, Key Stage 1 and 2 (years 1 to 6), Key Stage 3 and 4 (years 7 to 11), Learn, upskill and find work, Learning Outside the Classroom, Online job-seeking support, Sixth form and college library support, Study Happy | Topic: Learning"
     },
     {
-      "id": "community::5",
-      "title": "Cluster 6: 11 services",
+      "id": "community::6",
+      "title": "Cluster 7: 11 services",
       "size": 12,
       "members": [
-        "service::Get school ready with Worcestershire's libraries",
-        "service::Free family fun this summer with Worcestershire Libraries & National Trust Croome",
-        "service::Celebrate World Book Day at your local library",
-        "service::Libraries ‘Go All In’ for the National Year of Reading 2026",
         "topic::seasonal",
+        "service::Get involved with the National Year of Reading 2026",
+        "service::Celebrate World Book Day at your local library",
+        "service::Free family fun this summer with Worcestershire Libraries & National Trust Croome",
         "service::Young Poet Laureate",
+        "service::Libraries ‘Go All In’ for the National Year of Reading 2026",
+        "service::Get school ready with Worcestershire's libraries",
         "service::Improve Your Digital Skills at Worcestershire Libraries This Summer!",
         "service::Summer Reading Challenge",
+        "service::Library Christmas and New Year opening times",
         "service::Library Christmas & New Year Opening Times",
-        "service::Aged 13–24? Volunteer with Worcestershire’s Libraries this summer",
-        "service::Get involved with the National Year of Reading 2026",
-        "service::Library Christmas and New Year opening times"
+        "service::Aged 13–24? Volunteer with Worcestershire’s Libraries this summer"
       ],
       "report": "Service: Aged 13–24? Volunteer with Worcestershire’s Libraries this summer, Celebrate World Book Day at your local library, Free family fun this summer with Worcestershire Libraries & National Trust Croome, Get involved with the National Year of Reading 2026, Get school ready with Worcestershire's libraries, Improve Your Digital Skills at Worcestershire Libraries This Summer!, Libraries ‘Go All In’ for the National Year of Reading 2026, Library Christmas & New Year Opening Times, Library Christmas and New Year opening times, Summer Reading Challenge, Young Poet Laureate | Topic: Seasonal"
     },
     {
-      "id": "community::6",
-      "title": "Cluster 7: 5 services",
+      "id": "community::7",
+      "title": "Cluster 8: 5 services",
       "size": 6,
       "members": [
-        "service::'Read & Unwind Time' at your local library",
         "service::Reading well",
-        "service::Worcestershire Reading Groups Recommend",
         "topic::reading",
+        "service::'Read & Unwind Time' at your local library",
         "service::Read and discover",
+        "service::Worcestershire Reading Groups Recommend",
         "service::Ask for a Book"
       ],
       "report": "Service: 'Read & Unwind Time' at your local library, Ask for a Book, Read and discover, Reading well, Worcestershire Reading Groups Recommend | Topic: Reading"
     },
     {
-      "id": "community::7",
-      "title": "Cluster 8: 4 services",
+      "id": "community::8",
+      "title": "Cluster 9: 4 services",
       "size": 5,
       "members": [
-        "service::Stay warm and connected at your local library this winter",
-        "service::Warm welcome",
-        "service::Connect with others and boost your wellbeing",
         "service::Libraries offer a free warm space to its residents this winter",
-        "topic::wellbeing"
+        "service::Connect with others and boost your wellbeing",
+        "service::Stay warm and connected at your local library this winter",
+        "topic::wellbeing",
+        "service::Warm welcome"
       ],
       "report": "Service: Connect with others and boost your wellbeing, Libraries offer a free warm space to its residents this winter, Stay warm and connected at your local library this winter, Warm welcome | Topic: Wellbeing"
     }

library_sources.py

@@ -1,12 +1,21 @@
 """
-library_sources.py — live data-mining tools for Worcestershire Libraries.
-
-Every function here pulls *live* data from official sources only:
-  - the SirsiDynix Enterprise catalogue  (wcc.ent.sirsidynix.net.uk)
-  - worcestershire.gov.uk library pages
-
-We deliberately do NOT scrape thehiveworcester.org — that content is
-unreliable and often years out of date. Council + catalogue only.
+library_sources.py — data-mining tools for Worcestershire Libraries,
+at every granularity:
+
+  service level   — every council library page         (library_kb.json, live)
+  page level      — every page of thehiveworcester.org (hive_kb.json)
+  item level      — the live SirsiDynix catalogue      (Atom feed)
+  copy level      — per-branch holdings on an item's detail page, so we can
+                    say WHERE to actually get the book/eBook someone wants
+
+Sources & provenance policy:
+  - the SirsiDynix Enterprise catalogue (wcc.ent.sirsidynix.net.uk) — live
+  - worcestershire.gov.uk library pages — live + crawled KB (canonical)
+  - thehiveworcester.org — crawled page-by-page (build_hive_kb.py); every
+    fact carries its source page + crawl date. Where Hive and council pages
+    conflict (hours, prices, membership), the COUNCIL page wins, and answers
+    say which source they used. The Hive site's own events page is static,
+    so live events always come from the council.
 
 No LLM, no Gradio in here — pure functions so they can be unit-tested
 against the live sites on their own.
@@ -35,6 +44,9 @@ CATALOGUE_RSS = "https://wcc.ent.sirsidynix.net.uk/client/rss/hitlist/wcc/qu="
 CATALOGUE_SEARCH = (
     "https://wcc.ent.sirsidynix.net.uk/client/en_GB/wcc/search/results?qu="
 )
+HIVE = "https://www.thehiveworcester.org"
+BORROWBOX = "https://library.bolindadigital.com/worcestershire"
+EXPLORE_PAST = "https://www.explorethepast.co.uk"
 MOBILE_INDEX = f"{GOV}/council-services/libraries/your-library-membership/mobile-library"
 EVENTS_URL = f"{GOV}/council-services/libraries/library-events-and-activities"
 PRINTING_URL = f"{GOV}/council-services/libraries/printing-and-photocopying-services"
@@ -139,6 +151,10 @@ def search_catalogue(query: str, limit: int = 8) -> dict:
                     break
 
         fmt, digital = _classify(fields)
+        ea_url = ""
+        if fields.get("Electronic Access"):
+            m = re.search(r"https?://\S+", fields["Electronic Access"])
+            ea_url = m.group(0).rstrip('".,)') if m else ""
         items.append({
             "title": title,
             "author": fields.get("author", ""),
@@ -147,6 +163,7 @@ def search_catalogue(query: str, limit: int = 8) -> dict:
             "year": fields.get("Publication Date", "").split()[0] if fields.get("Publication Date") else "",
             "isbn": fields.get("ISBN", ""),
             "digital": digital,
+            "electronic_access": ea_url,
             "detail_url": detail,
             "catalogue_id": cat_id,
         })
@@ -391,6 +408,9 @@ ELIGIBILITY = {
     "unlocked": "Full member, aged 15+, after a short one-off staff induction.",
     "events": "Most events are free — just turn up; a few need booking.",
     "visit": "Nothing at all — anyone can walk in for Wi-Fi, toilets and study space.",
+    "hive_visit": "Nothing — The Hive is open to everyone, 8:30am–10pm every day.",
+    "archives": "Free to visit Explore the Past (Level 2, The Hive); opening "
+                f"times and document-ordering rules are on [Explore the Past]({EXPLORE_PAST}).",
 }
 
 DAY_NAMES = ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday",
@@ -672,6 +692,313 @@ def membership_help(service: str | None = None) -> dict:
     return out
 
 
+# --------------------------------------------------------------------------- #
+# 6. Copy-level availability + the "where do I actually GET it" journey
+# --------------------------------------------------------------------------- #
+
+_STATUS_AVAILABLE = re.compile(r"\b(available|on shelf|in library)\b", re.I)
+_STATUS_WORDS = re.compile(
+    r"\b(available|on shelf|in library|checked out|on loan|due back|due \d|"
+    r"in transit|on order|on hold(shelf)?|reserved|missing|lost|reference only|"
+    r"not for loan|being catalogued)\b", re.I)
+_CALL_NO = re.compile(r"\b([A-Z]{0,3}\s?\d{3}(?:\.\d+)?\s?[A-Z]{0,4}|[A-Z]{1,3}\s?FIC[A-Z ]*)\b")
+
+
+def _branch_names() -> list[str]:
+    names = [b["name"] for b in kb().get("branches", [])]
+    extra = ["The Hive", "Mobile Library"]
+    out = names + [n for n in extra if n not in names]
+    # also match without the trailing " Library"
+    return sorted(out, key=len, reverse=True)
+
+
+def _item_availability(detail_url: str) -> dict:
+    """
+    Copy-level holdings for one catalogue item: which branch, what call number,
+    what status — parsed from the SirsiDynix detail page.
+
+    The page is JS-heavy, so we parse defensively (tables first, then a text
+    scan anchored on known branch names) and FAIL SOFT: if we can't parse,
+    we say so rather than guess. Returns
+    {"copies":[{branch, call_number, status, available}], "parsed": bool}.
+    """
+    out = {"copies": [], "parsed": False, "detail_url": detail_url}
+    if not detail_url:
+        return out
+    try:
+        soup = BeautifulSoup(_get(detail_url).text, "html.parser")
+    except Exception as e:
+        out["error"] = str(e)
+        return out
+
+    branches = _branch_names()
+
+    def add_copy(branch, call_no, status):
+        status = re.sub(r"\s+", " ", status).strip()
+        out["copies"].append({
+            "branch": branch.strip(),
+            "call_number": (call_no or "").strip(),
+            "status": status,
+            "available": bool(_STATUS_AVAILABLE.search(status)),
+        })
+
+    # Strategy 1 — a holdings table (header mentions library/branch + status)
+    for table in soup.find_all("table"):
+        head = " ".join(th.get_text(" ", strip=True).lower()
+                        for th in table.find_all(["th"]))
+        if not (("librar" in head or "branch" in head or "location" in head)
+                and ("status" in head or "avail" in head or "call" in head)):
+            continue
+        headers = [th.get_text(" ", strip=True).lower()
+                   for th in table.find_all("th")]
+        def col(*words):
+            return next((i for i, h in enumerate(headers)
+                         if any(w in h for w in words)), None)
+        c_lib, c_call, c_stat = (col("librar", "branch", "location"),
+                                 col("call", "shelf"), col("status", "avail"))
+        for tr in table.find_all("tr")[1:]:
+            cells = [td.get_text(" ", strip=True) for td in tr.find_all("td")]
+            if not cells:
+                continue
+            lib = cells[c_lib] if c_lib is not None and c_lib < len(cells) else ""
+            stat = cells[c_stat] if c_stat is not None and c_stat < len(cells) else ""
+            call = cells[c_call] if c_call is not None and c_call < len(cells) else ""
+            if lib and (stat or call):
+                add_copy(lib, call, stat or "see catalogue")
+        if out["copies"]:
+            out["parsed"] = True
+            return out
+
+    # Strategy 2 — text scan anchored on known branch names
+    text = re.sub(r"\s+", " ", soup.get_text(" ", strip=True))
+    for b in branches:
+        for m in re.finditer(re.escape(b), text, re.I):
+            window = text[m.end():m.end() + 140]
+            sm = _STATUS_WORDS.search(window)
+            if sm:
+                cm = _CALL_NO.search(window[:sm.start()])
+                add_copy(b, cm.group(0) if cm else "", sm.group(0))
+    # dedupe
+    seen, copies = set(), []
+    for c in out["copies"]:
+        key = (c["branch"].lower(), c["status"].lower(), c["call_number"])
+        if key not in seen:
+            seen.add(key); copies.append(c)
+    out["copies"] = copies
+    out["parsed"] = bool(copies)
+    return out
+
+
+def _title_sim(a: str, b: str) -> float:
+    return difflib.SequenceMatcher(None, a.lower(), b.lower()).ratio()
+
+
+def where_to_get(query: str) -> dict:
+    """
+    The full get-it journey for one title: every format the service holds and,
+    for each, exactly where/how to get it TODAY —
+        on the shelf at a named branch (copy-level, live)  →
+        reserve it (sign in + Place Hold)                  →
+        borrow tonight on BorrowBox (eBook / eAudiobook)   →
+        not held: ask staff / check the catalogue yourself.
+    """
+    query = (query or "").strip()
+    try:
+        res = search_catalogue(query, limit=12)
+    except Exception as e:  # catalogue unreachable — fail soft, keep the journey
+        res = {"items": [], "error": f"catalogue unreachable: {e}"}
+    base = {"query": query, "search_url": res.get("search_url",
+            CATALOGUE_SEARCH + quote_plus(query)), "checked": _now()}
+    if res.get("error") or not res.get("items"):
+        base.update({"found": False, "routes": [{
+            "route": "not_held",
+            "advice": "Nothing matched in the catalogue. Staff can often get "
+                      "titles from other library services — ask in any branch, "
+                      "or try different search words.",
+            "url": base["search_url"],
+        }]})
+        return base
+
+    items = sorted(res["items"], key=lambda i: _title_sim(query, i["title"]),
+                   reverse=True)
+    best = items[0]
+    cluster = [i for i in items if _title_sim(best["title"], i["title"]) > 0.6]
+    routes = []
+
+    # 1) digital first — instant, tonight, no waiting
+    for fmt in ("eBook", "eAudiobook"):
+        d = next((i for i in cluster if i["format"] == fmt), None)
+        if d:
+            routes.append({
+                "route": "digital", "format": fmt, "title": d["title"],
+                "author": d["author"],
+                "url": d.get("electronic_access") or BORROWBOX,
+                "direct_link": bool(d.get("electronic_access")),
+                "need": ELIGIBILITY["borrow_digital"],
+                "steps": ["Open the link (or the BorrowBox app, service "
+                          "'Worcestershire').",
+                          "Sign in with your library card number + PIN — or get "
+                          "instant digital membership with just a postcode.",
+                          "Borrow it free; it auto-returns, so no fines."],
+            })
+
+    # 2) physical — copy-level: which branch has it on the shelf right now
+    phys = next((i for i in cluster if not i["digital"]), None)
+    if phys:
+        avail = _item_availability(phys["detail_url"])
+        on_shelf = [c for c in avail["copies"] if c["available"]]
+        if on_shelf:
+            routes.append({
+                "route": "shelf", "format": phys["format"],
+                "title": phys["title"], "author": phys["author"],
+                "copies": on_shelf[:8], "all_copies": avail["copies"][:12],
+                "need": ELIGIBILITY["borrow_physical"],
+                "url": phys["detail_url"],
+            })
+        else:
+            routes.append({
+                "route": "reserve", "format": phys["format"],
+                "title": phys["title"], "author": phys["author"],
+                "copies": avail["copies"][:8],
+                "availability_parsed": avail["parsed"],
+                "need": ELIGIBILITY["borrow_physical"],
+                "url": phys["detail_url"],
+                "steps": ["Open the item page and sign in (card number + PIN).",
+                          "Choose 'Place Hold' and pick the branch you want to "
+                          "collect from — any Worcestershire library or the van.",
+                          "You'll be emailed when it's ready to collect. "
+                          "Reservations are free."],
+            })
+
+    if not routes:
+        routes.append({"route": "not_held",
+                       "advice": "I found similar titles but not that exact one — "
+                                 "check the matches below or ask staff in any branch.",
+                       "url": base["search_url"]})
+
+    other = [f'{i["icon"]} {i["title"]} ({i["format"]})'
+             for i in items if i not in cluster][:4]
+    base.update({
+        "found": True, "best_title": best["title"], "author": best["author"],
+        "formats_held": sorted({i["format"] for i in cluster}),
+        "routes": routes, "other_matches": other,
+    })
+    return base
+
+
+# --------------------------------------------------------------------------- #
+# 7. The Hive — page-level KB of thehiveworcester.org (built by build_hive_kb.py)
+# --------------------------------------------------------------------------- #
+
+_HIVE_KB = None
+
+
+def hive_kb() -> dict:
+    global _HIVE_KB
+    if _HIVE_KB is None:
+        path = os.path.join(os.path.dirname(os.path.abspath(__file__)),
+                            "hive_kb.json")
+        try:
+            with open(path, encoding="utf-8") as f:
+                _HIVE_KB = json.load(f)
+        except FileNotFoundError:
+            _HIVE_KB = {"pages": [], "hive_profile": {}, "generated": ""}
+    return _HIVE_KB
+
+
+# question word -> hive page slug fragments that answer it
+_HIVE_INTENTS = {
+    "hour": ["opening-hours"], "open": ["opening-hours"],
+    "parking": ["getting-here"], "park": ["getting-here"],
+    "get there": ["getting-here"], "directions": ["getting-here"],
+    "bus": ["getting-here"], "train": ["getting-here"],
+    "contact": ["contact-us"], "phone": ["contact-us"], "email": ["contact-us"],
+    "archive": ["explore-the-past"], "archaeolog": ["explore-the-past"],
+    "family history": ["explore-the-past"], "history": ["explore-the-past"],
+    "study": ["book-a-space"], "room": ["space-for-hire", "book-a-space"],
+    "hire": ["space-for-hire"], "meeting": ["space-for-hire"],
+    "card": ["how-to-get-a-library-card"], "join": ["how-to-get-a-library-card"],
+    "fine": ["fines-renewals"], "renew": ["fines-renewals"],
+    "borrow": ["borrowing-reservations"], "reserve": ["borrowing-reservations"],
+    "café": ["cafe"], "cafe": ["cafe"], "coffee": ["cafe"], "food": ["cafe"],
+    "children": ["children"], "kids": ["children"],
+    "business": ["business"], "student": ["student"], "young": ["youthhub"],
+    "career": ["youthhub"], "collection": ["collections"],
+}
+
+
+def hive_info(topic: str | None = None) -> dict:
+    """
+    The Hive (Worcester's library) at PAGE granularity: the exact offering of
+    each page of thehiveworcester.org, plus the profile of what makes it more
+    than a branch (joint university+public library, Explore the Past archives
+    & archaeology, 800+ study spaces, room hire, BIPC, Youth Hub...).
+    """
+    hk = hive_kb()
+    prof = hk.get("hive_profile", {})
+    pages = [p for p in hk.get("pages", []) if not p.get("error")]
+    caps = prof.get("extended_capabilities", [])
+    out = {
+        "name": prof.get("name", "The Hive, Worcester"),
+        "partnership": prof.get("partnership", ""),
+        "address": prof.get("address", ""),
+        "opening_hours": (prof.get("opening_hours") or {}).get("building", ""),
+        "as_of": hk.get("generated", ""), "source_note": hk.get("note", ""),
+        "page_url": HIVE, "checked": _now(),
+    }
+
+    if not (topic or "").strip():
+        out.update({
+            "kind": "overview",
+            "capabilities": caps[:12],
+            "page_count": len(pages),
+            "sections": sorted({p.get("section", "") for p in pages}),
+        })
+        return out
+
+    t = topic.lower()
+    slugs: list[str] = []
+    for word, frags in _HIVE_INTENTS.items():
+        if word in t:
+            slugs += frags
+    scored = []
+    for p in pages:
+        score = 0.0
+        if any(s in p["url"] for s in slugs):
+            score += 6
+        title = p.get("title", "").lower()
+        terms = [w for w in re.findall(r"[a-z]{3,}", t)
+                 if w not in ("the", "hive", "library", "what", "can", "you",
+                              "about", "tell", "does", "have", "there")]
+        for w in terms:
+            if w in title:
+                score += 3
+            score += sum(0.5 for o in p.get("offerings", []) if w in o.lower())
+            if w in p.get("summary", "").lower():
+                score += 1
+        if score:
+            scored.append((score, p))
+    scored.sort(key=lambda x: -x[0])
+
+    cap_hits = [c for c in caps
+                if isinstance(c, dict) and any(
+                    w in (c.get("capability", "") + c.get("detail", "")).lower()
+                    for w in re.findall(r"[a-z]{4,}", t))][:4]
+
+    out.update({
+        "kind": "topic", "topic": topic,
+        "pages": [{
+            "title": p["title"], "url": p["url"], "summary": p.get("summary", ""),
+            "offerings": p.get("offerings", [])[:10],
+            "what_you_need": p.get("what_you_need", [])[:3],
+            "details": p.get("details", {}),
+            "notes": p.get("notes", ""),
+        } for _, p in scored[:3]],
+        "capabilities": cap_hits,
+    })
+    return out
+
+
 def whats_new(genre: str | None = None, limit: int = 6) -> dict:
     """Newest catalogue titles for a genre/topic — fuel for a fun 'hot take'."""
     term = (genre or "fiction").strip()
@@ -722,3 +1049,30 @@ if __name__ == "__main__":
     res = printing_help()
     print("  ", res["summary"][:80], "...")
     print("  pricing:", res["pricing"])
+
+    print("\n### 5. WHERE TO GET: 'wolf hall' (copy-level availability — LIVE) ###")
+    res = where_to_get("wolf hall")
+    print(f"  found={res['found']} best='{res.get('best_title')}' "
+          f"formats={res.get('formats_held')}")
+    for r in res.get("routes", []):
+        if r["route"] == "shelf":
+            spots = ", ".join(f"{c['branch']} ({c['call_number'] or 'ask staff'})"
+                              for c in r["copies"][:4])
+            print(f"  📚 ON SHELF now: {spots}")
+        elif r["route"] == "reserve":
+            print(f"  🔖 reserve ({len(r.get('copies', []))} copies tracked, "
+                  f"parsed={r.get('availability_parsed')})")
+        elif r["route"] == "digital":
+            print(f"  💻 {r['format']} — direct link: {r['direct_link']}")
+        else:
+            print(f"  ✋ {r['route']}: {r.get('advice', '')[:70]}")
+
+    print("\n### 6. HIVE INFO (page-level KB — offline) ###")
+    res = hive_info()
+    print(f"  {res['name']} — {res['opening_hours'][:60]}")
+    print(f"  pages={res.get('page_count')} capabilities={len(res.get('capabilities', []))} "
+          f"as_of={res.get('as_of', '')[:10]}")
+    for q in ("archives and old documents", "hire a meeting room", "parking"):
+        r = hive_info(q)
+        tops = [p["title"] for p in r.get("pages", [])]
+        print(f"  '{q}' -> pages {tops} + {len(r.get('capabilities', []))} capabilities")