sari 0.0.1__tar.gz → 0.0.2__tar.gz

{sari-0.0.1/sari.egg-info → sari-0.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sari
-Version: 0.0.1
+Version: 0.0.2
 Summary: Sari - Local Search MCP Server
 Author: Horadric
 License: MIT License
@@ -66,23 +66,42 @@ Dynamic: license-file
 
 ## 🚀 성역 소환 주문 (설치 방법 - Installation)
 
-터미널(Terminal)을 열고 아래 마법 주문을 딱 한 줄만 복사해서 붙여넣고 엔터(Enter)를 누르세요!  
-이 명령어는 **최초 설치**뿐만 아니라, **새로운 워크스페이스 연동**에도 똑같이 사용됩니다.
+> **중요:** `deckard` 모듈/엔트리포인트는 **호환용으로만 유지**됩니다.  
+> 앞으로는 **Sari 이름을 사용**해 주세요. (향후 버전에서 제거 예정)
+
+설치 방식은 두 가지입니다.
+
+1) **설정만 추가하면 자동 설치 (권장)**  
+2) **직접 설치 (오프라인/제한 환경용)**
+
+### ✅ 1) 설정만 추가하면 자동 설치 (권장)
+MCP 설정 파일에 아래 블록을 **직접 추가**하면, 실행 시 Sari가 자동 설치됩니다.
+
+```toml
+[mcp_servers.sari]
+command = "bash"
+args = ["-lc", "if [ -x ~/.local/share/sari/bootstrap.sh ]; then if [ \"${SARI_AUTO_UPDATE:-}\" = \"1\" ]; then if [ -n \"${SARI_VERSION:-}\" ]; then curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/v${SARI_VERSION}/install.py | python3 - -y --update; else curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - -y --update; fi; fi; exec ~/.local/share/sari/bootstrap.sh --transport stdio; else if [ -n \"${SARI_VERSION:-}\" ]; then curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/v${SARI_VERSION}/install.py | python3 - -y; else curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - -y; fi; exec ~/.local/share/sari/bootstrap.sh --transport stdio; fi"]
+env = { DECKARD_WORKSPACE_ROOT = "/path/to/workspace", DECKARD_RESPONSE_COMPACT = "1", SARI_VERSION = "0.0.2", SARI_AUTO_UPDATE = "0" }
+startup_timeout_sec = 60
+```
+
+### 🧰 2) 직접 설치 (오프라인/제한 환경용)
+터미널(Terminal)에서 직접 설치도 가능합니다.
 
 ```bash
-# macOS / Linux (유닉스의 축복을 받은 자들)
+# macOS / Linux
 curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - -y
 
-# Windows (파워쉘의 마법사들)
+# Windows (PowerShell)
 irm https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python - -y
 ```
 
 ### 📖 호라드림의 설치 계시 (How it works)
-사리 선생님의 설치 마법은 아주 영리하게 동작합니다:
+사리 선생님의 설치 마법은 이렇게 동작합니다:
 
-1.  **최초 소환:** 사리가 없는 컴퓨터에서 실행하면, `~/.local/share/sari`에 전역 설치를 진행하고 현재 워크스페이스를 연동합니다.
-2.  **워크스페이스 추가:** 이미 사리가 설치된 컴퓨터라면, **불필요한 재설치 없이** 현재 폴더에 필요한 설정 파일(`.codex/config.toml` 등)만 번개처럼 빠르게 생성합니다.
-3.  **자동화 우호적:** `-y` 옵션을 통해 파이프라인 설치 시 발생할 수 있는 입력 오류(EOFError)를 원천 차단합니다.
+1. **설정만 추가** → 실행 시 네트워크에서 자동 설치
+2. 설치 위치는 항상 **전역 고정** (`~/.local/share/sari` / `%LOCALAPPDATA%\\sari`)
+3. 데몬은 **항상 하나**로 유지
 
 
 ### 설치하면 어떤 마법이 일어나나요?
@@ -90,14 +109,11 @@ irm https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python
 2.  **비밀 거처 마련**: 도서관 주소를 만듭니다. (이사 비용은 무료입니다.)
     - **macOS/Linux**: `~/.local/share/sari` (사과 마크가 찍힌 비밀 창고)
     - **Windows**: `%LOCALAPPDATA%\sari` (창문이 달린 비밀 창고)
-3.  **통역기 연결**: AI 에이전트들이 사리 선생님께 "헬프!"를 외칠 수 있도록 MCP 통역기를 연결합니다.
-
-### 설정은 어디에 숨겨지나요? (쌍둥이 CLI 지원)
-설치 스크립트(`install.py`)는 **설정이 지옥의 촉수처럼 흩어져 충돌**나는 것을 막기 위해 다음처럼 엄격하게 동작합니다.
+3.  **통역기 연결**: MCP 설정 블록만 추가하면 실행 시 자동으로 연결됩니다.
 
