genetics-mcp 2.22.0 → 2.24.0

package/genetics.mjs

@@ -182,11 +182,14 @@ const lockSleepCell = new Int32Array(new SharedArrayBuffer(4));
 
 function isoStamp() { return new Date().toISOString().replace(/[:.]/g, '-'); }
 
-/** 잠금 파일이 죽은 자의 것인가 — 같은 호스트의 죽은 pid 이거나 30초 넘게 묵었다. 그때 그 내용을, 아니면 null. */
-function lockStaleText(lock) {
+/**
+ * 잠금 파일이 죽은 자의 것인가 — 같은 호스트의 죽은 pid 이거나 `staleMs`(기본 30초) 넘게 묵었다. 그때 그 내용을, 아니면 null.
+ * `staleMs` 는 입구 임대(`LEASE_QUIET_MS`)가 쓴다 — 긴 PUT 을 쥔 산 주인의 임대를 30초 만에 걷지 않게(§3.2 · C7).
+ */
+function lockStaleText(lock, staleMs = LOCK_STALE_MS) {
   let st, text;
   try { st = fs.statSync(lock); text = fs.readFileSync(lock, 'utf8'); } catch { return null; }
-  if (Date.now() - st.mtimeMs > LOCK_STALE_MS) return text;
+  if (Date.now() - st.mtimeMs > staleMs) return text;
   const [pid, host] = text.split('\n');
   if (host === os.hostname() && /^[1-9][0-9]*$/.test(pid || '')) {
     try { process.kill(Number(pid), 0); } catch (e) { if (e?.code === 'ESRCH') return text; }
@@ -225,7 +228,8 @@ function sweepLeftovers(file) {
   const now = Date.now();
   try {
     for (const n of fs.readdirSync(dir)) {
-      if (!n.startsWith(`${base}.tmp-`) && !n.startsWith(`${base}.lock.stale-`)) continue;
+      // `<file>.lock.stale-` 은 기본 잠금 자리, `<file>.stale-` 은 잠금 파일을 직접 준 자리(입구 임대 `push/<uuid>.lease`).
+      if (!n.startsWith(`${base}.tmp-`) && !n.startsWith(`${base}.lock.stale-`) && !n.startsWith(`${base}.stale-`)) continue;
       const f = path.join(dir, n);
       try { if (now - fs.statSync(f).mtimeMs > LOCK_STALE_MS) fs.rmSync(f, { force: true }); } catch { /* 남이 지웠다 */ }
     }
@@ -233,12 +237,18 @@ function sweepLeftovers(file) {
 }
 
 /**
- * @param {number} [deadline] epoch ms — 이 시각을 넘기면 더 안 기다린다(0 이면 상한 없음, 호환 N9).
+ * @param {number} [deadline] epoch ms — 이 시각을 넘기면 더 안 기다린다(0 이면 LOCK_TRIES 만큼, 호환 N9).
  *   기다림은 `Atomics.wait` 이라 **이 고리가 곧 MCP 의 stdio 고리다** — 한 번의 쓰기가 몇 초씩 잡으면 심박도 도구 응답도 멎는다.
- */
-function fileLock(file, deadline = 0) {
-  const lock = `${file}.lock`;
-  const token = `${process.pid}\n${os.hostname()}\n${Date.now()}`;
+ *   `Date.now()` 를 주면 **한 번만** 잡아 본다(묵은 잠금을 걷는 한 번은 더 탄다) — 입구 임대의 비차단 모양(§3.2 · C7).
+ * @param {{stale?: number, lock?: string}} [o] `stale` 묵음 한도(기본 30초) · `lock` 잠금 파일 자리(기본 `<file>.lock`)
+ *   — 입구 임대는 `push/<uuid>.lease` 를 그대로 잠금 파일로 쓴다(새 원시를 안 만든다, race S2).
+ */
+function fileLock(file, deadline = 0, o = {}) {
+  const lock = o.lock || `${file}.lock`;
+  const staleMs = Number(o.stale) > 0 ? Number(o.stale) : LOCK_STALE_MS;
+  // 토큰 끝의 난수 — 같은 프로세스·같은 ms 에 잡는 둘(사람 push 와 자동 바퀴, C7)이 서로의 잠금을 제 것으로 읽지 않게.
+  //   앞 세 줄(pid·호스트·ms)은 그대로라 `lockStaleText` 와 옛 판이 읽는 모양이 안 바뀐다.
+  const token = `${process.pid}\n${os.hostname()}\n${Date.now()}\n${crypto.randomBytes(4).toString('hex')}`;
   let broke = false;
   // deadline 0 = 첫 시도(jsonFileUpdate) — §5.2 대로 **상한 없이** 기다린다(묵은 잠금은 30초에 걷힌다). 2초(LOCK_TRIES)
   // 에서 포기하면 그 쓰기는 `nolock` 으로 되풀이 없이 사라진다 — 창 열둘이 한 파일을 두드리는 관문에서 599/600(2026-09-16 실측).
@@ -252,7 +262,7 @@ function fileLock(file, deadline = 0) {
       if (e?.code !== 'EEXIST') return null;
     }
     if (!broke) {
-      const stale = lockStaleText(lock);
+      const stale = lockStaleText(lock, staleMs);
       if (stale !== null) {
         broke = true;             // 한 번만 걷고 다시 잡는다
         lockBreakStale(lock, stale);
@@ -799,6 +809,61 @@ function encodeShot(buf) {
     + '여러 장을 한 판에 몰아 넣으면 어차피 문서에서 글자가 안 읽힙니다.');
 }
 
+/**
+ * 영상 썸네일 판(스프라이트) — 열람 셸의 시크바가 끌 때 「그 자리 그림」을 보이려면 프레임이 있어야 하는데,
+ * 문서 CSP(default-src 'none')·sandbox 아래에서는 셸이 매체를 직접 열어 프레임을 뽑을 수 없다(2026-09-23).
+ * 그래서 **발행 때 이 기계에서** ffmpeg 로 `step` 초마다 한 장씩 뽑아 한 판(10열 × 140px)으로 붙이고 cwebp 로
+ * 굳혀(encodeShot — 장당 상한 ASSET_MAX_ONE 그대로) 자산의 `thumbs` 칸에 data: 로 싣는다. 렌더러가
+ * `<video data-thumbs…>` 로 내고 셸(assets/reader-video.js)이 **읽기만** 해서 자기 층에 그린다 — 발행물 바이트의
+ * 일부이지 실행 코드가 아니다(문서 CSP img-src data: 안). ffmpeg/ffprobe 가 없으면 **판 없이 간다**(힌트 한 줄) —
+ * 영상 자체는 그대로 올라가고 시크바는 그림 없이 선다. 장당 상한을 넘으면 간격을 두 배로 한 번 더 시도한다.
+ */
+const THUMB_W = 140, THUMB_COLS = 10;
+function videoThumbs(fpath, stepSec = 1) {
+  const probe = spawnSync('ffprobe', ['-v', 'error', '-select_streams', 'v:0',
+    '-show_entries', 'stream=width,height:format=duration', '-of', 'json', fpath], { encoding: 'utf8' });
+  if (probe.error && probe.error.code === 'ENOENT') {
+    ASSET_HINTS.push(`영상 「${path.basename(fpath)}」: ffprobe/ffmpeg 가 없어 썸네일 판 없이 올립니다(brew install ffmpeg).`);
+    return null;
+  }
+  let meta = null;
+  try { meta = JSON.parse(String(probe.stdout || '')); } catch (e) { meta = null; }
+  const dur = parseFloat(meta && meta.format && meta.format.duration);
+  const sw = Number(meta && meta.streams && meta.streams[0] && meta.streams[0].width);
+  const sh = Number(meta && meta.streams && meta.streams[0] && meta.streams[0].height);
+  if (!(dur > 0) || !(sw > 0) || !(sh > 0)) return null;
+  // 판의 세로가 긴 변 상한(ASSET_LONG_EDGE)을 넘으면 encodeShot 이 줄여 버려 칸 좌표가 어긋난다 — 가로는 10열 × 140 = 1400
+  // 으로 딱 상한이고, 세로는 **간격을 늘려** 줄 수를 맞춘다(한 칸 높이 ≈ 140 × 세로/가로, 짝수). 실제 치수는 뽑은 뒤 다시 잰다.
+  const frameH = Math.max(2, 2 * Math.round(THUMB_W * sh / sw / 2));
+  const fits = (step) => Math.ceil(Math.max(1, Math.ceil(dur / step)) / THUMB_COLS) * frameH <= ASSET_LONG_EDGE;
+  for (const mul of [1, 2, 4, 8, 16, 32]) {
+    const step = stepSec * mul;
+    if (!fits(step)) continue;
+    const n = Math.max(1, Math.ceil(dur / step));
+    const rows = Math.ceil(n / THUMB_COLS);
+    const r = spawnSync('ffmpeg', ['-v', 'error', '-i', fpath,
+      '-vf', `fps=1/${step},scale=${THUMB_W}:-2,tile=${THUMB_COLS}x${rows}`,
+      '-frames:v', '1', '-f', 'image2pipe', '-vcodec', 'png', '-'], { maxBuffer: IMAGE_MAX_DOWNLOAD });
+    if (r.error && r.error.code === 'ENOENT') {
+      ASSET_HINTS.push(`영상 「${path.basename(fpath)}」: ffmpeg 가 없어 썸네일 판 없이 올립니다(brew install ffmpeg).`);
+      return null;
+    }
+    if (r.status !== 0 || !r.stdout || !r.stdout.length) {
+      ASSET_HINTS.push(`영상 「${path.basename(fpath)}」: 썸네일 판을 못 만들어 없이 올립니다 — ${String(r.stderr).slice(0, 120)}`);
+      return null;
+    }
+    const d = imageDims(r.stdout);
+    if (!d || d.w > ASSET_LONG_EDGE || d.h > ASSET_LONG_EDGE || d.h % rows !== 0) continue;   // 추정이 빗나갔다 — 간격을 늘려 다시
+    let enc;
+    try { enc = encodeShot(r.stdout); } catch (e) { continue; }   // 장당 상한 초과 — 간격을 늘려 한 번 더
+    const h = d.h / rows;
+    ASSET_HINTS.push(`영상 「${path.basename(fpath)}」 썸네일 판 ${n}장(${step}초 간격) ${(enc.length / 1024).toFixed(0)}KB.`);
+    return { data: 'data:image/webp;base64,' + enc.toString('base64'), n, cols: THUMB_COLS, w: THUMB_W, h, step };
+  }
+  ASSET_HINTS.push(`영상 「${path.basename(fpath)}」: 썸네일 판이 장당 상한을 넘어 없이 올립니다(영상이 깁니다).`);
+  return null;
+}
+
 function cwebpMissing() {
   return new Error('cwebp 가 없어 자산을 계약 규격(WebP)으로 굳힐 수 없습니다.\n'
     + `libwebp 를 설치하세요(${installHint('webp')}). `
@@ -855,12 +920,88 @@ 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, thumbs: given, ...rest } = meta;
+      /* 썸네일 판 — 실물(data:image/…)이면 그대로, `null` 이면 뺀 것(서버 report_carry_assets 와 같은 뜻).
+       * 되읽기 표식('(생략 — NB)')은 실물이 아니다 — 판이 있는 것으로 치면 표식이 그대로 발행돼 거절된다. */
+      const optOut = given === null;
+      const real = !!(given && typeof given.data === 'string' && given.data.startsWith('data:image/'));
+      const slot = (t) => (optOut ? { thumbs: null } : (t && typeof t === 'object' ? { thumbs: t } : {}));
+      if (Number(rest.ref) > 0) {
+        // 이미 올린 영상 — 판이 실물이 아니면 file 에서 새로 굽는다(영상은 다시 안 올린다). file 도 없으면 받은
+        // 표식을 그대로 보낸다 — 서버가 같은 영상(ref)의 저장된 판을 잇는다.
+        const t = (optOut || real) ? given : ((fpath ? videoThumbs(String(fpath)) : null) || given);
+        out.push({ ...rest, role: 'video', provider: 'r2', ...slot(t) });
+        continue;
+      }
+      if (!fpath) {
+        throw new Error(`영상 「${rest.id ?? '(id 없음)'}」 에 file(로컬 mp4 경로)도 ref 도 없습니다.\n`
+          + 'file 에 절대경로를 주면 올리고 번호를 받아 싣습니다.');
+      }
+      const ref = await uploadVideo(tenant, readLocalVideo(String(fpath)), String(fpath));
+      // 새로 올린 영상 — 표식이 가리키던 옛 판은 다른 장면이라 버리고 이 파일에서 굽는다.
+      const t = (optOut || real) ? given : videoThumbs(String(fpath));
+      out.push({ ...rest, role: 'video', provider: 'r2', ref, mime: 'video/mp4', ...slot(t) });
+      continue;
+    }
     if (!a?.source && !fpath) {
       // 둘 다 없으면 예전 경로 그대로 — data 를 그대로 통과시킨다(판 A 하위호환).
       // get_report 가 준 표식('(생략 — NB)')과 bytes 칸의 처리(2026-08-27, 운영 #34):
@@ -957,9 +1098,31 @@ function warnOnce(key, msg) {
   try { process.stderr.write(`genetics: ${msg}\n`); } catch { /* 그것마저 막히면 넘어간다 */ }
 }
 
+/**
+ * 【선언】 요청 하나의 시간 상한 — **바탕 120초**(DESIGN-session-delta-sync §2.10 · race S1 · C7). 시험은 120초를 못 기다려
+ * `GENETICS_API_TIMEOUT_MS` 로 갈아 끼운다 — 하한 1초(`GENETICS_OBSERVE_MS` 와 같은 규율: 실수로 0 이 들어가 모든 요청이
+ * 즉시 끊기지 않게).
+ */
+const API_TIMEOUT_MS = Math.max(1000, Number(cfg.GENETICS_API_TIMEOUT_MS) || 120_000);
+/**
+ * 【선언】 업링크의 **바닥 속도** 32KB/s(=256kbit/s). 상한을 벽시계 하나로 두면 **큰 봉투가 영영 못 올라간다** —
+ * 조각 하나가 6MiB 라 120초는 52KB/s(=419kbit/s) 이상을 요구했고, 그보다 느린 링크(모바일 테더링·혼잡한 VPN)에서는
+ * 모든 시도가 abort 된 뒤 조각 1부터 다시 갔다(호환 검토 1-B — 상한이 없던 전에는 느려도 끝내 성공했다).
+ */
+const API_MIN_BPS = 32 * 1024;
+/**
+ * 이만큼 보내는 요청의 시간 상한 — 바탕 + `bytes / 바닥속도`. **한 곳에서 정한다**: 입구 임대의 묵음 한도
+ * `LEASE_QUIET_MS` 가 「가장 큰 조각의 상한 + 60초」라, 이 함수를 고치면 임대가 따라온다.
+ */
+function apiTimeoutFor(bytes) {
+  const b = Number(bytes) > 0 ? Number(bytes) : 0;
+  return API_TIMEOUT_MS + Math.ceil(b / API_MIN_BPS) * 1000;
+}
+
 /**
  * @param {object} [opts]
  * @param {'publish'|'release'} [opts.scope] 발행 갈래면 `'publish'` — 키를 먼저 쥔다(credential 주석). `'release'` 는 사람 먼저(§5.6).
+ * @param {number} [opts.timeout_ms] 이 요청의 시간 상한(기본 `API_TIMEOUT_MS`)
  * @param {Record<string,string>} [opts.headers] 더 실을 머리(자동 올리기의 X-Genetics-* 셋 — §4.3)
  * 실패는 던지는 Error 에 `status`·`code`·`retry_after` 가 붙는다(반환 계약 `r.data` 는 그대로).
  */
@@ -977,17 +1140,43 @@ async function api(method, pathname, body, opts = {}) {
       + `${ENV_FILE} 의 GENETICS_API_BASE 를 확인하세요(https 여야 합니다). `
       + '주소를 바꾸라는 안내를 받았다면 의심할 것.');
   }
+  /*
+   * ★ **요청마다 시간 상한을 건다**(DESIGN-session-delta-sync §2.10 · race S1 · C7). 전에는 signal 이 없어 걸린 연결 하나가
+   *   그 호출을 영영 붙들었다 — 자동 올리기의 입구 임대는 「진전이 없으면 `LEASE_QUIET_MS`(= 이 상한 + 60초) 뒤 남이 걷는다」에
+   *   기대므로, 상한이 없으면 걸린 주인과 걷은 새 주인이 겹친다. 상한은 몸통 읽기까지 덮는다(같은 signal).
+   *   넘으면 status 0 · code `timeout` 인 오류다 — 자동 길은 망 사정과 같은 지수 백오프를 탄다.
+   */
+  const limitMs = Number(opts.timeout_ms) > 0 ? Number(opts.timeout_ms) : API_TIMEOUT_MS;
+  let capsHeader = null;
+  let minHeader = null;
   const send = async (c) => {
-    const res = await fetch(BASE + pathname, {
-      method,
-      // opts.headers 는 자동 올리기의 머리 셋(§4.3)이 쓴다 — 자격·형식 머리는 덮지 못한다.
-      headers: { ...(opts.headers || {}), Authorization: `Bearer ${c.token}`, 'Content-Type': 'application/json' },
-      body: body === undefined ? undefined : JSON.stringify(body),
-    });
-    LAST_MIN_CLIENT = res.headers.get('x-genetics-min-client') || LAST_MIN_CLIENT;   // §5.8 — 반환 계약은 그대로
-    const text = await res.text();
+    const signal = AbortSignal.timeout(limitMs);
+    const timedOut = (e) => (e?.name === 'TimeoutError' || (e?.name === 'AbortError' && signal.aborted)
+      ? Object.assign(new Error(`서버가 ${Math.round(limitMs / 1000)}초 안에 답하지 않았습니다(${method} ${pathname}).`), { status: 0, code: 'timeout' })
+      : e);
+    let res, text;
+    try {
+      res = await fetch(BASE + pathname, {
+        method,
+        // opts.headers 는 자동 올리기의 머리 셋(§4.3)이 쓴다 — 자격·형식 머리는 덮지 못한다.
+        headers: { ...(opts.headers || {}), Authorization: `Bearer ${c.token}`, 'Content-Type': 'application/json' },
+        body: body === undefined ? undefined : JSON.stringify(body),
+        signal,
+      });
+      LAST_MIN_CLIENT = res.headers.get('x-genetics-min-client') || LAST_MIN_CLIENT;   // §5.8 — 반환 계약은 그대로
+      capsHeader = res.headers.get('x-genetics-session-caps');                          // §6.1 — 덧붙임 능력 광고(C8)
+      minHeader = res.headers.get('x-genetics-min-client');                             // 「우리 PHP 가 답했다」의 표(아래 capsNote)
+      text = await res.text();
+    } catch (e) { throw timedOut(e); }
     let data;
-    try { data = JSON.parse(text); } catch { throw Object.assign(new Error(`응답을 해석하지 못했습니다(HTTP ${res.status}): ${text.slice(0, 300)}`), { status: res.status }); }
+    // `not_json` — 봉투가 `post_max_size` 를 넘으면 PHP 가 본문을 버리고 200·`text/html` 을 낸다. 덧붙임은 그 표로 조각을 더 쪼갠다(C8).
+    try { data = JSON.parse(text); } catch { throw Object.assign(new Error(`응답을 해석하지 못했습니다(HTTP ${res.status}): ${text.slice(0, 300)}`), { status: res.status, not_json: true }); }
+    /*
+     * ★ 능력 광고는 **JSON 으로 읽힌 응답에서만** 잰다(§6.1 · C8). 봉투가 `post_max_size` 를 넘으면 PHP 가 본문을 버리고
+     *   `text/html` + 경고 덩어리를 200 으로 내는데 머리가 하나도 안 실린다(dev 실측) — 그 갈래는 위 `JSON.parse` 에서
+     *   먼저 죽으므로 여기 안 온다. 「광고가 없으니 옛 서버」를 그 응답으로 적으면 조용히 덧붙임이 꺼진다.
+     */
+    capsNote(pathname, res.status, capsHeader, data, !!minHeader);
     return { ok: res.ok && data.ok !== false, status: res.status, data };
   };
 
@@ -1021,9 +1210,18 @@ async function api(method, pathname, body, opts = {}) {
     // 자동 올리기의 백오프(§5.5 7)가 상태·code·retry_after 로 갈린다 — 메시지는 그대로, 칸만 붙인다.
     // `auto_upload_at` 은 409 `too_old`(관문 11)가 **서버의 동의 시각**을 알려 주는 칸이다 — 그것이 곧 클라이언트가
     // 못 받은 하한이라, 받아 두면 같은 거절을 24시간마다 되풀이하지 않는다(개인정보 N3).
+    // `coords` — 409 `behind`·`base_moved` 가 싣는 서버 좌표(C3·C4). 따라잡기(C8)가 읽는다.
+    // `why` — 덧붙임의 409 `no_base`·`rebake`·`base_lost` 가 가르는 칸(C4). §5.1 의 다음 동작이 이것으로 갈린다.
+    // `caps` — 그 **거절 응답**이 실은 능력 광고. 덧붙임의 400·404 가 「서버가 모른다」인지 「이 요청을 거절했다」인지 가른다(C8).
+    const coordKeys = ['rev', 'bytes', 'raw_off', 'raw_key_id', 'raw_win_mac'].filter((k) => k in (r.data || {}));
+    // `comment` — 완료 보고의 400 이 **이미 남긴 글**을 함께 싣는다(근거가 없어 검수로 못 간 경우). 버리면 글 번호를 잃는다(2026-09-26 검토).
     throw Object.assign(new Error(r.data.error || `HTTP ${r.status}`),
       { status: r.status, code: String(r.data.code || ''), retry_after: Number(r.data.retry_after) || 0,
-        auto_upload_at: typeof r.data.auto_upload_at === 'string' ? r.data.auto_upload_at : '' });
+        caps: String(capsHeader || ''),
+        auto_upload_at: typeof r.data.auto_upload_at === 'string' ? r.data.auto_upload_at : '',
+        why: typeof r.data.why === 'string' ? r.data.why : '',
+        ...(r.data.comment && typeof r.data.comment === 'object' ? { comment: r.data.comment } : {}),
+        ...(coordKeys.length ? { coords: Object.fromEntries(coordKeys.map((k) => [k, r.data[k]])) } : {}) });
   }
   return r.data;
 }
@@ -1269,7 +1467,7 @@ const REPORT_DATA = {
                  + '· `marg`: {why, key, advice} — **좌측 여백 주석 단. 이것이 본체다.** '
                  + '없으면 두 단 본문이 한 단으로 서고, 문서는 「문서처럼 꾸민 웹페이지」가 된다. '
                  + 'why 는 **독자가 실제로 던질 질문**(「무엇을 조치해야 하는가?」), '
-                 + 'key 는 이 절에서 하나만 가져간다면 그것, advice 는 어디를 참조하라는 것. '
+                 + 'key 는 이 절에서 하나만 가져간다면 그것, advice 는 더 볼 곳 — 명사구(「03절 대조표」)나 사물이 주어인 단문(「판정 기준은 부록 1에 있음」), 독자에게 시키는 꼴(「~할 것」「~ 참조」)은 아님. '
                  + '채우려고 넣으면 안 넣느니만 못하다.\n'
                  + '· `lede`: 절 간지의 도입문 — 다루는 범위와 **다루지 않는 범위**.\n'
                  + '· `sub`: 차례 행에 붙는 한 줄 설명. `short`: 측면 색인 레일용 짧은 이름.\n'
@@ -1366,7 +1564,7 @@ const REPORT_DATA = {
             type: 'string',
             description: 'role: figure 의 **그림 캡션.** 「그림 4-1」 번호 뒤에 붙는다(번호는 자리가 '
               + '매기므로 적지 않는다). 무엇을 보이는 화면인지 한 문장으로 — 본문이 이미 말한 것을 '
-              + '되풀이하지 말고 **이 화면에서 무엇을 보라는 것인지**를 적는다.',
+              + '되풀이하지 말고 **이 화면에서 독자가 볼 자리**를 명사형으로 적는다(「8.0 행의 두 날짜와 8.4 행의 종료일」).',
           },
           source_text: {
             type: 'string',
@@ -1374,18 +1572,49 @@ 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 자신에게는 뜻이 없다.',
+          },
+          // 영상 썸네일 판(d9dde6f7) — 렌더러가 읽는 칸(gazette.py `<video data-thumbs…>`)이라 계약에 적는다(tools/contract-drift.py).
+          thumbs: {
+            type: ['object', 'null'],
+            description: '`provider: r2`(영상) 자산의 **시크바 썸네일 판** — 열람 화면에서 시크바를 끌 때 그 자리 그림을 보인다. '
+              + '**보통은 적지 않는다** — `file` 에 로컬 mp4 를 주면 이 도구가 발행 때 ffmpeg 로 굽는다(ffmpeg 가 없으면 판 없이 간다). '
+              + '`null` 이면 판을 뺀다. 되읽은 판을 고쳐 되돌려 보낼 때는 받은 값을 그대로 두면 서버가 저장된 판을 잇는다.',
           },
           alt: { type: 'string', description: '설명적 대체 텍스트 — 접근성 계약. 그림과 함께 다닌다' },
           origin: { type: 'string', description: '생성 job 식별자·.mmd 원본 경로·제공자 이름' },
@@ -1424,12 +1653,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 주소(허용 호스트 목록 안). **이 도구의 프로세스가** '
@@ -1459,8 +1683,8 @@ const REPORT_DATA = {
           symptom: { type: 'string' },
           cause: { type: 'string' },
           fix: { type: 'string' },
-          how_to_check: { type: 'string' },
-          remaining: { type: 'string', description: '고객 확인이 필요한 사항(선택)' },
+          how_to_check: { type: 'string', description: '고객이 화면에서 볼 수 있는 결과 — 어디를 열면 무엇이 보이는지(주어는 화면·값, 독자에게 시키는 문장 아님)' },
+          remaining: { type: 'string', description: '아직 닫히지 않은 것 — 미확인·미결인 사실과 운영에 아직 안 나간 우리 작업. 독자에게 부탁할 것은 open_items 로(선택)' },
           source_url: { type: 'string', description: 'http(s) 제보 원본 링크(선택)' },
           quotes: {
             type: 'array',
@@ -1511,6 +1735,16 @@ const REPORT_DATA = {
  *     심볼릭 링크라 리터럴 경로로 만들면 엉뚱한 디렉터리에 놓인다(그렇게 세 번 틀렸다)
  */
 
+/**
+ * 클라이언트 검열 **규칙판**(DESIGN-session-delta-sync §2.8 · C6). 사람이 올리는 상수다 — 검열 **출력 바이트**를 바꾸는
+ * 원천(`mcp/scrub-rev.lock` 의 목록: SECRET_SHAPES·MASK·DROP_TYPES·KEEP_ATTACHMENT_PREFIX·isKeptAttachment·
+ * maskHomeInPick·maskSecrets·maskDeep·relHome·scrubTranscript)을 고치면 이 판을 올리고 lock 에 새 줄을 덧붙인다.
+ * smoke 의 「규칙판 lock」 절이 원문 지문(주석·공백 걷은 토큰)과 판을 대조한다 — 원천이 바뀌었는데 판이 그대로면 빨갛다.
+ * ⚠ 서버 `AGENT_SCRUB_REV`(r…)와는 **다른 이름공간**이다(m…). 전체 PUT 은 이 값을 좌표의 규칙판으로 싣고, 서버는 행에
+ *   자기 판을 적어 응답 `scrub_rev` 로 돌려준다 — 대응표는 둘 다 적는다(scrub_rev · srv_scrub_rev).
+ */
+const SCRUB_REV = 'm1';
+
 /** 비밀 **모양** — `www/portal/lib/agent_session.php` 의 `agent_secret_shapes()` 와 **같아야 한다.**
  *  PHP 와 JS 는 코드를 공유할 수 없으므로 `mcp/smoke.mjs` 가 두 목록의 이름을 대조한다. */
 const SECRET_SHAPES = [
@@ -1630,10 +1864,22 @@ function cwdMode(counts) {
   return best;
 }
 
-function scrubTranscript(raw) {
+/**
+ * @param {string} raw  원본 전사의 **줄 경계에서 끊긴** 텍스트(부르는 쪽이 마지막 `\n` 까지 자른다 — §2.1)
+ * @param {{delta?: boolean, hist?: Object<string, number>}} [opts]
+ *   `delta` — 변화분 모드(§2.2): 남는 줄이 0이어도 예외 대신 `{jsonl:'', lines:0, …}`. 전체 모드의 「빈 트랜스크립트」 예외는 그대로.
+ *   `hist`  — 앞 구간까지 센 `cwd_hist`(raw cwd → 셈). 이어 세면 `cwd`·`cwd_raw`·`cwd_hist` 가 전체를 한 번에 센 것과 같다.
+ * 출력 줄은 **그 줄만의 함수**다 — 그래서 [0,a)·[a,b)·… 로 잘라 검열한 jsonl 을 이으면 전체를 한 번에 검열한 바이트와 같다.
+ * `cwd_hist` 는 **자르지 않은 전부**다(.genetics-private 판정이 열쇠 전부를 본다 — 예전 상위 64 자르기는 65위 아래를 흘렸다).
+ */
+function scrubTranscript(raw, opts = {}) {
+  const delta = opts?.delta === true;
   const out = [];
-  const cwds = new Map();
-  const cwdsRaw = new Map();   // 폴더 identity 는 realpath 뒤에 잰다(§3.2) — 이 기계 안에서만 쓰고 보내지 않는다
+  // 폴더 identity 는 realpath 뒤에 잰다(§3.2) — 이 기계 안에서만 쓰고 보내지 않는다
+  // ⚠ 동수 판정은 「처음 본 차례」를 쓴다(cwdMode). `Object.fromEntries`·JSON 왕복은 **정수 모양 열쇠**를 앞으로 옮겨 그 차례를
+  //   흐트러뜨린다 — 실제 cwd 는 절대 경로라 그런 열쇠가 안 생기지만, 대응표의 hist 를 이어 셀 때(C8) 이 전제에 기대고 있다.
+  const cwdsRaw = new Map(Object.entries(opts?.hist && typeof opts.hist === 'object' ? opts.hist : {})
+    .filter(([k, v]) => k && Number.isInteger(v) && v > 0));
   let redacted = 0, dropped = 0, no = 0;
   for (const line of raw.split('\n')) {
     no++;
@@ -1649,8 +1895,6 @@ function scrubTranscript(raw) {
      * (그것도 152줄을 싣는다) 버린 뒤에 세면 표본이 **조용히** 줄어든다. 순서가 곧 방어다.
      */
     if (typeof r.cwd === 'string' && r.cwd) {
-      const k = relHome(r.cwd);
-      cwds.set(k, (cwds.get(k) || 0) + 1);
       cwdsRaw.set(r.cwd, (cwdsRaw.get(r.cwd) || 0) + 1);
     }
     if (DROP_TYPES.has(r.type) && !isKeptAttachment(r)) { dropped++; continue; }
@@ -1703,11 +1947,15 @@ function scrubTranscript(raw) {
     redacted += extra;
     out.push(JSON.stringify(safe));
   }
-  if (!out.length) throw new Error('빈 트랜스크립트입니다.');
-  // `cwds_raw` 는 **이 대화가 거쳐 간 자리 전부**다(빈도순). 최빈 자리 하나만 보면 세션의 일부가
-  // `.genetics-private` 폴더에서 돌아도 그 대화가 통째로 올라간다(개인정보 검토 m1).
-  const rawAll = [...cwdsRaw.entries()].sort((a, b) => b[1] - a[1]).map(([k]) => k).slice(0, 64);
-  return { jsonl: out.join('\n') + '\n', lines: out.length, dropped, redacted, cwd: cwdMode(cwds), cwd_raw: cwdMode(cwdsRaw), cwds_raw: rawAll };
+  if (!out.length && !delta) throw new Error('빈 트랜스크립트입니다.');
+  // 집 경로를 접은 셈은 원문 셈에서 낸다 — 이어 센 hist 에서도 전체와 같은 최빈 자리가 나온다(처음 본 차례도 같다).
+  const cwds = new Map();
+  for (const [k, v] of cwdsRaw) { const h = relHome(k); cwds.set(h, (cwds.get(h) || 0) + v); }
+  // `cwds_raw` 는 **이 대화가 거쳐 간 자리 전부**다(빈도순 · 자르지 않는다). 최빈 자리 하나만 보면 세션의 일부가
+  // `.genetics-private` 폴더에서 돌아도 그 대화가 통째로 올라간다(개인정보 검토 m1). 판정의 정본은 `cwd_hist` 의 열쇠다.
+  const rawAll = [...cwdsRaw.entries()].sort((a, b) => b[1] - a[1]).map(([k]) => k);
+  return { jsonl: out.length ? out.join('\n') + '\n' : '', lines: out.length, dropped, redacted,
+           cwd: cwdMode(cwds), cwd_raw: cwdMode(cwdsRaw), cwds_raw: rawAll, cwd_hist: Object.fromEntries(cwdsRaw) };
 }
 
 /*
@@ -2015,6 +2263,768 @@ function splitAtLines(text, max) {
   return out.length ? out : [text];
 }
 
+/* ── 좌표·기계 키·대응표 (DESIGN-session-delta-sync §2.1·§2.9·§2.11 · C6) ────────────────────────────
+ *
+ * 이음매는 **원본 전사의 바이트 오프셋**이다. `raw_off` 는 늘 마지막 `\n` 바로 뒤에 멈춘다(쓰는 중인 반쪽 줄은 다음 바퀴).
+ * 기반의 정체는 기기 이름이 아니라 **기계 키의 지문**이 보증한다 — `deviceId` 는 유일하지도 안정적이지도 않다.
+ *   · 키: `<설정 디렉터리>/push/_key` — 0600, 32바이트 난수, **처음 FULL 을 보낼 때** 만든다(모듈을 불러오는 것만으로는 안 만든다
+ *     — 시험들이 진짜 HOME 인 채 이 파일을 import 한다).
+ *   · raw_key_id = HMAC(key, 'genetics-push/key-id') 앞 16hex — 이 기계의 좌표인지 가르는 이름표일 뿐이다.
+ *   · raw_head_mac = HMAC(key, 원본[0, min(64KB, to)))  ← 64KB 보다 짧은 전사는 [0,to) 다(덧붙임이 같은 규칙으로 잰다).
+ *   · raw_win_mac  = HMAC(key, 원본[max(0, to−64KB), to))
+ *   · 원본 바이트의 맨 sha 는 **서버에 안 보낸다**(privacy) — 서버는 키가 없어 지문으로 원문을 대조해 볼 수 없다.
+ * 대응표 `<설정 디렉터리>/push/<uuid>.json` 은 **좌표 캐시일 뿐**이다 — 정책 상태(간격·백오프·막음)는 색인 `auto.*` 에 그대로 둔다.
+ * 자리는 자격 파일 옆(`dirname(CRED_FILE)`, 색인과 같은 규칙) — `GENETICS_CRED` 하나로 시험이 격리된다. `GENETICS_PUSH_DIR` 는
+ * 같은 프로세스 안에서 자리를 갈아 끼우는 시험용 손잡이다(부를 때마다 읽는다).
+ */
+const PUSH_MAC_WIN = 64 * 1024;
+/** 거쳐 간 자리(cwd_hist 열쇠)가 이보다 많으면 자동 올리기는 닫힌 쪽으로 멈춘다(§2.2 `cwd_hist_overflow`). */
+const CWD_HIST_MAX = 4096;
+const PUSH_FULL_LOG_MAX = 16;
+
+function pushDir() {
+  return process.env.GENETICS_PUSH_DIR || path.join(path.dirname(CRED_FILE), 'push');
+}
+
+let pushKeyMemo = null;      // { file, key } — 자리가 바뀌면(시험) 다시 읽는다
+/**
+ * 기계 키 — 없으면 만든다(`create`). 못 만들거나 못 읽으면 **null**: 부르는 쪽은 좌표 없이 옛 봉투로 보낸다(예외를 안 낸다).
+ * 만들기는 임시 파일(0600)을 다 채운 뒤 `link` 로 건다 — 이미 있으면 EEXIST 로 지고 남의 키를 읽는다(경합에서 반쪽 키를 안 본다).
+ */
+function pushKey(create = true) {
+  const dir = pushDir();
+  const file = path.join(dir, '_key');
+  if (pushKeyMemo && pushKeyMemo.file === file) return pushKeyMemo.key;
+  let key = null;
+  try { key = fs.readFileSync(file); } catch (e) {
+    if (e?.code !== 'ENOENT') warnOnce('push-key-read', `기계 키(${file})를 못 읽어 좌표 없이 올립니다: ${e?.code || e}`);
+    if (e?.code !== 'ENOENT' || !create) return null;
+  }
+  if (!key) {
+    const tmp = `${file}.tmp-${process.pid}-${crypto.randomBytes(4).toString('hex')}`;
+    try {
+      fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+      const fd = fs.openSync(tmp, 'wx', 0o600);
+      try { fs.fchmodSync(fd, 0o600); fs.writeSync(fd, crypto.randomBytes(32)); fs.fsyncSync(fd); } finally { fs.closeSync(fd); }
+      try { fs.linkSync(tmp, file); } catch (e) { if (e?.code !== 'EEXIST') throw e; }
+    } catch (e) {
+      // 좌표 없이도 올리기는 된다(개인정보 쪽으로는 안전한 방향) — 다만 말없이 영영 꺼지지 않게 한 줄은 남긴다
+      warnOnce('push-key-make', `기계 키를 못 만들어 좌표 없이 올립니다(${dir}): ${e?.code || e}`);
+      return null;
+    } finally { try { fs.rmSync(tmp, { force: true }); } catch { /* */ } }
+    try { key = fs.readFileSync(file); } catch { return null; }
+  }
+  if (key.length !== 32) {                 // 망가진 키는 안 쓴다(갈아 끼우지도 않는다 — 좌표 없이 FULL 로 산다)
+    warnOnce('push-key-bad', `기계 키(${file})가 32바이트가 아니라 좌표 없이 올립니다 — 지우면 다음 올리기에 새로 만듭니다.`);
+    return null;
+  }
+  // 백업에서 되살리거나 손으로 복사한 키는 0644 일 수 있다 — 쓰기 전에 조인다(키·자리 모두). 못 조여도 올리기는 막지 않는다.
+  for (const [p, want] of [[file, 0o600], [dir, 0o700]]) {
+    try {
+      if (fs.statSync(p).mode & 0o077) { fs.chmodSync(p, want); warnOnce(`push-key-mode:${p}`, `${p} 의 권한이 넓어 ${want.toString(8)} 으로 조였습니다.`); }
+    } catch { /* */ }
+  }
+  pushKeyMemo = { file, key };
+  return key;
+}
+function pushMac(key, buf) { return crypto.createHmac('sha256', key).update(buf).digest('hex'); }
+function pushKeyId(key) { return pushMac(key, 'genetics-push/key-id').slice(0, 16); }
+
+/** FULL 이 싣는 `raw` 좌표 — 서버 `agent_session_coords_parse()` 의 모양(`to` 는 JSON 정수 · MAC 은 소문자 64hex). */
+function pushCoords(key, bytes, to) {
+  return {
+    key_id: pushKeyId(key), to,
+    head_mac: pushMac(key, bytes.subarray(0, Math.min(PUSH_MAC_WIN, to))),
+    win_mac_to: pushMac(key, bytes.subarray(Math.max(0, to - PUSH_MAC_WIN), to)),
+  };
+}
+
+function ledgerFile(uuid) {
+  const u = String(uuid || '').toLowerCase();
+  return /^[0-9a-f][0-9a-f-]{7,63}$/.test(u) ? path.join(pushDir(), `${u}.json`) : '';
+}
+function ledgerRead(uuid) {
+  const f = ledgerFile(uuid);
+  if (!f) return null;
+  try { const o = JSON.parse(fs.readFileSync(f, 'utf8')); return o && typeof o === 'object' && !Array.isArray(o) ? o : null; } catch { return null; }
+}
+function ledgerWrite(uuid, obj) {
+  const f = ledgerFile(uuid);
+  if (!f) return false;
+  fs.mkdirSync(path.dirname(f), { recursive: true, mode: 0o700 });
+  writeAtomic(f, JSON.stringify(obj), 0o600);      // 임시 파일 + rename(§2.11) — 반쪽 대응표를 읽는 창이 없다
+  return true;
+}
+function ledgerDrop(uuid) {
+  const f = ledgerFile(uuid);
+  if (f) { try { fs.rmSync(f, { force: true }); } catch { /* 캐시일 뿐이다 */ } }
+}
+
+/**
+ * FULL 성공 뒤 대응표를 세운다 — **서버가 그 좌표를 세웠다고 답한 때만**: 응답 `raw_off` 가 정수이고 보낸 `to` 와 같으며,
+ * `raw_win_mac` 이 보낸 값과 **같을 때**(그 MAC 은 이 기계 키의 HMAC 이라, 같으면 서버 행의 key_id 도 이 키다 — 성공 응답에는
+ * key_id 칸이 없어 이것으로 대신 잰다). 칸이 없거나(옛 서버) null 이면(누적 상한·cwd 비밀 모양) 옛 대응표를 **지운다** —
+ * 서버 행의 좌표가 방금 비었거나 원래 없으니 남은 캐시는 거짓 기반이다. 실패해도 올리기는 성공이다(캐시일 뿐).
+ * 좌표 없이 보냈으면(`sent` null — 키 없음·Cursor 의 다 쓴 끝 줄) 역시 지운다.
+ */
+function ledgerAfterFull(uuid, r, sent, ctx) {
+  try {
+    if (!sent || !Number.isInteger(r?.raw_off) || r.raw_off !== sent.to || !Number.isInteger(r?.rev)
+        || r.raw_win_mac !== sent.win_mac_to) {
+      ledgerDrop(uuid);
+      return false;
+    }
+    return ledgerWrite(uuid, {
+      v: 1, uuid, tenant_id: Number(r.tenant_id) || 0, key_id: sent.key_id, rev: r.rev,
+      bytes: Number.isInteger(r.bytes) ? r.bytes : null, raw_off: r.raw_off,
+      head_mac: sent.head_mac, win_mac: sent.win_mac_to, ino: ctx.ino, dev: ctx.dev,
+      /*
+       * ★ `head_len` — **서버가 되돌려 주지 않는 단 하나의 좌표**(C8). 덧붙임 관문은 `raw.head_mac !== row.raw_head_mac` 이면
+       *   base_moved 인데, 성공하면 서버는 **보낸 head_mac 을 그대로 다시 적는다**(agent_session_append.php:241). 즉 그 지문의
+       *   창 길이는 **첫 FULL 의 `to` 로 세션 내내 고정**된다 — 전사가 자란 뒤 `min(64K, raw_off)` 로 다시 재면 첫 FULL 이
+       *   64KB 미만이던 대화는 값이 갈려 **영원히 base_moved** 다(그리고 까닭이 「좌표가 어긋났다」로만 보인다).
+       *   그래서 창 길이를 여기 적고, 덧붙임은 **그 길이로** 재서 대응표의 값과 견준 뒤 **대응표의 값을 싣는다**.
+       */
+      head_len: Math.min(PUSH_MAC_WIN, sent.to),
+      scrub_rev: SCRUB_REV, srv_scrub_rev: typeof r.scrub_rev === 'string' ? r.scrub_rev : null,
+      ck_off: sent.to, ck_sha: ctx.ck_sha, cwd_hist: ctx.cwd_hist,
+      line_off: Number.isInteger(ctx.line_off) ? ctx.line_off : 0,   // [0,raw_off) 의 원본 줄 수 — 변화분 오류의 줄 번호를 사람 말로 되돌린다
+      head: { id: String(r.head_id || ''), ms: Number(r.head_ms) || 0 },
+      /*
+       * ★ **`full_log` 는 여기 없다 — 색인 `auto.full_log` 로 옮겼다**(C8 · C7 이 남긴 숙제 둘의 처방). 까닭 둘:
+       *   ① 이 함수는 좌표가 안 오면 대응표를 **통째로 지운다**(위) — 예산의 재료가 그때마다 0 으로 되돌아갔다.
+       *   ② 이 함수는 **사람의 push 도 안 가린다** — 사람이 두 번 올리면 그 대화의 자동 갱신이 한 시간 멎었다.
+       *   기록하는 자는 이제 **입구 하나**(`autoEntrance`)이고, 기록하는 때는 **진짜 FULL(재기반)이 성공한 때**뿐이다.
+       *   설계 §2.11 의 「정책 상태는 대응표에 두지 않는다 — 색인 `auto.*` 에 둔다」와도 같은 쪽이다.
+       */
+    });
+  } catch { return false; }
+}
+
+/* ── 능력 광고 캐시 (DESIGN-session-delta-sync §6.1 · C8) ────────────────────────────────────────────
+ *
+ * 새 서버는 **세션 블록 맨 앞**에서 `X-Genetics-Session-Caps: append1` 을 한 번 세운다(api.php:1304) — 자격 403 보다도,
+ * `api_out` 을 안 지나는 이진 심박 응답보다도 앞이다. **광고를 본 적 없는 서버에는 덧붙임을 보내지 않는다.**
+ * 판정의 규율 셋(전부 실측이 근거다):
+ *   ① 머리가 있으면 **참**이다 — 그 origin 에 붙박이로 적는다(메모리 + `push/_caps.json`).
+ *   ② 「없으니 옛 서버」는 **세션 경로의 JSON 응답이면서 401 이 아닐 때만** 적는다(1시간). ⚠ **401 에는 광고가 없다**
+ *      (전역 인증이 세션 블록보다 앞이다 — curl 실측) — 401 하나로 거짓을 캐시하면 토큰이 만료된 순간 그 origin 이
+ *      영영 FULL 전용이 된다.
+ *   ③ 5xx·타임아웃·망 오류·JSON 이 아닌 응답은 **아무 판정도 아니다**(위 `api()` 의 주석 — 깨진 200 이 그 갈래다).
+ *   ④ 「없으니 옛 서버」는 **우리 PHP 가 답한 응답**에서만 적는다 — 표는 `X-Genetics-Min-Client`(api.php:214 가 **모든 `/api/*`,
+ *      4xx 포함**에 세운다 · 능력 광고보다 먼저 들어온 머리다). 그 머리도 없는 4xx 는 가장자리(Caddy·WAF·CDN 의 403·404·429)의
+ *      답이라 서버에 대해 아무것도 말하지 않는다(C8 반박 cost③ — 전에는 그 하나가 origin 을 한 시간 FULL 전용으로 만들었다).
+ *   ⑤ `/append` 가 광고 **없이** 400·404·405 로 거절되면(`capsAppendGone`) 그 거짓은 **1시간 동안 광고로도 못 덮는다**. 곧이어 도는
+ *      FULL 의 응답이 광고를 싣기 때문이다 — 안 그러면 「덧붙임만 죽은 서버」(그 경로만 막은 프록시·반쪽 배포)에서 바퀴마다
+ *      `/append` 를 다시 두드리고 FULL 로 내려가기를 되풀이한다(C8 반박 fail F1·equiv ④ — 거짓이 같은 바퀴 안에 지워졌다).
+ * 서버의 규칙판(`scrub_rev`)도 같은 자리에 적는다 — 그것은 **서버마다 하나**인 값이고, 대응표를 잃은 따라잡기가
+ * 덧붙임 봉투를 지으려면 그 값이 있어야 한다(대응표의 `srv_scrub_rev` 가 유일한 재료였다).
+ */
+const CAPS_FALSE_TTL_MS = 3600_000;
+const CAPS_REV_RE = /^[A-Za-z0-9._-]{1,32}$/;
+let capsMemo = null;                 // origin → { append: boolean, at: number, gone?: number, scrub_rev?: string }
+let capsMemoDir = '';                // 그 메모가 읽어 온 자리 — 자리가 바뀌면(시험의 GENETICS_PUSH_DIR) 다시 읽는다
+
+function capsFile() { return path.join(pushDir(), '_caps.json'); }
+function capsOrigin() { try { return new URL(BASE).origin; } catch { return String(BASE || ''); } }
+function capsLoad() {
+  const dir = pushDir();
+  if (capsMemo && capsMemoDir === dir) return capsMemo;
+  capsMemo = new Map();
+  capsMemoDir = dir;
+  try {
+    const o = JSON.parse(fs.readFileSync(capsFile(), 'utf8'));
+    for (const [k, v] of Object.entries(o?.origins && typeof o.origins === 'object' ? o.origins : {})) {
+      if (v && typeof v === 'object' && typeof v.append === 'boolean') {
+        capsMemo.set(k, { append: v.append, at: Number(v.at) || 0, ...(Number(v.gone) > 0 ? { gone: Number(v.gone) } : {}),
+          ...(CAPS_REV_RE.test(String(v.scrub_rev || '')) ? { scrub_rev: String(v.scrub_rev) } : {}) });
+      }
+    }
+  } catch { /* 없거나 깨졌으면 **모르는 것**으로 — 캐시일 뿐이고 모르면 FULL 이다(닫는 쪽) */ }
+  return capsMemo;
+}
+/**
+ * ⚠ **자리를 만들지 않는다.** `push/` 는 기계 키와 대응표의 집이고 그 자리는 FULL 이 키를 만들 때 선다. 광고 하나 때문에 자리를
+ * 만들면 **dry_run 이 자리를 안 만든다**는 계약(C6)이 깨진다 — 광고를 싣는 서버에 dry_run 을 하면 `push/_caps.json` 이 생겼다
+ * (C8 반박 fail F2·cost ⑤ · smoke 의 그 단언은 가짜 서버가 광고를 안 내서 빨개질 수 없었다). 자리가 없으면 메모리로 족하다 —
+ * 첫 FULL 이 키를 만들면 그다음 응답부터 적힌다.
+ */
+function capsSave() {
+  try {
+    if (!fs.existsSync(pushDir())) return;
+    writeAtomic(capsFile(), JSON.stringify({ v: 1, origins: Object.fromEntries(capsLoad()) }), 0o600);
+  } catch { /* 못 적어도 이 프로세스는 메모리 캐시로 산다 */ }
+}
+/**
+ * 응답 하나가 이 서버에 대해 말해 주는 것 — 규율은 위 머리말. `api()` 가 JSON 으로 읽힌 응답에서만 부른다.
+ * @param {boolean} [ours] 우리 PHP 가 답했나(`X-Genetics-Min-Client` 가 있었나) — 거짓이면 「광고 없음」을 판정으로 안 쓴다(④)
+ */
+function capsNote(pathname, status, header, data, ours = true) {
+  if (!/^\/api\/sessions(\/|$)/.test(String(pathname || ''))) return;
+  const org = capsOrigin();
+  if (!org) return;
+  const m = capsLoad();
+  const was = m.get(org) || null;
+  const has = String(header || '').split(/[\s,]+/).filter(Boolean).includes('append1');
+  // 서버 판(`scrub_rev`)은 좌표를 실은 전체 PUT 의 성공 응답이 준다 — 모양이 맞을 때만 받는다.
+  const rev = typeof data?.scrub_rev === 'string' && CAPS_REV_RE.test(data.scrub_rev) ? data.scrub_rev : (was?.scrub_rev || '');
+  const s = Number(status) || 0;
+  const now = Date.now();
+  // ⑤ `/append` 가 광고 없이 거절된 뒤 1시간은 광고도 그 거짓을 못 덮는다(그 시각이 `gone`).
+  const goneHold = was?.append === false && Number(was.gone) > 0 && now - Number(was.gone) < CAPS_FALSE_TTL_MS;
+  let next = null;
+  if (has) next = goneHold ? null : { append: true, at: now };
+  else if (ours && s !== 401 && ((s >= 200 && s < 300) || (s >= 400 && s < 500))) {
+    next = { append: false, at: now, ...(goneHold ? { gone: Number(was.gone) } : {}) };
+  }
+  if (!next) { if (rev && rev !== was?.scrub_rev) { m.set(org, { ...(was || { append: false, at: 0 }), scrub_rev: rev }); capsSave(); } return; }
+  if (rev) next.scrub_rev = rev;
+  // 같은 답이 되풀이되면 파일을 다시 안 적는다 — 거짓은 1시간마다 한 번만 새로 적는다(그 TTL 이 새로 올라간 서버를 다시 본다).
+  if (was && was.append === next.append && was.scrub_rev === next.scrub_rev
+      && (next.append === true || now - was.at < CAPS_FALSE_TTL_MS)) return;
+  m.set(org, next);
+  capsSave();
+}
+/** 이 서버가 덧붙임을 받는다고 **광고했나** — 모르면 거짓이다(닫는 쪽: FULL). */
+function capsAppend() { return capsLoad().get(capsOrigin())?.append === true; }
+/** 이 서버의 규칙판(`AGENT_SCRUB_REV`) — 못 봤으면 ''. 덧붙임 봉투의 `scrub_rev` 는 **클라이언트 판(m1)이 아니라 이것**이다. */
+function capsScrubRev() { return String(capsLoad().get(capsOrigin())?.scrub_rev || ''); }
+/**
+ * `/append` 가 **광고 없이** 400·404·405 — 이 서버(또는 그 앞의 무엇)는 덧붙임을 모른다(§5.1). 1시간 거짓으로 덮고 이번 바퀴는 FULL.
+ * ⚠ 그 1시간은 **광고로도 못 덮는다**(`gone` · 머리말 ⑤) — 그래서 그동안은 `/append` 를 안 두드리고 옛 서버처럼 FULL 만 간다.
+ */
+function capsAppendGone() {
+  const m = capsLoad();
+  const was = m.get(capsOrigin());
+  const now = Date.now();
+  m.set(capsOrigin(), { append: false, at: now, gone: now, ...(was?.scrub_rev ? { scrub_rev: was.scrub_rev } : {}) });
+  capsSave();
+}
+
+/* ── 덧붙임 길 (DESIGN-session-delta-sync §2.10 · C8) ────────────────────────────────────────────── */
+
+/** 【선언】 한 조각의 **JSON 봉투** 상한. 서버가 재는 것은 `strlen($delta)` 6MiB 인데, POST 는 그 앞에서 PHP `post_max_size`
+ *  (dev 실측 8MiB · **운영 값 미확인**)에 먼저 걸린다 — 넘으면 본문이 통째로 버려지고 `text/html` 경고 덩어리가 200 으로 온다.
+ *  그래서 나누는 자는 검열본 바이트가 아니라 **봉투 바이트**다(실측 부풂 1.016~1.036배 · 깨지는 문턱 1.3333배). */
+const APPEND_ENV_MAX = 6 * 1024 * 1024 + 512 * 1024;
+/** 조각 하나가 읽는 원본 구간의 몫 — 검열 출력은 이보다 작거나 비슷하다. 봉투가 상한을 넘으면 줄 경계에서 반씩 더 쪼갠다. */
+const APPEND_RAW_STEP = 4 * 1024 * 1024;
+/** 한 바퀴에 덧붙이는 원본의 상한 — 나머지는 다음 바퀴로. 메모리와 임대 묵음 한도를 함께 묶는다. */
+const APPEND_ROUND_MAX = 32 * 1024 * 1024;
+/** 흘려 읽기의 걸음(§2.10 「1MB 단위로 흘려 읽고」). */
+const APPEND_READ_CHUNK = 1024 * 1024;
+/** 【선언】 FULL 예산 — **진짜 FULL(재기반)** 만 시간당 이만큼(§5 불변식 「전체 재전송으로 폭주하지 않는다」). */
+const PUSH_FULL_BUDGET = 2;
+const PUSH_FULL_WINDOW_MS = 3600_000;
+/**
+ * 【선언】 예산이 세는 FULL 의 까닭 — **재기반**과, **덧붙임을 아는 서버가 이 대화의 덧붙임을 거절한 것**(`append_rejected` —
+ *   거절 응답이 광고를 실은 400·404·405. 바퀴마다 같은 거절을 받고 통째로 내려가는 대화를 묶는다 · C8 반박 fail F1).
+ *   여기 없는 까닭은 구조가 정한 것이라 예산으로 늦춰 봐야 아무도 안 구한다:
+ *   `no_cap`(옛 서버 — 그 서버에서는 모든 올리기가 FULL 이다 · 광고 없는 `/append` 거절도 1시간 이 갈래다) · `no_key`(기계 키 없음) ·
+ *   `cursor_tail`(Cursor 의 다 쓴 끝 줄 — 덧붙임은 `\n` 경계만 받는다) · `title`(사람이 제목을 고친다 — 입구는 제목을 안 싣는다).
+ *   첫 업로드도 안 센다 — 그 판정은 입구가 한다(`autoEntrance`).
+ */
+const PUSH_FULL_REBASE = new Set(['no_base', 'tenant', 'rebake', 'replaced', 'shrunk', 'head_changed', 'seam_changed',
+                                  'prefix_changed', 'base_moved', 'base_lost', 'append_rejected']);
+
+/** 버퍼 안의 줄 수(모든 줄이 `\n` 으로 끝난다 — 조각은 줄 경계에서만 끊긴다). */
+function countLines(buf) {
+  let n = 0;
+  for (let i = buf.indexOf(0x0a); i >= 0; i = buf.indexOf(0x0a, i + 1)) n++;
+  return n;
+}
+
+/** 파일 [from, to) 의 줄 수 — 흘려 읽고 **검열은 안 한다**(서버가 뒤처진 따라잡기가 `line_off` 를 되돌릴 때만 쓴다). */
+function countLinesAt(fd, from, to) {
+  const buf = Buffer.allocUnsafe(APPEND_READ_CHUNK);
+  let n = 0;
+  let at = from;
+  while (at < to) {
+    const got = fs.readSync(fd, buf, 0, Math.min(buf.length, to - at), at);
+    if (got <= 0) break;
+    n += countLines(got === buf.length ? buf : buf.subarray(0, got));
+    at += got;
+  }
+  return n;
+}
+
+/** 파일의 [pos, pos+len) 를 읽는다 — 자리 읽기라 fd 의 자리를 안 옮긴다(덧붙임은 전사를 통째로 안 읽는다). */
+function readAt(fd, pos, len) {
+  const want = Math.max(0, Number(len) || 0);
+  if (want === 0) return Buffer.alloc(0);
+  const b = Buffer.allocUnsafe(want);
+  let got = 0;
+  while (got < want) {
+    const n = fs.readSync(fd, b, got, want - got, pos + got);
+    if (n <= 0) break;
+    got += n;
+  }
+  return got === want ? b : b.subarray(0, got);
+}
+
+/** 파일의 **마지막 `\n` 바로 뒤**(§2.1) — 꼬리부터 64KB 씩 거슬러 찾는다(전사를 통째로 안 읽는다). 없으면 0. */
+function lastNewlineAt(fd, size) {
+  let end = Number(size) || 0;
+  while (end > 0) {
+    const start = Math.max(0, end - PUSH_MAC_WIN);
+    const b = readAt(fd, start, end - start);
+    const i = b.lastIndexOf(0x0a);
+    if (i >= 0) return start + i + 1;
+    end = start;
+  }
+  return 0;
+}
+
+/**
+ * [from, to) 를 **1MB 씩 흘려 읽어** 줄 경계 조각으로 넘긴다(§2.10). 조각 하나는 `step` 을 넘어서는 첫 줄 끝에서 끊고,
+ * 통틀어 `cap` 을 넘으면 **거기서 멈춘다**(나머지는 다음 바퀴 — 메모리와 임대 묵음 한도를 함께 묶는다).
+ * 접기(따라잡기)는 `cap` 없이 훑기만 하고, 보내기는 `cap` 안에서 조각을 모은다.
+ * @param {(seg:{from:number,to:number,buf:Buffer}) => void} onSeg
+ */
+function appendScan(fd, from, to, step, cap, onSeg) {
+  const chunk = Buffer.allocUnsafe(APPEND_READ_CHUNK);
+  let at = from;
+  let segStart = from;
+  let acc = [];
+  let accLen = 0;
+  while (at < to) {
+    const n = fs.readSync(fd, chunk, 0, Math.min(chunk.length, to - at), at);
+    if (n <= 0) break;
+    let used = 0;
+    let scan = 0;
+    for (;;) {
+      const i = chunk.indexOf(0x0a, scan);
+      if (i < 0 || i >= n) break;
+      const cut = at + i + 1;
+      if (cut - segStart >= step) {
+        acc.push(Buffer.from(chunk.subarray(used, i + 1)));
+        accLen += (i + 1) - used;
+        onSeg({ from: segStart, to: cut, buf: Buffer.concat(acc, accLen) });
+        acc = []; accLen = 0; segStart = cut; used = i + 1;
+        if (cut - from >= cap) return;
+      }
+      scan = i + 1;
+    }
+    if (used < n) { acc.push(Buffer.from(chunk.subarray(used, n))); accLen += n - used; }
+    at += n;
+  }
+  if (accLen > 0) onSeg({ from: segStart, to: segStart + accLen, buf: Buffer.concat(acc, accLen) });
+}
+
+/** 조각 하나를 **줄 경계에서** 반으로 쪼갠다 — 봉투가 상한을 넘거나 413 을 받았을 때. 줄 하나뿐이면 null(더 못 쪼갠다). */
+function splitSeg(seg) {
+  const half = Math.floor(seg.buf.length / 2);
+  let cut = seg.buf.indexOf(0x0a, half);
+  if (cut < 0 || cut + 1 >= seg.buf.length) cut = seg.buf.lastIndexOf(0x0a, Math.max(0, half - 1));
+  if (cut < 0 || cut + 1 >= seg.buf.length) return null;
+  const n = cut + 1;
+  return [{ from: seg.from, to: seg.from + n, buf: seg.buf.subarray(0, n) },
+          { from: seg.from + n, to: seg.to, buf: seg.buf.subarray(n) }];
+}
+
+/**
+ * 변화분 검열 — **줄 번호를 사람 말로 되돌린다**(C6 이 C8 에 넘긴 것). `scrubTranscript` 안의 `no` 는 **이 호출 안의 번호**라,
+ * 덧붙임에서는 「3번째 줄」이 전사의 3번째 줄이 아니다. 보정을 **부르는 쪽에서** 한다 — 그 함수는 `scrub-rev.lock` 의 원천이라
+ * 한 글자만 고쳐도 판(`SCRUB_REV`)을 올려야 하고, 판을 올리면 **이 기계의 모든 대응표가 다음 바퀴에 rebake→FULL** 이 된다.
+ * 줄 번호 하나 때문에 치를 값이 아니다(C8 이 정한 자리).
+ */
+function scrubDelta(text, hist, lineBase) {
+  try { return scrubTranscript(text, { delta: true, hist }); } catch (e) {
+    const m = /^(\d+)번째 줄을/.exec(String(e?.message || ''));
+    if (m && Number(lineBase) > 0) throw new Error(String(e.message).replace(/^\d+번째 줄을/, `${Number(m[1]) + Number(lineBase)}번째 줄을`));
+    throw e;
+  }
+}
+
+/**
+ * **건너뛴 원본 구간을 `cwd_hist` 에 접는다** — 셈만 하고 검열 출력은 버린다. 전송은 없다(§2.10 따라잡기 · privacy B4).
+ * 이것이 있어야 그 구간에만 나온 자리도 `.genetics-private` 매 바퀴 재검사가 본다 — **좌표를 옮기기 전에** 부른다.
+ * @returns {{hist: object, sc: object, lines: number}}
+ */
+function foldHist(fd, from, to, hist, lineBase) {
+  let h = hist && typeof hist === 'object' ? hist : {};
+  let lines = 0;
+  let sc = null;
+  appendScan(fd, from, to, APPEND_RAW_STEP, Infinity, (seg) => {
+    sc = scrubDelta(seg.buf.toString('utf8'), h, lineBase + lines);
+    h = sc.cwd_hist;
+    lines += countLines(seg.buf);
+  });
+  // 접을 것이 없어도 판정 재료는 있어야 한다 — 빈 변화분으로 `cwd`·`cwd_raw` 를 hist 에서 낸다.
+  if (!sc) sc = scrubTranscript('', { delta: true, hist: h });
+  return { hist: h, sc, lines };
+}
+
+/**
+ * 이 바퀴는 **덧붙임인가 전체인가**(§2.10 의 의사코드 그대로) — 임대 **안에서만** 부른다(§3.2 「순서가 보증이다」).
+ * 파일은 **자리 읽기**로만 본다(앞 64KB · 이음매 64KB · 기하 시점의 접두) — 전사를 통째로 안 읽는 것이 덧붙임의 요지다.
+ * 갈래마다 FULL 의 **까닭**을 남긴다: 예산(`PUSH_FULL_REBASE`)과 시험이 그 글자로 갈린다.
+ *
+ * @param {number} fd  열린 전사
+ * @param {{size:bigint, ino:bigint, dev:bigint}} st  같은 fd 의 fstat
+ * @param {{tenantId:number, tailDone:boolean, titled?:boolean, onServer:boolean}} o
+ * @returns {{mode:'FULL'|'APPEND'|'ASK', why:string, L:object|null, key:Buffer|null, head_len:number, ck:?{off:number,sha:string}}}
+ */
+function planPush(uuid, fd, st, o) {
+  const FULL = (why) => ({ mode: 'FULL', why, L: null, key: null, head_len: 0, ck: null });
+  // ⚠ **사람이 제목을 주면 FULL 이다**(C8 반박 equiv ②). 덧붙임은 메타를 안 바꾼다(agent_session_append.php — UPDATE 에 title 칸이
+  //   없다 · 의도다). 덧붙임으로 보내면 도구는 성공이라 말하고 제목은 **조용히** 그대로였다. 입구는 제목을 안 싣으므로 예산과 무관하다.
+  if (o.titled) return FULL('title');
+  // ⚠ Cursor 의 **다 쓴 끝 줄**은 개행이 없다(C6). 덧붙임은 `\n` 경계만 받으므로 대응표가 있어도 FULL 이다 — 반쪽 줄을 보내면
+  //   서버가 그것을 온전한 줄로 굳히고 좌표는 줄 중간을 가리킨 채 다음 바퀴가 그 줄 꼬리를 또 보낸다(거절이 아니라 조용한 중복).
+  if (o.tailDone) return FULL('cursor_tail');
+  if (!capsAppend()) return FULL('no_cap');
+  const key = pushKey(false);
+  if (!key) return FULL('no_key');
+  const keyId = pushKeyId(key);
+  const L = ledgerRead(uuid);
+  // 대응표가 없거나 이 기계의 것이 아니면 — 서버에 이미 있는 대화면 **물어본다**(base.rev −1 · 쓰기 없음 · race S8).
+  const noBase = () => (o.onServer ? { mode: 'ASK', why: 'no_base', L: null, key, head_len: 0, ck: null } : FULL('no_base'));
+  if (!L || L.v !== 1 || L.key_id !== keyId) return noBase();
+  if (!Number.isInteger(L.rev) || L.rev < 0 || !Number.isInteger(L.bytes) || L.bytes < 0) return noBase();
+  if (!Number.isInteger(L.raw_off) || L.raw_off <= 0) return noBase();
+  if (typeof L.srv_scrub_rev !== 'string' || !CAPS_REV_RE.test(L.srv_scrub_rev)) return noBase();
+  // 개인정보(§5 불변식) — `cwd_hist` 가 없으면 `.genetics-private` 판정 재료가 없다. **올리지 않는다**(따라잡기가 되살린다).
+  if (!L.cwd_hist || typeof L.cwd_hist !== 'object' || Array.isArray(L.cwd_hist)) return noBase();
+  // ⚠ 대응표 열쇠는 uuid 하나인데 서버 행은 (소속처, uuid) 다(C6 이 C8 에 넘긴 반박 ①) — 소속처부터 본다.
+  if (!(Number(o.tenantId) > 0) || Number(L.tenant_id) !== Number(o.tenantId)) return FULL('tenant');
+  if (L.scrub_rev !== SCRUB_REV) return FULL('rebake');            // 판이 둘이다 — 여기는 **클라이언트 판**(C6)
+  if (String(L.ino) !== String(st.ino) || String(L.dev) !== String(st.dev)) return FULL('replaced');
+  if (Number(st.size) < L.raw_off) return FULL('shrunk');
+  // 앞 64KB — 창 길이는 **첫 FULL 이 정한 그 길이**다(위 `head_len` 주석). 옛 대응표(C6)는 `ck_off == 첫 FULL 의 to` 라 거기서 낸다.
+  const headLen = Number.isInteger(L.head_len) && L.head_len > 0
+    ? Math.min(L.head_len, L.raw_off)
+    : Math.min(PUSH_MAC_WIN, Number.isInteger(L.ck_off) && L.ck_off > 0 ? L.ck_off : L.raw_off);
+  if (pushMac(key, readAt(fd, 0, headLen)) !== L.head_mac) return FULL('head_changed');
+  // 이음매 64KB — **이것이 「내가 아는 그 자리가 아직 그대로인가」의 탐지기**다. 다르면 보내지 말고 바로 FULL.
+  const wf = Math.max(0, L.raw_off - PUSH_MAC_WIN);
+  if (pushMac(key, readAt(fd, wf, L.raw_off - wf)) !== L.win_mac) return FULL('seam_changed');
+  // 기하 시점 검사(§3.6) — `raw_off ≥ 2·ck_off` 면 [0,ck_off) 를 다시 해시해 대조하고 **같은 읽기로** 새 ck 를 세운다.
+  //   창 밖에서 크기를 유지한 채 제자리에서 다시 쓴 경우를 늦게라도 잡는 자리다. 일생 동안 읽는 총량은 2N 이하다.
+  let ck = null;
+  if (Number.isInteger(L.ck_off) && L.ck_off > 0 && L.raw_off >= 2 * L.ck_off) {
+    const h = crypto.createHash('sha256');
+    const buf = Buffer.allocUnsafe(APPEND_READ_CHUNK);
+    let at = 0;
+    let seen = '';
+    while (at < L.raw_off) {
+      const n = fs.readSync(fd, buf, 0, Math.min(buf.length, L.raw_off - at), at);
+      if (n <= 0) break;
+      if (at < L.ck_off && at + n >= L.ck_off) {
+        h.update(buf.subarray(0, L.ck_off - at));
+        seen = h.copy().digest('hex');
+        h.update(buf.subarray(L.ck_off - at, n));
+      } else h.update(buf.subarray(0, n));
+      at += n;
+    }
+    if (seen !== L.ck_sha) return FULL('prefix_changed');
+    ck = { off: L.raw_off, sha: h.digest('hex') };
+  }
+  return { mode: 'APPEND', why: '', L, key, head_len: headLen, ck };
+}
+
+/**
+ * 이 올리기가 가는 소속처의 **숫자 id** — 대응표의 `tenant_id` 와 견줄 값. 입구는 그것을 알고 부른다(`tid`);
+ * 사람의 `push_session` 은 슬러그·이름만 아는 채로 오므로 색인 행에서 **그 이름이 그 행의 소속처일 때만** 낸다.
+ * 모르면 0 이고, 그러면 덧붙이지 않는다(닫는 쪽) — 남의 소속처 행에 이 기계의 좌표를 들이밀지 않는다.
+ */
+function pushTenantId(tenantArg, uuid, hint) {
+  if (Number(hint) > 0) return Number(hint);
+  const a = String(tenantArg || '').trim().toLowerCase();
+  if (!a) return 0;
+  const row = indexRead()[String(uuid)];
+  if (!row || typeof row !== 'object' || !(Number(row.tenant_id) > 0)) return 0;
+  return (String(row.tenant_slug || '').toLowerCase() === a || String(row.tenant || '').toLowerCase() === a)
+    ? Number(row.tenant_id) : 0;
+}
+
+/** [from,to) 의 sha256 — 흘려 읽는다(따라잡기 뒤 기하 점검 자리를 다시 세울 때만 쓴다). */
+function hashRange(fd, from, to) {
+  const h = crypto.createHash('sha256');
+  const buf = Buffer.allocUnsafe(APPEND_READ_CHUNK);
+  let at = from;
+  while (at < to) {
+    const n = fs.readSync(fd, buf, 0, Math.min(buf.length, to - at), at);
+    if (n <= 0) break;
+    h.update(buf.subarray(0, n));
+    at += n;
+  }
+  return h.digest('hex');
+}
+
+/**
+ * **덧붙임 길**(§2.10 · C8) — `[raw_off, EOF)` 를 1MB 로 흘려 읽어 **마지막 `\n` 까지만** 줄 경계 조각으로 나누고,
+ * 조각마다 `POST /api/sessions/append` 를 **차례로** 보낸다. 요청 하나가 커밋 하나다 — 앞 응답의 `rev`·`bytes`·`raw_off` 가
+ * 다음 요청의 기반이라 **병렬로 못 보낸다**(조각 길과 다른 점이 그것이다).
+ *
+ * 순서가 보증이다: ① 조각을 다 **검열**해 `cwd_hist` 를 이어 세고 → ② 그 열쇠 **전부**로 사적 폴더·4096 을 판정하고 →
+ * ③ 그다음에 첫 바이트를 보낸다. 거꾸로 하면 둘째 조각에만 나온 사적 자리가 첫 조각이 나간 뒤에 드러난다.
+ *
+ * ⚠ 제목은 이 길로 안 온다 — 제목이 있으면 `planPush` 이 FULL(`title`)을 고른다(덧붙임은 메타를 안 바꾼다).
+ *
+ * @param {{fd:number, st:object, uuid:string, tenant:string, tenantId:number, dryRun:boolean,
+ *          bindOf:'propose'|'skip', auto:?object, hooks:?object, headers:?object, plan:object,
+ *          size:number, end:number, isCursorBody:boolean}} a
+ * @returns {Promise<{r:?object, before:number, parts:number, raw_sha:string, plan:object, appended:number, why:string}>}
+ *   `r` 이 있으면 보냈다. 없으면 `why` 가 **같은 부름 안에서 FULL 로 내려가는 까닭**이다(예산이 그 글자로 갈린다).
+ */
+async function pushAppend(a) {
+  const { fd, st, uuid, tenant, tenantId, dryRun, bindOf, auto, hooks, headers, plan, size, end, isCursorBody } = a;
+  const key = plan.key;
+  const keyId = pushKeyId(key);
+  const L = plan.L;
+  const progressed = () => { try { hooks?.progress?.(); } catch { /* 임대 시계를 못 밀어도 올리기는 계속한다 */ } };
+  const fall = (why) => ({ r: null, why, before: size, parts: 0, raw_sha: '', plan, appended: 0 });
+  const stop = (code, msg) => { throw Object.assign(new Error(msg), { code, status: code === 'session_hidden' ? 409 : 0 }); };
+
+  let headMac = L ? String(L.head_mac) : '';
+  let headLen = plan.head_len;
+  let srvRev = L ? String(L.srv_scrub_rev) : capsScrubRev();
+  let from = L ? L.raw_off : 0;
+  let base = L ? { rev: L.rev, bytes: Number(L.bytes) || 0 } : { rev: -1, bytes: 0 };
+  let winFrom = L ? String(L.win_mac) : '';
+  let lineOff = L && Number.isInteger(L.line_off) ? L.line_off : 0;
+  let ck = plan.ck || (L && Number.isInteger(L.ck_off) && L.ck_off > 0 ? { off: L.ck_off, sha: String(L.ck_sha || '') } : null);
+  let hist = L && L.cwd_hist && typeof L.cwd_hist === 'object' ? { ...L.cwd_hist } : {};
+  let headInfo = L && L.head && typeof L.head === 'object' ? L.head : { id: '', ms: 0 };
+
+  // ⚠ **dry_run 은 대응표를 안 만든다**(C6 의 계약 — FULL 쪽 주석과 같은 규칙). 전에는 대응표 없는 dry_run 의 물음(ASK)이
+  //   서버 좌표를 받아 `push/<uuid>.json` 을 세웠다(C8 반박 fail F2·equiv ⑧·cost ⑤).
+  const ledgerSave = () => (dryRun ? false : ledgerWrite(uuid, {
+    v: 1, uuid, tenant_id: tenantId, key_id: keyId, rev: base.rev, bytes: base.bytes, raw_off: from,
+    head_mac: headMac, head_len: headLen, win_mac: winFrom, ino: String(st.ino), dev: String(st.dev),
+    scrub_rev: SCRUB_REV, srv_scrub_rev: srvRev,
+    ck_off: ck ? ck.off : 0, ck_sha: ck ? ck.sha : '',
+    cwd_hist: hist, line_off: lineOff, head: headInfo,
+  }));
+
+  /**
+   * **따라잡기** — 서버 좌표가 이 기계 키이고 그 자리의 이음매 MAC 이 내 파일과 맞으면 서버 사본은 내 파일의 접두사다.
+   * 그 자리에서 잇는다. **방향을 가리지 않는다**(서버가 앞서든 뒤처지든 서버 좌표에서 시작한다).
+   * ⚠⚠ **좌표를 옮기기 전에 건너뛰는 원본 구간을 읽어 `cwd_hist` 에 접는다**(§5 불변식 「개인정보 판정 재료가 좌표보다
+   *   늦지 않다」 · privacy B4). 안 그러면 그 구간에만 나온 사적 폴더가 판정 없이 통과한다.
+   */
+  const catchUp = (coords) => {
+    if (!coords || String(coords.raw_key_id || '') !== keyId) return false;   // 다른 기계 — MAC 을 겨룰 수 없다
+    const off = Number(coords.raw_off);
+    const rev = Number(coords.rev);
+    if (!Number.isInteger(off) || off < 0 || off > size) return false;        // 서버가 내 파일보다 뒤까지 안다 — 못 잇는다
+    if (!Number.isInteger(rev) || rev < 0) return false;
+    const wf = Math.max(0, off - PUSH_MAC_WIN);
+    if (pushMac(key, readAt(fd, wf, off - wf)) !== String(coords.raw_win_mac || '')) return false;
+    if (off > from) { const f0 = foldHist(fd, from, off, hist, lineOff); hist = f0.hist; lineOff += f0.lines; }
+    // 서버가 뒤처진 쪽(off < from)은 접을 것이 없다 — 내 hist 는 이미 그 앞을 다 세었다(넉넉한 쪽으로 남긴다).
+    // ⚠ 다만 `line_off` 는 되돌린다 — [off, from) 을 다시 보내며 또 세면 줄 번호가 두 번 센 값이 된다(C8 반박 fail F3 · 실측 41→62).
+    //   줄 수는 빼기가 정확하다(검열 없이 \n 만 센다). cwd_hist 의 셈은 빼기가 안 되어 넉넉한 쪽으로 남는다(열쇠 집합은 같다).
+    else if (off < from) lineOff = Math.max(0, lineOff - countLinesAt(fd, off, from));
+    from = off;
+    base = { rev, bytes: Number(coords.bytes) || 0 };
+    winFrom = String(coords.raw_win_mac);
+    if (!L) {
+      // 대응표가 없는 따라잡기 — `head_mac` 은 서버가 안 준다. 첫 FULL 의 창 길이를 모르니 `min(64K, raw_off)` 로 **가정**한다.
+      // 응답만 잃은 경우(race S8)에는 그 값이 곧 참이고, 아니면 다음 요청이 base_moved 로 돌아와 FULL 이 바로잡는다.
+      headLen = Math.min(PUSH_MAC_WIN, off);
+      headMac = pushMac(key, readAt(fd, 0, headLen));
+      ck = off > 0 ? { off, sha: hashRange(fd, 0, off) } : null;
+    }
+    return true;
+  };
+
+  /** §5.1 의 표 그대로 — 덧붙임의 거절이 어디로 가는가. **`code` 를 먼저 보고 `status` 를 나중에 본다**(관문 pre 가 413 보다 앞이다). */
+  const triage = (e) => {
+    const status = Number(e?.status) || 0;
+    const code = String(e?.code || '');
+    const why = String(e?.why || '');
+    if (code === 'base_moved' || code === 'behind') return { coords: e?.coords || null };
+    // 가림·걷음은 **멈춘다** — 되살리기는 사람의 전체 PUT 만(§0-5·§3.3). 입구의 붙박이 표와 같은 무게로 옮긴다.
+    if (code === 'no_base') {
+      return why === 'hidden' || why === 'purged'
+        ? { sticky: Object.assign(new Error(e.message), { status: 409, code: 'session_hidden' }) }
+        : { fall: 'no_base' };
+    }
+    if (code === 'rebake') return { fall: 'rebake' };
+    if (code === 'base_lost') return { fall: 'base_lost' };
+    if (code === 'delta_too_big' || status === 413) return { split: true };
+    // 200 인데 JSON 이 아니다 — 봉투가 `post_max_size` 를 넘어 PHP 가 본문을 버렸다(운영 값 미확인 · C8 반박 fail F5).
+    //   413 과 같게 줄 경계에서 더 쪼갠다. 줄 하나로도 안 되면 아래 `halve()` 가 FULL 로 내린다(그 바퀴 안에서 끝난다).
+    if (e?.not_json && status === 200) return { split: true };
+    if (status === 400 || status === 404 || status === 405) {
+      // ★ 거절 응답이 **광고를 실었으면** 서버는 덧붙임을 안다 — 이 요청이 거절된 것이다(`bad_coords`·남의 소속처 404).
+      //   광고 캐시는 그대로 두고 이 대화만 FULL 로, **예산이 세는 까닭**으로 내린다(C8 반박 fail F1 — 전에는 캐시를 거짓으로
+      //   덮었지만 곧이어 도는 FULL 의 응답이 광고로 되돌려, 안 세는 FULL 이 90초마다 무기한 되풀이됐다).
+      if (String(e?.caps || '').split(/[\s,]+/).includes('append1')) return { fall: 'append_rejected' };
+      // 광고 없는 거절 — 이 서버(또는 그 앞의 무엇)는 덧붙임을 모른다(§5.1). 1시간 거짓(광고로도 못 덮는다)으로 두고 이번은 FULL.
+      capsAppendGone();
+      return { fall: 'no_cap' };
+    }
+    return { rethrow: true };                     // 422·429·403·426·5xx·타임아웃 — 입구의 백오프가 맡는다
+  };
+
+  const cwdFallback = isCursorBody ? relHome(cursorWorkspaceFolder() || '') : relHome(process.cwd());
+
+  /* ── 대응표 없음: **쓰기 없는 물음**으로 서버 좌표를 받는다(base.rev −1 · §2.10 · race S8) ───────────────── */
+  if (plan.mode === 'ASK') {
+    if (!srvRev) return fall('no_base');          // 이 서버의 규칙판을 아직 못 봤다 — FULL 한 번이 알려 준다
+    // 판정 재료가 하나도 없으므로 [0, end) 를 통째로 접는다(셈만 · 전송 없음).
+    const all = foldHist(fd, 0, end, {}, 0);
+    const held0 = hooks?.check ? String(hooks.check(all.sc) || '') : '';
+    if (held0) stop(held0, `자동 올리기를 보류했다(${held0})`);
+    let folder0 = null;
+    if (auto) {
+      const prep = auto.prepare(all.sc);
+      if (prep.code) throw Object.assign(new Error(`자동 올리기를 보류했다(${prep.code})`),
+        { code: prep.code, status: prep.code === 'place_unreadable' ? 422 : 0 });
+      folder0 = prep.folder;
+    } else if (bindOf === 'propose') folder0 = pushProposeFolder(all.sc, isCursorBody);
+    const Z = '0'.repeat(64);
+    let coords = null;
+    try {
+      await api('POST', '/api/sessions/append', {
+        tenant, uuid, bind: bindOf, origin_cwd: all.sc.cwd || cwdFallback, ...(folder0 ? { folder: folder0 } : {}),
+        base: { rev: -1, bytes: 0 },
+        raw: { key_id: keyId, from: 0, to: 0, head_mac: Z, win_mac_from: Z, win_mac_to: Z },
+        scrub_rev: srvRev, delta: '',
+      }, { headers, timeout_ms: apiTimeoutFor(0) });
+      return fall('no_base');                     // 200 은 올 수 없다(rev −1 은 언제나 base_moved) — 모르는 서버다
+    } catch (e) {
+      const t = triage(e);
+      if (t.sticky) throw t.sticky;
+      if (t.rethrow) throw e;
+      if (t.coords === undefined || t.coords === null) return fall(t.fall || 'no_base');
+      coords = t.coords;
+    }
+    if (!catchUp(coords)) return fall('no_base');
+    ledgerSave();                                 // **전송 없이** 좌표를 되살렸다(S8)
+  }
+
+  /* ── 조각을 모으고 보낸다 ──────────────────────────────────────────────────────────────────── */
+  let moved = plan.mode === 'ASK';
+  let caught = 0;
+  for (;;) {
+    const items = [];
+    {
+      let h = hist;
+      let lb = lineOff;
+      appendScan(fd, from, end, APPEND_RAW_STEP, APPEND_ROUND_MAX, (seg) => {
+        const sc = scrubDelta(seg.buf.toString('utf8'), h, lb);
+        items.push({ seg, sc, hist0: h, lb, lines: countLines(seg.buf) });
+        h = sc.cwd_hist;
+        lb += countLines(seg.buf);
+      });
+    }
+    // 판정은 **이번 구간 전부를 접은 뒤** 한 번(§3.3 「cwd_hist 열쇠 전부로 매 바퀴」). 조각이 없으면 지금까지 접은 hist 로.
+    const lastSc = items.length ? items[items.length - 1].sc : scrubTranscript('', { delta: true, hist });
+    const held = hooks?.check ? String(hooks.check(lastSc) || '') : '';
+    if (held) stop(held, `자동 올리기를 보류했다(${held})`);
+    let folder = null;
+    if (auto) {
+      /*
+       * ★ **32MB 는 「한 번 전송량」이 아니라 「서버 사본 한 벌의 크기」다**(§3.1 · C7 이 C8 로 넘긴 것).
+       *   길이 FULL 뿐이던 때는 보내는 검열본 전체가 곧 그 사본이라 같은 값이었다. 덧붙임에서는 `row.bytes + 조각` 이다.
+       */
+      const add = items.reduce((n, it) => n + Buffer.byteLength(it.sc.jsonl, 'utf8'), 0);
+      const prep = base.bytes + add > AUTO_BODY_MAX ? { code: 'too_big' } : auto.prepare(lastSc);
+      if (prep.code) throw Object.assign(new Error(`자동 올리기를 보류했다(${prep.code})`),
+        { code: prep.code, status: prep.code === 'place_unreadable' ? 422 : 0 });
+      folder = prep.folder;
+    } else if (bindOf === 'propose') folder = pushProposeFolder(lastSc, isCursorBody);
+
+    if (!items.length) {
+      // 보낼 원본 구간이 없다 — 파일이 안 자랐거나, 따라잡기로 좌표만 옮겼다. **실패가 아니다**(입구가 간격만 비춘다).
+      // ★★ 따라잡았으면 **그 좌표를 적고** 끝낸다(C8 반박 equiv ①). 전에는 보내는 고리 안의 따라잡기(409 base_moved)가 옮긴 좌표를
+      //   안 적어, 다음 바퀴가 옛 좌표에서 같은 구간을 다시 검열·전송하고 409 를 받고 또 `caught_up` — 끝난 대화에서 90초마다
+      //   무기한이었다(`caught_up` 은 실패가 아니라 백오프도 안 걸리고, 예산은 FULL 만 센다).
+      if (moved) ledgerSave();
+      throw Object.assign(new Error(moved
+        ? '서버 좌표를 따라잡아 대응표만 세웠다(보낼 줄 없음)'
+        : '덧붙일 줄이 없다(서버가 이미 이 대화의 끝까지 가지고 있다)'), { code: 'caught_up', status: 0, moved });
+    }
+
+    const queue = items.slice();
+    let last = null;
+    let parts = 0;
+    let appended = 0;
+    let restart = false;
+    while (queue.length) {
+      const it = queue[0];
+      const segTo = it.seg.to;
+      const wf = Math.max(0, segTo - PUSH_MAC_WIN);
+      const winTo = pushMac(key, readAt(fd, wf, segTo - wf));
+      const env = {
+        tenant, uuid, bind: bindOf,
+        origin_cwd: it.sc.cwd || cwdFallback, ...(folder ? { folder } : {}),
+        base: { rev: base.rev, bytes: base.bytes },
+        raw: { key_id: keyId, from: it.seg.from, to: segTo, head_mac: headMac, win_mac_from: winFrom, win_mac_to: winTo },
+        scrub_rev: srvRev, delta: it.sc.jsonl,
+        ...(dryRun ? { dry_run: true } : {}),
+      };
+      /*
+       * ★ **나누는 자는 검열본이 아니라 봉투 바이트다**(C4 가 C6→C8 로 넘긴 줄). 서버는 `strlen($delta)` 6MiB 를 재지만,
+       *   POST 는 그 앞에서 `post_max_size` 에 먼저 걸린다 — 넘으면 200·`text/html`·머리 0개가 와서 **조용히 아무것도
+       *   안 올라간다**. 봉투를 먼저 재고, 그래도 413 이 오면 줄 경계에서 반으로 쪼개 앞쪽부터 다시 보낸다.
+       */
+      const envBytes = Buffer.byteLength(JSON.stringify(env), 'utf8');
+      const halve = () => {
+        const two = splitSeg(it.seg);
+        if (!two) return false;
+        queue.shift();
+        const A = { seg: two[0], sc: scrubDelta(two[0].buf.toString('utf8'), it.hist0, it.lb), hist0: it.hist0, lb: it.lb, lines: countLines(two[0].buf) };
+        const B = { seg: two[1], sc: scrubDelta(two[1].buf.toString('utf8'), A.sc.cwd_hist, it.lb + A.lines), hist0: A.sc.cwd_hist, lb: it.lb + A.lines, lines: countLines(two[1].buf) };
+        queue.unshift(A, B);
+        return true;
+      };
+      if (envBytes > APPEND_ENV_MAX) {
+        if (halve()) continue;
+        return fall('rebake');                    // 줄 하나가 상한을 넘는다 — 덧붙임으로는 못 보낸다(FULL 의 조각 길로)
+      }
+      let r;
+      try {
+        r = await api('POST', '/api/sessions/append', env, { headers, timeout_ms: apiTimeoutFor(envBytes) });
+      } catch (e) {
+        const t = triage(e);
+        if (t.split) { if (halve()) continue; return fall('rebake'); }
+        if (t.sticky) throw t.sticky;
+        if (t.fall) return fall(t.fall);
+        if (t.rethrow) throw e;
+        // base_moved / behind — 따라잡기는 **한 바퀴에 한 번**. 또 어긋나면 FULL 로 재기반한다.
+        if (caught >= 1 || !catchUp(t.coords)) return fall('base_moved');
+        caught++;
+        moved = true;
+        restart = true;
+        break;
+      }
+      progressed();
+      parts++;
+      appended += Buffer.byteLength(it.sc.jsonl, 'utf8');
+      last = r;
+      queue.shift();
+      if (dryRun) {
+        /*
+         * ★ **덧붙임 dry_run 도 같은 길을 간다** — 다만 조각 **하나**까지다. 서버가 행을 안 쓰므로 기반이 안 움직이고,
+         *   둘째 조각의 `raw.from` 은 행의 `raw_off` 와 달라 409 base_moved 가 된다. 대응표·색인도 안 건드린다(FULL 과 같은 규칙).
+         */
+        return { r, before: size, parts, raw_sha: '', plan, appended, why: '' };
+      }
+      // 서버가 그 좌표를 세웠다고 답한 때만 대응표를 옮긴다 — `raw_win_mac === 보낸 값` 이 이 키인지도 함께 잰다(응답에 key_id 가 없다).
+      if (!Number.isInteger(r?.rev) || r.raw_off !== segTo || r.raw_win_mac !== winTo) {
+        ledgerDrop(uuid);
+        return fall('no_base');
+      }
+      base = { rev: r.rev, bytes: Number.isInteger(r.bytes) ? r.bytes : base.bytes };
+      from = segTo;
+      winFrom = winTo;
+      hist = it.sc.cwd_hist;
+      lineOff = it.lb + it.lines;
+      if (typeof r.scrub_rev === 'string' && CAPS_REV_RE.test(r.scrub_rev)) srvRev = r.scrub_rev;
+      headInfo = { id: String(r.head_id || ''), ms: Number(r.head_ms) || 0 };
+      ledgerSave();                               // **성공마다** 옮긴다 — 도중에 죽어도 다음 바퀴가 여기서 잇는다
+    }
+    if (restart) continue;
+    pushIndexNote(uuid, tenant, last, '');        // `raw_sha` 는 FULL 에서만(§2.10) — 덧붙임은 원본 전체를 안 읽는다
+    return { r: last, before: size, parts, raw_sha: '', plan, appended, why: '' };
+  }
+}
+
 /**
  * 이 기계의 대화 하나를 검열해서 올린다.
  *
@@ -2033,18 +3043,86 @@ function toolsStamp() {
   return t;
 }
 
+/** 개행 없는 끝 줄이 **다 쓴 줄**인가 — 온전한 JSON 객체로 읽히면 그렇다(반쪽 줄은 객체로 안 읽힌다). 공백뿐이면 아니다. */
+function cursorTailDone(tail) {
+  const s = tail.toString('utf8');
+  if (!s.trim()) return false;
+  try { const r = JSON.parse(s); return !!r && typeof r === 'object' && !Array.isArray(r); } catch { return false; }
+}
+
 /**
  * @param {'propose'|'skip'} [bind] `'propose'` 면 이 대화의 자리 폴더를 그 소속처에 **제안**한다(§4.2 —
  *   확정·자동 올리기는 포털에서 사람이 한다). 사람이 부른 push_session 만 제안하고, 심박의 갱신은 `'skip'`.
+ * @param {null|{check?: (sc: object) => string, progress?: () => void}} [hooks] 입구(C7)가 거는 손잡이 둘 —
+ *   `check` 는 검열 뒤·보내기 전에 한 번 불러 코드('')가 아니면 **안 보낸다**(옛 길의 사적 폴더·4096 — 봉투는 안 바꾼다:
+ *   `auto` 와 달리 머리·folder 를 안 싣는다) · `progress` 는 요청 하나(조각 하나)가 끝날 때마다 — 임대의 묵음 시계를 민다(§3.2).
  */
-async function pushSession(tenant, uuid, title, dryRun, bind = 'skip', auto = null) {
+async function pushSession(tenant, uuid, title, dryRun, bind = 'skip', auto = null, hooks = null, tenantIdHint = 0) {
   const f = findTranscript(uuid);
   if (!f) throw new Error(`이 기계에 그 세션이 없습니다: ${uuid}`);
-  // 검열한 **바로 그 바이트**의 지문(§5.1 raw_sha) — 파일을 두 번 읽으면 그 사이에 자란 줄이 섞인다.
-  const bytes = fs.readFileSync(f);
-  const rawSha = crypto.createHash('sha256').update(bytes).digest('hex');
-  const sc = scrubTranscript(bytes.toString('utf8'));
+  // 한 fd 로 stat 과 읽기를 한다 — 대응표의 ino·dev 가 읽은 그 파일의 것이어야 한다(§2.11).
+  // ★ **덧붙임은 이 fd 를 자리 읽기로만 쓴다**(C8) — 전사를 통째로 안 읽는 것이 이 커밋의 요지다.
+  const fd = fs.openSync(f, 'r');
+  try { return await pushSessionFd(fd, f, tenant, uuid, title, dryRun, bind, auto, hooks, tenantIdHint); }
+  finally { fs.closeSync(fd); }
+}
+
+async function pushSessionFd(fd, f, tenant, uuid, title, dryRun, bind, auto, hooks, tenantIdHint) {
+  const st = fs.fstatSync(fd, { bigint: true });
+  const size = Number(st.size);
+  const isCursorBody = f.includes(`${path.sep}.cursor${path.sep}projects${path.sep}`);
+  // 끝 줄 판정도 **꼬리만** 읽는다(§2.1) — 마지막 `\n` 바로 뒤가 좌표 `raw_off` 다.
+  const toEnd = lastNewlineAt(fd, size);
+  const tailDone = isCursorBody && toEnd < size && cursorTailDone(readAt(fd, toEnd, size - toEnd));
+  const tid = pushTenantId(tenant, uuid, tenantIdHint);
+  const bindOf = bind === 'propose' ? 'propose' : 'skip';
+  let headers;
+  if (!auto && bindOf === 'propose') headers = { 'X-Genetics-Push': 'human' };
+  if (auto) {
+    headers = { 'X-Genetics-Binding': String(auto.binding_id), 'X-Genetics-Device': auto.device,
+                'X-Genetics-Client': `genetics-mcp/${VERSION}` };
+  }
+  /*
+   * ── 길을 고른다(§2.10 · §3.2) ──────────────────────────────────────────────────────────────
+   * `planPush` 은 자리 읽기만 한다. 갈래마다 FULL 의 **까닭**이 남고, 예산(`hooks.plan`)이 그 글자로 갈린다.
+   * 덧붙임이 섰다가 서버가 「기반이 다르다」고 하면 **따라잡기**로 그 자리에서 잇고, 그것도 안 되면 같은 부름 안에서 FULL 로 내려온다.
+   */
+  const titled = typeof title === 'string' && title.trim() !== '';
+  let plan = planPush(uuid, fd, st, { tenantId: tid, tailDone, titled, onServer: autoRowOnServer(indexRead()[uuid]) });
+  if (plan.mode !== 'FULL') {
+    const got = await pushAppend({ fd, st, uuid, tenant, tenantId: tid, dryRun, bindOf, auto, hooks, headers,
+                                   plan, size, end: toEnd, isCursorBody });
+    if (got.r) return got;
+    plan = { ...plan, mode: 'FULL', why: got.why };
+  }
+  const held0 = hooks?.plan ? String(hooks.plan(plan) || '') : '';       // FULL 예산(§3.2) — 입구만 건다(사람의 push 는 안 센다)
+  if (held0) throw Object.assign(new Error(`자동 올리기를 보류했다(${held0})`), { code: held0, status: 0 });
+  const bytes = readAt(fd, 0, size);
+  /*
+   * ★ **마지막 `\n` 까지만 검열해 보낸다**(§2.1 · C6). 좌표 `raw_off` 가 늘 그 자리이고, 본문과 좌표가 같은 구간이어야
+   *   서버 행의 끝이 곧 이 좌표다. 쓰는 중인 반쪽 끝 줄은 다음 바퀴로 넘긴다(전에는 그 줄에서 JSON 이 깨져 통째로 실패했다).
+   * `raw_sha` 는 뜻 그대로 **원본 전체**의 sha 다(후보 쪽 `rawShaOf()` 와 같은 범위 — 사본 판정이 갈리지 않게).
+   * 접두 [0,to) 의 sha(`ck_sha`)는 같은 해시 상태를 복사해 한 번 읽기로 낸다 — 대응표에만 적고 서버에는 안 보낸다.
+   */
+  const to = bytes.lastIndexOf(0x0a) + 1;
+  const hasher = crypto.createHash('sha256').update(bytes.subarray(0, to));
+  const ckSha = hasher.copy().digest('hex');
+  const rawSha = hasher.update(bytes.subarray(to)).digest('hex');
+  /*
+   * ★ **Cursor 의 다 쓴 끝 줄은 싣는다 — 좌표 없이**(C6 반박 equiv). 위 끊기 규칙은 Claude Code 전사의 전제(모든 줄이 `\n` 으로
+   *   끝난다 — 이 기계 148/148)다. Cursor 는 **다 끝난 대화**인데도 마지막 줄에 개행이 없는 것이 있다(173개 중 3개, 끝 줄은 전부
+   *   온전한 JSON · assistant 답). 그 줄을 넘기면 파일이 안 자라는 한 영영 안 올라간다 — 색인 raw_sha 는 원본 전체라 「이미 올렸다」로
+   *   보고, 사람의 push_session 도 한 줄 빠진 채 성공한다(C6 전에는 올라갔다 — 퇴행).
+   *   그래서 Cursor 전사이고 끝 줄이 **온전한 JSON 객체**면 [0,끝) 을 검열해 보내되 **좌표는 안 싣는다**: 좌표 `raw_off` 는 늘 마지막
+   *   `\n` 바로 뒤여야 하고(§2.1), 본문과 좌표가 다른 구간이면 서버 행의 끝이 좌표가 아니다. 대응표도 지워진다(좌표 없는 FULL) —
+   *   그러면 다음 갱신(C8)은 대응표가 없어 FULL 로 간다. 반쪽 끝 줄(파싱 안 됨)은 Cursor 여도 전처럼 다음 바퀴로 넘긴다.
+   *   Claude Code 전사는 그대로다 — 다 쓴 줄이 개행 직전에 잠깐 보이는 창에서 그 줄을 실으면 머리 끊기 규칙(transcriptHead)과 갈린다.
+   */
+  const sc = scrubTranscript(bytes.subarray(0, tailDone ? bytes.length : to).toString('utf8'));
   const before = bytes.length;
+  const held = hooks?.check ? String(hooks.check(sc) || '') : '';
+  if (held) throw Object.assign(new Error(`자동 올리기를 보류했다(${held})`), { code: held, status: 0 });
+  const progressed = () => { try { hooks?.progress?.(); } catch { /* 임대 시계를 못 밀어도 올리기는 계속한다 */ } };
   /*
    * ★ **제목을 안 정했으면 키를 아예 뺀다.** 예전에는 `title: title || ''` 로 빈 문자열을
    * **명시해서** 보냈고 서버가 그것으로 기존 제목을 덮었다. 자동 올리기는 제목 없이 부르므로
@@ -2072,7 +3150,6 @@ async function pushSession(tenant, uuid, title, dryRun, bind = 'skip', auto = nu
    *   같은 창의 Cursor MCP 면 워크스페이스 폴더가 진짜 자리다(cursorWorkspaceFolder) —
    *   그것도 모르면 **빈 값**으로 둔다. 모르는 것은 모른다고 적는다(자리 판정은 빈 자리를 안다).
    */
-  const isCursorBody = f.includes(`${path.sep}.cursor${path.sep}projects${path.sep}`);
   const body = {
     tenant, uuid,
     origin_cwd: sc.cwd || (isCursorBody ? relHome(cursorWorkspaceFolder() || '') : relHome(process.cwd())),
@@ -2086,10 +3163,9 @@ async function pushSession(tenant, uuid, title, dryRun, bind = 'skip', auto = nu
    * 들어 있을 수 있어 원문을 안 보낸다. 자리는 origin_cwd 와 같은 차례로 고른다(본문 최빈 cwd →
    * Cursor 창 폴더 → 이 프로세스). 집·임시 폴더이거나 identity 를 못 만들면 folder 를 안 싣는다.
    */
-  body.bind = bind === 'propose' ? 'propose' : 'skip';
+  body.bind = bindOf;
   if (body.bind === 'propose') {
-    const place = sc.cwd_raw || (isCursorBody ? (cursorWorkspaceFolder() || '') : process.cwd());
-    const folder = place ? folderForPush(folderOf(place)) : null;
+    const folder = pushProposeFolder(sc, isCursorBody);
     if (folder) body.folder = folder;
   }
   /*
@@ -2104,17 +3180,15 @@ async function pushSession(tenant, uuid, title, dryRun, bind = 'skip', auto = nu
    *   하나도 없었다 — 대리 표지가 바뀌는 날 사람의 push_session 이 통째로 막힌다.
    *   사람의 올리기는 `push_session` 도구 하나뿐이고 그 갈래만 `bind:'propose'` 로 온다(심박의 갱신은 `'skip'`).
    */
-  let headers;
-  if (!auto && body.bind === 'propose') headers = { 'X-Genetics-Push': 'human' };
+  // 머리 셋은 길을 고르기 전에 이미 섰다(이 함수 머리) — 덧붙임도 **같은 머리**로 간다.
   if (auto) {
+    // 32MB 의 뜻은 **서버 사본 한 벌의 크기**다(§3.1). FULL 은 보내는 검열본 전체가 곧 그 사본이라 같은 값을 잰다.
     const prep = Buffer.byteLength(sc.jsonl, 'utf8') > AUTO_BODY_MAX ? { code: 'too_big' } : auto.prepare(sc);
     if (prep.code) {
       throw Object.assign(new Error(`자동 올리기를 보류했다(${prep.code})`),
         { code: prep.code, status: prep.code === 'place_unreadable' ? 422 : 0 });   // 서버가 같은 이유로 내는 422 와 같은 무게
     }
     body.folder = prep.folder;
-    headers = { 'X-Genetics-Binding': String(auto.binding_id), 'X-Genetics-Device': auto.device,
-                'X-Genetics-Client': `genetics-mcp/${VERSION}` };
   }
 
   /*
@@ -2132,13 +3206,51 @@ async function pushSession(tenant, uuid, title, dryRun, bind = 'skip', auto = nu
    *   검열 뒤 43.9MB). 「먼저 dry_run」이 권장 절차라 사실상 올릴 길이 없었다. 서버가 조각
    *   dry_run 을 받는다(조각마다 세고 파일만 안 만든다). `body.dry_run` 이 조각마다 실린다.
    */
+  /*
+   * ── 좌표(§2.9 · C6) — FULL 이 `raw:{key_id,to,head_mac,win_mac_to}`·`scrub_rev`·`base.rev`(대응표가 있으면)를 싣는다 ──
+   * 조각 길이면 **마지막 조각에만** 싣는다(서버는 조각마다 모양을 재고 마지막 조각의 것만 쓴다 — 앞에 실을 까닭이 없다).
+   * 옛 서버는 모르는 칸을 무시하고 전체 교체를 한다 — 뜻이 안 틀어진다. 키가 없으면 좌표 없이 옛 봉투 그대로다.
+   * ⚠ **dry_run 은 키도 대응표도 안 만든다** — 서버가 행을 안 쓰는 시험 실행이 좌표 캐시를 세우면 다음 판정이 거짓 기반을 믿는다.
+   */
+  let coords = null;
+  let coordEnv = {};
+  if (!dryRun && !tailDone) {                       // Cursor 의 다 쓴 끝 줄을 실은 FULL 은 좌표 없이(위 tailDone)
+    const key = pushKey();
+    if (key) {
+      coords = pushCoords(key, bytes, to);
+      const L = ledgerRead(uuid);
+      coordEnv = { raw: coords, scrub_rev: SCRUB_REV,
+        ...(L && L.key_id === coords.key_id && Number.isInteger(L.rev) && L.rev >= 0 ? { base: { rev: L.rev } } : {}) };
+    }
+  }
+  const ledgerCtx = { ino: String(st.ino), dev: String(st.dev), ck_sha: ckSha, cwd_hist: sc.cwd_hist,
+                      line_off: countLines(bytes.subarray(0, to)) };
+
   const parts = splitAtLines(sc.jsonl, PUSH_PART_MAX);
+  /*
+   * ★ **FULL 도 봉투 바이트로 잰다**(C8 반박 cost①). 위 나누기는 검열본 6MiB 를 재는데, 보내는 것은 그것을 한 번 더 JSON 으로 싼
+   *   봉투다 — 따옴표·역빗금이 많은 줄은 부푼다(이 기계의 전사 25개 실측 최악 1.0983배 = 6.589MiB, 한 줄 최악 1.54배). 덧붙임은
+   *   `APPEND_ENV_MAX` 를 지키는데 FULL 만 넘으면, `post_max_size` 가 그 사이에 있을 때 **FULL 만** 200·`text/html` 로 조용히 죽는다
+   *   — 배포 직후·재기반·옛 서버가 전부 FULL 로 온다. 그래서 봉투가 상한을 넘는 조각은 줄 경계에서 반씩 더 쪼갠다.
+   *   조각 번호·upload_id·head_ms 칸은 **가장 긴 모양**으로 채워 잰다(한 조각 봉투는 그보다 작다 — 넉넉한 쪽).
+   *   줄 하나가 넘으면 더 못 쪼갠다 — 그대로 보내고 서버의 답(413)에 맡긴다.
+   */
+  const envOf = (jsonl) => Buffer.byteLength(JSON.stringify({ ...body, ...coordEnv, jsonl,
+    upload_id: 'f'.repeat(24), part: 99999, parts: 99999, ...(auto ? { head_ms: 9_999_999_999_999 } : {}) }), 'utf8');
+  for (let i = 0; i < parts.length;) {
+    if (envOf(parts[i]) <= APPEND_ENV_MAX) { i++; continue; }
+    const two = splitAtLines(parts[i], Math.max(1, Math.floor(Buffer.byteLength(parts[i], 'utf8') / 2)));
+    if (two.length < 2) { i++; continue; }
+    parts.splice(i, 1, ...two);
+  }
   if (parts.length === 1) {
-    const r = await api('PUT', '/api/sessions', body, { headers });
-    // `auto` — 서버가 받았으므로 서버발 막음 표(too_old·hidden·hold)를 지운다. 사람의 손 올리기가 실제로 푸는 자리다(호환 C2).
-    //   hidden·hold 표는 **받은 소속처가 그 표의 소속처일 때만** 지운다(호환 N9 — `autoClearOnPush()`).
-    if (!dryRun) indexNote(uuid, { src: 'push', tenant: r.tenant || tenant, tenant_id: r.tenant_id, head_id: r.head_id, head_ms: r.head_ms, raw_sha: rawSha, auto: autoClearOnPush(r.tenant_id), ...(r.tenant_slug ? { tenant_slug: r.tenant_slug } : {}) }, 'tx');
-    return { r, before, parts: 1, raw_sha: rawSha };
+    // 상한은 **보내는 바이트에 맞춘다**(호환 1-B) — 6MiB 를 120초로 못 올리는 링크가 실재한다.
+    const r = await api('PUT', '/api/sessions', { ...body, ...coordEnv },
+      { headers, timeout_ms: apiTimeoutFor(Buffer.byteLength(parts[0], 'utf8')) });
+    progressed();
+    if (!dryRun) ledgerAfterFull(uuid, r, coords, ledgerCtx);
+    if (!dryRun) pushIndexNote(uuid, tenant, r, rawSha);
+    return { r, before, parts: 1, raw_sha: rawSha, plan, appended: 0 };
   }
 
   /*
@@ -2167,14 +3279,36 @@ async function pushSession(tenant, uuid, title, dryRun, bind = 'skip', auto = nu
       ...body, jsonl: parts[i],
       upload_id: uploadId, part: i + 1, parts: parts.length,
       ...(auto ? { head_ms: autoHeadMs } : {}),     // 관문 11 은 조각마다 선다 — 첫 조각에만 실으면 둘째부터 409 다
-    }, { headers });
+      ...(i === parts.length - 1 ? coordEnv : {}),  // 좌표는 마지막 조각에만(§2.9)
+    }, { headers, timeout_ms: apiTimeoutFor(Buffer.byteLength(parts[i], 'utf8')) });
+    progressed();
     // 바이트로 적는다 — `.length` 는 UTF-16 단위라 한글이 3배로 어긋난다(splitAtLines 의 그 함정).
     process.stderr.write(`genetics: 조각 ${i + 1}/${parts.length} ${dryRun ? '시험' : '올림'} `
       + `(${(Buffer.byteLength(parts[i], 'utf8') / 1048576).toFixed(1)}MB)\n`);
   }
+  if (!dryRun) ledgerAfterFull(uuid, last, coords, ledgerCtx);
   // 〃 조각 올리기도 같다 — 마지막 조각까지 받았으면 그 uuid 에 대한 막음은 지금 안 선다(호환 C2 · 소속처 견줌은 N9).
-  if (!dryRun) indexNote(uuid, { src: 'push', tenant: last.tenant || tenant, tenant_id: last.tenant_id, head_id: last.head_id, head_ms: last.head_ms, raw_sha: rawSha, auto: autoClearOnPush(last.tenant_id), ...(last.tenant_slug ? { tenant_slug: last.tenant_slug } : {}) }, 'tx');
-  return { r: last, before, parts: parts.length, raw_sha: rawSha };
+  if (!dryRun) pushIndexNote(uuid, tenant, last, rawSha);
+  return { r: last, before, parts: parts.length, raw_sha: rawSha, plan, appended: 0 };
+}
+
+/**
+ * 성공한 올리기가 색인에 적는 것 — **한 자리**(FULL 셋과 덧붙임이 같은 줄을 지난다).
+ * 서버가 받았으므로 서버발 막음 표(too_old·hidden·hold)를 지운다. 사람의 손 올리기가 실제로 푸는 자리다(호환 C2).
+ *   hidden·hold 표는 **받은 소속처가 그 표의 소속처일 때만** 지운다(호환 N9 — `autoClearOnPush()`).
+ * ⚠ `raw_sha`(원본 전체의 sha)는 **FULL 에서만** 적는다(§2.10) — 덧붙임은 원본 전체를 안 읽으므로 그 값을 모른다.
+ *   그래서 사본(dup) 판정의 비교 대상도 「색인에 적힌 지문」이 아니라 **지금 디스크의 파일**로 바뀌었다(`autoDupOf`).
+ */
+function pushIndexNote(uuid, tenant, r, rawSha) {
+  indexNote(uuid, { src: 'push', tenant: r.tenant || tenant, tenant_id: r.tenant_id, head_id: r.head_id, head_ms: r.head_ms,
+    ...(rawSha ? { raw_sha: rawSha } : {}), auto: autoClearOnPush(r.tenant_id),
+    ...(r.tenant_slug ? { tenant_slug: r.tenant_slug } : {}) }, 'tx');
+}
+
+/** 폴더 제안(§4.2)의 자리 — 본문 최빈 cwd → Cursor 창 폴더 → 이 프로세스. FULL 과 덧붙임이 같은 자를 쓴다. */
+function pushProposeFolder(sc, isCursorBody) {
+  const place = sc.cwd_raw || (isCursorBody ? (cursorWorkspaceFolder() || '') : process.cwd());
+  return place ? folderForPush(folderOf(place)) : null;
 }
 
 /* ── 코로케이션 심박 ───────────────────────────────────────────────────
@@ -2326,25 +3460,33 @@ function indexRowSame(a, b) {
 /**
  * @param {string} uuid
  * @param {null|{tenant_id:number, tenant_slug?:string, tenant?:string, src?:string}} tenant 서버가 준 소속. null 이면 소속 칸을 안 건드린다
- * @param {object} patch 소속 밖 칸 — 소속 칸이 섞여 오면 버린다
+ * @param {object|((row: object|null) => (object|null))} patch 소속 밖 칸 — 소속 칸이 섞여 오면 버린다. **함수면 잠금 안에서**
+ *   파일의 그 행을 받아 patch 를 낸다(null 이면 안 쓴다) — 입구가 실패 수를 「읽고 +1」 하는 자리(race S6 · C7)
  * @param {''|'tx'|'rx'} flow
- * @param {null|((row: object|null) => boolean)} [guard] 잠금 안에서 파일의 그 행을 보고 거짓이면 안 쓴다(자동 올리기의 선점 — §5.5)
+ * @param {null|((row: object|null) => boolean)} [guard] 잠금 안에서 파일의 그 행을 보고 거짓이면 안 쓴다(보류·막음 표의 견줌 — §5.5)
  */
 function indexWrite(uuid, tenant, patch, flow, guard = null) {
   if (typeof uuid !== 'string' || uuid === '' || uuid === '_v') return false;
-  const p = {};
-  for (const [k, v] of Object.entries(patch || {})) {
-    if (k === '_v' || INDEX_TENANT_KEYS.includes(k) || v === undefined) continue;
-    p[k] = v;
-  }
   const now = Date.now();
-  if (flow === 'tx') p.tx_at = now;
-  if (flow === 'rx') p.rx_at = now;
+  const clean = (src) => {
+    const p = {};
+    for (const [k, v] of Object.entries(src || {})) {
+      if (k === '_v' || INDEX_TENANT_KEYS.includes(k) || v === undefined) continue;
+      p[k] = v;
+    }
+    if (flow === 'tx') p.tx_at = now;
+    if (flow === 'rx') p.rx_at = now;
+    return p;
+  };
+  const fixed = typeof patch === 'function' ? null : clean(patch);
   // (판 8 — 적합성 F7) 성공한 올리기는 **그 소속처의** 곁 표도 걷는다 — 파일의 표와 같은 견줌(`autoBlockClearedBy()`).
-  if (p.auto && typeof p.auto === 'object' && Object.hasOwn(p.auto, AUTO_UNBLOCK_KEY)) {
-    const a = autoBlockAside.get(uuid.toLowerCase());
-    if (a && autoBlockClearedBy(a, p.auto[AUTO_UNBLOCK_KEY])) autoBlockAside.delete(uuid.toLowerCase());
-  }
+  const unblockAside = (p) => {
+    if (p.auto && typeof p.auto === 'object' && Object.hasOwn(p.auto, AUTO_UNBLOCK_KEY)) {
+      const a = autoBlockAside.get(uuid.toLowerCase());
+      if (a && autoBlockClearedBy(a, p.auto[AUTO_UNBLOCK_KEY])) autoBlockAside.delete(uuid.toLowerCase());
+    }
+  };
+  if (fixed) unblockAside(fixed);
   const r = jsonFileUpdate(INDEX_FILE, (cur) => {
     const idx = { _v: 2, ...cur };
     idx._v = 2;                       // 옛 판은 이 줄을 e?.tenant_id 로 걸러 무시한다
@@ -2353,6 +3495,13 @@ function indexWrite(uuid, tenant, patch, flow, guard = null) {
     // patch 만 남기면 그 행의 나머지 칸(머리·소속)을 잃고, 그 반쪽 행이 메모리 사본까지 덮는다.
     const was = had ? idx[uuid] : (indexMine.get(uuid) || {});
     if (guard && !guard(had ? idx[uuid] : null)) return null;
+    let p = fixed;
+    if (!p) {
+      const got = patch(had ? idx[uuid] : null);
+      if (!got || typeof got !== 'object') return null;
+      p = clean(got);
+      unblockAside(p);
+    }
     let row = { ...was, ...p };
     // `auto`(백오프·보류, §5.1)는 칸끼리 합친다 — 백오프만 고치는 쓰기가 사람이 세운 hold 를 지우면 안 된다.
     if (p.auto && typeof p.auto === 'object') row.auto = { ...(was.auto && typeof was.auto === 'object' ? was.auto : {}), ...p.auto };
@@ -2415,24 +3564,6 @@ function indexNote(uuid, entry, flow = '') {
   catch { /* 색인은 있으면 좋은 것이지 도구가 실패할 이유가 아니다 */ }
 }
 
-/**
- * 자동 올리기의 **선점**(§5.5) — 이 기계의 창 여럿이 같은 후보를 한꺼번에 올리지 않게, 잠금 안에서 그 행의
- * `auto.next_at`(다음 시도 시각)을 보고 비어 있거나 지났을 때만 `until` 로 세운다. 보류(hold)면 안 잡는다.
- * 올리다 죽어도 선점은 `until` 에 저절로 풀린다 — 새 칸을 만들지 않고 백오프 칸 하나로 한다.
- */
-function indexClaim(uuid, until, now = Date.now()) {
-  let got = false;
-  let ok = false;
-  try {
-    ok = indexWrite(uuid, null, { auto: { next_at: until } }, '', (row) => {
-      const a = row?.auto;
-      got = !(a?.hold === true || Number(a?.next_at) > now);
-      return got;
-    });
-  } catch { return false; }
-  return got && ok;
-}
-
 /**
  * 사본의 **머리** — 마지막으로 남은 발화의 id·시각, 그리고 줄 수.
  *
@@ -2459,7 +3590,13 @@ function transcriptHead(file) {
     // 앞이 잘린 줄은 버린다 — 반쪽 JSON 은 파싱이 안 되지만, 버리는 것을 **의도로** 적어 둔다.
     // (개행이 하나도 없으면 꼬리 전체가 잘린 한 줄이다 — 남는 것이 없다.)
     const cut = from > 0 ? text.indexOf('\n') : -1;
-    const head = jsonlHead(from > 0 ? (cut < 0 ? '' : text.slice(cut + 1)) : text);
+    const whole = from > 0 ? (cut < 0 ? '' : text.slice(cut + 1)) : text;
+    // ★ **끊기 규칙**(§2.1 · C6): 개행 없는 끝 줄은 머리가 아니다 — 쓰는 중인 반쪽 줄이거나, 다 쓴 줄이어도 아직
+    //   올릴 좌표(`raw_off` = 마지막 `\n` 바로 뒤) 밖이다. 서버가 가진 본문은 늘 `\n` 으로 끝나므로, 여기서 끝 줄을
+    //   머리로 잡으면 덧붙임이 그 줄을 안 실은 채 머리만 앞서 SAME 으로 수렴하지 못한다(compat G1).
+    //   ⚠ jsonlHead 에 넣지 않는다 — 그 함수는 늘 `\n` 으로 끝나는 검열본(조각 봉투 head_ms)에도 쓰인다.
+    const endNl = whole.lastIndexOf('\n');
+    const head = jsonlHead(endNl < 0 ? '' : whole.slice(0, endNl + 1));
 
     // 줄 수 — 늘어난 만큼만 센다. 처음 보는 파일·줄어든 파일은 처음부터 세되 **파일을 통째로 올리지 않는다**
     // (2026-09-17: 38MB 전사를 `Buffer.alloc(size)` 로 올려 바이트 루프로 세던 자리가 부팅·압축 뒤의 버스트였다).
@@ -3207,7 +4344,6 @@ function autoPushSilence() {
    */
   process.stderr.write(`${tenantNoticeText({ state: 'bound', auto_upload: true, env_off: true })}\n`);
 }
-const autoPushAt = new Map();
 /*
  * §5.4 「bound·auto on」(동의 표시)을 도구 꼬리로 낸 **폴더들** — 그 폴더의 전사는 그 뒤에만 올라간다.
  *
@@ -3252,7 +4388,10 @@ function autoConsentGiven(e) {
 const AUTO_SCAN_EVERY_MS = 5 * 60_000;              // 되찾기 훑기는 5분에 한 번
 const AUTO_SCAN_MAX_AGE_MS = 30 * 24 * 3600_000;    // 【선언】 mtime 30일 안
 const AUTO_SCAN_PER_FOLDER = 200;                   // 폴더당 최대 200개
-const AUTO_BODY_MAX = 32 * 1024 * 1024;             // 【선언】 검열본 32MB — 넘으면 안 올리고 한 번 말한다
+// 【선언】 검열본 32MB — 넘으면 안 올리고 한 번 말한다. 뜻은 **서버 사본 한 벌의 크기**다(DESIGN-session-delta-sync §3.1 · C7) —
+//   길이 FULL 뿐인 지금은 보내는 검열본 전체가 곧 그 사본이라 같은 값을 잰다. 덧붙임(C8)은 `row.bytes + 조각` 으로 잰다.
+//   확정 폴더(bound) 갈래에서만 건다 — 옛 길에는 안 씌운다(오너 결정 §0-1).
+const AUTO_BODY_MAX = 32 * 1024 * 1024;
 const AUTO_BACKOFF_BASE_MS = 60_000;                // 실패 백오프 1분 → 2분 → 4분 …
 const AUTO_BACKOFF_CAP_MS = 6 * 3600_000;           // … 6시간 상한
 const AUTO_BACKOFF_LONG_MS = 24 * 3600_000;         // 403·409·422·426 → 24시간
@@ -3306,6 +4445,11 @@ function autoClearOnPush(tenantId) {
  *   늘 resolve 가 먼저라(§5.5) 새 서버의 답이 올리기 전에 다시 세운다. 옛 서버(409 만 말한다)에서는 프로세스마다
  *   한 번 보낸 뒤 선다 — 두 소속처가 같은 uuid 를 함께 막은 드문 자리의 값이다. 푸는 길은 파일의 표와 같다
  *   (그 소속처로의 성공한 올리기 — `indexWrite()` 의 `unblock_tenant` · 그 소속처 resolve 의 `hold:false`).
+ * ⚠ (C7) 설계(DESIGN-session-delta-sync §3.2)는 이 표를 「색인 쓰기가 실패할 때의 곁 표」로 읽고 걷는 목록에 넣었지만,
+ *   **이 표의 일은 그것이 아니다** — 색인 쓰기는 **성공한** 채로 「한 칸을 이미 다른 소속처가 쥐었다」(`'foreign'`)는 소유권의
+ *   답이다. 입구가 「색인을 못 읽거나 못 쓰면 안 올린다」를 세워도 이 자리는 안 사라진다(걷으면 F7 이 되돌아온다: A 가 뺀
+ *   대화가 B 의 hold:false 로 A 로 다시 간다). 그래서 **남긴다**. 걷으려면 색인 `auto.blocked` 를 소속처별로 두는 모양 바꿈이
+ *   먼저다 — 그것은 옛 판이 읽는 칸의 모양이라 C7 밖의 결정이다(C8·오너로 넘김).
  */
 const autoBlockAside = new Map();
 
@@ -3472,8 +4616,8 @@ function autoTooOldMark(uuid, tooOld, mtime) {
 /**
  * 후보 하나를 거른다(§5.5 3) — 빈 문자열이면 올려도 된다. **순수 함수**(시험이 표로 잰다).
  * @param {{uuid:string, entry:?object, private_file?:boolean, row?:?object, raw_sha?:string, mtime?:number, head_ms?:number}} c
- * @param {{now:number, env_on:boolean, shas?:Map<string,string>, holds?:Set<string>, holds_ok?:boolean}} ctx
- *        shas: 색인의 raw_sha → 그 uuid · holds: 색인 밖 보류 명부(§5.8) · holds_ok=false 면 전부 보류
+ * @param {{now:number, env_on:boolean, dupOf?:(c:object)=>boolean, holds?:Set<string>, holds_ok?:boolean}} ctx
+ *        dupOf: 이 후보와 바이트째 같은 다른 uuid 가 있나(첫 업로드 후보에만 · C8) · holds: 색인 밖 보류 명부(§5.8) · holds_ok=false 면 전부 보류
  */
 function autoSkipReason(c, ctx) {
   const e = c?.entry;
@@ -3504,13 +4648,10 @@ function autoSkipReason(c, ctx) {
    *     답하면 푼다(`autoBlockFromResolve()` — 포털에서 가림·보류를 푼 사실이 이 기계에 닿는 길, 부록 D-30).
    *     ⚠ 옛 서버(`hold` 칸 없음)·`none` 답으로는 안 푼다 — 그때는 사람이 한 번 올리면 된다.
    */
-  const blocked = row.auto?.blocked;
-  if (blocked && AUTO_STICKY_409.has(String(blocked.code))
-      && (!(Number(blocked.tenant_id) > 0) || Number(blocked.tenant_id) === Number(e.tenant_id))) return String(blocked.code);
-  // (판 8 — 적합성 F7) 파일의 표가 다른 소속처의 것이라 못 적은 막음 — 이 프로세스의 곁 표. 소속처가 같을 때만 선다.
-  const aside = ctx.aside?.get?.(String(c.uuid || '').toLowerCase());
-  if (aside && AUTO_STICKY_409.has(String(aside.code))
-      && Number(aside.tenant_id) > 0 && Number(aside.tenant_id) === Number(e.tenant_id)) return String(aside.code);
+  // (판 8 — 적합성 F7) 파일의 표가 다른 소속처의 것이라 못 적은 막음은 이 프로세스의 곁 표(ctx.aside) — 소속처가 같을 때만 선다.
+  //   판정은 옛 길의 입구와 **같은 한 벌**(`autoBlockedFor()` · C7)이다.
+  const blocked = autoBlockedFor(row, e.tenant_id, ctx.aside?.get?.(String(c.uuid || '').toLowerCase()));
+  if (blocked) return blocked;
   /*
    * 동의 앞의 대화는 안 올린다(D3) — 잰 자리가 없는 후보(순수 시험의 표)는 이 줄을 안 탄다.
    * ① mtime 은 **싼 앞거르개**다: 파일이 하한보다 이르면 마지막 발화도 대개 그보다 이르다
@@ -3527,7 +4668,41 @@ function autoSkipReason(c, ctx) {
    */
   const tooOld = Number(row.auto?.too_old) || 0;
   if (tooOld > 0 && !(Number(c.head_ms) > 0 && Number(c.head_ms) >= tooOld)) return 'too_old';
-  if (c.raw_sha && ctx.shas?.has(c.raw_sha) && ctx.shas.get(c.raw_sha) !== c.uuid) return 'dup';
+  /*
+   * ★ **사본(dup) 은 첫 업로드 후보에만 건다 — 그리고 비교 대상은 「지금 디스크의 파일」이다**(§2.10 · cost G1 · C8).
+   *   전에는 색인의 `raw_sha`(마지막으로 올린 때의 지문)끼리 견줬다. 덧붙임이 서면 그 칸은 **마지막 FULL 때의 값**이라
+   *   자란 파일을 말하지 않는다 — 상대 쪽 지문이 낡아 거르개가 그냥 뚫린다(실패가 서버 계보로 옮겨 갈 뿐이다).
+   *   그리고 이미 올라간 대화가 자라는 것은 사본이 아니라 제 자리로 자라는 것이다.
+   */
+  if (c.first && typeof ctx.dupOf === 'function' && ctx.dupOf(c)) return 'dup';
+  return '';
+}
+
+/**
+ * 사본(dup) 판정 — 이 후보와 **바이트째 같은** 다른 uuid 가 이 기계에 있나(§2.10). 없으면 ''.
+ * 한 번 이상 올라간 다른 uuid 의 전사 가운데 **크기가 같은 것**만 해시해 견준다 — 평소 비용은 stat 뿐이다.
+ * `rawShaOf` 는 (크기, mtime) 로 기억하므로 같은 파일을 두 번 안 읽는다.
+ */
+function autoDupOf(uuid, file, idx) {
+  let size = -1;
+  try { size = fs.statSync(file).size; } catch { return ''; }
+  if (!(size > 0)) return '';
+  const same = [];
+  for (const [u, row] of Object.entries(idx || {})) {
+    if (u === uuid || !AUTO_UUID_RE.test(u) || !row || typeof row !== 'object') continue;
+    // 한 번도 안 올라간 행은 견줄 대상이 아니다 — 「이미 올라간 다른 대화의 사본인가」가 이 판정의 뜻이다.
+    if (!autoRowOnServer(row) && !(typeof row.raw_sha === 'string' && row.raw_sha !== '')) continue;
+    const f = transcriptOf(u);
+    if (!f || f === file) continue;
+    let s;
+    try { s = fs.statSync(f); } catch { continue; }
+    if (s.size !== size) continue;
+    same.push({ uuid: u, file: f });
+  }
+  if (!same.length) return '';
+  const my = rawShaOf(file);
+  if (!my) return '';
+  for (const m of same) if (rawShaOf(m.file) === my) return m.uuid;
   return '';
 }
 
@@ -3635,15 +4810,19 @@ function autoCandidates(now = Date.now()) {
   return out;
 }
 
+/**
+ * 한 바퀴의 **잠금 밖 스냅숏** — 심박 **앞에서** 한 번 뜬다(beatTick). 거르개가 싸게 먼저 걸러 헛된 임대 잡기를 줄이는 데만 쓴다.
+ * ⚠ 보증이 아니다: 입구(`autoEntrance()`)가 임대 안에서 색인을 **다시** 읽어 같은 판정을 한 번 더 한다(race M4 · C7).
+ *   `idx` 는 그때의 색인 사본 — 못 읽었으면 `{}` 다(여기서는 그래도 된다 — 입구가 못 읽음을 따로 가른다).
+ */
 function autoContext(now = Date.now()) {
-  const shas = new Map();
-  for (const [u, row] of Object.entries(indexRead())) {
-    if (AUTO_UUID_RE.test(u) && row && typeof row.raw_sha === 'string' && row.raw_sha !== '' && !shas.has(row.raw_sha)) shas.set(row.raw_sha, u);
-  }
+  const idx = indexRead();
+  // 사본 거르개는 **부를 때** 잰다(첫 업로드 후보에만) — 바퀴마다 모든 행의 지문을 미리 짓지 않는다(§2.10 · cost G1).
+  const dupOf = (c) => !!autoDupOf(c.uuid, c.file, idx);
   const h = autoHoldsRead();          // 색인 밖 보류 명부 — 못 읽으면 이 바퀴는 아무것도 안 올린다(H2)
   // 닫는 쪽으로 실패하되 **조용히는 아니다** — 이 상태가 이어지면 자동 올리기가 영영 안 돈다. 사람이 고칠 수 있게 한 번 말한다.
   if (!h.ok) warnOnce('auto-holds-unreadable', `${HOLDS_FILE} 를 못 읽어 이 기계의 자동 올리기를 전부 멈춘다(무엇이 보류인지 모르므로). 그 파일을 고치거나 지우면 다시 돈다.`);
-  return { now, env_on: autoPushOn(), shas, holds: h.set, holds_ok: h.ok, aside: autoBlockAside };
+  return { now, idx, env_on: autoPushOn(), dupOf, holds: h.set, holds_ok: h.ok, aside: autoBlockAside };
 }
 
 /** 서버 최소 판보다 낡았는가 — 그러면 자동 올리기를 안 두드린다(서버가 426 으로 막을 자리다, §4.3 관문 2). */
@@ -3708,13 +4887,18 @@ function autoBeatRecs(cands, ctx) {
 /**
  * 이 대화가 거쳐 간 자리 **전부**에 `.genetics-private` 이 있나(개인정보 검토 m1).
  * 최빈 자리 하나만 보면, 세션의 일부가 사적인 하위 폴더에서 돌아도 그 대화가 통째로 올라간다.
+ * ★ 재료는 `cwd_hist` 의 **열쇠 전부**다(§2.2 · C6) — 예전 재료(`cwds_raw`)는 빈도순 상위 64 로 잘려서, 한 번만 들른
+ *   사적 폴더(65위 아래)가 판정에서 빠졌다. `cwd_hist` 가 없는 입력(옛 모양)만 `cwds_raw` 로 물러선다.
  */
 function autoPrivateAnyCwd(sc, stopReal) {
-  for (const raw of (Array.isArray(sc.cwds_raw) ? sc.cwds_raw : [])) {
+  const places = sc?.cwd_hist && typeof sc.cwd_hist === 'object' ? Object.keys(sc.cwd_hist)
+    : (Array.isArray(sc?.cwds_raw) ? sc.cwds_raw : []);
+  for (const raw of places) {
     let r = String(raw || '');
     if (!r) continue;
     try { r = fs.realpathSync(r); } catch { /* 없는 자리면 준 값 그대로 */ }
-    if (privateFileFor(r, stopReal)) return true;
+    // 멈출 자리는 한 곳(확정 폴더의 뿌리)이거나, 자리마다 정하는 함수(옛 길 — 그 자리의 git 뿌리, C7)다.
+    if (privateFileFor(r, typeof stopReal === 'function' ? stopReal(r) : stopReal)) return true;
   }
   return false;
 }
@@ -3722,6 +4906,8 @@ function autoPrivateAnyCwd(sc, stopReal) {
 /** 보내기 직전 — 본문의 자리(최빈 cwd, realpath)가 그 확정 폴더 안인가. 맞으면 서버 관문 5·6 이 대조할 `folder` 를 낸다. */
 function autoPrepare(sc, c) {
   const e = c.entry;
+  // 거쳐 간 자리가 너무 많으면 private 판정을 다 못 잰다 — 자동 길은 **닫힌 쪽**으로 멈춘다(§2.2). 사람의 push 는 이 함수를 안 지난다.
+  if (autoHistOverflow(sc)) return { code: 'cwd_hist_overflow' };
   let real = String(sc.cwd_raw || '');
   if (!real) return { code: 'place_unreadable' };
   try { real = fs.realpathSync(real); } catch { /* 없는 자리면 준 값 그대로 */ }
@@ -3739,122 +4925,522 @@ function autoPrepare(sc, c) {
   return { folder: { kind: 'path', identity: id, subpath: '', path: bound } };
 }
 
-/** 후보 하나를 올린다 — 머리 셋을 붙인 PUT(§4.3). 결과를 색인 `auto` 에 적는다(성공은 비우고, 실패는 물러선다). */
-async function autoUploadOne(c) {
-  const e = c.entry;
-  const u8 = c.uuid.slice(0, 8);
+/* ── 한 입구 (DESIGN-session-delta-sync §3 · C7) ─────────────────────────────────────────────────────
+ *
+ * 무엇을 푸는가: 이 기계에는 MCP 창이 열 개 넘게 돈다. 전에는 자동 올리기가 두 길(① 확정 폴더 · ② 옛 길)로 갈라져 있었고,
+ *   「한 대화는 기계에서 한 번만 올린다」가 ① 에만, 그것도 **보내는 동안만** 섰다(`indexClaim` 선점 → 성공하면 `next_at:0` 으로
+ *   되돌림 — 「방금 보냈다」를 아무도 못 봤다). ② 는 프로세스 메모리(`autoPushAt`)뿐이라 창 N 개가 같은 대화를 N 번 보냈다
+ *   (2026-09-21 실측: 5분 PUT 514회 중 68% 가 같은 머리).
+ * 이제 **모든 자동 올리기가 이 입구 하나**를 지난다: 기계 공용 임대(`push/<uuid>.lease`, 기존 `fileLock` 원시) → 임대 안에서
+ *   색인을 **다시 읽고** 모든 판정(간격·백오프·막음·닫힘·FULL 예산) → `pushSession`(사람과 같은 함수) → 결과를 잠금 안 mutate 로
+ *   → finally 에서 토큰으로 푼다. 판정을 임대 **밖**에서 하면 두 창이 모두 통과한 뒤 차례로 올린다(race M4) — 순서가 보증이다.
+ * 정책 상태는 새 저장소가 아니라 지금 기계 공용인 색인 `auto.*` 에 둔다(`last_at` 칸 하나를 더했다).
+ */
+/**
+ * 【선언】 임대의 묵음 한도 — **가장 큰 조각의 요청 상한** + 60초. 진전이 이만큼 없으면 남이 걷는다(§3.2 · race S1).
+ * 상한이 바이트에 비례하므로(`apiTimeoutFor`) 여기서도 그 최대값을 쓴다 — 한 곳을 고치면 둘이 함께 움직인다(호환 1-B).
+ * ⚠ 가장 큰 요청은 이제 **덧붙임 봉투**(`APPEND_ENV_MAX` 6.5MiB)다 — FULL 조각(검열본 6MiB)보다 크다. 둘 중 큰 쪽으로 잰다
+ *   (C8 반박 fail F4 — 전에는 선언한 「+60초」가 실제로 +44초였다).
+ */
+const LEASE_QUIET_MS = apiTimeoutFor(Math.max(PUSH_PART_MAX, APPEND_ENV_MAX)) + 60_000;
+/** 【선언】 사람의 push_session 이 임대를 기다리는 상한(§3.4) — 비동기로만(Atomics.wait 금지 · race S5). */
+const HUMAN_LEASE_WAIT_MS = 30_000;
+const HUMAN_LEASE_POLL_MS = 250;
+/*
+ * 【선언】 **FULL 예산**(§5 불변식 「전체 재전송으로 폭주하지 않는다」 · C7 이 C8 로 미룬 것). C7 에 못 둔 까닭 둘을 이 커밋이 먼저 풀었다:
+ *   ① 재료가 안 쌓였다 — `full_log` 가 **대응표** 안에 있어서, 서버가 좌표를 안 돌려주면 `ledgerAfterFull()` 이 대응표를 통째로
+ *      지우며 기록도 함께 갔다. → 기록을 **색인 `auto.full_log`** 로 옮겼다(정책 상태의 자리 · §2.11 「정책 상태는 대응표에 두지 않는다」).
+ *   ② 사람의 push 를 안 가렸다 — `ledgerAfterFull` 은 누가 불렀는지 모른다. → 기록하는 자를 **입구 하나**(`autoEntrance`)로 좁혔다.
+ *      사람의 `push_session` 은 예산을 **세지도 않고 받지도 않는다**(`hooks.plan` 을 안 건다).
+ * 그리고 뜻이 이제 선다: 길이 APPEND 라 예산은 **진짜 FULL(재기반)** 에만 걸린다(`PUSH_FULL_REBASE`) — 첫 업로드도, 옛 서버의
+ * FULL 도 안 센다. 넘으면 **조용히 버리지 않는다**: 색인에 `last_code:'full_budget'` 을 남기고 `next_at` 을 한 자리가 비는 시각으로 민다.
+ */
+/*
+ * 【선언】 **닫힌 쪽으로 멈추는 보류**(C6 넘김 · C7 결정): 사적 폴더(`private`)와 자리 4096 초과(`cwd_hist_overflow`).
+ *   둘 다 서버가 아니라 이 기계가 본문을 재서 내리는 판정이라, **파일이 그대로면 답도 그대로다**(cwd_hist 열쇠는 덧붙이기만으로는
+ *   줄지 않고, 표지 파일이 걷혀도 판정 재료는 같은 파일이다) — 전에는 일반 백오프(1분 → … 6시간)를 타서 그때마다 전사 전체를 다시
+ *   읽고 검열했다. 이제 그때의 크기·mtime 을 `auto.closed` 에 적고 **파일이 바뀔 때까지 다시 안 본다**. 바뀌면(자람·교체) 백오프가
+ *   지난 뒤 한 번 다시 잰다 — 사람이 표지를 걷었거나 전사가 갈렸을 수 있다. 판정은 크기·mtime `!==` 다(시계가 되돌아간 것도 「바뀜」).
+ */
+const AUTO_CLOSED_CODES = new Set(['private', 'cwd_hist_overflow']);
+
+function leaseFile(uuid) {
+  const f = ledgerFile(uuid);          // 같은 uuid 모양 검사 · 같은 자리(push/) — 대응표 옆
+  return f ? `${f.slice(0, -'.json'.length)}.lease` : '';
+}
+
+/**
+ * 임대를 **한 번만** 잡아 본다(비차단). `{h}` 잡음 · `{held:true}` 남이 쥐었다 · `{err}` 자리를 못 만들었다.
+ * ⚠ `fileLock` 은 EEXIST 가 아닌 실패(자리 없음 등)도 null 이라, 자리를 먼저 만들고 null 이면 파일이 있는지로 가른다 —
+ *   안 그러면 못 만든 자리가 「남이 올리는 중」으로 읽힌다.
+ */
+function leaseTake(uuid) {
+  const lock = leaseFile(uuid);
+  if (!lock) return { err: 'uuid' };
+  try { fs.mkdirSync(path.dirname(lock), { recursive: true, mode: 0o700 }); } catch (e) { return { err: String(e?.code || 'mkdir') }; }
+  // SIGKILL 로 죽은 창이 남긴 `<lease>.stale-*` — 임대는 `jsonFileUpdate` 를 안 지나 아무도 안 치웠다(반박 race·compat 2-D).
+  sweepLeftovers(lock);
+  const h = fileLock(lock, Date.now(), { stale: LEASE_QUIET_MS, lock });
+  if (h) return { h };
+  // ⚠ **못 읽는 임대를 「남이 쥠」으로 읽지 않는다**(반박 race). EACCES 면 `lockStaleText` 도 실패해 영영 조용히 안 올린다 —
+  //   까닭을 내면 입구가 `warnOnce` 로 말한다.
+  try { fs.readFileSync(lock, 'utf8'); } catch (e) { if (e?.code !== 'ENOENT') return { err: String(e?.code || 'read') }; }
+  return fs.existsSync(lock) ? { held: true } : { err: 'open' };
+}
+
+/** 진전(요청 하나가 끝남)이 있을 때만 임대의 mtime 을 민다 — 타이머로는 안 민다(race S1). 내 토큰일 때만. */
+function leaseTouch(h) {
   try {
-    const { r } = await pushSession(e.tenant_slug || e.tenant, c.uuid, '', false, 'skip',
-      { binding_id: Number(e.binding_id) || 0, device: deviceId(), prepare: (sc) => autoPrepare(sc, c) });
-    indexPatch(c.uuid, { auto: { fails: 0, next_at: 0, last_code: '', ...autoClearOnPush(Number(r?.tenant_id) || e.tenant_id) } });
-    process.stderr.write(`genetics: ${u8} 를 확정 폴더의 자동 올리기로 올렸다 — «${r.tenant || e.tenant}» · ${r.lines}줄.\n`);
-  } catch (err) {
-    const status = Number(err?.status) || 0;
-    const code = String(err?.code || (status ? `http_${status}` : 'error'));
-    const fails = (Number(indexRead()[c.uuid]?.auto?.fails) || 0) + 1;
+    if (fs.readFileSync(h.lock, 'utf8') !== h.token) return;
+    const t = new Date();
+    fs.utimesSync(h.lock, t, t);
+  } catch { /* 없어졌으면 민 것이 없다 */ }
+}
+
+/** 사람의 push_session 이 임대를 기다린다 — **비동기**(setTimeout)로만. 못 잡으면 null · 자리를 못 만들면 `{err}` 그대로. */
+async function leaseWait(uuid, ms = HUMAN_LEASE_WAIT_MS) {
+  const until = Date.now() + ms;
+  for (;;) {
+    const got = leaseTake(uuid);
+    if (!got.held) return got;
+    if (Date.now() >= until) return got;
+    await new Promise((r) => setTimeout(r, HUMAN_LEASE_POLL_MS));
+  }
+}
+
+/**
+ * 간격 — 이 기계의 누군가가 이 대화를 `AUTO_PUSH_MIN_MS` 안에 올렸나. **순수 함수.**
+ * 시계가 되돌아가 그 시각이 한참 미래면(간격보다 멀리) 그 값은 안 믿는다 — 그렇지 않으면 되돌린 만큼 멎는다.
+ *
+ * ★★ 재료가 **둘**이다(반박 compat 1-A): 새 판이 적는 `auto.last_at`, 그리고 **성공한 올리기가 언제나 적는 `tx_at`**
+ *   (`indexWrite(..., 'tx')` — 사람의 push 도, **옛 판의 두 길도** 적는다). 옛 판 ①은 성공하면 `next_at` 을 0 으로
+ *   되돌리고 `last_at` 을 안 적어, `last_at` 만 보면 「옛 창이 방금 올렸다」가 색인 어디에도 안 남는다 — 그 순간
+ *   AHEAD 판정을 쥔 새 창이 그대로 또 보냈다(실측: 옛 판이 먼저 올리는 혼합 함대에서 2회). 이 기계의 MCP 는 창마다
+ *   오래 살아 **혼합이 평상 상태**라, 이 한 칸이 「기계에서 uuid 마다 간격당 1회」를 옛 판 쪽에서도 세운다.
+ */
+function autoIntervalOf(row, now) {
+  const at = Math.max(Number(row?.auto?.last_at) || 0, Number(row?.tx_at) || 0);
+  return at > 0 && Math.abs(now - at) < AUTO_PUSH_MIN_MS;
+}
+
+/**
+ * 입구의 나머지 판정(보류·백오프·닫힘) — **순수 함수**. '' 이면 보낸다. (FULL 예산은 C8 — 위 【없음】 주석)
+ * @param {object|null} row 색인의 그 행
+ * @param {{now:number, size:number, mtime:number}} f 파일의 지금
+ */
+function autoGateOf(row, f) {
+  const a = row?.auto && typeof row.auto === 'object' ? row.auto : {};
+  if (a.hold === true) return 'hold';
+  // 시계 가드는 간격과 **같은 규율**이다(반박 race) — 시계가 앞으로 뛴 뒤 적힌 `next_at` 은 백오프의 최대값(24시간)보다
+  // 멀 수 없으므로, 그보다 먼 미래면 안 믿는다. 한쪽만 방어하면 그 대화가 그 시각까지 통째로 멎는다.
+  const next = Number(a.next_at) || 0;
+  if (next > f.now && next - f.now <= AUTO_BACKOFF_LONG_MS) return 'backoff';
+  const c = a.closed;
+  if (c && typeof c === 'object' && AUTO_CLOSED_CODES.has(String(c.code))
+      && Number(c.size) === Number(f.size) && Number(c.mtime) === Number(f.mtime)) return String(c.code);
+  return '';
+}
+
+/**
+ * FULL 예산이 남았나 — **순수 함수**. 0 이면 남았다, 아니면 **한 자리가 비는 시각**(epoch ms)이다.
+ * 재료는 색인 `auto.full_log`(최근 `PUSH_FULL_LOG_MAX` 개의 **진짜 FULL** 시각). 시계 가드는 간격·백오프와 같은 규율이다 —
+ * 한참 미래의 기록은 안 믿는다(시계가 앞으로 뛴 뒤 적힌 값 하나가 그 대화를 영영 묶지 않게).
+ * @param {object|null} row 색인의 그 행
+ */
+function autoFullBudgetOf(row, now) {
+  const log = (Array.isArray(row?.auto?.full_log) ? row.auto.full_log : [])
+    .map(Number).filter((t) => Number.isFinite(t) && t > 0 && now - t < PUSH_FULL_WINDOW_MS && t - now < PUSH_FULL_WINDOW_MS);
+  if (log.length < PUSH_FULL_BUDGET) return 0;
+  return Math.min(...log) + PUSH_FULL_WINDOW_MS;
+}
+
+/** 이번 바퀴가 **예산이 세는 FULL** 인가 — 재기반이고, 첫 업로드가 아니다(§3.2 · C8). */
+function autoFullCounts(plan, verdict) {
+  return plan?.mode === 'FULL' && PUSH_FULL_REBASE.has(String(plan.why || ''))
+    && verdict !== BEAT_VERDICT.UNKNOWN;
+}
+
+/**
+ * 그 행에 **그 소속처**에 대한 붙박이 막음(가림·보류 409)이 서 있나 — 코드 또는 ''. **순수 함수**(개인정보 NEW-4 · 판 8 F7).
+ * 파일의 표는 소속처를 안 적은 옛 표이거나 같은 소속처일 때, 곁 표(`aside`)는 같은 소속처일 때만 선다.
+ * `autoSkipReason()`(확정 폴더)과 옛 길의 입구(C7 · 오너 결정 §0-5)가 이 한 벌을 쓴다.
+ */
+function autoBlockedFor(row, tenantId, aside) {
+  const tid = Number(tenantId) || 0;
+  const blocked = row?.auto?.blocked;
+  if (blocked && AUTO_STICKY_409.has(String(blocked.code))
+      && (!(Number(blocked.tenant_id) > 0) || Number(blocked.tenant_id) === tid)) return String(blocked.code);
+  if (aside && AUTO_STICKY_409.has(String(aside.code))
+      && Number(aside.tenant_id) > 0 && Number(aside.tenant_id) === tid) return String(aside.code);
+  return '';
+}
+
+/** 거쳐 간 자리가 `CWD_HIST_MAX` 를 넘나 — 넘으면 private 판정을 다 못 잰다(§2.2). 확정 폴더(autoPrepare)와 옛 길이 같은 자를 쓴다. */
+function autoHistOverflow(sc) {
+  return !!(sc?.cwd_hist && typeof sc.cwd_hist === 'object' && Object.keys(sc.cwd_hist).length > CWD_HIST_MAX);
+}
+
+/**
+ * 그 자리의 git 뿌리(`.git` 이 있는 가장 가까운 위 폴더) — 집·뿌리에서 멈춘다. 없으면 ''. git 을 부르지 않는다(자리가 수천일 수 있다).
+ * 짝인 `privateFileFor` 와 **같은 규율로 60초 기억한다** — cwd_hist 열쇠가 4096 곳이면 한 번의 옛 길 검사에 `existsSync` 가
+ * 수만 번이다(반박 policy).
+ */
+const gitRootSeen = new Map();       // real → { at, root }
+function gitRootAbove(real) {
+  const key = String(real || '');
+  const c = gitRootSeen.get(key);
+  if (c && Date.now() - c.at < PRIVATE_TTL_MS) return c.root;
+  let h = os.homedir();
+  try { h = fs.realpathSync(h); } catch { /* */ }
+  let d = key;
+  let root = '';
+  for (let i = 0; i < 64 && d && d !== '/' && d !== h; i++) {
+    if (fs.existsSync(path.join(d, '.git'))) { root = d; break; }
+    const up = path.dirname(d);
+    if (up === d) break;
+    d = up;
+  }
+  if (gitRootSeen.size > 8192) gitRootSeen.clear();
+  gitRootSeen.set(key, { at: Date.now(), root });
+  return root;
+}
+
+/**
+ * 옛 길의 보내기 전 검사(오너 결정 2026-09-21 · §0-1 의 private) — 자리 4096 초과면 `cwd_hist_overflow`, 거쳐 간 자리
+ * **전부**(cwd_hist 열쇠) 중 하나라도 `.genetics-private` 아래면 `private`. 확정 바인딩이 없으니 멈출 자리는 **열쇠마다 그 git 뿌리,
+ * 없으면 집**이다 — 비워 두면(그 자리 하나) git 저장소가 아닌 자리에서 **상위 폴더의 표지를 통째로 놓친다**(반박 policy 실측:
+ * `~/secret/.genetics-private` + cwd `~/secret/work` 가 안 막혔다. 사람이 표지를 두는 가장 흔한 무늬다). `privateFileFor` 는
+ * 집과 `/` 에서 멈추므로 집 밖 자리(예: /tmp)는 지금처럼 그 한 칸만 본다. 32MB·동의 문구·too_old·pull 은 **안 씌운다**(오너 결정).
+ * Cursor 전사는 줄에 자리가 없어 이 검사가 볼 것이 없다(지금처럼 올라간다).
+ */
+function autoLegacyCheck(sc) {
+  if (autoHistOverflow(sc)) return 'cwd_hist_overflow';
+  // ⚠ 집은 **realpath 로** 준다 — `privateFileFor` 는 「자리가 멈출 자리 아래인가」를 글자로 재는데, macOS 의 `/var` 처럼
+  //   집이 심링크 뒤에 있으면(`$HOME=/var/…` · 자리는 `/private/var/…`) 안 걸려 멈출 자리가 그 한 칸으로 되돌아간다(실측).
+  let home = os.homedir();
+  try { home = fs.realpathSync(home); } catch { /* 없는 집이면 준 값 그대로 */ }
+  if (autoPrivateAnyCwd(sc, (r) => gitRootAbove(r) || home)) return 'private';
+  return '';
+}
+
+/**
+ * 후보 하나의 갈래 — `'bound'` · `'legacy'` · `null`. **세 갈래를 명시한다 — 여집합으로 짜지 않는다**(§3.1 · privacy B5).
+ * 판정 재료는 **그 전사 폴더의 resolve 캐시 답**(`t.entry`)이다 — `autoCandidates()` 에 들었는지가 아니다(그 목록은 pull 행·Cursor 를
+ * 뺀다). 거르개는 잠금 밖 스냅숏(`ctx` — 심박 앞에서 뜬 것)으로 먼저 싸게 거르는 것이고, 입구가 임대 안에서 **다시** 본다.
+ * 안 가는 까닭은 `t.why` 에 적는다(시험이 읽는다).
+ *
+ *   · `bound`  — 확정 바인딩 **그리고** 자동 켜짐 **그리고** 안 낡음 **그리고** 후보 목록 안. 거르개는 ① 그대로: 판 낡음
+ *                (`autoClientOld` 는 이 갈래만 끈다) · 옮겨짐 · 판정 UNKNOWN(첫 업로드)/AHEAD · 서버를 거친 행의 UNKNOWN
+ *                (가렸거나 걷음) · 동의 문구 · 429 대기 · too_old 채움 → `autoSkipReason()` → 머리·사본 → 다시
+ *                `autoSkipReason()` · 간격·백오프·닫힘.
+ *   · null ①  — 확정 바인딩 **그리고** (꺼짐 | 낡음 | ambiguous). 오너가 끈 동의를 옛 길이 거스르지 않는다.
+ *   · `legacy` — 확정 바인딩 **없음**(답이 없거나 `unbound`), **또는 확정·자동 폴더인데 후보 목록 밖**(pull 행 — 아래 ★) ·
+ *                판정 AHEAD **그리고** WANT_PUSH(서버가 올려 달라고 할 때만) ·
+ *                색인에 소속(`_tenant_arg`) · 보류 명부를 읽을 수 있고 그 안에 없음 · `auto.hold` 아님 · 그 소속처의 붙박이 막음
+ *                없음(§0-5) · 간격·백오프·닫힘. ①의 정책 거르개(32MB·동의·too_old·pull)는 **안 씌운다**(§0-1). 사적 폴더·4096 은
+ *                보내기 직전(`autoLegacyCheck`)에 본다.
+ *   · null ②  — 그 밖 전부(모르는 폴더 상태 포함).
+ * @param {{uuid:string, v:?object, c:?object, entry:?object, row:?object, rec:?object, size:number, mtime:number}} t
+ * @param {{now:number, holds?:Set<string>, holds_ok?:boolean, aside?:Map, client_old?:boolean,
+ *          consent?:(e:object)=>boolean, tenant_wait?:Map<number,number>, dupOf?:(c:object)=>boolean, env_on?:boolean}} ctx
+ */
+function autoPolicyOf(t, ctx) {
+  const no = (why) => { t.why = why; return null; };
+  const v = t.v;
+  if (!v) return no('no_verdict');
+  const e = t.entry && typeof t.entry === 'object' ? t.entry : null;
+  const st = e ? String(e.state || '') : '';
+  const row = t.row && typeof t.row === 'object' ? t.row : null;
+  const snap = { now: ctx.now, size: t.size, mtime: t.mtime };
+  /*
+   * ★ **확정·자동 폴더인데 후보 목록 밖인 행**(`t.c` 없음 — `autoCandidates` 가 빼는 `origin:'pull'` 행. Cursor 는 애초에
+   *   폴더 답을 안 받아 `st === ''` 다)은 **옛 길로 보낸다**. 그 행은 「내 확정 폴더에서 남의 세션을 이어받아 계속 일한 대화」이고
+   *   (`resume_session` 이 받은 사본에 `origin:'pull'` 을 찍는다), **옛 ②가 올리던 바로 그것**이다 — 옛 ②는 cands 에 있는
+   *   bound 행만 건너뛰었고 pull 행은 cands 에 없어 그대로 올렸다. 여기서 null 로 떨구면 오너 결정(「옛 길의 뜻은 그대로」) 밖의
+   *   뜻 변경이 되고, 사람에게는 아무 말도 안 나간 채 그 대화의 자동 갱신이 통째로 멎는다(반박 policy ②). 설계 §3.1 의
+   *   「Cursor·pull 행은 지금처럼 여기(legacy)로 들어온다」도 이 쪽이다.
+   *   ⚠ 자동이 **꺼졌거나·낡았거나·ambiguous** 인 폴더는 아래 null ① 그대로다(privacy B5) — 오너가 끈 동의를 옛 길이 안 거스른다.
+   */
+  const boundOn = st === 'bound' && e.auto_upload === true && !e.stale;
+  // ── bound ──
+  if (boundOn && t.c) {
+    if (ctx.client_old) return no('client_old');                            // ① 만 끈다(서버가 426 으로 막을 자리)
+    if (v.flags & BEAT_MOVED) return no('moved');                            // 옮겨진 세션은 resolve 가 새 자리를 준다
+    const first = v.verdict === BEAT_VERDICT.UNKNOWN;
+    if (!first && v.verdict !== BEAT_VERDICT.AHEAD) return no('verdict');   // SAME·BEHIND 는 안 올린다
+    const c = t.c;
+    c.first = first;                                                         // 사본(dup) 은 첫 업로드 후보에만 건다(§2.10 · C8)
+    // 색인이 「서버에 있다」고 아는 대화가 UNKNOWN 이면 사람이 가렸거나 걷은 것이다 — 첫 업로드가 아니다(§4.6).
+    if (first && autoRowOnServer(row)) return no('row_on_server');
+    // ★ 동의 문구가 먼저다(개인정보 M5·N8·N9) — 그 폴더의 §5.4 「bound·auto on」이 이 창에서 한 번 나간 뒤에만.
+    if (!ctx.consent?.(e)) return no('no_consent');                          // 판정자가 없으면 안 나간 것으로 친다(닫는 쪽)
+    if ((ctx.tenant_wait?.get(Number(e.tenant_id)) || 0) > ctx.now) return no('tenant_wait');
+    autoTooOldRefresh(c);                                                    // ★ 묻기 **전에** 머리를 채운다(호환 C2)
+    let why = autoSkipReason(c, ctx);
+    if (why) return no(why);
+    autoHeadFill(c);                                                         // 서버 관문 11 이 재는 값(마지막 발화)으로 한 번 더(N3)
+    // ⚠ 여기서 `rawShaOf(c.file)` 를 **조건 없이** 부르던 줄을 걷었다(§4.1 · C8): 그 한 줄이 **바퀴마다 전사 전체를 다시
+    //   sha256** 했고(크기·mtime 이 바뀌면 기억이 안 듣는다 — 자라는 전사는 매번 바뀐다), 쓰임은 사본 판정 한 곳뿐이었다.
+    //   덧붙임의 「O(변화분)」 주장이 클라이언트 읽기에서 무너지는 자리다. 사본은 이제 첫 업로드 후보에서만 잰다.
+    why = autoSkipReason(c, ctx);                                            // 동의 앞 · 이미 올린 다른 uuid 의 사본(첫 업로드만)
+    if (why) return no(why);
+    if (autoIntervalOf(row, ctx.now)) return no('interval');
+    why = autoGateOf(row, snap);
+    return why ? no(why) : 'bound';
+  }
+  // ── null ① ── 확정 바인딩이 있는데 자동이 꺼졌거나·낡았거나·애매하다
+  if (st === 'ambiguous') return no('ambiguous');
+  if (st === 'bound' && !boundOn) return no(e.stale ? 'stale' : 'auto_off');
+  // ── legacy ── 확정 바인딩이 없다(답이 없거나 unbound) · 또는 확정·자동 폴더의 후보 목록 밖 행(위 ★)
+  if (st === '' || st === 'unbound' || boundOn) {
+    if (v.verdict !== BEAT_VERDICT.AHEAD || !(v.flags & BEAT_WANT_PUSH)) return no('not_wanted');
+    if (!t.rec?._tenant_arg || !(Number(row?.tenant_id) > 0)) return no('no_tenant');
+    if (ctx.holds_ok === false) return no('holds_unreadable');              // 보류 명부를 못 읽으면 옛 길도 안 간다(H2)
+    if (ctx.holds?.has?.(String(t.uuid).toLowerCase())) return no('hold');   // no_auto_push — 색인이 절단돼도 남는 자리
+    if (row?.auto?.hold === true) return no('hold');
+    const blocked = autoBlockedFor(row, row.tenant_id, ctx.aside?.get?.(String(t.uuid).toLowerCase()));
+    if (blocked) return no(blocked);                                        // 가림·보류 409 뒤에는 멈춘다(오너 결정 §0-5)
+    if (autoIntervalOf(row, ctx.now)) return no('interval');
+    const why = autoGateOf(row, snap);
+    return why ? no(why) : 'legacy';
+  }
+  // ── null ② ── 그 밖(모르는 폴더 상태)
+  return no(`state:${st}`);
+}
+
+/**
+ * 입구(§3.2) — 임대 → 임대 안에서 색인·대응표를 **다시** 읽고 모든 판정 → `pushSession` → 결과를 잠금 안 mutate 로 → 푼다.
+ * @return {Promise<{sent: boolean, why: string}>} sent = 보내기를 시도했다(성공이든 실패든 — 한 바퀴에 한 건의 셈)
+ */
+async function autoEntrance(t, cls, ctx) {
+  const u = t.uuid;
+  const u8 = u.slice(0, 8);
+  const lease = leaseTake(u);
+  if (!lease.h) {
+    if (lease.err) warnOnce(`lease-${lease.err}`, `자동 올리기 임대 자리(${pushDir()})를 못 만들어 올리지 않는다(${lease.err}).`);
+    return { sent: false, why: lease.held ? 'held_elsewhere' : `lease_${lease.err}` };
+  }
+  try {
+    // ── 2. 임대 안에서 다시 읽는다 — 색인을 못 읽으면 올리지 않는다(닫는 쪽 · §5.1). `indexRead()` 는 못 읽음을 {} 로 삼키므로 직접 본다.
+    const got = jsonReadRetry(INDEX_FILE);
+    if (got.err || (got.raw !== null && !got.obj)) {
+      warnOnce('auto-index-unreadable', `${INDEX_FILE} 를 못 읽어 자동 올리기를 멈춘다(무엇을 언제 올렸는지 모르므로) — 그 파일을 고치면 다시 돈다.`);
+      return { sent: false, why: 'index_unreadable' };
+    }
+    const row = got.obj?.[u] && typeof got.obj[u] === 'object' ? got.obj[u] : null;
+    const holds = autoHoldsRead();
+    if (!holds.ok) return { sent: false, why: 'holds_unreadable' };
+    const L = ledgerReadStrict(u);
+    if (!L.ok) {
+      warnOnce(`auto-ledger-unreadable-${u}`, `${u8} 의 대응표를 못 읽어 자동으로 안 올린다 — ${ledgerFile(u)} 의 권한을 고치거나 지우면 다시 돈다.`);
+      return { sent: false, why: 'ledger_unreadable' };
+    }
+    let st;
+    try { st = fs.statSync(t.file); } catch { return { sent: false, why: 'gone' }; }
     const now = Date.now();
-    const wait = autoBackoffMs(fails, status, err?.retry_after);
-    if (status === 429 && code === 'auto_rate') autoTenantWait.set(Number(e.tenant_id), now + wait);
-    if (status === 426) minClientTick(true);                             // 판 알림 뒤 24시간(§5.5 7)
-    /*
-     * ★ **`too_old` 는 그 세션에 영구다**(개인정보 N3 · 부록 D-7). 「동의 앞에 끝난 대화」는 내일도 같은 답이다 —
-     *   24시간 백오프로 두면 같은 검열본이 **날마다** 서버 디스크에 한 번 쓰였다 지워진다. 서버가 알려 준
-     *   동의 시각을 적어 두고, 그 대화가 **자라서** 마지막 발화가 그 시각을 넘을 때까지 다시 안 보낸다.
-     */
-    if (status === 409 && code === 'too_old') {
-      const at = Date.parse(String(err?.auto_upload_at || '').replace(' ', 'T'));
-      const floor = Number.isFinite(at) && at > 0 ? at : (autoFloorMs(e) || now);
-      // ⚠ 그때의 mtime 을 함께 적는다 — 다음 바퀴부터는 **파일이 바뀌었을 때만** 머리를 다시 읽는다(호환 C2).
-      indexPatch(c.uuid, { auto: { fails: 0, next_at: 0, last_code: code, too_old: floor, too_old_mtime: Number(c.mtime) || 0 } });
-      warnOnce(`auto-too-old-${c.uuid}`,
-        `${u8} 는 자동 올리기를 켜기 전에 끝난 대화라 안 올린다 — 다시 안 두드린다(올리려면 push_session).`);
-      return;
+    const f = { now, size: st.size, mtime: st.mtimeMs };
+    const aside = autoBlockAside.get(u.toLowerCase());
+    let tenantArg;
+    let tid;
+    if (cls === 'bound') {
+      const c = t.c;
+      c.row = row;
+      if (c.v?.verdict === BEAT_VERDICT.UNKNOWN && autoRowOnServer(row)) return { sent: false, why: 'row_on_server' };
+      // 사본 거르개도 **임대 안에서 다시 읽은 색인**으로 짓는다(잠금 밖 스냅숏이 아니라 · race M4).
+      const why = autoSkipReason(c, { now, env_on: autoPushOn(), dupOf: (x) => !!autoDupOf(x.uuid, x.file, got.obj || {}),
+                                      holds: holds.set, holds_ok: holds.ok, aside: autoBlockAside });
+      if (why) return { sent: false, why };
+      tid = Number(c.entry.tenant_id) || 0;
+      // 429 `auto_rate` 대기도 임대 안에서 **다시** 본다 — 잠금 밖 스냅숏에서만 보면 기다리는 동안 옆 창이 세운 대기를 못 본다(반박 policy).
+      if ((autoTenantWait.get(tid) || 0) > now) return { sent: false, why: 'tenant_wait' };
+      tenantArg = c.entry.tenant_slug || c.entry.tenant;
+    } else {
+      if (holds.set.has(u.toLowerCase()) || row?.auto?.hold === true) return { sent: false, why: 'hold' };
+      tenantArg = tenantArgOf(row);
+      tid = Number(row?.tenant_id) || 0;
+      if (!tenantArg || !(tid > 0)) return { sent: false, why: 'no_tenant' };
+      const blocked = autoBlockedFor(row, tid, aside);
+      if (blocked) return { sent: false, why: blocked };
+    }
+    if (autoIntervalOf(row, now)) return { sent: false, why: 'interval' };
+    const gate = autoGateOf(row, f);
+    if (gate) return { sent: false, why: gate };
+    // ── 3. 보낸다 — 사람과 같은 함수. 진전이 있을 때만 임대 시계를 민다.
+    //    길(덧붙임/전체)은 `pushSession` 안의 `planPush` 이 **이 임대 안에서** 고른다(§3.2). 여기서 거는 것은 **예산** 하나다:
+    //    진짜 FULL(재기반)만 세고, 첫 업로드와 옛 서버의 FULL 은 안 센다. 넘으면 `full_budget` 으로 멎고 그 상태가 색인에 남는다.
+    const progress = () => leaseTouch(lease.h);
+    const budgetAt = autoFullBudgetOf(row, now);
+    const planGate = (plan) => (budgetAt > 0 && autoFullCounts(plan, t.v?.verdict) ? 'full_budget' : '');
+    let r = null;
+    let plan = null;
+    try {
+      ({ r, plan } = cls === 'bound'
+        ? await pushSession(tenantArg, u, '', false, 'skip',
+          { binding_id: Number(t.c.entry.binding_id) || 0, device: deviceId(), prepare: (sc) => autoPrepare(sc, t.c) },
+          { progress, plan: planGate }, tid)
+        : await pushSession(tenantArg, u, '', false, 'skip', null, { check: autoLegacyCheck, progress, plan: planGate }, tid));
+    } catch (err) {
+      if (String(err?.code || '') === 'full_budget') {
+        // **조용히 버리지 않는다** — 다음 시간으로 미루고 까닭을 남긴다(사람이 「왜 안 올라가나」를 색인에서 읽는다).
+        indexPatch(u, { auto: { fails: 0, next_at: budgetAt, last_code: 'full_budget' } });
+        warnOnce(`auto-full-budget-${u}`, `${u8} 는 한 시간에 전체 재전송이 ${PUSH_FULL_BUDGET}번을 넘어 다음 시간까지 미룬다(덧붙임이 설 때까지).`);
+        return { sent: false, why: 'full_budget' };
+      }
+      autoEntranceFailed(t, cls, err, { tid, tenant: cls === 'bound' ? (t.c.entry.tenant || t.c.entry.tenant_slug) : (row?.tenant || tenantArg), size: st.size, mtime: st.mtimeMs });
+      return { sent: true, why: '' };
     }
     /*
-     * ★★ **사람이 뺀 대화는 물러섬이 아니라 붙박이다**(개인정보 NEW-4). `session_hidden`·`session_hold` 는
-     *   사람의 손이 세운 답이라 24시간 뒤에도 같다 — 그런데 백오프로 두면 **검열된 전사 전체가 날마다**
-     *   그 소속처 서버로 다시 보내지고 파싱된다(서버는 관문 앞에서 막으니 디스크에는 안 남는다 — 그래도
-     *   보낸 것은 보낸 것이다). 소속처를 함께 적어 두고, 그 소속처에 대해서만 다시 안 보낸다.
-     *   푸는 길은 `autoSkipReason()` 의 「푸는 길」 넷뿐이다(그 소속처로의 성공한 올리기 · 소속처 바뀜 · 그 소속처 resolve 의 `same`·`hold:false`).
+     * ── 4. 결과는 잠금 안 mutate 로. `next_at = now + 간격` 은 같은 기계의 **옛 판 ①**(색인 next_at 을 읽는다)도 간격을
+     *   지키게 하는 비춤이다 — 전에는 성공하면 `next_at:0` 으로 되돌려 「방금 보냈다」를 아무도 못 봤다.
+     * ⚠ **성공한 뒤의 뒷처리는 제 try 로 가른다**(반박 race). 전에는 같은 catch 라, 색인 쓰기나 stderr(EPIPE)가 던지면
+     *   **보낸 것을 실패로 적어** fails 를 올리고 백오프를 걸었다.
      */
-    if (status === 409 && AUTO_STICKY_409.has(code)) {
-      indexPatch(c.uuid, { auto: { fails: 0, next_at: 0, last_code: code } });
-      // (판 8 — 적합성 F7) 표는 따로, 잠금 안 견줌으로 — 다른 소속처가 세운 표는 안 덮고 곁 표에 둔다.
-      try { autoBlockPut(c.uuid, code, Number(e.tenant_id) || 0, now); } catch { /* 못 적으면 다음 바퀴의 409 가 다시 세운다 */ }
-      warnOnce(`auto-blocked-${c.uuid}-${code}`, code === 'session_hidden'
-        ? `${u8} 는 사람이 «${e.tenant || e.tenant_slug}» 에서 가렸거나 걷은 대화라 자동으로 안 올린다 — 다시 안 두드린다(정말 올려야 하면 push_session).`
-        : `${u8} 는 «${e.tenant || e.tenant_slug}» 에서 「자동으로 올리지 않음」으로 표시된 대화라 안 올린다 — 다시 안 두드린다(포털 「폴더」의 업로드 목록에서 푼다).`);
-      return;
-    }
-    indexPatch(c.uuid, { auto: { fails, next_at: now + wait, last_code: code } });
-    if (code === 'too_big') warnOnce(`auto-too-big-${c.uuid}`, `${u8} 는 검열본이 32MB 를 넘어 자동으로 올리지 않는다 — 올리려면 push_session.`);
-    else beatSay(`auto-${c.uuid}-${code}`, `자동 올리기 보류(${u8} · ${code}) — ${err?.message || err}`);
+    try {
+      const done = Date.now();
+      // ★ 예산의 기록은 **여기 한 곳**에서만 선다 — 진짜 FULL(재기반)이 **성공한** 때뿐이다(사람의 push 는 이 길로 안 온다).
+      const counts = autoFullCounts(plan, t.v?.verdict);
+      const wrote = indexWrite(u, null, (cur) => {
+        const log = (Array.isArray(cur?.auto?.full_log) ? cur.auto.full_log : []).map(Number).filter((x) => Number.isFinite(x) && x > 0);
+        return { auto: { last_at: done, fails: 0, next_at: done + AUTO_PUSH_MIN_MS, last_code: '', closed: null,
+          ...(counts ? { full_log: [...log.slice(-(PUSH_FULL_LOG_MAX - 1)), done] } : {}),
+          ...autoClearOnPush(Number(r?.tenant_id) || tid) } };
+      }, '');
+      if (!wrote) warnOnce(`auto-index-write-${u}`, `${u8} 를 올렸지만 색인에 못 적었다 — 옆 창이 간격을 못 볼 수 있다.`);
+      const how = plan?.mode === 'APPEND' || plan?.mode === 'ASK' ? '덧붙여' : '통째로';
+      process.stderr.write(cls === 'bound'
+        ? `genetics: ${u8} 를 확정 폴더의 자동 올리기로 ${how} 올렸다 — «${r.tenant || t.c.entry.tenant}» · ${r.lines}줄.\n`
+        : `genetics: ${u8} 를 자동으로 ${how} 올렸다 — ${r.lines}줄(서버가 낡아 있었다).\n`);
+    } catch { /* 보낸 것은 성공이다 — 뒷처리 실패로 실패를 적지 않는다 */ }
+    return { sent: true, why: '' };
+  } finally {
+    fileUnlock(lease.h);
   }
 }
 
-/** §5.5 5 — 심박 판정으로 갈라 한 바퀴에 한 건. 확정 폴더 밖의 앞선 사본은 옛 길(서버가 올려 달라고 할 때만). */
-async function autoUploadRound(reply, recs, cands) {
+/** 대응표를 읽는다 — 없으면 `{ok:true, obj:null}` · **있는데 못 읽으면(권한) `{ok:false}`** · 깨진 JSON 은 캐시일 뿐이라 없는 것으로. */
+function ledgerReadStrict(uuid) {
+  const f = ledgerFile(uuid);
+  if (!f) return { ok: true, obj: null };
+  let raw;
+  try { raw = fs.readFileSync(f, 'utf8'); } catch (e) { return e?.code === 'ENOENT' ? { ok: true, obj: null } : { ok: false, obj: null }; }
+  try { const o = JSON.parse(raw); return { ok: true, obj: o && typeof o === 'object' && !Array.isArray(o) ? o : null }; } catch { return { ok: true, obj: null }; }
+}
+
+/**
+ * 입구의 실패 규칙 **한 곳**(§3.2 4 · §5.1) — 확정 폴더와 옛 길이 같은 규칙을 탄다(옛 길은 전에 stderr 한 줄뿐이라 409 가림을 받고도
+ * 90초마다 다시 보냈다 — 오너 결정 §0-5 로 붙박이). 실패 수는 잠금 안에서 파일의 값을 읽어 +1 한다(race S6).
+ */
+function autoEntranceFailed(t, cls, err, o) {
+  const u = t.uuid;
+  const u8 = u.slice(0, 8);
+  const status = Number(err?.status) || 0;
+  const code = String(err?.code || (status ? `http_${status}` : 'error'));
+  const now = Date.now();
+  const at = { last_at: now };
+  if (status === 429 && code === 'auto_rate') autoTenantWait.set(Number(o.tid) || 0, now + autoBackoffMs(1, status, err?.retry_after));
+  if (status === 426) minClientTick(true);                             // 판 알림 뒤 24시간(§5.5 7)
+  /*
+   * ★ **`too_old` 는 그 세션에 영구다**(개인정보 N3 · 부록 D-7). 「동의 앞에 끝난 대화」는 내일도 같은 답이다 —
+   *   24시간 백오프로 두면 같은 검열본이 **날마다** 서버 디스크에 한 번 쓰였다 지워진다. 서버가 알려 준
+   *   동의 시각을 적어 두고, 그 대화가 **자라서** 마지막 발화가 그 시각을 넘을 때까지 다시 안 보낸다.
+   */
+  /*
+   * ⚠ 이 자리는 **확정 폴더(①) 몫이다** — 옛 길은 `too_old` 를 안 읽는다(오너 결정 §0-1: 32MB·동의·too_old·pull 을 안 씌운다).
+   *   지금은 도달 불가이기도 하다: 서버의 `too_old` 는 바인딩 머리를 실은 요청에만 서는데(`lib/folder_binding.php` 의
+   *   `agent_session_gate_age` — `$auto === null` 이면 null) 옛 길은 그 머리를 안 싣는다. 뜻이 바뀌어 옛 길에도 오게 되면
+   *   `autoGateOf` 가 `too_old` 를 읽지 않으므로 90초마다 되풀이된다 — 그때는 게이트에 한 줄을 더해야 한다(반박 policy).
+   */
+  if (status === 409 && code === 'too_old') {
+    const t0 = Date.parse(String(err?.auto_upload_at || '').replace(' ', 'T'));
+    const floor = Number.isFinite(t0) && t0 > 0 ? t0 : (autoFloorMs(t.entry) || now);
+    // ⚠ 그때의 mtime 을 함께 적는다 — 다음 바퀴부터는 **파일이 바뀌었을 때만** 머리를 다시 읽는다(호환 C2).
+    indexPatch(u, { auto: { ...at, fails: 0, next_at: 0, last_code: code, too_old: floor, too_old_mtime: Number(t.mtime) || 0 } });
+    warnOnce(`auto-too-old-${u}`, `${u8} 는 자동 올리기를 켜기 전에 끝난 대화라 안 올린다 — 다시 안 두드린다(올리려면 push_session).`);
+    return;
+  }
+  /*
+   * ★★ **사람이 뺀 대화는 물러섬이 아니라 붙박이다**(개인정보 NEW-4 · 옛 길은 오너 결정 §0-5). `session_hidden`·`session_hold` 는
+   *   사람의 손이 세운 답이라 24시간 뒤에도 같다 — 백오프로 두면 **검열된 전사 전체가 날마다** 그 소속처 서버로 다시 보내지고
+   *   파싱된다. 소속처를 함께 적어 두고, 그 소속처에 대해서만 다시 안 보낸다. 푸는 길은 `autoSkipReason()` 의 「푸는 길」 넷뿐이다.
+   */
+  if (status === 409 && AUTO_STICKY_409.has(code)) {
+    indexPatch(u, { auto: { ...at, fails: 0, next_at: 0, last_code: code } });
+    // (판 8 — 적합성 F7) 표는 따로, 잠금 안 견줌으로 — 다른 소속처가 세운 표는 안 덮고 곁 표에 둔다.
+    try { autoBlockPut(u, code, Number(o.tid) || 0, now); } catch { /* 못 적으면 다음 바퀴의 409 가 다시 세운다 */ }
+    warnOnce(`auto-blocked-${u}-${code}`, code === 'session_hidden'
+      ? `${u8} 는 사람이 «${o.tenant}» 에서 가렸거나 걷은 대화라 자동으로 안 올린다 — 다시 안 두드린다(정말 올려야 하면 push_session).`
+      : `${u8} 는 «${o.tenant}» 에서 「자동으로 올리지 않음」으로 표시된 대화라 안 올린다 — 다시 안 두드린다(포털 「폴더」의 업로드 목록에서 푼다).`);
+    return;
+  }
+  /*
+   * ★ **`behind` 는 실패가 아니다**(C6 · §2.9 race M6). 이 기계의 다른 창이 같은 대화를 **더 뒤까지** 먼저 올렸다 — 물러서지 않고
+   *   (fails 0) 간격만 비춘다(`next_at = now + 간격` — 성공과 같은 비춤, C7). 따라잡기는 C8 몫이다.
+   */
+  if (status === 409 && code === 'behind') {
+    indexPatch(u, { auto: { ...at, fails: 0, next_at: now + AUTO_PUSH_MIN_MS, last_code: code } });
+    return;
+  }
+  /*
+   * ★ **`caught_up` 도 실패가 아니다**(C8). 덧붙임이 서버 좌표를 따라잡고 보니 보낼 줄이 없었다 — 대응표는 세웠고 전송은 0이다.
+   *   백오프를 걸면 「좌표만 어긋났던」 대화가 몇 시간 멎는다. `behind` 와 같은 대우(fails 0 · 간격만 비춤).
+   */
+  if (code === 'caught_up') {
+    indexPatch(u, { auto: { ...at, fails: 0, next_at: now + AUTO_PUSH_MIN_MS, last_code: code } });
+    return;
+  }
+  const closed = AUTO_CLOSED_CODES.has(code) ? { closed: { code, size: Number(o.size) || 0, mtime: Number(o.mtime) || 0 } } : {};
+  indexWrite(u, null, (row) => {
+    const fails = (Number(row?.auto?.fails) || 0) + 1;
+    return { auto: { ...at, fails, next_at: now + autoBackoffMs(fails, status, err?.retry_after), last_code: code, ...closed } };
+  }, '');
+  if (code === 'cwd_hist_overflow') warnOnce(`auto-cwd-hist-${u}`, `${u8} 는 거쳐 간 폴더가 ${CWD_HIST_MAX}곳을 넘어 사적 폴더 판정을 다 못 잰다 — 자동으로 안 올린다(올리려면 push_session).`);
+  else if (code === 'private') warnOnce(`auto-private-${u}`, `${u8} 는 거쳐 간 자리에 .genetics-private 가 있어 자동으로 안 올린다(올리려면 push_session).`);
+  else if (code === 'too_big') warnOnce(`auto-too-big-${u}`, `${u8} 는 검열본이 32MB 를 넘어 자동으로 올리지 않는다 — 올리려면 push_session.`);
+  else beatSay(`auto-${u}-${code}`, `자동 올리기 보류(${u8} · ${code}) — ${err?.message || err}`);
+}
+
+/**
+ * 한 바퀴(§3.1) — ①과 ②를 합친다. 후보 = 확정 폴더 후보(`autoCandidates`, 내 세션 → 최근 순) + 심박이 AHEAD 라 한 나머지(옛 길).
+ * 갈래는 `autoPolicyOf()` 가 정하고, 보내기를 **시도한** 한 건에서 멈춘다(한 바퀴에 한 건 — ①이 먼저라는 우선순위는 후보 순서가 진다).
+ * 임대를 못 잡았거나 임대 안 판정에서 물러선 후보는 건너뛰고 다음 후보를 본다(보낸 것이 없으니 「한 건」을 안 쓴다).
+ * @param {object|null} ctx0 심박 **앞에서** 뜬 스냅숏(`beatTick`) — 없으면 여기서 뜬다
+ */
+async function autoSyncRound(reply, recs, cands, ctx0 = null) {
   if (!autoPushOn()) { autoPushSilence(); return; }
   if (!reply) return;
-  const ctx = autoContext();
+  const ctx = ctx0 || autoContext();
   const verdict = new Map(reply.map((v) => [v.uuid, v]));
   for (const c of cands) {
     const v = verdict.get(c.uuid);
     if (v && (v.verdict === BEAT_VERDICT.SAME || v.verdict === BEAT_VERDICT.BEHIND)) autoSettled.set(c.uuid, `${c.size}:${c.mtime}`);
   }
-  // ① 확정·자동 폴더 — 거르개를 전부 지난 첫 후보 하나(내 세션 → 최근 순)
-  if (!autoClientOld()) {
-    for (const c of autoOrder(cands)) {
-      const v = verdict.get(c.uuid);
-      if (!v || (v.flags & BEAT_MOVED)) continue;                        // 옮겨진 세션은 resolve 가 새 자리를 준다
-      const first = v.verdict === BEAT_VERDICT.UNKNOWN;
-      if (!first && v.verdict !== BEAT_VERDICT.AHEAD) continue;          // SAME·BEHIND 는 안 올린다
-      // 색인이 「서버에 있다」고 아는 대화가 UNKNOWN 이면 사람이 가렸거나 걷은 것이다 — **첫 업로드**가 아니다.
-      // 다시 올리면 가림(deleted_at)이 풀린다(§4.6 — 지우는 손을 기계가 되돌리지 않는다).
-      // ⚠ 「안다」의 자는 소속 칸이 아니라 **서버를 거친 표식**이다(autoRowOnServer) — mail 도구와 옛 판 입양이
-      //   소속 칸만 적어서, 그 행을 여기서 건너뛰면 그 대화는 첫 업로드를 영영 못 한다(2026-09-15 실측).
-      if (first && autoRowOnServer(c.row)) continue;
-      /*
-       * ★ **동의 문구가 먼저다**(개인정보 검토 M5·N8·N9). §5.4 「bound·auto on」 이 **그 폴더에 대해** 도구 응답
-       *   꼬리로 한 번 나간 뒤에만 그 폴더의 전사를 올린다. 전에는 부팅 직후 첫 심박이 도구 호출보다 먼저 올려서,
-       *   genetics 도구를 한 번도 안 부른 세션이 **한 글자도 안 알린 채** 올라갔다.
-       *   ⚠ 깃발은 폴더별이고(N8: 창 하나가 두 확정 폴더를 오갈 수 있다), **옆 창의 전사에도 건다**
-       *     (N9: 후보의 대부분이 그것이다). 다만 옆 **대화 안에서는** 여전히 아무 말도 안 나간다 —
-       *     그 한계는 `autoConsentSaid` 머리말과 §5.5 가 적어 둔다.
-       */
-      if (!autoConsentGiven(c.entry)) continue;
-      if (!first && ctx.now - (autoPushAt.get(c.uuid) || 0) < AUTO_PUSH_MIN_MS) continue;
-      if ((autoTenantWait.get(Number(c.entry?.tenant_id)) || 0) > ctx.now) continue;
-      autoTooOldRefresh(c);                                              // ★ 묻기 **전에** 머리를 채운다(호환 C2) — 아래 autoHeadFill 은 이 뒤에 선다
-      if (autoSkipReason(c, ctx)) continue;
-      autoHeadFill(c);                                                   // 서버 관문 11 이 재는 값(마지막 발화)으로 한 번 더(N3)
-      c.raw_sha = rawShaOf(c.file);
-      if (autoSkipReason(c, ctx)) continue;                              // 동의 앞 · 이미 올린 다른 uuid 의 사본 — 다음 후보로
-      if (!indexClaim(c.uuid, ctx.now + AUTO_PUSH_MIN_MS, ctx.now)) continue;   // 옆 창이 먼저 잡았다
-      autoPushAt.set(c.uuid, ctx.now);
-      await autoUploadOne(c);
-      return;                                                            // 한 바퀴에 한 건
-    }
+  const pctx = { ...ctx, client_old: autoClientOld(), consent: autoConsentGiven, tenant_wait: autoTenantWait };
+  const byDir = autoFolderMap(resolveCacheRead(), ctx.now);
+  const recOf = new Map((recs || []).map((r) => [r.uuid, r]));
+  const list = [];
+  const seen = new Set();
+  for (const c of autoOrder(cands)) {
+    seen.add(c.uuid);
+    list.push({ uuid: c.uuid, c, file: c.file, size: c.size, mtime: c.mtime, entry: c.entry, row: c.row, rec: recOf.get(c.uuid) || null });
   }
-  // ② 옛 길 — 확정 바인딩이 없는 폴더에서 사람이 올린 세션이 앞섰을 때(서버가 올려 달라고 할 때만)
   for (const v of reply) {
-    if (v.verdict !== BEAT_VERDICT.AHEAD || !(v.flags & BEAT_WANT_PUSH)) continue;
-    if (cands.some((c) => c.uuid === v.uuid && c.entry?.state === 'bound')) continue;   // 확정 폴더의 행은 ① 의 거르개가 정한다
-    const rec = recs.find((r) => r.uuid === v.uuid);
-    if (!rec?._tenant_arg) continue;
-    if (ctx.holds_ok === false) continue;                                // 보류 명부를 못 읽으면 옛 길도 안 간다(H2)
-    if (ctx.holds.has(String(v.uuid).toLowerCase())) continue;           // no_auto_push — 색인이 절단돼도 남는 자리
-    if (indexRead()[v.uuid]?.auto?.hold === true) continue;              // no_auto_push — 이 대화는 자동으로 안 올라간다
-    if (ctx.now - (autoPushAt.get(v.uuid) || 0) < AUTO_PUSH_MIN_MS) continue;
-    autoPushAt.set(v.uuid, ctx.now);
-    try {
-      const { r } = await pushSession(rec._tenant_arg, v.uuid, '', false, 'skip');
-      process.stderr.write(`genetics: ${v.uuid.slice(0, 8)} 를 자동으로 올렸다 — ${r.lines}줄(서버가 낡아 있었다).\n`);
-    } catch (e) {
-      // 실패는 알리되 멈추지 않는다. 다음 심박이 다시 시도한다.
-      process.stderr.write(`genetics: 자동 올리기 실패(${v.uuid.slice(0, 8)}) — ${e.message}\n`);
-    }
-    return;                                                              // 한 바퀴에 한 건
+    if (seen.has(v.uuid) || v.verdict !== BEAT_VERDICT.AHEAD) continue;
+    seen.add(v.uuid);
+    const file = transcriptOf(v.uuid);
+    if (!file) continue;
+    let st;
+    try { st = fs.statSync(file); } catch { continue; }
+    const hit = isCursorTranscript(file) ? null : byDir.get(path.dirname(file));
+    const row = ctx.idx?.[v.uuid] && typeof ctx.idx[v.uuid] === 'object' ? ctx.idx[v.uuid] : null;
+    list.push({ uuid: v.uuid, c: null, file, size: st.size, mtime: st.mtimeMs, entry: hit ? hit.entry : null, row, rec: recOf.get(v.uuid) || null });
+  }
+  for (const t of list) {
+    t.v = verdict.get(t.uuid) || null;
+    if (t.c) t.c.v = t.v;
+    const cls = autoPolicyOf(t, pctx);
+    if (!cls) continue;
+    const r = await autoEntrance(t, cls, pctx);
+    if (r.sent) return;                                                  // 한 바퀴에 한 건
   }
 }
 
@@ -3903,7 +5489,8 @@ async function beatTick() {
     // 확정·자동 폴더의 후보(§5.5) — 서버 소속을 이 기계가 모르는 사본도 판정을 받게 심박에 싣는다.
     let cands = [];
     let extra = [];
-    try { cands = autoCandidates(); extra = autoBeatRecs(cands, autoContext()); } catch { /* 후보를 못 모아도 심박은 뛴다 */ }
+    let ctx0 = null;                          // 심박 **앞의** 스냅숏 — 싼 앞거르개용일 뿐, 입구가 임대 안에서 다시 읽는다(C7)
+    try { cands = autoCandidates(); ctx0 = autoContext(); extra = autoBeatRecs(cands, ctx0); } catch { /* 후보를 못 모아도 심박은 뛴다 */ }
     const recs = beatTargets(extra);
     if (!recs.length) return;
     // **안 바뀌었으면 안 보낸다.** 이 설계가 실제로 버는 것은 바이트가 아니라 이것이다.
@@ -3914,7 +5501,7 @@ async function beatTick() {
     const reply = await beatOnce(recs);
     // 옮겨진 세션은 resolve 가 새 자리를 준다(심박 프레임은 그대로 — §4.5).
     try { await resolveMoved(reply); } catch { /* 다음 바퀴에 다시 */ }
-    try { await autoUploadRound(reply, recs, cands); } catch { /* 한 바퀴가 실패해도 심박은 계속 뛴다 */ }
+    try { await autoSyncRound(reply, recs, cands, ctx0); } catch { /* 한 바퀴가 실패해도 심박은 계속 뛴다 */ }
   } finally {
     beatRunning = false;
   }
@@ -4004,7 +5591,140 @@ 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;
+}
+
+/**
+ * 할 일에 **완료 보고**를 올리는 문(M1 · 2026-09-26) — 사람이 화면에서 쓰는 것과 **같은 서버 함수**(`work_task_do_report`)다.
+ *
+ * 규율(DESIGN-work-tasks.md §4·§7): 세포가 done 을 올리면 완료가 아니라 **검수**다 — 도장은 사람 검수자가 찍는다. 글은 근거가
+ * 아니다 — 근거는 (kind, ref) 튜플이고, 안 주면 **이 세션**을 근거로 싣는다(세션은 서버가 실재를 대조할 수 있는 갈래다).
+ * 응답은 서버의 문장을 그대로 나른다 — 「완료로 표시했습니다」는 어느 갈래에도 없다(G18).
+ */
+function taskWriteTools() {
+  const tenant = { type: 'string', minLength: 1, maxLength: 100, description: 'list_my_tenants에서 확인한 조직 slug' };
+  return [
+    { name: 'report_task',
+      description: '할 일에 완료 보고(또는 대화)를 남깁니다 — 무엇을 어떻게 했는지 본문으로, 확인할 수 있는 근거를 (kind, ref) 로. '
+        + 'kind 가 done(기본)이면 그 할 일은 검수로 올라가고 완료 도장은 사람이 찍습니다. 근거를 안 주면 이 세션을 근거로 싣습니다'
+        + '(세션·커밋 같은 내부층 근거는 우리 팀 자격만 — member 자격이면 근거 없이 글만 남고 그렇게 말합니다). '
+        + '할 일 uid 는 list_tasks 에서 받습니다.',
+      inputSchema: { type: 'object', additionalProperties: false, required: ['tenant', 'task_uid', 'body'], properties: { tenant,
+        task_uid: { type: 'string', pattern: '^[a-z0-9]{8}$', description: 'list_tasks 가 준 할 일 uid' },
+        body: { type: 'string', minLength: 1, maxLength: 4000, description: '무엇을 어떻게 했나 — 사람이 읽는 글. 근거를 대신하지 않는다' },
+        kind: { type: 'string', enum: ['done', 'talk'], default: 'done', description: 'done = 완료 보고(검수로 올림) · talk = 대화만' },
+        evidence: { type: 'array', maxItems: 10, description: '확인할 수 있는 근거. 비우면 {kind:"session", ref:<이 세션>} 하나',
+          items: { type: 'object', additionalProperties: false, required: ['kind', 'ref'], properties: {
+            kind: { type: 'string', enum: ['session', 'commit', 'file', 'case', 'report', 'decision'] },
+            ref: { type: 'string', minLength: 1, maxLength: 300, description: '세션 uuid · 커밋 해시 · 파일 id · cases/…md · reports/<id>#<uid> · decisions/…md' },
+            note: { type: 'string', maxLength: 300 } } } },
+        done_when: { type: 'string', maxLength: 500, description: '완료 조건 — 그 할 일에 아직 없을 때만 채워진다' } } } },
+  ];
+}
+
+/** 요청 다듬기 — 모양만. 자격·소속처·세션의 실재는 서버가 본다. */
+function taskWriteRequest(args) {
+  if (!args || typeof args !== 'object' || Array.isArray(args) || typeof args.tenant !== 'string'
+      || !args.tenant.trim() || [...args.tenant].length > 100) throw new Error('조직 slug를 확인하세요.');
+  if (typeof args.task_uid !== 'string' || !/^[a-z0-9]{8}$/.test(args.task_uid)) throw new Error('list_tasks에서 받은 할 일 uid가 필요합니다.');
+  const body = typeof args.body === 'string' ? args.body.trim() : '';
+  if (!body || [...body].length > 4000) throw new Error('완료 보고 본문은 1~4,000자입니다.');
+  const kind = args.kind === 'talk' ? 'talk' : 'done';
+  const mine = mySessionId();
+  let evidence = Array.isArray(args.evidence) ? args.evidence : [];
+  if (evidence.length > 10) throw new Error('근거는 한 번에 10개까지입니다.');
+  evidence = evidence.map((e) => {
+    if (!e || typeof e !== 'object' || typeof e.kind !== 'string' || typeof e.ref !== 'string' || !e.ref.trim()) throw new Error('근거는 kind 와 ref 가 함께 있어야 합니다.');
+    const out = { kind: e.kind, ref: e.ref.trim().slice(0, 300) };
+    if (typeof e.note === 'string' && e.note.trim()) out.note = e.note.trim().slice(0, 300);
+    return out;
+  });
+  // 근거를 안 줬으면 **이 세션**이 근거다 — 세션 이름을 못 찾으면 지어내지 않고 빈 채로 보낸다(서버가 근거 없음을 말한다).
+  const defaulted = !evidence.length && !!mine;
+  if (defaulted) evidence = [{ kind: 'session', ref: mine }];
+  const req = { tenant: args.tenant, body, kind, evidence, session: mine || '' };
+  if (typeof args.done_when === 'string' && args.done_when.trim()) req.done_when = args.done_when.trim().slice(0, 500);
+  return { path: '/api/work/tasks/' + args.task_uid + '/report', body: req, defaulted };
+}
+
+/** 응답 한 줄 — 수와 상태 낱말은 서버의 것, 문장(says)은 그대로 나른다. */
+function taskWriteResult(uid, r) {
+  const c = r?.comment || {};
+  const t = r?.task || {};
+  const counts = t.evidence_counts || {};
+  const n = Number(counts.total) || (Array.isArray(c.evidence) ? c.evidence.length : 0);
+  const v = Number(counts.usable) || 0;
+  const head = `«${uid}» — ${c.kind_word || '완료 보고'} #${c.id ?? '?'} 올림 · 근거 ${n}(검증 ${v})`;
+  const state = t.state_word ? ` · 상태: ${t.state_word}` : '';
+  return head + state + '.' + (r?.says ? ' ' + r.says : '');
+}
+
 const TOOLS = [
+  ...taskReadTools(),
+  ...taskWriteTools(),
   /*
    * ★ **이 도구는 부르지 않아도 일한다.** 설명 자체가 세계 사실을 실어 나른다(`toolsNow()`).
    * 도구 목록은 매 턴 모델 문맥에 있으므로, 부르기 전에 이미 눈앞에 놓인다.
@@ -4169,7 +5889,7 @@ const TOOLS = [
       'HTML 을 만들지 말 것 — 내용만 주면 서버가 렌더한다.\n' +
       '**기본은 초안이다** — 만들어도 고객에게는 보이지 않는다. 눈으로 확인한 뒤 ' +
       'release_report 로 열어 준다. 바로 열려면 publish: true 를 명시할 것.\n' +
-      '**문체는 두 면이다** — 우리가 한 일은 개조식(~함/~했음/~임), **상대가 할 일에는 높임 어간을 살린다**. 「회신 필요」가 아니라 「회신 주시면 됨」, 「~해 주셔야 함」이 아니라 명사형 「~ 요청」. 개조식을 상대에게 쓰면 명령형이 된다. dry_run 이 경고로 센다.\n' +
+      '**문체는 주어와 자리가 정한다** — 요청 자리 밖에는 우리·사물·화면이 주어인 문장만 개조식(~함/~했음/~임)으로 쓴다. 독자가 할 일은 요청 자리(open_items·cta·PART I 간지(요청·결정 PART 일 때)·판권지 회신 안내·요청 절 항을 부탁하는 읽는 법 한 줄)에만 두고 사실 문장까지 하십시오체로 맺는다(「회신 부탁드립니다」. 제목은 검수·보고면 「~ 요청」+기한 괄호, 결정 문서의 판단 항목은 물음). 그 밖의 칸에는 사실만 적는다(「기준 수치는 미정」). dry_run 은 일부만 센다.\n' +
       '쓰기 전에 결과만 보고 싶으면 dry_run: true — 렌더까지 돌려 경고를 주고 아무것도 저장하지 않는다.',
     inputSchema: {
       type: 'object',
@@ -4244,7 +5964,7 @@ const TOOLS = [
       '**그림 계약**: `assets` 를 **빼고** 보내면 서버가 저장된 그림을 그대로 유지한다. 전부 지우려면 `assets: []` 를 명시하고 ' +
       '`sections[].plates`·`chapters[].asset` 에서도 그 id 를 빼야 한다 — 가리키는 곳이 없는 id 는 422 로 거절된다. ' +
       '한 장만 바꾸려면 그 id 에 새 `source`/`file` 을 주고 나머지는 get_report 가 준 표식 그대로 두면 된다.\n' +
-      '**문체는 두 면이다** — 우리가 한 일은 개조식(~함/~했음/~임), **상대가 할 일에는 높임 어간을 살린다**. 「회신 필요」가 아니라 「회신 주시면 됨」, 「~해 주셔야 함」이 아니라 명사형 「~ 요청」. 개조식을 상대에게 쓰면 명령형이 된다. dry_run 이 경고로 센다.\n',
+      '**문체는 주어와 자리가 정한다** — 요청 자리 밖에는 우리·사물·화면이 주어인 문장만 개조식(~함/~했음/~임)으로 쓴다. 독자가 할 일은 요청 자리(open_items·cta·PART I 간지(요청·결정 PART 일 때)·판권지 회신 안내·요청 절 항을 부탁하는 읽는 법 한 줄)에만 두고 사실 문장까지 하십시오체로 맺는다(「회신 부탁드립니다」. 제목은 검수·보고면 「~ 요청」+기한 괄호, 결정 문서의 판단 항목은 물음). 그 밖의 칸에는 사실만 적는다(「기준 수치는 미정」). dry_run 은 일부만 센다.\n',
     inputSchema: {
       type: 'object',
       properties: {
@@ -4297,11 +6017,12 @@ const TOOLS = [
         evidence: { type: 'string', description: '근거 — 실측치·커밋 해시·로그 한 줄. 비면 "안 적혔다"로 남는다.' },
         tags: { type: 'array', items: { type: 'string' }, description: '갈래(최대 8).' },
         paths: { type: 'array', items: { type: 'string' },
-          description: '이 사례가 걸린 **저장소 상대 경로**(예: www/portal/lib/x.php). 본문에 적힌 경로는 자동으로 들어간다.' },
+          description: '이 사례가 걸린 **저장소 상대 파일 경로**(예: www/portal/lib/x.php — 빗금 필수). 본문에 적힌 경로는 자동으로 들어간다. 설비 이름·맨 파일명은 열쇠가 못 된다(세포가 실재 파일 경로와 정확 일치로만 맞힌다) — 서버가 돌려보내며 말한다.' },
         commands: { type: 'array', items: { type: 'string' },
           description: '이 사례가 걸린 **명령 문구**(예: "INSERT INTO rp_agent_presence"). 다른 세포가 그 문구가 든 명령을 치기 직전에 이 사례를 본다.' },
         errors: { type: 'array', items: { type: 'string' },
-          description: '이 사례의 **오류 문자열**(예: "CONSTRAINT ck_tree_machine failed"). 지금은 적어 두기만 한다.' },
+          description: '이 사례의 **오류 문자열**(예: "CONSTRAINT ck_tree_machine failed"). 지금은 **관측 쪽**에서만 쓴다 — 사례가 닿은 뒤 같은 오류가 또 났는지를 실패 지문과 대조한다. 도구 직전 알림에는 아직 안 쓴다(세포는 paths·commands 만 맞힌다).' },
+        work: { type: 'string', description: '이 사례가 **어느 일의 시정조치 기록**인지 — 그 일의 열쇠(영문 소문자·숫자·붙임표, 예: hnl-wait). 결정의 work 와 같은 규칙으로 갈래 맨 앞에 접힌다. 부적합(사례) → 조치(일) → 근거(완료)가 한 줄로 이어지게 하는 자리다.' },
         picks: { type: 'array', maxItems: 20, items: { type: 'object', required: ['selector', 'text'], properties: {
           selector: { type: 'string', description: '페이지에서 다시 잴 자리 — 훅 줄의 sel `…` 그대로' },
           text: { type: 'string', description: '사람이 본 글자 — 훅 줄의 "…" 그대로' },
@@ -4340,7 +6061,9 @@ 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/<이 결정을 뒤집은 장>" · "조건 충족 → <무엇이> (날짜)". ★ 「뒤집힘」은 **옛 결정을 다시 저장할 때** 적는 값이고, **무엇으로 뒤집혔는지** 대야 저장된다 — 경로가 없거나 그 장이 실재하지 않으면 거절한다(get_case 가 준 경로 그대로). **새 결정이 옛 결정을 뒤집는 것이면 status 가 아니라 overturns 를 쓴다** — 새 결정의 status 에 「뒤집힘」을 적으면 그 새 결정이 폐기로 읽힌다.' },
+        overturns: { type: 'string', description: '이 결정이 **뒤집는 옛 결정**의 경로(decisions/<그 결정>, get_case 가 준 것 그대로). 적으면 서버가 **같은 커밋**에서 옛 결정의 상태를 「뒤집힘 → 이 결정」으로 고치고, 이 결정 본문에 「그 결정을 뒤집는다」를 남긴다(양쪽 연결). 이 결정의 status 는 비워 둔다(유효로 선다). ★ overturns_revision 이 없으면 거절한다 — 읽지 않은 장은 뒤집을 수 없다.' },
+        overturns_revision: { type: 'string', pattern: '^[a-f0-9]{64}$', description: 'overturns 로 댄 옛 결정을 get_case 로 읽은 revision 그대로. 그 사이 누가 그 장을 고쳤으면 409 로 멈춘다 — 다시 읽고 판단을 다시 한다.' },
         tags: { type: 'array', items: { type: 'string' }, description: '갈래(최대 8). ★ 이것이 있어야 이 결정이 「일」 후보 계산에 들어간다.' },
         work: { type: 'string', description: '**이 결정이 곧 과업이면** 그 일의 열쇠(영문 소문자·숫자·붙임표, 예: hnl-wait). 적으면 그 이름의 일이 **지금** 「계획」으로 선다 — 착수 전에 세우는 정문이다. 이미 열린 일의 열쇠면 이 결정이 그 일의 **항목**(작업 리스트 한 줄)으로 서고 간트에 저장 즉시 보인다 — 항목 여럿이면 결정을 여러 번 적는다(항목마다 제 근거를 갖는다).' },
         order: { type: 'array', items: { type: 'string' }, description: '일 사이 **순서**를 정하는 결정이면 일의 열쇠를 앞선 것부터(최대 24). 표에 저장하지 않고 일 목록이 이 결정을 읽어 그 순서로 선다 — 순서가 바뀌면 새 결정을 적는다.' },
@@ -4355,10 +6078,34 @@ const TOOLS = [
           source: { type: 'string', description: '고칠 자리 — 훅 줄의 <저장소 상대 경로>:<줄> 그대로(없으면 비움)' },
           url: { type: 'string', description: '그 화면 주소(알면)' },
         } }, description: '사용자가 브라우저에서 **집은 요소**(iab 픽) — remember_case 의 같은 칸. 사용자가 "iab N" 이라 했으면 훅 줄의 #N 에서 그대로 옮긴다, 지어내지 않는다. 장에 「집은 자리」 절로 선다(최대 20).' },
+        // 소속처가 반려한 이름(2026-09-26) — 목록의 정본이 이 칸이다. 모양 검사는 창구(wiki_rejected_names_clean)가 한다.
+        rejected_names: { type: 'array', maxItems: 20, items: { type: 'object', required: ['name'], properties: {
+          name: { type: 'string', description: '반려된 이름 — 작업하며 지은 판·환경·인스턴스 이름(공백 빼고 2~40자)' },
+          use: { type: 'string', description: '대신 쓸 원래 이름 — 독자 화면·문서의 이름(80자까지)' },
+          near: { type: 'array', maxItems: 8, items: { type: 'string' }, description: '흔한 낱말이라 문맥으로만 가를 이름이면 함께 설 낱말(각 20자까지) — 그 낱말이 같은 문장 12자 안에 설 때만 센다. 정규식은 받지 않는다' },
+        } }, description: '**반려가 작업하며 지은 이름을 짚었으면** 그 이름과 대신 쓸 원래 이름(최대 20). 이 소속처의 문서 발행·모의 발행·로컬 렌더가 경고로 센다(list_rejected_names 로 확인). 반려 날짜와 까닭은 when·why 에 적는다. 같은 제목으로 다시 적으면 목록도 통째로 바뀐다 — 빠진 이름은 응답이 말한다.' },
       },
       required: ['tenant', 'title', 'what', 'commit_id'],
     },
   },
+  {
+    // 소속처가 반려한 이름(2026-09-26) — 로컬 렌더(render.py)·발행 직전 훅이 서버를 안 거치고도 발행과 같은 목록으로 세게 하는 창구.
+    // 원격(/mcp)에는 두지 않는다 — 그쪽은 렌더가 서버에서 돌아 소비자가 없다.
+    name: 'list_rejected_names',
+    description:
+      '**이 소속처가 반려한 이름 목록**을 읽는다 — 결정 장(remember_decision 의 rejected_names 칸)에서 이름마다 가장 새 결정을 모은다(뒤집힌 결정은 뺀다). '
+      + '문서 발행·모의 발행이 렌더러에 넘겨 경고로 세는 **그 목록**이다. 읽기만 한다.\n'
+      + '언제 부르는가: 반려 이름을 적은 뒤 확인할 때 · 로컬 렌더(render.py --tenant)와 발행 직전 훅이 부른다(format: "json").\n'
+      + '0 이면 0 이라고 말하고, 결정 장의 줄이 깨졌으면 그 장을 짚는다.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        tenant: { type: 'string', description: '대상 소속처 slug(이름도 받는다 — list_my_tenants 참조).' },
+        format: { type: 'string', enum: ['text', 'json'], description: '"json" 이면 기계가 읽을 JSON 한 덩어리({tenant, tenant_slug, names:[{name,use,near}], counted, skipped, note}). 기본은 사람이 읽을 글.' },
+      },
+      required: ['tenant'],
+    },
+  },
   {
     name: 'forget_decision',
     description:
@@ -4438,6 +6185,8 @@ const TOOLS = [
       + '잘못 표시했으면 work+item+undone:true 로 되돌린다(사후 정정 — 조용히 지워지지 않고 원장에 남는다).\n'
       + '**사람이 화면에서 체크박스로 표시하는 것은 이것의 별도 경로일 뿐, 필수 경로가 아니다** — '
       + '두뇌(에이전트) 스스로 완료를 확인했으면 사람이 누르기를 기다리지 않고 바로 이 도구로 표시한다.\n'
+      + '**그 일의 항목 번호·제목·계획 기간·상태가 필요하면 work(slug)만 주고 부른다** — 항목 목록이 한 번에 온다'
+      + '(결정 장을 한 장씩 열어 번호를 찾지 말 것).\n'
       + '요지 전문은 get_case(tenant, "work/<slug>.md") 로 읽는다. **0 이면 0 이라고 말한다.**',
     inputSchema: {
       type: 'object',
@@ -4445,7 +6194,7 @@ const TOOLS = [
         tenant: { type: 'string', description: '대상 소속처 slug(이름도 받는다 — list_my_tenants 참조).' },
         claim: { type: 'string', description: '이 일(slug)에 붙겠다고 선언한다 — 잠정이며, 다른 일을 선언하면 앞 선언은 대체된다. 비우면 목록만 읽는다.' },
         item: { type: 'string', description: 'claim 과 함께 쓰면 착수 선언(잠정). work 와 함께 쓰면 완료 확인/표시/해제 대상 — 이 일 안의 결정 항목(item_key, 예: decisions/foo.md).' },
-        work: { type: 'string', description: '이 일(slug)의 특정 항목을 완료로 확인·표시·해제할 때 쓴다 — claim 과 별개(착수 선언 없이도 완료를 다룰 수 있다). item 과 함께 쓴다.' },
+        work: { type: 'string', description: '이 일(slug). **혼자 주면 그 일의 항목 목록**(번호·제목·계획 기간·상태·item_key)을 읽는다(부작용 없음). item 과 함께 주면 그 항목의 완료 확인·표시·해제 — claim 과 별개(착수 선언 없이도 완료를 다룰 수 있다).' },
         done_when: { type: 'string', description: '이 항목의 완료 조건 — 무엇이 되면 끝인가. done_evidence 와 반드시 함께 채운다(work+item과 함께).' },
         done_evidence: { type: 'string', description: 'done_when 과 함께 쓴다 — 그 조건이 실제로 충족됐다는 구체적 관측(파일·시험 결과·커밋 등). 비우면 완료로 못 간다 — 지어내지 말 것, 스스로 확인한 것만.' },
         undone: { type: 'boolean', description: '이 항목의 완료 표시를 되돌린다(사후 정정) — work+item 과 함께 쓴다.' },
@@ -4911,13 +6660,16 @@ function worldWho(c) {
   return '누군가';
 }
 
-function worldFacts(max = 8) {
+function worldFacts(max = 8, strict = false) {
   const { bin } = cellCheck();
   if (!bin) return null;                               // 세포가 없다 — 「없다」와 구별한다
   try {
     const r = spawnSync(bin, ['delta', '--root', process.cwd(), '--json'],
                         { encoding: 'utf8', timeout: 800 });
-    if (r.error || r.status !== 0 || !r.stdout) return [];
+    // `strict` 는 알림 기준선(notifyToolsChanged)의 몫이다 — 시간 초과·실패는 「조용함」이 아니라 「못 읽음」이다.
+    //   빈 목록을 기준선으로 삼으면 다음 정상 답이 변화로 읽혀 알림이 한 번 샌다(2026-09-28 게시 관문 notify 대조군 실측).
+    if (r.error || r.status !== 0) return strict ? null : [];
+    if (!r.stdout) return [];
     const d = JSON.parse(r.stdout);
     const ch = Array.isArray(d.changes) ? d.changes : [];
     const out = ch.slice(0, max).map((c) => {
@@ -5253,7 +7005,7 @@ let toolsNotifyReady = false;          // initialize 전에는 안 보낸다
 let SEND = null;
 
 function notifyToolsChanged(sendFn) {
-  const facts = worldFacts(3);
+  const facts = worldFacts(3, true);
   const sig = facts === null ? null : facts.join('|');
   if (sig === null) return;                       // 세포를 못 읽었다 — 지어내지 않는다
   if (toolsSig === null) { toolsSig = sig; return; }   // 첫 관측은 기준선일 뿐이다
@@ -5721,6 +7473,38 @@ function requireArgs(name, args) {
     + `받는 이름은 이것뿐입니다 — ${all}`);
 }
 
+/**
+ * ── `works(tenant, work)` — 그 일의 항목 한 줄씩(GET /api/work/items, 2026-09-27) ─────────────
+ *
+ * 오너: 「매번 너한테 일감 항목 번호 가져오라고 하는 것 부터가 문제로보여」. 세포는 항목 번호를 알려고
+ * 결정 장을 한 장씩 열었다(같은 날 hnl 세션: 배정안 + 항목 장 일곱). 서버가 간트와 같은 자로 낸 줄을
+ * 그대로 옮긴다 — 번호(code)는 제목 머리의 [ … ] 이고, 없으면 제목만 쓴다(지어내지 않는다).
+ * ⚠ **서버가 준 칸만 쓴다** — 계획·상태 칸이 없거나 비면 그 토막을 안 그린다(옛 서버·빈 관측).
+ */
+function worksItemsList(r) {
+  const works = Array.isArray(r?.works) ? r.works : [];
+  if (!works.length) return `${r?.tenant || ''} — 열린 일이 없다. 0건은 0건이다.`;
+  const md = (d) => String(d || '').slice(5);   // 2026-09-14 → 09-14
+  const out = [];
+  for (const w of works) {
+    const items = Array.isArray(w?.items) ? w.items : [];
+    out.push(`«${w.name || w.slug}» (${w.slug}) — 항목 ${items.length}개`);
+    for (const it of items) {
+      const code = typeof it.code === 'string' && it.code !== '' ? it.code : '';
+      const title = code ? String(it.title || '').replace(/^\[[^\]]*\]\s*/, '') : String(it.title || '');
+      // 계획 끝 말(plan_word)·고유 번호(uid)도 서버가 준 것만 — 할 일 화면과 같은 자(work_task_due_word) · 할 일 표의 uid.
+      const due = it.plan_word && it.plan_word.text && it.plan_word.text !== '—' ? ` (${it.plan_word.text})` : '';
+      const plan = it.plan && it.plan.from ? ` · 계획 ${md(it.plan.from)}~${md(it.plan.to)}${due}` : '';
+      const state = it.state_word ? ` · ${it.state_word}` : '';
+      const uid = typeof it.uid === 'string' && it.uid !== '' ? ` · uid ${it.uid}` : '';
+      out.push(`  · ${code ? code + ' ' : ''}${title}${plan}${state} — ${it.key}${uid}`);
+    }
+    if (Number(w.dropped) > 0) out.push(`  (지시형 제목이라 뺀 결정 ${Number(w.dropped)}건)`);
+  }
+  out.push('항목을 건드리기 전에는 works(tenant, work, item) 로 이미 끝났는지 먼저 확인한다 — 전문은 get_case(tenant, item_key).');
+  return out.join('\n');
+}
+
 /*
  * ── `works` 한 줄의 「항목」 토막 (DESIGN-genetics-ssot.md §7.7) ───────────────────────────
  *
@@ -5749,6 +7533,36 @@ function worksItemsLine(items) {
   return rows.length ? `${head} · 그중 ${rows.join(' · ')}` : head;
 }
 
+/**
+ * **목록 밖으로 떨어진 결정**(2026-09-21) — 그 일의 갈래와 만나는데 **항목이 못 된** 장.
+ *
+ * ★ 왜 이 줄이 있나(LIM 실측 2026-09-21): 「간트에서 항목을 에이전트에게 시키기」 한 목표를
+ *   다룬 결정 5장 중 표지(`work:`)를 단 것은 1장(gantt-dispatch)뿐이었다. 나머지 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 +7921,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 +7967,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,12 +8012,53 @@ 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 'report_task': {
+      const req = taskWriteRequest(args);
+      const call = async (body) => {
+        try {
+          return taskWriteResult(args.task_uid, await api('POST', req.path, body));
+        } catch (e) {
+          /* 거절이어도 글은 남았을 수 있다(근거가 없어 검수로 못 간 경우) — 서버가 그 글을 400 봉투에 함께 실어 준다. 지어내지 않고 그대로 말한다. */
+          if (e && e.status === 400 && e.why && /^(need_evidence|need_done_when|need_assignee)$/.test(e.why)) {
+            return `«${args.task_uid}» — 글은 남았지만 검수로 못 갔다(${e.why}): ${e.message}`
+              + (e.comment && e.comment.id ? ` 글은 남았습니다(#${e.comment.id}).` : '');
+          }
+          throw e;
+        }
+      };
+      try {
+        return await call(req.body);
+      } catch (e) {
+        /* 기본 근거(이 세션)는 내부층 갈래라 member 자격에서는 403 inner_only 로 **글도 안 남는다**(2026-09-26 검토). 사용자가 근거를 안 준 판이면
+           근거 없이 한 번 더 보낸다 — 그러면 글은 남고, 검수로 못 간 사실은 위 400 갈래가 말한다. 사용자가 직접 준 근거는 되풀이하지 않는다. */
+        if (e && e.status === 403 && e.why === 'inner_only' && req.defaulted) {
+          const out = await call({ ...req.body, evidence: [] });
+          return out + ' (이 자격으로는 세션을 근거로 못 실어 근거 없이 남겼다 — 내부층 근거는 우리 팀만.)';
+        }
+        throw e;
+      }
+    }
     case 'works': {
       if (args.work) {
-        // 완료 확인/표시/해제(095) — claim 과 별개 통로. item 은 필수(어느 결정인지).
+        // 완료 확인/표시/해제(095) — claim 과 별개 통로. 표시·해제는 item 이 필수(어느 결정인지).
         const wSlug = String(args.work);
         const item = args.item ? String(args.item) : '';
-        if (!item) return "완료 확인/표시/해제에는 item(item_key)이 있어야 한다 — work만으로는 어느 결정인지 모른다.";
+        if (!item) {
+          // work 만 주면 **그 일의 항목 목록**(2026-09-27) — 번호·제목·계획·상태를 한 번에 읽는다.
+          // 오너: 「매번 너한테 일감 항목 번호 가져오라고 하는 것 부터가 문제」 — 결정 장을 한 장씩 열던 자리.
+          if (args.undone || args.done_when || args.done_evidence) {
+            return '완료 표시/해제에는 item(item_key)이 있어야 한다 — work만으로는 어느 결정인지 모른다. '
+              + '항목 열쇠는 work 만 주고 불러 목록에서 고른다.';
+          }
+          const r = await api('GET', '/api/work/items?tenant=' + encodeURIComponent(args.tenant)
+            + '&work=' + encodeURIComponent(wSlug));
+          return worksItemsList(r);
+        }
         if (args.undone) {
           const r = await api('POST', '/api/work/done', { tenant: args.tenant, work: wSlug, item, undone: true });
           return `${r.item.key} — 완료 표시를 되돌렸다(사후 정정, 원장에 남는다). 지금 상태: ${r.word}.`;
@@ -6246,20 +8101,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 로 막는다. 그 사실을 먼저 말해 두는 것이 헛걸음을 줄인다.
@@ -6296,6 +8160,10 @@ async function callTool(name, args = {}) {
         reopen: args.reopen || '', status: args.status || '', tags: args.tags || [],
         work: args.work || '', order: args.order || [], plan: args.plan || [],
         picks: Array.isArray(args.picks) ? args.picks : [],          // 집은 자리(2026-09-03)
+        // 반려 이름(2026-09-26) — 그대로 싣는다. 모양 검사·거절은 창구 하나(wiki_rejected_names_clean)가 한다.
+        rejected_names: Array.isArray(args.rejected_names) ? args.rejected_names : [],
+        // 옛 결정 뒤집기(2026-09-21) — 댈 때만 싣는다(안 대면 요청이 예전과 같다).
+        ...(args.overturns ? { overturns: args.overturns, overturns_revision: args.overturns_revision || '' } : {}),
         // ★ 출처는 우리가 채운다 — 모델에게 안 묻는다(remember_case 와 같은 규율). 표지가
         //   열린 일과 만나 항목으로 설 때 「누가 심었나」(간트의 세션 자국)가 이것이다.
         ...myCitation(),
@@ -6306,6 +8174,16 @@ async function callTool(name, args = {}) {
         ? '원문은 저장됐지만 후속 정리가 재시도 한도에 닿았습니다. 운영 확인이 필요합니다.'
         : '원문은 저장됐고 후속 정리는 대기 중입니다. 같은 내용을 새로 저장하지 마세요.');
       if (Number(r.picks) > 0) lines.push(`집은 자리 ${r.picks}건 실림 — 다른 기계·다른 사람도 그 요소를 본다.`);
+      // 반려 이름(2026-09-26) — 적힌 수와 빠진 이름을 그대로. 칸이 응답에 없으면 옛 서버다(조용히 버려졌다) — 그렇게 말한다.
+      const sentRejected = Array.isArray(args.rejected_names) ? args.rejected_names.length : 0;
+      if (typeof r.rejected_names === 'number') {
+        if (r.rejected_names > 0) lines.push(`반려 이름 ${r.rejected_names}개를 적었다 — 이 소속처의 문서 발행·모의 발행·로컬 렌더가 경고로 센다(확인: list_rejected_names).`);
+        if (Array.isArray(r.rejected_names_dropped) && r.rejected_names_dropped.length) {
+          lines.push(`같은 제목으로 다시 적어 목록에서 빠진 반려 이름: ${r.rejected_names_dropped.join(' · ')} — 이제 세지 않는다. 뺄 뜻이 아니었으면 다시 적을 것.`);
+        }
+      } else if (sentRejected && !r.effects_pending) {
+        lines.push('반려 이름을 보냈지만 이 서버는 아직 그 칸을 모른다 — 판이 낡았다(목록이 안 적혔다).');
+      }
       // 안 적은 것을 **그렇게 말한다** — 조용히 열린 결정을 만들거나 계산 밖에 두지 않는다.
       if (!args.reopen) {
         lines.push('재개 조건을 안 적어 이 결정은 「아직 열린 것」으로 읽힌다. 끝난 결정이면 reopen 에 "조건 없음(종결)" 을 적을 것.');
@@ -6325,6 +8203,8 @@ async function callTool(name, args = {}) {
       // 표지(work:)의 앞날 — 문장의 정본은 서버(work_decl_mark_note → 응답 work_note)다.
       // 여기서 프로즈를 다시 지으면 두 벌이 되어 한쪽이 낡는다(2026-09-01 에 두 벌을 실제로
       // 걷었다 — mcp.php 와 이 파일이 같은 문장을 복제하고 있었다).
+      // 옛 장 도장(2026-09-21) — 문장의 정본은 서버(wiki_decision_overturn_note → 응답 overturn_note)다. 옮기기만 한다.
+      if (typeof r.overturn_note === 'string' && r.overturn_note !== '') lines.push(r.overturn_note);
       if (typeof r.work_note === 'string' && r.work_note !== '') {
         lines.push(r.work_note);
       } else if (r.work_mark) {
@@ -6336,6 +8216,28 @@ async function callTool(name, args = {}) {
       }
       return lines.join('\n');
     }
+    case 'list_rejected_names': {
+      // 고르는 자(이름마다 가장 새 결정 · 뒤집힘 제외 · 깨진 줄 skipped)는 서버 report_rejected_names 하나다 — 여기서 다시 고르지 않는다.
+      const r = await api('GET', '/api/wiki/rejected_names?tenant=' + encodeURIComponent(args.tenant));
+      const names = Array.isArray(r.names) ? r.names : [];
+      const skipped = Array.isArray(r.skipped) ? r.skipped : [];
+      if (args.format === 'json') {
+        // 기계가 읽는 모양 — render.py·발행 직전 훅이 렌더러 cfg `rejected_names` 로 그대로 얹는다(대조에 쓰는 셋만).
+        return JSON.stringify({
+          tenant: r.tenant, tenant_slug: r.tenant_slug,
+          names: names.map((n) => ({ name: n.name, use: n.use || '', near: Array.isArray(n.near) ? n.near : [] })),
+          counted: names.length, skipped, note: r.note || '',
+        });
+      }
+      const lines = [`${r.tenant} — 반려 이름 ${names.length}개(결정 장 ${r.decisions_read ?? 0}장을 읽음)`];
+      for (const n of names) {
+        const near = Array.isArray(n.near) && n.near.length ? ` | 함께: ${n.near.join(', ')}` : '';
+        lines.push(`  · ${n.name} → ${n.use || '(대신 쓸 이름 안 적힘)'}${near}  (${n.since || '날짜 모름'} · ${n.decision}${n.status && n.status !== '유효' ? ' · ' + n.status : ''})`);
+      }
+      for (const s of skipped) lines.push(`  ⚠ ${s.path} — 반려 이름 줄을 못 읽었다(${s.why}). 그 장의 이름은 세지 않는다.`);
+      if (r.note) lines.push(r.note);
+      return lines.join('\n');
+    }
     case 'forget_decision': {
       const r = await api('DELETE', '/api/wiki/decision?tenant=' + encodeURIComponent(args.tenant)
         + '&path=' + encodeURIComponent(String(args.path || ''))
@@ -6368,7 +8270,7 @@ async function callTool(name, args = {}) {
         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 || [],
+        paths: args.paths || [], commands: args.commands || [], errors: args.errors || [], work: args.work || '',
         picks: Array.isArray(args.picks) ? args.picks : [],          // 집은 자리(2026-09-03) — 그대로 넘긴다, 모양은 서버가 검사
         // ★ **출처는 우리가 채운다 — 모델에게 안 묻는다.** 스키마에 노출하면 지어낸다
         //   (DESIGN-session-as-vcs.md §5.1 「출처를 도구 인자로 두지 말 것」). 모르면 안 보내고, 서버는 안 적는다.
@@ -6393,6 +8295,12 @@ async function callTool(name, args = {}) {
         }
         if (Array.isArray(r.skipped) && r.skipped.length) lines.push('못 보낸 곳: ' + r.skipped.join(' / '));
       }
+      // 일의 열쇠 — **적혔는지 부른 쪽이 알아야 한다.** 옛 서버는 이 칸 자체가 없어 조용히 버리므로 그것을 그대로 말한다.
+      if (args.work) {
+        if (r.work === undefined) lines.push(`⚠ work=「${args.work}」 는 **이 서버가 모르는 칸**이라 안 적혔다 — 서버를 먼저 올린 뒤 다시 적는다.`);
+        else if (!r.work) lines.push(`⚠ work=「${args.work}」 가 안 적혔다 — 서버가 받아들이지 않았다.`);
+        else lines.push(`일: ${r.work} — 이 사례가 그 일의 시정조치 기록으로 걸렸다(갈래 맨 앞).`);
+      }
       if (r.triggers && typeof r.triggers === 'object') {
         const t = r.triggers;
         const n = (t.paths?.length || 0) + (t.commands?.length || 0) + (t.errors?.length || 0);
@@ -6548,8 +8456,46 @@ async function callTool(name, args = {}) {
            + (follow.length ? `\n\n${follow.join('\n')}` : '');
     }
     case 'push_session': {
-      const { r, before, parts } = await pushSession(args.tenant, args.uuid, args.title, args.dry_run, 'propose');
-      const cut = `${before.toLocaleString()}B → ${r.bytes.toLocaleString()}B`;
+      /*
+       * ★ **사람의 올리기도 입구 임대를 지난다 — 간격은 안 지난다**(DESIGN-session-delta-sync §3.4 · C7). 같은 대화를 이 기계의
+       *   다른 창이 지금 올리고 있으면 **비동기로** 최대 30초 기다린다(`Atomics.wait` 는 stdio 고리를 통째로 멈춰 안 쓴다 — race S5).
+       *   정합성은 어차피 서버가 지킨다 — 기다리는 것은 헛 409 를 줄이는 효율 장치라, 임대 자리를 못 만들면 임대 없이 간다.
+       *   dry_run 은 대응표·키를 안 만들고 서버도 행을 안 써 임대를 안 탄다.
+       */
+      let lease = null;
+      if (!args.dry_run) {
+        const got = await leaseWait(String(args.uuid || ''));
+        if (got.held) {
+          return `다른 창이 올리는 중입니다 — 이 기계의 다른 창이 이 대화(${String(args.uuid).slice(0, 8)})를 지금 올리고 있어 `
+               + `${Math.round(HUMAN_LEASE_WAIT_MS / 1000)}초를 기다렸지만 끝나지 않았습니다. 잠시 뒤 다시 부르세요.`;
+        }
+        lease = got.h || null;
+      }
+      let pushed;
+      try {
+        /*
+         * ★ **사람의 올리기도 덧붙임 길을 탄다**(§3.4 · C8) — 대응표가 서 있고 서버가 광고했으면 덧붙은 줄만 간다.
+         *   ⚠ 사람의 push 는 **FULL 예산을 세지도 않고 받지도 않는다**(`hooks.plan` 을 안 건다) — 예산은 기계의 폭주를
+         *     막는 것이지 사람이 「지금 올려라」고 한 것을 미루는 장치가 아니다(C7 이 남긴 숙제 ②의 처방).
+         *   ⚠ 따라잡기도 여기서 돈다 — 옆 창이 더 뒤까지 올린 직후에 사람이 보던 409 `behind` 가 이 커밋에서 닫힌다(C6 넘김).
+         */
+        pushed = await pushSession(args.tenant, args.uuid, args.title, args.dry_run, 'propose', null,
+          lease ? { progress: () => leaseTouch(lease) } : null);
+        // 사람이 올린 시각도 간격의 시작이다 — 방금 올린 대화를 옆 창의 자동 길이 곧바로 또 보내지 않게(색인은 기계 공용).
+        if (!args.dry_run) indexPatch(String(args.uuid), { auto: { last_at: Date.now() } });
+      } catch (e) {
+        // 따라잡고 보니 보낼 줄이 없었다 — 오류가 아니라 사실이다(대응표는 섰다).
+        if (String(e?.code || '') === 'caught_up') {
+          return `올릴 것이 없습니다 — 서버가 이미 이 대화(${String(args.uuid).slice(0, 8)})의 끝까지 가지고 있습니다.`
+               + (e?.moved && !args.dry_run ? '\n이 기계의 좌표만 맞췄습니다(다음 갱신부터 덧붙은 줄만 올라갑니다).' : '');
+        }
+        throw e;
+      } finally { fileUnlock(lease); }
+      const { r, before, parts, plan, appended } = pushed;
+      // 표시를 **덧붙임 X B / 전체 Y B** 로(§3.4) — 통째로 갔으면 전처럼 「전 → 후」다.
+      const cut = plan?.mode === 'APPEND' || plan?.mode === 'ASK'
+        ? `덧붙임 ${Number(appended || 0).toLocaleString()}B / 전체 ${r.bytes.toLocaleString()}B`
+        : `${before.toLocaleString()}B → ${r.bytes.toLocaleString()}B`;
       // 폴더 제안의 결과 — 문장의 정본은 서버다(§4.2). 옛 서버는 칸이 없어 침묵한다.
       const bindNote = typeof r.binding?.note === 'string' && r.binding.note !== '' ? r.binding.note + '\n' : '';
       // 조각으로 갔으면 말한다 — 크기 때문에 사람이 할 일이 없다는 것을 결과가 보여 준다.
@@ -6972,10 +8918,36 @@ function cellLinkDir(pathEnv, candidates, exists, writable) {
   }
   return null;
 }
+/*
+ * ★★ **남의 HOME 으로 뜬 프로세스는 전역 PATH 자리를 안 건드린다**(C7 · 2026-09-21 실측 누수).
+ *   `CELL_PATH` 는 `os.homedir()` 를 따른다(posix 는 HOME 환경). 시험이 가짜 HOME 으로 MCP 를 띄우면 그 HOME 의 세포가
+ *   생기는데, 전역 자리(/opt/homebrew/bin 등)의 `gcell` 이 「옛 자리를 가리키는 우리 심링크」로 읽혀 **가짜 HOME 쪽으로
+ *   갈아 끼워졌다** — 시험이 끝나 그 HOME 이 지워지면 이 기계의 `gcell` 이 통째로 dangling 이 된다(C6 검토 때 실제로 났다).
+ *   그래서: 고른 자리가 이 HOME 밖(전역)이고, 이 프로세스의 HOME 이 **이 사용자의 실제 집**(passwd — `os.userInfo().homedir`)이
+ *   아니면 걸지도 걷지도 않고 말만 한다. HOME 안의 자리(~/.local/bin)는 그 HOME 의 것이라 그대로 건다.
+ *   실제 집을 모르면(userInfo 가 던짐) 닫는 쪽 — 전역 자리를 안 건드린다. **순수 함수**(smoke 가 표로 잰다).
+ */
+function cellLinkForeign(dir, home, realHome) {
+  const norm = (p) => { const s = String(p || ''); try { return fs.realpathSync(s); } catch { return s; } };
+  const h = norm(home);
+  const d = norm(dir);
+  if (h && (d === h || d.startsWith(h.endsWith(path.sep) ? h : h + path.sep))) return false;   // 이 HOME 의 자리
+  return !realHome || norm(realHome) !== h;
+}
+function cellRealHome() {
+  try { return os.userInfo().homedir || ''; } catch { return ''; }
+}
 function cellLinkOnPath() {
   const dir = cellLinkDir(process.env.PATH, CELL_LINK_CANDIDATES,
     (d) => { try { return fs.statSync(d).isDirectory(); } catch { return false; } },
     (d) => { try { fs.accessSync(d, fs.constants.W_OK); return true; } catch { return false; } });
+  if (dir && cellLinkForeign(dir, os.homedir(), cellRealHome())) {
+    // ⚠ 까닭을 **그대로** 적는다(반박 compat 2-B) — 「시험용 HOME」이라고만 하면 `sudo -E`·passwd 항목이 없는 컨테이너처럼
+    //   HOME 이 정당하게 다른 사람이 원인을 못 찾는다. 그 사람들은 이 한 줄을 보고 손으로 걸면 된다.
+    return `전역 자리(${dir})에는 \`gcell\` 을 안 걸었다 — 이 프로세스의 HOME(${os.homedir()})이 passwd 의 집`
+         + `(${cellRealHome() || '알 수 없음'})과 달라, 남의 HOME 으로 뜬 프로세스가 기계 공용 자리를 갈아 끼우지 않게 막았다`
+         + `(시험용 HOME·sudo -E·컨테이너). 전체 경로 ${CELL_PATH} 로 부르거나, 직접 걸려면 ln -sfn ${CELL_PATH} ${path.join(dir, 'gcell')}.`;
+  }
   if (!dir) {
     if (process.platform === 'win32') {
       return `PATH 에 안 걸었다(Windows 는 심링크에 권한이 필요하다) — 전체 경로 ${CELL_PATH} 로 부르거나 `
@@ -7000,6 +8972,7 @@ function cellLinkOnPath() {
 function cellUnlinkOnPath() {
   const out = [];
   for (const d of CELL_LINK_CANDIDATES) {
+    if (cellLinkForeign(d, os.homedir(), cellRealHome())) continue;   // 거는 쪽과 같은 가드 — 남의 HOME 은 전역 자리를 안 만진다
     const link = path.join(d, 'gcell');
     try {
       if (fs.lstatSync(link).isSymbolicLink() && fs.readlinkSync(link) === CELL_PATH) {
@@ -7438,7 +9411,8 @@ if (IS_MAIN) {
 }
 
 // 시험용 — 서버 동작에는 쓰이지 않는다. materializeAssets 만 네트워크를 쓴다.
-export { encodeAsset, imageDims, imageHostAllowed, materializeAssets, warnText, IMAGE_HOST_ALLOW, HOST_ALLOW,
+export { videoThumbs, 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,
@@ -7458,4 +9432,16 @@ export { encodeAsset, imageDims, imageHostAllowed, materializeAssets, warnText,
          autoRowOnServer,
          // 2026-09-18 Windows — 남의 규칙(Claude Code 슬러그)·플랫폼 갈래는 시험이 표로 걷는다
          transcriptSlug, transcriptDir, cursorUserRoot, sqliteBin, npxCacheResetHint, cellPlatformSupported,
-         HOLDS_FILE, UPDATE_BUDGET_MS };
+         HOLDS_FILE, UPDATE_BUDGET_MS,
+         // DESIGN-session-delta-sync C6 — 규칙판·좌표·기계 키·대응표·머리 끊기·private 판정(시험이 걷는다)
+         SCRUB_REV, CWD_HIST_MAX, PUSH_MAC_WIN, pushDir, pushKey, pushKeyId, pushMac, pushCoords,
+         ledgerRead, ledgerWrite, ledgerAfterFull, autoPrepare, transcriptHead,
+         // DESIGN-session-delta-sync C7 — 한 입구(갈래·임대·임대 안 판정·닫힘) · 요청 상한(바이트에 비례) · 전역 링크 가드(시험이 걷는다)
+         autoPolicyOf, autoIntervalOf, autoGateOf, autoBlockedFor, autoLegacyCheck, autoHistOverflow, gitRootAbove,
+         leaseFile, leaseTake, LEASE_QUIET_MS, HUMAN_LEASE_WAIT_MS, API_TIMEOUT_MS, apiTimeoutFor, API_MIN_BPS, AUTO_CLOSED_CODES,
+         AUTO_BACKOFF_LONG_MS, AUTO_PUSH_MIN_MS, cellLinkForeign,
+         // DESIGN-session-delta-sync C8 — 갈래 고르기·능력 광고·조각 나누기·접기·FULL 예산·사본 재정의(시험이 걷는다)
+         planPush, pushSession, pushAppend, capsNote, capsAppend, capsScrubRev, capsFile, capsAppendGone, CAPS_FALSE_TTL_MS,
+         readAt, lastNewlineAt, countLines, appendScan, splitSeg, foldHist, scrubDelta, hashRange, pushTenantId,
+         APPEND_ENV_MAX, APPEND_RAW_STEP, APPEND_ROUND_MAX,
+         autoFullBudgetOf, autoFullCounts, autoDupOf, PUSH_FULL_BUDGET, PUSH_FULL_WINDOW_MS, PUSH_FULL_REBASE, PUSH_FULL_LOG_MAX };