@operato/twin-kernel 0.7.11 → 0.7.13

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/ems-profile.d.ts

@@ -16,5 +16,11 @@ export declare const EMS_PROPERTY: {
     readonly ratedKW: "power.ratedKW";
     /** 멈춰 있을 때의 소비(kW). 없으면 멈춘 동안을 **비운다** — 0 이라고 주장하지 않는다. */
     readonly standbyKW: "power.standbyKW";
+    /** 기본요금 단가 — 최대수요 1kW 당(청구 주기 기준). */
+    readonly demandChargePerKW: "tariff.demandChargePerKW";
+    /** 사용량 단가 — 1kWh 당. */
+    readonly energyChargePerKWh: "tariff.energyChargePerKWh";
+    /** 통화 — ISO 4217 코드(USD·KRW…). 없으면 금액에 단위를 붙이지 않는다. */
+    readonly currency: "tariff.currency";
 };
 export declare const EMS_TYPES: TwinTypeInfo[];

package/dist/ems-profile.js

@@ -20,7 +20,26 @@ export const EMS_PROPERTY = {
     /** 가동 중 소비(kW). */
     ratedKW: 'power.ratedKW',
     /** 멈춰 있을 때의 소비(kW). 없으면 멈춘 동안을 **비운다** — 0 이라고 주장하지 않는다. */
-    standbyKW: 'power.standbyKW'
+    standbyKW: 'power.standbyKW',
+    /*
+     * ── 요금 단가 — 수를 금액으로 바꾸는 선언 (2026-08-17) ─────────────────────
+     *
+     * 그동안 트윈은 「최대수요 328kW」·「전력량 1,547kWh」까지 말하고 멈췄다. 그런데 피크를 깎는 일이
+     * 돈이 되는 이유는 **요금이 둘로 나뉘기** 때문이다: 사용량(kWh)에 붙는 요금과 **최대수요(kW)에 붙는
+     * 기본요금**. 단가가 없으면 그 절반을 말할 수 없고, 그래서 「피크를 깎아 얼마를 아끼나」에 답하지 못했다.
+     *
+     * 단가는 **현장의 계약**이다(같은 나라 안에서도 사업자·요금제마다 다르다). 그래서 기본값을 두지
+     * 않는다 — 선언하지 않으면 금액을 계산하지 않는다. 짐작한 단가로 낸 금액은 숫자가 있다는 것만으로
+     * 사람을 결정으로 밀어붙인다.
+     *
+     * 계약전력(`contract.kW`)과 같은 자리(수전)에 선언한다.
+     */
+    /** 기본요금 단가 — 최대수요 1kW 당(청구 주기 기준). */
+    demandChargePerKW: 'tariff.demandChargePerKW',
+    /** 사용량 단가 — 1kWh 당. */
+    energyChargePerKWh: 'tariff.energyChargePerKWh',
+    /** 통화 — ISO 4217 코드(USD·KRW…). 없으면 금액에 단위를 붙이지 않는다. */
+    currency: 'tariff.currency'
 };
 export const EMS_TYPES = [
     /* ── 자리: 전기적 구간 ─────────────────────────────────────────────────── */

package/dist/energy-attribution.d.ts

@@ -221,3 +221,47 @@ export declare function energyOfWindows(windows: readonly {
     startMs: number;
     endMs: number;
 }): WindowedEnergy;
+/** 선언된 단가 — 없는 항목은 계산하지 않는다(0 으로 두지 않는다). */
+export interface TariffDeclaration {
+    /** 최대수요 1kW 당 기본요금. */
+    demandChargePerKW?: number;
+    /** 1kWh 당 사용량 요금. */
+    energyChargePerKWh?: number;
+    /** ISO 4217 통화 코드. 없으면 금액에 단위를 붙일 수 없다. */
+    currency?: string;
+}
+/**
+ * 이 창의 전기요금 — **청구서가 아니다.**
+ *
+ * ── 무엇을 계산하나 ─────────────────────────────────────────────────────────
+ *  · 사용량 부분: `kWh × 단가`. 이것은 창에 비례하므로 창을 잘라도 뜻이 유지된다.
+ *  · 기본요금 부분: `최대수요 × 단가`. **이것은 창의 값이 아니다** — 기본요금은 청구 주기(보통 한 달)의
+ *    최고 수요로 매겨진다. 그래서 이 값의 뜻은 「이 창의 최대수요가 그 주기의 최고로 남는다면 기본요금이
+ *    이만큼」이고, 그 조건을 `demandBasis` 로 함께 낸다. 조건을 감추면 창을 좁힌 사람이 요금이 줄었다고
+ *    읽는다(실제로는 같은 달의 다른 시각에 더 높은 피크가 있을 수 있다).
+ *
+ * ── 세우지 않은 것 ──────────────────────────────────────────────────────────
+ * 시간대 요금(TOU)·계절 요금·래칫(직전 개월의 피크를 끌고 가는 구조)·최소 청구액·역률 요금은
+ * **모델에 없다.** 있는 척하지 않는다 — 그것들이 필요한 현장에서는 이 값이 실 청구서와 다르고,
+ * 그 사실을 아는 편이 그럴듯한 총액보다 낫다.
+ */
+export type ElectricityCost = {
+    /** 사용량 요금 — 선언과 전력량이 다 있을 때만. */
+    energyCharge?: number;
+    /** 기본요금 — 선언과 최대수요가 다 있을 때만. */
+    demandCharge?: number;
+    /** 위 둘의 합. 둘 중 하나만 있으면 그 하나다(없는 쪽을 0 으로 세지 않는다). */
+    total?: number;
+    currency?: string;
+    /** 기본요금이 성립하는 조건 — 창의 피크가 청구 주기의 최고일 때. */
+    demandBasis?: 'window-peak-as-period-peak';
+    /** 세우지 않은 요금 요소 — 소비처가 「이 값이 청구서가 아니다」를 말할 수 있게. */
+    notModeled: readonly string[];
+} | {
+    reason: 'no-tariff';
+};
+export declare function electricityCost(input: {
+    kWh?: number;
+    peakKW?: number;
+    tariff?: TariffDeclaration;
+}): ElectricityCost;

package/dist/energy-attribution.js

@@ -239,3 +239,27 @@ export function energyOfWindows(windows, range) {
         ...(first !== undefined && last !== undefined ? { window: { startMs: first, endMs: last } } : {})
     };
 }
