@tricoteuses/tisseuse 0.13.7 → 0.13.9

package/README.md

@@ -65,6 +65,22 @@ Pour les articles dont Légifrance fournit une date de début sentinelle (`2222-
 
 Le pilote est exposé par Exploratrice à `GET /legifrance/recherche-plein-texte?q=...`, avec les filtres facultatifs `date=YYYY-MM-DD`, `nature`, `texte_cid` et `limit`.
 
+### Recherche plein texte de la jurisprudence Légifrance
+
+La projection `tisseuse.legifrance_jurisprudence_search` couvre les fonds CNIL, CONSTIT, CAPP, CASS, INCA et JADE. Les décisions sont indexées par la commande suivante, à exécuter sur le primaire PostgreSQL avec un rôle en écriture :
+
+```sh
+npm run index:postgres:legifrance-jurisprudence
+```
+
+Le rôle Tisseuse ne peut pas installer de trigger sur `legifrance.jurisprudence`. Après **chaque import DILA qui modifie ce corpus**, l’exploitation doit donc déclencher explicitement la réconciliation :
+
+```sh
+npm run index:postgres:legifrance-jurisprudence -- --all
+```
+
+Cette commande est l’étape post-import obligatoire : elle alimente la file durable, que les workers consomment par lots verrouillés. Vérifier ensuite que `tisseuse.legifrance_jurisprudence_search_queue` est vide avant de déclarer la mise à jour disponible. Ne pas l’exécuter sur un standby.
+
 ### Contenus et recherche plein texte Assemblée nationale
 
 Les documents de l’Assemblée nationale sont acquis depuis les URL institutionnelles déduites de `assemblee.documents`, puis stockés dans `tisseuse.assemblee_document_content`. Cette projection est la source de contenu d’Exploratrice : elle contient un HTML simplifié, sa version enrichie de liens lorsque disponible, le sommaire, la provenance et l’état d’acquisition. Le répertoire local `Documents/` peut servir à diagnostiquer ou à amorcer un import historique, mais n’est pas lu par le service web ou l’indexeur.
@@ -117,46 +133,34 @@ Les documents sans URL, externes au Sénat, sans Akoma Ntoso ou en échec de par
 
 ## Legal reference resolver
 
-Tisseuse resolves legal references through a `LegiResolver`. The default
-resolver is `canutes`, which uses the configured Canutes database and a generated
-`text_titles_infos.json` file.
+Tisseuse resolves legal references through the Canutes-backed `LegiResolver`.
+`LegiResolver` is exported as an abstract class from both
+`@tricoteuses/tisseuse` and `@tricoteuses/tisseuse/server`, so applications can
+provide another storage-backed implementation. At process startup, the Canutes
+resolver reads the title metadata it needs directly from
+`legifrance.texte_version` and builds the parser indexes in memory. Concurrent
+callers share the same preload operation, and the resulting indexes remain fixed
+for the lifetime of the process.
 
-There are two supported resolver paths for tests and scripts:
+No generated title index belongs in the source tree. Tests that resolve the full
+Légifrance title corpus need access to the configured Canutes database and call
+the same preload operation as production code.
 
-- `f_legi`: uses the flat f_legi database and does not need a generated
-  `text_titles_infos.json` file.
-- `canutes`: uses the Canutes database and requires generating
-  `src/lib/text_parsers/text_titles_infos.json` before running tests that parse
-  or resolve French text titles.
+### `f_legi` server adapter
 
-Use `f_legi` explicitly when you want to run against the flat f_legi database:
+Applications backed by a `f_legi` database can import the optional server-only
+adapter from the same package:
 
-```sh
-TISSEUSE_LEGI_RESOLVER=f_legi npm test
-npx tsx src/scripts/parse_assemblee_bill_raw.ts bill.html.raw --resolver f_legi
-```
+```ts
+import { FlegiResolver } from "@tricoteuses/tisseuse/server/f-legi"
 
-For the default Canutes resolver, generate the text title index first, then run
-the tests:
-
-```sh
-npx tsx src/scripts/extract_texts_titles_infos.ts
-npm test
+const resolver = new FlegiResolver(sql)
 ```
 
-This creates `src/lib/text_parsers/text_titles_infos.json`. It is generated from
-the Canutes database, is listed in `.gitignore`, and must never be committed.
-
-If you need to keep the generated file outside the working tree, pass it through
-`TISSEUSE_TEXT_TITLES_INFOS_PATH` or script options instead:
-
-```sh
-TISSEUSE_TEXT_TITLES_INFOS_PATH=/path/to/text_titles_infos.json npm test
-npx tsx src/scripts/parse_akoma_ntoso_bill_raw.ts bill.akn.xml.raw --text-titles-infos /path/to/text_titles_infos.json
-```
+The caller owns the PostgreSQL client and its lifecycle. Importing the adapter
+does not open a connection, read environment variables, or preload title data.
+The generic Tisseuse entry points do not load this adapter.
 
-If no path is supplied, the Canutes resolver first tries
-`src/lib/text_parsers/text_titles_infos.json` from the current working tree, then
-the same generated file in the local tisseuse package source tree. That file is
-generated data and is not loaded through Vitest global setup; tests that need it
-preload it explicitly through the selected resolver.
+External adapters can extend the public `LegiResolver` class. The public package
+also exports the resolver option types and `buildAndInstallTextTitlesInfos`, so
+an adapter does not need deep imports into Tisseuse.