soulclaw-vscode 0.3.0

package/.vscodeignore

@@ -0,0 +1,8 @@
+.vscode/**
+.vscode-test/**
+src/**
+.gitignore
+tsconfig.json
+node_modules/**
+**/*.ts
+!out/**

package/.vsixignore

@@ -0,0 +1,2 @@
+media/clawsouls_vscode_logo.png
+media/clawsouls_vscode_logo_small.png

package/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding any notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 ClawSouls
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,167 @@
+# SoulClaw — Soul-Powered AI Agent
+
+Zero-setup AI agent with Soul-based personas, Swarm Memory collaboration, and integrated development tools — powered by [OpenClaw](https://github.com/openclaw/openclaw).
+
+> ⚠️ **Early Preview** — Under active development. Expect breaking changes.
+
+## Features
+
+### ✅ Implemented
+
+- 💬 **Chat Panel** — Real-time AI chat in VSCode with streaming responses, message history, and session persistence
+- 🎭 **Soul Explorer** — Browse 85+ community souls from [ClawSouls](https://clawsouls.ai), search/filter by category, preview details, one-click apply
+- 🐝 **Swarm Memory** — Git-based team knowledge collaboration with branch management, push/pull, LLM-powered merge conflict resolution, age encryption
+- 📊 **Checkpoints** — Create, scan, compare, and restore agent state snapshots with contamination detection
+- 🔍 **SoulScan** — Run security scans on AI persona packages directly from the editor
+- ⚙️ **Setup Wizard** — 5-step guided onboarding (LLM provider → API key → port → soul selection → done)
+- 🎭 **Onboarding Soul Browser** — Dynamic soul picker during first-run setup, fetches live data from ClawSouls API with search, category filters, and popularity ranking
+- 🔌 **Contained Runtime** — OpenClaw installs into extension storage, zero system pollution, clean uninstall
+- 📋 **Chat History** — Browse and switch between past conversation sessions
+- 📍 **Status Bar** — Live soul name, agent branch, connection status, quick actions
+- 🔄 **Workspace Tracker** — Auto-syncs current project path to agent TOOLS.md for context awareness
+
+### 🚧 Planned
+
+- 🛒 VS Marketplace publishing
+- 🔐 Private soul management
+- 🤖 Multi-agent orchestration panel
+
+## Requirements
+
+- **Node.js 22+** (required for OpenClaw runtime)
+- VSCode 1.85+
+- **For local LLM**: [Ollama](https://ollama.com) installed and running (`ollama serve`)
+
+## Setup Guide
+
+### Step 1: Install Node.js 22+
+
+The extension auto-detects Node.js from nvm, fnm, volta, or system PATH.
+
+#### macOS / Linux
+
+```bash
+# Using nvm (recommended)
+nvm install 24
+```
+
+#### Windows
+
+```powershell
+# Using nvm-windows
+nvm install 24.13.0 64
+nvm use 24.13.0
+```
+
+> ⚠️ **Windows**: Specify architecture: `nvm install 24 64`. Without `64`, nvm-windows may fail.
+
+#### Direct Install
+
+Download Node.js 24+ from [nodejs.org](https://nodejs.org/).
+
+### Step 2: (Optional) Set Up Ollama for Local LLM
+
+```bash
+# Install from https://ollama.com
+ollama pull llama3.2
+ollama serve
+```
+
+### Step 3: Install & Configure
+
+1. Install the extension from `.vsix` or VS Marketplace
+2. Setup Wizard runs automatically on first launch:
+   - **Step 1**: Choose LLM provider (Anthropic / OpenAI / Ollama)
+   - **Step 2**: Enter API key or Ollama config
+   - **Step 3**: Configure Gateway port (default: 18789)
+   - **Step 4**: Browse and pick a soul from the community — search, filter by category, see download counts and scan scores
+   - **Step 5**: Done! Chat opens automatically
+3. Start building with your AI partner
+
+## Panels
+
+### 💬 Chat
+
+Full-featured chat with streaming, markdown rendering, code blocks, and persistent history. Messages are saved across sessions — switch between past conversations via the history panel.
+
+### 🎭 Soul Explorer
+
+- **Browse mode**: Souls grouped by category, sorted by downloads, with SoulScan badges
+- **Search**: Filter by name, description, or tags
+- **Preview**: View full soul details, files, and scan results
+- **Apply**: One-click apply to OpenClaw workspace with optional memory clear
+- **Local mode**: Toggle to see soul files in your current workspace
+
+### 📊 Checkpoints
+
+- **Create**: Snapshot current agent state (SOUL.md, MEMORY.md, etc.)
+- **Scan**: Run 4-layer contamination detection on any checkpoint
+- **Compare**: Diff two checkpoints to see what changed
+- **Restore**: Roll back to a previous state
+
+### 🐝 Swarm Memory
+
+- **Init/Join**: Create or join a shared swarm repository
+- **Push/Pull**: Sync memory changes with the team
+- **Branch**: Create topic branches for isolated exploration
+- **Merge**: LLM-powered semantic conflict resolution
+- **Encryption**: Age-based encryption for sensitive memory with key rotation
+
+## Status Bar
+
+| Item | Description |
+|------|-------------|
+| 🔮 Soul Name | Current soul — click to chat |
+| 🐝 agent/main | Current swarm branch |
+| 🟢 connected | Gateway status — click for action |
+| 🔄 | Restart Gateway |
+| ⚙️ | Re-run setup wizard |
+
+## Settings
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| `clawsouls.llmProvider` | `anthropic` | LLM provider (anthropic / openai / ollama) |
+| `clawsouls.llmApiKey` | | API key for Anthropic or OpenAI |
+| `clawsouls.llmModel` | | Model override (e.g. `claude-opus-4-6`) |
+| `clawsouls.ollamaUrl` | `http://127.0.0.1:11434` | Ollama API URL |
+| `clawsouls.ollamaModel` | `llama3` | Ollama model name |
+| `clawsouls.gatewayUrl` | `ws://127.0.0.1:18789` | Gateway WebSocket URL |
+| `clawsouls.gatewayPort` | `18789` | Gateway port |
+| `clawsouls.autoConnect` | `true` | Auto-connect on startup |
+| `clawsouls.showStatusBar` | `true` | Show status bar items |
+
+## How It Works
+
+1. Extension finds Node.js 22+ on your system (nvm, fnm, volta, PATH)
+2. Installs OpenClaw into extension storage (`globalStorage/`)
+3. Starts the OpenClaw Gateway as a background process
+4. Connects via WebSocket for real-time chat
+
+Everything is contained — uninstalling cleans up completely.
+
+## File Locations
+
+| OS | Extension Storage | OpenClaw Config |
+|----|-------------------|-----------------|
+| **Windows** | `%APPDATA%\Code\User\globalStorage\clawsouls.soulclaw-vscode\` | `%USERPROFILE%\.openclaw\` |
+| **macOS** | `~/Library/Application Support/Code/User/globalStorage/clawsouls.soulclaw-vscode/` | `~/.openclaw/` |
+| **Linux** | `~/.config/Code/User/globalStorage/clawsouls.soulclaw-vscode/` | `~/.openclaw/` |
+
+## Disclaimer
+
+This extension is provided "as is" without warranty of any kind. It is an independent project by [ClawSouls](https://clawsouls.ai) and is **not officially affiliated with or endorsed by the OpenClaw project**. Use at your own risk.
+
+## License
+
+**Apache License 2.0** (extension) + **MIT** (embedded OpenClaw runtime).
+
+See [LICENSE](LICENSE) for details.
+
+## Links
+
+- [ClawSouls](https://clawsouls.ai) — AI persona platform
+- [Soul Spec](https://clawsouls.ai/spec) — Open persona specification
+- [Documentation](https://docs.clawsouls.ai) — Full docs
+- [Blog](https://blog.clawsouls.ai) — Guides & updates
+- [GitHub](https://github.com/clawsouls/clawsouls-vscode) — Source code & issues

package/docs/TESTCASE.md

@@ -0,0 +1,217 @@
+# ClawSouls Agent — VSCode Extension Test Cases
+
+## 환경 준비
+- Windows amd64, Node v24+
+- VSCode 1.85+
+- `.vsix` 설치: Extensions → `...` → Install from VSIX
+- 아무 프로젝트 폴더 열기
+
+---
+
+## 1. Setup Wizard
+
+| # | 테스트 | 기대 결과 | Pass |
+|---|--------|-----------|------|
+| S-01 | Extension 설치 후 최초 실행 | Setup Wizard 패널 자동 표시 |  |
+| S-02 | Anthropic API key 입력 | key 저장, Gateway 연결 시작 |  |
+| S-03 | Ollama 선택 → URL 입력 | Ollama 모드로 설정 |  |
+| S-04 | 잘못된 API key 입력 | 에러 메시지 표시 |  |
+| S-05 | Command Palette → "ClawSouls: Setup" | Setup Wizard 재실행 |  |
+| S-06 | Step 4: Soul 브라우저 로딩 | API에서 soul 목록 fetch, 카드 그리드 표시 |  |
+| S-07 | Step 4: 검색 입력 | 이름/설명/태그로 실시간 필터링 |  |
+| S-08 | Step 4: 카테고리 필터 클릭 | 해당 카테고리만 표시 |  |
+| S-09 | Step 4: 인기 soul ⭐ 배지 | 상위 3개에 "Popular" 배지 표시 |  |
+| S-10 | Step 4: Soul 카드 클릭 → Next | 선택한 soul이 OpenClaw workspace에 apply |  |
+| S-11 | Step 4: "Create Custom" 선택 → Next | Custom soul 생성 플로우 |  |
+| S-12 | Step 4: "Start Empty" 선택 → Next | Soul 없이 진행 |  |
+| S-13 | Step 4: 다운로드 수/스캔 상태 표시 | 각 카드에 ⬇ count, ✅/⚠️ 배지 |  |
+| S-14 | Step 4: API 장애 시 | "No souls found" 표시, Custom/Empty로 진행 가능 |  |
+
+---
+
+## 2. Gateway Connection
+
+| # | 테스트 | 기대 결과 | Pass |
+|---|--------|-----------|------|
+| G-01 | Setup 완료 후 | Status bar "🟢 connected" 표시 |  |
+| G-02 | Gateway 연결 끊김 | Status bar "⚪ disconnected" 표시 |  |
+| G-03 | "🔄" 버튼 클릭 | Gateway 재시작, 재연결 |  |
+| G-04 | Chat 패널에서 연결 상태 확인 | "● Gateway: connected" 실시간 업데이트 |  |
+
+---
+
+## 3. Chat Panel
+
+| # | 테스트 | 기대 결과 | Pass |
+|---|--------|-----------|------|
+| C-01 | Status bar "💬 Chat" 클릭 | Chat 패널 열림 |  |
+| C-02 | 메시지 입력 → Send | 메시지 전송, 유저 메시지 표시 |  |
+| C-03 | Enter 키로 전송 | Shift+Enter 없이 Enter만 누르면 전송 |  |
+| C-04 | Shift+Enter | 줄바꿈 (전송 아님) |  |
+| C-05 | AI 응답 수신 | Assistant 메시지 표시 (마크다운 렌더링) |  |
+| C-06 | 긴 대화 후 새 메시지 | 스크롤 점프 없이 메시지 append |  |
+| C-07 | Chat 패널 닫기 → 다시 열기 | 이전 대화 내용 유지 (최대 200개) |  |
+| C-08 | VSCode 재시작 후 Chat 열기 | 대화 히스토리 유지 |  |
+| C-09 | 파일 drag & drop | 파일 내용 텍스트에 삽입 (100KB 이하) |  |
+| C-10 | 100KB 초과 파일 drag & drop | 경고 메시지 |  |
+| C-11 | 스트리밍 응답 중 | "typing..." 인디케이터 표시 |  |
+
+---
+
+## 4. Status Bar
+
+| # | 테스트 | 기대 결과 | Pass |
+|---|--------|-----------|------|
+| SB-01 | soul.json 있는 프로젝트 열기 | "🔮 {displayName}" 표시 |  |
+| SB-02 | soul.json 없는 프로젝트 열기 | "🔮 No Soul" 표시 |  |
+| SB-03 | Soul Explorer에서 soul apply 후 | Status bar soul name 업데이트 |  |
+| SB-04 | soul.json 수동 삭제 | "🔮 No Soul"로 변경 |  |
+| SB-05 | soul.json 수동 생성/수정 | soul name 자동 업데이트 |  |
+| SB-06 | "🐝 agent/main" 표시 확인 | agent 이름 표시 |  |
+
+---
+
+## 5. Soul Explorer
+
+| # | 테스트 | 기대 결과 | Pass |
+|---|--------|-----------|------|
+| SE-01 | 사이드바 ClawSouls 아이콘 클릭 | Soul Explorer 패널 열림 |  |
+| SE-02 | Browse 모드 | 카테고리별 soul 목록 로드 (89개) |  |
+| SE-03 | 검색 아이콘 클릭 → 키워드 입력 | 이름/태그/설명 검색 필터링 |  |
+| SE-04 | Soul 항목 클릭 → Preview | Webview에 soul 상세 정보 표시 |  |
+| SE-05 | Apply 버튼 (☁↓) 클릭 | 확인 다이얼로그 → "Apply" 선택 |  |
+| SE-06 | Apply 완료 후 | "✅ Soul applied" 메시지 + Gateway 재시작 |  |
+| SE-07 | Apply 후 Chat에서 대화 | 해당 soul 페르소나로 응답 |  |
+| SE-08 | Toggle View (로컬/브라우즈) | 로컬 파일 ↔ API 목록 전환 |  |
+| SE-09 | Refresh 버튼 | soul 목록 새로고침 |  |
+
+---
+
+## 6. Checkpoint
+
+| # | 테스트 | 기대 결과 | Pass |
+|---|--------|-----------|------|
+| CP-01 | "ClawSouls: Create Checkpoint" 실행 | 체크포인트 이름 입력 프롬프트 |  |
+| CP-02 | 이름 입력 → 생성 | `.clawsouls/checkpoints/{id}/` 에 파일 저장 |  |
+| CP-03 | Checkpoints 패널에 목록 표시 | 생성한 체크포인트 보임 |  |
+| CP-04 | Restore 버튼 클릭 | 확인 다이얼로그 → soul.json 복원 |  |
+| CP-05 | Diff 버튼 클릭 | 파일 선택 → VSCode diff viewer 열림 |  |
+| CP-06 | Delete 버튼 클릭 | 체크포인트 삭제 |  |
+| CP-07 | 체크포인트 없는 상태 | "No checkpoints" 메시지 |  |
+| CP-08 | **저장 위치** | `~/.openclaw/workspace/.clawsouls/checkpoints/`에 저장 (프로젝트 폴더 아님) |  |
+| CP-09 | **Restore 후 gateway restart** | 복원 후 gateway 자동 재시작, 에이전트가 복원된 soul 사용 |  |
+
+---
+
+## 7. Swarm Memory
+
+| # | 테스트 | 기대 결과 | Pass |
+|---|--------|-----------|------|
+| SW-01 | 초기 상태 | "Initialize Swarm Memory" 버튼만 표시 |  |
+| SW-02 | Initialize 클릭 → URL 비움 | globalStorage에 로컬 git repo 생성 |  |
+| SW-03 | Initialize 클릭 → URL 입력 | git clone 실행 |  |
+| SW-04 | 초기화 후 패널 | Join/Push/Pull/Merge/Encryption 버튼 표시 |  |
+| SW-05 | "👤 Join as Agent" 클릭 | branch 이름 입력 → `agent/{name}` 생성 |  |
+| SW-06 | "⬆ Push" 클릭 | 터미널에서 `npx clawsouls swarm push` 실행 |  |
+| SW-07 | "⬇ Pull" 클릭 | 터미널에서 `npx clawsouls swarm pull` 실행 |  |
+| SW-08 | "🔀 Merge" 클릭 | branch 선택 → 전략 선택 (Git/LLM) |  |
+| SW-09 | Git merge 선택 | 직접 git merge 실행 |  |
+| SW-10 | LLM merge 선택 | 터미널에서 `--strategy llm` 실행 |  |
+| SW-11 | "🔐 Encryption Keys" 클릭 | QuickPick: init/show/add/list/rotate |  |
+| SW-12 | Keys → Init 선택 | 터미널에서 `swarm keys init` 실행 |  |
+| SW-13 | Keys → Add 선택 | public key 입력 프롬프트 → 실행 |  |
+| SW-14 | Branch 목록 표시 | 현재 branch에 ★ 표시 |  |
+| SW-15 | Branch 항목 클릭 | branch 전환 |  |
+| SW-16 | **프로젝트 repo 무영향 확인** | `git branch` — agent/* 브랜치 없음 |  |
+| SW-17 | 터미널 명령어 구분자 | `;` 사용 (PowerShell 호환) |  |
+| SW-18 | **Swarm dir 위치** | `~/.openclaw/swarm/`에 git repo 생성 (globalStorage 아님) |  |
+| SW-19 | **Pull 후 workspace sync** | Pull → `~/.openclaw/workspace/`에 메모리 파일 복사됨 |  |
+| SW-20 | **Pull 후 gateway restart** | Pull 완료 5초 후 gateway 재시작 |  |
+| SW-21 | **Merge 후 workspace sync** | Merge → workspace에 메모리 파일 복사 + gateway 재시작 |  |
+| SW-22 | **joinAgent prefix 자동추가** | "brad" 입력 → `agent/brad` 브랜치 생성 |  |
+| SW-23 | **Push/Pull 비agent 브랜치 경고** | main 브랜치에서 Push → "not an agent branch" 경고 |  |
+| SW-24 | **여러 workspace에서 같은 swarm** | 다른 프로젝트 열어도 같은 `~/.openclaw/swarm/` 참조 |  |
+
+---
+
+## 8. SoulScan
+
+| # | 테스트 | 기대 결과 | Pass |
+|---|--------|-----------|------|
+| SC-01 | "ClawSouls: Run SoulScan" 실행 | 터미널에서 `npx clawsouls scan` 실행 |  |
+| SC-02 | soul.json 있는 프로젝트에서 실행 | 스캔 결과 터미널 출력 |  |
+| SC-03 | soul.json 없는 프로젝트에서 실행 | 에러 메시지 |  |
+
+---
+
+## 9. Edit Soul
+
+| # | 테스트 | 기대 결과 | Pass |
+|---|--------|-----------|------|
+| ES-01 | "ClawSouls: Edit Soul" — soul.json 있음 | soul.json 에디터에서 열림 |  |
+| ES-02 | "ClawSouls: Edit Soul" — soul.json 없음 | "Create?" 다이얼로그 → 생성 |  |
+| ES-03 | Create 선택 후 | 기본 soul.json 템플릿 생성 + 에디터 열림 |  |
+
+---
+
+## 10. Chat History
+
+| # | 테스트 | 기대 결과 | Pass |
+|---|--------|-----------|------|
+| CH-01 | Chat History 패널 열기 | 과거 세션 목록 표시 |  |
+| CH-02 | 세션 항목 클릭 | 해당 세션 대화 내용 Chat에 로드 |  |
+| CH-03 | 여러 세션 전환 | 각 세션 히스토리 정확히 표시 |  |
+
+---
+
+## 11. Workspace Tracker
+
+| # | 테스트 | 기대 결과 | Pass |
+|---|--------|-----------|------|
+| WT-01 | 프로젝트 폴더 열기 | TOOLS.md에 `## Current Project` 섹션 자동 추가 |  |
+| WT-02 | 다른 프로젝트로 전환 | TOOLS.md 프로젝트 경로 업데이트 |  |
+| WT-03 | Agent 대화에서 프로젝트 컨텍스트 | Agent가 현재 프로젝트 경로 인식 |  |
+
+---
+
+## 12. Activity Bar & UI
+
+| # | 테스트 | 기대 결과 | Pass |
+|---|--------|-----------|------|
+| UI-01 | Activity bar 아이콘 확인 | 새 SVG 아이콘 표시 |  |
+| UI-02 | Swarm Memory 패널 이름 | "Swarm Memory" (not "Swarm") |  |
+| UI-03 | Swarm Memory 아이콘 | 다이아몬드+화살표 PNG 아이콘 |  |
+| UI-04 | 다크 테마에서 전체 UI | 가독성 확인 |  |
+| UI-05 | 라이트 테마에서 전체 UI | 가독성 확인 |  |
+
+---
+
+## 13. Cross-Platform
+
+| # | 테스트 | 기대 결과 | Pass |
+|---|--------|-----------|------|
+| XP-01 | Windows + Anthropic | Chat 정상 동작 |  |
+| XP-02 | Windows + Ollama | Chat 정상 동작 |  |
+| XP-03 | Mac + Anthropic | Chat 정상 동작 |  |
+| XP-04 | Mac + Ollama | Chat 정상 동작 |  |
+
+---
+
+## Summary
+
+| 카테고리 | 항목 수 |
+|----------|---------|
+| Setup Wizard | 14 |
+| Gateway | 4 |
+| Chat | 11 |
+| Status Bar | 6 |
+| Soul Explorer | 9 |
+| Checkpoint | 9 |
+| Swarm Memory | 24 |
+| SoulScan | 3 |
+| Edit Soul | 3 |
+| Chat History | 3 |
+| Workspace Tracker | 3 |
+| UI | 5 |
+| Cross-Platform | 4 |
+| **Total** | **98** |

package/esbuild.mjs

@@ -0,0 +1,59 @@
+import esbuild from 'esbuild';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const production = process.argv.includes('--production');
+const watch = process.argv.includes('--watch');
+
+/**
+ * @type {import('esbuild').Plugin}
+ */
+const esbuildProblemMatcherPlugin = {
+  name: 'esbuild-problem-matcher',
+
+  setup(build) {
+    build.onStart(() => {
+      console.log('[watch] build started');
+    });
+    build.onEnd((result) => {
+      result.errors.forEach(({ text, location }) => {
+        console.error(`✘ [ERROR] ${text}`);
+        console.error(`    ${location.file}:${location.line}:${location.column}:`);
+      });
+      console.log('[watch] build finished');
+    });
+  },
+};
+
+async function main() {
+  const ctx = await esbuild.context({
+    entryPoints: ['src/extension.ts'],
+    bundle: true,
+    format: 'cjs',
+    minify: production,
+    sourcemap: !production,
+    sourcesContent: false,
+    platform: 'node',
+    outfile: 'dist/extension.js',
+    external: ['vscode'],
+    logLevel: 'silent',
+    plugins: [
+      esbuildProblemMatcherPlugin,
+    ],
+  });
+
+  if (watch) {
+    await ctx.watch();
+  } else {
+    await ctx.rebuild();
+    await ctx.dispose();
+  }
+}
+
+main().catch(e => {
+  console.error(e);
+  process.exit(1);
+});