genetics-mcp 2.5.0 → 2.7.0

package/bin/manifest.json

@@ -1,6 +1,6 @@
 {
-  "aarch64-apple-darwin": "088b89bdac75d16ed88e832471e46c0221c068a0caf888960b629a29e77f6eb2",
-  "aarch64-unknown-linux-musl": "4c2d40a9b9f09610c9de57fac3c14d385983d5c83d8adbd359d57a2458ba345f",
-  "x86_64-apple-darwin": "726ce268009952176e62887fef0f8dd97b7ee2c084d46a7af66c4f467697cec5",
-  "x86_64-unknown-linux-musl": "ec9c9a3105dbbaaaad284a82544268e77ed9295591430789d9a95761eaffc89e"
+  "aarch64-apple-darwin": "c0f7ca318d5e4e040b6118e835cbad3e467597d61e94d150c555ed050b5d1f57",
+  "aarch64-unknown-linux-musl": "5588db11a4aad41a65609d4cf14f389d106fb8b74023aa745ae4765738243006",
+  "x86_64-apple-darwin": "857d738a752776813e9ee52e972e93d046502aa8364ec9fe2d1ece8a0d770914",
+  "x86_64-unknown-linux-musl": "f01bf90ab7014764487773b9ac91ad8532ac6a727eedd6ff50151c3e6eab127e"
 }

package/genetics.mjs

@@ -21,7 +21,7 @@
  * 의존성 0 — MCP 는 stdio 위의 JSON-RPC 2.0 이라 표준 라이브러리로 충분하다.
  */
 
-import { spawnSync } from 'node:child_process';
+import { spawn, spawnSync } from 'node:child_process';
 import crypto from 'node:crypto';
 import fs from 'node:fs';
 import os from 'node:os';
@@ -1302,6 +1302,26 @@ function transcriptOf(uuid) {
 }
 
 /** 지금 심박을 보낼 세션들. 이 창의 세션 + 최근에 움직인 사본. */
+/**
+ * 지금 이 대화의 **출처** — `{session_uuid, head_id}`. 모르면 빈 객체.
+ *
+ * 인용 표(020)는 「이 대화의 **이 턴**이 그 사례의 근거다」를 적는다. 그런데 그 둘을
+ * 도구 인자로 두면 **모델이 지어낸다.** 그래서 여기서 로컬 상태로 채운다 —
+ * 세션 id 는 하네스가 준 환경변수, 턴은 전사의 마지막 발화 id 다.
+ *
+ * ⚠ **모르면 빈 객체를 준다.** 서버는 둘 다 있을 때만 적는다(`citation_ok`).
+ *   지어낸 출처 한 줄이 뒤에서 회수 보호의 근거가 되면, 걷어야 할 것을 안 걷게 된다.
+ */
+function myCitation() {
+  const uuid = process.env.CLAUDE_CODE_SESSION_ID || '';
+  if (!/^[0-9a-f-]{36}$/i.test(uuid)) return {};
+  const f = transcriptOf(uuid);
+  if (!f) return {};
+  const head = transcriptHead(f);
+  if (!head?.id) return {};
+  return { session_uuid: uuid, head_id: head.id };
+}
+
 function beatTargets() {
   const idx = indexRead();
   const mine = process.env.CLAUDE_CODE_SESSION_ID || '';
@@ -1484,6 +1504,49 @@ async function beatTick() {
   }
 }
 
