npm - @things-factory/headless-twin - Versions diffs - 10.0.14 → 10.0.17 - Mend

@things-factory/headless-twin 10.0.14 → 10.0.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (478) hide show

package/dist-server/service/twin-ingest-window/twin-ingest-window-query.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"twin-ingest-window-query.js","sourceRoot":"","sources":["../../../server/service/twin-ingest-window/twin-ingest-window-query.ts"],"names":[],"mappings":"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","sourcesContent":["import { Arg, Ctx, Int, Query, Resolver } from 'type-graphql'\nimport { Between } from 'typeorm'\n\nimport { ScalarObject, getRepository } from '@things-factory/shell'\n\nimport { TwinEngine } from '../../engine/index.js'\nimport { TwinIngestWindow } from './twin-ingest-window.js'\n\n/\n 인제스트 창 이력 — 재기동 뒤에도 추이를 이어 본다.\n \n ── 왜 따로 있나 (2026-08-20) ───────────────────────────────────────────────\n * 창을 표로 남기기 시작했는데 읽는 코드가 없었다. 21행이 쌓여 있고 아무도 보지 않았다 — 이\n * 프로젝트가 결함으로 보는 상태다(「필드만 만들고 아무도 읽지 않는다」). 표를 만든 이유가 「메모리\n * 장부는 재기동에 사라지고 6시간까지인데 추이는 그보다 오래 봐야 한다」였으니, 목적이 미완이었다.\n \n ── 왜 `twinIngestHealth` 에 합치지 않나 ────────────────────────────────────\n * 그 조회는 화면이 자주 묻는다(상세를 열 때마다, 목록은 응답에 요약이 함께 온다). 거기에 DB 주사를\n * 얹으면 이 세션에서 없앤 것과 같은 종류의 비용이 돌아온다 — 자주 묻는 조회가 자라는 표를 읽는 것.\n * 이력은 다른 질문이고 덜 자주 묻는다: 「더 뒤까지 보여 달라」.\n \n ── 이어 붙이기는 서버가 한다 ───────────────────────────────────────────────\n * 표와 메모리는 겹친다(프로세스가 살아 있는 동안 닫힌 창은 둘 다에 있다). 겹침을 화면이 정리하게 두면\n * 화면마다 규칙이 갈리고, 같은 구간이 두 번 그려지거나 사라진다. 그래서 여기서 한 벌로 이어 붙이고\n * 어디서부터 메모리인지(`liveFrom`)를 함께 낸다 — 화면이 근거를 말할 수 있게.\n /\n\n/\n 한 번에 돌려주는 창 수 상한 — 144창 × 10분 = 24시간.\n \n 상한이 필요한 이유는 이 표가 자란다는 것이다(트윈 1,000개에 하루 14.4만 행). 상한에서 밀려난\n * 수는 세어서 낸다 — ~~조용히~~ 자르면 화면이 「그 앞에는 아무 일도 없었다」로 읽는다.\n /\nexport const HISTORY_WINDOW_LIMIT = 144\n\n/* 물을 수 있는 기간의 상한(시간). 넘겨도 여기서 자르고, 자른 사실을 낸다. /\nexport const HISTORY_HOURS_MAX = 168\n\n@Resolver()\nexport class TwinIngestWindowQuery {\n @Query(returns => ScalarObject, {\n nullable: true,\n description:\n 'Ingest windows for one twin over a past span, stitched from two sources so the trend survives a restart: closed windows persisted in the table (older) and the in-memory ledger (recent, roughly the last 6 hours). Overlap is resolved here rather than on screen — a window present in both is reported once, from memory, and `liveFrom` says where memory takes over so a screen can state its basis. Each window carries offered / accepted / rejected / undelivered plus the journal rows written and the write round-trips behind them; `acceptedRatio` is null when nothing was offered, because an empty window is not a perfect one. Deliberately separate from twinIngestHealth: that query is polled whenever a screen opens, and making it scan a growing table would reintroduce the cost this codebase just removed elsewhere. Counts that could not be returned are reported rather than dropped — `storedDropped` when the row cap was hit and `hoursClamped` when the requested span was longer than allowed. Null if the instance is not in the current domain.'\n })\n async twinIngestHistory(\n @Arg('instanceId') instanceId: string,\n @Arg('hours', type => Int, { nullable: true, description: 'How far back to read, in hours. Defaults to 24 and is clamped to 168.' })\n hours: number \| undefined,\n @Ctx() context: ResolverContext\n ): Promise<any> {\n const domainId = context.state.domain.id\n / 테넌트 격리 — 멈춘 트윈의 이력도 볼 수 있어야 한다(그때가 가장 보고 싶은 때다). /\n if (!TwinEngine.owns(domainId, instanceId) && !(await TwinEngine.ownsRegistered(domainId, instanceId))) return null\n\n const asked = Number.isFinite(Number(hours)) && Number(hours) > 0 ? Math.floor(Number(hours)) : 24\n const span = Math.min(asked, HISTORY_HOURS_MAX)\n const now = Date.now()\n const fromMs = now - span 3_600_000\n\n /\n 표에서 그 구간의 닫힌 창을 읽는다. 상한을 둔다 — 자라는 표이고, 이 조회가 화면에서 열린다.\n * 최신 쪽이 중요하므로 내려서 정렬해 가져오고, 낼 때 다시 올린다.\n /\n const repo = getRepository(TwinIngestWindow)\n const where = {\n domain: { id: domainId } as any,\n instanceId,\n closedAt: Between(new Date(fromMs), new Date(now))\n }\n const rows = await repo.find({ where, order: { closedAt: 'DESC' }, take: HISTORY_WINDOW_LIMIT })\n\n /\n * 상한에 닿았으면 몇 개가 밀렸는지 센다. 「더 있음」만 말하면 화면이 그 앞을 짐작하게 된다.\n * 상한에 닿지 않았으면 셀 필요가 없다(왕복을 아낀다).\n /\n const storedDropped = rows.length === HISTORY_WINDOW_LIMIT ? Math.max(0, (await repo.count({ where })) - rows.length) : 0\n\n const stored = rows.reverse().map(r => ({\n from: r.openedAt?.toISOString?.() ?? new Date(r.openedAt as any).toISOString(),\n to: r.closedAt?.toISOString?.() ?? new Date(r.closedAt as any).toISOString(),\n offered: r.offered,\n / 통과는 트윈에 닿은 것만. 표의 값을 그대로 쓴다 — 읽는 쪽에서 다시 나누면 반올림이 갈린다. /\n accepted: r.offered - r.rejected - (r.undelivered ?? 0),\n rejected: r.rejected,\n undelivered: r.undelivered ?? 0,\n acceptedRatio: typeof r.acceptedRatio === 'number' ? r.acceptedRatio : null,\n rows: r.journaledRows ?? 0,\n flushes: r.journalFlushes ?? 0,\n source: 'stored' as const\n }))\n\n / 메모리 장부의 닫힌 창 — 이쪽이 최신이고, 겹치는 구간은 이쪽을 쓴다(같은 사실의 원본이다). /\n const live = (TwinEngine.ingestHealthOf(domainId, instanceId).trend ?? []).map((w: any) => ({\n ...w,\n source: 'live' as const\n }))\n\n /\n * 겹침 정리 — 창의 여는 시각이 키다. 같은 창이 표와 메모리에 둘 다 있으면 하나만 낸다.\n * 시각 문자열을 그대로 키로 쓰지 않는다: 드라이버가 밀리초를 자르거나 형식을 바꿀 수 있어\n * 같은 창이 다른 키가 된다. epoch 로 견준다.\n /\n const liveStarts = new Set(live.map((w: any) => Date.parse(w.from)))\n const windows = [...stored.filter(w => !liveStarts.has(Date.parse(w.from))), ...live]\n\n return {\n windows,\n hours: span,\n / 물은 것보다 짧게 잘렸으면 밝힌다. /\n ...(span < asked ? { hoursClamped: asked } : {}),\n from: new Date(fromMs).toISOString(),\n to: new Date(now).toISOString(),\n /* 표에서 읽은 창 수 · 상한에서 밀려난 수. /\n storedCount: stored.length,\n storedDropped,\n /\n 어디서부터 메모리인가 — 화면이 근거를 말할 수 있게. 메모리에 닫힌 창이 없으면 `null` 이다\n * (재기동 직후가 그렇다: 그때 보이는 것은 전부 표에서 온 것이다).\n */\n liveFrom: live.length ? live[0].from : null,\n liveCount: live.length\n }\n }\n}\n"]}
1	+ {"version":3,"file":"twin-ingest-window-query.js","sourceRoot":"","sources":["../../../server/service/twin-ingest-window/twin-ingest-window-query.ts"],"names":[],"mappings":"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","sourcesContent":["import { Arg, Ctx, Int, Query, Resolver } from 'type-graphql'\nimport { Between } from 'typeorm'\n\nimport { ScalarObject, getRepository } from '@things-factory/shell'\n\nimport { TwinEngine } from '../../engine/index.js'\nimport { TwinIngestWindow } from './twin-ingest-window.js'\n\n/\n 인제스트 창 이력 — 재기동 뒤에도 추이를 이어 본다.\n \n ── 왜 따로 있나 (2026-08-20) ───────────────────────────────────────────────\n * 창을 표로 남기기 시작했는데 읽는 코드가 없었다. 21행이 쌓여 있고 아무도 보지 않았다 — 이\n * 프로젝트가 결함으로 보는 상태다(「필드만 만들고 아무도 읽지 않는다」). 표를 만든 이유가 「메모리\n * 장부는 재기동에 사라지고 6시간까지인데 추이는 그보다 오래 봐야 한다」였으니, 목적이 미완이었다.\n \n ── 왜 `twinIngestHealth` 에 합치지 않나 ────────────────────────────────────\n * 그 조회는 화면이 자주 묻는다(상세를 열 때마다, 목록은 응답에 요약이 함께 온다). 거기에 DB 주사를\n * 얹으면 이 세션에서 없앤 것과 같은 종류의 비용이 돌아온다 — 자주 묻는 조회가 자라는 표를 읽는 것.\n * 이력은 다른 질문이고 덜 자주 묻는다: 「더 뒤까지 보여 달라」.\n \n ── 이어 붙이기는 서버가 한다 ───────────────────────────────────────────────\n * 표와 메모리는 겹친다(프로세스가 살아 있는 동안 닫힌 창은 둘 다에 있다). 겹침을 화면이 정리하게 두면\n * 화면마다 규칙이 갈리고, 같은 구간이 두 번 그려지거나 사라진다. 그래서 여기서 한 벌로 이어 붙이고\n * 어디서부터 메모리인지(`liveFrom`)를 함께 낸다 — 화면이 근거를 말할 수 있게.\n /\n\n/\n 한 번에 돌려주는 창 수 상한 — 144창 × 10분 = 24시간.\n \n 상한이 필요한 이유는 이 표가 자란다는 것이다(트윈 1,000개에 하루 14.4만 행). 상한에서 밀려난\n * 수는 세어서 낸다 — 알리지 않고 자르면 화면이 「그 앞에는 아무 일도 없었다」로 읽는다.\n /\nexport const HISTORY_WINDOW_LIMIT = 144\n\n/* 물을 수 있는 기간의 상한(시간). 넘겨도 여기서 자르고, 자른 사실을 낸다. /\nexport const HISTORY_HOURS_MAX = 168\n\n@Resolver()\nexport class TwinIngestWindowQuery {\n @Query(returns => ScalarObject, {\n nullable: true,\n description:\n 'Ingest windows for one twin over a past span, stitched from two sources so the trend survives a restart: closed windows persisted in the table (older) and the in-memory ledger (recent, roughly the last 6 hours). Overlap is resolved here rather than on screen — a window present in both is reported once, from memory, and `liveFrom` says where memory takes over so a screen can state its basis. Each window carries offered / accepted / rejected / undelivered plus the journal rows written and the write round-trips behind them; `acceptedRatio` is null when nothing was offered, because an empty window is not a perfect one. Deliberately separate from twinIngestHealth: that query is polled whenever a screen opens, and making it scan a growing table would reintroduce the cost this codebase just removed elsewhere. Counts that could not be returned are reported rather than dropped — `storedDropped` when the row cap was hit and `hoursClamped` when the requested span was longer than allowed. Null if the instance is not in the current domain.'\n })\n async twinIngestHistory(\n @Arg('instanceId') instanceId: string,\n @Arg('hours', type => Int, { nullable: true, description: 'How far back to read, in hours. Defaults to 24 and is clamped to 168.' })\n hours: number \| undefined,\n @Ctx() context: ResolverContext\n ): Promise<any> {\n const domainId = context.state.domain.id\n / 테넌트 격리 — 멈춘 트윈의 이력도 볼 수 있어야 한다(그때가 가장 보고 싶은 때다). /\n if (!TwinEngine.owns(domainId, instanceId) && !(await TwinEngine.ownsRegistered(domainId, instanceId))) return null\n\n const asked = Number.isFinite(Number(hours)) && Number(hours) > 0 ? Math.floor(Number(hours)) : 24\n const span = Math.min(asked, HISTORY_HOURS_MAX)\n const now = Date.now()\n const fromMs = now - span 3_600_000\n\n /\n 표에서 그 구간의 닫힌 창을 읽는다. 상한을 둔다 — 자라는 표이고, 이 조회가 화면에서 열린다.\n * 최신 쪽이 중요하므로 내려서 정렬해 가져오고, 낼 때 다시 올린다.\n /\n const repo = getRepository(TwinIngestWindow)\n const where = {\n domain: { id: domainId } as any,\n instanceId,\n closedAt: Between(new Date(fromMs), new Date(now))\n }\n const rows = await repo.find({ where, order: { closedAt: 'DESC' }, take: HISTORY_WINDOW_LIMIT })\n\n /\n * 상한에 닿았으면 몇 개가 밀렸는지 센다. 「더 있음」만 말하면 화면이 그 앞을 짐작하게 된다.\n * 상한에 닿지 않았으면 셀 필요가 없다(왕복을 아낀다).\n /\n const storedDropped = rows.length === HISTORY_WINDOW_LIMIT ? Math.max(0, (await repo.count({ where })) - rows.length) : 0\n\n const stored = rows.reverse().map(r => ({\n from: r.openedAt?.toISOString?.() ?? new Date(r.openedAt as any).toISOString(),\n to: r.closedAt?.toISOString?.() ?? new Date(r.closedAt as any).toISOString(),\n offered: r.offered,\n / 통과는 트윈에 닿은 것만. 표의 값을 그대로 쓴다 — 읽는 쪽에서 다시 나누면 반올림이 갈린다. /\n accepted: r.offered - r.rejected - (r.undelivered ?? 0),\n rejected: r.rejected,\n undelivered: r.undelivered ?? 0,\n acceptedRatio: typeof r.acceptedRatio === 'number' ? r.acceptedRatio : null,\n rows: r.journaledRows ?? 0,\n flushes: r.journalFlushes ?? 0,\n source: 'stored' as const\n }))\n\n / 메모리 장부의 닫힌 창 — 이쪽이 최신이고, 겹치는 구간은 이쪽을 쓴다(같은 사실의 원본이다). /\n const live = (TwinEngine.ingestHealthOf(domainId, instanceId).trend ?? []).map((w: any) => ({\n ...w,\n source: 'live' as const\n }))\n\n /\n * 겹침 정리 — 창의 여는 시각이 키다. 같은 창이 표와 메모리에 둘 다 있으면 하나만 낸다.\n * 시각 문자열을 그대로 키로 쓰지 않는다: 드라이버가 밀리초를 자르거나 형식을 바꿀 수 있어\n * 같은 창이 다른 키가 된다. epoch 로 견준다.\n /\n const liveStarts = new Set(live.map((w: any) => Date.parse(w.from)))\n const windows = [...stored.filter(w => !liveStarts.has(Date.parse(w.from))), ...live]\n\n return {\n windows,\n hours: span,\n / 물은 것보다 짧게 잘렸으면 밝힌다. /\n ...(span < asked ? { hoursClamped: asked } : {}),\n from: new Date(fromMs).toISOString(),\n to: new Date(now).toISOString(),\n /* 표에서 읽은 창 수 · 상한에서 밀려난 수. /\n storedCount: stored.length,\n storedDropped,\n /\n 어디서부터 메모리인가 — 화면이 근거를 말할 수 있게. 메모리에 닫힌 창이 없으면 `null` 이다\n * (재기동 직후가 그렇다: 그때 보이는 것은 전부 표에서 온 것이다).\n */\n liveFrom: live.length ? live[0].from : null,\n liveCount: live.length\n }\n }\n}\n"]}

