agentic-api 1.0.5 → 2.0.26

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

@@ -0,0 +1,137 @@
+import { SimpleGit } from 'simple-git';
+import { RulesGitConfig, PRMetadata, PRInfo, RuleUser, PRMergeResult, RulePullRequestDetails } from '../types';
+/**
+ * Synchronise une branche PR avec son mergeBase pour corriger les références orphelines
+ *
+ * FIXME: Cette fonction a un problème de gestion des métadonnées manquantes.
+ *
+ * PROBLÈME IDENTIFIÉ:
+ * - Les branches de validation (rule-validation-*) DOIVENT avoir des métadonnées PR
+ * - Actuellement, si les métadonnées sont manquantes, la fonction fait un return silencieux
+ * - Ceci masque un vrai problème : pourquoi une branche de validation n'a pas de métadonnées ?
+ *
+ * CAUSES POSSIBLES:
+ * - Problème de namespace Git Notes (création vs lecture dans des namespaces différents)
+ * - Race condition entre création et lecture des Git Notes
+ * - Configuration E2E différente entre helper.newPR() et gitSyncPR()
+ * - Corruption des Git Notes lors de la simulation du "reset" dans le test
+ *
+ * SOLUTION RECOMMANDÉE:
+ * - Ajouter un diagnostic approfondi pour identifier pourquoi les métadonnées sont manquantes
+ * - Distinguer le traitement : strict pour branches de validation, tolérant pour autres branches
+ * - Corriger la cause racine au lieu de masquer le symptôme
+ *
+ * IMPACT MÉTIER:
+ * - Une branche de validation sans métadonnées indique un problème d'intégrité des données
+ * - Le comportement actuel (return silencieux) peut masquer des corruptions de données
+ * - Les utilisateurs pourraient perdre des informations de PR importantes
+ *
+ * @param git Instance Git
+ * @param branch Nom de la branche PR à synchroniser
+ * @param user Utilisateur qui effectue la synchronisation
+ * @returns Promise<void>
+ */
+export declare function gitSyncPR(git: SimpleGit, branch: string, user: RuleUser): Promise<void>;
+/**
+ * Vérifie si une branche PR est fermée en regardant le message du dernier commit
+ * @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)
+ * @returns true si le PR est fermé (dernier commit contient le token de validation)
+ * DEPRECATED: use gitIsPRClosedRobust instead
+ */
+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
+ * @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)
+ * @param config Configuration Git (optionnel, utilise la config globale)
+ * @returns true si le PR est fermé
+ */
+export declare function gitIsPRClosedRobust(git: SimpleGit, branch: string, config?: RulesGitConfig): Promise<boolean>;
+/**
+ * Vérifie si une branche PR est fermée en utilisant Git Notes (avec fallback)
+ * Version robuste qui remplace gitIsPRClosed
+ * @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)
+ * @param config Configuration Git (optionnel, utilise la config globale)
+ * @returns true si le PR est fermé
+ */
+export declare function gitGetPRMetadata(git: SimpleGit, branch: string, config?: RulesGitConfig): Promise<PRMetadata | null>;
+/**
+ * Récupère tous les pull requests (branches rule-validation-*) avec leur statut
+ * @param git Instance Gitno
+ * @param options Configuration pour filtrer les PRs (default: list open PRs)
+ * @returns Liste des PRs avec leur statut (au niveau de la branche)
+ */
+export declare function gitGetAllPR(git: SimpleGit, options?: {
+    closed?: boolean;
+    validationPrefix?: string;
+}): Promise<PRInfo[]>;
+/**
+ * Finds closed PRs by scanning the history of the draft branch for merge commits with PR metadata.
+ * @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>;
+export declare function gitPRUpdateComments(git: SimpleGit, branch: string, details: RulePullRequestDetails, config?: RulesGitConfig): Promise<PRInfo>;
+/**
+ * DEPRECATED: use gitClosePRRobust instead
+ * Ferme un PR en ajoutant un commit avec le token de validation
+ * @param git Instance Git
+ * @param branch Branche PR à fermer
+ * @param author Utilisateur qui ferme le PR
+ * @param message Message optionnel à ajouter avant le token de validation
+ * @param validationToken Token utilisé pour marquer la fermeture (optionnel, utilise la config par défaut)
+ * @returns Hash du commit de fermeture
+ * DEPRECATED: use gitClosePRRobust instead
+ */
+export declare function gitClosePR(git: SimpleGit, branch: string, author: RuleUser, message?: string, validationToken?: string): Promise<PRMergeResult>;
+/**
+ * Ferme un PR en utilisant Git Notes (avec fallback vers commit)
+ * Version robuste qui remplace gitClosePR
+ * @param git Instance Git
+ * @param branch Branche PR à fermer
+ * @param closedBy Utilisateur qui ferme le PR
+ * @param message Message optionnel à ajouter avant le token de validation
+ * @param config Configuration Git (optionnel, utilise la config globale)
+ * @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).
+ * Fait un commit initial vide et écrit une note Git avec les métadonnées du travail à faire.
+ * @param git Instance SimpleGit
+ * @param files Liste des fichiers qui seront concernés par ce travail de validation
+ * @param description Description du travail ou du PR
+ * @param author Utilisateur qui initie ce travail
+ * @param options Options (content when file creation, editorBranch, validationBranchPrefix)
+ * @returns PRInfo contenant les informations de la branche créée et ses métadonnées initiales
+ */
+export declare function gitNewValidationRequest(git: SimpleGit, files: string[], description: string, author: RuleUser, options?: {
+    content?: string[];
+    editorBranch?: string;
+    mergeBase?: string;
+    validationBranchPrefix?: string;
+}): Promise<PRInfo>;
+/**
+ * DEPRECATED
+ */
+export declare function gitNewPR(git: SimpleGit, files: string[], description: string, author: RuleUser, options?: {
+    content?: string[];
+    editorBranch?: string;
+    validationPrefix?: string;
+}): Promise<PRInfo>;