@operato/twin-kernel 0.6.1 → 0.6.2

package/dist/contract.d.ts

@@ -874,6 +874,22 @@ export interface OrderState {
     requested?: number;
     fulfilled?: number;
     lines?: ObservedOrderLine[];
+    /**
+     * 이 오더가 **확보해 둔 물품들** — 진행 중인 할당.
+     *
+     * 이것이 상태에 없으면 **웜스타트가 잃는다.** 잃으면 되살아난 오더는 아무것도 안 잡은 것처럼
+     * 보이고, 그 오더에 딸린 진행 중 작업이 완료될 때 계보(`TransformationEvent`)가 **입력 없이**
+     * 나간다 — "무엇이 무엇으로 바뀌었나" 의 절반이 사라진다. 실제로 그렇게 되고 있었다.
+     *
+     * 씨앗이 잃은 것은 예측도 모른다 — 진행 중 자재를 안 잡은 것으로 놓고 미래를 굴리면 답이
+     * 낙관 쪽으로 치우친다(`hydrateObserved` 가 상태를 지키는 이유와 같다).
+     */
+    allocated?: string[];
+    /**
+     * 이 오더의 거래번호(작업지시·PO·SO) — 계보와 EPCIS 이벤트가 **무슨 거래로** 일어났는지 잇는 축.
+     * 이것도 상태에 없어서 되살아난 오더는 빈 문자열을 갖고, 이후 모든 이벤트의 거래번호가 빈다.
+     */
+    bizTransaction?: string;
     /** 우선순위 — 표준 `OperationsRequest.Priority`. 작은 값이 급하다. 오더 할당 순서를 정한다. */
     priority?: number;
     /** 예정 착수 — 표준 `OperationsRequest.StartTime`. */
@@ -1230,6 +1246,15 @@ export interface OrderStatusDelta {
     priority?: number;
     startTime?: ISOTime;
     endTime?: ISOTime;
+    /**
+     * 이 오더가 **확보해 둔 물품들**과 그 **거래번호** — 진행 중인 할당.
+     *
+     * 델타가 나르지 않으면 웜스타트가 잃는다. 잃으면 되살아난 오더는 아무것도 안 잡은 것처럼
+     * 보이고, 그 오더의 진행 중 작업이 완료될 때 계보(`TransformationEvent`)가 **입력 없이** 나간다 —
+     * "무엇이 무엇으로 바뀌었나" 의 절반이 사라진다. 실제로 그렇게 되고 있었다.
+     */
+    allocated?: string[];
+    bizTransaction?: string;
 }
 export declare const CMD: {
     readonly orderHold: "order.hold";

package/dist/flow-engine.js

@@ -520,7 +520,11 @@ export class FlowEngine {
                    없다.** 라이브 트윈이 납기 초과를 한 번도 보고하지 못한 원인 중 하나였다. */
                 ...(o.endTime ? { endTime: o.endTime } : {}),
                 ...(o.startTime ? { startTime: o.startTime } : {}),
-                ...(o.priority !== undefined ? { priority: o.priority } : {})
+                ...(o.priority !== undefined ? { priority: o.priority } : {}),
+                /* 확보분과 거래번호도 함께 옮긴다 — 여기서 떨구면 위에서 실어 온 것이 마지막 한 걸음에서
+                   사라진다(같은 사실이 델타·스냅샷·이 변환 **세 길**을 지난다). */
+                ...(o.allocated?.length ? { allocated: o.allocated } : {}),
+                ...(o.bizTransaction ? { bizTransaction: o.bizTransaction } : {})
             }));
         for (const o of observedOrders) {
             const lines = (o.lines ?? []).map(l => ({ gtin: l.gtin, requested: l.requested - (l.fulfilled ?? 0) })).filter(l => l.requested > 0);
@@ -534,7 +538,10 @@ export class FlowEngine {
                 continue; // 이미 이행 완료 → 예측 대상 아님
             this.orders.set(o.orderId, {
                 id: o.orderId, kind: o.kind, status: 'created', requested: remaining, fulfilled: 0,
-                bizTransaction: '', allocated: [], picked: [], shipmentEpc: null, lines,
+                /* **확보해 둔 것과 거래번호를 이어받는다.** 비우면 되살아난 오더가 아무것도 안 잡은 것처럼
+                   보이고, 그 오더의 진행 중 작업이 완료될 때 계보가 입력 없이 나간다. 상태가 말해 주지
+                   않으면(옛 저널) 그때는 비는 것이 사실이다 — 없는 것을 지어내지 않는다. */
+                bizTransaction: o.bizTransaction ?? '', allocated: (o.allocated ?? []).slice(), picked: [], shipmentEpc: null, lines,
                 /* **보류를 이어받는다** — 잃으면 씨앗이 사람이 일부러 멈춘 오더를 다시 계획해 내보낸다.
                    씨앗 왕복 대조가 이것을 잡았다(그 전에는 사람이 코드를 읽어야만 알 수 있었다). */
                 ...(o.held ? { held: true } : {}),
@@ -860,6 +867,10 @@ export class FlowEngine {
                 ...(o.priority !== undefined ? { priority: o.priority } : {}),
                 ...(o.startTime ? { startTime: o.startTime } : {}),
                 ...(o.endTime ? { endTime: o.endTime } : {}),
+                /* 진행 중 확보분과 거래번호 — **스냅샷에도** 실어야 한다. 델타에만 실으면 스냅샷으로
+                   재기동하는 경로(체크포인트)에서 그대로 잃는다(같은 사실을 두 길로 나르는 값이다). */
+                ...(o.allocated?.length ? { allocated: o.allocated.slice() } : {}),
+                ...(o.bizTransaction ? { bizTransaction: o.bizTransaction } : {}),
                 held: o.held
             })),
             attentions: this.computeAttentions(),
@@ -1460,7 +1471,11 @@ export class FlowEngine {
             ...(o.priority !== undefined ? { priority: o.priority } : {}),
             ...(o.startTime ? { startTime: o.startTime } : {}),
             ...(o.endTime ? { endTime: o.endTime } : {}),
-            ...(o.lines?.length ? { lines: o.lines.map(l => ({ gtin: l.gtin, requested: l.requested })) } : {})
+            ...(o.lines?.length ? { lines: o.lines.map(l => ({ gtin: l.gtin, requested: l.requested })) } : {}),
+            /* 진행 중 할당과 거래번호를 함께 싣는다 — 이것이 없으면 웜스타트가 잃고, 되살아난 오더의
+               계보가 입력 없이 나간다(무엇이 무엇으로 바뀌었나의 절반이 사라진다). */
+            ...(o.allocated?.length ? { allocated: o.allocated.slice() } : {}),
+            ...(o.bizTransaction ? { bizTransaction: o.bizTransaction } : {})
         });
     }
     // ── 내부 mechanics ─────────────────────────────────────────────────────────

