@operato/twin-kernel 0.8.3 → 0.9.0

package/dist/flow-engine.d.ts

@@ -1,4 +1,4 @@
-import type { TestResult, ISOTime, MaterialQuantity, WorkCalendarEntry, EffectivePeriod, Effectivity, OffCalendarReason, ResourceProperty, ResourceClassDef, MaterialDefinition, Attention, TwinModelDef, CanonicalEnvelope, Command, CommandAck, EventHandler, EquipmentMotion, OeeMetrics, AssetState, GeneratorSpec, InterventionOutcome, OrderState, PersonState, ScenarioControl, ScenarioOverride, StateSnapshot, TwinKernel, Unsubscribe, LocationState, ItemState, EquipmentState, OrderStatusDelta, TaskState, TaskStatus, StructureShift, IdentityGroundingView, IdentityDeclaration, TestSpecificationCriterion, LocationObservation } from '@operato/ops-contract';
+import type { TestResult, ISOTime, MaterialQuantity, WorkCalendarEntry, EffectivePeriod, Effectivity, OffCalendarReason, ResourceProperty, ResourceClassDef, MaterialDefinition, Attention, TwinModelDef, CanonicalEnvelope, Command, CommandAck, EventHandler, EquipmentMotion, AssetState, GeneratorSpec, InterventionOutcome, OrderState, PersonState, ScenarioControl, ScenarioOverride, StateSnapshot, TwinKernel, Unsubscribe, LocationState, ItemState, EquipmentState, OrderStatusDelta, TaskState, TaskStatus, StructureShift, IdentityGroundingView, IdentityDeclaration, TestSpecificationCriterion, LocationObservation } from '@operato/ops-contract';
 import type { VocabularyElement } from '@operato/ops-contract';
 import type { ReducerCheckpoint } from './observed-reducer.ts';
 import type { EpcisEvent, BizTransactionElement } from '@operato/ops-contract';
@@ -411,22 +411,6 @@ nowIso?: ISOTime,
  * 부르는 쪽이 모델에서 뽑아 넘긴다(이 함수는 순수하게 남는다 — 모델을 읽는 규칙이 두 곳이 되지 않게).
  */
 thresholds?: AttentionThresholds): Attention[];
-/** OEE 계측 카운터 — sim 은 tick 으로 누적, live 는 실 텔레메트리 또는 이벤트 누적기가 채운다(face2-inbound-live §1.1). */
-export interface OeeCounters {
-    runMs: number;
-    setupMs: number;
-    downMs: number;
-    goodCount: number;
-    scrapCount: number;
-    holdMs?: number;
-    metricsSinceMs?: number;
-}
-/**
- * OEE 공식(순수) — 누적 카운터 + 현재 시각 → OEE. sim(oeeOf)과 live 가 **공유하는 계산 층**(face2-inbound-live §1.1).
- * ⚠ attentions 와 달리: 입력(카운터)이 관측 State·이벤트에 없다 → live 는 카운터를 텔레메트리(정확) 또는
- *    이벤트 누적기(근사)로 별도 공급해야 한다. 공식만 공유되고 입력원은 live 데이터-생산 결정.
- */
-export declare function computeOee(c: OeeCounters, nowMs: number): OeeMetrics;
 /**
  * 물품 저장소 — **맵과 「자리별 색인」을 함께 든다.**
  *

package/dist/flow-engine.js

@@ -9,7 +9,7 @@
  * 통합 타입은 도메인 필드를 옵셔널로 넓혀(FlowItem.gtin?, FlowOrder.shipmentEpc? 등) 두 도메인을 담는다.
  * (roadmap Phase5 발견 → 추출. [[project_flow_single_base_vision]] FlowLocation 단일 base 방향과 정합.)
  */
-import { OP_EVENT, CMD, locationStatusOf, readBoardEquipment, readBoardLocations, readBoardAssets, classClosure, capabilityOf, requiredTestsFor, priorityRank, dueStatusOf, isOrderTerminal, effectivityAt, offCalendarAt, offCalendarReasonAt, minuteOfDayAt, activeShiftAt, subLotIdOf, itemKeyOf, identityGroundingOf, outsideLimit } from '@operato/ops-contract';
+import { OP_EVENT, CMD, locationStatusOf, readBoardEquipment, readBoardLocations, readBoardAssets, classClosure, capabilityOf, requiredTestsFor, priorityRank, dueStatusOf, isOrderTerminal, effectivityAt, offCalendarAt, offCalendarReasonAt, minuteOfDayAt, activeShiftAt, subLotIdOf, itemKeyOf, identityGroundingOf, outsideLimit, computeOee } from '@operato/ops-contract';
 import { ObservedReducer } from "./observed-reducer.js";
 /* 주체를 정하는 규칙은 유입 문과 한 벌이다 — 두 곳에 적으면 한쪽만 고쳐진다. */
 import { resolveSubject } from '@operato/ops-contract';
