release: v0.7.16 — 시맨틱 검색 + AI 패턴 + review 확장

Author: eddmpython

CAPABILITIES.md

@@ -1,6 +1,6 @@
 # dartlab Capabilities
 
-> v0.7.15 기준 자동 생성. 직접 수정 금지.  
+> v0.7.16 기준 자동 생성. 직접 수정 금지.  
 > `uv run python scripts/generateSpec.py`로 재생성.
 
 
@@ -1500,6 +1500,7 @@ sections: 구조화된 데이터 지도 (retrievalBlocks의 원본)
 4개 출력 형식 (rich, html, markdown, json)
 섹션간 순환 서사 자동 감지
 프리셋 지원 (executive/audit/credit/growth/valuation)
+스토리 템플릿 (사이클/프랜차이즈/턴어라운드/성장/자본집약/지주/현금부자)
 detail=False로 요약만 표시
 레이아웃 커스텀
 **Requires:** 데이터: finance + report (자동 다운로드)
@@ -1508,6 +1509,7 @@ ask()에서 재무분석 컨텍스트로 활용
 **Guide:** "재무 검토서 만들어줘" -> c.review()
 "수익구조 분석" -> c.review("수익구조")
 "감사용 리뷰" -> c.review(preset="audit")
+"이 회사 스토리는?" -> c.review(template="auto")
 "요약만 보여줘" -> c.review(detail=False)
 "AI 의견 포함 보고서" -> c.reviewer() (review + AI 해석)
 **SeeAlso:** reviewer: review() + AI 섹션별 종합의견 (AI 해석 포함)

CHANGELOG.md

@@ -5,6 +5,30 @@ All notable changes to DartLab will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.7.16] - 2026-03-31
+
+### Added
+
+- **시맨틱 검색 엔진(alpha)**: `dartlab.search("대표이사 변경")` — n-gram + vector hybrid 검색. core/search 모듈 신규, ngramIndex 전면 개선
+- **AI 프롬프트 패턴 3종**: growth, quick_check, value_investor 패턴 추가. 기존 패턴(financial, prediction, risk, valuation) 보강
+- **review 6막 구조 확장**: builders/templates 대폭 강화, registry 축-보고서 매핑 보강
+- **analysis predictionSignals 확장**: 예측 신호 12→15축 (consensusDirection, flowDirection, revenueDirection)
+- **ops/ 운영문서 체계**: DEV.md 전면 제거 → 루트 ops/에 엔진별 설계 문서 통합
+- **실험 105 시맨틱 맵**: 13개 실험 스크립트 (taxonomy~reportNmMapping)
+- **VSCode extension**: ChatInput/ChatPanel UX 개선, 메시지 프로토콜 확장
+
+### Changed
+
+- **analysis 6축 계산 개선**: asset, capital, costStructure, earningsQuality, stability 보강
+- **providers/dart**: allFilingsCollector 증분 수집/에러 복구 강화, notes 파싱 개선
+- **ai/runtime**: 패턴 매칭 로직 확장, standalone 안정화
+- **core**: vectorStore를 core/search로 이전, exogenousAxes/ols 강화
+
+### Removed
+
+- **DEV.md 28개 파일**: 모듈별 산재된 개발 메모 → ops/ 통합으로 대체
+- **core/vectorStore.py**: core/search/vectorStore.py로 이전
+
 ## [0.7.15] - 2026-03-30
 
 ### Added

docs/api/generated-reference.md

@@ -63,7 +63,7 @@ dartlab 전역 설정.
 
 LLM 기반 적극적 분석가. dartlab을 도구로 삼아 주체적으로 분석하고, 사용자의 분석 학습을 돕는다.
 
-### `dartlab.ask(args: str, *, include: list[str] | None = None, exclude: list[str] | None = None, provider: str | None = None, model: str | None = None, stream: bool = True, raw: bool = False, reflect: bool = False, pattern: str | None = None, kwargs)`
+### `dartlab.ask(args: str, *, include: list[str] | None = None, exclude: list[str] | None = None, provider: str | None = None, model: str | None = None, stream: bool = True, raw: bool = False, reflect: bool = False, pattern: str | None = None, template: str | None = None, modules: list[str] | None = None, kwargs)`
 
 LLM에게 기업에 대해 질문.
 
