@things-factory/headless-twin 10.1.278 → 10.1.280

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

@@ -1 +0,0 @@
-{"version":3,"file":"reference-hook.js","sourceRoot":"","sources":["../../../server/service/reference/reference-hook.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * 연결된 시스템이 **밀어 주는** 사실을 받는 자리 — 웹훅.\n *\n * 규약(상태 코드 · 비밀값 · 대상 확인)은 `hook-contract.ts` 에 있다. 여기는 그것을 써서 찾고 · 확인하고 ·\n * 커넥터에게 옮기게 하고 · 유입으로 넘기는 순서만 맡는다.\n *\n * ── 왜 필요한가 ─────────────────────────────────────────────────────────────\n * 지금 모든 커넥터가 주기적으로 물어봅니다(폴링). 그 방식은 두 가지를 치릅니다. 연결된 시스템이 값을\n * 갱신하는 주기보다 자주 물으면 같은 값을 되풀이 받고, 그쪽 서버에 그만큼 부담을 줍니다. 실제로\n * 태양광 발전소에 10초마다 물으면서 10분마다 바뀌는 값을 받아 왔습니다.\n *\n * 연결된 시스템이 「바뀌었다」를 말해 줄 수 있으면 그것을 받는 것이 낫습니다. 이 파일이 그 입구입니다.\n *\n * ── 규약 ────────────────────────────────────────────────────────────────────\n *\n *   주소     POST /twin/hook/<연결이름>/<트윈>   — no /domain/<도메인> prefix: the route sits on the domain-public\n *            router without one (server/routes.ts:31); a prefixed address falls through and answers 405\n *   도메인   X-Things-Factory-Domain: <도메인>   — the webhook module sends it from the destination's\n *            params.receivingDomain\n *   인증     연결 설정에 저장한 비밀값(`hookSecret`)을 헤더로 보낸다\n *            X-Twin-Hook-Secret: <비밀값>   또는   Authorization: Bearer <비밀값>\n *   본문     연결된 시스템이 정한 모양 그대로. 우리 어휘로 옮기는 것은 커넥터의 일이다\n *   응답     아래 §`hookStatus`\n *\n * ── 왜 사람 인증(JWT)이 아닌가 ──────────────────────────────────────────────\n * 밀어 주는 쪽은 사람이 아닙니다. 우리 토큰을 발급받아 갱신하며 관리하라고 요구하면 대부분의 현장에서\n * 연동이 서지 않습니다. 그래서 연결마다 비밀값을 두고 그것으로 확인합니다.\n *\n * **비밀값이 없는 연결은 훅을 받지 않습니다.** 기본이 거부입니다 — 인증 없는 입구를 열어 두는 것보다\n * 훅을 못 쓰는 것이 낫습니다.\n *\n * ── 왜 커넥터가 옮기나 (시나리오가 아니라) ──────────────────────────────────\n * 연결된 시스템의 웹훅은 그쪽이 정한 고정된 모양으로 옵니다. 그 모양을 아는 것은 그 커넥터이고,\n * 옮기는 판단은 코드여야 테스트로 지킬 수 있습니다. 실제로 지금 커넥터들이 코드로 판단합니다 —\n * 통신이 끊긴 설비의 값은 보내지 않고, 잰 시각이 나아가지 않은 줄은 거릅니다. 그 판단을 변환식으로\n * 옮기면 약해지고 테스트가 없어집니다.\n *\n * ── 밀어 주기만으로는 안 된다 ───────────────────────────────────────────────\n * 훅은 반드시 놓칩니다 — 우리가 내려가 있을 때, 그쪽이 못 보냈을 때, 네트워크가 끊겼을 때. 그래서\n * 훅을 쓰는 연결도 **드문 폴링을 유지합니다.** 폴링의 역할이 「값을 가져오는 것」에서 「놓친 것이 있나\n * 확인하는 것」으로 바뀌는 것입니다. 그 주기는 연결 설정이 정합니다.\n *\n * ── 같은 것이 두 번 오는 것 ─────────────────────────────────────────────────\n * 밀어 주는 방식은 재전송이 정상입니다(그쪽이 우리 응답을 못 받으면 다시 보냅니다). 그것은 유입\n * 경계가 이미 거릅니다(§`FactDeduper`) — 이 파일이 따로 하지 않습니다. 응답에 몇 건이 중복이었는지\n * 함께 알립니다.\n */\nimport { WEBHOOK_STATUS, type WebhookResponse } from '@operato/ops-contract'\n\nimport { twinWarn } from '../../engine/log.js'\n\nimport { getAdapter, type InboundBatch } from './reference-adapter.js'\nimport { rejectedForCaller, type RejectedForCaller } from './hook-rejected.js'\nexport { rejectedForCaller, type RejectedForCaller } from './hook-rejected.js'\nimport { authorizeHook, producedInstance, pushCursorKey, seqOf, takeInSequence, withSeq, type HookOutcome } from './hook-contract.js'\n\ntype WebhookLane = 'FACTS' | 'ATTENTIONS'\nfunction webhookLaneOf(value: unknown): WebhookLane | undefined {\n  return value === undefined || value === 'FACTS' ? 'FACTS' : value === 'ATTENTIONS' ? 'ATTENTIONS' : undefined\n}\n\n/**\n * 훅 하나를 처리한다 — 찾고 · 확인하고 · 커넥터에게 옮기게 하고 · 유입으로 넘긴다.\n *\n * 유입 자체(`ingest`)는 부르는 쪽이 넘겨 준다: 이 파일이 엔진을 직접 부르면 시험할 때 엔진이 필요해지고,\n * 그러면 규약을 확인하는 시험을 쓸 수 없다.\n */\nexport async function handleHook(args: {\n  domainId: string\n  source: string\n  instanceId: string\n  headers: Record<string, unknown>\n  body: unknown\n  /**\n   * 받은 바이트 그대로 — 서명을 확인하려면 이것이 있어야 한다.\n   *\n   * 파싱한 객체를 다시 문자열로 만들면 키 순서와 공백이 달라져 서명이 맞지 않는다. 없으면 서명을 쓰는\n   * 요청은 거절된다(§`authorizeHook`).\n   */\n  rawBody?: string\n  /** 서명 창을 재는 기준 시각. 부르는 쪽이 준다 — 여기서 읽으면 시험이 시계에 매인다. */\n  nowMs?: number\n  /** 레코드를 트윈에 넣는다 — 받은 수와 **떨어진 것들**을 돌려준다. */\n  ingest: (instanceId: string, records: unknown[], lane: WebhookLane) => IngestResult | Promise<IngestResult>\n  /**\n   * 구멍을 봤다 — **부르는 쪽이 무엇을 할지 정한다.**\n   *\n   * 여기서 backfill 을 직접 부르지 않는다. 이 파일은 `ingest`·`store` 를 인자로 받아 가볍게 유지한다\n   * (그래야 테스트가 엔진 없이 이 판정을 확인할 수 있다). backfill 을 import 하면 그 규율이 깨진다.\n   *\n   * 기다리지 않는 것도 부르는 쪽의 몫이다 — 훅의 응답이 늦으면 보내는 쪽이 되풀이한다.\n   */\n  onGap?: (scope: string) => void\n  /**\n   * 저장소를 대신 쓰는 자리 — **시험이 재기동을 넣을 수 있게.**\n   *\n   * `ingest` 를 부르는 쪽이 넘겨 주는 것과 같은 이유다(위 §). 커서는 재기동을 넘어 살아야 하는데, 한\n   * 프로세스 안에서만 확인하면 「적히나」는 보이지만 「다시 세우면 읽히나」는 안 보인다. 그 둘이 갈린\n   * 결함을 이 저장소가 이미 겪었다.\n   */\n  store: HookStore\n}): Promise<HookOutcome> {\n  const { domainId, source, instanceId, headers, body, rawBody, ingest, onGap } = args\n  const nowMs = args.nowMs ?? Date.now()\n  const { store } = args\n\n  const ref = await store.load(domainId, source)\n  if (!ref) {\n    return { status: WEBHOOK_STATUS.unknownTarget, body: { ok: false, error: `unknown connection \"${source}\"` } }\n  }\n\n  const cfg: any = (ref as any).connectionConfig ?? {}\n  const expected = String(cfg.hookSecret ?? '').trim()\n  if (!expected) {\n    /* 비밀값을 선언하지 않은 연결은 훅을 받지 않는다 — 기본이 거부다. */\n    return {\n      status: WEBHOOK_STATUS.badSecret,\n      body: {\n        ok: false,\n        error: `connection \"${source}\" declares no hookSecret — set one in the connection settings before pushing to it`\n      }\n    }\n  }\n  const auth = authorizeHook({ headers, rawBody, secret: expected, nowMs })\n  if (auth.ok === false) {\n    return { status: WEBHOOK_STATUS.badSecret, body: { ok: false, error: auth.reason } }\n  }\n\n  const site = producedInstance(ref as any, instanceId)\n  if (!site) {\n    return {\n      status: WEBHOOK_STATUS.unknownTarget,\n      body: { ok: false, error: `twin \"${instanceId}\" was not created by connection \"${source}\"` }\n    }\n  }\n\n  const adapter: any = getAdapter(String((ref as any).adapterType ?? ''))\n  if (typeof adapter?.handleInbound !== 'function') {\n    return {\n      status: WEBHOOK_STATUS.unsupported,\n      body: { ok: false, error: `connector \"${(ref as any).adapterType}\" cannot take pushed events (no handleInbound)` }\n    }\n  }\n\n  let batch: InboundBatch\n  try {\n    batch = adapter.handleInbound(cfg, site, body, headers)\n  } catch (e: any) {\n    /* 옮기지 못한 것은 그쪽 모양이 바뀐 것이다 — 다시 보내도 같으므로 재시도를 부르지 않는다. */\n    return { status: WEBHOOK_STATUS.badPayload, body: { ok: false, error: e?.message ?? 'cannot translate the payload' } }\n  }\n  const items = batch?.items\n  if (!Array.isArray(items)) {\n    return {\n      status: WEBHOOK_STATUS.badPayload,\n      body: { ok: false, error: 'the connector did not return a list of items' }\n    }\n  }\n\n  /*\n   * **번호 확인** — 이 자리가 프레임워크인 이유는 밀어 주는 모든 연결에 같은 규율이라야 하기 때문이다.\n   * 커넥터마다 만들면 한 곳이 빠지고, 빠진 그 연결에서만 사실이 없어진다.\n   *\n   * 판정은 `takeInSequence` 하나가 한다 — **backfill 하는 길도 같은 함수를 지난다.** 여기서 따로 만들면\n   * 두 길이 다른 규칙으로 받고, 한쪽만 고쳐지는 날이 온다.\n   */\n  const lane = webhookLaneOf((batch as any).lane)\n  if (!lane) {\n    return { status: WEBHOOK_STATUS.badPayload, body: { ok: false, error: 'unknown webhook lane' } }\n  }\n  const scope = typeof batch.scope === 'string' && batch.scope.trim() ? batch.scope.trim() : undefined\n  /* 열쇠에 트윈을 넣는다 — 연결 하나가 트윈 여럿을 만들고 커서는 연결마다 한 행이다. */\n  const key = scope ? pushCursorKey(instanceId, scope) : undefined\n  const taken = takeInSequence({\n    items,\n    scope,\n    lastSeq: key ? seqOf((ref as any).liveCursor, key) : undefined\n  })\n  if (taken.refused) {\n    /* 반쯤 확인한 것을 확인했다고 말하지 않는다. */\n    return { status: WEBHOOK_STATUS.badPayload, body: { ok: false, error: taken.refused } }\n  }\n  const numbered = taken.numbered\n  const gap = taken.gap\n  /*\n   * 첫 봉투가 1번이 아니면 **그 사실을 남긴다.** 커서가 없는 연결에 21번이 오면 커서가 21 로 뛰고,\n   * 그 앞 스무 건은 구멍으로도 안 세어진다. 실제로 plant 에서 그렇게 스무 건이 조용히 사라졌다.\n   *\n   * 손실이라고 말하지 않는다 — 늦게 붙은 트윈은 그 앞을 안 받기로 한 것이다. 수만 말하고 판단은\n   * 사람이 한다.\n   */\n  if (taken.firstUnseenBefore) {\n    twinWarn(\n      `[twin-ingest] \"${instanceId}\" 의 ${scope ?? '(단위 없음)'} 를 ${taken.advancedSeq} 번부터 받기 시작했습니다 — ` +\n        `그 앞 ${taken.firstUnseenBefore}건은 받은 적이 없습니다. 원본이 오래 돌고 있었으면 정상이고, ` +\n        `보냈는데 못 받은 것이면 그만큼이 빠진 것입니다`\n    )\n  }\n  const advanced = taken.advancedSeq !== undefined && key ? { scope: key, seq: taken.advancedSeq } : undefined\n\n  const records = taken.records\n\n  if (!records.length) {\n    /*\n     * 옮길 것이 없는 것은 오류가 아니다 — 그쪽이 우리와 무관한 것을 보낸 것일 수 있다. 다만 첫 봉투부터\n     * 구멍이면 그것은 받은 것이 없는 것이고, 그 앞부터 달라고 해야 한다.\n     */\n    if (gap) {\n      if (scope) onGap?.(scope)\n      return gapOutcome(scope, gap)\n    }\n    if (advanced) await saveSeq(store, ref as any, advanced.scope, advanced.seq, taken.firstSeq)\n    return {\n      status: WEBHOOK_STATUS.ok,\n      body: {\n        ok: true,\n        offered: 0,\n        applied: 0,\n        duplicates: 0,\n        vocabulary: 0,\n        rejected: [],\n        ...seqBody(scope, advanced, numbered, taken.firstUnseenBefore)\n      }\n    }\n  }\n\n  let result: IngestResult\n  try {\n    result = await ingest(instanceId, records, lane)\n  } catch (e: any) {\n    return { status: WEBHOOK_STATUS.failed, body: { ok: false, error: e?.message ?? 'ingest failed' } }\n  }\n  const rejected = result.rejected ?? []\n  /*\n   * ── 떨어진 것에 **봉투 id** 를 붙인다 (2026-09-07 측정) ──────────────────────\n   * 이 응답이 `{ record, errors }` 목록이었고, plant 은 그것을 **봉투 id 문자열 목록**으로 읽고\n   * 있었다. `Array.isArray` 는 통과하므로 그쪽 guard 도 안 걸렸다 — id 를 맞추는데 객체라 하나도\n   * 안 맞고 **묶음 전체가 「보냈음」으로 찍혔다.**\n   *\n   * 422 와 `ok: false` 를 보냈는데 그쪽 행은 재시도 0 · 오류 없음 · 보냈음이었다. 우리가 말했는데\n   * 상대가 못 알아듣는 모양이면, 말한 것이 아니다.\n   *\n   * 그래서 봉투 id 를 함께 싣는다. 보내는 쪽이 자기 행을 표시할 수 있고 까닭도 남는다.\n   *\n   * **id 를 못 찾으면 레코드를 그대로 싣는다.** 그때는 무엇이 떨어졌는지 알 방법이 그것뿐이고,\n   * 빈 id 를 실으면 보내는 쪽이 아무 행도 못 찾으면서 「알았다」고 여긴다.\n   *\n   * 짝은 **객체 동일성**으로 짓는다. `records` 는 `items` 의 순서와 원소를 그대로 들고 있고\n   * (§`takeInSequence`), 그래서 커넥터를 고치지 않고도 봉투로 되짚을 수 있다. 값으로 비교하면\n   * 같은 모양의 레코드 둘이 서로의 id 를 가져간다.\n   */\n  const forCaller = rejectedForCaller(rejected, items as { record?: unknown; eventId?: unknown }[])\n\n  if (result.applied === 0 && result.duplicates === 0 && rejected.length === 0 && !result.vocabulary) {\n    /*\n     * 넣었는데 한 건도 반영되지 않았고 중복도 거부도 아니면, 그 트윈이 실시간으로 돌지 않는 것이다.\n     * 200 을 주면 그쪽은 전달된 줄 알고 그 사실을 버린다.\n     *\n     * **커서를 올리지 않는다.** 한 건도 안 들어갔는데 번호를 올리면 그 번호는 다시 오지 않고, 트윈이\n     * 뜬 뒤에 그 구간이 비어 있게 된다.\n     *\n     * ── Vocabulary is why this test needs a fourth term (2026-09-07) ──────────\n     * This inference reads an absence as a cause, and one absence is legitimate: a batch that was\n     * entirely vocabulary applies no events, has no duplicates and rejects nothing, and yet\n     * everything in it landed (§`applyMasterData`). Without the last term the receiver answers\n     * 503 to correct traffic, and the sender then holds those facts and retries every thirty\n     * seconds for as long as they keep arriving — the reply invents a reason (\"not running live\")\n     * that the numbers do not support.\n     *\n     * Found by a test written for the response sum, not by reading this line.\n     *\n     * ── Why this branch has to say something out loud ─────────────────────────\n     * Measured today: a 503 from here leaves **no trace on either side.** The sender maps it to\n     * backpressure and returns without touching `attempts` or `lastError`, and this branch logged\n     * nothing, so a sender re-offering the same batch every thirty seconds is invisible to both.\n     *\n     * That is also why \"it has not happened\" could not be established: `attempts 0` on the seven\n     * vocabulary envelopes was offered as evidence and is not evidence, because this path never\n     * increments that counter. Telling a sender to come back forever is worth one line.\n     */\n    twinWarn(\n      `[twin-hook] \"${instanceId}\" 에 ${records.length}건이 왔는데 한 건도 앉지 않아 ` +\n        `${NOT_LIVE_RETRY_MS / 1000}초 뒤 다시 오라고 답했습니다 — 트윈이 실시간으로 돌지 않는 것으로 봅니다. ` +\n        `보내는 쪽은 이 답에 재시도 횟수를 남기지 않으므로, 되풀이되면 이 줄만 늘어납니다`\n    )\n\n    return {\n      status: WEBHOOK_STATUS.notLive,\n      body: {\n        ok: false,\n        error: `twin \"${instanceId}\" is not running live — nothing was applied`,\n        offered: records.length,\n        retryAfterMs: NOT_LIVE_RETRY_MS\n      }\n    }\n  }\n\n  if (advanced) await saveSeq(store, ref as any, advanced.scope, advanced.seq, taken.firstSeq)\n\n  /*\n   * **구멍이 있으면 그것이 답을 정한다.** 앞의 것은 이미 들어갔으므로 `lastSeq` 까지는 보냄으로 표시하게\n   * 하고, 떨어진 것이 있으면 그것도 함께 싣는다 — 두 소식이 한 응답에 들어가야 보내는 쪽이 둘 다 한다.\n   */\n  if (gap) {\n    if (scope) onGap?.(scope)\n    return gapOutcome(scope, gap, forCaller, advanced)\n  }\n\n  if (rejected.length) {\n    /*\n     * **다시 보내라고 하지 않는다.** 떨어진 것은 모양이 틀린 것이라 같은 것을 다시 보내도 또 떨어지고,\n     * 함께 간 나머지는 이미 들어갔으므로 두 번 들어간다.\n     */\n    return {\n      status: WEBHOOK_STATUS.partial,\n      body: {\n        ok: false,\n        error: `${rejected.length} of ${records.length} records did not pass validation`,\n        offered: records.length,\n        applied: result.applied,\n        duplicates: result.duplicates,\n        vocabulary: result.vocabulary ?? 0,\n        rejected: forCaller,\n        ...seqBody(scope, advanced, numbered, taken.firstUnseenBefore)\n      }\n    }\n  }\n\n  return {\n    status: WEBHOOK_STATUS.ok,\n    body: {\n      ok: true,\n      offered: records.length,\n      applied: result.applied,\n      duplicates: result.duplicates,\n      /*\n       * Always reported, even as zero — the sender's sum has a term for it either way, and a field\n       * that appears only sometimes makes an absent one indistinguishable from a receiver that\n       * does not count vocabulary at all.\n       */\n      vocabulary: result.vocabulary ?? 0,\n      rejected: [],\n      ...seqBody(scope, advanced, numbered, taken.firstUnseenBefore)\n    }\n  }\n}\n\n/**\n * 유입이 돌려주는 것.\n *\n * 떨어진 것을 **수가 아니라 목록으로** 받는다. 수만 받으면 보내는 쪽에 「몇 건이 떨어졌다」밖에 말할 수\n * 없고, 그러면 무엇을 따로 두어야 할지 알 수 없어 배치 전체를 다시 보내거나 전부 버린다.\n */\nexport interface IngestResult {\n  applied: number\n  duplicates: number\n  rejected: { record: unknown; errors: string[] }[]\n  /**\n   * How many records were vocabulary rather than events — **needed so the reply's sum closes.**\n   *\n   * `liveIngest` has counted this all along and this boundary dropped it, because the callback was\n   * typed as `IngestResult` and vocabulary was not on it. So `offered` counted those records and\n   * none of the other three did, and a sender checking the sum would have seen a loss on ordinary\n   * traffic (§`WebhookResponse.offered`).\n   *\n   * Optional because an ingest that handles no vocabulary need not say zero, and a caller that\n   * simply does not know must not be made to claim none.\n   */\n  vocabulary?: number\n}\n\n/**\n * 구멍을 알리는 응답 — **앞의 것은 받았다는 것을 함께 말한다.**\n *\n * `lastSeq` 를 빼면 보내는 쪽은 이미 들어간 것까지 다시 보내고, 그것이 매번 중복으로 걸러지면서\n * 처리량만 먹는다.\n */\n/*\n * 구멍을 본 자리에서 **바로 받는다** — 번호가 비었다는 것을 아는 가장 이른 순간이다.\n *\n * 기다리지 않는다. 훅의 응답이 이것 때문에 늦으면 보내는 쪽이 되풀이하고, 그러면 같은 봉투가 두 번\n * 온다. 그리고 같은 단위를 1분 안에 두 번 부르지 않는다(§`FILL_DEBOUNCE_MS`) — 밀어 받는 쪽이\n * 구멍 뒤의 봉투를 계속 보내면 그때마다 구멍 판정이 나기 때문이다.\n */\nfunction gapOutcome(\n  scope: string | undefined,\n  gap: { expectedSeq: number; lastSeq: number },\n  /*\n   * 떨어진 것 — 봉투 id 를 알면 그것을, 모르면 레코드를 싣는다(§`InboundItem.eventId`).\n   * 보내는 쪽이 자기 행을 찾을 수 있어야 하고, 못 찾으면 무엇이 떨어졌는지라도 보여야 한다.\n   */\n  rejected: RejectedForCaller[] = [],\n  advanced?: { scope: string; seq: number }\n): HookOutcome {\n  return {\n    status: WEBHOOK_STATUS.sequenceGap,\n    body: {\n      ok: false,\n      error: 'sequence gap',\n      scope,\n      expectedSeq: gap.expectedSeq,\n      lastSeq: advanced?.seq ?? gap.lastSeq,\n      ...(rejected.length ? { rejected } : {})\n    }\n  }\n}\n\n/**\n * 트윈이 안 돌 때 얼마나 쉬라고 할 것인가.\n *\n * 사람이 트윈을 띄워야 풀리므로 초 단위로 다시 두드릴 이유가 없다. 그렇다고 길게 잡으면 트윈이 뜬 뒤\n * 그만큼 늦게 이어진다.\n */\nconst NOT_LIVE_RETRY_MS = 30_000\n\n/**\n * 응답에 번호를 어떻게 적나 — **확인한 것과 확인하지 않은 것을 구별한다.**\n *\n * 번호를 매기지 않는 원본은 확인할 것이 없다. 그것을 응답에서 「이상 없다」와 같아 보이게 두면, 어느\n * 연결이 연속성을 지키고 있는지 아무도 알 수 없다.\n */\n/*\n * The return type is the contract's, narrowed to the fields this function fills.\n *\n * It was `Record<string, unknown>`, and because the result is **spread** into the reply, an index\n * signature slips past the excess-property check entirely — the four fields below were unverified\n * even after `HookOutcome.body` was typed. Naming them here is what makes the check reach them.\n */\nfunction seqBody(\n  scope: string | undefined,\n  advanced: { scope: string; seq: number } | undefined,\n  numbered: boolean,\n  firstUnseenBefore?: number\n): Pick<WebhookResponse, 'sequenceChecked' | 'scope' | 'lastSeq' | 'firstUnseenBefore'> {\n  if (!numbered) return { sequenceChecked: false }\n  return {\n    sequenceChecked: true,\n    scope,\n    lastSeq: advanced?.seq,\n    /*\n     * 첫 봉투였고 그 앞을 못 봤으면 **그 수를 보내는 쪽에 돌려준다.** 안 돌려주면 그 사실이 아무 데도\n     * 안 남는다 — 구멍으로도 안 세어지고 backfill 대상도 아니다(backfill 은 커서부터 묻는다).\n     */\n    ...(firstUnseenBefore ? { firstUnseenBefore } : {})\n  }\n}\n\n/**\n * 커서에 번호를 적는다 — **반영한 뒤에만.**\n *\n * 넣기 전에 올리면, 넣다가 실패했을 때 그 번호는 다시 오지 않는다. 보내는 쪽은 200 을 못 받았으니 다시\n * 보내겠지만, 그때는 커서가 이미 지나가 있어 `behind` 로 읽히고 버려진다.\n *\n * 적지 못하는 것은 사실 유입을 무르는 이유가 아니다 — 이미 들어간 사실은 그대로 두고, 다음 번호가 오면\n * `gap` 으로 드러난다. 그래서 실패를 던지지 않고 남긴다.\n */\nasync function saveSeq(\n  store: HookStore,\n  ref: { id: string; liveCursor?: unknown },\n  scope: string,\n  seq: number,\n  firstSeq?: number\n): Promise<void> {\n  const next = withSeq(ref.liveCursor, scope, seq, firstSeq)\n  ref.liveCursor = next\n  await store\n    .saveCursor(ref.id, next)\n    .catch(err => twinWarn(`[twin-hook] 번호를 커서에 적지 못했다 (${scope}=${seq}) — ${err?.message ?? err}`))\n}\n\n/**\n * 훅이 저장소에 닿는 두 자리 — 연결을 찾는 것과 커서를 적는 것.\n *\n * 이 둘만 밖으로 낸다. 나머지는 인자만 보고 답하므로 시험이 데이터베이스를 세우지 않아도 된다.\n */\nexport interface HookStore {\n  load(domainId: string, source: string): Promise<any | null>\n  saveCursor(refId: string, cursor: unknown): Promise<void>\n}\n"]}

