diff --git a/examples/cli/README.md b/examples/cli/README.md
index 6be5a1b..44b8857 100644
--- a/examples/cli/README.md
+++ b/examples/cli/README.md
@@ -297,7 +297,7 @@ Expand from one or more seed entries:
.venv/bin/python -m citegeist --db library.sqlite3 expand langton1989artificial1
```
-Choose the source:
+Choose the graph expansion source:
```bash
.venv/bin/python -m citegeist --db library.sqlite3 expand langton1989artificial1 --source openalex
@@ -333,12 +333,14 @@ Override the topic phrase:
.venv/bin/python -m citegeist --db library.sqlite3 expand-topic artificial-life --topic-phrase "artificial life alife artificial organisms"
```
-Choose source and relation:
+Choose graph expansion source and relation:
```bash
.venv/bin/python -m citegeist --db library.sqlite3 expand-topic artificial-life --source openalex --relation cited_by
```
+Note: graph expansion currently supports `openalex` and `crossref`. Metadata resolution, verification, and bootstrap topic seeding also use `datacite` and `pubmed`.
+
Control seed and discovery limits:
```bash
diff --git a/examples/literature-explorer/README.md b/examples/literature-explorer/README.md
index 039d7de..7ecb44a 100644
--- a/examples/literature-explorer/README.md
+++ b/examples/literature-explorer/README.md
@@ -45,6 +45,11 @@ The adapter exposes JSON-serializable methods suitable for a local web bridge:
- `verify_bibtex(bibtex_text, context="", limit=5)`
- `graph(seed_keys, relation_types=None, depth=1, review_status=None, missing_only=False)`
+The `capabilities()` payload also distinguishes between broader metadata/search sources and narrower graph-expansion sources:
+
+- metadata and topic seeding currently use `crossref`, `datacite`, `openalex`, and `pubmed`
+- topic graph expansion currently uses `crossref` and `openalex`
+
## Browser Contract
A demo app can expose a browser object like:
diff --git a/examples/literature-explorer/index.html b/examples/literature-explorer/index.html
index d555117..0f60b0a 100644
--- a/examples/literature-explorer/index.html
+++ b/examples/literature-explorer/index.html
@@ -561,7 +561,7 @@