@operato/twin-kernel 0.7.20 → 0.7.21

package/dist/contract.d.ts

@@ -1237,6 +1237,17 @@ export interface MeterPointState {
 export interface DemandWindowState {
     startMs: number;
     endMs: number;
+    /**
+     * 이 구간의 **최대가 찍힌 순간**의 지점별 kW — 요금이 걸린 수는 kW 다.
+     *
+     * 나중에 계산할 수 없다: 커널은 표본을 보관하지 않으므로 그 순간이 지나면 각 지점이 얼마였는지 알 길이
+     * 없다. 그래서 최대가 갱신되는 순간에 찍어 둔다. 「어느 분기를 깎아야 피크가 내려가나」의 유일한 근거다
+     * (전력량이 큰 분기와 피크를 만든 분기는 다를 수 있다).
+     */
+    pointsAtPeak?: {
+        id: string;
+        kW: number;
+    }[];
     /**
      * 그 구간의 최대 순간부하 — 표본이 없으면 `undefined`(0 이 아니다).
      *

package/dist/ems-kernel.js

@@ -300,8 +300,25 @@ export class EmsKernel extends FlowEngine {
              */
             const roots = this.rootMeterIds();
             const total = [...this.points.values()].reduce((sum, p) => sum + (roots.has(p.id) ? p.kW ?? 0 : 0), 0);
-            if (w.maxKW === undefined || total > w.maxKW)
+            if (w.maxKW === undefined || total > w.maxKW) {
                 w.maxKW = total;
+                /*
+                 * ── 피크가 갱신된 **그 순간**의 지점별 kW 를 붙잡는다 (2026-08-18) ─────────
+                 *
+                 * 요금이 매겨지는 수는 kW(최대수요)이고 전력량(kWh)이 아니다. 그런데 지점별로 남기던 것은
+                 * 구간 전력량뿐이라, 「어느 분기를 깎아야 피크가 내려가나」에 답할 수 없었다 — 전력량이 큰 분기가
+                 * 피크를 만든 분기와 다를 수 있다(하루 종일 조금씩 쓰는 부하 vs 잠깐 크게 쓰는 부하).
+                 *
+                 * 나중에 계산할 수 없는 값이다: 표본을 보관하지 않으므로 그 순간이 지나면 각 지점이 얼마였는지
+                 * 알 길이 없다. 그래서 **갱신되는 순간에** 찍는다.
+                 *
+                 * 뿌리만이 아니라 **모든 지점**을 찍는다: 뿌리 합이 피크를 만들지만, 그 피크를 누가 만들었는지는
+                 * 하위 계량이 답한다. kW 를 모르는 지점은 넣지 않는다(0 으로 만들지 않는다).
+                 */
+                w.pointsAtPeak = [...this.points.values()]
+                    .filter(p => Number.isFinite(Number(p.kW)))
+                    .map(p => ({ id: p.id, kW: Number(p.kW) }));
+            }
             w.samples++;
             w.meanKW = (w.meanKW === undefined ? total : (w.meanKW * (w.samples - 1) + total) / w.samples);
         }
@@ -387,6 +404,11 @@ export class EmsKernel extends FlowEngine {
                  * `root` 는 계층 판정을 우리가 말해 주는 것이다 — 소비처가 같은 규칙을 다시 쓰면 갈라진다.
                  */
                 ...(pointShares.length ? { points: pointShares } : {}),
+                /*
+                 * 피크 순간의 지점별 kW — 요금이 걸린 수는 kW 다. 이것이 없으면 저널을 읽는 쪽은 「어느 분기를
+                 * 깎아야 피크가 내려가나」에 답할 수 없다(전력량이 큰 분기와 피크를 만든 분기는 다를 수 있다).
+                 */
+                ...(w.pointsAtPeak?.length ? { pointsAtPeak: w.pointsAtPeak } : {}),
                 /*
                  * **만든 값이면 그렇게 말한다.** 상태에만 표시하고 사실에는 빠뜨리면, 저널을 읽는 쪽
                  * (성과·이력·보고서)이 시뮬레이션의 수를 계측으로 읽는다 — 값이 그럴듯할수록 위험하다.

package/dist-cjs/index.cjs

@@ -6184,7 +6184,10 @@ var EmsKernel = class extends FlowEngine {
     if (kW !== void 0) {
       const roots = this.rootMeterIds();
       const total = [...this.points.values()].reduce((sum, p) => sum + (roots.has(p.id) ? p.kW ?? 0 : 0), 0);
-      if (w.maxKW === void 0 || total > w.maxKW) w.maxKW = total;
+      if (w.maxKW === void 0 || total > w.maxKW) {
+        w.maxKW = total;
+        w.pointsAtPeak = [...this.points.values()].filter((p) => Number.isFinite(Number(p.kW))).map((p) => ({ id: p.id, kW: Number(p.kW) }));
+      }
       w.samples++;
       w.meanKW = w.meanKW === void 0 ? total : (w.meanKW * (w.samples - 1) + total) / w.samples;
     }
@@ -6262,6 +6265,11 @@ var EmsKernel = class extends FlowEngine {
          * `root` 는 계층 판정을 우리가 말해 주는 것이다 — 소비처가 같은 규칙을 다시 쓰면 갈라진다.
          */
         ...pointShares.length ? { points: pointShares } : {},
+        /*
+         * 피크 순간의 지점별 kW — 요금이 걸린 수는 kW 다. 이것이 없으면 저널을 읽는 쪽은 「어느 분기를
+         * 깎아야 피크가 내려가나」에 답할 수 없다(전력량이 큰 분기와 피크를 만든 분기는 다를 수 있다).
+         */
+        ...w.pointsAtPeak?.length ? { pointsAtPeak: w.pointsAtPeak } : {},
         /*
          * **만든 값이면 그렇게 말한다.** 상태에만 표시하고 사실에는 빠뜨리면, 저널을 읽는 쪽
          * (성과·이력·보고서)이 시뮬레이션의 수를 계측으로 읽는다 — 값이 그럴듯할수록 위험하다.

package/package.json

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