genetics-mcp 2.5.0 → 2.6.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,45 @@ 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 가 세션 수만큼 떠 있어도 **한 번만** 일한다.
+ */
+const OBSERVE_EVERY_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 { /* 최선만 다한다 */ }
+}
+
+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();
@@ -2254,6 +2313,9 @@ async function callTool(name, args = {}) {
       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 로 이 장을 먼저 찾는다.';
@@ -2729,6 +2791,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.6.0",
   "description": "문서 포털 발행·세션 이식·사례 기억 MCP — 데이터를 주면 규격 문서가 나온다 (짝인 스킬 동봉)",
   "author": "주식회사 LIM (LIM Inc.)",
   "license": "SEE LICENSE IN LICENSE",