package/dist-server/service/reference/reference-link-groups.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"reference-link-groups.js","sourceRoot":"","sources":["../../../server/service/reference/reference-link-groups.ts"],"names":[],"mappings":";;AAgBA,4CAIC;AAZD;;;;;;;GAOG;AACH,SAAgB,gBAAgB,CAAC,MAA6C;IAC5E,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,CAC1B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CACtG,CAAA;AACH,CAAC","sourcesContent":["/*\n * 원본이 준 관계 그룹 중 화면에 낼 수 있는 것만 남기는 판정.\n *\n * 조회 코드(`reference-links.ts`)와 나누어 둔다. 그쪽은 TypeORM 엔티티를 물어서 테스트 프로세스가\n * 적재할 수 없다. 판정만 따로 두면 테스트가 가벼운 import 로 확인할 수 있다.\n */\nimport type { ExternalIncoming } from '../twin-model/external-resolver.js'\n\n/**\n * 이름(`via`)이 없으면 화면에 이름 없는 줄이 된다. `total` 이 0 이면 낼 내용이 없다 — 원본이 그\n * 축을 취급하지 않는다는 뜻이고, 트윈이 선언한 관계가 비어 있는 것과 다르다. 후자는 그대로\n * 표시한다(`twin-model-item-query.ts`).\n *\n * `total` 이 없는 그룹도 버린다. 목록만 보내고 전체 수를 빼면 화면이 목록 길이를 전체 수로 쓰게\n * 되고, 원본이 20개만 보낸 날 실제 200건이 20건으로 표시된다.\n */\nexport function usableLinkGroups(groups: ExternalIncoming[] | undefined | null): ExternalIncoming[] {\n  return (groups ?? []).filter(\n    g => !!g && typeof g.via === 'string' && !!g.via.trim() && typeof g.total === 'number' && g.total > 0\n  )\n}\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"reference-links.js","sourceRoot":"","sources":["../../../server/service/reference/reference-links.ts"],"names":[],"mappings":";;AA2CA,kDAqBC;AAGD,oEASC;AA5ED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,iDAAqD;AAErD,wEAAgE;AAChE,2DAAmD;AACnD,iEAAwE;AACxE,6EAAoG;AACpG,yEAA6D;AAE7D;;;;;;;;;GASG;AACI,KAAK,UAAU,mBAAmB,CACvC,QAAgB,EAChB,UAAkB,EAClB,IAAY,EACZ,MAAc;IAEd,MAAM,GAAG,GAAG,MAAM,IAAA,qBAAa,EAAC,iCAAa,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC,CAAA;IACnH,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAA;IAEnB,MAAM,OAAO,GAAG,IAAA,iCAAU,EAAC,GAAG,CAAC,WAAW,CAAC,CAAA;IAC3C,IAAI,CAAC,OAAO,EAAE,UAAU;QAAE,OAAO,EAAE,CAAA;IAEnC;;;OAGG;IACH,MAAM,IAAI,GAAG,MAAM,IAAA,qBAAa,EAAC,+BAAY,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,EAAE,CAAC,CAAA;IAC3G,MAAM,MAAM,GAAI,IAAI,EAAE,MAAc,EAAE,MAAM,CAAA;IAC5C,MAAM,IAAI,GAA+B,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;IAExE,OAAO,IAAA,2CAAgB,EAAC,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;AACnG,CAAC;AAED,qBAAqB;AACrB,SAAgB,4BAA4B;IAC1C,IAAA,+CAAwB,EAAC;QACvB;;;WAGG;QACH,MAAM,EAAE,iBAAiB;QACzB,QAAQ,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC;KAC1G,CAAC,CAAA;AACJ,CAAC","sourcesContent":["/*\n * **원본에만 있는 관계를 조회해서 트윈 상세 화면에 붙인다.**\n *\n * ── 무엇을 해결하나 ────────────────────────────────────────────────────────\n * 설비 상세 화면에서 사람이 실제로 묻는 것은 「이 설비로 무엇을 얼마나 만들었나」, 「지금 정비\n * 중인가」, 「예정된 정비가 있나」다. 그 정보는 트윈에 없고 MES 에 있다.\n *\n * 트윈으로 복제하면 원본의 테이블을 전부 미러링하게 됩니다. 조회용 참조는 복제하지 않고 필요할 때\n * 물어보는 것이 맞습니다.\n *\n * ── 왜 프로세스가 나뉘어 있는가 ────────────────────────────────────────────\n * 측정 결과입니다(2026-09-06).\n *\n *   operato-plant   포트 4000   자기 DB\n *   operato-twin    포트 3000   자기 DB\n *\n * 별개 프로세스이므로 plant 안에서 `registerExternalResolver` 를 불러도 twin 프로세스에는 등록되지\n * 않습니다. 그래서 resolver 는 twin 안에 있고, 본체는 어댑터를 통해 원본에 HTTP 로 물어봅니다.\n *\n * 주소와 인증은 이미 연결 설정(`TwinReference.connectionConfig`)에 있습니다. 새로 만들 것이 없습니다.\n *\n * ── 왜 부팅에 한 번만 등록하나 ──────────────────────────────────────────────\n * 연결은 나중에 추가될 수 있습니다. 연결마다 resolver 를 등록하면 새 연결이 생길 때 재기동해야\n * 합니다. resolver 하나가 호출될 때 연결을 조회하므로 재기동이 필요 없습니다.\n */\nimport { getRepository } from '@things-factory/shell'\n\nimport { TwinInstance } from '../twin-instance/twin-instance.js'\nimport { TwinReference } from './twin-reference.js'\nimport { getAdapter, type SiteDescriptor } from './reference-adapter.js'\nimport { registerExternalResolver, type ExternalIncoming } from '../twin-model/external-resolver.js'\nimport { usableLinkGroups } from './reference-link-groups.js'\n\n/**\n * 이 트윈의 원본에 관계를 물어본다.\n *\n * 물어볼 수 없는 경우가 여럿이고 **전부 빈 배열입니다** — 원본을 모르는 트윈, 등록되지 않은 어댑터,\n * `fetchLinks` 를 구현하지 않은 어댑터. 이 셋은 결함이 아닙니다. 가상 원본과 시뮬레이터는 조회할\n * 관계가 없습니다.\n *\n * 실패는 다릅니다 — 예외를 그대로 올립니다. 호출하는 쪽(`externalIncoming`)이 잡아서 경고를 남기고\n * 나머지 관계는 그대로 표시합니다.\n */\nexport async function fetchReferenceLinks(\n  domainId: string,\n  instanceId: string,\n  axis: string,\n  itemId: string\n): Promise<ExternalIncoming[]> {\n  const ref = await getRepository(TwinReference).findOne({ where: { domain: { id: domainId }, source: instanceId } })\n  if (!ref) return []\n\n  const adapter = getAdapter(ref.adapterType)\n  if (!adapter?.fetchLinks) return []\n\n  /*\n   * 사이트를 함께 넘깁니다 — 원본 하나가 여러 사이트를 낼 수 있습니다(`discoverSites`). 이 트윈이\n   * 어느 사이트에서 왔는지는 `origin.siteId` 에 있고, 없으면 넘기지 않습니다.\n   */\n  const inst = await getRepository(TwinInstance).findOne({ where: { domain: { id: domainId }, instanceId } })\n  const siteId = (inst?.origin as any)?.siteId\n  const site: SiteDescriptor | undefined = siteId ? { siteId } : undefined\n\n  return usableLinkGroups(await adapter.fetchLinks(ref.connectionConfig ?? {}, site, axis, itemId))\n}\n\n/** 부팅에서 한 번 등록한다. */\nexport function installReferenceLinkResolver(): void {\n  registerExternalResolver({\n    /*\n     * `entity` 는 계약의 `target.entity` 와 맞추는 값입니다. 이 resolver 는 들어오는 관계만 답하고\n     * 특정 관계에 붙지 않으므로, 계약에 없는 이름을 씁니다.\n     */\n    entity: 'reference.links',\n    incoming: (domainId, instanceId, axis, itemId) => fetchReferenceLinks(domainId, instanceId, axis, itemId)\n  })\n}\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"reference-live.js","sourceRoot":"","sources":["../../../server/service/reference/reference-live.ts"],"names":[],"mappings":"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","sourcesContent":["import { twinLog, twinWarn, twinError } from '../../engine/log.js'\nimport { getRepository } from '@things-factory/shell'\n\nimport { getAdapter, type ConnectionConfig, type LiveFeedContinuity, type ObservedItemFact, type SiteDescriptor } from './reference-adapter.js'\n/* 이름 짓는 규칙은 가벼운 파일에 있다 — 테스트가 붙게(§`live-feed-lease.ts`). */\nimport { liveFeedLeaseName } from './live-feed-lease.js'\nexport { liveFeedLeaseName } from './live-feed-lease.js'\nimport { databaseCommandStore } from '../actuation/command-store.js'\nimport { settleEffects } from '../actuation/settle-effects.js'\nimport { TwinEngine, ingestCanonicalRecords, registerLiveFeedProbe } from '../../engine/index.js'\nimport { type CanonicalRecord } from '@operato/ops-contract'\nimport { TwinInstance } from '../twin-instance/twin-instance.js'\nimport { TwinReference } from './twin-reference.js'\n\n/*\n * 커넥터 기반 라이브 피드 결선(reference → live, §0 프레임 ① restartPolicy='resync').\n * 흐름: adapter.openLiveFeed(cfg, site, records) → ingestCanonicalRecords(정규→봉투) → TwinEngine.ingestLive(projector 미러).\n * 커넥터가 \"벤더 이벤트 → 정규 레코드\" 매핑을 소유(코드)한다 — preset 기반 startLiveFeed(operato-twin, http-get+jsonata)와\n * 대칭이되, 매핑 위치만 다르다. 실 시스템 전환은 connectionConfig.baseUrl 교체뿐(코드 경로 동일).\n * 생명주기: 인스턴스 정지(TwinEngine.stop)에 훅으로 묶여 피드도 함께 unsubscribe.\n */\n\n/** 활성 라이브 피드 — instanceId → unsubscribe(어댑터 openLiveFeed 반환). */\nconst feeds = new Map<string, () => void>()\n\n/**\n * 커넥터 라이브 기동 — 어댑터 openLiveFeed 를 인스턴스에 결선.\n * 반환: 라이브 결선 성공 여부(어댑터가 openLiveFeed 미지원이면 false → 호출측이 sim 폴백).\n */\nexport async function startReferenceLiveFeed(\n  domainId: string,\n  adapterType: string,\n  cfg: ConnectionConfig,\n  site: SiteDescriptor,\n  instanceId: string,\n  /**\n   * **어느 레퍼런스에서 읽는 피드인가** — 읽기 커서를 저장할 자리를 가리킨다(§`loadLiveCursor`).\n   *\n   * 부르는 쪽이 `TwinReference` 를 이미 들고 있으므로 그 이름을 넘긴다. 처음에는 `cfg`·`site` 에서\n   * 찾으려 했는데 **둘 다 그 값을 가질 수 없다**: `cfg` 는 사람이 화면에서 입력한 접속 설정이고\n   * (`endpoint`·`token`…), `site` 는 커넥터가 원본에서 발견한 것이다 — **레퍼런스의 이름은 호스트가\n   * 붙이는 것이고 원본은 그것을 모른다.** 커넥터가 채울 수 없는 값을 커넥터에서 읽으려 한 것이 잘못이었다.\n   *\n   * 주지 않으면 커서를 잇지 않고 **그 사실을 말한다**(알리지 않고 창이 미끄러지지 않게).\n   */\n  source?: string\n): Promise<boolean> {\n  const adapter = getAdapter(adapterType)\n  if (!adapter?.openLiveFeed) return false\n\n  const det = await TwinEngine.detail(domainId, instanceId)\n  if (!det?.model) throw new Error(`instance \"${instanceId}\" not provisioned (no model) — ingest master before live start`)\n\n  // 관측 기동 — 커널 tick 없이 projector 가 실 이벤트를 반영한다(startLive 가 restartPolicy='resync' 로 적는다).\n  // 시각 기준은 **공간**이 갖는다(테넌트 아님) — 교대의 HH:MM 을 어느 기준으로 읽나.\n  TwinEngine.startLive(instanceId, domainId, det.kind, await TwinEngine.withSpaceTimeBase(det.model, domainId))\n\n  stopReferenceLiveFeed(instanceId) // 재기동 시 이전 피드 정리\n  /*\n   * **어디까지 읽었나를 이 층이 들고 건넨다**(§`LiveFeedContinuity`, 2026-08-23).\n   *\n   * 어댑터가 이 값을 자기 사물함에 두면 원본이 늘 때마다 저장 기제가 늘고, 그중 하나가 알리지 않고 다르게\n   * 동작한다. 그리고 커널이 이미 갈라 두었다: 「원천이 애초에 다시 말해 주지 않는 축」은 재기동\n   * 연속성으로 이어받는다(§`hydrateContinuity`) — 읽기 커서가 정확히 그 성질이다.\n   *\n   * The object itself is handed over even on a first attach, because the feed needs its lease name\n   * before it has read anything. `cursor` staying absent is what says \"first attach\" — which is how\n   * every connector already reads it (`continuity?.cursor`), so nothing changes for them. What is\n   * never filled in with an empty value is the cursor: an empty one would make a first attach look\n   * like a resumed one, and the adapter would build no look-back window.\n   */\n  const carried = await loadLiveCursor(domainId, instanceId, source)\n  const continuity: LiveFeedContinuity = { ...carried, leaseName: liveFeedLeaseName(domainId, instanceId, source) }\n  /*\n   * The lease name is composed here, not in the adapter, because it has to be unique across\n   * domains and an adapter is handed neither `domainId` nor `instanceId` (§`LiveFeedContinuity`).\n   * Built from `source` rather than `site.siteId`: one reference is one connection to one system,\n   * and that is the thing a second instance must not open twice.\n   */\n  /*\n   * ── **트윈이 아는 것을 함께 건넨다** (2026-08-28) ───────────────────────────\n   *\n   * 전량 절대값을 읽는 커넥터는 지난 주기와 견주어 바뀐 것만 낸다. 그 비교 표가 프로세스 안에만\n   * 있어서 재기동하면 커넥터가 전량을 「바뀐 것」으로 판정했다 — 승화푸드에서 2,665건이다.\n   *\n   * 트윈은 저장본에서 되세우므로 잃지 않았다. 그래서 그 사실을 건네면 첫 주기부터 바뀐 것만 나간다.\n   * 커널 어휘로 건넨다 — 원본 낱말로 되돌리는 일은 여러 낱말이 한 값으로 모여 불가능하고, 필요도 없다.\n   */\n  continuity.observedItems = observedItemsOf(domainId, instanceId)\n  const unsubscribe = adapter.openLiveFeed(cfg, site, (records: unknown[]) => {\n    if (!TwinEngine.owns(domainId, instanceId)) {\n      stopReferenceLiveFeed(instanceId) // 인스턴스 사라지면 자가 정지(안전망)\n      return\n    }\n    const offered = Array.isArray(records) ? records.length : records ? 1 : 0\n    const { accepted, rejected, masterData } = ingestCanonicalRecords(\n      records as CanonicalRecord[],\n      domainId,\n      new Date().toISOString(),\n      TwinEngine.factScope(domainId, instanceId)\n    )\n    /*\n     * ── **사건이 아닌 것은 상태만 세운다** (2026-08-28) ─────────────────────────\n     *\n     * 마스터데이터 — 변하지 않는 속성(유통기한·로트번호). 시각축이 없는 값이므로 지난 기록에 적지\n     * 않는다(§`applyMasterData`). 이 문이 없던 동안 그 값은 사건에 실려 왔고, 표준이 그것을\n     * 「들어왔다」에만 허용하므로 전량을 읽는 원본은 **들어오지 않은 것을 들어왔다고** 말해야 했다.\n     *\n     * 반영된 건수를 함께 센다 — 라이브로 돌지 않는 트윈은 0 을 내므로, 그 차이가 「바닥에 버려진 수」다.\n     */\n    const masterApplied = masterData.length ? TwinEngine.applyMasterData(domainId, instanceId, masterData) : 0\n    if (masterData.length && masterApplied < masterData.length) {\n      twinWarn(\n        `[twin-live] \"${instanceId}\": ${masterData.length - masterApplied}/${masterData.length} master data element(s) NOT applied — ` +\n          'the twin is not running live; lot attributes such as expiry will stay empty.'\n      )\n    }\n    /*\n     * 커널이 **몇 건을 실제로 받았나**를 함께 본다. 트윈이 라이브로 돌지 않으면 `ingestLive` 가 0 을\n     * 돌려주고, 그 차이가 곧 「바닥에 버려진 수」다. 이것을 통과로 세면 멈춘 트윈이 100% 로 보인다.\n     */\n    /* 어떤 길로 들어왔는지 함께 적는다 — 화면이 「이 트윈은 무엇을 통해 받나」를 말할 수 있게. */\n    const applied = accepted.length ? TwinEngine.ingestLive(domainId, instanceId, accepted, 'connector') : 0\n\n    /*\n     * **나간 지시와 잇는다** — 폐루프. 훅과 같은 자리다(§`routes.ts`). 기다리지 않는다: 라이브 묶음\n     * 처리가 이것 때문에 늦으면 뒤의 묶음이 밀리고, 밀린 것이 크래시로 이어진 적이 있다.\n     */\n    void settleEffects({ domainId, envelopes: accepted, store: databaseCommandStore() })\n    const undelivered = accepted.length - applied\n    /*\n     * **거부한 것을 알리지 않고 버리지 않는다.** 예전에는 `rejected` 를 받지도 않았다 — 커넥터의 매핑이\n     * 틀리면 트윈은 「아무 일도 일어나지 않는」 모습이 되고, 로그에도 아무 흔적이 없었다.\n     *\n     * 그다음 자리였던 「화면까지 나르기」를 이제 채운다. 건마다 브로드캐스팅하지 않고 **집계**한다 — 통과분까지\n     * 함께 세는 이유는, 거부만 세면 「유입 없음」과 「정상」이 둘 다 거부 0 으로 같아 보이기 때문이다.\n     * 조회는 `twinIngestHealth`.\n     */\n    /*\n     * **읽었다는 것 자체가 사실이다** — 빈 읽기도 성공이므로 단절 기록을 지운다(§`onReadFailure`).\n     * 그 둘을 섞으면 들어온 것이 없는 연결이 끊긴 원본으로 보인다.\n     */\n    TwinEngine.clearIngestReadFailure(domainId, instanceId)\n    TwinEngine.recordIngestResult(domainId, instanceId, offered, rejected, Date.now(), undelivered)\n    if (rejected.length) {\n      const why = rejected[0]?.errors?.join(' · ') ?? 'unknown'\n      twinWarn(`[twin-live] \"${instanceId}\": ${rejected.length}/${offered} record(s) rejected — e.g. ${why}`)\n    }\n    /* 버려진 것은 로그에도 남긴다 — 화면을 보지 않는 사람도 알아야 한다(사실이 사라지는 중이다). */\n    if (undelivered > 0) {\n      twinWarn(\n        `[twin-live] \"${instanceId}\": ${undelivered}/${offered} record(s) NOT delivered — the twin is not running live; ` +\n          `records are being discarded. Start the twin, or disconnect the feed.`\n      )\n    }\n  }, continuity)\n  feeds.set(instanceId, unsubscribe)\n  return true\n}\n\n/**\n * 트윈이 지금 들고 있는 물품을 커널 어휘로 낸다 — 없으면 `undefined`.\n *\n * 상태가 없으면(트윈이 아직 아무것도 모르면) `undefined` 다. 빈 배열로 메우지 않는다 — 「모른다」와\n * 「하나도 없다」는 다른 사실이고, 커넥터가 그 둘에 다르게 반응해야 한다.\n */\nfunction observedItemsOf(domainId: string, instanceId: string): ObservedItemFact[] | undefined {\n  const state = TwinEngine.snapshot(domainId, instanceId)\n  const items = (state as any)?.items\n  if (!Array.isArray(items)) return undefined\n  return items.map((i: any) => ({\n    id: String(i?.subLotId ?? i?.epc ?? ''),\n    ...(i?.gtin ? { epcClass: String(i.gtin) } : {}),\n    ...(i?.location ? { location: String(i.location) } : {}),\n    ...(typeof i?.qty === 'number' ? { qty: i.qty } : {}),\n    ...(i?.uom ? { uom: String(i.uom) } : {}),\n    ...(i?.disposition ? { disposition: String(i.disposition) } : {}),\n    ...(typeof i?.expiry === 'number' ? { expiry: i.expiry } : {}),\n    ...(i?.lot ? { lot: String(i.lot) } : {})\n  })).filter((i: ObservedItemFact) => !!i.id)\n}\n\n/**\n * 그 원본의 읽기 커서를 불러오고, 움직이면 저장하는 통로를 만든다.\n *\n * 커서는 **원본(`TwinReference`)의 것**이지 인스턴스의 것이 아니다 — 한 원본이 여러 인스턴스를 낳고\n * (`scopeSpec.produced`) 읽는 것은 한 번이다. 인스턴스마다 커서를 두면 같은 표를 여러 번 읽는다.\n *\n * 저장 실패는 **삼키지 않고 말한다.** 오류 없이 실패하면 다음 재기동에서 창이 다시 미끄러지고, 그 손실은\n * 오류 없이 사라진다 — 이 컬럼을 만든 이유가 바로 그것이다.\n */\nasync function loadLiveCursor(\n  domainId: string,\n  /** 읽기 실패를 적을 트윈 — 커서는 레퍼런스의 것이지만 **건강은 인스턴스의 것**이다(한 레퍼런스가 여럿을 낳는다). */\n  instanceId: string,\n  source?: string\n  /*\n   * `leaseName` is not this function's to know — it is composed from the domain and instance by the\n   * caller. Returning the rest keeps that rule in one place instead of two.\n   */\n): Promise<Omit<LiveFeedContinuity, 'leaseName'> | undefined> {\n  if (!source) {\n    /* 원본을 가리킬 수 없으면 저장할 자리도 없다 — 그 사실을 말한다(알리지 않고 커서 없이 돌지 않게). */\n    twinWarn('[twin-live] live cursor not carried — the caller did not say which reference this feed reads from')\n    return undefined\n  }\n  const repo = getRepository(TwinReference)\n  const row = await repo.findOne({ where: { domain: { id: domainId } as any, source } }).catch(() => null)\n  if (!row) {\n    twinWarn(`[twin-live] live cursor not carried — no reference row for source \"${source}\"`)\n    return undefined\n  }\n  const stored = row.liveCursor\n  if (stored?.firstAttachedAt) {\n    twinLog(`[twin-live] \"${source}\": resuming from stored cursor — knowledge starts ${stored.firstAttachedAt}`)\n  }\n  return {\n    cursor: stored ?? undefined,\n    /*\n     * **원본에 닿지 못했다** — 어댑터가 알리면 상태에 적는다(§`onReadFailure`).\n     *\n     * 로그로는 어댑터가 이미 말하고 있었다(재시도 경고). 그러나 **로그는 사람이 볼 때만 값이 있다** —\n     * 화면이 말하려면 조회 가능한 상태에 있어야 한다.\n     *\n     * ── `status` 를 건드리지 않는다 (2026-08-23, 되돌린 자리) ────────────────────\n     * 처음에는 레퍼런스 행의 `status` 를 `'error'` 로도 적었다 — 「목록이 「연결됨」이라 말하면서 실제로는\n     * 못 읽는 상태를 없애려고」. **그것이 피드를 영구히 껐다.**\n     *\n     * 부팅 재부착은 `status: 'connected'` 인 레퍼런스만 되살린다(§`resumeReferenceLiveFeeds`). 그래서\n     * 원본이 **잠깐** 끊긴 것이 그 행을 `error` 로 만들고, 다음 재기동에서 그 피드는 아예 붙지 않았다 —\n     * 실측으로 그렇게 났다(09:25 버전에 `[twin-live]` 줄이 한 줄도 없었다).\n     *\n     * 두 축을 한 칸에 섞은 것이 원인이다:\n     *   `status`      **연결 설정이 성립하나** — 접속 시험·마스터 동기가 정하는 축(재부착의 자격이다)\n     *   읽기 실패      **지금 닿나** — 오갈 수 있는 사실이고, 유입 장부가 그 축을 갖는다\n     *\n     * 그러니 여기서는 `lastError` 에만 적는다(사람이 목록에서 이유를 볼 수 있게). 「지금 닿나」는\n     * `ingestHealth().readFailure` 가 답하고, 성공한 주기가 그것을 지운다.\n     */\n    onReadFailure: ({ reason, stream, nextRetryMs }) => {\n      TwinEngine.recordIngestReadFailure(domainId, instanceId, reason, Date.now(), stream, nextRetryMs)\n      twinWarn(`[twin-live] \"${source}\": cannot read from the source${stream ? ` (${stream})` : ''} — ${reason}`)\n      repo\n        .update({ id: row.id }, { lastError: `live: ${reason}` } as any)\n        .catch(err => twinWarn(`[twin-live] \"${source}\": read failure not recorded — ${err?.message ?? err}`))\n    },\n    /*\n     * **끊겼다가 돌아왔다** — 그 사실을 장부에 남긴다 (2026-08-27).\n     *\n     * 실패 기록을 지우기만 하면 「끊긴 적이 있었다」가 화면에서 사라진다. 그러면 밤새 두 시간 끊겼던\n     * 연결과 한 번도 끊기지 않은 연결이 아침에 똑같이 보인다.\n     *\n     * `lastError` 도 함께 지운다 — 목록에 남은 옛 이유가 지금의 상태로 읽힌다.\n     */\n    onRecovered: ({ afterFailures, downMs }) => {\n      TwinEngine.recordIngestRecovered(domainId, instanceId, afterFailures, downMs, Date.now())\n      twinLog(\n        `[twin-live] \"${source}\": reading again after ${afterFailures} failed attempt(s) — it was out for ${Math.round(downMs / 1000)}s`\n      )\n      repo\n        .update({ id: row.id }, { lastError: null } as any)\n        .catch(err => twinWarn(`[twin-live] \"${source}\": recovery not recorded — ${err?.message ?? err}`))\n    },\n    /**\n     * **읽었는데 창을 넘길 수 없다** — 위와 조치가 반대인 사실이다 (2026-08-24).\n     *\n     * 이 문을 만들기 전에는 이 사실이 `onReadFailure` 로 나갔다. 그래서 화면이 「원본에 닿지 못한다」고\n     * 말했는데 실제로는 원본이 **답한** 상태였고, 그 답의 모양이 커서를 이긴 것이었다. 사람은 원본을\n     * 의심하고 기다리는데 기다림으로는 영원히 풀리지 않는다 — **원인을 반대 방향으로 가리켰다.**\n     *\n     * `status` 를 건드리지 않는 규율은 위와 같다(재부착의 자격이다). `lastError` 에는 적는다 — 목록에서\n     * 이유를 볼 수 있어야 하고, 「닿지 못한다」와 다른 문장이어야 한다.\n     */\n    /*\n     * **세우지 않은 것을 장부에 적는다** — 원본에 있는데 트윈에 세우지 않은 것(이유와 수).\n     *\n     * 로그로도 남기지만 **로그는 사람이 볼 때만 값이 있다.** 이 사실은 상태의 성질이라(세우지 않은 것은\n     * 지금도 없다) 조회되는 자리에 있어야 한다 — 그러지 않으면 프로비저닝 화면에서 한 번 스쳐 지나간다.\n     *\n     * `status`·`lastError` 를 건드리지 않는다: 이것은 **실패가 아니다.** 어댑터가 옳은 판단으로 안 받은\n     * 것이고, 오류로 적으면 화면이 원본을 의심하게 만든다.\n     */\n    onWithheld: ({ reason, count }) => {\n      TwinEngine.recordIngestWithheld(domainId, instanceId, reason, count)\n    },\n    onCursorStall: ({ reason, stream }) => {\n      TwinEngine.recordIngestCursorStall(domainId, instanceId, reason, Date.now(), stream)\n      twinWarn(\n        `[twin-live] \"${source}\": read the source but the cursor cannot advance` +\n          `${stream ? ` (${stream})` : ''} — ${reason}. Waiting will not clear this.`\n      )\n      repo\n        .update({ id: row.id }, { lastError: `live cursor stalled: ${reason}` } as any)\n        .catch(err => twinWarn(`[twin-live] \"${source}\": cursor stall not recorded — ${err?.message ?? err}`))\n    },\n    onCursor: next => {\n      /* 어댑터가 준 모양을 그대로 적는다 — 이 층은 흐름의 뜻을 모른다(열쇠는 어댑터가 정한다). */\n      repo\n        .update({ id: row.id }, { liveCursor: next } as any)\n        .catch(err => twinWarn(`[twin-live] \"${source}\": live cursor not saved — ${err?.message ?? err}`))\n    }\n  }\n}\n\n/** 라이브 피드 중지(unsubscribe). */\nexport function stopReferenceLiveFeed(instanceId: string): boolean {\n  const unsub = feeds.get(instanceId)\n  if (!unsub) return false\n  try { unsub() } catch { /* noop */ }\n  feeds.delete(instanceId)\n  return true\n}\n\n/** 활성 피드 목록(관측). */\nexport function listReferenceLiveFeeds(): string[] {\n  return [...feeds.keys()]\n}\n\n/**\n * 부팅 때 **끊어진 피드를 다시 붙인다** — 도는 미러 트윈에 계측이 계속 들어오게.\n *\n * ── 무엇이 알리지 않고 끊겼나 (2026-08-14) ───────────────────────────────────────\n * `startReferenceLiveFeed` 를 부르는 곳은 `importTwinReference` **하나뿐**이었다. 그래서 서버를 한 번\n * 재기동하면 미러 트윈은 「도는 중」이라 말하면서 아무 계측도 받지 않았다 — 오류도 로그도 없이,\n * 사람은 「값이 안 변하네」로 알게 된다. 실 배포에서 재기동 한 번에 계측이 멈추는 셈이다.\n *\n * ── 되살릴 재료는 이미 영속돼 있다 ─────────────────────────────────────────\n * `TwinReference` 가 어댑터 종류·접속 설정·그 레퍼런스가 만든 인스턴스(`scopeSpec.produced`)를 들고 있다.\n * 사이트 서술자만 없는데(`hint` 는 남기지 않았다) **다시 찾아서** 얻는다(`discoverSites`) — 인제스트가\n * 걷는 것과 같은 길이므로 규칙이 갈라지지 않는다. 되살릴 인스턴스가 없으면 그 호출도 하지 않는다.\n *\n * 재개 대상은 **등록부가 도는 미러라고 말하는 것**뿐이다: 멈춘 트윈을 되살리면 사람이 멈춘 것을\n * 우리가 다시 켜는 것이고, 시뮬 트윈에 실 계측을 부으면 두 현실이 섞인다.\n */\nexport async function resumeReferenceLiveFeeds(): Promise<{ resumed: string[]; failed: { instanceId: string; error: string }[] }> {\n  const resumed: string[] = []\n  const failed: { instanceId: string; error: string }[] = []\n  /*\n   * **한 트윈에 피드는 하나다** (2026-08-18).\n   *\n   * 같은 사이트를 두 레퍼런스가 각각 인제스트하면 둘 다 그 인스턴스를 자기가 만든 것(`produced`)으로\n   * 들고 있다. 기동 때 그 목록을 그대로 돌면 같은 트윈에 피드를 두 번 붙이는데, 붙이는 함수가 미러를\n   * 다시 세우므로(`startLive`) **먼저 쌓인 수요 구간이 리셋된다** — 실제로 그렇게 났다\n   * (로그: `reattached 2 feed(s): ems-plant-1, ems-plant-1`).\n   *\n   * 그러니 한 번만 붙이고, **두 레퍼런스가 같은 트윈을 주장한다는 사실은 말한다** — 알리지 않고 하나를\n   * 고르면 어느 접속이 그 트윈을 먹이고 있는지 아무도 모르게 된다.\n   */\n  const attached = new Map<string, string>() // instanceId → 먼저 붙인 레퍼런스\n  try {\n    const refs = await getRepository(TwinReference).find({ where: { status: 'connected' }, relations: ['domain'] })\n    for (const ref of refs) {\n      const domainId = (ref as any).domain?.id ?? (ref as any).domainId\n      const adapter = getAdapter(ref.adapterType)\n      if (!domainId || !adapter?.openLiveFeed) continue // 관측만 하는 어댑터에는 되살릴 피드가 없다\n\n      const produced: any[] = ((ref.scopeSpec as any)?.produced ?? []).filter((p: any) => p?.instanceId && p?.siteId)\n      if (!produced.length) continue\n\n      /* 등록부가 「도는 미러」라고 말하는 것만 고른다. */\n      const rows = await getRepository(TwinInstance).find({\n        where: produced.map((p: any) => ({ domain: { id: domainId }, instanceId: p.instanceId })) as any\n      })\n      const live = produced.filter((p: any) =>\n        rows.some(r => r.instanceId === p.instanceId && r.status === 'running' && r.restartPolicy === 'resync')\n      )\n      if (!live.length) continue\n\n      let sites: SiteDescriptor[]\n      try {\n        sites = await adapter.discoverSites(ref.connectionConfig ?? {})\n      } catch (e: any) {\n        /* 원 시스템이 아직 안 떴을 수 있다 — 지어내지 않고 그렇게 적는다(트윈은 계속 「도는 미러」다). */\n        for (const p of live) failed.push({ instanceId: p.instanceId, error: `discover failed: ${e?.message ?? 'unknown'}` })\n        continue\n      }\n\n      for (const p of live) {\n        const site = sites.find(s => s.siteId === p.siteId)\n        if (!site) {\n          failed.push({ instanceId: p.instanceId, error: `site \"${p.siteId}\" no longer discoverable` })\n          continue\n        }\n        const owner = attached.get(p.instanceId)\n        if (owner) {\n          /* 두 접속이 같은 트윈을 주장한다 — 먼저 붙은 것을 지키고, 그 사실을 남긴다(둘 다 붙이면 미러가 리셋된다). */\n          failed.push({\n            instanceId: p.instanceId,\n            error: `also claimed by reference \"${ref.source}\" — kept the feed from \"${owner}\" (two connections feeding one twin would reset the mirror)`\n          })\n          continue\n        }\n        attached.set(p.instanceId, ref.source)\n        try {\n          const ok = await startReferenceLiveFeed(domainId, ref.adapterType, ref.connectionConfig ?? {}, site, p.instanceId, ref.source)\n          if (ok) resumed.push(p.instanceId)\n          else failed.push({ instanceId: p.instanceId, error: 'adapter has no openLiveFeed' })\n        } catch (e: any) {\n          failed.push({ instanceId: p.instanceId, error: e?.message ?? 'reattach failed' })\n        }\n      }\n    }\n  } catch (e: any) {\n    twinError('[twin-live] feed resume scan failed', e?.message)\n  }\n\n  if (resumed.length) twinLog(`[twin-live] reattached ${resumed.length} feed(s): ${resumed.join(', ')}`)\n  /* **알리지 않고 넘기지 않는다** — 붙지 않은 미러는 「도는데 아무것도 오지 않는」 트윈이다. */\n  for (const f of failed) twinWarn(`[twin-live] \"${f.instanceId}\" feed NOT reattached — ${f.error}`)\n  return { resumed, failed }\n}\n\n/*\n * 이 계층의 피드 장부를 등록한다 — 화면이 「끊김」을 말할 근거는 **묻는 자리 하나**여야 한다.\n * (프리셋 기반 피드는 앱이 자기 장부를 따로 등록한다. 한쪽만 보면 흐르는 트윈을 끊겼다고 부른다.)\n */\nregisterLiveFeedProbe(() => [...feeds.keys()])\n\n/* 인스턴스 정지 시 피드 자동 정리(생명주기 대칭). */\nTwinEngine.onStop(instanceId => stopReferenceLiveFeed(instanceId))\n"]}

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

