deel-local-cli 1.7.0 → 1.10.0

package/src/oneshot.js

@@ -11,14 +11,15 @@
 //   그래서 '묻는 자리' 를 전부 없앤 길을 따로 낸다. 에이전트 루프는 그대로 쓴다 —
 //   여기서 루프를 다시 짜면 두 벌이 되고, 언젠가 한쪽만 고쳐진다.
 import { c, mark, clip } from './ui/ansi.js';
-import { 규칙모으기 } from './safety/policy.js';
+import { 규칙모으기, 정책읽기 } from './safety/policy.js';
+import { 받기설정 } from './safety/authcmd.js';
 import { run } from './agent/loop.js';
 import { Session } from './agent/session.js';
 import { makeScope } from './safety/guard.js';
 import { 모두끄기 as 언어서버다끄기 } from './lsp/client.js';
 import { History } from './safety/undo.js';
-import { Audit } from './safety/audit.js';
-import { activeProfile, load, resolveKey, 잠금소식 } from './config.js';
+import { Audit, 열쇠묻기 } from './safety/audit.js';
+import { activeProfile, load, resolveKey, 잠금소식, 열쇠탈소식 } from './config.js';
 import { 말 as 옮긴말 } from './i18n/index.js';
 import { 알림채움 } from './backend/retry.js';
 import { discover } from './skills/discover.js';
@@ -43,6 +44,15 @@ export const EXIT = {
   limit: 2,     // 도구 호출 걸음 수 상한에 닿았다
   stuck: 3,     // 같은 자리에서 헛돌아 스스로 멈췄다
   aborted: 4,   // 도중에 끊겼다 (Ctrl+C)
+  /*
+   * 서버가 끝났다는 말을 한 번도 안 주고 답을 멈췄다.
+   *
+   * 여기에 자기 코드가 있어야 한다. 전에는 이걸 아예 안 보고 `done`(0) 으로
+   * 끝냈다. `deel -p` 는 잡·CI 에서 돌고 그 뒤에 스크립트가 붙는데, 반쪽짜리
+   * 답이 0 으로 넘어가면 그 스크립트는 온전한 답으로 알고 그대로 쓴다.
+   * 사람이 나중에 결과를 보고 왜 반쪽인지 되짚을 방법이 없다.
+   */
+  cutoff: 5,
 };
 
 /**
@@ -63,7 +73,7 @@ async function 표준입력읽기() {
 // 도구 한 줄 요약. 화면 그림이 아니라 로그에 남을 글이라 색을 아낀다.
 function 도구줄(name, args) {
   const a = args ?? {};
-  const 첫 = a.file_path ?? a.pattern ?? a.path ?? a.url ?? a.name ?? a.목적 ??
+  const 첫 = a.file_path ?? a.pattern ?? a.path ?? a.url ?? a.name ?? a.purpose ?? a.목적 ??
     (a.command ? String(a.command).replace(/\s+/g, ' ') : null) ??
     // 뒤에서 도는 명령. 번호가 곧 그 일감의 이름이라, 이게 없으면 기록에
     // `Jobs()` 만 여러 줄 남아 나중에 무엇을 본 것인지 알 수 없다.
@@ -154,6 +164,14 @@ export async function runOnce(opts = {}) {
   const conn = {
     kind: prof.kind, base: prof.baseUrl, auth: prof.auth,
     key: resolveKey(prof), model: prof.model,
+    /*
+     * 열쇠를 갖고 있는 대신 **받아 오는** 설정 (safety/authcmd.js).
+     *
+     * 여기서는 설정만 싣는다. 명령은 요청 직전에 부른다 — 켤 때 한 번
+     * 받아 두면 한 시간짜리 토큰이 세 시간짜리 대화 한복판에서 죽고,
+     * 그 401 은 화면에서 「열쇠가 틀렸다」 와 구별이 안 된다.
+     */
+    열쇠받기: 받기설정(prof, { 정책값: 정책읽기().값 }),
     ctx: opts.ctx ?? prof.ctx ?? CTX_DEFAULT,
     // 답 길이 상한 — deel --max-tokens 32k 로 높일 수 있다(대화 화면의 /out 과 같은 값).
     maxTokens: opts.maxTokens ?? prof.maxTokens ?? null,
@@ -162,6 +180,16 @@ export async function runOnce(opts = {}) {
     vision: prof.vision ?? false,
   };
 
