npm - @things-factory/headless-twin - Versions diffs - 10.0.13 → 10.0.14 - Mend

@things-factory/headless-twin 10.0.13 → 10.0.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (42) hide show

package/dist-server/engine/ingest-health.d.ts CHANGED Viewed

@@ -120,6 +120,35 @@ export interface IngestLedger {
         /** 어느 흐름에서 났나(어댑터가 말해 주면). 원본마다 흐름이 다르므로 열려 있다. */
         stream?: string;
     };
+    /**
+     * **읽었는데 창을 넘길 수 없다** (2026-08-24) — 위와 **다른 사실**이다.
+     *
+     * ── 왜 갈랐나 ───────────────────────────────────────────────────────────────
+     * 이 칸을 만들기 전에는 두 사실이 같은 이름으로 나갔다.
+     *
+     *   readFailure   원본에 닿지 못했다        → **기다리면 풀린다**
+     *   cursorStall   읽었는데 커서가 못 넘어간다 → **기다려도 안 풀린다**
+     *
+     * 둘째는 읽기가 성공한 실패다: 한 시각에 한 페이지보다 많은 행이 몰려 커서를 그 시각 밖으로 옮길 수
+     * 없다. 화면이 「원본에 닿지 못한다」고 말하면 사람은 원본을 의심하고 기다리는데, 필요한 조치는
+     * 페이지를 키우거나 같은 시각 안에서 순서를 정하는 것이다. **조치가 반대인 두 사실을 한 이름으로
+     * 부르면 그 이름은 정보가 아니라 오해다.**
+     *
+     * 모양은 위와 같게 둔다 — 「몇 번」과 「언제부터」가 여기서도 같은 값을 한다(한 번의 밀림과 사흘째
+     * 못 넘어가는 것은 다르다). 넘어가면 지운다.
+     */
+    cursorStall?: {
+        /** 연속 정체 수 — 넘어가면 0 으로 돌아간다. */
+        consecutive: number;
+        /** 이 정체가 **처음** 시작된 시각(ms). */
+        sinceMs: number;
+        /** 마지막 정체 시각(ms). */
+        lastAtMs: number;
+        /** 사유 — 사람이 읽는 한 줄(어느 시각에서 막혔나까지 어댑터가 말해 주면 좋다). */
+        reason: string;
+        /** 어느 흐름인가. 밀도가 높은 표는 원본마다 다르므로 이 이름이 조치의 절반이다. */
+        stream?: string;
+    };
 }
 /**
  * 읽기 실패를 장부에 적는다 — **받은 것이 없는 것과 가른다.**
@@ -135,6 +164,16 @@ export declare function recordReadFailure(ledger: IngestLedger, reason: string,
  * 조용한 원본이 끊긴 원본으로 보인다(고치려던 것의 반대 방향으로 틀린다).
  */
 export declare function clearReadFailure(ledger: IngestLedger): void;
+/**
+ * 커서 정체를 장부에 적는다 — **닿지 못한 것과 가른다.**
+ *
+ * `recordReadFailure` 와 같은 모양이지만 **다른 칸**이다. 한 주기가 두 이유로 실패할 수는 없으므로
+ * (먼저 닿아야 읽는다) 둘이 동시에 서지 않는다 — 그래서 화면은 둘 중 하나만 보게 되고, 그 하나가
+ * 조치를 정한다.
+ */
+export declare function recordCursorStall(ledger: IngestLedger, reason: string, nowMs: number, stream?: string): void;
+/** 창을 넘겼으면 지운다 — 풀린 정체가 화면에 남아 있으면 그것도 거짓이다. */
+export declare function clearCursorStall(ledger: IngestLedger): void;
 /** 창 길이 — 10분. 부하 계기판(10초)과 다른 값이라 이름을 따로 둔다(같은 이름이면 섞인다). */
 export declare const INGEST_WINDOW_MS = 600000;
 /**
@@ -309,6 +348,8 @@ export interface IngestHealthView {
     /**
      * **원본에 닿지 못하고 있다** — 없으면 닿고 있다는 뜻이다(§`IngestLedger.readFailure`).
      *
+     * 커서 정체(`cursorStall`)와 **섞이지 않는다**: 이쪽은 기다리면 풀리고 그쪽은 기다려도 안 풀린다.
+     *
      * 「유입 없음」과 **다른 판정**이다: 유입 없음은 원본이 조용한 것일 수 있고, 이것은 우리가 묻지도
      * 못한 것이다. 화면은 두 문장을 다르게 말해야 한다 — 실 원본이 끊겼을 때 사용자가 원인을 찾을 수
      * 있는지가 그 차이다.

package/dist-server/engine/ingest-health.js CHANGED Viewed

@@ -31,6 +31,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.HEALTHY_ACCEPTED_RATIO = exports.RECORD_MAX = exports.SAMPLE_LIMIT = exports.OTHER_REASON = exports.REASON_LIMIT = exports.TREND_LIMIT = exports.STALE_AFTER_MS = exports.INGEST_WINDOW_MS = void 0;
 exports.recordReadFailure = recordReadFailure;
 exports.clearReadFailure = clearReadFailure;
+exports.recordCursorStall = recordCursorStall;
+exports.clearCursorStall = clearCursorStall;
 exports.newIngestLedger = newIngestLedger;
 exports.rollIngestWindow = rollIngestWindow;
 exports.reasonKey = reasonKey;
@@ -64,6 +66,28 @@ function clearReadFailure(ledger) {
     if (ledger.readFailure)
         delete ledger.readFailure;
 }
+/**
+ * 커서 정체를 장부에 적는다 — **닿지 못한 것과 가른다.**
+ *
+ * `recordReadFailure` 와 같은 모양이지만 **다른 칸**이다. 한 주기가 두 이유로 실패할 수는 없으므로
+ * (먼저 닿아야 읽는다) 둘이 동시에 서지 않는다 — 그래서 화면은 둘 중 하나만 보게 되고, 그 하나가
+ * 조치를 정한다.
+ */
+function recordCursorStall(ledger, reason, nowMs, stream) {
+    const prev = ledger.cursorStall;
+    ledger.cursorStall = {
+        consecutive: (prev?.consecutive ?? 0) + 1,
+        sinceMs: prev?.sinceMs ?? nowMs,
+        lastAtMs: nowMs,
+        reason,
+        ...(stream ? { stream } : {})
+    };
+}
+/** 창을 넘겼으면 지운다 — 풀린 정체가 화면에 남아 있으면 그것도 거짓이다. */
+function clearCursorStall(ledger) {
+    if (ledger.cursorStall)
+        delete ledger.cursorStall;
+}
 /** 창 길이 — 10분. 부하 계기판(10초)과 다른 값이라 이름을 따로 둔다(같은 이름이면 섞인다). */
 exports.INGEST_WINDOW_MS = 600_000;
 /**
@@ -386,6 +410,19 @@ function ingestHealth(ledger, feedState, threshold = exports.HEALTHY_ACCEPTED_RA
                         ...(ledger.readFailure.stream ? { stream: ledger.readFailure.stream } : {})
                     }
                 }
+                : {}),
+            /* 커서 정체도 **이 갈래에서** 내보낸다 — 유입이 없는 장부에서도 정체는 실재한다(읽었으나 못
+               넘겼으면 유입이 0이다). 여기서 떨어뜨리면 바로 그 상황에서 조용해진다. */
+            ...(ledger?.cursorStall
+                ? {
+                    cursorStall: {
+                        consecutive: ledger.cursorStall.consecutive,
+                        since: new Date(ledger.cursorStall.sinceMs).toISOString(),
+                        lastAt: new Date(ledger.cursorStall.lastAtMs).toISOString(),
+                        reason: ledger.cursorStall.reason,
+                        ...(ledger.cursorStall.stream ? { stream: ledger.cursorStall.stream } : {})
+                    }
+                }
                 : {})
         };
     }
@@ -426,6 +463,17 @@ function ingestHealth(ledger, feedState, threshold = exports.HEALTHY_ACCEPTED_RA
                     ...(ledger.readFailure.stream ? { stream: ledger.readFailure.stream } : {})
                 }
             }
+            : {}),
+        ...(ledger.cursorStall
+            ? {
+                cursorStall: {
+                    consecutive: ledger.cursorStall.consecutive,
+                    since: new Date(ledger.cursorStall.sinceMs).toISOString(),
+                    lastAt: new Date(ledger.cursorStall.lastAtMs).toISOString(),
+                    reason: ledger.cursorStall.reason,
+                    ...(ledger.cursorStall.stream ? { stream: ledger.cursorStall.stream } : {})
+                }
+            }
             : {})
     };
 }

