deel-local-cli 1.13.0 → 1.14.0

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/pack/tar.js

@@ -1,154 +1,154 @@
-// tar 읽기. GitHub 가 주는 tarball 을 풀기 위한 최소 구현.
-// git 이 없는 기기에서도 플러그인을 받을 수 있어야 해서 필요하다.
-import { gunzipSync } from 'node:zlib';
-import { resolve, sep } from 'node:path';
-
-const BLOCK = 512;
-
-function str(buf, off, len) {
-  const end = buf.indexOf(0, off);
-  const stop = end >= 0 && end < off + len ? end : off + len;
-  return buf.toString('utf8', off, stop).trim();
-}
-
-function octal(buf, off, len) {
-  const s = str(buf, off, len).replace(/[^0-7]/g, '');
-  return s ? parseInt(s, 8) : 0;
-}
-
-/*
- * ── 작게 받아서 크게 푸는 묶음(압축 폭탄) ───────────────────────────────
- *
- * 받는 쪽(plugins/manage.js)은 **압축된** 크기를 64MB 로 막는다. 그런데
- * 0 으로만 채운 파일은 천 배 넘게 줄어든다 — 64MB 짜리 하나가 풀면 수십 GB 다.
- * gunzipSync 는 그걸 통째로 메모리에 올리므로, 화면에는 아무 말도 안 남고
- * 프로세스가 그대로 죽는다. 사용자가 보는 것은 「플러그인을 깔아 줘」 라고
- * 시킨 뒤 deel 이 사라진 것뿐이다 — 하던 대화까지 같이.
- *
- * 그래서 **푼 크기**에도 상한을 둔다. 256MB 로 잡은 까닭은 받는 상한의 네 배라서다.
- * 플러그인은 글과 스크립트 묶음이라 서너 배까지는 부푼다. 그보다 더 부푸는 것은
- * 플러그인이 아니라 폭탄으로 본다.
- */
-export const 푼것상한 = 256 * 1024 * 1024;
-
-/**
- * gzip 된 tar 를 풀어 파일 목록을 돌려준다.
- * @param {Buffer} gz
- * @param {object} o
- * @param {number} o.상한 푼 크기 상한. 검사가 작은 값으로 부르려고 열어 뒀다 —
- *   256MB 를 진짜로 만들어 재면 그 검사 하나가 기계를 잡아먹는다.
- * @returns {Array<{name:string, data:Buffer, mode:number}>}
- */
-export function untargz(gz, { 상한 = 푼것상한 } = {}) {
-  let buf;
-  try {
-    buf = gunzipSync(gz, { maxOutputLength: 상한 });
-  } catch (err) {
-    // 조용히 죽는 대신 왜 안 되는지 말한다. 이 말은 install 이 그대로 화면에 올린다.
-    if (err?.code === 'ERR_BUFFER_TOO_LARGE') {
-      // MB 로만 적으면 작은 상한이 「0MB」 가 된다 — 사람에게 아무 말도 안 하는 숫자다.
-      const 상한말 = 상한 >= 1024 * 1024 ? `${Math.round(상한 / 1024 / 1024)}MB` : `${Math.round(상한 / 1024)}KB`;
-      throw new Error(`푼 크기가 상한(${상한말})을 넘습니다`
-        + ' — 압축만 작고 풀면 몇 GB 가 되는 묶음입니다. 저장소가 맞는지 확인하세요.');
-    }
-    throw err;
-  }
-  const out = [];
-  let pos = 0;
-  let longName = null;
-
-  while (pos + BLOCK <= buf.length) {
-    const head = buf.subarray(pos, pos + BLOCK);
-    // 빈 블록 두 개면 끝.
-    if (head.every((b) => b === 0)) break;
-
-    const size = octal(head, 124, 12);
-    const type = String.fromCharCode(head[156]) || '0';
-    const mode = octal(head, 100, 8);
-    const prefix = str(head, 345, 155);
-    let name = str(head, 0, 100);
-    if (prefix) name = `${prefix}/${name}`;
-
-    pos += BLOCK;
-    const data = buf.subarray(pos, pos + size);
-    pos += Math.ceil(size / BLOCK) * BLOCK;
-
-    if (type === 'L') {                    // GNU 긴 이름
-      longName = data.toString('utf8').replace(/\0+$/, '');
-      continue;
-    }
-    if (type === 'x' || type === 'g') {    // pax 확장 머리 — path 만 본다
-      const m = /\d+ path=([^\n]+)\n/.exec(data.toString('utf8'));
-      if (m) longName = m[1];
-      continue;
-    }
-    if (longName) { name = longName; longName = null; }
-
-    if (type === '0' || type === '\0' || type === '') {
-      out.push({ name: name.replace(/\\/g, '/'), data: Buffer.from(data), mode: mode || 0o644 });
-    }
-    // 폴더('5')·링크 등은 건너뛴다. 파일만 있으면 폴더는 만들면서 채운다.
-  }
-  return out;
-}
-
-// GitHub tarball 은 최상위에 <repo>-<커밋> 폴더 한 겹이 더 있다. 그걸 벗긴다.
-export function stripTop(files) {
-  if (!files.length) return files;
-  const first = files[0].name.split('/')[0];
-  if (!files.every((f) => f.name.startsWith(first + '/'))) return files;
-  return files.map((f) => ({ ...f, name: f.name.slice(first.length + 1) }));
-}
-
-/**
- * 이 이름이 풀 폴더 **안쪽**을 가리키나.
- *
- * ── 왜 있어야 하나 ──────────────────────────────────────────────────────
- *
- * tar 안의 이름은 **남이 적은 글자**다. 우리가 만든 것이 아니다. 그걸 그대로
- * join(dest, name) 에 넣으면 `../../../..` 하나로 폴더 밖에 파일을 쓴다.
- * 받는 쪽이 mkdirSync(recursive) 까지 해 주므로 없는 폴더도 만들어 가며 나간다.
- *
- *   name: '../../../../윗동네에쓰기.txt'
- *   dest: C:\Users\누군가\.deel\plugins\x
- *   →    C:\Users\윗동네에쓰기.txt
- *
- * 이 프로그램이 파는 문장이 「작업 폴더 밖은 안 만진다」 인데, 플러그인을
- * 받는 길에는 그 문장을 지키는 코드가 한 줄도 없었다. 여기서 막는다 —
- * 푸는 자리마다 따로 적으면 언젠가 한 곳이 빠진다.
- *
- * 절대경로·드라이브 문자도 같이 걸린다. resolve 는 절대경로를 만나면 뿌리를
- * 통째로 갈아 치우므로, 그 결과가 뿌리로 시작하지 않는다.
- */
-export function 안쪽인가(뿌리, 이름) {
-  const 원래 = String(이름 ?? '');
-  /*
-   * ── 판마다 다르게 막으면 막은 게 아니다 ───────────────────────────────
-   *
-   * `resolve()` 는 윈도우에서만 역슬래시를 칸막이로 본다. 그래서
-   * `..\\..\\밖으로.txt` 는 윈도우에서는 밖으로 잡히고 리눅스·맥에서는
-   * **그냥 파일 이름 하나**로 통과한다. 같은 묶음이 판에 따라 다르게 처리되는
-   * 셈이다.
-   *
-   * 플러그인 묶음은 기계를 옮겨 다닌다. 리눅스에서 받아 둔 것을 윈도우로
-   * 옮기거나, 리눅스에서 푼 것을 그대로 다시 묶어 나눠 주는 일이 흔하다.
-   * 한쪽에서만 막으면 다른 쪽으로 새어 나갈 길이 남는다.
-   *
-   * 그래서 역슬래시를 **어느 판에서든** 칸막이로 본다. 이 방향으로만 틀리면
-   * 손해는 「이름에 역슬래시가 든 파일을 못 푼다」 뿐이고, 그런 이름이 정직한
-   * 플러그인에 있을 까닭이 없다. 반대 방향으로 틀리면 남의 글자 한 줄로
-   * 폴더 밖에 파일이 써진다.
-   */
-  const 이름꼴 = 원래.replace(/\\/g, '/');
-  // 드라이브 글자(`C:`)도 마찬가지다. 리눅스에서는 그냥 이름이라 통과하는데,
-  // 그 묶음을 윈도우에서 풀면 그 자리로 곧장 나간다.
-  if (/^[a-zA-Z]:/.test(이름꼴)) return false;
-  const 뿌리절대 = resolve(String(뿌리 ?? ''));
-  const 갈곳 = resolve(뿌리절대, 이름꼴);
-  return 갈곳 === 뿌리절대 || 갈곳.startsWith(뿌리절대 + sep);
-}
-
-/** 풀 폴더 밖을 가리키는 것만 골라 준다. 하나라도 있으면 그 묶음은 안 푼다. */
-export function 밖을가리키는것(뿌리, files) {
-  return (files ?? []).filter((f) => !안쪽인가(뿌리, f?.name));
-}
+// tar 읽기. GitHub 가 주는 tarball 을 풀기 위한 최소 구현.
+// git 이 없는 기기에서도 플러그인을 받을 수 있어야 해서 필요하다.
+import { gunzipSync } from 'node:zlib';
+import { resolve, sep } from 'node:path';
+
+const BLOCK = 512;
+
+function str(buf, off, len) {
+  const end = buf.indexOf(0, off);
+  const stop = end >= 0 && end < off + len ? end : off + len;
+  return buf.toString('utf8', off, stop).trim();
+}
+
+function octal(buf, off, len) {
+  const s = str(buf, off, len).replace(/[^0-7]/g, '');
+  return s ? parseInt(s, 8) : 0;
+}
+
+/*
+ * ── 작게 받아서 크게 푸는 묶음(압축 폭탄) ───────────────────────────────
+ *
+ * 받는 쪽(plugins/manage.js)은 **압축된** 크기를 64MB 로 막는다. 그런데
+ * 0 으로만 채운 파일은 천 배 넘게 줄어든다 — 64MB 짜리 하나가 풀면 수십 GB 다.
+ * gunzipSync 는 그걸 통째로 메모리에 올리므로, 화면에는 아무 말도 안 남고
+ * 프로세스가 그대로 죽는다. 사용자가 보는 것은 「플러그인을 깔아 줘」 라고
+ * 시킨 뒤 deel 이 사라진 것뿐이다 — 하던 대화까지 같이.
+ *
+ * 그래서 **푼 크기**에도 상한을 둔다. 256MB 로 잡은 까닭은 받는 상한의 네 배라서다.
+ * 플러그인은 글과 스크립트 묶음이라 서너 배까지는 부푼다. 그보다 더 부푸는 것은
+ * 플러그인이 아니라 폭탄으로 본다.
+ */
+export const 푼것상한 = 256 * 1024 * 1024;
+
+/**
+ * gzip 된 tar 를 풀어 파일 목록을 돌려준다.
+ * @param {Buffer} gz
+ * @param {object} o
+ * @param {number} o.상한 푼 크기 상한. 검사가 작은 값으로 부르려고 열어 뒀다 —
+ *   256MB 를 진짜로 만들어 재면 그 검사 하나가 기계를 잡아먹는다.
+ * @returns {Array<{name:string, data:Buffer, mode:number}>}
+ */
+export function untargz(gz, { 상한 = 푼것상한 } = {}) {
+  let buf;
+  try {
+    buf = gunzipSync(gz, { maxOutputLength: 상한 });
+  } catch (err) {
+    // 조용히 죽는 대신 왜 안 되는지 말한다. 이 말은 install 이 그대로 화면에 올린다.
+    if (err?.code === 'ERR_BUFFER_TOO_LARGE') {
+      // MB 로만 적으면 작은 상한이 「0MB」 가 된다 — 사람에게 아무 말도 안 하는 숫자다.
+      const 상한말 = 상한 >= 1024 * 1024 ? `${Math.round(상한 / 1024 / 1024)}MB` : `${Math.round(상한 / 1024)}KB`;
+      throw new Error(`푼 크기가 상한(${상한말})을 넘습니다`
+        + ' — 압축만 작고 풀면 몇 GB 가 되는 묶음입니다. 저장소가 맞는지 확인하세요.');
+    }
+    throw err;
+  }
+  const out = [];
+  let pos = 0;
+  let longName = null;
+
+  while (pos + BLOCK <= buf.length) {
+    const head = buf.subarray(pos, pos + BLOCK);
+    // 빈 블록 두 개면 끝.
+    if (head.every((b) => b === 0)) break;
+
+    const size = octal(head, 124, 12);
+    const type = String.fromCharCode(head[156]) || '0';
+    const mode = octal(head, 100, 8);
+    const prefix = str(head, 345, 155);
+    let name = str(head, 0, 100);
+    if (prefix) name = `${prefix}/${name}`;
+
+    pos += BLOCK;
+    const data = buf.subarray(pos, pos + size);
+    pos += Math.ceil(size / BLOCK) * BLOCK;
+
+    if (type === 'L') {                    // GNU 긴 이름
+      longName = data.toString('utf8').replace(/\0+$/, '');
+      continue;
+    }
+    if (type === 'x' || type === 'g') {    // pax 확장 머리 — path 만 본다
+      const m = /\d+ path=([^\n]+)\n/.exec(data.toString('utf8'));
+      if (m) longName = m[1];
+      continue;
+    }
+    if (longName) { name = longName; longName = null; }
+
+    if (type === '0' || type === '\0' || type === '') {
+      out.push({ name: name.replace(/\\/g, '/'), data: Buffer.from(data), mode: mode || 0o644 });
+    }
+    // 폴더('5')·링크 등은 건너뛴다. 파일만 있으면 폴더는 만들면서 채운다.
+  }
+  return out;
+}
+
+// GitHub tarball 은 최상위에 <repo>-<커밋> 폴더 한 겹이 더 있다. 그걸 벗긴다.
+export function stripTop(files) {
+  if (!files.length) return files;
+  const first = files[0].name.split('/')[0];
+  if (!files.every((f) => f.name.startsWith(first + '/'))) return files;
+  return files.map((f) => ({ ...f, name: f.name.slice(first.length + 1) }));
+}
+
+/**
+ * 이 이름이 풀 폴더 **안쪽**을 가리키나.
+ *
+ * ── 왜 있어야 하나 ──────────────────────────────────────────────────────
+ *
+ * tar 안의 이름은 **남이 적은 글자**다. 우리가 만든 것이 아니다. 그걸 그대로
+ * join(dest, name) 에 넣으면 `../../../..` 하나로 폴더 밖에 파일을 쓴다.
+ * 받는 쪽이 mkdirSync(recursive) 까지 해 주므로 없는 폴더도 만들어 가며 나간다.
+ *
+ *   name: '../../../../윗동네에쓰기.txt'
+ *   dest: C:\Users\누군가\.deel\plugins\x
+ *   →    C:\Users\윗동네에쓰기.txt
+ *
+ * 이 프로그램이 파는 문장이 「작업 폴더 밖은 안 만진다」 인데, 플러그인을
+ * 받는 길에는 그 문장을 지키는 코드가 한 줄도 없었다. 여기서 막는다 —
+ * 푸는 자리마다 따로 적으면 언젠가 한 곳이 빠진다.
+ *
+ * 절대경로·드라이브 문자도 같이 걸린다. resolve 는 절대경로를 만나면 뿌리를
+ * 통째로 갈아 치우므로, 그 결과가 뿌리로 시작하지 않는다.
+ */
+export function 안쪽인가(뿌리, 이름) {
+  const 원래 = String(이름 ?? '');
+  /*
+   * ── 판마다 다르게 막으면 막은 게 아니다 ───────────────────────────────
+   *
+   * `resolve()` 는 윈도우에서만 역슬래시를 칸막이로 본다. 그래서
+   * `..\\..\\밖으로.txt` 는 윈도우에서는 밖으로 잡히고 리눅스·맥에서는
+   * **그냥 파일 이름 하나**로 통과한다. 같은 묶음이 판에 따라 다르게 처리되는
+   * 셈이다.
+   *
+   * 플러그인 묶음은 기계를 옮겨 다닌다. 리눅스에서 받아 둔 것을 윈도우로
+   * 옮기거나, 리눅스에서 푼 것을 그대로 다시 묶어 나눠 주는 일이 흔하다.
+   * 한쪽에서만 막으면 다른 쪽으로 새어 나갈 길이 남는다.
+   *
+   * 그래서 역슬래시를 **어느 판에서든** 칸막이로 본다. 이 방향으로만 틀리면
+   * 손해는 「이름에 역슬래시가 든 파일을 못 푼다」 뿐이고, 그런 이름이 정직한
+   * 플러그인에 있을 까닭이 없다. 반대 방향으로 틀리면 남의 글자 한 줄로
+   * 폴더 밖에 파일이 써진다.
+   */
+  const 이름꼴 = 원래.replace(/\\/g, '/');
+  // 드라이브 글자(`C:`)도 마찬가지다. 리눅스에서는 그냥 이름이라 통과하는데,
+  // 그 묶음을 윈도우에서 풀면 그 자리로 곧장 나간다.
+  if (/^[a-zA-Z]:/.test(이름꼴)) return false;
+  const 뿌리절대 = resolve(String(뿌리 ?? ''));
+  const 갈곳 = resolve(뿌리절대, 이름꼴);
+  return 갈곳 === 뿌리절대 || 갈곳.startsWith(뿌리절대 + sep);
+}
+
+/** 풀 폴더 밖을 가리키는 것만 골라 준다. 하나라도 있으면 그 묶음은 안 푼다. */
+export function 밖을가리키는것(뿌리, files) {
+  return (files ?? []).filter((f) => !안쪽인가(뿌리, f?.name));
+}