package/dist-server/service/twin-ingest-window/twin-ingest-window-writer.js CHANGED Viewed

@@ -12,7 +12,7 @@ const twin_ingest_window_js_1 = require("./twin-ingest-window.js");
  * 두었고(`onIngestWindowClosed`), 이 파일이 부팅에서 한 번 등록한다. 그래서 기록 경로가 갈리지 않는다.
  *
  * ── 실패를 삼키지 않는다 ────────────────────────────────────────────────────
- * 쓰기가 터져도 메모리 장부는 계속 굴러간다(`rollIngestWindow` 가 훅을 감싼다). 다만 **조용히 넘기지는
+ * 쓰기가 터져도 메모리 장부는 계속 굴러간다(`rollIngestWindow` 가 훅을 감싼다). 다만 **알리지 않고 넘기지는
  * 않는다** — 실패를 로그로 남긴다. 그러지 않으면 추이 표에 구멍이 생긴 이유를 나중에 알 수 없다.
  *
  * ── 왜 await 하지 않나 ──────────────────────────────────────────────────────

package/dist-server/service/twin-ingest-window/twin-ingest-window-writer.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"twin-ingest-window-writer.js","sourceRoot":"","sources":["../../../server/service/twin-ingest-window/twin-ingest-window-writer.ts"],"names":[],"mappings":";;AAoBA,8DAiCC;AArDD,gDAA8C;AAC9C,iDAAqD;AAErD,oDAAkD;AAClD,mEAA0D;AAE1D;;;;;;;;;;;;;GAaG;AACH,SAAgB,yBAAyB;IACvC,qBAAU,CAAC,oBAAoB,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE;QAC7C,MAAM,IAAI,GAAG,IAAA,qBAAa,EAAC,wCAAgB,CAAC,CAAA;QAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAA;QAC9B,IAAI;aACD,IAAI,CACH,IAAI,CAAC,MAAM,CAAC;YACV,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,QAAQ,EAAS;YAClC,UAAU,EAAE,EAAE,CAAC,UAAU;YACzB,QAAQ,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YAClC,QAAQ,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAChC,OAAO;YACP,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,kDAAkD;YAClD,aAAa,EAAE,MAAM,CAAC,IAAI;YAC1B,cAAc,EAAE,MAAM,CAAC,OAAO;YAC9B;;;eAGG;YACH,GAAG,CAAC,OAAO,GAAG,CAAC;gBACb,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,EAAE;gBACvF,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CACH;aACA,KAAK,CAAC,GAAG,CAAC,EAAE,CACX,IAAA,iBAAQ,EACN,yBAAyB,EAAE,CAAC,UAAU,sDAAsD,EAC5F,GAAG,EAAE,OAAO,IAAI,GAAG,CACpB,CACF,CAAA;IACL,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,mEAAmE;AACnE,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAA","sourcesContent":["import { twinWarn } from '../../engine/log.js'\nimport { getRepository } from '@things-factory/shell'\n\nimport { TwinEngine } from '../../engine/index.js'\nimport { TwinIngestWindow } from './twin-ingest-window.js'\n\n/\n 닫힌 창을 표로 옮긴다 — 영속이 붙는 유일한 자리.\n \n 커널 층(`engine/ingest-health.ts`)은 저장 계층을 모른다. 창이 닫힐 때 부를 곳을 엔진이 문으로 열어\n * 두었고(`onIngestWindowClosed`), 이 파일이 부팅에서 한 번 등록한다. 그래서 기록 경로가 갈리지 않는다.\n \n ── 실패를 삼키지 않는다 ────────────────────────────────────────────────────\n * 쓰기가 터져도 메모리 장부는 계속 굴러간다(`rollIngestWindow` 가 훅을 감싼다). 다만 *조용히 넘기지는\n 않는다** — 실패를 로그로 남긴다. 그러지 않으면 추이 표에 구멍이 생긴 이유를 나중에 알 수 없다.\n \n ── 왜 await 하지 않나 ──────────────────────────────────────────────────────\n * 이 훅은 인제스트 경로에서 불린다(라이브 피드의 콜백 안). 여기서 DB 를 기다리면 *유입이 DB 속도에\n 묶인다** — 이 기능이 막으려던 부하가 그 모양으로 돌아온다. 그래서 띄워 보내고 결과만 로그로 받는다.\n /\nexport function installIngestWindowWriter(): void {\n TwinEngine.onIngestWindowClosed((at, closed) => {\n const repo = getRepository(TwinIngestWindow)\n const offered = closed.offered\n repo\n .save(\n repo.create({\n domain: { id: at.domainId } as any,\n instanceId: at.instanceId,\n openedAt: new Date(closed.startMs),\n closedAt: new Date(closed.endMs),\n offered,\n rejected: closed.rejected,\n undelivered: closed.undelivered,\n / 적힌 것도 같은 행에 — 창이 유입 없이 닫혔어도(시뮬) 이 두 수는 사실이다. /\n journaledRows: closed.rows,\n journalFlushes: closed.flushes,\n /\n * 제시가 0 이면 비워 둔다 — 1 로 채우면 「전부 통과」로 읽힌다.\n * 통과는 트윈에 닿은 것만이다: 버려진 것을 빼지 않으면 멈춘 트윈의 창이 100% 로 남는다.\n /\n ...(offered > 0\n ? { acceptedRatio: round4((offered - closed.rejected - closed.undelivered) / offered) }\n : {})\n })\n )\n .catch(err =>\n twinWarn(\n `[twin-ingest-window] \"${at.instanceId}\" window not persisted (trend will have a gap here):`,\n err?.message ?? err\n )\n )\n })\n}\n\n/* 0.999 가 1 로 반올림되면 「전부 통과」로 읽힌다 — 자릿수를 넉넉히 준다(메모리 장부와 같은 규칙). /\nconst round4 = (v: number) => Math.round(v 10000) / 10000\n"]}
1	+ {"version":3,"file":"twin-ingest-window-writer.js","sourceRoot":"","sources":["../../../server/service/twin-ingest-window/twin-ingest-window-writer.ts"],"names":[],"mappings":";;AAoBA,8DAiCC;AArDD,gDAA8C;AAC9C,iDAAqD;AAErD,oDAAkD;AAClD,mEAA0D;AAE1D;;;;;;;;;;;;;GAaG;AACH,SAAgB,yBAAyB;IACvC,qBAAU,CAAC,oBAAoB,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE;QAC7C,MAAM,IAAI,GAAG,IAAA,qBAAa,EAAC,wCAAgB,CAAC,CAAA;QAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAA;QAC9B,IAAI;aACD,IAAI,CACH,IAAI,CAAC,MAAM,CAAC;YACV,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,QAAQ,EAAS;YAClC,UAAU,EAAE,EAAE,CAAC,UAAU;YACzB,QAAQ,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YAClC,QAAQ,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAChC,OAAO;YACP,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,kDAAkD;YAClD,aAAa,EAAE,MAAM,CAAC,IAAI;YAC1B,cAAc,EAAE,MAAM,CAAC,OAAO;YAC9B;;;eAGG;YACH,GAAG,CAAC,OAAO,GAAG,CAAC;gBACb,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,EAAE;gBACvF,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CACH;aACA,KAAK,CAAC,GAAG,CAAC,EAAE,CACX,IAAA,iBAAQ,EACN,yBAAyB,EAAE,CAAC,UAAU,sDAAsD,EAC5F,GAAG,EAAE,OAAO,IAAI,GAAG,CACpB,CACF,CAAA;IACL,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,mEAAmE;AACnE,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAA","sourcesContent":["import { twinWarn } from '../../engine/log.js'\nimport { getRepository } from '@things-factory/shell'\n\nimport { TwinEngine } from '../../engine/index.js'\nimport { TwinIngestWindow } from './twin-ingest-window.js'\n\n/\n 닫힌 창을 표로 옮긴다 — 영속이 붙는 유일한 자리.\n \n 커널 층(`engine/ingest-health.ts`)은 저장 계층을 모른다. 창이 닫힐 때 부를 곳을 엔진이 문으로 열어\n * 두었고(`onIngestWindowClosed`), 이 파일이 부팅에서 한 번 등록한다. 그래서 기록 경로가 갈리지 않는다.\n \n ── 실패를 삼키지 않는다 ────────────────────────────────────────────────────\n * 쓰기가 터져도 메모리 장부는 계속 굴러간다(`rollIngestWindow` 가 훅을 감싼다). 다만 *알리지 않고 넘기지는\n 않는다** — 실패를 로그로 남긴다. 그러지 않으면 추이 표에 구멍이 생긴 이유를 나중에 알 수 없다.\n \n ── 왜 await 하지 않나 ──────────────────────────────────────────────────────\n * 이 훅은 인제스트 경로에서 불린다(라이브 피드의 콜백 안). 여기서 DB 를 기다리면 *유입이 DB 속도에\n 묶인다** — 이 기능이 막으려던 부하가 그 모양으로 돌아온다. 그래서 띄워 보내고 결과만 로그로 받는다.\n /\nexport function installIngestWindowWriter(): void {\n TwinEngine.onIngestWindowClosed((at, closed) => {\n const repo = getRepository(TwinIngestWindow)\n const offered = closed.offered\n repo\n .save(\n repo.create({\n domain: { id: at.domainId } as any,\n instanceId: at.instanceId,\n openedAt: new Date(closed.startMs),\n closedAt: new Date(closed.endMs),\n offered,\n rejected: closed.rejected,\n undelivered: closed.undelivered,\n / 적힌 것도 같은 행에 — 창이 유입 없이 닫혔어도(시뮬) 이 두 수는 사실이다. /\n journaledRows: closed.rows,\n journalFlushes: closed.flushes,\n /\n * 제시가 0 이면 비워 둔다 — 1 로 채우면 「전부 통과」로 읽힌다.\n * 통과는 트윈에 닿은 것만이다: 버려진 것을 빼지 않으면 멈춘 트윈의 창이 100% 로 남는다.\n /\n ...(offered > 0\n ? { acceptedRatio: round4((offered - closed.rejected - closed.undelivered) / offered) }\n : {})\n })\n )\n .catch(err =>\n twinWarn(\n `[twin-ingest-window] \"${at.instanceId}\" window not persisted (trend will have a gap here):`,\n err?.message ?? err\n )\n )\n })\n}\n\n/* 0.999 가 1 로 반올림되면 「전부 통과」로 읽힌다 — 자릿수를 넉넉히 준다(메모리 장부와 같은 규칙). /\nconst round4 = (v: number) => Math.round(v 10000) / 10000\n"]}

