@operato/twin-kernel 0.7.78 → 0.7.80

package/dist/contract.d.ts

@@ -2052,6 +2052,12 @@ export interface EnergyState {
         basis: 'ac' | 'dc';
         from: 'equipment' | 'location';
     };
+    /**
+     * 마지막으로 받은 **발전 단가** — 이 기간에 낸 전기 1kWh 의 값.
+     *
+     * 창 밖의 단가도 이 창에 적용될 수 있어(단가는 기간마다 정해진다) 상태로 이어 간다.
+     */
+    generationPrice?: EnergyGenerationPriceData;
     /**
      * 이 청구 주기의 **최고 수요** — 기본요금이 이 값으로 다시 정해진다.
      *
@@ -2491,6 +2497,23 @@ export declare const ENERGY_EVENT: {
      * 쪽인지 말한다.
      */
     readonly usagePeriod: "energy.usage.period";
+    /**
+     * **발전에 매겨지는 단가가 정해졌다** — 이 기간에 낸 전기 1kWh 의 값.
+     *
+     * 소비에 요금이 매겨지듯 발전에도 값이 매겨진다. 파는 발전소는 판 값이고, 자가소비형은 아꼈다고
+     * 볼 수 있는 값이다 — 어느 쪽인지는 현장이 정한다.
+     *
+     * **단가는 날마다 바뀐다.** 그래서 선언이 아니라 기간을 가진 사실로 받는다. 선언에 적어 두면
+     * 사람이 매일 갱신해야 하고, 안 하면 낡은 값으로 수익이 조용히 틀린다.
+     *
+     * 사건 시각은 기간의 시작이다 — 「이 시각부터 이 단가가 적용된다」이므로 기간이 끝나기 전에 성립한다.
+     *
+     * ── 담지 않은 것 ────────────────────────────────────────────────────────────
+     * 제도마다 있는 가산·인증서·가중치는 담지 않는다. 그 셈은 제도가 정하고 나라마다 다르므로,
+     * 커넥터가 계산해 **1kWh 당 얼마**로 옮겨 보낸다. 커널이 한 제도의 모양을 안으면 다른 제도에서
+     * 그 자리가 거짓이 된다.
+     */
+    readonly generationPrice: "energy.generation.price";
     /**
      * **이 주기에 적용되는 요금 기준이 정해졌다** — 요금적용전력과 기본요금 단가.
      *
@@ -2764,6 +2787,19 @@ export interface EnergyUsagePeriodData {
  * 사건 시각은 `from` 이다. 「이 시각부터 이 기준이 적용된다」이므로 주기가 끝나기 전에 성립하고,
  * `to` 로 시각을 잡으면 아직 오지 않은 시각이 저널에 적힌다.
  */
