@operato/twin-kernel 0.7.1 → 0.7.3

package/dist/capability.d.ts

@@ -1,4 +1,4 @@
-export type CapabilityKey = 'operable' | 'storable' | 'mobile' | 'processable' | 'trackable' | 'metered' | 'curtailable' | 'generating' | 'storing';
+export type CapabilityKey = 'operable' | 'storable' | 'mobile' | 'processable' | 'trackable' | 'switching' | 'metered' | 'curtailable' | 'generating' | 'storing';
 /** 이동 관측 — Mobile 이 노출. */
 export interface Motion {
     fromNode: string;
@@ -58,6 +58,15 @@ export interface StoringState {
     chargeKW?: number;
     dischargeKW?: number;
 }
+/**
+ * 개폐 위치 — IEC 61850 `XCBR.Pos`·`XSWI.Pos` 의 넷 값을 그대로 쓴다.
+ *
+ * `intermediate`(과도)와 `bad`(위치 불량)를 **뭉개지 않는다**: 실 계통에서 이 둘은 이중 접점이 서로
+ * 다른 말을 하는 상태이고, 「열림/닫힘」으로 반올림하면 트윈이 없는 확신을 갖는다.
+ */
+export interface SwitchingState {
+    position?: 'open' | 'closed' | 'intermediate' | 'bad';
+}
 /** 능력 관측 계약 메타(발견·검증). ops 없음(원칙 ①). */
 export interface CapabilitySpec {
     key: CapabilityKey;

package/dist/capability.js

@@ -33,6 +33,22 @@ export const CAPABILITIES = {
         key: 'processable', label: 'twin.capability.processable', semantics: '변환/가공 수행 — 산출(양품/불량). 운영 status 는 Operable 조합. progress 방출은 후속.',
         stateFields: ['output'], results: ['completed']
     },
+    /*
+     * ── 「위치를 읽는다」 ≠ 「조작할 수 있다」 (2026-08-14) ─────────────────────
+     * 차단기는 이 둘이 갈리는 자리다. 상태를 읽어 계통 구성을 알지만 **우리는 조작하지 않는다**
+     * (안전 계통은 범위 밖: profiles/ems.md §1). 그런데 능력을 `operable` 로 주면 저작면이 그 설비에
+     * **제어 컴포넌트를 권한다** — 화면이 우리가 하지 않기로 한 것을 하라고 부추긴다.
+     *
+     * 그래서 개폐 기기의 관측을 따로 세운다. 이름을 `observable` 로 하지 않은 이유: 그러면 상태 필드가
+     * `status` 여야 하고 그건 `operable` 의 것이다(원칙 ② 직교). 없는 필드를 지어내는 대신 **표준이 주는
+     * 이름**을 쓴다 — 개폐 기기의 관측은 `Pos`(위치)다.
+     *
+     * `operable` 은 그대로 「명령을 받는 능동 자원」의 자리로 남는다.
+     */
+    switching: {
+        key: 'switching', label: 'twin.capability.switching', semantics: '회로를 열고 닫는 기기의 **위치를 읽는다** — 우리는 조작하지 않는다(명령 없음). IEC 61850 XCBR/XSWI Pos.',
+        stateFields: ['position'], models: ['SwitchingState'], results: ['positionChanged']
+    },
     trackable: {
         key: 'trackable', label: 'twin.capability.trackable', semantics: '오더/아이템 생애 추적 — 생애단계(도메인 라벨, 무방언)·진행·보류.',
         stateFields: ['lifecycle', 'progress', 'held'], results: ['lifecycleChanged']
@@ -60,7 +76,7 @@ export const CAPABILITIES = {
         stateFields: ['soc', 'chargeKW', 'dischargeKW'], models: ['StoringState'], invariants: ['0 <= soc <= 100'], results: ['stored', 'discharged']
     }
 };
-export const CAPABILITY_KEYS = ['operable', 'storable', 'mobile', 'processable', 'trackable', 'metered', 'curtailable', 'generating', 'storing'];
+export const CAPABILITY_KEYS = ['operable', 'storable', 'mobile', 'processable', 'trackable', 'switching', 'metered', 'curtailable', 'generating', 'storing'];
 /** 능력 집합이 관측 노출하는 상태 필드 합집합(직교이므로 단순 병합). */
 export function stateFieldsOf(caps) {
     const out = new Set();

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/ems-profile.js

@@ -69,11 +69,15 @@ export const EMS_TYPES = [
         label: 'twin.type.breaker',
         /*
          * 차단기 — IEC 61850 `XCBR`. **우리는 이것을 조작하지 않는다**(안전 계통은 범위 밖: ems.md §1).
-         * 상태를 읽어 계통 구성을 알 뿐이다 — 그래서 능력은 `operable` 만이고 `curtailable` 이 아니다.
+         * 상태를 읽어 계통 구성을 알 뿐이다.
+         *
+         * 능력은 `switching` 이다 — `operable` 이 아니다(2026-08-14). `operable` 이던 동안 저작면이 차단기에
+         * **제어 컴포넌트**를 권했다: 우리가 하지 않기로 한 조작을 화면이 부추긴 것이다. 「위치를 읽는다」와
+         * 「명령을 받는다」는 다른 능력이고, 이제 그 둘이 갈려 있다(capability.ts 주석).
          */
         standardClass: { iec61850: 'XCBR', iso55000: 'Asset' },
         identity: { scheme: 'kernel:id' },
-        capabilities: ['operable']
+        capabilities: ['switching']
     },
     {
         key: 'pv-array',

package/dist-cjs/index.cjs

@@ -1665,11 +1665,15 @@ var EMS_TYPES = [
     label: "twin.type.breaker",
     /*
      * 차단기 — IEC 61850 `XCBR`. **우리는 이것을 조작하지 않는다**(안전 계통은 범위 밖: ems.md §1).
-     * 상태를 읽어 계통 구성을 알 뿐이다 — 그래서 능력은 `operable` 만이고 `curtailable` 이 아니다.
+     * 상태를 읽어 계통 구성을 알 뿐이다.
+     *
+     * 능력은 `switching` 이다 — `operable` 이 아니다(2026-08-14). `operable` 이던 동안 저작면이 차단기에
+     * **제어 컴포넌트**를 권했다: 우리가 하지 않기로 한 조작을 화면이 부추긴 것이다. 「위치를 읽는다」와
+     * 「명령을 받는다」는 다른 능력이고, 이제 그 둘이 갈려 있다(capability.ts 주석).
      */
     standardClass: { iec61850: "XCBR", iso55000: "Asset" },
     identity: { scheme: "kernel:id" },
-    capabilities: ["operable"]
+    capabilities: ["switching"]
   },
   {
     key: "pv-array",
@@ -1760,6 +1764,26 @@ var CAPABILITIES = {
     stateFields: ["output"],
     results: ["completed"]
   },
+  /*
+   * ── 「위치를 읽는다」 ≠ 「조작할 수 있다」 (2026-08-14) ─────────────────────
+   * 차단기는 이 둘이 갈리는 자리다. 상태를 읽어 계통 구성을 알지만 **우리는 조작하지 않는다**
+   * (안전 계통은 범위 밖: profiles/ems.md §1). 그런데 능력을 `operable` 로 주면 저작면이 그 설비에
+   * **제어 컴포넌트를 권한다** — 화면이 우리가 하지 않기로 한 것을 하라고 부추긴다.
+   *
+   * 그래서 개폐 기기의 관측을 따로 세운다. 이름을 `observable` 로 하지 않은 이유: 그러면 상태 필드가
+   * `status` 여야 하고 그건 `operable` 의 것이다(원칙 ② 직교). 없는 필드를 지어내는 대신 **표준이 주는
+   * 이름**을 쓴다 — 개폐 기기의 관측은 `Pos`(위치)다.
+   *
+   * `operable` 은 그대로 「명령을 받는 능동 자원」의 자리로 남는다.
+   */
+  switching: {
+    key: "switching",
+    label: "twin.capability.switching",
+    semantics: "\uD68C\uB85C\uB97C \uC5F4\uACE0 \uB2EB\uB294 \uAE30\uAE30\uC758 **\uC704\uCE58\uB97C \uC77D\uB294\uB2E4** \u2014 \uC6B0\uB9AC\uB294 \uC870\uC791\uD558\uC9C0 \uC54A\uB294\uB2E4(\uBA85\uB839 \uC5C6\uC74C). IEC 61850 XCBR/XSWI Pos.",
+    stateFields: ["position"],
+    models: ["SwitchingState"],
+    results: ["positionChanged"]
+  },
   trackable: {
     key: "trackable",
     label: "twin.capability.trackable",
@@ -1808,7 +1832,7 @@ var CAPABILITIES = {
     results: ["stored", "discharged"]
   }
 };
-var CAPABILITY_KEYS = ["operable", "storable", "mobile", "processable", "trackable", "metered", "curtailable", "generating", "storing"];
+var CAPABILITY_KEYS = ["operable", "storable", "mobile", "processable", "trackable", "switching", "metered", "curtailable", "generating", "storing"];
 function stateFieldsOf(caps) {
   const out = /* @__PURE__ */ new Set();
   for (const c of caps) for (const f of CAPABILITIES[c]?.stateFields ?? []) out.add(f);
@@ -5628,6 +5652,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 +5724,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.3",
   "type": "module",
   "description": "Twin Domain Kernel — framework-agnostic, zero-dep (domain + sim + 3-channel contract). WMS/YMS/MES, EPCIS 2.0 · ISA-95.",
   "publishConfig": {