@operato/twin-kernel 0.7.8 → 0.7.9

package/dist/energy-attribution.d.ts

@@ -171,6 +171,20 @@ export declare function energyIntensity(input: IntensityInput): IntensityResult;
 export interface WindowedEnergy {
     /** 그 범위의 전력량 — 셀 수 있는 구간이 하나도 없으면 `undefined`(0 이 아니다). */
     kWh?: number;
+    /**
+     * 그 범위의 **최대수요** — 구간 최대부하 중 가장 큰 값. 요금이 걸리는 수다.
+     *
+     * ── 왜 여기서 내나 (2026-08-17) ──────────────────────────────────────────
+     * 「이 범위」를 정하는 규칙(걸친 구간은 세지 않는다)이 이미 여기 있다. 최대수요를 소비처에서 따로
+     * 세면 그 경계 규칙이 두 벌이 되고, 전력량과 최대수요가 **서로 다른 구간 집합**을 말하게 된다 —
+     * 같은 창을 두고 두 수가 어긋나면 어느 쪽도 못 믿는다.
+     *
+     * 평균부하(`meanKW`)로 대신하지 않는다. 15분 평균 400kW 인 구간의 최대가 900kW 일 수 있고,
+     * 계약을 넘겼는지는 **최대**가 답한다. 구간이 최대를 싣고 오지 않으면 이 값은 없다(짐작하지 않는다).
+     */
+    peakKW?: number;
+    /** 그 최대수요가 난 구간의 시작 — 「언제였나」를 물으면 답할 수 있어야 한다. */
+    peakStartMs?: number;
     /**
      * 어떻게 얻었나 — **파생임을 숨기지 않는다.**
      *  · `mean-kw` — 구간 평균부하 × 구간 길이. 표본의 평균이므로 **추정**이다.
@@ -202,6 +216,7 @@ export declare function energyOfWindows(windows: readonly {
     startMs: number;
     endMs: number;
     meanKW?: number;
+    maxKW?: number;
 }[], range?: {
     startMs: number;
     endMs: number;

package/dist/energy-attribution.js

@@ -203,9 +203,20 @@ export function energyOfWindows(windows, range) {
     let skipped = 0;
     let first;
     let last;
+    let peakKW;
+    let peakStartMs;
     for (const w of windows ?? []) {
         if (!inRange(w))
             continue;
+        /*
+         * 최대수요는 전력량과 **따로 센다.** 평균을 못 읽어 전력량에서 빠진 구간도 최대는 실려 올 수
+         * 있고(그 반대도 있다), 하나가 없다고 다른 하나를 버리면 있는 사실을 잃는다.
+         */
+        const max = Number(w.maxKW);
+        if (Number.isFinite(max) && (peakKW === undefined || max > peakKW)) {
+            peakKW = max;
+            peakStartMs = Number(w.startMs);
+        }
         const mean = Number(w.meanKW);
         const hours = (Number(w.endMs) - Number(w.startMs)) / 3_600_000;
         if (!Number.isFinite(mean) || !Number.isFinite(hours) || hours <= 0) {
@@ -221,6 +232,7 @@ export function energyOfWindows(windows, range) {
     }
     return {
         ...(counted > 0 ? { kWh } : {}),
+        ...(peakKW !== undefined ? { peakKW, peakStartMs } : {}),
         basis: 'mean-kw',
         counted,
         skipped,

package/dist-cjs/index.cjs

@@ -6339,8 +6339,15 @@ function energyOfWindows(windows, range) {
   let skipped = 0;
   let first;
   let last;
+  let peakKW;
+  let peakStartMs;
   for (const w of windows ?? []) {
     if (!inRange(w)) continue;
+    const max = Number(w.maxKW);
+    if (Number.isFinite(max) && (peakKW === void 0 || max > peakKW)) {
+      peakKW = max;
+      peakStartMs = Number(w.startMs);
+    }
     const mean = Number(w.meanKW);
     const hours = (Number(w.endMs) - Number(w.startMs)) / 36e5;
     if (!Number.isFinite(mean) || !Number.isFinite(hours) || hours <= 0) {
@@ -6354,6 +6361,7 @@ function energyOfWindows(windows, range) {
   }
   return {
     ...counted > 0 ? { kWh } : {},
+    ...peakKW !== void 0 ? { peakKW, peakStartMs } : {},
     basis: "mean-kw",
     counted,
     skipped,

package/package.json

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