ltcai 0.1.3 → 0.1.8

package/skills/SKILL_TEMPLATE.md

@@ -0,0 +1,57 @@
+# Skill: <name>
+
+## 메타데이터
+- **버전**: 0.1.0
+- **카테고리**: [coding | data | document | web | system | analysis]
+- **위험도**: [low | medium | high]  <!-- low=읽기, medium=쓰기, high=실행/삭제 -->
+- **필요 권한**: [none | local_read | local_write | exec | admin]
+
+## 설명
+한 줄 설명.
+
+## 입력 스키마
+```json
+{
+  "required": ["field1"],
+  "optional": ["field2"],
+  "properties": {
+    "field1": { "type": "string", "description": "..." },
+    "field2": { "type": "integer", "default": 10 }
+  }
+}
+```
+
+## 출력 스키마
+```json
+{
+  "success": true,
+  "result": "...",
+  "artifacts": []
+}
+```
+
+## 실행 조건
+- 사전 조건 (예: 모델 로드 필요, 파일 존재 여부)
+- 후처리 조건
+
+## 예제
+
+### 성공 케이스
+**입력**: `{ "field1": "예시값" }`  
+**출력**: `{ "success": true, "result": "..." }`
+
+### 실패 케이스
+**입력**: `{ "field1": "" }`  
+**출력**: `{ "success": false, "error": "field1 is required" }`
+
+## 실패 처리
+| 에러 코드 | 원인 | 처리 방법 |
+|-----------|------|-----------|
+| `INVALID_INPUT` | 필수 필드 누락 | 입력 검증 후 재시도 |
+| `PERMISSION_DENIED` | 권한 없음 | 관리자에게 문의 |
+| `TIMEOUT` | 실행 시간 초과 | 작업 분할 후 재시도 |
+
+## 테스트 케이스
+```python
+# tests/skills/test_<name>.py 참조
+```

package/skills/code_review/SKILL.md

@@ -0,0 +1,76 @@
+# Skill: code_review
+
+## 메타데이터
+- **버전**: 0.1.0
+- **카테고리**: coding
+- **위험도**: low
+- **필요 권한**: local_read
+
+## 설명
+파일 또는 코드 스니펫을 LLM에 전달해 버그, 보안 이슈, 성능, 스타일을 리뷰한다.
+
+## 입력 스키마
+```json
+{
+  "required": ["target"],
+  "optional": ["focus", "lang", "max_lines"],
+  "properties": {
+    "target":    { "type": "string", "description": "절대 파일 경로 또는 코드 스니펫 문자열" },
+    "focus":     { "type": "array",  "items": { "type": "string", "enum": ["bug", "security", "performance", "style"] }, "default": ["bug", "security"], "description": "리뷰 초점 목록" },
+    "lang":      { "type": "string", "description": "언어 힌트 (python, js, go …). 미입력시 자동 감지" },
+    "max_lines": { "type": "integer", "default": 500, "description": "분석할 최대 줄 수" }
+  }
+}
+```
+
+## 출력 스키마
+```json
+{
+  "success": true,
+  "result": {
+    "summary": "...",
+    "issues": [
+      { "severity": "high|medium|low", "line": 42, "category": "security", "message": "..." }
+    ],
+    "score": 85
+  }
+}
+```
+
+## 실행 조건
+- LLM 모델이 로드되어 있어야 함 (`/mode` 응답의 `model` 필드 비어있지 않음)
+- 파일 대상인 경우 파일이 존재해야 함
+
+## 예제
+
+### 성공 케이스
+**입력**: `{ "target": "~/project/server.py", "focus": ["security"] }`
+**출력**:
+```json
+{
+  "success": true,
+  "result": {
+    "summary": "1개의 심각한 보안 이슈 발견",
+    "issues": [{ "severity": "high", "line": 102, "category": "security", "message": "SQL 쿼리에 사용자 입력이 직접 삽입됨" }],
+    "score": 60
+  }
+}
+```
+
+### 실패 케이스
+**입력**: `{ "target": "" }`
+**출력**: `{ "success": false, "error": "INVALID_INPUT", "message": "target is required" }`
+
+## 실패 처리
+| 에러 코드 | 원인 | 처리 방법 |
+|-----------|------|-----------|
+| `INVALID_INPUT` | target 비어 있음 | 파일 경로 또는 코드 입력 |
+| `FILE_NOT_FOUND` | 파일 경로 존재하지 않음 | 경로 확인 |
+| `MODEL_NOT_LOADED` | LLM 미로드 | `/model` 명령으로 모델 선택 |
+| `SIZE_LIMIT` | max_lines 초과 파일 | max_lines 값 조정 또는 파일 분할 |
+
+## 테스트 케이스
+```python
+# tests/unit/test_tools.py::test_code_review_snippet
+# tests/integration/test_api.py::test_agent_code_review_file
+```

