@things-factory/headless-twin 10.0.18 → 10.1.0

package/dist-server/service/reference/live-cadence.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cadenceOf = cadenceOf;
+exports.ingestExpectation = ingestExpectation;
+/** 그 축의 선언을 찾는다 — 없으면 `undefined`(옛 거동으로 견준다). */
+function cadenceOf(cadences, axis) {
+    return cadences?.find(c => c.axis === axis);
+}
+/**
+ * 유입 건강이 이 축을 어떻게 견줄 것인가 — **판정에 넘길 두 값으로 옮긴다.**
+ *
+ * `syncVerdictOf` 가 받는 모양(§`ingest-health.ts`)에 맞춘다. 그 함수는 순수하고 달력을 보지
+ * 않으므로, 창 판정은 여기서 끝내고 참·거짓만 넘긴다 — `capabilityOf` 가 `requiredTests` 를 받는
+ * 것과 같은 규율이다.
+ *
+ * ── 「보내면 온다」는 침묵으로 판정하지 않는다 ──────────────────────────────
+ * `pushed` 면 `quietNow` 를 늘 참으로 낸다. 그러면 침묵이 「유입 없음」이 되지 않는다. **다른
+ * 갈래는 그대로 산다** — 버려지는 중·결선 없음은 몇 시든 문제이고 그것들이 이 값보다 앞선다.
+ *
+ * ── 모르면 아무것도 답하지 않는다 ──────────────────────────────────────────
+ * 선언이 없으면 둘 다 비운다. 그때 판정은 지금까지처럼 창 하나로 견준다 — 「모른다」를 「안 와도
+ * 된다」로 접으면 정말 끊긴 원천이 통째로 조용해진다.
+ */
+function ingestExpectation(cadence, ctx) {
+    if (!cadence)
+        return {};
+    const out = {};
+    if (typeof cadence.expectedSilenceMs === 'number' && cadence.expectedSilenceMs > 0) {
+        out.expectedSilenceMs = cadence.expectedSilenceMs;
+    }
+    if (cadence.pushed) {
+        /* 보낼 것이 없으면 안 보내는 것이 정상이다 — 침묵을 근거로 삼지 않는다. */
+        out.quietNow = true;
+        return out;
+    }
+    /*
+     * 창이 있으면 그것으로 판정한다. **판정할 수단을 안 받았으면 답하지 않는다** — 부르는 쪽이
+     * 달력 판정 함수를 주지 않았는데 우리가 「활동 시각이다」로 단언하면 그것이 지어낸 값이다.
+     */
+    if (cadence.window?.length && ctx.inWindow)
+        out.quietNow = !ctx.inWindow(cadence.window);
+    return out;
+}
+//# sourceMappingURL=live-cadence.js.map