@@ -1 +0,0 @@
-{"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'\nimport { partitionLensLocations } 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  /*\n   * **렌즈는 자기 영역의 자리만 세운다**(ADR-0081 보탬). 다른 영역의 자리는 참조로만 들고 종류를 검사하지 않는다 — 창고 트윈이\n   * plant 의 조립 라인 자리를 「종류를 모르는 자리」로 경고하던 것이 이 줄이다. 구역(`area`)은 현장이 함께 쓰므로 가르지 않는다.\n   */\n  const lens = partitionLensLocations(\n    master.locations.filter(l => l.role === 'location' || l.role === 'both'),\n    master.system\n  )\n  const locationEntries = lens.own\n  const referencedLocations = lens.referenced\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    ...(referencedLocations.length ? { referencedLocations } : {}),\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-server/service/reference/reference-probe.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"reference-probe.js","sourceRoot":"","sources":["../../../server/service/reference/reference-probe.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReferenceAdapter, SiteDescriptor } from './reference-adapter.js'\nimport type { ReferenceMaster } from './reference-master.js'\nimport { capabilitiesOf } from './reference-adapter.js'\nimport { REFERENCE_STEPS, type ReferenceStep } from './reference-progress.js'\n\n/*\n * **커넥터 점검 하네스** — 실 원본에 붙여 「무엇이 채워지고 무엇이 비는가」를 한 번에 본다.\n *\n * ── 왜 필요한가 (2026-08-21) ────────────────────────────────────────────────\n * chef v1 커넥터를 만들 때 실 인스턴스(포천)에 붙이는 확인을 매번 손으로 했다 — curl 로 필드를 묻고,\n * 일회용 스크립트로 마스터를 읽고, 결과를 눈으로 셌다. 그 방식은 세 가지를 잃는다:\n *  · 같은 확인을 다음 커넥터에서 처음부터 다시 만든다.\n *  · 무엇을 확인했는지가 어디에도 남지 않는다.\n *  · **앱을 띄워야 알 수 있는 것**이 되어 버린다 — dev 서버가 남의 것이면 확인 자체가 막힌다.\n *\n * 그래서 어댑터 규약만 아는 자리에 둔다. 어댑터는 `testConnection` · `discoverSites` · `fetchMaster` ·\n * `openLiveFeed` 를 갖는 객체이고, 그 넷을 순서대로 부르는 일에 커넥터별 지식이 필요하지 않다.\n *\n * ── 무엇을 하지 않는가 ──────────────────────────────────────────────────────\n *  · **판단하지 않는다.** 「합격」을 매기지 않고 센 것을 그대로 낸다 — 무엇이 충분한지는 커넥터마다\n *    다르고, 그 판단은 체크리스트 문서가 한다.\n *  · **저장하지 않는다.** 트윈을 만들지도, 커서를 남기지도 않는다. 원본을 읽기만 한다.\n *  · **라이브는 부르지 않는 것이 기본이다.** 첫 주기는 전량 읽기이므로 실 운영 원본에 부담이 된다\n *    (포천은 로트 99,095 · 투입 290,688 · 재고 141,358건이다). 부를 때는 호출부가 명시한다.\n */\n\n/** 마스터 한 벌에서 센 것 — 커넥터와 무관한 자리 이름으로만 센다. */\nexport interface MasterCounts {\n  locations: number\n  areas: number\n  equipment: number\n  materialDefinitions: number\n  operations: number\n  /** 생산 선언이 없으면 `undefined` — 0 과 구별한다(선언 자체가 없는 것과 비어 있는 것은 다르다). */\n  materials?: number\n  materialsWithHome?: number\n  routes?: number\n  recipes?: number\n  recipesWithRoute?: number\n  locationTypes?: number\n  resourceTypes?: number\n}\n\nexport interface ProbeStep {\n  key: ReferenceStep | string\n  detail?: string\n  /** 그 단계가 끝난 시각까지 걸린 밀리초 — 어느 단계가 느린지 보이게 한다. */\n  elapsedMs: number\n}\n\nexport interface ProbeReport {\n  adapter: string\n  /** 어댑터가 선언하고 **구현까지 있는** 능력. 선언만 있는 것은 여기 나오지 않는다. */\n  capabilities: string[]\n  connection?: { ok: boolean; readiness?: string; notes?: string[]; error?: string }\n  sites?: { siteId: string; name?: string }[]\n  /** 사이트마다 한 벌 — 마스터는 사이트 단위다. */\n  masters: {\n    siteId: string\n    steps: ProbeStep[]\n    counts?: MasterCounts\n    warnings: string[]\n    space?: unknown\n    identity?: unknown\n    /** 표본 — 눈으로 확인할 몇 건. 전체를 싣지 않는다(원본이 수천 건이다). */\n    samples?: { recipes?: unknown[]; routes?: unknown[]; locations?: unknown[] }\n    elapsedMs: number\n    error?: string\n  }[]\n  /** 라이브를 부른 경우에만 — 한 주기가 낸 기록을 종류별로 센다. */\n  live?: { records: number; byShape: Record<string, number>; samples: unknown[]; elapsedMs: number; error?: string }\n  /** 선언한 단계 중 **한 번도 보고되지 않은** 것. 선언해 두고 보내지 않으면 화면의 진행이 멈춘 것처럼 보인다. */\n  silentSteps?: string[]\n  /** 선언하지 않은 이름으로 보고한 단계. 표준 낱말 밖의 값은 화면이 번역할 수 없다. */\n  unknownSteps?: string[]\n}\n\n/** 기록의 모양을 이름 붙인다 — 커널 낱말로만 가린다(커넥터를 알 필요가 없다). */\nfunction shapeOf(r: any): string {\n  if (r?.inputQuantityList || r?.outputQuantityList) return 'transformation'\n  if (r?.taskId) return 'task'\n  if (r?.orderId) return 'order'\n  if (r?.quantityList || r?.epcList) return 'observation'\n  return 'other'\n}\n\nfunction countMaster(ref: ReferenceMaster): MasterCounts {\n  const m: any = ref\n  const d = m.productionSpec?.definition\n  return {\n    locations: m.locations?.length ?? 0,\n    areas: (m.locations ?? []).filter((l: any) => l.role === 'area').length,\n    equipment: m.equipment?.length ?? 0,\n    materialDefinitions: m.materialDefinitions?.length ?? 0,\n    operations: m.operations?.length ?? 0,\n    ...(d\n      ? {\n          materials: d.materials?.length ?? 0,\n          materialsWithHome: (d.materials ?? []).filter((x: any) => x.locationType).length,\n          routes: d.routes?.length ?? 0,\n          recipes: d.recipes?.length ?? 0,\n          recipesWithRoute: (d.recipes ?? []).filter((x: any) => x.route).length,\n          locationTypes: d.locationTypes?.length ?? 0,\n          resourceTypes: d.resourceTypes?.length ?? 0\n        }\n      : {})\n  }\n}\n\nconst messageOf = (w: unknown): string => (typeof w === 'string' ? w : `${(w as any)?.code}: ${(w as any)?.message}`)\n\n/**\n * 사람이 읽는 줄로 자른다 — **자랐다는 사실을 함께 적는다.**\n *\n * 경고에 값 목록이 붙는다(어느 자리가 걸렀는지). 88건이면 UUID 88개가 한 줄에 쏟아져 보고를 읽을 수\n * 없게 된다. 그래서 사람용 출력에서만 자르고, 전체는 보고 객체(`--json`)에 그대로 남긴다.\n */\nconst brief = (text: string, max = 300): string =>\n  text.length <= max ? text : `${text.slice(0, max)}… (${text.length}자 중 앞 ${max}자 — 전체는 보고 객체에 있다)`\n\n/**\n * 어댑터 한 벌을 실 원본에 붙여 본다.\n *\n * 실패를 던지지 않는다 — **어디까지 갔는지가 보고의 내용**이다. 연결이 안 되면 그 사실이, 마스터가\n * 실패하면 어느 단계에서 실패했는지가 보고에 남는다(예외로 끝나면 그 정보가 사라진다).\n */\nexport async function probeReference(opts: {\n  adapter: ReferenceAdapter\n  config: any\n  /** 특정 사이트만 볼 때. 없으면 `discoverSites` 가 낸 전부. */\n  siteId?: string\n  /**\n   * 라이브 한 주기를 부를지. **기본은 부르지 않는다** — 첫 주기가 전량 읽기다.\n   * `waitMs` 만큼 기다린 뒤 멈춘다(주기가 끝나지 않았으면 그때까지 받은 것만 센다).\n   */\n  live?: { waitMs: number; sampleCount?: number }\n  /** 표본 건수 — 기본 3건. */\n  sampleCount?: number\n}): Promise<ProbeReport> {\n  const { adapter, config } = opts\n  const sampleCount = opts.sampleCount ?? 3\n  const report: ProbeReport = { adapter: adapter.type, capabilities: capabilitiesOf(adapter), masters: [] }\n\n  if (adapter.testConnection) {\n    try {\n      report.connection = (await adapter.testConnection(config)) as any\n    } catch (e: any) {\n      report.connection = { ok: false, error: e?.message ?? String(e) }\n    }\n    /* 연결이 안 되면 더 가지 않는다 — 그 뒤 실패는 모두 같은 원인의 반복이다. */\n    if (report.connection && report.connection.ok === false) return report\n  }\n\n  let sites: SiteDescriptor[] = []\n  try {\n    sites = adapter.discoverSites ? await adapter.discoverSites(config) : []\n  } catch (e: any) {\n    report.sites = []\n    report.masters.push({ siteId: '(사이트를 찾지 못했다)', steps: [], warnings: [], elapsedMs: 0, error: e?.message ?? String(e) })\n    return report\n  }\n  if (opts.siteId) sites = sites.filter(s => s.siteId === opts.siteId)\n  report.sites = sites.map(s => ({ siteId: s.siteId, name: s.name }))\n\n  const declared = new Set<string>(adapter.masterSteps ?? [])\n  const reported = new Set<string>()\n  const unknown = new Set<string>()\n\n  for (const site of sites) {\n    const t0 = Date.now()\n    const steps: ProbeStep[] = []\n    try {\n      const ref = await adapter.fetchMaster!(config, site, s => {\n        reported.add(String(s.key))\n        if (!(REFERENCE_STEPS as readonly string[]).includes(String(s.key))) unknown.add(String(s.key))\n        steps.push({ key: s.key, detail: s.detail, elapsedMs: Date.now() - t0 })\n      })\n      const m: any = ref\n      const d = m.productionSpec?.definition\n      report.masters.push({\n        siteId: site.siteId,\n        steps,\n        counts: countMaster(ref),\n        warnings: (m.warnings ?? []).map(messageOf),\n        space: m.space,\n        identity: m.identity,\n        samples: {\n          recipes: (d?.recipes ?? []).slice(0, sampleCount),\n          routes: (d?.routes ?? []).slice(0, sampleCount),\n          locations: (m.locations ?? []).slice(0, sampleCount)\n        },\n        elapsedMs: Date.now() - t0\n      })\n    } catch (e: any) {\n      /* 어느 단계까지 갔는지를 남긴다 — 그것이 다음에 볼 자리다. */\n      report.masters.push({ siteId: site.siteId, steps, warnings: [], elapsedMs: Date.now() - t0, error: e?.message ?? String(e) })\n    }\n  }\n\n  const silent = [...declared].filter(s => !reported.has(s))\n  if (silent.length) report.silentSteps = silent\n  if (unknown.size) report.unknownSteps = [...unknown]\n\n  if (opts.live && adapter.openLiveFeed && sites.length) {\n    const t0 = Date.now()\n    const got: unknown[] = []\n    try {\n      const stop = adapter.openLiveFeed(config, sites[0], rs => got.push(...rs))\n      await new Promise(r => setTimeout(r, opts.live.waitMs))\n      stop()\n      const byShape: Record<string, number> = {}\n      for (const r of got) byShape[shapeOf(r)] = (byShape[shapeOf(r)] ?? 0) + 1\n      report.live = {\n        records: got.length,\n        byShape,\n        samples: got.slice(0, opts.live.sampleCount ?? sampleCount),\n        elapsedMs: Date.now() - t0\n      }\n    } catch (e: any) {\n      report.live = { records: got.length, byShape: {}, samples: [], elapsedMs: Date.now() - t0, error: e?.message ?? String(e) }\n    }\n  }\n\n  return report\n}\n\n/** 보고를 사람이 읽는 줄로 — 화면이 아니라 터미널·로그가 읽는다. */\nexport function formatProbeReport(r: ProbeReport): string {\n  const out: string[] = []\n  out.push(`커넥터 ${r.adapter} · 능력 ${r.capabilities.length ? r.capabilities.join(',') : '(없음)'}`)\n  if (r.connection) {\n    out.push(`연결 ${r.connection.ok ? 'ok' : '실패'}${r.connection.readiness ? ` · 읽기준비 ${r.connection.readiness}` : ''}`)\n    for (const n of r.connection.notes ?? []) out.push(`  · ${brief(n)}`)\n    if (r.connection.error) out.push(`  · ${r.connection.error}`)\n  }\n  for (const m of r.masters) {\n    out.push(`사이트 ${m.siteId} — ${(m.elapsedMs / 1000).toFixed(1)}초`)\n    for (const s of m.steps) out.push(`  [${(s.elapsedMs / 1000).toFixed(1)}s] ${s.key}${s.detail ? ` — ${s.detail}` : ''}`)\n    if (m.error) out.push(`  실패: ${m.error}`)\n    if (m.counts) {\n      const c = m.counts\n      out.push(\n        `  로케이션 ${c.locations}(존 ${c.areas}) · 설비 ${c.equipment} · 자재정의 ${c.materialDefinitions} · 공정 ${c.operations}`\n      )\n      if (c.materials !== undefined) {\n        out.push(\n          `  선언자재 ${c.materials}(보관 로케이션 있는 것 ${c.materialsWithHome}) · 경로 ${c.routes} · 레시피 ${c.recipes}(경로 붙은 것 ${c.recipesWithRoute})`\n        )\n      } else {\n        out.push('  생산 선언 없음 — 레시피가 하나도 성립하지 않았다')\n      }\n    }\n    for (const w of m.warnings) out.push(`  경고 ${brief(w)}`)\n  }\n  if (r.silentSteps?.length) out.push(`선언했으나 보고되지 않은 단계: ${r.silentSteps.join(', ')}`)\n  if (r.unknownSteps?.length) out.push(`표준 낱말 밖의 단계 이름: ${r.unknownSteps.join(', ')}`)\n  if (r.live) {\n    out.push(\n      `라이브 한 주기 — 기록 ${r.live.records}건 (${Object.entries(r.live.byShape).map(([k, v]) => `${k} ${v}`).join(' · ') || '없음'}) · ${(r.live.elapsedMs / 1000).toFixed(1)}초`\n    )\n    if (r.live.error) out.push(`  실패: ${r.live.error}`)\n  }\n  return out.join('\\n')\n}\n"]}

