genetics-mcp 2.8.1 → 2.9.1

package/bin/manifest.json

@@ -1,6 +1,6 @@
 {
-  "aarch64-apple-darwin": "c0f7ca318d5e4e040b6118e835cbad3e467597d61e94d150c555ed050b5d1f57",
-  "aarch64-unknown-linux-musl": "5588db11a4aad41a65609d4cf14f389d106fb8b74023aa745ae4765738243006",
-  "x86_64-apple-darwin": "857d738a752776813e9ee52e972e93d046502aa8364ec9fe2d1ece8a0d770914",
-  "x86_64-unknown-linux-musl": "f01bf90ab7014764487773b9ac91ad8532ac6a727eedd6ff50151c3e6eab127e"
+  "aarch64-apple-darwin": "0be4865075eacbd2c83cb2fad02b92458969a33eea636b2f68d7d704f6cf60b5",
+  "aarch64-unknown-linux-musl": "206709a078fa1814b49aa8e59012a28542496bc1d08b4e75c9ee716c00a09a11",
+  "x86_64-apple-darwin": "519dfad58dc6e7dc67a820bd386e4a6d54eb4e3c5c706f5178d147d0d0ed0cae",
+  "x86_64-unknown-linux-musl": "56b7c532ae56e814abfbe460d7761ddec3a0631f2eea0cc68ad29d6efe2fa2cd"
 }

package/genetics.mjs

