Projetos

Espaços de trabalho de projeto no Memory Console

Os Project Workspaces fornecem limites contextuais estruturados para agrupar memórias, rastrear decisões operacionais e gerenciar tarefas ativas entre sessões de clientes. No Memory Console em https://xmemo.dev/me#projects, a seção de navegação de espaços de trabalho hospeda o painel Projects, projetado para "Browse project workspaces, context, and project memories."

• Métricas de espaço de trabalho: O console exibe estatísticas de nível superior em todos os seus espaços de trabalho, incluindo Total Projects, Active, Attention Needed e Archived.
• Provisionamento de espaço de trabalho: Selecionar Create New Project abre um modal guiado exigindo um Project Name ("Required, 1-128 characters."). A interface renderiza uma prévia em tempo real do identificador de projeto ("Non-authoritative preview. The backend server assigns the authoritative project key.") e aceita uma Description opcional de até 2000 caracteres.
• Limite pessoal: Os projetos são apenas pessoais hoje. O serviço de backend rejeita a criação de espaços de trabalho com team_id (HTTP 400). A documentação não faz promessas de projetos para equipes.
• Sem limites numéricos: Os espaços de trabalho de projeto não possuem cotas de plano numéricas nem limites artificiais de criação. As contas provisionam espaços de trabalho com base nas necessidades do fluxo de trabalho, e não em cotas de plano.

Associações de memória, estados de ciclo de vida e remoção não destrutiva

As memórias são atribuídas a um projeto para fornecer contexto delimitado para agentes conectados e revisão do painel. A visualização de detalhes do projeto agrega métricas de integridade do projeto e fornece inspeção granular dos registros vinculados:

• Estatísticas principais do projeto: A barra de destaque de cada espaço de trabalho exibe agregados em tempo real para Memories:, Open TODOs: e Decisions:.
• Filtragem por ciclo de vida da memória: O explorador de memória categoriza registros por status de ciclo de vida: Active, Superseded, Expired e Archived.
• Desassociação não destrutiva: Remover um registro de memória de um espaço de trabalho de projeto desvincula a associação sem destruir a memória subjacente. A caixa de diálogo de confirmação afirma: "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."
• Isolamento diagnóstico: Itens com referências canônicas ausentes ou conflitos de namespace são colocados em quarentena sob Diagnostic Isolated Items com o selo Unindexed - Troubleshooting Only, evitando que contexto corrompido vaze para o recall do agente.

Partições de Knowledge vs Working e exibição Attention Needed

Os espaços de trabalho de projeto suportam particionamento contextual de memória se habilitado para sua conta (o modo de avaliação de convergência fica desativado por padrão):

• Partição Knowledge: Mantém fatos de referência duradouros, decisões arquitetônicas de longo prazo e convenções de projeto destinadas a recall persistente.
• Partição de Working memory: Contém estado de tarefa transitório, sessões de trabalho em andamento e contexto de rascunho que podem ser descartados após a conclusão de marcos.
• Visualização Attention Needed: Destaca candidatos não atribuídos, duplicatas suspeitas ou registros com atribuição pendente quando a curadoria particionada estiver ativa para sua conta.
• Distinção das Knowledge Bases: Uma partição Knowledge de projeto categoriza a memória conversacional episódica dentro do limite de um projeto. Em contraste, uma Knowledge Base fornece documentos de referência com curadoria e múltiplas revisões gerenciados por meio de armazenamento independente. Para obter documentação com curadoria, consulte o guia de conceitos das Knowledge Bases em /docs/concepts/knowledge-bases.

Um projeto é um escopo mais uma convenção de caminhos

Para a delimitação básica da memória, o XMemo não requer um objeto de projeto separado: um projeto é expresso pelo escopo sob o qual uma memória é gravada e pelo namespace do caminho lógico dentro dele, de modo que a mesma conta pode comportar muitos projetos sem contaminação mútua. Sobre esse limite de memória, o Project Workspaces adiciona um estado estruturado do projeto (API do projeto, rastreamento de TODO e decisões registradas) para colaboração entre clientes.

• Escreva fatos do projeto em um caminho estável como projects/<name>/decisions.
• Transmita o escopo do projeto tanto na gravação quanto na leitura para manter a recuperação delimitada.
• O Project Workspaces adiciona uma camada de estado estruturado de projeto — incluindo APIs de projeto, TODOs duradouros e decisões registradas — sobre o limite de memória subjacente.
• Os projetos permanecem exclusivamente pessoais atualmente; espaços de trabalho de projeto no escopo de equipe são rejeitados pela API.

Grave uma decisão do projeto

Vincule o registro ao caminho e ao escopo do projeto no momento da gravação; nada mais precisa ser configurado antes.

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

Continue um projeto em outro cliente

Um segundo cliente recupera o mesmo escopo e obtém o contexto do projeto de volta sem que o usuário precise explicá-lo novamente.

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

Ferramentas de agente e acesso a perfis de cliente

Agentes autorizados interagem com projetos por meio de ferramentas definidas em config/mcp-documentation-contract.json em perfis de cliente específicos:

• chatgpt-public, generic-public e public-only: Expõem project, get_project_summary e open_project_workspace.
• claude-plugin: Expõe project e get_project_context.
• cursor-plugin e ordinary-full: Expõem get_project_context, update_project_todo e update_project_decision.
• Diferença do widget dentro do chat: O widget do ChatGPT Project Workspace aberto via open_project_workspace é uma interface de cartão interativa dentro do chat; ele é distinto do Memory Console completo baseado na web em https://xmemo.dev/me#projects.