deel-local-cli 1.15.1 → 1.16.0

package/README.ko.md

@@ -20,7 +20,7 @@
 
 [![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%2C152%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.1  ⌂ 이 안
+ 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,152항목 — 몇몇은 터미널에 따라 갈립니다)
+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` | 어긋 11개 | **검사가 정말 지키는가** — 지켜야 할 줄을 일부러 어긋내고 빨개지는지 본다 |
+| `mutate` | 어긋 12개 | **검사가 정말 지키는가** — 지켜야 할 줄을 일부러 어긋내고 빨개지는지 본다 |
 
 > **자세히** — 어디를 밟았는지 · 폴더 구조
 >
@@ -1156,6 +1211,7 @@ 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)** | 적어 둔 것이 참인지 기계가 대신 봅니다 — 초록불과 「깨면 잡힌다」 는 다릅니다 |

package/README.md

@@ -20,7 +20,7 @@ Vendor APIs connect too — **only when you say so**
 
 [![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%2C152%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.1  ⌂ 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,152 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` | 11 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,7 @@ 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 |

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.1",
+  "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/agent/asks.js

@@ -93,6 +93,59 @@ const 시킴꼴 = /(줘|주세요|주라|해라|하라|하자|해다오|할래|
 // 줄머리 표. 번호(1. 2))·글머리(- * ·)·동그라미 숫자.
 const 줄머리 = /^\s*(?:(\d{1,2})\s*[.)]|[-*·▪️•]|[①-⑮])\s+/;
 
+/*
+ * ── 시킨 것이 아니라 **조건**인 줄 ─────────────────────────────────────
+ *
+ * 실제로 이렇게 틀렸다. 사람이 친 말은 이랬다 —
+ *
+ *   이 기능을 분석해서 … 부분을 찾아줘.
+ *   각 문제마다 관련 파일과 함수, 발생 조건, 원인을 설명해줘.
+ *   코드는 수정하지 마.
+ *   최대 5개까지만 찾아줘.
+ *
+ * 네 줄 중 셋이 시킴꼴이라 **항목 셋**으로 잡혔고, 마지막 줄이 자국에 안
+ * 닿아서 이런 말이 나갔다 —
+ *
+ *   「시킨 것 중 1가지에 아직 손도 안 댔습니다: 3. 최대 5개까지만 찾아줘.
+ *     지금 하세요.」
+ *
+ * 그런데 「최대 5개까지만」 은 **할 일이 아니라 1번에 붙은 조건**이다. 이미
+ * 지킨 것을 안 했다고 말한 것이고, 이 파일 맨 위에 「제일 나쁘다」 고 적어
+ * 둔 바로 그 짓이다 — 한 번 이러면 그 뒤로 이 검사를 아무도 안 믿는다.
+ *
+ * ── 어떻게 가르나 ───────────────────────────────────────────────────────
+ *
+ * 낱말로 가른다. 그 줄에서 **알맹이를 다 빼고 나면 무엇이 남는가.** 수와
+ * 한계말과 「찾아줘」 같은 맨 동사밖에 안 남으면, 그 줄은 무엇을 하라는
+ * 말이 아니라 얼마나 하라는 말이다.
+ *
+ * 이렇게 하면 진짜 할 일은 안 걸린다 — 「테스트 최대 10개 만들어줘」 에는
+ * '테스트' 가 남아서 조건이 아니다. 가르는 자리를 수가 아니라 **남는 알맹이**
+ * 에 두었기 때문이다.
+ */
+const 한계말 = new Set([
+  '최대', '최소', '많아야', '적어도', '이내', '이하', '이상', '까지', '정도', '넘게',
+  '최대한', '이상은', '개', '가지', '건', '줄', '짧게', '간단히', '간결하게', '되도록',
+  'max', 'min', 'most', 'least', 'only', 'up',
+]);
+// 무엇을 하라는 말이 아니라 그냥 「내놔라」 인 동사들. 이것만 남으면 알맹이가 없다.
+const 맨동사 = new Set([
+  '찾아줘', '찾아', '찾기', '골라줘', '골라', '뽑아줘', '뽑아', '적어줘', '적어',
+  '알려줘', '보여줘', '제시해', '제시', '내줘', '달라', '말해줘', '써줘',
+]);
+// 「…하지 마」 는 무슨 일이 있어도 할 일이 아니다. 안 하는 것이 다 한 것이다.
+const 하지마 = /(?:하지|치지|시키지|되지|넣지|쓰지|고치지|바꾸지|건드리지|만지지)\s*(?:는)?\s*(?:마|말)/;
+const 하지마En = /\b(?:do not|don'?t|never|without)\b/i;
+
+/** 이 줄이 할 일이 아니라 그 일에 붙은 조건인가. */
+export function 조건줄인가(글) {
+  const s = String(글 ?? '');
+  if (하지마.test(s) || 하지마En.test(s)) return true;
+  const 낱말 = 알맹이낱말(s);
+  if (!낱말.length) return false;   // 잴 것이 없으면 안 건다 — 빠진것 이 따로 거른다
+  return 낱말.every((w) => 한계말.has(w) || 맨동사.has(w) || /^\d/.test(w));
+}
+
 /**
  * 시킨 것을 항목으로 쪼갠다.
  *
@@ -100,6 +153,9 @@ const 줄머리 = /^\s*(?:(\d{1,2})\s*[.)]|[-*·▪️•]|[①-⑮])\s+/;
  * 문장 하나를 쉼표로 더 쪼개지는 않는다. 쪼갤수록 없는 항목이 생기고,
  * 없는 항목을 "안 했다" 고 말하는 것이 제일 나쁘다.
  *
+ * 조건인 줄은 항목에서 뺀다(조건줄인가). 개수 제한과 금지는 **지켰을 때
+ * 자국이 안 남는** 종류라, 그대로 두면 지킨 것이 안 한 것으로 잡힌다.
+ *
  * @returns {Array<{번호:number, 글:string}>}
  */
 export function 요청항목들(요청) {
@@ -111,12 +167,12 @@ export function 요청항목들(요청) {
     const m = 줄머리.exec(줄);
     if (!m) continue;
     const 글 = 줄.slice(m[0].length).trim();
-    if (글) 표붙은것.push(글);
+    if (글 && !조건줄인가(글)) 표붙은것.push(글);
   }
   if (표붙은것.length >= 2) return 표붙은것.map((글, i) => ({ 번호: i + 1, 글 }));
 
   // 2) 표는 없지만 줄마다 시키는 꼴
-  const 시킨줄 = 줄들.map((l) => l.trim()).filter((l) => l && 시킴꼴.test(l));
+  const 시킨줄 = 줄들.map((l) => l.trim()).filter((l) => l && 시킴꼴.test(l) && !조건줄인가(l));
   if (시킨줄.length >= 2) return 시킨줄.map((글, i) => ({ 번호: i + 1, 글 }));
 
   return [];

package/src/agent/budget.js

@@ -33,6 +33,18 @@ const 걸음규칙 = {
   ask:          { 배수: 0.25, 최소: 4,  최대: 12 },
   plan:         { 배수: 0.6,  최소: 8,  최대: 40 },
   architect:    { 배수: 0.7,  최소: 8,  최대: 48 },
+  /*
+   * 점검은 **묻기보다 훨씬 넉넉해야** 한다.
+   *
+   * 이 값이 왜 여기 적혀 있는지가 중요하다. 같은 일이 묻기(ask)로 갔을 때
+   * 걸음이 열두 번에서 멈췄다 — 배수 0.25 에 최대 12 라, 창이 200k 여도 12 다.
+   * 파일 열 개를 훑어야 하는 점검에 열두 걸음이면 절반쯤 보고 답을 낸다.
+   * 그런데 화면에는 「다 봤다」 와 구별되는 표시가 아무것도 안 뜬다.
+   *
+   * 설계보다도 넉넉히 준다. 설계는 몇 파일의 관계를 보면 되지만 점검은
+   * **다 뒤져야** 한다 — 안 본 자리에 있는 결함은 없는 것과 같다.
+   */
+  inspect:      { 배수: 1.2,  최소: 16, 최대: 120 },
   auto:         { 배수: 1.5,  최소: 16, 최대: 200 },
   code:         { 배수: 1.5,  최소: 16, 최대: 200 },
   debug:        { 배수: 2,    최소: 16, 최대: 250 },
@@ -101,6 +113,27 @@ export function 웹글자수(ctx) {
   return 사이(k(ctx) * 400, 4000, 120000);
 }
 
+/**
+ * 도구 하나가 한 번에 돌려줄 글자 수.
+ *
+ * ── 여기만 고정 숫자로 남아 있었다 ──────────────────────────────────────
+ *
+ * 이 파일 맨 위에 「고정한 것 자체가 틀린 것」 이라고 적어 놓고, 정작 도구
+ * 결과 상한만 30,000자로 박혀 있었다(tools/index.js 의 MAX_OUT). 그쪽 주석은
+ * 「모델에 맞춰 정한다」 고 말하고 있었으므로, 글과 코드가 서로 다른 말을
+ * 하는 자리이기도 했다.
+ *
+ * 8k 짜리 모델에 30,000자면 한 번으로 창이 넘친다. 넘치면 접히고, 접히면
+ * 앞엣말을 잊는다 — 화면에는 아무 표시가 없고, 사람 눈에는 그냥 "모델이
+ * 멍청해졌다" 로 보인다. 이 파일이 없애려던 고장이 바로 그것이다.
+ *
+ * 큰 창에서는 여태와 같은 값에 선다(30,000). 그 자리는 문제가 없었고,
+ * 문제 없던 자리를 같이 바꾸면 무엇이 좋아졌는지 못 가린다.
+ */
+export function 한번에낼글자수(ctx) {
+  return 사이(k(ctx) * 160, 2000, 30000);
+}
+
 /**
  * 하위 작업이 돌 걸음 수.
  *

package/src/agent/effort.js

@@ -180,6 +180,75 @@ export function 가벼운가(글) {
   return true;
 }
 
+/*
+ * ── 반대쪽 문: **깊이 봐야 하는 말** ────────────────────────────────────
+ *
+ * 위 `가벼운가` 는 강도를 내리는 문이다. 이건 그 문을 **잠그는** 자리다.
+ *
+ * 왜 필요한가 — 모드가 강도를 낮추는 자리가 있다(modes.js 의 묻기: low).
+ * 그 값이 옳은 자리는 "이 함수 뭐야?" 같은 한 줄짜리다. 그런데 무엇이
+ * 묻기 모드로 가는지는 낱말이 정한다(route.js). "…설명해줘" 한 마디면
+ * 간다. 그래서 이런 것도 같이 갔다 —
+ *
+ *   「이 프로젝트의 공동작업 기능을 분석해서 동시 편집 시 데이터 손실,
+ *     덮어쓰기, 충돌 또는 상태 불일치가 발생할 가능성이 있는 부분을 찾아줘.
+ *     실제 코드 근거가 있는 문제만 제시하고 각 문제마다 관련 파일과 함수,
+ *     발생 조건, 원인을 설명해줘. 코드는 수정하지 마. 최대 5개까지만 찾아줘.」
+ *
+ * 파일 열 개를 읽고 경합 조건을 짚어야 하는 일인데, 「짧게 답하라」 는 글과
+ * `low` 를 달고 돌았다. 재 보면 이렇다 — 같은 프로젝트, 같은 질문 —
+ *
+ *   생각 블록:  이쪽 0자   ·  깊게 본 쪽 165,000자
+ *
+ * 값이 5분의 1이면 싼 것이지만, **답이 다르면 싼 게 아니다.**
+ *
+ * ── 무엇으로 가르나 ─────────────────────────────────────────────────────
+ *
+ * 시킨 말의 **모양**으로 가른다. 줄이 여럿이면 시킨 것이 여럿이고, 길면
+ * 조건이 붙어 있고, 살펴보라는 낱말이 있으면 읽어야 답이 나온다. 셋 중
+ * 하나면 충분하다 — 틀리는 방향이 「조금 더 생각한다」 쪽이라 값이 싸다.
+ */
+const 살펴보라는말 = /분석|검토|감사|점검|진단|살펴|파헤|훑어|짚어|찾아|가능성|위험|취약|누락|경합|충돌|불일치|원인|근거|비교|추적|audit|review|analy[sz]e|investigat|assess|diagnos|vulnerab|race\s*condition|compare|trace/i;
+
+/**
+ * 얕게 보면 안 되는 말인가.
+ *
+ * `가벼운가` 의 반대말이 아니다. 둘 다 아닌 말이 대부분이고, 그때는 아무것도
+ * 안 움직인다 — 사람이 정한 천장 그대로 간다.
+ */
+export function 무거운가(글) {
+  const s = String(글 ?? '').trim();
+  if (!s || 인사인가(s)) return false;
+  // 줄이 여럿이면 시킨 것이 여럿이다. 빈 줄은 안 센다 — 붙여넣기에 흔하다.
+  if (s.split(/\r?\n/).filter((l) => l.trim()).length >= 3) return true;
+  // 길면 조건이 붙어 있다. 조건이 붙은 말을 얕게 읽으면 조건부터 떨어진다.
+  if (s.length >= 200) return true;
+  // 짧아도 살펴보라는 말이면 읽어야 답이 나온다. 한 마디짜리는 뺀다.
+  // 스무 자다. 한국어는 빽빽해서 「공동작업 쪽에 경합 조건 있는지 좀 봐줘」 가 스물둘이다 —
+  // 마흔으로 잡으면 진짜 일이 가벼운 쪽으로 떨어진다. 틀리는 값이 한쪽은
+  // 「조금 더 생각한다」 이고 다른 쪽은 「얕게 답한다」 라, 싼 쪽으로 기운다.
+  return s.length >= 20 && 살펴보라는말.test(s);
+}
+
+/**
+ * 이번 턴의 **천장** — 모드가 정한 값과 사람이 정한 값 중에서 고른다.
+ *
+ * 모드가 더 세게 보라고 하면 그대로 따른다(설계·디버그·계획·점검). 그건
+ * 「이 일은 원래 깊다」 는 말이고, 사람이 손대지 않은 기본값보다 그 말이 낫다.
+ *
+ * 모드가 **낮출 때**만 한 번 더 본다. 낮추는 것이 맞는 자리는 한 줄짜리
+ * 물음이고, 시킨 것이 여럿이거나 살펴보라는 말이면 그 자리가 아니다.
+ * 그때는 사람이 정한 값으로 돌아간다 — 모드가 낮추기 전의 자리다.
+ */
+export function 천장고르기(모드think, 세션think, 요청 = '') {
+  const 세션 = LEVELS.includes(세션think) ? 세션think : 'medium';
+  // 끈 것은 모드가 못 켠다. `off` 는 기본값이 아니라 사람이 고른 값이다.
+  if (세션 === 'off') return 'off';
+  if (!모드think || !LEVELS.includes(모드think)) return 세션;
+  if (LEVELS.indexOf(모드think) >= LEVELS.indexOf(세션)) return 모드think;
+  return 무거운가(요청) ? 세션 : 모드think;
+}
+
 /**
  * 이번 턴의 기준 강도.
  *