package/dist-server/engine/ingest-health.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"ingest-health.js","sourceRoot":"","sources":["../../server/engine/ingest-health.ts"],"names":[],"mappings":"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","sourcesContent":["/\n 동기화 건강 — 이 트윈이 현장과 맞춰지고 있나. 순수(import 없음).\n \n ── 한 질문 ─────────────────────────────────────────────────────────────────\n * 화면에서 값이 변하지 않을 때 원인이 넷인데, 지금까지 넷이 똑같이 보였다.\n * ① 피드가 붙지 않았다 ② 붙었는데 아무것도 오지 않는다\n * ③ 오는데 전부 거부된다 ④ 정상인데 현장이 조용하다\n * ③은 특히 나쁘다 — 커넥터의 매핑이 한 글자 틀리면 트윈은 「빈 공장」이 되고, 그 사실이 서버 로그\n * 한 줄에만 남았다. 현장에 나간 사람은 로그를 뒤져야 했다.\n \n ── 왜 저널로는 답할 수 없나 ────────────────────────────────────────────────\n * 거부된 것은 저널에 없다 — 거부의 뜻이 그것이다. 저널을 접으면 통과한 쪽만 나온다. 거부의 추이는\n * 세는 자리를 따로 두어야 나온다. 이 장부가 그 자리다.\n \n ── 왜 건마다 저장하지 않나 ─────────────────────────────────────────────────\n * 라이브 계측은 초당 여러 건이다. 거부마다 행을 쓰면 그 자체가 부하가 된다(`reference-live.ts` 가\n * 이미 그렇게 적어 두었다). 그리고 이 패키지는 `integration-base` 를 알지 않는다(이식성 규약) —\n * 시나리오 경로가 쓰는 dead-letter 를 여기서 부를 수 없다. 그래서 집계한다.\n \n ── 통과와 거부를 함께 센다 ─────────────────────────────────────────────────\n * 거부만 그리면 「유입 없음」과 「정상」이 둘 다 거부 0 으로 같아 보인다. 제시 수가 있어야 갈린다.\n \n ── 지키는 규율 넷 ──────────────────────────────────────────────────────────\n * ① 닫힌 창만 「최근」이다 — 채우는 중인 창은 과소 집계다(부하 계기판에서 겪었다).\n * ② 0 과 「없음」을 가른다 — 안 받은 것은 `null`, 받았지만 거부 0 은 `0`.\n * ③ 조용히 자르지 않는다 — 표본·추이 상한에서 밀려난 수를 함께 낸다.\n * ④ 통과율에 1 을 함부로 쓰지 않는다 — 1,000건 중 1건 거부는 0.999 다.\n /\n\n/* 추이 창 하나 — 제시·통과·거부·미전달, 그리고 적힌 것을 함께 든다. /\nexport interface IngestWindow {\n /* 창이 열린 시각(ms). /\n startMs: number\n /* 창이 닫힌 시각(ms). 아직 채우는 중이면 `-1`. /\n endMs: number\n /* 이 창에 제시된 레코드 수(거부 여부 무관). /\n offered: number\n /* 그중 매핑이 거부한 수 — 처방은 매핑을 고치는 것이다. /\n rejected: number\n /\n 매핑은 통과했지만 트윈에 닿지 못한 수 — 처방은 트윈을 세우는 것이다.\n \n ── 왜 거부와 따로 세나 (2026-08-20에 겪었다) ─────────────────────────────\n * 트윈이 라이브로 돌지 않으면 커널이 레코드를 조용히 버린다. 그런데 장부는 그것을 「통과」로 셌다.\n * 화면이 「150 들어옴 · 150 통과 · 100%」라고 말하는 동안 150건은 바닥에 버려지고 있었다. 이 기능이\n * 막으려던 바로 그것을 이 기능이 저지른 셈이다.\n \n 거부에 합치는 것도 답이 아니다 — 거부는 「매핑을 고쳐라」는 말이고, 여기서 필요한 말은 「트윈이 안\n * 돌고 있다」다. 처방이 다르면 다른 수로 센다.\n /\n undelivered: number\n /\n 이 창에 저널에 적힌 행 수 — 「무엇이 남았나」.\n \n 유입과 다른 축이다: 시뮬 트윈은 받는 것 없이 자기가 낸 사실을 적는다(그래서 `offered` 는 0 이고\n * `rows` 는 0 이 아니다). 이 칸이 없으면 그 트윈의 활동은 어느 추이에도 나타나지 않는다.\n /\n rows: number\n /\n 그것을 적기 위해 DB 를 두드린 횟수(flush) — 「우리가 몇 번 갔나」.\n \n 행 수와 따로 세는 이유: 2026-08-20 에 고친 것이 바로 이 값이다(행마다 한 번 → 창당 한 번). 행만\n * 세면 그 개선도, 되돌아가는 것도 보이지 않는다.\n /\n flushes: number\n}\n\n/* 거부 표본 하나 — 매핑을 고치려면 실제 모양을 봐야 한다. /\nexport interface RejectSample {\n atMs: number\n /* 커널이 낸 사유. 우리가 다시 쓰지 않고 그대로 옮긴다. /\n errors: string[]\n /* 막힌 레코드의 직렬화. 길면 자르고, 잘랐다고 표시한다. /\n record: string\n recordTruncated?: boolean\n}\n\nexport interface IngestLedger {\n /* 지금 채우는 중인 창. `startMs < 0` 이면 아직 아무것도 받지 않았다. /\n window: IngestWindow\n /* 닫힌 창들 — 오래된 것이 앞. 상한을 넘으면 앞에서 밀려난다. /\n trend: IngestWindow[]\n /* 추이에서 밀려난 창 수. /\n trendDropped: number\n /* 누적 제시·거부·미전달. /\n offered: number\n rejected: number\n undelivered: number\n /* 누적 — 적힌 행과 두드린 횟수. /\n rows: number\n flushes: number\n /\n 마지막으로 적은 시각. 한 번도 없으면 `-1`.\n \n 유입 시각(`lastAtMs`)과 갈라 두는 이유는 위 `recordJournalWrite` 주석에 있다 — 섞으면 끊긴 피드가\n * 초록으로 보인다.\n /\n lastWriteAtMs: number\n /\n 마지막으로 버려진 시각(ms). 한 번도 없으면 `-1`.\n \n 창과 따로 둔다: 미전달은 창이 닫히기 전에 알아야 한다(그 사이에도 사실은 계속 사라지고 있다).\n /\n lastUndeliveredAtMs: number\n /* 사유별 누적 건수와 마지막으로 그 사유가 난 시각 — 고친 사유는 시각이 멈춘다. /\n byReason: Record<string, { count: number; lastAtMs: number }>\n /\n 사유 종류가 상한에 닿았나.\n \n 접힌 종류 수는 세지 않는다 — 그것을 세려면 이미 본 사유를 모두 기억해야 하고, 그 집합이\n * 바로 이 상한으로 막으려던 무한한 집합이다. 접힌 건수는 `byReason[OTHER_REASON].count` 가 답한다.\n /\n reasonsCapped: boolean\n /* 표본을 이미 뜬 사유들 — 같은 사유를 다시 직렬화하지 않기 위한 색인(O(1) 조회). /\n sampledReasons: Set<string>\n /* 최근 거부 표본. /\n samples: RejectSample[]\n /* 표본에서 밀려난 거부 건수. /\n sampleDropped: number\n /* 마지막으로 무엇이든 받은 시각(ms). 한 번도 없으면 `-1` — 0 으로 두면 시각 0 과 구별되지 않는다. /\n lastAtMs: number\n /\n 원본에 닿지 못한 사실 (2026-08-23) — 「받은 것이 없다」와 다른 사실이다.\n \n ── 무엇이 조용했나 ─────────────────────────────────────────────────────────\n * 실 원본이 끊겼을 때(접속 시간 초과) 트윈의 조회 가능한 상태 어디에도 그 사실이 없었다.\n * `recordIngest` 는 `onRecords` 가 불릴 때만 도달하고, 읽기가 실패하면 그 문에 오지 않는다.\n * `TwinReference.lastError` 는 마스터 동기·접속 시험에만 적힌다.\n \n 그래서 화면이 볼 수 있는 것은 「새 사실이 없다」뿐이었고, 그것은 *「원본이 조용하다」와 구별되지\n 않는다.** 실증 데모 중에 원본이 끊기면 사용자가 원인을 찾을 수 없다.\n \n ── 왜 「몇 번」과 「언제부터」를 함께 두나 ──────────────────────────────────\n * 한 번 실패한 것과 20분째 못 읽는 것은 다른 사실이다. 그 구별이 없으면 화면이 순간의 실패에 놀라거나\n * 계속된 단절을 대수롭지 않게 말한다. 그래서 연속 실패 수와 처음 실패한 시각을 함께 든다.\n \n 성공하면 지운다 — 고쳐진 단절이 화면에 남아 있으면 그것도 거짓이다.\n /\n readFailure?: {\n /* 연속 실패 수 — 성공 한 번에 0 으로 돌아간다. /\n consecutive: number\n /* 이 단절이 처음 시작된 시각(ms). 연속이 끊기면 다시 정해진다. /\n sinceMs: number\n /* 마지막 실패 시각(ms). /\n lastAtMs: number\n /* 마지막 실패의 사유 — 사람이 읽는 한 줄(원본이 준 말 그대로). /\n reason: string\n /* 어느 흐름에서 났나(어댑터가 말해 주면). 원본마다 흐름이 다르므로 열려 있다. /\n stream?: string\n }\n}\n\n/\n 읽기 실패를 장부에 적는다 — 받은 것이 없는 것과 가른다.\n \n 연속 실패의 시작 시각을 지키는 것이 이 함수의 요점이다: 매번 새로 적으면 「20분째 못 읽는다」를\n * 말할 수 없고, 화면은 늘 「방금 실패했다」만 보게 된다.\n /\nexport function recordReadFailure(\n ledger: IngestLedger,\n reason: string,\n nowMs: number,\n stream?: string\n): void {\n const prev = ledger.readFailure\n ledger.readFailure = {\n consecutive: (prev?.consecutive ?? 0) + 1,\n sinceMs: prev?.sinceMs ?? nowMs,\n lastAtMs: nowMs,\n reason,\n ...(stream ? { stream } : {})\n }\n}\n\n/\n 읽기가 성공했다 — 단절 기록을 지운다.\n \n 빈 읽기도 성공이다: 원본이 「새 것이 없다」고 답한 것은 닿았다는 뜻이다. 그 둘을 같게 두면\n * 조용한 원본이 끊긴 원본으로 보인다(고치려던 것의 반대 방향으로 틀린다).\n /\nexport function clearReadFailure(ledger: IngestLedger): void {\n if (ledger.readFailure) delete ledger.readFailure\n}\n\n/* 창 길이 — 10분. 부하 계기판(10초)과 다른 값이라 이름을 따로 둔다(같은 이름이면 섞인다). /\nexport const INGEST_WINDOW_MS = 600_000\n\n/\n 이만큼 아무것도 오지 않으면 「유입 없음」이라 말한다.\n \n 창 하나와 같게 둔다 — 한 창을 통째로 비운 것은 실제로 「그 구간에 아무것도 오지 않았다」이고, 추이의\n * 그 자리도 비게 된다. 그림과 알약이 같은 말을 하게 하려면 같은 길이여야 한다.\n /\nexport const STALE_AFTER_MS = INGEST_WINDOW_MS\n\n/* 추이 보관 창 수 — 36창 × 10분 = 6시간. 「고친 것이 먹혔나」를 보기에 충분하고 메모리는 숫자 넷×36 이다. /\nexport const TREND_LIMIT = 36\n\n/\n 사유 종류 상한.\n \n 없으면 메모리가 끝없이 자란다. 사유 문구에 레코드마다 다른 값이 섞이는 커넥터가 하나만 있어도\n * (`unknown bizStep \"PUTAWAY_X17\"`, `…X18`, …) 키가 무한히 늘어난다. 초당 1만 건 규모에서 이것은\n * 미미한 오버헤드가 아니라 누수다.\n \n 넘치면 `OTHER_REASON` 한 칸에 모으고 몇 종을 접었는지 함께 낸다(조용히 자르지 않는다).\n * 30종이면 고칠 곳을 찾기에 충분하다 — 목록을 훑는 일이 아니라 매핑 몇 줄을 고치는 일이다.\n /\nexport const REASON_LIMIT = 30\n\n/* 상한을 넘긴 사유들이 모이는 칸. /\nexport const OTHER_REASON = '(other reasons)'\n\n/\n 표본 상한 — 사유마다 한 건만 든다.\n \n 같은 사유 20건보다 서로 다른 사유 1건씩이 매핑을 고치는 데 유용하다. 그리고 이 규칙이 성능을\n * 지킨다: 그 사유의 표본이 이미 있으면 `JSON.stringify` 를 아예 하지 않는다. 실측(레코드 241바이트)\n * 으로 건당 0.24µs 인데, 초당 1만 건이 전부 거부되면 9,980건은 만들자마자 버려지는 문자열이었다 —\n * CPU 는 감당되지만 GC 압박이 이벤트 루프로 돌아온다.\n /\nexport const SAMPLE_LIMIT = REASON_LIMIT\n\n/* 표본 하나의 직렬화 상한(문자). /\nexport const RECORD_MAX = 2000\n\n/\n 매핑이 막고 있다고 볼 통과율 문턱.\n \n 값과 함께 내보낸다 — 화면이 「95% 미만이라 매핑 문제로 봤다」를 말할 수 있게. 숨긴 문턱은 사람이\n * 판정을 믿지 못한다.\n /\nexport const HEALTHY_ACCEPTED_RATIO = 0.95\n\nexport function newIngestLedger(): IngestLedger {\n return {\n window: { startMs: -1, endMs: -1, offered: 0, rejected: 0, undelivered: 0, rows: 0, flushes: 0 },\n trend: [],\n trendDropped: 0,\n offered: 0,\n rejected: 0,\n undelivered: 0,\n rows: 0,\n flushes: 0,\n lastWriteAtMs: -1,\n lastUndeliveredAtMs: -1,\n byReason: {},\n reasonsCapped: false,\n sampledReasons: new Set<string>(),\n samples: [],\n sampleDropped: 0,\n lastAtMs: -1\n }\n}\n\n/\n 창이 다 찼으면 닫아 추이에 넣고 새로 연다. 닫힌 창만 「최근」으로 읽는다.\n \n ── 영속이 붙는 유일한 자리 ────────────────────────────────────────────────\n * 닫힌 창 하나가 영속의 단위다(숫자 넷 + 구간). `onClosed` 를 받는 이유는 *이 함수가 창이 닫히는\n 유일한 지점*이기 때문이다 — 여기 한 곳에 붙이면 기록 경로가 갈리지 않는다.\n \n * 왜 건마다가 아니라 창마다인가: 거부마다 행을 쓰면 초당 1만 행이고 그 부하가 이벤트 루프로 돌아온다.\n * 창마다면 트윈 1,000개에 하루 14.4만 행(약 14MB)이다.\n \n `onClosed` 는 오류를 내지 않아야 한다(호출부가 감싼다) — 영속이 실패해도 장부는 계속 굴러야 한다.\n * 영속을 지키는 것과 관측을 지키는 것은 다른 일이고, 뒤엣것이 앞엣것 때문에 멈추면 안 된다.\n /\nexport function rollIngestWindow(\n ledger: IngestLedger,\n nowMs: number,\n windowMs = INGEST_WINDOW_MS,\n onClosed?: (closed: IngestWindow) => void\n): void {\n if (ledger.window.startMs < 0) {\n ledger.window.startMs = nowMs\n return\n }\n if (nowMs - ledger.window.startMs < windowMs) return\n\n const closed: IngestWindow = { ...ledger.window, endMs: nowMs }\n ledger.trend.push(closed)\n ledger.window = { startMs: nowMs, endMs: -1, offered: 0, rejected: 0, undelivered: 0, rows: 0, flushes: 0 }\n\n if (ledger.trend.length > TREND_LIMIT) {\n const drop = ledger.trend.length - TREND_LIMIT\n ledger.trend.splice(0, drop)\n ledger.trendDropped += drop\n }\n\n / 영속은 관측을 막지 않는다 — 터져도 장부는 이미 갱신됐다. /\n if (onClosed) {\n try {\n onClosed(closed)\n } catch {\n / 호출부가 알린다. 여기서 삼키는 것은 장부의 진행을 지키기 위해서다. /\n }\n }\n}\n\n/* 사유 묶음의 키. 사유가 여럿이면 한 줄로 잇고, 없으면 지어내지 않고 `unknown`. /\nexport function reasonKey(errors: string[] \| undefined): string {\n const list = (errors ?? []).map(e => String(e).trim()).filter(Boolean)\n return list.length ? list.join(' · ') : 'unknown'\n}\n\nfunction safeJson(v: unknown): string {\n try {\n const s = JSON.stringify(v)\n return s === undefined ? String(v) : s\n } catch {\n return '(serialization failed)' / 순환 참조 등 — 모양을 못 보여 주는 것도 사실이다 /\n }\n}\n\n/\n 한 번의 인제스트 결과를 적는다.\n \n `offered` 를 함께 받는 이유: 통과율을 서로 다른 두 계수기에서 나눠 계산하면 분모와 분자가 다른\n * 것을 세게 된다. 둘을 한자리에서 본 수를 그대로 적는다.\n /\nexport function recordIngest(\n ledger: IngestLedger,\n offered: number,\n rejected: { record?: unknown; errors?: string[] }[] \| undefined,\n nowMs: number,\n onClosed?: (closed: IngestWindow) => void,\n /* 매핑은 통과했지만 트윈에 닿지 못한 수 — 「통과」로 세면 화면이 거짓을 말한다. /\n undelivered = 0\n): void {\n if (!Number.isFinite(offered) \|\| offered < 0) return\n\n rollIngestWindow(ledger, nowMs, INGEST_WINDOW_MS, onClosed)\n\n ledger.offered += offered\n ledger.window.offered += offered\n ledger.lastAtMs = nowMs\n\n if (Number.isFinite(undelivered) && undelivered > 0) {\n ledger.undelivered += undelivered\n ledger.window.undelivered += undelivered\n ledger.lastUndeliveredAtMs = nowMs\n }\n\n const items = rejected ?? []\n if (!items.length) return\n\n ledger.rejected += items.length\n ledger.window.rejected += items.length\n\n for (const it of items) {\n const raw = reasonKey(it?.errors)\n const known = raw in ledger.byReason\n\n / 사유 종류 상한 — 넘치면 한 칸으로 접고, 닿았다는 사실을 표시한다. /\n let key = raw\n if (!known && Object.keys(ledger.byReason).length >= REASON_LIMIT) {\n key = OTHER_REASON\n ledger.reasonsCapped = true\n }\n\n const seen = ledger.byReason[key]\n ledger.byReason[key] = { count: (seen?.count ?? 0) + 1, lastAtMs: nowMs }\n\n /\n * 표본은 사유마다 하나. 이미 그 사유의 표본이 있으면 직렬화를 아예 하지 않는다 — 초당 1만 건이\n * 전부 거부될 때 만들자마자 버려지는 문자열을 만들지 않기 위해서다(실측: 건당 0.24µs, GC 압박).\n /\n if (ledger.sampledReasons.has(key)) {\n ledger.sampleDropped += 1\n continue\n }\n\n const text = safeJson(it?.record)\n const truncated = text.length > RECORD_MAX\n ledger.samples.push({\n atMs: nowMs,\n errors: key === OTHER_REASON ? [OTHER_REASON] : it?.errors?.length ? [...it.errors] : ['unknown'],\n record: truncated ? text.slice(0, RECORD_MAX) : text,\n ...(truncated ? { recordTruncated: true } : {})\n })\n\n ledger.sampledReasons.add(key)\n\n if (ledger.samples.length > SAMPLE_LIMIT) {\n const gone = ledger.samples.splice(0, ledger.samples.length - SAMPLE_LIMIT)\n / 밀려난 표본의 사유는 색인에서도 빼야 다음에 다시 뜰 수 있다(안 빼면 그 사유는 영원히 표본 없음). /\n for (const g of gone) ledger.sampledReasons.delete(reasonKey(g.errors))\n ledger.sampleDropped += gone.length\n }\n }\n}\n\n/\n 저널에 적은 것을 기록한다 — 창을 넘길 때가 되었으면 넘기고, 행·왕복을 더한다.\n \n ── 왜 유입과 같은 창인가 ───────────────────────────────────────────────────\n * 새 장부를 만들지 않는다. 이 창은 「닫힌 창만 최근」·「0 과 없음을 가른다」·「잘린 것을 세어 드러낸다」를\n * 이미 지키고, 닫힐 때 영속까지 된다. 같은 규율을 두 벌 만들면 한쪽만 고쳐진다.\n \n ── 유입이 없어도 창은 넘어간다 ────────────────────────────────────────────\n * 시뮬 트윈은 받는 것 없이 자기가 낸 사실을 적는다. 창이 유입에서만 넘어간다면 그 트윈은 추이에\n * 영원히 나타나지 않는다 — 그래서 쓰기도 창을 넘긴다.\n /\nexport function recordJournalWrite(\n ledger: IngestLedger,\n rows: number,\n nowMs: number,\n onClosed?: (closed: IngestWindow) => void\n): void {\n if (!Number.isFinite(rows) \|\| rows <= 0) return\n rollIngestWindow(ledger, nowMs, INGEST_WINDOW_MS, onClosed)\n ledger.rows += rows\n ledger.flushes += 1\n ledger.window.rows += rows\n ledger.window.flushes += 1\n /\n * `lastAtMs` 는 건드리지 않는다. 그 값은 「마지막 유입」이고, 끊긴 피드를 가려내는 근거다. 쓰기로\n * 갱신하면 라이브 트윈은 유입이 끊겨도 틱이 만든 델타를 계속 적으므로 영원히 「방금 받았다」가 되고,\n * 「오래 끊긴 피드에 옛 창으로 초록을 내지 않는다」가 조용히 무력해진다. 축을 따로 든다.\n /\n ledger.lastWriteAtMs = nowMs\n}\n\n/\n 한눈 판정.\n \n `not-applicable` 과 `not-connected` 를 섞지 않고, 재지 않은 것을 정상·비정상으로 채우지 않는다\n * (`unknown`). 시뮬 트윈에 「동기화 안 됨」이라 말하면 거짓 경보이고, 거짓 경보는 참 경보를 죽인다.\n /\nexport type SyncVerdict =\n \| 'syncing' /* 유입이 있고 통과율이 문턱 이상 /\n \| 'mapping-blocked' /* 유입은 있는데 거부가 문턱을 넘는다 — 사유를 보고 매핑을 고친다 /\n /\n 들어오는데 커널이 받지 않는다 — 사실이 사라지고 있다.\n \n ── 이름이 사실보다 좁다 (2026-08-20에 드러났다) ────────────────────────────\n * 관측한 것은 「커널이 받지 않았다」(`ingestLive` 가 0)이고, 멈춘 것은 그 원인 중 하나일 뿐이다.\n * 다른 원인이 실제로 있었다: 미러로 선언된 트윈을 사람이 화면에서 시작하면 시뮬 구동으로 떴고, 그\n * 트윈은 돌고 있으면서 유입을 한 건도 받지 못했다. 그때 화면은 한쪽에 「running」, 다른 쪽에\n * 「멈춰」라고 적었고 사람은 「시작 버튼을 누르면 되겠네」라는 엉뚱한 처방으로 갔다.\n \n 그래서 화면 문구는 관측 그대로 적는다(「트윈에 닿지 않고 버려지는 중」). 이 키 이름은 서버·화면·\n * 시험에 걸친 계약 문자열이라 그대로 두지만, 이름을 원인으로 읽지 않는다.\n /\n \| 'twin-not-running'\n \| 'no-traffic' /* 피드는 붙었는데 제시가 0 — 원천·망을 본다 /\n \| 'not-connected' /* 피드 자체가 없다 — 결선한다 /\n \| 'not-applicable' /* 원본이 먹이지 않는 트윈(시뮬)·멈춘 트윈 — 물을 대상이 아니다 /\n \| 'unknown' /* 한 번도 받지 않았거나 창이 아직 닫히지 않았다 — 기다린다 /\n\nexport function syncVerdictOf(args: {\n /* `live-feed-registry.liveFeedStateOf` 의 답을 그대로 받는다 — 판정 어휘를 두 벌 만들지 않는다. /\n feedState: 'attached' \| 'detached' \| 'not-applicable'\n /* 마지막으로 닫힌 창. 없으면 `null`. /\n recent: { offered: number; rejected: number } \| null\n /* 마지막으로 무엇이든 받은 시각. 한 번도 없으면 `-1` — 0 이 아니다(0 은 1970년이다). /\n lastAtMs?: number\n /* 지금. `lastAtMs` 를 견줄 때만 쓴다. /\n nowMs?: number\n /* 마지막으로 버려진 시각. 한 번도 없으면 `-1`. /\n lastUndeliveredAtMs?: number\n threshold?: number\n}): SyncVerdict {\n /\n * ── 버려지고 있는 것이 가장 먼저다 ────────────────────────────────────────\n * 트윈이 멈추면 피드는 남아 계속 레코드를 나르고, 커널은 그것을 조용히 버린다. 그 상태를 「해당 없음」\n * 이라 부르면 사실이 사라지는 동안 화면이 안심시킨다 — 실제로 그렇게 떴다(멈춘 트윈 옆에 「150\n * 통과 · 100%」). 그래서 시뮬·멈춤 판정보다 먼저 본다.\n \n 시뮬 트윈에는 이 값이 서지 않는다(먹이는 피드가 없으므로 미전달도 없다). 그래서 이 순서가 시뮬에\n * 거짓 경보를 주지 않는다.\n /\n if (\n typeof args.lastUndeliveredAtMs === 'number' &&\n args.lastUndeliveredAtMs >= 0 &&\n typeof args.nowMs === 'number' &&\n args.nowMs - args.lastUndeliveredAtMs <= STALE_AFTER_MS\n ) {\n return 'twin-not-running'\n }\n\n if (args.feedState === 'not-applicable') return 'not-applicable'\n if (args.feedState === 'detached') return 'not-connected'\n\n /\n * ── 끊긴 피드가 초록으로 남지 않게 ────────────────────────────────────────\n * 창은 다음 유입이 있을 때 닫힌다. 그래서 유입이 멈추면 창도 멈추고, 「최근 창」은 멈추기 직전의\n * 건강했던 창으로 남는다. 그 창만 보고 판정하면 어제 죽은 피드가 오늘도 「동기화 중」이다. 이\n * 기능이 있는 이유가 바로 그 상태를 드러내는 것이므로, 그때 초록을 내면 목적을 놓친다.\n \n 그래서 창과 별개로 지금까지의 침묵을 먼저 본다. 한 창을 통째로 아무것도 받지 않았으면 그것은\n * 「유입 없음」이다 — 실제로 그 구간의 창은 비어 있게 된다.\n \n 이 판단을 서버에 두는 이유: 소비처가 여럿(목록·연결 상세·앞으로 생길 것)이고, 화면마다 다시\n * 판단하면 규칙이 갈라져 어떤 화면은 초록, 어떤 화면은 경고를 말한다.\n \n 한계 — 한 창(10분)보다 느리게 긷는 원천은 긷는 사이에 「유입 없음」으로 보인다. 장부는 원천의\n * 주기를 모르므로 이보다 정확히 답할 수 없다. 주기를 알게 되면 그 값으로 견주는 것이 맞다.\n /\n if (typeof args.lastAtMs === 'number' && typeof args.nowMs === 'number') {\n if (args.lastAtMs < 0) return 'unknown' / 붙었지만 한 번도 받지 않았다 — 기다린다 /\n if (args.nowMs - args.lastAtMs > STALE_AFTER_MS) return 'no-traffic'\n }\n\n if (!args.recent) return 'unknown'\n if (args.recent.offered <= 0) return 'no-traffic'\n\n const ratio = (args.recent.offered - args.recent.rejected) / args.recent.offered\n return ratio >= (args.threshold ?? HEALTHY_ACCEPTED_RATIO) ? 'syncing' : 'mapping-blocked'\n}\n\nexport interface IngestWindowView {\n from: string\n to: string\n offered: number\n /* 트윈에 닿은 수. 제시 − 거부 − 미전달. /\n accepted: number\n /* 매핑이 거부한 수 — 처방은 매핑을 고치는 것. /\n rejected: number\n /* 매핑은 통과했으나 트윈에 닿지 못한 수 — 처방은 트윈을 세우는 것. /\n undelivered: number\n /* 통과율(0~1). 제시가 없으면 `null` — 1 로 채우면 「전부 통과」로 읽힌다. /\n acceptedRatio: number \| null\n /* 이 창에 적힌 행. /\n rows: number\n /* 그것을 적기 위해 DB 를 두드린 횟수 — 행당 왕복이 줄었는지 보는 값. /\n flushes: number\n}\n\nexport interface IngestHealthView {\n verdict: SyncVerdict\n /* 판정에 쓴 문턱 — 화면이 왜 그 판정인지 말할 수 있게 함께 낸다. /\n threshold: number\n /* 마지막으로 닫힌 창. 창이 한 번도 닫히지 않았으면 `null`. /\n recent: IngestWindowView \| null\n /* 닫힌 창들, 오래된 것부터. /\n trend: IngestWindowView[]\n /* 추이 상한에서 밀려난 창 수. /\n trendDropped: number\n /* 누적(기동 이후). /\n total: {\n offered: number\n accepted: number\n rejected: number\n undelivered: number\n acceptedRatio: number \| null\n /* 저널에 적힌 행과 그것을 위해 DB 를 두드린 횟수 — 기동 이후 누적. /\n rows: number\n flushes: number\n }\n /* 사유별 누적, 많은 것부터. `lastAt` 이 멈춘 사유는 이미 고쳐진 것이다. /\n reasons: { reason: string; count: number; lastAt: string }[]\n /* 사유 종류가 상한에 닿아 일부가 `(other reasons)` 로 접혔나. /\n reasonsCapped: boolean\n samples: RejectSample[]\n sampleDropped: number\n /* 마지막으로 무엇이든 받은 시각. 한 번도 없으면 `null`. /\n lastAt: string \| null\n /* 마지막으로 저널에 적은 시각. 한 번도 없으면 `null` — 받은 적 없는 트윈도 이 값은 있을 수 있다. /\n lastWriteAt: string \| null\n /\n 원본에 닿지 못하고 있다 — 없으면 닿고 있다는 뜻이다(§`IngestLedger.readFailure`).\n \n 「유입 없음」과 다른 판정이다: 유입 없음은 원본이 조용한 것일 수 있고, 이것은 우리가 묻지도\n * 못한 것이다. 화면은 두 문장을 다르게 말해야 한다 — 실 원본이 끊겼을 때 사용자가 원인을 찾을 수\n * 있는지가 그 차이다.\n /\n readFailure?: {\n consecutive: number\n /* 이 단절이 시작된 시각 — 「20분째」를 말할 수 있게. /\n since: string\n lastAt: string\n reason: string\n stream?: string\n }\n}\n\nfunction toWindowView(w: IngestWindow, fallbackEndMs: number): IngestWindowView {\n / 「통과」는 트윈에 닿은 것만이다. 버려진 것을 통과로 세면 화면이 안심시킨다. /\n const accepted = w.offered - w.rejected - w.undelivered\n return {\n from: new Date(w.startMs).toISOString(),\n to: new Date(w.endMs >= 0 ? w.endMs : fallbackEndMs).toISOString(),\n offered: w.offered,\n accepted,\n rejected: w.rejected,\n undelivered: w.undelivered,\n acceptedRatio: w.offered > 0 ? round4(accepted / w.offered) : null,\n rows: w.rows,\n flushes: w.flushes\n }\n}\n\n/\n 읽기용 요약.\n \n 장부가 없어도(한 번도 받지 않은 트윈) 판정은 낸다 — 피드 사실만으로 답할 수 있는 경우가 있다\n * (`not-applicable`·`not-connected`). 그 경우 수치는 비운다: 없는 값을 0 으로 채우지 않는다.\n \n `nowMs` 를 받는 이유: 끊긴 피드를 가려내려면 「마지막 유입이 얼마나 전인가」를 봐야 하고, 그 판단을\n * 화면이 아니라 여기서 한다(소비처마다 다시 판단하면 규칙이 갈라진다). 시험이 시각을 고정할 수 있도록\n * 인자로 받는다.\n /\nexport function ingestHealth(\n ledger: IngestLedger \| undefined,\n feedState: 'attached' \| 'detached' \| 'not-applicable',\n threshold = HEALTHY_ACCEPTED_RATIO,\n nowMs: number = Date.now()\n): IngestHealthView {\n const recentRaw = ledger?.trend.length ? ledger.trend[ledger.trend.length - 1] : null\n / 열린 창의 끝 시각 대체값 — 유입이 없는 장부에서 `-1` 을 시각으로 읽으면 1969년이 화면에 뜬다. /\n const lastAnyMs = Math.max(ledger?.lastAtMs ?? -1, ledger?.lastWriteAtMs ?? -1)\n const verdict = syncVerdictOf({\n feedState,\n recent: recentRaw,\n lastAtMs: ledger?.lastAtMs ?? -1,\n lastUndeliveredAtMs: ledger?.lastUndeliveredAtMs ?? -1,\n nowMs,\n threshold\n })\n\n /\n * 유입이 없어도 「빈 장부」가 아니다. 시뮬 트윈은 받는 것 없이 적는다. 유입 시각만 보고 비었다고\n * 판단하면 그 트윈의 창은 만들어져 있는데 화면에는 아무 추이도 나오지 않는다(이 축을 넣은 이유가 그것이다).\n /\n if (!ledger \|\| (ledger.lastAtMs < 0 && ledger.lastWriteAtMs < 0)) {\n return {\n verdict,\n threshold,\n recent: null,\n trend: [],\n trendDropped: 0,\n total: { offered: 0, accepted: 0, rejected: 0, undelivered: 0, acceptedRatio: null, rows: 0, flushes: 0 },\n reasons: [],\n reasonsCapped: false,\n samples: [],\n sampleDropped: 0,\n lastAt: null,\n lastWriteAt: null,\n /\n * 이 짧은 답에도 단절은 실어야 한다 — 이 자리가 바로 그 트윈의 모습이다.\n \n 받은 것도 적은 것도 없는 장부는 「아직 아무 일도 없다」로 읽히는데, 원본에 닿지 못하는 트윈이\n * 정확히 그 모습이다(읽지 못하면 받은 것도 적은 것도 없다). 여기서 떨어뜨리면 *가장 필요한\n 순간에** 그 사실이 사라진다 — 실측으로 원본이 끊긴 트윈이 이 경로로 답하고 있었다.\n /\n ...(ledger?.readFailure\n ? {\n readFailure: {\n consecutive: ledger.readFailure.consecutive,\n since: new Date(ledger.readFailure.sinceMs).toISOString(),\n lastAt: new Date(ledger.readFailure.lastAtMs).toISOString(),\n reason: ledger.readFailure.reason,\n ...(ledger.readFailure.stream ? { stream: ledger.readFailure.stream } : {})\n }\n }\n : {})\n }\n }\n\n / 「통과」는 트윈에 닿은 것만이다 — 창 뷰와 같은 규칙. /\n const accepted = ledger.offered - ledger.rejected - ledger.undelivered\n return {\n verdict,\n threshold,\n recent: recentRaw ? toWindowView(recentRaw, lastAnyMs) : null,\n trend: ledger.trend.map(w => toWindowView(w, lastAnyMs)),\n trendDropped: ledger.trendDropped,\n total: {\n offered: ledger.offered,\n accepted,\n rejected: ledger.rejected,\n undelivered: ledger.undelivered,\n acceptedRatio: ledger.offered > 0 ? round4(accepted / ledger.offered) : null,\n rows: ledger.rows,\n flushes: ledger.flushes\n },\n reasons: Object.entries(ledger.byReason)\n .map(([reason, v]) => ({ reason, count: v.count, lastAt: new Date(v.lastAtMs).toISOString() }))\n .sort((a, b) => b.count - a.count \|\| a.reason.localeCompare(b.reason)),\n reasonsCapped: ledger.reasonsCapped,\n samples: [...ledger.samples],\n sampleDropped: ledger.sampleDropped,\n / 「받은 적 없음」과 「방금 받음」을 가른다 — 적기만 하는 트윈의 유입 시각은 없다. /\n lastAt: ledger.lastAtMs >= 0 ? new Date(ledger.lastAtMs).toISOString() : null,\n lastWriteAt: ledger.lastWriteAtMs >= 0 ? new Date(ledger.lastWriteAtMs).toISOString() : null,\n / 닿지 못하고 있으면 그 사실을 낸다 — 없으면 필드를 만들지 않는다(빈 값이 「닿는다」로 읽히지 않게). /\n ...(ledger.readFailure\n ? {\n readFailure: {\n consecutive: ledger.readFailure.consecutive,\n since: new Date(ledger.readFailure.sinceMs).toISOString(),\n lastAt: new Date(ledger.readFailure.lastAtMs).toISOString(),\n reason: ledger.readFailure.reason,\n ...(ledger.readFailure.stream ? { stream: ledger.readFailure.stream } : {})\n }\n }\n : {})\n }\n}\n\n/* 비율은 자릿수를 넉넉히 준다 — 0.999 가 1 로 반올림되면 「전부 통과」로 읽힌다. /\nconst round4 = (v: number) => Math.round(v 10000) / 10000\n"]}
1	+ {"version":3,"file":"ingest-health.js","sourceRoot":"","sources":["../../server/engine/ingest-health.ts"],"names":[],"mappings":"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","sourcesContent":["/\n 동기화 건강 — 이 트윈이 현장과 맞춰지고 있나. 순수(import 없음).\n \n ── 한 질문 ─────────────────────────────────────────────────────────────────\n * 화면에서 값이 변하지 않을 때 원인이 넷인데, 지금까지 넷이 똑같이 보였다.\n * ① 피드가 붙지 않았다 ② 붙었는데 아무것도 오지 않는다\n * ③ 오는데 전부 거부된다 ④ 정상인데 현장이 조용하다\n * ③은 특히 나쁘다 — 커넥터의 매핑이 한 글자 틀리면 트윈은 「빈 공장」이 되고, 그 사실이 서버 로그\n * 한 줄에만 남았다. 현장에 나간 사람은 로그를 뒤져야 했다.\n \n ── 왜 저널로는 답할 수 없나 ────────────────────────────────────────────────\n * 거부된 것은 저널에 없다 — 거부의 뜻이 그것이다. 저널을 접으면 통과한 쪽만 나온다. 거부의 추이는\n * 세는 자리를 따로 두어야 나온다. 이 장부가 그 자리다.\n \n ── 왜 건마다 저장하지 않나 ─────────────────────────────────────────────────\n * 라이브 계측은 초당 여러 건이다. 거부마다 행을 쓰면 그 자체가 부하가 된다(`reference-live.ts` 가\n * 이미 그렇게 적어 두었다). 그리고 이 패키지는 `integration-base` 를 알지 않는다(이식성 규약) —\n * 시나리오 경로가 쓰는 dead-letter 를 여기서 부를 수 없다. 그래서 집계한다.\n \n ── 통과와 거부를 함께 센다 ─────────────────────────────────────────────────\n * 거부만 그리면 「유입 없음」과 「정상」이 둘 다 거부 0 으로 같아 보인다. 제시 수가 있어야 갈린다.\n \n ── 지키는 규율 넷 ──────────────────────────────────────────────────────────\n * ① 닫힌 창만 「최근」이다 — 채우는 중인 창은 과소 집계다(부하 계기판에서 겪었다).\n * ② 0 과 「없음」을 가른다 — 안 받은 것은 `null`, 받았지만 거부 0 은 `0`.\n * ③ 조용히 자르지 않는다 — 표본·추이 상한에서 밀려난 수를 함께 낸다.\n * ④ 통과율에 1 을 함부로 쓰지 않는다 — 1,000건 중 1건 거부는 0.999 다.\n /\n\n/* 추이 창 하나 — 제시·통과·거부·미전달, 그리고 적힌 것을 함께 든다. /\nexport interface IngestWindow {\n /* 창이 열린 시각(ms). /\n startMs: number\n /* 창이 닫힌 시각(ms). 아직 채우는 중이면 `-1`. /\n endMs: number\n /* 이 창에 제시된 레코드 수(거부 여부 무관). /\n offered: number\n /* 그중 매핑이 거부한 수 — 처방은 매핑을 고치는 것이다. /\n rejected: number\n /\n 매핑은 통과했지만 트윈에 닿지 못한 수 — 처방은 트윈을 세우는 것이다.\n \n ── 왜 거부와 따로 세나 (2026-08-20에 겪었다) ─────────────────────────────\n * 트윈이 라이브로 돌지 않으면 커널이 레코드를 조용히 버린다. 그런데 장부는 그것을 「통과」로 셌다.\n * 화면이 「150 들어옴 · 150 통과 · 100%」라고 말하는 동안 150건은 바닥에 버려지고 있었다. 이 기능이\n * 막으려던 바로 그것을 이 기능이 저지른 셈이다.\n \n 거부에 합치는 것도 답이 아니다 — 거부는 「매핑을 고쳐라」는 말이고, 여기서 필요한 말은 「트윈이 안\n * 돌고 있다」다. 처방이 다르면 다른 수로 센다.\n /\n undelivered: number\n /\n 이 창에 저널에 적힌 행 수 — 「무엇이 남았나」.\n \n 유입과 다른 축이다: 시뮬 트윈은 받는 것 없이 자기가 낸 사실을 적는다(그래서 `offered` 는 0 이고\n * `rows` 는 0 이 아니다). 이 칸이 없으면 그 트윈의 활동은 어느 추이에도 나타나지 않는다.\n /\n rows: number\n /\n 그것을 적기 위해 DB 를 두드린 횟수(flush) — 「우리가 몇 번 갔나」.\n \n 행 수와 따로 세는 이유: 2026-08-20 에 고친 것이 바로 이 값이다(행마다 한 번 → 창당 한 번). 행만\n * 세면 그 개선도, 되돌아가는 것도 보이지 않는다.\n /\n flushes: number\n}\n\n/* 거부 표본 하나 — 매핑을 고치려면 실제 모양을 봐야 한다. /\nexport interface RejectSample {\n atMs: number\n /* 커널이 낸 사유. 우리가 다시 쓰지 않고 그대로 옮긴다. /\n errors: string[]\n /* 막힌 레코드의 직렬화. 길면 자르고, 잘랐다고 표시한다. /\n record: string\n recordTruncated?: boolean\n}\n\nexport interface IngestLedger {\n /* 지금 채우는 중인 창. `startMs < 0` 이면 아직 아무것도 받지 않았다. /\n window: IngestWindow\n /* 닫힌 창들 — 오래된 것이 앞. 상한을 넘으면 앞에서 밀려난다. /\n trend: IngestWindow[]\n /* 추이에서 밀려난 창 수. /\n trendDropped: number\n /* 누적 제시·거부·미전달. /\n offered: number\n rejected: number\n undelivered: number\n /* 누적 — 적힌 행과 두드린 횟수. /\n rows: number\n flushes: number\n /\n 마지막으로 적은 시각. 한 번도 없으면 `-1`.\n \n 유입 시각(`lastAtMs`)과 갈라 두는 이유는 위 `recordJournalWrite` 주석에 있다 — 섞으면 끊긴 피드가\n * 초록으로 보인다.\n /\n lastWriteAtMs: number\n /\n 마지막으로 버려진 시각(ms). 한 번도 없으면 `-1`.\n \n 창과 따로 둔다: 미전달은 창이 닫히기 전에 알아야 한다(그 사이에도 사실은 계속 사라지고 있다).\n /\n lastUndeliveredAtMs: number\n /* 사유별 누적 건수와 마지막으로 그 사유가 난 시각 — 고친 사유는 시각이 멈춘다. /\n byReason: Record<string, { count: number; lastAtMs: number }>\n /\n 사유 종류가 상한에 닿았나.\n \n 접힌 종류 수는 세지 않는다 — 그것을 세려면 이미 본 사유를 모두 기억해야 하고, 그 집합이\n * 바로 이 상한으로 막으려던 무한한 집합이다. 접힌 건수는 `byReason[OTHER_REASON].count` 가 답한다.\n /\n reasonsCapped: boolean\n /* 표본을 이미 뜬 사유들 — 같은 사유를 다시 직렬화하지 않기 위한 색인(O(1) 조회). /\n sampledReasons: Set<string>\n /* 최근 거부 표본. /\n samples: RejectSample[]\n /* 표본에서 밀려난 거부 건수. /\n sampleDropped: number\n /* 마지막으로 무엇이든 받은 시각(ms). 한 번도 없으면 `-1` — 0 으로 두면 시각 0 과 구별되지 않는다. /\n lastAtMs: number\n /\n 원본에 닿지 못한 사실 (2026-08-23) — 「받은 것이 없다」와 다른 사실이다.\n \n ── 무엇이 조용했나 ─────────────────────────────────────────────────────────\n * 실 원본이 끊겼을 때(접속 시간 초과) 트윈의 조회 가능한 상태 어디에도 그 사실이 없었다.\n * `recordIngest` 는 `onRecords` 가 불릴 때만 도달하고, 읽기가 실패하면 그 문에 오지 않는다.\n * `TwinReference.lastError` 는 마스터 동기·접속 시험에만 적힌다.\n \n 그래서 화면이 볼 수 있는 것은 「새 사실이 없다」뿐이었고, 그것은 *「원본이 조용하다」와 구별되지\n 않는다.** 실증 데모 중에 원본이 끊기면 사용자가 원인을 찾을 수 없다.\n \n ── 왜 「몇 번」과 「언제부터」를 함께 두나 ──────────────────────────────────\n * 한 번 실패한 것과 20분째 못 읽는 것은 다른 사실이다. 그 구별이 없으면 화면이 순간의 실패에 놀라거나\n * 계속된 단절을 대수롭지 않게 말한다. 그래서 연속 실패 수와 처음 실패한 시각을 함께 든다.\n \n 성공하면 지운다 — 고쳐진 단절이 화면에 남아 있으면 그것도 거짓이다.\n /\n readFailure?: {\n /* 연속 실패 수 — 성공 한 번에 0 으로 돌아간다. /\n consecutive: number\n /* 이 단절이 처음 시작된 시각(ms). 연속이 끊기면 다시 정해진다. /\n sinceMs: number\n /* 마지막 실패 시각(ms). /\n lastAtMs: number\n /* 마지막 실패의 사유 — 사람이 읽는 한 줄(원본이 준 말 그대로). /\n reason: string\n /* 어느 흐름에서 났나(어댑터가 말해 주면). 원본마다 흐름이 다르므로 열려 있다. /\n stream?: string\n }\n /\n 읽었는데 창을 넘길 수 없다 (2026-08-24) — 위와 다른 사실이다.\n \n ── 왜 갈랐나 ───────────────────────────────────────────────────────────────\n * 이 칸을 만들기 전에는 두 사실이 같은 이름으로 나갔다.\n \n readFailure 원본에 닿지 못했다 → 기다리면 풀린다\n * cursorStall 읽었는데 커서가 못 넘어간다 → 기다려도 안 풀린다\n \n 둘째는 읽기가 성공한 실패다: 한 시각에 한 페이지보다 많은 행이 몰려 커서를 그 시각 밖으로 옮길 수\n * 없다. 화면이 「원본에 닿지 못한다」고 말하면 사람은 원본을 의심하고 기다리는데, 필요한 조치는\n * 페이지를 키우거나 같은 시각 안에서 순서를 정하는 것이다. *조치가 반대인 두 사실을 한 이름으로\n 부르면 그 이름은 정보가 아니라 오해다.*\n \n * 모양은 위와 같게 둔다 — 「몇 번」과 「언제부터」가 여기서도 같은 값을 한다(한 번의 밀림과 사흘째\n * 못 넘어가는 것은 다르다). 넘어가면 지운다.\n /\n cursorStall?: {\n /* 연속 정체 수 — 넘어가면 0 으로 돌아간다. /\n consecutive: number\n /* 이 정체가 처음 시작된 시각(ms). /\n sinceMs: number\n /* 마지막 정체 시각(ms). /\n lastAtMs: number\n /* 사유 — 사람이 읽는 한 줄(어느 시각에서 막혔나까지 어댑터가 말해 주면 좋다). /\n reason: string\n /* 어느 흐름인가. 밀도가 높은 표는 원본마다 다르므로 이 이름이 조치의 절반이다. /\n stream?: string\n }\n}\n\n/\n 읽기 실패를 장부에 적는다 — 받은 것이 없는 것과 가른다.\n \n 연속 실패의 시작 시각을 지키는 것이 이 함수의 요점이다: 매번 새로 적으면 「20분째 못 읽는다」를\n * 말할 수 없고, 화면은 늘 「방금 실패했다」만 보게 된다.\n /\nexport function recordReadFailure(\n ledger: IngestLedger,\n reason: string,\n nowMs: number,\n stream?: string\n): void {\n const prev = ledger.readFailure\n ledger.readFailure = {\n consecutive: (prev?.consecutive ?? 0) + 1,\n sinceMs: prev?.sinceMs ?? nowMs,\n lastAtMs: nowMs,\n reason,\n ...(stream ? { stream } : {})\n }\n}\n\n/\n 읽기가 성공했다 — 단절 기록을 지운다.\n \n 빈 읽기도 성공이다: 원본이 「새 것이 없다」고 답한 것은 닿았다는 뜻이다. 그 둘을 같게 두면\n * 조용한 원본이 끊긴 원본으로 보인다(고치려던 것의 반대 방향으로 틀린다).\n /\nexport function clearReadFailure(ledger: IngestLedger): void {\n if (ledger.readFailure) delete ledger.readFailure\n}\n\n/\n 커서 정체를 장부에 적는다 — 닿지 못한 것과 가른다.\n \n `recordReadFailure` 와 같은 모양이지만 다른 칸이다. 한 주기가 두 이유로 실패할 수는 없으므로\n * (먼저 닿아야 읽는다) 둘이 동시에 서지 않는다 — 그래서 화면은 둘 중 하나만 보게 되고, 그 하나가\n * 조치를 정한다.\n /\nexport function recordCursorStall(ledger: IngestLedger, reason: string, nowMs: number, stream?: string): void {\n const prev = ledger.cursorStall\n ledger.cursorStall = {\n consecutive: (prev?.consecutive ?? 0) + 1,\n sinceMs: prev?.sinceMs ?? nowMs,\n lastAtMs: nowMs,\n reason,\n ...(stream ? { stream } : {})\n }\n}\n\n/* 창을 넘겼으면 지운다 — 풀린 정체가 화면에 남아 있으면 그것도 거짓이다. /\nexport function clearCursorStall(ledger: IngestLedger): void {\n if (ledger.cursorStall) delete ledger.cursorStall\n}\n\n/* 창 길이 — 10분. 부하 계기판(10초)과 다른 값이라 이름을 따로 둔다(같은 이름이면 섞인다). /\nexport const INGEST_WINDOW_MS = 600_000\n\n/\n 이만큼 아무것도 오지 않으면 「유입 없음」이라 말한다.\n \n 창 하나와 같게 둔다 — 한 창을 통째로 비운 것은 실제로 「그 구간에 아무것도 오지 않았다」이고, 추이의\n * 그 자리도 비게 된다. 그림과 알약이 같은 말을 하게 하려면 같은 길이여야 한다.\n /\nexport const STALE_AFTER_MS = INGEST_WINDOW_MS\n\n/* 추이 보관 창 수 — 36창 × 10분 = 6시간. 「고친 것이 먹혔나」를 보기에 충분하고 메모리는 숫자 넷×36 이다. /\nexport const TREND_LIMIT = 36\n\n/\n 사유 종류 상한.\n \n 없으면 메모리가 끝없이 자란다. 사유 문구에 레코드마다 다른 값이 섞이는 커넥터가 하나만 있어도\n * (`unknown bizStep \"PUTAWAY_X17\"`, `…X18`, …) 키가 무한히 늘어난다. 초당 1만 건 규모에서 이것은\n * 미미한 오버헤드가 아니라 누수다.\n \n 넘치면 `OTHER_REASON` 한 칸에 모으고 몇 종을 접었는지 함께 낸다(조용히 자르지 않는다).\n * 30종이면 고칠 곳을 찾기에 충분하다 — 목록을 훑는 일이 아니라 매핑 몇 줄을 고치는 일이다.\n /\nexport const REASON_LIMIT = 30\n\n/* 상한을 넘긴 사유들이 모이는 칸. /\nexport const OTHER_REASON = '(other reasons)'\n\n/\n 표본 상한 — 사유마다 한 건만 든다.\n \n 같은 사유 20건보다 서로 다른 사유 1건씩이 매핑을 고치는 데 유용하다. 그리고 이 규칙이 성능을\n * 지킨다: 그 사유의 표본이 이미 있으면 `JSON.stringify` 를 아예 하지 않는다. 실측(레코드 241바이트)\n * 으로 건당 0.24µs 인데, 초당 1만 건이 전부 거부되면 9,980건은 만들자마자 버려지는 문자열이었다 —\n * CPU 는 감당되지만 GC 압박이 이벤트 루프로 돌아온다.\n /\nexport const SAMPLE_LIMIT = REASON_LIMIT\n\n/* 표본 하나의 직렬화 상한(문자). /\nexport const RECORD_MAX = 2000\n\n/\n 매핑이 막고 있다고 볼 통과율 문턱.\n \n 값과 함께 내보낸다 — 화면이 「95% 미만이라 매핑 문제로 봤다」를 말할 수 있게. 숨긴 문턱은 사람이\n * 판정을 믿지 못한다.\n /\nexport const HEALTHY_ACCEPTED_RATIO = 0.95\n\nexport function newIngestLedger(): IngestLedger {\n return {\n window: { startMs: -1, endMs: -1, offered: 0, rejected: 0, undelivered: 0, rows: 0, flushes: 0 },\n trend: [],\n trendDropped: 0,\n offered: 0,\n rejected: 0,\n undelivered: 0,\n rows: 0,\n flushes: 0,\n lastWriteAtMs: -1,\n lastUndeliveredAtMs: -1,\n byReason: {},\n reasonsCapped: false,\n sampledReasons: new Set<string>(),\n samples: [],\n sampleDropped: 0,\n lastAtMs: -1\n }\n}\n\n/\n 창이 다 찼으면 닫아 추이에 넣고 새로 연다. 닫힌 창만 「최근」으로 읽는다.\n \n ── 영속이 붙는 유일한 자리 ────────────────────────────────────────────────\n * 닫힌 창 하나가 영속의 단위다(숫자 넷 + 구간). `onClosed` 를 받는 이유는 *이 함수가 창이 닫히는\n 유일한 지점*이기 때문이다 — 여기 한 곳에 붙이면 기록 경로가 갈리지 않는다.\n \n * 왜 건마다가 아니라 창마다인가: 거부마다 행을 쓰면 초당 1만 행이고 그 부하가 이벤트 루프로 돌아온다.\n * 창마다면 트윈 1,000개에 하루 14.4만 행(약 14MB)이다.\n \n `onClosed` 는 오류를 내지 않아야 한다(호출부가 감싼다) — 영속이 실패해도 장부는 계속 굴러야 한다.\n * 영속을 지키는 것과 관측을 지키는 것은 다른 일이고, 뒤엣것이 앞엣것 때문에 멈추면 안 된다.\n /\nexport function rollIngestWindow(\n ledger: IngestLedger,\n nowMs: number,\n windowMs = INGEST_WINDOW_MS,\n onClosed?: (closed: IngestWindow) => void\n): void {\n if (ledger.window.startMs < 0) {\n ledger.window.startMs = nowMs\n return\n }\n if (nowMs - ledger.window.startMs < windowMs) return\n\n const closed: IngestWindow = { ...ledger.window, endMs: nowMs }\n ledger.trend.push(closed)\n ledger.window = { startMs: nowMs, endMs: -1, offered: 0, rejected: 0, undelivered: 0, rows: 0, flushes: 0 }\n\n if (ledger.trend.length > TREND_LIMIT) {\n const drop = ledger.trend.length - TREND_LIMIT\n ledger.trend.splice(0, drop)\n ledger.trendDropped += drop\n }\n\n / 영속은 관측을 막지 않는다 — 터져도 장부는 이미 갱신됐다. /\n if (onClosed) {\n try {\n onClosed(closed)\n } catch {\n / 호출부가 알린다. 여기서 삼키는 것은 장부의 진행을 지키기 위해서다. /\n }\n }\n}\n\n/* 사유 묶음의 키. 사유가 여럿이면 한 줄로 잇고, 없으면 지어내지 않고 `unknown`. /\nexport function reasonKey(errors: string[] \| undefined): string {\n const list = (errors ?? []).map(e => String(e).trim()).filter(Boolean)\n return list.length ? list.join(' · ') : 'unknown'\n}\n\nfunction safeJson(v: unknown): string {\n try {\n const s = JSON.stringify(v)\n return s === undefined ? String(v) : s\n } catch {\n return '(serialization failed)' / 순환 참조 등 — 모양을 못 보여 주는 것도 사실이다 /\n }\n}\n\n/\n 한 번의 인제스트 결과를 적는다.\n \n `offered` 를 함께 받는 이유: 통과율을 서로 다른 두 계수기에서 나눠 계산하면 분모와 분자가 다른\n * 것을 세게 된다. 둘을 한자리에서 본 수를 그대로 적는다.\n /\nexport function recordIngest(\n ledger: IngestLedger,\n offered: number,\n rejected: { record?: unknown; errors?: string[] }[] \| undefined,\n nowMs: number,\n onClosed?: (closed: IngestWindow) => void,\n /* 매핑은 통과했지만 트윈에 닿지 못한 수 — 「통과」로 세면 화면이 거짓을 말한다. /\n undelivered = 0\n): void {\n if (!Number.isFinite(offered) \|\| offered < 0) return\n\n rollIngestWindow(ledger, nowMs, INGEST_WINDOW_MS, onClosed)\n\n ledger.offered += offered\n ledger.window.offered += offered\n ledger.lastAtMs = nowMs\n\n if (Number.isFinite(undelivered) && undelivered > 0) {\n ledger.undelivered += undelivered\n ledger.window.undelivered += undelivered\n ledger.lastUndeliveredAtMs = nowMs\n }\n\n const items = rejected ?? []\n if (!items.length) return\n\n ledger.rejected += items.length\n ledger.window.rejected += items.length\n\n for (const it of items) {\n const raw = reasonKey(it?.errors)\n const known = raw in ledger.byReason\n\n / 사유 종류 상한 — 넘치면 한 칸으로 접고, 닿았다는 사실을 표시한다. /\n let key = raw\n if (!known && Object.keys(ledger.byReason).length >= REASON_LIMIT) {\n key = OTHER_REASON\n ledger.reasonsCapped = true\n }\n\n const seen = ledger.byReason[key]\n ledger.byReason[key] = { count: (seen?.count ?? 0) + 1, lastAtMs: nowMs }\n\n /\n * 표본은 사유마다 하나. 이미 그 사유의 표본이 있으면 직렬화를 아예 하지 않는다 — 초당 1만 건이\n * 전부 거부될 때 만들자마자 버려지는 문자열을 만들지 않기 위해서다(실측: 건당 0.24µs, GC 압박).\n /\n if (ledger.sampledReasons.has(key)) {\n ledger.sampleDropped += 1\n continue\n }\n\n const text = safeJson(it?.record)\n const truncated = text.length > RECORD_MAX\n ledger.samples.push({\n atMs: nowMs,\n errors: key === OTHER_REASON ? [OTHER_REASON] : it?.errors?.length ? [...it.errors] : ['unknown'],\n record: truncated ? text.slice(0, RECORD_MAX) : text,\n ...(truncated ? { recordTruncated: true } : {})\n })\n\n ledger.sampledReasons.add(key)\n\n if (ledger.samples.length > SAMPLE_LIMIT) {\n const gone = ledger.samples.splice(0, ledger.samples.length - SAMPLE_LIMIT)\n / 밀려난 표본의 사유는 색인에서도 빼야 다음에 다시 뜰 수 있다(안 빼면 그 사유는 영원히 표본 없음). /\n for (const g of gone) ledger.sampledReasons.delete(reasonKey(g.errors))\n ledger.sampleDropped += gone.length\n }\n }\n}\n\n/\n 저널에 적은 것을 기록한다 — 창을 넘길 때가 되었으면 넘기고, 행·왕복을 더한다.\n \n ── 왜 유입과 같은 창인가 ───────────────────────────────────────────────────\n * 새 장부를 만들지 않는다. 이 창은 「닫힌 창만 최근」·「0 과 없음을 가른다」·「잘린 것을 세어 드러낸다」를\n * 이미 지키고, 닫힐 때 영속까지 된다. 같은 규율을 두 벌 만들면 한쪽만 고쳐진다.\n \n ── 유입이 없어도 창은 넘어간다 ────────────────────────────────────────────\n * 시뮬 트윈은 받는 것 없이 자기가 낸 사실을 적는다. 창이 유입에서만 넘어간다면 그 트윈은 추이에\n * 영원히 나타나지 않는다 — 그래서 쓰기도 창을 넘긴다.\n /\nexport function recordJournalWrite(\n ledger: IngestLedger,\n rows: number,\n nowMs: number,\n onClosed?: (closed: IngestWindow) => void\n): void {\n if (!Number.isFinite(rows) \|\| rows <= 0) return\n rollIngestWindow(ledger, nowMs, INGEST_WINDOW_MS, onClosed)\n ledger.rows += rows\n ledger.flushes += 1\n ledger.window.rows += rows\n ledger.window.flushes += 1\n /\n * `lastAtMs` 는 건드리지 않는다. 그 값은 「마지막 유입」이고, 끊긴 피드를 가려내는 근거다. 쓰기로\n * 갱신하면 라이브 트윈은 유입이 끊겨도 틱이 만든 델타를 계속 적으므로 영원히 「방금 받았다」가 되고,\n * 「오래 끊긴 피드에 옛 창으로 초록을 내지 않는다」가 조용히 무력해진다. 축을 따로 든다.\n /\n ledger.lastWriteAtMs = nowMs\n}\n\n/\n 한눈 판정.\n \n `not-applicable` 과 `not-connected` 를 섞지 않고, 재지 않은 것을 정상·비정상으로 채우지 않는다\n * (`unknown`). 시뮬 트윈에 「동기화 안 됨」이라 말하면 거짓 경보이고, 거짓 경보는 참 경보를 죽인다.\n /\nexport type SyncVerdict =\n \| 'syncing' /* 유입이 있고 통과율이 문턱 이상 /\n \| 'mapping-blocked' /* 유입은 있는데 거부가 문턱을 넘는다 — 사유를 보고 매핑을 고친다 /\n /\n 들어오는데 커널이 받지 않는다 — 사실이 사라지고 있다.\n \n ── 이름이 사실보다 좁다 (2026-08-20에 드러났다) ────────────────────────────\n * 관측한 것은 「커널이 받지 않았다」(`ingestLive` 가 0)이고, 멈춘 것은 그 원인 중 하나일 뿐이다.\n * 다른 원인이 실제로 있었다: 미러로 선언된 트윈을 사람이 화면에서 시작하면 시뮬 구동으로 떴고, 그\n * 트윈은 돌고 있으면서 유입을 한 건도 받지 못했다. 그때 화면은 한쪽에 「running」, 다른 쪽에\n * 「멈춰」라고 적었고 사람은 「시작 버튼을 누르면 되겠네」라는 엉뚱한 처방으로 갔다.\n \n 그래서 화면 문구는 관측 그대로 적는다(「트윈에 닿지 않고 버려지는 중」). 이 키 이름은 서버·화면·\n * 시험에 걸친 계약 문자열이라 그대로 두지만, 이름을 원인으로 읽지 않는다.\n /\n \| 'twin-not-running'\n \| 'no-traffic' /* 피드는 붙었는데 제시가 0 — 원천·망을 본다 /\n \| 'not-connected' /* 피드 자체가 없다 — 결선한다 /\n \| 'not-applicable' /* 원본이 먹이지 않는 트윈(시뮬)·멈춘 트윈 — 물을 대상이 아니다 /\n \| 'unknown' /* 한 번도 받지 않았거나 창이 아직 닫히지 않았다 — 기다린다 /\n\nexport function syncVerdictOf(args: {\n /* `live-feed-registry.liveFeedStateOf` 의 답을 그대로 받는다 — 판정 어휘를 두 벌 만들지 않는다. /\n feedState: 'attached' \| 'detached' \| 'not-applicable'\n /* 마지막으로 닫힌 창. 없으면 `null`. /\n recent: { offered: number; rejected: number } \| null\n /* 마지막으로 무엇이든 받은 시각. 한 번도 없으면 `-1` — 0 이 아니다(0 은 1970년이다). /\n lastAtMs?: number\n /* 지금. `lastAtMs` 를 견줄 때만 쓴다. /\n nowMs?: number\n /* 마지막으로 버려진 시각. 한 번도 없으면 `-1`. /\n lastUndeliveredAtMs?: number\n threshold?: number\n}): SyncVerdict {\n /\n * ── 버려지고 있는 것이 가장 먼저다 ────────────────────────────────────────\n * 트윈이 멈추면 피드는 남아 계속 레코드를 나르고, 커널은 그것을 조용히 버린다. 그 상태를 「해당 없음」\n * 이라 부르면 사실이 사라지는 동안 화면이 안심시킨다 — 실제로 그렇게 떴다(멈춘 트윈 옆에 「150\n * 통과 · 100%」). 그래서 시뮬·멈춤 판정보다 먼저 본다.\n \n 시뮬 트윈에는 이 값이 서지 않는다(먹이는 피드가 없으므로 미전달도 없다). 그래서 이 순서가 시뮬에\n * 거짓 경보를 주지 않는다.\n /\n if (\n typeof args.lastUndeliveredAtMs === 'number' &&\n args.lastUndeliveredAtMs >= 0 &&\n typeof args.nowMs === 'number' &&\n args.nowMs - args.lastUndeliveredAtMs <= STALE_AFTER_MS\n ) {\n return 'twin-not-running'\n }\n\n if (args.feedState === 'not-applicable') return 'not-applicable'\n if (args.feedState === 'detached') return 'not-connected'\n\n /\n * ── 끊긴 피드가 초록으로 남지 않게 ────────────────────────────────────────\n * 창은 다음 유입이 있을 때 닫힌다. 그래서 유입이 멈추면 창도 멈추고, 「최근 창」은 멈추기 직전의\n * 건강했던 창으로 남는다. 그 창만 보고 판정하면 어제 죽은 피드가 오늘도 「동기화 중」이다. 이\n * 기능이 있는 이유가 바로 그 상태를 드러내는 것이므로, 그때 초록을 내면 목적을 놓친다.\n \n 그래서 창과 별개로 지금까지의 침묵을 먼저 본다. 한 창을 통째로 아무것도 받지 않았으면 그것은\n * 「유입 없음」이다 — 실제로 그 구간의 창은 비어 있게 된다.\n \n 이 판단을 서버에 두는 이유: 소비처가 여럿(목록·연결 상세·앞으로 생길 것)이고, 화면마다 다시\n * 판단하면 규칙이 갈라져 어떤 화면은 초록, 어떤 화면은 경고를 말한다.\n \n 한계 — 한 창(10분)보다 느리게 긷는 원천은 긷는 사이에 「유입 없음」으로 보인다. 장부는 원천의\n * 주기를 모르므로 이보다 정확히 답할 수 없다. 주기를 알게 되면 그 값으로 견주는 것이 맞다.\n /\n if (typeof args.lastAtMs === 'number' && typeof args.nowMs === 'number') {\n if (args.lastAtMs < 0) return 'unknown' / 붙었지만 한 번도 받지 않았다 — 기다린다 /\n if (args.nowMs - args.lastAtMs > STALE_AFTER_MS) return 'no-traffic'\n }\n\n if (!args.recent) return 'unknown'\n if (args.recent.offered <= 0) return 'no-traffic'\n\n const ratio = (args.recent.offered - args.recent.rejected) / args.recent.offered\n return ratio >= (args.threshold ?? HEALTHY_ACCEPTED_RATIO) ? 'syncing' : 'mapping-blocked'\n}\n\nexport interface IngestWindowView {\n from: string\n to: string\n offered: number\n /* 트윈에 닿은 수. 제시 − 거부 − 미전달. /\n accepted: number\n /* 매핑이 거부한 수 — 처방은 매핑을 고치는 것. /\n rejected: number\n /* 매핑은 통과했으나 트윈에 닿지 못한 수 — 처방은 트윈을 세우는 것. /\n undelivered: number\n /* 통과율(0~1). 제시가 없으면 `null` — 1 로 채우면 「전부 통과」로 읽힌다. /\n acceptedRatio: number \| null\n /* 이 창에 적힌 행. /\n rows: number\n /* 그것을 적기 위해 DB 를 두드린 횟수 — 행당 왕복이 줄었는지 보는 값. /\n flushes: number\n}\n\nexport interface IngestHealthView {\n verdict: SyncVerdict\n /* 판정에 쓴 문턱 — 화면이 왜 그 판정인지 말할 수 있게 함께 낸다. /\n threshold: number\n /* 마지막으로 닫힌 창. 창이 한 번도 닫히지 않았으면 `null`. /\n recent: IngestWindowView \| null\n /* 닫힌 창들, 오래된 것부터. /\n trend: IngestWindowView[]\n /* 추이 상한에서 밀려난 창 수. /\n trendDropped: number\n /* 누적(기동 이후). /\n total: {\n offered: number\n accepted: number\n rejected: number\n undelivered: number\n acceptedRatio: number \| null\n /* 저널에 적힌 행과 그것을 위해 DB 를 두드린 횟수 — 기동 이후 누적. /\n rows: number\n flushes: number\n }\n /* 사유별 누적, 많은 것부터. `lastAt` 이 멈춘 사유는 이미 고쳐진 것이다. /\n reasons: { reason: string; count: number; lastAt: string }[]\n /* 사유 종류가 상한에 닿아 일부가 `(other reasons)` 로 접혔나. /\n reasonsCapped: boolean\n samples: RejectSample[]\n sampleDropped: number\n /* 마지막으로 무엇이든 받은 시각. 한 번도 없으면 `null`. /\n lastAt: string \| null\n /* 마지막으로 저널에 적은 시각. 한 번도 없으면 `null` — 받은 적 없는 트윈도 이 값은 있을 수 있다. /\n lastWriteAt: string \| null\n /\n 원본에 닿지 못하고 있다 — 없으면 닿고 있다는 뜻이다(§`IngestLedger.readFailure`).\n \n 커서 정체(`cursorStall`)와 섞이지 않는다: 이쪽은 기다리면 풀리고 그쪽은 기다려도 안 풀린다.\n \n 「유입 없음」과 다른 판정이다: 유입 없음은 원본이 조용한 것일 수 있고, 이것은 우리가 묻지도\n * 못한 것이다. 화면은 두 문장을 다르게 말해야 한다 — 실 원본이 끊겼을 때 사용자가 원인을 찾을 수\n * 있는지가 그 차이다.\n /\n readFailure?: {\n consecutive: number\n /* 이 단절이 시작된 시각 — 「20분째」를 말할 수 있게. /\n since: string\n lastAt: string\n reason: string\n stream?: string\n }\n}\n\nfunction toWindowView(w: IngestWindow, fallbackEndMs: number): IngestWindowView {\n / 「통과」는 트윈에 닿은 것만이다. 버려진 것을 통과로 세면 화면이 안심시킨다. /\n const accepted = w.offered - w.rejected - w.undelivered\n return {\n from: new Date(w.startMs).toISOString(),\n to: new Date(w.endMs >= 0 ? w.endMs : fallbackEndMs).toISOString(),\n offered: w.offered,\n accepted,\n rejected: w.rejected,\n undelivered: w.undelivered,\n acceptedRatio: w.offered > 0 ? round4(accepted / w.offered) : null,\n rows: w.rows,\n flushes: w.flushes\n }\n}\n\n/\n 읽기용 요약.\n \n 장부가 없어도(한 번도 받지 않은 트윈) 판정은 낸다 — 피드 사실만으로 답할 수 있는 경우가 있다\n * (`not-applicable`·`not-connected`). 그 경우 수치는 비운다: 없는 값을 0 으로 채우지 않는다.\n \n `nowMs` 를 받는 이유: 끊긴 피드를 가려내려면 「마지막 유입이 얼마나 전인가」를 봐야 하고, 그 판단을\n * 화면이 아니라 여기서 한다(소비처마다 다시 판단하면 규칙이 갈라진다). 시험이 시각을 고정할 수 있도록\n * 인자로 받는다.\n /\nexport function ingestHealth(\n ledger: IngestLedger \| undefined,\n feedState: 'attached' \| 'detached' \| 'not-applicable',\n threshold = HEALTHY_ACCEPTED_RATIO,\n nowMs: number = Date.now()\n): IngestHealthView {\n const recentRaw = ledger?.trend.length ? ledger.trend[ledger.trend.length - 1] : null\n / 열린 창의 끝 시각 대체값 — 유입이 없는 장부에서 `-1` 을 시각으로 읽으면 1969년이 화면에 뜬다. /\n const lastAnyMs = Math.max(ledger?.lastAtMs ?? -1, ledger?.lastWriteAtMs ?? -1)\n const verdict = syncVerdictOf({\n feedState,\n recent: recentRaw,\n lastAtMs: ledger?.lastAtMs ?? -1,\n lastUndeliveredAtMs: ledger?.lastUndeliveredAtMs ?? -1,\n nowMs,\n threshold\n })\n\n /\n * 유입이 없어도 「빈 장부」가 아니다. 시뮬 트윈은 받는 것 없이 적는다. 유입 시각만 보고 비었다고\n * 판단하면 그 트윈의 창은 만들어져 있는데 화면에는 아무 추이도 나오지 않는다(이 축을 넣은 이유가 그것이다).\n /\n if (!ledger \|\| (ledger.lastAtMs < 0 && ledger.lastWriteAtMs < 0)) {\n return {\n verdict,\n threshold,\n recent: null,\n trend: [],\n trendDropped: 0,\n total: { offered: 0, accepted: 0, rejected: 0, undelivered: 0, acceptedRatio: null, rows: 0, flushes: 0 },\n reasons: [],\n reasonsCapped: false,\n samples: [],\n sampleDropped: 0,\n lastAt: null,\n lastWriteAt: null,\n /\n * 이 짧은 답에도 단절은 실어야 한다 — 이 자리가 바로 그 트윈의 모습이다.\n \n 받은 것도 적은 것도 없는 장부는 「아직 아무 일도 없다」로 읽히는데, 원본에 닿지 못하는 트윈이\n * 정확히 그 모습이다(읽지 못하면 받은 것도 적은 것도 없다). 여기서 떨어뜨리면 *가장 필요한\n 순간에** 그 사실이 사라진다 — 실측으로 원본이 끊긴 트윈이 이 경로로 답하고 있었다.\n /\n ...(ledger?.readFailure\n ? {\n readFailure: {\n consecutive: ledger.readFailure.consecutive,\n since: new Date(ledger.readFailure.sinceMs).toISOString(),\n lastAt: new Date(ledger.readFailure.lastAtMs).toISOString(),\n reason: ledger.readFailure.reason,\n ...(ledger.readFailure.stream ? { stream: ledger.readFailure.stream } : {})\n }\n }\n : {}),\n / 커서 정체도 이 갈래에서 내보낸다 — 유입이 없는 장부에서도 정체는 실재한다(읽었으나 못\n 넘겼으면 유입이 0이다). 여기서 떨어뜨리면 바로 그 상황에서 조용해진다. /\n ...(ledger?.cursorStall\n ? {\n cursorStall: {\n consecutive: ledger.cursorStall.consecutive,\n since: new Date(ledger.cursorStall.sinceMs).toISOString(),\n lastAt: new Date(ledger.cursorStall.lastAtMs).toISOString(),\n reason: ledger.cursorStall.reason,\n ...(ledger.cursorStall.stream ? { stream: ledger.cursorStall.stream } : {})\n }\n }\n : {})\n }\n }\n\n / 「통과」는 트윈에 닿은 것만이다 — 창 뷰와 같은 규칙. /\n const accepted = ledger.offered - ledger.rejected - ledger.undelivered\n return {\n verdict,\n threshold,\n recent: recentRaw ? toWindowView(recentRaw, lastAnyMs) : null,\n trend: ledger.trend.map(w => toWindowView(w, lastAnyMs)),\n trendDropped: ledger.trendDropped,\n total: {\n offered: ledger.offered,\n accepted,\n rejected: ledger.rejected,\n undelivered: ledger.undelivered,\n acceptedRatio: ledger.offered > 0 ? round4(accepted / ledger.offered) : null,\n rows: ledger.rows,\n flushes: ledger.flushes\n },\n reasons: Object.entries(ledger.byReason)\n .map(([reason, v]) => ({ reason, count: v.count, lastAt: new Date(v.lastAtMs).toISOString() }))\n .sort((a, b) => b.count - a.count \|\| a.reason.localeCompare(b.reason)),\n reasonsCapped: ledger.reasonsCapped,\n samples: [...ledger.samples],\n sampleDropped: ledger.sampleDropped,\n / 「받은 적 없음」과 「방금 받음」을 가른다 — 적기만 하는 트윈의 유입 시각은 없다. /\n lastAt: ledger.lastAtMs >= 0 ? new Date(ledger.lastAtMs).toISOString() : null,\n lastWriteAt: ledger.lastWriteAtMs >= 0 ? new Date(ledger.lastWriteAtMs).toISOString() : null,\n / 닿지 못하고 있으면 그 사실을 낸다 — 없으면 필드를 만들지 않는다(빈 값이 「닿는다」로 읽히지 않게). /\n ...(ledger.readFailure\n ? {\n readFailure: {\n consecutive: ledger.readFailure.consecutive,\n since: new Date(ledger.readFailure.sinceMs).toISOString(),\n lastAt: new Date(ledger.readFailure.lastAtMs).toISOString(),\n reason: ledger.readFailure.reason,\n ...(ledger.readFailure.stream ? { stream: ledger.readFailure.stream } : {})\n }\n }\n : {}),\n ...(ledger.cursorStall\n ? {\n cursorStall: {\n consecutive: ledger.cursorStall.consecutive,\n since: new Date(ledger.cursorStall.sinceMs).toISOString(),\n lastAt: new Date(ledger.cursorStall.lastAtMs).toISOString(),\n reason: ledger.cursorStall.reason,\n ...(ledger.cursorStall.stream ? { stream: ledger.cursorStall.stream } : {})\n }\n }\n : {})\n }\n}\n\n/* 비율은 자릿수를 넉넉히 준다 — 0.999 가 1 로 반올림되면 「전부 통과」로 읽힌다. /\nconst round4 = (v: number) => Math.round(v 10000) / 10000\n"]}