package/dist-server/service/reference/live-cadence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-cadence.js","sourceRoot":"","sources":["../../../server/service/reference/live-cadence.ts"],"names":[],"mappings":";;AAoFA,8BAEC;AAiBD,8CAyBC;AA7CD,kDAAkD;AAClD,SAAgB,SAAS,CAAC,QAA4C,EAAE,IAAY;IAClF,OAAO,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;AAC7C,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,iBAAiB,CAC/B,OAAgC,EAChC,GAA+G;IAE/G,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAA;IAEvB,MAAM,GAAG,GAAuD,EAAE,CAAA;IAElE,IAAI,OAAO,OAAO,CAAC,iBAAiB,KAAK,QAAQ,IAAI,OAAO,CAAC,iBAAiB,GAAG,CAAC,EAAE,CAAC;QACnF,GAAG,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAA;IACnD,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,+CAA+C;QAC/C,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAA;QACnB,OAAO,GAAG,CAAA;IACZ,CAAC;IAED;;;OAGG;IACH,IAAI,OAAO,CAAC,MAAM,EAAE,MAAM,IAAI,GAAG,CAAC,QAAQ;QAAE,GAAG,CAAC,QAAQ,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAExF,OAAO,GAAG,CAAA;AACZ,CAAC","sourcesContent":["/*\n * **원천이 축마다 언제·얼마나 자주 내놓나** — 유입 건강이 이 선언으로 견준다.\n *\n * ── 왜 필요한가 (2026-09-04 실측) ──────────────────────────────────────────\n * 유입 건강이 **한 자로 전부를 쟀다.** 10분 안에 아무것도 오지 않으면 「유입 없음」이다. 그런데\n * 원천마다 시간의 결이 다르다.\n *\n *   태양광 발전        일몰에 멈춘다 — 두 사이트가 같은 분 19:25 에 함께\n *   부하 계측          밤에도 온다 · 15분마다\n *   인증서 가격        화·목만 거래된다 · 그 날 하루 한 번\n *   MES · 주방        현장 근무시간 밖에는 사실이 안 난다 · 훅이라 「보내면 온다」\n *\n * 그래서 **정상인데 매일 밤 절반이 빨갛게 났다.** 거짓 빨강이 쌓이면 진짜 빨강도 같이 안 읽힌다.\n *\n * ── 두 축이고 서로 다르다 ───────────────────────────────────────────────────\n *   window            지금이 그 축의 활동 시각인가        → 아니면 조용한 것이 정상\n *   expectedSilenceMs 활동 시각 안에서 이만큼 조용해도 정상 → 넘기면 유입 없음\n *\n * 주기를 넘겼어도 활동 시각 밖이면 정상이다. 한 값으로 접을 수 없다 — 인증서 가격이 그 증거다.\n * 「매일 와야 한다」로 재면 주 5일 중 3일이 빨갛고, 「주 2회」로 재면 이어 쓴 날을 못 본다.\n *\n * ── 커널이 일출·일몰을 계산하지 않는다 ─────────────────────────────────────\n * 굴절·고위도·박명 정의가 다 선택이고, 우리가 정하면 그 순간 방언이다. 그리고 계약이 같은 문제에\n * 이미 답해 뒀다(§`TwinModelDef.utcOffsetMinutes`): 「긴 지평선의 정확한 답은 호스트가 표준대로\n * **절대 구간**을 계산해 넣는 것이다」.\n *\n * 그래서 원천은 `windowKind: 'daylight'` 로 **종류만** 선언하고, 좌표를 아는 호스트가 날마다\n * 구체적인 구간을 채운다. **고정 시각을 선언에 박지 않는다** — 일몰 19:25 는 오늘 잰 값이고 두 달\n * 뒤에는 틀리다. 그것을 박으면 겨울마다 거짓 빨강이 다시 난다.\n *\n * ── 「주기 없음」과 「모른다」는 다르다 ──────────────────────────────────────\n * MES 는 훅으로 밀어 준다 — 몇 분마다가 아니라 「보내면 온다」다. 보낼 것이 없으면 안 보내는 것이\n * 정상이고, 그것을 침묵으로 판정하면 안 된다.\n *\n * 선언하지 않은 축은 **지금까지처럼** 창 하나로 견준다(옛 거동). 「모른다」를 「안 와도 된다」로\n * 접지 않는다 — 그러면 정말 끊긴 원천이 통째로 조용해진다.\n */\nimport type { WorkCalendarEntry } from '@operato/ops-contract'\n\n/**\n * 창의 종류 — **호스트가 채워야 하는 것**만 이름이 있다.\n *\n * 지금은 하나다. 늘리기 전에 「호스트가 그것을 계산할 근거를 갖고 있나」를 먼저 물어야 한다 —\n * 좌표 없이 `daylight` 를 선언하면 호스트가 채울 것이 없고, 그러면 그 축은 창이 없는 것과 같다.\n */\nexport type LiveWindowKind = 'daylight'\n\n/** 한 축의 시간성 — 어느 사실이 언제·얼마나 자주 오나. */\nexport interface LiveCadence {\n  /**\n   * 어느 축인가 — **`OP_EVENT` 의 값 그대로**(`equipment.status` · `quality.output` …).\n   *\n   * 새 낱말을 만들지 않는다. 만들면 커넥터가 부르는 이름과 장부가 세는 이름이 갈리고, 그때\n   * 선언이 조용히 아무 축에도 안 붙는다.\n   */\n  axis: string\n  /**\n   * 활동 시각 안에서 **이만큼 조용해도 정상**(ms). 없으면 창 하나로 견준다.\n   *\n   * 15분마다 긷는 원천은 이 값을 선언해야 한다 — 안 하면 긷는 사이마다 「유입 없음」으로 보인다.\n   */\n  expectedSilenceMs?: number\n  /**\n   * 이 축이 **활동하는 창** — 근무 달력 어휘 그대로(요일·시간대·휴일).\n   *\n   * 계약이 이미 그 셋을 표현한다. 새 모양을 만들지 않는 이유는 판정하는 함수가 이미 하나\n   * 있기 때문이다(`inWorkCalendar`) — 두 벌이면 화면과 커널이 다른 답을 낸다.\n   */\n  window?: readonly WorkCalendarEntry[]\n  /**\n   * 창을 **호스트가 채우는 종류** — 좌표·표준으로 계산해야 하는 것.\n   *\n   * `window` 와 함께 선언하면 호스트가 채운 것이 이긴다(계산이 선언보다 그 날에 맞다).\n   */\n  windowKind?: LiveWindowKind\n  /**\n   * **보내면 온다** — 이 축은 침묵으로 판정하지 않는다(훅·구독).\n   *\n   * 「주기가 없다」와 「모른다」를 가르는 값이다. 훅은 보낼 것이 없으면 안 보내고, 그것이 정상이다.\n   */\n  pushed?: boolean\n}\n\n/** 그 축의 선언을 찾는다 — 없으면 `undefined`(옛 거동으로 견준다). */\nexport function cadenceOf(cadences: readonly LiveCadence[] | undefined, axis: string): LiveCadence | undefined {\n  return cadences?.find(c => c.axis === axis)\n}\n\n/**\n * 유입 건강이 이 축을 어떻게 견줄 것인가 — **판정에 넘길 두 값으로 옮긴다.**\n *\n * `syncVerdictOf` 가 받는 모양(§`ingest-health.ts`)에 맞춘다. 그 함수는 순수하고 달력을 보지\n * 않으므로, 창 판정은 여기서 끝내고 참·거짓만 넘긴다 — `capabilityOf` 가 `requiredTests` 를 받는\n * 것과 같은 규율이다.\n *\n * ── 「보내면 온다」는 침묵으로 판정하지 않는다 ──────────────────────────────\n * `pushed` 면 `quietNow` 를 늘 참으로 낸다. 그러면 침묵이 「유입 없음」이 되지 않는다. **다른\n * 갈래는 그대로 산다** — 버려지는 중·결선 없음은 몇 시든 문제이고 그것들이 이 값보다 앞선다.\n *\n * ── 모르면 아무것도 답하지 않는다 ──────────────────────────────────────────\n * 선언이 없으면 둘 다 비운다. 그때 판정은 지금까지처럼 창 하나로 견준다 — 「모른다」를 「안 와도\n * 된다」로 접으면 정말 끊긴 원천이 통째로 조용해진다.\n */\nexport function ingestExpectation(\n  cadence: LiveCadence | undefined,\n  ctx: { nowMs: number; utcOffsetMinutes?: number; inWindow?: (window: readonly WorkCalendarEntry[]) => boolean }\n): { expectedSilenceMs?: number; quietNow?: boolean } {\n  if (!cadence) return {}\n\n  const out: { expectedSilenceMs?: number; quietNow?: boolean } = {}\n\n  if (typeof cadence.expectedSilenceMs === 'number' && cadence.expectedSilenceMs > 0) {\n    out.expectedSilenceMs = cadence.expectedSilenceMs\n  }\n\n  if (cadence.pushed) {\n    /* 보낼 것이 없으면 안 보내는 것이 정상이다 — 침묵을 근거로 삼지 않는다. */\n    out.quietNow = true\n    return out\n  }\n\n  /*\n   * 창이 있으면 그것으로 판정한다. **판정할 수단을 안 받았으면 답하지 않는다** — 부르는 쪽이\n   * 달력 판정 함수를 주지 않았는데 우리가 「활동 시각이다」로 단언하면 그것이 지어낸 값이다.\n   */\n  if (cadence.window?.length && ctx.inWindow) out.quietNow = !ctx.inWindow(cadence.window)\n\n  return out\n}\n"]}

