genetics-mcp 2.23.0 → 2.25.0

package/skills/genetics-report/assets/example/cases.json

@@ -6,7 +6,7 @@
     "symptom": "주문서를 작성하고 저장을 눌러도 목록으로 돌아오면 그 주문이 보이지 않던 상황. 새로고침을 한 번 더 하면 나타났음.",
     "cause": "저장이 끝나기 전에 목록을 다시 불러오고 있어, 저장 직전 상태가 화면에 남았음.",
     "fix": "저장이 끝난 뒤에 목록을 불러오도록 순서를 바꿈. 운영 환경에서 주문서를 실제로 작성·저장해 목록에 바로 나타나는 것까지 확인함.",
-    "how_to_check": "주문서를 하나 작성해 저장하고 목록으로 돌아와 볼 것. 새로고침 없이 바로 보이면 정상임."
+    "how_to_check": "주문서를 하나 작성해 저장하면 목록에 새로고침 없이 바로 보임."
   },
   {
     "group": "own",
@@ -15,7 +15,7 @@
     "symptom": "주문이 많은 지점에서 목록 첫 화면이 뜨기까지 10초 넘게 걸리던 상황.",
     "cause": "목록을 그릴 때마다 전체 항목을 훑고 있었음. 건수가 늘수록 시간이 비례해 늘어남.",
     "fix": "자주 쓰는 조회 조건에 조회 색인을 걸어 필요한 만큼만 읽도록 바꿈. 운영 데이터를 건별로 대조해 결과가 같은 것을 확인함.",
-    "how_to_check": "주문이 가장 많은 지점의 목록을 열어 볼 것. 첫 화면이 1초 안에 뜨면 정상임.",
-    "remaining": "목록 위 총 건수가 예전 데이터 때문에 실제보다 몇 건 많게 나올 수 있는 상황. 실제 수치와 대조해 알려 주시면 기준을 맞출 예정."
+    "how_to_check": "주문이 가장 많은 지점의 목록도 첫 화면이 1초 안에 뜸.",
+    "remaining": "목록 위 총 건수가 예전 데이터 때문에 실제보다 몇 건 많게 나올 수 있는 상황. 기준은 실제 수치와 대조한 결과를 받은 뒤 맞출 예정."
   }
 ]

package/skills/genetics-report/assets/example/report-briefing-designs.json

@@ -4,7 +4,7 @@
   "lang": "ko",
   "doc_type": "도안 결재 브리핑",
   "title_tag": "설정 변경 안내 도안 결재 · 예시 고객사",
-  "description": "알림 설정을 바꾼 이용자에게 보여 줄 안내를 세 도안 가운데 하나로 정하기 위한 브리핑. 세 도안의 화면과 견줌, 근거, 시험판 확인을 정리함",
+  "description": "알림 설정을 바꾼 이용자에게 보여 줄 안내를 세 도안 가운데 하나로 정하기 위한 브리핑. 세 도안의 화면과 견줌, 근거, <독자 화면의 채널 이름> 앱 확인을 정리함",
   "doc_no": "LIM-2026-0901-03",
   "client": "예시 고객사",
   "kicker": "우리회사 · 예시 고객사",
