diff --git a/changelog.d/fixed-552-integrations-link-stays-on-site.md b/changelog.d/fixed-552-integrations-link-stays-on-site.md new file mode 100644 index 0000000..dc02103 --- /dev/null +++ b/changelog.d/fixed-552-integrations-link-stays-on-site.md @@ -0,0 +1 @@ +- The Hive introduction, documentation map and landscape pages now link to the on-site Supported agents & inference engines page (/docs/hive/integrations) instead of the GitHub copy of integrations.md (#552). diff --git a/docs/content/hive/documentation-map.md b/docs/content/hive/documentation-map.md index 53a0af3..c11c8cc 100644 --- a/docs/content/hive/documentation-map.md +++ b/docs/content/hive/documentation-map.md @@ -224,7 +224,7 @@ Documentation for the current Hive line (branch `v5`; the code and docs live und - [Automatic repo ACMM onboarding reconciler](https://github.com/hivecommons/hive/blob/v5/src/docs/design/repo-acmm-onboarding.md) — proposed design for per-repo ACMM targets, gap-to-work reconciliation, human hand-off, waivers, and anti-gaming controls (RFC #6235). - [Hive federation design](https://github.com/hivecommons/hive/blob/v5/docs/federation-design.md) — the multi-hive registry: live `/api/hives` endpoints, project onboarding, contributor flow across hubs, and what remains future design work. - [Public roadmap](/docs/hive/roadmap) — available foundations, current/future direction, release-line status, completed work, and dated decision evidence. Not a delivery promise. -- [Integrations](https://github.com/hivecommons/hive/blob/v5/src/docs/integrations.md) — one page of logos and status (Supported / Opt-in / Planned) for agent backends, work sources, forges, sandboxes and upstream projects. +- [Integrations](/docs/hive/integrations) — one page of logos and status (Supported / Opt-in / Planned) for agent backends, work sources, forges, sandboxes and upstream projects. - [Landscape and positioning](/docs/hive/landscape) — how Hive's operations-plane design compares to nearby agentic orchestration tools, with public references per project. Explicitly time-sensitive; check the conducted date in its header before quoting product details. - [CNCF sandbox onboarding status](https://github.com/hivecommons/hive/blob/v5/src/docs/cncf-sandbox-onboarding.md) — repo-local map of the onboarding tracker and repository evidence (LICENSE, governance, security, OWNERS, DCO). - [CNCF reference architecture](https://github.com/hivecommons/hive/blob/v5/src/docs/cncf-reference-architecture.md) — CNCF submission/reference template. diff --git a/docs/content/hive/landscape.md b/docs/content/hive/landscape.md index 1e3ffca..cc76085 100644 --- a/docs/content/hive/landscape.md +++ b/docs/content/hive/landscape.md @@ -230,7 +230,7 @@ GitHub.com or GitHub Enterprise. Hive has GitLab and Gitea/Forgejo adapters but the governor, merge gate and agent `gh` path are not yet forge-neutral ([#14096](https://github.com/hivecommons/hive/issues/14096)). Fullsend already ships GitHub, GitLab and Forgejo. See [Forges](https://github.com/hivecommons/hive/blob/v5/src/docs/integrations/forges.md). -The [integrations page](https://github.com/hivecommons/hive/blob/v5/src/docs/integrations.md) lists every tracker, forge and backend +The [integrations page](/docs/hive/integrations) lists every tracker, forge and backend with its status. ## Related projects and vendors @@ -258,7 +258,7 @@ three: open-source, self-hosted, fleet-scale, with explicit policy. - **Hive**: operating a live agent fleet across any work source, with many runtimes, ACMM gates, fixed merge policy, hub/spoke provisioning, contributor compute, cost visibility and proxy-level write checks. See - [integrations.md](https://github.com/hivecommons/hive/blob/v5/src/docs/integrations.md) for what Hive works with today. + [integrations.md](/docs/hive/integrations) for what Hive works with today. ## Hive claims checked against this repo diff --git a/docs/content/hive/readme.md b/docs/content/hive/readme.md index ccbdad9..e0c6c3b 100644 --- a/docs/content/hive/readme.md +++ b/docs/content/hive/readme.md @@ -2,7 +2,7 @@ # Hive introduction -Hive helps maintain a GitHub project. It watches reports and tasks (issues), proposed code changes (pull requests, or PRs), failed automated build and test checks (CI), known security vulnerabilities (CVEs), and Dependabot alerts. It sends AI coding agents to sort reports, make fixes, review changes, and prepare releases. See [Integrations](https://github.com/hivecommons/hive/blob/v5/src/docs/integrations.md) for supported agent backends. +Hive helps maintain a GitHub project. It watches reports and tasks (issues), proposed code changes (pull requests, or PRs), failed automated build and test checks (CI), known security vulnerabilities (CVEs), and Dependabot alerts. It sends AI coding agents to sort reports, make fixes, review changes, and prepare releases. See [Integrations](/docs/hive/integrations) for supported agent backends. For example, Hive can spot a missing test, record the finding on its dashboard, and — if the configured permissions allow it — ask the quality agent to propose a test in a pull request. At lower levels, a person reviews and merges that change. Autonomous merging is optional, not the starting goal. @@ -55,7 +55,7 @@ A terminal agent is a power tool: you hold it, aim it, and it stops when you sto ## Where to go next - [Architecture](/docs/hive/architecture) -- [Integrations](https://github.com/hivecommons/hive/blob/v5/src/docs/integrations.md) — backends, trackers, forges and sandboxes Hive works with, at a glance. +- [Integrations](/docs/hive/integrations) — backends, trackers, forges and sandboxes Hive works with, at a glance. - [Getting started](/docs/hive/getting-started) - [Operator reference](https://github.com/hivecommons/hive/blob/v5/src/docs/operator-reference.md) - [GitHub webhooks: cadence, patch and reconcile](https://github.com/hivecommons/hive/blob/v5/src/docs/webhooks.md) — polling fallback, webhook patch and reconcile, and the state-accuracy guarantees. diff --git a/scripts/sync-hive-docs.test.ts b/scripts/sync-hive-docs.test.ts index 59104f4..d97a238 100644 --- a/scripts/sync-hive-docs.test.ts +++ b/scripts/sync-hive-docs.test.ts @@ -46,6 +46,18 @@ describe("rewriteLinkTarget — Case 1: in-tree synced docs -> site route", () = ).toBe("/docs/hive/adr/0026-sandbox-runtime-selection"); }); + it("rewrites the local integrations page link from src/docs/README.md to its site route (#552)", () => { + expect(rewriteLinkTarget("integrations.md", README)).toBe( + "/docs/hive/integrations" + ); + }); + + it("rewrites the local integrations page link from src/docs/landscape.md to its site route (#552)", () => { + expect(rewriteLinkTarget("integrations.md", "src/docs/landscape.md")).toBe( + "/docs/hive/integrations" + ); + }); + it("preserves an #anchor on an in-tree link", () => { expect(rewriteLinkTarget("architecture.md#the-governor-loop", README)).toBe( "/docs/hive/architecture#the-governor-loop" diff --git a/scripts/sync-hive-docs.ts b/scripts/sync-hive-docs.ts index 2f22515..d0270be 100644 --- a/scripts/sync-hive-docs.ts +++ b/scripts/sync-hive-docs.ts @@ -96,7 +96,10 @@ const files: Array<{ source: string; target?: string; route?: string }> = [ // Hive pages authored in this repo (docs/content/hive/) rather than synced, // listed so links from synced pages resolve to their site routes. -const localHiveDocs: Array<{ source: string; target?: string }> = []; +const localHiveDocs: Array<{ source: string; target?: string }> = [ + // Supported agents & inference engines page authored here, published at /docs/hive/integrations (#552). + { source: "integrations.md" }, +]; // --------------------------------------------------------------------------- // Brand scrub