package/dist-server/service/twin-instance/twin-instance.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"twin-instance.js","sourceRoot":"","sources":["../../../server/service/twin-instance/twin-instance.ts"],"names":[],"mappings":";;;;AAAA,qCAAkI;AAClI,+CAAoD;AAEpD,iDAA4D;AAC5D,yDAAgD;AAChD,0EAAyE;AAEzE;;;;;;GAMG;AAKI,IAAM,YAAY,GAAlB,MAAM,YAAY;CAoLxB,CAAA;AApLY,oCAAY;AAGd;IAFR,IAAA,gCAAsB,EAAC,MAAM,CAAC;IAC9B,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,iBAAE,EAAE,EAAE,WAAW,EAAE,2CAA2C,EAAE,CAAC;;wCAC7D;AAInB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,cAAM,CAAC;IACzB,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,cAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uBAAuB,EAAE,CAAC;sCACvE,cAAM;4CAAA;AAGf;IADC,IAAA,oBAAU,EAAC,CAAC,CAAe,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;;8CACzB;AAIjB;IAFC,IAAA,gBAAM,GAAE;IACR,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,oDAAoD,EAAE,CAAC;;gDAC3D;AAkBlB;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,iIAAiI,EAAE,CAAC;;0CAC7J;AAIb;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,kDAAkD,EAAE,CAAC;;iDACvE;AAMpB;IAFC,IAAA,gBAAM,GAAE;IACR,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,sCAAsC,EAAE,CAAC;;0CACnD;AAqBZ;IAFC,IAAA,gBAAM,GAAE;IACR,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,wMAAwM,EAAE,CAAC;;mDAC5M;AAOrB;IAFC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,4CAAsB,EAAE,CAAC;IACpF,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,oBAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,sMAAsM,EAAE,CAAC,CAAC,yEAAyE;;;2CACpU;AAoBX;IAFC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC/C,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,oBAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,wOAAwO,EAAE,CAAC;;uDAChR;AAIvB;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,sIAAsI,EAAE,CAAC;;6CAC/J;AAIhB;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,+EAA+E,EAAE,CAAC;;4CACzG;AAIf;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,sCAAsC,EAAE,CAAC;;4CAChE;AAYf;IAFC,IAAA,gBAAM,GAAE;IACR,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,mGAAmG,EAAE,CAAC;;6CAC7G;AAIf;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uEAAuE,EAAE,CAAC;;4CACjG;AAmBf;IANC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC/C,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,oBAAY,EAAE;QAC3B,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,+KAA+K;KAClL,CAAC;;4CACU;AAgBZ;IAFC,IAAA,0BAAgB,GAAE;IAClB,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,mDAAmD,EAAE,CAAC;sCAChF,IAAI;+CAAA;AAIhB;IAFC,IAAA,0BAAgB,GAAE;IAClB,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,4DAA4D,EAAE,CAAC;sCACzF,IAAI;IAEhB;;;;;;;OAOG;;+CATa;AAYhB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,2GAA2G,EAAE,CAAC;sCACxJ,gBAAI;6CAAA;AAGd;IADC,IAAA,oBAAU,EAAC,CAAC,CAAe,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;;+CACzB;AAIlB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,mDAAmD,EAAE,CAAC;sCAChG,gBAAI;6CAAA;AAGd;IADC,IAAA,oBAAU,EAAC,CAAC,CAAe,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;;+CACzB;uBAnLP,YAAY;IAJxB,IAAA,gBAAM,GAAE;IACR,IAAA,eAAK,EAAC,oBAAoB,EAAE,CAAC,CAAe,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC5F,IAAA,eAAK,EAAC,oBAAoB,EAAE,CAAC,CAAe,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B;;IACnG,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,sFAAsF,EAAE,CAAC;GACvG,YAAY,CAoLxB","sourcesContent":["import { CreateDateColumn, Entity, Index, Column, RelationId, ManyToOne, PrimaryGeneratedColumn, UpdateDateColumn } from 'typeorm'\nimport { ObjectType, Field, ID } from 'type-graphql'\n\nimport { Domain, ScalarObject } from '@things-factory/shell'\nimport { User } from '@things-factory/auth-base'\nimport { modelColumnTransformer } from '../../engine/model-vocabulary.js'\n\n/\n TwinInstance — 트윈 인스턴스 레지스트리(재부팅 복구의 앵커).\n * 복구(DB→replay)는 model(마스터 청사진)가 있어야 이벤트를 상태로 다시 계산할 수 있다 → model·kind 를 영속.\n * 이벤트(TwinEvent)와 달리 가변(status 갱신) — 인스턴스의 \"현재 등록 상태\".\n * model 는 simple-json(멀티DB 이식 — postgres/mysql/sqlite/mssql/oracle 공통).\n * (CLAUDE.md: 모든 @ObjectType/@Field 는 영문 description 필수.)\n /\n@Entity()\n@Index('ix_twin_instance_0', (e: TwinInstance) => [e.domain, e.instanceId], { unique: true })\n@Index('ix_twin_instance_1', (e: TwinInstance) => [e.domain, e.spaceId]) // 공간→인스턴스 1급 질의(공간 중심 존재론)\n@ObjectType({ description: 'Registry of a hosted twin runtime instance — anchors reboot recovery (model + kind).' })\nexport class TwinInstance {\n @PrimaryGeneratedColumn('uuid')\n @Field(type => ID, { description: 'Unique identifier of the registry record.' })\n readonly id: string\n\n @ManyToOne(type => Domain)\n @Field(type => Domain, { nullable: true, description: 'Owning tenant domain.' })\n domain?: Domain\n\n @RelationId((e: TwinInstance) => e.domain)\n domainId?: string\n\n @Column()\n @Field({ description: 'Twin runtime instance id (unique within a domain).' })\n instanceId: string\n\n /\n 사람이 부르는 이름 — 업무키(`instanceId`)와 나란히 두는 표시명(프레임워크 엔티티 규약).\n \n ── 왜 업무키와 이름을 나눠 두나 ─────────────────────────────────────────────\n * `instanceId` 는 URL·저널·구독이 전부 쓰는 계약이라 바꿀 수 없다. 반대로 이름은 바뀌고,\n * 중복되고(사이트 둘에 \"도장\" 이 있는 것이 정상), 언어마다 다르다. 둘을 한 컬럼에 담으면 개명이\n * 곧 다른 트윈이 되고 재동기가 끊긴다 — 그래서 나눈다(이 저장소에서 식별자가 밖에서 오는 것은\n * 전부 이 규약을 쓴다: `spaceId`·`locationId`·`equipmentId`·`operationKey`).\n \n 나눴으면 이름을 반드시 함께 둬야 한다. 이 자리가 없던 동안 사이트 이름은 model 안에만 있어서\n * 목록이 `crew-two` 만 보였다 — 나누기만 하고 절반을 빼먹으면 화면에는 id 만 남는다.\n \n 원본이 이름을 말하지 않으면 비운다(id 를 베끼지 않는다).\n /\n @Column({ nullable: true })\n @Field({ nullable: true, description: 'Human name of this twin (the site name from its master). Empty when the source does not name it — never copied from instanceId.' })\n name?: string\n\n @Column({ nullable: true })\n @Field({ nullable: true, description: 'Longer description when the source provides one.' })\n description?: string\n\n / 어느 도메인 커널이 이 트윈을 운영하는가. 커널 없는 트윈은 없으므로 비어 있을 수 없다\n (`TwinEngine.start`·`register` 모두 필수 인자로 받는다). /\n @Column()\n @Field({ description: 'Domain kernel kind: wms \| yms \| mes.' })\n kind: string\n\n /\n * 재기동 정책 — 이 트윈은 다시 세워질 때 자기 과거를 어떻게 대하나(ADR-0029 §2).\n \n 'resync' = 외부 실물에서 다시 읽는다(원본이 진실이므로 우리 과거를 이어 붙이지 않는다 → startLive).\n * 'resume' = 저널을 이어 세운다(이 트윈이 낳은 타임라인이 곧 사실이다).\n * 'reset' = 저널을 비우고 씨앗부터 다시 돌린다(재현 가능한 실험 — 백지 시작이 선언된 거동이다).\n \n ── 왜 트윈에 남았나 (옛 이름 `realityMode`) ────────────────────────────────\n * 「현실이 어디서 오나」는 ADR-0029 가 원본의 종류로 옮긴 물음이다(`TwinReference.adapterType`) —\n * 트윈은 한 종류이고 언제나 원본을 반영한다. 그런데 코드가 이 축으로 실제로 가른 것은 *재기동 거동\n 하나였고, 그것은 원본의 성질이 아니라 트윈과 자기 과거의 관계*다: 같은 시뮬레이터 원본을 보는 두\n 트윈이 하나는 이어가고 하나는 매번 처음부터 재현할 수 있다. 그래서 축은 남고 이름만 바뀌었다.\n \n 비어 있을 수 없고, 기본값도 없다. 예전에는 미선언이 조용히 `sim-experiment`(=저널 초기화)로\n * 떨어졌다 — 값이 하나 어긋나는 순간 이력을 지우는 길이다. 이제 읽는 쪽이 오류를 낸다\n * (`engine/restart-policy.ts`). 선언은 프로비저닝하는 쪽의 몫이다.\n /\n @Column()\n @Field({ description: \"Restart policy: 'resync' (read again from the external source) \| 'resume' (continue this twin's own journal) \| 'reset' (wipe and replay from the seed). No default — an unspecified policy is refused.\" })\n restartPolicy: string\n\n / 읽을 때 어휘 세대를 흡수한다(`nodes`/`movers`/`equipmentList` → `locations`/`equipment`). (vocabulary-guard: allow — 세대 이름 없이는 설명할 수 없다.)\n 자리마다 리더를 쓰게 하면 다음에 추가되는 자리가 또 빠지고, 빠진 것은 오류가 아니라 빈 공장이라\n 조용하다(2026-08-06: 모델러 엔티티 목록이 통째로 비었다). 상세 `engine/model-vocabulary.ts`. /\n @Column({ type: 'simple-json', nullable: true, transformer: modelColumnTransformer })\n @Field(type => ScalarObject, { nullable: true, description: 'TwinModelDef blueprint (locations/equipment) required to replay events into state. Older stored boards used nodes/movers/equipmentList; they are normalised on read so consumers see one vocabulary.' }) // vocabulary-guard: allow — 옛 어휘를 흡수하는 것이 이 코드의 일이다(세대 이름을 적어야 흡수할 수 있다)\n model?: any\n\n /\n * 로컬 선언 겹 — 구조는 원천이, 수는 우리가.\n \n 요금 단가·계약 정보·축전지 충전율처럼 원 시스템이 모르는 값을 넣는 자리다. `model` 에 직접 쓰지\n * 않는 이유는 그것이 원천의 사본이기 때문이다: 다시 읽기가 사본을 새로 그리면 직접 쓴 값은 조용히\n * 사라진다(요금이 사라지면 금액도 사라지고, 사용자는 이유를 알 수 없다).\n \n 그래서 여기 남기고, 모델을 그릴 때마다 그 위에 얹는다(`engine/local-declarations`). 얹힌 값에는\n * `source: 'local'` 이 붙는다 — 커널 계약의 `PropertySource` 축(`reference` ↔ `local`)이고, 「밖에서\n * 참조해 온 값이냐, 이 안에서 정한 값이냐」에 답한다.\n \n 이름에 장소 낱말을 쓰지 않는다(옛 이름 `siteDeclarations`): 이 코드에서 `site` 는 *외부\n 시스템이 부르는 사업장*이고(SAP `P3`·Oracle `W01` 이 같은 현장), 여기 담기는 것은 그 외부 시스템이\n 모르는 값이다 — 이름이 내용과 정반대였다. `space` 도 아니다: 그것은 「어디」에 답하고 이 축은\n * 「누가 말했나」에 답한다.\n /\n @Column({ type: 'simple-json', nullable: true })\n @Field(type => ScalarObject, { nullable: true, description: \"Locally-declared values layered on top of the reference-derived model (tariff, contract, state of charge) — values whose authority sits here, not in the source system. Kept apart from `model` so a resync cannot silently drop them.\" })\n localDeclarations?: any\n\n @Column({ nullable: true })\n @Field({ nullable: true, description: 'Owning space id (co-location anchor). Promoted from model.spaceId — first-class \"space → its twins\" query (space-centered ontology).' })\n spaceId?: string\n\n @Column({ nullable: true })\n @Field({ nullable: true, description: 'Owning area id within the space (optional scope). Promoted from model.areaId.' })\n areaId?: string\n\n @Column({ nullable: true })\n @Field({ nullable: true, description: 'Lifecycle status: running \| stopped.' })\n status?: string\n\n /\n * purpose — 이 인스턴스가 운영 트윈인지, 격리된 벤치 사본인지 1급 선언(이름 접두사가 아니라 속성으로 구별).\n * 'bench' 는 규모/부하 실험용 격리 사본 — 목록·정리·안전 가드가 이 속성을 키로 동작(운영 트윈 무오염 보장).\n \n 비어 있을 수 없다. 프로비저닝이 `register` 에서 'operational' 로 각인하고, 벤치 사본만\n * `setPurpose` 로 뒤집는다. 예전에는 비워 둔 채 읽는 쪽에서 메웠는데, 그러면 \"운영이라고 선언된 것\"\n * 과 \"아무도 말하지 않은 것\" 이 같은 값으로 보여서 벤치 격리가 추측에 기대게 된다.\n /\n @Column()\n @Field({ description: \"Instance purpose: 'operational' (real twin) \| 'bench' (isolated copy for scale/load experiments).\" })\n purpose: string\n\n @Column({ nullable: true })\n @Field({ nullable: true, description: 'For a bench copy: the source spaceId it was copied from (provenance).' })\n copyOf?: string\n\n /\n 이 트윈을 다시 읽는 방법 — 어떤 원본에서 나왔나(`MasterOrigin`).\n \n 트윈은 원본을 비출 뿐이므로(ADR-0028) 원본이 달라지면 다시 읽어야 한다. 그런데 이 자리가 없던\n * 동안 트윈은 자기가 무엇에서 나왔는지 몰랐다 — 어댑터로 들어온 트윈은 `TwinReference` 행이\n * 있었지만 템플릿으로 세운 트윈에는 아무 표식도 없었고, 그래서 첫날의 모습에 영원히 머무는\n * 트윈이 만들어졌다. 원천이 무엇이든 여기 한 자리에 남긴다.\n \n 비어 있을 수 있다 — 이 자리가 생기기 전에 만들어진 트윈이 그렇다. 그때는 \"다시 읽을 수\n * 없다\" 가 사실이므로 화면이 그대로 말한다(짐작해 채우지 않는다).\n /\n @Column({ type: 'simple-json', nullable: true })\n @Field(type => ScalarObject, {\n nullable: true,\n description:\n \"How this twin's master can be produced again — {kind:'reference', source} or {kind:'template', templateId, params}. Absent means this twin cannot be re-read from its source.\"\n })\n origin?: any\n\n /\n * `revision` 컬럼은 없앴다(2026-08-08).\n \n `ADR-0015` 가 \"정의만 있고 write 안 됨 — 프로비저닝에서 최신 저널 revision 을 반영하도록\n * 채운다\" 고 적어 두었는데, 채우지 않는 편이 맞다. 저널의 최신 번호는 저널이 아는 사실이고\n * (`TwinEngine.list` 가 `MAX(revision)` 으로 낸다), 여기 복제하면 같은 사실의 집이 둘이 된다.\n * 이 세션에만 그 부류를 셋 겪었다(`model.operations` 두 집 · `materials` 두 집 · tenantId 중복).\n \n 복제한 값은 반드시 어긋난다 — 저널은 틱마다 늘고 이 컬럼은 저장할 때만 갱신되므로, 화면이\n * 어느 쪽을 읽느냐로 다른 숫자가 나온다. 그 조용한 어긋남을 만들 이유가 없다.\n /\n\n @CreateDateColumn()\n @Field({ nullable: true, description: 'Timestamp when the instance was first registered.' })\n createdAt?: Date\n\n @UpdateDateColumn()\n @Field({ nullable: true, description: 'Timestamp when the instance registry row was last updated.' })\n updatedAt?: Date\n\n /\n * 누가 만들고 누가 고쳤나 — 이 행은 사람이 만든다(프로비저닝은 사용자 행위)이므로 규약의\n * 풀세트를 갖는다. 투영 행(자리·설비·공정)은 반대로 인제스트가 그린 것이라 저자가 사람이 아니고,\n * 그 저자는 `sourceRef`+`ingestedAt` 이 이미 말한다 — 그래서 그쪽에는 두지 않는다.\n \n 비어 있을 수 있다: 부팅 자동 프로비저닝처럼 사람이 없는 경로로 만들어진 행이 그렇다.\n * 그때 아무 사용자를 적어 넣으면 감사 기록이 거짓이 된다.\n */\n @ManyToOne(type => User, { nullable: true })\n @Field(type => User, { nullable: true, description: 'The user who first provisioned this twin. Empty when it was created by a system path (boot provisioning).' })\n creator?: User\n\n @RelationId((e: TwinInstance) => e.creator)\n creatorId?: string\n\n @ManyToOne(type => User, { nullable: true })\n @Field(type => User, { nullable: true, description: 'The user who last changed this twin registry row.' })\n updater?: User\n\n @RelationId((e: TwinInstance) => e.updater)\n updaterId?: string\n}\n"]}
1	+ {"version":3,"file":"twin-instance.js","sourceRoot":"","sources":["../../../server/service/twin-instance/twin-instance.ts"],"names":[],"mappings":"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","sourcesContent":["import { CreateDateColumn, Entity, Index, Column, RelationId, ManyToOne, PrimaryGeneratedColumn, UpdateDateColumn } from 'typeorm'\nimport { ObjectType, Field, ID } from 'type-graphql'\n\nimport { Domain, ScalarObject } from '@things-factory/shell'\nimport { User } from '@things-factory/auth-base'\nimport { modelColumnTransformer } from '../../engine/model-vocabulary.js'\n\n/\n TwinInstance — 트윈 인스턴스 레지스트리(재부팅 복구의 앵커).\n * 복구(DB→replay)는 model(마스터 청사진)가 있어야 이벤트를 상태로 다시 계산할 수 있다 → model·kind 를 영속.\n * 이벤트(TwinEvent)와 달리 가변(status 갱신) — 인스턴스의 \"현재 등록 상태\".\n * model 는 simple-json(멀티DB 이식 — postgres/mysql/sqlite/mssql/oracle 공통).\n * (CLAUDE.md: 모든 @ObjectType/@Field 는 영문 description 필수.)\n /\n@Entity()\n@Index('ix_twin_instance_0', (e: TwinInstance) => [e.domain, e.instanceId], { unique: true })\n@Index('ix_twin_instance_1', (e: TwinInstance) => [e.domain, e.spaceId]) // 공간→인스턴스 1급 질의(공간 중심 존재론)\n@ObjectType({ description: 'Registry of a hosted twin runtime instance — anchors reboot recovery (model + kind).' })\nexport class TwinInstance {\n @PrimaryGeneratedColumn('uuid')\n @Field(type => ID, { description: 'Unique identifier of the registry record.' })\n readonly id: string\n\n @ManyToOne(type => Domain)\n @Field(type => Domain, { nullable: true, description: 'Owning tenant domain.' })\n domain?: Domain\n\n @RelationId((e: TwinInstance) => e.domain)\n domainId?: string\n\n @Column()\n @Field({ description: 'Twin runtime instance id (unique within a domain).' })\n instanceId: string\n\n /\n 사람이 부르는 이름 — 업무키(`instanceId`)와 나란히 두는 표시명(프레임워크 엔티티 규약).\n \n ── 왜 업무키와 이름을 나눠 두나 ─────────────────────────────────────────────\n * `instanceId` 는 URL·저널·구독이 전부 쓰는 계약이라 바꿀 수 없다. 반대로 이름은 바뀌고,\n * 중복되고(사이트 둘에 \"도장\" 이 있는 것이 정상), 언어마다 다르다. 둘을 한 컬럼에 담으면 개명이\n * 곧 다른 트윈이 되고 재동기가 끊긴다 — 그래서 나눈다(이 저장소에서 식별자가 밖에서 오는 것은\n * 전부 이 규약을 쓴다: `spaceId`·`locationId`·`equipmentId`·`operationKey`).\n \n 나눴으면 이름을 반드시 함께 둬야 한다. 이 자리가 없던 동안 사이트 이름은 model 안에만 있어서\n * 목록이 `crew-two` 만 보였다 — 나누기만 하고 절반을 빼먹으면 화면에는 id 만 남는다.\n \n 원본이 이름을 말하지 않으면 비운다(id 를 베끼지 않는다).\n /\n @Column({ nullable: true })\n @Field({ nullable: true, description: 'Human name of this twin (the site name from its master). Empty when the source does not name it — never copied from instanceId.' })\n name?: string\n\n @Column({ nullable: true })\n @Field({ nullable: true, description: 'Longer description when the source provides one.' })\n description?: string\n\n / 어느 도메인 커널이 이 트윈을 운영하는가. 커널 없는 트윈은 없으므로 비어 있을 수 없다\n (`TwinEngine.start`·`register` 모두 필수 인자로 받는다). /\n @Column()\n @Field({ description: 'Domain kernel kind: wms \| yms \| mes.' })\n kind: string\n\n /\n * 재기동 정책 — 이 트윈은 다시 세워질 때 자기 과거를 어떻게 대하나(ADR-0029 §2).\n \n 'resync' = 외부 실물에서 다시 읽는다(원본이 진실이므로 우리 과거를 이어 붙이지 않는다 → startLive).\n * 'resume' = 저널을 이어 세운다(이 트윈이 낳은 타임라인이 곧 사실이다).\n * 'reset' = 저널을 비우고 씨앗부터 다시 돌린다(재현 가능한 실험 — 백지 시작이 선언된 거동이다).\n \n ── 왜 트윈에 남았나 (옛 이름 `realityMode`) ────────────────────────────────\n * 「현실이 어디서 오나」는 ADR-0029 가 원본의 종류로 옮긴 물음이다(`TwinReference.adapterType`) —\n * 트윈은 한 종류이고 언제나 원본을 반영한다. 그런데 코드가 이 축으로 실제로 가른 것은 *재기동 거동\n 하나였고, 그것은 원본의 성질이 아니라 트윈과 자기 과거의 관계*다: 같은 시뮬레이터 원본을 보는 두\n 트윈이 하나는 이어가고 하나는 매번 처음부터 재현할 수 있다. 그래서 축은 남고 이름만 바뀌었다.\n \n 비어 있을 수 없고, 기본값도 없다. 예전에는 미선언이 알리지 않고 `sim-experiment`(=저널 초기화)로\n * 떨어졌다 — 값이 하나 어긋나는 순간 이력을 지우는 길이다. 이제 읽는 쪽이 오류를 낸다\n * (`engine/restart-policy.ts`). 선언은 프로비저닝하는 쪽의 몫이다.\n /\n @Column()\n @Field({ description: \"Restart policy: 'resync' (read again from the external source) \| 'resume' (continue this twin's own journal) \| 'reset' (wipe and replay from the seed). No default — an unspecified policy is refused.\" })\n restartPolicy: string\n\n / 읽을 때 어휘 세대를 흡수한다(`nodes`/`movers`/`equipmentList` → `locations`/`equipment`). (vocabulary-guard: allow — 세대 이름 없이는 설명할 수 없다.)\n 자리마다 리더를 쓰게 하면 다음에 추가되는 자리가 또 빠지고, 빠진 것은 오류가 아니라 빈 공장이라\n 들어온 것이 없다(2026-08-06: 모델러 엔티티 목록이 통째로 비었다). 상세 `engine/model-vocabulary.ts`. /\n @Column({ type: 'simple-json', nullable: true, transformer: modelColumnTransformer })\n @Field(type => ScalarObject, { nullable: true, description: 'TwinModelDef blueprint (locations/equipment) required to replay events into state. Older stored boards used nodes/movers/equipmentList; they are normalised on read so consumers see one vocabulary.' }) // vocabulary-guard: allow — 옛 어휘를 흡수하는 것이 이 코드의 일이다(세대 이름을 적어야 흡수할 수 있다)\n model?: any\n\n /\n * 로컬 선언 겹 — 구조는 원천이, 수는 우리가.\n \n 요금 단가·계약 정보·축전지 충전율처럼 원 시스템이 모르는 값을 넣는 자리다. `model` 에 직접 쓰지\n * 않는 이유는 그것이 원천의 사본이기 때문이다: 다시 읽기가 사본을 새로 그리면 직접 쓴 값은 알리지 않고\n * 사라진다(요금이 사라지면 금액도 사라지고, 사용자는 이유를 알 수 없다).\n \n 그래서 여기 남기고, 모델을 그릴 때마다 그 위에 얹는다(`engine/local-declarations`). 얹힌 값에는\n * `source: 'local'` 이 붙는다 — 커널 계약의 `PropertySource` 축(`reference` ↔ `local`)이고, 「밖에서\n * 참조해 온 값이냐, 이 안에서 정한 값이냐」에 답한다.\n \n 이름에 장소 낱말을 쓰지 않는다(옛 이름 `siteDeclarations`): 이 코드에서 `site` 는 *외부\n 시스템이 부르는 사업장*이고(SAP `P3`·Oracle `W01` 이 같은 현장), 여기 담기는 것은 그 외부 시스템이\n 모르는 값이다 — 이름이 내용과 정반대였다. `space` 도 아니다: 그것은 「어디」에 답하고 이 축은\n * 「누가 말했나」에 답한다.\n /\n @Column({ type: 'simple-json', nullable: true })\n @Field(type => ScalarObject, { nullable: true, description: \"Locally-declared values layered on top of the reference-derived model (tariff, contract, state of charge) — values whose authority sits here, not in the source system. Kept apart from `model` so a resync cannot silently drop them.\" })\n localDeclarations?: any\n\n @Column({ nullable: true })\n @Field({ nullable: true, description: 'Owning space id (co-location anchor). Promoted from model.spaceId — first-class \"space → its twins\" query (space-centered ontology).' })\n spaceId?: string\n\n @Column({ nullable: true })\n @Field({ nullable: true, description: 'Owning area id within the space (optional scope). Promoted from model.areaId.' })\n areaId?: string\n\n @Column({ nullable: true })\n @Field({ nullable: true, description: 'Lifecycle status: running \| stopped.' })\n status?: string\n\n /\n * purpose — 이 인스턴스가 운영 트윈인지, 격리된 벤치 사본인지 1급 선언(이름 접두사가 아니라 속성으로 구별).\n * 'bench' 는 규모/부하 실험용 격리 사본 — 목록·정리·안전 가드가 이 속성을 키로 동작(운영 트윈 무오염 보장).\n \n 비어 있을 수 없다. 프로비저닝이 `register` 에서 'operational' 로 각인하고, 벤치 사본만\n * `setPurpose` 로 뒤집는다. 예전에는 비워 둔 채 읽는 쪽에서 메웠는데, 그러면 \"운영이라고 선언된 것\"\n * 과 \"아무도 말하지 않은 것\" 이 같은 값으로 보여서 벤치 격리가 추측에 기대게 된다.\n /\n @Column()\n @Field({ description: \"Instance purpose: 'operational' (real twin) \| 'bench' (isolated copy for scale/load experiments).\" })\n purpose: string\n\n @Column({ nullable: true })\n @Field({ nullable: true, description: 'For a bench copy: the source spaceId it was copied from (provenance).' })\n copyOf?: string\n\n /\n 이 트윈을 다시 읽는 방법 — 어떤 원본에서 나왔나(`MasterOrigin`).\n \n 트윈은 원본을 비출 뿐이므로(ADR-0028) 원본이 달라지면 다시 읽어야 한다. 그런데 이 자리가 없던\n * 동안 트윈은 자기가 무엇에서 나왔는지 몰랐다 — 어댑터로 들어온 트윈은 `TwinReference` 행이\n * 있었지만 템플릿으로 세운 트윈에는 아무 표식도 없었고, 그래서 첫날의 모습에 영원히 머무는\n * 트윈이 만들어졌다. 원천이 무엇이든 여기 한 자리에 남긴다.\n \n 비어 있을 수 있다 — 이 자리가 생기기 전에 만들어진 트윈이 그렇다. 그때는 \"다시 읽을 수\n * 없다\" 가 사실이므로 화면이 그대로 말한다(짐작해 채우지 않는다).\n /\n @Column({ type: 'simple-json', nullable: true })\n @Field(type => ScalarObject, {\n nullable: true,\n description:\n \"How this twin's master can be produced again — {kind:'reference', source} or {kind:'template', templateId, params}. Absent means this twin cannot be re-read from its source.\"\n })\n origin?: any\n\n /\n * `revision` 컬럼은 없앴다(2026-08-08).\n \n `ADR-0015` 가 \"정의만 있고 write 안 됨 — 프로비저닝에서 최신 저널 revision 을 반영하도록\n * 채운다\" 고 적어 두었는데, 채우지 않는 편이 맞다. 저널의 최신 번호는 저널이 아는 사실이고\n * (`TwinEngine.list` 가 `MAX(revision)` 으로 낸다), 여기 복제하면 같은 사실의 집이 둘이 된다.\n * 이 세션에만 그 부류를 셋 겪었다(`model.operations` 두 집 · `materials` 두 집 · tenantId 중복).\n \n 복제한 값은 반드시 어긋난다 — 저널은 틱마다 늘고 이 컬럼은 저장할 때만 갱신되므로, 화면이\n * 어느 쪽을 읽느냐로 다른 숫자가 나온다. 그 들어온 것이 없는 어긋남을 만들 이유가 없다.\n /\n\n @CreateDateColumn()\n @Field({ nullable: true, description: 'Timestamp when the instance was first registered.' })\n createdAt?: Date\n\n @UpdateDateColumn()\n @Field({ nullable: true, description: 'Timestamp when the instance registry row was last updated.' })\n updatedAt?: Date\n\n /\n * 누가 만들고 누가 고쳤나 — 이 행은 사람이 만든다(프로비저닝은 사용자 행위)이므로 규약의\n * 풀세트를 갖는다. 투영 행(자리·설비·공정)은 반대로 인제스트가 그린 것이라 저자가 사람이 아니고,\n * 그 저자는 `sourceRef`+`ingestedAt` 이 이미 말한다 — 그래서 그쪽에는 두지 않는다.\n \n 비어 있을 수 있다: 부팅 자동 프로비저닝처럼 사람이 없는 경로로 만들어진 행이 그렇다.\n * 그때 아무 사용자를 적어 넣으면 감사 기록이 거짓이 된다.\n */\n @ManyToOne(type => User, { nullable: true })\n @Field(type => User, { nullable: true, description: 'The user who first provisioned this twin. Empty when it was created by a system path (boot provisioning).' })\n creator?: User\n\n @RelationId((e: TwinInstance) => e.creator)\n creatorId?: string\n\n @ManyToOne(type => User, { nullable: true })\n @Field(type => User, { nullable: true, description: 'The user who last changed this twin registry row.' })\n updater?: User\n\n @RelationId((e: TwinInstance) => e.updater)\n updaterId?: string\n}\n"]}

