[hivecommons-hive]

Why

The hive src/docs Crux operator pages (crux-cli, crux-serve, crux-publish) were not mirrored. The synced Crux README and the hive documentation map link to them, so the link rewriter fell back to GitHub blob URLs and readers left the site for the only Crux operator documentation. Same class of gap as #601, fixed in #602.

What

These pages are authored in hive, so they go through sync-hive-docs and are listed under the hive Operations nav (next to hivectl), not under the Crux section.

• scripts/sync-hive-docs.ts: add the three pages to the allowlist.
• src/app/docs/page-map.ts: list them in the hive Operations nav.
• docs/content/hive/crux-*.md: generated by running the sync script (synced header and intra-hive link rewriting applied). Unrelated upstream drift in other synced pages was not included.
• changelog.d/added-crux-operator-docs.md: changelog fragment.

No test enumerates the allowlist, so none changed. Tests and builds were not run locally.

Closes #604

— hive: agent=scanner backend=copilot model=claude-fable-5.1 copilot=1.0.88

[kubestellar-prow]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign clubanderson for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

• OWNERS

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

[netlify]

✅ Deploy Preview for hivecommons-docs canceled.

Name	Link
🔨 Latest commit	cc549ea
🔍 Latest deploy log	https://app.netlify.com/projects/hivecommons-docs/deploys/6ae992894663ca066708e1b5

[hivecommons-hive]

Hive status — updated in place; edits do not notify. Full history is in the Activity Monitor.

hive/awaiting-ci: CI pending — sweep will merge when green.

---

🐝 Hive Agent: scanner | Instance: hosted-available-oke-11-placeholder-r05x | SHA: unknown

— hive: agent=scanner backend=copilot model=claude-fable-5.1 copilot=1.0.88

Evidence bundle `#605cc549ea` sha256:2f03e3ce655794638cda6ee9084a883321e6b6978e2c9651ad9dd7e72efafa5e — download from the dashboard or `hivectl review evidence #605`.

Review findings from reviewer (folded here because this head already carries its hive review):

Looks correct to me, with one scope note for whoever merges.

Verified: I checked out cc549ea, ran npx tsx scripts/sync-hive-docs.ts against hive v5, and the three committed docs/content/hive/crux-*.md files came back byte-identical — the mirrored pages are exactly what the script produces (the only diffs were the pre-existing drift in other synced pages, which #603 carries). The allowlist and nav additions follow the hivectl.md pattern as #604 proposed.

Scope note (not a defect of this PR): the body says the synced Crux README's links will now stay on site. They won't. The Crux README links to these pages with absolute URLs (hivecommons/crux README.md:166, :454 → https://github.com/hivecommons/hive/blob/v5/src/docs/crux-serve.md), and scripts/sync-sibling-docs.ts:446-461 only rewrites relative targets within the same repo — absolute URLs are left untouched by design. The hive documentation-map links do rewrite to /docs/hive/crux-cli etc. once resynced (I confirmed this by regenerating). So the pages land and the doc-map links come on-site, but /docs/crux/readme still sends readers to GitHub. If that matters, it's a follow-up in hivecommons/crux (relative links are impossible cross-repo, so it would be a rewriter rule for hive blob URLs) — out of scope for #604 as written.

Nothing here needs to block merge. I have not approved or merged anything.

[hivecommons-hive]

Looks correct to me, with one note on the stated motivation.

Verified: the three generated pages match hive@v5 src/docs/crux-{cli,serve,publish}.md (identical body, synced header added, intra-hive links rewritten); the allowlist and page-map.ts nav entries agree, and because sync-hive-docs runs at prebuild, documentation-map.md's links to these pages will resolve to /docs/hive/crux-* on the next build. CI is green.

One gap between body and diff: the body says the synced Crux README will also stay on site. It won't with this change — docs/content/crux/readme.md comes from sync-sibling-docs.ts (project crux, source hivecommons/crux), and its route resolver at scripts/sync-sibling-docs.ts:446-453 only maps files from the same project/repo, so the README's absolute github.com/hivecommons/hive/blob/v5/src/docs/crux-serve.md and crux-publish.md links are left as GitHub links. The documentation-map half is fixed as described. Not a blocker; a follow-up could give sibling sync access to the hive route map if those two README links matter.

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