Corrija o registro; não acrescente uma contradição
Uma correção altera a memória existente por meio de PATCH /v1/memories/{memory_id}. MemoryUpdateRequest torna todos os campos opcionais e inclui content, path, metadata, source, provenance, memory_type, status, expires_at, scope e team_id. Assim, a correção permanece associada à mesma referência de memória e o servidor pode aplicar seu caminho de versionamento.
PATCH /v1/memories/<memory-id>
X-API-Key: <your-assigned-api-key>
Content-Type: application/json
{
"content": "The corrected deployment decision was verified on 2026-09-02.",
"provenance": {
"correction": "owner-confirmed"
},
"merge_provenance": true,
"detect_conflicts": true
}Versionamento e controles de conflito fazem parte da requisição
O contrato de atualização inclui merge_metadata, merge_provenance e detect_conflicts, todos com valor padrão true, além de supersession_reason. O caminho de persistência incrementa a versão da memória e mantém status/superseded_by/evidências de conflito no contrato público de memória; leia os dados de implementação retornados como resultado atual, enquanto a resposta OpenAPI continua sem tipagem.
- Mescle metadados e proveniência quando a correção deve manter as evidências existentes.
- Mantenha detect_conflicts habilitado quando edições concorrentes ou versões conflitantes forem relevantes.
- Use supersession_reason quando a correção substituir intencionalmente uma versão anterior.
Verifique o escopo corrigido
Depois de uma correção, faça uma leitura com escopo e examine os campos de versão, status, proveniência e conflito retornados. A recuperação continua seguindo o escopo autenticado e os filtros de status da memória; um PATCH bem-sucedido, por si só, não prova que o resultado no escopo desejado está visível.
GET /v1/memories/search?query=corrected%20deployment%20decision&scope=memory-os&status=active&limit=5
X-API-Key: <your-assigned-api-key>Fluxos de personas
Usuário do ChatGPT
Dê ao ChatGPT acesso duradouro às suas preferências do XMemo, fatos do projeto, decisões e TODOs sem colar tokens bearer no chat.
Salve uma preferência de teste ou anotação de projeto, inicie um novo chat e peça ao ChatGPT para recuperá-la via XMemo antes de prosseguir.
Desenvolvedor Copilot / Codex
Transfira decisões do repositório, convenções de código, notas de correção de bugs e histórico de tarefas entre agentes de IDE e CLI.
Registre uma decisão da base de código ou correção de bug e peça ao próximo agente de IDE ou CLI para recuperar o contexto relevante do XMemo antes de editar.
Líder de piloto de equipe / corporativo
Avalie a memória compartilhada com controles de conta, atribuição de origem, fluxos de exportação/exclusão e evidências de configuração seguras para revisores.
Peça para um membro do piloto salvar uma memória de equipe de teste, confirme a atribuição de origem no XMemo e revise os caminhos de exclusão/exportação e suporte.
Origem: API de memória