> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# nora clause-lineage

> Foundry 가 제안한 조항 개정 이력을 승인·정정·거절합니다

Foundry 의 [Output · Clause lineage](/ko/build/foundry/output#clause-lineage) 싱크는 이번에 처리한 문서의 조항을 직전 버전과 비교해 **개정 이력** 을 제안합니다. 그대로 이어짐, 개정, 신설, 삭제 네 갈래로요. 사람이 확인해야 확정되고, `nora clause-lineage` 가 그 확인을 터미널에서 하는 표면입니다.

과정은 처음부터 끝까지 비파괴적입니다. 문서 텍스트는 손대지 않고, 조항 버전 사이의 관계 라벨(계보) 만 승인·정정·거절합니다.

## 명령 그룹

* **훑기**: `pending`, `by-block`, `by-document`, `pending-documents`
* **결정**: `review`, `reject`, `bulk-approve`

## 대기 제안 훑기

### `pending`

```bash theme={null}
nora clause-lineage pending --limit 100
```

워크스페이스의 모든 파이프라인·문서에 걸친 미검수 제안. `--limit` 이 행을 자릅니다(기본 500).

### `by-block`

```bash theme={null}
nora clause-lineage by-block \
  --pipeline-id p_insurance \
  --block-id n_lineage \
  --include-reviewed
```

한 `out_clause_lineage` 블록이 낸 제안 전부. `--include-reviewed` 를 붙이면 기본값(대기만) 을 뒤집어 이미 결정된 행까지 함께 봅니다.

### `by-document`

```bash theme={null}
# 전체 이력 (기본)
nora clause-lineage by-document doc_policy_v2

# 대기만
nora clause-lineage by-document doc_policy_v2 --pending-only
```

한 문서의 개정 이력. 이 버전과 직전 버전 사이의 모든 제안 관계와 대기 항목.

### `pending-documents`

```bash theme={null}
nora clause-lineage pending-documents
```

문서별 롤업. 아직 대기 있는 문서 하나당 한 줄, 대기 개수와 함께. 어느 문서부터 검수할지 우선순위 잡기에 좋습니다.

## 결정

### `review`

```bash theme={null}
# 제안된 관계로 확정
nora clause-lineage review lin_abc123 --relation carried_over

# 정정: 모델은 신설이라 했지만 사람이 보기엔 개정
nora clause-lineage review lin_abc123 --relation amended
```

한 제안을 확정하거나 다른 관계로 덮어씁니다. `--relation` 값: `carried_over` · `amended` · `new` · `removed`.

### `reject`

```bash theme={null}
nora clause-lineage reject lin_abc123
```

계보 행 자체를 지웁니다. 제안이 승인도 검수도 되지 않은 상태로 사라집니다. 모델이 원래 짝이 될 수 없는 조항을 짝지은 경우에 씁니다.

### `bulk-approve`

```bash theme={null}
nora clause-lineage bulk-approve --ids lin_a,lin_b,lin_c
```

나열한 모든 행을 **제안된 관계 그대로** 승인합니다. 관계 오버라이드 없이 스탬프만 찍는 셈이라, 모델의 제안이 대부분 옳은 고신뢰 배치에 씁니다.

## 레시피

### 우선순위: 대기 가장 많은 문서부터

```bash theme={null}
next=$(nora clause-lineage pending-documents --json | jq -r 'sort_by(-.pending_count) | .[0].document_id')
nora clause-lineage by-document $next --pending-only
```

### 특정 블록이 낸 제안 전부 자동 승인

```bash theme={null}
ids=$(nora clause-lineage by-block --pipeline-id p_ins --block-id n_lineage --json | jq -r '.[].id' | paste -sd,)
nora clause-lineage bulk-approve --ids "$ids"
```

그 블록의 제안이 지난 이력에서 늘 옳았던 경우에만 쓰세요. bulk-approve 는 파이프라인을 다시 돌리지 않는 한 되돌릴 수 없습니다.

### 대기 큐를 스프레드시트로 뽑기

```bash theme={null}
nora clause-lineage pending --json > pending.json
# pending.json 을 엑셀·시트로 열어 오프라인 검수.
```

## 관련

* [Foundry · Output · Clause lineage](/ko/build/foundry/output#clause-lineage): 제안이 만들어지는 자리.
* [리트리벌 · 시점 인지 검색](/ko/build/retrieval/overview): 승인된 계보가 `as_of` 검색(G1\~G4) 에 어떻게 쓰이는지.