fix: keep the Integrations link on-site when syncing Hive docs

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).

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.

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
 

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.

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"

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