@@ -25,7 +25,7 @@
     ],
     [
       "확인 요청",
-      "시험판 화면 1건"
+      "<독자 화면의 채널 이름> 앱 화면 1건"
     ],
     [
       "회신 기한",
@@ -44,7 +44,7 @@
     {
       "no": 1,
       "date": "2026. 9. 1.",
-      "note": "최초 발행. 세 도안의 화면과 견줌, 시험판 확인을 정리함."
+      "note": "최초 발행. 세 도안의 화면과 견줌, <독자 화면의 채널 이름> 앱 확인을 정리함."
     }
   ],
   "guide": [
@@ -65,7 +65,7 @@
     {
       "q": "회신 뒤에 할 일이 또 있는가?",
       "a": [
-        "시험판에서 고른 도안의 화면을 확인하는 일 하나임.",
+        "<독자 화면의 채널 이름> 앱에서 고른 도안의 화면을 확인하는 일 하나임.",
         "기한은 01절 둘째 항목, 볼 경우는 07절 표 7-2."
       ]
     },
@@ -86,7 +86,7 @@
   ],
   "notice": {
     "state": "info",
-    "text": "정할 것은 안내 도안 1건, 2026. 9. 30.까지임. 시험판 확인은 받으신 뒤 7일 안임."
+    "text": "정할 것은 안내 도안 1건, 2026. 9. 30.까지임. <독자 화면의 채널 이름> 앱 확인은 받으신 뒤 7일 안임."
   },
   "stats": [
     {
@@ -127,7 +127,7 @@
     ],
     "추정": [
       "m-est",
-      "사례·전망에 기댄 값임. 시험판 실측으로 갱신될 때까지 잠정."
+      "사례·전망에 기댄 값임. <독자 화면의 채널 이름> 앱 실측으로 갱신될 때까지 잠정."
     ]
   },
   "labels": {
@@ -164,10 +164,10 @@
       "no": "3",
       "title": "이행",
       "tone": "wait",
-      "lede": "고른 도안의 위험과 회신 뒤 일정, 시험판에서 볼 경우.",
+      "lede": "고른 도안의 위험과 회신 뒤 일정, <독자 화면의 채널 이름> 앱에서 볼 경우.",
       "questions": [
         "고른 도안에서 무엇이 잘못될 수 있는가?",
-        "시험판에서 무엇을 보면 되는가?"
+        "<독자 화면의 채널 이름> 앱에서 무엇을 보면 되는가?"
       ]
     }
   ],
@@ -185,10 +185,10 @@
       "part": "1",
       "short": "결정 요청",
       "sub": "회신이 필요한 도안 1건과 확인 1건",