@@ -332,32 +332,6 @@ thresholds) {
                 a.state = 'acknowledged';
     return out;
 }
-/**
- * OEE 공식(순수) — 누적 카운터 + 현재 시각 → OEE. sim(oeeOf)과 live 가 **공유하는 계산 층**(face2-inbound-live §1.1).
- * ⚠ attentions 와 달리: 입력(카운터)이 관측 State·이벤트에 없다 → live 는 카운터를 텔레메트리(정확) 또는
- *    이벤트 누적기(근사)로 별도 공급해야 한다. 공식만 공유되고 입력원은 live 데이터-생산 결정.
- */
-export function computeOee(c, nowMs) {
-    /*
-     * **계측 창을 모르면 잰 시간이 없다** — `?? 0` 으로 메우면 "1970년부터 재고 있었다" 가 된다.
-     *
-     * 그 결과가 화면까지 갔다: 갓 뜬 트윈의 절단기가 `idleMs 1767226603000`(약 56,000년) 유휴로 섰다.
-     * 시각을 소요시간 자리에 앉힌 것이고, 같은 값이 availability·overall 의 분모라 **성과 숫자 전체가
-     * 조용히 거짓**이 된다(가동률 100%, 성능 0%).
-     *
-     * 모르면 0 이 아니라 **없음**이다: 잰 구간이 없으면 유휴도 없다(아직 아무것도 재지 않았다).
-     */
-    const planned = c.metricsSinceMs == null ? 0 : Math.max(0, nowMs - c.metricsSinceMs - (c.holdMs ?? 0));
-    const uptime = Math.max(0, planned - c.setupMs - c.downMs); // 가용시간(셋업·고장 제외)
-    const availability = planned > 0 ? uptime / planned : 1;
-    const performance = uptime > 0 ? Math.min(1, c.runMs / uptime) : (c.runMs > 0 ? 1 : 0);
-    const totalQ = c.goodCount + c.scrapCount;
-    const quality = totalQ > 0 ? c.goodCount / totalQ : 1;
-    return {
-        availability, performance, quality, overall: availability * performance * quality,
-        runMs: c.runMs, setupMs: c.setupMs, downMs: c.downMs, idleMs: Math.max(0, uptime - c.runMs), goodCount: c.goodCount, scrapCount: c.scrapCount
-    };
-}
 /**
  * 에너지 능력이 선언한 상태 필드를 스냅샷에 싣는다 — **온 것만.**
  *
@@ -1075,7 +1049,7 @@ export class FlowEngine {
              * 한계가 있다 — busy 를 가동으로 근사하고 **셋업을 분리하지 못해 0** 으로 둔다. 여기서는 받은
              * 값을 그대로 이어받고, 없으면 0 에서 시작한다(꾸미지 않는다).
              */
-            /* `idleMs` 까지 읽는다 — 그것이 있어야 **잰 구간**을 되세울 수 있다(계획 시간 = 가동+준비+고장+유휴). */
+            /* `delayMs` 까지 읽는다 — 그것이 있어야 **잰 구간**을 되세울 수 있다(계획 조업 = 생산+준비+고장+대기). */
             const oee = m.oee;
             /* **마스터가 말한 것을 관측이 지우지 않는다.** 예전에는 이 자리에서 통째로 새 객체를 만들어
              * 교대 캘린더·속성·유효 기간·계획정지를 **전부 버렸다.** 그 결과 라이브(관측) 커널은
@@ -1105,7 +1079,7 @@ export class FlowEngine {
                  * 뒤로 물려 창을 다시 세운다. 지표가 없으면 창도 없다(그때는 지금부터 새로 잰다).
                  */
                 ...(oee
-                    ? { metricsSinceMs: this.clockMs - ((oee.runMs ?? 0) + (oee.setupMs ?? 0) + (oee.downMs ?? 0) + (oee.idleMs ?? 0)) }
+                    ? { metricsSinceMs: this.clockMs - ((oee.runMs ?? 0) + (oee.setupMs ?? 0) + (oee.downMs ?? 0) + (oee.delayMs ?? 0)) }
                     : {}),
                 /* 계획 정지를 이어받는다 — 잃으면 씨앗이 **정비 중인 설비를 가용으로 놓고** 미래를 시뮬레이션한다
                    (예측이 낙관 쪽으로 치우친다). 씨앗 왕복 대조가 이것을 잡았다. */

