ltcai 0.1.9 → 0.1.16

package/skills/summarize_document/SKILL.md

@@ -0,0 +1,68 @@
+# Skill: summarize_document
+
+## 메타데이터
+- **버전**: 0.1.0
+- **카테고리**: document
+- **위험도**: low
+- **필요 권한**: local_read
+
+## 설명
+텍스트 파일(.txt, .md, .pdf, .docx)을 읽어 핵심 내용을 요약하고, 섹션별 요점과 키워드를 추출한다.
+
+## 거버넌스
+
+`risk.json` 참고. 요약: `risk=read`, `destructive=false`, `shell=false`, `network=false`, `auto_approve=true`, `sandbox=home`, `rollback=none`
+
+## 트리거 조건
+
+호출해야 하는 상황:
+- 사용자가 "이 문서 요약해줘", "핵심만 뽑아줘", "이 파일 내용이 뭐야?"라고 요청할 때
+- 에이전트가 Discover 단계에서 긴 문서의 구조를 빠르게 파악해야 할 때
+- 여러 문서를 비교하기 전 각 문서의 핵심 파악이 필요할 때
+
+호출하면 **안** 되는 상황:
+- 문서를 수정해야 할 때 → `edit_file` 사용
+- CSV/Excel 데이터 분석 → `data_analysis` 사용
+- 코드 파일 분석 → `code_review` 사용
+
+## Side Effects
+
+| 항목 | 내용 |
+|------|------|
+| 파일 변경 | 없음 |
+| 생성 파일 | 없음 |
+| 프로세스 | 없음 |
+| 네트워크 | 없음 |
+
+## Rollback
+
+없음. 읽기 전용 작업.
+
+## 입력 스키마
+`schema.json` 참고.
+
+## 출력 스키마
+`schema.json` 참고.
+
+## 실행 조건
+- LLM 모델이 로드되어 있어야 함
+- 파일이 존재해야 하며 .txt/.md/.pdf/.docx 형식이어야 함
+- 파일 크기 20 MB 이하
+
+## 예제
+`examples.md` 참고.
+
+## 실패 처리
+| 에러 코드 | 원인 | 처리 방법 |
+|-----------|------|-----------|
+| `INVALID_INPUT` | path 누락 | 파일 경로 입력 |
+| `FILE_NOT_FOUND` | 경로에 파일 없음 | 경로 확인 |
+| `UNSUPPORTED_FORMAT` | 지원하지 않는 형식 | .txt/.md/.pdf/.docx로 변환 후 재시도 |
+| `SIZE_LIMIT` | 20 MB 초과 | 파일 분할 후 재시도 |
+| `MODEL_NOT_LOADED` | LLM 미로드 | `/model` 명령으로 모델 선택 |
+
+## 테스트 케이스
+```python
+# tests/unit/test_tools.py::test_summarize_document_md
+# tests/unit/test_tools.py::test_summarize_document_unsupported
+```

package/skills/summarize_document/examples.md