package/skills/data_analysis/SKILL.md

@@ -0,0 +1,79 @@
+# Skill: data_analysis
+
+## 메타데이터
+- **버전**: 0.1.0
+- **카테고리**: data
+- **위험도**: low
+- **필요 권한**: local_read
+
+## 설명
+CSV/Excel/JSON 파일을 읽어 기초 통계, 컬럼 요약, 이상치 탐지를 수행하고 인사이트를 제공한다.
+
+## 입력 스키마
+```json
+{
+  "required": ["path"],
+  "optional": ["columns", "analysis_type", "max_rows"],
+  "properties": {
+    "path":          { "type": "string", "description": "분석할 파일 절대 경로 (.csv, .xlsx, .json)" },
+    "columns":       { "type": "array",  "items": { "type": "string" }, "description": "분석할 컬럼 목록. 미입력시 전체" },
+    "analysis_type": { "type": "array",  "items": { "type": "string", "enum": ["summary", "outlier", "correlation", "trend"] }, "default": ["summary"], "description": "수행할 분석 유형" },
+    "max_rows":      { "type": "integer", "default": 10000, "description": "처리할 최대 행 수" }
+  }
+}
+```
+
+## 출력 스키마
+```json
+{
+  "success": true,
+  "result": {
+    "shape": [100, 5],
+    "columns": ["col1", "col2"],
+    "summary": { "col1": { "mean": 42.0, "std": 3.1, "min": 10, "max": 99 } },
+    "outliers": { "col1": [99, 10] },
+    "insights": "..."
+  }
+}
+```
+
+## 실행 조건
+- pandas, openpyxl 패키지 설치 필요 (requirements.txt 포함)
+- 파일이 존재해야 하며 .csv/.xlsx/.json 형식이어야 함
+
+## 예제
+
+### 성공 케이스
+**입력**: `{ "path": "~/data/sales.csv", "analysis_type": ["summary", "outlier"] }`
+**출력**:
+```json
+{
+  "success": true,
+  "result": {
+    "shape": [500, 4],
+    "columns": ["date", "revenue", "units", "region"],
+    "summary": { "revenue": { "mean": 15000.0, "std": 4200.0, "min": 200, "max": 89000 } },
+    "outliers": { "revenue": [89000] },
+    "insights": "revenue 컬럼에서 1개의 이상치(89000) 발견. 평균 대비 17.6 표준편차."
+  }
+}
+```
+
+### 실패 케이스
+**입력**: `{ "path": "~/data/photo.png" }`
+**출력**: `{ "success": false, "error": "UNSUPPORTED_FORMAT", "message": "Supported formats: csv, xlsx, json" }`
+
+## 실패 처리
+| 에러 코드 | 원인 | 처리 방법 |
+|-----------|------|-----------|
+| `INVALID_INPUT` | path 누락 | 파일 경로 입력 |
+| `FILE_NOT_FOUND` | 경로에 파일 없음 | 경로 확인 |
+| `UNSUPPORTED_FORMAT` | csv/xlsx/json 이외 형식 | 지원 형식으로 변환 후 재시도 |
+| `PARSE_ERROR` | 파일 파싱 실패 | 파일 인코딩/형식 확인 |
+| `SIZE_LIMIT` | max_rows 초과 | max_rows 값 조정 |
+
+## 테스트 케이스
+```python
+# tests/unit/test_tools.py::test_data_analysis_csv_summary
+# tests/unit/test_tools.py::test_data_analysis_unsupported_format
+```

