justicedao/ipfs_nepal_laws_ir

Nepal legislation IR (CID-keyed sparse GraphRAG)

Research retrieval release of endomorphosis/ipfs_nepal_laws (revision 22395665af98b03f562994b5b7aca768b7e34b54) packaged as country-laws-ir-graphrag/v1 (layout family skillcenter-huggingface-release/v3 / publicus-ir).

Not legal advice. This is a research snapshot. The official gazette / authentic source of Nepal prevails over this corpus. Retrieved documents and graph edges are retrieval evidence only. No legal text was invented.

Primary key: entry_cid (CIDv1 raw sha2-256 of a canonical identity record). Integer document_index values are compact shard pointers, not identities.

Target Hub id (packaging metadata only): justicedao/ipfs_nepal_laws_ir.

Counts

Canonical fields

entry_cid, law_cid, record_type, jurisdiction, language, instrument_id, instrument_title, article_number, article_title, title, body, source_url, snapshot_date, coverage, license, collector, source_dataset, source_revision.

Unit policy: prefer article/section rows; fall back to law-level when articles.parquet is empty.

Index layout

Zstandard parquet shards with at most 4,096 rows.

• —indexes/bm25_keyword_shards.parquet — lexical term ranges → BM25 posting shards
• —indexes/vector_chunks.parquet — semantic routing centroids (rows sorted by cosine to shard centroid)
• —indexes/corpus_chunks.parquet — document ranges → corpus shards
• —data/graph/nodes / data/graph/edges — property graph
• —data/graph/adjacency/{incoming,outgoing} — score-ordered neighbor pages

BM25: Okapi k1=1.2, b=0.75, titleweight=5, bodyweight=1 (FTS5 unicode61-style tokenizer).

Graph: one node per entry_cid plus facet nodes (_facet_cid(kind, value) for jurisdiction, language, instrument, source, status). Neighbor edges BM25_NEIGHBOR_OF (k=8) carry score and matched terms. Structural edges: ARTICLE_OF (article → parent law) when articles exist, plus IDENTIFIED_BY_ELI / IDENTIFIED_BY only when those identifiers are present in the source.

Query

python scripts/query_country_laws_hf.py --local-dir . bm25 "constitution" --top-k 10
python scripts/query_country_laws_hf.py --local-dir . vector "money laundering" --top-k 10
python scripts/query_country_laws_hf.py --local-dir . graph neighbors <entry_cid>

Publish later (operator)

export HF_TOKEN=...   # never commit
hf upload-large-folder justicedao/ipfs_nepal_laws_ir . \
  --repo-type dataset --no-private --num-workers 8 \
  --exclude "**/__pycache__/**" --exclude "**/*.pyc"

Provenance

Packaged by country-laws-ir. Upstream collector and official license remain those of endomorphosis/ipfs_nepal_laws. CIDs identify local content; they do not prove public IPFS pinning.