Damodaran 스토리-드라이버 변환

공개 호출 방식

import dartlab
import importlib.resources as resources
import json

import polars as pl
from dartlab.synth.damodaranL15 import buildDamodaranMemo

target = "005930"
c = dartlab.Company(target)
market = getattr(c, "market", "US" if not target.isdigit() else "KR")
currency = getattr(c, "currency", "USD" if market == "US" else "KRW")
company_name = getattr(c, "corpName", getattr(c, "companyName", target))


def _loadReference(name):
    return json.loads(resources.files("dartlab.reference.data").joinpath(name).read_text(encoding="utf-8"))


def _safeShow(topic):
    try:
        table = c.show(topic, freq="Y")
    except TypeError:
        table = c.show(topic)
    except Exception:
        return pl.DataFrame()
    return table if isinstance(table, pl.DataFrame) else pl.DataFrame()


def _marketData():
    try:
        frame = dartlab.gather("price", target, market="US") if market == "US" else dartlab.gather("price", target)
        if isinstance(frame, pl.DataFrame) and frame.height:
            return {"priceDate": str(frame.tail(1).to_dicts()[0].get("date", ""))}
    except Exception as exc:
        return {"priceError": type(exc).__name__}
    return {}


country_defaults = _loadReference("damodaranDefaults.json")
industry_defaults = _loadReference("damodaranIndustryDefaults.json")
memo = buildDamodaranMemo(
    target=target,
    market=market,
    currency=currency,
    companyName=company_name,
    statements={topic: _safeShow(topic) for topic in ("IS", "BS", "CF")},
    countryDefaults=country_defaults,
    industryDefaults=industry_defaults,
    marketData=_marketData(),
)

emit_result(
    table=memo["tables"]["storyToDrivers"],
    values=memo["headline"],
    date=memo.get("asOf"),
    units=memo["units"],
    sources=memo["sources"],
)

호출 동작

1. 결론 도출

story claim을 성장, 마진, 재투자, 리스크, terminal, reverse price story driver로 분해한다.

2. 핵심 근거 수집

정규화 재무 패널과 Damodaran reference, gather price metadata를 사용한다.

3. 메커니즘 분석

Damodaran식 스토리는 수치 가정으로 검증 가능해야 한다. reverse DCF가 blocked이면 현재 가격 내재 스토리는 partial로 둔다.

4. 반례·한계

금융업은 일반 FCFF driver로 변환하지 않고 별도 모델 경로를 남긴다.

5. 후속 모니터링

후속 스킬은 growthFeasibility, fcffDcf, scenarioFalsifier다.

대표 반환 형태

storyToDrivers : list[dict] — storyClaim, driver, value, status.

연계 절차

1. recipes.fundamental.valuation.damodaran.narrativeMap - narrative 요소를 구조화.
2. recipes.fundamental.valuation.damodaran.growthFeasibility - driver의 성장 정합성 반증.
3. recipes.fundamental.valuation.damodaran.scenarioFalsifier - 현재 가격 내재 스토리 반증.

기본 검증

• 모든 row는 storyClaim, driver, status를 가져야 한다.