Skip to content

πŸ“– docs: resync the Hive docs mirror from hive@v5 - #537

Merged
hivecommons-hive[bot] merged 3 commits into
mainfrom
bot/hive-docs-refresh
Oct 31, 2026
Merged

hivecommons-hive[bot] merged 3 commits into
mainfrom
bot/hive-docs-refresh

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

Automated daily resync of the committed mirrors under docs/content/
via npm run sync-hive-docs and npm run sync-sibling-docs.

This PR was opened with GITHUB_TOKEN, so GitHub does not start
pull_request workflows for it. The refresh run instead dispatches
Build, TypeScript & Lint Check, Vitest, npm audit, Internal Links
and Markdown Lint on the PR branch; their check-runs land on the
head SHA as usual.

Refresh run: https://github.com/hivecommons/docs/actions/runs/41176512721

Refs #496

The hive sweep merges this PR once CI is green.

Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
@kubestellar-prow

Copy link
Copy Markdown

[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:

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

@netlify

netlify Bot commented Oct 31, 2026 •

Copy link
Copy Markdown

❌ Deploy Preview for hivecommons-docs failed. Why did it fail? β†’

Name Link
πŸ”¨ Latest commit 82d7598
πŸ” Latest deploy log https://app.netlify.com/projects/hivecommons-docs/deploys/6ae599a39370fb3d8afc5e7d

@hivecommons-hive

Copy link
Copy Markdown
Contributor

needs-human: GitHub Actions is holding this PR's workflow runs for approval, and Hive cannot start them. /ok-to-test on this repository belongs to Prow, which only accepts it from its trusted users, and hivecommons-hive[bot] is not one. Hive will not post the command again on this PR.

A maintainer can comment /ok-to-test (plus /lgtm and /approve for tide), or install .github/workflows/hive-ok-to-test.yml (hivectl ok-to-test-template) so the repository's own GITHUB_TOKEN approves trusted same-repo bot runs on Hive's command.

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

Content-only resync (all 61 changed files are under docs/content/) and every check the repo itself runs on head a2b81a9 is green: Lint and build, TypeScript & ESLint, unit tests, dependency audit, internal links, markdownlint, DCO.

The only red is Netlify: netlify/hivecommons-docs/deploy-preview plus its three derived checks (Header rules / Redirect rules / Pages changed) all point at the same deploy, https://app.netlify.com/projects/hivecommons-docs/deploys/6ae589ff3320d8888255379b. I can't read the Netlify log from here, so I can't tell whether that's a build error in the mirrored content or a Netlify-side failure β€” but since Lint and build succeeded on the same tree, Netlify-side is the likelier explanation. Open question for whoever owns the Netlify project: is the deploy-preview context required for this PR, and what does that deploy log say? If it's not required, nothing in the repo's own CI blocks this.

β€” hive: agent=reviewer-2 backend=copilot model=claude-fable-5.1 copilot=1.0.88

@hivecommons-hive

hivecommons-hive Bot commented Oct 31, 2026 •

Copy link
Copy Markdown
Contributor

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

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

docs-currency β€” delta re-review at 4c6f1b4 (merge of main into bot/hive-docs-refresh)

Previous finding sync-hive-docs allowlist misses new upstream subpages β€” fixed: scripts/sync-hive-docs.ts:53-59 now lists the six dashboard-sections/* and labels-and-control-signals/* subpages, src/app/docs/page-map.ts:137-143 adds nav entries, and scripts/sync-hive-docs.main.test.ts:161-170 asserts they are written.

Advisory (low, non-blocking): the committed mirror in this PR was generated before that allowlist landed, so docs/content/hive/dashboard-sections/ and docs/content/hive/labels-and-control-signals/ do not exist at this head, and docs/content/hive/dashboard-sections.md:60-96 still rewrites "Full entry" links to github.com instead of /docs/hive/dashboard-sections/.... The deployed site is unaffected because prebuild (package.json:10) re-runs the sync at build time and page-map.ts:368 silently drops nav entries with no file, and the next daily refresh will commit the six files. No action needed on this PR.

Previous finding Netlify deploy-preview failed despite bot/ skip rule* β€” still present at this head (netlify/hivecommons-docs/deploy-preview fail); infra, outside this perspective, already in backlog.

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

Intent-alignment delta re-review (head 4c6f1b4, delta vs a2b81a9)

The delta is a merge of main that brings in the allowlist/nav/test additions for the six dashboard-sections/* and labels-and-control-signals/* subpages (scripts/sync-hive-docs.ts:53-59, src/app/docs/page-map.ts:137-143). Nothing in the delta is out of contract.

Advisory (non-blocking): the mirror content in this PR was generated before the allowlist grew, so docs/content/hive/dashboard-sections/ and docs/content/hive/labels-and-control-signals/ do not exist at this head β€” the parent pages still deep-link off-site (docs/content/hive/labels-and-control-signals.md:13-15, docs/content/hive/dashboard-sections.md:60). The new nav entries are skipped harmlessly by the allDocFiles.includes(value) guard (page-map.ts:373), so build/links pass. The next scheduled hive-docs-refresh run (or a manual workflow_dispatch) will regenerate the branch with the six pages; merging as-is is safe but leaves that gap until then.

Prior findings: allowlist gap β€” fixed on main (allowlist/nav), mirror content still pending next refresh; Netlify deploy-preview failure β€” still present, out-of-scope (infra).

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

Summary: the mirrored content is fine as upstream content, but this head is stale relative to its own sync script β€” merging it leaves docs/content/hive/ out of sync with #540, which is on this very branch. Not harmful; self-healing on the next scheduled refresh. A maintainer can either re-dispatch hive-docs-refresh to refresh the branch, or merge and let tomorrow's run reconcile.

What I verified (head 4c6f1b4)

  • The head is a merge commit: a2b81a9 (the actual sync-hive-docs/sync-sibling-docs output, committed 06:26 UTC on parent 1d0863b) merged with main at 06f59e0 (πŸ› fix: mirror the split labels and dashboard-sections subpagesΒ #540, merged 07:11 UTC). scripts/sync-hive-docs.ts on this branch is byte-identical to main.
  • πŸ› fix: mirror the split labels and dashboard-sections subpagesΒ #540 added the split subpages to scripts/sync-hive-docs.ts:52-59 (dashboard-sections/{overview-and-metrics,workflow-and-agents,activity-monitor}.md, labels-and-control-signals/{reference,stage-labels,glossary-and-operations}.md). The sync in a2b81a9 ran against the pre-πŸ› fix: mirror the split labels and dashboard-sections subpagesΒ #540 script, so none of those six files are in this diff.
  • Re-running npm run sync-hive-docs && npm run sync-sibling-docs at this head produces 6 untracked files (the subpages above) plus 57 changed lines across contributor-relay.md, dashboard-sections.md, env-vars.md, labels-and-control-signals.md, running-at-level-6.md. The changes are link rewrites: this PR mirrors them as https://github.com/hivecommons/hive/blob/v5/src/docs/labels-and-control-signals/... (20 such links in labels-and-control-signals.md alone), whereas the current script resolves them to local routes like /docs/hive/labels-and-control-signals/glossary-and-operations#question-auto-close (env-vars.md:575).
  • Check internal doc links passes on this head only because the stale links are external GitHub URLs, which the checker does not follow β€” so CI will not catch this.
  • Diff touches only docs/content/; no scripts, workflows, or config. No injected markup in the added content.
  • The Netlify deploy-preview / header / redirect failures are the bot-PR ignore rule from fix(ci): gate bot deploy-preview ignore driftΒ #447, not something in this diff.

Not a defect in the content β€” just a sync that happened four minutes before the script it was merged with. Flagging so the sweep does not read "green" as "mirror complete".

@hivecommons-hive

Copy link
Copy Markdown
Contributor

Hive filed review findings that do not block this PR as backlog items:

Cap: 10 backlog item(s) per PR per day.

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

Correctness β€” delta re-review (a2b81a9 β†’ 4c6f1b4)

The delta fixes the earlier allowlist gap: scripts/sync-hive-docs.ts:53-59 now lists the six dashboard-sections/* and labels-and-control-signals/* subpages (all 200 on hive@v5), src/app/docs/page-map.ts:137-143 adds nav entries, and the test at scripts/sync-hive-docs.main.test.ts:161-170 asserts they are written. Nested paths follow the existing integrations/ precedent (page-map.ts:151-153, routeMap fallback page-map.ts:459-463), and resolveSyncTarget/mkdirSync (sync-hive-docs.ts:240-257) already handle subdirectories.

Advisory (low): the committed mirror was not regenerated after the allowlist change. The PR adds no docs/content/hive/dashboard-sections/*.md or labels-and-control-signals/*.md files, and docs/content/hive/dashboard-sections.md:60-114 still carries off-site github.com/.../blob/v5/src/docs/dashboard-sections/... links produced by the old allowlist. prebuild (package.json:10) re-runs the sync at build time so the deployed site is correct, and the next daily resync will commit the regenerated files β€” but at this head the committed mirror and the script disagree. Running npm run sync-hive-docs and committing would close that.

Previous findings: allowlist gap β€” fixed (script/nav/test), mirror content lags one cycle. Netlify deploy-preview failure β€” still present, pre-existing infra, not touched by this PR.

β€” hive: agent=adjudicator backend=copilot model=claude-fable-5.1 copilot=1.0.88

Hive-Fix-Attempt: 1/6

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: guide <280983584+hivecommons-hive[bot]@users.noreply.github.com>

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

Content-only resync; nothing here looks wrong to me.

  • All 67 changed files are under docs/content/ (61 hive, 2 dibs, 1 each crux/hotshot/promptargs/rationguard); no deletions, no changes to scripts, workflows or config.
  • The 6 newly added mirror files (hive/dashboard-sections/*, hive/labels-and-control-signals/*) each open with the > **Synced from Hive.** banner, so page.tsx:261 will resolve their source links upstream as intended.
  • Check internal doc links, markdownlint, build, lint and unit tests are green on 82d7598.

The four red Netlify statuses are the [context.deploy-preview].ignore rule at netlify.toml:53 matching bot/* β€” the deploy API shows skipped: true for this head, which Netlify surfaces as error. That is pre-existing behaviour for bot branches, not something in this diff.

β€” hive: agent=reviewer-2 backend=copilot model=claude-fable-5.1 copilot=1.0.88

@hivecommons-hive
hivecommons-hive Bot merged commit 238ddf3 into main Oct 31, 2026
8 of 13 checks passed
@kubestellar-prow
kubestellar-prow Bot deleted the bot/hive-docs-refresh branch October 31, 2026 07:43
@hivecommons-hive

Copy link
Copy Markdown
Contributor
Evidence bundle `#53782d7598` sha256:e6bbd96773d1a9fbe36f5ada425ca1c88cd24ecda25fcef47ccc3af283a9b0db β€” download from the dashboard or `hivectl review evidence #537`.

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.

0 participants