agentic-api 2.0.646 → 2.0.684

package/dist/src/rules/git/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.gitGetNextPRNumber = exports.gitClosePRRobust = exports.gitClosePR = exports.gitPRUpdateComments = exports.gitLoadPR = exports.gitGetClosedPRs = exports.gitGetAllPR = exports.gitGetPRMetadata = exports.gitIsPRClosedRobust = exports.gitIsPRClosed = exports.gitSyncPR = exports.gitIDRegistryRename = exports.gitIDRegistryExists = exports.gitFileStrictMatter = exports.gitEnsureMatterID = exports.gitRegisterExistingID = exports.gitReloadIDRegistry = exports.gitGenerateNextID = exports.gitDeleteFile = exports.gitRenameFile = exports.gitEditFile = exports.gitCreateOrEditFile = exports.gitGetValidationBranchHealth = exports.gitGetBranchHealth = exports.gitCheckConfiguration = exports.gitShowConfiguration = exports.gitSetupRepository = exports.gitEnsureRemoteConfiguration = exports.gitEnsureRepositoryConfiguration = exports.gitInit = exports.gitDeleteNote = exports.gitWriteNote = exports.gitReadNote = exports.gitGetDiffFiles = exports.gitGetAllBranches = exports.gitGetUnmergedBranchesForFile = exports.gitReadFileOutsideRepo = exports.gitGetFileHistory = exports.gitGetFilePreview = exports.gitGetFileContent = exports.gitGetFilesSummary = exports.gitFileExistsInBranch = exports.gitListFilesOutsideRepo = exports.gitListFilesInBranch = exports.gitLastCommit = exports.gitIsFileMerged = exports.isValidInt = exports.gitLoad = exports.unlock = exports.lock = void 0;
+exports.gitClosePRRobust = exports.gitClosePR = exports.gitPRUpdateComments = exports.gitLoadPR = exports.gitGetClosedPRs = exports.gitGetAllPR = exports.gitGetPRMetadata = exports.gitIsPRClosedRobust = exports.gitIsPRClosed = exports.gitSyncPR = exports.gitIDRegistryRename = exports.gitIDRegistryExists = exports.gitFileStrictMatter = exports.gitEnsureMatterID = exports.gitRegisterExistingID = exports.gitReloadIDRegistry = exports.gitAllocateNextPRNumber = exports.gitGenerateNextID = exports.gitDeleteFile = exports.gitRenameFile = exports.gitEditFile = exports.gitCreateOrEditFile = exports.gitGetValidationBranchHealth = exports.gitGetBranchHealth = exports.gitCheckConfiguration = exports.gitShowConfiguration = exports.gitSetupRepository = exports.gitEnsureRemoteConfiguration = exports.gitEnsureRepositoryConfiguration = exports.gitInit = exports.gitDeleteNote = exports.gitWriteNote = exports.gitReadNote = exports.gitGetDiffFiles = exports.gitGetAllBranches = exports.gitGetUnmergedBranchesForFile = exports.gitReadFileOutsideRepo = exports.gitGetFileHistory = exports.gitGetFilePreview = exports.gitGetFileContent = exports.gitGetFilesSummary = exports.gitFileExistsInBranch = exports.gitListFilesOutsideRepo = exports.gitListFilesInBranch = exports.gitLastCommit = exports.gitIsFileMerged = exports.isValidInt = exports.gitLoad = exports.unlock = exports.lock = void 0;
 exports.gitNewPR = exports.gitNewValidationRequest = void 0;
 // === OPÉRATIONS GIT BAS NIVEAU ===
 // Fonctions atomiques pour manipuler Git directement