-- **쌍둥이의 축복**: 현재 작업 폴더의 `.codex/config.toml`과 `.gemini/config.toml` 양쪽에 사리 선생님의 영혼 인장을 동시에 찍습니다. (하나만 하면 섭섭하니까요.)
-- **부정한 유산 정화**: `~/.codex/config.toml`과 `~/.gemini/config.toml`에 남아있던 케케묵은 설정들은 자비 없이 불태워 소멸시킵니다. (오직 깨끗한 것만이 살아남으리!)
-- **성역의 예절**: Claude/Cursor 설정은 **함부로 발을 들이지 않습니다.** (남의 집 안방 가구는 집주인이 직접 옮기는 게 도리죠.) 필요하면 아래 비급 예시를 보고 직접 수련하여 옮기시게나.
+### 설정은 어디에 숨겨지나요? (수동 등록 방식)
+**설정 파일은 자동으로 수정하지 않습니다.**  
+Codex/Gemini는 TOML, Cursor/Claude는 JSON 형식으로 동일 내용을 넣어주세요.
 
 ### 여러 워크스페이스를 동시에? (분신술의 대가)
 - **설정은 워크스페이스별로 각자의 운명**을 가집니다.  
@@ -108,21 +124,14 @@ irm https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python
 
 ---
 
-## 🪄 1‑Step 모드 vs 설치본 고정 모드
+## 🪄 설치 옵션 (대안)
 
-**1‑Step 모드(권장)**  
-레포의 `bootstrap.sh`를 config에 등록하면, 첫 실행 시 자동 설치/업데이트 후 **설치본으로 전환**됩니다.
-
-**설치본 고정 모드**  
-설치본 경로 `~/.local/share/sari/bootstrap.sh`를 등록하면 **자동 업데이트 없이** 고정된 버전을 사용합니다. (변화를 거부하는 보수적인 사서 모드입니다.)
-
-**자동 업데이트 기준**  
-레포 tag와 설치본 `VERSION`이 다르면, 레포의 `bootstrap.sh`가 `install.py`를 자동 실행합니다.
+**오프라인/제한 환경용**  
+설정에서 `command`를 설치본 `bootstrap.sh`로 직접 지정하면 네트워크 없이 실행할 수 있습니다.
 
 **bootstrap 스크립트 위치**
-- **macOS/Linux (레포)**: `/path/to/sari/bootstrap.sh`
-- **macOS/Linux (설치본)**: `~/.local/share/sari/bootstrap.sh`
-- **Windows (설치본)**: `%LOCALAPPDATA%\sari\bootstrap.bat`
+- **macOS/Linux**: `~/.local/share/sari/bootstrap.sh`
+- **Windows**: `%LOCALAPPDATA%\\sari\\bootstrap.bat`
 
 ---
 
@@ -193,8 +202,8 @@ python3 ~/.local/share/sari/doctor.py
 ## 🧯 문제 해결 (Troubleshooting)
 
 ### Q. MCP 연결이 안 돼요
-- `command` 경로가 실제 존재하는지 확인하세요.  
-  (레포 경로인지 설치본 경로인지 헷갈리기 쉬워요!)
+- `command`가 `bash`인지, 그리고 네트워크가 허용되는지 확인하세요.
+- 제한 환경이라면 **설치본 bootstrap 경로**로 전환하세요.
 - 데몬 상태 확인:
   ```bash
   # macOS/Linux
@@ -213,11 +222,14 @@ python3 ~/.local/share/sari/doctor.py
 - 격리된 환경에서 실행하려면 `scripts/run_tests_isolated.sh`를 사용하세요. (HOME/registry/log/port 분리)
 
 ### Q. 업데이트가 안 되는 것 같아요
-- **1‑Step 모드인지 확인**하세요 (레포 `bootstrap.sh` 사용).
 - 설치본 `VERSION`을 확인하세요:
   ```bash
   cat ~/.local/share/sari/VERSION
   ```
+- 필요하면 강제 업데이트:
+  ```bash
+  curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - --update -y
+  ```
 
 ### Q. 설정 파일이 여기저기 생겼어요
 - 사리 선생님은 **글로벌 설정과 프로젝트 설정이 뒤섞여 혼돈이 오는 걸 극도로 혐오합니다.**  
@@ -332,45 +344,35 @@ Sari는 인덱싱 + FTS 기반 검색 구조라서 **“어떤 단계에서 쓰
 {
   "mcpServers": {
     "sari": {
-      "command": "/Users/[사용자명]/.local/share/sari/bootstrap.sh",
-      "args": []
+      "command": "bash",
+      "args": [
+        "-lc",
+        "if [ -x ~/.local/share/sari/bootstrap.sh ]; then if [ \"${SARI_AUTO_UPDATE:-}\" = \"1\" ]; then if [ -n \"${SARI_VERSION:-}\" ]; then curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/v${SARI_VERSION}/install.py | python3 - -y --update; else curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - -y --update; fi; fi; exec ~/.local/share/sari/bootstrap.sh --transport stdio; else if [ -n \"${SARI_VERSION:-}\" ]; then curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/v${SARI_VERSION}/install.py | python3 - -y; else curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - -y; fi; exec ~/.local/share/sari/bootstrap.sh --transport stdio; fi"
+      ],
+      "env": {
+        "DECKARD_WORKSPACE_ROOT": "/Users/[사용자명]/path/to/workspace",
+        "DECKARD_RESPONSE_COMPACT": "1"
+      }
     }
   }
 }
 ```
 
 ### 🧩 Codex / Gemini 설정 예시 (config.toml)
