@things-factory/headless-twin 10.0.8 → 10.0.9

package/dist-server/engine/attention-digest.d.ts

@@ -0,0 +1,52 @@
+interface AttentionLike {
+    id?: string;
+    /** 어느 트윈(렌즈)에서 온 신호인가 — 공간에서 모을 때 붙는다. */
+    instanceId?: string;
+    severity?: string;
+    state?: string;
+    anchor?: {
+        locationId?: string;
+    };
+}
+export interface AttentionDigestResult {
+    /** 상위 N — 레일이 그리는 것. */
+    attentions: AttentionLike[];
+    /** 전체 개수 — 레일의 "N건 더" 가 이 값에서 나온다(자른 사실을 밝힌다). */
+    attentionTotal: number;
+    /**
+     * 자리별 최고 심각도 — **전량을 근거로** 접는다.
+     *
+     * 상위 N 만으로 접으면 20위 밖의 신호를 가진 자리가 색을 잃는다. 그것이 이 요약의 핵심 이유다:
+     * 레일은 잘라도 되지만 **지도 색은 잘라선 안 된다.**
+     */
+    severityByLocation: Record<string, string>;
+}
+/** 화면 정렬과 같은 순서 — 확인된 것은 아래로, 그다음 심각도 내림차순. */
+export declare const compareAttentions: (a: AttentionLike, b: AttentionLike) => number;
+/**
+ * 신호를 요약한다.
+ *
+ * `limit` 이 없거나 0 이하면 **자르지 않는다** — 자르는 쪽이 기본이면 이 값을 모르는 소비처가
+ * 조용히 일부만 받는다(요약을 도입하다 만드는 전형적인 사고다).
+ */
+export declare function digestAttentions(attentions: readonly AttentionLike[] | undefined | null, limit?: number): AttentionDigestResult;
+/** 렌즈 하나가 낸 신호 — 어느 트윈에서 왔는지와 함께. */
+export interface LensAttentions {
+    instanceId: string;
+    attentions: readonly AttentionLike[] | undefined | null;
+}
+/**
+ * 여러 렌즈의 신호를 **한 현장의 목록으로** 모은다.
+ *
+ * 한 공장에 WMS·MES·YMS 가 함께 있으므로 "이 현장에서 봐야 할 것" 은 렌즈 하나로 답할 수 없다.
+ * 모으면서 지키는 것 셋:
+ *
+ *  ① **어느 트윈에서 왔는지 붙인다**(`instanceId`) — 조치는 결국 그 트윈에 보내야 하고, 공간에서 보면
+ *     같은 자리 id 가 렌즈마다 다른 것을 가리킬 수 있다.
+ *  ② **순서는 렌즈 순서가 아니라 급한 순서다** — 앞 렌즈의 낮은 신호가 뒤 렌즈의 심각한 신호를
+ *     밀어내면, 상위 N 만 보는 화면에서 정작 급한 것이 안 보인다.
+ *  ③ **자리 색은 렌즈를 가로질러 가장 급한 것으로** 접는다 — 두 렌즈가 같은 자리를 가리키면 그 자리는
+ *     하나의 현실이므로 더 급한 쪽이 이긴다(둘 중 하나를 임의로 고르면 색이 렌즈 순서에 따라 달라진다).
+ */
+export declare function mergeLensAttentions(lenses: readonly LensAttentions[], limit?: number): AttentionDigestResult;
+export {};

package/dist-server/engine/attention-digest.js

@@ -0,0 +1,76 @@
+"use strict";
+/*
+ * 주의 신호 요약 — **순수**. "화면이 실제로 쓰는 두 가지만 값싸게 만든다."
+ *
+ * ── 왜 있나 (2026-08-05) ────────────────────────────────────────────────────
+ * 축 선택으로 리프레시를 80KB → 2KB 로 줄였는데, **신호가 많은 트윈은 거기서 막혔다**: `hatio-yard`
+ * 는 신호 397건이 108KB 라 5배 감소에 그쳤다. 그런데 화면이 그 397건으로 하는 일은 둘뿐이다.
+ *
+ *  ① 레일에 **20건**만 보여주고 나머지는 "N건 더" 라고만 말한다.
+ *  ② 자리(폴리곤)를 칠할 **자리별 최고 심각도**를 뽑는다 — 397건이 자리 7곳의 색 7개로 접힌다.
+ *
+ * 즉 전량을 내려보내 클라이언트가 접는 구조였다. 접는 것은 값싸므로 **서버가 접어서 보낸다.**
+ *
+ * ── 조용히 자르지 않는다 ────────────────────────────────────────────────────
+ * 잘랐다는 사실과 **전체 개수**를 함께 보낸다. 경고 목록에서 조용한 누락은 "괜찮은 줄 알았다" 로
+ * 이어진다 — 레일이 이미 "N건 더" 를 말하고 있었고, 그 N 은 전체 개수에서 나와야 맞다.
+ *
+ * ── 정렬을 한 곳에 둔다 ─────────────────────────────────────────────────────
+ * 상위 N 을 서버가 고르므로 **클라이언트와 같은 순서**여야 한다. 순서가 다르면 서버가 고른 20건이
+ * 화면이 고를 20건과 달라지고, 그 어긋남은 아무 데서도 오류로 드러나지 않는다.
+ * 순서 = 확인된 것은 아래로, 그다음 심각도 높은 것부터(클라이언트 정렬과 동일).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compareAttentions = void 0;
+exports.digestAttentions = digestAttentions;
+exports.mergeLensAttentions = mergeLensAttentions;
+/** 알람 표준(ISA-18.2) 우선순위 — 큰 값이 급하다. */
+const RANK = { low: 1, medium: 2, high: 3, critical: 4 };
+/** 화면 정렬과 같은 순서 — 확인된 것은 아래로, 그다음 심각도 내림차순. */
+const compareAttentions = (a, b) => (a.state === 'acknowledged' ? 1 : 0) - (b.state === 'acknowledged' ? 1 : 0) ||
+    (RANK[b.severity ?? ''] ?? 0) - (RANK[a.severity ?? ''] ?? 0);
+exports.compareAttentions = compareAttentions;
+/**
+ * 신호를 요약한다.
+ *
+ * `limit` 이 없거나 0 이하면 **자르지 않는다** — 자르는 쪽이 기본이면 이 값을 모르는 소비처가
+ * 조용히 일부만 받는다(요약을 도입하다 만드는 전형적인 사고다).
+ */
+function digestAttentions(attentions, limit) {
+    const all = Array.isArray(attentions) ? attentions : [];
+    /* 자리 색은 전량으로 접는다 — 잘린 뒤에 접으면 색을 잃는 자리가 생긴다. */
+    const severityByLocation = {};
+    for (const a of all) {
+        const nid = a?.anchor?.locationId;
+        if (!nid)
+            continue;
+        const cur = severityByLocation[nid];
+        if (!cur || (RANK[a.severity ?? ''] ?? 0) > (RANK[cur] ?? 0))
+            severityByLocation[nid] = a.severity ?? '';
+    }
+    const sorted = [...all].sort(exports.compareAttentions);
+    const capped = limit && limit > 0 ? sorted.slice(0, limit) : sorted;
+    return { attentions: capped, attentionTotal: all.length, severityByLocation };
+}
+/**
+ * 여러 렌즈의 신호를 **한 현장의 목록으로** 모은다.
+ *
+ * 한 공장에 WMS·MES·YMS 가 함께 있으므로 "이 현장에서 봐야 할 것" 은 렌즈 하나로 답할 수 없다.
+ * 모으면서 지키는 것 셋:
+ *
+ *  ① **어느 트윈에서 왔는지 붙인다**(`instanceId`) — 조치는 결국 그 트윈에 보내야 하고, 공간에서 보면
+ *     같은 자리 id 가 렌즈마다 다른 것을 가리킬 수 있다.
+ *  ② **순서는 렌즈 순서가 아니라 급한 순서다** — 앞 렌즈의 낮은 신호가 뒤 렌즈의 심각한 신호를
+ *     밀어내면, 상위 N 만 보는 화면에서 정작 급한 것이 안 보인다.
+ *  ③ **자리 색은 렌즈를 가로질러 가장 급한 것으로** 접는다 — 두 렌즈가 같은 자리를 가리키면 그 자리는
+ *     하나의 현실이므로 더 급한 쪽이 이긴다(둘 중 하나를 임의로 고르면 색이 렌즈 순서에 따라 달라진다).
+ */
+function mergeLensAttentions(lenses, limit) {
+    const all = [];
+    for (const lens of lenses) {
+        for (const a of lens.attentions ?? [])
+            all.push({ ...a, instanceId: lens.instanceId });
+    }
+    return digestAttentions(all, limit);
+}
+//# sourceMappingURL=attention-digest.js.map