package/dist-server/service/twin-journal/event-type-split-shape.d.ts ADDED Viewed

@@ -0,0 +1,50 @@
+/** 질의를 몇 개까지 나눌까 — 대상 × 종류. 이 이상이면 나누는 것이 손해다. */
+export declare const MAX_SPLIT = 24;
+export interface SplitShape {
+    eventTypes: string[];
+    /**
+     * 공정 단계 하나로 좁힌 경우 — 그 값을 갈래마다 함께 건다.
+     *
+     * 이 필터를 만나면 갈래를 포기하던 것을 고쳤다(2026-08-29). 원장은 종류를 담아 묻고 그 위에 단계
+     * 칩을 겹치는데, 칩을 고른 순간 예전 경로로 떨어져 **고르지 않은 쪽이 더 빨랐다.**
+     *
+     * 단계 컬럼에는 색인이 없다. 그래도 느려지지 않는다 — 종류 정확일치가 색인으로 시각 순서까지 주고,
+     * 단계는 그 안에서 행마다 확인하는 조건이다(걷는 행이 그 종류의 것으로 이미 좁혀져 있다).
+     */
+    bizStep?: string;
+    untilTime?: Date;
+    fromTime?: Date;
+}
+/**
+ * 이 물음이 「여러 종류를 시각순으로」인가 — 아니면 `null`.
+ *
+ * 받는 모양
+ *   `eventType` 을 `in` 으로 · 시각 상한이나 구간 · 시각 내림차순 정렬
+ *
+ * 보내는 모양(일반 경로로)
+ *   자유 검색어 · 그 밖의 필터(축·상관 식별자·업무 단계) · 그 밖의 정렬이나 연산자
+ */
+export declare function splitShape(params: any, sortings: any[]): SplitShape | null;
+/**
+ * **나눠 물은 갈래들을 합쳐 앞에서 `limit` 개** — 이 규율이 정확성의 근거다.
+ *
+ * ── 왜 갈래마다 `limit` 까지 받아야 하나 ────────────────────────────────────
+ * 갈래마다 `limit` 개를 받아 합치면, 합친 것의 앞 `limit` 개는 **전체에서도** 앞 `limit` 개다.
+ * 어떤 갈래에서 빠진 행은 그 갈래의 `limit` 번째보다 뒤이고, 우리는 전체에서 `limit` 개만 취하므로
+ * 그 행이 이 페이지에 들어올 수 없다.
+ *
+ * 갈래마다 **더 적게** 받으면 그 성질이 깨진다. 한 갈래가 앞을 다 차지하는 경우
+ * (종류 A 의 마지막이 종류 B 의 첫째보다 앞선다) 그 갈래에서 못 받은 것이 빠지고, 결과는 구간의
+ * 앞부분만 계산한 것이 된다 — 그런데 화면은 「일부만 읽었다」고만 말하고 어느 부분인지는 말하지 못한다.
+ * (2026-08-28 · UX 레인이 미리 짚어 준 함정이다.)
+ *
+ * 그래서 이 함수는 **`limit` 미만으로 받은 갈래가 있으면 그것을 말한다** — 부르는 쪽이 그 상태로
+ * 답하지 않게.
+ */
+export declare function mergeStreams<T>(streams: readonly T[][], limit: number,
+/** 앞에 와야 하는 것이 음수 — `Array.prototype.sort` 와 같은 규약. */
+compare: (a: T, b: T) => number): {
+    items: T[];
+    capped: boolean;
+    underfilled: boolean;
+};

