@operato/twin-kernel 0.2.2 → 0.3.0

package/dist-cjs/index.cjs

@@ -30,34 +30,39 @@ __export(index_exports, {
   DOMAIN_CATALOG: () => DOMAIN_CATALOG,
   DOMAIN_SYSTEMS: () => DOMAIN_SYSTEMS,
   EPCIS_CONTEXT: () => EPCIS_CONTEXT,
+  EQUIPMENT_LEVEL: () => EQUIPMENT_LEVEL,
   EventJournal: () => EventJournal,
   FlowEngine: () => FlowEngine,
+  GUARD_PRAGMA: () => GUARD_PRAGMA,
   ILMD_ATTR: () => ILMD_ATTR,
+  LOCATION_SATURATION_NEAR: () => LOCATION_SATURATION_NEAR,
   MES_BIZSTEP: () => MES_BIZSTEP,
-  MES_NODE_TYPES: () => MES_NODE_TYPES,
+  MES_LOCATION_TYPES: () => MES_LOCATION_TYPES,
   MES_PART_GTINS: () => MES_PART_GTINS,
   MES_PRODUCTS: () => MES_PRODUCTS,
   MES_PRODUCT_GTINS: () => MES_PRODUCT_GTINS,
   MES_TYPES: () => MES_TYPES,
   MesKernel: () => MesKernel,
-  NODE_SATURATION_NEAR: () => NODE_SATURATION_NEAR,
   OP_EVENT: () => OP_EVENT,
   OP_PARAM: () => OP_PARAM,
   ObservedReducer: () => ObservedReducer,
+  RETIRED_VOCABULARY: () => RETIRED_VOCABULARY,
   StateProjector: () => ObservedReducer,
   TwinHistory: () => TwinHistory,
   TwinObserver: () => TwinObserver,
   TwinRuntime: () => TwinRuntime,
   UTC_OFFSET: () => UTC_OFFSET,
-  WMS_NODE_TYPES: () => WMS_NODE_TYPES,
+  VOCABULARY_EXCEPTIONS: () => VOCABULARY_EXCEPTIONS,
+  WMS_LOCATION_TYPES: () => WMS_LOCATION_TYPES,
   WMS_TYPES: () => WMS_TYPES,
   WmsKernel: () => WmsKernel,
   YARD_BIZSTEP: () => YARD_BIZSTEP,
-  YMS_NODE_TYPES: () => YMS_NODE_TYPES,
+  YMS_LOCATION_TYPES: () => YMS_LOCATION_TYPES,
   YMS_TYPES: () => YMS_TYPES,
   YmsKernel: () => YmsKernel,
   aggregationEvent: () => aggregationEvent,
   capabilitiesForType: () => capabilitiesForType,
+  classClosure: () => classClosure,
   compareStates: () => compareStates,
   computeOee: () => computeOee,
   constantDuration: () => constantDuration,
@@ -68,16 +73,22 @@ __export(index_exports, {
   foldTaskRecords: () => foldTaskRecords,
   gdtiUri: () => gdtiUri,
   graiUri: () => graiUri,
+  hierarchyOf: () => hierarchyOf,
   ingest: () => ingest,
+  isEquipmentLevel: () => isEquipmentLevel,
   lgtinClass: () => lgtinClass,
+  locationStatusOf: () => locationStatusOf,
   mapRecord: () => mapRecord,
   monteCarloForecast: () => monteCarloForecast,
-  nodeStatusOf: () => nodeStatusOf,
   objectEvent: () => objectEvent,
   parseEpc: () => parseEpc,
   parseIsoDuration: () => parseIsoDuration,
   partialFitPolicy: () => partialFitPolicy,
+  readBoardAssets: () => readBoardAssets,
+  readBoardEquipment: () => readBoardEquipment,
+  readBoardLocations: () => readBoardLocations,
   replay: () => replay,
+  retiredVocabularyIn: () => retiredVocabularyIn,
   sgtinClass: () => sgtinClass,
   sgtinUri: () => sgtinUri,
   ssccUri: () => ssccUri,
@@ -90,12 +101,112 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/contract.ts
-var NODE_SATURATION_NEAR = 0.9;
-function nodeStatusOf(n) {
+var LOCATION_SATURATION_NEAR = 0.9;
+function locationStatusOf(n) {
   const cap = n.capacity;
   if (!(typeof cap === "number" && cap > 0)) return void 0;
   const r = (n.occupancy ?? 0) / cap;
-  return r >= 1 ? "full" : r >= NODE_SATURATION_NEAR ? "near-full" : "available";
+  return r >= 1 ? "full" : r >= LOCATION_SATURATION_NEAR ? "near-full" : "available";
+}
+var EQUIPMENT_LEVEL = [
+  "Enterprise",
+  "Site",
+  "Area",
+  "ProcessCell",
+  "Unit",
+  "ProductionLine",
+  "WorkCell",
+  "ProductionUnit",
+  "StorageZone",
+  "StorageUnit",
+  "WorkCenter",
+  "WorkUnit",
+  "EquipmentModule",
+  "ControlModule",
+  "Other"
+];
+function isEquipmentLevel(v) {
+  return typeof v === "string" && EQUIPMENT_LEVEL.includes(v);
+}
+function hierarchyOf(s) {
+  const push = (m, k, v) => {
+    const cur = m.get(k);
+    if (cur) cur.push(v);
+    else m.set(k, [v]);
+  };
+  const parent = /* @__PURE__ */ new Map();
+  const kids = /* @__PURE__ */ new Map();
+  const known = new Set(s.locations.map((n) => n.id));
+  for (const n of s.locations) {
+    if (!n.parentId || n.parentId === n.id) continue;
+    parent.set(n.id, n.parentId);
+    if (known.has(n.parentId)) push(kids, n.parentId, n.id);
+  }
+  for (const start of known) {
+    const seen = [start];
+    for (let at = parent.get(start); at !== void 0; at = parent.get(at)) {
+      if (seen.includes(at)) throw new Error(`location hierarchy has a cycle: ${[...seen, at].join(" \u2192 ")}`);
+      seen.push(at);
+      if (!known.has(at)) break;
+    }
+  }
+  const homes = /* @__PURE__ */ new Map();
+  for (const m of s.equipment ?? []) if (m.homeLocation) push(homes, m.homeLocation, m.id);
+  const ancestorsOf = (id) => {
+    const out = [];
+    for (let at = parent.get(id); at !== void 0; at = parent.get(at)) {
+      out.push(at);
+      if (!known.has(at)) break;
+    }
+    return out;
+  };
+  const descendantsOf = (id) => {
+    const out = [];
+    const stack = [...kids.get(id) ?? []];
+    while (stack.length) {
+      const cur = stack.pop();
+      out.push(cur);
+      stack.push(...kids.get(cur) ?? []);
+    }
+    return out;
+  };
+  const typeOf = new Map(s.locations.map((n) => [n.id, n.type]));
+  const levelOf = new Map(s.locations.map((n) => [n.id, n.level]));
+  return {
+    childrenOf: (id) => [...kids.get(id) ?? []],
+    ancestorsOf,
+    descendantsOf,
+    rollupOf: (id) => ancestorsOf(id).find((a) => !known.has(a)),
+    ancestorOfLevel: (id, level) => ancestorsOf(id).find((a) => known.has(a) && levelOf.get(a) === level),
+    ancestorOfType: (id, type) => ancestorsOf(id).find((a) => known.has(a) && typeOf.get(a) === type),
+    equipmentOf: (id, opts) => {
+      const scope = opts?.deep ? [id, ...descendantsOf(id)] : [id];
+      return scope.flatMap((n) => homes.get(n) ?? []);
+    }
+  };
+}
+function classClosure(directIds, defs, at) {
+  const byId = new Map((defs ?? []).map((d) => [d.id, d]));
+  const atMs = at ? Date.parse(at) : NaN;
+  const inWindow = (d) => {
+    if (!d || !Number.isFinite(atMs)) return true;
+    const from = d.effectiveStart ? Date.parse(d.effectiveStart) : NaN;
+    const to = d.effectiveEnd ? Date.parse(d.effectiveEnd) : NaN;
+    if (Number.isFinite(from) && atMs < from) return false;
+    if (Number.isFinite(to) && atMs > to) return false;
+    return true;
+  };
+  const out = /* @__PURE__ */ new Set();
+  const stack = [...directIds ?? []];
+  while (stack.length) {
+    const id = stack.pop();
+    if (out.has(id)) continue;
+    const def = byId.get(id);
+    if (!inWindow(def)) continue;
+    out.add(id);
+    for (const b of def?.baseIds ?? []) if (!out.has(b)) stack.push(b);
+  }
+  return out;
 }
 var OP_EVENT = {
   task: "task.status",
@@ -114,7 +225,7 @@ var CMD = {
   orderRelease: "order.release",
   attentionAck: "attention.ack",
   // 주목 신호 확인(OPC UA A&C acknowledge) — args:{id}
-  // Operable 코어 — 모든 operable 자원(설비·이동무버) 공통. args:{resourceId}. capability-keyed(무방언, equipment.* 아님).
+  // Operable 코어 — 모든 operable 자원(설비·이동설비) 공통. args:{resourceId}. capability-keyed(무방언, equipment.* 아님).
   resourceHold: "resource.hold",
   // 계획 정지(정비/오프라인) — 배정 스킵
   resourceResume: "resource.resume",
@@ -126,8 +237,27 @@ var CMD = {
   resourceResetMetrics: "resource.reset-metrics",
   // OEE 계측 창 리셋
   resourceAdd: "resource.add"
-  // 라이브 자원(무버) 추가 — args:{kind, homeNode, count?}. 런타임 구조 변이(what-if 아닌 실제 act)
+  // 라이브 자원(설비) 추가 — args:{kind, homeLocation, count?}. 런타임 구조 변이(what-if 아닌 실제 act)
 };
+function readBoardLocations(def) {
+  const d = def;
+  return d.locations ?? d.nodes ?? [];
+}
+function readBoardEquipment(def) {
+  const d = def;
+  const list = d.equipment ?? d.equipmentList ?? [];
+  return list.map((e) => normalizeHomeLocation(e));
+}
+function normalizeHomeLocation(entry) {
+  const legacy = entry.homeNode;
+  if (legacy === void 0 || entry.homeLocation !== void 0) return entry;
+  const { homeNode: _drop, ...rest } = entry;
+  return { ...rest, homeLocation: legacy };
+}
+function readBoardAssets(def) {
+  const list = def.assets ?? [];
+  return list.map((a) => normalizeHomeLocation(a));
+}
 
 // src/domain-definition.ts
 var OP_PARAM = {
@@ -152,19 +282,19 @@ function validateDomainDefinition(def) {
   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.locationTypes) || def.locationTypes.length === 0) v.push("locationTypes \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 locationKeys2 = new Set((def.locationTypes || []).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 [name, arr] of [["locationTypes", def.locationTypes], ["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.locationType && !locationKeys2.has(o.locationType)) v.push(`operation '${o.key}' locationType '${o.locationType}' \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)`);
   }
@@ -198,10 +328,10 @@ function diffBy(predicted, actual, idOf, valOf) {
 function compareStates(predicted, actual) {
   const itemLocation = diffBy(predicted.items, actual.items, (i) => i.epc, (i) => i.location);
   const itemDisposition = diffBy(predicted.items, actual.items, (i) => i.epc, (i) => i.disposition);
-  const nodeOccupancy = diffBy(predicted.nodes, actual.nodes, (n) => n.id, (n) => n.occupancy);
+  const locationOccupancy = diffBy(predicted.locations, actual.locations, (n) => n.id, (n) => n.occupancy);
   const orderStatus = diffBy(predicted.orders, actual.orders, (o) => o.id, (o) => o.status);
-  const hasDrift = itemLocation.length > 0 || itemDisposition.length > 0 || nodeOccupancy.length > 0 || orderStatus.length > 0;
-  return { hasDrift, itemLocation, itemDisposition, nodeOccupancy, orderStatus };
+  const hasDrift = itemLocation.length > 0 || itemDisposition.length > 0 || locationOccupancy.length > 0 || orderStatus.length > 0;
+  return { hasDrift, itemLocation, itemDisposition, locationOccupancy, orderStatus };
 }
 
 // src/counterfactual.ts
@@ -538,7 +668,7 @@ var ObservedReducer = class {
   pendingParent = /* @__PURE__ */ new Map();
   // 자식 EPC → 부모(물류단위)
   tasks = /* @__PURE__ */ new Map();
-  movers = /* @__PURE__ */ new Map();
+  equipment = /* @__PURE__ */ new Map();
   persons = /* @__PURE__ */ new Map();
   assets = /* @__PURE__ */ new Map();
   orders = /* @__PURE__ */ new Map();
@@ -546,26 +676,26 @@ var ObservedReducer = class {
   /** 받은 정정 선언 — 상태에 반영하지 않되 **버리지도 않는다**(소비처가 볼 수 있게). */
   corrections = [];
   constructor(board) {
-    for (const n of board.nodes) this.master.set(n.id, { id: n.id, type: n.type, capacity: n.capacity, parallelism: n.parallelism, parentId: n.parentId, origin: "master" });
-    for (const m of board.movers) this.movers.set(m.id, { id: m.id, kind: m.kind, status: "idle", location: m.homeNode, origin: "master" });
-    for (const p of board.persons ?? []) this.persons.set(p.id, { id: p.id, personnelClass: p.personnelClass, status: "idle" });
-    for (const a of board.assets ?? []) this.assets.set(a.id, { id: a.id, assetClass: a.assetClass, location: a.homeNode, status: "idle" });
+    for (const n of readBoardLocations(board)) this.master.set(n.id, { id: n.id, type: n.type, capacity: n.capacity, parallelism: n.parallelism, parentId: n.parentId, origin: "master" });
+    for (const m of readBoardEquipment(board)) this.equipment.set(m.id, { id: m.id, kind: m.kind, status: "idle", location: m.homeLocation, homeLocation: m.homeLocation, ...m.properties ? { properties: m.properties } : {}, ...m.testSpecificationIds ? { testSpecificationIds: m.testSpecificationIds } : {}, origin: "master" });
+    for (const p of board.persons ?? []) this.persons.set(p.id, { id: p.id, personnelClassIds: p.personnelClassIds, status: "idle", ...p.homeLocation ? { location: p.homeLocation } : {}, ...p.properties ? { properties: p.properties } : {}, ...p.testSpecificationIds ? { testSpecificationIds: p.testSpecificationIds } : {} });
+    for (const a of readBoardAssets(board)) this.assets.set(a.id, { id: a.id, assetClassIds: a.assetClassIds, location: a.homeLocation, status: "idle", ...a.properties ? { properties: a.properties } : {}, ...a.testSpecificationIds ? { testSpecificationIds: a.testSpecificationIds } : {} });
   }
   /** 마스터 동기 — 로케이션 추가/변경/제거. */
   applyMaster(u) {
     if (u.op === "remove") {
-      this.master.delete(u.node.id);
+      this.master.delete(u.location.id);
       return;
     }
-    const cur = this.master.get(u.node.id);
-    const capacity = u.node.capacity ?? cur?.capacity;
-    const parallelism = u.node.parallelism ?? cur?.parallelism;
-    this.master.set(u.node.id, {
-      id: u.node.id,
-      type: u.node.type ?? cur?.type ?? UNKNOWN_TYPE,
+    const cur = this.master.get(u.location.id);
+    const capacity = u.location.capacity ?? cur?.capacity;
+    const parallelism = u.location.parallelism ?? cur?.parallelism;
+    this.master.set(u.location.id, {
+      id: u.location.id,
+      type: u.location.type ?? cur?.type ?? UNKNOWN_TYPE,
       ...capacity === void 0 ? {} : { capacity },
       ...parallelism === void 0 ? {} : { parallelism },
-      ...u.node.parentId ?? cur?.parentId ? { parentId: u.node.parentId ?? cur?.parentId } : {},
+      ...u.location.parentId ?? cur?.parentId ? { parentId: u.location.parentId ?? cur?.parentId } : {},
       /* 마스터가 말한 것은 마스터 출처다 — 관측으로 알게 된 것(origin='observed')을 덮어 승격한다. */
       origin: "master"
     });
@@ -573,7 +703,7 @@ var ObservedReducer = class {
   /**
    * 관측된 로케이션을 구조로 승격 — **이벤트가 가르쳐 준 것을 구조에서 지우지 않는다.**
    *
-   * 마스터에 없는 로케이션에서 물품이 관측되면, 예전에는 물품의 `location` 에만 남고 `nodes` 에는
+   * 마스터에 없는 로케이션에서 물품이 관측되면, 예전에는 물품의 `location` 에만 남고 `locations` 에는
    * 나타나지 않았다. 그 결과 그 자리는 스키매틱에 없고, 점유가 집계되지 않고, 병목 주목이 뜰 수
    * 없었다 — **사실은 들어왔는데 구조가 모르는 상태.** 이제 최소 형태로 승격한다:
    * 종류는 모르므로 `unknown`, **용량은 비워 둔다**(발명하지 않는다), 출처는 `observed`.
@@ -646,20 +776,25 @@ var ObservedReducer = class {
       }
       case OP_EVENT.equipment: {
         const d = e.data;
-        if (this.stale(`mover:${d.moverId}`, e)) return;
+        if (this.stale(`eq:${d.moverId}`, e)) return;
         this.touchLocation(d.location);
-        const known = this.movers.get(d.moverId);
-        this.movers.set(d.moverId, { id: d.moverId, kind: d.kind, status: d.status, location: d.location, taskId: d.taskId, motion: d.motion, origin: known?.origin ?? "observed" });
+        const known = this.equipment.get(d.moverId);
+        const homeLocation = d.homeLocation ?? known?.homeLocation;
+        this.equipment.set(d.moverId, { id: d.moverId, kind: d.kind, status: d.status, location: d.location, ...homeLocation ? { homeLocation } : {}, taskId: d.taskId, motion: d.motion, origin: known?.origin ?? "observed" });
         break;
       }
       case OP_EVENT.person: {
         const d = e.data;
         if (this.stale(`person:${d.personId}`, e)) return;
+        const known = this.persons.get(d.personId);
         this.persons.set(d.personId, {
           id: d.personId,
-          personnelClass: d.personnelClass ?? this.persons.get(d.personId)?.personnelClass,
+          personnelClassIds: d.personnelClassIds ?? known?.personnelClassIds,
           status: d.status,
           taskId: d.taskId,
+          ...d.location ?? known?.location ? { location: d.location ?? known?.location } : {},
+          ...known?.properties ? { properties: known.properties } : {},
+          ...known?.testSpecificationIds ? { testSpecificationIds: known.testSpecificationIds } : {},
           ...d.offShift ? { offShift: true } : {}
         });
         break;
@@ -670,7 +805,7 @@ var ObservedReducer = class {
         const cur = this.assets.get(d.assetId);
         this.assets.set(d.assetId, {
           id: d.assetId,
-          assetClass: d.assetClass ?? cur?.assetClass,
+          assetClassIds: d.assetClassIds ?? cur?.assetClassIds,
           location: d.location ?? cur?.location,
           status: d.status,
           taskId: d.taskId,
@@ -803,16 +938,16 @@ var ObservedReducer = class {
       for (const c of children) this.remove(c);
     }
   }
-  /** 현재 투영 State — 노드 점유는 아이템 위치 집계로 유도(pure projection). */
+  /** 현재 투영 State — 자리 점유는 아이템 위치 집계로 유도(pure projection). */
   snapshot() {
     const occ = /* @__PURE__ */ new Map();
     for (const it of this.items.values()) occ.set(it.location, (occ.get(it.location) ?? 0) + 1);
     return {
       revision: this.revision,
       ...this.corrections.length ? { corrections: this.corrections.map((c) => ({ ...c })) } : {},
-      nodes: [...this.master.values()].map((n) => {
+      locations: [...this.master.values()].map((n) => {
         const occupancy = occ.get(n.id) ?? 0;
-        const status = nodeStatusOf({ occupancy, capacity: n.capacity });
+        const status = locationStatusOf({ occupancy, capacity: n.capacity });
         return {
           id: n.id,
           type: n.type,
@@ -830,7 +965,7 @@ var ObservedReducer = class {
       persons: [...this.persons.values()].map((p) => ({ ...p })),
       assets: [...this.assets.values()].map((a) => ({ ...a })),
       tasks: [...this.tasks.values()].map((t) => ({ ...t })),
-      movers: [...this.movers.values()].map((m) => ({ ...m })),
+      equipment: [...this.equipment.values()].map((m) => ({ ...m })),
       orders: [...this.orders.values()].map((o) => ({ ...o }))
     };
   }
@@ -882,10 +1017,10 @@ var BTT = {
   po: "urn:epcglobal:cbv:btt:po",
   so: "urn:epcglobal:cbv:btt:so"
 };
-var WMS_NODE_TYPES = ["dock", "storage", "staging", "dock-ship"];
+var WMS_LOCATION_TYPES = ["dock", "storage", "staging", "dock-ship"];
 var WMS_TYPES = [
-  ...WMS_NODE_TYPES.map((k) => ({ key: k, role: "node", label: `twin.type.${k}`, standardClass: { epcis: "bizLocation" }, identity: { scheme: "gs1:SGLN" }, capabilities: ["storable"] })),
-  { key: "forklift", role: "mover", label: "twin.type.forklift", standardClass: { epcis: "object", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["mobile", "operable"] }
+  ...WMS_LOCATION_TYPES.map((k) => ({ key: k, role: "location", label: `twin.type.${k}`, standardClass: { epcis: "bizLocation" }, identity: { scheme: "gs1:SGLN" }, capabilities: ["storable"] })),
+  { key: "forklift", role: "equipment", label: "twin.type.forklift", standardClass: { epcis: "object", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["mobile", "operable"] }
 ];
 
 // src/capability.ts
@@ -908,7 +1043,7 @@ var CAPABILITIES = {
   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)",
+    semantics: "\uC790\uC6D0 \uC790\uC2E0\uC774 \uC790\uB9AC \uAC04 \uC774\uB3D9. Transferable(\uC544\uC774\uD15C \uC774\uB3D9)\uACFC \uB2E4\uB984. (\uC52C \uAE30\uC81C: CarrierLine)",
     stateFields: ["location", "motion"],
     models: ["Motion"],
     results: ["moved", "motionTick"]
@@ -952,10 +1087,10 @@ var BTT_DELIVERY = "urn:epcglobal:cbv:btt:deliv";
 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_LOCATION_TYPES = ["gate", "yard-slot", "dock-door", "staging"];
 var YMS_TYPES = [
-  ...YMS_NODE_TYPES.map((k) => ({ key: k, role: "node", label: `twin.type.${k}`, standardClass: { epcis: "bizLocation" }, identity: { scheme: "gs1:SGLN" }, capabilities: ["storable"] })),
-  { key: "hostler", role: "mover", label: "twin.type.hostler", standardClass: { epcis: "object", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["mobile", "operable"] }
+  ...YMS_LOCATION_TYPES.map((k) => ({ key: k, role: "location", label: `twin.type.${k}`, standardClass: { epcis: "bizLocation" }, identity: { scheme: "gs1:SGLN" }, capabilities: ["storable"] })),
+  { key: "hostler", role: "equipment", label: "twin.type.hostler", standardClass: { epcis: "object", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["mobile", "operable"] }
 ];
 
 // src/mes-profile.ts
@@ -971,8 +1106,8 @@ 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", "paint-booth", "assembly-line", "fg-store"];
-var MES_NODE_CLS = {
+var MES_LOCATION_TYPES = ["raw-store", "cut-station", "weld-station", "paint-booth", "assembly-line", "fg-store"];
+var MES_LOCATION_CLS = {
   "raw-store": { epcis: "bizLocation" },
   "cut-station": { isa95: "WorkCenter", epcis: "bizLocation" },
   "weld-station": { isa95: "WorkCenter", epcis: "bizLocation" },
@@ -981,20 +1116,20 @@ var MES_NODE_CLS = {
   "fg-store": { epcis: "bizLocation" }
 };
 var MES_TYPES = [
-  ...MES_NODE_TYPES.map((k) => ({ key: k, role: "node", label: `twin.type.${k}`, standardClass: MES_NODE_CLS[k] ?? {}, identity: { scheme: "gs1:SGLN" }, capabilities: ["storable"] })),
-  { key: "cutter", role: "mover", label: "twin.type.cutter", standardClass: { isa95: "Equipment", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] },
-  { key: "welder", role: "mover", label: "twin.type.welder", standardClass: { isa95: "Equipment", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] },
-  { key: "painter", role: "mover", label: "twin.type.painter", standardClass: { isa95: "Equipment", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] },
-  { key: "assembler", role: "mover", label: "twin.type.assembler", standardClass: { isa95: "Equipment", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] }
+  ...MES_LOCATION_TYPES.map((k) => ({ key: k, role: "location", label: `twin.type.${k}`, standardClass: MES_LOCATION_CLS[k] ?? {}, identity: { scheme: "gs1:SGLN" }, capabilities: ["storable"] })),
+  { key: "cutter", role: "equipment", label: "twin.type.cutter", standardClass: { isa95: "Equipment", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] },
+  { key: "welder", role: "equipment", label: "twin.type.welder", standardClass: { isa95: "Equipment", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] },
+  { key: "painter", role: "equipment", label: "twin.type.painter", standardClass: { isa95: "Equipment", iso55000: "Asset" }, identity: { scheme: "gs1:GIAI" }, capabilities: ["processable", "operable"] },
+  { key: "assembler", role: "equipment", label: "twin.type.assembler", 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 locationKeys = (types) => types.filter((t) => t.role === "location").map((t) => t.key);
 var DOMAIN_CATALOG = {
   // label 은 언어 중립 i18n 키(twin.system.<code>) — 사람 언어는 표현계층이 렌더(L2).
-  wms: { system: "wms", label: "twin.system.wms", types: WMS_TYPES, nodeTypes: nodeKeys(WMS_TYPES) },
-  yms: { system: "yms", label: "twin.system.yms", types: YMS_TYPES, nodeTypes: nodeKeys(YMS_TYPES) },
-  mes: { system: "mes", label: "twin.system.mes", types: MES_TYPES, nodeTypes: nodeKeys(MES_TYPES) }
+  wms: { system: "wms", label: "twin.system.wms", types: WMS_TYPES, locationTypes: locationKeys(WMS_TYPES) },
+  yms: { system: "yms", label: "twin.system.yms", types: YMS_TYPES, locationTypes: locationKeys(YMS_TYPES) },
+  mes: { system: "mes", label: "twin.system.mes", types: MES_TYPES, locationTypes: locationKeys(MES_TYPES) }
 };
 var DOMAIN_SYSTEMS = ["wms", "yms", "mes"];
 function capabilitiesForType(system, typeKey) {
@@ -1083,8 +1218,8 @@ function foldTaskRecords(rows) {
     if (f.resource === void 0 && d.resourceRef) f.resource = d.resourceRef;
     if (f.kind === void 0 && d.kind) f.kind = d.kind;
     if (f.order === void 0 && d.orderId) f.order = d.orderId;
-    const node = d.toNode ?? d.fromNode;
-    if (node) f.node = node;
+    const loc = d.toNode ?? d.fromNode;
+    if (loc) f.location = loc;
     if (d.status === "created") rec.createdMs = at;
     else if (d.status === "in-progress") rec.startedMs = rec.startedMs != null ? Math.min(rec.startedMs, at) : at;
     else if (d.status === "completed") rec.completedMs = rec.completedMs != null ? Math.max(rec.completedMs, at) : at;
@@ -1209,14 +1344,14 @@ function mulberry32(seed) {
 }
 function deriveAttentions(view, acked) {
   const out = [];
-  for (const m of view.movers) {
+  for (const m of view.equipment) {
     if (m.status === "down") {
       out.push({
         id: `breakdown:${m.id}`,
         kind: "breakdown",
         severity: "critical",
-        anchor: { moverId: m.id, nodeId: m.location },
-        params: { moverId: m.id, ...m.location ? { nodeId: m.location } : {} },
+        anchor: { moverId: m.id, locationId: m.location },
+        params: { moverId: m.id, ...m.location ? { locationId: m.location } : {} },
         recommendedActions: [
           { code: "act.repair", command: CMD.resourceRepair, args: { resourceId: m.id } },
           { code: "act.hold-until-repair", command: CMD.resourceHold, args: { resourceId: m.id } }
@@ -1225,7 +1360,7 @@ function deriveAttentions(view, acked) {
       });
     }
   }
-  for (const n of view.nodes) {
+  for (const n of view.locations) {
     if ((n.capacity ?? 0) > 0) {
       const r = (n.occupancy ?? 0) / n.capacity;
       if (r >= 0.9) {
@@ -1234,15 +1369,15 @@ function deriveAttentions(view, acked) {
           id: `bottleneck:${n.id}`,
           kind: "bottleneck",
           severity: saturated ? "high" : "medium",
-          anchor: { nodeId: n.id },
-          params: { nodeId: n.id, occupancy: n.occupancy ?? 0, capacity: n.capacity ?? 0, ratioPct: Math.round(r * 100), saturated: saturated ? 1 : 0 },
+          anchor: { locationId: n.id },
+          params: { locationId: n.id, occupancy: n.occupancy ?? 0, capacity: n.capacity ?? 0, ratioPct: Math.round(r * 100), saturated: saturated ? 1 : 0 },
           recommendedActions: [{ code: "advice.add-resource" }, { code: "advice.downstream-priority" }]
           // 권고만(command 없음) — 표현계층이 advice.* 코드로 렌더
         });
       }
     }
   }
-  for (const m of view.movers) {
+  for (const m of view.equipment) {
     const total = (m.goodCount ?? 0) + (m.scrapCount ?? 0);
     if (total >= 10) {
       const rate = (m.scrapCount ?? 0) / total;
@@ -1250,7 +1385,7 @@ function deriveAttentions(view, acked) {
         id: `scrap:${m.id}`,
         kind: "scrap-high",
         severity: rate >= 0.3 ? "high" : "medium",
-        anchor: { moverId: m.id, nodeId: m.location },
+        anchor: { moverId: m.id, locationId: m.location },
         params: { moverId: m.id, goodCount: m.goodCount ?? 0, scrapCount: m.scrapCount ?? 0, ratePct: Math.round(rate * 100) },
         recommendedActions: [
           { code: "act.hold-for-inspection", command: CMD.resourceHold, args: { resourceId: m.id } },
@@ -1298,9 +1433,11 @@ function computeOee(c, nowMs) {
 }
 var FlowEngine = class {
   tenantId;
-  nodes = /* @__PURE__ */ new Map();
+  locations = /* @__PURE__ */ new Map();
   items = /* @__PURE__ */ new Map();
-  movers = /* @__PURE__ */ new Map();
+  equipment = /* @__PURE__ */ new Map();
+  /** 등급 정의(표준 `<X>Class`) — 상속·유효기간 판정의 재료. 선언 안 하면 비어 있고, 소속 그대로 판정한다. */
+  classDefs = {};
   /** 사람 — 선언하지 않으면 빈 맵(인원 제약 없는 트윈, 기존 거동). */
   persons = /* @__PURE__ */ new Map();
   /** 물리 자산 — 선언하지 않으면 빈 맵(자산 제약 없는 트윈, 기존 거동). */
@@ -1347,43 +1484,44 @@ var FlowEngine = class {
   // ── TwinKernel (mechanics, 도메인 무관) ───────────────────────────────────
   loadBoard(def) {
     this.boardDef = def;
-    for (const n of def.nodes) this.nodes.set(n.id, { id: n.id, type: n.type, capacity: n.capacity, parallelism: n.parallelism, occupancy: 0, status: "idle", parentId: n.parentId });
-    for (const p of def.persons ?? []) this.persons.set(p.id, { id: p.id, personnelClass: p.personnelClass, status: "idle", taskId: null, window: p.window });
-    for (const a of def.assets ?? []) this.assets.set(a.id, { id: a.id, assetClass: a.assetClass, location: a.homeNode, status: "idle", taskId: null });
-    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, window: m.window };
+    for (const n of readBoardLocations(def)) this.locations.set(n.id, { id: n.id, type: n.type, capacity: n.capacity, parallelism: n.parallelism, occupancy: 0, status: "idle", parentId: n.parentId });
+    this.classDefs = { personnel: def.personnelClasses, equipment: def.equipmentClasses, asset: def.assetClasses };
+    for (const p of def.persons ?? []) this.persons.set(p.id, { id: p.id, personnelClassIds: p.personnelClassIds, status: "idle", taskId: null, window: p.window, ...p.homeLocation ? { location: p.homeLocation } : {}, ...p.properties ? { properties: p.properties } : {}, ...p.testSpecificationIds ? { testSpecificationIds: p.testSpecificationIds } : {} });
+    for (const a of readBoardAssets(def)) this.assets.set(a.id, { id: a.id, assetClassIds: a.assetClassIds, location: a.homeLocation, status: "idle", taskId: null, ...a.properties ? { properties: a.properties } : {}, ...a.testSpecificationIds ? { testSpecificationIds: a.testSpecificationIds } : {} });
+    for (const m of readBoardEquipment(def)) {
+      const eq = { id: m.id, kind: m.kind, location: m.homeLocation, homeLocation: m.homeLocation, ...m.properties ? { properties: m.properties } : {}, ...m.testSpecificationIds ? { testSpecificationIds: m.testSpecificationIds } : {}, status: "idle", taskId: null, runMs: 0, setupMs: 0, downMs: 0, goodCount: 0, scrapCount: 0, window: m.window };
       if (m.mtbfMs !== void 0) {
-        mover.mtbfMs = m.mtbfMs;
-        mover.mttrMs = m.mttrMs;
-        mover.nextFailureMs = this.sampleExp(m.mtbfMs);
+        eq.mtbfMs = m.mtbfMs;
+        eq.mttrMs = m.mttrMs;
+        eq.nextFailureMs = this.sampleExp(m.mtbfMs);
       }
-      this.movers.set(m.id, mover);
+      this.equipment.set(m.id, eq);
     }
   }
   /**
-   * what-if 구성 변주 — fork(또는 실행 중) 엔진에 무버 추가. loadBoard 무버 삽입과 동일 규약.
+   * 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 };
+  addEquipment(m) {
+    if (this.equipment.has(m.id)) return;
+    const eq = { id: m.id, kind: m.kind, location: m.homeLocation, homeLocation: m.homeLocation, ...m.properties ? { properties: m.properties } : {}, ...m.testSpecificationIds ? { testSpecificationIds: m.testSpecificationIds } : {}, 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);
+      eq.mtbfMs = m.mtbfMs;
+      eq.mttrMs = m.mttrMs;
+      eq.nextFailureMs = this.sampleExp(m.mtbfMs);
     }
-    this.movers.set(m.id, mover);
+    this.equipment.set(m.id, eq);
   }
   /**
-   * 관측 상태 주입(라이브 예측용, kernel-unification P1) — 외부 관측 스냅샷(재고·무버·노드)과
+   * 관측 상태 주입(라이브 예측용, 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, parallelism: n.parallelism, occupancy: n.occupancy ?? 0, status: n.status ?? "idle", parentId: n.parentId });
+    for (const n of snap.locations) {
+      this.locations.set(n.id, { id: n.id, type: n.type, capacity: n.capacity ?? 0, parallelism: n.parallelism, occupancy: n.occupancy ?? 0, status: n.status ?? "idle", parentId: n.parentId });
     }
     this.items.clear();
     for (const it of snap.items) {
@@ -1401,12 +1539,13 @@ var FlowEngine = class {
         ilmd: it.ilmd
       });
     }
-    for (const m of snap.movers) {
+    for (const m of snap.equipment) {
       const oee = m.oee;
-      this.movers.set(m.id, {
+      this.equipment.set(m.id, {
         id: m.id,
         kind: m.kind,
         location: m.location ?? "",
+        ...m.homeLocation ? { homeLocation: m.homeLocation } : {},
         status: m.status ?? "idle",
         taskId: null,
         runMs: oee?.runMs ?? 0,
@@ -1417,10 +1556,10 @@ var FlowEngine = class {
       });
     }
     for (const p of snap.persons ?? []) {
-      this.persons.set(p.id, { id: p.id, personnelClass: p.personnelClass, status: "idle", taskId: null });
+      this.persons.set(p.id, { id: p.id, personnelClassIds: p.personnelClassIds, status: "idle", taskId: null });
     }
     for (const a of snap.assets ?? []) {
-      this.assets.set(a.id, { id: a.id, assetClass: a.assetClass, location: a.location, status: "idle", taskId: null, carrying: a.carrying });
+      this.assets.set(a.id, { id: a.id, assetClassIds: a.assetClassIds, location: a.location, status: "idle", taskId: null, carrying: a.carrying });
     }
     for (const t of snap.tasks ?? []) {
       if (t.status === "completed") continue;
@@ -1440,7 +1579,7 @@ var FlowEngine = class {
         intent: t.intent
       });
       if (known && t.status === "in-progress" && t.resourceRef) {
-        const mv = this.movers.get(t.resourceRef);
+        const mv = this.equipment.get(t.resourceRef);
         if (mv) {
           mv.status = "busy";
           mv.taskId = t.id;
@@ -1466,9 +1605,9 @@ var FlowEngine = class {
       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);
+  /** what-if 구성 변주 — 자리 용량 변경(fork 대상). 존재하면 true. */
+  setLocationCapacity(locationId, capacity) {
+    const n = this.locations.get(locationId);
     if (!n) return false;
     n.capacity = Math.max(0, capacity);
     return true;
@@ -1513,39 +1652,39 @@ var FlowEngine = class {
         if (id) this._acked.add(id);
         return ok();
       }
-      // Operable 코어 — 자원(설비·무버) 제어. capability-keyed(resourceId), 모든 operable 자원 공통.
+      // Operable 코어 — 자원(설비·설비) 제어. capability-keyed(resourceId), 모든 operable 자원 공통.
       case CMD.resourceHold:
       case CMD.resourceResume: {
-        const m = this.movers.get(cmd.args?.resourceId ?? "");
+        const m = this.equipment.get(cmd.args?.resourceId ?? "");
         if (!m) return fail("resource-not-found");
         m.held = cmd.type === CMD.resourceHold;
-        this.emitMover(m);
+        this.emitEquipment(m);
         return ok();
       }
       case CMD.resourceDown: {
         const a = cmd.args;
-        const m = this.movers.get(a?.resourceId ?? "");
+        const m = this.equipment.get(a?.resourceId ?? "");
         if (!m) return fail("resource-not-found");
         if (m.status !== "down") {
           m.status = "down";
           m.repairUntilMs = this.clockMs + (Number(a?.durationMs) || m.mttrMs || 6e4);
-          this.emitMover(m);
+          this.emitEquipment(m);
         }
         return ok();
       }
       case CMD.resourceRepair: {
-        const m = this.movers.get(cmd.args?.resourceId ?? "");
+        const m = this.equipment.get(cmd.args?.resourceId ?? "");
         if (!m) return fail("resource-not-found");
         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);
+          this.emitEquipment(m);
         }
         return ok();
       }
       case CMD.resourceResetMetrics: {
-        const m = this.movers.get(cmd.args?.resourceId ?? "");
+        const m = this.equipment.get(cmd.args?.resourceId ?? "");
         if (!m) return fail("resource-not-found");
         m.runMs = 0;
         m.setupMs = 0;
@@ -1554,21 +1693,21 @@ var FlowEngine = class {
         m.scrapCount = 0;
         m.holdMs = 0;
         m.metricsSinceMs = this.clockMs;
-        this.emitMover(m);
+        this.emitEquipment(m);
         return ok();
       }
       case CMD.resourceAdd: {
         const a = cmd.args;
         if (!a?.kind) return fail("kind-required");
-        if (!a?.homeNode || !this.nodes.has(a.homeNode)) return fail("home-node-not-found", { homeNode: a?.homeNode ?? "" });
+        if (!a?.homeLocation || !this.locations.has(a.homeLocation)) return fail("home-location-not-found", { homeLocation: a?.homeLocation ?? "" });
         const count = Math.max(1, Math.min(50, Number(a.count) || 1));
-        let seq = this.movers.size;
+        let seq = this.equipment.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);
+          while (this.equipment.has(id)) id = `${a.kind}-${++seq}`;
+          this.addEquipment({ id, kind: a.kind, homeLocation: a.homeLocation });
+          const m = this.equipment.get(id);
+          if (m) this.emitEquipment(m);
         }
         return ok();
       }
@@ -1617,25 +1756,30 @@ var FlowEngine = class {
       simClockMs: this.clockMs,
       /* 출처 표시 — 보드(마스터)에서 온 자리다. 미러는 관측으로 알게 된 자리를 'observed' 로 구별하는데,
        * 시뮬이 아무 표시도 안 하면 소비처가 두 스냅샷을 같은 규칙으로 읽지 못한다. */
-      nodes: [...this.nodes.values()].map((n) => {
+      locations: [...this.locations.values()].map((n) => {
         const { status, ...rest } = n;
-        const derived = nodeStatusOf(n);
+        const derived = locationStatusOf(n);
         return { ...rest, ...derived ? { status: derived } : {}, origin: "master" };
       }),
       items: [...this.items.values()].map((i) => this.itemState(i)),
-      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), held: m.held, origin: "master", ...this.offShift(m) ? { offShift: true } : {} };
+      equipment: [...this.equipment.values()].map((m) => {
+        const s = { id: m.id, kind: m.kind, location: m.location, ...m.homeLocation ? { homeLocation: m.homeLocation } : {}, status: m.status, taskId: m.taskId ?? void 0, oee: this.oeeOf(m), held: m.held, ...m.properties ? { properties: m.properties } : {}, ...m.testSpecificationIds ? { testSpecificationIds: m.testSpecificationIds } : {}, origin: "master", ...this.offShift(m) ? { offShift: true } : {} };
         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;
       }),
       assets: [...this.assets.values()].map((a) => {
-        const st = { id: a.id, assetClass: a.assetClass, location: a.location, status: a.status, taskId: a.taskId ?? void 0 };
+        const st = { id: a.id, assetClassIds: a.assetClassIds, location: a.location, status: a.status, taskId: a.taskId ?? void 0 };
         if (a.carrying) st.carrying = a.carrying;
+        if (a.properties) st.properties = a.properties;
+        if (a.testSpecificationIds) st.testSpecificationIds = a.testSpecificationIds;
         return st;
       }),
       persons: [...this.persons.values()].map((p) => {
-        const st = { id: p.id, personnelClass: p.personnelClass, status: p.status, taskId: p.taskId ?? void 0 };
+        const st = { id: p.id, personnelClassIds: p.personnelClassIds, status: p.status, taskId: p.taskId ?? void 0 };
+        if (p.location) st.location = p.location;
+        if (p.properties) st.properties = p.properties;
+        if (p.testSpecificationIds) st.testSpecificationIds = p.testSpecificationIds;
         if (this.personOffShift(p)) st.offShift = true;
         return st;
       }),
@@ -1672,13 +1816,13 @@ var FlowEngine = class {
     };
   }
   /*
-   * 주목 신호 판단 — 상태(노드·무버·오더)에서 도메인 조건을 평가해 Attention 방출.
+   * 주목 신호 판단 — 상태(자리·설비·오더)에서 도메인 조건을 평가해 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()] },
+      { equipment: [...this.equipment.values()], locations: [...this.locations.values()], orders: [...this.orders.values()] },
       this._acked
     );
     const present = new Set(out.map((a) => a.id));
@@ -1733,7 +1877,7 @@ var FlowEngine = class {
    */
   apply(envelope) {
     if (!this.observer) {
-      this.observer = new ObservedReducer(this.boardDef ?? { nodes: [], movers: [] });
+      this.observer = new ObservedReducer(this.boardDef ?? { locations: [], equipment: [] });
       this.observeMode = true;
     }
     this.observer.apply(envelope);
@@ -1881,28 +2025,28 @@ var FlowEngine = class {
     }
     return mix[mix.length - 1].gtin;
   }
-  nodeByType(type) {
-    for (const n of this.nodes.values()) if (n.type === type) return n;
+  locationByType(type) {
+    for (const n of this.locations.values()) if (n.type === type) return n;
     return void 0;
   }
   /**
    * process 변화 대수(EPCIS TransformationEvent · ISA-95 Material Consumed/Produced · 씬 Processable.transform).
    * inputs 소비 → outputs 생산. 입출력 arity 가 곧 대수:
    *   merge N→1(조립) · split 1→N(분해) · transform 1→1(타입변경) · loss N→0(소실) · gain 0→N(부산물·생성).
-   * 아이템 상태(소비/생산)와 노드 점유를 갱신하고 계보(TransformationEvent)를 방출한다.
+   * 아이템 상태(소비/생산)와 자리 점유를 갱신하고 계보(TransformationEvent)를 방출한다.
    * 도메인은 이 원시만 호출 — onTaskComplete 의 소비/생산/EPCIS 손코딩을 대체.
    */
   transform(inputs, outputs, opts) {
     for (const epc of inputs) {
       const it = this.items.get(epc);
       if (!it) continue;
-      const n = this.nodes.get(it.location);
+      const n = this.locations.get(it.location);
       if (n) n.occupancy--;
       this.items.delete(epc);
     }
     for (const o of outputs) {
       this.items.set(o.epc, { epc: o.epc, gtin: o.gtin, qty: o.qty, location: o.location, disposition: o.disposition });
-      const n = this.nodes.get(o.location);
+      const n = this.locations.get(o.location);
       if (n) n.occupancy++;
     }
     this.emit(transformationEvent({
@@ -1976,7 +2120,7 @@ var FlowEngine = class {
       for (const c of children) {
         const it = this.items.get(c);
         if (it) {
-          const n = this.nodes.get(it.location);
+          const n = this.locations.get(it.location);
           if (n) n.occupancy--;
           this.items.delete(c);
         }
@@ -1990,7 +2134,7 @@ var FlowEngine = class {
   }
   /**
    * containment 분해(EPCIS AggregationEvent DELETE) — 부모(용기)에서 자식들을 풀어냄.
-   * materialize 지정 시 자식이 독립 아이템으로 등장(materialize: 노드 배치 + occupancy + ObjectEvent ADD).
+   * materialize 지정 시 자식이 독립 아이템으로 등장(materialize: 자리 배치 + occupancy + ObjectEvent ADD).
    * 미지정 시 이벤트만.
    */
   disaggregate(parent, children, opts) {
@@ -2003,7 +2147,7 @@ var FlowEngine = class {
       const m = opts.materialize;
       for (const c of children) {
         this.items.set(c, { epc: c, location: m.location, disposition: m.disposition });
-        const n = this.nodes.get(m.location);
+        const n = this.locations.get(m.location);
         if (n) n.occupancy++;
         this.emit(objectEvent({ eventTime: this.now(), action: "ADD", bizStep: opts.bizStep, disposition: m.disposition, epcList: [c], readPoint: m.location, bizLocation: m.location }));
       }
@@ -2011,22 +2155,22 @@ var FlowEngine = class {
   }
   /** 품질 보고(OEE Quality) — 도메인이 완료 시 자원별 양품/불량 1건 계상(예: 용접 수율). */
   recordOutput(moverId, good) {
-    const m = moverId ? this.movers.get(moverId) : void 0;
+    const m = moverId ? this.equipment.get(moverId) : void 0;
     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). */
+  /** 설비 OEE(스냅샷 파생) — Availability×Performance×Quality. planned = 설비 존재 sim 시간(clockMs). */
   oeeOf(m) {
     return computeOee(m, this.clockMs);
   }
-  /** 정책에 넘길 특정 타입 노드의 관측 뷰 — 예약(그 노드로 향하는 in-flight task) 포함. */
-  slotViews(nodeType) {
+  /** 정책에 넘길 특정 타입 자리의 관측 뷰 — 예약(그 자리로 향하는 in-flight task) 포함. */
+  slotViews(locationType) {
     const reserved = /* @__PURE__ */ new Map();
     for (const t of this.tasks.values()) if (t.status !== "completed") reserved.set(t.toNode, (reserved.get(t.toNode) ?? 0) + 1);
     const views = [];
-    for (const n of this.nodes.values()) if (n.type === nodeType) views.push({ id: n.id, capacity: n.capacity, occupancy: n.occupancy, reserved: reserved.get(n.id) ?? 0 });
+    for (const n of this.locations.values()) if (n.type === locationType) views.push({ id: n.id, capacity: n.capacity, occupancy: n.occupancy, reserved: reserved.get(n.id) ?? 0 });
     return views;
   }
   emit(event) {
@@ -2068,15 +2212,15 @@ var FlowEngine = class {
   }
   /** 사람 상태 전이 — 설비와 별개 채널(어휘가 다르다: 고장이 아니라 교대·투입). */
   emitAsset(a) {
-    this.emitOp(OP_EVENT.asset, { assetId: a.id, assetClass: a.assetClass, status: a.status, location: a.location, taskId: a.taskId ?? void 0, carrying: a.carrying });
+    this.emitOp(OP_EVENT.asset, { assetId: a.id, assetClassIds: a.assetClassIds, status: a.status, location: a.location, taskId: a.taskId ?? void 0, carrying: a.carrying });
   }
   emitPerson(p) {
-    this.emitOp(OP_EVENT.person, { personId: p.id, personnelClass: p.personnelClass, status: p.status, taskId: p.taskId ?? void 0, ...this.personOffShift(p) ? { offShift: true } : {} });
+    this.emitOp(OP_EVENT.person, { personId: p.id, personnelClassIds: p.personnelClassIds, status: p.status, taskId: p.taskId ?? void 0, ...p.location ? { location: p.location } : {}, ...this.personOffShift(p) ? { offShift: true } : {} });
   }
   /** 설비 상태 전이 — `taskId` 를 함께 싣는다(사람·자산 델타와 같은 규칙). 없으면 미러가 "이 설비가
    *  무슨 일을 하는 중인가" 를 알 수 없어 작업↔자원 연결이 한쪽에서만 성립한다. */
-  emitMover(m, motion) {
-    this.emitOp(OP_EVENT.equipment, { moverId: m.id, kind: m.kind, status: m.status, location: m.location, taskId: m.taskId ?? void 0, motion });
+  emitEquipment(m, motion) {
+    this.emitOp(OP_EVENT.equipment, { moverId: m.id, kind: m.kind, status: m.status, location: m.location, ...m.homeLocation ? { homeLocation: m.homeLocation } : {}, taskId: m.taskId ?? void 0, motion });
   }
   /** 오더 델타 — **라인까지 싣는다.** 라인이 빠지면 미러가 남은 데맨드를 라인별로 재계획할 수 없다. */
   emitOrder(o) {
@@ -2156,7 +2300,8 @@ var FlowEngine = class {
       const want = Math.max(0, Math.floor(req.quantity ?? 0));
       if (!want) continue;
       const avail = [...this.assets.values()].filter(
-        (a) => a.status === "idle" && !picked.includes(a.id) && (req.assetClass === void 0 || a.assetClass === req.assetClass)
+        /* 인원과 같은 규칙 — 상속을 타고 닫아 판정하고 유효기간 밖은 제외한다. 요구는 등급 하나+수량. */
+        (a) => a.status === "idle" && !picked.includes(a.id) && (req.assetClass === void 0 || classClosure(a.assetClassIds, this.classDefs.asset, this.now()).has(req.assetClass))
       );
       if (avail.length < want) return null;
       for (let i = 0; i < want; i++) picked.push(avail[i].id);
@@ -2213,7 +2358,10 @@ var FlowEngine = class {
       const want = Math.max(0, Math.floor(req.quantity ?? 0));
       if (!want) continue;
       const avail = [...this.persons.values()].filter(
-        (p) => p.status === "idle" && !picked.includes(p.id) && !this.personOffShift(p) && (req.personnelClass === void 0 || p.personnelClass === req.personnelClass)
+        (p) => p.status === "idle" && !picked.includes(p.id) && !this.personOffShift(p) && /* 자격은 **상속을 타고 닫아** 판정한다 — 사람은 여러 등급에 속할 수 있고(표준), 등급은
+           다른 등급을 상속한다. "생산직 2명" 요구를 "용접 자격자" 가 만족해야 한다.
+           유효기간 밖의 등급은 닫힘에서 빠진다(만료된 자격으로 배정되지 않는다). */
+        (req.personnelClass === void 0 || classClosure(p.personnelClassIds, this.classDefs.personnel, this.now()).has(req.personnelClass))
       );
       if (avail.length < want) return null;
       for (let i = 0; i < want; i++) picked.push(avail[i].id);
@@ -2226,8 +2374,11 @@ var FlowEngine = class {
    * 여기서는 고르기만 한다 — 확정은 호출부가 다른 자원까지 확보한 뒤에 한다.
    */
   claimEquipment(t) {
-    const free = (kind, picked2 = []) => [...this.movers.values()].filter(
-      (m) => m.status === "idle" && !m.held && !this.offShift(m) && !picked2.includes(m.id) && (kind === void 0 || m.kind === kind)
+    const free = (kind, picked2 = []) => [...this.equipment.values()].filter(
+      (m) => m.status === "idle" && !m.held && !this.offShift(m) && !picked2.includes(m.id) && /* 설비의 소속은 아직 단수(`kind`)다 — 저널에 기록이 쌓여 복수화를 별도 작업으로 두었다.
+         다만 등급 정의가 있으면 **상속은 지금도 탄다**: 'welder-6axis' 가 'welder' 를 상속하면
+         'welder' 요구를 만족한다. 단수/복수와 상속은 다른 축이므로 하나를 기다리지 않는다. */
+      (kind === void 0 || classClosure(m.kind ? [m.kind] : [], this.classDefs.equipment, this.now()).has(kind))
     );
     const need = this.operationSpecs.get(t.kind)?.equipmentSpecification;
     if (!need?.length) {
@@ -2277,12 +2428,12 @@ var FlowEngine = class {
    * 이 자리가 동시 처리 한도에 찼는가 — `parallelism` 을 선언한 자리만 판정한다(미선언=제약 없음).
    * 세는 대상은 **그 자리에서 진행 중인 작업**(`toNode` 기준, in-progress). 대기 중인 작업은 세지 않는다.
    */
-  stationFull(nodeId) {
-    if (!nodeId) return false;
-    const limit = this.nodes.get(nodeId)?.parallelism;
+  stationFull(locationId) {
+    if (!locationId) return false;
+    const limit = this.locations.get(locationId)?.parallelism;
     if (!(typeof limit === "number" && limit > 0)) return false;
     let running = 0;
-    for (const t of this.tasks.values()) if (t.status === "in-progress" && t.toNode === nodeId) running++;
+    for (const t of this.tasks.values()) if (t.status === "in-progress" && t.toNode === locationId) running++;
     return running >= limit;
   }
   /** 교대 밖인가 — 자원이 지금 일하지 않는 이유 중 고장·계획정지와 구별되는 세 번째. */
@@ -2312,19 +2463,19 @@ var FlowEngine = class {
     return -Math.log(1 - this.rng()) * meanMs;
   }
   /**
-   * 확률적 설비 고장(MTBF/MTTR) — mtbf 지정 무버만 참여(미지정=고장 없음, rng 무소비 → byte-identical).
+   * 확률적 설비 고장(MTBF/MTTR) — mtbf 지정 설비만 참여(미지정=고장 없음, rng 무소비 → byte-identical).
    * up: nextFailure 도래 시 down(수리까지 repairUntil). down: downMs 누적, repair 도래 시 up(다음 고장 예약).
-   * down 중 무버는 배정 불가 + 진행중 task 동결(processTasks 가 skip) → OEE Availability 손실.
+   * down 중 설비는 배정 불가 + 진행중 task 동결(processTasks 가 skip) → OEE Availability 손실.
    */
   processFailures(dt) {
-    for (const m of this.movers.values()) {
+    for (const m of this.equipment.values()) {
       if (m.status === "down") {
         m.downMs += dt;
         if (m.repairUntilMs != null && this.clockMs >= m.repairUntilMs) {
           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);
+          this.emitEquipment(m);
         }
         continue;
       }
@@ -2336,7 +2487,7 @@ var FlowEngine = class {
         m.status = "down";
         m.repairUntilMs = this.clockMs + this.sampleExp(m.mttrMs ?? m.mtbfMs);
         m.nextFailureMs = void 0;
-        this.emitMover(m);
+        this.emitEquipment(m);
       }
     }
   }
@@ -2422,34 +2573,34 @@ var FlowEngine = class {
       if (this.stationFull(t.toNode)) continue;
       const rigs = this.claimEquipment(t);
       if (!rigs) continue;
-      const mover = this.movers.get(rigs[0]);
-      if (t.setupMs && t.changeoverKey !== void 0 && mover.lastChangeoverKey !== void 0 && mover.lastChangeoverKey !== t.changeoverKey) {
+      const eq = this.equipment.get(rigs[0]);
+      if (t.setupMs && t.changeoverKey !== void 0 && eq.lastChangeoverKey !== void 0 && eq.lastChangeoverKey !== t.changeoverKey) {
         t.appliedSetupMs = t.setupMs;
         t.durationMs += t.setupMs;
       }
-      if (t.changeoverKey !== void 0) mover.lastChangeoverKey = t.changeoverKey;
+      if (t.changeoverKey !== void 0) eq.lastChangeoverKey = t.changeoverKey;
       for (const id of rigs) {
-        const m = this.movers.get(id);
+        const m = this.equipment.get(id);
         m.status = "busy";
         m.taskId = t.id;
       }
       t.status = "in-progress";
-      t.resource = mover.id;
+      t.resource = eq.id;
       t.remainingMs = t.durationMs;
       t.startedAtSimMs = this.clockMs;
       if (rigs.length > 1) t.resources = rigs.slice();
       this.assignCrew(t, crew);
       this.assignAssets(t, gear);
       this.emitTask(t);
-      if (t.intent === "process") this.emitMover(mover);
-      else this.emitMover(mover, { fromNode: t.fromNode, toNode: t.toNode, startedAtSimMs: this.clockMs, durationMs: t.durationMs, progress: 0, elapsedMs: 0 });
+      if (t.intent === "process") this.emitEquipment(eq);
+      else this.emitEquipment(eq, { fromNode: t.fromNode, toNode: t.toNode, startedAtSimMs: this.clockMs, durationMs: t.durationMs, progress: 0, elapsedMs: 0 });
     }
   }
   /** in-progress 진행/완료 — 상태 효과는 전부 도메인(onTaskComplete). base 는 자원 해제·델타만. */
   advanceTasks(dt) {
     for (const t of this.tasks.values()) {
       if (t.status !== "in-progress") continue;
-      if (t.resource && this.movers.get(t.resource)?.status === "down") continue;
+      if (t.resource && this.equipment.get(t.resource)?.status === "down") continue;
       t.remainingMs -= dt;
       if (t.remainingMs > 0) continue;
       this.onTaskComplete(t);
@@ -2460,26 +2611,26 @@ var FlowEngine = class {
         this.emitTask(t);
         continue;
       }
-      const mover = this.movers.get(t.resource);
+      const eq = this.equipment.get(t.resource);
       const setup = t.appliedSetupMs ?? 0;
-      mover.setupMs += setup;
-      mover.runMs += t.durationMs - setup;
-      mover.status = "idle";
-      mover.taskId = null;
-      if (t.intent !== "process") mover.location = t.toNode;
+      eq.setupMs += setup;
+      eq.runMs += t.durationMs - setup;
+      eq.status = "idle";
+      eq.taskId = null;
+      if (t.intent !== "process") eq.location = t.toNode;
       for (const id of t.resources ?? []) {
-        if (id === mover.id) continue;
-        const m = this.movers.get(id);
+        if (id === eq.id) continue;
+        const m = this.equipment.get(id);
         if (!m) continue;
         m.setupMs += setup;
         m.runMs += t.durationMs - setup;
         m.status = "idle";
         m.taskId = null;
         if (t.intent !== "process") m.location = t.toNode;
-        this.emitMover(m);
+        this.emitEquipment(m);
       }
       this.emitTask(t);
-      this.emitMover(mover);
+      this.emitEquipment(eq);
     }
   }
 };
@@ -2496,7 +2647,7 @@ var WmsKernel = class extends FlowEngine {
   }
   /** 입고 도착 — §4 라이프사이클: ASN(PO) → 팔레트 조립 → 수령 → putaway task. */
   onArrival(spec) {
-    const dock = this.nodeByType("dock");
+    const dock = this.locationByType("dock");
     if (!dock) return;
     const epc = ssccUri(COMPANY_PREFIX, ++this.epcSeq);
     const gtin = this.pickGtin(spec.content.skuMix);
@@ -2586,14 +2737,14 @@ var WmsKernel = class extends FlowEngine {
    * 멀티SKU 는 여러 라인의 팔레트를 한 오더로 모아 단일 출하(finalizeOrder 통합 화물).
    */
   allocate(o) {
-    const staging = this.nodeByType("staging");
+    const staging = this.locationByType("staging");
     if (!staging || !o.lines) return;
     const chosenAll = [];
     for (const line of o.lines) {
       const already = o.allocated.filter((e) => this.items.get(e)?.gtin === line.gtin).length;
       const need = line.requested - already;
       if (need <= 0) continue;
-      const available = [...this.items.values()].filter((i) => i.gtin === line.gtin && i.disposition === DISP.sellable && this.nodes.get(i.location)?.type === "storage").map((i) => ({ epc: i.epc, location: i.location, qty: i.qty ?? 1, expiry: i.expiry }));
+      const available = [...this.items.values()].filter((i) => i.gtin === line.gtin && i.disposition === DISP.sellable && this.locations.get(i.location)?.type === "storage").map((i) => ({ epc: i.epc, location: i.location, qty: i.qty ?? 1, expiry: i.expiry }));
       const chosen = this.policy.selectStock({ gtin: line.gtin, qty: need, available });
       for (const epc of chosen) {
         o.allocated.push(epc);
@@ -2616,8 +2767,8 @@ var WmsKernel = class extends FlowEngine {
   /** 태스크 완료 — 이동 반영 후 putaway=storing, pick=picking(+전량 시 pack→stage→ship). */
   onTaskComplete(t) {
     const item = this.items.get(t.itemEpc);
-    const from = this.nodes.get(t.fromNode);
-    const to = this.nodes.get(t.toNode);
+    const from = this.locations.get(t.fromNode);
+    const to = this.locations.get(t.toNode);
     from.occupancy--;
     to.occupancy++;
     item.location = to.id;
@@ -2635,7 +2786,7 @@ var WmsKernel = class extends FlowEngine {
   }
   /** 전량 피킹 → packing(조립)·staging·shipping 마감. 화물 사이트 이탈, 백오더 잔량 재할당. */
   finalizeOrder(order, staging) {
-    const shipDock = this.nodeByType("dock-ship") ?? staging;
+    const shipDock = this.locationByType("dock-ship") ?? staging;
     const eventTime = this.now();
     const shipment = ssccUri(COMPANY_PREFIX, ++this.epcSeq);
     order.shipmentEpc = shipment;
@@ -2693,8 +2844,8 @@ var YmsKernel = class extends FlowEngine {
   }
   /** 게이트-인 — 트레일러 도착 → 어포인트먼트(도크도어 배정 + 창). drop 은 야드 주차 태스크, live 는 게이트 대기. */
   spawnAppointment(kind) {
-    const gate = this.nodeByType("gate");
-    const doors = [...this.nodes.values()].filter((n) => n.type === "dock-door").sort((a, b) => a.id.localeCompare(b.id));
+    const gate = this.locationByType("gate");
+    const doors = [...this.locations.values()].filter((n) => n.type === "dock-door").sort((a, b) => a.id.localeCompare(b.id));
     if (!gate || doors.length === 0) return;
     const inbound = kind === "appointment";
     const epc = graiUri(CP, "10", ++this.epcSeq);
@@ -2731,15 +2882,15 @@ var YmsKernel = class extends FlowEngine {
     const trailer = this.items.get(o.allocated[0]);
     if (!trailer) return;
     if (this.clockMs < (o.windowStartMs ?? 0)) return;
-    const door = this.nodes.get(o.dockDoor);
+    const door = this.locations.get(o.dockDoor);
     const inflight = [...this.tasks.values()].some((t) => t.status !== "completed" && t.toNode === door.id);
     if (door.occupancy > 0 || inflight) return;
     const mode = this.apptMode.get(o.id) ?? "drop";
-    if (mode === "drop" && this.nodes.get(trailer.location)?.type !== "yard-slot") return;
+    if (mode === "drop" && this.locations.get(trailer.location)?.type !== "yard-slot") return;
     const outbound = o.kind === "appointment-out";
     const bizStep = outbound ? YARD_BIZSTEP.loading : YARD_BIZSTEP.unloading;
     if (outbound) {
-      const staging = this.nodeByType("staging");
+      const staging = this.locationByType("staging");
       const reserved = new Set([...this.trailerCargo.values()].flat());
       const avail = [...this.items.values()].filter((i) => i.location === staging?.id && i.disposition === DISP.sellable && !reserved.has(i.epc)).sort((a, b) => a.epc.localeCompare(b.epc));
       if (!staging || avail.length < CARGO_PER_TRAILER) return;
@@ -2757,13 +2908,13 @@ var YmsKernel = class extends FlowEngine {
   /** 태스크 완료 — 목적지 타입으로 분기: yard-slot=주차, dock-door=상/하차+depart, gate=출차. */
   onTaskComplete(t) {
     const trailer = this.items.get(t.itemEpc);
-    const from = this.nodes.get(t.fromNode);
-    const to = this.nodes.get(t.toNode);
+    const from = this.locations.get(t.fromNode);
+    const to = this.locations.get(t.toNode);
     from.occupancy--;
     to.occupancy++;
     trailer.location = to.id;
     if (t.kind === "dwell") {
-      const gate = this.nodeByType("gate");
+      const gate = this.locationByType("gate");
       const dep = { id: `task-${++this.taskSeq}`, kind: "depart", status: "created", itemEpc: trailer.epc, fromNode: t.toNode, toNode: gate.id, resource: null, remainingMs: 0, durationMs: this.durationOf({ kind: "depart", fromNode: t.toNode, toNode: gate.id }, TRAVEL_MS2), orderId: t.orderId };
       this.tasks.set(dep.id, dep);
       this.emitTask(dep);
@@ -2777,7 +2928,7 @@ var YmsKernel = class extends FlowEngine {
     if (to.type === "dock-door") {
       const order2 = t.orderId ? this.orders.get(t.orderId) : void 0;
       const outbound = order2?.kind === "appointment-out";
-      const staging = this.nodeByType("staging");
+      const staging = this.locationByType("staging");
       const cargo = this.trailerCargo.get(trailer.epc) ?? [];
       this.observeDisposition([trailer.epc], DISP.in_progress, outbound ? YARD_BIZSTEP.loading : YARD_BIZSTEP.unloading, to.id);
       if (outbound) {
@@ -2829,10 +2980,10 @@ 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" }
+  { kind: "cut", locationType: "cut-station", resource: "cutter" },
+  { kind: "weld", locationType: "weld-station", resource: "welder" },
+  { kind: "paint", locationType: "paint-booth", resource: "painter" },
+  { kind: "assembly", locationType: "assembly-line", resource: "assembler" }
 ];
 var MesKernel = class extends FlowEngine {
   wipSeq = 0;
@@ -2857,12 +3008,12 @@ var MesKernel = class extends FlowEngine {
     if (cmd.type === MES_CMD.changeover) {
       const a = cmd.args;
       if (!a?.resourceId || !a?.gtin) return { commandId: cmd.commandId, accepted: false, errorCode: "changeover-needs-args", error: "mes.changeover: resourceId and gtin required" };
-      const m = this.movers.get(a.resourceId);
+      const m = this.equipment.get(a.resourceId);
       if (!m) return { commandId: cmd.commandId, accepted: false, errorCode: "resource-not-found", errorParams: { resourceId: a.resourceId }, error: `resource-not-found: ${a.resourceId}` };
       if (m.lastChangeoverKey !== a.gtin) {
         m.setupMs += DEFAULT_SETUP_MS;
         m.lastChangeoverKey = a.gtin;
-        this.emitMover(m);
+        this.emitEquipment(m);
       }
       return { commandId: cmd.commandId, accepted: true };
     }
@@ -2871,7 +3022,7 @@ var MesKernel = class extends FlowEngine {
   /** 부품 수령(다품종) — skuMix 의 gtin 으로 부품 종류 결정. */
   onArrival(spec) {
     if (this.mesSpec) return this.onArrivalDef(spec);
-    const rawStore = this.nodeByType("raw-store");
+    const rawStore = this.locationByType("raw-store");
     if (!rawStore) return;
     const gtin = this.pickGtin(spec.content.skuMix);
     const part = [PART_A, PART_B].find((p) => p.gtin === gtin);
@@ -2895,12 +3046,12 @@ var MesKernel = class extends FlowEngine {
   allocate(o) {
     if (this.mesSpec) return this.allocateDef(o);
     const s0 = ROUTE[0];
-    const first = this.nodeByType(s0.node);
+    const first = this.locationByType(s0.locationType);
     const product = this.productOf(o.gtin);
     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 }));
+      const available = [...this.items.values()].filter((i) => i.gtin === line.part.gtin && i.disposition === DISP.sellable && this.locations.get(i.location)?.type === "raw-store").map((i) => ({ epc: i.epc, location: i.location, qty: 1 }));
       const chosen = this.policy.selectStock({ gtin: line.part.gtin, qty: line.qty, available });
       if (chosen.length < line.qty) return;
       picks.push(...chosen);
@@ -2914,8 +3065,8 @@ var MesKernel = class extends FlowEngine {
   }
   /** 라우트 스테이션 태스크 발행(공통) — 제자리 가공(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 }, DEFAULT_CYCLE_MS), orderId: o.id, resourceType: stage.resource, changeoverKey, setupMs: this.paramDuration(stage.kind, OP_PARAM.setupDuration) ?? DEFAULT_SETUP_MS, intent: "process" };
+    const loc = this.locationByType(stage.locationType);
+    const task = { id: `task-${++this.taskSeq}`, kind: stage.kind, status: "created", itemEpc, fromNode: loc.id, toNode: loc.id, resource: null, remainingMs: 0, durationMs: this.durationOf({ kind: stage.kind, fromNode: loc.id, toNode: loc.id, resourceKind: stage.resource }, DEFAULT_CYCLE_MS), orderId: o.id, resourceType: stage.resource, changeoverKey, setupMs: this.paramDuration(stage.kind, OP_PARAM.setupDuration) ?? DEFAULT_SETUP_MS, intent: "process" };
     this.tasks.set(task.id, task);
     this.emitTask(task);
   }
@@ -2925,12 +3076,12 @@ var MesKernel = class extends FlowEngine {
     const order = this.orders.get(t.orderId);
     const product = this.productOf(order.gtin);
     const i = ROUTE.findIndex((s) => s.kind === t.kind);
-    const node = this.nodes.get(t.toNode);
+    const loc = this.locations.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: 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 }] });
+      this.transform(inputs, [{ epc: wip2, gtin: WIP_GTIN, qty: 1, location: loc.id, disposition: DISP.in_progress }], { bizStep: MES_BIZSTEP.producing, disposition: DISP.in_progress, transformationId: order.bizTransaction, readPoint: loc.id, bizTransactionList: [{ type: BTT_PRODORDER, bizTransaction: order.bizTransaction }] });
       order.allocated = [wip2];
       const next = ROUTE[i + 1];
       this.emitStation(order, next, wip2, product.gtin);
@@ -2938,13 +3089,13 @@ var MesKernel = class extends FlowEngine {
       this.emitOrder(order);
       return;
     }
-    const fgStore = this.nodeByType("fg-store");
+    const fgStore = this.locationByType("fg-store");
     const wip = order.allocated[0];
     const good = this.rng() < (this.paramNumber(t.kind, OP_PARAM.yield) ?? DEFAULT_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: node.id, bizTransactionList: [{ type: BTT_PRODORDER, bizTransaction: order.bizTransaction }] });
+    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: loc.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;
@@ -2971,7 +3122,7 @@ var MesKernel = class extends FlowEngine {
   }
   /** 정의 모드 수령 — skuMix gtin 이 레시피 입력 자재면 raw-store 에 생성. */
   onArrivalDef(spec) {
-    const rawStore = this.nodeByType("raw-store");
+    const rawStore = this.locationByType("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);
@@ -2993,12 +3144,12 @@ var MesKernel = class extends FlowEngine {
   /** 정의 모드 할당 — 레시피 입력 BOM 전량 확보 후 첫 라우트 스텝 태스크. */
   allocateDef(o) {
     const ops = this.routeOps();
-    if (!ops.length || !ops[0].nodeType || !this.nodeByType(ops[0].nodeType)) return;
+    if (!ops.length || !ops[0].locationType || !this.locationByType(ops[0].locationType)) 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 available = [...this.items.values()].filter((i) => i.gtin === g && i.disposition === DISP.sellable && this.locations.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);
@@ -3011,8 +3162,8 @@ var MesKernel = class extends FlowEngine {
     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 }, DEFAULT_CYCLE_MS), orderId: o.id, resourceType: op.resourceType, changeoverKey: o.gtin, setupMs: this.paramDuration(op.key, OP_PARAM.setupDuration) ?? DEFAULT_SETUP_MS, intent: op.intent };
+    const loc = this.locationByType(op.locationType);
+    const task = { id: `task-${++this.taskSeq}`, kind: op.key, status: "created", itemEpc, fromNode: loc.id, toNode: loc.id, resource: null, remainingMs: 0, durationMs: this.durationOf({ kind: op.key, fromNode: loc.id, toNode: loc.id, resourceKind: op.resourceType }, DEFAULT_CYCLE_MS), orderId: o.id, resourceType: op.resourceType, changeoverKey: o.gtin, setupMs: this.paramDuration(op.key, OP_PARAM.setupDuration) ?? DEFAULT_SETUP_MS, intent: op.intent };
     this.tasks.set(task.id, task);
     this.emitTask(task);
   }
@@ -3022,14 +3173,14 @@ var MesKernel = class extends FlowEngine {
     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 loc = this.locations.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 }] });
+      this.transform(inputs, [{ epc: wip2, gtin: wipGtin, qty: 1, location: loc.id, disposition: DISP.in_progress }], { bizStep, disposition: DISP.in_progress, transformationId: order.bizTransaction, readPoint: loc.id, bizTransactionList: [{ type: BTT_PRODORDER, bizTransaction: order.bizTransaction }] });
       order.allocated = [wip2];
       const next = ops[i + 1];
       this.emitStationDef(order, next, wip2);
@@ -3037,14 +3188,14 @@ var MesKernel = class extends FlowEngine {
       this.emitOrder(order);
       return;
     }
-    const fgStore = this.nodeByType("fg-store");
+    const fgStore = this.locationByType("fg-store");
     const wip = order.allocated[0];
     const good = this.rng() < (this.paramNumber(t.kind, OP_PARAM.yield) ?? DEFAULT_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.transform([wip], [{ epc: outEpc, gtin: outGtin, qty: 1, location: fgStore.id, disposition: disp }], { bizStep, disposition: disp, transformationId: order.bizTransaction, readPoint: loc.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;
@@ -3052,6 +3203,43 @@ var MesKernel = class extends FlowEngine {
     this.emitOrder(order);
   }
 };
+
+// src/vocabulary.ts
+var RETIRED_VOCABULARY = ["mover", "Mover", "MOVER", "node", "Node", "NODE"];
+var VOCABULARY_EXCEPTIONS = [
+  /* ── 저널 와이어 필드 — append-only 역사이므로 이름을 바꾸지 않는다 ───────
+   * 같은 사실이 시점에 따라 다른 키로 들어가면 낡은 이름보다 나쁘다. 개명은 이벤트 스키마
+   * 버저닝과 함께 다룬다. (개명 시점 실측: moverId 8,965행 · fromNode/toNode 9,679행) */
+  { token: "moverId", why: "journal wire field \u2014 renaming would mix two keys for one fact across history" },
+  { token: "fromNode", why: "journal wire field (task.status payload)" },
+  { token: "toNode", why: "journal wire field (task.status payload)" },
+  /* ── 씬 컴포넌트 타입 — 보드에 저장된 값이고, 뜻이 어긋나지도 않는다 ──────
+   * 보드 7개가 이 타입으로 컴포넌트를 담고 있어 개명하면 그 컴포넌트가 조용히 안 그려진다.
+   * 그리고 씬에서 이 이름은 자원이 아니라 **움직임 표현**을 가리킨다(표준과 충돌 아님). */
+  { token: "twin-mover", why: "scene component type persisted in boards; names a motion representation, not a resource" },
+  { token: "TwinMover", why: "class backing the persisted scene component type above" },
+  /* ── 플랫폼·언어 어휘 — 우리 도메인 낱말이 아니다 ─────────────────────── */
+  { token: "node_modules", why: "npm path" },
+  { token: "node:", why: "Node.js builtin module specifier" },
+  { token: "nodemon", why: "tool name" },
+  { token: "Node.js", why: "platform name" },
+  { token: "NodeJS", why: "TypeScript global namespace" },
+  { token: "nodeName", why: "DOM API" },
+  { token: "childNodes", why: "DOM API" },
+  { token: "appendChild", why: "DOM API (no match, kept for clarity)" }
+];
+var GUARD_PRAGMA = "vocabulary-guard: allow";
+function retiredVocabularyIn(line) {
+  if (line.includes(GUARD_PRAGMA)) return [];
+  let rest = line;
+  for (const { token } of VOCABULARY_EXCEPTIONS) rest = rest.split(token).join(" ");
+  const hits = [];
+  for (const word of RETIRED_VOCABULARY) {
+    const re = new RegExp(`[A-Za-z_]*${word}[A-Za-z_]*`, "g");
+    for (const m of rest.matchAll(re)) hits.push(m[0]);
+  }
+  return hits;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BIZSTEP,
@@ -3065,34 +3253,39 @@ var MesKernel = class extends FlowEngine {
   DOMAIN_CATALOG,
   DOMAIN_SYSTEMS,
   EPCIS_CONTEXT,
+  EQUIPMENT_LEVEL,
   EventJournal,
   FlowEngine,
+  GUARD_PRAGMA,
   ILMD_ATTR,
+  LOCATION_SATURATION_NEAR,
   MES_BIZSTEP,
-  MES_NODE_TYPES,
+  MES_LOCATION_TYPES,
   MES_PART_GTINS,
   MES_PRODUCTS,
   MES_PRODUCT_GTINS,
   MES_TYPES,
   MesKernel,
-  NODE_SATURATION_NEAR,
   OP_EVENT,
   OP_PARAM,
   ObservedReducer,
+  RETIRED_VOCABULARY,
   StateProjector,
   TwinHistory,
   TwinObserver,
   TwinRuntime,
   UTC_OFFSET,
-  WMS_NODE_TYPES,
+  VOCABULARY_EXCEPTIONS,
+  WMS_LOCATION_TYPES,
   WMS_TYPES,
   WmsKernel,
   YARD_BIZSTEP,
-  YMS_NODE_TYPES,
+  YMS_LOCATION_TYPES,
   YMS_TYPES,
   YmsKernel,
   aggregationEvent,
   capabilitiesForType,
+  classClosure,
   compareStates,
   computeOee,
   constantDuration,
@@ -3103,16 +3296,22 @@ var MesKernel = class extends FlowEngine {
   foldTaskRecords,
   gdtiUri,
   graiUri,
+  hierarchyOf,
   ingest,
+  isEquipmentLevel,
   lgtinClass,
+  locationStatusOf,
   mapRecord,
   monteCarloForecast,
-  nodeStatusOf,
   objectEvent,
   parseEpc,
   parseIsoDuration,
   partialFitPolicy,
+  readBoardAssets,
+  readBoardEquipment,
+  readBoardLocations,
   replay,
+  retiredVocabularyIn,
   sgtinClass,
   sgtinUri,
   ssccUri,