LibreJustice

Removed value: -"Metadata fields carry search_decisions filter tokens: each field matches the filter of the same name (jurisdictionType → jurisdiction_type, legalDomain → legal_domain…) and its value passes back verbatim to filter."

Removed value: -"Fate of THIS decision before the court that reviewed it, precomputed from caseChronology: 'INFIRMATION, Cour d'appel de Paris, 1 juillet 2025 (url)'. INFIRMATION = this decision was reversed and no longer stands; CONFIRMATION = upheld. Absent = no recourse known to the corpus, which never proves the decision is final."

Removed value: -"Prior and subsequent decisions of the same case (appeal, pourvoi, renvoi), most recent first, current decision included. The fate of a judgment reads in the solution of the decision that reviewed it (INFIRMATION = reversed, CONFIRMATION = upheld). Absent chronology never proves no recourse exists."

Removed value: -"Link nature to the step below (the attacked decision): APPEL_DE | POURVOI_CONTRE | RENVOI_APRES_CASSATION."

Removed value: -"Absent when the corpus does not hold that step: it is named by the decision that attacks it, and cannot be opened."

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "Chamber that heard the case, as \"<court>|<chamber>\", reusable verbatim as the chamber filter."
-}

Removed value: -"Institutional commentary anchored on this document: court-written analyses served inline (`body`), plus outbound links (`url`) to the rapporteur public's conclusions and to related institutional documents (reports, opinions, press releases). Context, never the ruling itself. Quote the decision text, not a commentaire, as the court's words."

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "libre",
+      "abonnes"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Removed value: -"libre | abonnes"

Removed value: -"analyse = official court-written abstract, full content in `body`. conclusions = the rapporteur public's conclusions, `url` only (copyright-protected, existence + official link). note = linked institutional document (report, avocat général's opinion, press release, doctrine note), `url` + `title` + `publisher`."

Added value: +[
+  "analyse",
+  "conclusions",
+  "note"
+]

Removed value: -"Doctrinal cross-references of the analyse (« Cf. CE, … »)."

Removed value: -"Official classification headings (analyse)."

Removed value: -"External link, to hand to the user, not openable by an MCP tool."

Removed value: -"The decision on its official publisher: legifrance.gouv.fr, courdecassation.fr, opendata.justice-administrative.fr, conseil-constitutionnel.fr, hudoc, eur-lex. Cite this when the deliverable requires the authoritative source; `url` is the LibreJustice page. Absent when the publisher exposes no per-decision permalink."

Removed value: -"Publication values carried, reusable verbatim as the publication filter."

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

Removed value: -"Number of articles the text carries. Present only on the root of a text with articles."

Removed value: -"Contents of a text root or of one of its divisions, in reading order. Each `url` goes back to get_legal_text; a `section` entry returns all its articles at once, which is the cheapest way to read a chapter. `text` is joined only within the inline reading budget."

Removed value: -"Article number, or the division title when `kind` is `section`."

Removed value: -"Institutional commentary anchored on this document: court-written analyses served inline (`body`), plus outbound links (`url`) to the rapporteur public's conclusions and to related institutional documents (reports, opinions, press releases). Context, never the ruling itself. Quote the decision text, not a commentaire, as the court's words."

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "libre",
+      "abonnes"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Removed value: -"libre | abonnes"

Removed value: -"analyse = official court-written abstract, full content in `body`. conclusions = the rapporteur public's conclusions, `url` only (copyright-protected, existence + official link). note = linked institutional document (report, avocat général's opinion, press release, doctrine note), `url` + `title` + `publisher`."

Added value: +[
+  "analyse",
+  "conclusions",
+  "note"
+]

Removed value: -"Doctrinal cross-references of the analyse (« Cf. CE, … »)."

Removed value: -"Official classification headings (analyse)."

Removed value: -"External link, to hand to the user, not openable by an MCP tool."

Removed value: -"Article key. Absent when the url addressed the root of a text: with no articles the payload is the whole text, `text` carrying its body; with articles it is the table of contents, `articles` carrying it."

Removed value: -"Articles served without their body because the text or division exceeds the inline reading budget: their `url` fetches them."

Removed value: -"Full text; cross-references to other articles render as inline markdown links (/texte/ urls, open with get_legal_text)."

