agentic-api 1.0.5 → 2.0.26

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

@@ -0,0 +1,128 @@
+import { SimpleGit } from 'simple-git';
+import { RulesGitConfig, GitCommitHistory, RuleUser, GitHealthStatus } from '../types';
+/**
+ * Vérifie et configure un repository Git existant pour s'assurer qu'il a la configuration requise
+ * @param git Instance SimpleGit
+ * @param options Options de configuration
+ */
+export declare function gitEnsureRepositoryConfiguration(git: SimpleGit, options?: {
+    remoteUrl?: string;
+    remoteName?: string;
+    forceUpdate?: boolean;
+}): Promise<{
+    configured: boolean;
+    changes: string[];
+}>;
+/**
+ * Configure le remote origin et les paramètres Git Notes
+ * @param git Instance SimpleGit
+ * @param config Configuration du remote
+ */
+export declare function gitEnsureRemoteConfiguration(git: SimpleGit, config: {
+    remoteUrl?: string;
+    remoteName?: string;
+    quiet?: boolean;
+}): Promise<void>;
+export declare function gitInit(git: SimpleGit, options?: {
+    excludePatterns?: string[];
+    remoteUrl?: string;
+    remoteName?: string;
+    enableGitNotes?: boolean;
+}): Promise<void>;
+/**
+ * Fonction helper pour initialiser ou configurer un repository avec la configuration Git standard
+ * Cette fonction combine gitInit et gitEnsureRepositoryConfiguration pour une utilisation simple
+ * @param git Instance SimpleGit
+ * @param options Options de configuration
+ */
+export declare function gitSetupRepository(git: SimpleGit, options?: {
+    remoteUrl?: string;
+    remoteName?: string;
+    enableGitNotes?: boolean;
+    excludePatterns?: string[];
+    forceReconfig?: boolean;
+}): Promise<{
+    initialized: boolean;
+    configured: boolean;
+    changes: string[];
+}>;
+/**
+ * Fonction helper pour vérifier et afficher la configuration Git d'un repository
+ * @param git Instance SimpleGit
+ * @returns Configuration détaillée
+ */
+export declare function gitShowConfiguration(git: SimpleGit): Promise<any>;
+/**
+ * Vérifie la validité de la configuration Git (utilitaire)
+ * @param git Instance Git
+ * @returns Promise<boolean> True si la configuration est valide
+ */
+export declare function gitCheckConfiguration(git?: SimpleGit): Promise<any>;
+/**
+ * Crée un fichier dans la branche draft (opération bas niveau)
+ * @param git Instance Git
+ * @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)
+ * @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>;
+/**
+ * Modifie un fichier dans la branche draft (opération bas niveau)
+ * @param git Instance Git
+ * @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)
+ * @throws GitOperationError si la modification échoue
+ */
+export declare function gitEditFile(git: SimpleGit, filePath: string, PR: string, content: string, user: RuleUser, config?: RulesGitConfig): Promise<GitCommitHistory>;
+export declare function gitRenameFile_git(git: SimpleGit, oldFileName: string, newFileName: string, branch: string, user: RuleUser, config?: RulesGitConfig): Promise<GitCommitHistory>;
+export declare function gitRenameFile_fs(git: SimpleGit, oldFileName: string, newFileName: string, branch: string, user: RuleUser, config?: RulesGitConfig): Promise<GitCommitHistory>;
+/**
+ * Renomme un fichier de manière atomique (Git ou filesystem selon le contexte)
+ * @param git Instance SimpleGit
+ * @param oldFileName Ancien nom du fichier
+ * @param newFileName Nouveau nom du fichier
+ * @param branch Branche où effectuer le renommage
+ * @param user Utilisateur effectuant l'opération
+ * @param config Configuration Git optionnelle
+ * @returns Historique du commit de renommage
+ */
+export declare function gitRenameFile(git: SimpleGit, oldFileName: string, newFileName: string, branch: string, user: RuleUser, config?: RulesGitConfig): Promise<GitCommitHistory>;
+/**
+ * Supprime un fichier d'une branche Git (opération bas niveau)
+ * @param git Instance Git
+ * @param filePath Chemin du fichier à supprimer
+ * @param branch Nom de la branche où supprimer le fichier
+ * @param user Utilisateur qui effectue l'opération
+ * @param config Configuration Git (optionnel, utilise la config globale)
+ * @throws GitOperationError si la suppression échoue
+ */
+export declare function gitDeleteFile(git: SimpleGit, filePath: string, branch: string, user: RuleUser, config?: RulesGitConfig): Promise<GitCommitHistory>;
+/**
+ * Diagnostique l'état de santé d'une branche Git et détecte les problèmes bloquants.
+ *
+ * **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
+ * - ❌ **Merge en cours** : Opération de merge interrompue (fichiers .git/MERGE_HEAD présents)
+ * - ❌ **Fichiers en conflit** : Conflits de merge non résolus (status.conflicted)
+ * - ❌ **Index Git corrompu** : Index illisible ou corrompu (git status échoue)
+ * - ⚠️  **Fichiers modifiés** : Changements non commités dans le working directory
+ * - ⚠️  **Fichiers stagés** : Changements en attente de commit dans l'index
+ *
+ * **Méthode de diagnostic :**
+ * 1. Vérification de l'existence de la branche (git branch --list)
+ * 2. Test d'accessibilité (git checkout)
+ * 3. Analyse de l'état (git status)
+ * 4. Détection des merges en cours (fichiers .git/MERGE_*)
+ *
+ * @param git Instance SimpleGit configurée
+ * @param branch Nom de la branche à diagnostiquer (optionnel, utilise la branche courante si non spécifié)
+ * @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>;