feat: add search_scope to all teachers + cross-reference tool for inter-teacher dialogue

Each teacher's meta.json now includes search_scope with tradition-specific
CBETA/SuttaCentral IDs, dictionary sources, and keywords for focused RAG
retrieval. New tools/cross_reference.py enables lineage queries and
cross-tradition concept comparison via FoJin KG.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

prebuilt/ajahn_chah/meta.json

@@ -5,17 +5,69 @@
   "tradition": "南传",
   "school": "泰国森林传承",
   "era": "1918-1992",
-  "languages": ["en", "th", "pi", "zh"],
+  "languages": [
+    "en",
+    "th",
+    "pi",
+    "zh"
+  ],
   "fojin_entity_id": null,
   "sources": [
-    {"type": "suttacentral", "id": "dn22", "title": "Mahāsatipaṭṭhāna Sutta"},
+    {
-    {"type": "suttacentral", "id": "sn56.11", "title": "Dhammacakkappavattana Sutta"},
+      "type": "suttacentral",
-    {"type": "suttacentral", "id": "sn35.28", "title": "Ādittapariyāya Sutta"},
+      "id": "dn22",
-    {"type": "suttacentral", "id": "mn10", "title": "Satipaṭṭhāna Sutta"},
+      "title": "Mahāsatipaṭṭhāna Sutta"
-    {"type": "suttacentral", "id": "sn22.59", "title": "Anattalakkhaṇa Sutta"}
+    },
+    {
+      "type": "suttacentral",
+      "id": "sn56.11",
+      "title": "Dhammacakkappavattana Sutta"
+    },
+    {
+      "type": "suttacentral",
+      "id": "sn35.28",
+      "title": "Ādittapariyāya Sutta"
+    },
+    {
+      "type": "suttacentral",
+      "id": "mn10",
+      "title": "Satipaṭṭhāna Sutta"
+    },
+    {
+      "type": "suttacentral",
+      "id": "sn22.59",
+      "title": "Anattalakkhaṇa Sutta"
+    }
   ],
   "version": "1.0.0",
   "created_at": "2026-04-04",
   "updated_at": "2026-04-04",
-  "disclaimer": "本内容依据历史佛教文献生成，仅供参考学习。如需正式修行指导，请亲近善知识。"
+  "disclaimer": "本内容依据历史佛教文献生成，仅供参考学习。如需正式修行指导，请亲近善知识。",
+  "search_scope": {
+    "primary_suttacentral_ids": [
+      "dn22",
+      "sn56.11",
+      "sn35.28",
+      "mn10",
+      "sn22.59"
+    ],
+    "traditions": [
+      "南传",
+      "上座部"
+    ],
+    "dictionary_sources": [
+      "dpd",
+      "pts",
+      "ncped"
+    ],
+    "keywords": [
+      "anicca",
+      "dukkha",
+      "anatta",
+      "satipatthana",
+      "vipassana",
+      "无常",
+      "正念"
+    ]
+  }
 }

prebuilt/fazang/meta.json

@@ -4,17 +4,64 @@
   "tradition": "汉传",
   "school": "华严宗",
   "era": "643-712",
-  "languages": ["zh-classical", "zh"],
+  "languages": [
+    "zh-classical",
+    "zh"
+  ],
   "fojin_entity_id": null,
   "sources": [
-    {"type": "cbeta", "id": "T10n0279", "title": "大方广佛华严经(八十华严)"},
+    {
-    {"type": "cbeta", "id": "T35n1733", "title": "华严经探玄记"},
+      "type": "cbeta",
-    {"type": "cbeta", "id": "T45n1866", "title": "华严一乘教义分齐章"},
+      "id": "T10n0279",
-    {"type": "cbeta", "id": "T45n1875", "title": "华严经义海百门"},
+      "title": "大方广佛华严经(八十华严)"
-    {"type": "cbeta", "id": "T45n1876", "title": "修华严奥旨妄尽还源观"}
+    },
+    {
+      "type": "cbeta",
+      "id": "T35n1733",
+      "title": "华严经探玄记"
+    },
+    {
+      "type": "cbeta",
+      "id": "T45n1866",
+      "title": "华严一乘教义分齐章"
+    },
+    {
+      "type": "cbeta",
+      "id": "T45n1875",
+      "title": "华严经义海百门"
+    },
+    {
+      "type": "cbeta",
+      "id": "T45n1876",
+      "title": "修华严奥旨妄尽还源观"
+    }
   ],
   "version": "1.0.0",
   "created_at": "2026-04-04",
   "updated_at": "2026-04-04",
