deel-local-cli 0.9.0 → 1.0.1

package/README.md

@@ -24,7 +24,7 @@
  ╰──────────────────────────────────────────────────────────────╯
  /help 명령 목록   /think 추론 강도   Ctrl+C 중단·끝내기
 
- ▏myproject ▏qwen2.5-coder:7b ▏▰▰▱▱▱▱▱▱▱▱ 22% 28k/128k ▏◇ medium·절약 ▏auto
+ ▏myproject · qwen2.5-coder:7b ▏ ▰▰▱▱▱▱▱▱▱▱ 22% 28k/128k ▏ ◎ 종합 · ◇ medium·절약 · auto
  ❯ 로그 형식 통일해줘
 
   ❊ Grep(console.log)
@@ -34,7 +34,7 @@
   ◈ Edit(src/runner.js)
     └ 1군데
 
-  로그 호출을 logger 형식으로 통일했습니다. runner.js 한 군데를 고쳤습니다.
+  ▌ 로그 호출을 logger 형식으로 통일했습니다. runner.js 한 군데를 고쳤습니다.
 
   ── 4.2초 · 도구 3회 · ↑3,900 ↓180
 ```
@@ -56,6 +56,7 @@
 - [추론 강도](#추론-강도)
 - [자동 압축](#자동-압축)
 - [대화 이어하기](#대화-이어하기)
+- [밖에서 도구 붙이기 (MCP)](#밖에서-도구-붙이기-mcp)
 - [안전망](#안전망)
 - [사내 반입](#사내-반입)
 - [설정](#설정)
@@ -219,17 +220,21 @@ LM Studio 는 `/api/v0/models`, llama.cpp 는 `/props`. 못 알아보면 `(추
 |---|---|
 | `/help` | 명령 목록 |
 | `/context` | 무엇이 컨텍스트를 먹고 있는지 |
-| `/ctx [auto\|숫자]` | 컨텍스트 **길이** — 모델에 맞춰 다시 재거나 직접 지정 |
+| `/ctx [auto\|숫자\|자세히]` | 컨텍스트 **길이** — 모델에 맞춰 다시 재거나 직접 지정 |
+| `/out [숫자\|auto]` | 한 번에 받을 **답 길이** 상한 — 큰 파일이 잘리면 여기를 올립니다 |
 | `/compact` | 앞선 대화를 요약해서 접기 |
 | `/clear` | 대화 비우기 (연결·규칙은 유지) |
 | `/model` | 연결·모델 바꾸기 |
-| `/think <강도\|배분>` | 추론 강도 (`off·low·medium·high·max`) 또는 배분 (`even·save·deep`) |
+| `/think <강도>` | 추론 강도 (`off·low·medium·high·max`) |
+| `/think 배분 <배분>` | 단계별 배분 (`균일·절약·깊게`) |
+| `/think 자세히` | 단계표 — 어느 단계를 어떤 강도·상한으로 도는지 |
 | `/mode <모드>` | 승인 정책 — 얼마나 물어보나 (`auto` · `confirm` · `strict`) |
 | `/work [모드]` | 작업 모드 — 무슨 일을 하는 중인가 |
 | `/auto` | 다시 맡기기 — 말을 보고 알맞은 모드로 저절로 옮겨 갑니다 |
 | `/code` `/plan` `/architect` `/debug` `/ask` `/orchestrator` | 작업 모드 바로 바꾸기 (그때부터 고정) |
 | `/level [수준]` | 화면에 무엇을 내놓을지 (`쉬움` · `개발자`) |
 | `/undo [턴수]` | 파일 변경 되돌리기 |
+| `/diff [파일]` | 이번 대화에서 바뀐 파일 · 바뀐 자리 보기 |
 | `/tools` | 쓸 수 있는 도구 |
 | `/skills [검색어\|all\|off]` | 스킬 보기·검색·골라 올리기 |
 | `/plugin [install\|remove\|pack]` | 플러그인 관리 |
@@ -237,12 +242,51 @@ LM Studio 는 `/api/v0/models`, llama.cpp 는 `/props`. 못 알아보면 `(추
 | `/status` | 연결 상태 |
 | `/scan [save]` | 이 PC 에 떠 있는 로컬 모델 서버 훑기 (`save` 면 바로 등록) |
 | `/sessions` | 이 폴더의 지난 대화 목록 |
+| `/recall <말>` | 지난 대화에서 **내용으로** 찾기 |
+| `/memory` | 대화가 끝나도 남는 기억 — 보기·적기·지우기 |
+| `/mcp` | 밖에서 붙인 도구(MCP) 서버 보기 |
 | `/init` | `DEEL.md` 규칙 파일 만들기 |
 | `/exit` | 끝내기 |
 
 `/scan` 과 `/sessions` 는 나가지 않고도 씁니다. 로컬 서버를 새로 켰거나 모델을
 바꿔 올렸을 때 `/scan save` → `/model` 두 번이면 대화를 이어둔 채로 갈아탑니다.
 
+### `@파일` 로 바로 붙이기
+
+말 속에 `@` 뒤로 경로를 쓰면 그 파일을 말과 함께 바로 보냅니다.
+
+```
+❯ @src/a.js 이거 왜 느려?
+  ◧ 붙임 src/a.js
+```
+
+모델이 `Read` 를 스스로 부르는 **왕복 한 번이 없어집니다.** 로컬 모델은 도구 호출이
+약해서 그 한 번이 자주 헛돕니다 — 엉뚱한 경로를 부르거나, 아예 안 부르고 지어냅니다.
+사람은 이미 어느 파일인지 아는데 모델더러 찾아보라고 시킬 이유가 없습니다.
+
+어려운 것은 붙이는 일이 아니라 **아닌 것을 파일로 오해하지 않기** 입니다.
+`@` 로 시작하는 것은 세상에 널렸습니다.
+
+| 이렇게 쓰면 | 어떻게 되나 |
+|---|---|
+| `@src/a.js` | 붙습니다 — 실제로 있는 경로일 때만 |
+| `hong@example.com` | 지목으로 안 봅니다. `@` 앞에 글자가 붙어 있으면 주소입니다 |
+| `@media` · `@dataclass` · `@scope/pkg` | 그대로 둡니다 — 그런 경로가 없으니까 |
+| `@src/` 처럼 폴더 | 안에 든 것을 목록으로 붙입니다 |
+| `@"보고서 초안.txt"` | 띄어쓰기가 든 이름은 따옴표로 묶습니다 |
+| 작업 범위 밖 | 안 붙이고, 왜 안 붙였는지 화면에 알립니다 |
+| CP949 사내 문서 | 무엇으로 쓰였는지 알아보고 제대로 붙입니다 |
+
+규칙은 하나입니다 — **실제로 있는 경로일 때만 붙입니다.** 없으면 아무 말 없이
+글자 그대로 둡니다. 지목이 아니었을 테니 조용한 편이 맞습니다.
+
+붙이는 양은 컨텍스트 길이의 **25%**(많아야 20,000토큰)까지입니다. 그보다 크면 앞부분만 붙이는데,
+이때는 **'읽은 것' 으로 치지 않습니다.** 잘린 파일을 읽은 것으로 쳐 두면 모델이
+안 본 자리를 그냥 고쳐 버립니다. 통째로 붙은 파일만 `Read` 를 건너뜁니다.
+
+붙인 것은 화면에 반드시 알립니다. 사람이 안 보낸 글이 대화에 들어가 있는데
+그걸 모르면, 컨텍스트가 왜 줄었는지도 알 수 없습니다.
+
 ### 도중에 멈추기
 
 모델이 엉뚱한 길로 가는 게 보이면 **Ctrl+C** 로 그 자리에서 끊습니다.
@@ -357,6 +401,52 @@ LM Studio 는 `/api/v0/models`, llama.cpp 는 `/props`. 못 알아보면 `(추
 - **초보라고 승인을 덜 받지 않습니다.** 되돌리기·작업 범위·위험 명령 차단은 두 수준이 같습니다.
   초보일수록 되돌릴 수 있어야 합니다.
 
+### 입력칸
+
+터미널에서 그냥 켜면 **대화는 위로 흘러가고, 맨 아래에 입력 상자가 붙습니다.**
+상자만 우리가 지우고 다시 그립니다 — 위쪽 대화는 손대지 않습니다.
+
+```
+  ❊ Grep(console.log)
+    └ 3개 파일 · 11건
+  ◈ Edit(src/runner.js)
+    └ 1군데 +3-1
+    - 12 console.log('시작', 이름)
+    + 12 logger.info({ 단계: '시작', 이름 })
+
+  ▌ 로그 호출을 logger 형식으로 통일했습니다. runner.js 한 군데입니다.
+
+  ── 4.2초 · 도구 3회 · ↑3,900 ↓180
+
+ ▏myproject · qwen2.5-coder:7b ▏ ▰▰▱▱▱▱▱▱ 22% ▏ ◎ 종합 · ◇ medium · auto
+ ╭─────────────────────────────────────────────────────────────────────────────╮
+ │ ❯ 집계 함수도 줄여줘                                                        │
+ ╰─────────────────────────────────────────────────────────────────────────────╯
+```
+
+터미널 스크롤·복사·`Ctrl+F` 찾기가 **그대로 됩니다.** 대화를 우리 칸에 가둬 두지
+않기 때문입니다. 긴 글을 치면 상자가 알아서 여러 줄로 늘어납니다.
+
+**저절로 꺼지는 자리가 있습니다.** 파이프·리다이렉트로 넘길 때, `CI` 가 켜져 있을 때,
+`TERM=dumb` 일 때, 창이 40칸보다 좁을 때는 묻지 않고 상자를 안 그립니다.
+`deel … | tee 기록.txt` 가 제어문자 덩어리가 되면 안 되기 때문입니다.
+`--tui` 를 줘도 파이프면 안 켭니다. `--no-tui` 로 언제든 끌 수 있습니다.
+
+줄 편집은 전부 Node 의 readline 이 그대로 맡습니다 — 한글 조합, 붙여넣기,
+위아래 이력, Ctrl+A/E, 백스페이스. 우리는 readline 이 들고 있는 글을 상자 안에
+**그리기만** 합니다. 직접 키를 받아 줄 편집을 짜기 시작하면 한글 입력기부터 깨집니다.
+
+> **한 번 틀렸던 길** — 처음에는 터미널을 통째로 빌려(vim 처럼 딴 화면) 대화 칸·
+> 파일 칸·할 일 칸을 나눠 그렸습니다. 보기에는 그럴듯했는데 **슬래시 명령이 전부
+> 먹통**이 됐습니다. `commands.js` 를 비롯한 여섯 모듈이 화면 객체를 안 거치고
+> 터미널에 바로 쓰는데, 매번 화면을 통째로 다시 그리니 그 글이 찍히자마자 덮여
+> 사라졌던 것입니다. 명령이 안 도는 게 아니라 **결과가 안 보이는** 것이라 더
+> 나빴습니다. 고치려면 터미널에 쓰는 자리를 전부 화면 객체로 꿰야 하는데, 지금
+> 여섯 곳이고 앞으로 늘 것이며, 하나라도 빠뜨리면 같은 증상이 조용히 돌아옵니다.
+> 그래서 반대로 갔습니다 — 대화는 그냥 흘려보내고 상자만 관리합니다.
+> ([`test/box.test.js`](test/box.test.js) 가 터미널인 척하는 자식을 띄워
+> 이 결함이 다시 안 나가는지 봅니다.)
+
 ---
 
 ## 도구
@@ -367,14 +457,99 @@ LM Studio 는 `/api/v0/models`, llama.cpp 는 `/props`. 못 알아보면 `(추
 |---|---|
 | `Read` | 파일 읽기 (줄 번호 · `offset`/`limit` 지원 · **엑셀은 CSV 로 바꿔서**) |
 | `Write` | 파일 쓰기·덮어쓰기 |
+| `Append` | 파일 끝에 이어 붙이기 — **큰 파일을 나눠 쓰는 자리** |
 | `Edit` | 정확한 문자열 바꾸기 (`replace_all` 지원) |
 | `Glob` | 이름 패턴으로 파일 찾기 |
 | `Grep` | 내용 정규식 검색 |
 | `Bash` | 명령 실행 |
 | `Skill` | 스킬 본문 펼쳐 읽기 (스킬이 있을 때만 모델에게 보임) |
 | `WebFetch` | 웹 페이지 읽기 (읽기 전용 · `--offline` 이면 숨김) |
+| `Recall` | **지난 대화**에서 찾기 — "저번에 그거" 를 모델이 스스로 뒤진다 |
+| `Remember` | 대화가 끝나도 남길 것 한 줄 — 다음에 켤 때 처음부터 안다 |
 | `TodoWrite` | 할 일 목록 — 긴 일을 쪼개서 어디까지 했는지 화면에 띄움 |
 
+Claude Code 에 없는 것은 **셋뿐**입니다 — `Append` · `Recall` · `Remember`.
+도구 하나가 스키마로 150토큰쯤 먹고 그게 **매 요청마다** 나가므로, 늘릴 때마다
+검사에서 한 번 멈추게 해 뒀습니다(`test/loop.test.js`).
+
+### 지난 대화를 찾고, 정한 것을 기억합니다
+
+deel 은 대화를 `.deel/sessions/*.jsonl` 로 꼬박꼬박 남깁니다. 그런데 목록을 보는 것
+말고는 할 수 있는 게 없었습니다 — **기록이 있는데 못 찾으면 없는 것과 같습니다.**
+
+```
+$ /recall 인코딩을 어떻게
+
+  2026-08-01 10:15  모델    20260801-101500
+      CP949 인코딩 문제입니다. 읽을 때 인코딩을 재서 그대로 되돌려 쓰도록…
+  2026-08-20 14:45  나      20260820-144500
+      저번 인코딩 규칙 그대로 적용해줘
+
+  2건 중 2건 · 대화 3개를 뒤졌습니다
+```
+
+조사를 붙여 쳐도 찾습니다(`인코딩을` → `인코딩`). 형태소 분석기를 붙일 수는 없으니
+(의존성 0) 조사처럼 보이는 꼬리를 떼어 **둘 다** 찾습니다. 색인은 안 만듭니다 —
+색인은 반드시 낡고, **낡은 색인은 없는 것보다 나쁩니다**("못 찾았습니다" 가
+"없습니다" 로 읽힙니다). 대신 얼마나 뒤졌고 무엇을 못 뒤졌는지 반드시 말합니다.
+
+`Recall` 은 **도구로도** 줍니다. 사람만 쓰는 명령으로 두면 "저번에 정한 대로 해줘" 에
+모델이 할 수 있는 게 되묻는 것뿐입니다.
+
+**기억(`/memory`)은 다른 물건입니다.** 지난 대화 찾기는 *찾아야* 나오고, 기억은
+*처음부터 들어가 있습니다.* 매번 다시 설명할 수 없는 것이 여기 옵니다.
+
+```
+$ /memory
+
+   1  사내 문서는 CP949 로 읽고 CP949 로 되돌려 쓴다
+   2  검증할 때 7080 포트는 쓰지 않는다 — 앱 기본 포트라 진짜 data/ 를 덮는다
+
+  2줄 · 약 30토큰이 매 요청마다 함께 나갑니다
+  파일 .deel/memory.md — 직접 고치셔도 됩니다
+```
+
+`.deel/memory.md` 는 **사람이 열어 고치는 글**입니다. 데이터베이스가 아닙니다.
+이게 중요합니다 — 모델이 잘못 적은 줄은 매 요청마다 실려 나가면서 계속 틀리게
+만듭니다. **틀린 기억은 없느니만 못합니다.** 그래서 `/memory 지우기 2` 로 지웁니다.
+
+매 요청에 나가는 물건이라 자리를 지킵니다: 한 줄 400자 · 60줄 · 전체 6,000자.
+넘으면 오래된 것부터 빼고 뺐다고 말합니다. `/context` 에도 줄 수와 토큰이 뜹니다.
+
+### 또 하게 될 절차는 스킬로 남깁니다
+
+여러 걸음이 걸리는 일을 끝냈고 또 하게 될 일이면, 모델이 그 절차를
+`.deel/skills/<이름>/SKILL.md` 로 적어 둡니다. 다음에 켤 때 스킬 목록에 떠서 바로
+쓸 수 있고, 쓰다가 틀린 데를 찾으면 그 파일을 고칩니다.
+
+새 도구가 필요 없습니다 — 이미 있는 `Write` 로 쓰고, 이미 있는 스킬 훑기가 읽습니다.
+
+
+
+### 큰 파일은 나눠 씁니다 — `Append`
+
+출력 상한이 4k 인 모델도 2,000줄 파일을 여덟 번에 나눠 쓸 수 있어야 합니다.
+`Edit` 으로 잇는 방법은 실제로 안 됩니다 — HTML 은 `</div>` 같은 앵커가 반복돼
+"여러 군데에서 발견됐습니다" 로 막히고, 앵커를 길게 잡으면 그 토큰이 본문에서 빠집니다.
+
+처음 만들 때는 `Write`, 이어 붙일 때는 `Append` 입니다. 인코딩은 `Write` 와 같게
+따라갑니다(사내 문서의 CP949, `.csv` 의 BOM 을 그대로 지킵니다).
+되돌리기 스냅샷은 **첫 `Append` 때 한 번만** 남습니다 — 여덟 번 이어 붙였다고
+이력에 여덟 벌이 쌓이면 되돌릴 자리를 찾을 수 없기 때문입니다.
+
+```
+  ⏺ Write(dashboard.html)
+    └ ⚠ 잘린 데까지만 썼습니다 — 632줄
+  ↻ 대답이 상한에서 잘렸습니다 — 상한을 9,984 → 16,384 로 올려 다시 부릅니다
+  ⏺ Append(dashboard.html)
+    └ +567줄 · 전체 1,199줄
+
+  ✓ dashboard.html · 1,199줄 · 97.7KB
+```
+
+마지막 줄이 중요합니다. 파일이 없는데 모델이 "만들었습니다" 라고 하면
+그대로 믿게 됩니다. **턴이 끝날 때 실제 파일을 재서 알려 줍니다.**
+
 ### 할 일 목록
 
 여러 단계가 걸리는 일에서 모델이 순서를 잃지 않게 하는 장치입니다.
@@ -431,6 +606,66 @@ LM Studio 는 `/api/v0/models`, llama.cpp 는 `/props`. 못 알아보면 `(추
   이 줄을 그대로 옮겨 담아 다시 시도하세요.
 ```
 
+### 고친 자리를 그 자리에서 보여줍니다
+
+`auto` 모드는 안 물어보고 고칩니다. 그게 이 도구의 속도인데, 화면에 `3군데` 만
+남으면 사람은 무엇이 바뀐지 모른 채 넘어갑니다. 되돌리기가 안전망이어도
+**뭐가 바뀐지 모르면 되돌릴지 말지조차 못 정합니다.**
+그래서 `Edit`·`Write` 뒤에는 바뀐 줄을 그대로 붙여 보여줍니다.
+
+```
+  ◈ Edit(src/runner.js)
+    └ 1군데 +1 −2
+
+      11 const id = job.id;
+    -    console.log("실행 시작: " + id);
+    -    console.log("  옵션 " + JSON.stringify(opts));
+    + 12 logger.info('실행 시작', { id, opts });
+      13 return run(job);
+```
+
+요약 옆의 `+1 −2` 는 늘고 준 줄 수입니다.
+
+- **없어진 줄에는 번호를 안 답니다.** 지금 파일에 없는 줄이니까요. 옛 번호를
+  달았더니 바로 위 곁줄의 새 번호와 같은 숫자가 나란히 찍혔습니다 — 서로 다른
+  파일의 번호가 한 열에 섞여 보입니다. 실제로 8번이 두 번 찍히는 화면이 나왔습니다.
+- 줄 끝 표시(CRLF/LF)만 바뀌었으면 그렇다고 따로 말해 줍니다. 안 그러면 눈에
+  똑같은 줄이 전부 바뀐 것으로 나와서 진짜 바뀐 곳을 못 찾습니다.
+- 큰 파일은 앞뒤로 같은 부분을 먼저 잘라내고 견줍니다. 그러고도 크면 자세히 맞추기를
+  포기하고 '이만큼이 통째로 바뀌었다' 로 물러섭니다 — 느린 것보다 대충이라도
+  빨리 보이는 편이 낫습니다.
+
+몇 줄까지 펼칠지는 수준마다 다릅니다. 처음 켠 사람에게 40줄을 쏟으면 아무것도 안 읽습니다.
+
+| | 쉬움 | 개발자 |
+|---|---|---|
+| 도구 뒤에 펼치는 줄 | 14줄 | 40줄 |
+| `/diff <파일>` | 60줄 | 200줄 |
+
+### `/diff` — 이번 대화에서 바뀐 것
+
+도구 뒤에 지나간 화면은 스크롤에 묻힙니다. `/diff` 는 이번 대화에서 손댄 파일을
+한 장에 모읍니다.
+
+```
+$ /diff
+
+── 이번 대화에서 바뀐 파일 ──────────────────────────────────
+  src/runner.js                     +12     −7   3번
+  src/logger.js                     +40     −0
+  ──────────────────────────────────────────────────────────
+  2개 파일                           +52     −7
+
+  한 파일을 자세히 보려면 /diff <파일>, 되돌리려면 /undo
+```
+
+`/diff <파일>` 은 **이번 대화를 시작하기 전과 지금**을 견줍니다. 세 번 고쳤어도
+사람이 알고 싶은 것은 '내가 시키기 전과 지금이 뭐가 다른가' 이지 마지막 한 번이
+아니기 때문입니다. 그 처음 모습은 되돌리기 이력의 가장 오래된 스냅샷에서 꺼냅니다.
+
+`/diff` 는 **쉬움 수준의 명령 목록에도 들어 있습니다.** `auto` 가 안 물어보고
+고치는 이상, 초보일수록 '무엇이 바뀌었나' 를 볼 통로가 필요합니다.
+
 ---
 
 ## 한글 문서와 엑셀
@@ -467,6 +702,12 @@ LM Studio 는 `/api/v0/models`, llama.cpp 는 `/props`. 못 알아보면 `(추
 명령 출력도 마찬가지입니다. 윈도우 명령창은 UTF-8 이 아니라, `Bash` 결과를
 utf8 로 받으면 한글이 깨집니다. 바이트로 받아서 풉니다.
 
+**되돌리기 스냅샷도 바이트로 담습니다.** 예전에는 UTF-8 글자로 적었습니다.
+그러면 CP949 파일을 되돌릴 때 `가나다`(`b0a1 b3aa b4d9`) 가 U+FFFD 여섯 개로
+돌아옵니다 — **안전망이 원본 바이트를 없애 버리는 것입니다.** 지금은 UTF-8 로
+되짚어 봐서 바이트가 그대로 살아나지 않는 파일만 base64 로 담고, 되돌릴 때
+바이트 그대로 씁니다.
+
 ### 엑셀 — CSV 로 바꿔서 읽습니다
 
 엑셀 파일은 글이 아니라 압축 꾸러미라, 보통은 "바이너리 파일입니다" 로 끝납니다.
@@ -554,16 +795,13 @@ unzip 반입.zip -d ~/.deel/plugins/
 에이전트 한 번의 대답은 모델을 여러 번 부릅니다. **부를 때마다 필요한 생각의 양이 다릅니다.**
 전부 세게 두면 느리고, 전부 얕게 두면 엉뚱한 길로 갑니다.
 
+기본은 **한 줄**입니다. 알고 싶은 것은 '지금 얼마나 생각하나' 이지 단계표가 아닙니다.
+
 ```
 $ /think
 
-── 추론 강도 ─────────────────────────────────────────────────────
-  기준 medium   배분 절약   첫 판단만 세게, 이어가기는 얕게
-
-  단계        강도      출력상한  언제
-  첫 판단     · medium       4,096  무엇을 할지 정하는 자리
-  이어가기    ↓ low          2,048  도구 결과를 읽고 다음 한 수
-  막혔을 때   ↑ high         4,096  직전 도구가 오류를 냄
+  추론 강도  medium   (첫 판단 medium · 이어가기 low · 막혔을 때 high)
+  더 세게 /think high   더 빠르게 /think low
 ```
 
 | 배분 | 성격 |
@@ -572,6 +810,31 @@ $ /think
 | `save` (절약, 기본) | 첫 판단만 세게, 이어가기는 얕게 |
 | `deep` (깊게) | 전 단계 한 칸씩 위로 — 어려운 일에만 |
 
+배분은 `/think 배분 절약` 로 정합니다. **강도와 배분은 다른 축이라 명령을 갈랐습니다** —
+전에는 `/think high` 와 `/think save` 가 같은 이름으로 다른 것을 정해서,
+화면을 봐도 지금 무엇이 무엇인지 읽히지 않았습니다.
+
+단계표는 `/think 자세히` 로 뺐습니다(개발자 수준 기본).
+
+```
+$ /think 자세히
+
+  추론 강도  medium   (첫 판단 medium · 이어가기 low · 막혔을 때 high)
+  배분      절약   첫 판단만 세게, 이어가기는 얕게 — 대개 이게 낫습니다
+
+  단계        강도      출력상한  언제
+  첫 판단     · medium      15,549  무엇을 할지 정하는 자리
+  이어가기    ↓ low         13,605  도구 결과를 읽고 다음 한 수
+  막혔을 때   ↑ high        16,384  직전 도구가 오류를 냄
+
+  출력 상한은 16,384 (모르는 값이라 기본값) 안에서 나눕니다 — /out
+  컨텍스트 40,960 · 지금 찬 양 2,087
+```
+
+마지막에서 두 번째 줄이 있는 이유: **세 값이 다 같을 때 그게 고장인지 아닌지**
+이 한 줄로 갈립니다. 아는 상한이 낮으면 셋이 같아지는 것이 맞습니다.
+한동안 이 표는 세 줄이 늘 `16,384` 였고, 그건 표가 뜻이 없다는 뜻이었습니다.
+
 ### 컨텍스트 길이는 모델에서 긁어옵니다
 
 이 숫자 하나가 프로그램 전체 크기를 정합니다. 한 번에 읽힐 수 있는 파일 수,
@@ -610,29 +873,98 @@ $ /think
 | `/ctx` | 지금 값과 남은 자리 |
 | `/ctx auto` | 서버에 다시 물어 모델에 맞춤 |
 | `/ctx 655360` | 직접 지정 (`640k` · `128k` · `1m` 도 됩니다) |
-| `/ctx out 32k` | 한 번에 받을 **답 길이** 상한 — 컨텍스트와 다른 축 |
+| `/ctx 자세히` | 어디를 두드려서 어떤 값을 얻었는지 — 안 가져와질 때 원인을 봅니다 |
 | `deel --ctx 655360` | 켤 때부터 이 값으로 (긁어오기를 건너뜁니다) |
 
 **`k` 는 1024 입니다.** 컨텍스트 길이는 전부 2의 거듭제곱이라 그래야 아귀가 맞습니다 —
 655,360 은 `655k` 가 아니라 `640k`, 131,072 는 `131k` 가 아니라 `128k` 입니다.
 화면에 뜨는 표기와 `/ctx` 가 받는 단위가 같아서, 보이는 대로 쳐도 같은 값이 됩니다.
 
-**출력 상한은 고정 숫자가 아닙니다.** 모델 컨텍스트와 지금 찬 양에서 매번 계산합니다 —
+### 한 번에 받을 답 길이 — `/out`
+
+컨텍스트(담아 둘 수 있는 양)와 **출력 상한**(한 번에 낼 수 있는 양)은 다른 숫자입니다.
+그 둘을 하나로 알면 큰 파일이 왜 안 만들어지는지 영영 알 수 없습니다 —
+컨텍스트는 넉넉한데 답이 잘리기 때문입니다.
+
+| 명령 | 하는 일 |
+|---|---|
+| `/out` | 지금 상한과 그 값이 **어디서 왔는지**(직접 정함 / 서버에서 알아냄 / 기본값) |
+| `/out 32k` | 직접 지정 (`k` 는 1024). 프로필에 남아 다음에 켤 때도 그대로입니다 |
+| `/out auto` | 직접 정한 값을 지우고 알아낸 값·기본값으로 |
+| `deel --max-tokens 65536` | 켤 때부터 이 값으로 |
+
+옛 이름 `/ctx out 32k` 도 그대로 받습니다.
+
+**상한은 고정 숫자가 아닙니다.** 모델 컨텍스트와 지금 찬 양에서 매번 계산합니다 —
 남은 자리의 몇 %를 이 단계에 내줄지가 배분입니다.
 
-| 모델 | 첫 판단 | 이어가기 | 막혔을 때 |
-|---|---|---|---|
-| 2k 로컬 | 554 | 512 | 554 |
-| 8k 로컬 | 2,007 | 1,003 | 2,007 |
-| 40k (qwen3) | 11,688 | 5,844 | 11,688 |
-| 128k 게이트웨이 | 16,384 | 16,384 | 16,384 |
-| 128k 인데 80% 참 | 7,680 | 3,840 | 7,680 |
+| 모델 | 첫 판단 | 이어가기 | 막혔을 때 | 잘린 뒤 다시 |
+|---|---|---|---|---|
+| 2k 로컬 | 819 | 716 | 921 | 1,638 |
+| 8k 로컬 | 3,276 | 2,867 | 3,686 | 6,553 |
+| 40k (qwen3) | 16,384 | 14,336 | 16,384 | 16,384 |
+| 128k 게이트웨이 | 16,384 | 16,384 | 16,384 | 16,384 |
+| 128k 인데 80% 참 | 10,485 | 9,174 | 11,796 | 16,384 |
+| 640k 에 `/out 65536` | 65,536 | 65,536 | 65,536 | 65,536 |
 
 컨텍스트가 차오르면 상한도 같이 줄어듭니다. 4k 모델에 4096 을 주면 입력 자리가 안 남기 때문입니다.
-더 필요하면 프로필에 `maxTokens` 를 적어 올릴 수 있습니다.
 
-아끼다 대답이 잘리면 **그 단계만 상한을 풀어 자동으로 다시 부릅니다.**
-잘린 채로 넘어가면 도구 호출이 반토막 나서 조용히 실패하기 때문입니다.
+마지막 줄이 요점입니다. **아는 값이 있으면 16,384 는 비켜섭니다.**
+한동안은 안 그랬습니다 — `Math.min(cap, max ?? 16384, 16384)` 의 세 번째 인자가
+무조건 다시 조여서, 적어 둔 값은 **낮출 수만 있고 올릴 수 없었습니다.**
+그런데 주석도 README 도 안내도 셋 다 "올릴 수 있다" 고 말했습니다.
+문서에 적힌 탈출구가 막혀 있는 것이 가장 나쁩니다.
+
+아끼다 대답이 잘리면 **상한을 풀어 자동으로 다시 부릅니다.** 이때 추론 강도도 한 칸
+내립니다 — 생각 토큰이 같은 예산을 먼저 까먹기 때문에, 강도를 낮춰야 본문 자리가 실제로 늡니다.
+잘린 채로 넘어가면 도구 호출이 반토막 나서 조용히 실패합니다.
+
+**서버가 거절하면 그 문장에서 배웁니다.**
+
+```
+This model's maximum context length is 8192 tokens, however you requested 41003
+```
+
+이 숫자를 뽑아 즉시 맞추고 다시 부릅니다. 사용자는 실패를 안 봅니다.
+규격을 몰라도 되므로 **처음 보는 서버에서도 통합니다.**
+
+### 잘린 도구 호출
+
+실제로 있었던 일입니다. 사용자가 대시보드를 만들어 달라고 했고, 모델은 HTML 문서를
+통째로 `Write` 의 인자에 넣으려다 출력 한도에 걸렸습니다. 인자 JSON 이 중간에서
+끊긴 채로 도착했습니다.
+
+예전 코드는 그 읽히지 않는 JSON 을 조용히 `{_raw: "..."}` 로 바꿔 도구에 넘겼습니다.
+도구는 `경로가 비었습니다` 라고 답했습니다 — **진짜 원인과 아무 상관 없는 말입니다.**
+모델은 경로를 안 빠뜨렸으니 고칠 게 없다고 보고 똑같이 다시 시도했고, 또 잘렸습니다.
+
+```
+  ◆ Write(dashboard.html)
+    └ 경로가 비었습니다        ← 아홉 번 똑같이
+
+  ── 71초 · 도구 13회 · 컨텍스트가 차서 대화를 접음 · 파일은 안 생김
+```
+
+조용히 삼킨 값 하나가 그 전부를 만들었습니다. 지금은 이렇게 합니다.
+
+| | 지금 |
+|---|---|
+| 안 읽히는 인자 | 삼키지 않고 **잘렸다고 표시**합니다. 도구에 넘기지 않습니다 |
+| 모델에게 | 무슨 일이 났는지 그대로 말하고, 통째로 다시 보내지 말고 **뼈대만 먼저 만든 뒤 `Edit` 으로 나눠 이어 붙이라**고 알려 줍니다 |
+| 잘린 내용 | 대화에 다시 넣지 않습니다 — 반쪽인 데다 컨텍스트만 먹습니다 |
+| 잘림 판정 | 게이트웨이가 `finish_reason: "stop"` 이라고 해도 **인자가 깨진 것 자체를 잘린 증거로 봅니다.** 모델은 반쪽짜리 JSON 을 일부러 만들지 않습니다 |
+| 같은 실패 3번 | 그 턴을 멈추고, 나눠서 시켜 보라고 말합니다 |
+
+```
+  ⊘ 같은 자리에서 헛돌고 있어 멈췄습니다.
+    같은 도구 호출이 계속 잘립니다
+    한 번에 만들 내용이 모델의 출력 한도보다 큽니다. 나눠서 시켜 보세요 —
+    예: "뼈대만 먼저 만들어줘" → "표 부분 추가해줘" → "그래프 추가해줘"
+```
+
+**걸음 수 상한(`maxSteps`)으로는 이걸 못 막습니다.** 그건 '잘 되고 있는 긴 작업' 과
+'헛도는 작업' 을 구분하지 못합니다. 여기서 세는 것은 걸음 수가 아니라
+**같은 도구가 같은 이유로 실패한 횟수**입니다.
 
 ---
 
@@ -685,6 +1017,44 @@ $ deel sessions
 
 ---
 
+## 밖에서 도구 붙이기 (MCP)
+
+사내 위키 검색기, 이슈 트래커, DB 조회기 같은 것을 각 팀이 MCP 서버로 만들어 두면
+deel 은 그걸 **코드를 안 고치고** 도구로 씁니다.
+
+`.deel/mcp.json` 에 적습니다. Claude Code 설정을 그대로 복사해 붙일 수 있습니다:
+
+```json
+{ "mcpServers": { "사내위키": { "command": "node", "args": ["wiki-mcp.js"] } } }
+```
+
+모델에게는 `mcp__사내위키__검색` 이라는 이름으로 보입니다. `/mcp` 로 무엇이 붙었는지 봅니다.
+
+**의존성은 그대로 0 입니다.** stdio 규격은 자식 프로세스의 stdin/stdout 에 줄 단위
+JSON-RPC 2.0 을 주고받는 것이 전부라, `child_process` 와 `JSON` 이면 됩니다. SDK 가
+필요 없습니다.
+
+### 다만 이건 남의 프로그램입니다
+
+이 프로젝트가 존재하는 이유가 '미승인 SW 반입 금지' 인데, MCP 를 아무렇게나 켜면
+그 선을 우리 손으로 무너뜨리는 셈입니다. 그래서:
+
+| | |
+|---|---|
+| **기본은 꺼져 있음** | `.deel/mcp.json` 에 직접 적어야만 뜹니다 |
+| **`--offline` 이면 안 띄움** | 자식 프로세스가 어디로 나가는지 우리는 못 막습니다. **막을 수 없는 것을 막았다고 말하지 않습니다** |
+| **작업 범위 밖** | MCP 서버는 우리 울타리를 안 지킵니다. `/mcp` 화면이 그렇다고 말합니다 |
+| **감사기록에 남음** | 무엇을 띄웠고 무엇을 불렀는지 `.deel/audit.jsonl` 에 |
+| **열쇠를 안 넘김** | 우리 환경변수를 통째로 안 넘깁니다 — `DEEL_*` 의 게이트웨이 열쇠가 남의 프로세스로 가면 어디로 가는지 알 수 없습니다 |
+| **읽기 전용 모드엔 안 줌** | 이름이 '검색' 이어도 파일을 쓸 수 있습니다. 계획·설계 모드에서 '모르는 것' 을 쥐여 주면 그 약속이 약속이 아니게 됩니다 |
+| **한 서버에 24개까지** | 스키마가 매 요청에 실립니다. 넘으면 자르고 **잘랐다고 말합니다** |
+
+서버 하나가 죽거나·답이 없거나·헛소리를 해도 나머지는 그대로 씁니다. 안 뜬 것은
+조용히 빠지지 않고 머리말에 이유가 뜹니다 — 조용히 빠지면 "왜 그 도구가 없지" 를
+영영 알 수 없습니다.
+
+---
+
 ## 안전망
 
 승인 프롬프트 대신 **되돌릴 수 있게** 만들었습니다. 기본 모드 `auto` 는 묻지 않고 알아서 합니다.
@@ -692,10 +1062,13 @@ $ deel sessions
 | 장치 | 내용 |
 |---|---|
 | **되돌리기** | 파일을 고치기 전 항상 스냅샷. `/undo` 로 턴 단위 복구 |
+| **바뀐 자리 보기** | 고칠 때마다 바뀐 줄을 화면에. 이번 대화 전체는 `/diff` |
 | **작업 범위** | 시작한 폴더 밖은 모델이 시켜도 거부 |
 | **위험 명령 차단** | 되돌릴 수 없는 것만 (디스크 포맷, 재귀 삭제, `--force` 푸시 등) |
 | **재실행 금지** | 변경성 명령은 실패해도 다시 실행하지 않음 — 두 번 돌면 사고 |
 | **중단** | Ctrl+C 로 도중에 끊어도 대화가 성한 채로 남음 |
+| **헛돌기 차단** | 같은 도구가 같은 이유로 3번 실패하면 그 턴을 멈추고 왜인지 말함 |
+| **안 읽는 자리** | 남의 도구 살림과 deel 자신의 기록·설정(열쇠)은 거절 |
 | **감사 로그** | `.deel/audit.jsonl` 에 전부 기록 |
 
 | 모드 | 언제 물어보나 |
@@ -708,6 +1081,42 @@ $ deel sessions
 32MB 를 넘으면 **최근 50턴만 남기고** 오래된 것을 버립니다. 방금 한 일은 언제나
 되돌릴 수 있고, 지금 이력이 얼마나 되는지는 `/status` 에서 봅니다.
 
+### 안 읽는 자리
+
+폴더를 훑다 보면 프로젝트 파일이 아닌 것이 걸려 나옵니다. 다른 코딩 도구가 제 살림을
+넣어 둔 자리입니다 — 지난 대화, 명령 이력, 캐시, 그리고 열쇠.
+이 작업과 아무 상관이 없는데 목록에 나오면 모델이 그것부터 읽습니다.
+
+```
+  ◧ Read(~/.deel/audit.jsonl)      77줄
+  ◧ Read(~/.claude/history.jsonl)  35줄
+```
+
+감사기록은 **이 프로그램이 방금 무엇을 했는지** 적어 둔 것입니다. 그걸 다시 읽어
+대화에 넣으면 모델이 제 그림자를 좇습니다. 시킨 일과는 상관없이 컨텍스트만 찹니다.
+
+설정 파일은 더 나쁩니다. `.deel/config.json` 에는 게이트웨이 **열쇠(API 키)** 가
+들어 있습니다. 읽는 순간 그 열쇠가 대화에 실려 모델로 나가고, 디스크의 세션 기록에도
+남습니다. 열쇠를 그 열쇠의 주인에게 보내는 셈입니다.
+
+| 안 읽는 것 | 왜 |
+|---|---|
+| `.deel/config.json` | 게이트웨이 열쇠가 들어 있음 |
+| `.deel/audit.jsonl` · `.deel/sessions` · `.deel/history` | deel 자신의 기록. 제 그림자를 좇게 됨 |
+| `.claude` `.codex` `.cursor` `.gemini` `.aider` `.continue` `.cline` `.roo` `.kilocode` `.windsurf` `.opencode` `.zed` `.trae` `.augment` `.qodo` `.tabnine` `.cody` `.sourcegraph` `.copilot` `.amazonq` `.junie` `.codeium` `.goose` `.crush` `.gptme` `.openhands` `.devin` | 남의 도구 살림 |
+| `.aider.chat.history.md` 처럼 폴더가 아니라 파일로 흘리는 것 | 같은 이유 |
+
+읽기만이 아니라 **쓰기도 막습니다.** 읽기만 막아 두면 남의 도구 설정을 덮어쓸 수 있고,
+`.deel/config.json` 을 덮어쓰면 연결이 통째로 날아갑니다.
+
+**막는 것이지 숨기는 것이 아닙니다** — 왜 안 되는지 그대로 말해 줍니다.
+새 도구는 계속 나옵니다. 목록에 없는 이름이 보이면 **한 줄 더하면 됩니다.**
+
+그 목록은 **소스의 한 곳에만 둡니다.** 훑는 쪽(`SKIP_DIRS`)과 읽기 막는 쪽이
+같은 것을 봅니다. 전에는 따로 적어 놨는데, 그러면 한쪽에만 새 이름을 넣는 날이
+반드시 옵니다 — 훑을 때는 안 걸리는데 이름을 대면 읽히는, 설명하기 어려운
+상태가 됩니다.
+
 ---
 
 ## 사내 반입
@@ -801,11 +1210,14 @@ deel --root <폴더>       작업 범위. 기본은 지금 폴더
 deel --mode <모드>       auto(기본) / confirm / strict
 deel --work <모드>       auto(기본·종합) / code / plan / architect / debug / ask / orchestrator
 deel --level <수준>      쉬움 / 개발자
+deel --ctx <길이>        컨텍스트 길이 직접 지정 (655360 · 640k · 128k)
+deel --max-tokens <길이> 한 번에 받을 답 길이 상한 (32k) — /out 과 같은 값
 deel --think <강도>      off / low / medium(기본) / high / max
 deel --effort <배분>     even / save(기본) / deep
 deel --offline           이 컴퓨터 밖으로 아무것도 안 보냄
 deel --continue          가장 최근 대화 이어하기
 deel --resume <id>       골라서 이어하기
+deel --no-tui            입력 상자를 끄고 줄 화면으로 (아래 참고)
 ```
 
 ### 프로젝트 규칙
@@ -826,7 +1238,9 @@ deel --resume <id>       골라서 이어하기
 | 401 / 403 | 키가 틀렸거나 인증 헤더 형식이 다름 (4가지를 자동 시도합니다) |
 | `허용되지 않은 주소입니다` | 자물쇠가 막은 것. 정상입니다 — `/model` 로 연결을 고르세요 |
 | 도구 호출이 안 먹음 | `deel diagnose` 로 판정을 보세요. 작은 모델(1B~3B)은 자주 못 합니다 |
-| 대답이 비어 있음 | 생각을 많이 하는 모델입니다. `/think low` 로 낮춰 보세요 |
+| 대답이 비어 있음 | 스트리밍을 무시하는 서버입니다. 한 번은 저절로 다시 부르고, 그래도 비면 이 대화에서는 스트리밍을 끕니다 |
+| 큰 파일이 중간에 끊김 | `/out` 으로 지금 상한을 보고 올리세요. 상한을 몰라 16,384 로 서 있을 수 있습니다 |
+| `HTTP 400` 만 뜸 | 서버가 보낸 문장을 그대로 보여 줍니다. 길이 문제면 숫자를 읽어 저절로 맞춥니다 |
 | `deel scan` 이 0곳 | 로컬 서버가 꺼져 있거나 다른 포트 — `--ports` 로 지정 |
 
 ---
@@ -834,11 +1248,12 @@ deel --resume <id>       골라서 이어하기
 ## 개발
 
 ```bash
-npm test        전체 검증 (254항목)
-npm run verify  반입·통신 검증만
-npm run bench   편집 성공률 측정
-npm run demo    화면이 어떻게 보이는지 실제로 돌려 보기
-npm run check   전 파일 문법 검사
+npm test          전체 검증 (1,787항목)
+npm run coverage  검사가 소스의 어디를 밟았는지
+npm run verify    반입·통신 검증만
+npm run bench     편집 성공률 측정
+npm run demo      화면이 어떻게 보이는지 실제로 돌려 보기
+npm run check     전 파일 문법 검사
 ```
 
 검증은 **가짜 게이트웨이**를 띄워서 합니다. 실제 모델 없이 규격 그대로
@@ -868,34 +1283,69 @@ zip 은 진짜 `unzip` 으로, tar 는 진짜 `tar` 가 만든 것을 읽혀 교
 |---|---|---|
 | `smoke` | 20 | 도구·작업범위·되돌리기·감사로그 |
 | `loop` | 16 | 에이전트 루프·스트리밍·도구 호출 |
+| `guard` | 24 | **안 하는 자리** — 거부·모르는 도구·두 번 실행·범위 밖 |
 | `network` | 30 | 정해진 자리 밖으로 새지 않는가 |
 | `web` | 25 | 웹 읽기가 읽기만 하는가 |
 | `abort` | 16 | Ctrl+C 로 끊어도 대화가 성한가 |
 | `parallel` | 23 | 읽기만 동시에 도는가 · 할 일 목록 |
+| `cli` | 75 | **진짜 `deel` 을 띄워** 끝까지 돌려 본다 |
+| `setup` | 42 | 첫 실행 마법사 (가짜 TTY 로 사람처럼 입력) |
+| `detect` | 66 | 주소 한 줄로 규격·인증을 짚어내는가 |
+| `modes` · `route` | 89 · 33 | 작업 모드 · 종합에서 알맞은 모드로 옮겨 가는가 |
+| `ctxsize` | 43 | 모델에 걸린 컨텍스트 길이를 긁어오는가 |
+| `commands` · `commands-more` | 128 · 62 | 슬래시 명령 전부 |
+| `ui` · `ui2` | 60 · 40 | 암호 가림·한글 폭·상태줄·대화 목록·엑셀→글 |
+| `encoding` · `xlsx` | 68 · 72 | 한글 인코딩 판별 · 엑셀 읽기 |
 | `compact` | 21 | 요약 압축·짝 안 깨짐·실패 시 물러섬 |
 | `store` | 34 | 대화 저장·이어하기·중간에 죽어도 복구 |
-| `scan` | 19 | 여러 런타임을 구분해 찾는가 |
+| `scan` | 29 | 여러 런타임을 구분해 찾는가 |
 | `plugins` | 38 | 플러그인 받기·묶기·ZIP/TAR |
 | `no-bundle` | 12 | 배포 묶음에 남의 것이 안 섞였는가 · 검사 파일 위생 |
 | `edit-bench` | 20건 | 편집 성공률 |
 
+### 어디를 밟았는지
+
+```bash
+npm run coverage                          전체 요약
+node test/coverage.mjs --file src/repl.js  한 파일 자세히
+node test/coverage.mjs --json              기계가 읽을 형태로
+```
+
+의존성이 0개라 c8·nyc 를 못 씁니다. 대신 Node 에 원래 들어 있는
+`NODE_V8_COVERAGE` 를 읽습니다 — 새로 반입 심사할 것이 하나도 안 늡니다.
+자식 프로세스까지 잡히므로 `deel` 을 띄워 보는 `cli` 검사도 그대로 집계됩니다.
+
+지금 **전체 92%** (7,496줄 중 6,911줄). 일부러 못 채운 곳이 셋 있습니다.
+
+| 파일 | 지금 | 왜 못 채우나 |
+|---|---|---|
+| `tools/excel.js` | 67% | 암호 걸린 엑셀을 여는 길. 이 PC 에 엑셀이 깔려 있고 암호 걸린 진짜 파일이 있어야 합니다. 흉내 내면 '되는 것처럼 보이는' 검사가 됩니다 |
+| `repl.js` | 77% | 사람이 키를 누르는 길 — Shift+Tab, Ctrl+C, 암호 입력, 붙여넣기. 가짜 터미널(pty)이 있어야 밟히는데 그건 의존성입니다. 대신 화면에 나가는 **글**은 값으로 재 봅니다(`ui`·`tui` 검사) |
+| `plugins/manage.js` | 79% | GitHub 에서 내려받는 길. **검사가 바깥으로 안 나간다**는 약속이 먼저입니다. 폴더에서 설치하는 길은 검사합니다 |
+
 ### 폴더 구조
 
 ```
 bin/deel.js              진입점
 src/
   ui/                    색·한글 폭·상자·상태줄·입력
+  ui/screen.js           화면 고르기 (줄 화면 / 상자 화면)
+  ui/inputbox.js         맨 아래 입력 상자 — 그리기·지우기·커서 자리
+  ui/wrap.js             색을 지키며 폭에 맞춰 접기
   agent/loop.js          에이전트 루프
   agent/session.js       대화 상태 + 컨텍스트 셈
   agent/effort.js        단계별 추론 강도 배분
   agent/compact.js       요약 압축
   agent/store.js         대화 저장·이어하기
+  agent/recall.js        지난 대화 찾기 (색인 없이, 예산 안에서)
+  agent/memory.js        대화가 끝나도 남는 것
   backend/http.js        HTTP 한 겹 (바깥으로 나가는 유일한 문)
   backend/detect.js      규격·인증 자동 판별
   backend/adapter.js     OpenAI/Ollama 차이 흡수 + 스트리밍 파서
   backend/probe.js       진단 검사 8종
   backend/scan.js        로컬 서버 훑기
-  tools/index.js         도구 9종
+  backend/mcp.js         밖에서 도구 붙이기 (MCP, stdio)
+  tools/index.js         도구 11종
   tools/edit-match.js    단계별 완화 편집 매칭
   tools/webfetch.js      웹 읽기 (읽기 전용)
   tools/todo.js          할 일 목록