-> 아래는 **설치본 고정 모드** 예시입니다. 1‑Step 모드를 쓰려면 `command`를 레포 경로로 바꾸세요.
-
-```toml
-[mcp_servers.sari]
-command = "/Users/[사용자명]/.local/share/sari/bootstrap.sh"
-args = ["--workspace-root", "/Users/[사용자명]/path/to/workspace"]
-env = { DECKARD_WORKSPACE_ROOT = "/Users/[사용자명]/path/to/workspace" }
-startup_timeout_sec = 60
-```
-
-**1‑Step 모드 예시 (레포 bootstrap 사용)**
 ```toml
 [mcp_servers.sari]
-command = "/Users/[사용자명]/path/to/sari/bootstrap.sh"
-args = ["--workspace-root", "/Users/[사용자명]/path/to/workspace"]
-env = { DECKARD_WORKSPACE_ROOT = "/Users/[사용자명]/path/to/workspace" }
+command = "bash"
+args = ["-lc", "if [ -x ~/.local/share/sari/bootstrap.sh ]; then if [ \"${SARI_AUTO_UPDATE:-}\" = \"1\" ]; then if [ -n \"${SARI_VERSION:-}\" ]; then curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/v${SARI_VERSION}/install.py | python3 - -y --update; else curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - -y --update; fi; fi; exec ~/.local/share/sari/bootstrap.sh --transport stdio; else if [ -n \"${SARI_VERSION:-}\" ]; then curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/v${SARI_VERSION}/install.py | python3 - -y; else curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - -y; fi; exec ~/.local/share/sari/bootstrap.sh --transport stdio; fi"]
+env = { DECKARD_WORKSPACE_ROOT = "/Users/[사용자명]/path/to/workspace", DECKARD_RESPONSE_COMPACT = "1" }
 startup_timeout_sec = 60
 ```
 
 **필드별 상세 설명**
 - `command`: 사리를 실행할 경로입니다.  
-  - **1‑Step 모드**: 레포의 `bootstrap.sh` 경로  
-    예) `/path/to/sari/bootstrap.sh`
-  - **설치본 고정 모드**: 설치본의 `bootstrap.sh` 경로  
-    예) `~/.local/share/sari/bootstrap.sh`
-- `args`: 실행 옵션을 리스트로 전달합니다.  
-  - `--workspace-root <path>`: 인덱싱할 워크스페이스 루트 경로  
-  - **생략 시**: 현재 실행 위치를 기준으로 동작하거나, `.codex-root`가 있는 상위 폴더를 기준으로 동작합니다.
+- `command`: 기본은 `bash` (네트워크 자동 설치 방식).
+- `args`: `curl | python3`로 설치 후 `bootstrap.sh` 실행.
 - `env`: 환경 변수를 강제로 주입합니다.  
   - `DECKARD_WORKSPACE_ROOT`는 **workspace-root를 고정**하려고 넣습니다.  
-  - `args`와 **동일한 값**을 넣는 것이 권장됩니다. (둘 중 하나만 있어도 동작합니다)
 - `startup_timeout_sec`: 데몬 기동 대기 시간(초).  
   초기 인덱싱이 길다면 120~180으로 늘려보세요.
 

{sari-0.0.1 → sari-0.0.2}/README.md

@@ -33,23 +33,42 @@
 
 ## 🚀 성역 소환 주문 (설치 방법 - Installation)
 
-터미널(Terminal)을 열고 아래 마법 주문을 딱 한 줄만 복사해서 붙여넣고 엔터(Enter)를 누르세요!  
-이 명령어는 **최초 설치**뿐만 아니라, **새로운 워크스페이스 연동**에도 똑같이 사용됩니다.
+> **중요:** `deckard` 모듈/엔트리포인트는 **호환용으로만 유지**됩니다.  
+> 앞으로는 **Sari 이름을 사용**해 주세요. (향후 버전에서 제거 예정)
+
+설치 방식은 두 가지입니다.
+
+1) **설정만 추가하면 자동 설치 (권장)**  
+2) **직접 설치 (오프라인/제한 환경용)**
+
+### ✅ 1) 설정만 추가하면 자동 설치 (권장)
+MCP 설정 파일에 아래 블록을 **직접 추가**하면, 실행 시 Sari가 자동 설치됩니다.
+
+```toml
+[mcp_servers.sari]
+command = "bash"
+args = ["-lc", "if [ -x ~/.local/share/sari/bootstrap.sh ]; then if [ \"${SARI_AUTO_UPDATE:-}\" = \"1\" ]; then if [ -n \"${SARI_VERSION:-}\" ]; then curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/v${SARI_VERSION}/install.py | python3 - -y --update; else curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - -y --update; fi; fi; exec ~/.local/share/sari/bootstrap.sh --transport stdio; else if [ -n \"${SARI_VERSION:-}\" ]; then curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/v${SARI_VERSION}/install.py | python3 - -y; else curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - -y; fi; exec ~/.local/share/sari/bootstrap.sh --transport stdio; fi"]
+env = { DECKARD_WORKSPACE_ROOT = "/path/to/workspace", DECKARD_RESPONSE_COMPACT = "1", SARI_VERSION = "0.0.2", SARI_AUTO_UPDATE = "0" }
+startup_timeout_sec = 60
+```
+
+### 🧰 2) 직접 설치 (오프라인/제한 환경용)
+터미널(Terminal)에서 직접 설치도 가능합니다.
 
 ```bash
-# macOS / Linux (유닉스의 축복을 받은 자들)
+# macOS / Linux
 curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - -y
 
-# Windows (파워쉘의 마법사들)
+# Windows (PowerShell)
 irm https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python - -y
 ```
 
 ### 📖 호라드림의 설치 계시 (How it works)
