Aller au contenu principal
Version: Future

Flux de travail en équipe avec Git

Git transporte la mémoire d'une machine à l'autre et fournit un historique des révisions. Engram is natif de Git : la mémoire est stockée en Markdown brut, ce qui permet d'appliquer le flux de travail Git habituel.

Mémoire de l'espace de travail en tant que sous-module​

Si l'utilisateur souhaite que le répertoire .agents/.engram soit suivi comme un dépôt distinct :

engram inject --submodule
engram inject --submodule-remote <git-url>

Engram valide l'URL, initialise le sous-module sur la branche main et effectue le premier commit du sous-module intitulé Initialize engram.

Dépôt Git global partagé (Git origin)​

Si la commande engram entry n'affiche aucune valeur pour global_git_detected.remote_url, demandez à l'utilisateur si la mémoire globale doit être partagée via Git. Lorsqu'il fournit une URL :

engram inject --global-remote <git-url>

Configurez le comportement de synchronisation avec les champs global_git.* :

  • global_git.enabled — active le comportement Git pour la mémoire globale
  • global_git.remote — nom du dépôt distant (par défaut origin)
  • global_git.remote_url — URL du dépôt distant de la mémoire globale partagée
  • global_git.branch — branche cible (par défaut main)
  • global_git.auto_sync — comportement de pull/push automatique
  • global_git.auto_resolve — gestion automatique des conflits
attention

La gestion automatique des conflits peut masquer les différences (diffs) de mémoire. Vérifiez les diffs avant de vous fier à global_git.auto_resolve.

Flux de travail de révision​

  1. L'agent propose des candidats de mémoire.
  2. L'humain approuve via l'étape de validation A/B/C (terminal) or yes/audit/cancel (chat).
  3. Engram écrit le fichier Markdown approuvé et régénère les hachages, l'index, le graphe et le journal des modifications.
  4. Commitez et poussez (push) les modifications de la mémoire via Git.
  5. Les collaborateurs récupèrent (pull) les modifications et exécutent engram upgrade pour synchroniser.

Étapes suivantes​

Identité d’auteur Git​

Engram peut stocker un auteur global et une surcharge d’espace de travail facultative. La résolution suit l’ordre workspace, global, puis repli Git en lecture seule. Les paramètres n’affectent que les mémoires futures ; une surcharge d’espace de travail ne modifie jamais la configuration Git globale. Utilisez un plan explicite et une confirmation pour la synchronisation Git globale ou la migration des anciennes mémoires.

engram author show
engram author set --name "Jane Doe" --email "jane@example.com"
engram author unset --scope workspace
engram author sync-git-global --plan
engram author sync-git-global --confirm
engram author migrate-memories --plan
engram author migrate-memories --confirm

Lisez le guide complet des paramètres de l’auteur Git.