genetics-mcp 2.21.0 → 2.22.0

package/bin/manifest.json

@@ -1,6 +1,7 @@
 {
-  "aarch64-apple-darwin": "70aa0772b147db518b10f22ab6a027a3b7b6a98bbc6d477505bf69cb9d9b447c",
-  "aarch64-unknown-linux-musl": "87fecda2d2348a0403957b3ab7b7ed55dff72560d6768ad241d93861ab5c56d0",
-  "x86_64-apple-darwin": "4877439d3b788c303fced3dd458331f21d3661f4eb463572c260e2c82888c165",
-  "x86_64-unknown-linux-musl": "58e7821dd31b81232175023a86db8659cb2f5c5d47620e7b939df4e155f93b98"
+  "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 });
@@ -4725,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() {
@@ -4897,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)} 확정, 자동 올리기 켬)에서 `
@@ -4954,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 '';
   }
@@ -5167,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');
 }
 
 /* ── ★★ 메일 레인 — 두뇌·다른 세션·사람이 **나를 지목해** 보낸 것 ──────────
@@ -6844,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) {
@@ -6857,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');
@@ -7332,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.21.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"