nora causal

Nora의 인과 그래프는 폴더별. 문서 폴더에 그래프를 붙이고, 그 문서에서 인과 트리플을 staged 영역으로 추출한 뒤, live로 승인. causal CLI가 staged/live 워크플로우 표면. 그래프를 문서에서 띄우고, 좋은 트리플을 승인하고, 승인된(라이브) 것만 검증과 추론에 씀.

명령

명령	설명
`causal get <folder>`	폴더의 전체 그래프 가져오기(LIVE + STAGED).
`causal settings show <folder>`	폴더 그래프 설정 + 스테이지 통계 출력.
`causal settings set <folder>`	그래프 설정 업데이트.
`causal bootstrap <folder>`	인과 트리플을 STAGED로 추출.
`causal refresh <folder>`	델타를 STAGED로 다시 계산.
`causal approve <folder>`	STAGED 줄을 LIVE로 올림.
`causal reject <folder>`	STAGED 줄을 안 올리고 버림.

폴더 식별자가 문서 폴더 태그(예: billing, product-docs).

`causal get`

nora causal get billing

전체 그래프 출력:

live_nodes와 live_edges 검증과 추론에 쓰임.
staged_nodes와 staged_edges 리뷰 대기.

구조화 출력은 --json을 붙임. 흔한 빠른 점검:

nora causal get billing --json | jq '{live: .live_nodes | length, staged: .staged_nodes | length}'

`causal settings show` / `set`

nora causal settings show billing

설정 + 스테이지 수를 표시.

nora causal settings set billing \
  --connection documents_folder:billing \
  --retrieval-preset high-precision \
  --dedup-policy merge \
  --auto-restage true

넘긴 플래그만 바뀜.

--connection <kind:id> 그래프를 특정 데이터 소스에 잇기(예: documents_folder:billing).
--retrieval-preset <preset-id> 추출이 컨텍스트를 끌어올 때 쓰는 프리셋.
--dedup-policy <policy> 중복 처리 방식(merge, keep_newer, keep_older, keep_all).
--auto-restage true|false 연결된 소스가 바뀌면 자동으로 다시 부트스트랩.

`causal bootstrap`

nora causal bootstrap billing --model gpt-4o

폴더의 모든 문서에서 인과 트리플을 STAGED로 추출. approve 할 때까지 LIVE 로는 아무것도 안 감.

--model <m> 추출에 쓰는 모델. 워크스페이스 기본이 기본.

부트스트랩은 멱등. 이미 채워진 폴더에 다시 돌려도 LIVE 데이터를 안 잃음. 재추출이 새 STAGED 줄을 만들고 기존 LIVE는 그대로. 새 폴더: bootstrap → 앱에서 STAGED 영역 리뷰 → 좋은 것 승인. 기존 폴더: refresh가 대개 원하는 것.

`causal refresh`

nora causal refresh billing

델타만 다시 계산. 마지막 부트스트랩 이후 더해진 새 문서, 바뀐 기존 문서. 전체 부트스트랩보다 쌈. Refresh 출력이 STAGED에 쌓임. 기존 LIVE는 그대로. --auto-restage가 안 맞으면 스케줄로(또는 문서 변경으로 걸어) 돌림.

`causal approve` / `reject`

# 모든 STAGED 줄 승인
nora causal approve billing

# 특정 줄만 승인
nora causal approve billing --ids node_1,edge_a,node_5

# 나머지 거부
nora causal reject billing

--ids <id,…> 특정 스테이지 줄 ID. 생략하면 모든 STAGED에 적용.

approve 뒤:

줄이 LIVE로 이동.
검증이 바로 그것들을 쓰기 시작.
STAGED에는 이 명령이 안 건드린 것이 여전히 남음.

reject가 안 올리고 줄을 버림. 다음 부트스트랩이나 refresh로 다시 만들 수 있음.

레시피

CLI로 폴더를 처음부터 끝까지 부트스트랩

folder="billing"

# 1. 설정
nora causal settings set $folder \
  --connection documents_folder:$folder \
  --retrieval-preset high-precision \
  --auto-restage true

# 2. STAGED로 추출
nora causal bootstrap $folder

# 3. 리뷰 (보통 앱에서), 그 뒤 스테이지된 것 한꺼번에 승인
nora causal approve $folder

# 4. 쿼리가 그래프를 쓰는지 확인
nora retrieval search "some question" --filters '{"tag":"'$folder'"}' --include-subgraph

CI: STAGED가 너무 크면 실패

무제한 백로그를 막음:

threshold=200
staged=$(nora causal get billing --json | jq '.staged_nodes | length')
if [ "$staged" -gt "$threshold" ]; then
  echo "STAGED 백로그가 너무 큼 ($staged > $threshold). 리뷰 필요."
  exit 1
fi

사람 리뷰 뒤 골라 승인

리뷰 흐름이 외부 시스템에서 줄 ID로 승인 표시한다고 하면, 한꺼번에 승인:

ids=$(cat approved-ids.txt | tr '\n' ',' | sed 's/,$//')
nora causal approve billing --ids "$ids"

감사용 LIVE 그래프 스냅샷

nora causal get billing --json | jq '{live_nodes, live_edges}' > audit/billing-graph-$(date +%Y%m%d).json

STAGED / LIVE 모델

인과 추출이 최선을 다하는 것이라 스테이지가 둘. 모델이 제안하고 여러분이 처리. LIVE 직접 편집은 CLI에서 안 됨(그건 앱의 그래프 캔버스를 씀). 다만 한꺼번에 승인/거부가 CLI가 맡는 일. 라이브 그래프를 손으로 고치고 싶으면(특정 엣지 추가, 잘못된 노드 제거) 앱에서. CLI의 역할은 대량 부트스트랩/refresh/승인.

시작

플로우

블록

데이터·지식

신뢰성

워크스페이스

레퍼런스

nora causal

명령

`causal get`

`causal settings show` / `set`

`causal bootstrap`

`causal refresh`

`causal approve` / `reject`

레시피

CLI로 폴더를 처음부터 끝까지 부트스트랩

CI: STAGED가 너무 크면 실패

사람 리뷰 뒤 골라 승인

감사용 LIVE 그래프 스냅샷

STAGED / LIVE 모델

관련

​명령

​causal get

​causal settings show / set

​causal bootstrap

​causal refresh

​causal approve / reject

​레시피

​CLI로 폴더를 처음부터 끝까지 부트스트랩

​CI: STAGED가 너무 크면 실패

​사람 리뷰 뒤 골라 승인

​감사용 LIVE 그래프 스냅샷

​STAGED / LIVE 모델

​관련

명령

`causal get`

`causal settings show` / `set`

`causal bootstrap`

`causal refresh`

`causal approve` / `reject`

레시피

CLI로 폴더를 처음부터 끝까지 부트스트랩

CI: STAGED가 너무 크면 실패

사람 리뷰 뒤 골라 승인

감사용 LIVE 그래프 스냅샷

STAGED / LIVE 모델

관련