@things-factory/headless-twin 10.0.7 → 10.0.9

package/dist-server/service/reference/knob-defaults.js

@@ -0,0 +1,59 @@
+"use strict";
+/*
+ * 노브 기본값 적용 — **순수**. "안 준 값은 템플릿이 선언한 기본값으로."
+ *
+ * ── 왜 있나 (2026-08-05) ────────────────────────────────────────────────────
+ * 템플릿은 노브마다 기본값을 선언한다(`knobs[].default`). 그런데 그 기본값을 채우는 일을 **위자드만**
+ * 하고 있었다 — 서버는 받은 파라미터를 그대로 `build(p)` 에 넘긴다. 그래서 파라미터를 일부만 주고
+ * 부르면(AI·스크립트·API 호출자) 템플릿 안에서 `Number(p.inboundRate) || 0` 이 **0** 이 되고,
+ * 발생률 0 = 도착 없음 = **아무것도 하지 않는 트윈**이 조용히 만들어진다.
+ *
+ * 실제로 그 함정을 밟았다: 유통가공 창고를 파라미터 일부만 주고 만들었더니 이벤트가 0건이었고,
+ * 처음에는 템플릿이 깨진 것으로 오진했다. 기본값을 아는 곳이 계약(노브 스키마)인데 그것을 적용하는
+ * 곳이 화면뿐이면, 화면을 거치지 않는 모든 경로가 함정이 된다.
+ *
+ * ── 0 을 기본값으로 덮지 않는다 ─────────────────────────────────────────────
+ * 발생률 `0` 은 "도착 없음" 이라는 **뜻 있는 값**이다. 없는 것과 0 은 다르다 — falsy 로 판정해 덮으면
+ * "자극 없이 구조만 보겠다" 는 선언이 조용히 뒤집힌다. 그래서 **키가 없을 때만** 채운다.
+ * `null` 은 없는 것으로 본다(JSON·GraphQL 경로에서 "주지 않음" 이 null 로 오는 일이 흔하다).
+ *
+ * ── 선언 밖 파라미터는 손대지 않는다 ────────────────────────────────────────
+ * 템플릿은 노브에 없는 값도 읽는다(예: `geo` 대신 `lat`/`lon` 폴백). 모르는 키를 걷어내면 그 경로가
+ * 조용히 끊긴다. 그대로 통과시킨다.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyKnobDefaults = applyKnobDefaults;
+exports.filledKnobKeys = filledKnobKeys;
+/**
+ * 빠진 노브를 기본값으로 채운다.
+ *
+ * @param knobs  템플릿이 선언한 노브들(없으면 파라미터를 그대로 돌려준다).
+ * @param params 호출자가 준 파라미터.
+ * @returns 새 객체 — 입력을 바꾸지 않는다(호출자의 객체가 몰래 변하면 추적이 어렵다).
+ */
+function applyKnobDefaults(knobs, params) {
+    const out = { ...(params ?? {}) };
+    for (const k of knobs ?? []) {
+        if (!k?.key)
+            continue;
+        if (k.default === undefined)
+            continue; // 기본값을 선언하지 않은 노브는 채울 것이 없다
+        const given = out[k.key];
+        if (given === undefined || given === null)
+            out[k.key] = k.default;
+    }
+    return out;
+}
+/**
+ * 기본값으로 채운 노브 이름들 — 호출자에게 "무엇을 내가 정해 줬는지" 알릴 때 쓴다.
+ *
+ * 조용히 채우는 것도 조용히 비우는 것만큼 위험하다: 사용자가 준 적 없는 값으로 트윈이 만들어졌는데
+ * 아무 말이 없으면, 나중에 "왜 이 수치인가" 를 아무도 답할 수 없다.
+ */
+function filledKnobKeys(knobs, params) {
+    const given = params ?? {};
+    return (knobs ?? [])
+        .filter(k => k?.key && k.default !== undefined && (given[k.key] === undefined || given[k.key] === null))
+        .map(k => k.key);
+}
+//# sourceMappingURL=knob-defaults.js.map

