ltcai 0.2.1 → 0.3.0

package/README.md

@@ -154,14 +154,17 @@ Based on public product behavior as of 2026-05.
 |-------|----------|------|---------|
 | Qwen3-VL 4B | Multimodal / low spec | ~2.7 GB | 8 GB |
 | Qwen3-VL 8B | Multimodal / balanced | ~4.8 GB | 16 GB |
+| GPT-OSS 20B | Reasoning / open-weight | ~12.1 GB | 32 GB |
 | Gemma 4 26B | Multimodal / large | ~15.6 GB | 32 GB |
+| Gemma 4 31B | Multimodal / latest Gemma 4 | ~18.4 GB | 48 GB |
 | Qwen3-VL 30B A3B | Multimodal / top | ~18 GB | 48 GB |
+| GPT-OSS 120B | Reasoning / top open-weight | ~62.3 GB | 128 GB |
 | Phi 4 Mini | Coding (fast) | ~2.2 GB | 8 GB |
 | Llama 3.1 8B | General | ~4.7 GB | 8 GB |
 | Mistral 7B v0.3 | General / Apache | ~4.1 GB | 8 GB |
 
 **Cross-platform (Ollama / LM Studio / vLLM / llama.cpp):**
-Same models via Ollama pull, LM Studio download, or vLLM serve.
+Same models via Ollama pull, LM Studio download, vLLM serve, or llama.cpp GGUF where available.
 
 **Cloud (any platform):**
 OpenAI GPT-5.5 · Claude Opus 4.7 / Sonnet 4.6 / Haiku 4.5 via OpenRouter · Groq · Together · xAI · any OpenAI-compatible endpoint