+  /*
+   * 잠근 열쇠를 못 풀었으면 그 까닭을 표준오류로 낸다.
+   *
+   * 배치로 부르는 쪽은 표준출력을 JSON 으로 읽으므로 거기에 섞으면 안 된다.
+   * 그렇다고 조용히 넘기면 여기가 더 나쁘다 — 아무도 안 보고 있는 자리라
+   * 401 하나 남기고 끝난다. 위 잠금소식 과 같은 자리, 같은 규칙이다.
+   */
+  const 열쇠탈 = 열쇠탈소식();
+  if (열쇠탈) { try { process.stderr.write(`  ${열쇠탈}\n`); } catch { /* 못 써도 그만 */ } }
+
   /*
    * 자물쇠는 대화 화면과 똑같이 건다. 비대화라고 느슨해질 이유가 없다 —
    * 오히려 배치는 아무도 안 보는 자리라 더 단단해야 한다.
@@ -224,7 +252,7 @@ export async function runOnce(opts = {}) {
     // 적어 둔 허락·금지 규칙 (safety/policy.js). 승인 모드보다 먼저 본다.
     규칙들: 규칙모으기(cfg),
     history: new History(root),
-    audit: new Audit(root),
+    audit: new Audit(root, { 열쇠들: 열쇠묻기(conn) }),
     seen: new Set(),
     skills: found.skills,
     loadedSkills: new Set(),
@@ -299,6 +327,8 @@ export async function runOnce(opts = {}) {
   let steps = 0;
   let 이번단계글 = '';   // 지금 단계에서 모델이 흘린 글. 단계가 바뀌면 비운다
   let 답 = null;
+  // 서버가 끝났다는 말 없이 멈춘 적이 있나. 뒤에 오는 done 이 이걸 못 지운다.
+  let 말없이끊겼나 = false;
 
   try {
     // 하위 작업 안쪽에서 온 이벤트는 그 겹만큼 들여 쓴다.
@@ -397,6 +427,50 @@ export async function runOnce(opts = {}) {
           곁(`  ${c.gray(`(접지 못했습니다: ${ev.why})`)}`);
           break;
 
+        /*
+         * ── 여기 넷은 여태 아예 안 보고 있었다 ────────────────────────
+         *
+         * 대화창은 넷 다 화면에 적어 준다. 한 방 실행은 안 적었다. 그래서
+         * 잘린 답이 **온전한 답인 척** 파이프 뒤로 넘어갔다. `deel -p` 는
+         * 잡·CI 에서 돌고 그 기록이 나중에 근거가 되는 물건이라, 여기서
+         * 빠지면 왜 반쪽인지 되짚을 자리가 아무 데도 없다.
+         */
+        case 'capped':
+          곁(`  ${c.yellow('⚠')} ${c.gray(옮긴말('ev.capped', { 한계: ev.cap.toLocaleString() }))}`);
+          break;
+
+        /*
+         * 말없이 끊긴 것은 **종료코드까지** 바꾼다.
+         *
+         * 뒤에 done 이 따라오므로 그대로 두면 0 으로 끝난다. 잘렸다는 사실을
+         * 화면에만 적고 코드로는 성공이라고 하면, 스크립트는 화면을 안 읽으니
+         * 아무 일도 없던 것이 된다. 다만 여기서 곧바로 reason 을 바꾸지는
+         * 않는다 — 뒤에 오는 done 이 덮어쓰기 때문에 표시만 해 두고
+         * 루프가 끝난 뒤에 판정한다.
+         */
+        case 'cutoff':
+          말없이끊겼나 = true;
+          곁(`  ${c.yellow('⚠')} ${c.gray(옮긴말('ev.cutoff'))}`);
+          break;
+
+        case 'nudge':
+          곁(`  ${c.gray(`↺ ${ev.why === '요청누락'
+            ? 옮긴말('ev.nudgeMissed', { n: ev.빠진?.length ?? 0 })
+            : 옮긴말('ev.nudgeRead')}`)}`);
+          break;
+
+        // 자리가 다 차서 비웠다. 오류가 아니라 이어 가는 중이라, 종료코드는 안 건드린다.
+        case 'reset':
+          곁(`  ${c.cyan('◱')} ${c.gray((ev.kept?.할일 ?? 0)
+            ? 옮긴말('ev.reset', { 버린수: ev.dropped, 할일: ev.kept.할일 })
+            : 옮긴말('ev.resetBare', { 버린수: ev.dropped }))}`);
+          break;
+        case 'learned':
+          곁(`  ${c.cyan('◎')} ${c.gray(ev.what === 'ctx'
+            ? 옮긴말('ev.learnedCtx', { 한계: ev.limit.toLocaleString() })
+            : 옮긴말('ev.learnedOut', { 한계: ev.limit.toLocaleString() }))}`);
+          break;
+
         case 'limit':
           reason = 'limit';
           why = `도구 호출 ${ev.steps}회에서 멈췄습니다. 한 번에 하기엔 큰 일입니다 — 나눠서 시키세요.`;
