agentic-api 1.0.6 → 2.0.26

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

@@ -0,0 +1,134 @@
+import { SimpleGit } from 'simple-git';
+import { RulesGitConfig, PRMetadata, GitCommitHistory, GitFileSummary } from '../types';
+export declare function lock(key: string): Promise<void>;
+export declare function unlock(key: string): void;
+/**
+ * Configuration et initialisation du client Git
+ * @returns Configuration Git avec l'instance et les chemins
+ */
+export declare function gitLoad(defaultConfig?: RulesGitConfig): RulesGitConfig;
+/**
+ * Récupère la prévisualisation d'un fichier depuis Git (opération bas niveau atomique),
+ * sans les métadonnées.
+ * @param git Instance SimpleGit
+ * @param filename Nom du fichier
+ * @param branch Branche optionnelle (par défaut: rule-editor)
+ * @returns Contenu du fichier ou null si non trouvé
+ */
+export declare function gitGetFilePreview(git: SimpleGit, filename: string, branch?: string, fallback?: boolean): Promise<string | null>;
+/**
+ * Récupère le contenu d'un fichier depuis Git (opération bas niveau atomique),
+ * ainsi que les métadonnées du dernier commit qui a touché ce fichier dans la même branche.
+ * @param git Instance SimpleGit
+ * @param filename Chemin du fichier
+ * @param branch Branche optionnelle (par défaut: HEAD)
+ * @returns Contenu du fichier avec métadonnées ou null si non trouvé
+ */
+export declare function gitGetFileContent(git: SimpleGit, filename: string, branch?: string): Promise<GitCommitHistory | null>;
+/**
+ * FIXME:missing return type
+ * Lit le contenu d'un fichier depuis le système de fichiers (hors repo ou dans uploadPath)
+ * @param filePath Chemin du fichier
+ * @returns Contenu du fichier ou null si non trouvé
+ */
+export declare function gitReadFileOutsideRepo(git: SimpleGit, filePath: string): Promise<{
+    content: string;
+    date: Date;
+}>;
+export declare function gitGetFileHistory(git: SimpleGit, filename: string, hash?: string): Promise<GitCommitHistory[]>;
+/**
+ * Récupère le dernier commit d'une branche (opération bas niveau atomique)
+ * @param git Instance SimpleGit
+ * @param branch Nom de la branche
+ * @returns Dernier commit de la branche ou null si la branche n'existe pas
+ */
+export declare function gitLastCommit(git: SimpleGit, branch: string): Promise<GitCommitHistory | null>;
+/**
+ * Liste tous les fichiers d'un type donné dans une branche (opération bas niveau atomique)
+ * @param git Instance Git
+ * @param branch Nom de la branche à lister
+ * @param pattern Pattern de fichiers (ex:'.md')
+ * @returns Liste des chemins de fichiers
+ */
+export declare function gitListFilesInBranch(git: SimpleGit, branch: string, ext?: string): Promise<string[]>;
+export declare function gitListFilesOutsideRepo(git: SimpleGit, options?: {
+    ext?: string;
+}): Promise<{
+    file: string;
+    path: string;
+    date: Date;
+}[]>;
+/**
+ * Vérifie si un fichier existe dans une branche donnée et s'il est plus récent que la version dans main
+ * @param git Instance Git
+ * @param filePath Chemin du fichier
+ * @param branch Branche à vérifier
+ * @param config Configuration Git (optionnel, utilise la config globale)
+ * @returns true si le fichier existe et est plus récent que main
+ */
+export declare function gitFileExistsInBranch(git: SimpleGit, filePath: string, branch?: string, config?: RulesGitConfig): Promise<boolean>;
+/**
+ * Retourne la liste des branches non mergées contenant un fichier spécifique
+ * @param git Instance Git
+ * @param filePath Chemin du fichier
+ * @param targetBranch Branche cible (par défaut: main)
+ * @returns Liste des branches non mergées contenant le fichier
+ */
+export declare function gitGetUnmergedBranchesForFile(git: SimpleGit, filePath: string, targetBranch?: string): Promise<string[]>;
+/**
+ * Vérifie si la dernière version du fichier (sur sourceBranch) a été mergée dans targetBranch.
+ * - Recherche du dernier commit modifiant filePath sur sourceBranch
+ * - Test de l'ancêtre (merge-base --is-ancestor)
+ */
+export declare function gitIsFileMerged(git: SimpleGit, filePath: string, from: string, target?: string): Promise<boolean>;
+/**
+ * Récupère la liste de toutes les branches (opération bas niveau)
+ * @param git Instance Git
+ * @param options Options de filtrage des branches
+ * @returns Liste des noms de branches
+ */
+export declare function gitGetAllBranches(git: SimpleGit, options?: {
+    unmergedOnly?: boolean;
+    mainBranch?: string;
+}): Promise<string[]>;
+/**
+ * Récupère les fichiers modifiés entre deux branches (sans état)
+ * @param git Instance SimpleGit
+ * @param targetBranch Branche à comparer
+ * @param baseBranch Branche de base (par défaut: main)
+ * @param filter Filtre optionnel (ex: '.md')
+ * @returns Liste des fichiers modifiés
+ */
+export declare function gitGetDiffFiles(git: SimpleGit, targetBranch: string, baseBranch?: string, filter?: string): Promise<string[]>;
+/**
+ * Lit une note Git pour une branche donnée
+ * @param git Instance Git
+ * @param branchOrCommit Hash du commit ou nom de la branche
+ * @param namespace Namespace des notes
+ * @param maxCommits Nombre maximum de commits à examiner (défaut: 10)
+ * @returns Contenu de la note ou null si inexistante
+ */
+export declare function gitReadNote(git: SimpleGit, branchOrCommit: string, namespace: string, maxCommits?: number): Promise<PRMetadata | null>;
+/**
+ * Écrit une note Git pour une branche donnée
+ * @param git Instance Git
+ * @param commitHash Hash du commit
+ * @param author la note
+ * @param content Contenu de la note
+ * @param namespace Namespace des notes
+ */
+export declare function gitWriteNote(git: SimpleGit, commitHash: string, metadata: PRMetadata, namespace: string): Promise<void>;
+/**
+ * Modifie un fichier dans la branche draft (opération bas niveau)
+ * @param namespace Namespace des notes
+ */
+export declare function gitDeleteNote(git: SimpleGit, commitHash: string, namespace: string): Promise<void>;
+/**
+ * FIXME: GitFileSummary must be cached in memory (and refreshed on change)
+ * Retrieves a summary (content and last commit) for multiple files in a branch efficiently.
+ * It uses a single `git log` command for all files to improve performance.
+ * @param git SimpleGit instance
+ * @param branch The branch to inspect
+ * @returns An array of GitFileSummary objects.
+ */
+export declare function gitGetFilesSummary(git: SimpleGit, branch: string): Promise<GitFileSummary[]>;