-사리 선생님의 설치 마법은 아주 영리하게 동작합니다:
+사리 선생님의 설치 마법은 이렇게 동작합니다:
 
-1.  **최초 소환:** 사리가 없는 컴퓨터에서 실행하면, `~/.local/share/sari`에 전역 설치를 진행하고 현재 워크스페이스를 연동합니다.
-2.  **워크스페이스 추가:** 이미 사리가 설치된 컴퓨터라면, **불필요한 재설치 없이** 현재 폴더에 필요한 설정 파일(`.codex/config.toml` 등)만 번개처럼 빠르게 생성합니다.
-3.  **자동화 우호적:** `-y` 옵션을 통해 파이프라인 설치 시 발생할 수 있는 입력 오류(EOFError)를 원천 차단합니다.
+1. **설정만 추가** → 실행 시 네트워크에서 자동 설치
+2. 설치 위치는 항상 **전역 고정** (`~/.local/share/sari` / `%LOCALAPPDATA%\\sari`)
+3. 데몬은 **항상 하나**로 유지
 
 
 ### 설치하면 어떤 마법이 일어나나요?
@@ -57,14 +76,11 @@ irm https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python
 2.  **비밀 거처 마련**: 도서관 주소를 만듭니다. (이사 비용은 무료입니다.)
     - **macOS/Linux**: `~/.local/share/sari` (사과 마크가 찍힌 비밀 창고)
     - **Windows**: `%LOCALAPPDATA%\sari` (창문이 달린 비밀 창고)
-3.  **통역기 연결**: AI 에이전트들이 사리 선생님께 "헬프!"를 외칠 수 있도록 MCP 통역기를 연결합니다.
-
-### 설정은 어디에 숨겨지나요? (쌍둥이 CLI 지원)
-설치 스크립트(`install.py`)는 **설정이 지옥의 촉수처럼 흩어져 충돌**나는 것을 막기 위해 다음처럼 엄격하게 동작합니다.
+3.  **통역기 연결**: MCP 설정 블록만 추가하면 실행 시 자동으로 연결됩니다.
 
-- **쌍둥이의 축복**: 현재 작업 폴더의 `.codex/config.toml`과 `.gemini/config.toml` 양쪽에 사리 선생님의 영혼 인장을 동시에 찍습니다. (하나만 하면 섭섭하니까요.)
-- **부정한 유산 정화**: `~/.codex/config.toml`과 `~/.gemini/config.toml`에 남아있던 케케묵은 설정들은 자비 없이 불태워 소멸시킵니다. (오직 깨끗한 것만이 살아남으리!)
-- **성역의 예절**: Claude/Cursor 설정은 **함부로 발을 들이지 않습니다.** (남의 집 안방 가구는 집주인이 직접 옮기는 게 도리죠.) 필요하면 아래 비급 예시를 보고 직접 수련하여 옮기시게나.
+### 설정은 어디에 숨겨지나요? (수동 등록 방식)
+**설정 파일은 자동으로 수정하지 않습니다.**  
+Codex/Gemini는 TOML, Cursor/Claude는 JSON 형식으로 동일 내용을 넣어주세요.
 
 ### 여러 워크스페이스를 동시에? (분신술의 대가)
 - **설정은 워크스페이스별로 각자의 운명**을 가집니다.  
@@ -75,21 +91,14 @@ irm https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python
 
 ---
 
-## 🪄 1‑Step 모드 vs 설치본 고정 모드
+## 🪄 설치 옵션 (대안)
 
-**1‑Step 모드(권장)**  
-레포의 `bootstrap.sh`를 config에 등록하면, 첫 실행 시 자동 설치/업데이트 후 **설치본으로 전환**됩니다.
-
-**설치본 고정 모드**  
-설치본 경로 `~/.local/share/sari/bootstrap.sh`를 등록하면 **자동 업데이트 없이** 고정된 버전을 사용합니다. (변화를 거부하는 보수적인 사서 모드입니다.)
-
-**자동 업데이트 기준**  
-레포 tag와 설치본 `VERSION`이 다르면, 레포의 `bootstrap.sh`가 `install.py`를 자동 실행합니다.
+**오프라인/제한 환경용**  
+설정에서 `command`를 설치본 `bootstrap.sh`로 직접 지정하면 네트워크 없이 실행할 수 있습니다.
 
 **bootstrap 스크립트 위치**
-- **macOS/Linux (레포)**: `/path/to/sari/bootstrap.sh`
-- **macOS/Linux (설치본)**: `~/.local/share/sari/bootstrap.sh`
-- **Windows (설치본)**: `%LOCALAPPDATA%\sari\bootstrap.bat`
+- **macOS/Linux**: `~/.local/share/sari/bootstrap.sh`
+- **Windows**: `%LOCALAPPDATA%\\sari\\bootstrap.bat`
 
 ---
 