package/dist-server/service/reference/live-feed-lease.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The lease name for one twin's feed.
+ *
+ * ── Domain and instance are required; the source is not ───────────────────
+ * A feed is registered per instance, so domain plus instance already names it
+ * uniquely. The source is appended when known because it is what a person
+ * reading `task_leases` wants to see — which system this channel talks to.
+ *
+ * Missing a domain or an instance is refused rather than filled in. A blank
+ * there would collapse two different feeds onto one name, and the failure
+ * would be that one of them silently stops: it would look exactly like
+ * "someone else holds it", which is the ordinary case on every instance but
+ * one, so nothing would be logged.
+ */
+export declare function liveFeedLeaseName(domainId: string, instanceId: string, source?: string): string;

package/dist-server/service/reference/live-feed-lease.js

@@ -0,0 +1,56 @@
+"use strict";
+/*
+ * What a live feed takes its task lease under — pure naming, one place.
+ *
+ * ── Why the name is built here and not by the adapter ──────────────────────
+ * `TaskLease` deliberately has no domain column: the thing made exclusive is a
+ * loop, not a tenant's slice of one, and a task that does need to be per-tenant
+ * puts the tenant in its name so the unique index keeps meaning what it says.
+ *
+ * An adapter cannot honour that. It receives `cfg` and `site`, and neither
+ * carries a domain — so a name built from `siteId` would let two domains that
+ * happen to share a plant code block each other's channel. It would look
+ * exactly like "someone else holds it", which is the ordinary case on every
+ * instance but one, so nothing would be logged and nothing would look wrong.
+ *
+ * ── Why the source and not the site ───────────────────────────────────────
+ * One reference is one connection to one system, and that connection is what a
+ * second instance must not open twice. A source that discovers several sites
+ * still reads them over that one connection.
+ *
+ * ── Why the parts are joined with `::` ────────────────────────────────────
+ * The same separator the push cursor key already uses (`instanceId::scope`), so
+ * a person reading `task_leases` during an incident sees the same shape they
+ * see in `liveCursor`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.liveFeedLeaseName = liveFeedLeaseName;
+/** Marks the name as a live feed, so a lease table read tells you what kind of task it is. */
+const PREFIX = 'twin-live';
+/**
+ * The lease name for one twin's feed.
+ *
+ * ── Domain and instance are required; the source is not ───────────────────
+ * A feed is registered per instance, so domain plus instance already names it
+ * uniquely. The source is appended when known because it is what a person
+ * reading `task_leases` wants to see — which system this channel talks to.
+ *
+ * Missing a domain or an instance is refused rather than filled in. A blank
+ * there would collapse two different feeds onto one name, and the failure
+ * would be that one of them silently stops: it would look exactly like
+ * "someone else holds it", which is the ordinary case on every instance but
+ * one, so nothing would be logged.
+ */
+function liveFeedLeaseName(domainId, instanceId, source) {
+    for (const [what, value] of [
+        ['domainId', domainId],
+        ['instanceId', instanceId]
+    ]) {
+        if (!value || !String(value).trim()) {
+            throw new Error(`cannot name a live feed lease without ${what} — two feeds would share one name`);
+        }
+    }
+    const named = source && String(source).trim();
+    return named ? `${PREFIX}::${domainId}::${instanceId}::${named}` : `${PREFIX}::${domainId}::${instanceId}`;
+}
+//# sourceMappingURL=live-feed-lease.js.map

