genetics-mcp 2.22.0 → 2.23.0

package/bin/manifest.json

@@ -1,7 +1,7 @@
 {
-  "aarch64-apple-darwin": "cb352eda0bbcf7419a7ca7243be783dfd3fece7a7e5fc3b5574474c92ac349f3",
-  "aarch64-unknown-linux-musl": "43a93d3366f4700a74564adca0531312d4ef2079eb3d38ae5617e9c2199806de",
-  "x86_64-apple-darwin": "c21172e1519287d0990149b668fc595be8f656d39fa30f5b811963d492c9e8d4",
-  "x86_64-pc-windows-gnu": "10cdaa9e0f06b35843fe65006dbaed70e382ee61a1a86f0627d9e9df87557df3",
-  "x86_64-unknown-linux-musl": "72e65bdd62e2afc7de01be2311ecfe55bc3b656764e09df4e382782ba66981c4"
+  "aarch64-apple-darwin": "e1a2b90dba750b351681467c79e08892e1e3194e7ad17942d7a1e27df4466222",
+  "aarch64-unknown-linux-musl": "8f92a5b9acdc4d03efdbe1acd579fad475626e95d0e8d9e10acabe0c3dbb74a4",
+  "x86_64-apple-darwin": "e231aeeb459fb5fc36aa877dd78d505f8327c02fe30e74305b6bf4a72540aabb",
+  "x86_64-pc-windows-gnu": "8b57d84c62233951f36b612901aea40db6fe775fefb571f34b4896e1440894fc",
+  "x86_64-unknown-linux-musl": "4fb2c81fe250bfbc6ccef94bd44c1326646ae3e93b83990feaaf846b80582439"
 }

package/genetics.mjs

