agentic-api 2.0.314 → 2.0.585

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

@@ -14,8 +14,8 @@ 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.gitNewValidationRequest = 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.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 = void 0;
+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.gitNewPR = exports.gitNewValidationRequest = void 0;
 // === OPÉRATIONS GIT BAS NIVEAU ===
 // Fonctions atomiques pour manipuler Git directement
 var repo_tools_1 = require("./repo.tools");
@@ -53,6 +53,7 @@ Object.defineProperty(exports, "gitSetupRepository", { enumerable: true, get: fu
 Object.defineProperty(exports, "gitShowConfiguration", { enumerable: true, get: function () { return repo_1.gitShowConfiguration; } });
 Object.defineProperty(exports, "gitCheckConfiguration", { enumerable: true, get: function () { return repo_1.gitCheckConfiguration; } });
 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; } });
 Object.defineProperty(exports, "gitEditFile", { enumerable: true, get: function () { return repo_1.gitEditFile; } });
 Object.defineProperty(exports, "gitRenameFile", { enumerable: true, get: function () { return repo_1.gitRenameFile; } });

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

@@ -1,5 +1,14 @@
 import { SimpleGit } from 'simple-git';
 import { RulesGitConfig, GitCommitHistory, RuleUser, GitHealthStatus } from '../types';
+/**
+ * Structure du cache matter pour un fichier
+ */
+interface MatterStrict {
+    id?: number;
+    title?: string;
+    service?: string;
+    oldfile?: string;
+}
 /**
  * Vérifie si le fichier de registre d'IDs existe dans le repository Git
  *
@@ -52,7 +61,7 @@ export declare function gitReloadIDRegistry(config?: RulesGitConfig): void;
 /**
  * Enregistre un ID existant dans le registre
  *
- * @param id L'ID à enregistrer
+ * @param matter Le matter contenant l'ID à enregistrer
  * @param branch Branche du fichier (optionnel, pour vérification de propriété)
  * @param file Nom du fichier (optionnel, pour vérification de propriété)
  * @param config Configuration Git optionnelle
@@ -60,8 +69,11 @@ export declare function gitReloadIDRegistry(config?: RulesGitConfig): void;
  *
  * **Note:** Si `branch` et `file` sont fournis, la fonction vérifie si l'ID appartient
  * déjà au même fichier. Si oui, aucune erreur n'est levée (cas de re-scan).
+ *
+ * **Note:** `setMatterCache()` est appelé automatiquement avant l'enregistrement
+ * pour garantir la cohérence du cache.
  */
-export declare function gitRegisterExistingID(id: number, branch?: string, file?: string, config?: RulesGitConfig): void;
+export declare function gitRegisterExistingID(matter: MatterStrict, branch?: string, file?: string, config?: RulesGitConfig): void;
 /**
  * Renomme un fichier dans le cache du registre d'IDs
  *
@@ -84,11 +96,18 @@ export declare function gitRegisterExistingID(id: number, branch?: string, file?
 export declare function gitIDRegistryRename(oldFile: string, newFile: string, branch: string, config?: RulesGitConfig): void;
 /**
  * Valide et assure qu'un matter a un ID valide
+ *
+ * **Principe d'identité stable**: Un fichier conserve son ID à travers les branches.
+ * Cette fonction cherche d'abord si le fichier a déjà un ID dans le registre
+ * (peu importe la branche), et le réutilise pour garantir la cohérence.
+ *
  * @param matter Le matter à valider/compléter
  * @param config Configuration Git optionnelle
+ * @param branch Branche du fichier (optionnel, peut être undefined lors de createPullRequest)
+ * @param file Nom du fichier (requis pour chercher l'ID existant)
  * @returns Le matter mis à jour avec un ID valide
  */
-export declare function gitEnsureMatterID(matter: any, config?: RulesGitConfig): any;
+export declare function gitEnsureMatterID(matter: MatterStrict, config?: RulesGitConfig, branch?: string, file?: string): any;
 /**
  * Lecture rapide et stricte du matter d'un fichier (id + title uniquement)
  *
@@ -176,13 +195,20 @@ export declare function gitShowConfiguration(git: SimpleGit): Promise<any>;
  */
 export declare function gitCheckConfiguration(git?: SimpleGit): Promise<any>;
 /**
- * Crée un fichier dans la branche draft (opération bas niveau)
- * @param git Instance Git
+ * Crée ou modifie un fichier dans une branche Git et fait un commit automatique
+ *
+ * @param git Instance SimpleGit
  * @param filePath Chemin du fichier
  * @param PR Nom de la branche de Pull Request
  * @param content Contenu du fichier
- * @param user Utilisateur qui effectue l'opération
- * @param config Configuration Git (optionnel, utilise la config globale)
+ * @param user Utilisateur qui fait le commit
+ * @param config Configuration Git optionnelle
+ * @returns Historique du commit créé
+ *
+ * @fixme Ajouter un paramètre optionnel `commitMessage?: string` pour permettre de personnaliser
+ *        le message de commit au lieu d'utiliser toujours `commit: ${filePath}` par défaut.
+ *        Cela permettrait aux callers de spécifier des messages plus descriptifs.
+ *
  * @throws GitOperationError si la création échoue
  */
 export declare function gitCreateOrEditFile(git: SimpleGit, filePath: string, PR: string, content: string, user: RuleUser, config?: RulesGitConfig): Promise<GitCommitHistory>;
@@ -243,3 +269,27 @@ export declare function gitDeleteFile(git: SimpleGit, filePath: string, branch:
  * @returns Promise<GitHealthStatus> Diagnostic complet avec liste des problèmes et recommandations de réparation
  */
 export declare function gitGetBranchHealth(git: SimpleGit, branch?: string): Promise<GitHealthStatus>;
+/**
+ * Version optimisée de gitGetBranchHealth pour les branches de validation
+ *
+ * Cette fonction utilise une approche en cascade pour diagnostiquer rapidement
+ * l'état d'une branche de validation sans effectuer de checkout coûteux.
+ *
+ * Tests effectués dans l'ordre (arrêt au premier échec) :
+ * 1. Branche existe ? (git rev-parse --verify)
+ * 2. Note Git présente sur HEAD ? (gitReadNote avec maxCommit=1)
+ * 3. Note correspond au bon PR ? (note.id === prNumber)
+ *
+ * Avantages :
+ * - ✅ Pas de checkout (gain 80-90% performance)
+ * - ✅ Lecture directe du HEAD sans changer de branche
+ * - ✅ Tests cascade (arrêt dès qu'un problème est détecté)
+ * - ✅ Optimisé pour branches temporaires (validations)
+ *
+ * @param git Instance SimpleGit
+ * @param branch Nom de la branche de validation à diagnostiquer
+ * @param config Configuration Git optionnelle
+ * @returns GitHealthStatus avec diagnostic optimisé
+ */
+export declare function gitGetValidationBranchHealth(git: SimpleGit, branch: string, config?: RulesGitConfig): Promise<GitHealthStatus>;
+export {};