@things-factory/headless-twin 10.0.8 → 10.0.10

package/dist-shared/axis-read.js

@@ -0,0 +1,32 @@
+"use strict";
+/*
+ * 축의 값을 **어디서 읽나** — 규칙 한 곳. (design/profiles/ems.md §10 6.5단계)
+ *
+ * ── 왜 함수로 빼나 ─────────────────────────────────────────────────────────
+ * 개념 지도는 상태 축을 `state[축이름]` 으로 읽고 있었다. 에너지의 수요 구간은 `state.energy.closed`
+ * 에 살아서 그 규칙으로는 **언제나 `undefined`** 다 — 카드가 「관측 없음」으로 굳고, 원인은 화면도
+ * 서버도 말해 주지 않는다(축은 선언돼 있고 상태에도 값이 있는데 이름이 안 맞을 뿐이다).
+ *
+ * 커널 선언이 이미 그 자리를 말한다(`TwinAxisInfo.path`). 그래서 규칙은 한 줄이다:
+ * **경로가 있으면 그 경로로, 없으면 축 이름으로.** 리졸버 안에 두면 시험이 DB 를 물어야 하므로
+ * 순수 함수로 빼 둔다.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.atPath = atPath;
+exports.axisValueOf = axisValueOf;
+/** 중첩 경로를 따라간다 — 중간이 없으면 `undefined`(빈 객체로 메우지 않는다). */
+function atPath(obj, path) {
+    return path.split('.').reduce((o, k) => (o == null ? undefined : o[k]), obj);
+}
+/**
+ * 그 축의 값 — 배열이면 목록, 객체면 그릇, 없으면 `undefined`.
+ *
+ * `undefined` 와 빈 배열은 **다르다**: 앞은 「모른다·아직 안 옴」이고 뒤는 「없다」다. 이 함수는 그
+ * 구별을 지우지 않는다 — 소비처가 `emptyBecause` 를 그 차이로 만든다.
+ */
+function axisValueOf(state, axis) {
+    if (!state || !axis?.axis)
+        return undefined;
+    return axis.path ? atPath(state, axis.path) : state[axis.axis];
+}
+//# sourceMappingURL=axis-read.js.map

package/dist-shared/axis-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"axis-read.js","sourceRoot":"","sources":["../shared/axis-read.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AAGH,wBAEC;AAQD,kCAGC;AAdD,wDAAwD;AACxD,SAAgB,MAAM,CAAC,GAAQ,EAAE,IAAY;IAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AAC3F,CAAC;AAED;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,KAAU,EAAE,IAAqC;IAC3E,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,IAAI;QAAE,OAAO,SAAS,CAAA;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAChE,CAAC","sourcesContent":["/*\n * 축의 값을 **어디서 읽나** — 규칙 한 곳. (design/profiles/ems.md §10 6.5단계)\n *\n * ── 왜 함수로 빼나 ─────────────────────────────────────────────────────────\n * 개념 지도는 상태 축을 `state[축이름]` 으로 읽고 있었다. 에너지의 수요 구간은 `state.energy.closed`\n * 에 살아서 그 규칙으로는 **언제나 `undefined`** 다 — 카드가 「관측 없음」으로 굳고, 원인은 화면도\n * 서버도 말해 주지 않는다(축은 선언돼 있고 상태에도 값이 있는데 이름이 안 맞을 뿐이다).\n *\n * 커널 선언이 이미 그 자리를 말한다(`TwinAxisInfo.path`). 그래서 규칙은 한 줄이다:\n * **경로가 있으면 그 경로로, 없으면 축 이름으로.** 리졸버 안에 두면 시험이 DB 를 물어야 하므로\n * 순수 함수로 빼 둔다.\n */\n\n/** 중첩 경로를 따라간다 — 중간이 없으면 `undefined`(빈 객체로 메우지 않는다). */\nexport function atPath(obj: any, path: string): any {\n  return path.split('.').reduce((o: any, k: string) => (o == null ? undefined : o[k]), obj)\n}\n\n/**\n * 그 축의 값 — 배열이면 목록, 객체면 그릇, 없으면 `undefined`.\n *\n * `undefined` 와 빈 배열은 **다르다**: 앞은 「모른다·아직 안 옴」이고 뒤는 「없다」다. 이 함수는 그\n * 구별을 지우지 않는다 — 소비처가 `emptyBecause` 를 그 차이로 만든다.\n */\nexport function axisValueOf(state: any, axis: { axis: string; path?: string }): any {\n  if (!state || !axis?.axis) return undefined\n  return axis.path ? atPath(state, axis.path) : state[axis.axis]\n}\n"]}

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

@@ -0,0 +1,29 @@
+export interface EntityDelta {
+    tag: string;
+    data: any;
+}
+/** 집약 고정 태그 — 클라 provider 와 일치해야 한다(런타임 생성 엔티티는 개별 배치가 불가하므로 집약 뷰). */
+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 const ENERGY_TAG_PREFIX = "__energy__";
+/** 이 트윈의 집약 채널 태그. 트윈 식별자가 없으면 만들지 않는다 — 덮어쓰기의 원인이었다. */
+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;
+export declare const energyTag: (instanceId: string) => string;
+/**
+ * 물품 집약의 상한 — 큰 현장은 물품이 수만 개라, 전량을 매 방송에 실으면 전달이 현장을 느리게 한다.
+ *
+ * **조용히 자르지 않는다**: 넘치면 `total`(전체 수)과 `truncated`(잘린 수)를 함께 실어, 소비처가
+ * "이게 전부" 라고 오해하지 않게 한다. 개별 물품은 태그별 delta 로 따로 나가고 그쪽은 시그니처 dedup
+ * 이 걸려 **변한 것만** 재방송된다.
+ */
+export declare const ITEMS_AGGREGATE_LIMIT = 500;
+export declare function buildEntityDeltas(state: any, instanceId: string): EntityDelta[];