package/dist-cjs/index.cjs

@@ -38,7 +38,6 @@ __export(index_exports, {
   YmsKernel: () => YmsKernel,
   attributeEnergy: () => attributeEnergy,
   compareStates: () => compareStates,
-  computeOee: () => computeOee,
   constantDuration: () => constantDuration,
   counterfactualAt: () => counterfactualAt,
   demandWindowStart: () => demandWindowStart,
@@ -63,7 +62,7 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// node_modules/@operato/ops-contract/dist/capability.js
+// ../ops-contract/dist/capability.js
 var CAPABILITIES = {
   operable: {
     key: "operable",
@@ -198,7 +197,7 @@ function stateFieldsOf(caps) {
   return [...out];
 }
 
-// node_modules/@operato/ops-contract/dist/contract.js
+// ../ops-contract/dist/contract.js
 var ORDER_TERMINAL_STATUS = ["completed", "cancelled"];
 function isOrderTerminal(o) {
   const status = String(o?.status ?? "").trim().toLowerCase();
@@ -218,6 +217,32 @@ function locationStatusOf(n) {
   const r = (n.occupancy ?? 0) / cap;
   return r >= 1 ? "full" : r >= LOCATION_SATURATION_NEAR ? "near-full" : "available";
 }
+var DISPOSITION_DECISION = [
+  /** 원 규격으로 되돌린다 — 공정에 다시 들어가고, 산출물은 원 품목이다. */
+  "rework",
+  /**
+   * 쓸 수 있게 만들되 **원 규격은 아니다** — 공정에 다시 들어가지만 산출물이 원 품목이 아니다.
+   *
+   * `rework` 와 나눈 이유는 이름이 아니라 **효과**다. 되돌린 것과 고쳐 쓴 것은 산출물의 정체성이
+   * 다르고, 그것을 한 낱말로 묶으면 계보가 「원 품목을 만들었다」고 거짓을 말한다.
+   */
+  "repair",
+  /** 그대로 쓴다 — 공정도 정체성도 바뀌지 않는다. */
+  "use-as-is",
+  /**
+   * **등급을 내려 다른 품목으로 판다** — 공정에 다시 들어가지 않고, 그 자리에서 품목 정의가 바뀐다.
+   *
+   * 다른 넷과 축이 다르다. 폐기도 특채도 아니고 **자재의 품목 자체가 달라진다**(GTIN 이 바뀐다).
+   * 식품·철강·섬유에서 일상이다.
+   */
+  "regrade",
+  /** 재고에서 뺀다. */
+  "scrap",
+  /** 공급자에게 돌려보낸다 — 재고에서 빠지되 폐기와 다른 사실이다. */
+  "return-to-supplier",
+  /** 아직 정하지 않았다 — 묶어 두고 쓰지 않는다. */
+  "hold"
+];
 function testPassedAt(r, at) {
   if (r.result !== "pass")
     return false;
@@ -556,6 +581,15 @@ var OP_EVENT = {
    * 이 채널이 없으면 시험 결과는 **상태에만 있는 축**이 된다 — 재기동에서 사라지고, 폴드가 되살릴 수
    * 없고, 미러가 이어받지 못한다(§상태 ⊆ 이벤트).
    */
+  /**
+   * **마감된 설비 상태 구간** — 이 설비가 이 구간 동안 이 상태였다.
+   *
+   * 시점의 전이(`equipment.status`)와 다른 사실이다. 전이는 설비가 내고, 이것은 **사람이 나중에
+   * 적는다.** 자재 대기처럼 신호를 내지 않는 정지는 이 길로만 들어온다.
+   *
+   * ISO 22400-2 의 가동률 계산이 이 구간들을 읽는다.
+   */
+  equipmentPeriod: "equipment.state.period",
   test: "test.result",
   /**
    * **부적합 처분** — 재고 판정을 받은 것을 어떻게 하기로 정했나(재작업 · 특채 · 폐기 · 반품).
@@ -779,7 +813,7 @@ function gs1Namespaces(prefix) {
   return [`urn:epc:idpat:sgtin:${prefix}.`, `urn:epc:class:lgtin:${prefix}.`, `urn:epc:id:sgtin:${prefix}.`];
 }
 
-// node_modules/@operato/ops-contract/dist/capacity.js
+// ../ops-contract/dist/capacity.js
 function isoDurationHours(iso2) {
   if (!iso2)
     return 0;
@@ -887,7 +921,7 @@ function analyzeCapacity(input) {
   };
 }
 
-// node_modules/@operato/ops-contract/dist/wms-profile.js
+// ../ops-contract/dist/wms-profile.js
 var BIZSTEP = {
   receiving: "urn:epcglobal:cbv:bizstep:receiving",
   storing: "urn:epcglobal:cbv:bizstep:storing",
@@ -917,7 +951,7 @@ var WMS_TYPES = [
   { key: "packer", role: "equipment", label: "twin.type.packer", standardClass: { epcis: "object", isa95: "Equipment" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] }
 ];
 
-// node_modules/@operato/ops-contract/dist/yms-profile.js
+// ../ops-contract/dist/yms-profile.js
 var YARD_BIZSTEP = {
   arriving: "urn:epcglobal:cbv:bizstep:arriving",
   // 게이트-인
@@ -943,7 +977,7 @@ var YMS_TYPES = [
   { key: "hostler", role: "equipment", label: "twin.type.hostler", standardClass: { epcis: "object", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["mobile", "operable"] }
 ];
 
-// node_modules/@operato/ops-contract/dist/mes-profile.js
+// ../ops-contract/dist/mes-profile.js
 var MES_BIZSTEP = {
   receiving: "urn:epcglobal:cbv:bizstep:receiving",
   // 원자재 수령
@@ -981,7 +1015,7 @@ var MES_TYPES = [
   { key: "assembler", role: "equipment", label: "twin.type.assembler", standardClass: { isa95: "Equipment", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] }
 ];
 
-// node_modules/@operato/ops-contract/dist/ems-profile.js
+// ../ops-contract/dist/ems-profile.js
 var EMS_LOCATION_TYPES = ["incoming", "feeder", "submeter-zone"];
 var METER_DIRECTION = ["import", "export", "bidirectional"];
 var EMS_PROPERTY = {
@@ -1302,7 +1336,7 @@ function isElectricalLocationType(type) {
   return EMS_LOCATION_TYPES.includes(type);
 }
 
-// node_modules/@operato/ops-contract/dist/domain-catalog.js
+// ../ops-contract/dist/domain-catalog.js
 var locationKeys = (types) => types.filter((t) => t.role === "location").map((t) => t.key);
 var DOMAIN_CATALOG = {
   // label 은 언어 중립 i18n 키(twin.system.<code>) — 사람 언어는 표현계층이 렌더(L2).
@@ -1312,7 +1346,7 @@ var DOMAIN_CATALOG = {
   ems: { system: "ems", label: "twin.system.ems", types: EMS_TYPES, locationTypes: locationKeys(EMS_TYPES) }
 };
 
-// node_modules/@operato/ops-contract/dist/domain-definition.js
+// ../ops-contract/dist/domain-definition.js
 var OP_PARAM = {
   /** 양품률(0..1, 무차원). 없으면 커널 기본값 — 기본값을 쓴 사실은 `specCoverage()` 가 밝힌다. */
   yield: "yield",
@@ -1321,7 +1355,7 @@ var OP_PARAM = {
   setupDuration: "setupDuration"
 };
 
-// node_modules/@operato/ops-contract/dist/energy-ingest.js
+// ../ops-contract/dist/energy-ingest.js
 function resolveSubject(kind, localId, opts) {
   const declared = opts.identityOf?.(kind, localId);
   if (declared)
@@ -1332,7 +1366,7 @@ function periodFactId(tenantId, kind, subject, from, to) {
   return [tenantId, kind, subject, from, to].join("|");
 }
 
-// node_modules/@operato/ops-contract/dist/epcis.js
+// ../ops-contract/dist/epcis.js
 var EPCIS_CONTEXT = "https://ref.gs1.org/standards/epcis/2.0.0/epcis-context.jsonld";
 var UTC_OFFSET = "+00:00";
 var DISP = {
@@ -1591,7 +1625,7 @@ function transformationEvent(p) {
   return e;
 }
 
-// node_modules/@operato/ops-contract/dist/iso-duration.js
+// ../ops-contract/dist/iso-duration.js
 var RE = /^(-)?P(?:(\d+(?:\.\d+)?)W)?(?:(\d+(?:\.\d+)?)D)?(?:T(?:(\d+(?:\.\d+)?)H)?(?:(\d+(?:\.\d+)?)M)?(?:(\d+(?:\.\d+)?)S)?)?$/;
 function parseIsoDuration(text) {
   if (typeof text !== "string")
@@ -1617,7 +1651,7 @@ function parseIsoDuration(text) {
   return sign ? -ms2 : ms2;
 }
 
-// node_modules/@operato/ops-contract/dist/master-data.js
+// ../ops-contract/dist/master-data.js
 function expiryFromAttributes(attrs) {
   return readEpochMs(attrs?.[ILMD_ATTR.expiry]);
 }
@@ -1634,9 +1668,9 @@ function readEpochMs(raw) {
   return Number.isNaN(at) ? void 0 : at;
 }
 
-// node_modules/@operato/ops-contract/dist/operational-ingest.js
+// ../ops-contract/dist/operational-ingest.js
 var TASK_STATUS = ["created", "assigned", "in-progress", "completed"];
-var EQUIPMENT_STATUS = ["idle", "busy", "down"];
+var EQUIPMENT_STATUS = ["idle", "busy", "down", "setup", "planned-stop"];
 var PERSON_STATUS = ["idle", "busy"];
 var ASSET_STATUS = ["idle", "in-use"];
 var SPECS = {
@@ -1694,6 +1728,8 @@ var SPECS = {
       effectiveStart: "string",
       effectiveEnd: "string",
       recordTime: "string",
+      /* 왜 이 상태가 됐나 — 설비가 알려 주면 싣는다. 사람이 나중에 정하는 사유는 구간 사실에 적는다. */
+      reasonCode: "string",
       /* 이동 구간 — 실 시스템도 줄 수 있는 사실이다(AGV·RTLS 가 출발·도착·소요를 낸다). 안쪽 필드까지
          재검사하지는 않는다: 그 모양은 `EquipmentMotion` 계약이고, 여기서 두 번 지키면 두 벌이 된다. */
       motion: "object"
@@ -1783,6 +1819,82 @@ var SPECS = {
    * `propertyMeasurements` 안쪽은 재검사하지 않는다 — 그 모양은 `PropertyMeasurement` 계약이고,
    * 여기서 두 번 지키면 두 벌이 된다(설비 `motion` 과 같은 규율).
    */
+  /*
+   * **마감된 설비 상태 구간** — 이 설비가 이 구간 동안 이 상태였다.
+   *
+   * ── 전이만으로는 안 되는 이유 (2026-08-30) ───────────────────────────────
+   * 세 가지다. 셋째가 결정적이다.
+   *
+   *   사유가 붙을 자리가 없다   기계가 서는 순간에는 왜 섰는지 아무도 모른다. 작업자가 라인이 다시
+   *                            돈 뒤에 적는다. 그 사이에 전이가 더 있으면 어느 전이에 붙일지 정할 수 없다
+   *   계획·비계획을 나중에 정한다  ISO 22400 은 계획정지를 계획 조업 시간에서 빼고 고장은 빼지 않는다.
+   *                            그 분류는 전이가 일어난 순간에 모른다
+   *   전이를 내지 않는 정지가 많다  자재 대기 · 앞 공정 대기 · 작업자 부재. 기계는 전원이 켜진 채 `idle`
+   *                            이고 신호가 하나도 안 나온다. OEE 에서 가장 크게 깎이는 것이 보통 이 시간이다
+   *
+   * 마지막이 감시 시스템과 MES 가 갈리는 자리이기도 하다. 설비가 말하는 것만 모으면 감시이고,
+   * **설비가 말하지 못하는 것을 사람이 적어 넣는 자리**가 MES 다.
+   *
+   * ── 이름이 `downtime` 이 아닌 이유 ────────────────────────────────────────
+   * 이 구간은 `setup` 과 `planned-stop` 도 나른다. 그 둘은 정지가 아니다. 담는 것은 **상태 구간**이고,
+   * 어느 상태인지는 `status` 가 말한다.
+   *
+   * ── 되돌아가 적는 사실이다 ───────────────────────────────────────────────
+   * 봉투의 사건 시각은 **구간의 끝**(그때 성립한다)이고, 적은 시각은 `recordTime` 이다. 둘이 갈려 있어야
+   * 「언제 일어났나」와 「언제 알았나」를 구별할 수 있다.
+   */
+  "equipment-period": {
+    eventType: OP_EVENT.equipmentPeriod,
+    identity: "moverId",
+    // vocabulary-guard: allow 저널 와이어 필드 — 전이와 같은 이름을 쓴다
+    required: ["moverId", "status", "from", "to"],
+    // vocabulary-guard: allow 위와 같은 이유
+    fields: {
+      moverId: "string",
+      status: "string",
+      from: "string",
+      to: "string",
+      // vocabulary-guard: allow
+      /* 사람이 정한 사유 — 없을 수 있다(적지 않은 것과 사유가 없는 것은 다르므로 지어내지 않는다). */
+      reasonCode: "string",
+      decidedBy: "string",
+      recordTime: "string"
+    },
+    enums: { status: EQUIPMENT_STATUS }
+  },
+  /*
+   * **부적합 처분** — 재고 판정을 받은 것을 어떻게 하기로 정했나.
+   *
+   * ── 이 통이 늦게 생긴 이유 (2026-08-30) ──────────────────────────────────
+   * 사건 이름(`OP_EVENT.disposition`)과 모양(`DispositionFact`)을 먼저 만들고 **여기로 오는 길을
+   * 내지 않았다.** 그래서 처분 사실을 보내면 어느 통도 아니어서 떨어진 목록에도 남지 않고 사라졌다.
+   * MES 전문가가 소스를 읽다 찾았다.
+   *
+   * 이 파일의 위 주석이 말한 부류 그대로다 — `OP_EVENT.test` 와 `OP_EVENT.observation` 이 같은 일을
+   * 겪었고 이번이 셋째다. **계약에 자리를 만드는 것과 그 자리로 가는 길을 내는 것은 다른 일이다.**
+   *
+   * ── 판정과 다른 사실이다 ─────────────────────────────────────────────────
+   * 근거가 된 판정(`specId`)을 가리킬 수 있지만 **필수가 아니다** — 판정 없이 현장 재량으로 빼는 일이
+   * 정상이다. 그래서 정체성은 처분 대상(`subjectId`)이다.
+   */
+  disposition: {
+    eventType: OP_EVENT.disposition,
+    identity: "subjectId",
+    /* 무엇을 어떻게 하기로 했나 — 둘 중 하나가 없으면 그 결정은 아무 데도 붙지 못한다. */
+    required: ["subjectId", "decision"],
+    fields: {
+      subjectId: "string",
+      decision: "string",
+      quantity: "number",
+      uom: "string",
+      specId: "string",
+      decidedBy: "string",
+      reason: "string",
+      decidedAt: "string",
+      recordTime: "string"
+    },
+    enums: { decision: DISPOSITION_DECISION }
+  },
   test: {
     eventType: OP_EVENT.test,
     identity: "testableObjectId",
@@ -1842,7 +1954,7 @@ var SPECS = {
   }
 };
 
-// node_modules/@operato/ops-contract/dist/operations-capability.js
+// ../ops-contract/dist/operations-capability.js
 function workingHoursBetween(calendar, fromMs, toMs, utcOffsetMinutes) {
   if (!(toMs > fromMs))
     return 0;
@@ -1912,6 +2024,39 @@ function operationsCapabilityOf(input) {
   };
 }
 
+// ../ops-contract/dist/oee.js
+function computeOee(c, nowMs) {
+  const missing = [];
+  const planned = c.metricsSinceMs == null ? 0 : Math.max(0, nowMs - c.metricsSinceMs - (c.holdMs ?? 0));
+  if (planned <= 0)
+    missing.push("planned-busy-time");
+  const delayMs = Math.max(0, planned - c.runMs - c.setupMs - c.downMs);
+  const availability = planned > 0 ? Math.min(1, c.runMs / planned) : void 0;
+  const produced = c.goodCount + c.scrapCount;
+  if (produced <= 0)
+    missing.push("produced-quantity");
+  const quality = produced > 0 ? c.goodCount / produced : void 0;
+  if (c.plannedRunTimePerItemMs == null)
+    missing.push("planned-run-time-per-item");
+  else if (c.runMs <= 0)
+    missing.push("actual-production-time");
+  const performance = c.plannedRunTimePerItemMs != null && c.runMs > 0 ? Math.min(1, c.plannedRunTimePerItemMs * produced / c.runMs) : void 0;
+  const overall = availability != null && performance != null && quality != null ? availability * performance * quality : void 0;
+  return {
+    ...availability != null ? { availability } : {},
+    ...performance != null ? { performance } : {},
+    ...quality != null ? { quality } : {},
+    ...overall != null ? { overall } : {},
+    ...missing.length ? { missing } : {},
+    runMs: c.runMs,
+    setupMs: c.setupMs,
+    downMs: c.downMs,
+    delayMs,
+    goodCount: c.goodCount,
+    scrapCount: c.scrapCount
+  };
+}
+
 // src/divergence.ts
 function diffBy(predicted, actual, idOf, valOf) {
   const p = new Map(predicted.map((e) => [idOf(e), valOf(e)]));
@@ -3292,26 +3437,6 @@ function deriveAttentions(view, acked, nowIso, thresholds) {
   }
   return out;
 }
-function computeOee(c, nowMs) {
-  const planned = c.metricsSinceMs == null ? 0 : Math.max(0, nowMs - c.metricsSinceMs - (c.holdMs ?? 0));
-  const uptime = Math.max(0, planned - c.setupMs - c.downMs);
-  const availability = planned > 0 ? uptime / planned : 1;
-  const performance = uptime > 0 ? Math.min(1, c.runMs / uptime) : c.runMs > 0 ? 1 : 0;
-  const totalQ = c.goodCount + c.scrapCount;
-  const quality = totalQ > 0 ? c.goodCount / totalQ : 1;
-  return {
-    availability,
-    performance,
-    quality,
-    overall: availability * performance * quality,
-    runMs: c.runMs,
-    setupMs: c.setupMs,
-    downMs: c.downMs,
-    idleMs: Math.max(0, uptime - c.runMs),
-    goodCount: c.goodCount,
-    scrapCount: c.scrapCount
-  };
-}
 var ENERGY_STATE_FIELDS = [
   ...stateFieldsOf(["metered", "curtailable", "energyGenerating", "energyStoring", "switching"]),
   "measuredAt"
@@ -3936,7 +4061,7 @@ var FlowEngine = class {
          * 창은 지표 자신이 말해 준다 — 계획 시간은 가동·준비·고장·유휴의 합이다. 그래서 그 합만큼
          * 뒤로 물려 창을 다시 세운다. 지표가 없으면 창도 없다(그때는 지금부터 새로 잰다).
          */
-        ...oee ? { metricsSinceMs: this.clockMs - ((oee.runMs ?? 0) + (oee.setupMs ?? 0) + (oee.downMs ?? 0) + (oee.idleMs ?? 0)) } : {},
+        ...oee ? { metricsSinceMs: this.clockMs - ((oee.runMs ?? 0) + (oee.setupMs ?? 0) + (oee.downMs ?? 0) + (oee.delayMs ?? 0)) } : {},
         /* 계획 정지를 이어받는다 — 잃으면 씨앗이 **정비 중인 설비를 가용으로 놓고** 미래를 시뮬레이션한다
            (예측이 낙관 쪽으로 치우친다). 씨앗 왕복 대조가 이것을 잡았다. */
         ...m.held ? { held: true } : {},
@@ -9361,7 +9486,6 @@ function electricityCost(input) {
   YmsKernel,
   attributeEnergy,
   compareStates,
-  computeOee,
   constantDuration,
   counterfactualAt,
   demandWindowStart,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operato/twin-kernel",
-  "version": "0.8.3",
+  "version": "0.9.0",
   "type": "module",
   "description": "Twin Domain Kernel — framework-agnostic, zero-dep (domain + sim + 3-channel contract). WMS/YMS/MES, EPCIS 2.0 · ISA-95.",
   "publishConfig": {
@@ -28,6 +28,6 @@
     "test": "node --test test/*.test.ts"
   },
   "dependencies": {
-    "@operato/ops-contract": "^0.3.0"
+    "@operato/ops-contract": "^0.5.0"
   }
 }