@@ -160,8 +169,8 @@ python3 ~/.local/share/sari/doctor.py
 ## 🧯 문제 해결 (Troubleshooting)
 
 ### Q. MCP 연결이 안 돼요
-- `command` 경로가 실제 존재하는지 확인하세요.  
-  (레포 경로인지 설치본 경로인지 헷갈리기 쉬워요!)
+- `command`가 `bash`인지, 그리고 네트워크가 허용되는지 확인하세요.
+- 제한 환경이라면 **설치본 bootstrap 경로**로 전환하세요.
 - 데몬 상태 확인:
   ```bash
   # macOS/Linux
@@ -180,11 +189,14 @@ python3 ~/.local/share/sari/doctor.py
 - 격리된 환경에서 실행하려면 `scripts/run_tests_isolated.sh`를 사용하세요. (HOME/registry/log/port 분리)
 
 ### Q. 업데이트가 안 되는 것 같아요
-- **1‑Step 모드인지 확인**하세요 (레포 `bootstrap.sh` 사용).
 - 설치본 `VERSION`을 확인하세요:
   ```bash
   cat ~/.local/share/sari/VERSION
   ```
+- 필요하면 강제 업데이트:
+  ```bash
+  curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - --update -y
+  ```
 
 ### Q. 설정 파일이 여기저기 생겼어요
 - 사리 선생님은 **글로벌 설정과 프로젝트 설정이 뒤섞여 혼돈이 오는 걸 극도로 혐오합니다.**  
@@ -299,45 +311,35 @@ Sari는 인덱싱 + FTS 기반 검색 구조라서 **“어떤 단계에서 쓰
 {
   "mcpServers": {
     "sari": {
-      "command": "/Users/[사용자명]/.local/share/sari/bootstrap.sh",
-      "args": []
+      "command": "bash",
+      "args": [
+        "-lc",
+        "if [ -x ~/.local/share/sari/bootstrap.sh ]; then if [ \"${SARI_AUTO_UPDATE:-}\" = \"1\" ]; then if [ -n \"${SARI_VERSION:-}\" ]; then curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/v${SARI_VERSION}/install.py | python3 - -y --update; else curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - -y --update; fi; fi; exec ~/.local/share/sari/bootstrap.sh --transport stdio; else if [ -n \"${SARI_VERSION:-}\" ]; then curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/v${SARI_VERSION}/install.py | python3 - -y; else curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - -y; fi; exec ~/.local/share/sari/bootstrap.sh --transport stdio; fi"
+      ],
+      "env": {
+        "DECKARD_WORKSPACE_ROOT": "/Users/[사용자명]/path/to/workspace",
+        "DECKARD_RESPONSE_COMPACT": "1"
+      }
     }
   }
 }
 ```
 
 ### 🧩 Codex / Gemini 설정 예시 (config.toml)
-> 아래는 **설치본 고정 모드** 예시입니다. 1‑Step 모드를 쓰려면 `command`를 레포 경로로 바꾸세요.
-
-```toml
-[mcp_servers.sari]
-command = "/Users/[사용자명]/.local/share/sari/bootstrap.sh"
-args = ["--workspace-root", "/Users/[사용자명]/path/to/workspace"]
-env = { DECKARD_WORKSPACE_ROOT = "/Users/[사용자명]/path/to/workspace" }
-startup_timeout_sec = 60
-```
-
-**1‑Step 모드 예시 (레포 bootstrap 사용)**
 ```toml
 [mcp_servers.sari]
-command = "/Users/[사용자명]/path/to/sari/bootstrap.sh"
-args = ["--workspace-root", "/Users/[사용자명]/path/to/workspace"]
-env = { DECKARD_WORKSPACE_ROOT = "/Users/[사용자명]/path/to/workspace" }
+command = "bash"
+args = ["-lc", "if [ -x ~/.local/share/sari/bootstrap.sh ]; then if [ \"${SARI_AUTO_UPDATE:-}\" = \"1\" ]; then if [ -n \"${SARI_VERSION:-}\" ]; then curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/v${SARI_VERSION}/install.py | python3 - -y --update; else curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - -y --update; fi; fi; exec ~/.local/share/sari/bootstrap.sh --transport stdio; else if [ -n \"${SARI_VERSION:-}\" ]; then curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/v${SARI_VERSION}/install.py | python3 - -y; else curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - -y; fi; exec ~/.local/share/sari/bootstrap.sh --transport stdio; fi"]
+env = { DECKARD_WORKSPACE_ROOT = "/Users/[사용자명]/path/to/workspace", DECKARD_RESPONSE_COMPACT = "1" }
 startup_timeout_sec = 60
 ```
 
 **필드별 상세 설명**
 - `command`: 사리를 실행할 경로입니다.  
-  - **1‑Step 모드**: 레포의 `bootstrap.sh` 경로  
-    예) `/path/to/sari/bootstrap.sh`
-  - **설치본 고정 모드**: 설치본의 `bootstrap.sh` 경로  
-    예) `~/.local/share/sari/bootstrap.sh`
-- `args`: 실행 옵션을 리스트로 전달합니다.  
-  - `--workspace-root <path>`: 인덱싱할 워크스페이스 루트 경로  
-  - **생략 시**: 현재 실행 위치를 기준으로 동작하거나, `.codex-root`가 있는 상위 폴더를 기준으로 동작합니다.
+- `command`: 기본은 `bash` (네트워크 자동 설치 방식).
+- `args`: `curl | python3`로 설치 후 `bootstrap.sh` 실행.
 - `env`: 환경 변수를 강제로 주입합니다.  
   - `DECKARD_WORKSPACE_ROOT`는 **workspace-root를 고정**하려고 넣습니다.  
