@operato/twin-kernel 0.7.86 → 0.7.88

package/dist/contract.d.ts

@@ -2041,6 +2041,19 @@ export interface EnergyState {
      * 청구서보다 이쪽이 먼저다: 청구서는 끝난 기간의 정산이고 이것은 지금 적용되는 값이다.
      */
     tariffBasis?: EnergyTariffBasisData;
+    /**
+     * **선언된 요금 기준들** — 유효 구간별. `tariffBasis` 는 이 중 지금 유효한 것이다.
+     *
+     * ── 왜 여럿을 드나 (2026-08-30) ──────────────────────────────────────────
+     * 선언은 **예정될 수 있다.** 한전은 다음 달 요금을 미리 공표한다. 하나만 들면 9월 선언이 들어오는
+     * 순간 8월 선언을 덮어써서 **오늘 요금이 다음 달 단가로 계산된다.** 오류는 나지 않는다.
+     *
+     * 처음에는 예정된 선언을 유입에서 거부해 이 상황을 막았다. 그것은 정상적인 사실을 막는 것이라,
+     * 담을 자리를 만들고 거부를 풀었다.
+     *
+     * 고르는 규칙은 **커널에 한 벌만 둔다.** 읽는 쪽이 각자 고르면 화면마다 다른 요금이 나온다.
+     */
+    tariffBasisSchedule?: EnergyTariffBasisData[];
     /**
      * 이 트윈의 **발전 정격**과 그 근거 — 이용률의 분모(§ `generationRated`).
      *
@@ -2056,8 +2069,12 @@ export interface EnergyState {
      * 마지막으로 받은 **발전 단가** — 이 기간에 낸 전기 1kWh 의 값.
      *
      * 창 밖의 단가도 이 창에 적용될 수 있어(단가는 기간마다 정해진다) 상태로 이어 간다.
+     *
+     * 예정된 단가는 `generationPriceSchedule` 에 함께 든다 — 이 칸은 **지금 유효한 것**이다.
      */
     generationPrice?: EnergyGenerationPriceData;
+    /** **선언된 발전 단가들** — 유효 구간별. 예정된 것을 담는다(§`tariffBasisSchedule`). */
+    generationPriceSchedule?: EnergyGenerationPriceData[];
     /**
      * 이 청구 주기의 **최고 수요** — 기본요금이 이 값으로 다시 정해진다.
      *

package/dist/ems-kernel.d.ts

@@ -133,6 +133,13 @@ export declare class EmsKernel extends FlowEngine {
      * 새것을 쓴다 — 사업자가 그 주기의 기준을 고칠 수 있다.
      */
     private applyTariffBasis;
+    /**
+     * 시계가 선언의 경계를 넘으면 **지금 유효한 선언이 바뀐다.**
+     *
+     * 표본이 들어올 때만 다시 고르면, 9월 1일 0시에 단가가 바뀌었는데 다음 표본이 올 때까지 8월 단가로
+     * 계산한다. 태양광은 밤에 표본이 없어 그 간격이 길다.
+     */
+    protected refreshDeclarationsInEffect(nowMs: number): void;
     /**
      * 청구서를 상태에 둔다 — **우리 계산을 덮지 않는다.**
      *
@@ -221,8 +228,12 @@ export declare class EmsKernel extends FlowEngine {
     private lastBill?;
     /** 마지막으로 받은 요금 기준 — 이 주기에 적용되는 요금적용전력과 단가. */
     private tariffBasis?;
+    /** 선언된 요금 기준들 — 예정된 것을 포함한다(§`EnergyState.tariffBasisSchedule`). */
+    private tariffBasisSchedule?;
     /** 마지막으로 받은 발전 단가 — 이 기간에 낸 전기 1kWh 의 값. */
     private generationPrice?;
+    /** 선언된 발전 단가들 — 예정된 것을 포함한다. */
+    private generationPriceSchedule?;
     /**
      * 이 청구 주기의 **최고 수요** — 기본요금이 이 값으로 다시 정해진다.
      *

package/dist/ems-kernel.js

@@ -354,13 +354,8 @@ export class EmsKernel extends FlowEngine {
         const d = envelope.data;
         if (!d?.from || !d?.to)
             return;
-        const fromMs = Date.parse(String(d.from));
-        if (!Number.isFinite(fromMs))
-            return;
-        const priorFromMs = Date.parse(String(this.generationPrice?.from ?? ''));
-        if (Number.isFinite(priorFromMs) && fromMs < priorFromMs)
-            return;
-        this.generationPrice = { ...d };
+        this.generationPriceSchedule = putDeclaration(this.generationPriceSchedule, d);
+        this.generationPrice = inEffectAt(this.generationPriceSchedule, this.nowMs());
         this.revision++;
     }
     /**
@@ -373,15 +368,25 @@ export class EmsKernel extends FlowEngine {
         const d = envelope.data;
         if (!d?.from || !d?.to)
             return;
-        const fromMs = Date.parse(String(d.from));
-        if (!Number.isFinite(fromMs))
-            return;
-        const priorFromMs = Date.parse(String(this.tariffBasis?.from ?? ''));
-        if (Number.isFinite(priorFromMs) && fromMs < priorFromMs)
-            return;
-        this.tariffBasis = { ...d };
+        this.tariffBasisSchedule = putDeclaration(this.tariffBasisSchedule, d);
+        this.tariffBasis = inEffectAt(this.tariffBasisSchedule, this.nowMs());
         this.revision++;
     }
+    /**
+     * 시계가 선언의 경계를 넘으면 **지금 유효한 선언이 바뀐다.**
+     *
+     * 표본이 들어올 때만 다시 고르면, 9월 1일 0시에 단가가 바뀌었는데 다음 표본이 올 때까지 8월 단가로
+     * 계산한다. 태양광은 밤에 표본이 없어 그 간격이 길다.
+     */
+    refreshDeclarationsInEffect(nowMs) {
+        const tariff = inEffectAt(this.tariffBasisSchedule, nowMs);
+        const price = inEffectAt(this.generationPriceSchedule, nowMs);
+        if (tariff !== this.tariffBasis || price !== this.generationPrice) {
+            this.tariffBasis = tariff;
+            this.generationPrice = price;
+            this.revision++;
+        }
+    }
     /**
      * 청구서를 상태에 둔다 — **우리 계산을 덮지 않는다.**
      *
@@ -713,8 +718,12 @@ export class EmsKernel extends FlowEngine {
     lastBill;
     /** 마지막으로 받은 요금 기준 — 이 주기에 적용되는 요금적용전력과 단가. */
     tariffBasis;
+    /** 선언된 요금 기준들 — 예정된 것을 포함한다(§`EnergyState.tariffBasisSchedule`). */
+    tariffBasisSchedule;
     /** 마지막으로 받은 발전 단가 — 이 기간에 낸 전기 1kWh 의 값. */
     generationPrice;
+    /** 선언된 발전 단가들 — 예정된 것을 포함한다. */
+    generationPriceSchedule;
     /**
      * 이 청구 주기의 **최고 수요** — 기본요금이 이 값으로 다시 정해진다.
      *
@@ -1599,6 +1608,8 @@ export class EmsKernel extends FlowEngine {
          * 계량은 이미 시계로 마감한다(`closeDue`). 한 커널 안에서 규칙이 두 벌일 이유가 없다.
          */
         this.closeGenerationPeriodsDue(at);
+        /* 시계가 선언의 경계를 넘으면 지금 유효한 선언이 바뀐다 — 표본을 기다리지 않는다. */
+        this.refreshDeclarationsInEffect(at);
         /* 틱 길이를 함께 넘긴다 — 방전량을 에너지로 바꿀 때 필요하다(필드로 숨기면 어디서 온 값인지 흐려진다). */
         this.deriveLoad(at, dtMs);
         this.closeDue(at);
@@ -1657,10 +1668,21 @@ export class EmsKernel extends FlowEngine {
         /* 청구서도 이어받는다 — 재기동마다 사라지면 우리 계산과 견줄 기준이 없어진다. */
         if (e.lastBill?.from && e.lastBill?.to)
             this.lastBill = { ...e.lastBill };
+        /*
+         * 선언은 **목록째** 이어받는다 — 예정된 것이 사라지면 재기동 뒤에 시행일이 와도 옛 단가를 쓴다.
+         * 이어받은 뒤 지금 시각으로 다시 고른다: 멈춰 있는 동안 시행일이 지났을 수 있다.
+         */
+        if (Array.isArray(e.tariffBasisSchedule))
+            this.tariffBasisSchedule = e.tariffBasisSchedule.map(d => ({ ...d }));
+        if (Array.isArray(e.generationPriceSchedule))
+            this.generationPriceSchedule = e.generationPriceSchedule.map(d => ({ ...d }));
         if (e.tariffBasis?.from && e.tariffBasis?.to)
             this.tariffBasis = { ...e.tariffBasis };
         if (e.generationPrice?.from && e.generationPrice?.to)
             this.generationPrice = { ...e.generationPrice };
+        if (this.tariffBasisSchedule?.length || this.generationPriceSchedule?.length) {
+            this.refreshDeclarationsInEffect(this.nowMs());
+        }
         /* 이 주기의 최고도 이어받는다 — 재기동마다 0 으로 돌아가면 이미 넘은 것을 못 넘었다고 말한다. */
         if (Number.isFinite(Number(e.demandHigh?.kW)) && e.demandHigh?.since)
             this.demandHigh = { ...e.demandHigh };
@@ -1691,6 +1713,14 @@ export class EmsKernel extends FlowEngine {
             ...(this.lastBill ? { lastBill: { ...this.lastBill } } : {}),
             ...(this.tariffBasis ? { tariffBasis: { ...this.tariffBasis } } : {}),
             ...(this.generationPrice ? { generationPrice: { ...this.generationPrice } } : {}),
+            /*
+             * **예정된 선언도 함께 낸다.** 지금 유효한 것만 이어받으면, 재기동한 뒤 9월이 되어도 8월 단가로
+             * 계산한다 — 9월 선언이 어디에도 남아 있지 않기 때문이다. 오늘 이 부류를 세 번 겪었다.
+             */
+            ...(this.tariffBasisSchedule?.length ? { tariffBasisSchedule: this.tariffBasisSchedule.map(d => ({ ...d })) } : {}),
+            ...(this.generationPriceSchedule?.length
+                ? { generationPriceSchedule: this.generationPriceSchedule.map(d => ({ ...d })) }
+                : {}),
             ...(() => {
                 const r = this.generationRated();
                 return r ? { generationRated: r } : {};
@@ -1705,3 +1735,41 @@ export class EmsKernel extends FlowEngine {
         return { ...snap, energy };
     }
 }
+/**
+ * 선언 하나를 목록에 넣는다 — **같은 유효 구간이면 새것이 이긴다.**
+ *
+ * 사업자가 그 주기의 기준을 고칠 수 있다. 같은 구간에 두 선언이 남으면 어느 것이 맞는지 말할 수 없다.
+ *
+ * 목록은 시작 시각 순으로 두고 **24개까지** 든다. 선언은 주기마다 하나이므로 24개면 두 해치다 —
+ * 그보다 오래된 것은 지난 기록에서 읽는다(상태는 「지금」을 위한 것이다).
+ */
+function putDeclaration(list, d) {
+    const rest = (list ?? []).filter(x => !(x.from === d.from && x.to === d.to));
+    const next = [...rest, { ...d }].sort((a, b) => Date.parse(a.from) - Date.parse(b.from));
+    return next.length > 24 ? next.slice(next.length - 24) : next;
+}
+/**
+ * **이 시각에 유효한 선언** — 시작했고 아직 끝나지 않은 것.
+ *
+ * 유효한 것이 없으면 답하지 않는다. 가장 가까운 것을 골라 주지 않는다 — 아직 시작하지 않은 단가로
+ * 오늘을 계산하거나, 이미 끝난 단가를 지금 것인 양 쓰게 된다. 둘 다 오류 없이 틀린 값을 만든다.
+ *
+ * 구간이 겹치면 **나중에 시작한 것**이 이긴다(더 좁게 정한 선언이 앞선다).
+ */
+function inEffectAt(list, atMs) {
+    let best;
+    let bestFrom = -Infinity;
+    for (const d of list ?? []) {
+        const from = Date.parse(String(d.from));
+        const to = Date.parse(String(d.to));
+        if (!Number.isFinite(from) || !Number.isFinite(to))
+            continue;
+        if (atMs < from || atMs >= to)
+            continue;
+        if (from > bestFrom) {
+            best = d;
+            bestFrom = from;
+        }
+    }
+    return best;
+}

package/dist/energy-ingest.d.ts

@@ -35,6 +35,11 @@ export interface EnergyIngestOptions {
      * 그때도 `twin-local` 이되 범위는 비어 있다.
      */
     scopeId?: string;
+    /**
+     * **지금** — 아직 오지 않은 시각의 사실을 받지 않기 위해 쓴다. 주지 않으면 `defaultEventTime` 을 쓰고,
+     * 그것도 없으면 판단하지 않는다(없는 기준으로 거절하지 않는다).
+     */
+    nowISO?: string;
 }
 export interface EnergyIngestResult {
     accepted: CanonicalEnvelope[];
@@ -200,14 +205,6 @@ export interface EnergyBillRecord {
     billingDemandKW?: number;
 }
 export declare function isEnergyBillRecord(record: unknown): boolean;
-/**
- * 이 사실의 **주체를 무엇으로 부를까** — 선언이 있으면 그 이름, 없으면 이름표와 그 범위.
- *
- * 선언이 없을 때 트윈 범위를 이름에 넣는 이유는 **겹침을 숨기지 않기 위해서**다. 넣지 않으면 서로 다른
- * 설비의 같은 날이 한 사실이 되고, 여러 현장을 함께 계산하는 곳에서 한쪽이 조용히 사라진다(실측).
- * 넣되 `subjectBasis` 로 **이 이름이 트윈 안에서만 통한다**고 밝힌다 — 그릇으로 정한 이름을 고유한
- * 척하지 않는다.
- */
 export declare function resolveSubject(kind: 'equipment' | 'meter', localId: string, opts: EnergyIngestOptions): {
     subject: string;
     basis: 'declared' | 'twin-local';

package/dist/energy-ingest.js

@@ -452,6 +452,11 @@ export function ingestEnergyGenerationPeriodRecords(records, opts) {
         const subj = resolveSubject('equipment', equipmentId, opts);
         data.subject = subj.subject;
         data.subjectBasis = subj.basis;
+        const futureError = futureFactError(span.to, opts);
+        if (futureError) {
+            rejected.push({ record: r, errors: [futureError] });
+            continue;
+        }
         accepted.push({
             eventId: periodFactId(opts.tenantId, ENERGY_EVENT.generationPeriod, subj.subject, span.from, span.to),
             eventType: ENERGY_EVENT.generationPeriod,
@@ -607,6 +612,35 @@ export function isEnergyBillRecord(record) {
  * 넣되 `subjectBasis` 로 **이 이름이 트윈 안에서만 통한다**고 밝힌다 — 그릇으로 정한 이름을 고유한
  * 척하지 않는다.
  */
+/**
+ * **아직 오지 않은 시각의 사실은 받지 않는다.**
+ *
+ * ── 왜 필요한가 (2026-08-30) ──────────────────────────────────────────────
+ * 한 원본이 **끝나지 않은 이번 달**의 요금 정보를 청구서로 보냈다. 청구서의 사건 시각은 기간의 끝이라
+ * 그 사실이 **내일** 일어난 것으로 저널에 적혔다. 성과 계산은 「가장 늦은 사건」으로 구간을 잡으므로
+ * 구간 전체가 미래로 밀렸고, 그 현장의 화면에서 어제 발전량이 사라졌다. 오류는 하나도 나지 않았다.
+ *
+ * 지난 기록 채우기는 이미 이 판단을 하고 있었다(§`judgeBackfill`). 라이브 문에만 없어서 **한 종류에
+ * 규칙이 두 벌**이었다. 같은 사실이 어느 문으로 들어오느냐에 따라 받아지기도 하고 거절되기도 했다.
+ *
+ * ── 기준 선언은 이 판정을 받지 않는다 (2026-08-30, 두 번째 판단) ────────────
+ * 요금 기준·발전 단가는 **예정될 수 있다.** 한전은 다음 달 요금을 미리 공표하고, 공정 조건도 시행일을
+ * 앞두고 정해진다. 「9월부터 이 단가」는 오늘 성립하는 사실이다.
+ *
+ * 처음에는 이 둘도 거부했다. 그러면 정상적인 사실이 막힌다. 받되, **예정된 선언이 지금 것을 덮지 않게**
+ * 커널이 유효 구간으로 고른다(§`EnergyState.tariffBasisSchedule`). 받아 놓고 아무 데나 쓰면
+ * 오늘 요금이 다음 달 단가로 계산된다 — 그것이 이 문을 열기 전에 먼저 만들어야 했던 자리다.
+ */
+function futureFactError(eventTime, opts) {
+    const nowText = opts.nowISO ?? opts.defaultEventTime;
+    if (!nowText)
+        return undefined;
+    const nowMs = Date.parse(nowText);
+    const atMs = Date.parse(eventTime);
+    if (!Number.isFinite(nowMs) || !Number.isFinite(atMs) || atMs <= nowMs)
+        return undefined;
+    return `아직 오지 않은 시각의 사실이다(${eventTime}) — 끝나지 않은 기간은 마감된 사실이 아니다`;
+}
 export function resolveSubject(kind, localId, opts) {
     const declared = opts.identityOf?.(kind, localId);
     if (declared)
@@ -699,6 +733,11 @@ export function ingestEnergyUsagePeriodRecords(records, opts) {
             ...(currency ? { currency } : {}),
             ...(basis ? { basis } : {})
         };
+        const futureError = futureFactError(span.to, opts);
+        if (futureError) {
+            rejected.push({ record: r, errors: [futureError] });
+            continue;
+        }
         accepted.push({
             eventId: periodFactId(opts.tenantId, ENERGY_EVENT.usagePeriod, subj.subject, span.from, span.to),
             eventType: ENERGY_EVENT.usagePeriod,
@@ -745,6 +784,11 @@ export function ingestEnergyBillRecords(records, opts) {
             ...(currency ? { currency } : {}),
             ...(billingDemandKW !== undefined ? { billingDemandKW } : {})
         };
+        const futureError = futureFactError(span.to, opts);
+        if (futureError) {
+            rejected.push({ record: r, errors: [futureError] });
+            continue;
+        }
         accepted.push({
             eventId: periodFactId(opts.tenantId, ENERGY_EVENT.bill, '', span.from, span.to),
             eventType: ENERGY_EVENT.bill,

package/dist-cjs/index.cjs

@@ -2824,6 +2824,11 @@ function ingestEnergyGenerationPeriodRecords(records, opts) {
     const subj = resolveSubject("equipment", equipmentId, opts);
     data.subject = subj.subject;
     data.subjectBasis = subj.basis;
+    const futureError = futureFactError(span.to, opts);
+    if (futureError) {
+      rejected.push({ record: r, errors: [futureError] });
+      continue;
+    }
     accepted.push({
       eventId: periodFactId(opts.tenantId, ENERGY_EVENT.generationPeriod, subj.subject, span.from, span.to),
       eventType: ENERGY_EVENT.generationPeriod,
@@ -2919,6 +2924,14 @@ function isEnergyBillRecord(record) {
   if (r.from === void 0 || r.to === void 0) return false;
   return r.energyCharge !== void 0 || r.demandCharge !== void 0 || r.total !== void 0;
 }
+function futureFactError(eventTime, opts) {
+  const nowText = opts.nowISO ?? opts.defaultEventTime;
+  if (!nowText) return void 0;
+  const nowMs = Date.parse(nowText);
+  const atMs = Date.parse(eventTime);
+  if (!Number.isFinite(nowMs) || !Number.isFinite(atMs) || atMs <= nowMs) return void 0;
+  return `\uC544\uC9C1 \uC624\uC9C0 \uC54A\uC740 \uC2DC\uAC01\uC758 \uC0AC\uC2E4\uC774\uB2E4(${eventTime}) \u2014 \uB05D\uB098\uC9C0 \uC54A\uC740 \uAE30\uAC04\uC740 \uB9C8\uAC10\uB41C \uC0AC\uC2E4\uC774 \uC544\uB2C8\uB2E4`;
+}
 function resolveSubject(kind, localId, opts) {
   const declared = opts.identityOf?.(kind, localId);
   if (declared) return { subject: declared, basis: "declared" };
@@ -2997,6 +3010,11 @@ function ingestEnergyUsagePeriodRecords(records, opts) {
       ...currency ? { currency } : {},
       ...basis ? { basis } : {}
     };
+    const futureError = futureFactError(span.to, opts);
+    if (futureError) {
+      rejected.push({ record: r, errors: [futureError] });
+      continue;
+    }
     accepted.push({
       eventId: periodFactId(opts.tenantId, ENERGY_EVENT.usagePeriod, subj.subject, span.from, span.to),
       eventType: ENERGY_EVENT.usagePeriod,
@@ -3037,6 +3055,11 @@ function ingestEnergyBillRecords(records, opts) {
       ...currency ? { currency } : {},
       ...billingDemandKW !== void 0 ? { billingDemandKW } : {}
     };
+    const futureError = futureFactError(span.to, opts);
+    if (futureError) {
+      rejected.push({ record: r, errors: [futureError] });
+      continue;
+    }
     accepted.push({
       eventId: periodFactId(opts.tenantId, ENERGY_EVENT.bill, "", span.from, span.to),
       eventType: ENERGY_EVENT.bill,
@@ -8640,11 +8663,8 @@ var EmsKernel = class extends FlowEngine {
   applyGenerationPrice(envelope) {
     const d = envelope.data;
     if (!d?.from || !d?.to) return;
-    const fromMs = Date.parse(String(d.from));
-    if (!Number.isFinite(fromMs)) return;
-    const priorFromMs = Date.parse(String(this.generationPrice?.from ?? ""));
-    if (Number.isFinite(priorFromMs) && fromMs < priorFromMs) return;
-    this.generationPrice = { ...d };
+    this.generationPriceSchedule = putDeclaration(this.generationPriceSchedule, d);
+    this.generationPrice = inEffectAt(this.generationPriceSchedule, this.nowMs());
     this.revision++;
   }
   /**
@@ -8656,13 +8676,25 @@ var EmsKernel = class extends FlowEngine {
   applyTariffBasis(envelope) {
     const d = envelope.data;
     if (!d?.from || !d?.to) return;
-    const fromMs = Date.parse(String(d.from));
-    if (!Number.isFinite(fromMs)) return;
-    const priorFromMs = Date.parse(String(this.tariffBasis?.from ?? ""));
-    if (Number.isFinite(priorFromMs) && fromMs < priorFromMs) return;
-    this.tariffBasis = { ...d };
+    this.tariffBasisSchedule = putDeclaration(this.tariffBasisSchedule, d);
+    this.tariffBasis = inEffectAt(this.tariffBasisSchedule, this.nowMs());
     this.revision++;
   }
+  /**
+   * 시계가 선언의 경계를 넘으면 **지금 유효한 선언이 바뀐다.**
+   *
+   * 표본이 들어올 때만 다시 고르면, 9월 1일 0시에 단가가 바뀌었는데 다음 표본이 올 때까지 8월 단가로
+   * 계산한다. 태양광은 밤에 표본이 없어 그 간격이 길다.
+   */
+  refreshDeclarationsInEffect(nowMs) {
+    const tariff = inEffectAt(this.tariffBasisSchedule, nowMs);
+    const price = inEffectAt(this.generationPriceSchedule, nowMs);
+    if (tariff !== this.tariffBasis || price !== this.generationPrice) {
+      this.tariffBasis = tariff;
+      this.generationPrice = price;
+      this.revision++;
+    }
+  }
   /**
    * 청구서를 상태에 둔다 — **우리 계산을 덮지 않는다.**
    *
@@ -8881,8 +8913,12 @@ var EmsKernel = class extends FlowEngine {
   lastBill;
   /** 마지막으로 받은 요금 기준 — 이 주기에 적용되는 요금적용전력과 단가. */
   tariffBasis;
+  /** 선언된 요금 기준들 — 예정된 것을 포함한다(§`EnergyState.tariffBasisSchedule`). */
+  tariffBasisSchedule;
   /** 마지막으로 받은 발전 단가 — 이 기간에 낸 전기 1kWh 의 값. */
   generationPrice;
+  /** 선언된 발전 단가들 — 예정된 것을 포함한다. */
+  generationPriceSchedule;
   /**
    * 이 청구 주기의 **최고 수요** — 기본요금이 이 값으로 다시 정해진다.
    *
@@ -9519,6 +9555,7 @@ var EmsKernel = class extends FlowEngine {
     super.tick(dtMs);
     const at = this.nowMs();
     this.closeGenerationPeriodsDue(at);
+    this.refreshDeclarationsInEffect(at);
     this.deriveLoad(at, dtMs);
     this.closeDue(at);
   }
@@ -9558,8 +9595,13 @@ var EmsKernel = class extends FlowEngine {
     }
     if (Number.isFinite(e.unclosedGenerationPeriods)) this.unclosedGenerationPeriods = Number(e.unclosedGenerationPeriods);
     if (e.lastBill?.from && e.lastBill?.to) this.lastBill = { ...e.lastBill };
+    if (Array.isArray(e.tariffBasisSchedule)) this.tariffBasisSchedule = e.tariffBasisSchedule.map((d) => ({ ...d }));
+    if (Array.isArray(e.generationPriceSchedule)) this.generationPriceSchedule = e.generationPriceSchedule.map((d) => ({ ...d }));
     if (e.tariffBasis?.from && e.tariffBasis?.to) this.tariffBasis = { ...e.tariffBasis };
     if (e.generationPrice?.from && e.generationPrice?.to) this.generationPrice = { ...e.generationPrice };
+    if (this.tariffBasisSchedule?.length || this.generationPriceSchedule?.length) {
+      this.refreshDeclarationsInEffect(this.nowMs());
+    }
     if (Number.isFinite(Number(e.demandHigh?.kW)) && e.demandHigh?.since) this.demandHigh = { ...e.demandHigh };
   }
   getSnapshot() {
@@ -9584,6 +9626,12 @@ var EmsKernel = class extends FlowEngine {
       ...this.lastBill ? { lastBill: { ...this.lastBill } } : {},
       ...this.tariffBasis ? { tariffBasis: { ...this.tariffBasis } } : {},
       ...this.generationPrice ? { generationPrice: { ...this.generationPrice } } : {},
+      /*
+       * **예정된 선언도 함께 낸다.** 지금 유효한 것만 이어받으면, 재기동한 뒤 9월이 되어도 8월 단가로
+       * 계산한다 — 9월 선언이 어디에도 남아 있지 않기 때문이다. 오늘 이 부류를 세 번 겪었다.
+       */
+      ...this.tariffBasisSchedule?.length ? { tariffBasisSchedule: this.tariffBasisSchedule.map((d) => ({ ...d })) } : {},
+      ...this.generationPriceSchedule?.length ? { generationPriceSchedule: this.generationPriceSchedule.map((d) => ({ ...d })) } : {},
       ...(() => {
         const r = this.generationRated();
         return r ? { generationRated: r } : {};
@@ -9596,6 +9644,26 @@ var EmsKernel = class extends FlowEngine {
     return { ...snap, energy };
   }
 };
+function putDeclaration(list, d) {
+  const rest = (list ?? []).filter((x) => !(x.from === d.from && x.to === d.to));
+  const next = [...rest, { ...d }].sort((a, b) => Date.parse(a.from) - Date.parse(b.from));
+  return next.length > 24 ? next.slice(next.length - 24) : next;
+}
+function inEffectAt(list, atMs) {
+  let best;
+  let bestFrom = -Infinity;
+  for (const d of list ?? []) {
+    const from = Date.parse(String(d.from));
+    const to = Date.parse(String(d.to));
+    if (!Number.isFinite(from) || !Number.isFinite(to)) continue;
+    if (atMs < from || atMs >= to) continue;
+    if (from > bestFrom) {
+      best = d;
+      bestFrom = from;
+    }
+  }
+  return best;
+}
 
 // src/event-journal.ts
 var DOMAIN_KERNELS = { wms: WmsKernel, yms: YmsKernel, mes: MesKernel, ems: EmsKernel };

package/package.json

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