@operato/twin-kernel 0.11.22 → 0.11.24

package/dist/flow-engine.d.ts

@@ -1,4 +1,4 @@
-import type { MaterialActual, RecipeExecutionBasis, TestResult, ISOTime, MaterialQuantity, WorkCalendarEntry, EffectivePeriod, Effectivity, OffCalendarReason, ResourceProperty, ResourceClassDef, MaterialDefinition, Attention, TwinModelDef, CanonicalEnvelope, Command, CommandAck, EventHandler, EquipmentMotion, AssetState, GeneratorSpec, InterventionOutcome, OrderState, PersonState, ScenarioControl, ScenarioOverride, StateSnapshot, TwinKernel, Unsubscribe, LocationState, ItemState, EquipmentState, OrderStatusDelta, TaskState, TaskStatus, StructureShift, IdentityGroundingView, IdentityDeclaration, TestSpecificationCriterion, LocationObservation, DispositionFact, AllocatedQuantity, MaterialLotUse } from '@operato/ops-contract';
+import type { MaterialActual, RecipeExecutionBasis, MaterialExecutionBasis, TestResult, ISOTime, MaterialQuantity, WorkCalendarEntry, EffectivePeriod, Effectivity, OffCalendarReason, ResourceProperty, ResourceClassDef, MaterialDefinition, Attention, TwinModelDef, CanonicalEnvelope, Command, CommandAck, EventHandler, EquipmentMotion, AssetState, GeneratorSpec, InterventionOutcome, OrderState, PersonState, ScenarioControl, ScenarioOverride, StateSnapshot, TwinKernel, Unsubscribe, LocationState, ItemState, EquipmentState, OrderStatusDelta, TaskState, TaskStatus, StructureShift, IdentityGroundingView, IdentityDeclaration, TestSpecificationCriterion, LocationObservation, DispositionFact, AllocatedQuantity, MaterialLotUse } from '@operato/ops-contract';
 import { type RatedUsage, type UsedUsage } from '@operato/ops-contract';
 import type { VocabularyElement } from '@operato/ops-contract';
 import type { ReducerCheckpoint } from './observed-reducer.ts';
@@ -197,6 +197,7 @@ export interface FlowTask {
      * 채널에 실어야 실적을 **한 곳에서** 읽는다(EPCIS 이벤트에서 다시 계산하려면 작업과 잇는 끈이 없다).
      */
     materialActual?: MaterialActual[];
+    workShiftBasis?: import('@operato/ops-contract').WorkShiftExecutionBasis;
     itemEpc: string;
     fromNode: string;
     toNode: string;
@@ -271,6 +272,7 @@ export declare function allocatedQty(rows: readonly AllocatedQuantity[] | undefi
 /** 잡아 둔 줄들의 식별자 — EPCIS 이벤트가 싣는 것은 열쇠뿐이다. */
 export declare function allocatedEpcs(rows: readonly AllocatedQuantity[] | undefined): string[];
 export interface FlowOrder {
+    materialBasis?: MaterialExecutionBasis[];
     recipeBasis?: RecipeExecutionBasis;
     id: string;
     kind: string;
@@ -498,6 +500,9 @@ export declare class ItemStore {
      * 사라진다**(있는데 없다고 판정된다). 자리 색인과 같은 규율이다.
      */
     private byGtin;
+    /** 같은 글자를 매번 뜯지 않는다 — 클래스 글자의 종류는 적고 물품은 많다. */
+    private itemClassCache;
+    private itemClass;
     get size(): number;
     get(key: string): FlowItem | undefined;
     has(key: string): boolean;

package/dist/flow-engine.js

@@ -9,7 +9,8 @@
  * 통합 타입은 도메인 필드를 옵셔널로 넓혀(FlowItem.gtin?, FlowOrder.shipmentEpc? 등) 두 도메인을 담는다.
  * (roadmap Phase5 발견 → 추출. [[project_flow_single_base_vision]] FlowLocation 단일 base 방향과 정합.)
  */
-import { OP_EVENT, CMD, USE_UOM, locationStatusOf, readBoardEquipment, equipmentClassMembership, readBoardLocations, readBoardAssets, classClosure, capabilityOf, requiredTestsFor, priorityRank, dueStatusOf, isOrderTerminal, effectivityAt, offCalendarAt, offCalendarReasonAt, minuteOfDayAt, activeShiftAt, subLotIdOf, itemKeyOf, identityGroundingOf, outsideLimit, computeOee } from '@operato/ops-contract';
+import { isWorkShiftExecutionBasis } from '@operato/ops-contract';
+import { OP_EVENT, CMD, USE_UOM, locationStatusOf, readBoardEquipment, equipmentClassMembership, readBoardLocations, readBoardAssets, classClosure, capabilityOf, requiredTestsFor, priorityRank, dueStatusOf, isOrderTerminal, effectivityAt, offCalendarAt, offCalendarReasonAt, minuteOfDayAt, activeShiftAt, subLotIdOf, itemKeyOf, itemClassOf, identityGroundingOf, outsideLimit, computeOee } from '@operato/ops-contract';
 import { ObservedReducer } from "./observed-reducer.js";
 /* 주체를 정하는 규칙은 유입 문과 한 벌이다 — 두 곳에 적으면 한쪽만 고쳐진다. */
 import { resolveSubject } from '@operato/ops-contract';
@@ -406,7 +407,21 @@ export class ItemStore {
      * 색인을 밖에 따로 두지 않는다 — 갱신하는 자리가 흩어지면 한 자리라도 빠뜨렸을 때 **재고가 조용히
      * 사라진다**(있는데 없다고 판정된다). 자리 색인과 같은 규율이다.
      */
+    /*
+     * 품목 색인 — 키는 **품목 클래스**다(`itemClassOf`). 재고는 로트 클래스를 들고 오더는 품목 클래스를 묻는다
+     * (ADR-0076 ⑥ · ADR-0082 결정 2). 로트 글자를 키로 쓰면 품목을 물어도 로트 재고가 안 나온다.
+     */
     byGtin = new Map();
+    /** 같은 글자를 매번 뜯지 않는다 — 클래스 글자의 종류는 적고 물품은 많다. */
+    itemClassCache = new Map();
+    itemClass(gtin) {
+        let c = this.itemClassCache.get(gtin);
+        if (c === undefined) {
+            c = itemClassOf(gtin) ?? gtin;
+            this.itemClassCache.set(gtin, c);
+        }
+        return c;
+    }
     get size() {
         return this.map.size;
     }
@@ -514,7 +529,7 @@ export class ItemStore {
     }
     /** 그 품목인 물품들 — 색인이 답한다(자리를 모를 때 쓴다). */
     ofGtin(gtin) {
-        const keys = this.byGtin.get(gtin);
+        const keys = this.byGtin.get(this.itemClass(gtin));
         if (!keys)
             return [];
         const out = [];
@@ -548,7 +563,7 @@ export class ItemStore {
         }
         /* 품목 색인도 같은 규율로 본다 — 어긋나면 자재가 있는데 없다고 판정된다. */
         for (const [key, it] of this.map) {
-            if (it.gtin && !this.byGtin.get(it.gtin)?.has(key))
+            if (it.gtin && !this.byGtin.get(this.itemClass(it.gtin))?.has(key))
                 drift.push(`${key} 이 품목 '${it.gtin}' 색인에 없다`);
         }
         for (const [g, keys] of this.byGtin) {
@@ -556,7 +571,7 @@ export class ItemStore {
                 const it = this.map.get(k);
                 if (!it)
                     drift.push(`${k} 이 지워졌는데 품목 '${g}' 색인에 남아 있다`);
-                else if (it.gtin !== g)
+                else if (this.itemClass(it.gtin ?? '') !== g)
                     drift.push(`${k} 은 품목 '${it.gtin}' 인데 '${g}' 색인에 있다`);
             }
         }
@@ -565,9 +580,10 @@ export class ItemStore {
     index(key, location, gtin) {
         this.indexLocation(key, location);
         if (gtin) {
-            const set = this.byGtin.get(gtin) ?? new Set();
+            const g = this.itemClass(gtin);
+            const set = this.byGtin.get(g) ?? new Set();
             set.add(key);
-            this.byGtin.set(gtin, set);
+            this.byGtin.set(g, set);
         }
     }
     indexLocation(key, location) {
@@ -578,12 +594,13 @@ export class ItemStore {
     unindex(key, location, gtin) {
         this.unindexLocation(key, location);
         if (gtin) {
-            const set = this.byGtin.get(gtin);
+            const g = this.itemClass(gtin);
+            const set = this.byGtin.get(g);
             if (!set)
                 return;
             set.delete(key);
             if (!set.size)
-                this.byGtin.delete(gtin);
+                this.byGtin.delete(g);
         }
     }
     unindexLocation(key, location) {
@@ -1050,6 +1067,10 @@ export class FlowEngine {
      * 그래서 규칙을 둘로 쪼개지 않고 **목적을 밝힌다.** 같은 함수, 같은 주입 경로, 다른 판정 하나다.
      */
     purpose = 'seed') {
+        for (const task of snap.tasks ?? []) {
+            if (task.workShiftBasis !== undefined && !isWorkShiftExecutionBasis(task.workShiftBasis))
+                throw new Error('Invalid pinned work shift evidence');
+        }
         /* 확인 처리를 먼저 이어받는다 — 아래에서 상태를 주입하면 곧바로 주목 신호가 계산되므로, 늦게
          * 이어받으면 그 한 번은 확인 안 된 것으로 계산된다(화면이 잠깐 빨개진다). */
         for (const id of snap.acked ?? [])
@@ -1242,6 +1263,7 @@ export class FlowEngine {
                 ...(o.gtin ? { gtin: o.gtin } : {}),
                 ...(o.recipeKey ? { recipeKey: o.recipeKey } : {}),
                 ...(o.recipeBasis ? { recipeBasis: structuredClone(o.recipeBasis) } : {}),
+                ...(o.materialBasis ? { materialBasis: structuredClone(o.materialBasis) } : {}),
                 ...(o.bizTransaction ? { bizTransaction: o.bizTransaction } : {}),
                 ...(o.dockDoor ? { dockDoor: o.dockDoor } : {}),
                 ...(o.windowStartMs !== undefined ? { windowStartMs: o.windowStartMs } : {})
@@ -1305,6 +1327,7 @@ export class FlowEngine {
                    남은 공정·소요가 다른 레시피 기준으로 계산된다(같은 품목에 대체 레시피가 있다). */
                 ...(o.recipeKey ? { recipeKey: o.recipeKey } : {}),
                 ...(o.recipeBasis ? { recipeBasis: structuredClone(o.recipeBasis) } : {}),
+                ...(o.materialBasis ? { materialBasis: structuredClone(o.materialBasis) } : {}),
                 bizTransaction: o.bizTransaction ?? '', allocated: resolved.kept, picked: [], shipmentEpc: null,
                 /* 라인도 같다 — 씨앗은 남은 양만 남기고, 미러는 원본이 말한 요청·이행을 그대로 든다. */
                 lines: observing ? (o.lines ?? []).map(l => ({ ...l })) : lines,
@@ -1368,6 +1391,7 @@ export class FlowEngine {
                 status: purpose === 'observe' ? t.status : known && t.status === 'in-progress' ? 'in-progress' : 'created',
                 /* 이미 일어난 자재 이동은 **씨앗에도 남는다** — 잃으면 실적이 재기동마다 지워진다. */
                 ...(t.materialActual?.length ? { materialActual: t.materialActual.map(r => ({ ...r })) } : {}),
+                ...(t.workShiftBasis ? { workShiftBasis: structuredClone(t.workShiftBasis) } : {}),
                 itemEpc: t.itemRefs?.[0] ?? '',
                 fromNode: t.fromNode ?? '', toNode: t.toNode ?? '',
                 /*
@@ -1802,6 +1826,7 @@ export class FlowEngine {
                 ...(t.assets?.length ? { assets: t.assets.slice() } : {}),
                 ...(t.resources?.length ? { resources: t.resources.slice() } : {}),
                 ...(t.materialActual?.length ? { materialActual: t.materialActual.map(r => ({ ...r })) } : {}),
+                ...(t.workShiftBasis ? { workShiftBasis: structuredClone(t.workShiftBasis) } : {}),
                 ...(t.priority !== undefined ? { priority: t.priority } : {}),
                 ...(t.startTime ? { startTime: t.startTime } : {}),
                 ...(t.endTime ? { endTime: t.endTime } : {})
@@ -1823,6 +1848,7 @@ export class FlowEngine {
                 /* **어느 레시피로 만드나** — 품목만으로는 「무엇으로」가 안 남는다(같은 품목의 대체 레시피가 있다). */
                 ...(o.recipeKey ? { recipeKey: o.recipeKey } : {}),
                 ...(o.recipeBasis ? { recipeBasis: structuredClone(o.recipeBasis) } : {}),
+                ...(o.materialBasis ? { materialBasis: structuredClone(o.materialBasis) } : {}),
                 /* 씨앗이 다 심지 못했다는 사실 — 조용히 자르지 않는다(그 오더의 답은 부족한 씨앗 위에 있다). */
                 ...(o.seedIncomplete ? { seedIncomplete: true } : {}),
                 /* 왜 대기하는지 — 없으면 화면은 「running」만 보여 주고 사람은 원인을 찾을 자리가 없다. */
@@ -2954,6 +2980,7 @@ export class FlowEngine {
             ...(t.resources?.length ? { resources: t.resources.slice() } : {}),
             /* 실제 자재 이동 — 인원·설비와 같은 채널(실적을 한 곳에서 읽는다). */
             ...(t.materialActual?.length ? { materialActual: t.materialActual.map(r => ({ ...r })) } : {}),
+            ...(t.workShiftBasis ? { workShiftBasis: structuredClone(t.workShiftBasis) } : {}),
             ...(t.durationMs ? { durationMs: t.durationMs } : {}),
             /* 품질 판정이 있었으면 **그 자리에서** 실어 보낸다 — 없으면 필드를 만들지 않는다(모름≠양품). */
             ...(t.outcome ? { outcome: t.outcome } : {}),
@@ -2993,6 +3020,7 @@ export class FlowEngine {
                레시피가 있다). 시뮬만 아는 사실이 남으면 두 스냅샷을 같은 규칙으로 읽을 수 없다. */
             ...(o.recipeKey ? { recipeKey: o.recipeKey } : {}),
             ...(o.recipeBasis ? { recipeBasis: structuredClone(o.recipeBasis) } : {}),
+            ...(o.materialBasis ? { materialBasis: structuredClone(o.materialBasis) } : {}),
             ...(o.allocated?.length ? { allocated: o.allocated.slice() } : {}),
             ...(o.bizTransaction ? { bizTransaction: o.bizTransaction } : {}),
             /* 약속해 둔 자리·시각창 — 이것이 빠져서 야드 트윈이 재기동마다 첫 틱에 죽었다(§dockDoor). */
@@ -3197,7 +3225,7 @@ export class FlowEngine {
             for (const it of this.items.at(at)) {
                 if (remaining <= 0)
                     break;
-                if (!this.materialMatches(it, req))
+                if (!this.materialMatches(it, req, t.orderId))
                     continue;
                 /*
                  * 변환 중인 것은 잡지 않는다 — 어떤 공정이 이미 먹어 그 단계의 산출로 바뀔 물품이다
@@ -3221,12 +3249,13 @@ export class FlowEngine {
         return picked;
     }
     /** 이 물품이 명세를 만족하나 — 품목 지목이 우선, 없으면 등급(상속을 타고 닫는다). */
-    materialMatches(it, req) {
+    materialMatches(it, req, orderId) {
         const defId = it.definitionId ?? it.gtin;
         if (req.materialDefinition)
             return defId === req.materialDefinition;
         if (req.materialClass) {
-            const def = defId ? this.materialDefs.get(defId) : undefined;
+            const basis = orderId ? this.orders.get(orderId)?.materialBasis : undefined;
+            const def = basis !== undefined ? basis.find(b => b.material.id === defId)?.material : defId ? this.materialDefs.get(defId) : undefined;
             return classClosure(def?.materialClassIds, this.classDefs.material, this.now()).has(req.materialClass);
         }
         return true; // 지목도 등급도 없으면 아무 자재나(명세가 그렇게 느슨하면 그대로 따른다)

package/dist/kernel.js

@@ -11,7 +11,7 @@ import { FlowEngine, allocatedQty } from "./flow-engine.js";
 import { planMakeToOrder } from "./make-to-order.js";
 import { BIZSTEP, BTT, WMS_ORDER_KIND } from '@operato/ops-contract';
 import { DISP, ILMD_ATTR, aggregationEvent, objectEvent, transactionEvent } from '@operato/ops-contract';
-import { subLotIdOf, itemKeyOf } from '@operato/ops-contract';
+import { subLotIdOf, itemKeyOf, sameItemClass, lotClassOfItem } from '@operato/ops-contract';
 const TRAVEL_MS = 30_000;
 const SHELF_MS = 30 * 24 * 3_600_000; // 기본 유통기한(30일)
 const SHELF_JITTER_MS = 5 * 24 * 3_600_000; // 로트별 만료 편차(FEFO 가 FIFO 와 갈리게)
@@ -57,8 +57,30 @@ export class WmsKernel extends FlowEngine {
         /* 발주 문서 식별자 — 선언된 이름공간 아래(CBV §8.5.5) 또는 선언된 GDTI 문서 타입. */
         const po = this.requireBizTransactionId(`PO-${poSeq}`, 'purchaseorder');
         const eventTime = this.now();
-        const qtyList = [{ epcClass: gtin, quantity: qty }];
+        /*
+         * ── 도착은 로트를 든다 (2026-09-24, ADR-0076 ⑥ · ADR-0082 결정 2) ──────────
+         * 로트는 발주 하나에 하나다(`L-<발주 번호>`) — rng 를 더 쓰지 않으므로 같은 씨앗이면 같은 사건이다.
+         * 케이스의 클래스는 계약이 만든 로트 클래스이고(`lotClassOfItem` → `lotClassUri`), plant · warehouse 가 보내는
+         * 로트와 같은 글자다. 오더 줄은 품목을 묻고 재고는 로트를 들므로 맞춤은 `sameItemClass` 가 한다.
+         *
+         * 선언된 품목이 로트를 붙일 수 없는 모양이면(식별자가 아닌 낱말) 품목 클래스 그대로 싣는다 — 로트를
+         * 말하지 않을 뿐 거짓은 없다. 자리 수가 틀린 GTIN 은 시나리오 검사가 선언에서 거절한다.
+         */
+        const lot = `L-${poSeq}`;
+        const lotClass = lotClassOfItem(gtin, lot) ?? gtin;
+        const qtyList = [{ epcClass: lotClass, quantity: qty }];
         const poTxn = [{ type: BTT.po, bizTransaction: po }];
+        /*
+         * **입고 오더가 도착보다 먼저 선다**(ADR-0076 ⑥, 판정 2026-09-24 — 물음 2 의 A). 「무엇이 오기로 되어
+         * 있었나」가 저널에 먼저 있어야 미러도 같은 순서로 안다. 리드 타임은 쓰는 소비자가 생길 때 연다.
+         * 배차 · 흐름 지표는 받는 오더를 이미 뺀다(`isFlowOrder`).
+         */
+        const inbound = {
+            id: `inbound-${poSeq}`, kind: WMS_ORDER_KIND.inbound, status: 'created', requested: qty, fulfilled: 0, bizTransaction: po,
+            allocated: [], picked: [], shipmentEpc: null, lines: [{ gtin, requested: qty }]
+        };
+        this.orders.set(inbound.id, inbound);
+        this.emitOrder(inbound);
         // 로트 만료(FEFO 용, 결정적 — rng 무소비로 byte-identical 유지). 편차로 도착순≠만료순 → FEFO 가 유의미.
         const expiry = this.clockMs + SHELF_MS - (this.epcSeq % 5) * SHELF_JITTER_MS;
         /* 방출한 마스터데이터를 **상태에도 들고 있는다** — 자기가 선언한 것을 자기가 모르면, 미러는 알고
@@ -68,7 +90,7 @@ export class WmsKernel extends FlowEngine {
          * 들어온 시각을 재고가 들고 있는다 — 「먼저 들어온 것 먼저」를 할 수 있는 유일한 근거다.
          * 값은 **receiving 이 일어난 시각**이고(수집 시각이 아니다), 여기서는 그 둘이 같다.
          */
-        this.items.set(epc, { epc, gtin, qty, location: dock.id, disposition: DISP.in_progress, expiry, ilmd, receivedAtMs: this.nowMs() });
+        this.items.set(epc, { epc, gtin: lotClass, qty, location: dock.id, disposition: DISP.in_progress, expiry, ilmd, receivedAtMs: this.nowMs() });
         dock.occupancy++;
         this.emit(transactionEvent({ eventTime, action: 'ADD', bizStep: BIZSTEP.receiving, bizTransactionList: poTxn, epcList: [epc], quantityList: qtyList, readPoint: dock.id }));
         this.emit(aggregationEvent({ eventTime, action: 'ADD', bizStep: BIZSTEP.receiving, parentID: epc, childQuantityList: qtyList, readPoint: dock.id }));
@@ -79,6 +101,11 @@ export class WmsKernel extends FlowEngine {
             epcList: [epc], quantityList: qtyList, readPoint: dock.id, bizLocation: dock.id, bizTransactionList: poTxn,
             ilmd
         }));
+        /* 수령했으므로 입고 오더를 이행하고 닫는다 — 시뮬에서 입고 오더를 닫는 것은 커널이다(ADR-0076 ⑥). */
+        inbound.fulfilled = qty;
+        inbound.status = 'completed';
+        this.emitOrder(inbound);
+        /* 적치는 품목으로 판단한다(같은 품목을 모으는 정책) — 로트가 아니라 품목 클래스를 넘긴다. */
         const binId = this.policy.selectPlacement({ item: { epc, gtin, qty }, slots: this.slotViews('storage') });
         if (!binId)
             return; // 수용 불가 → 도크 대기
@@ -156,7 +183,7 @@ export class WmsKernel extends FlowEngine {
         const staging = this.builtInLocation('staging', 'picked pallets wait here before shipping');
         const chosenAll = [];
         for (const line of o.lines) {
-            const already = allocatedQty(o.allocated.filter(a => this.items.get(a.epc)?.gtin === line.gtin));
+            const already = allocatedQty(o.allocated.filter(a => sameItemClass(this.items.get(a.epc)?.gtin, line.gtin)));
             const need = line.requested - already;
             if (need <= 0)
                 continue;
@@ -171,7 +198,7 @@ export class WmsKernel extends FlowEngine {
              * 모두 표현할 수 있고, **단위를 정하는 것은 부르는 쪽**이다.
              */
             const available = [...this.items.values()]
-                .filter(i => i.gtin === line.gtin && i.disposition === DISP.sellable && this.locations.get(i.location)?.type === 'storage')
+                .filter(i => sameItemClass(i.gtin, line.gtin) && i.disposition === DISP.sellable && this.locations.get(i.location)?.type === 'storage')
                 .filter(i => this.usableLot(i))
                 .map(i => ({ epc: i.epc, location: i.location, qty: 1, expiry: i.expiry, ...(i.receivedAtMs !== undefined ? { receivedAtMs: i.receivedAtMs } : {}) }));
             const chosen = this.policy.selectStock({ gtin: line.gtin, qty: need, available });
@@ -264,7 +291,7 @@ export class WmsKernel extends FlowEngine {
         const locations = [...this.locations.values()].map(l => ({ id: l.id, type: l.type }));
         const ops = this.declaredOperations();
         for (const line of o.lines) {
-            const have = stock.filter(s => s.gtin === line.gtin && s.sellable && this.locations.get(s.location)?.type === 'storage')
+            const have = stock.filter(s => sameItemClass(s.gtin, line.gtin) && s.sellable && this.locations.get(s.location)?.type === 'storage')
                 .reduce((n, s) => n + s.qty, 0);
             const short = line.requested - have;
             if (short <= 0)
@@ -301,7 +328,7 @@ export class WmsKernel extends FlowEngine {
     }
     /** 부품을 작업대로 — 팔레트 이동이므로 피킹과 같은 기제다(부분 소비는 코어가 한다). */
     issueFeed(o, gtin, from, to, qty) {
-        const src = [...this.items.values()].find(i => i.gtin === gtin && i.location === from && i.disposition === DISP.sellable);
+        const src = [...this.items.values()].find(i => sameItemClass(i.gtin, gtin) && i.location === from && i.disposition === DISP.sellable);
         if (!src)
             return;
         /* 이송 중에 다른 오더가 같은 팔레트를 집지 않게 예약으로 바꾼다 — 코어의 자재 게이트는
@@ -389,7 +416,7 @@ export class WmsKernel extends FlowEngine {
         if (order.lines)
             for (const epc of order.picked) {
                 const g = this.items.get(epc)?.gtin;
-                const line = order.lines.find(l => l.gtin === g && l.requested > 0);
+                const line = order.lines.find(l => sameItemClass(l.gtin, g) && l.requested > 0);
                 if (line)
                     line.requested--;
             }

package/dist/make-to-order.js

@@ -21,6 +21,7 @@
  * 그래서 한 오더가 부르는 것은 세 걸음이다: **부품 이송 → 가공 → 되돌리기.** 이 모듈은 그중
  * "지금 무엇을 발행해야 하나" 를 답한다 — 이송이 아직 안 끝났으면 가공을 발행하지 않는다.
  */
+import { sameItemClass } from '@operato/ops-contract';
 /** 품목 → 그것을 산출하는 공정. 선언에서 파생한다(코드에 표를 두지 않는다). */
 export function producedByIndex(ops) {
     const idx = new Map();
@@ -113,6 +114,6 @@ export function planMakeToOrder(gtin, shortQty, ops, stock, locations) {
 /** 이 재고가 명세를 만족하나 — 품목 지목만 본다(등급 상속은 엔진이 안다). */
 function matches(s, req) {
     if (req.materialDefinition)
-        return s.gtin === req.materialDefinition;
+        return sameItemClass(s.gtin, req.materialDefinition);
     return false;
 }

package/dist/mes-kernel.js

@@ -8,7 +8,7 @@
  *  ③ 셋업/체인지오버 = work-center 가 제품 전환 시 셋업(changeoverKey=제품 gtin) → OEE Availability.
  *  ④ OEE = base 가 설비(설비)별 계측(가동/셋업/기아/품질). cut=cutter·weld=welder 이종 자원.
  */
-import { identityGroundingOf, procedureViolations, isRecipeExecutionBasis } from '@operato/ops-contract';
+import { identityGroundingOf, procedureViolations, isRecipeExecutionBasis, sameItemClass } from '@operato/ops-contract';
 import { firstFitPolicy } from "./allocation-policy.js";
 import { FlowEngine, allocatedEpcs, allocatedQty } from "./flow-engine.js";
 import { DISP, objectEvent, transactionEvent, gdtiUri, sgtinClass, bizTransactionUri } from '@operato/ops-contract';
@@ -820,7 +820,7 @@ export class MesKernel extends FlowEngine {
             if (fromType) {
                 for (const n of locsOfType.get(fromType) ?? []) {
                     for (const i of this.items.at(n.id)) {
-                        if (i.gtin === g && i.disposition === DISP.sellable)
+                        if (sameItemClass(i.gtin, g) && i.disposition === DISP.sellable)
                             available.push({ epc: i.epc, location: i.location, qty: 1 });
                     }
                 }

package/dist/observed-reducer.js

@@ -19,7 +19,7 @@
  *  - 운영 델타(task/equipment/order.status) → tasks·equipment·orders (EPCIS 로 재구성 불가한 절반)
  * 마스터(로케이션)는 board 초기화 + applyMaster 로 갱신(마스터 동기).
  */
-import { computeOee } from '@operato/ops-contract';
+import { computeOee, isWorkShiftExecutionBasis } from '@operato/ops-contract';
 import { OP_EVENT, capabilityOf, itemKeyOf, judgeAgainstSpec, requiredTestsFor, locationStatusOf, readBoardEquipment, readBoardLocations, readBoardAssets, effectivityAt, offCalendarAt, offCalendarReasonAt, activeShiftAt } from '@operato/ops-contract';
 import { ILMD_ATTR, parseEpc } from '@operato/ops-contract';
 import { expiryFromAttributes, lotFromAttributes } from '@operato/ops-contract';
@@ -345,6 +345,8 @@ export class ObservedReducer {
         switch (e.eventType) {
             case OP_EVENT.task: {
                 const d = e.data;
+                if (d.workShiftBasis !== undefined && !isWorkShiftExecutionBasis(d.workShiftBasis))
+                    throw new Error('Invalid pinned work shift evidence');
                 if (this.stale(`task:${d.taskId}`, e))
                     return;
                 /* 커널이 실어 보낸 것을 그대로 담는다 — 진척·남은 시간·의도가 있어야 이 상태를 씨앗으로
@@ -387,6 +389,7 @@ export class ObservedReducer {
                     ...(d.resources?.length ? { resources: d.resources.slice() } : {}),
                     /* 실제 자재 이동 — 인원·설비와 같은 채널로 온다(실적을 한 곳에서 읽는다).
                        말하지 않았으면 **앞의 것을 지킨다**(위 주석) — 빈 배열은 「지웠다」로 말한 것이다. */
+                    ...(d.workShiftBasis ? { workShiftBasis: structuredClone(d.workShiftBasis) } : prevTask?.workShiftBasis ? { workShiftBasis: structuredClone(prevTask.workShiftBasis) } : {}),
                     ...(d.materialActual?.length
                         ? { materialActual: d.materialActual.map(r => ({ ...r })) }
                         : keptActual?.length
@@ -509,6 +512,8 @@ export class ObservedReducer {
                  * **지금 상태를 바꾸지 않는다.** 어제의 구간이 오늘의 상태가 되면 안 된다.
                  */
                 const d = e.data;
+                if (d.workShiftBasis !== undefined && !isWorkShiftExecutionBasis(d.workShiftBasis))
+                    throw new Error('Invalid pinned work shift evidence');
                 if (!d?.moverId || !d?.from || !d?.to)
                     break;
                 const from = Date.parse(d.from);
@@ -723,6 +728,7 @@ export class ObservedReducer {
                     /* 어느 레시피로 만드는가 — 품목만으로는 「무엇으로」가 남지 않는다(같은 품목에 대체 레시피). */
                     ...(d.recipeKey ? { recipeKey: d.recipeKey } : {}),
                     ...(d.recipeBasis ? { recipeBasis: structuredClone(d.recipeBasis) } : {}),
+                    ...(d.materialBasis ? { materialBasis: structuredClone(d.materialBasis) } : {}),
                     ...(d.allocated?.length ? { allocated: d.allocated.slice() } : {}),
                     ...(d.bizTransaction ? { bizTransaction: d.bizTransaction } : {}),
                     /* 이행하는 계획 — 「이 계획이 얼마나 됐나」를 이 값으로 묶어 답한다(§`OrderState.operationsRequestId`). */
@@ -1321,7 +1327,7 @@ export class ObservedReducer {
             /* 수량으로 담긴 것도 이어받는다 — 되풀어 주지 않는 축이다(원천은 담김을 다시 말해 주지 않는다). */
             qtyAggregation: [...this.qtyAggregation.entries()].map(([parent, quantities]) => ({ parent, quantities })),
             pendingQuantities: [...this.pendingQuantities.entries()].map(([parent, quantities]) => ({ parent, quantities })),
-            tasks: [...this.tasks.values()].map(t => ({ ...t })),
+            tasks: [...this.tasks.values()].map(t => structuredClone(t)),
             equipment: [...this.equipment.values()].map(m => ({ ...m })),
             persons: [...this.persons.values()].map(x => ({ ...x })),
             assets: [...this.assets.values()].map(x => ({ ...x })),
@@ -1349,6 +1355,10 @@ export class ObservedReducer {
      * 모델에서 오는 판정 입력(교대·등급·시간대)은 생성자가 이미 세웠으므로 건드리지 않는다.
      */
     restore(cp) {
+        for (const task of cp?.tasks ?? []) {
+            if (task.workShiftBasis !== undefined && !isWorkShiftExecutionBasis(task.workShiftBasis))
+                throw new Error('Invalid pinned work shift evidence');
+        }
         this.observations = new Map((cp?.observations ?? []).map(o => [o.id, new Map((o.values ?? []).map(v => [v.propertyId, { ...v }]))]));
         this.revision = cp?.revision ?? 0;
         this.master = new Map((cp?.master ?? []).map(n => [n.id, { ...n }]));
@@ -1359,7 +1369,7 @@ export class ObservedReducer {
         this.pendingParent = new Map((cp?.pendingParent ?? []).map(x => [x.child, x.parent]));
         this.qtyAggregation = new Map((cp?.qtyAggregation ?? []).map(x => [x.parent, x.quantities]));
         this.pendingQuantities = new Map((cp?.pendingQuantities ?? []).map(x => [x.parent, x.quantities]));
-        this.tasks = new Map((cp?.tasks ?? []).map(t => [t.id, { ...t }]));
+        this.tasks = new Map((cp?.tasks ?? []).map(t => [t.id, structuredClone(t)]));
         this.equipment = new Map((cp?.equipment ?? []).map(m => [m.id, { ...m }]));
         this.oeeCounters = new Map((cp?.oeeCounters ?? []).map((c) => [String(c.id), { ...emptyOeeCounters(), ...c, id: undefined }]));
         this.persons = new Map((cp?.persons ?? []).map(x => [x.id, { ...x }]));
@@ -1412,7 +1422,7 @@ export class ObservedReducer {
                만료는 이벤트 없이 시각만으로 일어나므로, 델타로 받아 두면 유휴 자원이 영원히 유효하게 남는다. */
             persons: [...this.persons.values()].map(p => ({ ...p, ...this.effectivityPart(p), ...this.offShiftPart(`person:${p.id}`), ...this.capabilityPart(p, `person:${p.id}`, p.personnelClassIds, this.classDefs.personnel) })),
             assets: [...this.assets.values()].map(a => ({ ...a, ...this.effectivityPart(a), ...this.capabilityPart(a, `asset:${a.id}`, a.assetClassIds, this.classDefs.asset) })),
-            tasks: [...this.tasks.values()].map(t => ({ ...t })),
+            tasks: [...this.tasks.values()].map(t => structuredClone(t)),
             equipment: [...this.equipment.values()].map(m => ({ ...m, ...this.oeePart(m.id), ...this.effectivityPart(m), ...this.offShiftPart(`eq:${m.id}`), ...this.capabilityPart(m, `eq:${m.id}`, m.kind ? [m.kind] : [], this.classDefs.equipment) })),
             orders: [...this.orders.values()].map(o => ({ ...o })),
             acked: [...this.acked]

package/dist-cjs/index.cjs

@@ -1629,12 +1629,19 @@ var ILMD_ATTR = {
   /** 로트·배치 번호(직렬 개체에 로트를 붙일 때). */
   lot: "cbvmda:lotNumber"
 };
+function lgtinClass(companyPrefix, itemRefAndIndicator, lot) {
+  return `urn:epc:class:lgtin:${companyPrefix}.${itemRefAndIndicator}.${encodeURIComponent(lot)}`;
+}
 function parseEpc(uri) {
   const raw = String(uri ?? "");
   if (/(?:\/obj\/|:obj:)[^/:\s]+$/.test(raw))
     return { scheme: "unknown", instance: true, uri: raw };
-  if (/(?:\/class\/|:class:)[^/:\s]+$/.test(raw))
-    return { scheme: "unknown", instance: false, uri: raw };
+  const inHouseClass = raw.match(/(?:\/class\/|:class:)([^/:\s]+)$/);
+  if (inHouseClass) {
+    const at = inHouseClass[1].indexOf(LOT_SEPARATOR);
+    const split = at > 0 ? decodedPair(inHouseClass[1].slice(0, at), inHouseClass[1].slice(at + LOT_SEPARATOR.length)) : void 0;
+    return split ? { scheme: "unknown", instance: false, item: split[0], lot: split[1], uri: raw } : { scheme: "unknown", instance: false, uri: raw };
+  }
   const cls = raw.match(/^urn:epc:class:lgtin:(.+)$/);
   if (cls) {
     const seg = cls[1].split(".");
@@ -1666,12 +1673,83 @@ function parseEpc(uri) {
   }
   return { scheme: "unknown", instance: false, uri: raw };
 }
+function decodedPair(item, lot) {
+  if (!lot)
+    return void 0;
+  try {
+    return [decodeURIComponent(item), decodeURIComponent(lot)];
+  } catch {
+    return void 0;
+  }
+}
+function itemClassOf(uri) {
+  if (!uri)
+    return void 0;
+  const parsed = parseEpc(uri);
+  if (parsed.scheme === "lgtin" && parsed.gtinKey)
+    return `urn:epc:idpat:sgtin:${parsed.gtinKey}.*`;
+  if (parsed.item !== void 0) {
+    const marker = /^(.*(?:\/class\/|:class:))[^/:\s]+$/.exec(parsed.uri);
+    if (marker)
+      return `${marker[1]}${parsed.item.replace(STRUCTURE_BREAKING, (c) => PERCENT_ENCODED[c])}`;
+  }
+  return parsed.uri;
+}
+function lotClassOfItem(itemClass, lot) {
+  if (!itemClass)
+    return void 0;
+  const idpat = /^urn:epc:idpat:sgtin:(\d+)\.(\d+)\.\*$/.exec(itemClass);
+  if (idpat)
+    return lotClassUri({ namespace: "", item: "", lot, gtin: `${idpat[1]}.${idpat[2]}` });
+  const parsed = parseEpc(itemClass);
+  if (parsed.instance || parsed.lot !== void 0)
+    return void 0;
+  const url = /^(https?:\/\/.+)\/class\/([^/:\s]+)$/.exec(itemClass);
+  const urn = /^(urn:.+):class:([^/:\s]+)$/.exec(itemClass);
+  const at = url ?? urn;
+  if (!at)
+    return void 0;
+  let item;
+  try {
+    item = decodeURIComponent(at[2]);
+  } catch {
+    return void 0;
+  }
+  return lotClassUri({ namespace: at[1], item, lot });
+}
+function sameItemClass(a, b) {
+  const x = itemClassOf(a);
+  return x !== void 0 && x === itemClassOf(b);
+}
 function gdtiUri(companyPrefix, docType, serial) {
   return `urn:epc:id:gdti:${companyPrefix}.${docType}.${serial}`;
 }
 function objectUri(namespace, objId) {
   return underNamespace(namespace, "obj", objId);
 }
+function lotClassUri(input) {
+  const item = String(input.item ?? "");
+  const lot = String(input.lot ?? "");
+  if (!lot)
+    throw new Error(`lotClassUri: \uB85C\uD2B8\uAC00 \uBE44\uC5C8\uB2E4 \u2014 \uB85C\uD2B8 \uC5C6\uB294 \uD488\uBAA9\uC740 classUri \uB85C \uBD80\uB978\uB2E4 (item=${item})`);
+  if (input.gtin !== void 0) {
+    const [prefix, ref, ...rest] = String(input.gtin).split(".");
+    if (!prefix || !ref || rest.length) {
+      throw new Error(`lotClassUri: gtin \uC740 'CompanyPrefix.ItemRefAndIndicator' \uC5EC\uC57C \uD55C\uB2E4: ${input.gtin}`);
+    }
+    const uri = lgtinClass(prefix, ref, lot);
+    const wrong = gs1KeyDigitViolation(uri);
+    if (wrong)
+      throw new Error(`lotClassUri: ${wrong}`);
+    return uri;
+  }
+  if (!item)
+    throw new Error(`lotClassUri: \uD488\uBC88\uC774 \uBE44\uC5C8\uB2E4 (lot=${lot})`);
+  const enc = (v) => v.replace(LOT_COMPONENT_BREAKING, (c) => PERCENT_ENCODED[c]);
+  return joinUnderNamespace(input.namespace, "class", `${enc(item)}${LOT_SEPARATOR}${enc(lot)}`);
+}
+var LOT_SEPARATOR = ";lot=";
+var LOT_COMPONENT_BREAKING = /[%/:?# ;]/g;
 function bizTransactionUri(namespace, transId) {
   return underNamespace(namespace, "bt", transId);
 }
@@ -1682,16 +1760,20 @@ var PERCENT_ENCODED = {
   ":": "%3A",
   "?": "%3F",
   "#": "%23",
-  " ": "%20"
+  " ": "%20",
+  /* 로트 클래스의 가르는 글자 — `lotClassUri` 만 쓴다(§`LOT_COMPONENT_BREAKING`). 표는 한 벌이다. */
+  ";": "%3B"
 };
 function underNamespace(namespace, marker, id) {
-  const ns = namespace?.trim();
-  if (!ns)
-    return void 0;
   const raw = String(id);
   if (!raw)
     return void 0;
-  const v = raw.replace(STRUCTURE_BREAKING, (c) => PERCENT_ENCODED[c]);
+  return joinUnderNamespace(namespace, marker, raw.replace(STRUCTURE_BREAKING, (c) => PERCENT_ENCODED[c]));
+}
+function joinUnderNamespace(namespace, marker, v) {
+  const ns = namespace?.trim();
+  if (!ns)
+    return void 0;
   if (/^https?:\/\/[^/\s]+/.test(ns))
     return `${ns.replace(/\/+$/, "")}/${marker}/${v}`;
   if (/^urn:epc(global)?:/.test(ns))
@@ -1802,6 +1884,30 @@ function transformationEvent(p) {
     e.bizTransactionList = p.bizTransactionList;
   return e;
 }
+var GS1_KEY_DIGITS = { sgtin: 13, lgtin: 13, sscc: 17, grai: 12, gdti: 12, sgln: 12 };
+function gs1KeyDigitViolation(uri) {
+  if (!uri)
+    return void 0;
+  const m = /^urn:epc:(?:id|idpat|class):([a-z]+):([^:]+)$/.exec(uri);
+  if (!m)
+    return void 0;
+  const want = GS1_KEY_DIGITS[m[1]];
+  if (!want)
+    return void 0;
+  const parts = m[2].split(".");
+  if (parts.length < 2)
+    return `${m[1]} \uD615\uC2DD \uC624\uB958: ${uri} \u2014 \uD68C\uC0AC \uD504\uB9AC\uD53D\uC2A4\uC640 \uCC38\uC870\uAC00 '.' \uB85C \uAC08\uB824\uC57C \uD55C\uB2E4`;
+  const [prefix, ref] = parts;
+  if (ref === "*")
+    return void 0;
+  if (!/^\d+$/.test(prefix) || !/^\d+$/.test(ref)) {
+    return `${m[1]} \uD615\uC2DD \uC624\uB958: ${uri} \u2014 \uD68C\uC0AC \uD504\uB9AC\uD53D\uC2A4\uC640 \uCC38\uC870\uB294 \uC22B\uC790\uB2E4`;
+  }
+  const got = prefix.length + ref.length;
+  if (got === want)
+    return void 0;
+  return `${m[1]} \uC790\uB9AC \uC218 \uC624\uB958: ${uri} \u2014 \uD68C\uC0AC \uD504\uB9AC\uD53D\uC2A4(${prefix.length}) + \uCC38\uC870(${ref.length}) = ${got} \uC774\uC9C0\uB9CC ${want} \uC5EC\uC57C \uD55C\uB2E4(GS1 TDS). \uD504\uB9AC\uD53D\uC2A4\uB97C \uBC14\uAFB8\uBA74 \uCC38\uC870 \uC790\uB9AC \uC218\uB97C \uD568\uAED8 \uB9DE\uCDB0\uC57C \uD55C\uB2E4.`;
+}
 
 // ../ops-contract/dist/iso-duration.js
 var RE = /^(-)?P(?:(\d+(?:\.\d+)?)W)?(?:(\d+(?:\.\d+)?)D)?(?:T(?:(\d+(?:\.\d+)?)H)?(?:(\d+(?:\.\d+)?)M)?(?:(\d+(?:\.\d+)?)S)?)?$/;
@@ -1846,6 +1952,43 @@ function readEpochMs(raw) {
   return Number.isNaN(at) ? void 0 : at;
 }
 
+// ../ops-contract/dist/work-shift-basis.js
+var instant = (value) => typeof value === "string" && /(?:Z|[+-]\d{2}:\d{2})$/.test(value) && Number.isFinite(Date.parse(value));
+var nonempty = (value) => typeof value === "string" && !!value.trim();
+var clock = (value) => typeof value === "string" && /^(?:[01]\d|2[0-3]):[0-5]\d$/.test(value);
+function isWorkShiftExecutionBasis(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value))
+    return false;
+  const b = value;
+  if (![b.basisId, b.arrangementId, b.revisionId, b.planId, b.contentHash].every(nonempty) || !Number.isSafeInteger(b.revisionNumber) || b.revisionNumber < 1 || !instant(b.businessTime) || !nonempty(b.timezone))
+    return false;
+  try {
+    new Intl.DateTimeFormat("en", { timeZone: b.timezone }).format(0);
+  } catch {
+    return false;
+  }
+  if (typeof b.workDate !== "string" || !/^\d{4}-\d{2}-\d{2}$/.test(b.workDate) || !Number.isFinite(Date.parse(b.workDate)) || new Date(b.workDate).toISOString().slice(0, 10) !== b.workDate)
+    return false;
+  if (!Array.isArray(b.shifts) || !b.shifts.length || b.shifts.length > 64)
+    return false;
+  const names = /* @__PURE__ */ new Set();
+  for (const s of b.shifts) {
+    if (!s || typeof s !== "object" || !nonempty(s.name) || names.has(s.name) || s.description !== void 0 && typeof s.description !== "string" || ![-1, 0, 1].includes(s.fromDate) || ![-1, 0, 1].includes(s.toDate) || !clock(s.fromTime) || !clock(s.toTime) || typeof s.daysOfWeek !== "string" || !/^(?:[0-6](?:,[0-6])*)?$/.test(s.daysOfWeek))
+      return false;
+    const minutes = (time) => Number(time.slice(0, 2)) * 60 + Number(time.slice(3));
+    const duration = (s.toDate - s.fromDate) * 1440 + minutes(s.toTime) - minutes(s.fromTime);
+    if (duration <= 0 || duration > 1440)
+      return false;
+    names.add(s.name);
+  }
+  if (b.shiftName === void 0)
+    return b.occurrence === void 0;
+  if (!nonempty(b.shiftName) || !names.has(b.shiftName) || !b.occurrence || !instant(b.occurrence.from) || !instant(b.occurrence.to))
+    return false;
+  const at = Date.parse(b.businessTime);
+  return Date.parse(b.occurrence.from) <= at && at < Date.parse(b.occurrence.to);
+}
+
 // ../ops-contract/dist/operational-ingest.js
 var TASK_STATUS = ["created", "assigned", "in-progress", "completed"];
 var EQUIPMENT_STATUS = ["idle", "busy", "down", "setup", "planned-stop"];
@@ -1881,7 +2024,8 @@ var SPECS = {
       startTime: "string",
       endTime: "string",
       materialActual: "object[]",
-      recordTime: "string"
+      recordTime: "string",
+      workShiftBasis: "object"
     },
     /*
      * **자재 줄의 안쪽** — 계약의 `MaterialActual` 그대로다.
@@ -1897,6 +2041,11 @@ var SPECS = {
      * 물려받으면 단위를 모르는 현장의 사실이 통째로 거절된다.
      */
     shapes: {
+      workShiftBasis: {
+        required: ["basisId", "arrangementId", "revisionId", "revisionNumber", "planId", "contentHash", "businessTime", "timezone", "shifts", "workDate"],
+        fields: { basisId: "string", arrangementId: "string", revisionId: "string", revisionNumber: "number", planId: "string", contentHash: "string", businessTime: "string", timezone: "string", workDate: "string" }
+        // Full nested content and selected occurrence are checked by isWorkShiftExecutionBasis below.
+      },
       materialActual: {
         required: ["definitionId", "use"],
         fields: { definitionId: "string", lotId: "string", quantity: "number", uom: "string" },
@@ -2023,13 +2172,19 @@ var SPECS = {
        * 새 어휘가 아니다 — 계약이 `recipeKey` 를 네 자리에서 이미 쓴다. 오더 관측에만 자리가 없었다.
        */
       recipeKey: "string",
-      recipeBasis: "object"
+      recipeBasis: "object",
+      materialBasis: "object[]"
     },
     /*
      * 확보분의 안쪽을 본다 — 열쇠와 수 둘이다(§`AllocatedQuantity`). 안 보면 틀린 이름이 조용히
      * 지나가고(`epcs`·`quantity` 따위), 미러는 잡힌 수를 0 으로 읽는다.
      */
     shapes: {
+      materialBasis: {
+        required: ["basisId", "materialId", "revisionId", "revisionNumber", "planId", "contentHash", "businessTime", "material"],
+        fields: { basisId: "string", materialId: "string", revisionId: "string", revisionNumber: "number", planId: "string", contentHash: "string", businessTime: "string" }
+        // Recursive material properties and reference lists are checked by isMaterialExecutionBasis.
+      },
       recipeBasis: {
         required: ["basisId", "recipeId", "revisionId", "planId", "contentHash", "businessTime", "recipe"],
         fields: { basisId: "string", recipeId: "string", revisionId: "string", planId: "string", contentHash: "string", businessTime: "string" }
@@ -2115,7 +2270,14 @@ var SPECS = {
       /* 사람이 정한 사유 — 없을 수 있다(적지 않은 것과 사유가 없는 것은 다르므로 지어내지 않는다). */
       reasonCode: "string",
       decidedBy: "string",
-      recordTime: "string"
+      recordTime: "string",
+      workShiftBasis: "object"
+    },
+    shapes: {
+      workShiftBasis: {
+        required: ["basisId", "arrangementId", "revisionId", "revisionNumber", "planId", "contentHash", "businessTime", "timezone", "shifts", "workDate"],
+        fields: { basisId: "string", arrangementId: "string", revisionId: "string", revisionNumber: "number", planId: "string", contentHash: "string", businessTime: "string", timezone: "string", workDate: "string" }
+      }
     },
     enums: { status: EQUIPMENT_STATUS }
   },
@@ -2898,6 +3060,7 @@ var ObservedReducer = class {
     switch (e.eventType) {
       case OP_EVENT.task: {
         const d = e.data;
+        if (d.workShiftBasis !== void 0 && !isWorkShiftExecutionBasis(d.workShiftBasis)) throw new Error("Invalid pinned work shift evidence");
         if (this.stale(`task:${d.taskId}`, e)) return;
         this.touchLocation(d.fromNode);
         this.touchLocation(d.toNode);
@@ -2922,6 +3085,7 @@ var ObservedReducer = class {
           ...d.resources?.length ? { resources: d.resources.slice() } : {},
           /* 실제 자재 이동 — 인원·설비와 같은 채널로 온다(실적을 한 곳에서 읽는다).
              말하지 않았으면 **앞의 것을 지킨다**(위 주석) — 빈 배열은 「지웠다」로 말한 것이다. */
+          ...d.workShiftBasis ? { workShiftBasis: structuredClone(d.workShiftBasis) } : prevTask?.workShiftBasis ? { workShiftBasis: structuredClone(prevTask.workShiftBasis) } : {},
           ...d.materialActual?.length ? { materialActual: d.materialActual.map((r) => ({ ...r })) } : keptActual?.length ? { materialActual: keptActual.map((r) => ({ ...r })) } : {},
           ...d.priority !== void 0 ? { priority: d.priority } : {},
           ...d.startTime ? { startTime: d.startTime } : {},
@@ -3003,6 +3167,7 @@ var ObservedReducer = class {
       }
       case OP_EVENT.equipmentPeriod: {
         const d = e.data;
+        if (d.workShiftBasis !== void 0 && !isWorkShiftExecutionBasis(d.workShiftBasis)) throw new Error("Invalid pinned work shift evidence");
         if (!d?.moverId || !d?.from || !d?.to) break;
         const from = Date.parse(d.from);
         const to = Date.parse(d.to);
@@ -3112,6 +3277,7 @@ var ObservedReducer = class {
           /* 어느 레시피로 만드는가 — 품목만으로는 「무엇으로」가 남지 않는다(같은 품목에 대체 레시피). */
           ...d.recipeKey ? { recipeKey: d.recipeKey } : {},
           ...d.recipeBasis ? { recipeBasis: structuredClone(d.recipeBasis) } : {},
+          ...d.materialBasis ? { materialBasis: structuredClone(d.materialBasis) } : {},
           ...d.allocated?.length ? { allocated: d.allocated.slice() } : {},
           ...d.bizTransaction ? { bizTransaction: d.bizTransaction } : {},
           /* 이행하는 계획 — 「이 계획이 얼마나 됐나」를 이 값으로 묶어 답한다(§`OrderState.operationsRequestId`). */
@@ -3536,7 +3702,7 @@ var ObservedReducer = class {
       /* 수량으로 담긴 것도 이어받는다 — 되풀어 주지 않는 축이다(원천은 담김을 다시 말해 주지 않는다). */
       qtyAggregation: [...this.qtyAggregation.entries()].map(([parent, quantities]) => ({ parent, quantities })),
       pendingQuantities: [...this.pendingQuantities.entries()].map(([parent, quantities]) => ({ parent, quantities })),
-      tasks: [...this.tasks.values()].map((t) => ({ ...t })),
+      tasks: [...this.tasks.values()].map((t) => structuredClone(t)),
       equipment: [...this.equipment.values()].map((m) => ({ ...m })),
       persons: [...this.persons.values()].map((x) => ({ ...x })),
       assets: [...this.assets.values()].map((x) => ({ ...x })),
@@ -3564,6 +3730,9 @@ var ObservedReducer = class {
    * 모델에서 오는 판정 입력(교대·등급·시간대)은 생성자가 이미 세웠으므로 건드리지 않는다.
    */
   restore(cp) {
+    for (const task of cp?.tasks ?? []) {
+      if (task.workShiftBasis !== void 0 && !isWorkShiftExecutionBasis(task.workShiftBasis)) throw new Error("Invalid pinned work shift evidence");
+    }
     this.observations = new Map(
       (cp?.observations ?? []).map((o) => [o.id, new Map((o.values ?? []).map((v) => [v.propertyId, { ...v }]))])
     );
@@ -3576,7 +3745,7 @@ var ObservedReducer = class {
     this.pendingParent = new Map((cp?.pendingParent ?? []).map((x) => [x.child, x.parent]));
     this.qtyAggregation = new Map((cp?.qtyAggregation ?? []).map((x) => [x.parent, x.quantities]));
     this.pendingQuantities = new Map((cp?.pendingQuantities ?? []).map((x) => [x.parent, x.quantities]));
-    this.tasks = new Map((cp?.tasks ?? []).map((t) => [t.id, { ...t }]));
+    this.tasks = new Map((cp?.tasks ?? []).map((t) => [t.id, structuredClone(t)]));
     this.equipment = new Map((cp?.equipment ?? []).map((m) => [m.id, { ...m }]));
     this.oeeCounters = new Map(
       (cp?.oeeCounters ?? []).map((c) => [String(c.id), { ...emptyOeeCounters(), ...c, id: void 0 }])
@@ -3630,7 +3799,7 @@ var ObservedReducer = class {
          만료는 이벤트 없이 시각만으로 일어나므로, 델타로 받아 두면 유휴 자원이 영원히 유효하게 남는다. */
       persons: [...this.persons.values()].map((p) => ({ ...p, ...this.effectivityPart(p), ...this.offShiftPart(`person:${p.id}`), ...this.capabilityPart(p, `person:${p.id}`, p.personnelClassIds, this.classDefs.personnel) })),
       assets: [...this.assets.values()].map((a) => ({ ...a, ...this.effectivityPart(a), ...this.capabilityPart(a, `asset:${a.id}`, a.assetClassIds, this.classDefs.asset) })),
-      tasks: [...this.tasks.values()].map((t) => ({ ...t })),
+      tasks: [...this.tasks.values()].map((t) => structuredClone(t)),
       equipment: [...this.equipment.values()].map((m) => ({ ...m, ...this.oeePart(m.id), ...this.effectivityPart(m), ...this.offShiftPart(`eq:${m.id}`), ...this.capabilityPart(m, `eq:${m.id}`, m.kind ? [m.kind] : [], this.classDefs.equipment) })),
       orders: [...this.orders.values()].map((o) => ({ ...o })),
       acked: [...this.acked]
@@ -3970,7 +4139,21 @@ var ItemStore = class _ItemStore {
    * 색인을 밖에 따로 두지 않는다 — 갱신하는 자리가 흩어지면 한 자리라도 빠뜨렸을 때 **재고가 조용히
    * 사라진다**(있는데 없다고 판정된다). 자리 색인과 같은 규율이다.
    */
+  /*
+   * 품목 색인 — 키는 **품목 클래스**다(`itemClassOf`). 재고는 로트 클래스를 들고 오더는 품목 클래스를 묻는다
+   * (ADR-0076 ⑥ · ADR-0082 결정 2). 로트 글자를 키로 쓰면 품목을 물어도 로트 재고가 안 나온다.
+   */
   byGtin = /* @__PURE__ */ new Map();
+  /** 같은 글자를 매번 뜯지 않는다 — 클래스 글자의 종류는 적고 물품은 많다. */
+  itemClassCache = /* @__PURE__ */ new Map();
+  itemClass(gtin) {
+    let c = this.itemClassCache.get(gtin);
+    if (c === void 0) {
+      c = itemClassOf(gtin) ?? gtin;
+      this.itemClassCache.set(gtin, c);
+    }
+    return c;
+  }
   get size() {
     return this.map.size;
   }
@@ -4060,7 +4243,7 @@ var ItemStore = class _ItemStore {
   }
   /** 그 품목인 물품들 — 색인이 답한다(자리를 모를 때 쓴다). */
   ofGtin(gtin) {
-    const keys = this.byGtin.get(gtin);
+    const keys = this.byGtin.get(this.itemClass(gtin));
     if (!keys) return [];
     const out = [];
     for (const k of keys) {
@@ -4088,13 +4271,13 @@ var ItemStore = class _ItemStore {
       }
     }
     for (const [key, it] of this.map) {
-      if (it.gtin && !this.byGtin.get(it.gtin)?.has(key)) drift.push(`${key} \uC774 \uD488\uBAA9 '${it.gtin}' \uC0C9\uC778\uC5D0 \uC5C6\uB2E4`);
+      if (it.gtin && !this.byGtin.get(this.itemClass(it.gtin))?.has(key)) drift.push(`${key} \uC774 \uD488\uBAA9 '${it.gtin}' \uC0C9\uC778\uC5D0 \uC5C6\uB2E4`);
     }
     for (const [g, keys] of this.byGtin) {
       for (const k of keys) {
         const it = this.map.get(k);
         if (!it) drift.push(`${k} \uC774 \uC9C0\uC6CC\uC84C\uB294\uB370 \uD488\uBAA9 '${g}' \uC0C9\uC778\uC5D0 \uB0A8\uC544 \uC788\uB2E4`);
-        else if (it.gtin !== g) drift.push(`${k} \uC740 \uD488\uBAA9 '${it.gtin}' \uC778\uB370 '${g}' \uC0C9\uC778\uC5D0 \uC788\uB2E4`);
+        else if (this.itemClass(it.gtin ?? "") !== g) drift.push(`${k} \uC740 \uD488\uBAA9 '${it.gtin}' \uC778\uB370 '${g}' \uC0C9\uC778\uC5D0 \uC788\uB2E4`);
       }
     }
     return drift;
@@ -4102,9 +4285,10 @@ var ItemStore = class _ItemStore {
   index(key, location, gtin) {
     this.indexLocation(key, location);
     if (gtin) {
-      const set = this.byGtin.get(gtin) ?? /* @__PURE__ */ new Set();
+      const g = this.itemClass(gtin);
+      const set = this.byGtin.get(g) ?? /* @__PURE__ */ new Set();
       set.add(key);
-      this.byGtin.set(gtin, set);
+      this.byGtin.set(g, set);
     }
   }
   indexLocation(key, location) {
@@ -4115,10 +4299,11 @@ var ItemStore = class _ItemStore {
   unindex(key, location, gtin) {
     this.unindexLocation(key, location);
     if (gtin) {
-      const set = this.byGtin.get(gtin);
+      const g = this.itemClass(gtin);
+      const set = this.byGtin.get(g);
       if (!set) return;
       set.delete(key);
-      if (!set.size) this.byGtin.delete(gtin);
+      if (!set.size) this.byGtin.delete(g);
     }
   }
   unindexLocation(key, location) {
@@ -4527,6 +4712,9 @@ var FlowEngine = class {
     return { kept, dropped };
   }
   hydrateObserved(snap, orders = [], purpose = "seed") {
+    for (const task of snap.tasks ?? []) {
+      if (task.workShiftBasis !== void 0 && !isWorkShiftExecutionBasis(task.workShiftBasis)) throw new Error("Invalid pinned work shift evidence");
+    }
     for (const id of snap.acked ?? []) this._acked.add(id);
     for (const e of snap.attentionSince ?? []) if (e?.id && e.since) this._attentionSince.set(e.id, e.since);
     for (const n of snap.locations) {
@@ -4688,6 +4876,7 @@ var FlowEngine = class {
       ...o.gtin ? { gtin: o.gtin } : {},
       ...o.recipeKey ? { recipeKey: o.recipeKey } : {},
       ...o.recipeBasis ? { recipeBasis: structuredClone(o.recipeBasis) } : {},
+      ...o.materialBasis ? { materialBasis: structuredClone(o.materialBasis) } : {},
       ...o.bizTransaction ? { bizTransaction: o.bizTransaction } : {},
       ...o.dockDoor ? { dockDoor: o.dockDoor } : {},
       ...o.windowStartMs !== void 0 ? { windowStartMs: o.windowStartMs } : {}
@@ -4713,6 +4902,7 @@ var FlowEngine = class {
            남은 공정·소요가 다른 레시피 기준으로 계산된다(같은 품목에 대체 레시피가 있다). */
         ...o.recipeKey ? { recipeKey: o.recipeKey } : {},
         ...o.recipeBasis ? { recipeBasis: structuredClone(o.recipeBasis) } : {},
+        ...o.materialBasis ? { materialBasis: structuredClone(o.materialBasis) } : {},
         bizTransaction: o.bizTransaction ?? "",
         allocated: resolved.kept,
         picked: [],
@@ -4766,6 +4956,7 @@ var FlowEngine = class {
         status: purpose === "observe" ? t.status : known && t.status === "in-progress" ? "in-progress" : "created",
         /* 이미 일어난 자재 이동은 **씨앗에도 남는다** — 잃으면 실적이 재기동마다 지워진다. */
         ...t.materialActual?.length ? { materialActual: t.materialActual.map((r) => ({ ...r })) } : {},
+        ...t.workShiftBasis ? { workShiftBasis: structuredClone(t.workShiftBasis) } : {},
         itemEpc: t.itemRefs?.[0] ?? "",
         fromNode: t.fromNode ?? "",
         toNode: t.toNode ?? "",
@@ -5123,6 +5314,7 @@ var FlowEngine = class {
         ...t.assets?.length ? { assets: t.assets.slice() } : {},
         ...t.resources?.length ? { resources: t.resources.slice() } : {},
         ...t.materialActual?.length ? { materialActual: t.materialActual.map((r) => ({ ...r })) } : {},
+        ...t.workShiftBasis ? { workShiftBasis: structuredClone(t.workShiftBasis) } : {},
         ...t.priority !== void 0 ? { priority: t.priority } : {},
         ...t.startTime ? { startTime: t.startTime } : {},
         ...t.endTime ? { endTime: t.endTime } : {}
@@ -5147,6 +5339,7 @@ var FlowEngine = class {
         /* **어느 레시피로 만드나** — 품목만으로는 「무엇으로」가 안 남는다(같은 품목의 대체 레시피가 있다). */
         ...o.recipeKey ? { recipeKey: o.recipeKey } : {},
         ...o.recipeBasis ? { recipeBasis: structuredClone(o.recipeBasis) } : {},
+        ...o.materialBasis ? { materialBasis: structuredClone(o.materialBasis) } : {},
         /* 씨앗이 다 심지 못했다는 사실 — 조용히 자르지 않는다(그 오더의 답은 부족한 씨앗 위에 있다). */
         ...o.seedIncomplete ? { seedIncomplete: true } : {},
         /* 왜 대기하는지 — 없으면 화면은 「running」만 보여 주고 사람은 원인을 찾을 자리가 없다. */
@@ -6141,6 +6334,7 @@ var FlowEngine = class {
       ...t.resources?.length ? { resources: t.resources.slice() } : {},
       /* 실제 자재 이동 — 인원·설비와 같은 채널(실적을 한 곳에서 읽는다). */
       ...t.materialActual?.length ? { materialActual: t.materialActual.map((r) => ({ ...r })) } : {},
+      ...t.workShiftBasis ? { workShiftBasis: structuredClone(t.workShiftBasis) } : {},
       ...t.durationMs ? { durationMs: t.durationMs } : {},
       /* 품질 판정이 있었으면 **그 자리에서** 실어 보낸다 — 없으면 필드를 만들지 않는다(모름≠양품). */
       ...t.outcome ? { outcome: t.outcome } : {},
@@ -6182,6 +6376,7 @@ var FlowEngine = class {
          레시피가 있다). 시뮬만 아는 사실이 남으면 두 스냅샷을 같은 규칙으로 읽을 수 없다. */
       ...o.recipeKey ? { recipeKey: o.recipeKey } : {},
       ...o.recipeBasis ? { recipeBasis: structuredClone(o.recipeBasis) } : {},
+      ...o.materialBasis ? { materialBasis: structuredClone(o.materialBasis) } : {},
       ...o.allocated?.length ? { allocated: o.allocated.slice() } : {},
       ...o.bizTransaction ? { bizTransaction: o.bizTransaction } : {},
       /* 약속해 둔 자리·시각창 — 이것이 빠져서 야드 트윈이 재기동마다 첫 틱에 죽었다(§dockDoor). */
@@ -6356,7 +6551,7 @@ var FlowEngine = class {
       if (!remaining) continue;
       for (const it of this.items.at(at)) {
         if (remaining <= 0) break;
-        if (!this.materialMatches(it, req)) continue;
+        if (!this.materialMatches(it, req, t.orderId)) continue;
         if (it.disposition === DISP.in_progress) continue;
         const already = takenSoFar.get(it.epc) ?? 0;
         const avail = Math.max(0, (it.qty ?? 1) - already);
@@ -6371,11 +6566,12 @@ var FlowEngine = class {
     return picked;
   }
   /** 이 물품이 명세를 만족하나 — 품목 지목이 우선, 없으면 등급(상속을 타고 닫는다). */
-  materialMatches(it, req) {
+  materialMatches(it, req, orderId) {
     const defId = it.definitionId ?? it.gtin;
     if (req.materialDefinition) return defId === req.materialDefinition;
     if (req.materialClass) {
-      const def = defId ? this.materialDefs.get(defId) : void 0;
+      const basis = orderId ? this.orders.get(orderId)?.materialBasis : void 0;
+      const def = basis !== void 0 ? basis.find((b) => b.material.id === defId)?.material : defId ? this.materialDefs.get(defId) : void 0;
       return classClosure(def?.materialClassIds, this.classDefs.material, this.now()).has(req.materialClass);
     }
     return true;
@@ -7202,7 +7398,7 @@ function planMakeToOrder(gtin, shortQty, ops, stock, locations) {
   return { steps: [{ step: "process", operation: op.key, at: station.id }] };
 }
 function matches(s, req) {
-  if (req.materialDefinition) return s.gtin === req.materialDefinition;
+  if (req.materialDefinition) return sameItemClass(s.gtin, req.materialDefinition);
   return false;
 }
 
@@ -7249,11 +7445,27 @@ var WmsKernel = class extends FlowEngine {
     const poSeq = ++this.poSeq;
     const po = this.requireBizTransactionId(`PO-${poSeq}`, "purchaseorder");
     const eventTime = this.now();
-    const qtyList = [{ epcClass: gtin, quantity: qty }];
+    const lot = `L-${poSeq}`;
+    const lotClass = lotClassOfItem(gtin, lot) ?? gtin;
+    const qtyList = [{ epcClass: lotClass, quantity: qty }];
     const poTxn = [{ type: BTT.po, bizTransaction: po }];
+    const inbound = {
+      id: `inbound-${poSeq}`,
+      kind: WMS_ORDER_KIND.inbound,
+      status: "created",
+      requested: qty,
+      fulfilled: 0,
+      bizTransaction: po,
+      allocated: [],
+      picked: [],
+      shipmentEpc: null,
+      lines: [{ gtin, requested: qty }]
+    };
+    this.orders.set(inbound.id, inbound);
+    this.emitOrder(inbound);
     const expiry = this.clockMs + SHELF_MS - this.epcSeq % 5 * SHELF_JITTER_MS;
     const ilmd = { [ILMD_ATTR.expiry]: expiry };
-    this.items.set(epc, { epc, gtin, qty, location: dock.id, disposition: DISP.in_progress, expiry, ilmd, receivedAtMs: this.nowMs() });
+    this.items.set(epc, { epc, gtin: lotClass, qty, location: dock.id, disposition: DISP.in_progress, expiry, ilmd, receivedAtMs: this.nowMs() });
     dock.occupancy++;
     this.emit(transactionEvent({ eventTime, action: "ADD", bizStep: BIZSTEP.receiving, bizTransactionList: poTxn, epcList: [epc], quantityList: qtyList, readPoint: dock.id }));
     this.emit(aggregationEvent({ eventTime, action: "ADD", bizStep: BIZSTEP.receiving, parentID: epc, childQuantityList: qtyList, readPoint: dock.id }));
@@ -7269,6 +7481,9 @@ var WmsKernel = class extends FlowEngine {
       bizTransactionList: poTxn,
       ilmd
     }));
+    inbound.fulfilled = qty;
+    inbound.status = "completed";
+    this.emitOrder(inbound);
     const binId = this.policy.selectPlacement({ item: { epc, gtin, qty }, slots: this.slotViews("storage") });
     if (!binId) return;
     const id = `task-${++this.taskSeq}`;
@@ -7347,10 +7562,10 @@ var WmsKernel = class extends FlowEngine {
     const staging = this.builtInLocation("staging", "picked pallets wait here before shipping");
     const chosenAll = [];
     for (const line of o.lines) {
-      const already = allocatedQty(o.allocated.filter((a) => this.items.get(a.epc)?.gtin === line.gtin));
+      const already = allocatedQty(o.allocated.filter((a) => sameItemClass(this.items.get(a.epc)?.gtin, line.gtin)));
       const need = line.requested - already;
       if (need <= 0) continue;
-      const available = [...this.items.values()].filter((i) => i.gtin === line.gtin && i.disposition === DISP.sellable && this.locations.get(i.location)?.type === "storage").filter((i) => this.usableLot(i)).map((i) => ({ epc: i.epc, location: i.location, qty: 1, expiry: i.expiry, ...i.receivedAtMs !== void 0 ? { receivedAtMs: i.receivedAtMs } : {} }));
+      const available = [...this.items.values()].filter((i) => sameItemClass(i.gtin, line.gtin) && i.disposition === DISP.sellable && this.locations.get(i.location)?.type === "storage").filter((i) => this.usableLot(i)).map((i) => ({ epc: i.epc, location: i.location, qty: 1, expiry: i.expiry, ...i.receivedAtMs !== void 0 ? { receivedAtMs: i.receivedAtMs } : {} }));
       const chosen = this.policy.selectStock({ gtin: line.gtin, qty: need, available });
       for (const row of chosen) {
         o.allocated.push(row);
@@ -7414,7 +7629,7 @@ var WmsKernel = class extends FlowEngine {
     const locations = [...this.locations.values()].map((l) => ({ id: l.id, type: l.type }));
     const ops = this.declaredOperations();
     for (const line of o.lines) {
-      const have = stock.filter((s) => s.gtin === line.gtin && s.sellable && this.locations.get(s.location)?.type === "storage").reduce((n, s) => n + s.qty, 0);
+      const have = stock.filter((s) => sameItemClass(s.gtin, line.gtin) && s.sellable && this.locations.get(s.location)?.type === "storage").reduce((n, s) => n + s.qty, 0);
       const short = line.requested - have;
       if (short <= 0) continue;
       const plan = planMakeToOrder(line.gtin, short, ops, stock, locations);
@@ -7440,7 +7655,7 @@ var WmsKernel = class extends FlowEngine {
   }
   /** 부품을 작업대로 — 팔레트 이동이므로 피킹과 같은 기제다(부분 소비는 코어가 한다). */
   issueFeed(o, gtin, from, to, qty) {
-    const src = [...this.items.values()].find((i) => i.gtin === gtin && i.location === from && i.disposition === DISP.sellable);
+    const src = [...this.items.values()].find((i) => sameItemClass(i.gtin, gtin) && i.location === from && i.disposition === DISP.sellable);
     if (!src) return;
     src.disposition = DISP.reserved;
     this.pushTask(o, "feed", src.epc, from, to);
@@ -7518,7 +7733,7 @@ var WmsKernel = class extends FlowEngine {
     order.fulfilled += allocatedQty(order.allocated);
     if (order.lines) for (const epc of order.picked) {
       const g = this.items.get(epc)?.gtin;
-      const line = order.lines.find((l) => l.gtin === g && l.requested > 0);
+      const line = order.lines.find((l) => sameItemClass(l.gtin, g) && l.requested > 0);
       if (line) line.requested--;
     }
     for (const epc of order.picked) {
@@ -8359,7 +8574,7 @@ The steps are the source of truth for execution order; the hierarchy only names
       if (fromType) {
         for (const n of locsOfType.get(fromType) ?? []) {
           for (const i of this.items.at(n.id)) {
-            if (i.gtin === g && i.disposition === DISP.sellable) available.push({ epc: i.epc, location: i.location, qty: 1 });
+            if (sameItemClass(i.gtin, g) && i.disposition === DISP.sellable) available.push({ epc: i.epc, location: i.location, qty: 1 });
           }
         }
       } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operato/twin-kernel",
-  "version": "0.11.22",
+  "version": "0.11.24",
   "type": "module",
   "description": "Twin Domain Kernel — framework-agnostic, zero-dep (domain + sim + 3-channel contract). WMS/YMS/MES, EPCIS 2.0 · ISA-95.",
   "publishConfig": {
@@ -28,6 +28,6 @@
     "test": "node --test test/*.test.ts"
   },
   "dependencies": {
-    "@operato/ops-contract": "^0.9.32"
+    "@operato/ops-contract": "^0.9.35"
   }
 }