Dura Lex Wiki - Recent changes [en]

Main Page

Nicolas — Thu, 23 Apr 2026 02:24:03 GMT

Fix navigation links: point to actual pages instead of categories (via update-page on MediaWiki MCP Server)

← Older revision		Revision as of 02:24, 23 April 2026
Line 19:		Line 19:
	\| [[Architecture]] \|\| How the pieces fit together — kernel, drivers, pipeline, services		\| [[Architecture]] \|\| How the pieces fit together — kernel, drivers, pipeline, services
	\|-		\|-
	\| [[~~:Category:Corpus\|~~Corpus]] \|\| The data model — schema, tags, edges, quality, temporal versioning, FTS		\| [[Corpus]] \|\| The data model — schema, tags, edges, quality, temporal versioning, FTS
	\|-		\|-
	\| [[Sources]] \|\| Data dictionary — one page per ingest source, coverage matrix		\| [[Sources]] \|\| Data dictionary — one page per ingest source, coverage matrix
	\|-		\|-
	\| [[~~:Category:Jurisdictions\|~~Jurisdictions]] \|\| Legal systems we cover and how they map to the unified schema		\| [[Jurisdictions]] \|\| Legal systems we cover and how they map to the unified schema
	\|-		\|-
	\| [[~~:Category:MCP\|~~MCP]] \|\| The public API — tools, safety guidelines, reference resolution		\| [[MCP]] \|\| The public API — tools, safety guidelines, reference resolution
	\|-		\|-
	\| [[~~:Category:Development\|~~Development]] \|\| For contributors — coding conventions, testing, packaging		\| [[Development]] \|\| For contributors — coding conventions, testing, packaging
	\|-		\|-
	\| [[:Category:Design decisions\|Design decisions]] \|\| Architectural decision records		\| [[:Category:Design decisions\|Design decisions]] \|\| Architectural decision records (coming soon)
	\|}		\|}

Architecture

Nicolas — Thu, 23 Apr 2026 02:18:20 GMT

Architecture page — from spec/ARCHITECTURE.md, full faithful conversion (via create-page on MediaWiki MCP Server)

New page

== What Dura Lex is ==

An open-source platform for international legal data. MIT license, ODbL data.

Structures public legal data (legislation, case law, company registries, administrative guidance) into a jurisdiction-agnostic corpus, queryable by AI agents via MCP and by humans via a web portal.

== OS metaphor ==

{| class="wikitable"
|-
! OS concept !! Dura Lex equivalent
|-
| Kernel || duralex — protocols, data models, unified schema
|-
| Drivers || Country packages (duralex-fr, duralex-eu, future duralex-gb, duralex-de)
|-
| File system || Document IDs, jurisdiction-scoped URIs
|-
| System calls || search(), get(), browse(), guidelines(), quality_check()
|-
| Package manager || Compiled SQLite packages for the knowledge graph
|-
| Applications || duralex-mcp (MCP server), duralex-portal (web), duralex-graph (future)
|}

== Package overview (8 packages, 6 repos) ==

{| class="wikitable"
|-
! Package !! Repo !! Role !! Depends on
|-
| duralex || duralex/ || Core protocols, data models, temporal, corpus schema, DocumentStore, SearchEngine, FTS. Specs + docs. || nothing
|-
| duralex-fr || duralex-jurisdictions/ || French jurisdiction plugin: tag schema, formatters, reference resolver, synonym thesaurus. || duralex
|-
| duralex-eu || duralex-jurisdictions/ || EU jurisdiction plugin: EUR-Lex, CJEU, ECHR references. || duralex
|-
| duralex-ingest || duralex-ingest/ || Schema DDL, universal BatchWriter, state management, HTML sanitizer. || duralex
|-
| duralex-ingest-fr || duralex-ingest/ || French parsers: DILA, Judilibre, BODACC, RNE, BOFiP, CADA, CE, CNIL. || duralex, ingest, fr
|-
| duralex-ingest-eu || duralex-ingest/ || EU parsers: EUR-Lex (Cellar), CJEU, ECHR. || duralex, ingest
|-
| duralex-mcp || duralex-mcp/ || MCP server: 5 tools (search, get, browse, guidelines, quality_check). Plugin discovery. Docker infra. || duralex, fr/eu
|-
| duralex-portal || duralex-portal/ || Web portal for human consultation of the corpus. || duralex
|}

Future: duralex-graph (knowledge graph compiler, separate repo).

== Dependency graph ==

<pre>
duralex no dependencies
|
+----> duralex-fr depends on: duralex
+----> duralex-eu depends on: duralex
|
+----> duralex-ingest depends on: duralex
| |
| +----> duralex-ingest-fr depends on: duralex, ingest, fr
| +----> duralex-ingest-eu depends on: duralex, ingest
|
+----> duralex-mcp depends on: duralex, fr, eu (via plugin discovery)
+----> duralex-portal depends on: duralex
+----> duralex-graph depends on: duralex (future)
</pre>

== Two PostgreSQL schemas ==

<pre>
corpus.* -- source documents, citations, tag stats, source metadata
graph.* -- concepts, annotations, compiled edges, compilation metadata (future)
</pre>

Separate schemas in the same database. Different lifecycle:

* '''corpus''': source data, precious (days to re-ingest), stable after ingestion.
* '''graph''': compiled knowledge, reproducible (hours to recompile), write-heavy during compilation.

Benefits: separate VACUUM/ANALYZE, separate backup strategies, <code>DROP SCHEMA graph CASCADE</code> to recompile without touching corpus.

== Core composition pattern ==

Three levels:

# '''Core protocol''' (duralex): defines WHAT can be done (DocumentStore protocol, SearchEngine protocol).
# '''Country implementation''' (duralex-fr): implements HOW for a specific jurisdiction (formatters, reference resolvers, tag schemas).
# '''Application''' (duralex-mcp): composes protocols + implementations at startup.

'''Reference resolution''' uses <code>TagQuery</code> as the universal interface between jurisdiction parsers and the store. This is a core architectural decision — all reference resolution across all jurisdictions flows through TagQuery. There are no typed reference classes per jurisdiction.

* Core defines: <code>TagQuery</code> dataclass (<code>language</code>, <code>kind</code>, <code>tag_filters: TagFilterSet</code>, <code>should_sort_in_force_first</code>, <code>at_date</code>) and <code>TagFilterSet</code> (immutable tuple of <code>TagFilter</code> predicates with operators EQ/IN/NOT_IN/ILIKE/EXISTS/NOT_EXISTS/NORMALIZE). See [[MCP/Reference resolution]].
* Jurisdiction plugin (e.g., duralex-fr): parses "article 1240 du code civil" into <code>TagQuery(language="fr", kind="legislation", tag_filters=TagFilterSet.from_tags({"article_number": "1240", "code": "Code civil"}))</code>.
* Store: translates <code>TagQuery</code> to SQL via the shared <code>build_tag_filter_conditions</code> builder (generic, zero jurisdiction knowledge).

== MCP tools: 5 ==

search, get, browse, guidelines, quality_check. Each tool is jurisdiction-agnostic. The jurisdiction plugins provide tag schemas, formatters, and reference resolvers — not tools.

== Language boundary ==

* '''Code''' (protocols, classes, functions, variables, docstrings): English.
* '''Content''' (concept names, article text, court names, legal vocabulary): jurisdiction language.

MCP/Guidelines/EU

Nicolas — Thu, 23 Apr 2026 02:17:22 GMT

Create MCP/Guidelines/EU page from jurisdiction.md (European law) (via create-page on MediaWiki MCP Server)

New page

= Jurisdiction: European law =

Supplements core safety guidelines with rules specific to European law (<code>tags={"jurisdiction": "eu"}</code>).

⚠️ '''Current limitation''': only <code>language="fr"</code> ingested. <code>language="en"</code> → 0 results. Always pass <code>language="fr"</code> for EU searches. Multi-language planned (F-5).

<code>tags["jurisdiction"]</code> is REQUIRED on every search and browse_structure call. Use <code>"eu"</code> for European law only, <code>"eu|fr"</code> for combined (recommended for EU member state queries), or <code>"*"</code> for all jurisdictions.

----

== Which tool for which question ==

* '''EU regulations & directives''': search(tags={"jurisdiction": "eu", "kind": "legislation", "nature": "REGLEMENT"}) or <code>"nature": "DIRECTIVE"</code>
* '''CJEU case law''': search(tags={"jurisdiction": "eu", "kind": "decision", "court": "cjeu"}) for Court of Justice; <code>"court": "general_court"</code> for General Court
* '''ECHR case law''': search(tags={"jurisdiction": "eu", "kind": "decision", "court": "echr"})
* '''Direct CELEX lookup''': get_document("32016R0679") — resolves to <code>EU.EURLEXTEXT32016R0679</code>
* '''Transposition into FR''': search(query="transposition directive 2016/680", tags={"jurisdiction": "fr", "kind": "legislation"}) or check edges on the directive via get_document
* '''AG opinions''': search(tags={"jurisdiction": "eu", "kind": "decision", "type": "advisory_opinion"}) ⚠️ not yet ingested — returns 0 results currently.

When in doubt: <code>"jurisdiction": "eu|fr"</code> to combine FR and EU sources.

----

== Search — EU legal terminology ==

* "responsabilité" / "liability" / "responsibility" — texts may be in multiple languages
* "données personnelles" / "personal data" / "personenbezogene Daten"
* "concurrence" / "competition" / "antitrust"
* "marché intérieur" / "internal market" / "single market"
* Multi-word concepts MUST use quotes: <code>"libre circulation des travailleurs"</code>, <code>"abus de position dominante"</code>

EU texts exist in 24 official languages. The corpus may contain multiple language versions of the same text — they are equivalent in legal value (TFEU art. 55).

'''Multilingual ingestion''': each language version is a separate row with a <code>:lang</code> suffix in the
document ID (e.g. <code>EU.EURLEXTEXT32016R0679:fr</code> and <code>EU.EURLEXTEXT32016R0679:en</code> for the French
and English versions of the GDPR). The cross-language identifier <code>tags.text_id</code> is unsuffixed
(<code>EU.EURLEXTEXT32016R0679</code>), so resolver lookups by <code>text_id</code> find all language versions; the
<code>language</code> parameter you pass to the tools narrows results to the user's language. Documents
ingested in a fallback language (e.g. EN-only when no FR is available) carry
<code>tags.translation_pending="fr"</code> and may receive a machine translation later.

----

== Courts ==

=== court_level mapping (T1 tag) ===

* <code>supranational</code> — cjeu (Court of Justice), echr
* <code>first_instance</code> — general_court (General Court), civil_service_tribunal (dissolved 2016)

=== CJEU (Court of Justice of the EU) ===

* '''Court of Justice''' ("Cour de justice"): highest EU court, preliminary rulings, appeals
* '''General Court''' ("Tribunal"): direct actions, competition, state aid, trademarks

Formation solemnity (ascending): single_judge < reduced_bench (3 judges) < standard_bench (5 judges) < grand_bench (15 judges) < full_court (all judges).

Publication grades: <code>ecr_grand_chamber</code> (Court Reports, Grand Chamber, highest_importance) > <code>ecr_chamber</code> (Court Reports, Chamber, high_importance) > <code>oj_only</code> (OJ series C only, low_importance) > <code>unpublished</code> (minimal_importance).

Procedure types: preliminary ruling ("renvoi préjudiciel", art. 267 TFEU), annulment (art. 263 TFEU), infringement (art. 258-260 TFEU), opinion (art. 218 TFEU).

=== ECHR (European Court of Human Rights) ===

* Covers 46 Council of Europe member states
* Application numbers: 5+ digits / 2 digits (e.g., 36022/97)

Importance grades:
* official_grade 1 = Key case (Reports of Judgments and Decisions) — highest_importance
* official_grade 2 = High importance — high_importance
* official_grade 3 = Medium importance — medium_importance
* official_grade 4 = Low importance — low_importance

Formations: "Grande chambre" (grand_bench) > Section/Chamber (standard_bench) > "Comité" (reduced_bench) > Single Judge (single_judge).

----

== Legislation ==

=== Hierarchy ===

Treaties (TEU, TFEU, Charter of Fundamental Rights) > Regulations (directly applicable) > Directives (require national transposition) > Decisions.

=== Key distinctions ===

* '''Regulation''' ("règlement"): directly applicable in all member states. No transposition. Direct effect.
* '''Directive''': binds member states as to the result. Requires national transposition within deadline. After deadline → vertical direct effect (vs State) but NOT horizontal (between private parties).
* '''Decision''': binding on its addressees only.
* '''CELEX number''': official identifier, format <code>3{year}{type}{number}</code> (e.g., 32016R0679 = Regulation 2016/679 = GDPR).

=== Enforcement status ===

Tag: <code>enforcement_status</code> (canonical international values, see TAG-CONVENTIONS.md)
EU EUR-Lex emits only:
* <code>in_force</code> = in force
* <code>repealed</code> = repealed → NEVER cite as current

----

== Charter of Fundamental Rights ==

Treaty-level value since Lisbon (2009). Binds EU institutions + member states implementing EU law.

Key articles:
* Art. 7 — private and family life
* Art. 8 — protection of personal data
* Art. 21 — non-discrimination
* Art. 47 — right to effective remedy and fair trial

----

== Direct effect and primacy ==

* Regulations: full direct effect (vertical + horizontal).
* Directives: vertical direct effect (vs State) after transposition deadline. NOT horizontal (between private parties).
* EU primacy over all national law (Costa v ENEL, 1964).
* France: "contrôle de conventionnalité" by ordinary courts (art. 55 Constitution). Constitutional Council does conventionality control via QPC since 2010.

----

== ECHR margin of appreciation ==

ECHR grants states a "margin of appreciation" on sensitive topics (morals, religion, national security, family policy). Same legal question → different outcomes in different national contexts.

⚠️ A ruling against Italy ≠ automatically applies to France. Different national context, different margin.
Always check for rulings against the specific state involved (search tags={"jurisdiction": "eu", "source": "echr", "respondent_state": "FRA"} — values are 3-letter ISO country codes).

----

== Transposition ==

Finding the FR transposition of an EU directive:
# get_document() the directive, check <code>edges</code> for explicit transposition links
# search(query="transposition directive YYYY/NN", tags={"jurisdiction": "fr", "kind": "legislation"})
# Look for the FR "loi de transposition" or "ordonnance de transposition"

⚠️ EUR-Lex national transposition measures may be incomplete or outdated — verify in FR sources.

----

== CJEU preliminary rulings (art. 267 TFEU) ==

Mechanism: a national court asks the CJEU to interpret EU law. The CJEU answers; the national court applies the answer to the case.

⚠️ A preliminary ruling INTERPRETS EU law. It does NOT decide the underlying national case. The national court applies the interpretation to the facts. Don't confuse the preliminary ruling answer with a decision on the merits.

----

== Advocate General opinions ==

Separate documents (kind=decision, type=advisory_opinion). Precede the judgment, more detailed reasoning. Not binding on the CJEU but highly persuasive — often followed. Linked via edges when available.

⚠️ Not yet ingested. The search above returns 0 results currently.

When citing a CJEU judgment, also check whether an AG opinion exists — it provides essential context.

----

== Decision analysis — EU courts ==

Supplements core "Structured decision analysis" (§5).

'''CJEU — preliminary rulings (art. 267 TFEU)''':
* Procedure = referring court + national dispute. CJEU answers question, does NOT decide national case.
* Questions referred: list as formulated. CJEU may reformulate or merge.
* AG opinion (if exists): summarize BEFORE court's reasoning. Note follow/departure — departure = deliberate choice, always significant.
* Reasoning: cite by §number (e.g. "§42-48"). Key paragraphs = principle before application.

'''CJEU — direct actions''':
* Contested act (annulment) or member state obligation (infringement).
* Pleas replace "Claims" — each plea = distinct argument, analyze separately.

'''ECHR''':
* Claims → alleged violations by Convention article (e.g. "Art. 8", "Art. 6§1").
* Vote split: note unanimous/majority. Dissenting opinions published, often significant.
* Margin of appreciation: wide = other states may differ. Narrow = more universal.
* Formally binding on respondent state only (Art. 46 ECHR). But interpretive authority (res interpretata) persuasive across all contracting states — do not dismiss as irrelevant.

----

== Practical reflexes ==

* '''Harmonized areas''' (data protection, competition, consumer, free movement): always check both FR and EU sources. Use <code>"jurisdiction": "eu|fr"</code>.
* '''Direct applicability''': regulations apply without national act. Directives need transposition.
* '''Time limits for direct actions''': annulment 2 months (art. 263(6) TFEU). Infringement: no time limit but Commission discretion.
* '''Multiple language versions''': in case of divergence, all versions equally authentic. CJEU resolves divergences by purposive interpretation.
* '''Brexit''': UK no longer member state since 2020-01-31. EU law no longer applicable. Pre-Brexit case law involving UK still relevant for general EU law principles.

----

== Danger — European emergency resources ==

When danger detected (see core guidelines §6):

<blockquote>
* European emergency: 112 (works in all EU member states)
* ECHR application: hudoc.echr.coe.int
* EU complaint to Commission: ec.europa.eu/info/about-european-commission/contact/problems-and-complaints_en
* Cross-border legal aid: e-justice.europa.eu
</blockquote>

Always recommend the user contact a lawyer in the relevant member state for national law issues.

[[Category:MCP]]

MCP/Guidelines/FR

Nicolas — Thu, 23 Apr 2026 02:16:02 GMT

Create MCP/Guidelines/FR page from jurisdiction.md (French law) (via create-page on MediaWiki MCP Server)

New page

= Jurisdiction: French law =

Supplements core safety guidelines with rules specific to French law (<code>tags={"jurisdiction": "fr"}</code>).

For French users, pass <code>language="fr"</code> on every search/get_document/browse_structure call. The corpus is overwhelmingly French (60M+ documents) so this is the typical default, but the parameter is '''always required''' — see the global Language guideline. The same legal text may exist in multiple language variants and the LLM must specify which one it wants.

<code>tags["jurisdiction"]</code> is also REQUIRED on every search and browse_structure call. Use <code>"fr"</code> for French law only, <code>"eu|fr"</code> for combined FR + EU (recommended for cross-border issues), or <code>"*"</code> for all jurisdictions.

----

== Which tool for which question ==

All examples below assume <code>tags={"jurisdiction": "fr", ...}</code>. Combine with <code>"eu|fr"</code> for cross-border questions.

* '''Employment law''' (dismissal, contract, salary, working hours): search(tags={"jurisdiction": "fr", "kind": "legislation", "code": "Code du travail"}) for statutory floor, then search(tags={"jurisdiction": "fr", "kind": "legislation", "source": "kali|acco"}) for collective and company agreements, then search(tags={"jurisdiction": "fr", "kind": "decision"}) for interpretation.
* '''Civil law''' (contracts, liability, property, family): search(tags={"jurisdiction": "fr", "kind": "legislation"}) for Code civil / Code de la consommation / Code de la construction, then search(tags={"jurisdiction": "fr", "kind": "decision"}).
* '''Criminal law''' (offenses, penalties, procedure): search(tags={"jurisdiction": "fr", "kind": "legislation", "code": "Code pénal"}) or <code>"code": "Code de procédure pénale"</code>, then search(tags={"jurisdiction": "fr", "kind": "decision"}).
* '''Tax law''': search(tags={"jurisdiction": "fr", "kind": "legislation"}) for CGI / LPF, then search(tags={"jurisdiction": "fr", "source": "bofip"}) for BOFiP interpretation, then search(tags={"jurisdiction": "fr", "kind": "decision"}).
* '''Data protection / GDPR''': search(tags={"jurisdiction": "eu", "kind": "legislation"}) for RGPD, search(tags={"jurisdiction": "fr", "kind": "legislation"}) for loi Informatique et Libertés, search(tags={"jurisdiction": "fr", "source": "cnil"}) for CNIL guidelines, search(tags={"jurisdiction": "fr", "kind": "decision", "court": "cnil"}) for sanctions. ⚠️ "RGPD" as FTS term returns few EU results — prefer <code>"données à caractère personnel"</code> OR <code>"protection des données"</code>, or direct CELEX: <code>get_document("32016R0679")</code>.
* '''Administrative law''': search(tags={"jurisdiction": "fr", "kind": "legislation"}) for relevant code (urbanisme, environnement, CESEDA...), search(tags={"jurisdiction": "fr", "kind": "decision", "court": "administratif"}) for CE / CAA / TA decisions.
* '''Company information''': search(tags={"jurisdiction": "fr", "kind": "record"}) for RNE registry + BODACC announcements.
* '''Legislative intent''': search(tags={"jurisdiction": "fr", "source": "parliamentary"}) for debates when a text is ambiguous.
* '''EU law''': use <code>"jurisdiction": "eu"</code> or <code>"eu|fr"</code>. search(tags={"jurisdiction": "eu", "kind": "decision"}) for CJUE/CEDH.
* '''QPC''' (constitutionality): search(tags={"jurisdiction": "fr", "kind": "decision", "court": "constitutionnel"}).
* '''Public accounting / financial discipline''': search(tags={"jurisdiction": "fr", "kind": "decision", "court": "cour_des_comptes"}) for CdC, search(tags={"jurisdiction": "fr", "kind": "decision", "court": "chambre_regionale_des_comptes"}) for CRC.

When in doubt: search(tags={"jurisdiction": "fr", "kind": "legislation"}) first, then search(tags={"jurisdiction": "fr", "kind": "decision"}). Cross-reference both.

----

== Search — French legal synonyms ==

Same concept, different words across texts and eras. Use OR:

* licenciement / rupture du contrat de travail / congédiement
* vice caché / défaut de conformité / garantie des vices
* préjudice / dommage / réparation
* faute lourde / faute grave / faute inexcusable
* clause abusive / clause léonine / déséquilibre significatif
* responsabilité / obligation de réparation
* bail / contrat de location / louage
* mise en demeure / sommation / interpellation

Example: <code>"vice caché" OR "défaut de conformité"</code>.

Multi-word concepts MUST use quotes: "action de groupe", "preuve déloyale", "abus de position dominante".

----

== Search — numeric literals ==

Thousands separator: space.
Amounts ≥ 4 digits: OR both forms, quote the spaced form.
<code>seuil 10000 OR seuil "10 000"</code>
Skip: years (2024), case numbers (19-15.165), article numbers (L.1235-1), decimals (10,5).

----

== Normative hierarchy ==

Constitution > treaties/EU law > "loi" > "ordonnance ratifiée" > "décret" > "arrêté" > "circulaire" (not binding on courts).

=== Codification prefixes ===

* '''L.''' = legislative ("loi", Parliament). Highest within a code.
* '''R.''' = regulatory ("décret en Conseil d'État").
* '''D.''' = regulatory ("décret simple").
* '''A.''' = ministerial order ("arrêté").
* '''No prefix''' = old codes not recodified (Code civil, Code pénal pre-1994).

L. > R. within same code. Same number, different prefix = different articles (L.1234-5 ≠ R.1234-5). If R. contradicts L., L. prevails.
Include exact prefix in search queries. Test format variations: <code>L. 121-1</code> / <code>L121-1</code> / <code>L.121-1</code>.

=== EU law interaction ===

* Regulation = directly applicable, no transposition.
* Directive = requires transposition. Untransposed after deadline → invocable vertically (vs State) but NOT horizontally (between private parties).
* Harmonized areas (data protection, competition, consumer): check FR + EU sources. Use <code>"jurisdiction": "eu"</code> or <code>"eu|fr"</code>.
* CJEU preliminary ruling (art. 267 TFEU) = interprets EU law, does NOT decide national case.
* ECHR: margin of appreciation. Ruling vs Italy ≠ automatically applies to France.
* Charter Art.7 (private life) and Art.8 (data protection) ≠ ECHR Convention Art.8 (private life). Same wording, different instruments — never confuse.

----

== Major reforms — renumbering traps ==

=== Obligations (ordonnance 2016-131, effective 1 Oct 2016) ===

Key renumbering: 1134→1103+1104, 1147→1231-1, 1382→1240, 1383→1241, 1384→1242.
Pre-2016 decisions cite old numbers — still valid case law but articles renumbered.
CRITICAL: contracts before 1 Oct 2016 → old articles apply. Don't apply new numbering to old contracts.

=== Security interests (ordonnance 2021-1192, effective 1 Jan 2022) ===

Reorganized Code civil Book IV ("sûretés").

=== Criminal justice for minors (effective 30 Sep 2021) ===

"Code de justice pénale des mineurs" replaced 1945 "ordonnance."

=== Criminal procedure (loi n° 2024-364 du 22 avril 2024, effective 1 Jul 2024) ===

Articles 63 et seq. CPP (garde à vue) modified. Check version applicable: pre- or post-1 Jul 2024.

=== Transitional law ===

Applicable version = date of facts, not date of question. Non-retroactivity (art. 2 CC). Immediate application of new procedural law. Criminal "in mitius" (more lenient = retroactive). Check transitional articles in recently reformed texts.

----

== Court system ==

=== court_level mapping (T1 tag) ===

Apex per judicial order (judiciaire / administratif / financier). Pair with <code>court</code> for FR-specific precision.

* <code>supreme</code> — cour_cassation (judiciaire), conseil_etat (administratif), cour_des_comptes (financier)
* <code>appellate</code> — cour_appel, cour_administrative_appel, tribunal_superieur_appel, cour_appel_financiere
* <code>first_instance</code> — tribunal_judiciaire, conseil_prudhommes, tribunal_commerce, tribunal_administratif, chambre_regionale_des_comptes, cour_discipline_budgetaire_financiere
* <code>constitutional</code> — conseil_constitutionnel
* null — tribunal_conflits (sui generis), CNIL / CADA / AMF

=== Judicial order ===

* '''Cour de cassation''': supreme. Controls law, not facts. "Publié au bulletin" = jurisprudential value.
** "Assemblée plénière" > "Chambre mixte" > individual chamber (civ.1, civ.2, civ.3, com., soc., crim.)
* '''Cours d'appel''': rejudge facts + law.
* '''Tribunal judiciaire''' (tribunal_judiciaire): general first instance. '''Conseil de prud'hommes''' (conseil_prudhommes): labor. '''Tribunal de commerce''' (tribunal_commerce): commercial.

=== Administrative order ===

* '''Conseil d'État''': supreme admin court + government advisor ("avis" ≠ "arrêts").
* '''Cour administrative d'appel''' (cour_administrative_appel) > '''Tribunal administratif''' (tribunal_administratif).

=== Specialized ===

* '''Conseil constitutionnel''': QPC can invalidate provisions.
* '''Tribunal des conflits''': judicial vs admin jurisdiction conflicts.
* '''CNIL''': guidelines → search(tags={"jurisdiction": "fr", "source": "cnil"}). Sanctions → search(tags={"jurisdiction": "fr", "kind": "decision", "court": "cnil"}).
* '''CADA''': access to admin documents. Opinions → search(tags={"jurisdiction": "fr", "source": "cada"}).

=== Financial order ===

* '''Cour des comptes''' (cour_des_comptes): apex of the financial order. Since 2023: 1st instance (contentious chamber, absorbed CDBF) + cassation over CAF. Pre-2023: appellate for CRC. search(tags={"jurisdiction": "fr", "kind": "decision", "court": "cour_des_comptes"}).
* '''Chambres régionales des comptes''' (chambre_regionale_des_comptes): first instance for local authorities. search(tags={"jurisdiction": "fr", "kind": "decision", "court": "chambre_regionale_des_comptes"}).
* '''Cour de discipline budgétaire et financière''' (cour_discipline_budgetaire_financiere): abolished 2023, integrated into CdC contentious chamber. Historical decisions (1954-2022) remain searchable. search(tags={"jurisdiction": "fr", "kind": "decision", "court": "cour_discipline_budgetaire_financiere"}).
* '''Cour d'appel financière''' (cour_appel_financiere, CAF): created 2023, hears appeals from CRC and CdC contentious chamber. Reviewed en cassation by CdC. search(tags={"jurisdiction": "fr", "kind": "decision", "court": "cour_appel_financiere"}).

=== Publication grades (official_grade) ===

'''Administrative courts''' (PUBLI_RECUEIL):
* A: "Publié au Recueil Lebon" (conseil_etat and tribunal_conflits only) — highest_importance
* B: "Mentionné aux Tables du Lebon" (conseil_etat and tribunal_conflits only) — high_importance
* R: "Intérêt jurisprudentiel majeur" (cour_administrative_appel and tribunal_administratif — equivalent of A) — highest_importance
* C+: "Intérêt signalé" (cour_administrative_appel and tribunal_administratif — equivalent of B) — high_importance
* C: "Inédit" — low_importance
* D, Z: "Intérêt limité aux parties" — minimal_importance

'''Cour de cassation''' (post-2021):
* rapport: "Sélectionné pour le Rapport annuel" — highest_importance
* bulletin: "Publié au Bulletin des arrêts" — high_importance
* diffuse: "Diffusé sur Légifrance" — low_importance
* non_diffuse: "Non diffusé" — minimal_importance

'''Cour de cassation''' (pre-2021, decisions before 2021-06-15):
* rapport (R): "Rapport annuel" — highest_importance
* bulletin (ancien P): "Publié au Bulletin" — high_importance
* bulletin_information (ancien B): "Mentionné au BICC" — medium_importance
* internet (ancien I): "Diffusé sur internet" — low_importance
* diffuse (ancien D): "Diffusé aux bases" — low_importance

'''Lower courts''' (cour_appel, tribunal_judiciaire, tribunal_commerce):
* particular_interest: "Arrêt d'intérêt particulier" — highest_importance (only ~1,400 decisions out of 1.25M)

'''Financial courts''' (cour_des_comptes, chambre_regionale_des_comptes, cour_discipline_budgetaire_financiere, cour_appel_financiere):
* recueil: "Publié au Recueil des juridictions financières" — high_importance (~25% of decisions)

=== Formations (ascending solemnity) ===

'''Cour de cassation''': F: "formation restreinte" (reduced_bench) < standard chamber (standard_bench) < FS: "formation de section" (grand_bench) < FP: "formation plénière de chambre" (grand_bench) < "Chambre mixte" (combined_chambers) < "Assemblée plénière" (full_court). Note: at the Cass, "Chambre mixte" (combined_chambers) outranks "formation plénière" (grand_bench) — diverges from generic solemnity ordering.

'''Conseil d'État''': "Juge des référés" (single_judge) < "Formation à 3" (reduced_bench) < "Chambre seule" (standard_bench) < "Chambres réunies"/SSR (combined_chambers) < "Section du contentieux" (grand_bench) < "Assemblée du contentieux" (full_court)

=== Reading a decision ===

Structure: '''visa''' ("Vu l'article...") = legal basis → '''motifs''' = reasoning (ratio decidendi + obiter dicta) → '''dispositif''' ("PAR CES MOTIFS") = operative part (res judicata).