+/**
+ * 발전 단가 — `ENERGY_EVENT.generationPrice` 의 데이터.
+ *
+ * 사건 시각은 `from` 이다(그때부터 적용된다). 가산·인증서 같은 제도의 셈은 커넥터가 하고, 여기에는
+ * **1kWh 당 얼마**만 온다.
+ */
+export interface EnergyGenerationPriceData {
+    from: ISOTime;
+    to: ISOTime;
+    /** 1kWh 당 값. 통화는 `currency`. */
+    unitPrice: number;
+    currency: string;
+}
 export interface EnergyTariffBasisData {
     from: ISOTime;
     to: ISOTime;

package/dist/contract.js

@@ -1046,6 +1046,23 @@ export const ENERGY_EVENT = {
      * 쪽인지 말한다.
      */
     usagePeriod: 'energy.usage.period',
+    /**
+     * **발전에 매겨지는 단가가 정해졌다** — 이 기간에 낸 전기 1kWh 의 값.
+     *
+     * 소비에 요금이 매겨지듯 발전에도 값이 매겨진다. 파는 발전소는 판 값이고, 자가소비형은 아꼈다고
+     * 볼 수 있는 값이다 — 어느 쪽인지는 현장이 정한다.
+     *
+     * **단가는 날마다 바뀐다.** 그래서 선언이 아니라 기간을 가진 사실로 받는다. 선언에 적어 두면
+     * 사람이 매일 갱신해야 하고, 안 하면 낡은 값으로 수익이 조용히 틀린다.
+     *
+     * 사건 시각은 기간의 시작이다 — 「이 시각부터 이 단가가 적용된다」이므로 기간이 끝나기 전에 성립한다.
+     *
+     * ── 담지 않은 것 ────────────────────────────────────────────────────────────
+     * 제도마다 있는 가산·인증서·가중치는 담지 않는다. 그 셈은 제도가 정하고 나라마다 다르므로,
+     * 커넥터가 계산해 **1kWh 당 얼마**로 옮겨 보낸다. 커널이 한 제도의 모양을 안으면 다른 제도에서
+     * 그 자리가 거짓이 된다.
+     */
+    generationPrice: 'energy.generation.price',
     /**
      * **이 주기에 적용되는 요금 기준이 정해졌다** — 요금적용전력과 기본요금 단가.
      *

package/dist/ems-kernel.d.ts

@@ -122,6 +122,10 @@ export declare class EmsKernel extends FlowEngine {
      * 모르는 지점이면 세어 둔다 — 조용히 버리면 「값이 왜 안 보이지」로만 남는다(계량과 같은 규율).
      */
     private applyUsagePeriod;
+    /**
+     * 발전 단가를 상태에 둔다 — 늦게 온 지난 기간의 단가가 최신을 덮지 않게 시작 시각으로 가린다.
+     */
+    private applyGenerationPrice;
     /**
      * 이 주기에 적용되는 요금 기준을 상태에 둔다.
      *
@@ -165,6 +169,15 @@ export declare class EmsKernel extends FlowEngine {
      * 않으면 늦게 온 옛 적산이 최신 값을 뒤로 돌린다 — 그리고 그것이 「계기가 되돌아갔다」로 잘못 적힌다.
      */
     private applyGenerated;
+    /**
+     * 시계가 기간의 끝을 지났으면 마감한다 — **표본을 기다리지 않는다.**
+     *
+     * 값이 오지 않는 밤에도 자정이 지나면 어제가 닫힌다. 마감에 쓰는 총량은 **그날 마지막으로 본 값**
+     * 이므로 표본이 더 오지 않아도 정확하다(하루 누적은 그 값이 곧 그날의 총량이다).
+     *
+     * 이 자리는 계량의 `closeDue` 와 같은 성질이다 — 호스트가 시각을 주며 부른다.
+     */
+    closeGenerationPeriodsDue(nowMs: number): void;
     /**
      * **기간이 끝났으면 그 기간의 발전량을 사실로 낸다.**
      *
@@ -208,6 +221,8 @@ export declare class EmsKernel extends FlowEngine {
     private lastBill?;
     /** 마지막으로 받은 요금 기준 — 이 주기에 적용되는 요금적용전력과 단가. */
     private tariffBasis?;
+    /** 마지막으로 받은 발전 단가 — 이 기간에 낸 전기 1kWh 의 값. */
+    private generationPrice?;
     /**
      * 이 청구 주기의 **최고 수요** — 기본요금이 이 값으로 다시 정해진다.
      *

package/dist/ems-kernel.js

@@ -281,6 +281,10 @@ export class EmsKernel extends FlowEngine {
             this.applyTariffBasis(envelope);
             return;
         }
+        if (envelope.eventType === ENERGY_EVENT.generationPrice) {
+            this.applyGenerationPrice(envelope);
+            return;
+        }
         super.apply(envelope);
     }
     /**
@@ -341,6 +345,22 @@ export class EmsKernel extends FlowEngine {
         }
         this.revision++;
     }
+    /**
+     * 발전 단가를 상태에 둔다 — 늦게 온 지난 기간의 단가가 최신을 덮지 않게 시작 시각으로 가린다.
+     */
+    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.revision++;
+    }
     /**
      * 이 주기에 적용되는 요금 기준을 상태에 둔다.
      *
@@ -512,6 +532,39 @@ export class EmsKernel extends FlowEngine {
         this.closeGenerationPeriod(id, eq, { atMs, kWh, dayIndex, kind, since, priorSince, periodAdvanced, faulted: dropped && sameDayDrop });
         this.revision++;
     }
+    /**
+     * 시계가 기간의 끝을 지났으면 마감한다 — **표본을 기다리지 않는다.**
+     *
+     * 값이 오지 않는 밤에도 자정이 지나면 어제가 닫힌다. 마감에 쓰는 총량은 **그날 마지막으로 본 값**
+     * 이므로 표본이 더 오지 않아도 정확하다(하루 누적은 그 값이 곧 그날의 총량이다).
+     *
+     * 이 자리는 계량의 `closeDue` 와 같은 성질이다 — 호스트가 시각을 주며 부른다.
+     */
+    closeGenerationPeriodsDue(nowMs) {
+        const today = this.localDayIndex(nowMs);
+        for (const [id, obs] of [...this.generationPeriodObs.entries()]) {
+            if (today <= obs.dayIndex)
+                continue;
+            const eq = this.equipment.get(id);
+            if (!eq)
+                continue;
+            const kind = eq.generatedKWhAccumulation;
+            /*
+             * 마감은 `applyGenerated` 와 **같은 함수**로 한다 — 규칙을 두 벌 만들면 표본으로 닫은 날과
+             * 시계로 닫은 날이 다른 값을 낸다.
+             *
+             * 그때 「지금 들어온 값」이 없으므로, 마지막으로 본 값을 그대로 넘긴다(그 값은 이미 상태에 있다).
+             */
+            this.closeGenerationPeriod(id, eq, {
+                atMs: nowMs,
+                kWh: obs.lastKWh,
+                dayIndex: today,
+                kind,
+                periodAdvanced: false,
+                faulted: false
+            });
+        }
+    }
     /**
      * **기간이 끝났으면 그 기간의 발전량을 사실로 낸다.**
      *
@@ -627,6 +680,8 @@ export class EmsKernel extends FlowEngine {
     lastBill;
     /** 마지막으로 받은 요금 기준 — 이 주기에 적용되는 요금적용전력과 단가. */
     tariffBasis;
+    /** 마지막으로 받은 발전 단가 — 이 기간에 낸 전기 1kWh 의 값. */
+    generationPrice;
     /**
      * 이 청구 주기의 **최고 수요** — 기본요금이 이 값으로 다시 정해진다.
      *
@@ -1501,6 +1556,16 @@ export class EmsKernel extends FlowEngine {
          * 부하를 먼저 만들고 마감한다 — 마감이 먼저면 마지막 값이 다음 구간으로 밀린다.
          */
         const at = this.nowMs();
+        /*
+         * ── 발전 기간도 **시계로** 마감한다 (2026-08-30) ───────────────────────────
+         *
+         * 앞 판은 새 표본이 올 때만 날짜가 바뀐 것을 알아챘다. 그런데 태양광은 해가 지면 값을 보내지
+         * 않는다 — 어제 마지막 표본이 19:40 이면 어제 하루치가 **다음 날 아침 첫 표본**에야 확정된다.
+         * 밤새 「어제 얼마 냈나」에 답이 없다.
+         *
+         * 계량은 이미 시계로 마감한다(`closeDue`). 한 커널 안에서 규칙이 두 벌일 이유가 없다.
+         */
+        this.closeGenerationPeriodsDue(at);
         /* 틱 길이를 함께 넘긴다 — 방전량을 에너지로 바꿀 때 필요하다(필드로 숨기면 어디서 온 값인지 흐려진다). */
         this.deriveLoad(at, dtMs);
         this.closeDue(at);
@@ -1560,6 +1625,8 @@ export class EmsKernel extends FlowEngine {
             this.lastBill = { ...e.lastBill };
         if (e.tariffBasis?.from && e.tariffBasis?.to)
             this.tariffBasis = { ...e.tariffBasis };
+        if (e.generationPrice?.from && e.generationPrice?.to)
+            this.generationPrice = { ...e.generationPrice };
         /* 이 주기의 최고도 이어받는다 — 재기동마다 0 으로 돌아가면 이미 넘은 것을 못 넘었다고 말한다. */
         if (Number.isFinite(Number(e.demandHigh?.kW)) && e.demandHigh?.since)
             this.demandHigh = { ...e.demandHigh };
@@ -1589,6 +1656,7 @@ export class EmsKernel extends FlowEngine {
             ...(this.unclosedGenerationPeriods ? { unclosedGenerationPeriods: this.unclosedGenerationPeriods } : {}),
             ...(this.lastBill ? { lastBill: { ...this.lastBill } } : {}),
             ...(this.tariffBasis ? { tariffBasis: { ...this.tariffBasis } } : {}),
+            ...(this.generationPrice ? { generationPrice: { ...this.generationPrice } } : {}),
             ...(() => {
                 const r = this.generationRated();
                 return r ? { generationRated: r } : {};

package/dist/energy-ingest.d.ts

@@ -115,6 +115,21 @@ export interface EnergyUsagePeriodRecord {
     basis?: string;
 }
 export declare function isEnergyUsagePeriodRecord(record: unknown): boolean;
+/** 발전 단가 — 이 기간에 낸 전기 1kWh 의 값. 날마다 바뀐다. */
+export interface EnergyGenerationPriceRecord {
+    from: string;
+    to: string;
+    unitPrice: number;
+    currency: string;
+}
+export declare function isEnergyGenerationPriceRecord(record: unknown): boolean;
+/**
+ * 발전 단가를 봉투로 — **사건 시각은 `from`** 이다(그때부터 적용된다).
+ *
+ * 제도의 가산·인증서 셈은 커넥터가 하고 여기에는 1kWh 당 얼마만 온다. 커널이 한 제도의 모양을
+ * 안으면 다른 제도에서 그 자리가 거짓이 된다.
+ */
+export declare function ingestEnergyGenerationPriceRecords(records: EnergyGenerationPriceRecord | EnergyGenerationPriceRecord[] | undefined | null, opts: EnergyIngestOptions): EnergyIngestResult;
 /** 이 주기에 적용되는 요금 기준 — 공급자가 정하고 매 주기 다시 정해진다. */
 export interface EnergyTariffBasisRecord {
     from: string;

package/dist/energy-ingest.js

@@ -378,6 +378,53 @@ export function isEnergyUsagePeriodRecord(record) {
     const r = record;
     return !!r && typeof r === 'object' && r.meterId !== undefined && r.from !== undefined && r.to !== undefined && r.kWh !== undefined;
 }
+export function isEnergyGenerationPriceRecord(record) {
+    const r = record;
+    if (!r || typeof r !== 'object')
+        return false;
+    if (r.from === undefined || r.to === undefined)
+        return false;
+    /* 계량 지점·설비가 있으면 그 설비의 사실이지 단가가 아니다 — 문이 겹치지 않게. */
+    if (r.meterId !== undefined || r.equipmentId !== undefined)
+        return false;
+    return r.unitPrice !== undefined;
+}
+/**
+ * 발전 단가를 봉투로 — **사건 시각은 `from`** 이다(그때부터 적용된다).
+ *
+ * 제도의 가산·인증서 셈은 커넥터가 하고 여기에는 1kWh 당 얼마만 온다. 커널이 한 제도의 모양을
+ * 안으면 다른 제도에서 그 자리가 거짓이 된다.
+ */
+export function ingestEnergyGenerationPriceRecords(records, opts) {
+    const list = records === undefined || records === null ? [] : Array.isArray(records) ? records : [records];
+    const accepted = [];
+    const rejected = [];
+    let seq = 0;
+    for (const r of list) {
+        const errors = [];
+        const span = readSpan(r, errors);
+        const unitPrice = readAmount(r?.unitPrice, 'unitPrice', errors);
+        if (unitPrice === undefined && !errors.length)
+            errors.push('unitPrice 가 없다 — 이 문이 받는 값은 1kWh 당 값 하나다');
+        /* 단위 없는 값은 다른 금액과 더할 수 없다. */
+        const currency = String(r?.currency ?? '').trim();
+        if (!currency)
+            errors.push('currency 가 없다 — 단위 없는 값은 다른 금액과 더할 수 없다');
+        if (errors.length || !span || unitPrice === undefined) {
+            rejected.push({ record: r, errors });
+            continue;
+        }
+        const data = { from: span.from, to: span.to, unitPrice, currency };
+        accepted.push({
+            eventId: `${opts.tenantId}-generation-price-${++seq}`,
+            eventType: ENERGY_EVENT.generationPrice,
+            eventTime: span.from,
+            tenantId: opts.tenantId,
+            data
+        });
+    }
+    return { accepted, rejected };
+}
 export function isEnergyTariffBasisRecord(record) {
     const r = record;
     if (!r || typeof r !== 'object')

package/dist/index.d.ts

@@ -30,10 +30,10 @@ export { WmsKernel } from './kernel.ts';
 export { YmsKernel } from './yms-kernel.ts';
 export { MesKernel } from './mes-kernel.ts';
 export { EmsKernel, DEMAND_WINDOW_MS, demandWindowStart } from './ems-kernel.ts';
-export { ingestEnergyRecords, isEnergyRecord, ingestEnergyEquipmentRecords, isEnergyEquipmentRecord, ingestEnergyGenerationRecords, isEnergyGenerationRecord, ingestEnergyUsagePeriodRecords, isEnergyUsagePeriodRecord, ingestEnergyBillRecords, isEnergyBillRecord, ingestEnergyTariffBasisRecords, isEnergyTariffBasisRecord } from './energy-ingest.ts';
+export { ingestEnergyRecords, isEnergyRecord, ingestEnergyEquipmentRecords, isEnergyEquipmentRecord, ingestEnergyGenerationRecords, isEnergyGenerationRecord, ingestEnergyUsagePeriodRecords, isEnergyUsagePeriodRecord, ingestEnergyBillRecords, isEnergyBillRecord, ingestEnergyTariffBasisRecords, isEnergyTariffBasisRecord, ingestEnergyGenerationPriceRecords, isEnergyGenerationPriceRecord } from './energy-ingest.ts';
 export { ingestOperationalRecords, isOperationalRecord, operationalKindOf } from './operational-ingest.ts';
 export type { OperationalKind, OperationalRecord, OperationalIngestOptions } from './operational-ingest.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, EnergyGenerationRecord, EnergyUsagePeriodRecord, EnergyBillRecord, EnergyTariffBasisRecord, EnergyIngestOptions, EnergyIngestResult } from './energy-ingest.ts';
+export type { EnergyRecord, EnergyEquipmentRecord, EnergyGenerationRecord, EnergyUsagePeriodRecord, EnergyBillRecord, EnergyTariffBasisRecord, EnergyGenerationPriceRecord, EnergyIngestOptions, EnergyIngestResult } from './energy-ingest.ts';
 export * from './vocabulary.ts';

package/dist/index.js

@@ -30,7 +30,7 @@ export { WmsKernel } from "./kernel.js";
 export { YmsKernel } from "./yms-kernel.js";
 export { MesKernel } from "./mes-kernel.js";
 export { EmsKernel, DEMAND_WINDOW_MS, demandWindowStart } from "./ems-kernel.js";
-export { ingestEnergyRecords, isEnergyRecord, ingestEnergyEquipmentRecords, isEnergyEquipmentRecord, ingestEnergyGenerationRecords, isEnergyGenerationRecord, ingestEnergyUsagePeriodRecords, isEnergyUsagePeriodRecord, ingestEnergyBillRecords, isEnergyBillRecord, ingestEnergyTariffBasisRecords, isEnergyTariffBasisRecord } from "./energy-ingest.js";
+export { ingestEnergyRecords, isEnergyRecord, ingestEnergyEquipmentRecords, isEnergyEquipmentRecord, ingestEnergyGenerationRecords, isEnergyGenerationRecord, ingestEnergyUsagePeriodRecords, isEnergyUsagePeriodRecord, ingestEnergyBillRecords, isEnergyBillRecord, ingestEnergyTariffBasisRecords, isEnergyTariffBasisRecord, ingestEnergyGenerationPriceRecords, isEnergyGenerationPriceRecord } from "./energy-ingest.js";
 /* 운영 사실의 문 — 리듀서가 다루는 여섯이 들어오는 자리(미러가 시뮬보다 가난하지 않게). */
 export { ingestOperationalRecords, isOperationalRecord, operationalKindOf } from "./operational-ingest.js";
 export { attributeEnergy, electricityCost, energyIntensity, energyOfWindows } from "./energy-attribution.js";

package/dist-cjs/index.cjs

@@ -127,6 +127,7 @@ __export(index_exports, {
   ingest: () => ingest,
   ingestEnergyBillRecords: () => ingestEnergyBillRecords,
   ingestEnergyEquipmentRecords: () => ingestEnergyEquipmentRecords,
+  ingestEnergyGenerationPriceRecords: () => ingestEnergyGenerationPriceRecords,
   ingestEnergyGenerationRecords: () => ingestEnergyGenerationRecords,
   ingestEnergyRecords: () => ingestEnergyRecords,
   ingestEnergyTariffBasisRecords: () => ingestEnergyTariffBasisRecords,
@@ -137,6 +138,7 @@ __export(index_exports, {
   isElectricalLocationType: () => isElectricalLocationType,
   isEnergyBillRecord: () => isEnergyBillRecord,
   isEnergyEquipmentRecord: () => isEnergyEquipmentRecord,
+  isEnergyGenerationPriceRecord: () => isEnergyGenerationPriceRecord,
   isEnergyGenerationRecord: () => isEnergyGenerationRecord,
   isEnergyRecord: () => isEnergyRecord,
   isEnergyTariffBasisRecord: () => isEnergyTariffBasisRecord,
@@ -711,6 +713,23 @@ var ENERGY_EVENT = {
    * 쪽인지 말한다.
    */
   usagePeriod: "energy.usage.period",
+  /**
+   * **발전에 매겨지는 단가가 정해졌다** — 이 기간에 낸 전기 1kWh 의 값.
+   *
+   * 소비에 요금이 매겨지듯 발전에도 값이 매겨진다. 파는 발전소는 판 값이고, 자가소비형은 아꼈다고
+   * 볼 수 있는 값이다 — 어느 쪽인지는 현장이 정한다.
+   *
+   * **단가는 날마다 바뀐다.** 그래서 선언이 아니라 기간을 가진 사실로 받는다. 선언에 적어 두면
+   * 사람이 매일 갱신해야 하고, 안 하면 낡은 값으로 수익이 조용히 틀린다.
+   *
+   * 사건 시각은 기간의 시작이다 — 「이 시각부터 이 단가가 적용된다」이므로 기간이 끝나기 전에 성립한다.
+   *
+   * ── 담지 않은 것 ────────────────────────────────────────────────────────────
+   * 제도마다 있는 가산·인증서·가중치는 담지 않는다. 그 셈은 제도가 정하고 나라마다 다르므로,
+   * 커넥터가 계산해 **1kWh 당 얼마**로 옮겨 보낸다. 커널이 한 제도의 모양을 안으면 다른 제도에서
+   * 그 자리가 거짓이 된다.
+   */
+  generationPrice: "energy.generation.price",
   /**
    * **이 주기에 적용되는 요금 기준이 정해졌다** — 요금적용전력과 기본요금 단가.
    *
@@ -7991,6 +8010,10 @@ var EmsKernel = class extends FlowEngine {
       this.applyTariffBasis(envelope);
       return;
     }
+    if (envelope.eventType === ENERGY_EVENT.generationPrice) {
+      this.applyGenerationPrice(envelope);
+      return;
+    }
     super.apply(envelope);
   }
   /**
@@ -8031,6 +8054,19 @@ var EmsKernel = class extends FlowEngine {
     }
     this.revision++;
   }
+  /**
+   * 발전 단가를 상태에 둔다 — 늦게 온 지난 기간의 단가가 최신을 덮지 않게 시작 시각으로 가린다.
+   */
+  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.revision++;
+  }
   /**
    * 이 주기에 적용되는 요금 기준을 상태에 둔다.
    *
@@ -8132,6 +8168,31 @@ var EmsKernel = class extends FlowEngine {
     this.closeGenerationPeriod(id, eq, { atMs, kWh, dayIndex, kind, since, priorSince, periodAdvanced, faulted: dropped && sameDayDrop });
     this.revision++;
   }
+  /**
+   * 시계가 기간의 끝을 지났으면 마감한다 — **표본을 기다리지 않는다.**
+   *
+   * 값이 오지 않는 밤에도 자정이 지나면 어제가 닫힌다. 마감에 쓰는 총량은 **그날 마지막으로 본 값**
+   * 이므로 표본이 더 오지 않아도 정확하다(하루 누적은 그 값이 곧 그날의 총량이다).
+   *
+   * 이 자리는 계량의 `closeDue` 와 같은 성질이다 — 호스트가 시각을 주며 부른다.
+   */
+  closeGenerationPeriodsDue(nowMs) {
+    const today = this.localDayIndex(nowMs);
+    for (const [id, obs] of [...this.generationPeriodObs.entries()]) {
+      if (today <= obs.dayIndex) continue;
+      const eq = this.equipment.get(id);
+      if (!eq) continue;
+      const kind = eq.generatedKWhAccumulation;
+      this.closeGenerationPeriod(id, eq, {
+        atMs: nowMs,
+        kWh: obs.lastKWh,
+        dayIndex: today,
+        kind,
+        periodAdvanced: false,
+        faulted: false
+      });
+    }
+  }
   /**
    * **기간이 끝났으면 그 기간의 발전량을 사실로 낸다.**
    *
@@ -8225,6 +8286,8 @@ var EmsKernel = class extends FlowEngine {
   lastBill;
   /** 마지막으로 받은 요금 기준 — 이 주기에 적용되는 요금적용전력과 단가. */
   tariffBasis;
+  /** 마지막으로 받은 발전 단가 — 이 기간에 낸 전기 1kWh 의 값. */
+  generationPrice;
   /**
    * 이 청구 주기의 **최고 수요** — 기본요금이 이 값으로 다시 정해진다.
    *
@@ -8860,6 +8923,7 @@ var EmsKernel = class extends FlowEngine {
   tick(dtMs) {
     super.tick(dtMs);
     const at = this.nowMs();
+    this.closeGenerationPeriodsDue(at);
     this.deriveLoad(at, dtMs);
     this.closeDue(at);
   }
@@ -8899,6 +8963,7 @@ 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 (e.tariffBasis?.from && e.tariffBasis?.to) this.tariffBasis = { ...e.tariffBasis };
+    if (e.generationPrice?.from && e.generationPrice?.to) this.generationPrice = { ...e.generationPrice };
     if (Number.isFinite(Number(e.demandHigh?.kW)) && e.demandHigh?.since) this.demandHigh = { ...e.demandHigh };
   }
   getSnapshot() {
@@ -8922,6 +8987,7 @@ var EmsKernel = class extends FlowEngine {
       ...this.unclosedGenerationPeriods ? { unclosedGenerationPeriods: this.unclosedGenerationPeriods } : {},
       ...this.lastBill ? { lastBill: { ...this.lastBill } } : {},
       ...this.tariffBasis ? { tariffBasis: { ...this.tariffBasis } } : {},
+      ...this.generationPrice ? { generationPrice: { ...this.generationPrice } } : {},
       ...(() => {
         const r = this.generationRated();
         return r ? { generationRated: r } : {};
@@ -9972,6 +10038,40 @@ function isEnergyUsagePeriodRecord(record) {
   const r = record;
   return !!r && typeof r === "object" && r.meterId !== void 0 && r.from !== void 0 && r.to !== void 0 && r.kWh !== void 0;
 }
+function isEnergyGenerationPriceRecord(record) {
+  const r = record;
+  if (!r || typeof r !== "object") return false;
+  if (r.from === void 0 || r.to === void 0) return false;
+  if (r.meterId !== void 0 || r.equipmentId !== void 0) return false;
+  return r.unitPrice !== void 0;
+}
+function ingestEnergyGenerationPriceRecords(records, opts) {
+  const list = records === void 0 || records === null ? [] : Array.isArray(records) ? records : [records];
+  const accepted = [];
+  const rejected = [];
+  let seq = 0;
+  for (const r of list) {
+    const errors = [];
+    const span = readSpan(r, errors);
+    const unitPrice = readAmount(r?.unitPrice, "unitPrice", errors);
+    if (unitPrice === void 0 && !errors.length) errors.push("unitPrice \uAC00 \uC5C6\uB2E4 \u2014 \uC774 \uBB38\uC774 \uBC1B\uB294 \uAC12\uC740 1kWh \uB2F9 \uAC12 \uD558\uB098\uB2E4");
+    const currency = String(r?.currency ?? "").trim();
+    if (!currency) errors.push("currency \uAC00 \uC5C6\uB2E4 \u2014 \uB2E8\uC704 \uC5C6\uB294 \uAC12\uC740 \uB2E4\uB978 \uAE08\uC561\uACFC \uB354\uD560 \uC218 \uC5C6\uB2E4");
+    if (errors.length || !span || unitPrice === void 0) {
+      rejected.push({ record: r, errors });
+      continue;
+    }
+    const data = { from: span.from, to: span.to, unitPrice, currency };
+    accepted.push({
+      eventId: `${opts.tenantId}-generation-price-${++seq}`,
+      eventType: ENERGY_EVENT.generationPrice,
+      eventTime: span.from,
+      tenantId: opts.tenantId,
+      data
+    });
+  }
+  return { accepted, rejected };
+}
 function isEnergyTariffBasisRecord(record) {
   const r = record;
   if (!r || typeof r !== "object") return false;
@@ -10834,6 +10934,7 @@ function retiredVocabularyIn(line) {
   ingest,
   ingestEnergyBillRecords,
   ingestEnergyEquipmentRecords,
+  ingestEnergyGenerationPriceRecords,
   ingestEnergyGenerationRecords,
   ingestEnergyRecords,
   ingestEnergyTariffBasisRecords,
@@ -10844,6 +10945,7 @@ function retiredVocabularyIn(line) {
   isElectricalLocationType,
   isEnergyBillRecord,
   isEnergyEquipmentRecord,
+  isEnergyGenerationPriceRecord,
   isEnergyGenerationRecord,
   isEnergyRecord,
   isEnergyTariffBasisRecord,

package/package.json

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