deel-local-cli 2.0.1 → 2.1.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-13%2C900%20passing-1a7f37?logo=checkmarx&logoColor=white)](docs/ko/develop.md)
+[![tests](https://img.shields.io/badge/tests-14%2C322%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)
@@ -127,6 +127,7 @@
 | [늘려 쓰기](docs/ko/extend.md) | 스킬 · 플러그인 · MCP · 에이전트 · 훅 · ACP |
 | [속도와 씀씀이](docs/ko/tuning.md) | 단계별 추론 강도 · 프리픽스 캐시 · 컨텍스트 길이 |
 | [안전망과 사내 반입](docs/ko/safety.md) | 되돌리기 · 작업 범위 · 감사기록 · 심사 서류 |
+| [사내 배포 안내](docs/ko/company.md) | 처음 쓰는 사람 · 관리 정책 한 장 · 어디로 나가나 · 막는 것의 한계 |
 | [설정](docs/ko/config.md) · [개발](docs/ko/develop.md) | 환경변수 · 실행 옵션 · 검사 돌리기 · 폴더 구조 |
 | [릴리스 노트](docs/ko/releases.md) | [1.16.x](docs/ko/releases/1.x.md#116x) · [1.15.x](docs/ko/releases/1.x.md#115x) · [1.14.x](docs/ko/releases/1.x.md#114x) · [1.13.x](docs/ko/releases/1.x.md#113x) · [1.12.x](docs/ko/releases/1.x.md#112x) · [1.10.x](docs/ko/releases/1.x.md#110x) · [1.9.x](docs/ko/releases/1.x.md#19x) · [그 앞](docs/ko/releases.md) |
 
@@ -243,6 +244,12 @@ Model Context Protocol 과 Agent Client Protocol 은 둘 다 표준입출력으
 npm install -g deel-local-cli
 ```
 
+이 명령은 옛 판이 깔려 있어도 늘 npm 의 최신 판을 받습니다. `npx` 로 쓸 때는 `@latest` 를 붙이세요 —
+전에 깔아 둔 deel 이 있으면 `npx deel-local-cli` 는 새로 받지 않고 **그걸** 실행합니다.
+`npx deel-local-cli@latest` 는 늘 최신을 받습니다. 지금 도는 판은 `deel --version` 으로 봅니다.
+`npm i -g` 로도 옛 판이 오면 `npm view deel-local-cli version` 을 보세요 — 사내 npm 미러는
+npmjs.org 보다 늦을 수 있습니다.
+
 설치가 싫으면 소스를 받아 그대로 쓰셔도 됩니다. `npm install` 이 필요 없습니다.
 
 ```bash
@@ -316,7 +323,7 @@ deel --offline
 무엇이 어디로 갈 수 있는지는 켤 때 화면 맨 위에 늘 적혀 있습니다.
 
 ```
- deel 2.0.1  ⌂ 이 안
+ deel 2.1.0  ⌂ 이 안
  보냄    이 컴퓨터 안 127.0.0.1:11434  ← 여기 말고는 어디로도 안 갑니다
 ```
 
@@ -1134,9 +1141,26 @@ AWS 키 · Google 키 · JWT · 주소에 박힌 열쇠 · `Authorization` 계
 
 | 모드 | 언제 물어보나 |
 |---|---|
-| `auto` (기본) | 안 물어봄. 되돌리기가 안전망 |
+| `auto` (기본) | 안 물어봄 — **맡기는 모드**. 되돌리기가 안전망. 모델이 되묻거나 계획부터 내도 60초 안에 답이 없으면 알아서 진행(`askWait`) |
 | `confirm` | 되돌릴 수 없는 명령만 |
-| `strict` | 파일 변경·명령 전부 |
+| `strict` | 파일 변경·명령 전부. **바뀔 내용(diff)을 먼저 보여 주고** 묻습니다 |
+
+회사에서 「바꾸기 전에 늘 사람이 본다」 를 정해야 하면 관리 정책에 `"approval": "strict"` 한 줄을
+적습니다. 그러면 `/mode` · Shift+Tab · `--yes` · 「앞으로 묻지 않기」 어느 것으로도 그 아래로 못
+내립니다 — [사내 배포 안내](docs/ko/company.md).
+
+**「다 됐다」 는 검사가 정합니다.** 설정에 `"check": "npm test"` 를 적거나 `deel run --check` 로 주면,
+모델이 무엇을 바꾸고 끝내려 할 때 deel 이 그 검사를 **직접** 돌립니다. 실패하면 출력을 돌려주고 이어서
+고치게 하고(기본 3판), 끝내 실패면 실패로 끝냅니다 — `deel run` 은 종료코드 8. 검사 명령도 모델의
+명령과 같은 관문(규칙·훅·승인·위험 명령 차단)을 지납니다 — [완료 검사](docs/ko/company.md#완료-검사).
+
+**얼마나 해내나는 골든셋으로 잽니다.** `deel eval --init` 이 예제 과제 다섯을 만들고, `deel eval` 이
+과제마다 임시 폴더에서 deel 을 돌린 뒤 **모델이 못 본** 정답 검사로 채점합니다. 결과를 남겨 두고
+지난번보다 나빠진 과제를 짚습니다 — [골든셋](docs/ko/company.md#골든셋).
+
+위험 명령 차단은 **금지 목록 방식**입니다. 목록에 없는 꼴은 새어 나갈 수 있고, 실제로 그렇게
+찾아 막아 온 기록이 릴리스 노트에 있습니다. 그래서 하나에 기대지 않고 겹쳐 씁니다 — 작업 범위,
+정책 금지 규칙, 승인, 되돌리기, 감사 로그.
 
 되돌리기 이력은 파일 내용을 통째로 담기 때문에 큰 파일을 여러 번 고치면 금방 커집니다.
 32MB 를 넘으면 **최근 50턴만 남기고** 오래된 것을 버립니다. 방금 한 일은 언제나
@@ -1240,7 +1264,7 @@ deel stats                    # 이 폴더에서 실제로 무엇을 했나 (.de
 ## 개발
 
 ```bash
-npm test          전체 검증 (13,941항목 — 몇몇은 터미널에 따라 갈립니다)
+npm test          전체 검증 (14,322항목 — 몇몇은 터미널에 따라 갈립니다)
 npm run coverage  검사가 소스의 어디를 밟았는지
 npm run verify    반입·통신 검증만
 npm run bench     편집 성공률 측정
@@ -1297,7 +1321,7 @@ zip 은 진짜 `unzip` 으로, tar 는 진짜 `tar` 가 만든 것을 읽혀 교
 | `exitcode` · `doorparity` | 7 · 19 | 화면에 적은 종료코드 표가 진짜인가 · 문 **네 개**가 같은 것을 주는가 |
 | `no-bundle` | 28 | 배포 묶음에 남의 것이 안 섞였는가 · 검사 파일 위생 |
 | `edit-bench` | 15건 | 편집 성공률 |
-| `mutate` | 어긋 1,662개 | **검사가 정말 지키는가** — 지켜야 할 줄을 일부러 어긋내고 빨개지는지 본다 |
+| `mutate` | 어긋 1,785개 | **검사가 정말 지키는가** — 지켜야 할 줄을 일부러 어긋내고 빨개지는지 본다 |
 
 > **자세히** — 어디를 밟았는지 · 폴더 구조
 >
@@ -1309,7 +1333,10 @@ zip 은 진짜 `unzip` 으로, tar 는 진짜 `tar` 가 만든 것을 읽혀 교
 
 | 판 | 무엇이 바뀌었나 |
 |---|---|
-| **[2.0.1](docs/ko/releases/2.0.md#201)** | 울타리 하나가 안 걸렸습니다 — `sudo -u root bash` 가 `curl … \| bash` 막이를 지나갔습니다 — 그리고 관문 넷이 빨개질 수 없었습니다 |
+| **[2.1.0](docs/ko/releases/2.1.md#210)** | 맡기면 멈추지 않고, 묻게 하면 diff 를 보여 줍니다 — 「다 됐다」 는 검사가 정합니다(`check`) · 얼마나 해내나는 골든셋으로 잽니다(`deel eval`) · 관리 정책 `"approval"` 로 회사가 승인 바닥을 겁니다 |
+| [2.0.3](docs/ko/releases/2.0.md#203) | 2.0.2 는 npm 에 못 나갔습니다 — 이제 GitHub 릴리스는 npm 에 올라간 뒤에만 생깁니다 |
+| [2.0.2](docs/ko/releases/2.0.md#202) | 2.0.1 까지 넘겨 둔 것을 다 잡았습니다 — `deel run` 에만 없던 MCP 도구, 끝난 명령의 번호로 가던 `taskkill`, 한 번 넘어지면 세션 내내 못 쓰던 MCP 서버 |
+| [2.0.1](docs/ko/releases/2.0.md#201) | 울타리 하나가 안 걸렸습니다 — `sudo -u root bash` 가 `curl … \| bash` 막이를 지나갔습니다 — 그리고 관문 넷이 빨개질 수 없었습니다 |
 | [2.0.0](docs/ko/releases/2.0.md#200) | 있다고 적힌 울타리마다 실제로 걸리는지 다시 봤습니다 — 바뀐 것 전부·어디를 어떻게 고쳤나·어떻게 찾았나(CHA) |
 
 <p align="center">

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-13%2C900%20passing-1a7f37?logo=checkmarx&logoColor=white)](docs/en/develop.md)
+[![tests](https://img.shields.io/badge/tests-14%2C322%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)
@@ -162,6 +162,7 @@ This page is the **summary**. Each section links to the detail behind it.
 | [Extending](docs/en/extend.md) | Skills · plugins · MCP · subagents · hooks · 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 |
+| [Rolling it out at work](docs/en/company.md) | First-time users · one policy file · where requests go · what the guards cannot do |
 | [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.16.x](docs/en/releases/1.x.md#116x) · [1.15.x](docs/en/releases/1.x.md#115x) · [1.14.x](docs/en/releases/1.x.md#114x) · [1.13.x](docs/en/releases/1.x.md#113x) · [1.12.x](docs/en/releases/1.x.md#112x) · [1.10.x](docs/en/releases/1.x.md#110x) · [1.9.x](docs/en/releases/1.x.md#19x) · [older](docs/en/releases.md) |
 
@@ -314,6 +315,12 @@ that sends `목적` instead of `purpose` still gets through.
 npm install -g deel-local-cli
 ```
 
+This always installs the newest version on npm, including over an older one. With `npx`, add `@latest`:
+if an older deel is already installed, `npx deel-local-cli` runs that one instead of fetching a new one —
+`npx deel-local-cli@latest` always gets the newest. `deel --version` shows what you are running.
+If `npm i -g` still brings an old version, check `npm view deel-local-cli version` — a company npm
+mirror can lag behind npmjs.org.
+
 Or skip installing entirely — there is no `npm install` step:
 
 ```bash
@@ -389,7 +396,7 @@ deel --offline
 The destination is printed at the top of every session:
 
 ```
- deel 2.0.1  ⌂ inside
+ deel 2.1.0  ⌂ inside
  Sends to this machine 127.0.0.1:11434  ← nowhere else
 ```
 
@@ -1236,9 +1243,27 @@ does not ask.
 
 | Mode | Asks when |
 |---|---|
-| `auto` (default) | Never — undo is the safety net |
+| `auto` (default) | Never — **the hand-off mode**; undo is the safety net. If the model asks a question or offers a plan first, it carries on by itself after 60 seconds with no answer (`askWait`) |
 | `confirm` | Irreversible commands only |
-| `strict` | All file changes and commands |
+| `strict` | All file changes and commands. **Shows the change (a diff) first**, then asks |
+
+If your organisation needs "a person sees every change before it lands", put `"approval": "strict"`
+in the managed policy. Then `/mode`, Shift+Tab, `--yes` and "don't ask again" all stop at that
+floor — see [Rolling it out at work](docs/en/company.md).
+
+**A check, not the model, says when it is done.** Put `"check": "npm test"` in the config or pass
+`deel run --check`, and when the model has changed something and tries to finish, deel runs that check
+**itself**. A failure goes back to the model to keep fixing (3 rounds by default); still failing ends as
+failed — `deel run` exits with 8. The check goes through the same gates as the model's own commands
+(rules, hooks, approval, the dangerous-command guard) — see [Completion check](docs/en/company.md#completion-check).
+
+**How much it gets done is measured with a golden set.** `deel eval --init` creates five example tasks,
+and `deel eval` runs deel on each one in a temp folder, then grades it with checks **the model never saw**.
+Results are kept, and tasks that got worse since last time are pointed out — see [Golden set](docs/en/company.md#golden-set).
+
+Blocked commands are a **deny list**. Shapes the list does not know can get through, and the
+release notes record the ones found and closed so far. So no single layer is relied on: working
+scope, policy deny rules, approval, undo and the audit log are stacked.
 
 Undo history stores whole file contents, so repeated edits to large files add up. Past 32MB
 it keeps the **most recent 50 turns** and drops the rest. What you just did is always
@@ -1334,7 +1359,7 @@ Stored in `~/.deel/config.json`. A `.deel/config.json` in the project folder tak
 ## Development
 
 ```bash
-npm test          Full suite (13,941 checks; a few are TTY-dependent)
+npm test          Full suite (14,322 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
@@ -1378,7 +1403,7 @@ so one run tells you everything.
 | `exitcode` · `doorparity` | 7 · 19 | The printed exit-code table is real · all **four** doors hand out the same thing |
 | `no-bundle` | 28 | Nothing foreign in the published package; test-file hygiene |
 | `edit-bench` | 15 cases | Edit success rate |
-| `mutate` | 1,662 mutants | **Whether the tests actually guard** — break the line on purpose, check it turns red |
+| `mutate` | 1,785 mutants | **Whether the tests actually guard** — break the line on purpose, check it turns red |
 
 > **More** — Coverage · Layout
 >
@@ -1390,7 +1415,10 @@ so one run tells you everything.
 
 | Version | What changed |
 |---|---|
-| **[2.0.1](docs/en/releases/2.0.md#201)** | One fence in 2.0.0 did not hold — `sudo -u root bash` walked through the `curl … \| bash` guard — and four gates could not go red |
+| **[2.1.0](docs/en/releases/2.1.md#210)** | Hand it off and it keeps going; make it ask and it shows the diff — a check decides when it is done (`check`), a golden set measures how much gets done (`deel eval`), and `"approval"` in the managed policy lets a company set an approval floor |
+| [2.0.3](docs/en/releases/2.0.md#203) | 2.0.2 never reached npm — GitHub releases now appear only after npm has the version |
+| [2.0.2](docs/en/releases/2.0.md#202) | Everything 2.0.1 left open, closed — MCP tools missing only from `deel run`, `taskkill` sent to an exited command's pid, MCP servers that stayed down for the session after one crash |
+| [2.0.1](docs/en/releases/2.0.md#201) | One fence in 2.0.0 did not hold — `sudo -u root bash` walked through the `curl … \| bash` guard — and four gates could not go red |
 | [2.0.0](docs/en/releases/2.0.md#200) | Every fence we said was there, checked for whether it actually holds — everything that changed, where and how it was fixed, and how it was found (CHA) |
 
 <p align="center">

package/bin/deel.js

@@ -23,6 +23,7 @@ import { 규칙모으기, 어떻게할까, 확인목록, 확인인자, 확인돌
 import { 기록자리, 세기, 도구차례, 막힘차례, 셈JSON } from '../src/stats.js';
 import { 진찰 } from '../src/doctor.js';
 import { 설명, 설명줄들 } from '../src/configexplain.js';
+import { runEval } from '../src/eval/run.js';
 
 const MIN_NODE = 20;
 
@@ -625,6 +626,8 @@ const BOOL = new Set([
   'hard',
   // trust --off · --list, scan --save · --pick. 여태 목록에 없어 뒤의 낱말을 삼킬 수 있었다.
   'off', 'list', 'save', 'pick',
+  // eval --init · --keep (src/eval/run.js).
+  'init', 'keep',
 ]);
 
 /*
@@ -646,6 +649,8 @@ const BOOL = new Set([
 const 값깃발 = new Set([
   'root', 'mode', 'work', 'level', 'ctx', 'max-tokens', 'think', 'effort', 'output-schema',
   'out', 'only', 'days', 'tool', 'url', 'key', 'model', 'host', 'ports', 'timeout', 'rm', 'delete',
+  // run --check <명령> (agent/donecheck.js) · eval --repeat <수> (src/eval/run.js).
+  'check', 'repeat',
 ]);
 // 값을 줘도 되고 안 줘도 되는 깃발. `--resume` 만 치면 이어 할 대화를 고른다.
 const 값골라깃발 = new Set(['resume']);
@@ -902,6 +907,8 @@ function help() {
   say(`    ${c.gray('--json')}             결과를 JSON 한 덩이로 (답·도구 횟수·토큰·끝난 까닭)`);
   say(`    ${c.gray('--quiet')}            도구가 무엇을 했는지 안 적음 (오류는 그래도 적음)`);
   say(`    ${c.gray('--yes')}              승인이 필요한 것도 그냥 실행. ${c.yellow('기본은 거부입니다')}`);
+  // 새로 넣는 도움말 줄은 말() 로 적는다 — 영어로 켠 사람에게 한국어 줄을 더 새게 하지 않는다(test/langleak.test.js 의 래칫).
+  say(`    ${c.gray('--check <cmd>')}       ${말('cli.checkFlag')}`);
   /*
    * 답의 모양을 못 박는 자리 (src/agent/outschema.js).
    *
@@ -914,7 +921,13 @@ function help() {
   // 이 줄은 src/oneshot.js 의 EXIT 와 짝이다. test/exitcode.test.js 가 둘이
   // 어긋나면 빨개진다 — 한 판 동안 refusal(6) 이 여기서 빠져 있었고, 그
   // 사실을 말해 주는 자리가 아무 데도 없었다.
-  say(`    ${c.gray('끝난 까닭이 종료코드에 담깁니다:')} ${c.gray('0 끝냄 · 1 오류 · 2 걸음수상한 · 3 헛돎 · 4 중단 · 5 말없이끊김 · 6 거절 · 7 모양안맞음 · 64 사용법틀림')}`);
+  say(`    ${c.gray('끝난 까닭이 종료코드에 담깁니다:')} ${c.gray('0 끝냄 · 1 오류 · 2 걸음수상한 · 3 헛돎 · 4 중단 · 5 말없이끊김 · 6 거절 · 7 모양안맞음 · 8 검사실패 · 64 사용법틀림')}`);
+  say('');
+  say(`  ${c.bold(말('cli.evalTitle'))} ${c.gray(말('cli.evalWhy'))}`);
+  say('');
+  say(`    ${c.cyan('deel eval --init')}            ${말('cli.evalInit')}`);
+  say(`    ${c.cyan('deel eval [dir]')}             ${말('cli.evalRun')}`);
+  say(`    ${c.gray('--repeat <n> · --only <name> · --keep · --json')}`);
   say('');
   say(`  ${c.bold('진단 직접 지정')} ${c.gray('— 설정을 남기지 않고 확인만 할 때')}`);
   say('');
@@ -1113,6 +1126,8 @@ async function main() {
         quiet: flags.quiet === true || flags.quiet === 'true',
         // 답의 모양을 못 박는다. 이게 있으면 표준출력은 그 JSON 하나다.
         outputSchema: flags['output-schema'] ? String(flags['output-schema']) : undefined,
+        // 끝내려는 자리에서 돌릴 검사 (agent/donecheck.js). 설정의 check 를 이긴다.
+        check: flags.check !== undefined ? String(flags.check) : undefined,
       });
     case '':
     case 'chat':
@@ -1186,6 +1201,24 @@ async function main() {
       return runRules(args, flags);
     case 'doc2md':
       return runDoc2md(args, flags);
+    // 과제 모음(골든셋)을 실제 모델로 돌려 성공률을 잰다 (src/eval/run.js).
+    case 'eval':
+      return runEval({
+        폴더: args[0] ?? null,
+        init: flags.init === true || flags.init === 'true',
+        repeat: flags.repeat ?? 1,
+        keep: flags.keep === true || flags.keep === 'true',
+        json: flags.json === true || flags.json === 'true',
+        only: flags.only !== undefined ? String(flags.only) : null,
+        시간초: flags.timeout !== undefined ? Number(flags.timeout) : null,
+        // 과제마다 띄우는 `deel run` 에 그대로 넘길 것 — 바깥 게이트웨이면 --online 이 있어야 돈다.
+        깃발들: [
+          ...(flags.online === true || flags.online === 'true' ? ['--online'] : []),
+          ...(flags.offline === true || flags.offline === 'true' ? ['--offline'] : []),
+          ...(flags.think ? ['--think', String(flags.think)] : []),
+          ...(flags.effort ? ['--effort', String(flags.effort)] : []),
+        ],
+      });
     case 'sbom':
       return runSbom(flags);
     case 'scan':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deel-local-cli",
-  "version": "2.0.1",
+  "version": "2.1.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/serve.js

@@ -27,10 +27,11 @@
 // 그래서 여기서 process.stdout.write 를 통째로 바꿔 끼운다. 부르는 자리를
 // 하나하나 찾아 막는 방법도 있지만, 그건 앞으로 새로 쓰는 코드까지 계속
 // 조심해야 한다는 뜻이다 — 언젠가 반드시 한 군데를 빠뜨린다.
-import { existsSync, statSync } from 'node:fs';
+import { existsSync, statSync, realpathSync } from 'node:fs';
 import { isAbsolute, join, resolve } from 'node:path';
 import { VERSION } from '../version.js';
-import { 규칙모으기, 늘허락, 정책읽기 } from '../safety/policy.js';
+import { 규칙모으기, 늘허락, 정책읽기, 승인바닥 } from '../safety/policy.js';
+import { 검사설정 } from '../agent/donecheck.js';
 import { 훅읽기 } from '../safety/hooks.js';
 import { 에이전트읽기 } from '../agent/agents.js';
 import { 남길것읽기 } from '../safety/shellenv.js';
@@ -63,7 +64,7 @@ import { 연결, 줄나누기, 모르는방법오류, 잘못된인자오류, 인
 import { 도구시작, 도구끝남, 도구이름표, 도구갈래, 도구자리, 멈춘까닭, 프롬프트글, 되살린것 } from './map.js';
 
 /** 우리가 말하는 규격 판. 정수 하나이고, 깨지는 변경에서만 올라간다. */
-export const 규격판 = 1;
+const 규격판 = 1;
 
 /**
  * 이 모드에서 표준출력을 잠근다.
@@ -74,6 +75,22 @@ export const 규격판 = 1;
  *
  * @returns {(줄: string) => void} 진짜 표준출력으로 쓰는 함수. ACP 만 이걸 쓴다
  */
+/**
+ * 두 폴더 글이 **같은 자리**인가를 가르는 열쇠 (2.0.2 · 508).
+ *
+ * 글자로 견줬다(윈도에서만 소문자로). 그래서 한 폴더가 두 벌로 셌다 —
+ * 맥(대소문자를 안 가리는 APFS)의 `/Users/me/Proj` 와 `/users/me/proj`, 정션·심링크로 들어온 길,
+ * 8.3 짧은 이름. 같은 폴더인데 MCP 서버를 한 벌 더 띄우고, 같은 대화를 「다른 폴더로 열려
+ * 있다」 며 거절했다. 실제 자리(realpath)로 편 뒤에 견준다 — 맥·윈도의 realpath 는 디스크에
+ * 적힌 대소문자로 돌려준다. 윈도는 드라이브 글자(`C:` · `c:`)까지 맞추려고 소문자로 한 번 더 편다.
+ * 없는 자리면 글자 그대로 편다(견줄 것은 견준다).
+ */
+export function 자리열쇠(p) {
+  let r = resolve(String(p ?? ''));
+  try { r = realpathSync.native(r); } catch { /* 없거나 못 읽는 자리 — 글자로 견준다 */ }
+  return process.platform === 'win32' ? r.toLowerCase() : r;
+}
+
 export function 표준출력잠그기() {
   const 진짜 = process.stdout.write.bind(process.stdout);
   process.stdout.write = function (덩이, enc, cb) {
@@ -156,10 +173,7 @@ export async function acp(opts = {}) {
    * 겹쳐 온 session/new 둘을 가르려면 이름을 짓는 그 자리에서 바로 적어 둬야 한다.
    */
   const 열린자리 = new Map();
-  const 같은자리 = (가, 나) => {
-    const 편 = (p) => { const r = resolve(String(p)); return process.platform === 'win32' ? r.toLowerCase() : r; };
-    return 편(가) === 편(나);
-  };
+  const 같은자리 = (가, 나) => 자리열쇠(가) === 자리열쇠(나);
 
   /*
    * 폴더 → MCP 붙임. **폴더 하나에 한 벌**이다.
@@ -194,7 +208,24 @@ export async function acp(opts = {}) {
    * @param {object} o
    * @param {string|null} o.아이디  이어할 대화 이름. 주면 그 파일에 이어 쓴다
    */
-  async function 방만들기(요청, { 아이디 = null } = {}) {
+  /*
+   * 방을 짓다 넘어지면 **잡아 둔 이름을 푼다** (2.0.2 · 508).
+   *
+   * 이름은 짓자마자 열린자리 에 적는다(겹쳐 온 session/new 가 피하게). 그런데 그 뒤에서
+   * 넘어지면(훅·에이전트·감사기록을 여는 자리) 방은 없는데 이름만 남아, 이 창이 끝날 때까지
+   * 그 이름을 「다른 폴더로 열려 있다」 며 되살리기를 거절하고 정리(prune)에서도 뺐다.
+   */
+  async function 방만들기(요청, 옵션 = {}) {
+    const 잡은이름 = [];
+    try {
+      return await 방짓기(요청, 옵션, 잡은이름);
+    } catch (err) {
+      for (const id of 잡은이름) if (!방들.has(id)) 열린자리.delete(id);
+      throw err;
+    }
+  }
+
+  async function 방짓기(요청, { 아이디 = null } = {}, 잡은이름 = []) {
     /*
      * 작업 폴더를 **설정보다 먼저** 정한다.
      *
@@ -212,9 +243,13 @@ export async function acp(opts = {}) {
      * 그 경로를 통째로 새로 만들었다. 둘 다 에디터가 잘못 준 것이니 잘못된 인자로 답한다.
      * 안 주면 예전처럼 --root(없으면 띄운 자리)를 쓴다 — 그건 사람이 띄울 때 정한 것이다.
      */
-    const 준자리 = typeof 요청?.cwd === 'string' && 요청.cwd ? 요청.cwd : null;
+    /*
+     * **빈 글도 준 것이다** (2.0.2 · 508). 빈 글을 안 준 것으로 쳐서 --root 로 갔다 — 규격 위반 입력을
+     * 사람이 띄울 때 정한 자리로 조용히 바꿔 여는 것이다. 에디터가 cwd 를 못 채웠다는 뜻이니 거절한다.
+     */
+    const 준자리 = typeof 요청?.cwd === 'string' ? 요청.cwd : null;
     if (준자리 != null) {
-      if (!isAbsolute(준자리)) throw 잘못된인자오류(`cwd 는 절대 경로여야 합니다: ${준자리}`);
+      if (!isAbsolute(준자리)) throw 잘못된인자오류(`cwd 는 절대 경로여야 합니다: ${준자리 || '(빈 글)'}`);
       let 폴더인가 = false;
       try { 폴더인가 = statSync(준자리).isDirectory(); } catch { /* 없다 */ }
       if (!폴더인가) throw 잘못된인자오류(`cwd 가 있는 폴더가 아닙니다: ${준자리}`);
@@ -428,6 +463,7 @@ export async function acp(opts = {}) {
     // begin() 이 이름을 옮겼을 수 있으니 그 뒤에 적는다. Store 를 지은 자리부터 여기까지
     // 기다림이 없어서, 겹쳐 온 session/new 도 이 적힌 것을 보고 이름을 피한다.
     열린자리.set(store.id, root);
+    잡은이름.push(store.id);
     /*
      * 남은 할 일과 시킨 말 원문도 이 파일과 묶는다 (agent/store.js 의 살림따라가기).
      *
@@ -459,7 +495,8 @@ export async function acp(opts = {}) {
      * 그래서 deel 은 늘 제 폴더의 .deel/mcp.json 만 본다. 사람이 직접 적은 것만
      * 띄운다는 규칙이 대화 화면과 여기서 똑같이 유지된다.
      */
-    const 캐시열쇠 = resolve(root);
+    // 같은 폴더면 한 벌 — 글자가 달라도 (자리열쇠 머리말 · 2.0.2 · 508). `C:` · `c:` 로 두 벌 띄웠었다.
+    const 캐시열쇠 = 자리열쇠(root);
     if (!mcp캐시.has(캐시열쇠)) {
       mcp캐시.set(캐시열쇠, 다붙이기(root, {
         // 봉인은 MCP 를 붙이는 자리에도 그대로 걸린다 (safety/runmode.js 의 봉인됐나).
@@ -510,6 +547,8 @@ export async function acp(opts = {}) {
       get 눈있나() { return !!conn.vision; },
       // 적어 둔 허락·금지 규칙 (safety/policy.js). 승인 모드보다 먼저 본다.
       규칙들: 규칙모으기(cfg),
+      // 끝내려는 자리에서 돌릴 검사 (agent/donecheck.js). 터미널과 같은 설정을 읽는다.
+      완료검사: 검사설정(cfg),
       // 사람이 적어 둔 훅 (safety/hooks.js). 에디터 안에서도 같은 것이 돌아야 한다 —
       // 여기만 빠지면 「터미널에서는 막히고 에디터에서는 안 막힌다」 가 된다.
       훅들: 훅정보.훅들,
@@ -533,7 +572,7 @@ export async function acp(opts = {}) {
        */
       ask: async (_라벨, o = {}) => o?.def ?? '',
       askPassword: async () => null,
-      confirm: (이름, 인자) => 승인묻기(방, 이름, 인자),
+      confirm: (이름, 인자, 곁것 = {}) => 승인묻기(방, 이름, 인자, 곁것?.미리보기),
     };
 
     방.ctx.배움 = new 배움(root, homeDir());
@@ -580,7 +619,7 @@ export async function acp(opts = {}) {
   // deel 의 안전장치를 에디터의 승인 창으로 그대로 내보낸다. 이게 붙는 것과
   // 안 붙는 것의 차이가 크다 — 안 붙으면 위험한 명령을 물어볼 데가 없어서
   // 무조건 거부하게 되고, 그러면 에디터 안에서는 아무 일도 못 하는 도구가 된다.
-  async function 승인묻기(방, 이름, 인자) {
+  async function 승인묻기(방, 이름, 인자, 미리보기 = []) {
     /*
      * ── 끊긴 턴의 승인은 없다 (사냥5 H5-3) ─────────────────────────────────
      *
@@ -595,7 +634,13 @@ export async function acp(opts = {}) {
      */
     const 신호 = 방.도는신호 ?? null;
     if (신호?.aborted) return false;
-    if (방.늘허락.has(이름)) return true;
+    /*
+     * 관리 정책이 승인 바닥을 걸었으면 「앞으로 묻지 않기」 는 없다 (safety/policy.js 의 승인바닥).
+     * 바닥은 바꾸기 전에 사람이 본다는 약속이라, 버튼 한 번으로 그 사람을 빼는 길을 주면
+     * 안 된다. 전에 눌러 둔 늘 허락도 이 판에서는 안 먹는다.
+     */
+    const 바닥걸림 = 승인바닥().바닥 !== 'auto';
+    if (방.늘허락.has(이름) && !바닥걸림) return true;
 
     const 아이디 = `t${++방.도구번호}`;
     try {
@@ -608,10 +653,18 @@ export async function acp(opts = {}) {
           status: 'pending',
           locations: 도구자리(이름, 인자, null, { 뿌리: 방.root }),
           rawInput: 인자 ?? {},
+          /*
+           * 무엇이 바뀌는지를 같이 보낸다 (tools/index.js 의 바뀔내용). 편집기는 이걸 승인 창에
+           * diff 로 그린다. 여태는 제목 한 줄과 날것 인자만 보내서, 사람은 old_string·new_string
+           * JSON 을 읽고 허락해야 했다. 새 파일이면 oldText 가 null 이다 (ACP 의 Diff 꼴).
+           */
+          ...(Array.isArray(미리보기) && 미리보기.length
+            ? { content: 미리보기.map((것) => ({ type: 'diff', path: 것.경로, oldText: 것.전, newText: 것.후 })) }
+            : {}),
         },
         options: [
           { optionId: 'allow_once', name: '이번만 실행', kind: 'allow_once' },
-          { optionId: 'allow_always', name: `${이름} 은 앞으로 묻지 않기`, kind: 'allow_always' },
+          ...(바닥걸림 ? [] : [{ optionId: 'allow_always', name: `${이름} 은 앞으로 묻지 않기`, kind: 'allow_always' }]),
           { optionId: 'reject_once', name: '하지 않기', kind: 'reject_once' },
         ],
       }, { signal: 신호 });
@@ -620,6 +673,7 @@ export async function acp(opts = {}) {
       if (신호?.aborted) return false;
       const 결과 = 답?.outcome ?? {};
       if (결과.outcome !== 'selected') return false;   // cancelled 도 여기로 온다
+      if (결과.optionId === 'allow_always' && 바닥걸림) return true;
       if (결과.optionId === 'allow_always') {
         방.늘허락.add(이름);
         /*
@@ -846,6 +900,17 @@ export async function acp(opts = {}) {
             말하기(`\n\n_(${옮긴말('ev.hookBlock')})_\n\n`);
             break;
 
+          // 완료 검사 (agent/donecheck.js). 에디터에도 무엇을 돌렸고 어떻게 됐는지 적는다.
+          case 'check_start':
+            말하기(`\n\n_(${옮긴말('check.start', { 판: ev.판, 최대: ev.최대, 명령: ev.명령 })})_\n\n`);
+            break;
+
+          case 'check':
+            말하기(`\n\n_(${ev.ok === true ? 옮긴말('check.pass', { 명령: ev.명령 })
+              : ev.ok === false ? `${옮긴말('check.fail', { 판: ev.판, 최대: ev.최대, 요약: ev.요약 })} — ${ev.판 < ev.최대 ? 옮긴말('check.retry') : 옮긴말('check.gaveUp', { 판: ev.판 })}`
+                : 옮긴말('check.skipped', { 까닭: ev.까닭 })})_\n\n`);
+            break;
+
           case 'nudge':
             말하기(`\n\n_(${ev.why === '요청누락'
               ? 옮긴말('ev.nudgeMissed', { n: ev.빠진?.length ?? 0 })
@@ -1134,8 +1199,9 @@ export async function acp(opts = {}) {
         // 이름 대화를 되살리라는데 A 폴더 방이 나가서, 그 뒤 한 말이 A 에 적히고 A 를
         // 고친다. 폴더가 다르면 방만들기 로 보내고, 거기서 또렷하게 거절한다.
         const 있던방 = 방들.get(아이디);
-        const 바란자리 = typeof 인자?.cwd === 'string' && 인자.cwd ? 인자.cwd : (opts.root ?? process.cwd());
-        const 방 = 있던방 && 같은자리(있던방.root, 바란자리) ? 있던방 : await 방만들기(인자, { 아이디 });
+        // 빈 cwd 는 방만들기 가 거절한다 — 여기서 --root 로 바꿔 있던 방을 내주지 않는다 (2.0.2 · 508).
+        const 바란자리 = typeof 인자?.cwd === 'string' ? 인자.cwd : (opts.root ?? process.cwd());
+        const 방 = 있던방 && 바란자리 && 같은자리(있던방.root, 바란자리) ? 있던방 : await 방만들기(인자, { 아이디 });
 
         /*
          * 화면에 그릴 것과 모델에게 줄 것이 다르다.

package/src/agent/commit.js

@@ -299,7 +299,7 @@ export function 담기(뿌리, 경로들, { 전부 = false, 안쪽 = '' } = {})
  *
  * @returns {{샌것: string[], 못뺀것: string[]}}
  */
-export function 살림도로빼기(뿌리, 파일들) {
+function 살림도로빼기(뿌리, 파일들) {
   const 샌것 = 파일들.filter((f) => 살림에닿나(join(뿌리, f)));
   if (!샌것.length) return { 샌것, 못뺀것: [] };
   // 첫 커밋 전이면 HEAD 가 없어 restore 가 안 된다. 그때는 index 에서 지운다.
@@ -458,7 +458,7 @@ export function 답가르기(글) {
  * 글자를 감춘다), 그렇게 적힌 것은 이력에 영영 남아 남의 터미널에서 다시 돈다.
  * 줄바꿈과 탭만 남긴다.
  */
-export function 제어글자빼기(글) {
+function 제어글자빼기(글) {
   let 남길것 = '';
   for (const 글자 of String(글 ?? '')) {
     const 값 = 글자.codePointAt(0);

package/src/agent/compact.js

@@ -14,8 +14,8 @@ import { 그림장수, 글만 } from '../backend/vision.js';
 
 // 몇 %에서 접기 시작할지. 접고 나서 다시 금방 차면 아무 소용이 없으니 넉넉히 비운다.
 export const COMPACT_AT = 0.8;
-export const KEEP_TAIL_RATIO = 0.3;   // 최근 대화 중 남길 비율
-export const KEEP_HEAD = 2;           // 맨 처음 요청은 언제나 남긴다 (목표가 거기 있다)
+const KEEP_TAIL_RATIO = 0.3;   // 최근 대화 중 남길 비율
+const KEEP_HEAD = 2;           // 맨 처음 요청은 언제나 남긴다 (목표가 거기 있다)
 
 /*
  * ── 그 전에, 도구 결과부터 접는다 ──────────────────────────────────────
@@ -37,7 +37,7 @@ export const KEEP_HEAD = 2;           // 맨 처음 요청은 언제나 남긴
  */
 export const FOLD_AT = 0.55;      // 이 아래로는 접을 이유가 없다
 export const KEEP_RECENT = 4;     // 최근 도구 결과 이만큼은 원문 그대로 둔다
-export const FOLD_MIN = 300;      // 이보다 작으면 접어도 자리가 안 준다 (글자 수)
+const FOLD_MIN = 300;      // 이보다 작으면 접어도 자리가 안 준다 (글자 수)
 export const 접힘표 = '(접힘)';
 
 /*
@@ -109,7 +109,7 @@ export const 캐시일때비울몫 = 0.10;
  * (여기가 「두 번 넘게」 라고 적혀 있었다. 아래 셈은 두 번째에 이미 단정한다 —
  * 한 번의 차이지만, 적힌 것과 하는 것이 다르면 다음 사람이 그 값을 못 믿는다.)
  */
-export const 재볼기회 = 2;
+const 재볼기회 = 2;
 
 export function 캐시가도나(session) {
   const u = session?.usage ?? {};