From d256a479ec0afc037f1eae5119d1680ab63e0d0c Mon Sep 17 00:00:00 2001 From: Karibhou <157208370+Karibhou@users.noreply.github.com> Date: Thu, 19 Nov 2026 01:50:05 +0100 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=96=20docs:=20publish=20Hive=20dashboa?= =?UTF-8?q?rd=20help=20guides?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Sync and index the missing operator help targets used by Hive dashboards. Hive-Run: hivecommons/hive#19182 Hive-Plan: Ask AI help phase 3 — Docs coverage Hive-Spec: dashboard-ask-ai-help.md#docs-coverage-in-kapa Co-authored-by: clubanderson <407614+clubanderson@users.noreply.github.com> Signed-off-by: Karibhou <157208370+Karibhou@users.noreply.github.com> --- .../added-hive-dashboard-help-guides.md | 1 + scripts/sync-hive-docs.files.json | 144 ++++++++++++++++++ scripts/sync-hive-docs.unsynced-allowlist.txt | 34 ----- src/app/docs/page-map.ts | 45 ++++++ 4 files changed, 190 insertions(+), 34 deletions(-) create mode 100644 changelog.d/added-hive-dashboard-help-guides.md diff --git a/changelog.d/added-hive-dashboard-help-guides.md b/changelog.d/added-hive-dashboard-help-guides.md new file mode 100644 index 0000000..feb8a18 --- /dev/null +++ b/changelog.d/added-hive-dashboard-help-guides.md @@ -0,0 +1 @@ +- Publish the Hive dashboard UI map and the guides linked from dashboard settings, including hub onboarding, deployment, and review evidence. diff --git a/scripts/sync-hive-docs.files.json b/scripts/sync-hive-docs.files.json index 71e15f4..f4ab577 100644 --- a/scripts/sync-hive-docs.files.json +++ b/scripts/sync-hive-docs.files.json @@ -399,5 +399,149 @@ }, { "source": "ui-render-evidence.md" + }, + { + "source": "advisory.md", + "route": "operations/automation-and-review/advisory-digest" + }, + { + "source": "agent-logging.md", + "route": "operations/agent-and-governor-controls/agent-peer-awareness-logging" + }, + { + "source": "agent-watchdog.md", + "route": "operations/agent-and-governor-controls/agent-watchdog" + }, + { + "source": "audit-campaign.md", + "route": "operations/automation-and-review/audit-campaign" + }, + { + "source": "backend-support-tiers.md", + "route": "operations/agent-and-governor-controls/agent-backend-support-tiers" + }, + { + "source": "cel-triggers.md", + "route": "operations/automation-and-review/cel-triggers" + }, + { + "source": "cli-pins.md", + "route": "operations/agent-and-governor-controls/cli-pins" + }, + { + "source": "compliance.md", + "route": "security/compliance-controls" + }, + { + "source": "contributor-trust-and-roles.md", + "route": "security/contributor-trust-and-roles" + }, + { + "source": "dashboard.md", + "route": "dashboard/spoke-dashboard" + }, + { + "source": "dashboard-ui-map.md", + "route": "dashboard/dashboard-ui-map" + }, + { + "source": "fleet-health.md", + "route": "hub/fleet-health" + }, + { + "source": "formal-verification.md", + "route": "operations/automation-and-review/formal-verification" + }, + { + "source": "github-app-setup.md", + "route": "integrating-with-hive/github-app-setup" + }, + { + "source": "governor-thresholds.md", + "route": "operations/agent-and-governor-controls/governor-thresholds" + }, + { + "source": "hive-merge.md", + "route": "operations/automation-and-review/hive-merge" + }, + { + "source": "hosted-hub.md", + "route": "hub/hosted-hive-hub-onboarding" + }, + { + "source": "hub-deployment.md", + "route": "hub/self-hosted-hub-deployment" + }, + { + "source": "hub-fleet-activity.md", + "route": "hub/fleet-activity" + }, + { + "source": "ioscan.md", + "route": "security/ioscan" + }, + { + "source": "linear-agent.md", + "route": "integrating-with-hive/linear-agent-integration" + }, + { + "source": "maintainer-commands.md", + "route": "operations/automation-and-review/maintainer-commands" + }, + { + "source": "native-merge-queue.md", + "route": "operations/automation-and-review/native-github-merge-queues" + }, + { + "source": "notifications.md", + "route": "dashboard/notifications" + }, + { + "source": "retro-lane.md", + "route": "operations/automation-and-review/retro-lane" + }, + { + "source": "review-bot-threads.md", + "route": "operations/automation-and-review/review-bot-threads" + }, + { + "source": "review-evidence.md", + "route": "hub/review-evidence-bundle" + }, + { + "source": "review-swarm.md", + "route": "operations/automation-and-review/review-swarm" + }, + { + "source": "sandbox-isolation.md", + "route": "security/sandbox-isolation" + }, + { + "source": "settings.md", + "route": "dashboard/dashboard-settings" + }, + { + "source": "snapshots.md", + "route": "dashboard/public-snapshots" + }, + { + "source": "spektacular.md", + "route": "operations/automation-and-review/spektacular-stage-runner" + }, + { + "source": "telemetry.md", + "route": "dashboard/data-collection-and-telemetry" + }, + { + "source": "token-mint.md", + "route": "security/token-mint" + }, + { + "source": "trajectory-review.md", + "route": "operations/automation-and-review/trajectory-review" + }, + { + "source": "upstream-watch.md", + "route": "operations/automation-and-review/upstream-watch" } ] diff --git a/scripts/sync-hive-docs.unsynced-allowlist.txt b/scripts/sync-hive-docs.unsynced-allowlist.txt index c3bacf3..fd148d1 100644 --- a/scripts/sync-hive-docs.unsynced-allowlist.txt +++ b/scripts/sync-hive-docs.unsynced-allowlist.txt @@ -13,15 +13,11 @@ acmm-advisor.md acmm-waivers.md advisory-staleness.md -advisory.md -agent-logging.md -agent-watchdog.md agents-md.md api-reference.md api-reference/agents-and-controls.md apiproxy.md attention-episodes.md -audit-campaign.md audit-log.md auto-update-profile.md backend-auth-recovery-runbook.md @@ -29,21 +25,16 @@ backend-gap-claude-managed-agents.md backend-gap-openai-agents-api.md backend-omnigent-cli-contract.md backend-smoke.md -backend-support-tiers.md beads-cli.md benchmarks/outcomes-2026-10.md benchmarks/README.md branding.md -cel-triggers.md ci-runner-labels.md -cli-pins.md cncf-reference-architecture.md cncf-sandbox-onboarding.md community.md -compliance.md config-layering.md contributor-token-policy.md -contributor-trust-and-roles.md credly-badges.md cross-cluster-migration.md custom-stylesheets.md @@ -51,7 +42,6 @@ dashboard-copy-inventory.md dashboard-design-system.md dashboard-source-layout.md dashboard-standalone-upgrades.md -dashboard.md deployment-scripts.md design/crux.md design/discord-issue-promotion.md @@ -73,34 +63,25 @@ duplicate-sweep.md evidence.md feedback.md fleet-drift-signals.md -fleet-health.md fleet-report.md forge-app-setup.md -formal-verification.md general-technical-review.md -github-app-setup.md github-cli-compact.md github-write-surface.md good-first-issue.md -governor-thresholds.md guide-flow-health.md health-checks.md heartbeat-bearer-cutover.md -hive-merge.md hive-of-the-week.md hive-open-issue.md hive-open-pr.md hivecommons-migration.md hooks.md -hosted-hub.md house-style.md -hub-deployment.md -hub-fleet-activity.md inception.md intent-verification.md ios-widget.md ioscan-red-team.md -ioscan.md issue-labels.md knowledge-confidence.md knowledge-connectors.md @@ -108,9 +89,7 @@ knowledge-curator.md knowledge-lifecycle.md knowledge-toc.md kubernetes-deployment.md -linear-agent.md lite-enrollment.md -maintainer-commands.md migration-v2-v4.md migration-v4-v5.md monitoring.md @@ -118,9 +97,7 @@ move-cross-runtime.md move-host.md move-hub-registered-cutover.md move-kubernetes.md -native-merge-queue.md network-requirements.md -notifications.md nous-hive-self-experiments.md nps.md operations.md @@ -157,20 +134,13 @@ releases.md repo-pause.md research/ablation-plan-2026-10.md research/backfill.md -retro-lane.md -review-bot-threads.md -review-evidence.md review-queue-triage.md -review-swarm.md runs.md -sandbox-isolation.md scale-envelope.md security-response.md security-self-assessment.md security.md -settings.md skills.md -snapshots.md soc2-control-mapping.md social-cards.md spoke-wildcard-tls.md @@ -179,13 +149,9 @@ strategy-lab.md streaming-the-activity-monitor.md supervisor.md swarm.md -telemetry.md tls-setup.md token-access-log.md -token-mint.md token-tracking.md -trajectory-review.md -upstream-watch.md v4-freeze-runbook.md v5-candidate-week.md v5-ga.md diff --git a/src/app/docs/page-map.ts b/src/app/docs/page-map.ts index 9372955..fe8919f 100644 --- a/src/app/docs/page-map.ts +++ b/src/app/docs/page-map.ts @@ -127,6 +127,28 @@ const NAV_STRUCTURE_HIVE: Array<{ title: string; items: NavItem[] }> = [ { 'Contributor relay': 'contributor-relay.md' }, { 'Using Spektacular with Hive': 'spektacular-runs.md' }, { 'The agent Terminal window': 'agent-terminal.md' }, + { 'Agent and governor controls': [ + { 'Agent peer-awareness logging': 'agent-logging.md' }, + { 'Agent watchdog': 'agent-watchdog.md' }, + { 'Agent backend support tiers': 'backend-support-tiers.md' }, + { 'CLI pins': 'cli-pins.md' }, + { 'Governor thresholds': 'governor-thresholds.md' }, + ] }, + { 'Automation and review': [ + { 'Advisory digest': 'advisory.md' }, + { 'Audit campaign': 'audit-campaign.md' }, + { 'CEL triggers': 'cel-triggers.md' }, + { 'Formal verification': 'formal-verification.md' }, + { 'Hive merge': 'hive-merge.md' }, + { 'Maintainer commands': 'maintainer-commands.md' }, + { 'Native GitHub merge queues': 'native-merge-queue.md' }, + { 'Retro lane': 'retro-lane.md' }, + { 'Review-bot threads': 'review-bot-threads.md' }, + { 'Review swarm': 'review-swarm.md' }, + { 'Spektacular stage runner': 'spektacular.md' }, + { 'Trajectory review': 'trajectory-review.md' }, + { 'Upstream watch': 'upstream-watch.md' }, + ] }, { 'Troubleshooting': 'troubleshooting.md' }, { 'Kick refusals': 'kick-refusals.md' }, { 'Release channels': 'release-channels.md' }, @@ -139,6 +161,12 @@ const NAV_STRUCTURE_HIVE: Array<{ title: string; items: NavItem[] }> = [ { title: 'Dashboard', items: [ + { 'Spoke dashboard': 'dashboard.md' }, + { 'Dashboard UI map': 'dashboard-ui-map.md' }, + { 'Dashboard settings': 'settings.md' }, + { 'Notifications': 'notifications.md' }, + { 'Public snapshots': 'snapshots.md' }, + { 'Data collection and telemetry': 'telemetry.md' }, { 'Dashboard sections explained': 'dashboard-sections.md' }, { 'Dashboard glossary': 'dashboard-glossary.md' }, { 'Dashboard overview and metrics': 'dashboard-sections/overview-and-metrics.md' }, @@ -150,10 +178,22 @@ const NAV_STRUCTURE_HIVE: Array<{ title: string; items: NavItem[] }> = [ { 'Labels glossary and operations': 'labels-and-control-signals/glossary-and-operations.md' }, ] }, + { + title: 'Hub', + items: [ + { 'Hosted Hive Hub onboarding': 'hosted-hub.md' }, + { 'Self-hosted hub deployment': 'hub-deployment.md' }, + { 'Fleet activity': 'hub-fleet-activity.md' }, + { 'Fleet health': 'fleet-health.md' }, + { 'Review evidence bundle': 'review-evidence.md' }, + ] + }, { title: 'Integrating with Hive', items: [ { 'Integration guide': 'integration-guide.md' }, + { 'GitHub App setup': 'github-app-setup.md' }, + { 'Linear agent integration': 'linear-agent.md' }, { 'Public knowledge MCP endpoint': 'public-knowledge-mcp.md' }, { 'Work-source providers': 'integrations/work-source-providers.md' }, { 'Clanker (Flue-style) interface': 'integrations/clanker-flue.md' }, @@ -170,6 +210,11 @@ const NAV_STRUCTURE_HIVE: Array<{ title: string; items: NavItem[] }> = [ { 'Security threat model': 'security-threat-model.md' }, { 'Hive trust levels vs Copilot assisted permissions': 'copilot-permissions-comparison.md' }, { 'ACMM policy matrix': 'acmm-policy-matrix.md' }, + { 'Compliance controls': 'compliance.md' }, + { 'Contributor trust and roles': 'contributor-trust-and-roles.md' }, + { 'ioscan': 'ioscan.md' }, + { 'Sandbox isolation': 'sandbox-isolation.md' }, + { 'Token mint': 'token-mint.md' }, ] }, {