@operato/twin-kernel 0.7.7 → 0.7.8

package/dist/capability.d.ts

@@ -1,4 +1,4 @@
-export type CapabilityKey = 'operable' | 'storable' | 'mobile' | 'processable' | 'trackable' | 'switching' | 'metered' | 'curtailable' | 'generating' | 'storing';
+export type CapabilityKey = 'operable' | 'storable' | 'mobile' | 'processable' | 'trackable' | 'switching' | 'metered' | 'curtailable' | 'energyGenerating' | 'energyStoring';
 /** 이동 관측 — Mobile 이 노출. */
 export interface Motion {
     fromNode: string;
@@ -74,6 +74,28 @@ export interface CapabilitySpec {
     semantics: string;
     /** 관측 상태 필드(데이터 형식). 직교 — 어느 필드도 두 능력에 중복 없음(원칙 ②). */
     stateFields: string[];
+    /**
+     * 이 능력을 가진 자원이 **받는 명령** — 나가는 사실(`results`)의 짝.
+     *
+     * ── 계약이 반쪽이었다 (2026-08-15) ────────────────────────────────────────
+     * 능력은 「무슨 값을 내보내는가」만 선언하고 있었다. 그런데 저작면이 알아야 할 것이 하나 더 있다:
+     * 「여기에 제어를 붙여도 되는가」. 적을 자리가 없어서 **능력 이름으로 눈치껏** 판단했다 —
+     * `operable` 이면 제어를 권하고 아니면 안 권했다.
+     *
+     * 차단기에서 그 방식이 막혔다. 상태는 보여주고 싶은데 `operable` 을 주면 화면이 우리가 하지 않기로
+     * 한 조작을 권한다. 그래서 능력을 새로 만들었고(`switching`), 능력은 상태 필드로 정의되므로 새
+     * 필드가 필요했는데 마침 표준이 `position` 이라는 이름을 줘서 됐다 — **그건 운이었다.**
+     *
+     * 없던 것은 참/거짓 하나가 아니라 **대칭**이다: 나가는 것은 선언돼 있고 들어오는 것은 없었다.
+     * 명령 어휘(`CMD`)는 이미 능력별로 묶여 있었지만 그 묶임이 **주석에만** 있었다 — 여기로 옮긴다.
+     *
+     * 비어 있다는 것이 곧 「조작하지 않는다」이다. 「명령을 받나」는 이 목록에서 **파생**된다 —
+     * 그래서 형용사를 새로 만들지 않는다.
+     *
+     * 트윈 수준 명령(`attention.ack`·`resource.add`)은 특정 자원의 능력이 아니므로 여기 넣지 않는다.
+     * 모든 명령이 능력에 속해야 한다는 규칙을 만들면 그것이 다음 땜빵이 된다.
+     */
+    commands: string[];
     /** 교환 데이터 모델 이름. */
     models?: string[];
     /** 불변식(모두 준수·신뢰). */
@@ -85,3 +107,10 @@ export declare const CAPABILITIES: Record<CapabilityKey, CapabilitySpec>;
 export declare const CAPABILITY_KEYS: CapabilityKey[];
 /** 능력 집합이 관측 노출하는 상태 필드 합집합(직교이므로 단순 병합). */
 export declare function stateFieldsOf(caps: CapabilityKey[]): string[];
+/**
+ * 능력 집합이 **받는 명령**의 합집합 — `stateFieldsOf` 의 짝.
+ *
+ * 「이 자원에 제어를 붙여도 되는가」는 이 목록이 비었는지로 **파생**한다. 그래서 `controllable` 같은
+ * 형용사를 따로 두지 않는다 — 형용사를 두면 목록과 형용사가 언젠가 어긋나고, 어긋난 쪽이 화면이 된다.
+ */
+export declare function commandsOf(caps: CapabilityKey[]): string[];

package/dist/capability.js

@@ -19,18 +19,22 @@
 export const CAPABILITIES = {
     operable: {
         key: 'operable', label: 'twin.capability.operable', semantics: '능동 자원의 운영 상태(유휴/가동/고장). status 교차 관심사를 여기 하나로.',
+        commands: ['resource.hold', 'resource.resume', 'resource.down', 'resource.repair', 'resource.reset-metrics'],
         stateFields: ['status'], results: ['statusChanged']
     },
     storable: {
         key: 'storable', label: 'twin.capability.storable', semantics: '아이템을 보유하는 위치 — 점유/용량. (씬 기제: Capacity)',
+        commands: [],
         stateFields: ['occupancy', 'capacity'], invariants: ['0 <= occupancy <= capacity (capacity>0)'], results: ['occupancyChanged']
     },
     mobile: {
         key: 'mobile', label: 'twin.capability.mobile', semantics: '자원 자신이 자리 간 이동. Transferable(아이템 이동)과 다름. (씬 기제: CarrierLine)',
+        commands: [],
         stateFields: ['location', 'motion'], models: ['Motion'], results: ['moved', 'motionTick']
     },
     processable: {
         key: 'processable', label: 'twin.capability.processable', semantics: '변환/가공 수행 — 산출(양품/불량). 운영 status 는 Operable 조합. progress 방출은 후속.',
+        commands: [],
         stateFields: ['output'], results: ['completed']
     },
     /*
@@ -47,10 +51,12 @@ export const CAPABILITIES = {
      */
     switching: {
         key: 'switching', label: 'twin.capability.switching', semantics: '회로를 열고 닫는 기기의 **위치를 읽는다** — 우리는 조작하지 않는다(명령 없음). IEC 61850 XCBR/XSWI Pos.',
+        commands: [],
         stateFields: ['position'], models: ['SwitchingState'], results: ['positionChanged']
     },
     trackable: {
         key: 'trackable', label: 'twin.capability.trackable', semantics: '오더/아이템 생애 추적 — 생애단계(도메인 라벨, 무방언)·진행·보류.',
+        commands: ['order.hold', 'order.resume', 'order.release'],
         stateFields: ['lifecycle', 'progress', 'held'], results: ['lifecycleChanged']
     },
     /*
@@ -61,22 +67,35 @@ export const CAPABILITIES = {
      */
     metered: {
         key: 'metered', label: 'twin.capability.metered', semantics: '자기 소비를 잰다 — 유효전력·누적량·역률. 값이 없으면 모르는 것이다(0 이 아니다).',
+        commands: [],
         stateFields: ['kW', 'kWh', 'powerFactor'], models: ['MeteredState'], results: ['measured']
     },
     curtailable: {
         key: 'curtailable', label: 'twin.capability.curtailable', semantics: '줄일 수 있다 — 최소 유지 아래로는 내리지 않는다. 판정만 하고 집행은 사람과 그 시스템의 몫이다.',
+        commands: [],
         stateFields: ['curtailable', 'minKW'], models: ['CurtailableState'], invariants: ['minKW >= 0'], results: ['drSuggested']
     },
-    generating: {
-        key: 'generating', label: 'twin.capability.generating', semantics: '전기를 만든다 — 역송은 소비의 음수가 아니라 별개 사실이다.',
+    energyGenerating: {
+        key: 'energyGenerating', label: 'twin.capability.energyGenerating', semantics: '전기를 만든다 — 역송은 소비의 음수가 아니라 별개 사실이다.',
+        commands: [],
         stateFields: ['generatedKW', 'exportKW'], models: ['GeneratingState'], results: ['generated']
     },
-    storing: {
-        key: 'storing', label: 'twin.capability.storing', semantics: '담고 낸다 — 충전과 방전을 나눈다(손실·수명 판단이 둘을 구별해야 한다).',
+    /*
+     * ── 왜 `storing` 이 아니라 `energyStoring` 인가 (2026-08-15) ────────────────
+     * 같은 카탈로그에 `storable`(물건을 담는 자리)이 있다. 전기를 담는 것과 물건을 담는 것이 한 글자
+     * 차이로 붙어 있어서, 컴포넌트를 만들 때 `twin-storage` 를 피해 `twin-storage-energy` 로 도망쳤다 —
+     * 한 이름을 두 번 피해 갔다면 그 이름이 틀린 것이다.
+     *
+     * 도메인(EMS)이 아니라 **양(에너지)** 을 이름에 넣는다. 그래서 MES 트윈 안의 디젤 발전기도 그대로
+     * `energyGenerating` 이다 — 능력은 도메인이 아니라 관측의 면이다(방언 없음).
+     */
+    energyStoring: {
+        key: 'energyStoring', label: 'twin.capability.energyStoring', semantics: '담고 낸다 — 충전과 방전을 나눈다(손실·수명 판단이 둘을 구별해야 한다).',
+        commands: [],
         stateFields: ['soc', 'chargeKW', 'dischargeKW'], models: ['StoringState'], invariants: ['0 <= soc <= 100'], results: ['stored', 'discharged']
     }
 };
-export const CAPABILITY_KEYS = ['operable', 'storable', 'mobile', 'processable', 'trackable', 'switching', 'metered', 'curtailable', 'generating', 'storing'];
+export const CAPABILITY_KEYS = ['operable', 'storable', 'mobile', 'processable', 'trackable', 'switching', 'metered', 'curtailable', 'energyGenerating', 'energyStoring'];
 /** 능력 집합이 관측 노출하는 상태 필드 합집합(직교이므로 단순 병합). */
 export function stateFieldsOf(caps) {
     const out = new Set();
@@ -85,3 +104,16 @@ export function stateFieldsOf(caps) {
             out.add(f);
     return [...out];
 }
+/**
+ * 능력 집합이 **받는 명령**의 합집합 — `stateFieldsOf` 의 짝.
+ *
+ * 「이 자원에 제어를 붙여도 되는가」는 이 목록이 비었는지로 **파생**한다. 그래서 `controllable` 같은
+ * 형용사를 따로 두지 않는다 — 형용사를 두면 목록과 형용사가 언젠가 어긋나고, 어긋난 쪽이 화면이 된다.
+ */
+export function commandsOf(caps) {
+    const out = new Set();
+    for (const c of caps)
+        for (const cmd of CAPABILITIES[c]?.commands ?? [])
+            out.add(cmd);
+    return [...out];
+}

package/dist/ems-profile.js

@@ -96,7 +96,7 @@ export const EMS_TYPES = [
         /* 태양광 어레이 — IEC 61850-7-420(분산자원)의 `DPVA`. 발전과 계량은 다른 능력이다. */
         standardClass: { iec61850: 'DPVA', iso55000: 'Asset', iso50001: 'RenewableSupply' },
         identity: { scheme: 'kernel:id' },
-        capabilities: ['generating', 'metered', 'operable']
+        capabilities: ['energyGenerating', 'metered', 'operable']
     },
     {
         key: 'battery',
@@ -105,7 +105,7 @@ export const EMS_TYPES = [
         /* 축전지(ESS) — `ZBAT`. 충전·방전을 나눠 재고, 저장은 보관(`storable`)이 아니다(물건이 아니다). */
         standardClass: { iec61850: 'ZBAT', iso55000: 'Asset' },
         identity: { scheme: 'kernel:id' },
-        capabilities: ['storing', 'metered', 'operable']
+        capabilities: ['energyStoring', 'metered', 'operable']
     },
     {
         key: 'utility',

package/dist-cjs/index.cjs

@@ -85,6 +85,7 @@ __export(index_exports, {
   capabilitiesForType: () => capabilitiesForType,
   capabilityOf: () => capabilityOf,
   classClosure: () => classClosure,
+  commandsOf: () => commandsOf,
   compareStates: () => compareStates,
   computeOee: () => computeOee,
   constantDuration: () => constantDuration,
@@ -1700,7 +1701,7 @@ var EMS_TYPES = [
     /* 태양광 어레이 — IEC 61850-7-420(분산자원)의 `DPVA`. 발전과 계량은 다른 능력이다. */
     standardClass: { iec61850: "DPVA", iso55000: "Asset", iso50001: "RenewableSupply" },
     identity: { scheme: "kernel:id" },
-    capabilities: ["generating", "metered", "operable"]
+    capabilities: ["energyGenerating", "metered", "operable"]
   },
   {
     key: "battery",
@@ -1709,7 +1710,7 @@ var EMS_TYPES = [
     /* 축전지(ESS) — `ZBAT`. 충전·방전을 나눠 재고, 저장은 보관(`storable`)이 아니다(물건이 아니다). */
     standardClass: { iec61850: "ZBAT", iso55000: "Asset" },
     identity: { scheme: "kernel:id" },
-    capabilities: ["storing", "metered", "operable"]
+    capabilities: ["energyStoring", "metered", "operable"]
   },
   {
     key: "utility",
@@ -1756,6 +1757,7 @@ var CAPABILITIES = {
     key: "operable",
     label: "twin.capability.operable",
     semantics: "\uB2A5\uB3D9 \uC790\uC6D0\uC758 \uC6B4\uC601 \uC0C1\uD0DC(\uC720\uD734/\uAC00\uB3D9/\uACE0\uC7A5). status \uAD50\uCC28 \uAD00\uC2EC\uC0AC\uB97C \uC5EC\uAE30 \uD558\uB098\uB85C.",
+    commands: ["resource.hold", "resource.resume", "resource.down", "resource.repair", "resource.reset-metrics"],
     stateFields: ["status"],
     results: ["statusChanged"]
   },
@@ -1763,6 +1765,7 @@ var CAPABILITIES = {
     key: "storable",
     label: "twin.capability.storable",
     semantics: "\uC544\uC774\uD15C\uC744 \uBCF4\uC720\uD558\uB294 \uC704\uCE58 \u2014 \uC810\uC720/\uC6A9\uB7C9. (\uC52C \uAE30\uC81C: Capacity)",
+    commands: [],
     stateFields: ["occupancy", "capacity"],
     invariants: ["0 <= occupancy <= capacity (capacity>0)"],
     results: ["occupancyChanged"]
@@ -1771,6 +1774,7 @@ var CAPABILITIES = {
     key: "mobile",
     label: "twin.capability.mobile",
     semantics: "\uC790\uC6D0 \uC790\uC2E0\uC774 \uC790\uB9AC \uAC04 \uC774\uB3D9. Transferable(\uC544\uC774\uD15C \uC774\uB3D9)\uACFC \uB2E4\uB984. (\uC52C \uAE30\uC81C: CarrierLine)",
+    commands: [],
     stateFields: ["location", "motion"],
     models: ["Motion"],
     results: ["moved", "motionTick"]
@@ -1779,6 +1783,7 @@ var CAPABILITIES = {
     key: "processable",
     label: "twin.capability.processable",
     semantics: "\uBCC0\uD658/\uAC00\uACF5 \uC218\uD589 \u2014 \uC0B0\uCD9C(\uC591\uD488/\uBD88\uB7C9). \uC6B4\uC601 status \uB294 Operable \uC870\uD569. progress \uBC29\uCD9C\uC740 \uD6C4\uC18D.",
+    commands: [],
     stateFields: ["output"],
     results: ["completed"]
   },
@@ -1798,6 +1803,7 @@ var CAPABILITIES = {
     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.",
+    commands: [],
     stateFields: ["position"],
     models: ["SwitchingState"],
     results: ["positionChanged"]
@@ -1806,6 +1812,7 @@ var CAPABILITIES = {
     key: "trackable",
     label: "twin.capability.trackable",
     semantics: "\uC624\uB354/\uC544\uC774\uD15C \uC0DD\uC560 \uCD94\uC801 \u2014 \uC0DD\uC560\uB2E8\uACC4(\uB3C4\uBA54\uC778 \uB77C\uBCA8, \uBB34\uBC29\uC5B8)\xB7\uC9C4\uD589\xB7\uBCF4\uB958.",
+    commands: ["order.hold", "order.resume", "order.release"],
     stateFields: ["lifecycle", "progress", "held"],
     results: ["lifecycleChanged"]
   },
@@ -1819,6 +1826,7 @@ var CAPABILITIES = {
     key: "metered",
     label: "twin.capability.metered",
     semantics: "\uC790\uAE30 \uC18C\uBE44\uB97C \uC7B0\uB2E4 \u2014 \uC720\uD6A8\uC804\uB825\xB7\uB204\uC801\uB7C9\xB7\uC5ED\uB960. \uAC12\uC774 \uC5C6\uC73C\uBA74 \uBAA8\uB974\uB294 \uAC83\uC774\uB2E4(0 \uC774 \uC544\uB2C8\uB2E4).",
+    commands: [],
     stateFields: ["kW", "kWh", "powerFactor"],
     models: ["MeteredState"],
     results: ["measured"]
@@ -1827,35 +1835,52 @@ var CAPABILITIES = {
     key: "curtailable",
     label: "twin.capability.curtailable",
     semantics: "\uC904\uC77C \uC218 \uC788\uB2E4 \u2014 \uCD5C\uC18C \uC720\uC9C0 \uC544\uB798\uB85C\uB294 \uB0B4\uB9AC\uC9C0 \uC54A\uB294\uB2E4. \uD310\uC815\uB9CC \uD558\uACE0 \uC9D1\uD589\uC740 \uC0AC\uB78C\uACFC \uADF8 \uC2DC\uC2A4\uD15C\uC758 \uBAAB\uC774\uB2E4.",
+    commands: [],
     stateFields: ["curtailable", "minKW"],
     models: ["CurtailableState"],
     invariants: ["minKW >= 0"],
     results: ["drSuggested"]
   },
-  generating: {
-    key: "generating",
-    label: "twin.capability.generating",
+  energyGenerating: {
+    key: "energyGenerating",
+    label: "twin.capability.energyGenerating",
     semantics: "\uC804\uAE30\uB97C \uB9CC\uB4E0\uB2E4 \u2014 \uC5ED\uC1A1\uC740 \uC18C\uBE44\uC758 \uC74C\uC218\uAC00 \uC544\uB2C8\uB77C \uBCC4\uAC1C \uC0AC\uC2E4\uC774\uB2E4.",
+    commands: [],
     stateFields: ["generatedKW", "exportKW"],
     models: ["GeneratingState"],
     results: ["generated"]
   },
-  storing: {
-    key: "storing",
-    label: "twin.capability.storing",
+  /*
+   * ── 왜 `storing` 이 아니라 `energyStoring` 인가 (2026-08-15) ────────────────
+   * 같은 카탈로그에 `storable`(물건을 담는 자리)이 있다. 전기를 담는 것과 물건을 담는 것이 한 글자
+   * 차이로 붙어 있어서, 컴포넌트를 만들 때 `twin-storage` 를 피해 `twin-storage-energy` 로 도망쳤다 —
+   * 한 이름을 두 번 피해 갔다면 그 이름이 틀린 것이다.
+   *
+   * 도메인(EMS)이 아니라 **양(에너지)** 을 이름에 넣는다. 그래서 MES 트윈 안의 디젤 발전기도 그대로
+   * `energyGenerating` 이다 — 능력은 도메인이 아니라 관측의 면이다(방언 없음).
+   */
+  energyStoring: {
+    key: "energyStoring",
+    label: "twin.capability.energyStoring",
     semantics: "\uB2F4\uACE0 \uB0B8\uB2E4 \u2014 \uCDA9\uC804\uACFC \uBC29\uC804\uC744 \uB098\uB208\uB2E4(\uC190\uC2E4\xB7\uC218\uBA85 \uD310\uB2E8\uC774 \uB458\uC744 \uAD6C\uBCC4\uD574\uC57C \uD55C\uB2E4).",
+    commands: [],
     stateFields: ["soc", "chargeKW", "dischargeKW"],
     models: ["StoringState"],
     invariants: ["0 <= soc <= 100"],
     results: ["stored", "discharged"]
   }
 };
-var CAPABILITY_KEYS = ["operable", "storable", "mobile", "processable", "trackable", "switching", "metered", "curtailable", "generating", "storing"];
+var CAPABILITY_KEYS = ["operable", "storable", "mobile", "processable", "trackable", "switching", "metered", "curtailable", "energyGenerating", "energyStoring"];
 function stateFieldsOf(caps) {
   const out = /* @__PURE__ */ new Set();
   for (const c of caps) for (const f of CAPABILITIES[c]?.stateFields ?? []) out.add(f);
   return [...out];
 }
+function commandsOf(caps) {
+  const out = /* @__PURE__ */ new Set();
+  for (const c of caps) for (const cmd of CAPABILITIES[c]?.commands ?? []) out.add(cmd);
+  return [...out];
+}
 
 // src/yms-profile.ts
 var YARD_BIZSTEP = {
@@ -6446,6 +6471,7 @@ function retiredVocabularyIn(line) {
   capabilitiesForType,
   capabilityOf,
   classClosure,
+  commandsOf,
   compareStates,
   computeOee,
   constantDuration,

package/package.json

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