> ## 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 vinculado, com verificações de compatibilidade, journals de checkpoint e fechamento e recuperação em dois slots baseada em evidências.

A gramática `qxctl knowledge reconcile ...` conduz a reconciliação de worktrees por meio de um único Knowledge Session Coordinator vinculado exato. Toda mutação é rastreada por identificador estável e é um compare-and-swap contra o digest exato do journal 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 as engines vinculadas concordam quanto à versão do protocolo e ao escopo.
* `begin`: abre um novo contexto de reconciliação com um identificador de operação estável.
* `status`: inspeciona o journal atual sem mutação.
* `checkpoint`: avança o journal de forma durável com compare-and-swap.
* `close`: finaliza o contexto de reconciliação.
* `recover --discover`: recuperação por descoberta quando o status comum não consegue validar o estado local.

## Regras de recuperação

> [!WARNING]
>
> A recuperação em dois slots é um reparo progressivo baseado em evidências. Ela nunca é uma permissão para descartar um journal incompatível ou uma extensão crítica desconhecida. Se a recuperação falhar, escale em vez de forçar.

Use a recuperação por descoberta somente quando o status comum não conseguir validar o estado local. Preserve os bloqueios; refaça o plano somente após mudanças em evidências verificadas.

## Superfícies relacionadas

> [card] [Coordenador de sessões](https://docs.quanux.org/symphony/pt-BR/engines/coordinator.md)
>
> A engine que é dona dos journals de reconciliação.

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

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


## Related topics

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


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