-  "disclaimer": "本内容依据历史佛教文献生成，仅供参考学习。如需正式修行指导，请亲近善知识。"
+  "disclaimer": "本内容依据历史佛教文献生成，仅供参考学习。如需正式修行指导，请亲近善知识。",
+  "search_scope": {
+    "primary_cbeta_ids": [
+      "T10n0279",
+      "T35n1733",
+      "T45n1866",
+      "T45n1875",
+      "T45n1876"
+    ],
+    "traditions": [
+      "华严"
+    ],
+    "dictionary_sources": [
+      "foguang",
+      "dingfubao"
+    ],
+    "keywords": [
+      "法界",
+      "华严",
+      "十玄",
+      "六相",
+      "事事无碍",
+      "因陀罗网"
+    ]
+  }
 }

prebuilt/huineng/meta.json

@@ -4,15 +4,54 @@
   "tradition": "汉传",
   "school": "禅宗",
   "era": "638-713",
-  "languages": ["zh-classical", "zh"],
+  "languages": [
+    "zh-classical",
+    "zh"
+  ],
   "fojin_entity_id": null,
   "sources": [
-    {"type": "cbeta", "id": "T48n2008", "title": "六祖大师法宝坛经"},
+    {
-    {"type": "cbeta", "id": "T08n0235", "title": "金刚般若波罗蜜经"},
+      "type": "cbeta",
-    {"type": "cbeta", "id": "T14n0475", "title": "维摩诘所说经"}
+      "id": "T48n2008",
+      "title": "六祖大师法宝坛经"
+    },
+    {
+      "type": "cbeta",
+      "id": "T08n0235",
+      "title": "金刚般若波罗蜜经"
+    },
+    {
+      "type": "cbeta",
+      "id": "T14n0475",
+      "title": "维摩诘所说经"
+    }
   ],
   "version": "1.0.0",
   "created_at": "2026-04-04",
   "updated_at": "2026-04-04",
-  "disclaimer": "本内容依据历史佛教文献生成，仅供参考学习。如需正式修行指导，请亲近善知识。"
+  "disclaimer": "本内容依据历史佛教文献生成，仅供参考学习。如需正式修行指导，请亲近善知识。",
+  "search_scope": {
+    "primary_cbeta_ids": [
+      "T48n2008",
+      "T08n0235",
+      "T14n0475"
+    ],
+    "traditions": [
+      "禅宗",
+      "般若"
+    ],
+    "dictionary_sources": [
+      "foguang",
+      "dingfubao"
+    ],
+    "keywords": [
+      "自性",
+      "顿悟",
+      "见性",
+      "无念",
+      "禅",
+      "本心",
+      "般若"
+    ]
+  }
 }

prebuilt/kumarajiva/meta.json

@@ -5,18 +5,73 @@
   "tradition": "汉传",
   "school": "三论宗/中观",
   "era": "344-413",
-  "languages": ["zh-classical", "zh", "sa"],
+  "languages": [
+    "zh-classical",
+    "zh",
+    "sa"
+  ],
   "fojin_entity_id": null,
   "sources": [
-    {"type": "cbeta", "id": "T09n0262", "title": "妙法莲华经"},
+    {
-    {"type": "cbeta", "id": "T08n0235", "title": "金刚般若波罗蜜经"},
+      "type": "cbeta",
-    {"type": "cbeta", "id": "T14n0475", "title": "维摩诘所说经"},
+      "id": "T09n0262",
-    {"type": "cbeta", "id": "T30n1564", "title": "中论"},
+      "title": "妙法莲华经"
-    {"type": "cbeta", "id": "T25n1509", "title": "大智度论"},
+    },
-    {"type": "cbeta", "id": "T12n0366", "title": "佛说阿弥陀经"}
+    {
+      "type": "cbeta",
+      "id": "T08n0235",
+      "title": "金刚般若波罗蜜经"
+    },
+    {
+      "type": "cbeta",
+      "id": "T14n0475",
+      "title": "维摩诘所说经"
+    },
+    {
+      "type": "cbeta",
+      "id": "T30n1564",
+      "title": "中论"
+    },
+    {
+      "type": "cbeta",
+      "id": "T25n1509",
+      "title": "大智度论"
+    },
+    {
+      "type": "cbeta",
+      "id": "T12n0366",
+      "title": "佛说阿弥陀经"
+    }
   ],
   "version": "1.0.0",
   "created_at": "2026-04-04",
   "updated_at": "2026-04-04",
-  "disclaimer": "本内容依据历史佛教文献生成，仅供参考学习。如需正式修行指导，请亲近善知识。"
+  "disclaimer": "本内容依据历史佛教文献生成，仅供参考学习。如需正式修行指导，请亲近善知识。",
+  "search_scope": {
+    "primary_cbeta_ids": [
+      "T09n0262",
+      "T08n0235",
+      "T14n0475",
+      "T30n1564",
+      "T25n1509"
+    ],
+    "traditions": [
+      "中观",
+      "三论",
+      "般若"
+    ],
+    "dictionary_sources": [
+      "foguang",
+      "dingfubao",
+      "soothill"
+    ],
+    "keywords": [
+      "空",
+      "中道",
+      "般若",
+      "法华",
+      "不二",
+      "八不"
+    ]
+  }
 }