package/skills/file_edit/SKILL.md

@@ -0,0 +1,68 @@
+# Skill: file_edit
+
+## 메타데이터
+- **버전**: 0.1.0
+- **카테고리**: system
+- **위험도**: medium
+- **필요 권한**: local_write
+
+## 설명
+로컬 파일을 읽고 특정 범위를 편집한 뒤 저장한다. 원본 백업을 `.bak` 파일로 생성한다.
+
+## 입력 스키마
+```json
+{
+  "required": ["path", "new_content"],
+  "optional": ["start_line", "end_line", "backup"],
+  "properties": {
+    "path":        { "type": "string",  "description": "절대 경로 또는 ~/로 시작하는 경로" },
+    "new_content": { "type": "string",  "description": "교체할 새 내용" },
+    "start_line":  { "type": "integer", "description": "편집 시작 줄 번호 (1-indexed). 없으면 전체 교체" },
+    "end_line":    { "type": "integer", "description": "편집 종료 줄 번호 (포함). 없으면 start_line 단일 줄" },
+    "backup":      { "type": "boolean", "default": true, "description": "false면 .bak 파일 생성 생략" }
+  }
+}
+```
+
+## 출력 스키마
+```json
+{
+  "success": true,
+  "result": {
+    "path": "...",
+    "lines_changed": 3,
+    "backup_path": "....bak"
+  }
+}
+```
+
+## 실행 조건
+- 대상 파일이 존재해야 함
+- BINARY_EXTS(png, jpg, zip 등) 파일은 거부
+- 파일 크기 10 MB 이하
+
+## 예제
+
+### 성공 케이스
+**입력**: `{ "path": "~/project/config.py", "new_content": "DEBUG = False\n", "start_line": 5, "end_line": 5 }`
+**출력**: `{ "success": true, "result": { "path": "...", "lines_changed": 1, "backup_path": "...config.py.bak" } }`
+
+### 실패 케이스
+**입력**: `{ "path": "~/photo.png", "new_content": "..." }`
+**출력**: `{ "success": false, "error": "BINARY_FILE", "message": "Binary files cannot be edited as text" }`
+
+## 실패 처리
+| 에러 코드 | 원인 | 처리 방법 |
+|-----------|------|-----------|
+| `INVALID_INPUT` | path 또는 new_content 누락 | 필드 확인 후 재시도 |
+| `FILE_NOT_FOUND` | 경로에 파일 없음 | 경로 확인 |
+| `BINARY_FILE` | 바이너리 파일 편집 시도 | 텍스트 파일만 지원 |
+| `PERMISSION_DENIED` | 파일 쓰기 권한 없음 | 관리자 권한 확인 |
+| `SIZE_LIMIT` | 파일 10 MB 초과 | 파일 분할 후 재시도 |
+
+## 테스트 케이스
+```python
+# tests/unit/test_tools.py::test_file_edit_full_replace
+# tests/unit/test_tools.py::test_file_edit_line_range
+# tests/unit/test_tools.py::test_file_edit_binary_rejected
+```

package/skills/web_search/SKILL.md