package/dist-server/service/reference/live-feed-lease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-feed-lease.js","sourceRoot":"","sources":["../../../server/service/reference/live-feed-lease.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;AAmBH,8CAaC;AA9BD,8FAA8F;AAC9F,MAAM,MAAM,GAAG,WAAW,CAAA;AAE1B;;;;;;;;;;;;;GAaG;AACH,SAAgB,iBAAiB,CAAC,QAAgB,EAAE,UAAkB,EAAE,MAAe;IACrF,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI;QAC1B,CAAC,UAAU,EAAE,QAAQ,CAAC;QACtB,CAAC,YAAY,EAAE,UAAU,CAAC;KAClB,EAAE,CAAC;QACX,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,yCAAyC,IAAI,mCAAmC,CAAC,CAAA;QACnG,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAA;IAE7C,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,KAAK,QAAQ,KAAK,UAAU,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,KAAK,QAAQ,KAAK,UAAU,EAAE,CAAA;AAC5G,CAAC","sourcesContent":["/*\n * What a live feed takes its task lease under — pure naming, one place.\n *\n * ── Why the name is built here and not by the adapter ──────────────────────\n * `TaskLease` deliberately has no domain column: the thing made exclusive is a\n * loop, not a tenant's slice of one, and a task that does need to be per-tenant\n * puts the tenant in its name so the unique index keeps meaning what it says.\n *\n * An adapter cannot honour that. It receives `cfg` and `site`, and neither\n * carries a domain — so a name built from `siteId` would let two domains that\n * happen to share a plant code block each other's channel. It would look\n * exactly like \"someone else holds it\", which is the ordinary case on every\n * instance but one, so nothing would be logged and nothing would look wrong.\n *\n * ── Why the source and not the site ───────────────────────────────────────\n * One reference is one connection to one system, and that connection is what a\n * second instance must not open twice. A source that discovers several sites\n * still reads them over that one connection.\n *\n * ── Why the parts are joined with `::` ────────────────────────────────────\n * The same separator the push cursor key already uses (`instanceId::scope`), so\n * a person reading `task_leases` during an incident sees the same shape they\n * see in `liveCursor`.\n */\n\n/** Marks the name as a live feed, so a lease table read tells you what kind of task it is. */\nconst PREFIX = 'twin-live'\n\n/**\n * The lease name for one twin's feed.\n *\n * ── Domain and instance are required; the source is not ───────────────────\n * A feed is registered per instance, so domain plus instance already names it\n * uniquely. The source is appended when known because it is what a person\n * reading `task_leases` wants to see — which system this channel talks to.\n *\n * Missing a domain or an instance is refused rather than filled in. A blank\n * there would collapse two different feeds onto one name, and the failure\n * would be that one of them silently stops: it would look exactly like\n * \"someone else holds it\", which is the ordinary case on every instance but\n * one, so nothing would be logged.\n */\nexport function liveFeedLeaseName(domainId: string, instanceId: string, source?: string): string {\n  for (const [what, value] of [\n    ['domainId', domainId],\n    ['instanceId', instanceId]\n  ] as const) {\n    if (!value || !String(value).trim()) {\n      throw new Error(`cannot name a live feed lease without ${what} — two feeds would share one name`)\n    }\n  }\n\n  const named = source && String(source).trim()\n\n  return named ? `${PREFIX}::${domainId}::${instanceId}::${named}` : `${PREFIX}::${domainId}::${instanceId}`\n}\n"]}

