@operato/twin-kernel 0.7.57 → 0.7.59

package/dist/face2-adapter.d.ts

@@ -29,6 +29,22 @@ export interface ObjectEventMapping {
      * 사건이 정답을 다시 말해 주고 오차가 쌓이지 않는다(시뮬 `consumeMaterials` 가 택한 것과 같은 규약).
      */
     quantityList?: MapValue;
+    /**
+     * **개체·로트의 마스터데이터** → `ilmd`(EPCIS 2.0 Instance/Lot Master Data).
+     *
+     * ── 왜 뒤늦게 생겼나 (2026-08-24 실측) ─────────────────────────────────────
+     * `quantityList` 와 **똑같은 모양의 결함**이었다: 받는 쪽은 처음부터 준비돼 있는데 **문이 없었다.**
+     * `ObservedReducer` 는 `ilmd` 를 읽어 로트와 소비기한을 세운다(`expiryOf` · `ILMD_ATTR.lot`), 그리고
+     * 이름을 모르는 속성도 버리지 않고 원문으로 든다. 그런데 이 매핑에 자리가 없어서 **커넥터가 그것을
+     * 말할 길이 없었다.**
+     *
+     * 실측(포천): 원본 재고 1,704행 **전부**에 소비기한이 있는데 투영된 상태에는 **0건**이었다. 지난
+     * 재고 950건·59,785kg 이 어디에도 나타나지 않았다 — 화면이 비어 있는 것이 「이상 없음」으로 읽혔다.
+     *
+     * 값은 **객체 그대로** 받는다(`{ 'cbvmda:lotNumber': …, 'cbvmda:itemExpirationDate': … }`). 키 어휘는
+     * 표준(CBV MDA)의 것이고 커널이 `ILMD_ATTR` 로 그 이름을 안다 — 여기서 이름을 다시 정하지 않는다.
+     */
+    ilmd?: MapValue;
     readPoint?: MapValue;
     bizLocation?: MapValue;
 }

package/dist/face2-adapter.js

@@ -99,6 +99,26 @@ function resolveQuantityList(v, record, field, errors) {
     }
     return r.map(x => ({ ...x }));
 }
