@operato/twin-kernel 0.7.11 → 0.7.12

package/dist/contract.d.ts

@@ -1125,6 +1125,20 @@ export interface OrderState {
      * 이것도 상태에 없어서 되살아난 오더는 빈 문자열을 갖고, 이후 모든 이벤트의 거래번호가 빈다.
      */
     bizTransaction?: string;
+    /**
+     * 도메인이 **약속해 둔 자리와 시각창** — 어디로/언제 들이기로 했는가.
+     *
+     * ── 왜 사실에 실어야 하나 (2026-08-17) ─────────────────────────────────────
+     * 야드 트윈이 재기동 뒤 **첫 틱에서 죽었다.** 어포인트먼트를 받을 때 도크 도어를 정해 두는데
+     * 그것이 어느 사실에도 실리지 않아, 웜스타트가 오더는 되살리고 배정은 잃었다. 그리고 다음 틱에
+     * 「그 도어의 점유」를 읽다 예외가 났다(`Cannot read properties of undefined`). 안전망이 그 트윈만
+     * 세워 다른 트윈은 살았지만, 야드 트윈 셋이 부팅마다 죽는 상태였다.
+     *
+     * `allocated` 가 두 자리에만 있어 계보를 잃었던 것과 **같은 부류**다: 상태가 필요로 하는 것을
+     * 사실이 갖고 있지 않으면 재기동을 넘지 못한다.
+     */
+    dockDoor?: string;
+    windowStartMs?: number;
     /** 우선순위 — 표준 `OperationsRequest.Priority`. 작은 값이 급하다. 오더 할당 순서를 정한다. */
     priority?: number;
     /** 예정 착수 — 표준 `OperationsRequest.StartTime`. */
@@ -1670,6 +1684,20 @@ export interface OrderStatusDelta {
      */
     allocated?: string[];
     bizTransaction?: string;
+    /**
+     * 도메인이 **약속해 둔 자리와 시각창** — 어디로/언제 들이기로 했는가.
+     *
+     * ── 왜 사실에 실어야 하나 (2026-08-17) ─────────────────────────────────────
+     * 야드 트윈이 재기동 뒤 **첫 틱에서 죽었다.** 어포인트먼트를 받을 때 도크 도어를 정해 두는데
+     * 그것이 어느 사실에도 실리지 않아, 웜스타트가 오더는 되살리고 배정은 잃었다. 그리고 다음 틱에
+     * 「그 도어의 점유」를 읽다 예외가 났다(`Cannot read properties of undefined`). 안전망이 그 트윈만
+     * 세워 다른 트윈은 살았지만, 야드 트윈 셋이 부팅마다 죽는 상태였다.
+     *
+     * `allocated` 가 두 자리에만 있어 계보를 잃었던 것과 **같은 부류**다: 상태가 필요로 하는 것을
+     * 사실이 갖고 있지 않으면 재기동을 넘지 못한다.
+     */
+    dockDoor?: string;
+    windowStartMs?: number;
 }
 export declare const CMD: {
     readonly orderHold: "order.hold";

package/dist/flow-engine.js

@@ -589,7 +589,9 @@ export class FlowEngine {
                    사라진다(같은 사실이 델타·스냅샷·이 변환 **세 길**을 지난다). */
                 ...(o.allocated?.length ? { allocated: o.allocated } : {}),
                 ...(o.gtin ? { gtin: o.gtin } : {}),
-                ...(o.bizTransaction ? { bizTransaction: o.bizTransaction } : {})
+                ...(o.bizTransaction ? { bizTransaction: o.bizTransaction } : {}),
+                ...(o.dockDoor ? { dockDoor: o.dockDoor } : {}),
+                ...(o.windowStartMs !== undefined ? { windowStartMs: o.windowStartMs } : {})
             }));
         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);
