deel-local-cli 1.15.0 → 1.16.0

package/README.ko.md

@@ -14,13 +14,13 @@
 <br>
 
 [![npm](https://img.shields.io/npm/v/deel-local-cli?logo=npm&logoColor=white&label=npm&color=cb3837)](https://www.npmjs.com/package/deel-local-cli)
-[![downloads](https://img.shields.io/npm/dt/deel-local-cli?label=downloads&color=1a7f37)](https://www.npmjs.com/package/deel-local-cli)
+[![downloads](https://img.shields.io/npm/dm/deel-local-cli?label=downloads&color=1a7f37)](https://www.npmjs.com/package/deel-local-cli)
 [![node](https://img.shields.io/node/v/deel-local-cli?logo=nodedotjs&logoColor=white&label=node&color=5FA04E)](https://nodejs.org)
 [![license](https://img.shields.io/npm/l/deel-local-cli?label=license&color=0969da)](LICENSE)
 
 [![Node.js CI](https://img.shields.io/github/actions/workflow/status/jysvai/deel-local-cli/test.yml?branch=main&logo=github&logoColor=white&label=Node.js%20CI)](https://github.com/jysvai/deel-local-cli/actions/workflows/test.yml)
 [![CodeQL](https://img.shields.io/github/actions/workflow/status/jysvai/deel-local-cli/codeql.yml?branch=main&logo=github&logoColor=white&label=CodeQL)](https://github.com/jysvai/deel-local-cli/actions/workflows/codeql.yml)
-[![tests](https://img.shields.io/badge/tests-7%2C095%20passing-1a7f37?logo=checkmarx&logoColor=white)](docs/ko/develop.md)
+[![tests](https://img.shields.io/badge/tests-7%2C162%20passing-1a7f37?logo=checkmarx&logoColor=white)](docs/ko/develop.md)
 
 [![dependencies](https://img.shields.io/badge/dependencies-0-1a7f37)](https://www.npmjs.com/package/deel-local-cli?activeTab=dependencies)
 [![ESM](https://img.shields.io/badge/ESM-Node%2020%2B-5FA04E?logo=javascript&logoColor=white)](package.json)
@@ -94,7 +94,7 @@
 | [속도와 씀씀이](docs/ko/tuning.md) | 단계별 추론 강도 · 프리픽스 캐시 · 컨텍스트 길이 |
 | [안전망과 사내 반입](docs/ko/safety.md) | 되돌리기 · 작업 범위 · 감사기록 · 심사 서류 |
 | [설정](docs/ko/config.md) · [개발](docs/ko/develop.md) | 환경변수 · 실행 옵션 · 검사 돌리기 · 폴더 구조 |
-| [릴리스 노트](docs/ko/releases.md) | [1.15.x](docs/ko/releases/1.15.md) · [1.14.x](docs/ko/releases/1.14.md) · [1.13.x](docs/ko/releases/1.13.md) · [1.12.x](docs/ko/releases/1.12.md) · [1.10.x](docs/ko/releases/1.10.md) · [1.9.x](docs/ko/releases/1.9.md) · [그 앞](docs/ko/releases.md) |
+| [릴리스 노트](docs/ko/releases.md) | [1.16.x](docs/ko/releases/1.16.md) · [1.15.x](docs/ko/releases/1.15.md) · [1.14.x](docs/ko/releases/1.14.md) · [1.13.x](docs/ko/releases/1.13.md) · [1.12.x](docs/ko/releases/1.12.md) · [1.10.x](docs/ko/releases/1.10.md) · [1.9.x](docs/ko/releases/1.9.md) · [그 앞](docs/ko/releases.md) |
 
 ---
 
@@ -267,7 +267,7 @@ deel --offline
 무엇이 어디로 갈 수 있는지는 켤 때 화면 맨 위에 늘 적혀 있습니다.
 
 ```
- deel 1.15.0  ⌂ 이 안
+ deel 1.16.0  ⌂ 이 안
  보냄    이 컴퓨터 안 127.0.0.1:11434  ← 여기 말고는 어디로도 안 갑니다
 ```
 
@@ -482,7 +482,7 @@ LM Studio 는 `/api/v0/models`, llama.cpp 는 `/props`. 못 알아보면 `(추
 | `/mode <모드>` | 승인 정책 — 얼마나 물어보나 (`auto` · `confirm` · `strict`) |
 | `/work [모드]` | 작업 모드 — 무슨 일을 하는 중인가 |
 | `/auto` | 다시 맡기기 — 말을 보고 알맞은 모드로 저절로 옮겨 갑니다 |
-| `/code` `/plan` `/architect` `/debug` `/ask` `/orchestrator` | 작업 모드 바로 바꾸기 (그때부터 고정) |
+| `/code` `/plan` `/architect` `/debug` `/inspect` `/ask` `/orchestrator` | 작업 모드 바로 바꾸기 (그때부터 고정) |
 | `/level [수준]` | 화면에 무엇을 내놓을지 (`쉬움` · `개발자`) |
 | `/motion [기본\|기사\|동물\|사무실\|끔]` | 일하는 동안 뭐가 도나 — 그 자리에서 바뀌고 설정에 남습니다 |
 | `/undo [턴수]` | 파일 변경 되돌리기 |
@@ -525,6 +525,11 @@ LM Studio 는 `/api/v0/models`, llama.cpp 는 `/props`. 못 알아보면 `(추
 
 ## 작업 모드
 
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/jysvai/deel-local-cli/main/docs/assets/shot-work-ko-dark.svg">
+  <img alt="deel 작업 모드 목록 — 모드마다 파일을 바꿀 수 있는지, 생각 강도, 최대 걸음 수" src="https://raw.githubusercontent.com/jysvai/deel-local-cli/main/docs/assets/shot-work-ko-light.svg" width="900">
+</picture>
+
 무슨 일을 하는 중인지에 따라 **줄 수 있는 도구와 추론 설정이 같이 바뀝니다.**
 `Shift+Tab` 으로 차례로 돌리거나, 이름을 그대로 치면 됩니다.
 
@@ -534,9 +539,13 @@ LM Studio 는 `/api/v0/models`, llama.cpp 는 `/props`. 못 알아보면 `(추
 | `/code` ◆ 코드 | 고치고 만든다 | 예 | 보통 (`save`) |
 | `/plan` ☰ 계획 | 먼저 계획만 세운다 | **아니오** | 깊게 (`deep`·high) |
 | `/architect` ◈ 설계 | 구조를 짠다 | **아니오** | 깊게 (`deep`·high) |
-| `/debug` ◉ 디버그 | 원인을 찾는다 | 예 | 깊게 · 단계 많이 (32) |
-| `/ask` ◇ 묻기 | 설명만 한다 | **아니오** | 얕게 (`low`) |
-| `/orchestrator` ❋ 총괄 | 큰 일을 쪼개서 | 예 | 단계 아주 많이 (40) |
+| `/debug` ◉ 디버그 | 원인을 찾는다 | 예 | 깊게 · 걸음 많이 |
+| `/inspect` ◍ 점검 | 결함을 찾는다 — 근거를 대고, 안 고친다 | **아니오** | 깊게 (`deep`·high) · 걸음 많이 |
+| `/ask` ◇ 묻기 | 설명만 한다 | **아니오** | 얕게 (`low`) — 다만 시킨 것이 여럿이면 안 낮춥니다 |
+| `/orchestrator` ❋ 총괄 | 큰 일을 쪼개서 | 예 | 걸음 아주 많이 |
+
+걸음 수는 **모델 창 크기를 따라갑니다** — 128k 짜리에서 디버그는 250걸음, 묻기는 12걸음입니다.
+작은 모델에 400걸음을 주면 창이 넘쳐 앞엣말을 잊은 채로 도는 것뿐입니다.
 
 읽기만 하는 모드에서는 `Write`·`Edit`·`Bash` 를 **모델에게 아예 보내지 않습니다.**
 "고치지 마세요" 라고 부탁하지 않습니다 — 모델은 부탁을 잊습니다. 없는 도구는 못 씁니다.
@@ -544,7 +553,7 @@ LM Studio 는 `/api/v0/models`, llama.cpp 는 `/props`. 못 알아보면 `(추
 `/mode` 와 헷갈리지 마세요. 둘은 다른 축입니다.
 
 - `/mode` — **얼마나 물어보나** (auto · confirm · strict)
-- `/work` — **무슨 일을 하는 중인가** (위 일곱 가지)
+- `/work` — **무슨 일을 하는 중인가** (위 여덟 가지)
 
 `/think` 나 `/mode` 를 직접 고른 적이 있으면 그 선택이 우선합니다.
 모드가 사람이 고른 값을 덮어쓰지 않습니다.
@@ -629,12 +638,41 @@ PDF 는 **못 읽은 쪽을 못 읽었다고 말합니다.** 스캔본·암호·
 빈 글로 넘기지 않고 그 자리에 까닭을 적습니다 — 빈 글은 「그런 내용이 없다」로
 읽히기 때문입니다.
 
+문서를 **마크다운 한 장으로** 뽑아 두려면 `deel doc2md` 입니다. 표가
+`| 이름 | 값 |` 꼴로 살아 있는 채로 나오기 때문에, 평평한 글보다 모델이 훨씬
+덜 헷갈립니다.
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/jysvai/deel-local-cli/main/docs/assets/shot-doc2md-dark.svg">
+  <img alt="deel doc2md 로 docx 를 마크다운으로 — 표가 마크다운 표로 그대로 남는다" src="https://raw.githubusercontent.com/jysvai/deel-local-cli/main/docs/assets/shot-doc2md-light.svg" width="820">
+</picture>
+
+```bash
+deel doc2md 보고서.pptx              # 표준출력으로
+deel doc2md 스펙.pdf --out 스펙.md   # 파일로
+```
+
+**Figma 시안(`.fig`)도 읽습니다.** 「이 시안대로 만들어 줘」 하고 건네받은
+파일이 「이진 파일이라 못 읽습니다」 로 끝나던 자리입니다. 안에는 그림만이
+아니라 **틀 이름 · 글 · 크기 · 겹친 차례**가 다 글자로 들어 있습니다.
+
+```
+- FRAME · 로그인 화면 375×812
+  - TEXT · 제목 "다시 오신 것을 환영합니다"
+  - FRAME · 입력칸 335×48
+    - TEXT · 라벨 "이메일"
+```
+
+색·그림자·글꼴은 안 냅니다 — 그리고 **안 낸다고 먼저 말합니다.** 요즘 `.fig`
+는 zstd 로 눌려 있어 Node 22.15 이상이 필요하고, 낮은 판에서는 「깨진 파일」 이
+아니라 **여기서 못 푼다**고 말합니다.
+
 옛 형식(`.ppt`·`.doc`·`.xls`·`.rtf`)은 **이 PC 에 깔린 LibreOffice 를 빌려서**
 읽습니다 — `rg` 를 빌려 쓰는 것과 같은 원칙으로, 아무것도 설치하지 않습니다.
 없으면 **없다고 못 박고 끝냅니다**(무엇이 없어서 못 하는지, 무엇을 하면 되는지,
 그리고 「다시 열지 말라」까지). 끄려면 `DEEL_CONVERT=off`.
 
-> **자세히** — 인코딩 · 엑셀 · hwpx/docx/pptx · PDF · 변환기 빌려 쓰기
+> **자세히** — 인코딩 · 엑셀 · hwpx/docx/pptx · PDF · `doc2md` · 변환기 빌려 쓰기
 >
 > **[한글 문서와 엑셀 읽기 →](docs/ko/documents.md#한글-문서와-엑셀)**
 
@@ -898,6 +936,23 @@ deel acp
 에디터가 이걸 자식 프로세스로 띄우고, 표준입출력으로 줄 단위 JSON-RPC 2.0 을
 주고받습니다. 사람이 직접 칠 명령은 아닙니다.
 
+**Zed 라면 이렇게 적습니다.** 에이전트 패널의 `Settings → External Agents →
+Add Custom Agent` 를 눌러도 되고, `settings.json` 에 바로 적어도 됩니다.
+
+```json
+{
+  "agent_servers": {
+    "deel": { "type": "custom", "command": "npx", "args": ["-y", "deel-local-cli", "acp"], "env": {} }
+  }
+}
+```
+
+그리고 에이전트 패널에서 **deel** 을 고릅니다. 아직 `deel setup` 을 안 했다면
+deel 이 「연결이 없다」 고 에디터에게 **규격대로**(ACP 의 `AuthRequired`) 말하고,
+같이 보내 둔 ``Run `deel setup` in a terminal`` 이 뜹니다 — 빨간 글씨만 보고
+버그인지 설정 문제인지 헤매지 않게 하려는 것입니다. 터미널에서 한 번 마치면
+그 다음부터는 바로 대화가 열립니다.
+
 **붙으면 이렇게 됩니다.**
 
 | 에디터 쪽 | deel 쪽 |
@@ -906,7 +961,7 @@ deel acp
 | 도구 목록 (아이콘·상태) | `Read` 는 읽기, `Edit` 는 고치기, `Bash` 는 실행 — **갈래를 붙여** 보냅니다 |
 | 파일 링크 | 고친 파일의 **절대 경로**. 눌러서 그 자리로 갑니다 |
 | 승인 창 | deel 의 안전망이 그대로 에디터 창으로 뜹니다 (`이번만` · `앞으로 묻지 않기` · `안 함`) |
-| 모드 고르개 | deel 의 작업 모드 7개 (`종합` · `코드` · `계획` · `설계` · `디버그` · `묻기` · `총괄`) |
+| 모드 고르개 | deel 의 작업 모드 8개 (`종합` · `코드` · `계획` · `설계` · `디버그` · `점검` · `묻기` · `총괄`) |
 | 멈춤 단추 | 도중에 닿습니다 — 답을 기다리는 중에도 |
 | 지난 대화 | 껐다 켜도 그대로 열립니다. 터미널과 **같은 자리**에 남아서, 에디터에서 하던 것을 `deel --resume` 으로 이어받는 것도 됩니다 |
 
@@ -1087,7 +1142,7 @@ deel sbom --only sbom         # SBOM 한 장만
 ## 개발
 
 ```bash
-npm test          전체 검증 (7,144항목 — 몇몇은 터미널에 따라 갈립니다)
+npm test          전체 검증 (7,346항목 — 몇몇은 터미널에 따라 갈립니다)
 npm run coverage  검사가 소스의 어디를 밟았는지
 npm run verify    반입·통신 검증만
 npm run bench     편집 성공률 측정
@@ -1144,7 +1199,7 @@ zip 은 진짜 `unzip` 으로, tar 는 진짜 `tar` 가 만든 것을 읽혀 교
 | `exitcode` · `doorparity` | 7 · 7 | 화면에 적은 종료코드 표가 진짜인가 · 문 **네 개**가 같은 것을 주는가 |
 | `no-bundle` | 21 | 배포 묶음에 남의 것이 안 섞였는가 · 검사 파일 위생 |
 | `edit-bench` | 20건 | 편집 성공률 |
-| `mutate` | 어긋 10개 | **검사가 정말 지키는가** — 지켜야 할 줄을 일부러 어긋내고 빨개지는지 본다 |
+| `mutate` | 어긋 12개 | **검사가 정말 지키는가** — 지켜야 할 줄을 일부러 어긋내고 빨개지는지 본다 |
 
 > **자세히** — 어디를 밟았는지 · 폴더 구조
 >
@@ -1156,6 +1211,8 @@ zip 은 진짜 `unzip` 으로, tar 는 진짜 `tar` 가 만든 것을 읽혀 교
 
 | 판 | 무엇이 바뀌었나 |
 |---|---|
+| **[1.16.0](docs/ko/releases/1.16.md#1160)** | 깊이 봐 달라는 말을 얕게 받던 자리 · 게이트웨이 캐시 · `doc2md` · Figma `.fig` |
+| **[1.15.1](docs/ko/releases/1.15.md#1151)** | 에디터에 우리가 어떻게 인증받는지 말합니다 — ACP 레지스트리 등재 조건 |
 | **[1.15.0](docs/ko/releases/1.15.md#1150)** | 같은 것을 두 번 하지 않습니다 — 프리픽스 캐시를 깨던 조용히 비싼 아홉 자리 |
 | **[1.14.0](docs/ko/releases/1.14.md#1140)** | 적어 둔 것이 참인지 기계가 대신 봅니다 — 초록불과 「깨면 잡힌다」 는 다릅니다 |
 | [1.13.1](docs/ko/releases/1.13.md#1131) | 올라간 물건이 소스와 달랐습니다 — 148개 중 47개가 CRLF 로 나갔습니다 |

package/README.md

@@ -14,13 +14,13 @@ Vendor APIs connect too — **only when you say so**
 <br>
 
 [![npm](https://img.shields.io/npm/v/deel-local-cli?logo=npm&logoColor=white&label=npm&color=cb3837)](https://www.npmjs.com/package/deel-local-cli)
-[![downloads](https://img.shields.io/npm/dt/deel-local-cli?label=downloads&color=1a7f37)](https://www.npmjs.com/package/deel-local-cli)
+[![downloads](https://img.shields.io/npm/dm/deel-local-cli?label=downloads&color=1a7f37)](https://www.npmjs.com/package/deel-local-cli)
 [![node](https://img.shields.io/node/v/deel-local-cli?logo=nodedotjs&logoColor=white&label=node&color=5FA04E)](https://nodejs.org)
 [![license](https://img.shields.io/npm/l/deel-local-cli?label=license&color=0969da)](LICENSE)
 
 [![Node.js CI](https://img.shields.io/github/actions/workflow/status/jysvai/deel-local-cli/test.yml?branch=main&logo=github&logoColor=white&label=Node.js%20CI)](https://github.com/jysvai/deel-local-cli/actions/workflows/test.yml)
 [![CodeQL](https://img.shields.io/github/actions/workflow/status/jysvai/deel-local-cli/codeql.yml?branch=main&logo=github&logoColor=white&label=CodeQL)](https://github.com/jysvai/deel-local-cli/actions/workflows/codeql.yml)
-[![tests](https://img.shields.io/badge/tests-7%2C095%20passing-1a7f37?logo=checkmarx&logoColor=white)](docs/en/develop.md)
+[![tests](https://img.shields.io/badge/tests-7%2C162%20passing-1a7f37?logo=checkmarx&logoColor=white)](docs/en/develop.md)
 
 [![dependencies](https://img.shields.io/badge/dependencies-0-1a7f37)](https://www.npmjs.com/package/deel-local-cli?activeTab=dependencies)
 [![ESM](https://img.shields.io/badge/ESM-Node%2020%2B-5FA04E?logo=javascript&logoColor=white)](package.json)
@@ -119,7 +119,7 @@ This page is the **summary**. Each section links to the detail behind it.
 | [Speed and spend](docs/en/tuning.md) | Per-stage effort · the prefix cache · context length |
 | [Safety and corporate review](docs/en/safety.md) | Undo · working scope · audit log · the review package |
 | [Configuration](docs/en/config.md) · [Development](docs/en/develop.md) | Env vars · run flags · running the tests · folder layout |
-| [Release notes](docs/en/releases.md) | [1.15.x](docs/en/releases/1.15.md) · [1.14.x](docs/en/releases/1.14.md) · [1.13.x](docs/en/releases/1.13.md) · [1.12.x](docs/en/releases/1.12.md) · [1.10.x](docs/en/releases/1.10.md) · [1.9.x](docs/en/releases/1.9.md) · [older](docs/en/releases.md) |
+| [Release notes](docs/en/releases.md) | [1.16.x](docs/en/releases/1.16.md) · [1.15.x](docs/en/releases/1.15.md) · [1.14.x](docs/en/releases/1.14.md) · [1.13.x](docs/en/releases/1.13.md) · [1.12.x](docs/en/releases/1.12.md) · [1.10.x](docs/en/releases/1.10.md) · [1.9.x](docs/en/releases/1.9.md) · [older](docs/en/releases.md) |
 
 ---
 
@@ -338,7 +338,7 @@ deel --offline
 The destination is printed at the top of every session:
 
 ```
- deel 1.15.0  ⌂ inside
+ deel 1.16.0  ⌂ inside
  Sends to this machine 127.0.0.1:11434  ← nowhere else
 ```
 
@@ -545,7 +545,7 @@ Names follow Claude Code / Codex conventions.
 | `/mode <mode>` | Approval policy — how much it asks (`auto` · `confirm` · `strict`) |
 | `/work [mode]` | Work mode — what kind of work you are doing |
 | `/auto` | Hand the wheel back — it picks the mode from what you type |
-| `/code` `/plan` `/architect` `/debug` `/ask` `/orchestrator` | Switch work mode directly (pins it) |
+| `/code` `/plan` `/architect` `/debug` `/inspect` `/ask` `/orchestrator` | Switch work mode directly (pins it) |
 | `/level [level]` | How much to show (`simple` · `developer`) |
 | `/motion [plain\|knight\|animal\|office\|off]` | What animates while it works — takes effect at once, and is saved |
 | `/undo [turns]` | Revert file changes |
@@ -591,6 +591,11 @@ Korean IME composition, paste, `Ctrl+A/E` and backspace all keep working.
 
 ## Work modes
 
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/jysvai/deel-local-cli/main/docs/assets/shot-work-en-dark.svg">
+  <img alt="deel work modes: whether each can edit files, its reasoning depth, and its step ceiling" src="https://raw.githubusercontent.com/jysvai/deel-local-cli/main/docs/assets/shot-work-en-light.svg" width="900">
+</picture>
+
 What you are working on changes **which tools the model is given and how hard it thinks.**
 Cycle with `Shift+Tab`, or type the name.
 
@@ -600,9 +605,13 @@ Cycle with `Shift+Tab`, or type the name.
 | `/code` ◆ Code | Writing and fixing | Yes | Normal (`save`) |
 | `/plan` ☰ Plan | Planning first | **No** | Deep (`deep`·high) |
 | `/architect` ◈ Architect | Shaping structure | **No** | Deep (`deep`·high) |
-| `/debug` ◉ Debug | Finding causes | Yes | Deep, more steps (32) |
-| `/ask` ◇ Ask | Explaining only | **No** | Shallow (`low`) |
-| `/orchestrator` ❋ Orchestrator | Breaking up large work | Yes | Many steps (40) |
+| `/debug` ◉ Debug | Finding causes | Yes | Deep, many steps |
+| `/inspect` ◍ Inspect | Auditing for defects — with evidence, changing nothing | **No** | Deep (`deep`/high), many steps |
+| `/ask` ◇ Ask | Explaining only | **No** | Shallow (`low`) — not lowered when the ask has several parts |
+| `/orchestrator` ❋ Orchestrator | Breaking up large work | Yes | Very many steps |
+
+The step ceiling **follows the model's window** — on a 128k model debug gets 250 steps and ask gets 12.
+Hand a small model 400 steps and it just runs on past the point where its window folded.
 
 In read-only modes, `Write`, `Edit` and `Bash` are **never sent to the model at all.**
 It is not asked politely not to edit — models forget requests. A tool that isn't there can't be used.
@@ -610,7 +619,7 @@ It is not asked politely not to edit — models forget requests. A tool that isn
 Don't confuse this with `/mode`. They are separate axes:
 
 - `/mode` — **how much it asks you** (auto · confirm · strict)
-- `/work` — **what kind of work you are doing** (the seven above)
+- `/work` — **what kind of work you are doing** (the eight above)
 
 If you have explicitly set `/think` or `/mode`, your choice wins. A work mode never
 overrides something a person chose.
@@ -689,12 +698,42 @@ their cost; here is why.
 **A file saved as CP949 is written back as CP949.** The encoding is never changed.
 Excel (`.xlsx`) is read as CSV — read-only.
 
+To keep a document as **one Markdown file**, use `deel doc2md`. Tables survive as
+real `| name | value |` tables, so a model has far less to guess at than it does
+with flattened text.
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/jysvai/deel-local-cli/main/docs/assets/shot-doc2md-dark.svg">
+  <img alt="deel doc2md turning a docx into Markdown — the table stays a table" src="https://raw.githubusercontent.com/jysvai/deel-local-cli/main/docs/assets/shot-doc2md-light.svg" width="820">
+</picture>
+
+```bash
+deel doc2md report.pptx            # to stdout
+deel doc2md spec.pdf --out spec.md # to a file
+```
+
+**Figma designs (`.fig`) are read too.** Handing over a design with "build this"
+used to end at "binary file, cannot be read". What is inside is not only
+pictures — **frame names, text, sizes and stacking order** are all there as
+characters.
+
+```
+- FRAME · Login screen 375×812
+  - TEXT · Title "Welcome back"
+  - FRAME · Field 335×48
+    - TEXT · Label "Email"
+```
+
+No colours, shadows or fonts — and it **says so up front**. Recent `.fig` files
+are zstd-compressed, which needs Node 22.15 or newer; on an older one it says
+**this Node cannot unpack it**, not "corrupt file".
+
 Old formats (`.ppt`, `.doc`, `.xls`, `.rtf`) are read by **borrowing the LibreOffice already
 on this machine** — the same terms on which deel borrows `rg`, and nothing is ever installed.
 With no converter it **says so definitively and stops**: what is missing, what you can do about
 it, and not to open the file again. Turn it off with `DEEL_CONVERT=off`.
 
-> **More** — Encoding · Excel · borrowing a converter
+> **More** — Encoding · Excel · `doc2md` · borrowing a converter
 >
 > **[Korean documents and Excel read →](docs/en/documents.md#korean-text-and-excel)**
 
@@ -977,6 +1016,23 @@ deel acp
 The editor spawns that as a child process and exchanges newline-delimited JSON-RPC 2.0 over
 stdio. It is not a command you type yourself.
 
+**In Zed, concretely.** Either use `Settings → External Agents → Add Custom Agent` in the
+agent panel, or put this straight into `settings.json`:
+
+```json
+{
+  "agent_servers": {
+    "deel": { "type": "custom", "command": "npx", "args": ["-y", "deel-local-cli", "acp"], "env": {} }
+  }
+}
+```
+
+Then pick **deel** in the agent panel. If you have not run `deel setup` yet, deel tells the
+editor so **the way the spec says to** (ACP's `AuthRequired`), along with the method it sent
+at connect time — ``Run `deel setup` in a terminal``. That is there so a first run is not a
+red error message you cannot tell from a bug. Finish it once in a terminal and the editor
+opens straight into a conversation from then on.
+
 **What you get once it is attached:**
 
 | In the editor | From deel |
@@ -985,7 +1041,7 @@ stdio. It is not a command you type yourself.
 | Tool list with icons and status | `Read` is a read, `Edit` is an edit, `Bash` is an execution — **the kind is sent**, not just a name |
 | Clickable file links | The **absolute path** of every file touched |
 | Approval dialog | deel's safety rails, rendered as the editor's own prompt (`allow once` · `always allow` · `reject`) |
-| Mode picker | deel's seven work modes (auto · code · plan · architect · debug · ask · orchestrator) |
+| Mode picker | deel's eight work modes (auto · code · plan · architect · debug · inspect · ask · orchestrator) |
 | Stop button | Reaches the turn mid-flight, even while waiting on the model |
 | Past conversations | Still there after a restart. They live in the **same place** as the terminal's, so a session started in the editor can be picked up with `deel --resume` |
 
@@ -1158,7 +1214,7 @@ Stored in `~/.deel/config.json`. A `.deel/config.json` in the project folder tak
 ## Development
 
 ```bash
-npm test          Full suite (7,144 checks; a few are TTY-dependent)
+npm test          Full suite (7,346 checks; a few are TTY-dependent)
 npm run coverage  Which lines the tests actually execute
 npm run verify    Import + network checks only
 npm run bench     Edit success rate
@@ -1201,7 +1257,7 @@ so one run tells you everything.
 | `exitcode` · `doorparity` | 7 · 7 | The printed exit-code table is real · all **four** doors hand out the same thing |
 | `no-bundle` | 21 | Nothing foreign in the published package; test-file hygiene |
 | `edit-bench` | 20 cases | Edit success rate |
-| `mutate` | 10 mutants | **Whether the tests actually guard** — break the line on purpose, check it turns red |
+| `mutate` | 12 mutants | **Whether the tests actually guard** — break the line on purpose, check it turns red |
 
 > **More** — Coverage · Layout
 >
@@ -1213,6 +1269,8 @@ so one run tells you everything.
 
 | Version | What changed |
 |---|---|
+| **[1.16.0](docs/en/releases/1.16.md#1160)** | A deep request no longer lands in a shallow mode · gateway cache · `doc2md` · Figma `.fig` |
+| **[1.15.1](docs/en/releases/1.15.md#1151)** | Telling the editor how we get authenticated — ACP Registry listing requirement |
 | **[1.15.0](docs/en/releases/1.15.md#1150)** | Stop doing the same thing twice — nine quietly expensive places that broke the prefix cache |
 | **[1.14.0](docs/en/releases/1.14.md#1140)** | A machine now checks that what we wrote down is true — green does not mean guarded |
 | [1.13.1](docs/en/releases/1.13.md#1131) | What shipped was not what the source said — 47 of 148 files went out with CRLF line endings |

package/bin/deel.js

@@ -15,6 +15,7 @@ import { runSessions } from '../src/agent/sessionui.js';
 import { acp } from '../src/acp/serve.js';
 import { runCompletion } from '../src/completion.js';
 import { runReset } from '../src/reset.js';
+import { 마크다운, 읽는갈래 } from '../src/tools/doc2md.js';
 import { 언어잡기, 언어 } from '../src/i18n/index.js';
 import { load as 설정읽기 } from '../src/config.js';
 
@@ -112,6 +113,47 @@ function runAudit() {
  * 운영팀은 감사기록 사양을 보고 수집 규칙을 짠다. zip 을 통째로 만들지 않고
  * 그 두 장만 필요할 때가 실제로 더 잦다 — 심사 양식에 첨부하는 자리다.
  */
+/*
+ * `deel doc2md <파일> [--out 이름.md]` — 문서를 마크다운으로.
+ *
+ * 읽는 일은 이미 있는 세 읽개가 그대로 한다(docs.js · xlsx.js · pdf.js).
+ * 여기서 새로 들이는 것은 없다 — 의존성 0개는 그대로다.
+ *
+ * `--out` 이 없으면 표준출력으로 낸다. 파이프에 바로 물리는 자리라
+ * 여기서는 say() 를 안 쓴다 (completion 과 같은 규칙이다).
+ */
+function runDoc2md(args, flags) {
+  const 파일 = args[0];
+  if (!파일) {
+    say(`  ${mark.warn} 바꿀 파일을 주세요: ${c.white('deel doc2md 보고서.pptx')}`);
+    say(`  ${c.gray('직접 읽는 것:')} ${읽는갈래.join(c.gray(' · '))}`);
+    return 1;
+  }
+  const r = 마크다운(파일);
+  if (!r.ok) {
+    say('');
+    for (const 줄 of String(r.error).split('\n')) say(`  ${mark.warn} ${줄}`);
+    say('');
+    return 1;
+  }
+  // 못 읽은 쪽·자른 자리는 **반드시** 말한다. 조용히 자르면 받은 사람은
+  // 그게 문서 전부인 줄 알고 그 위에 판단을 쌓는다.
+  if (flags.out) {
+    const 자리 = String(flags.out);
+    writeFileSync(자리, r.md, 'utf8');
+    say('');
+    say(`  ${mark.ok} ${c.bold(자리)}  ${c.gray(r.summary)}`);
+    for (const 줄 of r.말 ?? []) say(`  ${c.gray(`· ${줄}`)}`);
+    say('');
+    return 0;
+  }
+  // 글은 표준출력, 말은 표준오류로 나눈다. 그래야 `> 보고서.md` 로 받아도
+  // 「몇 자에서 잘랐습니다」 가 파일 안에 섞여 들어가지 않는다.
+  process.stdout.write(`${r.md}\n`);
+  for (const 줄 of r.말 ?? []) process.stderr.write(`${줄}\n`);
+  return 0;
+}
+
 function runSbom(flags) {
   const a = audit();
   const at = new Date();
@@ -223,7 +265,7 @@ function help() {
   say('');
   say(`    ${c.gray('--root <폴더>')}      작업 범위. 기본은 지금 폴더`);
   say(`    ${c.gray('--mode <모드>')}      auto(기본) / confirm / strict`);
-  say(`    ${c.gray('--work <모드>')}      auto(기본·종합) / code / plan / architect / debug / ask / orchestrator`);
+  say(`    ${c.gray('--work <모드>')}      auto(기본·종합) / code / plan / architect / debug / inspect / ask / orchestrator`);
   say(`    ${c.gray('--level <수준>')}     쉬움(기본) / 개발자`);
   say(`    ${c.gray('--ctx <길이>')}       컨텍스트 길이 직접 지정 (655360 · 640k · 128k). 없으면 서버에 맞춤`);
   say(`    ${c.gray('--max-tokens <길이>')} 한 번에 받을 답 길이 상한 (32k). 큰 파일이 잘리면 올린다 — /out 과 같은 값`);
@@ -374,6 +416,8 @@ async function main() {
       return runPack(flags);
     case 'audit':
       return runAudit();
+    case 'doc2md':
+      return runDoc2md(args, flags);
     case 'sbom':
       return runSbom(flags);
     case 'scan':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deel-local-cli",
-  "version": "1.15.0",
+  "version": "1.16.0",
   "description": "A coding-agent CLI that runs on local models and private gateways. Zero dependencies, Node 20+.",
   "type": "module",
   "license": "MIT",

package/src/acp/jsonrpc.js

@@ -33,6 +33,16 @@ export const 오류번호 = {
   모르는방법: -32601,
   잘못된인자: -32602,
   안쪽오류: -32603,
+  /*
+   * 인증이 있어야 한다.
+   *
+   * 다른 번호와 달리 이건 JSON-RPC 가 아니라 **ACP 가 정한 번호**다
+   * (규격의 ErrorCode::AuthRequired). 에디터는 이 번호를 봐야 initialize
+   * 때 받아 둔 authMethods 를 꺼내 「인증」 단추를 그린다. 잘못된인자로
+   * 답하면 그냥 빨간 글씨가 뜨고, 사람은 이게 설정 문제인지 버그인지
+   * 모른다 — 할 수 있는 안내를 안 한 셈이다.
+   */
+  인증필요: -32000,
 };
 
 /**
@@ -228,3 +238,16 @@ export function 잘못된인자오류(무엇) {
   e.code = 오류번호.잘못된인자;
   return e;
 }
+
+/**
+ * 아직 인증(연결 설정)이 안 됐다고 답하게 하는 오류.
+ *
+ * 글은 그대로 사람에게 보인다. 그러니 **무엇을 하면 되는지**까지 적는다 —
+ * 번호만 맞고 글이 「인증이 필요합니다」 면 어디서 무엇을 해야 하는지 여전히
+ * 모른다.
+ */
+export function 인증필요오류(무엇) {
+  const e = new Error(무엇);
+  e.code = 오류번호.인증필요;
+  return e;
+}

package/src/acp/serve.js

@@ -54,7 +54,7 @@ import { 못박기 } from '../agent/pins.js';
 import { route } from '../agent/route.js';
 import { ORDER as 모드순서, get as getWork, normalize as 모드정리 } from '../agent/modes.js';
 import { 모두끝내기 as 일감모두끝내기 } from '../tools/jobs.js';
-import { 연결, 줄나누기, 모르는방법오류, 잘못된인자오류 } from './jsonrpc.js';
+import { 연결, 줄나누기, 모르는방법오류, 잘못된인자오류, 인증필요오류 } from './jsonrpc.js';
 import { 도구시작, 도구끝남, 도구이름표, 도구갈래, 도구자리, 멈춘까닭, 프롬프트글, 되살린것 } from './map.js';
 
 /** 우리가 말하는 규격 판. 정수 하나이고, 깨지는 변경에서만 올라간다. */
@@ -87,6 +87,35 @@ export async function acp(opts = {}) {
   const 내보내기 = 표준출력잠그기();
   const 로그 = (s) => { try { process.stderr.write(`[acp] ${s}\n`); } catch { /* 여기서 또 터지면 할 게 없다 */ } };
 
+  /*
+   * ── 우리가 어떻게 인증받는지 ────────────────────────────────────────────
+   *
+   * ACP 의 `initialize` 응답에는 authMethods 자리가 있다. 여기를 비워 두면
+   * 에디터는 「이 에이전트는 인증이 필요 없다」 로 읽는다. 그런데 deel 은
+   * 연결 정보가 없으면 아무 일도 못 한다.
+   *
+   * 그래서 처음 붙인 사람은 이렇게 됐다 — 에디터에서 deel 을 고르고, 대화를
+   * 열고, 「저장된 연결이 없습니다」 를 받는다. 화면만 봐서는 이게 인증
+   * 문제인지 버그인지 모른다.
+   *
+   * 규격에는 그 자리가 있다. **Terminal Auth** — 「터미널에서 이 인자로 나를
+   * 다시 띄우면 설정이 끝난다」 고 말하는 방법이다. 그리고 deel 은 그 명령이
+   * 이미 있다: `deel setup`. 없는 것을 만드는 게 아니라 **있는 것을 말하는**
+   * 일이었다.
+   *
+   * args 가 진짜 도는 명령인지는 검사가 지킨다(test/acp.test.js 의 5-11).
+   * 여기가 틀리면 에디터가 사람에게 없는 명령을 치라고 시킨다.
+   */
+  const 인증방법들 = [
+    {
+      id: 'terminal-setup',
+      name: 'Run `deel setup` in a terminal',
+      description: '로컬 런타임(Ollama · LM Studio · llama.cpp)을 고르거나 게이트웨이 주소와 열쇠를 넣습니다.',
+      type: 'terminal',
+      args: ['setup'],
+    },
+  ];
+
   /** 세션 하나. 에디터의 탭 하나에 해당한다. */
   const 방들 = new Map();
 
@@ -127,7 +156,16 @@ export async function acp(opts = {}) {
     const cfg = load();
     const prof = activeProfile(cfg);
     if (!prof) {
-      throw 잘못된인자오류('저장된 연결이 없습니다. 터미널에서 `deel setup` 을 먼저 실행하세요.');
+      /*
+       * 잘못된인자가 아니라 **인증필요**다.
+       *
+       * 사람이 인자를 잘못 준 것이 아니라 아직 설정을 안 한 것이다. 그 둘은
+       * 에디터에서 하는 일이 다르다 — 인증필요(-32000)를 받으면 위 initialize
+       * 에서 받아 둔 authMethods 를 꺼내 「터미널에서 설정하기」 를 띄우고,
+       * 잘못된인자면 그냥 빨간 글씨만 뜬다. 고칠 방법이 있는데 안 알려 주는
+       * 것이 제일 나쁘다.
+       */
+      throw 인증필요오류('저장된 연결이 없습니다. 터미널에서 `deel setup` 을 먼저 실행하세요.');
     }
 
     /*
@@ -729,13 +767,32 @@ export async function acp(opts = {}) {
             mcpCapabilities: { http: false, sse: false },
           },
           agentInfo: { name: 'deel', title: 'deel (로컬 모델 코딩 에이전트)', version: 판번호() },
-          authMethods: [],   // 연결 설정은 `deel setup` 이 맡는다
+          authMethods: 인증방법들,
         };
       }
 
-      case 'authenticate':
-        // 인증 방법을 하나도 안 걸었으니 여기 올 일이 없다. 와도 조용히 넘긴다.
+      /*
+       * 에디터가 「인증」 을 눌렀다.
+       *
+       * 우리 인증은 터미널에서 도는 것이라(위 인증방법들 머리말), 여기서
+       * 우리가 할 일은 없다 — 에디터가 우리를 `deel setup` 으로 다시 띄우고,
+       * 사람이 거기서 마치고, 그 다음에 이 프로세스가 다시 연결된다.
+       *
+       * 그래도 **끝났는지는 확인해 준다.** 사람이 설정을 안 마치고 창을
+       * 닫았는데 여기서 성공이라고 답하면, 에디터는 인증이 끝난 줄 알고 대화를
+       * 열고, 그 다음 한마디에서야 같은 오류가 난다. 한 번 더 돌아가는 셈이다.
+       */
+      case 'authenticate': {
+        const 골라온것 = String(인자?.methodId ?? '');
+        if (골라온것 && !인증방법들.some((m) => m.id === 골라온것)) {
+          throw 잘못된인자오류(`모르는 인증 방법입니다: ${골라온것}`);
+        }
+        if (!activeProfile(load())) {
+          throw 인증필요오류('아직 설정이 안 끝났습니다. 터미널에서 `deel setup` 을 마치고 다시 시도하세요.');
+        }
+        로그('설정이 확인됐습니다.');
         return {};
+      }
 
       case 'session/new': {
         const 방 = await 방만들기(인자);