@operato/twin-kernel 0.7.72 → 0.7.74

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;
@@ -2520,6 +2528,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.js

@@ -603,6 +603,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;

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

@@ -29,7 +29,19 @@ export function isEnergyRecord(record) {
     const r = record;
     /* 계량 지점이 있고 EPCIS 어휘가 없으면 에너지다. `epc` 가 함께 있으면 둘 중 무엇인지 알 수 없으므로
        에너지로 받지 않는다 — 그 판단은 커넥터가 명확히 해야 한다. */
-    return typeof r.meterId === 'string' && r.meterId.trim().length > 0 && r.epc === undefined;
+    if (!(typeof r.meterId === 'string' && r.meterId.trim().length > 0 && r.epc === undefined))
+        return false;
+    /*
+     * ── **마감된 구간은 계량 표본이 아니다** (2026-08-29) ──────────────────────
+     *
+     * 둘 다 `meterId` 를 가지므로 이 판별이 겹쳤다. 겹친 채로 두면 갈림의 **순서**가 값을 정한다 —
+     * 순서를 잘못 두면 시간별 사용량이 계량 문으로 가고, 그 문은 `kWh` 를 적산 레지스터로 읽는다.
+     * 우리가 넣는 값은 이미 그 구간의 양이므로 **차분의 차분**이 된다.
+     *
+     * 가장 나쁜 모양이다: **거부되지 않고 값만 틀린다.** 그래서 순서에 기대지 않고 배타로 만든다
+     * (설비 상태와 발전 적산을 가를 때와 같은 규율).
+     */
+    return r.from === undefined && r.to === undefined;
 }
 /**
  * 표본 레코드들을 봉투로 — 유효한 것만 통과하고 나머지는 이유와 함께 남는다.
@@ -168,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);
@@ -176,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('바꿀 상태가 하나도 없다 — 값 없는 보고는 사실로 적을 것이 없다');
         }
@@ -195,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"]
   },
@@ -8178,6 +8178,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);
@@ -9531,7 +9535,8 @@ var TwinRuntime = class {
 function isEnergyRecord(record) {
   if (!record || typeof record !== "object") return false;
   const r = record;
-  return typeof r.meterId === "string" && r.meterId.trim().length > 0 && r.epc === void 0;
+  if (!(typeof r.meterId === "string" && r.meterId.trim().length > 0 && r.epc === void 0)) return false;
+  return r.from === void 0 && r.to === void 0;
 }
 function ingestEnergyRecords(records, opts) {
   const arr = Array.isArray(records) ? records : records ? [records] : [];
@@ -9629,13 +9634,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");
     }
@@ -9654,7 +9691,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.72",
+  "version": "0.7.74",
   "type": "module",
   "description": "Twin Domain Kernel — framework-agnostic, zero-dep (domain + sim + 3-channel contract). WMS/YMS/MES, EPCIS 2.0 · ISA-95.",
   "publishConfig": {