prebuilt/ouyi/meta.json

@@ -4,17 +4,68 @@
   "tradition": "汉传",
   "school": "天台/净土（跨宗派）",
   "era": "1599-1655",
-  "languages": ["zh-classical", "zh"],
+  "languages": [
+    "zh-classical",
+    "zh"
+  ],
   "fojin_entity_id": null,
   "sources": [
-    {"type": "cbeta", "id": "T37n1762", "title": "阿弥陀经要解"},
+    {
-    {"type": "cbeta", "id": "T09n0262", "title": "妙法莲华经"},
+      "type": "cbeta",
-    {"type": "cbeta", "id": "T24n1484", "title": "梵网经"},
+      "id": "T37n1762",
-    {"type": "cbeta", "id": "T12n0366", "title": "佛说阿弥陀经"},
+      "title": "阿弥陀经要解"
-    {"type": "cbeta", "id": "T31n1585", "title": "成唯识论"}
+    },
+    {
+      "type": "cbeta",
+      "id": "T09n0262",
+      "title": "妙法莲华经"
+    },
+    {
+      "type": "cbeta",
+      "id": "T24n1484",
+      "title": "梵网经"
+    },
+    {
+      "type": "cbeta",
+      "id": "T12n0366",
+      "title": "佛说阿弥陀经"
+    },
+    {
+      "type": "cbeta",
+      "id": "T31n1585",
+      "title": "成唯识论"
+    }
   ],
   "version": "1.0.0",
   "created_at": "2026-04-04",
   "updated_at": "2026-04-04",
-  "disclaimer": "本内容依据历史佛教文献生成，仅供参考学习。如需正式修行指导，请亲近善知识。"
+  "disclaimer": "本内容依据历史佛教文献生成，仅供参考学习。如需正式修行指导，请亲近善知识。",
+  "search_scope": {
+    "primary_cbeta_ids": [
+      "T37n1762",
+      "T09n0262",
+      "T24n1484",
+      "T12n0366",
+      "T31n1585"
+    ],
+    "traditions": [
+      "天台",
+      "净土",
+      "唯识",
+      "律宗"
+    ],
+    "dictionary_sources": [
+      "foguang",
+      "dingfubao",
+      "tiantai"
+    ],
+    "keywords": [
+      "天台",
+      "净土",
+      "念佛",
+      "六信",
+      "止观",
+      "性相融会"
+    ]
+  }
 }

prebuilt/tsongkhapa/meta.json

@@ -5,17 +5,54 @@
   "tradition": "藏传",
   "school": "格鲁派",
   "era": "1357-1419",
-  "languages": ["bo", "zh", "sa"],
+  "languages": [
+    "bo",
+    "zh",
+    "sa"
+  ],
   "fojin_entity_id": null,
   "sources": [
-    {"type": "text", "title": "菩提道次第广论 (Lam Rim Chen Mo)"},
+    {
-    {"type": "text", "title": "密宗道次第广论 (sNgags Rim Chen Mo)"},
+      "type": "text",
-    {"type": "text", "title": "入中论善显密意疏"},
+      "title": "菩提道次第广论 (Lam Rim Chen Mo)"
-    {"type": "text", "title": "辨了不了义善说藏论"},
+    },
-    {"type": "text", "title": "三主要道 (Lam gTso rNam gSum)"}
+    {
+      "type": "text",
+      "title": "密宗道次第广论 (sNgags Rim Chen Mo)"
+    },
+    {
+      "type": "text",
+      "title": "入中论善显密意疏"
+    },
+    {
+      "type": "text",
+      "title": "辨了不了义善说藏论"
+    },
+    {
+      "type": "text",
+      "title": "三主要道 (Lam gTso rNam gSum)"
+    }
   ],
   "version": "1.0.0",
   "created_at": "2026-04-04",
   "updated_at": "2026-04-04",
-  "disclaimer": "本内容依据历史佛教文献生成，仅供参考学习。如需正式修行指导，请亲近善知识。"
+  "disclaimer": "本内容依据历史佛教文献生成，仅供参考学习。如需正式修行指导，请亲近善知识。",
+  "search_scope": {
+    "traditions": [
+      "藏传",
+      "格鲁"
+    ],
+    "dictionary_sources": [
+      "rangjung",
+      "hopkins"
+    ],
+    "keywords": [
+      "道次第",
+      "三主要道",
+      "菩提心",
+      "空性",
+      "止观",
+      "出离心"
+    ]
+  }
 }

