genetics-mcp 2.2.1 → 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 가 그것만 안다).
 // 포털 자체는 문서 종류를 가리지 않지만, 데이터로 발행하는 길은 아직 이 서식뿐이다.
@@ -1018,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 };
 }
 
 /* ── 코로케이션 심박 ───────────────────────────────────────────────────
@@ -1453,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: {} },
   },
   {
@@ -1464,7 +1540,7 @@ const TOOLS = [
   {
     name: 'list_reports',
     description:
-      '이 키가 담당하는 고객사의 문서 목록. 각 줄의 대괄호가 **문서 상태**이고, ' +
+      '내가 닿을 수 있는 문서 목록(사람으로 붙으면 소속처 전부, 키면 그 한 곳). 각 줄의 대괄호가 **문서 상태**이고, ' +
       '무엇으로 만들어졌는지·API 로 읽고 쓸 수 있는지를 서버가 판정해 준다. ' +
       '편집기가 정본인 문서는 API 로 못 고친다 — 사람이 편집 화면에서 고쳐야 한다. ' +
       '응답 끝의 다음 page 안내를 따라가면 100건 뒤의 문서도 볼 수 있다.',
@@ -1504,7 +1580,7 @@ const TOOLS = [
   {
     name: 'publish_report',
     description:
-      '새 보고서를 만든다. 고객사는 키가 정하므로 지정하지 않는다. ' +
+      '새 보고서를 만든다. 키로 붙어 있으면 소속처는 키가 정한다. ' +
       'HTML 을 만들지 말 것 — 내용만 주면 서버가 렌더한다.\n' +
       '**기본은 초안이다** — 만들어도 고객에게는 보이지 않는다. 눈으로 확인한 뒤 ' +
       'release_report 로 열어 준다. 바로 열려면 publish: true 를 명시할 것.\n' +
@@ -1512,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: {
@@ -1536,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 (생략하면 오늘)' },
       },
@@ -1551,7 +1627,7 @@ const TOOLS = [
     inputSchema: {
       type: 'object',
       properties: {
-        tenant: { type: 'string', description: '대상 고객사 이름. 키와 다르면 거부된다.' },
+        tenant: { type: 'string', description: '대상 소속처 이름. 키와 다르면 거부된다.' },
         id: { type: 'integer' },
         reason: { type: 'string', description: '왜 내리는지. 서버 로그에 남아 다음 사람이 이유를 안다.' },
       },
@@ -1580,7 +1656,7 @@ const TOOLS = [
     inputSchema: {
       type: 'object',
       properties: {
-        tenant: { type: 'string', description: '대상 고객사 이름. 키와 다르면 거부된다(오발행 방지).' },
+        tenant: { type: 'string', description: '대상 소속처 이름. 키와 다르면 거부된다(오발행 방지).' },
         id: { type: 'integer' },
         dry_run: {
           type: 'boolean',
@@ -1595,7 +1671,7 @@ const TOOLS = [
   {
     name: 'remember_case',
     description:
-      '**알아낸 것을 팀의 기억에 적는다** — 증상·원인·처방·근거. 그 고객사 지식의 `cases/` 에 적히고 '
+      '**알아낸 것을 팀의 기억에 적는다** — 증상·원인·처방·근거. 그 소속처 지식의 `cases/` 에 적히고 '
       + '다음에 누가(어느 기계에서든) `search_cases` 로 찾아 쓴다. 같은 제목이면 **덮어쓴다** — '
       + '그래서 「갱신」·「업데이트」도 이 도구다.\n'
       + '언제 부르는가 — 사람이 이런 뜻으로 말할 때 전부 이것이다:\n'
@@ -1611,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: '원인. 모르면 비운다 — 지어내지 않는다.' },
@@ -1625,7 +1701,7 @@ const TOOLS = [
   {
     name: 'search_cases',
     description:
-      '**전에 겪은 적이 있는지 팀의 기억을 뒤진다.** 그 고객사 지식(사례·개념·대상 전부)를 '
+      '**전에 겪은 적이 있는지 팀의 기억을 뒤진다.** 그 소속처 지식(사례·개념·대상 전부)을 '
       + '증상 문장으로 훑어 점수순으로 돌려준다.\n'
       + '언제 부르는가 — 사람이 이런 뜻으로 말할 때 전부 이것이다:\n'
       + '  "전에도 이런 적 있었나" · "우리 이거 겪지 않았나" · "지식에 있나 찾아봐" · '
@@ -1637,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: '의미 확장을 건너뛴다(빠르지만 덜 찾는다). 기본은 확장 켬 — '
@@ -1649,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를 넣는다.',
@@ -1674,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: '참이면 아무것도 저장하지 않고 검열 결과만 돌려준다.' },
@@ -1702,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` 은 그 폴더의 트랜스크립트를 찾으므로 이 값이 곧 원본을 열 자리다.' },
@@ -1722,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` 은 그 폴더의 트랜스크립트를 찾으므로 이 값이 곧 이어 갈 자리다.' },
@@ -1799,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`
@@ -1827,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 });
@@ -1865,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건만 보인 채 끝나는 막다른 길을
@@ -2027,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': {
@@ -2045,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 과 같은 이유).
@@ -2059,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);
       }
 
       /*
@@ -2095,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}`);
@@ -2193,7 +2315,7 @@ async function handle(line) {
            * **도구 사이의 관계**만 적는다 — 중복하면 둘이 갈라진다.
            */
           instructions: [
-            'Lim 문서 포털 — 고객사 문서 발행, 작업 세션 이식, 사례 기억을 다룬다.',
+            'genetics — 소속처 문서 발행, 작업 세션 이식, 사례 기억을 다룬다.',
             '',
             '무엇을 언제 쓰는가(관계만; 각 도구의 발동 조건은 그 도구 설명에 있다):',
             '· 고객에게 나갈 문서를 만들면 publish_report → release_report. 이미 나간 문서를 고치면 update_report.',
@@ -2207,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.1",
+  "version": "2.4.0",
   "description": "문서 포털 발행·세션 이식·사례 기억 MCP — 데이터를 주면 규격 문서가 나온다 (짝인 스킬 동봉)",
   "author": "주식회사 LIM (LIM Inc.)",
   "license": "SEE LICENSE IN LICENSE",