@@ -360,7 +363,7 @@ Full reference: [docs/mcp-tools.md](docs/mcp-tools.md)
 | VS Code Marketplace | [marketplace.visualstudio.com](https://marketplace.visualstudio.com/items?itemName=parktaesoo.ltcai) |
 | Open VSX | [open-vsx.org](https://open-vsx.org/extension/parktaesoo/ltcai) |
 
-Current version: **0.2.1** — [Changelog](docs/CHANGELOG.md)
+Current version: **0.2.2** — [Changelog](docs/CHANGELOG.md)
 
 ---
 
@@ -416,8 +419,11 @@ LTCAI --tunnel                       # + Cloudflare 공개 URL 자동 발급
 |------|------|------|----------|
 | Qwen3-VL 4B | 멀티모달 / 저사양 | ~2.7GB | 8GB |
 | Qwen3-VL 8B | 멀티모달 / 균형 추천 | ~4.8GB | 16GB |
+| GPT-OSS 20B | 추론 / 오픈가중치 | ~12.1GB | 32GB |
 | Gemma 4 26B | 멀티모달 / 대형 | ~15.6GB | 32GB |
+| Gemma 4 31B | 멀티모달 / 최신 Gemma 4 | ~18.4GB | 48GB |
 | Qwen3-VL 30B A3B | 멀티모달 / 최고급 | ~18GB | 48GB |
+| GPT-OSS 120B | 추론 / 최고급 오픈가중치 | ~62.3GB | 128GB |
 
 자세한 내용: [docs/CHANGELOG.md](docs/CHANGELOG.md) · [보안](SECURITY.md) · [기여](CONTRIBUTING.md)
 

package/auto_setup.py

@@ -443,8 +443,16 @@ class Recommendation:
 _MODEL_CATALOG: List[Dict[str, Any]] = [
     # (min_ram_mb, min_vram_mb, model_id, quant, runtime_preference)
     # OS 오버헤드(~4-6 GB) + KV 캐시 여유를 감안한 보수적 RAM 임계값
+    {"ram": 128 * 1024, "vram": 48 * 1024,
+     "id": "mlx-community/gpt-oss-120b-MXFP4-Q4", "q": "mxfp4", "multimodal": False},
+    {"ram": 64 * 1024, "vram": 32 * 1024,
+     "id": "mlx-community/gemma-4-31b-it-4bit", "q": "4bit", "multimodal": True},
     {"ram": 64 * 1024, "vram": 32 * 1024,
      "id": "Qwen/Qwen3-VL-30B-A3B-Instruct", "q": "q4_K_M", "multimodal": True},
+    {"ram": 48 * 1024, "vram": 24 * 1024,
+     "id": "mlx-community/gemma-4-31b-it-4bit", "q": "4bit", "multimodal": True},
+    {"ram": 32 * 1024, "vram": 16 * 1024,
+     "id": "mlx-community/gpt-oss-20b-MXFP4-Q8", "q": "mxfp4", "multimodal": False},
     {"ram": 48 * 1024, "vram": 24 * 1024,
      "id": "Qwen/Qwen3-VL-30B-A3B-Instruct", "q": "q4_K_M", "multimodal": True},
     {"ram": 32 * 1024, "vram": 16 * 1024,
@@ -630,7 +638,13 @@ def plan(profile: SystemProfile, rec: Recommendation) -> InstallPlan:
     model_command = ["huggingface-cli", "download", rec.model_id, "--quiet"]
     if rec.runtime == "ollama":
         lower = rec.model_id.lower()
-        if "qwen3-vl-8b" in lower:
+        if "gpt-oss-120b" in lower:
+            model_command = ["ollama", "pull", "gpt-oss:120b"]
+        elif "gpt-oss-20b" in lower:
+            model_command = ["ollama", "pull", "gpt-oss:20b"]
+        elif "gemma-4-31b" in lower:
+            model_command = ["ollama", "pull", "hf.co/ggml-org/gemma-4-31B-it-GGUF:Q4_K_M"]
+        elif "qwen3-vl-8b" in lower:
             model_command = ["ollama", "pull", "qwen3-vl:8b"]
         elif "qwen3-vl-4b" in lower:
             model_command = ["ollama", "pull", "qwen3-vl:4b"]

package/docs/CHANGELOG.md

@@ -1,5 +1,72 @@
 # Changelog
 
+## [0.3.0] - 2026-05-27
+
+### Knowledge Graph — LLM Structured Output Extraction
+
+- `_extract_concepts()` / `_extract_triples()`를 LLM 기반으로 전환 (rule-based 폴백 유지)
+- LLM Router 참조를 knowledge_graph에 주입하는 `set_llm_router()` 함수 추가
+- `LATTICEAI_LLM_EXTRACTION` 환경변수로 LLM extraction on/off 제어
+
+### Knowledge Graph — Hybrid Retrieval & Document Generation
+
+- `search_for_document_generation()` 추가 — Hybrid Score (0.5×text + 0.3×graph + 0.2×recency) 기반 검색
+- `multi_hop_context()` 추가 — Seed nodes에서 N-hop 그래프 탐색
+- `DOCUMENT` NodeType, `USED_IN` / `INSPIRED_BY` / `CONTRADICTS` / `EVOLVES_FROM` EdgeType 추가
+- Node에 `style`, `tone`, `importance_score`, `last_used` 필드 추가 (SQLite v2 스키마 반영)
+
+### 문서 자동 생성 파이프라인
+
+- `latticeai/core/context_builder.py` 신규 — Knowledge Graph → 구조화 Markdown Context 변환
+- `latticeai/core/document_generator.py` 신규 — Intent detection + 전용 System Prompt + Session 관리
+- `llm_router.py`에 `generate_document()` / `stream_generate_document()` 추가
+- `/chat` 엔드포인트에서 "보고서 작성해줘" 같은 문서 생성 의도 자동 감지 → 전용 파이프라인 활성화
+- 생성 문서에 참조 Knowledge Graph 노드 각주 자동 첨부
+- 대화별 `DocumentGenerationSession`으로 반복 수정("이 부분 더 수정해") 지원
+
+### UI/UX — 디자인 통일
+
+- Account/Chat/Graph/Admin 전체 페이지를 통일된 lavender purple 테마로 전환
+- 다크 모드 base 스타일 완전 제거 (`.app-layout` Obsidian dark, account dark base 등)
+- 초록 테마(`#22d3a0`) 60+ 인스턴스를 보라(`#6f42e8`) 계열로 교체
+- 메시지 버블: 다크 green → 보라 gradient(user), 밝은 lavender glass(AI)
+- 사이드바, 입력창, 버튼, 모달 오버레이 모두 라이트 lavender로 통일
+- 카드/패널에 hover lift 효과, 커스텀 스크롤바, focus ring, selection 색상 추가
+- tokens.css에 글로벌 polish (scrollbar, selection, focus-visible) 추가
+
+### 테스트
+
+- `test_document_generation.py` 33개 테스트 추가 (intent detection, session, extraction, hybrid retrieval, context builder, schema v2)
+
+### Release
+
+- 배포 버전을 `0.3.0`으로 상향
+- 대상 채널: `npm` · `PyPI` · `VS Code Marketplace` · `Open VSX`
+
+## [0.2.2] - 2026-05-26
+
+### 모델 카탈로그
+
+- `GPT-OSS 20B`, `GPT-OSS 120B`, `Gemma 4 31B 4-bit`를 MLX/Ollama/vLLM/LM Studio/llama.cpp 모델 선택 및 다운로드/로드 흐름에 추가
+- 엔진별 모델 목록에서 같은 패밀리의 최신 major/minor 버전이 있으면 낮은 버전 항목을 숨기도록 정리
+- 설정 마법사 추천표와 RAM 티어에 새 모델을 반영
+
+### 지식 그래프
+
+- 로컬 폴더 스캔 시 PDF, Word, PowerPoint, Excel, CSV, 텍스트/코드, OCR 이미지 등 지원 파일은 실제 본문 텍스트가 추출된 경우에만 그래프 노드로 생성
+- 빈 PDF/Word/PowerPoint/Excel 파일이나 OCR이 비어 있는 파일은 `skipped_empty_text`로 기록하고 그래프에는 표시하지 않도록 변경
+- 기존 버전에서 파일명/상대경로만으로 만들어진 로컬 파일 노드는 다음 스캔에서 재추출 검증 후 자동 정리
+- Word 표 셀, PowerPoint 슬라이드 텍스트, Excel 실제 셀 값 추출을 보강하고 파일명 기반 개념 추출을 제거
+
+### UX
+
+- 지식 그래프 오른쪽 사이드바의 하단 잘림 문제를 수정하고 데스크톱/모바일에서 패널, 메타데이터, 긴 경로가 자연스럽게 스크롤/줄바꿈되도록 조정
+
+### Release
+
+- 배포 버전을 `0.2.2`로 상향
+- 대상 채널: `npm` · `PyPI` · `VS Code Marketplace` · `Open VSX`
+
 ## [0.2.1] - 2026-05-25
 
 ### 버그 수정

package/kg_schema.py

@@ -81,6 +81,7 @@ class NodeType(str, Enum):
     CONVERSATION = "CONVERSATION"   # 대화 세션 전체
     MESSAGE      = "MESSAGE"        # 단일 발화
     FILE         = "FILE"           # 업로드/연결된 파일
+    DOCUMENT     = "DOCUMENT"       # 생성/관리되는 문서 (보고서, 계획서 등)
     CHUNK        = "CHUNK"          # 파일의 분할 청크
     CODE_SYMBOL  = "CODE_SYMBOL"    # 함수·클래스·모듈
     CONCEPT      = "CONCEPT"        # 추출된 개념 / 태그
@@ -110,6 +111,10 @@ class EdgeType(str, Enum):
     TAGGED_AS     = "TAGGED_AS"       # ANY → CONCEPT
     VERSION_OF    = "VERSION_OF"      # FILE → FILE (히스토리)
     GRANTS_ACCESS = "GRANTS_ACCESS"   # PERSON → RESOURCE
+    USED_IN       = "USED_IN"         # CONCEPT → DOCUMENT (문서에 활용됨)
+    INSPIRED_BY   = "INSPIRED_BY"     # DOCUMENT → DOCUMENT (영감/참조 관계)
+    CONTRADICTS   = "CONTRADICTS"     # DOCUMENT ↔ DOCUMENT (상충 관계)
+    EVOLVES_FROM  = "EVOLVES_FROM"    # DOCUMENT → DOCUMENT (발전/개정 관계)
 
     @classmethod
     def from_legacy(cls, label: str) -> "EdgeType":
@@ -140,6 +145,13 @@ _LEGACY_NODE_MAP: Dict[str, NodeType] = {
     "mcp":          NodeType.TOOL,
     "project":      NodeType.PROJECT,
     "workspace":    NodeType.PROJECT,
+    "document":     NodeType.DOCUMENT,
+    "report":       NodeType.DOCUMENT,
+    "plan":         NodeType.DOCUMENT,
+    "proposal":     NodeType.DOCUMENT,
+    "보고서":       NodeType.DOCUMENT,
+    "계획서":       NodeType.DOCUMENT,
+    "기획서":       NodeType.DOCUMENT,
 }
 
 _LEGACY_EDGE_MAP: Dict[str, EdgeType] = {
@@ -171,18 +183,27 @@ _LEGACY_EDGE_MAP: Dict[str, EdgeType] = {
     "tagged_as": EdgeType.TAGGED_AS,
     "version_of": EdgeType.VERSION_OF,
     "grants_access": EdgeType.GRANTS_ACCESS,
+    "used_in":       EdgeType.USED_IN,
+    "inspired_by":   EdgeType.INSPIRED_BY,
+    "contradicts":   EdgeType.CONTRADICTS,
+    "evolves_from":  EdgeType.EVOLVES_FROM,
+    "활용됨":        EdgeType.USED_IN,
+    "영감받음":      EdgeType.INSPIRED_BY,
+    "상충함":        EdgeType.CONTRADICTS,
+    "발전함":        EdgeType.EVOLVES_FROM,
 }
 
 # 노드 타입별로 허용되는 source / target 조합 (PPT 카탈로그 그대로)
 # None == 모든 타입 허용
 EDGE_ENDPOINT_RULES: Dict[EdgeType, Tuple[Optional[Sequence[NodeType]], Optional[Sequence[NodeType]]]] = {
-    EdgeType.CONTAINS:      ((NodeType.FILE,),            (NodeType.CHUNK,)),
-    EdgeType.MENTIONS:      ((NodeType.MESSAGE, NodeType.FILE, NodeType.CHUNK),
+    EdgeType.CONTAINS:      ((NodeType.FILE, NodeType.DOCUMENT),
+                             (NodeType.CHUNK,)),
+    EdgeType.MENTIONS:      ((NodeType.MESSAGE, NodeType.FILE, NodeType.CHUNK, NodeType.DOCUMENT),
                              (NodeType.CONCEPT, NodeType.PERSON, NodeType.MODEL, NodeType.TOOL)),
     EdgeType.REFERENCES:    ((NodeType.FILE, NodeType.MESSAGE, NodeType.CHUNK),
                              (NodeType.FILE, NodeType.MESSAGE, NodeType.CHUNK)),
     EdgeType.REPLIES_TO:    ((NodeType.MESSAGE,),         (NodeType.MESSAGE,)),
-    EdgeType.AUTHORED_BY:   ((NodeType.FILE, NodeType.MESSAGE, NodeType.CONVERSATION),
+    EdgeType.AUTHORED_BY:   ((NodeType.FILE, NodeType.MESSAGE, NodeType.CONVERSATION, NodeType.DOCUMENT),
                              (NodeType.PERSON,)),
     EdgeType.USES:          ((NodeType.PROJECT, NodeType.CONVERSATION),
                              (NodeType.TOOL, NodeType.MODEL)),
@@ -194,6 +215,14 @@ EDGE_ENDPOINT_RULES: Dict[EdgeType, Tuple[Optional[Sequence[NodeType]], Optional
     EdgeType.VERSION_OF:    ((NodeType.FILE,), (NodeType.FILE,)),
     EdgeType.GRANTS_ACCESS: ((NodeType.PERSON,),
                              (NodeType.FILE, NodeType.CONVERSATION, NodeType.PROJECT)),
+    EdgeType.USED_IN:       ((NodeType.CONCEPT,),
+                             (NodeType.DOCUMENT, NodeType.FILE)),
+    EdgeType.INSPIRED_BY:   ((NodeType.DOCUMENT, NodeType.FILE),
+                             (NodeType.DOCUMENT, NodeType.FILE)),
+    EdgeType.CONTRADICTS:   ((NodeType.DOCUMENT, NodeType.FILE),
+                             (NodeType.DOCUMENT, NodeType.FILE)),
+    EdgeType.EVOLVES_FROM:  ((NodeType.DOCUMENT, NodeType.FILE),
+                             (NodeType.DOCUMENT, NodeType.FILE)),
 }
 
 
@@ -262,6 +291,10 @@ class Node:
     visibility: Visibility = Visibility.PRIVATE
     created_at: str = field(default_factory=_now_iso)
     updated_at: str = field(default_factory=_now_iso)
+    style: Optional[str] = None
+    tone: Optional[str] = None
+    importance_score: float = 0.0
+    last_used: Optional[str] = None
 
     def validate(self) -> None:
         if not isinstance(self.type, NodeType):
@@ -345,15 +378,19 @@ CREATE TABLE IF NOT EXISTS kg_meta (
 );
 
 CREATE TABLE IF NOT EXISTS nodes_v2 (
-  id          TEXT PRIMARY KEY,
-  type        TEXT NOT NULL,
-  label       TEXT NOT NULL,
-  attrs       TEXT NOT NULL DEFAULT '{}',
-  embedding   BLOB,
-  owner_id    TEXT,
-  visibility  TEXT NOT NULL DEFAULT 'private',
-  created_at  TEXT NOT NULL,
-  updated_at  TEXT NOT NULL
+  id               TEXT PRIMARY KEY,
+  type             TEXT NOT NULL,
+  label            TEXT NOT NULL,
+  attrs            TEXT NOT NULL DEFAULT '{}',
+  embedding        BLOB,
+  owner_id         TEXT,
+  visibility       TEXT NOT NULL DEFAULT 'private',
+  created_at       TEXT NOT NULL,
+  updated_at       TEXT NOT NULL,
+  style            TEXT,
+  tone             TEXT,
+  importance_score REAL NOT NULL DEFAULT 0.0,
+  last_used        TEXT
 );
 
 CREATE TABLE IF NOT EXISTS edges_v2 (
@@ -418,8 +455,9 @@ class KGStoreV2:
             conn.execute(
                 """
                 INSERT INTO nodes_v2(id, type, label, attrs, embedding,
-                                     owner_id, visibility, created_at, updated_at)
-                VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+                                     owner_id, visibility, created_at, updated_at,
+                                     style, tone, importance_score, last_used)
+                VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
                 ON CONFLICT(id) DO UPDATE SET
                   type=excluded.type,
                   label=excluded.label,
@@ -427,7 +465,11 @@ class KGStoreV2:
                   embedding=COALESCE(excluded.embedding, nodes_v2.embedding),
                   owner_id=excluded.owner_id,
                   visibility=excluded.visibility,
-                  updated_at=excluded.updated_at
+                  updated_at=excluded.updated_at,
+                  style=COALESCE(excluded.style, nodes_v2.style),
+                  tone=COALESCE(excluded.tone, nodes_v2.tone),
+                  importance_score=MAX(excluded.importance_score, nodes_v2.importance_score),
+                  last_used=COALESCE(excluded.last_used, nodes_v2.last_used)
                 """,
                 (
                     node.id, node.type.value, node.label,
@@ -435,6 +477,8 @@ class KGStoreV2:
                     encode_embedding(node.embedding),
                     node.owner_id, node.visibility.value,
                     node.created_at, node.updated_at,
+                    node.style, node.tone,
+                    float(node.importance_score), node.last_used,
                 ),
             )
         return node.id
@@ -575,6 +619,7 @@ class KGStoreV2:
 
 # ── Row → model helpers ────────────────────────────────────────────────────
 def _row_to_node(row: sqlite3.Row) -> Node:
+    keys = row.keys() if hasattr(row, "keys") else []
     return Node(
         id=row["id"],
         type=NodeType(row["type"]),
@@ -585,6 +630,10 @@ def _row_to_node(row: sqlite3.Row) -> Node:
         visibility=Visibility(row["visibility"]),
         created_at=row["created_at"],
         updated_at=row["updated_at"],
+        style=row["style"] if "style" in keys else None,
+        tone=row["tone"] if "tone" in keys else None,
+        importance_score=float(row["importance_score"]) if "importance_score" in keys else 0.0,
+        last_used=row["last_used"] if "last_used" in keys else None,
     )