+const NOT_MODELED = ['tou', 'seasonal', 'ratchet', 'minimum-bill', 'power-factor'];
+export function electricityCost(input) {
+    const t = input.tariff;
+    const eRate = Number(t?.energyChargePerKWh);
+    const dRate = Number(t?.demandChargePerKW);
+    const hasE = Number.isFinite(eRate) && eRate > 0;
+    const hasD = Number.isFinite(dRate) && dRate > 0;
+    /* 단가가 하나도 없으면 금액을 만들지 않는다 — 이유를 낸다(빈 값과 0 원을 구별할 수 있게). */
+    if (!hasE && !hasD)
+        return { reason: 'no-tariff' };
+    const kWh = Number(input.kWh);
+    const peakKW = Number(input.peakKW);
+    const energyCharge = hasE && Number.isFinite(kWh) ? kWh * eRate : undefined;
+    const demandCharge = hasD && Number.isFinite(peakKW) ? peakKW * dRate : undefined;
+    /* 반올림하지 않는다 — 표현은 화면의 일이고, 여기서 깎으면 합과 부분이 어긋난다. */
+    const total = energyCharge === undefined && demandCharge === undefined ? undefined : (energyCharge ?? 0) + (demandCharge ?? 0);
+    return {
+        ...(energyCharge !== undefined ? { energyCharge } : {}),
+        ...(demandCharge !== undefined ? { demandCharge, demandBasis: 'window-peak-as-period-peak' } : {}),
+        ...(total !== undefined ? { total } : {}),
+        ...(t?.currency ? { currency: String(t.currency) } : {}),
+        notModeled: NOT_MODELED
+    };
+}

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/index.d.ts

@@ -30,7 +30,7 @@ export { YmsKernel } from './yms-kernel.ts';
 export { MesKernel, MES_PART_GTINS, MES_PRODUCT_GTINS, MES_PRODUCTS } from './mes-kernel.ts';
 export { EmsKernel, DEMAND_WINDOW_MS, demandWindowStart } from './ems-kernel.ts';
 export { ingestEnergyRecords, isEnergyRecord, ingestEnergyEquipmentRecords, isEnergyEquipmentRecord } from './energy-ingest.ts';
-export { attributeEnergy, energyIntensity, energyOfWindows } from './energy-attribution.ts';
-export type { AttributionBasis, AttributionResult, EnergyConsumer, EnergyPool, EnergyShare, IntensityInput, IntensityResult, IntensityDenominator, WeightKind, WindowedEnergy } from './energy-attribution.ts';
+export { attributeEnergy, electricityCost, energyIntensity, energyOfWindows } from './energy-attribution.ts';
+export type { AttributionBasis, AttributionResult, ElectricityCost, EnergyConsumer, EnergyPool, EnergyShare, IntensityInput, IntensityResult, IntensityDenominator, TariffDeclaration, WeightKind, WindowedEnergy } from './energy-attribution.ts';
 export type { EnergyRecord, EnergyEquipmentRecord, EnergyIngestOptions, EnergyIngestResult } from './energy-ingest.ts';
 export * from './vocabulary.ts';

package/dist/index.js

@@ -30,6 +30,6 @@ export { YmsKernel } from "./yms-kernel.js";
 export { MesKernel, MES_PART_GTINS, MES_PRODUCT_GTINS, MES_PRODUCTS } from "./mes-kernel.js";
 export { EmsKernel, DEMAND_WINDOW_MS, demandWindowStart } from "./ems-kernel.js";
 export { ingestEnergyRecords, isEnergyRecord, ingestEnergyEquipmentRecords, isEnergyEquipmentRecord } from "./energy-ingest.js";
