[TheGreatAxios]

Summary

Replace the git-install README with a registry-first README: Install, Use, Full example, How it works, Contributing.

Quickstart now models the real production call site, not a toy example: read RERANK_BASE_URL/RERANK_MODEL from host config at boot (fail fast on a half-configured reranker, matching how retrieval pipelines already treat this endpoint), call rerankDocuments with typed RerankDoc[] candidates, and fall back to the caller's own fused order in a catch when the reranker is unavailable — the degrade-soft policy real retrieval pipelines apply so a reranker outage never fails search.

Verification

• Install is npm / pnpm / yarn / bun of @corbits/reranking (no github: URL)
• Quickstart calls the package's real top-level entry point, rerankDocuments from src/index.ts, with real exported types (RerankDoc, RerankResult) and @intx/inference's createDefaultScheduler — the same deps = { fetch, scheduler } shape production hosts already build for chat and embeddings
• Quickstart's env-var + degrade-soft-catch shape matches how @corbits/memory's hybrid search pipeline wires its own rerank client (RERANK_BASE_URL/RERANK_MODEL, fail-fast boot, fallback to fused ranking on failure)
• Quickstart code fence compiles standalone against this repo's own tsconfig.json (bunx tsc --noEmit)
• Contributing commands match package.json scripts (build, test, typecheck); Node >= 24 / Bun >= 1.2.0

Fixes CL-8775

Follow-up

• The catch {} block silently swallowed a reranker outage. rerankFusedCandidates now takes an onError: (error: unknown) => void host callback, reports the caught error through it, then falls back to the fused order — same degrade-soft behavior, but the failure is now surfaced instead of hidden.