> ## 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: 워크트리 조정

> 호환성 검사, 체크포인트 및 종료 저널, 증거 기반 2슬롯 복구를 사용하여 바인딩된 Symphony 코디네이터에 대해 워크트리를 조정합니다.

`qxctl knowledge reconcile ...` 문법은 정확히 하나의 바인딩된 Knowledge Session Coordinator를 통해 워크트리 조정을 수행합니다. 모든 변경은 안정적인 식별자로 추적되며 정확한 현재 저널 다이제스트에 대한 compare-and-swap으로 수행됩니다.

## 명령

```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`: qxctl, 코디네이터, 바인딩된 엔진이 프로토콜 버전과 범위에 대해 일치하는지 확인합니다.
* `begin`: 안정적인 작업 식별자로 새 조정 컨텍스트를 엽니다.
* `status`: 변경 없이 현재 저널을 검사합니다.
* `checkpoint`: compare-and-swap으로 저널을 영구적으로 진행시킵니다.
* `close`: 조정 컨텍스트를 마무리합니다.
* `recover --discover`: 일반 status로 로컬 상태를 검증할 수 없을 때의 탐색 복구입니다.

## 복구 규칙

> [!WARNING]
>
> 2슬롯 복구는 증거 기반의 전진 복구입니다. 호환되지 않는 저널이나 알 수 없는 중요 확장을 폐기해도 된다는 허가가 절대 아닙니다. 복구가 실패하면 강제로 진행하지 말고 상위로 에스컬레이션하세요.

일반 status로 로컬 상태를 검증할 수 없을 때만 탐색 복구를 사용하세요. 차단 조건을 보존하고, 검증된 증거가 변경된 후에만 다시 계획하세요.

## 관련 항목

> [card] [세션 코디네이터](https://docs.quanux.org/symphony/ko/engines/coordinator.md)
>
> 조정 저널을 소유하는 엔진입니다.

> [card] [qxctl session](https://docs.quanux.org/symphony/ko/qxctl/session.md)
>
> 조정 컨텍스트와 짝을 이루는 인증된 세션입니다.

> [card] [qxctl engines](https://docs.quanux.org/symphony/ko/qxctl/engines.md)
>
> 코디네이터가 사용하는 바인딩을 관리합니다.


## Related topics

- [qxctl knowledge: 교차 벡터 수명 주기 관리](https://docs.quanux.org/symphony/ko/qxctl/knowledge.md)
- [qxctl: Symphony 에이전트형 관리 명령줄](https://docs.quanux.org/symphony/ko/qxctl/overview.md)
- [Symphony Vector 엔진을 위한 지식 세션 코디네이터](https://docs.quanux.org/symphony/ko/engines/coordinator.md)
- [qxctl knowledge engines: 바인딩, 진단, 레지스트리 마이그레이션](https://docs.quanux.org/symphony/ko/qxctl/engines.md)
- [qxctl knowledge session: 인증된 Symphony 세션](https://docs.quanux.org/symphony/ko/qxctl/session.md)


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