genetics-mcp 2.20.0 → 2.22.0

package/bin/manifest.json

@@ -1,6 +1,7 @@
 {
-  "aarch64-apple-darwin": "1db100bb09a127f3895fbe833dd494072cb831a89b90b6044dbcd0d3b0d2eb00",
-  "aarch64-unknown-linux-musl": "731f44a4ae57e624312e0c7e76def96d977cbf18993f87677913bb6af7537caf",
-  "x86_64-apple-darwin": "a1b59a18e1a7f1d79085213d11f7370a433d21742f36536db6c7aa65f8e0b5aa",
-  "x86_64-unknown-linux-musl": "e3f0f1394760b39435dd7fa8af6e992cdc43d345236b7472bed8cf99a6939fd2"
+  "aarch64-apple-darwin": "cb352eda0bbcf7419a7ca7243be783dfd3fece7a7e5fc3b5574474c92ac349f3",
+  "aarch64-unknown-linux-musl": "43a93d3366f4700a74564adca0531312d4ef2079eb3d38ae5617e9c2199806de",
+  "x86_64-apple-darwin": "c21172e1519287d0990149b668fc595be8f656d39fa30f5b811963d492c9e8d4",
+  "x86_64-pc-windows-gnu": "10cdaa9e0f06b35843fe65006dbaed70e382ee61a1a86f0627d9e9df87557df3",
+  "x86_64-unknown-linux-musl": "72e65bdd62e2afc7de01be2311ecfe55bc3b656764e09df4e382782ba66981c4"
 }

package/genetics.mjs

@@ -49,6 +49,22 @@ if (process.argv.includes('--version') || process.argv.includes('-v')) {
   process.exit(0);
 }
 
+/*
+ * **낡은 Node 는 여기서 말하고 멈춘다.** 서버가 쓰는 전역 `fetch` 는 Node 18 부터다.
+ * 그 아래에서는 첫 도구 호출에서 `fetch is not defined` 가 나는데, 그 글자는 클라이언트의
+ * 로그 구석에만 남아 **「도구가 그냥 안 된다」로 보인다.** 뜰 때 한 줄로 말하는 편이 낫다.
+ * Windows 에서 특히 중요하다 — 옛 판(7·8)에는 Node 18 이 아예 없다(공식 지원표: Node 14·16 은
+ * Windows 8.1 부터, 지금 판은 Windows 10 부터).
+ */
+if (typeof fetch !== 'function') {
+  process.stderr.write(
+    `genetics-mcp ${VERSION}: 이 Node(${process.version})에는 전역 fetch 가 없다 — Node 18 이상이 필요하다.\n`
+    + (process.platform === 'win32'
+        ? '  Windows 는 Node 18+ 가 Windows 10 이상에서만 돈다(공식 지원표). 7·8 에서는 포털의 브라우저 커넥터로 연결할 것.\n'
+        : '  nodejs.org 의 LTS 를 깔고 다시 열 것.\n'));
+  process.exit(1);
+}
+
 /*
  * 짝인 스킬을 편다.
  *
@@ -706,13 +722,33 @@ async function fetchImage(url) {
  * 방어를 늘려야 하기 때문이다. 그래서 굳히는 것은 여기서 한다: 계약 §7.1 ④ 의
  * 「발행 도구의 프로세스가 원본을 받아 포맷 규정대로 굳힌다」가 정확히 이 자리다.
  */
