docs(discovery-plane): finalize operator guide now that the plane is shipped and live#8165
docs(discovery-plane): finalize operator guide now that the plane is shipped and live#8165JSONbored wants to merge 1 commit into
Conversation
…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 didn't find any vulnerabilities or security issues in this PR. |
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
loopover-ui | 1d8e8b1 | Commit Preview URL Branch Preview URL |
Jul 23 2026, 07:37 AM |
Bundle ReportChanges will decrease total bundle size by 577 bytes (-0.01%) ⬇️. This is within the configured threshold ✅ Detailed changes
Affected Assets, Files, and Routes:view changes for bundle: loopover-uiAssets Changed:
|
…8167) A PR whose scoped-selection paths (backend/miner/mcp/discoveryIndex) only touch files no test imports -- e.g. a pure docs-only change under packages/loopover-miner/docs/** -- correctly triggers scoped test selection (vitest --changed=origin/main), which then correctly finds nothing to run ("No test files found, exiting with code 0"). That legitimate outcome wrote no coverage/lcov.info, which "Verify coverage report exists" treated as a hard failure regardless of cause. Confirmed live: PR #8165 (packages/loopover-miner/docs + apps/loopover-ui/ content/docs mdx only) failed all 3 validate-tests shards this way despite nothing being broken. Captures vitest's own "No test files found" stdout in the scoped branch and skips the coverage-existence check specifically for that case, while a real failure (tests ran and failed, or the step crashed before producing output) still fails the job exactly as before.
|
Caution 🛑 LoopOver review result - fixes requiredReview updated: 2026-07-23 08:01:18 UTC
Review summary Nits — 6 non-blocking
CI checks failing
Decision drivers
Context & advisory signals — never blocks the verdict
Linked issue satisfactionAddressed Review context
Contributor next steps
Signal definitions
🧪 Chat with LoopOverAsk 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.
Full command reference: https://loopover.ai/docs/loopover-commands 🧪 Experimental — new and may change. Visual preview
Click any thumbnail to open the full-size screenshot. Before = production · After = this PR's preview deploy. Scroll preview
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.
|
|
Closing and reopening as a fresh PR to force a clean CI run against the current branch tip (post-rebase onto the CI fix in #8167) -- the previous run was stuck showing stale results against the pre-rebase commit. |


Summary
discovery.loopover.ai(Cloudflare Container + Worker, deployed this session). Rewrites the operator guide (packages/loopover-miner+ the mirrored docs-site mdx) from "provisional/TBD" to the real, shipped opt-in mechanism.LOOPOVER_MINER_DISCOVERY_SHARED_SECRET(bearer auth against the hosted index), which wasn't in the original TBD list at all.recordDiscoveryTelemetryonly ever emits a bare{event, outcome}local log line — no hosted telemetry collector exists yet, so there's nothing to hash today.Closes #7169.
Test plan
src/**changes, so no Codecov impact.npx prettier --checkpasses on both changed files.curl https://discovery.loopover.ai/health→ 200,/ready→{"ready":true}.discovery-index-client.ts,discovery-index-contract.ts) rather than carrying over the original design doc unchanged.