@operato/twin-kernel 0.11.12 → 0.11.14

package/dist/flow-engine.d.ts

@@ -1,4 +1,4 @@
-import type { MaterialActual, TestResult, ISOTime, MaterialQuantity, WorkCalendarEntry, EffectivePeriod, Effectivity, OffCalendarReason, ResourceProperty, ResourceClassDef, MaterialDefinition, Attention, TwinModelDef, CanonicalEnvelope, Command, CommandAck, EventHandler, EquipmentMotion, AssetState, GeneratorSpec, InterventionOutcome, OrderState, PersonState, ScenarioControl, ScenarioOverride, StateSnapshot, TwinKernel, Unsubscribe, LocationState, ItemState, EquipmentState, OrderStatusDelta, TaskState, TaskStatus, StructureShift, IdentityGroundingView, IdentityDeclaration, TestSpecificationCriterion, LocationObservation } from '@operato/ops-contract';
+import type { MaterialActual, TestResult, ISOTime, MaterialQuantity, WorkCalendarEntry, EffectivePeriod, Effectivity, OffCalendarReason, ResourceProperty, ResourceClassDef, MaterialDefinition, Attention, TwinModelDef, CanonicalEnvelope, Command, CommandAck, EventHandler, EquipmentMotion, AssetState, GeneratorSpec, InterventionOutcome, OrderState, PersonState, ScenarioControl, ScenarioOverride, StateSnapshot, TwinKernel, Unsubscribe, LocationState, ItemState, EquipmentState, OrderStatusDelta, TaskState, TaskStatus, StructureShift, IdentityGroundingView, IdentityDeclaration, TestSpecificationCriterion, LocationObservation, DispositionFact } from '@operato/ops-contract';
 import { type RatedUsage, type UsedUsage } from '@operato/ops-contract';
 import type { VocabularyElement } from '@operato/ops-contract';
 import type { ReducerCheckpoint } from './observed-reducer.ts';
@@ -46,6 +46,13 @@ export interface FlowItem {
     ilmd?: Record<string, unknown>;
     /** 선언된 모든 수량 — 표준 `MaterialLot.Quantity`(복수). 관측에서 온 물품이 여러 단위를 들 수 있다. */
     quantities?: MaterialQuantity[];
+    /**
+     * 로트의 두 표준 칸 — ISA-95 `Disposition`(`nonconformance`) · `Status`(`status`). 관측 모드에서 리듀서가
+     * 앉힌 것을 `settleObserved` 가 옮기고 `itemState` 가 스냅샷에 낸다. 둘 중 하나가 빠지면 리듀서에는 있는데
+     * 화면에는 없는 칸이 된다(2026-09-16 에 둘 다 그랬다).
+     */
+    nonconformance?: DispositionFact;
+    status?: string;
 }
 /** 물리 자산 — 반복사용(팔레트·랙·용기). 설비도 물품도 아니다(GRAI vs SSCC 구분은 계약 주석 참조). */
 export interface FlowAsset extends EffectivePeriod {

package/dist/flow-engine.js

@@ -1034,7 +1034,14 @@ export class FlowEngine {
                 ...(it.subLotId ? { subLotId: it.subLotId } : {}),
                 ...(it.definitionId ? { definitionId: it.definitionId } : {}),
                 gtin: it.gtin, qty: it.qty ?? 1, uom: it.uom, ...(it.quantities?.length ? { quantities: it.quantities } : {}),
-                parent: it.parent, carriedBy: it.carriedBy, expiry: it.expiry, ilmd: it.ilmd
+                parent: it.parent, carriedBy: it.carriedBy, expiry: it.expiry, ilmd: it.ilmd,
+                /*
+                 * 로트의 두 표준 칸 — ISA-95 `Disposition`(`nonconformance`)과 `Status`(`status`). 이 복사가 칸을 하나씩
+                 * 옮기는 자리라, 여기 없는 칸은 리듀서에 앉았어도 **스냅샷에 나오지 않는다**(2026-09-16 에 `status` 를
+                 * 넣다가 `nonconformance` 도 여기서 빠져 있던 것을 찾았다 — 자리는 있고 길이 없는 부류). 있을 때만 옮긴다.
+                 */
+                ...(it.nonconformance ? { nonconformance: it.nonconformance } : {}),
+                ...(it.status ? { status: it.status } : {})
             });
         }
         for (const m of snap.equipment) {
@@ -3869,7 +3876,10 @@ export class FlowEngine {
             ...(i.uom ? { uom: i.uom } : {}),
             ...(i.quantities?.length ? { quantities: i.quantities } : {}),
             ...(i.expiry !== undefined ? { expiry: i.expiry } : {}),
-            ...(i.ilmd ? { ilmd: i.ilmd } : {})
+            ...(i.ilmd ? { ilmd: i.ilmd } : {}),
+            /* 로트의 두 표준 칸(§FlowItem) — 여기서 빠지면 리듀서·엔진에는 있고 스냅샷에는 없다. */
+            ...(i.nonconformance ? { nonconformance: i.nonconformance } : {}),
+            ...(i.status ? { status: i.status } : {})
         };
     }
     /**

package/dist/observed-reducer.js

@@ -573,11 +573,12 @@ export class ObservedReducer {
                  * 않는다** — 모르는 로트의 상태는 `unhandled` 로 세어서 낸다.
                  */
                 const d = e.data;
