Company Governance

공개 호출 방식

import dartlab

c = dartlab.Company("005930")

# 최신 지배구조보고서
gov = c.governance()
print(gov["board"])               # 이사회 구성 (사외이사 비율 등)
print(gov["auditCommittee"])      # 감사위원회 독립성
print(gov["majorHolder"])         # 최대주주
print(gov["disclosure"])          # 15 핵심지표 yes/no + 미준수 narrative

# 5 년 추세
import polars as pl
trends = pl.concat([
    c.governance(period=f"{y}").to_frame()
    for y in range(2020, 2026)
])

호출 동작

• target = 종목코드 (KOSPI/KOSDAQ) 또는 ticker (EDGAR). 한국 강제: KOSPI 시가총액 ≥ 1 조 원 기업은 기업지배구조보고서 의무.
• period 미명시 = 최신 보고서. 명시 = 해당 회계연도 보고서.
• 반환 dict 의 key 4 종 (board · auditCommittee · majorHolder · disclosure).
• 15 핵심지표 disclosure key 안에 yes/no boolean + 미준수 narrative string.
• DART OpenAPI 의 corp_outline + corp_report 조합으로 추출. rceptNo + section 보존.

대표 반환 형태

{
  "board": {
    "totalDirectors": int,
    "outsideDirectors": int,
    "outsideRatio": float,
    "ceoChairSeparated": bool,
    "members": [{"name": str, "role": str, "isOutside": bool, ...}]
  },
  "auditCommittee": {
    "totalMembers": int,
    "outsideMembers": int,
    "independenceScore": float
  },
  "majorHolder": {
    "topHolder": str,
    "topHolderRatio": float,
    "treasuryRatio": float,
    "foreignRatio": float
  },
  "disclosure": {
    "indicator1_boardIndependence": {"compliant": bool, "narrative": str, "rceptNo": str},
    ...
    "indicator15_cumulativeVoting": {"compliant": bool, "narrative": str, "rceptNo": str}
  }
}

기본 검증

• 답변의 사외이사 비율 · CEO/Chair 분리 · 누적투표제 등 수치 claim 은 모두 rceptNo + section paragraph 에 묶인다.
• 15 핵심지표 yes/no 만 답변 본문에 박지 말고 미준수 narrative 도 같이 인용 (한국 corporate governance code 의 explain-or-comply 원칙).
• KOSPI < 1 조 원 기업은 governance 보고서 미의무 → 본 skill 의 fallback = Company.disclosure(category=“기업지배구조”) · 결과 None 처리.
• Company.governance() docstring 변경 시 본 skill 의 capabilityRefs · examples · 반환 형태 동기화.
• 외부 본문 (DART 원본 narrative) 은 wrapExternalInResult 의 untrusted marker 강제.