@@ -0,0 +1,74 @@
+# Skill: web_search
+
+## 메타데이터
+- **버전**: 0.1.0
+- **카테고리**: web
+- **위험도**: low
+- **필요 권한**: none
+
+## 설명
+외부 검색 엔진(DuckDuckGo/Brave)을 통해 웹 검색을 수행하고 상위 결과를 반환한다.
+
+## 입력 스키마
+```json
+{
+  "required": ["query"],
+  "optional": ["num_results", "lang"],
+  "properties": {
+    "query":       { "type": "string",  "description": "검색어" },
+    "num_results": { "type": "integer", "default": 5, "description": "반환할 결과 수 (1-20)" },
+    "lang":        { "type": "string",  "default": "ko-KR", "description": "검색 언어 로케일" }
+  }
+}
+```
+
+## 출력 스키마
+```json
+{
+  "success": true,
+  "result": {
+    "query": "...",
+    "results": [
+      { "title": "...", "url": "...", "snippet": "..." }
+    ]
+  }
+}
+```
+
+## 실행 조건
+- 네트워크 연결 필요
+- 외부 API 키 불필요 (DuckDuckGo instant answer API 사용)
+
+## 예제
+
+### 성공 케이스
+**입력**: `{ "query": "FastAPI 비동기 처리", "num_results": 3 }`
+**출력**:
+```json
+{
+  "success": true,
+  "result": {
+    "query": "FastAPI 비동기 처리",
+    "results": [
+      { "title": "FastAPI - Async", "url": "https://fastapi.tiangolo.com/async/", "snippet": "..." }
+    ]
+  }
+}
+```
+
+### 실패 케이스
+**입력**: `{ "query": "" }`
+**출력**: `{ "success": false, "error": "INVALID_INPUT", "message": "query is required" }`
+
+## 실패 처리
+| 에러 코드 | 원인 | 처리 방법 |
+|-----------|------|-----------|
+| `INVALID_INPUT` | query 비어 있음 | 검색어 입력 후 재시도 |
+| `NETWORK_ERROR` | 외부 API 연결 실패 | 잠시 후 재시도 |
+| `TIMEOUT` | 5초 초과 | 검색어 단순화 후 재시도 |
+
+## 테스트 케이스
+```python
+# tests/unit/test_tools.py::test_web_search_returns_results
+# tests/integration/test_api.py::test_agent_web_search
+```

package/static/account.html

@@ -2,8 +2,13 @@
 <html lang="ko">
 <head>
     <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover">
     <title>Lattice AI</title>
+    <link rel="manifest" href="/manifest.json">
+    <meta name="theme-color" content="#2d5a3d">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <link rel="apple-touch-icon" href="/icons/apple-touch-icon.png">
+    <link rel="icon" type="image/png" sizes="32x32" href="/icons/favicon-32.png">
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@tabler/icons-webfont@latest/tabler-icons.min.css">
     <style>
         @import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&display=swap');
@@ -164,6 +169,34 @@
         .switch a { color: var(--accent); text-decoration: none; font-weight: 700; }
         .switch a:hover { text-decoration: underline; }
 
+        .sso-divider {
+            display: flex; align-items: center; gap: 10px;
+            margin: 14px 0 10px;
+            color: var(--faint); font-size: 11.5px;
+        }
+        .sso-divider::before, .sso-divider::after {
+            content: ''; flex: 1;
+            height: 1px; background: rgba(255,255,255,0.07);
+        }
+        .sso-btn {
+            width: 100%;
+            padding: 12px;
+            background: rgba(255,255,255,0.04);
+            border: 1px solid rgba(255,255,255,0.1);
+            color: var(--text);
+            border-radius: 10px;
+            cursor: pointer;
+            font-weight: 600;
+            font-size: 13.5px;
+            font-family: inherit;
+            display: flex; align-items: center; justify-content: center; gap: 8px;
+            transition: all .18s;
+        }
+        .sso-btn:hover {
+            background: rgba(255,255,255,0.08);
+            border-color: rgba(34,211,160,0.3);
+        }
+
         .msg {
             font-size: 12px;
             min-height: 18px;
@@ -238,6 +271,13 @@
             <input class="input" type="password" id="login-pw" placeholder="비밀번호" onkeydown="if(event.key==='Enter')doLogin()">
             <div class="msg" id="login-msg"></div>
             <button class="submit" id="login-btn" onclick="doLogin()" data-ko="로그인" data-en="Log in">로그인</button>
+            <div id="sso-section" style="display:none;">
+                <div class="sso-divider" id="sso-divider-text">또는</div>
+                <button class="sso-btn" id="sso-btn" onclick="doSSOLogin()">
+                    <i class="ti ti-building"></i>
+                    <span id="sso-btn-label">SSO로 로그인</span>
+                </button>
+            </div>
             <p class="switch" id="login-switch">
                 <span id="no-account-text">계정이 없으신가요?</span>
                 <a href="#" onclick="showSection('register');return false;" id="go-register-link">회원가입</a>
@@ -265,7 +305,12 @@
 
     <script>
         const API_BASE = window.location.protocol === 'file:' ? 'http://localhost:4825' : '';
-        function apiFetch(path, opts = {}) { return fetch(API_BASE + path, opts); }
+        function apiFetch(path, opts = {}) {
+            const headers = { ...(opts.headers || {}) };
+            const token = localStorage.getItem('ltcai_session_token') || '';
+            if (token && !headers.Authorization) headers.Authorization = `Bearer ${token}`;
+            return fetch(API_BASE + path, { credentials: 'include', ...opts, headers });
+        }
 
         // ── i18n ──────────────────────────────────────────────
         const I18N = {
@@ -281,6 +326,7 @@
                 err_fill: '모든 항목을 입력해주세요.',
                 err_login_fail: '이메일 또는 비밀번호가 틀렸습니다.',
                 err_server: '서버 연결 실패',
+                sso_divider: '또는', sso_btn: '로 로그인',
             },
             en: {
                 login_title: 'Lattice AI', login_sub: 'Local AI Workspace — Apple Silicon',
@@ -294,6 +340,7 @@
                 err_fill: 'Please fill in all fields.',
                 err_login_fail: 'Invalid email or password.',
                 err_server: 'Server connection failed',
+                sso_divider: 'or', sso_btn: 'Sign in with',
             }
         };
 