+/*
+ * ── 훅 없이 관측한다 (2026-08-23) ──────────────────────────────────────
+ *
+ * **Codex 는 훅을 신뢰하기 전엔 안 돌린다**(`Hooks need review`), 그리고 그 화면이
+ * ChatGPT.app 경로에서는 안 뜬다(실측). 그래서 codex 세션은 훅으로 관측을 영영 못 올린다 —
+ * 그런데 이 프로젝트가 시작된 사고가 정확히 **옆 codex 가 배포한 것을 내가 몰랐던 일**이다.
+ *
+ * MCP 는 codex 밑에서도 돈다(실측: MCP PID 13409, 부모가 codex 45855). 훅도 신뢰도
+ * 안 지나는 자리다. 그래서 여기서 세포를 띄워 이 저장소의 최근 전사를 훑게 한다.
+ *
+ * ⚠ **심박에 얹지 않고 따로 돈다.** `beatTick()` 은 올린 세션이 없으면 일찍 빠져나가는데
+ *   (`if (!recs.length) return`), codex 는 대개 그 상태다. 얹었으면 영영 안 돌았을 것이다.
+ *
+ * 비용: 저장소를 아는 걸음으로 바꿔 **1,436ms → 320ms**(실측). 그리고 세포가 저장소마다
+ * 자물쇠를 잡으므로, MCP 가 세션 수만큼 떠 있어도 **한 번만** 일한다.
+ */
+// 시험은 20초를 못 기다린다. **갈아 끼울 수 있게** 둔다(`GCELL_STATE_DIR` 과 같은 규율) —
+// 다만 하한을 둬서 실수로 0.01초가 들어가 기계를 태우는 일은 막는다.
+const OBSERVE_EVERY_MS = Math.max(200, Number(cfg.GENETICS_OBSERVE_MS) || 20_000);
+let observeTimer = null;
+
+function observeTick() {
+  const { bin } = cellCheck();
+  if (!bin) return;                       // 세포가 없으면 할 수 있는 것이 없다
+  try {
+    // 떼어낸 자식이다 — MCP 는 도구 응답의 임계 경로에 있고, 이 일은 그것을 기다릴 이유가 없다.
+    // stdio 를 전부 막는다: MCP 의 stdout 은 **프로토콜**이라 한 글자만 흘려도 세션이 깨진다.
+    const c = spawn(bin, ['observe', '--root', process.cwd(), '--sync', '--quiet'],
+                    { stdio: 'ignore', detached: true });
+    c.unref?.();
+    c.on?.('error', () => {});
+  } catch { /* 최선만 다한다 */ }
+  // 세포가 방금 갱신했을 사실을 보고, 바뀌었으면 알린다(한 tick 늦는다 — 자식이 비동기다).
+  if (SEND) notifyToolsChanged(SEND);
+}
+
+function startObserve() {
+  if (cfg.GENETICS_NO_BEAT) return;       // 심박을 끄는 사람은 이것도 안 원한다
+  observeTick();
+  observeTimer = setInterval(observeTick, OBSERVE_EVERY_MS);
+  observeTimer.unref?.();                 // 창을 닫으면 노드가 남지 않게
+}
+
 function startBeat() {
   if (cfg.GENETICS_NO_BEAT) return;          // 심박을 원치 않는 사람의 탈출구
   const cred = credential();
@@ -1503,6 +1566,19 @@ async function stopBeat() {
 }
 
 const TOOLS = [
+  /*
+   * ★ **이 도구는 부르지 않아도 일한다.** 설명 자체가 세계 사실을 실어 나른다(`toolsNow()`).
+   * 도구 목록은 매 턴 모델 문맥에 있으므로, 부르기 전에 이미 눈앞에 놓인다.
+   * 부르면 더 많이(8건) 말한다 — 설명에는 3건만 싣는다.
+   */
+  {
+    name: 'world',
+    description:
+      '이 저장소에서 **다른 세션·다른 기계**가 최근에 무엇을 바꿨나. '
+      + '「누가 언제 무엇을」만 말하고 무엇을 할지는 안 말한다. '
+      + '고치기 전에 「내가 알고 있는 것이 아직 맞나」가 궁금하면 이것을 본다.',
+    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+  },
   {
     name: 'login',
     description:
@@ -1955,21 +2031,89 @@ function cellClean(s) {
     .slice(0, 200);
 }
 
-function worldDelta() {
-  const { bin, why } = cellCheck();
-  if (!bin) return cellNotice(why);
+/**
+ * 세계 사실을 **줄 단위로**. 도구 응답 꼬리와 도구 설명이 **같은 것**을 쓰게 하려고 뺐다 —
+ * 두 곳에서 따로 지으면 같은 사실을 다르게 말하게 된다.
+ *
+ * ⚠ **시각을 함께 말한다.** 오늘 사고에서 결정적이었던 정보가 정확히 「20:04 에」였다.
+ *   `gcell delta` 의 글 출력은 2026-08-23 에 고쳤는데, MCP 는 `--json` 을 **자기가 포맷**하고
+ *   있어서 여기만 여전히 시각을 버리고 있었다. 같은 결함이 두 자리에 있었던 것이다.
+ */
+function worldFacts(max = 8) {
+  const { bin } = cellCheck();
+  if (!bin) return null;                               // 세포가 없다 — 「없다」와 구별한다
   try {
     const r = spawnSync(bin, ['delta', '--root', process.cwd(), '--json'],
                         { encoding: 'utf8', timeout: 800 });
-    if (r.error) return cellNotice('세포를 띄우지 못했다');
-    if (r.status !== 0 || !r.stdout) return '';
+    if (r.error || r.status !== 0 || !r.stdout) return [];
     const d = JSON.parse(r.stdout);
     const ch = Array.isArray(d.changes) ? d.changes : [];
-    if (!ch.length) return '';                         // 조용한 구간은 조용하다.
-    const lines = ch.slice(0, 8).map((c) => `  · ${cellClean(c.path)} — ${cellClean(c.client)} 세션이 썼다`);
-    if (ch.length > 8) lines.push(`  · 그 밖 ${ch.length - 8}건`);
-    return `이 저장소에서 최근에 바뀐 것:\n${lines.join('\n')}`;
-  } catch { return cellNotice('세포의 답을 못 읽었다'); }
+    const out = ch.slice(0, max).map((c) => {
+      const at = Number(c.at) || 0;
+      const t = at > 0
+        ? new Date(at * 1000).toTimeString().slice(0, 5)
+        : '시각 미상';
+      return `${cellClean(c.path)} — ${cellClean(c.client)} 세션이 ${t}에 썼다`;
+    });
+    if (ch.length > max) out.push(`그 밖 ${ch.length - max}건`);
+    return out;
+  } catch { return null; }
+}
+
+function worldDelta() {
+  const { bin, why } = cellCheck();
+  if (!bin) return cellNotice(why);
+  const facts = worldFacts(8);
+  if (facts === null) return cellNotice('세포의 답을 못 읽었다');
+  if (!facts.length) return '';                        // 조용한 구간은 조용하다.
+  return `이 저장소에서 최근에 바뀐 것:\n${facts.map((f) => `  · ${f}`).join('\n')}`;
+}
+
+/*
+ * ★★ **도구 설명이 유일한 통로다** — 이 파일의 스모크가 2026-08-20 에 그렇게 적어 뒀고
+ * (「initialize 의 instructions 는 선택 필드라 클라이언트가 안 실을 수 있다」),
+ * 2026-08-23 에 Codex 로 **실증됐다**: 지침에 있는 문장을 물었더니 codex 는 문맥에서 답하지
+ * 못하고 `rg` 로 저장소를 뒤져 `mcp/genetics.mjs` 를 읽어 찾았다. 즉 그 세션의 문맥에
+ * instructions 가 **없었다.**
+ *
+ * 그런데 도구 목록은 **구조상 반드시 문맥에 있다**(없으면 모델이 도구를 못 부른다).
+ * 그래서 세계 사실을 거기에 싣는다. 부르지 않아도 **눈앞에 놓인다** —
+ * README 가 적어 둔 그 원칙(「검색 도구가 아니라 눈앞에 놓기」)의 유일한 이식 경로다.
+ *
+ * ⚠ 다른 도구의 설명은 **안 건드린다.** 발동 낱말이 곧 기능이라(스모크가 그것을 붙든다)
+ *   변하는 문장을 섞으면 도구 선택이 흔들린다. 자리를 하나 따로 둔다.
+ */
+/*
+ * ★ **세션 도중에도 갱신한다.** 위 `toolsNow()` 는 `tools/list` 시점의 사실을 싣는데,
+ * 그 시점은 사실상 **세션 시작**이다. 그러면 「자리를 비운 사이」는 덮어도
+ * 「지금 막 일어난 일」은 못 덮는다 — 그리고 오늘 사고가 정확히 후자였다
+ * (내가 일하는 동안 옆 세션이 배포했다).
+ *
+ * codex 가 `notifications/tools/list_changed` 를 안다(바이너리 7회). 사실이 **바뀌었을 때만**
+ * 보낸다 — 매 tick 보내면 클라이언트가 매번 다시 묻고, 그건 소음이다.
+ */
+let toolsSig = null;
+let toolsNotifyReady = false;          // initialize 전에는 안 보낸다
+// stdout 에 쓰는 문은 **하나**다(`send`). 그 함수가 아래 범위에 있어 여기로 이어 둔다 —
+// 두 곳에서 각자 쓰면 응답 한가운데에 알림이 끼어 프로토콜이 깨진다.
+let SEND = null;
+
+function notifyToolsChanged(sendFn) {
+  const facts = worldFacts(3);
+  const sig = facts === null ? null : facts.join('|');
+  if (sig === null) return;                       // 세포를 못 읽었다 — 지어내지 않는다
+  if (toolsSig === null) { toolsSig = sig; return; }   // 첫 관측은 기준선일 뿐이다
+  if (sig === toolsSig) return;                   // 조용한 구간은 조용하다
+  toolsSig = sig;
+  if (!toolsNotifyReady) return;
+  try { sendFn({ jsonrpc: '2.0', method: 'notifications/tools/list_changed' }); } catch { /* 최선만 */ }
+}
+
+function toolsNow() {
+  const facts = worldFacts(3);
+  if (!facts || !facts.length) return TOOLS;           // 조용한 구간은 조용하다
+  const head = `\n\n지금 이 저장소:\n${facts.map((f) => `  · ${f}`).join('\n')}`;
+  return TOOLS.map((t) => (t.name === 'world' ? { ...t, description: t.description + head } : t));
 }
 
 /**
@@ -2250,10 +2394,19 @@ async function callTool(name, args = {}) {
       return `교체 완료 — ${r.tenant} · 건 ${r.cases}${st}\n열람 주소: ${r.url}\n${r.note || ''}`
         + pendingText(r) + warnText(r);
     }
+    case 'world': {
+      const facts = worldFacts(8);
+      if (facts === null) return cellNotice('세포의 답을 못 읽었다');
+      if (!facts.length) return '이 저장소에서 최근에 남이 바꾼 것은 없다.';
+      return `이 저장소에서 최근에 바뀐 것:\n${facts.map((f) => `  · ${f}`).join('\n')}`;
+    }
     case 'remember_case': {
       const r = await api('POST', '/api/wiki/case?tenant=' + encodeURIComponent(args.tenant), {
         title: args.title, symptom: args.symptom, cause: args.cause || '', fix: args.fix,
         evidence: args.evidence || '', tags: args.tags || [],
+        // ★ **출처는 우리가 채운다 — 모델에게 안 묻는다.** 스키마에 노출하면 지어낸다
+        //   (DESIGN-session-as-vcs.md:136-141). 모르면 안 보내고, 서버는 안 적는다.
+        ...myCitation(),
       });
       return `${r.note} — ${r.tenant} · ${r.path}\n`
         + '다음에 같은 증상을 만나면 search_cases 로 이 장을 먼저 찾는다.';
@@ -2454,6 +2607,7 @@ process.stdout.on('error', (e) => {
 function send(msg) {
   process.stdout.write(JSON.stringify(msg) + '\n');
 }
+SEND = send;
 
 let buf = '';
 
@@ -2499,7 +2653,9 @@ async function handle(line) {
         CLIENT = req.params?.clientInfo || null;
         result = {
           protocolVersion: req.params?.protocolVersion || '2024-11-05',
-          capabilities: { tools: {} },
+          // ★ `listChanged` 를 **선언해야** 알림을 보낼 자격이 생긴다. 명세상 안 알리고
+          //   보내면 클라이언트가 버려도 할 말이 없다.
+          capabilities: { tools: { listChanged: true } },
           /*
            * 자기소개 이름. **도구 이름 접두사와 다른 물건이다** — 그 접두사는 클라이언트 설정
            * 키(`claude mcp add --scope user <키>`)에서 나오고, 패키지는 그 값을 못 바꾼다.
@@ -2537,8 +2693,9 @@ async function handle(line) {
             '내 소속이 아닌 곳은 존재도 안 보이므로, 404 는 "없다"가 아니라 "내 것이 아니다"일 수 있다.',
           ].join('\n'),
         };
+        toolsNotifyReady = true;
       } else if (req.method === 'tools/list') {
-        result = { tools: TOOLS };
+        result = { tools: toolsNow() };
       } else if (req.method === 'tools/call') {
         const text = await callTool(req.params?.name, req.params?.arguments || {});
         result = { content: [{ type: 'text', text }] };
@@ -2729,6 +2886,7 @@ if (IS_MAIN) {
    * 꺼진 것이지 고장이 아니다(그림 자격이 없을 때와 같은 태도).
    */
   startBeat();
+  startObserve();   // 훅이 안 걸리는 도구(Codex)도 관측을 올린다 — 위 머리말 참조
   process.stdin.setEncoding('utf8');
   process.stdin.on('data', (chunk) => { buf += chunk; pump(); });
   process.stdin.on('end', () => { pump(true); stopBeat().catch(() => {}); });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genetics-mcp",
-  "version": "2.5.0",
+  "version": "2.7.0",
   "description": "문서 포털 발행·세션 이식·사례 기억 MCP — 데이터를 주면 규격 문서가 나온다 (짝인 스킬 동봉)",
   "author": "주식회사 LIM (LIM Inc.)",
   "license": "SEE LICENSE IN LICENSE",
@@ -18,7 +18,7 @@
     "node": ">=18"
   },
   "scripts": {
-    "test": "node smoke.mjs && bash ../cell/tests/cellcycle.sh",
+    "test": "node smoke.mjs && node notify.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"
   }