OntoCast Vendored Copy — 수정 내역

본 디렉터리는 OntoCast의 vendored copy다.

Apache 2.0 의무사항

본 vendored copy 내의 파일을 수정할 경우 Apache License 2.0 §4(b) 요구사항에 따라:

파일: ontocast/agent/convert_document.py
문제: 루프는 모든 state.files를 순회하지만 state.set_text(result["text"])가 매 반복에서 덮어써 마지막 파일의 텍스트만 살아남았다("NB: processing only one file" 주석으로 의도가 명시되어 있던 부분).
수정: 텍스트를 texts: list[str]에 누적하고 파일이 2개 이상이면 === File: <name> === 경계 마커를 사이에 삽입해 단일 corpus로 합친다. 단일 파일 입력은 마커 없이 통과하여 기존 단일 파일 동작과 byte-identical. JSON envelope의 ontology_user_instruction / facts_user_instruction / url은 first-wins (한 corpus는 하나의 instruction이라는 모델). 첫 unsupported 확장자에서 fail-fast하는 기존 동작 유지.
회귀 테스트: tests/unit/test_convert_document.py (7 케이스 — 단일 PDF / 단일 JSON / 다중 PDF / 다중 JSON first-wins / 미지원 확장자 / 빈 입력 / 혼합 PDF+JSON)
근거: docs/통합설계서.md §5 Phase 0, OntoCast 분석 §13.1 / §21.1 (#4)

파일: ontocast/agent/select_ontology.py
문제: dynamic Pydantic 모델은 answer_index ∈ [1, num_ontologies + 1]을 강제하지만 코드는 answer_index == 0을 "None"으로 처리. 0은 Pydantic 검증을 통과할 수 없어 dead code였으며, LLM이 None을 선택할 때마다(num_ontologies + 1 반환) defensive branch로 빠져 WARNING 로그가 찍혔다.
수정: none_index = num_ontologies + 1 분기 추가, answer_index == 0 분기 제거. 파일 상단에 MODIFIED 2026-05-13 주석 추가.
회귀 테스트: tests/unit/test_select_ontology.py (4 케이스 — 빈 ontology / 정상 선택 / None 선택 / 범위 밖)
근거: docs/통합설계서.md §5 Phase 0, OntoCast 분석 §13.1

vendored/ontocast/ontocast/ 패키지는 우리 코드(platform/)에서 import하여 사용한다
OntoCast의 코어 모듈(stategraph/, agent/, onto/, tool/)은 수정 최소화
API 레이어(vendored/ontocast/ontocast/cli/serve.py Robyn)는 사용하지 않고 우리가 FastAPI로 재작성한다
OntoCast 자체의 pyproject.toml은 참고용이며, 의존성은 프로젝트 루트의 pyproject.toml이 우선