package/dist-server/service/reference/reference-progress-channel.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"reference-progress-channel.js","sourceRoot":"","sources":["../../../server/service/reference/reference-progress-channel.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AASH,4DAGC;AAGD,0DAGC;AAhBY,QAAA,wBAAwB,GAAG,yBAAyB,CAAA;AAOjE,SAAgB,wBAAwB,CAA+B,QAAgB,EAAE,OAAU;IACjG,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,6FAA6F,CAAC,CAAA;IAC7H,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,OAAO,EAAE,CAAA;AACrD,CAAC;AAED,0DAA0D;AAC1D,SAAgB,uBAAuB,CAAC,QAAgB,EAAE,MAAc;IACtE,OAAO,CAAC,CAAuC,EAAW,EAAE,CAC1D,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,qBAAqB,EAAE,MAAM,KAAK,MAAM,CAAA;AAChF,CAAC","sourcesContent":["/*\n * The `twin-reference-progress` channel — **progress says whose import it is, and the filter asks.** Pure.\n *\n * The subscription filtered on `source` alone and checked only that the caller had some domain, so\n * anyone who knew a source name — and names like `sap-ewm-1710` are shared between tenants — received\n * another tenant's import progress, including its failure text. Same fix and same rule as\n * `engine/twin-state-channel.ts`.\n */\n\nexport const REFERENCE_PROGRESS_TOPIC = 'twin-reference-progress'\n\nexport interface ReferenceProgressPayload<M extends { source: string } = { source: string }> {\n  domainId: string\n  twinReferenceProgress: M\n}\n\nexport function referenceProgressPayload<M extends { source: string }>(domainId: string, message: M): ReferenceProgressPayload<M> {\n  if (!domainId) throw new Error('referenceProgressPayload: domainId is required — import progress always belongs to a tenant')\n  return { domainId, twinReferenceProgress: message }\n}\n\n/** Passes only this tenant's progress for this source. */\nexport function referenceProgressFilter(domainId: string, source: string) {\n  return (p: ReferenceProgressPayload | undefined): boolean =>\n    !!p && p.domainId === domainId && p.twinReferenceProgress?.source === source\n}\n"]}

