ltcai 0.1.4 → 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');
@@ -300,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 = {
@@ -431,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(() => ({}));
@@ -473,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';
                         }
                     });