@operato/twin-kernel 0.11.26 → 0.11.27

package/dist/flow-engine.d.ts

@@ -29,7 +29,11 @@ export interface FlowLocation {
 export interface FlowItem {
     epc: string;
     location: string;
-    disposition: string;
+    /**
+     * CBV disposition. Optional, as in EPCIS: a yard trailer carries none — CBV 2.0 has no disposition for an
+     * asset waiting in a yard, and `bizStep: staging` already says it waits (ADR-0050 ruling, 2026-09-24).
+     */
+    disposition?: string;
     /** 무슨 품목인가 — 표준 `MaterialLot.MaterialDefinitionID`. 보통은 `gtin` 이 곧 정의 id 라 비어 있다. */
     definitionId?: string;
     /** 로트의 부분(표준 `MaterialSubLot.ID`) — 비직렬 로트가 자리마다 갈릴 때. */

package/dist/flow-engine.js

@@ -15,7 +15,7 @@ import { ObservedReducer } from "./observed-reducer.js";
 /* 주체를 정하는 규칙은 유입 문과 한 벌이다 — 두 곳에 적으면 한쪽만 고쳐진다. */
 import { resolveSubject } from '@operato/ops-contract';
 import { WMS_ORDER_KIND } from '@operato/ops-contract';
-import { transformationEvent, aggregationEvent, objectEvent, parseEpc, DISP, ILMD_ATTR, CBV_BIZSTEP, objectUri, bizTransactionUri, gdtiUri } from '@operato/ops-contract';
+import { transformationEvent, aggregationEvent, objectEvent, parseEpc, DISP, ILMD_ATTR, CBV_BIZSTEP, PRIVATE_BIZSTEP, objectUri, bizTransactionUri, gdtiUri } from '@operato/ops-contract';
 import { allocationPolicyOf } from "./allocation-policy.js";
 import { ORDER_FOLD_DEFAULT, emptyFoldedOrders, foldOrdersInto, foldedOrderCount, pruneFoldedHours, orderFoldPolicyOf, planOrderFold } from '@operato/ops-contract';
 import { OP_PARAM } from '@operato/ops-contract';
@@ -3611,7 +3611,7 @@ export class FlowEngine {
                 this.recordMaterialActual(t, it.definitionId ?? it.gtin, 'consumed', take, it.uom, it.epc);
                 /* 남은 수량을 그대로 알린다 — 관측 경로가 그 자리의 사실을 갱신한다(§quantityList). */
                 this.emit(objectEvent({
-                    eventTime: this.now(), action: 'OBSERVE', bizStep: CBV_BIZSTEP.consuming, disposition: DISP.in_progress,
+                    eventTime: this.now(), action: 'OBSERVE', bizStep: PRIVATE_BIZSTEP.consuming, disposition: DISP.in_progress,
                     epcList: [], quantityList: [{ epcClass: it.gtin ?? it.epc, quantity: left, uom: it.uom }],
                     readPoint: it.location, bizLocation: it.location
                 }));
@@ -3639,7 +3639,7 @@ export class FlowEngine {
              * 다른 작업이 같은 물품을 또 잡지 못하게 한다 — 소비 시점은 시작인데 변환은 완료 시점이라 그
              * 사이가 열려 있다. **변환 중**으로 표시한다(상태와 사건을 한 번에 — §`observeDisposition`).
              */
-            this.observeDisposition(whole, DISP.in_progress, CBV_BIZSTEP.consuming);
+            this.observeDisposition(whole, DISP.in_progress, PRIVATE_BIZSTEP.consuming);
             return;
         }
         const at = this.items.get(whole[0])?.location ?? t.toNode;
@@ -3654,7 +3654,7 @@ export class FlowEngine {
             this.items.delete(epc);
         }
         this.emit(objectEvent({
-            eventTime: this.now(), action: 'DELETE', bizStep: CBV_BIZSTEP.consuming, disposition: DISP.in_progress,
+            eventTime: this.now(), action: 'DELETE', bizStep: PRIVATE_BIZSTEP.consuming, disposition: DISP.in_progress,
             epcList: whole.slice(), readPoint: at, bizLocation: at
         }));
     }

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 } from '@operato/ops-contract';
+import { YARD_BIZSTEP, YARD_PRIVATE_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 → 대기)
@@ -182,8 +182,13 @@ export class YmsKernel extends FlowEngine {
         }
         if (to.type === 'yard-slot') {
             // drop 주차 — 야드 대기(창 도래까지). 도어는 depart 완료까지 미점유.
-            trailer.disposition = DISP.sellable;
-            this.emit(objectEvent({ eventTime: this.now(), action: 'OBSERVE', bizStep: YARD_BIZSTEP.staging, disposition: DISP.sellable, epcList: [trailer.epc], readPoint: to.id, bizLocation: to.id }));
+            /*
+             * No disposition (ADR-0050 ruling, 2026-09-24). It was `sellable` — "product can be sold as is" — and a
+             * trailer is not product; CBV 2.0 has nothing for an asset waiting in a yard. `staging` says it waits.
+             * The step is ours, not CBV's (YARD_PRIVATE_BIZSTEP, contract 836c308).
+             */
+            delete trailer.disposition;
+            this.emit(objectEvent({ eventTime: this.now(), action: 'OBSERVE', bizStep: YARD_PRIVATE_BIZSTEP.staging, epcList: [trailer.epc], readPoint: to.id, bizLocation: to.id }));
             return;
         }
         if (to.type === 'dock-door') {
@@ -201,7 +206,7 @@ export class YmsKernel extends FlowEngine {
                     this.aggregate(trailer.epc, cargo, { bizStep: YARD_BIZSTEP.loading, readPoint: to.id, consume: { readPoint: staging.id, disposition: DISP.in_transit } });
                 }
                 this.trailerCargo.delete(trailer.epc); // 적재 완료 → 예약분 소진(트레일러가 화물 보유)
-                trailer.disposition = DISP.sellable; // 적재 완료(loaded)
+                delete trailer.disposition; // 적재 완료(loaded) — no disposition, same ruling as the yard drop
             }
             else if (cargo.length && staging) {
                 // 하차: 트레일러←화물 분해(split) → 화물이 staging 에 materialize(WMS receiving hand-off).