> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quanux.org/symphony/llms.txt
> Use this file to discover all available pages before exploring further.

# qxctl knowledge reconcile: reconciliação de worktrees

> Reconcilie worktrees com um coordenador do Symphony associado, com verificações de compatibilidade, diários de checkpoint e fecho, e recuperação de duas posições baseada em evidência.

A gramática `qxctl knowledge reconcile ...` conduz a reconciliação de worktrees através de um único Knowledge Session Coordinator associado e exato. Cada mutação é rastreada por um identificador estável e é compare-and-swap contra o digest exato do diário atual.

## Comandos

```bash Reconcile grammar theme={null}
qxctl knowledge reconcile compatibility
qxctl knowledge reconcile begin      --operation-id OPID --expected-journal-digest absent|DIGEST ...
qxctl knowledge reconcile status
qxctl knowledge reconcile checkpoint --operation-id OPID --expected-journal-digest DIGEST
qxctl knowledge reconcile close      --operation-id OPID --expected-journal-digest DIGEST
qxctl knowledge reconcile recover    --discover
```

* `compatibility`: verifica se o qxctl, o coordenador e os engines associados concordam quanto à versão do protocolo e ao âmbito.
* `begin`: abre um novo contexto de reconciliação com um identificador de operação estável.
* `status`: inspeciona o diário atual sem mutação.
* `checkpoint`: faz avançar o diário de forma durável com compare-and-swap.
* `close`: finaliza o contexto de reconciliação.
* `recover --discover`: recuperação por descoberta quando o estado normal não consegue validar o estado local.

## Regras de recuperação

> [!WARNING]
>
> A recuperação de duas posições é uma reparação progressiva baseada em evidência. Nunca é uma permissão para descartar um diário incompatível ou uma extensão crítica desconhecida. Se a recuperação falhar, escale o problema em vez de forçar.

Utilize a recuperação por descoberta apenas quando o estado normal não consegue validar o estado local. Preserve os bloqueios; volte a planear apenas depois de a evidência verificada mudar.

## Superfícies relacionadas

> [card] [Coordenador de sessões](https://docs.quanux.org/symphony/pt/engines/coordinator.md)
>
> O engine responsável pelos diários de reconciliação.

> [card] [qxctl session](https://docs.quanux.org/symphony/pt/qxctl/session.md)
>
> Sessões autenticadas que se emparelham com contextos de reconciliação.

> [card] [qxctl engines](https://docs.quanux.org/symphony/pt/qxctl/engines.md)
>
> Gira as associações que o coordenador consome.


## Related topics

- [qxctl knowledge: administração do ciclo de vida entre vetores](https://docs.quanux.org/symphony/pt/qxctl/knowledge.md)
- [qxctl: linha de comandos administrativa agêntica do Symphony](https://docs.quanux.org/symphony/pt/qxctl/overview.md)
- [qxctl knowledge session: sessões autenticadas do Symphony](https://docs.quanux.org/symphony/pt/qxctl/session.md)
- [Coordenador de sessões de conhecimento para os motores de vetores do Symphony](https://docs.quanux.org/symphony/pt/engines/coordinator.md)
- [qxctl knowledge engines: associar, diagnosticar e migrar o registo](https://docs.quanux.org/symphony/pt/qxctl/engines.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.