genetics-mcp 2.22.0 → 2.24.0

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,109 @@
+// 큰 원고를 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> [결과.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   # 작은 인자는 인라인도 받는다
+//
+// `--no-mail` — 프로그램이 한 번 읽고 버리는 호출용(render.py·발행 직전 훅). 부르는 쪽 세션의 신원을 자식에게
+// 안 물려준다. 물려주면 genetics.mjs 가 그 세션으로 알고 도구를 부를 때마다 그 세션 앞 메일을 긷고
+// 「받음」 도장(/api/mail/ack)을 찍는데, 이 파일은 응답을 쓰고 서버를 죽이므로 그 메일은 아무도 못 읽는다.
+// 옵션이 없으면 지금과 같다(부모 env 를 그대로 물려준다).
+//
+// 서버 위치는 이 파일의 자리에서 찾고(스킬은 레포 안에 산다), `GENETICS_MCP` 로 덮어쓸 수 있다.
+// 종료 코드: 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 SERVER = process.env.GENETICS_MCP || path.resolve(HERE, '../../../genetics.mjs');
+
+const argv = process.argv.slice(2);
+const noMail = argv.includes('--no-mail');
+const [tool, argsArg, outPath] = argv.filter((a) => a !== '--no-mail');
+if (!tool || !argsArg) {
+  console.error('쓰기: node mcp-call.mjs [--no-mail] <도구 이름> <인자.json|인라인 JSON> [결과.txt]');
+  process.exit(2);
+}
+if (!fs.existsSync(SERVER)) {
+  console.error(`✗ MCP 서버를 못 찾았습니다: ${SERVER}\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('node', [SERVER], { stdio: ['pipe', 'pipe', 'inherit'], ...(noMail ? { env: noMailEnv() } : {}) });
+srv.on('error', (e) => { console.error(`✗ 서버를 못 띄웠습니다: ${e.message}`); process.exit(1); });
+
+let buf = '';
+const pending = new Map();
+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;
+if (outPath) fs.writeFileSync(outPath, out); else process.stdout.write(out + '\n');
+srv.kill();
+process.exit(r.error || r.result?.isError ? 1 : 0);

package/skills/genetics-report/assets/patch.py

@@ -0,0 +1,196 @@
+#!/usr/bin/env python3
+"""원고 부분 고치기 — **멱등**. 회차마다 스크립트를 다시 짓지 않게 한다.
+
+## 왜 이 파일이 생겼나 (2026-09-22)
+
+포털은 「통째로 바꾸기」(`update_report`)만 준다. 그래서 회차마다 「이 문장을 저 문장으로」를
+적용하는 파이썬을 고객사 문서 폴더에 새로 지었고, 그것이 쌓였다 — 실측: 앳플리 #31 의
+문서 폴더에 20개 2,563줄, RDS 8.4 폴더에 46개 4,285줄(`edit-<날짜><글자>.py` 만 34개).
+매번 같은 뼈대(`rep`·`setv`·`droprows`·멱등·금지어 쓸기)를 다시 썼고, 다시 쓸 때마다 같은
+결함을 다시 만들었다(2026-09-21: `zip` 이 짧은 쪽에 맞춰 잘리는 탓에 `droprows` 가 두 번째
+실행에서 남은 줄 하나를 지웠다 — 여기서는 길이 검사로 막는다).
+
+**고치는 내용은 그 회차의 것이지만, 고치는 방법은 아니다.** 방법만 여기 두고,
+회차 폴더에는 **데이터 파일 하나**(edits.json)만 남긴다.
+
+## 쓰는 법
+
+    python3 patch.py report.json edits.json           # 적용
+    python3 patch.py report.json edits.json --dry     # 재 보기만(파일 안 건드림)
+
+`edits.json` 은 목록이고, 각 항목은 `op` 하나다. `path` 는 원고 JSON 의 자리를
+`["sections", 1, "lede"]` 처럼 적는다(문자열 `"sections[1].lede"` 도 받는다).
+
+| op | 칸 | 하는 일 |
+|---|---|---|
+| `set` | `path` · `old` · `new` | 그 자리 값이 `old` 면 `new` 로. 이미 `new` 면 건너뛴다 |
+| `replace` | `path` · `old` · `new` | 그 자리 **문자열 안**의 조각을 바꾼다 |
+| `drop_rows` | `path` · `labels` | 앞줄들을 뺀다. 첫 칸 글자가 `labels` 와 **정확히** 같을 때만 |
+| `append_row` | `path` · `row` | 없으면 뒤에 붙인다(있으면 건너뛴다) |
+| `forbid` | `words` | 원고 전체에서 그 낱말이 남았는지 **센다**(안 고친다) |
+
+모든 op 는 **멱등**이다 — 두 번 돌리면 두 번째는 「바꿈 0」이어야 하고, 그것이 이 도구의 계약이다.
+값이 `old` 도 `new` 도 아니면 **멈춘다** — 그 사이에 누가 고쳤다는 뜻이고, 조용히 덮으면 안 된다.
+"""
+import argparse
+import json
+import re
+import sys
+
+# 자산 바이트·도해 SVG 는 글자가 아니다 — `forbid` 가 훑지 않는다.
+SKIP_KEYS = {'data', 'file', 'ref', 'mime', 'provider', 'svg'}
+_TOK = re.compile(r'([A-Za-z_]\w*)|\[(\d+)\]|\[id=([^\]]+)\]|\.')
+
+
+def parse_path(p):
+    """`["sections", 1, "lede"]` 또는 `"sections[1].lede"` → 자리 목록.
+
+    `assets[id=fig-a]` 꼴도 받는다 — 배열에서 `id` 로 찾는다(자리 번호가 흔들려도 안 깨진다).
+    """
+    if isinstance(p, list):
+        return list(p)
+    out = []
+    for name, idx, aid in _TOK.findall(str(p)):
+        if name:
+            out.append(name)
+        elif idx:
+            out.append(int(idx))
+        elif aid:
+            out.append({'id': aid})
+    return out
+
+
+def locate(doc, path):
+    """자리 목록 → (부모, 열쇠). 마지막 한 칸은 남긴다."""
+    cur = doc
+    for k in path[:-1]:
+        if isinstance(k, dict):
+            cur = next(x for x in cur if isinstance(x, dict) and x.get('id') == k['id'])
+        else:
+            cur = cur[k]
+    last = path[-1]
+    if isinstance(last, dict):
+        raise ValueError('마지막 자리를 id 로 적을 수 없습니다: %r' % (path,))
+    return cur, last
+
+
+def _label(r):
+    """줄을 알아보는 글자 — 표는 첫 칸, 흐름도는 첫 칸의 글."""
+    if isinstance(r, dict):
+        cells = r.get('cells') or []
+        return (cells[0] or {}).get('text', '') if cells else str(r.get('no', ''))
+    return r[0] if r else ''
+
+
+def walk_strings(o, path=''):
+    if isinstance(o, dict):
+        for k, v in o.items():
+            if k in SKIP_KEYS:
+                continue
+            yield from walk_strings(v, '%s.%s' % (path, k) if path else k)
+    elif isinstance(o, list):
+        for i, v in enumerate(o):
+            yield from walk_strings(v, '%s[%d]' % (path, i))
+    elif isinstance(o, str):
+        yield path, o
+
+
+class Run:
+    def __init__(self, doc):
+        self.doc, self.done, self.skipped, self.left = doc, 0, 0, []
+
+    def _where(self, e):
+        return e.get('why') or e.get('path') or e.get('op')
+
+    def set(self, e):
+        parent, key = locate(self.doc, parse_path(e['path']))
+        cur = parent[key]
+        if cur == e['new']:
+            self.skipped += 1
+            return
+        if cur != e['old']:
+            sys.exit('✗ 값이 다릅니다 @ %s\n  지금: %r\n  기대: %r\n'
+                     '  (그 사이에 누가 고쳤습니다 — 덮지 않고 멈춥니다)'
+                     % (self._where(e), cur, e['old']))
+        parent[key] = e['new']
+        self.done += 1
+
+    def replace(self, e):
+        parent, key = locate(self.doc, parse_path(e['path']))
+        cur = parent[key]
+        if not isinstance(cur, str):
+            sys.exit('✗ 문자열이 아닙니다 @ %s — %r' % (self._where(e), type(cur).__name__))
+        if e['old'] in cur:
+            parent[key] = cur.replace(e['old'], e['new'])
+            self.done += 1
+        elif e['new'] in cur:
+            self.skipped += 1
+        else:
+            sys.exit('✗ 옛 조각도 새 조각도 없습니다 @ %s\n  지금: %r\n  찾던 것: %r'
+                     % (self._where(e), cur, e['old']))
+
+    def drop_rows(self, e):
+        """⚠ 길이를 **먼저** 잰다 — zip 은 짧은 쪽에 맞춰 잘리므로, 이 검사가 없으면
+        두 번째 실행이 남은 줄을 지운다(2026-09-21 실측 사고)."""
+        parent, key = locate(self.doc, parse_path(e['path']))
+        rows, labels = parent[key], e['labels']
+        if len(rows) < len(labels) or [_label(r) for r in rows[:len(labels)]] != labels:
+            self.skipped += 1
+            return
+        del rows[:len(labels)]
+        self.done += 1
+
+    def append_row(self, e):
+        parent, key = locate(self.doc, parse_path(e['path']))
+        rows = parent[key]
+        if e['row'] in rows:
+            self.skipped += 1
+            return
+        rows.append(e['row'])
+        self.done += 1
+
+    def forbid(self, e):
+        for w in e['words']:
+            for p, s in walk_strings(self.doc):
+                if w in s:
+                    i = s.find(w)
+                    self.left.append((p, w, s[max(0, i - 25):i + 25]))
+
+
+OPS = {'set': 'set', 'replace': 'replace', 'drop_rows': 'drop_rows',
+       'append_row': 'append_row', 'forbid': 'forbid'}
+
+
+def main():
+    ap = argparse.ArgumentParser(description='원고 부분 고치기(멱등) — 회차 데이터는 edits.json 에')
+    ap.add_argument('report', help='원고 JSON (get_report 가 준 발행 데이터)')
+    ap.add_argument('edits', help='고칠 목록 JSON')
+    ap.add_argument('--dry', action='store_true', help='재 보기만 — 파일을 안 건드린다')
+    a = ap.parse_args()
+
+    doc = json.load(open(a.report, encoding='utf-8'))
+    edits = json.load(open(a.edits, encoding='utf-8'))
+    if isinstance(edits, dict):
+        edits = edits.get('edits') or []
+    run = Run(doc)
+    for i, e in enumerate(edits):
+        op = e.get('op')
+        if op not in OPS:
+            sys.exit('✗ 모르는 op: %r (edits[%d]) — 있는 것: %s' % (op, i, ' · '.join(OPS)))
+        getattr(run, OPS[op])(e)
+
+    if not a.dry:
+        json.dump(doc, open(a.report, 'w', encoding='utf-8'), ensure_ascii=False, indent=1)
+    print('바꿈 %d · 이미 같음 %d%s' % (run.done, run.skipped, ' (dry)' if a.dry else ''))
+    if run.left:
+        print('남은 금지어 %d곳' % len(run.left))
+        for p, w, ctx in run.left[:20]:
+            print('  「%s」 @ %s — …%s…' % (w, p, ctx.replace('\n', ' ')))
+    # 두 번째 실행이 0 이어야 한다는 계약을 사람이 눈으로 확인할 수 있게 한 줄 남긴다.
+    if run.done and not a.dry:
+        print('(멱등 확인: 한 번 더 돌려 「바꿈 0」이면 맞습니다)')
+    sys.exit(1 if run.left else 0)
+
+
+if __name__ == '__main__':
+    main()