@operato/twin-kernel 0.11.12 → 0.11.15

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/kernel.js

@@ -9,7 +9,7 @@ import { CMD } from '@operato/ops-contract';
 import { firstFitPolicy } from "./allocation-policy.js";
 import { FlowEngine } from "./flow-engine.js";
 import { planMakeToOrder } from "./make-to-order.js";
-import { BIZSTEP, BTT } from '@operato/ops-contract';
+import { BIZSTEP, BTT, WMS_ORDER_KIND } from '@operato/ops-contract';
 import { DISP, ILMD_ATTR, aggregationEvent, objectEvent, transactionEvent } from '@operato/ops-contract';
 import { subLotIdOf, itemKeyOf } from '@operato/ops-contract';
 const TRAVEL_MS = 30_000;
@@ -133,7 +133,7 @@ export class WmsKernel extends FlowEngine {
         const so = this.requireBizTransactionId(`SO-${soSeq}`, 'salesorder');
         const requested = lines.reduce((s, l) => s + l.qty, 0);
         const order = {
-            id, kind: 'outbound', status: 'created', requested, fulfilled: 0, bizTransaction: so,
+            id, kind: WMS_ORDER_KIND.outbound, status: 'created', requested, fulfilled: 0, bizTransaction: so,
             allocated: [], picked: [], shipmentEpc: null, lines: lines.map(l => ({ gtin: l.gtin, requested: l.qty })),
             ...(spec ? this.promiseOf(spec) : {})
         };
@@ -175,7 +175,7 @@ export class WmsKernel extends FlowEngine {
         /* 할당은 아직 집은 것이 아니다 — 물건은 보관 자리에 있고 처분만 '예약' 으로 바뀐다.
          * 그래서 단계는 storing 이다(피킹 관측은 실제로 집을 때 따로 난다). */
         this.reserve(chosenAll, BIZSTEP.storing);
-        this.emit(transactionEvent({ eventTime: this.now(), action: 'ADD', bizStep: BIZSTEP.picking, bizTransactionList: [{ type: BTT.so, bizTransaction: o.bizTransaction }], epcList: chosenAll.slice() }));
+        this.emit(transactionEvent({ eventTime: this.now(), action: 'ADD', bizStep: BIZSTEP.picking, bizTransactionList: [{ type: BTT.poc, bizTransaction: o.bizTransaction }], epcList: chosenAll.slice() }));
         for (const epc of chosenAll) {
             const it = this.items.get(epc);
             const id = `task-${++this.taskSeq}`;
@@ -363,7 +363,7 @@ export class WmsKernel extends FlowEngine {
         const shpSeq = ++this.epcSeq;
         const shipment = this.requireObjectId(`SHP-${shpSeq}`);
         order.shipmentEpc = shipment;
-        const soTxn = [{ type: BTT.so, bizTransaction: order.bizTransaction }];
+        const soTxn = [{ type: BTT.poc, bizTransaction: order.bizTransaction }];
         // 패킹: 화물(shipment) ← 팔레트 조립(merge). 팔레트는 출하 DELETE 까지 독립 유지 → consume 없음.
         this.aggregate(shipment, order.picked.slice(), { bizStep: BIZSTEP.packing, readPoint: staging.id, bizLocation: staging.id });
         order.status = 'packed';

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/yms-kernel.js

@@ -19,7 +19,7 @@ import { itemKeyOf } from '@operato/ops-contract';
 import { firstFitPolicy } from "./allocation-policy.js";
 import { FlowEngine } from "./flow-engine.js";
 import { DISP, objectEvent, transactionEvent } from '@operato/ops-contract';
-import { YARD_BIZSTEP, BTT_DELIVERY } from '@operato/ops-contract';
+import { YARD_BIZSTEP } from '@operato/ops-contract';
 const TRAVEL_MS = 20_000; // 야드 이동
 const DWELL_MS = 30_000; // 도크 체류(상·하차) — depart 이동에 folded
 const WINDOW_DELAY_MS = 40_000; // 도착 후 어포인트먼트 창까지(early arrival → 대기)
@@ -149,7 +149,7 @@ export class YmsKernel extends FlowEngine {
             this.trailerCargo.set(trailer.epc, avail.slice(0, CARGO_PER_TRAILER).map(i => i.epc));
         }
         this.reserve([trailer.epc], bizStep); // 처분 변화를 이벤트로 — 미러가 "잡혔다" 를 알 수 있게
-        this.emit(transactionEvent({ eventTime: this.now(), action: 'ADD', bizStep, bizTransactionList: [{ type: BTT_DELIVERY, bizTransaction: o.bizTransaction }], epcList: [trailer.epc], readPoint: door.id }));
+        this.emit(transactionEvent({ eventTime: this.now(), action: 'ADD', bizStep, bizTransactionList: [{ bizTransaction: o.bizTransaction }], epcList: [trailer.epc], readPoint: door.id }));
         // drop: 야드→도크 pull. live: 게이트→도크 직행(spot-live). 둘 다 toNode=도크도어.
         const dockKind = mode === 'drop' ? 'pull' : 'spot-live';
         const task = { id: `task-${++this.taskSeq}`, kind: dockKind, status: 'created', itemEpc: trailer.epc, fromNode: trailer.location, toNode: door.id, resource: null, remainingMs: 0, durationMs: this.durationOf({ kind: dockKind, fromNode: trailer.location, toNode: door.id }, TRAVEL_MS), orderId: o.id };

package/dist-cjs/index.cjs

@@ -668,6 +668,7 @@ var OP_EVENT = {
    * 접지 않는다 — 승인됐는데 안 나간 배치가 트윈이 보여야 할 상태다.
    */
   materialLot: "material-lot.status",
+  // 레코드: { lotId(표준 MaterialLotID = ItemState.epc 의 값), status, decidedBy?, reason?, decidedAt? }
   /**
    * **이 목록이 전부다** — 연결된 시스템이 현재 목록을 한 바퀴 다 보낸 뒤 그것을 알린다.
    *
@@ -992,8 +993,28 @@ var BIZSTEP = {
   replenishing: "urn:epcglobal:cbv:bizstep:replenishing"
 };
 var BTT = {
+  /** Purchase Order — the document an inbound receipt is made against. */
   po: "urn:epcglobal:cbv:btt:po",
-  so: "urn:epcglobal:cbv:btt:so"
+  /** Purchase Order Confirmation — the seller's sales order. */
+  poc: "urn:epcglobal:cbv:btt:poc",
+  /** Despatch Advice (ASN) — announces an inbound delivery; also attached when shipping. */
+  desadv: "urn:epcglobal:cbv:btt:desadv",
+  /** Receiving Advice — the reply once an inbound receipt is complete. */
+  recadv: "urn:epcglobal:cbv:btt:recadv",
+  /** Return Merchandise Authorization — what a return is received against. */
+  rma: "urn:epcglobal:cbv:btt:rma",
+  /** Bill of Lading — the carrier's document, attached when shipping. */
+  bol: "urn:epcglobal:cbv:btt:bol"
+};
+var WMS_ORDER_KIND = {
+  /** Expected receipt (ASN). The kernel has no inbound order yet — arrival carries a `po` without one. */
+  inbound: "inbound",
+  /** Outbound order — what the kernel's sales order is. */
+  outbound: "outbound",
+  /** Receipt of returned goods. */
+  return: "return",
+  /** Stock transfer between sites. CBV has no document type for it: carry the id without a type. */
+  transfer: "transfer"
 };
 var WMS_LOCATION_TYPES = ["dock", "storage", "staging", "dock-ship", "vas-station"];
 var WMS_LOCATION_LEVEL = {
@@ -1024,7 +1045,6 @@ var YARD_BIZSTEP = {
   departing: "urn:epcglobal:cbv:bizstep:departing"
   // 게이트-아웃
 };
-var BTT_DELIVERY = "urn:epcglobal:cbv:btt:deliv";
 var YMS_LOCATION_TYPES = ["gate", "yard-slot", "dock-door", "staging"];
 var YMS_LOCATION_LEVEL = {
   gate: "Other",
@@ -1043,14 +1063,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 +2079,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 +2937,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 +4383,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 +6797,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 } : {}
     };
   }
   /**
@@ -7123,7 +7149,7 @@ var WmsKernel = class extends FlowEngine {
     const requested = lines.reduce((s, l) => s + l.qty, 0);
     const order = {
       id,
-      kind: "outbound",
+      kind: WMS_ORDER_KIND.outbound,
       status: "created",
       requested,
       fulfilled: 0,
@@ -7159,7 +7185,7 @@ var WmsKernel = class extends FlowEngine {
     }
     if (chosenAll.length === 0) return this.makeShortLines(o);
     this.reserve(chosenAll, BIZSTEP.storing);
-    this.emit(transactionEvent({ eventTime: this.now(), action: "ADD", bizStep: BIZSTEP.picking, bizTransactionList: [{ type: BTT.so, bizTransaction: o.bizTransaction }], epcList: chosenAll.slice() }));
+    this.emit(transactionEvent({ eventTime: this.now(), action: "ADD", bizStep: BIZSTEP.picking, bizTransactionList: [{ type: BTT.poc, bizTransaction: o.bizTransaction }], epcList: chosenAll.slice() }));
     for (const epc of chosenAll) {
       const it = this.items.get(epc);
       const id = `task-${++this.taskSeq}`;
@@ -7310,7 +7336,7 @@ var WmsKernel = class extends FlowEngine {
     const shpSeq = ++this.epcSeq;
     const shipment = this.requireObjectId(`SHP-${shpSeq}`);
     order.shipmentEpc = shipment;
-    const soTxn = [{ type: BTT.so, bizTransaction: order.bizTransaction }];
+    const soTxn = [{ type: BTT.poc, bizTransaction: order.bizTransaction }];
     this.aggregate(shipment, order.picked.slice(), { bizStep: BIZSTEP.packing, readPoint: staging.id, bizLocation: staging.id });
     order.status = "packed";
     this.emit(objectEvent({ eventTime, action: "OBSERVE", bizStep: BIZSTEP.staging_outbound, disposition: DISP.reserved, epcList: [shipment], readPoint: staging.id, bizLocation: staging.id, bizTransactionList: soTxn }));
@@ -7450,7 +7476,7 @@ var YmsKernel = class extends FlowEngine {
       this.trailerCargo.set(trailer.epc, avail.slice(0, CARGO_PER_TRAILER).map((i) => i.epc));
     }
     this.reserve([trailer.epc], bizStep);
-    this.emit(transactionEvent({ eventTime: this.now(), action: "ADD", bizStep, bizTransactionList: [{ type: BTT_DELIVERY, bizTransaction: o.bizTransaction }], epcList: [trailer.epc], readPoint: door.id }));
+    this.emit(transactionEvent({ eventTime: this.now(), action: "ADD", bizStep, bizTransactionList: [{ bizTransaction: o.bizTransaction }], epcList: [trailer.epc], readPoint: door.id }));
     const dockKind = mode === "drop" ? "pull" : "spot-live";
     const task = { id: `task-${++this.taskSeq}`, kind: dockKind, status: "created", itemEpc: trailer.epc, fromNode: trailer.location, toNode: door.id, resource: null, remainingMs: 0, durationMs: this.durationOf({ kind: dockKind, fromNode: trailer.location, toNode: door.id }, TRAVEL_MS2), orderId: o.id };
     this.tasks.set(task.id, task);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operato/twin-kernel",
-  "version": "0.11.12",
+  "version": "0.11.15",
   "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.24"
   }
 }