> ## 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: Worktree Reconciliation

> Reconcile worktrees against a bound Symphony coordinator with compatibility checks, checkpoint and close journals, and evidence-based two-slot recovery.

The `qxctl knowledge reconcile ...` grammar drives worktree reconciliation through one exact bound Knowledge Session Coordinator. Every mutation is stable-identifier tracked and compare-and-swap against the exact current journal digest.

## Commands

```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`: verify that qxctl, the coordinator, and the bound engines agree on protocol version and scope.
* `begin`: open a new reconciliation context with a stable operation identifier.
* `status`: inspect the current journal without mutation.
* `checkpoint`: durably advance the journal with compare-and-swap.
* `close`: finalize the reconciliation context.
* `recover --discover`: discovery recovery when ordinary status cannot validate local state.

## Recovery rules

<Warning>
  Two-slot recovery is evidence-based forward repair. It is never permission to discard an incompatible journal or an unknown critical extension. If recovery fails, escalate rather than force.
</Warning>

Use discovery recovery only when ordinary status cannot validate local state. Preserve blockers; replan only after verified evidence changes.

## Related surfaces

<CardGroup cols={2}>
  <Card title="Session coordinator" icon="gears" href="/symphony/symphony/engines/coordinator">
    The engine that owns reconciliation journals.
  </Card>

  <Card title="qxctl session" icon="key" href="/symphony/symphony/qxctl/session">
    Authenticated sessions that pair with reconciliation contexts.
  </Card>

  <Card title="qxctl engines" icon="cube" href="/symphony/symphony/qxctl/engines">
    Manage the bindings the coordinator consumes.
  </Card>
</CardGroup>


## Related topics

- [qxctl knowledge: Cross-Vector Lifecycle Administration](/symphony/symphony/qxctl/knowledge.md)
- [Knowledge Session Coordinator for Symphony Vector Engines](/symphony/symphony/engines/coordinator.md)
- [qxctl: Symphony Agentic Administrative Command Line](/symphony/symphony/qxctl/overview.md)
- [qxctl knowledge session: Authenticated Symphony Sessions](/symphony/symphony/qxctl/session.md)
- [Maestro: Symphony Vector-Engine Presence Authority](/symphony/symphony/governance/maestro.md)