package/dist-server/service/twin-journal/event-type-split-shape.js ADDED Viewed

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_SPLIT = void 0;
+exports.splitShape = splitShape;
+exports.mergeStreams = mergeStreams;
+/*
+ * **이 물음이 「여러 종류를 시각순으로」인가** — 순수 판단만 여기 둔다.
+ *
+ * 데이터베이스를 부르지 않는다. 그래서 시험이 이 파일을 그대로 부를 수 있다(데코레이터가 없다).
+ * 판단이 조회 코드 안에 섞여 있으면 그 판단만 확인할 방법이 없고, 그러면 「어떤 물음이 나눠 묻는
+ * 갈래로 가는가」가 아무도 읽지 못하는 규칙이 된다.
+ *
+ * 실측 근거와 고침의 뜻은 `event-type-split.ts` 머리에 있다.
+ */
+const read_time_js_1 = require("../../engine/read-time.js");
+/** 질의를 몇 개까지 나눌까 — 대상 × 종류. 이 이상이면 나누는 것이 손해다. */
+exports.MAX_SPLIT = 24;
+/** 종류 목록의 상한 — 이보다 많으면 「이 종류만」이 아니라 사실상 전체다. */
+const MAX_TYPES = 12;
+/**
+ * 이 물음이 「여러 종류를 시각순으로」인가 — 아니면 `null`.
+ *
+ * 받는 모양
+ *   `eventType` 을 `in` 으로 · 시각 상한이나 구간 · 시각 내림차순 정렬
+ *
+ * 보내는 모양(일반 경로로)
+ *   자유 검색어 · 그 밖의 필터(축·상관 식별자·업무 단계) · 그 밖의 정렬이나 연산자
+ */
+function splitShape(params, sortings) {
+    const filters = Array.isArray(params?.filters) ? params.filters : [];
+    if (typeof params?.search === 'string' && params.search.trim())
+        return null;
+    if (sortings.length !== 1 || sortings[0]?.name !== 'eventTime' || sortings[0]?.desc !== true)
+        return null;
+    let eventTypes;
+    let untilTime;
+    let fromTime;
+    let bizStep;
+    for (const f of filters) {
+        if (f?.name === 'eventType') {
+            if (f.operator !== 'in' || !Array.isArray(f.value))
+                return null;
+            const types = f.value.map((v) => String(v ?? '').trim()).filter((t) => !!t);
+            /* 하나면 나눌 것이 없다(이미 정확일치라 색인을 탄다). 너무 많으면 사실상 전체다. */
+            if (types.length < 2 || types.length > MAX_TYPES)
+                return null;
+            if (eventTypes)
+                return null;
+            eventTypes = [...new Set(types)];
+        }
+        else if (f?.name === 'bizStep') {
+            /* 하나로 좁힌 경우만 받는다 — 여러 값이면 종류 × 단계로 갈래가 곱해진다. */
+            if (f.operator !== 'eq')
+                return null;
+            const v = String(f.value ?? '').trim();
+            if (!v)
+                return null;
+            if (bizStep)
+                return null;
+            bizStep = v;
+        }
+        else if (f?.name === 'eventTime') {
+            if (f.operator === 'lte' || f.operator === 'lt') {
+                untilTime = (0, read_time_js_1.absoluteTime)(f.value) ?? undefined;
+                if (!untilTime)
+                    return null;
+            }
+            else if (f.operator === 'between' && Array.isArray(f.value)) {
+                fromTime = (0, read_time_js_1.absoluteTime)(f.value[0]) ?? undefined;
+                untilTime = (0, read_time_js_1.absoluteTime)(f.value[1]) ?? undefined;
+                if (!fromTime || !untilTime)
+                    return null;
+            }
+            else
+                return null;
+        }
+        else
+            return null;
+    }
+    return eventTypes ? { eventTypes, untilTime, fromTime, bizStep } : null;
+}
+/**
+ * **나눠 물은 갈래들을 합쳐 앞에서 `limit` 개** — 이 규율이 정확성의 근거다.
+ *
+ * ── 왜 갈래마다 `limit` 까지 받아야 하나 ────────────────────────────────────
+ * 갈래마다 `limit` 개를 받아 합치면, 합친 것의 앞 `limit` 개는 **전체에서도** 앞 `limit` 개다.
+ * 어떤 갈래에서 빠진 행은 그 갈래의 `limit` 번째보다 뒤이고, 우리는 전체에서 `limit` 개만 취하므로
+ * 그 행이 이 페이지에 들어올 수 없다.
+ *
+ * 갈래마다 **더 적게** 받으면 그 성질이 깨진다. 한 갈래가 앞을 다 차지하는 경우
+ * (종류 A 의 마지막이 종류 B 의 첫째보다 앞선다) 그 갈래에서 못 받은 것이 빠지고, 결과는 구간의
+ * 앞부분만 계산한 것이 된다 — 그런데 화면은 「일부만 읽었다」고만 말하고 어느 부분인지는 말하지 못한다.
+ * (2026-08-28 · UX 레인이 미리 짚어 준 함정이다.)
+ *
+ * 그래서 이 함수는 **`limit` 미만으로 받은 갈래가 있으면 그것을 말한다** — 부르는 쪽이 그 상태로
+ * 답하지 않게.
+ */
+function mergeStreams(streams, limit,
+/** 앞에 와야 하는 것이 음수 — `Array.prototype.sort` 와 같은 규약. */
+compare) {
+    const underfilled = streams.some(s => s.length > limit);
+    const merged = streams.flat().sort(compare);
+    return {
+        items: merged.slice(0, limit),
+        /* 합친 것이 상한을 넘었으면 더 있었다는 뜻이다 — 잘랐다는 사실을 부르는 쪽이 말해야 한다. */
+        capped: merged.length > limit || streams.some(s => s.length >= limit),
+        /* 갈래가 상한보다 많이 받아 왔다 — 있을 수 없는 일이므로 부르는 쪽이 알아야 한다. */
+        underfilled
+    };
+}
+//# sourceMappingURL=event-type-split-shape.js.map

