{
  "schemaVersion": "uk-shortlists-buying-friction-index-dictionary.v1",
  "dataset": "UK Buying Friction Index 2026",
  "license": {
    "id": "CC-BY-4.0",
    "url": "https://creativecommons.org/licenses/by/4.0/"
  },
  "generator": {
    "version": "2.0.0",
    "path": "scripts/report/generate-uk-buying-friction-index.mjs",
    "command": "pnpm report:buying-friction-index"
  },
  "classification": {
    "includedFields": [
      "avoidIf",
      "dealbreakers",
      "checkBeforeBuying",
      "chooseAnotherRouteIf",
      "howWeChoseFactors",
      "evidenceSummary",
      "alternatives"
    ],
    "matchingRules": {
      "caseSensitive": false,
      "wordBoundaries": true,
      "stemMarker": "*",
      "stemBehaviour": "A term ending in * matches the declared stem followed by letters or hyphens.",
      "routeDeduplication": "Each guide contributes at most one count to each friction group."
    },
    "frictionDefinitions": [
      {
        "id": "dimensions-fit",
        "label": "Dimensions and physical fit",
        "terms": [
          "dimension*",
          "width",
          "height",
          "depth",
          "clearance",
          "worktop",
          "footprint",
          "measure*"
        ]
      },
      {
        "id": "compatibility-connections",
        "label": "Compatibility and connections",
        "terms": [
          "compatib*",
          "connector*",
          "connection*",
          "port",
          "network",
          "sim",
          "voltage",
          "mount*",
          "adapter*"
        ]
      },
      {
        "id": "installation-setup",
        "label": "Installation and setup",
        "terms": [
          "install*",
          "set-up",
          "setup",
          "assembly",
          "plumbing",
          "wiring",
          "configuration",
          "configure*"
        ]
      },
      {
        "id": "returns-warranty-support",
        "label": "Returns, warranty and support",
        "terms": [
          "return*",
          "warranty",
          "support",
          "repair*",
          "guarantee"
        ]
      },
      {
        "id": "seller-listing-identity",
        "label": "Seller and listing identity",
        "terms": [
          "seller*",
          "model code",
          "product identity",
          "bundle version*",
          "marketplace seller*"
        ]
      },
      {
        "id": "ownership-running-costs",
        "label": "Running and ownership costs",
        "terms": [
          "running cost",
          "energy",
          "consumable",
          "subscription",
          "replacement",
          "ongoing cost",
          "ownership cost"
        ]
      },
      {
        "id": "contract-cancellation-terms",
        "label": "Contract, cancellation and terms",
        "terms": [
          "contract",
          "cancellation",
          "deposit",
          "fees",
          "renewal",
          "provider terms",
          "booking terms"
        ]
      },
      {
        "id": "cleaning-upkeep",
        "label": "Cleaning and upkeep",
        "terms": [
          "clean*",
          "maintenance",
          "upkeep",
          "descale*",
          "filter replacement"
        ]
      },
      {
        "id": "delivery-availability",
        "label": "Delivery and availability",
        "terms": [
          "delivery",
          "stock",
          "availability",
          "lead time",
          "dispatch"
        ]
      },
      {
        "id": "capacity-use-case",
        "label": "Capacity and use-case fit",
        "terms": [
          "capacity",
          "load",
          "battery life",
          "range",
          "household",
          "buyer need",
          "use case",
          "use-case"
        ]
      }
    ]
  },
  "fields": [
    {
      "name": "friction_id",
      "type": "string",
      "description": "Stable identifier for the documented decision-friction group."
    },
    {
      "name": "friction",
      "type": "string",
      "description": "Human-readable friction-group label."
    },
    {
      "name": "route_count",
      "type": "integer",
      "description": "Number of analysed buying guides matching at least one documented term in the group."
    },
    {
      "name": "share_of_routes",
      "type": "number",
      "description": "route_count divided by the total analysed guide count; range 0 to 1."
    },
    {
      "name": "top_categories",
      "type": "string",
      "description": "Pipe-delimited category_id:route_count pairs for the five most represented buying areas."
    }
  ],
  "boundaries": [
    "This describes the published UK Shortlists guide collection; it is not a survey of all UK consumers or the whole retail market.",
    "Guide counts indicate recurring decision checks, not prevalence, severity, spending or harm.",
    "Keyword groups are documented and reproducible but do not replace qualitative consumer research.",
    "No personal data, proprietary retailer performance data or unsupported market-wide claim is included."
  ]
}