@operato/twin-kernel 0.6.12 → 0.6.13

package/dist/operations-capability.d.ts

@@ -37,8 +37,19 @@ export interface OperationCapability {
      * `Math.max(0, …)` 하나로 덮는 일이 실제로 이 트윈에서 여러 번 있었다.
      */
     available: number | null;
-    /** 무엇이 묶고 있나 — 축과 등급(용량 분석이 이미 낸다). */
+    /** 무엇이 **천장**을 묶고 있나 — 축과 등급(용량 분석이 이미 낸다). 선언 기준이다. */
     constraint?: CapacityRequirement;
+    /**
+     * **남은 능력을 묶는 축** — 달성불가를 되찾으려면 여기부터다. `unattainable > 0` 일 때만 있다.
+     *
+     * 천장을 묶는 축과 **다를 수 있고**, 그 차이가 곧 사람이 헛걸음하는 자리다: 용접기 2대와 용접
+     * 자격자 2명이 같은 천장을 낼 때 천장은 어느 쪽으로도 묶이지만, 자격 하나가 만료돼 잃은 몫의
+     * 원인은 인원이다. 화면이 천장 쪽만 보이면 사람이 **설비를 보러 간다**(실제로 그랬다).
+     *
+     * 값은 이미 손에 있다 — 달성불가를 내려고 가용 자원 기준으로 같은 계산을 한 번 더 돌리기 때문이다.
+     * 그 계산이 묶는 축이 곧 이 답이고, 따로 판정을 만들지 않는다.
+     */
+    unattainableBy?: CapacityRequirement;
 }
 export interface OperationsCapabilityReport {
     /** 표준 `OperationsType` — 지금은 생산뿐이다(정비·품질 능력은 별도 보고서가 될 자리). */

package/dist/operations-capability.js

@@ -90,9 +90,14 @@ export function operationsCapabilityOf(input) {
          * 아닌 입력을 받은 것이므로 값을 지어내는 대신 아래 `available` 이 어긋남을 드러낸다.
          */
         let unattainable = null;
+        let unattainableBy;
         if (usable) {
-            const usableAmount = amountOf(usable.operations.find(o => o.operation === op.operation)?.perHour ?? NaN);
+            const left = usable.operations.find(o => o.operation === op.operation);
+            const usableAmount = amountOf(left?.perHour ?? NaN);
             unattainable = total != null && usableAmount != null ? Math.max(0, total - usableAmount) : null;
+            /* 잃은 몫이 있을 때만 원인을 말한다 — 잃은 것이 없는데 "여기부터" 라고 하면 없는 일을 만든다. */
+            if (unattainable != null && unattainable > 0 && left?.constraint)
+                unattainableBy = left.constraint;
         }
         const available = total == null || unattainable == null ? null : total - committed - unattainable;
         return {
@@ -101,7 +106,8 @@ export function operationsCapabilityOf(input) {
             committed,
             unattainable,
             available,
-            ...(op.constraint ? { constraint: op.constraint } : {})
+            ...(op.constraint ? { constraint: op.constraint } : {}),
+            ...(unattainableBy ? { unattainableBy } : {})
         };
     });
     return {

package/dist-cjs/index.cjs

@@ -2276,9 +2276,12 @@ function operationsCapabilityOf(input) {
     const total = amountOf(op.perHour);
     const committed = committedOf(op.operation);
     let unattainable = null;
+    let unattainableBy;
     if (usable) {
-      const usableAmount = amountOf(usable.operations.find((o) => o.operation === op.operation)?.perHour ?? NaN);
+      const left = usable.operations.find((o) => o.operation === op.operation);
+      const usableAmount = amountOf(left?.perHour ?? NaN);
       unattainable = total != null && usableAmount != null ? Math.max(0, total - usableAmount) : null;
+      if (unattainable != null && unattainable > 0 && left?.constraint) unattainableBy = left.constraint;
     }
     const available = total == null || unattainable == null ? null : total - committed - unattainable;
     return {
@@ -2287,7 +2290,8 @@ function operationsCapabilityOf(input) {
       committed,
       unattainable,
       available,
-      ...op.constraint ? { constraint: op.constraint } : {}
+      ...op.constraint ? { constraint: op.constraint } : {},
+      ...unattainableBy ? { unattainableBy } : {}
     };
   });
   return {

package/package.json

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