agentic-api 2.0.646 → 2.0.885

package/dist/src/llm/xai.js

@@ -54,26 +54,31 @@ exports.LLMxai = {
     },
     "MEDIUM-fast": {
         temperature: 0.2,
-        model: "grok-4-1-fast-reasoning",
+        model: "grok-4-1-fast-non-reasoning",
         stream: true
     },
     "MEDIUM": {
         temperature: 0.2,
-        model: "grok-4-fast-reasoning",
+        model: "grok-4-1-fast-reasoning",
         stream: true
     },
     "HIGH-fast": {
-        model: "grok-4-1-fast-reasoning",
+        model: "grok-4-1-fast-non-reasoning",
+        temperature: 0.2,
+        stream: true
+    },
+    "HIGH-codex": {
+        model: "grok-code-fast-1",
         temperature: 0.2,
         stream: true
     },
     "HIGH": {
-        model: "grok-4",
+        model: "grok-4-1-fast-reasoning",
         temperature: 0.2,
         stream: true
     },
     "HIGH-medium": {
-        model: "grok-4",
+        model: "grok-4-1-fast-non-reasoning",
         temperature: 0.2,
         stream: true
     },
@@ -84,7 +89,7 @@ exports.LLMxai = {
     },
     "SEARCH": {
         temperature: 0.2,
-        model: "grok-4-fast-reasoning",
+        model: "grok-4-1-fast-non-reasoning",
         tools: [{ type: "web_search" }],
     },
 };

package/dist/src/prompts.d.ts

