{
  "dataset_identifier": "llb-consumer-intelligence-2026-08-12-r4",
  "dataset_version": "2026.08.12-r4",
  "important_definitions": {
    "best_observed_maps_position": "The best discovery position captured for an office across the fixed query collection. Positions can repeat and do not affect the score.",
    "hidden_leader": "A qualified office with best observed Maps position greater than 20 and a Review Evidence Score at or above the qualified-market median.",
    "qualified_office": "An office that passes the Review Evidence Score inputs and the versioned practice-signal classifier for a practice/city cohort.",
    "review_evidence_score": "A 0-100 comparison score derived from public-review evidence; it does not measure legal skill, credentials, outcomes, or client fit.",
    "review_volume_hhi": "The Herfindahl-Hirschman Index calculated from each qualified office's share of tracked reviews in a market."
  },
  "privacy_exclusions": [
    "address",
    "cid",
    "evidence_excerpt",
    "latitude",
    "longitude",
    "matched_terms",
    "matched_terms_json",
    "owner_response_text",
    "phone",
    "place_id",
    "provider_payload",
    "raw_payload",
    "review_text",
    "reviewer_name"
  ],
  "ranking_methodology": {
    "fixed_priors": {
      "communication_rate": 17.9,
      "consistency": 92.6,
      "negative_sentiment_rate": 3.0,
      "owner_response_rate": 67.6,
      "public_rating": 4.875,
      "recommendation_rate": 60.0
    },
    "maps_visibility": "Google Maps discovery position is retained separately and never enters this score.",
    "minimum_analyzed_text_reviews": 50,
    "prior_strength": 50,
    "scope": "Public-review evidence only; not legal ability, credentials, outcomes, or case fit.",
    "tie_breaks": [
      "score descending",
      "analyzed text-review count descending",
      "tracked public-review count descending",
      "firm name ascending",
      "stable firm id ascending"
    ],
    "transforms": {
      "communication": "Bayesian adjusted communication-mention percentage / 40 * 100, capped at 100",
      "consistency": "Bayesian adjusted review-consistency index",
      "low_concern": "100 - 5 * Bayesian adjusted negative-sentiment percentage, floored at 0",
      "owner_response": "Bayesian adjusted public owner-reply percentage",
      "public_rating": "Bayesian adjusted rating, then clamp((rating - 4.0) * 100, 0, 100)",
      "recommendation": "Bayesian adjusted explicit-recommendation percentage",
      "review_depth": "100 * log(1 + tracked_reviews) / log(1 + 2500), capped at 100"
    },
    "version": "review-evidence-v1.0.0",
    "weights": {
      "communication": 0.15,
      "consistency": 0.1,
      "low_concern": 0.1,
      "owner_response": 0.1,
      "public_rating": 0.25,
      "recommendation": 0.2,
      "review_depth": 0.1
    }
  },
  "record_granularity": {
    "coverage.json": "Every practice/city matrix cell, including withheld and unassessed cells.",
    "hidden-leaders.csv": "One qualified office beyond observed Maps position 20 with a score at or above its market median.",
    "market-concentration.csv": "One publishable market with tracked-review concentration measures.",
    "market-depth.csv": "One publishable practice/city market.",
    "markets/*.json": "One publishable practice/city market with all qualified offices.",
    "office-index.json": "One office qualified for at least one publishable market."
  }
}
