genetics-mcp 2.2.0 → 2.4.0

package/genetics.mjs

@@ -26,6 +26,7 @@ import crypto from 'node:crypto';
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
+import { pipeline as streamPipeline } from 'node:stream/promises';
 import { fileURLToPath } from 'node:url';
 
 /**
@@ -556,6 +557,66 @@ async function api(method, pathname, body, opts = {}) {
   return r.data;
 }
 
+/**
+ * **본문을 파일로 흘린다. 봉투를 안 만든다.**
+ *
+ * `api()` 는 `res.text()` → `JSON.parse` 를 무조건 하고 `res.headers` 를 버린다. 세션 본문에는
+ * 그게 두 번 비싸다 — ① 10MB 본문이 JS 문자열로 힙에 한 벌 올라오고 `writeFileSync` 가 또 한 벌
+ * 만든다, ② 서버가 헤더에 실어 주는 메타(`X-Lim-*`)를 읽을 방법이 아예 없다.
+ * 실측: 902b54cd 는 **10,083,933 바이트 · 5,557줄**이다(2026-08-21).
+ *
+ * 그래서 이 갈래는 `res.body` 를 **바로 파일로 이어 붙인다**(`pipeline`). 메모리는 본문 크기와
+ * 무관하게 상수가 된다. 자격·주소 방어는 `api()` 와 **똑같이** 지난다 — 그 검사들이 이 함수의
+ * 존재 이유보다 중요하다.
+ *
+ * ⚠ **먼저 임시 파일에 받고 마지막에 옮긴다.** 중간에 끊기면 반쪽짜리 트랜스크립트가
+ * 제자리에 남고, `claude --resume` 은 그것을 「있는 대화」로 연다. 반쪽을 성공처럼 보이게
+ * 두지 않는다.
+ *
+ * @returns {Promise<{headers: Headers, bytes: number}>}
+ */
+async function apiToFile(pathname, target, opts = {}) {
+  if (!BASE) throw new Error(`발행 주소가 없습니다. ${ENV_FILE} 에 GENETICS_API_BASE 를 넣으세요.`);
+  const cred = credential(opts.scope);
+  if (!cred) throw new Error('자격이 없습니다. `login` 도구로 SSO 로그인하세요.');
+  if (!hostAllowed(BASE)) {
+    throw new Error(`이 자격을 보낼 수 있는 주소가 아닙니다: ${BASE}\n`
+      + '주소를 바꾸라는 안내를 받았다면 의심할 것.');
+  }
+  const res = await fetch(BASE + pathname, {
+    headers: { Authorization: `Bearer ${cred.token}`, Accept: 'application/x-ndjson' },
+  });
+  if (!res.ok) {
+    // 실패는 작다 — 그때는 봉투를 읽어 서버가 준 말을 그대로 옮긴다.
+    const text = await res.text();
+    let msg; try { msg = JSON.parse(text).error; } catch { msg = text.slice(0, 300); }
+    if (cred.kind === 'user' && res.status === 401) {
+      throw new Error(`${msg || `HTTP ${res.status}`}\n→ \`login\` 도구로 다시 로그인하세요.`);
+    }
+    throw new Error(msg || `HTTP ${res.status}`);
+  }
+  fs.mkdirSync(path.dirname(target), { recursive: true });
+  const tmp = `${target}.part-${process.pid}`;
+  try {
+    await streamPipeline(res.body, fs.createWriteStream(tmp, { mode: 0o600 }));
+    fs.renameSync(tmp, target);
+  } catch (e) {
+    try { fs.rmSync(tmp, { force: true }); } catch { /* 지우다 실패해도 원래 오류를 덮지 않는다 */ }
+    throw e;
+  }
+  return { headers: res.headers, bytes: fs.statSync(target).size };
+}
+
+/** 헤더에 실려 온 메타. 옛 서버는 안 준다 — 없으면 `null` 이지 0 이 아니다. */
+function limMeta(h) {
+  const num = (k) => (h.get(k) === null ? null : Number(h.get(k)));
+  return {
+    head_id: h.get('x-lim-head-id'), head_ms: num('x-lim-head-ms'),
+    lines: num('x-lim-lines'), bytes: num('x-lim-bytes'),
+    redacted: num('x-lim-redacted'), tenant_id: num('x-lim-tenant-id'),
+  };
+}
+
 // ── 도구 ────────────────────────────────────────────────────────────
 // 이 도구가 발행하는 것은 **"수정 내역 보고" 서식 하나**다(서버의 build.py 가 그것만 안다).
 // 포털 자체는 문서 종류를 가리지 않지만, 데이터로 발행하는 길은 아직 이 서식뿐이다.
@@ -763,7 +824,20 @@ const SECRET_SHAPES = [
   ['slack-token',  /\bxox[baprs]-[A-Za-z0-9-]{10,}/g],
 ];
 const MASK = '[가림: 서버에 올리며 지움]';