@@ -5,6 +5,20 @@ export declare const transferAgentPromptStructured = "\nCet outil permet de tran
 export declare const transferAgentPromptHandoff = "# Contexte g\u00E9n\u00E9ral\nTu fais partie d'un syst\u00E8me multi-agents con\u00E7u pour faciliter la coordination et l'ex\u00E9cution entre plusieurs agents. Tu utilises deux abstractions principales : **Agents** et **Transferts**. \nUn agent poss\u00E8de des instructions et des outils, et peut, quand c'est appropri\u00E9, transmettre une conversation \u00E0 un autre agent avec une autre sp\u00E9cialisation. Les transferts se font en appelant un outil nomm\u00E9e `transferAgents`.\nLes transferts entre agents sont g\u00E9r\u00E9s automatiquement en arri\u00E8re-plan ; tu ne dois jamais mentionner ou attirer l'attention sur ces transferts dans ta conversation avec l'utilisateur.\n\n## PROTOCOLE CONTEXT TRAIL `<context-trail>`\nTU DOIS consulter le trail avant de prendre une d\u00E9cision pour \u00E9viter les r\u00E9p\u00E9titions et te coordonner avec les autres agents. Le trail est visible pour toi dans tes instructions syst\u00E8me pour:\n- D\u00E9tecter les boucles et ne pas les reproduire (action d\u00E9j\u00E0 faite \u2192 surtout ne pas r\u00E9p\u00E9ter)\n- Comprendre les \u00E9tapes et ce qui reste\n- Pr\u00E9vention du drift (maintenir l'alignement \u00E0 l'objectif)\n\n";
 export declare const defaultOutputPrompt = "\n# OUTPUT INSTRUCTIONS\n- Only output CoT and Markdown.\n- Do not output the markdown code syntax, only the content.\n- Use the name of the document on top of the markdown.\n- You use bulleted lists for output, not numbered lists.\n- Do not output the main index as a section.\n- Do not output the images which are not relevant in section.\n- Ensure you follow ALL these instructions when creating your output.\n- EXAMPLE OF SECTION: `# {{page name}} - {{titre}}\n{{content}}`\n";
 export declare const textToMarkdownPrompt = "# R\u00D4LE:\n- Tu es un expert en transformation de documents proc\u00E9duraux pour un RAG (Retrieval-Augmented Generation).\n- Ton r\u00F4le est de d\u00E9composer une proc\u00E9dure en plusieurs unit\u00E9s de connaissance atomiques, optimis\u00E9es pour la recherche s\u00E9mantique avec HNSW (cosine).\n- Tu agis comme un moteur de \"reader view\" capable de construire une version fluide et lisible du document original.\n\n# MISSION:\n- Tu dois analyser le document fourni (texte brut ou HTML) et le d\u00E9couper en plusieurs unit\u00E9s de connaissance distinctes.\n- Chaque unit\u00E9 doit commencer par \"Titre:\" et \u00EAtre s\u00E9par\u00E9e de la suivante par \"---\".\n- Tu dois suivre rigoureusement le format de sortie et les r\u00E8gles de structuration.\n- Tu utilises le DICTIONNAIRE pour comprendre le jargon de l'entreprise.\n\n# R\u00C8GLES DE STRUCTURATION D'UNE UNIT\u00C9\n\n1.  **Titre (Obligatoire)**\n    - Le champ \"Titre:\" Une phrase sp\u00E9cifique \u00E0 la section qui contient l'objectif, l'action, le p\u00E9rim\u00E8tre et le b\u00E9n\u00E9ficiaire.\n    - Il sert de r\u00E9sum\u00E9 dense unique et contextualis\u00E9 pour l'embedding.\n\n2.  **Section (Obligatoire)**\n    - Le champ \"Section:\" contient le contenu d\u00E9taill\u00E9 et exhaustif de l'unit\u00E9, incluant le contexte, les \u00E9tapes et les actions.\n\n3.  **Champs Optionnels (\u00E0 omettre si vides)**\n    - **Exemple:** : Uniquement si un cas d'usage concret ou une situation illustrative est mentionn\u00E9.\n    - **Template:** : Uniquement si un mod\u00E8le de lettre, d'e-mail ou de formulaire est d\u00E9crit.\n    - **Exception:** : Uniquement si une variante \u00E0 la r\u00E8gle g\u00E9n\u00E9rale est sp\u00E9cifi\u00E9e.\n    - **Si un champ est vide, tu ne dois PAS l'inclure dans la sortie.**\n\n# FORMAT DE SORTIE\n- La sortie ne doit contenir AUCUN titre Markdown (pas de \"##\") ni de frontmatter.\n- Chaque unit\u00E9 de connaissance est un bloc de texte.\n- Le s\u00E9parateur \"---\" est utilis\u00E9 exclusivement entre chaque unit\u00E9.\n\n## EXEMPLE DE SORTIE ATTENDUE\nTitre: {Objectif proc\u00E9dure} via {action} incluant {p\u00E9rim\u00E8tre} et {b\u00E9n\u00E9ficiaire}\nSection: Contenu d\u00E9taill\u00E9, contexte, \u00E9tapes, actions\nExemple: Cas d'usage illustratif (omis si vide)\nTemplate: Mod\u00E8le de document r\u00E9utilisable (omis si vide)\nException: Variante \u00E0 la r\u00E8gle g\u00E9n\u00E9rale (omis si vide)\n---\nTitre: Un autre objectif via une autre action\nSection: Le contenu de la deuxi\u00E8me unit\u00E9.\n---\nTitre: Un troisi\u00E8me objectif via une troisi\u00E8me action\nSection: Le contenu de la troisi\u00E8me unit\u00E9.\nTemplate: Un mod\u00E8le de lettre est d\u00E9crit ici.\n\n\n# DIRECTIVES DE NETTOYAGE\n- Analyser **chaque ligne du document** pour identifier sa structure logique (paragraphes, listes, tableaux).\n- Supprimer les caract\u00E8res invisibles ou parasites fr\u00E9quents issus d'une conversion PDF (ex : saut de page \"\\f\").\n- Masquer toute information sensible li\u00E9e \u00E0 une authentification avec des ast\u00E9risques (ex : `jo***3`).\n- \u26A0\uFE0F Les sections qui contiennent uniquement des liens relatifs \u00E0 des proc\u00E9dures sont supprim\u00E9es du r\u00E9sultat final.\n\n# DIRECTIVES PRIORITAIRES POUR CAS COMPLEXES\n- Ne jamais r\u00E9sumer les sections comportant des sc\u00E9narios conditionnels (\"Si... alors...\"). Tous les cas doivent \u00EAtre explicitement d\u00E9velopp\u00E9s.\n- Toute **logique de d\u00E9cision op\u00E9rationnelle** doit \u00EAtre repr\u00E9sent\u00E9e avec une structure claire : **liste num\u00E9rot\u00E9e, liste imbriqu\u00E9e ou tableau de d\u00E9cision**.\n- Lorsque le document mentionne une situation **urgente** (mots cl\u00E9s : \"URGENT\", \"imm\u00E9diat\"), ajouter une ic\u00F4ne \"\u26A0\uFE0F\" au d\u00E9but de l'\u00E9tape.\n\n# DICTIONNAIRE:\n- Logiciels Sp\u00E9cifiques: Quorum, MFiles, Base de connaissance, Teams, HomePad, Todoist, Mammutt, E-banking, INCH, Ecopartage, Immowise.\n- SGC: Service de Gestion de la Client\u00E8le\n- GED: service qui g\u00E8re le scan des documents, la mise sous plis, l'\u00E9conomat, le r\u00E9assort des salles de pauses, la saisie des donn\u00E9es pour orienter les documents dans M-Files\n- MED: Mise en demeure.\n- WC: Toilettes.\n- M-Files: logiciel de gestion de documents\n- PR ou PRSA: Pilet & Renaud SA\n- PPE: Service qui g\u00E8re les copropri\u00E9t\u00E9s.\n- GP: Garantie Bancaire\n- WC: Toilettes.\n- BAL: Boite \u00E0 Lettre\n- DD: Arrangement de paiement pour facture due mais qui n'est pas du loyer.\n- copro: copropri\u00E9taire (attention \u00E0 ne pas confondre avec gopros)\n- un bon (bons): ordre d'intervention pour travaux (ex, bon de travail, cr\u00E9ation de bons, bons, etc).\n- La Date \u00E0 jour Locataire: le dernier mois qui a \u00E9t\u00E9 pay\u00E9 par le locataire.\n\n# APPROCHE CoT (Chain of Thought):\n- Utilise un processus de r\u00E9flexion structur\u00E9 encadr\u00E9 par les balises <thinking></thinking> avant de g\u00E9n\u00E9rer le r\u00E9sultat final. \n- Dans cette section de raisonnement tu DOIS:\n  1. Analyse toutes les DIRECTIVES et instructions qui sont \u00E0 utiliser conjointement avec la question.\n  2. D\u00E9compose la solution en \u00E9tapes claires, avec des mots-cl\u00E9s non format\u00E9s et en utilisant des balises <step> \u00E0 l'int\u00E9rieur de la r\u00E9flexion <thinking>.\n  3. Ajuste continuellement ton raisonnement en fonction des r\u00E9sultats interm\u00E9diaires et des r\u00E9flexions.\n\n\n# OUTPUT INSTRUCTIONS\n- Only output CoT and Markdown.\n- Do not output the markdown code syntax, only the content.\n- Use the name of the document on top of the markdown.\n- You use bulleted lists for output, not numbered lists.\n- Do not output the main index as a section.\n- Do not output the images which are not relevant in section.\n- Ensure you follow ALL these instructions when creating your output.\n- EXAMPLE OF SECTION: `# {{page name}} - {{titre}}\n{{content}}`\n\n";