package/dist-server/engine/twin-engine.d.ts CHANGED Viewed

@@ -174,6 +174,28 @@ export declare class TwinEngine {
      * 사건 집계가 없다 — 그 상태로 뒤를 접으면 0부터 접은 결과와 조용히 달라진다). 그래서 씨앗은 따로 든다.
      */
     private static readonly FOLD_NOTE;
+    /**
+     * 재기동에 쓸 **웜스타트 씨앗**을 만든다 — 상태 + 이어 접을 재개점.
+     *
+     * ── 왜 이 자리가 생겼나 (2026-08-24) ──────────────────────────────────────
+     * 두 호출부가 같은 일을 조금씩 다르게 하고 있었고(겹포장을 한쪽만 벗겼다), 둘 다 **재개점을 버리고**
+     * 상태만 들고 갔다. 그래서 저장된 재개점을 읽는 쪽이 다 있는데도 재기동은 매번 저널을 처음부터
+     * 접었다(실측: 저널 2,960만 줄).
+     *
+     * 여기서 하는 일 셋:
+     *  ① 겹포장을 벗긴다 — 옛 형식으로 저장된 값이 한 번은 반드시 나온다
+     *  ② **그 공장이 아직 그 공장인지** 심판한다 — 아니면 씨앗을 버린다(아래)
+     *  ③ 씨앗이 저널 끝보다 앞서 있으면 **그 꼬리만 접어** 끝까지 밀어 둔다
+     *
+     * ②가 필요한 이유: 재개점은 그때의 보드 위에서 만들어진 것이다. 그 뒤 구조가 바뀌었다면(자리가
+     * 빠졌다·설비가 옮겨졌다) 되세운 리듀서는 **지금 없는 자리와 설비를 든다** — 없는 냉장실이 화면에
+     * 나오고 그 자리의 판정이 계속 돌아간다. 오류 없이 틀리므로 눈에 띄지 않는다.
+     *
+     * ③이 필요한 이유: 스냅샷은 체크포인트 주기로 쓰이므로 마지막 주기 이후의 사실은 저널에만 있다.
+     * 그것을 빼고 되세우면 그만큼이 조용히 사라진다 — 「모름」을 「없음」으로 적는 것과 같은 부류다.
+     * 접는 구간은 **그 틈뿐**이고(저널 전체가 아니다), `recover` 가 그 자리에서 새 재개점을 남겨 준다.
+     */
+    private static warmSeedFor;
     /** 체크포인트된 최신 스냅샷 로드(없으면 null). getFromCache 는 CacheStore 엔티티를 반환 → 페이로드는 .value. */
     static loadSnapshot(domainId: string, instanceId: string): Promise<{
         revision: number;
@@ -1046,6 +1068,18 @@ export declare class TwinEngine {
      * 그 둘을 같게 두면 조용한 원본이 끊긴 원본으로 보인다.
      */
     static clearIngestReadFailure(domainId: string, instanceId: string): void;
+    /**
+     * **읽었는데 창을 넘길 수 없다**를 적는다 — 위와 **조치가 반대인** 사실이다(§`recordCursorStall`).
+     *
+     * 이 문이 없던 동안 이 사실이 `recordIngestReadFailure` 로 나갔다. 그래서 화면이 「원본에 닿지
+     * 못한다」고 말했는데 원본은 **답한** 상태였고, 그 답의 모양이 커서를 이긴 것이었다(한 시각에 한
+     * 페이지보다 많은 행). 사람은 원본을 의심하고 기다리는데 **기다림으로는 영원히 풀리지 않는다.**
+     *
+     * 조치가 반대인 두 사실을 한 이름으로 부르면 그 이름은 정보가 아니라 오해다.
+     */
+    static recordIngestCursorStall(domainId: string, instanceId: string, reason: string, nowMs?: number, stream?: string): void;
+    /** 창을 넘겼다 — 정체 기록을 지운다(풀린 정체가 화면에 남아 있으면 그것도 거짓이다). */
+    static clearIngestCursorStall(domainId: string, instanceId: string): void;
     /**
      * 저널에 **적은 것**을 같은 장부에 남긴다 — 유입과 같은 10분 창에.
      *