@@ -434,6 +508,19 @@ export async function runOnce(opts = {}) {
   // 왜 안 됐는지 짐작할 거리조차 없다.
   if (답 == null) 답 = 이번단계글;
 
+  /*
+   * 말없이 끊긴 답은 '다 됐다' 로 안 넘긴다.
+   *
+   * done 이 뒤따라오므로 그냥 두면 reason 이 done 으로 덮인다. 그런데 그
+   * 답은 중간에서 끊긴 물건이다. 여기서 갈라 주지 않으면 파이프 뒤 스크립트가
+   * 반쪽을 온전한 것으로 받아 쓴다 — 그러고도 아무 표시가 안 남는다.
+   * 진짜 탈(error·limit·stuck)이 이미 잡혔으면 그쪽이 먼저다.
+   */
+  if (말없이끊겼나 && reason === 'done') {
+    reason = 'cutoff';
+    why = 옮긴말('ev.cutoff');
+  }
+
   const code = EXIT[reason] ?? EXIT.error;
   if (why) 삐끗(`  ${reason === 'done' ? c.gray('·') : c.red('✗')} ${why}`);
   if (!json && !quiet) {

package/src/pack/sbom.js

@@ -25,6 +25,8 @@
 // 적어 둔 칸이 다 있는지 본다.
 import { randomUUID } from 'node:crypto';
 import { 보관방식 } from '../safety/keystore.js';
+import { 언어 } from '../i18n/index.js';
+import { specEn, egressEn, keyStorageEn, auditLogEn, specSummaryEn } from './sheet.en.js';
 
 /** 우리가 내놓는 SBOM 규격. 스캐너가 이 숫자를 보고 읽는 법을 정한다. */
 export const CDX판 = '1.5';
@@ -41,7 +43,7 @@ export const CDX판 = '1.5';
  * @param {Date}   o.at        만든 때 (검사가 고정할 수 있게)
  * @param {string} o.serial    문서 일련번호 (검사가 고정할 수 있게)
  */
-export function sbom(a, { at = new Date(), serial = null } = {}) {
+export function sbom(a, { at = new Date(), serial = null, lang = 언어() } = {}) {
   const purl = `pkg:npm/${a.name}@${a.version}`;
   const 본체 = {
     type: 'application',
@@ -50,7 +52,11 @@ export function sbom(a, { at = new Date(), serial = null } = {}) {
     version: a.version,
     purl,
     licenses: a.license ? [{ license: { id: a.license } }] : [],
-    description: '로컬 모델·사내 게이트웨이 전용 코딩 에이전트 CLI',
+    // SBOM 은 남에게 내는 서류다. 화면을 영어로 켜 둔 사람이 한국어 설명이
+    // 박힌 문서를 심사에 낼 수는 없다.
+    description: lang === 'ko'
+      ? '로컬 모델·사내 게이트웨이 전용 코딩 에이전트 CLI'
+      : 'A coding agent CLI for local models and in-house gateways',
   };
 
   return {
@@ -208,7 +214,20 @@ export function 감사명세() {
 /**
  * 세 가지를 한 덩이로. zip 에 이대로 들어간다.
  */
-export function 심사명세(a, { at = new Date() } = {}) {
+export function 심사명세(a, { at = new Date(), lang = 언어() } = {}) {
+  /*
+   * 한국어가 아니면 영어 서류를 낸다 (pack/sheet.en.js).
+   *
+   * 열쇠 이름까지 영어라야 뜻이 있다. 값만 옮기고 열쇠를 `통신`·`감사기록`
+   * 으로 두면, 스캐너에 넣는 사람이 무엇이 무엇인지 못 읽는다 — 반쯤 옮긴
+   * 서류는 안 옮긴 것보다 나쁘다.
+   *
+   * 일본어·중국어도 영어로 간다. i18n 의 물러날곳(ja→en→ko)과 같은 규칙이다.
+   */
+  if (lang !== 'ko') {
+    const 자리 = (id) => (a.calls?.[id] ?? []).map((x) => `${x.file}:${x.line}`);
+    return specEn(a, at, egressEn(자리, a), keyStorageEn(보관방식(null, { lang: 'en' })), auditLogEn());
+  }
   return {
     만든것: a.name,
     판: a.version,
@@ -231,9 +250,16 @@ export function 심사명세(a, { at = new Date() } = {}) {
   };
 }
 
-/** 사람이 읽을 짧은 요약. 화면에 찍는 자리에서 쓴다. */
+/**
+ * 사람이 읽을 짧은 요약. 화면에 찍는 자리에서 쓴다.
+ *
+ * 어느 말로 쓸지를 **명세 자체를 보고** 정한다. 언어() 를 여기서 또 물으면,
+ * 명세를 만든 뒤에 말이 바뀐 자리에서 요약만 딴 말이 된다 — 그러면 읽을 수
+ * 없는 열쇠에서 값을 꺼내려다 전부 0 으로 찍힌다.
+ */
 export function 명세요약(명세) {
   const m = 명세 ?? {};
+  if (!m.파일 && m.files) return specSummaryEn(m);
   return [
     `SBOM 부품     ${(m.파일?.length ?? 0).toLocaleString()}개 (전부 SHA-256 붙임)`,
     `의존성        ${(m.의존성?.dependencies?.length ?? 0)}개 · 설치 스크립트 ${(m.의존성?.설치스크립트?.length ?? 0)}개`,

package/src/pack/selfpack.js

@@ -12,12 +12,14 @@ import { join, dirname, relative } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { makeZip } from './zip.js';
 import { sbom, 심사명세 } from './sbom.js';
+import { 언어 } from '../i18n/index.js';
+import { reviewSheetEn, readMeEn } from './sheet.en.js';
 
 export const repoRoot = () => join(dirname(fileURLToPath(import.meta.url)), '..', '..');
 
 const SKIP_DIRS = new Set(['node_modules', '.git', '.github', 'test', '.deel']);
 const SHIP = ['bin', 'src'];
-const SHIP_FILES = ['package.json', 'README.md', 'README.en.md', 'LICENSE'];
+const SHIP_FILES = ['package.json', 'README.md', 'README.ko.md', 'LICENSE'];
 
 function walk(dir, base, out) {
   for (const e of readdirSync(dir, { withFileTypes: true })) {
@@ -127,7 +129,10 @@ export function audit(root = repoRoot()) {
 
 const 줄 = (n = 74) => '-'.repeat(n);
 
-export function reviewSheet(a, at) {
+export function reviewSheet(a, at, { lang = 언어() } = {}) {
+  // 한국어가 아니면 영어 서류 (pack/sheet.en.js). 같은 audit() 을 쓴다 —
+  // 말이 달라도 숫자가 달라지면 그건 서류가 거짓말을 하는 것이다.
+  if (lang !== 'ko') return reviewSheetEn(a, at, PROBES);
   const L = [];
   L.push('deel 사내 반입 심사 자료');
   L.push(줄());
@@ -221,10 +226,11 @@ export function reviewSheet(a, at) {
 /**
  * 심사서 + 소스를 zip 하나로 묶는다.
  */
-export function packSelf(outFile, { root = repoRoot(), at = new Date() } = {}) {
+export function packSelf(outFile, { root = repoRoot(), at = new Date(), lang = 언어() } = {}) {
   const a = audit(root);
   const stamp = at.toISOString().replace('T', ' ').slice(0, 19);
-  const sheet = reviewSheet(a, stamp);
+  const sheet = reviewSheet(a, stamp, { lang });
+  const 한국어 = lang === 'ko';
 
   /*
    * 사람이 읽는 것 하나, 기계가 읽는 것 둘.
@@ -233,10 +239,20 @@ export function packSelf(outFile, { root = repoRoot(), at = new Date() } = {}) {
    * 취약점 목록을 뽑고, 운영팀은 감사기록 사양을 보고 SIEM 수집 규칙을 짠다.
    * 사람이 읽는 글은 그 어느 쪽에도 못 들어간다 — 그래서 셋을 다 넣는다.
    */
+  /*
+   * 파일 이름도 같이 옮긴다.
+   *
+   * 안이 영어인데 이름이 `반입심사서.txt` 면, 받은 사람은 열기 전에 무엇인지
+   * 모르고 메일에 첨부하면 이름이 깨져서 온다. 서류의 이름은 서류의 일부다.
+   */
+  const 이름 = 한국어
+    ? { 심사서: '반입심사서.txt', 명세: '심사명세.json', 안내: '읽어주세요.txt' }
+    : { 심사서: 'import-review.txt', 명세: 'audit-spec.json', 안내: 'READ-ME-FIRST.txt' };
+
   const entries = [
-    { name: '반입심사서.txt', data: Buffer.from(sheet, 'utf8'), mtime: at },
-    { name: 'sbom.cdx.json', data: Buffer.from(JSON.stringify(sbom(a, { at }), null, 2), 'utf8'), mtime: at },
-    { name: '심사명세.json', data: Buffer.from(JSON.stringify(심사명세(a, { at }), null, 2), 'utf8'), mtime: at },
+    { name: 이름.심사서, data: Buffer.from(sheet, 'utf8'), mtime: at },
+    { name: 'sbom.cdx.json', data: Buffer.from(JSON.stringify(sbom(a, { at, lang }), null, 2), 'utf8'), mtime: at },
+    { name: 이름.명세, data: Buffer.from(JSON.stringify(심사명세(a, { at, lang }), null, 2), 'utf8'), mtime: at },
   ];
   for (const f of a.files) {
     entries.push({
@@ -247,8 +263,8 @@ export function packSelf(outFile, { root = repoRoot(), at = new Date() } = {}) {
     });
   }
   entries.push({
-    name: '읽어주세요.txt',
-    data: Buffer.from([
+    name: 이름.안내,
+    data: 한국어 ? Buffer.from([
       'deel — 로컬 모델·사내 게이트웨이 코딩 에이전트',
       '',
       '쓰는 법 (설치 절차 없음)',
@@ -265,7 +281,7 @@ export function packSelf(outFile, { root = repoRoot(), at = new Date() } = {}) {
       '',
       '  세 파일 모두 소스를 훑어 자동으로 만든 것입니다. 손으로 적은 값이 아닙니다.',
       '',
-    ].join('\n'), 'utf8'),
+    ].join('\n'), 'utf8') : Buffer.from(readMeEn(), 'utf8'),
     mtime: at,
   });
 

package/src/pack/sheet.en.js

@@ -0,0 +1,288 @@
+// 반입 심사 서류의 영어판.
+//
+// ── 왜 번역표가 아니라 딴 파일인가 ──────────────────────────────────────
+//
+// 화면 말은 열쇠 하나에 한 문장이라 i18n 표가 맞다(src/i18n). 이건 다르다.
+// **서류**다. 한 장이 통째로 하나의 글이고, 절 이름·차례·줄맞춤이 같이
+// 뜻을 만든다. 그걸 열쇠 이백 개로 쪼개 두면, 고칠 때마다 두 파일을 오가며
+// 짜맞춰야 하고 결국 한쪽만 고친 서류가 나간다.
+//
+// 이 저장소는 이미 같은 판단을 한 번 했다 — README.md 와 README.ko.md 를
+// 갈라 뒀다. 서류는 서류대로 통째로 쓰는 편이 읽기도 고치기도 낫다.
+//
+// ── 대신 어긋나지 않게 검사한다 ─────────────────────────────────────────
+//
+// 갈라 두면 한쪽만 고치는 날이 온다. 그래서 test/packlang.test.js 가 두 판의
+// **모양**을 견준다 — 절 수, 실린 파일 수, 통신 갈래 수. 글은 달라도 되지만
+// 사실이 달라지면 그건 서류가 거짓말을 하는 것이다.
+//
+// ── 지어내지 않는다 ────────────────────────────────────────────────────
+//
+// 여기 적히는 값은 전부 selfpack.js 의 audit() 이 소스를 훑어 얻은 것이다.
+// 한국어판과 같은 자료를 쓴다. 영어판이라고 다른 숫자가 나오면 안 된다.
+
+const rule = (n = 74) => '-'.repeat(n);
+
+/** 소스를 훑는 자리들. 한국어판 PROBES 와 같은 차례여야 한다. */
+const PROBE_LABELS = {
+  net: { label: 'Network requests', note: 'Only to the address you entered in setup (through HTTPS_PROXY when one is set)' },
+  exec: { label: 'External commands', note: 'Commands you or the model asked for, plus git when installing a plugin' },
+  listen: { label: 'Listening ports', note: 'Should be none' },
+  eval: { label: 'String evaluation', note: 'Should be none' },
+};
+
+/**
+ * 사람이 읽는 심사서 — 영어판.
+ *
+ * @param {object} a       selfpack.js 의 audit()
+ * @param {string} at      만든 시각
+ * @param {Array}  probes  selfpack.js 의 PROBES (차례를 그대로 따른다)
+ */
+export function reviewSheetEn(a, at, probes) {
+  const L = [];
+  L.push('deel — security review package');
+  L.push(rule());
+  L.push(`Name          ${a.name}`);
+  L.push(`Version       ${a.version}`);
+  L.push(`License       ${a.license}`);
+  L.push(`Runtime       Node ${a.node} (standard library only)`);
+  L.push(`Generated     ${at}`);
+  L.push('');
+
+  L.push('1. Third-party dependencies');
+  L.push(rule());
+  L.push(`   dependencies       ${a.deps.length}${a.deps.length ? '  ' + a.deps.join(', ') : '   <- no third-party code is shipped'}`);
+  L.push(`   devDependencies    ${a.devDeps.length}`);
+  L.push(`   external imports   ${a.외부모듈.length}${a.외부모듈.length ? '' : '   <- only node: builtins and its own files'}`);
+  for (const x of a.외부모듈) L.push(`       ${x}`);
+  L.push('');
+
+  L.push('2. Code that runs on install');
+  L.push(rule());
+  L.push(a.lifecycle.length
+    ? `   Present: ${a.lifecycle.join(', ')}   <- needs review`
+    : '   None   <- no preinstall / install / postinstall / prepare');
+  L.push('   Unzip and run `node bin/deel.js`. There is no install step.');
+  L.push('');
+
+  L.push('3. Every outbound call site (found by scanning the source)');
+  L.push(rule());
+  for (const p of probes) {
+    const hits = a.calls[p.id];
+    const w = PROBE_LABELS[p.id] ?? { label: p.id, note: '' };
+    L.push(`   [${w.label}]  ${hits.length}   ${w.note}`);
+    for (const h of hits) L.push(`       ${h.file}:${h.line}   ${h.text}`);
+    if (!hits.length) L.push('       (none)');
+  }
+  L.push('');
+  L.push('   Note: no endpoint is hard-coded in the source. deel only uses the address you');
+  L.push('     entered in setup.  Config file: ~/.deel/config.json  (or DEEL_API_KEY)');
+  L.push('');
+
+  L.push('3-1. Four separate outbound lanes that never mix');
+  L.push(rule());
+  L.push('   [A] Model gateway - the only lane that carries your source code');
+  L.push('       - Address: the single endpoint chosen in deel setup');
+  L.push('       - That one address is the entire allow-list. Switch models and the old one closes.');
+  L.push('       - src/safety/network.js checks every request. If the address is not on the');
+  L.push('         list, the request is never built.');
+  L.push('       - With HTTPS_PROXY (or proxy in the config) the call goes **through** that');
+  L.push('         proxy (CONNECT tunnel). The destination stays the same single address, and');
+  L.push('         the proxy in use is printed at startup and in /status. Requests to this');
+  L.push('         machine (127.*, localhost) never go through the proxy.');
+  L.push('');
+  L.push('   [B] Web reading (WebFetch tool) - fetch only');
+  L.push('       - GET only. No request body, so source and conversation cannot leave this way.');
+  L.push('       - This machine and private ranges (127.*, 10.*, 192.168.*, 172.16-31.*) are refused.');
+  L.push('       - The lane opens only while the tool runs and closes immediately after.');
+  L.push('       - Every address visited is written to the audit log.');
+  L.push('');
+  L.push('   [C] Plugin install (github) - only when you type /plugin install');
+  L.push('       - Open only while that command runs.');
+  L.push('');
+  L.push('   [D] MCP servers - separate child processes, someone else\'s program');
+  L.push('       - Off by default. A server runs only if you list it in .deel/mcp.json.');
+  L.push('       - Unlike A/B/C we cannot see which sockets that server opens. So instead of');
+  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('');
+
+  L.push('4. Skills and plugins');
+  L.push(rule());
+  L.push('   This package contains no skills and no plugins.');
+  L.push('   It only reads ~/.claude, ~/.deel and the project folder on the machine it runs on.');
+  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(rule());
+  const w = Math.max(...a.files.map((f) => f.path.length));
+  for (const f of a.files) {
+    L.push(`   ${f.path.padEnd(w)}  ${String(f.bytes).padStart(7)}B  ${f.sha}`);
+  }
+  L.push('');
+  L.push('   Verify these yourself with:');
+  L.push('     sha256sum <file>                   (Linux, macOS)');
+  L.push('     certutil -hashfile <file> SHA256   (Windows)');
+  L.push('');
+  return L.join('\n');
+}
+
+/** zip 맨 앞에 넣는 안내 — 영어판. */
+export function readMeEn() {
+  return [
+    'deel - a coding agent CLI for local models and in-house gateways',
+    '',
+    'How to run it (there is no install step)',
+    '  1. Unzip this archive anywhere.',
+    '  2. Check that Node 20 or newer is present:  node -v',
+    '  3. Choose a connection:                     node deel/bin/deel.js setup',
+    '  4. Start talking:                           node deel/bin/deel.js',
+    '',
+    'For the security reviewer',
+    '  import-review.txt  The review package in prose: dependencies, install scripts,',
+    '                     every network call site, and a SHA-256 for each file.',
+    '  sbom.cdx.json      SBOM (CycloneDX 1.5). Feed it straight to your scanner.',
+    '  audit-spec.json    Egress list, audit-log specification, file hashes - machine readable.',
+    '',
+    '  All three are generated by scanning the source. None of it is written by hand.',
+    '',
+  ].join('\n');
+}
+
+/**
+ * 심사명세 — 영어판.
+ *
+ * 한국어판(sbom.js 의 심사명세)과 **같은 자료, 같은 차례**다. 열쇠 이름까지
+ * 영어라야 뜻이 있다 — 스캐너에 넣는 사람이 `통신` 을 읽을 수는 없다.
+ */
+export function specEn(a, at, 통신, 열쇠, 감사) {
+  return {
+    product: a.name,
+    version: a.version,
+    license: a.license,
+    runtime: `Node ${a.node} (standard library only)`,
+    generated: at.toISOString(),
+    dependencies: {
+      dependencies: a.deps,
+      devDependencies: a.devDeps,
+      installScripts: a.lifecycle,
+      externalImportsInSource: a.외부모듈,
+      summary: a.deps.length === 0 && a.외부모듈.length === 0
+        ? 'No third-party code is bundled. Only node: builtins and its own files are imported.'
+        : 'External modules are present - review the list above.',
+    },
+    egress: 통신,
+    keyStorage: 열쇠,
+    auditLog: 감사,
+    files: a.files.map((f) => ({ path: f.path, bytes: f.bytes, sha256: f.sha })),
+  };
+}
+
+/** 나가는 길 — 영어판. 자리(소스 줄 번호)는 부르는 쪽이 넣어 준다. */
+export function egressEn(자리, a) {
+  return {
+    lanes: [
+      {
+        lane: 'Model gateway',
+        when: 'On every turn you type',
+        where: 'The single address chosen in deel setup',
+        what: 'The conversation, and the file contents the model read',
+        control: 'src/safety/network.js checks the allow-list on every request. If the address is not listed, the request is never built.',
+        proxy: 'With HTTPS_PROXY (or proxy in the config) the call goes through that proxy (CONNECT tunnel). The destination allow-list is unchanged, and addresses on this machine bypass the proxy.',
+        source: 자리('net'),
+      },
+      {
+        lane: 'Web reading (WebFetch)',
+        when: 'Only when the model calls that tool',
+        where: 'An address the model chose. This machine and private ranges are refused',
+        what: 'Nothing - GET only, so no request body is sent',
+        control: 'Blocked entirely under --offline.',
+        source: 자리('net'),
+      },
+      {
+        lane: 'Plugin install',
+        when: 'Only when you type /plugin install',
+        where: 'github.com',
+        what: 'Nothing',
+        control: 'Blocked entirely under --offline.',
+        source: 자리('net'),
+      },
+    ],
+    listeningPorts: {
+      count: (a.calls?.listen ?? []).length,
+      use: 'Only /preview, which serves the page you just built. It binds to 127.0.0.1 and closes when the command ends.',
+      source: 자리('listen'),
+    },
+    externalCommands: {
+      count: (a.calls?.exec ?? []).length,
+      use: 'Commands you or the model asked for, starting MCP servers, and git when installing a plugin.',
+      source: 자리('exec'),
+    },
+    stringEvaluation: {
+      count: (a.calls?.eval ?? []).length,
+      use: 'Should be none.',
+      source: 자리('eval'),
+    },
+    whenOffline: [
+      'Web reading (WebFetch) is blocked.',
+      'Plugin install is blocked.',
+      'MCP servers are not started - we cannot control where a child process connects.',
+      'The model gateway still works. If that address is on this machine, nothing leaves it at all.',
+    ],
+  };
+}
+
+/** 열쇠 보관 — 영어판. 이 PC 에서 실제로 쓰는 방식은 부르는 쪽이 넣어 준다. */
+export function keyStorageEn(이PC에서) {
+  return {
+    where: 'profiles[].apiKey in ~/.deel/config.json (or DEEL_HOME)',
+    onThisMachine: 이PC에서,
+    methods: [
+      { os: 'Windows', how: 'DPAPI ProtectedData (CurrentUser) - only this account on this machine can unseal it. Copying the file elsewhere does not help.' },
+      { os: 'macOS', how: 'Login keychain (security add-generic-password)' },
+      { os: 'Other', how: 'File mode 0600. There is no OS keystore, so we say so plainly.' },
+    ],
+    howItIsPassed: 'The key never appears on a command line - it is always passed over stdin, so another user on the same machine cannot read it from the process list.',
+    avoidTheFile: 'Set DEEL_API_KEY (or DEEL_KEY_<profile>) and nothing is written to the file at all. The environment variable wins over the file.',
+    disable: 'DEEL_KEYSTORE=off - no OS keystore, file permissions only.',
+  };
+}
+
+/** 감사기록 사양 — 영어판. */
+export function auditLogEn() {
+  return {
+    location: '<workdir>/.deel/audit.jsonl',
+    format: 'JSON Lines (UTF-8, one record per line)',
+    growth: 'Append only. Records are never edited or removed.',
+    retention: 'deel never deletes it. Set retention according to your own policy.',
+    everyLine: [
+      { field: 'at', meaning: 'When (ISO 8601, UTC)' },
+      { field: 'session', meaning: 'Which conversation - an id derived from the start time' },
+      { field: 'kind', meaning: 'Record type - see below' },
+    ],
+    kinds: [
+      { kind: 'turn', meaning: 'Something the user asked for', fields: ['text'], note: 'First 500 characters only' },
+      { kind: 'tool', meaning: 'A tool call', fields: ['tool', 'target', 'ok', 'note'], note: 'target is a file path, a command, or a search pattern' },
+      { kind: 'blocked', meaning: 'Something a safety check refused', fields: ['why', 'what'], note: 'The refused command is kept verbatim' },
+      { kind: 'undo', meaning: 'A rollback', fields: ['files', 'turns'] },
+    ],
+    neverRecorded: [
+      'Keys and passwords. Neither apiKey from the config nor a spreadsheet password reaches the log.',
+      'Whole file contents. What was touched is recorded; what was written is not.',
+      'Model replies. Those live in the session transcript (.deel/sessions) instead.',
+    ],
+  };
+}
+
+/** 사람이 읽을 짧은 요약 — 영어판. */
+export function specSummaryEn(m = {}) {
+  return [
+    `SBOM components  ${(m.files?.length ?? 0).toLocaleString()} (each with SHA-256)`,
+    `Dependencies     ${(m.dependencies?.dependencies?.length ?? 0)} - install scripts ${(m.dependencies?.installScripts?.length ?? 0)}`,
+    `Egress lanes     ${(m.egress?.lanes?.length ?? 0)} - listening ports ${(m.egress?.listeningPorts?.count ?? 0)}`,
+    `Audit records    ${(m.auditLog?.kinds?.length ?? 0)} kinds - ${m.auditLog?.location ?? ''}`,
+  ].join('\n');
+}