@@ -0,0 +1,65 @@
+# summarize_document — Examples
+
+## 1. Markdown file summary (success)
+
+**Input**
+```json
+{ "path": "~/project/README.md", "style": "bullet" }
+```
+**Output**
+```json
+{
+  "success": true,
+  "result": {
+    "title": "README.md",
+    "summary": "• Lattice AI는 Apple Silicon 기반 로컬 AI 에이전트\n• FastAPI 서버 + VS Code 익스텐션 + Telegram bot 구조\n• MLX 및 클라우드 모델(OpenAI/Groq) 지원",
+    "keywords": ["Lattice AI", "MLX", "FastAPI", "VS Code", "Telegram", "local LLM"],
+    "sections": [
+      { "heading": "Installation", "summary": "pip install ltcai 후 ltcai start로 실행" },
+      { "heading": "Features", "summary": "채팅, 에이전트 모드, 파일 편집, 웹 검색 등 지원" }
+    ],
+    "word_count": 1240
+  }
+}
+```
+
+## 2. PDF summary with focus section (success)
+
+**Input**
+```json
+{ "path": "~/docs/report.pdf", "style": "paragraph", "focus_sections": ["결론", "권고사항"], "max_length": 300 }
+```
+**Output**
+```json
+{
+  "success": true,
+  "result": {
+    "title": "report.pdf",
+    "summary": "보고서의 결론: 시스템 성능이 전분기 대비 23% 향상되었으며, 추가 최적화를 위해 캐시 레이어 도입이 권고됩니다.",
+    "keywords": ["성능", "최적화", "캐시", "권고"],
+    "word_count": 8500
+  }
+}
+```
+
+## 3. Unsupported format (failure)
+
+**Input**
+```json
+{ "path": "~/data/sales.csv" }
+```
+**Output**
+```json
+{ "success": false, "error": "UNSUPPORTED_FORMAT", "message": "Supported formats: txt, md, pdf, docx. Use data_analysis for CSV files." }
+```
+
+## 4. File not found (failure)
+
+**Input**
+```json
+{ "path": "~/docs/nonexistent.md" }
+```
+**Output**
+```json
+{ "success": false, "error": "FILE_NOT_FOUND", "message": "No such file: /home/user/docs/nonexistent.md" }
+```

package/skills/summarize_document/risk.json

@@ -0,0 +1,9 @@
+{
+  "risk": "read",
+  "destructive": false,
+  "shell": false,
+  "network": false,
+  "auto_approve": true,
+  "sandbox": "home",
+  "rollback": "none"
+}

package/skills/summarize_document/schema.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "summarize_document",
+  "input": {
+    "required": ["path"],
+    "optional": ["max_length", "style", "focus_sections"],
+    "properties": {
+      "path":           { "type": "string", "description": "절대 경로 또는 ~/로 시작하는 경로 (.txt, .md, .pdf, .docx)" },
+      "max_length":     { "type": "integer", "default": 500, "description": "요약 최대 글자 수" },
+      "style":          { "type": "string", "enum": ["bullet","paragraph","table"], "default": "bullet", "description": "출력 형식" },
+      "focus_sections": { "type": "array", "items": { "type": "string" }, "description": "특정 섹션만 요약할 때 섹션 제목 목록" }
+    }
+  },
+  "output": {
+    "oneOf": [
+      {
+        "title": "success",
+        "properties": {
+          "success": { "const": true },
+          "result": {
+            "properties": {
+              "title":    { "type": "string", "description": "문서 제목 또는 파일명" },
+              "summary":  { "type": "string", "description": "핵심 요약" },
+              "keywords": { "type": "array", "items": { "type": "string" }, "description": "주요 키워드 (최대 10개)" },
+              "sections": {
+                "type": "array",
+                "items": {
+                  "properties": {
+                    "heading": { "type": "string" },
+                    "summary": { "type": "string" }
+                  },
+                  "required": ["heading","summary"]
+                },
+                "description": "섹션별 요약 (있는 경우)"
+              },
+              "word_count": { "type": "integer" }
+            },
+            "required": ["title","summary","keywords"]
+          }
+        },
+        "required": ["success","result"]
+      },
+      {
+        "title": "failure",
+        "properties": {
+          "success": { "const": false },
+          "error":   { "type": "string", "enum": ["INVALID_INPUT","FILE_NOT_FOUND","UNSUPPORTED_FORMAT","SIZE_LIMIT","MODEL_NOT_LOADED"] },
+          "message": { "type": "string" }
+        },
+        "required": ["success","error","message"]
+      }
+    ]
+  },
+  "evals": [
+    {
+      "id": "markdown_summary",
+      "input": { "path": "__TEST__/README.md", "style": "bullet" },
+      "pass_criteria": "success == true and len(keywords) >= 1"
+    },
+    {
+      "id": "unsupported_format",
+      "input": { "path": "__TEST__/data.csv" },
+      "pass_criteria": "error == UNSUPPORTED_FORMAT"
+    },
+    {
+      "id": "missing_path",
+      "input": {},
+      "pass_criteria": "error == INVALID_INPUT"
+    }
+  ]
+}

