deel-local-cli 1.20.7 → 1.20.9

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-9%2C491%20passing-1a7f37?logo=checkmarx&logoColor=white)](docs/ko/develop.md)
+[![tests](https://img.shields.io/badge/tests-9%2C762%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.20.7  ⌂ 이 안
+ deel 1.20.9  ⌂ 이 안
  보냄    이 컴퓨터 안 127.0.0.1:11434  ← 여기 말고는 어디로도 안 갑니다
 ```
 
@@ -1289,6 +1289,8 @@ zip 은 진짜 `unzip` 으로, tar 는 진짜 `tar` 가 만든 것을 읽혀 교
 
 | 판 | 무엇이 바뀌었나 |
 |---|---|
+| [1.20.9](docs/ko/releases/1.20.md#1209) | 안 보이는 것이 아니라 다른 것이 보이고 있었습니다 |
+| [1.20.8](docs/ko/releases/1.20.md#1208) | 못 쟀다는 것을 안 된다고 적고 있었습니다 |
 | [1.20.7](docs/ko/releases/1.20.md#1207) | 서버가 말해 준 것과 반대를 배우고 있었습니다 |
 | [1.20.6](docs/ko/releases/1.20.md#1206) | 2차 리뷰가 판을 조용히 잃고 있었습니다 |
 | [1.20.5](docs/ko/releases/1.20.md#1205) | `aws_access_token` 이 안 잡히고 있었습니다 |

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-9%2C491%20passing-1a7f37?logo=checkmarx&logoColor=white)](docs/en/develop.md)
+[![tests](https://img.shields.io/badge/tests-9%2C762%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.20.7  ⌂ inside
+ deel 1.20.9  ⌂ inside
  Sends to this machine 127.0.0.1:11434  ← nowhere else
 ```
 
@@ -1350,6 +1350,8 @@ so one run tells you everything.
 
 | Version | What changed |
 |---|---|
+| [1.20.9](docs/en/releases/1.20.md#1209) | Nothing was missing from the screen — something else was on it |
+| [1.20.8](docs/en/releases/1.20.md#1208) | We were writing down "can't" where the truth was "couldn't measure" |
 | [1.20.7](docs/en/releases/1.20.md#1207) | We were learning the opposite of what the server said |
 | [1.20.6](docs/en/releases/1.20.md#1206) | The second review was losing rounds silently |
 | [1.20.5](docs/en/releases/1.20.md#1205) | `aws_access_token` was not being caught |

package/bin/deel.js

@@ -701,6 +701,33 @@ async function main() {
 
   if (flags.help || cmd === 'help') { help(); return 0; }
 
+  /*
+   * `--work` 에 오타가 났으면 **여기서 멈춘다.**
+   *
+   * 모르는 이름은 조용히 기본값(종합)으로 떨어진다. 그런데 종합은 Write·Edit·
+   * Bash 를 다 가진 모드다 — `deel --work architcet` 한 번으로, 파일을 안
+   * 건드리는 모드로 켠 줄 알고 **고칠 수 있는 상태**로 돌게 된다. 화면에
+   * 남는 단서는 상태줄 글자 하나뿐이다.
+   *
+   * 대화 중에 치는 `/work` 는 관대하게 받아도 된다(틀리면 바로 화면에 뜨고
+   * 다시 치면 된다). 깃발은 한 번 켜면 그 세션이 끝까지 그걸로 간다.
+   *
+   * 판 번호·도움말보다 뒤에 둔다 — 그 둘은 무엇을 잘못 쳤든 답해야 한다.
+   */
+  if (flags.work !== undefined && flags.work !== true) {
+    const { normalize: 모드이름, MODES: 모드들, 보일이름: 모드보임 } = await import('../src/agent/modes.js');
+    if (!모드이름(String(flags.work))) {
+      const 있는것 = Object.keys(모드들).map((k) => `${모드보임(k)}(${k})`).join(' · ');
+      say('');
+      say(`  그런 작업 모드가 없습니다: ${String(flags.work)}`);
+      say(`  있는 것: ${있는것}`);
+      say('');
+      say('  그냥 켜면 「종합」 으로 돕니다 — 그건 파일을 고칠 수 있는 모드입니다.');
+      say('');
+      return 2;
+    }
+  }
+
   switch (cmd) {
     // 한 번만 돌고 끝난다. 스크립트·배치에서 부르는 자리다.
     //

package/package.json

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

package/src/agent/compact.js

@@ -105,7 +105,9 @@ export const 캐시일때비울몫 = 0.10;
  * 늦어질 뿐이고, 있는데 없다고 치면 방금 만든 캐시를 깬다. 그래서 모르는
  * 쪽은 덜 잃는 쪽으로 기울인다.
  *
- * 두 번 넘게 불렀는데도 읽힌 것이 하나도 없으면, 그때는 정말 없는 것이다.
+ * **두 번** 불렀는데도 읽힌 것이 하나도 없으면, 그때는 정말 없는 것이다.
+ * (여기가 「두 번 넘게」 라고 적혀 있었다. 아래 셈은 두 번째에 이미 단정한다 —
+ * 한 번의 차이지만, 적힌 것과 하는 것이 다르면 다음 사람이 그 값을 못 믿는다.)
  */
 export const 재볼기회 = 2;
 
@@ -163,7 +165,37 @@ export function foldImages(session, { keep = KEEP_IMAGES } = {}) {
   const 자리 = [];
   ms.forEach((m, i) => { if (그림장수(m)) 자리.push(i); });
 
-  const 뺄것 = 자리.slice(0, Math.max(0, 자리.length - keep));
+  /*
+   * ── 남기는 것은 **장수**다, 메시지 수가 아니다 ─────────────────────────
+   *
+   * `KEEP_IMAGES` 는 위 머리말대로 「최근 몇 **장**」 이다. 그런데 자리를
+   * 메시지 단위로 세고 거기서 keep 을 빼고 있었다. 그래서 한 메시지에 여러
+   * 장이 실리면(`@a.png @b.png @c.png` 를 한 줄로 붙이면 그렇게 된다)
+   * **남는 장수가 keep 을 훌쩍 넘었다.**
+   *
+   *   석 장 실린 메시지 + 한 장 실린 메시지  →  자리가 둘이라 한 장도 안 뺀다
+   *                                            (남는 것은 넉 장. keep 은 둘)
+   *
+   * 몇 MB 짜리 사진 셋이 「최근 둘만 남긴다」 는 이름 아래 그대로 남는다.
+   *
+   * ── 그러면서도 한 덩이는 쪼개지 않는다 ────────────────────────────────
+   *
+   * 사람이 한 번에 붙인 사진들은 한 이야기다. 그 안에서 어느 장이 더 오래된
+   * 것인지 알 길도 없다. 그래서 **마지막 덩이는 몇 장이든 남기고**, 그보다
+   * 앞엣것은 장수를 더해 keep 을 안 넘을 때만 남긴다. 마지막 덩이를 빼지
+   * 않는 까닭: 방금 보여 준 사진을 그 자리에서 없애면 그 턴이 헛턴이 된다.
+   */
+  let 남긴장수 = 0;
+  let 첫남길자리 = 자리.length;
+  for (let k = 자리.length - 1; k >= 0; k--) {
+    const 이번장수 = 그림장수(ms[자리[k]]);
+    // 마지막 덩이는 무조건 남긴다. 그 뒤로는 넘치면 거기서 끊는다.
+    if (k < 자리.length - 1 && 남긴장수 + 이번장수 > keep) break;
+    남긴장수 += 이번장수;
+    첫남길자리 = k;
+  }
+
+  const 뺄것 = 자리.slice(0, 첫남길자리);
   const 뺀것들 = [];
   for (const i of 뺄것) {
     const m = ms[i];
@@ -174,7 +206,14 @@ ${접힘표} 그림 ${장수}장은 자리를 비우려고 뺐습니다. 필요
     delete ms[i].images;
     뺀것들.push({ 장수 });
   }
-  return { 뺀것: 뺄것.length, 뺀것들 };
+  /*
+   * `뺀것` 은 **장수**다.
+   *
+   * 여기가 `뺄것.length` — 곧 **메시지 수**였다. 화면은 이 값을 「그림 N장을
+   * 뺐습니다」 로 적으므로, 한 메시지에서 넉 장을 뺀 판에 「1장」 이라고
+   * 떴다. 사람이 세어 볼 수 있는 숫자라 틀리면 바로 거짓이 된다.
+   */
+  return { 뺀것: 뺀것들.reduce((a, x) => a + x.장수, 0), 뺀메시지: 뺄것.length, 뺀것들 };
 }
 
 export function shouldFold(session, at = null) {
@@ -241,8 +280,21 @@ export function foldToolResults(session, { keep = KEEP_RECENT, min = FOLD_MIN,
       * 같은 것을 두 번 뽑을 까닭이 없다 — 한 번 뽑아서 같이 들고 간다.
       */
      const 아는것 = 이름표.get(첫?.id) ?? null;
+     /*
+      * 이름은 **한 메시지에 실린 것 전부**를 들고 간다.
+      *
+      * 아래 「마지막 할 일 목록은 안 접는다」 가 이 이름을 본다. 그런데
+      * 첫 것만 들고 가면, 모델이 한 턴에 `Read` 와 `TodoWrite` 를 같이 부른
+      * 판에서 — Anthropic 꼴은 그 결과 둘을 **한 메시지**에 싣는다 —
+      * 이름이 'Read' 로 잡혀 할 일 목록이 지킴 목록에서 빠진다. 그러면
+      * 그 자리가 접히면서 남은 항목이 어디에도 없어진다.
+      *
+      * 아래 머리말이 「접는 순간 남은 항목이 어디에도 없어진다」 고 적어 둔
+      * 바로 그 일이, 도구를 둘 같이 부른 판에서만 조용히 일어났다 (35차 리뷰).
+      */
+     const 이름들 = 것들.map((x) => 이름표.get(x?.id)?.name ?? x?.name ?? '').filter(Boolean);
      자리.push({
-       i, 글,
+       i, 글, 이름들,
        이름: 아는것?.name ?? 첫?.name ?? '',
        args: 아는것?.args ?? {},
      });
@@ -262,7 +314,7 @@ export function foldToolResults(session, { keep = KEEP_RECENT, min = FOLD_MIN,
    * 남겨 둘수록 해롭다. 지키는 것은 **마지막 하나**뿐이고, 목록 하나는
    * 몇백 글자라 자리도 거의 안 먹는다.
    */
-  const 지킬할일 = 자리.filter((x) => x.이름 === 'TodoWrite').at(-1)?.i ?? -1;
+  const 지킬할일 = 자리.filter((x) => x.이름들.includes('TodoWrite')).at(-1)?.i ?? -1;
 
   const 접을것 = 자리
     .slice(0, Math.max(0, 자리.length - keep))
@@ -296,7 +348,31 @@ export function foldToolResults(session, { keep = KEEP_RECENT, min = FOLD_MIN,
    * 100자도 안 된다). 그래서 이 수는 언제나 **새로 접을 것**의 수다.
    */
   const 예상이득 = 접을것.reduce((a, x) => a + estimateTokens(x.글), 0);
-  if (예상이득 < 넘을것 || 접을것.length < keep) {
+  /*
+   * ── 개수를 기다리는 것이 손해가 되는 판 ────────────────────────────────
+   *
+   * 위 개수 문턱은 「3천 토큰 아끼려고 앞머리를 깨지 말라」 는 말이다. 맞는
+   * 말인데, **아낄 것이 3만 토큰일 때도** 똑같이 기다렸다. 큰 파일 읽기 셋이
+   * 쌓인 판에서 접기를 미루면 그 다음 안전망은 80% 요약 압축이고, 그쪽은
+   * 대화를 **통째로 요약으로 갈아 치우는** 훨씬 비싼 일이다. 개수를 기다리다
+   * 더 큰 것을 치르는 셈이다.
+   *
+   * 그래서 기다림을 **값으로** 판단한다. 앞머리를 깨는 값은 **접은 뒤에**
+   * 그 자리부터 다시 보내야 하는 토큰이다 — 캐시에서 싸게 읽던 것을 정가로
+   * 다시 쓴다. 아끼는 것이 그보다 크면 지금 접는 것이 이득이라, 개수를 더
+   * 기다리지 않는다.
+   *
+   * 접기 전 양에서 아끼는 양을 뺀다. 접을 글 자체를 대가로 세면 안 된다 —
+   * 그건 접은 뒤에 사라지는 것이라, 세는 순간 늘 「기다려라」 가 나온다.
+   */
+  const 깰자리 = 접을것[0]?.i ?? -1;
+  const 깨는값 = 깰자리 < 0 ? Infinity
+    : Math.max(0, ms.slice(깰자리).reduce((a, m) => a + estimateTokens(
+      도구결과인가(m) ? 결과들(m).map((x) => x.글).join('\n')
+        : (typeof m.content === 'string' ? m.content : JSON.stringify(m.content ?? '')),
+    ), 0) - 예상이득);
+  const 기다릴까 = 접을것.length < keep && 예상이득 <= 깨는값;
+  if (예상이득 < 넘을것 || 기다릴까) {
     return {
       접은것: 0, 아낀토큰: 0, 접은것들: [], 미룸: true,
       모인것: 예상이득, 모인개수: 접을것.length, 넘을것,
@@ -352,7 +428,18 @@ export function foldToolResults(session, { keep = KEEP_RECENT, min = FOLD_MIN,
    */
   return {
     접은것: 접을것.length, 아낀토큰: Math.max(0, 아낀토큰), 접은것들,
-    캐시다시씀: 캐시가도나(session),
+    /*
+     * 화면에 「캐시를 다시 씁니다」 를 적을까.
+     *
+     * `캐시가도나()` 를 그대로 쓰고 있었다. 그 함수는 **결정**을 위해 모르는
+     * 쪽을 「있다」 로 기울인다(그 머리말) — 그래서 첫 턴에는, 캐시가 아예
+     * 없는 창구에서도 늘 참이었다. 그러면 화면은 「값과 지연이 한 번 튑니다」
+     * 라고 겁을 주는데 잃을 캐시가 애초에 없다.
+     *
+     * 결정은 기울여도 되지만 **화면은 아는 것만 적는다.** 캐시를 정말 읽어
+     * 본 적이 있을 때만 말한다 (35차 리뷰).
+     */
+    캐시다시씀: (session?.usage?.cacheRead ?? 0) > 0,
   };
 }
 
@@ -525,7 +612,15 @@ export async function compact(session, { auto = false, signal = null, onBackoff
      * 「앞에서 읽은 그대로입니다」 를 내밀면 모델은 대화에 없는 글을 가리키는
      * 쪽지만 받는다. 통째로 다시 싣는 것보다 훨씬 나쁘다.
      */
-    if (folded > 0) session.파일기억?.잊기();
+    /*
+     * 읽은 파일 수도 같이 내린다.
+     *
+     * 아래 성공한 길은 `filesRead.clear()` 도 하는데 이쪽은 안 했다. 그 표는
+     * `/context` 가 「도구 결과 N개」 로 세는 자리라(agent/session.js), 물러선
+     * 뒤에는 **대화에 없는 파일까지 세어 보여 줬다.** 사람이 자리를 왜 이만큼
+     * 쓰는지 그 화면으로 판단하는데, 거기 없는 것이 섞여 있으면 안 된다.
+     */
+    if (folded > 0) { session.파일기억?.잊기(); session.filesRead?.clear?.(); }
     const after = session.breakdown().used;
     return {
       ok: folded > 0, folded, before, after, fallback: true,

package/src/agent/evolve.js

@@ -298,10 +298,27 @@ export class 배움 {
     return out.length > 1 ? out.join('\n') : null;
   }
 
-  /** 사람이 지우라고 한 것. 파일째 비운다. */
+  /**
+   * 사람이 지우라고 한 것. 파일째 비운다.
+   *
+   * ── `'전선'` 은 왜 따로 있나 ───────────────────────────────────────────
+   *
+   * 전선 모양은 **틀리게 배울 수 있는 유일한 것**이다 (backend/wire.js 의
+   * 배울전선: "잘못 배우는 것은 못 배우는 것보다 나쁘다"). 게이트웨이가
+   * 한동안 잘못 답했거나 우리가 문구를 잘못 읽으면, 멀쩡한 기능이 꺼진 채
+   * 디스크에 굳는다 — 그리고 그 창구에서는 영영 그대로다.
+   *
+   * 그런데 되돌릴 길이 **「쌓아 둔 것 전부 비우기」 하나**였다. 그러면 몇 주
+   * 걸려 쌓은 명령 겪음과 토큰 보정까지 같이 날아간다. 그 값이 아까워서
+   * 사람은 안 비우고, 안 비우니 꺼진 기능을 그냥 안고 쓴다.
+   *
+   * 그래서 전선만 지운다. 다음 요청에서 짐작으로 다시 시작하고, 서버가
+   * 여전히 거절하면 같은 것을 다시 배운다 — 잃을 것이 없다.
+   */
   지우기(어디 = '전부') {
     if (어디 === '전부' || 어디 === '폴더') { this.폴더 = 빈것(); this.#저장폴더(); }
     if (어디 === '전부' || 어디 === '모델') { this.집 = 빈것(); this.#저장집(); }
+    if (어디 === '전선') { this.집.전선 = {}; this.#저장집(); }
     return this;
   }
 

package/src/agent/models.js

@@ -36,6 +36,9 @@ import { load, activeProfile, resolveKey } from '../config.js';
 import { isLocalHost, isOffline } from '../safety/network.js';
 import { 잠잠기본, 무소식기본, 연결기본 } from '../backend/http.js';
 import { 인증서설정 } from '../backend/clientcert.js';
+import { 받기설정 } from '../safety/authcmd.js';
+// 열쇠받기 명령을 정책이 못박아 뒀을 수 있다 — 받기설정 이 그 값을 같이 본다.
+import { 정책읽기 } from '../safety/policy.js';
 
 // 컨텍스트를 못 알아냈을 때 쓰는 값. repl.js 와 같은 값을 봐야 한다.
 export const CTX_DEFAULT = 32768;
@@ -67,6 +70,25 @@ export function 연결만들기(prof, { ctx = null, maxTokens = null } = {}) {
     tools: prof.tools ?? false,
     json: prof.json ?? false,
     think: prof.think ?? false,
+    /*
+     * ── 이 두 줄을 빼면 회사 프로필로는 물어볼 수가 없다 ────────────────
+     *
+     * conn 을 짓는 자리는 다섯이다 — repl.js · oneshot.js · acp/serve.js ·
+     * commands.js 의 연결적용, 그리고 여기. 앞의 넷은 이 둘을 넣는데 여기만
+     * 빠져 있었다. 이 함수를 쓰는 자리가 둘인데 **둘 다 남에게 넘기는
+     * 자리**다 — /consult 로 한 번 물어보기, Task 로 하위에 떼어 주기.
+     *
+     * 열쇠를 명령으로 받아 오는 프로필(SSO 토큰)은 prof.key 가 비어 있다.
+     * 그래서 열쇠받기 없이 지으면 Authorization 이 안 실려 401 이 나고,
+     * 열쇠를 다시 받는 길도 잠긴다(adapter.js 의 열쇠다시받을까 는
+     * conn.열쇠받기 를 본다). `/model 회사창구` 는 되는데 `/consult
+     * 회사창구` 만 안 되는, 까닭이 화면에 안 적히는 꼴이 된다.
+     *
+     * vision 도 같다 — 안 넣으면 그림을 볼 수 있는 모델에 하위 작업을
+     * 떼어 주면서 그림을 못 보는 것으로 친다.
+     */
+    열쇠받기: 받기설정(prof, { 정책값: 정책읽기().값 }),
+    vision: prof.vision ?? false,
   };
 }
 

package/src/agent/modes.js

@@ -115,7 +115,7 @@ export const MODES = {
     id: 'auto',
     hintEn: "picks the right mode for what you ask",
     sayEn: "You are in **Auto** mode. What comes next is not fixed.\n\n- Work out what kind of job this is first, then do it that way.\n  If it is an edit, read before editing. If it is a diagnosis, confirm before concluding.\n  If it is an explanation, back it with the files.\n- For a large job, break it into steps with TodoWrite and **finish everything you wrote down.**\n  Do not write the list and then ask. If there are several chunks, hand them off with Task —\n  a subtask runs in its own window, so yours does not fill up.\n- For code you did not write, get the shape with Outline. Use Grep to gather every place it\n  touches, then Read **only around the lines you found** (offset/limit). Do not read whole\n  files - pour it all in at once and the earlier turns fold away, and you answer having\n  forgotten them.\n- Fire unrelated reads **together in one message.** Read tools run side by side; one call at\n  a time adds that many round trips, and that is the waiting the person feels.\n- Making several files: one Write call (files array). Do not call it once per file.\n  Several places to edit: one Edit call the same way (edits array).\n- Commands that never end (dev servers, watch) need background: true on Bash. Called plainly\n  they die on timeout. After starting one, read its output with Jobs, and end it with Jobs when done.\n- Verify what can be verified — call Verify. Do not call something done that you did not check.\n- Do what the job needs. Do not start work the job did not ask for.",
-    say짧게En: "**Auto** mode. What comes next is not fixed.\n- Work out what kind of job this is, then do it that way.\n- Large job: break it up with TodoWrite and **finish it all.** Several chunks: hand off with Task.\n- Code you did not write: Outline -> Grep -> Read **only around what you found** (offset/limit).\n- Fire unrelated reads together in one message - they run side by side.\n- Several files: one Write (files array). Several edits: one Edit (edits array).\n- Commands that never end (dev server, watch): background: true on Bash. Read with Jobs, end with Jobs.\n- Verify before you finish. Do not call something done that you did not check.",
+    say짧게En: "**Auto** mode. What comes next is not fixed.\n- Work out what kind of job this is, then do it that way.\n- Large job: break it up with TodoWrite and **finish it all.** Several chunks: hand off with Task.\n- Code you did not write: Outline -> Grep -> Read **only around what you found** (offset/limit).\n- Fire unrelated reads together in one message - they run side by side.\n- Several files: one Write (files array). Several edits: one Edit (edits array).\n- Commands that never end (dev server, watch): background: true on Bash. Read with Jobs, end with Jobs.\n- Verify before you finish. Do not call something done that you did not check.\n- Do what the job needs. Do not start work the job did not ask for.",
     name: '종합',
     en: 'Auto',
     glyph: '◎',
@@ -132,6 +132,9 @@ export const MODES = {
       '- 파일 여러 개는 Write 한 번에 (files 배열), 고칠 자리 여럿은 Edit 한 번에 (edits 배열).',
       '- 끝내지 않는 명령(dev 서버·watch)은 Bash 에 background: true. Jobs 로 읽고 끝낸다.',
       '- 끝내기 전에 Verify. 확인 못 한 것을 됐다고 하지 마라.',
+      // 「빠진 규칙은 없다」 는 위 주석대로 되려면 이 줄이 있어야 한다.
+      // 시키지 않은 일을 벌이는 것은 작은 창에서 더 비싸다.
+      '- 시키는 일을 해라. 시키지 않은 일을 벌이지 마라.',
     ].join('\n'),
     say: [
       '지금은 **종합** 모드다. 무슨 일이 올지 정해져 있지 않다.',
@@ -206,6 +209,7 @@ export const MODES = {
     id: 'architect',
     hintEn: "shapes the structure · touches no files",
     sayEn: "This is **design**. You have not been given the tools that change files.\n\nRead first. Designing without knowing the current structure is imagining, not designing.\n  - Start with Outline for the shape of the folder. Narrow with Glob/Grep, then Read\n    **only around the lines you found** (offset/limit). Read whole files and the earlier\n    ones fold away after a handful - then you have not seen the structure, only the last file\n  - Fire unrelated reads together in one message - they run side by side\n  - Work out what depends on what, and in which direction\n\nThen answer in this order.\n  1. Current structure — files, their roles, where the boundaries are (point with path:line)\n  2. What is wrong — why the current shape does not hold\n  3. Two or three options — what each gains, what each costs, how much work it is\n  4. One recommendation with the reason, and why you dropped the others\n  5. The files this affects\n\nFind the answer inside the conventions this code already uses. Bringing in a new framework is\nthe last resort, and if you go there, first say why the existing conventions cannot do it.",
+    say짧게En: "**Design** mode. You have no tools that change files.\n- Read first — designing without the current structure is imagining, not designing.\n  Outline -> Glob/Grep -> Read **only around what you found** (offset/limit). Never whole files.\n  Fire unrelated reads together in one message. Work out what depends on what, and which way.\n- Answer in this order: 1) current structure (path:line) 2) what is wrong 3) two or three options\n  (what each gains, costs, how much work) 4) one recommendation with the reason, and why you dropped\n  the others 5) the files this affects.\n- Find it inside the conventions this code already uses. A new framework is the last resort — if you\n  go there, first say why the existing conventions cannot do it.",
     name: '설계',
     en: 'Architect',
     glyph: '◈',
@@ -213,6 +217,16 @@ export const MODES = {
     tools: [...읽기, ...계획],
     effort: 'deep',
     think: 'high',
+    say짧게: [
+      '**설계** 모드다. 파일을 바꾸는 도구는 없다.',
+      '- 먼저 읽어라 — 구조를 모르면 설계가 아니라 상상이다.',
+      '  Outline → Glob/Grep → **짚은 자리 앞뒤만** Read (offset·limit). 통째로 읽지 마라.',
+      '  상관없는 읽기는 한 번에 같이 부른다. 무엇이 무엇에 기대는지(의존 방향)를 본다.',
+      '- 이 차례로 답한다: 1) 지금 구조(경로:줄) 2) 무엇이 문제인가 3) 선택지 2~3개(얻는 것·잃는',
+      '  것·드는 손) 4) 추천 하나와 버린 이유 5) 영향받는 파일.',
+      '- 이 코드가 이미 쓰는 관례 안에서 찾아라. 새 틀은 마지막 수단이고, 그때는 기존 관례로',
+      '  왜 안 되는지 먼저 밝혀라.',
+    ].join('\n'),
     say: [
       "지금 하는 일은 **설계**다. 파일을 바꾸는 도구는 주어지지 않았다.",
       "",
@@ -238,7 +252,11 @@ export const MODES = {
   ask: {
     id: 'ask',
     hintEn: "explains only · changes nothing",
-    sayEn: "This is **explanation**. You change nothing.\n\n- Back it with the files. Give the path and line number (src/a.js:42).\n- If you do not know, say so. Do not invent a plausible answer.\n- Keep it short. Answer what was asked.\n- Do not propose fixes unless asked to fix something. Do not start work you were not asked for.",
+    // 영어 쪽이 「Keep it short」 로 남아 있었다. 한국어는 그 말 때문에 여러
+    // 가지를 물으면 몇 가지가 빠지던 것을 고쳐 「물음의 크기에 맞춰라」 로
+    // 바꿨는데, 영어는 안 바꿔서 **영어로 쓰는 사람에게만 옛 결함이 남아
+    // 있었다.** 읽는 절차도 빠져 있어 읽어야 나오는 답을 짐작으로 냈다.
+    sayEn: "This is **explanation**. You change nothing.\n\n- Back it with the files. Give the path and line number (src/a.js:42).\n- If you do not know, say so. Do not invent a plausible answer.\n- **Match the size of the answer to the size of the question.** One line asked, one line back;\n  several things asked, every one of them answered. Short is not the goal.\n- If it takes reading to answer, read — Outline -> Grep -> Read **only around what you found**.\n  Fire unrelated reads together in one message.\n- Do not propose fixes unless asked to fix something. Do not start work you were not asked for.",
     name: '묻기',
     en: 'Ask',
     glyph: '◇',
@@ -364,6 +382,7 @@ export const MODES = {
     id: 'debug',
     hintEn: "finds the cause",
     sayEn: "This is **finding the cause**. Do not fix by guessing.\n\nFollow this order.\n  1. Restate the symptom in one sentence — what happens when you do what.\n  2. Get a reproduction. If there is none, build one. Without it you cannot tell whether you fixed it.\n  3. Form two or three hypotheses. For each, write down what you should see if it is true.\n  4. Check them one at a time, for real — read the logs, run something small, print the value.\n     Only what you checked is fact. What you did not check is still a hypothesis.\n     If several hypotheses turn on reading alone, read for all of them in one message.\n  5. When you name the cause, bring the evidence. A cause that starts with \"probably\" is not a cause.\n  6. After fixing, run the reproduction from step 2 again. If it is not fixed, go back to step 3.\n\nDo not change several places at once. You will not know which one fixed it.",
+    say짧게En: "**Finding the cause.** Do not fix by guessing.\n1. Restate the symptom in one sentence — what happens when you do what.\n2. Get a reproduction. If there is none, build one — without it you cannot tell whether you fixed it.\n3. Form two or three hypotheses. For each, write what you should see if it is true.\n4. Check them one at a time, for real. Only what you checked is fact.\n   If several turn on reading alone, read for all of them in one message.\n5. Name the cause with the evidence. A cause that starts with \"probably\" is not a cause.\n6. After fixing, run the reproduction from step 2 again. Not fixed — back to step 3.\nDo not change several places at once. You will not know which one fixed it.",
     name: '디버그',
     en: 'Debug',
     glyph: '◉',
@@ -371,6 +390,17 @@ export const MODES = {
     tools: [...읽기, ...계획, ...쓰기, ...확인, ...쪼개기],
     effort: 'deep',
     think: 'high',
+    say짧게: [
+      '**원인 찾기** 모드다. 짐작으로 고치지 마라.',
+      '1. 증상을 한 문장으로 다시 적는다 — 무엇을 했을 때 무엇이 일어나는가.',
+      '2. 재현 방법을 확보한다. 없으면 만든다 — 재현 못 하면 고쳤는지도 알 수 없다.',
+      '3. 가설 2~3개. 각각 「맞다면 무엇이 보여야 하는가」 를 같이 적는다.',
+      '4. 하나씩 실제로 확인한다. 확인한 것만 사실이다.',
+      '   읽기로 가릴 가설이 여럿이면 한 번에 같이 읽는다 — 나란히 돈다.',
+      '5. 원인에는 증거를 같이 댄다. 「아마」 로 시작하는 원인은 원인이 아니다.',
+      '6. 고친 뒤 2번 절차로 다시 확인한다. 안 고쳐졌으면 3번으로 돌아간다.',
+      '한 번에 여러 곳을 고치지 마라 — 무엇이 고쳤는지 알 수 없게 된다.',
+    ].join('\n'),
     say: [
       "지금 하는 일은 **원인 찾기**다. 짐작으로 고치지 마라.",
       "",
@@ -391,7 +421,8 @@ export const MODES = {
   plan: {
     id: 'plan',
     hintEn: "plan first · run it after approval",
-    sayEn: "This is **planning**. You have not been given the tools that change files.\nDo not try to edit code. Produce a plan and stop.\n\nConfirm first — a plan built without knowing the current state is a wish, not a plan.\n  Start with Outline for the shape, narrow with Glob/Grep, then Read **only around the lines\n  you found** (offset/limit). Fire unrelated reads together in one message.\n\nThen write it in this order.\n  1. Goal — what does \"done\" look like (as a sentence you can check)\n  2. Current state — the files involved and what they do now (point with path:line)\n  3. What changes — per file, what and why\n  4. Order — step by step. Each step small enough to check on its own\n  5. Risks — what could break, and how to get back if it does\n  6. How to check — what do you run to know it worked\n\nWrite the steps into TodoWrite as well. After approval you continue straight from them.\n  The number of steps is not fixed — match it to the size of the job. Do not force it to three.\n  A small job ends in two or three; a large one lists all ten or more.\nIf something is unknown, do not invent it — write \"this needs to be confirmed\".\n\nEnd with \"Shall I go ahead with this?\". Once approved, switch to /code and run it.",
+    sayEn: "This is **planning**. You have not been given the tools that change files.\nDo not try to edit code. Produce a plan and stop.\n\nConfirm first — a plan built without knowing the current state is a wish, not a plan.\n  Start with Outline for the shape, narrow with Glob/Grep, then Read **only around the lines\n  you found** (offset/limit). Fire unrelated reads together in one message.\n\nThen write it in this order.\n  1. Goal — what does \"done\" look like (as a sentence you can check)\n  2. Current state — the files involved and what they do now (point with path:line)\n  3. What changes — per file, what and why\n  4. Order — step by step. Each step small enough to check on its own\n  5. Risks — what could break, and how to get back if it does\n  6. How to check — what do you run to know it worked\n\nWrite the steps into TodoWrite as well. After approval you continue straight from them.\n  The number of steps is not fixed — match it to the size of the job. Do not force it to three.\n  A small job ends in two or three; a large one lists all ten or more.\nIf something is unknown, do not invent it — write \"this needs to be confirmed\".\n\nEnd with \"Shall I go ahead with this?\".\n  You cannot make the edits in this mode — you have no tools for it. Once approved,\n  **tell the person to type `/code`** — you have no way to switch modes yourself.",
+    say짧게En: "**Planning.** You have no tools that change files. Produce a plan and stop.\n- Confirm first — a plan built without the current state is a wish, not a plan.\n  Outline -> Glob/Grep -> Read **only around what you found** (offset/limit). Unrelated reads together.\n- Write it in this order: 1) goal (a sentence you can check) 2) current state (path:line)\n  3) what changes, per file, and why 4) order — each step small enough to check on its own\n  5) risks and how to get back 6) how to check it worked.\n- Put the steps in TodoWrite too. Match the number to the size of the job — do not force it to three.\n- If something is unknown, do not invent it — write \"this needs to be confirmed\".\n- End with \"Shall I go ahead with this?\". You have no tools to make the edits, so once approved,\n  **tell the person to type `/code`** — you cannot switch modes yourself.",
     name: '계획',
     en: 'Plan',
     glyph: '☰',
@@ -399,6 +430,17 @@ export const MODES = {
     tools: [...읽기, ...계획],
     effort: 'deep',
     think: 'high',
+    say짧게: [
+      '**계획** 모드다. 파일을 바꾸는 도구는 없다. 계획을 내고 멈춘다.',
+      '- 먼저 확인하라 — 지금 상태를 모르면 계획이 아니라 희망이다.',
+      '  Outline → Glob/Grep → **짚은 자리 앞뒤만** Read (offset·limit). 상관없는 읽기는 한 번에.',
+      '- 이 차례로 적어라: 1) 목표(확인할 수 있는 문장) 2) 지금 상태(경로:줄) 3) 바꿀 것(파일별로',
+      '  무엇을 왜) 4) 순서(각 단계는 따로 확인할 수 있는 크기로) 5) 위험과 되돌리는 길 6) 확인 방법.',
+      '- 단계는 TodoWrite 로도 적어라. 수는 일의 크기에 맞춘다 — 세 개로 맞추지 마라.',
+      '- 모르는 것은 지어내지 말고 「이건 확인이 필요하다」 고 적어라.',
+      '- 「이대로 진행할까요?」 로 끝내라. 고치는 도구가 없으니, 승인을 받으면',
+      '  **사람에게 `/code` 를 치라고 적어 줘라** — 네가 모드를 바꿀 길은 없다.',
+    ].join('\n'),
     say: [
       "지금 하는 일은 **계획 세우기**다. 파일을 바꾸는 도구는 주어지지 않았다.",
       "코드를 고치려 들지 마라. 계획을 내고 멈춘다.",
@@ -420,7 +462,12 @@ export const MODES = {
       "  작은 일이면 두세 개로 끝내고, 큰 일이면 열 개가 넘어도 그대로 다 적어라.",
       "모르는 것이 있으면 지어내지 말고 \"이건 확인이 필요하다\" 고 적어라.",
       "",
-      "마지막에 \"이대로 진행할까요?\" 로 끝내라. 승인을 받으면 /code 로 바꿔 실행한다.",
+      // 모드를 바꾸는 도구는 모델에게 없다. `/code` 는 사람이 치는 명령이다.
+      // 「바꿔 실행한다」 고 적어 두면, 승인을 받은 모델이 고칠 도구도 없이
+      // 고치려 들다 아무것도 못 하고 멈춘다 — 사람은 기다리고만 있게 된다.
+      "마지막에 \"이대로 진행할까요?\" 로 끝내라.",
+      "  실제로 고치는 것은 이 모드에서 안 된다(고치는 도구가 없다). 승인을 받으면",
+      "  **사람에게 `/code` 를 치라고 적어 줘라** — 네가 모드를 바꿀 길은 없다.",
     ].join('\n'),
   },
 
@@ -473,7 +520,16 @@ export const DEFAULT = 'auto';
 export function normalize(v) {
   const s = String(v ?? '').trim().toLowerCase();
   if (!s) return null;
-  if (MODES[s]) return s;
+  /*
+   * 열쇠가 **제 것인지**를 본다.
+   *
+   * 그냥 `MODES[s]` 로 보면 `constructor`·`__proto__` 같은 이름에 물려받은
+   * 것이 잡혀 참이 된다. 그러면 그 이름이 모드로 통과하고, `get()` 이
+   * 돌려준 것에는 `tools` 가 없어 **터진다** — 하필 터지는 자리가
+   * `canWrite()` 이고, 그것은 하위 작업이 부모보다 셀 수 없게 막는
+   * 자리(tools/task.js 의 하위모드)다. 아래 별명 표도 같은 이유로 같이 막는다.
+   */
+  if (Object.hasOwn(MODES, s)) return s;
   const 별명 = {
     '종합': 'auto', '자동': 'auto', '기본': 'auto', 'auto': 'auto', '맡김': 'auto',
     '코드': 'code', 'c': 'code',
@@ -488,7 +544,7 @@ export function normalize(v) {
     'inspect': 'inspect', 'audit': 'inspect', 'review': 'inspect', 'i': 'inspect',
     '총괄': 'orchestrator', '오케': 'orchestrator', 'orch': 'orchestrator', 'o': 'orchestrator',
   };
-  return 별명[s] ?? null;
+  return Object.hasOwn(별명, s) ? 별명[s] : null;
 }
 
 export function get(id) {
@@ -502,7 +558,11 @@ export function get(id) {
  * 규칙(session.js)이 줄어드는 자리와 같은 경계다. 셋이 같이 움직여야
  * '작은 창에서는 고정 몫을 줄인다' 가 흩어진 세 결정이 아니라 한 결정이 된다.
  *
- * 짧은 판이 없는 모드는 원래 짧은 것들이다(묻기 125토큰). 그냥 그대로 쓴다.
+ * 짧은 판이 없는 것은 **묻기 하나**다(340자 — 원래 짧다). 그냥 그대로 쓴다.
+ *
+ * 앞서는 설계·디버그·계획에도 짧은 판이 없었다. 「원래 짧은 것들」 이라고
+ * 적어 두었지만 계획은 761자였다 — 작은 창에서 줄이자고 만든 자리가 정작 큰
+ * 모드에서 안 줄었다. 그래서 지금은 검사가 그 짝을 지킨다(test/modes.test.js).
  */
 export function 말(id, ctx) {
   const m = get(id);

package/src/agent/session.js

@@ -899,8 +899,18 @@ export class Session {
       { label: 옮긴말('ctx.toolResults', { n: this.filesRead.size }), n: files },
     ];
     const used = rows.reduce((a, r) => a + r.n, 0);
+    /*
+     * 창 크기를 **알아낸 것인지**도 같이 내놓는다.
+     *
+     * 안 알려 주는 창구에서는 32k 로 둔다(그래야 무엇이든 돌아간다). 그런데
+     * 화면이 그 값을 잰 것과 똑같은 낯으로 `5.6k/32k · 17%` 라고 적으면,
+     * 실제 창이 8k 인 자리에서 답이 잘리는 동안 게이지는 초록이다. 같은
+     * 상태줄이 모델 급은 짐작일 때 `◈ 보통?` 으로 흐리게 적는다 — 창 크기도
+     * 같은 규칙을 따라야 한다(ui/status.js).
+     */
+    const 잰것 = this.conn.ctx != null;
     const total = this.conn.ctx ?? 32768;
-    return { rows, used, total, left: Math.max(0, total - used) };
+    return { rows, used, total, 총잰것: 잰것, left: Math.max(0, total - used) };
   }
 
   /**
@@ -918,6 +928,7 @@ export class Session {
       rows,
       used,
       total: 날것.total,
+      총잰것: 날것.총잰것,
       left: Math.max(0, 날것.total - used),
       보정: this.보정,
       보정잰것: this.보정잰것,