+/**
+ * 객체 하나를 그대로 꺼낸다 — `ilmd` 처럼 **구조가 곧 값**인 자리.
+ *
+ * `resolve` 는 객체가 오면 오류로 본다(스칼라 자리에 표준 구조를 실은 것이 실제 결함이었다). 여기서는
+ * 반대다: 객체가 맞고 스칼라가 틀렸다. 그래서 함수를 갈라 두고 각자 자기 모양을 단정한다.
+ */
+function resolveObject(v, record, field, errors) {
+    if (v === undefined)
+        return undefined;
+    const r = get(record, v.startsWith('$.') ? v.slice(2) : v);
+    if (r === undefined || r === null)
+        return undefined;
+    if (typeof r !== 'object' || Array.isArray(r)) {
+        errors.push(`${field} 가 객체가 아니다(${v}): ${JSON.stringify(r).slice(0, 80)}`);
+        return undefined;
+    }
+    const o = { ...r };
+    /* 빈 객체는 「말하지 않은 것」이다 — 실으면 소비처가 「마스터데이터가 있는데 비었다」로 읽는다. */
+    return Object.keys(o).length ? o : undefined;
+}
 /** 단일 레코드 → 정규 EPCIS 이벤트 + 매핑에서 드러난 문제(검증은 `ingest` 가 이어서 한다). */
 export function mapRecordChecked(record, mapping, eventTime) {
     const errors = [];
@@ -165,11 +185,13 @@ export function mapRecordChecked(record, mapping, eventTime) {
     if (!epc && !quantityList.length) {
         errors.push('epc 와 quantityList 가 둘 다 비었다 — 개체 식별자나 클래스+수량 중 하나는 있어야 한다');
     }
+    const ilmd = resolveObject(mapping.ilmd, record, 'ilmd', errors);
     return {
         event: objectEvent({
             eventTime, action, bizStep, disposition,
             epcList: epc ? [epc] : [],
             ...(quantityList.length ? { quantityList } : {}),
+            ...(ilmd ? { ilmd } : {}),
             readPoint, bizLocation
         }),
         errors

package/dist/observed-reducer.js

@@ -630,6 +630,26 @@ export class ObservedReducer {
                  * 덮었다**(rack-1 의 100개가 사라지고 합계가 60이 됐다). 로트가 나뉘어 놓이는 것은 일상이다.
                  */
                 const subLotId = `${qe.epcClass}@${loc}`;
+                /*
+                 * ── ★ **이 갈래가 문을 지나지 않았다** (2026-08-24 실측) ──────────────
+                 * 개체 관측은 `stale()` 을 지나는데 **수량 관측은 지나지 않았다.** 둘이 걸려 있었다.
+                 *
+                 * ① **순서 판정이 없었다** — 늦게 온 옛 관측이 최신 수량을 덮는다. 실 연동에서 순서는 뒤집힌다
+                 *    (재시도·큐·배치). 비직렬 자재가 주된 경로인 원본(식품 제조)에서는 이것이 재고의 대부분이다.
+                 *
+                 * ② **트윈의 시계가 밀리지 않았다** — `stale()` 이 관측 시각을 기억하는 유일한 자리이고
+                 *    (`observedAtMs`), `nowMs` 가 그 값을 「지금」으로 쓴다. 그래서 포천 미러는 재고 관측이
+                 *    오늘 시각으로 계속 들어오는데도 `nowTime` 이 **2026-04-15 에 멈춰 있었다** — 시계를 밀던
+                 *    유일한 스트림(공정·로트)이 4월에 멈춘 것이다. 그 결과 주의 신호의 지속시간이 언제나 0 이고,
+                 *    시각으로 재는 모든 판단이 조용히 틀렸다.
+                 *
+                 * 에너지 경로가 같은 문을 우회해 같은 사고가 났고(2026-08-18) 그때 `noteObservedAt` 을 냈다.
+                 * **세 번째다.** 축을 늘릴 때 이 문을 지나는지 보는 것이 규율이다.
+                 *
+                 * 키에 서브로트를 넣는다 — 같은 로트의 다른 자리가 서로를 막지 않아야 한다(§`subLotId`).
+                 */
+                if (envelope && this.stale(`item:${subLotId}`, envelope))
+                    continue;
                 this.items.set(subLotId, this.mergeItem(qe.epcClass, { location: loc, disposition: ev.disposition, ilmd: ev.ilmd }, qe, mine, subLotId));
             }
         }

package/dist-cjs/index.cjs

@@ -1812,6 +1812,7 @@ var ObservedReducer = class {
         if (!qe?.epcClass) continue;
         const mine = all.filter((x) => x.epcClass === qe.epcClass);
         const subLotId = `${qe.epcClass}@${loc}`;
+        if (envelope && this.stale(`item:${subLotId}`, envelope)) continue;
         this.items.set(subLotId, this.mergeItem(qe.epcClass, { location: loc, disposition: ev.disposition, ilmd: ev.ilmd }, qe, mine, subLotId));
       }
     }
@@ -3188,6 +3189,17 @@ function resolveQuantityList(v, record, field, errors) {
   }
   return r.map((x) => ({ ...x }));
 }
+function resolveObject(v, record, field, errors) {
+  if (v === void 0) return void 0;
+  const r = get(record, v.startsWith("$.") ? v.slice(2) : v);
+  if (r === void 0 || r === null) return void 0;
+  if (typeof r !== "object" || Array.isArray(r)) {
+    errors.push(`${field} \uAC00 \uAC1D\uCCB4\uAC00 \uC544\uB2C8\uB2E4(${v}): ${JSON.stringify(r).slice(0, 80)}`);
+    return void 0;
+  }
+  const o = { ...r };
+  return Object.keys(o).length ? o : void 0;
+}
 function mapRecordChecked(record, mapping, eventTime) {
   const errors = [];
   const bizStep = resolve(mapping.bizStep, record, "bizStep", errors) ?? "";
@@ -3251,6 +3263,7 @@ function mapRecordChecked(record, mapping, eventTime) {
   if (!epc && !quantityList.length) {
     errors.push("epc \uC640 quantityList \uAC00 \uB458 \uB2E4 \uBE44\uC5C8\uB2E4 \u2014 \uAC1C\uCCB4 \uC2DD\uBCC4\uC790\uB098 \uD074\uB798\uC2A4+\uC218\uB7C9 \uC911 \uD558\uB098\uB294 \uC788\uC5B4\uC57C \uD55C\uB2E4");
   }
+  const ilmd = resolveObject(mapping.ilmd, record, "ilmd", errors);
   return {
     event: objectEvent({
       eventTime,
@@ -3259,6 +3272,7 @@ function mapRecordChecked(record, mapping, eventTime) {
       disposition,
       epcList: epc ? [epc] : [],
       ...quantityList.length ? { quantityList } : {},
+      ...ilmd ? { ilmd } : {},
       readPoint,
       bizLocation
     }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operato/twin-kernel",
-  "version": "0.7.57",
+  "version": "0.7.59",
   "type": "module",
   "description": "Twin Domain Kernel — framework-agnostic, zero-dep (domain + sim + 3-channel contract). WMS/YMS/MES, EPCIS 2.0 · ISA-95.",
   "publishConfig": {