prebuilt/xuanzang/meta.json

@@ -4,18 +4,71 @@
   "tradition": "汉传",
   "school": "法相唯识宗",
   "era": "602-664",
-  "languages": ["zh-classical", "zh", "sa"],
+  "languages": [
+    "zh-classical",
+    "zh",
+    "sa"
+  ],
   "fojin_entity_id": null,
   "sources": [
-    {"type": "cbeta", "id": "T07n0220", "title": "大般若波罗蜜多经"},
+    {
-    {"type": "cbeta", "id": "T30n1579", "title": "瑜伽师地论"},
+      "type": "cbeta",
-    {"type": "cbeta", "id": "T31n1585", "title": "成唯识论"},
+      "id": "T07n0220",
-    {"type": "cbeta", "id": "T08n0251", "title": "般若波罗蜜多心经"},
+      "title": "大般若波罗蜜多经"
-    {"type": "cbeta", "id": "T29n1558", "title": "阿毗达磨俱舍论"},
+    },
-    {"type": "cbeta", "id": "T51n2087", "title": "大唐西域记"}
+    {
+      "type": "cbeta",
+      "id": "T30n1579",
+      "title": "瑜伽师地论"
+    },
+    {
+      "type": "cbeta",
+      "id": "T31n1585",
+      "title": "成唯识论"
+    },
+    {
+      "type": "cbeta",
+      "id": "T08n0251",
+      "title": "般若波罗蜜多心经"
+    },
+    {
+      "type": "cbeta",
+      "id": "T29n1558",
+      "title": "阿毗达磨俱舍论"
+    },
+    {
+      "type": "cbeta",
+      "id": "T51n2087",
+      "title": "大唐西域记"
+    }
   ],
   "version": "1.0.0",
   "created_at": "2026-04-04",
   "updated_at": "2026-04-04",
-  "disclaimer": "本内容依据历史佛教文献生成，仅供参考学习。如需正式修行指导，请亲近善知识。"
+  "disclaimer": "本内容依据历史佛教文献生成，仅供参考学习。如需正式修行指导，请亲近善知识。",
+  "search_scope": {
+    "primary_cbeta_ids": [
+      "T07n0220",
+      "T30n1579",
+      "T31n1585",
+      "T08n0251"
+    ],
+    "traditions": [
+      "唯识",
+      "法相"
+    ],
+    "dictionary_sources": [
+      "foguang",
+      "dingfubao",
+      "yogacara"
+    ],
+    "keywords": [
+      "唯识",
+      "阿赖耶识",
+      "三性",
+      "五位百法",
+      "因明",
+      "瑜伽"
+    ]
+  }
 }

prebuilt/xuyun/meta.json

@@ -4,16 +4,57 @@
   "tradition": "汉传",
   "school": "禅宗（五宗兼嗣）",
   "era": "1840-1959",
-  "languages": ["zh"],
+  "languages": [
+    "zh"
+  ],
   "fojin_entity_id": null,
   "sources": [
-    {"type": "cbeta", "id": "T19n0945", "title": "大佛顶首楞严经"},
+    {
-    {"type": "cbeta", "id": "T08n0235", "title": "金刚般若波罗蜜经"},
+      "type": "cbeta",
-    {"type": "cbeta", "id": "T48n2008", "title": "六祖大师法宝坛经"},
+      "id": "T19n0945",
-    {"type": "cbeta", "id": "T17n0842", "title": "大方广圆觉修多罗了义经"}
+      "title": "大佛顶首楞严经"
+    },
+    {
+      "type": "cbeta",
+      "id": "T08n0235",
+      "title": "金刚般若波罗蜜经"
+    },
+    {
+      "type": "cbeta",
+      "id": "T48n2008",
+      "title": "六祖大师法宝坛经"
+    },
+    {
+      "type": "cbeta",
+      "id": "T17n0842",
+      "title": "大方广圆觉修多罗了义经"
+    }
   ],
   "version": "1.0.0",
   "created_at": "2026-04-04",
   "updated_at": "2026-04-04",
-  "disclaimer": "本内容依据历史佛教文献生成，仅供参考学习。如需正式修行指导，请亲近善知识。"
+  "disclaimer": "本内容依据历史佛教文献生成，仅供参考学习。如需正式修行指导，请亲近善知识。",
+  "search_scope": {
+    "primary_cbeta_ids": [
+      "T19n0945",
+      "T08n0235",
+      "T48n2008",
+      "T17n0842"
+    ],
+    "traditions": [
+      "禅宗"
+    ],
+    "dictionary_sources": [
+      "foguang",
+      "dingfubao"
+    ],
+    "keywords": [
+      "参禅",
+      "话头",
+      "疑情",
+      "开悟",
+      "禅七",
+      "禅净双修"
+    ]
+  }
 }

