deel-local-cli 1.13.1 → 1.15.0

package/src/agent/threads.js

@@ -27,6 +27,8 @@
 // 한 줄기로 읽어서, 서로 상관없는 대화가 한 덩어리가 된다.
 
 /** 이름이 없을 때 붙여 줄 이름. 사람이 목록에서 알아볼 수 있으면 된다. */
+import { 파일기억 } from './filemem.js';
+
 function 기본이름(n) { return `갈래 ${n}`; }
 
 export class Threads {
@@ -49,9 +51,20 @@ export class Threads {
      * 돌아오는데 남은 할 일은 안 돌아왔다.
      */
     첫store?.살림따라가기?.(session);
+    /*
+     * 파일기억·filesRead 도 **갈래 것**이다.
+     *
+     * 이 둘은 「messages 안에 무엇이 살아 있나」 의 그림자다. messages 를
+     * 갈래마다 따로 두면서 이것만 세션에 하나로 두면 반드시 어긋나고, 어긋나면
+     * 「앞에서 읽은 그대로입니다」 가 **그 글이 없는 갈래에서** 나온다 —
+     * 모델은 대화 어디에도 없는 글을 가리키는 쪽지를 받고, 다시 읽어도 파일이
+     * 안 바뀌었으니 같은 쪽지를 받는다. 세 번째에 헛돈다고 턴이 죽는다.
+     * (agent/filemem.js 머리말의 「통째로 다시 싣는 것보다 훨씬 나쁘다」)
+     */
     this.갈래들 = [{
       이름: '본줄기', messages: session.messages, usage: session.usage, todos: ctx?.todos ?? null,
       할일: session.할일, 이번요청: session.이번요청, store: 첫store,
+      파일기억: session.파일기억, filesRead: session.filesRead,
     }];
     this.자리 = 0;
     this.센것 = 1;
@@ -72,6 +85,9 @@ export class Threads {
     // 적어 버린다 — 이어받을 때 하지도 않은 일이 본줄기에 남는다.
     g.할일 = this.session.할일;
     g.이번요청 = this.session.이번요청;
+    // 읽은 파일 기억도 같이 — 까닭은 생성자에 적어 뒀다.
+    g.파일기억 = this.session.파일기억;
+    g.filesRead = this.session.filesRead;
   }
 
   /** 갈래 하나를 화면으로 꺼낸다. */
@@ -83,6 +99,15 @@ export class Threads {
     if (this.ctx) this.ctx.todos = g.todos;
     this.session.할일 = g.할일 ?? [];
     this.session.이번요청 = g.이번요청 ?? '';
+    /*
+     * 여기서 session.파일기억 을 통째로 갈아 끼운다.
+     *
+     * 이미 잊기() 를 부르는 자리들(compact.js · loop.js · session.js)은 전부
+     * session.파일기억 을 거치므로 손댈 것이 없다 — 그때그때 지금 갈래의 것을
+     * 잊는다. 문이 하나로 남는다.
+     */
+    if (g.파일기억) this.session.파일기억 = g.파일기억;
+    if (g.filesRead) this.session.filesRead = g.filesRead;
     // 적는 자리도 지금 갈래의 파일로 옮긴다 (agent/store.js 의 살림따라가기).
     g.store?.살림따라가기?.(this.session);
     // 상태줄이 지금 어느 갈래인지 보여 줄 수 있게 남긴다.
@@ -110,6 +135,14 @@ export class Threads {
       할일: [],
       이번요청: '',
       store,
+      /*
+       * 갈라낸 것이면 지금 기억을 **베껴** 물려준다. 같이 쓰면 한쪽에서 파일을
+       * 다시 읽은 것이 다른 쪽 답을 바꾼다 — 갈라낸 쪽에서 v3 을 읽으면
+       * 본줄기가 「안 바뀌었다」 고 답하기 시작한다. 본줄기에 실린 것은 v1 인데도.
+       * 빈 갈래면 빈 기억이다. 대화가 비었으니 기억할 것도 없다.
+       */
+      파일기억: 물려줄것 ? (this.session.파일기억?.베끼기?.() ?? new 파일기억()) : new 파일기억(),
+      filesRead: 물려줄것 ? new Map(this.session.filesRead ?? []) : new Map(),
     };
     this.갈래들.push(g);
     // 갈라낸 것은 지금까지 오간 말을 새 파일에도 적어 둔다. 안 적으면 그 갈래를

package/src/cmdnames.js

@@ -0,0 +1,68 @@
+// 슬래시 명령 이름표. 이름과 인자 유무만 — 사람이 읽는 글은 i18n 쪽에 있다.
+//
+// ── 왜 파일이 따로인가 ──────────────────────────────────────────────────
+//
+// 이 표를 보고 싶은 자리가 commands.js 바깥에도 있다. `deel run /이름` 이
+// 그렇다 — 비대화 모드는 「이 이름이 대화 화면 전용인가」 를 알아야 "모르는
+// 명령" 대신 "그건 대화 화면에서만 됩니다" 라고 말해 줄 수 있다.
+//
+// 그렇다고 oneshot.js 가 commands.js 를 부를 수는 없다. 그쪽은 대화 화면
+// 한 벌을 통째로 끌고 온다 — 미리보기 서버 · 클립보드 · 화면 그리기까지.
+// 배치로 도는 길에 그것이 딸려 들어오면 켜는 데만 시간이 늘고, 언젠가 그
+// 안의 무엇이 사람을 기다리기 시작하면 배치가 그 자리에서 선다. 이 파일이
+// 들여오는 것이 하나도 없는 것은 그래서다 — 표는 그냥 표다.
+//
+// desc·arg 를 게터로 만드는 일(COMMANDS)은 commands.js 에 그대로 뒀다.
+// 그쪽은 i18n 을 부르므로 여기 두면 이 파일이 더는 순수한 표가 아니다.
+
+export const 명령들 = {
+  help: { arg: false },
+  clear: { arg: false },
+  context: { arg: false },
+  ctx: { arg: true },
+  out: { arg: true },
+  grade: { arg: true },
+  compact: { arg: false },
+  model: { arg: true },
+  think: { arg: true },
+  mode: { arg: true },
+  work: { arg: true },
+  auto: { arg: false },
+  code: { arg: false },
+  plan: { arg: false },
+  architect: { arg: false },
+  debug: { arg: false },
+  ask: { arg: false },
+  orchestrator: { arg: false },
+  undo: { arg: true },
+  diff: { arg: true },
+  preview: { arg: true },
+  tools: { arg: false },
+  skills: { arg: true },
+  plugin: { arg: true },
+  cost: { arg: false },
+  status: { arg: false },
+  scan: { arg: true },
+  thread: { arg: true },
+  learned: { arg: true },
+  pin: { arg: true },
+  evidence: { arg: true },
+  commit: { arg: true },
+  review: { arg: false },
+  paste: { arg: false },
+  sessions: { arg: false },
+  recall: { arg: true },
+  mcp: { arg: false },
+  memory: { arg: true },
+  level: { arg: true },
+  bell: { arg: true },
+  keys: { arg: false },
+  motion: { arg: true },
+  consult: { arg: true },
+  lang: { arg: true },
+  lsp: { arg: true },
+  export: { arg: true },
+  init: { arg: false },
+  exit: { arg: false },
+  quit: { arg: false },
+};

package/src/commands.js

@@ -13,7 +13,9 @@ import { 지금모드, 바깥인가, 나갈수있나 } from './safety/runmode.js
 import { 주소가리기 } from './safety/secrets.js';
 import { pick, confirm } from './ui/prompt.js';
 import { load, save, 저장시도, resolveKey, upsert, 열쇠보관, configPath } from './config.js';
-import { 지금상태 as 지금열쇠상태 } from './safety/authcmd.js';
+import { 지금상태 as 지금열쇠상태, 받기설정, 잊기 as 받은열쇠잊기 } from './safety/authcmd.js';
+// 열쇠받기 명령을 정책이 못박아 뒀을 수 있다 — 받기설정 이 그 값을 같이 본다.
+import { 정책읽기 } from './safety/policy.js';
 import { 제공자고르기 } from './providers/index.js';
 import { 종, 알릴만한초 } from './ui/notify.js';
 /*
@@ -69,81 +71,13 @@ import { readTextFull } from './tools/fsutil.js';
 import { 띄우기, 브라우저로 } from './preview/serve.js';
 import { 클립보드그림, 그림앉히기 } from './tools/clipboard.js';
 import { 크기말 } from './backend/vision.js';
+import { 명령들 } from './cmdnames.js';
 const MODES = {
   auto: '자율 — 전부 알아서. 되돌리기가 안전망',
   confirm: '확인 — 되돌릴 수 없는 것만 물어봄',
   strict: '엄격 — 파일 변경·명령 전부 물어봄',
 };
 
-/*
- * 슬래시 명령 목록.
- *
- * ── 왜 설명이 여기 없나 ─────────────────────────────────────────────────
- *
- * 이름과 인자 유무만 여기 두고, **사람이 읽는 글은 i18n/ko.js 에 있다.**
- * 명령 이름은 원래부터 영어였는데(help·model·undo…) 그 옆의 설명이 전부
- * 한글이라, 저장소를 처음 연 영어권 사람은 `/help` 를 쳐 봐도 무엇을 하는
- * 명령인지 알 수가 없었다. 그래서 설명만 갈아 끼울 수 있게 뺐다.
- *
- * desc·arg 를 **게터로** 둔다. 켤 때 한 번 읽어 굳히면 /lang 으로 바꿔도
- * 목록이 안 따라오고, 그러면 바뀐 것처럼 보이다가 안 바뀐 자리가 남는다.
- * 볼 때마다 지금 언어로 읽는 편이 어긋날 자리가 없다.
- *
- * 없는 열쇠는 열쇠 이름이 그대로 나온다 — 빈칸이 아니다. 명령을 새로 넣고
- * ko.js 에 적는 것을 빠뜨리면 `cmd.foo.desc` 가 화면에 찍혀서 바로 눈에 띈다.
- * (검사도 그걸 잡는다.)
- */
-const 명령들 = {
-  help: { arg: false },
-  clear: { arg: false },
-  context: { arg: false },
-  ctx: { arg: true },
-  out: { arg: true },
-  grade: { arg: true },
-  compact: { arg: false },
-  model: { arg: true },
-  think: { arg: true },
-  mode: { arg: true },
-  work: { arg: true },
-  auto: { arg: false },
-  code: { arg: false },
-  plan: { arg: false },
-  architect: { arg: false },
-  debug: { arg: false },
-  ask: { arg: false },
-  orchestrator: { arg: false },
-  undo: { arg: true },
-  diff: { arg: true },
-  preview: { arg: true },
-  tools: { arg: false },
-  skills: { arg: true },
-  plugin: { arg: true },
-  cost: { arg: false },
-  status: { arg: false },
-  scan: { arg: true },
-  thread: { arg: true },
-  learned: { arg: true },
-  pin: { arg: true },
-  evidence: { arg: true },
-  commit: { arg: true },
-  review: { arg: false },
-  paste: { arg: false },
-  sessions: { arg: false },
-  recall: { arg: true },
-  mcp: { arg: false },
-  memory: { arg: true },
-  level: { arg: true },
-  bell: { arg: true },
-  keys: { arg: false },
-  motion: { arg: true },
-  consult: { arg: true },
-  lang: { arg: true },
-  lsp: { arg: true },
-  export: { arg: true },
-  init: { arg: false },
-  exit: { arg: false },
-  quit: { arg: false },
-};
 
 /**
  * 화면에 낼 명령표. desc·arg 는 볼 때마다 지금 언어로 읽는다.
@@ -499,7 +433,7 @@ export async function handle(line, session, ctx) {
       }
 
       const { 있는것, 없는것 } = 둘러보기();
-      const 뿌리것 = ctx?.scope?.root ? 프로젝트갈래(ctx.scope.root) : null;
+      const 뿌리것 = ctx?.scope?.root ? await 프로젝트갈래(ctx.scope.root) : null;
       const 떠있는것 = 지금것들();
       say('');
       if (있는것.length) {
@@ -2684,6 +2618,9 @@ function 모델급(session, arg = '') {
 
   if (값 === 'auto' || 값 === '자동') {
     session.급정한것 = null;
+    // 급은 턴마다 한 번만 맨다(session.js 의 급 머리말). 사람이 여기서 정한
+    // 것은 다음 턴이 아니라 **지금** 먹어야 하니 빗장을 풀어 준다.
+    session.급다시재기?.();
     const g = session.급();
     say('');
     say(`  ${c.cyan('◈')} 모델 급을 다시 ${c.bold('스스로 잡게')} 했습니다 — 지금은 ${c.white(g.급)}`);
@@ -2693,6 +2630,7 @@ function 모델급(session, arg = '') {
 
   if (값 && 별명[값]) {
     session.급정한것 = 별명[값];
+    session.급다시재기?.();
     const v = session.급값();
     say('');
     say(`  ${c.cyan('◈')} 모델 급을 ${c.bold(별명[값])} 으로 정했습니다.`);
@@ -2853,7 +2791,47 @@ function 연결적용(session, p, ctx = null) {
     kind: p.kind, base: p.baseUrl, auth: p.auth, key: resolveKey(p), model: p.model,
     ctx: p.ctx, maxTokens: p.maxTokens ?? null,
     streaming: p.streaming, tools: p.tools, json: p.json, think: p.think,
+    /*
+     * ── 이 두 줄이 없어서 회사 토큰이 남의 창구로 나갔다 ────────────────
+     *
+     * conn 을 짓는 자리는 넷이다 — repl.js · oneshot.js · acp/serve.js, 그리고
+     * 여기. 앞의 셋은 이 둘을 넣는데 여기만 빠져 있었다. 그래서 `/model` 로
+     * 갈아타면 **옛 프로필의 것이 그대로 남았다.**
+     *
+     *   회사 프로필(열쇠받기로 SSO 토큰을 받아 온다) → /model 남의창구
+     *     · 살아 있는 회사 토큰이 `Authorization` 에 실려 남의 host 로 간다
+     *     · 새 프로필의 제 열쇠(conn.key)는 **쓰이지도 않는다** —
+     *       adapter.js 의 머리말짓기 는 열쇠받기가 있으면 그쪽을 쓴다
+     *     · 남의 창구는 그 토큰을 모르니 401, 그러면 로그인 명령을 다시 돌린다
+     *
+     * 반대쪽도 같다. 맨 프로필에서 회사 프로필로 옮기면 열쇠받기가 null 로
+     * 남아 401 뒤에 열쇠를 다시 받는 길이 잠긴다(adapter.js 의 열쇠다시받을까).
+     *
+     * vision 도 같은 값이다 — 안 옮기면 그림을 못 보는 모델에 그림을 보낸다.
+     */
+    열쇠받기: 받기설정(p, { 정책값: 정책읽기().값 }),
+    vision: p.vision ?? false,
   });
+  /*
+   * 들고 있던 토큰도 버린다.
+   *
+   * 열쇠받기 설정을 새것으로 갈아도, authcmd.js 가 **모듈 전역 하나**에
+   * 받은 토큰을 들고 있다(받은것). 어느 프로필 것인지는 안 적혀 있다. 그래서
+   * 안 버리면 새 창구의 첫 요청에 옛 회사 토큰이 그대로 실려 나간다 — 위에서
+   * 고친 것을 캐시가 도로 되돌리는 셈이다.
+   *
+   * 이 함수의 머리말이 「검사와 `/model` 갈아타기가 부른다」 라고 적혀 있었는데
+   * 부르는 곳이 검사밖에 없었다. 이제 적힌 대로가 된다.
+   */
+  받은열쇠잊기();
+  /*
+   * 급도 다시 맨다.
+   *
+   * 급은 conn 을 보고 매긴다(agent/grade.js 의 매김). 모델을 갈아탔는데 앞
+   * 모델로 매긴 급을 턴 끝까지 들고 있으면, 화면에 적힌 급과 프롬프트에 실린
+   * 급이 서로 다른 모델 이야기가 된다.
+   */
+  session.급다시재기?.();
   // 자물쇠도 같이 옮긴다. 이걸 빼먹으면 옛 주소가 열린 채로 남고 새 주소는 막혀
   // 다음 한마디에서 바로 "허용되지 않은 주소" 가 난다.
   allowEndpoint(p.baseUrl);

package/src/lsp/servers.js

@@ -193,13 +193,17 @@ export function 둘러보기(env = process.env) {
  *
  * 뿌리마다 한 번만 센다. 폴더 훑기는 값이 있고, 세션 중에 언어가 바뀌지 않는다.
  */
-export function 프로젝트갈래(뿌리, env = process.env) {
+export async function 프로젝트갈래(뿌리, env = process.env) {
+  // 센 것이 아니라 **세는 약속**을 담아 둔다. 훑기가 비동기라, 다 세고 나서
+  // 담으면 겹쳐 부른 쪽이 둘 다 빈 칸을 보고 둘 다 훑는다 — 에디터에서 탭을
+  // 한꺼번에 열면 실제로 그렇게 된다.
   if (_센것.has(뿌리)) return _센것.get(뿌리);
+  const 약속 = (async () => {
   let 답 = null;
   try {
     const 셈 = new Map();
     const 첫파일 = new Map();
-    for (const f of walk(뿌리, { limit: 4000 })) {
+    for (const f of await walk(뿌리, { limit: 4000 })) {
       const g = 갈래(f.path);
       if (!g) continue;
       셈.set(g, (셈.get(g) ?? 0) + 1);
@@ -210,8 +214,10 @@ export function 프로젝트갈래(뿌리, env = process.env) {
       if (고르기(g, env)) { 답 = { 갈래: g, 대표파일: 첫파일.get(g), 개수: 셈.get(g) }; break; }
     }
   } catch { 답 = null; }
-  _센것.set(뿌리, 답);
   return 답;
+  })();
+  _센것.set(뿌리, 약속);
+  return 약속;
 }
 
 /** 시험이 쓴다 — 폴더를 새로 만들고 다시 셀 때. */

package/src/oneshot.js

@@ -24,7 +24,8 @@ import { 말 as 옮긴말 } from './i18n/index.js';
 import { 알림채움 } from './backend/retry.js';
 import { 전선붙이기, 세션이름짓기 } from './backend/wire.js';
 import { newId } from './agent/store.js';
-import { discover } from './skills/discover.js';
+import { discover, loadCommand } from './skills/discover.js';
+import { 명령들 } from './cmdnames.js';
 import { allowEndpoint, setOffline } from './safety/network.js';
 import { 지금모드, 바깥인가, 나갈수있나 } from './safety/runmode.js';
 import { 주소가리기 } from './safety/secrets.js';
@@ -259,6 +260,65 @@ export async function runOnce(opts = {}) {
   session.commands = found.commands;
   session.plugins = found.plugins;
 
+  /*
+   * ── `deel run /이름` ──────────────────────────────────────────────────
+   *
+   * 사람이 대화 화면에서 쓰던 슬래시 명령을 배치에서도 그대로 부르게 한다.
+   * `.claude/commands/배포점검.md` 를 만들어 두고 아침마다 손으로 `/배포점검`
+   * 을 치고 있었으면, 그걸 야간 잡에 옮기는 데 드는 일이 이것 하나다.
+   *
+   * 여태는 `/배포점검` 이 **그냥 글자로** 모델에게 갔다. 슬래시가 붙은 낱말
+   * 하나를 받은 모델은 대개 "무슨 뜻인지 모르겠다" 고 답하고 0 으로 끝난다 —
+   * 아무 일도 안 했는데 배치는 초록불이다. 이 파일이 제일 피하려는 결말이다.
+   *
+   * 세 갈래로 끝난다.
+   *   · 이 PC 에 파일로 있는 명령이면 → 본문을 펴서 그것을 시킨다
+   *   · 대화 화면 전용 이름(/help·/undo…)이면 → 여기선 안 된다고 말하고 1
+   *   · 아무것도 아니면 → 모르는 명령이라고 말하고 1
+   * 두 실패 모두 **종료코드가 0 이 아니다.** 스크립트가 보는 것은 그 숫자다.
+   *
+   * 첫 낱말에 슬래시·역슬래시가 또 있으면 명령이 아니라 경로다(`/mnt/d/일감`).
+   * 그건 건드리지 않고 시킨 말 그대로 둔다 — commands.js 의 경로처럼보이나 와
+   * 같은 기준이다.
+   */
+  if (시킬말.startsWith('/')) {
+    const [부른이름 = '', ...나머지] = 시킬말.slice(1).trim().split(/\s+/);
+    const 경로인가 = 부른이름.includes('/') || 부른이름.includes('\\');
+    if (부른이름 && !경로인가) {
+      const 인자 = 나머지.join(' ');
+      const 낮춘 = 부른이름.toLowerCase();
+      /*
+       * 붙박이 이름을 **먼저** 본다 — 대화 화면과 차례가 같아야 한다.
+       *
+       * commands.js 는 switch 로 붙박이를 먼저 받고, 못 받은 것만 default 에서
+       * 찾아 쓴다. 그래서 대화 화면의 `/help` 는 언제나 도움말이다. 여기서
+       * 차례를 뒤집으면 이 PC 에 `ralph-loop:help` 같은 플러그인 명령이 깔린
+       * 순간 `deel run /help` 만 딴 것을 부른다 — 같은 글자가 창에 따라 다른
+       * 일을 하는 것이 제일 나쁘다. 깔린 것에 따라 뜻이 흔들리면 안 된다.
+       */
+      const 붙박이 = !!명령들[낮춘];
+      // 찾는 차례는 대화 화면과 같다 — 적은 그대로 · 대소문자 무시 · 꼬리 이름.
+      const 찾은 = 붙박이 ? null : (found.commands.find((x) => x.name === 부른이름)
+        ?? found.commands.find((x) => x.name.toLowerCase() === 낮춘)
+        ?? found.commands.find((x) => x.name.split(':').pop() === 낮춘));
+      if (붙박이) {
+        return 못함('repl-only', `/${부른이름} 은 대화 화면에서만 도는 명령입니다.`
+          + ' 여기서 되는 것은 파일로 적어 둔 슬래시 명령뿐입니다 (.claude/commands · .deel/commands).');
+      } else if (찾은) {
+        const { text, error } = loadCommand(찾은, 인자);
+        if (error) return 못함('command-read', `/${부른이름} 을 읽지 못했습니다 — ${error}`);
+        곁(`  ${c.cyan('⌘')} ${찾은.name} ${c.gray(찾은.source)}`);
+        시킬말 = text;
+      } else {
+        const 비슷 = found.commands
+          .filter((x) => x.name.includes(낮춘) || 낮춘.includes(x.name.split(':').pop()))
+          .slice(0, 5).map((x) => '/' + x.name);
+        return 못함('no-command', `모르는 명령 /${부른이름}`
+          + (비슷.length ? ` — 비슷한 것: ${비슷.join('  ')}` : ' — 이 폴더에서 찾은 슬래시 명령이 없습니다.'));
+      }
+    }
+  }
+
   // ── 물어보는 자리를 전부 막는다 ────────────────────────────────────────
   //
   // 여기가 이 파일의 핵심이다. 물어보는 함수 하나라도 기다리게 두면 그것 하나로

package/src/pack/selfpack.js

@@ -199,7 +199,7 @@ export function reviewSheet(a, at, { lang = 언어() } = {}) {
   L.push('         아예 띄우지 않습니다.');
   L.push('');
   L.push('   --offline 으로 켜면 [B]·[C]·[D] 가 모두 막히고, 이 컴퓨터 안으로만 다닙니다.');
-  L.push('   (검증: npm test 안의 network / web / mcp 검사 123항목이 이를 확인합니다)');
+  L.push('   (검증: npm test 안의 network / web / mcp 검사가 이를 확인합니다 — 항목 수는 그 출력에 있습니다)');
   L.push('');
 
   L.push('4. 스킬·플러그인');
@@ -209,7 +209,20 @@ export function reviewSheet(a, at, { lang = 언어() } = {}) {
   L.push('   (검증: npm test 안의 no-bundle 검사가 이를 확인합니다)');
   L.push('');
 
-  L.push(`5. 담긴 파일 ${a.files.length}개 — SHA-256`);
+  L.push('5. 검사가 무엇을 지키는가');
+  L.push(줄());
+  L.push('   검사가 초록이라는 것은 「아무도 안 깨졌다」 는 뜻이지 「깨면 잡힌다」 는 뜻이');
+  L.push('   아닙니다. 이 둘은 겉으로 구별이 안 되는데 값어치는 정반대입니다.');
+  L.push('   그래서 지켜야 할 줄을 일부러 어긋내 놓고, 짝지은 검사가 빨개지는지 되잽니다.');
+  L.push('   무엇을 어긋내는지와 「그러면 무슨 일이 나는지」 는 test/mutants.json 에 적어');
+  L.push('   두었습니다 — 살림 폴더 통째로 지우기 · 되돌리기 스냅샷 · ACP 문 파리티 ·');
+  L.push('   도움말의 종료코드 표가 그 안에 있습니다. 하나라도 안 잡히면 실패입니다.');
+  L.push('   (검증: npm run mutate — 잡은 수와 샌 수가 그 출력에 있습니다)');
+  L.push('   검사와 이 목록은 이 묶음에 안 들어 있습니다 — 묶음에는 도는 코드만 담습니다.');
+  L.push('   저장소에서 보실 수 있습니다: https://github.com/jysvai/deel-local-cli');
+  L.push('');
+
+  L.push(`6. 담긴 파일 ${a.files.length}개 — SHA-256`);
   L.push(줄());
   const w = Math.max(...a.files.map((f) => f.path.length));
   for (const f of a.files) {

package/src/pack/sheet.en.js

@@ -106,7 +106,7 @@ export function reviewSheetEn(a, at, probes) {
   L.push('         filtering its requests, --offline does not start the server at all.');
   L.push('');
   L.push('   Starting with --offline blocks [B], [C] and [D]; traffic stays on this machine.');
-  L.push('   (Verified by the network / web / mcp checks in npm test - 123 assertions.)');
+  L.push('   (Verified by the network / web / mcp checks in npm test; the count is in that output.)');
   L.push('');
 
   L.push('4. Skills and plugins');
@@ -116,7 +116,21 @@ export function reviewSheetEn(a, at, probes) {
   L.push('   (Verified by the no-bundle check in npm test.)');
   L.push('');
 
-  L.push(`5. ${a.files.length} files shipped - SHA-256`);
+  L.push('5. What the tests actually guard');
+  L.push(rule());
+  L.push('   A green test run means "nothing broke", not "breaking it would be caught".');
+  L.push('   The two look identical and are worth the opposite.');
+  L.push('   So we deliberately break the lines that matter and check that the paired test');
+  L.push('   turns red. What gets broken, and what would go wrong if it stayed broken, is');
+  L.push('   written down in test/mutants.json - deleting the whole .deel folder, undo');
+  L.push('   snapshots, ACP door parity, and the exit-code table are among them.');
+  L.push('   A single survivor fails the run.');
+  L.push('   (Verified by npm run mutate; killed and survived counts are in that output.)');
+  L.push('   The tests and that list are not in this package - it ships only running code.');
+  L.push('   Read them in the repository: https://github.com/jysvai/deel-local-cli');
+  L.push('');
+
+  L.push(`6. ${a.files.length} files shipped - SHA-256`);
   L.push(rule());
   const w = Math.max(...a.files.map((f) => f.path.length));
   for (const f of a.files) {

package/src/repl.js

@@ -411,7 +411,7 @@ export async function chatLoop(opts = {}) {
    * 답이 바뀌지 않는다. 아무것도 안 깔아 준다 — 있으면 쓰고 없으면 없는 대로
    * Grep·Outline 으로 간다 (lsp/servers.js 머리말).
    */
-  session.lsp = 언어서버있나(root);
+  session.lsp = await 언어서버있나(root);
   // 지난 대화에서 정해 둔 것을 들고 시작한다.
   // 기억은 Session 이 켤 때 직접 읽는다 (session.js 생성자) — deel run 도 같은 것을 들고 시작하게.
 

package/src/safety/guard.js

@@ -466,7 +466,25 @@ export function 경로낱말(cmd) {
     t = t.replace(/^[<>]+/, '');
     if (!t) continue;
     const 풀린 = 자리표풀기(t);
-    const 경로같나 = 풀린.includes('/') || 풀린.includes('\\') || /^[a-zA-Z]:$/.test(풀린);
+    /*
+     * ── 맨 낱말 `.deel` 도 자리로 친다 ──────────────────────────────────
+     *
+     * 이 필터는 `/` 나 `\` 가 있어야 「자리」 로 쳤다. 그래서 `rm -rf .deel`
+     * 의 `.deel` 은 **후보로도 안 잡혔다.** checkPaths 는 이 목록 안에서만
+     * 내부살림() 을 부르므로, 내부살림 을 아무리 고쳐도 이 철자는 안 걸린다.
+     *
+     * 그 결과가 이랬다 — 같은 파일을 지우는 두 명령이 서로 다른 답을 받았다.
+     *
+     *   rm -rf .deel/history   → 막힘
+     *   rm -rf .deel           → 통과
+     *
+     * 그래서 이 이름 하나만 예외로 둔다. **품고 있는 것이 아니라 그 이름
+     * 자체**일 때만이다 — `.deelignore` 는 다른 파일이고, `my.deel.txt` 도
+     * 남의 파일이다. 넓히다 반대로 베면 모델이 까닭 없이 무언가를 못 하게
+     * 되는데, 그것을 신고해 줄 사람이 없다.
+     */
+    const 살림이름 = 풀린 === '.deel' || 풀린.toLowerCase() === '.deel';
+    const 경로같나 = 풀린.includes('/') || 풀린.includes('\\') || /^[a-zA-Z]:$/.test(풀린) || 살림이름;
     if (!경로같나) continue;
     /*
      * 남은 자리표가 있으면(우리가 못 푼 것) **어디로 갈지 모른다.** 울타리
@@ -639,3 +657,58 @@ const MUTATING = /(^|[|;&]\s*)(sudo\s+)?(git\s+(commit|push|merge|rebase|reset)|
 export function isMutating(cmd) {
   return MUTATING.test(String(cmd));
 }
+
+/*
+ * 셸이 **파일에 쓰는 꼴**인가 — 스냅샷을 뜰지 정하는 데만 쓴다.
+ *
+ * ── 왜 MUTATING 을 넓히지 않고 새로 만드나 ──────────────────────────────
+ *
+ * MUTATING 은 세 곳에서 쓰인다.
+ *
+ *   tools/index.js:307   스냅샷을 뜰지            ← 넓히고 싶은 곳
+ *   agent/loop.js:1214   같은 명령을 두 번 안 돌린다
+ *   agent/loop.js:1255   엄격 모드에서 물어본다
+ *
+ * 아래 것들을 MUTATING 에 넣으면 뒤의 두 곳이 같이 넓어진다. `echo x > log`
+ * 마다 승인 창이 뜨고, 두 번째 `echo` 가 「다시 실행하지 않습니다」 로 막힌다.
+ * 고치려던 것보다 나쁜 것이 생긴다. 그래서 **쓰임이 하나뿐인 술어**를 따로 둔다.
+ *
+ * ── 왜 넉넉해도 되나 ────────────────────────────────────────────────────
+ *
+ * 여기서 잘못 걸리면 안 떠도 될 파일을 하나 더 뜨는 것뿐이다. MUTATING 에서
+ * 잘못 걸리면 멀쩡한 명령이 막힌다. 값이 다른 두 실수라, 이쪽은 넉넉히 잡는다.
+ * `echo "a > b"` 처럼 글 안의 부등호까지 걸려도 손해가 스냅샷 한 장이다.
+ *
+ * ── 왜 이 목록이 필요했나 ───────────────────────────────────────────────
+ *
+ * 열한 가지 파일 고치기를 재 보니 MUTATING 에는 `rm` 하나만 걸렸다.
+ *
+ *   O rm f.js
+ *   X echo x > f.js      X printf x >> f.js     X sed -i s/a/b/ f.js
+ *   X tee f.js           X truncate -s 0 f.js   X dd of=f.js
+ *   X node -e "…"        X python -c "…"        X npx prettier --write src/
+ *   X git checkout -- f.js
+ *
+ * 즉 모델이 셸에서 파일을 고치는 **흔한 방법 전부**가 스냅샷 없이 지나갔다.
+ * 그리고 스냅샷이 없으면 그 턴은 기록을 한 줄도 안 남겨서, /undo 가 그 턴의
+ * 존재를 모르고 **앞의 무관한 턴**을 되돌린 뒤 성공했다고 적었다.
+ * (검사: test/undo.test.js 의 「셸쓰기-다른턴을-되돌리던-것」)
+ */
+const 셸쓰기무늬 = [
+  />{1,2}\s*(?![&>])\S/,                       // echo x > f · printf x >> f  (2>&1 은 & 라 안 걸린다)
+  /\bsed\s+(-[a-z]*i\b|--in-place)/i,          // sed -i · sed --in-place
+  /\bperl\s+(-[a-z]*i\b|--in-place)/i,
+  /\btee\b/i,
+  /\b(set-content|add-content|out-file)\b/i,   // 파워셸
+  /\btruncate\b/i,
+  /\bdd\b[^|;&]*\bof=/i,
+  /--write\b/i,                                // prettier --write 류
+  /\bpatch\b/i,
+  /\bgit\s+(checkout\s+--|restore)\b/i,        // 작업 트리를 되돌리는 것도 파일을 바꾼다
+];
+
+/** 이 명령이 파일 내용을 바꿀 낌새인가. **스냅샷 판단에만** 쓴다. */
+export function 셸이파일에쓰나(cmd) {
+  const s = String(cmd ?? '');
+  return 셸쓰기무늬.some((무늬) => 무늬.test(s));
+}

package/src/safety/undo.js

@@ -1,7 +1,7 @@
 // 되돌리기. 승인 프롬프트를 안 쓰는 대신 이게 안전망이다.
 // 파일을 고치기 전에 항상 이전 내용을 떠 놓고, /undo 로 턴 단위로 되돌린다.
 import { join, dirname } from 'node:path';
-import { readFileSync, writeFileSync, existsSync, mkdirSync, rmSync, appendFileSync, statSync } from 'node:fs';
+import { readFileSync, writeFileSync, existsSync, mkdirSync, rmSync, appendFileSync, statSync, chmodSync } from 'node:fs';
 import { looksBinary } from '../tools/encoding.js';
 import { 말 } from '../i18n/index.js';
 
@@ -12,9 +12,40 @@ const KEEP_TURNS = 50;
 export class History {
   constructor(root) {
     this.dir = join(root, '.deel', 'history');
-    mkdirSync(this.dir, { recursive: true });
+    // 폴더부터 본인 것으로. 파일만 잠그고 폴더가 0755 면 이름은 다 보인다.
+    mkdirSync(this.dir, { recursive: true, mode: 0o700 });
     this.file = join(this.dir, 'edits.jsonl');
     this.turn = 0;
+    /** 잠근 결과. 밖에서 볼 수 있어야 「잠갔다」 는 말이 뜻을 갖는다. */
+    this.잠금 = null;
+  }
+
+  /*
+   * ── 이 파일은 남의 파일 **원문**을 담는다 ───────────────────────────────
+   *
+   * 되돌리려면 고치기 전 내용을 그대로 들고 있어야 한다. 그래서 여기에는
+   * `.env` · `id_rsa` · `.npmrc` · kubeconfig 가 **평문으로** 들어온다.
+   * 가리지도 않는다 — 가리면 되돌릴 때 사람의 진짜 열쇠가 표로 덮여 없어진다.
+   * 즉 이 자리에서 지키는 방법은 파일 권한 하나뿐인데, 그것이 없었다.
+   *
+   * umask 022 인 리눅스·맥에서 이 파일은 0644 로 만들어진다. 같은 PC 의 다른
+   * 계정, 데몬, 공유 홈(NFS)의 아무나가 deel 이 손댄 모든 파일의 원문을 읽는다
+   * — 주인이 일부러 0600 으로 잠가 둔 파일까지. `.deel` 아래 다른 기록
+   * (agent/store.js · safety/audit.js)은 전부 잠그는데 여기만 안 잠갔다.
+   *
+   * 1.14.0 에서 셸 쓰기(`sed -i` · `echo >` · `tee`)까지 스냅샷을 뜨게 하면서
+   * 들어오는 파일이 더 늘었다. 고친 것이 이 구멍을 넓힌 셈이라 같이 막는다.
+   *
+   * 윈도우(NTFS)에서는 chmod 가 아무 일도 안 한다. 거기서는 못 잠근 것이지
+   * 잠근 척하지 않는다 — 그래서 결과를 `잠금` 에 있는 그대로 남긴다.
+   * (safety/audit.js · agent/store.js 와 같은 모양이다)
+   */
+  #잠갔나 = false;
+  #잠그기() {
+    if (this.#잠갔나) return;
+    this.#잠갔나 = true;
+    try { chmodSync(this.file, 0o600); this.잠금 = { 모드: 0o600 }; }
+    catch (err) { this.잠금 = { 못함: err?.code ?? String(err) }; }
   }
 
   /**
@@ -73,6 +104,7 @@ export class History {
     if (뜬것.enc) rec.enc = 뜬것.enc;
     if (뜬것.skipped) rec.skipped = 뜬것.skipped;
     appendFileSync(this.file, JSON.stringify(rec) + '\n', 'utf8');
+    this.#잠그기();
     this.#이번턴.set(absPath, rec);
     this.#maybePrune();
     return rec;
@@ -109,6 +141,8 @@ export class History {
     if (!버린수) return 0;
     try {
       writeFileSync(this.file, 남길것.map((r) => JSON.stringify(r)).join('\n') + (남길것.length ? '\n' : ''), 'utf8');
+      // 통째로 다시 쓰면 새 파일일 수 있다 — 빗장을 다시 건다 (agent/store.js 도 같다).
+      this.#잠갔나 = false; this.#잠그기();
     } catch { return 0; }
     return 버린수;
   }
@@ -199,6 +233,7 @@ export class History {
     const 못한것 = new Set(restored.filter((x) => x.ok === false).map((x) => x.path));
     const keep = recs.filter((r) => !turns.includes(r.turn) || 못한것.has(r.path));
     writeFileSync(this.file, keep.map((r) => JSON.stringify(r)).join('\n') + (keep.length ? '\n' : ''), 'utf8');
+    this.#잠갔나 = false; this.#잠그기();
     return {
       restored,
       // 화면·감사기록이 쓰는 수. **진짜로 되돌아간 것만** 센다.