Skip to content

✨ Add Hive integrations docs - #40

Merged
kubestellar-prow[bot] merged 1 commit into
mainfrom
docs-integrations-page
Sep 24, 2026
Merged

kubestellar-prow[bot] merged 1 commit into
mainfrom
docs-integrations-page

Conversation

@clubanderson

Copy link
Copy Markdown
Member

Summary

  • add /docs/hive/integrations with supported agent CLIs, inference engines, gateways, and infrastructure thanks
  • add the page to Hive Overview navigation and generated sitemap inputs
  • add metadata/JSON-LD and llms.txt crawler context

Validation

  • npm ci
  • npm run lint
  • npm run test
  • npm run check-links
  • npm run build
  • reverted prebuild rewrites with git checkout -- docs/content public/config/shared.json
  • Playwright screenshots saved under ~/hive-work/docs-shots/site-int-docs-{dark,light}.png

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: Andrew Anderson <andy@clubanderson.com>
@netlify

netlify Bot commented Sep 24, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for hivecommons-docs ready!

Name Link
🔨 Latest commit c9fe978
🔍 Latest deploy log https://app.netlify.com/projects/hivecommons-docs/deploys/6ab56069dcb6f5000768ab0b
😎 Deploy Preview https://deploy-preview-40--hivecommons-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@clubanderson

Copy link
Copy Markdown
Member Author

/lgtm
/approve

@kubestellar-prow

Copy link
Copy Markdown

@clubanderson: you cannot LGTM your own PR.

Details

In response to this:

/lgtm
/approve

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.

@kubestellar-prow

Copy link
Copy Markdown

[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

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@kubestellar-prow
kubestellar-prow Bot merged commit 55660dc into main Sep 24, 2026
11 checks passed
@kubestellar-prow
kubestellar-prow Bot deleted the docs-integrations-page branch September 24, 2026 17:47

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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) and config.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 with unsupported backend "anthropic" (supported: …). There is also no built-in gateway kind anthropic/openai/deepseek — kinds are openrouter | litellm | vllm | llm-d | watsonx | custom (config.go:2539).
  • Suggested fix: for OpenRouter, present it as a gateway (gateways: [{name: openrouter, kind: openrouter, …}] then backend: openrouter), and for Anthropic/OpenAI/DeepSeek drop the Hive 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 how getProjectFromSlug + getPageContent resolve the page (projectId === 'hive' && filePath === 'integrations.md'), and returning {} for all other slugs inherits parent metadata rather than clobbering it. JSON-LD is JSON.stringify of static constants — no injection surface.
  • Nav entry in page-map.ts gives 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.txt matches the page's integration list.

— hive: agent=reviewer backend=copilot model=claude-fable-5 copilot=1.0.88

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant