@things-factory/headless-twin 10.1.45 → 10.1.47

package/dist-server/engine/warm-start.d.ts

@@ -108,6 +108,8 @@ export interface ContinuitySeed {
         since: string;
     }[];
     energy?: unknown;
+    /** 접힌 오더(ADR-0092) — 모양은 커널이 안다(호스트는 있나만 본다). */
+    foldedOrders?: unknown;
 }
 export interface ContinuityPlan {
     seed: ContinuitySeed;
@@ -116,6 +118,8 @@ export interface ContinuityPlan {
     attentionSinceCount: number;
     /** 에너지 연속성을 이어받았나 — 열린 구간이 있으면 그 구간의 요금 근거가 살아난다. */
     energy: boolean;
+    /** 접힌 오더를 이어받았나(ADR-0092). */
+    foldedOrders: boolean;
 }
 /** 미러가 이어받을 축만 골라낸다 — 관측 축(재고·위치·설비)은 일부러 넣지 않는다. */
 export declare function planLiveContinuity(raw: unknown): ContinuityPlan;

package/dist-server/engine/warm-start.js

@@ -139,15 +139,19 @@ function planLiveContinuity(raw) {
         : [];
     /* 에너지는 커널이 자기 모양을 안다 — 호스트는 「있나」만 본다(골라 담으면 규칙이 두 곳으로 갈린다). */
     const energy = state?.energy && typeof state.energy === 'object' ? state.energy : undefined;
+    /* 접힌 오더(ADR-0092) — 원천을 다시 읽는 미러도 세는 수와 경계를 잃지 않게(없으면 옛 종결이 뜨거운 줄로 되살아난다). */
+    const foldedOrders = state?.foldedOrders && typeof state.foldedOrders === 'object' ? state.foldedOrders : undefined;
     return {
         seed: {
             ...(acked.length ? { acked } : {}),
             ...(attentionSince.length ? { attentionSince } : {}),
-            ...(energy ? { energy } : {})
+            ...(energy ? { energy } : {}),
+            ...(foldedOrders ? { foldedOrders } : {})
         },
         ackedCount: acked.length,
         attentionSinceCount: attentionSince.length,
-        energy: !!energy
+        energy: !!energy,
+        foldedOrders: !!foldedOrders
     };
 }
 //# sourceMappingURL=warm-start.js.map

package/dist-server/engine/warm-start.js.map

@@ -1 +1 @@
-{"version":3,"file":"warm-start.js","sourceRoot":"","sources":["../../server/engine/warm-start.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * 웜스타트 판정 — **순수**. \"기동하는 커널에 직전 상태를 주입할 것인가, 주입한다면 무엇을\" 만 정한다.\n * 실제 주입(hydrateObserved 호출)과 로그는 엔진이 한다.\n *\n * ── 왜 떼어냈나 ─────────────────────────────────────────────────────────────\n * 이 판정이 틀리면 증상이 정반대 두 방향으로 나온다: 주입해야 할 때 안 주입하면 **있는 재고가 0 으로**\n * 보이고(2026-07-31 hatiolab-wms: 저널에 입고 540·출고 94 인데 재고 화면이 비어 있었다), 심지\n * 말아야 할 벤치에 주입하면 **용량 측정이 오염된다.** 둘 다 알리지 않고 틀리는 종류라 규칙을 고정한다.\n *\n * ── 오더를 버리던 전제가 낡았다 (2026-08-05) ────────────────────────────────\n * 예전 주석은 \"스냅샷의 오더에는 progress 밖에 없어서 역산하면 없는 숫자를 지어내는 셈이므로\n * 넘기지 않는다\" 였다. 그때는 맞았다. 그러나 커널 `OrderState` 가 **원값을 되찾은 뒤**\n * (`requested`·`fulfilled`·`lines`) 이 판정만 그대로 남아, 재기동하면 재고는 맞는데 **진행 중\n * 주문이 통째로 사라진** 화면이 나왔다. 오류는 나지 않는다 — 그래서 오래 남아 있었다.\n *\n * 두 스냅샷 생산 경로가 모두 원값을 담는다: 시뮬은 커널 `snapshot()`, 라이브(미러)는\n * `StateProjector` 다. 사람·자산·작업도 같은 스냅샷에 있고 커널이 심을 수 있는데 넘기지 않고 있었다.\n * 그래서 씨앗을 **관측 스냅샷 전체**로 넓힌다.\n *\n * 다만 넓히면서 **들어온 것이 없는 누락을 만들지 않는다.** 원값이 없는 오더는 커널이 걸러 내므로(지어내지\n * 않는다), 그 수를 여기서 세어 호출부가 말할 수 있게 한다. 세지 않으면 \"주문이 없다\" 와 \"주문을\n * 못 심었다\" 가 화면에서 같아진다.\n */\n\n/**\n * 커널에 심을 관측 상태 — 구조가 아니라 \"무엇이 어디에 얼마나\".\n *\n * 커널 `hydrateObserved` 가 받는 스냅샷 모양을 그대로 따른다. 여기서 골라 담지 않는 이유: 무엇을\n * 심을 수 있는지는 커널이 알고, 그 규칙(고아 작업 제외·이행 완료 오더 제외 등)도 커널에 있다.\n * 호스트가 미리 골라내면 규칙이 두 곳으로 갈린다.\n */\nexport interface ObservedSeed {\n  locations: unknown[]\n  items: unknown[]\n  equipment: unknown[]\n  persons?: unknown[]\n  assets?: unknown[]\n  tasks?: unknown[]\n  orders?: unknown[]\n  /** 확인해 둔 주목 신호 id — 상태에서 파생되지 않아 반드시 함께 넘긴다. */\n  acked?: string[]\n  /**\n   * 주목 신호가 **처음 성립한 시각** — 확인과 같은 성질이다(계산으로 되살릴 수 없다).\n   *\n   * 넘기지 않으면 재기동 뒤 세 시간째 지속된 조건이 「0초째」로 되살아난다. 방금 찬 자리와 세 시간째\n   * 막힌 자리는 할 일이 다르므로, 그 값이 거짓이면 화면이 사람을 잘못된 순서로 움직인다.\n   */\n  attentionSince?: { id: string; since: string }[]\n}\n\n/** 심은 것의 내역 — 로그와 테스트가 같은 숫자를 본다. */\nexport interface WarmStartCounts {\n  itemCount: number\n  equipmentCount: number\n  personCount: number\n  assetCount: number\n  taskCount: number\n  /** 원값(requested)이 있어 커널이 실제로 심을 수 있는 오더. */\n  orderCount: number\n  /** 이어받은 확인 처리 수 — 잃으면 확인해 둔 신호가 다시 빨개진다. */\n  ackedCount: number\n  /** 이어받은 시작 시각 수 — 잃으면 지속된 조건이 모두 「방금」이 된다. */\n  attentionSinceCount: number\n  /**\n   * 원값이 없어 심지 못하는 오더 — **0 이 아니면 반드시 말한다.**\n   * progress 만 있는 오더는 남은 수량을 알 수 없어 재계획의 근거가 되지 못한다. 지어내지 않고 뺀다.\n   */\n  ordersWithoutDemand: number\n  /** Finished orders carried folded (ADR-0092) — 0 when the twin had folded nothing. */\n  foldedOrderCount: number\n}\n\nexport type WarmStartPlan =\n  | ({ action: 'hydrate'; seed: ObservedSeed } & WarmStartCounts)\n  /** 벤치 트윈 — 새 시작에서 용량을 재는 게 목적이라 현재 상태를 주입하면 측정이 오염된다. */\n  | { action: 'skip'; reason: 'bench' }\n  /** 심을 상태가 없다 — 처음 만든 트윈이거나 저널·체크포인트가 비었다. 정상이다. */\n  | { action: 'skip'; reason: 'no-state' }\n  /** 커널이 관측 주입을 지원하지 않는다 — 구조만으로 시작하므로 보유량은 0 으로 읽힌다(알려야 한다). */\n  | { action: 'skip'; reason: 'unsupported' }\n\n/** 스냅샷이 들고 올 수 있는 관측 축 — 어느 것이든 있으면 주입할 가치가 있다. */\ninterface ObservedState {\n  locations?: unknown[]\n  items?: unknown[]\n  equipment?: unknown[]\n  persons?: unknown[]\n  assets?: unknown[]\n  tasks?: unknown[]\n  orders?: unknown[]\n  foldedOrders?: unknown\n  acked?: string[]\n  attentionSince?: { id: string; since: string }[]\n}\n\nfunction foldedTotal(f: { counts: Record<string, Record<string, number>> }): number {\n  let n = 0\n  for (const byStatus of Object.values(f.counts)) for (const c of Object.values(byStatus ?? {})) n += Number(c) || 0\n  return n\n}\n\n/** 관측 상태가 실려 있는지 — 축 하나라도 있으면 상태다(봉투에는 없다). */\nconst looksLikeState = (x: any): boolean =>\n  !!x && typeof x === 'object' && ['locations', 'items', 'equipment', 'orders', 'tasks', 'persons', 'assets', 'acked'].some(k => k in x)\n\n/**\n * 봉투를 벗긴다 — **체크포인트가 겹포장돼 복원이 알리지 않고 죽던 자리.**\n *\n * `TwinEngine.snapshot()` 은 라이브에서는 상태를, 시뮬에서는 `runtime.resync()` 봉투(`{revision,state}`)를\n * 돌려준다. 그 봉투를 다시 `{revision, state}` 로 감싸 캐시에 넣었으므로, 꺼낸 `state` 는 축이 하나도\n * 없는 껍데기였다 → `planWarmStart` 가 \"심을 것이 없다\" 로 판정하고 **알리지 않고** 넘어갔다. 저널에 수천 건이\n * 있고 캐시도 최신인데 트윈이 빈 채로 떴다(오류도 로그도 없다).\n *\n * 반환 모양을 통일하는 것이 뿌리 수정이지만, 그 값은 State 구독 페이로드로도 나가므로 클라이언트 계약을\n * 건드린다. 그래서 **복원 경로에서만** 벗긴다. 겹겹이 싸여 있어도 벗긴다(과거에 저장된 값이 남아 있다).\n */\nexport function unwrapState(x: any, depth = 4): any {\n  if (!x || typeof x !== 'object') return x\n  if (looksLikeState(x)) return x\n  if (depth > 0 && x.state && typeof x.state === 'object') return unwrapState(x.state, depth - 1)\n  return x\n}\n\nconst arr = (v: unknown[] | undefined): unknown[] => (Array.isArray(v) ? v : [])\n\n/** 원값이 있는 오더인가 — 커널 `hydrateObserved` 의 판정(`requested !== undefined`)과 같은 기준. */\nconst hasDemand = (o: unknown): boolean =>\n  !!o && typeof o === 'object' && (o as { requested?: unknown }).requested !== undefined\n\n/**\n * 무엇을 할지 정한다.\n *\n * 오더·작업·사람·자산도 함께 주입한다. 골라내는 규칙은 커널이 들고 있고(이행 완료 오더, 고아 작업),\n * 여기서는 **심을 수 없는 오더의 수만 센다** — 호출부가 그 사실을 말할 수 있어야 하기 때문이다.\n */\nexport function planWarmStart(state: ObservedState | null | undefined, purpose: string | undefined, canHydrate: boolean): WarmStartPlan {\n  /* 벤치 판정이 먼저다 — 상태가 있든 없든 벤치에는 주입하지 않는다는 사실이 바뀌지 않는다. */\n  if (purpose === 'bench') return { action: 'skip', reason: 'bench' }\n  if (!state) return { action: 'skip', reason: 'no-state' }\n  /* 봉투가 들어오면 스스로 벗는다 — 호출부가 한 곳이라도 잊으면 그 경로가 알리지 않고 죽는다(실제로 그랬다). */\n  state = unwrapState(state)\n\n  const locations = arr(state.locations)\n  const items = arr(state.items)\n  const equipment = arr(state.equipment)\n  const persons = arr(state.persons)\n  const assets = arr(state.assets)\n  const tasks = arr(state.tasks)\n  const orders = arr(state.orders)\n  /* 확인 처리는 문자열 id 목록이다 — 배열이 아니면 없는 것으로 본다(지어내지 않는다). */\n  const acked = Array.isArray(state.acked) ? state.acked.filter((x): x is string => typeof x === 'string') : []\n  /* 시작 시각은 {id, since} 쌍 목록이다 — 모양이 아니면 없는 것으로 본다(지어낸 시각을 심으면 화면이\n     「세 시간째」라고 거짓을 말한다. 모르면 그 신호는 이어붙는 순간이 새 시작이다). */\n  const attentionSince = Array.isArray(state.attentionSince)\n    ? state.attentionSince.filter((x: any): x is { id: string; since: string } => !!x && typeof x.id === 'string' && typeof x.since === 'string')\n    : []\n\n  /*\n   * Folded orders (ADR-0092) — their counts are the only record of the finished orders taken out of the hot\n   * list; nothing re-sends them. The seed used to leave them out, so a restart lost every folded count.\n   * Carried as the kernel wrote them; a value without a `counts` object is not a folded side.\n   */\n  const f: any = (state as any).foldedOrders\n  const foldedOrders = f && typeof f === 'object' && f.counts && typeof f.counts === 'object' ? f : undefined\n\n  /* 어느 축도 없으면 심을 것이 없다 — 빈 주입으로 로그만 남기지 않는다. */\n  if (!locations.length && !items.length && !equipment.length && !persons.length && !assets.length && !tasks.length && !orders.length && !foldedOrders && !acked.length && !attentionSince.length) {\n    return { action: 'skip', reason: 'no-state' }\n  }\n\n  /* 지원 여부는 마지막에 본다 — 주입할 것이 있는데 주입하지 못하는 상황이라야 경고할 가치가 있다. */\n  if (!canHydrate) return { action: 'skip', reason: 'unsupported' }\n\n  const seedable = orders.filter(hasDemand)\n\n  return {\n    action: 'hydrate',\n    seed: {\n      locations,\n      items,\n      equipment,\n      ...(persons.length ? { persons } : {}),\n      ...(assets.length ? { assets } : {}),\n      ...(tasks.length ? { tasks } : {}),\n      /* 원값 없는 오더는 넘기지 않는다 — 커널도 걸러 내지만, 넘기지 않으면 세어 둔 수와 어긋날 일이 없다. */\n      ...(seedable.length ? { orders: seedable } : {}),\n      ...(foldedOrders ? { foldedOrders } : {}),\n      /* 확인 처리는 조건이 사라진 id 가 섞여 있어도 해롭지 않다 — 그 신호가 없으면 표시할 대상이 없다. */\n      ...(acked.length ? { acked } : {}),\n      /* 조건이 사라진 id 가 섞여 있어도 해롭지 않다 — 커널이 그 신호가 없으면 함께 지운다. */\n      ...(attentionSince.length ? { attentionSince } : {})\n    },\n    itemCount: items.length,\n    equipmentCount: equipment.length,\n    personCount: persons.length,\n    assetCount: assets.length,\n    taskCount: tasks.length,\n    orderCount: seedable.length,\n    foldedOrderCount: foldedOrders ? foldedTotal(foldedOrders) : 0,\n    ordersWithoutDemand: orders.length - seedable.length,\n    ackedCount: acked.length,\n    attentionSinceCount: attentionSince.length\n  }\n}\n\n/*\n * ── 미러(관측 구동) 재기동의 연속성 ─────────────────────────────────────────\n *\n * 미러의 진실은 원천이다. 그래서 재고·위치·설비 상태는 심지 않는다 — 다음 계측·다음 마스터 재읽기가\n * 곧 정정하므로, 심으면 **떠난 물건이 되살아나는** 위험만 남는다(그래서 `startLive` 는 오랫동안 아무것도\n * 심지 않았다).\n *\n * 그런데 원천이 **애초에 다시 말해 주지 않는 축**이 있다. 우리가 계산해 만든 것들이다:\n *  · 확인(ack)·조건이 처음 성립한 시각 — 사람이 한 일과 우리가 기억한 시각\n *  · 에너지의 열린 구간 누적·적산 기준점·관측 이후 최대 — SCADA 는 「이번 15분에 지금까지 얼마」를 모른다\n *\n * 잃으면 **오류 없이 값이 작아진다**(실측 2026-08-18: 재기동 뒤 그 구간의 전력량·피크가 작아지고, 세\n * 시간째 지속된 경보가 「0초째」가 됐다). 그래서 축을 갈라 되풀어 주지 않는 것만 이어받는다.\n *\n * 무엇을 이어받을지는 여기서 고르고, **어떻게 흡수할지는 커널이 정한다**(`hydrateContinuity`) — 도메인\n * 규칙이 호스트로 새면 트윈마다 다른 답이 된다.\n */\nexport interface ContinuitySeed {\n  acked?: string[]\n  attentionSince?: { id: string; since: string }[]\n  energy?: unknown\n}\n\nexport interface ContinuityPlan {\n  seed: ContinuitySeed\n  /** 무엇을 이어받았나 — 로그와 시험이 같은 숫자를 본다(0 이면 이어받을 것이 없었다는 사실이다). */\n  ackedCount: number\n  attentionSinceCount: number\n  /** 에너지 연속성을 이어받았나 — 열린 구간이 있으면 그 구간의 요금 근거가 살아난다. */\n  energy: boolean\n}\n\n/** 미러가 이어받을 축만 골라낸다 — 관측 축(재고·위치·설비)은 일부러 넣지 않는다. */\nexport function planLiveContinuity(raw: unknown): ContinuityPlan {\n  const state = raw ? (unwrapState(raw as any) as any) : undefined\n  const acked = Array.isArray(state?.acked) ? state.acked.filter((x: any): x is string => typeof x === 'string') : []\n  const attentionSince = Array.isArray(state?.attentionSince)\n    ? state.attentionSince.filter((x: any): x is { id: string; since: string } => !!x && typeof x.id === 'string' && typeof x.since === 'string')\n    : []\n  /* 에너지는 커널이 자기 모양을 안다 — 호스트는 「있나」만 본다(골라 담으면 규칙이 두 곳으로 갈린다). */\n  const energy = state?.energy && typeof state.energy === 'object' ? state.energy : undefined\n  return {\n    seed: {\n      ...(acked.length ? { acked } : {}),\n      ...(attentionSince.length ? { attentionSince } : {}),\n      ...(energy ? { energy } : {})\n    },\n    ackedCount: acked.length,\n    attentionSinceCount: attentionSince.length,\n    energy: !!energy\n  }\n}\n"]}
+{"version":3,"file":"warm-start.js","sourceRoot":"","sources":["../../server/engine/warm-start.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * 웜스타트 판정 — **순수**. \"기동하는 커널에 직전 상태를 주입할 것인가, 주입한다면 무엇을\" 만 정한다.\n * 실제 주입(hydrateObserved 호출)과 로그는 엔진이 한다.\n *\n * ── 왜 떼어냈나 ─────────────────────────────────────────────────────────────\n * 이 판정이 틀리면 증상이 정반대 두 방향으로 나온다: 주입해야 할 때 안 주입하면 **있는 재고가 0 으로**\n * 보이고(2026-07-31 hatiolab-wms: 저널에 입고 540·출고 94 인데 재고 화면이 비어 있었다), 심지\n * 말아야 할 벤치에 주입하면 **용량 측정이 오염된다.** 둘 다 알리지 않고 틀리는 종류라 규칙을 고정한다.\n *\n * ── 오더를 버리던 전제가 낡았다 (2026-08-05) ────────────────────────────────\n * 예전 주석은 \"스냅샷의 오더에는 progress 밖에 없어서 역산하면 없는 숫자를 지어내는 셈이므로\n * 넘기지 않는다\" 였다. 그때는 맞았다. 그러나 커널 `OrderState` 가 **원값을 되찾은 뒤**\n * (`requested`·`fulfilled`·`lines`) 이 판정만 그대로 남아, 재기동하면 재고는 맞는데 **진행 중\n * 주문이 통째로 사라진** 화면이 나왔다. 오류는 나지 않는다 — 그래서 오래 남아 있었다.\n *\n * 두 스냅샷 생산 경로가 모두 원값을 담는다: 시뮬은 커널 `snapshot()`, 라이브(미러)는\n * `StateProjector` 다. 사람·자산·작업도 같은 스냅샷에 있고 커널이 심을 수 있는데 넘기지 않고 있었다.\n * 그래서 씨앗을 **관측 스냅샷 전체**로 넓힌다.\n *\n * 다만 넓히면서 **들어온 것이 없는 누락을 만들지 않는다.** 원값이 없는 오더는 커널이 걸러 내므로(지어내지\n * 않는다), 그 수를 여기서 세어 호출부가 말할 수 있게 한다. 세지 않으면 \"주문이 없다\" 와 \"주문을\n * 못 심었다\" 가 화면에서 같아진다.\n */\n\n/**\n * 커널에 심을 관측 상태 — 구조가 아니라 \"무엇이 어디에 얼마나\".\n *\n * 커널 `hydrateObserved` 가 받는 스냅샷 모양을 그대로 따른다. 여기서 골라 담지 않는 이유: 무엇을\n * 심을 수 있는지는 커널이 알고, 그 규칙(고아 작업 제외·이행 완료 오더 제외 등)도 커널에 있다.\n * 호스트가 미리 골라내면 규칙이 두 곳으로 갈린다.\n */\nexport interface ObservedSeed {\n  locations: unknown[]\n  items: unknown[]\n  equipment: unknown[]\n  persons?: unknown[]\n  assets?: unknown[]\n  tasks?: unknown[]\n  orders?: unknown[]\n  /** 확인해 둔 주목 신호 id — 상태에서 파생되지 않아 반드시 함께 넘긴다. */\n  acked?: string[]\n  /**\n   * 주목 신호가 **처음 성립한 시각** — 확인과 같은 성질이다(계산으로 되살릴 수 없다).\n   *\n   * 넘기지 않으면 재기동 뒤 세 시간째 지속된 조건이 「0초째」로 되살아난다. 방금 찬 자리와 세 시간째\n   * 막힌 자리는 할 일이 다르므로, 그 값이 거짓이면 화면이 사람을 잘못된 순서로 움직인다.\n   */\n  attentionSince?: { id: string; since: string }[]\n}\n\n/** 심은 것의 내역 — 로그와 테스트가 같은 숫자를 본다. */\nexport interface WarmStartCounts {\n  itemCount: number\n  equipmentCount: number\n  personCount: number\n  assetCount: number\n  taskCount: number\n  /** 원값(requested)이 있어 커널이 실제로 심을 수 있는 오더. */\n  orderCount: number\n  /** 이어받은 확인 처리 수 — 잃으면 확인해 둔 신호가 다시 빨개진다. */\n  ackedCount: number\n  /** 이어받은 시작 시각 수 — 잃으면 지속된 조건이 모두 「방금」이 된다. */\n  attentionSinceCount: number\n  /**\n   * 원값이 없어 심지 못하는 오더 — **0 이 아니면 반드시 말한다.**\n   * progress 만 있는 오더는 남은 수량을 알 수 없어 재계획의 근거가 되지 못한다. 지어내지 않고 뺀다.\n   */\n  ordersWithoutDemand: number\n  /** Finished orders carried folded (ADR-0092) — 0 when the twin had folded nothing. */\n  foldedOrderCount: number\n}\n\nexport type WarmStartPlan =\n  | ({ action: 'hydrate'; seed: ObservedSeed } & WarmStartCounts)\n  /** 벤치 트윈 — 새 시작에서 용량을 재는 게 목적이라 현재 상태를 주입하면 측정이 오염된다. */\n  | { action: 'skip'; reason: 'bench' }\n  /** 심을 상태가 없다 — 처음 만든 트윈이거나 저널·체크포인트가 비었다. 정상이다. */\n  | { action: 'skip'; reason: 'no-state' }\n  /** 커널이 관측 주입을 지원하지 않는다 — 구조만으로 시작하므로 보유량은 0 으로 읽힌다(알려야 한다). */\n  | { action: 'skip'; reason: 'unsupported' }\n\n/** 스냅샷이 들고 올 수 있는 관측 축 — 어느 것이든 있으면 주입할 가치가 있다. */\ninterface ObservedState {\n  locations?: unknown[]\n  items?: unknown[]\n  equipment?: unknown[]\n  persons?: unknown[]\n  assets?: unknown[]\n  tasks?: unknown[]\n  orders?: unknown[]\n  foldedOrders?: unknown\n  acked?: string[]\n  attentionSince?: { id: string; since: string }[]\n}\n\nfunction foldedTotal(f: { counts: Record<string, Record<string, number>> }): number {\n  let n = 0\n  for (const byStatus of Object.values(f.counts)) for (const c of Object.values(byStatus ?? {})) n += Number(c) || 0\n  return n\n}\n\n/** 관측 상태가 실려 있는지 — 축 하나라도 있으면 상태다(봉투에는 없다). */\nconst looksLikeState = (x: any): boolean =>\n  !!x && typeof x === 'object' && ['locations', 'items', 'equipment', 'orders', 'tasks', 'persons', 'assets', 'acked'].some(k => k in x)\n\n/**\n * 봉투를 벗긴다 — **체크포인트가 겹포장돼 복원이 알리지 않고 죽던 자리.**\n *\n * `TwinEngine.snapshot()` 은 라이브에서는 상태를, 시뮬에서는 `runtime.resync()` 봉투(`{revision,state}`)를\n * 돌려준다. 그 봉투를 다시 `{revision, state}` 로 감싸 캐시에 넣었으므로, 꺼낸 `state` 는 축이 하나도\n * 없는 껍데기였다 → `planWarmStart` 가 \"심을 것이 없다\" 로 판정하고 **알리지 않고** 넘어갔다. 저널에 수천 건이\n * 있고 캐시도 최신인데 트윈이 빈 채로 떴다(오류도 로그도 없다).\n *\n * 반환 모양을 통일하는 것이 뿌리 수정이지만, 그 값은 State 구독 페이로드로도 나가므로 클라이언트 계약을\n * 건드린다. 그래서 **복원 경로에서만** 벗긴다. 겹겹이 싸여 있어도 벗긴다(과거에 저장된 값이 남아 있다).\n */\nexport function unwrapState(x: any, depth = 4): any {\n  if (!x || typeof x !== 'object') return x\n  if (looksLikeState(x)) return x\n  if (depth > 0 && x.state && typeof x.state === 'object') return unwrapState(x.state, depth - 1)\n  return x\n}\n\nconst arr = (v: unknown[] | undefined): unknown[] => (Array.isArray(v) ? v : [])\n\n/** 원값이 있는 오더인가 — 커널 `hydrateObserved` 의 판정(`requested !== undefined`)과 같은 기준. */\nconst hasDemand = (o: unknown): boolean =>\n  !!o && typeof o === 'object' && (o as { requested?: unknown }).requested !== undefined\n\n/**\n * 무엇을 할지 정한다.\n *\n * 오더·작업·사람·자산도 함께 주입한다. 골라내는 규칙은 커널이 들고 있고(이행 완료 오더, 고아 작업),\n * 여기서는 **심을 수 없는 오더의 수만 센다** — 호출부가 그 사실을 말할 수 있어야 하기 때문이다.\n */\nexport function planWarmStart(state: ObservedState | null | undefined, purpose: string | undefined, canHydrate: boolean): WarmStartPlan {\n  /* 벤치 판정이 먼저다 — 상태가 있든 없든 벤치에는 주입하지 않는다는 사실이 바뀌지 않는다. */\n  if (purpose === 'bench') return { action: 'skip', reason: 'bench' }\n  if (!state) return { action: 'skip', reason: 'no-state' }\n  /* 봉투가 들어오면 스스로 벗는다 — 호출부가 한 곳이라도 잊으면 그 경로가 알리지 않고 죽는다(실제로 그랬다). */\n  state = unwrapState(state)\n\n  const locations = arr(state.locations)\n  const items = arr(state.items)\n  const equipment = arr(state.equipment)\n  const persons = arr(state.persons)\n  const assets = arr(state.assets)\n  const tasks = arr(state.tasks)\n  const orders = arr(state.orders)\n  /* 확인 처리는 문자열 id 목록이다 — 배열이 아니면 없는 것으로 본다(지어내지 않는다). */\n  const acked = Array.isArray(state.acked) ? state.acked.filter((x): x is string => typeof x === 'string') : []\n  /* 시작 시각은 {id, since} 쌍 목록이다 — 모양이 아니면 없는 것으로 본다(지어낸 시각을 심으면 화면이\n     「세 시간째」라고 거짓을 말한다. 모르면 그 신호는 이어붙는 순간이 새 시작이다). */\n  const attentionSince = Array.isArray(state.attentionSince)\n    ? state.attentionSince.filter((x: any): x is { id: string; since: string } => !!x && typeof x.id === 'string' && typeof x.since === 'string')\n    : []\n\n  /*\n   * Folded orders (ADR-0092) — their counts are the only record of the finished orders taken out of the hot\n   * list; nothing re-sends them. The seed used to leave them out, so a restart lost every folded count.\n   * Carried as the kernel wrote them; a value without a `counts` object is not a folded side.\n   */\n  const f: any = (state as any).foldedOrders\n  const foldedOrders = f && typeof f === 'object' && f.counts && typeof f.counts === 'object' ? f : undefined\n\n  /* 어느 축도 없으면 심을 것이 없다 — 빈 주입으로 로그만 남기지 않는다. */\n  if (!locations.length && !items.length && !equipment.length && !persons.length && !assets.length && !tasks.length && !orders.length && !foldedOrders && !acked.length && !attentionSince.length) {\n    return { action: 'skip', reason: 'no-state' }\n  }\n\n  /* 지원 여부는 마지막에 본다 — 주입할 것이 있는데 주입하지 못하는 상황이라야 경고할 가치가 있다. */\n  if (!canHydrate) return { action: 'skip', reason: 'unsupported' }\n\n  const seedable = orders.filter(hasDemand)\n\n  return {\n    action: 'hydrate',\n    seed: {\n      locations,\n      items,\n      equipment,\n      ...(persons.length ? { persons } : {}),\n      ...(assets.length ? { assets } : {}),\n      ...(tasks.length ? { tasks } : {}),\n      /* 원값 없는 오더는 넘기지 않는다 — 커널도 걸러 내지만, 넘기지 않으면 세어 둔 수와 어긋날 일이 없다. */\n      ...(seedable.length ? { orders: seedable } : {}),\n      ...(foldedOrders ? { foldedOrders } : {}),\n      /* 확인 처리는 조건이 사라진 id 가 섞여 있어도 해롭지 않다 — 그 신호가 없으면 표시할 대상이 없다. */\n      ...(acked.length ? { acked } : {}),\n      /* 조건이 사라진 id 가 섞여 있어도 해롭지 않다 — 커널이 그 신호가 없으면 함께 지운다. */\n      ...(attentionSince.length ? { attentionSince } : {})\n    },\n    itemCount: items.length,\n    equipmentCount: equipment.length,\n    personCount: persons.length,\n    assetCount: assets.length,\n    taskCount: tasks.length,\n    orderCount: seedable.length,\n    foldedOrderCount: foldedOrders ? foldedTotal(foldedOrders) : 0,\n    ordersWithoutDemand: orders.length - seedable.length,\n    ackedCount: acked.length,\n    attentionSinceCount: attentionSince.length\n  }\n}\n\n/*\n * ── 미러(관측 구동) 재기동의 연속성 ─────────────────────────────────────────\n *\n * 미러의 진실은 원천이다. 그래서 재고·위치·설비 상태는 심지 않는다 — 다음 계측·다음 마스터 재읽기가\n * 곧 정정하므로, 심으면 **떠난 물건이 되살아나는** 위험만 남는다(그래서 `startLive` 는 오랫동안 아무것도\n * 심지 않았다).\n *\n * 그런데 원천이 **애초에 다시 말해 주지 않는 축**이 있다. 우리가 계산해 만든 것들이다:\n *  · 확인(ack)·조건이 처음 성립한 시각 — 사람이 한 일과 우리가 기억한 시각\n *  · 에너지의 열린 구간 누적·적산 기준점·관측 이후 최대 — SCADA 는 「이번 15분에 지금까지 얼마」를 모른다\n *\n * 잃으면 **오류 없이 값이 작아진다**(실측 2026-08-18: 재기동 뒤 그 구간의 전력량·피크가 작아지고, 세\n * 시간째 지속된 경보가 「0초째」가 됐다). 그래서 축을 갈라 되풀어 주지 않는 것만 이어받는다.\n *\n * 무엇을 이어받을지는 여기서 고르고, **어떻게 흡수할지는 커널이 정한다**(`hydrateContinuity`) — 도메인\n * 규칙이 호스트로 새면 트윈마다 다른 답이 된다.\n */\nexport interface ContinuitySeed {\n  acked?: string[]\n  attentionSince?: { id: string; since: string }[]\n  energy?: unknown\n  /** 접힌 오더(ADR-0092) — 모양은 커널이 안다(호스트는 있나만 본다). */\n  foldedOrders?: unknown\n}\n\nexport interface ContinuityPlan {\n  seed: ContinuitySeed\n  /** 무엇을 이어받았나 — 로그와 시험이 같은 숫자를 본다(0 이면 이어받을 것이 없었다는 사실이다). */\n  ackedCount: number\n  attentionSinceCount: number\n  /** 에너지 연속성을 이어받았나 — 열린 구간이 있으면 그 구간의 요금 근거가 살아난다. */\n  energy: boolean\n  /** 접힌 오더를 이어받았나(ADR-0092). */\n  foldedOrders: boolean\n}\n\n/** 미러가 이어받을 축만 골라낸다 — 관측 축(재고·위치·설비)은 일부러 넣지 않는다. */\nexport function planLiveContinuity(raw: unknown): ContinuityPlan {\n  const state = raw ? (unwrapState(raw as any) as any) : undefined\n  const acked = Array.isArray(state?.acked) ? state.acked.filter((x: any): x is string => typeof x === 'string') : []\n  const attentionSince = Array.isArray(state?.attentionSince)\n    ? state.attentionSince.filter((x: any): x is { id: string; since: string } => !!x && typeof x.id === 'string' && typeof x.since === 'string')\n    : []\n  /* 에너지는 커널이 자기 모양을 안다 — 호스트는 「있나」만 본다(골라 담으면 규칙이 두 곳으로 갈린다). */\n  const energy = state?.energy && typeof state.energy === 'object' ? state.energy : undefined\n  /* 접힌 오더(ADR-0092) — 원천을 다시 읽는 미러도 세는 수와 경계를 잃지 않게(없으면 옛 종결이 뜨거운 줄로 되살아난다). */\n  const foldedOrders = state?.foldedOrders && typeof state.foldedOrders === 'object' ? state.foldedOrders : undefined\n  return {\n    seed: {\n      ...(acked.length ? { acked } : {}),\n      ...(attentionSince.length ? { attentionSince } : {}),\n      ...(energy ? { energy } : {}),\n      ...(foldedOrders ? { foldedOrders } : {})\n    },\n    ackedCount: acked.length,\n    attentionSinceCount: attentionSince.length,\n    energy: !!energy,\n    foldedOrders: !!foldedOrders\n  }\n}\n"]}

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

@@ -6,6 +6,11 @@ export interface RefLocation {
     description?: string;
     role: 'location' | 'area' | 'both';
     parentId?: string;
+    /**
+     * **이 자리를 정의하는 영역**(`wms` · `mes` …) — 기준정보가 말한 그대로. 이 트윈의 렌즈(`ReferenceMaster.system`)와 다르면
+     * 그 자리는 참조로만 든다(ADR-0081 보탬). 말하지 않은 자리는 이 렌즈의 자리다.
+     */
+    system?: string;
     /**
      * **전기적으로 어디서 받는가** — 이 자리에 전기를 주는 상류 자리(커널 계약의 `upstreamId`).
      *

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 * 마스터를 읽어 트윈 구조(TwinModelDef) + 공간(Space content)을 생성. 손배선이 아니라 인제스트로 엔티티가 흐른다.\n *\n * 규율(ADR-0018): 도메인 타입(location.type=노드용)은 커널 카탈로그 어휘를 그대로 반영(발명 금지).\n * location 은 role 로 노드(운영점)·area(공간영역)·both 를 구분 — 노드→TwinModelDef, area→Space.areas.\n * 좌표·representations 는 트윈 공간층(보완/추가). 실 시스템이 좌표를 안 주면 layout 없이 위상만 인제스트.\n */\n\nimport type { DomainSystem, EquipmentLevel, TestSpecificationCriterion, WorkCalendarEntry } from '@operato/ops-contract'\n\nexport interface RefLocation {\n  id: string\n  type: string // 노드는 커널 노드타입(dock/storage/yard-slot…), area 는 공간 region 타입\n  name?: string\n  description?: string\n  role: 'location' | 'area' | 'both'\n  parentId?: string\n  /**\n   * **전기적으로 어디서 받는가** — 이 자리에 전기를 주는 상류 자리(커널 계약의 `upstreamId`).\n   *\n   * `parentId`(공간 포함)와 따로 두는 이유는 커널 계약에 적혀 있다. 여기서 빠뜨리면 마스터가 말한 계통이\n   * 모델까지 오지 못하고, 뿌리 계량 판정이 분기 계량기까지 뿌리로 세어 **부하가 두 배로** 보인다.\n   */\n  upstreamId?: 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  /**\n   * 자리의 **열린 속성** — 표준 `OperationalLocationProperty`(설비·사람·자산과 같은 모양).\n   *\n   * 무엇이 여기 실리나: **자리의 물리량**이다. 에너지의 계약전력(`contract.kW`)이 첫 사례다 —\n   * 그 값이 앉을 자리가 없어서 EMS 커널은 계약 대비 판정을 할 수 없었다(자리가 없으면 사실이\n   * 들어오지 못한다). 커널은 자기가 **읽는** 속성 id 만 선언하고(`EMS_PROPERTY`) 나머지는 나른다.\n   */\n  properties?: RefResourceProperty[]\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\n/**\n * 검사 명세 — **자원이 가리키는 대상**(ISA-95 `TestSpecification`).\n *\n * 표준 필드는 셋만 담는다(`ID`·`Description`·`Version`) — 재는 속성과 합격 기준은 아직 1차 출처와\n * 대조하지 않았다(커널 계약의 머리말이 그 사실을 적어 두었다).\n */\n/**\n * 시험 결과 — **\"이 개체가 그 시험을 통과했다\"** 는 기록(ISA-95 결과).\n *\n * 결과를 낳는 곳은 트윈이 아니다(인사·정비 시스템이 기록한다) — 그래서 관측이면서 **선언 경로로** 온다.\n * 커널은 이 값이 있을 때만 자격을 판정한다: 없으면 제약이 아니고(라인이 굶지 않는다), 있으면 만료·\n * 불합격이 배정을 막는다.\n */\nexport interface RefTestResult {\n  specId: string\n  result: 'pass' | 'fail'\n  at?: string\n  /** 없으면 무기한 — 짐작으로 기한을 만들면 멀쩡한 자격자가 오류 없이 사라진다. */\n  expiresAt?: string\n}\n\nexport interface RefTestSpecification {\n  id: string\n  /** 표시명 — i18n 키일 수 있다. 읽는 어휘를 하나로 맞추려고 인제스트가 `name` 으로 옮긴다. */\n  description?: string\n  version?: string\n  /**\n   * 판정 기준들 — 커널 계약의 `TestSpecification.criteria` 를 그대로 나른다.\n   *\n   * **경계에서 어휘를 갈지 않는다.** 커널 타입을 그대로 쓰므로 `limit.{minimum,maximum,uom}` ·\n   * `expression` · `evaluatedPropertyId` 가 원본에서 커널까지 한 이름으로 간다.\n   *\n   * 선언하지 않아도 명세는 성립한다(이름만으로 「무엇으로 검증했나」에 답한다). 선언하면 **판정에\n   * 근거가 있는지**를 물을 수 있게 된다 — 커널의 `criterionSaysNothing` 이 그것을 센다.\n   */\n  criteria?: TestSpecificationCriterion[]\n}\n\nexport interface RefEquipment {\n  id: string\n  kind: string\n  /**\n   * 속한 **등급들** — 계약 선언의 `equipment[].equipmentClassIds` 로 그대로 간다.\n   *\n   * ── 왜 빠져 있었나 (2026-09-04) ─────────────────────────────────────────\n   * 커널에 이 축을 여는 날 모델·상태·저널·미러까지 배선했는데 **접수면이 빠졌다.** 사람과 자산은\n   * 받는데(`personnelClassIds`·`assetClassIds`) 설비만 없었다.\n   *\n   * 그래서 원본이 설비 22대에 등급을 다 채워 보냈는데 **문턱에서 버려졌다** — 거절도 경고도 없이.\n   * 등급 목록은 서고 소속은 아무도 없어서, 화면에서 등급을 골라도 설비가 안 나왔다.\n   *\n   * 소속은 이 선언과 `kind` 를 합친 것이다(§`equipmentClassMembership`) — 판정하는 쪽이 그 함수를\n   * 지난다.\n   */\n  equipmentClassIds?: string[]\n  /** 사람이 부르는 이름 — 없으면 화면이 id 를 보인다(id 를 이름으로 베끼지 않는다). */\n  name?: string\n  /** 시험 결과 — 자격이 성립하는지는 이것이 말한다(§RefTestResult). */\n  testResults?: RefTestResult[]\n  description?: string\n  homeLocationId: string\n  mtbfMs?: number // 평균 고장 간격(확률적 고장) — 지정 시 커널이 breakdown 시뮬 → 주목(고장) 발생\n  mttrMs?: number // 평균 수리 시간\n  /**\n   * **이 설비의 전역 정체성** — 커널 선언의 `equipment[].identity` 로 그대로 간다.\n   *\n   * 예전 이름은 `gs1Id` 였다. 그런데 **GS1 키가 아닌 것이 정상이다** — 실측한 값은 인버터의\n   * 하드웨어 식별자(`ES100000007d8d061d-1`)이고, 원본이 GIAI 를 주면 그것도 여기 들어온다.\n   * 이름이 한 종류만 가리키면 다른 종류가 들어올 때 그 자리를 못 쓴다.\n   *\n   * 자리(`RefLocation.gs1Id`)는 그대로다 — 그쪽은 실제로 SGLN 이 온다.\n   */\n  identity?: string\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  /** 시험 결과 — 자격이 성립하는지는 이것이 말한다(§RefTestResult). */\n  testResults?: RefTestResult[]\n  /**\n   * **이 사람의 전역 정체성** — 커널 선언의 `personnel[].identity` 로 간다.\n   *\n   * ── 왜 필요한가 (인티그레이션 레인이 물음, 2026-09-05) ─────────────────────\n   * 설비에서 이 자리를 만든 이유가 사람에게도 그대로 걸린다: **지역 이름은 그 현장 안에서만\n   * 고유하다.** 인버터 `001` 이 두 발전소에 있어서 함께 집계하니 한쪽 발전량이 사라졌다.\n   * `E-1001` 도 다른 공장에 있을 수 있고, 여러 현장을 함께 보는 순간 같은 일이 난다.\n   *\n   * ── **여기에 개인정보를 넣지 않는다** ──────────────────────────────────────\n   * 설비와 사람이 갈리는 자리가 이것이다. 설비의 정체성은 하드웨어 일련번호이고 아무에게도 해가\n   * 없다. 사람의 「전역에서 고유한 값」은 사원번호·출입카드·주민등록처럼 **그 사람에 관한 사실**\n   * 이고, 저널은 되풀이 읽히고 미러로 복제되고 구독으로 방송된다 — 한 번 들어가면 지워지지 않는다.\n   *\n   * 그래서 이 칸이 요구하는 것은 **현장을 앞에 붙여 전역에서 고유해진 이름**이다. 그 이상이 아니다.\n   *\n   * ```\n   * 맞다    urn:hatiolab:mes-line-a:obj:E-1001      (§`objectUri` 가 만든다)\n   *         https://hatiotrailer.com/twin/obj/E-1001\n   * 아니다  카드번호 · 사원번호 원문 · 주민등록번호 · 생체 식별자\n   * ```\n   *\n   * 「이 사람이 누구인가」는 인사 시스템이 답할 물음이고 트윈의 물음이 아니다. 트윈은 **같은\n   * 사람인지 다른 사람인지**만 알면 된다 — 그 일에 개인정보는 필요 없다.\n   *\n   * 값이 없으면 비운다. 지금 원본이 그런 값을 주지 않으므로 당분간 비어 있는 것이 정상이다.\n   */\n  identity?: 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  /** 시험 결과 — 자격이 성립하는지는 이것이 말한다(§RefTestResult). */\n  testResults?: RefTestResult[]\n  /**\n   * 속한 등급들 — 표준 `PhysicalAssetClassID`(복수). 팔레트가 'euro-pallet' 이면서 'food-grade' 일 수 있다.\n   * 공정의 요구는 등급 하나 + 수량이다(표준 `PhysicalAssetSpecification`).\n   */\n  assetClassIds?: string[]\n  /** 기본 위치. */\n  homeLocationId?: string\n  /**\n   * **이 자산의 전역 정체성** — 설비와 같은 이름이다(§`RefEquipment.identity`).\n   *\n   * ── 왜 이름을 바꿨나 (2026-09-04) ───────────────────────────────────────\n   * `gs1Id` 였다. 설비에서 그 이름을 바꾼 이유가 여기에도 그대로 적용된다 — **GS1 키가 아닌 것이\n   * 정상이다.** 자산의 실측 값도 제조번호·사내 관리번호이고, GS1 을 요구하는 이름을 두면 그것을\n   * 채우는 쪽이 없는 키를 지어내거나 칸을 비워 둔다.\n   *\n   * 그리고 마스터는 이미 `identity` 로 낸다(설비·자산 둘 다). 이 자리만 다른 이름이라 **원본이\n   * 채우는 순간 조용히 사라졌다.** 지금 자산 26대가 다 비어 있어 버려지는 값은 없었다 —\n   * 인티그레이션 레인이 그것을 재서 「누가 채우는 순간」이라고 짚었다.\n   *\n   * 자리 쪽(`RefLocation.gs1Id`)은 그대로다 — 거기는 실제로 SGLN 이 온다.\n   */\n  identity?: 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\n/**\n * **이 마스터를 다시 만들 수 있는 방법** — 트윈이 자기 원본을 기억하는 자리.\n *\n * 트윈은 원본을 비출 뿐이므로(ADR-0028), 원본이 달라지면 **다시 읽어야** 합니다. 그런데 지금까지\n * 트윈은 \"내가 무엇에서 나왔나\" 를 남기지 않았다 — 어댑터로 들어온 트윈은 `TwinReference` 행이\n * 있었지만 템플릿으로 세운 트윈에는 아무것도 없었고, 그래서 **다시 읽을 대상이 없는 트윈**이\n * 만들어졌다. 원본을 잃은 트윈은 첫날의 모습에 영원히 머문다.\n *\n * 그래서 원천이 무엇이든 여기 한 자리에 남긴다. 다시 읽기는 이 값 하나만 보면 된다.\n */\nexport type MasterOrigin =\n  /**\n   * 등록된 레퍼런스(어댑터)에서 왔다 — 다시 읽기 = 그 어댑터로 마스터를 다시 가져온다.\n   *\n   * `source` 는 **레퍼런스 등록 이름**이고 그 참조가 보고하는 사이트 전부에 같다. 그래서 어느 사이트에서\n   * 온 트윈인지는 `siteId` 가 있어야 안다 — 없으면 다시 읽기가 사이트를 찾지 못한다(2026-08-18 실측:\n   * 사이트가 여러 개인 참조에서 온 트윈은 재동기가 전부 거절됐다. 참조 이름을 사이트별 마스터의\n   * `source`(=인스턴스 id)와 비교하고 있었다 — 서로 다른 것을 비교한 것이다).\n   */\n  | { kind: 'reference'; source: string; siteId?: string; spaceId?: string }\n  /**\n   * 템플릿 + 노브로 합성했다 — 다시 읽기 = 같은 노브로 다시 짓는다(합성은 결정적이다).\n   *\n   * `spaceId` 는 **만들 때 고른 현장**이다(합쳐 넣기). 기억하지 않으면 다시 읽을 때 트윈이 알리지 않고 자기\n   * 현장을 떠난다 — 템플릿이 낸 기본 공간으로 돌아가기 때문이다. 그러면 그 현장의 값(요금 등)도 함께\n   * 잃는다(2026-08-18 실측: 한 현장에 합쳐 둔 EMS 트윈 여덟이 재동기 뒤 각자 공간으로 흩어졌다).\n   */\n  | { kind: 'template'; templateId: string; params: Record<string, unknown>; spaceId?: string }\n\nexport interface ReferenceMaster {\n  source: string\n  /**\n   * 어느 종류의 트윈인가 — **커널 카탈로그가 정본**이다(`DomainSystem`).\n   *\n   * 예전에는 `'wms' | 'yms' | 'mes'` 를 여기 적어 뒀다. 커널에 종류가 하나 늘 때(에너지) 이 줄이\n   * 함께 움직여야 하는데, 손으로 적힌 목록은 그것을 알려 주지 않는다 — 어휘의 집은 한 곳이어야 한다.\n   */\n  system: DomainSystem\n  siteName: string\n  /** 검사 명세 — 자원·등급의 `testSpecificationIds` 가 가리키는 대상. */\n  testSpecifications?: RefTestSpecification[]\n  /**\n   * 이 마스터가 어디서 나왔나 — **다시 읽기의 유일한 근거.** 없으면 그 트윈은 다시 읽을 수 없고,\n   * 조회 화면이 그 사실을 그대로 말한다(없는 것을 있는 척하지 않는다).\n   */\n  origin?: MasterOrigin\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   * 생산 선언 — `TwinModelDef.productionSpec` 으로 통과한다(ISA-95 OperationsSegment + BOM).\n   *\n   * 예전 이름은 `mesSpec` 이었다. 담긴 것은 MES 만의 것이 아니라 \"자재를 소비해 자재를 산출하는\n   * 공정\" 이고, 이름이 MES 였기 때문에 창고 트윈은 이 자리를 쓸 생각조차 하지 못했다(유통가공 창고가\n   * BOM 을 설명 문서에만 적어 둔 채 키트를 못 만드는 트윈을 만든 원인). 근거는 커널 계약 주석에.\n   */\n  productionSpec?: unknown\n  /**\n   * **이 원본이 식별자를 만드는 이름공간** — `TwinModelDef.identity` 로 통과한다.\n   *\n   * **선언이 없으면 커널이 거절한다** (0.7.45~). 예전에는 상수 프리픽스로 팔레트·트레일러·문서를\n   * 만들었는데(`0614141` — GS1 이 규격 예제로 쓰다 버린 값이고 `06…` 은 실 배정 대역이다), 그 값은\n   * 저널에 영원히 남으면서 지어낸 것이라고 말해 주는 데가 없었다. 그래서 커널이 만들지 않는다.\n   *\n   * 원본이 자기 도메인을 말하면 그 아래에서 만든다 — 그것이 표준 정합이다(CBV 2.0 §8.2.4·§8.5.5,\n   * 「그 인터넷 도메인 소유자가 배정한다」). GS1 키를 쓰려면 `documentTypes` + `companyPrefix` 이고,\n   * 그때 **자리 수가 맞아야 한다**(SGTIN 은 프리픽스 + 품목참조 = 13자리, GS1 TDS).\n   *\n   * 정체성은 생산과 무관하므로 `productionSpec` 이 아니라 **모델**이 갖는다 — 창고·야드는 아무것도\n   * 생산하지 않으면서 팔레트·트레일러를 식별한다.\n   */\n  identity?: 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   * 커넥터가 **옮기는 동안 알게 된 것.** 외부 시스템의 값을 우리 어휘로 못 옮겨 기본값을 넣었다면\n   * 여기에 담아 보낸다 — 그러면 `masterToTwin` 의 경고와 한 줄기로 합쳐져 화면까지 간다.\n   *\n   * 이 자리가 없던 동안 커넥터는 할 말이 있어도 **말할 곳이 없었다.** 그래서 도크를 랙으로 바꿔\n   * 놓고도 알리지 않고 성공했다. 옮기는 사람만 아는 사실은 옮기는 자리에서 실어야 한다.\n   */\n  warnings?: IngestWarning[]\n  /**\n   * **원본이 가진 수** — 옮긴 수의 분모다.\n   *\n   * 총평은 도착한 모델만 볼 수 있어서 「레시피 1,261」까지만 말할 수 있었다. 그런데 사람이 묻는 것은\n   * 「그게 전부인가」다 — 원본에 1,408개가 있었고 147개를 옮기지 못했다면 그 사실이 총평의 첫 줄에\n   * 있어야 한다. 실제로 사용자가 품목 2,789 와 자재 1,789 의 차이를 화면에서 읽어 내지 못해 직접\n   * 물었다(2026-08-22).\n   *\n   * 분모를 아는 것은 **커넥터뿐이다.** 그래서 커넥터가 실어 보낸다. 보내지 않으면 총평은 분모 없이\n   * 옮긴 수만 말한다 — **지어내지 않는다.**\n   *\n   * 열쇠는 총평이 세는 이름과 같다(`recipes`·`materials`·`totalInputs`·…). 값은 **원본을 끝까지 읽어서\n   * 센 것**이어야 한다. 잘린 읽기의 수를 여기 담으면 「전부 옮겼다」는 거짓이 된다.\n   */\n  originCounts?: Record<string, number>\n}\n\nexport interface IngestedTwin {\n  model: any // TwinModelDef(+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/**\n * **시각을 모르는 채 시각으로 판정하려 한다** — 발전 형상은 하루의 시각을 읽는데 이 트윈의 공간이\n * 시간대를 말하지 않았다.\n *\n * ── 왜 경고인가 (2026-08-18) ────────────────────────────────────────────────\n * 커널은 시간대를 모르면 UTC 로 읽는다(계약에 밝혀 둔 규율 — 모르는 값을 지어내지 않는다). 그런데 발전\n * 형상은 **시각별 비율**이라, 시간대가 없으면 현장 정오가 아니라 UTC 정오에 피크가 선다(KST 현장이면\n * 밤 9시). 값이 그럴듯하게 나오므로 아무도 알아채지 못한다.\n *\n * 그래서 시간대를 **지어내지 않고**(서버 로컬이나 임의 기본값을 넣으면 그 트윈의 모든 시각 판정이 알리지 않고\n * 그 가정 위에 선다) 대신 **그 조합을 말한다** — 공간에 시간대를 선언하면 사라지는 경고다.\n */\nexport const generationWithoutTimeZone = (spaceId: string, equipmentId: string): IngestWarning => ({\n  code: 'generation-without-time-zone',\n  params: { spaceId, equipmentId },\n  message:\n    `\"${equipmentId}\" declares a daily generation shape but space \"${spaceId}\" declares no time zone — the hourly fractions will be read in UTC, ` +\n    'so the generation peak will not land at local noon. Declare the space time zone (we do not guess one).'\n})\n\n/**\n * 아무도 선언하지 않은 자리 타입 — 그 자리는 흐름에 참여하지 못할 수 있다.\n *\n * **묻는 상대를 고쳤다 (2026-08-20).** 예전에는 내장 카탈로그에게만 물었다. 그런데 원본이 자기\n * `DomainDefinition.locationTypes` 를 함께 보내면 **그 선언이 정본**이다 — 카탈로그는 우리가 아는\n * 도메인들의 기본 어휘일 뿐이다. 물을 상대가 틀렸으니, 자기 어휘를 선언한 원본은 정상적인 타입마다\n * 경고를 받았다(F&B 라인을 붙이면 자리마다 하나씩). 소음이 되면 사람은 경고를 읽지 않게 되고, 그때\n * 진짜 경고도 함께 죽는다.\n */\nexport const unknownLocationType = (system: string, type: string, id: string): IngestWarning => ({\n  code: 'unknown-location-type',\n  params: { system, type, id },\n  /*\n   * ── 무슨 일이 벌어지는지 말한다 (2026-08-25) ────────────────────────────────\n   * 예전 문장은 「흐름에 참여하지 못할 수 있다」였다. 물건이 흐르는 도메인에서는 맞는 말인데,\n   * 에너지 트윈에는 흐름이 없어서 그 문장이 아무것도 알려 주지 않았다(실제로 태양광 발전소를\n   * 붙이면서 이 경고를 받은 사람이 「이 경고가 뜻이 있는가」를 되물었다).\n   *\n   * 종류를 모르면 실제로 일어나는 일은 하나다: **그 자리에 능력이 붙지 않는다.** 능력이 없으면\n   * 상태 필드도 없고, 롤업에도 들어가지 않고, 저작면 팔레트에도 서지 않는다. 도메인을 가리지 않고\n   * 참인 문장이므로 이것을 적는다.\n   */\n  message:\n    `\"${type}\" is declared nowhere for ${system} (${id}) — neither in the master's own locationTypes nor in the built-in ` +\n    `catalog. A location whose type is unknown gets no capabilities, so it carries no state, joins no rollup, ` +\n    `and (in domains that move things) may be left out of the flow.`\n})\n\n/**\n * 원본이 함께 보낸 자리 타입 선언 — 있으면 **이것이 정본**이다.\n *\n * 커널 계약의 `DomainDefinition.locationTypes` 는 `{ key, label, … }` 목록이다. 읽을 수 없는 모양이면\n * `undefined` 를 돌려 **카탈로그로 떨어진다** — 빈 배열을 돌려주면 「아무 타입도 선언되지 않았다」가\n * 되어 모든 자리가 경고를 받는다(없는 것과 못 읽은 것은 다르다).\n */\nexport function declaredLocationTypes(productionSpec: unknown): string[] | undefined {\n  const list = (productionSpec as any)?.definition?.locationTypes\n  if (!Array.isArray(list) || !list.length) return undefined\n  const keys = list.map((t: any) => (typeof t === 'string' ? t : t?.key)).filter((k: any) => typeof k === 'string' && k)\n  return keys.length ? keys : undefined\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/**\n * 구조 투영에서 **가리키는 대상을 못 찾았다.**\n *\n * 예전에는 이런 참조가 model JSON 안의 맨 문자열이라 화면만 경고할 수 있었고, 다른 경로로 들어온\n * 데이터는 아무도 안 봤다. 이제 행으로 풀면서 **인제스트가 직접 안다** — 그러니 인제스트가 말한다.\n * 막지는 않는다(트윈은 model 로 이미 동작한다). 다만 알리지 않고 넘기지 않는다.\n */\nexport const unresolvedReference = (field: string, ref: string): IngestWarning => ({\n  code: 'unresolved-reference',\n  params: { field, ref },\n  message: `${field} points at something that is not in this twin (${ref}) — the link was left empty`\n})\n\n/**\n * 구조 투영 자체가 실패했다 — 조회는 못 하지만 **트윈은 동작한다**(커널은 model 를 이미 받았다).\n * 행은 원본에서 다시 그릴 수 있으므로 인제스트를 실패로 만들지 않되, 침묵하지도 않는다.\n */\nexport const projectionFailed = (reason: string): IngestWarning => ({\n  code: 'projection-failed',\n  params: { reason },\n  message: `structure projection failed (${reason}) — the twin runs, but model inspection will be stale until the next ingest`\n})\n\n/**\n * **동작 중에 공장을 전환했다** — 미러는 멈추지 않으므로, 무엇이 사라졌는지 여기서 말한다.\n *\n * 멈췄다 세우는 구조 전환이라면 사용자가 \"다시 세웠다\" 는 것을 안다. 미러는 그 마디가 없어서\n * 자리 하나·설비 한 대가 알리지 않고 없어질 수 있다 — 자리가 수천인 현장에서 화면의 수를 세어\n * 눈치채기를 기대할 수는 없다. 늘어난 것도 함께 말한다(무엇이 반영되었나가 곧 인제스트의 답이다).\n */\nexport const structureAdopted = (rev: number, shift: { locationsAdded: number; locationsDropped: number; equipmentDropped: number; personsDropped: number; assetsDropped: number }): IngestWarning => ({\n  code: 'structure-adopted',\n  params: { rev, ...shift },\n  message:\n    `the running mirror adopted a new structure (revision ${rev}) — ` +\n    `+${shift.locationsAdded} location(s), -${shift.locationsDropped} location(s), ` +\n    `-${shift.equipmentDropped} equipment, -${shift.personsDropped} person(s), -${shift.assetsDropped} asset(s)`\n})\n\n/**\n * 커넥터가 외부 시스템의 값을 **우리 어휘로 옮기지 못해 기본값을 넣었다.**\n *\n * 예: Oracle WMS 가 우리 표에 없는 `locn_type` 을 주면 그 자리는 `storage` 가 된다 — 도크가 랙으로\n * 모델링되는 것이다. 인제스트를 통째로 실패시킬 일은 아니지만(로케이션 하나 때문에 현장 전체가\n * 안 들어오는 편이 더 나쁘다), **알리지 않고 넘어가면 안 된다.** 트윈이 실물과 다르게 생겼는데\n * 아무도 그 사실을 모른 채 그 위에서 흐름을 논하게 된다.\n *\n * 값을 나열하는 이유: \"3건\" 만으로는 커넥터 매핑에 무엇을 더해야 하는지 알 수 없다.\n */\nexport const connectorMappingFallback = (field: string, fallback: string, values: readonly string[], count: number): IngestWarning => ({\n  code: 'connector-mapping-fallback',\n  params: { field, fallback, values: values.join(', '), count },\n  message: `${count} ${field} value(s) had no mapping and fell back to \"${fallback}\" (${values.join(', ')}) — the twin's shape differs from the source system here`\n})\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\n/**\n * 이 현장의 설비를 노브 값으로 채웠다 — **알리지 않고 채우지 않는다.**\n *\n * 에너지 트윈의 부하를 이웃 설비 id 로 선언할 때 쓴다. 몇 개를 가져왔는지 말해 주지 않으면, 사용자는\n * 자기가 고르지 않은 설비들이 부하로 잡힌 것을 나중에 화면에서야 알게 된다.\n */\nexport const siteEquipmentAdopted = (key: string, count: number): IngestWarning => ({\n  code: 'site-equipment-adopted',\n  params: { key, count },\n  message: `${count} piece(s) of equipment already on this site were adopted as loads (knob \"${key}\") — set their coefficients before trusting the numbers`\n})\n\nexport function masterToTwin(master: ReferenceMaster, catalog?: any): IngestedTwin {\n  /* 커넥터가 옮기며 알게 된 것을 먼저 싣는다 — 원인이 앞에 오는 편이 읽기 쉽다(대체가 먼저, 그 결과가 뒤). */\n  const warnings: IngestWarning[] = [...(master.warnings ?? [])]\n  /*\n   * 원본이 자기 어휘를 선언했으면 **그것에 대조한다.** 내장 카탈로그는 그 선언이 없을 때의 기본이다 —\n   * 상대를 바꾸지 않으면, 자기 어휘를 선언한 원본이 정상적인 자리마다 경고를 받는다.\n   */\n  const known: string[] = declaredLocationTypes(master.productionSpec) ?? 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    /*\n     * **이름을 통과시킨다.** 여기서 버리고 있었다 — 그래서 모델에도, 투영한 행에도 이름이 없고\n     * 화면은 자리 id 를 그대로 찍었다(`cut-station`). 목록·표·관계 그림에서 같은 결함이 따로\n     * 보였던 이유가 이 한 줄이다. 이름 없는 원본은 이름 없이 통과한다(id 로 메우지 않는다).\n     */\n    /*\n     * **속성도 통과시킨다** — 설비와 같은 규율(손대지 않고 나른다). 여기가 없으면 자리에 실은 값이\n     * 커널에 닿지 않는다: 에너지의 계약전력(`contract.kW`)이 그 경로이고, 통과하지 않으면 커널이\n     * 계약을 모르는 채로 서서 **판정을 아예 하지 않는다**(오류 없이 알리지 않고).\n     */\n    return { id: l.id, type: l.type, ...(l.name ? { name: l.name } : {}), ...(l.description ? { description: l.description } : {}), capacity: l.capacity ?? 0, ...(l.parallelism !== undefined ? { parallelism: l.parallelism } : {}), ...(l.level ? { level: l.level } : {}), ...(l.properties?.length ? { properties: l.properties } : {}), parentId: l.parentId, ...(l.upstreamId ? { upstreamId: l.upstreamId } : {}), gs1Id: l.gs1Id }\n  })\n\n  /*\n   * ── 설비가 구역에 서 있을 수 있다 (2026-09-06) ──────────────────────────────\n   * 마스터는 자리와 구역을 **한 목록**에 담고 `role` 로 가른다(§`locationEntries` · `areaLocs`).\n   * 그래서 설비의 `homeLocationId` 가 구역을 가리킬 수 있다 — 실제로 `EQ-CAM-SHOWER-01` 이\n   * `LINE-CAM`(구역)에 서 있고, 그것이 정상이다(에어샤워는 라인 전체에 딸린다).\n   *\n   * 계약이 그 구분을 위해 `homeLocationKind` 를 두었는데(`HomeKind = 'location' | 'area'`)\n   * **아무도 안 채우고 있었다.** 그래서 인제스트가 그 참조를 「끊어졌다」고 경고했다.\n   *\n   * 짐작하지 않는다 — 마스터가 이미 `role` 로 말하고 있으므로 그것을 읽는다.\n   */\n  const areaIds = new Set(master.locations.filter(l => l.role === 'area').map(l => l.id))\n\n  const equipment = (master.equipment ?? []).map(e => ({\n    id: e.id, kind: e.kind, ...(e.name ? { name: e.name } : {}), ...(e.description ? { description: e.description } : {}), ...(e.testResults?.length ? { testResults: e.testResults } : {}),\n    /* 등급 소속 — 사람·자산과 같은 자리. 빠뜨리면 원본이 채운 등급이 문턱에서 조용히 버려진다. */\n    ...(e.equipmentClassIds?.length ? { equipmentClassIds: e.equipmentClassIds } : {}),\n    homeLocation: e.homeLocationId,\n    /* 자리면 안 적는다 — 계약의 기본값이 `location` 이고, 없는 칸을 만들면 화면이 그것을 그린다. */\n    ...(e.homeLocationId && areaIds.has(e.homeLocationId) ? { homeLocationKind: 'area' as const } : {}),\n    mtbfMs: e.mtbfMs, mttrMs: e.mttrMs, ...(e.identity ? { identity: e.identity } : {}),\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   * **분 오프셋**만 받는다(계약 `TwinModelDef.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   * ── 이름도 함께 싣는다 (2026-09-07) ────────────────────────────────────────\n   * 위에서 푼 오프셋은 **이 순간의** 값이고, 이 모델은 저장된다. 그래서 그 수는 마스터를 받은 날의\n   * 계절로 굳는다 — `America/Tijuana`(PST −480 / PDT −420)가 자료에 있고, 지난 구간을 교대별로 접으면\n   * 그 안의 전환이 사실을 한 시간 밀어 **다른 교대로** 세게 한다. 오류는 나지 않는다.\n   *\n   * 이름이 함께 있으면 소비처가 순간마다 다시 풀 수 있다(§`shiftContext`). 커널은 이 값을 쓰지 않는다.\n   *\n   * 오프셋이 안 풀린 이름은 싣지 않는다 — 그 경우는 위에서 경고로 말했고, 풀리지 않는 이름을 실어\n   * 두면 소비처가 그것을 믿고 매번 실패한다.\n   */\n  const timezone = utcOffsetMinutes !== undefined ? master.space.timezone : undefined\n  /*\n   * 오퍼레이션 명세를 model 에 통과시킨다 — 커널이 `loadOperations` 로 소비한다(TwinModelDef 확장 필드,\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, ...(p.name ? { name: p.name } : {}), ...(p.testResults?.length ? { testResults: p.testResults } : {}), personnelClassIds: p.personnelClassIds, ...(p.identity ? { identity: p.identity } : {}), ...(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, ...(a.name ? { name: a.name } : {}), ...(a.testResults?.length ? { testResults: a.testResults } : {}), assetClassIds: a.assetClassIds, homeLocation: a.homeLocationId, ...(a.identity ? { identity: a.identity } : {}), ...(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    /* 이름은 이름 자리에 — 예전에는 `name` 을 `description` 으로 옮겨 담았다(어휘가 뒤집혀 있었다). */\n    ...(d.name ? { name: 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  /*\n   * **등급의 표시명은 `name` 이다.**\n   *\n   * 표준 마스터는 등급의 표시명을 `description` 에 담는다(`RefResourceClass.description` = i18n 키).\n   * 그것을 그대로 모델에 실으면 화면의 \"설명\" 열에 이름이 앉는다 — 사용자에게는 이름인데 머리글은\n   * 설명이라, 같은 것을 축마다 다른 이름으로 부르게 된다.\n   *\n   * 그래서 **문 하나에서 어휘를 맞춘다**: 표시명은 어느 축이든 `name`. 원래의 `description` 은\n   * 남겨 두지 않는다 — 두 자리에 같은 값이 있으면 어느 것이 정본인지 다시 헷갈린다.\n   */\n  const asName = (list?: RefResourceClass[]) =>\n    list?.map(({ description, ...rest }) => ({ ...rest, ...(description ? { name: description } : {}) }))\n  /*\n   * 검사 명세도 **표시명은 `name`** 이다 — 등급과 같은 규칙을 쓴다(어휘를 하나로). 표준 마스터는\n   * 표시명을 `description` 에 담으므로 문 하나에서 옮긴다. 그러지 않으면 화면의 \"설명\" 열에 이름이\n   * 앉아 축마다 다른 이름으로 같은 것을 부르게 된다(등급에서 이미 겪었다).\n   */\n  const testSpecifications = master.testSpecifications?.map(({ description, ...rest }) => ({\n    ...rest,\n    ...(description ? { name: description } : {})\n  }))\n  const personnelClasses = asName(master.personnelClasses)\n  const equipmentClasses = asName(master.equipmentClasses)\n  const assetClasses = asName(master.assetClasses)\n  const materialClasses = asName(master.materialClasses)\n\n  const model = {\n    locations, equipment, layout, spaceId,\n    /* 생산 정의도 손대지 않고 통과 — 경계에서 어휘를 갈지 않는다(커널이 그대로 소비한다). */\n    ...(master.productionSpec ? { productionSpec: master.productionSpec } : {}),\n    /* 정체성 선언도 그대로 통과한다 — 없으면 만들지 않는다(커널이 레거시 상수로 떨어진다). */\n    ...(master.identity ? { identity: master.identity } : {}),\n    ...(materialDefinitions?.length ? { materialDefinitions } : {}),\n    ...(materialClasses?.length ? { materialClasses } : {}),\n    ...(utcOffsetMinutes !== undefined ? { utcOffsetMinutes } : {}),\n    ...(timezone ? { timezone } : {}),\n    ...(operations?.length ? { operations } : {}),\n    ...(testSpecifications?.length ? { testSpecifications } : {}),\n    ...(personnelClasses?.length ? { personnelClasses } : {}),\n    ...(equipmentClasses?.length ? { equipmentClasses } : {}),\n    ...(assetClasses?.length ? { 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, ...(l.upstreamId ? { upstreamId: l.upstreamId } : {}),\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  /*\n   * ── 이름을 지어내지 않는다 (2026-08-26) ────────────────────────────────────\n   * 여기가 합성한 표현에 `name: '위성 지도'` 를 넣고 있었다. 이 층은 언어 중립이어야 하는데 한국어가\n   * 그대로 저장됐다.\n   *\n   * 낱말 열쇠(`twin.representation.map` 같은 것)를 넣는 길도 있는데 택하지 않았다. **표현의 이름은\n   * 사람이 바꿀 수 있는 값**이고, 바꿀 수 있는 값 안에 열쇠가 들어 있으면 사람이 한 번 고치는 순간\n   * 그 자리만 열쇠가 아니게 되어 규칙이 둘이 된다.\n   *\n   * 그래서 이름을 넣지 않는다. 화면이 종류(`map`)로 부르고, 사람이 붙이면 그때부터 그 이름이다.\n   */\n  const representations =\n    givenReps.length > 0\n      ? givenReps\n      : geo\n        ? [{ id: 'r-map', type: 'map', 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\n  }\n\n  return { model, spaceContent, warnings }\n}\n\n/**\n * 다시 읽을 사이트를 고른다 — **기억해 둔 사이트 하나만**.\n *\n * 못 찾으면 **첫 사이트로 때우지 않는다**: 다른 현장의 구조를 이 트윈에 덮어쓰는 일이고, 그것은 오류가\n * 아니라 **오류 없이 틀린 공장**으로 나타난다. 기억이 없는 옛 트윈은 `undefined` 를 돌려주고, 부르는 쪽이\n * 마스터의 정체(`source` = 인스턴스 id)로 찾는 길을 택한다.\n */\nexport function pickOriginSite<T extends { siteId: string }>(\n  sites: readonly T[],\n  origin: { siteId?: string } | undefined | null\n): { site?: T; reason?: 'no-remembered-site' | 'site-gone' } {\n  const wanted = String(origin?.siteId ?? '').trim()\n  if (!wanted) return { reason: 'no-remembered-site' }\n  const site = sites.find(s => String(s.siteId) === wanted)\n  return site ? { site } : { reason: 'site-gone' }\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 * 마스터를 읽어 트윈 구조(TwinModelDef) + 공간(Space content)을 생성. 손배선이 아니라 인제스트로 엔티티가 흐른다.\n *\n * 규율(ADR-0018): 도메인 타입(location.type=노드용)은 커널 카탈로그 어휘를 그대로 반영(발명 금지).\n * location 은 role 로 노드(운영점)·area(공간영역)·both 를 구분 — 노드→TwinModelDef, area→Space.areas.\n * 좌표·representations 는 트윈 공간층(보완/추가). 실 시스템이 좌표를 안 주면 layout 없이 위상만 인제스트.\n */\n\nimport type { DomainSystem, EquipmentLevel, TestSpecificationCriterion, WorkCalendarEntry } from '@operato/ops-contract'\n\nexport interface RefLocation {\n  id: string\n  type: string // 노드는 커널 노드타입(dock/storage/yard-slot…), area 는 공간 region 타입\n  name?: string\n  description?: string\n  role: 'location' | 'area' | 'both'\n  parentId?: string\n  /**\n   * **이 자리를 정의하는 영역**(`wms` · `mes` …) — 기준정보가 말한 그대로. 이 트윈의 렌즈(`ReferenceMaster.system`)와 다르면\n   * 그 자리는 참조로만 든다(ADR-0081 보탬). 말하지 않은 자리는 이 렌즈의 자리다.\n   */\n  system?: string\n  /**\n   * **전기적으로 어디서 받는가** — 이 자리에 전기를 주는 상류 자리(커널 계약의 `upstreamId`).\n   *\n   * `parentId`(공간 포함)와 따로 두는 이유는 커널 계약에 적혀 있다. 여기서 빠뜨리면 마스터가 말한 계통이\n   * 모델까지 오지 못하고, 뿌리 계량 판정이 분기 계량기까지 뿌리로 세어 **부하가 두 배로** 보인다.\n   */\n  upstreamId?: 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  /**\n   * 자리의 **열린 속성** — 표준 `OperationalLocationProperty`(설비·사람·자산과 같은 모양).\n   *\n   * 무엇이 여기 실리나: **자리의 물리량**이다. 에너지의 계약전력(`contract.kW`)이 첫 사례다 —\n   * 그 값이 앉을 자리가 없어서 EMS 커널은 계약 대비 판정을 할 수 없었다(자리가 없으면 사실이\n   * 들어오지 못한다). 커널은 자기가 **읽는** 속성 id 만 선언하고(`EMS_PROPERTY`) 나머지는 나른다.\n   */\n  properties?: RefResourceProperty[]\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\n/**\n * 검사 명세 — **자원이 가리키는 대상**(ISA-95 `TestSpecification`).\n *\n * 표준 필드는 셋만 담는다(`ID`·`Description`·`Version`) — 재는 속성과 합격 기준은 아직 1차 출처와\n * 대조하지 않았다(커널 계약의 머리말이 그 사실을 적어 두었다).\n */\n/**\n * 시험 결과 — **\"이 개체가 그 시험을 통과했다\"** 는 기록(ISA-95 결과).\n *\n * 결과를 낳는 곳은 트윈이 아니다(인사·정비 시스템이 기록한다) — 그래서 관측이면서 **선언 경로로** 온다.\n * 커널은 이 값이 있을 때만 자격을 판정한다: 없으면 제약이 아니고(라인이 굶지 않는다), 있으면 만료·\n * 불합격이 배정을 막는다.\n */\nexport interface RefTestResult {\n  specId: string\n  result: 'pass' | 'fail'\n  at?: string\n  /** 없으면 무기한 — 짐작으로 기한을 만들면 멀쩡한 자격자가 오류 없이 사라진다. */\n  expiresAt?: string\n}\n\nexport interface RefTestSpecification {\n  id: string\n  /** 표시명 — i18n 키일 수 있다. 읽는 어휘를 하나로 맞추려고 인제스트가 `name` 으로 옮긴다. */\n  description?: string\n  version?: string\n  /**\n   * 판정 기준들 — 커널 계약의 `TestSpecification.criteria` 를 그대로 나른다.\n   *\n   * **경계에서 어휘를 갈지 않는다.** 커널 타입을 그대로 쓰므로 `limit.{minimum,maximum,uom}` ·\n   * `expression` · `evaluatedPropertyId` 가 원본에서 커널까지 한 이름으로 간다.\n   *\n   * 선언하지 않아도 명세는 성립한다(이름만으로 「무엇으로 검증했나」에 답한다). 선언하면 **판정에\n   * 근거가 있는지**를 물을 수 있게 된다 — 커널의 `criterionSaysNothing` 이 그것을 센다.\n   */\n  criteria?: TestSpecificationCriterion[]\n}\n\nexport interface RefEquipment {\n  id: string\n  kind: string\n  /**\n   * 속한 **등급들** — 계약 선언의 `equipment[].equipmentClassIds` 로 그대로 간다.\n   *\n   * ── 왜 빠져 있었나 (2026-09-04) ─────────────────────────────────────────\n   * 커널에 이 축을 여는 날 모델·상태·저널·미러까지 배선했는데 **접수면이 빠졌다.** 사람과 자산은\n   * 받는데(`personnelClassIds`·`assetClassIds`) 설비만 없었다.\n   *\n   * 그래서 원본이 설비 22대에 등급을 다 채워 보냈는데 **문턱에서 버려졌다** — 거절도 경고도 없이.\n   * 등급 목록은 서고 소속은 아무도 없어서, 화면에서 등급을 골라도 설비가 안 나왔다.\n   *\n   * 소속은 이 선언과 `kind` 를 합친 것이다(§`equipmentClassMembership`) — 판정하는 쪽이 그 함수를\n   * 지난다.\n   */\n  equipmentClassIds?: string[]\n  /** 사람이 부르는 이름 — 없으면 화면이 id 를 보인다(id 를 이름으로 베끼지 않는다). */\n  name?: string\n  /** 시험 결과 — 자격이 성립하는지는 이것이 말한다(§RefTestResult). */\n  testResults?: RefTestResult[]\n  description?: string\n  homeLocationId: string\n  mtbfMs?: number // 평균 고장 간격(확률적 고장) — 지정 시 커널이 breakdown 시뮬 → 주목(고장) 발생\n  mttrMs?: number // 평균 수리 시간\n  /**\n   * **이 설비의 전역 정체성** — 커널 선언의 `equipment[].identity` 로 그대로 간다.\n   *\n   * 예전 이름은 `gs1Id` 였다. 그런데 **GS1 키가 아닌 것이 정상이다** — 실측한 값은 인버터의\n   * 하드웨어 식별자(`ES100000007d8d061d-1`)이고, 원본이 GIAI 를 주면 그것도 여기 들어온다.\n   * 이름이 한 종류만 가리키면 다른 종류가 들어올 때 그 자리를 못 쓴다.\n   *\n   * 자리(`RefLocation.gs1Id`)는 그대로다 — 그쪽은 실제로 SGLN 이 온다.\n   */\n  identity?: string\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  /** 시험 결과 — 자격이 성립하는지는 이것이 말한다(§RefTestResult). */\n  testResults?: RefTestResult[]\n  /**\n   * **이 사람의 전역 정체성** — 커널 선언의 `personnel[].identity` 로 간다.\n   *\n   * ── 왜 필요한가 (인티그레이션 레인이 물음, 2026-09-05) ─────────────────────\n   * 설비에서 이 자리를 만든 이유가 사람에게도 그대로 걸린다: **지역 이름은 그 현장 안에서만\n   * 고유하다.** 인버터 `001` 이 두 발전소에 있어서 함께 집계하니 한쪽 발전량이 사라졌다.\n   * `E-1001` 도 다른 공장에 있을 수 있고, 여러 현장을 함께 보는 순간 같은 일이 난다.\n   *\n   * ── **여기에 개인정보를 넣지 않는다** ──────────────────────────────────────\n   * 설비와 사람이 갈리는 자리가 이것이다. 설비의 정체성은 하드웨어 일련번호이고 아무에게도 해가\n   * 없다. 사람의 「전역에서 고유한 값」은 사원번호·출입카드·주민등록처럼 **그 사람에 관한 사실**\n   * 이고, 저널은 되풀이 읽히고 미러로 복제되고 구독으로 방송된다 — 한 번 들어가면 지워지지 않는다.\n   *\n   * 그래서 이 칸이 요구하는 것은 **현장을 앞에 붙여 전역에서 고유해진 이름**이다. 그 이상이 아니다.\n   *\n   * ```\n   * 맞다    urn:hatiolab:mes-line-a:obj:E-1001      (§`objectUri` 가 만든다)\n   *         https://hatiotrailer.com/twin/obj/E-1001\n   * 아니다  카드번호 · 사원번호 원문 · 주민등록번호 · 생체 식별자\n   * ```\n   *\n   * 「이 사람이 누구인가」는 인사 시스템이 답할 물음이고 트윈의 물음이 아니다. 트윈은 **같은\n   * 사람인지 다른 사람인지**만 알면 된다 — 그 일에 개인정보는 필요 없다.\n   *\n   * 값이 없으면 비운다. 지금 원본이 그런 값을 주지 않으므로 당분간 비어 있는 것이 정상이다.\n   */\n  identity?: 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  /** 시험 결과 — 자격이 성립하는지는 이것이 말한다(§RefTestResult). */\n  testResults?: RefTestResult[]\n  /**\n   * 속한 등급들 — 표준 `PhysicalAssetClassID`(복수). 팔레트가 'euro-pallet' 이면서 'food-grade' 일 수 있다.\n   * 공정의 요구는 등급 하나 + 수량이다(표준 `PhysicalAssetSpecification`).\n   */\n  assetClassIds?: string[]\n  /** 기본 위치. */\n  homeLocationId?: string\n  /**\n   * **이 자산의 전역 정체성** — 설비와 같은 이름이다(§`RefEquipment.identity`).\n   *\n   * ── 왜 이름을 바꿨나 (2026-09-04) ───────────────────────────────────────\n   * `gs1Id` 였다. 설비에서 그 이름을 바꾼 이유가 여기에도 그대로 적용된다 — **GS1 키가 아닌 것이\n   * 정상이다.** 자산의 실측 값도 제조번호·사내 관리번호이고, GS1 을 요구하는 이름을 두면 그것을\n   * 채우는 쪽이 없는 키를 지어내거나 칸을 비워 둔다.\n   *\n   * 그리고 마스터는 이미 `identity` 로 낸다(설비·자산 둘 다). 이 자리만 다른 이름이라 **원본이\n   * 채우는 순간 조용히 사라졌다.** 지금 자산 26대가 다 비어 있어 버려지는 값은 없었다 —\n   * 인티그레이션 레인이 그것을 재서 「누가 채우는 순간」이라고 짚었다.\n   *\n   * 자리 쪽(`RefLocation.gs1Id`)은 그대로다 — 거기는 실제로 SGLN 이 온다.\n   */\n  identity?: 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\n/**\n * **이 마스터를 다시 만들 수 있는 방법** — 트윈이 자기 원본을 기억하는 자리.\n *\n * 트윈은 원본을 비출 뿐이므로(ADR-0028), 원본이 달라지면 **다시 읽어야** 합니다. 그런데 지금까지\n * 트윈은 \"내가 무엇에서 나왔나\" 를 남기지 않았다 — 어댑터로 들어온 트윈은 `TwinReference` 행이\n * 있었지만 템플릿으로 세운 트윈에는 아무것도 없었고, 그래서 **다시 읽을 대상이 없는 트윈**이\n * 만들어졌다. 원본을 잃은 트윈은 첫날의 모습에 영원히 머문다.\n *\n * 그래서 원천이 무엇이든 여기 한 자리에 남긴다. 다시 읽기는 이 값 하나만 보면 된다.\n */\nexport type MasterOrigin =\n  /**\n   * 등록된 레퍼런스(어댑터)에서 왔다 — 다시 읽기 = 그 어댑터로 마스터를 다시 가져온다.\n   *\n   * `source` 는 **레퍼런스 등록 이름**이고 그 참조가 보고하는 사이트 전부에 같다. 그래서 어느 사이트에서\n   * 온 트윈인지는 `siteId` 가 있어야 안다 — 없으면 다시 읽기가 사이트를 찾지 못한다(2026-08-18 실측:\n   * 사이트가 여러 개인 참조에서 온 트윈은 재동기가 전부 거절됐다. 참조 이름을 사이트별 마스터의\n   * `source`(=인스턴스 id)와 비교하고 있었다 — 서로 다른 것을 비교한 것이다).\n   */\n  | { kind: 'reference'; source: string; siteId?: string; spaceId?: string }\n  /**\n   * 템플릿 + 노브로 합성했다 — 다시 읽기 = 같은 노브로 다시 짓는다(합성은 결정적이다).\n   *\n   * `spaceId` 는 **만들 때 고른 현장**이다(합쳐 넣기). 기억하지 않으면 다시 읽을 때 트윈이 알리지 않고 자기\n   * 현장을 떠난다 — 템플릿이 낸 기본 공간으로 돌아가기 때문이다. 그러면 그 현장의 값(요금 등)도 함께\n   * 잃는다(2026-08-18 실측: 한 현장에 합쳐 둔 EMS 트윈 여덟이 재동기 뒤 각자 공간으로 흩어졌다).\n   */\n  | { kind: 'template'; templateId: string; params: Record<string, unknown>; spaceId?: string }\n\nexport interface ReferenceMaster {\n  source: string\n  /**\n   * 어느 종류의 트윈인가 — **커널 카탈로그가 정본**이다(`DomainSystem`).\n   *\n   * 예전에는 `'wms' | 'yms' | 'mes'` 를 여기 적어 뒀다. 커널에 종류가 하나 늘 때(에너지) 이 줄이\n   * 함께 움직여야 하는데, 손으로 적힌 목록은 그것을 알려 주지 않는다 — 어휘의 집은 한 곳이어야 한다.\n   */\n  system: DomainSystem\n  siteName: string\n  /** 검사 명세 — 자원·등급의 `testSpecificationIds` 가 가리키는 대상. */\n  testSpecifications?: RefTestSpecification[]\n  /**\n   * 이 마스터가 어디서 나왔나 — **다시 읽기의 유일한 근거.** 없으면 그 트윈은 다시 읽을 수 없고,\n   * 조회 화면이 그 사실을 그대로 말한다(없는 것을 있는 척하지 않는다).\n   */\n  origin?: MasterOrigin\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   * 생산 선언 — `TwinModelDef.productionSpec` 으로 통과한다(ISA-95 OperationsSegment + BOM).\n   *\n   * 예전 이름은 `mesSpec` 이었다. 담긴 것은 MES 만의 것이 아니라 \"자재를 소비해 자재를 산출하는\n   * 공정\" 이고, 이름이 MES 였기 때문에 창고 트윈은 이 자리를 쓸 생각조차 하지 못했다(유통가공 창고가\n   * BOM 을 설명 문서에만 적어 둔 채 키트를 못 만드는 트윈을 만든 원인). 근거는 커널 계약 주석에.\n   */\n  productionSpec?: unknown\n  /**\n   * **이 원본이 식별자를 만드는 이름공간** — `TwinModelDef.identity` 로 통과한다.\n   *\n   * **선언이 없으면 커널이 거절한다** (0.7.45~). 예전에는 상수 프리픽스로 팔레트·트레일러·문서를\n   * 만들었는데(`0614141` — GS1 이 규격 예제로 쓰다 버린 값이고 `06…` 은 실 배정 대역이다), 그 값은\n   * 저널에 영원히 남으면서 지어낸 것이라고 말해 주는 데가 없었다. 그래서 커널이 만들지 않는다.\n   *\n   * 원본이 자기 도메인을 말하면 그 아래에서 만든다 — 그것이 표준 정합이다(CBV 2.0 §8.2.4·§8.5.5,\n   * 「그 인터넷 도메인 소유자가 배정한다」). GS1 키를 쓰려면 `documentTypes` + `companyPrefix` 이고,\n   * 그때 **자리 수가 맞아야 한다**(SGTIN 은 프리픽스 + 품목참조 = 13자리, GS1 TDS).\n   *\n   * 정체성은 생산과 무관하므로 `productionSpec` 이 아니라 **모델**이 갖는다 — 창고·야드는 아무것도\n   * 생산하지 않으면서 팔레트·트레일러를 식별한다.\n   */\n  identity?: 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   * 커넥터가 **옮기는 동안 알게 된 것.** 외부 시스템의 값을 우리 어휘로 못 옮겨 기본값을 넣었다면\n   * 여기에 담아 보낸다 — 그러면 `masterToTwin` 의 경고와 한 줄기로 합쳐져 화면까지 간다.\n   *\n   * 이 자리가 없던 동안 커넥터는 할 말이 있어도 **말할 곳이 없었다.** 그래서 도크를 랙으로 바꿔\n   * 놓고도 알리지 않고 성공했다. 옮기는 사람만 아는 사실은 옮기는 자리에서 실어야 한다.\n   */\n  warnings?: IngestWarning[]\n  /**\n   * **원본이 가진 수** — 옮긴 수의 분모다.\n   *\n   * 총평은 도착한 모델만 볼 수 있어서 「레시피 1,261」까지만 말할 수 있었다. 그런데 사람이 묻는 것은\n   * 「그게 전부인가」다 — 원본에 1,408개가 있었고 147개를 옮기지 못했다면 그 사실이 총평의 첫 줄에\n   * 있어야 한다. 실제로 사용자가 품목 2,789 와 자재 1,789 의 차이를 화면에서 읽어 내지 못해 직접\n   * 물었다(2026-08-22).\n   *\n   * 분모를 아는 것은 **커넥터뿐이다.** 그래서 커넥터가 실어 보낸다. 보내지 않으면 총평은 분모 없이\n   * 옮긴 수만 말한다 — **지어내지 않는다.**\n   *\n   * 열쇠는 총평이 세는 이름과 같다(`recipes`·`materials`·`totalInputs`·…). 값은 **원본을 끝까지 읽어서\n   * 센 것**이어야 한다. 잘린 읽기의 수를 여기 담으면 「전부 옮겼다」는 거짓이 된다.\n   */\n  originCounts?: Record<string, number>\n}\n\nexport interface IngestedTwin {\n  model: any // TwinModelDef(+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/**\n * **시각을 모르는 채 시각으로 판정하려 한다** — 발전 형상은 하루의 시각을 읽는데 이 트윈의 공간이\n * 시간대를 말하지 않았다.\n *\n * ── 왜 경고인가 (2026-08-18) ────────────────────────────────────────────────\n * 커널은 시간대를 모르면 UTC 로 읽는다(계약에 밝혀 둔 규율 — 모르는 값을 지어내지 않는다). 그런데 발전\n * 형상은 **시각별 비율**이라, 시간대가 없으면 현장 정오가 아니라 UTC 정오에 피크가 선다(KST 현장이면\n * 밤 9시). 값이 그럴듯하게 나오므로 아무도 알아채지 못한다.\n *\n * 그래서 시간대를 **지어내지 않고**(서버 로컬이나 임의 기본값을 넣으면 그 트윈의 모든 시각 판정이 알리지 않고\n * 그 가정 위에 선다) 대신 **그 조합을 말한다** — 공간에 시간대를 선언하면 사라지는 경고다.\n */\nexport const generationWithoutTimeZone = (spaceId: string, equipmentId: string): IngestWarning => ({\n  code: 'generation-without-time-zone',\n  params: { spaceId, equipmentId },\n  message:\n    `\"${equipmentId}\" declares a daily generation shape but space \"${spaceId}\" declares no time zone — the hourly fractions will be read in UTC, ` +\n    'so the generation peak will not land at local noon. Declare the space time zone (we do not guess one).'\n})\n\n/**\n * 아무도 선언하지 않은 자리 타입 — 그 자리는 흐름에 참여하지 못할 수 있다.\n *\n * **묻는 상대를 고쳤다 (2026-08-20).** 예전에는 내장 카탈로그에게만 물었다. 그런데 원본이 자기\n * `DomainDefinition.locationTypes` 를 함께 보내면 **그 선언이 정본**이다 — 카탈로그는 우리가 아는\n * 도메인들의 기본 어휘일 뿐이다. 물을 상대가 틀렸으니, 자기 어휘를 선언한 원본은 정상적인 타입마다\n * 경고를 받았다(F&B 라인을 붙이면 자리마다 하나씩). 소음이 되면 사람은 경고를 읽지 않게 되고, 그때\n * 진짜 경고도 함께 죽는다.\n */\nexport const unknownLocationType = (system: string, type: string, id: string): IngestWarning => ({\n  code: 'unknown-location-type',\n  params: { system, type, id },\n  /*\n   * ── 무슨 일이 벌어지는지 말한다 (2026-08-25) ────────────────────────────────\n   * 예전 문장은 「흐름에 참여하지 못할 수 있다」였다. 물건이 흐르는 도메인에서는 맞는 말인데,\n   * 에너지 트윈에는 흐름이 없어서 그 문장이 아무것도 알려 주지 않았다(실제로 태양광 발전소를\n   * 붙이면서 이 경고를 받은 사람이 「이 경고가 뜻이 있는가」를 되물었다).\n   *\n   * 종류를 모르면 실제로 일어나는 일은 하나다: **그 자리에 능력이 붙지 않는다.** 능력이 없으면\n   * 상태 필드도 없고, 롤업에도 들어가지 않고, 저작면 팔레트에도 서지 않는다. 도메인을 가리지 않고\n   * 참인 문장이므로 이것을 적는다.\n   */\n  message:\n    `\"${type}\" is declared nowhere for ${system} (${id}) — neither in the master's own locationTypes nor in the built-in ` +\n    `catalog. A location whose type is unknown gets no capabilities, so it carries no state, joins no rollup, ` +\n    `and (in domains that move things) may be left out of the flow.`\n})\n\n/**\n * 원본이 함께 보낸 자리 타입 선언 — 있으면 **이것이 정본**이다.\n *\n * 커널 계약의 `DomainDefinition.locationTypes` 는 `{ key, label, … }` 목록이다. 읽을 수 없는 모양이면\n * `undefined` 를 돌려 **카탈로그로 떨어진다** — 빈 배열을 돌려주면 「아무 타입도 선언되지 않았다」가\n * 되어 모든 자리가 경고를 받는다(없는 것과 못 읽은 것은 다르다).\n */\nexport function declaredLocationTypes(productionSpec: unknown): string[] | undefined {\n  const list = (productionSpec as any)?.definition?.locationTypes\n  if (!Array.isArray(list) || !list.length) return undefined\n  const keys = list.map((t: any) => (typeof t === 'string' ? t : t?.key)).filter((k: any) => typeof k === 'string' && k)\n  return keys.length ? keys : undefined\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/**\n * 구조 투영에서 **가리키는 대상을 못 찾았다.**\n *\n * 예전에는 이런 참조가 model JSON 안의 맨 문자열이라 화면만 경고할 수 있었고, 다른 경로로 들어온\n * 데이터는 아무도 안 봤다. 이제 행으로 풀면서 **인제스트가 직접 안다** — 그러니 인제스트가 말한다.\n * 막지는 않는다(트윈은 model 로 이미 동작한다). 다만 알리지 않고 넘기지 않는다.\n */\nexport const unresolvedReference = (field: string, ref: string): IngestWarning => ({\n  code: 'unresolved-reference',\n  params: { field, ref },\n  message: `${field} points at something that is not in this twin (${ref}) — the link was left empty`\n})\n\n/**\n * 구조 투영 자체가 실패했다 — 조회는 못 하지만 **트윈은 동작한다**(커널은 model 를 이미 받았다).\n * 행은 원본에서 다시 그릴 수 있으므로 인제스트를 실패로 만들지 않되, 침묵하지도 않는다.\n */\nexport const projectionFailed = (reason: string): IngestWarning => ({\n  code: 'projection-failed',\n  params: { reason },\n  message: `structure projection failed (${reason}) — the twin runs, but model inspection will be stale until the next ingest`\n})\n\n/**\n * **동작 중에 공장을 전환했다** — 미러는 멈추지 않으므로, 무엇이 사라졌는지 여기서 말한다.\n *\n * 멈췄다 세우는 구조 전환이라면 사용자가 \"다시 세웠다\" 는 것을 안다. 미러는 그 마디가 없어서\n * 자리 하나·설비 한 대가 알리지 않고 없어질 수 있다 — 자리가 수천인 현장에서 화면의 수를 세어\n * 눈치채기를 기대할 수는 없다. 늘어난 것도 함께 말한다(무엇이 반영되었나가 곧 인제스트의 답이다).\n */\nexport const structureAdopted = (rev: number, shift: { locationsAdded: number; locationsDropped: number; equipmentDropped: number; personsDropped: number; assetsDropped: number }): IngestWarning => ({\n  code: 'structure-adopted',\n  params: { rev, ...shift },\n  message:\n    `the running mirror adopted a new structure (revision ${rev}) — ` +\n    `+${shift.locationsAdded} location(s), -${shift.locationsDropped} location(s), ` +\n    `-${shift.equipmentDropped} equipment, -${shift.personsDropped} person(s), -${shift.assetsDropped} asset(s)`\n})\n\n/**\n * 커넥터가 외부 시스템의 값을 **우리 어휘로 옮기지 못해 기본값을 넣었다.**\n *\n * 예: Oracle WMS 가 우리 표에 없는 `locn_type` 을 주면 그 자리는 `storage` 가 된다 — 도크가 랙으로\n * 모델링되는 것이다. 인제스트를 통째로 실패시킬 일은 아니지만(로케이션 하나 때문에 현장 전체가\n * 안 들어오는 편이 더 나쁘다), **알리지 않고 넘어가면 안 된다.** 트윈이 실물과 다르게 생겼는데\n * 아무도 그 사실을 모른 채 그 위에서 흐름을 논하게 된다.\n *\n * 값을 나열하는 이유: \"3건\" 만으로는 커넥터 매핑에 무엇을 더해야 하는지 알 수 없다.\n */\nexport const connectorMappingFallback = (field: string, fallback: string, values: readonly string[], count: number): IngestWarning => ({\n  code: 'connector-mapping-fallback',\n  params: { field, fallback, values: values.join(', '), count },\n  message: `${count} ${field} value(s) had no mapping and fell back to \"${fallback}\" (${values.join(', ')}) — the twin's shape differs from the source system here`\n})\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\n/**\n * 이 현장의 설비를 노브 값으로 채웠다 — **알리지 않고 채우지 않는다.**\n *\n * 에너지 트윈의 부하를 이웃 설비 id 로 선언할 때 쓴다. 몇 개를 가져왔는지 말해 주지 않으면, 사용자는\n * 자기가 고르지 않은 설비들이 부하로 잡힌 것을 나중에 화면에서야 알게 된다.\n */\nexport const siteEquipmentAdopted = (key: string, count: number): IngestWarning => ({\n  code: 'site-equipment-adopted',\n  params: { key, count },\n  message: `${count} piece(s) of equipment already on this site were adopted as loads (knob \"${key}\") — set their coefficients before trusting the numbers`\n})\n\nexport function masterToTwin(master: ReferenceMaster, catalog?: any): IngestedTwin {\n  /* 커넥터가 옮기며 알게 된 것을 먼저 싣는다 — 원인이 앞에 오는 편이 읽기 쉽다(대체가 먼저, 그 결과가 뒤). */\n  const warnings: IngestWarning[] = [...(master.warnings ?? [])]\n  /*\n   * 원본이 자기 어휘를 선언했으면 **그것에 대조한다.** 내장 카탈로그는 그 선언이 없을 때의 기본이다 —\n   * 상대를 바꾸지 않으면, 자기 어휘를 선언한 원본이 정상적인 자리마다 경고를 받는다.\n   */\n  const known: string[] = declaredLocationTypes(master.productionSpec) ?? 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    /*\n     * **이름을 통과시킨다.** 여기서 버리고 있었다 — 그래서 모델에도, 투영한 행에도 이름이 없고\n     * 화면은 자리 id 를 그대로 찍었다(`cut-station`). 목록·표·관계 그림에서 같은 결함이 따로\n     * 보였던 이유가 이 한 줄이다. 이름 없는 원본은 이름 없이 통과한다(id 로 메우지 않는다).\n     */\n    /*\n     * **속성도 통과시킨다** — 설비와 같은 규율(손대지 않고 나른다). 여기가 없으면 자리에 실은 값이\n     * 커널에 닿지 않는다: 에너지의 계약전력(`contract.kW`)이 그 경로이고, 통과하지 않으면 커널이\n     * 계약을 모르는 채로 서서 **판정을 아예 하지 않는다**(오류 없이 알리지 않고).\n     */\n    return { id: l.id, type: l.type, ...(l.name ? { name: l.name } : {}), ...(l.description ? { description: l.description } : {}), capacity: l.capacity ?? 0, ...(l.parallelism !== undefined ? { parallelism: l.parallelism } : {}), ...(l.level ? { level: l.level } : {}), ...(l.properties?.length ? { properties: l.properties } : {}), parentId: l.parentId, ...(l.upstreamId ? { upstreamId: l.upstreamId } : {}), gs1Id: l.gs1Id }\n  })\n\n  /*\n   * ── 설비가 구역에 서 있을 수 있다 (2026-09-06) ──────────────────────────────\n   * 마스터는 자리와 구역을 **한 목록**에 담고 `role` 로 가른다(§`locationEntries` · `areaLocs`).\n   * 그래서 설비의 `homeLocationId` 가 구역을 가리킬 수 있다 — 실제로 `EQ-CAM-SHOWER-01` 이\n   * `LINE-CAM`(구역)에 서 있고, 그것이 정상이다(에어샤워는 라인 전체에 딸린다).\n   *\n   * 계약이 그 구분을 위해 `homeLocationKind` 를 두었는데(`HomeKind = 'location' | 'area'`)\n   * **아무도 안 채우고 있었다.** 그래서 인제스트가 그 참조를 「끊어졌다」고 경고했다.\n   *\n   * 짐작하지 않는다 — 마스터가 이미 `role` 로 말하고 있으므로 그것을 읽는다.\n   */\n  const areaIds = new Set(master.locations.filter(l => l.role === 'area').map(l => l.id))\n\n  const equipment = (master.equipment ?? []).map(e => ({\n    id: e.id, kind: e.kind, ...(e.name ? { name: e.name } : {}), ...(e.description ? { description: e.description } : {}), ...(e.testResults?.length ? { testResults: e.testResults } : {}),\n    /* 등급 소속 — 사람·자산과 같은 자리. 빠뜨리면 원본이 채운 등급이 문턱에서 조용히 버려진다. */\n    ...(e.equipmentClassIds?.length ? { equipmentClassIds: e.equipmentClassIds } : {}),\n    homeLocation: e.homeLocationId,\n    /* 자리면 안 적는다 — 계약의 기본값이 `location` 이고, 없는 칸을 만들면 화면이 그것을 그린다. */\n    ...(e.homeLocationId && areaIds.has(e.homeLocationId) ? { homeLocationKind: 'area' as const } : {}),\n    mtbfMs: e.mtbfMs, mttrMs: e.mttrMs, ...(e.identity ? { identity: e.identity } : {}),\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   * **분 오프셋**만 받는다(계약 `TwinModelDef.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   * ── 이름도 함께 싣는다 (2026-09-07) ────────────────────────────────────────\n   * 위에서 푼 오프셋은 **이 순간의** 값이고, 이 모델은 저장된다. 그래서 그 수는 마스터를 받은 날의\n   * 계절로 굳는다 — `America/Tijuana`(PST −480 / PDT −420)가 자료에 있고, 지난 구간을 교대별로 접으면\n   * 그 안의 전환이 사실을 한 시간 밀어 **다른 교대로** 세게 한다. 오류는 나지 않는다.\n   *\n   * 이름이 함께 있으면 소비처가 순간마다 다시 풀 수 있다(§`shiftContext`). 커널은 이 값을 쓰지 않는다.\n   *\n   * 오프셋이 안 풀린 이름은 싣지 않는다 — 그 경우는 위에서 경고로 말했고, 풀리지 않는 이름을 실어\n   * 두면 소비처가 그것을 믿고 매번 실패한다.\n   */\n  const timezone = utcOffsetMinutes !== undefined ? master.space.timezone : undefined\n  /*\n   * 오퍼레이션 명세를 model 에 통과시킨다 — 커널이 `loadOperations` 로 소비한다(TwinModelDef 확장 필드,\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, ...(p.name ? { name: p.name } : {}), ...(p.testResults?.length ? { testResults: p.testResults } : {}), personnelClassIds: p.personnelClassIds, ...(p.identity ? { identity: p.identity } : {}), ...(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, ...(a.name ? { name: a.name } : {}), ...(a.testResults?.length ? { testResults: a.testResults } : {}), assetClassIds: a.assetClassIds, homeLocation: a.homeLocationId, ...(a.identity ? { identity: a.identity } : {}), ...(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    /* 이름은 이름 자리에 — 예전에는 `name` 을 `description` 으로 옮겨 담았다(어휘가 뒤집혀 있었다). */\n    ...(d.name ? { name: 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  /*\n   * **등급의 표시명은 `name` 이다.**\n   *\n   * 표준 마스터는 등급의 표시명을 `description` 에 담는다(`RefResourceClass.description` = i18n 키).\n   * 그것을 그대로 모델에 실으면 화면의 \"설명\" 열에 이름이 앉는다 — 사용자에게는 이름인데 머리글은\n   * 설명이라, 같은 것을 축마다 다른 이름으로 부르게 된다.\n   *\n   * 그래서 **문 하나에서 어휘를 맞춘다**: 표시명은 어느 축이든 `name`. 원래의 `description` 은\n   * 남겨 두지 않는다 — 두 자리에 같은 값이 있으면 어느 것이 정본인지 다시 헷갈린다.\n   */\n  const asName = (list?: RefResourceClass[]) =>\n    list?.map(({ description, ...rest }) => ({ ...rest, ...(description ? { name: description } : {}) }))\n  /*\n   * 검사 명세도 **표시명은 `name`** 이다 — 등급과 같은 규칙을 쓴다(어휘를 하나로). 표준 마스터는\n   * 표시명을 `description` 에 담으므로 문 하나에서 옮긴다. 그러지 않으면 화면의 \"설명\" 열에 이름이\n   * 앉아 축마다 다른 이름으로 같은 것을 부르게 된다(등급에서 이미 겪었다).\n   */\n  const testSpecifications = master.testSpecifications?.map(({ description, ...rest }) => ({\n    ...rest,\n    ...(description ? { name: description } : {})\n  }))\n  const personnelClasses = asName(master.personnelClasses)\n  const equipmentClasses = asName(master.equipmentClasses)\n  const assetClasses = asName(master.assetClasses)\n  const materialClasses = asName(master.materialClasses)\n\n  const model = {\n    locations, equipment, layout, spaceId,\n    /* 생산 정의도 손대지 않고 통과 — 경계에서 어휘를 갈지 않는다(커널이 그대로 소비한다). */\n    ...(master.productionSpec ? { productionSpec: master.productionSpec } : {}),\n    /* 정체성 선언도 그대로 통과한다 — 없으면 만들지 않는다(커널이 레거시 상수로 떨어진다). */\n    ...(master.identity ? { identity: master.identity } : {}),\n    ...(materialDefinitions?.length ? { materialDefinitions } : {}),\n    ...(materialClasses?.length ? { materialClasses } : {}),\n    ...(utcOffsetMinutes !== undefined ? { utcOffsetMinutes } : {}),\n    ...(timezone ? { timezone } : {}),\n    ...(operations?.length ? { operations } : {}),\n    ...(testSpecifications?.length ? { testSpecifications } : {}),\n    ...(personnelClasses?.length ? { personnelClasses } : {}),\n    ...(equipmentClasses?.length ? { equipmentClasses } : {}),\n    ...(assetClasses?.length ? { 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, ...(l.upstreamId ? { upstreamId: l.upstreamId } : {}),\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  /*\n   * ── 이름을 지어내지 않는다 (2026-08-26) ────────────────────────────────────\n   * 여기가 합성한 표현에 `name: '위성 지도'` 를 넣고 있었다. 이 층은 언어 중립이어야 하는데 한국어가\n   * 그대로 저장됐다.\n   *\n   * 낱말 열쇠(`twin.representation.map` 같은 것)를 넣는 길도 있는데 택하지 않았다. **표현의 이름은\n   * 사람이 바꿀 수 있는 값**이고, 바꿀 수 있는 값 안에 열쇠가 들어 있으면 사람이 한 번 고치는 순간\n   * 그 자리만 열쇠가 아니게 되어 규칙이 둘이 된다.\n   *\n   * 그래서 이름을 넣지 않는다. 화면이 종류(`map`)로 부르고, 사람이 붙이면 그때부터 그 이름이다.\n   */\n  const representations =\n    givenReps.length > 0\n      ? givenReps\n      : geo\n        ? [{ id: 'r-map', type: 'map', 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\n  }\n\n  return { model, spaceContent, warnings }\n}\n\n/**\n * 다시 읽을 사이트를 고른다 — **기억해 둔 사이트 하나만**.\n *\n * 못 찾으면 **첫 사이트로 때우지 않는다**: 다른 현장의 구조를 이 트윈에 덮어쓰는 일이고, 그것은 오류가\n * 아니라 **오류 없이 틀린 공장**으로 나타난다. 기억이 없는 옛 트윈은 `undefined` 를 돌려주고, 부르는 쪽이\n * 마스터의 정체(`source` = 인스턴스 id)로 찾는 길을 택한다.\n */\nexport function pickOriginSite<T extends { siteId: string }>(\n  sites: readonly T[],\n  origin: { siteId?: string } | undefined | null\n): { site?: T; reason?: 'no-remembered-site' | 'site-gone' } {\n  const wanted = String(origin?.siteId ?? '').trim()\n  if (!wanted) return { reason: 'no-remembered-site' }\n  const site = sites.find(s => String(s.siteId) === wanted)\n  return site ? { site } : { reason: 'site-gone' }\n}\n"]}

package/dist-shared/entity-delta.d.ts

@@ -1,3 +1,4 @@
+import { type OrderFoldPolicy } from '@operato/ops-contract';
 export interface EntityDelta {
     tag: string;
     data: any;
@@ -46,4 +47,6 @@ export interface EntityDeltaScope {
     /** 개별 payload 를 만들 물품 태그. 없으면 전부. */
     items?: ReadonlySet<string>;
 }
-export declare function buildEntityDeltas(state: any, instanceId: string, scope?: EntityDeltaScope): EntityDelta[];
+export declare function buildEntityDeltas(state: any, instanceId: string, scope?: EntityDeltaScope, 
+/** 끝난 오더를 접는 경계(모델의 `orderFold`) — 「최근 T 완료」의 T 다. 없으면 커널의 기본. */
+orderFold?: OrderFoldPolicy): EntityDelta[];