Removed value: -"One flat payload for every tab: a slice is filled only when it was asked for, by a targeted `kind` or by `all`."

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "bookmarks": {
-        "items": {
-          "additionalProperties": false,
-          "description": "Decision reference for bookmarks and reading history: enough to cite it or to chain into get_decision with its `url`, without the full text.",
-          "properties": {
-            "bookmarkedAt": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null,
-              "format": "date-time"
-            },
-            "dateLecture": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null,
-              "format": "date"
-            },
-            "lastSource": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "lastViewedAt": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null,
-              "format": "date-time"
-            },
-            "solution": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "summary": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "title": {
-              "type": "string"
-            },
-            "url": {
-              "type": "string"
-            },
-            "viewCount": {
-              "anyOf": [
-                {
-                  "type": "integer"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            }
-          },
-          "required": [
-            "title",
-            "url"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "total": {
-        "type": "integer"
-      }
-    },
-    "required": [
-      "total",
-      "bookmarks"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "bookmarks": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "bookmarkedAt": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "format": "date-time"
+            },
+            "dateLecture": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "format": "date"
+            },
+            "lastSource": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "lastViewedAt": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "format": "date-time"
+            },
+            "solution": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "summary": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "title": {
+              "type": "string"
+            },
+            "url": {
+              "type": "string"
+            },
+            "viewCount": {
+              "anyOf": [
+                {
+                  "type": "integer"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            }
+          },
+          "required": [
+            "title",
+            "url"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "total": {
+        "type": "integer"
+      }
+    },
+    "required": [
+      "total",
+      "bookmarks"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "decisions": {
-        "items": {
-          "additionalProperties": false,
-          "description": "Decision reference for bookmarks and reading history: enough to cite it or to chain into get_decision with its `url`, without the full text.",
-          "properties": {
-            "bookmarkedAt": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null,
-              "format": "date-time"
-            },
-            "dateLecture": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null,
-              "format": "date"
-            },
-            "lastSource": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "lastViewedAt": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null,
-              "format": "date-time"
-            },
-            "solution": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "summary": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "title": {
-              "type": "string"
-            },
-            "url": {
-              "type": "string"
-            },
-            "viewCount": {
-              "anyOf": [
-                {
-                  "type": "integer"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            }
-          },
-          "required": [
-            "title",
-            "url"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "total": {
-        "type": "integer"
-      }
-    },
-    "required": [
-      "total",
-      "decisions"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "decisions": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "bookmarkedAt": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "format": "date-time"
+            },
+            "dateLecture": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "format": "date"
+            },
+            "lastSource": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "lastViewedAt": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "format": "date-time"
+            },
+            "solution": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "summary": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "title": {
+              "type": "string"
+            },
+            "url": {
+              "type": "string"
+            },
+            "viewCount": {
+              "anyOf": [
+                {
+                  "type": "integer"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            }
+          },
+          "required": [
+            "title",
+            "url"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "total": {
+        "type": "integer"
+      }
+    },
+    "required": [
+      "total",
+      "decisions"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Removed value: -{
-  "anyOf": [
-    {
-      "items": {
-        "maxLength": 60,
-        "type": "string"
-      },
-      "maxItems": 10,
-      "type": "array"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "Restrict to one or more chambers, as a composite key \"<court>|<chamber>\" where <court> is a jurisdiction_code (e.g. \"ca_paris|C3\", \"cc|C2\", \"cc|SOCIALE\"). The court prefix is required: a chamber key names a different chamber in each court, \"C1\" alone existing in about 200 of them. The chamber part is slots joined by a dot, in the order they render: tag P (pôle), SC (section holding chambers), C (chambre), S (section), L (lettered section), Q (sous-sections réunies) or R (chambres réunies), then its number or letter. So \"P5.C6\" is pôle 5, 6e chambre, \"C5.LA\" section A of the 5th, \"CD\" chambre D, \"R3-8\" chambres 3/8 réunies (numbers in a reunited list always ascending). A chamber that no coordinate positions is keyed by what it judges instead (\"cc|SOCIALE\", \"cc|CRIMINELLE\"). facets.chamber lists the pairs present, and only once jurisdiction_code narrows the search to one or more courts."
-}

Previous value: -"Restrict to one or more precise court units by referential code. Code shapes: \"cc\" (Cour de cassation), \"ce\" (Conseil d'État), \"cnda\", \"cedh\", \"cjue\"; \"ca_<city>\", \"caa_<city>\", \"ta_<city>\", \"tj_<city>\", \"tcom_<city>\" (e.g. \"ca_paris\", \"ta_marseille\", \"tj_paris\", \"tcom_lyon\"). When unsure, guess with the city name in the code: the error names the nearest valid ones. Each code is a court; the chamber inside it is a separate filter (see chamber); use jurisdiction_type for the broad category."New value: +"Restrict to one or more precise court units by referential code. Code shapes: \"cc\" (Cour de cassation), \"ce\" (Conseil d'État), \"cnda\", \"cedh\", \"cjue\"; \"ca_<city>\", \"caa_<city>\", \"ta_<city>\", \"tj_<city>\", \"tcom_<city>\" (e.g. \"ca_paris\", \"ta_marseille\", \"tj_paris\", \"tcom_lyon\"). When unsure, guess with the city name in the code: the error names the nearest valid ones. Each code is a court; a room inside it is reached with seat, which also expresses this filter as a path."

Previous value: -"'auto' is the right choice in almost all cases, it picks the regime from the query shape. auto: combines meaning and keyword matching on plain queries; switches to keyword-only when the query contains ET / OU / SAUF or quoted phrases. lexical: force keyword-only matching. Every term becomes required and nothing recovers a miss, so it fits a string you expect word for word (a consecrated formula, the direction of a holding, a party named in the text) and an empty answer is then an answer. Never for a docket number or a decision name, which auto resolves by exact key. semantic: force the meaning+keyword hybrid even on quoted or operator queries (where auto would fall back to keyword-only). Naming a mode, like adding ET / OU / SAUF, also keeps a docket number inside an ordinary query instead of resolving it alone."New value: +"'auto' is the right choice in almost all cases, it picks the regime from the query shape. auto: combines meaning and keyword matching on plain queries; switches to keyword-only when the query contains ET / OU / SAUF or quoted phrases. lexical: force keyword-only matching. Every term becomes required and nothing recovers a miss, so it fits a string you expect word for word (a consecrated formula, the direction of a holding, a party named in the text) and an empty answer is then an answer. semantic: force the meaning+keyword hybrid even on quoted or operator queries (where auto would fall back to keyword-only)."

Previous value: -[
-  {
-    "items": {
-      "enum": [
-        "PUBLIE_BULLETIN",
-        "PUBLIE_RAPPORT",
-        "LETTRE_CHAMBRE",
-        "COMMUNIQUE",
-        "INEDIT_BULLETIN",
-        "PUBLIE_LEBON",
-        "MENTIONNE_LEBON",
-        "INEDIT_LEBON"
-      ],
-      "type": "string"
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "enum": [
+        "PUBLIE_RAPPORT",
+        "PUBLIE_BULLETIN",
+        "LETTRE_CHAMBRE",
+        "COMMUNIQUE",
+        "INEDIT_BULLETIN",
+        "PUBLIE_LEBON",
+        "MENTIONNE_LEBON",
+        "INEDIT_LEBON"
+      ],
+      "type": "string"
+    },
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"Filter by publication, at the grain the Cour de cassation itself uses (any-of, membership is multiple: a decision matches every value whose code it carries). Judicial order: PUBLIE_BULLETIN, PUBLIE_RAPPORT (annual report, the strongest signal), LETTRE_CHAMBRE, COMMUNIQUE, INEDIT_BULLETIN. Administrative order: PUBLIE_LEBON, MENTIONNE_LEBON, INEDIT_LEBON. Lower courts carry no publication statement and match no value."New value: +"Filter by publication, at the grain the Cour de cassation itself uses (any-of, membership is multiple: a decision matches every value whose code it carries). Judicial order: PUBLIE_RAPPORT (annual report, the strongest signal), PUBLIE_BULLETIN, LETTRE_CHAMBRE, COMMUNIQUE, INEDIT_BULLETIN. Administrative order: PUBLIE_LEBON, MENTIONNE_LEBON, INEDIT_LEBON. Lower courts carry no publication statement and match no value."

Previous value: -"French query, the primary input. Two regimes, pick the right tool for the job: (a) Natural language or descriptive keywords for legal-issue searches; the engine handles synonyms and reformulations. Examples: « responsabilité hôpital infection nosocomiale » ; « étranger malade soins inaccessibles dans son pays d'origine » ; « licenciement discrimination syndicale charge de la preuve ». (b) Quoted exact phrases and ET / OU / SAUF operators for a named entity (company, municipality, person), a precise legal formula, or the direction of a holding: semantic matching ignores negations (« n'est pas X » ranks like « est X »), and only an exact phrase targets which way the court ruled. Examples: « \"Société Générale\" » ; « \"commune de Saint-Denis\" SAUF Réunion » ; « \"force majeure\" ET épidémie ». Using operators or quotes switches the engine to keyword-only matching for the whole query (no synonyms), so do not mix the two regimes: a quoted phrase followed by free words requires every one of them in the same decision. (c) A docket number or a decision name takes neither quotes nor operators: « 21PA01295 », « n° 19-20.682 », « arrêt Danthony » are matched by an exact key, whatever the spelling, and quoting them only costs the recovery that catches a miss."New value: +"French query, the primary input. Two regimes, pick the right tool for the job: (a) Natural language or descriptive keywords for legal-issue searches; the engine handles synonyms and reformulations. Examples: « responsabilité hôpital infection nosocomiale » ; « étranger malade soins inaccessibles dans son pays d'origine » ; « licenciement discrimination syndicale charge de la preuve ». (b) Quoted exact phrases and ET / OU / SAUF operators for a named entity (company, municipality, person), a precise legal formula, or the direction of a holding: semantic matching ignores negations (« n'est pas X » ranks like « est X »), and only an exact phrase targets which way the court ruled. Examples: « \"Société Générale\" » ; « \"commune de Saint-Denis\" SAUF Réunion » ; « \"force majeure\" ET épidémie ». Using operators or quotes switches the engine to keyword-only matching for the whole query (no synonyms), so do not mix the two regimes."

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "maxLength": 60,
+        "type": "string"
+      },
+      "maxItems": 10,
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Restrict to one or more seats, as a dotted path from the court type down to the room: \"CC\", \"CC.SOCIALE\", \"CA.PARIS\", \"CA.PARIS.P5.C3\". A path matches itself and everything below it, so this one filter also covers what jurisdiction_type and jurisdiction_code express. Take the paths from facets.seat."
+}

Removed value: -"Per filter name, a map of filter value to decision count under the current query (jurisdiction_type, jurisdiction_code, chamber, office, legal_domain, solution, procedure, publication, date_lecture_year, legal_instrument). Reuse keys verbatim as filter values. jurisdiction_code is capped to the top 15 courts (other_courts counts the rest) and legal_instrument to the top 10 statutes. chamber appears only under a jurisdiction_code filter, and then lists every formation of the selected courts."

Removed value: -"A filter of the call was retired and rewritten: what was asked, what was searched, and the filter to use instead. The hits answer the rewritten call."

Removed value: -"Metadata fields carry search_decisions filter tokens: each field matches the filter of the same name (jurisdictionType → jurisdiction_type, legalDomain → legal_domain…) and its value passes back verbatim to filter."

Removed value: -"AI-written summary of what the decision is about (semantic search), a machine paraphrase, NEVER the court's words: nothing in it is quotable. Exactly one of aiSummary/snippet is served per hit."

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "Chamber that heard the case, as \"<court>|<chamber>\", reusable verbatim as the chamber filter."
-}

Removed value: -"The decision on its official publisher: legifrance.gouv.fr, courdecassation.fr, opendata.justice-administrative.fr, conseil-constitutionnel.fr, hudoc, eur-lex. Cite this when the deliverable requires the authoritative source; `url` is the LibreJustice page. Absent when the publisher exposes no per-decision permalink."

Removed value: -"Publication values carried, reusable verbatim as the publication filter."

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

Removed value: -"Verbatim passage of the decision text where the query terms matched (keyword search). Exactly one of aiSummary/snippet is served per hit."

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "title": {
+        "type": "string"
+      },
+      "url": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "title",
+      "url"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Removed value: -"Decisions matched under the current filters, the whole set and not the served window: `hits` is one page of it, and `facets` counts that same set. Keyword matching is an OR bag over the query tokens, so a long query matches a large share of the corpus: narrow with filters (court, dates, chamber) rather than with more words for the number to count something."

Removed value: -"Per filter name, a map of filter value to article count under the current query (code, jurisdiction). Reuse keys verbatim as filter values. Each axis is capped to its top 10."

Previous value: -"Fate of THIS decision before the court that reviewed it, precomputed from caseChronology: 'INFIRMATION — Cour d'appel de Paris, 1 juillet 2025 (url)'. INFIRMATION = this decision was reversed and no longer stands; CONFIRMATION = upheld. Absent = no recourse known to the corpus, which never proves the decision is final."New value: +"Fate of THIS decision before the court that reviewed it, precomputed from caseChronology: 'INFIRMATION, Cour d'appel de Paris, 1 juillet 2025 (url)'. INFIRMATION = this decision was reversed and no longer stands; CONFIRMATION = upheld. Absent = no recourse known to the corpus, which never proves the decision is final."

Previous value: -"Institutional commentary anchored on this document: court-written analyses served inline (`body`), plus outbound links (`url`) to the rapporteur public's conclusions and to related institutional documents (reports, opinions, press releases). Context, never the ruling itself — quote the decision text, not a commentaire, as the court's words."New value: +"Institutional commentary anchored on this document: court-written analyses served inline (`body`), plus outbound links (`url`) to the rapporteur public's conclusions and to related institutional documents (reports, opinions, press releases). Context, never the ruling itself. Quote the decision text, not a commentaire, as the court's words."

Previous value: -"External link, to hand to the user — not openable by an MCP tool."New value: +"External link, to hand to the user, not openable by an MCP tool."

Previous value: -"Consultation date (YYYY-MM-DD) — returns the version in force at that date. Omit for the version currently in force."New value: +"Consultation date (YYYY-MM-DD): returns the version in force at that date. Omit for the version currently in force."

Previous value: -"A librejustice.fr article URL `/texte/{code}/{article}`: take it from a search_legal_texts hit or an inline citation link, or compose it — {code} is the code slug (\"code-civil\", as in facets.legal_instrument), {article} the lowercase article key (\"l761-1\" for L. 761-1, \"1240\" for 1240). `/texte/{code}` alone addresses the text itself, which is how a text with no articles (circulaire, publication decree) is read."New value: +"A librejustice.fr article URL `/texte/{code}/{article}`: take it from a search_legal_texts hit or an inline citation link, or compose it: {code} is the code slug (\"code-civil\", as in facets.legal_instrument), {article} the lowercase article key (\"l761-1\" for L. 761-1, \"1240\" for 1240). `/texte/{code}` alone addresses the text itself, which is how a text with no articles (circulaire, publication decree) is read."

Previous value: -"Institutional commentary anchored on this document: court-written analyses served inline (`body`), plus outbound links (`url`) to the rapporteur public's conclusions and to related institutional documents (reports, opinions, press releases). Context, never the ruling itself — quote the decision text, not a commentaire, as the court's words."New value: +"Institutional commentary anchored on this document: court-written analyses served inline (`body`), plus outbound links (`url`) to the rapporteur public's conclusions and to related institutional documents (reports, opinions, press releases). Context, never the ruling itself. Quote the decision text, not a commentaire, as the court's words."

Previous value: -"External link, to hand to the user — not openable by an MCP tool."New value: +"External link, to hand to the user, not openable by an MCP tool."

Previous value: -"When enabled (default), reorders results by actual relevance to the query using an LLM reranker. Keep on for agentic use — shortlist quality is significantly higher. Cost: a few seconds of extra latency. Disable only for high-rate exploratory searches where latency matters more than ranking quality."New value: +"When enabled (default), reorders results by actual relevance to the query using an LLM reranker. Keep on for agentic use, shortlist quality is significantly higher. Cost: a few seconds of extra latency. Disable only for high-rate exploratory searches where latency matters more than ranking quality."

Previous value: -"Restrict to decisions citing a specific article of a specific code, as a composite key \"<instrument>|<article>\" where <instrument> is a slug or an exact text name, resolved like legal_instrument (e.g. \"code-civil|1240\", \"code-de-justice-administrative|L761-1\"). The instrument prefix is required — the same article number exists in several codes."New value: +"Restrict to decisions citing a specific article of a specific code, as a composite key \"<instrument>|<article>\" where <instrument> is a slug or an exact text name, resolved like legal_instrument (e.g. \"code-civil|1240\", \"code-de-justice-administrative|L761-1\"). The instrument prefix is required: the same article number exists in several codes."

Previous value: -"Maximum number of results (default 10). Above 20 the window is clamped, not refused."New value: +"Maximum number of results (default 10)."

Previous value: -"'auto' is the right choice in almost all cases — it picks the regime from the query shape. auto: combines meaning and keyword matching on plain queries; switches to keyword-only when the query contains ET / OU / SAUF or quoted phrases. lexical: force keyword-only matching. Every term becomes required and nothing recovers a miss, so it fits a string you expect word for word (a consecrated formula, the direction of a holding, a party named in the text) and an empty answer is then an answer. Never for a docket number or a decision name, which auto resolves by exact key. semantic: force the meaning+keyword hybrid even on quoted or operator queries (where auto would fall back to keyword-only). Naming a mode, like adding ET / OU / SAUF, also keeps a docket number inside an ordinary query instead of resolving it alone."New value: +"'auto' is the right choice in almost all cases, it picks the regime from the query shape. auto: combines meaning and keyword matching on plain queries; switches to keyword-only when the query contains ET / OU / SAUF or quoted phrases. lexical: force keyword-only matching. Every term becomes required and nothing recovers a miss, so it fits a string you expect word for word (a consecrated formula, the direction of a holding, a party named in the text) and an empty answer is then an answer. Never for a docket number or a decision name, which auto resolves by exact key. semantic: force the meaning+keyword hybrid even on quoted or operator queries (where auto would fall back to keyword-only). Naming a mode, like adding ET / OU / SAUF, also keeps a docket number inside an ordinary query instead of resolving it alone."

Previous value: -"French query, the primary input. Two regimes — pick the right tool for the job: (a) Natural language or descriptive keywords for legal-issue searches; the engine handles synonyms and reformulations. Examples: « responsabilité hôpital infection nosocomiale » ; « étranger malade soins inaccessibles dans son pays d'origine » ; « licenciement discrimination syndicale charge de la preuve ». (b) Quoted exact phrases and ET / OU / SAUF operators for a named entity (company, municipality, person), a precise legal formula, or the direction of a holding: semantic matching ignores negations (« n'est pas X » ranks like « est X »), and only an exact phrase targets which way the court ruled. Examples: « \"Société Générale\" » ; « \"commune de Saint-Denis\" SAUF Réunion » ; « \"force majeure\" ET épidémie ». Using operators or quotes switches the engine to keyword-only matching for the whole query (no synonyms), so do not mix the two regimes: a quoted phrase followed by free words requires every one of them in the same decision. (c) A docket number or a decision name takes neither quotes nor operators: « 21PA01295 », « n° 19-20.682 », « arrêt Danthony » are matched by an exact key, whatever the spelling, and quoting them only costs the recovery that catches a miss."New value: +"French query, the primary input. Two regimes, pick the right tool for the job: (a) Natural language or descriptive keywords for legal-issue searches; the engine handles synonyms and reformulations. Examples: « responsabilité hôpital infection nosocomiale » ; « étranger malade soins inaccessibles dans son pays d'origine » ; « licenciement discrimination syndicale charge de la preuve ». (b) Quoted exact phrases and ET / OU / SAUF operators for a named entity (company, municipality, person), a precise legal formula, or the direction of a holding: semantic matching ignores negations (« n'est pas X » ranks like « est X »), and only an exact phrase targets which way the court ruled. Examples: « \"Société Générale\" » ; « \"commune de Saint-Denis\" SAUF Réunion » ; « \"force majeure\" ET épidémie ». Using operators or quotes switches the engine to keyword-only matching for the whole query (no synonyms), so do not mix the two regimes: a quoted phrase followed by free words requires every one of them in the same decision. (c) A docket number or a decision name takes neither quotes nor operators: « 21PA01295 », « n° 19-20.682 », « arrêt Danthony » are matched by an exact key, whatever the spelling, and quoting them only costs the recovery that catches a miss."

Previous value: -"AI-written summary of what the decision is about (semantic search) — a machine paraphrase, NEVER the court's words: nothing in it is quotable. Exactly one of aiSummary/snippet is served per hit."New value: +"AI-written summary of what the decision is about (semantic search), a machine paraphrase, NEVER the court's words: nothing in it is quotable. Exactly one of aiSummary/snippet is served per hit."

Previous value: -"Consultation date (YYYY-MM-DD) — searches the versions valid at that date (point-in-time, same semantics as get_legal_text). Omit to search the versions currently in force."New value: +"Consultation date (YYYY-MM-DD): searches the versions valid at that date (point-in-time, same semantics as get_legal_text). Omit to search the versions currently in force."

Previous value: -"Maximum number of results (default 10). Above 20 the window is clamped, not refused."New value: +"Maximum number of results (default 10)."

Previous value: -"Linked prior and subsequent decisions of the same case (appeal, pourvoi, renvoi), most recent first, current decision included. The fate of a judgment reads in the solution of the decision that reviewed it (INFIRMATION = reversed, CONFIRMATION = upheld). Absent chronology never proves no recourse exists."New value: +"Prior and subsequent decisions of the same case (appeal, pourvoi, renvoi), most recent first, current decision included. The fate of a judgment reads in the solution of the decision that reviewed it (INFIRMATION = reversed, CONFIRMATION = upheld). Absent chronology never proves no recourse exists."

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Added value: +null

Added value: +"Absent when the corpus does not hold that step: it is named by the decision that attacks it, and cannot be opened."

Removed value: -"string"

Previous value: -[
-  "title",
-  "url",
-  "current"
-]New value: +[
+  "title",
+  "current"
+]

Previous value: -"Restrict to one or more chambers, as a composite key \"<court>|<chamber>\" where <court> is a jurisdiction_code (e.g. \"ca_paris|C3\", \"cc|C2\", \"cc|SOCIALE\"). The court prefix is required: a chamber key names a different chamber in each court, \"C1\" alone existing in about 200 of them. The chamber part reads as slots joined by a dot, in the order they render: \"P5\" (pôle 5), \"SC4\" (4e section, which contains chambers), \"C6\" (6e chambre), \"CD\" (chambre D), \"C4-7\" (chambre 4-7), \"S1\" (1re section), \"LB\" (section B), \"Q1-4\" (sous-sections 1/4 réunies), \"R3-8\" (chambres 3/8 réunies), numbers in a reunited list always ascending. So \"P5.C6\" is pôle 5, 6e chambre and \"C5.LA\" is section A of the 5th. A chamber that no coordinate positions is named by what it judges, and the key is that bare name, as at the Cour de cassation whose social and criminal chambers carry no number (\"cc|SOCIALE\", \"cc|CRIMINELLE\"). facets.chamber lists the pairs present in the current result set, and only once jurisdiction_code narrows it to one or more courts: a chamber key is meaningless outside its court, so search for the court first and read its formations from the answer."New value: +"Restrict to one or more chambers, as a composite key \"<court>|<chamber>\" where <court> is a jurisdiction_code (e.g. \"ca_paris|C3\", \"cc|C2\", \"cc|SOCIALE\"). The court prefix is required: a chamber key names a different chamber in each court, \"C1\" alone existing in about 200 of them. The chamber part is slots joined by a dot, in the order they render: tag P (pôle), SC (section holding chambers), C (chambre), S (section), L (lettered section), Q (sous-sections réunies) or R (chambres réunies), then its number or letter. So \"P5.C6\" is pôle 5, 6e chambre, \"C5.LA\" section A of the 5th, \"CD\" chambre D, \"R3-8\" chambres 3/8 réunies (numbers in a reunited list always ascending). A chamber that no coordinate positions is keyed by what it judges instead (\"cc|SOCIALE\", \"cc|CRIMINELLE\"). facets.chamber lists the pairs present, and only once jurisdiction_code narrows the search to one or more courts."

Previous value: -"How many results to come back with. Keep the default of 10: the reranker has already put the best first, and each extra hit spends caller context on a preview that must not be quoted. Above 20 the window is clamped to 20, not refused."New value: +"Maximum number of results (default 10). Above 20 the window is clamped, not refused."

Previous value: -"'auto' is the right choice in almost all cases — it picks the regime from the query shape. auto: combines meaning and keyword matching on plain queries; switches to keyword-only when the query contains ET / OU / SAUF or quoted phrases. lexical: force keyword-only matching. Every term becomes required and nothing recovers a miss, so it fits a string you expect word for word (a consecrated formula, the direction of a holding, a party named in the text) and an empty answer is then an answer. Never for a docket number or a decision name, which auto resolves by exact key. semantic: force the meaning+keyword hybrid even on quoted or operator queries (where auto would fall back to keyword-only)."New value: +"'auto' is the right choice in almost all cases — it picks the regime from the query shape. auto: combines meaning and keyword matching on plain queries; switches to keyword-only when the query contains ET / OU / SAUF or quoted phrases. lexical: force keyword-only matching. Every term becomes required and nothing recovers a miss, so it fits a string you expect word for word (a consecrated formula, the direction of a holding, a party named in the text) and an empty answer is then an answer. Never for a docket number or a decision name, which auto resolves by exact key. semantic: force the meaning+keyword hybrid even on quoted or operator queries (where auto would fall back to keyword-only). Naming a mode, like adding ET / OU / SAUF, also keeps a docket number inside an ordinary query instead of resolving it alone."

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "Docket number asked for and not found: the hits below carry another number. Absent from the corpus when absentScope is null, absent from that scope only otherwise."
-}

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "Court and year the call pinned around absentReference, when no decision carrying that number satisfies them: the number exists elsewhere in the corpus. Drop or widen that filter to reach it."
-}

Previous value: -"Per filter name, a map of filter value to decision count under the current query (jurisdiction_type, jurisdiction_code, chamber, office, legal_domain, solution, procedure, publication, date_lecture_year, legal_instrument). Reuse keys verbatim as filter values. jurisdiction_code is capped to the top 15 courts (other_courts counts the rest) and legal_instrument to the top 10 statutes. chamber appears only under a jurisdiction_code filter, and then lists every formation of the selected courts: search once for the court, once more for the chamber."New value: +"Per filter name, a map of filter value to decision count under the current query (jurisdiction_type, jurisdiction_code, chamber, office, legal_domain, solution, procedure, publication, date_lecture_year, legal_instrument). Reuse keys verbatim as filter values. jurisdiction_code is capped to the top 15 courts (other_courts counts the rest) and legal_instrument to the top 10 statutes. chamber appears only under a jurisdiction_code filter, and then lists every formation of the selected courts."

Previous value: -"How many results to come back with. Keep the default of 10: the reranker has already put the best first, and each extra hit spends caller context on a preview that must not be quoted. Above 20 the window is clamped to 20, not refused."New value: +"Maximum number of results (default 10). Above 20 the window is clamped, not refused."

Previous value: -"Sortie unique de ``list_my_activity`` : chaque tranche n'est remplie que\nsi elle a été demandée (``kind`` ciblé ou ``all``). Un seul modèle à plat\n(plutôt qu'une union par ``kind``) évite une enveloppe ``result``. Noter\nqu'après inlining des ``$ref`` par ``_clean_schema`` (cf. mcp_server),\n``McpDecisionRef`` apparaît deux fois dans le schéma émis — une fois sous\n``bookmarks``, une fois sous ``readingHistory``."New value: +"One flat payload for every tab: a slice is filled only when it was asked for, by a targeted `kind` or by `all`."

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "bookmarks": {
-        "items": {
-          "additionalProperties": false,
-          "description": "Référence décision pour signets/consultations : assez pour citer ou\nchaîner vers ``get_decision`` via ``url``, sans le texte intégral.",
-          "properties": {
-            "bookmarkedAt": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null,
-              "format": "date-time"
-            },
-            "dateLecture": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null,
-              "format": "date"
-            },
-            "lastSource": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "lastViewedAt": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null,
-              "format": "date-time"
-            },
-            "solution": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "summary": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "title": {
-              "type": "string"
-            },
-            "url": {
-              "type": "string"
-            },
-            "viewCount": {
-              "anyOf": [
-                {
-                  "type": "integer"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            }
-          },
-          "required": [
-            "title",
-            "url"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "total": {
-        "type": "integer"
-      }
-    },
-    "required": [
-      "total",
-      "bookmarks"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "bookmarks": {
+        "items": {
+          "additionalProperties": false,
+          "description": "Decision reference for bookmarks and reading history: enough to cite it or to chain into get_decision with its `url`, without the full text.",
+          "properties": {
+            "bookmarkedAt": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "format": "date-time"
+            },
+            "dateLecture": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "format": "date"
+            },
+            "lastSource": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "lastViewedAt": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "format": "date-time"
+            },
+            "solution": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "summary": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "title": {
+              "type": "string"
+            },
+            "url": {
+              "type": "string"
+            },
+            "viewCount": {
+              "anyOf": [
+                {
+                  "type": "integer"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            }
+          },
+          "required": [
+            "title",
+            "url"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "total": {
+        "type": "integer"
+      }
+    },
+    "required": [
+      "total",
+      "bookmarks"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "decisions": {
-        "items": {
-          "additionalProperties": false,
-          "description": "Référence décision pour signets/consultations : assez pour citer ou\nchaîner vers ``get_decision`` via ``url``, sans le texte intégral.",
-          "properties": {
-            "bookmarkedAt": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null,
-              "format": "date-time"
-            },
-            "dateLecture": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null,
-              "format": "date"
-            },
-            "lastSource": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "lastViewedAt": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null,
-              "format": "date-time"
-            },
-            "solution": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "summary": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "title": {
-              "type": "string"
-            },
-            "url": {
-              "type": "string"
-            },
-            "viewCount": {
-              "anyOf": [
-                {
-                  "type": "integer"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            }
-          },
-          "required": [
-            "title",
-            "url"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "total": {
-        "type": "integer"
-      }
-    },
-    "required": [
-      "total",
-      "decisions"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "decisions": {
+        "items": {
+          "additionalProperties": false,
+          "description": "Decision reference for bookmarks and reading history: enough to cite it or to chain into get_decision with its `url`, without the full text.",
+          "properties": {
+            "bookmarkedAt": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "format": "date-time"
+            },
+            "dateLecture": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "format": "date"
+            },
+            "lastSource": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "lastViewedAt": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "format": "date-time"
+            },
+            "solution": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "summary": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "title": {
+              "type": "string"
+            },
+            "url": {
+              "type": "string"
+            },
+            "viewCount": {
+              "anyOf": [
+                {
+                  "type": "integer"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            }
+          },
+          "required": [
+            "title",
+            "url"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "total": {
+        "type": "integer"
+      }
+    },
+    "required": [
+      "total",
+      "decisions"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"Restrict to one or more chambers, as a composite key \"<court>|<chamber>\" where <court> is a jurisdiction_code (e.g. \"ca_paris|CH:3\", \"cc|CH:2\", \"cc|MAT:SOCIALE\"). The court prefix is required: a chamber key names a different chamber in each court, \"CH:1\" alone existing in about 200 of them. The chamber part is what names the chamber inside its own court: its position in the organisation chart when it has one, \"CH:2\" (2e chambre), \"CH:5.A\" (section A of the 5th), \"P:1-11\" (pôle 1, 11e chambre), \"CHC:4-7\" (chambre 4-7), \"S:8\" (8e section), \"SS:3\" (3e sous-section), \"SSR:1-4\" and \"CHR:3-8\" (reunited, numbers always ascending); its specialisation otherwise, prefixed \"MAT:\", as at the Cour de cassation whose social and criminal chambers carry no number (\"cc|MAT:SOCIALE\", \"cc|MAT:CRIMINELLE\"). facets.chamber lists the pairs present in the current result set."New value: +"Restrict to one or more chambers, as a composite key \"<court>|<chamber>\" where <court> is a jurisdiction_code (e.g. \"ca_paris|C3\", \"cc|C2\", \"cc|SOCIALE\"). The court prefix is required: a chamber key names a different chamber in each court, \"C1\" alone existing in about 200 of them. The chamber part reads as slots joined by a dot, in the order they render: \"P5\" (pôle 5), \"SC4\" (4e section, which contains chambers), \"C6\" (6e chambre), \"CD\" (chambre D), \"C4-7\" (chambre 4-7), \"S1\" (1re section), \"LB\" (section B), \"Q1-4\" (sous-sections 1/4 réunies), \"R3-8\" (chambres 3/8 réunies), numbers in a reunited list always ascending. So \"P5.C6\" is pôle 5, 6e chambre and \"C5.LA\" is section A of the 5th. A chamber that no coordinate positions is named by what it judges, and the key is that bare name, as at the Cour de cassation whose social and criminal chambers carry no number (\"cc|SOCIALE\", \"cc|CRIMINELLE\"). facets.chamber lists the pairs present in the current result set, and only once jurisdiction_code narrows it to one or more courts: a chamber key is meaningless outside its court, so search for the court first and read its formations from the answer."

Previous value: -"Maximum number of results (1–20, default 10)."New value: +"How many results to come back with. Keep the default of 10: the reranker has already put the best first, and each extra hit spends caller context on a preview that must not be quoted. Above 20 the window is clamped to 20, not refused."

Previous value: -"Per filter name, a map of filter value to decision count under the current query (jurisdiction_type, jurisdiction_code, chamber, office, legal_domain, solution, procedure, publication, date_lecture_year, legal_instrument). Reuse keys verbatim as filter values. jurisdiction_code is capped to the top 15 courts (other_courts counts the rest), chamber to the top 15 chambers (other_chambers), legal_instrument to the top 10 statutes."New value: +"Per filter name, a map of filter value to decision count under the current query (jurisdiction_type, jurisdiction_code, chamber, office, legal_domain, solution, procedure, publication, date_lecture_year, legal_instrument). Reuse keys verbatim as filter values. jurisdiction_code is capped to the top 15 courts (other_courts counts the rest) and legal_instrument to the top 10 statutes. chamber appears only under a jurisdiction_code filter, and then lists every formation of the selected courts: search once for the court, once more for the chamber."

Previous value: -"Maximum number of results (1–20, default 10)."New value: +"How many results to come back with. Keep the default of 10: the reranker has already put the best first, and each extra hit spends caller context on a preview that must not be quoted. Above 20 the window is clamped to 20, not refused."

Previous value: -"'auto' is the right choice in almost all cases — it picks the regime from the query shape. auto: combines meaning and keyword matching on plain queries; switches to keyword-only when the query contains ET / OU / SAUF or quoted phrases. lexical: force keyword-only matching. The right choice when searching for a named entity (company, municipality, person), a precise legal formula, or an exact quote — cuts semantic noise. semantic: force the meaning+keyword hybrid even on quoted or operator queries (where auto would fall back to keyword-only)."New value: +"'auto' is the right choice in almost all cases — it picks the regime from the query shape. auto: combines meaning and keyword matching on plain queries; switches to keyword-only when the query contains ET / OU / SAUF or quoted phrases. lexical: force keyword-only matching. Every term becomes required and nothing recovers a miss, so it fits a string you expect word for word (a consecrated formula, the direction of a holding, a party named in the text) and an empty answer is then an answer. Never for a docket number or a decision name, which auto resolves by exact key. semantic: force the meaning+keyword hybrid even on quoted or operator queries (where auto would fall back to keyword-only)."

Previous value: -"French query, the primary input. Two regimes — pick the right tool for the job: (a) Natural language or descriptive keywords for legal-issue searches; the engine handles synonyms and reformulations. Examples: « responsabilité hôpital infection nosocomiale » ; « étranger malade soins inaccessibles dans son pays d'origine » ; « licenciement discrimination syndicale charge de la preuve ». (b) Quoted exact phrases and ET / OU / SAUF operators for a named entity (company, municipality, person), a precise legal formula, or the direction of a holding: semantic matching ignores negations (« n'est pas X » ranks like « est X »), and only an exact phrase targets which way the court ruled. Examples: « \"Société Générale\" » ; « \"commune de Saint-Denis\" SAUF Réunion » ; « \"force majeure\" ET épidémie ». Using operators or quotes switches the engine to keyword-only matching for the whole query (no synonyms), so do not mix the two regimes."New value: +"French query, the primary input. Two regimes — pick the right tool for the job: (a) Natural language or descriptive keywords for legal-issue searches; the engine handles synonyms and reformulations. Examples: « responsabilité hôpital infection nosocomiale » ; « étranger malade soins inaccessibles dans son pays d'origine » ; « licenciement discrimination syndicale charge de la preuve ». (b) Quoted exact phrases and ET / OU / SAUF operators for a named entity (company, municipality, person), a precise legal formula, or the direction of a holding: semantic matching ignores negations (« n'est pas X » ranks like « est X »), and only an exact phrase targets which way the court ruled. Examples: « \"Société Générale\" » ; « \"commune de Saint-Denis\" SAUF Réunion » ; « \"force majeure\" ET épidémie ». Using operators or quotes switches the engine to keyword-only matching for the whole query (no synonyms), so do not mix the two regimes: a quoted phrase followed by free words requires every one of them in the same decision. (c) A docket number or a decision name takes neither quotes nor operators: « 21PA01295 », « n° 19-20.682 », « arrêt Danthony » are matched by an exact key, whatever the spelling, and quoting them only costs the recovery that catches a miss."

Previous value: -"Docket number asked for and absent from the corpus: the hits below carry another number."New value: +"Docket number asked for and not found: the hits below carry another number. Absent from the corpus when absentScope is null, absent from that scope only otherwise."

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Court and year the call pinned around absentReference, when no decision carrying that number satisfies them: the number exists elsewhere in the corpus. Drop or widen that filter to reach it."
+}

Added value: +{
+  "description": "Decisions matched under the current filters, the whole set and not the served window: `hits` is one page of it, and `facets` counts that same set. Keyword matching is an OR bag over the query tokens, so a long query matches a large share of the corpus: narrow with filters (court, dates, chamber) rather than with more words for the number to count something.",
+  "type": "integer"
+}

Previous value: -[
-  "query",
-  "hits"
-]New value: +[
+  "query",
+  "total",
+  "hits"
+]

Added value: +{
+  "description": "Number of articles the text carries. Present only on the root of a text with articles.",
+  "type": "integer"
+}

Added value: +{
+  "description": "Contents of a text root or of one of its divisions, in reading order. Each `url` goes back to get_legal_text; a `section` entry returns all its articles at once, which is the cheapest way to read a chapter. `text` is joined only within the inline reading budget.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "kind": {
+        "enum": [
+          "article",
+          "section"
+        ],
+        "type": "string"
+      },
+      "num": {
+        "description": "Article number, or the division title when `kind` is `section`.",
+        "type": "string"
+      },
+      "section": {
+        "type": "string"
+      },
+      "text": {
+        "type": "string"
+      },
+      "url": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "num",
+      "url"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Previous value: -"Article key. Absent when the url addressed a text with no articles: the payload is then the whole text, `text` carrying its body and `versions` empty."New value: +"Article key. Absent when the url addressed the root of a text: with no articles the payload is the whole text, `text` carrying its body; with articles it is the table of contents, `articles` carrying it."

Added value: +{
+  "description": "Articles served without their body because the text or division exceeds the inline reading budget: their `url` fetches them.",
+  "type": "integer"
+}

Previous value: -[
-  {
-    "items": {
-      "enum": [
-        "JLD",
-        "JAF",
-        "JCP",
-        "JEX",
-        "JUGE_ENFANTS",
-        "PREMIER_PRESIDENT",
-        "MAGISTRAT_DESIGNE"
-      ],
-      "type": "string"
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "enum": [
+        "JLD",
+        "JAF",
+        "JCP",
+        "JEX",
+        "JUGE_ENFANTS",
+        "PREMIER_PRESIDENT",
+        "MAGISTRAT_DESIGNE",
+        "PRESIDENT_SECTION_CONTENTIEUX",
+        "JUGE_EXPROPRIATION"
+      ],
+      "type": "string"
+    },
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null
-}

Previous value: -"Restrict to one or more precise court units by referential code. Code shapes: \"cc\" (Cour de cassation), \"ce\" (Conseil d'État), \"cnda\", \"cedh\", \"cjue\"; \"ca_<city>\", \"caa_<city>\", \"ta_<city>\", \"tj_<city>\", \"tcom_<city>\" (e.g. \"ca_paris\", \"ta_marseille\", \"tj_paris\", \"tcom_lyon\"). When unsure, guess with the city name in the code: the error names the nearest valid ones. Each code is a court; the chamber inside it is a separate filter (see chamber and matiere); use jurisdiction_type for the broad category."New value: +"Restrict to one or more precise court units by referential code. Code shapes: \"cc\" (Cour de cassation), \"ce\" (Conseil d'État), \"cnda\", \"cedh\", \"cjue\"; \"ca_<city>\", \"caa_<city>\", \"ta_<city>\", \"tj_<city>\", \"tcom_<city>\" (e.g. \"ca_paris\", \"ta_marseille\", \"tj_paris\", \"tcom_lyon\"). When unsure, guess with the city name in the code: the error names the nearest valid ones. Each code is a court; the chamber inside it is a separate filter (see chamber); use jurisdiction_type for the broad category."

Removed value: -{
-  "anyOf": [
-    {
-      "items": {
-        "enum": [
-          "BAUX",
-          "CIVI",
-          "CIVILE",
-          "COMMERCIALE",
-          "CONSEIL",
-          "CONSTRUCTION",
-          "COPROPRIETE",
-          "CORRECTIONNELLE",
-          "CRIMINELLE",
-          "DALO",
-          "ETRANGERS",
-          "EXPROPRIATION",
-          "FAMILLE",
-          "INSTRUCTION",
-          "MINEURS",
-          "NATIONALITE",
-          "PROCEDURES_COLLECTIVES",
-          "PROTECTION_SOCIALE",
-          "PROXIMITE",
-          "PRUD_HOMALE",
-          "SOCIALE",
-          "SURENDETTEMENT",
-          "TERRES",
-          "URGENCES"
-        ],
-        "type": "string"
-      },
-      "maxItems": 10,
-      "type": "array"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "Filter by subject matter (any-of, uniform across orders): the contentieux the case belongs to, read off the chamber that heard it, independent of the court itself. Pairs with office for the single-judge formations. Where a court names its chambers instead of numbering them, this says the same thing as chamber does (\"cc|MAT:SOCIALE\"), matiere being the one that crosses courts. A general matiere covers its specialities: \"CIVILE\" also returns BAUX, COPROPRIETE and FAMILLE, while a speciality returns itself alone."
-}

Previous value: -"Per filter name, a map of filter value to decision count under the current query (jurisdiction_type, jurisdiction_code, matiere, chamber, office, legal_domain, solution, procedure, publication, date_lecture_year, legal_instrument). Reuse keys verbatim as filter values. jurisdiction_code is capped to the top 15 courts (other_courts counts the rest), chamber to the top 15 chambers (other_chambers), legal_instrument to the top 10 statutes."New value: +"Per filter name, a map of filter value to decision count under the current query (jurisdiction_type, jurisdiction_code, chamber, office, legal_domain, solution, procedure, publication, date_lecture_year, legal_instrument). Reuse keys verbatim as filter values. jurisdiction_code is capped to the top 15 courts (other_courts counts the rest), chamber to the top 15 chambers (other_chambers), legal_instrument to the top 10 statutes."

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "A filter of the call was retired and rewritten: what was asked, what was searched, and the filter to use instead. The hits answer the rewritten call."
+}

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null
-}

Previous value: -"Filter by subject matter (any-of, uniform across orders): the contentieux the case belongs to, read off the chamber that heard it, independent of the court itself. Pairs with office for the single-judge formations. Where a court names its chambers instead of numbering them, this says the same thing as chamber does (\"cc|MAT:SOCIALE\"), matiere being the one that crosses courts."New value: +"Filter by subject matter (any-of, uniform across orders): the contentieux the case belongs to, read off the chamber that heard it, independent of the court itself. Pairs with office for the single-judge formations. Where a court names its chambers instead of numbering them, this says the same thing as chamber does (\"cc|MAT:SOCIALE\"), matiere being the one that crosses courts. A general matiere covers its specialities: \"CIVILE\" also returns BAUX, COPROPRIETE and FAMILLE, while a speciality returns itself alone."

Previous value: -"Per filter name, a map of filter value to decision count under the current query (jurisdiction_type, jurisdiction_code, matiere, chamber, office, legal_domain, solution, publication, date_lecture_year, legal_instrument). Reuse keys verbatim as filter values. jurisdiction_code is capped to the top 15 courts (other_courts counts the rest), chamber to the top 15 chambers (other_chambers), legal_instrument to the top 10 statutes."New value: +"Per filter name, a map of filter value to decision count under the current query (jurisdiction_type, jurisdiction_code, matiere, chamber, office, legal_domain, solution, procedure, publication, date_lecture_year, legal_instrument). Reuse keys verbatim as filter values. jurisdiction_code is capped to the top 15 courts (other_courts counts the rest), chamber to the top 15 chambers (other_chambers), legal_instrument to the top 10 statutes."

Previous value: -"Bench that heard the case, as \"<court>|<bench>\", reusable verbatim as the chamber filter."New value: +"Chamber that heard the case, as \"<court>|<chamber>\", reusable verbatim as the chamber filter."

Previous value: -"Restrict to one or more benches, as a composite key \"<court>|<bench>\" where <court> is a jurisdiction_code (e.g. \"ca_paris|CH:3\", \"cc|CH:2\"). The court prefix is required: a bench key names a different bench in each court, \"CH:1\" alone existing in about 200 of them. The bench part is a position in the court's own organisation chart, not a subject (that is matiere): \"CH:2\" (2e chambre), \"CH:5.A\" (section A of the 5th), \"P:1-11\" (pôle 1, 11e chambre), \"CHC:4-7\" (chambre 4-7), \"S:8\" (8e section), \"SS:3\" (3e sous-section), \"SSR:1-4\" and \"CHR:3-8\" (reunited, numbers always ascending). facets.chamber lists the pairs present in the current result set."New value: +"Restrict to one or more chambers, as a composite key \"<court>|<chamber>\" where <court> is a jurisdiction_code (e.g. \"ca_paris|CH:3\", \"cc|CH:2\", \"cc|MAT:SOCIALE\"). The court prefix is required: a chamber key names a different chamber in each court, \"CH:1\" alone existing in about 200 of them. The chamber part is what names the chamber inside its own court: its position in the organisation chart when it has one, \"CH:2\" (2e chambre), \"CH:5.A\" (section A of the 5th), \"P:1-11\" (pôle 1, 11e chambre), \"CHC:4-7\" (chambre 4-7), \"S:8\" (8e section), \"SS:3\" (3e sous-section), \"SSR:1-4\" and \"CHR:3-8\" (reunited, numbers always ascending); its specialisation otherwise, prefixed \"MAT:\", as at the Cour de cassation whose social and criminal chambers carry no number (\"cc|MAT:SOCIALE\", \"cc|MAT:CRIMINELLE\"). facets.chamber lists the pairs present in the current result set."

Previous value: -"Restrict to one or more precise court units by referential code. Code shapes: \"cc\" (Cour de cassation), \"ce\" (Conseil d'État), \"cnda\", \"cedh\", \"cjue\"; \"ca_<city>\", \"caa_<city>\", \"ta_<city>\", \"tj_<city>\", \"tcom_<city>\" (e.g. \"ca_paris\", \"ta_marseille\", \"tj_paris\", \"tcom_lyon\"). When unsure, guess with the city name in the code: the error names the nearest valid ones. Each code is a court; the bench is a separate axis (see chamber and matiere); use jurisdiction_type for the broad category."New value: +"Restrict to one or more precise court units by referential code. Code shapes: \"cc\" (Cour de cassation), \"ce\" (Conseil d'État), \"cnda\", \"cedh\", \"cjue\"; \"ca_<city>\", \"caa_<city>\", \"ta_<city>\", \"tj_<city>\", \"tcom_<city>\" (e.g. \"ca_paris\", \"ta_marseille\", \"tj_paris\", \"tcom_lyon\"). When unsure, guess with the city name in the code: the error names the nearest valid ones. Each code is a court; the chamber inside it is a separate filter (see chamber and matiere); use jurisdiction_type for the broad category."

Previous value: -"Filter by subject matter (any-of, uniform across orders): the contentieux the case belongs to, read off the bench that heard it, independent of the court itself. Pairs with office for the single-judge benches, and with chamber for the bench itself."New value: +"Filter by subject matter (any-of, uniform across orders): the contentieux the case belongs to, read off the chamber that heard it, independent of the court itself. Pairs with office for the single-judge formations. Where a court names its chambers instead of numbering them, this says the same thing as chamber does (\"cc|MAT:SOCIALE\"), matiere being the one that crosses courts."

Previous value: -"Per filter name, a map of filter value to decision count under the current query (jurisdiction_type, jurisdiction_code, matiere, chamber, office, legal_domain, solution, publication, date_lecture_year, legal_instrument). Reuse keys verbatim as filter values. jurisdiction_code is capped to the top 15 courts (other_courts counts the rest), chamber to the top 15 benches (other_benches), legal_instrument to the top 10 statutes."New value: +"Per filter name, a map of filter value to decision count under the current query (jurisdiction_type, jurisdiction_code, matiere, chamber, office, legal_domain, solution, publication, date_lecture_year, legal_instrument). Reuse keys verbatim as filter values. jurisdiction_code is capped to the top 15 courts (other_courts counts the rest), chamber to the top 15 chambers (other_chambers), legal_instrument to the top 10 statutes."

Previous value: -"Bench that heard the case, as \"<court>|<bench>\", reusable verbatim as the chamber filter."New value: +"Chamber that heard the case, as \"<court>|<chamber>\", reusable verbatim as the chamber filter."

Previous value: -"Factual bench key, reusable verbatim as the chamber filter."New value: +"Bench that heard the case, as \"<court>|<bench>\", reusable verbatim as the chamber filter."

Previous value: -[
-  {
-    "items": {
-      "maxLength": 20,
-      "type": "string"
-    },
-    "maxItems": 10,
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "maxLength": 60,
+      "type": "string"
+    },
+    "maxItems": 10,
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"Restrict to one or more benches by their factual key: the position in the court's own organisation chart, not a subject (that is matiere). Key shapes: \"CH:2\" (2e chambre), \"CH:5.A\" (section A of the 5th), \"P:1-11\" (pôle 1, 11e chambre), \"CHC:4-7\" (chambre 4-7), \"S:8\" (8e section), \"SS:3\" (3e sous-section), \"SSR:1-4\" and \"CHR:3-8\" (reunited, numbers always ascending). The same key means a different bench in each court, so pair it with jurisdiction_code; facets.chamber lists the keys present in the current result set with their labels."New value: +"Restrict to one or more benches, as a composite key \"<court>|<bench>\" where <court> is a jurisdiction_code (e.g. \"ca_paris|CH:3\", \"cc|CH:2\"). The court prefix is required: a bench key names a different bench in each court, \"CH:1\" alone existing in about 200 of them. The bench part is a position in the court's own organisation chart, not a subject (that is matiere): \"CH:2\" (2e chambre), \"CH:5.A\" (section A of the 5th), \"P:1-11\" (pôle 1, 11e chambre), \"CHC:4-7\" (chambre 4-7), \"S:8\" (8e section), \"SS:3\" (3e sous-section), \"SSR:1-4\" and \"CHR:3-8\" (reunited, numbers always ascending). facets.chamber lists the pairs present in the current result set."

Previous value: -"Per filter name, a map of filter value to decision count under the current query (jurisdiction_type, jurisdiction_code, matiere, chamber, office, legal_domain, solution, publication, date_lecture_year, legal_instrument). Reuse keys verbatim as filter values. jurisdiction_code is capped to the top 15 courts (other_courts counts the rest), legal_instrument to the top 10 statutes."New value: +"Per filter name, a map of filter value to decision count under the current query (jurisdiction_type, jurisdiction_code, matiere, chamber, office, legal_domain, solution, publication, date_lecture_year, legal_instrument). Reuse keys verbatim as filter values. jurisdiction_code is capped to the top 15 courts (other_courts counts the rest), chamber to the top 15 benches (other_benches), legal_instrument to the top 10 statutes."

Previous value: -"Factual bench key, reusable verbatim as the chamber filter."New value: +"Bench that heard the case, as \"<court>|<bench>\", reusable verbatim as the chamber filter."

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Factual bench key, reusable verbatim as the chamber filter."
+}

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

Removed value: -null

Added value: +"Publication values carried, reusable verbatim as the publication filter."

Added value: +{
+  "type": "string"
+}

Added value: +"array"

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Docket number asked for and absent from the corpus: the hits below carry another number."
+}

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

Removed value: -null

Added value: +"Publication values carried, reusable verbatim as the publication filter."

Added value: +{
+  "type": "string"
+}

Added value: +"array"

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null
-}

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

Previous value: -[
-  {
-    "items": {
-      "enum": [
-        "BAUX",
-        "CIVI",
-        "CIVILE",
-        "COMMERCIALE",
-        "CONSEIL",
-        "CONSTRUCTION",
-        "COPROPRIETE",
-        "CORRECTIONNELLE",
-        "CRIMINELLE",
-        "DALO",
-        "ETRANGERS",
-        "EXPROPRIATION",
-        "FAMILLE",
-        "INSTRUCTION",
-        "MINEURS",
-        "NATIONALITE",
-        "PROCEDURES_COLLECTIVES",
-        "PROTECTION_SOCIALE",
-        "PROXIMITE",
-        "PRUD_HOMALE",
-        "SOCIALE",
-        "SURENDETTEMENT",
-        "TERRES",
-        "URGENCES"
-      ],
-      "type": "string"
-    },
-    "maxItems": 10,
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "maxLength": 20,
+      "type": "string"
+    },
+    "maxItems": 10,
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"Filter by chamber category (any-of, uniform across orders): the specialised bench that heard the case, independent of the court itself. Pairs with office for the single-judge benches."New value: +"Restrict to one or more benches by their factual key: the position in the court's own organisation chart, not a subject (that is matiere). Key shapes: \"CH:2\" (2e chambre), \"CH:5.A\" (section A of the 5th), \"P:1-11\" (pôle 1, 11e chambre), \"CHC:4-7\" (chambre 4-7), \"S:8\" (8e section), \"SS:3\" (3e sous-section), \"SSR:1-4\" and \"CHR:3-8\" (reunited, numbers always ascending). The same key means a different bench in each court, so pair it with jurisdiction_code; facets.chamber lists the keys present in the current result set with their labels."

Previous value: -"Restrict to one or more precise court units by referential code. Code shapes: \"cc\" (Cour de cassation), \"ce\" (Conseil d'État), \"cnda\", \"cedh\", \"cjue\"; \"ca_<city>\", \"caa_<city>\", \"ta_<city>\", \"tj_<city>\", \"tcom_<city>\" (e.g. \"ca_paris\", \"ta_marseille\", \"tj_paris\", \"tcom_lyon\"). When unsure, guess with the city name in the code — the error names the nearest valid ones. Each code is a court; the chamber is a separate axis (see chamber); use jurisdiction_type for the broad category."New value: +"Restrict to one or more precise court units by referential code. Code shapes: \"cc\" (Cour de cassation), \"ce\" (Conseil d'État), \"cnda\", \"cedh\", \"cjue\"; \"ca_<city>\", \"caa_<city>\", \"ta_<city>\", \"tj_<city>\", \"tcom_<city>\" (e.g. \"ca_paris\", \"ta_marseille\", \"tj_paris\", \"tcom_lyon\"). When unsure, guess with the city name in the code: the error names the nearest valid ones. Each code is a court; the bench is a separate axis (see chamber and matiere); use jurisdiction_type for the broad category."

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "enum": [
+          "BAUX",
+          "CIVI",
+          "CIVILE",
+          "COMMERCIALE",
+          "CONSEIL",
+          "CONSTRUCTION",
+          "COPROPRIETE",
+          "CORRECTIONNELLE",
+          "CRIMINELLE",
+          "DALO",
+          "ETRANGERS",
+          "EXPROPRIATION",
+          "FAMILLE",
+          "INSTRUCTION",
+          "MINEURS",
+          "NATIONALITE",
+          "PROCEDURES_COLLECTIVES",
+          "PROTECTION_SOCIALE",
+          "PROXIMITE",
+          "PRUD_HOMALE",
+          "SOCIALE",
+          "SURENDETTEMENT",
+          "TERRES",
+          "URGENCES"
+        ],
+        "type": "string"
+      },
+      "maxItems": 10,
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Filter by subject matter (any-of, uniform across orders): the contentieux the case belongs to, read off the bench that heard it, independent of the court itself. Pairs with office for the single-judge benches, and with chamber for the bench itself."
+}

Previous value: -"Per filter name, a map of filter value to decision count under the current query (jurisdiction_type, jurisdiction_code, chamber, office, legal_domain, solution, publication, date_lecture_year, legal_instrument). Reuse keys verbatim as filter values. jurisdiction_code is capped to the top 15 courts (other_courts counts the rest), legal_instrument to the top 10 statutes."New value: +"Per filter name, a map of filter value to decision count under the current query (jurisdiction_type, jurisdiction_code, matiere, chamber, office, legal_domain, solution, publication, date_lecture_year, legal_instrument). Reuse keys verbatim as filter values. jurisdiction_code is capped to the top 15 courts (other_courts counts the rest), legal_instrument to the top 10 statutes."

Added value: +"Factual bench key, reusable verbatim as the chamber filter."

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "The decision on its official publisher: legifrance.gouv.fr, courdecassation.fr, opendata.justice-administrative.fr, conseil-constitutionnel.fr, hudoc, eur-lex. Cite this when the deliverable requires the authoritative source; `url` is the LibreJustice page. Absent when the publisher exposes no per-decision permalink."
+}

Previous value: -[
-  {
-    "items": {
-      "maxLength": 40,
-      "type": "string"
-    },
-    "maxItems": 10,
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "enum": [
+        "BAUX",
+        "CIVI",
+        "CIVILE",
+        "COMMERCIALE",
+        "CONSEIL",
+        "CONSTRUCTION",
+        "COPROPRIETE",
+        "CORRECTIONNELLE",
+        "CRIMINELLE",
+        "DALO",
+        "ETRANGERS",
+        "EXPROPRIATION",
+        "FAMILLE",
+        "INSTRUCTION",
+        "MINEURS",
+        "NATIONALITE",
+        "PROCEDURES_COLLECTIVES",
+        "PROTECTION_SOCIALE",
+        "PROXIMITE",
+        "PRUD_HOMALE",
+        "SOCIALE",
+        "SURENDETTEMENT",
+        "TERRES",
+        "URGENCES"
+      ],
+      "type": "string"
+    },
+    "maxItems": 10,
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"Filter by chamber category (any-of, uniform across orders, e.g. \"CIVILE\", \"SOCIALE\", \"COMMERCIALE\", \"PROCEDURES_COLLECTIVES\", \"ETRANGERS\", \"PROTECTION_SOCIALE\", \"INSTRUCTION\"). Codes come from the chamber facet of a previous search."New value: +"Filter by chamber category (any-of, uniform across orders): the specialised bench that heard the case, independent of the court itself. Pairs with office for the single-judge benches."

Previous value: -[
-  {
-    "items": {
-      "enum": [
-        "PUBLIE_BULLETIN",
-        "INEDIT_BULLETIN",
-        "PUBLIE_LEBON",
-        "MENTIONNE_LEBON",
-        "INEDIT_LEBON",
-        "AUTRE"
-      ],
-      "type": "string"
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "enum": [
+        "PUBLIE_BULLETIN",
+        "PUBLIE_RAPPORT",
+        "LETTRE_CHAMBRE",
+        "COMMUNIQUE",
+        "INEDIT_BULLETIN",
+        "PUBLIE_LEBON",
+        "MENTIONNE_LEBON",
+        "INEDIT_LEBON"
+      ],
+      "type": "string"
+    },
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"Filter by publication level (any-of, référentiel publication): PUBLIE_BULLETIN / INEDIT_BULLETIN (Cour de cassation), PUBLIE_LEBON / MENTIONNE_LEBON / INEDIT_LEBON (administrative), AUTRE (no publication statement in the source)."New value: +"Filter by publication, at the grain the Cour de cassation itself uses (any-of, membership is multiple: a decision matches every value whose code it carries). Judicial order: PUBLIE_BULLETIN, PUBLIE_RAPPORT (annual report, the strongest signal), LETTRE_CHAMBRE, COMMUNIQUE, INEDIT_BULLETIN. Administrative order: PUBLIE_LEBON, MENTIONNE_LEBON, INEDIT_LEBON. Lower courts carry no publication statement and match no value."

Removed value: -{
-  "anyOf": [
-    {
-      "items": {
-        "enum": [
-          "MAJEURE",
-          "IMPORTANTE",
-          "LIMITEE",
-          "INDETERMINEE"
-        ],
-        "type": "string"
-      },
-      "type": "array"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "Filter by jurisprudential significance (any-of), derived from publication codes at strongest rank: MAJEURE (rapport annuel / recueil Lebon), IMPORTANTE (bulletin, tables du Lebon, lettres de chambre, communiqués), LIMITEE (unpublished), INDETERMINEE (no publication statement — lower courts, European courts)."
-}

Previous value: -"Per filter name, a map of filter value to decision count under the current query (jurisdiction_type, jurisdiction_code, chamber, office, legal_domain, solution, significance, publication, date_lecture_year, legal_instrument). Reuse keys verbatim as filter values. jurisdiction_code is capped to the top 15 courts (other_courts counts the rest), legal_instrument to the top 10 statutes."New value: +"Per filter name, a map of filter value to decision count under the current query (jurisdiction_type, jurisdiction_code, chamber, office, legal_domain, solution, publication, date_lecture_year, legal_instrument). Reuse keys verbatim as filter values. jurisdiction_code is capped to the top 15 courts (other_courts counts the rest), legal_instrument to the top 10 statutes."

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "The decision on its official publisher: legifrance.gouv.fr, courdecassation.fr, opendata.justice-administrative.fr, conseil-constitutionnel.fr, hudoc, eur-lex. Cite this when the deliverable requires the authoritative source; `url` is the LibreJustice page. Absent when the publisher exposes no per-decision permalink."
+}

Removed value: -[
-  {
-    "required": [
-      "url"
-    ]
-  },
-  {
-    "required": [
-      "code"
-    ]
-  },
-  {
-    "required": [
-      "textId"
-    ]
-  }
-]

Added value: +[
+  {
+    "required": [
+      "url"
+    ]
+  },
+  {
+    "required": [
+      "code"
+    ]
+  },
+  {
+    "required": [
+      "textId"
+    ]
+  }
+]

Added value: +{
+  "description": "Lowercase article key, alongside `code` (\"l761-1\" for L. 761-1, \"1240\" for 1240).",
+  "type": "string"
+}

Added value: +{
+  "description": "Code slug, when you hold the code and the article apart rather than as a url (\"code-civil\"). Alone, addresses the text itself.",
+  "type": "string"
+}

Added value: +{
+  "description": "Légifrance article id (LEGIARTI…), resolved to the article it designates. LEGITEXT and CID are not accepted.",
+  "type": "string"
+}

Previous value: -"A librejustice.fr article URL `/texte/{code}/{article}`: take it from a search_legal_texts hit or an inline citation link, or compose it — {code} is the code slug (\"code-civil\", as in facets.legal_instrument), {article} the lowercase article key (\"l761-1\" for L. 761-1, \"1240\" for 1240). Never a Légifrance id — LEGIARTI/LEGITEXT/CID are not accepted."New value: +"A librejustice.fr article URL `/texte/{code}/{article}`: take it from a search_legal_texts hit or an inline citation link, or compose it — {code} is the code slug (\"code-civil\", as in facets.legal_instrument), {article} the lowercase article key (\"l761-1\" for L. 761-1, \"1240\" for 1240). `/texte/{code}` alone addresses the text itself, which is how a text with no articles (circulaire, publication decree) is read."

Removed value: -[
-  "url"
-]

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Added value: +null

Removed value: -"string"

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Added value: +null

Removed value: -"string"

Added value: +"Article key. Absent when the url addressed a text with no articles: the payload is then the whole text, `text` carrying its body and `versions` empty."

Previous value: -[
-  "code",
-  "num",
-  "title",
-  "url",
-  "etat",
-  "dateDebut",
-  "versions"
-]New value: +[
+  "code",
+  "title",
+  "url",
+  "versions"
+]

Previous value: -"French query over statutory articles. Matches article titles (boosted) and bodies; alias expansion handles acronyms and usual names."New value: +"French query over legal articles. Matches article titles (boosted) and bodies; alias expansion handles acronyms and usual names."

Previous value: -"When enabled (default), reorders results by actual relevance to the query using an LLM reranker (cf. ADR 0041). Keep on for agentic use — shortlist quality is significantly higher. Cost: a few seconds of extra latency. Disable only for high-rate exploratory searches where latency matters more than ranking quality."New value: +"When enabled (default), reorders results by actual relevance to the query using an LLM reranker. Keep on for agentic use — shortlist quality is significantly higher. Cost: a few seconds of extra latency. Disable only for high-rate exploratory searches where latency matters more than ranking quality."

Previous value: -"Filter by legal domain (curated domain tree, ADR 0146): 9 roots and their leaves (e.g. CIVIL_DROIT_LOCATIF). Selecting a root also matches all its leaves."New value: +"Filter by legal domain (curated domain tree): 9 roots and their leaves (e.g. CIVIL_DROIT_LOCATIF). Selecting a root also matches all its leaves."

Previous value: -"Filter by jurisprudential significance (any-of, ADR 0167), derived from publication codes at strongest rank: MAJEURE (rapport annuel / recueil Lebon), IMPORTANTE (bulletin, tables du Lebon, lettres de chambre, communiqués), LIMITEE (unpublished), INDETERMINEE (no publication statement — lower courts, European courts)."New value: +"Filter by jurisprudential significance (any-of), derived from publication codes at strongest rank: MAJEURE (rapport annuel / recueil Lebon), IMPORTANTE (bulletin, tables du Lebon, lettres de chambre, communiqués), LIMITEE (unpublished), INDETERMINEE (no publication statement — lower courts, European courts)."

Previous value: -"Filter by the ruling of the operative part (référentiel solution, ADR 0146). REJET / IRRECEVABILITE / DESISTEMENT / NON_LIEU_A_STATUER are procedural or negative endings; CONFIRMATION / INFIRMATION* / REFORMATION are appeal outcomes; CASSATION* is cassation-specific; ANNULATION covers administrative annulment; SATISFACTION_TOTALE / SATISFACTION_PARTIELLE cover first-instance civil rulings granting the claim."New value: +"Filter by the ruling of the operative part (référentiel solution). REJET / IRRECEVABILITE / DESISTEMENT / NON_LIEU_A_STATUER are procedural or negative endings; CONFIRMATION / INFIRMATION* / REFORMATION are appeal outcomes; CASSATION* is cassation-specific; ANNULATION covers administrative annulment; SATISFACTION_TOTALE / SATISFACTION_PARTIELLE cover first-instance civil rulings granting the claim."