-export { attributeEnergy, energyIntensity, energyOfWindows } from "./energy-attribution.js";
+export { attributeEnergy, electricityCost, energyIntensity, energyOfWindows } from "./energy-attribution.js";
 /* 에너지 상태 타입은 **계약**에 있다(상태의 모양은 계약이다) — contract 의 `export *` 가 이미 낸다. */
 export * from "./vocabulary.js";

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

@@ -96,6 +96,7 @@ __export(index_exports, {
   documentPath: () => documentPath,
   dueStatusOf: () => dueStatusOf,
   effectivityAt: () => effectivityAt,
+  electricityCost: () => electricityCost,
   energyIntensity: () => energyIntensity,
   energyOfWindows: () => energyOfWindows,
   fefoPolicy: () => fefoPolicy,
@@ -1354,6 +1355,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;
@@ -1679,7 +1684,26 @@ var EMS_PROPERTY = {
   /** 가동 중 소비(kW). */
   ratedKW: "power.ratedKW",
   /** 멈춰 있을 때의 소비(kW). 없으면 멈춘 동안을 **비운다** — 0 이라고 주장하지 않는다. */
-  standbyKW: "power.standbyKW"
+  standbyKW: "power.standbyKW",
+  /*
+   * ── 요금 단가 — 수를 금액으로 바꾸는 선언 (2026-08-17) ─────────────────────
+   *
+   * 그동안 트윈은 「최대수요 328kW」·「전력량 1,547kWh」까지 말하고 멈췄다. 그런데 피크를 깎는 일이
+   * 돈이 되는 이유는 **요금이 둘로 나뉘기** 때문이다: 사용량(kWh)에 붙는 요금과 **최대수요(kW)에 붙는
+   * 기본요금**. 단가가 없으면 그 절반을 말할 수 없고, 그래서 「피크를 깎아 얼마를 아끼나」에 답하지 못했다.
+   *
+   * 단가는 **현장의 계약**이다(같은 나라 안에서도 사업자·요금제마다 다르다). 그래서 기본값을 두지
+   * 않는다 — 선언하지 않으면 금액을 계산하지 않는다. 짐작한 단가로 낸 금액은 숫자가 있다는 것만으로
+   * 사람을 결정으로 밀어붙인다.
+   *
+   * 계약전력(`contract.kW`)과 같은 자리(수전)에 선언한다.
+   */
+  /** 기본요금 단가 — 최대수요 1kW 당(청구 주기 기준). */
+  demandChargePerKW: "tariff.demandChargePerKW",
+  /** 사용량 단가 — 1kWh 당. */
+  energyChargePerKWh: "tariff.energyChargePerKWh",
+  /** 통화 — ISO 4217 코드(USD·KRW…). 없으면 금액에 단위를 붙이지 않는다. */
+  currency: "tariff.currency"
 };
 var EMS_TYPES = [
   /* ── 자리: 전기적 구간 ─────────────────────────────────────────────────── */
@@ -3219,7 +3243,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 +3272,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 +3592,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 +4241,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 +5336,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 +5409,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";
@@ -6441,6 +6488,27 @@ function energyOfWindows(windows, range) {
     ...first !== void 0 && last !== void 0 ? { window: { startMs: first, endMs: last } } : {}
   };
 }
+var NOT_MODELED = ["tou", "seasonal", "ratchet", "minimum-bill", "power-factor"];
+function electricityCost(input) {
+  const t = input.tariff;
+  const eRate = Number(t?.energyChargePerKWh);
+  const dRate = Number(t?.demandChargePerKW);
+  const hasE = Number.isFinite(eRate) && eRate > 0;
+  const hasD = Number.isFinite(dRate) && dRate > 0;
+  if (!hasE && !hasD) return { reason: "no-tariff" };
+  const kWh = Number(input.kWh);
+  const peakKW = Number(input.peakKW);
+  const energyCharge = hasE && Number.isFinite(kWh) ? kWh * eRate : void 0;
+  const demandCharge = hasD && Number.isFinite(peakKW) ? peakKW * dRate : void 0;
+  const total = energyCharge === void 0 && demandCharge === void 0 ? void 0 : (energyCharge ?? 0) + (demandCharge ?? 0);
+  return {
+    ...energyCharge !== void 0 ? { energyCharge } : {},
+    ...demandCharge !== void 0 ? { demandCharge, demandBasis: "window-peak-as-period-peak" } : {},
+    ...total !== void 0 ? { total } : {},
+    ...t?.currency ? { currency: String(t.currency) } : {},
+    notModeled: NOT_MODELED
+  };
+}
 
 // src/vocabulary.ts
 var RETIRED_VOCABULARY = ["mover", "Mover", "MOVER", "node", "Node", "NODE"];
@@ -6563,6 +6631,7 @@ function retiredVocabularyIn(line) {
   documentPath,
   dueStatusOf,
   effectivityAt,
+  electricityCost,
   energyIntensity,
   energyOfWindows,
   fefoPolicy,

package/package.json

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