package/dist-server/service/reference/live-ingest.d.ts

@@ -0,0 +1,21 @@
+import type { IngestResult } from './reference-hook.js';
+/**
+ * 레코드를 넣고 **네 갈래로 답한다.**
+ *
+ * 두 갈래로는 셈이 안 닫힙니다(인티그레이션 레인 실측 2026-09-05).
+ *
+ * ```
+ * 두 갈래   157 − 46 − 2 = 109 「설명 못 함」   진실은 되풀이 108 + 어휘 1
+ * 네 갈래   157 − 46 − 2 − 108 − 1 = 0
+ * ```
+ *
+ * 109 를 「사라졌다」로 내면 그날부터 아무도 그 수를 안 봅니다. 늘 참인 경고는 벽지가 됩니다.
+ *
+ * `vocabulary` 는 저널에 안 가는 어휘 요소의 수입니다. 사라진 것이 아닙니다.
+ *
+ * @param via 유입 장부에 남길 길 이름 — `hook`(밀어 받음) · `fill`(빠진 구간을 다시 받음)
+ */
+export declare function liveIngest(domainId: string, instanceId: string, records: unknown[], via: string): IngestResult & {
+    vocabulary: number;
+    undated?: Record<string, number>;
+};

package/dist-server/service/reference/live-ingest.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.liveIngest = liveIngest;
+const index_js_1 = require("../../engine/index.js");
+const canonical_ingest_js_1 = require("../../engine/canonical-ingest.js");
+const index_js_2 = require("../actuation/index.js");
+const event_time_js_1 = require("../../engine/event-time.js");
+const log_js_1 = require("../../engine/log.js");
+/**
+ * 레코드를 넣고 **네 갈래로 답한다.**
+ *
+ * 두 갈래로는 셈이 안 닫힙니다(인티그레이션 레인 실측 2026-09-05).
+ *
+ * ```
+ * 두 갈래   157 − 46 − 2 = 109 「설명 못 함」   진실은 되풀이 108 + 어휘 1
+ * 네 갈래   157 − 46 − 2 − 108 − 1 = 0
+ * ```
+ *
+ * 109 를 「사라졌다」로 내면 그날부터 아무도 그 수를 안 봅니다. 늘 참인 경고는 벽지가 됩니다.
+ *
+ * `vocabulary` 는 저널에 안 가는 어휘 요소의 수입니다. 사라진 것이 아닙니다.
+ *
+ * @param via 유입 장부에 남길 길 이름 — `hook`(밀어 받음) · `fill`(빠진 구간을 다시 받음)
+ */
+function liveIngest(domainId, instanceId, records, via) {
+    const { accepted, rejected, masterData, undated } = (0, canonical_ingest_js_1.ingestCanonicalRecords)(records, domainId, new Date().toISOString(), index_js_1.TwinEngine.factScope(domainId, instanceId));
+    /* 사건이 아닌 것은 상태만 세운다 — 두 길이 같은 규율이다(§`applyMasterData`). */
+    if (masterData.length)
+        index_js_1.TwinEngine.applyMasterData(domainId, instanceId, masterData);
+    const { applied, duplicates } = index_js_1.TwinEngine.ingestLiveResult(domainId, instanceId, accepted, via);
+    /*
+     * **나간 지시와 잇는다** — 폐루프. 기다리지 않습니다: 훅의 응답이 이것 때문에 늦으면 보내는 쪽이
+     * 되풀이하고, 그러면 같은 관측이 두 번 옵니다. 실패해도 관측 유입은 멈추지 않습니다.
+     */
+    void (0, index_js_2.settleEffects)({ domainId, envelopes: accepted, store: (0, index_js_2.databaseCommandStore)() });
+    /*
+     * 커널이 받지 못한 수를 이름으로 남깁니다 — 트윈이 멈춘 사이 버려진 레코드를 「통과」로 세면
+     * 화면이 100% 라고 말합니다. 중복으로 걸러진 것은 버려진 것이 아니므로 빼고 셉니다.
+     */
+    const undelivered = Math.max(0, accepted.length - applied - duplicates);
+    index_js_1.TwinEngine.recordIngestResult(domainId, instanceId, records.length, rejected, Date.now(), undelivered, masterData.length);
+    /*
+     * 떨어진 것을 **수가 아니라 목록으로** 넘깁니다 — 응답에 실어야 보내는 쪽이 그것만 따로 둘 수
+     * 있습니다. 수만 주면 배치 전체를 다시 보내거나 전부 버리는 두 갈래밖에 없습니다.
+     */
+    /*
+     * **표에 있는 type 인데 시각을 못 읽었으면 그것은 결함이다.** 그 fact 는 자기 시각을 싣기로 되어
+     * 있는데 안 실려 온 것이고, 그대로 두면 ingest 시각이 그 사실의 시각으로 저장된다.
+     *
+     * 표에 없는 type 은 세기만 한다 — 절대값 snapshot 은 polling 순간이 맞는 시각이다.
+     */
+    const wrong = Object.entries(undated ?? {}).filter(([type]) => (0, event_time_js_1.shouldHaveTime)(type));
+    if (wrong.length) {
+        (0, log_js_1.twinWarn)(`[twin-ingest] "${instanceId}" — 시각을 실어야 하는 fact 가 시각 없이 왔습니다: ` +
+            wrong.map(([t, n]) => `${t} ${n}건`).join(' · ') +
+            `. 그 사실들은 지금 시각으로 저널에 앉습니다`);
+    }
+    return {
+        applied,
+        duplicates,
+        vocabulary: masterData.length,
+        rejected,
+        ...(undated && Object.keys(undated).length ? { undated } : {})
+    };
+}
+//# sourceMappingURL=live-ingest.js.map

