feat(doc-symbols): doc_symbols table + resolve_doc_symbol RPC #65

Merged

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

2026-06-25 20:39:51 +02:00

raisondetredev commented

2026-06-25 20:37:28 +02:00

(Migrated from codeberg.org)

Part of the multi-repo doc-symbol feature — app project-halkyon/halkyon-learn#685, backend project-halkyon/halkyon-infra#65, curator project-halkyon/halkyon-curator#17.

Backend for the multi-language "Link to docs" feature: resolving a selected code symbol to its official documentation URL.

doc_symbols table — read-only reference data (RLS SELECT-only, trigram GIN), (ecosystem, fqn) PK, columns display / official_url / package / kind / search_blob. Mirrors dictionary_entries.
resolve_doc_symbol(p_symbol, p_ecosystem?, p_limit) RPC — ranked tiers: exact FQN → .suffix → fuzzy substring (LIKE wildcards escaped for _-heavy symbols). SECURITY INVOKER, search_path pinned.

Seeded by halkyon-curator's seed_doc_symbols; queried by halkyon-learn. Apply before the app build that calls the RPC ships.

> Part of the multi-repo **doc-symbol** feature — app project-halkyon/halkyon-learn#685, backend project-halkyon/halkyon-infra#65, curator project-halkyon/halkyon-curator#17. Backend for the multi-language **"Link to docs"** feature: resolving a selected code symbol to its **official** documentation URL. - `doc_symbols` table — read-only reference data (RLS SELECT-only, trigram GIN), `(ecosystem, fqn)` PK, columns `display / official_url / package / kind / search_blob`. Mirrors `dictionary_entries`. - `resolve_doc_symbol(p_symbol, p_ecosystem?, p_limit)` RPC — ranked tiers: exact FQN → `.suffix` → fuzzy substring (LIKE wildcards escaped for `_`-heavy symbols). SECURITY INVOKER, search_path pinned. Seeded by halkyon-curator's `seed_doc_symbols`; queried by halkyon-learn. **Apply before the app build that calls the RPC ships.**