+/**
+ * Per-page digest prompt for `callLLMForParsingPDF` (mupdf path).
+ *
+ * mupdf already provides GFM tables, bullet lists, and link footers.
+ * This prompt only normalises what mupdf leaves raw:
+ *  - title hierarchy (MAJUSCULES, colon endings)
+ *  - broken multi-line table cells
+ *  - repeated page headers / footers
+ *  - critical-element highlighting
+ *
+ * **No frontmatter** — the single YAML block is added by the caller (pdf2markdown).
+ * **finalReduce** (disabled) is reserved for a future "N-page light summary" feature.
+ */
+export declare const mupdfPagePrompt = "\nTu es *MarkdownPDF-Pro*.\n\nTu re\u00E7ois le contenu brut d'une page PDF extrait par mupdf : texte et tableaux GFM d\u00E9j\u00E0 partiellement structur\u00E9s.\n\n**Mission :** Nettoie et am\u00E9liore ce contenu en Markdown propre. Ne jamais produire de frontmatter YAML.\n\n**Ce que mupdf a d\u00E9j\u00E0 fourni (\u00E0 pr\u00E9server) :**\n- Tableaux `| col | col |` en GFM \u2014 ne pas les supprimer, mais possibilit\u00E9 d'am\u00E9liorer et corriger les cellules cass\u00E9es.\n- Listes `-` d\u00E9tect\u00E9es dans le PDF\n- Section `## Liens` en pied de page si pr\u00E9sente\n\n**Ce qu'il reste \u00E0 faire :**\n1. **Titres** : ligne en MAJUSCULES \u2192 `##` ; ligne finissant par `:` \u2192 `###` ; titre principal \u00E9vident \u2192 `#`.\n2. **Fusion de cellules cass\u00E9es** : si une cellule est coup\u00E9e sur plusieurs lignes (continuation sans s\u00E9parateur, hyph\u00E9nation en fin de ligne), fusionner dans la m\u00EAme cellule.\n3. **En-t\u00EAtes/pieds r\u00E9p\u00E9titifs** : supprimer les lignes qui ne sont que num\u00E9ro de page, logo ou nom d'entreprise sans apporter de contenu.\n4. **\u00C9l\u00E9ments critiques** : informations v\u00E9ritablement importantes \u2192 `\u26A0\uFE0F **gras**`.\n5. **Nettoyage** : un seul saut de ligne vide entre blocs ; pas de balises HTML ; conserver signes et abr\u00E9viations.\n6. **Coh\u00E9rence des tableaux** : normaliser le nombre de colonnes si des cellules manquent.\n7. **Groupes r\u00E9p\u00E9t\u00E9s dans un tableau** : si la m\u00EAme valeur de groupe appara\u00EEt dans la premi\u00E8re colonne sur plusieurs lignes cons\u00E9cutives (ex. `Code | ABC | \u2026`, `Code | DEF | \u2026`), il faut simplifier le groupe avec un titre.\n**Ne jamais :**\n- Inventer du contenu ou reformuler le fond\n- Ajouter un frontmatter YAML (`---`)\n- Ajouter des commentaires ou explications\n\nR\u00E9ponds uniquement avec le Markdown nettoy\u00E9 de la page.\n";
 export declare const htmlToMarkdownPrompt = "\nVous \u00EAtes *MarkdownPDF-Pro*, un assistant expert charg\u00E9 de transformer un texte brut issu d\u2019un PDF en un fichier Markdown clair et minimaliste, sans mise en page complexe.\nTu travailles dans le contexte de l'entreprise Pilet & Renaud SA. Tu sais que les proc\u00E9dures proviennent des services suivants: SGC (Gestion de la Client\u00E8le), RH, PPE (copropri\u00E9t\u00E9), g\u00E9rance locataire, direction, comptabilit\u00E9, contentieux, IT.\n\n**But :**\nStructurer le contenu pour qu\u2019il soit imm\u00E9diatement lisible dans n\u2019importe quel \u00E9diteur Markdown, tout en pr\u00E9servant la hi\u00E9rarchie logique (titres, listes, tableaux simples).\n\n**Contraintes globales (IMP\u00C9RATIF) :**\n1. Aucune syntaxe HTML, pas de balises <div>, <span>, etc.  \n2. Pas de styles CSS ni de code LaTeX.  \n3. Utiliser exclusivement les \u00E9l\u00E9ments Markdown suivants :  \n   * `#` \u2026 `######` pour les titres  \n   * listes \u00E0 puces `-` ou num\u00E9rot\u00E9es `1.`  \n   * blocs de citation `>` si n\u00E9cessaire  \n   * tableaux au format pipe `| Col 1 | Col 2 |`  \n   * emphase `*italique*` et `**gras**`  \n   * Front-matter YAML `---\n ...\n---\n` pour les m\u00E9tadonn\u00E9es.\n4. Ne pas ajouter d\u2019analyse ou de commentaires personnels.\n5. Si le service n\u2019est pas d\u00E9duit du texte, laisser `service: unknown`.\n6. **Les tableaux doivent \u00EAtre d\u00E9tect\u00E9s et normalis\u00E9s selon les \u201CR\u00E8gles de TABLE Markdown\u201D ci-dessous (pas de copie brute ligne par ligne).**\n\nRemplir automatiquement le champ `title` sous la forme `{service} - {action} {object} {b\u00E9n\u00E9ficiaire}` en minuscules **uniquement si ces \u00E9l\u00E9ments sont clairement inf\u00E9r\u00E9s** ; sinon, utiliser le premier `# Titre` du document. Ne jamais \u00E9crire \u201Cunknown\u201D dans `title`.\n\n---\n\n### Heuristique de structuration\n1. **D\u00E9tection des titres**  \n   * Ligne en MAJUSCULES \u2192 `##`  \n   * Ligne qui finit par \u00AB : \u00BB \u2192 `###`  \n   * Saut de ligne double + mot initial capitalis\u00E9 \u2192 `##` si > 3 mots sinon `###`.\n2. **Paragraphes** : regrouper les lignes cons\u00E9cutives jusqu\u2019au prochain saut de ligne vide.\n3. **Listes**  \n   * Convertir les puces d\u2019origine (`\u2022`, `-`, `*`, chiffres suivis de `)` ou `.`).  \n   * Conserver l\u2019imbrication (quatre espaces par niveau).\n\n---\n\n### R\u00E8gles de TABLE Markdown (g\u00E9n\u00E9riques, robustes)\n1. **D\u00E9tection d\u2019un bloc tableau** : s\u00E9quence de \u22653 lignes pr\u00E9sentant un alignement r\u00E9gulier (espaces/tabs), des s\u00E9parateurs r\u00E9currents, OU une premi\u00E8re colonne contenant des *identifiants plausibles* (ex. codes, IDs, sigles).  \n2. **Colonnes** : inf\u00E9rer le nombre de colonnes en analysant la majorit\u00E9 des lignes. Normaliser toutes les lignes \u00E0 ce nombre (remplir les cellules manquantes par vide).  \n3. **En-t\u00EAte** :  \n   - Si une premi\u00E8re ligne contient des libell\u00E9s de colonnes \u2192 utiliser comme `header`.  \n   - Sinon, g\u00E9n\u00E9rer un en-t\u00EAte minimal et neutre (`Col 1`, `Col 2`, \u2026) ou, si identifi\u00E9, des noms g\u00E9n\u00E9riques (`Identifiant`, `Libell\u00E9`, `Commentaire`).  \n4. **Fusion de lignes cass\u00E9es** : joindre aux cellules la/les lignes qui suivent quand elles sont des continuations (indentation, absence de s\u00E9parateur, hyph\u00E9nation en fin de ligne) pour \u00E9viter de cr\u00E9er de fausses lignes.  \n5. **En-t\u00EAtes visuels (cat\u00E9gories)** : lignes isol\u00E9es sans s\u00E9parateurs ni motif tabulaire, servant d\u2019intertitre (ex. cat\u00E9gories, sections) \u2192 les rendre en `###` au-dessus du tableau ou entre deux tableaux, **pas** comme des lignes de donn\u00E9es.  \n6. **Identifiants / codes** : d\u00E9tecter les *tokens* de type ID (lettres/chiffres/points/traits). Si pr\u00E9sents en premi\u00E8re colonne, **ne pas trier** ; **pr\u00E9server l\u2019ordre d\u2019origine du PDF**.  \n7. **S\u00E9paration multi-tableaux** : d\u00E9marrer un nouveau tableau lorsque le sch\u00E9ma de colonnes change, lorsqu\u2019un intertitre visuel survient, ou apr\u00E8s un blanc significatif.  \n8. **Nettoyage des cellules** : trim, consolidation des espaces multiples, \u00E9chapper `|` par `|`, conserver les signes et abr\u00E9viations.  \n9. **R\u00E9f\u00E9rences crois\u00E9es non list\u00E9es** : si des identifiants sont mentionn\u00E9s dans une cellule (ex. \u201Cutiliser le 123456\u201D) mais n\u2019apparaissent pas comme ligne d\u00E9di\u00E9e, **ne pas les inventer** dans le tableau ; \u00E0 la place, ajouter apr\u00E8s le tableau une section `#### R\u00E9f\u00E9rences crois\u00E9es non list\u00E9es` avec une liste `- 123456 : contexte (extrait bref)` si utile.  \n10. **Validation post-g\u00E9n\u00E9ration** :  \n    - Chaque tableau doit avoir \u22652 colonnes et \u22652 lignes de donn\u00E9es.  \n    - V\u00E9rifier la coh\u00E9rence (pas de d\u00E9calage de colonnes, pas de titre de cat\u00E9gorie dans les lignes).  \n    - Si la structure reste ambig\u00FCe, pr\u00E9f\u00E9rer une **liste structur\u00E9e** plut\u00F4t qu\u2019un tableau incorrect.\n\n---\n\n### Sp\u00E9cifique \u00E0 l'entreprise\n- Les informations v\u00E9ritablement critiques peuvent \u00EAtre signal\u00E9es avec `\u26A0\uFE0F` et `**gras**`, sans r\u00E9\u00E9crire le fond.  \n- Mentionner par inf\u00E9rence le `service` **uniquement dans le front-matter** ; le corps doit rester fid\u00E8le \u00E0 la source.  \n- Ne pas promouvoir des intertitres visuels en alertes `\u26A0\uFE0F`.\n\n---\n\n### \u00C9l\u00E9ments hors-texte\n- **Images** : `![Img page-X-Y](IMAGE_PLACEHOLDER_X_Y)` (une ligne par image, \u00E0 l\u2019emplacement d\u2019origine).  \n- **Notes de bas de page** : convertir en liens `[^n]` et regrouper \u00E0 la fin sous `## Notes`.\n\n---\n\n### Nettoyage final\n- Supprimer en-t\u00EAtes/pieds de page r\u00E9p\u00E9t\u00E9s (m\u00EAme s\u00E9quence sur \u2265 3 pages).  \n- R\u00E9duire les blancs multiples \u00E0 un seul.  \n- Conserver un seul saut de ligne vide entre blocs.  \n- Supprimer les sections de revue automatique (ex. \u201Crapport de r\u00E9vision\u2026\u201D) quand d\u00E9tectables.\n\n---\n\n### Format d\u2019entr\u00E9e attendu\n**Proc\u00E9dure :**\n1. Lire attentivement le bloc `<<PDF_TEXT>>`.  \n2. Appliquer les heuristiques ci-dessus, \u00E9tape par \u00E9tape (raisonnement interne, ne pas afficher).  \n3. Produire un **front-matter** puis le **Markdown final brut**, sans d\u00E9limiteurs et sans commentaires.\n\n**Front-matter (YAML) \u00E0 produire :**\n---\ntitle: {service} - {action} {object} {b\u00E9n\u00E9ficiaire}   # en minuscules si inf\u00E9r\u00E9s, sinon premier H1\nservice: {service}                                     # \"unknown\" si non d\u00E9duit\nrole: rule\nowner: {owner}\n---\n\n\n";
 export interface UsecaseExtractionOptions {
     model?: string;

package/dist/src/prompts.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.usecaseExtractionPrompt = exports.htmlToMarkdownPrompt = exports.textToMarkdownPrompt = exports.defaultOutputPrompt = exports.transferAgentPromptHandoff = exports.transferAgentPromptStructured = exports.transferAgentPrompt = exports.transferAgentPrompt__ = exports.transferAgentPrompt_ = void 0;
+exports.usecaseExtractionPrompt = exports.htmlToMarkdownPrompt = exports.mupdfPagePrompt = exports.textToMarkdownPrompt = exports.defaultOutputPrompt = exports.transferAgentPromptHandoff = exports.transferAgentPromptStructured = exports.transferAgentPrompt = exports.transferAgentPrompt__ = exports.transferAgentPrompt_ = void 0;
 exports.transferAgentPrompt_ = `Triggers a transfer of the user to a more specialized agent. 
   Calls escalate to a more specialized LLM agent or to a human agent, with additional context. 
   Only call this function if one of the available agents is appropriate. Don't transfer to your own agent type.
@@ -149,6 +149,46 @@ Template: Un modèle de lettre est décrit ici.
 
 ${exports.defaultOutputPrompt}
 `;
+/**
+ * Per-page digest prompt for `callLLMForParsingPDF` (mupdf path).
+ *
+ * mupdf already provides GFM tables, bullet lists, and link footers.
+ * This prompt only normalises what mupdf leaves raw:
+ *  - title hierarchy (MAJUSCULES, colon endings)
+ *  - broken multi-line table cells
+ *  - repeated page headers / footers
+ *  - critical-element highlighting
+ *
+ * **No frontmatter** — the single YAML block is added by the caller (pdf2markdown).
+ * **finalReduce** (disabled) is reserved for a future "N-page light summary" feature.
+ */
+exports.mupdfPagePrompt = `
+Tu es *MarkdownPDF-Pro*.
+
+Tu reçois le contenu brut d'une page PDF extrait par mupdf : texte et tableaux GFM déjà partiellement structurés.
+
+**Mission :** Nettoie et améliore ce contenu en Markdown propre. Ne jamais produire de frontmatter YAML.
+
+**Ce que mupdf a déjà fourni (à préserver) :**
+- Tableaux \`| col | col |\` en GFM — ne pas les supprimer, mais possibilité d'améliorer et corriger les cellules cassées.
+- Listes \`-\` détectées dans le PDF
+- Section \`## Liens\` en pied de page si présente
+
+**Ce qu'il reste à faire :**
+1. **Titres** : ligne en MAJUSCULES → \`##\` ; ligne finissant par \`:\` → \`###\` ; titre principal évident → \`#\`.
+2. **Fusion de cellules cassées** : si une cellule est coupée sur plusieurs lignes (continuation sans séparateur, hyphénation en fin de ligne), fusionner dans la même cellule.
+3. **En-têtes/pieds répétitifs** : supprimer les lignes qui ne sont que numéro de page, logo ou nom d'entreprise sans apporter de contenu.
+4. **Éléments critiques** : informations véritablement importantes → \`⚠️ **gras**\`.
+5. **Nettoyage** : un seul saut de ligne vide entre blocs ; pas de balises HTML ; conserver signes et abréviations.
+6. **Cohérence des tableaux** : normaliser le nombre de colonnes si des cellules manquent.
+7. **Groupes répétés dans un tableau** : si la même valeur de groupe apparaît dans la première colonne sur plusieurs lignes consécutives (ex. \`Code | ABC | …\`, \`Code | DEF | …\`), il faut simplifier le groupe avec un titre.
+**Ne jamais :**
+- Inventer du contenu ou reformuler le fond
+- Ajouter un frontmatter YAML (\`---\`)
+- Ajouter des commentaires ou explications
+
+Réponds uniquement avec le Markdown nettoyé de la page.
+`;
 exports.htmlToMarkdownPrompt = `
 Vous êtes *MarkdownPDF-Pro*, un assistant expert chargé de transformer un texte brut issu d’un PDF en un fichier Markdown clair et minimaliste, sans mise en page complexe.
 Tu travailles dans le contexte de l'entreprise Pilet & Renaud SA. Tu sais que les procédures proviennent des services suivants: SGC (Gestion de la Clientèle), RH, PPE (copropriété), gérance locataire, direction, comptabilité, contentieux, IT.

package/dist/src/rag/rag.manager.d.ts

@@ -1,4 +1,4 @@
-import { RAGManagerConfig, RAGRegistryEntry, RAGConfig, ParsedDocument, DocumentQueries } from './types';
+import { RAGManagerConfig, RAGRegistryEntry, RAGConfig, ParsedDocument, RAGMetadata, DocumentQueries } from './types';
 import { Embeddings } from './embeddings';
 /**
  * Gestionnaire multi-RAG stateless pour gérer plusieurs index RAG
@@ -75,6 +75,7 @@ export declare class RAGManager {
      */
     notifyUpdate(name: string, opts?: {
         action?: 'rename';
+        id?: number;
         oldFile?: string;
         newFile?: string;
     }): void;
@@ -86,6 +87,15 @@ export declare class RAGManager {
      * Archive un RAG existant
      */
     private archive;
+    /**
+     * Charge la configuration depuis le fichier metadata
+     */
+    private readMetadataFile;
+    /**
+     * Charge les métadonnées d'un RAG sans instancier un nouvel Embeddings.
+     * Si le RAG est déjà chargé, réutilise les métadonnées en mémoire.
+     */
+    loadMetadata(name: string): RAGMetadata;
     /**
      * Charge la configuration depuis le fichier metadata
      */
@@ -107,6 +117,10 @@ export declare class RAGManager {
      * @private
      */
     private saveMapping;
+    /**
+     * Supprime les fichiers orphelins d'un dossier RAG à partir des documents indexés.
+     */
+    private cleanupOrphanFiles;
     /**
      * Nettoie les anciennes archives d'un RAG
      */
@@ -311,6 +325,7 @@ export declare class RAGManager {
      * Supprime un RAG du registre
      */
     delete(name: string, archiveFlag?: boolean): Promise<void | Error>;
+    private resolveDocumentFilenameById;
     /**
      * Renomme un document dans un RAG existant
      *
@@ -323,7 +338,7 @@ export declare class RAGManager {
      * Et met à jour les références dans les fichiers JSON (mapping, metadata, queries)
      *
      * @param ragName Nom du RAG concerné
-     * @param oldFile Ancien nom du fichier (ex: 'old-name.md')
+     * @param oldFileOrId Ancien nom du fichier (ex: 'old-name.md') ou ID documentaire
      * @param newFile Nouveau nom du fichier (ex: 'new-name.md')
      *
      * @example
@@ -331,7 +346,7 @@ export declare class RAGManager {
      * ragManager.renameDocument('rule-validation-1', 'old-procedure.md', 'new-procedure.md');
      * ```
      */
-    renameDocument(ragName: string, oldFile: string, newFile: string): void;
+    renameDocument(ragName: string, oldFileOrId: string | number, newFile: string): void;
     /**
      * Met à jour les références d'un fichier dans les JSON du RAG
      *

package/dist/src/rag/rag.manager.js

@@ -34,6 +34,9 @@ class RAGManager {
         if (!config.baseDir || !(0, fs_1.existsSync)(config.baseDir)) {
             throw new Error(`Le dossier du registre RAG n'existe pas: ${config.baseDir}`);
         }
+        if (!config.defaultName || config.defaultName.trim() === '') {
+            throw new Error('RAGManagerConfig.defaultName est obligatoire et ne peut pas être vide');
+        }
         this.config = {
             tempDir: path_1.default.join(config.baseDir, 'temp'),
             archiveDir: path_1.default.join(config.baseDir, 'archives'),
@@ -49,7 +52,10 @@ class RAGManager {
         // store instance in memory
         DEFAULT_RAG_INSTANCE[this.config.baseDir] = this;
         const registry = this.getRegistry();
-        const defaultName = registry.defaultName || 'RAGRegistry';
+        const defaultName = registry.defaultName;
+        if (!defaultName || defaultName.trim() === '') {
+            throw new Error('registry.json invalide: defaultName manquant');
+        }
         DEFAULT_RAG_INSTANCE[defaultName] = this;
     }
     static get(config) {
@@ -101,7 +107,7 @@ class RAGManager {
                 registry = {
                     version: '1.0',
                     registries: {},
-                    defaultName: 'RAGRegistry'
+                    defaultName: this.config.defaultName
                 };
             }
         }
@@ -109,12 +115,12 @@ class RAGManager {
             registry = {
                 version: '1.0',
                 registries: {},
-                defaultName: 'RAGRegistry'
+                defaultName: this.config.defaultName
             };
         }
-        // Définir defaultName par défaut s'il n'est pas défini
+        // Fail-fast: defaultName doit toujours être défini explicitement
         if (!registry.defaultName) {
-            registry.defaultName = 'RAGRegistry';
+            throw new Error('registry.json invalide: defaultName manquant. Fournir defaultName dans la config RAG.');
         }
         // Scanner les dossiers pour découvrir les RAG existants
         this.scanDirectoriesForRAGs(registry);
@@ -312,13 +318,39 @@ class RAGManager {
     /**
      * Charge la configuration depuis le fichier metadata
      */
-    loadConfig(configPath) {
-        const metadataFile = path_1.default.join(configPath, 'rag-metadata.json');
+    readMetadataFile(configPath) {
+        const metadataFile = path_1.default.join(configPath, types_1.RAG_FILES.METADATA);
         if (!(0, fs_1.existsSync)(metadataFile)) {
             throw new Error(`Fichier metadata manquant: ${metadataFile}`);
         }
         try {
-            const metadata = JSON.parse((0, fs_1.readFileSync)(metadataFile, 'utf8'));
+            return JSON.parse((0, fs_1.readFileSync)(metadataFile, 'utf8'));
+        }
+        catch (error) {
+            throw new Error(`Erreur lors du chargement des métadonnées RAG: ${error}`);
+        }
+    }
+    /**
+     * Charge les métadonnées d'un RAG sans instancier un nouvel Embeddings.
+     * Si le RAG est déjà chargé, réutilise les métadonnées en mémoire.
+     */
+    loadMetadata(name) {
+        if (!this.exists(name)) {
+            throw new Error(`RAG '${name}' n'existe pas`);
+        }
+        const embeddingData = this.loadedEmbeddings.get(name);
+        if (embeddingData) {
+            return embeddingData.embedding.getMetadata();
+        }
+        const entry = this.getEntry(name);
+        return this.readMetadataFile(entry.configPath);
+    }
+    /**
+     * Charge la configuration depuis le fichier metadata
+     */
+    loadConfig(configPath) {
+        try {
+            const metadata = this.readMetadataFile(configPath);
             // Extraire la configuration depuis les métadonnées
             const ragConfig = {
                 baseDir: configPath,
@@ -380,6 +412,41 @@ class RAGManager {
             throw new Error(`Échec de la sauvegarde du mapping: ${error}`);
         }
     }
+    /**
+     * Supprime les fichiers orphelins d'un dossier RAG à partir des documents indexés.
+     */
+    cleanupOrphanFiles(configPath, metadata) {
+        const allowedFiles = new Set([
+            types_1.RAG_FILES.VECTORS,
+            types_1.RAG_FILES.METADATA,
+            types_1.RAG_FILES.MAPPING,
+            types_1.RAG_FILES.QUERIES
+        ]);
+        const uniqueFilenames = new Set();
+        for (const doc of Object.values(metadata.documents || {})) {
+            if (doc.filename) {
+                uniqueFilenames.add(doc.filename);
+            }
+        }
+        for (const filename of uniqueFilenames) {
+            const baseName = filename.replace(/\.md$/, '');
+            allowedFiles.add(filename);
+            allowedFiles.add(`${filename}.sha`);
+            allowedFiles.add(`${baseName}.enhanced.md`);
+            allowedFiles.add(`${baseName}.query.json`);
+        }
+        for (const fileName of (0, fs_1.readdirSync)(configPath)) {
+            const fullPath = path_1.default.join(configPath, fileName);
+            if (!allowedFiles.has(fileName)) {
+                try {
+                    (0, fs_1.rmSync)(fullPath, { recursive: true, force: true });
+                }
+                catch (error) {
+                    console.warn(`⚠️ Erreur suppression fichier orphelin ${fileName}:`, error);
+                }
+            }
+        }
+    }
     /**
      * Nettoie les anciennes archives d'un RAG
      */
@@ -732,8 +799,15 @@ class RAGManager {
         }
         //
         // Charger le metadata pour obtenir la liste des documents
+        // Ignorer les dossiers temporaires (temp/) sans metadata
         const metadataFile = path_1.default.join(entry.configPath, types_1.RAG_FILES.METADATA);
         if (!(0, fs_1.existsSync)(metadataFile)) {
+            //
+            // Si c'est un dossier temporaire (temp/rule-validation-*), retourner vide au lieu d'erreur
+            if (entry.configPath.includes('/temp/') || entry.status === 'building') {
+                console.warn(`⚠️ Dossier temporaire sans metadata ignoré: ${entry.configPath}`);
+                return { documents: {}, totalQueries: 0 };
+            }
             throw new Error(`Fichier metadata manquant: ${metadataFile}`);
         }
         let metadata;
@@ -858,6 +932,7 @@ class RAGManager {
             // Sauvegarder les métadonnées et le mapping
             this.saveMetadata(buildPath, metadata);
             this.saveMapping(buildPath, buildResult.mapping, buildResult);
+            this.cleanupOrphanFiles(buildPath, metadata);
             // ✅ En mode legacy, on construit directement dans configPath (pas de déplacement)
             if (!isLegacyMode && destDir) {
                 // Archiver l'ancienne version si elle existe
@@ -990,7 +1065,7 @@ class RAGManager {
             // Changer le défaut si nécessaire
             if (registry.defaultName === name) {
                 const remainingRAGs = Object.keys(registry.registries);
-                registry.defaultName = remainingRAGs.length > 0 ? remainingRAGs[0] : 'RAGRegistry';
+                registry.defaultName = remainingRAGs.length > 0 ? remainingRAGs[0] : this.config.defaultName;
             }
             this.saveRegistry(registry);
             console.log(`✅ RAG supprimé: ${name}`);
@@ -999,6 +1074,20 @@ class RAGManager {
             return error;
         }
     }
+    resolveDocumentFilenameById(ragName, configPath, documentId) {
+        try {
+            const metadata = this.loadMetadata(ragName);
+            for (const doc of Object.values(metadata.documents || {})) {
+                if (typeof doc.metadata?.id === 'number' && doc.metadata.id === documentId) {
+                    return doc.filename;
+                }
+            }
+        }
+        catch (error) {
+            console.warn(`⚠️ Erreur lecture metadata pour résolution par ID:`, error);
+        }
+        return undefined;
+    }
     /**
      * Renomme un document dans un RAG existant
      *
@@ -1011,7 +1100,7 @@ class RAGManager {
      * Et met à jour les références dans les fichiers JSON (mapping, metadata, queries)
      *
      * @param ragName Nom du RAG concerné
-     * @param oldFile Ancien nom du fichier (ex: 'old-name.md')
+     * @param oldFileOrId Ancien nom du fichier (ex: 'old-name.md') ou ID documentaire
      * @param newFile Nouveau nom du fichier (ex: 'new-name.md')
      *
      * @example
@@ -1019,7 +1108,7 @@ class RAGManager {
      * ragManager.renameDocument('rule-validation-1', 'old-procedure.md', 'new-procedure.md');
      * ```
      */
-    renameDocument(ragName, oldFile, newFile) {
+    renameDocument(ragName, oldFileOrId, newFile) {
         const entry = this.getEntry(ragName);
         if (!entry) {
             if (this.config.verbose) {
@@ -1028,6 +1117,15 @@ class RAGManager {
             return;
         }
         const configPath = entry.configPath;
+        const oldFile = typeof oldFileOrId === 'number'
+            ? this.resolveDocumentFilenameById(ragName, configPath, oldFileOrId)
+            : oldFileOrId;
+        if (!oldFile) {
+            if (this.config.verbose) {
+                console.log(`⚠️ Aucun document trouvé pour ${typeof oldFileOrId === 'number' ? `id=${oldFileOrId}` : oldFileOrId} dans RAG '${ragName}'`);
+            }
+            return;
+        }
         //
         // Liste des fichiers à renommer (sans extension pour le basename)
         const oldBase = oldFile.replace(/\.md$/, '');
@@ -1070,6 +1168,7 @@ class RAGManager {
         // Notifier les embeddings chargés de se mettre à jour avec l'action rename
         this.notifyUpdate(ragName, {
             action: 'rename',
+            id: typeof oldFileOrId === 'number' ? oldFileOrId : undefined,
             oldFile,
             newFile
         });
@@ -1420,7 +1519,10 @@ class RAGManager {
      */
     getDefault() {
         const registry = this.getRegistry();
-        return registry.defaultName || 'RAGRegistry';
+        if (!registry.defaultName || registry.defaultName.trim() === '') {
+            throw new Error('registry.json invalide: defaultName manquant');
+        }
+        return registry.defaultName;
     }
     /**
      * Obtient les statistiques de tous les RAG

package/dist/src/rag/types.d.ts

@@ -278,13 +278,15 @@ export interface RAGRegistry {
     version: string;
     /** Liste des RAG disponibles */
     registries: Record<string, RAGRegistryEntry>;
-    /** RAG par défaut (par défaut: 'RAGRegistry') */
+    /** RAG par défaut (obligatoire) */
     defaultName?: string;
 }
 /** Configuration du gestionnaire RAG */
 export interface RAGManagerConfig {
     /** Répertoire de base du registre */
     baseDir: string;
+    /** Nom du RAG par défaut (obligatoire) */
+    defaultName?: string;
     /** Répertoire temporaire pour les constructions */
     tempDir?: string;
     /** Répertoire d'archives */

package/dist/src/rules/git/git.e2e.helper.js

@@ -156,14 +156,14 @@ Temporary repository for E2E testing.`;
         return (0, index_1.gitCheckConfiguration)(this.git);
     }
     async isPRClosed(branch) {
-        return (0, index_1.gitIsPRClosed)(this.git, branch);
+        return (0, index_1.gitIsPRClosedRobust)(this.git, branch, this.config);
     }
     async isPRClosedRobust(branch, config) {
         return (0, index_1.gitIsPRClosedRobust)(this.git, branch, config || this.config);
     }
     async closePR(branch, author, message) {
         console.log(`[DEBUG][E2EHelper.closePR] Closing PR: ${branch} by ${author.name}`);
-        return (0, index_1.gitClosePR)(this.git, branch, author, message);
+        return (0, index_1.gitClosePRRobust)(this.git, branch, author, message || `Closed by ${author.name}`, this.config);
     }
     async closePRRobust(branch, closedBy, message, config) {
         return (0, index_1.gitClosePRRobust)(this.git, branch, closedBy, message, config || this.config);
@@ -174,7 +174,47 @@ Temporary repository for E2E testing.`;
         return (0, index_1.gitGetAllPR)(this.git, options);
     }
     async getNextPRNumber(validationPrefix) {
-        return (0, index_1.gitGetNextPRNumber)(this.git, validationPrefix);
+        const initialPRCounter = 60;
+        const registryPath = (0, path_1.join)(this.config.repoPath, '.git', 'with-ids.json');
+        const now = new Date().toISOString();
+        const allBranches = await this.getAllBranches();
+        const numbers = allBranches
+            .filter((branch) => branch.startsWith(validationPrefix))
+            .map((branch) => parseInt(branch.substring(validationPrefix.length).split('-')[0], 10))
+            .filter((num) => !isNaN(num));
+        const maxBranchNumber = numbers.length > 0 ? Math.max(...numbers) : initialPRCounter;
+        let registry = {
+            last: 980,
+            lastPR: initialPRCounter,
+            used: [],
+            updated: now,
+            matters: {}
+        };
+        if ((0, fs_1.existsSync)(registryPath)) {
+            try {
+                registry = JSON.parse(await fs_1.promises.readFile(registryPath, 'utf8'));
+            }
+            catch {
+                // Rebuild minimal registry fallback
+            }
+        }
+        if (!Number.isInteger(registry.lastPR)) {
+            registry.lastPR = initialPRCounter;
+        }
+        if (!Number.isInteger(registry.last)) {
+            registry.last = 980;
+        }
+        if (!Array.isArray(registry.used)) {
+            registry.used = [];
+        }
+        if (!registry.matters || typeof registry.matters !== 'object') {
+            registry.matters = {};
+        }
+        const nextPR = Math.max(registry.lastPR, maxBranchNumber, initialPRCounter) + 1;
+        registry.lastPR = nextPR;
+        registry.updated = now;
+        await fs_1.promises.writeFile(registryPath, JSON.stringify(registry, null, 2), 'utf8');
+        return nextPR;
     }
     async newPR(files, description, author, options) {
         //console.log(`[DEBUG][E2EHelper.newPR] Creating new PR by ${author.name} for files: ${files.join(', ')}`);
@@ -220,7 +260,11 @@ Temporary repository for E2E testing.`;
     async editFile(filePath, content, branch) {
         const user = { name: 'E2E Test', email: 'e2e@test.com' };
         const targetBranch = branch || this.config.draftBranch;
-        return (0, index_1.gitEditFile)(this.git, filePath, targetBranch, content, user, this.config);
+        const exists = await (0, index_1.gitFileExistsInBranch)(this.git, filePath, targetBranch);
+        if (!exists) {
+            throw new Error(`File "${filePath}" not found in branch "${targetBranch}"`);
+        }
+        return (0, index_1.gitCreateOrEditFile)(this.git, filePath, targetBranch, content, user, this.config);
     }
     async validateRepositoryState() {
         const errors = [];
@@ -379,6 +423,9 @@ const defaultConfig = (tempDir) => {
         instance: (0, simple_git_1.default)({ baseDir: tempDir, binary: 'git' }),
         repoPath: tempDir,
         uploadPath: (0, path_1.join)(tempDir, '.assets'), // Add uploadPath to default config
+        // FIXME(test-config): inject a dedicated fake remote when we need remote-aware E2E coverage.
+        // Empty string explicitly disables inheriting GIT_REMOTE_URL from the developer environment.
+        remoteUrl: '',
         draftBranch: 'rule-editor',
         mainBranch: 'main',
         validationPrefix: 'rule-validation-',