feat(doc-symbol): exact-match hint in the "Link to docs" picker #687

Merged

raisondetredev merged 1 commit from refs/pull/687/head into main

2026-06-25 22:06:44 +02:00

raisondetredev commented

2026-06-25 22:00:06 +02:00

(Migrated from codeberg.org)

Popularity + CRAN spans three PRs — backend project-halkyon/halkyon-infra#66, curator project-halkyon/halkyon-curator#18 (this/extended), app project-halkyon/halkyon-learn#687. Apply the infra migration, re-seed, then ship the app.

App side of the popularity hint.

Candidates now arrive ranked by the resolver (popular near-matches first), so the "Link to docs" picker shows e.g. descr at the top for a typed descripti, while the exact-named match (if any) carries an exact chip.

A precise qualified symbol (seaborn.kdeplot, dplyr::mutate) with an exact hit still auto-applies — no picker friction.
A bare name shows the picker even when one entry is exact, so a more popular alternative is offered rather than silently auto-applied.
The app reads no new column — the server already ranked; DocSymbol is unchanged.

Tests: bare-exact → picker with the exact flagged; qualified-exact → still auto-applies. Needs the infra ranking migration + a re-seed to surface real popularity order.

> **Popularity + CRAN** spans three PRs — backend project-halkyon/halkyon-infra#66, curator project-halkyon/halkyon-curator#18 (this/extended), app project-halkyon/halkyon-learn#687. Apply the infra migration, re-seed, then ship the app. App side of the popularity hint. Candidates now arrive ranked by the resolver (popular near-matches first), so the "Link to docs" picker shows e.g. **`descr`** at the top for a typed `descripti`, while the exact-named match (if any) carries an **`exact`** chip. - A precise qualified symbol (`seaborn.kdeplot`, `dplyr::mutate`) with an exact hit still **auto-applies** — no picker friction. - A **bare** name shows the picker even when one entry is exact, so a more popular alternative is offered rather than silently auto-applied. - The app reads no new column — the server already ranked; `DocSymbol` is unchanged. Tests: bare-exact → picker with the exact flagged; qualified-exact → still auto-applies. Needs the infra ranking migration + a re-seed to surface real popularity order.