prebuilt/yinguang/meta.json

@@ -4,18 +4,70 @@
   "tradition": "汉传",
   "school": "净土宗",
   "era": "1861-1940",
-  "languages": ["zh-classical", "zh"],
+  "languages": [
+    "zh-classical",
+    "zh"
+  ],
   "fojin_entity_id": null,
   "sources": [
-    {"type": "cbeta", "id": "X62n1182", "title": "印光法师文钞正编"},
+    {
-    {"type": "cbeta", "id": "X62n1183", "title": "印光法师文钞续编"},
+      "type": "cbeta",
-    {"type": "cbeta", "id": "X62n1184", "title": "印光法师文钞三编"},
+      "id": "X62n1182",
-    {"type": "cbeta", "id": "T12n0366", "title": "佛说阿弥陀经"},
+      "title": "印光法师文钞正编"
-    {"type": "cbeta", "id": "T12n0365", "title": "佛说观无量寿佛经"},
+    },
-    {"type": "cbeta", "id": "T12n0360", "title": "佛说无量寿经"}
+    {
+      "type": "cbeta",
+      "id": "X62n1183",
+      "title": "印光法师文钞续编"
+    },
+    {
+      "type": "cbeta",
+      "id": "X62n1184",
+      "title": "印光法师文钞三编"
+    },
+    {
+      "type": "cbeta",
+      "id": "T12n0366",
+      "title": "佛说阿弥陀经"
+    },
+    {
+      "type": "cbeta",
+      "id": "T12n0365",
+      "title": "佛说观无量寿佛经"
+    },
+    {
+      "type": "cbeta",
+      "id": "T12n0360",
+      "title": "佛说无量寿经"
+    }
   ],
   "version": "1.0.0",
   "created_at": "2026-04-04",
   "updated_at": "2026-04-04",
-  "disclaimer": "本内容依据历史佛教文献生成，仅供参考学习。如需正式修行指导，请亲近善知识。"
+  "disclaimer": "本内容依据历史佛教文献生成，仅供参考学习。如需正式修行指导，请亲近善知识。",
+  "search_scope": {
+    "primary_cbeta_ids": [
+      "X62n1182",
+      "X62n1183",
+      "X62n1184",
+      "T12n0366",
+      "T12n0365",
+      "T12n0360"
+    ],
+    "traditions": [
+      "净土"
+    ],
+    "dictionary_sources": [
+      "foguang",
+      "dingfubao"
+    ],
+    "keywords": [
+      "念佛",
+      "净土",
+      "往生",
+      "信愿行",
+      "阿弥陀",
+      "极乐"
+    ]
+  }
 }

prebuilt/zhiyi/meta.json

@@ -4,17 +4,66 @@
   "tradition": "汉传",
   "school": "天台宗",
   "era": "538-597",
-  "languages": ["zh-classical", "zh"],
+  "languages": [
+    "zh-classical",
+    "zh"
+  ],
   "fojin_entity_id": null,
   "sources": [
-    {"type": "cbeta", "id": "T46n1911", "title": "摩诃止观"},
+    {
-    {"type": "cbeta", "id": "T33n1718", "title": "妙法莲华经玄义"},
+      "type": "cbeta",
-    {"type": "cbeta", "id": "T34n1718", "title": "妙法莲华经文句"},
+      "id": "T46n1911",
-    {"type": "cbeta", "id": "T46n1915", "title": "修习止观坐禅法要"},
+      "title": "摩诃止观"
-    {"type": "cbeta", "id": "T09n0262", "title": "妙法莲华经"}
+    },
+    {
+      "type": "cbeta",
+      "id": "T33n1718",
+      "title": "妙法莲华经玄义"
+    },
+    {
+      "type": "cbeta",
+      "id": "T34n1718",
+      "title": "妙法莲华经文句"
+    },
+    {
+      "type": "cbeta",
+      "id": "T46n1915",
+      "title": "修习止观坐禅法要"
+    },
+    {
+      "type": "cbeta",
+      "id": "T09n0262",
+      "title": "妙法莲华经"
+    }
   ],
   "version": "1.0.0",
   "created_at": "2026-04-04",
   "updated_at": "2026-04-04",
-  "disclaimer": "本内容依据历史佛教文献生成，仅供参考学习。如需正式修行指导，请亲近善知识。"
+  "disclaimer": "本内容依据历史佛教文献生成，仅供参考学习。如需正式修行指导，请亲近善知识。",
+  "search_scope": {
+    "primary_cbeta_ids": [
+      "T46n1911",
+      "T33n1718",
+      "T34n1718",
+      "T46n1915",
+      "T09n0262"
+    ],
+    "traditions": [
+      "天台",
+      "法华"
+    ],
+    "dictionary_sources": [
+      "foguang",
+      "dingfubao",
+      "tiantai"
+    ],
+    "keywords": [
+      "一念三千",
+      "三谛",
+      "止观",
+      "五时八教",
+      "法华",
+      "圆融"
+    ]
+  }
 }

