ingest

llm-brain의 ingest 커맨드입니다. 아래 절차를 순서대로 실행하세요.

인자 파싱

$ARGUMENTS를 파싱해 모드를 결정합니다:

• https://... 또는 http://... 로 시작 → URL 모드
• --file <경로> 포함 → 파일 모드
• --note "<텍스트>" 포함 → 노트 모드
• --resonance high|medium|low 옵션이 있으면 해당 레벨 사용
• --priority-only → resonance: high 미처리 파일만 처리
• 인자 없음 → 미처리 파일 목록만 확인

Step 1: 스크립트 실행

인자에 따라 아래 중 해당하는 명령 실행:

# URL 수집
cd "$(git rev-parse --show-toplevel)"  # llm-brain 레포 루트
uv run python scripts/ingest.py --url <URL> [--resonance <level>]

# 파일 추가
uv run python scripts/ingest.py --file <경로> [--resonance <level>]

# 텍스트 노트
uv run python scripts/ingest.py --note "<텍스트>" [--resonance <level>]

# 미처리 목록 확인 (인자 없음)
uv run python scripts/ingest.py [--priority-only]

exit code 0 = 처리할 파일 없음, exit code 1 = 미처리 파일 있음.

Step 2: wiki 컴파일

스크립트 출력에서 미처리 파일 목록을 확인합니다. 미처리 파일이 있으면 schema/ingest.md 규칙에 따라 각 파일을 wiki 페이지로 컴파일합니다:

1. 각 raw 파일 내용 읽기
2. schema/domains.yaml 기준 도메인 분류
3. index.md에서 관련 기존 페이지 확인
   • 기존 페이지 있음 → 갱신 (sources 추가, 내용 병합)
   • 없음 → 신규 생성 (wiki frontmatter 포함)
4. wikilink 교차 연결
5. index.md 갱신

Step 3: 완료 표시

wiki 컴파일 완료 후:

cd "$(git rev-parse --show-toplevel)"  # llm-brain 레포 루트
uv run python scripts/ingest.py --mark-done

Step 4: 그래프 delta 처리

wiki 페이지가 0개이거나 Step 2에서 변경 사항이 없으면 이 단계를 건너뜁니다.

4-0. 스냅샷 (export_graph.py 실행 전 반드시 먼저):

import sys
sys.path.insert(0, "scripts")
from ingest import snapshot_graph
snapshot_graph()  # wiki/graph.json → wiki/.graph_prev.json 복사

4-1. export_graph.py 실행 (graph.json 갱신):

cd "$(git rev-parse --show-toplevel)"  # llm-brain 레포 루트
uv run python scripts/export_graph.py

4-2. delta 계산 및 출력:

import sys
sys.path.insert(0, "scripts")
from ingest import run_delta_pipeline, print_delta
delta = run_delta_pipeline()
if delta:
    print_delta(delta)
else:
    print("[ingest] delta — 변경 없음")

Step 5: Canvas 생성

delta가 있으면 wiki/canvas/ingest-delta.canvas를 생성합니다:

import sys
sys.path.insert(0, "scripts")
from ingest import generate_ingest_delta_canvas
generated = generate_ingest_delta_canvas()
if not generated:
    print("[ingest] canvas 생성 생략 (delta 없음)")