package/dist-server/service/reference/reference-progress-subscription.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"reference-progress-subscription.js","sourceRoot":"","sources":["../../../server/service/reference/reference-progress-subscription.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * 유입 진행 구독 — **트윈을 만드는 동안 무엇을 하고 있는지 화면이 안다.**\n *\n * 마스터 읽기는 원본에 여러 질의를 보내는 긴 작업이고, 그 사이 화면은 아무것도 알 수 없었다. 단계를\n * 아는 것은 어댑터뿐이므로 어댑터가 **표준 낱말**로 말하고(`REFERENCE_STEPS`) 호스트가 자기 두 단계를\n * 더해 이 채널로 흘린다.\n *\n * 낱말이 표준이므로 화면은 **단계마다 번역 하나**만 두면 모든 커넥터를 보여 준다.\n */\nimport { Arg, Field, Int, ObjectType, Resolver, Root, Subscription } from 'type-graphql'\nimport { assertDomainSubscribeAllowed, getRepository, pubsub } from '@things-factory/shell'\nimport { filter, pipe } from 'graphql-yoga'\n\nimport { REFERENCE_STEPS } from './reference-progress.js'\nimport { REFERENCE_PROGRESS_TOPIC, referenceProgressFilter, type ReferenceProgressPayload } from './reference-progress-channel.js'\nimport { TwinReference } from './twin-reference.js'\n\n@ObjectType({ description: 'One step of progress while a reference is being imported into twins.' })\nexport class TwinReferenceProgressMessage {\n  @Field({ description: 'Which reference (source) this belongs to.' })\n  source: string\n\n  @Field({ description: 'Which site is being built.' })\n  siteId: string\n\n  @Field({ description: `Standard step name — one of: ${REFERENCE_STEPS.join(' | ')}.` })\n  step: string\n\n  @Field(type => Int, { description: 'Steps finished for this site.' })\n  done: number\n\n  @Field(type => Int, {\n    nullable: true,\n    description: 'Total steps for this site. Absent when the adapter did not declare its steps — the UI then shows no percentage rather than inventing one.'\n  })\n  total?: number\n\n  @Field(type => Int, { description: 'Index of the site being built (0-based).' })\n  siteIndex: number\n\n  @Field(type => Int, { description: 'How many sites are being built.' })\n  siteCount: number\n\n  @Field({ nullable: true, description: 'A fact within the step, such as how many rows were read.' })\n  detail?: string\n\n  @Field({ nullable: true, description: 'True when this step failed. The UI keeps the progress panel and marks this step.' })\n  failed?: boolean\n\n  @Field({ nullable: true, description: 'Why it failed. Present only on failure.' })\n  error?: string\n}\n\n@Resolver()\nexport class TwinReferenceProgressSubscription {\n  @Subscription(returns => TwinReferenceProgressMessage, {\n    /*\n     * Tenancy is asked twice (2026-09-24): the source must be one of the caller's references, and every\n     * message must be the caller's domain's. It used to filter on `source` alone after checking only that\n     * the caller had a domain — and source names are shared between tenants.\n     */\n    subscribe: async ({ args, context }) => {\n      const { source } = args\n      const { domain, user } = (context as any)?.state ?? {}\n      await assertDomainSubscribeAllowed(domain, user, (d, u) => process.superUserGranted(d, u))\n      const owned = await getRepository(TwinReference).findOne({ where: { domain: { id: domain.id }, source } })\n      if (!owned) throw new Error(`reference not found in this tenant: ${source}`)\n      return pipe(pubsub.subscribe(REFERENCE_PROGRESS_TOPIC), filter(referenceProgressFilter(domain.id, source)))\n    },\n    description: 'Progress while importing a reference — standard step names, so one translation per step covers every connector.'\n  })\n  twinReferenceProgress(\n    @Root() payload: ReferenceProgressPayload<TwinReferenceProgressMessage>,\n    @Arg('source') source: string\n  ): TwinReferenceProgressMessage {\n    return payload.twinReferenceProgress\n  }\n}\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"reference-progress.js","sourceRoot":"","sources":["../../../server/service/reference/reference-progress.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAsEH,4CAKC;AAzED;;;GAGG;AACU,QAAA,eAAe,GAAG;IAC7B,mDAAmD;IACnD,QAAQ;IACR,0BAA0B;IAC1B,OAAO;IACP,+BAA+B;IAC/B,WAAW;IACX,kBAAkB;IAClB,WAAW;IACX,sBAAsB;IACtB,YAAY;IACZ,qBAAqB;IACrB,WAAW;IACX,mBAAmB;IACnB,QAAQ;IACR,oBAAoB;IACpB,SAAS;IACT,6BAA6B;IAC7B,oBAAoB;IACpB,UAAU;IACV,SAAS;IACT,YAAY;IACZ,QAAQ;IACR,gDAAgD;IAChD,WAAW;IACX,UAAU;IACV,OAAO;CACC,CAAA;AAIV,uDAAuD;AAC1C,QAAA,UAAU,GAAoB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;AA2BjE;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,CAAoB;IACnD,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC;QAAE,OAAO,SAAS,CAAA;IAClE,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,CAAA;IAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAA;IAClD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,CAAC,CAAA;AACrE,CAAC","sourcesContent":["/*\n * 유입 진행 단계 — **모든 커넥터가 같은 낱말로 말한다.**\n *\n * ── 왜 표준화하나 (2026-08-21) ──────────────────────────────────────────────\n * 마스터 읽기는 원본에 여러 질의를 보내는 긴 작업이고, 그 사이 화면은 아무것도 알 수 없었다. 커넥터마다\n * 자기 낱말로 말하게 두면 화면이 커넥터 수만큼 문구를 알아야 하고, 새 커넥터가 생기면 화면에 낯선 글자가\n * 나온다.\n *\n * 그래서 낱말을 고정한다. 그리고 그 낱말은 **트윈의 자리 이름**이다 — 커넥터가 지금 채우는 자리가 곧\n * 지금 하는 일이다(`design/integration/connector-checklist.md` 의 마스터 축과 같은 이름).\n *\n * 그러면 셋이 함께 얻어진다.\n *  · 화면은 **단계마다 하나의 번역**만 두면 모든 커넥터를 보여 준다.\n *  · 사람은 원본이 달라도 **같은 말로** 진행을 읽는다.\n *  · 실패했을 때 「어느 자리를 읽다 실패했다」가 곧 「트윈의 무엇이 비었다」가 된다.\n *\n * ── 퍼센트를 만들려면 분모가 있어야 한다 ────────────────────────────────────\n * 어댑터가 **자기가 보낼 단계를 미리 선언**한다(`ReferenceAdapter.masterSteps`). 그것이 분모다. 선언하지\n * 않으면 화면은 퍼센트를 보이지 않고 단계 이름만 보인다 — **모르는 진행률을 지어내지 않는다.**\n */\n\n/**\n * 표준 단계. 순서는 대개 이 차례이지만 **강제하지 않는다** — 원본에 따라 없는 자리가 있고, 그때는 그\n * 단계를 선언하지도 보내지도 않는다.\n */\nexport const REFERENCE_STEPS = [\n  /** 원본 스키마 확인 — 무엇을 물을 수 있는지 먼저 본다(버전이 다를 수 있다). */\n  'schema',\n  /** 공간·좌표 — 자리가 놓일 좌표계. */\n  'space',\n  /** 자리 — 물건이 놓이고 작업이 일어나는 곳. */\n  'locations',\n  /** 설비 — 일하는 것. */\n  'equipment',\n  /** 공정 — 무슨 일을 하는가. */\n  'operations',\n  /** 자재 — 무엇이 흐르는가. */\n  'materials',\n  /** 경로 — 공정의 순서. */\n  'routes',\n  /** 레시피 — 투입과 산출. */\n  'recipes',\n  /** 시험 명세 — 무엇을 어떻게 검사하는가. */\n  'testSpecifications',\n  /** 인원. */\n  'persons',\n  /** 물리자산. */\n  'assets',\n  /** 트윈 생성 — 여기부터는 호스트가 하는 일이다(어댑터가 선언하지 않는다). */\n  'provision',\n  /** 기동. */\n  'start'\n] as const\n\nexport type ReferenceStep = (typeof REFERENCE_STEPS)[number]\n\n/** 호스트가 마스터 읽기 뒤에 하는 단계 — 어댑터의 선언에 이만큼을 더해 분모를 만든다. */\nexport const HOST_STEPS: ReferenceStep[] = ['provision', 'start']\n\n/**\n * 한 단계의 진행 — 구독으로 흐르는 메시지의 몸통.\n *\n * `detail` 은 **그 단계 안에서 사람이 알아야 하는 것**이다(읽은 건수 등). 비어 있어도 된다 — 지어내지\n * 않는다.\n */\nexport interface ReferenceProgress {\n  /** 어느 사이트를 만드는 중인가. */\n  siteId: string\n  step: ReferenceStep\n  /** 이 사이트에서 끝낸 단계 수. */\n  done: number\n  /** 이 사이트의 전체 단계 수 — 어댑터가 선언하지 않으면 없다(그때 퍼센트를 만들지 않는다). */\n  total?: number\n  /** 여러 사이트를 한 번에 만들 때, 지금 몇 번째인가. */\n  siteIndex: number\n  siteCount: number\n  /** 그 단계 안의 사실 — 「자리 128건」처럼. */\n  detail?: string\n  /** 이 단계에서 실패했는가. 실패해도 화면이 그 자리를 그대로 보여 줄 수 있어야 한다. */\n  failed?: boolean\n  /** 실패 이유 — 실패했을 때만. */\n  error?: string\n}\n\n/**\n * 전체 진행률 — **분모를 알 때만 낸다.**\n *\n * 사이트가 여럿이면 사이트 사이의 진행도 함께 센다: 앞선 사이트는 끝난 것으로 본다.\n */\nexport function referencePercent(p: ReferenceProgress): number | undefined {\n  if (!p.total || p.total <= 0 || p.siteCount <= 0) return undefined\n  const perSite = 1 / p.siteCount\n  const within = Math.min(p.done, p.total) / p.total\n  return Math.round((p.siteIndex * perSite + within * perSite) * 100)\n}\n"]}

package/dist-server/service/reference/reference-reconciliation-query.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"reference-reconciliation-query.js","sourceRoot":"","sources":["../../../server/service/reference/reference-reconciliation-query.ts"],"names":[],"mappings":";;;;AAAA,+CAAwD;AACxD,iDAAqD;AACrD,yFAAgF;AAGzE,IAAM,gCAAgC,GAAtC,MAAM,gCAAgC;IAErC,AAAN,KAAK,CAAC,4BAA4B,CACb,UAAkB,EAC9B,OAAwB;QAE/B,OAAO,IAAA,qBAAa,EAAC,8DAA2B,CAAC,CAAC,IAAI,CAAC;YACrD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE;YAC9D,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;SACxB,CAAC,CAAA;IACJ,CAAC;IAGK,AAAN,KAAK,CAAC,2BAA2B,CACZ,UAAkB,EACvB,KAAa,EACpB,OAAwB;QAE/B,OAAO,IAAA,qBAAa,EAAC,8DAA2B,CAAC,CAAC,OAAO,CAAC;YACxD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE;SACtE,CAAC,CAAA;IACJ,CAAC;CACF,CAAA;AAtBY,4EAAgC;AAErC;IADL,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,CAAC,8DAA2B,CAAC,EAAE,EAAE,WAAW,EAAE,6JAA6J,EAAE,CAAC;IAE7N,mBAAA,IAAA,kBAAG,EAAC,YAAY,CAAC,CAAA;IACjB,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;oFAMP;AAGK;IADL,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,8DAA2B,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,4KAA4K,EAAE,CAAC;IAE1P,mBAAA,IAAA,kBAAG,EAAC,YAAY,CAAC,CAAA;IACjB,mBAAA,IAAA,kBAAG,EAAC,OAAO,CAAC,CAAA;IACZ,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;mFAKP;2CArBU,gCAAgC;IAD5C,IAAA,uBAAQ,GAAE;GACE,gCAAgC,CAsB5C","sourcesContent":["import { Arg, Ctx, Query, Resolver } from 'type-graphql'\nimport { getRepository } from '@things-factory/shell'\nimport { TwinReferenceReconciliation } from './twin-reference-reconciliation.js'\n\n@Resolver()\nexport class TwinReferenceReconciliationQuery {\n  @Query(returns => [TwinReferenceReconciliation], { description: 'All latest durable sequence reconciliations for one Twin. An empty list means no numbered source range has been read yet, not that every source is aligned.' })\n  async twinReferenceReconciliations(\n    @Arg('instanceId') instanceId: string,\n    @Ctx() context: ResolverContext\n  ): Promise<TwinReferenceReconciliation[]> {\n    return getRepository(TwinReferenceReconciliation).find({\n      where: { domain: { id: context.state.domain.id }, instanceId },\n      order: { scope: 'ASC' }\n    })\n  }\n\n  @Query(returns => TwinReferenceReconciliation, { nullable: true, description: 'Latest durable source-range versus Twin-cursor reconciliation for one numbered scope. Null means no backfill has yet obtained a source range; it is not an aligned result.' })\n  async twinReferenceReconciliation(\n    @Arg('instanceId') instanceId: string,\n    @Arg('scope') scope: string,\n    @Ctx() context: ResolverContext\n  ): Promise<TwinReferenceReconciliation | null> {\n    return getRepository(TwinReferenceReconciliation).findOne({\n      where: { domain: { id: context.state.domain.id }, instanceId, scope }\n    })\n  }\n}\n"]}