package/dist-server/engine/attention-digest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attention-digest.js","sourceRoot":"","sources":["../../server/engine/attention-digest.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAuCH,4CAeC;AAqBD,kDAMC;AA/ED,uCAAuC;AACvC,MAAM,IAAI,GAA2B,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAA;AAyBhF,+CAA+C;AACxC,MAAM,iBAAiB,GAAG,CAAC,CAAgB,EAAE,CAAgB,EAAU,EAAE,CAC9E,CAAC,CAAC,CAAC,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;AAFlD,QAAA,iBAAiB,qBAEiC;AAE/D;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,UAAuD,EAAE,KAAc;IACtG,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAA;IAEvD,+CAA+C;IAC/C,MAAM,kBAAkB,GAA2B,EAAE,CAAA;IACrD,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,CAAC,EAAE,MAAM,EAAE,UAAU,CAAA;QACjC,IAAI,CAAC,GAAG;YAAE,SAAQ;QAClB,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAA;QACnC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAAE,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAA;IAC1G,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,yBAAiB,CAAC,CAAA;IAC/C,MAAM,MAAM,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;IACnE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAA;AAC/E,CAAC;AAQD;;;;;;;;;;;;GAYG;AACH,SAAgB,mBAAmB,CAAC,MAAiC,EAAE,KAAc;IACnF,MAAM,GAAG,GAAoB,EAAE,CAAA;IAC/B,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,IAAI,EAAE;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAmB,CAAC,CAAA;IACzG,CAAC;IACD,OAAO,gBAAgB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;AACrC,CAAC","sourcesContent":["/*\n * 주의 신호 요약 — **순수**. \"화면이 실제로 쓰는 두 가지만 값싸게 만든다.\"\n *\n * ── 왜 있나 (2026-08-05) ────────────────────────────────────────────────────\n * 축 선택으로 리프레시를 80KB → 2KB 로 줄였는데, **신호가 많은 트윈은 거기서 막혔다**: `hatio-yard`\n * 는 신호 397건이 108KB 라 5배 감소에 그쳤다. 그런데 화면이 그 397건으로 하는 일은 둘뿐이다.\n *\n *  ① 레일에 **20건**만 보여주고 나머지는 \"N건 더\" 라고만 말한다.\n *  ② 자리(폴리곤)를 칠할 **자리별 최고 심각도**를 뽑는다 — 397건이 자리 7곳의 색 7개로 접힌다.\n *\n * 즉 전량을 내려보내 클라이언트가 접는 구조였다. 접는 것은 값싸므로 **서버가 접어서 보낸다.**\n *\n * ── 조용히 자르지 않는다 ────────────────────────────────────────────────────\n * 잘랐다는 사실과 **전체 개수**를 함께 보낸다. 경고 목록에서 조용한 누락은 \"괜찮은 줄 알았다\" 로\n * 이어진다 — 레일이 이미 \"N건 더\" 를 말하고 있었고, 그 N 은 전체 개수에서 나와야 맞다.\n *\n * ── 정렬을 한 곳에 둔다 ─────────────────────────────────────────────────────\n * 상위 N 을 서버가 고르므로 **클라이언트와 같은 순서**여야 한다. 순서가 다르면 서버가 고른 20건이\n * 화면이 고를 20건과 달라지고, 그 어긋남은 아무 데서도 오류로 드러나지 않는다.\n * 순서 = 확인된 것은 아래로, 그다음 심각도 높은 것부터(클라이언트 정렬과 동일).\n */\n\n/** 알람 표준(ISA-18.2) 우선순위 — 큰 값이 급하다. */\nconst RANK: Record<string, number> = { low: 1, medium: 2, high: 3, critical: 4 }\n\ninterface AttentionLike {\n  id?: string\n  /** 어느 트윈(렌즈)에서 온 신호인가 — 공간에서 모을 때 붙는다. */\n  instanceId?: string\n  severity?: string\n  state?: string\n  anchor?: { locationId?: string }\n}\n\nexport interface AttentionDigestResult {\n  /** 상위 N — 레일이 그리는 것. */\n  attentions: AttentionLike[]\n  /** 전체 개수 — 레일의 \"N건 더\" 가 이 값에서 나온다(자른 사실을 밝힌다). */\n  attentionTotal: number\n  /**\n   * 자리별 최고 심각도 — **전량을 근거로** 접는다.\n   *\n   * 상위 N 만으로 접으면 20위 밖의 신호를 가진 자리가 색을 잃는다. 그것이 이 요약의 핵심 이유다:\n   * 레일은 잘라도 되지만 **지도 색은 잘라선 안 된다.**\n   */\n  severityByLocation: Record<string, string>\n}\n\n/** 화면 정렬과 같은 순서 — 확인된 것은 아래로, 그다음 심각도 내림차순. */\nexport const compareAttentions = (a: AttentionLike, b: AttentionLike): number =>\n  (a.state === 'acknowledged' ? 1 : 0) - (b.state === 'acknowledged' ? 1 : 0) ||\n  (RANK[b.severity ?? ''] ?? 0) - (RANK[a.severity ?? ''] ?? 0)\n\n/**\n * 신호를 요약한다.\n *\n * `limit` 이 없거나 0 이하면 **자르지 않는다** — 자르는 쪽이 기본이면 이 값을 모르는 소비처가\n * 조용히 일부만 받는다(요약을 도입하다 만드는 전형적인 사고다).\n */\nexport function digestAttentions(attentions: readonly AttentionLike[] | undefined | null, limit?: number): AttentionDigestResult {\n  const all = Array.isArray(attentions) ? attentions : []\n\n  /* 자리 색은 전량으로 접는다 — 잘린 뒤에 접으면 색을 잃는 자리가 생긴다. */\n  const severityByLocation: Record<string, string> = {}\n  for (const a of all) {\n    const nid = a?.anchor?.locationId\n    if (!nid) continue\n    const cur = severityByLocation[nid]\n    if (!cur || (RANK[a.severity ?? ''] ?? 0) > (RANK[cur] ?? 0)) severityByLocation[nid] = a.severity ?? ''\n  }\n\n  const sorted = [...all].sort(compareAttentions)\n  const capped = limit && limit > 0 ? sorted.slice(0, limit) : sorted\n  return { attentions: capped, attentionTotal: all.length, severityByLocation }\n}\n\n/** 렌즈 하나가 낸 신호 — 어느 트윈에서 왔는지와 함께. */\nexport interface LensAttentions {\n  instanceId: string\n  attentions: readonly AttentionLike[] | undefined | null\n}\n\n/**\n * 여러 렌즈의 신호를 **한 현장의 목록으로** 모은다.\n *\n * 한 공장에 WMS·MES·YMS 가 함께 있으므로 \"이 현장에서 봐야 할 것\" 은 렌즈 하나로 답할 수 없다.\n * 모으면서 지키는 것 셋:\n *\n *  ① **어느 트윈에서 왔는지 붙인다**(`instanceId`) — 조치는 결국 그 트윈에 보내야 하고, 공간에서 보면\n *     같은 자리 id 가 렌즈마다 다른 것을 가리킬 수 있다.\n *  ② **순서는 렌즈 순서가 아니라 급한 순서다** — 앞 렌즈의 낮은 신호가 뒤 렌즈의 심각한 신호를\n *     밀어내면, 상위 N 만 보는 화면에서 정작 급한 것이 안 보인다.\n *  ③ **자리 색은 렌즈를 가로질러 가장 급한 것으로** 접는다 — 두 렌즈가 같은 자리를 가리키면 그 자리는\n *     하나의 현실이므로 더 급한 쪽이 이긴다(둘 중 하나를 임의로 고르면 색이 렌즈 순서에 따라 달라진다).\n */\nexport function mergeLensAttentions(lenses: readonly LensAttentions[], limit?: number): AttentionDigestResult {\n  const all: AttentionLike[] = []\n  for (const lens of lenses) {\n    for (const a of lens.attentions ?? []) all.push({ ...a, instanceId: lens.instanceId } as AttentionLike)\n  }\n  return digestAttentions(all, limit)\n}\n"]}

package/dist-server/engine/board-vocabulary.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 보드를 정본 어휘로 — `locations`·`equipment` 만 남는다. 새 어휘 보드에는 **아무 일도 하지 않는다**
+ * (같은 값을 다시 담을 뿐이라 멱등).
+ *
+ * 보드가 아닌 것(없음·배열·원시값)은 **그대로 통과**시킨다 — 모양을 짐작해 고치지 않는다.
+ */
+export declare function canonicalBoard<T = any>(board: T): T;
+/**
+ * 엔티티 컬럼 변환기 — **읽을 때만** 정규화한다.
+ *
+ * `to`(쓰기)는 손대지 않는다: 저장은 호출부가 준 그대로가 진실이고, 읽기가 정규화되므로 다음 저장에서
+ * 자연히 새 어휘가 된다.
+ */
+export declare const boardColumnTransformer: {
+    from: (value: any) => any;
+    to: (value: any) => any;
+};