@@ -319,12 +366,33 @@
             document.getElementById('reg-name').placeholder = t('ph_name');
             document.getElementById('reg-nick').placeholder = t('ph_nick');
             document.getElementById('lang-label').textContent = lang === 'ko' ? '한국어' : 'English';
+            document.getElementById('sso-divider-text').textContent = t('sso_divider');
+            const ssoName = window._ssoProviderName || 'SSO';
+            document.getElementById('sso-btn-label').textContent =
+                lang === 'ko' ? `${ssoName}${t('sso_btn')}` : `${t('sso_btn')} ${ssoName}`;
             ['ko', 'en'].forEach(l => {
                 const el = document.getElementById(`opt-${l}`);
                 if (el) el.classList.toggle('active', l === lang);
             });
         }
 
+        async function initSSO() {
+            try {
+                const res = await apiFetch('/auth/sso/config');
+                if (!res.ok) return;
+                const cfg = await res.json();
+                if (cfg.enabled) {
+                    window._ssoProviderName = cfg.provider_name;
+                    document.getElementById('sso-section').style.display = '';
+                    applyI18n();
+                }
+            } catch {}
+        }
+
+        function doSSOLogin() {
+            window.location.href = '/auth/sso/login';
+        }
+
         function toggleLang() {
             const m = document.getElementById('lang-menu');
             m.classList.toggle('open');
@@ -373,6 +441,7 @@
                     localStorage.setItem('ltcai_user_email', data.email);
                     localStorage.setItem('ltcai_user_nickname', data.nickname || data.name || data.email);
                     localStorage.setItem('ltcai_is_admin', data.is_admin ? 'true' : 'false');
+                    if (data.token) localStorage.setItem('ltcai_session_token', data.token);
                     window.location.href = '/chat';
                 } else {
                     const data = await res.json().catch(() => ({}));
@@ -415,6 +484,7 @@
                             localStorage.setItem('ltcai_user_email', data.email);
                             localStorage.setItem('ltcai_user_nickname', data.nickname || data.name || data.email);
                             localStorage.setItem('ltcai_is_admin', data.is_admin ? 'true' : 'false');
+                            if (data.token) localStorage.setItem('ltcai_session_token', data.token);
                             window.location.href = '/chat';
                         }
                     });
@@ -436,6 +506,8 @@
             if (r.ok) window.location.href = '/chat';
         }).catch(() => {});
 
+        initSSO();
+
         // Handle invite code in URL
         const urlCode = new URLSearchParams(window.location.search).get('code');
         if (urlCode) {