catalyst 일정 캘린더 (다가오는 정기공시 추론)

공개 호출 방식

import dartlab

tickers = ["005930", "000660", "035420"]
df = dartlab.gather("calendar", tickers, horizon_days=30)
# df: date, code, eventType, title, source, impactHint, confidence

emit_result(
    table=df.to_dicts(),
    date=str(df["date"].max()) if not df.is_empty() else None,
)

호출 동작

gather('calendar') 가 회사별 disclosure 시계열에서 마지막 정기보고서 → 다음 fiscal cycle due 추론. horizon 안의 이벤트만 반환.

1. tickers + horizon 확정.
2. gather(‘calendar’, codes, horizon_days) — DART API 호출 (각 종목 disclosure 1 회).
3. confidence 별 classification.
4. 본문 — 이번 주 / 다음 주 / 그 후 그룹핑.
5. catalystCalendar 결과는 dailyMorningNote 의 “오늘 주목” 섹션과 연동 가능.

대표 반환 형태

• tableRef 1 개 — 향후 N 일 일정 (date · code · eventType · title · impactHint · confidence)
• dateRef 1 개 — 기준일
• 답변 본문 — 시점별 그룹 + 임팩트 큰 이벤트 헤드라인

연계 절차

1. engines.gather — gather(‘calendar’, codes, horizon_days) 호출
2. recipes.report.dailyMorningNote — morning note 의 “오늘 주목” 섹션과 연동
3. recipes.report.thesisTracker — thesis 의 catalyst 영역 갱신
4. recipes.disclosure.event — 발생한 이벤트 사후 분석 path

한계 (P0)

• 한국 정기공시 (사업·반기·분기) 추론만 지원. AGM·만기·컨센서스·EDGAR 8-K 미포함 (P1+).
• fiscal year ≠ calendar year 인 회사 (소수) 는 추론 정확도 낮음 — capability 가 confidence 로 표시.
• 추론된 due date 는 예상 — 실제 회사 사정으로 ±3 일 변동 가능.
• US 시장 호출 → 빈 DataFrame + 안내. P1 에서 EDGAR 분기 cycle 추가 예정.

외부 본문 가드

본 recipe 는 dartlab internal capability (gather + Company.disclosure) 만 호출 — sourceType=internal. 외부 컨센서스 사이트 (FactSet/Bloomberg 등) 는 본 capability 가 호출하지 않는다. 사용자가 외부 confirmation 을 WebSearch 로 가져오면 그 결과는 [EXTERNAL CONTENT START/END] 마커로 감싸지고 2 차 검증 없이 인용 금지. 상세: runtime.workbenchEvidenceFlow.