@operato/twin-kernel 0.7.1 → 0.7.2

package/dist/ems-kernel.d.ts

@@ -39,6 +39,14 @@ export declare class EmsKernel extends FlowEngine {
      * (기본값을 지어내면 그 뒤 모든 판정이 거짓 위에 선다).
      */
     private declaredContractKW;
+    /**
+     * **뿌리 계량기** — 조상 중에 계량된 자리가 없는 계량 지점들.
+     *
+     * 계층 계량(수전 ⊃ 분기)에서 전부 더하면 이중 계상이 된다. 뿌리만 더하면 현장의 실제 부하가 된다.
+     * 모델이 그 계량기의 자리를 모르면 뿌리로 본다(모르는 것을 빼면 부하가 조용히 작아진다 — 그것이
+     * 「계약 안쪽」이라는 더 위험한 거짓을 만든다).
+     */
+    private rootMeterIds;
     /**
      * 계측 표본을 받는다 — 에너지 사건만 가로채고 나머지는 그대로 상위에 넘긴다.
      *

package/dist/ems-kernel.js

@@ -93,6 +93,51 @@ export class EmsKernel extends FlowEngine {
         }
         return max;
     }
+    /**
+     * **뿌리 계량기** — 조상 중에 계량된 자리가 없는 계량 지점들.
+     *
+     * 계층 계량(수전 ⊃ 분기)에서 전부 더하면 이중 계상이 된다. 뿌리만 더하면 현장의 실제 부하가 된다.
+     * 모델이 그 계량기의 자리를 모르면 뿌리로 본다(모르는 것을 빼면 부하가 조용히 작아진다 — 그것이
+     * 「계약 안쪽」이라는 더 위험한 거짓을 만든다).
+     */
+    rootMeterIds() {
+        const locOf = new Map();
+        for (const e of this.boardDef?.equipment ?? [])
+            locOf.set(e.id, e.homeLocation);
+        const parentOf = new Map();
+        for (const l of this.boardDef?.locations ?? [])
+            parentOf.set(l.id, l.parentId);
+        /* 계량되고 있는 자리들 — 표본이 실제로 온 계량기의 자리만 센다(선언만 있고 값이 없는 계량기는
+           부하에 기여하지 않으므로 계층 판정에서도 제외한다). */
+        const meteredLocs = new Set();
+        for (const id of this.points.keys()) {
+            const loc = locOf.get(id);
+            if (loc)
+                meteredLocs.add(loc);
+        }
+        const out = new Set();
+        for (const id of this.points.keys()) {
+            const loc = locOf.get(id);
+            if (!loc) {
+                out.add(id);
+                continue;
+            } // 자리를 모르면 뿌리로 본다
+            let cur = parentOf.get(loc);
+            let root = true;
+            const seen = new Set([loc]);
+            while (cur && !seen.has(cur)) {
+                if (meteredLocs.has(cur)) {
+                    root = false;
+                    break;
+                }
+                seen.add(cur);
+                cur = parentOf.get(cur);
+            }
+            if (root)
+                out.add(id);
+        }
+        return out;
+    }
     /**
      * 계측 표본을 받는다 — 에너지 사건만 가로채고 나머지는 그대로 상위에 넘긴다.
      *
@@ -138,12 +183,21 @@ export class EmsKernel extends FlowEngine {
         const w = this.open;
         if (kW !== undefined) {
             /*
-             * 구간의 부하는 **지점의 합**이다(수전 하나만 계량하는 현장도, 피더를 여럿 계량하는 현장도 있다).
-             * 마지막으로 관측된 값들을 더한다 — 표본 주기가 지점마다 달라도 이것이 그 순간의 최선이다.
-             * 지점 하나가 침묵하면 그 값은 낡은 채로 더해진다: 그래서 `atMs` 를 지점마다 남겨 소비처가
-             * 「이 지점은 3시간째 조용하다」를 볼 수 있게 한다.
+             * ── 구간의 부하는 **뿌리 계량기의 합**이다 (2026-08-14 실측으로 고침) ────────
+             *
+             * 처음에는 「지점의 합」이라고만 했다. 그런데 실제 현장은 **계층 계량**이다: 수전 계량기가 공장
+             * 전체를 재고, 분기 계량기가 그 안의 라인을 나눠 잰다. 둘을 다 더하면 **이중 계상**이 되고,
+             * 목 데이터로 재 보니 실제 3,855kW 인 현장이 7,414kW 로 읽혀 **계약(4,000kW)을 넘었다는 거짓
+             * 판정**이 나왔다. 요금은 수전 지점에서 매겨지므로 그 값이 사실이다.
+             *
+             * 그래서 **뿌리만 더한다**: 자기 자리의 조상 중에 계량된 자리가 없는 계량기가 뿌리다. 수전만
+             * 계량하는 현장은 그것 하나, 분기만 계량하는 현장은 분기들의 합, 둘 다 계량하면 수전 하나.
+             *
+             * 모델이 그 계량기를 모르면(설비 선언에 없다) 뿌리로 본다 — 모르는 것을 빼면 그만큼 부하가
+             * 조용히 작아지고, 작아진 부하는 「계약 안쪽」이라는 더 위험한 거짓을 만든다.
              */
-            const total = [...this.points.values()].reduce((sum, p) => sum + (p.kW ?? 0), 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 === undefined || total > w.maxKW)
                 w.maxKW = total;
             w.samples++;

package/dist-cjs/index.cjs

@@ -5628,6 +5628,45 @@ var EmsKernel = class extends FlowEngine {
     }
     return max;
   }
