✨ Add Hive integrations docs - #40
Conversation
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Signed-off-by: Andrew Anderson <andy@clubanderson.com>
✅ Deploy Preview for hivecommons-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
|
/lgtm |
|
@clubanderson: you cannot LGTM your own PR. DetailsIn response to this:
Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. |
|
[APPROVALNOTIFIER] This PR is APPROVED This pull-request has been approved by: clubanderson The full list of commands accepted by this bot can be found here. The pull request process is described here DetailsNeeds approval from an approver in each of these files:
Approvers can indicate their approval by writing |
There was a problem hiding this comment.
Read the diff against main and cross-checked the documented backend IDs against the hive codebase (v5 head). The Next.js changes are sound; one accuracy problem in the content should be fixed before this lands, because it is exactly the kind of thing operators will copy-paste.
Finding (medium): four backend: values in docs/content/hive/integrations.md are not valid hive backend IDs as written.
- Lines 128/135/142/149 document
backend: openrouter,backend: anthropic,backend: openai,backend: deepseek. - Hive's canonical lists are
config.CLIBackends(claude, copilot, goose, codex, pi, bob, aider, gemini, agy, opencode, kilo, muse, omp—src/pkg/config/config.go:6014) andconfig.InferenceBackends(vllm, llm-d, litellm, watsonx—config.go:5974). All 17 of those entries in this page check out. ✅ - The other four are accepted only if the operator has configured a model gateway with that exact name (
validateBackendName,src/pkg/agent/manager_routing.go:71→routableBackend); otherwise the agent is rejected withunsupported backend "anthropic" (supported: …). There is also no built-in gateway kindanthropic/openai/deepseek— kinds areopenrouter | litellm | vllm | llm-d | watsonx | custom(config.go:2539). - Suggested fix: for OpenRouter, present it as a gateway (
gateways: [{name: openrouter, kind: openrouter, …}]thenbackend: openrouter), and for Anthropic/OpenAI/DeepSeek drop theHive config: backend: …line in favor of "reached via a configured gateway or the corresponding CLI backend".
Verified as correct:
generateMetadata/JSON-LD wiring: the slug gate (hive/integrations) matches howgetProjectFromSlug+getPageContentresolve the page (projectId === 'hive' && filePath === 'integrations.md'), and returning{}for all other slugs inherits parent metadata rather than clobbering it. JSON-LD isJSON.stringifyof static constants — no injection surface.- Nav entry in
page-map.tsgives the page a static route; CI (TS/ESLint, unit tests, link check, Netlify preview) is green and the deploy preview renders the page. public/llms.txtmatches the page's integration list.
— hive: agent=reviewer backend=copilot model=claude-fable-5 copilot=1.0.88
Summary
Validation