package/dist-server/service/reference/knob-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knob-defaults.js","sourceRoot":"","sources":["../../../server/service/reference/knob-defaults.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;AAeH,8CASC;AAQD,wCAKC;AA7BD;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAC,KAA6C,EAAE,MAAkD;IACjI,MAAM,GAAG,GAA4B,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAA;IAC1D,KAAK,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,EAAE,GAAG;YAAE,SAAQ;QACrB,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS;YAAE,SAAQ,CAAC,4BAA4B;QAClE,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QACxB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAA;IACnE,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,KAA6C,EAAE,MAAkD;IAC9H,MAAM,KAAK,GAAG,MAAM,IAAI,EAAE,CAAA;IAC1B,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;SACjB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAI,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,GAAI,CAAC,KAAK,IAAI,CAAC,CAAC;SACzG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAI,CAAC,CAAA;AACrB,CAAC","sourcesContent":["/*\n * 노브 기본값 적용 — **순수**. \"안 준 값은 템플릿이 선언한 기본값으로.\"\n *\n * ── 왜 있나 (2026-08-05) ────────────────────────────────────────────────────\n * 템플릿은 노브마다 기본값을 선언한다(`knobs[].default`). 그런데 그 기본값을 채우는 일을 **위자드만**\n * 하고 있었다 — 서버는 받은 파라미터를 그대로 `build(p)` 에 넘긴다. 그래서 파라미터를 일부만 주고\n * 부르면(AI·스크립트·API 호출자) 템플릿 안에서 `Number(p.inboundRate) || 0` 이 **0** 이 되고,\n * 발생률 0 = 도착 없음 = **아무것도 하지 않는 트윈**이 조용히 만들어진다.\n *\n * 실제로 그 함정을 밟았다: 유통가공 창고를 파라미터 일부만 주고 만들었더니 이벤트가 0건이었고,\n * 처음에는 템플릿이 깨진 것으로 오진했다. 기본값을 아는 곳이 계약(노브 스키마)인데 그것을 적용하는\n * 곳이 화면뿐이면, 화면을 거치지 않는 모든 경로가 함정이 된다.\n *\n * ── 0 을 기본값으로 덮지 않는다 ─────────────────────────────────────────────\n * 발생률 `0` 은 \"도착 없음\" 이라는 **뜻 있는 값**이다. 없는 것과 0 은 다르다 — falsy 로 판정해 덮으면\n * \"자극 없이 구조만 보겠다\" 는 선언이 조용히 뒤집힌다. 그래서 **키가 없을 때만** 채운다.\n * `null` 은 없는 것으로 본다(JSON·GraphQL 경로에서 \"주지 않음\" 이 null 로 오는 일이 흔하다).\n *\n * ── 선언 밖 파라미터는 손대지 않는다 ────────────────────────────────────────\n * 템플릿은 노브에 없는 값도 읽는다(예: `geo` 대신 `lat`/`lon` 폴백). 모르는 키를 걷어내면 그 경로가\n * 조용히 끊긴다. 그대로 통과시킨다.\n */\n\n/** 템플릿 노브 — 기본값 적용에 필요한 만큼만 본다. */\nexport interface KnobLike {\n  key?: string\n  default?: unknown\n}\n\n/**\n * 빠진 노브를 기본값으로 채운다.\n *\n * @param knobs  템플릿이 선언한 노브들(없으면 파라미터를 그대로 돌려준다).\n * @param params 호출자가 준 파라미터.\n * @returns 새 객체 — 입력을 바꾸지 않는다(호출자의 객체가 몰래 변하면 추적이 어렵다).\n */\nexport function applyKnobDefaults(knobs: readonly KnobLike[] | undefined | null, params: Record<string, unknown> | undefined | null): Record<string, unknown> {\n  const out: Record<string, unknown> = { ...(params ?? {}) }\n  for (const k of knobs ?? []) {\n    if (!k?.key) continue\n    if (k.default === undefined) continue // 기본값을 선언하지 않은 노브는 채울 것이 없다\n    const given = out[k.key]\n    if (given === undefined || given === null) out[k.key] = k.default\n  }\n  return out\n}\n\n/**\n * 기본값으로 채운 노브 이름들 — 호출자에게 \"무엇을 내가 정해 줬는지\" 알릴 때 쓴다.\n *\n * 조용히 채우는 것도 조용히 비우는 것만큼 위험하다: 사용자가 준 적 없는 값으로 트윈이 만들어졌는데\n * 아무 말이 없으면, 나중에 \"왜 이 수치인가\" 를 아무도 답할 수 없다.\n */\nexport function filledKnobKeys(knobs: readonly KnobLike[] | undefined | null, params: Record<string, unknown> | undefined | null): string[] {\n  const given = params ?? {}\n  return (knobs ?? [])\n    .filter(k => k?.key && k.default !== undefined && (given[k.key!] === undefined || given[k.key!] === null))\n    .map(k => k.key!)\n}\n"]}

package/dist-server/service/reference/reference-live.js

@@ -30,13 +30,13 @@ async function startReferenceLiveFeed(domainId, adapterType, cfg, site, instance
     index_js_1.TwinEngine.startLive(instanceId, domainId, det.kind ?? 'wms', await index_js_1.TwinEngine.withSpaceTimeBase(det.board, domainId));
     stopReferenceLiveFeed(instanceId); // 재기동 시 이전 피드 정리
     const unsubscribe = adapter.openLiveFeed(cfg, site, (records) => {
-        if (!index_js_1.TwinEngine.instances[instanceId]) {
+        if (!index_js_1.TwinEngine.owns(domainId, instanceId)) {
             stopReferenceLiveFeed(instanceId); // 인스턴스 사라지면 자가 정지(안전망)
             return;
         }
         const { accepted } = (0, index_js_1.ingestCanonicalRecords)(records, domainId, new Date().toISOString());
         if (accepted.length)
-            index_js_1.TwinEngine.ingestLive(instanceId, accepted);
+            index_js_1.TwinEngine.ingestLive(domainId, instanceId, accepted);
     });
     feeds.set(instanceId, unsubscribe);
     return true;

package/dist-server/service/reference/reference-live.js.map

@@ -1 +1 @@
-{"version":3,"file":"reference-live.js","sourceRoot":"","sources":["../../../server/service/reference/reference-live.ts"],"names":[],"mappings":";;AAkBA,wDA4BC;AAGD,sDAMC;AAGD,wDAEC;AA5DD,iEAA+F;AAC/F,oDAAgG;AAEhG;;;;;;GAMG;AAEH,iEAAiE;AACjE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAA;AAE3C;;;GAGG;AACI,KAAK,UAAU,sBAAsB,CAC1C,QAAgB,EAChB,WAAmB,EACnB,GAAqB,EACrB,IAAoB,EACpB,UAAkB;IAElB,MAAM,OAAO,GAAG,IAAA,iCAAU,EAAC,WAAW,CAAC,CAAA;IACvC,IAAI,CAAC,OAAO,EAAE,YAAY;QAAE,OAAO,KAAK,CAAA;IAExC,MAAM,GAAG,GAAG,MAAM,qBAAU,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;IACzD,IAAI,CAAC,GAAG,EAAE,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,aAAa,UAAU,gEAAgE,CAAC,CAAA;IAEzH,wFAAwF;IACxF,uDAAuD;IACvD,qBAAU,CAAC,SAAS,CAAC,UAAU,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,IAAI,KAAK,EAAE,MAAM,qBAAU,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAA;IAEtH,qBAAqB,CAAC,UAAU,CAAC,CAAA,CAAC,iBAAiB;IACnD,MAAM,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,OAAkB,EAAE,EAAE;QACzE,IAAI,CAAC,qBAAU,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;YACtC,qBAAqB,CAAC,UAAU,CAAC,CAAA,CAAC,uBAAuB;YACzD,OAAM;QACR,CAAC;QACD,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAA,iCAAsB,EAAC,OAA4B,EAAE,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAA;QAC7G,IAAI,QAAQ,CAAC,MAAM;YAAE,qBAAU,CAAC,UAAU,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;IAClE,CAAC,CAAC,CAAA;IACF,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA;IAClC,OAAO,IAAI,CAAA;AACb,CAAC;AAED,8BAA8B;AAC9B,SAAgB,qBAAqB,CAAC,UAAkB;IACtD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IACxB,IAAI,CAAC;QAAC,KAAK,EAAE,CAAA;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;IACpC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IACxB,OAAO,IAAI,CAAA;AACb,CAAC;AAED,oBAAoB;AACpB,SAAgB,sBAAsB;IACpC,OAAO,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;AAC1B,CAAC;AAED,kCAAkC;AAClC,qBAAU,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC,CAAA","sourcesContent":["import { getAdapter, type ConnectionConfig, type SiteDescriptor } from './reference-adapter.js'\nimport { TwinEngine, ingestCanonicalRecords, type CanonicalRecord } from '../../engine/index.js'\n\n/*\n * 커넥터 기반 라이브 피드 결선(reference → live, §0 프레임 ① realityMode='mirror').\n * 흐름: adapter.openLiveFeed(cfg, site, records) → ingestCanonicalRecords(정규→봉투) → TwinEngine.ingestLive(projector 미러).\n * 커넥터가 \"벤더 이벤트 → 정규 레코드\" 매핑을 소유(코드)한다 — preset 기반 startLiveFeed(operato-twin, http-get+jsonata)와\n * 대칭이되, 매핑 위치만 다르다. 실 시스템 전환은 connectionConfig.baseUrl 교체뿐(코드 경로 동일).\n * 생명주기: 인스턴스 정지(TwinEngine.stop)에 훅으로 묶여 피드도 함께 unsubscribe.\n */\n\n/** 활성 라이브 피드 — instanceId → unsubscribe(어댑터 openLiveFeed 반환). */\nconst feeds = new Map<string, () => void>()\n\n/**\n * 커넥터 라이브 기동 — 어댑터 openLiveFeed 를 인스턴스에 결선.\n * 반환: 라이브 결선 성공 여부(어댑터가 openLiveFeed 미지원이면 false → 호출측이 sim 폴백).\n */\nexport async function startReferenceLiveFeed(\n  domainId: string,\n  adapterType: string,\n  cfg: ConnectionConfig,\n  site: SiteDescriptor,\n  instanceId: string\n): Promise<boolean> {\n  const adapter = getAdapter(adapterType)\n  if (!adapter?.openLiveFeed) return false\n\n  const det = await TwinEngine.detail(domainId, instanceId)\n  if (!det?.board) throw new Error(`instance \"${instanceId}\" not provisioned (no board) — ingest master before live start`)\n\n  // mirror 모드 기동 — 커널 tick 없이 projector 가 실 이벤트를 미러(startLive 가 realityMode='mirror' 설정).\n  // 시각 기준은 **공간**이 갖는다(테넌트 아님) — 교대의 HH:MM 을 어느 기준으로 읽나.\n  TwinEngine.startLive(instanceId, domainId, det.kind ?? 'wms', await TwinEngine.withSpaceTimeBase(det.board, domainId))\n\n  stopReferenceLiveFeed(instanceId) // 재기동 시 이전 피드 정리\n  const unsubscribe = adapter.openLiveFeed(cfg, site, (records: unknown[]) => {\n    if (!TwinEngine.instances[instanceId]) {\n      stopReferenceLiveFeed(instanceId) // 인스턴스 사라지면 자가 정지(안전망)\n      return\n    }\n    const { accepted } = ingestCanonicalRecords(records as CanonicalRecord[], domainId, new Date().toISOString())\n    if (accepted.length) TwinEngine.ingestLive(instanceId, accepted)\n  })\n  feeds.set(instanceId, unsubscribe)\n  return true\n}\n\n/** 라이브 피드 중지(unsubscribe). */\nexport function stopReferenceLiveFeed(instanceId: string): boolean {\n  const unsub = feeds.get(instanceId)\n  if (!unsub) return false\n  try { unsub() } catch { /* noop */ }\n  feeds.delete(instanceId)\n  return true\n}\n\n/** 활성 피드 목록(관측). */\nexport function listReferenceLiveFeeds(): string[] {\n  return [...feeds.keys()]\n}\n\n/* 인스턴스 정지 시 피드 자동 정리(생명주기 대칭). */\nTwinEngine.onStop(instanceId => stopReferenceLiveFeed(instanceId))\n"]}
+{"version":3,"file":"reference-live.js","sourceRoot":"","sources":["../../../server/service/reference/reference-live.ts"],"names":[],"mappings":";;AAkBA,wDA4BC;AAGD,sDAMC;AAGD,wDAEC;AA5DD,iEAA+F;AAC/F,oDAAgG;AAEhG;;;;;;GAMG;AAEH,iEAAiE;AACjE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAA;AAE3C;;;GAGG;AACI,KAAK,UAAU,sBAAsB,CAC1C,QAAgB,EAChB,WAAmB,EACnB,GAAqB,EACrB,IAAoB,EACpB,UAAkB;IAElB,MAAM,OAAO,GAAG,IAAA,iCAAU,EAAC,WAAW,CAAC,CAAA;IACvC,IAAI,CAAC,OAAO,EAAE,YAAY;QAAE,OAAO,KAAK,CAAA;IAExC,MAAM,GAAG,GAAG,MAAM,qBAAU,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;IACzD,IAAI,CAAC,GAAG,EAAE,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,aAAa,UAAU,gEAAgE,CAAC,CAAA;IAEzH,wFAAwF;IACxF,uDAAuD;IACvD,qBAAU,CAAC,SAAS,CAAC,UAAU,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,IAAI,KAAK,EAAE,MAAM,qBAAU,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAA;IAEtH,qBAAqB,CAAC,UAAU,CAAC,CAAA,CAAC,iBAAiB;IACnD,MAAM,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,OAAkB,EAAE,EAAE;QACzE,IAAI,CAAC,qBAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC;YAC3C,qBAAqB,CAAC,UAAU,CAAC,CAAA,CAAC,uBAAuB;YACzD,OAAM;QACR,CAAC;QACD,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAA,iCAAsB,EAAC,OAA4B,EAAE,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAA;QAC7G,IAAI,QAAQ,CAAC,MAAM;YAAE,qBAAU,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAA;IAC5E,CAAC,CAAC,CAAA;IACF,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA;IAClC,OAAO,IAAI,CAAA;AACb,CAAC;AAED,8BAA8B;AAC9B,SAAgB,qBAAqB,CAAC,UAAkB;IACtD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IACxB,IAAI,CAAC;QAAC,KAAK,EAAE,CAAA;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;IACpC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IACxB,OAAO,IAAI,CAAA;AACb,CAAC;AAED,oBAAoB;AACpB,SAAgB,sBAAsB;IACpC,OAAO,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;AAC1B,CAAC;AAED,kCAAkC;AAClC,qBAAU,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC,CAAA","sourcesContent":["import { getAdapter, type ConnectionConfig, type SiteDescriptor } from './reference-adapter.js'\nimport { TwinEngine, ingestCanonicalRecords, type CanonicalRecord } from '../../engine/index.js'\n\n/*\n * 커넥터 기반 라이브 피드 결선(reference → live, §0 프레임 ① realityMode='mirror').\n * 흐름: adapter.openLiveFeed(cfg, site, records) → ingestCanonicalRecords(정규→봉투) → TwinEngine.ingestLive(projector 미러).\n * 커넥터가 \"벤더 이벤트 → 정규 레코드\" 매핑을 소유(코드)한다 — preset 기반 startLiveFeed(operato-twin, http-get+jsonata)와\n * 대칭이되, 매핑 위치만 다르다. 실 시스템 전환은 connectionConfig.baseUrl 교체뿐(코드 경로 동일).\n * 생명주기: 인스턴스 정지(TwinEngine.stop)에 훅으로 묶여 피드도 함께 unsubscribe.\n */\n\n/** 활성 라이브 피드 — instanceId → unsubscribe(어댑터 openLiveFeed 반환). */\nconst feeds = new Map<string, () => void>()\n\n/**\n * 커넥터 라이브 기동 — 어댑터 openLiveFeed 를 인스턴스에 결선.\n * 반환: 라이브 결선 성공 여부(어댑터가 openLiveFeed 미지원이면 false → 호출측이 sim 폴백).\n */\nexport async function startReferenceLiveFeed(\n  domainId: string,\n  adapterType: string,\n  cfg: ConnectionConfig,\n  site: SiteDescriptor,\n  instanceId: string\n): Promise<boolean> {\n  const adapter = getAdapter(adapterType)\n  if (!adapter?.openLiveFeed) return false\n\n  const det = await TwinEngine.detail(domainId, instanceId)\n  if (!det?.board) throw new Error(`instance \"${instanceId}\" not provisioned (no board) — ingest master before live start`)\n\n  // mirror 모드 기동 — 커널 tick 없이 projector 가 실 이벤트를 미러(startLive 가 realityMode='mirror' 설정).\n  // 시각 기준은 **공간**이 갖는다(테넌트 아님) — 교대의 HH:MM 을 어느 기준으로 읽나.\n  TwinEngine.startLive(instanceId, domainId, det.kind ?? 'wms', await TwinEngine.withSpaceTimeBase(det.board, domainId))\n\n  stopReferenceLiveFeed(instanceId) // 재기동 시 이전 피드 정리\n  const unsubscribe = adapter.openLiveFeed(cfg, site, (records: unknown[]) => {\n    if (!TwinEngine.owns(domainId, instanceId)) {\n      stopReferenceLiveFeed(instanceId) // 인스턴스 사라지면 자가 정지(안전망)\n      return\n    }\n    const { accepted } = ingestCanonicalRecords(records as CanonicalRecord[], domainId, new Date().toISOString())\n    if (accepted.length) TwinEngine.ingestLive(domainId, instanceId, accepted)\n  })\n  feeds.set(instanceId, unsubscribe)\n  return true\n}\n\n/** 라이브 피드 중지(unsubscribe). */\nexport function stopReferenceLiveFeed(instanceId: string): boolean {\n  const unsub = feeds.get(instanceId)\n  if (!unsub) return false\n  try { unsub() } catch { /* noop */ }\n  feeds.delete(instanceId)\n  return true\n}\n\n/** 활성 피드 목록(관측). */\nexport function listReferenceLiveFeeds(): string[] {\n  return [...feeds.keys()]\n}\n\n/* 인스턴스 정지 시 피드 자동 정리(생명주기 대칭). */\nTwinEngine.onStop(instanceId => stopReferenceLiveFeed(instanceId))\n"]}

package/dist-server/service/reference/reference-master.d.ts

@@ -311,7 +311,14 @@ export interface ReferenceMaster {
      * 없으면 커널은 레거시(하드코딩) 흐름으로 돈다. 즉 **현장 레시피를 적어도 이 자리에 실리지 않으면
      * 커널은 그것을 보지 못한다** — 선언과 실행이 갈라지는 지점이라 자리를 연다.
      */
-    mesSpec?: unknown;
+    /**
+     * 생산 선언 — `BoardDef.productionSpec` 으로 통과한다(ISA-95 OperationsSegment + BOM).
+     *
+     * 예전 이름은 `mesSpec` 이었다. 담긴 것은 MES 만의 것이 아니라 "자재를 소비해 자재를 산출하는
+     * 공정" 이고, 이름이 MES 였기 때문에 창고 트윈은 이 자리를 쓸 생각조차 하지 못했다(유통가공 창고가
+     * BOM 을 설명 문서에만 적어 둔 채 키트를 못 만드는 트윈을 만든 원인). 근거는 커널 계약 주석에.
+     */
+    productionSpec?: unknown;
     /**
      * 사람 — 선언하지 않으면 **인원 제약이 없는 트윈**이 된다(설비만 있으면 언제나 돌아가는 공장).
      * 공정이 인원을 요구하는데 사람이 없으면 그 작업은 시작되지 않는다 — 그것이 사실이므로 그대로 둔다.
@@ -336,7 +343,7 @@ export interface ReferenceMaster {
 export interface IngestedTwin {
     board: any;
     spaceContent: any;
-    warnings: string[];
+    warnings: IngestWarning[];
 }
 /**
  * 마스터 → 트윈 구조 매핑(순수). 노드타입을 카탈로그로 검증(모르는 타입은 warning, 버리진 않음 — 반영 우선).
@@ -356,4 +363,32 @@ export interface IngestedTwin {
  * 그렇게 바꾸면 판정이 조용히 틀린다.
  */
 export declare function utcOffsetOf(timezone?: string, at?: Date): number | undefined;
+/** 인제스트가 알리는 한 가지. */
+export interface IngestWarning {
+    /** 언어 중립 코드. 화면은 `twin.ingest.<code>` 로 렌더한다. */
+    code: string;
+    /** 문장에 끼울 값. 번역이 어순을 바꿀 수 있게 이름으로 넘긴다. */
+    params?: Record<string, string | number>;
+    /** 영어 canonical 문장 — 로그·폴백용. 번역이 없어도 읽을 수 있어야 한다. */
+    message: string;
+}
+/** 커널 카탈로그가 모르는 자리 타입 — 그 자리는 흐름에 참여하지 못할 수 있다. */
+export declare const unknownLocationType: (system: string, type: string, id: string) => IngestWarning;
+/** 시간대 문자열을 못 읽었다 — 시각 해석이 UTC 로 떨어진다(조용히 현지 시각으로 가정하지 않는다). */
+export declare const unknownTimezone: (timezone: string) => IngestWarning;
+/** 작업 정의에 소요시간·파라미터가 없다 — 커널 기본값으로 돈다. */
+export declare const operationWithoutDuration: (operation: string) => IngestWarning;
+/** 볼 수 있는 표현이 없다 — 현장이 화면에 뜨지 않는다. */
+export declare const noViewableRepresentation: () => IngestWarning;
+/** 합치는 공간에 같은 id 의 랜드마크가 이미 있다 — 서로 다른 것이 하나로 접혔을 수 있다. */
+export declare const landmarkIdsMerged: (spaceId: string, ids: readonly string[]) => IngestWarning;
+/** 로그 한 줄 — 개발자가 읽는 것이므로 영어 canonical 문장을 쓴다. */
+export declare const describeWarnings: (warnings: readonly IngestWarning[]) => string;
+/**
+ * 서버가 기본값으로 채운 노브들 — 사용자가 준 적 없는 값으로 트윈이 만들어졌음을 알린다.
+ *
+ * 조용히 채우면 나중에 "왜 이 수치인가" 를 아무도 답할 수 없다. 막을 일은 아니다(기본값은 템플릿이
+ * 확신을 갖고 선언한 값이다) — 다만 밝힌다.
+ */
+export declare const knobDefaultsFilled: (keys: readonly string[]) => IngestWarning;
 export declare function masterToTwin(master: ReferenceMaster, catalog?: any): IngestedTwin;

package/dist-server/service/reference/reference-master.js

@@ -8,6 +8,7 @@
  * 좌표·representations 는 트윈 공간층(보완/추가). 실 시스템이 좌표를 안 주면 layout 없이 위상만 인제스트.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.knobDefaultsFilled = exports.describeWarnings = exports.landmarkIdsMerged = exports.noViewableRepresentation = exports.operationWithoutDuration = exports.unknownTimezone = exports.unknownLocationType = void 0;
 exports.utcOffsetOf = utcOffsetOf;
 exports.masterToTwin = masterToTwin;
 /**
@@ -45,6 +46,55 @@ function utcOffsetOf(timezone, at = new Date()) {
         return undefined; // 알 수 없는 이름 — Intl 이 던진다
     }
 }
+/** 커널 카탈로그가 모르는 자리 타입 — 그 자리는 흐름에 참여하지 못할 수 있다. */
+const unknownLocationType = (system, type, id) => ({
+    code: 'unknown-location-type',
+    params: { system, type, id },
+    message: `"${type}" is not a known ${system} location type (${id}) — the kernel may not include this location in the flow`
+});
+exports.unknownLocationType = unknownLocationType;
+/** 시간대 문자열을 못 읽었다 — 시각 해석이 UTC 로 떨어진다(조용히 현지 시각으로 가정하지 않는다). */
+const unknownTimezone = (timezone) => ({
+    code: 'unknown-timezone',
+    params: { timezone },
+    message: `space timezone "${timezone}" is not a known IANA zone — the twin will read times as UTC`
+});
+exports.unknownTimezone = unknownTimezone;
+/** 작업 정의에 소요시간·파라미터가 없다 — 커널 기본값으로 돈다. */
+const operationWithoutDuration = (operation) => ({
+    code: 'operation-without-duration',
+    params: { operation },
+    message: `operation "${operation}" has no duration or parameters — kernel defaults will be used`
+});
+exports.operationWithoutDuration = operationWithoutDuration;
+/** 볼 수 있는 표현이 없다 — 현장이 화면에 뜨지 않는다. */
+const noViewableRepresentation = () => ({
+    code: 'no-viewable-representation',
+    message: 'the space has no viewable representation (no representations and no geo) — add one, or provide geo/board'
+});
+exports.noViewableRepresentation = noViewableRepresentation;
+/** 합치는 공간에 같은 id 의 랜드마크가 이미 있다 — 서로 다른 것이 하나로 접혔을 수 있다. */
+const landmarkIdsMerged = (spaceId, ids) => ({
+    code: 'landmark-ids-merged',
+    params: { spaceId, ids: ids.join(', '), count: ids.length },
+    message: `landmark ids already present in space "${spaceId}" — merged: ${ids.join(', ')}`
+});
+exports.landmarkIdsMerged = landmarkIdsMerged;
+/** 로그 한 줄 — 개발자가 읽는 것이므로 영어 canonical 문장을 쓴다. */
+const describeWarnings = (warnings) => warnings.map(w => `${w.code}: ${w.message}`).join(' | ');
+exports.describeWarnings = describeWarnings;
+/**
+ * 서버가 기본값으로 채운 노브들 — 사용자가 준 적 없는 값으로 트윈이 만들어졌음을 알린다.
+ *
+ * 조용히 채우면 나중에 "왜 이 수치인가" 를 아무도 답할 수 없다. 막을 일은 아니다(기본값은 템플릿이
+ * 확신을 갖고 선언한 값이다) — 다만 밝힌다.
+ */
+const knobDefaultsFilled = (keys) => ({
+    code: 'knob-defaults-filled',
+    params: { keys: keys.join(', '), count: keys.length },
+    message: `values you did not provide were filled from the template defaults: ${keys.join(', ')}`
+});
+exports.knobDefaultsFilled = knobDefaultsFilled;
 function masterToTwin(master, catalog) {
     const warnings = [];
     const known = catalog?.[master.system]?.locationTypes ?? [];
@@ -52,7 +102,7 @@ function masterToTwin(master, catalog) {
     const areaLocs = master.locations.filter(l => l.role === 'area' || l.role === 'both');
     const locations = locationEntries.map(l => {
         if (known.length && !known.includes(l.type))
-            warnings.push(`unknown ${master.system} location type "${l.type}" (${l.id}) — 카탈로그에 없음`);
+            warnings.push((0, exports.unknownLocationType)(master.system, l.type, l.id));
         // gs1Id(정식 정체성)를 보드 노드로 통과 — 결합(tag)/추적이 GS1 로(§J). 로컬 id 는 그대로 유지(name/xref).
         return { id: l.id, type: l.type, capacity: l.capacity ?? 0, ...(l.parallelism !== undefined ? { parallelism: l.parallelism } : {}), ...(l.level ? { level: l.level } : {}), parentId: l.parentId, gs1Id: l.gs1Id };
     });
@@ -79,7 +129,7 @@ function masterToTwin(master, catalog) {
      */
     const utcOffsetMinutes = utcOffsetOf(master.space.timezone);
     if (master.space.timezone && utcOffsetMinutes === undefined) {
-        warnings.push(`space timezone "${master.space.timezone}" is not a known IANA zone — the twin will read times as UTC`);
+        warnings.push((0, exports.unknownTimezone)(String(master.space.timezone)));
     }
     /*
      * 오퍼레이션 명세를 board 에 통과시킨다 — 커널이 `loadOperations` 로 소비한다(BoardDef 확장 필드,
@@ -89,7 +139,7 @@ function masterToTwin(master, catalog) {
     if (operations?.length) {
         for (const o of operations) {
             if (!o.duration && !o.parameters?.length)
-                warnings.push(`operation "${o.key}" has no duration or parameters — kernel defaults will be used`);
+                warnings.push((0, exports.operationWithoutDuration)(o.key));
         }
     }
     /* 사람도 손대지 않고 통과 — 등급·교대 그대로 커널까지 간다(경계에서 어휘를 갈지 않는다). */
@@ -109,7 +159,7 @@ function masterToTwin(master, catalog) {
     const board = {
         locations, equipment, layout, spaceId,
         /* 생산 정의도 손대지 않고 통과 — 경계에서 어휘를 갈지 않는다(커널이 그대로 소비한다). */
-        ...(master.mesSpec ? { mesSpec: master.mesSpec } : {}),
+        ...(master.productionSpec ? { productionSpec: master.productionSpec } : {}),
         ...(materialDefinitions?.length ? { materialDefinitions } : {}),
         ...(master.materialClasses?.length ? { materialClasses: master.materialClasses } : {}),
         ...(utcOffsetMinutes !== undefined ? { utcOffsetMinutes } : {}),
@@ -135,7 +185,7 @@ function masterToTwin(master, catalog) {
             ? [{ id: 'r-map', type: 'map', name: '위성 지도', primary: true, center: { lat: geo.lat, lon: geo.lon }, zoom: 17 }]
             : [];
     if (representations.length === 0) {
-        warnings.push('space has no viewable representation (no representations and no geo) — add one manually or provide geo/board');
+        warnings.push((0, exports.noViewableRepresentation)());
     }
     const spaceContent = {
         width: master.space.width, depth: master.space.depth, unit: master.space.unit ?? 'm',

package/dist-server/service/reference/reference-master.js.map

@@ -1 +1 @@
-{"version":3,"file":"reference-master.js","sourceRoot":"","sources":["../../../server/service/reference/reference-master.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Face2 마스터 인제스트(ADR-0018 반영 모드) — 레퍼런스 시스템(실 WMS/YMS/MES 또는 가상 레퍼런스)의\n * 마스터를 읽어 트윈 구조(BoardDef) + 공간(Space content)을 생성. 손배선이 아니라 인제스트로 엔티티가 흐른다.\n *\n * 규율(ADR-0018): 도메인 타입(location.type=노드용)은 커널 카탈로그 어휘를 그대로 반영(발명 금지).\n * location 은 role 로 노드(운영점)·area(공간영역)·both 를 구분 — 노드→BoardDef, area→Space.areas.\n * 좌표·representations 는 트윈 공간층(보완/추가). 실 시스템이 좌표를 안 주면 layout 없이 위상만 인제스트.\n */\n\nimport type { EquipmentLevel, WorkCalendarEntry } from '@operato/twin-kernel'\n\nexport interface RefLocation {\n  id: string\n  type: string // 노드는 커널 노드타입(dock/storage/yard-slot…), area 는 공간 region 타입\n  name?: string\n  role: 'location' | 'area' | 'both'\n  parentId?: string\n  /** 저장 용량 — 이 자리에 동시에 놓일 수 있는 물품 수. */\n  capacity?: number\n  /**\n   * 동시 처리 수 — 이 자리에서 한 번에 진행될 수 있는 작업 수. **저장 용량과 다른 축**이다\n   * (자재를 20개 쌓아 두는 절단 스테이션이 한 번에 한 대만 깎는다). 미지정=제약 없음.\n   */\n  parallelism?: number\n  /**\n   * **ISA-95 설비 계층 단계** — `EquipmentLevel` 열거값(`ProductionLine`·`StorageZone`·`WorkCenter`…).\n   *\n   * `type` 은 현장의 낱말(`paint-booth`)이고 이것은 **표준이 정한 역할**이다. 둘은 다른 축이라 함께 든다 —\n   * 연동·집계는 표준 축으로, 화면은 현장 낱말로. 미지정이면 그 자리의 표준 역할을 아직 모른다는 뜻이고,\n   * 짐작해 채우지 않는다.\n   */\n  level?: EquipmentLevel\n  footprint?: { x: number; y: number; w: number; h: number } // 있으면 area 기하 + 노드 중심좌표\n  gs1Id?: string // 정식 GS1 정체성(§J) — 위치=SGLN. 결합(tag)/추적 canonical id. 받아들이기 경계서 부여(로컬 id=name/xref 로 보존).\n}\n\n/**\n * 설비 속성 — **ISA-95 `EquipmentSpecificationProperty`(`OpEquipmentSpecificationPropertyType`) 1:1.**\n * 그 타입도 `ID` + `Value`(`ValueString`·`DataType`·`UnitOfMeasure`) 이므로 공정 모수와 같은 모양이다.\n *\n * 단위 코드는 **UN/CEFACT 권고 20 공통코드**(EPCIS `uom` 과 같은 코드계): 속도는 `MTS`(metre per\n * second) 또는 `KMH`(kilometre per hour). 코드를 우리가 발명하지 않는다.\n */\n/**\n * 자원 속성 — **커널 `ResourceProperty` 와 같은 모양**이고, 그 모양은 ISA-95 가 세 자원에 똑같이\n * 정의한 것이다(`EquipmentPropertyType` · `PersonPropertyType` · `PhysicalAssetPropertyType`).\n *\n * 그래서 자원마다 다른 속성 타입을 두지 않는다 — 예전에는 설비만 속성을 가졌고(RefEquipmentProperty),\n * 인원·자산에 붙는 사실은 **실을 자리가 없어서 들어오지 못했다.**\n */\nexport interface RefResourceProperty {\n  id: string\n  description?: string\n  value?: string\n  /** 표준 `Value.DataType`. */\n  dataType?: string\n  /** 표준 `Value.UnitOfMeasure` — UN/CEFACT 공통코드. 물리량에 단위가 없으면 소비처가 거절한다. */\n  uom?: string\n  /** 하위 속성(재귀) — 표준 `<X>PropertyChild`. */\n  children?: RefResourceProperty[]\n  /** 이 개체 속성이 구체화하는 등급 속성 — 표준 `<X>ClassPropertyID`. */\n  classPropertyId?: string\n}\n\n/** 옛 이름 — 설비 전용이던 시절의 별칭(소비처 호환). 신규 소싱은 `RefResourceProperty`. */\nexport type RefEquipmentProperty = RefResourceProperty\n\n/**\n * 자원 **등급 정의** — 커널 `ResourceClassDef` 와 같은 모양이고, 그 모양은 ISA-95 가 세 자원에 똑같이\n * 정의한 것이다(`PersonnelClassType`·`EquipmentClassType`·`PhysicalAssetClassType`).\n *\n * 왜 필요한가: 원 시스템은 등급 **체계**를 갖고 있다(\"6축 용접 자격자\" 는 \"용접 자격자\" 이고, 그것은\n * \"생산직\" 이다). 그 체계가 들어올 자리가 없으면 요구와 소속이 **문자열이 똑같을 때만** 맞아,\n * 현장에서는 되는 배정이 모델에서 막힌다.\n */\nexport interface RefResourceClass {\n  id: string\n  description?: string\n  /** 상위 등급들 — 표준 `<X>ClassBaseID`(복수 = 다중 상속). */\n  baseIds?: string[]\n  properties?: RefResourceProperty[]\n  testSpecificationIds?: string[]\n  /** 유효 기간(ISO) — 표준 `EffectiveStartDate`/`EffectiveEndDate`. 밖이면 자격이 성립하지 않는다. */\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\nexport interface RefEquipment {\n  id: string\n  kind: string\n  homeLocationId: string\n  mtbfMs?: number // 평균 고장 간격(확률적 고장) — 지정 시 커널이 breakdown 시뮬 → 주목(고장) 발생\n  mttrMs?: number // 평균 수리 시간\n  gs1Id?: string // 정식 GS1 정체성(§J) — 설비=GIAI.\n  /**\n   * 교대(가동시간) — 이 시간대에만 배정된다. `startHour <= endHour` 면 같은 날, 넘어가면 야간(22→6).\n   * 미지정=24시간 가용. 교대 밖 자원은 고장·계획정지와 **구별되는 이유**로 쉰다(상태에 드러난다).\n   */\n  window?: { startHour: number; endHour: number }\n  /**\n   * 근무 캘린더 — 표준 `WorkCalendarEntry`(복수). 있으면 `window` 보다 이것을 본다.\n   *\n   * 축을 프레임워크 `@things-factory/work-shift` 의 `WorkShift`(`fromDate`·`fromTime`·`toDate`·`toTime`)와\n   * 맞춰 두었다 — 그 엔티티를 교대의 정본으로 결선할 때 직선 매핑이 되게. **아직 결선하지 않았다**:\n   * 그 엔티티에는 자원 연결과 비근무(휴일)가 없어 확장이 함께 필요하고, operato-twin 의 의존성 추가는\n   * 앱 아키텍처 결정이다(커버리지 §4-7 에 결선 지점으로 기록).\n   */\n  workCalendar?: WorkCalendarEntry[]\n  /**\n   * 설비 속성(속도 등) — 없으면 **이동시간을 거리에서 계산할 수 없다**(속도 없이 거리만으로는 시간이\n   * 안 나온다). 그때는 커널 상수로 떨어지고 그 사실이 `specCoverage()` 에 남는다.\n   */\n  properties?: RefResourceProperty[]\n  /** 적격을 검증한 시험 명세들 — 표준 `TestSpecificationID`(교정 등). */\n  testSpecificationIds?: string[]\n  /**\n   * 유효 기간 — **표준 `EffectiveStartDate` / `EffectiveEndDate`**(개체 타입 셋 모두에 있다).\n   *\n   * 없으면 **폐기한 것이 영구히 살아 있다**: 배정 대상에 남고, 가용 수에 들어가고, 화면에 뜬다.\n   * 도입 예정인 것은 반대로 오늘부터 있는 것처럼 보인다. 기간 밖이면 커널이 그 시각의 모델에서\n   * 빼고 **이유를 달아 남긴다**(`effectivity: 'not-yet' | 'expired'`) — 조용히 지우지 않는다.\n   */\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\n/**\n * 공정 모수 — 커널 `OperationParameter`(= ISA-95 `ParameterSpecification`/`ParameterType`) 와 **같은 모양**.\n * 이름을 바꾸지 않는다: 인제스트 경계에서 어휘가 갈리면 그 자리에서 방언이 생긴다.\n * ID 어휘의 정본은 커널 `OP_PARAM`(표준이 파라미터 ID 를 정하지 않으므로 우리가 한 곳에서 정한다).\n */\nexport interface RefOperationParameter {\n  id: string\n  /** ISA-95 `Value.ValueString` — 표준이 문자열로 싣는다. 기간 모수는 ISO 8601(`PT8M`). */\n  value: string\n  /** ISA-95 `Value.UnitOfMeasure`. 무차원(비율)이면 생략. */\n  uom?: string\n}\n\n/**\n * 공정의 자재 요구·산출 — **ISA-95 `OperationsSegment.MaterialSpecification`** 과 같은 모양.\n * 인원·설비·자산 명세와 같은 자리에 있어야 4대 자원이 대칭이 된다(자재만 빠져 있었다).\n */\nexport interface RefOpMaterialSpecification {\n  id?: string\n  /** 품목 등급으로 요구 — 표준 `MaterialClassID`. */\n  materialClass?: string\n  /** 특정 품목으로 요구 — 표준 `MaterialDefinitionID`. */\n  materialDefinition?: string\n  /** 표준 `MaterialUse` — 이 공정에서의 쓰임. */\n  use: 'consumed' | 'produced' | 'consumable'\n  /** 표준 `Quantity`. 단위 미지정이면 개수. */\n  quantity: number\n  uom?: string\n}\n\n/** 소요시간 변동 — **표준 밖 확장**(ISA-95 Duration 은 스칼라). 커널 `DurationVariability` 와 동형. */\nexport interface RefOperationVariability {\n  distribution: 'constant' | 'exponential' | 'uniform' | 'triangular'\n  min?: string\n  max?: string\n  mode?: string\n}\n\n/**\n * 오퍼레이션 명세 — ISA-95 `OperationsSegment`. 커널 `OperationDef` 와 필드 이름이 1:1이다.\n *\n * **이것이 없으면 시뮬레이션의 시간은 우리가 코드에 박아 둔 상수다.** 원 시스템(또는 가상 레퍼런스)이\n * 공정별 소요·변동·수율을 말해 줘야 예측이 그 현장의 예측이 된다. 주지 않으면 커널 기본값으로\n * 굴러가고, **기본값을 썼다는 사실은 커널 `specCoverage()` 가 밝힌다**(조용히 넘어가지 않는다).\n */\nexport interface RefOperation {\n  /** 작업 종류 키 — 커널 `FlowTask.kind` 와 같은 값이어야 명세가 그 작업에 붙는다. */\n  key: string\n  label: string\n  intent: 'transport' | 'process' | 'dwell'\n  locationType?: string\n  resourceType?: string\n  bizStep?: string\n  /** ISA-95 `OperationsSegment.Duration` — ISO 8601 기간(`PT12M`). */\n  duration?: string\n  variability?: RefOperationVariability\n  parameters?: RefOperationParameter[]\n  /**\n   * 필요 인원 — ISA-95 `PersonnelSpecification`(`PersonnelClassID` + `Quantity`) 1:1.\n   * 없으면 사람 없이 도는 공정이다(설비만 잡는다).\n   */\n  personnelSpecification?: { personnelClass?: string; quantity: number }[]\n  /** 필요 물리 자산 — ISA-95 `PhysicalAssetSpecification`(등급 + 수량). 빈 팔레트가 없으면 못 나간다. */\n  physicalAssetSpecification?: { assetClass?: string; quantity: number }[]\n  /**\n   * 필요·산출 자재 — ISA-95 `MaterialSpecification`. **4대 자원 중 자재만 이 자리가 없었다** —\n   * 그래서 부품이 떨어져 라인이 서는 상황이 예측에 나타나지 않았다.\n   * BOM 의 \"몇 개\" 는 여기다(품목 정의의 조립 구조에는 수량이 없다 — 1차 출처 확인).\n   */\n  materialSpecification?: RefOpMaterialSpecification[]\n}\n\n/**\n * 사람 — **ISA-95 `Person`.** 설비와 별개 자원이다(고장·설비효율이 아니라 등급·교대로 산다).\n * `personnelClass` 가 ISA-95 `PersonnelClassID` — 공정은 특정인이 아니라 **등급으로** 인원을 요구한다.\n */\nexport interface RefPerson {\n  id: string\n  name?: string\n  /**\n   * 속한 등급들 — **표준 `Person.PersonnelClassID`, `maxOccurs=\"unbounded\"`**.\n   * 복수인 것이 표준이고 그것이 자격 표현이다: 한 사람이 용접 자격과 지게차 자격을 함께 갖는다.\n   */\n  personnelClassIds?: string[]\n  /** 교대 — 설비와 같은 모양. 미지정=24시간 가용. */\n  window?: { startHour: number; endHour: number }\n  /** 근무 캘린더 — 표준 `WorkCalendarEntry`(복수). 2교대·휴게·휴일을 함께 표현한다. */\n  workCalendar?: WorkCalendarEntry[]\n  /**\n   * 기본 위치 — 표준 `Person.OperationalLocation`. 없으면 \"이 라인에 몇 명 있나\" 를 물을 수 없다.\n   * 사람은 움직이므로 이 값은 **출발점**이고, 실제 위치는 관측(person.status)이 갱신한다.\n   */\n  homeLocationId?: string\n  /**\n   * 자원 속성 — 표준 `PersonProperty`. **자격증·숙련도가 여기 들어간다.**\n   *\n   * 표준에는 자격(Qualification)이라는 별도 요소가 없다(`B2MML-Personnel.xsd` 확인). 자격은\n   * ① 등급 복수 소속으로(`personnelClassIds: ['welder-certified','forklift-licensed']`) ②\n   * 증빙은 이 속성으로(자격증 번호·만료일), ③ 검증 시험은 표준 `TestSpecificationID`(아직 미구현).\n   */\n  properties?: RefResourceProperty[]\n  /** 자격을 검증한 시험 명세들 — 표준 `TestSpecificationID`(참조만; 시험 명세·결과 모델은 아직 없다). */\n  testSpecificationIds?: string[]\n  /** 유효 기간 — 사람에게는 **입사 전·퇴사 후**다(자격 만료는 등급 쪽 기간이다: 사람은 남고 자격만 끊긴다). */\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\n/**\n * 물리 자산(반복사용) — **ISA-95 `PhysicalAsset`, GS1 `GRAI`.**\n * 팔레트·랙·용기처럼 **나갔다 돌아오는** 것. 물류단위(SSCC)와 다르다: SSCC 는 그 팔레트에 실린 화물\n * 한 덩어리이고, GRAI 는 팔레트 자체다(오늘은 이 화물, 내일은 저 화물을 싣는다).\n */\nexport interface RefAsset {\n  id: string\n  name?: string\n  /**\n   * 속한 등급들 — 표준 `PhysicalAssetClassID`(복수). 팔레트가 'euro-pallet' 이면서 'food-grade' 일 수 있다.\n   * 공정의 요구는 등급 하나 + 수량이다(표준 `PhysicalAssetSpecification`).\n   */\n  assetClassIds?: string[]\n  /** 기본 위치. */\n  homeLocationId?: string\n  /** 정식 GS1 정체성 — 반복사용 자산=GRAI. */\n  gs1Id?: string\n  /** 자원 속성 — 표준 `PhysicalAssetProperty`(적재 한도·규격 등). */\n  properties?: RefResourceProperty[]\n  /** 적격을 검증한 시험 명세들 — 표준 `TestSpecificationID`. */\n  testSpecificationIds?: string[]\n  /** 유효 기간 — 자산에서는 **폐기한 팔레트가 풀에서 빠지는 것**이다(회수 대상 수가 부풀지 않게). */\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\n/**\n * 품목 정의 — **ISA-95 `MaterialDefinition`.**\n *\n * 없으면 로트만 관측으로 들어오고 **품목이 무엇인지는 아무 데도 없다.** 그래서 같은 로트를 100개로\n * 받아도 \"몇 kg 인가\" 에 답할 수 없다(커널 `quantityIn` 이 환산을 거부하는 근거).\n *\n * **표준에 단위 환산 요소는 없다**(1차 출처 전수 확인) — 속성 주머니뿐이다. 그래서 환산 계수는\n * 커널이 정한 속성 이름(`perBaseUnit`, `uom` 이 대상 단위)으로 `properties` 에 싣는다.\n */\nexport interface RefMaterialDefinition {\n  /** 표준 `ID` — GTIN(`urn:epc:idpat:sgtin:…`)을 쓴다(정체성의 정본이 EPCIS 다). */\n  id: string\n  name?: string\n  /** 속한 등급들 — 표준 `MaterialClassID`(복수). */\n  materialClassIds?: string[]\n  /** 품목 속성 — 표준 `MaterialDefinitionProperty`. 환산 계수가 여기 들어간다. */\n  properties?: RefResourceProperty[]\n  testSpecificationIds?: string[]\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\nexport interface ReferenceMaster {\n  source: string\n  system: 'wms' | 'yms' | 'mes'\n  siteName: string\n  /* spaceId 명시 시 그 공간을 참조(여러 트윈이 한 공간 공유, N:1). 없으면 source 에서 파생(1:1). */\n  /**\n   * 현장(공간). **시각 기준(`timezone`)이 여기 있는 이유**: 한 테넌트가 Rosarito(태평양)와 한국\n   * 공장을 함께 가질 수 있다. 테넌트 단위(`Domain.timezone`)로 두면 **둘 중 하나는 반드시 틀린다.**\n   * 시각 기준은 **물리 현장의 성질**이므로 공간이 그것을 갖는다(공간 중심 원칙).\n   *\n   * `timezone` 은 IANA 이름(`'America/Tijuana'`) — 오프셋 숫자가 아니다. 숫자로 두면 일광절약시간을\n   * 표현할 수 없고, 나중에 절대 구간으로 옮길 때도 이름이 있어야 계산할 수 있다.\n   */\n  space: { spaceId?: string; width: number; depth: number; unit?: string; timezone?: string; geo?: { lat: number; lon: number; rotation?: number }; representations?: any[]; primaryId?: string }\n  locations: RefLocation[]\n  equipment?: RefEquipment[]\n  /** 공정 명세(소요·변동·수율) — 없으면 커널 기본값으로 굴러간다(그 사실은 specCoverage 가 보고). */\n  operations?: RefOperation[]\n  /**\n   * **생산 정의**(레시피·라우트·자재 바인딩) — 커널의 정의-구동 MES 모드 입구.\n   *\n   * 없으면 커널은 레거시(하드코딩) 흐름으로 돈다. 즉 **현장 레시피를 적어도 이 자리에 실리지 않으면\n   * 커널은 그것을 보지 못한다** — 선언과 실행이 갈라지는 지점이라 자리를 연다.\n   */\n  mesSpec?: unknown\n  /**\n   * 사람 — 선언하지 않으면 **인원 제약이 없는 트윈**이 된다(설비만 있으면 언제나 돌아가는 공장).\n   * 공정이 인원을 요구하는데 사람이 없으면 그 작업은 시작되지 않는다 — 그것이 사실이므로 그대로 둔다.\n   */\n  persons?: RefPerson[]\n  /**\n   * 물리 자산(반복사용) — 선언하지 않으면 자산 제약이 없는 트윈이다.\n   * 공정이 자산을 요구하는데 없으면 그 작업은 시작되지 않는다 — 그것이 사실이므로 그대로 둔다.\n   */\n  assets?: RefAsset[]\n  /**\n   * 등급 정의 — 표준 `PersonnelClass`·`EquipmentClass`·`PhysicalAssetClass`.\n   * 안 실어도 트윈은 돈다(소속 문자열 그대로 판정). 실으면 상속·유효기간이 살아난다.\n   */\n  personnelClasses?: RefResourceClass[]\n  equipmentClasses?: RefResourceClass[]\n  assetClasses?: RefResourceClass[]\n  /** 품목 정의·등급 — 표준 `MaterialDefinition` / `MaterialClass`. 없으면 단위 환산을 할 수 없다. */\n  materialDefinitions?: RefMaterialDefinition[]\n  materialClasses?: RefResourceClass[]\n}\n\nexport interface IngestedTwin {\n  board: any // BoardDef(+layout+spaceId) — 커널 소비\n  spaceContent: any // TwinSpace content — 뷰 소비\n  warnings: string[]\n}\n\n/**\n * 마스터 → 트윈 구조 매핑(순수). 노드타입을 카탈로그로 검증(모르는 타입은 warning, 버리진 않음 — 반영 우선).\n * @param catalog DOMAIN_CATALOG (커널 SSOT). 없으면 검증 생략.\n */\n/**\n * IANA 시간대 이름 → **그 시각의** UTC 오프셋(분). 의존성 없이 `Intl` 로 푼다.\n *\n * `Intl.DateTimeFormat` 의 `longOffset` 은 `\"GMT-07:00\"` 처럼 나오고, 이것은 **일광절약시간을 반영한**\n * 값이다. 그래서 8월의 `America/Tijuana` 는 −420(PDT), 1월은 −480(PST)이 된다.\n *\n * **한계를 밝힌다**: 여기서 나오는 것은 **한 시점의** 오프셋이다. 커널은 고정 오프셋으로 하루 중 분을\n * 읽으므로, 보드를 만든 계절과 다른 계절을 길게 예측하면 한 시간 어긋난다. 표준에 충실한 끝 모습은\n * 호스트가 절대 구간(`StartDateTime`/`FinishDateTime`)을 계산해 넣는 것이고, 그때 이 함수는 사라진다.\n *\n * 모르는 이름에는 **0 을 답하지 않는다**(`undefined`) — 0 은 \"UTC 라고 선언했다\" 는 뜻이고, 모르는 것을\n * 그렇게 바꾸면 판정이 조용히 틀린다.\n */\nexport function utcOffsetOf(timezone?: string, at: Date = new Date()): number | undefined {\n  if (!timezone) return undefined\n  try {\n    const parts = new Intl.DateTimeFormat('en-US', { timeZone: timezone, timeZoneName: 'longOffset' }).formatToParts(at)\n    const name = parts.find(p => p.type === 'timeZoneName')?.value ?? ''\n    if (name === 'GMT') return 0 // UTC 계열은 오프셋 표기가 없다\n    const m = /^GMT([+-])(\\d{1,2})(?::(\\d{2}))?$/.exec(name)\n    if (!m) return undefined\n    const sign = m[1] === '-' ? -1 : 1\n    return sign * (Number(m[2]) * 60 + Number(m[3] ?? 0))\n  } catch {\n    return undefined // 알 수 없는 이름 — Intl 이 던진다\n  }\n}\n\nexport function masterToTwin(master: ReferenceMaster, catalog?: any): IngestedTwin {\n  const warnings: string[] = []\n  const known: string[] = catalog?.[master.system]?.locationTypes ?? []\n\n  const locationEntries = master.locations.filter(l => l.role === 'location' || l.role === 'both')\n  const areaLocs = master.locations.filter(l => l.role === 'area' || l.role === 'both')\n\n  const locations = locationEntries.map(l => {\n    if (known.length && !known.includes(l.type)) warnings.push(`unknown ${master.system} location type \"${l.type}\" (${l.id}) — 카탈로그에 없음`)\n    // gs1Id(정식 정체성)를 보드 노드로 통과 — 결합(tag)/추적이 GS1 로(§J). 로컬 id 는 그대로 유지(name/xref).\n    return { id: l.id, type: l.type, capacity: l.capacity ?? 0, ...(l.parallelism !== undefined ? { parallelism: l.parallelism } : {}), ...(l.level ? { level: l.level } : {}), parentId: l.parentId, gs1Id: l.gs1Id }\n  })\n\n  const equipment = (master.equipment ?? []).map(e => ({\n    id: e.id, kind: e.kind, homeLocation: e.homeLocationId, mtbfMs: e.mtbfMs, mttrMs: e.mttrMs, gs1Id: e.gs1Id,\n    ...(e.window ? { window: e.window } : {}),\n    /* 속성은 손대지 않고 통과 — 이동시간 추정기가 kind 별 속도를 여기서 읽는다(단위 코드 그대로). */\n    ...(e.properties?.length ? { properties: e.properties } : {}), ...(e.workCalendar?.length ? { workCalendar: e.workCalendar } : {}), ...(e.testSpecificationIds?.length ? { testSpecificationIds: e.testSpecificationIds } : {}),\n    /* 유효 기간도 손대지 않고 통과 — 판정은 커널이 자기 시계로 한다(호스트가 미리 자르지 않는다). */\n    ...(e.effectiveStart ? { effectiveStart: e.effectiveStart } : {}), ...(e.effectiveEnd ? { effectiveEnd: e.effectiveEnd } : {})\n  }))\n\n  // 좌표(layout) — footprint 중심. 없으면 생략(coordinate-free 유지).\n  const layout: Record<string, { x: number; y: number }> = {}\n  for (const l of locationEntries) if (l.footprint) layout[l.id] = { x: l.footprint.x + l.footprint.w / 2, y: l.footprint.y + l.footprint.h / 2 }\n\n  const spaceId = master.space.spaceId ?? `${master.source}-site`\n  /*\n   * 시각 기준을 커널이 읽을 형태로 푼다 — 커널은 zero-dep 이라 시간대 데이터베이스를 들이지 않고\n   * **분 오프셋**만 받는다(계약 `BoardDef.utcOffsetMinutes`). 푸는 일은 호스트의 몫이다.\n   *\n   * 선언이 없으면 **필드를 만들지 않는다** — 그러면 커널이 UTC 로 읽고, 그 기본값은 계약에 밝혀져 있다.\n   * 여기서 0 을 넣으면 \"UTC 라고 선언했다\" 와 \"선언하지 않았다\" 가 구별되지 않는다.\n   */\n  const utcOffsetMinutes = utcOffsetOf(master.space.timezone)\n  if (master.space.timezone && utcOffsetMinutes === undefined) {\n    warnings.push(`space timezone \"${master.space.timezone}\" is not a known IANA zone — the twin will read times as UTC`)\n  }\n  /*\n   * 오퍼레이션 명세를 board 에 통과시킨다 — 커널이 `loadOperations` 로 소비한다(BoardDef 확장 필드,\n   * 모르는 커널은 무시). 여기서 값을 손대지 않는다: 기간은 표준 표기(ISO 8601)로 커널까지 그대로 간다.\n   */\n  const operations = master.operations\n  if (operations?.length) {\n    for (const o of operations) {\n      if (!o.duration && !o.parameters?.length) warnings.push(`operation \"${o.key}\" has no duration or parameters — kernel defaults will be used`)\n    }\n  }\n  /* 사람도 손대지 않고 통과 — 등급·교대 그대로 커널까지 간다(경계에서 어휘를 갈지 않는다). */\n  const persons = master.persons?.map(p => ({ id: p.id, personnelClassIds: p.personnelClassIds, ...(p.window ? { window: p.window } : {}), ...(p.workCalendar?.length ? { workCalendar: p.workCalendar } : {}), ...(p.homeLocationId ? { homeLocation: p.homeLocationId } : {}), ...(p.properties?.length ? { properties: p.properties } : {}), ...(p.testSpecificationIds?.length ? { testSpecificationIds: p.testSpecificationIds } : {}), ...(p.effectiveStart ? { effectiveStart: p.effectiveStart } : {}), ...(p.effectiveEnd ? { effectiveEnd: p.effectiveEnd } : {}) }))\n  /* 자산도 손대지 않고 통과 — 등급·자리 그대로 커널까지. */\n  const assets = master.assets?.map(a => ({ id: a.id, assetClassIds: a.assetClassIds, homeLocation: a.homeLocationId, gs1Id: a.gs1Id, ...(a.properties?.length ? { properties: a.properties } : {}), ...(a.testSpecificationIds?.length ? { testSpecificationIds: a.testSpecificationIds } : {}), ...(a.effectiveStart ? { effectiveStart: a.effectiveStart } : {}), ...(a.effectiveEnd ? { effectiveEnd: a.effectiveEnd } : {}) }))\n  /* 품목 정의·등급도 손대지 않고 통과 — 경계에서 어휘를 갈지 않는다(환산 계수는 커널이 읽는다). */\n  const materialDefinitions = master.materialDefinitions?.map(d => ({\n    id: d.id,\n    ...(d.name ? { description: d.name } : {}),\n    ...(d.materialClassIds?.length ? { materialClassIds: d.materialClassIds } : {}),\n    ...(d.properties?.length ? { properties: d.properties } : {}),\n    ...(d.testSpecificationIds?.length ? { testSpecificationIds: d.testSpecificationIds } : {}),\n    ...(d.effectiveStart ? { effectiveStart: d.effectiveStart } : {}),\n    ...(d.effectiveEnd ? { effectiveEnd: d.effectiveEnd } : {})\n  }))\n  const board = {\n    locations, equipment, layout, spaceId,\n    /* 생산 정의도 손대지 않고 통과 — 경계에서 어휘를 갈지 않는다(커널이 그대로 소비한다). */\n    ...(master.mesSpec ? { mesSpec: master.mesSpec } : {}),\n    ...(materialDefinitions?.length ? { materialDefinitions } : {}),\n    ...(master.materialClasses?.length ? { materialClasses: master.materialClasses } : {}),\n    ...(utcOffsetMinutes !== undefined ? { utcOffsetMinutes } : {}),\n    ...(operations?.length ? { operations } : {}),\n    ...(master.personnelClasses?.length ? { personnelClasses: master.personnelClasses } : {}),\n    ...(master.equipmentClasses?.length ? { equipmentClasses: master.equipmentClasses } : {}),\n    ...(master.assetClasses?.length ? { assetClasses: master.assetClasses } : {}),\n    ...(persons?.length ? { persons } : {}),\n    ...(assets?.length ? { assets } : {})\n  }\n\n  const areas = areaLocs.map(l => ({\n    id: l.id, type: l.type, name: l.name ?? l.id, parentId: l.parentId,\n    x: l.footprint?.x ?? 0, y: l.footprint?.y ?? 0, w: l.footprint?.w ?? 10, h: l.footprint?.h ?? 10\n  }))\n  // 인제스트 현장 물질화(space facet #4) — 표현이 없고 geo 가 있으면 기본 map 표현 합성.\n  // \"인제스트하면 알아볼 현장(내 place)이 뜬다\"는 공간 중심 정수 보장(zero-to-twin): 커넥터/템플릿이\n  // 표현을 안 줘도 geo 만 있으면 위성 지도로 착지. (area 폴리곤 물질화는 좌표 투영 필요 → space #3.)\n  const geo = master.space.geo\n  const givenReps = master.space.representations ?? []\n  const representations =\n    givenReps.length > 0\n      ? givenReps\n      : geo\n        ? [{ id: 'r-map', type: 'map', name: '위성 지도', primary: true, center: { lat: geo.lat, lon: geo.lon }, zoom: 17 }]\n        : []\n  if (representations.length === 0) {\n    warnings.push('space has no viewable representation (no representations and no geo) — add one manually or provide geo/board')\n  }\n  const spaceContent = {\n    width: master.space.width, depth: master.space.depth, unit: master.space.unit ?? 'm',\n    geo, representations, primaryId: master.space.primaryId ?? representations[0]?.id,\n    areas, landmarks: []\n  }\n\n  return { board, spaceContent, warnings }\n}\n"]}
+{"version":3,"file":"reference-master.js","sourceRoot":"","sources":["../../../server/service/reference/reference-master.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Face2 마스터 인제스트(ADR-0018 반영 모드) — 레퍼런스 시스템(실 WMS/YMS/MES 또는 가상 레퍼런스)의\n * 마스터를 읽어 트윈 구조(BoardDef) + 공간(Space content)을 생성. 손배선이 아니라 인제스트로 엔티티가 흐른다.\n *\n * 규율(ADR-0018): 도메인 타입(location.type=노드용)은 커널 카탈로그 어휘를 그대로 반영(발명 금지).\n * location 은 role 로 노드(운영점)·area(공간영역)·both 를 구분 — 노드→BoardDef, area→Space.areas.\n * 좌표·representations 는 트윈 공간층(보완/추가). 실 시스템이 좌표를 안 주면 layout 없이 위상만 인제스트.\n */\n\nimport type { EquipmentLevel, WorkCalendarEntry } from '@operato/twin-kernel'\n\nexport interface RefLocation {\n  id: string\n  type: string // 노드는 커널 노드타입(dock/storage/yard-slot…), area 는 공간 region 타입\n  name?: string\n  role: 'location' | 'area' | 'both'\n  parentId?: string\n  /** 저장 용량 — 이 자리에 동시에 놓일 수 있는 물품 수. */\n  capacity?: number\n  /**\n   * 동시 처리 수 — 이 자리에서 한 번에 진행될 수 있는 작업 수. **저장 용량과 다른 축**이다\n   * (자재를 20개 쌓아 두는 절단 스테이션이 한 번에 한 대만 깎는다). 미지정=제약 없음.\n   */\n  parallelism?: number\n  /**\n   * **ISA-95 설비 계층 단계** — `EquipmentLevel` 열거값(`ProductionLine`·`StorageZone`·`WorkCenter`…).\n   *\n   * `type` 은 현장의 낱말(`paint-booth`)이고 이것은 **표준이 정한 역할**이다. 둘은 다른 축이라 함께 든다 —\n   * 연동·집계는 표준 축으로, 화면은 현장 낱말로. 미지정이면 그 자리의 표준 역할을 아직 모른다는 뜻이고,\n   * 짐작해 채우지 않는다.\n   */\n  level?: EquipmentLevel\n  footprint?: { x: number; y: number; w: number; h: number } // 있으면 area 기하 + 노드 중심좌표\n  gs1Id?: string // 정식 GS1 정체성(§J) — 위치=SGLN. 결합(tag)/추적 canonical id. 받아들이기 경계서 부여(로컬 id=name/xref 로 보존).\n}\n\n/**\n * 설비 속성 — **ISA-95 `EquipmentSpecificationProperty`(`OpEquipmentSpecificationPropertyType`) 1:1.**\n * 그 타입도 `ID` + `Value`(`ValueString`·`DataType`·`UnitOfMeasure`) 이므로 공정 모수와 같은 모양이다.\n *\n * 단위 코드는 **UN/CEFACT 권고 20 공통코드**(EPCIS `uom` 과 같은 코드계): 속도는 `MTS`(metre per\n * second) 또는 `KMH`(kilometre per hour). 코드를 우리가 발명하지 않는다.\n */\n/**\n * 자원 속성 — **커널 `ResourceProperty` 와 같은 모양**이고, 그 모양은 ISA-95 가 세 자원에 똑같이\n * 정의한 것이다(`EquipmentPropertyType` · `PersonPropertyType` · `PhysicalAssetPropertyType`).\n *\n * 그래서 자원마다 다른 속성 타입을 두지 않는다 — 예전에는 설비만 속성을 가졌고(RefEquipmentProperty),\n * 인원·자산에 붙는 사실은 **실을 자리가 없어서 들어오지 못했다.**\n */\nexport interface RefResourceProperty {\n  id: string\n  description?: string\n  value?: string\n  /** 표준 `Value.DataType`. */\n  dataType?: string\n  /** 표준 `Value.UnitOfMeasure` — UN/CEFACT 공통코드. 물리량에 단위가 없으면 소비처가 거절한다. */\n  uom?: string\n  /** 하위 속성(재귀) — 표준 `<X>PropertyChild`. */\n  children?: RefResourceProperty[]\n  /** 이 개체 속성이 구체화하는 등급 속성 — 표준 `<X>ClassPropertyID`. */\n  classPropertyId?: string\n}\n\n/** 옛 이름 — 설비 전용이던 시절의 별칭(소비처 호환). 신규 소싱은 `RefResourceProperty`. */\nexport type RefEquipmentProperty = RefResourceProperty\n\n/**\n * 자원 **등급 정의** — 커널 `ResourceClassDef` 와 같은 모양이고, 그 모양은 ISA-95 가 세 자원에 똑같이\n * 정의한 것이다(`PersonnelClassType`·`EquipmentClassType`·`PhysicalAssetClassType`).\n *\n * 왜 필요한가: 원 시스템은 등급 **체계**를 갖고 있다(\"6축 용접 자격자\" 는 \"용접 자격자\" 이고, 그것은\n * \"생산직\" 이다). 그 체계가 들어올 자리가 없으면 요구와 소속이 **문자열이 똑같을 때만** 맞아,\n * 현장에서는 되는 배정이 모델에서 막힌다.\n */\nexport interface RefResourceClass {\n  id: string\n  description?: string\n  /** 상위 등급들 — 표준 `<X>ClassBaseID`(복수 = 다중 상속). */\n  baseIds?: string[]\n  properties?: RefResourceProperty[]\n  testSpecificationIds?: string[]\n  /** 유효 기간(ISO) — 표준 `EffectiveStartDate`/`EffectiveEndDate`. 밖이면 자격이 성립하지 않는다. */\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\nexport interface RefEquipment {\n  id: string\n  kind: string\n  homeLocationId: string\n  mtbfMs?: number // 평균 고장 간격(확률적 고장) — 지정 시 커널이 breakdown 시뮬 → 주목(고장) 발생\n  mttrMs?: number // 평균 수리 시간\n  gs1Id?: string // 정식 GS1 정체성(§J) — 설비=GIAI.\n  /**\n   * 교대(가동시간) — 이 시간대에만 배정된다. `startHour <= endHour` 면 같은 날, 넘어가면 야간(22→6).\n   * 미지정=24시간 가용. 교대 밖 자원은 고장·계획정지와 **구별되는 이유**로 쉰다(상태에 드러난다).\n   */\n  window?: { startHour: number; endHour: number }\n  /**\n   * 근무 캘린더 — 표준 `WorkCalendarEntry`(복수). 있으면 `window` 보다 이것을 본다.\n   *\n   * 축을 프레임워크 `@things-factory/work-shift` 의 `WorkShift`(`fromDate`·`fromTime`·`toDate`·`toTime`)와\n   * 맞춰 두었다 — 그 엔티티를 교대의 정본으로 결선할 때 직선 매핑이 되게. **아직 결선하지 않았다**:\n   * 그 엔티티에는 자원 연결과 비근무(휴일)가 없어 확장이 함께 필요하고, operato-twin 의 의존성 추가는\n   * 앱 아키텍처 결정이다(커버리지 §4-7 에 결선 지점으로 기록).\n   */\n  workCalendar?: WorkCalendarEntry[]\n  /**\n   * 설비 속성(속도 등) — 없으면 **이동시간을 거리에서 계산할 수 없다**(속도 없이 거리만으로는 시간이\n   * 안 나온다). 그때는 커널 상수로 떨어지고 그 사실이 `specCoverage()` 에 남는다.\n   */\n  properties?: RefResourceProperty[]\n  /** 적격을 검증한 시험 명세들 — 표준 `TestSpecificationID`(교정 등). */\n  testSpecificationIds?: string[]\n  /**\n   * 유효 기간 — **표준 `EffectiveStartDate` / `EffectiveEndDate`**(개체 타입 셋 모두에 있다).\n   *\n   * 없으면 **폐기한 것이 영구히 살아 있다**: 배정 대상에 남고, 가용 수에 들어가고, 화면에 뜬다.\n   * 도입 예정인 것은 반대로 오늘부터 있는 것처럼 보인다. 기간 밖이면 커널이 그 시각의 모델에서\n   * 빼고 **이유를 달아 남긴다**(`effectivity: 'not-yet' | 'expired'`) — 조용히 지우지 않는다.\n   */\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\n/**\n * 공정 모수 — 커널 `OperationParameter`(= ISA-95 `ParameterSpecification`/`ParameterType`) 와 **같은 모양**.\n * 이름을 바꾸지 않는다: 인제스트 경계에서 어휘가 갈리면 그 자리에서 방언이 생긴다.\n * ID 어휘의 정본은 커널 `OP_PARAM`(표준이 파라미터 ID 를 정하지 않으므로 우리가 한 곳에서 정한다).\n */\nexport interface RefOperationParameter {\n  id: string\n  /** ISA-95 `Value.ValueString` — 표준이 문자열로 싣는다. 기간 모수는 ISO 8601(`PT8M`). */\n  value: string\n  /** ISA-95 `Value.UnitOfMeasure`. 무차원(비율)이면 생략. */\n  uom?: string\n}\n\n/**\n * 공정의 자재 요구·산출 — **ISA-95 `OperationsSegment.MaterialSpecification`** 과 같은 모양.\n * 인원·설비·자산 명세와 같은 자리에 있어야 4대 자원이 대칭이 된다(자재만 빠져 있었다).\n */\nexport interface RefOpMaterialSpecification {\n  id?: string\n  /** 품목 등급으로 요구 — 표준 `MaterialClassID`. */\n  materialClass?: string\n  /** 특정 품목으로 요구 — 표준 `MaterialDefinitionID`. */\n  materialDefinition?: string\n  /** 표준 `MaterialUse` — 이 공정에서의 쓰임. */\n  use: 'consumed' | 'produced' | 'consumable'\n  /** 표준 `Quantity`. 단위 미지정이면 개수. */\n  quantity: number\n  uom?: string\n}\n\n/** 소요시간 변동 — **표준 밖 확장**(ISA-95 Duration 은 스칼라). 커널 `DurationVariability` 와 동형. */\nexport interface RefOperationVariability {\n  distribution: 'constant' | 'exponential' | 'uniform' | 'triangular'\n  min?: string\n  max?: string\n  mode?: string\n}\n\n/**\n * 오퍼레이션 명세 — ISA-95 `OperationsSegment`. 커널 `OperationDef` 와 필드 이름이 1:1이다.\n *\n * **이것이 없으면 시뮬레이션의 시간은 우리가 코드에 박아 둔 상수다.** 원 시스템(또는 가상 레퍼런스)이\n * 공정별 소요·변동·수율을 말해 줘야 예측이 그 현장의 예측이 된다. 주지 않으면 커널 기본값으로\n * 굴러가고, **기본값을 썼다는 사실은 커널 `specCoverage()` 가 밝힌다**(조용히 넘어가지 않는다).\n */\nexport interface RefOperation {\n  /** 작업 종류 키 — 커널 `FlowTask.kind` 와 같은 값이어야 명세가 그 작업에 붙는다. */\n  key: string\n  label: string\n  intent: 'transport' | 'process' | 'dwell'\n  locationType?: string\n  resourceType?: string\n  bizStep?: string\n  /** ISA-95 `OperationsSegment.Duration` — ISO 8601 기간(`PT12M`). */\n  duration?: string\n  variability?: RefOperationVariability\n  parameters?: RefOperationParameter[]\n  /**\n   * 필요 인원 — ISA-95 `PersonnelSpecification`(`PersonnelClassID` + `Quantity`) 1:1.\n   * 없으면 사람 없이 도는 공정이다(설비만 잡는다).\n   */\n  personnelSpecification?: { personnelClass?: string; quantity: number }[]\n  /** 필요 물리 자산 — ISA-95 `PhysicalAssetSpecification`(등급 + 수량). 빈 팔레트가 없으면 못 나간다. */\n  physicalAssetSpecification?: { assetClass?: string; quantity: number }[]\n  /**\n   * 필요·산출 자재 — ISA-95 `MaterialSpecification`. **4대 자원 중 자재만 이 자리가 없었다** —\n   * 그래서 부품이 떨어져 라인이 서는 상황이 예측에 나타나지 않았다.\n   * BOM 의 \"몇 개\" 는 여기다(품목 정의의 조립 구조에는 수량이 없다 — 1차 출처 확인).\n   */\n  materialSpecification?: RefOpMaterialSpecification[]\n}\n\n/**\n * 사람 — **ISA-95 `Person`.** 설비와 별개 자원이다(고장·설비효율이 아니라 등급·교대로 산다).\n * `personnelClass` 가 ISA-95 `PersonnelClassID` — 공정은 특정인이 아니라 **등급으로** 인원을 요구한다.\n */\nexport interface RefPerson {\n  id: string\n  name?: string\n  /**\n   * 속한 등급들 — **표준 `Person.PersonnelClassID`, `maxOccurs=\"unbounded\"`**.\n   * 복수인 것이 표준이고 그것이 자격 표현이다: 한 사람이 용접 자격과 지게차 자격을 함께 갖는다.\n   */\n  personnelClassIds?: string[]\n  /** 교대 — 설비와 같은 모양. 미지정=24시간 가용. */\n  window?: { startHour: number; endHour: number }\n  /** 근무 캘린더 — 표준 `WorkCalendarEntry`(복수). 2교대·휴게·휴일을 함께 표현한다. */\n  workCalendar?: WorkCalendarEntry[]\n  /**\n   * 기본 위치 — 표준 `Person.OperationalLocation`. 없으면 \"이 라인에 몇 명 있나\" 를 물을 수 없다.\n   * 사람은 움직이므로 이 값은 **출발점**이고, 실제 위치는 관측(person.status)이 갱신한다.\n   */\n  homeLocationId?: string\n  /**\n   * 자원 속성 — 표준 `PersonProperty`. **자격증·숙련도가 여기 들어간다.**\n   *\n   * 표준에는 자격(Qualification)이라는 별도 요소가 없다(`B2MML-Personnel.xsd` 확인). 자격은\n   * ① 등급 복수 소속으로(`personnelClassIds: ['welder-certified','forklift-licensed']`) ②\n   * 증빙은 이 속성으로(자격증 번호·만료일), ③ 검증 시험은 표준 `TestSpecificationID`(아직 미구현).\n   */\n  properties?: RefResourceProperty[]\n  /** 자격을 검증한 시험 명세들 — 표준 `TestSpecificationID`(참조만; 시험 명세·결과 모델은 아직 없다). */\n  testSpecificationIds?: string[]\n  /** 유효 기간 — 사람에게는 **입사 전·퇴사 후**다(자격 만료는 등급 쪽 기간이다: 사람은 남고 자격만 끊긴다). */\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\n/**\n * 물리 자산(반복사용) — **ISA-95 `PhysicalAsset`, GS1 `GRAI`.**\n * 팔레트·랙·용기처럼 **나갔다 돌아오는** 것. 물류단위(SSCC)와 다르다: SSCC 는 그 팔레트에 실린 화물\n * 한 덩어리이고, GRAI 는 팔레트 자체다(오늘은 이 화물, 내일은 저 화물을 싣는다).\n */\nexport interface RefAsset {\n  id: string\n  name?: string\n  /**\n   * 속한 등급들 — 표준 `PhysicalAssetClassID`(복수). 팔레트가 'euro-pallet' 이면서 'food-grade' 일 수 있다.\n   * 공정의 요구는 등급 하나 + 수량이다(표준 `PhysicalAssetSpecification`).\n   */\n  assetClassIds?: string[]\n  /** 기본 위치. */\n  homeLocationId?: string\n  /** 정식 GS1 정체성 — 반복사용 자산=GRAI. */\n  gs1Id?: string\n  /** 자원 속성 — 표준 `PhysicalAssetProperty`(적재 한도·규격 등). */\n  properties?: RefResourceProperty[]\n  /** 적격을 검증한 시험 명세들 — 표준 `TestSpecificationID`. */\n  testSpecificationIds?: string[]\n  /** 유효 기간 — 자산에서는 **폐기한 팔레트가 풀에서 빠지는 것**이다(회수 대상 수가 부풀지 않게). */\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\n/**\n * 품목 정의 — **ISA-95 `MaterialDefinition`.**\n *\n * 없으면 로트만 관측으로 들어오고 **품목이 무엇인지는 아무 데도 없다.** 그래서 같은 로트를 100개로\n * 받아도 \"몇 kg 인가\" 에 답할 수 없다(커널 `quantityIn` 이 환산을 거부하는 근거).\n *\n * **표준에 단위 환산 요소는 없다**(1차 출처 전수 확인) — 속성 주머니뿐이다. 그래서 환산 계수는\n * 커널이 정한 속성 이름(`perBaseUnit`, `uom` 이 대상 단위)으로 `properties` 에 싣는다.\n */\nexport interface RefMaterialDefinition {\n  /** 표준 `ID` — GTIN(`urn:epc:idpat:sgtin:…`)을 쓴다(정체성의 정본이 EPCIS 다). */\n  id: string\n  name?: string\n  /** 속한 등급들 — 표준 `MaterialClassID`(복수). */\n  materialClassIds?: string[]\n  /** 품목 속성 — 표준 `MaterialDefinitionProperty`. 환산 계수가 여기 들어간다. */\n  properties?: RefResourceProperty[]\n  testSpecificationIds?: string[]\n  effectiveStart?: string\n  effectiveEnd?: string\n}\n\nexport interface ReferenceMaster {\n  source: string\n  system: 'wms' | 'yms' | 'mes'\n  siteName: string\n  /* spaceId 명시 시 그 공간을 참조(여러 트윈이 한 공간 공유, N:1). 없으면 source 에서 파생(1:1). */\n  /**\n   * 현장(공간). **시각 기준(`timezone`)이 여기 있는 이유**: 한 테넌트가 Rosarito(태평양)와 한국\n   * 공장을 함께 가질 수 있다. 테넌트 단위(`Domain.timezone`)로 두면 **둘 중 하나는 반드시 틀린다.**\n   * 시각 기준은 **물리 현장의 성질**이므로 공간이 그것을 갖는다(공간 중심 원칙).\n   *\n   * `timezone` 은 IANA 이름(`'America/Tijuana'`) — 오프셋 숫자가 아니다. 숫자로 두면 일광절약시간을\n   * 표현할 수 없고, 나중에 절대 구간으로 옮길 때도 이름이 있어야 계산할 수 있다.\n   */\n  space: { spaceId?: string; width: number; depth: number; unit?: string; timezone?: string; geo?: { lat: number; lon: number; rotation?: number }; representations?: any[]; primaryId?: string }\n  locations: RefLocation[]\n  equipment?: RefEquipment[]\n  /** 공정 명세(소요·변동·수율) — 없으면 커널 기본값으로 굴러간다(그 사실은 specCoverage 가 보고). */\n  operations?: RefOperation[]\n  /**\n   * **생산 정의**(레시피·라우트·자재 바인딩) — 커널의 정의-구동 MES 모드 입구.\n   *\n   * 없으면 커널은 레거시(하드코딩) 흐름으로 돈다. 즉 **현장 레시피를 적어도 이 자리에 실리지 않으면\n   * 커널은 그것을 보지 못한다** — 선언과 실행이 갈라지는 지점이라 자리를 연다.\n   */\n  /**\n   * 생산 선언 — `BoardDef.productionSpec` 으로 통과한다(ISA-95 OperationsSegment + BOM).\n   *\n   * 예전 이름은 `mesSpec` 이었다. 담긴 것은 MES 만의 것이 아니라 \"자재를 소비해 자재를 산출하는\n   * 공정\" 이고, 이름이 MES 였기 때문에 창고 트윈은 이 자리를 쓸 생각조차 하지 못했다(유통가공 창고가\n   * BOM 을 설명 문서에만 적어 둔 채 키트를 못 만드는 트윈을 만든 원인). 근거는 커널 계약 주석에.\n   */\n  productionSpec?: unknown\n  /**\n   * 사람 — 선언하지 않으면 **인원 제약이 없는 트윈**이 된다(설비만 있으면 언제나 돌아가는 공장).\n   * 공정이 인원을 요구하는데 사람이 없으면 그 작업은 시작되지 않는다 — 그것이 사실이므로 그대로 둔다.\n   */\n  persons?: RefPerson[]\n  /**\n   * 물리 자산(반복사용) — 선언하지 않으면 자산 제약이 없는 트윈이다.\n   * 공정이 자산을 요구하는데 없으면 그 작업은 시작되지 않는다 — 그것이 사실이므로 그대로 둔다.\n   */\n  assets?: RefAsset[]\n  /**\n   * 등급 정의 — 표준 `PersonnelClass`·`EquipmentClass`·`PhysicalAssetClass`.\n   * 안 실어도 트윈은 돈다(소속 문자열 그대로 판정). 실으면 상속·유효기간이 살아난다.\n   */\n  personnelClasses?: RefResourceClass[]\n  equipmentClasses?: RefResourceClass[]\n  assetClasses?: RefResourceClass[]\n  /** 품목 정의·등급 — 표준 `MaterialDefinition` / `MaterialClass`. 없으면 단위 환산을 할 수 없다. */\n  materialDefinitions?: RefMaterialDefinition[]\n  materialClasses?: RefResourceClass[]\n}\n\nexport interface IngestedTwin {\n  board: any // BoardDef(+layout+spaceId) — 커널 소비\n  spaceContent: any // TwinSpace content — 뷰 소비\n  warnings: IngestWarning[]\n}\n\n/**\n * 마스터 → 트윈 구조 매핑(순수). 노드타입을 카탈로그로 검증(모르는 타입은 warning, 버리진 않음 — 반영 우선).\n * @param catalog DOMAIN_CATALOG (커널 SSOT). 없으면 검증 생략.\n */\n/**\n * IANA 시간대 이름 → **그 시각의** UTC 오프셋(분). 의존성 없이 `Intl` 로 푼다.\n *\n * `Intl.DateTimeFormat` 의 `longOffset` 은 `\"GMT-07:00\"` 처럼 나오고, 이것은 **일광절약시간을 반영한**\n * 값이다. 그래서 8월의 `America/Tijuana` 는 −420(PDT), 1월은 −480(PST)이 된다.\n *\n * **한계를 밝힌다**: 여기서 나오는 것은 **한 시점의** 오프셋이다. 커널은 고정 오프셋으로 하루 중 분을\n * 읽으므로, 보드를 만든 계절과 다른 계절을 길게 예측하면 한 시간 어긋난다. 표준에 충실한 끝 모습은\n * 호스트가 절대 구간(`StartDateTime`/`FinishDateTime`)을 계산해 넣는 것이고, 그때 이 함수는 사라진다.\n *\n * 모르는 이름에는 **0 을 답하지 않는다**(`undefined`) — 0 은 \"UTC 라고 선언했다\" 는 뜻이고, 모르는 것을\n * 그렇게 바꾸면 판정이 조용히 틀린다.\n */\nexport function utcOffsetOf(timezone?: string, at: Date = new Date()): number | undefined {\n  if (!timezone) return undefined\n  try {\n    const parts = new Intl.DateTimeFormat('en-US', { timeZone: timezone, timeZoneName: 'longOffset' }).formatToParts(at)\n    const name = parts.find(p => p.type === 'timeZoneName')?.value ?? ''\n    if (name === 'GMT') return 0 // UTC 계열은 오프셋 표기가 없다\n    const m = /^GMT([+-])(\\d{1,2})(?::(\\d{2}))?$/.exec(name)\n    if (!m) return undefined\n    const sign = m[1] === '-' ? -1 : 1\n    return sign * (Number(m[2]) * 60 + Number(m[3] ?? 0))\n  } catch {\n    return undefined // 알 수 없는 이름 — Intl 이 던진다\n  }\n}\n\n\n/* ── 인제스트 경고 ──────────────────────────────────────────────────────────\n * 인제스트는 구조에 문제가 있어도 트윈을 만들어 준다(막지 않는 것이 옳다 — 부분적으로라도 세우고\n * 고쳐 나가는 것이 이 시스템의 방식이다). 그래서 **경고가 유일한 신호**인데, 그 경고를 화면이 하나도\n * 보여주지 않고 있었다: 유통가공 창고 템플릿은 커널이 모르는 자리 타입(`vas-station`)으로 트윈을\n * 만들면서 경고를 냈지만, 위자드는 그것을 버렸고 사용자는 아무 말 없이 막히는 트윈을 받았다.\n *\n * 문장이 아니라 코드로 실어 보낸다. 예전 경고는 프로즈였고 그중 하나에는 한글이 섞여 있었다\n * (`— 카탈로그에 없음`) — 다섯 언어 화면에 그대로 내보내면 이번에 걷어낸 문제를 다시 만든다.\n * 이 프로젝트가 이미 쓰는 규약과 같은 모양이다: 주의 신호(kind+params)·커맨드 거절(errorCode+params)·\n * 만만함 판정(code+영어 canonical message).\n *\n *   code    언어 중립 — 화면이 `twin.ingest.<code>` 로 사람 말을 만든다\n *   params  문장에 끼울 값 — 번역이 언어마다 어순을 바꿀 수 있게\n *   message 영어 canonical — 로그에 남고, 번역이 없을 때 그대로 보인다(빈칸보다 낫다)\n *\n * **여기 사는 이유**: 이 파일이 경고의 생산자이고, 테스트가 소스에서 직접 읽는 모듈이라\n * 런타임 상대 import 를 가질 수 없다(이 저장소의 규약 — 그런 모듈은 자기완결이다).\n * ────────────────────────────────────────────────────────────────────────── */\n/** 인제스트가 알리는 한 가지. */\nexport interface IngestWarning {\n  /** 언어 중립 코드. 화면은 `twin.ingest.<code>` 로 렌더한다. */\n  code: string\n  /** 문장에 끼울 값. 번역이 어순을 바꿀 수 있게 이름으로 넘긴다. */\n  params?: Record<string, string | number>\n  /** 영어 canonical 문장 — 로그·폴백용. 번역이 없어도 읽을 수 있어야 한다. */\n  message: string\n}\n\n/** 커널 카탈로그가 모르는 자리 타입 — 그 자리는 흐름에 참여하지 못할 수 있다. */\nexport const unknownLocationType = (system: string, type: string, id: string): IngestWarning => ({\n  code: 'unknown-location-type',\n  params: { system, type, id },\n  message: `\"${type}\" is not a known ${system} location type (${id}) — the kernel may not include this location in the flow`\n})\n\n/** 시간대 문자열을 못 읽었다 — 시각 해석이 UTC 로 떨어진다(조용히 현지 시각으로 가정하지 않는다). */\nexport const unknownTimezone = (timezone: string): IngestWarning => ({\n  code: 'unknown-timezone',\n  params: { timezone },\n  message: `space timezone \"${timezone}\" is not a known IANA zone — the twin will read times as UTC`\n})\n\n/** 작업 정의에 소요시간·파라미터가 없다 — 커널 기본값으로 돈다. */\nexport const operationWithoutDuration = (operation: string): IngestWarning => ({\n  code: 'operation-without-duration',\n  params: { operation },\n  message: `operation \"${operation}\" has no duration or parameters — kernel defaults will be used`\n})\n\n/** 볼 수 있는 표현이 없다 — 현장이 화면에 뜨지 않는다. */\nexport const noViewableRepresentation = (): IngestWarning => ({\n  code: 'no-viewable-representation',\n  message: 'the space has no viewable representation (no representations and no geo) — add one, or provide geo/board'\n})\n\n/** 합치는 공간에 같은 id 의 랜드마크가 이미 있다 — 서로 다른 것이 하나로 접혔을 수 있다. */\nexport const landmarkIdsMerged = (spaceId: string, ids: readonly string[]): IngestWarning => ({\n  code: 'landmark-ids-merged',\n  params: { spaceId, ids: ids.join(', '), count: ids.length },\n  message: `landmark ids already present in space \"${spaceId}\" — merged: ${ids.join(', ')}`\n})\n\n/** 로그 한 줄 — 개발자가 읽는 것이므로 영어 canonical 문장을 쓴다. */\nexport const describeWarnings = (warnings: readonly IngestWarning[]): string =>\n  warnings.map(w => `${w.code}: ${w.message}`).join(' | ')\n\n/**\n * 서버가 기본값으로 채운 노브들 — 사용자가 준 적 없는 값으로 트윈이 만들어졌음을 알린다.\n *\n * 조용히 채우면 나중에 \"왜 이 수치인가\" 를 아무도 답할 수 없다. 막을 일은 아니다(기본값은 템플릿이\n * 확신을 갖고 선언한 값이다) — 다만 밝힌다.\n */\nexport const knobDefaultsFilled = (keys: readonly string[]): IngestWarning => ({\n  code: 'knob-defaults-filled',\n  params: { keys: keys.join(', '), count: keys.length },\n  message: `values you did not provide were filled from the template defaults: ${keys.join(', ')}`\n})\n\nexport function masterToTwin(master: ReferenceMaster, catalog?: any): IngestedTwin {\n  const warnings: IngestWarning[] = []\n  const known: string[] = catalog?.[master.system]?.locationTypes ?? []\n\n  const locationEntries = master.locations.filter(l => l.role === 'location' || l.role === 'both')\n  const areaLocs = master.locations.filter(l => l.role === 'area' || l.role === 'both')\n\n  const locations = locationEntries.map(l => {\n    if (known.length && !known.includes(l.type)) warnings.push(unknownLocationType(master.system, l.type, l.id))\n    // gs1Id(정식 정체성)를 보드 노드로 통과 — 결합(tag)/추적이 GS1 로(§J). 로컬 id 는 그대로 유지(name/xref).\n    return { id: l.id, type: l.type, capacity: l.capacity ?? 0, ...(l.parallelism !== undefined ? { parallelism: l.parallelism } : {}), ...(l.level ? { level: l.level } : {}), parentId: l.parentId, gs1Id: l.gs1Id }\n  })\n\n  const equipment = (master.equipment ?? []).map(e => ({\n    id: e.id, kind: e.kind, homeLocation: e.homeLocationId, mtbfMs: e.mtbfMs, mttrMs: e.mttrMs, gs1Id: e.gs1Id,\n    ...(e.window ? { window: e.window } : {}),\n    /* 속성은 손대지 않고 통과 — 이동시간 추정기가 kind 별 속도를 여기서 읽는다(단위 코드 그대로). */\n    ...(e.properties?.length ? { properties: e.properties } : {}), ...(e.workCalendar?.length ? { workCalendar: e.workCalendar } : {}), ...(e.testSpecificationIds?.length ? { testSpecificationIds: e.testSpecificationIds } : {}),\n    /* 유효 기간도 손대지 않고 통과 — 판정은 커널이 자기 시계로 한다(호스트가 미리 자르지 않는다). */\n    ...(e.effectiveStart ? { effectiveStart: e.effectiveStart } : {}), ...(e.effectiveEnd ? { effectiveEnd: e.effectiveEnd } : {})\n  }))\n\n  // 좌표(layout) — footprint 중심. 없으면 생략(coordinate-free 유지).\n  const layout: Record<string, { x: number; y: number }> = {}\n  for (const l of locationEntries) if (l.footprint) layout[l.id] = { x: l.footprint.x + l.footprint.w / 2, y: l.footprint.y + l.footprint.h / 2 }\n\n  const spaceId = master.space.spaceId ?? `${master.source}-site`\n  /*\n   * 시각 기준을 커널이 읽을 형태로 푼다 — 커널은 zero-dep 이라 시간대 데이터베이스를 들이지 않고\n   * **분 오프셋**만 받는다(계약 `BoardDef.utcOffsetMinutes`). 푸는 일은 호스트의 몫이다.\n   *\n   * 선언이 없으면 **필드를 만들지 않는다** — 그러면 커널이 UTC 로 읽고, 그 기본값은 계약에 밝혀져 있다.\n   * 여기서 0 을 넣으면 \"UTC 라고 선언했다\" 와 \"선언하지 않았다\" 가 구별되지 않는다.\n   */\n  const utcOffsetMinutes = utcOffsetOf(master.space.timezone)\n  if (master.space.timezone && utcOffsetMinutes === undefined) {\n    warnings.push(unknownTimezone(String(master.space.timezone)))\n  }\n  /*\n   * 오퍼레이션 명세를 board 에 통과시킨다 — 커널이 `loadOperations` 로 소비한다(BoardDef 확장 필드,\n   * 모르는 커널은 무시). 여기서 값을 손대지 않는다: 기간은 표준 표기(ISO 8601)로 커널까지 그대로 간다.\n   */\n  const operations = master.operations\n  if (operations?.length) {\n    for (const o of operations) {\n      if (!o.duration && !o.parameters?.length) warnings.push(operationWithoutDuration(o.key))\n    }\n  }\n  /* 사람도 손대지 않고 통과 — 등급·교대 그대로 커널까지 간다(경계에서 어휘를 갈지 않는다). */\n  const persons = master.persons?.map(p => ({ id: p.id, personnelClassIds: p.personnelClassIds, ...(p.window ? { window: p.window } : {}), ...(p.workCalendar?.length ? { workCalendar: p.workCalendar } : {}), ...(p.homeLocationId ? { homeLocation: p.homeLocationId } : {}), ...(p.properties?.length ? { properties: p.properties } : {}), ...(p.testSpecificationIds?.length ? { testSpecificationIds: p.testSpecificationIds } : {}), ...(p.effectiveStart ? { effectiveStart: p.effectiveStart } : {}), ...(p.effectiveEnd ? { effectiveEnd: p.effectiveEnd } : {}) }))\n  /* 자산도 손대지 않고 통과 — 등급·자리 그대로 커널까지. */\n  const assets = master.assets?.map(a => ({ id: a.id, assetClassIds: a.assetClassIds, homeLocation: a.homeLocationId, gs1Id: a.gs1Id, ...(a.properties?.length ? { properties: a.properties } : {}), ...(a.testSpecificationIds?.length ? { testSpecificationIds: a.testSpecificationIds } : {}), ...(a.effectiveStart ? { effectiveStart: a.effectiveStart } : {}), ...(a.effectiveEnd ? { effectiveEnd: a.effectiveEnd } : {}) }))\n  /* 품목 정의·등급도 손대지 않고 통과 — 경계에서 어휘를 갈지 않는다(환산 계수는 커널이 읽는다). */\n  const materialDefinitions = master.materialDefinitions?.map(d => ({\n    id: d.id,\n    ...(d.name ? { description: d.name } : {}),\n    ...(d.materialClassIds?.length ? { materialClassIds: d.materialClassIds } : {}),\n    ...(d.properties?.length ? { properties: d.properties } : {}),\n    ...(d.testSpecificationIds?.length ? { testSpecificationIds: d.testSpecificationIds } : {}),\n    ...(d.effectiveStart ? { effectiveStart: d.effectiveStart } : {}),\n    ...(d.effectiveEnd ? { effectiveEnd: d.effectiveEnd } : {})\n  }))\n  const board = {\n    locations, equipment, layout, spaceId,\n    /* 생산 정의도 손대지 않고 통과 — 경계에서 어휘를 갈지 않는다(커널이 그대로 소비한다). */\n    ...(master.productionSpec ? { productionSpec: master.productionSpec } : {}),\n    ...(materialDefinitions?.length ? { materialDefinitions } : {}),\n    ...(master.materialClasses?.length ? { materialClasses: master.materialClasses } : {}),\n    ...(utcOffsetMinutes !== undefined ? { utcOffsetMinutes } : {}),\n    ...(operations?.length ? { operations } : {}),\n    ...(master.personnelClasses?.length ? { personnelClasses: master.personnelClasses } : {}),\n    ...(master.equipmentClasses?.length ? { equipmentClasses: master.equipmentClasses } : {}),\n    ...(master.assetClasses?.length ? { assetClasses: master.assetClasses } : {}),\n    ...(persons?.length ? { persons } : {}),\n    ...(assets?.length ? { assets } : {})\n  }\n\n  const areas = areaLocs.map(l => ({\n    id: l.id, type: l.type, name: l.name ?? l.id, parentId: l.parentId,\n    x: l.footprint?.x ?? 0, y: l.footprint?.y ?? 0, w: l.footprint?.w ?? 10, h: l.footprint?.h ?? 10\n  }))\n  // 인제스트 현장 물질화(space facet #4) — 표현이 없고 geo 가 있으면 기본 map 표현 합성.\n  // \"인제스트하면 알아볼 현장(내 place)이 뜬다\"는 공간 중심 정수 보장(zero-to-twin): 커넥터/템플릿이\n  // 표현을 안 줘도 geo 만 있으면 위성 지도로 착지. (area 폴리곤 물질화는 좌표 투영 필요 → space #3.)\n  const geo = master.space.geo\n  const givenReps = master.space.representations ?? []\n  const representations =\n    givenReps.length > 0\n      ? givenReps\n      : geo\n        ? [{ id: 'r-map', type: 'map', name: '위성 지도', primary: true, center: { lat: geo.lat, lon: geo.lon }, zoom: 17 }]\n        : []\n  if (representations.length === 0) {\n    warnings.push(noViewableRepresentation())\n  }\n  const spaceContent = {\n    width: master.space.width, depth: master.space.depth, unit: master.space.unit ?? 'm',\n    geo, representations, primaryId: master.space.primaryId ?? representations[0]?.id,\n    areas, landmarks: []\n  }\n\n  return { board, spaceContent, warnings }\n}\n"]}

package/dist-server/service/reference/reference-resolver.d.ts

@@ -6,7 +6,7 @@ export declare class TwinReferenceResolver {
     /** 등록된 트윈 템플릿(파라미터화 아키타입) 목록 — 노브 스키마 포함(클라이언트 폼용). */
     twinTemplates(_context: ResolverContext): Promise<any[]>;
     /** 템플릿 + 노브 → 합성 마스터 → 인제스트(+기동+시나리오). 레퍼런스 import 와 같은 경로, 원천만 합성. */
-    createFromTemplate(templateId: string, params: any, context: ResolverContext, start?: boolean): Promise<any>;
+    createFromTemplate(templateId: string, params: any, context: ResolverContext, start?: boolean, spaceId?: string): Promise<any>;
     twinReferences(context: ResolverContext): Promise<any[]>;
     referenceAdapterTypes(): string[];
     /**
@@ -29,7 +29,7 @@ export declare class TwinReferenceResolver {
      * P1 은 대개 N=1(virtual/단일). start 면 각 인스턴스 기동. 라이브 피드·mode 는 face2-inbound-live 소유.
      */
     /** 레퍼런스가 노출하는 사이트/공장 발견 — 트윈 생성 시 "어느 공장" 선택용(§2.2). */
-    discoverReferenceSites(source: string, context: ResolverContext): Promise<any[]>;
+    discoverReferenceSites(source: string, context: ResolverContext): Promise<any>;
     /**
      * 트윈 생성 — 레퍼런스에서 사이트 발견 → (siteIds 있으면 그 공장만) → fetchMaster → provision. 사이트별 resilient.
      * 여러 공장을 관할하는 소스는 siteIds 로 "어느 공장"을 골라 생성(1:N, §2.1·§2.2).