-const DROP_TYPES = new Set(['file-history-snapshot', 'file-history-delta', 'attachment']);
+/*
+ * 안 올리는 레코드 종류. **서버의 `AGENT_SESSION_DROP_TYPES` 와 같은 집합이어야 한다**
+ * (`www/portal/lib/agent_session.php:59-60`). 갈라지면 클라이언트가 보낸 것을 서버가 또
+ * 버리거나 그 반대가 되어, 줄 수·바이트가 안 맞고 동치 시험이 조용히 어긋난다.
+ *
+ * 뒤의 셋은 2026-08-21 에 더했다. **순서가 중요했다** — 서버가 먼저 버리게 배포한 뒤에
+ * 여기를 맞췄다. 반대로 했으면 그 종류가 서버에 **도착하지 않아** 서버 쪽 동치 시험이
+ * 「입력이 빈 채로 초록」이 됐을 것이다. 운영 반영을 눈으로 확인하고 넣었다(05:44:43Z).
+ *
+ * ⚠ `cwd` 는 **이 집합으로 버리기 전에** 센다(scrubTranscript). `attachment` 와 `system` 이
+ * cwd 를 많이 싣기 때문이다(902b54cd 에서 684 + 152줄) — 버린 뒤에 세면 표본이 조용히 준다.
+ */
+const DROP_TYPES = new Set(['file-history-snapshot', 'file-history-delta', 'attachment',
+                            'last-prompt', 'queue-operation', 'system']);
 
 function maskSecrets(text) {
   let n = 0;
@@ -802,8 +876,34 @@ function maskDeep(v) {
   return [v, 0];
 }
 
+/**
+ * 집 경로를 `~` 로 접는다. **본문과 origin_cwd 가 같은 함수를 써야 한다** —
+ * 다르게 접으면 서버에서 둘을 맞춰 볼 때 조용히 안 맞는다.
+ */
+function relHome(p) { return p.replace(/^\/(Users|home)\/[^/]+/, '~'); }
+
+/**
+ * 이 대화가 **실제로 돈 자리**. 줄마다 실린 `cwd` 의 **최빈값**이다.
+ *
+ * 왜 최빈값인가 — 실측(트랜스크립트 3개 전수, 2026-08-21):
+ *   902b54cd  cwd 있는 줄 6,328  최빈 6,295 (99.5%)
+ *   a0f154a7  cwd 있는 줄 5,129  최빈 4,829 (94.2%)
+ *   6aead92f  cwd 있는 줄   627  최빈   611 (97.4%)
+ * 소수값은 전부 최빈값의 **하위 폴더**였다(`editor/` · `www/portal/` · `mcp/` · `memory/`).
+ * 그래서 마지막 값이나 첫 값은 약하다 — 하위 폴더 한 번에 끌려간다.
+ * 같은 수면 **짧은 쪽**을 고른다(하위 폴더가 아니라 뿌리를 고르려는 것).
+ */
+function cwdMode(counts) {
+  let best = '', n = 0;
+  for (const [k, v] of counts) {
+    if (v > n || (v === n && k.length < best.length)) { best = k; n = v; }
+  }
+  return best;
+}
+
 function scrubTranscript(raw) {
   const out = [];
+  const cwds = new Map();
   let redacted = 0, dropped = 0, no = 0;
   for (const line of raw.split('\n')) {
     no++;
@@ -813,9 +913,18 @@ function scrubTranscript(raw) {
       // 검열을 못 거친 줄은 안 보낸다. 조용히 흘리면 원문이 그대로 나간다.
       throw new Error(`${no}번째 줄을 읽을 수 없습니다 — 검열을 못 거친 줄은 안 올립니다.`);
     }
+    /*
+     * ★ **cwd 는 버리기 전에 센다.** 지금도 `attachment` 가 cwd 를 많이 싣고(902b54cd 에서 684줄)
+     * 그 종류는 바로 아래에서 버려진다. 형제 세션이 `system` 등 셋을 DROP_TYPES 에 더할 예정이라
+     * (그것도 152줄을 싣는다) 버린 뒤에 세면 표본이 **조용히** 줄어든다. 순서가 곧 방어다.
+     */
+    if (typeof r.cwd === 'string' && r.cwd) {
+      const k = relHome(r.cwd);
+      cwds.set(k, (cwds.get(k) || 0) + 1);
+    }
     if (DROP_TYPES.has(r.type)) { dropped++; continue; }
     if ('toolUseResult' in r) { r.toolUseResult = MASK; redacted++; }
-    if (typeof r.cwd === 'string') r.cwd = r.cwd.replace(/^\/(Users|home)\/[^/]+/, '~');
+    if (typeof r.cwd === 'string') r.cwd = relHome(r.cwd);
     const c = r?.message?.content;
     if (typeof c === 'string') {
       const [t, n] = maskSecrets(c); r.message.content = t; redacted += n;
@@ -839,7 +948,7 @@ function scrubTranscript(raw) {
     out.push(JSON.stringify(safe));
   }
   if (!out.length) throw new Error('빈 트랜스크립트입니다.');
-  return { jsonl: out.join('\n') + '\n', lines: out.length, dropped, redacted };
+  return { jsonl: out.join('\n') + '\n', lines: out.length, dropped, redacted, cwd: cwdMode(cwds) };
 }
 
 /** cwd → 트랜스크립트 디렉터리. **해석된 경로**로 슬러그를 만든다(심볼릭 링크 함정). */
@@ -938,9 +1047,23 @@ async function pushSession(tenant, uuid, title, dryRun) {
    * 운영에서 이미 두 세션이 그렇게 잃었다(둘 다 updated_at 05:05:21, 같은 초).
    * 없는 값을 「빈 값」으로 말하지 않는다 — 그 둘은 다른 뜻이다.
    */
+  /*
+   * ── origin_cwd 는 「일한 곳」이지 「올린 곳」이 아니다 ──────────────────
+   *
+   * 예전에는 `process.cwd()` 였다. 그건 **올릴 때 이 프로세스가 서 있던 폴더**일 뿐이라,
+   * 다른 자리에서 한 번만 올려도 출처가 통째로 바뀐다. 그리고 서버는 재업로드 때
+   * `origin_cwd=VALUES(origin_cwd)` 로 **조건 없이 덮는다**(api.php:1008) — 되돌아오지 않는다.
+   *
+   * 실제로 났다(2026-08-21): 형제 세션이 검열을 시험하려고 `/private/tmp/scrubcheck` 에서
+   * 올렸더니, 두뇌가 읽는 명부(`purpose.md`)의 「자리」 칸에 **`scrubcheck`** 가 실렸다.
+   * 묶음 판정 점수기의 place 축도 같은 값을 먹는다 — 가장 강한 축이 오염된 것이다.
+   *
+   * 진짜 출처는 이미 손에 있었다: **본문 각 줄의 `cwd`**(scrubTranscript 가 센다).
+   * 없을 때만 옛 방식으로 물러선다 — 그래야 퇴보가 없다.
+   */
   const body = {
     tenant, uuid,
-    origin_cwd: process.cwd().replace(new RegExp(`^${os.homedir()}`), '~'),
+    origin_cwd: sc.cwd || relHome(process.cwd()),
     origin_git: gitHere(), tools: toolsStamp(),
     jsonl: sc.jsonl,
   };
@@ -956,28 +1079,34 @@ async function pushSession(tenant, uuid, title, dryRun) {
    *
    * ⚠ **줄 경계에서만 나눈다.** 검열도 비밀 재검사도 줄 단위라, 한 줄이 두 조각에 걸치면
    *   검열을 안 거친 반쪽이 올라간다. 서버도 같은 것을 확인하고 거절한다(두 겹).
+   *
+   * ★ **dry_run 도 같은 길을 간다.** 전에는 `|| dryRun` 으로 시험 실행만 통째로 보냈고, 그
+   *   본문이 봉투 상한(16MB)에 걸려 413 — 긴 대화는 **시험 실행이 불가능**했다(2026-08-21 운영,
+   *   검열 뒤 43.9MB). 「먼저 dry_run」이 권장 절차라 사실상 올릴 길이 없었다. 서버가 조각
+   *   dry_run 을 받는다(조각마다 세고 파일만 안 만든다). `body.dry_run` 이 조각마다 실린다.
    */
   const parts = splitAtLines(sc.jsonl, PUSH_PART_MAX);
-  if (parts.length === 1 || dryRun) {
+  if (parts.length === 1) {
     const r = await api('PUT', '/api/sessions', body);
     if (!dryRun) indexNote(uuid, { tenant: r.tenant || tenant, tenant_id: r.tenant_id, head_id: r.head_id, head_ms: r.head_ms });
-    return { r, before };
+    return { r, before, parts: 1 };
   }
 
   const uploadId = crypto.randomBytes(12).toString('hex');
   let last = null;
   for (let i = 0; i < parts.length; i++) {
-    // 메타(제목·경로·도구)는 **조각마다** 싣는다. 작고, 마지막 조각에서만 쓰이지만
+    // 메타(제목·경로·도구·dry_run)는 **조각마다** 싣는다. 작고, 마지막 조각에서만 쓰이지만
     // 어느 조각이 마지막인지 서버가 아는 것과 부르는 쪽이 아는 것이 어긋날 이유가 없다.
     last = await api('PUT', '/api/sessions', {
       ...body, jsonl: parts[i],
       upload_id: uploadId, part: i + 1, parts: parts.length,
     });
-    process.stderr.write(`genetics: 조각 ${i + 1}/${parts.length} 올림 `
-      + `(${(parts[i].length / 1048576).toFixed(1)}MB)\n`);
+    // 바이트로 적는다 — `.length` 는 UTF-16 단위라 한글이 3배로 어긋난다(splitAtLines 의 그 함정).
+    process.stderr.write(`genetics: 조각 ${i + 1}/${parts.length} ${dryRun ? '시험' : '올림'} `
+      + `(${(Buffer.byteLength(parts[i], 'utf8') / 1048576).toFixed(1)}MB)\n`);
   }
-  indexNote(uuid, { tenant: last.tenant || tenant, tenant_id: last.tenant_id, head_id: last.head_id, head_ms: last.head_ms });
-  return { r: last, before };
+  if (!dryRun) indexNote(uuid, { tenant: last.tenant || tenant, tenant_id: last.tenant_id, head_id: last.head_id, head_ms: last.head_ms });
+  return { r: last, before, parts: parts.length };
 }
 
 /* ── 코로케이션 심박 ───────────────────────────────────────────────────
@@ -1391,7 +1520,16 @@ const TOOLS = [
   },
   {
     name: 'whoami',
-    description: '지금 무엇으로 붙어 있는지 — 고객사 키인지 사람 로그인인지, 사람이면 누구인지.',
+    description: '지금 무엇으로 붙어 있는지 — 사람 로그인인지 소속처 키인지, 사람이면 누구인지.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'list_my_tenants',
+    description:
+      '**내가 속한 곳 목록.** 다른 도구가 요구하는 `tenant` 이름을 여기서 얻는다.\n'
+      + '이름을 모르는 채로 `tenant` 를 **지어내지 말 것** — 이것부터 부르고, 여럿이면 사용자에게 고르게 한다.\n'
+      + '지금 폴더에서 올린 세션이 있는 곳이 위로 온다. 다만 그것은 **순서일 뿐 정답이 아니다** — '
+      + '같은 폴더에서 여러 곳의 일을 하기도 한다.',
     inputSchema: { type: 'object', properties: {} },
   },
   {
@@ -1402,7 +1540,7 @@ const TOOLS = [
   {
     name: 'list_reports',
     description:
-      '이 키가 담당하는 고객사의 문서 목록. 각 줄의 대괄호가 **문서 상태**이고, ' +
+      '내가 닿을 수 있는 문서 목록(사람으로 붙으면 소속처 전부, 키면 그 한 곳). 각 줄의 대괄호가 **문서 상태**이고, ' +
       '무엇으로 만들어졌는지·API 로 읽고 쓸 수 있는지를 서버가 판정해 준다. ' +
       '편집기가 정본인 문서는 API 로 못 고친다 — 사람이 편집 화면에서 고쳐야 한다. ' +
       '응답 끝의 다음 page 안내를 따라가면 100건 뒤의 문서도 볼 수 있다.',
@@ -1442,7 +1580,7 @@ const TOOLS = [
   {
     name: 'publish_report',
     description:
-      '새 보고서를 만든다. 고객사는 키가 정하므로 지정하지 않는다. ' +
+      '새 보고서를 만든다. 키로 붙어 있으면 소속처는 키가 정한다. ' +
       'HTML 을 만들지 말 것 — 내용만 주면 서버가 렌더한다.\n' +
       '**기본은 초안이다** — 만들어도 고객에게는 보이지 않는다. 눈으로 확인한 뒤 ' +
       'release_report 로 열어 준다. 바로 열려면 publish: true 를 명시할 것.\n' +
@@ -1450,7 +1588,7 @@ const TOOLS = [
     inputSchema: {
       type: 'object',
       properties: {
-        tenant: { type: 'string', description: '발행 대상 고객사 이름. 키가 가리키는 고객사와 다르면 거부된다(오발행 방지).' },
+        tenant: { type: 'string', description: '문서를 받을 소속처 이름. 키가 가리키는 곳과 다르면 거부된다(오발행 방지).' },
         slug: { type: 'string', description: '파일 이름이 될 식별자. 영문 소문자·숫자·하이픈 (예: fixes-20260812)' },
         published_at: { type: 'string', description: 'YYYY-MM-DD (생략하면 오늘)' },
         publish: {
@@ -1474,7 +1612,7 @@ const TOOLS = [
     inputSchema: {
       type: 'object',
       properties: {
-        tenant: { type: 'string', description: '대상 고객사 이름. 키와 다르면 거부된다.' },
+        tenant: { type: 'string', description: '대상 소속처 이름. 키와 다르면 거부된다.' },
         id: { type: 'integer' },
         published_at: { type: 'string', description: 'YYYY-MM-DD (생략하면 오늘)' },
       },
@@ -1489,7 +1627,7 @@ const TOOLS = [
     inputSchema: {
       type: 'object',
       properties: {
-        tenant: { type: 'string', description: '대상 고객사 이름. 키와 다르면 거부된다.' },
+        tenant: { type: 'string', description: '대상 소속처 이름. 키와 다르면 거부된다.' },
         id: { type: 'integer' },
         reason: { type: 'string', description: '왜 내리는지. 서버 로그에 남아 다음 사람이 이유를 안다.' },
       },
@@ -1518,7 +1656,7 @@ const TOOLS = [
     inputSchema: {
       type: 'object',
       properties: {
-        tenant: { type: 'string', description: '대상 고객사 이름. 키와 다르면 거부된다(오발행 방지).' },
+        tenant: { type: 'string', description: '대상 소속처 이름. 키와 다르면 거부된다(오발행 방지).' },
         id: { type: 'integer' },
         dry_run: {
           type: 'boolean',
@@ -1533,7 +1671,7 @@ const TOOLS = [
   {
     name: 'remember_case',
     description:
-      '**알아낸 것을 팀의 기억에 적는다** — 증상·원인·처방·근거. 그 고객사 지식의 `cases/` 에 적히고 '
+      '**알아낸 것을 팀의 기억에 적는다** — 증상·원인·처방·근거. 그 소속처 지식의 `cases/` 에 적히고 '
       + '다음에 누가(어느 기계에서든) `search_cases` 로 찾아 쓴다. 같은 제목이면 **덮어쓴다** — '
       + '그래서 「갱신」·「업데이트」도 이 도구다.\n'
       + '언제 부르는가 — 사람이 이런 뜻으로 말할 때 전부 이것이다:\n'
@@ -1549,7 +1687,7 @@ const TOOLS = [
     inputSchema: {
       type: 'object',
       properties: {
-        tenant: { type: 'string', description: '대상 고객사 이름.' },
+        tenant: { type: 'string', description: '대상 소속처 이름.' },
         title: { type: 'string', description: '한 줄 제목. 파일 이름이 된다(같은 제목이면 덮어쓴다).' },
         symptom: { type: 'string', description: '겪은 현상. 원인이 아니라 **눈에 보인 것**을 그대로.' },
         cause: { type: 'string', description: '원인. 모르면 비운다 — 지어내지 않는다.' },
@@ -1563,7 +1701,7 @@ const TOOLS = [
   {
     name: 'search_cases',
     description:
-      '**전에 겪은 적이 있는지 팀의 기억을 뒤진다.** 그 고객사 지식(사례·개념·대상 전부)를 '
+      '**전에 겪은 적이 있는지 팀의 기억을 뒤진다.** 그 소속처 지식(사례·개념·대상 전부)을 '
       + '증상 문장으로 훑어 점수순으로 돌려준다.\n'
       + '언제 부르는가 — 사람이 이런 뜻으로 말할 때 전부 이것이다:\n'
       + '  "전에도 이런 적 있었나" · "우리 이거 겪지 않았나" · "지식에 있나 찾아봐" · '
@@ -1575,7 +1713,7 @@ const TOOLS = [
     inputSchema: {
       type: 'object',
       properties: {
-        tenant: { type: 'string', description: '대상 고객사 이름.' },
+        tenant: { type: 'string', description: '대상 소속처 이름.' },
         q: { type: 'string', description: '증상 문장. 원인이 아니라 현상으로.' },
         limit: { type: 'integer', minimum: 1, maximum: 20, description: '몇 건까지(기본 5).' },
         fast: { type: 'boolean', description: '의미 확장을 건너뛴다(빠르지만 덜 찾는다). 기본은 확장 켬 — '
@@ -1587,12 +1725,12 @@ const TOOLS = [
   {
     name: 'list_sessions',
     description:
-      '이 고객사에 올라와 있는 **작업 세션 대화** 목록. 담당자가 부재일 때 무엇을 이어받을 수 있는지 본다. '
+      '이 소속처에 올라와 있는 **작업 세션 대화** 목록. 담당자가 부재일 때 무엇을 이어받을 수 있는지 본다. '
       + '응답 끝의 다음 page 안내를 따라가면 100건 뒤의 세션도 볼 수 있다.',
     inputSchema: {
       type: 'object',
       properties: {
-        tenant: { type: 'string', description: '대상 고객사 이름.' },
+        tenant: { type: 'string', description: '대상 소속처 이름.' },
         page: {
           type: 'integer', minimum: 1, maximum: 1000,
           description: '목록 page(1부터, 최대 1000). 응답이 알려 준 next를 넣는다.',
@@ -1612,11 +1750,12 @@ const TOOLS = [
       '`claude --resume <uuid>` 로 이어 갈 수 있다.\n' +
       '올라가지 않는 것: 도구 실행 결과·첨부·파일 이력·집 경로·비밀 모양(토큰·비밀번호·개인키). ' +
       '**도구 호출의 짝과 인자는 남는다** — 그게 없으면 대화가 안 열린다.\n' +
-      '쓰기 전에 무엇이 빠지는지만 보고 싶으면 dry_run: true.',
+      '긴 대화는 **알아서 조각으로** 나눠 보내고 서버가 잇는다 — 크기 때문에 사람이 할 일은 없다.\n' +
+      '쓰기 전에 무엇이 빠지는지만 보고 싶으면 dry_run: true(조각도 같은 길을 간다).',
     inputSchema: {
       type: 'object',
       properties: {
-        tenant: { type: 'string', description: '대상 고객사 이름.' },
+        tenant: { type: 'string', description: '대상 소속처 이름.' },
         uuid: { type: 'string', description: '세션 id. `--resume` 에 쓰는 그 값.' },
         title: { type: 'string', description: '목록에서 알아볼 한 줄. 생략하면 빈 값.' },
         dry_run: { type: 'boolean', description: '참이면 아무것도 저장하지 않고 검열 결과만 돌려준다.' },
@@ -1640,7 +1779,7 @@ const TOOLS = [
     inputSchema: {
       type: 'object',
       properties: {
-        tenant: { type: 'string', description: '대상 고객사 이름.' },
+        tenant: { type: 'string', description: '대상 소속처 이름.' },
         uuid: { type: 'string', description: '이어받을 세션 id.' },
         into: { type: 'string', description: '원본 파일을 놓을 자리(생략하면 지금 폴더). '
           + '`--resume` 은 그 폴더의 트랜스크립트를 찾으므로 이 값이 곧 원본을 열 자리다.' },
@@ -1660,7 +1799,7 @@ const TOOLS = [
     inputSchema: {
       type: 'object',
       properties: {
-        tenant: { type: 'string', description: '대상 고객사 이름.' },
+        tenant: { type: 'string', description: '대상 소속처 이름.' },
         uuid: { type: 'string', description: '받을 세션 id.' },
         into: { type: 'string', description: '어느 디렉터리에서 이어 갈 것인가(생략하면 지금 폴더). '
           + '`--resume` 은 그 폴더의 트랜스크립트를 찾으므로 이 값이 곧 이어 갈 자리다.' },
@@ -1737,7 +1876,7 @@ async function callTool(name, args = {}) {
         base: BASE,
       });
       const warn = KEY
-        ? `\n\n⚠ 이 기계에는 고객사 키도 있습니다. **발행은 키로 나갑니다**(좁은 쪽이 기본). `
+        ? `\n\n⚠ 이 기계에는 소속처 키도 있습니다. **발행은 키로 나갑니다**(좁은 쪽이 기본). `
           + `로그인 자격으로 쓰려면 ${ENV_FILE} 의 GENETICS_API_KEY 를 지우세요.`
         : '';
       return `로그인했습니다 — ${data.user.name}(${data.user.email}) · ${data.user.role}\n`
@@ -1765,6 +1904,31 @@ async function callTool(name, args = {}) {
         + `기계: ${me.device_label || '(이름 없음)'} · 만료 ${c.expires_at}${alsoKey}`;
     }
 
+    case 'list_my_tenants': {
+      /*
+       * **폴더를 보내되, 그것으로 고르지 않는다.** 서버는 이 값으로 순서만 매기고 `guess` 를
+       * 안 준다(api.php 의 `/api/tenants` 주석). 여기서도 하나를 골라 주지 않는다 —
+       * **후보가 하나뿐일 때만** 그것이 답이고, 그건 추론이 아니라 선택지가 없는 것이다(§6-4).
+       *
+       * 접는 규칙은 올릴 때와 **같은 함수**를 쓴다. 다르면 서버에 쌓인 값과 안 맞아 조용히 0건이 된다.
+       */
+      const r = await api('GET', `/api/tenants?cwd=${encodeURIComponent(relHome(process.cwd()))}`);
+      const list = Array.isArray(r.tenants) ? r.tenants : [];
+      if (!list.length) return '속한 곳이 없습니다. 관리자에게 담당 지정을 요청하세요.';
+      if (list.length === 1) {
+        return `속한 곳이 하나입니다 — **${list[0].name}**\n`
+             + '다른 도구의 `tenant` 에 이 이름을 그대로 쓰세요.';
+      }
+      const lines = list.map((t) => {
+        const when = t.last_used_at ? String(t.last_used_at).slice(0, 10) : '기록 없음';
+        // 「여기서 N건」은 **순서의 이유**이지 정답이 아니다 — 그렇게 읽히게 적는다.
+        const here = t.sessions_from_here ? ` · 이 폴더에서 ${t.sessions_from_here}건` : '';
+        return `  · ${t.name}${here} · 최근 ${when}`;
+      });
+      return `속한 곳 ${list.length}곳입니다. **사용자에게 어디로 할지 물어보세요** — 고르지 마세요.\n`
+           + `${lines.join('\n')}\n`
+           + (r.cwd ? `(순서는 지금 폴더 ${r.cwd} 기준입니다. 순서일 뿐 정답이 아닙니다.)` : '');
+    }
     case 'logout': {
       if (!credRead()) return '이 기계에는 심긴 로그인 자격이 없습니다.';
       fs.rmSync(CRED_FILE, { force: true });
@@ -1803,7 +1967,7 @@ async function callTool(name, args = {}) {
         return `#${x.id} ${tn}${x.title} (${x.published_at || '미발행'})${sl}${tag}\n    ${x.url}`;
       });
       // 서버가 `tenant: null` 을 주면 「고객사 하나에 매인 자격이 아니다」는 뜻이다.
-      const head = r.tenant === null ? '담당 고객사 전체' : `고객사: ${r.tenant}`;
+      const head = r.tenant === null ? '내 소속처 전부' : `소속처: ${r.tenant}`;
       /*
        * pagination이 없는 옛 서버와도 물린다. 새 서버면 **전체 건수와 현재 범위**를 말하고,
        * next를 그대로 다음 도구 호출로 보여 준다 — 첫 100건만 보인 채 끝나는 막다른 길을
@@ -1965,14 +2129,16 @@ async function callTool(name, args = {}) {
            + (follow.length ? `\n\n${follow.join('\n')}` : '');
     }
     case 'push_session': {
-      const { r, before } = await pushSession(args.tenant, args.uuid, args.title, args.dry_run);
+      const { r, before, parts } = await pushSession(args.tenant, args.uuid, args.title, args.dry_run);
       const cut = `${before.toLocaleString()}B → ${r.bytes.toLocaleString()}B`;
+      // 조각으로 갔으면 말한다 — 크기 때문에 사람이 할 일이 없다는 것을 결과가 보여 준다.
+      const how = parts > 1 ? ` · ${parts}조각으로` : '';
       if (r.dry_run) {
         return `시험 실행 — 아무것도 저장하지 않았습니다.\n`
-             + `${r.tenant} · ${r.lines}줄 · 뺀 레코드 ${r.dropped} · 가린 자리 ${r.redacted} · ${cut}`;
+             + `${r.tenant} · ${r.lines}줄 · 뺀 레코드 ${r.dropped} · 가린 자리 ${r.redacted} · ${cut}${how}`;
       }
       return `${r.replaced ? '갈아 끼웠습니다' : '올렸습니다'} — ${r.tenant} · ${args.uuid.slice(0, 8)}\n`
-           + `${r.lines}줄 · 뺀 레코드 ${r.dropped}(첨부·파일이력) · 가린 자리 ${r.redacted} · ${cut}\n`
+           + `${r.lines}줄 · 뺀 레코드 ${r.dropped}(첨부·파일이력) · 가린 자리 ${r.redacted} · ${cut}${how}\n`
            + '다른 기계에서: pull_session 으로 받은 뒤 그 폴더에서 `claude --resume ' + args.uuid + '`';
     }
     case 'resume_session': {
@@ -1983,10 +2149,22 @@ async function callTool(name, args = {}) {
        * 그래서 서버가 구운 요지를 **응답 본문에 실어** 지금 창의 맥락에 그대로 들어가게 한다 —
        * 붙여넣기+엔터 한 번으로 끝나야 「이어받기」이지, 창을 새로 열어야 하면 절차서다.
        */
+      /*
+       * **두 부름으로 나눈다.**
+       *
+       * 예전에는 한 번에 받았다 — 요지와 본문이 같은 JSON 봉투에 실려 왔고, 본문 10MB 가
+       * 문자열로 힙에 올라온 뒤 `writeFileSync` 가 또 한 벌을 만들었다. 그런데 **본문은 이 창이
+       * 안 읽는다**(한 줄이 197KB 까지 간다). 창이 읽는 것은 요지뿐이다.
+       *
+       *   ① `?no_body=1&digest=1` → 요지와 메타만. 서버가 본문 파일을 **읽지도 않는다**.
+       *   ② `?raw=1`              → ndjson 을 파일로 **흘린다**(apiToFile). 봉투 0벌.
+       *
+       * ②는 파일을 놓을 때만 부른다 — 이미 있으면 안 덮으므로 받을 이유도 없다.
+       */
       const chars = Math.max(2000, Math.min(80000, args.chars || 40000));
+      const q = `?tenant=${encodeURIComponent(args.tenant)}`;
       const r = await api('GET',
-        `/api/sessions/${encodeURIComponent(args.uuid)}?tenant=${encodeURIComponent(args.tenant)}`
-        + `&digest=1&digest_chars=${chars}`);
+        `/api/sessions/${encodeURIComponent(args.uuid)}${q}&no_body=1&digest=1&digest_chars=${chars}`);
       indexNote(args.uuid, { tenant: r.tenant || args.tenant, tenant_id: r.tenant_id, head_id: r.head_id, head_ms: r.head_ms });
 
       // 원본도 제자리에 놓는다 — **덮지 않는다**(pull_session 과 같은 이유).
@@ -1997,8 +2175,7 @@ async function callTool(name, args = {}) {
       if (fs.existsSync(target)) {
         placed = `${target} (이미 있어 그대로 두었습니다 — 덮으면 이 기계에서 하던 대화가 사라집니다)`;
       } else {
-        fs.mkdirSync(dir, { recursive: true });
-        fs.writeFileSync(target, r.jsonl, { mode: 0o600 });
+        await apiToFile(`/api/sessions/${encodeURIComponent(args.uuid)}${q}&raw=1`, target);
       }
 
       /*
@@ -2033,22 +2210,29 @@ async function callTool(name, args = {}) {
            + `\n──────── 이어받은 대화 ────────\n\n${r.digest || '(요지가 비어 있습니다)'}`;
     }
     case 'pull_session': {
-      const r = await api('GET',
-        `/api/sessions/${encodeURIComponent(args.uuid)}?tenant=${encodeURIComponent(args.tenant)}`);
       const into = args.into || process.cwd();
       const dir = transcriptDir(into);
       const target = path.join(dir, `${args.uuid}.jsonl`);
-      // **덮지 않는다.** 같은 uuid 가 이 기계에도 있으면 여기서 하던 대화가 사라진다.
+      /*
+       * **덮지 않는다.** 같은 uuid 가 이 기계에도 있으면 여기서 하던 대화가 사라진다.
+       * ★ 그 검사를 **받기 전에** 한다 — 이 도구는 본문만 받으므로, 뒤에 두면 10MB 를
+       *   다 받아 놓고 버리게 된다(옛 코드가 그랬다).
+       */
       if (fs.existsSync(target)) {
         throw new Error(`이미 있습니다: ${target}\n덮지 않았습니다 — 이 기계에서 하던 대화가 사라집니다.`);
       }
-      fs.mkdirSync(dir, { recursive: true });
-      fs.writeFileSync(target, r.jsonl, { mode: 0o600 });
-      indexNote(args.uuid, { tenant: r.tenant || args.tenant, tenant_id: r.tenant_id, head_id: r.head_id, head_ms: r.head_ms });
-      return `받았습니다 — ${args.uuid.slice(0, 8)} · ${r.lines}줄 · ${(r.bytes / 1024).toFixed(0)}KB\n`
+      // 봉투를 안 만든다 — 메타는 헤더로 온다(apiToFile 주석).
+      const { headers, bytes } = await apiToFile(
+        `/api/sessions/${encodeURIComponent(args.uuid)}?tenant=${encodeURIComponent(args.tenant)}&raw=1`,
+        target);
+      const m = limMeta(headers);
+      indexNote(args.uuid, { tenant: args.tenant, tenant_id: m.tenant_id, head_id: m.head_id, head_ms: m.head_ms });
+      // 헤더를 안 주는 옛 서버면 **지어내지 않는다** — 받은 바이트만 말한다.
+      const size = `${((m.bytes ?? bytes) / 1024).toFixed(0)}KB`;
+      return `받았습니다 — ${args.uuid.slice(0, 8)} · ${m.lines === null ? '' : `${m.lines}줄 · `}${size}\n`
            + `놓은 자리: ${target}\n`
            + `이어서 말하려면: cd ${into} && claude --resume ${args.uuid}\n`
-           + (r.redacted ? `※ 가린 자리 ${r.redacted}곳 — 도구 실행 결과는 안 실려 옵니다. 필요하면 다시 실행하세요.` : '');
+           + (m.redacted ? `※ 가린 자리 ${m.redacted}곳 — 도구 실행 결과는 안 실려 옵니다. 필요하면 다시 실행하세요.` : '');
     }
     default:
       throw new Error(`알 수 없는 도구: ${name}`);
@@ -2131,7 +2315,7 @@ async function handle(line) {
            * **도구 사이의 관계**만 적는다 — 중복하면 둘이 갈라진다.
            */
           instructions: [
-            'Lim 문서 포털 — 고객사 문서 발행, 작업 세션 이식, 사례 기억을 다룬다.',
+            'genetics — 소속처 문서 발행, 작업 세션 이식, 사례 기억을 다룬다.',
             '',
             '무엇을 언제 쓰는가(관계만; 각 도구의 발동 조건은 그 도구 설명에 있다):',
             '· 고객에게 나갈 문서를 만들면 publish_report → release_report. 이미 나간 문서를 고치면 update_report.',
@@ -2145,8 +2329,10 @@ async function handle(line) {
             '· 고객에게 나갈 문서 → publish_report / update_report',
             '무엇인지 모호하면 묻기 전에 search_cases 로 먼저 뒤져 본다 — 이미 있으면 갱신이 답이다.',
             '',
-            '자격은 고객사 키(rpk_) 또는 사람 로그인(login) 하나면 된다. 고객사는 tenant 이름으로 고른다 —',
-            '담당이 아닌 고객사는 존재도 보이지 않으므로, 404 는 "없다"가 아니라 "당신 것이 아니다"일 수 있다.',
+            '자격은 **`login` 으로 받는 SSO 하나면 된다** — 그것으로 내가 속한 소속처 전부에 닿는다.',
+            '키(rpk_)도 쓸 수 있지만 **한 소속처에만** 매이고, 발행할 때만 그쪽이 먼저 쓰인다.',
+            '어디로 갈지는 tenant 에 소속처 **이름**으로 적는다. 이름을 모르면 지어내지 말고 사용자에게 묻는다 —',
+            '내 소속이 아닌 곳은 존재도 안 보이므로, 404 는 "없다"가 아니라 "내 것이 아니다"일 수 있다.',
           ].join('\n'),
         };
       } else if (req.method === 'tools/list') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genetics-mcp",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "description": "문서 포털 발행·세션 이식·사례 기억 MCP — 데이터를 주면 규격 문서가 나온다 (짝인 스킬 동봉)",
   "author": "주식회사 LIM (LIM Inc.)",
   "license": "SEE LICENSE IN LICENSE",