+  /**
+   * **뿌리 계량기** — 조상 중에 계량된 자리가 없는 계량 지점들.
+   *
+   * 계층 계량(수전 ⊃ 분기)에서 전부 더하면 이중 계상이 된다. 뿌리만 더하면 현장의 실제 부하가 된다.
+   * 모델이 그 계량기의 자리를 모르면 뿌리로 본다(모르는 것을 빼면 부하가 조용히 작아진다 — 그것이
+   * 「계약 안쪽」이라는 더 위험한 거짓을 만든다).
+   */
+  rootMeterIds() {
+    const locOf = /* @__PURE__ */ new Map();
+    for (const e of this.boardDef?.equipment ?? []) locOf.set(e.id, e.homeLocation);
+    const parentOf = /* @__PURE__ */ new Map();
+    for (const l of this.boardDef?.locations ?? []) parentOf.set(l.id, l.parentId);
+    const meteredLocs = /* @__PURE__ */ new Set();
+    for (const id of this.points.keys()) {
+      const loc = locOf.get(id);
+      if (loc) meteredLocs.add(loc);
+    }
+    const out = /* @__PURE__ */ new Set();
+    for (const id of this.points.keys()) {
+      const loc = locOf.get(id);
+      if (!loc) {
+        out.add(id);
+        continue;
+      }
+      let cur = parentOf.get(loc);
+      let root = true;
+      const seen = /* @__PURE__ */ new Set([loc]);
+      while (cur && !seen.has(cur)) {
+        if (meteredLocs.has(cur)) {
+          root = false;
+          break;
+        }
+        seen.add(cur);
+        cur = parentOf.get(cur);
+      }
+      if (root) out.add(id);
+    }
+    return out;
+  }
   /**
    * 계측 표본을 받는다 — 에너지 사건만 가로채고 나머지는 그대로 상위에 넘긴다.
    *
@@ -5661,7 +5700,8 @@ var EmsKernel = class extends FlowEngine {
     this.points.set(id, point);
     const w = this.open;
     if (kW !== void 0) {
-      const total = [...this.points.values()].reduce((sum, p) => sum + (p.kW ?? 0), 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;
       w.samples++;
       w.meanKW = w.meanKW === void 0 ? total : (w.meanKW * (w.samples - 1) + total) / w.samples;

package/package.json

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