genetics-mcp 2.9.3 → 2.9.4

package/genetics.mjs

@@ -2269,6 +2269,25 @@ const TOOLS = [
       required: ['tenant', 'path', 'verdict'],
     },
   },
+  {
+    name: 'review_verdict',
+    description:
+      '**두뇌가 보낸 검토(백신 메일: 「충돌 — …」「중복 — …」「문서 필요 — …」)에 대한 이 세션의 판정을 적는다** — '
+      + '「그 지적대로 고쳤다(applied) / 그 지적이 틀렸다(refuted)」. 그 메일을 읽고 실제로 고쳤거나 근거를 보고 틀렸다고 '
+      + '확인했을 때만 부른다. 이것은 세션 판정이라 **이 세션에게 같은 검토를 다시 놓지 않는 데만** 쓰이고, 두뇌의 '
+      + '학습(굽기)에는 사람이 지식 화면에서 닫은 판정만 실린다. title 은 메일 제목의 「— 」 뒤를 그대로.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        tenant: { type: 'string', description: '대상 소속처 이름.' },
+        title: { type: 'string', description: '검토 제목 — 메일 제목 「충돌 — <제목>」의 <제목> 그대로.' },
+        verdict: { type: 'string', enum: ['applied', 'refuted'], description: '이 세션의 판정.' },
+        type: { type: 'string', enum: ['contradiction', 'duplicate', 'missing-page'], description: '검토 종류(선택 — 충돌=contradiction·중복=duplicate·문서 필요=missing-page). 비우면 서버가 셋 중 있는 것을 고른다.' },
+        note: { type: 'string', description: '한 줄 근거(선택, 200자).' },
+      },
+      required: ['tenant', 'title', 'verdict'],
+    },
+  },
   {
     name: 'list_sessions',
     description:
@@ -2781,8 +2800,8 @@ function brainSays() {
 const MAIL_POLL_MS = 60_000;   // 사람이 기다린다 — 백신(120초)보다 자주 본다
 const MAIL_PAGE    = 20;
 let mailAt = 0;
-let mailCursor = null;         // null = 아직 색인에서 안 읽었다
-let mailAddrAt = 0;            // 마지막으로 주소를 댄 때
+const mailCursors = new Map();   // tenant → 마지막 커서 (소속처마다 따로 — 한 세션이 여러 곳에 주소를 댄다)
+const mailAddrAt  = new Map();   // tenant → 마지막으로 주소를 댄 때
 const mailQueue = [];          // 아직 안 말한 통(서버가 렌더한 글자를 그대로 싣는다)
 const mailBack  = [];          // 내가 부쳤다 만료된 것
 const mailBackSeen = new Set();
@@ -2877,17 +2896,26 @@ function myAgentName() {
  *   0f 의 답장이 꼬리에 영영 안 실렸다. 색인이 없으면 mail 도구가 마지막으로 쓴 소속처를
  *   힌트로 쓴다(그 소속처에 주소를 댔으니 받을 곳도 거기다).
  */
-let mailTenantHint = null;   // { tenant, tenant_id } — mail 도구가 성공할 때 적는다
+/*
+ * ⚠⚠ **받기는 「주소를 댄 소속처 전부」를 돈다** (2026-08-25 app-4a 실측 — 0a8c9d3 의 남은 구멍).
+ *   0a8c9d3 은 힌트를 「색인이 비었을 때」의 폴백으로만 뒀다. 그런데 색인에 **다른** 소속처가
+ *   박힌 세션(app-4a: 색인=앳플리, mail 도구=Lim 데모)은 힌트가 영영 안 먹고, 폴은 색인 쪽만
+ *   봐서 **보낸 곳과 받는 곳이 갈렸다** — 「보낼 수 있는데 받지 못한다」의 두 번째 갈래.
+ *   게다가 mailPull 이 소속처 하나만 조회했다(한 세션이 여러 곳에 주소를 댈 수 있는데).
+ *   처방: 색인의 소속처 ∪ 이 프로세스에서 mail 도구가 성공한 소속처 전부를 **매 바퀴 다** 돈다.
+ *   폴백이 아니라 합집합이다 — 우선순위를 두면 언젠가 또 한쪽이 조용히 진다.
+ */
+const mailTenants = new Map();   // tenant 이름 → tenant_id(모르면 0). mail 도구가 성공할 때 적는다
 function mailReady() {
   const mine = process.env.CLAUDE_CODE_SESSION_ID || '';
   if (!mine) return null;
-  let e = indexRead()[mine];
-  if (!e?.tenant && mailTenantHint) e = { ...(e || {}), ...mailTenantHint };
-  if (!e?.tenant) return null;                       // 아직 어느 소속처인지 모른다 — 받기엔 이름이면 족하다
   const cred = credential();
-  // 세계 장부와 같다 — 서버가 사람 토큰만 받는다.
-  if (!cred || cred.kind !== 'user') return null;
-  return { mine, e };
+  if (!cred || cred.kind !== 'user') return null;    // 세계 장부와 같다 — 서버가 사람 토큰만 받는다
+  const e = indexRead()[mine];
+  const set = new Map(mailTenants);
+  if (e?.tenant && !set.has(e.tenant)) set.set(e.tenant, Number(e.tenant_id) || 0);
+  if (!set.size) return null;                        // 아직 어느 소속처에도 주소를 안 댔다
+  return { mine, tenants: set, indexTenant: e?.tenant || '' , indexEntry: e };
 }
 
 /**
@@ -2896,10 +2924,10 @@ function mailReady() {
  * 이름이 없어도 등록한다 — 받을 수는 있어야 하기 때문이다. 이름이 생기면 다시 댄다.
  */
 async function mailRegister(tenant, mine, force = false) {
-  if (!force && Date.now() - mailAddrAt < MAIL_POLL_MS) return;
-  mailAddrAt = Date.now();
+  if (!force && Date.now() - (mailAddrAt.get(tenant) || 0) < MAIL_POLL_MS) return null;
+  mailAddrAt.set(tenant, Date.now());
   const name = myAgentName();
-  await api('POST', '/api/mail/register', {
+  return await api('POST', '/api/mail/register', {
     tenant,
     session: mine,
     name: name || '',
@@ -2918,32 +2946,42 @@ async function mailRegister(tenant, mine, force = false) {
 async function mailPull() {
   const r0 = mailReady();
   if (!r0) return;
-  const { mine, e } = r0;
+  const { mine, tenants, indexTenant, indexEntry } = r0;
   if (Date.now() - mailAt < MAIL_POLL_MS) return;
   mailAt = Date.now();
 
-  try { await mailRegister(e.tenant, mine); } catch { /* 등록 실패가 받기를 막지 않는다 */ }
+  for (const [tenant] of tenants) {
+    try { await mailPullOne(tenant, mine, tenant === indexTenant ? indexEntry : null); }
+    catch { /* 한 소속처가 막혀도 나머지는 돈다 — 다음 바퀴에 다시 */ }
+  }
+}
+
+/** 한 소속처의 내 편지함을 긷고 **받았다고 도장을 찍는다**(도장은 큐에 넣기 **전에** — 재점화 방지). */
+async function mailPullOne(tenant, mine, indexEntry) {
+  try { await mailRegister(tenant, mine); } catch { /* 등록 실패가 받기를 막지 않는다 */ }
 
-  if (mailCursor === null) mailCursor = Number(e.mail_cursor || 0);
+  if (!mailCursors.has(tenant)) mailCursors.set(tenant, Number(indexEntry?.mail_cursor || 0));
+  let cursor = mailCursors.get(tenant);
   /*
    * ⚠ **자리(`cwd`)를 안 보낸다.** 창구가 그것으로 거르던 동안 주소 있는 메일이 조용히
    *   사라졌다(실측 2026-08-25: cwd 없이 1통 · cwd 있게 0통). 메일은 폴더가 아니라
    *   세션에 부친 것이라 **주소가 이미 필터**다.
    */
-  const q = '?tenant=' + encodeURIComponent(e.tenant)
-    + '&since=' + mailCursor
+  const q = '?tenant=' + encodeURIComponent(tenant)
+    + '&since=' + cursor
     + '&session=' + encodeURIComponent(mine)
     + '&limit=' + MAIL_PAGE;
   const r = await api('GET', '/api/mail' + q);
 
   const rows = Array.isArray(r?.mail) ? r.mail : [];
-  if (typeof r?.cursor === 'number' && r.cursor > mailCursor) mailCursor = r.cursor;
-  indexNote(mine, { tenant: e.tenant, tenant_id: e.tenant_id, mail_cursor: mailCursor });
+  if (typeof r?.cursor === 'number' && r.cursor > cursor) { cursor = r.cursor; mailCursors.set(tenant, cursor); }
+  // 색인에는 색인의 소속처 것만 적는다(다른 곳의 커서는 프로세스 안에서만 — 잃어도 ack 가 중복을 막는다).
+  if (indexEntry?.tenant_id) indexNote(mine, { tenant, tenant_id: indexEntry.tenant_id, mail_cursor: cursor });
 
   if (rows.length) {
     const ids = rows.map((m) => Number(m.id)).filter((n) => n > 0);
     if (ids.length) {
-      try { await api('POST', '/api/mail/ack', { tenant: e.tenant, ids }); }
+      try { await api('POST', '/api/mail/ack', { tenant, ids }); }
       catch { /* 도장을 못 찍어도 말은 한다 — 못 찍은 것은 다음 바퀴에 또 온다 */ }
     }
     /*
@@ -3392,6 +3430,14 @@ async function callTool(name, args = {}) {
       return `${r.says || '판정을 적었다.'}\n`
         + '(세션이 중계한 판정이다 — 사람이 지식 화면에서 누른 판정만 도구 직전 알림·검색에 반영된다.)';
     }
+    case 'review_verdict': {
+      const r = await api('POST', '/api/wiki/review_verdict?tenant=' + encodeURIComponent(args.tenant), {
+        title: args.title, verdict: args.verdict, type: args.type || '', note: args.note || '',
+        ...myCitation(),                      // 세션 uuid 는 우리가 채운다 — 없으면 서버가 안 적는다
+      });
+      return `${r.says || '판정을 적었다.'}\n`
+        + '(세션 판정이다 — 이 세션에게 같은 검토를 다시 놓지 않는 데만 쓰인다. 두뇌의 기억에는 사람이 화면에서 닫은 판정만 실린다.)';
+    }
     case 'list_sessions': {
       const query = new URLSearchParams({ tenant: String(args.tenant) });
       if (args.page !== undefined) query.set('page', String(args.page));
@@ -3574,8 +3620,19 @@ async function callTool(name, args = {}) {
              + '이름은 `ListAgents` 를 한 번 부르면 생긴다 — 하네스가 「This session is …」를 '
              + '전사에 적고, 이 도구가 그것을 읽는다. 부른 뒤 다시 보내면 된다.';
       }
-      try { await mailRegister(args.tenant, mine, true); }
+      let reg;
+      try { reg = await mailRegister(args.tenant, mine, true); }
       catch (e) { return `주소를 대지 못했다 — ${e.message}`; }
+      /*
+       * ⚠ 이름을 **남이 쥐고 있으면** 보내기가 409(이름 없음)로 막힌다 — 서버 오류문만 보면
+       *   무엇을 해야 하는지 모른다. 창구가 준 사실(held_by)을 여기서 사람 말로 앞세운다.
+       *   (하네스가 짧은 이름을 재사용한다 — 2026-08-25 운영 실측, app-4a 둘.)
+       */
+      if (reg?.held_by) {
+        return `이 세션의 이름을 살아 있는 다른 세션(${String(reg.held_by).slice(0, 8)})이 쥐고 있어 이름 없이 등록됐다 — `
+             + '이름 없는 주소로는 보낼 수 없다. 그 세션이 닫히면(5분 조용) 이름이 돌아온다. '
+             + `그때까지 이 세션에 닿으려면 uuid(${mine})를 쓰면 된다.`;
+      }
 
       const r = await api('POST', '/api/mail', {
         tenant:    args.tenant,
@@ -3592,8 +3649,8 @@ async function callTool(name, args = {}) {
       // ★ 받을 곳을 기억한다 — 색인 밖 세션도 이 소속처에서 받는다(mailReady 힌트 + 색인).
       // ⚠ 서버가 tenant_id 를 아직 안 주는 판(재배포 전)이어도 **받기는 이름만으로 된다** —
       //   GET /api/mail 은 tenant 이름으로 묻는다. 색인(indexNote)만 id 가 있어야 적힌다.
-      mailTenantHint = { tenant: args.tenant, tenant_id: r?.tenant_id || 0 };
-      if (r?.tenant_id) indexNote(mine, { tenant: args.tenant, tenant_id: r.tenant_id });
+      mailTenants.set(args.tenant, r?.tenant_id || 0);   // 이 소속처에서도 받는다 — 합집합, 폴백 아님
+      if (r?.tenant_id && !indexRead()[mine]?.tenant) indexNote(mine, { tenant: args.tenant, tenant_id: r.tenant_id });
       return `«${r.to}» 앞으로 보냈다 — 실 ${r.thread} · ${r.turn}번째.\n`
         + `받는 쪽이 보게 될 글자는 이것이다:\n${r.preview}\n`
         + (r.says ? `${r.says}\n` : '')

package/package.json

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

package/skills/genetics-cell-id/SKILL.md

@@ -157,9 +157,22 @@ mail({tenant: "<소속처>", to: "brain", body: "…"})       # 기계를 넘어
 
 받은 것에 답할 때 `SendMessage` 는 그 메시지의 `from` 을 그대로 `to` 에 쓰고, `mail` 은 `thread` 를 씁니다.
 
-`mail` 의 `to` 에 올 수 있는 것은 **셋뿐**입니다 — `gcell agents` 나 `world` 가 아는 **세포 이름**,
-**세션 uuid**, 또는 두뇌를 뜻하는 **`brain`**. **지어내지 마세요.** 셋 중 하나가 아니면 사용자에게
-묻습니다. 소속처 이름을 모르면 `list_my_tenants` 로 먼저 확인합니다.
+`mail` 의 `to` 에 올 수 있는 것은 **셋뿐**입니다. **지어내지 마세요** — 셋 중 하나가 아니면
+사용자에게 묻습니다. 소속처 이름을 모르면 `list_my_tenants` 로 먼저 확인합니다.
+
+| `to` | 언제 쓰나 |
+|---|---|
+| **세션 uuid** | **확실히 닿아야 할 때.** 하네스가 재사용하지 않는 유일한 열쇠입니다 |
+| 세포 이름 (`app-2f`) | 이 기계 안에서 사람이 부를 때. **불안정한 별칭입니다 — 아래** |
+| `brain` | 두뇌에게. 주소가 필요 없습니다 |
+
+**이름은 유일하지 않습니다.** 하네스가 짧은 이름을 프로젝트·시간을 넘어 재사용하므로 **같은
+이름을 쥔 산 세션이 따로 있을 수 있습니다.** 그러면 나중에 등록하는 쪽은 이름 없이(받기만) 서고,
+그 이름으로 부친 통은 **먼저 쥔 쪽에게 갑니다.**
+
+2026-08-25 실측 — 이름 접미가 2자리 16진(256가지)인데 한 기계에 세션 13개가 돌아
+충돌 확률이 **26.6%** 입니다. 실제로 났습니다: 이름으로 부친 통(실 `bc3b4f59`)은 39초 만에
+**동명이인에게** 배달됐고, uuid 로 부친 통(실 `9003652b`)은 47초 만에 제자리에 닿았습니다.
 
 받는 것은 부를 필요가 없습니다 — 온 것은 **다른 도구를 부를 때 응답 꼬리에 저절로 실립니다.**
 
@@ -193,6 +206,8 @@ mail({tenant: "<소속처>", to: "brain", body: "…"})       # 기계를 넘어
 | 세포는 이 기계만 본다 | 다른 기계를 **보는** 것은 `world`, **말 거는** 것은 `mail` |
 | `SendMessage` 로 다른 기계에 보냈다 | **안 간다.** 그건 이 기계 전용이다 — `mail` 을 쓴다 |
 | 왕복이 길어진다 | 상한이 있다 — **사람이 낀 실 5회, 기계끼리 3회.** 넘으면 사람에게 올라간다 |
+| 이름으로 부쳤는데 딴 세션이 받았다 | 같은 이름의 **산 세션**이 있다. 이름은 별칭이니 **uuid** 로 부친다 |
+| 보냈는데 답이 없다 | 받는 쪽 꼬리는 **그쪽이 도구를 불러야** 붙는다 — 폴 60초 + 그 간격이다(실측 47·39초) |
 | `status` 에 내 줄이 표시되지 않는다 | 내 uuid 는 전사 파일 이름에서 얻는다 |
 
 ## 무엇을 하지 않는가