package/dist/observed-reducer.js

@@ -342,6 +342,10 @@ export class ObservedReducer {
                     ...(d.priority !== undefined ? { priority: d.priority } : {}),
                     ...(d.startTime ? { startTime: d.startTime } : {}),
                     ...(d.endTime ? { endTime: d.endTime } : {}),
+                    /* 진행 중 확보분과 거래번호 — **미러도 같은 필드를 채운다.** 시뮬만 아는 사실을 두면
+                       그 위에서 세운 예측이 두 구동에서 달라진다(패리티 검사가 지키는 것이 이것이다). */
+                    ...(d.allocated?.length ? { allocated: d.allocated.slice() } : {}),
+                    ...(d.bizTransaction ? { bizTransaction: d.bizTransaction } : {}),
                     held: d.held
                 });
                 break;

package/dist-cjs/index.cjs

@@ -1181,6 +1181,10 @@ var ObservedReducer = class {
           ...d.priority !== void 0 ? { priority: d.priority } : {},
           ...d.startTime ? { startTime: d.startTime } : {},
           ...d.endTime ? { endTime: d.endTime } : {},
+          /* 진행 중 확보분과 거래번호 — **미러도 같은 필드를 채운다.** 시뮬만 아는 사실을 두면
+             그 위에서 세운 예측이 두 구동에서 달라진다(패리티 검사가 지키는 것이 이것이다). */
+          ...d.allocated?.length ? { allocated: d.allocated.slice() } : {},
+          ...d.bizTransaction ? { bizTransaction: d.bizTransaction } : {},
           held: d.held
         });
         break;