package/dist-server/service/reference/reference-reconciliation-writer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"reference-reconciliation-writer.js","sourceRoot":"","sources":["../../../server/service/reference/reference-reconciliation-writer.ts"],"names":[],"mappings":";;AAKA,sEAgCC;AArCD,iDAAqD;AACrD,yFAAgF;AAChF,+EAA+F;AAE/F,kDAAkD;AAC3C,KAAK,UAAU,6BAA6B,CAAC,IAOnD;IACC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,IAAI,CAAA;IAClF,IAAI,CAAC,WAAW;QAAE,OAAM;IACxB,MAAM,OAAO,GAAG,IAAA,wDAA0B,EAAC,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAA;IAC5F,MAAM,IAAI,GAAG,IAAA,qBAAa,EAAC,8DAA2B,CAAC,CAAA;IACvD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC,CAAA;IAC/F,MAAM,IAAI,CAAC,IAAI,CACb,IAAI,CAAC,MAAM,CAAC;QACV,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;QACnB,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAS;QAC/B,UAAU;QACV,KAAK;QACL,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB;gDACwC;QACxC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;QACxC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;QACtC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;QAC1C,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;QACxC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,SAAS,EAAE,IAAI,IAAI,EAAE;KACtB,CAAC,CACH,CAAA;AACH,CAAC","sourcesContent":["import { getRepository } from '@things-factory/shell'\nimport { TwinReferenceReconciliation } from './twin-reference-reconciliation.js'\nimport { reconcileReferenceSequence, type ReferenceRange } from './reference-reconciliation.js'\n\n/** backfill이 원본 범위를 실제로 읽은 뒤에만 최신 대사 상태를 갱신한다. */\nexport async function recordReferenceReconciliation(args: {\n  domainId: string\n  instanceId: string\n  scope: string\n  sourceRange?: ReferenceRange\n  cursorSeq?: number\n  firstSeqSeen?: number\n}): Promise<void> {\n  const { domainId, instanceId, scope, sourceRange, cursorSeq, firstSeqSeen } = args\n  if (!sourceRange) return\n  const verdict = reconcileReferenceSequence({ source: sourceRange, cursorSeq, firstSeqSeen })\n  const repo = getRepository(TwinReferenceReconciliation)\n  const previous = await repo.findOne({ where: { domain: { id: domainId }, instanceId, scope } })\n  await repo.save(\n    repo.create({\n      ...(previous ?? {}),\n      domain: { id: domainId } as any,\n      instanceId,\n      scope,\n      status: verdict.status,\n      /* TypeORM은 undefined를 \"갱신하지 않음\"으로 읽는다. 현재 대사가 맞아진 뒤 옛 gap 수가\n       * 남지 않게 nullable 칸은 명시적으로 null로 지운다. */\n      sourceFirst: verdict.sourceFirst ?? null,\n      sourceLast: verdict.sourceLast ?? null,\n      cursorSeq: verdict.cursorSeq ?? null,\n      firstSeqSeen: verdict.firstSeqSeen ?? null,\n      headMissing: verdict.headMissing ?? null,\n      behind: verdict.behind ?? null,\n      reason: verdict.reason ?? null,\n      checkedAt: new Date()\n    })\n  )\n}\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"reference-reconciliation.js","sourceRoot":"","sources":["../../../server/service/reference/reference-reconciliation.ts"],"names":[],"mappings":";;AAoBA,gEAkCC;AAlCD,SAAgB,0BAA0B,CAAC,IAI1C;IACC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,IAAI,CAAA;IAChD,MAAM,WAAW,GAAG,MAAM,EAAE,KAAK,CAAA;IACjC,MAAM,UAAU,GAAG,MAAM,EAAE,IAAI,CAAA;IAC/B,MAAM,IAAI,GAAG,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,CAAA;IAEjE,IAAI,WAAW,KAAK,SAAS,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC1D,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,kCAAkC,EAAE,CAAA;IACnF,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,+BAA+B,EAAE,CAAA;IAChF,CAAC;IACD,IAAI,SAAS,GAAG,WAAW,EAAE,CAAC;QAC5B,OAAO;YACL,GAAG,IAAI;YACP,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,wDAAwD;SACjE,CAAA;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,CAAA;IAClD,8CAA8C;IAC9C,MAAM,WAAW,GAAG,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,GAAG,WAAW,CAAC,CAAA;IACpG,IAAI,MAAM,IAAI,WAAW,EAAE,CAAC;QAC1B,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;IAC3G,CAAC;IACD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,uCAAuC,EAAE,CAAA;IACxF,CAAC;IACD,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;AACvC,CAAC","sourcesContent":["/*\n * 원본 번호 범위와 Twin 커서를 맞춘 **현재 판정**이다.\n *\n * 이 계산은 봉투 수와 저널 행 수를 비교하지 않는다. 재전송과 backfill 때문에 그 둘은 같은\n * 사실을 여러 번 셀 수 있다. 여기서 답하는 것은 번호를 매기는 원본에서만 가능한, 더 좁고\n * 검증 가능한 질문이다: \"원본의 양 끝과 우리가 처음/마지막으로 받은 번호가 이어지는가?\"\n */\nexport type ReferenceRange = { first?: number; last?: number }\n\nexport type ReferenceReconciliation = {\n  sourceFirst?: number\n  sourceLast?: number\n  cursorSeq?: number\n  firstSeqSeen?: number\n  headMissing?: number\n  behind?: number\n  status: 'aligned' | 'gap' | 'unknown'\n  reason?: string\n}\n\nexport function reconcileReferenceSequence(args: {\n  source: ReferenceRange | undefined\n  cursorSeq?: number\n  firstSeqSeen?: number\n}): ReferenceReconciliation {\n  const { source, cursorSeq, firstSeqSeen } = args\n  const sourceFirst = source?.first\n  const sourceLast = source?.last\n  const base = { sourceFirst, sourceLast, cursorSeq, firstSeqSeen }\n\n  if (sourceFirst === undefined || sourceLast === undefined) {\n    return { ...base, status: 'unknown', reason: '원본이 번호 범위의 양 끝을 주지 않아 대사할 수 없습니다' }\n  }\n  if (cursorSeq === undefined) {\n    return { ...base, status: 'unknown', reason: 'Twin이 아직 이 단위의 번호를 받은 적이 없습니다' }\n  }\n  if (cursorSeq < sourceFirst) {\n    return {\n      ...base,\n      status: 'unknown',\n      reason: 'Twin 커서가 원본의 첫 번호보다 앞입니다. 원본 번호가 다시 매겨졌거나 다른 단위의 커서입니다'\n    }\n  }\n\n  const behind = Math.max(0, sourceLast - cursorSeq)\n  /* 처음 받은 번호를 적지 않았으면 앞머리는 \"없음\"이 아니라 \"모름\"이다. */\n  const headMissing = firstSeqSeen === undefined ? undefined : Math.max(0, firstSeqSeen - sourceFirst)\n  if (behind || headMissing) {\n    return { ...base, ...(behind ? { behind } : {}), ...(headMissing ? { headMissing } : {}), status: 'gap' }\n  }\n  if (firstSeqSeen === undefined) {\n    return { ...base, status: 'unknown', reason: '처음 받은 번호가 기록되지 않아 앞머리 연속성은 확인할 수 없습니다' }\n  }\n  return { ...base, status: 'aligned' }\n}\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"reference-registry.js","sourceRoot":"","sources":["../../../server/service/reference/reference-registry.ts"],"names":[],"mappings":";;AAQA,8CAEC;AACD,wCAEC;AACD,oCAEC;AAVD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAA;AAElD,SAAgB,iBAAiB,CAAC,MAAuB;IACvD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AACpC,CAAC;AACD,SAAgB,cAAc;IAC5B,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;AAC9B,CAAC;AACD,SAAgB,YAAY,CAAC,MAAc;IACzC,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;AAC5B,CAAC","sourcesContent":["/*\n * 레퍼런스 소스 레지스트리 — 호스트에 등록된 레퍼런스 마스터(가상 또는 실 어댑터)를 UI 가 열거·인제스트한다.\n * 앱(operato-twin)이 bootstrap 에서 자기 가상 레퍼런스를 register 하고, 실 배포는 실 시스템 어댑터를 register.\n */\nimport type { ReferenceMaster } from './reference-master.js'\n\nconst sources = new Map<string, ReferenceMaster>()\n\nexport function registerReference(master: ReferenceMaster): void {\n  sources.set(master.source, master)\n}\nexport function listReferences(): ReferenceMaster[] {\n  return [...sources.values()]\n}\nexport function getReference(source: string): ReferenceMaster | undefined {\n  return sources.get(source)\n}\n"]}