@operato/twin-kernel 0.11.3 → 0.11.4

package/dist/observed-reducer.d.ts

@@ -50,6 +50,18 @@ export interface MasterUpdate {
 }
 export interface ProjectedState {
     revision: number;
+    /**
+     * **지금 아는 어휘 항목 수** — 「무엇을 알고 있나」를 밖에서 잴 수 있게.
+     *
+     * ── 왜 수만 내나 (2026-09-05) ─────────────────────────────────────────────
+     * 어휘 표 자체는 클 수 있다(로트는 계속 새로 생긴다 — 하루 수백이면 1년에 수십만). 그것을 매
+     * 스냅샷에 통째로 실으면 스냅샷이 그 표의 크기를 따라간다.
+     *
+     * 그래서 여기는 **수**만 낸다. 내용은 대상 하나씩 `masterDataOf()` 로 묻는다.
+     *
+     * 0 이 아니라 없을 수도 있다 — 어휘를 한 번도 안 받은 트윈에는 이 칸이 없다.
+     */
+    masterDataSize?: number;
     /**
      * 받은 정정 선언들 — 상태에 반영하지 않은 것을 **밝힌다**.
      * 비어 있지 않으면 "원 시스템이 정정을 보냈고 우리는 아직 반영하지 못했다" 는 뜻이다(조용한 무시 금지).
@@ -407,6 +419,20 @@ export declare class ObservedReducer {
      * 비직렬 재고는 물품의 키가 곧 클래스 식별자다. 직렬 개체는 클래스가 따로 있다. 두 모양이 다 오므로
      * 둘 다 본다 — 한쪽만 보면 그 원본에서는 값이 조용히 비어 있게 된다.
      */
+    /**
+     * **이 클래스에 대해 아는 것** — 수량으로만 말하는 원본에서 로트 어휘를 읽는 길.
+     *
+     * ── 왜 필요한가 (인티그레이션 레인이 올림, 2026-09-05) ─────────────────────
+     * 어휘 요소(로트 번호·소비기한)는 들어와서 `classMaster` 에 앉고 검사점에도 실린다. 그런데
+     * **밖에서 물을 길이 없었다** — `masterAttributesOf` 는 사적이고, 물품을 꾸미는 데만 쓰였다.
+     *
+     * 그리고 그 꾸미기는 **이미 서 있는 물품만** 다시 센다. 낱개에 일련번호를 안 붙이는 원본은
+     * `epcList` 를 비워 보내므로 걸릴 물품이 아예 없고, 그러면 로트 번호·소비기한이 **올 리 없는
+     * 물품을 기다린다.** 잃지는 않는데 아무도 안 본다.
+     *
+     * 그 원본에서는 **클래스가 주어**다. 물품이 아니라 클래스에게 물어야 답이 나온다.
+     */
+    masterDataOf(classUri: string | undefined): Record<string, unknown> | undefined;
     private masterAttributesOf;
     /**
      * **마스터데이터를 받는다** — 어휘 요소의 속성을 상태에 세운다(§`master-data`).

package/dist/observed-reducer.js

@@ -991,6 +991,22 @@ export class ObservedReducer {
      * 비직렬 재고는 물품의 키가 곧 클래스 식별자다. 직렬 개체는 클래스가 따로 있다. 두 모양이 다 오므로
      * 둘 다 본다 — 한쪽만 보면 그 원본에서는 값이 조용히 비어 있게 된다.
      */
+    /**
+     * **이 클래스에 대해 아는 것** — 수량으로만 말하는 원본에서 로트 어휘를 읽는 길.
+     *
+     * ── 왜 필요한가 (인티그레이션 레인이 올림, 2026-09-05) ─────────────────────
+     * 어휘 요소(로트 번호·소비기한)는 들어와서 `classMaster` 에 앉고 검사점에도 실린다. 그런데
+     * **밖에서 물을 길이 없었다** — `masterAttributesOf` 는 사적이고, 물품을 꾸미는 데만 쓰였다.
+     *
+     * 그리고 그 꾸미기는 **이미 서 있는 물품만** 다시 센다. 낱개에 일련번호를 안 붙이는 원본은
+     * `epcList` 를 비워 보내므로 걸릴 물품이 아예 없고, 그러면 로트 번호·소비기한이 **올 리 없는
+     * 물품을 기다린다.** 잃지는 않는데 아무도 안 본다.
+     *
+     * 그 원본에서는 **클래스가 주어**다. 물품이 아니라 클래스에게 물어야 답이 나온다.
+     */
+    masterDataOf(classUri) {
+        return classUri ? this.classMaster.attributesOf(classUri) : undefined;
+    }
     masterAttributesOf(classUri, epc) {
         return this.classMaster.attributesOf(classUri) ?? this.classMaster.attributesOf(epc);
     }
@@ -1303,6 +1319,7 @@ export class ObservedReducer {
             occ.set(it.location, (occ.get(it.location) ?? 0) + 1);
         return {
             revision: this.revision,
+            ...(this.classMaster.size ? { masterDataSize: this.classMaster.size } : {}),
             ...(this.corrections.length ? { corrections: this.corrections.map(c => ({ ...c })) } : {}),
             ...(this.unhandled.size
                 ? { unhandled: [...this.unhandled.entries()].map(([eventType, v]) => ({ eventType, ...v })).sort((a, b) => b.count - a.count) }

package/dist-cjs/index.cjs

@@ -3083,6 +3083,22 @@ var ObservedReducer = class {
    * 비직렬 재고는 물품의 키가 곧 클래스 식별자다. 직렬 개체는 클래스가 따로 있다. 두 모양이 다 오므로
    * 둘 다 본다 — 한쪽만 보면 그 원본에서는 값이 조용히 비어 있게 된다.
    */
+  /**
+   * **이 클래스에 대해 아는 것** — 수량으로만 말하는 원본에서 로트 어휘를 읽는 길.
+   *
+   * ── 왜 필요한가 (인티그레이션 레인이 올림, 2026-09-05) ─────────────────────
+   * 어휘 요소(로트 번호·소비기한)는 들어와서 `classMaster` 에 앉고 검사점에도 실린다. 그런데
+   * **밖에서 물을 길이 없었다** — `masterAttributesOf` 는 사적이고, 물품을 꾸미는 데만 쓰였다.
+   *
+   * 그리고 그 꾸미기는 **이미 서 있는 물품만** 다시 센다. 낱개에 일련번호를 안 붙이는 원본은
+   * `epcList` 를 비워 보내므로 걸릴 물품이 아예 없고, 그러면 로트 번호·소비기한이 **올 리 없는
+   * 물품을 기다린다.** 잃지는 않는데 아무도 안 본다.
+   *
+   * 그 원본에서는 **클래스가 주어**다. 물품이 아니라 클래스에게 물어야 답이 나온다.
+   */
+  masterDataOf(classUri) {
+    return classUri ? this.classMaster.attributesOf(classUri) : void 0;
+  }
   masterAttributesOf(classUri, epc) {
     return this.classMaster.attributesOf(classUri) ?? this.classMaster.attributesOf(epc);
   }
@@ -3352,6 +3368,7 @@ var ObservedReducer = class {
     for (const it of this.items.values()) occ.set(it.location, (occ.get(it.location) ?? 0) + 1);
     return {
       revision: this.revision,
+      ...this.classMaster.size ? { masterDataSize: this.classMaster.size } : {},
       ...this.corrections.length ? { corrections: this.corrections.map((c) => ({ ...c })) } : {},
       ...this.unhandled.size ? { unhandled: [...this.unhandled.entries()].map(([eventType, v]) => ({ eventType, ...v })).sort((a, b) => b.count - a.count) } : {},
       locations: [...this.master.values()].map((n) => {

package/package.json

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