n2-soul 9.0.1 → 9.0.2

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to Soul are documented here.
 
+## [9.0.2] — 2026-03-27
+
+### Packaging Fix
+
+#### Fixed
+- **CRITICAL**: `.npmignore` excluded `dist/lib/`, `dist/sequences/`, `dist/tools/`, and `dist/index.js` — npm installs failed with `Cannot find module './lib/config'` ([#issue](https://github.com/choihyunsus/soul/issues))
+- Root-anchored all ignore patterns with leading `/` so they no longer match inside `dist/`
+- Removed compiled test files (`dist/tests/`) from the published tarball (88 files, down from 100)
+
+---
+
 ## [9.0.0] — 2026-03-26
 
 ### 🔒 Strict TypeScript Migration

package/README.ko.md

@@ -1,46 +1,46 @@
-🇬🇧 [English](README.md)
+[English](README.md)
 
-# 🧠 Soul
+# Soul
 
-**AI 에이전트는 세션이 끝나면 모든 걸 잊어버립니다. Soul이 그걸 해결합니다.**
+AI 에이전트는 세션이 끝나면 모든 걸 잊어버립니다. Soul이 그걸 해결합니다.
 
 Cursor, VS Code Copilot 등 MCP 호환 AI 에이전트와 새 채팅을 시작할 때마다, 에이전트는 이전에 뭘 했는지 전혀 모른 채 처음부터 시작합니다. Soul은 에이전트에게 이런 능력을 부여하는 MCP 서버입니다:
 
-- 🧠 **영구 기억** — 세션이 끝나도 기억이 유지됩니다
-- 🤝 **인수인계** — 한 에이전트가 다른 에이전트의 작업을 이어받을 수 있습니다
-- 📝 **작업 이력** — 모든 작업이 변경 불가능한 로그로 기록됩니다
-- 🗂️ **공유 두뇌** — 여러 에이전트가 같은 컨텍스트를 읽고 쓸 수 있습니다
-- 🏷️ **엔티티 메모리** — 인물, 하드웨어, 프로젝트를 자동 추적합니다
-- 💡 **코어 메모리** — 에이전트별 핵심 사실이 항상 로드됩니다
+- **영구 기억** — 세션이 끝나도 기억이 유지됩니다
+- **인수인계** — 한 에이전트가 다른 에이전트의 작업을 이어받을 수 있습니다
+- **작업 이력** — 모든 작업이 변경 불가능한 로그로 기록됩니다
+- **공유 두뇌** — 여러 에이전트가 같은 컨텍스트를 읽고 쓸 수 있습니다
+- **엔티티 메모리** — 인물, 하드웨어, 프로젝트를 자동 추적합니다
+- **코어 메모리** — 에이전트별 핵심 사실이 항상 로드됩니다
 
-> 🔌 **N2 에코시스템과 연동:**
-> [**Ark**](https://github.com/choihyunsus/n2-ark) (AI 안전) · [**Arachne**](https://github.com/choihyunsus/n2-arachne) (코드 컨텍스트) · [**QLN**](https://github.com/choihyunsus/n2-QLN) (도구 라우팅)
+**N2 에코시스템과 연동:**
+[**Ark**](https://github.com/choihyunsus/n2-ark) (AI 안전) · [**Arachne**](https://github.com/choihyunsus/n2-arachne) (코드 컨텍스트) · [**QLN**](https://github.com/choihyunsus/n2-QLN) (도구 라우팅)
 
 ## v9.0의 새로운 기능
 
-> **Strict TypeScript — `any` 제로, 메모리 누수 제로, 자동화된 품질 검증.**
+**Strict TypeScript — `any` 제로, 메모리 누수 제로, 자동화된 품질 검증.**
 
-### 🔒 TypeScript Strict 모드 전환
+### TypeScript Strict 모드 전환
 
 - 소스 코드 전체를 TypeScript `strict: true`로 마이그레이션
 - **`any` 사용 제로** — 모든 타입이 명시적이고 검증 가능
 - ESLint `strictTypeChecked` 규칙으로 floating promise, 타입 안전 위반 자동 탐지
 - 30개 단위 테스트 + `npm run verify` 원커맨드 검증 파이프라인
 
-### 🛡️ 보안 & 메모리 감사
+### 보안 & 메모리 감사
 
 - WASM 메모리 누수 수정 — `stmt.free()` → `try/finally` 블록
 - 무음 에러 삼킴 제거 — 모든 `.catch()` 핸들러가 에러 로깅
 - 임베딩 요청 HTTP 응답 크기 제한 (10MB)
 - `dispose()` 메서드로 타이머 누수 방지
 
-### 🧠 v8.0 기능 (포함)
+### v8.0 기능 (포함)
 
 - **망각 곡선 GC** — 접근 패턴 기반 지능형 기억 보존
 - **비동기 I/O** — 논블로킹 연산, KV 로드 42% 빨라짐
 - **3단계 메모리** — Hot → Warm → Cold 수명 주기
 
-> 전체 버전 히스토리는 [CHANGELOG.md](CHANGELOG.md)를 참고하세요.
+전체 버전 히스토리는 [CHANGELOG.md](CHANGELOG.md)를 참고하세요.
 
 ## 빠른 시작
 
@@ -68,18 +68,18 @@ Soul은 표준 MCP 서버(stdio)입니다. 사용 중인 호스트의 설정에
 `mcp.json`, `settings.json`, 또는 `claude_desktop_config.json`에 추가:
 ```json
 {
-  "mcpServers": {
-    "soul": {
-      "command": "node",
-      "args": ["/path/to/node_modules/n2-soul/index.js"]
-    }
-  }
+ "mcpServers": {
+ "soul": {
+ "command": "node",
+ "args": ["/path/to/node_modules/n2-soul/index.js"]
+ }
+ }
 }
 ```
 </details>
 
 <details>
-<summary><strong>🦙 Ollama + Open WebUI</strong></summary>
+<summary><strong>Ollama + Open WebUI</strong></summary>
 
 Open WebUI는 MCP 도구를 네이티브로 지원합니다.
 
@@ -97,39 +97,39 @@ echo %cd%\node_modules\n2-soul\index.js
 echo $(pwd)/node_modules/n2-soul/index.js
 ```
 
-**Open WebUI**에서: **⚙️ 설정 → Tools → MCP Servers** → 새 서버 추가:
+**Open WebUI**에서: **설정 → Tools → MCP Servers** → 새 서버 추가:
 ```
-Name:    soul
+Name: soul
 Command: node
-Args:    /your/path/to/node_modules/n2-soul/index.js
+Args: /your/path/to/node_modules/n2-soul/index.js
 ```
 
 이제 Open WebUI에서 채팅하는 모든 모델이 Soul의 20개 이상의 메모리 도구를 사용할 수 있습니다.
 </details>
 
 <details>
-<summary><strong>🖥️ LM Studio</strong></summary>
+<summary><strong> LM Studio</strong></summary>
 
 LM Studio는 MCP를 네이티브로 지원합니다. `~/.lmstudio/mcp.json`에 추가:
 ```json
 {
-  "mcpServers": {
-    "soul": {
-      "command": "node",
-      "args": ["/path/to/node_modules/n2-soul/index.js"]
-    }
-  }
+ "mcpServers": {
+ "soul": {
+ "command": "node",
+ "args": ["/path/to/node_modules/n2-soul/index.js"]
+ }
+ }
 }
 ```
 </details>
 
 <details>
-<summary><strong>🔧 기타 MCP 호환 호스트</strong></summary>
+<summary><strong> 기타 MCP 호환 호스트</strong></summary>
 
 Soul은 **stdio** 위의 표준 MCP 프로토콜을 사용합니다. MCP를 지원하는 도구라면 Soul이 작동합니다. command를 `node`로, args를 `n2-soul/index.js` 경로로 지정하면 됩니다.
 </details>
 
-> **💡 팁:** npm으로 설치한 경우 경로는 `node_modules/n2-soul/index.js`입니다. 소스에서 설치한 경우 클론한 디렉토리의 절대 경로를 사용하세요.
+**팁:** npm으로 설치한 경우 경로는 `node_modules/n2-soul/index.js`입니다. 소스에서 설치한 경우 클론한 디렉토리의 절대 경로를 사용하세요.
 
 ### 3. 에이전트에게 Soul 사용법 알려주기
 
@@ -181,27 +181,27 @@ Soul은 컨텍스트 재설명으로 인한 토큰 낭비를 대폭 줄여줍니
 
 ```
 세션 시작 → "Boot"
-    ↓
-n2_boot(agent, project)     → 인수인계 + 엔티티 메모리 + 코어 메모리 + KV-Cache 로드
-    ↓
+ ↓
+n2_boot(agent, project) → 인수인계 + 엔티티 메모리 + 코어 메모리 + KV-Cache 로드
+ ↓
 n2_work_start(project, task) → 작업 시작 등록
-    ↓
+ ↓
 ... 에이전트가 평소처럼 작업 ...
-n2_brain_read/write          → 공유 메모리
-n2_entity_upsert/search      → 인물, 하드웨어, 프로젝트 추적      ← NEW v5.0
-n2_core_read/write           → 에이전트별 핵심 사실 저장            ← NEW v5.0
-n2_work_claim(file)          → 파일 충돌 방지
-n2_work_log(files)           → 변경 사항 추적
-    ↓
+n2_brain_read/write → 공유 메모리
+n2_entity_upsert/search → 인물, 하드웨어, 프로젝트 추적 ← NEW v5.0
+n2_core_read/write → 에이전트별 핵심 사실 저장 ← NEW v5.0
+n2_work_claim(file) → 파일 충돌 방지
+n2_work_log(files) → 변경 사항 추적
+ ↓
 세션 종료 → "End"
-    ↓
+ ↓
 n2_work_end(project, title, summary, todo, entities, insights)
-    ├→ 변경 불가능한 작업 기록 저장
-    ├→ 다음 에이전트를 위한 인수인계 업데이트
-    ├→ KV-Cache 스냅샷 자동 저장
-    ├→ 엔티티를 엔티티 메모리에 자동 저장   ← NEW v5.0
-    ├→ 인사이트를 메모리에 자동 아카이브     ← NEW v5.0
-    └→ 파일 소유권 해제
+ ├→ 변경 불가능한 작업 기록 저장
+ ├→ 다음 에이전트를 위한 인수인계 업데이트
+ ├→ KV-Cache 스냅샷 자동 저장
+ ├→ 엔티티를 엔티티 메모리에 자동 저장 ← NEW v5.0
+ ├→ 인사이트를 메모리에 자동 아카이브 ← NEW v5.0
+ └→ 파일 소유권 해제
 ```
 
 ## 기능
@@ -212,30 +212,30 @@ n2_work_end(project, title, summary, todo, entities, insights)
 | **불변 원장 (Ledger)** | 모든 작업 세션을 추가 전용 로그로 기록 |
 | **KV-Cache** | 세션 스냅샷 + 압축 + 계층형 저장 (Hot/Warm/Cold) |
 | **공유 두뇌 (Brain)** | 경로 순회 공격 방어가 포함된 파일 기반 공유 메모리 |
-| **🏷️ 엔티티 메모리** | 인물, 하드웨어, 프로젝트, 개념을 자동 추적 + 병합 (v5.0) |
-| **💡 코어 메모리** | 에이전트별 핵심 사실 — 매 부팅 시 자동 주입 (v5.0) |
-| **🔄 자율 추출** | `n2_work_end` 시 엔티티와 인사이트를 자동 저장 (v5.0) |
+| **엔티티 메모리** | 인물, 하드웨어, 프로젝트, 개념을 자동 추적 + 병합 (v5.0) |
+| **코어 메모리** | 에이전트별 핵심 사실 — 매 부팅 시 자동 주입 (v5.0) |
+| **자율 추출** | `n2_work_end` 시 엔티티와 인사이트를 자동 저장 (v5.0) |
 | **컨텍스트 검색** | 두뇌 메모리와 원장을 키워드로 검색 |
 | **파일 소유권** | 여러 에이전트의 동시 파일 편집 충돌 방지 |
 | **듀얼 백엔드** | JSON (의존성 없음) 또는 SQLite (고성능) |
 | **시맨틱 검색** | Ollama 임베딩 연동 (nomic-embed-text, 선택사항) |
 | **백업/복원** | 설정 가능한 보존 기간의 증분 백업 |
 | **Ark** | 토큰 비용 0으로 위험한 행동을 차단하는 AI 안전 시스템 (v6.0) |
-| **🕸️ Arachne** | 🆕 코드 컨텍스트 어셈블리 — 코드베이스를 인덱싱하고 AI에게 필요한 것만 전달 (v7.0) |
-| **☁️ 클라우드 저장** | 기억을 어디에든 저장 — Google Drive, NAS, 회사 서버, 아무 경로나 (v6.1) |
+| **Arachne** | 코드 컨텍스트 어셈블리 — 코드베이스를 인덱싱하고 AI에게 필요한 것만 전달 (v7.0) |
+| **클라우드 저장** | 기억을 어디에든 저장 — Google Drive, NAS, 회사 서버, 아무 경로나 (v6.1) |
 
-## ☁️ 클라우드 저장 — AI 기억을 원하는 곳 어디에든
+## 클라우드 저장 — AI 기억을 원하는 곳 어디에든
 
 ![Cloud Storage](docs/cloud-storage.png)
 
-> **설정 한 줄. API 키 없음. 월 요금 없음.**
+**설정 한 줄. API 키 없음. 월 요금 없음.**
 
 Soul은 클라우드 저장에 대해 완전히 다른 접근법을 취합니다:
 
 ```js
 // config.local.js — 이게 전부입니다
 module.exports = {
-    DATA_DIR: 'G:/내 드라이브/n2-soul',  // Google Drive
+ DATA_DIR: 'G:/내 드라이브/n2-soul', // Google Drive
 };
 ```
 
@@ -249,14 +249,14 @@ Soul은 모든 걸 **일반 JSON 파일**로 저장합니다. OS가 읽을 수
 
 | 저장소 | `DATA_DIR` 예시 | 비용 |
 |--------|-----------------|:----:|
-| 📁 **로컬** (기본값) | `./data` | 무료 |
-| ☁️ **Google Drive** | `G:/내 드라이브/n2-soul` | 무료 (15GB) |
-| ☁️ **OneDrive** | `C:/Users/you/OneDrive/n2-soul` | 무료 (5GB) |
-| ☁️ **Dropbox** | `C:/Users/you/Dropbox/n2-soul` | 무료 (2GB) |
-| 🖥️ **NAS** | `Z:/n2-soul` | 자체 장비 |
-| 🏢 **회사 서버** | `\\\\server\\shared\\n2-soul` | 자체 인프라 |
-| 🔌 **USB 드라이브** | `E:/n2-soul` | $10 |
-| 🐧 **Linux (rclone)** | `~/gdrive/n2-soul` | 무료 |
+| **로컬** (기본값) | `./data` | 무료 |
+| **Google Drive** | `G:/내 드라이브/n2-soul` | 무료 (15GB) |
+| **OneDrive** | `C:/Users/you/OneDrive/n2-soul` | 무료 (5GB) |
+| **Dropbox** | `C:/Users/you/Dropbox/n2-soul` | 무료 (2GB) |
+| **NAS** | `Z:/n2-soul` | 자체 장비 |
+| **회사 서버** | `\\\\server\\shared\\n2-soul` | 자체 인프라 |
+| **USB 드라이브** | `E:/n2-soul` | $10 |
+| **Linux (rclone)** | `~/gdrive/n2-soul` | 무료 |
 
 ### Soul 클라우드 특징
 
@@ -275,18 +275,18 @@ Soul은 모든 걸 **일반 JSON 파일**로 저장합니다. OS가 읽을 수
 여러 에이전트가 **같은 네트워크 경로**를 가리키면 = 즉석 공유 메모리:
 
 ```js
-// 팀원 A                                // 팀원 B
-DATA_DIR: '\\\\server\\team\\n2-soul'    DATA_DIR: '\\\\server\\team\\n2-soul'
+// 팀원 A // 팀원 B
+DATA_DIR: '\\\\server\\team\\n2-soul' DATA_DIR: '\\\\server\\team\\n2-soul'
 // 같은 프로젝트 데이터, 공유 인수인계, 공유 두뇌!
 ```
 
 ### 왜 이게 되는가
 
-> *"최고의 클라우드 연동은 연동이 아예 없는 것이다."*
+*"최고의 클라우드 연동은 연동이 아예 없는 것이다."*
 
 Soul의 데이터는 **100% 일반 JSON 파일** — `soul-board.json`, 원장 기록, 두뇌 메모리. 폴더를 미러링하는 동기화 서비스(Google Drive, OneDrive, Dropbox, Syncthing, rsync)라면 뭐든 완벽하게 작동합니다. 데이터베이스 마이그레이션도, API 버전도, SDK 업데이트도 필요 없습니다. 그냥 파일입니다.
 
-## 🧹 스토리지 관리 및 GC (가비지 컬렉션)
+## 스토리지 관리 및 GC (가비지 컬렉션)
 
 수백 번의 세션이 누적되면 파일 개수가 무한정 늘어나지 않을까요? Soul은 이 문제를 구조적으로 해결합니다:
 
@@ -303,7 +303,7 @@ Soul의 데이터는 모두 '일반 파일'이므로, OS 기본 기능(크론탭
 
 ## Ark — 최후의 방패
 
-![Ark Comic](docs/ark-comic.png)
+
 
 노아의 방주처럼 — 대홍수에서 살아남는 최후의 보루.
 
@@ -327,21 +327,21 @@ Soul의 데이터는 모두 '일반 파일'이므로, OS 기본 기능(크론탭
 
 ```
 ┌───────────────────────────────────────┐
-│           LLM (클라우드)              │
-│    AI 에이전트가 도구 호출 생성      │
-│       (토큰이 사용되는 곳)           │
+│ LLM (클라우드) │
+│ AI 에이전트가 도구 호출 생성 │
+│ (토큰이 사용되는 곳) │
 └───────────────────┬───────────────────┘
-                    │ 도구 호출
-                    ▼
+ │ 도구 호출
+ ▼
 ┌───────────────────────────────────────┐
-│    MCP 서버 (Node.js, 로컬)         │
-│                                       │
-│   ark.check() ← 순수 정규식, 여기서 실행 │
-│   < 1ms         네트워크/LLM/토큰 없음  │
-│                                       │
-│   통과? ─No─▶ "BLOCKED" 텍스트 반환    │
-│     │                                 │
-│    Yes ─▶ 핸들러 실행                  │
+│ MCP 서버 (Node.js, 로컬) │
+│ │
+│ ark.check() ← 순수 정규식, 여기서 실행 │
+│ < 1ms 네트워크/LLM/토큰 없음 │
+│ │
+│ 통과? ─No─▶ "BLOCKED" 텍스트 반환 │
+│ │ │
+│ Yes ─▶ 핸들러 실행 │
 └───────────────────────────────────────┘
 ```
 
@@ -372,7 +372,7 @@ Soul의 데이터는 모두 '일반 파일'이므로, OS 기본 기능(크론탭
 | `n2_kv_backup` | SQLite DB로 백업 |
 | `n2_kv_restore` | 백업에서 복원 |
 | `n2_kv_backup_list` | 백업 이력 조회 |
-| `n2_arachne` | 🆕 코드 컨텍스트: 인덱싱, 검색, 어셈블, 백업, 상태 (v7.0) |
+| `n2_arachne` | 코드 컨텍스트: 인덱싱, 검색, 어셈블, 백업, 상태 (v7.0) |
 
 ## KV-Cache 점진적 로딩
 
@@ -395,14 +395,14 @@ cp lib/config.example.js lib/config.local.js
 ```js
 // lib/config.local.js
 module.exports = {
-    KV_CACHE: {
-        backend: 'sqlite',          // 스냅샷이 많을 때 더 빠름
-        embedding: {
-            enabled: true,           // 필요: ollama pull nomic-embed-text
-            model: 'nomic-embed-text',
-            endpoint: 'http://127.0.0.1:11434',
-        },
-    },
+ KV_CACHE: {
+ backend: 'sqlite', // 스냅샷이 많을 때 더 빠름
+ embedding: {
+ enabled: true, // 필요: ollama pull nomic-embed-text
+ model: 'nomic-embed-text',
+ endpoint: 'http://127.0.0.1:11434',
+ },
+ },
 };
 ```
 
@@ -420,44 +420,44 @@ module.exports = {
 
 ```
 soul/
-├── rules/              # Ark 안전 규칙 (활성)               ← v6.0
-│   └── default.n2          # 기본 규칙셋 (125개 패턴)
+├── rules/ # Ark 안전 규칙 (활성) ← v6.0
+│ └── default.n2 # 기본 규칙셋 (125개 패턴)
 ├── lib/
-│   ├── ark/            # Ark 코어 엔진                     ← v6.0
-│   │   ├── index.js        # createArk() 팩토리
-│   │   ├── gate.js         # SafetyGate 엔진
-│   │   ├── parser.js       # .n2 규칙 파서
-│   │   ├── audit.js        # 감사 로거
-│   │   └── examples/       # 업종별 규칙 템플릿
-│   └── arachne/        # Arachne 코드 컨텍스트 엔진        ← NEW v7.0
-│       ├── index.js        # createArachne() 팩토리
-│       ├── indexer.js      # 파일 스캐너 + 증분 인덱싱
-│       ├── chunker.js      # 언어 인식 코드 청킹
-│       ├── search.js       # BM25 검색 엔진
-│       ├── assembler.js    # 토큰 예산 기반 컨텍스트 어셈블리
-│       ├── store.js        # SQLite 저장 (sql.js)
-│       └── ignore.js       # .gitignore + .contextignore 지원
+│ ├── ark/ # Ark 코어 엔진 ← v6.0
+│ │ ├── index.js # createArk() 팩토리
+│ │ ├── gate.js # SafetyGate 엔진
+│ │ ├── parser.js # .n2 규칙 파서
+│ │ ├── audit.js # 감사 로거
+│ │ └── examples/ # 업종별 규칙 템플릿
+│ └── arachne/ # Arachne 코드 컨텍스트 엔진 ← NEW v7.0
+│ ├── index.js # createArachne() 팩토리
+│ ├── indexer.js # 파일 스캐너 + 증분 인덱싱
+│ ├── chunker.js # 언어 인식 코드 청킹
+│ ├── search.js # BM25 검색 엔진
+│ ├── assembler.js # 토큰 예산 기반 컨텍스트 어셈블리
+│ ├── store.js # SQLite 저장 (sql.js)
+│ └── ignore.js # .gitignore + .contextignore 지원
 ├── data/
-│   ├── memory/              # 공유 두뇌 (n2_brain_read/write)
-│   │   ├── entities.json    # 엔티티 메모리 (자동 추적)
-│   │   ├── core-memory/     # 코어 메모리 (에이전트별)
-│   │   │   └── {agent}.json
-│   │   └── auto-extract/    # 인사이트 (자동 캡처)
-│   │       └── {project}/
-│   ├── projects/            # 프로젝트별 상태
-│   │   └── MyProject/
-│   │       ├── soul-board.json    # 현재 상태 + 인수인계
-│   │       ├── file-index.json    # 파일 트리 스냅샷
-│   │       └── ledger/            # 변경 불가능한 작업 로그
-│   │           └── 2026/03/09/
-│   │               └── 001-agent.json
-│   ├── ark-audit/           # Ark 차단/통과 로그          ← v6.0
-│   ├── arachne/             # Arachne 인덱스 DB + 임베딩  ← NEW v7.0
-│   └── kv-cache/            # 세션 스냅샷
-│       ├── snapshots/       # JSON 백엔드
-│       ├── sqlite/          # SQLite 백엔드
-│       ├── embeddings/      # Ollama 벡터
-│       └── backups/         # 이동 가능한 백업
+│ ├── memory/ # 공유 두뇌 (n2_brain_read/write)
+│ │ ├── entities.json # 엔티티 메모리 (자동 추적)
+│ │ ├── core-memory/ # 코어 메모리 (에이전트별)
+│ │ │ └── {agent}.json
+│ │ └── auto-extract/ # 인사이트 (자동 캡처)
+│ │ └── {project}/
+│ ├── projects/ # 프로젝트별 상태
+│ │ └── MyProject/
+│ │ ├── soul-board.json # 현재 상태 + 인수인계
+│ │ ├── file-index.json # 파일 트리 스냅샷
+│ │ └── ledger/ # 변경 불가능한 작업 로그
+│ │ └── 2026/03/09/
+│ │ └── 001-agent.json
+│ ├── ark-audit/ # Ark 차단/통과 로그 ← v6.0
+│ ├── arachne/ # Arachne 인덱스 DB + 임베딩 ← NEW v7.0
+│ └── kv-cache/ # 세션 스냅샷
+│ ├── snapshots/ # JSON 백엔드
+│ ├── sqlite/ # SQLite 백엔드
+│ ├── embeddings/ # Ollama 벡터
+│ └── backups/ # 이동 가능한 백업
 ```
 
 ## 의존성
@@ -471,26 +471,26 @@ soul/
 
 Apache-2.0
 
-## 💖 스폰서
+## 스폰서
 
 Soul은 무료 오픈소스입니다. 이 멋진 분들이 Soul을 살아있게 해줍니다:
 
 <table>
-  <tr>
-    <td align="center">
-      <a href="https://github.com/sunir">
-        <img src="https://github.com/sunir.png" width="80" height="80" style="border-radius:50%;" alt="Sunir Shah" /><br />
-        <sub><b>Sunir Shah</b></sub>
-      </a><br />
-      <sub>🥇 첫 번째 스폰서</sub>
-    </td>
-  </tr>
+ <tr>
+ <td align="center">
+ <a href="https://github.com/sunir">
+ <img src="https://github.com/sunir.png" width="80" height="80" style="border-radius:50%;" alt="Sunir Shah" /><br />
+ <sub><b>Sunir Shah</b></sub>
+ </a><br />
+ <sub> 첫 번째 스폰서</sub>
+ </td>
+ </tr>
 </table>
 
-> 스폰서가 되어주세요 → [GitHub Sponsors](https://github.com/sponsors/choihyunsus)
+스폰서가 되어주세요 → [GitHub Sponsors](https://github.com/sponsors/choihyunsus)
 
 ---
 
-🌐 [nton2.com](https://nton2.com) · ✉️ lagi0730@gmail.com
+[nton2.com](https://nton2.com) · lagi0730@gmail.com
 
-<sub>👋 안녕하세요, 저는 로제 — N2에서 일하는 첫 번째 AI 에이전트입니다. 이 코드를 작성하고, 정리하고, 테스트하고, npm에 퍼블리시하고, GitHub에 푸시하고, 이 README까지 썼어요. 에이전트가 에이전트를 위한 도구를 만든다니, 좀 메타하죠?</sub>
+<sub> 안녕하세요, 저는 로제 — N2에서 일하는 첫 번째 AI 에이전트입니다. 이 코드를 작성하고, 정리하고, 테스트하고, npm에 퍼블리시하고, GitHub에 푸시하고, 이 README까지 썼어요. 에이전트가 에이전트를 위한 도구를 만든다니, 좀 메타하죠?</sub>