-      "lede": "**세 도안 가운데 하나**를 고르는 일과, 고른 도안을 시험판에서 확인하는 일 두 가지.",
+      "lede": "**세 도안 가운데 하나**를 고르는 일과, 고른 도안을 <독자 화면의 채널 이름> 앱에서 확인하는 일 두 가지.",
       "marg": {
         "why": "무엇을 정해 달라는 것인가?",
-        "key": "안내에 쓸 도안 하나와 시험판 확인 하나.",
+        "key": "안내에 쓸 도안 하나와 <독자 화면의 채널 이름> 앱 확인 하나.",
         "advice": "세 도안을 견준 표 1-1, 뜨는 조건은 표 1-2."
       },
       "tables": [
@@ -376,7 +376,7 @@
       "tone": "hold",
       "short": "의견",
       "sub": "사실과 갈라 둔 의견",
-      "lede": "03·04절의 사실을 보고 우리회사가 맞다고 보는 도안. 의견이며, 정하는 것은 01절 회신임.",
+      "lede": "03·04절의 사실을 보고 우리회사가 맞다고 보는 도안. 의견이며, 어느 도안으로 갈지는 01절 회신이 정함.",
       "marg": {
         "why": "우리회사는 어느 도안이 맞다고 보는가?",
         "key": "의견은 이 표 한 장에만 둠.",
@@ -431,7 +431,7 @@
       "marg": {
         "why": "고른 도안에서 무엇이 잘못될 수 있는가?",
         "key": "첫 화면을 막는 도안 A 는 닫기 단추 크기로 줄임.",
-        "advice": "근거 등급이 「추정」인 행은 시험판에서 갱신."
+        "advice": "근거 등급이 「추정」인 행은 <독자 화면의 채널 이름> 앱에서 갱신."
       },
       "tables": [
         {
@@ -477,11 +477,11 @@
       "part": "3",
       "tone": "neutral",
       "short": "일정",
-      "sub": "누가 무엇을 언제, 시험판에서 볼 경우",
-      "lede": "회신에 따라 우리회사가 할 일과, 시험판에서 확인할 경우.",
+      "sub": "누가 무엇을 언제, <독자 화면의 채널 이름> 앱에서 볼 경우",
+      "lede": "회신에 따라 우리회사가 할 일과, <독자 화면의 채널 이름> 앱에서 확인할 경우.",
       "marg": {
         "why": "회신하면 무엇이 언제 일어나는가?",
-        "key": "회신 후 14일 안에 시험판을 전달함.",
+        "key": "회신 후 14일 안에 <독자 화면의 채널 이름> 앱을 전달함.",
         "advice": "일정의 주어는 우리회사임."
       },
       "tables": [
@@ -501,23 +501,23 @@
             [
               "도안 A 확인 창",
               "우리회사",
-              "회신 후 14일 안 시험판"
+              "회신 후 14일 안 <독자 화면의 채널 이름> 앱"
             ],
             [
               "도안 B 홈 카드",
               "우리회사",
-              "회신 후 14일 안 시험판"
+              "회신 후 14일 안 <독자 화면의 채널 이름> 앱"
             ],
             [
               "도안 C 상단 띠",
               "우리회사",
-              "회신 후 21일 안 시험판"
+              "회신 후 21일 안 <독자 화면의 채널 이름> 앱"
             ]
           ],
           "note": "도안 C 는 띠 모양을 새로 그려 일주일이 더 걸림."
         },
         {
-          "caption": "시험판 확인 프로필",
+          "caption": "<독자 화면의 채널 이름> 앱 확인 프로필",
           "cols": [
             "확인 프로필",
             "만드는 법",
@@ -582,8 +582,8 @@
     },
     {
       "label": "정할 것",
-      "lead": "정할 것은 도안 하나이고, 고른 도안은 시험판에서 한 번 더 확인함.",
-      "body": "회신 후 14일 안에 시험판을 전달함(도안 C 는 21일). 확인할 네 경우는 07절 표 7-2 에 있음(§4.2).",
+      "lead": "정할 것은 도안 하나임. 고른 도안의 <독자 화면의 채널 이름> 앱 확인은 01절 둘째 항목에서 요청함.",
+      "body": "회신 후 14일 안에 <독자 화면의 채널 이름> 앱을 전달함(도안 C 는 21일). 확인할 네 경우는 07절 표 7-2 에 있음(§4.2).",
       "refs": [
         "4.2"
       ]
@@ -609,8 +609,8 @@
       ]
     },
     {
-      "title": "시험판에서 고른 도안의 화면 확인 요청",
-      "body": "시험판을 받으신 뒤 7일 안에 확인 프로필 표(회신 뒤 일정 절)의 네 경우대로 보이는지 확인해 주시기 바랍니다. 표와 다르게 보이면 그 화면을 회신해 주시기 바랍니다.",
+      "title": "<독자 화면의 채널 이름> 앱에서 고른 도안의 화면 확인 요청",
+      "body": "<독자 화면의 채널 이름> 앱을 받으신 뒤 7일 안에 확인 프로필 표(회신 뒤 일정 절)의 네 경우대로 보이는지 확인해 주시기 바랍니다. 표와 다르게 보이면 그 화면을 회신해 주시기 바랍니다.",
       "refs": [
         "4.2"
       ]
@@ -682,7 +682,7 @@
         ],
         [
           "추정",
-          "사례·전망에 기댄 값임. 시험판 실측으로 갱신될 때까지 잠정."
+          "사례·전망에 기댄 값임. <독자 화면의 채널 이름> 앱 실측으로 갱신될 때까지 잠정."
         ]
       ],
       "note": "직접 확인이 아니면 한 단 내리고, 이해관계가 있는 출처면 또 한 단 내림. 올려 적지 않음."
@@ -731,8 +731,8 @@
     ],
     "mark": "이 브리핑의 사실은 2026. 9. 1. 기준임.",
     "badge": "고객 공유용",
-    "note": "※ 이 문서에는 입력·저장 기능이 없음. 회신은 이 문서를 보낸 담당자에게 보내 주시기 바랍니다.",
-    "tail": "회신 뒤 일정은 표 7-1 대로 진행하고, 시험판 확인으로 이어짐."
+    "note": "※ 이 문서에는 입력·저장 기능이 없습니다. 회신은 이 문서를 보낸 담당자에게 보내 주시기 바랍니다.",
+    "tail": "회신 뒤 일정은 표 7-1 대로 진행하고, <독자 화면의 채널 이름> 앱 확인으로 이어짐."
   },
   "forbid": [
     "(은|는|을|를) 제외(함|됨|했음|했다|한다|하였음|하였다)",

package/skills/genetics-report/assets/example/report-briefing.json

@@ -73,7 +73,7 @@
       "q": "우리회사 의견은 어디에 있는가?",
       "a": [
         "05절 한 곳에만 둠.",
-        "정하는 것은 01절 회신임."
+        "판단 항목은 01절 한 곳에 둠."
       ]
     }
   ],