@@ -1235,7 +1235,7 @@ c = Company("005930")
 c.retrievalBlocks          # 전체 retrieval 블록
 ```
 
-### `review(section: str | None = None, layout = None, helper: bool | None = None, *, preset: str | None = None, detail: bool | None = None, basePeriod: str | None = None)`
+### `review(section: str | None = None, layout = None, helper: bool | None = None, *, preset: str | None = None, template: str | None = None, detail: bool | None = None, basePeriod: str | None = None)`
 
 재무제표 구조화 보고서 — 14개 섹션 데이터 검토서.
 
@@ -1245,13 +1245,15 @@ c.retrievalBlocks          # 전체 retrieval 블록
 - layout: ReviewLayout 커스텀. None이면 기본.
 - helper: True면 해석 힌트 텍스트 포함. None이면 자동.
 - preset: 프리셋명 ("executive"/"audit"/"credit"/"growth"/"valuation"). None이면 전체.
+- template: 스토리 템플릿 ("성장"/"자본집약"/"지주" 등). "auto"면 자동 판별.
 - detail: True면 전체 블록, False면 섹션 요약만. None이면 preset 기본값 또는 True.
 
 ```python
 c.review()                        # 전체 검토서
 c.review("수익구조")                # 특정 섹션
 c.review(preset="audit")          # 감사/회계 검토용