@@ -855,12 +855,75 @@ function encodeAsset(buf, role, provider) {
  * 운영 문서가 1400x934 그림을 1400x1050 이라 선언해 브라우저가 세로로 12.4% 늘여
  * 그리고 있었다(2026-08-16 실측). 선언을 안 받으면 그 결함이 구조적으로 안 생긴다.
  */
-async function materializeAssets(data) {
+/** 영상 한 편의 상한 — 서버 R2_VIDEO_MAX_BYTES 와 **같은 값**이다(갈리면 올리다 막힌다). */
+const VIDEO_MAX_BYTES = 200_000_000;
+
+/**
+ * 로컬 영상 파일 하나. 확장자를 안 믿고 **매직바이트**로 판정한다(서버도 같은 것을 다시 잰다).
+ * ISO BMFF 는 [4바이트 크기][ftyp] 라 4바이트째부터 본다.
+ */
+function readLocalVideo(p) {
+  if (/^[a-z][a-z0-9+.-]*:/i.test(p)) throw new Error(`file 에는 주소가 아니라 파일 경로를 줍니다: ${p}`);
+  if (!path.isAbsolute(p)) throw new Error(`file 은 절대경로여야 합니다: ${p}`);
+  let st;
+  try { st = fs.statSync(p); } catch { throw new Error(`file 을 찾을 수 없습니다: ${p}`); }
+  if (!st.isFile()) throw new Error(`file 이 일반 파일이 아닙니다: ${p}`);
+  if (st.size > VIDEO_MAX_BYTES) {
+    throw new Error(`영상이 ${st.size.toLocaleString()}B 로 상한 ${VIDEO_MAX_BYTES.toLocaleString()}B 를 넘습니다: ${p}\n`
+      + '길이를 줄이거나 화질을 낮춰 다시 인코딩하세요(ffmpeg -crf 를 올리면 작아집니다).');
+  }
+  const buf = fs.readFileSync(p);
+  if (buf.toString('ascii', 4, 8) !== 'ftyp') {
+    throw new Error(`file 이 mp4(ISO BMFF)가 아닙니다(매직바이트 기준): ${p}`);
+  }
+  return buf;
+}
+
+/**
+ * 영상을 저장소에 올리고 **참조 번호**를 받는다.
+ *
+ * 바이트는 이 기계에서 저장소로 **직접** 간다 — 포털을 거치지 않는다(포털은 메모리가 좁고
+ * Range 를 모른다). 포털이 하는 일은 「올릴 자리 하나를 원장에 세우고 서명해 주는 것」뿐이다.
+ * `headers` 는 **그대로** 실어야 한다 — 그 값이 서명에 들어가 있어서, 하나라도 다르면 저장소가 거절한다.
+ */
+async function uploadVideo(tenant, buf, filePath) {
+  if (!tenant) {
+    throw new Error('영상을 올리려면 tenant 가 필요합니다 — publish_report·update_report 의 tenant 를 씁니다.');
+  }
+  const sha256 = crypto.createHash('sha256').update(buf).digest('hex');
+  const pre = await api('POST', '/api/media/presign', { tenant, bytes: buf.length, sha256 });
+  const res = await fetch(pre.url, { method: 'PUT', body: buf, headers: { ...(pre.headers || {}) } });
+  if (!res.ok) {
+    const why = (await res.text().catch(() => '')).slice(0, 200);
+    throw new Error(`영상을 저장소에 올리지 못했습니다(${res.status}): ${filePath}\n${why}\n`
+      + '설정 화면의 「연결 시험」이 통과하는지 먼저 확인하세요.');
+  }
+  ASSET_HINTS.push(`영상 「${path.basename(filePath)}」 ${(buf.length / 1048576).toFixed(1)}MB 를 올렸습니다(참조 ${pre.ref}).`);
+  return pre.ref;
+}
+
+async function materializeAssets(data, tenant) {
   ASSET_HINTS = [];
   if (!data || !Array.isArray(data.assets) || !data.assets.length) return data;
   const out = [];
   for (const a of data.assets) {
     const { data: dropped, file: fpath, ...meta } = a ?? {};
+    /*
+     * 영상(138) — 바이트를 문서에 싣지 않는다. `file` 에 로컬 mp4 경로를 주면 여기서 올리고
+     * **참조 번호만** 문서에 남긴다. 이미 `ref` 가 있으면 올린 것이므로 그대로 둔다
+     * (되읽은 판을 고쳐 되돌려 보내는 왕복에서 같은 영상을 두 번 올리지 않는다).
+     */
+    if (String(a?.role ?? '') === 'video' || String(a?.provider ?? '') === 'r2') {
+      const { data: _vd, ...rest } = meta;
+      if (Number(rest.ref) > 0) { out.push({ ...rest, role: 'video', provider: 'r2' }); continue; }
+      if (!fpath) {
+        throw new Error(`영상 「${rest.id ?? '(id 없음)'}」 에 file(로컬 mp4 경로)도 ref 도 없습니다.\n`
+          + 'file 에 절대경로를 주면 올리고 번호를 받아 싣습니다.');
+      }
+      const ref = await uploadVideo(tenant, readLocalVideo(String(fpath)), String(fpath));
+      out.push({ ...rest, role: 'video', provider: 'r2', ref, mime: 'video/mp4' });
+      continue;
+    }
     if (!a?.source && !fpath) {
       // 둘 다 없으면 예전 경로 그대로 — data 를 그대로 통과시킨다(판 A 하위호환).
       // get_report 가 준 표식('(생략 — NB)')과 bytes 칸의 처리(2026-08-27, 운영 #34):
@@ -1374,18 +1437,42 @@ const REPORT_DATA = {
               + '예: 「2026. 8. 24. Galaxy S22+ 실기기 홈 화면」.',
           },
           role: {
-            type: 'string', enum: ['hero', 'chapter', 'figure', 'eof', 'logo'],
+            type: 'string', enum: ['hero', 'chapter', 'figure', 'eof', 'logo', 'video'],
             description: '`logo` 는 **표지 우상단 고객사 마크**다 — provider 는 user-provided, '
               + 'origin 에 제공자를 적는다. 못 받았으면 넣지 말고 data.client 에 이름만 적어라 '
               + '(렌더러가 활자로 세운다).\n'
               + '`eof` 는 **문서 끝 꼬리 카드**다. 안 줘도 된다 — 서버가 기본 카드를 '
               + '끼운다(계약 9절). 이 문서만의 카드가 있을 때만 준다. 그때는 무손실(PNG 또는 '
-              + '무손실 WebP)이어야 하고 줄이지 않고 원본 크기로 실린다.',
+              + '무손실 WebP)이어야 하고 줄이지 않고 원본 크기로 실린다.\n'
+              + '`video` 는 **절 본문 영상**이다(138). 바이트를 여기 싣지 않는다 — 먼저 '
+              + '`POST /api/media/presign` 으로 올릴 자리를 받아 그 URL 에 PUT 하고, 받은 번호를 '
+              + '`ref` 에 적는다. 자리는 `figure` 와 같다(sections[].plates·cases[].plates). '
+              + '영상 저장 연동이 꺼진 환경에서는 발행이 거절된다 — 다른 형식으로 우회하지 않는다.',
           },
           provider: {
-            type: 'string', enum: ['higgsfield', 'deterministic', 'user-provided'],
+            type: 'string', enum: ['higgsfield', 'deterministic', 'user-provided', 'r2'],
             description: 'hero·chapter 는 higgsfield 여야 한다. deterministic 은 role: figure 에 한한다. '
-              + 'user-provided 는 origin 이 필수다. sample-exception 은 발행 거절 값',
+              + 'user-provided 는 origin 이 필수다. sample-exception 은 발행 거절 값. '
+              + '`r2` 는 role: video 와 **짝**이다 — 바이트 대신 ref 로 온다',
+          },
+          // ⚠ 한 이름에 **자리에 따라 다른 두 뜻**이 얹혀 있다. 둘은 provider 로 서로 배타적이고 독자도 키를 만지기
+          //   전에 provider/role 로 먼저 가른다(report_publish.php:544·1642 · report_media.php · gazette.py).
+          //   2026-09-19 에 영상 갈래가 이 정수 선언을 따로 적으면서 아래쪽 불리언 선언과 **같은 객체에 두 번**
+          //   들어갔고, JS 는 뒤엣것을 써서 정수 쪽이 조용히 사라졌다 — 게시 스키마가 `ref` 를 불리언이라고
+          //   광고하는 동안 영상 자산은 `ref: 12` 를 실어 보내고 있었다(2026-09-20 관문이 짚음).
+          //   개명은 하지 않는다: 서버 창구가 응답 본문으로 `ref` 를 안내하고(api.php:3252) 이미 발행된 문서의
+          //   source_json 에도 그 이름으로 저장돼 있어, 옮기면 report_media_refs() 가 빈 배열을 내고 청소가
+          //   R2 객체를 지운다(되돌릴 수 없다 — 실측으로 확인된 실패 양식). 그래서 **한 벌로 합쳐** 두 뜻을 적는다.
+          ref: {
+            type: ['integer', 'boolean'],
+            description: '자리에 따라 뜻이 갈린다 — **`provider: r2` 이면 영상 자리 번호(정수)**, '
+              + '그 밖의 그림 자산이면 **세트 참조 스위치(불리언)** 다.\n'
+              + '· 정수: 영상 자리 번호. **보통은 직접 적지 않는다** — `file` 에 로컬 mp4 절대경로를 주면 '
+              + '이 도구가 올리고 번호를 채운다. 되읽은 판을 고쳐 되돌려 보낼 때는 받은 값을 그대로 두면 '
+              + '다시 안 올린다(빼면 서버가 저장된 값을 잇는다).\n'
+              + '· 불리언: 거짓이면 **세트 참조 없이 단독으로** 그린다. 기본은 참 — hero 를 먼저 그려 그것을 '
+              + '참조로 나머지를 이어야 한 세트로 보인다(참조 없이 내면 장마다 인물이 달라진다). '
+              + 'hero 자신에게는 뜻이 없다.',
           },
           alt: { type: 'string', description: '설명적 대체 텍스트 — 접근성 계약. 그림과 함께 다닌다' },
           origin: { type: 'string', description: '생성 job 식별자·.mmd 원본 경로·제공자 이름' },
@@ -1424,12 +1511,7 @@ const REPORT_DATA = {
             type: 'string', enum: ['16:9', '4:3', '3:4', '1:1', '3:2', '2:3', '9:16'],
             description: '생략하면 역할이 정한다 — hero 16:9 · 그 밖 4:3.',
           },
-          ref: {
-            type: 'boolean',
-            description: '거짓이면 **세트 참조 없이 단독으로** 그린다. 기본은 참 — hero 를 먼저 '
-              + '그려 그것을 참조로 나머지를 이어야 한 세트로 보인다(참조 없이 내면 장마다 '
-              + '인물이 달라진다). hero 자신에게는 뜻이 없다.',
-          },
+          // (`ref` 는 위 provider 옆으로 합쳤다 — 한 객체에 같은 키를 두 번 적으면 JS 가 앞엣것을 조용히 버린다)
           source: {
             type: 'string',
             description: '이미 그린 그림의 원본 https 주소(허용 호스트 목록 안). **이 도구의 프로세스가** '
@@ -4004,7 +4086,74 @@ async function stopBeat() {
   try { await beatOnce(beatTargets(), { closing: true }); } catch { /* 최선만 다한다 */ }
 }
 
+function taskReadTools() {
+  const tenant = { type: 'string', minLength: 1, maxLength: 100, description: 'list_my_tenants에서 확인한 조직 slug' };
+  return [
+    { name: 'list_tasks', description: '조직에서 함께 사용하는 할 일과 완료 조건을 찾습니다. uid로 get_task_result를 호출해 사람이 채택한 결과를 이어받으세요. 개인 대화나 초안은 포함하지 않습니다.',
+      inputSchema: { type: 'object', additionalProperties: false, required: ['tenant'], properties: { tenant,
+        limit: { type: 'integer', minimum: 1, maximum: 50, default: 20 }, offset: { type: 'integer', minimum: 0, maximum: 10000, default: 0 } } } },
+    { name: 'get_task_result', description: '할 일에서 사람이 채택한 현재 결과를 본인의 조직·Notion 원문 권한으로 읽습니다. 다시 사용할 때 재조회하세요. 할 일이 바뀌었으면 당시 기록과 현재 업무를 구분합니다.',
+      inputSchema: { type: 'object', additionalProperties: false, required: ['tenant', 'task_uid'], properties: { tenant,
+        task_uid: { type: 'string', pattern: '^[a-z0-9]{8}$' } } } },
+  ];
+}
+
+/** Request validation is transport-only. Current identity, source access and selected revision belong to the API. */
+function taskReadRequest(name, args) {
+  if (!args || typeof args !== 'object' || Array.isArray(args) || typeof args.tenant !== 'string'
+      || !args.tenant.trim() || [...args.tenant].length > 100) throw new Error('조직 slug를 확인하세요.');
+  const allowed = name === 'get_task_result' ? ['tenant', 'task_uid'] : ['tenant', 'limit', 'offset'];
+  if (Object.keys(args).some(key => !allowed.includes(key))) throw new Error('지원하지 않는 조회 인자입니다.');
+  const query = new URLSearchParams({ tenant: args.tenant });
+  if (name === 'get_task_result') {
+    if (typeof args.task_uid !== 'string' || !/^[a-z0-9]{8}$/.test(args.task_uid)) throw new Error('list_tasks에서 받은 할 일 uid가 필요합니다.');
+    return '/api/work/tasks/' + args.task_uid + '/result?' + query;
+  }
+  const limit = args.limit ?? 20, offset = args.offset ?? 0;
+  if (name !== 'list_tasks' || !Number.isInteger(limit) || limit < 1 || limit > 50
+      || !Number.isInteger(offset) || offset < 0 || offset > 10000) throw new Error('할 일 목록의 범위를 확인하세요.');
+  return '/api/work/tasks?' + query + '&limit=' + limit + '&offset=' + offset;
+}
+
+function taskReadResult(name, args, body) {
+  const pick = (value, keys) => Object.fromEntries(keys.map(key => [key, value[key]]));
+  const hash = value => typeof value === 'string' && /^[a-f0-9]{64}$/.test(value);
+  if (body?.ok !== true) throw new Error('현재 업무 결과를 확인하지 못했습니다.');
+  let result;
+  if (name === 'get_task_result') {
+    const value = body.result, doc = value?.document;
+    if (value?.tenant !== args.tenant || value?.task_uid !== args.task_uid || !hash(value.task_revision)
+        || !Number.isInteger(value.generation) || value.generation < 0 || value.generation > 10000
+        || typeof value.basis_changed !== 'boolean' || typeof value.note !== 'string'
+        || (value.generation === 0) !== (doc === null)) throw new Error('채택 기록의 정체와 판을 확인하지 못했습니다.');
+    if (doc !== null && (!doc || !Number.isInteger(doc.id) || doc.id < 1 || typeof doc.title !== 'string'
+        || typeof doc.url !== 'string' || !hash(doc.revision) || typeof doc.text !== 'string' || Buffer.byteLength(doc.text) > 65536)) {
+      throw new Error('채택 문서의 전체 본문을 확인하지 못했습니다.');
+    }
+    result = pick(value, ['tenant', 'task_uid', 'task_revision', 'generation', 'basis_changed', 'note']);
+    result.document = doc === null ? null : pick(doc, ['id', 'title', 'url', 'revision', 'text']);
+  } else {
+    const rows = body.tasks, page = body.page, limit = args.limit ?? 20, offset = args.offset ?? 0;
+    const expected = Math.min(limit, Math.max(0, body.open - offset)), end = offset + expected;
+    const next = end < body.open && end <= 10000 ? end : null;
+    if (name !== 'list_tasks' || body.tenant_slug !== args.tenant || !Array.isArray(rows) || !Number.isInteger(body.open)
+        || body.open < 0 || !page || page.limit !== limit || page.offset !== offset || rows.length !== expected
+        || page.returned !== expected || page.truncated !== (end < body.open) || page.next_offset !== next) {
+      throw new Error('할 일 목록의 범위를 확인하지 못했습니다.');
+    }
+    const tasks = rows.map(row => {
+      if (!row || typeof row.uid !== 'string' || !/^[a-z0-9]{8}$/.test(row.uid)
+          || ['title', 'state', 'state_word', 'done_when'].some(key => typeof row[key] !== 'string')) throw new Error('할 일의 내용을 확인하지 못했습니다.');
+      return pick(row, ['uid', 'title', 'state', 'state_word', 'done_when']);
+    });
+    result = { tenant: args.tenant, tasks, total: body.open, page: pick(page, ['limit', 'offset', 'returned', 'truncated', 'next_offset']) };
+  }
+  if (Buffer.byteLength(JSON.stringify(result)) > 98304) throw new Error('현재 업무 결과의 응답 크기가 상한을 넘습니다.');
+  return result;
+}
+
 const TOOLS = [
+  ...taskReadTools(),
   /*
    * ★ **이 도구는 부르지 않아도 일한다.** 설명 자체가 세계 사실을 실어 나른다(`toolsNow()`).
    * 도구 목록은 매 턴 모델 문맥에 있으므로, 부르기 전에 이미 눈앞에 놓인다.
@@ -4340,7 +4489,7 @@ const TOOLS = [
         when: { type: 'string', description: '정한 날짜(예: 2026-08-27). 모르면 비운다 — 오늘로 지어내지 말 것.' },
         why: { type: 'string', description: '그때의 근거 — 수치·관찰. 이 칸이 이 장의 값이다.' },
         reopen: { type: 'string', description: '무슨 조건이면 다시 여나. **비우면 「열린 결정」으로 읽힌다.** 끝났으면 "조건 없음(종결)".' },
-        status: { type: 'string', description: '상태 — "유효"(기본) · "뒤집힘 → decisions/<그 결정>" · "조건 충족 → <무엇이> (날짜)".' },
+        status: { type: 'string', description: '상태 — "유효"(기본) · "뒤집힘 → decisions/<그 결정>.md" · "조건 충족 → <무엇이> (날짜)". ★ 「뒤집힘」은 **무엇을 뒤집는지 대야 저장된다** — 경로가 없거나 그 장이 실재하지 않으면 거절한다(get_case 가 준 경로 그대로). 가리킬 장이 아직 없으면 그 결정을 먼저 남겨라.' },
         tags: { type: 'array', items: { type: 'string' }, description: '갈래(최대 8). ★ 이것이 있어야 이 결정이 「일」 후보 계산에 들어간다.' },
         work: { type: 'string', description: '**이 결정이 곧 과업이면** 그 일의 열쇠(영문 소문자·숫자·붙임표, 예: hnl-wait). 적으면 그 이름의 일이 **지금** 「계획」으로 선다 — 착수 전에 세우는 정문이다. 이미 열린 일의 열쇠면 이 결정이 그 일의 **항목**(작업 리스트 한 줄)으로 서고 간트에 저장 즉시 보인다 — 항목 여럿이면 결정을 여러 번 적는다(항목마다 제 근거를 갖는다).' },
         order: { type: 'array', items: { type: 'string' }, description: '일 사이 **순서**를 정하는 결정이면 일의 열쇠를 앞선 것부터(최대 24). 표에 저장하지 않고 일 목록이 이 결정을 읽어 그 순서로 선다 — 순서가 바뀌면 새 결정을 적는다.' },
@@ -5749,6 +5898,36 @@ function worksItemsLine(items) {
   return rows.length ? `${head} · 그중 ${rows.join(' · ')}` : head;
 }
 
+/**
+ * **목록 밖으로 떨어진 결정**(2026-09-21) — 그 일의 갈래와 만나는데 **항목이 못 된** 장.
+ *
+ * ★ 왜 이 줄이 있나(LIM 실측 2026-09-21): 「간트에서 항목을 에이전트에게 시키기」 한 목표를
+ *   다룬 결정 6장 중 표지(`work:`)를 단 것은 2장뿐이었고 그 둘조차 열쇠가 달랐다. 나머지 4장은
+ *   **어느 목록에도 어느 수에도 안 섰다** — 그래서 사람도 두뇌도 「왜 이 일에 항목이 이것뿐인가」를
+ *   물을 길이 없었다. 항목으로 세우지는 **않는다**(2026-08-31 오너 판정: 그 일에 **대한** 결정은
+ *   그 일의 **할 일**이 아니다). 빠졌다는 **사실만** 말한다.
+ *
+ * ★ **방어적으로 그린다** — 서버가 이 칸을 안 보내면 **오늘 내는 글자 그대로** 낸다.
+ *   읽는 칸: `unmarked = { no_mark, baked, off_work, total, paths: [<결정 장 경로>, …] }`
+ *   사유마다 **처방이 다르므로** 낱말을 가른다:
+ *     · `no_mark`  표지가 없다        → 그 결정에 `work:` 를 달면 항목이 된다
+ *     · `baked`    두뇌가 구운 장이다 → 사람이 제 것으로 세워야(`origin: human`) 비로소 읽힌다
+ *     · `off_work` 표지가 **열린 일을 안 가리킨다** → 열쇠가 갈렸다(닫혔거나 다른 이름)
+ */
+function worksUnmarkedLine(u) {
+  const x = u && typeof u === 'object' ? u : {};
+  const total = Number(x.total) || 0;
+  if (!total) return '';
+  const bits = [];
+  if (Number(x.no_mark) > 0) bits.push(`표지 없음 ${Number(x.no_mark)}`);
+  if (Number(x.baked) > 0) bits.push(`두뇌가 구운 장 ${Number(x.baked)}`);
+  if (Number(x.off_work) > 0) bits.push(`표지가 다른 이름 ${Number(x.off_work)}`);
+  if (!bits.length) return '';
+  const paths = (Array.isArray(x.paths) ? x.paths : []).filter((q) => typeof q === 'string' && q).slice(0, 3);
+  return `\n    ⚠ 이 일 언저리에서 **항목이 못 된 결정 ${total}건** — ${bits.join(' · ')}.`
+    + (paths.length ? ` 예: ${paths.join(' · ')}` : '');
+}
+
 async function callTool(name, args = {}) {
   requireArgs(name, args);
   switch (name) {
@@ -6107,7 +6286,7 @@ async function callTool(name, args = {}) {
       return r.says;
     }
     case 'publish_report': {
-      const data = await materializeAssets(args.data);
+      const data = await materializeAssets(args.data, args.tenant);
       // **기본은 초안이다.** 서버 기본값은 참(다른 호출자의 동작을 말없이 바꾸지 않는다)이라
       // 여기서 뒤집는다 — 확인 전에 고객이 먼저 보는 일을 막는 것은 도구의 몫이다.
       const publish = args.publish === true;
@@ -6153,7 +6332,7 @@ async function callTool(name, args = {}) {
       return `${r.note}\n${lines.join('\n')}`;
     }
     case 'update_report': {
-      const data = await materializeAssets(args.data);
+      const data = await materializeAssets(args.data, args.tenant);
       const payload = { ...data, tenant: args.tenant };
       // 노출 손잡이는 떼고 보낸다(2026-09-14). get_report 가 돌려주는 data 에는 발행 때 보낸 몸통이
       // 그대로 남아 있어(source_json) `publish`·`published_at` 이 메아리로 섞여 온다 — 그 값이
@@ -6198,6 +6377,11 @@ async function callTool(name, args = {}) {
       if (!facts.length) return '이 저장소에서 최근에 남이 바꾼 것은 없다.';
       return `이 저장소에서 최근에 바뀐 것:\n${facts.map((f) => `  · ${f}`).join('\n')}`;
     }
+    case 'list_tasks':
+    case 'get_task_result': {
+      const result = await api('GET', taskReadRequest(name, args));
+      return JSON.stringify(taskReadResult(name, args, result), null, 2);
+    }
     case 'works': {
       if (args.work) {
         // 완료 확인/표시/해제(095) — claim 과 별개 통로. item 은 필수(어느 결정인지).
@@ -6246,20 +6430,29 @@ async function callTool(name, args = {}) {
       // 차례를 사람이 정했으면 그 출처를 말한다 — 「…부터 해라」가 아니라 「…이 정한 차례다」(서술형).
       if (r.order_from?.title) lines.push(`  차례는 결정 «${r.order_from.title}» 이 정했다 — 위에서부터가 그 차례다.`);
       let reportSeen = false;
+      let unmarkedSeen = false;
       for (const w of rows) {
         if (Array.isArray(w.items?.reports) && w.items.reports.some((x) => Number(x?.id) > 0)) reportSeen = true;
+        if (Number(w.unmarked?.total) > 0) unmarkedSeen = true;
         lines.push(`  · «${w.name || w.slug}» (${w.slug}) — ${w.word} · 세션 ${w.sessions}`
           // 항목 = 그 일을 가리키는 결정, 그리고 공개된 보고서의 열린 항목(§7.7). 「무엇을 하기로 했나」가 몇 건인지.
           // 0 이면 안 붙인다. done 은 실행 축 집계(095) — 어느 항목인지는 안 말한다, work+item 으로 따로 확인.
           + worksItemsLine(w.items)
           + (w.stale ? ` · 낡음 ${w.stale}일째(AI 관측 — 활동이 멎었다: 사람이 닫거나 다시 살릴 일)` : '')
-          + (w.doc ? ` · 요지: get_case(tenant, "${w.doc}")` : ' · 요지 문서 아직 없음'));
+          + (w.doc ? ` · 요지: get_case(tenant, "${w.doc}")` : ' · 요지 문서 아직 없음')
+          + worksUnmarkedLine(w.unmarked));
       }
       if (!rows.length) lines.push('열린 일이 없다 — 0건은 0건이다. 착수 전에 세우려면 그 과업의 결정을 remember_decision 으로 남기되 **work 에 일의 열쇠를 적어라** — 저장 응답의 work_note 로 「계획」이 선 것을 확인하고 이 도구를 다시 부른다. 표지 없이 tags 만 달면 신호가 쌓일 때까지 AI 가 기다린다. 군체 화면은 열린 일이 있을 때 소속을 확정하는 자리 — 0건이면 고를 일이 없다.');
       else lines.push('붙을 일이 보이면 works(tenant, claim: "<slug>") 로 선언한다 — 확정은 사람이 화면에서 한다.'
         + '\n그 일 안의 특정 결정 항목을 쥐었으면 works(tenant, claim: "<slug>", item: "decisions/<page>.md") 로 함께 선언한다.'
-        + '\n항목은 그 일의 열쇠·갈래를 단 **결정**이다 — 무엇을 하기로 했는지는 지식의 결정 장에 있고, 새 항목은 remember_decision 으로 남긴다.'
+        + '\n항목은 그 일의 열쇠를 **표지(work:)로 단** 결정이다 — 갈래(tags)만 달면 항목이 아니라 「그 일에 **대한** 결정」이라 목록에 안 선다(2026-08-31 오너 판정). 새 항목은 remember_decision 의 work 에 그 열쇠를 적어 남긴다.'
         + '\n항목을 실제로 끝냈으면 works(tenant, work: "<slug>", item: "…", done_when: "…", done_evidence: "…") 로 직접 완료를 표시한다 — 사람이 화면에서 누르길 기다릴 필요 없다.');
+      /* 목록 밖으로 떨어진 결정이 하나라도 보이면 **처방 한 줄**을 더한다(2026-09-21).
+         하나도 없는 소속처의 출력은 오늘과 **한 글자도 다르지 않다** — reportSeen 과 같은 규율. */
+      if (unmarkedSeen) lines.push('⚠ 「항목이 못 된 결정」이 있다 — 그 일에 **대한** 결정이 그 일의 **할 일 목록**에는 안 선 것이다. 사유마다 처방이 다르다:'
+        + '\n  · 표지 없음 — 그 결정을 remember_decision 으로 다시 적을 때 work 에 그 일의 열쇠를 적으면 항목이 된다(같은 제목이면 갱신이라 expected_revision 이 필요하다).'
+        + '\n  · 두뇌가 구운 장 — 사람이 포털에서 제 것으로 세워야 읽힌다. 두뇌가 제 산출물로 제 일을 낳는 길은 **일부러 막혀 있다**.'
+        + '\n  · 표지가 다른 이름 — 같은 목표에 **열쇠가 둘 선 것**이다. 어느 쪽이 정본인지 사람에게 묻고, 새 이름으로 또 열지 마라.');
       /*
        * ★ 보고서에서 온 항목이 섞여 있을 때만 한 줄 더한다(§7.7) — 그 항목의 **상태는 보고서가 정본**이라
        *   여기서 완료를 찍으면 서버가 409 로 막는다. 그 사실을 먼저 말해 두는 것이 헛걸음을 줄인다.
@@ -7438,7 +7631,8 @@ if (IS_MAIN) {
 }
 
 // 시험용 — 서버 동작에는 쓰이지 않는다. materializeAssets 만 네트워크를 쓴다.
-export { encodeAsset, imageDims, imageHostAllowed, materializeAssets, warnText, IMAGE_HOST_ALLOW, HOST_ALLOW,
+export { taskReadTools, taskReadRequest, taskReadResult,
+         encodeAsset, imageDims, imageHostAllowed, materializeAssets, warnText, IMAGE_HOST_ALLOW, HOST_ALLOW,
          scrubTranscript, splitAtLines, PUSH_PART_MAX,
          // DESIGN-genetics-ssot.md §3·§5 — 색인·잠금·폴더 identity·알림 문구의 순수/파일 함수(시험이 걷는다)
          jsonFileUpdate, jsonCorruptAside, credWrite, pendingWrite, pendingClear, indexRead, indexNote, indexPatch, indexTenant,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genetics-mcp",
-  "version": "2.22.0",
+  "version": "2.23.0",
   "description": "문서 포털 발행·세션 이식·사례 기억 MCP — 데이터를 주면 규격 문서가 나온다 (짝인 스킬 동봉)",
   "author": "주식회사 LIM (LIM Inc.)",
   "license": "SEE LICENSE IN LICENSE",
@@ -18,7 +18,8 @@
     "node": ">=18"
   },
   "scripts": {
-    "test": "node smoke.mjs && node notify.test.mjs && node schedule.test.mjs && node windows.test.mjs && bash ../cell/tests/cellcycle.sh",
+    "test": "node smoke.mjs && node task-results-stdio.test.mjs && node notify.test.mjs && node schedule.test.mjs && node windows.test.mjs && bash ../cell/tests/cellcycle.sh",
+    "test:task-results": "node task-results.test.mjs && node task-results-stdio.test.mjs",
     "prepack": "find skills -name __pycache__ -type d -prune -exec rm -rf {} + 2>/dev/null; bash ../cell/build-all.sh",
     "prepublishOnly": "npm test",
     "release": "bash release.sh"

package/skills/genetics-report/references/lim-portal-format.md

@@ -471,6 +471,7 @@ python3 assets/render.py <report.json>
 | 절 %s 도해 「%s」가 %d바이트입니다 — 상한 %d바이트, 노드를 줄이거나 도판(PNG)으로 싣습니다 | `diagrams[].svg` 가 250,000B 초과 | 도해를 나누거나 PNG 도판으로 |
 | 절 %s 도해 「%s」에 viewBox 가 없거나 svg 가 아닙니다 — 폭을 알 수 없어 싣지 않습니다 | 루트 `<svg>` 에 viewBox 가 없다 | `diagram.mjs export` 로 굳힌 SVG 를 넣는다(§11-9) |
 | 절 %s 시계열 「%s」의 표식 「%s」가 점에 없습니다 — marks[].x 는 points[].x 와 같은 값이어야 섭니다 | `charts[].marks[].x` 가 어느 `points[].x` 와도 같지 않다 | 점의 x 값 그대로 적는다(§11-7) |
+| 절 %s 시계열 「%s」의 표식 라벨 「%s」와 「%s」가 %.0fpx 겹칩니다 — 라벨을 줄이거나 하나를 빼고 세로선만 남깁니다 | 표식 라벨은 전부 같은 높이(`T+13`)에 서고 렌더러가 밀어내지 않는다 — 가까운 표식 둘의 글자가 포개진다. 폭은 전각 1.0 · 공백 0.28 · 그 밖 0.55 로 어림한다(`_lblw`) | 라벨을 줄이거나, 하나는 `label` 없이 두어 세로선만 남긴다(§11-7) |
 | 절 %s 도해 「%s」의 ir 는 %s 입니다 — 관보가 직접 그리는 것은 workflow 뿐, 다른 종류는 svg 로 굳혀 넣습니다 | `diagrams[].ir.diagram_type` 이 `workflow` 가 아니다 | Archify 로 그린 뒤 `diagram.mjs export` 의 svg 를 넣는다(§11-9) |
 | 절 %s 도해 「%s」의 노드 「%s」 라벨이 두 줄을 넘습니다 — 낱말을 줄이거나 wide 로 두십시오 | 노드 폭(열 폭 − 간격)에서 15px 글자로 두 줄을 넘는 라벨 | 라벨을 줄이거나 `wide: true` |
 | 절 %s 도해 「%s」의 노드 「%s」가 없는 레인 「%s」를 가리킵니다 | `nodes[].lane` 이 `lanes[].id` 에 없다 | Archify validate 를 먼저 통과시킨다 |