From 1f677211f7930de1d5ac64b8669fac94ef4da5e3 Mon Sep 17 00:00:00 2001 From: Tarik Moussa Date: Mon, 15 Jun 2026 22:13:56 +0200 Subject: [PATCH] =?UTF-8?q?docs(adr):=20finalise=20D-1=20=E2=80=94=20re-me?= =?UTF-8?q?asure=20F-15=20spike=20on=20canonical=20corpus?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Re-ran the citation graph after the C-7 re-ingest (29/29 papers canonical/bare): 489 nodes, 590 edges, 472 dangling, 5.4% spread. The resolution fix's signature: Pinkall/Polthier 1993 resolves to its DOI and is now the rank-1 *in-KB* hub (was a dangling OpenAlex node); Bobenko/Springborn 2007 holds rank 7. Foundational hubs still surface — GO re-affirmed on the shipping topology. Updates the ADR spike table with before/after numbers. Co-Authored-By: Claude Fable 5 --- docs/adr/ADR-F15-literature-graph.md | 33 ++++++++++++++++++++-------- 1 file changed, 24 insertions(+), 9 deletions(-) diff --git a/docs/adr/ADR-F15-literature-graph.md b/docs/adr/ADR-F15-literature-graph.md index 4733885..66e1b2e 100644 --- a/docs/adr/ADR-F15-literature-graph.md +++ b/docs/adr/ADR-F15-literature-graph.md @@ -177,13 +177,28 @@ was measured on a graph the current code no longer produces: diverge (audit C-1). Ingest stores the caller's canonical id as `papers.id` instead of OpenAlex's URL-form doi (audit C-7). Inter-KB citations are therefore represented as edges — the "Known Limitation" above is obsolete. -- **Spike numbers are stale.** The 478 dangling nodes, the rank-7 - Bobenko/Springborn result, and the 5.7 % score spread were measured *before* - the resolution + canonicalisation. They must be **re-measured after the corpus - is re-ingested** onto canonical ids (the chosen C-7 migration); until then the - GO rests on a superseded topology. +- **Spike re-measured after migration (2026-06-15).** The corpus was re-ingested + onto canonical bare ids (29 papers, all bare — verified `url_form_ids = 0`), and + the graph re-run on the post-migration corpus: -**Action (pending):** after re-ingesting via `ingest_all.sh`, re-run -`codex graph report`, refresh the Spike Result table, and confirm the -foundational hubs (Pinkall/Polthier, Yamabe, Schoen, Bobenko/Springborn) still -surface. + | Metric | Original spike (pre-fix) | Post-migration (re-measured) | + |--------|--------------------------|------------------------------| + | Ingested papers | 29 | 29 | + | Graph nodes | 495 | 489 | + | Graph edges | 590 | 590 | + | Dangling nodes | 478 | 472 | + | Top-10 PR spread | 5.7 % | 5.4 % | + | Rank-1 hub | W1974956622 (dangling) | **Pinkall/Polthier 1993 — in-KB (resolved)** | + | Bobenko/Springborn 2007 | rank 7 | rank 7 | + + The resolution fix's signature is visible: Pinkall/Polthier 1993 now resolves to + its canonical DOI and rises to **rank 1 as an in-KB hub** (previously a dangling + OpenAlex node). Bobenko/Springborn 2007 holds rank 7, and the foundational works + (Pinkall/Polthier, Yamabe, Schoen, Bobenko/Springborn) still surface. **GO + re-affirmed** on the shipping topology. + + Migration footnotes: two papers initially survived in URL form because the + id-keyed upsert did not catch a `papers.openalex_id` collision, and `2305.10988` + failed on a `papers.bibkey` collision with `2310.17529` (both → + `BobenkoLutz2023`). Same upsert gap — resolved by the bibkey-retry (audit C-15) + plus a delete + re-ingest of the two stragglers; corpus is now 29/29 canonical.