package/dist-server/service/reference/live-ingest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-ingest.js","sourceRoot":"","sources":["../../../server/service/reference/live-ingest.ts"],"names":[],"mappings":";;AAsCA,gCAuDC;AA7ED,oDAAkD;AAClD,0EAAyE;AACzE,oDAA2E;AAC3E,8DAA2D;AAC3D,gDAA8C;AAE9C;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,UAAU,CACxB,QAAgB,EAChB,UAAkB,EAClB,OAAkB,EAClB,GAAW;IAEX,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,IAAA,4CAAsB,EACxE,OAAc,EACd,QAAQ,EACR,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EACxB,qBAAU,CAAC,SAAS,CAAC,QAAQ,EAAE,UAAU,CAAC,CAC3C,CAAA;IACD,2DAA2D;IAC3D,IAAI,UAAU,CAAC,MAAM;QAAE,qBAAU,CAAC,eAAe,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,CAAA;IACnF,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,qBAAU,CAAC,gBAAgB,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAA;IAEhG;;;OAGG;IACH,KAAK,IAAA,wBAAa,EAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAA,+BAAoB,GAAE,EAAE,CAAC,CAAA;IAEpF;;;OAGG;IACH,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC,CAAA;IACvE,qBAAU,CAAC,kBAAkB,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,CAAA;IAEzH;;;OAGG;IACH;;;;;OAKG;IACH,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAA,8BAAc,EAAC,IAAI,CAAC,CAAC,CAAA;IACpF,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,IAAA,iBAAQ,EACN,kBAAkB,UAAU,oCAAoC;YAC9D,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;YAC/C,2BAA2B,CAC9B,CAAA;IACH,CAAC;IAED,OAAO;QACL,OAAO;QACP,UAAU;QACV,UAAU,EAAE,UAAU,CAAC,MAAM;QAC7B,QAAQ;QACR,GAAG,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/D,CAAA;AACH,CAAC","sourcesContent":["/*\n * **원본이 준 레코드를 트윈에 넣는다** — 밀어 받는 길과 backfill 이 같이 쓴다.\n *\n * ── 왜 한 곳에 두나 ─────────────────────────────────────────────────────────\n * 이 몸통이 `routes.ts` 의 훅 안에 박혀 있었습니다. backfill 문을 만들면서 복사하면 두 길이 서로\n * 다른 규칙으로 받게 되고, 한쪽만 수정되는 날이 옵니다.\n *\n * 실제로 그 위험이 이 자리에 있습니다. 유입 장부의 네 갈래(앉음 · 되풀이 · 어휘 · 거절)를\n * 2026-09-05 에 고쳤는데, 그때 이 몸통이 두 벌이었다면 한쪽 셈만 닫혔을 것입니다.\n *\n * ── 커널을 직접 부르지 않는 쪽이 넘겨받는다 ────────────────────────────────\n * 훅 판정(`reference-hook.ts`)은 이 함수를 인자로 받습니다. 그 파일이 엔진을 직접 부르면 테스트할\n * 때 엔진이 필요해집니다. 그 규율은 그대로 두고, 이 파일이 엔진을 아는 유일한 자리가 됩니다.\n */\nimport type { IngestResult } from './reference-hook.js'\n\nimport { TwinEngine } from '../../engine/index.js'\nimport { ingestCanonicalRecords } from '../../engine/canonical-ingest.js'\nimport { databaseCommandStore, settleEffects } from '../actuation/index.js'\nimport { shouldHaveTime } from '../../engine/event-time.js'\nimport { twinWarn } from '../../engine/log.js'\n\n/**\n * 레코드를 넣고 **네 갈래로 답한다.**\n *\n * 두 갈래로는 셈이 안 닫힙니다(인티그레이션 레인 실측 2026-09-05).\n *\n * ```\n * 두 갈래   157 − 46 − 2 = 109 「설명 못 함」   진실은 되풀이 108 + 어휘 1\n * 네 갈래   157 − 46 − 2 − 108 − 1 = 0\n * ```\n *\n * 109 를 「사라졌다」로 내면 그날부터 아무도 그 수를 안 봅니다. 늘 참인 경고는 벽지가 됩니다.\n *\n * `vocabulary` 는 저널에 안 가는 어휘 요소의 수입니다. 사라진 것이 아닙니다.\n *\n * @param via 유입 장부에 남길 길 이름 — `hook`(밀어 받음) · `fill`(빠진 구간을 다시 받음)\n */\nexport function liveIngest(\n  domainId: string,\n  instanceId: string,\n  records: unknown[],\n  via: string\n): IngestResult & { vocabulary: number; undated?: Record<string, number> } {\n  const { accepted, rejected, masterData, undated } = ingestCanonicalRecords(\n    records as any,\n    domainId,\n    new Date().toISOString(),\n    TwinEngine.factScope(domainId, instanceId)\n  )\n  /* 사건이 아닌 것은 상태만 세운다 — 두 길이 같은 규율이다(§`applyMasterData`). */\n  if (masterData.length) TwinEngine.applyMasterData(domainId, instanceId, masterData)\n  const { applied, duplicates } = TwinEngine.ingestLiveResult(domainId, instanceId, accepted, via)\n\n  /*\n   * **나간 지시와 잇는다** — 폐루프. 기다리지 않습니다: 훅의 응답이 이것 때문에 늦으면 보내는 쪽이\n   * 되풀이하고, 그러면 같은 관측이 두 번 옵니다. 실패해도 관측 유입은 멈추지 않습니다.\n   */\n  void settleEffects({ domainId, envelopes: accepted, store: databaseCommandStore() })\n\n  /*\n   * 커널이 받지 못한 수를 이름으로 남깁니다 — 트윈이 멈춘 사이 버려진 레코드를 「통과」로 세면\n   * 화면이 100% 라고 말합니다. 중복으로 걸러진 것은 버려진 것이 아니므로 빼고 셉니다.\n   */\n  const undelivered = Math.max(0, accepted.length - applied - duplicates)\n  TwinEngine.recordIngestResult(domainId, instanceId, records.length, rejected, Date.now(), undelivered, masterData.length)\n\n  /*\n   * 떨어진 것을 **수가 아니라 목록으로** 넘깁니다 — 응답에 실어야 보내는 쪽이 그것만 따로 둘 수\n   * 있습니다. 수만 주면 배치 전체를 다시 보내거나 전부 버리는 두 갈래밖에 없습니다.\n   */\n  /*\n   * **표에 있는 type 인데 시각을 못 읽었으면 그것은 결함이다.** 그 fact 는 자기 시각을 싣기로 되어\n   * 있는데 안 실려 온 것이고, 그대로 두면 ingest 시각이 그 사실의 시각으로 저장된다.\n   *\n   * 표에 없는 type 은 세기만 한다 — 절대값 snapshot 은 polling 순간이 맞는 시각이다.\n   */\n  const wrong = Object.entries(undated ?? {}).filter(([type]) => shouldHaveTime(type))\n  if (wrong.length) {\n    twinWarn(\n      `[twin-ingest] \"${instanceId}\" — 시각을 실어야 하는 fact 가 시각 없이 왔습니다: ` +\n        wrong.map(([t, n]) => `${t} ${n}건`).join(' · ') +\n        `. 그 사실들은 지금 시각으로 저널에 앉습니다`\n    )\n  }\n\n  return {\n    applied,\n    duplicates,\n    vocabulary: masterData.length,\n    rejected,\n    ...(undated && Object.keys(undated).length ? { undated } : {})\n  }\n}\n"]}