Skip to content

docs(discovery-plane): finalize operator guide now that the plane is shipped and live#8168

Merged
JSONbored merged 2 commits into
mainfrom
docs/discovery-plane-operator-guide-finalize
Jul 23, 2026
Merged

docs(discovery-plane): finalize operator guide now that the plane is shipped and live#8168
JSONbored merged 2 commits into
mainfrom
docs/discovery-plane-operator-guide-finalize

Conversation

@JSONbored

Copy link
Copy Markdown
Owner

Summary

Reopened as a fresh PR (was #8165) to force a clean CI run against the current branch tip, now rebased onto #8167's CI fix for the scoped-test-selection zero-files case that originally false-failed this docs-only PR.

Closes #7169.

Test plan

  • Docs-only change; no src/** changes, so no Codecov impact.
  • npx prettier --check passes on both changed files.
  • Verified live: curl https://discovery.loopover.ai/health → 200, /ready{"ready":true}.
  • Cross-checked every invariant claim against the actual shipped module (discovery-index-client.ts, discovery-index-contract.ts) rather than carrying over the original design doc unchanged.

…shipped and live

#7164/#7166/#7167 all closed and the discovery-index server is now deployed
at discovery.loopover.ai (Cloudflare Container + Worker). Rewrites the
operator guide (packages/loopover-miner + the mirrored docs-site mdx) from
"provisional/TBD" to the real, shipped opt-in mechanism:

- Documents the real env vars, including LOOPOVER_MINER_DISCOVERY_SHARED_SECRET
  (used for bearer auth against the hosted index), which wasn't in the
  original TBD list at all.
- Adds the maintainer-run instance's real URL and a verification step
  (dry-run discover) to the opt-in checklist.
- Corrects a real invariant-list drift found while verifying: the doc
  claimed telemetry uses HMAC-hashed repo/issue correlation identifiers,
  but the shipped recordDiscoveryTelemetry only ever emits a bare
  {event, outcome} local log line -- no hosted telemetry collector exists
  yet, so there's nothing to hash today.
- Marks server-side soft-claim dedup shipped (was "server-side dedup is
  #4250 [open]").

Closes #7169.
@superagent-security

Copy link
Copy Markdown
Contributor

Superagent didn't find any vulnerabilities or security issues in this PR.

@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
loopover-ui 44c2661 Commit Preview URL

Branch Preview URL
Jul 23 2026, 08:04 AM

@codecov

codecov Bot commented Jul 23, 2026

Copy link
Copy Markdown

Bundle Report

Changes will increase total bundle size by 1.33kB (0.02%) ⬆️. This is within the configured threshold ✅

Detailed changes
Bundle name Size Change
loopover-ui 7.45MB 1.33kB (0.02%) ⬆️

Affected Assets, Files, and Routes:

view changes for bundle: loopover-ui

Assets Changed:

Asset Name Size Change Total Size Change (%)
assets/add-scalar-classes-Ba7UZWRw.js (New) 2.17MB 2.17MB 100.0% 🚀
assets/tanstack-vendor-CGmKsmHE.js (New) 812.72kB 812.72kB 100.0% 🚀
assets/docs.fumadocs-spike-api-reference-CszYPojK.js (New) 442.92kB 442.92kB 100.0% 🚀
assets/AgentScalarChatInterface.vue-80a2lWeq.js (New) 201.71kB 201.71kB 100.0% 🚀
assets/modal-BxDPqjTw.js (New) 184.38kB 184.38kB 100.0% 🚀
assets/client-BKslu3mo.js (New) 146.06kB 146.06kB 100.0% 🚀
assets/maintainer-panel-guN5y38u.js (New) 78.96kB 78.96kB 100.0% 🚀
assets/ui-vendor-B7kCyYvR.js (New) 57.04kB 57.04kB 100.0% 🚀
assets/routes-CCX-nazn.js (New) 34.83kB 34.83kB 100.0% 🚀
assets/owner-panel-AF8tVdnZ.js (New) 27.36kB 27.36kB 100.0% 🚀
assets/app-CyhZujUD.js (New) 25.7kB 25.7kB 100.0% 🚀
assets/ams-discovery-plane-BtWJ9Dmo.js (New) 25.16kB 25.16kB 100.0% 🚀
assets/app.runs-BofNolTN.js (New) 23.56kB 23.56kB 100.0% 🚀
assets/miner-panel-BWKewySq.js (New) 20.25kB 20.25kB 100.0% 🚀
assets/api._op-Bp0yPfmt.js (New) 17.55kB 17.55kB 100.0% 🚀
assets/self-hosting-docs-audit-Cq3JLO3r.js (New) 16.63kB 16.63kB 100.0% 🚀
assets/app.index-BWvrlWDs.js (New) 15.62kB 15.62kB 100.0% 🚀
assets/playground-panel-C3k6CPW0.js (New) 14.49kB 14.49kB 100.0% 🚀
assets/app.audit-C2_AO2Qd.js (New) 10.11kB 10.11kB 100.0% 🚀
assets/app.config-generator-C6YA4Rkn.js (New) 10.09kB 10.09kB 100.0% 🚀
assets/extension-BEy5DPPe.js (New) 10.04kB 10.04kB 100.0% 🚀
assets/fairness-Dv7Hwqdv.js (New) 8.34kB 8.34kB 100.0% 🚀
assets/maintainers-DTTZoMh7.js (New) 8.03kB 8.03kB 100.0% 🚀
assets/miners-DfSvsLhl.js (New) 7.85kB 7.85kB 100.0% 🚀
assets/agents-xYQhlUva.js (New) 7.76kB 7.76kB 100.0% 🚀
assets/commands-panel-DwnvZ83z.js (New) 6.65kB 6.65kB 100.0% 🚀
assets/maintainer-workflow-BxoJ0RXH.js (New) 6.5kB 6.5kB 100.0% 🚀
assets/roadmap-oOv1N4S9.js (New) 6.33kB 6.33kB 100.0% 🚀
assets/digest-panel-p7V1RoCV.js (New) 6.18kB 6.18kB 100.0% 🚀
assets/repos._owner._repo.quality-BizLh2Wb.js (New) 6.14kB 6.14kB 100.0% 🚀
assets/docs.index-DJU0S0ic.js (New) 5.61kB 5.61kB 100.0% 🚀
assets/api.index-B28eKFme.js (New) 4.7kB 4.7kB 100.0% 🚀
assets/api-CNGp7-KC.js (New) 2.69kB 2.69kB 100.0% 🚀
assets/docs-B3zXf8ix.js (New) 2.67kB 2.67kB 100.0% 🚀
assets/app.workbench-CGPyTavk.js (New) 1.58kB 1.58kB 100.0% 🚀
assets/session-CAcqcYut.js (New) 1.45kB 1.45kB 100.0% 🚀
assets/tooltip-Ba3sdtv2.js (New) 1.45kB 1.45kB 100.0% 🚀
assets/tabs-BTW77s-B.js (New) 1.39kB 1.39kB 100.0% 🚀
assets/app.repos-DmtxWIBn.js (New) 1.07kB 1.07kB 100.0% 🚀
assets/input-1nxE5avS.js (New) 796 bytes 796 bytes 100.0% 🚀
assets/file-cog-CTZVexKK.js (New) 758 bytes 758 bytes 100.0% 🚀
assets/docs.ai-summaries-CB9NJAOr.js (New) 506 bytes 506 bytes 100.0% 🚀
assets/app.maintainer-nnEIHMU8.js (New) 502 bytes 502 bytes 100.0% 🚀
assets/docs.backtest-calibration-DroKONa2.js (New) 499 bytes 499 bytes 100.0% 🚀
assets/docs.branch-analysis-TUu-5Y3W.js (New) 499 bytes 499 bytes 100.0% 🚀
assets/docs.scoreability-DJ7Lx361.js (New) 499 bytes 499 bytes 100.0% 🚀
assets/docs.upstream-drift-ALzg5ZU8.js (New) 499 bytes 499 bytes 100.0% 🚀
assets/docs.federated-fleet-intelligence-BChuNCMr.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.maintainer-install-trust-C0hpg0T6.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-ai-providers-DaBCoI7Y.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-backup-scaling-jBj-16iu.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-configuration-pOdbmWj-.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-docs-audit-BwPg-A8K.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-github-app-Dv6wSn_e.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-quickstart-t9wuZg0I.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-rag-BobcKzIR.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-rees-6vLd95Hi.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-rees-analyzers-BZf2OS-2.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-release-checklist-BNyMVSLs.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-releases-BaZZTN83.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-security-ynYWmdlP.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-troubleshooting-CJRDQv58.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-unified-ams-orb-BPdoSEF9.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.ams-config-precedence-D3LM978F.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.ams-deployment-B4Ks1mMB.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.ams-discovery-plane-BXKoY33t.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.ams-env-reference-DnR9QA_e.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.ams-fleet-manifest-iH9t74QM.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.ams-goal-spec-CHueYsvb.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.ams-kill-switch-incident-ByQ--zKp.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.ams-observability-BOAlXDWO.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.ams-operations-runbook-nxBSq0BX.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.ams-sizing-B4gxb2RB.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.ams-unattended-scheduling-2wl4Opnv.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.beta-onboarding-Dbtn9-3G.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.capacity-FRXVtfhu.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.maintainer-self-hosting-DgkWpZKU.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.mcp-clients-Dn5U0qz0.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.owner-checklist-DJb5ZIXM.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.quickstart-CoFcp8SY.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.github-app-BCkocsCJ.js (New) 495 bytes 495 bytes 100.0% 🚀
assets/docs.maintainer-workflow-ecjVmBOg.js (New) 495 bytes 495 bytes 100.0% 🚀
assets/docs.privacy-security-IW2kNjlp.js (New) 495 bytes 495 bytes 100.0% 🚀
assets/docs.troubleshooting-5CKKzBuD.js (New) 495 bytes 495 bytes 100.0% 🚀
assets/docs.tuning-BzxhBN6E.js (New) 495 bytes 495 bytes 100.0% 🚀
assets/docs.loopover-commands-BN72FSGm.js (New) 494 bytes 494 bytes 100.0% 🚀
assets/sparkles-DAetH6vZ.js (New) 494 bytes 494 bytes 100.0% 🚀
assets/docs.how-reviews-work-C4U6L9OV.js (New) 493 bytes 493 bytes 100.0% 🚀
assets/app.owner-Brk9nsgD.js (New) 474 bytes 474 bytes 100.0% 🚀
assets/app.commands-B5J-9etv.js (New) 455 bytes 455 bytes 100.0% 🚀
assets/app.playground-_3ELLzKW.js (New) 442 bytes 442 bytes 100.0% 🚀
assets/reveal-BZdxie0X.js (New) 442 bytes 442 bytes 100.0% 🚀
assets/index-hSEdhHia.js (New) 438 bytes 438 bytes 100.0% 🚀
assets/app.digest-CuDAjp2J.js (New) 430 bytes 430 bytes 100.0% 🚀
assets/eye-off-D5ZHm1XN.js (New) 430 bytes 430 bytes 100.0% 🚀
assets/app.miner-DgFefuA0.js (New) 422 bytes 422 bytes 100.0% 🚀
assets/key-round-zKyicDYy.js (New) 355 bytes 355 bytes 100.0% 🚀
assets/bot-DGhzrhah.js (New) 328 bytes 328 bytes 100.0% 🚀
assets/trash-2-6Nal-fw4.js (New) 328 bytes 328 bytes 100.0% 🚀
assets/save-B3h4Pty2.js (New) 327 bytes 327 bytes 100.0% 🚀
assets/git-pull-request-arrow-Dc1DGhOw.js (New) 321 bytes 321 bytes 100.0% 🚀
assets/wrench-BlSer4Wl.js (New) 303 bytes 303 bytes 100.0% 🚀
assets/list-checks-ZGGH04lE.js (New) 279 bytes 279 bytes 100.0% 🚀
assets/shield-CsfTq7NJ.js (New) 272 bytes 272 bytes 100.0% 🚀
assets/workflow-V5EMTRgA.js (New) 265 bytes 265 bytes 100.0% 🚀
assets/compass-Vd8VLb31.js (New) 251 bytes 251 bytes 100.0% 🚀
assets/history-BYPKT4y3.js (New) 237 bytes 237 bytes 100.0% 🚀
assets/activity-DqGMheA3.js (New) 234 bytes 234 bytes 100.0% 🚀
assets/message-square-BKcuhC7r.js (New) 233 bytes 233 bytes 100.0% 🚀
assets/lock-M-Mo1es-.js (New) 206 bytes 206 bytes 100.0% 🚀
assets/rotate-cw-D5vFTk9X.js (New) 201 bytes 201 bytes 100.0% 🚀
assets/play-CyUSvNCl.js (New) 190 bytes 190 bytes 100.0% 🚀
assets/circle-check-FTqZKkSs.js (New) 178 bytes 178 bytes 100.0% 🚀
assets/search-Q2arJK89.js (New) 174 bytes 174 bytes 100.0% 🚀
assets/circle-GKw6yXxz.js (New) 130 bytes 130 bytes 100.0% 🚀
assets/add-scalar-classes-DoMG1MWf.js (Deleted) -2.17MB 0 bytes -100.0% 🗑️
assets/tanstack-vendor-DWvrspw9.js (Deleted) -812.72kB 0 bytes -100.0% 🗑️
assets/docs.fumadocs-spike-api-reference-CSv30828.js (Deleted) -442.92kB 0 bytes -100.0% 🗑️
assets/AgentScalarChatInterface.vue-Rj4bOqW-.js (Deleted) -201.71kB 0 bytes -100.0% 🗑️
assets/modal-C_ykDaDf.js (Deleted) -184.38kB 0 bytes -100.0% 🗑️
assets/client-BK2rdKEU.js (Deleted) -146.06kB 0 bytes -100.0% 🗑️
assets/maintainer-panel-CSrbbPU2.js (Deleted) -78.96kB 0 bytes -100.0% 🗑️
assets/ui-vendor-DxlHZDYq.js (Deleted) -57.04kB 0 bytes -100.0% 🗑️
assets/routes-QoaWhWEq.js (Deleted) -34.83kB 0 bytes -100.0% 🗑️
assets/owner-panel-BtE_YQB5.js (Deleted) -27.36kB 0 bytes -100.0% 🗑️
assets/app-D3YZg7E3.js (Deleted) -25.7kB 0 bytes -100.0% 🗑️
assets/ams-discovery-plane-DVYyV0n9.js (Deleted) -23.83kB 0 bytes -100.0% 🗑️
assets/app.runs-Br8Vq1VK.js (Deleted) -23.56kB 0 bytes -100.0% 🗑️
assets/miner-panel-c6XL3IQ4.js (Deleted) -20.25kB 0 bytes -100.0% 🗑️
assets/api._op-DpSv1Rxk.js (Deleted) -17.55kB 0 bytes -100.0% 🗑️
assets/self-hosting-docs-audit-DFlk9ZWN.js (Deleted) -16.63kB 0 bytes -100.0% 🗑️
assets/app.index-vQK-HEeU.js (Deleted) -15.62kB 0 bytes -100.0% 🗑️
assets/playground-panel-BvQMhnt4.js (Deleted) -14.49kB 0 bytes -100.0% 🗑️
assets/app.audit-BXobjF2W.js (Deleted) -10.11kB 0 bytes -100.0% 🗑️
assets/app.config-generator-CCp5Qkst.js (Deleted) -10.09kB 0 bytes -100.0% 🗑️
assets/extension-MKAII5CV.js (Deleted) -10.04kB 0 bytes -100.0% 🗑️
assets/fairness-DCrABRKT.js (Deleted) -8.34kB 0 bytes -100.0% 🗑️
assets/maintainers-B7GmmqDS.js (Deleted) -8.03kB 0 bytes -100.0% 🗑️
assets/miners-a0hcwxbL.js (Deleted) -7.85kB 0 bytes -100.0% 🗑️
assets/agents-DijuljGB.js (Deleted) -7.76kB 0 bytes -100.0% 🗑️
assets/commands-panel-B1ToX1uW.js (Deleted) -6.65kB 0 bytes -100.0% 🗑️
assets/maintainer-workflow-CxEfIpZe.js (Deleted) -6.5kB 0 bytes -100.0% 🗑️
assets/roadmap-rmj0kdTU.js (Deleted) -6.33kB 0 bytes -100.0% 🗑️
assets/digest-panel-KNxp_Ukv.js (Deleted) -6.18kB 0 bytes -100.0% 🗑️
assets/repos._owner._repo.quality-uC94JB5W.js (Deleted) -6.14kB 0 bytes -100.0% 🗑️
assets/docs.index-tU3Ub-Pt.js (Deleted) -5.61kB 0 bytes -100.0% 🗑️
assets/api.index-DCJTfp8K.js (Deleted) -4.7kB 0 bytes -100.0% 🗑️
assets/api-BHxelMfq.js (Deleted) -2.69kB 0 bytes -100.0% 🗑️
assets/docs-21XmXJCV.js (Deleted) -2.67kB 0 bytes -100.0% 🗑️
assets/app.workbench-CNn7UUeU.js (Deleted) -1.58kB 0 bytes -100.0% 🗑️
assets/session-CSiLowQ4.js (Deleted) -1.45kB 0 bytes -100.0% 🗑️
assets/tooltip-D5bjJgZ2.js (Deleted) -1.45kB 0 bytes -100.0% 🗑️
assets/tabs-BnGIuxAi.js (Deleted) -1.39kB 0 bytes -100.0% 🗑️
assets/app.repos-6TGsXLSO.js (Deleted) -1.07kB 0 bytes -100.0% 🗑️
assets/input-o7J2b3vV.js (Deleted) -796 bytes 0 bytes -100.0% 🗑️
assets/file-cog-D0XPr4N3.js (Deleted) -758 bytes 0 bytes -100.0% 🗑️
assets/docs.ai-summaries-C_yv-wU-.js (Deleted) -506 bytes 0 bytes -100.0% 🗑️
assets/app.maintainer-C_sbkeFj.js (Deleted) -502 bytes 0 bytes -100.0% 🗑️
assets/docs.backtest-calibration-BwfBbQIl.js (Deleted) -499 bytes 0 bytes -100.0% 🗑️
assets/docs.branch-analysis-B11bvZWY.js (Deleted) -499 bytes 0 bytes -100.0% 🗑️
assets/docs.scoreability-CnAw05o4.js (Deleted) -499 bytes 0 bytes -100.0% 🗑️
assets/docs.upstream-drift-CuL8Wwep.js (Deleted) -499 bytes 0 bytes -100.0% 🗑️
assets/docs.federated-fleet-intelligence-94bZgX7f.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.maintainer-install-trust-DejINKTb.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-ai-providers-r3yaZhkQ.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-backup-scaling-BjBhv-32.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-configuration-DktHxwW5.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-docs-audit-VyB9dcl3.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-github-app-H0ryS-Xr.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-quickstart-BH345jvi.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-rag-vyMMKVYy.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-rees-7t-pG5RM.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-rees-analyzers-D4UmIeJ8.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-release-checklist-BQJPjWZi.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-releases-DSjujzrv.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-security-BfghHqSy.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-troubleshooting-BwOZjM5O.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-unified-ams-orb-BEDfKLzG.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.ams-config-precedence-D_-Yamz1.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.ams-deployment-DN5uc90k.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.ams-discovery-plane-S1OKDzM_.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.ams-env-reference-DXmFiGFZ.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.ams-fleet-manifest-DMlNbyFx.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.ams-goal-spec-B-Vj2c2j.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.ams-kill-switch-incident-l5YlkISY.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.ams-observability-Gnp91tz-.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.ams-operations-runbook-R6qG4-MT.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.ams-sizing-Bb-2IkPb.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.ams-unattended-scheduling-CUTwaVNw.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.beta-onboarding-BaPX36o3.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.capacity-RawBX8ky.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.maintainer-self-hosting-CA_RKD50.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.mcp-clients-CdaHvOrC.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.owner-checklist-EXV_QpZk.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.quickstart-afDS8Uye.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.github-app-Dtp4gN1B.js (Deleted) -495 bytes 0 bytes -100.0% 🗑️
assets/docs.maintainer-workflow-DaH5n89N.js (Deleted) -495 bytes 0 bytes -100.0% 🗑️
assets/docs.privacy-security-DxSOZ2sZ.js (Deleted) -495 bytes 0 bytes -100.0% 🗑️
assets/docs.troubleshooting-FQXJS9hX.js (Deleted) -495 bytes 0 bytes -100.0% 🗑️
assets/docs.tuning-DzMzA6c0.js (Deleted) -495 bytes 0 bytes -100.0% 🗑️
assets/docs.loopover-commands-CpbWlMUr.js (Deleted) -494 bytes 0 bytes -100.0% 🗑️
assets/sparkles-ByQE1gIm.js (Deleted) -494 bytes 0 bytes -100.0% 🗑️
assets/docs.how-reviews-work-DYptYCRv.js (Deleted) -493 bytes 0 bytes -100.0% 🗑️
assets/app.owner-ehJSzLzs.js (Deleted) -474 bytes 0 bytes -100.0% 🗑️
assets/app.commands-Cd8w5pse.js (Deleted) -455 bytes 0 bytes -100.0% 🗑️
assets/app.playground-BW0cAJNb.js (Deleted) -442 bytes 0 bytes -100.0% 🗑️
assets/reveal-DPT3z331.js (Deleted) -442 bytes 0 bytes -100.0% 🗑️
assets/index-Dq4FohIo.js (Deleted) -438 bytes 0 bytes -100.0% 🗑️
assets/app.digest-BxipMTZz.js (Deleted) -430 bytes 0 bytes -100.0% 🗑️
assets/eye-off-CXVmEQX4.js (Deleted) -430 bytes 0 bytes -100.0% 🗑️
assets/app.miner-Rg545f-a.js (Deleted) -422 bytes 0 bytes -100.0% 🗑️
assets/key-round-DyPUz58D.js (Deleted) -355 bytes 0 bytes -100.0% 🗑️
assets/bot-C10n2klW.js (Deleted) -328 bytes 0 bytes -100.0% 🗑️
assets/trash-2-DfGZsIKE.js (Deleted) -328 bytes 0 bytes -100.0% 🗑️
assets/save-N3lRqxPd.js (Deleted) -327 bytes 0 bytes -100.0% 🗑️
assets/git-pull-request-arrow-Caj62haE.js (Deleted) -321 bytes 0 bytes -100.0% 🗑️
assets/wrench-DOj0GZ0G.js (Deleted) -303 bytes 0 bytes -100.0% 🗑️
assets/list-checks-0JT2nP7U.js (Deleted) -279 bytes 0 bytes -100.0% 🗑️
assets/shield-Bki2mcUJ.js (Deleted) -272 bytes 0 bytes -100.0% 🗑️
assets/workflow-6nU41OET.js (Deleted) -265 bytes 0 bytes -100.0% 🗑️
assets/compass-0aMzXRw8.js (Deleted) -251 bytes 0 bytes -100.0% 🗑️
assets/history-B4CHExgh.js (Deleted) -237 bytes 0 bytes -100.0% 🗑️
assets/activity-CQLlBlR7.js (Deleted) -234 bytes 0 bytes -100.0% 🗑️
assets/message-square--Ol9wwM1.js (Deleted) -233 bytes 0 bytes -100.0% 🗑️
assets/lock-CVWhoEHL.js (Deleted) -206 bytes 0 bytes -100.0% 🗑️
assets/rotate-cw-X7hpSOaX.js (Deleted) -201 bytes 0 bytes -100.0% 🗑️
assets/play-lgf9Y0QX.js (Deleted) -190 bytes 0 bytes -100.0% 🗑️
assets/circle-check-Bu6zCkJ0.js (Deleted) -178 bytes 0 bytes -100.0% 🗑️
assets/search-BbqsRtM4.js (Deleted) -174 bytes 0 bytes -100.0% 🗑️
assets/circle-Dy8xb1iV.js (Deleted) -130 bytes 0 bytes -100.0% 🗑️

@loopover-orb loopover-orb Bot added the gittensor:bug Gittensor-scored bug fix — scores a 0.05x multiplier. label Jul 23, 2026
@loopover-orb

loopover-orb Bot commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

Caution

🛑 LoopOver review result - fixes required

Review updated: 2026-07-23 08:23:57 UTC

2 files · 1 AI reviewer · no blockers · CI failing · blocked

🛑 Suggested Action - Manual Review

Review summary
This is a docs-only PR that updates two mirrored operator-guide files (mdx + md) to reflect a shipped hosted discovery-index plane, replacing 'TBD/provisional' language with concrete env vars, the live URL, a new bearer-auth env var (LOOPOVER_MINER_DISCOVERY_SHARED_SECRET), and a corrected telemetry claim (local log line only, no hosted collector or HMAC hashing yet). The two files stay consistent with each other, the described drift-correction (telemetry) is a real, verifiable improvement over the prior doc's overstated claim, and the PR explicitly closes #7169. No src/** changes, so no coverage impact; the two FAILED checks (validate, validate-tests-merge) are reported with no detail, and this PR states it was rebased onto #8167's fix for a related zero-files false-failure, which is a plausible explanation for at least one of them, but the actual cause of these two failures cannot be confirmed from what's given here.

Nits — 7 non-blocking
  • `LOOPOVER_MINER_DISCOVERY_PLANE` is described as 'Master opt-in' in both files (ams-discovery-plane.mdx and discovery-plane-operator-guide.md) — consider 'main' or 'primary' opt-in per inclusive-terminology conventions.
  • The doc doesn't specify what happens if `LOOPOVER_MINER_DISCOVERY_SHARED_SECRET` is unset while the maintainer-run instance requires one (e.g. does the client just get a 401 and fail-open per the stated fail-open behavior, or fail loudly?) — worth one clarifying sentence.
  • The dry-run verification step (item 6) doesn't say what a 'hosted-index candidate' looks like in the `--json` output, making it hard for an operator to confirm success/failure at a glance.
  • Add a one-line example of the `--json` output shape referenced in item 6 of the operator checklist so operators know what to grep for.
  • Since this is described as a 'fresh PR reopened to force a clean CI run,' confirm the validate / validate-tests-merge failures are indeed the known zero-files false-failure and not a new regression before merging.
  • PR author also opened the linked issue — Link an issue that was opened by a different contributor, or provide a rationale for why this self-authored issue represents genuine discovery work.
  • Diff looks like trivial or whitespace-only churn — Reduce whitespace-only or formatting-only churn and keep the diff focused on substantive changes.

CI checks failing

  • validate
  • validate-tests-merge

Decision drivers

  • ✅ Code review — No blockers (1 reviewer)
  • ✅ Gate result — Passing (No configured blocker found.)
Context & advisory signals — never blocks the verdict
Signal Result Evidence
Linked issue ✅ Linked #7169
Related work ✅ No active overlap found No same-issue or scoped active PR overlap found.
Change scope ✅ 20/20 Low review scope from cached public metadata (1 linked issue).
Validation posture ✅ 25/25 PR body includes validation/test evidence.
Contributor workload ✅ 10/10 Author activity: 14 registered-repo PR(s), 14 merged, 253 issue(s).
Contributor context ✅ Confirmed Gittensor contributor JSONbored; Gittensor profile; 14 PR(s), 253 issue(s).
Improvement ℹ️ Insufficient signal risk: low · value: insufficient-signal
Linked issue satisfaction

Addressed
The PR rewrites the operator guide from provisional/TBD framing to a shipped state, adds a concrete opt-in walkthrough (env vars including a new SHARED_SECRET, checklist, dry-run verification), and re-verifies each invariant against actual code, notably correcting the telemetry HMAC claim to reflect the real local-only log line implementation.

Review context
  • Author: JSONbored
  • Role context: owner (maintainer lane)
  • Public audience mode: oss maintainer
  • Lane context: Repository is configured for direct PR review.
  • Public profile languages: Python, TypeScript, Ruby, Go, JavaScript, MDX, Shell, Solidity
  • Official Gittensor activity: 14 PR(s), 253 issue(s).
  • PR-specific overlap: none found.
Contributor next steps
  • Start here: Treat this as maintainer-lane context rather than normal contributor-lane activity.
Signal definitions
  • Related work = same linked issue, overlapping active PRs, or title/path similarity.
  • Change scope = cached public metadata such as size labels, draft state, and review-burden hints.
  • Validation posture = whether the PR provides enough public validation/test evidence for maintainer review.
  • Contributor workload = public contributor activity and cleanup pressure, not a repo-wide quality failure.
  • Contributor context = public GitHub/Gittensor identity context; non-Gittensor status is not a blocker.
🧪 Chat with LoopOver

Ask LoopOver a question about this PR directly in a comment — grounded only in the same cached, public-safe facts shown above, never a new claim.

  • @loopover ask <question> answers contribution-quality Q&A with source citations and freshness.
  • @loopover chat <question> answers in natural prose from cached decision-pack facts via local inference (maintainer/collaborator; read-only).
  • A plain-language @loopover mention with a real question is routed to the closest matching read-only command automatically — no exact syntax required.

Full command reference: https://loopover.ai/docs/loopover-commands

🧪 Experimental — new and may change.

Visual preview
Route Viewport Before (production) After (this PR's preview) Diff
/ desktop before /
before /
after /
after /
/ mobile before / (mobile)
before / (mobile)
after / (mobile)
after / (mobile)

Click any thumbnail to open the full-size screenshot. Before = production · After = this PR's preview deploy.

Scroll preview
Route Before (production) After (this PR's preview)
/ before / (scroll)
before / (scroll)
after / (scroll)
after / (scroll)

A short scroll-through clip (desktop) — click either thumbnail to open the full animation. Evidence for scroll-linked behavior a single screenshot can't show.

🟩 Safe / merged · 🟦 Advisory · 🟨 Held for review · 🟥 Blocked / closed


💰 Earn for open-source contributions like this. Gittensor lets GitHub contributors earn for the work they already do — register to start earning →.

Checked by LoopOver, a quiet PR intelligence layer for OSS maintainers.

  • Re-run LoopOver review

@loopover-orb loopover-orb Bot added the manual-review Gittensor contributor context label Jul 23, 2026
JSONbored added a commit that referenced this pull request Jul 23, 2026
…8174)

#8167 fixed the per-shard --changed case (exits 0 with "No test files
found"), but --mergeReports exits 1 for the same condition -- a different
code path, not covered by that fix. Confirmed live: PR #8168 (the same
docs-only PR #8167 was meant to unblock) passed all 3 validate-tests shards
but still failed validate-tests-merge with "No test files found, exiting
with code 1", even with COVERAGE_NO_THRESHOLDS already disabling the
threshold check.

Only treats that exact case as success, and only when COVERAGE_NO_THRESHOLDS
is set (i.e. this run is the scoped case to begin with) -- in the unscoped
full-suite case, "no test files found" while merging is still a real
failure worth surfacing loudly.
@JSONbored
JSONbored merged commit 08e5c45 into main Jul 23, 2026
13 of 15 checks passed
@JSONbored
JSONbored deleted the docs/discovery-plane-operator-guide-finalize branch July 23, 2026 08:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

gittensor:bug Gittensor-scored bug fix — scores a 0.05x multiplier. manual-review Gittensor contributor context

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs(discovery-plane): finalize operator guide once env vars ship

1 participant