package/dist-server/engine/board-vocabulary.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.boardColumnTransformer = void 0;
+exports.canonicalBoard = canonicalBoard;
+/*
+ * 저장된 보드의 **어휘 세대를 흡수한다** — 읽는 순간 한 어휘로. 순수.
+ *
+ * ── 계기 (2026-08-06, 사용자 신고) ───────────────────────────────────────────
+ * 트윈 모델러의 엔티티 목록이 **통째로 비어 있었다.** 오류도 없었다. 원인은 이 인스턴스의 저장된 보드가
+ * 옛 어휘였고 화면과 호스트는 새 어휘(`locations`/`equipment`)를 읽었기 때문이다. 그 옛 이름들은
+ * 아래 `RETIRED_KEYS` 에 있다 — 흡수할 세대의 이름을 적지 않고는 이 파일을 쓸 수 없다.
+ *
+ * 커널에는 이미 세대를 흡수하는 리더가 있다(`readBoardLocations`·`readBoardEquipment` — 세 세대
+ * `movers`→`equipmentList`→`equipment`, 실측 주석에 "저장된 보드 23개 중 13개가 `movers`"). 그런데 **그
+ * 리더를 거치는 곳이 목록뿐**이었다. 상세·구조 서명·주행 추정기·설비 동기는 컬렉션을 직접 읽어
+ * **오류 없이 빈 공장**으로 읽었다:
+ *
+ *  · 모델러·팔레트·보드 자동생성 → 엔티티 0(사용자가 본 증상)
+ *  · 구조 서명 → `N[]M[]` — **서로 다른 두 공장이 구조적으로 같아 보인다**(변경 감지가 죽는다)
+ *  · 주행 추정기 → 설비 0이라 거리 기반 소요시간을 못 만든다
+ *  · 설비 동기 → 아는 설비가 0이라 중복 append + 한 보드에 두 세대가 섞인다
+ *
+ * ── 왜 자리마다 고치지 않나 ─────────────────────────────────────────────────
+ * 저장된 보드를 읽는 자리가 **27곳**이다. 자리마다 리더를 쓰게 하면 다음에 추가되는 자리가 또 빠진다 —
+ * 그리고 빠진 것은 오류가 아니라 **빈 공장**이라 조용하다. 그래서 **DB에서 읽는 순간 한 번** 정규화한다
+ * (엔티티 컬럼 변환기). 그 뒤로는 코드가 세대를 알 필요가 없다.
+ *
+ * ── 쓰기는 건드리지 않는다 ──────────────────────────────────────────────────
+ * 저장은 주는 대로 한다(새 쓰기는 이미 새 어휘다). 읽기가 정규화되므로, 저장된 옛 보드는 **다음에
+ * 저장될 때 자연히 새 어휘로 옮겨간다** — 마이그레이션을 따로 돌리지 않는다.
+ */
+const twin_kernel_1 = require("@operato/twin-kernel");
+/** 흡수하고 **내보내지 않는** 옛 키 — 남겨 두면 소비처가 두 어휘를 다시 보게 된다. */
+const RETIRED_KEYS = ['nodes', 'movers', 'equipmentList']; // vocabulary-guard: allow — 옛 어휘를 흡수하는 것이 이 코드의 일이다(세대 이름을 적어야 흡수할 수 있다)
+/**
+ * 보드를 정본 어휘로 — `locations`·`equipment` 만 남는다. 새 어휘 보드에는 **아무 일도 하지 않는다**
+ * (같은 값을 다시 담을 뿐이라 멱등).
+ *
+ * 보드가 아닌 것(없음·배열·원시값)은 **그대로 통과**시킨다 — 모양을 짐작해 고치지 않는다.
+ */
+function canonicalBoard(board) {
+    if (!board || typeof board !== 'object' || Array.isArray(board))
+        return board;
+    const rest = {};
+    for (const [k, v] of Object.entries(board)) {
+        if (RETIRED_KEYS.includes(k))
+            continue;
+        rest[k] = v;
+    }
+    /* 리더가 세대를 고른다 — 여기서 `??` 사슬을 다시 적으면 세대 규칙이 두 곳이 된다. */
+    return { ...rest, locations: (0, twin_kernel_1.readBoardLocations)(board), equipment: (0, twin_kernel_1.readBoardEquipment)(board) };
+}
+/**
+ * 엔티티 컬럼 변환기 — **읽을 때만** 정규화한다.
+ *
+ * `to`(쓰기)는 손대지 않는다: 저장은 호출부가 준 그대로가 진실이고, 읽기가 정규화되므로 다음 저장에서
+ * 자연히 새 어휘가 된다.
+ */
+exports.boardColumnTransformer = {
+    from: (value) => canonicalBoard(value),
+    to: (value) => value
+};
+//# sourceMappingURL=board-vocabulary.js.map

package/dist-server/engine/board-vocabulary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-vocabulary.js","sourceRoot":"","sources":["../../server/engine/board-vocabulary.ts"],"names":[],"mappings":";;;AAsCA,wCAWC;AAjDD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,sDAA6E;AAE7E,wDAAwD;AACxD,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,eAAe,CAAU,CAAA,CAAC,yEAAyE;AAE5I;;;;;GAKG;AACH,SAAgB,cAAc,CAAU,KAAQ;IAC9C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAE7E,MAAM,IAAI,GAA4B,EAAE,CAAA;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;QACtE,IAAK,YAAkC,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,SAAQ;QAC7D,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IACb,CAAC;IAED,uDAAuD;IACvD,OAAO,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,IAAA,gCAAkB,EAAC,KAAY,CAAC,EAAE,SAAS,EAAE,IAAA,gCAAkB,EAAC,KAAY,CAAC,EAAO,CAAA;AACnH,CAAC;AAED;;;;;GAKG;AACU,QAAA,sBAAsB,GAAG;IACpC,IAAI,EAAE,CAAC,KAAU,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC;IAC3C,EAAE,EAAE,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK;CAC1B,CAAA","sourcesContent":["/*\n * 저장된 보드의 **어휘 세대를 흡수한다** — 읽는 순간 한 어휘로. 순수.\n *\n * ── 계기 (2026-08-06, 사용자 신고) ───────────────────────────────────────────\n * 트윈 모델러의 엔티티 목록이 **통째로 비어 있었다.** 오류도 없었다. 원인은 이 인스턴스의 저장된 보드가\n * 옛 어휘였고 화면과 호스트는 새 어휘(`locations`/`equipment`)를 읽었기 때문이다. 그 옛 이름들은\n * 아래 `RETIRED_KEYS` 에 있다 — 흡수할 세대의 이름을 적지 않고는 이 파일을 쓸 수 없다.\n *\n * 커널에는 이미 세대를 흡수하는 리더가 있다(`readBoardLocations`·`readBoardEquipment` — 세 세대\n * `movers`→`equipmentList`→`equipment`, 실측 주석에 \"저장된 보드 23개 중 13개가 `movers`\"). 그런데 **그\n * 리더를 거치는 곳이 목록뿐**이었다. 상세·구조 서명·주행 추정기·설비 동기는 컬렉션을 직접 읽어\n * **오류 없이 빈 공장**으로 읽었다:\n *\n *  · 모델러·팔레트·보드 자동생성 → 엔티티 0(사용자가 본 증상)\n *  · 구조 서명 → `N[]M[]` — **서로 다른 두 공장이 구조적으로 같아 보인다**(변경 감지가 죽는다)\n *  · 주행 추정기 → 설비 0이라 거리 기반 소요시간을 못 만든다\n *  · 설비 동기 → 아는 설비가 0이라 중복 append + 한 보드에 두 세대가 섞인다\n *\n * ── 왜 자리마다 고치지 않나 ─────────────────────────────────────────────────\n * 저장된 보드를 읽는 자리가 **27곳**이다. 자리마다 리더를 쓰게 하면 다음에 추가되는 자리가 또 빠진다 —\n * 그리고 빠진 것은 오류가 아니라 **빈 공장**이라 조용하다. 그래서 **DB에서 읽는 순간 한 번** 정규화한다\n * (엔티티 컬럼 변환기). 그 뒤로는 코드가 세대를 알 필요가 없다.\n *\n * ── 쓰기는 건드리지 않는다 ──────────────────────────────────────────────────\n * 저장은 주는 대로 한다(새 쓰기는 이미 새 어휘다). 읽기가 정규화되므로, 저장된 옛 보드는 **다음에\n * 저장될 때 자연히 새 어휘로 옮겨간다** — 마이그레이션을 따로 돌리지 않는다.\n */\nimport { readBoardLocations, readBoardEquipment } from '@operato/twin-kernel'\n\n/** 흡수하고 **내보내지 않는** 옛 키 — 남겨 두면 소비처가 두 어휘를 다시 보게 된다. */\nconst RETIRED_KEYS = ['nodes', 'movers', 'equipmentList'] as const // vocabulary-guard: allow — 옛 어휘를 흡수하는 것이 이 코드의 일이다(세대 이름을 적어야 흡수할 수 있다)\n\n/**\n * 보드를 정본 어휘로 — `locations`·`equipment` 만 남는다. 새 어휘 보드에는 **아무 일도 하지 않는다**\n * (같은 값을 다시 담을 뿐이라 멱등).\n *\n * 보드가 아닌 것(없음·배열·원시값)은 **그대로 통과**시킨다 — 모양을 짐작해 고치지 않는다.\n */\nexport function canonicalBoard<T = any>(board: T): T {\n  if (!board || typeof board !== 'object' || Array.isArray(board)) return board\n\n  const rest: Record<string, unknown> = {}\n  for (const [k, v] of Object.entries(board as Record<string, unknown>)) {\n    if ((RETIRED_KEYS as readonly string[]).includes(k)) continue\n    rest[k] = v\n  }\n\n  /* 리더가 세대를 고른다 — 여기서 `??` 사슬을 다시 적으면 세대 규칙이 두 곳이 된다. */\n  return { ...rest, locations: readBoardLocations(board as any), equipment: readBoardEquipment(board as any) } as T\n}\n\n/**\n * 엔티티 컬럼 변환기 — **읽을 때만** 정규화한다.\n *\n * `to`(쓰기)는 손대지 않는다: 저장은 호출부가 준 그대로가 진실이고, 읽기가 정규화되므로 다음 저장에서\n * 자연히 새 어휘가 된다.\n */\nexport const boardColumnTransformer = {\n  from: (value: any) => canonicalBoard(value),\n  to: (value: any) => value\n}\n"]}

package/dist-server/engine/command-routing.d.ts

@@ -0,0 +1,33 @@
+/** 라우팅에 필요한 인스턴스 사실만 — 엔진 객체를 그대로 받지 않는다(순수하게 유지). */
+export interface RoutableInstance {
+    /** 'live' 면 현실을 비추는 트윈(미러). 그 외는 시뮬. */
+    mode?: string;
+    /** 커널 런타임(tick/dispatch)이 붙어 있나 — 시뮬 경로에서만 만들어진다. */
+    hasRuntime: boolean;
+    /** 관측 커널이 dispatch 를 받을 수 있나. */
+    hasKernelDispatch: boolean;
+}
+export type CommandRoute = 
+/** 커널 런타임으로(시뮬 — 커널이 세계다). */
+{
+    target: 'runtime';
+}
+/** 관측 커널로(미러 — 주석만). 방출된 사실은 저널 큐에 실어야 한다. */
+ | {
+    target: 'kernel';
+}
+/** 보내지 않는다. 사유는 언어 중립 코드 — 화면이 `twin.cmderr.<code>` 로 사람 말을 만든다. */
+ | {
+    target: 'reject';
+    errorCode: string;
+    errorParams?: Record<string, string | number>;
+};
+/** 이 커맨드가 실 프로세스를 바꾸는 것인가(= 액추에이션). */
+export declare const isActuation: (type: string) => boolean;
+/**
+ * 어디로 보낼지 정한다.
+ *
+ * `inst` 가 없거나 호출자 도메인 소유가 아니면 **같은 사유로** 거절한다 — 존재 여부를 알려 주면
+ * 다른 테넌트의 인스턴스 id 를 추측할 수 있다(있음/없음이 구별되면 그것이 정보다).
+ */
+export declare function routeCommand(inst: RoutableInstance | undefined, ownedByCaller: boolean, type: string): CommandRoute;

package/dist-server/engine/command-routing.js