@@ -635,12 +635,65 @@ const REPORT_DATA = {
      * 믿는데 실제로는 무시된다 — 거짓말하는 인자다. 고를 것이 생기면 그때 연다.
      */
     title_tag: { type: 'string', description: '브라우저 탭 제목' },
-    title: { type: 'string', description: '표지 제목' },
+    title: { type: 'string', description: '표지 대제목 **첫 행** (굵게)' },
+    title_sub: {
+      type: 'string',
+      description: '표지 대제목 **둘째 행** — 회차·부제. "1차 보고" 처럼 **짧게**. '
+                 + '여기는 42px 표제 자리라 문장을 넣으면 조판이 무너진다. 한 문단 요약은 subtitle 로.',
+    },
     kicker: { type: 'string', description: '표지 윗줄 (예: "회사명 · 프로젝트")' },
-    subtitle: { type: 'string', description: '표지 한 문단 요약' },
+    subtitle: { type: 'string', description: '표지 한 문단 요약 — 대제목 **아래**에 앉는다' },
     description: { type: 'string' },
-    meta: { type: 'array', description: '표지 메타 [[라벨, 값], ...]' },
-    stats: { type: 'array', description: '표지 숫자 [{value, unit, label}]' },
+    doc_no: { type: 'string', description: '문서번호. 표지 머리 왼쪽 박스 (예: "LIM-2026-0824-01")' },
+    client: {
+      type: 'string',
+      description: '고객사명. 표지 머리 **오른쪽**은 고객사 마크의 자리다 — 로고 파일을 '
+                 + '받았으면 assets 에 role:"logo" 로 넣고, 못 받았으면 이 이름을 활자로 세운다. '
+                 + '비워 두지 마라: 빈 자리는 「받을 것을 못 받은 문서」로 읽힌다.',
+    },
+    issuer: {
+      type: 'array',
+      description: '표지 맨 아래 발행처 스트립 ["발행처", "대상", "2026. 8."] — 마지막 칸이 날짜다.',
+    },
+    meta: { type: 'array', description: '표지 메타 [[라벨, 값], ...] · 4칸 권장' },
+    stats: { type: 'array', description: '요약면 수치 칸 [{value, unit, label, accent?, href?}] · accent:true 는 **독자 몫**인 첫 칸' },
+    history: {
+      type: 'array',
+      description: '발행 이력 [{no, date, note}] — 회차 문서임을 문서가 스스로 밝히는 자리.',
+    },
+    guide: {
+      type: 'array',
+      description: '이 문서 읽는 법 [{q, a: [문장, ...]}] — **독자가 실제로 던질 질문**만. '
+                 + '「시간이 없다면 어디를 봐야 하는가?」 「어디까지 확인한 것인가?」 처럼. '
+                 + '채우려고 넣으면 안 넣느니만 못하다.',
+    },
+    parts: {
+      type: 'array',
+      description: 'PART 묶음 [{no, title, lede?, tone?, questions?}] — 절만 늘어놓으면 '
+                 + '「먼저 읽을 것 / 경과 / 남은 것」이라는 독자의 읽기 순서가 사라진다. '
+                 + 'tone 은 you(독자 몫)·neutral(기록)·wait(대기)·hold(유보) 중 하나. '
+                 + 'questions 는 「이 PART 가 답하는 질문」.',
+    },
+    notice: {
+      type: 'object',
+      description: '요약면 현황 줄 {state, text} — state 는 critical|info|success. '
+                 + '**상태에 따라 바뀌는 유일한 줄**이다. 떠 있는 알림 배너를 따로 두지 마라.',
+    },
+    bar: { type: 'array', description: '요약면 상태 막대 [{value, label, tone}] · tone 은 done|wait' },
+    bar_note: { type: 'string', description: '막대가 뜻하는 바의 한정 조건 (※ 각주)' },
+    bar_alt: { type: 'string', description: '막대의 대체 텍스트 (보조기기용)' },
+    appendix: {
+      type: 'array',
+      description: '부록 [{no, title, rows: [[라벨, 값], ...], note?}] — 본문에서 **반복 참조되는** '
+                 + '기준·환경을 뒤로 뺀다(확인 환경, 판정 기준 등).',
+    },
+    colophon: {
+      type: 'object',
+      description: '판권지 {title?, sub?, rows?, mark?, badge?, note?, tail?} — 표지와 같은 문법으로 '
+                 + '문서를 닫는다. badge 는 「내부 공유용」 같은 표시.',
+    },
+    remain: { type: 'string', description: '머리띠 우측 판독부의 수치(요청 잔여 건수). 생략하면 open_items 개수.' },
+    running_footer: { type: 'string', description: '인쇄 러닝 푸터의 뒷말. 생략하면 client.' },
     grades: { type: 'object', description: '확인 등급 정의 {이름: [클래스, 설명]}' },
     groups: { type: 'array', description: '건 묶음 [{key, no}]' },
     sections: {
@@ -656,7 +709,21 @@ const REPORT_DATA = {
                  + '· `logic`: {kicker, title_lines[], lede, models:[{label, flow[], body}, …]} — 대조 도해. '
                  + '`flow` 는 「현재 상태 → 인접 등급 → 도착점」 같은 단계이고 **마지막 칸이 강조**된다. '
                  + '첫 모델이 「현재」, 그다음이 「개선」으로 그려진다(자리로 정한다).\n'
-                 + '둘 다 **데이터가 있을 때만** 그려진다 — 없는 문구를 지어내지 말 것.',
+                 + '둘 다 **데이터가 있을 때만** 그려진다 — 없는 문구를 지어내지 말 것.\n'
+                 + '\n'
+                 + '관보 문법이 절마다 요구하는 칸:\n'
+                 + '· `part`: 이 절이 속한 PART 의 no. 안 주면 첫 묶음으로 떨어진다.\n'
+                 + '· `marg`: {why, key, advice} — **좌측 여백 주석 단. 이것이 본체다.** '
+                 + '없으면 두 단 본문이 한 단으로 서고, 문서는 「문서처럼 꾸민 웹페이지」가 된다. '
+                 + 'why 는 **독자가 실제로 던질 질문**(「무엇을 조치해야 하는가?」), '
+                 + 'key 는 이 절에서 하나만 가져간다면 그것, advice 는 어디를 참조하라는 것. '
+                 + '채우려고 넣으면 안 넣느니만 못하다.\n'
+                 + '· `lede`: 절 간지의 도입문 — 다루는 범위와 **다루지 않는 범위**.\n'
+                 + '· `sub`: 차례 행에 붙는 한 줄 설명. `short`: 측면 색인 레일용 짧은 이름.\n'
+                 + '· `tone`: 장 색을 뜻으로 고른다 — you(독자 몫)·deep(요지)·neutral(허브)·'
+                 + 'done(끝난 것)·wait(대기)·hold(유보). 생략하면 kind 가 정한다.\n'
+                 + '· kind:status 전용 — `board_title`(대조표 제목) · `board_hint`(표 아래 안내).\n'
+                 + '· kind:note 전용 — `paragraphs`(강조 박스의 항목) · `limit_label`(그 박스 제목).',
     },
     chapters: {
       type: 'array',
@@ -722,8 +789,11 @@ const REPORT_DATA = {
         properties: {
           id: { type: 'string', description: '영소문자·숫자·하이픈 1~40자. 문서 안 참조 이름' },
           role: {
-            type: 'string', enum: ['hero', 'chapter', 'figure', 'eof'],
-            description: '`eof` 는 **문서 끝 꼬리 카드**다. 안 줘도 된다 — 서버가 기본 카드를 '
+            type: 'string', enum: ['hero', 'chapter', 'figure', 'eof', 'logo'],
+            description: '`logo` 는 **표지 우상단 고객사 마크**다 — provider 는 user-provided, '
+              + 'origin 에 제공자를 적는다. 못 받았으면 넣지 말고 data.client 에 이름만 적어라 '
+              + '(렌더러가 활자로 세운다).\n'
+              + '`eof` 는 **문서 끝 꼬리 카드**다. 안 줘도 된다 — 서버가 기본 카드를 '
               + '끼운다(계약 9절). 이 문서만의 카드가 있을 때만 준다. 그때는 무손실(PNG 또는 '
               + '무손실 WebP)이어야 하고 줄이지 않고 원본 크기로 실린다.',
           },
@@ -1640,6 +1710,8 @@ async function beatTick() {
     beatLastSent = Date.now();
     const reply = await beatOnce(recs);
     await autoPushIfAhead(reply, recs);
+    // 두뇌가 짚은 모순을 긷는다 — 실패해도 심박을 안 멈춘다(안 오는 것이 고장은 아니다).
+    try { await brainPull(); } catch { /* 그물·자격 문제는 다음 바퀴에 다시 */ }
   } finally {
     beatRunning = false;
   }
@@ -2180,6 +2252,23 @@ function cellClean(s) {
  *   `gcell delta` 의 글 출력은 2026-08-23 에 고쳤는데, MCP 는 `--json` 을 **자기가 포맷**하고
  *   있어서 여기만 여전히 시각을 버리고 있었다. 같은 결함이 두 자리에 있었던 것이다.
  */
+/**
+ * 사건 한 줄을 **누구**로 부를까. 서버의 `world_who()`(`lib/world_delta.php`)와 **같은 규칙**이다 —
+ * 두 자로 말하면 같은 사실을 화면과 도구가 다르게 말한다.
+ *
+ * ⚠ **`unknown` 은 이름이 아니다.** 전에는 `client` 하나만 찍어 「unknown 세션이 썼다」로
+ *   나갔고, 사람이 읽으면 「unknown 이라는 세포」로 보였다(사용자 지적 2026-08-24).
+ *   세포는 세션을 알고 있었다 — 아는 것을 안 쓰고 모르는 것을 이름 자리에 놓고 있었다.
+ */
+function worldWho(c) {
+  const client = cellClean(c.client || '').trim();
+  const sid = cellClean(c.session || c.session_uuid || '').trim();
+  const short = sid ? sid.slice(0, 8) : '';
+  if (client && client !== 'unknown') return short ? `${client}(${short}) 세션이` : `${client} 세션이`;
+  if (short) return `${short} 세션이`;
+  return '누군가';
+}
+
 function worldFacts(max = 8) {
   const { bin } = cellCheck();
   if (!bin) return null;                               // 세포가 없다 — 「없다」와 구별한다
@@ -2194,7 +2283,7 @@ function worldFacts(max = 8) {
       const t = at > 0
         ? new Date(at * 1000).toTimeString().slice(0, 5)
         : '시각 미상';
-      return `${cellClean(c.path)} — ${cellClean(c.client)} 세션이 ${t}에 썼다`;
+      return `${cellClean(c.path)} — ${worldWho(c)} ${t}에 썼다`;
     });
     if (ch.length > max) out.push(`그 밖 ${ch.length - max}건`);
     return out;
@@ -2268,7 +2357,122 @@ function cellNotice(why) {
   ].join('\n');
 }
 
+/* ── ★★ 백신 받기 — 두뇌가 짚은 **모순**을 이 세션 눈앞에 놓는다 ──────────────
+ *
+ * 사용자의 진단(2026-08-24): 여러 세포가 한 군체를 다룰 때 **정상적으로 일하는 사람이
+ * 두뇌에겐 바이러스가 된다.** 그러면 두뇌가 그 세션에게 **되돌려 줄 줄 알아야** 한다.
+ *
+ * ── 왜 세포(gcell)가 아니라 여기서 긷나 ────────────────────────────────────
+ * 세포도 같은 장부를 긷지만 `kind != "write"` 를 **버린다**(`cell/src/server.rs:254`).
+ * 통과시켜도 `root.join(ref)` 로 ref 를 경로 취급해 **없는 파일**을 「최근에 바뀐 것」으로
+ * 만든다 — 그 파일의 주석이 바로 그 해악을 경고한다. 세포를 다시 굽는 것은 별건이라,
+ * 검토는 이 자리에서 **직접** 긷는다(사람 자격으로 열리는 창구다).
+ *
+ * ── 처음 한 바퀴에 옛날 것을 읊지 않는다 ────────────────────────────────────
+ * 커서가 없으면 지난 것을 전부 「지금 일」로 읽는다. 그래서 첫 바퀴는 **커서만 맞추고**
+ * 최근 10분 것만 말한다. 커서는 색인에 적어 두므로 이 프로세스가 죽었다 살아나도 안 잃는다.
+ */
+const BRAIN_POLL_MS  = 120_000;   // 굽기는 분 단위다 — 20초 심박마다 두드릴 이유가 없다
+const BRAIN_FRESH_MS = 600_000;   // 첫 바퀴에 「방금 것」으로 볼 나이
+const BRAIN_PAGE     = 200;       // 서버 상한(WORLD_PAGE_MAX)과 같다
+let brainAt = 0;
+let brainCursor = null;           // null = 아직 색인에서 안 읽었다
+const brainQueue = [];            // 아직 안 말한 모순
+
+async function brainPull() {
+  const mine = process.env.CLAUDE_CODE_SESSION_ID || '';
+  if (!mine) return;
+  const e = indexRead()[mine];
+  if (!e?.tenant || !e?.tenant_id) return;          // 아직 어느 소속처인지 모른다
+  const cred = credential();
+  // **키로는 세계 장부를 못 연다** — 서버가 사람 토큰만 받는다(`api.php` 의 world 라우트).
+  if (!cred || cred.kind !== 'user') return;
+  if (Date.now() - brainAt < BRAIN_POLL_MS) return;
+  brainAt = Date.now();
+
+  const first = brainCursor === null;
+  if (first) brainCursor = Number(e.brain_cursor || 0);
+  const cwd = relHome(process.cwd());
+  const fresh = [];
+  for (let page = 0; page < 10; page++) {
+    const r = await api('GET', '/api/world?tenant=' + encodeURIComponent(e.tenant)
+      + '&since=' + brainCursor + '&cwd=' + encodeURIComponent(cwd) + '&limit=' + BRAIN_PAGE);
+    const evs = Array.isArray(r?.events) ? r.events : [];
+    for (const ev of evs) if (ev?.kind === 'review' && ev?.ref) fresh.push(ev);
+    if (typeof r?.cursor === 'number' && r.cursor > brainCursor) brainCursor = r.cursor;
+    if (!r?.truncated) break;
+  }
+  indexNote(mine, { tenant: e.tenant, tenant_id: e.tenant_id, brain_cursor: brainCursor });
+
+  const now = Date.now();
+  for (const ev of fresh) {
+    if (!brainFresh(ev, first, now)) continue;
+    brainQueue.push(String(ev.ref));
+  }
+}
+
+/**
+ * 이 사건을 **지금 일로 말해도 되나.**
+ *
+ * 커서가 있는 바퀴(=이 프로세스가 이미 따라잡은 뒤)라면 내려온 것은 정의상 새것이라 전부 참.
+ * **첫 바퀴만** 나이를 본다 — 커서가 0이면 지난 것이 통째로 내려오는데, 그것을 읊으면
+ * 이미 끝난 이야기를 **지금 하는 일로** 읽는다. 그게 이 물건이 막으려던 바로 그 병이다.
+ *
+ * ⚠ 시각을 못 읽으면 **안 말한다.** 모르는 것을 「방금」으로 치는 쪽이 더 위험하다.
+ */
+function brainFresh(ev, first, now) {
+  if (!first) return true;
+  const at = brainAtMs(ev);
+  return at > 0 && now - at <= BRAIN_FRESH_MS;
+}
+
+/**
+ * 서버가 준 `at` 을 밀리초로. **서버는 시간대 표식 없는 UTC 로 준다.**
+ *
+ * ⚠⚠ 맨몸 `Date.parse("2026-08-24 01:50:30")` 은 그 문자열을 **로컬 시각**으로 읽는다.
+ *    서버는 `world_at()` 에서 `gmdate('Y-m-d H:i:s')` 로 쓰므로 실제로는 UTC 다
+ *    (서버 스스로도 그것을 안다 — `world_delta.php` 가 화면에 쓸 때 `…substr(at,11,5) . 'Z'`).
+ *    그래서 **KST(+9) 기계에서는 방금 난 모순이 9시간 낡은 것**으로 보인다.
+ *    첫 바퀴는 나이를 보고 버리므로 백신이 통째로 사라지고, **커서는 그대로 전진해**
+ *    그 사건들은 이 세션에서 영영 안 온다. 조용한 손실이다.
+ *
+ * 2026-08-24 실측: 같은 하네스에 서버 꼴을 넣으면 백신 0건, `Z` 를 붙이면 1건.
+ * 내 첫 PoC 가 이걸 놓친 이유는 픽스처가 `toISOString()` 이라 **실제로 깨지는 그 꼴을
+ * 비켜 갔기** 때문이다 — 픽스처는 서버가 진짜 주는 글자여야 한다.
+ *
+ * ⚠ 시각을 못 읽으면 **0**. 모르는 것을 「방금」으로 치는 쪽이 더 위험하다.
+ */
+const BRAIN_AT_NAIVE = /^(\d{4}-\d{2}-\d{2})[ T](\d{2}:\d{2}:\d{2})$/;
+function brainAtMs(ev) {
+  const s = String(ev?.at || '').trim();
+  const m = BRAIN_AT_NAIVE.exec(s);
+  return (m ? Date.parse(`${m[1]}T${m[2]}Z`) : Date.parse(s)) || 0;
+}
+
+/**
+ * 큐에 쌓인 모순을 **한 번씩만** 말한다.
+ *
+ * ⚠ **지시를 안 붙인다.** 실측 2026-08-22: 「…라고 말하라」를 실었더니 모델이 *「가짜 시스템」*
+ *   이라며 거부했다 — 옳은 거부다. 서버도 `world_event_clean()` 으로 지시형을 막는다.
+ *   여기서는 **어디를 보면 되는지**만 덧붙인다(사실).
+ */
+function brainSays() {
+  if (!brainQueue.length) return '';
+  const n = brainQueue.length;
+  const lines = brainQueue.splice(0, n).map((t) => `  · ${t}`);
+  return '두뇌가 이 폴더의 지식에서 모순을 짚었다:\n' + lines.join('\n')
+    + '\n전문은 포털 지식 화면의 검토 목록에 있다. search_cases 로 그 주제를 찾으면'
+    + ' 「⚠ 상태:」가 붙은 장이 어느 것인지 보인다.';
+}
+
 function worldAppend(result) {
+  /*
+   * ★ 백신이 **먼저**다. 세계 델타는 「누가 무엇을 썼다」는 배경이고, 모순은 지금 하는 일을
+   *   바꿀 수 있는 사실이다. 그리고 델타가 비어도(조용한 구간) 백신은 나가야 한다 —
+   *   아래 `if (!t) return;` 뒤에 두면 **조용한 날엔 영영 안 간다.**
+   */
+  const v = brainSays();
+  if (v) result.content.push({ type: 'text', text: v });
   const t = worldDelta();
   if (!t) return;
   /*
@@ -2612,7 +2816,14 @@ async function callTool(name, args = {}) {
           + '이번에 고치면 remember_case 로 남길 것.';
       }
       return `«${args.q}» — ${r.hits.length}건(${r.scanned}장 중${r.expanded ? ', 의미 확장으로 다시 찾음' : ''})\n`
-        + r.hits.map((h) => `· ${h.path} [${h.score}점]\n  ${h.excerpt}`).join('\n')
+        /*
+         * ★ **뒤집힌 결정을 살아 있는 것으로 읽지 않게 한다.** 점수로는 구별이 안 되고,
+         *   찾는 쪽은 위에 뜬 것을 지금 참인 것으로 읽는다 — 그렇게 낡은 결정이 다음
+         *   세포에게 전달된다. 「유효」는 **서버가 걸러서** 안 온다 — 그 규칙을 여기 두면
+         *   화면과 갈린다(`wiki_page_status()` 머리말).
+         */
+        + r.hits.map((h) => `· ${h.path} [${h.score}점]${h.status ? `\n  ⚠ 상태: ${h.status}` : ''}`
+                          + `\n  ${h.excerpt}`).join('\n')
         + '\n전문은 get 이 아니라 포털 지식 화면에서 본다(경로 그대로).';
     }
     case 'list_sessions': {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genetics-mcp",
-  "version": "2.8.1",
+  "version": "2.9.1",
   "description": "문서 포털 발행·세션 이식·사례 기억 MCP — 데이터를 주면 규격 문서가 나온다 (짝인 스킬 동봉)",
   "author": "주식회사 LIM (LIM Inc.)",
   "license": "SEE LICENSE IN LICENSE",