ltcai 0.1.23 → 0.1.25

package/README.md

@@ -1,5 +1,5 @@
 <div align="center">
-  <img src="docs/images/logo.svg" alt="Lattice AI" width="280"/>
+  <img src="https://raw.githubusercontent.com/TaeSooPark-PTS/LatticeAI/main/docs/images/logo.svg" alt="Lattice AI" width="280"/>
   <br/>
   <strong>Your personal AI workspace server — local & cloud, one stack.</strong>
   <br/><br/>
@@ -7,7 +7,7 @@
 [![PyPI](https://img.shields.io/pypi/v/ltcai?label=PyPI&color=blue)](https://pypi.org/project/ltcai/)
 [![PyPI Downloads](https://img.shields.io/pypi/dm/ltcai?label=PyPI%20downloads)](https://pypi.org/project/ltcai/)
 [![npm](https://img.shields.io/npm/v/ltcai?label=npm)](https://www.npmjs.com/package/ltcai)
-[![VS Code](https://img.shields.io/badge/VS%20Code%20Marketplace-v0.1.23-blue?logo=visualstudiocode)](https://marketplace.visualstudio.com/items?itemName=parktaesoo.ltcai)
+[![VS Code](https://vsmarketplacebadges.dev/version-short/parktaesoo.ltcai.svg)](https://marketplace.visualstudio.com/items?itemName=parktaesoo.ltcai)
 [![Open VSX](https://img.shields.io/open-vsx/v/parktaesoo/ltcai?label=Open%20VSX)](https://open-vsx.org/extension/parktaesoo/ltcai)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green)](./LICENSE)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue)](https://www.python.org/)
@@ -32,9 +32,9 @@
 
 <table>
 <tr>
-<td width="33%"><b>Chat UI</b><br/><img src="docs/images/screenshot-chat.png" alt="Lattice AI Chat" width="100%"/></td>
-<td width="33%"><b>Admin Dashboard</b><br/><img src="docs/images/screenshot-admin.png" alt="Admin Dashboard" width="100%"/></td>
-<td width="33%"><b>Data Graph (Graph RAG)</b><br/><img src="docs/images/screenshot-graph.png" alt="Knowledge Graph" width="100%"/></td>
+<td width="33%"><b>Chat UI</b><br/><img src="https://raw.githubusercontent.com/TaeSooPark-PTS/LatticeAI/main/docs/images/screenshot-chat.png" alt="Lattice AI Chat" width="100%"/></td>
+<td width="33%"><b>Admin Dashboard</b><br/><img src="https://raw.githubusercontent.com/TaeSooPark-PTS/LatticeAI/main/docs/images/screenshot-admin.png" alt="Admin Dashboard" width="100%"/></td>
+<td width="33%"><b>Data Graph (Graph RAG)</b><br/><img src="https://raw.githubusercontent.com/TaeSooPark-PTS/LatticeAI/main/docs/images/screenshot-graph.png" alt="Knowledge Graph" width="100%"/></td>
 </tr>
 </table>
 
@@ -42,6 +42,8 @@
 
 ## ⚡ Quick Start (30 seconds)
 
+**Python / PyPI**
+
 ```bash
 # Install (cloud models)
 pip install ltcai
@@ -49,21 +51,43 @@ pip install ltcai
 # Install (+ Apple Silicon local models)
 pip install "ltcai[local]"
 
+# Verify environment
+LTCAI doctor
+
 # Start server
 LTCAI
 # → http://localhost:4825
+```
 
-# Start with public HTTPS tunnel (Cloudflare, no account needed)
-LTCAI --tunnel
-# → https://xxxx.trycloudflare.com
+**Node / npm**
+
+```bash
+npm install -g ltcai
+LTCAI doctor
+LTCAI
 ```
 
+**VS Code / Cursor**
+
+1. Install **Lattice AI** from [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=parktaesoo.ltcai) or [Open VSX](https://open-vsx.org/extension/parktaesoo/ltcai)
+2. Start the local server with `LTCAI`
+3. Run `Lattice AI: Open Chat` (`Cmd+Shift+A`) in your editor
+
 **First run:** open `http://localhost:4825` → sign up → first account auto-becomes admin → pick a model → start chatting.
 
+**Public HTTPS tunnel (Cloudflare, no account needed):**
+
+```bash
+LTCAI --tunnel
+# → https://xxxx.trycloudflare.com
+```
+
 ---
 
 ## 🆚 Why Lattice AI?
 
+Comparison is based on public product behavior as of 2026-05.
+
 | | Lattice AI | Open WebUI | Continue.dev | GitHub Copilot |
 |---|:---:|:---:|:---:|:---:|
 | Local model (offline, Apple Silicon) | ✅ | ✅ | ✅ | ❌ |
@@ -270,7 +294,7 @@ Or: `./start_ai.sh` (auto-restart + caffeinate)
 | 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.1.23** — [Changelog](docs/CHANGELOG.md)
+Current version: **0.1.25** — [Changelog](docs/CHANGELOG.md)
 
 ---
 

package/docs/CHANGELOG.md

@@ -1,5 +1,57 @@
 # Changelog
 
+## [0.1.25] - 2026-05-24
+
+### Knowledge Graph 전면 재설계 — 점=명사, 선=동사
+
+**설계 원칙**
+- **점(Node) = 명사** — 의미 있는 대상 (문서, 사람, 개념, 에러, 코드, 채팅 등)
+- **선(Edge) = 동사** — 대상 간의 관계 (언급함, 포함함, 해결함, 의존함 등)
+- 원본 데이터(PDF·PPT·채팅·코드 등)는 그대로 보관, AI가 핵심 개념을 추출해 점으로 만들고 관계를 선으로 연결
+
+**노드 타입 (점 = 명사)**
+- `Chat` — 대화 세션
+- `Document` — 파일 (PDF·PPT·Word·Excel·이미지)
+- `Concept` — 개념·아이디어·기술 용어
+- `Person` — 사람 (사용자, 언급된 인물)
+- `Error` — 오류·버그·예외
+- `Code` — 코드·함수·클래스
+- `Feature` — 소프트웨어 기능
+- `Task` — 할 일·액션 아이템
+- `Decision` — 결정 사항
+
+**엣지 어휘 (선 = 동사형)**
+`언급함` · `포함함` · `해결함` · `의존함` · `설명함` · `비교함` · `사용함` · `연결함` · `확장함` · `생성함` · `대체함` · `지원함` · `발생함` · `관련됨` · `작성함` · `업로드함`
+
+**핵심 개선**
+- `_extract_concepts()` — 고유명사·복합어·기술 용어 추출 (Lattice AI, Graph RAG, VS Code 등)
+- `_classify_node_type()` — 개념별 노드 타입 자동 분류 (윈도우 컨텍스트 기반)
+- `_infer_edge()` — 문장 내 동사·조사 패턴으로 엣지 레이블 자동 결정
+- `_extract_triples()` — 문장 단위 개념 쌍 → (주어, 동사, 목적어) 트리플 추출
+- `ingest_message()` 재설계 — 메시지 단위 → 대화 세션(Chat) 단위 노드
+- `ingest_document()` 재설계 — Document 노드 + 동사형 엣지 (포함함, 업로드함)
+- 중복 제거 — 하위 개념이 상위 복합어에 완전히 흡수될 때만 제거
+- Message·AIResponse·Chunk 노드는 RAG 검색용으로만 저장, 그래프 비표시
+
+### Release
+- 배포 버전을 `0.1.25`로 상향
+- 대상 채널: `npm` · `PyPI` · `VS Code Marketplace` · `Open VSX`
+
+## [0.1.24] - 2026-05-24
+
+### 안정화 및 UX 개선
+
+- **로컬 파일 인증 강화** — `/local/list` · `/local/read` · `/local/write` · `/local/serve`에서 로그인 세션 필수화 (`_require_local_user` 헬퍼 도입)
+- **`GET /local/list` 라우트 추가** — smoke-test 및 브라우저 직접 호출 호환
+- **VS Code 배지 수정** — shields.io `visual-studio-marketplace` 폐기 → `vsmarketplacebadges.dev`로 전환
+- **README 이미지 URL 안정화** — 로고·스크린샷을 `raw.githubusercontent.com` 절대 URL로 전환해 PyPI / npm / Marketplace 페이지에서도 표시
+- **Quick Start 분리** — PyPI / npm / VS Code 사용자의 첫 설치 경로를 각각 명확히 안내
+- **GitHub Actions Node 24** — CI 런타임을 Node 24로 업그레이드
+
+### Release
+- 배포 버전을 `0.1.24`로 상향
+- 대상 채널: `npm` · `PyPI` · `VS Code Marketplace` · `Open VSX`
+
 ## [0.1.23] - 2026-05-24
 
 ### Discord 권한 알림 시스템
@@ -19,12 +71,22 @@
 - **영어 README** 전면 재작성 — 한국어는 접을 수 있는 `<details>` 섹션으로 이동
 - **SVG 로고** 추가 (`docs/images/logo.svg`)
 - **경쟁 제품 비교표** — Lattice AI vs Open WebUI · Continue.dev · GitHub Copilot
+- **Quick Start 분리** — PyPI / npm / VS Code 사용자의 첫 설치 경로를 각각 명확히 안내
+- **비교표 기준 명시** — 공개 제품 동작 기준 시점을 README에 표기
+- **패키지 페이지 이미지 안정화** — README 이미지 URL을 GitHub raw URL로 전환해 PyPI / npm / Marketplace에서도 표시되도록 개선
+- **npm 패키지 정리** — 배포 tarball에서 테스트/캐시 파일 제외
 - **실제 UI 스크린샷 3장** — Chat UI · Admin Dashboard · Data Graph (Playwright 2x 캡처)
 - **VS Code 익스텐션 카테고리** `Other` → `AI, Machine Learning, Chat, Other`
 - **VS Code 익스텐션 키워드** 8개 → 16개 (copilot, apple-silicon, groq, graph-rag 등)
 - **VS Code 익스텐션 README** 전면 재작성 (기능표, 비교표, 모델 목록)
 - 구버전 `.tgz` / `.vsix` 빌드 파일 삭제
 
+### CI / 보안 안정화
+
+- `/local/list` `GET` smoke-test 호환 라우트 추가
+- `/local/list`, `/local/read`, `/local/write`, `/local/serve`는 로컬 개발 모드에서도 로그인 세션을 요구하도록 강화
+- GitHub Actions integration smoke test 실패 원인 수정
+
 ### Release
 - 배포 버전을 `0.1.23`으로 상향
 - 대상 채널: `npm` · `PyPI` · `VS Code Marketplace` · `Open VSX`