@@ -0,0 +1,53 @@
+"use strict";
+/*
+ * 커맨드 라우팅 판정 — **순수**. "이 커맨드를 누구에게 보낼 것인가" 만 정한다.
+ * 실제 dispatch·저널 기록은 엔진이 한다(`design/plans/command-routing.md` §1·§4 P0).
+ *
+ * ── 왜 떼어냈나 ─────────────────────────────────────────────────────────────
+ * 예전에는 리졸버가 `inst.runtime.dispatch(...)` 를 곧바로 불렀다. `runtime` 은 **시뮬 경로에서만**
+ * 만들어지므로 실물을 비추는 트윈(mirror)에서는 그 한 줄이 `TypeError` 로 터졌다 — 조치 채널이
+ * 통째로 닿지 않았고, 사용자에게는 이유 있는 거절이 아니라 그냥 실패였다.
+ *
+ * 판정이 코드 한가운데 있으면 이런 부류를 테스트로 못 잡는다(엔진은 DB·TypeORM 을 물고 있어 단위
+ * 테스트가 불러올 수 없다). 그래서 판정만 순수하게 떼어 둔다 — `planWarmStart` 와 같은 이유다.
+ *
+ * ── 판정 규칙 = 권위 × 성격 ─────────────────────────────────────────────────
+ * | 성격 \ 모드      | 시뮬            | 미러(현실을 비춤)                    |
+ * | 액추에이션        | 커널 런타임      | **거절**(아웃바운드 어댑터 미결선)     |
+ * | 주석(확인 ack)    | 커널 런타임      | 관측 커널                            |
+ *
+ * 미러에서 액추에이션을 그냥 허용하면 **새 거짓말이 생긴다**: 트윈은 "보류됨" 이라 말하고 실 시스템은
+ * 모른다. 조용히 커널만 바꾸지 않고, 이유를 밝혀 거절한다.
+ *
+ * 반면 확인(ack)은 액추에이션이 아니다 — 신호를 봤다는 트윈 쪽 주석이라 현실을 건드리지 않는다.
+ * 미러에서도 성립해야 하므로 관측 커널로 보낸다.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isActuation = void 0;
+exports.routeCommand = routeCommand;
+/** 관측 쪽 주석 커맨드 — 현실을 바꾸지 않으므로 미러에서도 통과한다. */
+const ANNOTATION_COMMANDS = new Set(['attention.ack']);
+/** 이 커맨드가 실 프로세스를 바꾸는 것인가(= 액추에이션). */
+const isActuation = (type) => !ANNOTATION_COMMANDS.has(type);
+exports.isActuation = isActuation;
+/**
+ * 어디로 보낼지 정한다.
+ *
+ * `inst` 가 없거나 호출자 도메인 소유가 아니면 **같은 사유로** 거절한다 — 존재 여부를 알려 주면
+ * 다른 테넌트의 인스턴스 id 를 추측할 수 있다(있음/없음이 구별되면 그것이 정보다).
+ */
+function routeCommand(inst, ownedByCaller, type) {
+    if (!inst || !ownedByCaller)
+        return { target: 'reject', errorCode: 'no-instance' };
+    if (!type)
+        return { target: 'reject', errorCode: 'unknown-command' };
+    if (inst.mode !== 'live') {
+        /* 시뮬 — 커널이 세계다. 런타임이 없으면 터뜨리지 않고 이유를 말한다. */
+        return inst.hasRuntime ? { target: 'runtime' } : { target: 'reject', errorCode: 'no-runtime' };
+    }
+    /* 미러 — 실 프로세스 변경은 아웃바운드 어댑터의 몫이고 아직 결선되지 않았다. */
+    if ((0, exports.isActuation)(type))
+        return { target: 'reject', errorCode: 'actuation-not-wired', errorParams: { type } };
+    return inst.hasKernelDispatch ? { target: 'kernel' } : { target: 'reject', errorCode: 'no-runtime' };
+}
+//# sourceMappingURL=command-routing.js.map

package/dist-server/engine/command-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-routing.js","sourceRoot":"","sources":["../../server/engine/command-routing.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AAgCH,oCAYC;AA1CD,6CAA6C;AAC7C,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAS,CAAC,eAAe,CAAC,CAAC,CAAA;AAoB9D,uCAAuC;AAChC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AAAvE,QAAA,WAAW,eAA4D;AAEpF;;;;;GAKG;AACH,SAAgB,YAAY,CAAC,IAAkC,EAAE,aAAsB,EAAE,IAAY;IACnG,IAAI,CAAC,IAAI,IAAI,CAAC,aAAa;QAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,CAAA;IAClF,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAA;IAEpE,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACzB,6CAA6C;QAC7C,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,CAAA;IAChG,CAAC;IAED,iDAAiD;IACjD,IAAI,IAAA,mBAAW,EAAC,IAAI,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,qBAAqB,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,EAAE,CAAA;IAC3G,OAAO,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,CAAA;AACtG,CAAC","sourcesContent":["/*\n * 커맨드 라우팅 판정 — **순수**. \"이 커맨드를 누구에게 보낼 것인가\" 만 정한다.\n * 실제 dispatch·저널 기록은 엔진이 한다(`design/plans/command-routing.md` §1·§4 P0).\n *\n * ── 왜 떼어냈나 ─────────────────────────────────────────────────────────────\n * 예전에는 리졸버가 `inst.runtime.dispatch(...)` 를 곧바로 불렀다. `runtime` 은 **시뮬 경로에서만**\n * 만들어지므로 실물을 비추는 트윈(mirror)에서는 그 한 줄이 `TypeError` 로 터졌다 — 조치 채널이\n * 통째로 닿지 않았고, 사용자에게는 이유 있는 거절이 아니라 그냥 실패였다.\n *\n * 판정이 코드 한가운데 있으면 이런 부류를 테스트로 못 잡는다(엔진은 DB·TypeORM 을 물고 있어 단위\n * 테스트가 불러올 수 없다). 그래서 판정만 순수하게 떼어 둔다 — `planWarmStart` 와 같은 이유다.\n *\n * ── 판정 규칙 = 권위 × 성격 ─────────────────────────────────────────────────\n * | 성격 \\ 모드      | 시뮬            | 미러(현실을 비춤)                    |\n * | 액추에이션        | 커널 런타임      | **거절**(아웃바운드 어댑터 미결선)     |\n * | 주석(확인 ack)    | 커널 런타임      | 관측 커널                            |\n *\n * 미러에서 액추에이션을 그냥 허용하면 **새 거짓말이 생긴다**: 트윈은 \"보류됨\" 이라 말하고 실 시스템은\n * 모른다. 조용히 커널만 바꾸지 않고, 이유를 밝혀 거절한다.\n *\n * 반면 확인(ack)은 액추에이션이 아니다 — 신호를 봤다는 트윈 쪽 주석이라 현실을 건드리지 않는다.\n * 미러에서도 성립해야 하므로 관측 커널로 보낸다.\n */\n\n/** 관측 쪽 주석 커맨드 — 현실을 바꾸지 않으므로 미러에서도 통과한다. */\nconst ANNOTATION_COMMANDS = new Set<string>(['attention.ack'])\n\n/** 라우팅에 필요한 인스턴스 사실만 — 엔진 객체를 그대로 받지 않는다(순수하게 유지). */\nexport interface RoutableInstance {\n  /** 'live' 면 현실을 비추는 트윈(미러). 그 외는 시뮬. */\n  mode?: string\n  /** 커널 런타임(tick/dispatch)이 붙어 있나 — 시뮬 경로에서만 만들어진다. */\n  hasRuntime: boolean\n  /** 관측 커널이 dispatch 를 받을 수 있나. */\n  hasKernelDispatch: boolean\n}\n\nexport type CommandRoute =\n  /** 커널 런타임으로(시뮬 — 커널이 세계다). */\n  | { target: 'runtime' }\n  /** 관측 커널로(미러 — 주석만). 방출된 사실은 저널 큐에 실어야 한다. */\n  | { target: 'kernel' }\n  /** 보내지 않는다. 사유는 언어 중립 코드 — 화면이 `twin.cmderr.<code>` 로 사람 말을 만든다. */\n  | { target: 'reject'; errorCode: string; errorParams?: Record<string, string | number> }\n\n/** 이 커맨드가 실 프로세스를 바꾸는 것인가(= 액추에이션). */\nexport const isActuation = (type: string): boolean => !ANNOTATION_COMMANDS.has(type)\n\n/**\n * 어디로 보낼지 정한다.\n *\n * `inst` 가 없거나 호출자 도메인 소유가 아니면 **같은 사유로** 거절한다 — 존재 여부를 알려 주면\n * 다른 테넌트의 인스턴스 id 를 추측할 수 있다(있음/없음이 구별되면 그것이 정보다).\n */\nexport function routeCommand(inst: RoutableInstance | undefined, ownedByCaller: boolean, type: string): CommandRoute {\n  if (!inst || !ownedByCaller) return { target: 'reject', errorCode: 'no-instance' }\n  if (!type) return { target: 'reject', errorCode: 'unknown-command' }\n\n  if (inst.mode !== 'live') {\n    /* 시뮬 — 커널이 세계다. 런타임이 없으면 터뜨리지 않고 이유를 말한다. */\n    return inst.hasRuntime ? { target: 'runtime' } : { target: 'reject', errorCode: 'no-runtime' }\n  }\n\n  /* 미러 — 실 프로세스 변경은 아웃바운드 어댑터의 몫이고 아직 결선되지 않았다. */\n  if (isActuation(type)) return { target: 'reject', errorCode: 'actuation-not-wired', errorParams: { type } }\n  return inst.hasKernelDispatch ? { target: 'kernel' } : { target: 'reject', errorCode: 'no-runtime' }\n}\n"]}

package/dist-server/engine/entity-delta.d.ts

@@ -3,11 +3,18 @@ export interface EntityDelta {
     data: any;
 }
 /** 집약 고정 태그 — 클라 provider 와 일치해야 한다(런타임 생성 엔티티는 개별 배치가 불가하므로 집약 뷰). */