-                if (!d?.epc || !d?.status)
+                if (!d?.lotId || !d?.status)
                     break;
-                if (this.stale(`material-lot:${d.epc}`, e))
+                if (this.stale(`material-lot:${d.lotId}`, e))
                     return;
-                const parts = [...this.items.values()].filter(i => i.epc === d.epc);
+                /* `lotId` 는 표준 `MaterialLotID` — 값은 로트의 식별자, 즉 여기서 `epc` 로 든 것과 같다. */
+                const parts = [...this.items.values()].filter(i => i.epc === d.lotId);
                 if (!parts.length) {
                     this.noteUnhandled(e, `${OP_EVENT.materialLot}:unknown-lot`);
                     break;

package/dist-cjs/index.cjs

@@ -668,6 +668,7 @@ var OP_EVENT = {
    * 접지 않는다 — 승인됐는데 안 나간 배치가 트윈이 보여야 할 상태다.
    */
   materialLot: "material-lot.status",
+  // 레코드: { lotId(표준 MaterialLotID = ItemState.epc 의 값), status, decidedBy?, reason?, decidedAt? }
   /**
    * **이 목록이 전부다** — 연결된 시스템이 현재 목록을 한 바퀴 다 보낸 뒤 그것을 알린다.
    *
@@ -1043,14 +1044,8 @@ var MES_BIZSTEP = {
   // 원자재 수령
   producing: "urn:epcglobal:cbv:bizstep:commissioning",
   // 생산(제품 최초 생성)
-  storing: "urn:epcglobal:cbv:bizstep:storing",
+  storing: "urn:epcglobal:cbv:bizstep:storing"
   // 완제품 저장
-  /**
-   * **출하** — CBV `shipping`: 물품이 시설을 떠난다. 자재를 트윈 밖으로 내는 것은 이 사건이다(disposition
-   * `in_transit`, readPoint = 출하 dock). 출하 **승인**은 이 사건이 아니라 로트 상태(`OP_EVENT.materialLot`)다 —
-   * 승인됐는데 안 나간 배치가 보여야 한다(2026-09-16, ADR-0046 곁).
-   */
-  shipping: "urn:epcglobal:cbv:bizstep:shipping"
 };
 var BTT_PRODORDER = "urn:epcglobal:cbv:btt:prodorder";
 function sgtinUri(companyPrefix, itemRef, serial) {
@@ -2065,17 +2060,19 @@ var SPECS = {
   /*
    * **로트 상태** — ISA-95 `MaterialLot.Status`. 출하 승인(batch release)이 들어오는 문(§`OP_EVENT.materialLot`).
    *
-   * `disposition`(subjectId + decision) 과 필드가 겹치지 않는다 — 여기는 `epc` + `status`. 상태 낱말은 열려
-   * 있어 enum 이 없다(오더 상태와 같은 규율). 로트 전체의 사실이므로 `subLotId` 는 받지 않는다 — 부분마다 다른
-   * 상태가 필요해지면 그것은 다른 사실이다.
+   * `disposition`(subjectId + decision) 과 필드가 겹치지 않는다 — 여기는 `lotId` + `status`. 정체 이름이 표준
+   * `MaterialLotID` 인 이유가 하나 더 있다: 이 문은 `epc` 를 든 레코드를 EPCIS 어휘로 보고 받지 않는다
+   * (§`operationalKindOf`). 값은 로트의 식별자(`ItemState.epc` 와 같은 값)다. 상태 낱말은 열려 있어 enum 이
+   * 없다(오더 상태와 같은 규율). 로트 전체의 사실이므로 부분(`subLotId`)은 받지 않는다 — 부분마다 다른 상태가
+   * 필요해지면 그것은 다른 사실이다.
    */
   "material-lot": {
     eventType: OP_EVENT.materialLot,
-    match: ["epc", "status"],
+    match: ["lotId", "status"],
     matchOrder: 85,
-    identity: "epc",
-    required: ["epc", "status"],
-    fields: { epc: "string", status: "string", decidedBy: "string", reason: "string", decidedAt: "string", recordTime: "string" }
+    identity: "lotId",
+    required: ["lotId", "status"],
+    fields: { lotId: "string", status: "string", decidedBy: "string", reason: "string", decidedAt: "string", recordTime: "string" }
   },
   test: {
     eventType: OP_EVENT.test,
@@ -2921,9 +2918,9 @@ var ObservedReducer = class {
       }
       case OP_EVENT.materialLot: {
         const d = e.data;
-        if (!d?.epc || !d?.status) break;
-        if (this.stale(`material-lot:${d.epc}`, e)) return;
-        const parts = [...this.items.values()].filter((i) => i.epc === d.epc);
+        if (!d?.lotId || !d?.status) break;
+        if (this.stale(`material-lot:${d.lotId}`, e)) return;
+        const parts = [...this.items.values()].filter((i) => i.epc === d.lotId);
         if (!parts.length) {
           this.noteUnhandled(e, `${OP_EVENT.materialLot}:unknown-lot`);
           break;
@@ -4367,7 +4364,14 @@ var FlowEngine = class {
         parent: it.parent,
         carriedBy: it.carriedBy,
         expiry: it.expiry,
-        ilmd: it.ilmd
+        ilmd: it.ilmd,
+        /*
+         * 로트의 두 표준 칸 — ISA-95 `Disposition`(`nonconformance`)과 `Status`(`status`). 이 복사가 칸을 하나씩
+         * 옮기는 자리라, 여기 없는 칸은 리듀서에 앉았어도 **스냅샷에 나오지 않는다**(2026-09-16 에 `status` 를
+         * 넣다가 `nonconformance` 도 여기서 빠져 있던 것을 찾았다 — 자리는 있고 길이 없는 부류). 있을 때만 옮긴다.
+         */
+        ...it.nonconformance ? { nonconformance: it.nonconformance } : {},
+        ...it.status ? { status: it.status } : {}
       });
     }
     for (const m of snap.equipment) {
@@ -6774,7 +6778,10 @@ var FlowEngine = class {
       ...i.uom ? { uom: i.uom } : {},
       ...i.quantities?.length ? { quantities: i.quantities } : {},
       ...i.expiry !== void 0 ? { expiry: i.expiry } : {},
-      ...i.ilmd ? { ilmd: i.ilmd } : {}
+      ...i.ilmd ? { ilmd: i.ilmd } : {},
+      /* 로트의 두 표준 칸(§FlowItem) — 여기서 빠지면 리듀서·엔진에는 있고 스냅샷에는 없다. */
+      ...i.nonconformance ? { nonconformance: i.nonconformance } : {},
+      ...i.status ? { status: i.status } : {}
     };
   }
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operato/twin-kernel",
-  "version": "0.11.12",
+  "version": "0.11.14",
   "type": "module",
   "description": "Twin Domain Kernel — framework-agnostic, zero-dep (domain + sim + 3-channel contract). WMS/YMS/MES, EPCIS 2.0 · ISA-95.",
   "publishConfig": {
@@ -28,6 +28,6 @@
     "test": "node --test test/*.test.ts"
   },
   "dependencies": {
-    "@operato/ops-contract": "^0.9.20"
+    "@operato/ops-contract": "^0.9.22"
   }
 }