-  - `args`와 **동일한 값**을 넣는 것이 권장됩니다. (둘 중 하나만 있어도 동작합니다)
 - `startup_timeout_sec`: 데몬 기동 대기 시간(초).  
   초기 인덱싱이 길다면 120~180으로 늘려보세요.
 

{sari-0.0.1 → sari-0.0.2}/app/config.py

@@ -62,7 +62,19 @@ class Config:
             "db_path": str(WorkspaceManager.get_local_db_path(workspace_root)),
             "include_ext": [".py", ".js", ".ts", ".java", ".kt", ".go", ".rs", ".md", ".json", ".yaml", ".yml", ".sh"],
             "include_files": ["pom.xml", "package.json", "Dockerfile", "Makefile", "build.gradle", "settings.gradle"],
-            "exclude_dirs": [".git", "node_modules", "__pycache__", ".venv", "venv", "target", "build", "dist", "coverage", "vendor"],
+            "exclude_dirs": [
+                ".git",
+                "node_modules",
+                "__pycache__",
+                ".venv",
+                "venv",
+                "target",
+                "build",
+                "dist",
+                "coverage",
+                "vendor",
+                "data",
+            ],
             "exclude_globs": [
                 "*.min.js",
                 "*.min.css",
@@ -75,6 +87,9 @@ class Config:
                 "*.pyc",
                 "*.pyo",
                 "__pycache__/*",
+                "*.db",
+                "*.db-shm",
+                "*.db-wal",
             ],
             "redact_enabled": True,
             "commit_batch_size": 500,

sari-0.0.2/deckard/version.py

@@ -0,0 +1 @@
+__version__ = "0.0.2"

{sari-0.0.1 → sari-0.0.2/sari.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sari
-Version: 0.0.1
+Version: 0.0.2
 Summary: Sari - Local Search MCP Server
 Author: Horadric
 License: MIT License
@@ -66,23 +66,42 @@ Dynamic: license-file
 
 ## 🚀 성역 소환 주문 (설치 방법 - Installation)
 
-터미널(Terminal)을 열고 아래 마법 주문을 딱 한 줄만 복사해서 붙여넣고 엔터(Enter)를 누르세요!  
-이 명령어는 **최초 설치**뿐만 아니라, **새로운 워크스페이스 연동**에도 똑같이 사용됩니다.
+> **중요:** `deckard` 모듈/엔트리포인트는 **호환용으로만 유지**됩니다.  
+> 앞으로는 **Sari 이름을 사용**해 주세요. (향후 버전에서 제거 예정)
+
+설치 방식은 두 가지입니다.
+
+1) **설정만 추가하면 자동 설치 (권장)**  
+2) **직접 설치 (오프라인/제한 환경용)**
+
+### ✅ 1) 설정만 추가하면 자동 설치 (권장)
+MCP 설정 파일에 아래 블록을 **직접 추가**하면, 실행 시 Sari가 자동 설치됩니다.
+
+```toml
+[mcp_servers.sari]
+command = "bash"
+args = ["-lc", "if [ -x ~/.local/share/sari/bootstrap.sh ]; then if [ \"${SARI_AUTO_UPDATE:-}\" = \"1\" ]; then if [ -n \"${SARI_VERSION:-}\" ]; then curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/v${SARI_VERSION}/install.py | python3 - -y --update; else curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - -y --update; fi; fi; exec ~/.local/share/sari/bootstrap.sh --transport stdio; else if [ -n \"${SARI_VERSION:-}\" ]; then curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/v${SARI_VERSION}/install.py | python3 - -y; else curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - -y; fi; exec ~/.local/share/sari/bootstrap.sh --transport stdio; fi"]
+env = { DECKARD_WORKSPACE_ROOT = "/path/to/workspace", DECKARD_RESPONSE_COMPACT = "1", SARI_VERSION = "0.0.2", SARI_AUTO_UPDATE = "0" }
+startup_timeout_sec = 60
+```
+
+### 🧰 2) 직접 설치 (오프라인/제한 환경용)
+터미널(Terminal)에서 직접 설치도 가능합니다.
 
 ```bash
-# macOS / Linux (유닉스의 축복을 받은 자들)
+# macOS / Linux
 curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - -y
 
-# Windows (파워쉘의 마법사들)
+# Windows (PowerShell)
 irm https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python - -y
 ```
 
 ### 📖 호라드림의 설치 계시 (How it works)
-사리 선생님의 설치 마법은 아주 영리하게 동작합니다:
+사리 선생님의 설치 마법은 이렇게 동작합니다:
 