-export declare const ORDERS_TAG = "__orders__";
-export declare const TASKS_TAG = "__tasks__";
-export declare const ITEMS_TAG = "__items__";
-export declare const PERSONS_TAG = "__persons__";
-export declare const ASSETS_TAG = "__assets__";
+export declare const ORDERS_TAG_PREFIX = "__orders__";
+export declare const TASKS_TAG_PREFIX = "__tasks__";
+export declare const ITEMS_TAG_PREFIX = "__items__";
+export declare const PERSONS_TAG_PREFIX = "__persons__";
+export declare const ASSETS_TAG_PREFIX = "__assets__";
+/** 이 트윈의 집약 채널 태그. 트윈 식별자가 없으면 만들지 않는다 — 덮어쓰기의 원인이었다. */
+export declare function aggregateTag(prefix: string, instanceId: string): string;
+export declare const ordersTag: (instanceId: string) => string;
+export declare const tasksTag: (instanceId: string) => string;
+export declare const itemsTag: (instanceId: string) => string;
+export declare const personsTag: (instanceId: string) => string;
+export declare const assetsTag: (instanceId: string) => string;
 /**
  * 물품 집약의 상한 — 큰 현장은 물품이 수만 개라, 전량을 매 방송에 실으면 전달이 현장을 느리게 한다.
  *
@@ -16,4 +23,4 @@ export declare const ASSETS_TAG = "__assets__";
  * 이 걸려 **변한 것만** 재방송된다.
  */
 export declare const ITEMS_AGGREGATE_LIMIT = 500;
-export declare function buildEntityDeltas(state: any): EntityDelta[];
+export declare function buildEntityDeltas(state: any, instanceId: string): EntityDelta[];

package/dist-server/engine/entity-delta.js

@@ -26,14 +26,40 @@
  *   그리고 집약 태그(__orders__ · __tasks__ · __items__ · __persons__ · __assets__).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ITEMS_AGGREGATE_LIMIT = exports.ASSETS_TAG = exports.PERSONS_TAG = exports.ITEMS_TAG = exports.TASKS_TAG = exports.ORDERS_TAG = void 0;
+exports.ITEMS_AGGREGATE_LIMIT = exports.assetsTag = exports.personsTag = exports.itemsTag = exports.tasksTag = exports.ordersTag = exports.ASSETS_TAG_PREFIX = exports.PERSONS_TAG_PREFIX = exports.ITEMS_TAG_PREFIX = exports.TASKS_TAG_PREFIX = exports.ORDERS_TAG_PREFIX = void 0;
+exports.aggregateTag = aggregateTag;
 exports.buildEntityDeltas = buildEntityDeltas;
 /** 집약 고정 태그 — 클라 provider 와 일치해야 한다(런타임 생성 엔티티는 개별 배치가 불가하므로 집약 뷰). */
-exports.ORDERS_TAG = '__orders__';
-exports.TASKS_TAG = '__tasks__';
-exports.ITEMS_TAG = '__items__';
-exports.PERSONS_TAG = '__persons__';
-exports.ASSETS_TAG = '__assets__';
+/*
+ * 집약 채널의 접두사 — **실제 태그는 트윈 식별자를 붙여 만든다.**
+ *
+ * 예전에는 이 상수가 곧 태그였다. 그런데 발행 키는 (도메인, 태그)이고, **한 공간에 트윈이 여럿**
+ * 있으면(실측: 3곳 × 3개) 셋이 같은 태그로 발행해 서로 덮었다. 보드의 주문 목록판이 세 공장의 주문
+ * 중 마지막에 도착한 것을 보여 준다 — 오류 없이.
+ *
+ * 구간 성과 태그가 이미 `__kpi__:<트윈>` 으로 트윈을 붙이고 있었다(`kpi-broadcast.ts`). 같은 규약으로 맞춘다.
+ */
+exports.ORDERS_TAG_PREFIX = '__orders__';
+exports.TASKS_TAG_PREFIX = '__tasks__';
+exports.ITEMS_TAG_PREFIX = '__items__';
+exports.PERSONS_TAG_PREFIX = '__persons__';
+exports.ASSETS_TAG_PREFIX = '__assets__';
+/** 이 트윈의 집약 채널 태그. 트윈 식별자가 없으면 만들지 않는다 — 덮어쓰기의 원인이었다. */
+function aggregateTag(prefix, instanceId) {
+    if (!instanceId)
+        throw new Error('aggregateTag: instanceId required — 트윈 구분이 없는 태그는 다른 트윈의 것을 덮는다');
+    return `${prefix}:${instanceId}`;
+}
+const ordersTag = (instanceId) => aggregateTag(exports.ORDERS_TAG_PREFIX, instanceId);
+exports.ordersTag = ordersTag;
+const tasksTag = (instanceId) => aggregateTag(exports.TASKS_TAG_PREFIX, instanceId);
+exports.tasksTag = tasksTag;
+const itemsTag = (instanceId) => aggregateTag(exports.ITEMS_TAG_PREFIX, instanceId);
+exports.itemsTag = itemsTag;
+const personsTag = (instanceId) => aggregateTag(exports.PERSONS_TAG_PREFIX, instanceId);
+exports.personsTag = personsTag;
+const assetsTag = (instanceId) => aggregateTag(exports.ASSETS_TAG_PREFIX, instanceId);
+exports.assetsTag = assetsTag;
 /**
  * 통과시키지 않는 필드 — **빼는 데는 이유가 필요하다.**
  *
@@ -98,7 +124,7 @@ function aggregateItem(entity, idKey) {
  * 이 걸려 **변한 것만** 재방송된다.
  */
 exports.ITEMS_AGGREGATE_LIMIT = 500;