tools/cross_reference.py

@@ -0,0 +1,365 @@
+#!/usr/bin/env python3
+"""
+Cross-Reference — find connections between teachers using FoJin KG.
+
+Usage:
+    python3 tools/cross_reference.py lineage "印光" "蕅益"
+    python3 tools/cross_reference.py concept "空性" --teachers xuanzang,kumarajiva
+"""
+
+import argparse
+import json
+import os
+import sys
+from pathlib import Path
+from typing import Optional
+
+# Allow running from project root or tools/
+PROJECT_ROOT = Path(__file__).resolve().parent.parent
+sys.path.insert(0, str(PROJECT_ROOT / "tools"))
+
+from fojin_bridge import FojinBridge, create_bridge
+
+
+# ── Teacher registry ────────────────────────────────────────────
+
+PREBUILT_DIR = PROJECT_ROOT / "prebuilt"
+
+
+def load_teacher_meta(slug: str) -> dict:
+    """Load a teacher's meta.json by slug."""
+    meta_path = PREBUILT_DIR / slug / "meta.json"
+    if not meta_path.exists():
+        raise FileNotFoundError(f"Teacher not found: {slug}")
+    with open(meta_path, "r", encoding="utf-8") as f:
+        return json.load(f)
+
+
+def list_teachers() -> list[str]:
+    """Return all available teacher slugs."""
+    return sorted(
+        d.name for d in PREBUILT_DIR.iterdir()
+        if d.is_dir() and (d / "meta.json").exists()
+    )
+
+
+def find_teacher_by_name(name: str) -> Optional[dict]:
+    """Find a teacher by Chinese name, English name, or slug."""
+    for slug in list_teachers():
+        meta = load_teacher_meta(slug)
+        if name in (
+            meta.get("name"),
+            meta.get("name_en"),
+            meta.get("name_sa"),
+            meta.get("name_bo"),
+            meta.get("slug"),
+            slug,
+        ):
+            return meta
+    return None
+
+
+# ── Lineage subcommand ──────────────────────────────────────────
+
+def cmd_lineage(bridge: FojinBridge, person_a: str, person_b: str) -> str:
+    """
+    Search the KG for relationship paths between two people.
+
+    Returns formatted text describing the lineage connection.
+    """
+    lines: list[str] = []
+    lines.append(f"## 师承关系查询: {person_a} <-> {person_b}")
+    lines.append("")
+
+    # Search for both entities in the KG
+    result_a = bridge.search_kg_entities(person_a, entity_type="person", limit=5)
+    result_b = bridge.search_kg_entities(person_b, entity_type="person", limit=5)
+
+    entities_a = result_a.get("data", result_a.get("results", []))
+    entities_b = result_b.get("data", result_b.get("results", []))
+
+    if not entities_a:
+        lines.append(f"- 未在知识图谱中找到: {person_a}")
+    if not entities_b:
+        lines.append(f"- 未在知识图谱中找到: {person_b}")
+
+    if not entities_a or not entities_b:
+        lines.append("")
+        lines.append("### 建议")
+        lines.append("- 尝试使用不同的名称（法号、别名等）")
+        lines.append("- 查看 prebuilt/ 目录下已有的法师配置")
+        return "\n".join(lines)
+
+    entity_a = entities_a[0]
+    entity_b = entities_b[0]
+    id_a = entity_a.get("id")
+    id_b = entity_b.get("id")
+
+    lines.append(f"### {person_a}")
+    lines.append(f"- KG实体: {entity_a.get('name', person_a)} (ID: {id_a})")
+    lines.append("")
+
+    lines.append(f"### {person_b}")
+    lines.append(f"- KG实体: {entity_b.get('name', person_b)} (ID: {id_b})")
+    lines.append("")
+
+    # Fetch relationship graphs for both, looking for teacher-student predicates
+    lines.append("### 关系图谱")
+    lines.append("")
+
+    graph_a = bridge.get_kg_graph(
+        id_a, depth=3, max_nodes=100,
+        predicates="teacher_of,student_of,disciple_of,master_of"
+    )
+
+    nodes = {n["id"]: n for n in graph_a.get("nodes", [])}
+    edges = graph_a.get("edges", graph_a.get("links", []))
+
+    # Check if person_b appears in person_a's graph
+    found_connection = False
+    for node in nodes.values():
+        node_name = node.get("name", "")
+        if person_b in node_name or node.get("id") == id_b:
+            found_connection = True
+            break
+
+    if found_connection:
+        lines.append(f"在 {person_a} 的关系图谱中找到 {person_b}:")
+        lines.append("")
+        for edge in edges:
+            src = nodes.get(edge.get("source"), {}).get("name", str(edge.get("source")))
+            tgt = nodes.get(edge.get("target"), {}).get("name", str(edge.get("target")))
+            pred = edge.get("predicate", edge.get("label", "related_to"))
+            lines.append(f"  {src} --[{pred}]--> {tgt}")
+    else:
+        lines.append(f"在3层关系内未找到 {person_a} 与 {person_b} 的直接师承路径。")
+        lines.append("")
+
+        # Show each person's immediate relations for context
+        lines.append(f"#### {person_a} 的师承关系:")
+        for edge in edges[:10]:
+            src = nodes.get(edge.get("source"), {}).get("name", str(edge.get("source")))
+            tgt = nodes.get(edge.get("target"), {}).get("name", str(edge.get("target")))
+            pred = edge.get("predicate", edge.get("label", "related_to"))
+            lines.append(f"  {src} --[{pred}]--> {tgt}")
+
+        graph_b = bridge.get_kg_graph(
+            id_b, depth=2, max_nodes=50,
+            predicates="teacher_of,student_of,disciple_of,master_of"
+        )
+        nodes_b = {n["id"]: n for n in graph_b.get("nodes", [])}
+        edges_b = graph_b.get("edges", graph_b.get("links", []))
+
+        lines.append("")
+        lines.append(f"#### {person_b} 的师承关系:")
+        for edge in edges_b[:10]:
+            src = nodes_b.get(edge.get("source"), {}).get("name", str(edge.get("source")))
+            tgt = nodes_b.get(edge.get("target"), {}).get("name", str(edge.get("target")))
+            pred = edge.get("predicate", edge.get("label", "related_to"))
+            lines.append(f"  {src} --[{pred}]--> {tgt}")
+
+    # Check if both are prebuilt teachers and note shared traditions
+    lines.append("")
+    lines.append("### 传承交集分析")
+    meta_a = find_teacher_by_name(person_a)
+    meta_b = find_teacher_by_name(person_b)
+    if meta_a and meta_b:
+        scope_a = meta_a.get("search_scope", {})
+        scope_b = meta_b.get("search_scope", {})
+        shared_traditions = set(scope_a.get("traditions", [])) & set(scope_b.get("traditions", []))
+        shared_keywords = set(scope_a.get("keywords", [])) & set(scope_b.get("keywords", []))
+
+        if shared_traditions:
+            lines.append(f"- 共同传承: {', '.join(shared_traditions)}")
+        if shared_keywords:
+            lines.append(f"- 共同关键词: {', '.join(shared_keywords)}")
+        if not shared_traditions and not shared_keywords:
+            lines.append("- 两位法师属于不同传承，无直接交集")
+    else:
+        lines.append("- 部分法师不在预置列表中，无法进行本地交集分析")
+
+    return "\n".join(lines)
+
+
+# ── Concept subcommand ──────────────────────────────────────────
+
+def cmd_concept(bridge: FojinBridge, concept: str, teacher_slugs: list[str]) -> str:
+    """
+    Search the same concept across multiple teachers' primary sources.
+
+    Returns formatted text comparing how different teachers discuss the concept.
+    """
+    lines: list[str] = []
+    lines.append(f"## 跨传承概念对比: {concept}")
+    lines.append("")
+
+    # Dictionary lookup first
+    lines.append("### 辞典释义")
+    try:
+        dict_result = bridge.search_dictionary_grouped(concept)
+        entries = dict_result.get("data", dict_result.get("results", []))
+        if entries:
+            for group in entries[:3]:
+                source = group.get("source", "unknown")
+                items = group.get("entries", group.get("items", []))
+                if items:
+                    entry = items[0]
+                    term = entry.get("term", entry.get("headword", concept))
+                    definition = entry.get("definition", entry.get("content", ""))
+                    # Truncate long definitions
+                    if len(definition) > 200:
+                        definition = definition[:200] + "..."
+                    lines.append(f"- **{source}** [{term}]: {definition}")
+        else:
+            lines.append(f"- 未找到「{concept}」的辞典条目")
+    except Exception as e:
+        lines.append(f"- 辞典查询失败: {e}")
+
+    lines.append("")
+
+    # For each teacher, search their primary sources
+    for slug in teacher_slugs:
+        try:
+            meta = load_teacher_meta(slug)
+        except FileNotFoundError:
+            lines.append(f"### {slug} (未找到)")
+            lines.append(f"- 法师 '{slug}' 不在预置列表中")
+            lines.append("")
+            continue
+
+        name = meta.get("name", slug)
+        scope = meta.get("search_scope", {})
+        traditions = scope.get("traditions", [])
+
+        lines.append(f"### {name} ({', '.join(traditions)})")
+
+        # Build source filter from primary CBETA/SuttaCentral IDs
+        primary_ids = scope.get("primary_cbeta_ids", []) + scope.get("primary_suttacentral_ids", [])
+        source_filter = ",".join(primary_ids) if primary_ids else None
+
+        # Search in teacher's primary texts
+        try:
+            results = bridge.search_content(concept, sources=source_filter, size=5)
+            hits = results.get("data", results.get("results", []))
+            if hits:
+                for hit in hits[:3]:
+                    title = hit.get("title", hit.get("text_title", ""))
+                    highlight = hit.get("highlight", hit.get("snippet", ""))
+                    if isinstance(highlight, dict):
+                        highlight = highlight.get("content", [""])[0]
+                    if isinstance(highlight, list):
+                        highlight = highlight[0] if highlight else ""
+                    # Truncate
+                    if len(highlight) > 150:
+                        highlight = highlight[:150] + "..."
+                    lines.append(f"- 《{title}》: {highlight}")
+            else:
+                lines.append(f"- 在主要典籍中未搜到「{concept}」的直接引用")
+        except Exception as e:
+            lines.append(f"- 搜索失败: {e}")
+
+        # Also search dictionary with teacher-specific sources
+        dict_sources = scope.get("dictionary_sources", [])
+        if dict_sources:
+            try:
+                for ds in dict_sources[:2]:
+                    dict_res = bridge.search_dictionary(concept, source=ds, size=1)
+                    entries = dict_res.get("data", dict_res.get("results", []))
+                    if entries:
+                        entry = entries[0]
+                        definition = entry.get("definition", entry.get("content", ""))
+                        if len(definition) > 100:
+                            definition = definition[:100] + "..."
+                        lines.append(f"- [{ds}辞典]: {definition}")
+            except Exception:
+                pass  # Dictionary lookup is best-effort
+
+        lines.append("")
+
+    # Cross-tradition comparison summary
+    lines.append("### 传承视角对比")
+    tradition_map: dict[str, list[str]] = {}
+    for slug in teacher_slugs:
+        try:
+            meta = load_teacher_meta(slug)
+            scope = meta.get("search_scope", {})
+            for t in scope.get("traditions", []):
+                tradition_map.setdefault(t, []).append(meta.get("name", slug))
+        except FileNotFoundError:
+            pass
+
+    for tradition, teachers in tradition_map.items():
+        lines.append(f"- **{tradition}**: {', '.join(teachers)}")
+
+    if len(tradition_map) > 1:
+        lines.append("")
+        lines.append(
+            f"共涉及 {len(tradition_map)} 个传承，"
+            f"建议对比各传承对「{concept}」的不同诠释角度。"
+        )
+
+    return "\n".join(lines)
+
+
+# ── CLI ─────────────────────────────────────────────────────────
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Cross-reference Buddhist teachers and concepts via FoJin KG",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""Examples:
+  %(prog)s lineage "印光" "蕅益"
+  %(prog)s concept "空性" --teachers xuanzang,kumarajiva
+  %(prog)s concept "止观" --teachers zhiyi,ouyi,xuyun
+  %(prog)s list
+""",
+    )
+    sub = parser.add_subparsers(dest="command")
+
+    # lineage
+    p_lineage = sub.add_parser("lineage", help="查询两人师承关系")
+    p_lineage.add_argument("person_a", help="第一位人物名称")
+    p_lineage.add_argument("person_b", help="第二位人物名称")
+
+    # concept
+    p_concept = sub.add_parser("concept", help="跨传承概念对比")
+    p_concept.add_argument("concept", help="要比较的概念")
+    p_concept.add_argument(
+        "--teachers", "-t", required=True,
+        help="法师slug列表，逗号分隔 (如: xuanzang,kumarajiva)"
+    )
+
+    # list
+    sub.add_parser("list", help="列出所有可用法师")
+
+    args = parser.parse_args()
+
+    if args.command == "list":
+        print("Available teachers:")
+        for slug in list_teachers():
+            meta = load_teacher_meta(slug)
+            scope = meta.get("search_scope", {})
+            traditions = ", ".join(scope.get("traditions", []))
+            print(f"  {slug:16s}  {meta['name']}  ({traditions})")
+        return
+
+    if args.command is None:
+        parser.print_help()
+        return
+
+    bridge = create_bridge()
+
+    if args.command == "lineage":
+        output = cmd_lineage(bridge, args.person_a, args.person_b)
+    elif args.command == "concept":
+        teacher_slugs = [s.strip() for s in args.teachers.split(",")]
+        output = cmd_concept(bridge, args.concept, teacher_slugs)
+    else:
+        parser.print_help()
+        return
+
+    print(output)
+
+
+if __name__ == "__main__":
+    main()