@@ -614,7 +616,11 @@ export class FlowEngine {
                 ...(o.held ? { held: true } : {}),
                 ...(o.endTime ? { endTime: o.endTime } : {}),
                 ...(o.startTime ? { startTime: o.startTime } : {}),
-                ...(o.priority !== undefined ? { priority: o.priority } : {})
+                ...(o.priority !== undefined ? { priority: o.priority } : {}),
+                /* 약속해 둔 자리·시각창을 이어받는다 — 없으면 도메인이 「정해 뒀다」고 믿는 것을 잃는다.
+                   사실이 말해 주지 않으면(옛 저널) 비는 것이 사실이다 — 지어내지 않는다. */
+                ...(o.dockDoor ? { dockDoor: o.dockDoor } : {}),
+                ...(o.windowStartMs !== undefined ? { windowStartMs: o.windowStartMs } : {})
             });
         }
         /* 작업이 딛고 설 오더를 먼저 세운다 — 순서가 뒤바뀌면 아래 확인이 언제나 "없다" 로 답한다. */
@@ -955,6 +961,9 @@ export class FlowEngine {
                 /* 진행 중 확보분과 거래번호 — **스냅샷에도** 실어야 한다. 델타에만 실으면 스냅샷으로
                    재기동하는 경로(체크포인트)에서 그대로 잃는다(같은 사실을 두 길로 나르는 값이다). */
                 ...(o.allocated?.length ? { allocated: o.allocated.slice() } : {}),
+                /* 스냅샷도 함께 나른다 — 델타·스냅샷·복원 **세 길** 중 하나만 빠져도 재기동이 잃는다. */
+                ...(o.dockDoor ? { dockDoor: o.dockDoor } : {}),
+                ...(o.windowStartMs !== undefined ? { windowStartMs: o.windowStartMs } : {}),
                 ...(o.bizTransaction ? { bizTransaction: o.bizTransaction } : {}),
                 held: o.held
             })),
@@ -1660,7 +1669,10 @@ export class FlowEngine {
                계보가 입력 없이 나간다(무엇이 무엇으로 바뀌었나의 절반이 사라진다). */
             ...(o.gtin ? { gtin: o.gtin } : {}),
             ...(o.allocated?.length ? { allocated: o.allocated.slice() } : {}),
-            ...(o.bizTransaction ? { bizTransaction: o.bizTransaction } : {})
+            ...(o.bizTransaction ? { bizTransaction: o.bizTransaction } : {}),
+            /* 약속해 둔 자리·시각창 — 이것이 빠져서 야드 트윈이 재기동마다 첫 틱에 죽었다(§dockDoor). */
+            ...(o.dockDoor ? { dockDoor: o.dockDoor } : {}),
+            ...(o.windowStartMs !== undefined ? { windowStartMs: o.windowStartMs } : {})
         });
     }
     // ── 내부 mechanics ─────────────────────────────────────────────────────────

package/dist/observed-reducer.js

@@ -357,6 +357,10 @@ export class ObservedReducer {
                     ...(d.gtin ? { gtin: d.gtin } : {}),
                     ...(d.allocated?.length ? { allocated: d.allocated.slice() } : {}),
                     ...(d.bizTransaction ? { bizTransaction: d.bizTransaction } : {}),
+                    /* 약속해 둔 자리·시각창도 채운다 — 시뮬만 알면 미러 위 예측이 「어디로 들일지」를 모른다.
+                       (이 필드가 어느 길에서 빠지면 무슨 일이 나는지는 §dockDoor 에 적혀 있다.) */
+                    ...(d.dockDoor ? { dockDoor: d.dockDoor } : {}),
+                    ...(d.windowStartMs !== undefined ? { windowStartMs: d.windowStartMs } : {}),
                     held: d.held
                 });
                 break;

package/dist/yms-kernel.d.ts