package/skills/web_search/SKILL.md

@@ -9,6 +9,34 @@
 ## 설명
 외부 검색 엔진(DuckDuckGo/Brave)을 통해 웹 검색을 수행하고 상위 결과를 반환한다.
 
+## 거버넌스
+
+`policies/policy.md` 참고. 요약: `risk=read`, `destructive=false`, `shell=false`, `network=true`, `auto_approve=true`, `sandbox=system`, `rollback=none`
+
+## 트리거 조건
+
+호출해야 하는 상황:
+- 사용자가 "검색해줘", "찾아봐줘", "최신 정보 알려줘"라고 요청할 때
+- 에이전트가 Discover 단계에서 외부 문서/API/라이브러리 정보를 수집해야 할 때
+- LLM의 학습 데이터 이후 최신 정보(라이브러리 버전, 뉴스 등)가 필요할 때
+
+호출하면 **안** 되는 상황:
+- 로컬 파일 내용 검색 시 → `grep` 사용
+- LLM이 이미 알고 있는 일반 지식 질문 시
+
+## Side Effects
+
+| 항목 | 내용 |
+|------|------|
+| 파일 변경 | 없음 |
+| 생성 파일 | 없음 |
+| 프로세스 | 없음 |
+| 네트워크 | 외부 검색 API로 검색어 전송 (DuckDuckGo/Brave) |
+
+## Rollback
+
+없음. 읽기 전용 네트워크 요청.
+
 ## 입력 스키마
 ```json
 {

package/skills/web_search/examples.md

@@ -0,0 +1,61 @@
+# web_search — Examples
+
+## 1. Basic search (success)
+
+**Input**
+```json
+{ "query": "FastAPI 비동기 처리", "num_results": 3 }
+```
+**Output**
+```json
+{
+  "success": true,
+  "result": {
+    "query": "FastAPI 비동기 처리",
+    "results": [
+      { "title": "FastAPI - Async", "url": "https://fastapi.tiangolo.com/async/", "snippet": "FastAPI는 Python의 asyncio를 완벽히 지원합니다..." }
+    ]
+  }
+}
+```
+
+## 2. Search with language (success)
+
+**Input**
+```json
+{ "query": "Python type hints best practices", "num_results": 5, "lang": "en-US" }
+```
+**Output**
+```json
+{
+  "success": true,
+  "result": {
+    "query": "Python type hints best practices",
+    "results": [
+      { "title": "PEP 484 – Type Hints", "url": "https://peps.python.org/pep-0484/", "snippet": "This PEP introduces a standard syntax for type annotations..." }
+    ]
+  }
+}
+```
+
+## 3. Empty query (failure)
+
+**Input**
+```json
+{ "query": "" }
+```
+**Output**
+```json
+{ "success": false, "error": "INVALID_INPUT", "message": "query is required" }
+```
+
+## 4. Network error (failure)
+
+**Input**
+```json
+{ "query": "offline test" }
+```
+**Output**
+```json
+{ "success": false, "error": "NETWORK_ERROR", "message": "외부 검색 API에 연결할 수 없습니다. 잠시 후 재시도하세요." }
+```

package/skills/web_search/risk.json

@@ -0,0 +1,9 @@
+{
+  "risk": "read",
+  "destructive": false,
+  "shell": false,
+  "network": true,
+  "auto_approve": true,
+  "sandbox": "system",
+  "rollback": "none"
+}

package/skills/web_search/schema.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "web_search",
+  "input": {
+    "required": ["query"],
+    "optional": ["num_results", "lang"],
+    "properties": {
+      "query":       { "type": "string", "description": "검색어" },
+      "num_results": { "type": "integer", "default": 5, "minimum": 1, "maximum": 20 },
+      "lang":        { "type": "string", "default": "ko-KR" }
+    }
+  },
+  "output": {
+    "oneOf": [
+      {
+        "title": "success",
+        "properties": {
+          "success": { "const": true },
+          "result": {
+            "properties": {
+              "query":   { "type": "string" },
+              "results": {
+                "type": "array",
+                "items": {
+                  "properties": {
+                    "title":   { "type": "string" },
+                    "url":     { "type": "string", "format": "uri" },
+                    "snippet": { "type": "string" }
+                  },
+                  "required": ["title","url","snippet"]
+                }
+              }
+            },
+            "required": ["query","results"]
+          }
+        },
+        "required": ["success","result"]
+      },
+      {
+        "title": "failure",
+        "properties": {
+          "success": { "const": false },
+          "error":   { "type": "string", "enum": ["INVALID_INPUT","NETWORK_ERROR","TIMEOUT"] },
+          "message": { "type": "string" }
+        },
+        "required": ["success","error","message"]
+      }
+    ]
+  },
+  "evals": [
+    {
+      "id": "basic_search",
+      "input": { "query": "FastAPI async", "num_results": 3 },
+      "pass_criteria": "success == true and len(results) >= 1"
+    },
+    {
+      "id": "empty_query",
+      "input": { "query": "" },
+      "pass_criteria": "error == INVALID_INPUT"
+    }
+  ]
+}

package/static/account.html

@@ -5,7 +5,7 @@
     <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="theme-color" content="#282a36">
     <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">
@@ -14,11 +14,13 @@
         @import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&display=swap');
 
         :root {
-            --bg: #080c0a;
-            --text: #f3f1e8;
-            --faint: #7c8078;
-            --accent: #22d3a0;
-            --shadow: 0 24px 70px rgba(0,0,0,0.5);
+            --bg: #282a36;
+            --text: #f7f7f2;
+            --faint: #8d93ab;
+            --muted: #c4c8d8;
+            --accent: #a77cff;
+            --accent-2: #20b8aa;
+            --shadow: 0 24px 70px rgba(5,7,12,0.46);
         }
 
         * { box-sizing: border-box; margin: 0; padding: 0; }
@@ -27,8 +29,9 @@
             font-family: Inter, -apple-system, BlinkMacSystemFont, sans-serif;
             color: var(--text);
             background:
-                linear-gradient(180deg, rgba(255,255,255,0.012), transparent 28%),
-                linear-gradient(135deg, #080c0a 0%, #060a08 52%, #0a0d09 100%);
+                radial-gradient(circle at 50% 35%, rgba(167,124,255,0.16), transparent 34%),
+                radial-gradient(circle at 80% 75%, rgba(32,184,170,0.10), transparent 28%),
+                linear-gradient(135deg, #292b38 0%, #242632 52%, #2f3040 100%);
             display: flex;
             align-items: center;
             justify-content: center;
@@ -43,9 +46,11 @@
             position: fixed;
             inset: 0;
             background:
-                linear-gradient(rgba(255,255,255,0.022) 1px, transparent 1px),
-                linear-gradient(90deg, rgba(255,255,255,0.016) 1px, transparent 1px);
-            background-size: 44px 44px;
+                radial-gradient(circle, rgba(247,247,242,0.66) 1px, transparent 1.8px),
+                linear-gradient(rgba(157,177,255,0.12) 1px, transparent 1px),
+                linear-gradient(90deg, rgba(157,177,255,0.08) 1px, transparent 1px);
+            background-size: 82px 82px, 46px 46px, 46px 46px;
+            background-position: 16px 18px, 0 0, 0 0;
             mask-image: linear-gradient(180deg, rgba(0,0,0,0.35), rgba(0,0,0,0.06));
             pointer-events: none;
         }
@@ -55,27 +60,24 @@
             position: fixed;
             inset: 0;
             background:
-                radial-gradient(ellipse 70% 60% at 18% 18%, rgba(34,211,160,0.16) 0%, transparent 55%),
-                radial-gradient(ellipse 55% 50% at 82% 82%, rgba(129,140,248,0.13) 0%, transparent 55%);
+                linear-gradient(116deg, transparent 0 44%, rgba(125,183,255,0.08) 44.1%, transparent 44.3% 100%),
+                linear-gradient(28deg, transparent 0 62%, rgba(167,124,255,0.08) 62.1%, transparent 62.3% 100%);
             pointer-events: none;
         }
 
         .orb {
-            position: fixed;
-            border-radius: 50%;
-            filter: blur(70px);
-            pointer-events: none;
+            display: none;
         }
         .orb-1 { width: 440px; height: 440px; top: -170px; left: -120px; background: rgba(34,211,160,0.13); }
         .orb-2 { width: 380px; height: 380px; bottom: -130px; right: -90px; background: rgba(129,140,248,0.11); }
 
         .card {
             width: min(400px, 100%);
-            background: rgba(10,14,12,0.88);
-            border: 1px solid rgba(255,255,255,0.08);
-            border-radius: 22px;
+            background: rgba(34,36,49,0.86);
+            border: 1px solid rgba(218,225,255,0.14);
+            border-radius: 10px;
             padding: 38px 34px;
-            box-shadow: var(--shadow), 0 0 0 1px rgba(34,211,160,0.05);
+            box-shadow: var(--shadow), 0 0 0 1px rgba(167,124,255,0.06);
             position: relative;
             z-index: 1;
             backdrop-filter: blur(28px);
@@ -87,17 +89,17 @@
             top: 0; left: 50%;
             transform: translateX(-50%);
             width: 55%; height: 1px;
-            background: linear-gradient(90deg, transparent, rgba(34,211,160,0.55), transparent);
+            background: linear-gradient(90deg, transparent, rgba(167,124,255,0.55), rgba(32,184,170,0.5), transparent);
         }
 
         .logo {
             width: 54px; height: 54px;
-            background: linear-gradient(135deg, #22d3a0, #818cf8);
-            border-radius: 15px;
+            background: radial-gradient(circle at 34% 30%, #ffffff 0 16%, #a77cff 17% 62%, #5b6cff 100%);
+            border-radius: 10px;
             display: flex; align-items: center; justify-content: center;
             font-size: 26px; color: #040706;
             margin: 0 auto 18px;
-            box-shadow: 0 0 32px rgba(34,211,160,0.32), 0 8px 24px rgba(0,0,0,0.4);
+            box-shadow: 0 0 32px rgba(167,124,255,0.28), 0 8px 24px rgba(0,0,0,0.38);
         }
 
         .title {
@@ -105,7 +107,7 @@
             font-size: 23px;
             font-weight: 800;
             margin-bottom: 6px;
-            background: linear-gradient(135deg, #fff 40%, rgba(34,211,160,0.9));
+            background: linear-gradient(135deg, #fff 40%, #cfc6ff 76%, #8be9df);
             -webkit-background-clip: text;
             -webkit-text-fill-color: transparent;
             background-clip: text;
@@ -113,7 +115,7 @@
 
         .subtitle {
             text-align: center;
-            color: var(--faint);
+            color: var(--muted);
             font-size: 12.5px;
             margin-bottom: 26px;
             line-height: 1.5;
@@ -123,39 +125,39 @@
             width: 100%;
             padding: 12px 14px;
             margin-bottom: 10px;
-            background: rgba(255,255,255,0.04);
-            border: 1px solid rgba(255,255,255,0.08);
+            background: rgba(20,22,31,0.74);
+            border: 1px solid rgba(218,225,255,0.14);
             color: var(--text);
-            border-radius: 10px;
+            border-radius: 8px;
             outline: none;
             font-size: 14px;
             font-family: inherit;
             transition: border-color .15s, box-shadow .15s;
         }
         .input:focus {
-            border-color: rgba(34,211,160,0.5);
-            box-shadow: 0 0 0 3px rgba(34,211,160,0.08);
+            border-color: rgba(167,124,255,0.5);
+            box-shadow: 0 0 0 3px rgba(167,124,255,0.09);
         }
         .input::placeholder { color: var(--faint); }
 
         .submit {
             width: 100%;
             padding: 13px;
-            background: linear-gradient(135deg, #22d3a0, #1ab88c);
-            color: #030d09;
+            background: linear-gradient(135deg, #f7f7f2, #cfc6ff);
+            color: #242632;
             border: none;
-            border-radius: 10px;
+            border-radius: 8px;
             cursor: pointer;
             font-weight: 800;
             font-size: 14px;
             font-family: inherit;
-            box-shadow: 0 0 20px rgba(34,211,160,0.28), 0 4px 12px rgba(0,0,0,0.3);
+            box-shadow: 0 0 22px rgba(167,124,255,0.18), 0 4px 12px rgba(0,0,0,0.3);
             transition: all .18s;
             margin-top: 4px;
         }
         .submit:hover {
-            background: linear-gradient(135deg, #2de8b0, #22d3a0);
-            box-shadow: 0 0 30px rgba(34,211,160,0.38), 0 4px 14px rgba(0,0,0,0.3);
+            background: linear-gradient(135deg, #ffffff, #d9d1ff);
+            box-shadow: 0 0 30px rgba(167,124,255,0.26), 0 4px 14px rgba(0,0,0,0.3);
             transform: translateY(-1px);
         }
         .submit:disabled { opacity: 0.6; cursor: not-allowed; transform: none; }
@@ -166,7 +168,7 @@
             font-size: 12.5px;
             color: var(--faint);
         }
-        .switch a { color: var(--accent); text-decoration: none; font-weight: 700; }
+        .switch a { color: #cfc6ff; text-decoration: none; font-weight: 700; }
         .switch a:hover { text-decoration: underline; }
 
         .sso-divider {
@@ -181,10 +183,10 @@
         .sso-btn {
             width: 100%;
             padding: 12px;
-            background: rgba(255,255,255,0.04);
-            border: 1px solid rgba(255,255,255,0.1);
+            background: rgba(247,247,242,0.045);
+            border: 1px solid rgba(218,225,255,0.13);
             color: var(--text);
-            border-radius: 10px;
+            border-radius: 8px;
             cursor: pointer;
             font-weight: 600;
             font-size: 13.5px;
@@ -193,8 +195,8 @@
             transition: all .18s;
         }
         .sso-btn:hover {
-            background: rgba(255,255,255,0.08);
-            border-color: rgba(34,211,160,0.3);
+            background: rgba(167,124,255,0.10);
+            border-color: rgba(167,124,255,0.3);
         }
 
         .msg {
@@ -214,8 +216,8 @@
             z-index: 10;
         }
         .lang-btn {
-            background: rgba(255,255,255,0.05);
-            border: 1px solid rgba(255,255,255,0.1);
+            background: rgba(34,36,49,0.72);
+            border: 1px solid rgba(218,225,255,0.14);
             color: var(--text);
             border-radius: 8px;
             padding: 7px 12px;
@@ -224,15 +226,15 @@
             cursor: pointer;
             transition: background .15s;
         }
-        .lang-btn:hover { background: rgba(255,255,255,0.1); }
+        .lang-btn:hover { background: rgba(167,124,255,0.12); }
         .lang-menu {
             display: none;
             position: absolute;
             top: calc(100% + 6px);
             right: 0;
-            background: #141a16;
-            border: 1px solid rgba(255,255,255,0.1);
-            border-radius: 10px;
+            background: #222431;
+            border: 1px solid rgba(218,225,255,0.14);
+            border-radius: 8px;
             padding: 4px;
             min-width: 130px;
             box-shadow: 0 8px 24px rgba(0,0,0,0.4);
@@ -245,7 +247,7 @@
             font-size: 13px;
             color: var(--faint);
         }
-        .lang-opt:hover { background: rgba(255,255,255,0.06); color: var(--text); }
+        .lang-opt:hover { background: rgba(167,124,255,0.10); color: var(--text); }
         .lang-opt.active { color: var(--accent); font-weight: 700; }
     </style>
 </head>