@operato/twin-kernel 0.11.26 → 0.11.28

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`) — 비직렬 로트가 자리마다 갈릴 때. */
@@ -821,6 +825,11 @@ export declare abstract class FlowEngine implements TwinKernel {
             id: string;
             since: string;
         }[];
+        /**
+         * **접힌 오더**(ADR-0092) — 저널이나 원천을 다시 읽어 세우는 트윈도 이어받아야 한다. 이것이 없으면 세는 수를 잃고,
+         * 원천이 옛 종결을 다시 보낼 때 그것을 거를 경계가 없어 접힌 오더가 뜨거운 줄로 되살아난다.
+         */
+        foldedOrders?: FoldedOrders;
     }): void;
     /**
      * 씨앗의 확보분 중 **이 트윈에 실제로 있는 것만** 남긴다 — 없는 것은 세고 버린다.

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';
@@ -1049,6 +1049,21 @@ export class FlowEngine {
         for (const e of snap?.attentionSince ?? [])
             if (e?.id && e.since)
                 this._attentionSince.set(e.id, e.since);
+        if (snap?.foldedOrders && foldedOrderCount(snap.foldedOrders)) {
+            /*
+             * 이미 접힌 것이 있으면(재개점이 먼저 되세웠다) 건드리지 않는다 — 같은 값을 또 더하면 세는 수가 두 번 는다.
+             * 미러는 리듀서가 원천이다 — 거기에 넣어야 다시 온 옛 종결을 거른다. 리듀서가 아직 없으면 만든다(§restoreObserved).
+             */
+            if (this.observeMode) {
+                if (!this.observer)
+                    this.observer = new ObservedReducer(this.boardDef ?? { locations: [], equipment: [] });
+                if (this.observer.adoptFoldedOrders(snap.foldedOrders))
+                    this.observedDirty = true;
+            }
+            else if (!foldedOrderCount(this.foldedOrders)) {
+                this.foldedOrders = structuredClone(snap.foldedOrders);
+            }
+        }
     }
     /**
      * 씨앗의 확보분 중 **이 트윈에 실제로 있는 것만** 남긴다 — 없는 것은 세고 버린다.
@@ -3611,7 +3626,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 +3654,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 +3669,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.d.ts

@@ -525,6 +525,13 @@ export declare class ObservedReducer {
      * 모델에서 오는 판정 입력(교대·등급·시간대)은 생성자가 이미 세웠으므로 건드리지 않는다.
      */
     restore(cp: ReducerCheckpoint): void;
+    /**
+     * **이어받은 접힌 쪽을 앉힌다**(ADR-0092) — 이어가기 씨앗으로 뜨는 미러가 부른다(§`FlowEngine.hydrateContinuity`).
+     *
+     * 이미 접힌 것이 있으면 **건드리지 않는다.** 재개점(체크포인트)이 먼저 되세웠다면 그것이 정본이고, 같은 값을 또 더하면 세는
+     * 수가 두 번 는다. 비어 있을 때만 이어받는다. 이어받았으면 참을 돌려준다.
+     */
+    adoptFoldedOrders(folded: FoldedOrders): boolean;
     /**
      * **끝난 오더를 접는다**(ADR-0092) — 접은 수를 돌려준다.
      *

package/dist/observed-reducer.js

@@ -1409,6 +1409,18 @@ export class ObservedReducer {
         this.corrections = (cp?.corrections ?? []).map(c => ({ ...c }));
         this.unhandled = new Map((cp?.unhandled ?? []).map(({ eventType, ...v }) => [eventType, { ...v }]));
     }
+    /**
+     * **이어받은 접힌 쪽을 앉힌다**(ADR-0092) — 이어가기 씨앗으로 뜨는 미러가 부른다(§`FlowEngine.hydrateContinuity`).
+     *
+     * 이미 접힌 것이 있으면 **건드리지 않는다.** 재개점(체크포인트)이 먼저 되세웠다면 그것이 정본이고, 같은 값을 또 더하면 세는
+     * 수가 두 번 는다. 비어 있을 때만 이어받는다. 이어받았으면 참을 돌려준다.
+     */
+    adoptFoldedOrders(folded) {
+        if (foldedOrderCount(this.foldedOrders))
+            return false;
+        this.foldedOrders = structuredClone(folded);
+        return true;
+    }
     /**
      * **끝난 오더를 접는다**(ADR-0092) — 접은 수를 돌려준다.
      *

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