JLaw-CiteGraph 🇯🇵⚖️

English · 日本語 · 한국어

An open, deterministic citation graph and search index for Japanese statutory law.

Every Japanese law in force is parsed from official e-Gov XML down to article (条), paragraph (項) and item (号), and citations in the text are resolved to the provision they point at: 92.9% of same-law and 82.2% of cross-law citations, with the unresolved ones listed. The result ships as data files, a single-file explorer, a jlawcite command-line tool that looks up and searches provisions without embeddings, and an MCP server for LLMs.

_{explorer.html: pick a law and see what it cites (green) and what cites it (yellow).}

At a glance (v2.0, e-Gov snapshot 2026-09-27)

What's new in v2

v1 wrote one line per citation mention, so its 1.21M lines hold 173,844 distinct links; v2 counts each (source, target) link once. Full list in CHANGELOG.md.

Who is this for?

Quick start

git clone https://github.com/yabooung/jp-law-citation-graph && cd jp-law-citation-graph
pip install -e .                                     # Python 3.11+

jlawcite fetch                                       # e-Gov bulk XML (~320 MB) → data/raw/law_xml
jlawcite build --input data/raw/law_xml \
    --csv data/raw/law_xml/all_law_list.csv --output data/parsed      # ~5 min, deterministic
jlawcite validate --data data/parsed                 # 11 integrity checks
jlawcite index                                       # search index (~1.5 min, 2.6 GB)

jlawcite get 民法第七百九条                           # also: 労働基準法20条1項, 激甚法第三条, node ids
jlawcite search 解雇 予告                             # BM25; --nl for a question sentence
jlawcite refs 労働基準法第二十条                       # what it cites / what cites it
jlawcite pending --until 20261231                    # amendments coming into force

$ jlawcite get 民法第七百九条
民法  [129AC0000000089, act, 明治二十九年法律第八十九号]  現行 2026-06-24 施行中, 次回改正 2027-06-23
[129AC0000000089_a709] Article

第七百九条
故意又は過失によって他人の権利又は法律上保護される利益を侵害した者は、これによって生じた損害を賠償する責任を負う。

改正予定:
  2027-06-23  民法 ← 民法等の一部を改正する法律 令和八年法律第四十五号 (公布の日から起算して一年を超えない範囲内において政令で定める日)
  …

Every command takes --json. The same functions are available in Python (jlawcite.search.SearchDB).

What's inside (/data)

The full node file (1.89M nodes, article and paragraph text included) is attached to the GitHub release, or you can rebuild it with the Quick start commands.

import pandas as pd
edges = pd.read_csv("data/cites_law_to_law.csv")
hubs = edges.groupby("tgt_law")["src_law_id"].nunique().sort_values(ascending=False).head(10)

Use it from an LLM: MCP server (mcp/)

resolve_citation, what_cites, what_law_cites, citation_path, get_law, and in v2 get_provision (citation → text), search_statutes and pending_amendments. See mcp/README.md.

Retrieval benchmark

Each of 1,170 National Tax Agency Q&A cases (質疑応答事例) is a real tax question whose answer cites specific articles. The question is the query, and hits are counted at the article level (jlawcite eval).

_{1,170 queries · e-Gov snapshot 2026-09-27 · eval/v2/nta_retrieval_results.json}

The one-hop expansion adds the articles that the top hits cite. A retrieved 施行令 paragraph pulls up the parent-act article it implements. Both rows use no embeddings; they are a baseline for dense or hybrid retrievers.

Quality, honestly

• Coverage. No law is left without body text, the 11 integrity checks pass (no dangling edges), and the same input produces the same output.
• Resolution rates leave out citations whose target is not in a current-law corpus: pre-amendment text (旧法), amending acts (改正法), and citations inside amending-law 附則 blocks. These are counted separately in jp_cites_stats.json.
• Precision is preliminary. 180 random edges (10–20 per resolution rule) were checked by hand against their source text during development. Five error classes turned up and were fixed. The rules covering 86% of edges now measure ≈98%. Samples are small (10/10 still has a 72% lower bound) and were not blind, so treat it as indicative. Citations inside amending-law 附則 are about 40% right and are flagged with confidence 0.4. Citations of pre-amendment text (「旧○○法第N条」) point at the current version and carry version: "pre_amendment". Details: docs/METHODOLOGY.md.
• Scope. National statutes in force only: no case law, 通達, local ordinances, or text of repealed and amending acts. イ/ロ/ハ subitems are folded into their item.

Reproduce

jlawcite fetch --zip all_xml.zip       # re-extract an archived snapshot for an exact rebuild
jlawcite build … --as-of 20260929      # same snapshot + same as-of date → same graph
jlawcite export --out data             # regenerate the files in /data
python tools/build_explorer.py         # regenerate explorer.html
python -m pytest                       # 177 tests

Related work

• 弁護士ドットコム (DDS 2026) built a citation graph over e-Gov statutes (条・項・号) together with books, guidelines and court decisions. It reports P 98.8 / R 92.1 for law-to-law citations; same-law references are outside its evaluation, and the graph is not public. paper
• DaisukeHori/japan-law publishes about 112k article-level cross-references for about 8,000 laws (CC0), without an accuracy evaluation.
• Reference resolution in Japanese statutes goes back to Tran, Nguyen & Shimazu (ICAIL 2013). Using citation structure for statute retrieval has been shown on the Japanese Civil Code (Mizuno & Kano, COLIEE 2025; Vuong et al., Applied Intelligence 2025) and on Belgian law (Louis et al., EACL 2023).

JLaw-CiteGraph adds same-law and relative references (前条・同条・同項・前号・同法), version selection with upcoming amendments, per-rule precision, and a retrieval evaluation over the whole corpus, all as open data.

Documentation

CHANGELOG · DATA_CARD · METHODOLOGY · eval protocol · detailed Korean docs: dataset, schema & resolution rules, search, improvement handbook

Contributing

Issues and PRs are welcome: CONTRIBUTING.md. A blind annotation round (eval/) would turn the preliminary precision into a validated number, and it is the most useful single contribution.

License

Code: Apache-2.0. Data: CC BY 4.0 (source: e-Gov 法令データ; NTA 質疑応答事例 for eval/v2/nta_gold.jsonl). See DATA_LICENSE.md. This is not legal advice; check e-Gov / 官報 for legal decisions.

Citation

@misc{jlaw_citegraph_2026,
  title   = {JLaw-CiteGraph: An open citation graph of Japanese statutory law},
  version = {2.0.0},
  year    = {2026},
  note    = {e-Gov 2026-09-27 snapshot},
  url     = {https://github.com/yabooung/jp-law-citation-graph}
}