@operato/twin-kernel 0.7.2 → 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-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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operato/twin-kernel",
-  "version": "0.7.2",
+  "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": {