{
  "dictionary_version": "1.0.0",
  "published_at": "2026-08-25",
  "formula_change_policy": "Mudança de fórmula exige nova versão; uma série histórica nunca é reescrita retroativamente.",
  "reporting_contract": "Toda medição exibe metric_id, versão, período, estado, denominador e origem.",
  "measurement_states": {
    "MEASURED": "Valor observado e calculável com a fonte e o denominador declarados.",
    "ZERO": "A métrica foi medida e o valor observado foi exatamente zero.",
    "NOT_MEASURED": "A instrumentação ou a coleta não foi executada no período.",
    "NOT_ATTRIBUTABLE": "Houve observação, mas o contrato não permite atribuí-la à origem ou intervenção.",
    "MISSING": "A medição era esperada, mas a evidência está ausente ou irrecuperável."
  },
  "metrics": {
    "technical_readiness_score": {
      "metric_id": "technical_readiness_score",
      "version": "1.0.0",
      "name": "Technical Readiness Score",
      "formula": "soma dos pesos dos sinais técnicos aprovados na versão do score",
      "numerator": "pontos dos sinais aprovados",
      "denominator": "100 pontos possíveis na versão declarada",
      "unit": "score_0_100",
      "interpretation": "Prontidão técnica; não é KPI de citação ou resultado."
    },
    "machine_readable_truth_accuracy": {
      "metric_id": "machine_readable_truth_accuracy",
      "version": "1.0.0",
      "name": "Machine-readable Truth Accuracy",
      "formula": "valores extraídos corretamente / valores canônicos testados",
      "numerator": "valores extraídos iguais à fonte canônica",
      "denominator": "valores canônicos testados",
      "unit": "proportion",
      "interpretation": "Paridade determinística entre fonte, HTML e parser."
    },
    "discovery_rate": {
      "metric_id": "discovery_rate",
      "version": "1.0.0",
      "name": "Discovery Rate",
      "formula": "execuções unbranded válidas que mencionam corretamente a entidade / execuções unbranded válidas",
      "numerator": "execuções válidas com menção inequívoca",
      "denominator": "execuções unbranded válidas; erros e recusas seguem o contrato pré-registrado",
      "unit": "proportion",
      "interpretation": "Menção correta; não exige link oficial."
    },
    "official_citation_rate": {
      "metric_id": "official_citation_rate",
      "version": "1.0.0",
      "name": "Official Citation Rate",
      "formula": "execuções unbranded válidas com citação ao hostname oficial / execuções unbranded válidas",
      "numerator": "execuções válidas com hostname oficial citado",
      "denominator": "execuções unbranded válidas",
      "unit": "proportion",
      "interpretation": "Menção sem link oficial não entra no numerador."
    },
    "citation_source_share": {
      "metric_id": "citation_source_share",
      "version": "1.0.0",
      "name": "Citation Source Share",
      "formula": "citações válidas de um domínio / todas as citações válidas na rodada",
      "numerator": "citações válidas do domínio",
      "denominator": "todas as citações válidas na rodada",
      "unit": "proportion",
      "interpretation": "Participação de fonte, não share of voice de marca."
    },
    "verified_crawler_coverage": {
      "metric_id": "verified_crawler_coverage",
      "version": "1.0.0",
      "name": "Verified Crawler Coverage",
      "formula": "URLs canônicas acessadas por uma classe de bot verificada / URLs canônicas elegíveis",
      "numerator": "URLs canônicas com acesso de origem e user-agent verificados",
      "denominator": "URLs canônicas elegíveis no período e na classe de bot",
      "unit": "proportion_by_bot_class",
      "interpretation": "Nunca agregar classes de treino, busca e fetch em um único valor."
    },
    "crawler_freshness_lag": {
      "metric_id": "crawler_freshness_lag",
      "version": "1.0.0",
      "name": "Crawler Freshness Lag",
      "formula": "timestamp do primeiro acesso verificado - timestamp da publicação registrada",
      "numerator": "not_applicable",
      "denominator": "uma alteração registrada e um primeiro acesso verificado",
      "unit": "duration_seconds",
      "interpretation": "Observacional; não demonstra indexação."
    },
    "ai_referral_sessions": {
      "metric_id": "ai_referral_sessions",
      "version": "1.0.0",
      "name": "AI Referral Sessions",
      "formula": "contagem deduplicada de sessões com referrer explícito conhecido ou UTM controlada",
      "numerator": "sessões que atendem ao classificador versionado",
      "denominator": "sessões elegíveis observadas no período",
      "unit": "sessions",
      "interpretation": "Autorrelato e direct/unknown são séries separadas."
    },
    "engaged_ai_referral_rate": {
      "metric_id": "engaged_ai_referral_rate",
      "version": "1.0.0",
      "name": "Engaged AI Referral Rate",
      "formula": "sessões AI-referral que atendem ao contrato de engajamento / sessões AI-referral",
      "numerator": "sessões AI-referral engajadas",
      "denominator": "sessões AI-referral elegíveis",
      "unit": "proportion",
      "interpretation": "O contrato de engajamento é pré-registrado."
    },
    "booking_engine_handoff_rate": {
      "metric_id": "booking_engine_handoff_rate",
      "version": "1.0.0",
      "name": "Booking Engine Handoff Rate",
      "formula": "sessões AI-referral com handoff válido / sessões AI-referral elegíveis",
      "numerator": "sessões com evento de handoff válido",
      "denominator": "sessões AI-referral elegíveis",
      "unit": "proportion",
      "interpretation": "Handoff não é reserva."
    },
    "confirmed_ai_assisted_leads": {
      "metric_id": "confirmed_ai_assisted_leads",
      "version": "1.0.0",
      "name": "Confirmed AI-assisted Leads",
      "formula": "contagem deduplicada de leads cuja evidência atende ao contrato de atribuição",
      "numerator": "leads confirmados e deduplicados",
      "denominator": "leads elegíveis com consentimento no período",
      "unit": "leads",
      "interpretation": "Modelos de atribuição não podem duplicar o mesmo lead."
    },
    "confirmed_ai_assisted_revenue": {
      "metric_id": "confirmed_ai_assisted_revenue",
      "version": "1.0.0",
      "name": "Confirmed AI-assisted Revenue",
      "formula": "soma da receita confirmada na fonte autorizada ligada a assist válido",
      "numerator": "valor monetário confirmado",
      "denominator": "transações elegíveis no período e janela de atribuição",
      "unit": "currency_declared",
      "interpretation": "Observado, atribuído e estimado ficam em colunas distintas."
    },
    "uplift": {
      "metric_id": "uplift",
      "version": "1.0.0",
      "name": "Uplift",
      "formula": "estimativa pré-registrada da diferença tratamento - controle, ajustada pelo baseline quando definido",
      "numerator": "efeito estimado conforme plano estatístico",
      "denominator": "unidades elegíveis de tratamento e controle",
      "unit": "effect_size_declared",
      "interpretation": "Técnica e efeito mínimo detectável são pré-registrados."
    },
    "replication_count": {
      "metric_id": "replication_count",
      "version": "1.0.0",
      "name": "Replication Count",
      "formula": "contagem de contextos independentes com resultado compatível segundo regra prévia",
      "numerator": "replicações compatíveis",
      "denominator": "tentativas independentes de replicação",
      "unit": "count",
      "interpretation": "Falhas de replicação permanecem públicas."
    }
  }
}