-1.  **최초 소환:** 사리가 없는 컴퓨터에서 실행하면, `~/.local/share/sari`에 전역 설치를 진행하고 현재 워크스페이스를 연동합니다.
-2.  **워크스페이스 추가:** 이미 사리가 설치된 컴퓨터라면, **불필요한 재설치 없이** 현재 폴더에 필요한 설정 파일(`.codex/config.toml` 등)만 번개처럼 빠르게 생성합니다.
-3.  **자동화 우호적:** `-y` 옵션을 통해 파이프라인 설치 시 발생할 수 있는 입력 오류(EOFError)를 원천 차단합니다.
+1. **설정만 추가** → 실행 시 네트워크에서 자동 설치
+2. 설치 위치는 항상 **전역 고정** (`~/.local/share/sari` / `%LOCALAPPDATA%\\sari`)
+3. 데몬은 **항상 하나**로 유지
 
 
 ### 설치하면 어떤 마법이 일어나나요?
@@ -90,14 +109,11 @@ irm https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python
 2.  **비밀 거처 마련**: 도서관 주소를 만듭니다. (이사 비용은 무료입니다.)
     - **macOS/Linux**: `~/.local/share/sari` (사과 마크가 찍힌 비밀 창고)
     - **Windows**: `%LOCALAPPDATA%\sari` (창문이 달린 비밀 창고)
-3.  **통역기 연결**: AI 에이전트들이 사리 선생님께 "헬프!"를 외칠 수 있도록 MCP 통역기를 연결합니다.
-
-### 설정은 어디에 숨겨지나요? (쌍둥이 CLI 지원)
-설치 스크립트(`install.py`)는 **설정이 지옥의 촉수처럼 흩어져 충돌**나는 것을 막기 위해 다음처럼 엄격하게 동작합니다.
+3.  **통역기 연결**: MCP 설정 블록만 추가하면 실행 시 자동으로 연결됩니다.
 
-- **쌍둥이의 축복**: 현재 작업 폴더의 `.codex/config.toml`과 `.gemini/config.toml` 양쪽에 사리 선생님의 영혼 인장을 동시에 찍습니다. (하나만 하면 섭섭하니까요.)
-- **부정한 유산 정화**: `~/.codex/config.toml`과 `~/.gemini/config.toml`에 남아있던 케케묵은 설정들은 자비 없이 불태워 소멸시킵니다. (오직 깨끗한 것만이 살아남으리!)
-- **성역의 예절**: Claude/Cursor 설정은 **함부로 발을 들이지 않습니다.** (남의 집 안방 가구는 집주인이 직접 옮기는 게 도리죠.) 필요하면 아래 비급 예시를 보고 직접 수련하여 옮기시게나.
+### 설정은 어디에 숨겨지나요? (수동 등록 방식)
+**설정 파일은 자동으로 수정하지 않습니다.**  
+Codex/Gemini는 TOML, Cursor/Claude는 JSON 형식으로 동일 내용을 넣어주세요.
 
 ### 여러 워크스페이스를 동시에? (분신술의 대가)
 - **설정은 워크스페이스별로 각자의 운명**을 가집니다.  
@@ -108,21 +124,14 @@ irm https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python
 
 ---
 
-## 🪄 1‑Step 모드 vs 설치본 고정 모드
+## 🪄 설치 옵션 (대안)
 
-**1‑Step 모드(권장)**  
-레포의 `bootstrap.sh`를 config에 등록하면, 첫 실행 시 자동 설치/업데이트 후 **설치본으로 전환**됩니다.
-
-**설치본 고정 모드**  
-설치본 경로 `~/.local/share/sari/bootstrap.sh`를 등록하면 **자동 업데이트 없이** 고정된 버전을 사용합니다. (변화를 거부하는 보수적인 사서 모드입니다.)
-
-**자동 업데이트 기준**  
-레포 tag와 설치본 `VERSION`이 다르면, 레포의 `bootstrap.sh`가 `install.py`를 자동 실행합니다.
+**오프라인/제한 환경용**  
+설정에서 `command`를 설치본 `bootstrap.sh`로 직접 지정하면 네트워크 없이 실행할 수 있습니다.
 
 **bootstrap 스크립트 위치**
-- **macOS/Linux (레포)**: `/path/to/sari/bootstrap.sh`
-- **macOS/Linux (설치본)**: `~/.local/share/sari/bootstrap.sh`
-- **Windows (설치본)**: `%LOCALAPPDATA%\sari\bootstrap.bat`
+- **macOS/Linux**: `~/.local/share/sari/bootstrap.sh`
+- **Windows**: `%LOCALAPPDATA%\\sari\\bootstrap.bat`
 
 ---
 
@@ -193,8 +202,8 @@ python3 ~/.local/share/sari/doctor.py
 ## 🧯 문제 해결 (Troubleshooting)
 
 ### Q. MCP 연결이 안 돼요