+/*
+ * 「이것을 까세요」는 **그 사람의 기계에서 되는 말**이어야 한다. 예전에는 brew·apt 만
+ * 적었는데, 그 두 줄은 Windows 에서 칠 수가 없다 — 안내가 아니라 막다른 길이 된다.
+ */
+function installHint(kind) {
+  const P = {
+    webp:   { win: 'winget install Google.LibWebp', mac: 'brew install webp',    apt: 'apt install webp' },
+    librsvg:{ win: 'winget install --id=GNOME.librsvg -e 또는 scoop install librsvg',
+              mac: 'brew install librsvg', apt: 'apt install librsvg2-bin' },
+  }[kind];
+  return process.platform === 'win32' ? P.win : `${P.mac} · ${P.apt}`;
+}
+
+/** npx 가 옛 판을 물고 있을 때 비우는 한 줄 — 셸마다 다르다. */
+function npxCacheResetHint(platform = process.platform) {
+  return platform === 'win32'
+    ? 'rmdir /s /q "%LOCALAPPDATA%\\npm-cache\\_npx" && npx -y genetics-mcp@latest'
+    : 'rm -rf ~/.npm/_npx && npx -y genetics-mcp@latest';
+}
+
 function rasterizeSvg(buf) {
   const r = spawnSync('rsvg-convert',
     ['-w', String(ASSET_LONG_EDGE), '-b', 'white', '-f', 'png'],
     { input: buf, maxBuffer: IMAGE_MAX_DOWNLOAD });
   if (r.error && r.error.code === 'ENOENT') {
     throw new Error('rsvg-convert 가 없어 벡터 원본을 래스터로 굳힐 수 없습니다.\n'
-      + 'librsvg 를 설치하세요(brew install librsvg · apt install librsvg2-bin). '
+      + `librsvg 를 설치하세요(${installHint('librsvg')}). `
       + 'SVG 를 그대로 싣지 않습니다 — 계약이 발행 데이터로 받는 형식을 두 래스터로 못박았습니다.');
   }
   if (r.status !== 0) throw new Error(`벡터 래스터화 실패: ${String(r.stderr).slice(0, 200)}`);
@@ -765,7 +801,7 @@ function encodeShot(buf) {
 
 function cwebpMissing() {
   return new Error('cwebp 가 없어 자산을 계약 규격(WebP)으로 굳힐 수 없습니다.\n'
-    + 'libwebp 를 설치하세요(brew install webp · apt install webp). '
+    + `libwebp 를 설치하세요(${installHint('webp')}). `
     + '다른 포맷으로 우회하지 않습니다 — 계약이 포맷을 규정으로 못박았습니다.');
 }
 
@@ -799,7 +835,7 @@ function encodeAsset(buf, role, provider) {
   const r = spawnSync('cwebp', args, { input: buf, maxBuffer: IMAGE_MAX_DOWNLOAD });
   if (r.error && r.error.code === 'ENOENT') {
     throw new Error('cwebp 가 없어 자산을 계약 규격(WebP q78 · 긴 변 1400px)으로 굳힐 수 없습니다.\n'
-      + 'libwebp 를 설치하세요(brew install webp · apt install webp). '
+      + `libwebp 를 설치하세요(${installHint('webp')}). `
       + '다른 포맷으로 우회하지 않습니다 — 계약이 포맷을 규정으로 못박았습니다.');
   }
   if (r.status !== 0) throw new Error(`자산 인코딩 실패: ${String(r.stderr).slice(0, 200)}`);
@@ -1674,11 +1710,46 @@ function scrubTranscript(raw) {
   return { jsonl: out.join('\n') + '\n', lines: out.length, dropped, redacted, cwd: cwdMode(cwds), cwd_raw: cwdMode(cwdsRaw), cwds_raw: rawAll };
 }
 
-/** cwd → 트랜스크립트 디렉터리. **해석된 경로**로 슬러그를 만든다(심볼릭 링크 함정). */
+/*
+ * cwd → 트랜스크립트 디렉터리. **해석된 경로**로 슬러그를 만든다(심볼릭 링크 함정).
+ *
+ * ★ **이 규칙은 우리 것이 아니라 Claude Code 의 것이다.** 우리가 정하는 자리가 아니라
+ *   **맞춰야 하는 자리**다 — 어긋나면 우리가 놓은 파일을 `claude --resume` 이 못 찾는다.
+ *   그래서 기억으로 쓰지 않고 **바이너리에서 떠 왔다**(2.1.274, 2026-09-18):
+ *
+ *     var jY = 200;
+ *     function JY(e){ let r=0; for(let n=0;n<e.length;n++) r=(r<<5)-r+e.charCodeAt(n)|0; return r }
+ *     function Le(e){ return Math.abs(JY(e)).toString(36) }
+ *     function k(e){ return e.replace(/[^a-zA-Z0-9]/g, "-") }
+ *     function eR(e){ let n=k(e); if(n.length<=jY) return n; return `${n.slice(0,jY)}-${Le(e)}` }
+ *
+ *   옛 코드는 `/` 와 `_` 만 바꿨다. 그러면 **점 하나만 들어가도 어긋난다** — 이 기계 실측:
+ *   `…/spreadjs-v19-0-3_/.vendor-src` 의 실재 폴더는 `…-v19-0-3---vendor-src` 인데 옛 규칙은
+ *   `…-v19-0-3--.vendor-src` 를 냈다(실재 0건). Windows 는 더 나쁘다 — `\` 와 `:` 가 그대로
+ *   남아 `C:\…\projects\C:\Users\…` 라는 **만들 수 없는 경로**가 나왔다(path.win32 로 실측).
+ *   비영숫자를 전부 바꾸면 드라이브 문자도 `C-` 가 되어 Windows 에서도 유효한 이름이 된다.
+ */
+const TRANSCRIPT_SLUG_MAX = 200;                 // Claude Code 의 jY
+
+/** Claude Code 의 `JY` — 자바 문자열 해시와 같은 셈(32비트 랩어라운드). */
+function transcriptSlugHash(s) {
+  let r = 0;
+  for (let i = 0; i < s.length; i += 1) r = (((r << 5) - r) + s.charCodeAt(i)) | 0;
+  return Math.abs(r).toString(36);
+}
+
+/** Claude Code 의 `eR` — 경로 하나를 폴더 이름 하나로. */
+function transcriptSlug(real) {
+  const n = String(real).replace(/[^a-zA-Z0-9]/g, '-');
+  return n.length <= TRANSCRIPT_SLUG_MAX
+    ? n
+    : `${n.slice(0, TRANSCRIPT_SLUG_MAX)}-${transcriptSlugHash(real)}`;
+}
+
 function transcriptDir(dir) {
   let real = dir;
   try { real = fs.realpathSync(dir); } catch { /* 없으면 준 값 그대로 */ }
-  return path.join(os.homedir(), '.claude', 'projects', real.replace(/[/_]/g, '-'));
+  return path.join(os.homedir(), '.claude', 'projects', transcriptSlug(real));
 }
 
 /** uuid 로 이 기계의 트랜스크립트를 찾는다. 지금 프로젝트를 먼저 보고, 없으면 전체를 훑는다. */
@@ -1777,8 +1848,33 @@ function cursorActiveFromLedger() {
  * 조용히 비켜난다(beatTargets:transcriptOf null → skip). 대화 본문을 올리는 길(두뇌
  * 파서까지)은 별도 단계다 — DESIGN-cursor-colony.md.
  */
-const CURSOR_ROOT = process.env.GENETICS_CURSOR_ROOT
-  || path.join(os.homedir(), 'Library', 'Application Support', 'Cursor', 'User');
+/*
+ * Cursor 의 사용자 데이터 자리는 **플랫폼마다 다르다**(VS Code 계열 공통 규약).
+ * 여기 macOS 자리만 박혀 있었다 — Windows·Linux 에서는 `workspaceStorage` 를 영영 못 찾고
+ * 조용히 빈 값으로 떨어졌다(try/catch 안이라 아무도 못 봤다).
+ *   darwin  ~/Library/Application Support/Cursor/User
+ *   win32   %APPDATA%\Cursor\User        (APPDATA 가 없으면 ~/AppData/Roaming 로 잇는다)
+ *   linux   $XDG_CONFIG_HOME/Cursor/User → 없으면 ~/.config/Cursor/User
+ */
+function cursorUserRoot(platform = process.platform, env = process.env, home = os.homedir()) {
+  if (env.GENETICS_CURSOR_ROOT) return env.GENETICS_CURSOR_ROOT;
+  if (platform === 'win32') {
+    return path.join(env.APPDATA || path.join(home, 'AppData', 'Roaming'), 'Cursor', 'User');
+  }
+  if (platform === 'darwin') return path.join(home, 'Library', 'Application Support', 'Cursor', 'User');
+  return path.join(env.XDG_CONFIG_HOME || path.join(home, '.config'), 'Cursor', 'User');
+}
+
+const CURSOR_ROOT = cursorUserRoot();
+
+/*
+ * sqlite3 실행체. macOS 는 자리가 고정이라 **절대경로로** 부르고(PATH 오염을 안 탄다),
+ * 나머지는 PATH 에서 찾는다 — Windows 는 sqlite3 가 기본 탑재가 아니라 없을 수 있고,
+ * 없으면 아래 장부 갈래로 떨어진다(없음은 오류가 아니다).
+ */
+function sqliteBin(platform = process.platform) {
+  return platform === 'darwin' ? '/usr/bin/sqlite3' : 'sqlite3';
+}
 
 let cursorSeen = { at: 0, id: '', folder: '' };   // 15초 캐시 — 도구마다 sqlite 를 안 두드리게
 
@@ -1815,7 +1911,7 @@ function cursorActiveComposer() {
         if (!best || mt > best.mt) best = { dir, wsPath, mt };
       }
       if (best) {
-        const r = spawnSync('/usr/bin/sqlite3',
+        const r = spawnSync(sqliteBin(),
           ['-readonly', path.join(best.dir, 'state.vscdb'),
            "SELECT value FROM ItemTable WHERE key='composer.composerData'"],
           { encoding: 'utf8', timeout: 2000 });
@@ -4012,13 +4108,17 @@ const TOOLS = [
       + '각 메모의 `anchor.path`(예 `case:k7m2p9/fix`)가 **발행 데이터의 어느 칸을 고치라는 것인지**를 '
       + '그대로 말한다 — 그 칸을 고쳐 update_report 로 되돌려 보내고, resolve_note 로 반영을 표시한다.\n'
       + '`anchor_state` 가 `unmoored`·`reparented` 면 문서가 바뀌어 원래 자리를 잃은 것이다 — '
-      + '그래도 메모는 남아 있고, `anchor.quote_exact` 가 저자가 무엇을 보고 썼는지 말한다.',
+      + '그래도 메모는 남아 있고, `anchor.quote_exact` 가 저자가 무엇을 보고 썼는지 말한다.\n'
+      + '같은 호출이 **검토 회신**(고객에게 보이는 글 — 판단 항목의 답이 여기로 온다)도 함께 보여 준다. '
+      + '문서를 고치기 **전에** 회신의 본문을 읽는다: 각 회신의 where 가 어느 물음·건·도판에 대한 말인지 말한다. '
+      + '회신대로 고친 뒤의 「원문이 바뀜」은 정상이다 — 핀을 살리려고 문장을 되돌리지 않는다.',
     inputSchema: {
       type: 'object',
       properties: {
         id: { type: 'integer', description: '보고서 id' },
         state: { type: 'string', description: '`open`(기본, 아직 반영 안 한 것) 또는 `all`' },
         uid: { type: 'string', description: '그 건·절의 uid 에 달린 것만(선택)' },
+        channel: { type: 'string', description: '`all`(기본 — 메모와 검토 회신 둘 다) · `notes`(저자 메모만) · `replies`(검토 회신만)' },
       },
       required: ['id'],
     },
@@ -4029,7 +4129,8 @@ const TOOLS = [
       '메모에 **답글로** 회신한다. 이견이 있거나 물을 것이 있으면 대화창이 아니라 여기에 쓴다 — '
       + '저자는 자기가 메모를 단 그 자리에서 답을 본다.\n'
       + '고칠 수 없는 이유, 다르게 본 근거, 되묻는 것이 여기 온다. '
-      + '고쳤으면 답글이 아니라 resolve_note 다.',
+      + '고쳤으면 답글이 아니라 resolve_note 다.\n'
+      + '★ **검토 회신에는 이 도구로 답하지 않는다** — 그쪽은 고객에게 보이는 글이라 사람이 포털에서 쓴다. 할 말은 작성자에게 대화로 전한다.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -4043,19 +4144,22 @@ const TOOLS = [
   {
     name: 'resolve_note',
     description:
-      '그 메모를 **반영했다**고 표시한다. 반영이 실린 판번호(body_rev)가 함께 남아 '
+      '그 메모(또는 검토 회신)를 **반영했다**고 표시한다. 반영이 실린 판번호(body_rev)가 함께 남아 '
       + '「무엇에 반영됐는지」를 나중에도 안다.\n'
       + '★ 고치기 **전에** 부르지 말 것 — 이 표시가 곧 「이 메모는 끝났다」이고, '
-      + '표시하는 순간 미반영 목록에서 빠져 다시 눈에 안 띈다.',
+      + '표시하는 순간 미반영 목록에서 빠져 다시 눈에 안 띈다.\n'
+      + '검토 회신은 `note` 대신 `reply` 로 가리킨다 — 표시해도 회신은 고객에게 그대로 보이고, 그 회신이 집은 문장이 바뀐 것을 update_report 가 더는 경고하지 않는다. '
+      + '문서에 반영할 것이 없는 회신(인사·이미 답한 물음)도 읽었으면 표시한다.',
     inputSchema: {
       type: 'object',
       properties: {
         id: { type: 'integer', description: '보고서 id' },
-        note: { type: 'integer', description: '메모 id' },
+        note: { type: 'integer', description: '메모 id(`reply` 와 둘 중 하나)' },
+        reply: { type: 'integer', description: '검토 회신 id — list_notes 의 [회신 N]. 뿌리 회신만 표시할 수 있다' },
         rev: { type: 'integer', description: '반영이 실린 body_rev. 안 주면 지금 판' },
         resolved: { type: 'boolean', description: '거짓이면 미반영으로 되돌린다' },
       },
-      required: ['id', 'note'],
+      required: ['id'],
     },
   },
   {
@@ -4627,6 +4731,14 @@ const TOOLS = [
  * 찍는 자리가 흩어져 있으면 또 한 곳이 빠지므로 여기 하나로 모은다. */
 // 자산을 굳히며 이쪽(작성자 기계)에서만 알 수 있는 것 — 서버 경고와 한 목록으로 낸다(readability.md R8).
 let ASSET_HINTS = [];
+/* 회신 핀 예보(update_report) — 서버가 핀마다 낸 판정(`pins[]`)을 한 줄로 센다. 경고는 약해지는 핀만 말하므로,
+ * 이 줄이 없으면 「전부 제자리」와 「핀이 없다」와 「예보가 안 돌았다(옛 서버)」를 에이전트가 못 가른다. 핀이 없으면 안 찍는다. */
+function pinsText(r) {
+  const p = Array.isArray(r?.pins) ? r.pins : [];
+  if (!p.length) return '';
+  const n = (s) => p.filter((x) => x?.state === s).length;
+  return `\n회신 핀 ${p.length}건 — 제자리 ${n('exact')} · 옮겨 붙음 ${n('moved')} · 원문이 바뀜 ${n('drifted')} · 상위로 ${n('reparented')} · 자리 잃음 ${n('unmoored')}`;
+}
 function warnText(r) {
   const w = [...(r?.warnings ?? []), ...ASSET_HINTS];
   return w.length
@@ -4709,11 +4821,23 @@ const CELL_DIR = path.join(os.homedir(), '.config/genetics/bin');
 const CELL_PATH = path.join(CELL_DIR, process.platform === 'win32' ? 'gcell.exe' : 'gcell');
 
 /** 이 기계의 타깃 삼중. 모르면 `null` — 지어내지 않는다. */
-function cellTarget() {
-  const a = process.arch, p = process.platform;
+function cellTarget(platform = process.platform, arch = process.arch) {
+  const a = arch, p = platform;
   if (p === 'darwin') return a === 'arm64' ? 'aarch64-apple-darwin' : a === 'x64' ? 'x86_64-apple-darwin' : null;
   if (p === 'linux') return a === 'arm64' ? 'aarch64-unknown-linux-musl' : a === 'x64' ? 'x86_64-unknown-linux-musl' : null;
-  return null;                                        // Windows 는 아직 못 굽는다(cell/.cargo/config.toml)
+  // Windows 는 mingw 로 굽는다(cell/.cargo/config.toml). arm64 Windows 는 아직 안 굽는다 — 없는 것은 없는 것이다.
+  if (p === 'win32') return a === 'x64' ? 'x86_64-pc-windows-gnu' : null;
+  return null;
+}
+
+/**
+ * 이 플랫폼에 **세포가 있을 수 있나**. 「아직 안 깔렸다」와 「이 플랫폼엔 애초에 없다」를 가른다.
+ *
+ * ⚠ 이 갈래가 없으면 안내가 **막다른 길**이 된다: 못 쓴다는 글이 `install_cell` 을 가리키고,
+ *   그 도구는 다시 「이 판에 없다」를 낸다 — 모델이 그 둘을 오가며 설치를 되풀이한다.
+ */
+function cellPlatformSupported(platform = process.platform, arch = process.arch) {
+  return cellTarget(platform, arch) !== null;
 }
 
 function cellManifest() {
@@ -4881,7 +5005,7 @@ function tenantNoticeText(v) {
       }
       if (v.client_old) {
         return `genetics: 이 폴더는 ${T} 로 확정돼 있고 자동 올리기도 켜져 있지만, 이 판(${v.version})이 서버 최소 판(${v.min_client})보다 낡아 `
-          + '**이 대화는 안 올라간다**. npx 캐시를 비우고 다시 깔면 그때부터 올라간다: rm -rf ~/.npm/_npx && npx -y genetics-mcp@latest.';
+          + `**이 대화는 안 올라간다**. npx 캐시를 비우고 다시 깔면 그때부터 올라간다: ${npxCacheResetHint()}.`;
       }
       const who = v.confirmed_by ? `${v.confirmed_by}${josaIGa(v.confirmed_by)} ` : '';
       return `genetics: 이 세션은 ${T} 소속으로 확정된 폴더(${v.path} · ${who}${String(v.confirmed_at || '').slice(0, 10)} 확정, 자동 올리기 켬)에서 `
@@ -4938,7 +5062,7 @@ function tenantNoticeText(v) {
         + 'login 도구로 로그인하면 그때부터 확인한다.';
     case 'client_old':
       return `genetics: 이 판(${v.version})은 서버 최소 판(${v.min_client})보다 낡아 폴더 소속·자동 올리기가 안 돈다. `
-        + 'npx 캐시를 비우고 다시 깔 것: rm -rf ~/.npm/_npx && npx -y genetics-mcp@latest.';
+        + `npx 캐시를 비우고 다시 깔 것: ${npxCacheResetHint()}.`;
     default:
       return '';
   }
@@ -5151,10 +5275,14 @@ function toolsNow() {
  * 지시형은 프롬프트 주입으로 거부된다(2026-08-22 실측).
  */
 function cellNotice(why) {
-  return [
-    `genetics 세포(gcell)를 못 쓴다 — ${why}. 그래서 이 저장소에서 남이 무엇을 바꿨는지 못 싣는다.`,
-    '세포는 선택이 아니라 필수다. `install_cell` 도구가 깔고, `uninstall_cell` 이 지운다.',
-  ].join('\n');
+  const head = `genetics 세포(gcell)를 못 쓴다 — ${why}. 그래서 이 저장소에서 남이 무엇을 바꿨는지 못 싣는다.`;
+  // **깔 수 없는 곳에 설치를 시키지 않는다.** 이 플랫폼에 세포가 없으면 그 말이 곧 다음 할 일이다.
+  if (!cellPlatformSupported()) {
+    return [head,
+            `이 플랫폼(${process.platform}/${process.arch})에는 세포가 없다 — 깔 수 있는 것이 없으니 `
+            + '`install_cell` 을 부르지 말 것. 나머지 도구는 그대로 쓴다.'].join('\n');
+  }
+  return [head, '세포는 선택이 아니라 필수다. `install_cell` 도구가 깔고, `uninstall_cell` 이 지운다.'].join('\n');
 }
 
 /* ── ★★ 메일 레인 — 두뇌·다른 세션·사람이 **나를 지목해** 보낸 것 ──────────
@@ -5456,6 +5584,55 @@ let NOTES_LAST = '';
 let NOTES_QUIET = 0;
 const NOTES_REMIND_EVERY = 8;
 
+/*
+ * 열린 검토 회신(125) — 메모와 같은 방식으로 기억하고 꼬리에서 말한다. 회신은 **판단 항목의 답이 오는 자리**라
+ * 문서를 고치기 전에 읽혀야 한다: 2026-09-17 에는 이 통로가 없어 답이 와 있는 항을 다섯 판 동안 다시 물었다.
+ */
+const REPLIES_OPEN = new Map();    // 보고서 id → 열린 회신 건수
+let REPLIES_LAST = '';
+let REPLIES_QUIET = 0;
+function repliesSeen(id, n) {
+  if (!Number.isInteger(id) || id <= 0 || !Number.isInteger(n)) return;
+  if (n > 0) REPLIES_OPEN.set(id, n); else REPLIES_OPEN.delete(id);
+}
+function repliesSays() {
+  const rows = [];
+  REPLIES_OPEN.forEach((n, id) => { if (n > 0) rows.push(`#${id} ${n}건`); });
+  if (!rows.length) { REPLIES_LAST = ''; return ''; }
+  const t = `검토 회신 미반영 — ${rows.join(' · ')} · list_notes(id) 가 본문과 함께 보여 준다. `
+    + '문서를 고치기 전에 읽고, 반영했으면 resolve_note(id, reply). 고객에게 보이는 답글은 사람이 포털에서 쓴다.';
+  if (t === REPLIES_LAST && ++REPLIES_QUIET < NOTES_REMIND_EVERY) return '';
+  REPLIES_LAST = t;
+  REPLIES_QUIET = 0;
+  return t;
+}
+
+/** 검토 회신 목록을 사람이 읽는 줄로. 답글은 뿌리 밑에 붙인다(메모 목록과 같은 규율). */
+function repliesText(id, r) {
+  if (!r.replies || !r.replies.length) return `검토 회신 — 보고서 #${id} · ${r.note || '열린 검토 회신이 없다.'}`;
+  const STATE = { exact: '', moved: '(옮겨 붙음)', drifted: '(원문이 바뀜)', reparented: '(문장을 잃어 상위로)', unmoored: '(자리를 잃음)' };
+  const side = (c) => (c.side === 'client' ? '고객' : '우리');
+  const kids = new Map();
+  for (const c of r.replies) {
+    if (c.parent_id !== null) {
+      if (!kids.has(c.parent_id)) kids.set(c.parent_id, []);
+      kids.get(c.parent_id).push(c);
+    }
+  }
+  const lines = [`검토 회신(고객에게 보이는 글) · 보고서 #${id} · 본문 판 body_rev=${r.body_rev} · ${r.note}`, ''];
+  if (r.capped) lines.splice(1, 0, '⚠ 목록이 잘렸다 — 아래가 전부가 아니다.');
+  for (const c of r.replies) {
+    if (c.parent_id !== null) continue;
+    lines.push(`[회신 ${c.id}] ${c.where || '문서 전체'} ${STATE[c.state_now] || ''}${c.resolved ? ` · 반영됨(판 ${c.resolved_rev ?? '?'})` : ''}`.trimEnd());
+    if (c.anchor?.quote_exact) lines.push(`  집은 글: 「${c.anchor.quote_exact}」`);
+    lines.push(`  ${c.author || ''}(${side(c)}) ${String(c.created_at || '').slice(0, 10)}: ${c.body}`);
+    for (const k of (kids.get(c.id) || [])) lines.push(`  ↳ ${k.author || ''}(${side(k)}): ${k.body}`);
+    lines.push('');
+  }
+  lines.push('반영했으면 resolve_note(id, reply: N). 회신대로 고친 뒤의 「원문이 바뀜」은 정상이다. 고객에게 보이는 답글은 이 도구로 달지 않는다.');
+  return lines.join('\n').trimEnd();
+}
+
 /** 응답에 실려 온 건수를 기억한다. 서버가 그 칸을 모르는 판이면 아무 일도 안 한다. */
 function notesSeen(id, n) {
   if (!Number.isInteger(id) || id <= 0 || !Number.isInteger(n)) return;
@@ -5493,6 +5670,8 @@ function worldAppend(result) {
    */
   const nn = notesSays();
   if (nn) result.content.push({ type: 'text', text: nn });
+  const rr = repliesSays();
+  if (rr) result.content.push({ type: 'text', text: rr });
   const t = worldDelta();
   if (!t) return;
   /*
@@ -5752,6 +5931,11 @@ async function callTool(name, args = {}) {
           notesSeen(Number(x.id), x.open_notes);
           if (x.open_notes > 0) bits.push(`첨삭 메모 ${x.open_notes}건 미반영`);
         }
+        // 열린 검토 회신(125) — 판단 항목의 답이 와 있는 문서를 목록에서 알아보게. 옛 서버·자격 없음이면 안 찍는다.
+        if (Number.isInteger(x.open_replies)) {
+          repliesSeen(Number(x.id), x.open_replies);
+          if (x.open_replies > 0) bits.push(`검토 회신 ${x.open_replies}건 미반영`);
+        }
         const tag = bits.length ? ` [${bits.join(' · ')}]` : '';
         // slug 를 싣는다. 중복 slug 는 409 로 잘 막히지만 **미리 알 수가 없었다** —
         // 목록에 이름표가 없어 새 이름을 고를 때 참고할 것이 없었다(2026-08-18 검토).
@@ -5803,6 +5987,7 @@ async function callTool(name, args = {}) {
         return JSON.stringify(r.current_text, null, 2);
       }
       notesSeen(Number(args.id), r.open_notes);
+      repliesSeen(Number(args.id), r.open_replies);
       if (!args.outline) {
         /*
          * ⚠ 전에는 여기서 **`r.data` 만** 돌려줬다. 서버가 정성껏 붙인 것이 이 한 줄에서
@@ -5820,6 +6005,10 @@ async function callTool(name, args = {}) {
         head.push(`[정본 ${owner} · 본문 판 body_rev=${r.body_rev ?? '?'}`
           + (r.sha256 ? ` · 지금 발행물 ${r.bytes}B sha256:${String(r.sha256).slice(0, 12)}…` : '')
           + `] — 고칠 때는 update_report 에 body_rev 를 함께 실으면, 그 사이 누가 고쳤을 때 409 로 멈춘다.`);
+        // 열린 검토 회신 — 고치기 전에 읽어야 한다(판단 항목의 답이 거기 있다). 첫 줄 가까이에 둔다.
+        if (Number.isInteger(r.open_replies) && r.open_replies > 0) {
+          head.push(`검토 회신 ${r.open_replies}건이 열려 있다 — 고치기 전에 list_notes(id: ${Number(args.id)}) 로 본문을 읽는다.`);
+        }
           // 그림은 서버가 보관한다(바이트는 에이전트를 안 지난다) — 되돌려 보낼 때의 계약을 여기서 말한다(#34).
           const kept = Array.isArray(r.data?.assets)
             ? r.data.assets.filter((a) => typeof a?.data === 'string' && a.data.startsWith('(생략')).length : 0;
@@ -5837,13 +6026,29 @@ async function callTool(name, args = {}) {
     }
     case 'list_notes': {
       const id = Number(args.id);
+      const channel = args.channel === undefined ? 'all' : String(args.channel);
+      if (!['all', 'notes', 'replies'].includes(channel)) throw new Error('channel 은 all · notes · replies 중 하나입니다.');
       const qs = new URLSearchParams();
       if (args.state) qs.set('state', String(args.state));
       if (args.uid) qs.set('uid', String(args.uid));
-      const r = await api('GET', `/api/reports/${id}/notes${qs.toString() ? '?' + qs : ''}`);
+      const q = qs.toString() ? '?' + qs : '';
+      // 검토 회신(125) — 메모 뒤에 붙인다. 옛 서버(창구 없음)는 메모만 낸다; 회신만 달라고 했으면 그 실패를 그대로 말한다.
+      let repliesPart = '';
+      if (channel !== 'notes') {
+        try {
+          const rr = await api('GET', `/api/reports/${id}/replies${q}`);
+          repliesSeen(id, rr.open);
+          repliesPart = repliesText(id, rr);
+        } catch (e) {
+          if (channel === 'replies' || Number(e?.status) !== 404) throw e;
+        }
+      }
+      if (channel === 'replies') return repliesPart;
+      const tail = repliesPart ? `\n\n${repliesPart}` : '';
+      const r = await api('GET', `/api/reports/${id}/notes${q}`);
       notesSeen(id, r.open);
       if (!r.notes || !r.notes.length) {
-        return `보고서 #${id} — ${r.note || '메모가 없다.'}`;
+        return `보고서 #${id} — ${r.note || '메모가 없다.'}${tail}`;
       }
       /*
        * 답글을 부모 밑에 붙여 낸다. 평평하게 내면 에이전트가 **자기가 이미 한 말**을
@@ -5873,7 +6078,7 @@ async function callTool(name, args = {}) {
         }
         lines.push('');
       }
-      return lines.join('\n').trimEnd();
+      return lines.join('\n').trimEnd() + tail;
     }
     case 'reply_note': {
       const id = Number(args.id);
@@ -5883,6 +6088,15 @@ async function callTool(name, args = {}) {
     }
     case 'resolve_note': {
       const id = Number(args.id);
+      if ((args.note === undefined) === (args.reply === undefined)) throw new Error('note(메모 id) 와 reply(검토 회신 id) 중 **하나만** 주세요.');
+      if (args.reply !== undefined) {
+        const rb = { reply: Number(args.reply) };
+        if (args.rev !== undefined) rb.rev = Number(args.rev);
+        if (args.resolved !== undefined) rb.resolved = !!args.resolved;
+        const rr = await api('PATCH', `/api/reports/${id}/replies`, rb);
+        if (Number.isInteger(rr.open)) repliesSeen(id, rr.open);
+        return rr.says;
+      }
       const body = { note: Number(args.note) };
       if (args.rev !== undefined) body.rev = Number(args.rev);
       if (args.resolved !== undefined) body.resolved = !!args.resolved;
@@ -5967,16 +6181,16 @@ async function callTool(name, args = {}) {
         throw e;
       }
       // 고친 직후가 「무엇을 아직 안 고쳤나」를 볼 가장 좋은 순간이다.
-      if (!r.dry_run) notesSeen(Number(args.id), r.open_notes);
+      if (!r.dry_run) { notesSeen(Number(args.id), r.open_notes); repliesSeen(Number(args.id), r.open_replies); }
       if (r.dry_run) {
-        return `시험 실행 — 아무것도 바꾸지 않았습니다.\n${r.tenant} · 건 ${r.cases}` + warnText(r);
+        return `시험 실행 — 아무것도 바꾸지 않았습니다.\n${r.tenant} · 건 ${r.cases}` + pinsText(r) + warnText(r);
       }
       // 상태를 함께 알린다 — 이 문서를 다음에도 API 로 고칠 수 있는지가 여기서 갈린다.
       const st = r.state ? ` [${r.state}]` : '';
       // 서버가 초안이라고 답하면 이 도구의 동사로 다음 할 일을 잇는다(서버 note 는 HTTP 경로로 말한다).
       const open = r.published === false ? ` 이 도구에서는 release_report(id: ${Number(args.id)}) 가 그 일입니다.` : '';
       return `교체 완료 — ${r.tenant} · 건 ${r.cases}${st}\n열람 주소: ${r.url}\n${r.note || ''}${open}`
-        + pendingText(r) + warnText(r);
+        + pendingText(r) + pinsText(r) + warnText(r);
     }
     case 'world': {
       const facts = worldFacts(8);
@@ -6742,7 +6956,15 @@ const IS_MAIN = (() => {
  * 자리 고르기는 **순수 함수**로 뺀다(smoke 가 떼어내 잰다): PATH 에 있고 · 실재하고 · 쓸 수 있는
  * 첫 후보. 없는 폴더를 만들거나 rc 파일을 고치지 않는다 — 남의 셸 설정에 손대는 설치는 못 믿는다.
  */
-const CELL_LINK_CANDIDATES = ['/opt/homebrew/bin', '/usr/local/bin', path.join(os.homedir(), '.local/bin')];
+/*
+ * ⚠ **Windows 에는 이 자리가 없다.** 후보 셋은 전부 유닉스의 PATH 자리이고, 심링크 자체도
+ *   Windows 에서는 개발자 모드나 관리자 권한이 있어야 만들어진다(EPERM). 그래서 그 판에서는
+ *   **걸지 않고**, 대신 「이 폴더를 PATH 에 넣으라」고 그 판의 말로 말한다 — 없는 자리를
+ *   나열하며 못 걸었다고 하는 것은 안내가 아니다.
+ */
+const CELL_LINK_CANDIDATES = process.platform === 'win32'
+  ? []
+  : ['/opt/homebrew/bin', '/usr/local/bin', path.join(os.homedir(), '.local/bin')];
 function cellLinkDir(pathEnv, candidates, exists, writable) {
   const onPath = new Set(String(pathEnv || '').split(path.delimiter).filter(Boolean));
   for (const d of candidates) {
@@ -6755,6 +6977,10 @@ function cellLinkOnPath() {
     (d) => { try { return fs.statSync(d).isDirectory(); } catch { return false; } },
     (d) => { try { fs.accessSync(d, fs.constants.W_OK); return true; } catch { return false; } });
   if (!dir) {
+    if (process.platform === 'win32') {
+      return `PATH 에 안 걸었다(Windows 는 심링크에 권한이 필요하다) — 전체 경로 ${CELL_PATH} 로 부르거나 `
+           + `이 폴더를 PATH 에 넣을 것: setx PATH "%PATH%;${CELL_DIR}"`;
+    }
     return `PATH 에 걸 자리를 못 찾았다(${CELL_LINK_CANDIDATES.join(' · ')} 중 PATH 에 있고 쓸 수 있는 곳이 없다) — 전체 경로 ${CELL_PATH} 로 부를 것.`;
   }
   const link = path.join(dir, 'gcell');
@@ -7230,4 +7456,6 @@ export { encodeAsset, imageDims, imageHostAllowed, materializeAssets, warnText,
          autoBlockSetVerdict, autoBlockPut, cellPinSource,
          // 2026-09-15 — 「서버가 아는 행인가」는 소속 칸이 아니라 서버를 거친 표식으로 가른다(첫 업로드가 영영 안 서던 자리)
          autoRowOnServer,
+         // 2026-09-18 Windows — 남의 규칙(Claude Code 슬러그)·플랫폼 갈래는 시험이 표로 걷는다
+         transcriptSlug, transcriptDir, cursorUserRoot, sqliteBin, npxCacheResetHint, cellPlatformSupported,
          HOLDS_FILE, UPDATE_BUDGET_MS };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genetics-mcp",
-  "version": "2.20.0",
+  "version": "2.22.0",
   "description": "문서 포털 발행·세션 이식·사례 기억 MCP — 데이터를 주면 규격 문서가 나온다 (짝인 스킬 동봉)",
   "author": "주식회사 LIM (LIM Inc.)",
   "license": "SEE LICENSE IN LICENSE",
@@ -18,7 +18,7 @@
     "node": ">=18"
   },
   "scripts": {
-    "test": "node smoke.mjs && node notify.test.mjs && node schedule.test.mjs && bash ../cell/tests/cellcycle.sh",
+    "test": "node smoke.mjs && node notify.test.mjs && node schedule.test.mjs && node windows.test.mjs && bash ../cell/tests/cellcycle.sh",
     "prepack": "find skills -name __pycache__ -type d -prune -exec rm -rf {} + 2>/dev/null; bash ../cell/build-all.sh",
     "prepublishOnly": "npm test",
     "release": "bash release.sh"

package/skills/genetics-report/SKILL.md

@@ -43,7 +43,7 @@ version: "4.0.0"
 | 4~6 원고 | `report.json` · 코드 작업을 녹이면 원고 밖 상태 표(반드시 지키는 것 3) | — | 요약 근거 · 요지 칸 수(4~6단계) · 절마다 `marg` | 서버 요약 근거 게이트(거절) · 사람 | 공통 원인이 실재하는가 |
 | 6 도판 굽기 | 도판 HTML → PNG · `plates.json` | `node assets/figure.mjs --batch plates.json --report report.json` · 두 칸 비교는 `shot.mjs --after` → `pair.mjs` | exit 0(✗0 · 합계 2,400,000B 안) | `figure.mjs` R0~R10·R13 · `pair.mjs` · 칩 문구의 뜻은 사람 눈 | — |
 | 7 로컬 렌더 | 단일 HTML | `python3 assets/render.py report.json` | ⚠0 · `forbid` 적중 0 | `gazette.py` `text_scan()`·`brief_checks()`·`tally_scan()` · `build.py guard()` | — |
-| 7 dry_run | 경고 목록 | `publish_report`/`update_report` 에 `dry_run: true` | 작성자가 고칠 수 있는 ⚠0 — 못 없애는 경고는 까닭을 핸드오프에 | `report_publish.php report_build_checked()`(렌더러·입고·그림·문체) · 경고 기준선 대조는 사람 | — |
+| 7 dry_run | 경고 목록 | `publish_report`/`update_report` 에 `dry_run: true` | 작성자가 고칠 수 있는 ⚠0 — 못 없애는 경고는 까닭을 핸드오프에 | `report_publish.php report_build_checked()`(렌더러·입고·그림·문체) · `update_report` 는 `comments.php comment_anchor_forecast()`(회신 핀 자리) · 경고 기준선 대조는 사람 | — |
 | 7 독자 검토 | 워크플로 결과(`merged`·`questions`·`dropped`) | `references/reader-review.workflow.js`(0.5단계 7행) · 구조를 안 바꾼 낱말 손질 판은 `references/edition-review.workflow.js`(결과 `kept`·`weak`) | 사실 틀림 반영 · 「⚠ 도판 N장 미열람」 없음 · 반영 뒤 로컬 렌더·dry_run 다시 | 워크플로 관점 + JS 거름 · `questions`·`dropped` 는 사람 | `questions[]` |
 | 7 조판 검사 | 검사기 출력 | `gazette-report` 검사기 8종(단일 HTML 전달일 때) | 각 0건 · **표본 수를 함께 본다**(0표본 통과는 통과가 아니다) | 검사기 — 실행법은 `gazette-report` 스킬 | — |
 | 7 사람 눈 | — | 인쇄 미리보기까지 연다 | `references/process.md` 「7단계 — 검수」 사람의 눈 표 | 사람 | — |
@@ -51,6 +51,7 @@ version: "4.0.0"
 | 9 발행 뒤 대조 | 블록 목록 | `get_report(id, outline: true)` | `aside.marg` 수 = 절 수 · 옛 서식 블록 0 · 빈 블록 0 | 사람(블록 목록을 읽음) — 대조 기계 없음 | — |
 | 9 열람 확인 | 캡처 | 열람 주소를 연다 | 칩·굵게·링크가 원문 글자가 아니라 서식으로 섬 · 도판 쌍·판단 절이 섬 | 사람 눈 — 못 열면 까닭을 핸드오프에 | — |
 | 9a 첨삭 메모 반영 | 반영된 판 · 닫힌 메모 · 까닭을 단 답글 | `list_reports` → `list_notes` → `update_report` → `resolve_note`·`reply_note`(9a단계) | 미반영 메모 0 — 남은 것은 전부 답글로 까닭이 달림 | 사람이 메모를 닮 · 서버는 미반영 수만 셈(`open_notes`, 우리 팀에게만) | 사람이 「메모 해놨다」고 할 때만 돈다 — 무엇을 고칠지 되묻지 않음 |
+| 9b 검토 회신 반영 | 회신마다 「어느 물음의 답인가」 대조 · 반영된 판 · 반영 표시 | **개정 전에** `list_notes(id)`(검토 회신이 본문과 함께 실린다) → 원고 반영 → `update_report` → `resolve_note(id, reply, rev)`(9b단계) | 열린 회신 0 — 남은 것은 사람에게 넘긴 까닭이 있음 · 원고에 「회신 없음」이라고 쓴 자리가 회신과 어긋나지 않음 | 서버는 열린 회신 수(`open_replies`)를 목록·되읽기·교체 응답에 싣고, 열린 회신의 문장이 바뀌면 교체 경고로 말함 · 본문 읽기와 대조는 사람·에이전트 | 고객에게 보이는 답글 문안(에이전트는 달지 않는다) |
 | 10 공개 직전 날짜 | `report.json` | `update_report` 한 번(날짜만 고치는 이 판은 독자 검토 없이 로컬 렌더·dry_run 만) | 작성일 세 자리가 한 값이고 공개하는 날(3c) | `gazette.py` `date_scan()` ⚠(세 자리가 다르면) · 공개하는 날인지는 사람 | 공개일 |
 | 10 공개 | 공개된 링크 | `release_report(id)` | 사용자 승인 | 사람(승인 행위) | **반드시** 공개 승인 |
 
@@ -351,6 +352,21 @@ report.json + cases.json 을 하나로 합쳐 `publish_report` 에 준다
 
 `anchor_state` 가 `unmoored`·`reparented` 면 문서가 바뀌어 자리를 잃은 메모다 — `quote_exact` 로 본문에서 찾아 고치고, 못 찾으면 답글로 묻는다. 끝나면 사람에게 **한 줄로** 알린다: 반영 N건 · 답글로 되물은 N건 · 문서 링크.
 
+### 9b단계 — 검토 회신 반영: 개정하기 전에 회신의 **본문**부터
+
+검토 회신(문서의 한 자리에 핀으로 붙는 글)은 **판단 항목의 답이 오는 자리**다 — 고객도 쓰고 우리 담당자도 쓴다. 이미 나간 문서를 고칠 때는 고치기 **전에** 회신을 읽는다. `list_reports` 줄의 `검토 회신 N건 미반영`, `get_report` 머리의 「검토 회신 N건이 열려 있다」가 읽을 것이 있다는 신호다.
+
+| 순서 | 도구 | 할 일 |
+|---|---|---|
+| 1 | `list_notes(id)` | 검토 회신이 **본문과 함께** 실린다. `[회신 N]` 줄의 자리(「판단 항 「…」」·건·절·도판)가 **어느 물음에 대한 말인지**, 그 아래가 누가(고객/우리) 무슨 말을 했는지다. 답글은 뿌리 밑에 붙는다 |
+| 2 | (대조) | 회신마다 원고와 맞춰 본다 — 이미 답이 온 판단 항을 **열린 항으로 다시 묻고 있지 않은가**, 원고가 「회신에 언급이 없어 미결」이라고 쓴 자리가 회신과 어긋나지 않는가, 회신의 낱말과 정본(고객 문서)의 낱말이 갈리면 정본 낱말로 맞췄는가 |
+| 3 | `update_report(dry_run: true)` → `update_report` | 반영한다. 답이 온 판단 항은 닫힌 항 표로 옮기고 출처에 회신 날짜를 적는다. 교체 경고의 「열린 검토 회신 …」 줄은 회신의 본문과 함께 온다 — 그 회신을 이 판이 반영한 것이면 그대로 발행한다 |
+| 4 | `resolve_note(id, reply, rev)` | **반영한 뒤에만.** 표시해도 회신은 고객에게 그대로 보인다. 문서에 반영할 것이 없는 회신(인사·이미 답한 물음)도 읽었으면 표시한다 |
+
+- **회신대로 고치면 그 회신이 집은 문장은 바뀐다. 그것이 정상이다**(열람 화면의 「원문이 바뀜」). 핀을 「제자리」로 돌리려고 발행 문장을 옛 표기로 되돌리지 않는다 — 실제로 그렇게 해서 렌더러 경고만 얹은 판이 있었다.
+- **고객에게 보이는 답글은 에이전트가 달지 않는다.** 창구에 쓰는 길이 없다. 고객에게 할 말(「N차에 반영했습니다」)은 문안을 사람에게 넘기고, 사람이 포털에서 쓴다. 우리 팀끼리의 고칠 지시는 검토 회신이 아니라 첨삭 메모(9a)다.
+- 닫힌 판단 항은 원고에서 뺄 수밖에 없다(요청은 그려지는 한 열려 있다). 그 항에 달린 회신은 상위 절로 올라가 붙으니, 빼는 판에서 그 회신을 반영 표시한다.
+
 ### 8단계′ — 전달: 단일 HTML (Lim 밖 고객·메일 첨부)
 
 ```bash

package/skills/genetics-report/references/lim-portal-format.md

@@ -197,7 +197,7 @@ python3 assets/render.py <report.json>
 `cases[].remaining` 이 있으면 그 건은 대조표에서 **미결**로 선다.
 그 행이 독자에게 넘어가는 몫이라 다른 행과 시각적으로 갈린다.
 
-### `cases[].uid` · `sections[].uid` — 건과 절의 **불변 이름**
+### `cases[].uid` · `sections[].uid` · `open_items[].uid` — 건·절·판단 항목의 **불변 이름**
 
 **적지 않아도 된다. 다만 받은 것은 돌려보내라.**
 
@@ -215,9 +215,20 @@ python3 assets/render.py <report.json>
 | `uid` 를 빼고 제목도 바꿨다 | **새 이름이 발급된다** |
 | 처음 발행(`publish_report`) | 전부 새로 발급된다 — 적을 필요 없다 |
 
-**왜 지켜야 하나**: 저자가 그 건에 달아 둔 메모(`list_notes`)가 이 이름을 문다.
-이름이 바뀌면 메모가 사라지지는 않지만(인용문으로 다시 찾는다) 「자리를 잃음」으로 떨어져
-저자가 다시 붙여야 한다.
+**왜 지켜야 하나**: 저자가 그 건에 달아 둔 메모(`list_notes`)와 **고객이 문장에 달아 둔 검토 회신 핀**이
+이 이름을 문다. 이름이 바뀌면 사라지지는 않지만(인용문으로 다시 찾는다) 「자리를 잃음」으로 떨어져
+저자가 다시 붙여야 한다. 판단 항목(`open_items[]`)도 같은 이름을 들고(2026-09-17), 렌더러가 그 항의
+`<li>` 에 `data-uid` 로 내보낸다 — 항을 고치거나 순서를 바꿔도 핀이 그 항에 남는다.
+
+**검토 회신은 자리 표식이 아니라 판단 항목의 답이다 — 개정 전에 본문부터 읽는다**(2026-09-17~18 사고). 한 보고서를
+다시 쓰며 핀의 자리(앵커)만 재고 본문을 안 읽었더니, 이미 답이 달린 판단 항을 다섯 판 동안 열린 항으로 다시 물었고
+「회신에 언급이 없어 미결」이라고 사실과 다르게 적었고, 핀을 「제자리」로 돌리려고 발행 문장을 옛 표기로 되돌려 렌더러 경고만
+얹었다. 그래서 서버는 셋을 한다 — ① `list_reports`·`get_report`·`update_report` 응답이 **열린 검토 회신 수**(`open_replies`)를
+싣고 ② `list_notes(id)` 가 회신을 **본문·자리(어느 판단 항·건·도판인가)·지금 발행물에서의 자리 판정**과 함께 보여 주고
+③ `update_report` 는 `dry_run`·실전 둘 다에서 **열린 회신**의 문장이 이 원문에 없으면 경고한다(회신 본문과 함께).
+회신대로 고쳐 문장이 바뀌는 것은 정상이다 — 반영한 뒤 `resolve_note(id, reply, rev)` 로 표시하면 그 회신은 더는 경고하지 않는다.
+대조는 열람 셸과 같은 엄격 일치라 띄어쓰기 하나만 고쳐도 「원문이 바뀜」이다. 판정 전체는 응답 `pins[]`(도구 출력의
+「회신 핀 N건 — …」 줄). 절차는 SKILL 9b단계.
 
 ★ **같은 제목을 두 건에 쓰지 마라.** 위 2단이 어느 쪽인지 못 갈라 둘 다 새 이름을 받는다.
 
@@ -400,6 +411,7 @@ python3 assets/render.py <report.json>
 | 그룹에 배정되지 않은 건 N개 | `cases[].group` 이 어긋났다(그룹이 아예 없을 때) |
 | 그림 N장은 놓을 자리가 없어 | `logo`·`figure` 밖의 `role`(`hero`·`chapter`·`eof`) |
 | 도판 N장이 어느 절에도 걸리지 않아 | `sections[].plates` 나 `cases[].plates` 에 그 id 를 안 적었다 — 11-1절·11-10절 |
+| 열린 검토 회신 #N(이름 · 날짜) 「회신 본문」 — 집은 문장 「…」이 이 원문에 없습니다 — 원문이 바뀜 / 문장을 잃어 상위로 / 자리를 잃음 | `update_report` 만. **아직 반영 표시가 안 된** 회신이 집은 문장이 새 원문에 없다(3.5절 uid 항) — 이 판이 그 회신을 반영한 것이면 발행 뒤 `resolve_note(id, reply, rev)`, 아니면 회신 본문부터 읽는다(SKILL 9b). 핀을 살리려고 문장을 되돌리지 않는다 |
 | 절 …의 도판 「…」를 assets 에서 못 찾았습니다 | `plates` 가 없는 `assets[].id` 를 가리킨다(건 `plates` 면 「건 NN-n 의 도판」) |
 | 건 NN-n 에 묶인 도판 「…」는 전폭(wide)인데 건 안이라 본문 단 폭으로 섭니다 | `cases[].plates` 가 `wide:true` 자산을 가리킨다 — 건 안은 두 단 그리드라 전폭이 못 선다. 절 `plates` 로 옮기거나 `wide` 를 끈다(11-10절) |
 | 도판 「…」에 그림 바이트가 없습니다 | `file`·`source` 없이 이름만 왔다. 로컬 `render.py` 는 `file` 을 바이트로 굳히지 않아 `file` 이 있어도 뜬다 — 로컬에서는 이 줄을 빼고 나머지 ⚠ 를 읽는다 |