Release 2.2.0 metadata; search syntax and filter URLs in llms.txt

.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",

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"

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

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"],

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": [
         {

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=<paragraph-id>, 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=<terms>
+- A search: https://lszoszk.github.io/generalcomments/?q=<terms> (operators and filters below).
 - Every document as a plain HTML page without JavaScript, full text with paragraph anchors: https://lszoszk.github.io/generalcomments/d/<document-id>/#p<paragraph>, 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/<symbol>.
-- 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