@operato/twin-kernel 0.0.4 → 0.0.5

package/dist-cjs/index.cjs

@@ -23,6 +23,8 @@ __export(index_exports, {
   BTT: () => BTT,
   BTT_DELIVERY: () => BTT_DELIVERY,
   BTT_PRODORDER: () => BTT_PRODORDER,
+  CAPABILITIES: () => CAPABILITIES,
+  CAPABILITY_KEYS: () => CAPABILITY_KEYS,
   CMD: () => CMD,
   DISP: () => DISP,
   DOMAIN_CATALOG: () => DOMAIN_CATALOG,
@@ -33,7 +35,9 @@ __export(index_exports, {
   MES_BIZSTEP: () => MES_BIZSTEP,
   MES_NODE_TYPES: () => MES_NODE_TYPES,
   MES_PART_GTINS: () => MES_PART_GTINS,
+  MES_PRODUCTS: () => MES_PRODUCTS,
   MES_PRODUCT_GTINS: () => MES_PRODUCT_GTINS,
+  MES_TYPES: () => MES_TYPES,
   MesKernel: () => MesKernel,
   OP_EVENT: () => OP_EVENT,
   StateProjector: () => StateProjector,
@@ -42,14 +46,19 @@ __export(index_exports, {
   TwinRuntime: () => TwinRuntime,
   UTC_OFFSET: () => UTC_OFFSET,
   WMS_NODE_TYPES: () => WMS_NODE_TYPES,
+  WMS_TYPES: () => WMS_TYPES,
   WmsKernel: () => WmsKernel,
   YARD_BIZSTEP: () => YARD_BIZSTEP,
   YMS_NODE_TYPES: () => YMS_NODE_TYPES,
+  YMS_TYPES: () => YMS_TYPES,
   YmsKernel: () => YmsKernel,
   aggregationEvent: () => aggregationEvent,
+  capabilitiesForType: () => capabilitiesForType,
   compareStates: () => compareStates,
+  computeOee: () => computeOee,
   constantDuration: () => constantDuration,
   counterfactualAt: () => counterfactualAt,
+  deriveAttentions: () => deriveAttentions,
   fefoPolicy: () => fefoPolicy,
   firstFitPolicy: () => firstFitPolicy,
   gdtiUri: () => gdtiUri,
@@ -63,8 +72,10 @@ __export(index_exports, {
   sgtinClass: () => sgtinClass,
   sgtinUri: () => sgtinUri,
   ssccUri: () => ssccUri,
+  stateFieldsOf: () => stateFieldsOf,
   transactionEvent: () => transactionEvent,
   transformationEvent: () => transformationEvent,
+  validateDomainDefinition: () => validateDomainDefinition,
   validateEpcisEvent: () => validateEpcisEvent
 });
 module.exports = __toCommonJS(index_exports);
@@ -73,14 +84,78 @@ module.exports = __toCommonJS(index_exports);
 var OP_EVENT = {
   task: "task.status",
   equipment: "equipment.status",
-  order: "order.status"
+  order: "order.status",
+  quality: "quality.output"
+  // 품질 산출(양품/불량) — OEE quality 입력. live 누적기가 이걸로 good/scrap 정확 추적.
 };
 var CMD = {
   orderHold: "order.hold",
   orderResume: "order.resume",
-  orderRelease: "order.release"
+  orderRelease: "order.release",
+  attentionAck: "attention.ack",
+  // 주목 신호 확인(OPC UA A&C acknowledge) — args:{id}
+  // Operable 코어 — 모든 operable 자원(설비·이동무버) 공통. args:{resourceId}. capability-keyed(무방언, equipment.* 아님).
+  resourceHold: "resource.hold",
+  // 계획 정지(정비/오프라인) — 배정 스킵
+  resourceResume: "resource.resume",
+  // 계획 정지 해제
+  resourceDown: "resource.down",
+  // 비계획 고장 주입 — args:{resourceId, durationMs?}
+  resourceRepair: "resource.repair",
+  // 즉시 수리
+  resourceResetMetrics: "resource.reset-metrics",
+  // OEE 계측 창 리셋
+  resourceAdd: "resource.add"
+  // 라이브 자원(무버) 추가 — args:{kind, homeNode, count?}. 런타임 구조 변이(what-if 아닌 실제 act)
 };
 
+// src/domain-definition.ts
+var INTENTS = ["transport", "process", "dwell"];
+function dupes(keys) {
+  const seen = /* @__PURE__ */ new Set();
+  const dup = /* @__PURE__ */ new Set();
+  for (const k of keys) {
+    if (seen.has(k)) dup.add(k);
+    else seen.add(k);
+  }
+  return [...dup];
+}
+function validateDomainDefinition(def) {
+  const v = [];
+  if (!def || typeof def !== "object") return ["domain definition \uC5C6\uC74C/\uAC1D\uCCB4 \uC544\uB2D8"];
+  if (typeof def.id !== "string" || !def.id) v.push("id \uB204\uB77D");
+  if (typeof def.label !== "string" || !def.label) v.push("label \uB204\uB77D");
+  if (!Array.isArray(def.nodeTypes) || def.nodeTypes.length === 0) v.push("nodeTypes \uBE44\uC5B4\uC788\uC74C");
+  if (!Array.isArray(def.resourceTypes)) v.push("resourceTypes \uBC30\uC5F4 \uC544\uB2D8");
+  const nodeKeys2 = new Set((def.nodeTypes || []).map((n) => n.key));
+  const resKeys = new Set((def.resourceTypes || []).map((r) => r.key));
+  const matKeys = new Set((def.materials || []).map((m) => m.key));
+  const opKeys = new Set((def.operations || []).map((o) => o.key));
+  const routeKeys = new Set((def.routes || []).map((r) => r.key));
+  for (const [name, arr] of [["nodeTypes", def.nodeTypes], ["resourceTypes", def.resourceTypes], ["materials", def.materials], ["operations", def.operations], ["routes", def.routes], ["recipes", def.recipes]]) {
+    for (const d of dupes((arr || []).map((x) => x.key))) v.push(`${name} \uD0A4 \uC911\uBCF5: ${d}`);
+  }
+  for (const o of def.operations || []) {
+    if (!INTENTS.includes(o.intent)) v.push(`operation '${o.key}' intent \uBD80\uC815: ${o.intent}`);
+    if (o.nodeType && !nodeKeys2.has(o.nodeType)) v.push(`operation '${o.key}' nodeType '${o.nodeType}' \uBBF8\uC815\uC758`);
+    if (o.resourceType && !resKeys.has(o.resourceType)) v.push(`operation '${o.key}' resourceType '${o.resourceType}' \uBBF8\uC815\uC758`);
+    if (o.intent === "dwell" && o.resourceType) v.push(`operation '${o.key}' dwell \uC778\uB370 resourceType \uC9C0\uC815\uB428(\uBB34\uC790\uC6D0\uC774\uC5B4\uC57C)`);
+  }
+  for (const r of def.routes || []) {
+    if (!Array.isArray(r.steps) || r.steps.length === 0) v.push(`route '${r.key}' steps \uBE44\uC5B4\uC788\uC74C`);
+    for (const s of r.steps || []) if (!opKeys.has(s)) v.push(`route '${r.key}' step '${s}' \uBBF8\uC815\uC758 operation`);
+  }
+  for (const rc of def.recipes || []) {
+    if (rc.route && !routeKeys.has(rc.route)) v.push(`recipe '${rc.key}' route '${rc.route}' \uBBF8\uC815\uC758`);
+    if (!rc.outputs?.length) v.push(`recipe '${rc.key}' outputs \uBE44\uC5B4\uC788\uC74C`);
+    for (const p of [...rc.inputs || [], ...rc.outputs || []]) {
+      if (!matKeys.has(p.material)) v.push(`recipe '${rc.key}' material '${p.material}' \uBBF8\uC815\uC758`);
+      if (typeof p.qty !== "number" || p.qty <= 0) v.push(`recipe '${rc.key}' material '${p.material}' qty \uBD80\uC815`);
+    }
+  }
+  return v;
+}
+
 // src/divergence.ts
 function diffBy(predicted, actual, idOf, valOf) {
   const p = new Map(predicted.map((e) => [idOf(e), valOf(e)]));
@@ -212,7 +287,7 @@ var StateProjector = class {
   orders = /* @__PURE__ */ new Map();
   revision = 0;
   constructor(board) {
-    for (const n of board.nodes) this.master.set(n.id, { id: n.id, type: n.type, capacity: n.capacity });
+    for (const n of board.nodes) this.master.set(n.id, { id: n.id, type: n.type, capacity: n.capacity, parentId: n.parentId });
     for (const m of board.movers) this.movers.set(m.id, { id: m.id, kind: m.kind, status: "idle", location: m.homeNode });
   }
   /** 마스터 동기 — 로케이션 추가/변경/제거. */
@@ -292,7 +367,7 @@ var StateProjector = class {
     for (const it of this.items.values()) occ.set(it.location, (occ.get(it.location) ?? 0) + 1);
     return {
       revision: this.revision,
-      nodes: [...this.master.values()].map((n) => ({ id: n.id, type: n.type, capacity: n.capacity, occupancy: occ.get(n.id) ?? 0 })),
+      nodes: [...this.master.values()].map((n) => ({ id: n.id, type: n.type, capacity: n.capacity, occupancy: occ.get(n.id) ?? 0, parentId: n.parentId })),
       items: [...this.items.values()].map((i) => ({ epc: i.epc, gtin: i.gtin, location: i.location, disposition: i.disposition })),
       tasks: [...this.tasks.values()].map((t) => ({ ...t })),
       movers: [...this.movers.values()].map((m) => ({ ...m })),
@@ -456,6 +531,58 @@ var BTT = {
   so: "urn:epcglobal:cbv:btt:so"
 };
 var WMS_NODE_TYPES = ["dock", "storage", "staging", "dock-ship"];
+var WMS_NODE_LABELS = { dock: "\uC785\uACE0 \uB3C4\uD06C", storage: "\uBCF4\uAD00 \uC704\uCE58", staging: "\uC2A4\uD14C\uC774\uC9D5", "dock-ship": "\uCD9C\uACE0 \uB3C4\uD06C" };
+var WMS_TYPES = [
+  ...WMS_NODE_TYPES.map((k) => ({ key: k, role: "node", label: WMS_NODE_LABELS[k] ?? k, standardClass: { epcis: "bizLocation" }, identity: { scheme: "gs1:SGLN" }, capabilities: ["storable"] })),
+  { key: "forklift", role: "mover", label: "\uC9C0\uAC8C\uCC28", standardClass: { epcis: "object", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["mobile", "operable"] }
+];
+
+// src/capability.ts
+var CAPABILITIES = {
+  operable: {
+    key: "operable",
+    label: "\uC6B4\uC601",
+    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.",
+    stateFields: ["status"],
+    results: ["statusChanged"]
+  },
+  storable: {
+    key: "storable",
+    label: "\uC800\uC7A5",
+    semantics: "\uC544\uC774\uD15C\uC744 \uBCF4\uC720\uD558\uB294 \uC704\uCE58 \u2014 \uC810\uC720/\uC6A9\uB7C9. (\uC52C \uAE30\uC81C: Capacity)",
+    stateFields: ["occupancy", "capacity"],
+    invariants: ["0 <= occupancy <= capacity (capacity>0)"],
+    results: ["occupancyChanged"]
+  },
+  mobile: {
+    key: "mobile",
+    label: "\uC774\uB3D9",
+    semantics: "\uC790\uC6D0 \uC790\uC2E0\uC774 \uB178\uB4DC \uAC04 \uC774\uB3D9. Transferable(\uC544\uC774\uD15C \uC774\uB3D9)\uACFC \uB2E4\uB984. (\uC52C \uAE30\uC81C: CarrierLine)",
+    stateFields: ["location", "motion"],
+    models: ["Motion"],
+    results: ["moved", "motionTick"]
+  },
+  processable: {
+    key: "processable",
+    label: "\uAC00\uACF5",
+    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.",
+    stateFields: ["output"],
+    results: ["completed"]
+  },
+  trackable: {
+    key: "trackable",
+    label: "\uCD94\uC801",
+    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.",
+    stateFields: ["lifecycle", "progress", "held"],
+    results: ["lifecycleChanged"]
+  }
+};
+var CAPABILITY_KEYS = ["operable", "storable", "mobile", "processable", "trackable"];
+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];
+}
 
 // src/yms-profile.ts
 var YARD_BIZSTEP = {
@@ -475,6 +602,11 @@ function graiUri(companyPrefix, assetType, serial) {
   return `urn:epc:id:grai:${companyPrefix}.${assetType}.${String(serial).padStart(6, "0")}`;
 }
 var YMS_NODE_TYPES = ["gate", "yard-slot", "dock-door", "staging"];
+var YMS_NODE_LABELS = { gate: "\uAC8C\uC774\uD2B8", "yard-slot": "\uC57C\uB4DC \uC2AC\uB86F", "dock-door": "\uB3C4\uD06C \uB3C4\uC5B4", staging: "\uC2A4\uD14C\uC774\uC9D5" };
+var YMS_TYPES = [
+  ...YMS_NODE_TYPES.map((k) => ({ key: k, role: "node", label: YMS_NODE_LABELS[k] ?? k, standardClass: { epcis: "bizLocation" }, identity: { scheme: "gs1:SGLN" }, capabilities: ["storable"] })),
+  { key: "hostler", role: "mover", label: "\uC57C\uB4DC \uD2B8\uB799\uD130", standardClass: { epcis: "object", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["mobile", "operable"] }
+];
 
 // src/mes-profile.ts
 var MES_BIZSTEP = {
@@ -489,15 +621,34 @@ var BTT_PRODORDER = "urn:epcglobal:cbv:btt:prodorder";
 function sgtinUri(companyPrefix, itemRef, serial) {
   return `urn:epc:id:sgtin:${companyPrefix}.${itemRef}.${serial}`;
 }
-var MES_NODE_TYPES = ["raw-store", "cut-station", "weld-station", "fg-store"];
+var MES_NODE_TYPES = ["raw-store", "cut-station", "weld-station", "paint-booth", "assembly-line", "fg-store"];
+var MES_NODE_META = {
+  "raw-store": { label: "\uC790\uC7AC \uCC3D\uACE0", cls: { epcis: "bizLocation" } },
+  "cut-station": { label: "\uD504\uB808\uC784 \uC808\uB2E8", cls: { isa95: "WorkCenter", epcis: "bizLocation" } },
+  "weld-station": { label: "\uC6A9\uC811", cls: { isa95: "WorkCenter", epcis: "bizLocation" } },
+  "paint-booth": { label: "\uB3C4\uC7A5", cls: { isa95: "WorkCenter", epcis: "bizLocation" } },
+  "assembly-line": { label: "\uC870\uB9BD\xB7\uC758\uC7A5", cls: { isa95: "WorkCenter", epcis: "bizLocation" } },
+  "fg-store": { label: "\uC644\uC131\uCC28 \uBCF4\uAD00", cls: { epcis: "bizLocation" } }
+};
+var MES_TYPES = [
+  ...MES_NODE_TYPES.map((k) => ({ key: k, role: "node", label: MES_NODE_META[k]?.label ?? k, standardClass: MES_NODE_META[k]?.cls ?? {}, identity: { scheme: "gs1:SGLN" }, capabilities: ["storable"] })),
+  { key: "cutter", role: "mover", label: "\uC808\uB2E8 \uC124\uBE44", standardClass: { isa95: "Equipment", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] },
+  { key: "welder", role: "mover", label: "\uC6A9\uC811 \uB85C\uBD07", standardClass: { isa95: "Equipment", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] },
+  { key: "painter", role: "mover", label: "\uB3C4\uC7A5 \uB85C\uBD07", standardClass: { isa95: "Equipment", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] },
+  { key: "assembler", role: "mover", label: "\uC870\uB9BD \uC124\uBE44", standardClass: { isa95: "Equipment", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] }
+];
 
 // src/domain-catalog.ts
+var nodeKeys = (types) => types.filter((t) => t.role === "node").map((t) => t.key);
 var DOMAIN_CATALOG = {
-  wms: { system: "wms", label: "WMS (\uBB3C\uB958\uCC3D\uACE0)", nodeTypes: WMS_NODE_TYPES },
-  yms: { system: "yms", label: "YMS (\uC57C\uB4DC)", nodeTypes: YMS_NODE_TYPES },
-  mes: { system: "mes", label: "MES (\uC81C\uC870)", nodeTypes: MES_NODE_TYPES }
+  wms: { system: "wms", label: "WMS (\uBB3C\uB958\uCC3D\uACE0)", types: WMS_TYPES, nodeTypes: nodeKeys(WMS_TYPES) },
+  yms: { system: "yms", label: "YMS (\uC57C\uB4DC)", types: YMS_TYPES, nodeTypes: nodeKeys(YMS_TYPES) },
+  mes: { system: "mes", label: "MES (\uC81C\uC870)", types: MES_TYPES, nodeTypes: nodeKeys(MES_TYPES) }
 };
 var DOMAIN_SYSTEMS = ["wms", "yms", "mes"];
+function capabilitiesForType(system, typeKey) {
+  return DOMAIN_CATALOG[system]?.types.find((t) => t.key === typeKey)?.capabilities ?? [];
+}
 
 // src/allocation-policy.ts
 function freeBinsFirstFit(slots) {
@@ -646,6 +797,103 @@ function mulberry32(seed) {
   } });
   return fn;
 }
+function deriveAttentions(view, acked) {
+  const out = [];
+  for (const m of view.movers) {
+    if (m.status === "down") {
+      const where = m.location ?? "\uD574\uB2F9 \uACF5\uC815";
+      out.push({
+        id: `breakdown:${m.id}`,
+        kind: "breakdown",
+        severity: "critical",
+        title: `\uC124\uBE44 \uACE0\uC7A5 \xB7 ${m.id}`,
+        anchor: { moverId: m.id, nodeId: m.location },
+        rationale: `\uC124\uBE44 \uC815\uC9C0 \u2014 ${where}\uC758 \uC791\uC5C5\uC774 \uC911\uB2E8\uB418\uC5B4 \uD558\uB958 \uC815\uCCB4\xB7\uCC98\uB9AC\uB7C9 \uAC10\uC18C\uB85C \uC774\uC5B4\uC9D1\uB2C8\uB2E4.`,
+        recommendedActions: [
+          { label: "\uC218\uB9AC \uC9C0\uC2DC", command: CMD.resourceRepair, args: { resourceId: m.id }, hint: "\uC124\uBE44\uB97C \uC989\uC2DC \uBCF5\uAD6C\uD574 \uAC00\uB3D9 \uC7AC\uAC1C" },
+          { label: "\uACC4\uD68D \uC815\uC9C0 \uC720\uC9C0", command: CMD.resourceHold, args: { resourceId: m.id }, hint: "\uC218\uB9AC \uC804\uAE4C\uC9C0 \uBC30\uC815\uC5D0\uC11C \uC81C\uC678" }
+        ],
+        suggestedAction: { command: CMD.resourceRepair, args: { resourceId: m.id }, label: "\uC218\uB9AC" }
+      });
+    }
+  }
+  for (const n of view.nodes) {
+    if ((n.capacity ?? 0) > 0) {
+      const r = (n.occupancy ?? 0) / n.capacity;
+      if (r >= 0.9) {
+        const saturated = r >= 1;
+        out.push({
+          id: `bottleneck:${n.id}`,
+          kind: "bottleneck",
+          severity: saturated ? "high" : "medium",
+          title: `${saturated ? "\uBCD1\uBAA9" : "\uD63C\uC7A1"} \xB7 ${n.id} \uC810\uC720 ${n.occupancy}/${n.capacity}`,
+          anchor: { nodeId: n.id },
+          rationale: `${n.id} \uC810\uC720 ${Math.round(r * 100)}% \u2014 \uC0C1\uB958 \uB300\uAE30\uAC00 \uC313\uC5EC \uB9AC\uB4DC\uD0C0\uC784\uC774 \uB298\uACE0 \uCC98\uB9AC\uB7C9\uC774 \uC81C\uD55C\uB429\uB2C8\uB2E4.`,
+          recommendedActions: [
+            { label: "\uC790\uC6D0 \uCD94\uAC00 \uAC80\uD1A0", hint: "\uBB34\uBC84\xB7\uCC98\uB9AC \uB2A5\uB825\uC744 \uBCF4\uAC15\uD574 \uBCD1\uBAA9 \uC644\uD654" },
+            { label: "\uD558\uB958 \uC6B0\uC120 \uCC98\uB9AC", hint: "\uC801\uCCB4 \uD574\uC18C\uB97C \uC704\uD574 \uBC30\uCD9C \uC6B0\uC120\uC21C\uC704 \uC870\uC815" }
+          ]
+        });
+      }
+    }
+  }
+  for (const m of view.movers) {
+    const total = (m.goodCount ?? 0) + (m.scrapCount ?? 0);
+    if (total >= 10) {
+      const rate = (m.scrapCount ?? 0) / total;
+      if (rate >= 0.15) out.push({
+        id: `scrap:${m.id}`,
+        kind: "scrap-high",
+        severity: rate >= 0.3 ? "high" : "medium",
+        title: `\uBD88\uB7C9\uB960 ${Math.round(rate * 100)}% \xB7 ${m.id}`,
+        detail: `\uC591\uD488 ${m.goodCount} / \uBD88\uB7C9 ${m.scrapCount}`,
+        anchor: { moverId: m.id, nodeId: m.location },
+        rationale: `\uBD88\uB7C9\uB960 ${Math.round(rate * 100)}% \u2014 \uC7AC\uC791\uC5C5\xB7\uC218\uC728 \uC190\uC2E4\uC774 \uB204\uC801\uB429\uB2C8\uB2E4. \uC124\uBE44 \uC0C1\uD0DC\xB7\uC14B\uC5C5 \uD3B8\uCC28\uB97C \uC810\uAC80\uD558\uC138\uC694.`,
+        recommendedActions: [
+          { label: "\uC124\uBE44 \uC810\uAC80 \uC815\uC9C0", command: CMD.resourceHold, args: { resourceId: m.id }, hint: "\uC810\uAC80\uC744 \uC704\uD574 \uBC30\uC815\uC5D0\uC11C \uC81C\uC678" },
+          { label: "\uACC4\uCE21 \uB9AC\uC14B", command: CMD.resourceResetMetrics, args: { resourceId: m.id }, hint: "\uAD50\uC815 \uD6C4 \uC218\uC728 \uC7AC\uCE21\uC815" }
+        ],
+        suggestedAction: { command: CMD.resourceHold, args: { resourceId: m.id }, label: "\uC810\uAC80 \uC815\uC9C0" }
+      });
+    }
+  }
+  for (const o of view.orders) {
+    if (o.held) out.push({
+      id: `hold:${o.id}`,
+      kind: "hold",
+      severity: "medium",
+      title: `\uC624\uB354 \uBCF4\uB958 \xB7 ${o.id}`,
+      anchor: { orderId: o.id },
+      rationale: `\uC624\uB354 \uC9C4\uD589\uC774 \uBA48\uCDA4 \u2014 \uB0A9\uAE30 \uC9C0\uC5F0 \uC704\uD5D8. \uBCF4\uB958 \uC0AC\uC720 \uD574\uC18C \uD6C4 \uC7AC\uAC1C\uD558\uC138\uC694.`,
+      recommendedActions: [{ label: "\uC7AC\uAC1C", command: CMD.orderResume, args: { orderId: o.id }, hint: "\uBCF4\uB958\uB97C \uD480\uACE0 \uD750\uB984 \uC7AC\uAC1C" }],
+      suggestedAction: { command: CMD.orderResume, args: { orderId: o.id }, label: "\uC7AC\uAC1C" }
+    });
+  }
+  if (acked) {
+    for (const a of out) if (acked.has(a.id)) a.state = "acknowledged";
+  }
+  return out;
+}
+function computeOee(c, nowMs) {
+  const planned = Math.max(0, nowMs - (c.metricsSinceMs ?? 0) - (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 FlowEngine = class {
   tenantId;
   nodes = /* @__PURE__ */ new Map();
@@ -674,7 +922,7 @@ var FlowEngine = class {
   }
   // ── TwinKernel (mechanics, 도메인 무관) ───────────────────────────────────
   loadBoard(def) {
-    for (const n of def.nodes) this.nodes.set(n.id, { id: n.id, type: n.type, capacity: n.capacity, occupancy: 0, status: "idle" });
+    for (const n of def.nodes) this.nodes.set(n.id, { id: n.id, type: n.type, capacity: n.capacity, occupancy: 0, status: "idle", parentId: n.parentId });
     for (const m of def.movers) {
       const mover = { id: m.id, kind: m.kind, location: m.homeNode, status: "idle", taskId: null, runMs: 0, setupMs: 0, downMs: 0, goodCount: 0, scrapCount: 0 };
       if (m.mtbfMs !== void 0) {
@@ -685,6 +933,54 @@ var FlowEngine = class {
       this.movers.set(m.id, mover);
     }
   }
+  /**
+   * what-if 구성 변주 — fork(또는 실행 중) 엔진에 무버 추가. loadBoard 무버 삽입과 동일 규약.
+   * 기본은 mtbf 미지정(고장 없는 신뢰 자원) → sampleExp(rng) 무소비라 baseline fork 와 깨끗이 비교 가능.
+   */
+  addMover(m) {
+    if (this.movers.has(m.id)) return;
+    const mover = { id: m.id, kind: m.kind, location: m.homeNode, status: "idle", taskId: null, runMs: 0, setupMs: 0, downMs: 0, goodCount: 0, scrapCount: 0 };
+    if (m.mtbfMs !== void 0) {
+      mover.mtbfMs = m.mtbfMs;
+      mover.mttrMs = m.mttrMs;
+      mover.nextFailureMs = this.sampleExp(m.mtbfMs);
+    }
+    this.movers.set(m.id, mover);
+  }
+  /**
+   * 관측 상태 주입(라이브 예측용, kernel-unification P1) — 외부 관측 스냅샷(재고·무버·노드)과
+   * 저널 오더(원값+라인)로 이 커널의 맵을 채운다. tick 으로 만든 게 아니라 "현재 관측된 현실"을 심어
+   * 이후 fork/tick 으로 예측한다. 라이브 런타임은 여전히 projector 미러 — 이 커널은 예측용 임시본.
+   * 오더는 남은 데맨드(라인별 requested-fulfilled)를 'created' 로 복원(현재 재고에서 재계획).
+   * 진행 중 개별 task 의 내부 상태는 관측만으론 복원 불가 → 재계획에 맡김(정직한 한계).
+   */
+  hydrateObserved(snap, orders = []) {
+    for (const n of snap.nodes) this.nodes.set(n.id, { id: n.id, type: n.type, capacity: n.capacity ?? 0, occupancy: n.occupancy ?? 0, status: "idle", parentId: n.parentId });
+    this.items.clear();
+    for (const it of snap.items) this.items.set(it.epc, { epc: it.epc, location: it.location, disposition: it.disposition ?? DISP.sellable, gtin: it.gtin, qty: it.qty ?? 1 });
+    for (const m of snap.movers) this.movers.set(m.id, { id: m.id, kind: m.kind, location: m.location ?? "", status: "idle", taskId: null, runMs: 0, setupMs: 0, downMs: 0, goodCount: 0, scrapCount: 0 });
+    for (const o of orders) {
+      const lines = (o.lines ?? []).map((l) => ({ gtin: l.gtin, requested: l.requested - (l.fulfilled ?? 0) })).filter((l) => l.requested > 0);
+      const remaining = lines.reduce((s, l) => s + l.requested, 0);
+      if (remaining <= 0) continue;
+      this.orders.set(o.orderId, { id: o.orderId, kind: o.kind, status: "created", requested: remaining, fulfilled: 0, bizTransaction: "", allocated: [], picked: [], shipmentEpc: null, lines });
+    }
+  }
+  /** what-if 구성 변주 — 노드 용량 변경(fork 대상). 존재하면 true. */
+  setNodeCapacity(nodeId, capacity) {
+    const n = this.nodes.get(nodeId);
+    if (!n) return false;
+    n.capacity = Math.max(0, capacity);
+    return true;
+  }
+  /**
+   * forecast 몬테카를로 — fork 의 RNG 만 재시드(시나리오·상태·gens·in-flight 는 보존).
+   * "현재 조건 지속"을 유지한 채 **미래 확률만** 변주(도착·고장 타이밍 등) → run 마다 다른 표본.
+   * (monteCarloForecast 은 scenario.load 로 gens 를 갈아끼우므로 "현재 조건"이 깨진다 — 그 대안.)
+   */
+  reseed(seed) {
+    this.rng = mulberry32(seed >>> 0);
+  }
   onEvent(handler) {
     this.handlers.push(handler);
     return () => {
@@ -697,6 +993,8 @@ var FlowEngine = class {
    * 도메인 커맨드(order.release 등)는 handleCommand 로 위임. 커맨드는 sim 상태를 변이하고
    * State 델타를 유발한다(command → 행위 → 관측 폐루프).
    */
+  _acked = /* @__PURE__ */ new Set();
+  // 확인(ack)된 주목 신호 id — 조건 지속돼도 acknowledged 로 표시(재발 시 재활성)
   dispatch(cmd) {
     const ok = () => ({ commandId: cmd.commandId, accepted: true });
     const fail = (error) => ({ commandId: cmd.commandId, accepted: false, error });
@@ -710,6 +1008,70 @@ var FlowEngine = class {
         this.emitOrder(order);
         return ok();
       }
+      case CMD.attentionAck: {
+        const id = cmd.args?.id;
+        if (id) this._acked.add(id);
+        return ok();
+      }
+      // Operable 코어 — 자원(설비·무버) 제어. capability-keyed(resourceId), 모든 operable 자원 공통.
+      case CMD.resourceHold:
+      case CMD.resourceResume: {
+        const m = this.movers.get(cmd.args?.resourceId ?? "");
+        if (!m) return fail("resource \uC5C6\uC74C");
+        m.held = cmd.type === CMD.resourceHold;
+        this.emitMover(m);
+        return ok();
+      }
+      case CMD.resourceDown: {
+        const a = cmd.args;
+        const m = this.movers.get(a?.resourceId ?? "");
+        if (!m) return fail("resource \uC5C6\uC74C");
+        if (m.status !== "down") {
+          m.status = "down";
+          m.repairUntilMs = this.clockMs + (Number(a?.durationMs) || m.mttrMs || 6e4);
+          this.emitMover(m);
+        }
+        return ok();
+      }
+      case CMD.resourceRepair: {
+        const m = this.movers.get(cmd.args?.resourceId ?? "");
+        if (!m) return fail("resource \uC5C6\uC74C");
+        if (m.status === "down") {
+          m.status = m.taskId ? "busy" : "idle";
+          m.repairUntilMs = void 0;
+          if (m.mtbfMs !== void 0) m.nextFailureMs = this.clockMs + this.sampleExp(m.mtbfMs);
+          this.emitMover(m);
+        }
+        return ok();
+      }
+      case CMD.resourceResetMetrics: {
+        const m = this.movers.get(cmd.args?.resourceId ?? "");
+        if (!m) return fail("resource \uC5C6\uC74C");
+        m.runMs = 0;
+        m.setupMs = 0;
+        m.downMs = 0;
+        m.goodCount = 0;
+        m.scrapCount = 0;
+        m.holdMs = 0;
+        m.metricsSinceMs = this.clockMs;
+        this.emitMover(m);
+        return ok();
+      }
+      case CMD.resourceAdd: {
+        const a = cmd.args;
+        if (!a?.kind) return fail("kind \uD544\uC694");
+        if (!a?.homeNode || !this.nodes.has(a.homeNode)) return fail(`homeNode \uC5C6\uC74C: ${a?.homeNode}`);
+        const count = Math.max(1, Math.min(50, Number(a.count) || 1));
+        let seq = this.movers.size;
+        for (let i = 0; i < count; i++) {
+          let id = `${a.kind}-${++seq}`;
+          while (this.movers.has(id)) id = `${a.kind}-${++seq}`;
+          this.addMover({ id, kind: a.kind, homeNode: a.homeNode });
+          const m = this.movers.get(id);
+          if (m) this.emitMover(m);
+        }
+        return ok();
+      }
       default:
         return this.handleCommand(cmd);
     }
@@ -755,15 +1117,30 @@ var FlowEngine = class {
       nodes: [...this.nodes.values()].map((n) => ({ ...n })),
       items: [...this.items.values()].map((i) => ({ epc: i.epc, gtin: i.gtin, qty: i.qty, location: i.location, disposition: i.disposition, expiry: i.expiry })),
       movers: [...this.movers.values()].map((m) => {
-        const s = { id: m.id, kind: m.kind, location: m.location, status: m.status, taskId: m.taskId ?? void 0, oee: this.oeeOf(m) };
+        const s = { id: m.id, kind: m.kind, location: m.location, status: m.status, taskId: m.taskId ?? void 0, oee: this.oeeOf(m), held: m.held };
         const t = m.taskId ? this.tasks.get(m.taskId) : void 0;
         if (t && t.status === "in-progress" && t.intent !== "process") s.motion = { fromNode: t.fromNode, toNode: t.toNode, startedAtSimMs: this.clockMs - (t.durationMs - t.remainingMs), durationMs: t.durationMs, progress: this.progressOf(t), elapsedMs: t.durationMs - t.remainingMs };
         return s;
       }),
-      tasks: [...this.tasks.values()].map((t) => ({ id: t.id, kind: t.kind, status: t.status, itemRefs: [t.itemEpc], fromNode: t.fromNode, toNode: t.toNode, resourceRef: t.resource ?? void 0, progress: t.status === "in-progress" ? this.progressOf(t) : void 0 })),
-      orders: [...this.orders.values()].map((o) => ({ id: o.id, kind: o.kind, status: o.status, progress: o.requested ? o.fulfilled / o.requested : 0, held: o.held }))
+      tasks: [...this.tasks.values()].map((t) => ({ id: t.id, kind: t.kind, status: t.status, itemRefs: [t.itemEpc], fromNode: t.fromNode, toNode: t.toNode, resourceRef: t.resource ?? void 0, orderId: t.orderId, progress: t.status === "in-progress" ? this.progressOf(t) : void 0 })),
+      orders: [...this.orders.values()].map((o) => ({ id: o.id, kind: o.kind, status: o.status, progress: o.requested ? o.fulfilled / o.requested : 0, held: o.held })),
+      attentions: this.computeAttentions()
     };
   }
+  /*
+   * 주목 신호 판단 — 상태(노드·무버·오더)에서 도메인 조건을 평가해 Attention 방출.
+   * severity=ISA-18.2 우선순위 계열, kind=도메인 라벨. UI 는 판단 안 함(임계값 여기 소유).
+   * 도메인별 추가 판단은 서브클래스가 override 로 확장(super.computeAttentions() 합성).
+   */
+  computeAttentions() {
+    const out = deriveAttentions(
+      { movers: [...this.movers.values()], nodes: [...this.nodes.values()], orders: [...this.orders.values()] },
+      this._acked
+    );
+    const present = new Set(out.map((a) => a.id));
+    for (const id of [...this._acked]) if (!present.has(id)) this._acked.delete(id);
+    return out;
+  }
   /**
    * fork — 현재 상태를 정확히 복제한 새 엔진 (디지털트윈 본연: "현재로부터 예측").
    * 원본(live/sim)은 계속 진행, fork 는 what-if 를 앞으로 굴려 forecast·발산(predicted vs actual) 검사에 쓴다.
@@ -883,27 +1260,11 @@ var FlowEngine = class {
     if (!m) return;
     if (good) m.goodCount++;
     else m.scrapCount++;
+    this.emitOp(OP_EVENT.quality, { moverId: m.id, good, goodCount: m.goodCount, scrapCount: m.scrapCount });
   }
   /** 무버 OEE(스냅샷 파생) — Availability×Performance×Quality. planned = 설비 존재 sim 시간(clockMs). */
   oeeOf(m) {
-    const planned = this.clockMs;
-    const uptime = Math.max(0, planned - m.setupMs - m.downMs);
-    const availability = planned > 0 ? uptime / planned : 1;
-    const performance = uptime > 0 ? Math.min(1, m.runMs / uptime) : m.runMs > 0 ? 1 : 0;
-    const totalQ = m.goodCount + m.scrapCount;
-    const quality = totalQ > 0 ? m.goodCount / totalQ : 1;
-    return {
-      availability,
-      performance,
-      quality,
-      overall: availability * performance * quality,
-      runMs: m.runMs,
-      setupMs: m.setupMs,
-      downMs: m.downMs,
-      idleMs: Math.max(0, uptime - m.runMs),
-      goodCount: m.goodCount,
-      scrapCount: m.scrapCount
-    };
+    return computeOee(m, this.clockMs);
   }
   /** 정책에 넘길 특정 타입 노드의 관측 뷰 — 예약(그 노드로 향하는 in-flight task) 포함. */
   slotViews(nodeType) {
@@ -924,7 +1285,7 @@ var FlowEngine = class {
     for (const h of this.handlers) h(e);
   }
   emitTask(t) {
-    this.emitOp(OP_EVENT.task, { taskId: t.id, kind: t.kind, status: t.status, fromNode: t.fromNode, toNode: t.toNode, itemRefs: [t.itemEpc], resourceRef: t.resource ?? void 0 });
+    this.emitOp(OP_EVENT.task, { taskId: t.id, orderId: t.orderId, kind: t.kind, status: t.status, fromNode: t.fromNode, toNode: t.toNode, itemRefs: [t.itemEpc], resourceRef: t.resource ?? void 0 });
   }
   emitMover(m, motion) {
     this.emitOp(OP_EVENT.equipment, { moverId: m.id, kind: m.kind, status: m.status, location: m.location, motion });
@@ -948,16 +1309,21 @@ var FlowEngine = class {
    */
   processFailures(dt) {
     for (const m of this.movers.values()) {
-      if (m.mtbfMs === void 0) continue;
       if (m.status === "down") {
         m.downMs += dt;
-        if (this.clockMs >= (m.repairUntilMs ?? 0)) {
+        if (m.repairUntilMs != null && this.clockMs >= m.repairUntilMs) {
           m.status = m.taskId ? "busy" : "idle";
           m.repairUntilMs = void 0;
-          m.nextFailureMs = this.clockMs + this.sampleExp(m.mtbfMs);
+          if (m.mtbfMs !== void 0) m.nextFailureMs = this.clockMs + this.sampleExp(m.mtbfMs);
           this.emitMover(m);
         }
-      } else if (this.clockMs >= (m.nextFailureMs ?? Infinity)) {
+        continue;
+      }
+      if (m.held) {
+        if (m.status === "idle") m.holdMs = (m.holdMs ?? 0) + dt;
+        continue;
+      }
+      if (m.mtbfMs !== void 0 && this.clockMs >= (m.nextFailureMs ?? Infinity)) {
         m.status = "down";
         m.repairUntilMs = this.clockMs + this.sampleExp(m.mttrMs ?? m.mtbfMs);
         m.nextFailureMs = void 0;
@@ -971,8 +1337,9 @@ var FlowEngine = class {
   generate() {
     for (const g of this.gens) {
       while (this.clockMs >= g.nextMs) {
-        if (g.spec.kind === "inbound-arrival") this.onArrival(g.spec);
-        else if (g.spec.kind === "outbound-order") this.onOrder(g.spec);
+        const stimulus = g.spec.stimulus ?? (g.spec.kind === "outbound-order" ? "order" : "arrival");
+        if (stimulus === "order") this.onOrder(g.spec);
+        else this.onArrival(g.spec);
         g.nextMs += this.intervalMs(g.spec);
       }
     }
@@ -989,7 +1356,7 @@ var FlowEngine = class {
         this.emitTask(t);
         continue;
       }
-      const mover = [...this.movers.values()].find((m) => m.status === "idle" && (t.resourceType === void 0 || m.kind === t.resourceType));
+      const mover = [...this.movers.values()].find((m) => m.status === "idle" && !m.held && (t.resourceType === void 0 || m.kind === t.resourceType));
       if (!mover) continue;
       if (t.setupMs && t.changeoverKey !== void 0 && mover.lastChangeoverKey !== void 0 && mover.lastChangeoverKey !== t.changeoverKey) {
         t.appliedSetupMs = t.setupMs;
@@ -1347,6 +1714,7 @@ var YmsKernel = class extends FlowEngine {
 // src/mes-kernel.ts
 var CYCLE_MS = 4e4;
 var SETUP_MS = 15e3;
+var MES_CMD = { changeover: "mes.changeover" };
 var CP2 = "0614141";
 var WIP_ITEMREF = "066666";
 var WIP_GTIN = sgtinClass(CP2, WIP_ITEMREF);
@@ -1359,17 +1727,49 @@ var PRODUCTS = [
 ];
 var MES_PART_GTINS = { partA: PART_A.gtin, partB: PART_B.gtin };
 var MES_PRODUCT_GTINS = { p1: PRODUCTS[0].gtin, p2: PRODUCTS[1].gtin };
+var MES_PRODUCTS = PRODUCTS.map((p) => ({ gtin: p.gtin, label: p.key }));
+var ROUTE = [
+  { kind: "cut", node: "cut-station", resource: "cutter" },
+  { kind: "weld", node: "weld-station", resource: "welder" },
+  { kind: "paint", node: "paint-booth", resource: "painter" },
+  { kind: "assembly", node: "assembly-line", resource: "assembler" }
+];
 var MesKernel = class extends FlowEngine {
   wipSeq = 0;
   prodSeq = 0;
-  constructor(tenantId, policy = firstFitPolicy) {
+  /** 정의-구동 모드(선택). 미지정 시 레거시 하드코딩 경로 — byte-identical. */
+  mesSpec;
+  constructor(tenantId, policy = firstFitPolicy, mesSpec) {
     super(tenantId, policy);
+    this.mesSpec = mesSpec;
   }
   productOf(gtin) {
     return PRODUCTS.find((p) => p.gtin === gtin);
   }
+  /**
+   * MES 도메인 커맨드(Tier 2) — mes.changeover: 설비를 제품 gtin 으로 강제 전환.
+   * 자동 체인지오버(task.changeoverKey 상이 시 셋업)의 수동 버전 — 운영자가 사전 전환(툴링 교체) 지시.
+   * 이미 그 제품이면 no-op, 아니면 셋업(SETUP_MS, OEE 가용성 손실) + lastChangeoverKey 각인
+   * (이후 그 제품 task 는 자동 셋업 생략). command → 변이 → State 델타(폐루프).
+   */
+  handleCommand(cmd) {
+    if (cmd.type === MES_CMD.changeover) {
+      const a = cmd.args;
+      if (!a?.resourceId || !a?.gtin) return { commandId: cmd.commandId, accepted: false, error: "mes.changeover: resourceId\xB7gtin \uD544\uC694" };
+      const m = this.movers.get(a.resourceId);
+      if (!m) return { commandId: cmd.commandId, accepted: false, error: `resource \uC5C6\uC74C: ${a.resourceId}` };
+      if (m.lastChangeoverKey !== a.gtin) {
+        m.setupMs += SETUP_MS;
+        m.lastChangeoverKey = a.gtin;
+        this.emitMover(m);
+      }
+      return { commandId: cmd.commandId, accepted: true };
+    }
+    return super.handleCommand(cmd);
+  }
   /** 부품 수령(다품종) — skuMix 의 gtin 으로 부품 종류 결정. */
   onArrival(spec) {
+    if (this.mesSpec) return this.onArrivalDef(spec);
     const rawStore = this.nodeByType("raw-store");
     if (!rawStore) return;
     const gtin = this.pickGtin(spec.content.skuMix);
@@ -1382,6 +1782,7 @@ var MesKernel = class extends FlowEngine {
   }
   /** 작업지시 — 제품 2종 교대(체인지오버 유발). 제품 gtin 을 오더에 기록. */
   onOrder(_spec) {
+    if (this.mesSpec) return this.onOrderDef(_spec);
     const product = PRODUCTS[this.orderSeq % PRODUCTS.length];
     const id = `order-${++this.orderSeq}`;
     const wo = gdtiUri(CP2, "403", ++this.soSeq);
@@ -1389,11 +1790,13 @@ var MesKernel = class extends FlowEngine {
     this.orders.set(id, order);
     this.emitOrder(order);
   }
-  /** 할당 — 제품 BOM 각 라인의 부품 예약(하나라도 부족하면 대기) + op1(cut, 체인지오버 셋업). */
+  /** 할당 — 제품 BOM 각 라인의 부품 예약(하나라도 부족하면 대기) + 라우트 첫 스테이션(절단) 태스크. */
   allocate(o) {
-    const cut = this.nodeByType("cut-station");
+    if (this.mesSpec) return this.allocateDef(o);
+    const s0 = ROUTE[0];
+    const first = this.nodeByType(s0.node);
     const product = this.productOf(o.gtin);
-    if (!cut || !product) return;
+    if (!first || !product) return;
     const picks = [];
     for (const line of product.bom) {
       const available = [...this.items.values()].filter((i) => i.gtin === line.part.gtin && i.disposition === DISP.sellable && this.nodes.get(i.location)?.type === "raw-store").map((i) => ({ epc: i.epc, location: i.location, qty: 1 }));
@@ -1406,40 +1809,146 @@ var MesKernel = class extends FlowEngine {
       o.allocated.push(epc);
     }
     this.emit(transactionEvent({ eventTime: this.now(), action: "ADD", bizStep: MES_BIZSTEP.producing, bizTransactionList: [{ type: BTT_PRODORDER, bizTransaction: o.bizTransaction }], epcList: o.allocated.slice() }));
-    const task = { id: `task-${++this.taskSeq}`, kind: "cut", status: "created", itemEpc: o.allocated[0], fromNode: cut.id, toNode: cut.id, resource: null, remainingMs: 0, durationMs: this.durationOf({ kind: "cut", fromNode: cut.id, toNode: cut.id, resourceKind: "cutter" }, CYCLE_MS), orderId: o.id, resourceType: "cutter", changeoverKey: product.gtin, setupMs: SETUP_MS, intent: "process" };
+    this.emitStation(o, s0, o.allocated[0], product.gtin);
+    o.status = "op-" + s0.kind;
+    this.emitOrder(o);
+  }
+  /** 라우트 스테이션 태스크 발행(공통) — 제자리 가공(process), 이종 자원, 제품 전환 셋업. */
+  emitStation(o, stage, itemEpc, changeoverKey) {
+    const node = this.nodeByType(stage.node);
+    const task = { id: `task-${++this.taskSeq}`, kind: stage.kind, status: "created", itemEpc, fromNode: node.id, toNode: node.id, resource: null, remainingMs: 0, durationMs: this.durationOf({ kind: stage.kind, fromNode: node.id, toNode: node.id, resourceKind: stage.resource }, CYCLE_MS), orderId: o.id, resourceType: stage.resource, changeoverKey, setupMs: SETUP_MS, intent: "process" };
     this.tasks.set(task.id, task);
     this.emitTask(task);
-    o.status = "op-cut";
-    this.emitOrder(o);
   }
-  /** op 완료 = 변환. cut: BOM 부품 소비 → WIP. weld: WIP → 완제품(수율: 양품/불량 → OEE 품질 보고). */
+  /** op 완료 = 변환. 라우트 인덱스로 분기: 첫=BOM 소비→WIP, 중간=WIP→WIP, 마지막(조립)=WIP→완성차(수율→OEE 품질). */
   onTaskComplete(t) {
+    if (this.mesSpec) return this.onTaskCompleteDef(t);
     const order = this.orders.get(t.orderId);
     const product = this.productOf(order.gtin);
-    const eventTime = this.now();
-    if (t.kind === "cut") {
-      const cut = this.nodes.get(t.toNode);
-      const weld2 = this.nodeByType("weld-station");
+    const i = ROUTE.findIndex((s) => s.kind === t.kind);
+    const node = this.nodes.get(t.toNode);
+    const isLast = i === ROUTE.length - 1;
+    if (!isLast) {
       const inputs = order.allocated.slice();
       const wip2 = sgtinUri(CP2, WIP_ITEMREF, ++this.wipSeq);
-      this.transform(inputs, [{ epc: wip2, gtin: WIP_GTIN, qty: 1, location: cut.id, disposition: DISP.in_progress }], { bizStep: MES_BIZSTEP.producing, disposition: DISP.in_progress, transformationId: order.bizTransaction, readPoint: cut.id, bizTransactionList: [{ type: BTT_PRODORDER, bizTransaction: order.bizTransaction }] });
+      this.transform(inputs, [{ epc: wip2, gtin: WIP_GTIN, qty: 1, location: node.id, disposition: DISP.in_progress }], { bizStep: MES_BIZSTEP.producing, disposition: DISP.in_progress, transformationId: order.bizTransaction, readPoint: node.id, bizTransactionList: [{ type: BTT_PRODORDER, bizTransaction: order.bizTransaction }] });
       order.allocated = [wip2];
-      const wtask = { id: `task-${++this.taskSeq}`, kind: "weld", status: "created", itemEpc: wip2, fromNode: weld2.id, toNode: weld2.id, resource: null, remainingMs: 0, durationMs: this.durationOf({ kind: "weld", fromNode: weld2.id, toNode: weld2.id, resourceKind: "welder" }, CYCLE_MS), orderId: order.id, resourceType: "welder", changeoverKey: product.gtin, setupMs: SETUP_MS, intent: "process" };
-      this.tasks.set(wtask.id, wtask);
-      this.emitTask(wtask);
-      order.status = "op-weld";
+      const next = ROUTE[i + 1];
+      this.emitStation(order, next, wip2, product.gtin);
+      order.status = "op-" + next.kind;
       this.emitOrder(order);
       return;
     }
-    const weld = this.nodes.get(t.toNode);
     const fgStore = this.nodeByType("fg-store");
     const wip = order.allocated[0];
     const good = this.rng() < YIELD;
     this.recordOutput(t.resource, good);
     const disp = good ? DISP.sellable : DISP.non_sellable;
     const outputEpc = sgtinUri(CP2, product.ref, ++this.prodSeq);
-    this.transform([wip], [{ epc: outputEpc, gtin: product.gtin, qty: 1, location: fgStore.id, disposition: disp }], { bizStep: MES_BIZSTEP.producing, disposition: disp, transformationId: order.bizTransaction, readPoint: weld.id, bizTransactionList: [{ type: BTT_PRODORDER, bizTransaction: order.bizTransaction }] });
-    this.emit(objectEvent({ eventTime, action: "OBSERVE", bizStep: MES_BIZSTEP.storing, disposition: disp, epcList: [outputEpc], quantityList: [{ epcClass: product.gtin, quantity: 1 }], readPoint: fgStore.id, bizLocation: fgStore.id }));
+    this.transform([wip], [{ epc: outputEpc, gtin: product.gtin, qty: 1, location: fgStore.id, disposition: disp }], { bizStep: MES_BIZSTEP.producing, disposition: disp, transformationId: order.bizTransaction, readPoint: node.id, bizTransactionList: [{ type: BTT_PRODORDER, bizTransaction: order.bizTransaction }] });
+    this.emit(objectEvent({ eventTime: this.now(), action: "OBSERVE", bizStep: MES_BIZSTEP.storing, disposition: disp, epcList: [outputEpc], quantityList: [{ epcClass: product.gtin, quantity: 1 }], readPoint: fgStore.id, bizLocation: fgStore.id }));
+    order.allocated = [];
+    order.fulfilled = 1;
+    order.status = good ? "produced" : "scrapped";
+    this.emitOrder(order);
+  }
+  // ── 정의-구동 모드 (도메인 정의 데이터로 실행 — 레거시와 분리, 하드코딩 대체) ──
+  recipeDef() {
+    const d = this.mesSpec.definition;
+    return this.mesSpec.recipeKey ? d.recipes?.find((r) => r.key === this.mesSpec.recipeKey) : d.recipes?.[0];
+  }
+  /** 자재 키 → 구체 gtin 클래스(idpat). 구체 식별은 바인딩+prefix 로 인스턴스가 주입. */
+  classOf(materialKey) {
+    return sgtinClass(this.mesSpec.companyPrefix, this.mesSpec.binding[materialKey]);
+  }
+  serialOf(materialKey, serial) {
+    return sgtinUri(this.mesSpec.companyPrefix, this.mesSpec.binding[materialKey], serial);
+  }
+  /** recipe.route → 오퍼레이션 시퀀스 해소. */
+  routeOps() {
+    const d = this.mesSpec.definition;
+    const route = d.routes?.find((r) => r.key === this.recipeDef().route);
+    return (route?.steps ?? []).map((sk) => d.operations?.find((o) => o.key === sk)).filter((o) => !!o);
+  }
+  /** 정의 모드 수령 — skuMix gtin 이 레시피 입력 자재면 raw-store 에 생성. */
+  onArrivalDef(spec) {
+    const rawStore = this.nodeByType("raw-store");
+    if (!rawStore) return;
+    const gtin = this.pickGtin(spec.content.skuMix);
+    const inputKey = this.recipeDef().inputs.map((i) => i.material).find((k) => this.classOf(k) === gtin);
+    if (!inputKey) return;
+    const epc = this.serialOf(inputKey, ++this.epcSeq);
+    this.items.set(epc, { epc, gtin, qty: 1, location: rawStore.id, disposition: DISP.sellable });
+    rawStore.occupancy++;
+    this.emit(objectEvent({ eventTime: this.now(), action: "ADD", bizStep: MES_BIZSTEP.receiving, disposition: DISP.sellable, epcList: [epc], quantityList: [{ epcClass: gtin, quantity: 1 }], readPoint: rawStore.id, bizLocation: rawStore.id }));
+  }
+  /** 정의 모드 작업지시 — 레시피 산출물 1개. */
+  onOrderDef(_spec) {
+    const rc = this.recipeDef();
+    const id = `order-${++this.orderSeq}`;
+    const wo = gdtiUri(this.mesSpec.companyPrefix, "403", ++this.soSeq);
+    const order = { id, kind: "workorder", status: "created", gtin: this.classOf(rc.outputs[0].material), requested: 1, fulfilled: 0, bizTransaction: wo, allocated: [], picked: [] };
+    this.orders.set(id, order);
+    this.emitOrder(order);
+  }
+  /** 정의 모드 할당 — 레시피 입력 BOM 전량 확보 후 첫 라우트 스텝 태스크. */
+  allocateDef(o) {
+    const ops = this.routeOps();
+    if (!ops.length || !ops[0].nodeType || !this.nodeByType(ops[0].nodeType)) return;
+    const rc = this.recipeDef();
+    const picks = [];
+    for (const line of rc.inputs) {
+      const g = this.classOf(line.material);
+      const available = [...this.items.values()].filter((i) => i.gtin === g && i.disposition === DISP.sellable && this.nodes.get(i.location)?.type === "raw-store").map((i) => ({ epc: i.epc, location: i.location, qty: 1 }));
+      const chosen = this.policy.selectStock({ gtin: g, qty: line.qty, available });
+      if (chosen.length < line.qty) return;
+      picks.push(...chosen);
+    }
+    for (const epc of picks) {
+      this.items.get(epc).disposition = DISP.reserved;
+      o.allocated.push(epc);
+    }
+    this.emit(transactionEvent({ eventTime: this.now(), action: "ADD", bizStep: MES_BIZSTEP.producing, bizTransactionList: [{ type: BTT_PRODORDER, bizTransaction: o.bizTransaction }], epcList: o.allocated.slice() }));
+    this.emitStationDef(o, ops[0], o.allocated[0]);
+    o.status = "op-" + ops[0].key;
+    this.emitOrder(o);
+  }
+  emitStationDef(o, op, itemEpc) {
+    const node = this.nodeByType(op.nodeType);
+    const task = { id: `task-${++this.taskSeq}`, kind: op.key, status: "created", itemEpc, fromNode: node.id, toNode: node.id, resource: null, remainingMs: 0, durationMs: this.durationOf({ kind: op.key, fromNode: node.id, toNode: node.id, resourceKind: op.resourceType }, CYCLE_MS), orderId: o.id, resourceType: op.resourceType, changeoverKey: o.gtin, setupMs: SETUP_MS, intent: op.intent };
+    this.tasks.set(task.id, task);
+    this.emitTask(task);
+  }
+  /** 정의 모드 완료 — 라우트 인덱스: 중간=WIP 변환+다음 스텝, 마지막=완제품(수율). */
+  onTaskCompleteDef(t) {
+    const order = this.orders.get(t.orderId);
+    const rc = this.recipeDef();
+    const ops = this.routeOps();
+    const i = ops.findIndex((s) => s.key === t.kind);
+    const node = this.nodes.get(t.toNode);
+    const bizStep = ops[i]?.bizStep ?? MES_BIZSTEP.producing;
+    const isLast = i === ops.length - 1;
+    if (!isLast) {
+      const inputs = order.allocated.slice();
+      const wip2 = sgtinUri(this.mesSpec.companyPrefix, "WIP", ++this.wipSeq);
+      const wipGtin = sgtinClass(this.mesSpec.companyPrefix, "WIP");
+      this.transform(inputs, [{ epc: wip2, gtin: wipGtin, qty: 1, location: node.id, disposition: DISP.in_progress }], { bizStep, disposition: DISP.in_progress, transformationId: order.bizTransaction, readPoint: node.id, bizTransactionList: [{ type: BTT_PRODORDER, bizTransaction: order.bizTransaction }] });
+      order.allocated = [wip2];
+      const next = ops[i + 1];
+      this.emitStationDef(order, next, wip2);
+      order.status = "op-" + next.key;
+      this.emitOrder(order);
+      return;
+    }
+    const fgStore = this.nodeByType("fg-store");
+    const wip = order.allocated[0];
+    const good = this.rng() < YIELD;
+    this.recordOutput(t.resource, good);
+    const disp = good ? DISP.sellable : DISP.non_sellable;
+    const outEpc = this.serialOf(rc.outputs[0].material, ++this.prodSeq);
+    const outGtin = this.classOf(rc.outputs[0].material);
+    this.transform([wip], [{ epc: outEpc, gtin: outGtin, qty: 1, location: fgStore.id, disposition: disp }], { bizStep, disposition: disp, transformationId: order.bizTransaction, readPoint: node.id, bizTransactionList: [{ type: BTT_PRODORDER, bizTransaction: order.bizTransaction }] });
+    this.emit(objectEvent({ eventTime: this.now(), action: "OBSERVE", bizStep: MES_BIZSTEP.storing, disposition: disp, epcList: [outEpc], quantityList: [{ epcClass: outGtin, quantity: 1 }], readPoint: fgStore.id, bizLocation: fgStore.id }));
     order.allocated = [];
     order.fulfilled = 1;
     order.status = good ? "produced" : "scrapped";
@@ -1452,6 +1961,8 @@ var MesKernel = class extends FlowEngine {
   BTT,
   BTT_DELIVERY,
   BTT_PRODORDER,
+  CAPABILITIES,
+  CAPABILITY_KEYS,
   CMD,
   DISP,
   DOMAIN_CATALOG,
@@ -1462,7 +1973,9 @@ var MesKernel = class extends FlowEngine {
   MES_BIZSTEP,
   MES_NODE_TYPES,
   MES_PART_GTINS,
+  MES_PRODUCTS,
   MES_PRODUCT_GTINS,
+  MES_TYPES,
   MesKernel,
   OP_EVENT,
   StateProjector,
@@ -1471,14 +1984,19 @@ var MesKernel = class extends FlowEngine {
   TwinRuntime,
   UTC_OFFSET,
   WMS_NODE_TYPES,
+  WMS_TYPES,
   WmsKernel,
   YARD_BIZSTEP,
   YMS_NODE_TYPES,
+  YMS_TYPES,
   YmsKernel,
   aggregationEvent,
+  capabilitiesForType,
   compareStates,
+  computeOee,
   constantDuration,
   counterfactualAt,
+  deriveAttentions,
   fefoPolicy,
   firstFitPolicy,
   gdtiUri,
@@ -1492,7 +2010,9 @@ var MesKernel = class extends FlowEngine {
   sgtinClass,
   sgtinUri,
   ssccUri,
+  stateFieldsOf,
   transactionEvent,
   transformationEvent,
+  validateDomainDefinition,
   validateEpcisEvent
 });