-function buildEntityDeltas(state) {
+function buildEntityDeltas(state, instanceId) {
     const out = [];
     for (const n of state?.locations ?? []) {
         out.push({ tag: n.id, data: payloadOf('location', n) });
@@ -135,19 +161,19 @@ function buildEntityDeltas(state) {
      * 런타임에 생기고 사라지는 엔티티(오더·작업·물품)는 보드에 개별 배치할 수 없다 → 한 컴포넌트가
      * 전체를 추적하는 집약 태그를 항상 방출한다. */
     const orders = state?.orders ?? [];
-    out.push({ tag: exports.ORDERS_TAG, data: { entity: 'orders', orders: orders.map((o) => aggregateItem(o, 'id')) } });
+    out.push({ tag: (0, exports.ordersTag)(instanceId), data: { entity: 'orders', orders: orders.map((o) => aggregateItem(o, 'id')) } });
     const tasks = state?.tasks ?? [];
-    out.push({ tag: exports.TASKS_TAG, data: { entity: 'tasks', tasks: tasks.map((t) => aggregateItem(t, 'id')) } });
+    out.push({ tag: (0, exports.tasksTag)(instanceId), data: { entity: 'tasks', tasks: tasks.map((t) => aggregateItem(t, 'id')) } });
     /* 사람 집약 — 인원은 보드에 개별 배치할 수도 있지만(설비처럼), 전체를 한눈에 보는 소비처도 있다.
      * 인원을 선언하지 않은 트윈에서는 빈 배열이 나간다(없음과 모름을 구별). */
     const persons = state?.persons ?? [];
-    out.push({ tag: exports.PERSONS_TAG, data: { entity: 'persons', persons: persons.map((p) => aggregateItem(p, 'id')) } });
+    out.push({ tag: (0, exports.personsTag)(instanceId), data: { entity: 'persons', persons: persons.map((p) => aggregateItem(p, 'id')) } });
     const assets = state?.assets ?? [];
-    out.push({ tag: exports.ASSETS_TAG, data: { entity: 'assets', assets: assets.map((a) => aggregateItem(a, 'id')) } });
+    out.push({ tag: (0, exports.assetsTag)(instanceId), data: { entity: 'assets', assets: assets.map((a) => aggregateItem(a, 'id')) } });
     const items = state?.items ?? [];
     const shown = items.slice(0, exports.ITEMS_AGGREGATE_LIMIT);
     out.push({
-        tag: exports.ITEMS_TAG,
+        tag: (0, exports.itemsTag)(instanceId),
         data: {
             entity: 'items',
             items: shown.map((it) => aggregateItem(it, 'epc')),

package/dist-server/engine/entity-delta.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity-delta.js","sourceRoot":"","sources":["../../server/engine/entity-delta.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * 트윈 State 스냅샷 → 라이브 바인딩 delta 목록 (순수 매핑 — pubsub/도메인 무관 → 단위 테스트 가능).\n * publishEntityData 가 이 목록을 엔티티별 시그니처로 dedup 후 data(tag) 채널로 발행한다.\n *\n * ── 규율: 레퍼런스가 아는 것은 **전부** 내보낸다 ────────────────────────────\n * 트윈에서 사소한 속성은 없다. 소속 구역·소속 팔레트·수량·만료처럼 곁가지로 보이는 값이 실제로는\n * 구역 롤업·적재 표현·로트 추적의 전제다. 그래서 여기서 **필드를 손으로 골라 담지 않는다.**\n *\n * 예전에는 엔티티마다 필요할 것 같은 필드만 열거했고, 그 결과 계약에 있는 것이 조용히 누락됐다\n * (2026-08-01 감사: 노드 parentId 누락 · 작업 전량 누락 · 물품 전량 누락). 화이트리스트 방식은\n * **계약이 자라도 화면이 따라오지 못한다** — 커널이 속성을 늘릴 때마다 이 파일을 고쳐야 하고, 고치는\n * 것을 잊으면 아무 신호 없이 정보가 사라진다.\n *\n * 그래서 반대로 한다: **상태 객체가 가진 것을 그대로 통과**시키고, 통과시키지 **않을** 것만 이유와 함께\n * 열거한다(EXCLUDED). 새 속성은 자동으로 화면에 도달하고, 빼려면 이유를 적어야 한다.\n *\n * ── 표식은 도메인 낱말을 훔치지 않는다 ─────────────────────────────────────\n * 예전 payload 는 엔티티 종류 표식을 `kind` 로 실었다. 그런데 `kind` 는 **도메인의 낱말**이다 —\n * 무버 kind=cutter, 작업 kind=putaway, 오더 kind=workorder. 표식이 그 이름을 차지하면 도메인 속성을\n * 실을 자리가 없어진다(같은 병을 오늘 ox-timeline 의 `group` 에서도 고쳤다).\n * 그래서 표식은 `entity`(우리 이름)로 옮기고 `kind` 는 도메인에 돌려준다.\n *\n * payload 계약(씬 컴포넌트가 소비): `entity`(표식) + 그 엔티티의 모든 속성(도메인 `kind` 포함).\n *   entity = location · equipment · person · asset · order · task · item,\n *   그리고 집약 태그(__orders__ · __tasks__ · __items__ · __persons__ · __assets__).\n */\n\nexport interface EntityDelta {\n  tag: string\n  data: any\n}\n\n/** 집약 고정 태그 — 클라 provider 와 일치해야 한다(런타임 생성 엔티티는 개별 배치가 불가하므로 집약 뷰). */\nexport const ORDERS_TAG = '__orders__'\nexport const TASKS_TAG = '__tasks__'\nexport const ITEMS_TAG = '__items__'\nexport const PERSONS_TAG = '__persons__'\nexport const ASSETS_TAG = '__assets__'\n\n/**\n * 통과시키지 않는 필드 — **빼는 데는 이유가 필요하다.**\n *\n * · `id`/`epc` — 태그로 이미 나가므로 개별 payload 에 중복해 싣지 않는다(집약 뷰에는 넣는다).\n * · `oee` — 원시 누적(idleMs 등)이 매 delta 증가해 \"무변화 생략\" 을 무력화한다. shapeOee 로 정형화해 얹는다.\n */\nconst EXCLUDED = new Set(['id', 'epc', 'oee'])\n\n/**\n * OEE 원시 비율/카운트 → 표시용 정수 퍼센트 + 카운트.\n * 원시 누적 ms(idleMs 등)는 매 delta 증가해 무변화-생략을 무력화하므로 제외(유휴 자원의 매초 재방송 억제).\n * oee 미측정이면 undefined.\n */\nfunction shapeOee(o: any): any {\n  if (!o) return undefined\n  return {\n    overall: Math.round((o.overall ?? 0) * 100),\n    availability: Math.round((o.availability ?? 0) * 100),\n    performance: Math.round((o.performance ?? 0) * 100),\n    quality: Math.round((o.quality ?? 0) * 100),\n    good: o.goodCount ?? 0,\n    scrap: o.scrapCount ?? 0\n  }\n}\n\n/**\n * 엔티티 하나의 payload — `entity` 표식 + 나머지 전부(도메인 `kind` 포함).\n *\n * `undefined` 값은 싣지 않는다(키의 유무가 시그니처를 흔들지 않게). 값이 없는 것과 키가 없는 것은\n * 소비처에서 같으므로 안전하고, 무변화 생략이 잘 듣는다.\n */\nfunction payloadOf(entityKind: string, entity: any): any {\n  /* 표식은 `entity` — 도메인의 `kind` 를 덮지 않는다. */\n  const data: any = { entity: entityKind }\n  for (const [k, v] of Object.entries(entity ?? {})) {\n    if (EXCLUDED.has(k) || v === undefined) continue\n    data[k] = v\n  }\n  return data\n}\n\n/**\n * 집약 뷰의 항목 — 개별 payload 와 같은 내용 + 식별자.\n * 집약은 \"전체를 한 컴포넌트가 추적\" 하는 용도라 식별자가 있어야 한다.\n */\nfunction aggregateItem(entity: any, idKey: 'id' | 'epc'): any {\n  const out: any = { [idKey]: entity?.[idKey] }\n  for (const [k, v] of Object.entries(entity ?? {})) {\n    if (k === idKey || k === 'oee' || v === undefined) continue\n    out[k] = v\n  }\n  const shaped = shapeOee(entity?.oee)\n  if (shaped) out.oee = shaped\n  return out\n}\n\n/**\n * 물품 집약의 상한 — 큰 현장은 물품이 수만 개라, 전량을 매 방송에 실으면 전달이 현장을 느리게 한다.\n *\n * **조용히 자르지 않는다**: 넘치면 `total`(전체 수)과 `truncated`(잘린 수)를 함께 실어, 소비처가\n * \"이게 전부\" 라고 오해하지 않게 한다. 개별 물품은 태그별 delta 로 따로 나가고 그쪽은 시그니처 dedup\n * 이 걸려 **변한 것만** 재방송된다.\n */\nexport const ITEMS_AGGREGATE_LIMIT = 500\n\nexport function buildEntityDeltas(state: any): EntityDelta[] {\n  const out: EntityDelta[] = []\n\n  for (const n of state?.locations ?? []) {\n    out.push({ tag: n.id, data: payloadOf('location', n) })\n  }\n  for (const m of state?.equipment ?? []) {\n    /* Mobile(location/motion) + Operable(status/held) + Processable(oee) — 한 payload 로.\n     * oee 만 정형화가 필요해 따로 얹는다(나머지는 통과). */\n    const data = payloadOf('equipment', m)\n    const oee = shapeOee(m?.oee)\n    if (oee) data.oee = oee\n    out.push({ tag: m.id, data })\n  }\n  /* 사람 — 설비와 별개 엔티티다. 같은 통과 규칙(가진 것을 전부 내보낸다). */\n  for (const p of state?.persons ?? []) {\n    out.push({ tag: p.id, data: payloadOf('person', p) })\n  }\n  /* 물리 자산(반복사용) — 물품도 설비도 아닌 네 번째 자원. */\n  for (const a of state?.assets ?? []) {\n    out.push({ tag: a.id, data: payloadOf('asset', a) })\n  }\n  for (const o of state?.orders ?? []) {\n    out.push({ tag: o.id, data: payloadOf('order', o) })\n  }\n  for (const t of state?.tasks ?? []) {\n    out.push({ tag: t.id, data: payloadOf('task', t) })\n  }\n  for (const it of state?.items ?? []) {\n    /* 물품의 태그는 epc(개체 식별자) — 노드·무버와 달리 id 가 아니다. */\n    if (it?.epc) out.push({ tag: it.epc, data: payloadOf('item', it) })\n  }\n\n  /* ── 집약 뷰 ──────────────────────────────────────────────────────────────\n   * 런타임에 생기고 사라지는 엔티티(오더·작업·물품)는 보드에 개별 배치할 수 없다 → 한 컴포넌트가\n   * 전체를 추적하는 집약 태그를 항상 방출한다. */\n  const orders = state?.orders ?? []\n  out.push({ tag: ORDERS_TAG, data: { entity: 'orders', orders: orders.map((o: any) => aggregateItem(o, 'id')) } })\n\n  const tasks = state?.tasks ?? []\n  out.push({ tag: TASKS_TAG, data: { entity: 'tasks', tasks: tasks.map((t: any) => aggregateItem(t, 'id')) } })\n\n  /* 사람 집약 — 인원은 보드에 개별 배치할 수도 있지만(설비처럼), 전체를 한눈에 보는 소비처도 있다.\n   * 인원을 선언하지 않은 트윈에서는 빈 배열이 나간다(없음과 모름을 구별). */\n  const persons = state?.persons ?? []\n  out.push({ tag: PERSONS_TAG, data: { entity: 'persons', persons: persons.map((p: any) => aggregateItem(p, 'id')) } })\n\n  const assets = state?.assets ?? []\n  out.push({ tag: ASSETS_TAG, data: { entity: 'assets', assets: assets.map((a: any) => aggregateItem(a, 'id')) } })\n\n  const items = state?.items ?? []\n  const shown = items.slice(0, ITEMS_AGGREGATE_LIMIT)\n  out.push({\n    tag: ITEMS_TAG,\n    data: {\n      entity: 'items',\n      items: shown.map((it: any) => aggregateItem(it, 'epc')),\n      total: items.length,\n      /* 잘렸으면 그 사실을 말한다 — \"이게 전부\" 로 읽히면 재고를 과소 판단한다. */\n      ...(items.length > shown.length ? { truncated: items.length - shown.length } : {})\n    }\n  })\n\n  return out\n}\n"]}
+{"version":3,"file":"entity-delta.js","sourceRoot":"","sources":["../../server/engine/entity-delta.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;;AAwBH,oCAIC;AAyED,8CAgEC;AA9JD,uEAAuE;AACvE;;;;;;;;GAQG;AACU,QAAA,iBAAiB,GAAG,YAAY,CAAA;AAChC,QAAA,gBAAgB,GAAG,WAAW,CAAA;AAC9B,QAAA,gBAAgB,GAAG,WAAW,CAAA;AAC9B,QAAA,kBAAkB,GAAG,aAAa,CAAA;AAClC,QAAA,iBAAiB,GAAG,YAAY,CAAA;AAE7C,yDAAyD;AACzD,SAAgB,YAAY,CAAC,MAAc,EAAE,UAAkB;IAC7D,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAA;IAEnG,OAAO,GAAG,MAAM,IAAI,UAAU,EAAE,CAAA;AAClC,CAAC;AAEM,MAAM,SAAS,GAAG,CAAC,UAAkB,EAAE,EAAE,CAAC,YAAY,CAAC,yBAAiB,EAAE,UAAU,CAAC,CAAA;AAA/E,QAAA,SAAS,aAAsE;AACrF,MAAM,QAAQ,GAAG,CAAC,UAAkB,EAAE,EAAE,CAAC,YAAY,CAAC,wBAAgB,EAAE,UAAU,CAAC,CAAA;AAA7E,QAAA,QAAQ,YAAqE;AACnF,MAAM,QAAQ,GAAG,CAAC,UAAkB,EAAE,EAAE,CAAC,YAAY,CAAC,wBAAgB,EAAE,UAAU,CAAC,CAAA;AAA7E,QAAA,QAAQ,YAAqE;AACnF,MAAM,UAAU,GAAG,CAAC,UAAkB,EAAE,EAAE,CAAC,YAAY,CAAC,0BAAkB,EAAE,UAAU,CAAC,CAAA;AAAjF,QAAA,UAAU,cAAuE;AACvF,MAAM,SAAS,GAAG,CAAC,UAAkB,EAAE,EAAE,CAAC,YAAY,CAAC,yBAAiB,EAAE,UAAU,CAAC,CAAA;AAA/E,QAAA,SAAS,aAAsE;AAE5F;;;;;GAKG;AACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAA;AAE9C;;;;GAIG;AACH,SAAS,QAAQ,CAAC,CAAM;IACtB,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAA;IACxB,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;QAC3C,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;QACrD,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;QACnD,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;QAC3C,IAAI,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC;QACtB,KAAK,EAAE,CAAC,CAAC,UAAU,IAAI,CAAC;KACzB,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,SAAS,CAAC,UAAkB,EAAE,MAAW;IAChD,0CAA0C;IAC1C,MAAM,IAAI,GAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAA;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;QAClD,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,SAAS;YAAE,SAAQ;QAChD,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IACb,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,MAAW,EAAE,KAAmB;IACrD,MAAM,GAAG,GAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAA;IAC7C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,SAAS;YAAE,SAAQ;QAC3D,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IACZ,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACpC,IAAI,MAAM;QAAE,GAAG,CAAC,GAAG,GAAG,MAAM,CAAA;IAC5B,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;GAMG;AACU,QAAA,qBAAqB,GAAG,GAAG,CAAA;AAExC,SAAgB,iBAAiB,CAAC,KAAU,EAAE,UAAkB;IAC9D,MAAM,GAAG,GAAkB,EAAE,CAAA;IAE7B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,CAAC;QACvC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;IACzD,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,CAAC;QACvC;6CACqC;QACrC,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;QACtC,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;QAC5B,IAAI,GAAG;YAAE,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;QACvB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/B,CAAC;IACD,gDAAgD;IAChD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC;QACrC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;IACvD,CAAC;IACD,uCAAuC;IACvC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;QACpC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;IACtD,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;QACpC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;IACtD,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,KAAK,IAAI,EAAE,EAAE,CAAC;QACnC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;IACrD,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,KAAK,IAAI,EAAE,EAAE,CAAC;QACpC,+CAA+C;QAC/C,IAAI,EAAE,EAAE,GAAG;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,CAAA;IACrE,CAAC;IAED;;kCAE8B;IAC9B,MAAM,MAAM,GAAG,KAAK,EAAE,MAAM,IAAI,EAAE,CAAA;IAClC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAA,iBAAS,EAAC,UAAU,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAE5H,MAAM,KAAK,GAAG,KAAK,EAAE,KAAK,IAAI,EAAE,CAAA;IAChC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAA,gBAAQ,EAAC,UAAU,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAExH;kDAC8C;IAC9C,MAAM,OAAO,GAAG,KAAK,EAAE,OAAO,IAAI,EAAE,CAAA;IACpC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAA,kBAAU,EAAC,UAAU,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAEhI,MAAM,MAAM,GAAG,KAAK,EAAE,MAAM,IAAI,EAAE,CAAA;IAClC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAA,iBAAS,EAAC,UAAU,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAE5H,MAAM,KAAK,GAAG,KAAK,EAAE,KAAK,IAAI,EAAE,CAAA;IAChC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,6BAAqB,CAAC,CAAA;IACnD,GAAG,CAAC,IAAI,CAAC;QACP,GAAG,EAAE,IAAA,gBAAQ,EAAC,UAAU,CAAC;QACzB,IAAI,EAAE;YACJ,MAAM,EAAE,OAAO;YACf,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,EAAO,EAAE,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YACvD,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,iDAAiD;YACjD,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnF;KACF,CAAC,CAAA;IAEF,OAAO,GAAG,CAAA;AACZ,CAAC","sourcesContent":["/*\n * 트윈 State 스냅샷 → 라이브 바인딩 delta 목록 (순수 매핑 — pubsub/도메인 무관 → 단위 테스트 가능).\n * publishEntityData 가 이 목록을 엔티티별 시그니처로 dedup 후 data(tag) 채널로 발행한다.\n *\n * ── 규율: 레퍼런스가 아는 것은 **전부** 내보낸다 ────────────────────────────\n * 트윈에서 사소한 속성은 없다. 소속 구역·소속 팔레트·수량·만료처럼 곁가지로 보이는 값이 실제로는\n * 구역 롤업·적재 표현·로트 추적의 전제다. 그래서 여기서 **필드를 손으로 골라 담지 않는다.**\n *\n * 예전에는 엔티티마다 필요할 것 같은 필드만 열거했고, 그 결과 계약에 있는 것이 조용히 누락됐다\n * (2026-08-01 감사: 노드 parentId 누락 · 작업 전량 누락 · 물품 전량 누락). 화이트리스트 방식은\n * **계약이 자라도 화면이 따라오지 못한다** — 커널이 속성을 늘릴 때마다 이 파일을 고쳐야 하고, 고치는\n * 것을 잊으면 아무 신호 없이 정보가 사라진다.\n *\n * 그래서 반대로 한다: **상태 객체가 가진 것을 그대로 통과**시키고, 통과시키지 **않을** 것만 이유와 함께\n * 열거한다(EXCLUDED). 새 속성은 자동으로 화면에 도달하고, 빼려면 이유를 적어야 한다.\n *\n * ── 표식은 도메인 낱말을 훔치지 않는다 ─────────────────────────────────────\n * 예전 payload 는 엔티티 종류 표식을 `kind` 로 실었다. 그런데 `kind` 는 **도메인의 낱말**이다 —\n * 무버 kind=cutter, 작업 kind=putaway, 오더 kind=workorder. 표식이 그 이름을 차지하면 도메인 속성을\n * 실을 자리가 없어진다(같은 병을 오늘 ox-timeline 의 `group` 에서도 고쳤다).\n * 그래서 표식은 `entity`(우리 이름)로 옮기고 `kind` 는 도메인에 돌려준다.\n *\n * payload 계약(씬 컴포넌트가 소비): `entity`(표식) + 그 엔티티의 모든 속성(도메인 `kind` 포함).\n *   entity = location · equipment · person · asset · order · task · item,\n *   그리고 집약 태그(__orders__ · __tasks__ · __items__ · __persons__ · __assets__).\n */\n\nexport interface EntityDelta {\n  tag: string\n  data: any\n}\n\n/** 집약 고정 태그 — 클라 provider 와 일치해야 한다(런타임 생성 엔티티는 개별 배치가 불가하므로 집약 뷰). */\n/*\n * 집약 채널의 접두사 — **실제 태그는 트윈 식별자를 붙여 만든다.**\n *\n * 예전에는 이 상수가 곧 태그였다. 그런데 발행 키는 (도메인, 태그)이고, **한 공간에 트윈이 여럿**\n * 있으면(실측: 3곳 × 3개) 셋이 같은 태그로 발행해 서로 덮었다. 보드의 주문 목록판이 세 공장의 주문\n * 중 마지막에 도착한 것을 보여 준다 — 오류 없이.\n *\n * 구간 성과 태그가 이미 `__kpi__:<트윈>` 으로 트윈을 붙이고 있었다(`kpi-broadcast.ts`). 같은 규약으로 맞춘다.\n */\nexport const ORDERS_TAG_PREFIX = '__orders__'\nexport const TASKS_TAG_PREFIX = '__tasks__'\nexport const ITEMS_TAG_PREFIX = '__items__'\nexport const PERSONS_TAG_PREFIX = '__persons__'\nexport const ASSETS_TAG_PREFIX = '__assets__'\n\n/** 이 트윈의 집약 채널 태그. 트윈 식별자가 없으면 만들지 않는다 — 덮어쓰기의 원인이었다. */\nexport function aggregateTag(prefix: string, instanceId: string): string {\n  if (!instanceId) throw new Error('aggregateTag: instanceId required — 트윈 구분이 없는 태그는 다른 트윈의 것을 덮는다')\n\n  return `${prefix}:${instanceId}`\n}\n\nexport const ordersTag = (instanceId: string) => aggregateTag(ORDERS_TAG_PREFIX, instanceId)\nexport const tasksTag = (instanceId: string) => aggregateTag(TASKS_TAG_PREFIX, instanceId)\nexport const itemsTag = (instanceId: string) => aggregateTag(ITEMS_TAG_PREFIX, instanceId)\nexport const personsTag = (instanceId: string) => aggregateTag(PERSONS_TAG_PREFIX, instanceId)\nexport const assetsTag = (instanceId: string) => aggregateTag(ASSETS_TAG_PREFIX, instanceId)\n\n/**\n * 통과시키지 않는 필드 — **빼는 데는 이유가 필요하다.**\n *\n * · `id`/`epc` — 태그로 이미 나가므로 개별 payload 에 중복해 싣지 않는다(집약 뷰에는 넣는다).\n * · `oee` — 원시 누적(idleMs 등)이 매 delta 증가해 \"무변화 생략\" 을 무력화한다. shapeOee 로 정형화해 얹는다.\n */\nconst EXCLUDED = new Set(['id', 'epc', 'oee'])\n\n/**\n * OEE 원시 비율/카운트 → 표시용 정수 퍼센트 + 카운트.\n * 원시 누적 ms(idleMs 등)는 매 delta 증가해 무변화-생략을 무력화하므로 제외(유휴 자원의 매초 재방송 억제).\n * oee 미측정이면 undefined.\n */\nfunction shapeOee(o: any): any {\n  if (!o) return undefined\n  return {\n    overall: Math.round((o.overall ?? 0) * 100),\n    availability: Math.round((o.availability ?? 0) * 100),\n    performance: Math.round((o.performance ?? 0) * 100),\n    quality: Math.round((o.quality ?? 0) * 100),\n    good: o.goodCount ?? 0,\n    scrap: o.scrapCount ?? 0\n  }\n}\n\n/**\n * 엔티티 하나의 payload — `entity` 표식 + 나머지 전부(도메인 `kind` 포함).\n *\n * `undefined` 값은 싣지 않는다(키의 유무가 시그니처를 흔들지 않게). 값이 없는 것과 키가 없는 것은\n * 소비처에서 같으므로 안전하고, 무변화 생략이 잘 듣는다.\n */\nfunction payloadOf(entityKind: string, entity: any): any {\n  /* 표식은 `entity` — 도메인의 `kind` 를 덮지 않는다. */\n  const data: any = { entity: entityKind }\n  for (const [k, v] of Object.entries(entity ?? {})) {\n    if (EXCLUDED.has(k) || v === undefined) continue\n    data[k] = v\n  }\n  return data\n}\n\n/**\n * 집약 뷰의 항목 — 개별 payload 와 같은 내용 + 식별자.\n * 집약은 \"전체를 한 컴포넌트가 추적\" 하는 용도라 식별자가 있어야 한다.\n */\nfunction aggregateItem(entity: any, idKey: 'id' | 'epc'): any {\n  const out: any = { [idKey]: entity?.[idKey] }\n  for (const [k, v] of Object.entries(entity ?? {})) {\n    if (k === idKey || k === 'oee' || v === undefined) continue\n    out[k] = v\n  }\n  const shaped = shapeOee(entity?.oee)\n  if (shaped) out.oee = shaped\n  return out\n}\n\n/**\n * 물품 집약의 상한 — 큰 현장은 물품이 수만 개라, 전량을 매 방송에 실으면 전달이 현장을 느리게 한다.\n *\n * **조용히 자르지 않는다**: 넘치면 `total`(전체 수)과 `truncated`(잘린 수)를 함께 실어, 소비처가\n * \"이게 전부\" 라고 오해하지 않게 한다. 개별 물품은 태그별 delta 로 따로 나가고 그쪽은 시그니처 dedup\n * 이 걸려 **변한 것만** 재방송된다.\n */\nexport const ITEMS_AGGREGATE_LIMIT = 500\n\nexport function buildEntityDeltas(state: any, instanceId: string): EntityDelta[] {\n  const out: EntityDelta[] = []\n\n  for (const n of state?.locations ?? []) {\n    out.push({ tag: n.id, data: payloadOf('location', n) })\n  }\n  for (const m of state?.equipment ?? []) {\n    /* Mobile(location/motion) + Operable(status/held) + Processable(oee) — 한 payload 로.\n     * oee 만 정형화가 필요해 따로 얹는다(나머지는 통과). */\n    const data = payloadOf('equipment', m)\n    const oee = shapeOee(m?.oee)\n    if (oee) data.oee = oee\n    out.push({ tag: m.id, data })\n  }\n  /* 사람 — 설비와 별개 엔티티다. 같은 통과 규칙(가진 것을 전부 내보낸다). */\n  for (const p of state?.persons ?? []) {\n    out.push({ tag: p.id, data: payloadOf('person', p) })\n  }\n  /* 물리 자산(반복사용) — 물품도 설비도 아닌 네 번째 자원. */\n  for (const a of state?.assets ?? []) {\n    out.push({ tag: a.id, data: payloadOf('asset', a) })\n  }\n  for (const o of state?.orders ?? []) {\n    out.push({ tag: o.id, data: payloadOf('order', o) })\n  }\n  for (const t of state?.tasks ?? []) {\n    out.push({ tag: t.id, data: payloadOf('task', t) })\n  }\n  for (const it of state?.items ?? []) {\n    /* 물품의 태그는 epc(개체 식별자) — 노드·무버와 달리 id 가 아니다. */\n    if (it?.epc) out.push({ tag: it.epc, data: payloadOf('item', it) })\n  }\n\n  /* ── 집약 뷰 ──────────────────────────────────────────────────────────────\n   * 런타임에 생기고 사라지는 엔티티(오더·작업·물품)는 보드에 개별 배치할 수 없다 → 한 컴포넌트가\n   * 전체를 추적하는 집약 태그를 항상 방출한다. */\n  const orders = state?.orders ?? []\n  out.push({ tag: ordersTag(instanceId), data: { entity: 'orders', orders: orders.map((o: any) => aggregateItem(o, 'id')) } })\n\n  const tasks = state?.tasks ?? []\n  out.push({ tag: tasksTag(instanceId), data: { entity: 'tasks', tasks: tasks.map((t: any) => aggregateItem(t, 'id')) } })\n\n  /* 사람 집약 — 인원은 보드에 개별 배치할 수도 있지만(설비처럼), 전체를 한눈에 보는 소비처도 있다.\n   * 인원을 선언하지 않은 트윈에서는 빈 배열이 나간다(없음과 모름을 구별). */\n  const persons = state?.persons ?? []\n  out.push({ tag: personsTag(instanceId), data: { entity: 'persons', persons: persons.map((p: any) => aggregateItem(p, 'id')) } })\n\n  const assets = state?.assets ?? []\n  out.push({ tag: assetsTag(instanceId), data: { entity: 'assets', assets: assets.map((a: any) => aggregateItem(a, 'id')) } })\n\n  const items = state?.items ?? []\n  const shown = items.slice(0, ITEMS_AGGREGATE_LIMIT)\n  out.push({\n    tag: itemsTag(instanceId),\n    data: {\n      entity: 'items',\n      items: shown.map((it: any) => aggregateItem(it, 'epc')),\n      total: items.length,\n      /* 잘렸으면 그 사실을 말한다 — \"이게 전부\" 로 읽히면 재고를 과소 판단한다. */\n      ...(items.length > shown.length ? { truncated: items.length - shown.length } : {})\n    }\n  })\n\n  return out\n}\n"]}

package/dist-server/engine/index.d.ts

@@ -1,6 +1,12 @@
 export * from './twin-engine.js';
 export * from './canonical-ingest.js';
 export * from './kpi-fold.js';
+export * from './kpi-baseline.js';
+export * from './kpi-target.js';
+export * from './kpi-broadcast.js';
+export * from './entity-delta.js';
+export * from './twin-level.js';
+export * from './runtime-key.js';
 export * from './kpi-query.js';
 export * from './spec-coverage.js';
 export * from './travel-estimator.js';

package/dist-server/engine/index.js

@@ -4,6 +4,16 @@ const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./twin-engine.js"), exports);
 tslib_1.__exportStar(require("./canonical-ingest.js"), exports);
 tslib_1.__exportStar(require("./kpi-fold.js"), exports);
+tslib_1.__exportStar(require("./kpi-baseline.js"), exports);
+/* 지표 정본 표(TWIN_METRIC)·목표 판정 — 소비처(twin-ai 등)가 지표 이름을 다시 열거하지 않게. */
+tslib_1.__exportStar(require("./kpi-target.js"), exports);
+tslib_1.__exportStar(require("./kpi-broadcast.js"), exports);
+/* 집약 채널 태그(접두사 + 트윈별 태그 생성) — 소비처가 문자열을 다시 적지 않게 내보낸다. */
+tslib_1.__exportStar(require("./entity-delta.js"), exports);
+/* 공간 계층의 단계 — 씬 표현·성과 카드·AI 가 같은 목록을 쓴다. */
+tslib_1.__exportStar(require("./twin-level.js"), exports);
+/* 런타임 레지스트리 키 규약 — 소비처(다른 키 캐시·테스트)가 `:` 를 다시 적지 않게 함께 내보낸다. */
+tslib_1.__exportStar(require("./runtime-key.js"), exports);
 tslib_1.__exportStar(require("./kpi-query.js"), exports);
 tslib_1.__exportStar(require("./spec-coverage.js"), exports);
 tslib_1.__exportStar(require("./travel-estimator.js"), exports);

package/dist-server/engine/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/engine/index.ts"],"names":[],"mappings":";;;AAAA,2DAAgC;AAChC,gEAAqC;AACrC,wDAA6B;AAC7B,yDAA8B;AAC9B,6DAAkC;AAClC,gEAAqC;AACrC,kEAAuC;AACvC,2DAAgC","sourcesContent":["export * from './twin-engine.js'\nexport * from './canonical-ingest.js'\nexport * from './kpi-fold.js'\nexport * from './kpi-query.js'\nexport * from './spec-coverage.js'\nexport * from './travel-estimator.js'\nexport * from './measured-estimator.js'\nexport * from './model-basis.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/engine/index.ts"],"names":[],"mappings":";;;AAAA,2DAAgC;AAChC,gEAAqC;AACrC,wDAA6B;AAC7B,4DAAiC;AACjC,qEAAqE;AACrE,0DAA+B;AAC/B,6DAAkC;AAClC,0DAA0D;AAC1D,4DAAiC;AACjC,4CAA4C;AAC5C,0DAA+B;AAC/B,gEAAgE;AAChE,2DAAgC;AAChC,yDAA8B;AAC9B,6DAAkC;AAClC,gEAAqC;AACrC,kEAAuC;AACvC,2DAAgC","sourcesContent":["export * from './twin-engine.js'\nexport * from './canonical-ingest.js'\nexport * from './kpi-fold.js'\nexport * from './kpi-baseline.js'\n/* 지표 정본 표(TWIN_METRIC)·목표 판정 — 소비처(twin-ai 등)가 지표 이름을 다시 열거하지 않게. */\nexport * from './kpi-target.js'\nexport * from './kpi-broadcast.js'\n/* 집약 채널 태그(접두사 + 트윈별 태그 생성) — 소비처가 문자열을 다시 적지 않게 내보낸다. */\nexport * from './entity-delta.js'\n/* 공간 계층의 단계 — 씬 표현·성과 카드·AI 가 같은 목록을 쓴다. */\nexport * from './twin-level.js'\n/* 런타임 레지스트리 키 규약 — 소비처(다른 키 캐시·테스트)가 `:` 를 다시 적지 않게 함께 내보낸다. */\nexport * from './runtime-key.js'\nexport * from './kpi-query.js'\nexport * from './spec-coverage.js'\nexport * from './travel-estimator.js'\nexport * from './measured-estimator.js'\nexport * from './model-basis.js'\n"]}