@@ -2502,7 +2506,11 @@ var FlowEngine = class {
          없다.** 라이브 트윈이 납기 초과를 한 번도 보고하지 못한 원인 중 하나였다. */
       ...o.endTime ? { endTime: o.endTime } : {},
       ...o.startTime ? { startTime: o.startTime } : {},
-      ...o.priority !== void 0 ? { priority: o.priority } : {}
+      ...o.priority !== void 0 ? { priority: o.priority } : {},
+      /* 확보분과 거래번호도 함께 옮긴다 — 여기서 떨구면 위에서 실어 온 것이 마지막 한 걸음에서
+         사라진다(같은 사실이 델타·스냅샷·이 변환 **세 길**을 지난다). */
+      ...o.allocated?.length ? { allocated: o.allocated } : {},
+      ...o.bizTransaction ? { bizTransaction: o.bizTransaction } : {}
     }));
     for (const o of observedOrders) {
       const lines = (o.lines ?? []).map((l) => ({ gtin: l.gtin, requested: l.requested - (l.fulfilled ?? 0) })).filter((l) => l.requested > 0);
@@ -2514,8 +2522,11 @@ var FlowEngine = class {
         status: "created",
         requested: remaining,
         fulfilled: 0,
-        bizTransaction: "",
-        allocated: [],
+        /* **확보해 둔 것과 거래번호를 이어받는다.** 비우면 되살아난 오더가 아무것도 안 잡은 것처럼
+           보이고, 그 오더의 진행 중 작업이 완료될 때 계보가 입력 없이 나간다. 상태가 말해 주지
+           않으면(옛 저널) 그때는 비는 것이 사실이다 — 없는 것을 지어내지 않는다. */
+        bizTransaction: o.bizTransaction ?? "",
+        allocated: (o.allocated ?? []).slice(),
         picked: [],
         shipmentEpc: null,
         lines,
@@ -2823,6 +2834,10 @@ var FlowEngine = class {
         ...o.priority !== void 0 ? { priority: o.priority } : {},
         ...o.startTime ? { startTime: o.startTime } : {},
         ...o.endTime ? { endTime: o.endTime } : {},
+        /* 진행 중 확보분과 거래번호 — **스냅샷에도** 실어야 한다. 델타에만 실으면 스냅샷으로
+           재기동하는 경로(체크포인트)에서 그대로 잃는다(같은 사실을 두 길로 나르는 값이다). */
+        ...o.allocated?.length ? { allocated: o.allocated.slice() } : {},
+        ...o.bizTransaction ? { bizTransaction: o.bizTransaction } : {},
         held: o.held
       })),
       attentions: this.computeAttentions(),
@@ -3367,7 +3382,11 @@ var FlowEngine = class {
       ...o.priority !== void 0 ? { priority: o.priority } : {},
       ...o.startTime ? { startTime: o.startTime } : {},
       ...o.endTime ? { endTime: o.endTime } : {},
-      ...o.lines?.length ? { lines: o.lines.map((l) => ({ gtin: l.gtin, requested: l.requested })) } : {}
+      ...o.lines?.length ? { lines: o.lines.map((l) => ({ gtin: l.gtin, requested: l.requested })) } : {},
+      /* 진행 중 할당과 거래번호를 함께 싣는다 — 이것이 없으면 웜스타트가 잃고, 되살아난 오더의
+         계보가 입력 없이 나간다(무엇이 무엇으로 바뀌었나의 절반이 사라진다). */
+      ...o.allocated?.length ? { allocated: o.allocated.slice() } : {},
+      ...o.bizTransaction ? { bizTransaction: o.bizTransaction } : {}
     });
   }
   // ── 내부 mechanics ─────────────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operato/twin-kernel",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "type": "module",
   "description": "Twin Domain Kernel — framework-agnostic, zero-dep (domain + sim + 3-channel contract). WMS/YMS/MES, EPCIS 2.0 · ISA-95.",
   "publishConfig": {