@@ -345,7 +345,7 @@
       "tone": "hold",
       "short": "의견",
       "sub": "사실과 갈라 둔 의견",
-      "lede": "03·04절의 사실을 보고 우리회사가 맞다고 보는 쪽. 의견이며, 정하는 것은 01절 회신임.",
+      "lede": "03·04절의 사실을 보고 우리회사가 맞다고 보는 쪽. 의견이며, 어느 쪽으로 갈지는 01절 회신이 정함.",
       "marg": {
         "why": "우리회사는 어느 쪽이 맞다고 보는가?",
         "key": "의견은 이 표 한 장에만 둠.",
@@ -647,7 +647,7 @@
     ],
     "mark": "이 브리핑의 수치는 2026년 8월 27일 기준임.",
     "badge": "고객 공유용",
-    "note": "※ 이 문서에는 입력·저장 기능이 없음. 회신은 이 문서를 보낸 담당자에게 보내 주시기 바랍니다.",
+    "note": "※ 이 문서에는 입력·저장 기능이 없습니다. 회신은 이 문서를 보낸 담당자에게 보내 주시기 바랍니다.",
     "tail": "회신 뒤 일정은 07절 표대로 진행하고, 첫 분기 실측 보고로 이어짐."
   },
   "forbid": [

package/skills/genetics-report/assets/example/report.json

@@ -11,7 +11,7 @@
   "kicker": "우리회사 · 예시 고객사",
   "title": "시스템 수정 내역",
   "title_sub": "1차 보고",
-  "subtitle": "처리한 2건과, 확인이 필요한 1건을 정리한 것임. 검수 결과는 이 문서를 보낸 담당자에게 회신해 주시기 바랍니다.",
+  "subtitle": "처리한 2건과, 확인이 필요한 1건을 정리한 것임.",
   "cover_date": "2026. 8. 24.",
   "issuer": ["우리회사", "예시 고객사", "2026. 8."],
   "running_footer": "예시 고객사 · LIM-2026-0824-01",
@@ -32,14 +32,14 @@
     { "q": "시간이 없다면 어디를 봐야 하는가?",
       "a": ["01절 확인 요청 1건이 조치 사항의 전부임.", "나머지 절은 그 근거."] },
     { "q": "어디까지 확인한 것인가?",
-      "a": ["03절 대조표의 「확인 방법」 열 참조.", "판정 기준은 부록 1.", "확인하지 않은 범위는 06절에 따로 적어 둠."] },
+      "a": ["「확인 방법」은 03절 대조표의 열에 있음.", "판정 기준은 부록 1.", "확인하지 않은 범위는 06절에 따로 적어 둠."] },
     { "q": "각 절 왼쪽 여백의 표식은?",
       "a": ["Why 는 그 절이 답하는 질문.", "Key Point 는 이 절에서 하나만 가져간다면 그것.", "Advice 는 어디를 더 볼 것인가."] },
     { "q": "인쇄하려면?",
-      "a": ["브라우저 인쇄 대화상자에서 「머리글 및 바닥글」 체크 해제 필요.", "그대로 두면 브라우저 주소가 페이지마다 찍힘."] }
+      "a": ["「머리글 및 바닥글」이 켜져 있으면 브라우저 주소가 페이지마다 찍힘.", "인쇄 대화상자에서 그 칸을 끄면 주소 없이 인쇄됨."] }
   ],
 
