genetics-mcp 2.7.0 → 2.8.0

package/genetics.mjs

@@ -929,8 +929,32 @@ function scrubTranscript(raw) {
     if (typeof c === 'string') {
       const [t, n] = maskSecrets(c); r.message.content = t; redacted += n;
     } else if (Array.isArray(c)) {
-      for (const b of c) {
+      for (let i = 0; i < c.length; i++) {
+        const b = c[i];
         if (!b || typeof b !== 'object') continue;
+        /*
+         * ★ **첨부 본문은 안 올린다.** 도구 설명이 이미 그렇게 약속한다("올라가지 않는 것:
+         * 도구 실행 결과·첨부"). 그런데 여기서 걷지 않아 `document`·`image` 의 base64 가
+         * 통째로 나갔다 — 그리고 그 한 줄이 서버의 줄 길이 검사에 걸려 **대화 전체가 막혔다.**
+         *
+         * 실측(2026-08-24): 376쪽 PDF 한 장이 line 628 에 7,782,947B.
+         * 81MB · 3,602줄 대화에서 상한을 넘는 줄은 **그 하나뿐**이었고, 나머지 1MB 초과 17줄은
+         * 전부 tool_result·image 라 어차피 가려졌다. 즉 첨부만 걷으면 통과한다.
+         *
+         * **자리는 남긴다.** 블록을 지우면 무엇이 오갔는지 대화에서 사라지고, 이어받은 사람은
+         * 「PDF를 참고하라」는 말만 보고 그 PDF 가 있었다는 사실을 모른다.
+         * `data` 만 비우지 않고 text 로 바꾸는 이유: 빈 base64 는 이어받을 때 렌더가 깨진다.
+         */
+        if ((b.type === 'document' || b.type === 'image') && b.source && typeof b.source === 'object') {
+          const bytes = Buffer.byteLength(String(b.source.data || ''), 'utf8');
+          const 무엇 = b.type === 'document' ? '문서' : '그림';
+          const 이름 = b.title ? ` 「${b.title}」` : '';
+          const 종류 = b.source.media_type ? ` ${b.source.media_type}` : '';
+          const 크기 = bytes >= 1048576 ? `${(bytes / 1048576).toFixed(1)}MB` : `${Math.round(bytes / 1024)}KB`;
+          c[i] = { type: 'text', text: `[가림: ${무엇} 첨부${이름}${종류} ${크기} — 서버에 올리며 뺐습니다]` };
+          redacted++;
+          continue;
+        }
         if (b.type === 'tool_result') { b.content = MASK; redacted++; }        // 짝은 남긴다
         else if (b.type === 'tool_use' && b.input !== undefined) {
           const [t, n] = maskSecrets(JSON.stringify(b.input));
@@ -1322,6 +1346,68 @@ function myCitation() {
   return { session_uuid: uuid, head_id: head.id };
 }
 
+/**
+ * **같은 폴더의 직전 세션과 같은 소속처로 고른다.** 순수 함수 — 시험이 걷는다.
+ *
+ * ── 왜 있나 ───────────────────────────────────────────────────────────────
+ * 자동 올리기는 **색인에 있는 세션만** 본다(`beatTargets`). 그런데 색인에 넣는 길은
+ * 전부 사람이 부른 도구 안이다(`pushSession`·`list_sessions`·`resume`·`pull`).
+ * 그래서 **새로 시작한 세션은 색인 밖**이고, 한 번은 손으로 올려야 등록된다 —
+ * 잊으면 그날 것이 통째로 안 간다(실측: 하루가 비었던 적이 있다, `8e14066`).
+ *
+ * 기계가 소속처를 못 고르는 것이 걸림돌이었다(이 기계에 소속처가 5곳). 규칙을 정했다
+ * (사용자 결정 2026-08-24): **같은 작업 폴더의 세션과 같은 소속처.** 표를 안 만들고,
+ * 같은 폴더면 같은 일이라 잘못 갈 위험이 낮다.
+ *
+ * ⚠ **섞여 있으면 안 고른다.** 한 폴더에 두 소속처가 있으면 추측이 되고, 추측으로
+ *   남의 고객사에 대화가 올라가면 되돌릴 수 없다. 실측 2026-08-24: 폴더 6곳 중 5곳이
+ *   소속처 하나로 깨끗했고, 섞인 1곳은 **전사 사본이 없는 것들**이라 폴더가 없었다.
+ *
+ * @param  string $myDir  지금 세션 전사가 사는 폴더
+ * @param  array  rows    `[{dir, tenant, tenant_id}]` — 색인된 세션들
+ * @return null|{tenant,tenant_id}|{ambiguous:number}
+ */
+function adoptTenantOf(myDir, rows) {
+  if (!myDir) return null;
+  const same = (rows || []).filter((r) => r && r.dir === myDir && r.tenant_id);
+  if (!same.length) return null;
+  const ids = [...new Set(same.map((r) => String(r.tenant_id)))];
+  if (ids.length > 1) return { ambiguous: ids.length };
+  return { tenant: same[0].tenant, tenant_id: same[0].tenant_id };
+}
+
+let adoptSaid = false;
+/** 위 규칙을 이 기계에 적용한다 — 색인에 한 줄을 더할 뿐, **올리지는 않는다.** */
+function indexAdoptCurrent() {
+  const mine = process.env.CLAUDE_CODE_SESSION_ID || '';
+  if (!mine) return;
+  const idx = indexRead();
+  if (idx[mine]?.tenant_id) return;               // 이미 등록돼 있다
+  const f = transcriptOf(mine);
+  if (!f) return;                                  // 이 기계에 사본이 없다
+  const myDir = path.dirname(f);
+  const rows = [];
+  for (const [u, e] of Object.entries(idx)) {
+    if (!e?.tenant_id) continue;
+    const p = transcriptOf(u);
+    if (p) rows.push({ dir: path.dirname(p), tenant: e.tenant, tenant_id: e.tenant_id });
+  }
+  const pick = adoptTenantOf(myDir, rows);
+  if (!pick) return;
+  if (pick.ambiguous) {
+    // **조용히 넘기지 않는다** — 왜 안 올라가는지 사람이 알아야 한다.
+    if (!adoptSaid) {
+      adoptSaid = true;
+      process.stderr.write('genetics: 이 폴더에 소속처가 ' + pick.ambiguous
+        + '곳 섞여 있어 자동 등록을 안 한다 — 한 번 `push_session` 으로 정해 주면 그 뒤는 자동이다.\n');
+    }
+    return;
+  }
+  indexNote(mine, { tenant: pick.tenant, tenant_id: pick.tenant_id, head_id: '', head_ms: 0 });
+  process.stderr.write('genetics: 이 세션을 «' + pick.tenant
+    + '» 로 등록했다 — 같은 폴더의 앞 세션과 같은 곳이다. 이제 자동으로 올라간다.\n');
+}
+
 function beatTargets() {
   const idx = indexRead();
   const mine = process.env.CLAUDE_CODE_SESSION_ID || '';
@@ -1452,10 +1538,39 @@ function beatWell() {
  * 끄는 길을 함께 둔다(`GENETICS_NO_AUTO_PUSH=1`). 이 값은 「내부 대화가 서버에 쌓인다」를
  * 뜻하므로, 끄는 길이 없으면 결정이 아니라 함정이 된다. */
 const AUTO_PUSH = !cfg.GENETICS_NO_AUTO_PUSH;
+
+/*
+ * ⚠⚠ **꺼져 있으면 말한다.** 전에는 `if (!AUTO_PUSH) return;` 한 줄로 조용히 빠졌다.
+ *
+ * 그 침묵의 값을 2026-08-23 에 쟀다: 이 기계의 세션이 **하루 넘게**(8-21 14:20, 6,094줄에서
+ * 멈춤 — 로컬은 10,476줄) 서버에 안 올라갔고, 본문이 없으니 두뇌가 위키를 못 굽고,
+ * 그래서 그날 배운 것이 팀 기억에 **한 장도** 안 남았다. 아무도 그 사실을 몰랐다 —
+ * 파고들어야 보였다.
+ *
+ * 이 저장소는 세포를 필수로 만들며 규칙을 세웠다: **「없으면 막지 말고 알려주면서 유도한다」.**
+ * 같은 규칙이 여기에도 걸린다. 끄는 것은 사람의 선택이지만, **끈 줄 모르는 것은 선택이 아니다.**
+ */
+let autoPushSaid = false;
+function autoPushSilence() {
+  if (autoPushSaid) return;
+  autoPushSaid = true;
+  // stdout 은 프로토콜이다 — 사람이 보는 자리(stderr)로만 말한다.
+  process.stderr.write(
+    'genetics: 대화 본문 자동 올리기가 꺼져 있다(GENETICS_NO_AUTO_PUSH). '
+    + '이 기계의 세션은 서버에 안 쌓이고, 그래서 두뇌가 그 대화로 팀 기억을 못 굽는다.\n'
+    /*
+     * ⚠ **설정은 시작할 때 한 번만 읽는다**(위 `cfg`). 파일을 고쳐도 돌고 있는 이 프로세스는
+     *   옛 값을 든 채다 — 그래서 켠 사람이 같은 문장을 다시 보고 「안 켜졌다」고 읽는다.
+     *   실측 2026-08-24: 내가 그 함정에 빠졌다. 「끈 줄 모르는 것은 선택이 아니다」와 같은 이유로
+     *   **켠 줄 모르는 것도 선택이 아니다.**
+     */
+    + '  (설정을 방금 바꿨다면 이 창을 다시 열어야 반영된다 — 시작할 때 한 번만 읽는다.)\n');
+}
 const autoPushAt = new Map();
 
 async function autoPushIfAhead(reply, recs) {
-  if (!AUTO_PUSH || !reply) return;
+  if (!AUTO_PUSH) { autoPushSilence(); return; }
+  if (!reply) return;
   const now = Date.now();
   for (const v of reply) {
     if (v.verdict !== BEAT_VERDICT.AHEAD || !(v.flags & BEAT_WANT_PUSH)) continue;
@@ -1490,6 +1605,8 @@ async function beatTick() {
   if (beatRunning) return;
   beatRunning = true;
   try {
+    // 새 세션을 같은 폴더의 앞 세션과 같은 소속처로 등록한다(색인만 — 올리기는 아래가 한다).
+    if (AUTO_PUSH) { try { indexAdoptCurrent(); } catch { /* 등록 실패가 심박을 멈추면 안 된다 */ } }
     const recs = beatTargets();
     if (!recs.length) return;
     // **안 바뀌었으면 안 보낸다.** 이 설계가 실제로 버는 것은 바이트가 아니라 이것이다.
@@ -2144,7 +2261,41 @@ function deviceLabel() {
   try { return `${os.userInfo().username}@${os.hostname()}`; } catch { return os.hostname(); }
 }
 
+/**
+ * **필수 인자를 여기서 막는다.** 스키마에 `required` 를 적어 두고 아무도 안 봤다.
+ *
+ * ── 왜 있나 ───────────────────────────────────────────────────────────────
+ * 2026-08-23 실측: `search_cases` 를 `q` 대신 `query` 로 불렀더니 오류가 아니라
+ * **`args.q` 가 `undefined`** 가 되었고, 그것이 `encodeURIComponent(undefined)` 를 지나
+ * `?q=undefined` 로 나갔다. 서버는 「빈 문자열인가」만 보므로 통과시켰고, 문자열
+ * `"undefined"` 로 위키를 검색해 **아무 질의에나 똑같은 한 건**(점수 429)을 돌려줬다.
+ * 부르는 쪽은 그것이 답인 줄 알았다 — 팀 기억 335장이 안 닿는 채로.
+ *
+ * **조용한 실패다.** 없는 인자는 없다고 말해야 한다. 그리고 한 도구가 아니라
+ * **모든 도구**가 같은 병이었으므로 여기 한 곳에서 막는다.
+ */
+function requireArgs(name, args) {
+  const spec = TOOLS.find((t) => t.name === name);
+  const need = spec?.inputSchema?.required;
+  if (!Array.isArray(need)) return;
+  const props = spec.inputSchema.properties || {};
+  const miss = need.filter((k) => args[k] === undefined || args[k] === null || args[k] === '');
+  if (!miss.length) return;
+  // ⚠ **비슷한 이름을 함께 말한다** — 「q 가 없다」만 보면 `query` 를 준 쪽은 못 알아챈다.
+  const given = Object.keys(args);
+  const hint = miss
+    .map((k) => {
+      const near = given.filter((g) => g !== k && (g.includes(k) || k.includes(g)));
+      return near.length ? `${k}(준 것: ${near.join('·')})` : k;
+    })
+    .join(', ');
+  const all = Object.keys(props).join(' · ');
+  throw new Error(`\`${name}\` 에 필수 인자가 없습니다: ${hint}\n`
+    + `받는 이름은 이것뿐입니다 — ${all}`);
+}
+
 async function callTool(name, args = {}) {
+  requireArgs(name, args);
   switch (name) {
     case 'login': {
       /*
@@ -2208,8 +2359,19 @@ async function callTool(name, args = {}) {
         ? '\n(키도 있습니다 — **발행 다섯만** 키로 나가고 나머지는 이 신원으로 갑니다.)'
         : '';
       const me = await api('GET', '/api/me');
+      /*
+       * ⚠ **꺼진 것을 말한다.** 자동 올리기가 꺼져 있으면 이 기계의 대화는 서버에 안 쌓이고,
+       * 그러면 두뇌가 그 대화로 팀 기억을 못 굽는다. 아무도 안 말하면 「왜 어제 배운 게
+       * 지식에 없지」를 사람이 짐작해야 한다(2026-08-23 실측: 하루가 통째로 비었다).
+       * **사실만 적는다** — 켜라고 하지 않는다. 끄는 것은 사람의 선택이다.
+       */
+        const pushOff = AUTO_PUSH ? '' :
+    '\n대화 본문 자동 올리기는 꺼져 있습니다(GENETICS_NO_AUTO_PUSH) — '
+    + '이 기계의 세션은 서버에 안 쌓이고, 두뇌가 그 대화로 팀 기억을 굽지 않습니다.'
+    // ⚠ 설정은 **시작할 때 한 번** 읽는다. 방금 켠 사람이 이 문장을 또 보고 「안 켜졌다」고 읽는다.
+    + '\n  (방금 설정을 바꿨다면 이 창을 다시 열어야 반영됩니다 — 시작할 때 한 번만 읽습니다.)';
       return `${me.user.name}(${me.user.email}) · ${me.user.role} 으로 붙어 있습니다.\n`
-        + `기계: ${me.device_label || '(이름 없음)'} · 만료 ${c.expires_at}${alsoKey}`;
+        + `기계: ${me.device_label || '(이름 없음)'} · 만료 ${c.expires_at}${alsoKey}${pushOff}`;
     }
 
     case 'list_my_tenants': {
@@ -2905,4 +3067,5 @@ if (IS_MAIN) {
 }
 
 // 시험용 — 서버 동작에는 쓰이지 않는다. materializeAssets 만 네트워크를 쓴다.
-export { encodeAsset, imageDims, imageHostAllowed, materializeAssets, warnText, IMAGE_HOST_ALLOW, HOST_ALLOW };
+export { encodeAsset, imageDims, imageHostAllowed, materializeAssets, warnText, IMAGE_HOST_ALLOW, HOST_ALLOW,
+         scrubTranscript, splitAtLines, PUSH_PART_MAX };

package/package.json

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

package/skills/genetics-report/assets/render.py

@@ -97,7 +97,7 @@ def templates_from_server(repo: pathlib.Path) -> dict:
         sys.exit('REPORT_TEMPLATES 를 못 읽었습니다 — report_publish.php 모양이 바뀌었습니다.')
     body = block.group(1)
     out = {}
-    for name in re.findall(r"'([a-z-]+)'\s*=>", body):
+    for name in re.findall(r"^\s{4}'([a-z0-9-]+)'\s*=>", body, re.M):
         out[name] = None
     if 'lim-report' not in out:
         sys.exit("서버에 'lim-report' 서식이 없습니다.")