> Source: https://clickhouse.github.io/loom/ko/reference/operations/conflicts/ (Markdown: https://clickhouse.github.io/loom/ko/reference/operations/conflicts.md)

<!-- i18n: source=docs/reference/operations/conflicts.md blob=25d369595f64dda74c9f2e7964c2658047ae2f9f model=claude-sonnet-5-5 -->
> 이 페이지는 [영어 원문](https://clickhouse.github.io/loom/reference/operations/conflicts/)을 기계 번역한 것이며, 영어 원문이 기준입니다.
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/conflicts/), which is authoritative.

<a id="conflicts-operations"></a>

# `conflicts` 연산

각 `conflicts.*` 연산이 받고 반환하는 정확한 필드입니다.

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

모든 op는 HTTP의 `POST /v1/<op>`이자 MCP 도구 `loom_<op>`입니다. 신원 필드(`org`, `namespace`, `agent`, `user_id`, `session_id`)는 전송 방식이 지원하면 토큰과 MCP 세션에서 채워집니다. 단일 사용자 서버에서 토큰 없이 HTTP로 호출하면, `code.*`와 `tracker.*`(각 플레인의 값을 유지함)를 제외한 모든 op에서 설치의 org가 채워지고, [일부 op](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request)에서는 네임스페이스와 에이전트도 채워집니다. 자세한 내용은 [신원과 네임스페이스](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md)를 참고하세요. [연산 색인](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md)에서 role, kind, MCP `all` 목록을 설명합니다. 알 수 없는 입력 필드는 그대로 처리되며 `ignored_args`에 이름이 표시됩니다.

<!-- prettier-ignore-start -->

<a id="conflictsallowlist_list"></a>

## `conflicts.allowlist_list`

충돌하지 않는 것으로 알려져 표시된 (memory_key, memory_key) 쌍을 나열하여, conflicts 워커가 더 이상 이를 충돌로 표시하지 않도록 합니다.

`POST /v1/conflicts.allowlist_list` · MCP `loom_conflicts_allowlist_list` · role `viewer` · read · MCP `all` 도구 세트에는 없음

| 입력 필드 | 타입 | 기본값 | 의미 |
| --- | --- | --- | --- |
| `org` | `str` | 필수 | 테넌트(신원 튜플의 첫 번째 요소). |
| `namespace` | `str` | 필수 | 이 op가 읽거나 쓰는 네임스페이스. |
| `limit` | `int` | `100` | 최대 이 개수만큼의 쌍, 1-1000, 최신순. |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `rows` | `list[_AllowlistRow]` | 유효한 허용 키 쌍(`memory_key_a`가 `memory_key_b`보다 앞에 정렬됨), 최신순. |

<a id="conflictsallowlist_remove"></a>

## `conflicts.allowlist_remove`

허용 결정을 취소합니다. 이후 쓰기에서 해당 쌍은 다시 충돌로 표시됩니다.

`POST /v1/conflicts.allowlist_remove` · MCP `loom_conflicts_allowlist_remove` · role `admin` · idempotent · audited · MCP `all` 도구 세트에는 없음

| 입력 필드 | 타입 | 기본값 | 의미 |
| --- | --- | --- | --- |
| `org` | `str` | 필수 | 테넌트(신원 튜플의 첫 번째 요소). |
| `namespace` | `str` | 필수 | 이 op가 읽거나 쓰는 네임스페이스. |
| `memory_key_a` | `str` | 필수 | 허용된 쌍의 한 키. 두 키의 순서는 상관없습니다. |
| `memory_key_b` | `str` | 필수 | 쌍의 다른 키. |
| `removed_by` | `str` | `''` | 취소한 주체. `reason`과 함께 해당 쌍의 저장된 사유에 덧붙여집니다. |
| `reason` | `str` | `''` | 사유. 해당 쌍의 저장된 사유에 덧붙여집니다. |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `removed` | `bool` | 일치하는 유효한 허용 쌍이 없으면 False. |

<a id="conflictslist"></a>

## `conflicts.list`

두 메모리가 서로 모순되는, 해결되지 않은 충돌을 나열합니다.

`POST /v1/conflicts.list` · MCP `loom_conflicts_list` · role `viewer` · read · MCP `all` 도구 세트에는 없음