-c.review(preset="executive")      # 경영진 요약
+c.review(template="auto")         # 스토리 자동 판별
+c.review(template="성장")          # 성장 템플릿 적용
 c.review(detail=False)            # 전 섹션 요약만
 ```
 

docs/changelog.md

@@ -9,6 +9,25 @@ All notable changes to DartLab will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.7.16] - 2026-03-31
+
+### Added
+
+- **시맨틱 검색 엔진(alpha)**: `dartlab.search("대표이사 변경")` — n-gram + vector hybrid 검색
+- **AI 프롬프트 패턴 3종**: growth, quick_check, value_investor
+- **review 6막 구조 확장**: builders/templates 대폭 강화
+- **analysis predictionSignals 확장**: 12→15축
+- **ops/ 운영문서 체계**: DEV.md → ops/ 통합
+- **실험 105 시맨틱 맵**: 13개 실험 스크립트
+
+### Changed
+
+- **analysis 6축 계산 개선**, providers/dart 강화, ai/runtime 확장, core/search 이전
+
+### Removed
+
+- **DEV.md 28개 파일**, core/vectorStore.py (search로 이전)
+
 ## [0.7.15] - 2026-03-30
 
 ### Added

landing/static/api-reference.json

@@ -115,6 +115,18 @@
         "default": "None",
         "keyword_only": "true"
       },
+      {
+        "name": "template",
+        "type": "str | None",
+        "default": "None",
+        "keyword_only": "true"
+      },
+      {
+        "name": "modules",
+        "type": "list[str] | None",
+        "default": "None",
+        "keyword_only": "true"
+      },
       {
         "name": "kwargs"
       }
@@ -1897,6 +1909,12 @@
         "default": "None",
         "keyword_only": "true"
       },
+      {
+        "name": "template",
+        "type": "str | None",
+        "default": "None",
+        "keyword_only": "true"
+      },
       {
         "name": "detail",
         "type": "bool | None",
@@ -1910,12 +1928,12 @@
         "keyword_only": "true"
       }
     ],
-    "args": "section: 섹션명 (\"수익구조\" 등). None이면 전체.\nlayout: ReviewLayout 커스텀. None이면 기본.\nhelper: True면 해석 힌트 텍스트 포함. None이면 자동.\npreset: 프리셋명 (\"executive\"/\"audit\"/\"credit\"/\"growth\"/\"valuation\"). None이면 전체.\ndetail: True면 전체 블록, False면 섹션 요약만. None이면 preset 기본값 또는 True.",
+    "args": "section: 섹션명 (\"수익구조\" 등). None이면 전체.\nlayout: ReviewLayout 커스텀. None이면 기본.\nhelper: True면 해석 힌트 텍스트 포함. None이면 자동.\npreset: 프리셋명 (\"executive\"/\"audit\"/\"credit\"/\"growth\"/\"valuation\"). None이면 전체.\ntemplate: 스토리 템플릿 (\"성장\"/\"자본집약\"/\"지주\" 등). \"auto\"면 자동 판별.\ndetail: True면 전체 블록, False면 섹션 요약만. None이면 preset 기본값 또는 True.",
     "returns": "Review — 구조화 보고서.",
-    "example": "c.review()                        # 전체 검토서\nc.review(\"수익구조\")                # 특정 섹션\nc.review(preset=\"audit\")          # 감사/회계 검토용\nc.review(preset=\"executive\")      # 경영진 요약\nc.review(detail=False)            # 전 섹션 요약만",
-    "capabilities": "14개 섹션 전체 보고서 (수익구조~재무정합성)\n단일 섹션 지정 가능\n4개 출력 형식 (rich, html, markdown, json)\n섹션간 순환 서사 자동 감지\n프리셋 지원 (executive/audit/credit/growth/valuation)\ndetail=False로 요약만 표시\n레이아웃 커스텀",
+    "example": "c.review()                        # 전체 검토서\nc.review(\"수익구조\")                # 특정 섹션\nc.review(preset=\"audit\")          # 감사/회계 검토용\nc.review(template=\"auto\")         # 스토리 자동 판별\nc.review(template=\"성장\")          # 성장 템플릿 적용\nc.review(detail=False)            # 전 섹션 요약만",
+    "capabilities": "14개 섹션 전체 보고서 (수익구조~재무정합성)\n단일 섹션 지정 가능\n4개 출력 형식 (rich, html, markdown, json)\n섹션간 순환 서사 자동 감지\n프리셋 지원 (executive/audit/credit/growth/valuation)\n스토리 템플릿 (사이클/프랜차이즈/턴어라운드/성장/자본집약/지주/현금부자)\ndetail=False로 요약만 표시\n레이아웃 커스텀",
     "requires": "데이터: finance + report (자동 다운로드)",
-    "guide": "\"재무 검토서 만들어줘\" -> c.review()\n\"수익구조 분석\" -> c.review(\"수익구조\")\n\"감사용 리뷰\" -> c.review(preset=\"audit\")\n\"요약만 보여줘\" -> c.review(detail=False)\n\"AI 의견 포함 보고서\" -> c.reviewer() (review + AI 해석)",
+    "guide": "\"재무 검토서 만들어줘\" -> c.review()\n\"수익구조 분석\" -> c.review(\"수익구조\")\n\"감사용 리뷰\" -> c.review(preset=\"audit\")\n\"이 회사 스토리는?\" -> c.review(template=\"auto\")\n\"요약만 보여줘\" -> c.review(detail=False)\n\"AI 의견 포함 보고서\" -> c.reviewer() (review + AI 해석)",
     "seealso": "reviewer: review() + AI 섹션별 종합의견 (AI 해석 포함)\nanalysis: 14축 개별 분석 (review가 내부적으로 소비)\ninsights: 7영역 등급 + 이상치 요약"
   },
   {

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dartlab"
-version = "0.7.15"
+version = "0.7.16"
 description = "DART 전자공시 + EDGAR 공시를 하나의 회사 맵으로 — Python 재무 분석 라이브러리"
 readme = "README.md"
 license = {file = "LICENSE"}

src/dartlab/guide/_generated.py

@@ -370,8 +370,8 @@
     },
     "Company.review": {
         "aicontext": "reviewer()가 이 결과를 소비하여 AI 해석 생성\nask()에서 재무분석 컨텍스트로 활용",
-        "capabilities": "14개 섹션 전체 보고서 (수익구조~재무정합성)\n단일 섹션 지정 가능\n4개 출력 형식 (rich, html, markdown, json)\n섹션간 순환 서사 자동 감지\n프리셋 지원 (executive/audit/credit/growth/valuation)\ndetail=False로 요약만 표시\n레이아웃 커스텀",
-        "guide": '"재무 검토서 만들어줘" -> c.review()\n"수익구조 분석" -> c.review("수익구조")\n"감사용 리뷰" -> c.review(preset="audit")\n"요약만 보여줘" -> c.review(detail=False)\n"AI 의견 포함 보고서" -> c.reviewer() (review + AI 해석)',
+        "capabilities": "14개 섹션 전체 보고서 (수익구조~재무정합성)\n단일 섹션 지정 가능\n4개 출력 형식 (rich, html, markdown, json)\n섹션간 순환 서사 자동 감지\n프리셋 지원 (executive/audit/credit/growth/valuation)\n스토리 템플릿 (사이클/프랜차이즈/턴어라운드/성장/자본집약/지주/현금부자)\ndetail=False로 요약만 표시\n레이아웃 커스텀",
+        "guide": '"재무 검토서 만들어줘" -> c.review()\n"수익구조 분석" -> c.review("수익구조")\n"감사용 리뷰" -> c.review(preset="audit")\n"이 회사 스토리는?" -> c.review(template="auto")\n"요약만 보여줘" -> c.review(detail=False)\n"AI 의견 포함 보고서" -> c.reviewer() (review + AI 해석)',
         "kind": "method",
         "requires": "데이터: finance + report (자동 다운로드)",
         "seeAlso": "reviewer: review() + AI 섹션별 종합의견 (AI 해석 포함)\nanalysis: 14축 개별 분석 (review가 내부적으로 소비)\ninsights: 7영역 등급 + 이상치 요약",