Projets

Espaces de travail de projet dans la Memory Console

Les espaces de travail de projet (Project Workspaces) offrent des limites contextuelles structurées pour regrouper les souvenirs, suivre les décisions opérationnelles et gérer les tâches actives à travers les sessions clientes. Dans la Memory Console à l'adresse https://xmemo.dev/me#projects, la section de navigation des espaces de travail héberge le panneau Projects, conçu pour "Browse project workspaces, context, and project memories."

• Métriques de l'espace de travail : La console affiche des statistiques de premier niveau sur l'ensemble de vos espaces de travail, notamment Total Projects, Active, Attention Needed et Archived.
• Provisionnement d'espace de travail : Sélectionner Create New Project ouvre une fenêtre modale guidée nécessitant un Project Name ("Required, 1-128 characters."). L'interface affiche un aperçu en temps réel de l'identifiant de projet ("Non-authoritative preview. The backend server assigns the authoritative project key.") et accepte une Description facultative allant jusqu'à 2000 caractères.
• Périmètre personnel : Les projets sont uniquement personnels pour l'instant. Le service backend rejette la création d'espace de travail comportant un team_id (HTTP 400). La documentation ne formule aucun engagement relatif aux projets d'équipe.
• Aucune limite numérique : Les espaces de travail de projet ne comportent aucun quota de plan numérique ni plafond de création artificiel. Les comptes provisionnent les espaces de travail en fonction des besoins des flux de travail plutôt que des quotas de plan.

Associations de mémoire, états de cycle de vie et suppression non destructive

Les mémoires sont affectées à un projet afin de fournir un contexte délimité pour les agents connectés et l'examen sur le tableau de bord. La vue détaillée du projet regroupe les métriques d'intégrité du projet et permet une inspection fine des enregistrements liés :

• Statistiques principales du projet : La bannière principale de chaque espace de travail met en avant les agrégats en direct pour Memories:, Open TODOs: et Decisions:.
• Filtrage du cycle de vie de la mémoire : L'explorateur de mémoire classe les enregistrements par état de cycle de vie : Active, Superseded, Expired et Archived.
• Dissociation non destructive : La suppression d'un enregistrement de mémoire d'un espace de travail de projet dissocie l'association sans détruire la mémoire sous-jacente. La boîte de dialogue de confirmation affirme : "This memory will be disassociated from this project workspace. The memory content remains in your personal memory archive, but will no longer appear in this project context."
• Isolement de diagnostic : Les éléments présentant des références canoniques manquantes ou des conflits d'espace de noms sont placés en quarantaine sous Diagnostic Isolated Items avec le badge Unindexed - Troubleshooting Only, empêchant ainsi le contexte corrompu de fuiter dans le recall de l'agent.

Partitions Knowledge vs Working et vue Attention Needed

Les espaces de travail de projet prennent en charge le partitionnement contextuel de la mémoire s'il est activé pour votre compte (le mode d'évaluation de convergence est désactivé par défaut) :

• Partition Knowledge : Conserve les faits de référence durables, les décisions architecturales à long terme et les conventions de projet destinées à un rappel persistant.
• Partition de mémoire de travail (Working memory) : Contient l'état temporaire des tâches, les sessions de travail en cours et le contexte de bloc-notes qui peuvent être retirés une fois le jalon franchi.
• Vue Attention Needed : Met en évidence les candidats non assignés, les doublons présumés ou les enregistrements en attente d'attribution lorsque la curation partitionnée est active pour votre compte.
• Distinction par rapport aux bases de connaissances : Une partition Knowledge de projet catégorise la mémoire conversationnelle épisodique au sein du périmètre d'un projet. En revanche, une base de connaissances fournit des documents de référence organisés et multi-révisions gérés via un stockage indépendant. Pour la documentation organisée, consultez le guide conceptuel des bases de connaissances sur /docs/concepts/knowledge-bases.

Un projet est l'association d'un périmètre et d'une convention de chemin

Pour le découpage de mémoire de base, XMemo ne requiert pas d'objet projet distinct : un projet s'exprime par le périmètre (scope) sous lequel une mémoire est enregistrée et l'espace de noms de chemin logique au sein de celui-ci, ce qui permet à un même compte de porter de nombreux projets sans interférence mutuelle. Au-dessus de cette frontière de mémoire, Project Workspaces superpose un état de projet structuré (API de projet, suivi des tâches TODO et décisions consignées) pour la collaboration multi-clients.

• Consignez les faits de projet sous un chemin stable tel que projects/<name>/decisions.
• Transmettez le périmètre du projet à la fois lors de l'écriture et de la lecture afin que la récupération reste bornée.
• Project Workspaces superpose un état de projet structuré — comprenant les API de projet, les tâches TODO durables et les décisions consignées — au-dessus de la frontière de mémoire sous-jacente.
• Les projets restent aujourd'hui strictement personnels ; les espaces de travail de projet associés à une équipe sont rejetés par l'API.

Consigner une décision de projet

Associez l'enregistrement au chemin et au périmètre du projet au moment de l'écriture ; aucune configuration préalable supplémentaire n'est requise.

await client.recordDecision(
  "Remote agents should use network MCP, not SSH stdio",
  { source: "codex", scope: "memory-os" },
);

Poursuivre un projet dans un autre client

Un deuxième client effectue un rappel sur le même périmètre et récupère le contexte du projet sans que l'utilisateur n'ait à le réexpliquer.

const context = await client.recallContext("recent agent integration progress", {
  scope: "memory-os",
  maxItems: 6,
  maxTokens: 1200,
});

Outils d'agent et accès au profil client

Les agents autorisés interagissent avec les projets via des outils définis dans config/mcp-documentation-contract.json à travers des profils clients spécifiques :

• chatgpt-public, generic-public et public-only : Exposent project, get_project_summary et open_project_workspace.
• claude-plugin : Expose project et get_project_context.
• cursor-plugin et ordinary-full : Exposent get_project_context, update_project_todo et update_project_decision.
• Distinction du widget dans le chat : Le widget ChatGPT Project Workspace ouvert via open_project_workspace est une interface de carte interactive intégrée au chat ; il est distinct de la Memory Console web complète accessible sur https://xmemo.dev/me#projects.