@@ -8,6 +8,8 @@ export declare class YmsKernel extends FlowEngine {
     private cargoSeq;
     private trailerCargo;
     private apptMode;
+    /** 도어를 못 찾아 대기시킨 오더 — 같은 말을 매 틱 반복하지 않기 위한 표시(§allocate). */
+    private doorWarned;
     /** 야드 운영 정책(상하차 방식). 기본 drop(야드 버퍼). live 는 게이트/도크 직행. */
     mode: YardMode;
     constructor(tenantId: string, policy?: AllocationPolicy, mode?: YardMode);

package/dist/yms-kernel.js

@@ -39,6 +39,8 @@ export class YmsKernel extends FlowEngine {
     cargoSeq = 0;
     trailerCargo = new Map(); // 트레일러 epc → 화물 SSCC(하차 전 opaque / 상차 예약분)
     apptMode = new Map(); // orderId → 상하차 모드(생성 시 캡처)
+    /** 도어를 못 찾아 대기시킨 오더 — 같은 말을 매 틱 반복하지 않기 위한 표시(§allocate). */
+    doorWarned = new Set();
     /** 야드 운영 정책(상하차 방식). 기본 drop(야드 버퍼). live 는 게이트/도크 직행. */
     mode;
     constructor(tenantId, policy = firstFitPolicy, mode = 'drop') {
@@ -102,7 +104,25 @@ export class YmsKernel extends FlowEngine {
             return;
         if (this.clockMs < (o.windowStartMs ?? 0))
             return; // 창 도래 전
-        const door = this.locations.get(o.dockDoor);
+        /*
+         * ── 배정된 도어가 없으면 **기다린다** (2026-08-17) ────────────────────────
+         *
+         * 예전에는 `this.locations.get(o.dockDoor!)!` 였다. 그래서 배정을 모르는 오더가 들어오면 바로
+         * 아래에서 `undefined.occupancy` 를 읽고 **틱 전체가 예외로 죽었다** — 야드 트윈 셋이 재기동마다
+         * 그렇게 멈췄다(안전망이 세운 것이지 스스로 멈춘 것이 아니다).
+         *
+         * 이제 그 오더만 대기로 남기고 **왜인지 한 번 말한다.** 매 틱 말하면 로그가 그것만 남으므로 한 번만
+         * 말하고, 조용히 넘기지도 않는다 — 조용하면 「왜 이 오더는 영원히 안 움직이나」를 아무도 답할 수 없다.
+         */
+        const door = o.dockDoor ? this.locations.get(o.dockDoor) : undefined;
+        if (!door) {
+            if (!this.doorWarned.has(o.id)) {
+                this.doorWarned.add(o.id);
+                console.warn(`[yms-kernel] order "${o.id}" waits: ${o.dockDoor ? `its dock door "${o.dockDoor}" is not in this model` : 'no dock door was assigned to it'}` +
+                    ' — the appointment cannot be scheduled until the declaration says where.');
+            }
+            return;
+        }
         const inflight = [...this.tasks.values()].some(t => t.status !== 'completed' && t.toNode === door.id);
         if (door.occupancy > 0 || inflight)
             return; // 도어 사용중/예약됨 → 대기(직렬화)

package/dist-cjs/index.cjs

@@ -1354,6 +1354,10 @@ var ObservedReducer = class {
           ...d.gtin ? { gtin: d.gtin } : {},
           ...d.allocated?.length ? { allocated: d.allocated.slice() } : {},
           ...d.bizTransaction ? { bizTransaction: d.bizTransaction } : {},
+          /* 약속해 둔 자리·시각창도 채운다 — 시뮬만 알면 미러 위 예측이 「어디로 들일지」를 모른다.
+             (이 필드가 어느 길에서 빠지면 무슨 일이 나는지는 §dockDoor 에 적혀 있다.) */
+          ...d.dockDoor ? { dockDoor: d.dockDoor } : {},
+          ...d.windowStartMs !== void 0 ? { windowStartMs: d.windowStartMs } : {},
           held: d.held
         });
         break;
@@ -3219,7 +3223,9 @@ var FlowEngine = class {
          사라진다(같은 사실이 델타·스냅샷·이 변환 **세 길**을 지난다). */
       ...o.allocated?.length ? { allocated: o.allocated } : {},
       ...o.gtin ? { gtin: o.gtin } : {},
-      ...o.bizTransaction ? { bizTransaction: o.bizTransaction } : {}
+      ...o.bizTransaction ? { bizTransaction: o.bizTransaction } : {},
+      ...o.dockDoor ? { dockDoor: o.dockDoor } : {},
+      ...o.windowStartMs !== void 0 ? { windowStartMs: o.windowStartMs } : {}
     }));
     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);
