deel-local-cli 1.5.8 → 1.6.1

package/README.en.md

@@ -18,7 +18,7 @@ Zero dependencies · Node 20+ · Exactly one place your source can go
 
 [![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-3%2C869%20passing-1a7f37?logo=checkmarx&logoColor=white)](docs/en/develop.md)
+[![tests](https://img.shields.io/badge/tests-4%2C932%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)
@@ -95,12 +95,12 @@ This page is the **summary**. Each section links to the detail behind it.
 | [Models](docs/en/models.md) | Grade and window size · Korean-model presets · project detection |
 | [The screen](docs/en/interface.md) | The input box · work modes · simple vs developer · what it asks about |
 | [Tools in depth](docs/en/tools.md) | `Outline` · `Verify` · `Task` · `Jobs` · `Append` · `Def`/`Refs` · edit matching |
-| [Korean documents and Excel](docs/en/documents.md) | hwpx/docx/pptx · encoding · Excel → CSV |
+| [Korean documents and Excel](docs/en/documents.md) | hwpx/docx/pptx/**PDF** · encoding · Excel → CSV |
 | [Extending](docs/en/extend.md) | Skills · plugins · MCP · ACP |
 | [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.5.8](docs/en/releases.md#158) · [1.5.7](docs/en/releases.md#157) · [1.5.6](docs/en/releases.md#156) · [1.5.5](docs/en/releases.md#155) · [1.5.4](docs/en/releases.md#154) · [1.5.3](docs/en/releases.md#153) · [1.5.2](docs/en/releases.md#152) · [1.5.1](docs/en/releases.md#151) · [1.5.0](docs/en/releases.md#150) · [1.4.3](docs/en/releases.md#143) · [1.4.2](docs/en/releases.md#142) · [1.4.1](docs/en/releases.md#141) · [1.4.0](docs/en/releases.md#140) · [1.3.0](docs/en/releases.md#130) · [1.2.0](docs/en/releases.md#120) |
+| [Release notes](docs/en/releases.md) | [1.6.1](docs/en/releases.md#161) · [1.6.0](docs/en/releases.md#160) · [1.5.8](docs/en/releases.md#158) · [1.5.7](docs/en/releases.md#157) · [1.5.6](docs/en/releases.md#156) · [1.5.5](docs/en/releases.md#155) · [1.5.4](docs/en/releases.md#154) · [1.5.3](docs/en/releases.md#153) · [1.5.2](docs/en/releases.md#152) · [1.5.1](docs/en/releases.md#151) · [1.5.0](docs/en/releases.md#150) · [1.4.3](docs/en/releases.md#143) · [1.4.2](docs/en/releases.md#142) · [1.4.1](docs/en/releases.md#141) · [1.4.0](docs/en/releases.md#140) · [1.3.0](docs/en/releases.md#130) · [1.2.0](docs/en/releases.md#120) |
 
 ---
 
@@ -207,19 +207,23 @@ reviewer catches one drifted claim, they stop trusting the rest of it.
 
 ## Quick start
 
-### The screen speaks English too
+### The screen speaks your language
 
 deel is written in Korean — the code, the function names, the comments. That part stays.
-What you see on screen does not have to.
+What you see on screen does not have to. Four screen languages ship: **한국어 · English ·
+日本語 · 中文**, all four complete.
 
 ```bash
-DEEL_LANG=en deel        # this run only
+DEEL_LANG=en deel        # this run only  (also ja, zh)
 /lang en                 # and remember it
+/lang ja                 # 日本語
+/lang zh                 # 中文
 /lang                    # how much is translated so far
 ```
 
-Untranslated lines come through in Korean rather than as blanks, and `/lang` tells you exactly
-how many are left.
+Nothing ever comes through blank. A line that has not been translated falls back to English
+first and Korean second — so a Japanese or Chinese screen degrades to English, not to Korean —
+and `/lang` prints exactly how many strings are covered.
 
 What the model reads follows the same switch. Set it to English and the rules, the mode
 instructions, and the tool descriptions all go out in English — so the model answers you in
@@ -379,6 +383,7 @@ Names follow Claude Code / Codex conventions.
 | `/learned [clear]` | What deel has picked up on its own — commands that work here, this model's habits |
 | `/pin <text>` | Pin a line — folding and compaction **cannot reach it** |
 | `/evidence [file]` | Evidence — what changed, and what proves it. **What is unproven is listed too** |
+| `/commit [all\|preview\|title]` | Commits only what this session changed; message from the diff and the evidence. **Never pushes** |
 | `/model` | Switch connection / model |
 | `/model 카드` | Model card — what this model has actually done here, and what deel changed because of it |
 | `/think <level>` | Reasoning level (`off·low·medium·high·max`) |
@@ -421,10 +426,11 @@ the conversation.
 | `Ctrl+O` | Work mode (`종합` → `코드` → `계획` → …) |
 | `↑` `↓` | Input history |
 | `Ctrl+C` | Stops the answer in progress; twice on an empty line quits |
+| Typing while it works, then `Enter` | Steers without throwing anything away — takes effect from the next step |
 
 Korean IME composition, paste, `Ctrl+A/E` and backspace all keep working.
 
-> **More** — Attaching a file with @ · Interrupting
+> **More** — Attaching a file with @ · Interrupting · Steering without stopping
 >
 > **[The screen read →](docs/en/interface.md#slash-commands)**
 
@@ -493,7 +499,7 @@ Names and arguments match Claude Code, so skills written for that convention wor
 
 | Tool | What it does |
 |---|---|
-| `Read` | Read a file (line numbers, `offset`/`limit`, **Excel as CSV, hwpx/docx/pptx as text**) |
+| `Read` | Read a file (line numbers, `offset`/`limit`, **Excel as CSV, hwpx/docx/pptx and PDF as text**) |
 | `Write` | Write / overwrite a file (**several at once via the `files` array**) |
 | `Append` | Append to the end of a file — **how large files get written in pieces** |
 | `Edit` | Replace an exact string (`replace_all`; **several sites at once via the `edits` array**) |
@@ -530,7 +536,12 @@ 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.
 
-> **More** — Encoding · Excel
+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
 >
 > **[Korean documents and Excel read →](docs/en/documents.md#korean-text-and-excel)**
 
@@ -767,6 +778,7 @@ stdio. It is not a command you type yourself.
 | 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) |
 | 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` |
 
 **Still zero dependencies.** Same reason as MCP — newline-delimited JSON-RPC 2.0 is the whole
 transport, so no SDK is needed.
@@ -918,13 +930,15 @@ Stored in `~/.deel/config.json`. A `.deel/config.json` in the project folder tak
 | `address not found` | Typo, DNS, VPN / intranet connectivity |
 | `connection refused` | Server is down or the port differs |
 | certificate error | `set NODE_EXTRA_CA_CERTS=C:\path\corp-ca.pem` |
-| behind a proxy | `set HTTPS_PROXY=http://proxy:port` |
+| behind a proxy | `set HTTPS_PROXY=http://proxy:port` (with auth: `http://user:pw@proxy:port`). If the first screen and `/status` show `proxy …`, it is in use. Exclude hosts with `NO_PROXY=.corp.com,10.1.2.3`; turn it off entirely with `"proxy": "none"` in the config |
+| the proxy answers 407 | Put `user:pw@` into the proxy address. Proxies that only accept NTLM · Negotiate are not supported — ask the admin for Basic or an unauthenticated address |
 | 401 / 403 | Wrong key or auth header style (four are tried automatically) |
 | `address not permitted` | The lock did its job — pick a connection with `/model` |
 | Tool calls don't work | Run `deel diagnose`. Small models (1B–3B) often can't |
 | Empty replies | The server ignores streaming. deel retries once, then turns streaming off for the session |
 | Large files cut off mid-write | Check `/out` and raise it — the cap may be sitting at the 16,384 default because it could not be discovered |
 | Only `HTTP 400` shows | The server's own message is shown verbatim. If it is a length problem the number is read and applied automatically |
+| `429` · `503` shows | The gateway pushed back for a moment. deel waits and calls again, up to three times (honouring `Retry-After`). If it keeps happening, check your quota |
 | `deel scan` finds nothing | Server is off or on another port — use `--ports` |
 
 ---
@@ -932,7 +946,7 @@ Stored in `~/.deel/config.json`. A `.deel/config.json` in the project folder tak
 ## Development
 
 ```bash
-npm test          Full suite (3,869 checks)
+npm test          Full suite (4,932 checks)
 npm run coverage  Which lines the tests actually execute
 npm run verify    Import + network checks only
 npm run bench     Edit success rate
@@ -957,7 +971,7 @@ so one run tells you everything.
 | `guard` | 24 | **What it refuses to do** — denied edits, unknown tools, repeated mutations, out-of-scope writes |
 | `network` | 30 | Nothing escapes the configured address |
 | `web` | 25 | Web reads stay read-only |
-| `abort` | 16 | Ctrl+C leaves the conversation valid |
+| `abort` · `steer` | 16 · 15 | Ctrl+C leaves the conversation valid · a line typed mid-turn rides the next call |
 | `parallel` | 23 | Read-only tools run together; checklists |
 | `cli` | 75 | **Spawns the real `deel`** and drives it to completion |
 | `setup` | 42 | First-run wizard, driven through a fake TTY |
@@ -984,6 +998,8 @@ so one run tells you everything.
 
 | Version | What changed |
 |---|---|
+| **[1.6.1](docs/en/releases.md#161)** | The places that made a turn spin in circles — the fence blocking `/dev/null` · old documents it could not read · images vanishing from files |
+| **[1.6.0](docs/en/releases.md#160)** | The things that did not work on a corporate network — proxy · 429 · Windows shell · 50k-file repos · PDF · clipboard paste · editor resume |
 | **[1.5.8](docs/en/releases.md#158)** | A 5MB document showed 8 lines out of 919 · a regex read as a path blocked the command |
 | **[1.5.7](docs/en/releases.md#157)** | Korean folders on macOS made your own files "out of scope" · paste · ESC |
 | **[1.5.6](docs/en/releases.md#156)** | It asks when stuck — instead of writing a question and ending the turn |

package/README.md

@@ -18,7 +18,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-3%2C869%20passing-1a7f37?logo=checkmarx&logoColor=white)](docs/ko/develop.md)
+[![tests](https://img.shields.io/badge/tests-4%2C932%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)
@@ -96,12 +96,12 @@
 | [모델 다루기](docs/ko/models.md) | 급과 창 크기 · 국산 모델 이름표 · 켤 때 프로젝트 읽기 |
 | [화면과 조작](docs/ko/interface.md) | 입력칸 · 작업 모드 · 쉬움과 개발자 · 무엇을 묻고 무엇을 그냥 하나 |
 | [도구 자세히](docs/ko/tools.md) | `Outline` · `Verify` · `Task` · `Jobs` · `Append` · `Def`/`Refs` · 편집 매칭 |
-| [한글 문서와 엑셀](docs/ko/documents.md) | hwpx·docx·pptx · 인코딩 · 엑셀 → CSV |
+| [한글 문서와 엑셀](docs/ko/documents.md) | hwpx·docx·pptx·**PDF** · 인코딩 · 엑셀 → CSV |
 | [늘려 쓰기](docs/ko/extend.md) | 스킬 · 플러그인 · MCP · ACP |
 | [속도와 씀씀이](docs/ko/tuning.md) | 단계별 추론 강도 · 프리픽스 캐시 · 컨텍스트 길이 |
 | [안전망과 사내 반입](docs/ko/safety.md) | 되돌리기 · 작업 범위 · 감사기록 · 심사 서류 |
 | [설정](docs/ko/config.md) · [개발](docs/ko/develop.md) | 환경변수 · 실행 옵션 · 검사 돌리기 · 폴더 구조 |
-| [릴리스 노트](docs/ko/releases.md) | [1.5.8](docs/ko/releases.md#158) · [1.5.7](docs/ko/releases.md#157) · [1.5.6](docs/ko/releases.md#156) · [1.5.5](docs/ko/releases.md#155) · [1.5.4](docs/ko/releases.md#154) · [1.5.3](docs/ko/releases.md#153) · [1.5.2](docs/ko/releases.md#152) · [1.5.1](docs/ko/releases.md#151) · [1.5.0](docs/ko/releases.md#150) · [1.4.3](docs/ko/releases.md#143) · [1.4.2](docs/ko/releases.md#142) · [1.4.1](docs/ko/releases.md#141) · [1.4.0](docs/ko/releases.md#140) · [1.3.0](docs/ko/releases.md#130) · [1.2.0](docs/ko/releases.md#120) |
+| [릴리스 노트](docs/ko/releases.md) | [1.6.1](docs/ko/releases.md#161) · [1.6.0](docs/ko/releases.md#160) · [1.5.8](docs/ko/releases.md#158) · [1.5.7](docs/ko/releases.md#157) · [1.5.6](docs/ko/releases.md#156) · [1.5.5](docs/ko/releases.md#155) · [1.5.4](docs/ko/releases.md#154) · [1.5.3](docs/ko/releases.md#153) · [1.5.2](docs/ko/releases.md#152) · [1.5.1](docs/ko/releases.md#151) · [1.5.0](docs/ko/releases.md#150) · [1.4.3](docs/ko/releases.md#143) · [1.4.2](docs/ko/releases.md#142) · [1.4.1](docs/ko/releases.md#141) · [1.4.0](docs/ko/releases.md#140) · [1.3.0](docs/ko/releases.md#130) · [1.2.0](docs/ko/releases.md#120) |
 
 ---
 
@@ -342,7 +342,7 @@ LM Studio 는 `/api/v0/models`, llama.cpp 는 `/props`. 못 알아보면 `(추
 |---|---|
 | `/help` | 명령 목록 |
 | `/bell [on|off]` | 다 됐을 때·물어볼 때 종소리와 창 제목 |
-| `/lang [ko|en] [시킬말]` | 화면 말. **시킬 말을 따로 줄 수 있다** — `/lang ko en` 이면 모델에게는 영어로 시키고 답은 한국어로 받는다(8k 창에서 고정 몫 23% 감소). 코드는 그대로 |
+| `/lang [ko|en|ja|zh] [시킬말]` | 화면 말 (한국어·English·日本語·中文 네 가지, 전부 다 채워져 있다). **시킬 말을 따로 줄 수 있다** — `/lang ko en` 이면 모델에게는 영어로 시키고 답은 한국어로 받는다(8k 창에서 고정 몫 23% 감소). 코드는 그대로 |
 | `/keys` | 이 터미널이 무슨 키를 보내는지 눌러서 확인 — 줄바꿈이 안 될 때 |
 | `/consult <프로필> <질문>` | 다른 모델에게 한 번 물어보기 — 지금 쓰는 것은 안 바꿈 |
 | `/export` | 이 대화를 **보고서 한 장**(HTML)으로 — 시킨 것·바뀐 것·확인한 것. 폐쇄망에서 여는 자기완결 파일 |
@@ -357,6 +357,7 @@ LM Studio 는 `/api/v0/models`, llama.cpp 는 `/props`. 못 알아보면 `(추
 | `/learned [지우기]` | 쓰면서 저절로 알게 된 것 — 되는 명령·이 모델의 버릇 |
 | `/pin <말>` | 못 박기 — 접거나 요약해도 **안 지워지는** 말 |
 | `/evidence [파일]` | 증거 — 무엇을 바꿨고 무엇이 그걸 증명하나. **안 된 것도** 적습니다 |
+| `/commit [전부\|미리보기\|제목]` | 이번 대화가 바꾼 것만 담아 커밋. 메시지는 diff 와 증거에서. **push 는 안 합니다** |
 | `/model` | 연결·모델 바꾸기 |
 | `/model 카드` | 이 모델을 겪어 본 결과 — 그래서 deel 이 무엇을 바꿔 뒀는지 |
 | `/think <강도>` | 추론 강도 (`off·low·medium·high·max`) |
@@ -396,10 +397,11 @@ LM Studio 는 `/api/v0/models`, llama.cpp 는 `/props`. 못 알아보면 `(추
 | `Ctrl+O` | 작업 모드 (`종합` → `코드` → `계획` → …) |
 | `↑` `↓` | 지난 입력 이력 |
 | `Ctrl+C` | 답하는 중이면 그 답만 끊고, 빈 줄에서 두 번이면 끝냅니다 |
+| 일하는 중에 그냥 치고 `Enter` | 하던 일을 안 버리고 방향만 틉니다 — 다음 걸음부터 반영 |
 
 한글 조합·붙여넣기·`Ctrl+A/E`·백스페이스는 전부 그대로 됩니다.
 
-> **자세히** — @파일 로 바로 붙이기 · 도중에 멈추기
+> **자세히** — @파일 로 바로 붙이기 · 도중에 멈추기 · 멈추지 않고 방향만 틀기
 >
 > **[화면과 조작 읽기 →](docs/ko/interface.md#대화-중-명령)**
 
@@ -468,7 +470,7 @@ LM Studio 는 `/api/v0/models`, llama.cpp 는 `/props`. 못 알아보면 `(추
 
 | 도구 | 하는 일 |
 |---|---|
-| `Read` | 파일 읽기 (줄 번호 · `offset`/`limit` 지원 · **엑셀은 CSV 로, hwpx·docx·pptx 는 글로 바꿔서**) |
+| `Read` | 파일 읽기 (줄 번호 · `offset`/`limit` 지원 · **엑셀은 CSV 로, hwpx·docx·pptx·PDF 는 글로 바꿔서**) |
 | `Write` | 파일 쓰기·덮어쓰기 (**여러 개는 `files` 배열로 한 번에**) |
 | `Append` | 파일 끝에 이어 붙이기 — **큰 파일을 나눠 쓰는 자리** |
 | `Edit` | 정확한 문자열 바꾸기 (`replace_all` · **여러 군데는 `edits` 배열로 한 번에**) |
@@ -504,10 +506,19 @@ Claude Code 에 없는 것은 아홉입니다 — `Append` · `Move` · `Ask` ·
 ## 한글 문서와 엑셀
 
 **CP949 로 저장된 파일은 CP949 로 되돌려 씁니다.** 인코딩을 바꾸지 않습니다.
-엑셀(`.xlsx`)은 CSV 로, 한글·워드·파워포인트(`.hwpx`/`.docx`/`.pptx`)는 글로
-바꿔서 읽습니다 — 전부 읽기 전용입니다.
+엑셀(`.xlsx`)은 CSV 로, 한글·워드·파워포인트(`.hwpx`/`.docx`/`.pptx`)와
+**PDF** 는 글로 바꿔서 읽습니다 — 전부 읽기 전용입니다.
 
-> **자세히** — 인코딩 · 엑셀 · hwpx/docx/pptx
+PDF 는 **못 읽은 쪽을 못 읽었다고 말합니다.** 스캔본·암호·글꼴 표가 없는 쪽은
+빈 글로 넘기지 않고 그 자리에 까닭을 적습니다 — 빈 글은 「그런 내용이 없다」로
+읽히기 때문입니다.
+
+옛 형식(`.ppt`·`.doc`·`.xls`·`.rtf`)은 **이 PC 에 깔린 LibreOffice 를 빌려서**
+읽습니다 — `rg` 를 빌려 쓰는 것과 같은 원칙으로, 아무것도 설치하지 않습니다.
+없으면 **없다고 못 박고 끝냅니다**(무엇이 없어서 못 하는지, 무엇을 하면 되는지,
+그리고 「다시 열지 말라」까지). 끄려면 `DEEL_CONVERT=off`.
+
+> **자세히** — 인코딩 · 엑셀 · hwpx/docx/pptx · PDF · 변환기 빌려 쓰기
 >
 > **[한글 문서와 엑셀 읽기 →](docs/ko/documents.md#한글-문서와-엑셀)**
 
@@ -742,6 +753,7 @@ deel acp
 | 승인 창 | deel 의 안전망이 그대로 에디터 창으로 뜹니다 (`이번만` · `앞으로 묻지 않기` · `안 함`) |
 | 모드 고르개 | deel 의 작업 모드 7개 (`종합` · `코드` · `계획` · `설계` · `디버그` · `묻기` · `총괄`) |
 | 멈춤 단추 | 도중에 닿습니다 — 답을 기다리는 중에도 |
+| 지난 대화 | 껐다 켜도 그대로 열립니다. 터미널과 **같은 자리**에 남아서, 에디터에서 하던 것을 `deel --resume` 으로 이어받는 것도 됩니다 |
 
 **의존성은 그대로 0 입니다.** MCP 와 같은 이유입니다 — 줄 단위 JSON-RPC 2.0 이
 전부라 SDK 가 필요 없습니다.
@@ -896,13 +908,15 @@ deel sbom --only sbom         # SBOM 한 장만
 | `주소를 찾을 수 없습니다` | 주소 오타, DNS, 사내망 접속 여부 |
 | `연결이 거부되었습니다` | 서버가 꺼져 있거나 포트가 다름 |
 | `인증서 문제` | `set NODE_EXTRA_CA_CERTS=C:\경로\사내CA.pem` |
-| 프록시를 거쳐야 함 | `set HTTPS_PROXY=http://프록시:포트` |
+| 프록시를 거쳐야 함 | `set HTTPS_PROXY=http://프록시:포트` (인증은 `http://user:pw@프록시:포트`). 첫 화면과 `/status` 에 `프록시 …` 가 뜨면 거치는 것. 안 거칠 곳은 `NO_PROXY=.corp.com,10.1.2.3`, 아예 끄려면 설정에 `"proxy": "none"` |
+| 프록시가 407 을 줌 | 프록시 주소에 `user:pw@` 를 넣으세요. NTLM · Negotiate 만 받는 프록시는 못 씁니다 — 담당자에게 Basic 이나 인증 없는 주소를 문의 |
 | 401 / 403 | 키가 틀렸거나 인증 헤더 형식이 다름 (4가지를 자동 시도합니다) |
 | `허용되지 않은 주소입니다` | 자물쇠가 막은 것. 정상입니다 — `/model` 로 연결을 고르세요 |
 | 도구 호출이 안 먹음 | `deel diagnose` 로 판정을 보세요. 작은 모델(1B~3B)은 자주 못 합니다 |
 | 대답이 비어 있음 | 스트리밍을 무시하는 서버입니다. 한 번은 저절로 다시 부르고, 그래도 비면 이 대화에서는 스트리밍을 끕니다 |
 | 큰 파일이 중간에 끊김 | `/out` 으로 지금 상한을 보고 올리세요. 상한을 몰라 16,384 로 서 있을 수 있습니다 |
 | `HTTP 400` 만 뜸 | 서버가 보낸 문장을 그대로 보여 줍니다. 길이 문제면 숫자를 읽어 저절로 맞춥니다 |
+| `429` · `503` 이 뜸 | 게이트웨이가 잠깐 막은 것입니다. 세 번까지 저절로 기다렸다 다시 부릅니다(`Retry-After` 를 지킵니다). 그래도 계속 뜨면 할당량을 보세요 |
 | `deel scan` 이 0곳 | 로컬 서버가 꺼져 있거나 다른 포트 — `--ports` 로 지정 |
 
 ---
@@ -910,7 +924,7 @@ deel sbom --only sbom         # SBOM 한 장만
 ## 개발
 
 ```bash
-npm test          전체 검증 (3,869항목)
+npm test          전체 검증 (4,932항목)
 npm run coverage  검사가 소스의 어디를 밟았는지
 npm run verify    반입·통신 검증만
 npm run bench     편집 성공률 측정
@@ -948,7 +962,7 @@ zip 은 진짜 `unzip` 으로, tar 는 진짜 `tar` 가 만든 것을 읽혀 교
 | `guard` | 24 | **안 하는 자리** — 거부·모르는 도구·두 번 실행·범위 밖 |
 | `network` | 30 | 정해진 자리 밖으로 새지 않는가 |
 | `web` | 25 | 웹 읽기가 읽기만 하는가 |
-| `abort` | 16 | Ctrl+C 로 끊어도 대화가 성한가 |
+| `abort` · `steer` | 16 · 15 | Ctrl+C 로 끊어도 대화가 성한가 · 도중에 낀 말이 다음 부름에 실리는가 |
 | `parallel` | 23 | 읽기만 동시에 도는가 · 할 일 목록 |
 | `cli` | 75 | **진짜 `deel` 을 띄워** 끝까지 돌려 본다 |
 | `setup` | 42 | 첫 실행 마법사 (가짜 TTY 로 사람처럼 입력) |
@@ -975,6 +989,8 @@ zip 은 진짜 `unzip` 으로, tar 는 진짜 `tar` 가 만든 것을 읽혀 교
 
 | 판 | 무엇이 바뀌었나 |
 |---|---|
+| **[1.6.1](docs/ko/releases.md#161)** | 헛도는 턴을 만들던 자리들 — 울타리가 `/dev/null` 까지 막던 것 · 옷 문서를 못 읽던 것 · 파일에서 그림이 사라지던 것 |
+| **[1.6.0](docs/ko/releases.md#160)** | 사내망에서 안 되던 것들 — 프록시 · 429 · 윈도우 셸 · 5만 개 저장소 · PDF · 캡처 붙여넣기 · 에디터 이어하기 |
 | **[1.5.8](docs/ko/releases.md#158)** | 5MB 문서를 919줄 중 8줄만 보던 것 · 정규식을 경로로 읽어 명령을 막던 것 |
 | **[1.5.7](docs/ko/releases.md#157)** | 맥 한글 폴더에서 제 파일이 「범위 밖」이던 것 · 붙여넣기 · ESC |
 | **[1.5.6](docs/ko/releases.md#156)** | 막히면 물어본다 — 글로 묻고 턴을 끝내는 대신에 |

package/bin/deel.js

@@ -13,6 +13,7 @@ import { closeConnections } from '../src/backend/http.js';
 import { parseSize } from '../src/backend/ctxsize.js';
 import { runSessions } from '../src/agent/sessionui.js';
 import { acp } from '../src/acp/serve.js';
+import { runCompletion } from '../src/completion.js';
 
 const MIN_NODE = 20;
 
@@ -137,6 +138,7 @@ function help() {
   say(`    ${c.cyan('deel setup')}                  연결 설정 (주소·키·모델)`);
   say(`    ${c.cyan('deel status')}                 연결 상태 보기`);
   say(`    ${c.cyan('deel diagnose')}               저장된 연결로 진단 다시 돌리기`);
+  say(`    ${c.cyan('deel completion <셸>')}        탭 완성 스크립트 ${c.gray('(bash · zsh · powershell)')}`);
   say(`    ${c.cyan('deel --version')}              판 번호 ${c.gray('(-v 도 됩니다)')}`);
   say('');
   say(`  ${c.bold('여러 로컬을 같이 쓸 때')}`);
@@ -298,6 +300,14 @@ async function main() {
     case 'sessions':
     case 'ls':
       return runSessions(flags);
+    /*
+     * 탭 완성 스크립트를 낸다 (src/completion.js).
+     *
+     * 표준출력으로만 낸다 — `deel completion bash > ~/.deel-completion.bash`
+     * 처럼 바로 파이프에 물릴 수 있어야 한다. 그래서 여기서는 say() 를 안 쓴다.
+     */
+    case 'completion':
+      return runCompletion(args);
     default:
       say('');
       say(`  ${c.red('모르는 명령')} ${c.bold(cmd)}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deel-local-cli",
-  "version": "1.5.8",
+  "version": "1.6.1",
   "description": "로컬 모델·사내 게이트웨이 전용 코딩 에이전트 CLI — 외부 의존성 0개 / Zero-dependency coding agent CLI for local LLMs and private gateways",
   "type": "module",
   "license": "MIT",
@@ -51,7 +51,7 @@
     "verify": "node test/no-bundle.test.js && node test/network.test.js && node test/web.test.js",
     "bench": "node test/edit-bench.js",
     "demo": "node test/demo.js",
-    "check": "node --check bin/deel.js && node --check src/repl.js && node --check src/oneshot.js && node --check src/commands.js && node --check src/agent/loop.js && node --check src/agent/session.js && node --check src/agent/effort.js && node --check src/agent/modes.js && node --check src/agent/route.js && node --check src/agent/models.js && node --check src/agent/grade.js && node --check src/agent/mention.js && node --check src/agent/project.js && node --check src/tools/encoding.js && node --check src/tools/excel-com.js && node --check src/tools/excel.js && node --check src/tools/xlsx.js && node --check src/tools/docs.js && node --check src/agent/compact.js && node --check src/agent/store.js && node --check src/agent/sessionui.js && node --check src/backend/adapter.js && node --check src/backend/ctxsize.js && node --check src/backend/probe.js && node --check src/backend/detect.js && node --check src/backend/http.js && node --check src/backend/scan.js && node --check src/backend/scanui.js && node --check src/tools/index.js && node --check src/tools/desc.en.js && node --check src/tools/lsp.js && node --check src/lsp/rpc.js && node --check src/lsp/servers.js && node --check src/lsp/client.js && node --check src/lsp/diag.js && node --check src/tools/fsutil.js && node --check src/tools/edit-match.js && node --check src/tools/webfetch.js && node --check src/tools/todo.js && node --check src/tools/jobs.js && node --check src/skills/discover.js && node --check src/plugins/manage.js && node --check src/pack/zip.js && node --check src/pack/tar.js && node --check src/pack/selfpack.js && node --check src/safety/guard.js && node --check src/safety/undo.js && node --check src/safety/audit.js && node --check src/safety/network.js && node --check src/setup.js && node --check src/report.js && node --check src/config.js && node --check src/ui/diff.js && node --check src/ui/ansi.js && node --check src/ui/status.js && node --check src/ui/level.js && node --check src/ui/prompt.js && node --check src/ui/spinner.js && node --check src/ui/motion.js && node --check src/ui/office.js && node --check src/ui/notify.js && node --check src/ui/intro.js && node --check src/ui/banner.js && node --check src/ui/export.js && node --check src/i18n/index.js && node --check src/i18n/ko.js && node --check src/i18n/en.js && node --check src/preview/serve.js && node --check src/ui/working.js && node --check src/ui/inputbox.js && node --check src/ui/wrap.js && node --check src/ui/md.js && node --check src/agent/threads.js && node --check src/agent/evolve.js && node --check src/agent/pins.js && node --check src/agent/card.js && node --check src/agent/preset.js && node --check src/agent/evidence.js && node --check src/acp/jsonrpc.js && node --check src/acp/map.js && node --check src/acp/serve.js && node --check src/pack/sbom.js && node --check src/safety/secrets.js && echo OK",
+    "check": "node --check bin/deel.js && node --check src/repl.js && node --check src/oneshot.js && node --check src/commands.js && node --check src/agent/loop.js && node --check src/agent/session.js && node --check src/agent/effort.js && node --check src/agent/modes.js && node --check src/agent/route.js && node --check src/agent/models.js && node --check src/agent/grade.js && node --check src/agent/mention.js && node --check src/agent/project.js && node --check src/tools/encoding.js && node --check src/tools/excel-com.js && node --check src/tools/excel.js && node --check src/tools/xlsx.js && node --check src/tools/docs.js && node --check src/tools/convert.js && node --check src/tools/pdf.js && node --check src/tools/clipboard.js && node --check src/agent/compact.js && node --check src/agent/store.js && node --check src/agent/sessionui.js && node --check src/backend/adapter.js && node --check src/backend/ctxsize.js && node --check src/backend/probe.js && node --check src/backend/detect.js && node --check src/backend/http.js && node --check src/backend/retry.js && node --check src/backend/proxy.js && node --check src/backend/azure.js && node --check src/backend/vision.js && node --check src/backend/quota.js && node --check src/backend/scan.js && node --check src/backend/scanui.js && node --check src/tools/index.js && node --check src/tools/desc.en.js && node --check src/tools/lsp.js && node --check src/lsp/rpc.js && node --check src/lsp/servers.js && node --check src/lsp/client.js && node --check src/lsp/diag.js && node --check src/tools/fsutil.js && node --check src/tools/ignore.js && node --check src/tools/fastgrep.js && node --check src/tools/edit-match.js && node --check src/tools/webfetch.js && node --check src/tools/todo.js && node --check src/tools/jobs.js && node --check src/tools/shell.js && node --check src/skills/discover.js && node --check src/plugins/manage.js && node --check src/pack/zip.js && node --check src/pack/tar.js && node --check src/pack/selfpack.js && node --check src/safety/guard.js && node --check src/safety/undo.js && node --check src/safety/audit.js && node --check src/safety/keystore.js && node --check src/safety/policy.js && node --check src/safety/network.js && node --check src/setup.js && node --check src/report.js && node --check src/config.js && node --check src/completion.js && node --check src/ui/diff.js && node --check src/ui/ansi.js && node --check src/ui/status.js && node --check src/ui/level.js && node --check src/ui/prompt.js && node --check src/ui/spinner.js && node --check src/ui/motion.js && node --check src/ui/office.js && node --check src/ui/notify.js && node --check src/ui/intro.js && node --check src/ui/banner.js && node --check src/ui/export.js && node --check src/i18n/index.js && node --check src/i18n/ko.js && node --check src/i18n/en.js && node --check src/i18n/ja.js && node --check src/i18n/zh.js && node --check src/preview/serve.js && node --check src/ui/working.js && node --check src/ui/inputbox.js && node --check src/ui/wrap.js && node --check src/ui/md.js && node --check src/agent/threads.js && node --check src/agent/evolve.js && node --check src/agent/pins.js && node --check src/agent/card.js && node --check src/agent/preset.js && node --check src/agent/evidence.js && node --check src/agent/commit.js && node --check src/agent/review.js && node --check src/acp/jsonrpc.js && node --check src/acp/map.js && node --check src/acp/serve.js && node --check src/pack/sbom.js && node --check src/safety/secrets.js && echo OK",
     "coverage": "node test/coverage.mjs",
     "prepublishOnly": "npm run check && npm test"
   },

package/src/acp/map.js

@@ -175,6 +175,149 @@ export function 멈춘까닭(까닭) {
   }
 }
 
+/**
+ * 메시지 하나에서 사람이 읽을 글만 뽑는다.
+ *
+ * content 는 글 한 덩어리일 때도 있고, 그림이 섞인 배열일 때도 있다
+ * (backend/vision.js). 배열에서 글만 빼고 그림은 조용히 버리면, 되살린
+ * 화면에서 "이 말을 왜 했는지" 가 사라진다 — 몇 장이 붙어 있었는지는 적는다.
+ */
+function 글만(m) {
+  const c = m?.content;
+  let 글 = '';
+  let 장수 = Array.isArray(m?.images) ? m.images.length : 0;   // ollama 규격
+  if (typeof c === 'string') 글 = c;
+  else if (Array.isArray(c)) {
+    const 조각 = [];
+    for (const p of c) {
+      if (p?.type === 'text' && typeof p.text === 'string') 조각.push(p.text);
+      else if (p?.type === 'image_url') 장수++;
+    }
+    글 = 조각.join('\n');
+  }
+  글 = 글.trim();
+  if (장수) 글 = 글 ? `${글}\n\n_(그림 ${장수}장)_` : `_(그림 ${장수}장)_`;
+  return 글;
+}
+
+/** 저장된 도구 인자. 규격에 따라 글일 수도, 이미 풀린 것일 수도 있다. */
+function 인자풀기(x) {
+  if (x && typeof x === 'object') return x;
+  if (typeof x !== 'string' || !x.trim()) return {};
+  try { return JSON.parse(x); } catch { return {}; }
+}
+
+/**
+ * 저장된 대화를 에디터에 다시 흘려 줄 알림 묶음으로.
+ *
+ * ── 왜 이 자리가 필요한가 ───────────────────────────────────────────────
+ *
+ * session/load 는 "지난 대화를 되살려라" 는 부름인데, 규격에는 되살린 것을
+ * **답으로 돌려주는 자리가 없다.** 오간 말을 전부 session/update 로 다시
+ * 흘려야 한다. 그러니까 에디터가 그리는 지난 대화는 여기서 만든 것이 전부다 —
+ * 여기서 빠뜨린 것은 화면에서 통째로 사라지고, 사람은 기록이 날아간 줄 안다.
+ *
+ * 도구 호출은 시작·끝 두 번으로 안 나눈다. 이미 끝난 일을 '도는 중' 으로 한 번
+ * 그렸다가 고칠 까닭이 없다. 끝난 모습 한 덩이만 준다.
+ *
+ * @param {object[]} messages  store.js 가 읽어 온 대화
+ * @returns {object[]} session/update 의 update 자리에 그대로 넣을 것들
+ */
+export function 되살린것(messages, { 최대내용 = 2000 } = {}) {
+  const 줄 = Array.isArray(messages) ? messages : [];
+
+  /*
+   * 도구 답을 먼저 줄 세운다.
+   *
+   * 답(role:'tool')은 부름보다 뒤에 온다. 앞에서부터 한 번에 그리려면 미리
+   * 찾아 둬야 한다. OpenAI 규격은 id 로 짝을 짓고, ollama 규격은 id 를 안 주므로
+   * 이름별 차례로 짝을 짓는다 (session.js 의 repairToolPairs 와 같은 눈).
+   */
+  const id로 = new Map();
+  const 이름으로 = new Map();
+  for (const m of 줄) {
+    if (m?.role !== 'tool') continue;
+    if (m.tool_call_id != null) id로.set(m.tool_call_id, m.content);
+    else if (m.tool_name) {
+      const q = 이름으로.get(m.tool_name) ?? [];
+      q.push(m.content);
+      이름으로.set(m.tool_name, q);
+    }
+  }
+
+  const 나온것 = [];
+  let 말번호 = 0;
+  let 도구번호 = 0;
+
+  for (const m of 줄) {
+    if (!m || typeof m !== 'object') continue;
+    // 시스템 프롬프트는 사람이 한 말이 아니다. 되살리면 매번 대화 머리에
+    // 수천 자짜리 지시문이 붙어서, 정작 무슨 얘기를 했는지가 안 보인다.
+    if (m.role === 'system' || m.role === 'tool') continue;
+
+    if (m.role === 'user') {
+      const 글 = 글만(m);
+      if (글) 나온것.push({ sessionUpdate: 'user_message_chunk', content: { type: 'text', text: 글 } });
+      continue;
+    }
+    if (m.role !== 'assistant') continue;
+
+    말번호++;
+    const 생각 = typeof m.thinking === 'string' ? m.thinking.trim() : '';
+    if (생각) {
+      나온것.push({
+        sessionUpdate: 'agent_thought_chunk',
+        content: { type: 'text', text: 자르기(생각, 최대내용) },
+        messageId: `h${말번호}`,
+      });
+    }
+    const 글 = 글만(m);
+    if (글) {
+      나온것.push({
+        sessionUpdate: 'agent_message_chunk',
+        content: { type: 'text', text: 글 },
+        messageId: `h${말번호}`,
+      });
+    }
+
+    for (const tc of Array.isArray(m.tool_calls) ? m.tool_calls : []) {
+      const fn = tc?.function ?? tc ?? {};
+      const 이름 = String(fn.name ?? tc?.name ?? '도구');
+      const 인자 = 인자풀기(fn.arguments ?? fn.args ?? tc?.args);
+
+      let 답;
+      if (tc?.id != null && id로.has(tc.id)) 답 = id로.get(tc.id);
+      else {
+        const q = 이름으로.get(이름);
+        if (q?.length) 답 = q.shift();
+      }
+
+      /*
+       * 답이 안 남은 부름 = 그때 프로그램이 도구 도는 중에 끊긴 것이다.
+       *
+       * 성공으로 그리면 안 된다. 그 도구가 끝까지 갔는지 아닌지가 다음에 무엇을
+       * 시킬지를 정한다 — 파일을 고치던 중이었을 수도 있다.
+       */
+      const 없음 = 답 === undefined || 답 === null;
+      나온것.push({
+        sessionUpdate: 'tool_call',
+        toolCallId: `h${말번호}-${++도구번호}`,
+        title: 도구이름표(이름, 인자),
+        kind: 도구갈래(이름),
+        // 남은 글만 보고 성공·실패를 점치지 않는다. 도구마다 실패를 적는 말이
+        // 달라서, 맞히려 들면 멀쩡한 것을 빨갛게 칠하게 된다.
+        status: 없음 ? 'failed' : 'completed',
+        content: 없음
+          ? [{ type: 'content', content: { type: 'text', text: '결과가 안 남았습니다 — 이 도구가 도는 중에 끊겼습니다.' } }]
+          : [{ type: 'content', content: { type: 'text', text: 자르기(String(답), 최대내용) } }],
+        locations: 도구자리(이름, 인자, null),
+      });
+    }
+  }
+
+  return 나온것;
+}
+
 /**
  * 프롬프트로 온 덩이들에서 글만 뽑는다.
  *