Key terms:
* "Casse et annule" = quashes (→ "renvoi", case NOT over)
* "Casse sans renvoi" = quashes and decides directly
* "Rejette" = upholds appealed decision
* "Infirme"/"confirme" = reverses/upholds (appeal)
* "Débouté" = claim dismissed (civil) ≠ "relaxé" = acquitted (criminal)
* "Irrecevable" = inadmissible (can't examine merits) ≠ "mal fondé" = rejected on merits

Post-2019: Cass. switched from "Attendu que" to direct style. Both equally authoritative.
Processual roles change between instances — identify WHO is WHO in each decision.

=== Decision analysis — French courts ===

Supplements core "Structured decision analysis" (§5).

'''Cour de cassation''':
* Claims = "moyen du pourvoi" (grounds the party argues Cass should quash on) vs cour d'appel position. Moyen ≠ court's position — it's what the party claims was wrong.
* Visa ("Vu l'article...") = legal basis. Visa + cassation = lower court violated that text.
* Chapeau = principle stated before application. May be narrower or broader than statutory text.
* Cass controls law, not facts (see "Court system" above). Do not extract factual findings from a Cass decision — those are the lower court's. Cass says whether the law was correctly applied.

'''Conseil d'État''':
* More explicit reasoning than Cass. "Considérant" → direct style since 2019.
* CE may raise moyens d'ordre public and reformulate the legal question beyond parties' framing.
* Avis contentieux: same structure, no dispositif — answers question, does not decide case.
* Dispositif: numbered articles ("Article 1er: ...").

'''Conseil constitutionnel (QPC)''':
* Saisine: who referred, which provision challenged, which rights invoked.
* Dispositif: conformité / non-conformité / conformité sous réserve. The reservation IS the holding — often more important than the conformity declaration.
* Abrogation may be deferred ("à compter du...") — check effective date before citing.

'''Cour d'appel / Tribunal judiciaire''' (cour_appel / tribunal_judiciaire):
* Rejudge facts AND law. Factual findings are the court's own.
* Less standardized structure — locate legal issue and reasoning chain in longer prose.

=== Case number formats ===

{| class="wikitable"
! Court (court tag value) !! Format !! Example
|-
| cour_cassation || <code>YY-NN.NNN</code> || 24-14.752
|-
| cour_appel / tribunal_judiciaire || <code>YY/NNNNN</code> || 21/00091
|-
| conseil_etat || <code>NNNNNN</code> (sequential) || 486329
|-
| tribunal_administratif / cour_administrative_appel || <code>YYLLNNNNN</code> (year + court code) || 24PA01233
|-
| conseil_constitutionnel || <code>YYYY-NNN TYPE</code> || 2021-823 DC
|-
| tribunal_conflits || <code>CNNNN</code> || C4321
|-
| cour_des_comptes || <code>S-YYYY-NNNN</code> || S-2025-0381
|-
| cour_discipline_budgetaire_financiere || <code>NNN-NNN</code> || 264-865
|}

Cass. pourvoi: digits 3-4 of the sequence correlate with chamber (80-89 = criminal, ~10-25 = civil/commercial/social). A "Cass. civ. 1re" citing n°25-85.337 is suspicious — 85 suggests criminal chamber.

=== "Référés" ===

Provisional measures ("liberté", "suspension", "provision", "expertise"). Single judge, "ordonnance." Lower standard: "urgence" + "doute sérieux"/"moyens sérieux." Provisional only, no res judicata on merits. Always flag provisional nature when citing.

=== "Avis contentieux" ===

Advisory opinions: Cass (since 1991, L441-1 COJ), CE (since 1987, L113-1 CJA). Novel legal questions from lower courts. Not binding but highly persuasive. No res judicata, no parties. search(tags={"jurisdiction": "fr", "kind": "decision", "type": "advisory_opinion"}).

⚠️ EU AG opinions (CJEU Advocate General): not yet ingested — type=advisory_opinion with jurisdiction="eu" returns 0 results.

----

== Labor law ==

=== Three-tier hierarchy ===

"Code du travail" (statutory floor) → "convention collective de branche" → "accord d'entreprise."
Since 2017 Macron ordonnances: company agreements can override branch in most areas EXCEPT locked domains ("minima salariaux", "classifications", "mutualisation formation", "prévoyance").

=== bargaining_level (T2 tag) ===

Filters collective / company agreements by negotiation level. Currently emitted (acco source): <code>enterprise</code> (accord d'entreprise), <code>sectoral</code> (accord de branche). ADR also defines <code>inter_sectoral</code>, <code>territorial</code> (not yet populated). Example: <code>search(tags={"jurisdiction": "fr", "source": "acco", "bargaining_level": "enterprise"})</code>.

=== IDCC ===

Each collective agreement has an IDCC number. IDCCs merge (metallurgy → IDCC 3248, 2024). Never assume IDCC is current.

=== Categories ===

Different rules per category: "ouvriers", "employés", ETAM, "cadres." Check section_path in results.

=== Applicable agreement ===

Depends on EMPLOYER's main activity, not employee's job. Developer at industrial company → metallurgy, not Syntec.

=== Sources ===

* kali = official texts (DILA/Légifrance). acco = filed company agreements.
* "Étendue" = all employers in sector. Non-extended = only signatory members.

=== Critical ===

Never from memory on amounts/durations/IDCC. Frequent amendments by "avenant."

----

== Legislation ==

=== Territorial scope ===

* '''Alsace-Moselle''': local law for associations (not "loi 1901"), local social security, civil bankruptcy, extra holidays (Good Friday, 26 Dec), "livre foncier."
* '''DOM''' (Guadeloupe, Martinique, Guyane, Réunion, Mayotte): FR law with adaptations. Mayotte: specific labor code, customary personal status. L7xx articles = overseas — don't cite for metropolitan.
* '''COM''' (Polynesia, New Caledonia, Wallis): "spécialité législative" — FR law does NOT apply unless expressly stated.

=== Text types ===

Code, "loi" (Parliament), "ordonnance" (gov + parliamentary authorization), "décret", "arrêté."
"Circulaire" = admin interpretation, NOT in this database (→ circulaires.gouv.fr), not binding on courts.

=== nature tag (T3 precision) ===

Source-native classification, slugified (lowercase, no accents, spaces → <code>_</code>). Use when T1 <code>type</code> / <code>document_form</code> are too broad.
* Legislation (LEGI): <code>loi</code>, <code>loi_organique</code>, <code>decret</code>, <code>ordonnance</code>, <code>arrete</code>.
* Decisions: <code>arret</code>, <code>ordonnance</code>, <code>avis</code>; Conseil constitutionnel: <code>dc</code>, <code>qpc</code>, <code>lp</code>, <code>lom</code>.
Example: <code>search(tags={"jurisdiction": "fr", "kind": "decision", "nature": "qpc"})</code> — QPC decisions only.
Use <code>discover="nature"</code> to enumerate actual values.

=== JORF (Journal officiel) ===

JORF is the official gazette — the original publication of all legislation. LEGI is the consolidated version. Both are in the corpus. '''JORF is hidden from default search''' (LEGI is preferred). To search JORF explicitly: <code>search(tags={"source": "jorf"})</code>. JO issues (gazette containers): <code>search(kind="notice", tags={"source": "jorf", "type": "gazette_publication"})</code>. Resolve a JO issue: <code>get_document(reference="JO du 11 avril 2026")</code>. LEGI↔JORF linked by <code>source_text</code> edges — visible in get_document results.

=== Code abbreviations ===

Common abbreviations in legal writing — the resolver normalizes these automatically:
C. civ. = Code civil, C. com. = Code de commerce, C. trav. = Code du travail, C. pén. = Code pénal, CPC = Code de procédure civile, CPP = Code de procédure pénale, CGI = Code général des impôts, CSS = Code de la sécurité sociale, C. cons./C. conso. = Code de la consommation, CPI = Code de la propriété intellectuelle, CMF = Code monétaire et financier, CSP = Code de la santé publique, CJA = Code de justice administrative, CGCT = Code général des collectivités territoriales.
Full list: <code>lister_codes_juridiques</code> or get_document(reference="<abbreviation>").

=== Enforcement status ===

See "Enforcement status" section below for canonical values used in tags.

=== Suppletive vs mandatory ===

* Mandatory ("ordre public"): "toute clause contraire est réputée non écrite." Cannot override.
* Suppletive: "sauf stipulation contraire." Contract can override → mention this caveat.

----

== Doctrine ==

=== BOFiP ===

Tax administration's official interpretation. Opposable to fisc (cannot apply less favorable position). NOT binding on courts. Series: IR, IS, TVA, BIC, BNC, CF.

=== CNIL ===

Guidelines/recommendations = soft law. Widely followed, used by courts as diligence standard.
Sanctions (fines, formal notices) → search(tags={"jurisdiction": "fr", "kind": "decision", "court": "cnil"}), NOT here.

=== CADA ===

Advisory opinions on access to admin documents.

=== NOT available ===

Academic doctrine (treatises, case commentaries) is NOT in this server. Flag this gap when relevant.

----

== Deadline computation ==

* "Jours francs": notification day and expiration day don't count.
* "Jours calendaires": all days. "Jours ouvrables": Mon-Sat minus holidays. "Jours ouvrés": Mon-Fri minus holidays.
* Expires on Sat/Sun/holiday → extended to next business day (art. 642 CPC).
* Prescription start: often "date holder knew or should have known" (art. 2224 CC), not event date. Hidden defects: date of discovery, not sale.
* Interruption ("assignation", debt recognition) → restarts clock. Suspension (mediation, minority) → freezes clock.

----

== Common traps ==

* "Obligation de moyens" (creditor proves fault) vs "résultat" (debtor presumed liable unless force majeure).
* "Responsabilité contractuelle" ≠ "délictuelle." No cumulation. Different regime, different prescription.
* "Nullité" (never existed) ≠ "résolution" (retroactive destruction) ≠ "résiliation" (future only).
* "Bonne foi" (art. 1104 CC): mandatory in all contracts. Formally compliant but bad faith → sanctioned.
* "Abus de droit": exercising right solely to harm → sanctioned.
* "Enrichissement injustifié" (art. 1303 CC): subsidiary only — not available if other basis exists.
* "Solidarité ne se présume pas" (art. 1310 CC) — must be in contract or statute.
* "Loi" without "décret d'application" = potentially inapplicable. Check 'Implementing texts' in get_document. Text mentions "fixé par décret" but no decree → flag.
* Non-retroactivity of laws. Exception: criminal law "in mitius."
* "Exécution provisoire de droit" since 2020: first-instance judgments immediately enforceable. Appeal ≠ suspension.
* Contract qualification ≠ party denomination: "prestation de services" with subordination = "contrat de travail."
* 4 "bail" types = 4 regimes: habitation (loi 1989) ≠ commercial ≠ professionnel ≠ rural.
* 3 couple regimes: "mariage" (+ "régime matrimonial") ≠ PACS ≠ "concubinage."
* Construction: 3 warranties ("parfait achèvement" 1y, "biennale" 2y, "décennale" 10y).
* Medical liability: 3 regimes ("faute", "perte de chance", "infection nosocomiale").
* Digital: "hébergeur" ≠ "éditeur" (LCEN/DSA — different liability).
* Proof: free (criminal, commercial), regulated >1500€ civil (1359 CC). Burden: claimant (1353 CC), reversed in harassment (shared), consumer (conformity presumed). Illegally obtained proof: admissible if proportionate (Ass. plén. 22 Dec 2023).
* "Titre exécutoire" required for enforcement. "Astreinte" for non-compliance, separate liquidation.
* "Trêve hivernale" (1 Nov – 31 Mar): no eviction of primary residence occupants (L412-6 CPCE). Check exceptions and dates — calendar may shift.

----

== Citation self-check — FR illustrations ==

Core rule 3b applied to French law:
* '''Source match''': L442-1 C.com ≠ L442-1 C.civ — same number, different code, different rule. Verify code name.
* '''Content fidelity''': art. 1240 — "oblige à indemniser" ≠ "oblige celui par la faute duquel il est arrivé à le réparer." The word "faute" is the entire condition.
* '''Completeness''': art. 1103 (force obligatoire) without art. 1104 (bonne foi) and ordre public exceptions is half the picture.
* '''Decision reality''': Cass. civ. 1re, 15 mars 2023, n°21-12.345 — correct format, plausible date, real chamber. But if not retrieved via tools: fabricated. See "Case number formats" above for valid patterns.
* '''Attribution''': Cass. com. ≠ Cass. civ. 1re — different chamber, different authority, potentially opposite rule on same question. Pourvoi digits 3-4 in 80-89 range → likely criminal, not civil.

----

== Practical reflexes ==

* '''Prescription''': 5y civil (2224 CC), 2y consumer (L218-2 C.conso), 10y bodily (2226 CC), 1y dismiss (L1471-1 C.trav), 3y salary (L3245-1 C.trav), 2mo admin (R421-1 CJA), 6y "délit", 20y "crime", 1y "contravention." Start = "knew or should have known", not event date. Always check — user may be right on substance but time-barred.
* '''Short deadlines''': contesting dismissal 12 months, building permit 2 months, "référé" urgency.
* '''Pre-litigation''': "mise en demeure" often mandatory. Mediation mandatory in some consumer and labor disputes. "Recours gracieux" / "hiérarchique" in admin law.
* '''Multiple avenues''': same problem → civil + criminal + admin paths. Criminal acquittal ≠ civil immunity.
* '''Insurance''': "RC pro", "protection juridique", D&O, "décennale." Always ask if user has legal protection insurance.
* '''Collective proceedings''' ("sauvegarde"/"redressement judiciaire"/"liquidation judiciaire"): individual actions frozen. Check before pursuing.
* '''Annual amounts''': SMIC, tax brackets, "taux d'intérêt légal", "plafond sécurité sociale" change annually. Always date amounts. Flag potential staleness.

----

== Data limitations — French sources ==

What is NOT in this corpus (flag explicitly when relevant):
* '''First-instance decisions''' (TJ, CPH, TC): not systematically published. Practice may differ from supreme courts.
* '''Academic doctrine''' (treatises, "fascicules", "notes d'arrêt"): NOT available. Only BOFiP + CNIL + CADA.
* '''Circulaires''': not in database. → circulaires.gouv.fr (not binding on courts anyway).
* '''Notarial practice and customs''': not available.
* '''Pénal''': limited coverage of criminal court decisions (Cass. crim. is in, but lower criminal courts are sparse).
* '''Avocats consultations / mémos internes / DD''': confidential, not available.
* '''Recent enactments''': ingestion lag. Always flag for very recent texts (< 48h).

=== Decision sources — search by court, not source ===

Overlapping sources: <code>cass</code>, <code>inca</code>, <code>judilibre</code> = Cour de cassation; <code>jade</code>,
<code>ce_opendata</code>, <code>judilibre</code> = admin courts; <code>capp</code>, <code>judilibre</code> = cours d'appel;
<code>jufi</code> = financial courts (CdC, CRC, CDBF, CAF — ~3,500 decisions, 1954-present).
Dedup keeps one copy. Use <code>"court": "cour_cassation"</code>, not <code>"source": "cass"</code>.
<code>source</code> filtering may miss decisions.

=== Legislation sources — LEGI vs JORF ===

<code>legi</code> = consolidated legislation (versioned, with enforcement_status). <code>jorf</code> = official gazette (original publication, no versioning). Same text exists in both with different IDs (LEGITEXT/JORFTEXT). JORF hidden from default search — LEGI preferred. JORF adds: JO issue structure, visas, ministère metadata. ~4% of JORF texts have no LEGI counterpart (nominations, old texts).

== Stemming gotchas (FR) ==

PostgreSQL stemming covers many forms but NOT all. Common pairs to OR explicitly:
* "contractuel" ≠ "contrat"
* "prescription" ≠ "prescrire"
* "responsabilité" matches "responsable" (OK)
* "juger" matches "jugement" (OK)

When in doubt, use OR.

== Enforcement status ==

Tag: <code>enforcement_status</code> (canonical international values)
* <code>in_force</code> = currently in force
* <code>deferred_enforcement</code> = enacted but not yet applicable → flag the future effective date
* <code>deferred_repeal</code> = still in force until a future date → cite but flag the upcoming repeal
* <code>repealed</code> = repealed → NEVER cite as current law
* <code>superseded</code> = historical version, a newer version exists → cite the newer version
* <code>never_in_force</code> = modified before its effective date, never applied → never cite
* <code>expired</code> = lapsed by its own terms (sunset clause) → no longer applicable
* <code>annulled</code> = struck down by a court (typically retroactive) → never cite
* <code>transferred</code> = content moved to a different article (renumbering) → cite the new location
* <code>denounced</code> = collective agreement repudiated by a party → no longer applies
* <code>disjoined</code> = version split into multiple articles → cite the resulting articles
* <code>conditional</code> = in force only under a specific interpretation (constitutional reservation)
* <code>pending</code> = adopted but awaiting ratification

----

== Danger — French emergency resources ==

When danger detected (see core guidelines §6):

<blockquote>
* Emergency: 17 (police) / 15 (SAMU) / 18 (pompiers) / 112 (European)
* Emergency SMS: 114 (for people who cannot speak — domestic violence, disability)
* Gendarmerie chat: https://www.gendarmerie.interieur.gouv.fr/contact/echanger-avec-un-gendarme (24/7, anonymous — for non-emergency; call 17 if urgent)
* Online reporting: internet-signalement.gouv.fr (Pharos)
* Legal aid: SOS Avocats (consultation gratuite), local "ordre des avocats"
* Government: https://www.service-public.gouv.fr/particuliers/vosdroits/F20706
* Domestic violence: 3919 (Violences Femmes Info)
* Child danger: 119 (Enfance en danger)
</blockquote>

[[Category:MCP]]

Corpus/Graph

Nicolas — Thu, 23 Apr 2026 02:12:47 GMT

Import from duralex/spec/GRAPH.md — faithful conversion to wikitext (via create-page on MediaWiki MCP Server)

New page

= Knowledge Graph (Draft) =

This document is a preliminary sketch. The graph layer will be refined when implementation begins. See the legalscript spec (separate repository) for the full vision.

== Scope ==

The knowledge graph is a separate system built ON TOP of the corpus. It is not part of the corpus schema. It lives in a separate PostgreSQL schema (<code>graph.*</code>) and compiles into self-contained SQLite packages for runtime navigation.

== Relationship to corpus ==

<pre>
corpus.* graph.* compiled/
documents (source texts) → concepts (legal concepts) → fr.civil.sqlite
edges (citations) → annotations (LLM/human) → fr.travail.sqlite
→ edges (concept relations) → fr.conso.sqlite
→ compilations (metadata)
</pre>

* The corpus stores source data (legislation, decisions, guidance). Precious, days to re-ingest.
* The graph stores derived knowledge (concepts, annotations). Reproducible, hours to recompile.
* Compiled packages are self-contained SQLite for runtime. No PostgreSQL dependency at query time.

== Graph schema (draft) ==

<syntaxhighlight lang="sql">
CREATE SCHEMA IF NOT EXISTS graph;

CREATE TABLE graph.concepts (
id text PRIMARY KEY, -- thematic path: fr.civil.contrat.formation.consentement.vice.dol
jurisdiction text NOT NULL,
parent_id text, -- parent concept (extends)
title text NOT NULL,
concept_type text NOT NULL, -- qualifiable, standard_ouvert, principe_directeur, procedural, bareme
defining_articles jsonb, -- references to corpus documents
metadata jsonb DEFAULT '{}',
created_at timestamptz DEFAULT now()
);

CREATE TABLE graph.annotations (
id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
doc_id text NOT NULL, -- references corpus.documents.id
annotation_type text NOT NULL, -- structure, defines, illustrates, condition, qualify, framework...
concept_id text, -- references graph.concepts.id
version int NOT NULL,
parent_version int,
method text NOT NULL, -- stub, llm, human, jurist
confidence text NOT NULL, -- stub, memory_only, source_checked, cross_validated, disputed
author text,
prompt_hash text,
content jsonb NOT NULL,
created_at timestamptz DEFAULT now()
);

-- PostgreSQL does not allow function calls in table-level UNIQUE constraints.
-- Use a unique index instead:
CREATE UNIQUE INDEX idx_ann_unique
ON graph.annotations (doc_id, annotation_type, coalesce(concept_id, ''), version);

CREATE TABLE graph.edges (
id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
source_id text NOT NULL,
target_id text NOT NULL,
kind text NOT NULL,
properties jsonb DEFAULT '{}',
UNIQUE (source_id, target_id, kind)
);

CREATE TABLE graph.compilations (
id text PRIMARY KEY,
version int NOT NULL,
compiled_at timestamptz NOT NULL,
source_commit text,
quality jsonb,
dependencies jsonb,
artifact_path text
);
</syntaxhighlight>

== Why separate from corpus ==

The graph has different structural needs:
* Annotations have versioning (version + parent_version), confidence, method, prompt_hash as first-class columns
* Concepts have concept_type and defining_articles
* No body/body_search/content_fts/language — annotations are structured JSONB, not searchable text
* Different write patterns: corpus is append-mostly, graph is recompiled in bulk

Forcing annotations into corpus.documents would leave 5 of 14 columns always NULL. That is not optimal — it is forcing.

== Corpus guarantees for the graph ==

The corpus schema guarantees properties the graph depends on:

# '''Stable IDs''' — corpus.documents.id never changes after ingestion. The graph references documents by ID.
# '''Permanent article identity''' — <code>tags.cid</code> groups temporal versions of the same article. The graph needs this to link concepts to articles across renumbering.
# '''Immutable body''' — <code>body</code> does not change after initial ingestion. Future annotation anchoring (character offsets) depends on this stability.
# '''No reverse dependency''' — corpus never references graph. The graph depends on corpus, not the inverse.

[[Category:Corpus]]

Corpus/FTS

Nicolas — Thu, 23 Apr 2026 02:12:09 GMT

Import from duralex/spec/FTS.md — faithful conversion to wikitext (via create-page on MediaWiki MCP Server)

New page

= Full-Text Search =

== Overview ==

FTS uses PostgreSQL tsvector with per-language text search configurations. The <code>content_fts</code> column is populated by a trigger from <code>coalesce(body_search, body)</code>. CJK languages require the pgroonga extension.

== The two-text model ==

* <code>body</code>: clean displayable content. Always renderable to a user (HTML, links, formatted text). Immutable after ingestion. Never contains noisy OCR or raw PDF binary.
* <code>body_search</code>: FTS-optimized text used for indexing. Can be noisy (raw PDF extraction, OCR output) because users never see it directly. Nullable. When NULL, FTS uses body directly.

Why two columns:
# '''Display vs index separation.''' <code>get_document</code> returns <code>body</code>, so it must always be clean. FTS reads <code>coalesce(body_search, body)</code>, so <code>body_search</code> can hold a noisy-but-indexable representation (e.g., extracted PDF text) without polluting display.
# '''PDF-sourced documents.''' When a document is only available as PDF, <code>body</code> is a clean stub like <code>Source: <a href="...">PDF officiel</a></code> (the LLM follows the link or uses search snippets). <code>body_search</code> holds the pdfminer-extracted text so the document is findable via FTS.
# '''Legal reference normalization''' (e.g., "L442-1" to "L442.1") must be consistent between index and query. <code>body_search</code> holds the normalized text; the search plugin applies the same normalization to the query.
# <code>body</code> is the source of truth for display and annotation anchoring. It never changes.

See ADR-010 for the full rationale of this semantic.

== Trigger ==

<syntaxhighlight lang="sql">
CREATE FUNCTION corpus.update_content_fts() RETURNS trigger AS $$
DECLARE
lang text;
cfg regconfig;
BEGIN
-- Skip recomputation if searchable content unchanged (tag-only upserts)
IF TG_OP = 'UPDATE'
AND NEW.title IS NOT DISTINCT FROM OLD.title
AND NEW.body IS NOT DISTINCT FROM OLD.body
AND NEW.body_search IS NOT DISTINCT FROM OLD.body_search
AND NEW.language IS NOT DISTINCT FROM OLD.language
AND NEW.jurisdiction IS NOT DISTINCT FROM OLD.jurisdiction
AND (NEW.tags->>'summary') IS NOT DISTINCT FROM (OLD.tags->>'summary')
AND (NEW.tags->>'headnote_classification') IS NOT DISTINCT FROM (OLD.tags->>'headnote_classification') THEN
NEW.content_fts := OLD.content_fts;
RETURN NEW;
END IF;

-- Extract country prefix for subdivisions (gb-sct → gb, es-ct → es)
lang := coalesce(NEW.language, split_part(NEW.jurisdiction, '-', 1));

-- CJK: tsvector non-functional, use pgroonga instead
IF lang IN ('zh', 'ja', 'ko') THEN
NEW.content_fts := NULL;
RETURN NEW;
END IF;

cfg := CASE lang
WHEN 'fr' THEN 'french'::regconfig
WHEN 'de' THEN 'german'::regconfig
WHEN 'en' THEN 'english'::regconfig
WHEN 'es' THEN 'spanish'::regconfig
WHEN 'it' THEN 'italian'::regconfig
WHEN 'pt' THEN 'portuguese'::regconfig
WHEN 'nl' THEN 'dutch'::regconfig
WHEN 'sv' THEN 'swedish'::regconfig
WHEN 'da' THEN 'danish'::regconfig
WHEN 'fi' THEN 'finnish'::regconfig
WHEN 'hu' THEN 'hungarian'::regconfig
WHEN 'ro' THEN 'romanian'::regconfig
WHEN 'tr' THEN 'turkish'::regconfig
WHEN 'ru' THEN 'russian'::regconfig
WHEN 'no' THEN 'norwegian'::regconfig
-- Arabic: no built-in PG config. Falls through to 'simple'.
-- Install a custom Arabic text search config before ingesting AR data.
ELSE 'simple'::regconfig
END;

-- Binary body check: skip FTS on PDF/binary content
IF coalesce(NEW.body_search, NEW.body) IS NOT NULL
AND left(coalesce(NEW.body_search, NEW.body), 4) = '%PDF' THEN
NEW.content_fts :=
setweight(to_tsvector(cfg, unaccent(
corpus.normalize_for_fts(NEW.jurisdiction, coalesce(NEW.title, ''))
)), 'A') ||
setweight(to_tsvector(cfg, unaccent(
coalesce(NEW.tags->>'summary', '') || ' ' ||
coalesce(NEW.tags->>'headnote_classification', '')
)), 'B');
RETURN NEW;
END IF;

NEW.content_fts :=
setweight(to_tsvector(cfg, unaccent(
corpus.normalize_for_fts(NEW.jurisdiction, coalesce(NEW.title, ''))
)), 'A') ||
setweight(to_tsvector(cfg, unaccent(
coalesce(NEW.tags->>'summary', '') || ' ' ||
coalesce(NEW.tags->>'headnote_classification', '')
)), 'B') ||
setweight(to_tsvector(cfg, unaccent(
corpus.normalize_for_fts(NEW.jurisdiction,
regexp_replace(coalesce(NEW.body_search, NEW.body, ''), '<[^>]+>', ' ', 'g'))
)), 'C');
RETURN NEW;
END $$ LANGUAGE plpgsql;

CREATE TRIGGER trg_content_fts
BEFORE INSERT OR UPDATE OF title, body, body_search, tags, language, jurisdiction
ON corpus.documents FOR EACH ROW
EXECUTE FUNCTION corpus.update_content_fts();
</syntaxhighlight>

== Pluggable normalization (normalize_for_fts) ==

<syntaxhighlight lang="sql">
-- Core: identity (no-op)
CREATE FUNCTION corpus.normalize_for_fts(p_jurisdiction text, p_input text)
RETURNS text LANGUAGE sql IMMUTABLE AS $$ SELECT p_input; $$;
</syntaxhighlight>

Jurisdiction plugins override this function:
* FR plugin installs <code>normalize_legal_refs_final()</code> for French legal references (L442-1 to L442.1).
* Future DE plugin could install <code>normalize_de_refs()</code> for German references (paragraph 823 BGB).

The same normalization function must be applied to search queries (by the search plugin) to ensure consistency between indexed text and query.

== Phased approach to normalization ==

Phase 1 (now): For HTML-sourced documents, <code>body_search=NULL</code>. <code>normalize_for_fts()</code> in the trigger handles normalization on <code>body</code>.

Phase 2 (PDF ingest, ADR-010): For PDF-sourced documents, <code>body</code> is a clean HTML stub with the source URL, and <code>body_search</code> holds the pdfminer-extracted text. <code>normalize_for_fts()</code> still runs. The trigger uses <code>coalesce(body_search, body)</code>, preferring the indexable representation when present.

Phase 3 (LLM pipeline): LLM writes a normalized/cleaned version to <code>body_search</code> for HTML-sourced documents whose body has irregular references. <code>normalize_for_fts()</code> reset to identity.

Query-side normalization (regex) remains necessary in all phases.

== Weight system ==

Three FTS weights:

* '''Weight A''' (highest): title.
* '''Weight B''': <code>tags.summary</code> + <code>tags.headnote_classification</code>, read directly from JSONB by the trigger. Provides FTS on curated legal metadata (headnotes, summaries) without duplicating body content. Not all documents have these tags — weight B is empty when absent.
* '''Weight C''': <code>coalesce(body_search, body)</code> with HTML tag stripping via <code>regexp_replace</code>. <code>body_search</code> holds the indexable representation when <code>body</code> is a clean stub (e.g., PDF-sourced documents with <code>body=<a>PDF link</a></code> and <code>body_search=<extracted text></code>). NULL for HTML-sourced documents — the trigger falls back to <code>body</code> directly. See ADR-010.

Weight D is unused.

== CJK languages ==

PostgreSQL built-in text search configurations do not support Chinese, Japanese, or Korean. The <code>simple</code> config produces single-character tokens that are functionally useless for search.

Hard requirement: install pgroonga or zhparser extension when ingesting CJK data.

The trigger sets <code>content_fts</code> to NULL for CJK. A separate pgroonga index on body handles CJK search:

<syntaxhighlight lang="sql">
-- When pgroonga is available:
CREATE INDEX idx_doc_pgroonga ON corpus.documents
USING pgroonga (body) WHERE language IN ('zh', 'ja', 'ko');
</syntaxhighlight>

The search engine routes CJK queries to pgroonga and non-CJK queries to tsvector.

== Partial GIN indexes ==

FTS GIN indexes are split per kind for performance isolation:

<syntaxhighlight lang="sql">
CREATE INDEX idx_doc_fts_legislation ON corpus.documents USING GIN (content_fts) WHERE kind = 'legislation';
CREATE INDEX idx_doc_fts_decision ON corpus.documents USING GIN (content_fts) WHERE kind = 'decision';
CREATE INDEX idx_doc_fts_record ON corpus.documents USING GIN (content_fts) WHERE kind = 'record';
CREATE INDEX idx_doc_fts_notice ON corpus.documents USING GIN (content_fts) WHERE kind = 'notice';
</syntaxhighlight>

Reindexing annotations (graph layer) does not touch corpus FTS indexes. Bulk ingestion of one kind does not bloat another kind's GIN index.

== Accent-insensitive search ==

<code>unaccent()</code> is applied in the trigger before tokenization. Requires the <code>unaccent</code> PostgreSQL extension. Ensures "responsabilite" matches "responsabilité".

The search engine must also apply <code>unaccent()</code> to the query:

<syntaxhighlight lang="sql">
websearch_to_tsquery(cfg, unaccent(corpus.normalize_for_fts(jurisdiction, query)))
</syntaxhighlight>

[[Category:Corpus]]

MCP/Guidelines/Core

Nicolas — Thu, 23 Apr 2026 02:12:00 GMT

Create MCP/Guidelines/Core page from core.md (via create-page on MediaWiki MCP Server)

Show changes

Corpus/Temporal

Nicolas — Thu, 23 Apr 2026 02:10:58 GMT

Import from duralex/spec/TEMPORAL.md — faithful conversion to wikitext (via create-page on MediaWiki MCP Server)

New page

= Temporal Model =

== Overview ==

Legal documents exist in time. Articles are versioned (valid_from/valid_until). Decisions are point-in-time events. The schema handles both with the same promoted columns.

== date and date_end semantics by kind ==

{| class="wikitable"
! kind !! date = !! date_end =
|-
| legislation (statute, versioned article) || valid_from (entry into force) || valid_until (repeal, amendment)
|-
| legislation (decree, regulation) || publication_date or entry_into_force || expiration (if any)
|-
| legislation (collective agreement) || filing_date or effective_date || expiration_date
|-
| legislation (guidance, circular) || publication_date || NULL (until superseded)
|-
| legislation (bill, debate) || publication_date || NULL
|-
| decision || decision_date || NULL
|-
| record (company) || creation_date || closure_date
|-
| record (person) || NULL || NULL
|-
| notice || publication_date || NULL
|-
| section || NULL || NULL
|-
| chunk || (inherited from parent) || NULL
|}

== Article versioning ==

Multiple versions of the same article = multiple documents with the same <code>tags.cid</code> (permanent article identity) and different date/date_end ranges.

<syntaxhighlight lang="sql">
-- Get the version of article 1147 CC in force on 2015-06-15
SELECT * FROM corpus.documents
WHERE tags->>'cid' = 'LEGISCTA000006136353'
AND date <= '2015-06-15'
AND (date_end IS NULL OR date_end > '2015-06-15')
ORDER BY date DESC LIMIT 1;
</syntaxhighlight>

<code>tags.cid</code> is the permanent identity (CID from LEGI XML, or equivalent). It survives renumbering. Article 1382 and article 1240 have different <code>id</code> values but the relationship is captured in <code>corpus.edges kind=replaces</code>.

== at_date in TagQuery ==

The reference resolver supports temporal queries via at_date:

<syntaxhighlight lang="python">
TagQuery(
language="fr",
kind="legislation",
tag_filters=TagFilterSet.from_tags({"article_number": "1147", "code": "Code civil"}),
at_date=date(2015, 6, 15),
)
</syntaxhighlight>

Translated to SQL:
<syntaxhighlight lang="sql">
WHERE language = 'fr'
AND kind = 'legislation'
AND tags @> '{"article_number": "1147", "code": "Code civil"}'
AND date <= '2015-06-15'
AND (date_end IS NULL OR date_end > '2015-06-15')
ORDER BY date DESC LIMIT 1
</syntaxhighlight>

== Non-Gregorian calendars ==

The <code>date</code> column always stores ISO/Gregorian dates. The original calendar representation is preserved in tags:

{| class="wikitable"
! Calendar !! Tag !! Example !! Used by
|-
| Islamic (Hijri) || tags.date_hijri || "1445-08-15" || SA, AE, other ME
|-
| Japanese imperial era || tags.date_era_jp || "R06" (Reiwa 6 = 2024) || JP
|-
| Taiwan ROC (Minguo) || tags.date_roc_tw || "112" (= 2023) || TW
|}

Conversion is done at ingestion time. The trigger and all queries use the ISO date column.

== Enforcement status ==

For versioned text documents, <code>tags.enforcement_status</code> tracks the legal force:

{| class="wikitable"
! Status !! Meaning
|-
| in_force || Currently applicable
|-
| deferred_enforcement || Not yet in force, will be on a future date
|-
| deferred_repeal || Currently in force, repeal scheduled for a future date
|-
| repealed || Explicitly repealed by a subsequent act
|-
| superseded || Historical version — a newer version of the same article exists
|-
| never_in_force || Modified before its effective date, never applied
|-
| expired || Lapsed by its own terms (sunset clause, fixed-duration text)
|-
| annulled || Struck down by a court (e.g. constitutional review) — typically retroactive
|-
| transferred || Content moved to a different article or location (renumbering)
|-
| denounced || Collective agreement repudiated by one of the parties
|-
| disjoined || Version split into multiple separate articles
|-
| conditional || In force only under a specific interpretation (constitutional reservation)
|-
| pending || Emergency decree or provisional measure awaiting ratification
|}

The boolean shortcut <code>tags.in_force</code> (true/false) enables simple filtering. Unlike <code>enforcement_status</code>, which is set once at ingest from the source data, <code>in_force</code> is dynamically recomputed by the <code>refresh_in_force</code> post-ingest job from the article's <code>date</code> and <code>date_end</code> columns. The two tags can therefore diverge over time:

* An article tagged <code>deferred_enforcement</code> becomes <code>in_force=true</code> once its effective <code>date</code> is in the past (the tag is not rewritten — only the boolean).
* An article tagged <code>deferred_repeal</code> becomes <code>in_force=false</code> once its <code>date_end</code> is in the past.
* An article tagged <code>in_force</code> becomes <code>in_force=false</code> if its <code>date</code> is in the future (rare — late-published versions).
* All other "not in force" states (<code>repealed</code>, <code>superseded</code>, <code>expired</code>, <code>annulled</code>, <code>transferred</code>, <code>denounced</code>, <code>never_in_force</code>, <code>disjoined</code>) are always <code>in_force=false</code>.

In short: <code>enforcement_status</code> answers "what is the legal lifecycle state of this version?", while <code>in_force</code> answers "is this version currently legally applicable?". Use <code>in_force</code> for filter queries, <code>enforcement_status</code> for display and warnings.

== Transitional provisions ==

When a reform includes transitional rules (e.g., the 2016 French contract law reform: contracts signed before Oct 1, 2016 governed by old law), these are modeled as:
* A separate document (the transitional provision article)
* With edges to both the old and new versions
* The knowledge graph (future) encodes transitional provisions as QUALIFY nodes that route to the correct version based on temporal context

[[Category:Corpus]]

Corpus/Quality

Nicolas — Thu, 23 Apr 2026 02:10:16 GMT

Import from duralex/spec/QUALITY.md — faithful conversion to wikitext (via create-page on MediaWiki MCP Server)

New page

= Content Quality =

== Two quality axes ==

The system tracks two independent quality dimensions:

=== 1. Content quality (tags.content_quality on corpus documents) ===

Quality of the text in <code>body</code>. Progression:

{| class="wikitable"
! Level !! Description !! Searchable? !! Reliable for display?
|-
| ocr_raw || OCR extraction, errors likely || Degraded FTS || No -- warn user
|-
| ocr_cleaned || OCR cleaned by regex or LLM || Better FTS || Partially
|-
| native_raw || Native text (PDF text layer, .doc), structure lost || Good FTS || Yes, but no structure
|-
| native_structured || Structured source (HTML Legifrance, XML Akoma Ntoso) || Optimal FTS || Yes
|-
| machine_reviewed || Reviewed/corrected by LLM || Optimal FTS || Yes
|-
| human_reviewed || Reviewed by a human || Optimal FTS || Yes
|-
| jurist_reviewed || Validated by a jurist || Optimal FTS || Yes (gold standard)
|}

Only the current level is stored. Progression is one-way (except disputes).

=== 2. Annotation confidence (on graph.annotations -- future, documented here for reference) ===

Quality of knowledge graph annotations. Separate from content quality.

{| class="wikitable"
! Method !! Confidence !! Meaning
|-
| stub || stub || Placeholder, not yet created
|-
| llm || memory_only || LLM-generated, not verified against source
|-
| llm || source_checked || Verification pass confirmed citation exists
|-
| llm || cross_validated || Cross-validation confirmed consistency
|-
| human || (any) || Non-expert human reviewed
|-
| jurist || (any) || Legal professional validated
|}

Progression: stub -> memory_only -> source_checked -> cross_validated. Can be downgraded to <code>disputed</code>.

=== How they interact ===

A corpus document has content_quality. An annotation on that document has its own confidence. The weakest link determines the trust of any reasoning path:
* An annotation with confidence=cross_validated on a document with content_quality=ocr_raw is still unreliable (the source text may have OCR errors that corrupted the annotation).
* A high-quality document (native_structured) with a stub annotation has no knowledge graph coverage yet.

== Impact on the system ==

* '''MCP tools''': display warnings for content_quality < native_structured
* '''Knowledge graph''': propagate minimum confidence in reasoning paths
* '''Quality pipeline''': prioritize ocr_raw documents for LLM cleaning, then for annotation
* '''body_search''': documents with content_quality >= machine_reviewed should have body_search populated with cleaned text

[[Category:Corpus]]

Corpus/Edge types

Nicolas — Thu, 23 Apr 2026 02:09:48 GMT

Import from duralex/spec/EDGE-TYPES.md — faithful conversion to wikitext (via create-page on MediaWiki MCP Server)

New page

= Edge Types =

Edge types (stored in <code>corpus.edges.kind</code>) form an open vocabulary — new types are added when data sources provide them. This document lists all known types organized by category.

The <code>properties</code> JSONB column on edges carries type-specific metadata (grounds for partial cassation, commencement date, reservation text, confidence, etc.).

== Universality ==

Edge kinds have varying degrees of cross-jurisdiction applicability. '''Universal''' kinds (amends, repeals, cites, interprets...) appear in 3+ legal traditions and are documented here. '''Multi-jurisdiction''' kinds (cassation_of, preliminary_reference_to...) appear in 2+ jurisdictions. '''Local''' kinds (establishes_jurisprudencia, violates...) are specific to one legal system and documented in the emitting plugin. This is a documentation convention, not a runtime constraint — the <code>kind</code> column has no enum. See ADR: edge pipeline architecture (design-decisions/2026-04-22-edge-pipeline-architecture.md).

== Category 1: Textual modification (legislation <-> legislation) ==

{| class="wikitable"
! Edge kind !! Direction !! Description !! Open data
|-
| amends || A->B || A amends B (umbrella term). Alias: <code>modifies</code> (FR LEGI: MODIFIE/MODIFICATION) || FR LEGI, UK legislation.gov.uk, IT normattiva
|-
| inserts || A->B || A inserts text into B || UK legislation.gov.uk
|-
| substitutes || A->B || A substitutes text in B || UK legislation.gov.uk
|-
| omits || A->B || A removes text from B || UK legislation.gov.uk
|-
| rectifies || A->B || A corrects an error in B (no policy change). FR LEGI: RECTIFICATION/RECTIFIE || FR LEGI, EU corrigenda, EU CELLAR <code>resource_legal_corrects_resource_legal</code>
|-
| renumbers || A->B || A renumbers provisions in B. Alias: <code>moves</code> (FR LEGI: DEPLACE/DEPLACEMENT) || FR LEGI
|}

== Category 2: Lifecycle / legal force ==

{| class="wikitable"
! Edge kind !! Direction !! Description !! Open data
|-
| repeals || A->B || A repeals B entirely || FR LEGI, UK, all
|-
| repeals_in_part || A->B || A repeals specific provisions of B || UK legislation.gov.uk
|-
| creates || A->B || A creates/establishes B || FR LEGI
|-
| expires || A->B || B expires by operation of A (or by its own sunset clause). FR LEGI: PERIME/PEREMPTION, PERIME_NVCC_IDCC/PEREMPTION_NVCC_IDCC || FR LEGI
|-
| suspends || A->B || A temporarily suspends B || Rare in open data
|-
| revives || A->B || A revives previously suspended/repealed B || UK
|-
| saves || A->B || A carves B out from a wider repeal || UK legislation.gov.uk
|-
| extends || A->B || A extends the application of B (territorial, temporal, or personal scope). FR LEGI: EXTENSION/ETEND, ADHESION/ADHERE, ELARGISSEMENT/ELARGIT || FR labor (extension), UK
|-
| restricts || A->B || A restricts the scope of B || UK legislation.gov.uk
|-
| annuls || A->B || A annuls B (judicial or legislative) || FR LEGI
|-
| denounces || A->B || A terminates convention/treaty B || FR labor conventions
|-
| disjoins || A->B || A splits a relationship between two texts || FR LEGI
|-
| converts || A->B || Parliament converts emergency decree A into law B || IT, FR (ordonnance), ES, BR (medida provisoria)
|}

== Category 3: Hierarchical / delegation ==

{| class="wikitable"
! Edge kind !! Direction !! Description !! Open data
|-
| implements || A->B || A implements/applies B (implementing regulation -> framework law). FR LEGI: APPLICATION/APPLIQUE, SPEC_APPLI || FR LEGI, EU
|-
| transposes || A->B || A transposes EU directive B into national law. FR LEGI: TRANSPOSITION, DIRECTIVE_EUROPEENNE || EU CELLAR NIM, FR LEGI
|-
| commences || A->B || Commencement order A brings B into force || UK legislation.gov.uk
|-
| enables || A->B || A grants power to make B (delegation) || Extraction
|-
| made_under || A->B || A is made under authority of B || UK
|-
| ratifies || A->B || A ratifies treaty B || FR LEGI
|-
| codifies || A->B || A codifies standalone text B into a code || FR LEGI
|-
| based_on || A->B || A has B as treaty base (EU) || EU
|-
| requires_implementation || A->B || A requires implementing measure B to be applicable. Properties: <code>{status: "applied"|"pending"|"moot", measure_object: "..."}</code> || FR Baromètre AN
|-
| supplements || A->B || A adds sectoral provisions to framework B || EU
|-
| complies_with || A->B || A ensures compliance with standard/rule B || EU, compliance
|-
| derogates_from || A->B || A explicitly derogates from B || EU, FR
|-
| adopts || A->B || A adopts the text of B (Council decision adopting a regulation/directive) || EU CELLAR <code>resource_legal_adopts_resource_legal</code>
|}

== Category 4: Cross-reference / concordance ==

{| class="wikitable"
! Edge kind !! Direction !! Description !! Open data
|-
| cites || A->B || A cites B (neutral reference). FR LEGI: CITATION, RENVOI/RENVOIT, CITATION_JURI_LEGI || FR LEGI, EU CELLAR <code>work_cites_work</code>, ECHR HUDOC <code>extractedappno</code>
|-
| replaces || A->B || A replaces B (renumbering: article 1240 replaces 1382). FR LEGI: TEXTE_SUITE || FR LEGI
|-
| corresponds_to || A<->B || A and B are concordant (synchronized texts) || FR LEGI
|-
| transfers || A->B || A moved provision from B to another location || FR LEGI
|-
| source_text || A->B || B is the source text that A codifies/implements || FR LEGI
|-
| associated_text || A<->B || A and B are associated texts. FR LEGI: TXT_ASSOCIE, RATTACHEMENT/RATTACHE || FR LEGI
|-
| pilot_follower || A<->B || A and B are synchronized (labor: pilot/follower) || FR LEGI
|-
| historical || A->B || Historical link between A and B || FR LEGI
|-
| consolidates || A->B || A consolidates multiple texts including B || All, EU CELLAR <code>act_consolidated_consolidates_resource_legal</code>
|-
| language_variant || A<->B || A and B are language versions of the same document || Multilingual jurisdictions
|}

== Category 5: Judicial treatment (decision <-> decision) ==

=== Negative treatments ===

{| class="wikitable"
! Edge kind !! Direction !! Description
|-
| overrules || A->B || A overrules B (B's ratio is no longer good law)
|-
| partially_overrules || A->B || A overrules B on specific grounds. Properties: <code>{grounds: [...]}</code>
|-
| reverses || A->B || A reverses B in the same case (appellate)
|-
| vacates || A->B || A vacates B (US)
|-
| not_followed || A->B || A explicitly declines to follow B
|-
| criticizes || A->B || A criticizes reasoning in B
|-
| doubts || A->B || A expresses doubt about B
|-
| limits || A->B || A narrows the scope of B without overruling
|-
| distinguishes || A->B || A distinguishes its facts from B (rule in B does not apply)
|}

=== Positive treatments ===

{| class="wikitable"
! Edge kind !! Direction !! Description
|-
| follows || A->B || A follows the reasoning of B
|-
| applies_rule_of || A->B || A applies the rule established in B
|-
| affirms || A->B || A affirms B in the same case (appellate)
|-
| confirms || A->B || A confirms B's position on a legal question
|-
| explains || A->B || A explains or clarifies B
|-
| harmonizes || A->B || A reconciles B with another apparently conflicting decision
|}

=== Procedural relationships ===

{| class="wikitable"
! Edge kind !! Direction !! Description
|-
| appeal_of || A->B || A is an appeal of B
|-
| cassation_of || A->B || A is a cassation review of B (civil law)
|-
| remanded_from || A->B || A results from remand by B
|-
| preliminary_reference_to || A->B || National court A refers question to CJEU/constitutional court B
|-
| answers_preliminary_reference || A->B || A answers the preliminary reference from B
|-
| constitutional_reference_to || A->B || A refers constitutionality question to constitutional court B (FR QPC, IT, DE)
|-
| joined_with || A<->B || A and B are joined cases
|-
| reviews || A->B || A reviews B (generic procedural link). FR LEGI: SUITE_PROCEDURALE
|-
| opinion_for || A->B || A is an opinion/conclusion for case B (rapporteur public, AG opinion, amicus). Properties: <code>{role: "rapporteur_public"|"avocat_general"|"amicus_curiae"}</code>
|-
| referred_to_grand_chamber || A->B || Chamber judgment A was referred to Grand Chamber, resulting in judgment B. ECHR (deferred — requires re-ingest with new fields)
|-
| execution_of || A->B || Execution supervision document A monitors compliance with judgment B. ECHR HUDOC-EXEC (deferred — requires HUDOC-EXEC ingestion)
|-
| case_group_member || A->B || Judgment A belongs to the execution group led by judgment B. ECHR HUDOC-EXEC (deferred — requires HUDOC-EXEC ingestion)
|}

== Category 6: Decision <-> legislation ==

{| class="wikitable"
! Edge kind !! Direction !! Description
|-
| interprets || A->B || Decision A interprets provision B. FR LEGI: JURISPRUDENTIEL. EU CELLAR <code>case-law_interpretes_resource_legal</code>, FR LEGI
|-
| declares_unconstitutional || A->B || Decision A declares B unconstitutional
|-
| declares_constitutional || A->B || Decision A declares B constitutional
|-
| declares_constitutional_with_reservation || A->B || A declares B constitutional under specific interpretation. Properties: <code>{reservation: "..."}</code>
|-
| annuls || A->B || Administrative court A annuls administrative act B (same edge kind as Category 2 <code>annuls</code>)
|-
| quashes || A->B || A quashes B (UK judicial review)
|-
| disapplies || A->B || A disapplies national law B (EU primacy). Also: plea of illegality (Art. 277 TFEU). EU CELLAR <code>case-law_incidentally_declares_void_resource_legal</code>
|-
| states_infringement_of || A->B || Infringement judgment A declares member state failure to comply with directive/regulation B (Art. 258 TFEU). EU CELLAR <code>case-law_states_failure_concerning_resource_legal</code>
|-
| violates || A->B || Judgment A finds a violation of Convention article B. ECHR (deferred — requires Convention text ingestion)
|}

== Category 7: Civil law doctrine-specific ==

{| class="wikitable"
! Edge kind !! Direction !! Description !! Country
|-
| establishes_jurisprudencia || A->B || 5th concordant decision A makes tesis B binding || MX
|-
| interrupts_jurisprudencia || A->B || Contradictory decision A breaks the reiteracion chain of tesis B || MX
|-
| substitutes_jurisprudencia || A->B || New tesis A replaces old tesis B || MX
|-
| establishes_sumula || A->B || Decision A contributes to creating sumula B || BR
|-
| cancels_sumula || A->B || Decision A cancels sumula B || BR
|-
| guiding_case_reference || A->B || Decision A refers to guiding case B || CN
|-
| judicial_interpretation_of || A->B || SPC interpretation A interprets statute B || CN
|}

== Category 8: Cross-regulation stacking ==

{| class="wikitable"
! Edge kind !! Direction !! Description
|-
| lex_specialis_to || A->B || A prevails over B in their overlap area (lex specialis)
|-
| stacks_with || A<->B || A and B apply concurrently with no displacement
|}

== Notes ==

* All types are directional (A->B) unless marked A<->B.
* The UNIQUE constraint <code>(source_id, target_id, kind)</code> prevents duplicate edges.
* With nullable <code>target_id</code> and PostgreSQL's NULL-is-distinct-from-NULL behavior, multiple unresolved references from the same source are allowed.
* Edge properties carry type-specific metadata:
** <code>partially_overrules</code>: <code>{grounds: ["moyen_2", "moyen_3"], scope: "partial"}</code>
** <code>declares_constitutional_with_reservation</code>: <code>{reservation: "conforme sous reserve que..."}</code>
** <code>commences</code>: <code>{commencement_date: "2024-06-01", extent: "england_and_wales"}</code>
** <code>suspends</code>: <code>{start: "2024-01-01", end: "2024-12-31"}</code>
* The vocabulary is open — new types added when data sources provide them. No enum constraint in the schema.

[[Category:Corpus]]

Corpus/Tag conventions

Nicolas — Thu, 23 Apr 2026 02:08:28 GMT

Import from duralex/spec/TAG-CONVENTIONS.md — faithful conversion to wikitext (via create-page on MediaWiki MCP Server)

New page

= Tag Conventions =

Tags are the primary mechanism for jurisdiction-specific metadata. They live in the <code>tags</code> JSONB column on <code>corpus.documents</code>. This document defines the shared vocabulary — tag keys that have the same meaning across jurisdictions.

Jurisdiction-specific tags (e.g., <code>idcc</code> for French labor conventions, <code>foral</code> for Spanish Basque tax law) are documented in each jurisdiction's plugin, not here.

== General rules ==

* '''Enum / classification tag values MUST be lowercase.''' Values from controlled vocabularies (type, binding, enforcement_status, content_quality, importance_level, legal_branch, etc.) must always be lowercase. No mixed-case, no uppercase. Enforced at ingest time. This ensures deterministic matching and avoids case-sensitivity bugs in filters, discover mode, and tag_stats aggregation.

* '''Data values are stored as-is, queried case-insensitively.''' Values that represent real-world data — company names (denominations like "DANONE"), legal form labels ("SAS", "SARL"), role labels ("Président"), tribunal names, case numbers, ECLI identifiers, NOR codes — are stored in their original case. The MCP search tools already lowercase tag values at query time for case-insensitive matching.

----

== Legal classification ==

=== tags.type (required) ===

The legal nature of the document. This does the work that the old per-table schema did.

Values for <code>kind=legislation</code>:

<pre>
statute, decree, regulation, enforcement_decree, ordinance, order,
collective_agreement, guidance, circular, manual, instruction,
fatwa, tesis, sumula_vinculante, tsūtatsu, judicial_interpretation,
dictamen, acordada, auto_acordado, normative_document,
inquiry_report, bill, debate, question, committee_report,
constitutional_amendment, provisional_measure, technical_standard,
code_of_practice, regulatory_handbook
</pre>

Values for <code>kind=decision</code>:

<pre>
judgment, order, advisory_opinion, enforcement_decision,
constitutional_review, preliminary_ruling, arbitral_award,
tutela, amparo, advance_ruling, administrative_decision
</pre>

Values for <code>kind=record</code>:

<pre>
company, person, property, patent, establishment
</pre>

Values for <code>kind=notice</code>:

<pre>
insolvency, registration, modification, filing, deregistration,
capital_change, merger, liquidation, gazette_publication
</pre>

=== tags.binding (optional) ===

Whether the document creates binding legal obligations.

Values: <code>true</code>, <code>false</code>

=== tags.binding_scope (optional, when binding=true) ===

Who is bound.

Values: <code>erga_omnes</code>, <code>administration</code>, <code>inter_partes</code>, <code>applicant_only</code>, <code>sector</code>

=== tags.legal_tradition (optional) ===

For jurisdictions with mixed legal systems (UAE, ZA, NG).

Values: <code>civil_law</code>, <code>common_law</code>, <code>sharia</code>, <code>customary</code>, <code>mixed</code>, <code>roman_dutch</code>

----

== Document form ==

=== tags.document_form (required for all documents) ===

Editorial/administrative form of the document. Jurisdiction-agnostic. Distinguishes the authoritative text from its editorial variants, notices, opinions, and corrections. See ADR: document_form tag (design-decisions/2026-04-22-document-form-tag.md) for naming rationale.

Values:

{| class="wikitable"
! Value !! Description !! Examples
|-
| <code>canonical_text</code> || Authoritative full text (default) || Judgment, statute, regulation, collective agreement
|-
| <code>editorial_summary</code> || Summary by documentalist/editor || CELEX <code>_res</code>, headnote, syllabus, Leitsatz, massima
|-
| <code>gazette_notice</code> || Publication notice in official gazette || EU OJ-C notice, JORF avis, Federal Register notice
|-
| <code>case_registration</code> || Notice of new case filing || CELEX CN/TN/FN, certified question (US), ICJ memorial
|-
| <code>corrigendum</code> || Correction/erratum || JORF rectificatif, EUR-Lex corrigendum
|-
| <code>consolidated_version</code> || Consolidated text incorporating amendments || EUR-Lex consolidated, UK consolidation act
|-
| <code>amendment</code> || Amending instrument || Avenant (ACCO/KALI), amending regulation
|-
| <code>dissenting_opinion</code> || Dissenting opinion by judge(s) || ECHR, ICJ, SCOTUS, BVerfG Sondervotum
|-
| <code>concurring_opinion</code> || Concurring opinion by judge(s) || ECHR, common law
|-
| <code>separate_opinion</code> || Separate opinion (neutral) || ICJ Art.57, ECHR
|-
| <code>declaration</code> || Brief declaration without detailed reasoning || ICJ, ECHR
|-
| <code>per_curiam</code> || Unsigned opinion attributed to the court || SCOTUS, UKSC
|-
| <code>memorandum_opinion</code> || Brief opinion without detailed reasoning || US federal courts
|}

Default: <code>canonical_text</code> when not specified. Title prefix: when <code>document_form != canonical_text</code>, prefix title with English bracketed label: <code>[Editorial Summary]</code>, <code>[OJ Notice]</code>, <code>[Case Filing]</code>, <code>[Corrigendum]</code>, <code>[Consolidated]</code>, <code>[Amendment]</code>, <code>[Dissenting Opinion]</code>, <code>[Concurring Opinion]</code>, <code>[Separate Opinion]</code>, <code>[Declaration]</code>, <code>[Per Curiam]</code>, <code>[Memorandum]</code>.

----

== Temporal metadata ==

=== tags.enforcement_status (for kind=legislation with versioning) ===

Values:
* <code>in_force</code> — currently applicable
* <code>deferred_enforcement</code> — adopted but not yet in force, will be on a future date
* <code>deferred_repeal</code> — currently in force, repeal scheduled for a future date
* <code>repealed</code> — explicitly repealed by a subsequent act
* <code>superseded</code> — historical version, a newer version of the same article exists
* <code>never_in_force</code> — modified before its effective date, never applied
* <code>expired</code> — lapsed by its own terms (sunset clause, fixed-duration text)
* <code>annulled</code> — struck down by a court (e.g. constitutional review) — typically retroactive
* <code>transferred</code> — content moved to a different article or location (renumbering)
* <code>denounced</code> — collective agreement repudiated by one of the parties
* <code>disjoined</code> — version split into multiple separate articles
* <code>conditional</code> — in force only under a specific interpretation (constitutional reservation)
* <code>pending</code> — emergency decree or provisional measure awaiting ratification

=== tags.in_force (boolean shortcut) ===

Values: <code>true</code>, <code>false</code>

=== tags.status (for provisional instruments: BR medida provisoria, AR DNU) ===

Values: <code>in_force</code>, <code>pending_ratification</code>, <code>converted</code>, <code>rejected</code>, <code>lapsed</code>

=== tags.last_modified (optional, ISO date) ===

Date the source last modified this document editorially. Distinct from <code>date</code> (legal effect date) and from ingestion timestamps. Populated when the source exposes it (BOFiP <code>bodgfip:date_modification</code>, Judilibre <code>update_date</code>, KALI <code>DATE_PUBLI</code>).

=== tags.date_published (optional, ISO date) ===

Date the document was officially published (e.g. in the Journal Officiel, Official Gazette, EUR-Lex). Distinct from <code>date</code> (legal effect date) which may be later (deferred enforcement). Populated when source exposes it and it differs from <code>date</code>.

----

== Non-Gregorian calendars ==

ISO date in the promoted <code>date</code> column. Original calendar representation in tags.

=== tags.date_hijri ===

Islamic (Hijri) calendar date. Format: <code>"YYYY-MM-DD"</code> in Hijri.

Used by: SA, AE, other Middle Eastern jurisdictions.

=== tags.date_era_jp ===

Japanese imperial era year. Format: era letter + 2-digit year (e.g., <code>"R06"</code> = Reiwa 6 = 2024).

Used by: JP.

=== tags.date_roc_tw ===

Republic of China (Minguo) year. Format: 3-digit year (e.g., <code>"112"</code> = 2023).

Used by: TW.

----

== Content quality ==

=== tags.content_quality (required for all documents) ===

The quality level of the text in <code>body</code>.

Values (progression order):

<pre>
ocr_raw — OCR extraction, errors likely
ocr_cleaned — OCR cleaned by regex or LLM
native_raw — native text (PDF text layer, .doc), structure lost
native_structured — structured source (HTML Legifrance, XML Akoma Ntoso, API JSON)
machine_reviewed — reviewed/corrected by LLM
human_reviewed — reviewed by a human
jurist_reviewed — validated by a jurist (highest confidence)
</pre>

Only the current level is stored. History is not tracked.

Critical for:

* Knowledge graph trust chains (annotations on <code>ocr_raw</code> docs have lower confidence)
* User-facing warnings ("this text may contain OCR errors")
* Quality pipeline prioritization

----

== Sub-jurisdiction ==

=== tags.sub_jurisdiction ===

For legal enclaves or devolved entities within a jurisdiction that have their own legal system.

Examples: <code>difc</code>, <code>adgm</code> (UAE free zones with English common law courts).

The <code>jurisdiction</code> column carries the country; this tag carries the enclave.

----

== Internal tags ==

Tags prefixed with <code>_</code> are internal: never displayed to users, excluded from discover mode, excluded from <code>tag_stats</code>. Used for computed values needed by the search engine. Populated at ingestion time by jurisdiction plugins.

----

== Quality flags ==

=== tags.need_fixing ===

Marker that the document has a known data quality issue that should be revisited later. The value is the ''category'' of the problem so we can group records by what needs to be done:

* <code>date</code> — one or more date columns were nullified at ingest time because the source published an aberrant value (DILA sentinels like <code>2999-01-01</code> in the wrong column, INPI <code>9999-12-31</code>, manual typos like <code>5489-12-30</code> or <code>3023-04-03</code>). The original raw value is lost; recovering it requires re-fetching from the source. Used by <code>duralex.ingest.date_validation.validate_date</code>.

The tag is intentionally a single string and not an array — one flag per document is enough for now. If we ever need to track multiple issue categories on the same document, switch to an array.

----

== Precedent, publication, and importance ==

=== tags.is_precedent (boolean) ===

Formally designated as binding precedent.

Used by: FI (ennakkopäätös), PL (uchwala zasada prawna), CN (guiding case).

=== tags.official_grade (string, kind=decision) ===

Official publication/importance grade assigned by the jurisdiction. Values are jurisdiction-specific, documented per plugin. Absent when the source has no grading system.

The grade is relative to the issuing court — a high grade from a first-instance court is not equivalent to the same grade from a supreme court. The real importance depends on the (court, grade) pair.

Known values by jurisdiction:

{| class="wikitable"
! Jurisdiction !! Source !! Values (highest → lowest)
|-
| FR admin (CE, TdC) || JADE <code>PUBLI_RECUEIL</code> || <code>A</code>, <code>B</code>
|-
| FR admin (cour_administrative_appel, tribunal_administratif) || JADE <code>PUBLI_RECUEIL</code>, CE opendata <code>Code_Publication</code> || <code>R</code>, <code>C+</code>, <code>C</code>, <code>D</code>, <code>Z</code>
|-
| FR cass (post-2021) || Judilibre <code>publication</code> || <code>rapport</code>, <code>bulletin</code>, <code>diffuse</code>, <code>non_diffuse</code>
|-
| FR cass (pre-2021) || Judilibre <code>publication</code>, DILA XML || <code>rapport</code>, <code>bulletin</code>, <code>bulletin_information</code>, <code>internet</code>, <code>diffuse</code>
|-
| ECHR || HUDOC <code>importance</code> || <code>1</code>, <code>2</code>, <code>3</code>, <code>4</code>
|-
| CJEU || CELLAR <code>erecueil</code> + CELEX sector || <code>ecr_grand_chamber</code>, <code>ecr_chamber</code>, <code>oj_only</code>, <code>unpublished</code>
|-
| DE || juris <code>Dokumenttyp</code> || <code>amtlicher_leitsatz</code>, <code>orientierungssatz</code>, <code>redaktioneller_leitsatz</code>
|-
| CH || bger.ch || <code>atf</code>, <code>atf_partial</code>, <code>online_only</code>
|-
| US || CourtListener || <code>precedential</code>, <code>non_precedential</code>
|-
| CN || SPC database || <code>guiding</code>, <code>reference</code>, <code>typical</code>, <code>gazette</code>, <code>ordinary</code>
|-
| MX || SJF || <code>jurisprudencia</code>, <code>precedente</code>, <code>tesis_aislada</code>
|-
| IT || CED || <code>sezioni_unite_massima</code>, <code>massima</code>, <code>no_massima</code>
|-
| UK || ICLR || <code>law_reports</code>, <code>wlr_2_3</code>, <code>wlr_1</code>, <code>wlr_4</code>, <code>all_er</code>, <code>unreported</code>
|-
| FR fond (cour_appel, tribunal_judiciaire, tribunal_commerce) || Judilibre <code>particularInterest</code> || <code>particular_interest</code>
|-
| FR financial (CdC, CRC, CDBF, CAF) || Légifrance <code>publicationRecueil</code> || <code>recueil</code>
|}

=== tags.importance_level (string, computed) ===

Harmonized importance score derived from <code>official_grade</code> by jurisdiction plugins. NOT an official classification — computed by Dura Lex for cross-jurisdiction search and FTS ranking. Applies to <code>kind=decision</code> and <code>kind=legislation</code> (for authoritative guidance like BOFiP fiscal doctrine). Absent when no importance signal is available. BOFiP documents are always <code>high_importance</code> (no per-document grading from the source).

Values (ascending importance): <code>minimal_importance</code>, <code>low_importance</code>, <code>medium_importance</code>, <code>high_importance</code>, <code>highest_importance</code>.

=== tags._importance_level_default (string, internal) ===

Internal tag for FTS ranking, never displayed. Always set for documents that have importance signals (<code>kind=decision</code>, <code>kind=legislation</code> with authoritative guidance). Equals <code>importance_level</code> when available, else derived from <code>court_level</code>:

* <code>supreme</code>, <code>constitutional</code>, <code>supranational</code> → <code>medium_importance</code>
* <code>appellate</code> → <code>low_importance</code>
* <code>first_instance</code> → <code>minimal_importance</code>
* <code>court_level</code> absent or null → <code>unknown_importance</code>

=== tags.formation_solemnity (string, computed, kind=decision) ===

Standardized bench type derived from <code>formation</code> by jurisdiction plugins. NOT an official classification — computed by Dura Lex for cross-jurisdiction comparison and display. Absent when formation is unknown.

Values (ascending solemnity): <code>single_judge</code>, <code>reduced_bench</code>, <code>standard_bench</code>, <code>combined_chambers</code>, <code>grand_bench</code>, <code>full_court</code>.

=== tags.court_level (string, kind=decision) ===

Position of the issuing court in the judicial hierarchy. Cross-jurisdiction handle for filtering by instance. Distinct from <code>court</code> (the name) and from <code>formation_solemnity</code> (the bench that heard the case). Null (absent) for non-judicial authorities (CNIL, CADA, AMF, Défenseur des droits) and for sui generis bodies that don't fit the hierarchy (Tribunal des conflits).

Values:

* <code>first_instance</code> — trial courts (FR tribunal judiciaire, tribunal de commerce, tribunal administratif, conseil de prud'hommes; EU General Court, Civil Service Tribunal)
* <code>appellate</code> — appeal courts (FR cour d'appel, cour administrative d'appel, tribunal supérieur d'appel)
* <code>supreme</code> — apex ordinary courts (FR Cour de cassation, Conseil d'État)
* <code>constitutional</code> — constitutional review bodies (FR Conseil constitutionnel, DE BVerfG, IT Corte Costituzionale)
* <code>supranational</code> — international/supranational courts (CJEU Court of Justice, ECHR, ICJ)

See ADR: Tag tier architecture (design-decisions/2026-04-22-tag-tier-architecture.md) for the per-jurisdiction mapping rationale.

----

== Collective bargaining ==

=== tags.bargaining_level (string, kind=legislation, type=collective_agreement) ===

Level at which a collective agreement was negotiated. ILO/OECD standard terminology. Applies to collective agreements and amendments (<code>avenants</code>).

Values:

* <code>enterprise</code> — company-level (FR <code>entreprise</code>, including group and establishment agreements)
* <code>sectoral</code> — industry/branch-level (FR <code>branche</code>)
* <code>inter_sectoral</code> — cross-industry, national (FR <code>interprofessionnel</code>, e.g. ANI)
* <code>territorial</code> — geographically scoped (regional, departmental)

Renames the former FR-specific <code>level</code> key.

----

== Administrative subclassification ==

=== tags.subcategory (string, optional) ===

Subclassification finer than <code>type</code>. T2: key is shared across jurisdictions, value vocabularies are controlled per plugin and listed in that plugin's documentation. Used primarily on <code>kind=notice</code> (BODACC event types) and on records (RCS filing subtypes). Values are English lowercase, slugified — translated from source classifications so they are portable across tools.

Per-plugin value lists live in <code>duralex-ingest-fr/docs/FR-TAGS.md</code> and equivalents.

----

== Source-native classifications (T3) ==

Some tag keys hold values that mirror the source's own taxonomy rather than a Dura Lex enum. These keys are documented per plugin, not here, and are intended for intra-jurisdiction precision filters. Values are slugified at ingest time (lowercase, no accents, spaces → underscores) so that queries remain deterministic.

=== tags.nature (string) ===

Source-native document classification (e.g. FR <code>arret</code>, <code>ordonnance</code>, <code>loi_organique</code>, <code>qpc</code>). T3 source-fidelity — values are plugin-specific. For cross-jurisdiction search, prefer <code>type</code> and <code>document_form</code>; use <code>nature</code> for jurisdiction-local precision (e.g. distinguishing QPC from an ordinary Conseil constitutionnel decision).

Slugification (accent removal + space → underscore) is applied centrally at ingest time by <code>duralex.ingest.tag_normalization.normalize_tag_value</code>.

Known tech debt: EU <code>nature</code> values are French-origin slugs because CJEU ingestion sources French documents first. See ADR: Tag tier architecture (design-decisions/2026-04-22-tag-tier-architecture.md).

----

== Legal branch ==

=== tags.legal_branch (array, kind=legislation only) ===

Branch(es) of law. Populated at ingest from code→branch mapping (deterministic). Decisions: LLM-enriched (future).

Values: <code>civil</code>, <code>criminal</code>, <code>administrative</code>, <code>commercial</code>, <code>social</code>, <code>tax</code>, <code>constitutional</code>, <code>environmental</code>, <code>consumer</code>, <code>ip</code>, <code>public_procurement</code>, <code>health</code>, <code>family</code>, <code>real_estate</code>, <code>digital</code>

----

== Translation ==

=== tags.translation_of ===

ID of the original document this is a translation of. Present only on translated documents, not on originals.

=== tags.translation_quality ===

Quality of the translation. Present only on documents that are translations or language variants.

Values:
* <code>official</code> — equally authoritative version (EU texts in 24 languages, BE/FI/CH bilingual laws). No single original exists.
* <code>official_translation</code> — official translation without equal legal force
* <code>machine_translated</code> — LLM translation, not verified
* <code>human_reviewed</code> — translation reviewed by bilingual human

=== tags.translation_pending ===

ISO 639-1 code of the target language for which a translation is pending. Set on documents whose original language differs from the user's primary language and that have not yet been translated. Removed once a <code>language_variant</code> edge is created linking to the translated version.

Used by the LLM enrichment script (<code>enrich_translations.py</code>) to find candidates for machine translation:
<syntaxhighlight lang="sql">
SELECT id, body, body_search FROM corpus.documents
WHERE jurisdiction='eu' AND tags->>'translation_pending' = 'fr'
</syntaxhighlight>

=== ID convention for language variants ===

* '''EU texts''' (all versions equally authoritative): every version has a language suffix. No version is "the original."
<pre>
eu.celex:32016r0679:fr language=fr, tags.translation_quality=official
eu.celex:32016r0679:en language=en, tags.translation_quality=official
eu.celex:32016r0679:de language=de, tags.translation_quality=official
</pre>

* '''National texts with translations''' (one original, others are translations): the original has no suffix. Translations have <code>:lang</code> suffix and <code>tags.translation_of</code> pointing to the original.
<pre>
fr.legiarti000006902764 language=fr (original, no suffix)
fr.legiarti000006902764:en language=en, tags.translation_of=fr.legiarti000006902764
</pre>

All language variants are linked by <code>language_variant</code> edges. The edge target is chosen by convention (alphabetical or first ingested) — no version is inherently canonical for equally authoritative texts.

----

== Identifiers ==

=== tags.text_id (kind=legislation and chunk) ===

Cross-language canonical identifier of the underlying legal work. Equal across all language variants of the same text — does NOT carry the <code>:lang</code> suffix that the document <code>id</code> column carries. Used by reference resolvers to find a text regardless of language.

Example:
<pre>
id = "eu.eurlextext32016r0679:fr" tags.text_id = "eu.eurlextext32016r0679"
id = "eu.eurlextext32016r0679:en" tags.text_id = "eu.eurlextext32016r0679"
</pre>

Both rows match a search by <code>text_id = "eu.eurlextext32016r0679"</code>. The search engine then narrows by user language via the <code>language</code> filter on <code>TagQuery</code>.

For articles and sections, <code>tags.text_id</code> points to the parent text (also without <code>:lang</code> suffix), enabling cross-language navigation: an article in the EN version of GDPR has the same <code>text_id</code> as the corresponding article in the FR version.

=== tags.eli ===

ELI (European Legislation Identifier) URI when provided by source. Not all jurisdictions support ELI.

=== tags.celex ===

CELEX identifier for EU documents (EUR-Lex primary key). Format: sector digit + 4-digit year + type letter(s) + ordinal (e.g. <code>32016R0679</code> for GDPR). Redundant with the document ID (<code>EU.CELEX:32016R0679</code>) but useful for tag-based filtering and discovery.

=== tags.ecli (kind=decision) ===

ECLI (European Case Law Identifier). Stored upper-case with whitespace stripped (ECLIs are case-insensitive per the EU spec but published mixed-case across sources). Normalization happens at ingest time via <code>duralex.ingest.tag_normalization.normalize_ecli</code> so dedup queries can match cross-source via a single partial expression index.

=== tags.case_number (array, kind=decision) ===

Display form of the case number(s), as published by the source. Multiple aliases allowed. Used for human-readable presentation only.

=== tags.case_number_normalized (array, kind=decision) ===

Indexable form of the case number(s) for cross-source dedup matching. Built at ingest time by <code>duralex.ingest.tag_normalization.normalize_case_number_list</code> which strips dots and whitespace while preserving dashes, slashes and letters (matches the historical <code>replace(., '.', '')</code> semantics so we don't introduce cross-court false positives like CASS <code>22-13456</code> colliding with CAPP <code>22/13456</code>). Backed by partial GIN <code>jsonb_path_ops</code> index <code>idx_doc_decision_case_number_normalized</code> for <code>@></code> containment queries.

----

== Original document reference ==

=== tags.original_url ===

URL or path to the original document (PDF in external storage).

=== tags.original_format ===

Original format: <code>pdf</code>, <code>xml</code>, <code>html</code>, <code>json</code>, <code>docx</code>, <code>odt</code>

----

== Document structure (for kind=chunk) ==

=== tags.part ===

The structural section of the parent document this chunk represents.

Values: <code>visa</code>, <code>facts</code>, <code>moyens</code>, <code>reasoning</code>, <code>ruling</code>, <code>ag_opinion</code>, <code>conclusie</code>, <code>dispositif</code>

=== tags.position ===

Ordinal position within parent (for ordering chunks and sections).

----

== Article versioning ==

=== tags.cid ===

Permanent article identity — groups temporal versions of the same article across renumbering. Corresponds to LEGI XML CID in France; other jurisdictions provide equivalent identifiers (e.g., BWB number in NL, SFS number in SE).

Used by: the compiler to group versions, the <code>at_date</code> TagQuery to select the correct temporal version, the knowledge graph to link concepts to articles.

See [[Corpus/Temporal|TEMPORAL]] for temporal versioning details.

----

== Structure type (for kind=section) ==

=== tags.structure_type ===

Differentiates navigation trees.

Values: <code>legislation</code>, <code>labor</code>, <code>doctrine</code>, <code>official_journal</code> (and future jurisdiction-specific values)

[[Category:Corpus]]

Development/Adding a source

Nicolas — Thu, 23 Apr 2026 02:07:32 GMT

Create guide for adding a new data source to the ingest pipeline (via create-page on MediaWiki MCP Server)

New page

= Adding a source =

This guide explains how to add a new data source to the Dura Lex ingest pipeline. A "source" is a public institutional data feed (legislation, case law, company records, official notices) that gets downloaded, parsed, and inserted into the corpus.

== Overview ==

Adding a source involves these steps:

# Register the source in the source registry
# Implement a downloader (and optionally a parser)
# Follow tag and edge conventions
# Document the source on the wiki

== Step 1: Register the source ==

Every source must be registered in the jurisdiction's <code>source_registry.py</code> module. Registration happens at import time via the <code>register_source()</code> function from <code>duralex.ingest.source_registry</code>.

=== Location ===

* French sources: <code>duralex-ingest/duralex-ingest-fr/src/duralex/ingest/fr/source_registry.py</code>
* EU sources: <code>duralex-ingest/duralex-ingest-eu/src/duralex/ingest/eu/source_registry.py</code>
* New jurisdictions: create <code>duralex-ingest/duralex-ingest-{jur}/src/duralex/ingest/{jur}/source_registry.py</code>

=== Required fields ===

The <code>register_source()</code> function requires the following fields:

{| class="wikitable"
! Field !! Type !! Description !! Example
|-
| <code>source_key</code> || <code>str</code> (positional) || Unique short identifier for the source || <code>"cada"</code>
|-
| <code>jurisdiction</code> || <code>str</code> || ISO-style jurisdiction code || <code>"fr"</code>, <code>"eu"</code>
|-
| <code>name</code> || <code>str</code> || Human-readable source name || <code>"CADA"</code>
|-
| <code>description</code> || <code>str</code> || What this source contains || <code>"Avis et conseils de la Commission d'accès aux documents administratifs"</code>
|-
| <code>kind</code> || <code>str</code> || One of the 6 structural kinds: <code>legislation</code>, <code>decision</code>, <code>record</code>, <code>notice</code>, <code>section</code>, <code>chunk</code> || <code>"decision"</code>
|-
| <code>publisher</code> || <code>str</code> || Organization that publishes the data || <code>"CADA"</code>, <code>"DILA"</code>
|-
| <code>publisher_url</code> || <code>str</code> || URL where the data can be found || <code>"https://www.data.gouv.fr/fr/datasets/..."</code>
|-
| <code>license</code> || <code>str</code> || License name || <code>"Licence Ouverte 2.0"</code>
|-
| <code>license_url</code> || <code>str</code> || URL of the license || <code>"https://www.etalab.gouv.fr/licence-ouverte-open-licence/"</code>
|-
| <code>language</code> || <code>str</code> || ISO 639-1 language code || <code>"fr"</code>, <code>"en"</code>
|-
| <code>date_bounds</code> || <code>DateBounds</code> || Valid date range for this source || see below
|}

=== DateBounds ===

<code>DateBounds</code> validates that document dates are within a plausible range. Two factory methods are available:

* <code>DateBounds.strict(min_year=NNNN)</code> — for sources where documents cannot have future dates (decisions, records, notices). Max year defaults to current year + small margin.
* <code>DateBounds.permissive(min_year=NNNN, max_year=NNNN)</code> — for legislation with legitimate forward entry-into-force or expiration dates.

=== Example: simple source registration ===

<syntaxhighlight lang="python">
from duralex.ingest.date_validation import DateBounds
from duralex.ingest.source_registry import register_source

register_source(
"cada",
jurisdiction="fr",
name="CADA",
description="Avis et conseils de la Commission d'accès aux documents administratifs",
kind="decision",
publisher="CADA",
publisher_url="https://www.data.gouv.fr/fr/datasets/53698f37a3a729239d2036a0/",
license="Licence Ouverte 2.0",
license_url="https://www.etalab.gouv.fr/licence-ouverte-open-licence/",
language="fr",
date_bounds=DateBounds.strict(min_year=1900),
)
</syntaxhighlight>

=== Sub-sources ===

If your source has logical sub-feeds (e.g., different court levels within a single API), register them as sub-sources. Sub-sources inherit all metadata from their parent:

<syntaxhighlight lang="python">
from duralex.ingest.source_registry import register_sub_source

# Parent must be registered first
for sub_key in ("judilibre_cc", "judilibre_ca", "judilibre_tj", "judilibre_tcom"):
register_sub_source(sub_key, "judilibre")
</syntaxhighlight>

== Step 2: Implement a downloader ==

=== BaseDownloader (for DILA-style tar.gz archives) ===

If your source publishes data as <code>.tar.gz</code> archives on an HTTP index page (like DILA sources), subclass <code>BaseDownloader</code> from <code>duralex.ingest.sources.base_downloader</code>.

<code>BaseDownloader</code> provides:
* HTTP retry with exponential backoff and 429/Retry-After support
* Listing remote files from an HTML index page
* Downloading with partial-download safety (<code>.tmp</code> files + atomic rename)
* Extracting <code>.tar.gz</code> archives with prefix stripping
* State tracking (last downloaded diff filename) for incremental updates
* Freemium base file + incremental diff pattern

Constructor parameters:

{| class="wikitable"
! Parameter !! Description
|-
| <code>dataset_name</code> || Identifier for this dataset (e.g. <code>"cass"</code>, <code>"legi"</code>)
|-
| <code>data_directory</code> || Root directory for extracted data and archives
|-
| <code>base_url</code> || URL of the HTTP index listing <code>.tar.gz</code> files
|-
| <code>get_state</code> || Callback returning the last processed filename, or <code>None</code>
|-
| <code>set_state</code> || Callback to persist the last processed filename
|-
| <code>archive_prefix_markers</code> || Directory names marking the start of useful content in tar archives (e.g. <code>["JURI", "CETA"]</code>)
|}

The <code>run()</code> method is the main entry point. It downloads the freemium base (on first run) and/or incremental diffs, extracts them, and returns a list of extracted XML file paths. State is NOT written by <code>run()</code> -- call <code>commit_state()</code> after successful ingest.

=== Inline downloader (for non-archive sources) ===

For sources that do not follow the tar.gz archive pattern (e.g., CSV files, API endpoints), write a standalone downloader class that handles its own parsing and DB insertion. This is called an "inline source".

The CADA downloader is a good example of an inline source. Key patterns:

<syntaxhighlight lang="python">
class CadaDownloader:
"""Downloads CADA CSV from data.gouv.fr and ingests into corpus.documents."""

def __init__(self, dsn: str, data_directory: Path) -> None:
self.dsn = dsn
self._cache_directory = data_directory / "cada"

def run(self, errors: IngestErrors | None = None) -> list[str]:
"""Download, parse, and insert. Returns []."""
# 1. Check upstream for changes (compare last_modified)
# 2. Download or use cached file
# 3. Parse rows into corpus.documents records
# 4. Insert in batches using insert_batch()
# 5. Clean up orphaned records
# 6. Update ingest state
...
</syntaxhighlight>

Key conventions for inline downloaders:

* Accept <code>dsn</code> (PostgreSQL connection string) and <code>data_directory</code> (root for cached files) in the constructor
* Accept an optional <code>errors: IngestErrors | None</code> parameter in <code>run()</code> for error tracking
* Cache downloaded files to disk with a <code>.tmp</code> extension during download and atomic rename on completion
* Store a sidecar metadata file (e.g., <code>.meta</code>) for change detection
* Use <code>get_ingest_state()</code> / <code>set_ingest_state()</code> from <code>duralex.ingest.state</code> to track whether the upstream data has changed
* Use <code>insert_batch()</code> from <code>duralex.ingest.database.batch_writer</code> for bulk insertion
* Return an empty list (inline sources handle their own insertion)

=== Document record format ===

Each record inserted into <code>corpus.documents</code> must have:

{| class="wikitable"
! Field !! Description
|-
| <code>id</code> || Globally unique document ID, prefixed with jurisdiction (e.g. <code>"fr.cada_20240001"</code>)
|-
| <code>kind</code> || One of: <code>legislation</code>, <code>decision</code>, <code>record</code>, <code>notice</code>, <code>section</code>, <code>chunk</code>
|-
| <code>jurisdiction</code> || Jurisdiction code (e.g. <code>"fr"</code>, <code>"eu"</code>)
|-
| <code>language</code> || ISO 639-1 language code
|-
| <code>source</code> || Source key matching the registered source
|-
| <code>date</code> || Primary date (ISO 8601 format <code>YYYY-MM-DD</code>), or <code>None</code>
|-
| <code>date_end</code> || End date for documents with a date range, or <code>None</code>
|-
| <code>parent_id</code> || Parent document ID for hierarchical sources, or <code>None</code>
|-
| <code>title</code> || Human-readable title
|-
| <code>body</code> || Clean displayable content (HTML or formatted text). Immutable after ingestion.
|-
| <code>body_search</code> || Indexable text for FTS (can be noisy: PDF OCR, etc.), or <code>None</code> to use <code>body</code>
|-
| <code>tags</code> || JSON string of metadata tags (see below)
|}

== Step 3: Follow tag conventions ==

Tags are the primary metadata mechanism. Every document gets a <code>tags</code> JSON object. Refer to [[Corpus/Tag conventions]] for the full shared vocabulary.

=== Mandatory tags ===

* <code>type</code> — legal document type (e.g. <code>"law"</code>, <code>"decree"</code>, <code>"judgment"</code>, <code>"administrative_decision"</code>). See the tag conventions for the full list.
* <code>content_quality</code> — quality of the body content (e.g. <code>"native_structured"</code>, <code>"ocr_raw"</code>, <code>"metadata_only"</code>)

=== Common optional tags ===

* <code>nature</code> — source-specific document nature
* <code>court</code> — court identifier (for decisions)
* <code>authority</code> — issuing authority
* <code>case_number</code> — case/dossier numbers (as a list)
* <code>solution</code> — outcome/disposition
* <code>summary</code> — headnote or summary
* <code>headnote_classification</code> — subject classification
* <code>_importance_level_default</code> — default importance for ranking

=== Tag construction pattern ===

<syntaxhighlight lang="python">
import json

def _tags(**kwargs: object) -> str:
"""Build a tags JSON string, stripping None values."""
return json.dumps(
{k: v for k, v in kwargs.items() if v is not None},
ensure_ascii=False,
)

# Usage
tags = _tags(
type="administrative_decision",
content_quality="native_structured",
court="cada",
case_number=[number],
solution=outcome or None,
)
</syntaxhighlight>

== Step 4: Follow edge conventions ==

If your source contains cross-references to other documents (citations, amendments, transpositions, etc.), create edges in the <code>corpus.edges</code> table. Refer to [[Corpus/Edge types]] for the full taxonomy of ~75 edge types.

Common edge types for new sources:
* <code>cites</code> — document A cites document B
* <code>amends</code> — document A amends document B
* <code>repeals</code> — document A repeals document B
* <code>implements</code> — national law implements an EU directive
* <code>transposes</code> — national law transposes an EU directive
* <code>consolidates</code> — consolidated version of a text

== Step 5: Document the source ==

Create a wiki page at <code>Sources/{jurisdiction}/{source_name}</code> documenting:

* What the source contains
* Publisher and license
* Data format (XML, CSV, JSON, API)
* Update frequency
* Known quirks or data quality issues
* Volume (approximate number of documents)
* Coverage dates

== Complete example: CADA source ==

The CADA (Commission d'acces aux documents administratifs) source is a good reference implementation for a simple inline source.

=== Registration ===

In <code>duralex-ingest/duralex-ingest-fr/src/duralex/ingest/fr/source_registry.py</code>:

<syntaxhighlight lang="python">
register_source(
"cada",
jurisdiction="fr",
name="CADA",
description="Avis et conseils de la Commission d'accès aux documents administratifs",
kind="decision",
publisher="CADA",
publisher_url="https://www.data.gouv.fr/fr/datasets/53698f37a3a729239d2036a0/",
license="Licence Ouverte 2.0",
license_url="https://www.etalab.gouv.fr/licence-ouverte-open-licence/",
language="fr",
date_bounds=DateBounds.strict(min_year=1900),
)
</syntaxhighlight>

=== Downloader ===

In <code>duralex-ingest/duralex-ingest-fr/src/duralex/ingest/fr/sources/cada.py</code>:

* Downloads a consolidated CSV (~184 MB, ~60k records, 1984-present) from data.gouv.fr
* Caches the CSV to disk with change detection via <code>last_modified</code> timestamp
* Parses each CSV row into a <code>corpus.documents</code> record with structured tags
* Inserts in batches of 5000 using <code>insert_batch()</code>
* Cleans up orphaned records (with a safety threshold of 30,000 to avoid accidental mass deletion)
* Tracks ingest state so unchanged upstream data is skipped

=== Record construction ===

Each CADA record maps to:
* <code>id</code>: <code>"fr.cada_{number}"</code>
* <code>kind</code>: <code>"decision"</code>
* <code>source</code>: <code>"cada"</code>
* <code>title</code>: <code>"CADA {year} n°{number} — {subject}"</code>
* <code>tags</code>: includes <code>type</code>, <code>content_quality</code>, <code>nature</code>, <code>court</code>, <code>authority</code>, <code>theme</code>, <code>case_number</code>, <code>solution</code>, <code>summary</code>, <code>headnote_classification</code>

== Existing French sources ==

For reference, the following sources are currently registered for France:

{| class="wikitable"
! Source key !! Name !! Kind !! Publisher
|-
| <code>cass</code> || Cour de cassation || decision || DILA
|-
| <code>inca</code> || INCA || decision || DILA
|-
| <code>capp</code> || Cours d'appel || decision || DILA
|-
| <code>jade</code> || JADE || decision || DILA
|-
| <code>constit</code> || Conseil constitutionnel || decision || DILA
|-
| <code>cnil</code> || CNIL || decision || DILA
|-
| <code>legi</code> || LEGI || legislation || DILA
|-
| <code>kali</code> || KALI || legislation || DILA
|-
| <code>acco</code> || ACCO || legislation || DILA
|-
| <code>jorf</code> || JORF || legislation || DILA
|-
| <code>ce_opendata</code> || Justice administrative (open data) || decision || Conseil d'État
|-
| <code>cada</code> || CADA || decision || CADA
|-
| <code>bofip</code> || BOFiP || legislation || DGFiP
|-
| <code>judilibre</code> || Judilibre || decision || Cour de cassation
|-
| <code>jufi</code> || Juridictions financières || decision || DILA
|-
| <code>rne</code> || Registre national des entreprises || record || INPI
|-
| <code>bodacc</code> || BODACC || notice || DILA
|}

[[Category:Development]]

MCP/Guidelines

Nicolas — Thu, 23 Apr 2026 02:07:01 GMT

Create MCP/Guidelines index page explaining the guidelines system (via create-page on MediaWiki MCP Server)

New page

= Guidelines =

The <code>safety_guidelines</code> tool returns mandatory guidelines for legal research. The guidelines system uses a two-call workflow:

# '''Core guidelines''' — called ONCE at the start of any session via <code>safety_guidelines(category="core")</code>. Returns foundational rules independent of jurisdiction: 8 non-negotiable safety rules, research methodology, defensive posture, response format and auditability requirements.
# '''Jurisdiction guidelines''' — called BEFORE researching any new jurisdiction via <code>safety_guidelines(category="jurisdiction", jurisdiction="<code>")</code>. Returns jurisdiction-specific rules and corpus provenance. When switching jurisdiction mid-session, call again with the new code.

== Architecture ==

The guidelines are loaded at server startup and cached for the lifetime of the MCP server process. Restarting the container is required after editing guideline files.

* '''Core text''' lives in <code>duralex-mcp/src/duralex/mcp/core.md</code> and is loaded by the MCP server directly (not by plugins).
* '''Jurisdiction texts''' are provided by each jurisdiction plugin via the <code>get_guidelines() -> str</code> protocol. Each plugin returns a single jurisdiction-scoped supplement.
* '''Corpus provenance''' is dynamically appended to jurisdiction guidelines, listing available data sources with document counts, coverage start years, and latest document dates.

Single-jurisdiction variants (e.g., <code>"fr"</code>, <code>"eu"</code>) are precomputed at registration time. Multi-jurisdiction variants (e.g., <code>"eu|fr"</code>) are built on demand by concatenating the relevant single-jurisdiction variants.

The <code>jurisdiction</code> parameter supports Overpass QL operators: <code>"fr"</code>, <code>"eu"</code>, <code>"eu|fr"</code> (combined), <code>"*"</code> (all jurisdictions), <code>"!=eu"</code> (exclusion). The <code>"!*"</code> operator is not allowed.

== Categories ==

=== Core ===

Foundational rules applicable to all jurisdictions. Contains:

* '''Identity and tone''' — research partner posture, no legal advice, no predictions, adaptive fact-gathering
* '''8 non-negotiable safety rules''' — fetch before cite, explicit refusal, quote-first, citation self-check, no jurisdiction mixing, temporal check, absence vs inexistence, quality_check mandatory
* '''Context window management''' — compaction detection and warning protocol
* '''Research methodology''' — 13-step checklist, search syntax, tool routing, fallback strategies
* '''Defensive posture and analysis''' — adversarial self-review, structured reasoning, authority weighting, hallucination pattern detection
* '''Response format and auditability''' — citation format, permanent links, danger detection, language rules

Full text: '''[[MCP/Guidelines/Core|Core guidelines]]'''

=== Jurisdiction: FR (French law) ===

French law-specific rules. Contains:

* Tool routing by legal domain (employment, civil, criminal, tax, data protection, administrative, company information)
* French legal synonyms for FTS
* Normative hierarchy and codification prefixes
* Major reforms and renumbering traps (obligations 2016, security interests 2022, criminal procedure 2024)
* Court system: judicial, administrative, financial orders with court_level mappings
* Publication grades (official_grade) for all court families
* Formations and solemnity ordering
* Decision reading and analysis (Cass, CE, CC, CA/TJ)
* Case number formats
* Labor law (three-tier hierarchy, IDCC, bargaining_level)
* Legislation (territorial scope, text types, nature tag, JORF, code abbreviations, enforcement status)
* Doctrine (BOFiP, CNIL, CADA)
* Deadline computation
* Common traps (40+ pitfalls)
* Practical reflexes (prescription periods, pre-litigation steps)
* Data limitations and source coverage
* Emergency resources

Full text: '''[[MCP/Guidelines/FR|FR guidelines]]'''

=== Jurisdiction: EU (European law) ===

European law-specific rules. Contains:

* Tool routing (regulations, directives, CJEU, ECHR, CELEX lookup, transposition)
* EU legal terminology and multilingual search
* Courts: CJEU (Court of Justice + General Court), ECHR
* Publication grades and importance grades
* Legislation hierarchy (treaties > regulations > directives > decisions)
* Charter of Fundamental Rights
* Direct effect and primacy
* ECHR margin of appreciation
* Transposition lookup workflow
* CJEU preliminary rulings
* Advocate General opinions
* Decision analysis (preliminary rulings, direct actions, ECHR)
* Practical reflexes
* Emergency resources

Full text: '''[[MCP/Guidelines/EU|EU guidelines]]'''

[[Category:MCP]]

MCP/Reference resolution

Nicolas — Thu, 23 Apr 2026 02:06:25 GMT

Create MCP/Reference resolution page from REFERENCE-RESOLUTION.md (via create-page on MediaWiki MCP Server)

New page

= Reference Resolution =

== Overview ==

Reference resolution transforms a natural language legal reference (or a document ID) into a query against the corpus. It is the bridge between how humans cite law and how the database stores it.

The resolver is used by:
* '''MCP <code>get</code> tool''': user asks for "article 1240 du code civil" → find the document
* '''Knowledge graph compiler''' (future): annotations reference articles by citation → resolve to corpus document IDs
* '''Edge resolution''': when <code>corpus.edges.target_id</code> is NULL, a background job resolves <code>reference</code> strings to document IDs

== TagQuery ==

The universal output of any reference parser. Jurisdiction-agnostic.

<syntaxhighlight lang="python">
@dataclass(frozen=True)
class TagQuery:
language: str # required, kw_only
kind: str | None = None
tag_filters: TagFilterSet = field(default_factory=TagFilterSet)
should_sort_in_force_first: bool = False
at_date: date | None = None
hint: str | None = None
</syntaxhighlight>

Fields:
* <code>language</code>: ISO 639-1 code, required (disambiguates language variants)
* <code>kind</code>: filter on document kind (legislation, decision, record...)
* <code>tag_filters</code>: TagFilterSet with all tag predicates (EQ, IN, NOT_IN, ILIKE, EXISTS, NOT_EXISTS, NORMALIZE)
* <code>should_sort_in_force_first</code>: order results with <code>tags.in_force=true</code> first, then by date descending
* <code>at_date</code>: temporal version selection — <code>date <= at_date AND (date_end IS NULL OR date_end > at_date)</code>
* <code>hint</code>: optional human-readable interpretation label. TagQueries '''with''' <code>hint</code> are ''candidates'' (collected from all plugins, disambiguated at MCP level); those '''without''' are ''confident matches'' (first hit wins)

== TagFilterSet ==

Unified immutable filter model. A tuple of <code>TagFilter</code> predicates, AND-combined.
Replaces the previous scattered dict params (<code>tags</code>, <code>tags_ilike</code>, <code>normalize</code>).

<syntaxhighlight lang="python">
class TagFilterOp(enum.Enum):
EQ # tags @> '{"k": "v"}' (JSONB containment)
IN # tags->>'k' = ANY(...)
NOT_IN # tags ? 'k' AND NOT (tags->>'k' = ANY(...))
ILIKE # unaccent(tags->>'k') ILIKE unaccent(pattern)
EXISTS # tags ? 'k'
NOT_EXISTS # NOT (tags ? 'k')
NORMALIZE # regexp_replace comparison (reference resolution only)

@dataclass(frozen=True)
class TagFilter:
key: str # tag key or virtual key (source/jurisdiction/language)
op: TagFilterOp
value: str | list[str] | None = None
normalize_pattern: str | None = None # only for NORMALIZE
</syntaxhighlight>

Convenience constructor: <code>TagFilterSet.from_tags({"k": "v"})</code> builds EQ filters from a dict.

== Resolution pipeline ==

<pre>
input string
|
v
1. Direct ID lookup (try as corpus.documents.id — covers all kinds in one query)
| found? → return (with CID-based version redirection if at_date is set)
v
2. Jurisdiction parser (FR, EU, GB...) → TagQuery
| parsed? → execute against store
| Note: SIREN 9-digit lookup is a detector in the FR plugin (with Luhn validation)
v
3. Disambiguation (bare article number matches multiple codes → error with suggestions)
</pre>

== TagQuery examples ==

<syntaxhighlight lang="python">
# "article 1240 du code civil"
TagQuery(language="fr", kind="legislation",
tag_filters=TagFilterSet.from_tags({"article_number": "1240", "code": "Code civil"}),
should_sort_in_force_first=True)

# "article 1147 du code civil" (version in force in 2015)
TagQuery(language="fr", kind="legislation",
tag_filters=TagFilterSet.from_tags({"article_number": "1147", "code": "Code civil"}),
at_date=date(2015, 6, 15))

# "loi n 2021-1109"
TagQuery(language="fr", kind="legislation",
tag_filters=TagFilterSet.from_tags({"nature": "LOI", "number": "2021-1109"}))

# "pourvoi 20-20.648" — case number with court filter and hint (candidate)
TagQuery(language="fr", kind="decision",
tag_filters=TagFilterSet(filters=(
TagFilter(key="case_number", op=TagFilterOp.NORMALIZE,
value="20-20.648", normalize_pattern=r"[\s.\-/]"),
TagFilter(key="court", op=TagFilterOp.EQ, value="cour_cassation"),
)),
hint="pourvoi Cour de cassation")

# "486329" — CE request number
TagQuery(language="fr", kind="decision",
tag_filters=TagFilterSet(filters=(
TagFilter(key="case_number", op=TagFilterOp.NORMALIZE,
value="486329", normalize_pattern=r"[\s.\-/]"),
TagFilter(key="court", op=TagFilterOp.EQ, value="conseil_etat"),
)),
hint="requete Conseil d'Etat")

# "21/00091" — CA/TJ RG number
TagQuery(language="fr", kind="decision",
tag_filters=TagFilterSet(filters=(
TagFilter(key="case_number", op=TagFilterOp.NORMALIZE,
value="21/00091", normalize_pattern=r"[\s.\-/]"),
TagFilter(key="court", op=TagFilterOp.IN, value=["cour_appel", "tribunal_judiciaire"]),
)),
hint="RG cour d'appel ou tribunal judiciaire")

# ECLI
TagQuery(language="fr", kind="decision",
tag_filters=TagFilterSet.from_tags({"ecli": "ECLI:FR:CCASS:2024:C100001"}))

# "IDCC 3239"
TagQuery(language="fr", kind="legislation",
tag_filters=TagFilterSet.from_tags({"idcc": "3239", "in_force": "true"}))

# UK: "section 1 of the Theft Act 1968" (ILIKE for fuzzy act title)
TagQuery(language="en", kind="legislation",
tag_filters=TagFilterSet(filters=(
TagFilter(key="section_number", op=TagFilterOp.EQ, value="1"),
TagFilter(key="act_title", op=TagFilterOp.ILIKE, value="Theft Act 1968"),
)))

# DE: "§ 823 BGB"
TagQuery(language="de", kind="legislation",
tag_filters=TagFilterSet.from_tags({"paragraph": "823", "code": "BGB"}))

# EU: "Article 101 TFEU"
TagQuery(language="en", kind="legislation",
tag_filters=TagFilterSet.from_tags({"article_number": "101", "treaty": "TFEU"}))
</syntaxhighlight>

== Store execution ==

The store translates TagQuery to SQL via the shared <code>build_tag_filter_conditions</code>
helper. Zero jurisdiction knowledge. Each TagFilterOp maps to a specific SQL pattern:

<syntaxhighlight lang="sql">
SELECT * FROM corpus.documents
WHERE language = %(language)s -- always required
AND kind = %(kind)s
AND tags @> %(eq_batch)s -- coalesced EQ filters (GIN)
AND tags->>'k' = ANY(%(in_values)s) -- IN filter
AND unaccent(tags->>'code') ILIKE unaccent(%(code_pattern)s) -- ILIKE filter
AND regexp_replace(tags->>'case_number', %(p)s, '', 'g') -- NORMALIZE filter
= regexp_replace(%(v)s, %(p)s, '', 'g')
AND date <= %(at_date)s -- temporal (if at_date)
AND (date_end IS NULL OR date_end > %(at_date)s)
ORDER BY
(tags->>'in_force')::boolean DESC NULLS LAST, -- should_sort_in_force_first
date DESC NULLS LAST
LIMIT 10;
</syntaxhighlight>

== Multi-candidate resolution ==

When a reference is ambiguous (e.g., a French case number that could match
multiple courts), the resolver returns multiple TagQuery instances, each with
a <code>hint</code> describing the interpretation. The MCP <code>get_document</code> tool:

# Collects all TagQueries from all jurisdiction plugins
# Separates '''confident''' (no hint) from '''candidates''' (with hint)
# Tries confident matches first — first hit wins (existing behavior)
# Tries all candidates against the store:
#* 1 match → returns the document with a warning noting the interpretation
#* 2+ matches → returns an error listing all candidates with IDs
#* 0 matches → falls through to "not found"

The <code>get_document</code> tool also accepts an optional <code>tags</code> parameter that merges
additional EQ filters into each TagQuery, narrowing the search (e.g.,
<code>tags={"court": "conseil_etat"}</code>).

== Jurisdiction parsers ==

Each jurisdiction plugin provides a parser that recognizes its citation formats:

{| class="wikitable"
! Plugin !! Recognizes
|-
| duralex-fr || Articles of codes, loi/decret/ordonnance by number, NOR codes, IDCC, ECLI, case numbers, BOFiP IDs, named laws
|-
| duralex-eu || CELEX numbers, ECLI, treaty articles, directive/regulation numbers
|-
| Future duralex-gb || Neutral citations ([2024] UKSC 1), Act + section, SI numbers
|-
| Future duralex-de || § + BGB/StGB/etc, Aktenzeichen, ECLI
|}

Parsers are composable: the MCP server chains all installed jurisdiction parsers. First match wins.

== Batch resolution (for knowledge graph) ==

The compiler needs to resolve millions of references. The same TagQuery mechanism is used, but with batch-friendly optimizations:
* Pre-filter by known patterns (regex on reference strings)
* Group by reference type and execute one query per group
* Cache resolved IDs in a lookup table for the duration of compilation

== Edge resolution (background job) ==

When <code>corpus.edges.target_id</code> is NULL, a background job periodically attempts resolution:

<syntaxhighlight lang="sql">
SELECT id, reference FROM corpus.edges WHERE target_id IS NULL;
-- For each: parse reference → TagQuery → execute → update target_id
UPDATE corpus.edges SET target_id = %(resolved_id)s WHERE id = %(edge_id)s;
</syntaxhighlight>

[[Category:MCP]]

Development/GitHub

Nicolas — Thu, 23 Apr 2026 02:06:04 GMT

Create GitHub conventions page from coding-conventions/GITHUB.md (via create-page on MediaWiki MCP Server)

New page

= GitHub Conventions =

Issues, pull requests, branches, and commit messages across all <code>duralex-*</code> repositories.

== Commit messages and PR titles ==

All repositories use '''conventional commits'''. Since PRs are squash-merged, the PR title becomes the commit message. The PR title format is enforced.

=== Format ===

<pre>
<type>(<scope>): <Description starting with uppercase>
</pre>

Scope is optional. Description starts with uppercase, does not end with punctuation.

=== Types ===

{| class="wikitable"
! Type !! When to use
|-
| <code>feat</code> || New feature or capability
|-
| <code>fix</code> || Bug fix
|-
| <code>refactor</code> || Code change that neither fixes a bug nor adds a feature
|-
| <code>perf</code> || Performance improvement
|-
| <code>docs</code> || Documentation only
|-
| <code>test</code> || Adding or updating tests
|-
| <code>ci</code> || CI/CD configuration
|-
| <code>chore</code> || Maintenance (dependencies, tooling, config)
|-
| <code>build</code> || Build system or packaging changes
|}

=== Scopes (per repo) ===

Scopes are short identifiers for the area of the codebase. Each repo defines its own set.

'''duralex:'''

<pre>
feat(corpus): Add source metadata discovery
fix(data): Handle missing content element in LEGI XML
refactor(annotations): Split envelope from type definitions
perf(fts): Optimize FTS query for large result sets
</pre>

'''duralex-fr:'''

<pre>
feat(parser): Add KALI collective agreement parser
fix(refs): Correct L/R/D prefix detection for code du travail
</pre>

=== Breaking changes ===

Append <code>!</code> after the scope for breaking changes:

<pre>
refactor(data)!: Rename LegislationArticle fields to match URI scheme
</pre>

The PR body must include a <code>== Breaking changes ==</code> section explaining what breaks and how to migrate.

== Branch naming ==

<pre>
<type>/<issue-number>-<short-description>
</pre>

Lowercase, hyphens between words. The type matches the conventional commit type.

<pre>
feat/12-ecli-reference-detection
fix/34-lrd-prefix-code-travail
refactor/56-rename-article-fields
docs/78-add-packaging-conventions
</pre>

== Pull request template ==

Every <code>duralex-*</code> repo has a <code>.github/pull_request_template.md</code>:

<pre>
## Summary



## Linked issues



## Test plan



## Breaking changes


</pre>

=== PR guidelines ===

* '''Target size: under 200 lines changed.''' If larger, split into stacked PRs.
* '''One concern per PR.''' A bug fix does not include a refactor. A feature does not include unrelated cleanup.
* '''Squash-merge only.''' The PR title is the commit message in <code>main</code>.
* '''Link to the issue.''' Use <code>Closes #N</code> syntax so the issue auto-closes on merge.

== Issue templates ==

Each repo has three YAML issue forms in <code>.github/ISSUE_TEMPLATE/</code>:

=== bug_report.yml ===

Required fields:

* '''Description''' — what happened vs. what was expected
* '''Reproducible example''' — minimal code or steps (required)
* '''Version info''' — output of <code>pip show duralex</code> or similar (required)
* '''Checklist''' — "I searched existing issues", "I am using the latest version"

=== feature_request.yml ===

Required fields:

* '''Use case''' — what problem does this solve? (required)
* '''Proposed API''' — how would the user call it? Code example preferred.
* '''Alternatives considered''' — what else was evaluated

=== config.yml ===

<syntaxhighlight lang="yaml">
blank_issues_enabled: false
contact_links:
- name: Questions and discussions
url: https://github.com/duralex/duralex/discussions
about: Ask questions and discuss ideas here
</syntaxhighlight>

Blank issues are disabled. Questions go to GitHub Discussions. Issues are for confirmed bugs and accepted features.

== Labels ==

Namespaced prefixes for machine-parseable filtering.

=== Shared across all repos ===

<pre>
type:bug
type:feature
type:refactor
type:docs
type:performance

priority:critical
priority:high
priority:medium
priority:low

status:needs-triage (auto-applied to new issues)
status:accepted
status:blocked
status:in-progress
</pre>

=== Per-repo area labels ===

'''duralex:'''

<pre>
area:corpus
area:annotations
area:concepts
area:data
area:temporal
</pre>

'''duralex-fr:'''

<pre>
area:mcp
area:refs
area:temporal
area:courts
area:search
</pre>

== Changelog ==

Generated automatically from conventional commit messages (PR titles). Each type maps to a changelog section:

{| class="wikitable"
! Commit type !! Changelog section
|-
| <code>feat</code> || Added
|-
| <code>fix</code> || Fixed
|-
| <code>perf</code> || Performance
|-
| <code>refactor!</code>, <code>feat!</code> || Breaking changes
|-
| <code>docs</code>, <code>test</code>, <code>ci</code>, <code>chore</code>, <code>build</code> || Not included
|}

[[Category:Development]]

Jurisdictions/EU

Nicolas — Thu, 23 Apr 2026 02:05:50 GMT

Create EU jurisdiction reference page (via create-page on MediaWiki MCP Server)

New page

= European Legal System =

Jurisdiction code: <code>eu</code>. Language: <code>fr</code> only (current limitation; multi-language planned). Covers EU law (EUR-Lex, CJEU) and Council of Europe (ECHR).

== Court structure ==

=== court_level mapping (T1 tag) ===

{| class="wikitable sortable"
! court_level !! Court (court tag) !! Institution !! Notes
|-
| <code>supranational</code> || Court of Justice (<code>cjeu</code>) || CJEU || Highest EU court; preliminary rulings, appeals from General Court
|-
| <code>supranational</code> || ECHR (<code>echr</code>) || Council of Europe || 46 member states; human rights
|-
| <code>first_instance</code> || General Court (<code>general_court</code>) || CJEU || Direct actions: competition, state aid, trademarks
|-
| <code>first_instance</code> || Civil Service Tribunal (<code>civil_service_tribunal</code>) || CJEU || '''Dissolved 2016''' — competence transferred to General Court
|}

=== CJEU (Court of Justice of the European Union) ===

Two active courts:
* '''Court of Justice''' (''Cour de justice''): highest EU court. Preliminary rulings (art. 267 TFEU), appeals from General Court, infringement proceedings.
* '''General Court''' (''Tribunal''): direct actions — competition, state aid, trademarks, EU staff disputes (since 2016).

'''Procedure types''':
{| class="wikitable"
! Type !! Treaty basis !! Description
|-
| Preliminary ruling || Art. 267 TFEU || National court asks CJEU to interpret EU law. CJEU answers; does NOT decide national case.
|-
| Annulment || Art. 263 TFEU || Challenge legality of EU act
|-
| Infringement || Art. 258-260 TFEU || Commission vs. member state for failure to comply
|-
| Opinion || Art. 218 TFEU || Compatibility of international agreement with treaties
|}

=== ECHR (European Court of Human Rights) ===

Covers 46 Council of Europe member states (broader than EU). Application number format: <code>NNNNN/YY</code> (e.g., 36022/97).

'''Margin of appreciation''': ECHR grants states discretion on sensitive topics (morals, religion, national security). A ruling against Italy does NOT automatically apply to France. Filter by respondent state: <code>tags={"respondent_state": "FRA"}</code> (3-letter ISO codes).

== CJEU publication grades (official_grade) ==

{| class="wikitable"
! Grade !! Label !! importance_level
|-
| <code>ecr_grand_chamber</code> || Published in ECR (Grand Chamber) || highest_importance
|-
| <code>ecr_chamber</code> || Published in ECR (Chamber) || high_importance
|-
| <code>oj_only</code> || Published in OJ only (not in ECR) || low_importance
|-
| <code>unpublished</code> || Unpublished || minimal_importance
|}

ECR = European Court Reports. OJ = Official Journal (series C).

== ECHR importance grades (official_grade) ==

{| class="wikitable"
! Grade !! Label !! importance_level
|-
| <code>1</code> || Key case (ECHR Reports of Judgments and Decisions) || highest_importance
|-
| <code>2</code> || High importance || high_importance
|-
| <code>3</code> || Medium importance || medium_importance
|-
| <code>4</code> || Low importance || low_importance
|}

== Formation / solemnity system ==

=== CJEU formations ===

{| class="wikitable"
! Formation !! Solemnity tag !! Notes
|-
| Single judge || <code>single_judge</code> ||
|-
| Chamber (3 judges) || <code>reduced_bench</code> ||
|-
| Chamber (5 judges) || <code>standard_bench</code> ||
|-
| Grand Chamber (15 judges) || <code>grand_bench</code> ||
|-
| Full Court (all judges) || <code>full_court</code> || Rare; constitutional matters
|}

=== ECHR formations ===

{| class="wikitable"
! Formation !! Solemnity tag !! Notes
|-
| Single Judge || <code>single_judge</code> || Admissibility only
|-
| Committee (3 judges) || <code>reduced_bench</code> || Repetitive cases
|-
| Section / Chamber (7 judges) || <code>standard_bench</code> || Standard formation
|-
| Grand Chamber (17 judges) || <code>grand_bench</code> || Relinquishment or referral; highest authority
|}

== EU legislation ==

=== Hierarchy ===

Treaties (TEU, TFEU, Charter of Fundamental Rights) > Regulations > Directives > Decisions > Recommendations/Opinions (non-binding)

=== Key types ===

{| class="wikitable"
! Type !! Effect !! Direct effect !! Tag example
|-
| '''Regulation''' (''reglement'') || Directly applicable in all member states || Full (vertical + horizontal) || <code>tags={"nature": "REGLEMENT"}</code>
|-
| '''Directive''' || Binds as to result; requires national transposition || Vertical only (vs. State), after deadline || <code>tags={"nature": "DIRECTIVE"}</code>
|-
| '''Decision''' || Binding on addressees only || Depends on content ||
|-
| '''Recommendation''' || Non-binding || None ||
|}

=== CELEX numbers ===

Official EU identifier. Format: <code>3{year}{type}{number}</code>.

{| class="wikitable"
! Example !! Meaning
|-
| <code>32016R0679</code> || Regulation 2016/679 (GDPR)
|-
| <code>32016L0680</code> || Directive 2016/680 (Law Enforcement Directive)
|-
| <code>32004D0001</code> || Decision 2004/1
|}

Direct lookup: <code>get_document("32016R0679")</code> resolves to <code>EU.EURLEXTEXT32016R0679</code>.

=== Enforcement status ===

EU EUR-Lex emits only two values:

{| class="wikitable"
! Value !! Meaning
|-
| <code>in_force</code> || In force
|-
| <code>repealed</code> || Repealed — NEVER cite as current
|}

=== Direct effect and primacy ===

{| class="wikitable"
! Instrument !! Direct effect !! Notes
|-
| Regulation || Vertical + horizontal || No transposition needed
|-
| Directive (after deadline) || Vertical only (vs. State) || NOT horizontal (between private parties)
|-
| Directive (before deadline) || None || Must wait for transposition
|-
| All EU law || Primacy over national law || Costa v ENEL (1964)
|}

== Multilingual documents ==

EU texts exist in 24 official languages, all equally authentic (TFEU art. 55).

Each language version is a separate document with a <code>:lang</code> suffix in the ID:
* <code>EU.EURLEXTEXT32016R0679:fr</code> — GDPR in French
* <code>EU.EURLEXTEXT32016R0679:en</code> — GDPR in English

The cross-language identifier <code>tags.text_id</code> is unsuffixed (<code>EU.EURLEXTEXT32016R0679</code>). The <code>language</code> parameter narrows results to the requested language.

Documents ingested in a fallback language (e.g., EN-only when no FR available) carry <code>tags.translation_pending="fr"</code>.

== Advocate General opinions ==

Separate documents (<code>kind=decision, type=advisory_opinion</code>). Precede the judgment, provide more detailed reasoning. Not binding but highly persuasive — often followed by the Court. Linked to judgments via edges when available.

'''Current limitation''': AG opinions are not yet ingested. <code>type=advisory_opinion</code> with <code>jurisdiction="eu"</code> returns 0 results.

== Charter of Fundamental Rights ==

Treaty-level value since Lisbon Treaty (2009). Binds EU institutions and member states when implementing EU law.

{| class="wikitable"
! Article !! Right
|-
| Art. 7 || Private and family life
|-
| Art. 8 || Protection of personal data
|-
| Art. 21 || Non-discrimination
|-
| Art. 47 || Right to effective remedy and fair trial
|}

'''Do not confuse''': Charter Art. 7 (private life) and Art. 8 (data protection) are separate from ECHR Convention Art. 8 (private life). Same wording, different instruments.

== What is NOT in the corpus ==

{| class="wikitable"
! Gap !! Notes
|-
| Advocate General opinions || Not yet ingested; planned
|-
| English-language documents || Only FR ingested currently; multi-language planned
|-
| EU national transposition measures || EUR-Lex transposition data may be incomplete — verify in FR sources
|-
| EU secondary legislation (delegated/implementing acts) || Partial coverage
|-
| Pre-accession case law for newer member states || Historical gaps
|}

== Practical notes ==

* '''Cross-border queries''': use <code>jurisdiction="eu|fr"</code> to combine EU and FR sources
* '''GDPR search tip''': "RGPD" as FTS term returns few EU results — prefer <code>"donnees a caractere personnel"</code> or <code>"protection des donnees"</code>, or direct CELEX: <code>get_document("32016R0679")</code>
* '''Transposition''': get_document() the directive, check edges for transposition links, then search FR sources
* '''Brexit''': UK no longer member state since 2020-01-31. Pre-Brexit case law involving UK still relevant for general EU law principles.
* '''Preliminary rulings''': CJEU interprets EU law but does NOT decide the national case. The national court applies the interpretation.

[[Category:Jurisdictions]]

Development/Packaging

Nicolas — Thu, 23 Apr 2026 02:05:32 GMT

Create Packaging conventions page from coding-conventions/PACKAGING.md (via create-page on MediaWiki MCP Server)

New page

= Packaging Conventions =

All duralex-* packages follow these conventions for consistent packaging, installation, and namespace management.

== Naming ==

{| class="wikitable"
! Layer !! Convention !! Example
|-
| Brand || Dura Lex (always two words) || —
|-
| Domain || <code>dura-lex.*</code> (hyphenated) || <code>dura-lex.org</code>
|-
| GitHub org || <code>duralex</code> || <code>github.com/duralex/</code>
|-
| PyPI package || <code>duralex-{name}</code> (hyphenated) || <code>duralex-fr</code>, <code>duralex-mcp</code>
|-
| Python import || <code>duralex.{name}</code> (dotted) || <code>from duralex.corpus import ...</code>
|-
| Exception || The core package is just <code>duralex</code> on PyPI || <code>pip install duralex</code>
|}

== Repository structure (6 repos) ==

<pre>
~/duralex/
├── duralex/ # PyPI: duralex (core + corpus + specs)
│ ├── pyproject.toml
│ ├── src/duralex/
│ │ ├── corpus/ # DocumentStore, FTS, TagQuery
│ │ ├── temporal/ # versioning, temporal types
│ │ ├── data/ # citation types, text utils
│ │ ├── annotations/ # annotation framework
│ │ ├── concepts/ # concept definitions
│ │ ├── errors.py # DuralexError base
│ │ ├── database.py # DSN builder
│ │ ├── logging.py # JSON/console logging
│ │ ├── middleware.py # ASGI middleware
│ │ └── retry.py # exponential backoff
│ ├── tests/
│ ├── sql/ # corpus DDL
│ ├── spec/ # authoritative specifications
│ ├── coding-conventions/ # this directory
│ ├── design-decisions/ # ADRs
│ ├── research/ # investigation logs
│ └── issues/ # issue tracker
│
├── duralex-jurisdictions/ # monorepo, two PyPI packages
│ ├── duralex-fr/ # PyPI: duralex-fr
│ │ ├── pyproject.toml
│ │ ├── src/duralex/fr/
│ │ └── tests/
│ └── duralex-eu/ # PyPI: duralex-eu
│ ├── pyproject.toml
│ ├── src/duralex/eu/
│ └── tests/
│
├── duralex-ingest/ # monorepo, three PyPI packages
│ ├── duralex-ingest/ # PyPI: duralex-ingest
│ │ ├── pyproject.toml
│ │ ├── src/duralex/ingest/ # NO __init__.py (namespace)
│ │ └── tests/
│ ├── duralex-ingest-fr/ # PyPI: duralex-ingest-fr
│ │ ├── pyproject.toml
│ │ ├── src/duralex/ingest/fr/
│ │ └── tests/
│ └── duralex-ingest-eu/ # PyPI: duralex-ingest-eu
│ ├── pyproject.toml
│ ├── src/duralex/ingest/eu/
│ └── tests/
│
├── duralex-mcp/ # PyPI: duralex-mcp (+ Docker infra)
│ ├── pyproject.toml
│ ├── src/duralex/mcp/
│ ├── tests/
│ ├── Dockerfile
│ ├── docker-compose.dev.yml
│ ├── docker-compose.prod.yml
│ └── Caddyfile
│
├── duralex-portal/ # PyPI: duralex-portal
│ ├── pyproject.toml
│ ├── src/duralex/portal/
│ └── tests/
│
└── duralex-feedback/ # standalone, not distributed
├── server.py
├── Dockerfile
└── docker-compose.yml
</pre>

== src layout with namespace packages ==

Every package uses the '''src layout''' with implicit namespace packages (PEP 420).

The critical rule: '''no <code>__init__.py</code> in namespace directories'''. Only leaf packages have <code>__init__.py</code>.

<pre>
duralex-fr/
├── pyproject.toml
├── src/
│ └── duralex/ # NO __init__.py (namespace)
│ └── fr/ # NO __init__.py (namespace)
│ ├── mcp/
│ │ ├── __init__.py # leaf package
│ │ └── ...
│ ├── refs/
│ │ ├── __init__.py
│ │ └── ...
│ └── courts/
│ ├── __init__.py
│ └── ...
└── tests/
</pre>

=== Special case: duralex-ingest namespace ===

The <code>duralex.ingest</code> namespace is shared across three packages. The base <code>duralex-ingest</code> package must NOT have <code>__init__.py</code> at <code>src/duralex/ingest/</code> — otherwise Python blocks namespace discovery of <code>duralex.ingest.fr</code> and <code>duralex.ingest.eu</code> from sibling packages.

<pre>
duralex-ingest/duralex-ingest/src/duralex/ingest/ # NO __init__.py
duralex-ingest/duralex-ingest/src/duralex/ingest/database/__init__.py # leaf
duralex-ingest/duralex-ingest-fr/src/duralex/ingest/fr/__init__.py # leaf
duralex-ingest/duralex-ingest-eu/src/duralex/ingest/eu/__init__.py # leaf
</pre>

== pyproject.toml template ==

<syntaxhighlight lang="toml">
[build-system]
requires = ["setuptools>=69.0"]
build-backend = "setuptools.build_meta"

[project]
name = "duralex-fr"
version = "0.1.0"
description = "France: legal reference resolver, court hierarchy, and validation for the Dura Lex ecosystem"
requires-python = ">=3.12"
license = "MIT"
authors = [{ name = "Nicolas Baldeck" }]
keywords = ["legal", "open-data", "france"]

dependencies = [
"duralex>=0.1.0",
]

[project.optional-dependencies]
dev = [
"pytest>=8.2",
"ruff>=0.15",
"mypy>=1.15",
]

[tool.setuptools.packages.find]
where = ["src"]
include = ["duralex.fr*"]

[tool.ruff]
line-length = 120
target-version = "py312"

[tool.ruff.lint]
select = ["E", "F", "W", "I", "UP", "B", "SIM", "TCH", "RUF", "PTH"]

[tool.ruff.format]
quote-style = "double"

[tool.mypy]
python_version = "3.12"
strict = true
namespace_packages = true
explicit_package_bases = true
mypy_path = ["src", "../../duralex/src"]

[tool.pytest.ini_options]
testpaths = ["tests"]
addopts = ["--strict-config", "--strict-markers", "--import-mode=importlib", "-m not slow and not integration"]
xfail_strict = true
consider_namespace_packages = true
filterwarnings = ["error"]
markers = [
"slow: tests with extended runtime",
"integration: requires PostgreSQL (testcontainers)",
]
</syntaxhighlight>

== Editable development installs ==

Install all packages in editable mode from the repo root:

<syntaxhighlight lang="bash">
cd ~/duralex
pip install -e "./duralex[dev,pg]"
pip install -e "./duralex-jurisdictions/duralex-fr[dev,db]"
pip install -e "./duralex-jurisdictions/duralex-eu[dev]"
pip install -e "./duralex-ingest/duralex-ingest[dev]"
pip install -e "./duralex-ingest/duralex-ingest-fr[dev]"
pip install -e "./duralex-ingest/duralex-ingest-eu[dev]"
pip install -e "./duralex-mcp[dev]"
pip install -e "./duralex-portal[dev]"
</syntaxhighlight>

If namespace resolution breaks between sibling packages:

<syntaxhighlight lang="bash">
pip install -e ".[dev]" --config-settings editable_mode=compat
</syntaxhighlight>

== Version policy ==

All packages start at <code>0.1.0</code>. Packages are versioned independently. A major version bump in <code>duralex</code> triggers compatibility review in all downstream packages.

== Brand vs. code ==

The brand is always written '''Dura Lex''' (two words). Code identifiers use <code>duralex</code> (one word, no space) because Python and PyPI do not allow spaces. Never write "Duralex" — it is either "Dura Lex" (prose) or <code>duralex</code> (code).

[[Category:Development]]

Corpus/Schema

Nicolas — Thu, 23 Apr 2026 02:05:28 GMT

Import from duralex/spec/CORPUS-SCHEMA.md — faithful conversion to wikitext (via create-page on MediaWiki MCP Server)

New page

= Corpus Schema =

Technical specification for the Dura Lex unified corpus schema. Reference for developers and AI agents.

== Overview ==

One <code>documents</code> table with promoted columns and a JSONB <code>tags</code> column, inspired by OpenStreetMap's model: a small fixed schema handles structure, while a flexible key-value store handles everything jurisdiction-specific.

Validated across 25 jurisdictions on 5 continents. Benchmark on 3.4M rows: 7x faster than the previous 16-table normalized schema.

Four tables:

{| class="wikitable"
! Table !! Purpose
|-
| <code>corpus.documents</code> || All legal content: legislation, case law, regulatory filings, administrative notices
|-
| <code>corpus.edges</code> || Relationships between documents: citations, amendments, hierarchy, consolidation
|-
| <code>corpus.tag_stats</code> || Aggregated tag counts per kind/jurisdiction, refreshed post-ingest
|-
| <code>corpus.source_metadata</code> || Data source registry: publishers, licenses, ingestion state, freshness
|}

----

== Schema: corpus.documents ==

14 columns.

<syntaxhighlight lang="sql">
CREATE SCHEMA IF NOT EXISTS corpus;

CREATE TABLE corpus.documents (
id text PRIMARY KEY,
kind text NOT NULL,
jurisdiction text NOT NULL,
language text,
source text NOT NULL,
date date,
date_end date,
parent_id text,
title text,
body text,
body_search text,
tags jsonb NOT NULL DEFAULT '{}',
content_fts tsvector,
ingested_at timestamptz DEFAULT now()
);
</syntaxhighlight>

=== Column definitions ===

'''id''' -- Text primary key. Uses source-native identifiers with a jurisdiction prefix, always '''lowercase''': <code>{jurisdiction}.{source_id}</code> (e.g., <code>fr.legiarti000006902764</code>, <code>eu.eurlextext32016r0679</code>). Identifiers with built-in jurisdiction context keep their original form (<code>ECLI:FR:CCASS:2024:CR00123</code>, <code>[2024] UKSC 1</code>). For non-legal registries where the source ID could collide, prefix with <code>{jurisdiction}.{source}.</code> (e.g., <code>fr.company.443061841</code>, <code>gb.company.12345678</code>). Never synthetic UUIDs -- the ID must be meaningful and traceable to the source. See ADR: lowercase document IDs (design-decisions/2026-04-09-lowercase-document-ids.md).

'''kind''' -- Structural classification. Exactly 6 values (see Kind Taxonomy below): <code>legislation</code>, <code>decision</code>, <code>record</code>, <code>notice</code>, <code>section</code>, <code>chunk</code>. This column answers "what shape is this document?" not "what legal category is it?" -- legal category belongs in <code>tags.type</code>.

'''jurisdiction''' -- Geographic/political area, not institution. ISO 3166-1 alpha-2 for countries (<code>fr</code>, <code>gb</code>, <code>de</code>, <code>br</code>, <code>jp</code>). ISO 3166-2 for subdivisions (<code>us-ca</code>, <code>gb-sct</code>, <code>es-ct</code>, <code>de-by</code>). Extensions for supranational areas: <code>eu</code> (European law — EU institutions and Council of Europe), <code>int</code> (international treaties). A search for a jurisdiction includes its subdivisions: searching <code>us</code> includes <code>us-ca</code>. No default value -- every document must declare its jurisdiction explicitly.

'''language''' -- ISO 639-1 (<code>fr</code>, <code>en</code>, <code>de</code>, <code>ar</code>, <code>zh</code>, <code>ja</code>, <code>ko</code>). Nullable. When NULL, the FTS trigger infers language from <code>jurisdiction</code>. Decoupled from jurisdiction because many countries are multilingual: Belgium (3 languages), Switzerland (4), South Africa (11), India (23+). A Belgian law in Dutch and the same law in French are two separate documents with the same jurisdiction (<code>be</code>) but different languages.

'''source''' -- Data source identifier. Examples: <code>legi</code>, <code>cass</code>, <code>hmrc_manuals</code>, <code>cendoj</code>, <code>boe</code>, <code>legifrance_jorf</code>, <code>knesset</code>. One source maps to one ingestion pipeline. Multiple sources can feed the same jurisdiction.

'''date''' -- Primary date, always ISO 8601 (converted from Hijri calendar, Japanese era dates, etc. at ingestion). Semantics vary by kind: <code>decision_date</code> for decisions, <code>valid_from</code> for legislation, <code>publication_date</code> for notices, <code>creation_date</code> for records. The semantic meaning is implicit from <code>kind</code> -- not stored separately.

'''date_end''' -- End date. <code>valid_until</code> for legislation, expiration for notices, closure for records. NULL for most decisions (they don't expire). NULL does not mean "still in force" -- it means the source did not provide an end date.

'''parent_id''' -- Hierarchical link to another document ID. Used for structure trees (code -> article), sub-documents (decision -> chunk), and entity hierarchies (company -> director appointments). Text, not a foreign key -- the parent may live in a different source or not yet be ingested. No FK constraint.

'''title''' -- Display title. Free text. May be NULL for chunks and sections that inherit their parent's title.

'''body''' -- Clean displayable content. HTML or plain text suitable for direct rendering to a user. Immutable after initial ingestion. Never contains noisy OCR or raw PDF binary. For PDF-only sources, <code>body</code> is a clean stub like <code>Source: <a href="...">PDF officiel</a></code> and the extracted text goes to <code>body_search</code>. <code>body</code> is what <code>get_document</code> returns.

'''body_search''' -- Indexable text representation used by FTS. Can be noisy (raw PDF extraction, OCR output) because users never see it directly — <code>get_document</code> never returns it. Nullable. When NULL, the FTS trigger falls back to <code>body</code> via <code>coalesce(body_search, body)</code>. Used for: (a) PDF-sourced documents where <code>body</code> is a clean stub and <code>body_search</code> holds the pdfminer-extracted text; (b) HTML documents with irregular references that need an LLM-cleaned indexable version. Summary and headnote FTS indexing is handled separately by the trigger reading <code>tags.summary</code> and <code>tags.headnote_classification</code> directly from JSONB (weight B). See ADR-010 (design-decisions/2026-04-08-body-search-inversion.md) for the current semantic and ADR-008 (design-decisions/2026-04-05-fts-three-weights.md) for the trigger weight system. See [[Corpus/Quality|QUALITY]] for <code>tags.content_quality</code> levels.

'''tags''' -- JSONB. Everything jurisdiction-specific or type-specific that does not deserve a promoted column. Examples: <code>{"type": "loi", "nid": "JORFTEXT000041865244", "nature": "LOI"}</code> for French legislation, <code>{"chamber": "2e_civ", "solution": "cassation"}</code> for French cassation decisions, <code>{"sic_code": "6411", "status": "active"}</code> for UK company records. No enforced schema -- each source defines its own tag vocabulary. Queried via <code>@></code>, <code>?</code>, and <code>jsonb_path_ops</code> GIN index.

'''content_fts''' -- <code>tsvector</code> column, populated by a trigger with three weights: A=title, B=<code>tags.summary</code>+<code>tags.headnote_classification</code> (read from JSONB), C=<code>coalesce(body_search, body)</code> with HTML tags stripped. Uses the appropriate language configuration (derived from <code>language</code> or <code>jurisdiction</code>). NULL for CJK languages (Chinese, Japanese, Korean) which require pgroonga or zhparser instead of PostgreSQL built-in FTS. See [[Corpus/FTS|FTS]] for full trigger details.

'''ingested_at''' -- Timestamp of first ingestion. <code>DEFAULT now()</code>. Not updated on re-ingestion -- use <code>tags</code> for versioning metadata if needed.

----

== Indexes ==

<syntaxhighlight lang="sql">
-- B-tree indexes on promoted columns
CREATE INDEX idx_doc_kind ON corpus.documents (kind);
CREATE INDEX idx_doc_jurisdiction ON corpus.documents (jurisdiction);
CREATE INDEX idx_doc_source ON corpus.documents (source);
CREATE INDEX idx_doc_date ON corpus.documents (date);
CREATE INDEX idx_doc_date_end ON corpus.documents (date_end) WHERE date_end IS NOT NULL;
CREATE INDEX idx_doc_parent ON corpus.documents (parent_id) WHERE parent_id IS NOT NULL;
CREATE INDEX idx_doc_kind_juris ON corpus.documents (kind, jurisdiction);
CREATE INDEX idx_doc_kind_source ON corpus.documents (kind, source);

-- GIN index on tags
CREATE INDEX idx_doc_tags ON corpus.documents USING GIN (tags jsonb_path_ops);

-- Partial GIN indexes per kind (FTS isolation)
CREATE INDEX idx_doc_fts_legislation ON corpus.documents USING GIN (content_fts) WHERE kind = 'legislation';
CREATE INDEX idx_doc_fts_decision ON corpus.documents USING GIN (content_fts) WHERE kind = 'decision';
CREATE INDEX idx_doc_fts_record ON corpus.documents USING GIN (content_fts) WHERE kind = 'record';
CREATE INDEX idx_doc_fts_notice ON corpus.documents USING GIN (content_fts) WHERE kind = 'notice';
</syntaxhighlight>

=== Why partial GIN indexes per kind instead of table partitioning ===

Partitioning <code>documents</code> by <code>kind</code> would require <code>kind</code> in the primary key (PostgreSQL requires the partition key in the PK). That means <code>id</code> alone can no longer be a PK -- every FK, every edge reference, every external link would need to carry <code>(id, kind)</code> instead of just <code>id</code>. The complexity cascades through the entire system.

Partial GIN indexes achieve 80% of the performance benefit with 0% of the complexity. When a query filters <code>WHERE kind = 'legislation' AND content_fts @@ ...</code>, PostgreSQL uses the partial index <code>idx_doc_fts_legislation</code> which contains only legislation tsvectors. The planner skips the other kinds entirely. Index size is smaller, scans are faster, and the PK stays a simple <code>text</code> column.

No partial index for <code>section</code> and <code>chunk</code> because they rarely have <code>body</code>/<code>body_search</code> content worth full-text indexing.

----

== Schema: corpus.edges ==

<syntaxhighlight lang="sql">
CREATE TABLE corpus.edges (
id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
source_id text NOT NULL,
target_id text,
kind text NOT NULL,
reference text,
properties jsonb DEFAULT '{}',
UNIQUE (source_id, target_id, kind)
);

CREATE INDEX idx_edge_source ON corpus.edges (source_id);
CREATE INDEX idx_edge_target ON corpus.edges (target_id) WHERE target_id IS NOT NULL;
CREATE INDEX idx_edge_kind ON corpus.edges (kind);
</syntaxhighlight>

=== Column definitions ===

'''id''' -- Synthetic identity, <code>bigint GENERATED ALWAYS AS IDENTITY</code>. Edges have no natural key.

'''source_id''' -- The document that originates the relationship. Not a foreign key.

'''target_id''' -- The document that receives the relationship. Nullable: an unresolved reference (a citation to a document not yet ingested, or a reference to an external system) has <code>target_id = NULL</code> and <code>reference</code> containing the raw citation text. Once the target is ingested or resolved, <code>target_id</code> is backfilled.

'''kind''' -- Relationship type. Open vocabulary. Examples: <code>cites</code>, <code>amends</code>, <code>repeals</code>, <code>implements</code>, <code>transposes</code>, <code>overrules</code>, <code>affirms</code>, <code>commences</code>, <code>language_variant</code>. See [[Corpus/Edge types|EDGE-TYPES]] for the full taxonomy.

'''reference''' -- Raw citation text as found in the source document. Preserved even after resolution for traceability. Example: <code>"article L. 121-1 du code de la consommation"</code>.

'''properties''' -- JSONB metadata on the relationship. Standard provenance keys (see ADR: edge pipeline architecture, design-decisions/2026-04-22-edge-pipeline-architecture.md):

* <code>extraction</code>: <code>"publisher_provided"</code> (source has a structured link) or <code>"id_resolved"</code> (textual reference resolved by the reference resolver).
* <code>source_type</code>: identifies the source system (<code>legi_lien</code>, <code>cellar_sparql</code>, <code>hudoc_appno</code>, <code>cellar_nim</code>).
* <code>raw_link_type</code>: source-native link type preserved for traceability (e.g., <code>"TRANSPOSITION"</code>, <code>"cdm:resource_legal_amends_resource_legal"</code>).

Type-specific examples: <code>{"scope": "partial", "articles": ["1", "2", "3"]}</code> for partial amendments, <code>{"commencement_date": "2024-01-01", "territorial_extent": "england_and_wales"}</code> for UK effects, <code>{"reservation": "sous reserve de..."}</code> for conditional constitutionality decisions.

=== Quarantine model ===

Edges with unresolved targets are stored with <code>target_id = NULL</code> and the raw citation in <code>reference</code>. They are visible to MCP and queryable for monitoring. The partial unique index <code>idx_edge_unique_without_target ON (source_id, reference, kind) WHERE target_id IS NULL</code> prevents duplicate quarantine entries.

'''Ownership:''' an edge is owned by the jurisdiction prefix of its <code>source_id</code>. Drop-and-reingest for jurisdiction X deletes edges WHERE <code>source_id LIKE '{x}.%'</code>. Cross-jurisdiction quarantine edges (e.g., EU NIM → FR target) survive the target jurisdiction's reingest.

'''Reconciliation:''' after each jurisdiction ingest, a post-ingest pass attempts to resolve quarantine edges whose reference matches the freshly ingested jurisdiction. Resolved → <code>UPDATE target_id</code>. Still unresolved → remains in quarantine.

=== Why no foreign keys ===

At 50M+ edges, FK checks on every insert become a measurable bottleneck. Sources are ingested independently and in parallel -- a French decision citing a EU directive may be ingested before the directive itself. FKs would either block ingestion order or require two-pass inserts.

Orphan cleanup runs periodically (post-ingest batch job), not on every write.

----

== Schema: corpus.tag_stats ==

<syntaxhighlight lang="sql">
CREATE TABLE corpus.tag_stats (
kind text NOT NULL,
jurisdiction text NOT NULL,
tag_key text NOT NULL,
tag_value text NOT NULL,
count integer DEFAULT 0,
PRIMARY KEY (kind, jurisdiction, tag_key, tag_value)
);
</syntaxhighlight>

Refreshed post-ingest, incrementally per source. Provides instant faceted counts without scanning <code>documents</code>.

Must handle both scalar and array tag values. For scalar tags, count directly. For array tags (e.g., <code>tags.themes = ["droit civil", "responsabilite"]</code>), use <code>jsonb_array_elements_text</code> to explode the array and count each element individually.

----

== Kind taxonomy ==

6 structural values. These classify document shape, not legal category.

{| class="wikitable"
! Kind !! What it is !! What it is NOT !! Examples
|-
| <code>legislation</code> || Creates, interprets, or defines a rule. Normative or quasi-normative content. || Not a resolution of a specific dispute. || Statute, regulation, decree, circular, directive, fatwa, ministerial order, regulatory handbook
|-
| <code>decision</code> || Resolves a specific dispute or case. Issued by a court or quasi-judicial body. || Not a general rule, even if it sets precedent. || Judgment, ruling, order, arbitral award, AG opinion
|-
| <code>record</code> || Factual registration in an official registry. || Not normative, not adjudicative. || Company filing, trademark registration, patent, land title, birth certificate
|-
| <code>notice</code> || Official announcement or publication. Time-bound, informational. || Not normative long-term. || Gazette entry, public consultation, tender, regulatory announcement
|-
| <code>section</code> || Structural subdivision of another document. Has a <code>parent_id</code>. || Not a standalone document. || Part, title, chapter, article, schedule, annex
|-
| <code>chunk</code> || Processing artifact. A fragment of a document created for search or embedding. || Not an editorial unit. || Paragraph-level split for RAG, embedding chunk
|}

=== Disambiguation rule ===

When a document is ambiguous:

# Does it resolve a specific dispute between parties? -> <code>decision</code>
# Does it create, interpret, or define a general rule? -> <code>legislation</code>
# Still ambiguous? -> <code>legislation</code>

The legal category goes in <code>tags.type</code> (e.g., <code>"type": "sumula_vinculante"</code>, <code>"type": "tesis_jurisprudencial"</code>).

=== Stress-test: ambiguous documents across jurisdictions ===

{| class="wikitable"
! Document !! Jurisdiction !! Kind !! Rationale
|-
| Sumula vinculante || BR || <code>legislation</code> || Binding precedent abstract, creates a general rule. Not resolving a specific dispute.
|-
| Tesis jurisprudencial || MX || <code>legislation</code> || Abstracted legal thesis from repeated rulings. General rule, not a specific dispute.
|-
| Judicial interpretation (司法解释) || CN || <code>legislation</code> || Supreme People's Court quasi-legislation. Creates binding rules of general application.
|-
| Dictamen CGR || CL || <code>legislation</code> || Comptroller General opinion. Interprets administrative law generally.
|-
| AG Opinion (CJEU) || EU || <code>decision</code> || Issued in the context of a specific case, advises on its resolution.
|-
| FCA Handbook || GB || <code>legislation</code> || Financial Conduct Authority regulatory rules. Normative, not case-specific.
|-
| Fatwa || SA || <code>legislation</code> || Religious-legal ruling of general application. Interprets Islamic law.
|-
| Administrative guidance (通達 tsutatsu) || JP || <code>legislation</code> || Ministry directive to subordinate agencies. General rule, not dispute resolution.
|-
| Restatement section || US || <code>legislation</code> || Scholarly synthesis of common law rules. General rule formulation.
|-
| Grundsatzentscheidung || DE || <code>decision</code> || Federal Court principle decision. Resolves a specific case, even if it sets precedent.
|-
| Arret de principe || FR || <code>decision</code> || Cour de cassation principle ruling. Resolves a specific dispute.
|-
| Sentenza interpretativa di rigetto || IT || <code>decision</code> || Constitutional Court interpretive rejection. Resolves a specific constitutional question.
|-
| Advisory Opinion (ICJ) || INT || <code>decision</code> || Issued on a specific question referred by a UN organ.
|-
| Pleno no jurisdiccional || ES || <code>decision</code> || Supreme Court plenary agreement. Resolves doctrinal conflict arising from cases.
|-
| Bepaling van algemene strekking || NL || <code>legislation</code> || General binding regulation. Normative, not case resolution.
|-
| Constitutional Court communique || TR || <code>legislation</code> || Press release summarizing a decision. Informational/normative summary.
|-
| Practice Direction || GB || <code>legislation</code> || Court-issued procedural rules. General application.
|-
| Reglement grand-ducal || LU || <code>legislation</code> || Grand-ducal regulation. Normative.
|-
| Acordao vinculante STF || BR || <code>decision</code> || Binding Supreme Court judgment. Resolves a specific case.
|-
| Royal Decree (مرسوم ملكي) || SA || <code>legislation</code> || Royal legislative act. Creates general rules.
|-
| Verfassungsbeschwerde decision || DE || <code>decision</code> || Constitutional complaint resolution. Specific dispute.
|-
| Recurso extraordinario || BR || <code>decision</code> || Extraordinary appeal. Resolves a specific case.
|-
| EU Regulation || EU || <code>legislation</code> || Directly applicable legislation. General normative act.
|-
| OHADA Uniform Act || INT || <code>legislation</code> || Harmonized commercial law. General normative act.
|-
| Tax ruling (rescrit) || FR || <code>legislation</code> || Tax authority interpretation. General application (even if triggered by a specific request).
|}

----

== Benchmark results ==

Measured on 3.4M rows, PostgreSQL 16, single-node, 16 GB RAM.

{| class="wikitable"
! Query !! Corpus schema !! Previous 16-table schema !! Speedup
|-
| Tag filter + date range || 0.9 ms || — || B-tree scan, instant
|-
| FTS + tag filter (broad, 111K results) || 4.4 s || 31 s || 7x faster (BitmapAnd vs Seq Scan)
|-
| Tag-only + date || 1.4 ms || — || B-tree scan, instant
|-
| FTS narrow (17K results, warm) || 565 ms || — || Partial GIN index
|-
| Get by ID || 0.3 ms || 0.3 ms || PK lookup
|-
| Tag discovery (GROUP BY court, 3.4M rows) || 2.7 s || — || Seq scan — justifies tag_stats
|}

The FTS speedup comes from BitmapAnd of GIN (FTS) + GIN (tags) indexes. The previous schema used a Parallel Seq Scan because the planner could not combine B-tree (court column) with GIN (FTS) efficiently.

----

== Operational notes ==

'''No FK on edges or parent_id.''' Foreign keys on multi-million row tables with parallel ingestion from independent sources create ordering constraints and lock contention that outweigh referential safety. Orphan detection runs as a periodic batch job.

'''Partial GIN indexes per kind.''' See the indexes section. Keeps FTS index sizes small, avoids partitioning complexity.

'''WHERE IS DISTINCT FROM in upserts.''' Use <code>IS DISTINCT FROM</code> instead of <code>!=</code> in <code>ON CONFLICT ... DO UPDATE SET ... WHERE</code> clauses. <code>!=</code> returns NULL when comparing with NULL (and the row is not updated), while <code>IS DISTINCT FROM</code> treats NULL as a comparable value. Critical for columns like <code>date_end</code>, <code>body_search</code>, <code>language</code> that are frequently NULL.

'''Autovacuum tuning.''' Set <code>autovacuum_vacuum_scale_factor = 0.01</code> on <code>corpus.documents</code>. The default (0.2) means autovacuum triggers after 20% of rows are dead -- on a 3.4M row table, that is 680K dead rows before cleanup. At 0.01, it triggers at 34K dead rows, keeping bloat and index performance under control.

'''Estimated counts at scale.''' <code>COUNT(*) OVER()</code> becomes expensive above 100M rows. Use <code>EXPLAIN</code>-based row estimates or <code>pg_class.reltuples</code> for approximate counts in paginated APIs. Exact counts only when explicitly requested.

'''CJK full-text search.''' PostgreSQL built-in FTS does not support Chinese, Japanese, or Korean tokenization. <code>content_fts</code> is NULL for CJK documents. Use pgroonga (all three languages) or zhparser (Chinese only) as an extension. CJK search queries must use a different code path.

'''Partitioning at CN scale.''' At 130M+ rows (realistic for a full Chinese legal corpus), partition <code>documents</code> by <code>jurisdiction</code>. This is the one case where partitioning is justified: queries almost always filter by jurisdiction, and partition pruning eliminates entire shards. The composite PK concern is manageable when partitioning by a column that is already always present in queries.

----

== corpus.source_metadata ==

Tracks data sources, their static descriptive metadata, and dynamic statistics recomputed at the end of each ingest cycle.

<syntaxhighlight lang="sql">
CREATE TABLE corpus.source_metadata (
source_key text PRIMARY KEY,
parent_source_key text,
jurisdiction text NOT NULL,
name text NOT NULL,
description text NOT NULL,
kind text NOT NULL DEFAULT 'legislation',
publisher text NOT NULL,
publisher_url text NOT NULL,
license text NOT NULL,
license_url text NOT NULL,
language text NOT NULL DEFAULT 'fr',
coverage_start_year integer,
document_count integer,
freshest_document_date date,
last_file text,
source_updated date,
ingested_at timestamptz
);
</syntaxhighlight>

Used by the MCP server (guidelines, data freshness display) and the portal. Sub-sources (e.g., <code>bodacc_pcl</code>) have <code>parent_source_key</code> set.

=== Static vs dynamic columns ===

* '''Static''' (written by <code>sync_source_registry()</code> at init from <code>SOURCE_REGISTRY</code>): <code>source_key</code>, <code>parent_source_key</code>, <code>jurisdiction</code>, <code>name</code>, <code>description</code>, <code>kind</code>, <code>publisher</code>, <code>publisher_url</code>, <code>license</code>, <code>license_url</code>, <code>language</code>.
* '''Dynamic''' (written by <code>refresh_corpus_stats()</code> at the end of each ingest cycle, including the dedup steps inside <code>run_post_ingest()</code>): <code>coverage_start_year</code> (= <code>MIN(date)</code> per source), <code>document_count</code> (= <code>COUNT(*)</code> per source), <code>freshest_document_date</code> (= <code>MAX(date)</code> per source). Top-level parent rows that have sub-sources are populated by a SUM/MIN/MAX rollup over their children.
* '''Operational''' (written by <code>state.set_ingest_state()</code> per ingest run): <code>last_file</code>, <code>source_updated</code>, <code>ingested_at</code>. These track pipeline state, not content state, and are not displayed in MCP responses.

<code>sync_source_registry()</code> MUST NOT touch dynamic columns — they would be reset to NULL on every init. The INSERT and <code>ON CONFLICT DO UPDATE SET</code> clauses only list static columns.

----

== Required PostgreSQL extensions ==

<syntaxhighlight lang="sql">
CREATE EXTENSION IF NOT EXISTS unaccent; -- accent-insensitive FTS
-- Optional (for CJK jurisdictions):
-- CREATE EXTENSION IF NOT EXISTS pgroonga; -- CJK full-text search
</syntaxhighlight>

----

== Complete DDL execution order ==

# <code>CREATE SCHEMA corpus;</code>
# <code>CREATE EXTENSION IF NOT EXISTS unaccent;</code>
# <code>CREATE TABLE corpus.documents (...);</code> (14 columns)
# <code>CREATE TABLE corpus.edges (...);</code>
# <code>CREATE TABLE corpus.tag_stats (...);</code>
# <code>CREATE TABLE corpus.source_metadata (...);</code>
# <code>CREATE FUNCTION corpus.normalize_for_fts(...);</code> (see [[Corpus/FTS|FTS]])
# <code>CREATE FUNCTION corpus.update_content_fts(...);</code> (see [[Corpus/FTS|FTS]])
# <code>CREATE TRIGGER trg_content_fts ...;</code>
# All indexes (B-tree, GIN, partial GIN)
# <code>ANALYZE corpus.documents;</code>

For the graph schema (future): <code>CREATE SCHEMA graph;</code> + tables from [[Corpus/Graph|GRAPH]].

----

== ID format convention ==

Document IDs use source-native identifiers, always '''lowercase'''. Rules:

* All document IDs carry a lowercase jurisdiction prefix: <code>{jurisdiction}.{source_id}</code> (e.g., <code>fr.legiarti000006902764</code>, <code>fr.juritext000041701651</code>, <code>fr.cetatext000046783006</code>, <code>eu.eurlextext32016r0679</code>).
* Identifiers with built-in jurisdiction context (ECLI:*, CELEX:*, [year] UKSC) may omit the prefix.
* For non-legal registries where the source ID could collide, use <code>{jurisdiction}.{source}.</code> (e.g., <code>fr.company.443061841</code>, <code>gb.company.12345678</code>).
* Decision: the ingest plugin author determines the prefix format, documented in the plugin's tag schema.

----

== Bidirectional edges convention ==

Some edge types are logically bidirectional (<code>language_variant</code>, <code>corresponds_to</code>, <code>associated_text</code>, <code>joined_with</code>, <code>pilot_follower</code>). The convention:

* Store ONE edge, not two.
* Pick a canonical direction (alphabetical by source_id, or the "primary" document in the pair).
* Queries for bidirectional edges check both directions: <code>WHERE (source_id = X OR target_id = X) AND kind = 'language_variant'</code>.

----

== Jurisdiction subdivision mapping in FTS trigger ==

The trigger resolves language from <code>coalesce(language, jurisdiction)</code>. For subdivision jurisdictions like <code>gb-sct</code>, <code>es-ct</code>, <code>de-by</code>:

* If <code>language</code> is set (recommended for subdivisions), it is used directly.
* If <code>language</code> is NULL, the trigger extracts the country prefix: <code>split_part(jurisdiction, '-', 1)</code> → <code>gb</code>. Since <code>gb</code> is not a language code in the mapping (the mapping uses ISO 639-1 codes like <code>en</code>), it falls through to <code>simple</code>. Set <code>language = 'en'</code> explicitly for English-language jurisdictions like <code>gb</code>, <code>gb-sct</code>, <code>us</code>.

This extraction is in the FTS trigger code (see [[Corpus/FTS|FTS]]).

----

== Migration strategy ==

Migration from the current 16-table schema is incremental and reversible:

# Create <code>corpus.*</code> tables alongside existing tables (coexistence).
# Migrate one kind at a time with SQL INSERT...SELECT scripts (decision first — largest and most exercised).
# Benchmark each migrated kind against the equivalent old-table queries.
# Adapt the MCP server to read from <code>corpus.documents</code> (dual-read during transition).
# Switch MCP tools one by one (search first, then get, then browse).
# When all tools read from <code>corpus.*</code>, drop old tables.
# Migrate <code>citations</code> → <code>corpus.edges</code> (same process).
# Refresh <code>corpus.tag_stats</code>.

Rollback: during coexistence, the old tables are still the source of truth. If migration fails, revert MCP to old tables.

[[Category:Corpus]]

MCP/Tools

Nicolas — Thu, 23 Apr 2026 02:05:18 GMT

Create MCP/Tools page from MCP-TOOLS.md (via create-page on MediaWiki MCP Server)

New page

= MCP Tools =

Dura Lex exposes 5 MCP tools. All are jurisdiction-agnostic. Jurisdiction plugins provide tag schemas, formatters, and reference resolvers — not tools.

== search ==

Search the corpus with full-text search, tag filters, and faceted discovery.
ALL filters go in the <code>tags</code> parameter. Tag values support Overpass QL-inspired
operators (see Tag filter operators below).

<syntaxhighlight lang="text">
search(
language: str # REQUIRED — ISO 639-1 (fr, en, de, ar...)
query: str | None # FTS query (websearch syntax: AND, OR, "phrase", -exclude)
tags: dict | None # ALL filters — kind, jurisdiction, source, court, etc.
edges: dict | None # Edge filters — key=edge kind, value=target document ID
discover: str | None # tag key to discover values for, or "*" for available keys
at_date: str | None # historical date (YYYY-MM-DD) — versions in force at that date
date_from: str | None # minimum date (YYYY-MM-DD)
date_to: str | None # maximum date (YYYY-MM-DD)
should_expand_synonyms: bool = true # expand query with legal synonyms
limit: int = 20 # results per page (max 100)
offset: int = 0 # pagination offset
)
</syntaxhighlight>

=== Tag filter operators (Overpass QL-inspired) ===

Tag values support these operators:

* <code>"value"</code> — exact match (default)
* <code>"!=value"</code> — negation: key exists, value differs
* <code>"val1|val2"</code> — any of (OR)
* <code>"!=val1|val2"</code> — none of (negated OR)
* <code>"*"</code> — key exists (any value)
* <code>"!*"</code> — key absent

=== Virtual tag keys (promoted columns filterable as tags) ===

* <code>kind</code>: <code>legislation</code>, <code>decision</code>, <code>record</code>, <code>notice</code>. Operators: <code>"legislation|decision"</code>, <code>"!=record"</code>. Drives the fan-out UNION ALL query.
* <code>jurisdiction</code> (REQUIRED): ISO code. Subdivision-aware: <code>"fr"</code> matches <code>fr</code>, <code>fr-alsace</code>. Multi: <code>"eu|fr"</code>. Wildcard: <code>"*"</code> (no filter). Negation: <code>"!=eu"</code>. '''Omitting <code>tags["jurisdiction"]</code> raises a ToolError''' — the LLM must always be explicit about jurisdiction scope.
* <code>source</code>: data source. <code>"legi"</code>, <code>"cass"</code>, <code>"acco"</code>, <code>"kali"</code>... Exclusion: <code>"!=acco|kali"</code>.
* <code>language</code>: overrides the auto-filter from the <code>language</code> parameter. <code>"fr|en"</code> returns French AND English.

=== Primary tag filters (T1) ===

T1 tags (cross-jurisdiction enums, documented in TAG-CONVENTIONS.md) are the intended primary search filters — stable English vocabularies, safe to use regardless of jurisdiction: <code>type</code>, <code>document_form</code>, <code>court_level</code>, <code>enforcement_status</code>, <code>importance_level</code>, <code>formation_solemnity</code>, <code>content_quality</code>. For jurisdiction-local precision, fall back to T2/T3 keys (e.g. FR <code>nature</code>) — see <code>spec/TAG-CONVENTIONS.md</code> and the per-plugin tag references.

=== Edge filters ===

The <code>edges</code> parameter filters documents by their relationships to other
documents. Key = edge kind (from EDGE-TYPES.md), value = target document ID.
Semantics: return documents that have an outgoing edge of this kind to this
target.

{| class="wikitable"
! Syntax !! Semantics
|-
| <code>"cites": "id1"</code> || cites id1
|-
| <code>"cites": "id1|id2"</code> || cites id1 OR id2
|-
| <code>"cites": "id1&id2"</code> || cites id1 AND id2
|-
| <code>"cites": "id1", "amends": "id2"</code> || cites id1 AND amends id2
|-
| <code>"*": "id1"</code> || any edge kind to id1
|}

Edge filters compose with all other search parameters (query, tags, dates,
pagination). The <code>edges</code> parameter is separate from <code>tags</code> because edges are
relationships between documents, not intrinsic properties.

=== Searchable kinds ===

The search tool only accepts <code>legislation</code>, <code>decision</code>, <code>record</code>, and <code>notice</code> as <code>kind</code> values. <code>section</code> (navigated via <code>browse_structure</code>) and <code>chunk</code> (processing artifact) are valid document kinds in the corpus but are filtered out of search.

=== Modes ===

* '''Search mode''' (query and/or tags provided): FTS + tag filters + date range. Returns ranked results with snippets.
* '''Browse mode''' (tags only, no query): returns documents matching tag filters, ordered by date descending.
* '''Discover mode''' (discover parameter set): returns distinct values for the given tag key from <code>tag_stats</code>. Use <code>discover="*"</code> to list all available tag keys. Use <code>discover="edge_kinds"</code> to list available edge kinds.

=== Examples ===

All examples pass <code>tags["jurisdiction"]</code> (REQUIRED).

<syntaxhighlight lang="text">
search(language="fr", query="responsabilite civile", tags={"jurisdiction": "fr", "kind": "decision", "court": "cassation"})
search(language="fr", tags={"jurisdiction": "fr", "kind": "legislation", "type": "collective_agreement", "idcc": "3239"})
search(language="fr", tags={"jurisdiction": "fr", "kind": "legislation", "source": "acco", "type": "collective_agreement"})
search(language="fr", tags={"jurisdiction": "fr", "kind": "decision"}, discover="court")
search(language="fr", discover="*", tags={"jurisdiction": "fr", "kind": "decision"})
search(language="fr", query="article 1240", tags={"jurisdiction": "fr", "kind": "legislation"}, at_date="2015-06-15")
search(language="fr", tags={"jurisdiction": "fr", "kind": "decision", "importance_level": "highest_importance"})
search(language="fr", tags={"jurisdiction": "fr", "kind": "decision", "official_grade": "A"})
search(language="fr", tags={"jurisdiction": "eu|fr", "kind": "decision", "court_level": "supreme|supranational"}) # apex-court rulings only

# Overpass QL operators
search(language="fr", tags={"jurisdiction": "fr", "kind": "legislation", "source": "!=acco|kali"}) # exclude conventions
search(language="fr", tags={"jurisdiction": "eu|fr", "kind": "legislation|decision"}) # multi-kind, multi-jurisdiction
search(language="fr", tags={"jurisdiction": "*", "kind": "decision", "official_grade": "*"}) # all jurisdictions, only graded decisions

# Edge filters
search(language="fr", tags={"jurisdiction": "fr", "kind": "decision"}, edges={"cites": "fr.legiarti000032041571"}) # decisions citing article 1240 code civil
search(language="fr", query="preuve deloyale", tags={"jurisdiction": "fr"}, edges={"cites": "fr.legiarti000032041571"}) # + FTS
search(language="fr", tags={"jurisdiction": "fr"}, edges={"cites": "fr.legiarti000032041571&fr.legiarti000006436298"}) # citing both articles
search(language="fr", tags={"jurisdiction": "fr"}, edges={"*": "fr.jorftext000032004539"}) # any relationship to this law
search(language="fr", tags={"jurisdiction": "fr"}, discover="edge_kinds") # list available edge kinds
</syntaxhighlight>

== get_document ==

Retrieve a single document by ID or legal reference.

<syntaxhighlight lang="text">
get_document(
reference: str # document ID or natural language reference
language: str # REQUIRED — ISO 639-1 (fr, en, de...). Disambiguates language variants.
highlight: str | None # select matching blocks (non-contiguous, ±1 context, capped at 40)
blocks: str | None # block range for large documents ("30-50")
at_date: str | None # historical date (YYYY-MM-DD) — version in force at that date
)
</syntaxhighlight>

The reference resolver (jurisdiction-specific) parses the reference into a TagQuery and executes it against the store. Falls back to direct ID lookup. For decisions, the output includes grade and formation display: <code>Grade : A — Publié au Recueil Lebon — highest_importance</code> / <code>Formation : Assemblée du contentieux (full_court)</code>.

=== Examples ===

<syntaxhighlight lang="text">
get_document(reference="article 1240 du code civil")
get_document(reference="fr.juritext000041701651", highlight="preuve deloyale")
get_document(reference="[2024] UKSC 1")
</syntaxhighlight>

== browse_structure ==

Navigate hierarchical structure (table of contents of codes, conventions, doctrine).

<syntaxhighlight lang="text">
browse_structure(
language: str # REQUIRED — filters the tree (not just labels)
tags: dict # REQUIRED, must contain "jurisdiction"
root_id: str | None # node ID to start from (NULL = top-level roots)
depth: int | None # maximum tree depth (capped at 20 internally)
limit: int = 50 # max nodes returned per page
offset: int = 0 # pagination offset
)
</syntaxhighlight>

<code>tags["jurisdiction"]</code> is REQUIRED — same syntax as <code>search</code>: <code>"fr"</code>, <code>"eu"</code>,
<code>"eu|fr"</code> (combined), <code>"*"</code> (all jurisdictions). Other tag filters
(e.g., <code>"structure_type": "legislation"</code>) are passed through as JSONB
containment filters.

Operates on documents with <code>kind=section</code>. Uses recursive CTE on <code>parent_id</code>.
The jurisdiction and language filters are applied to BOTH the anchor and the
recursive part of the CTE so a parent's children inherit the same scope (no
mixed-jurisdiction or mixed-language trees). Multi-jurisdiction uses
<code>s.jurisdiction = ANY(%(jurisdictions)s)</code> in both anchor and recursive WHERE.

== safety_guidelines ==

Retrieve mandatory guidelines for legal research. Two-call workflow: <code>core</code> once at session start, <code>jurisdiction</code> per jurisdictional context.

<syntaxhighlight lang="text">
safety_guidelines(
category: str # REQUIRED — "core" or "jurisdiction"
jurisdiction: str | None # REQUIRED iff category="jurisdiction"; ignored (with warning) if category="core"
)
</syntaxhighlight>

=== Categories ===

* <code>"core"</code>: foundational rules (8 non-negotiable, methodology, defensive posture, response format). Independent of jurisdiction. Called ONCE per session. Passing <code>jurisdiction</code> is non-fatal: the parameter is ignored and a warning is prepended to the returned text instructing the LLM to make a separate <code>category="jurisdiction"</code> call.
* <code>"jurisdiction"</code>: jurisdiction-specific rules + corpus provenance filtered by jurisdiction. Called when entering a jurisdictional research context. Supports the same Overpass QL syntax as <code>tags["jurisdiction"]</code>: <code>"fr"</code>, <code>"eu"</code>, <code>"eu|fr"</code> (concatenated), <code>"*"</code> (all jurisdictions), <code>"!=eu"</code> (exclusion). The <code>"!*"</code> operator is not allowed.

Returns jurisdiction-specific guidance: citation rules, search strategy, authority hierarchy, data freshness, caveats.

The plugin protocol (<code>get_guidelines() -> str</code>) returns a single jurisdiction-scoped supplement; the core text lives in <code>duralex.mcp/core.md</code> and is loaded by the MCP server, not by plugins.

== quality_check ==

Mandatory research debrief. Fire-and-forget. Two modes:
* <code>research</code> — called ONCE per research sequence, at the END, before presenting the answer to the user. Captures the full research journey.
* <code>correction</code> — called immediately when the model detects an error, or when the user signals one.

PRIVACY: ABSOLUTE. Only technical and structural data. Never user facts, names, conversation content, or anything that could identify a party.

<syntaxhighlight lang="text">
quality_check(
mode: str # "research" or "correction"
model: str # LLM model identifier
jurisdiction: str | None # jurisdiction(s) researched (fr, eu, eu|fr, *) — always include

# Research-mode fields
queries_attempted: list[str] | None # legal-concept queries (no user facts)
tools_sequence: list[str] | None # ordered tool calls (e.g. ["search","get_document"])
documents_cited: list[str] | None # IDs of documents cited in the answer
tags_used: dict | None # tag filters applied
satisfaction: str | None # sufficient | partial | insufficient
confidence: str | None # high | moderate | low
gaps: list[str] | None # coverage gaps identified
difficulties: list[str] | None # technical issues encountered
concept: str | None # legal concept label for synonym groups

# Correction-mode fields
error_type: str | None # fabricated_citation | wrong_jurisdiction
# | repealed_law | misattribution
# | temporal_error | wrong_article
# | user_correction
document_ids: list[str] | None # documents involved in the error
detail: str | None # technical description (no user facts)
severity: str | None # critical | important | minor

# Self-audit checklist (11 booleans, all default False)
# Pure presence-of-string checks on the pending response / visible context.
# Declared-true values trigger adaptive alerts tiered STOP / DANGER /
# DRIFT / ATTENTION; the tool returns a structured block the model must
# translate-and-relay to the user before emitting.
context_contains_compaction_marker: bool
response_self_references_previous_turn: bool
response_contains_flattery: bool
response_contains_prescriptive_legal_advice: bool
response_contains_outcome_prediction: bool
response_contains_legal_assertion_verb: bool
response_contains_hedge_marker: bool
response_cites_document_without_verbatim_or_locator: bool
response_cites_document_without_permanent_link: bool
response_claims_settled_case_law: bool
response_asserts_legal_absence_as_inexistence: bool
safety_guidelines_not_fully_loaded: bool
safety_guidelines_distant_or_unclear: bool
)
</syntaxhighlight>

The feedback server is schema-agnostic; the tool adds <code>"tool_name": "quality_check"</code> automatically so downstream JSONL analysis can distinguish quality_check payloads from older <code>report</code> payloads.

The 11 self-audit booleans and the computed <code>highest_alert_severity</code> are persisted in the payload for forensic analysis of declaration rates per boolean. See ADR <code>2026-04-15-quality-check-self-audit-checklist</code> for the full rationale and the alert-severity tiering.

[[Category:MCP]]

Jurisdictions/FR

Nicolas — Thu, 23 Apr 2026 02:05:00 GMT

Create French jurisdiction reference page (via create-page on MediaWiki MCP Server)

New page

= French Legal System =

Jurisdiction code: <code>fr</code>. Language: <code>fr</code> (always required). Corpus size: 60M+ documents.

== Court hierarchy ==

France has four judicial orders: judicial (''judiciaire''), administrative (''administratif''), financial (''financier''), and constitutional (''constitutionnel''). Each has its own apex court.

=== court_level mapping (T1 tag) ===

{| class="wikitable sortable"
! court_level !! Court (court tag) !! Order !! Notes
|-
| <code>supreme</code> || Cour de cassation (<code>cour_cassation</code>) || Judicial || Controls law, not facts
|-
| <code>supreme</code> || Conseil d'Etat (<code>conseil_etat</code>) || Administrative || Also government advisor (''avis'' are not ''arrets'')
|-
| <code>supreme</code> || Cour des comptes (<code>cour_des_comptes</code>) || Financial || Apex since 2023 reform; 1st instance (contentious chamber) + cassation over CAF
|-
| <code>appellate</code> || Cour d'appel (<code>cour_appel</code>) || Judicial || Rejudges facts + law
|-
| <code>appellate</code> || Cour administrative d'appel (<code>cour_administrative_appel</code>) || Administrative ||
|-
| <code>appellate</code> || Tribunal superieur d'appel (<code>tribunal_superieur_appel</code>) || Judicial || Overseas territories
|-
| <code>appellate</code> || Cour d'appel financiere (<code>cour_appel_financiere</code>) || Financial || Created 2023; appeals from CRC and CdC contentious chamber
|-
| <code>first_instance</code> || Tribunal judiciaire (<code>tribunal_judiciaire</code>) || Judicial || General civil/criminal
|-
| <code>first_instance</code> || Conseil de prud'hommes (<code>conseil_prudhommes</code>) || Judicial || Labor
|-
| <code>first_instance</code> || Tribunal de commerce (<code>tribunal_commerce</code>) || Judicial || Commercial
|-
| <code>first_instance</code> || Tribunal administratif (<code>tribunal_administratif</code>) || Administrative ||
|-
| <code>first_instance</code> || Chambre regionale des comptes (<code>chambre_regionale_des_comptes</code>) || Financial || Local authorities
|-
| <code>first_instance</code> || Cour de discipline budgetaire et financiere (<code>cour_discipline_budgetaire_financiere</code>) || Financial || Abolished 2023 (integrated into CdC); historical decisions 1954-2022
|-
| <code>constitutional</code> || Conseil constitutionnel (<code>conseil_constitutionnel</code>) || Constitutional || QPC can invalidate provisions
|-
| ''null'' || Tribunal des conflits (<code>tribunal_conflits</code>) || Sui generis || Arbitrates judicial vs. admin jurisdiction
|-
| ''null'' || CNIL (<code>cnil</code>) || Independent authority || Data protection
|-
| ''null'' || CADA (<code>cada</code>) || Independent authority || Access to admin documents
|}

=== Source-to-court mapping ===

Multiple data sources cover overlapping courts. Always search by <code>court</code> tag, not <code>source</code>.

{| class="wikitable"
! Source !! System !! Courts covered
|-
| <code>cass</code>, <code>inca</code> || Judicial || Cour de cassation
|-
| <code>capp</code> || Judicial || Cours d'appel
|-
| <code>judilibre</code> || Mixed || Cour de cassation + admin courts + cours d'appel (deduplicated)
|-
| <code>jade</code>, <code>ce_opendata</code> || Administrative || CE, CAA, TA, Tribunal des conflits
|-
| <code>jufi</code> || Financial || CdC, CRC, CDBF, CAF (~3,500 decisions, 1954-present)
|-
| <code>constit</code> || Constitutional || Conseil constitutionnel
|-
| <code>cnil</code> || Independent authority || CNIL sanctions
|-
| <code>cada</code> || Independent authority || CADA opinions
|}

=== Financial order — 2023 reform ===

Before 2023:
* Cour des comptes = appellate over CRC
* CDBF = separate disciplinary court

After 2023:
* Cour des comptes = apex (supreme): contentious chamber (absorbed CDBF) + cassation over CAF
* Cour d'appel financiere (CAF) = new appellate court
* CRC = first instance (unchanged)
* CDBF = abolished, historical decisions remain searchable

== Legislation types ==

=== Normative hierarchy ===

Constitution > treaties/EU law > ''loi'' > ''ordonnance ratifiee'' > ''decret'' > ''arrete'' > ''circulaire'' (not binding on courts)

=== Text types ===

{| class="wikitable"
! Type !! Description !! Tag example
|-
| Code || Consolidated legislation organized by topic || <code>tags={"code": "Code civil"}</code>
|-
| Loi || Parliament statute || <code>tags={"nature": "loi"}</code>
|-
| Loi organique || Organic law (constitutional-tier procedure) || <code>tags={"nature": "loi_organique"}</code>
|-
| Ordonnance || Government act under parliamentary authorization || <code>tags={"nature": "ordonnance"}</code>
|-
| Decret || Executive regulation || <code>tags={"nature": "decret"}</code>
|-
| Arrete || Ministerial/prefectoral order || <code>tags={"nature": "arrete"}</code>
|-
| Circulaire || Administrative interpretation (NOT in corpus) || See circulaires.gouv.fr
|}

=== Codification prefixes ===

{| class="wikitable"
! Prefix !! Origin !! Example
|-
| '''L.''' || Legislative (Parliament) — highest within a code || L.1234-5
|-
| '''R.''' || Regulatory (''decret en Conseil d'Etat'') || R.1234-5
|-
| '''D.''' || Regulatory (''decret simple'') || D.1234-5
|-
| '''A.''' || Ministerial order (''arrete'') || A.1234-5
|-
| ''No prefix'' || Old codes not recodified (Code civil, Code penal pre-1994) || 1240
|}

L. > R. within the same code. Same number with different prefix = different articles (L.1234-5 != R.1234-5).

=== Legislation sources: LEGI vs JORF ===

{| class="wikitable"
! Source !! Content !! Notes
|-
| <code>legi</code> || Consolidated legislation (versioned, with enforcement_status) || Preferred; shown in default search
|-
| <code>jorf</code> || Official gazette (original publication, no versioning) || Hidden from default search; use <code>tags={"source": "jorf"}</code>
|}

Same text exists in both with different IDs (LEGITEXT / JORFTEXT). ~4% of JORF texts have no LEGI counterpart (nominations, old texts).

=== Enforcement status ===

{| class="wikitable"
! Value !! Meaning !! Safety
|-
| <code>in_force</code> || Currently in force || Safe to cite
|-
| <code>deferred_enforcement</code> || Enacted but not yet applicable || Flag future effective date
|-
| <code>deferred_repeal</code> || Still in force until a future date || Cite but flag upcoming repeal
|-
| <code>repealed</code> || Repealed || NEVER cite as current law
|-
| <code>superseded</code> || Historical version, newer exists || Cite the newer version
|-
| <code>never_in_force</code> || Modified before effective date || Never cite
|-
| <code>expired</code> || Lapsed by sunset clause || No longer applicable
|-
| <code>annulled</code> || Struck down by court (typically retroactive) || Never cite
|-
| <code>transferred</code> || Content moved to different article (renumbering) || Cite new location
|-
| <code>denounced</code> || Collective agreement repudiated || No longer applies
|-
| <code>disjoined</code> || Version split into multiple articles || Cite resulting articles
|-
| <code>conditional</code> || In force under specific interpretation (constitutional reservation) ||
|-
| <code>pending</code> || Adopted but awaiting ratification ||
|}

== Publication grades (official_grade) ==

=== Administrative courts (PUBLI_RECUEIL system) ===

{| class="wikitable"
! Grade !! Label !! Courts !! importance_level
|-
| <code>A</code> || Publie au Recueil Lebon || CE, Tribunal des conflits || highest_importance
|-
| <code>B</code> || Mentionne aux Tables du Lebon || CE, Tribunal des conflits || high_importance
|-
| <code>R</code> || Interet jurisprudentiel majeur || CAA, TA (equivalent of A) || highest_importance
|-
| <code>C+</code> || Interet signale || CAA, TA (equivalent of B) || high_importance
|-
| <code>C</code> || Inedit || All admin courts || low_importance
|-
| <code>D</code> || Interet limite aux parties || All admin courts || minimal_importance
|-
| <code>Z</code> || Interet limite aux parties || All admin courts || minimal_importance
|}

=== Cour de cassation (post-2021, decisions after 2021-06-15) ===

{| class="wikitable"
! Grade !! Label !! importance_level
|-
| <code>rapport</code> || Selectionne pour le Rapport annuel || highest_importance
|-
| <code>bulletin</code> || Publie au Bulletin des arrets || high_importance
|-
| <code>diffuse</code> || Diffuse sur Legifrance || low_importance
|-
| <code>non_diffuse</code> || Non diffuse || minimal_importance
|}

=== Cour de cassation (pre-2021, decisions before 2021-06-15) ===

{| class="wikitable"
! Grade !! Former code !! Label !! importance_level
|-
| <code>rapport</code> || R || Rapport annuel || highest_importance
|-
| <code>bulletin</code> || P || Publie au Bulletin || high_importance
|-
| <code>bulletin_information</code> || B || Mentionne au BICC || medium_importance
|-
| <code>internet</code> || I || Diffuse sur internet || low_importance
|-
| <code>diffuse</code> || D || Diffuse aux bases || low_importance
|}

=== Lower courts (cour_appel, tribunal_judiciaire, tribunal_commerce) ===

{| class="wikitable"
! Grade !! Label !! importance_level !! Notes
|-
| <code>particular_interest</code> || Arret d'interet particulier || highest_importance || ~1,400 decisions out of 1.25M
|}

=== Financial courts (CdC, CRC, CDBF, CAF) ===

{| class="wikitable"
! Grade !! Label !! importance_level !! Notes
|-
| <code>recueil</code> || Publie au Recueil des juridictions financieres || high_importance || ~25% of decisions
|}

=== Default importance by court level (when no grade) ===

{| class="wikitable"
! Court level !! Default importance_level
|-
| cassation (supreme) || medium_importance
|-
| appel (appellate) || low_importance
|-
| premiere_instance (first_instance) || minimal_importance
|}

== Formation / solemnity system ==

Formations are ranked by ascending solemnity. Higher solemnity = greater jurisprudential authority.

=== Cour de cassation ===

{| class="wikitable"
! Formation !! Solemnity tag !! Notes
|-
| Formation restreinte (F, FRH, FRR) || <code>reduced_bench</code> || Minimum composition
|-
| Standard chamber (civ.1, civ.2, civ.3, com., soc., crim.) || <code>standard_bench</code> || Normal composition
|-
| Formation de section (FS) || <code>grand_bench</code> || Important questions
|-
| Formation pleniere de chambre (FP) || <code>grand_bench</code> || Full chamber
|-
| Chambre mixte (FM) || <code>combined_chambers</code> || Multiple chambers; outranks ''formation pleniere''
|-
| Assemblee pleniere || <code>full_court</code> || All chambers; highest authority
|}

Note: at the Cour de cassation, <code>combined_chambers</code> (Chambre mixte) outranks <code>grand_bench</code> (formation pleniere) — this diverges from the generic solemnity ordering.

=== Conseil d'Etat ===

{| class="wikitable"
! Formation !! Solemnity tag
|-
| Juge des referes || <code>single_judge</code>
|-
| Formation a 3 || <code>reduced_bench</code>
|-
| Chambre seule || <code>standard_bench</code>
|-
| Chambres reunies / SSR || <code>combined_chambers</code>
|-
| Section du contentieux || <code>grand_bench</code>
|-
| Assemblee du contentieux || <code>full_court</code>
|}

== Case number formats ==

{| class="wikitable"
! Court !! Format !! Example
|-
| Cour de cassation || <code>YY-NN.NNN</code> || 24-14.752
|-
| Cour d'appel / TJ || <code>YY/NNNNN</code> || 21/00091
|-
| Conseil d'Etat || <code>NNNNNN</code> (sequential) || 486329
|-
| TA / CAA || <code>YYLLNNNNN</code> (year + court code) || 24PA01233
|-
| Conseil constitutionnel || <code>YYYY-NNN TYPE</code> || 2021-823 DC
|-
| Tribunal des conflits || <code>CNNNN</code> || C4321
|-
| Cour des comptes || <code>S-YYYY-NNNN</code> || S-2025-0381
|-
| CDBF || <code>NNN-NNN</code> || 264-865
|}

Cass. pourvoi digits 3-4 correlate with chamber (80-89 = criminal, ~10-25 = civil/commercial/social).

== Labor law sources ==

{| class="wikitable"
! Source !! Content !! Tag
|-
| <code>kali</code> || Official collective agreement texts (DILA/Legifrance) || <code>tags={"source": "kali"}</code>
|-
| <code>acco</code> || Filed company agreements || <code>tags={"source": "acco"}</code>
|}

'''bargaining_level''' (T2 tag): <code>enterprise</code> (company agreement), <code>sectoral</code> (branch agreement). Also defined but not yet populated: <code>inter_sectoral</code>, <code>territorial</code>.

Each collective agreement has an IDCC number. IDCCs merge over time (e.g., metallurgy merged to IDCC 3248 in 2024).

== Doctrine sources ==

{| class="wikitable"
! Source !! Content !! Binding?
|-
| <code>bofip</code> || Tax administration interpretation (BOFiP) || Opposable to tax authority; NOT binding on courts
|-
| <code>cnil</code> || CNIL guidelines/recommendations || Soft law; widely followed as diligence standard
|-
| <code>cada</code> || CADA advisory opinions on document access || Advisory
|}

== What is NOT in the corpus ==

{| class="wikitable"
! Gap !! Alternative
|-
| First-instance decisions (TJ, CPH, TC) || Not systematically published
|-
| Academic doctrine (treatises, case commentaries) || Not available
|-
| Circulaires || circulaires.gouv.fr (not binding on courts)
|-
| Notarial practice and customs || Not available
|-
| Lower criminal court decisions || Sparse coverage (Cass. crim. is included)
|-
| Very recent enactments (< 48h) || Ingestion lag; flag for recent texts
|}

== Major reforms — renumbering traps ==

{| class="wikitable"
! Reform !! Effective !! Key changes
|-
| Obligations (ordonnance 2016-131) || 1 Oct 2016 || 1134->1103+1104, 1147->1231-1, 1382->1240, 1383->1241, 1384->1242. Contracts before 1 Oct 2016 use OLD articles.
|-
| Security interests (ordonnance 2021-1192) || 1 Jan 2022 || Reorganized Code civil Book IV (suretes)
|-
| Criminal justice for minors || 30 Sep 2021 || Code de justice penale des mineurs replaced 1945 ordonnance
|-
| Criminal procedure (loi 2024-364) || 1 Jul 2024 || Articles 63+ CPP (garde a vue) modified
|}

[[Category:Jurisdictions]]

Development/Testing

Nicolas — Thu, 23 Apr 2026 02:04:53 GMT

Create Testing conventions page from coding-conventions/TESTING.md (via create-page on MediaWiki MCP Server)

New page

= Testing Conventions =

All duralex-* packages follow these conventions for test organization, naming, and execution.

== Directory structure ==

Tests mirror the <code>src/duralex/</code> structure:

<pre>
tests/
├── conftest.py # shared fixtures for this repo
├── data/ # mirrors src/duralex/data/
│ ├── test_models.py
│ └── test_schema.py
├── temporal/ # mirrors src/duralex/temporal/
│ └── test_temporal_version.py
├── store/ # mirrors src/duralex/corpus/store/
│ ├── test_full_text_search_configuration.py
│ └── test_full_text_search_query_builder.py
├── integration/ # tests requiring external services
│ └── test_postgres_document_store.py
└── fixtures/ # real data files for tests
├── fr.legiarti000006436298.xml
├── fr.cetatext000046783006.xml
└── 5fdcdddd994f0448aad44c0b.json
</pre>

No <code>__init__.py</code> in test directories. Use <code>--import-mode=importlib</code> instead.

== Test naming ==

Pattern: <code>test_{what}_{scenario}</code>

<syntaxhighlight lang="python">
# What is being tested + specific scenario
def test_resolve_legal_reference_article_of_code():
def test_resolve_legal_reference_empty_string():
def test_resolve_legal_reference_unknown_pattern():
def test_resolve_legal_reference_pourvoi_number():

def test_parse_legislation_article_basic_fields():
def test_parse_legislation_article_missing_content():
def test_parse_legislation_article_multiple_versions():

def test_sanitize_html_content_strips_script_tags():
def test_sanitize_html_content_preserves_table_structure():
def test_sanitize_html_content_empty_input():
</syntaxhighlight>

The test name alone must tell an auditor what is being verified, without reading the body.

== Test body structure ==

Each test follows a clear three-section structure. Sections are separated by blank lines, not comments.

<syntaxhighlight lang="python">
def test_resolve_legal_reference_article_of_code():
"""'article 1240 du code civil' resolves to fr.law.code.civil.article-1240."""
resolver = FrenchLegalReferenceResolver()

results = resolver.resolve_legal_reference("article 1240 du code civil")

assert len(results) == 1
assert results[0].uri == "fr.law.code.civil.article-1240"
</syntaxhighlight>

* '''Line 1:''' Setup (create objects, prepare inputs)
* '''Line 2:''' Act (call the function under test)
* '''Line 3:''' Assert (verify the result)

One assertion per concept. Multiple <code>assert</code> statements are fine when they verify different aspects of the same result.

== Fixtures ==

=== Factory fixtures for data objects ===

When tests need multiple instances with variations, use factory fixtures:

<syntaxhighlight lang="python">
@pytest.fixture
def make_legislation_article():
"""Factory: creates LegislationArticle instances with sensible defaults."""
def _make(
article_id: str = "fr.legiarti000006436298",
article_number: str = "1240",
code_name: str = "code civil",
is_in_force: bool = True,
**overrides,
) -> LegislationArticle:
defaults = {
"article_id": article_id,
"article_number": article_number,
"code_name": code_name,
"is_in_force": is_in_force,
"html_content": "Tout fait quelconque de l'homme...",
"plain_text_content": "Tout fait quelconque de l'homme...",
}
defaults.update(overrides)
return LegislationArticle(**defaults)
return _make
</syntaxhighlight>

=== Real data fixtures ===

Test fixtures use '''real files''' from public institutional data sources (DILA, Judilibre, EUR-Lex). Not invented mocks. This is consistent with the project's commitment to transparency and auditability.

<syntaxhighlight lang="python">
FIXTURES_DIR = Path(__file__).parent / "fixtures"

@pytest.fixture
def sample_legi_article_path() -> Path:
"""Real LEGI XML article: article 1240 du code civil."""
return FIXTURES_DIR / "fr.legiarti000006436298.xml"

@pytest.fixture
def sample_jade_decision_path() -> Path:
"""Real JADE XML decision: CE, 13 dec 2022, n 462274."""
return FIXTURES_DIR / "fr.cetatext000046783006.xml"
</syntaxhighlight>

=== Session-scoped fixtures for expensive resources ===

<syntaxhighlight lang="python">
@pytest.fixture(scope="session")
def database_connection():
"""PostgreSQL connection via testcontainers. Shared across all tests in session."""
with PostgresContainer("postgres:17") as postgres:
pool = ConnectionPool(postgres.get_connection_url())
yield pool
pool.close()
</syntaxhighlight>

== Markers ==

Two standard markers, defined in every repo's <code>pyproject.toml</code>:

<syntaxhighlight lang="python">
@pytest.mark.slow
def test_parse_all_code_civil_articles():
"""Parse all 2000+ articles of Code civil. Verifies no crash."""
...

@pytest.mark.integration
def test_full_text_search_returns_ranked_results(database_connection):
"""FTS with real PostgreSQL, real French stemming, real data."""
...
</syntaxhighlight>

Default <code>pytest</code> invocation excludes both:

<syntaxhighlight lang="bash">
pytest # unit tests only (fast)
pytest -m integration # integration only
pytest -m "not slow" # everything except slow
pytest -m "" # everything including slow + integration
</syntaxhighlight>

== Parametrize for data-driven tests ==

Use <code>@pytest.mark.parametrize</code> for testing multiple inputs against the same logic:

<syntaxhighlight lang="python">
@pytest.mark.parametrize("raw_input, expected_uri", [
("article 1240 du code civil", "fr.law.code.civil.article-1240"),
("article L. 442-1 du code de commerce", "fr.law.code.commerce.article-l442-1"),
("loi n° 85-677", "fr.law.loi.85-677"),
("24-14.340", "fr.court.pourvoi.24-14.340"),
])
def test_resolve_legal_reference_known_patterns(raw_input, expected_uri):
resolver = FrenchLegalReferenceResolver()
results = resolver.resolve_legal_reference(raw_input)
assert results[0].uri == expected_uri
</syntaxhighlight>

== What NOT to test ==

* Private implementation details (functions starting with <code>_</code>)
* Third-party library behavior (lxml, psycopg, nh3)
* Configuration values

== pyproject.toml reference ==

<syntaxhighlight lang="toml">
[tool.pytest.ini_options]
testpaths = ["tests"]
addopts = [
"--strict-config",
"--strict-markers",
"--import-mode=importlib",
"-m not slow and not integration",
]
xfail_strict = true
consider_namespace_packages = true
filterwarnings = ["error"]
markers = [
"slow: tests with extended runtime",
"integration: requires PostgreSQL (testcontainers)",
]
</syntaxhighlight>

[[Category:Development]]

Development/Python

Nicolas — Thu, 23 Apr 2026 02:04:17 GMT

Create Python conventions page from coding-conventions/PYTHON.md (via create-page on MediaWiki MCP Server)

New page

= Python Conventions =

All duralex-* packages follow these conventions. No exceptions.

== Naming ==

=== Casing (PEP 8) ===

{| class="wikitable"
! Element !! Case !! Example
|-
| Functions, methods, variables || <code>snake_case</code> || <code>parse_legislation_article()</code>
|-
| Classes || <code>PascalCase</code> || <code>LegislationArticle</code>
|-
| Constants || <code>UPPER_SNAKE</code> || <code>ALLOWED_TABLE_NAMES</code>
|-
| Enum members || <code>UPPER_SNAKE</code> || <code>Confidence.SOURCE_CHECKED</code>
|-
| Enum string values || <code>lowercase</code> || <code>"source_checked"</code>
|-
| Module filenames || <code>snake_case</code> || <code>connection_pool.py</code>
|}

=== No abbreviations ===

The code is written and maintained by AI. The AI does not tire of typing. Full words always.

{| class="wikitable"
! Wrong !! Right
|-
| <code>ref</code> || <code>reference</code>
|-
| <code>leg</code> || <code>legislation</code>
|-
| <code>dec</code> || <code>decision</code>
|-
| <code>doc</code> || <code>document</code>
|-
| <code>fts</code> || <code>full_text_search</code>
|-
| <code>tbl</code> || <code>table</code>
|-
| <code>q</code> || <code>query</code>
|-
| <code>lim</code> || <code>limit</code>
|-
| <code>flt</code> || <code>filter</code>
|-
| <code>el</code> || <code>element</code>
|-
| <code>ctx</code> || <code>context</code>
|-
| <code>conn</code> || <code>connection</code>
|-
| <code>cfg</code> || <code>configuration</code>
|-
| <code>num</code> || <code>number</code>
|-
| <code>idx</code> || <code>index</code>
|-
| <code>val</code> || <code>value</code>
|}

=== Qualified names ===

Single-word names are ambiguous. Always qualify with the domain.

{| class="wikitable"
! Wrong !! Right !! Why
|-
| <code>query</code> || <code>search_query</code> || Could be SQL, HTTP, FTS...
|-
| <code>text</code> || <code>article_text</code> || Could be anything
|-
| <code>content</code> || <code>html_content</code> || What kind?
|-
| <code>result</code> || <code>search_result</code> || Result of what?
|-
| <code>data</code> || <code>decision_data</code> || Meaningless alone
|-
| <code>items</code> || <code>matched_articles</code> || What items?
|-
| <code>response</code> || <code>search_response</code> || From where?
|-
| <code>path</code> || <code>file_path</code> or <code>concept_path</code> || Filesystem? URI?
|}

=== Booleans read as phrases ===

A boolean variable or parameter must read as a true/false statement.

<syntaxhighlight lang="python">
# Wrong
active = True
force = False
recursive = True

# Right
is_in_force = True
should_force_refresh = False
is_recursive = True
has_been_verified = False
should_include_repealed = True
</syntaxhighlight>

=== Classes: named for what they ARE ===

<syntaxhighlight lang="python">
class LegislationArticle: ...
class CaseLawDecision: ...
class ResolvedReference: ...
class AnnotationEnvelope: ...
class ConceptDefinition: ...
class SearchFilters: ...
class SearchResults: ...
class CompiledPackage: ...
</syntaxhighlight>

=== Methods: verb + explicit object ===

<syntaxhighlight lang="python">
def parse_legislation_article(xml_path: Path) -> LegislationArticle: ...
def resolve_legal_reference(raw_text: str) -> list[ResolvedReference]: ...
def search_full_text(query: str, filters: SearchFilters) -> SearchResults: ...
def compile_domain_package(domain: str) -> CompiledPackage: ...
def sanitize_html_content(raw_html: str) -> str: ...
def extract_text_content(element: Element, xpath: str) -> str | None: ...
def validate_date_range(date_from: str | None, date_to: str | None) -> None: ...
</syntaxhighlight>

=== Protocols: named for the capability ===

<syntaxhighlight lang="python">
class LegislationParser(Protocol): ...
class ReferenceResolver(Protocol): ...
class SearchEngine(Protocol): ...
class VersionSelector(Protocol): ...
class DecisionDownloader(Protocol): ...
</syntaxhighlight>

=== Enums ===

<syntaxhighlight lang="python">
class ConceptType(Enum):
QUALIFIABLE = "qualifiable"
OPEN_STANDARD = "open_standard"
GUIDING_PRINCIPLE = "guiding_principle"
PROCEDURAL = "procedural"
SCALE = "scale"

class Confidence(Enum):
STUB = "stub"
MEMORY_ONLY = "memory_only"
SOURCE_CHECKED = "source_checked"
CROSS_VALIDATED = "cross_validated"

class Outcome(Enum):
QUALIFIED = "qualified"
NOT_QUALIFIED = "not_qualified"
VALIDATED = "validated"
INVALIDATED = "invalidated"
PROCEDURAL = "procedural"
MOOT = "moot"
</syntaxhighlight>

== Architecture patterns ==

=== Dependency injection ===

Dependencies are passed explicitly. No global singletons, no module-level mutable state.

<syntaxhighlight lang="python">
# Wrong
class SearchEngine:
def __init__(self):
self._pool = _get_global_pool()
self._load_cache()

# Right
class FullTextSearchEngine:
def __init__(self, connection_pool: ConnectionPool):
self.connection_pool = connection_pool
</syntaxhighlight>

=== No side effects in <code>__init__</code> ===

Constructors store parameters. They do not open connections, load caches, or perform I/O.

<syntaxhighlight lang="python">
# Wrong
class FrenchReferenceResolver:
def __init__(self, connection_pool: ConnectionPool):
self.connection_pool = connection_pool
self._code_cache = self._load_code_cache() # I/O in __init__

# Right
class FrenchReferenceResolver:
def __init__(self, connection_pool: ConnectionPool):
self.connection_pool = connection_pool
self._code_cache: dict[str, str] | None = None

def _ensure_code_cache(self) -> dict[str, str]:
if self._code_cache is None:
self._code_cache = self._load_code_cache()
return self._code_cache
</syntaxhighlight>

=== Composition over inheritance ===

Core libraries define <code>Protocol</code> interfaces. Country packages and plugins provide implementations. Applications compose them.

<syntaxhighlight lang="python">
# duralex -- defines the interface
class ReferenceResolver(Protocol):
def resolve_legal_reference(self, raw_text: str) -> list[ResolvedReference]: ...

class CompositeReferenceResolver:
"""Chains multiple resolvers. First match wins."""
def __init__(self, resolvers: list[ReferenceResolver]):
self.resolvers = resolvers

def resolve_legal_reference(self, raw_text: str) -> list[ResolvedReference]:
for resolver in self.resolvers:
if results := resolver.resolve_legal_reference(raw_text):
return results
return []

# duralex-fr -- implements for France
class FrenchLegalReferenceResolver:
"""French legal references: articles, lois, pourvois, ECLI."""
...

# Application -- composes at startup
resolver = CompositeReferenceResolver([
FrenchLegalReferenceResolver(connection_pool=pool),
SireneCompanyResolver(),
])
</syntaxhighlight>

=== One module = one concept ===

A Python file should contain one coherent concept. If you need a table of contents to navigate the file, split it.

{| class="wikitable"
! Wrong !! Right
|-
| <code>db.py</code> (1400 lines: pool + CRUD + FTS + ingest + dedup + browse) || <code>connection_pool.py</code>, <code>full_text_search.py</code>, <code>ingest_state.py</code>, <code>browse_structure.py</code>
|-
| <code>validation.py</code> (filters + jurisdiction + pagination + dates + courts) || <code>search_filters.py</code>, <code>court_classification.py</code>
|}

Target: '''under 300 lines per file'''. Hard limit: '''500 lines'''.

== Type annotations ==

Every function signature is fully annotated. An auditor reads signatures before reading bodies.

<syntaxhighlight lang="python">
# Wrong
def search(query, table, limit=20):
...

# Right
def search_full_text(
search_query: str,
table_name: str,
result_limit: int = 20,
date_from: date | None = None,
date_to: date | None = None,
) -> SearchResults:
...
</syntaxhighlight>

Use <code>|</code> union syntax (Python 3.10+), not <code>Optional</code> or <code>Union</code>.

== Docstrings ==

Every public class and function has a docstring. Docstrings include <code>Examples</code> blocks -- AI reads examples first to understand expected behavior.

<syntaxhighlight lang="python">
def resolve_legal_reference(raw_text: str) -> list[ResolvedReference]:
"""Parse a legal citation string into structured references.

Runs a pipeline of detectors in priority order (most specific first).
First match wins. Returns empty list if no pattern matches.

Args:
raw_text: A French legal citation in natural language.

Returns:
List of resolved references with canonical URIs.

Examples:
>>> resolve_legal_reference("article 1240 du code civil")
[ResolvedReference(uri="fr.law.code.civil.article-1240")]

>>> resolve_legal_reference("loi n° 85-677")
[ResolvedReference(uri="fr.law.loi.85-677")]

>>> resolve_legal_reference("bonjour")
[]
"""
</syntaxhighlight>

== Error handling ==

Errors are explicit. Never swallowed. Never hidden behind a generic fallback.

<syntaxhighlight lang="python">
# Wrong
try:
result = parse_article(path)
except Exception:
result = None

# Right
try:
result = parse_article(path)
except FileNotFoundError:
raise ArticleNotFoundError(article_id=article_id, path=path) from None
except etree.XMLSyntaxError as error:
raise ArticleParseError(article_id=article_id, detail=str(error)) from error
</syntaxhighlight>

Custom exception classes inherit from a common base:

<syntaxhighlight lang="python">
class DuralexError(Exception):
"""Base exception for all Dura Lex errors."""

class ArticleNotFoundError(DuralexError):
"""Raised when a legislation article file does not exist on disk."""

class ArticleParseError(DuralexError):
"""Raised when a legislation article XML file cannot be parsed."""

class ReferenceResolutionError(DuralexError):
"""Raised when a legal reference is ambiguous or malformed."""
</syntaxhighlight>

== Language ==

'''All code is in English.''' Variable names, function names, class names, docstrings, comments, error messages -- everything.

'''Content is in the jurisdiction's language.''' Concept names (<code>fr.civil.contrat.formation.consentement.vice.dol</code>), article text, legal vocabulary, court names -- these are in French (or the local language of the jurisdiction).

The boundary is clear: code structure is English, data values are local.

[[Category:Development]]

MCP

Nicolas — Thu, 23 Apr 2026 02:03:40 GMT

Create MCP index page (via create-page on MediaWiki MCP Server)

New page

The public API for AI agents and applications. 5 tools, safety guidelines per jurisdiction, reference resolution.

== Tools ==

The MCP server exposes 5 tools, all jurisdiction-agnostic. Jurisdiction plugins provide tag schemas, formatters, and reference resolvers — not tools.

* '''[[MCP/Tools|Tools]]''' — full specification of all 5 tools (search, get_document, browse_structure, safety_guidelines, quality_check)

== Reference resolution ==

Reference resolution transforms a natural language legal reference (or a document ID) into a query against the corpus.

* '''[[MCP/Reference resolution|Reference resolution]]''' — TagQuery, jurisdiction parsers, resolution pipeline

== Guidelines ==

Mandatory safety guidelines for legal research. Two-call workflow: core once at session start, jurisdiction per jurisdictional context.

* '''[[MCP/Guidelines|Guidelines]]''' — overview of the guidelines system
* '''[[MCP/Guidelines/Core|Core guidelines]]''' — foundational rules (8 non-negotiable, methodology, defensive posture, response format)
* '''[[MCP/Guidelines/FR|FR guidelines]]''' — French law jurisdiction-specific rules
* '''[[MCP/Guidelines/EU|EU guidelines]]''' — European law jurisdiction-specific rules

[[Category:MCP]]

Jurisdictions

Nicolas — Thu, 23 Apr 2026 02:03:30 GMT

Create jurisdictions index page (via create-page on MediaWiki MCP Server)

New page

Legal systems covered by Dura Lex. Each page describes the court hierarchy, legislation types, and publication systems for a jurisdiction.

== Covered jurisdictions ==

{| class="wikitable"
! Jurisdiction !! Code !! Description
|-
| [[Jurisdictions/FR|France]] || <code>fr</code> || French legal system: judicial, administrative, financial, and constitutional orders. 60M+ documents.
|-
| [[Jurisdictions/EU|European Union]] || <code>eu</code> || EU law (EUR-Lex, CJEU) and ECHR. Currently FR-language only.
|}

== Using jurisdiction tags ==

Every <code>search</code> and <code>browse_structure</code> call requires <code>tags["jurisdiction"]</code>:

{| class="wikitable"
! Value !! Meaning
|-
| <code>"fr"</code> || French law only
|-
| <code>"eu"</code> || European law only (EUR-Lex, CJEU, ECHR)
|-
| <code>"eu{{!}}fr"</code> || Both (recommended for cross-border questions)
|-
| <code>"*"</code> || All jurisdictions
|-
| <code>"!=eu"</code> || Everything except EU
|}

[[Category:Jurisdictions]]

Development

Nicolas — Thu, 23 Apr 2026 02:03:19 GMT

Create Development index page (via create-page on MediaWiki MCP Server)

New page

For contributors to the Dura Lex codebase. Coding conventions, testing, packaging, and how to add new sources and jurisdictions.

== Sub-pages ==

* [[Development/Python]] — Python coding conventions (naming, architecture, types, docstrings, errors)
* [[Development/Testing]] — Test organization, fixtures, markers, parametrize
* [[Development/Packaging]] — Repository structure, namespace packages, pyproject.toml
* [[Development/GitHub]] — Issues, pull requests, branches, commit messages
* [[Development/Adding a source]] — How to add a new data source to the ingest pipeline

[[Category:Development]]

Corpus

Nicolas — Thu, 23 Apr 2026 02:01:05 GMT

Corpus index page — links to all data model specs (via create-page on MediaWiki MCP Server)

New page

The Dura Lex data model. One table, JSONB tags, six structural kinds. Inspired by OpenStreetMap.

{| class="wikitable"
|-
! Page !! Scope
|-
| [[Corpus/Schema]] || Tables, columns, indexes, DDL, benchmarks
|-
| [[Corpus/Tag conventions]] || Shared tag vocabulary across jurisdictions
|-
| [[Corpus/Edge types]] || Taxonomy of relationship types between documents (~75 types)
|-
| [[Corpus/Quality]] || Content quality levels and annotation confidence
|-
| [[Corpus/Temporal]] || Versioning, at_date, non-Gregorian calendars
|-
| [[Corpus/FTS]] || Full-text search: trigger, body/body_search, normalization, CJK
|-
| [[Corpus/Graph]] || Knowledge graph: concepts, annotations, compilation (draft)
|}

[[Category:Corpus]]

Main Page

Nicolas — Thu, 23 Apr 2026 01:57:59 GMT

Fix Sources link: point to Sources page instead of category (via update-page on MediaWiki MCP Server)

← Older revision		Revision as of 01:57, 23 April 2026
Line 21:		Line 21:
	\| [[:Category:Corpus\|Corpus]] \|\| The data model — schema, tags, edges, quality, temporal versioning, FTS		\| [[:Category:Corpus\|Corpus]] \|\| The data model — schema, tags, edges, quality, temporal versioning, FTS
	\|-		\|-
	\| [[~~:Category:Sources\|~~Sources]] \|\| Data dictionary — one page per ingest source, coverage matrix		\| [[Sources]] \|\| Data dictionary — one page per ingest source, coverage matrix
	\|-		\|-
	\| [[:Category:Jurisdictions\|Jurisdictions]] \|\| Legal systems we cover and how they map to the unified schema		\| [[:Category:Jurisdictions\|Jurisdictions]] \|\| Legal systems we cover and how they map to the unified schema

Sources/EU/EUR-Lex

Nicolas — Thu, 23 Apr 2026 01:57:01 GMT

Source doc: eurlex — EU legislation (CELLAR/SPARQL) (via create-page on MediaWiki MCP Server)

New page

EU legislation from the Publications Office CELLAR database. Regulations, directives, decisions, recommendations, and international agreements. Article-level granularity with chapter/section hierarchy. Year-by-year from 1952 via SPARQL.

'''Status:''' active

== Source ==

{| class="wikitable"
|-
! Key !! Kind !! Origin !! Auth !! Update
|-
| <code>eurlex</code> || legislation + section || SPARQL + CELLAR download — <code>publications.europa.eu/webapi/rdf/sparql</code> || none || incremental (year-by-year)
|}

'''ID format:'''
* Text root: <code>eu.eurlextext{celex.lower()}:{lang}</code> (e.g. <code>eu.eurlextext32016r0679:fr</code>)
* Article: <code>eu.eurlexarti{celex.lower()}_{article_number}:{lang}</code>
* Chapter/section: <code>eu.eurlexscta{celex.lower()}_{html_id}:{lang}</code>

'''Coverage:''' 1952–present

== Tags ==

=== Classification ===

{| class="wikitable"
|-
! CELEX nature code !! → <code>nature</code>
|-
| R || <code>REGLEMENT</code>
|-
| L || <code>DIRECTIVE</code>
|-
| D || <code>DECISION</code>
|-
| H || <code>RECOMMANDATION</code>
|-
| X || <code>ACCORD_INTERNATIONAL</code>
|}

<code>type</code> = <code>statute</code> (always). <code>number</code> derived from CELEX pattern (e.g. <code>2016/679</code>).

=== Enforcement ===

{| class="wikitable"
|-
! <code>enforcement_status</code> !! <code>in_force</code> !! Signal
|-
| <code>in_force</code> || true || SPARQL in-force signal present
|-
| <code>repealed</code> || false || end_of_validity is past
|}

Only these two values are emitted (full vocabulary defined in TAG-CONVENTIONS but not used by this source).

<code>needs_review</code> = <code>"enforcement_status_missing"</code> (no signal) or <code>"enforcement_status_contradiction"</code> (in-force=true but end-of-validity is past).

=== Structure ===

{| class="wikitable"
|-
! Record type !! kind !! Notes
|-
| Root text node || section || <code>structure_type: "legislation"</code>, <code>text_id</code> = cross-language canonical ID
|-
| Chapter || section || parent = text root
|-
| Sub-section || section || parent = chapter
|-
| Article || legislation || parent = nearest enclosing section
|-
| Preamble || legislation || <code>article_number: "PREAMBULE"</code>
|}

=== Identifiers ===

{| class="wikitable"
|-
! Tag !! Notes
|-
| <code>celex</code> || CELEX identifier
|-
| <code>text_id</code> || cross-language canonical work ID (no <code>:lang</code> suffix)
|}

=== Multilingual ===

Each language version is a separate row with <code>:{lang}</code> suffix. <code>translation_pending</code> set when content was fetched in EN fallback.

== Edges ==

{| class="wikitable"
|-
! <code>kind</code> !! Direction !! Trigger
|-
| <code>language_variant</code> || EN ↔ FR || post-ingest LLM translation enrichment
|}

== Related sources ==

{| class="wikitable"
|-
! Source !! Relationship
|-
| [[Sources/EU/CJEU|cjeu]] || CJEU decisions interpret EU legislation. No cross-source edges yet.
|}

== Limitations ==

* Only <code>language="fr"</code> ingested — multi-language support planned
* Only R, L, D, H, X nature codes — other CELEX types not ingested
* No citation edges between EU legislative acts
* Legacy/PDF format documents produce a single article (no structural breakdown)

[[Category:Sources]][[Category:EU]]

Sources/EU/ECHR

Nicolas — Thu, 23 Apr 2026 01:56:42 GMT

Source doc: echr — European Court of Human Rights (HUDOC) (via create-page on MediaWiki MCP Server)

New page

European Court of Human Rights decisions from the HUDOC database. Judgments and admissibility decisions. Year-by-year from 1959, with automatic splitting for high-volume years. Parallel downloads (32 workers).

'''Status:''' active

== Source ==

{| class="wikitable"
|-
! Key !! Kind !! Origin !! Auth !! Update
|-
| <code>echr</code> || decision || HUDOC search API — <code>hudoc.echr.coe.int/app/query/results</code> || none || incremental (year-by-year)
|}

'''ID format:''' <code>eu.echr_{itemid}:{language}</code> (e.g. <code>eu.echr_001-12345:fr</code>)

'''Coverage:''' 1959–present

== Tags ==

=== Classification ===

{| class="wikitable"
|-
! Tag !! Values !! Notes
|-
| <code>type</code> || <code>judgment</code> || always (both judgments and decisions)
|-
| <code>nature</code> || <code>ARRÊT</code> (JUDGMENTS collection) or <code>DÉCISION</code> (DECISIONS collection) ||
|-
| <code>document_form</code> || <code>canonical_text</code>, <code>dissenting_opinion</code>, <code>concurring_opinion</code>, <code>separate_opinion</code> || detected via docname regex
|-
| <code>court</code> || <code>echr</code> || always
|-
| <code>court_level</code> || <code>supranational</code> || always
|}

=== Grades ===

{| class="wikitable"
|-
! <code>official_grade</code> !! → <code>importance_level</code> !! Meaning
|-
| <code>1</code> || <code>highest_importance</code> || Key case (ECHR Reports)
|-
| <code>2</code> || <code>high_importance</code> || High importance
|-
| <code>3</code> || <code>medium_importance</code> || Medium importance
|-
| <code>4</code> || <code>low_importance</code> || Low importance
|}

=== Formation ===

{| class="wikitable"
|-
! <code>formation_solemnity</code> !! Criteria
|-
| <code>grand_bench</code> || "Grande chambre" in chamber label
|-
| <code>standard_bench</code> || section/chamber (not committee, not grand)
|-
| <code>reduced_bench</code> || "Comité" or "(comité)" in label
|}

Chamber label derived from <code>originatingbody</code> (section ID) and <code>doctypebranch</code>. 5 sections (Première–Cinquième) with optional committee qualifier.

=== Domain-specific ===

{| class="wikitable"
|-
! Tag !! Notes
|-
| <code>respondent_state</code> || defendant country (e.g. "FRA")
|-
| <code>has_separate_opinion</code> || <code>"true"</code> or <code>"false"</code>
|-
| <code>echr_branch</code> || <code>admissibility</code>, <code>admissibility_committee</code>, <code>grand_chamber_decision</code> (when applicable)
|-
| <code>chamber</code> || full chamber label in French
|-
| <code>solution</code> || conclusion field from HUDOC
|-
| <code>summary</code> || headnote extracted from bordered CSS box in HTML
|-
| <code>ecli</code> || ECLI string
|-
| <code>case_number</code> || application numbers (split by ";")
|-
| <code>translation_pending</code> || target language code when no sibling found
|}

== Edges ==

{| class="wikitable"
|-
! <code>kind</code> !! Direction !! Trigger
|-
| <code>language_variant</code> || EN ↔ FR || post-ingest LLM translation enrichment
|}

== Related sources ==

{| class="wikitable"
|-
! Source !! Relationship
|-
| [[Sources/EU/CJEU|cjeu]] || Separate court system (Council of Europe vs EU). Different grade system, different formation model.
|}

== Limitations ==

* Only <code>language="fr"</code> ingested — multi-language support planned
* <code>needs_review: "echr_chamber_unmapped"</code> when neither branch nor body resolved to known mapping
* No citation edges between ECHR decisions
* Formation solemnity not available for single-judge decisions (no <code>single_judge</code> value set)

[[Category:Sources]][[Category:EU]]

Sources/FR/BODACC

Nicolas — Thu, 23 Apr 2026 01:56:10 GMT

Source doc: bodacc — commercial announcements (DILA) (via create-page on MediaWiki MCP Server)

New page

Bulletin officiel des annonces civiles et commerciales — commercial announcements from the DILA open data platform. Insolvency proceedings, company registrations, modifications, deregistrations, and annual account filings.

'''Status:''' active

== Source ==

{| class="wikitable"
|-
! Key !! Kind !! Origin !! Auth !! Update
|-
| <code>bodacc</code> || notice || DILA open data dump — <code>echanges.dila.gouv.fr/OPENDATA/BODACC/</code> || none || incremental (.taz archives)
|}

'''ID format:''' <code>fr.bodacc_{nojo}_{numero}</code>

'''parent_id:''' <code>fr.company.{siren}</code> when SIREN is extractable from the RCS number.

'''Coverage:''' 1850–present

== Sub-sources ==

{| class="wikitable"
|-
! Key !! Feed !! Content
|-
| <code>bodacc_pcl</code> || PCL || Insolvency proceedings (procédures collectives)
|-
| <code>bodacc_rcs_a</code> || RCS-A || Company registrations (immatriculations)
|-
| <code>bodacc_rcs_b</code> || RCS-B || Modifications and deregistrations
|-
| <code>bodacc_bilan</code> || BILAN || Annual account filings
|}

== Tags ==

=== By sub-feed ===

{| class="wikitable"
|-
! Feed !! <code>type</code> !! <code>category</code> !! <code>subcategory</code> values
|-
| PCL || <code>insolvency</code> || <code>insolvency</code> || <code>liquidation</code>, <code>reorganization</code>, <code>preventive_restructuring</code>, <code>recovery_plan</code>, <code>closure</code>, <code>consumer_insolvency</code>, <code>management_ban</code>, <code>asset_transfer</code>
|-
| RCS-A || <code>registration</code> || <code>registration</code> || <code>registration_natural_person</code>, <code>registration_legal_entity</code>, <code>registration_dormant_entity</code>, <code>gaec_conversion</code>, etc.
|-
| RCS-B || <code>deregistration</code> or <code>modification</code> || same as type || <code>deregistration</code> or <code>modification</code>
|-
| BILAN || <code>filing</code> || <code>filing</code> || <code>annual_accounts</code>, <code>consolidated_accounts</code>
|}

=== Common tags ===

{| class="wikitable"
|-
! Tag !! Notes
|-
| <code>authority</code> || issuing court
|-
| <code>region</code> || geographic region
|-
| <code>effective_date</code> || effective date of the event
|-
| <code>registration_number</code> || RCS number
|-
| <code>denomination</code> || company name
|-
| <code>address_postal_code</code>, <code>address_city</code> || company address
|}

== Edges ==

None. Parent-child relationship to company records via <code>parent_id</code>.

== Related sources ==

{| class="wikitable"
|-
! Source !! Relationship
|-
| [[Sources/FR/RNE|rne]] || BODACC notices reference companies by SIREN via parent_id.
|}

== Limitations ==

* No full text — structured metadata only
* No grade system

[[Category:Sources]][[Category:FR]]

Sources/FR/RNE

Nicolas — Thu, 23 Apr 2026 01:55:57 GMT

Source doc: rne — French company registry (INPI) (via create-page on MediaWiki MCP Server)

New page

French national company registry (Registre National des Entreprises) from INPI. Companies, directors, and establishments. 24.2M companies, 15M directors.

'''Status:''' active

== Source ==

{| class="wikitable"
|-
! Key !! Kind !! Origin !! Auth !! Update
|-
| <code>rne</code> || record || INPI FTP (stock ZIP) + REST API (diffs) || <code>INPI_RNE_FTP_USER</code> / <code>INPI_RNE_FTP_PASSWORD</code> (FTP), <code>INPI_RNE_API_USER</code> / <code>INPI_RNE_API_PASSWORD</code> (API) || stock + incremental diffs
|}

'''ID format:''' <code>fr.company.{siren}</code> (company), <code>fr.company.{siren}.dir.{uuid4}</code> (director)

'''Coverage:''' 1600–present

== Sub-sources ==

{| class="wikitable"
|-
! Key !! Scope
|-
| <code>rne_diff</code> || incremental diffs via API
|-
| <code>rne_reparse_progress</code> || resume checkpoint within stock ZIP
|}

== Tags ==

=== Company records ===

{| class="wikitable"
|-
! Tag !! Notes
|-
| <code>type</code> || <code>company</code>
|-
| <code>registration_number</code> || SIREN
|-
| <code>legal_form_code</code>, <code>legal_form_label</code> || ~50 codes from INSEE
|-
| <code>activity_code</code> || APE/NACE code
|-
| <code>activity_sector</code> || sector description
|-
| <code>entity_status</code> || <code>active</code> or <code>ceased</code>
|-
| <code>entity_type</code> || <code>legal_entity</code> (M), <code>natural_person</code> (P), <code>agricultural_entity</code> (E)
|-
| <code>capital_amount</code> || integer centimes
|-
| <code>address_street</code>, <code>address_postal_code</code>, <code>address_city</code>, <code>address_country</code> || registered address
|}

=== Director records ===

parent_id = company ID

{| class="wikitable"
|-
! Tag !! Notes
|-
| <code>type</code> || <code>person</code>
|-
| <code>role_code</code>, <code>role_label</code> || 17 codes (gérant, DG, président SAS...)
|-
| <code>role_category</code> || <code>dirigeant</code>, <code>gouvernance</code>, <code>controle</code>, <code>autre</code>
|-
| <code>entity_type</code> || <code>natural_person</code> or <code>legal_entity</code>
|-
| <code>last_name</code>, <code>first_names</code>, <code>birth_year</code>, <code>nationality</code> || natural persons
|-
| <code>denomination</code>, <code>director_registration_number</code> || legal entity directors
|}

=== Establishment records ===

parent_id = company ID, type = <code>establishment</code>.

== Edges ==

None. Parent-child relationships via <code>parent_id</code>, not edges table.

== Related sources ==

{| class="wikitable"
|-
! Source !! Relationship
|-
| [[Sources/FR/BODACC|bodacc]] || BODACC notices reference companies by SIREN. <code>parent_id</code> = <code>fr.company.{siren}</code>.
|}

== Limitations ==

* Non-diffusible records (diffusionINSEE = "N") are filtered out
* Stock ZIP is multi-GB, requires FTP with resume support
* Director IDs are UUID4 — not stable across re-ingests

[[Category:Sources]][[Category:FR]]

Sources/FR/BOFiP

Nicolas — Thu, 23 Apr 2026 01:55:38 GMT

Source doc: bofip — tax doctrine (DGFiP) (via create-page on MediaWiki MCP Server)

New page

Bulletin Officiel des Finances Publiques — tax authority doctrine from the DGFiP. Commentaries, rate tables, recommendations, and reference guides on French tax law. Opposable to the tax authority (taxpayer can rely on it), but NOT binding on courts.

'''Status:''' active

== Source ==

{| class="wikitable"
|-
! Key !! Kind !! Origin !! Auth !! Update
|-
| <code>bofip</code> || legislation + section || DGFiP open data — <code>bofip.impots.gouv.fr/opendata/</code> || none || incremental (stock + flux archives)
|}

'''ID format:''' <code>fr.bofip_{pgp_id.lower()}</code> (content), <code>fr.{node_id.lower()}</code> (structure)

'''Coverage:''' 2000–present

== Tags ==

=== Classification ===

{| class="wikitable"
|-
! Tag !! Values
|-
| <code>type</code> || <code>guidance</code> (always)
|}

=== Guidance subtypes ===

{| class="wikitable"
|-
! <code>guidance_subtype</code> !! Source contenu_type
|-
| <code>commentary</code> || commentaire
|-
| <code>opinion</code> || avis
|-
| <code>reference_guide</code> || référentiel
|-
| <code>annex</code> || autres annexes
|-
| <code>template</code> || lettre type / modèle
|-
| <code>recommendation</code> || recommandation
|-
| <code>form</code> || formulaire
|-
| <code>rate_table</code> || barème
|-
| <code>map</code> || cartographie
|}

=== Domain-specific ===

{| class="wikitable"
|-
! Tag !! Notes
|-
| <code>series</code> || first Dublin Core subject (IR, IS, TVA, BIC, BNC, CF...)
|-
| <code>modification_date</code> || last modification date
|-
| <code>importance_level</code> || always <code>high_importance</code> (no per-document grading)
|}

=== Structure ===

PlanClassement produces kind=<code>section</code> with <code>structure_type: "doctrine"</code>, forming a hierarchical tree. Content documents are children of these sections.

== Edges ==

None.

== Limitations ==

* No per-document grade system — all BOFiP has uniform importance
* Opposable to the tax authority, NOT binding on courts
* Structure relies on PlanClassement XML which can be complex

[[Category:Sources]][[Category:FR]]

Sources/FR/ACCO

Nicolas — Thu, 23 Apr 2026 01:55:19 GMT

Source doc: acco — enterprise labor agreements (DILA) (via create-page on MediaWiki MCP Server)

New page

Enterprise and branch labor agreements filed with the French Ministry of Labor. Metadata-rich (IDCC, unions, themes, company identifiers), often with attached .docx/.odt content files. See also [[Sources/FR/KALI|kali]] for extended branch conventions.

'''Status:''' active

== Source ==

{| class="wikitable"
|-
! Key !! Kind !! Origin !! Auth !! Update
|-
| <code>acco</code> || legislation || DILA open data dump — <code>echanges.dila.gouv.fr/OPENDATA/ACCO/</code> || none || incremental (tar.gz archives)
|}

'''ID format:''' <code>fr.{raw_id.lower()}</code>

'''Coverage:''' 1900–present (includes forward-dated expiration)

== Tags ==

=== Classification ===

{| class="wikitable"
|-
! Tag !! Values
|-
| <code>type</code> || <code>collective_agreement</code> (always)
|-
| <code>document_form</code> || <code>canonical_text</code> (ACCORD), <code>amendment</code> (AVENANT), <code>corrigendum</code> (RECTIFICATIF)
|}

=== Domain-specific ===

{| class="wikitable"
|-
! Tag !! Notes
|-
| <code>bargaining_level</code> || <code>sectoral</code> (CODE_UNITE_SIGNATAIRE in 01/02) or <code>enterprise</code> (others)
|-
| <code>idcc</code> || convention collective identifier
|-
| <code>themes</code> || list of theme labels
|-
| <code>unions</code> || list of signatory unions
|-
| <code>siret</code>, <code>siren</code> || company identifiers
|-
| <code>company_name</code> || company denomination
|-
| <code>activity_code</code> || APE/NACE code
|-
| <code>sector</code> || industry sector
|-
| <code>number</code> || agreement number
|-
| <code>is_complete_version</code> || <code>"true"</code> if integral version
|}

=== Dates ===

{| class="wikitable"
|-
! Tag !! Notes
|-
| <code>filing_date</code> || date filed with ministry
|-
| <code>text_date</code> || date of the agreement text
|-
| <code>effective_date</code> || entry into force
|-
| <code>publication_date</code> || publication date
|-
| <code>expiration_date</code> || end of validity (sentinel 2999-01-01 stripped)
|}

<code>date</code> column: coalesced from filing_date > text_date > effective_date > publication_date.

== Edges ==

None.

== Related sources ==

{| class="wikitable"
|-
! Source !! Relationship
|-
| [[Sources/FR/KALI|kali]] || Complementary. KALI = extended branch conventions with article-level granularity and enforcement tracking. ACCO = filed agreements with company-level metadata.
|}

== Limitations ==

* No enforcement_status tracking (unlike KALI)
* No article-level granularity — each agreement is a single document
* Content often in .docx/.odt attachments, not structured XML
* No edges

[[Category:Sources]][[Category:FR]]

Sources/FR/KALI

Nicolas — Thu, 23 Apr 2026 01:55:10 GMT

Source doc: kali — collective labor agreements (DILA) (via create-page on MediaWiki MCP Server)

New page

French collective labor agreements (conventions collectives de branche) from the DILA open data platform. Extended branch agreements with article-level granularity, enforcement status tracking, and IDCC codes. See also [[Sources/FR/ACCO|acco]] for enterprise-level agreements.

'''Status:''' active

== Source ==

{| class="wikitable"
|-
! Key !! Kind !! Origin !! Auth !! Update
|-
| <code>kali</code> || legislation + section || DILA open data dump — <code>echanges.dila.gouv.fr/OPENDATA/KALI/</code> || none || incremental (tar.gz archives)
|}

'''ID format:''' <code>fr.{raw_id.lower()}</code>

'''Coverage:''' 1850–present (includes forward-dated expiration)

== Tags ==

=== Classification (articles) ===

{| class="wikitable"
|-
! Tag !! Values
|-
| <code>type</code> || <code>collective_agreement</code>
|-
| <code>document_form</code> || <code>canonical_text</code> (ACCORD), <code>amendment</code> (AVENANT), <code>corrigendum</code> (RECTIFICATIF)
|}

=== Domain-specific ===

{| class="wikitable"
|-
! Tag !! Notes
|-
| <code>idcc</code> || convention collective identifier (IDCC code)
|-
| <code>nature</code> || raw NATURE field
|-
| <code>article_number</code> || article number within the text
|-
| <code>section_path</code> || breadcrumb through TM hierarchy
|-
| <code>text_id</code>, <code>container_id</code> || structural references
|-
| <code>sector</code> || industry sector
|}

=== Enforcement ===

Same enforcement_status mapping as [[Sources/FR/LEGI|legi]] — full 13-value vocabulary from DILA ETAT codes (in_force, repealed, superseded, transferred, denounced, etc.).

Temporal validity via <code>date</code> / <code>date_end</code>. Sentinel <code>2999-01-01</code> stripped to null.

=== Structure ===

KALI produces multiple record types:
* '''ARTICLE''' → kind=<code>legislation</code> (the actual agreement articles)
* '''IDCC containers''' (KALICONT + TM groups) → kind=<code>section</code> with <code>structure_type: "labor"</code>
* '''SECTION_TA''' → kind=<code>section</code>
* '''TEXTEKALI''' → kind=<code>section</code>
* '''TEXTE_VERSION''' → skipped

== Edges ==

{| class="wikitable"
|-
! <code>kind</code> !! Direction !! Trigger
|-
| various (normalized link types) || article → article || ARTICLE LIENS elements with sens="cible"
|}

Properties include <code>target_cid</code> when cidtexte is present.

== Related sources ==

{| class="wikitable"
|-
! Source !! Relationship
|-
| [[Sources/FR/ACCO|acco]] || Complementary. KALI = extended branch conventions (with articles, enforcement tracking). ACCO = filed enterprise agreements (metadata-heavy, often with .docx/.odt attachments).
|}

== Limitations ==

* Complex archive layout with multiple root element types
* Section hierarchy is deep (IDCC → TM → SECTION_TA → ARTICLE)

[[Category:Sources]][[Category:FR]]

Sources/FR/JORF

Nicolas — Thu, 23 Apr 2026 01:54:50 GMT

Source doc: jorf — Journal officiel (DILA) (via create-page on MediaWiki MCP Server)

New page

Journal officiel de la République française — original gazette publication of laws, decrees, orders, and official notices. The gazette counterpart to [[Sources/FR/LEGI|legi]] (consolidated). JORF captures the original publication with visas, ministère, and gazette structure. Linked to LEGI via <code>source_text</code> edges.

'''Status:''' active

== Source ==

{| class="wikitable"
|-
! Key !! Kind !! Origin !! Auth !! Update
|-
| <code>jorf</code> || legislation + section + notice || DILA open data dump — <code>echanges.dila.gouv.fr/OPENDATA/JORF/</code> || none || incremental (tar.gz archives)
|}

'''ID format:''' <code>fr.{raw_id.lower()}</code> (e.g. <code>fr.jorftext000000000001</code>)

'''Coverage:''' 1539–present (includes forward entry-into-force dates)

== Tags ==

=== Classification ===

{| class="wikitable"
|-
! NATURE !! → <code>type</code> !! → <code>document_form</code>
|-
| LOI, LOI_ORGANIQUE || <code>statute</code> || <code>canonical_text</code>
|-
| ORDONNANCE || <code>ordinance</code> || <code>canonical_text</code>
|-
| DECRET || <code>decree</code> || <code>canonical_text</code>
|-
| ARRETE, DECISION || <code>order</code> || <code>canonical_text</code>
|-
| AVIS || <code>order</code> || <code>gazette_notice</code>
|-
| CIRCULAIRE || <code>circular</code> || <code>canonical_text</code>
|-
| RECTIFICATIF || (same as base) || <code>corrigendum</code>
|-
| other || <code>normative_document</code> || <code>canonical_text</code>
|}

=== Domain-specific ===

{| class="wikitable"
|-
! Tag !! Notes
|-
| <code>nor</code> || NOR identifier
|-
| <code>number</code> || act number
|-
| <code>ministere</code> || issuing ministry
|-
| <code>date_published</code> || gazette publication date
|-
| <code>publication_reference</code> || JO reference
|-
| <code>eli</code> || European Legislation Identifier
|-
| <code>text_id</code> || JORFTEXT canonical ID
|-
| <code>legi_text_id</code> || corresponding LEGITEXT ID (when available)
|}

=== Gazette structure ===

JO containers produce kind=<code>notice</code> with type=<code>gazette_publication</code> and child sections with <code>structure_type: "official_journal"</code>.

== Edges ==

{| class="wikitable"
|-
! <code>kind</code> !! Direction !! Trigger
|-
| various (cites, amends...) || outgoing || TEXTE_VERSION LIENS with sens="source"
|-
| <code>source_text</code> || LEGITEXT → JORFTEXT || TEXTELR VERSIONS/VERSION/LIEN_TXT
|}

== Related sources ==

{| class="wikitable"
|-
! Source !! Relationship
|-
| [[Sources/FR/LEGI|legi]] || Same texts, different view. LEGI = consolidated + versioned. JORF = original gazette. ~4% of JORF texts have no LEGI counterpart. Linked by <code>source_text</code> edges.
|}

== Limitations ==

* No enforcement_status — JORF is the original publication, not the consolidated version
* Hidden from default search — access via <code>tags={"source": "jorf"}</code>
* No versioning — each article is a single snapshot at publication time

[[Category:Sources]][[Category:FR]]

Sources/FR/CADA

Nicolas — Thu, 23 Apr 2026 01:54:24 GMT

Source doc: cada — transparency authority opinions (via create-page on MediaWiki MCP Server)

New page

Opinions and advice from the Commission d'accès aux documents administratifs (CADA) — the French transparency authority. Single consolidated CSV from data.gouv.fr. ~60,000 records, 1984–present.

'''Status:''' active

== Source ==

{| class="wikitable"
|-
! Key !! Kind !! Origin !! Auth !! Update
|-
| <code>cada</code> || decision || data.gouv.fr CSV (~184 MB) — dataset <code>53698f37a3a729239d2036a0</code> || none || full re-download (checks last_modified)
|}

'''ID format:''' <code>fr.cada_{number}</code>

'''Coverage:''' 1984–present

== Tags ==

=== Classification ===

{| class="wikitable"
|-
! Tag !! Values
|-
| <code>type</code> || <code>administrative_decision</code>
|-
| <code>court</code> || <code>cada</code>
|-
| <code>nature</code> || CSV column "Type"
|}

=== Domain-specific ===

{| class="wikitable"
|-
! Tag !! Notes
|-
| <code>authority</code> || administation concerned
|-
| <code>theme</code> || subject classification
|-
| <code>solution</code> || outcome ("Sens et motivation")
|-
| <code>case_number</code> || dossier number
|}

<code>_importance_level_default</code> = <code>low_importance</code>.

=== Grades ===

No grade system.

== Edges ==

None.

== Limitations ==

* No full text — only structured metadata and outcome
* Orphan cleanup: deletes CADA records not in current CSV when total ≥ 30,000

[[Category:Sources]][[Category:FR]]

Sources/FR/Jufi

Nicolas — Thu, 23 Apr 2026 01:54:15 GMT

Source doc: jufi — financial courts (Légifrance API) (via create-page on MediaWiki MCP Server)

New page

French financial court decisions from the Légifrance PISTE API. Covers Cour des comptes (supreme), chambres régionales des comptes (CRC), Cour de discipline budgétaire et financière (CDBF), and Cour d'appel financière (CAF). ~3,500 decisions, 1950–present.

'''Status:''' active

== Source ==

{| class="wikitable"
|-
! Key !! Kind !! Origin !! Auth !! Update
|-
| <code>jufi</code> || decision || Légifrance PISTE API — <code>api.piste.gouv.fr/dila/legifrance/lf-engine-app</code> (fond=JUFI) || <code>PISTE_OAUTH_CLIENT_ID</code> + <code>PISTE_OAUTH_CLIENT_SECRET</code> (OAuth2) || incremental (date-filtered search)
|}

'''ID format:''' <code>fr.{decision_id.lower()}</code>

'''Coverage:''' 1950–present

== Sub-sources ==

{| class="wikitable"
|-
! Key !! Scope
|-
| <code>jufi_cour_des_comptes</code> || Cour des comptes
|-
| <code>jufi_chambres_comptes</code> || Chambres régionales des comptes
|-
| <code>jufi_discipline</code> || Cour de discipline budgétaire et financière
|-
| <code>jufi_appel_financiere</code> || Cour d'appel financière
|}

== Tags ==

=== Courts ===

{| class="wikitable"
|-
! <code>court</code> !! <code>court_level</code> !! natureJuridiction
|-
| <code>cour_des_comptes</code> || <code>supreme</code> || COURS_COMPTES
|-
| <code>chambre_regionale_des_comptes</code> || <code>first_instance</code> || CHAMBRES_COMPTES
|-
| <code>cour_discipline_budgetaire_financiere</code> || <code>first_instance</code> || COURS_DE_DISCIPLINE
|-
| <code>cour_appel_financiere</code> || <code>appellate</code> || COURS_APPEL_FINANCIERE
|}

<code>court_location</code>: extracted from CRC formation strings matching "CRC {region}".

=== Grades ===

{| class="wikitable"
|-
! <code>official_grade</code> !! → <code>importance_level</code> !! Source signal
|-
| <code>recueil</code> || <code>high_importance</code> || publicationRecueil = "C" or starts with "Publié"
|-
| (none) || default || no publication signal
|}

=== Identifiers ===

{| class="wikitable"
|-
! Tag !! Format
|-
| <code>case_number</code> || array
|}

=== Domain-specific ===

{| class="wikitable"
|-
! Tag !! Notes
|-
| <code>rapporteur</code> || reporting judge
|-
| <code>commissaire</code> || government commissioner
|-
| <code>chamber</code> || formation value for non-CRC courts
|}

== Edges ==

None.

== Limitations ==

* Small corpus (~3,500 decisions)
* No formation_solemnity
* OAuth2 authentication required (not simple API key)
* Rate-limited (0.5s default)

[[Category:Sources]][[Category:FR]]

Sources/FR/INCA

Nicolas — Thu, 23 Apr 2026 01:53:59 GMT

Source doc: inca — legacy administrative courts (superseded) (via create-page on MediaWiki MCP Server)

New page

Legacy administrative court decisions from the DILA open data platform. Superseded by [[Sources/FR/Jade|jade]] and [[Sources/FR/CE OpenData|ce_opendata]].

'''Status:''' legacy

== Source ==

{| class="wikitable"
|-
! Key !! Kind !! Origin !! Auth !! Update
|-
| <code>inca</code> || decision || DILA open data dump — <code>echanges.dila.gouv.fr/OPENDATA/INCA/</code> || none || no longer updated
|}

'''Coverage:''' 1800–present (historical)

== Tags ==

Same parser as [[Sources/FR/Cass|cass]] (<code>case_law_parser</code>). Tags follow the same pattern — court, grade, formation, identifiers.

Grade for inca: <code>diffuse</code> (PUBLI_BULL@publie="non" or absent) or <code>bulletin</code>.

== Edges ==

None.

== Related sources ==

{| class="wikitable"
|-
! Source !! Relationship
|-
| [[Sources/FR/Jade|jade]] || Replacement — DILA open data dump for administrative courts
|-
| [[Sources/FR/CE OpenData|ce_opendata]] || Replacement — Conseil d'État's own portal, more structured
|}

[[Category:Sources]][[Category:FR]]

Sources/FR/CNIL

Nicolas — Thu, 23 Apr 2026 01:53:42 GMT

Source doc: cnil — data protection authority (DILA) (via create-page on MediaWiki MCP Server)

New page

CNIL (French data protection authority) decisions and guidelines from the DILA open data platform. Produces both decision (sanctions, enforcement) and legislation (guidance, opinions, recommendations) depending on the nature of the deliberation.

'''Status:''' active

== Source ==

{| class="wikitable"
|-
! Key !! Kind !! Origin !! Auth !! Update
|-
| <code>cnil</code> || decision + legislation || DILA open data dump — <code>echanges.dila.gouv.fr/OPENDATA/CNIL/</code> || none || incremental (tar.gz archives)
|}

'''ID format:''' <code>fr.{raw_id.lower()}</code>

'''Coverage:''' 1978–present

== Tags ==

=== Classification ===

Routing depends on NATURE_DELIB:

{| class="wikitable"
|-
! NATURE_DELIB !! → kind !! → type !! → guidance_subtype
|-
| avis || legislation || <code>guidance</code> || <code>opinion</code>
|-
| recommandation/lignes directrices || legislation || <code>guidance</code> || <code>recommendation</code>
|-
| référentiel/règlement type/norme || legislation || <code>guidance</code> || <code>reference_guide</code>
|-
| other (sanctions, enforcement) || decision || <code>administrative_decision</code> || —
|}

=== Grades ===

No grade system.

=== Identifiers ===

{| class="wikitable"
|-
! Tag !! Format
|-
| <code>case_number</code> || for decisions (sanctions)
|}

== Edges ==

None.

== Limitations ==

* Source registry declares <code>kind="decision"</code> but parser also produces <code>legislation</code> — registry needs fixing
* No structured grade or formation system

[[Category:Sources]][[Category:FR]]

Sources/FR/Constit

Nicolas — Thu, 23 Apr 2026 01:53:34 GMT

Source doc: constit — Conseil constitutionnel (DILA) (via create-page on MediaWiki MCP Server)

New page

French Constitutional Council decisions from the DILA open data platform. QPC, DC, LP, LOM and other constitutional review decisions.

'''Status:''' active

== Source ==

{| class="wikitable"
|-
! Key !! Kind !! Origin !! Auth !! Update
|-
| <code>constit</code> || decision || DILA open data dump — <code>echanges.dila.gouv.fr/OPENDATA/CONSTIT/</code> || none || incremental (tar.gz archives)
|}

'''ID format:''' <code>fr.{raw_id.lower()}</code>

'''Coverage:''' 1958–present

== Tags ==

=== Classification ===

{| class="wikitable"
|-
! Tag !! Values !! When
|-
| <code>type</code> || <code>constitutional_review</code> || always
|-
| <code>nature</code> || e.g. <code>dc</code>, <code>qpc</code>, <code>lp</code>, <code>lom</code> ||
|-
| <code>court</code> || <code>conseil_constitutionnel</code> || always
|-
| <code>court_level</code> || <code>constitutional</code> || always
|}

=== Grades ===

No grade system. <code>_importance_level_default</code> = <code>medium_importance</code>.

=== Identifiers ===

{| class="wikitable"
|-
! Tag !! Format
|-
| <code>ecli</code> || ECLI string
|-
| <code>case_number</code> || array
|}

== Edges ==

None.

== Limitations ==

* No summaries or headnote classifications
* No grade distinction — all constitutional decisions treated equally

[[Category:Sources]][[Category:FR]]

Sources/FR/CE OpenData

Nicolas — Thu, 23 Apr 2026 01:53:27 GMT

Source doc: ce_opendata — administrative courts (CE portal) (via create-page on MediaWiki MCP Server)

New page

Administrative court decisions from the Conseil d'État open data portal. Covers Conseil d'État, CAA, and TA with structured metadata (court codes, formation fields, publication grades). Monthly ZIP archives. More structured than [[Sources/FR/Jade|jade]] for the same courts.

'''Status:''' active

== Source ==

{| class="wikitable"
|-
! Key !! Kind !! Origin !! Auth !! Update
|-
| <code>ce_opendata</code> || decision || Monthly ZIPs — <code>opendata.justice-administrative.fr</code> || none || incremental (monthly archives)
|}

'''ID format:''' <code>fr.ceod_{identification.lower()}</code>

'''Coverage:''' CE since 2021-06, CAA since 2022-03, TA since 2022-06

== Sub-sources ==

{| class="wikitable"
|-
! Key !! Scope !! Since
|-
| <code>ce_opendata_ce</code> || Conseil d'État || 2021-06
|-
| <code>ce_opendata_caa</code> || Cours administratives d'appel || 2022-03
|-
| <code>ce_opendata_ta</code> || Tribunaux administratifs || 2022-06
|}

== Tags ==

=== Courts ===

{| class="wikitable"
|-
! <code>court</code> !! <code>court_level</code> !! Code_Juridiction
|-
| <code>conseil_etat</code> || <code>supreme</code> || CE
|-
| <code>cour_administrative_appel</code> || <code>appellate</code> || CAA + dept code
|-
| <code>tribunal_administratif</code> || <code>first_instance</code> || TA + dept code
|}

<code>court_location</code>: city from department code lookup (9 CAAs + 40+ TAs including overseas).

=== Grades ===

{| class="wikitable"
|-
! <code>official_grade</code> !! → <code>importance_level</code> !! Meaning
|-
| <code>A</code> || <code>highest_importance</code> || Published in Recueil Lebon
|-
| <code>B</code> || <code>high_importance</code> || Mentioned in Tables du Lebon
|-
| <code>R</code> || <code>highest_importance</code> || Major jurisprudential interest
|-
| <code>C+</code> || <code>high_importance</code> || Flagged interest
|-
| <code>C</code> || <code>low_importance</code> || Unpublished
|-
| <code>D</code> || <code>minimal_importance</code> || Limited interest
|-
| <code>Z</code> || <code>minimal_importance</code> || Limited interest
|}

Raw value from <code>Code_Publication</code> field.

=== Formation ===

Resolved from <code>Formation_Jugement</code> via <code>formation.py</code>.

=== Identifiers ===

{| class="wikitable"
|-
! Tag !! Format
|-
| <code>ecli</code> || normalized from Numero_ECLI
|-
| <code>case_number</code> || from Numero_Dossier
|}

== Edges ==

None.

== Related sources ==

{| class="wikitable"
|-
! Source !! Relationship
|-
| [[Sources/FR/Jade|jade]] || Same courts, different data source. Jade is DILA open data dump, CE OpenData is the Conseil d'État's own portal. CE OpenData has more structured metadata.
|-
| [[Sources/FR/INCA|inca]] || Legacy predecessor.
|}

== Limitations ==

* TA coverage starts 2022 — no historical first-instance decisions
* Reversed decisions require monthly CSV checks for re-download
* No summaries or headnote classifications

[[Category:Sources]][[Category:FR]]

Sources/FR/Jade

Nicolas — Thu, 23 Apr 2026 01:53:08 GMT

Source doc: jade — administrative court decisions (DILA) (via create-page on MediaWiki MCP Server)

New page

Administrative court decisions from the DILA open data platform. Covers Conseil d'État, cours administratives d'appel (CAA), and tribunaux administratifs (TA). Overlaps with [[Sources/FR/CE OpenData|ce_opendata]] which has more structured metadata and actively maintained monthly releases.

'''Status:''' active

== Source ==

{| class="wikitable"
|-
! Key !! Kind !! Origin !! Auth !! Update
|-
| <code>jade</code> || decision || DILA open data dump — <code>echanges.dila.gouv.fr/OPENDATA/JADE/</code> || none || incremental (tar.gz archives)
|}

'''ID format:''' <code>fr.{raw_id.lower()}</code>

'''Coverage:''' 1800–present

== Tags ==

=== Classification ===

{| class="wikitable"
|-
! Tag !! Values !! When
|-
| <code>type</code> || <code>judgment</code> || default
|-
| <code>type</code> || <code>advisory_opinion</code> || FORMATION starts with "AVIS"
|-
| <code>nature</code> || raw NATURE field ||
|}

=== Courts ===

{| class="wikitable"
|-
! <code>court</code> !! <code>court_level</code>
|-
| <code>conseil_etat</code> || <code>supreme</code>
|-
| <code>cour_administrative_appel</code> || <code>appellate</code>
|-
| <code>tribunal_administratif</code> || <code>first_instance</code>
|}

<code>court_location</code>: city extracted from JURIDICTION string.

=== Grades ===

{| class="wikitable"
|-
! <code>official_grade</code> !! → <code>importance_level</code> !! Meaning
|-
| <code>A</code> || <code>highest_importance</code> || Published in Recueil Lebon (CE only)
|-
| <code>B</code> || <code>high_importance</code> || Mentioned in Tables du Lebon (CE only)
|-
| <code>R</code> || <code>highest_importance</code> || Major jurisprudential interest (CAA/TA)
|-
| <code>C+</code> || <code>high_importance</code> || Flagged interest (CAA/TA)
|-
| <code>C</code> || <code>low_importance</code> || Unpublished (CAA/TA)
|-
| <code>D</code> || <code>minimal_importance</code> || Limited interest (CAA/TA)
|-
| <code>Z</code> || <code>minimal_importance</code> || Limited interest (CAA/TA)
|}

=== Formation ===

Resolved from FORMATION string via <code>formation.py</code>.

=== Identifiers ===

{| class="wikitable"
|-
! Tag !! Format
|-
| <code>ecli</code> || ECLI string
|-
| <code>case_number</code> || array
|}

== Edges ==

None.

== Related sources ==

{| class="wikitable"
|-
! Source !! Relationship
|-
| [[Sources/FR/CE OpenData|ce_opendata]] || Same courts, different data source. CE OpenData has more structured metadata (court codes, formation fields). Both are actively maintained.
|-
| [[Sources/FR/INCA|inca]] || Legacy predecessor for administrative courts.
|}

== Limitations ==

* Grade values are raw PUBLI_RECUEIL from DILA — less structured than CE OpenData
* No summaries or headnote classifications for most decisions

[[Category:Sources]][[Category:FR]]

Sources/FR/Capp

Nicolas — Thu, 23 Apr 2026 01:52:55 GMT

Source doc: capp — French courts of appeal (DILA) (via create-page on MediaWiki MCP Server)

New page

French courts of appeal decisions from the DILA open data platform. Uses the same parser as [[Sources/FR/Cass|cass]] and [[Sources/FR/Jade|jade]] (<code>case_law_parser</code>).

'''Status:''' active

== Source ==

{| class="wikitable"
|-
! Key !! Kind !! Origin !! Auth !! Update
|-
| <code>capp</code> || decision || DILA open data dump — <code>echanges.dila.gouv.fr/OPENDATA/CAPP/</code> || none || incremental (tar.gz archives)
|}

'''ID format:''' <code>fr.{raw_id.lower()}</code>

'''Coverage:''' 1790–present

== Tags ==

=== Classification ===

{| class="wikitable"
|-
! Tag !! Values !! When
|-
| <code>type</code> || <code>judgment</code> || default
|-
| <code>type</code> || <code>advisory_opinion</code> || FORMATION starts with "AVIS"
|-
| <code>court</code> || <code>cour_appel</code> || always
|-
| <code>court_level</code> || <code>appellate</code> || always
|-
| <code>court_location</code> || city extracted from JURIDICTION string ||
|}

=== Grades ===

No structured grade system. Lower court decisions are ungraded by default (<code>_importance_level_default</code> = <code>low_importance</code>).

=== Formation ===

{| class="wikitable"
|-
! <code>formation_solemnity</code> !! Criteria
|-
| <code>grand_bench</code> || "assemblée plénière"
|-
| <code>standard_bench</code> || default
|-
| <code>reduced_bench</code> || "formation restreinte"
|}

=== Identifiers ===

{| class="wikitable"
|-
! Tag !! Format
|-
| <code>ecli</code> || ECLI string
|-
| <code>case_number</code> || array
|}

== Edges ==

None.

== Related sources ==

{| class="wikitable"
|-
! Source !! Relationship
|-
| [[Sources/FR/Judilibre|judilibre]] || Overlaps for cours d'appel. Judilibre is PISTE API, capp is DILA open data dump.
|}

== Limitations ==

* No grade system — all decisions have equal weight
* No summaries or headnote classifications

[[Category:Sources]][[Category:FR]]

Sources/FR/Cass

Nicolas — Thu, 23 Apr 2026 01:52:47 GMT

Source doc: cass — Cour de cassation (DILA) (via create-page on MediaWiki MCP Server)

New page

Cour de cassation decisions from the DILA open data platform. Historical depth back to 1750. Shares coverage with [[Sources/FR/Judilibre|judilibre]] for post-2021 decisions — judilibre has richer metadata (summaries, themes, finer grades), cass has deeper historical coverage.

'''Status:''' active

== Source ==

{| class="wikitable"
|-
! Key !! Kind !! Origin !! Auth !! Update
|-
| <code>cass</code> || decision || DILA open data dump — <code>echanges.dila.gouv.fr/OPENDATA/CASS/</code> || none || incremental (tar.gz archives)
|}

'''ID format:''' <code>fr.{raw_id.lower()}</code>

'''Coverage:''' 1750–present

== Tags ==

=== Classification ===

{| class="wikitable"
|-
! Tag !! Values !! When
|-
| <code>type</code> || <code>judgment</code> || default
|-
| <code>type</code> || <code>advisory_opinion</code> || FORMATION starts with "AVIS" or NATURE = "avis"
|-
| <code>nature</code> || raw NATURE field ||
|-
| <code>court</code> || <code>cour_cassation</code> || always
|-
| <code>court_level</code> || <code>supreme</code> || always
|}

=== Grades ===

{| class="wikitable"
|-
! <code>official_grade</code> !! → <code>importance_level</code> !! Source signal
|-
| <code>bulletin</code> || <code>high_importance</code> || PUBLI_BULL@publie="oui"
|-
| <code>diffuse</code> || <code>low_importance</code> || default (no PUBLI_BULL or publie="non")
|}

Less granular than [[Sources/FR/Judilibre|judilibre]] which also has <code>rapport</code>, <code>non_diffuse</code>, and <code>particular_interest</code>.

=== Formation ===

{| class="wikitable"
|-
! <code>formation_solemnity</code> !! Criteria
|-
| <code>full_court</code> || "assemblée plénière"
|-
| <code>grand_bench</code> || "chambre mixte"
|-
| <code>combined_chambers</code> || "réunies"
|-
| <code>standard_bench</code> || default
|-
| <code>reduced_bench</code> || "formation restreinte"
|}

=== Identifiers ===

{| class="wikitable"
|-
! Tag !! Format
|-
| <code>ecli</code> || ECLI string (normalized)
|-
| <code>case_number</code> || array from NUMEROS_AFFAIRES
|}

=== Domain-specific ===

{| class="wikitable"
|-
! Tag !! Notes
|-
| <code>chamber</code> || from META_JURI_JUDI/FORMATION
|-
| <code>formation</code> || raw formation string
|-
| <code>solution</code> || decision outcome
|-
| <code>summary</code> || from SOMMAIRE (when available)
|-
| <code>headnote_classification</code> || from ANA/SCT elements
|}

== Edges ==

None.

== Related sources ==

{| class="wikitable"
|-
! Source !! Relationship
|-
| [[Sources/FR/Judilibre|judilibre]] || Overlaps for CC post-2021. Judilibre has summaries, themes, rapport/non_diffuse grades.
|-
| [[Sources/FR/INCA|inca]] || Legacy. Some older decisions may appear in both.
|}

== Limitations ==

* No summaries or headnote classifications for most decisions (unlike judilibre)
* Grade system less granular than judilibre (no rapport/non_diffuse distinction)
* Pre-2021 decisions may lack ECLI

[[Category:Sources]][[Category:FR]]

Sources/EU/CJEU

Nicolas — Thu, 23 Apr 2026 01:50:27 GMT

Source doc: cjeu — EU Court of Justice decisions (via create-page on MediaWiki MCP Server)

New page

Court of Justice of the European Union decisions from the Publications Office CELLAR database. Covers three courts: Court of Justice (CJEU), General Court, and Civil Service Tribunal (dissolved 2016). Fetched via SPARQL, with HTML/PDF download from CELLAR and InfoCuria fallback.

'''Status:''' active

== Source ==

{| class="wikitable"
|-
! Key !! Kind !! Origin !! Auth !! Update
|-
| <code>cjeu</code> || decision (+ notice for OJ-C publications) || SPARQL + CELLAR download — <code>publications.europa.eu/webapi/rdf/sparql</code> || none || incremental (year-by-year from 1952)
|}

'''ID format:''' <code>eu.eurlexjuri{celex.lower()}:{lang}</code> (e.g. <code>eu.eurlexjuri62019cj0311:fr</code>)

'''Coverage:''' 1952–present

== Tags ==

=== Classification ===

{| class="wikitable"
|-
! Tag !! Values !! When
|-
| <code>type</code> || <code>judgment</code> || CELEX sectors CJ, TJ, TT, FJ
|-
| <code>type</code> || <code>advisory_opinion</code> || CELEX sectors CC, CV
|-
| <code>type</code> || <code>order</code> || CELEX sectors CO, CP, CS, CT, TO, TC, FO
|-
| <code>nature</code> || <code>ARRÊT</code>, <code>ORDONNANCE</code>, <code>CONCLUSIONS</code> || extracted from title
|-
| <code>celex</code> || CELEX identifier ||
|}

OJ-C publications (case registrations, gazette notices) are ingested as kind=<code>notice</code> with type=<code>gazette_publication</code>.

=== Courts ===

{| class="wikitable"
|-
! <code>court</code> !! <code>court_level</code> !! CELEX position 5
|-
| <code>cjeu</code> || <code>supranational</code> || C
|-
| <code>general_court</code> || <code>first_instance</code> || T
|-
| <code>civil_service_tribunal</code> || <code>first_instance</code> || F (dissolved 2016)
|}

=== Grades ===

{| class="wikitable"
|-
! <code>official_grade</code> !! → <code>importance_level</code> !! Meaning
|-
| <code>ecr_grand_chamber</code> || <code>highest_importance</code> || Published in ECR, Grand Chamber or Full Court
|-
| <code>ecr_chamber</code> || <code>high_importance</code> || Published in ECR, chamber formation
|-
| <code>oj_only</code> || <code>low_importance</code> || Published in Official Journal only, not in ECR
|-
| <code>unpublished</code> || <code>minimal_importance</code> || Not published in ECR
|}

=== Formation ===

{| class="wikitable"
|-
! <code>formation_solemnity</code> !! Criteria
|-
| <code>full_court</code> || CELLAR URI slug FULL_COURT_C
|-
| <code>grand_bench</code> || CELLAR URI slug CHAMB_GD_C, or label contains "grand"
|-
| <code>standard_bench</code> || numbered chamber (CHAMB_01–10)
|-
| <code>reduced_bench</code> || label contains "three" or "trois" or "3"
|-
| <code>single_judge</code> || label contains "single" or "juge unique"
|}

~40% coverage from CELLAR URI; remainder via label substring fallback.

=== Identifiers ===

{| class="wikitable"
|-
! Tag !! Format
|-
| <code>ecli</code> || ECLI string from SPARQL
|-
| <code>celex</code> || CELEX identifier
|-
| <code>case_number</code> || e.g. <code>["C-311/19"]</code>
|}

=== Domain-specific ===

{| class="wikitable"
|-
! Tag !! Notes
|-
| <code>advocate_general</code> || name from SPARQL
|-
| <code>judge_rapporteur</code> || name from SPARQL
|-
| <code>summary</code> || from HTML <code></code> paragraphs
|-
| <code>original_format</code> || <code>html</code> or <code>pdf</code>
|-
| <code>translation_pending</code> || target language code when content fetched in EN fallback
|}

== Edges ==

{| class="wikitable"
|-
! <code>kind</code> !! Direction !! Trigger
|-
| <code>language_variant</code> || EN ↔ FR || post-ingest LLM translation enrichment
|}

No citation edges during ingest.

== Related sources ==

{| class="wikitable"
|-
! Source !! Relationship
|-
| [[Sources/EU/EUR-Lex|eurlex]] || EU legislation that CJEU decisions interpret. No edges between them yet.
|-
| [[Sources/EU/ECHR|echr]] || Separate court (Council of Europe, not EU). Different grade system.
|}

== Limitations ==

* Only <code>language="fr"</code> ingested — <code>language="en"</code> returns 0 results. Multi-language support planned.
* Advocate General opinions not yet ingested — <code>type=advisory_opinion</code> only covers CJEU advisory opinions on treaty interpretation, not AG opinions
* Formation solemnity has ~40% coverage from structured CELLAR data; 60% from label heuristics
* No citation edges between CJEU decisions or to EU legislation

[[Category:Sources]][[Category:EU]]

Sources/FR/LEGI

Nicolas — Thu, 23 Apr 2026 01:49:53 GMT

Source doc: legi — FR consolidated legislation (via create-page on MediaWiki MCP Server)

New page

French consolidated legislation from the DILA open data platform. The primary source for codes, laws, decrees, ordinances. Every article is versioned with enforcement status and temporal validity. Linked to [[Sources/FR/JORF|jorf]] (original gazette publication) via <code>source_text</code> edges.

'''Status:''' active

== Source ==

{| class="wikitable"
|-
! Key !! Kind !! Origin !! Auth !! Update
|-
| <code>legi</code> || legislation (+ section) || DILA open data dump — <code>echanges.dila.gouv.fr/OPENDATA/LEGI/</code> || none || incremental (tar.gz archives)
|}

'''ID format:''' <code>fr.{raw_id.lower()}</code> (e.g. <code>fr.legiarti000006900168</code>)

'''Coverage:''' 1539–present (includes forward entry-into-force dates)

== Tags ==

=== Classification ===

{| class="wikitable"
|-
! Tag !! Values !! When
|-
| <code>type</code> || <code>statute</code> || always
|-
| <code>nature</code> || raw (e.g. <code>CODE</code>, <code>LOI</code>, <code>DECRET</code>, <code>ORDONNANCE</code>) ||
|-
| <code>code</code> || code name || when nature = CODE
|-
| <code>number</code>, <code>nor</code> || act identifiers ||
|}

=== Enforcement ===

{| class="wikitable"
|-
! <code>enforcement_status</code> !! <code>in_force</code> !! DILA code
|-
| <code>in_force</code> || true || VIGUEUR, VIGUEUR_ETEN, VIGUEUR_NON_ETEN
|-
| <code>deferred_enforcement</code> || true || VIGUEUR_DIFF
|-
| <code>deferred_repeal</code> || false || ABROGE_DIFF
|-
| <code>repealed</code> || false || ABROGE
|-
| <code>superseded</code> || false || MODIFIE, REMPLACE
|-
| <code>never_in_force</code> || false || MODIFIE_MORT_NE
|-
| <code>expired</code> || false || PERIME
|-
| <code>annulled</code> || false || ANNULE
|-
| <code>transferred</code> || false || TRANSFERE, DEPLACE
|-
| <code>denounced</code> || false || DENONCE
|-
| <code>disjoined</code> || false || DISJOINT
|}

=== Structure ===

{| class="wikitable"
|-
! Tag !! Notes
|-
| <code>article_number</code> || article number within the text
|-
| <code>section_path</code> || breadcrumb through TM hierarchy
|-
| <code>text_id</code> || canonical text ID (e.g. <code>fr.legitext000006069577</code>)
|-
| <code>nota</code> || legislative notes (NOTA/CONTENU)
|}

Temporal validity via <code>date</code> (entry into force) and <code>date_end</code> (end of validity). Sentinel <code>2999-01-01</code> stripped to null.

== Edges ==

{| class="wikitable"
|-
! <code>kind</code> !! Direction !! Trigger
|-
| various (amends, repeals, cites...) || article → article || LIENS elements with sens="cible", normalized via <code>normalize_link_type()</code>
|-
| <code>source_text</code> || LEGITEXT → JORFTEXT || META_TEXTE_CHRONICLE/CID starts with "JORFTEXT"
|}

== Related sources ==

{| class="wikitable"
|-
! Source !! Relationship
|-
| [[Sources/FR/JORF|jorf]] || Same texts, different view. LEGI = consolidated + versioned. JORF = original gazette with visas and ministère. Linked by <code>source_text</code> edges.
|}

== Limitations ==

* ~4% of JORF texts have no LEGI counterpart
* No per-article grading — importance derived from text nature and code membership
* Consolidation lag: recent amendments may take days to appear

[[Category:Sources]][[Category:FR]]

Sources/FR/Judilibre

Nicolas — Thu, 23 Apr 2026 01:49:18 GMT

Source doc: judilibre — FR judicial decisions (CC, CA, TJ, TC) (via create-page on MediaWiki MCP Server)

New page

Open judicial decisions from the Cour de cassation API. Covers 4 court levels — Cour de cassation, cours d'appel, tribunaux judiciaires, tribunaux de commerce. Richest metadata among FR case law sources (summaries, themes, fine-grained grades). Overlaps with [[Sources/FR/Cass|cass]] for Cour de cassation decisions — judilibre has richer metadata, cass has deeper historical coverage.

'''Status:''' active

== Source ==

{| class="wikitable"
|-
! Key !! Kind !! Origin !! Auth !! Update
|-
| <code>judilibre</code> || decision || PISTE API — <code>api.piste.gouv.fr/cassation/judilibre/v1.0</code> || <code>PISTE_CLIENT_ID</code> || incremental (transactional history)
|}

'''ID format:''' <code>fr.judi_{raw_id}</code>

'''Coverage:''' 1790–present

== Sub-sources ==

{| class="wikitable"
|-
! Key !! Scope
|-
| <code>judilibre_cc</code> || Cour de cassation
|-
| <code>judilibre_ca</code> || Cours d'appel
|-
| <code>judilibre_tj</code> || Tribunaux judiciaires
|-
| <code>judilibre_tcom</code> || Tribunaux de commerce
|}

== Tags ==

=== Classification ===

{| class="wikitable"
|-
! Tag !! Values !! When
|-
| <code>type</code> || <code>judgment</code> || default
|-
| <code>type</code> || <code>advisory_opinion</code> || nature = "avis"
|-
| <code>nature</code> || raw from API || e.g. arret, ordonnance, avis
|}

=== Courts ===

{| class="wikitable"
|-
! <code>court</code> !! <code>court_level</code>
|-
| <code>cour_cassation</code> || <code>supreme</code>
|-
| <code>cour_appel</code> || <code>appellate</code>
|-
| <code>tribunal_judiciaire</code> || <code>first_instance</code>
|-
| <code>tribunal_commerce</code> || <code>first_instance</code>
|}

<code>court_location</code>: city extracted from jurisdiction taxonomy (e.g. "Cour d'appel de Bordeaux" → "Bordeaux").

=== Grades ===

{| class="wikitable"
|-
! <code>official_grade</code> !! → <code>importance_level</code> !! Meaning
|-
| <code>rapport</code> || <code>highest_importance</code> || Selected for the Annual Report
|-
| <code>particular_interest</code> || <code>highest_importance</code> || Flagged as particularInterest (lower courts)
|-
| <code>bulletin</code> || <code>high_importance</code> || Published in Bulletin des arrêts
|-
| <code>diffuse</code> || <code>low_importance</code> || Published online only
|-
| <code>non_diffuse</code> || <code>minimal_importance</code> || Not published
|}

=== Formation ===

{| class="wikitable"
|-
! <code>formation_solemnity</code> !! Criteria
|-
| <code>combined_chambers</code> || formation = "fm" (chambre mixte)
|-
| <code>grand_bench</code> || formation = "fs" or "fp" (assemblée plénière)
|-
| <code>reduced_bench</code> || formation = "frh", "frr", or "f" (formation restreinte)
|-
| <code>standard_bench</code> || default
|}

=== Identifiers ===

{| class="wikitable"
|-
! Tag !! Format
|-
| <code>ecli</code> || ECLI string (normalized)
|-
| <code>case_number</code> || array, display form
|-
| <code>case_number_normalized</code> || array, indexable form
|}

=== Domain-specific ===

{| class="wikitable"
|-
! Tag !! Notes
|-
| <code>chamber</code> || raw chamber field
|-
| <code>formation</code> || raw formation field
|-
| <code>solution</code> || <code>solution_alt</code> for CA, <code>solution</code> for others
|-
| <code>summary</code> || from API summary or titlesAndSummaries
|-
| <code>headnote_classification</code> || titles joined with " / ", or themes
|}

== Edges ==

None.

== Related sources ==

{| class="wikitable"
|-
! Source !! Relationship
|-
| [[Sources/FR/Cass|cass]] || Overlaps for Cour de cassation. Cass has deeper history (1750 vs 1790), judilibre has summaries, themes, finer grades.
|-
| [[Sources/FR/Capp|capp]] || Overlaps for cours d'appel. Capp is DILA open data dump, judilibre is PISTE API.
|}

== Limitations ==

* Cours d'appel, TJ, TC coverage starts ~2024 — very recent
* Rate-limited API (0.5s default between calls)
* No edges — cannot traverse citation graphs from judilibre decisions

[[Category:Sources]][[Category:FR]]

Sources

Nicolas — Thu, 23 Apr 2026 01:48:47 GMT

Sources index — coverage matrix by court/domain (via create-page on MediaWiki MCP Server)

New page

Data dictionary for the Dura Lex corpus. Each page describes what one ingest source contributes to the unified schema ([[Corpus/Tag conventions|tags]], [[Corpus/Edge types|edges]]).

* '''Looking for a court?''' → Coverage matrix below
* '''Know the source key?''' → Jump to the source page
* '''Adding a new source?''' → See [[Development/Adding a source]]

== FR — Decisions ==

{| class="wikitable"
|-
! Court !! Level !! Sources !! Grade system !! Since
|-
| Cour de cassation || supreme || [[Sources/FR/Cass|cass]], [[Sources/FR/Judilibre|judilibre]] || rapport › bulletin › diffuse › non_diffuse || 1750
|-
| Conseil d'État || supreme || [[Sources/FR/Jade|jade]], [[Sources/FR/CE OpenData|ce_opendata]] || A › B || 1800
|-
| CAA || appellate || [[Sources/FR/Jade|jade]], [[Sources/FR/CE OpenData|ce_opendata]] || R › C+ › C › D › Z || 2000
|-
| TA || first_instance || [[Sources/FR/CE OpenData|ce_opendata]] || R › C+ › C › D › Z || 2022
|-
| Cours d'appel || appellate || [[Sources/FR/Capp|capp]], [[Sources/FR/Judilibre|judilibre]] || particular_interest || 2024
|-
| TJ, TC || first_instance || [[Sources/FR/Judilibre|judilibre]] || — || 2024
|-
| Conseil constitutionnel || constitutional || [[Sources/FR/Constit|constit]] || — || 1958
|-
| Cour des comptes || supreme || [[Sources/FR/Jufi|jufi]] || recueil || 1950
|-
| CRC, CDBF, CAF || varies || [[Sources/FR/Jufi|jufi]] || recueil || 1950
|-
| CNIL || — || [[Sources/FR/CNIL|cnil]] || — || 1978
|-
| CADA || — || [[Sources/FR/CADA|cada]] || — || 1984
|}

== FR — Legislation ==

{| class="wikitable"
|-
! Domain !! Sources !! Versioned !! Edges !! Since
|-
| Codes, laws, decrees || [[Sources/FR/LEGI|legi]] || yes (enforcement_status) || amends, repeals, cites... || 1539
|-
| Official gazette || [[Sources/FR/JORF|jorf]] || no (original publication) || cites, source_text || 1539
|-
| Collective agreements (branch) || [[Sources/FR/KALI|kali]] || yes (enforcement_status) || cites || 1850
|-
| Collective agreements (enterprise) || [[Sources/FR/ACCO|acco]] || no || — || 1900
|-
| Tax doctrine || [[Sources/FR/BOFiP|bofip]] || no || — || 2000
|-
| CNIL guidelines || [[Sources/FR/CNIL|cnil]] || no || — || 1978
|}

== FR — Records & Notices ==

{| class="wikitable"
|-
! Domain !! Sources !! Kind !! Since
|-
| Company registry || [[Sources/FR/RNE|rne]] || record || 1600
|-
| Commercial announcements || [[Sources/FR/BODACC|bodacc]] || notice || 1850
|}

== EU ==

{| class="wikitable"
|-
! Court / Domain !! Sources !! Grade system !! Since
|-
| CJEU (Court of Justice) || [[Sources/EU/CJEU|cjeu]] || ecr_grand_chamber › ecr_chamber › oj_only › unpublished || 1952
|-
| General Court || [[Sources/EU/CJEU|cjeu]] || (same) || 1989
|-
| ECHR || [[Sources/EU/ECHR|echr]] || 1 › 2 › 3 › 4 || 1959
|-
| EU legislation || [[Sources/EU/EUR-Lex|eurlex]] || — || 1952
|}

== Source status ==

{| class="wikitable"
|-
! Status !! Sources
|-
| active || all except below
|-
| legacy || [[Sources/FR/INCA|inca]] (superseded by jade + ce_opendata)
|}

[[Category:Sources]]

Main Page

Nicolas — Thu, 23 Apr 2026 01:46:55 GMT

Add: libraries are composable Python packages, embeddable in custom applications (via update-page on MediaWiki MCP Server)

← Older revision		Revision as of 01:46, 23 April 2026
(One intermediate revision by the same user not shown)
Line 2:		Line 2:

	It structures public legal data — legislation, case law, company registries, administrative guidance — into a jurisdiction-agnostic corpus, queryable by AI agents via MCP and by humans via a web portal.		It structures public legal data — legislation, case law, company registries, administrative guidance — into a jurisdiction-agnostic corpus, queryable by AI agents via MCP and by humans via a web portal.

			A jurisdiction-agnostic kernel, jurisdiction plugins (France and EU today, designed for any country), a robust ingestion pipeline, and services on top. The schema follows the OpenStreetMap model — six universal structural kinds, JSONB tags, zero schema migration to add a jurisdiction.

			Everything is published as '''Python libraries''' (MIT). The kernel, the corpus protocol, the jurisdiction drivers, the ingestion framework — all are composable packages that can be embedded in any application. Use the MCP server as-is, or import the libraries directly to build your own legal data product.

	Software licensed under '''MIT'''. Enriched data licensed under '''ODbL'''.		Software licensed under '''MIT'''. Enriched data licensed under '''ODbL'''.
Line 13:		Line 17:
	\| [[Philosophy]] \|\| Why Dura Lex exists — safety, transparency, sovereignty, professional secrecy		\| [[Philosophy]] \|\| Why Dura Lex exists — safety, transparency, sovereignty, professional secrecy
	\|-		\|-
	\| [[Architecture]] \|\| How the pieces fit together		\| [[Architecture]] \|\| How the pieces fit together — kernel, drivers, pipeline, services
	\|-		\|-
	\| [[:Category:Corpus\|Corpus]] \|\| The data model — schema, tags, edges, quality, FTS		\| [[:Category:Corpus\|Corpus]] \|\| The data model — schema, tags, edges, quality, temporal versioning, FTS
	\|-		\|-
	\| [[:Category:Sources\|Sources]] \|\| Data dictionary — one page per ingest source		\| [[:Category:Sources\|Sources]] \|\| Data dictionary — one page per ingest source, coverage matrix
	\|-		\|-
	\| [[:Category:Jurisdictions\|Jurisdictions]] \|\| Legal systems we cover		\| [[:Category:Jurisdictions\|Jurisdictions]] \|\| Legal systems we cover and how they map to the unified schema
	\|-		\|-
	\| [[:Category:MCP\|MCP]] \|\| The public API — tools, guidelines, reference resolution		\| [[:Category:MCP\|MCP]] \|\| The public API — tools, safety guidelines, reference resolution
	\|-		\|-
	\| [[:Category:Development\|Development]] \|\| For contributors — coding conventions, testing, packaging		\| [[:Category:Development\|Development]] \|\| For contributors — coding conventions, testing, packaging
Line 29:		Line 33:

	== Current data ==		== Current data ==

			France is the first implementation. The architecture is designed for any jurisdiction.

	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
	! Data !! Volume ~~!! Sources~~		! Jurisdiction !! Data !! Volume
			\|-
			\| rowspan="7" \| '''France''' \|\| Court decisions \|\| 3.4M
			\|-
			\| Legislation articles \|\| 1.8M
			\|-
			\| Collective agreements \|\| 299K articles + 382K enterprise agreements
	\|-		\|-
	\| ~~Court decisions~~ \|\| 3.~~4M \|\| Judilibre, Conseil d'État, JADE, INCA, Cass, courts of appeal, CADA, CNIL, Constit~~		\| Administrative doctrine \|\| 9.6K
	\|-		\|-
	\| ~~Legislation articles~~ \|\| 1.~~8M \|\| LEGI (73 codes + non-codified laws)~~		\| Companies \|\| 24.2M
	\|-		\|-
	\| ~~Collective agreements~~ \|\| ~~299K articles + 382K enterprise agreements \|\| KALI, ACCO~~		\| Directors \|\| 15M
	\|-		\|-
	\| ~~Administrative doctrine~~ \|\| 9.~~6K \|\| BOFiP, CNIL~~		\| Cross-citations \|\| 4.4M links
	\|-		\|-
	\| ~~Companies~~ \|\| ~~24.2M~~ \|\| ~~RNE/SIRENE~~		\| rowspan="3" \| '''EU''' \|\| CJEU decisions \|\| —
	\|-		\|-
	\| ~~Directors~~ \|\| ~~15M \|\| RNE~~		\| ECHR decisions \|\| —
	\|-		\|-
	\| ~~Cross-citations~~ \|\| ~~4.4M \|\| Inter-document links~~		\| EU legislation (regulations, directives, decisions) \|\| —
	\|}		\|}