@operato/twin-kernel 0.7.39 → 0.7.41

package/dist/observed-reducer.d.ts

@@ -55,7 +55,7 @@ export interface ProjectedState {
      * 아무것도 담기지 않는다. 그것을 조용히 두면 트윈은 「정상인데 빈」 모습이 된다.
      *
      * 비어 있지 않으면 뜻은 하나다: **이 트윈에 맞지 않는 어휘가 들어오고 있다**(커넥터 배선 오류이거나
-     * 커널이 낡았다). 세는 것에 그치고 판단은 소비처가 한다 — 여기서 던지면 저널 재생이 멈춘다.
+     * 커널이 낡았다). 세는 것에 그치고 판단은 소비처가 한다 — 여기서 오류를 내면 저널 재생이 멈춘다.
      */
     unhandled?: {
         eventType: string;

package/dist/observed-reducer.js

@@ -19,7 +19,7 @@
  *  - 운영 델타(task/equipment/order.status) → tasks·equipment·orders (EPCIS 로 재구성 불가한 절반)
  * 마스터(로케이션)는 board 초기화 + applyMaster 로 갱신(마스터 동기).
  */
-import { OP_EVENT, capabilityOf, requiredTestsFor, locationStatusOf, readBoardEquipment, readBoardLocations, readBoardAssets, effectivityAt, offCalendarAt, offCalendarReasonAt, activeShiftAt } from "./contract.js";
+import { OP_EVENT, capabilityOf, itemKeyOf, requiredTestsFor, locationStatusOf, readBoardEquipment, readBoardLocations, readBoardAssets, effectivityAt, offCalendarAt, offCalendarReasonAt, activeShiftAt } from "./contract.js";
 import { ILMD_ATTR, parseEpc } from "./epcis.js";
 /**
  * 투영이 들고 있는 물품 — **계약(ItemState)을 축소하지 않는다.**
@@ -364,6 +364,8 @@ export class ObservedReducer {
                     /* 진행 중 확보분과 거래번호 — **미러도 같은 필드를 채운다.** 시뮬만 아는 사실을 두면
                        그 위에서 세운 예측이 두 구동에서 달라진다(패리티 검사가 지키는 것이 이것이다). */
                     ...(d.gtin ? { gtin: d.gtin } : {}),
+                    /* 어느 레시피로 만드는가 — 품목만으로는 「무엇으로」가 남지 않는다(같은 품목에 대체 레시피). */
+                    ...(d.recipeKey ? { recipeKey: d.recipeKey } : {}),
                     ...(d.allocated?.length ? { allocated: d.allocated.slice() } : {}),
                     ...(d.bizTransaction ? { bizTransaction: d.bizTransaction } : {}),
                     /* 약속해 둔 자리·시각창도 채운다 — 시뮬만 알면 미러 위 예측이 「어디로 들일지」를 모른다.
@@ -471,7 +473,7 @@ export class ObservedReducer {
                     if (!cur)
                         this.pendingQuantities.set(ev.parentID, [...ev.childQuantityList]);
                     else {
-                        this.items.set(cur.subLotId ?? cur.epc, this.withContainedQuantity(cur, q, ev.childQuantityList));
+                        this.items.set(itemKeyOf(cur), this.withContainedQuantity(cur, q, ev.childQuantityList));
                         this.qtyAggregation.set(ev.parentID, [...ev.childQuantityList]);
                     }
                 }
@@ -507,7 +509,7 @@ export class ObservedReducer {
                     const cur = this.items.get(ev.parentID);
                     if (cur) {
                         const { gtin, gtinKey, qty, uom, quantities, lot, ...rest } = cur;
-                        this.items.set(cur.subLotId ?? cur.epc, { ...rest, qty: 1 });
+                        this.items.set(itemKeyOf(cur), { ...rest, qty: 1 });
                     }
                 }
                 this.pendingQuantities.delete(ev.parentID);
@@ -593,7 +595,8 @@ export class ObservedReducer {
     all, 
     /** 로트의 부분 식별자(표준 `MaterialSubLot.ID`) — 비직렬 로트가 자리마다 갈릴 때. */
     subLotId) {
-        const cur = this.items.get(subLotId ?? epc);
+        /* 키 규칙은 한 곳에서만 정한다(§itemKeyOf) — 여기서 다시 적으면 두 벌이 되고 한쪽만 고쳐진다. */
+        const cur = this.items.get(itemKeyOf({ epc, subLotId }));
         /* 클래스는 수량 목록에서 오거나, 물품 자신이 클래스 식별자일 수 있다(비직렬 입고). */
         const parsedClass = q?.epcClass ? parseEpc(q.epcClass) : undefined;
         const parsedSelf = parseEpc(epc);

package/dist/yms-kernel.js

@@ -15,6 +15,7 @@
  *   - drop(기본): 트레일러를 야드 슬롯에 내려놓고(주차) 창 도래 시 호슬러가 도크로 pull. 야드 버퍼 사용.
  *   - live: 게이트에서 대기하다 창 도래 시 도크로 직행(야드 미경유). 게이트/도크를 더 오래 점유.
  */
+import { itemKeyOf } from "./contract.js";
 import { firstFitPolicy } from "./allocation-policy.js";
 import { FlowEngine } from "./flow-engine.js";
 import { DISP, objectEvent, transactionEvent, gdtiUri, ssccUri } from "./epcis.js";
@@ -33,7 +34,12 @@ const WINDOW_DELAY_MS = 40_000; // 도착 후 어포인트먼트 창까지(early
  */
 const WINDOW_LENGTH_MS = 20 * 60_000;
 const CARGO_PER_TRAILER = 2; // 트레일러 적재/하역 화물(SSCC) 수
-const CP = '0614141';
+/**
+ * 이 내장 시나리오가 쓰는 **날조된 회사 프리픽스** — 선언이 없는 트윈만 이 길로 온다.
+ * 근거·처분은 WMS 커널의 같은 상수 주석에 있다(`kernel.ts`). 이름의 `LEGACY_` 는 새 코드가 무심코
+ * 집어 들지 못하게 하는 표시다 — 이 상수를 지나는 트윈은 `fabricated` 로 판정된다.
+ */
+const LEGACY_CP = '0614141';
 export class YmsKernel extends FlowEngine {
     doorRR = 0;
     cargoSeq = 0;
@@ -58,19 +64,19 @@ export class YmsKernel extends FlowEngine {
         if (!gate || doors.length === 0)
             return;
         const inbound = kind === 'appointment';
-        const epc = graiUri(CP, '10', ++this.epcSeq);
+        const epc = graiUri(LEGACY_CP, '10', ++this.epcSeq);
         this.items.set(epc, { epc, location: gate.id, disposition: DISP.in_progress });
         gate.occupancy++;
         this.emit(objectEvent({ eventTime: this.now(), action: 'ADD', bizStep: YARD_BIZSTEP.arriving, disposition: DISP.in_progress, epcList: [epc], readPoint: gate.id, bizLocation: gate.id }));
         // 인바운드: 화물 적재된 채 도착 → 조립(트레일러←화물) 기록. 아웃바운드: 빈 트레일러(화물은 도크에서 적재).
         if (inbound) {
-            const cargo = Array.from({ length: CARGO_PER_TRAILER }, () => ssccUri(CP, ++this.cargoSeq));
+            const cargo = Array.from({ length: CARGO_PER_TRAILER }, () => ssccUri(LEGACY_CP, ++this.cargoSeq));
             this.trailerCargo.set(epc, cargo);
             this.aggregate(epc, cargo, { bizStep: YARD_BIZSTEP.arriving, readPoint: gate.id }); // 적재된 채 도착(자식 opaque, 미materialize)
         }
         const door = doors[this.doorRR++ % doors.length];
         const id = `order-${++this.orderSeq}`;
-        const appt = gdtiUri(CP, '404', ++this.soSeq);
+        const appt = gdtiUri(LEGACY_CP, '404', ++this.soSeq);
         const order = { id, kind, status: 'created', requested: 1, fulfilled: 0, bizTransaction: appt, allocated: [epc], picked: [], dockDoor: door.id,
             /* 내부 스케줄 게이트(시뮬 ms) — 표준 `EarliestStartTime` 과 같은 개념의 우리 단위. */
             windowStartMs: this.clockMs + WINDOW_DELAY_MS,
@@ -163,7 +169,8 @@ export class YmsKernel extends FlowEngine {
         const to = this.locations.get(t.toNode);
         from.occupancy--;
         to.occupancy++;
-        trailer.location = to.id;
+        /* 자리 이동은 저장소 통로로 — 직접 고치면 자리별 색인이 어긋난다. */
+        this.items.relocate(itemKeyOf(trailer), to.id);
         if (t.kind === 'dwell') {
             // 도크 체류(무자원 dwell) 완료 → 출차 이동(transport). 체류 중 호슬러 미점유(drop-and-hook 충실).
             const gate = this.locationByType('gate');