@operato/twin-kernel 0.7.87 → 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.js

@@ -503,11 +503,6 @@ export function ingestEnergyGenerationPriceRecords(records, opts) {
             continue;
         }
         const data = { from: span.from, to: span.to, unitPrice, currency };
-        const futureError = futureFactError(span.from, opts);
-        if (futureError) {
-            rejected.push({ record: r, errors: [futureError] });
-            continue;
-        }
         accepted.push({
             eventId: periodFactId(opts.tenantId, ENERGY_EVENT.generationPrice, '', span.from, span.to),
             eventType: ENERGY_EVENT.generationPrice,
@@ -573,11 +568,6 @@ export function ingestEnergyTariffBasisRecords(records, opts) {
             ...(demandChargePerKW !== undefined ? { demandChargePerKW } : {}),
             ...(currency ? { currency } : {})
         };
-        const futureError = futureFactError(span.from, opts);
-        if (futureError) {
-            rejected.push({ record: r, errors: [futureError] });
-            continue;
-        }
         accepted.push({
             eventId: periodFactId(opts.tenantId, ENERGY_EVENT.tariffBasis, '', span.from, span.to),
             eventType: ENERGY_EVENT.tariffBasis,
@@ -633,8 +623,13 @@ export function isEnergyBillRecord(record) {
  * 지난 기록 채우기는 이미 이 판단을 하고 있었다(§`judgeBackfill`). 라이브 문에만 없어서 **한 종류에
  * 규칙이 두 벌**이었다. 같은 사실이 어느 문으로 들어오느냐에 따라 받아지기도 하고 거절되기도 했다.
  *
- * 기준 선언(요금 기준·발전 단가)은 기간이 미래로 뻗어도 된다 — 그쪽은 사건 시각이 **기간의 시작**이라
- * 이 판정에 걸리지 않는다. 앞으로 이렇게 매기겠다는 선언은 오늘 성립한다.
+ * ── 기준 선언은 이 판정을 받지 않는다 (2026-08-30, 두 번째 판단) ────────────
+ * 요금 기준·발전 단가는 **예정될 수 있다.** 한전은 다음 달 요금을 미리 공표하고, 공정 조건도 시행일을
+ * 앞두고 정해진다. 「9월부터 이 단가」는 오늘 성립하는 사실이다.
+ *
+ * 처음에는 이 둘도 거부했다. 그러면 정상적인 사실이 막힌다. 받되, **예정된 선언이 지금 것을 덮지 않게**
+ * 커널이 유효 구간으로 고른다(§`EnergyState.tariffBasisSchedule`). 받아 놓고 아무 데나 쓰면
+ * 오늘 요금이 다음 달 단가로 계산된다 — 그것이 이 문을 열기 전에 먼저 만들어야 했던 자리다.
  */
 function futureFactError(eventTime, opts) {
     const nowText = opts.nowISO ?? opts.defaultEventTime;

package/dist-cjs/index.cjs

@@ -2862,11 +2862,6 @@ function ingestEnergyGenerationPriceRecords(records, opts) {
       continue;
     }
     const data = { from: span.from, to: span.to, unitPrice, currency };
-    const futureError = futureFactError(span.from, opts);
-    if (futureError) {
-      rejected.push({ record: r, errors: [futureError] });
-      continue;
-    }
     accepted.push({
       eventId: periodFactId(opts.tenantId, ENERGY_EVENT.generationPrice, "", span.from, span.to),
       eventType: ENERGY_EVENT.generationPrice,
@@ -2912,11 +2907,6 @@ function ingestEnergyTariffBasisRecords(records, opts) {
       ...demandChargePerKW !== void 0 ? { demandChargePerKW } : {},
       ...currency ? { currency } : {}
     };
-    const futureError = futureFactError(span.from, opts);
-    if (futureError) {
-      rejected.push({ record: r, errors: [futureError] });
-      continue;
-    }
     accepted.push({
       eventId: periodFactId(opts.tenantId, ENERGY_EVENT.tariffBasis, "", span.from, span.to),
       eventType: ENERGY_EVENT.tariffBasis,
@@ -8673,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++;
   }
   /**
@@ -8689,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++;
+    }
+  }
   /**
    * 청구서를 상태에 둔다 — **우리 계산을 덮지 않는다.**
    *
@@ -8914,8 +8913,12 @@ var EmsKernel = class extends FlowEngine {
   lastBill;
   /** 마지막으로 받은 요금 기준 — 이 주기에 적용되는 요금적용전력과 단가. */
   tariffBasis;
+  /** 선언된 요금 기준들 — 예정된 것을 포함한다(§`EnergyState.tariffBasisSchedule`). */
+  tariffBasisSchedule;
   /** 마지막으로 받은 발전 단가 — 이 기간에 낸 전기 1kWh 의 값. */
   generationPrice;
+  /** 선언된 발전 단가들 — 예정된 것을 포함한다. */
+  generationPriceSchedule;
   /**
    * 이 청구 주기의 **최고 수요** — 기본요금이 이 값으로 다시 정해진다.
    *
@@ -9552,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);
   }
@@ -9591,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() {
@@ -9617,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 } : {};
@@ -9629,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.87",
+  "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": {