@@ -55,33 +55,42 @@ Object.defineProperty(exports, "gitCheckConfiguration", { enumerable: true, get:
 Object.defineProperty(exports, "gitGetBranchHealth", { enumerable: true, get: function () { return repo_1.gitGetBranchHealth; } });
 Object.defineProperty(exports, "gitGetValidationBranchHealth", { enumerable: true, get: function () { return repo_1.gitGetValidationBranchHealth; } });
 Object.defineProperty(exports, "gitCreateOrEditFile", { enumerable: true, get: function () { return repo_1.gitCreateOrEditFile; } });
+// deprecated: use gitCreateOrEditFile
 Object.defineProperty(exports, "gitEditFile", { enumerable: true, get: function () { return repo_1.gitEditFile; } });
 Object.defineProperty(exports, "gitRenameFile", { enumerable: true, get: function () { return repo_1.gitRenameFile; } });
 Object.defineProperty(exports, "gitDeleteFile", { enumerable: true, get: function () { return repo_1.gitDeleteFile; } });
 // ID Management & Matter Cache
 Object.defineProperty(exports, "gitGenerateNextID", { enumerable: true, get: function () { return repo_1.gitGenerateNextID; } });
+Object.defineProperty(exports, "gitAllocateNextPRNumber", { enumerable: true, get: function () { return repo_1.gitAllocateNextPRNumber; } });
+// deprecated: low-level test helper only
 Object.defineProperty(exports, "gitReloadIDRegistry", { enumerable: true, get: function () { return repo_1.gitReloadIDRegistry; } });
 Object.defineProperty(exports, "gitRegisterExistingID", { enumerable: true, get: function () { return repo_1.gitRegisterExistingID; } });
 Object.defineProperty(exports, "gitEnsureMatterID", { enumerable: true, get: function () { return repo_1.gitEnsureMatterID; } });
 Object.defineProperty(exports, "gitFileStrictMatter", { enumerable: true, get: function () { return repo_1.gitFileStrictMatter; } });
+// deprecated: avoid pre-checks, rely on gitEnsureMatterID / gitFileStrictMatter
 Object.defineProperty(exports, "gitIDRegistryExists", { enumerable: true, get: function () { return repo_1.gitIDRegistryExists; } });
 Object.defineProperty(exports, "gitIDRegistryRename", { enumerable: true, get: function () { return repo_1.gitIDRegistryRename; } });
 // === GESTION DES PULL REQUESTS (repo.pr.ts) ===
 var repo_pr_1 = require("./repo.pr");
 // Synchronisation et statut
+// deprecated: prefer workflow-level sync orchestration
 Object.defineProperty(exports, "gitSyncPR", { enumerable: true, get: function () { return repo_pr_1.gitSyncPR; } });
+// deprecated: use gitIsPRClosedRobust
 Object.defineProperty(exports, "gitIsPRClosed", { enumerable: true, get: function () { return repo_pr_1.gitIsPRClosed; } });
 Object.defineProperty(exports, "gitIsPRClosedRobust", { enumerable: true, get: function () { return repo_pr_1.gitIsPRClosedRobust; } });
+// deprecated: use gitLoadPR for full metadata
 Object.defineProperty(exports, "gitGetPRMetadata", { enumerable: true, get: function () { return repo_pr_1.gitGetPRMetadata; } });
 Object.defineProperty(exports, "gitGetAllPR", { enumerable: true, get: function () { return repo_pr_1.gitGetAllPR; } });
+// deprecated: use gitGetAllPR(..., { closed: true })
 Object.defineProperty(exports, "gitGetClosedPRs", { enumerable: true, get: function () { return repo_pr_1.gitGetClosedPRs; } });
 Object.defineProperty(exports, "gitLoadPR", { enumerable: true, get: function () { return repo_pr_1.gitLoadPR; } });
 // Opérations sur les PRs
 Object.defineProperty(exports, "gitPRUpdateComments", { enumerable: true, get: function () { return repo_pr_1.gitPRUpdateComments; } });
+// deprecated: use gitClosePRRobust
 Object.defineProperty(exports, "gitClosePR", { enumerable: true, get: function () { return repo_pr_1.gitClosePR; } });
 Object.defineProperty(exports, "gitClosePRRobust", { enumerable: true, get: function () { return repo_pr_1.gitClosePRRobust; } });
-Object.defineProperty(exports, "gitGetNextPRNumber", { enumerable: true, get: function () { return repo_pr_1.gitGetNextPRNumber; } });
 Object.defineProperty(exports, "gitNewValidationRequest", { enumerable: true, get: function () { return repo_pr_1.gitNewValidationRequest; } });
+// deprecated: alias of gitNewValidationRequest
 Object.defineProperty(exports, "gitNewPR", { enumerable: true, get: function () { return repo_pr_1.gitNewPR; } });
 __exportStar(require("./git.e2e.helper"), exports);
 __exportStar(require("./git.health"), exports);

package/dist/src/rules/git/repo.d.ts

@@ -16,6 +16,9 @@ interface MatterStrict {
  * dans le repository. Le fichier `with-ids.json` est créé automatiquement lors du
  * premier appel à `gitGenerateNextID()` ou `gitEnsureMatterID()`.
  *
+ * @deprecated API utilitaire de compatibilité. Préférer la résolution via
+ * gitEnsureMatterID() / gitFileStrictMatter() sans dépendre d'un check préalable.
+ *
  * @param config Configuration Git optionnelle (utilise la config par défaut si non fournie)
  * @returns `true` si le fichier `.git/with-ids.json` existe, `false` sinon
  *
@@ -40,6 +43,33 @@ export declare function gitIDRegistryExists(config?: RulesGitConfig): boolean;
  * @returns Un nouvel ID unique
  */
 export declare function gitGenerateNextID(config?: RulesGitConfig): number;
+/**
+ * Génère le prochain numéro de PR via le registre `.git/with-ids.json`.
+ * Cette séquence est indépendante des IDs documentaires.
+ *
+ * @param config Configuration Git optionnelle
+ * @param minValue Valeur plancher du compteur PR (60 par défaut)
+ * @returns Prochain numéro de PR
+ */
+export declare function gitGenerateNextPRNumber(config?: RulesGitConfig, minValue?: number): number;
+/**
+ * Réaligne le compteur PR du registre sur une borne minimale sans allouer de numéro.
+ *
+ * @param minCounter Valeur minimale à garantir pour `lastPR`
+ * @param config Configuration Git optionnelle
+ */
+export declare function gitEnsureMinimumPRCounter(minCounter: number, config?: RulesGitConfig): void;
+/**
+ * Alloue le prochain numéro de PR en réalignant d'abord le compteur registre
+ * sur les branches de validation existantes.
+ *
+ * @param git Instance Git
+ * @param validationPrefix Préfixe des branches de validation
+ * @param config Configuration Git optionnelle
+ * @param minValue Valeur plancher du compteur PR (60 par défaut)
+ * @returns Prochain numéro de PR
+ */
+export declare function gitAllocateNextPRNumber(git: SimpleGit, validationPrefix: string, config?: RulesGitConfig, minValue?: number): Promise<number>;
 /**
  * Force le rechargement du registre d'IDs depuis le disque
  *
@@ -56,6 +86,8 @@ export declare function gitGenerateNextID(config?: RulesGitConfig): number;
  * await gitCreateOrEditFile(...); // Modifie le registre
  * gitReloadIDRegistry(); // Force le rechargement depuis le disque
  * ```
+ *
+ * @deprecated Réservé aux tests de bas niveau. Ne pas utiliser dans le workflow applicatif.
  */
 export declare function gitReloadIDRegistry(config?: RulesGitConfig): void;
 /**
@@ -214,6 +246,9 @@ export declare function gitCheckConfiguration(git?: SimpleGit): Promise<any>;
 export declare function gitCreateOrEditFile(git: SimpleGit, filePath: string, PR: string, content: string, user: RuleUser, config?: RulesGitConfig): Promise<GitCommitHistory>;
 /**
  * Modifie un fichier dans la branche draft (opération bas niveau)
+ *
+ * @deprecated Utiliser gitCreateOrEditFile() qui couvre création + édition.
+ *
  * @param git Instance Git
  * @param filePath Chemin du fichier
  * @param PR Nom de la branche de Pull Request
@@ -249,6 +284,8 @@ export declare function gitDeleteFile(git: SimpleGit, filePath: string, branch:
 /**
  * Diagnostique l'état de santé d'une branche Git et détecte les problèmes bloquants.
  *
+ * @deprecated Utiliser GitHealthManager pour les diagnostics et réparations.
+ *
  * **Problèmes bloquants détectés :**
  * - ❌ **Branche inexistante** : La branche spécifiée n'existe pas dans le dépôt
  * - ❌ **Branche inaccessible** : Impossible de faire un checkout vers la branche
@@ -272,6 +309,8 @@ export declare function gitGetBranchHealth(git: SimpleGit, branch?: string): Pro
 /**
  * Version optimisée de gitGetBranchHealth pour les branches de validation
  *
+ * @deprecated Utiliser GitHealthManager.diagnoseValidationBranches() / repairValidationBranches().
+ *
  * Cette fonction utilise une approche en cascade pour diagnostiquer rapidement
  * l'état d'une branche de validation sans effectuer de checkout coûteux.
  *

package/dist/src/rules/git/repo.js

@@ -35,6 +35,9 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.gitIDRegistryExists = gitIDRegistryExists;
 exports.gitGenerateNextID = gitGenerateNextID;
+exports.gitGenerateNextPRNumber = gitGenerateNextPRNumber;
+exports.gitEnsureMinimumPRCounter = gitEnsureMinimumPRCounter;
+exports.gitAllocateNextPRNumber = gitAllocateNextPRNumber;
 exports.gitReloadIDRegistry = gitReloadIDRegistry;
 exports.gitRegisterExistingID = gitRegisterExistingID;
 exports.gitIDRegistryRename = gitIDRegistryRename;
@@ -59,7 +62,6 @@ const errors_1 = require("../errors");
 const path_1 = require("path");
 const fs = __importStar(require("fs/promises"));
 const repo_tools_1 = require("./repo.tools");
-const repo_pr_1 = require("./repo.pr");
 const utils_matter_1 = require("../utils.matter");
 /**
  * Service singleton pour gérer le registre d'IDs en mémoire
@@ -122,6 +124,7 @@ class IDRegistryService {
         if (!(0, fs_1.existsSync)(registryPath)) {
             return {
                 last: 980,
+                lastPR: 60,
                 used: [],
                 updated: new Date().toISOString(),
                 matters: {}
@@ -133,12 +136,17 @@ class IDRegistryService {
             if (!data.matters) {
                 data.matters = {};
             }
+            // Migration : compteur PR indépendant (valeur initiale explicite)
+            if (!Number.isInteger(data.lastPR)) {
+                data.lastPR = 60;
+            }
             return data;
         }
         catch (error) {
             console.warn('⚠️ Registre d\'IDs corrompu, création d\'un nouveau');
             return {
                 last: 980,
+                lastPR: 60,
                 used: [],
                 updated: new Date().toISOString(),
                 matters: {}
@@ -146,7 +154,8 @@ class IDRegistryService {
         }
     }
     /**
-     * Sauvegarde le registre sur le disque (seulement si modifié)
+     * Sauvegarde le registre sur le disque (seulement si modifié).
+     * L'échec est fatal: on propage une erreur pour éviter un état incohérent.
      */
     save() {
         if (!this.registry || !this.isDirty) {
@@ -165,8 +174,7 @@ class IDRegistryService {
             this.isDirty = false;
         }
         catch (error) {
-            console.warn(`⚠️ Failed to save ID registry:`, error);
-            // Ne pas propager l'erreur, le registre est une optimisation
+            throw new errors_1.GitOperationError(`Failed to save ID registry: ${error}`, 'id_registry_save');
         }
     }
     /**
@@ -191,6 +199,35 @@ class IDRegistryService {
         this.isDirty = true;
         return newID;
     }
+    /**
+     * Génère le prochain numéro de PR (séquence indépendante des IDs documents)
+     */
+    generateNextPRNumber(minValue = 60) {
+        if (!this.registry) {
+            throw new Error('IDRegistryService not initialized. Call init() first.');
+        }
+        const baseline = Math.max(Number.isInteger(this.registry.lastPR) ? this.registry.lastPR : minValue, minValue);
+        const newPR = baseline + 1;
+        this.registry.lastPR = newPR;
+        this.isDirty = true;
+        return newPR;
+    }
+    /**
+     * Force le compteur PR à une borne minimale (sans allouer de numéro).
+     * Utile pour réaligner le registre avec des branches déjà présentes.
+     */
+    ensureMinimumPRCounter(minCounter) {
+        if (!this.registry) {
+            throw new Error('IDRegistryService not initialized. Call init() first.');
+        }
+        const normalized = Number.isInteger(minCounter) ? minCounter : 60;
+        const current = Number.isInteger(this.registry.lastPR) ? this.registry.lastPR : 60;
+        const next = Math.max(current, normalized, 60);
+        if (next !== this.registry.lastPR) {
+            this.registry.lastPR = next;
+            this.isDirty = true;
+        }
+    }
     /**
      * Obtient l'ID d'un fichier (peu importe la branche)
      *
@@ -304,7 +341,8 @@ class IDRegistryService {
             id: cached.id,
             title: cached.title,
             service: cached.service,
-            oldfile: cached.oldfile // FIXME (check if needed) ✅ Inclure oldfile temporaire si présent
+            // FIXME(oldfile): compat temporaire; ne pas utiliser oldfile comme identité documentaire.
+            oldfile: cached.oldfile
         };
     }
     /**
@@ -319,7 +357,8 @@ class IDRegistryService {
             id: matter.id,
             title: matter.title,
             service: matter.service,
-            oldfile: matter.oldfile, // ✅ Inclure oldfile temporaire
+            // FIXME(oldfile): compat temporaire; à retirer quand le client ne dépend plus de ce signal.
+            oldfile: matter.oldfile,
             updated: new Date().toISOString()
         };
         this.isDirty = true;
@@ -389,6 +428,9 @@ const idRegistryService = IDRegistryService.get();
  * dans le repository. Le fichier `with-ids.json` est créé automatiquement lors du
  * premier appel à `gitGenerateNextID()` ou `gitEnsureMatterID()`.
  *
+ * @deprecated API utilitaire de compatibilité. Préférer la résolution via
+ * gitEnsureMatterID() / gitFileStrictMatter() sans dépendre d'un check préalable.
+ *
  * @param config Configuration Git optionnelle (utilise la config par défaut si non fournie)
  * @returns `true` si le fichier `.git/with-ids.json` existe, `false` sinon
  *
@@ -426,6 +468,60 @@ function gitGenerateNextID(config) {
     idRegistryService.save();
     return newID;
 }
+/**
+ * Génère le prochain numéro de PR via le registre `.git/with-ids.json`.
+ * Cette séquence est indépendante des IDs documentaires.
+ *
+ * @param config Configuration Git optionnelle
+ * @param minValue Valeur plancher du compteur PR (60 par défaut)
+ * @returns Prochain numéro de PR
+ */
+function gitGenerateNextPRNumber(config, minValue = 60) {
+    const gitConf = (0, repo_tools_1.gitLoad)(config);
+    idRegistryService.init(gitConf.repoPath);
+    const newPR = idRegistryService.generateNextPRNumber(minValue);
+    idRegistryService.save();
+    return newPR;
+}
+/**
+ * Réaligne le compteur PR du registre sur une borne minimale sans allouer de numéro.
+ *
+ * @param minCounter Valeur minimale à garantir pour `lastPR`
+ * @param config Configuration Git optionnelle
+ */
+function gitEnsureMinimumPRCounter(minCounter, config) {
+    const gitConf = (0, repo_tools_1.gitLoad)(config);
+    idRegistryService.init(gitConf.repoPath);
+    idRegistryService.ensureMinimumPRCounter(minCounter);
+    idRegistryService.save();
+}
+/**
+ * Alloue le prochain numéro de PR en réalignant d'abord le compteur registre
+ * sur les branches de validation existantes.
+ *
+ * @param git Instance Git
+ * @param validationPrefix Préfixe des branches de validation
+ * @param config Configuration Git optionnelle
+ * @param minValue Valeur plancher du compteur PR (60 par défaut)
+ * @returns Prochain numéro de PR
+ */
+async function gitAllocateNextPRNumber(git, validationPrefix, config, minValue = 60) {
+    const gitConf = (0, repo_tools_1.gitLoad)(config);
+    idRegistryService.init(gitConf.repoPath);
+    const allBranches = await (0, repo_tools_1.gitGetAllBranches)(git);
+    const numbers = allBranches
+        .filter((branch) => branch.startsWith(validationPrefix))
+        .map((branch) => {
+        const numberPart = branch.substring(validationPrefix.length);
+        return parseInt(numberPart.split('-')[0], 10);
+    })
+        .filter((num) => !isNaN(num));
+    const maxBranchNumber = numbers.length > 0 ? Math.max(...numbers) : minValue;
+    idRegistryService.ensureMinimumPRCounter(maxBranchNumber);
+    const nextPR = idRegistryService.generateNextPRNumber(minValue);
+    idRegistryService.save();
+    return nextPR;
+}
 /**
  * Force le rechargement du registre d'IDs depuis le disque
  *
@@ -442,6 +538,8 @@ function gitGenerateNextID(config) {
  * await gitCreateOrEditFile(...); // Modifie le registre
  * gitReloadIDRegistry(); // Force le rechargement depuis le disque
  * ```
+ *
+ * @deprecated Réservé aux tests de bas niveau. Ne pas utiliser dans le workflow applicatif.
  */
 function gitReloadIDRegistry(config) {
     const gitConf = (0, repo_tools_1.gitLoad)(config);
@@ -616,7 +714,7 @@ function extractMatterFromContent(content) {
     const serviceMatch = content.match(/^service:\s*["']?([^"'\n]+)["']?/m);
     const service = serviceMatch ? serviceMatch[1].trim() : undefined;
     //
-    // ✅ Extraction de oldfile (champ temporaire pour notifier les renames)
+    // FIXME(oldfile): extraction legacy pour compat UI rename; migration cible: ID-only.
     const oldfileMatch = content.match(/^oldfile:\s*["']?([^"'\n]+)["']?/m);
     const oldfile = oldfileMatch ? oldfileMatch[1].trim() : undefined;
     return { id, title, service, oldfile };
@@ -1180,6 +1278,9 @@ async function gitCreateOrEditFile(git, filePath, PR, content, user, config) {
 }
 /**
  * Modifie un fichier dans la branche draft (opération bas niveau)
+ *
+ * @deprecated Utiliser gitCreateOrEditFile() qui couvre création + édition.
+ *
  * @param git Instance Git
  * @param filePath Chemin du fichier
  * @param PR Nom de la branche de Pull Request
@@ -1353,7 +1454,7 @@ async function gitRenameFile(git, oldFileName, newFileName, branch, user, config
             result = await gitRenameFile_git(git, oldFileName, newFileName, branch, user, config);
             if (branch !== 'NEW' && branch.startsWith(gitConf.validationPrefix)) {
                 try {
-                    await (0, repo_pr_1.gitPRReplaceFile)(git, branch, { remove: oldFileName, add: newFileName }, gitConf);
+                    await gitPRReplaceFile(git, branch, { remove: oldFileName, add: newFileName }, gitConf);
                 }
                 catch (metadataError) {
                     if (gitConf.verbose) {
@@ -1370,6 +1471,48 @@ async function gitRenameFile(git, oldFileName, newFileName, branch, user, config
         throw error;
     }
 }
+/**
+ * Met à jour la liste des fichiers d'une PR après un renommage.
+ * Helper local pour éviter une dépendance circulaire avec repo.pr.ts.
+ */
+async function gitPRReplaceFile(git, branch, options = {}, config) {
+    const { remove, add } = options;
+    if (!remove && !add) {
+        return;
+    }
+    const gitConf = (0, repo_tools_1.gitLoad)(config);
+    const metadata = await (0, repo_tools_1.gitReadNote)(git, branch, gitConf.gitNotes.namespace, 20);
+    if (!metadata) {
+        return;
+    }
+    const currentFiles = Array.isArray(metadata.files) ? metadata.files : [];
+    const seen = new Set();
+    const nextFiles = [];
+    for (const file of currentFiles) {
+        if (!file) {
+            continue;
+        }
+        if (remove && file === remove) {
+            continue;
+        }
+        if (seen.has(file)) {
+            continue;
+        }
+        seen.add(file);
+        nextFiles.push(file);
+    }
+    if (add && !seen.has(add)) {
+        nextFiles.push(add);
+    }
+    const changed = currentFiles.length !== nextFiles.length ||
+        currentFiles.some((file, idx) => file !== nextFiles[idx]);
+    if (!changed) {
+        return;
+    }
+    metadata.files = nextFiles;
+    const headCommitHash = (await git.revparse([branch])).trim();
+    await (0, repo_tools_1.gitWriteNote)(git, headCommitHash, metadata, gitConf.gitNotes.namespace);
+}
 /**
  * Supprime un fichier d'une branche Git (opération bas niveau)
  * @param git Instance Git
@@ -1468,6 +1611,8 @@ const _writeFileAndCommit = async (git, filePath, content, user, config, commitM
 /**
  * Diagnostique l'état de santé d'une branche Git et détecte les problèmes bloquants.
  *
+ * @deprecated Utiliser GitHealthManager pour les diagnostics et réparations.
+ *
  * **Problèmes bloquants détectés :**
  * - ❌ **Branche inexistante** : La branche spécifiée n'existe pas dans le dépôt
  * - ❌ **Branche inaccessible** : Impossible de faire un checkout vers la branche
@@ -1593,6 +1738,8 @@ async function gitGetBranchHealth(git, branch) {
 /**
  * Version optimisée de gitGetBranchHealth pour les branches de validation
  *
+ * @deprecated Utiliser GitHealthManager.diagnoseValidationBranches() / repairValidationBranches().
+ *
  * Cette fonction utilise une approche en cascade pour diagnostiquer rapidement
  * l'état d'une branche de validation sans effectuer de checkout coûteux.
  *

package/dist/src/rules/git/repo.pr.d.ts

@@ -3,6 +3,9 @@ import { RulesGitConfig, PRMetadata, PRInfo, RuleUser, PRMergeResult, RulePullRe
 /**
  * Synchronise une branche PR avec son mergeBase pour corriger les références orphelines
  *
+ * @deprecated Utiliser le workflow applicatif (RulesWorkflow.syncPullRequest) et
+ * les opérations robustes orientées Git Notes. API conservée pour compatibilité.
+ *
  * FIXME: Cette fonction a un problème de gestion des métadonnées manquantes.
  *
  * PROBLÈME IDENTIFIÉ:
@@ -38,12 +41,14 @@ export declare function gitSyncPR(git: SimpleGit, branch: string, user: RuleUser
  * @param branch Nom de la branche PR
  * @param validationToken Token utilisé pour marquer la fermeture (optionnel, utilise la config par défaut)
  * @returns true si le PR est fermé (dernier commit contient le token de validation)
- * DEPRECATED: use gitIsPRClosedRobust instead
+ * @deprecated Utiliser gitIsPRClosedRobust.
  */
 export declare function gitIsPRClosed(git: SimpleGit, branch: string): Promise<boolean>;
 /**
  * Vérifie si une branche PR est fermée en utilisant Git Notes (avec fallback)
  * Version robuste qui remplace gitIsPRClosed
+ * @deprecated Préférer gitLoadPR() pour récupérer l'état PR complet.
+ *
  * @param git Instance Git
  * @param branch Nom de la branche PR
  * @param validationToken Token utilisé pour marquer la fermeture (optionnel, utilise la config par défaut)
@@ -73,23 +78,18 @@ export declare function gitGetAllPR(git: SimpleGit, options?: {
 }): Promise<PRInfo[]>;
 /**
  * Finds closed PRs by scanning the history of the draft branch for merge commits with PR metadata.
+ * @deprecated Utiliser gitGetAllPR(git, { closed: true }) pour unifier le listing PR.
+ *
  * @param git SimpleGit instance
  * @param gitConfig The git configuration
  * @returns A list of PRInfo objects for closed PRs.
  */
 export declare function gitGetClosedPRs(git: SimpleGit, gitConfig: RulesGitConfig): Promise<PRInfo[]>;
 export declare function gitLoadPR(git: SimpleGit, branch: string): Promise<PRInfo>;
-/**
- * Remplace explicitement un nom de fichier dans les métadonnées d'une PR.
- * Utilisé pour refléter immédiatement les renames sans dépendre de git diff.
- */
-export declare function gitPRReplaceFile(git: SimpleGit, branch: string, options?: {
-    remove?: string;
-    add?: string;
-}, config?: RulesGitConfig): Promise<void>;
 export declare function gitPRUpdateComments(git: SimpleGit, branch: string, details: RulePullRequestDetails, config?: RulesGitConfig): Promise<PRInfo>;
 /**
- * DEPRECATED: use gitClosePRRobust instead
+ * @deprecated Utiliser gitClosePRRobust.
+ *
  * Ferme un PR en ajoutant un commit avec le token de validation
  * @param git Instance Git
  * @param branch Branche PR à fermer
@@ -111,13 +111,6 @@ export declare function gitClosePR(git: SimpleGit, branch: string, author: RuleU
  * @returns Hash du commit de fermeture ou référence de la note
  */
 export declare function gitClosePRRobust(git: SimpleGit, branch: string, closedBy: RuleUser, message?: string, config?: RulesGitConfig): Promise<PRMergeResult>;
-/**
- * Trouve le prochain numéro de PR disponible (protégé contre la concurrence)
- * @param git Instance Git
- * @param validationPrefix Préfixe des branches de validation
- * @returns Prochain numéro de PR
- */
-export declare function gitGetNextPRNumber(git: SimpleGit, validationPrefix: string): Promise<number>;
 /**
  * Crée une nouvelle branche de validation (pour un PR vers rule-editor)
  * à partir d'une branche source (typiquement rule-editor).
@@ -136,7 +129,7 @@ export declare function gitNewValidationRequest(git: SimpleGit, files: string[],
     validationBranchPrefix?: string;
 }): Promise<PRInfo>;
 /**
- * DEPRECATED
+ * @deprecated Utiliser gitNewValidationRequest().
  */
 export declare function gitNewPR(git: SimpleGit, files: string[], description: string, author: RuleUser, options?: {
     content?: string[];