package/dist-server/service/twin-journal/event-type-split-shape.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"event-type-split-shape.js","sourceRoot":"","sources":["../../../server/service/twin-journal/event-type-split-shape.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * **이 물음이 「여러 종류를 시각순으로」인가** — 순수 판단만 여기 둔다.\n *\n * 데이터베이스를 부르지 않는다. 그래서 시험이 이 파일을 그대로 부를 수 있다(데코레이터가 없다).\n * 판단이 조회 코드 안에 섞여 있으면 그 판단만 확인할 방법이 없고, 그러면 「어떤 물음이 나눠 묻는\n * 갈래로 가는가」가 아무도 읽지 못하는 규칙이 된다.\n *\n * 실측 근거와 고침의 뜻은 `event-type-split.ts` 머리에 있다.\n */\nimport { absoluteTime } from '../../engine/read-time.js'\n\n/** 질의를 몇 개까지 나눌까 — 대상 × 종류. 이 이상이면 나누는 것이 손해다. */\nexport const MAX_SPLIT = 24\n\n/** 종류 목록의 상한 — 이보다 많으면 「이 종류만」이 아니라 사실상 전체다. */\nconst MAX_TYPES = 12\n\nexport interface SplitShape {\n eventTypes: string[]\n /**\n * 공정 단계 하나로 좁힌 경우 — 그 값을 갈래마다 함께 건다.\n *\n * 이 필터를 만나면 갈래를 포기하던 것을 고쳤다(2026-08-29). 원장은 종류를 담아 묻고 그 위에 단계\n * 칩을 겹치는데, 칩을 고른 순간 예전 경로로 떨어져 **고르지 않은 쪽이 더 빨랐다.**\n *\n * 단계 컬럼에는 색인이 없다. 그래도 느려지지 않는다 — 종류 정확일치가 색인으로 시각 순서까지 주고,\n * 단계는 그 안에서 행마다 확인하는 조건이다(걷는 행이 그 종류의 것으로 이미 좁혀져 있다).\n */\n bizStep?: string\n untilTime?: Date\n fromTime?: Date\n}\n\n/**\n * 이 물음이 「여러 종류를 시각순으로」인가 — 아니면 `null`.\n *\n * 받는 모양\n * `eventType` 을 `in` 으로 · 시각 상한이나 구간 · 시각 내림차순 정렬\n *\n * 보내는 모양(일반 경로로)\n * 자유 검색어 · 그 밖의 필터(축·상관 식별자·업무 단계) · 그 밖의 정렬이나 연산자\n */\nexport function splitShape(params: any, sortings: any[]): SplitShape | null {\n const filters: any[] = Array.isArray(params?.filters) ? params.filters : []\n if (typeof params?.search === 'string' && params.search.trim()) return null\n if (sortings.length !== 1 || sortings[0]?.name !== 'eventTime' || sortings[0]?.desc !== true) return null\n\n let eventTypes: string[] | undefined\n let untilTime: Date | undefined\n let fromTime: Date | undefined\n let bizStep: string | undefined\n for (const f of filters) {\n if (f?.name === 'eventType') {\n if (f.operator !== 'in' || !Array.isArray(f.value)) return null\n const types: string[] = f.value.map((v: unknown) => String(v ?? '').trim()).filter((t: string) => !!t)\n /* 하나면 나눌 것이 없다(이미 정확일치라 색인을 탄다). 너무 많으면 사실상 전체다. */\n if (types.length < 2 || types.length > MAX_TYPES) return null\n if (eventTypes) return null\n eventTypes = [...new Set(types)]\n } else if (f?.name === 'bizStep') {\n /* 하나로 좁힌 경우만 받는다 — 여러 값이면 종류 × 단계로 갈래가 곱해진다. */\n if (f.operator !== 'eq') return null\n const v = String(f.value ?? '').trim()\n if (!v) return null\n if (bizStep) return null\n bizStep = v\n } else if (f?.name === 'eventTime') {\n if (f.operator === 'lte' || f.operator === 'lt') {\n untilTime = absoluteTime(f.value) ?? undefined\n if (!untilTime) return null\n } else if (f.operator === 'between' && Array.isArray(f.value)) {\n fromTime = absoluteTime(f.value[0]) ?? undefined\n untilTime = absoluteTime(f.value[1]) ?? undefined\n if (!fromTime || !untilTime) return null\n } else return null\n } else return null\n }\n return eventTypes ? { eventTypes, untilTime, fromTime, bizStep } : null\n}\n\n/**\n * **나눠 물은 갈래들을 합쳐 앞에서 `limit` 개** — 이 규율이 정확성의 근거다.\n *\n * ── 왜 갈래마다 `limit` 까지 받아야 하나 ────────────────────────────────────\n * 갈래마다 `limit` 개를 받아 합치면, 합친 것의 앞 `limit` 개는 **전체에서도** 앞 `limit` 개다.\n * 어떤 갈래에서 빠진 행은 그 갈래의 `limit` 번째보다 뒤이고, 우리는 전체에서 `limit` 개만 취하므로\n * 그 행이 이 페이지에 들어올 수 없다.\n *\n * 갈래마다 **더 적게** 받으면 그 성질이 깨진다. 한 갈래가 앞을 다 차지하는 경우\n * (종류 A 의 마지막이 종류 B 의 첫째보다 앞선다) 그 갈래에서 못 받은 것이 빠지고, 결과는 구간의\n * 앞부분만 계산한 것이 된다 — 그런데 화면은 「일부만 읽었다」고만 말하고 어느 부분인지는 말하지 못한다.\n * (2026-08-28 · UX 레인이 미리 짚어 준 함정이다.)\n *\n * 그래서 이 함수는 **`limit` 미만으로 받은 갈래가 있으면 그것을 말한다** — 부르는 쪽이 그 상태로\n * 답하지 않게.\n */\nexport function mergeStreams<T>(\n streams: readonly T[][],\n limit: number,\n /** 앞에 와야 하는 것이 음수 — `Array.prototype.sort` 와 같은 규약. */\n compare: (a: T, b: T) => number\n): { items: T[]; capped: boolean; underfilled: boolean } {\n const underfilled = streams.some(s => s.length > limit)\n const merged = streams.flat().sort(compare)\n return {\n items: merged.slice(0, limit),\n /* 합친 것이 상한을 넘었으면 더 있었다는 뜻이다 — 잘랐다는 사실을 부르는 쪽이 말해야 한다. */\n capped: merged.length > limit || streams.some(s => s.length >= limit),\n /* 갈래가 상한보다 많이 받아 왔다 — 있을 수 없는 일이므로 부르는 쪽이 알아야 한다. */\n underfilled\n }\n}\n"]}

