From 89fecd889494cd70460493af9bfb017bd64ee82b Mon Sep 17 00:00:00 2001 From: lszoszk Date: Thu, 15 Oct 2026 00:44:31 +0200 Subject: [PATCH] Release 2.2.0 metadata; llms.txt documents search syntax and filter URLs llms.txt now lists the query operators, the URL filter parameters with three checked example links, and the AI connection guide. Version and release date bumped to 2.2.0 / 15 October 2026 in CITATION.cff, codemeta.json, .zenodo.json, README and the JSON-LD. Co-Authored-By: Claude Opus 5.5 --- .zenodo.json | 2 +- CITATION.cff | 4 ++-- README.md | 2 +- codemeta.json | 4 ++-- docs/index.html | 6 +++--- docs/llms.txt | 28 ++++++++++++++++++++++++++-- 6 files changed, 35 insertions(+), 11 deletions(-) diff --git a/.zenodo.json b/.zenodo.json index 108a7f62..0b6e8eba 100644 --- a/.zenodo.json +++ b/.zenodo.json @@ -3,7 +3,7 @@ "upload_type": "software", "access_right": "open", "license": "PolyForm-Noncommercial-1.0.0", - "description": "Paragraph-level research environment for UN human rights law. UNHRDB combines Treaty Body General Comments and Recommendations, individual-communication jurisprudence, and thematic Special Procedures reports in a source-first interface with faceted search, citation export, document workspaces, and extractive retrieval. The software and curated datasets have separate licences; see LICENSE, LICENSE-DATA, and NOTICE in the repository. The v2.1.0 release (3 September 2026) covers 6,152 documents and 326,448 paragraphs: 188 General Comments and Recommendations, 4,333 individual-communication decisions from 8 treaty bodies, and 1,631 thematic Special Procedures reports from all 46 mandates. The repository holds the published site and its front-end code; the data-processing pipeline is kept in a separate, private repository.", + "description": "Paragraph-level research environment for UN human rights law. UNHRDB combines Treaty Body General Comments and Recommendations, individual-communication jurisprudence, and thematic Special Procedures reports in a source-first interface with faceted search, citation export, document workspaces, and extractive retrieval. The software and curated datasets have separate licences; see LICENSE, LICENSE-DATA, and NOTICE in the repository. The v2.2.0 release (15 October 2026) covers 6,152 documents and 326,448 paragraphs: 188 General Comments and Recommendations, 4,333 individual-communication decisions from 8 treaty bodies, and 1,631 thematic Special Procedures reports from all 46 mandates. The repository holds the published site and its front-end code; the data-processing pipeline is kept in a separate, private repository.", "creators": [ { "name": "Szoszkiewicz, Łukasz", diff --git a/CITATION.cff b/CITATION.cff index 71e9370e..6cfcacd1 100644 --- a/CITATION.cff +++ b/CITATION.cff @@ -36,5 +36,5 @@ license-url: "https://polyformproject.org/licenses/noncommercial/1.0.0/" repository-code: "https://github.com/lszoszk/generalcomments" url: "https://lszoszk.github.io/generalcomments/" doi: "10.5281/zenodo.10495719" -version: "2.1.0" -date-released: "2026-09-03" +version: "2.2.0" +date-released: "2026-10-15" diff --git a/README.md b/README.md index 7ffc7e48..484df7b4 100644 --- a/README.md +++ b/README.md @@ -103,7 +103,7 @@ as part of that dataset package. For the evolving software, use the concept DOI: > Szoszkiewicz, Ł., & Kowalska, Z. (2026). *UNHRDB — UN Human Rights -> Database* (Version 2.1.0) [Computer software]. Zenodo. +> Database* (Version 2.2.0) [Computer software]. Zenodo. > https://doi.org/10.5281/zenodo.10495719 GitHub also exposes machine-readable citation metadata from diff --git a/codemeta.json b/codemeta.json index afaa36c2..dfdddca0 100644 --- a/codemeta.json +++ b/codemeta.json @@ -5,8 +5,8 @@ "description": "Paragraph-level search, reading, and citation environment for UN Treaty Body General Comments, jurisprudence, and thematic Special Procedures reports.", "codeRepository": "https://github.com/lszoszk/generalcomments", "url": "https://lszoszk.github.io/generalcomments/", - "version": "2.1.0", - "datePublished": "2026-09-03", + "version": "2.2.0", + "datePublished": "2026-10-15", "license": "https://polyformproject.org/licenses/noncommercial/1.0.0/", "applicationCategory": "Legal research software", "programmingLanguage": ["JavaScript", "Python", "HTML", "CSS"], diff --git a/docs/index.html b/docs/index.html index fe4ef46d..f6cd7dfe 100644 --- a/docs/index.html +++ b/docs/index.html @@ -118,8 +118,8 @@ "https://github.com/lszoszk/generalcomments", "https://huggingface.co/datasets/lszoszk/treaty-bodies-general-comments" ], - "version": "2.1.0", - "dateModified": "2026-09-26", + "version": "2.2.0", + "dateModified": "2026-10-15", "temporalCoverage": "1960/2026", "inLanguage": "en", "isAccessibleForFree": true, @@ -128,7 +128,7 @@ { "@type": "Person", "name": "Zuzanna Kowalska" } ], "license": "https://creativecommons.org/licenses/by-nc-sa/4.0/", - "citation": "Szoszkiewicz, Ł., & Kowalska, Z. (2026). UNHRDB — UN Human Rights Database (Version 2.1.0). Zenodo. https://doi.org/10.5281/zenodo.10495719", + "citation": "Szoszkiewicz, Ł., & Kowalska, Z. (2026). UNHRDB — UN Human Rights Database (Version 2.2.0). Zenodo. https://doi.org/10.5281/zenodo.10495719", "keywords": ["human rights", "UN treaty bodies", "general comments", "general recommendations", "jurisprudence", "individual communications", "special procedures", "international law", "legal information retrieval"], "distribution": [ { diff --git a/docs/llms.txt b/docs/llms.txt index b2e80746..91f0706e 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -18,15 +18,39 @@ General Comments are authoritative interpretations of a treaty by its monitoring ## How to link and cite - A paragraph: https://lszoszk.github.io/generalcomments/?p=, e.g. https://lszoszk.github.io/generalcomments/?p=ccpr-c-gc-36-0012 (Human Rights Committee, general comment No. 36, para. 12). -- A search: https://lszoszk.github.io/generalcomments/?q= +- A search: https://lszoszk.github.io/generalcomments/?q= (operators and filters below). - Every document as a plain HTML page without JavaScript, full text with paragraph anchors: https://lszoszk.github.io/generalcomments/d//#p, e.g. https://lszoszk.github.io/generalcomments/d/ccpr-c-gc-36/#p12. Index of all documents: https://lszoszk.github.io/generalcomments/d/ - Cite the underlying UN document by its symbol and paragraph (e.g. CCPR/C/GC/36, para. 12); the official text is at https://docs.un.org/en/. -- Cite the database itself as: Szoszkiewicz, Ł., & Kowalska, Z. (2026). UNHRDB — UN Human Rights Database (Version 2.1.0). Zenodo. https://doi.org/10.5281/zenodo.10495719 +- Cite the database itself as: Szoszkiewicz, Ł., & Kowalska, Z. (2026). UNHRDB — UN Human Rights Database (Version 2.2.0). Zenodo. https://doi.org/10.5281/zenodo.10495719 + +## Search syntax and filter URLs + +Query operators (parameter q): +- "exact phrase" — the words verbatim and in order; no stemming. +- A B — whitespace is AND: both terms must appear. +- A AND B, A OR B — AND binds tighter than OR; group with ( … ). +- A NOT B, or A -B — exclude B; an exclusion needs a positive term beside it. +- prefix* — trailing asterisk matches any continuation (discriminat* finds discrimination, discriminatory). +- Bare words match the word form as typed; there is no proximity (NEAR) operator. + +Filters, each a URL parameter; several values are joined with | : +- scope — gc (General Comments, the default), jur (treaty-body decisions), sp (Special Procedures reports), all (the three together), rec (recommendations to States). +- tb — treaty body or mandate, as shown in the filter panel: CCPR, CESCR, CRC, CEDAW, CERD, CAT, CRPD, CMW, CED; Special Procedures as "SR Privacy", "SR Torture", "WG Arbitrary Detention" and so on. +- y1, y2 — first and last year. +- g — groups concerned, e.g. Children, Women/girls, Persons with disabilities, Indigenous peoples, Migrants. +- jur only: cy (State party, e.g. Algeria), oc (outcome: violation_found, merits_no_violation, inadmissible, discontinued). +- fn=1 also searches footnotes (off by default). + +Examples: +- https://lszoszk.github.io/generalcomments/?q=%22best+interests%22+-adoption&tb=CRC|CESCR&g=Children +- https://lszoszk.github.io/generalcomments/?q=%22enforced+disappearance%22&scope=jur&tb=CCPR&cy=Algeria&oc=violation_found&y1=2015 +- https://lszoszk.github.io/generalcomments/?q=biometric*+AND+(surveillance+OR+facial)&scope=sp&y1=2018 ## Using it from an AI assistant - Connector (MCP, Streamable HTTP, no key): https://150.254.115.204/unhrdb-mcp-rpc/mcp — tools search_paragraphs, lookup_by_citation, search_recommendations, lookup_recommendation, list_uhri_facets. - Claude plugin with the connector and three skills (un-human-rights-research, un-citation-check, treaty-body-case-law): https://github.com/lszoszk/mcp-unhrdb#skills-for-claude. Skills for the recommendations to States (uhri-plus, uhri-plus-country-brief, uhri-plus-legal-grounding, uhri-plus-dashboard-link): https://lszoszk.github.io/UnitedNations_recommendations/skills/README.md. In Claude Code: `/plugin marketplace add lszoszk/mcp-unhrdb`, then `/plugin install unhrdb@mcp-unhrdb`. +- Step-by-step guide to connecting Claude, ChatGPT and other assistants: https://lszoszk.github.io/UnitedNations_recommendations/ai.html - Quote the returned text verbatim and cite the UN symbol and paragraph. Searches require all bare words (use OR, "phrases" and prefix*); check that a looked-up paragraph carries the label you asked for. ## Data and tools