Korean Disclosure Routing

공개 호출 방식

import dartlab

c = dartlab.Company("005930")

# 지배구조
gov = c.governance()

# 공시 이벤트 (임원변동 · 주요사항)
events = c.disclosure(category="임원변동")

# 사업보고서 segment narrative
narrative = c.panel("businessOverview")

# 감사보고서
audit = c.audit()

# 별도 vs 연결
sep = c.panel("IS", basis="separate")
con = c.panel("IS", basis="consolidated")

호출 동작

• 자연어 한국 공시 질문 → 본 skill 의 examples 표를 보고 적합 apiRef 선택.
• 종목코드 (DART) 또는 ticker (EDGAR) 를 target 으로 고정 후 Company 객체 생성.
• 매핑된 apiRef 가 capability registry 에 박혀있는지 확인 (ReadCapability 도구).
• EngineCall(apiRef=…) 호출 — 자연어 인자 X · 매핑 apiRef 직접 호출.
• DART 공시 종류는 미국 EDGAR 양식 (8-K · 10-K) 과 1:1 매핑 X — 한국 공시 양식 (사업보고서 · 분기보고서 · 주요사항보고 · 공정공시 · 대규모기업집단현황공시) 의 한국 특화 routing 이다.

대표 반환 형태

한국 공시 종류	apiRef	반환 dtype	핵심 필드
기업지배구조보고서 (15 핵심지표)	Company.governance	dict	board · audit · disclosure 분기
임원 변동 · 5억 이상 보수	Company.disclosure(category="임원변동")	DataFrame	rceptNo · filedAt · title · formType
사업보고서 II 항 segment narrative	Company.panel("businessOverview")	DataFrame	period · topic · content · sourceRef
감사보고서	Company.audit	dict	auditor · opinion · keyAuditMatters
별도재무제표 (parent-only)	Company.panel("IS", basis="separate")	DataFrame	account · value · period
연결재무제표	Company.panel("IS", basis="consolidated")	DataFrame	account · value · period · subsidiary

각 결과는 DART rceptNo + section + paragraph 의 source chain 보존 (wrapExternalInResult).

기본 검증

• 한국 공시 답변은 모든 숫자 claim 을 DART filing rceptNo 와 section paragraph 에 직접 묶는다.
• 별도 vs 연결 혼동 차단 — basis 인자 명시 없이 한국 기업 NI/EBIT 비교 금지.
• 본 skill 의 examples 표에 새 한국 공시 종류가 추가될 때마다 capabilityRefs · whenToUse 동기화.
• DART 공시 종류와 EDGAR 양식 (8-K · 10-K) 의 자동 매핑 금지 — 한국 양식은 독립 SSOT.
• 답변 본문에 rceptNo 인용 없이 한국 공시 본문을 인용하지 않는다 (forbidden 강제).