Transcript of a real run of wdkg 0.2.0 against live Wikidata on 2026-09-28. Google Knowledge Graph was not configured and not called. Output is filtered with jq for readability; the unfiltered tool output is one compact JSON line per command.

# 1. Search a name that many places share. Only 3 candidates come back, with match flags.
$ wdkg search "Fox Theatre" --place Atlanta | jq '{resolution, candidates: [.candidates[] | {id, label, desc}], warnings, meta: .meta | {cache, upstream_requests, raw_bytes, bytes}}'
{
  "resolution": "single_supported_candidate",
  "candidates": [
    {
      "id": "Q1440190",
      "label": "Fox Theatre",
      "desc": "movie theater in Atlanta, Georgia, United States"
    },
    {
      "id": "Q3080199",
      "label": "Fox Theatre",
      "desc": "theater and former movie theater in Detroit, Michigan, United States"
    },
    {
      "id": "Q28453508",
      "label": "Fox Theatre",
      "desc": "former movie theater in Joplin, Missouri, United States, now a church, but also used for events and movie showings"
    }
  ],
  "warnings": [
    "same_name_elsewhere: 13 other candidate(s) share this name but do not mention 'Atlanta'; confirm location from statements",
    "verify_before_use: description-level evidence only; confirm with `entity <id>` statements (P31/P131/P17/P625)"
  ],
  "meta": {
    "cache": "miss",
    "upstream_requests": {
      "wikidata": 3
    },
    "raw_bytes": 4374,
    "bytes": 1694
  }
}

# 2. Resolve with only a name and a city: not enough for a place, so the answer is HOLD.
$ wdkg resolve "Fox Theatre" --kind place --city Atlanta | jq '{decision, wikidata_qid, reasons, candidate_ids, local_anchor_evidence, upstream_requests, cache_hits}'
{
  "decision": "HOLD",
  "wikidata_qid": null,
  "reasons": [
    "NO_LOCAL_ANCHOR"
  ],
  "candidate_ids": [
    "Q1440190",
    "Q3080199"
  ],
  "local_anchor_evidence": [
    "CITY_MATCH"
  ],
  "upstream_requests": {
    "wikidata": 3
  },
  "cache_hits": {
    "provider": 0,
    "resolution": false
  }
}

# 3. Add a local anchor, the official website, and ask for the per-candidate evidence.
$ wdkg resolve "Fox Theatre" --kind place --city Atlanta --url https://www.foxtheatre.org --explain | jq '{decision, wikidata_qid, local_anchor_evidence, upstream_requests, candidates: [.explain.identities[] | {qid, label, codes, conflicts, auto, why_not}], cache_hits}'
{
  "decision": "AUTO_MATCH",
  "wikidata_qid": "Q1440190",
  "local_anchor_evidence": [
    "CITY_MATCH",
    "OFFICIAL_HOST_EXACT"
  ],
  "upstream_requests": {},
  "candidates": [
    {
      "qid": "Q1440190",
      "label": "Fox Theatre",
      "codes": [
        "CITY_MATCH",
        "KIND_COMPATIBLE",
        "NAME_EXACT",
        "OFFICIAL_HOST_EXACT"
      ],
      "conflicts": null,
      "auto": true,
      "why_not": null
    },
    {
      "qid": "Q3080199",
      "label": "Fox Theatre",
      "codes": [
        "KIND_COMPATIBLE",
        "NAME_EXACT"
      ],
      "conflicts": [
        "CITY_CONFLICT",
        "OFFICIAL_HOST_CONFLICT"
      ],
      "auto": false,
      "why_not": "NO_LOCAL_ANCHOR"
    },
    {
      "qid": "Q1440189",
      "label": "Fox Theatre",
      "codes": [
        "NAME_EXACT"
      ],
      "conflicts": [
        "KIND_CONFLICT"
      ],
      "auto": false,
      "why_not": "NO_LOCAL_ANCHOR"
    }
  ],
  "cache_hits": {
    "provider": 13,
    "resolution": false
  }
}

# 4. Ask again: the answer comes from the local cache with zero upstream requests.
$ wdkg search "Fox Theatre" --place Atlanta | jq '{resolution, meta: .meta | {cache, upstream_requests}}'
{
  "resolution": "single_supported_candidate",
  "meta": {
    "cache": "hit",
    "upstream_requests": {}
  }
}

# 5. Same for the resolution.
$ wdkg resolve "Fox Theatre" --kind place --city Atlanta --url https://www.foxtheatre.org | jq '{decision, wikidata_qid, reasons, candidate_ids, local_anchor_evidence, upstream_requests, cache_hits}'
{
  "decision": "AUTO_MATCH",
  "wikidata_qid": "Q1440190",
  "reasons": [
    "AUTO_KIND_RULE_PASSED"
  ],
  "candidate_ids": [
    "Q1440190",
    "Q3080199"
  ],
  "local_anchor_evidence": [
    "CITY_MATCH",
    "OFFICIAL_HOST_EXACT"
  ],
  "upstream_requests": {},
  "cache_hits": {
    "provider": 0,
    "resolution": true
  }
}