@operato/twin-kernel 0.11.25 → 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,9 +15,9 @@ 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, orderFoldPolicyOf, planOrderFold } from '@operato/ops-contract';
+import { ORDER_FOLD_DEFAULT, emptyFoldedOrders, foldOrdersInto, foldedOrderCount, pruneFoldedHours, orderFoldPolicyOf, planOrderFold } from '@operato/ops-contract';
 import { OP_PARAM } from '@operato/ops-contract';
 import { parseIsoDuration } from '@operato/ops-contract';
 import { analyzeCapacity } from '@operato/ops-contract';
@@ -721,7 +721,9 @@ export class FlowEngine {
         const ids = planOrderFold([...this.orders.values()], nowMs ?? this.nowMs(), this.orderFoldPolicy);
         if (!ids.length)
             return 0;
-        this.foldedOrders = foldOrdersInto(this.foldedOrders, ids.map(id => this.orders.get(id)).filter(Boolean));
+        /* 창 밖 시간 칸은 접을 때 버린다 — 칸 수가 T/1h 를 넘지 않게(ADR-0092 결정 2 보탬). */
+        const now = nowMs ?? this.nowMs();
+        this.foldedOrders = pruneFoldedHours(foldOrdersInto(this.foldedOrders, ids.map(id => this.orders.get(id)).filter(Boolean)), now, this.orderFoldPolicy);
         for (const id of ids)
             this.orders.delete(id);
         this.revision++;
@@ -3609,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
                 }));
@@ -3637,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;
@@ -3652,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/observed-reducer.js

@@ -22,7 +22,7 @@
 import { computeOee, isWorkShiftExecutionBasis } from '@operato/ops-contract';
 import { OP_EVENT, capabilityOf, itemKeyOf, judgeAgainstSpec, requiredTestsFor, locationStatusOf, readBoardEquipment, readBoardLocations, readBoardAssets, effectivityAt, offCalendarAt, offCalendarReasonAt, activeShiftAt } from '@operato/ops-contract';
 import { ILMD_ATTR, parseEpc } from '@operato/ops-contract';
-import { emptyFoldedOrders, foldOrdersInto, foldedOrderCount, isOrderTerminal, orderFoldPolicyOf, planOrderFold, standsNewOrderRow } from '@operato/ops-contract';
+import { emptyFoldedOrders, foldOrdersInto, foldedOrderCount, pruneFoldedHours, isOrderTerminal, orderFoldPolicyOf, planOrderFold, standsNewOrderRow } from '@operato/ops-contract';
 import { expiryFromAttributes, lotFromAttributes } from '@operato/ops-contract';
 /* 클래스 마스터 표는 상태를 들므로 커널에 있다(§`class-master-table`). */
 import { ClassMasterTable } from "./class-master-table.js";
@@ -1423,7 +1423,8 @@ export class ObservedReducer {
         if (!ids.length)
             return 0;
         const rows = ids.map(id => this.orders.get(id)).filter(Boolean);
-        this.foldedOrders = foldOrdersInto(this.foldedOrders, rows);
+        /* 창 밖 시간 칸은 접을 때 버린다 — 칸 수가 T/1h 를 넘지 않게(ADR-0092 결정 2 보탬). */
+        this.foldedOrders = pruneFoldedHours(foldOrdersInto(this.foldedOrders, rows), nowMs, this.orderFoldPolicy);
         for (const id of ids) {
             this.orders.delete(id);
             this.lastAt.delete(`order:${id}`);

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).