package/dist-server/service/twin-journal/event-type-split.d.ts ADDED Viewed

@@ -0,0 +1,15 @@
+import { TwinEvent } from '../twin-event/twin-event.js';
+import { type SplitShape } from './event-type-split-shape.js';
+export interface SplitPage {
+    items: TwinEvent[];
+    nextCursor?: string;
+}
+/**
+ * 나눠 묻고 합쳐 한 페이지 — 답할 수 없으면 `null`.
+ *
+ * 이어 읽기 지점은 **모든 갈래에 같이** 건다. 그래야 합친 결과가 커서 아래에서만 나온다 — 갈래마다
+ * 다르게 걸면 어떤 종류는 이미 지나간 구간을 다시 낸다.
+ */
+export declare function eventTypeSplitPage(domainId: string, instanceIds: string[], shape: SplitShape, limit: number,
+/** 동시각을 가리는 축 — 트윈 하나면 `revision`, 여럿이면 기본키(§`cursorTiebreak`). */
+tiebreak: 'revision' | 'id', after?: string): Promise<SplitPage | null>;

package/dist-server/service/twin-journal/event-type-split.js ADDED Viewed

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eventTypeSplitPage = eventTypeSplitPage;
+const shell_1 = require("@things-factory/shell");
+const twin_event_js_1 = require("../twin-event/twin-event.js");
+const read_time_js_1 = require("../../engine/read-time.js");
+const event_type_split_shape_js_1 = require("./event-type-split-shape.js");
+/**
+ * 나눠 묻고 합쳐 한 페이지 — 답할 수 없으면 `null`.
+ *
+ * 이어 읽기 지점은 **모든 갈래에 같이** 건다. 그래야 합친 결과가 커서 아래에서만 나온다 — 갈래마다
+ * 다르게 걸면 어떤 종류는 이미 지나간 구간을 다시 낸다.
+ */
+async function eventTypeSplitPage(domainId, instanceIds, shape, limit,
+/** 동시각을 가리는 축 — 트윈 하나면 `revision`, 여럿이면 기본키(§`cursorTiebreak`). */
+tiebreak, after) {
+    const pairs = instanceIds.length * shape.eventTypes.length;
+    if (!pairs || pairs > event_type_split_shape_js_1.MAX_SPLIT)
+        return null;
+    let cursor = null;
+    if (after) {
+        cursor = decodeCursorPair(after);
+        if (!cursor)
+            return null;
+    }
+    const rows = [];
+    for (const instanceId of instanceIds) {
+        for (const eventType of shape.eventTypes) {
+            const qb = (0, shell_1.getRepository)(twin_event_js_1.TwinEvent)
+                .createQueryBuilder('e')
+                .where('e.domain = :domainId', { domainId })
+                .andWhere('e.instanceId = :instanceId', { instanceId })
+                /* **정확일치**가 요점이다 — 그래야 색인이 시각 순서까지 준다(§ 위 실측). */
+                .andWhere('e.eventType = :eventType', { eventType });
+            /* 단계는 색인이 아니라 행 조건이다 — 종류 정확일치가 이미 걷는 범위를 좁혀 놓았다. */
+            if (shape.bizStep)
+                qb.andWhere('e.bizStep = :bizStep', { bizStep: shape.bizStep });
+            if (shape.fromTime)
+                qb.andWhere('e.eventTime >= :fromTime', { fromTime: shape.fromTime });
+            if (shape.untilTime)
+                qb.andWhere('e.eventTime <= :untilTime', { untilTime: shape.untilTime });
+            if (cursor) {
+                qb.andWhere(`(e.eventTime < :curAt OR (e.eventTime = :curAt AND e.${tiebreak} < :curTie))`, {
+                    curAt: cursor.at,
+                    curTie: cursor.tie
+                });
+            }
+            const page = await qb
+                .orderBy('e.eventTime', 'DESC')
+                .addOrderBy(`e.${tiebreak}`, 'DESC')
+                .limit(limit)
+                .getMany()
+                .catch(() => null);
+            /* 한 갈래라도 못 읽으면 합친 결과가 반쪽이다 — 반쪽을 전부인 것처럼 내지 않는다. */
+            if (!page)
+                return null;
+            rows.push(page);
+        }
+    }
+    /*
+     * 합친다. 갈래마다 `limit` 까지 받았으므로, 합쳐서 앞의 `limit` 개는 **전체에서도** 앞의 `limit` 개다
+     * (각 갈래가 자기 안에서 정렬돼 있고 그보다 앞선 것을 빠뜨릴 수 없다).
+     */
+    const merged = rows
+        .flat()
+        .sort((a, b) => {
+        /* `getMany` 는 엔티티를 주므로 시각이 이미 날짜다 — 감싸면 드라이버 값을 손으로 읽는 모양이 된다. */
+        const at = b.eventTime.getTime() - a.eventTime.getTime();
+        if (at !== 0)
+            return at;
+        const x = a[tiebreak];
+        const y = b[tiebreak];
+        return x === y ? 0 : x < y ? 1 : -1;
+    })
+        .slice(0, limit);
+    const last = merged[merged.length - 1];
+    const nextCursor = merged.length === limit && last?.eventTime instanceof Date && last[tiebreak] !== undefined
+        ? encodeCursorPair(last.eventTime, last[tiebreak])
+        : undefined;
+    return { items: merged, nextCursor };
+}
+/** 저널 경로와 같은 커서 — `[eventTime, 동시각 축]`(§`buildNextCursor`). */
+function encodeCursorPair(at, tie) {
+    return Buffer.from(JSON.stringify([at, tie]), 'utf8').toString('base64url');
+}
+function decodeCursorPair(cursor) {
+    let values;
+    try {
+        values = JSON.parse(Buffer.from(cursor, 'base64url').toString('utf8'));
+    }
+    catch {
+        return null;
+    }
+    if (!Array.isArray(values) || values.length !== 2)
+        return null;
+    const at = (0, read_time_js_1.absoluteTime)(values[0]);
+    const tie = values[1];
+    if (!at || (typeof tie !== 'string' && typeof tie !== 'number'))
+        return null;
+    return { at, tie };
+}
+//# sourceMappingURL=event-type-split.js.map

