@operato/twin-kernel 0.6.3 → 0.6.4

package/dist/contract.d.ts

@@ -878,6 +878,13 @@ export interface OrderState {
     id: string;
     kind: string;
     status: string;
+    /**
+     * **무엇을 만드나** — GS1 품목 참조(단일 품목 작업지시). 여러 품목이면 `lines[].gtin` 이 말한다.
+     *
+     * 이 자리가 없던 동안 상태에는 "1개" 만 남고 **무엇을 1개인지** 사라졌다. 화면·예측·계보가 품목을
+     * 알 수 없다는 뜻이고, 확보분(`allocated`)이 같은 식으로 빠져 계보의 절반이 사라졌던 것과 같은 부류다.
+     */
+    gtin?: string;
     progress?: number;
     held?: boolean;
     /**
@@ -1254,6 +1261,14 @@ export interface OrderStatusDelta {
     status: string;
     requested: number;
     fulfilled: number;
+    /**
+     * **무엇을 만드나** — 상태의 `OrderState.gtin` 과 같은 값.
+     *
+     * 스냅샷에만 실으면 **미러가 이 필드를 못 채운다**(라이브는 이벤트로만 배운다). 같은 사실은
+     * 델타·스냅샷·씨앗 **세 자리**에 함께 실어야 한다 — `allocated` 가 두 자리에만 있어서 웜스타트가
+     * 잃었던 것과 같은 부류다(패리티 가드가 이것을 잡았다).
+     */
+    gtin?: string;
     held?: boolean;
     /**
      * 오더 라인(SKU+수량) — 선택. 있으면 이행 예측이 "남은 데맨드(라인별 requested-fulfilled)를

package/dist/flow-engine.js

@@ -524,6 +524,7 @@ export class FlowEngine {
                 /* 확보분과 거래번호도 함께 옮긴다 — 여기서 떨구면 위에서 실어 온 것이 마지막 한 걸음에서
                    사라진다(같은 사실이 델타·스냅샷·이 변환 **세 길**을 지난다). */
                 ...(o.allocated?.length ? { allocated: o.allocated } : {}),
+                ...(o.gtin ? { gtin: o.gtin } : {}),
                 ...(o.bizTransaction ? { bizTransaction: o.bizTransaction } : {})
             }));
         for (const o of observedOrders) {
@@ -541,6 +542,8 @@ export class FlowEngine {
                 /* **확보해 둔 것과 거래번호를 이어받는다.** 비우면 되살아난 오더가 아무것도 안 잡은 것처럼
                    보이고, 그 오더의 진행 중 작업이 완료될 때 계보가 입력 없이 나간다. 상태가 말해 주지
                    않으면(옛 저널) 그때는 비는 것이 사실이다 — 없는 것을 지어내지 않는다. */
+                /* 품목도 함께 — 씨앗이 흘리면 되살아난 오더가 무엇을 만드는지 모른다. */
+                ...(o.gtin ? { gtin: o.gtin } : {}),
                 bizTransaction: o.bizTransaction ?? '', allocated: (o.allocated ?? []).slice(), picked: [], shipmentEpc: null, lines,
                 /* **보류를 이어받는다** — 잃으면 씨앗이 사람이 일부러 멈춘 오더를 다시 계획해 내보낸다.
                    씨앗 왕복 대조가 이것을 잡았다(그 전에는 사람이 코드를 읽어야만 알 수 있었다). */
@@ -863,6 +866,16 @@ export class FlowEngine {
                 id: o.id, kind: o.kind, status: o.status,
                 progress: o.requested ? o.fulfilled / o.requested : 0,
                 requested: o.requested, fulfilled: o.fulfilled,
+                /*
+                 * **무엇을 만드는 오더인가** — 이것이 없으면 "1개" 만 남고 무엇을 1개인지 사라진다.
+                 *
+                 * 커널은 오더를 만들 때부터 이 값을 들고 있는데(`gtin: product.gtin`) 스냅샷이 흘리고 있었다.
+                 * 그러면 화면·예측·계보가 품목을 알 수 없다 — 확보분(`allocated`)이 같은 식으로 빠져 계보의
+                 * 절반이 사라졌던 것과 같은 부류다(그때 배운 것을 여기서도 적용한다).
+                 *
+                 * 라인이 있는 오더는 `lines[].gtin` 이 품목을 말하고, 단일 품목 작업지시는 이 자리가 말한다.
+                 */
+                ...(o.gtin ? { gtin: o.gtin } : {}),
                 ...(o.lines?.length ? { lines: o.lines.map(l => ({ gtin: l.gtin, requested: l.requested })) } : {}),
                 ...(o.priority !== undefined ? { priority: o.priority } : {}),
                 ...(o.startTime ? { startTime: o.startTime } : {}),
@@ -1474,6 +1487,7 @@ export class FlowEngine {
             ...(o.lines?.length ? { lines: o.lines.map(l => ({ gtin: l.gtin, requested: l.requested })) } : {}),
             /* 진행 중 할당과 거래번호를 함께 싣는다 — 이것이 없으면 웜스타트가 잃고, 되살아난 오더의
                계보가 입력 없이 나간다(무엇이 무엇으로 바뀌었나의 절반이 사라진다). */
+            ...(o.gtin ? { gtin: o.gtin } : {}),
             ...(o.allocated?.length ? { allocated: o.allocated.slice() } : {}),
             ...(o.bizTransaction ? { bizTransaction: o.bizTransaction } : {})
         });

package/dist/observed-reducer.js

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

package/dist-cjs/index.cjs

@@ -1185,6 +1185,7 @@ var ObservedReducer = class {
           ...d.endTime ? { endTime: d.endTime } : {},
           /* 진행 중 확보분과 거래번호 — **미러도 같은 필드를 채운다.** 시뮬만 아는 사실을 두면
              그 위에서 세운 예측이 두 구동에서 달라진다(패리티 검사가 지키는 것이 이것이다). */
+          ...d.gtin ? { gtin: d.gtin } : {},
           ...d.allocated?.length ? { allocated: d.allocated.slice() } : {},
           ...d.bizTransaction ? { bizTransaction: d.bizTransaction } : {},
           held: d.held
@@ -2570,6 +2571,7 @@ var FlowEngine = class {
       /* 확보분과 거래번호도 함께 옮긴다 — 여기서 떨구면 위에서 실어 온 것이 마지막 한 걸음에서
          사라진다(같은 사실이 델타·스냅샷·이 변환 **세 길**을 지난다). */
       ...o.allocated?.length ? { allocated: o.allocated } : {},
+      ...o.gtin ? { gtin: o.gtin } : {},
       ...o.bizTransaction ? { bizTransaction: o.bizTransaction } : {}
     }));
     for (const o of observedOrders) {
@@ -2585,6 +2587,8 @@ var FlowEngine = class {
         /* **확보해 둔 것과 거래번호를 이어받는다.** 비우면 되살아난 오더가 아무것도 안 잡은 것처럼
            보이고, 그 오더의 진행 중 작업이 완료될 때 계보가 입력 없이 나간다. 상태가 말해 주지
            않으면(옛 저널) 그때는 비는 것이 사실이다 — 없는 것을 지어내지 않는다. */
+        /* 품목도 함께 — 씨앗이 흘리면 되살아난 오더가 무엇을 만드는지 모른다. */
+        ...o.gtin ? { gtin: o.gtin } : {},
         bizTransaction: o.bizTransaction ?? "",
         allocated: (o.allocated ?? []).slice(),
         picked: [],
@@ -2890,6 +2894,16 @@ var FlowEngine = class {
         progress: o.requested ? o.fulfilled / o.requested : 0,
         requested: o.requested,
         fulfilled: o.fulfilled,
+        /*
+         * **무엇을 만드는 오더인가** — 이것이 없으면 "1개" 만 남고 무엇을 1개인지 사라진다.
+         *
+         * 커널은 오더를 만들 때부터 이 값을 들고 있는데(`gtin: product.gtin`) 스냅샷이 흘리고 있었다.
+         * 그러면 화면·예측·계보가 품목을 알 수 없다 — 확보분(`allocated`)이 같은 식으로 빠져 계보의
+         * 절반이 사라졌던 것과 같은 부류다(그때 배운 것을 여기서도 적용한다).
+         *
+         * 라인이 있는 오더는 `lines[].gtin` 이 품목을 말하고, 단일 품목 작업지시는 이 자리가 말한다.
+         */
+        ...o.gtin ? { gtin: o.gtin } : {},
         ...o.lines?.length ? { lines: o.lines.map((l) => ({ gtin: l.gtin, requested: l.requested })) } : {},
         ...o.priority !== void 0 ? { priority: o.priority } : {},
         ...o.startTime ? { startTime: o.startTime } : {},
@@ -3445,6 +3459,7 @@ var FlowEngine = class {
       ...o.lines?.length ? { lines: o.lines.map((l) => ({ gtin: l.gtin, requested: l.requested })) } : {},
       /* 진행 중 할당과 거래번호를 함께 싣는다 — 이것이 없으면 웜스타트가 잃고, 되살아난 오더의
          계보가 입력 없이 나간다(무엇이 무엇으로 바뀌었나의 절반이 사라진다). */
+      ...o.gtin ? { gtin: o.gtin } : {},
       ...o.allocated?.length ? { allocated: o.allocated.slice() } : {},
       ...o.bizTransaction ? { bizTransaction: o.bizTransaction } : {}
     });

package/package.json

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