-  "notice": { "state": "info", "text": "접수 1건 처리 완료. 확인 요청 1건이 남아 있음." },
+  "notice": { "state": "info", "text": "접수 1건 처리 완료. 확인 요청 1건이 남아 있음(8월 31일까지)." },
   "bar": [
     { "value": 2, "label": "처리 완료", "tone": "done" },
     { "value": 1, "label": "확인 요청", "tone": "wait" }
@@ -59,7 +59,7 @@
 
   "parts": [
     { "no": "1", "title": "요청", "tone": "you",
-      "lede": "확인·처리가 필요한 사항. 이 PART 가 수신 측 조치 사항의 전부임.",
+      "lede": "확인·처리를 부탁드리는 사항입니다. 이 PART 가 수신 측에서 하실 일의 전부입니다.",
       "questions": ["무엇을 확인해야 하는가?", "그 판단의 근거는 어디에 있는가?"] },
     { "no": "2", "title": "경과", "tone": "neutral",
       "lede": "처리한 것과 그 근거.",
@@ -126,7 +126,7 @@
       "marg": {
         "why": "요청하지 않은 것을 왜 고쳤는가?",
         "key": "같은 화면에서 함께 드러난 건이라 함께 처리함.",
-        "advice": "03절 대조표와 함께 읽을 것."
+        "advice": "03절 대조표."
       } },
 
     { "no": "06", "id": "sec-6", "label": "06", "name": "이번 확인의 한계", "kind": "note", "part": "3",
@@ -158,15 +158,15 @@
     { "lead": "두 건은 같은 화면에서 함께 드러난 것임.",
       "body": "목록을 그리는 자리가 하나라, 저장 반영과 표시 속도가 같은 지점에서 갈렸음(§4.1). 그래서 함께 처리함.",
       "refs": ["4.1"] },
-    { "lead": "확인이 필요한 것은 1건임.",
-      "body": "총 건수 표시가 실제와 다르게 나올 수 있는 상황임(§5.1). 확인이 필요한 항목은 01절에 모아 둠.",
+    { "lead": "확인 요청은 1건임.",
+      "body": "총 건수 표시가 실제와 다르게 나올 수 있는 상황임(§5.1). 요청은 01절에 있고 기한은 2026년 8월 31일임.",
       "refs": ["5.1"] }
   ],
 
   "open_items": [
-    { "title": "목록 위 총 건수 표시 확인 요청",
+    { "title": "목록 위 총 건수 표시 확인 요청(2026. 8. 31.까지)",
       "priority": "must",
-      "body": "총 건수가 예전 데이터 때문에 실제보다 몇 건 많게 나올 수 있는 상황. 목록에 표시되는 내용 자체는 정상임. 실제 수치와 대조해 알려 주시면 기준을 맞추겠습니다.",
+      "body": "총 건수가 예전 데이터 때문에 실제보다 몇 건 많게 나올 수 있습니다. 목록에 표시되는 내용 자체는 정상입니다. 실제 수치와 대조해 알려 주시면 기준을 맞추겠습니다.",
       "refs": ["5.1"] }
   ],
 
@@ -192,7 +192,7 @@
     ],
     "mark": "이 문서는 2026년 8월 24일 기준임.",
     "badge": "고객 공유용",
-    "note": "※ 이 문서에는 입력·저장 기능이 없음. 검수 결과는 이 문서를 보낸 담당자에게 회신해 주시기 바랍니다.",
+    "note": "※ 이 문서에는 입력·저장 기능이 없습니다. 검수 결과는 이 문서를 보낸 담당자에게 회신해 주시기 바랍니다.",
     "tail": "이후 진행 사항은 다음 보고로 공유함."
   },
 

package/skills/genetics-report/assets/mcp-call.mjs

@@ -0,0 +1,160 @@
+// 큰 원고를 MCP 도구에 **파일로** 넘긴다 — 채팅의 도구 인자로 싣지 않는다.
+//
+// ## 왜 이 파일이 생겼나 (2026-09-22)
+//
+// 관보 원고는 자산 바이트를 품어 쉽게 100~200KB 가 된다(한 회차 실측: 177,573B).
+// 그대로 도구 인자에 실으면 대화 문맥을 통째로 쓰고, 그 뒤 작업이 못 돈다.
+// 그래서 회차마다 고객사 문서 폴더에 이 우회를 다시 짰고 — 실측 2026-09-22 기준
+// **5벌**(20·20·20·50·36줄)이 제각각 갈라져 있었다. 없애야 할 중복이 아니라
+// **genetics 에 없던 기능**이라 그렇게 된 것이므로, 여기 한 벌로 둔다.
+//
+// 자격·검증은 채팅에서 부를 때와 **같다** — 서버가 SSO 자격을 스스로 읽는다.
+// 이 파일은 전송만 바꾼다(stdio JSON-RPC). 도구의 판단을 흉내 내지 않는다.
+//
+// ## 쓰는 법
+//
+//     node assets/mcp-call.mjs [--no-mail] [--json] <도구 이름> <인자.json> [결과.txt]
+//
+//     node assets/mcp-call.mjs update_report args-dry.json out-dry.txt
+//     node assets/mcp-call.mjs get_report '{"id":<id>,"tenant":"<tenant>"}' out.txt   # 작은 인자는 인라인도 받는다
+//     node assets/mcp-call.mjs --no-mail --json get_report '{"id":<id>,"tenant":"<tenant>"}' report.rev28.json   # 받은 판 — JSON 만
+//
+// `--json` — 도구 출력에서 **줄 머리에서 시작하는 첫 JSON 값**만 결과 파일(없으면 표준 출력)에 쓰고, 머리줄·꼬리 줄(판번호·
+// 그림 보관 안내·메일·세계 소식)은 표준 오류로 보인다. get_report 출력을 그대로 쓰면 patch.py·render.py 가 JSON 을 못 읽는다
+// (머리만 떼도 꼬리 줄이 남는다 — 2026-09-30 적대 검토). JSON 이 없거나 도구가 오류를 내면 종료 1 이고 **결과 파일을 쓰지 않는다**
+// (같은 이름으로 받아 둔 판을 오류 글로 덮지 않는다 — 까닭은 표준 오류로 보인다).
+//
+// `--no-mail` — 프로그램이 한 번 읽고 버리는 호출용(render.py·발행 직전 훅). 부르는 쪽 세션의 신원을 자식에게
+// 안 물려준다. 물려주면 genetics.mjs 가 그 세션으로 알고 도구를 부를 때마다 그 세션 앞 메일을 긷고
+// 「받음」 도장(/api/mail/ack)을 찍는데, 이 파일은 응답을 쓰고 서버를 죽이므로 그 메일은 아무도 못 읽는다.
+// 옵션이 없으면 지금과 같다(부모 env 를 그대로 물려준다).
+//
+// 서버 위치(정본은 이 줄 — 다른 문서는 여기를 가리킨다): `GENETICS_MCP` → 이 파일의 자리(저장소 안의 스킬이면 ../../../genetics.mjs) → 없으면
+// `npx -y genetics-mcp`(게시본). `GENETICS_MCP` 가 없는 파일을 가리키면 종료 2 로 멈춘다 — 다음 자리로 넘어가지 않는다.
+// npm 설치본은 스킬을 ~/.claude/skills 로 **복사**해 깔아 옆에 genetics.mjs 가 없다 — 그 기계에서도 같은 명령이 돈다(2026-09-30 적대 검토).
+// 종료 코드: 0 성공 · 1 도구·프로토콜 오류 · 2 쓰는 법 틀림.
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const HERE = path.dirname(fileURLToPath(import.meta.url));
+// assets/ → genetics-report/ → skills/ → mcp/genetics.mjs
+const LOCAL = path.resolve(HERE, '../../../genetics.mjs');
+const SERVER = process.env.GENETICS_MCP || (fs.existsSync(LOCAL) ? LOCAL : null);
+const SERVER_CMD = SERVER ? ['node', [SERVER]] : ['npx', ['-y', 'genetics-mcp']];
+
+const argv = process.argv.slice(2);
+const noMail = argv.includes('--no-mail');
+const jsonOnly = argv.includes('--json');
+const [tool, argsArg, outPath] = argv.filter((a) => a !== '--no-mail' && a !== '--json');
+if (!tool || !argsArg) {
+  console.error('쓰기: node mcp-call.mjs [--no-mail] [--json] <도구 이름> <인자.json|인라인 JSON> [결과.txt]');
+  process.exit(2);
+}
+if (process.env.GENETICS_MCP && !fs.existsSync(process.env.GENETICS_MCP)) {
+  console.error(`✗ MCP 서버를 못 찾았습니다: ${process.env.GENETICS_MCP}\n  GENETICS_MCP=/경로/genetics.mjs 로 알려 주세요.`);
+  process.exit(2);
+}
+// 인자는 파일이 기본이다 — 큰 원고가 이 도구의 존재 이유다. 인라인은 작은 호출의 편의.
+let args;
+try {
+  args = JSON.parse(argsArg.trimStart().startsWith('{') ? argsArg : fs.readFileSync(argsArg, 'utf8'));
+} catch (e) {
+  console.error(`✗ 인자를 못 읽었습니다: ${e.message}`);
+  process.exit(2);
+}
+
+/*
+ * --no-mail 의 자식 env. 끄는 문은 genetics.mjs 가 가진 것만 쓴다(여기서 판정을 흉내 내지 않는다):
+ *   세션 env 셋을 지운다 — mySessionId()·hookLane() 이 「지금 이 세션」으로 읽는 값(CLAUDE_CODE_SESSION_ID, Cursor 둘).
+ *   GENETICS_HOOK_LANE=0 — 도구 호출 때 긷는 문(hookLane() && mailPollReady())을 닫는다. env 를 지워도 Cursor 원장
+ *     파일(active-cursor-*.json)만으로 hookLane 이 참이 되어 그 대화 앞 메일을 긷는다(격리 실측 2026-09-26).
+ *   GENETICS_NO_BEAT=1 — 훅 레인이 없는 세션의 60초 긷기 타이머(startSchedule)를 닫는다. 위 줄만 두면 뜨자마자 돈다.
+ */
+const SESSION_ENV = ['CLAUDE_CODE_SESSION_ID', 'CURSOR_CONVERSATION_ID', 'CURSOR_WORKSPACE_LABEL'];
+function noMailEnv() {
+  const env = { ...process.env, GENETICS_HOOK_LANE: '0', GENETICS_NO_BEAT: '1' };
+  for (const k of SESSION_ENV) delete env[k];
+  return env;
+}
+
+const srv = spawn(SERVER_CMD[0], SERVER_CMD[1], { stdio: ['pipe', 'pipe', 'inherit'], ...(noMail ? { env: noMailEnv() } : {}) });
+srv.on('error', (e) => { console.error(`✗ 서버를 못 띄웠습니다: ${e.message}`); process.exit(1); });
+
+let buf = '';
+const pending = new Map();
+// 파이프는 64KiB 조각으로 온다 — 조각마다 따로 글자로 풀면 경계에 걸친 한글 한 글자가 U+FFFD(�) 둘~셋으로 바뀐다(종료 0 · JSON 도 읽힌다).
+// 받은 판이 새 판의 출발점이라 그 글자가 그대로 발행 인자에 실린다(2026-09-30 검토 — 9/14~9/22 의 받은 사본 7벌에 실제로 남아 있었다).
+// 스트림에 디코더를 달아 조각 경계를 넘겨 푼다.
+srv.stdout.setEncoding('utf8');
+srv.stdout.on('data', (d) => {
+  buf += d;
+  let i;
+  while ((i = buf.indexOf('\n')) >= 0) {
+    const line = buf.slice(0, i);
+    buf = buf.slice(i + 1);
+    if (!line.trim()) continue;
+    let msg;
+    try { msg = JSON.parse(line); } catch { continue; }   // 서버가 섞어 내는 사람 글은 건너뛴다
+    if (msg.id != null && pending.has(msg.id)) { pending.get(msg.id)(msg); pending.delete(msg.id); }
+  }
+});
+
+let nextId = 1;
+const call = (method, params) => new Promise((resolve) => {
+  const id = nextId++;
+  pending.set(id, resolve);
+  srv.stdin.write(JSON.stringify({ jsonrpc: '2.0', id, method, params }) + '\n');
+});
+
+await call('initialize', {
+  protocolVersion: '2025-06-18', capabilities: {},
+  clientInfo: { name: 'mcp-call', version: '1' },
+});
+srv.stdin.write(JSON.stringify({ jsonrpc: '2.0', method: 'notifications/initialized', params: {} }) + '\n');
+
+const r = await call('tools/call', { name: tool, arguments: args });
+const text = (r.result?.content || []).map((c) => c.text || '').join('\n');
+const out = r.error
+  ? 'ERROR ' + JSON.stringify(r.error)
+  : (r.result?.isError ? 'TOOL_ERROR\n' : '') + text;
+srv.kill();
+const failed = Boolean(r.error || r.result?.isError);
+// 표준 출력으로 낼 때는 **쓰기가 끝난 뒤에** 끝낸다 — 곧바로 exit 하면 파이프로 받는 쪽(셸 파이프 · 파이썬 capture_output)이 64KiB 에서
+// 잘린 출력을 종료 0 과 함께 받는다(2026-09-30 검토). 파일로 쓸 때는 동기 쓰기라 그대로 끝낸다.
+const finish = (s, code) => {
+  if (outPath) { fs.writeFileSync(outPath, s); process.exit(code); }
+  process.stdout.write(s, () => process.exit(code));
+};
+if (!jsonOnly) finish(outPath ? out : out + '\n', failed ? 1 : 0);
+else if (failed) {
+  // 오류면 결과 파일을 건드리지 않는다 — 같은 이름으로 받아 둔 판을 「TOOL_ERROR …」 글로 덮지 않게. 까닭은 화면(표준 오류)에 보인다.
+  console.error(`✗ 도구가 오류를 냈습니다 — 결과 파일은 쓰지 않았습니다\n${out}`);
+  process.exit(1);
+} else {
+  const got = firstJson(text);
+  if (!got) { console.error(`✗ 도구 출력에 JSON 이 없습니다 — ${text.split('\n')[0].slice(0, 200)}`); process.exit(1); }
+  const rest = (got.before + got.after).trim();
+  if (rest) console.error(rest);   // 머리·꼬리 줄(판번호 등)은 사람 눈에 — 결과 파일에는 JSON 만
+  finish(got.json + '\n', 0);
+}
+
+/** 줄 머리에서 시작하는 첫 JSON 값(객체·배열) — 문자열 안의 괄호는 안 센다. 못 읽으면 다음 후보로 넘어간다. */
+function firstJson(s) {
+  for (let i = 0; i < s.length; i++) {
+    if ((s[i] !== '{' && s[i] !== '[') || (i > 0 && s[i - 1] !== '\n')) continue;
+    let depth = 0, inStr = false, esc = false;
+    for (let j = i; j < s.length; j++) {
+      const ch = s[j];
+      if (inStr) { if (esc) esc = false; else if (ch === '\\') esc = true; else if (ch === '"') inStr = false; continue; }
+      if (ch === '"') inStr = true;
+      else if (ch === '{' || ch === '[') depth++;
+      else if ((ch === '}' || ch === ']') && --depth === 0) {
+        const json = s.slice(i, j + 1);
+        try { JSON.parse(json); return { json, before: s.slice(0, i), after: s.slice(j + 1) }; } catch { break; }
+      }
+    }
+  }
+  return null;
+}