genetics-mcp 2.8.0 → 2.9.0

package/bin/manifest.json

@@ -1,6 +1,6 @@
 {
-  "aarch64-apple-darwin": "c0f7ca318d5e4e040b6118e835cbad3e467597d61e94d150c555ed050b5d1f57",
+  "aarch64-apple-darwin": "3f5fdf3c6029d94eafdb4ecf34f502676b3262f15de05eb54ecf6483d2d0f829",
   "aarch64-unknown-linux-musl": "5588db11a4aad41a65609d4cf14f389d106fb8b74023aa745ae4765738243006",
-  "x86_64-apple-darwin": "857d738a752776813e9ee52e972e93d046502aa8364ec9fe2d1ece8a0d770914",
+  "x86_64-apple-darwin": "8c440a19d2aee09dc8e2c3fe0a1b513563a7ab023d97722b99e5bae8eeb2cc62",
   "x86_64-unknown-linux-musl": "f01bf90ab7014764487773b9ac91ad8532ac6a727eedd6ff50151c3e6eab127e"
 }

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)이어야 하고 줄이지 않고 원본 크기로 실린다.',
           },
@@ -1537,7 +1607,36 @@ function beatWell() {
 /* 자동 올리기 — **서버 사본이 낡았을 때만.** 사용자 결정(2026-08-20)이라 기본이 켜짐이고,
  * 끄는 길을 함께 둔다(`GENETICS_NO_AUTO_PUSH=1`). 이 값은 「내부 대화가 서버에 쌓인다」를
  * 뜻하므로, 끄는 길이 없으면 결정이 아니라 함정이 된다. */
-const AUTO_PUSH = !cfg.GENETICS_NO_AUTO_PUSH;
+/**
+ * 이 텍스트와 환경변수로 **자동 올리기가 켜졌는지**. 순수 함수 — 시험이 걷는다.
+ *
+ * ⚠ 위 `cfg` 와 **같은 우선순위**: 환경변수가 파일을 이긴다. 반대로 짰다가 실제 사고를
+ *   냈다(2026-08-12) — 오버라이드가 안 먹는 설정은 안전한 기본값이 아니라 함정이다.
+ */
+function autoPushFromText(text, env) {
+  const K = 'GENETICS_NO_AUTO_PUSH';
+  if (env && Object.prototype.hasOwnProperty.call(env, K)) return !env[K];
+  let v = '';
+  for (const line of String(text || '').split('\n')) {
+    const m = line.match(/^\s*([A-Z_]+)\s*=\s*(.*)\s*$/);
+    if (m && m[1] === K) v = m[2];
+  }
+  return !v;
+}
+
+/**
+ * **스위치를 매번 다시 읽는다.** 예전에는 시작할 때 한 번만 읽어서, 켠 사람이 같은
+ * 「꺼져 있습니다」를 다시 보고 「안 켜졌다」고 읽었다 — 2026-08-24 내가 그 함정에 빠졌다.
+ *
+ * 안내문으로 덮는 것보다 **켜면 켜지는 것**이 맞다. 파일은 200바이트 남짓이고 심박은
+ * 20초에 한 번이라 비용이 없다. 자격은 그대로 시작할 때 값을 쓴다 — 여기서 다시 읽는 것은
+ * **사람이 쥐는 스위치 하나**뿐이다.
+ */
+function autoPushOn() {
+  let text = '';
+  try { text = fs.readFileSync(ENV_FILE, 'utf8'); } catch { /* 없으면 env 로만 */ }
+  return autoPushFromText(text, process.env);
+}
 
 /*
  * ⚠⚠ **꺼져 있으면 말한다.** 전에는 `if (!AUTO_PUSH) return;` 한 줄로 조용히 빠졌다.
@@ -1550,26 +1649,21 @@ const AUTO_PUSH = !cfg.GENETICS_NO_AUTO_PUSH;
  * 이 저장소는 세포를 필수로 만들며 규칙을 세웠다: **「없으면 막지 말고 알려주면서 유도한다」.**
  * 같은 규칙이 여기에도 걸린다. 끄는 것은 사람의 선택이지만, **끈 줄 모르는 것은 선택이 아니다.**
  */
-let autoPushSaid = false;
+let autoPushSaid = null;   // 마지막으로 말한 상태 — 스위치가 바뀌면 다시 말한다
 function autoPushSilence() {
-  if (autoPushSaid) return;
-  autoPushSaid = true;
+  if (autoPushSaid === false) return;
+  autoPushSaid = false;
   // stdout 은 프로토콜이다 — 사람이 보는 자리(stderr)로만 말한다.
   process.stderr.write(
     'genetics: 대화 본문 자동 올리기가 꺼져 있다(GENETICS_NO_AUTO_PUSH). '
     + '이 기계의 세션은 서버에 안 쌓이고, 그래서 두뇌가 그 대화로 팀 기억을 못 굽는다.\n'
-    /*
-     * ⚠ **설정은 시작할 때 한 번만 읽는다**(위 `cfg`). 파일을 고쳐도 돌고 있는 이 프로세스는
-     *   옛 값을 든 채다 — 그래서 켠 사람이 같은 문장을 다시 보고 「안 켜졌다」고 읽는다.
-     *   실측 2026-08-24: 내가 그 함정에 빠졌다. 「끈 줄 모르는 것은 선택이 아니다」와 같은 이유로
-     *   **켠 줄 모르는 것도 선택이 아니다.**
-     */
-    + '  (설정을 방금 바꿨다면 이 창을 다시 열어야 반영된다 — 시작할 때 한 번만 읽는다.)\n');
+    // 스위치는 심박마다 다시 읽는다 — 켜면 다음 심박(20초)에 스스로 켜진다.
+    + '  (지금 켜면 다음 심박에 스스로 반영된다 — 창을 다시 열 필요 없다.)\n');
 }
 const autoPushAt = new Map();
 
 async function autoPushIfAhead(reply, recs) {
-  if (!AUTO_PUSH) { autoPushSilence(); return; }
+  if (!autoPushOn()) { autoPushSilence(); return; }
   if (!reply) return;
   const now = Date.now();
   for (const v of reply) {
@@ -1606,7 +1700,7 @@ async function beatTick() {
   beatRunning = true;
   try {
     // 새 세션을 같은 폴더의 앞 세션과 같은 소속처로 등록한다(색인만 — 올리기는 아래가 한다).
-    if (AUTO_PUSH) { try { indexAdoptCurrent(); } catch { /* 등록 실패가 심박을 멈추면 안 된다 */ } }
+    if (autoPushOn()) { try { indexAdoptCurrent(); } catch { /* 등록 실패가 심박을 멈추면 안 된다 */ } }
     const recs = beatTargets();
     if (!recs.length) return;
     // **안 바뀌었으면 안 보낸다.** 이 설계가 실제로 버는 것은 바이트가 아니라 이것이다.
@@ -1616,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;
   }
@@ -2244,7 +2340,99 @@ 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 = Date.parse(String(ev?.at || '')) || 0;
+  return at > 0 && now - at <= BRAIN_FRESH_MS;
+}
+
+/**
+ * 큐에 쌓인 모순을 **한 번씩만** 말한다.
+ *
+ * ⚠ **지시를 안 붙인다.** 실측 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;
   /*
@@ -2365,11 +2553,11 @@ async function callTool(name, args = {}) {
        * 지식에 없지」를 사람이 짐작해야 한다(2026-08-23 실측: 하루가 통째로 비었다).
        * **사실만 적는다** — 켜라고 하지 않는다. 끄는 것은 사람의 선택이다.
        */
-        const pushOff = AUTO_PUSH ? '' :
+        const pushOff = autoPushOn() ? '' :
     '\n대화 본문 자동 올리기는 꺼져 있습니다(GENETICS_NO_AUTO_PUSH) — '
     + '이 기계의 세션은 서버에 안 쌓이고, 두뇌가 그 대화로 팀 기억을 굽지 않습니다.'
-    // ⚠ 설정은 **시작할 때 한 번** 읽는다. 방금 켠 사람이 이 문장을 또 보고 「안 켜졌다」고 읽는다.
-    + '\n  (방금 설정을 바꿨다면 이 창을 다시 열어야 반영됩니다 — 시작할 때 한 번만 읽습니다.)';
+    // 스위치는 심박마다 다시 읽는다 — 창을 다시 열 필요가 없다.
+    + '\n  (지금 켜시면 다음 심박에 스스로 반영됩니다 — 창을 다시 열 필요 없습니다.)';
       return `${me.user.name}(${me.user.email}) · ${me.user.role} 으로 붙어 있습니다.\n`
         + `기계: ${me.device_label || '(이름 없음)'} · 만료 ${c.expires_at}${alsoKey}${pushOff}`;
     }
@@ -2588,7 +2776,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.0",
+  "version": "2.9.0",
   "description": "문서 포털 발행·세션 이식·사례 기억 MCP — 데이터를 주면 규격 문서가 나온다 (짝인 스킬 동봉)",
   "author": "주식회사 LIM (LIM Inc.)",
   "license": "SEE LICENSE IN LICENSE",