@@ -3246,7 +3252,11 @@ var FlowEngine = class {
         ...o.held ? { held: true } : {},
         ...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.dockDoor ? { dockDoor: o.dockDoor } : {},
+        ...o.windowStartMs !== void 0 ? { windowStartMs: o.windowStartMs } : {}
       });
     }
     const seededOrderIds = new Set(this.orders.keys());
@@ -3562,6 +3572,9 @@ var FlowEngine = class {
         /* 진행 중 확보분과 거래번호 — **스냅샷에도** 실어야 한다. 델타에만 실으면 스냅샷으로
            재기동하는 경로(체크포인트)에서 그대로 잃는다(같은 사실을 두 길로 나르는 값이다). */
         ...o.allocated?.length ? { allocated: o.allocated.slice() } : {},
+        /* 스냅샷도 함께 나른다 — 델타·스냅샷·복원 **세 길** 중 하나만 빠져도 재기동이 잃는다. */
+        ...o.dockDoor ? { dockDoor: o.dockDoor } : {},
+        ...o.windowStartMs !== void 0 ? { windowStartMs: o.windowStartMs } : {},
         ...o.bizTransaction ? { bizTransaction: o.bizTransaction } : {},
         held: o.held
       })),
@@ -4208,7 +4221,10 @@ var FlowEngine = class {
          계보가 입력 없이 나간다(무엇이 무엇으로 바뀌었나의 절반이 사라진다). */
       ...o.gtin ? { gtin: o.gtin } : {},
       ...o.allocated?.length ? { allocated: o.allocated.slice() } : {},
-      ...o.bizTransaction ? { bizTransaction: o.bizTransaction } : {}
+      ...o.bizTransaction ? { bizTransaction: o.bizTransaction } : {},
+      /* 약속해 둔 자리·시각창 — 이것이 빠져서 야드 트윈이 재기동마다 첫 틱에 죽었다(§dockDoor). */
+      ...o.dockDoor ? { dockDoor: o.dockDoor } : {},
+      ...o.windowStartMs !== void 0 ? { windowStartMs: o.windowStartMs } : {}
     });
   }
   // ── 내부 mechanics ─────────────────────────────────────────────────────────
@@ -5300,6 +5316,8 @@ var YmsKernel = class extends FlowEngine {
   // 트레일러 epc → 화물 SSCC(하차 전 opaque / 상차 예약분)
   apptMode = /* @__PURE__ */ new Map();
   // orderId → 상하차 모드(생성 시 캡처)
+  /** 도어를 못 찾아 대기시킨 오더 — 같은 말을 매 틱 반복하지 않기 위한 표시(§allocate). */
+  doorWarned = /* @__PURE__ */ new Set();
   /** 야드 운영 정책(상하차 방식). 기본 drop(야드 버퍼). live 는 게이트/도크 직행. */
   mode;
   constructor(tenantId, policy = firstFitPolicy, mode = "drop") {
@@ -5371,7 +5389,16 @@ var YmsKernel = class extends FlowEngine {
     const trailer = this.items.get(o.allocated[0]);
     if (!trailer) return;
     if (this.clockMs < (o.windowStartMs ?? 0)) return;
-    const door = this.locations.get(o.dockDoor);
+    const door = o.dockDoor ? this.locations.get(o.dockDoor) : void 0;
+    if (!door) {
+      if (!this.doorWarned.has(o.id)) {
+        this.doorWarned.add(o.id);
+        console.warn(
+          `[yms-kernel] order "${o.id}" waits: ${o.dockDoor ? `its dock door "${o.dockDoor}" is not in this model` : "no dock door was assigned to it"} \u2014 the appointment cannot be scheduled until the declaration says where.`
+        );
+      }
+      return;
+    }
     const inflight = [...this.tasks.values()].some((t) => t.status !== "completed" && t.toNode === door.id);
     if (door.occupancy > 0 || inflight) return;
     const mode = this.apptMode.get(o.id) ?? "drop";

package/package.json

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