| 입력 필드 | 타입 | 기본값 | 의미 |
| --- | --- | --- | --- |
| `org` | `str` | 필수 | 테넌트(신원 튜플의 첫 번째 요소). |
| `namespace` | `str` | 필수 | 이 op가 읽거나 쓰는 네임스페이스. |
| `limit` | `int` | `50` | 최대 이 개수만큼의 행, 1-500, 최신 버전순. |
| `before_version` | `int \| None` | `None` | 키셋 커서. 페이지를 넘기려면 이전 응답의 가장 이른 버전을 전달하세요. |
| `count_only` | `bool` | `False` | 배지에는 행이 아닌 숫자만 필요합니다. |
| `fresh` | `bool` | `False` | count_only와 함께 사용하면 1분간 유지되는 캐시를 읽는 대신 지금 집계합니다. 기본값은 꺼짐. |
| `keys_only` | `bool` | `False` | Memories 보기는 충돌이 있는 카드를 표시하는 데 키만 필요합니다. |
| `fields` | `list[str] \| None` | `None` | 호출자가 읽는 출력 필드(행 모델에 대해 확인되는 허용 목록이며, 알 수 없는 이름은 422). 설정하지 않으면 모든 필드. |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `rows` | `list[_ConflictRow]` | 충돌한 메모리, 최신 버전순. `count_only` 또는 `keys_only` 호출에서는 비어 있습니다. |
| `next_before_version` | `int \| None` | 다음 페이지를 위해 `before_version`으로 전달합니다. 마지막 페이지에서는 null. |
| `total` | `int \| None` | 네임스페이스의 현재 충돌 메모리 수. count_only 호출에서 설정됩니다. |
| `keys` | `list[str] \| None` | 네임스페이스의 충돌한 메모리 키. keys_only 호출에서 설정됩니다. |

<a id="conflictspropose_revision"></a>

## `conflicts.propose_revision`

파괴적이지 않은 revise/contract/allow 제안을 반환합니다.

`POST /v1/conflicts.propose_revision` · MCP `loom_conflicts_propose_revision` · role `viewer` · read · MCP `all` 도구 세트에는 없음

| 입력 필드 | 타입 | 기본값 | 의미 |
| --- | --- | --- | --- |
| `org` | `str` | 필수 | 테넌트(신원 튜플의 첫 번째 요소). |
| `namespace` | `str` | 필수 | 이 op가 읽거나 쓰는 네임스페이스. |
| `memory_id` | `str` | 필수 | 조언 대상인 충돌한 메모리(org 전체 범위의 id). |
| `peer_id` | `str \| None` | `None` | 조언을 `conflict_with`의 이 피어 하나로 제한합니다. None이면 모든 피어를 고려합니다. |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `found` | `bool` | 메모리 또는 그것이 가리키는 모든 행이 `namespace`에서 유효하지 않으면 False. |
| `memories` | `list[_ConflictCandidateMemory]` | 대상이 먼저(`local_id` 1), 그다음 유효한 피어가 최신순으로 옵니다. |
| `suggestions` | `list[_ConflictRevisionSuggestion]` | 로컬 id로 지정된 `conflicts.resolve` 제안 최대 하나. 대상이 고정되어 있거나 피어와 키를 공유하면 revise, 피어가 고정되어 있으면 contract, 그 외에는 allow. |
| `note` | `str` | 아무것도 적용되지 않았음을 항상 알립니다. 이 연산은 조언만 합니다. |

<a id="conflictsresolve"></a>

## `conflicts.resolve`

충돌의 승자를 선택합니다(A 유지, B 유지, 둘 다 유지, 병합).

`POST /v1/conflicts.resolve` · MCP `loom_conflicts_resolve` · role `admin` · idempotent · audited · MCP `all` 도구 세트에는 없음

| 입력 필드 | 타입 | 기본값 | 의미 |
| --- | --- | --- | --- |
| `org` | `str` | 필수 | 테넌트(신원 튜플의 첫 번째 요소). |
| `namespace` | `str` | 필수 | 이 op가 읽거나 쓰는 네임스페이스. |
| `memory_id` | `str` | 필수 | 결정 대상인 충돌한 메모리(org 전체 범위의 id). `namespace`에 있어야 합니다. |
| `decision` | `Literal['revise', 'contract', 'allow']` | 필수 | `revise`는 해당 메모리를 유지하고 피어를 툼스톤 처리합니다. `contract`는 해당 메모리를 툼스톤 처리하고 피어를 다시 활성화합니다. `allow`는 모두 다시 활성화하고 각 키 쌍을 허용 목록에 추가합니다. |
| `peer_id` | `str \| None` | `None` | 선택 사항: 해결 범위를 특정 피어 하나로 한정합니다(그 피어에 대해서만 revise). |
| `reason` | `str` | `''` | 사유. 툼스톤 처리된 행의 `source_trace`에 덧붙여지고 허용 목록 행에 저장됩니다(처음 512자). |
| `resolved_by` | `str` | `''` | 해결한 주체. `reason`과 함께 기록됩니다(처음 128자). 토큰과 대조하여 확인하지 않습니다. |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `resolved` | `bool` | 메모리 또는 지정한 피어를 알 수 없거나 메모리가 `namespace`에 없으면 False. 이 경우 아무것도 기록되지 않습니다. |
| `decision` | `Literal['revise', 'contract', 'allow']` | 전달된 결정을 그대로 반환합니다. |
| `affected_memory_ids` | `list[str]` | 이 호출이 툼스톤 처리했거나 다시 활성화한 모든 메모리 id. |
| `resolved_at` | `datetime \| None` | 해결이 실행된 시각(UTC). 아무것도 해결되지 않았으면 null. |
| `total` | `int \| None` | 쓰기 이후에 집계한, 호출자의 읽기 범위에서의 네임스페이스 충돌 수. 아무것도 해결되지 않았거나 집계에 실패하면 null. |

<!-- prettier-ignore-end -->
