qxctl knowledge reconcile: reconciliação de worktrees

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

Reconcile grammar

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

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

Coordenador de sessões

A engine que é dona dos journals de reconciliação.

qxctl session

Sessões autenticadas que se associam a contextos de reconciliação.

qxctl engines

Gerencie as vinculações que o coordenador consome.

Última modificação em 10 de outubro de 2026