agentic-api 2.0.684 → 2.0.885

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.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;
+exports.gitLoadPR = exports.gitGetClosedPRs = exports.gitGetAllPR = exports.gitGetPRMetadata = exports.gitIsPRClosedRobust = exports.gitIsPRClosed = exports.gitSyncPR = exports.gitIDRegistryRename = exports.gitIDRegistryExists = exports.gitEnsureMatterID = exports.gitRegisterExistingID = exports.gitReloadIDRegistry = exports.gitSetMatterCache = exports.gitGetMatterCache = exports.gitFileStrictMatter = exports.gitAllocateNextPRNumber = exports.gitGenerateNextID = exports.gitEditFile = exports.gitDeleteFile = exports.gitRenameFile = exports.gitUpdateMatter = 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 = exports.gitClosePRRobust = exports.gitClosePR = exports.gitPRUpdateComments = void 0;
 // === OPÉRATIONS GIT BAS NIVEAU ===
 // Fonctions atomiques pour manipuler Git directement
 var repo_tools_1 = require("./repo.tools");
@@ -54,21 +54,29 @@ Object.defineProperty(exports, "gitShowConfiguration", { enumerable: true, get:
 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; } });
+// Document mutations
 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, "gitUpdateMatter", { enumerable: true, get: function () { return repo_1.gitUpdateMatter; } });
 Object.defineProperty(exports, "gitRenameFile", { enumerable: true, get: function () { return repo_1.gitRenameFile; } });
 Object.defineProperty(exports, "gitDeleteFile", { enumerable: true, get: function () { return repo_1.gitDeleteFile; } });
+// deprecated: use gitCreateOrEditFile
+Object.defineProperty(exports, "gitEditFile", { enumerable: true, get: function () { return repo_1.gitEditFile; } });
 // 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; } });
+Object.defineProperty(exports, "gitFileStrictMatter", { enumerable: true, get: function () { return repo_1.gitFileStrictMatter; } });
+Object.defineProperty(exports, "gitGetMatterCache", { enumerable: true, get: function () { return repo_1.gitGetMatterCache; } });
+Object.defineProperty(exports, "gitSetMatterCache", { enumerable: true, get: function () { return repo_1.gitSetMatterCache; } });
+// deprecated / legacy registry helpers
 // deprecated: low-level test helper only
 Object.defineProperty(exports, "gitReloadIDRegistry", { enumerable: true, get: function () { return repo_1.gitReloadIDRegistry; } });
+// deprecated: prefer gitCreateOrEditFile / gitUpdateMatter / gitRenameFile
 Object.defineProperty(exports, "gitRegisterExistingID", { enumerable: true, get: function () { return repo_1.gitRegisterExistingID; } });
+// deprecated: prefer document mutation APIs instead of pre-mutating matter
 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; } });
+// deprecated: cache rename is handled by gitRenameFile
 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");

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

@@ -1,5 +1,5 @@
 import { SimpleGit } from 'simple-git';
-import { RulesGitConfig, GitCommitHistory, RuleUser, GitHealthStatus } from '../types';
+import { FrontMatter, RulesGitConfig, GitCommitHistory, RuleUser, GitHealthStatus } from '../types';
 /**
  * Structure du cache matter pour un fichier
  */
@@ -7,7 +7,10 @@ interface MatterStrict {
     id?: number;
     title?: string;
     service?: string;
-    oldfile?: string;
+}
+export interface GitDocumentMutationOptions {
+    config?: RulesGitConfig;
+    matter?: Partial<FrontMatter>;
 }
 /**
  * Vérifie si le fichier de registre d'IDs existe dans le repository Git
@@ -93,6 +96,9 @@ export declare function gitReloadIDRegistry(config?: RulesGitConfig): void;
 /**
  * Enregistre un ID existant dans le registre
  *
+ * @deprecated Préférer `gitCreateOrEditFile(...)`, `gitUpdateMatter(...)` ou
+ * `gitRenameFile(...)` qui synchronisent le registre dans le même flux documentaire.
+ *
  * @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é)
@@ -109,6 +115,8 @@ export declare function gitRegisterExistingID(matter: MatterStrict, branch?: str
 /**
  * Renomme un fichier dans le cache du registre d'IDs
  *
+ * @deprecated Le cache de matter/ID est maintenant mis à jour par `gitRenameFile(...)`.
+ *
  * Cette fonction met à jour le cache lorsqu'un fichier est renommé:
  * - Supprime l'entrée avec l'ancien nom
  * - Crée une nouvelle entrée avec le nouveau nom
@@ -126,6 +134,13 @@ export declare function gitRegisterExistingID(matter: MatterStrict, branch?: str
  * ```
  */
 export declare function gitIDRegistryRename(oldFile: string, newFile: string, branch: string, config?: RulesGitConfig): void;
+export declare function gitGetMatterCache(branch: string, id: number, config?: RulesGitConfig): {
+    id?: number;
+    file?: string;
+    title?: string;
+    service?: string;
+} | undefined;
+export declare function gitSetMatterCache(branch: string, file: string, matter: MatterStrict, config?: RulesGitConfig): void;
 /**
  * Valide et assure qu'un matter a un ID valide
  *
@@ -166,7 +181,6 @@ export declare function gitEnsureMatterID(matter: MatterStrict, config?: RulesGi
 export declare function gitFileStrictMatter(git: SimpleGit, filePath: string, branch: string, config?: RulesGitConfig): Promise<{
     id?: number;
     title?: string;
-    oldfile?: string;
 }>;
 /**
  * Vérifie et configure un repository Git existant pour s'assurer qu'il a la configuration requise
@@ -258,8 +272,13 @@ export declare function gitCreateOrEditFile(git: SimpleGit, filePath: string, PR
  * @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>;
+/**
+ * Met à jour le front-matter d'un document sans changer son nom de fichier.
+ *
+ * Cette API refuse explicitement toute mutation du `title` qui nécessiterait
+ * un changement de slug / filename. Dans ce cas, utiliser `gitRenameFile(...)`.
+ */
+export declare function gitUpdateMatter(git: SimpleGit, filePath: string, branch: string, user: RuleUser, options?: GitDocumentMutationOptions | RulesGitConfig): Promise<GitCommitHistory>;
 /**
  * Renomme un fichier de manière atomique (Git ou filesystem selon le contexte)
  * @param git Instance SimpleGit
@@ -270,7 +289,7 @@ export declare function gitRenameFile_fs(git: SimpleGit, oldFileName: string, ne
  * @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>;
+export declare function gitRenameFile(git: SimpleGit, oldFileName: string, newFileName: string, branch: string, user: RuleUser, options?: GitDocumentMutationOptions | RulesGitConfig, nextContent?: string): Promise<GitCommitHistory>;
 /**
  * Supprime un fichier d'une branche Git (opération bas niveau)
  * @param git Instance Git