package/dist-shared/entity-delta.js

@@ -0,0 +1,287 @@
+"use strict";
+/*
+ * 트윈 State 스냅샷 → 라이브 바인딩 delta 목록 (순수 매핑 — pubsub/도메인 무관 → 단위 테스트 가능).
+ * publishEntityData 가 이 목록을 엔티티별 시그니처로 dedup 후 data(tag) 채널로 발행한다.
+ *
+ * ── 규율: 레퍼런스가 아는 것은 **전부** 내보낸다 ────────────────────────────
+ * 트윈에서 사소한 속성은 없다. 소속 구역·소속 팔레트·수량·만료처럼 곁가지로 보이는 값이 실제로는
+ * 구역 롤업·적재 표현·로트 추적의 전제다. 그래서 여기서 **필드를 손으로 골라 담지 않는다.**
+ *
+ * 예전에는 엔티티마다 필요할 것 같은 필드만 열거했고, 그 결과 계약에 있는 것이 조용히 누락됐다
+ * (2026-08-01 감사: 노드 parentId 누락 · 작업 전량 누락 · 물품 전량 누락). 화이트리스트 방식은
+ * **계약이 자라도 화면이 따라오지 못한다** — 커널이 속성을 늘릴 때마다 이 파일을 고쳐야 하고, 고치는
+ * 것을 잊으면 아무 신호 없이 정보가 사라진다.
+ *
+ * 그래서 반대로 한다: **상태 객체가 가진 것을 그대로 통과**시키고, 통과시키지 **않을** 것만 이유와 함께
+ * 열거한다(EXCLUDED). 새 속성은 자동으로 화면에 도달하고, 빼려면 이유를 적어야 한다.
+ *
+ * ── 표식은 도메인 낱말을 훔치지 않는다 ─────────────────────────────────────
+ * 예전 payload 는 엔티티 종류 표식을 `kind` 로 실었다. 그런데 `kind` 는 **도메인의 낱말**이다 —
+ * 무버 kind=cutter, 작업 kind=putaway, 오더 kind=workorder. 표식이 그 이름을 차지하면 도메인 속성을
+ * 실을 자리가 없어진다(같은 병을 오늘 ox-timeline 의 `group` 에서도 고쳤다).
+ * 그래서 표식은 `entity`(우리 이름)로 옮기고 `kind` 는 도메인에 돌려준다.
+ *
+ * payload 계약(씬 컴포넌트가 소비): `entity`(표식) + 그 엔티티의 모든 속성(도메인 `kind` 포함).
+ *   entity = location · equipment · person · asset · order · task · item,
+ *   그리고 집약 태그(__orders__ · __tasks__ · __items__ · __persons__ · __assets__).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ITEMS_AGGREGATE_LIMIT = exports.energyTag = exports.assetsTag = exports.personsTag = exports.itemsTag = exports.tasksTag = exports.ordersTag = exports.ENERGY_TAG_PREFIX = 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 와 일치해야 한다(런타임 생성 엔티티는 개별 배치가 불가하므로 집약 뷰). */
+/*
+ * 집약 채널의 접두사 — **실제 태그는 트윈 식별자를 붙여 만든다.**
+ *
+ * 예전에는 이 상수가 곧 태그였다. 그런데 발행 키는 (도메인, 태그)이고, **한 공간에 트윈이 여럿**
+ * 있으면(실측: 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__';
+/** 에너지 집약 — 수요 구간·피크·계약은 **트윈 하나의 사실**이라 개체 태그가 없다. */
+exports.ENERGY_TAG_PREFIX = '__energy__';
+/** 이 트윈의 집약 채널 태그. 트윈 식별자가 없으면 만들지 않는다 — 덮어쓰기의 원인이었다. */
+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;
+const energyTag = (instanceId) => aggregateTag(exports.ENERGY_TAG_PREFIX, instanceId);
+exports.energyTag = energyTag;
+/**
+ * 통과시키지 않는 필드 — **빼는 데는 이유가 필요하다.**
+ *
+ * · `id`/`epc` — 태그로 이미 나가므로 개별 payload 에 중복해 싣지 않는다(집약 뷰에는 넣는다).
+ * · `oee` — 원시 누적(idleMs 등)이 매 delta 증가해 "무변화 생략" 을 무력화한다. shapeOee 로 정형화해 얹는다.
+ */
+const EXCLUDED = new Set(['id', 'epc', 'oee']);
+/**
+ * OEE 원시 비율/카운트 → 표시용 정수 퍼센트 + 카운트.
+ * 원시 누적 ms(idleMs 등)는 매 delta 증가해 무변화-생략을 무력화하므로 제외(유휴 자원의 매초 재방송 억제).
+ * oee 미측정이면 undefined.
+ */
+function shapeOee(o) {
+    if (!o)
+        return undefined;
+    return {
+        overall: Math.round((o.overall ?? 0) * 100),
+        availability: Math.round((o.availability ?? 0) * 100),
+        performance: Math.round((o.performance ?? 0) * 100),
+        quality: Math.round((o.quality ?? 0) * 100),
+        good: o.goodCount ?? 0,
+        scrap: o.scrapCount ?? 0
+    };
+}
+/**
+ * 엔티티 하나의 payload — `entity` 표식 + 나머지 전부(도메인 `kind` 포함).
+ *
+ * `undefined` 값은 싣지 않는다(키의 유무가 시그니처를 흔들지 않게). 값이 없는 것과 키가 없는 것은
+ * 소비처에서 같으므로 안전하고, 무변화 생략이 잘 듣는다.
+ */
+function payloadOf(entityKind, entity) {
+    /* 표식은 `entity` — 도메인의 `kind` 를 덮지 않는다. */
+    const data = { entity: entityKind };
+    for (const [k, v] of Object.entries(entity ?? {})) {
+        if (EXCLUDED.has(k) || v === undefined)
+            continue;
+        data[k] = v;
+    }
+    return data;
+}
+/**
+ * 집약 뷰의 항목 — 개별 payload 와 같은 내용 + 식별자.
+ * 집약은 "전체를 한 컴포넌트가 추적" 하는 용도라 식별자가 있어야 한다.
+ */
+function aggregateItem(entity, idKey) {
+    const out = { [idKey]: entity?.[idKey] };
+    for (const [k, v] of Object.entries(entity ?? {})) {
+        if (k === idKey || k === 'oee' || v === undefined)
+            continue;
+        out[k] = v;
+    }
+    const shaped = shapeOee(entity?.oee);
+    if (shaped)
+        out.oee = shaped;
+    return out;
+}
+/**
+ * 물품 집약의 상한 — 큰 현장은 물품이 수만 개라, 전량을 매 방송에 실으면 전달이 현장을 느리게 한다.
+ *
+ * **조용히 자르지 않는다**: 넘치면 `total`(전체 수)과 `truncated`(잘린 수)를 함께 실어, 소비처가
+ * "이게 전부" 라고 오해하지 않게 한다. 개별 물품은 태그별 delta 로 따로 나가고 그쪽은 시그니처 dedup
+ * 이 걸려 **변한 것만** 재방송된다.
+ */
+exports.ITEMS_AGGREGATE_LIMIT = 500;
+/**
+ * 자리별 에너지 — **그 자리의 계량기들이 잰 것**을 그 자리 태그에 실을 수 있게 모은다.
+ *
+ * ── 왜 자리에도 필요한가 (2026-08-14) ───────────────────────────────────────
+ * 카탈로그는 자리에도 `metered` 를 준다(수전·분기·구역 계량은 재는 자리다). 그런데 값은 계량기
+ * **설비** 태그로만 나갔다. 그래서 계통도의 분기 자리에 계량 컴포넌트를 놓으면 **영원히 「—」** 였다 —
+ * 능력은 「잰다」고 말하는데 값이 오지 않는 자리.
+ *
+ * 「이 구간이 얼마를 먹나」는 자리의 사실이고, 사람은 계통도의 자리에 붙여 본다.
+ *
+ * ── 계층은 여기서 문제가 되지 않는다 ────────────────────────────────────────
+ * 각 자리에는 **그 자리에 붙은 계량기만** 더한다(수전 자리에는 수전 계량기, 분기 자리에는 그 분기의
+ * 것). 커널이 부하를 뿌리로만 세는 것과 다른 층의 계산이다 — 여기서는 자리마다 자기 것을 말한다.
+ *
+ * 근거를 함께 낸다(`meters`) — 그 자리의 수가 어느 계량기에서 왔는지 되짚을 수 있어야 한다.
+ */
+function energyByLocation(state) {
+    const out = new Map();
+    const points = state?.energy?.points;
+    if (!Array.isArray(points) || !points.length)
+        return out;
+    /* 계량기 → 자리. 자리를 모르는 계량기는 자리 payload 에 실을 데가 없다(설비 태그로만 나간다). */
+    const locOf = new Map();
+    for (const e of state?.equipment ?? [])
+        if (e?.id && e?.homeLocation)
+            locOf.set(e.id, e.homeLocation);
+    for (const pt of points) {
+        const loc = pt?.id ? locOf.get(pt.id) : undefined;
+        if (!loc)
+            continue;
+        const acc = out.get(loc) ?? { meters: [], samplesInWindow: 0 };
+        acc.meters.push(pt.id);
+        acc.samplesInWindow = Number(acc.samplesInWindow ?? 0) + (Number(pt.samplesInWindow) || 0);
+        /* 값은 **있는 것만** 더한다 — 하나도 없으면 키를 만들지 않는다(0 은 「안 썼다」가 된다). */
+        if (Number.isFinite(Number(pt.kW)))
+            acc.kW = Number(acc.kW ?? 0) + Number(pt.kW);
+        if (Number.isFinite(Number(pt.kWh)))
+            acc.kWh = Number(acc.kWh ?? 0) + Number(pt.kWh);
+        /* 나이는 **가장 최근**을 쓴다 — 자리에 계량기가 여럿이면 그중 마지막 관측이 그 자리의 나이다. */
+        if (pt.atMs !== undefined) {
+            const iso = new Date(Number(pt.atMs)).toISOString();
+            if (!acc.measuredAt || String(acc.measuredAt) < iso)
+                acc.measuredAt = iso;
+        }
+        out.set(loc, acc);
+    }
+    return out;
+}
+function buildEntityDeltas(state, instanceId) {
+    const out = [];
+    const locEnergy = energyByLocation(state);
+    for (const n of state?.locations ?? []) {
+        /* 에너지는 자리 payload 에 **합친다** — 같은 태그로 두 번 보내면 뒤엣것이 앞을 덮는다. */
+        const energy = locEnergy.get(n.id);
+        out.push({ tag: n.id, data: energy ? { ...payloadOf('location', n), ...energy } : payloadOf('location', n) });
+    }
+    for (const m of state?.equipment ?? []) {
+        /* Mobile(location/motion) + Operable(status/held) + Processable(oee) — 한 payload 로.
+         * oee 만 정형화가 필요해 따로 얹는다(나머지는 통과). */
+        const data = payloadOf('equipment', m);
+        const oee = shapeOee(m?.oee);
+        if (oee)
+            data.oee = oee;
+        out.push({ tag: m.id, data });
+    }
+    /* 사람 — 설비와 별개 엔티티다. 같은 통과 규칙(가진 것을 전부 내보낸다). */
+    for (const p of state?.persons ?? []) {
+        out.push({ tag: p.id, data: payloadOf('person', p) });
+    }
+    /* 물리 자산(반복사용) — 물품도 설비도 아닌 네 번째 자원. */
+    for (const a of state?.assets ?? []) {
+        out.push({ tag: a.id, data: payloadOf('asset', a) });
+    }
+    for (const o of state?.orders ?? []) {
+        out.push({ tag: o.id, data: payloadOf('order', o) });
+    }
+    for (const t of state?.tasks ?? []) {
+        out.push({ tag: t.id, data: payloadOf('task', t) });
+    }
+    for (const it of state?.items ?? []) {
+        /* 물품의 태그는 epc(개체 식별자) — 노드·무버와 달리 id 가 아니다. */
+        if (it?.epc)
+            out.push({ tag: it.epc, data: payloadOf('item', it) });
+    }
+    /* ── 집약 뷰 ──────────────────────────────────────────────────────────────
+     * 런타임에 생기고 사라지는 엔티티(오더·작업·물품)는 보드에 개별 배치할 수 없다 → 한 컴포넌트가
+     * 전체를 추적하는 집약 태그를 항상 방출한다. */
+    const orders = state?.orders ?? [];
+    out.push({ tag: (0, exports.ordersTag)(instanceId), data: { entity: 'orders', orders: orders.map((o) => aggregateItem(o, 'id')) } });
+    const tasks = state?.tasks ?? [];
+    out.push({ tag: (0, exports.tasksTag)(instanceId), data: { entity: 'tasks', tasks: tasks.map((t) => aggregateItem(t, 'id')) } });
+    /* 사람 집약 — 인원은 보드에 개별 배치할 수도 있지만(설비처럼), 전체를 한눈에 보는 소비처도 있다.
+     * 인원을 선언하지 않은 트윈에서는 빈 배열이 나간다(없음과 모름을 구별). */
+    const persons = state?.persons ?? [];
+    out.push({ tag: (0, exports.personsTag)(instanceId), data: { entity: 'persons', persons: persons.map((p) => aggregateItem(p, 'id')) } });
+    const assets = state?.assets ?? [];
+    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: (0, exports.itemsTag)(instanceId),
+        data: {
+            entity: 'items',
+            items: shown.map((it) => aggregateItem(it, 'epc')),
+            total: items.length,
+            /* 잘렸으면 그 사실을 말한다 — "이게 전부" 로 읽히면 재고를 과소 판단한다. */
+            ...(items.length > shown.length ? { truncated: items.length - shown.length } : {})
+        }
+    });
+    /*
+     * ── 에너지 (EMS) ─────────────────────────────────────────────────────────
+     *
+     * 계측은 `state.energy` 에 산다 — 자원 축(`equipment`·`locations`)이 아니다. 그래서 이 매핑이 없으면
+     * 보드에 놓은 계량기가 **아무 값도 받지 못한다**(컴포넌트는 있는데 영원히 빈 모습).
+     *
+     * 두 갈래로 낸다:
+     *  · **개체별** — 계량 지점 하나하나의 마지막 관측(kW·kWh·역률·시각). 태그는 그 설비 id 다.
+     *  · **집약** — 수요 구간·피크·계약전력. 이것은 트윈 하나의 사실이라 개체에 실을 수 없다.
+     *
+     * 값이 없으면 **키를 넣지 않는다**(0 으로 만들지 않는다) — 「못 읽었다」와 「0 이었다」는 다른 사실이고,
+     * 그 구별이 이 트윈의 값어치다.
+     */
+    const energy = state?.energy;
+    if (energy) {
+        for (const pt of energy.points ?? []) {
+            if (!pt?.id)
+                continue;
+            out.push({
+                tag: pt.id,
+                data: {
+                    entity: 'meter',
+                    ...(pt.kW !== undefined ? { kW: pt.kW } : {}),
+                    ...(pt.kWh !== undefined ? { kWh: pt.kWh } : {}),
+                    ...(pt.powerFactor !== undefined ? { powerFactor: pt.powerFactor } : {}),
+                    /* 마지막 표본 시각 — 계측이 끊긴 것을 화면이 스스로 알 수 있게(우리가 판정하지 않는다). */
+                    ...(pt.atMs !== undefined ? { measuredAt: new Date(pt.atMs).toISOString() } : {}),
+                    samplesInWindow: pt.samplesInWindow ?? 0
+                }
+            });
+        }
+        out.push({
+            tag: (0, exports.energyTag)(instanceId),
+            data: {
+                entity: 'energy',
+                ...(energy.contractKW !== undefined ? { contractKW: energy.contractKW } : {}),
+                ...(energy.open ? { open: energy.open } : {}),
+                ...(energy.peakSince ? { peakSince: energy.peakSince } : {}),
+                /* 마감된 구간은 **최근 것만** 낸다 — 하루치를 매 방송에 실으면 채널이 그것으로 찬다.
+                   전체 수는 함께 낸다(조용히 자르지 않는다). */
+                recent: (energy.closed ?? []).slice(-8),
+                closedTotal: energy.closedTotal ?? 0
+            }
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=entity-delta.js.map

package/dist-shared/entity-delta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-delta.js","sourceRoot":"","sources":["../shared/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 와 일치해야 한다(런타임 생성 엔티티는 개별 배치가 불가하므로 집약 뷰). */\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/** 에너지 집약 — 수요 구간·피크·계약은 **트윈 하나의 사실**이라 개체 태그가 없다. */\nexport const ENERGY_TAG_PREFIX = '__energy__'\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)\nexport const energyTag = (instanceId: string) => aggregateTag(ENERGY_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\n/**\n * 자리별 에너지 — **그 자리의 계량기들이 잰 것**을 그 자리 태그에 실을 수 있게 모은다.\n *\n * ── 왜 자리에도 필요한가 (2026-08-14) ───────────────────────────────────────\n * 카탈로그는 자리에도 `metered` 를 준다(수전·분기·구역 계량은 재는 자리다). 그런데 값은 계량기\n * **설비** 태그로만 나갔다. 그래서 계통도의 분기 자리에 계량 컴포넌트를 놓으면 **영원히 「—」** 였다 —\n * 능력은 「잰다」고 말하는데 값이 오지 않는 자리.\n *\n * 「이 구간이 얼마를 먹나」는 자리의 사실이고, 사람은 계통도의 자리에 붙여 본다.\n *\n * ── 계층은 여기서 문제가 되지 않는다 ────────────────────────────────────────\n * 각 자리에는 **그 자리에 붙은 계량기만** 더한다(수전 자리에는 수전 계량기, 분기 자리에는 그 분기의\n * 것). 커널이 부하를 뿌리로만 세는 것과 다른 층의 계산이다 — 여기서는 자리마다 자기 것을 말한다.\n *\n * 근거를 함께 낸다(`meters`) — 그 자리의 수가 어느 계량기에서 왔는지 되짚을 수 있어야 한다.\n */\nfunction energyByLocation(state: any): Map<string, Record<string, unknown>> {\n  const out = new Map<string, Record<string, unknown>>()\n  const points = state?.energy?.points\n  if (!Array.isArray(points) || !points.length) return out\n\n  /* 계량기 → 자리. 자리를 모르는 계량기는 자리 payload 에 실을 데가 없다(설비 태그로만 나간다). */\n  const locOf = new Map<string, string>()\n  for (const e of state?.equipment ?? []) if (e?.id && e?.homeLocation) locOf.set(e.id, e.homeLocation)\n\n  for (const pt of points) {\n    const loc = pt?.id ? locOf.get(pt.id) : undefined\n    if (!loc) continue\n    const acc = out.get(loc) ?? { meters: [] as string[], samplesInWindow: 0 }\n    ;(acc.meters as string[]).push(pt.id)\n    acc.samplesInWindow = Number(acc.samplesInWindow ?? 0) + (Number(pt.samplesInWindow) || 0)\n    /* 값은 **있는 것만** 더한다 — 하나도 없으면 키를 만들지 않는다(0 은 「안 썼다」가 된다). */\n    if (Number.isFinite(Number(pt.kW))) acc.kW = Number(acc.kW ?? 0) + Number(pt.kW)\n    if (Number.isFinite(Number(pt.kWh))) acc.kWh = Number(acc.kWh ?? 0) + Number(pt.kWh)\n    /* 나이는 **가장 최근**을 쓴다 — 자리에 계량기가 여럿이면 그중 마지막 관측이 그 자리의 나이다. */\n    if (pt.atMs !== undefined) {\n      const iso = new Date(Number(pt.atMs)).toISOString()\n      if (!acc.measuredAt || String(acc.measuredAt) < iso) acc.measuredAt = iso\n    }\n    out.set(loc, acc)\n  }\n  return out\n}\n\nexport function buildEntityDeltas(state: any, instanceId: string): EntityDelta[] {\n  const out: EntityDelta[] = []\n  const locEnergy = energyByLocation(state)\n\n  for (const n of state?.locations ?? []) {\n    /* 에너지는 자리 payload 에 **합친다** — 같은 태그로 두 번 보내면 뒤엣것이 앞을 덮는다. */\n    const energy = locEnergy.get(n.id)\n    out.push({ tag: n.id, data: energy ? { ...payloadOf('location', n), ...energy } : 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  /*\n   * ── 에너지 (EMS) ─────────────────────────────────────────────────────────\n   *\n   * 계측은 `state.energy` 에 산다 — 자원 축(`equipment`·`locations`)이 아니다. 그래서 이 매핑이 없으면\n   * 보드에 놓은 계량기가 **아무 값도 받지 못한다**(컴포넌트는 있는데 영원히 빈 모습).\n   *\n   * 두 갈래로 낸다:\n   *  · **개체별** — 계량 지점 하나하나의 마지막 관측(kW·kWh·역률·시각). 태그는 그 설비 id 다.\n   *  · **집약** — 수요 구간·피크·계약전력. 이것은 트윈 하나의 사실이라 개체에 실을 수 없다.\n   *\n   * 값이 없으면 **키를 넣지 않는다**(0 으로 만들지 않는다) — 「못 읽었다」와 「0 이었다」는 다른 사실이고,\n   * 그 구별이 이 트윈의 값어치다.\n   */\n  const energy = state?.energy\n  if (energy) {\n    for (const pt of energy.points ?? []) {\n      if (!pt?.id) continue\n      out.push({\n        tag: pt.id,\n        data: {\n          entity: 'meter',\n          ...(pt.kW !== undefined ? { kW: pt.kW } : {}),\n          ...(pt.kWh !== undefined ? { kWh: pt.kWh } : {}),\n          ...(pt.powerFactor !== undefined ? { powerFactor: pt.powerFactor } : {}),\n          /* 마지막 표본 시각 — 계측이 끊긴 것을 화면이 스스로 알 수 있게(우리가 판정하지 않는다). */\n          ...(pt.atMs !== undefined ? { measuredAt: new Date(pt.atMs).toISOString() } : {}),\n          samplesInWindow: pt.samplesInWindow ?? 0\n        }\n      })\n    }\n    out.push({\n      tag: energyTag(instanceId),\n      data: {\n        entity: 'energy',\n        ...(energy.contractKW !== undefined ? { contractKW: energy.contractKW } : {}),\n        ...(energy.open ? { open: energy.open } : {}),\n        ...(energy.peakSince ? { peakSince: energy.peakSince } : {}),\n        /* 마감된 구간은 **최근 것만** 낸다 — 하루치를 매 방송에 실으면 채널이 그것으로 찬다.\n           전체 수는 함께 낸다(조용히 자르지 않는다). */\n        recent: (energy.closed ?? []).slice(-8),\n        closedTotal: energy.closedTotal ?? 0\n      }\n    })\n  }\n\n  return out\n}\n"]}

package/dist-shared/kpi-broadcast.d.ts

@@ -0,0 +1,4 @@
+export declare const KPI_TAG_PREFIX = "__kpi__";
+/** 이 트윈의 구간 성과 태그. */
+export declare const kpiTag: (instanceId: string) => string;
+/** 표식은 `entity` 로 — `kind` 는 도메인의 낱말이라 표식이 훔치지 않는다(`entity-delta.ts` 와 같은 규약). */

package/dist-shared/kpi-broadcast.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.kpiTag = exports.KPI_TAG_PREFIX = void 0;
+/*
+ * 구간 성과 카드의 **대상 식별자**.
+ *
+ * 예전에는 이 파일이 방송 payload 도 만들었다(`shapeKpiBroadcast`). 2026-08-06 에 방송을 없애고 카드가
+ * `twinKpi` 를 직접 묻게 바꿔서, 남은 것은 팔레트가 대상을 가리킬 때 쓰는 식별자뿐이다.
+ * 왜 바꿨는지는 `twin-engine.ts` 의 주석과 `operato-twin/client/scene/twin-kpi-source.ts` 에 있다.
+ */
+exports.KPI_TAG_PREFIX = '__kpi__';
+/** 이 트윈의 구간 성과 태그. */
+const kpiTag = (instanceId) => `${exports.KPI_TAG_PREFIX}:${instanceId}`;
+exports.kpiTag = kpiTag;
+/** 표식은 `entity` 로 — `kind` 는 도메인의 낱말이라 표식이 훔치지 않는다(`entity-delta.ts` 와 같은 규약). */
+//# sourceMappingURL=kpi-broadcast.js.map

package/dist-shared/kpi-broadcast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kpi-broadcast.js","sourceRoot":"","sources":["../shared/kpi-broadcast.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACU,QAAA,cAAc,GAAG,SAAS,CAAA;AAEvC,sBAAsB;AACf,MAAM,MAAM,GAAG,CAAC,UAAkB,EAAE,EAAE,CAAC,GAAG,sBAAc,IAAI,UAAU,EAAE,CAAA;AAAlE,QAAA,MAAM,UAA4D;AAE/E,kFAAkF","sourcesContent":["/*\n * 구간 성과 카드의 **대상 식별자**.\n *\n * 예전에는 이 파일이 방송 payload 도 만들었다(`shapeKpiBroadcast`). 2026-08-06 에 방송을 없애고 카드가\n * `twinKpi` 를 직접 묻게 바꿔서, 남은 것은 팔레트가 대상을 가리킬 때 쓰는 식별자뿐이다.\n * 왜 바꿨는지는 `twin-engine.ts` 의 주석과 `operato-twin/client/scene/twin-kpi-source.ts` 에 있다.\n */\nexport const KPI_TAG_PREFIX = '__kpi__'\n\n/** 이 트윈의 구간 성과 태그. */\nexport const kpiTag = (instanceId: string) => `${KPI_TAG_PREFIX}:${instanceId}`\n\n/** 표식은 `entity` 로 — `kind` 는 도메인의 낱말이라 표식이 훔치지 않는다(`entity-delta.ts` 와 같은 규약). */\n"]}

package/dist-shared/twin-level.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 성과를 접을 수 있는 단계 — 좁은 것부터.
+ *
+ * `equipment` 는 커널 축 이름으로 `resource` 다(설비·인원·자산을 아우르는 이름). 화면과 AI 는
+ * "설비" 로 말하고, 커널에 물을 때만 축 이름으로 바꾼다 — 그 변환이 아래 한 곳에 있다.
+ */
+export declare const TWIN_LEVELS: readonly ["space", "twin", "area", "location", "equipment"];
+export type TwinLevel = (typeof TWIN_LEVELS)[number];
+export declare function isTwinLevel(v: unknown): v is TwinLevel;
+/**
+ * 단계 → 커널의 나누는 축(`KpiGroupBy`). **전체를 보는 단계는 축이 없다** — 나누지 않고 통째로 접는다.
+ *
+ * `space` 와 `twin` 이 축 없이 같은 이유: 둘의 차이는 "무엇을 대상으로 삼는가"(공간 전체 대 트윈 하나)이지
+ * "어떻게 나누는가" 가 아니다. 대상은 질의의 `spaceId`/`instanceId` 가 정한다.
+ */
+export declare function kpiGroupByOfLevel(level: TwinLevel): 'area' | 'location' | 'resource' | undefined;
+/**
+ * 그 단계의 카드가 **대상 하나마다 한 장**인가.
+ *
+ * 구역·자리·설비는 여럿이라 카드가 그 수만큼 생긴다. 공간·트윈은 하나뿐이다. 보드를 자동으로 조립할 때
+ * 몇 장이 생길지 미리 알아야 한다 — 자리 200개 × 지표 4개면 800장이다.
+ */
+export declare function isPerTargetLevel(level: TwinLevel): boolean;

package/dist-shared/twin-level.js

@@ -0,0 +1,52 @@
+"use strict";
+/*
+ * 공간 계층의 **단계** — 성과를 어느 단위로 보는가. 순수(import 없음).
+ *
+ * ── 왜 여기 있나 ───────────────────────────────────────────────────────────
+ * 이 목록을 세 곳이 쓴다: 씬 표현이 "나는 어느 단계에 붙는다" 고 선언할 때(클라이언트), 성과 카드가
+ * "이 단계로 나눠 달라" 고 물을 때(클라이언트), AI 가 "구역별로 보여 줘" 를 제안할 때(서버).
+ * 세 곳이 각자 목록을 적으면 하나가 늘 때 나머지가 조용히 뒤처진다 — 집약 태그에서 이미 겪었다.
+ *
+ * 그래서 **한 곳**에 두고 셋이 가져다 쓴다. 이 파일은 import 가 없어 클라이언트 번들에 서버 코드를
+ * 끌고 들어가지 않는다.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TWIN_LEVELS = void 0;
+exports.isTwinLevel = isTwinLevel;
+exports.kpiGroupByOfLevel = kpiGroupByOfLevel;
+exports.isPerTargetLevel = isPerTargetLevel;
+/**
+ * 성과를 접을 수 있는 단계 — 좁은 것부터.
+ *
+ * `equipment` 는 커널 축 이름으로 `resource` 다(설비·인원·자산을 아우르는 이름). 화면과 AI 는
+ * "설비" 로 말하고, 커널에 물을 때만 축 이름으로 바꾼다 — 그 변환이 아래 한 곳에 있다.
+ */
+exports.TWIN_LEVELS = ['space', 'twin', 'area', 'location', 'equipment'];
+function isTwinLevel(v) {
+    return typeof v === 'string' && exports.TWIN_LEVELS.includes(v);
+}
+/**
+ * 단계 → 커널의 나누는 축(`KpiGroupBy`). **전체를 보는 단계는 축이 없다** — 나누지 않고 통째로 접는다.
+ *
+ * `space` 와 `twin` 이 축 없이 같은 이유: 둘의 차이는 "무엇을 대상으로 삼는가"(공간 전체 대 트윈 하나)이지
+ * "어떻게 나누는가" 가 아니다. 대상은 질의의 `spaceId`/`instanceId` 가 정한다.
+ */
+function kpiGroupByOfLevel(level) {
+    if (level === 'area')
+        return 'area';
+    if (level === 'location')
+        return 'location';
+    if (level === 'equipment')
+        return 'resource';
+    return undefined;
+}
+/**
+ * 그 단계의 카드가 **대상 하나마다 한 장**인가.
+ *
+ * 구역·자리·설비는 여럿이라 카드가 그 수만큼 생긴다. 공간·트윈은 하나뿐이다. 보드를 자동으로 조립할 때
+ * 몇 장이 생길지 미리 알아야 한다 — 자리 200개 × 지표 4개면 800장이다.
+ */
+function isPerTargetLevel(level) {
+    return kpiGroupByOfLevel(level) !== undefined;
+}
+//# sourceMappingURL=twin-level.js.map

package/dist-shared/twin-level.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"twin-level.js","sourceRoot":"","sources":["../shared/twin-level.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAWH,kCAEC;AAQD,8CAMC;AAQD,4CAEC;AAnCD;;;;;GAKG;AACU,QAAA,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,CAAU,CAAA;AAGtF,SAAgB,WAAW,CAAC,CAAU;IACpC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAK,mBAAiC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;AAChF,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,KAAgB;IAChD,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,MAAM,CAAA;IACnC,IAAI,KAAK,KAAK,UAAU;QAAE,OAAO,UAAU,CAAA;IAC3C,IAAI,KAAK,KAAK,WAAW;QAAE,OAAO,UAAU,CAAA;IAE5C,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,KAAgB;IAC/C,OAAO,iBAAiB,CAAC,KAAK,CAAC,KAAK,SAAS,CAAA;AAC/C,CAAC","sourcesContent":["/*\n * 공간 계층의 **단계** — 성과를 어느 단위로 보는가. 순수(import 없음).\n *\n * ── 왜 여기 있나 ───────────────────────────────────────────────────────────\n * 이 목록을 세 곳이 쓴다: 씬 표현이 \"나는 어느 단계에 붙는다\" 고 선언할 때(클라이언트), 성과 카드가\n * \"이 단계로 나눠 달라\" 고 물을 때(클라이언트), AI 가 \"구역별로 보여 줘\" 를 제안할 때(서버).\n * 세 곳이 각자 목록을 적으면 하나가 늘 때 나머지가 조용히 뒤처진다 — 집약 태그에서 이미 겪었다.\n *\n * 그래서 **한 곳**에 두고 셋이 가져다 쓴다. 이 파일은 import 가 없어 클라이언트 번들에 서버 코드를\n * 끌고 들어가지 않는다.\n */\n\n/**\n * 성과를 접을 수 있는 단계 — 좁은 것부터.\n *\n * `equipment` 는 커널 축 이름으로 `resource` 다(설비·인원·자산을 아우르는 이름). 화면과 AI 는\n * \"설비\" 로 말하고, 커널에 물을 때만 축 이름으로 바꾼다 — 그 변환이 아래 한 곳에 있다.\n */\nexport const TWIN_LEVELS = ['space', 'twin', 'area', 'location', 'equipment'] as const\nexport type TwinLevel = (typeof TWIN_LEVELS)[number]\n\nexport function isTwinLevel(v: unknown): v is TwinLevel {\n  return typeof v === 'string' && (TWIN_LEVELS as readonly string[]).includes(v)\n}\n\n/**\n * 단계 → 커널의 나누는 축(`KpiGroupBy`). **전체를 보는 단계는 축이 없다** — 나누지 않고 통째로 접는다.\n *\n * `space` 와 `twin` 이 축 없이 같은 이유: 둘의 차이는 \"무엇을 대상으로 삼는가\"(공간 전체 대 트윈 하나)이지\n * \"어떻게 나누는가\" 가 아니다. 대상은 질의의 `spaceId`/`instanceId` 가 정한다.\n */\nexport function kpiGroupByOfLevel(level: TwinLevel): 'area' | 'location' | 'resource' | undefined {\n  if (level === 'area') return 'area'\n  if (level === 'location') return 'location'\n  if (level === 'equipment') return 'resource'\n\n  return undefined\n}\n\n/**\n * 그 단계의 카드가 **대상 하나마다 한 장**인가.\n *\n * 구역·자리·설비는 여럿이라 카드가 그 수만큼 생긴다. 공간·트윈은 하나뿐이다. 보드를 자동으로 조립할 때\n * 몇 장이 생길지 미리 알아야 한다 — 자리 200개 × 지표 4개면 800장이다.\n */\nexport function isPerTargetLevel(level: TwinLevel): boolean {\n  return kpiGroupByOfLevel(level) !== undefined\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/headless-twin",
-  "version": "10.0.8",
+  "version": "10.0.10",
   "main": "dist-server/index.js",
   "things-factory": true,
   "author": "heartyoh <heartyoh@hatiolab.com>",
@@ -16,20 +16,22 @@
     "directory": "packages/headless-twin"
   },
   "scripts": {
-    "build": "npm run clean:server && tsc",
-    "build:server": "npm run clean:server && tsc",
-    "clean:server": "rm -rf dist-server",
-    "clean": "npm run clean:server",
+    "build": "npm run build:shared && npm run clean:server && tsc",
+    "build:server": "npm run build:shared && npm run clean:server && tsc",
+    "clean:server": "rm -rf dist-server tsconfig.tsbuildinfo",
+    "clean": "npm run clean:server && npm run clean:shared",
     "migration:create": "node ../../node_modules/typeorm/cli.js migration:create ./server/migrations/migration",
-    "typecheck": "tsc --noEmit",
-    "test": "node --test test/*.test.ts"
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.shared.json --noEmit",
+    "test": "node --test test/*.test.ts",
+    "build:shared": "tsc -p tsconfig.shared.json",
+    "clean:shared": "rm -rf dist-shared tsconfig.shared.tsbuildinfo"
   },
   "dependencies": {
-    "@operato/twin-kernel": "^0.4.0",
-    "@things-factory/auth-base": "^10.0.8",
-    "@things-factory/cache-service": "^10.0.8",
+    "@operato/twin-kernel": "^0.7.30",
+    "@things-factory/auth-base": "^10.0.10",
+    "@things-factory/cache-service": "^10.0.10",
     "@things-factory/env": "^10.0.8",
-    "@things-factory/shell": "^10.0.8"
+    "@things-factory/shell": "^10.0.10"
   },
-  "gitHead": "4a5a29c9c4a8a3e04fd67a5e5a11a42f0131ad4b"
+  "gitHead": "afb7bf76bb16e946c8e62d9e79199c3fa5e34174"
 }