deel-local-cli 1.17.9 → 1.18.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-8%2C140%20passing-1a7f37?logo=checkmarx&logoColor=white)](docs/ko/develop.md)
+[![tests](https://img.shields.io/badge/tests-8%2C404%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)
@@ -301,7 +301,7 @@ deel --offline
 무엇이 어디로 갈 수 있는지는 켤 때 화면 맨 위에 늘 적혀 있습니다.
 
 ```
- deel 1.17.9  ⌂ 이 안
+ deel 1.18.0  ⌂ 이 안
  보냄    이 컴퓨터 안 127.0.0.1:11434  ← 여기 말고는 어디로도 안 갑니다
 ```
 
@@ -507,6 +507,7 @@ LM Studio 는 `/api/v0/models`, llama.cpp 는 `/props`. 못 알아보면 `(추
 | `/pin <말>` | 못 박기 — 접거나 요약해도 **안 지워지는** 말 |
 | `/evidence [파일]` | 증거 — 무엇을 바꿨고 무엇이 그걸 증명하나. **안 된 것도** 적습니다 |
 | `/commit [전부\|미리보기\|제목]` | 이번 대화가 바꾼 것만 담아 커밋. 메시지는 diff 와 증거에서. **push 는 안 합니다** |
+| `/review` | 바꿔 둔 것을 **새 창에서** 한 번 더 보기 — 찾은 것만 말하고 아무것도 안 고칩니다 |
 | `/model` | 연결·모델 바꾸기 |
 | `/model 카드` | 이 모델을 겪어 본 결과 — 그래서 deel 이 무엇을 바꿔 뒀는지 |
 | `/think <강도>` | 추론 강도 (`off·low·medium·high·xhigh·max`) — 창구가 안 받는 칸은 받는 값으로 낮춰 보냅니다 |
@@ -522,6 +523,7 @@ LM Studio 는 `/api/v0/models`, llama.cpp 는 `/props`. 못 알아보면 `(추
 | `/undo [턴수]` | 파일 변경 되돌리기 |
 | `/diff [파일]` | 이번 대화에서 바뀐 파일 · 바뀐 자리 보기 |
 | `/preview [폴더\|파일\|off]` | 만든 웹을 이 자리에서 띄워 보기 — 브라우저가 같이 열립니다 |
+| `/paste` | 클립보드에 든 화면 캡처 붙이기 (캡처 → `/paste`) |
 | `/tools` | 쓸 수 있는 도구 |
 | `/skills [검색어\|all\|off]` | 스킬 보기·검색·골라 올리기 |
 | `/plugin [install\|remove\|pack]` | 플러그인 관리 |
@@ -535,7 +537,7 @@ LM Studio 는 `/api/v0/models`, llama.cpp 는 `/props`. 못 알아보면 `(추
 | `/hooks` | 적어 둔 훅 보기 (어디서 읽었고 언제 도는지) |
 | `/agents` | 이름 붙인 하위 작업 보기 |
 | `/init` | `DEEL.md` 규칙 파일 만들기 |
-| `/exit` | 끝내기 |
+| `/exit` `/quit` | 끝내기 |
 
 `/scan` 과 `/sessions` 는 나가지 않고도 씁니다. 로컬 서버를 새로 켰거나 모델을
 바꿔 올렸을 때 `/scan save` → `/model` 두 번이면 대화를 이어둔 채로 갈아탑니다.
@@ -1287,6 +1289,7 @@ zip 은 진짜 `unzip` 으로, tar 는 진짜 `tar` 가 만든 것을 읽혀 교
 
 | 판 | 무엇이 바뀌었나 |
 |---|---|
+| [1.18.0](docs/ko/releases/1.18.md#1180) | 있는 것과 걸리는 것은 다릅니다 — 검사 8,404개가 초록인 채로 열려 있던 자리들 |
 | [1.17.9](docs/ko/releases/1.17.md#1179) | 한도에 걸렸는데 1초 뒤에 또 두드리고 있었습니다 |
 | [1.17.8](docs/ko/releases/1.17.md#1178) | 긴 지시문을 통째로 붙여 넣으면 시킨 것과 반대로 갔습니다 — 그리고 망이 한 번 끊기면 턴이 사라졌습니다 |
 | [1.17.7](docs/ko/releases/1.17.md#1177) | 나란히 세워 재 봤고, 진 항목을 고쳤습니다 |

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-8%2C140%20passing-1a7f37?logo=checkmarx&logoColor=white)](docs/en/develop.md)
+[![tests](https://img.shields.io/badge/tests-8%2C404%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)
@@ -374,7 +374,7 @@ deel --offline
 The destination is printed at the top of every session:
 
 ```
- deel 1.17.9  ⌂ inside
+ deel 1.18.0  ⌂ inside
  Sends to this machine 127.0.0.1:11434  ← nowhere else
 ```
 
@@ -572,6 +572,7 @@ Names follow Claude Code / Codex conventions.
 | `/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** |
+| `/review` | Re-reads what you changed **in a fresh context** — reports findings only, changes nothing |
 | `/model` | Switch connection / model |
 | `/model card` | Model card — what this model has actually done here, and what deel changed because of it |
 | `/think <level>` | Reasoning level (`off·low·medium·high·xhigh·max`) — a rung this endpoint does not accept is lowered to one it does |
@@ -587,6 +588,7 @@ Names follow Claude Code / Codex conventions.
 | `/undo [turns]` | Revert file changes |
 | `/diff [file]` | Files changed this session, and the changed lines |
 | `/preview [folder\|file\|off]` | Serve what you built, right here — a browser opens with it |
+| `/paste` | Attach the screenshot sitting in the clipboard (capture, then `/paste`) |
 | `/tools` | Available tools |
 | `/skills [query\|all\|off]` | Browse, search, load skills |
 | `/plugin [install\|remove\|pack]` | Manage plugins |
@@ -600,7 +602,7 @@ Names follow Claude Code / Codex conventions.
 | `/hooks` | Configured hooks — where they came from, when they run |
 | `/agents` | Named subagent definitions |
 | `/init` | Create a `DEEL.md` rules file |
-| `/exit` | Quit |
+| `/exit` `/quit` | Quit |
 
 Discovered plugin commands are invoked as `/<plugin>:<name>`, with `$ARGUMENTS` substituted.
 
@@ -1348,6 +1350,7 @@ so one run tells you everything.
 
 | Version | What changed |
 |---|---|
+| [1.18.0](docs/en/releases/1.18.md#1180) | Having a rule is not the same as the rule firing — what was open while 8,404 checks stayed green |
 | [1.17.9](docs/en/releases/1.17.md#1179) | Rate-limited, and knocking again one second later |
 | [1.17.8](docs/en/releases/1.17.md#1178) | A long brief got the opposite of what it asked for — and one network blip threw the turn away |
 | [1.17.7](docs/en/releases/1.17.md#1177) | We measured it side by side, and fixed the row we lost |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deel-local-cli",
-  "version": "1.17.9",
+  "version": "1.18.0",
   "description": "A coding-agent CLI that runs on local models and private gateways. Zero dependencies, Node 20+.",
   "type": "module",
   "license": "MIT",
@@ -54,6 +54,7 @@
     "check": "node tools/check-src.mjs",
     "coverage": "node test/coverage.mjs",
     "mutate": "node tools/mutate.mjs",
+    "review2": "node tools/review2.mjs",
     "prepublishOnly": "npm run check && npm test"
   },
   "dependencies": {},

package/src/agent/loop.js

@@ -986,9 +986,13 @@ export async function* run(session, ctx, userText, { signal = null, 깊이 = 0,
        * `low` 에서도 한 칸 더 내려간다 — `off` 로.
        *
        * 여태 여기서 멈춰 있었다. 그런데 지금은 「생각이 실제로 자리를 먹었을
-       * 때만 다시 부른다」 이므로, low 인데 생각이 1,024토큰어치 자리를 먹은
-       * 판에서 다시 부르기를 거절하는 것은 앞뒤가 안 맞는다. 되찾을 자리가
-       * 있다고 재 놓고 안 되찾는 셈이다.
+       * 때만 다시 부른다」 이므로, low 인데 **한 칸 낮추면 1,024토큰어치를
+       * 되찾는** 판에서 다시 부르기를 거절하는 것은 앞뒤가 안 맞는다.
+       * 되찾을 자리가 있다고 재 놓고 안 되찾는 셈이다.
+       *
+       * (되찾는 자리가 1,024 라는 말이지 생각이 1,024 를 먹었다는 말이 아니다 —
+       *  아래 `생각이자리를먹었나` 는 `생각몫 × 되찾을몫(0.4) >= 1024` 이라
+       *  생각이 2,560 토큰은 먹었어야 참이 된다.)
        *
        * 이 턴 하나만 끈다. 다음 걸음은 사람이 정한 눈금으로 되돌아간다.
        */

package/src/agent/route.js

@@ -16,7 +16,31 @@
 // 낱말과 점수. 큰 점수일수록 그 모드라는 증거가 강하다는 뜻이다.
 //
 // 한국어를 먼저 두되 영어도 같이 본다 — 오류 메시지를 그대로 붙여넣는 일이 흔하다.
-const 표 = {
+/*
+ * 검사가 이 표를 그대로 읽는다 (test/자동모드.test.js).
+ *
+ * 규칙을 넣기만 하고 그게 실제로 걸리는지는 아무도 안 본다 — 안 걸리는 규칙은
+ * 없는 것과 같고, 그런데도 화면은 멀줦하다(다음 규칙이 받아 그럴듯한 모드를 낸다).
+ * 그래서 밖으로 내놓고, 규칙 하나하나가 실제 문장에 걸리는지를 재게 한다.
+ */
+/*
+ * ── 「… 좀 해줘」 의 빈칸 ────────────────────────────────────────────────
+ *
+ * 낱말 뒤에 붙는 토씨를 `점검(해|좀|을|이)` 처럼 **붙여서만** 봤다. 그런데
+ * 한국말에서 부탁할 때는 그 사이가 거의 언제나 벌어진다 —
+ *
+ *   "점검 좀 해줘" · "설명 좀 해줘" · "수정 좀 해줘" · "구현 좀 해줘"
+ *
+ * 이 꼴이 전부 **하나도 안 걸려서** 종합 모드에 그대로 남았다. 규칙이 안
+ * 걸리면 아무 데서도 안 터지므로(점수만 안 오른다) 여태 아무도 몰랐다.
+ * 자동모드.test.js 의 죽은 규칙 검사가 「이 규칙에 걸리는 실제 문장이 없다」
+ * 로 잡아 줬다.
+ *
+ * 그래서 '좀' **앞에만** 빈칸을 열어 둔다(`\s*좀`). 토씨 전체에 열면
+ * "점검 이력" 이 「점검 이」 로 걸리는 식으로 넓어진다 — 가르는 자리가
+ * 미묘해서, 여는 것도 좁게 연다.
+ */
+export const 표 = {
   debug: [
     // 고장은 신호가 뚜렷하다. 그리고 디버그는 파일을 고칠 수 있으므로
     // 잘못 골라도 막히지 않는다. 그래서 세게 준다.
@@ -33,7 +57,7 @@ const 표 = {
     [/왜\s*(못|안)/, 3], [/뭐\s*때문(이|에)/, 3],
     // 원인을 짚으라는 말은 점검이 아니라 디버그다 — 증상이 이미 있다는 뜻이다.
     // 이게 없으면 "오류 원인 분석해줘" 가 둘 사이에서 비겨 종합에 그대로 남는다.
-    [/원인(을|이|은)?\s*(찾|짚|파악|밝|알아|분석|살펴|봐)/, 4],
+    [/원인(을|이|은)?\s*(?:좀\s*)?(찾|짚|파악|밝|알아|분석|살펴|봐)/, 4],
   ],
 
   plan: [
@@ -72,8 +96,8 @@ const 표 = {
    * 파일을 못 고쳐서 사람이 막히므로, 문턱은 읽기 전용답게 높인다.
    */
   inspect: [
-    [/점검(해|좀|을|이)/, 5], [/분석(해|좀|을|이)/, 5],
-    [/검토(해|좀|를)/, 5], [/리뷰(해|좀)?/, 5],
+    [/점검(해|\s*좀|을|이)/, 5], [/분석(해|\s*좀|을|이)/, 5],
+    [/검토(해|\s*좀|를)/, 5], [/리뷰(해|\s*좀)?/, 5],
     // '감사합니다' 는 안 걸린다 — '합' 은 '해·하' 가 아니다.
     [/감사(를)?\s*(해|하)/, 4], [/훑어\s*(봐|보고|줘)/, 4],
     [/취약(점|한|성)/, 5], [/보안\s*(점검|검토|문제|취약|구멍)/, 5],
@@ -103,7 +127,7 @@ const 표 = {
      */
     [/뭐\s*하는\s*(파일|함수|코드|모듈|클래스|녀석|건|거|것)/, 5],
     [/뭐\s*하(는|나|니|냐)/, 3], [/무슨\s*(일|역할)/, 3],
-    [/설명(해|좀|을)/, 5], [/알려\s*(줘|주세요|줄래)/, 3],
+    [/설명(해|\s*좀|을)/, 5], [/알려\s*(줘|주세요|줄래)/, 3],
     [/어떻게\s*(동작|작동|돌아가)/, 5],
     [/무슨\s*(뜻|의미)|의미(가|는)\s*뭐/, 5],
     [/차이(가|는|점)/, 3],
@@ -122,20 +146,20 @@ const 표 = {
     [/끝까지/, 3], [/마무리까지/, 3],
     [/여러\s*(개|군데|파일|단계|곳)/, 3],
     [/순서대로/, 3],
-    [/통일(해|시켜|좀)|일괄/, 2],
+    [/통일(해|시켜|\s*좀)|일괄/, 2],
     [/흩어진|여기저기/, 2],
     [/\bend[- ]?to[- ]?end\b/i, 3],
   ],
 
   code: [
-    [/고쳐|고쳐줘|수정(해|좀)/, 4],
-    [/만들어|추가(해|좀)|넣어(줘|주세요)/, 4],
-    [/구현(해|좀)/, 5],
-    [/바꿔(줘|주세요)?|변경(해|좀)/, 3],
-    [/지워(줘)?|삭제(해|좀)/, 3],
+    [/고쳐|고쳐줘|수정(해|\s*좀)/, 4],
+    [/만들어|추가(해|\s*좀)|넣어(줘|주세요)/, 4],
+    [/구현(해|\s*좀)/, 5],
+    [/바꿔(줘|주세요)?|변경(해|\s*좀)/, 3],
+    [/지워(줘)?|삭제(해|\s*좀)/, 3],
     [/이름\s*바꿔|리네임|rename/i, 3],
     [/옮겨(줘)?/, 2],
-    [/리팩터(링)?(해|좀)/, 3],
+    [/리팩터(링)?(해|\s*좀)/, 3],
     [/\bimplement\b|\badd\b|\bfix\b|\bwrite\b/i, 2],
     [/써(줘|주세요)/, 3],
   ],
@@ -285,7 +309,7 @@ export function 겹친요청(text) {
  * 하나는 읽고 말하라는 말이고 하나는 고치라는 말이다. 그래서 어미가 아니라
  * **동사 목록**으로 본다. 목록에 없으면 손대라는 말이 아니다.
  */
-const 손대는동사 = '만들|고쳐|고치|바꿔|바꾸|추가|넣어|지워|삭제|옮겨|나눠|나누|합쳐|정리|개선|구현|작성|적용|설치|배포|리팩터링|리팩터|분리|통일|세팅|갈아|손봐|손보|수정';
+export const 손대는동사 = '만들|고쳐|고치|바꿔|바꾸|추가|넣어|지워|삭제|옮겨|나눠|나누|합쳐|정리|개선|구현|작성|적용|설치|배포|리팩터링|리팩터|분리|통일|세팅|갈아|손봐|손보|수정';
 /*
  * 동사 바로 뒤에 시킴꼴이 붙어야 한다. 빈칸을 안 넘으므로 "나누는 설계만 봐줘"
  * 는 안 걸린다 — 그건 나누라는 말이 아니라 나누는 안을 보자는 말이다.
@@ -306,10 +330,34 @@ const 손대는동사 = '만들|고쳐|고치|바꿔|바꾸|추가|넣어|지워
  * 붙어 있나로 그 둘이 갈린다.
  * 「만들어라」 는 언제나 만들라는 말이다.
  */
-const 손대라는말 = new RegExp(`(${손대는동사})\\S{0,3}(줘|주세요|주라|해라|하라|하자|해다오|해줄래|할래|어라|아라|여라|라(?=[\s.!?~,]|$))`);
+/*
+ * ── 여기 백슬래시 하나가 빠져 있었다 ────────────────────────────────────
+ *
+ * 이 무늬는 **템플릿 글**로 짓는다(동사 목록을 끼워 넣어야 해서). 그런데
+ * 템플릿 글 안에서 `\s` 는 정규식에 닿기 전에 자바스크립트가 먼저 먹는다 —
+ * 모르는 이스케이프라 백슬래시를 떼고 **글자 `s`** 만 남긴다.
+ *
+ *     적은 것   ...|라(?=[\s.!?~,]|$))
+ *     닿은 것   ...|라(?=[s.!?~,]|$))     ← 빈칸이 아니라 알파벳 s
+ *
+ * 그래서 맨 「라」 뒤에 **빈칸이나 줄바꿈이 오면 안 걸렸다.** 걸리는 것은
+ * 「라」 가 글 맨 끝이거나 바로 뒤에 . ! ? ~ , 가 붙을 때뿐이었다.
+ *
+ *     "그것 좀 바꿔라"        걸림   (글 끝)
+ *     "바꿔라 지금 해줘"      안 걸림 ← 여러 마디로 시키면 거의 다 이쪽이다
+ *     "지워라 그리고 저장해"  안 걸림
+ *
+ * 위 주석이 「사람은 고쳐 달라고 세 번 적었는데 아무것도 안 바뀐 화면을
+ * 받는다」 고 적어 둔 바로 그 고장이, 고쳐 놓고도 백슬래시 하나 때문에
+ * 그대로 남아 있었다. `\\s` 로 적어야 정규식이 `\s` 를 받는다.
+ *
+ * (`\\S{0,3}` 는 처음부터 두 개라 멀쩡했다. 한 무늬 안에서 한쪽만 틀렸으니
+ *  눈으로는 더 안 보인다.)
+ */
+const 손대라는말 = new RegExp(`(${손대는동사})\\S{0,3}(줘|주세요|주라|해라|하라|하자|해다오|해줄래|할래|어라|아라|여라|라(?=[\\s.!?~,]|$))`);
 
 // 파일을 못 고치는 모드. modes.js 에서 쓰기 도구를 안 주는 것들과 같아야 한다.
-const 읽기만하는모드 = new Set(['architect', 'plan', 'ask', 'inspect']);
+export const 읽기만하는모드 = new Set(['architect', 'plan', 'ask', 'inspect']);
 
 /*
  * ── 영어로 시킨 말은 하나도 못 보고 있었다 ──────────────────────────────

package/src/backend/adapter.js

@@ -249,7 +249,8 @@ export function buildBody(shape, { model, messages, tools, stream, json, think,
     const 박은것 = 나머지.length ? 메시지표식(나머지, 칸) : 나머지;
     if (시킴) {
       const 나눔 = 시킴[조각표];
-      const 블록 = 시스템블록(Array.isArray(나눔) && 나눔.length > 1 ? 나눔 : [시킴.content], true, 칸);
+      const 블록 = 시스템블록(Array.isArray(나눔) && 나눔.length > 1 ? 나눔 : [시킴.content], true, 칸,
+        { 긴수명: 카드?.긴수명 !== false });
       대화 = [Array.isArray(블록) ? { ...시킴, content: 블록 } : 시킴, ...박은것];
     } else {
       대화 = 박은것;
@@ -414,7 +415,7 @@ function anthropic몸({ model, messages, tools, stream, json, think, maxTokens,
   const body = { model, messages: 대화, stream: !!stream, max_tokens: maxTokens };
   if (머리말.length) {
     body.system = 표식쓰나
-      ? 시스템블록(조각들 ?? 머리말, true, 칸)
+      ? 시스템블록(조각들 ?? 머리말, true, 칸, { 긴수명: 카드?.긴수명 !== false })
       : 머리말.join('\n\n');
   }
 
@@ -857,11 +858,6 @@ export function 본문글(m) {
     .join('\n');
 }
 
-/** 이 메시지가 도구를 불렀나. */
-export function 도구불렀나(m) {
-  return 부른것들(m).length > 0;
-}
-
 /**
  * 도구 결과의 **글만** 갈아 끼운 사본. 짝지어 주는 것(id)은 그대로 둔다.
  *

package/src/backend/cachemark.js

@@ -41,9 +41,43 @@ import { estimateTokens } from './tokens.js';
 // 빈 글 블록에도 안 붙인다. 둘 다 거절당할 수 있고, 그 400 은 화면에서
 // 열쇠가 틀린 것과 구별이 안 된다.
 
-/** 표식 한 개. 기본 수명(5분)을 쓴다 — 한 시간짜리는 쓰기 값이 두 배다. */
+/** 표식 한 개. 기본 수명(5분). 굴러가는 꼬리에는 이걸 쓴다. */
 export const 표식 = { type: 'ephemeral' };
 
+/**
+ * **굳은 앞머리**에 쓰는 표식. 한 시간을 산다.
+ *
+ * ── 왜 바꿨나 ───────────────────────────────────────────────────────────
+ *
+ * 여기 「한 시간짜리는 쓰기 값이 두 배라 안 쓴다」 고 적혀 있었다. 그 셈이
+ * **견줄 상대를 잘못 잡았다.**
+ *
+ *   5분이 지나 캐시가 죽으면 상대는 「싼 쓰기」 가 아니라 **전액 재전송**이다.
+ *
+ *   5분  쓰기 1.25배 → 5분 넘으면 죽는다 → 다음 턴에 또 1.25배 → 매 턴 1.25배
+ *   1시간 쓰기 2배   → 한 시간 산다     → 다음 턴부터 0.1배
+ *
+ * 두 턴만 넘어가도 1시간이 이긴다(2 + 0.1 = 2.1 대 1.25 + 1.25 = 2.5).
+ *
+ * 그리고 코딩 에이전트는 **5분을 넘기는 것이 예외가 아니라 일상**이다. 검사
+ * 한 번이 6분이고 빌드가 3분이다. 그 사이 도구가 도는 동안 모델은 안 불린다 —
+ * 5분 수명은 그 틈을 못 넘긴다.
+ *
+ * 나란히 재 봤을 때 이것이 숫자로 나왔다(docs/ko/benchmark.md). 같은 일을
+ * 시킨 비교에서 캐시 쓰기가 **1.5M 대 247.6K — 여섯 배**였고, 적중률이
+ * 94.3% 대 99.3% 였다. 토큰을 28.7% 적게 쓰고도 비용이 22% 높았다. 캐시를
+ * 자꾸 다시 쓰느라 그랬다.
+ *
+ * ── 왜 앞머리에만 붙이나 ────────────────────────────────────────────────
+ *
+ * 굳은 앞머리(도구 정의 + 시스템 글)는 **크고 안 바뀐다.** 오래 살려 둘 값이
+ * 있는 자리다. 반대로 대화 꼬리는 다음 턴에 새 메시지가 붙는 순간 어차피
+ * 무효가 된다 — 거기에 두 배를 내는 것은 그냥 버리는 돈이다.
+ *
+ * 그래서 수명을 자리에 맞춰 나눈다. 이게 「한 시간을 켠다」 와 다른 점이다.
+ */
+export const 표식긴것 = { type: 'ephemeral', ttl: '1h' };
+
 /**
  * 표식을 적는 **칸 이름**들.
  *
@@ -61,10 +95,16 @@ export const 표식 = { type: 'ephemeral' };
  */
 export const 표식칸들 = ['cache_control', 'prompt_cache_breakpoint'];
 
-/** 그 칸에 적을 값. 칸마다 값의 모양이 다르다. */
-const 표식값 = (칸) => (칸 === 'prompt_cache_breakpoint'
-  ? { mode: 'explicit' }
-  : { ...표식 });
+/**
+ * 그 칸에 적을 값. 칸마다 값의 모양이 다르다.
+ *
+ * `긴것` 은 Anthropic 규격에만 있다. OpenAI 규격의 `prompt_cache_breakpoint`
+ * 에는 수명 칸이 없으므로 붙이지 않는다 — 없는 칸을 지어내면 400 이다.
+ */
+const 표식값 = (칸, 긴것 = false) => {
+  if (칸 === 'prompt_cache_breakpoint') return { mode: 'explicit' };
+  return 긴것 ? { ...표식긴것 } : { ...표식 };
+};
 
 /*
  * 시스템 글의 「굳은 부분 / 매 턴 바뀌는 부분」 을 나눠 담는 표.
@@ -87,10 +127,43 @@ const 붙일수있나 = (b) => {
   return t === 'tool_result' || t === 'tool_use' || t === 'image' || t === 'document';
 };
 
-/** 대화가 이보다 길면 중간에 닻을 하나 더 박는다 (되돌아보기 창 스무 자리). */
+/*
+ * ── 되돌아보기 창은 **블록** 스무 개다. 메시지 스무 개가 아니다 ─────────
+ *
+ * 서버는 표식에서 뒤로 **블록 20개**까지만 훑어 먼저 굳혀 둔 것을 찾는다.
+ * 그 안에 앞선 표식이 없으면 못 찾고, 못 찾으면 앞이 통째로 다시 나간다.
+ * 닻은 바로 그 일이 안 나게 꼬리 앞에 하나 더 박아 두는 것이다.
+ *
+ * 그런데 여기서 **메시지 수로** 세고 있었다. 그 둘은 도구를 도는 대화에서
+ * 완전히 다른 값이다 — 한 차례가 블록 여럿이기 때문이다.
+ *
+ *   assistant  [글 하나 + 도구 부름 둘]        → 3블록
+ *   user       [도구 결과 둘]                  → 2블록
+ *   즉 한 바퀴가 메시지 2개인데 블록은 5개다.
+ *
+ * 그래서 「끝에서 메시지 12개」 는 실제로 **30블록**이었다. 창이 20인데.
+ * 닻이 창 밖에 박혀 있으니 꼬리 표식은 그걸 못 보고, 결국 매 턴 앞이 통째로
+ * 다시 나갔다. 닻을 박은 값이 하나도 없었던 셈이다.
+ *
+ * 더 나쁜 것은 **하필 도구를 많이 쓰는 대화에서만** 그랬다는 점이다. 그건
+ * 이 프로그램이 하는 일 그 자체다. 짧은 문답에서는 메시지와 블록 수가 비슷해
+ * 잘 맞고, 길게 일을 시킬수록 어긋난다 — 아낄 것이 제일 많은 자리에서만
+ * 안 아꼈다.
+ *
+ * 이제 블록으로 센다.
+ */
+/** 서버가 표식에서 뒤로 훑는 칸 수. 이 값은 서버가 정한 것이다. */
+export const 창블록 = 20;
+/** 닻은 꼬리에서 이만큼 **블록** 앞에 박는다. 창(20)보다 넉넉히 안쪽이어야 한다. */
+export const 닻블록 = 14;
+/** 대화가 이 블록 수를 넘으면 닻을 하나 더 박는다. 그 아래면 꼬리 하나로 닿는다. */
 export const 닻문턱 = 20;
-/** 닻은 끝에서 이만큼 앞에 박는다. */
-const 닻거리 = 12;
+
+/** 메시지 하나가 몇 블록인가. 글 한 덩이짜리는 1블록이다. */
+const 블록수 = (m) => (Array.isArray(m?.content) ? m.content.length : 1);
+
+/** 이 배열이 통틀어 몇 블록인가. */
+const 통블록 = (ms) => ms.reduce((n, m) => n + 블록수(m), 0);
 
 /**
  * 메시지 하나의 **마지막 성한 블록**에 표식을 붙인 사본을 돌려준다.
@@ -123,13 +196,22 @@ export function 블록에붙이기(msg, 칸 = 'cache_control') {
  * @param {string[]} 조각들
  * @param {boolean} 표식쓰나
  */
-export function 시스템블록(조각들, 표식쓰나, 칸 = 'cache_control') {
+export function 시스템블록(조각들, 표식쓰나, 칸 = 'cache_control', { 긴수명 = true } = {}) {
   const 있는것 = (조각들 ?? []).map((x) => String(x ?? '')).filter((x) => x.length);
   if (!있는것.length) return null;
   if (!표식쓰나) return 있는것.join('');
   const 굳은끝 = 0;   // 첫 조각이 굳은 부분이다
+  /*
+   * 굳은 부분에는 **한 시간짜리**를 붙인다 (표식긴것).
+   *
+   * 이 자리가 크고 안 바뀐다 — 도구 정의와 시스템 글이다. 오래 살려 두면
+   * 도구가 도는 몇 분 동안에도 안 죽는다. 굴러가는 꼬리는 어차피 다음 턴에
+   * 무효가 되므로 거기까지 두 배를 낼 까닭이 없다 (메시지표식 은 짧은 것).
+   *
+   * 안 받는 창구가 있으면 카드가 끈다 (backend/wire.js 의 긴수명).
+   */
   return 있는것.map((text, i) => (
-    i === 굳은끝 ? { type: 'text', text, [칸]: 표식값(칸) } : { type: 'text', text }
+    i === 굳은끝 ? { type: 'text', text, [칸]: 표식값(칸, 긴수명) } : { type: 'text', text }
   ));
 }
 
@@ -163,15 +245,59 @@ function 붙는자리(ms, 부터) {
   return -1;
 }
 
+/*
+ * ── 닻은 물러서면 안 된다. **다가서야** 한다 ────────────────────────────
+ *
+ * 위 자는 못 붙이면 **앞으로**(꼬리에서 멀어지는 쪽으로) 물러선다. 꼬리
+ * 표식에는 그게 맞다 — 끝 너머로는 갈 데가 없으니까.
+ *
+ * 그런데 닻에 같은 자를 쓰면 방향이 반대로 작동한다. 닻이 하는 일은
+ * 「꼬리에서 창(20블록) 안에 표식을 하나 더 두는 것」 인데, 못 붙였다고
+ * 뒤로 물러서면 꼬리와의 거리가 **늘어난다.** 막힌 자리가 몇 개만 이어져도
+ * 그대로 창 밖으로 나간다 — 이 파일이 고친 그 고장이 모양만 바꿔 돌아온다.
+ *
+ * 실제로 재 봤다. 닻 자리 언저리가 막혀 있으면 닻→꼬리가 25블록이 됐다.
+ * 창이 20인데.
+ *
+ * 그래서 닻은 **꼬리 쪽으로 먼저 다가선다.** 그러면 거리는 줄기만 하므로
+ * 창 안이 보장된다. 꼬리 앞까지 다 막혀 있을 때만 뒤로 물러선다 — 그때는
+ * 창 밖이라도 없는 것보다 낫다(앞쪽이 통째로 다시 나가는 것을 막는다).
+ */
+function 닻붙는자리(ms, 부터, 꼬리) {
+  const 끝 = 꼬리 >= 0 ? 꼬리 : ms.length;
+  for (let i = Math.max(0, 부터); i < 끝; i++) {
+    if (블록에붙이기(ms[i], 'cache_control') !== ms[i]) return i;
+  }
+  return 붙는자리(ms, 부터);
+}
+
+/**
+ * 꼬리에서 **블록으로** 닻블록 만큼 앞선 자리를 찾는다.
+ *
+ * 뒤에서부터 블록을 세어 올라가다 닻블록 을 넘는 순간 멈춘다. 메시지 수로
+ * 세면 도구를 도는 대화에서 창 밖으로 나간다 (위 주석).
+ */
+function 닻자리(ms, 꼬리) {
+  let 센것 = 0;
+  for (let i = 꼬리; i >= 0; i--) {
+    센것 += 블록수(ms[i]);
+    if (센것 >= 닻블록) return i;
+  }
+  return 0;
+}
+
 export function 메시지표식(messages, 칸 = 'cache_control') {
   const ms = messages ?? [];
   if (!ms.length) return ms;
   const 붙일자리 = new Set();
   const 꼬리 = 붙는자리(ms, ms.length - 1);
   if (꼬리 >= 0) 붙일자리.add(꼬리);
-  // 도구를 길게 늘어놓는 턴에서 되돌아보기 창을 넘기지 않게 닻을 하나 더.
-  if (ms.length > 닻문턱) {
-    const 닻 = 붙는자리(ms, ms.length - 1 - 닻거리);
+  /*
+   * 도구를 길게 늘어놓는 턴에서 되돌아보기 창을 넘기지 않게 닻을 하나 더.
+   * 통틀어 창 안에 들어오면 꼬리 하나로 앞까지 닿으니 닻이 필요 없다.
+   */
+  if (통블록(ms) > 닻문턱) {
+    const 닻 = 닻붙는자리(ms, 닻자리(ms, 꼬리 >= 0 ? 꼬리 : ms.length - 1), 꼬리);
     // 꼬리와 같은 자리면 닻이 아니다 — 그건 표식 하나짜리다.
     if (닻 >= 0 && 닻 !== 꼬리) 붙일자리.add(닻);
   }

package/src/backend/http.js

@@ -680,7 +680,18 @@ function 오류코드(err) {
 
 // fetch 는 무슨 일이든 'fetch failed' 라고만 말하고 까닭은 cause 에 숨긴다. 그래서
 // 말(m)만 보지 않고 코드도 본다 — 안 그러면 DNS 실패도 "주소·포트·프록시를 확인하세요" 가 된다.
-function normalizeError(err) {
+/*
+ * 내보내는 까닭은 **검사 때문**이다.
+ *
+ * 이 사다리는 서버가 준 글을 정규식으로 읽어 사람 말로 갈아 끼운다. 그 중
+ * 한 줄은 열쇠가 화면과 진단 보고서에 평문으로 흘러나가는 것을 막는 줄이다.
+ * 그런 줄이 조용히 죽어도 아무 데서도 안 터진다 — 그냥 원문이 그대로 나가고,
+ * 그 원문 안에 열쇠가 들어 있다.
+ *
+ * 부르는 길이 `req()` 하나뿐이라 검사판에서 갈래마다 재려면 진짜 통신을
+ * 실패시켜야 했다. 그래서 안 재고 있었다. 재지는 조각으로 내놓는다.
+ */
+export function normalizeError(err) {
   const m = String(err?.message ?? err);
   const 코드 = String(오류코드(err) ?? '');
   const 기본 = (() => {

package/src/backend/mcp.js

@@ -28,6 +28,8 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { createHash } from 'node:crypto';
 import { join } from 'node:path';
 import { VERSION } from '../version.js';
+// 남의 저장소에 딸려 온 mcp.json 으로 남의 프로그램을 띄우지 않는다 (다붙이기 머리말).
+import { 믿나 } from '../safety/trust.js';
 
 // 붙는 데 이만큼 넘게 걸리면 포기한다. 시작이 느려지면 안 쓰게 된다.
 export const 붙기제한 = 8000;
@@ -494,6 +496,40 @@ export async function 다붙이기(root, { offline = false, timeout = 붙기제
   if (설정.오류) return { 서버들: [], 못한것: [{ 이름: '(설정)', 왜: 설정.오류 }], 설정 };
   if (!설정.서버들.length) return { 서버들: [], 못한것: [], 설정 };
 
+  /*
+   * ── 믿는 폴더에서만 띄운다 ──────────────────────────────────────────
+   *
+   * 이 파일 머리말은 네 가지를 약속하는데(기본 꺼짐 · 자물쇠면 안 띄움 ·
+   * 감사기록 · 범위 밖이라고 말함) **정작 제일 앞 문은 없었다.**
+   *
+   * `mcp.json` 은 프로젝트 폴더에 있고, 그러니 **저장소에 같이 딸려 온다.**
+   * 남의 저장소를 clone 하고 그 안에서 deel 을 켜면, 거기 적힌 `command` 가
+   * 이 계정 권한으로 자식 프로세스가 된다. 도구 승인 화면은 안 거친다 —
+   * 모델이 부른 것이 아니라 우리가 「서버를 띄우려고」 부른 것이기 때문이다.
+   *
+   *     { "mcpServers": { "sync": { "command": "cmd", "args": ["/c", "…"] } } }
+   *
+   * 훅(safety/hooks.js)은 정확히 이 위협에 대해 `믿나(root)` 를 강제하고,
+   * 그 파일 머리말은 「MCP 와 같은 무게로 다룬다」 고 적어 두었다. 그런데
+   * 무게를 견주던 쪽에 그 문이 없었다. 프로젝트 설정(config.js)도 같은 문을
+   * 지나간다 — 남의 프로그램을 띄우는 이 자리가 셋 중 제일 무거운데 혼자
+   * 그냥 열려 있었다.
+   *
+   * 안 믿으면 **조용히 넘어가지 않는다.** 못 붙였다고 화면에 그대로 말하고,
+   * 어떻게 하면 되는지(deel trust)까지 같이 말한다.
+   */
+  if (!믿나(root, { env })) {
+    return {
+      서버들: [],
+      못한것: 설정.서버들.map((s) => ({
+        이름: s.이름,
+        왜: '믿는 폴더가 아닙니다 — 남의 저장소에 딸려 온 설정일 수 있어 안 띄웁니다 (deel trust)',
+      })),
+      설정,
+      안믿음: true,
+    };
+  }
+
   // 자물쇠가 걸려 있으면 아예 안 띄운다. 자식 프로세스가 어디로 나가는지
   // 우리는 못 막는다 — 막을 수 없는 것을 막았다고 말하지 않는다.
   if (offline) {

package/src/backend/probe.js

@@ -41,7 +41,7 @@ const READ_TOOL = {
  *   · 도구가 {type:'function', function:{…}} 모양으로 간다
  *   · 답을 choices[0].message 에서 찾는다 (실제로는 content 블록 배열)
  *
- * 첫 칸(기본 대화)이 400 으로 죽으면 나머지 일곱 칸은 전부 「확인 불가」 로
+ * 첫 칸(기본 대화)이 400 으로 죽으면 나머지 여덟 칸은 전부 「확인 불가」 로
  * 건너뛴다. 그 결과 `deel setup` 이 저장하는 프로필에 streaming·tools·json·
  * vision 이 **다 false** 로 적힌다 — Claude 를 붙였는데 도구를 아예 안 쓰는
  * 연결이 만들어진다. 붙기는 붙으니 아무도 고장이라고 생각하지 않는다.
@@ -140,7 +140,7 @@ export async function probe(conn, onStep = () => {}) {
    * 붙어 있어서, 그대로 이으면
    * `.../deployments/gpt-4o?api-version=2024-10-21/chat/completions` 가 된다.
    * 그러면 **설치 화면이 제 검사에 통째로 실패한다** — 기본 대화가 안 되니
-   * 나머지 일곱 칸이 다 '확인 불가' 로 건너뛰어지고, 프로필에는 스트리밍도
+   * 나머지 여덟 칸이 다 '확인 불가' 로 건너뛰어지고, 프로필에는 스트리밍도
    * 도구 호출도 안 된다고 적힌다. 붙기는 붙는데 반쪽짜리로 붙는다.
    */
   const url = (p) => 주소붙이기(base, p);