feat: include source page link in chat responses

[HardeepAsrani]

The Pro companion is Codeinwp/hyve#236.

What this adds

When Hyve answers a question, it can now show where the answer came from — the knowledge base content it drew on — as small numbered citations under the reply.

Highlights:

• Off by default. Turn it on under Settings → General → “Show Source Link in Chat Responses.”
• Numbered citations. Sources appear as a compact Sources 1 2 3 row beneath the answer; hovering (or focusing) a number reveals the page title, and clicking opens it in a new tab.
• Only what’s relevant. Sources are ranked by how well they match the question, and weak stragglers are dropped — so a question that’s really about one page shows one source, not three padded ones. At most three are shown.
• Only what’s public. A link is added only for publicly accessible content. Private posts, password-protected posts, and content with no public URL (e.g. custom data) are never linked.
• Theme-aware. The label and numbers follow the chat’s text color, so they stay legible on both light and custom/dark chat backgrounds.
• Works with both the streaming and non-streaming reply flows.

For developers

Three filters are available for fine-tuning:

• hyve_source_link_limit — max number of sources shown (default 3).
• hyve_source_link_score_ratio — how close to the best match a source must score to be shown, as a ratio of the top score (default 0.8; 0 shows everything above the relevance threshold).
• hyve_chat_source_link — resolve/override the URL for a given source (used by the Pro plugin for website-link and sitemap sources, and to suppress links for custom data).

Base branch is feat/streaming-responses and this builds on #179 (it reuses the post-visibility helper for the public-accessibility check).

Manual QA

Prerequisite: add a few public Posts/Pages to the Knowledge Base and make sure the chat answers from them.

1. Enable the setting. Go to Settings → General, set “Show Source Link in Chat Responses” to Enable, and save.
2. Ask a grounded question. Ask something clearly covered by one of your KB pages. Under the answer you should see a “Sources” label followed by numbered chips.
   • Hover/focus a number → the page title appears as a tooltip.
   • Click a number → the source page opens in a new tab.
3. Relevance. Ask a question that only one page really covers → you should see just that one source, not three. Ask a broad question covered by several pages → you should see up to three.
4. Public-only.
   • Set a KB source Post to Private (or add a password), ask a question it would answer → that page must not be linked.
   • Confirm no link is shown for sources that have no public URL.
5. Both reply modes. Repeat step 2 with streaming responses on and off — citations should appear in both.
6. Theming. Under Settings → Appearance, set a dark chat/assistant background → the “Sources” label and numbers should remain readable (they switch to a light color); hover fill uses the accent color.
7. Off state. Set the setting back to Disable and save → answers should no longer show any source citations.
8. No sources case. Ask an off-topic question the KB can’t answer → no “Sources” row should appear.

With the Pro plugin (Codeinwp/hyve#236) active, also confirm: website-link and sitemap sources link to their original public URL, and custom-data sources show no link.

[github-actions]

Plugin build for 8a3118e is ready 🛎️!

• Download Plugin - Download

[HardeepAsrani]

@copilot resolve the merge conflicts in this pull request

[Copilot]

@copilot resolve the merge conflicts in this pull request

Fixed in 7cf3c51.

[HardeepAsrani]

@copilot resolve the merge conflicts in this pull request

[Copilot]

@copilot resolve the merge conflicts in this pull request

Fixed in d6ea24c.