genetics-mcp 2.17.1 → 2.18.1

package/bin/manifest.json

@@ -1,6 +1,6 @@
 {
-  "aarch64-apple-darwin": "1e93db10afd8d6125508d20af650c290c6967f19ac4e24543dae2a42ced1fb7f",
+  "aarch64-apple-darwin": "2589e4eda175ae7f1158a3dd4b31b327fd8af85ea82bbb661fac7990567286af",
   "aarch64-unknown-linux-musl": "aa25f20daefda931d8497d346bd47fb9b8a2acc3136ec2b9eeff18773a789e8c",
-  "x86_64-apple-darwin": "84b539085af2ad89018296d54fe0a89ec932cae1ee0b67a445684ddbb8dfb8fb",
+  "x86_64-apple-darwin": "4de0feadcb7fe644c8004b76e0015518ffb330c6f13304684fb85aa2c99caa30",
   "x86_64-unknown-linux-musl": "c97bcded75ec34cdb5a448159e7f057a756deb6a45fa7793b299d0040c19be93"
 }

package/genetics.mjs

@@ -448,6 +448,15 @@ const isSvg = (b) => {
  */
 const SHOT_QUALITY_LADDER = [82, 72, 62, 52];
 
+/** 무손실로 굳혔을 때의 크기만 잰다(바이트는 버림). cwebp 가 없거나 실패하면 null. */
+function losslessSize(buf) {
+  try {
+    if (isSvg(buf)) return null;
+    const r = spawnSync('cwebp', ['-quiet', '-lossless', '-exact', '-o', '-', '--', '-'], { input: buf, maxBuffer: IMAGE_MAX_DOWNLOAD });
+    return r.status === 0 ? r.stdout.length : null;
+  } catch { return null; }
+}
+
 function encodeShot(buf) {
   const d = imageDims(buf);
   const resize = (d && Math.max(d.w, d.h) > ASSET_LONG_EDGE)
@@ -526,6 +535,7 @@ function encodeAsset(buf, role, provider) {
  * 그리고 있었다(2026-08-16 실측). 선언을 안 받으면 그 결함이 구조적으로 안 생긴다.
  */
 async function materializeAssets(data) {
+  ASSET_HINTS = [];
   if (!data || !Array.isArray(data.assets) || !data.assets.length) return data;
   const out = [];
   for (const a of data.assets) {
@@ -552,6 +562,15 @@ async function materializeAssets(data) {
     // 원격보다 **로컬이 이긴다** — 손에 든 실물이 주소보다 확실하다.
     const raw = fpath ? readLocalImage(String(fpath)) : await fetchImage(String(a.source));
     const enc = encodeAsset(raw, String(a.role ?? ''), String(a.provider ?? ''));
+    // 평면 그림(HTML 개념도·도표)을 user-provided 로 올리면 손실 사다리가 선·글자를 뭉갠다(2026-09-09 앳플리 #173
+    // 그림 1-2 반려). 무손실이 손실보다 **작으면** 그 그림은 평면 그림이다 — 그때만 한 줄 알린다(계약은 안 바꾼다).
+    if (String(a.role) === 'figure' && String(a.provider) === 'user-provided') {
+      const ll = losslessSize(raw);
+      if (ll !== null && ll <= ASSET_MAX_ONE && ll <= enc.length) {
+        ASSET_HINTS.push(`도판 「${a.id}」: 무손실 ${ll.toLocaleString()}B 가 손실 ${enc.length.toLocaleString()}B 보다 작습니다 — `
+          + '평면 그림이면 provider: deterministic 으로(손실 사다리는 선·글자를 뭉갭니다). 사진에 가까운 화면 캡처면 그대로.');
+      }
+    }
     const d = imageDims(enc);
     out.push({
       ...meta,
@@ -872,6 +891,8 @@ const REPORT_DATA = {
                  + 'rows[].no 가 `4.1`·`04-1` 모양이면 그 사례로 링크가 된다. '
                  + '그림 번호(`그림 5-1`)는 적지 않는다 — 자리가 매기고 `plates` 와 한 셈을 쓴다.\n'
                  + '· `plates`: [assets[].id, …] — 절 본문 도판.\n'
+                 + '· 시각 우선(dry_run 이 ⚠ 로 센다 — 서식 문서 §10-1): 절마다 표·흐름도·차트·도판 중 하나, 문단 220자 안, 산문의 참조 번호 3개 이하, 판단 요청 6항 이상이면 한눈표+관문 흐름도, 3,000자 넘는 문서엔 핵심 굵게. 집필 공식(독자 한 명·예시 한 명·한 장 이야기·용어 잠금·그림 먼저)은 스킬 references/visual-first.md.\n'
+                 + '· 인라인 표기(본문 문자열 어디서나 — 문단·도입문·여백 주석·표 셀·흐름도 칸·주석·부록 행): `**굵게**` → 핵심 구절, `==강조==` → 놓치면 안 되는 한 구절(노란 밑면), `{{ok|보통}}` → 상태 칩(톤 ok·wait·bad·info·muted 다섯뿐, 글자 40자 안), `[글자](https://…)` → 새 창으로 여는 하이퍼링크, 맨 `https://…` 주소도 그대로 링크가 됨(http(s) 만, 꼬리 문장부호는 링크 밖). 표기가 없으면 한 글자도 안 바뀐다. 핵심 한두 구절에만 — 문단 절반이 굵으면 굵기가 위계를 못 나른다. 출처는 부록 글자에만 두지 말고 건의 `source_url` 에도 실어라(「출처 원문」 행이 된다).\n'
                  + '· `tables`: [{caption, cols[], rows[[]], align?, hint?, note?}] — **관보의 자료표.** '
                  + '여러 항목을 축으로 견주는 자리다. 불릿 목록에 수를 눌러 담고 있으면 그건 표여야 한다. '
                  + 'kind 와 무관하게 쓴다(kind:status 의 `board_title` 대조표와는 다른 것 — 저건 건 전용이다). '
@@ -886,6 +907,7 @@ const REPORT_DATA = {
                  + 'HTML 막대와 CSS 로 짓는다. 값은 **본문 글자로 남고** 막대는 그 옆에 서므로 막대가 안 보이는 '
                  + '곳에서도 문서가 성립한다. value 는 **표기 그대로 적는다**(`"118,716"`) — 콤마는 셈에서 걷어내므로 '
                  + '같은 문서의 표와 표기가 갈리지 않게 하려면 데이터가 표기를 정해야 한다. '
+                 + 'rows[].tone(ok·wait·bad·info·muted) 을 주면 그 행의 막대와 값에 뜻 색이 붙는다 — 예: 처리 완료 행은 muted, 위험 행은 bad. '
                  + 'toggle{a,b} 를 주면 rows 는 value 대신 a·b 를 갖고 두 축을 `:checked` 로 갈아 낀다 '
                  + '(체크박스는 스크립트가 아니라 상태다). 그림 번호는 `flow`·`plates` 와 **한 셈**을 쓴다.\n'
                  + '데이터가 있을 때만 그려진다 — 없는 문구를 지어내지 말 것.\n'
@@ -1028,6 +1050,13 @@ const REPORT_DATA = {
               + '이 축을 포털본이 통째로 버려 2차 출처와 미확인 주장이 **사실로 단언돼 나갔다.** '
               + '증거를 실으면서 등급을 안 붙이면 문서가 실제보다 확실해 보인다.',
           },
+          wide: {
+            type: 'boolean',
+            description: '**전폭 도판.** 두 단 그리드 밖, 절 끝에 문서 폭(약 1030px)으로 선다. '
+              + '나란히 둔 화면 둘처럼 본문 단(760px)에서 절반으로 줄면 글자가 안 읽히는 그림에 켠다. '
+              + '켜면 그 절의 그림 번호는 마지막이 된다. 켜든 말든 모든 도판은 눌러서 크게 보기(원본 '
+              + '긴 변 1400px)가 열린다. 집필 때 figure.mjs --display 로 표시 글자 크기를 먼저 재라(하한 14px).',
+          },
           brief: {
             type: 'string',
             description: '**무엇을 그릴지 — 장면 한두 문장.** 이것만 주면 서버가 그린다(그리는 동안 '
@@ -2535,7 +2564,9 @@ const TOOLS = [
       type: 'object',
       properties: {
         tenant: { type: 'string', description: '대상 소속처 slug(이름도 받는다 — list_my_tenants 참조).' },
-        title: { type: 'string', description: '한 줄 제목. 파일 이름이 된다(같은 제목이면 덮어쓴다).' },
+        title: { type: 'string', description: '한 줄 제목. 같은 경로가 있으면 expected_revision 없이는 저장되지 않는다.' },
+        expected_revision: { type: 'string', pattern: '^[a-f0-9]{64}$', description: '기존 사례 수정 시 get_case에서 읽은 revision. 신규 생성은 생략. 충돌하면 원문을 다시 읽고 변경을 재검토한다.' },
+        commit_id: { type: 'string', pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{15,79}$', description: '이 저장 작업의 고유 UUID. 첫 호출 전에 생성하고 응답 유실·재시도에는 같은 값과 같은 본문을 유지한다. 별도 수정은 새 값을 쓴다.' },
         symptom: { type: 'string', description: '겪은 현상. 원인이 아니라 **눈에 보인 것**을 그대로.' },
         cause: { type: 'string', description: '원인. 모르면 비운다 — 지어내지 않는다.' },
         fix: { type: 'string', description: '처방. 다시 만나면 그대로 하면 되는 동작.' },
@@ -2555,7 +2586,7 @@ const TOOLS = [
         } }, description: '사용자가 브라우저에서 **집은 요소**(iab 픽). 사용자가 "iab N" 이라 했으면 훅이 끼운 「#N <tag> · 경로:줄 · sel `…` · "글자"」 줄에서 selector·text·source 를 **그대로** 옮긴다 — 지어내지 않는다. '
           + '픽은 이 세션 밖으로 안 넘어가므로(다른 기계·다른 사람은 못 본다) 이 칸이 유일한 기록이다. 장에 「집은 자리」 절로 선다(최대 20, 칸당 300자).' },
       },
-      required: ['tenant', 'title', 'symptom', 'fix'],
+      required: ['tenant', 'title', 'symptom', 'fix', 'commit_id'],
     },
   },
   {
@@ -2577,7 +2608,9 @@ const TOOLS = [
       type: 'object',
       properties: {
         tenant: { type: 'string', description: '대상 소속처 slug(이름도 받는다 — list_my_tenants 참조).' },
-        title: { type: 'string', description: '한 줄 제목. 파일 이름이 된다. ⚠ 같은 제목이면 덮어쓴다 — **다른 결정이면 제목을 달리할 것**(서로 다른 결정은 합치지 않는다).' },
+        title: { type: 'string', description: '한 줄 제목. 다른 결정은 제목을 달리한다. 기존 결정은 expected_revision을 전달해야 수정된다.' },
+        expected_revision: { type: 'string', pattern: '^[a-f0-9]{64}$', description: '기존 결정 수정 시 get_case에서 읽은 revision. 신규 생성은 생략. 충돌하면 원문을 다시 읽고 변경을 재검토한다.' },
+        commit_id: { type: 'string', pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{15,79}$', description: '이 저장 작업의 고유 UUID. 첫 호출 전에 생성하고 응답 유실·재시도에는 같은 값과 같은 본문을 유지한다. 별도 수정은 새 값을 쓴다.' },
         what: { type: 'string', description: '무엇을 정했나 — 한 문장.' },
         who: { type: 'string', description: '정한 사람 또는 그 자리에 있던 사람. 모르면 비운다.' },
         when: { type: 'string', description: '정한 날짜(예: 2026-08-27). 모르면 비운다 — 오늘로 지어내지 말 것.' },
@@ -2599,7 +2632,7 @@ const TOOLS = [
           url: { type: 'string', description: '그 화면 주소(알면)' },
         } }, description: '사용자가 브라우저에서 **집은 요소**(iab 픽) — remember_case 의 같은 칸. 사용자가 "iab N" 이라 했으면 훅 줄의 #N 에서 그대로 옮긴다, 지어내지 않는다. 장에 「집은 자리」 절로 선다(최대 20).' },
       },
-      required: ['tenant', 'title', 'what'],
+      required: ['tenant', 'title', 'what', 'commit_id'],
     },
   },
   {
@@ -2616,8 +2649,9 @@ const TOOLS = [
       properties: {
         tenant: { type: 'string', description: '대상 소속처 slug(이름도 받는다 — list_my_tenants 참조).' },
         path: { type: 'string', description: 'search_cases·remember_decision 이 준 path 그대로(decisions/….md). 제목을 줘도 저장과 같은 자로 찾는다.' },
+        expected_revision: { type: 'string', pattern: '^[a-f0-9]{64}$', description: 'get_case로 읽은 삭제 대상의 revision.' },
       },
-      required: ['tenant', 'path'],
+      required: ['tenant', 'path', 'expected_revision'],
     },
   },
   {
@@ -2640,8 +2674,9 @@ const TOOLS = [
       properties: {
         tenant: { type: 'string', description: '대상 소속처 slug(이름도 받는다 — list_my_tenants 참조).' },
         path: { type: 'string', description: 'search_cases·remember_case 가 준 path 그대로(cases/….md). 제목을 줘도 저장과 같은 자로 찾는다.' },
+        expected_revision: { type: 'string', pattern: '^[a-f0-9]{64}$', description: 'get_case로 읽은 삭제 대상의 revision.' },
       },
-      required: ['tenant', 'path'],
+      required: ['tenant', 'path', 'expected_revision'],
     },
   },
   {
@@ -2947,9 +2982,12 @@ const TOOLS = [
  * `api.php` 에 'warnings' 는 0건이었다. 그런데 도구는 이 코드를 갖고 있었으니,
  * 에이전트는 「경고 없음」으로 읽었고 확인할 방법이 없었다. 전달 경로를 만든 뒤에도
  * 찍는 자리가 흩어져 있으면 또 한 곳이 빠지므로 여기 하나로 모은다. */
+// 자산을 굳히며 이쪽(작성자 기계)에서만 알 수 있는 것 — 서버 경고와 한 목록으로 낸다(readability.md R8).
+let ASSET_HINTS = [];
 function warnText(r) {
-  return r?.warnings?.length
-    ? `\n\n경고 ${r.warnings.length}건:\n· ${r.warnings.join('\n· ')}`
+  const w = [...(r?.warnings ?? []), ...ASSET_HINTS];
+  return w.length
+    ? `\n\n경고 ${w.length}건:\n· ${w.join('\n· ')}`
     : '';
 }
 
@@ -4197,8 +4235,11 @@ async function callTool(name, args = {}) {
       return lines.join('\n');
     }
     case 'remember_decision': {
+      if (typeof args.commit_id !== 'string' || !/^[a-zA-Z0-9][a-zA-Z0-9-]{15,79}(?![\s\S])/.test(args.commit_id)) {
+        throw new Error('commit_id는 영숫자로 시작하는 16~80자의 영숫자·하이픈이어야 합니다. 최초 요청의 키를 재시도에도 유지하세요.');
+      }
       const r = await api('POST', '/api/wiki/decision?tenant=' + encodeURIComponent(args.tenant), {
-        title: args.title, what: args.what,
+        title: args.title, what: args.what, expected_revision: args.expected_revision, commit_id: args.commit_id,
         who: args.who || '', when: args.when || '', why: args.why || '',
         reopen: args.reopen || '', status: args.status || '', tags: args.tags || [],
         work: args.work || '', order: args.order || [], plan: args.plan || [],
@@ -4208,6 +4249,10 @@ async function callTool(name, args = {}) {
         ...myCitation(),
       });
       const lines = [`${r.note} — ${r.tenant} · ${r.path}`];
+      if (r.revision) lines.push(`revision: ${r.revision}\ncommit_id: ${r.commit_id || ''}`);
+      if (r.effects_pending) lines.push(r.effects_state === 'failed'
+        ? '원문은 저장됐지만 후속 정리가 재시도 한도에 닿았습니다. 운영 확인이 필요합니다.'
+        : '원문은 저장됐고 후속 정리는 대기 중입니다. 같은 내용을 새로 저장하지 마세요.');
       if (Number(r.picks) > 0) lines.push(`집은 자리 ${r.picks}건 실림 — 다른 기계·다른 사람도 그 요소를 본다.`);
       // 안 적은 것을 **그렇게 말한다** — 조용히 열린 결정을 만들거나 계산 밖에 두지 않는다.
       if (!args.reopen) {
@@ -4222,7 +4267,7 @@ async function callTool(name, args = {}) {
       // 전체 맥락 정리 줄이 섰는지도 말한다 — 결정 저장이 종합의 박자가 됐다(2026-08-31). 옛 서버(칸 없음)는 침묵.
       if (r.insights_queued === true) {
         lines.push('이 결정으로 전체 맥락 정리가 다시 돕니다(몇 분 뒤 지식 화면에).');
-      } else if (r.insights_queued === false) {
+      } else if (r.insights_queued === false && !r.effects_pending) {
         lines.push('전체 맥락 정리 줄은 안 섰다 — 재료가 아직 문턱 아래(배경 문서 3장 또는 결정·사례 5장)거나 이미 줄이 서 있다.');
       }
       // 표지(work:)의 앞날 — 문장의 정본은 서버(work_decl_mark_note → 응답 work_note)다.
@@ -4234,14 +4279,15 @@ async function callTool(name, args = {}) {
         // 구서버(work_note 이전 판) — 판정값만 기계적으로 옮긴다. 안내문을 여기서 지어내면
         // 새 서버의 문장과 두 벌이 된다(위와 같은 병).
         lines.push(`일 표지 «${args.work}» 판정: ${r.work_mark} — 서버 판이 낡아 안내문이 없다(새 판은 문장을 함께 보낸다).`);
-      } else if (args.work) {
+      } else if (args.work && !r.effects_pending) {
         lines.push('표지(work)를 적었지만 이 서버는 아직 그 칸을 모른다 — 판이 낡았다.');
       }
       return lines.join('\n');
     }
     case 'forget_decision': {
       const r = await api('DELETE', '/api/wiki/decision?tenant=' + encodeURIComponent(args.tenant)
-        + '&path=' + encodeURIComponent(String(args.path || '')));
+        + '&path=' + encodeURIComponent(String(args.path || ''))
+        + '&expected_revision=' + encodeURIComponent(String(args.expected_revision || '')));
       const lines = [`${r.note} — ${r.tenant} · ${r.path}`];
       if (r.trashed_to) lines.push(`휴지통: ${r.trashed_to} (복구는 서버에서 사람이 파일을 되돌린다)`);
       if (typeof r.index_dropped === 'number') {
@@ -4253,7 +4299,8 @@ async function callTool(name, args = {}) {
       // forget_decision 과 같은 꼴(2026-09-03) — 서버 note·trashed_to·index_dropped 를 **그대로** 옮긴다.
       // 프로즈를 여기서 다시 지으면 두 벌이 된다(remember_decision 의 work_note 교훈, 2026-09-01).
       const r = await api('DELETE', '/api/wiki/case?tenant=' + encodeURIComponent(args.tenant)
-        + '&path=' + encodeURIComponent(String(args.path || '')));
+        + '&path=' + encodeURIComponent(String(args.path || ''))
+        + '&expected_revision=' + encodeURIComponent(String(args.expected_revision || '')));
       const lines = [`${r.note} — ${r.tenant} · ${r.path}`];
       if (r.trashed_to) lines.push(`휴지통: ${r.trashed_to} (복구는 서버에서 사람이 파일을 되돌린다)`);
       if (typeof r.index_dropped === 'number') {
@@ -4262,8 +4309,12 @@ async function callTool(name, args = {}) {
       return lines.join('\n');
     }
     case 'remember_case': {
+      if (typeof args.commit_id !== 'string' || !/^[a-zA-Z0-9][a-zA-Z0-9-]{15,79}(?![\s\S])/.test(args.commit_id)) {
+        throw new Error('commit_id는 영숫자로 시작하는 16~80자의 영숫자·하이픈이어야 합니다. 최초 요청의 키를 재시도에도 유지하세요.');
+      }
       const r = await api('POST', '/api/wiki/case?tenant=' + encodeURIComponent(args.tenant), {
         title: args.title, symptom: args.symptom, cause: args.cause || '', fix: args.fix,
+        expected_revision: args.expected_revision, commit_id: args.commit_id,
         evidence: args.evidence || '', tags: args.tags || [],
         paths: args.paths || [], commands: args.commands || [], errors: args.errors || [],
         picks: Array.isArray(args.picks) ? args.picks : [],          // 집은 자리(2026-09-03) — 그대로 넘긴다, 모양은 서버가 검사
@@ -4273,10 +4324,14 @@ async function callTool(name, args = {}) {
       });
       // 밀기 결과도 그대로 옮긴다 — 몇에게 갔고 누가 왜 못 받았는지(구서버는 필드가 없어 침묵).
       const lines = [`${r.note} — ${r.tenant} · ${r.path}`];
+      if (r.revision) lines.push(`revision: ${r.revision}\ncommit_id: ${r.commit_id || ''}`);
+      if (r.effects_pending) lines.push(r.effects_state === 'failed'
+        ? '원문은 저장됐지만 후속 정리가 재시도 한도에 닿았습니다. 운영 확인이 필요합니다.'
+        : '원문은 저장됐고 후속 정리는 대기 중입니다. 같은 내용을 새로 저장하지 마세요.');
       if (Number(r.picks) > 0) lines.push(`집은 자리 ${r.picks}건 실림 — 다른 기계·다른 사람도 그 요소를 본다.`);
       // ★ 창구가 낸 경고를 **맨 앞에** 옮긴다 — 쓰는 그 순간이 고치기 가장 싼 자리다(2026-09-01).
       if (r.warn) lines.push('⚠ ' + r.warn);
-      if (Array.isArray(r.matched_paths)) {
+      if (Array.isArray(r.matched_paths) && !r.effects_pending) {
         if (!r.matched_paths.length) {
           lines.push('경로가 없어 아무에게도 안 갔다 — 그리고 **이 장이 어느 저장소의 일인지도 안 남았다**. 근거에 저장소 상대 경로(예: www/portal/lib/x.php:12)를 적으면 그 파일을 읽은 채로 든 세션에게 가고, 소속을 잘못 적었을 때 기계가 짚을 수 있다.');
         } else if (r.pushed > 0) {
@@ -4329,7 +4384,7 @@ async function callTool(name, args = {}) {
       const mine = myCitation().session_uuid || '';
       const r = await api('GET', '/api/wiki/page?tenant=' + encodeURIComponent(args.tenant)
         + '&path=' + encodeURIComponent(args.path) + (mine ? '&session=' + mine : ''));
-      return `${r.path}${r.signals ? '\n' + r.signals : ''}\n\n${r.markdown}`;
+      return `${r.path}\nrevision: ${r.revision}${r.signals ? '\n' + r.signals : ''}\n\n${r.markdown}`;
     }
     case 'case_verdict': {
       const r = await api('POST', '/api/wiki/verdict?tenant=' + encodeURIComponent(args.tenant), {
@@ -4719,7 +4774,7 @@ async function handle(line) {
             '  로컬 메모는 그 기계에서만 남는다. 다른 사람·다른 기계가 쓸 것이면 여기로 남긴다.',
             '',
             '「남겨줘 / 기억해줘 / 업데이트 / 갱신 / 동기화 / 올려둬」는 **무엇을 남기느냐로 갈린다**:',
-            '· 알아낸 것 하나(증상과 처방) → remember_case  (같은 제목이면 덮어쓰므로 갱신도 이것)',
+            '· 알아낸 것 하나(증상과 처방) → remember_case  (갱신은 get_case의 revision을 expected_revision으로 전달)',
             '· 정한 것(증상이 없다 — 기획·디자인의 판단, 반려, "이렇게 가기로 했다") → remember_decision',
             '· 지금 이 대화 전체 → push_session  (다른 기계가 이어받게)',
             '· 고객에게 나갈 문서 → publish_report / update_report',

package/package.json

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