@operato/twin-kernel 0.7.73 → 0.7.75

package/dist/capability.d.ts

@@ -47,8 +47,19 @@ export interface CurtailableState {
     curtailable: boolean;
     minKW?: number;
 }
+/**
+ * 전기 계측 — 전압(V)·전류(A). 전기를 만들거나 쓰는 어떤 설비에서나 같은 모양이다.
+ *
+ * 발전·저장·개폐 어느 능력에나 붙을 수 있어 따로 둔다. 상별 값은 배열이다(단상이면 원소 하나).
+ */
+export interface ElectricalMeasurementState {
+    dcVoltage?: number;
+    dcCurrent?: number;
+    acVoltage?: number[];
+    acCurrent?: number[];
+}
 /** 발전 — 만든다. 역송(`exportKW`)은 소비의 음수가 아니라 별개 사실이다. */
-export interface GeneratingState {
+export interface GeneratingState extends ElectricalMeasurementState {
     generatedKW?: number;
     exportKW?: number;
     generatedKWh?: number;

package/dist/capability.js

@@ -86,7 +86,7 @@ export const CAPABILITIES = {
          * 계량 능력(`metered`)이 `kW` 와 `kWh` 를 함께 선언한 것과 같은 짝이다. 적산은 발전 설비의 보편적
          * 사실이고(태양광·열병합·디젤), 그것이 없으면 성능비·발전시간 같은 성과를 아무도 셀 수 없다.
          */
-        stateFields: ['generatedKW', 'exportKW', 'generatedKWh', 'generatedKWhResetAt', 'generatedKWhSince', 'generatedKWhBasis', 'generatedKWhAccumulation', 'generatedKWhLastPeriod', 'generatedKWhLastPeriodEnd', 'generatedKWhLastPeriodObservedFrom', 'generatedKWhLastPeriodObservedTo'], models: ['GeneratingState'], results: ['generated']
+        stateFields: ['generatedKW', 'exportKW', 'generatedKWh', 'generatedKWhResetAt', 'generatedKWhSince', 'generatedKWhBasis', 'generatedKWhAccumulation', 'generatedKWhLastPeriod', 'generatedKWhLastPeriodEnd', 'generatedKWhLastPeriodObservedFrom', 'generatedKWhLastPeriodObservedTo', 'dcVoltage', 'dcCurrent', 'acVoltage', 'acCurrent'], models: ['GeneratingState'], results: ['generated']
     },
     /*
      * ── 왜 `storing` 이 아니라 `energyStoring` 인가 (2026-08-15) ────────────────

package/dist/contract.d.ts

@@ -1444,6 +1444,14 @@ export interface EquipmentState extends EffectivePeriod {
      */
     generatedKWhLastPeriodObservedFrom?: ISOTime;
     generatedKWhLastPeriodObservedTo?: ISOTime;
+    /**
+     * 전기 계측 — 전압(V)·전류(A). 출력이 0 일 때 **왜 0 인지**를 이 값들이 말한다
+     * (§`EnergyEquipmentData.dcVoltage`).
+     */
+    dcVoltage?: number;
+    dcCurrent?: number;
+    acVoltage?: number[];
+    acCurrent?: number[];
     /** storing — 충전율(%)·충전·방전(kW). 충전과 방전을 나눈다(손실·수명 판단이 그 둘을 구별한다). */
     soc?: number;
     chargeKW?: number;
@@ -2027,6 +2035,18 @@ export interface EnergyState {
      * 틀렸다는 뜻이고, 사람이 찾아내지 않아도 드러나야 한다.
      */
     lastBill?: EnergyBillData;
+    /**
+     * 이 청구 주기의 **최고 수요** — 기본요금이 이 값으로 다시 정해진다.
+     *
+     * `periodStart` 는 마지막 청구서의 끝이다(그 뒤가 아직 청구되지 않은 구간). 그것이 바뀌면 처음부터
+     * 다시 센다 — 지난 주기의 최고가 이번 주기를 정하지 않는다.
+     */
+    demandHigh?: {
+        kW: number;
+        atTo: ISOTime;
+        periodStart?: ISOTime;
+        since: ISOTime;
+    };
     /**
      * 설비마다 **지금 기간의 발전 관측** — 기간 발전량을 확정할 때 쓰는 기준점.
      *
@@ -2520,6 +2540,30 @@ export interface EnergyEquipmentData {
     curtailable?: boolean;
     minKW?: number;
     position?: 'open' | 'closed' | 'intermediate' | 'bad';
+    /**
+     * **전기 계측** — 전압(V)·전류(A). 전기를 만들거나 쓰는 어떤 설비에서나 같은 모양이다
+     * (IEC 61850 의 계측 항목).
+     *
+     * ── 왜 kW 만으로 부족한가 (2026-08-29) ─────────────────────────────────────
+     * 출력이 0 일 때 **왜 0 인지**를 kW 는 말하지 못한다. 전압과 전류가 있으면 값이 답한다.
+     *
+     *   전압 있음 · 전류 0     회로가 끊겼다 (실측: 직류 621.9V · 0A)
+     *   전압 0 · 전류 0       원천이 없다 (밤·차단)
+     *   전압 낮음 · 전류 높음  부하가 무겁거나 계통이 약하다
+     *
+     * ── 직류와 교류를 가른다 ────────────────────────────────────────────────────
+     * 변환기(인버터·정류기)를 낀 설비는 양쪽이 다른 값이고, 어느 쪽이 죽었는지가 곧 어디가 고장인지다.
+     * 한 이름에 담으면 그 구별이 사라진다.
+     *
+     * ── 상별로 받는다 ──────────────────────────────────────────────────────────
+     * 상 불평형은 그 자체로 사실이고, 합치면 되돌릴 수 없다. 단상이면 원소 하나짜리 배열이다.
+     *
+     * **역률은 이 자리에 없다.** 뜻을 확인하지 못한 값을 받으면 화면이 그것을 역률이라고 말한다.
+     */
+    dcVoltage?: number;
+    dcCurrent?: number;
+    acVoltage?: number[];
+    acCurrent?: number[];
 }
 /**
  * 발전 적산으로 담기는 값 — **발전 설비 하나가 지금까지 만든 양.**

package/dist/ems-kernel.d.ts

@@ -199,6 +199,13 @@ export declare class EmsKernel extends FlowEngine {
     private unclosedGenerationPeriods;
     /** 마지막으로 받은 청구서 — 공급자가 확정한 금액. 우리 계산과 견주는 기준이다. */
     private lastBill?;
+    /**
+     * 이 청구 주기의 **최고 수요** — 기본요금이 이 값으로 다시 정해진다.
+     *
+     * `since` 는 이 주기에서 처음 잰 구간의 끝이다. `periodStart` 는 마지막 청구서의 끝이고,
+     * 그것이 바뀌면 처음부터 다시 센다.
+     */
+    private demandHigh?;
     private applyEquipmentEnergy;
     /** 우리 모델이 모르는 설비가 상태를 보내 온 횟수 — 조용히 버리지 않는다. */
     private unknownEquipmentReports;
@@ -242,6 +249,31 @@ export declare class EmsKernel extends FlowEngine {
      * 어려우므로 높게 부르지 않는다(경보가 소음이 되면 사람이 경보 자체를 읽지 않는다).
      */
     protected collectAttentions(): Attention[];
+    /**
+     * **이 주기의 최고가 요금적용전력을 넘었다** — 다음 주기의 기본요금이 오른다.
+     *
+     * ── 왜 계약 초과와 다른 신호인가 (2026-08-29) ────────────────────────────
+     * 계약 초과는 약정 위반이고 지금 조치할 일이다(줄이면 된다). 이쪽은 **이미 일어난 일**이다 —
+     * 넘은 순간 다음 주기의 기준이 정해지고, 지금 줄여도 되돌아가지 않는다. 사람이 할 일이 다르므로
+     * 신호도 다르다.
+     *
+     * ── 한 번만 울린다 ──────────────────────────────────────────────────────────
+     * 넘으면 그 주기 내내 참이다. 구간마다 다시 울리면 소음이 되고, 소음이 되면 아무도 안 본다.
+     * 그래서 신호의 id 를 주기로 묶고 「처음 넘은 시각」이 아니라 **그 주기의 최고**를 싣는다.
+     *
+     * ── 늦게 안다 ───────────────────────────────────────────────────────────────
+     * 최고 수요는 지난 구간이 마감되어야 온다(지금 원본은 시간마다). 그래서 넘은 것을 최대 한 시간
+     * 뒤에 안다. 그 사실을 `observedTo` 로 함께 내어 화면이 「언제까지의 값인가」를 말할 수 있게 한다.
+     */
+    protected billingDemandAttention(): Attention | undefined;
+    /**
+     * 선언된 **요금적용전력** — 기본요금이 걸리는 기준(§`EMS_PROPERTY.billingDemandKW`).
+     *
+     * 청구서가 그 값을 실어 오면 그쪽이 먼저다(§`billingDemandKW()`). 이것은 청구가 오지 않는 현장의 몫이다.
+     */
+    private declaredBillingDemandKW;
+    /** 지금 쓰는 요금적용전력 — **청구서가 먼저다.** 매달 바뀌는 값이라 선언은 곧 낡는다. */
+    private billingDemandKW;
     /** 계약을 선언한 수전 자리 — 주의가 가리킬 대상. 없으면 대상을 지어내지 않는다. */
     private incomingLocationId;
     /** 감축 가능으로 **선언된** 설비 — 커널이 능력을 짐작하지 않는다(타입이 선언한다). */

package/dist/ems-kernel.js

@@ -315,6 +315,26 @@ export class EmsKernel extends FlowEngine {
             point.lastPeriodTo = d.to;
         if (d?.basis)
             point.lastPeriodBasis = d.basis;
+        /*
+         * ── 이 청구 주기의 최고 수요 (2026-08-29) ─────────────────────────────────
+         *
+         * 기본요금은 이 값으로 다시 정해진다. 그래서 **넘은 순간과 얼마나 넘었는지**를 기억한다.
+         *
+         * 주기의 시작은 마지막 청구서의 끝이다(그 뒤가 아직 청구되지 않은 구간이다). 청구서가 없으면
+         * 관측을 시작한 때부터다 — 그 사실은 `since` 가 말한다.
+         *
+         * 구간마다 새로 세지 않는다: 한 번 넘으면 그 주기 내내 참이고, 매 구간 다시 알리면 소음이 된다.
+         */
+        const maxKW = Number(d?.maxKW);
+        if (Number.isFinite(maxKW) && maxKW >= 0 && d?.to) {
+            const periodStart = this.lastBill?.to;
+            /* 청구 주기가 바뀌었으면 처음부터 다시 센다 — 지난 주기의 최고가 이번 주기를 정하지 않는다. */
+            if (this.demandHigh && periodStart && this.demandHigh.periodStart !== periodStart)
+                this.demandHigh = undefined;
+            if (!this.demandHigh || maxKW > this.demandHigh.kW) {
+                this.demandHigh = { kW: maxKW, atTo: String(d.to), periodStart, since: this.demandHigh?.since ?? String(d.to) };
+            }
+        }
         this.revision++;
     }
     /**
@@ -582,6 +602,13 @@ export class EmsKernel extends FlowEngine {
     unclosedGenerationPeriods = 0;
     /** 마지막으로 받은 청구서 — 공급자가 확정한 금액. 우리 계산과 견주는 기준이다. */
     lastBill;
+    /**
+     * 이 청구 주기의 **최고 수요** — 기본요금이 이 값으로 다시 정해진다.
+     *
+     * `since` 는 이 주기에서 처음 잰 구간의 끝이다. `periodStart` 는 마지막 청구서의 끝이고,
+     * 그것이 바뀌면 처음부터 다시 센다.
+     */
+    demandHigh;
     applyEquipmentEnergy(envelope) {
         const d = envelope.data;
         const id = String(d?.equipmentId ?? '').trim();
@@ -603,6 +630,11 @@ export class EmsKernel extends FlowEngine {
         put('curtailable');
         put('minKW');
         put('position');
+        /* 전기 계측 — 「출력이 0인데 왜 0인가」에 값으로 답하는 축(§`EnergyEquipmentData.dcVoltage`). */
+        put('dcVoltage');
+        put('dcCurrent');
+        put('acVoltage');
+        put('acCurrent');
         /* **값과 함께 시각을 남긴다** — 없으면 화면이 멈춘 값을 지금 값으로 그린다(계량 지점과 같은 규율). */
         if (d?.at)
             eq.measuredAt = d.at;
@@ -940,6 +972,9 @@ export class EmsKernel extends FlowEngine {
      */
     collectAttentions() {
         const out = super.collectAttentions();
+        const billingOver = this.billingDemandAttention();
+        if (billingOver)
+            out.push(billingOver);
         const w = this.open;
         if (!w || w.contractKW === undefined || w.meanKW === undefined)
             return out;
@@ -983,6 +1018,77 @@ export class EmsKernel extends FlowEngine {
         });
         return out;
     }
+    /**
+     * **이 주기의 최고가 요금적용전력을 넘었다** — 다음 주기의 기본요금이 오른다.
+     *
+     * ── 왜 계약 초과와 다른 신호인가 (2026-08-29) ────────────────────────────
+     * 계약 초과는 약정 위반이고 지금 조치할 일이다(줄이면 된다). 이쪽은 **이미 일어난 일**이다 —
+     * 넘은 순간 다음 주기의 기준이 정해지고, 지금 줄여도 되돌아가지 않는다. 사람이 할 일이 다르므로
+     * 신호도 다르다.
+     *
+     * ── 한 번만 울린다 ──────────────────────────────────────────────────────────
+     * 넘으면 그 주기 내내 참이다. 구간마다 다시 울리면 소음이 되고, 소음이 되면 아무도 안 본다.
+     * 그래서 신호의 id 를 주기로 묶고 「처음 넘은 시각」이 아니라 **그 주기의 최고**를 싣는다.
+     *
+     * ── 늦게 안다 ───────────────────────────────────────────────────────────────
+     * 최고 수요는 지난 구간이 마감되어야 온다(지금 원본은 시간마다). 그래서 넘은 것을 최대 한 시간
+     * 뒤에 안다. 그 사실을 `observedTo` 로 함께 내어 화면이 「언제까지의 값인가」를 말할 수 있게 한다.
+     */
+    billingDemandAttention() {
+        const high = this.demandHigh;
+        const basis = this.billingDemandKW();
+        if (!high || basis === undefined || high.kW <= basis)
+            return undefined;
+        const over = high.kW - basis;
+        const ratio = over / basis;
+        return {
+            id: `billing-demand-exceeded:${high.periodStart ?? high.since}`,
+            kind: 'billing-demand-exceeded',
+            severity: ratio > 0.15 ? 'high' : 'medium',
+            anchor: { locationId: this.incomingLocationId() },
+            params: {
+                peakKW: Math.round(high.kW),
+                billingDemandKW: Math.round(basis),
+                overKW: Math.round(over),
+                /* 값의 출처 — 청구서가 말한 기준인지 현장의 선언인지. 선언은 곧 낡는다. */
+                basisFrom: Number.isFinite(Number(this.lastBill?.billingDemandKW)) ? 'bill' : 'declaration',
+                observedTo: high.atTo,
+                periodSince: high.since
+            },
+            /*
+             * 조치를 걸지 않는다. **이미 일어난 일이라 되돌릴 수 없다** — 지금 줄여도 이 주기의 최고는
+             * 그대로다. 조치를 붙이면 화면이 「누르면 해결된다」고 거짓말한다.
+             */
+            recommendedActions: []
+        };
+    }
+    /**
+     * 선언된 **요금적용전력** — 기본요금이 걸리는 기준(§`EMS_PROPERTY.billingDemandKW`).
+     *
+     * 청구서가 그 값을 실어 오면 그쪽이 먼저다(§`billingDemandKW()`). 이것은 청구가 오지 않는 현장의 몫이다.
+     */
+    declaredBillingDemandKW() {
+        let max;
+        for (const loc of this.boardDef?.locations ?? []) {
+            for (const p of loc.properties ?? []) {
+                if (p.id !== EMS_PROPERTY.billingDemandKW)
+                    continue;
+                const v = Number(p.value);
+                if (!Number.isFinite(v) || v <= 0)
+                    continue;
+                if (max === undefined || v > max)
+                    max = v;
+            }
+        }
+        return max;
+    }
+    /** 지금 쓰는 요금적용전력 — **청구서가 먼저다.** 매달 바뀌는 값이라 선언은 곧 낡는다. */
+    billingDemandKW() {
+        const billed = Number(this.lastBill?.billingDemandKW);
+        if (Number.isFinite(billed) && billed > 0)
+            return billed;
+        return this.declaredBillingDemandKW();
+    }
     /** 계약을 선언한 수전 자리 — 주의가 가리킬 대상. 없으면 대상을 지어내지 않는다. */
     incomingLocationId() {
         for (const loc of this.boardDef?.locations ?? []) {
@@ -1376,6 +1482,9 @@ export class EmsKernel extends FlowEngine {
         /* 청구서도 이어받는다 — 재기동마다 사라지면 우리 계산과 견줄 기준이 없어진다. */
         if (e.lastBill?.from && e.lastBill?.to)
             this.lastBill = { ...e.lastBill };
+        /* 이 주기의 최고도 이어받는다 — 재기동마다 0 으로 돌아가면 이미 넘은 것을 못 넘었다고 말한다. */
+        if (Number.isFinite(Number(e.demandHigh?.kW)) && e.demandHigh?.since)
+            this.demandHigh = { ...e.demandHigh };
     }
     getSnapshot() {
         const snap = super.getSnapshot();
@@ -1401,6 +1510,7 @@ export class EmsKernel extends FlowEngine {
                 : {}),
             ...(this.unclosedGenerationPeriods ? { unclosedGenerationPeriods: this.unclosedGenerationPeriods } : {}),
             ...(this.lastBill ? { lastBill: { ...this.lastBill } } : {}),
+            ...(this.demandHigh ? { demandHigh: { ...this.demandHigh } } : {}),
             ...(contractKW !== undefined ? { contractKW } : {}),
             /* 물류 흐름 요청을 받은 적이 있나 — 있으면 이 트윈에 엉뚱한 명령이 오고 있다는 사실이다. */
             ...(this.flowRequests.size

package/dist/energy-ingest.d.ts

@@ -49,6 +49,11 @@ export interface EnergyEquipmentRecord {
     curtailable?: boolean;
     minKW?: number;
     position?: string;
+    /** 전기 계측 — 전압(V)·전류(A). 상별 값은 배열로(단상이면 원소 하나). */
+    dcVoltage?: number;
+    dcCurrent?: number;
+    acVoltage?: number[];
+    acCurrent?: number[];
 }
 /** 이 레코드가 설비 에너지 상태인가 — 라우팅 판정을 한 곳에 둔다. */
 export declare function isEnergyEquipmentRecord(record: unknown): boolean;

package/dist/energy-ingest.js

@@ -180,6 +180,49 @@ export function ingestEnergyEquipmentRecords(records, opts) {
             else
                 curtailable = r.curtailable;
         }
+        /*
+         * ── 전기 계측 (2026-08-29) ─────────────────────────────────────────────────
+         *
+         * 음수는 받지 않는다. 전압·전류의 크기는 음수가 되지 않고, 방향은 다른 축이 말한다
+         * (`chargeKW`·`dischargeKW`·`exportKW`). 음수를 받아 두면 화면이 「-380V」를 그린다.
+         *
+         * 상별 값은 **배열 그대로** 받는다. 합치거나 평균 내지 않는다 — 상 불평형은 그 자체로 사실이고,
+         * 한 수로 접으면 되돌릴 수 없다.
+         */
+        const dcVoltage = num(r?.dcVoltage, 'dcVoltage', 0);
+        const dcCurrent = num(r?.dcCurrent, 'dcCurrent', 0);
+        const phases = (raw, name) => {
+            if (raw === undefined || raw === null)
+                return undefined;
+            if (!Array.isArray(raw)) {
+                errors.push(`${name} 가 배열이 아니다 — 상별 값이라 배열로 받는다(단상이면 원소 하나): ${JSON.stringify(raw)}`);
+                return undefined;
+            }
+            if (!raw.length) {
+                errors.push(`${name} 가 빈 배열이다 — 잰 상이 없으면 그 칸을 보내지 않는다`);
+                return undefined;
+            }
+            const out = [];
+            for (const [i, v] of raw.entries()) {
+                const n = Number(v);
+                if (!Number.isFinite(n)) {
+                    errors.push(`${name}[${i}] 를 수로 읽을 수 없다: ${JSON.stringify(v)}`);
+                    return undefined;
+                }
+                if (n < 0) {
+                    errors.push(`${name}[${i}] 가 음수다(${n}) — 크기는 음수가 되지 않는다(방향은 다른 축이 말한다)`);
+                    return undefined;
+                }
+                out.push(n);
+            }
+            return out;
+        };
+        const acVoltage = phases(r?.acVoltage, 'acVoltage');
+        const acCurrent = phases(r?.acCurrent, 'acCurrent');
+        /* 상 수가 다르면 짝이 맞지 않는다 — 어느 상의 전류인지 알 수 없는 값을 받지 않는다. */
+        if (acVoltage && acCurrent && acVoltage.length !== acCurrent.length) {
+            errors.push(`acVoltage(${acVoltage.length}상)와 acCurrent(${acCurrent.length}상)의 상 수가 다르다`);
+        }
         let position;
         if (r?.position !== undefined && r?.position !== null && r?.position !== '') {
             const p = String(r.position);
@@ -188,7 +231,7 @@ export function ingestEnergyEquipmentRecords(records, opts) {
             else
                 position = p;
         }
-        const values = { generatedKW, exportKW, soc, chargeKW, dischargeKW, curtailable, minKW, position };
+        const values = { generatedKW, exportKW, soc, chargeKW, dischargeKW, curtailable, minKW, position, dcVoltage, dcCurrent, acVoltage, acCurrent };
         if (!errors.length && Object.values(values).every(v => v === undefined)) {
             errors.push('바꿀 상태가 하나도 없다 — 값 없는 보고는 사실로 적을 것이 없다');
         }
@@ -207,7 +250,11 @@ export function ingestEnergyEquipmentRecords(records, opts) {
             ...(dischargeKW !== undefined ? { dischargeKW } : {}),
             ...(curtailable !== undefined ? { curtailable } : {}),
             ...(minKW !== undefined ? { minKW } : {}),
-            ...(position !== undefined ? { position } : {})
+            ...(position !== undefined ? { position } : {}),
+            ...(dcVoltage !== undefined ? { dcVoltage } : {}),
+            ...(dcCurrent !== undefined ? { dcCurrent } : {}),
+            ...(acVoltage !== undefined ? { acVoltage } : {}),
+            ...(acCurrent !== undefined ? { acCurrent } : {})
         };
         accepted.push({
             eventId: `${opts.tenantId}-energy-eq-${++seq}`,

package/dist-cjs/index.cjs

@@ -2757,7 +2757,7 @@ var CAPABILITIES = {
      * 계량 능력(`metered`)이 `kW` 와 `kWh` 를 함께 선언한 것과 같은 짝이다. 적산은 발전 설비의 보편적
      * 사실이고(태양광·열병합·디젤), 그것이 없으면 성능비·발전시간 같은 성과를 아무도 셀 수 없다.
      */
-    stateFields: ["generatedKW", "exportKW", "generatedKWh", "generatedKWhResetAt", "generatedKWhSince", "generatedKWhBasis", "generatedKWhAccumulation", "generatedKWhLastPeriod", "generatedKWhLastPeriodEnd", "generatedKWhLastPeriodObservedFrom", "generatedKWhLastPeriodObservedTo"],
+    stateFields: ["generatedKW", "exportKW", "generatedKWh", "generatedKWhResetAt", "generatedKWhSince", "generatedKWhBasis", "generatedKWhAccumulation", "generatedKWhLastPeriod", "generatedKWhLastPeriodEnd", "generatedKWhLastPeriodObservedFrom", "generatedKWhLastPeriodObservedTo", "dcVoltage", "dcCurrent", "acVoltage", "acCurrent"],
     models: ["GeneratingState"],
     results: ["generated"]
   },
@@ -7980,6 +7980,14 @@ var EmsKernel = class extends FlowEngine {
     if (d?.from) point.lastPeriodFrom = d.from;
     if (d?.to) point.lastPeriodTo = d.to;
     if (d?.basis) point.lastPeriodBasis = d.basis;
+    const maxKW = Number(d?.maxKW);
+    if (Number.isFinite(maxKW) && maxKW >= 0 && d?.to) {
+      const periodStart = this.lastBill?.to;
+      if (this.demandHigh && periodStart && this.demandHigh.periodStart !== periodStart) this.demandHigh = void 0;
+      if (!this.demandHigh || maxKW > this.demandHigh.kW) {
+        this.demandHigh = { kW: maxKW, atTo: String(d.to), periodStart, since: this.demandHigh?.since ?? String(d.to) };
+      }
+    }
     this.revision++;
   }
   /**
@@ -8158,6 +8166,13 @@ var EmsKernel = class extends FlowEngine {
   unclosedGenerationPeriods = 0;
   /** 마지막으로 받은 청구서 — 공급자가 확정한 금액. 우리 계산과 견주는 기준이다. */
   lastBill;
+  /**
+   * 이 청구 주기의 **최고 수요** — 기본요금이 이 값으로 다시 정해진다.
+   *
+   * `since` 는 이 주기에서 처음 잰 구간의 끝이다. `periodStart` 는 마지막 청구서의 끝이고,
+   * 그것이 바뀌면 처음부터 다시 센다.
+   */
+  demandHigh;
   applyEquipmentEnergy(envelope) {
     const d = envelope.data;
     const id = String(d?.equipmentId ?? "").trim();
@@ -8178,6 +8193,10 @@ var EmsKernel = class extends FlowEngine {
     put("curtailable");
     put("minKW");
     put("position");
+    put("dcVoltage");
+    put("dcCurrent");
+    put("acVoltage");
+    put("acCurrent");
     if (d?.at) eq.measuredAt = d.at;
     const heardAt = Date.parse(String(d?.at ?? envelope.eventTime ?? ""));
     if (Number.isFinite(heardAt)) this.noteObserved(heardAt);
@@ -8393,6 +8412,8 @@ var EmsKernel = class extends FlowEngine {
    */
   collectAttentions() {
     const out = super.collectAttentions();
+    const billingOver = this.billingDemandAttention();
+    if (billingOver) out.push(billingOver);
     const w = this.open;
     if (!w || w.contractKW === void 0 || w.meanKW === void 0) return out;
     const projected = w.meanKW;
@@ -8431,6 +8452,72 @@ var EmsKernel = class extends FlowEngine {
     });
     return out;
   }
+  /**
+   * **이 주기의 최고가 요금적용전력을 넘었다** — 다음 주기의 기본요금이 오른다.
+   *
+   * ── 왜 계약 초과와 다른 신호인가 (2026-08-29) ────────────────────────────
+   * 계약 초과는 약정 위반이고 지금 조치할 일이다(줄이면 된다). 이쪽은 **이미 일어난 일**이다 —
+   * 넘은 순간 다음 주기의 기준이 정해지고, 지금 줄여도 되돌아가지 않는다. 사람이 할 일이 다르므로
+   * 신호도 다르다.
+   *
+   * ── 한 번만 울린다 ──────────────────────────────────────────────────────────
+   * 넘으면 그 주기 내내 참이다. 구간마다 다시 울리면 소음이 되고, 소음이 되면 아무도 안 본다.
+   * 그래서 신호의 id 를 주기로 묶고 「처음 넘은 시각」이 아니라 **그 주기의 최고**를 싣는다.
+   *
+   * ── 늦게 안다 ───────────────────────────────────────────────────────────────
+   * 최고 수요는 지난 구간이 마감되어야 온다(지금 원본은 시간마다). 그래서 넘은 것을 최대 한 시간
+   * 뒤에 안다. 그 사실을 `observedTo` 로 함께 내어 화면이 「언제까지의 값인가」를 말할 수 있게 한다.
+   */
+  billingDemandAttention() {
+    const high = this.demandHigh;
+    const basis = this.billingDemandKW();
+    if (!high || basis === void 0 || high.kW <= basis) return void 0;
+    const over = high.kW - basis;
+    const ratio = over / basis;
+    return {
+      id: `billing-demand-exceeded:${high.periodStart ?? high.since}`,
+      kind: "billing-demand-exceeded",
+      severity: ratio > 0.15 ? "high" : "medium",
+      anchor: { locationId: this.incomingLocationId() },
+      params: {
+        peakKW: Math.round(high.kW),
+        billingDemandKW: Math.round(basis),
+        overKW: Math.round(over),
+        /* 값의 출처 — 청구서가 말한 기준인지 현장의 선언인지. 선언은 곧 낡는다. */
+        basisFrom: Number.isFinite(Number(this.lastBill?.billingDemandKW)) ? "bill" : "declaration",
+        observedTo: high.atTo,
+        periodSince: high.since
+      },
+      /*
+       * 조치를 걸지 않는다. **이미 일어난 일이라 되돌릴 수 없다** — 지금 줄여도 이 주기의 최고는
+       * 그대로다. 조치를 붙이면 화면이 「누르면 해결된다」고 거짓말한다.
+       */
+      recommendedActions: []
+    };
+  }
+  /**
+   * 선언된 **요금적용전력** — 기본요금이 걸리는 기준(§`EMS_PROPERTY.billingDemandKW`).
+   *
+   * 청구서가 그 값을 실어 오면 그쪽이 먼저다(§`billingDemandKW()`). 이것은 청구가 오지 않는 현장의 몫이다.
+   */
+  declaredBillingDemandKW() {
+    let max;
+    for (const loc of this.boardDef?.locations ?? []) {
+      for (const p of loc.properties ?? []) {
+        if (p.id !== EMS_PROPERTY.billingDemandKW) continue;
+        const v = Number(p.value);
+        if (!Number.isFinite(v) || v <= 0) continue;
+        if (max === void 0 || v > max) max = v;
+      }
+    }
+    return max;
+  }
+  /** 지금 쓰는 요금적용전력 — **청구서가 먼저다.** 매달 바뀌는 값이라 선언은 곧 낡는다. */
+  billingDemandKW() {
+    const billed = Number(this.lastBill?.billingDemandKW);
+    if (Number.isFinite(billed) && billed > 0) return billed;
+    return this.declaredBillingDemandKW();
+  }
   /** 계약을 선언한 수전 자리 — 주의가 가리킬 대상. 없으면 대상을 지어내지 않는다. */
   incomingLocationId() {
     for (const loc of this.boardDef?.locations ?? []) {
@@ -8711,6 +8798,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 (Number.isFinite(Number(e.demandHigh?.kW)) && e.demandHigh?.since) this.demandHigh = { ...e.demandHigh };
   }
   getSnapshot() {
     const snap = super.getSnapshot();
@@ -8732,6 +8820,7 @@ var EmsKernel = class extends FlowEngine {
       } : {},
       ...this.unclosedGenerationPeriods ? { unclosedGenerationPeriods: this.unclosedGenerationPeriods } : {},
       ...this.lastBill ? { lastBill: { ...this.lastBill } } : {},
+      ...this.demandHigh ? { demandHigh: { ...this.demandHigh } } : {},
       ...contractKW !== void 0 ? { contractKW } : {},
       /* 물류 흐름 요청을 받은 적이 있나 — 있으면 이 트윈에 엉뚱한 명령이 오고 있다는 사실이다. */
       ...this.flowRequests.size ? { flowRequests: [...this.flowRequests.entries()].map(([hook, count]) => ({ hook, count })) } : {}
@@ -9630,13 +9719,45 @@ function ingestEnergyEquipmentRecords(records, opts) {
       if (typeof r.curtailable !== "boolean") errors.push(`curtailable \uAC00 \uCC38/\uAC70\uC9D3\uC774 \uC544\uB2C8\uB2E4: ${JSON.stringify(r.curtailable)}`);
       else curtailable = r.curtailable;
     }
+    const dcVoltage = num(r?.dcVoltage, "dcVoltage", 0);
+    const dcCurrent = num(r?.dcCurrent, "dcCurrent", 0);
+    const phases = (raw, name) => {
+      if (raw === void 0 || raw === null) return void 0;
+      if (!Array.isArray(raw)) {
+        errors.push(`${name} \uAC00 \uBC30\uC5F4\uC774 \uC544\uB2C8\uB2E4 \u2014 \uC0C1\uBCC4 \uAC12\uC774\uB77C \uBC30\uC5F4\uB85C \uBC1B\uB294\uB2E4(\uB2E8\uC0C1\uC774\uBA74 \uC6D0\uC18C \uD558\uB098): ${JSON.stringify(raw)}`);
+        return void 0;
+      }
+      if (!raw.length) {
+        errors.push(`${name} \uAC00 \uBE48 \uBC30\uC5F4\uC774\uB2E4 \u2014 \uC7B0 \uC0C1\uC774 \uC5C6\uC73C\uBA74 \uADF8 \uCE78\uC744 \uBCF4\uB0B4\uC9C0 \uC54A\uB294\uB2E4`);
+        return void 0;
+      }
+      const out = [];
+      for (const [i, v] of raw.entries()) {
+        const n = Number(v);
+        if (!Number.isFinite(n)) {
+          errors.push(`${name}[${i}] \uB97C \uC218\uB85C \uC77D\uC744 \uC218 \uC5C6\uB2E4: ${JSON.stringify(v)}`);
+          return void 0;
+        }
+        if (n < 0) {
+          errors.push(`${name}[${i}] \uAC00 \uC74C\uC218\uB2E4(${n}) \u2014 \uD06C\uAE30\uB294 \uC74C\uC218\uAC00 \uB418\uC9C0 \uC54A\uB294\uB2E4(\uBC29\uD5A5\uC740 \uB2E4\uB978 \uCD95\uC774 \uB9D0\uD55C\uB2E4)`);
+          return void 0;
+        }
+        out.push(n);
+      }
+      return out;
+    };
+    const acVoltage = phases(r?.acVoltage, "acVoltage");
+    const acCurrent = phases(r?.acCurrent, "acCurrent");
+    if (acVoltage && acCurrent && acVoltage.length !== acCurrent.length) {
+      errors.push(`acVoltage(${acVoltage.length}\uC0C1)\uC640 acCurrent(${acCurrent.length}\uC0C1)\uC758 \uC0C1 \uC218\uAC00 \uB2E4\uB974\uB2E4`);
+    }
     let position;
     if (r?.position !== void 0 && r?.position !== null && r?.position !== "") {
       const p = String(r.position);
       if (!POSITIONS.has(p)) errors.push(`position \uC774 \uD45C\uC900 \uAC12\uC774 \uC544\uB2C8\uB2E4(open\xB7closed\xB7intermediate\xB7bad): ${JSON.stringify(r.position)}`);
       else position = p;
     }
-    const values = { generatedKW, exportKW, soc, chargeKW, dischargeKW, curtailable, minKW, position };
+    const values = { generatedKW, exportKW, soc, chargeKW, dischargeKW, curtailable, minKW, position, dcVoltage, dcCurrent, acVoltage, acCurrent };
     if (!errors.length && Object.values(values).every((v) => v === void 0)) {
       errors.push("\uBC14\uAFC0 \uC0C1\uD0DC\uAC00 \uD558\uB098\uB3C4 \uC5C6\uB2E4 \u2014 \uAC12 \uC5C6\uB294 \uBCF4\uACE0\uB294 \uC0AC\uC2E4\uB85C \uC801\uC744 \uAC83\uC774 \uC5C6\uB2E4");
     }
@@ -9655,7 +9776,11 @@ function ingestEnergyEquipmentRecords(records, opts) {
       ...dischargeKW !== void 0 ? { dischargeKW } : {},
       ...curtailable !== void 0 ? { curtailable } : {},
       ...minKW !== void 0 ? { minKW } : {},
-      ...position !== void 0 ? { position } : {}
+      ...position !== void 0 ? { position } : {},
+      ...dcVoltage !== void 0 ? { dcVoltage } : {},
+      ...dcCurrent !== void 0 ? { dcCurrent } : {},
+      ...acVoltage !== void 0 ? { acVoltage } : {},
+      ...acCurrent !== void 0 ? { acCurrent } : {}
     };
     accepted.push({
       eventId: `${opts.tenantId}-energy-eq-${++seq}`,

package/package.json

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