package/dist-server/service/twin-journal/event-type-split.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"event-type-split.js","sourceRoot":"","sources":["../../../server/service/twin-journal/event-type-split.ts"],"names":[],"mappings":"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","sourcesContent":["import { getRepository } from '@things-factory/shell'\n\nimport { TwinEvent } from '../twin-event/twin-event.js'\nimport { absoluteTime } from '../../engine/read-time.js'\nimport { MAX_SPLIT, type SplitShape } from './event-type-split-shape.js'\n\n/*\n * **여러 종류를 시각순으로 — 종류를 하나씩 나눠 묻는다** (2026-08-28 실측).\n *\n * ── 무엇이 느렸나 ───────────────────────────────────────────────────────────\n * 에너지 원장은 「이 여덟 종류를 시각 내림차순으로 50건」을 묻는다. 그 모양에서 sqlite 는 종류 색인을\n * **버린다**:\n *\n * 종류 IN + 시각순 SEARCH USING INDEX ix_twin_event_1 (domain, instance) 37.181초 · 결과 0건\n * 같은 조건 · 정렬 없음 SEARCH USING INDEX ix_twin_event_7 (…, event_type=?) 0.003초\n * 종류 하나 + 시각순 SEARCH USING INDEX ix_twin_event_7 (…, event_type=?) 0.003초\n *\n * 정렬을 붙이는 순간 여러 종류의 순서를 합칠 방법이 없어, 시각 색인으로 337만 행을 걸으며 행마다\n * 종류를 확인한다. 승화푸드에 에너지 사건은 0건이다 — **없는 것을 찾느라 37초**를 쓴다.\n *\n * 360 이력이 64초였던 것과 같은 부류다: **거르는 축과 정렬 축이 어긋난다.**\n *\n * ── 고침 ────────────────────────────────────────────────────────────────────\n * 종류를 **정확일치로 하나씩** 물으면 색인이 시각 순서까지 그대로 준다(정렬이 사라진다). 여덟 종류면\n * 질의 여덟 개이고 각 0.003초다. 받은 것을 시각순으로 합쳐 한 페이지를 만든다.\n *\n * 새 색인도, 새 테이블도 필요 없다 — 있는 색인을 쓰게 하는 것이 전부다.\n *\n * ── 좁게 잡는다 ─────────────────────────────────────────────────────────────\n * 이 모양이 아닌 물음은 답하지 않고(`null`) 저널의 일반 경로로 보낸다. 억지로 답하면 목록이 알리지\n * 않고 달라진다.\n *\n * ── ★ **이 갈래를 걷을 조건** ────────────────────────────────────────────────\n * 앱에서 종류를 여러 값으로 보내는 곳은 **에너지 원장 한 곳뿐**이다(2026-08-28 확인). 그 화면이\n * 종류를 하나씩 고르는 모양으로 바뀌면 이 갈래를 부르는 데가 없어진다 — 그때 **지운다.**\n *\n * 부르는 데가 없는 갈래를 들고 있으면, 그것이 무언가를 받쳐 주는 것처럼 보이면서 실제로는 아무것도\n * 하지 않는다. 지금 살려 두는 이유는 하나다: 실 고객 트윈에서 37초 질의가 돌고 있고 화면 수정은\n * 다른 레인의 일이다.\n */\n\nexport interface SplitPage {\n items: TwinEvent[]\n nextCursor?: string\n}\n\n/**\n * 나눠 묻고 합쳐 한 페이지 — 답할 수 없으면 `null`.\n *\n * 이어 읽기 지점은 **모든 갈래에 같이** 건다. 그래야 합친 결과가 커서 아래에서만 나온다 — 갈래마다\n * 다르게 걸면 어떤 종류는 이미 지나간 구간을 다시 낸다.\n */\nexport async function eventTypeSplitPage(\n domainId: string,\n instanceIds: string[],\n shape: SplitShape,\n limit: number,\n /** 동시각을 가리는 축 — 트윈 하나면 `revision`, 여럿이면 기본키(§`cursorTiebreak`). */\n tiebreak: 'revision' | 'id',\n after?: string\n): Promise<SplitPage | null> {\n const pairs = instanceIds.length * shape.eventTypes.length\n if (!pairs || pairs > MAX_SPLIT) return null\n\n let cursor: { at: Date; tie: string | number } | null = null\n if (after) {\n cursor = decodeCursorPair(after)\n if (!cursor) return null\n }\n\n const rows: TwinEvent[][] = []\n for (const instanceId of instanceIds) {\n for (const eventType of shape.eventTypes) {\n const qb = getRepository(TwinEvent)\n .createQueryBuilder('e')\n .where('e.domain = :domainId', { domainId })\n .andWhere('e.instanceId = :instanceId', { instanceId })\n /* **정확일치**가 요점이다 — 그래야 색인이 시각 순서까지 준다(§ 위 실측). */\n .andWhere('e.eventType = :eventType', { eventType })\n /* 단계는 색인이 아니라 행 조건이다 — 종류 정확일치가 이미 걷는 범위를 좁혀 놓았다. */\n if (shape.bizStep) qb.andWhere('e.bizStep = :bizStep', { bizStep: shape.bizStep })\n if (shape.fromTime) qb.andWhere('e.eventTime >= :fromTime', { fromTime: shape.fromTime })\n if (shape.untilTime) qb.andWhere('e.eventTime <= :untilTime', { untilTime: shape.untilTime })\n if (cursor) {\n qb.andWhere(`(e.eventTime < :curAt OR (e.eventTime = :curAt AND e.${tiebreak} < :curTie))`, {\n curAt: cursor.at,\n curTie: cursor.tie\n })\n }\n const page = await qb\n .orderBy('e.eventTime', 'DESC')\n .addOrderBy(`e.${tiebreak}`, 'DESC')\n .limit(limit)\n .getMany()\n .catch(() => null)\n /* 한 갈래라도 못 읽으면 합친 결과가 반쪽이다 — 반쪽을 전부인 것처럼 내지 않는다. */\n if (!page) return null\n rows.push(page)\n }\n }\n\n /*\n * 합친다. 갈래마다 `limit` 까지 받았으므로, 합쳐서 앞의 `limit` 개는 **전체에서도** 앞의 `limit` 개다\n * (각 갈래가 자기 안에서 정렬돼 있고 그보다 앞선 것을 빠뜨릴 수 없다).\n */\n const merged = rows\n .flat()\n .sort((a: any, b: any) => {\n /* `getMany` 는 엔티티를 주므로 시각이 이미 날짜다 — 감싸면 드라이버 값을 손으로 읽는 모양이 된다. */\n const at = (b.eventTime as Date).getTime() - (a.eventTime as Date).getTime()\n if (at !== 0) return at\n const x = a[tiebreak]\n const y = b[tiebreak]\n return x === y ? 0 : x < y ? 1 : -1\n })\n .slice(0, limit)\n\n const last: any = merged[merged.length - 1]\n const nextCursor =\n merged.length === limit && last?.eventTime instanceof Date && last[tiebreak] !== undefined\n ? encodeCursorPair(last.eventTime, last[tiebreak])\n : undefined\n\n return { items: merged, nextCursor }\n}\n\n/** 저널 경로와 같은 커서 — `[eventTime, 동시각 축]`(§`buildNextCursor`). */\nfunction encodeCursorPair(at: Date, tie: string | number): string {\n return Buffer.from(JSON.stringify([at, tie]), 'utf8').toString('base64url')\n}\n\nfunction decodeCursorPair(cursor: string): { at: Date; tie: string | number } | null {\n let values: unknown\n try {\n values = JSON.parse(Buffer.from(cursor, 'base64url').toString('utf8'))\n } catch {\n return null\n }\n if (!Array.isArray(values) || values.length !== 2) return null\n const at = absoluteTime(values[0])\n const tie = values[1]\n if (!at || (typeof tie !== 'string' && typeof tie !== 'number')) return null\n return { at, tie }\n}\n"]}

package/dist-server/service/twin-journal/journal-order.d.ts ADDED Viewed

@@ -0,0 +1,15 @@
+/**
+ * 지난 기록 조회의 정렬 축 — **부르는 쪽이 무엇으로 물었는지에 맞춘다.**
+ *
+ * 리졸버 안에 두면 이 규칙을 확인할 방법이 소스를 글자로 전수 조회하는 것뿐이다. 규칙 자체를 부를 수 있게
+ * 밖으로 뺀다(`test/journal-order-axis.test.ts`).
+ */
+export declare function journalOrder(q: {
+    untilTime?: string | null;
+    fromTime?: string | null;
+    fromRevision?: number | null;
+    toRevision?: number | null;
+}): {
+    eventTime?: 'DESC';
+    revision: 'DESC';
+};

package/dist-server/service/twin-journal/journal-order.js ADDED Viewed

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.journalOrder = journalOrder;
+/**
+ * 지난 기록 조회의 정렬 축 — **부르는 쪽이 무엇으로 물었는지에 맞춘다.**
+ *
+ * 리졸버 안에 두면 이 규칙을 확인할 방법이 소스를 글자로 전수 조회하는 것뿐이다. 규칙 자체를 부를 수 있게
+ * 밖으로 뺀다(`test/journal-order-axis.test.ts`).
+ */
+function journalOrder(q) {
+    /* `revision` 으로 물었으면 그 순서가 물음의 답이다. 거르는 축과 정렬 축을 맞추는 규칙과도 같다. */
+    const byTime = q.untilTime != null || q.fromTime != null;
+    if (!byTime && (q.fromRevision != null || q.toRevision != null))
+        return { revision: 'DESC' };
+    return { eventTime: 'DESC', revision: 'DESC' };
+}
+//# sourceMappingURL=journal-order.js.map

package/dist-server/service/twin-journal/journal-order.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"journal-order.js","sourceRoot":"","sources":["../../../server/service/twin-journal/journal-order.ts"],"names":[],"mappings":";;AAMA,oCAaC;AAnBD;;;;;GAKG;AACH,SAAgB,YAAY,CAAC,CAK5B;IAIC,iEAAiE;IACjE,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,IAAI,IAAI,IAAI,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAA;IACxD,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,YAAY,IAAI,IAAI,IAAI,CAAC,CAAC,UAAU,IAAI,IAAI,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;IAC5F,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;AAChD,CAAC","sourcesContent":["/**\n * 지난 기록 조회의 정렬 축 — **부르는 쪽이 무엇으로 물었는지에 맞춘다.**\n *\n * 리졸버 안에 두면 이 규칙을 확인할 방법이 소스를 글자로 전수 조회하는 것뿐이다. 규칙 자체를 부를 수 있게\n * 밖으로 뺀다(`test/journal-order-axis.test.ts`).\n */\nexport function journalOrder(q: {\n untilTime?: string | null\n fromTime?: string | null\n fromRevision?: number | null\n toRevision?: number | null\n}): {\n eventTime?: 'DESC'\n revision: 'DESC'\n} {\n /* `revision` 으로 물었으면 그 순서가 물음의 답이다. 거르는 축과 정렬 축을 맞추는 규칙과도 같다. */\n const byTime = q.untilTime != null || q.fromTime != null\n if (!byTime && (q.fromRevision != null || q.toRevision != null)) return { revision: 'DESC' }\n return { eventTime: 'DESC', revision: 'DESC' }\n}\n"]}

package/dist-server/service/twin-journal/twin-journal-query.d.ts CHANGED Viewed

@@ -2,13 +2,13 @@ import { ListParam } from '@things-factory/shell';
 import { TwinEvent } from '../twin-event/twin-event.js';
 import { TwinEventList } from '../twin-event/twin-event-type.js';
 export declare class TwinJournalQuery {
-    twinEvents(instanceId: string, fromRevision: number, toRevision: number, eventType: string, limit: number, context: ResolverContext, untilTime?: string): Promise<TwinEvent[]>;
+    twinEvents(instanceId: string, fromRevision: number, toRevision: number, eventType: string, limit: number, context: ResolverContext, untilTime?: string, fromTime?: string): Promise<TwinEvent[]>;
     /**
-     * 저널 목록 — things-factory 표준 목록 계약(`ListParam` → `{ items, total }`).
+     * 지난 기록 목록 — things-factory 표준 목록 계약(`ListParam` → `{ items, total }`).
      *
      * ── 왜 `twinEvents` 와 따로 두는가 ─────────────────────────────────────────
      * `twinEvents` 는 배열만 돌려준다. 화면은 자기가 받은 게 전부인지 잘린 건지 알 수 없었고, 그래서
-     * 리스트가 **조용히 잘린 채 "이게 전부" 처럼** 보였다(원장 limit 120 이 대표적). 총건수를 함께
+     * 리스트가 **알리지 않고 잘린 채 "이게 전부" 처럼** 보였다(원장 limit 120 이 대표적). 총건수를 함께
      * 주면 "48 / 12,904" 라고 말할 수 있고, 사용자는 좁혀야 한다는 사실을 안다.
      * 기존 호출자를 깨지 않으려고 `twinEvents` 는 그대로 두고 목록 계약을 새로 연다.
      *
@@ -21,13 +21,13 @@ export declare class TwinJournalQuery {
      */
     twinEventList(params: ListParam, context: ResolverContext, instanceId?: string, spaceId?: string): Promise<TwinEventList>;
     /**
-     * 업무 KPI — 시간창 처리량·소요시간·자원 점유. 저널을 **접어서** 만든다(새 계측을 주입하지 않는다).
+     * 업무 KPI — 시간창 처리량·소요시간·자원 점유. 저널을 **계산해서** 만든다(새 계측을 주입하지 않는다).
      *
      * `twinMetrics`(초당 이벤트 수 = 인프라 부하)와 **다른 것**이다: 이건 "지난 한 시간에 몇 건 처리했고
      * 한 건에 얼마나 걸렸나" 다. 이름이 비슷해 헷갈리기 쉬우므로 설명에 명시한다.
      *
      * 완료된 작업의 **시작 이벤트가 창 앞에 있을 수 있어** 조회 구간을 창보다 앞으로 넓힌다(lookback).
-     * 그래도 못 찾은 것은 결과의 `unpaired` 로 드러난다 — 평균에서 조용히 빠지면 지표가 거짓이 된다.
+     * 그래도 못 찾은 것은 결과의 `unpaired` 로 드러난다 — 평균에서 오류 없이 빠지면 지표가 거짓이 된다.
      */
     twinKpi(context: ResolverContext, spaceId?: string, instanceId?: string,
     /** 창 시작·끝(ISO). 미지정이면 최근 1시간. */