-- `command` 경로가 실제 존재하는지 확인하세요.  
-  (레포 경로인지 설치본 경로인지 헷갈리기 쉬워요!)
+- `command`가 `bash`인지, 그리고 네트워크가 허용되는지 확인하세요.
+- 제한 환경이라면 **설치본 bootstrap 경로**로 전환하세요.
 - 데몬 상태 확인:
   ```bash
   # macOS/Linux
@@ -213,11 +222,14 @@ python3 ~/.local/share/sari/doctor.py
 - 격리된 환경에서 실행하려면 `scripts/run_tests_isolated.sh`를 사용하세요. (HOME/registry/log/port 분리)
 
 ### Q. 업데이트가 안 되는 것 같아요
-- **1‑Step 모드인지 확인**하세요 (레포 `bootstrap.sh` 사용).
 - 설치본 `VERSION`을 확인하세요:
   ```bash
   cat ~/.local/share/sari/VERSION
   ```
+- 필요하면 강제 업데이트:
+  ```bash
+  curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - --update -y
+  ```
 
 ### Q. 설정 파일이 여기저기 생겼어요
 - 사리 선생님은 **글로벌 설정과 프로젝트 설정이 뒤섞여 혼돈이 오는 걸 극도로 혐오합니다.**  
@@ -332,45 +344,35 @@ Sari는 인덱싱 + FTS 기반 검색 구조라서 **“어떤 단계에서 쓰
 {
   "mcpServers": {
     "sari": {
-      "command": "/Users/[사용자명]/.local/share/sari/bootstrap.sh",
-      "args": []
+      "command": "bash",
+      "args": [
+        "-lc",
+        "if [ -x ~/.local/share/sari/bootstrap.sh ]; then if [ \"${SARI_AUTO_UPDATE:-}\" = \"1\" ]; then if [ -n \"${SARI_VERSION:-}\" ]; then curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/v${SARI_VERSION}/install.py | python3 - -y --update; else curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - -y --update; fi; fi; exec ~/.local/share/sari/bootstrap.sh --transport stdio; else if [ -n \"${SARI_VERSION:-}\" ]; then curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/v${SARI_VERSION}/install.py | python3 - -y; else curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - -y; fi; exec ~/.local/share/sari/bootstrap.sh --transport stdio; fi"
+      ],
+      "env": {
+        "DECKARD_WORKSPACE_ROOT": "/Users/[사용자명]/path/to/workspace",
+        "DECKARD_RESPONSE_COMPACT": "1"
+      }
     }
   }
 }
 ```
 
 ### 🧩 Codex / Gemini 설정 예시 (config.toml)
-> 아래는 **설치본 고정 모드** 예시입니다. 1‑Step 모드를 쓰려면 `command`를 레포 경로로 바꾸세요.
-
-```toml
-[mcp_servers.sari]
-command = "/Users/[사용자명]/.local/share/sari/bootstrap.sh"
-args = ["--workspace-root", "/Users/[사용자명]/path/to/workspace"]
-env = { DECKARD_WORKSPACE_ROOT = "/Users/[사용자명]/path/to/workspace" }
-startup_timeout_sec = 60
-```
-
-**1‑Step 모드 예시 (레포 bootstrap 사용)**
 ```toml
 [mcp_servers.sari]
-command = "/Users/[사용자명]/path/to/sari/bootstrap.sh"
-args = ["--workspace-root", "/Users/[사용자명]/path/to/workspace"]
-env = { DECKARD_WORKSPACE_ROOT = "/Users/[사용자명]/path/to/workspace" }
+command = "bash"
+args = ["-lc", "if [ -x ~/.local/share/sari/bootstrap.sh ]; then if [ \"${SARI_AUTO_UPDATE:-}\" = \"1\" ]; then if [ -n \"${SARI_VERSION:-}\" ]; then curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/v${SARI_VERSION}/install.py | python3 - -y --update; else curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - -y --update; fi; fi; exec ~/.local/share/sari/bootstrap.sh --transport stdio; else if [ -n \"${SARI_VERSION:-}\" ]; then curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/v${SARI_VERSION}/install.py | python3 - -y; else curl -fsSL https://raw.githubusercontent.com/BaeCheolHan/sari/main/install.py | python3 - -y; fi; exec ~/.local/share/sari/bootstrap.sh --transport stdio; fi"]
+env = { DECKARD_WORKSPACE_ROOT = "/Users/[사용자명]/path/to/workspace", DECKARD_RESPONSE_COMPACT = "1" }
 startup_timeout_sec = 60
 ```
 
 **필드별 상세 설명**
 - `command`: 사리를 실행할 경로입니다.  
-  - **1‑Step 모드**: 레포의 `bootstrap.sh` 경로  
-    예) `/path/to/sari/bootstrap.sh`
-  - **설치본 고정 모드**: 설치본의 `bootstrap.sh` 경로  
-    예) `~/.local/share/sari/bootstrap.sh`
-- `args`: 실행 옵션을 리스트로 전달합니다.  
-  - `--workspace-root <path>`: 인덱싱할 워크스페이스 루트 경로  
-  - **생략 시**: 현재 실행 위치를 기준으로 동작하거나, `.codex-root`가 있는 상위 폴더를 기준으로 동작합니다.
+- `command`: 기본은 `bash` (네트워크 자동 설치 방식).
+- `args`: `curl | python3`로 설치 후 `bootstrap.sh` 실행.
 - `env`: 환경 변수를 강제로 주입합니다.  
   - `DECKARD_WORKSPACE_ROOT`는 **workspace-root를 고정**하려고 넣습니다.  
-  - `args`와 **동일한 값**을 넣는 것이 권장됩니다. (둘 중 하나만 있어도 동작합니다)
 - `startup_timeout_sec`: 데몬 기동 대기 시간(초).  
   초기 인덱싱이 길다면 120~180으로 늘려보세요.
 

sari-0.0.1/deckard/version.py

@@ -1 +0,0 @@
-__version__ = "0.0.1"