@things-factory/headless-twin 10.0.18 → 10.1.0

package/dist-server/engine/canonical-ingest.d.ts

@@ -1,4 +1,5 @@
-import { type CanonicalRecord, type CanonicalAggregationRecord, type CanonicalTransformationRecord, type EnergyRecord, type EnergyEquipmentRecord, type OperationalRecord, type IngestResult, type MasterDataRecord } from '@operato/ops-contract';
+import { type CanonicalRecord, type CanonicalAggregationRecord, type CanonicalTransformationRecord, type AdapterRule, type EnergyRecord, type EnergyEquipmentRecord, type OperationalRecord, type IngestResult, type MasterDataRecord } from '@operato/ops-contract';
+export declare function canonicalRulesForTest(): AdapterRule[];
 /** 정규 레코드[] → 검증된 CanonicalEnvelope[] (+ 거부분). 순수 함수. 단일→객체도 배열로 정규화. */
 export declare function ingestCanonicalRecords(records: CanonicalRecord | CanonicalAggregationRecord | CanonicalTransformationRecord | EnergyRecord | EnergyEquipmentRecord | OperationalRecord | MasterDataRecord | (CanonicalRecord | CanonicalAggregationRecord | CanonicalTransformationRecord | EnergyRecord | EnergyEquipmentRecord | OperationalRecord | MasterDataRecord)[] | undefined | null, tenantId: string, defaultEventTime: string, 
 /**
@@ -22,4 +23,12 @@ scope?: {
  */
 export interface CanonicalIngestResult extends IngestResult {
     masterData: MasterDataRecord[];
+    /**
+     * 시각을 못 읽어 ingest 시각으로 떨어진 record 를 **type 별로** 센다.
+     *
+     * 비어 있으면 전부 자기 시각을 말한 것이다. 값이 있어도 오류는 아니다 — 절대값 snapshot 은
+     * polling 순간이 맞는 시각이다. 다만 그 수가 남아야 「5일 틀린 값이 저장됐다」를 나중에 찾을 수
+     * 있다(2026-09-06 에 그것을 backfill 로 찾았다).
+     */
+    undated: Record<string, number>;
 }

package/dist-server/engine/canonical-ingest.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.canonicalRulesForTest = canonicalRulesForTest;
 exports.ingestCanonicalRecords = ingestCanonicalRecords;
 const ops_contract_1 = require("@operato/ops-contract");
+const event_time_js_1 = require("./event-time.js");
 /*
  * 정규 레코드 → 커널 검증 ACL → CanonicalEnvelope (P1 seam 코어).
  * 순수(커널만 의존; shell·integration-base 무의존 → node:test 검증 가능).
@@ -21,15 +23,65 @@ const ops_contract_1 = require("@operato/ops-contract");
  *   - live 커넥터 경로: reference-live(어댑터 openLiveFeed→여기).
  * SoT: design/integration/face2-adapters.md §5(seam)·§7(매핑=밖, 검증=커널).
  */
+/*
+ * **표준 헤더 필드는 한 번만 적는다** — 세 규칙이 이것을 펼쳐 쓴다.
+ *
+ * ── 왜 뽑아냈나 (2026-09-07) ────────────────────────────────────────────────
+ * 이 파일은 규칙 셋을 손으로 나란히 적고 있었고, 그래서 헤더 필드를 더할 때마다 **세 곳을 다 고쳐야**
+ * 했다. 그 구조가 같은 결함을 네 번 만들었다.
+ *
+ * ```
+ * quantityList        낱개 번호 없는 자재의 잔량을 말할 길이 없었다
+ * ilmd                포천 재고 1,704행 전부에 소비기한이 있는데 상태에는 0건
+ * errorDeclaration    정정이 또 하나의 사실로 쌓였다
+ * bizTransactionList  저널에 칸·인덱스·질의가 다 있는데 실 시스템 연결에서 0건
+ * ```
+ *
+ * 네 번째는 계약을 열고도 **이 파일이 그 스펙을 안 써서** 여전히 사라지고 있었다. 인티그레이션 레인이
+ * 규칙 그대로 `mapRecord` 를 돌려서 찾았다 — 읽어서 맞다고 하지 않고 돌려 본 것이 잡았다.
+ *
+ * 이제 헤더 필드를 더하는 것은 **이 상수 한 줄**이고, 세 갈래에 동시에 닿는다.
+ *
+ * `action` 은 여기 없다 — `TransformationEvent` 에는 그 칸이 없다(무엇이 무엇으로 되었나에는 방향이
+ * 하나뿐이다). 그것만 규칙마다 적는다.
+ */
+const TWIN_INGEST_HEADER = {
+    bizStep: '$.bizStep',
+    disposition: '$.disposition',
+    /*
+     * **정정 선언** — 「이 사건은 없던 일이 되었다」(커널 0.7.65 에서 이 자리가 열렸다).
+     *
+     * 세 값이 함께여야 뜻이 있어 묶음으로 온다. 커널이 선언 시각을 요구하고, 없으면 사건 시각으로
+     * 메우지 않고 이유와 함께 돌려준다 — 「언제 정정했나」와 「언제 일어났나」가 같아지면 둘을 다시
+     * 갈라낼 수 없다.
+     *
+     * 상태는 이것으로 흔들리지 않는다. 커널은 정정을 목록에 적고 재고를 그대로 둔다 — 무엇을 어떻게
+     * 되돌릴지는 도메인 판단이고, 참 재고는 그 뒤의 잔량 관측이 다시 말해 준다.
+     */
+    errorDeclaration: {
+        declarationTime: '$.errorDeclaration.declarationTime',
+        reason: '$.errorDeclaration.reason',
+        correctiveEventIDs: '$.errorDeclaration.correctiveEventIDs'
+    },
+    /*
+     * **오더 참조** — 「이 물건은 어느 오더 것인가」(표준 §7.3.5.4, 계약 0.9.11 에서 이 자리가 열렸다).
+     *
+     * 받는 쪽은 처음부터 다 서 있었다: 저널에 `biz_transaction` 칸과 인덱스(`ix_twin_event_9`), 이력추적
+     * 질의가 그 칸으로 거르고, 커널이 네 자리에서 그것을 채운다. 그래서 커널 안쪽에서 나는 사실만 그
+     * 칸을 갖고 실 시스템이 먹이는 트윈은 조용히 비었다 — 시뮬 2,492건 대 `mes-line-a` 0건.
+     */
+    bizTransactionList: '$.bizTransactionList',
+    readPoint: '$.readPoint',
+    bizLocation: '$.bizLocation'
+};
 /** 고정 정규 매핑(방언 아님 — 필드명 자체가 정규 계약). `sourceType` 으로 어느 품목 사실인지 고른다. */
 const TWIN_INGEST_RULES = [
     {
         sourceType: 'twin',
         mapping: {
             type: 'ObjectEvent',
+            ...TWIN_INGEST_HEADER,
             action: '$.action',
-            bizStep: '$.bizStep',
-            disposition: '$.disposition',
             epc: '$.epc',
             /* 비직렬 수량 — 개체 없이 「이 자리에 이 품목이 얼마 남았다」만 오는 관측이 있다. */
             quantityList: '$.quantityList',
@@ -54,13 +106,6 @@ const TWIN_INGEST_RULES = [
              * 상태는 이것으로 흔들리지 않는다. 커널은 정정을 목록에 적고 재고를 그대로 둔다 — 무엇을 어떻게
              * 되돌릴지는 도메인 판단이고, 참 재고는 그 뒤의 잔량 관측이 다시 말해 준다.
              */
-            errorDeclaration: {
-                declarationTime: '$.errorDeclaration.declarationTime',
-                reason: '$.errorDeclaration.reason',
-                correctiveEventIDs: '$.errorDeclaration.correctiveEventIDs'
-            },
-            readPoint: '$.readPoint',
-            bizLocation: '$.bizLocation'
         }
     },
     {
@@ -68,20 +113,12 @@ const TWIN_INGEST_RULES = [
         sourceType: 'twin-transformation',
         mapping: {
             type: 'TransformationEvent',
-            bizStep: '$.bizStep',
-            disposition: '$.disposition',
+            ...TWIN_INGEST_HEADER,
             inputEPCList: '$.inputEPCList',
             inputQuantityList: '$.inputQuantityList',
             outputEPCList: '$.outputEPCList',
             outputQuantityList: '$.outputQuantityList',
             transformationID: '$.transformationID',
-            errorDeclaration: {
-                declarationTime: '$.errorDeclaration.declarationTime',
-                reason: '$.errorDeclaration.reason',
-                correctiveEventIDs: '$.errorDeclaration.correctiveEventIDs'
-            },
-            readPoint: '$.readPoint',
-            bizLocation: '$.bizLocation'
         }
     },
     {
@@ -93,23 +130,27 @@ const TWIN_INGEST_RULES = [
         sourceType: 'twin-aggregation',
         mapping: {
             type: 'AggregationEvent',
+            ...TWIN_INGEST_HEADER,
             action: '$.action',
-            bizStep: '$.bizStep',
-            disposition: '$.disposition',
             parentID: '$.parentID',
             childEPCs: '$.childEPCs',
             /* 낱개 식별자 없이 **수량으로** 담긴 자식(「이 품번 40개」) — 입고·포장이 이 모양으로 온다. */
             childQuantityList: '$.childQuantityList',
-            errorDeclaration: {
-                declarationTime: '$.errorDeclaration.declarationTime',
-                reason: '$.errorDeclaration.reason',
-                correctiveEventIDs: '$.errorDeclaration.correctiveEventIDs'
-            },
-            readPoint: '$.readPoint',
-            bizLocation: '$.bizLocation'
         }
     }
 ];
+/*
+ * 규칙을 시험이 돌릴 수 있게 낸다 — **읽어서 맞다고 하지 않기 위해.**
+ *
+ * 오늘 이 자리가 정확히 그것으로 새고 있었다: 계약을 열고 계약 시험을 초록으로 만든 뒤에도, 이 파일이
+ * 그 스펙을 안 써서 값이 계속 사라졌다. 인티그레이션 레인이 이 규칙 그대로 `mapRecord` 를 돌려 봐서
+ * 찾았다 — 규칙이 파일 안에 갇혀 있으면 그것을 돌려 볼 방법이 없다.
+ *
+ * 복사본을 낸다. 부르는 쪽이 고쳐도 유입 경로가 바뀌지 않아야 한다.
+ */
+function canonicalRulesForTest() {
+    return TWIN_INGEST_RULES.map(r => ({ ...r, mapping: { ...r.mapping } }));
+}
 /*
  * 정규 레코드 셋(`CanonicalRecord` · `CanonicalTransformationRecord` · `CanonicalAggregationRecord`)은
  * **계약으로 옮겼다**(2026-08-30, `@operato/ops-contract` 0.2.0).
@@ -251,9 +292,16 @@ scope) {
              * 맞는 관측 시각이다(「어제 값을 오늘 봤다」는 「어제 일어났다」가 아니다). 값을 말하는
              * 레코드만 자기 시각을 갖는다.
              */
-            ...((r.eventTime ?? r.at) !== undefined
-                ? { eventTime: r.eventTime ?? r.at }
-                : {}),
+            /*
+             * ── 세 번째로 같은 자리를 밟았다 (2026-09-06) ────────────────────────
+             * 여기가 `eventTime ?? at` **두 이름만** 보고 있었다. `nonconformance.disposition` 은
+             * `data.decidedAt` 을 싣고(contract 가 required), 그래서 ingest 시각으로 떨어졌다 —
+             * backfill 로 5일 지난 사실을 받으니 5일 틀린 값이 저장됐다.
+             *
+             * 이름을 하나 더 넣는 것으로는 안 끝난다. type 마다의 칸을 한 표에 두고, 못 읽은 것은
+             * 세어서 낸다(§`event-time.ts`).
+             */
+            ...((0, event_time_js_1.factEventTime)(r) !== undefined ? { eventTime: (0, event_time_js_1.factEventTime)(r) } : {}),
             /* 판정은 커널이 한 곳에서 한다 — 여기서 다시 짐작하면 소비처마다 답이 달라진다. */
             sourceType: (0, ops_contract_1.isTransformationRecord)(r)
                 ? 'twin-transformation'
@@ -297,8 +345,29 @@ scope) {
     const generationResult = energyGeneration.length
         ? (0, ops_contract_1.ingestEnergyGenerationRecords)(energyGeneration, { tenantId, defaultEventTime, ...scope })
         : { accepted: [], rejected: [] };
-    const operationalResult = operational.length
-        ? (0, ops_contract_1.ingestOperationalRecords)(operational, { tenantId, defaultEventTime, ...scope })
+    /*
+     * ── fact type 마다 시각 칸 이름이 다르다 (2026-09-06) ────────────────────────
+     * 운영 레코드의 봉투 시각은 `at` 이다. 그런데 `nonconformance.disposition` 은 자기 시각을
+     * **payload 의 `decidedAt`** 에 싣는다(contract 가 그 자리에 required 로 선언했다). 그래서 `at` 이
+     * 없고 `defaultEventTime`(= ingest 시각)으로 떨어졌다.
+     *
+     * ```
+     * [측정함 2026-09-06, mes-line-a backfill 뒤]
+     * event_time  2026-09-05 23:50:51    data.decidedAt  2026-09-01T02:50:51.832Z    5일 차이
+     * ```
+     *
+     * push 경로에서는 몇 초 차이라 아무도 못 알아챈다. backfill 이 그 간격을 벌려서 드러냈다 —
+     * backfill 이 만든 결함이 아니라 원래 있던 것이 보인 것이다.
+     *
+     * 여기서 `at` 을 채워 넣는다. 더 깊은 고침은 contract 쪽이지만(선언과 봉투가 다른 이름을 쓰는
+     * 비대칭), 그것은 배포를 기다려야 하고 그동안 값이 계속 틀리게 저장된다.
+     */
+    const operationalDated = operational.map(r => {
+        const at = (0, event_time_js_1.factEventTime)(r);
+        return at !== undefined && r.at === undefined ? { ...r, at } : r;
+    });
+    const operationalResult = operationalDated.length
+        ? (0, ops_contract_1.ingestOperationalRecords)(operationalDated, { tenantId, defaultEventTime, ...scope })
         : { accepted: [], rejected: [] };
     /* 거부분을 합쳐 돌려준다 — 어느 어휘에서 거부됐는지는 이유 문구가 말한다. */
     return {
@@ -328,7 +397,15 @@ scope) {
             ...master.rejected
         ],
         /* 사건이 아닌 것은 따로 낸다 — 부르는 쪽이 상태 세우는 문으로 보낸다(저널로 가지 않게). */
-        masterData: master.accepted
+        masterData: master.accepted,
+        /*
+         * **시각을 못 읽어 ingest 시각으로 떨어진 것** — type 별 수.
+         *
+         * 오류가 아니다. 절대값 snapshot 은 polling 순간이 맞는 시각이라 여기 세어지는 것이 정상이다.
+         * 다만 그 수가 어디에도 안 남으면 `event_time == created_at` 이 유일한 단서가 되고, 그것은
+         * 우연히 같은 것과 구별되지 않는다.
+         */
+        undated: (0, event_time_js_1.undatedByKind)([...epcis, ...operational])
     };
 }
 //# sourceMappingURL=canonical-ingest.js.map

package/dist-server/engine/canonical-ingest.js.map

@@ -1 +1 @@
-{"version":3,"file":"canonical-ingest.js","sourceRoot":"","sources":["../../server/engine/canonical-ingest.ts"],"names":[],"mappings":"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","sourcesContent":["import { type CanonicalRecord, type CanonicalAggregationRecord, type CanonicalTransformationRecord, type AdapterRule, type EnergyRecord, type EnergyEquipmentRecord, type EnergyGenerationRecord, type EnergyUsagePeriodRecord, type EnergyBillRecord, type EnergyTariffBasisRecord, type EnergyGenerationPriceRecord, type EnergyGenerationPeriodRecord, type OperationalRecord, type IngestResult, type MasterDataRecord } from '@operato/ops-contract'\nimport { ingest, ingestEnergyRecords, ingestEnergyEquipmentRecords, ingestEnergyGenerationRecords, ingestEnergyUsagePeriodRecords, ingestEnergyBillRecords, ingestEnergyTariffBasisRecords, ingestEnergyGenerationPriceRecords, ingestEnergyGenerationPeriodRecords, ingestOperationalRecords, isAggregationRecord, isTransformationRecord, isEnergyRecord, isEnergyEquipmentRecord, isEnergyGenerationRecord, isEnergyUsagePeriodRecord, isEnergyBillRecord, isEnergyTariffBasisRecord, isEnergyGenerationPriceRecord, isEnergyGenerationPeriodRecord, isOperationalRecord, isMasterDataRecord, ingestMasterData } from '@operato/ops-contract'\n\n/*\n * 정규 레코드 → 커널 검증 ACL → CanonicalEnvelope (P1 seam 코어).\n * 순수(커널만 의존; shell·integration-base 무의존 → node:test 검증 가능).\n * 매핑(레거시 스키마 → 정규)은 이 앞 단계(jsonata step 또는 커넥터 openLiveFeed)가 끝낸다.\n * 여기 도착하는 레코드는 이미 정규 필드다 — 어휘마다 자기 필드 이름이 계약이다:\n *   EPCIS 품목 { epc, action, bizStep, disposition?, readPoint?, bizLocation? }\n *   에너지 계량 { meterId, kW?, kWh?, … } · 설비 에너지 { equipmentId, generatedKW?, soc?, … }\n *   발전 적산   { equipmentId, kWh, kWhSince?, … }\n *   사용 구간   { meterId, from, to, kWh, unitPrice?, basis?, … }  · 청구서 { from, to, total?, … }\n *   요금 기준   { from, to, billingDemandKW?, demandChargePerKW?, currency }\n *   담김(적재) { parentID, childEPCs[] | childQuantityList[], action, bizStep, … }\n *   운영 사실 { taskId | moverId | personId | assetId | orderId, status, … }  // vocabulary-guard: allow 저널 와이어 필드\n * 커널은 objectEvent 구성 + EPCIS 검증(위반=오염 차단) + 봉투 래핑만(방언 없음).\n *\n * 두 소비처가 이 단일 코어를 공유(중복 금지):\n *   - sim/scenario 경로: operato-twin twin-ingest 태스크(http-get→jsonata→여기).\n *   - live 커넥터 경로: reference-live(어댑터 openLiveFeed→여기).\n * SoT: design/integration/face2-adapters.md §5(seam)·§7(매핑=밖, 검증=커널).\n */\n\n/** 고정 정규 매핑(방언 아님 — 필드명 자체가 정규 계약). `sourceType` 으로 어느 품목 사실인지 고른다. */\nconst TWIN_INGEST_RULES: AdapterRule[] = [\n  {\n    sourceType: 'twin',\n    mapping: {\n      type: 'ObjectEvent',\n      action: '$.action',\n      bizStep: '$.bizStep',\n      disposition: '$.disposition',\n      epc: '$.epc',\n      /* 비직렬 수량 — 개체 없이 「이 자리에 이 품목이 얼마 남았다」만 오는 관측이 있다. */\n      quantityList: '$.quantityList',\n      /*\n       * **개체·로트의 마스터데이터**(로트 번호·소비기한 등) — 커널 0.7.58 에서 이 자리가 열렸다.\n       *\n       * 실측(포천): 원본 재고 1,704행 **전부**에 소비기한이 있는데 투영된 상태에는 **0건**이었다. 지난\n       * 재고 950건·59,785kg 이 어디에도 나타나지 않았고, 빈 화면이 「이상 없음」으로 읽혔다.\n       *\n       * ★ **표준이 `action: 'ADD'` 일 때만 허용한다**(또는 변환). 마스터데이터는 로트가 **생길 때**\n       * 말하는 사실이고, 주기 관측마다 실으면 커널이 거부한다 — 알리지 않고 통과시키지 않는 것이 옳다\n       * (커넥터가 첫 목격에 `ADD`, 그 뒤로 `OBSERVE` 를 내야 한다).\n       */\n      ilmd: '$.ilmd',\n      /*\n       * **정정 선언** — 「이 사건은 없던 일이 되었다」(커널 0.7.65 에서 이 자리가 열렸다).\n       *\n       * 세 값이 함께여야 뜻이 있어 묶음으로 온다. 커널이 선언 시각을 요구하고, 없으면 사건 시각으로\n       * 메우지 않고 이유와 함께 돌려준다 — 「언제 정정했나」와 「언제 일어났나」가 같아지면 둘을 다시\n       * 갈라낼 수 없다.\n       *\n       * 상태는 이것으로 흔들리지 않는다. 커널은 정정을 목록에 적고 재고를 그대로 둔다 — 무엇을 어떻게\n       * 되돌릴지는 도메인 판단이고, 참 재고는 그 뒤의 잔량 관측이 다시 말해 준다.\n       */\n      errorDeclaration: {\n        declarationTime: '$.errorDeclaration.declarationTime',\n        reason: '$.errorDeclaration.reason',\n        correctiveEventIDs: '$.errorDeclaration.correctiveEventIDs'\n      },\n      readPoint: '$.readPoint',\n      bizLocation: '$.bizLocation'\n    }\n  },\n  {\n    /* **변환의 사실** — 무엇으로 무엇이 되었나. 이름은 표준의 것을 그대로 쓴다(갈래 판정이 그 이름을 본다). */\n    sourceType: 'twin-transformation',\n    mapping: {\n      type: 'TransformationEvent',\n      bizStep: '$.bizStep',\n      disposition: '$.disposition',\n      inputEPCList: '$.inputEPCList',\n      inputQuantityList: '$.inputQuantityList',\n      outputEPCList: '$.outputEPCList',\n      outputQuantityList: '$.outputQuantityList',\n      transformationID: '$.transformationID',\n      errorDeclaration: {\n        declarationTime: '$.errorDeclaration.declarationTime',\n        reason: '$.errorDeclaration.reason',\n        correctiveEventIDs: '$.errorDeclaration.correctiveEventIDs'\n      },\n      readPoint: '$.readPoint',\n      bizLocation: '$.bizLocation'\n    }\n  },\n  {\n    /*\n     * **담김의 사실** — 무엇이 무엇에 실렸나(팔레트·상자). 오래 비어 있던 자리다: 관측 리듀서는 이 사실을\n     * 받으면 자식 물품에 `parent` 를 붙이는데, 문이 `ObjectEvent` 하나만 알아서 원본은 적재를 말할 길이\n     * 없었다(시뮬 원본을 붙여 돌려 보고서야 로그로 드러났다).\n     */\n    sourceType: 'twin-aggregation',\n    mapping: {\n      type: 'AggregationEvent',\n      action: '$.action',\n      bizStep: '$.bizStep',\n      disposition: '$.disposition',\n      parentID: '$.parentID',\n      childEPCs: '$.childEPCs',\n      /* 낱개 식별자 없이 **수량으로** 담긴 자식(「이 품번 40개」) — 입고·포장이 이 모양으로 온다. */\n      childQuantityList: '$.childQuantityList',\n      errorDeclaration: {\n        declarationTime: '$.errorDeclaration.declarationTime',\n        reason: '$.errorDeclaration.reason',\n        correctiveEventIDs: '$.errorDeclaration.correctiveEventIDs'\n      },\n      readPoint: '$.readPoint',\n      bizLocation: '$.bizLocation'\n    }\n  }\n]\n\n/*\n * 정규 레코드 셋(`CanonicalRecord` · `CanonicalTransformationRecord` · `CanonicalAggregationRecord`)은\n * **계약으로 옮겼다**(2026-08-30, `@operato/ops-contract` 0.2.0).\n *\n * 여기 있던 이유는 소비 방식 때문이었다 — EPCIS 는 커널의 범용 어댑터를 지나서 타입을 요구하지 않았다.\n * 그런데 모양 자체는 EPCIS 2.0 의 필드 이름이고 호스트의 것이 아니다. 이제 MES 가 이 모양 그대로\n * 보낸다.\n *\n * **매핑 룰(`TWIN_INGEST_RULES`)은 여기 남는다** — 이 모양을 EPCIS 사건으로 옮기는 정책이지 모양이 아니다.\n */\n\n/** 정규 레코드[] → 검증된 CanonicalEnvelope[] (+ 거부분). 순수 함수. 단일→객체도 배열로 정규화. */\nexport function ingestCanonicalRecords(\n  records:\n    | CanonicalRecord\n    | CanonicalAggregationRecord\n    | CanonicalTransformationRecord\n    | EnergyRecord\n    | EnergyEquipmentRecord\n    | OperationalRecord\n    /* 다섯째 어휘 — 사건이 아닌 것(변하지 않는 속성). 저널로 가지 않는다(§`CanonicalIngestResult`). */\n    | MasterDataRecord\n    | (\n        | CanonicalRecord\n        | CanonicalAggregationRecord\n        | CanonicalTransformationRecord\n        | EnergyRecord\n        | EnergyEquipmentRecord\n        | OperationalRecord\n        | MasterDataRecord\n      )[]\n    | undefined\n    | null,\n  tenantId: string,\n  defaultEventTime: string,\n  /**\n   * **이 사실들이 어느 트윈의 것인가** — 마감된 구간 사실의 이름에 쓰인다(커널 §`SubjectBasis`).\n   *\n   * 커널은 도메인으로 서므로 자기가 어느 트윈인지 모른다. 그런데 설비 번호·계량 지점 번호는 트윈\n   * 안에서만 통하는 이름표라, 한 도메인에 현장이 둘이면 서로 다른 설비의 같은 날이 한 사실이 된다.\n   * 실측으로 그 일이 났다 — 두 발전소의 `002` 가 겹쳤다.\n   *\n   * 주지 않으면 이름표를 그대로 쓰고 `twin-local` 로 표시된다 — 겹칠 수 있다는 뜻이다.\n   */\n  scope?: { scopeId?: string; identityOf?: (kind: 'equipment' | 'meter', localId: string) => string | undefined }\n): CanonicalIngestResult {\n  const arr = Array.isArray(records) ? records : records ? [records] : []\n  /*\n   * ── **다섯째 어휘는 사건이 아니다** (2026-08-28) ────────────────────────────\n   *\n   * 마스터데이터 — 변하지 않는 속성(유통기한·로트번호·자리의 성질). 표준은 이것을 사건이 아니라\n   * **어휘 요소의 속성**으로 담고, 커널에 그 자리가 없어서 지금까지 사건에 실려 왔다.\n   *\n   * 그 결과가 유입에서 이렇게 났다. 전량을 읽는 원본이 유통기한을 실으려고 **들어오지 않은 것을\n   * `ADD`** 라고 말했고, `ilmd` 가 사건 단위라 자리별로 묶을 수도 없어 낱개로 나갔다 — 재기동 한 번에\n   * 2,665건이다.\n   *\n   * 그래서 여기서 갈라 낸다. 이것은 봉투가 되지 않고 저널에도 적히지 않는다(시각축이 없는 값이다).\n   * 갈래 판정은 커널의 것을 부른다 — 다른 넷과 같은 규율이다.\n   *\n   * 설계: `operato-twin/design/plans/master-data.md`\n   */\n  const masterCandidates = arr.filter(isMasterDataRecord)\n  const master = masterCandidates.length ? ingestMasterData(masterCandidates) : { accepted: [], rejected: [] }\n  /*\n   * **어휘가 넷이다** — 물류(EPCIS)·에너지 계량·설비 에너지·운영 사실. 예전에는 이 함수가 무조건\n   * `ObjectEvent` 를 만들었고, 그래서 계측을 이 길로 넣으면 `epc` 가 없어 거부되거나(그나마 나은 쪽)\n   * 엉뚱한 물품 관측이 됐다.\n   *\n   * 물류 어휘 안에는 모양이 둘이다(개체 관측 `epc` / 담김 `parentID`+`childEPCs`).\n   *\n   * 판정은 커널이 한 곳에서 한다(`isEnergyRecord`·`isOperationalRecord`·`isAggregationRecord`) — 여기서 다시 짐작하면\n   * 소비처마다 답이 달라진다. 봉투는 같은 것을 쓰므로 아래 소비처(미러·저널·브로드캐스팅)는 이 갈림을 알\n   * 필요가 없다.\n   */\n  /*\n   * 여섯째·일곱째 어휘 — **마감된 사용 구간**과 **청구서**. 커널 0.7.72 가 이 문들을 열었다.\n   *\n   * ── ★ 사용 구간을 계량보다 **먼저** 가른다 ─────────────────────────────────\n   * `isEnergyRecord` 는 `meterId` 가 있으면 참이므로 사용 구간에도 참이다. 순서를 정하지 않으면\n   * 시간별 사용량이 계량 표본으로 들어가고, 그 문은 `kWh` 를 **적산 레지스터**로 읽는다. 그러면\n   * 커널이 구간 전력량을 차분으로 구하는데 우리가 넣은 값이 이미 구간의 양이다 — 차분의 차분이 되어\n   * 값이 조용히 틀린다. 거부되지도 않는다.\n   */\n  const usagePeriods = arr.filter(isEnergyUsagePeriodRecord) as unknown as EnergyUsagePeriodRecord[]\n  const bills = arr.filter(isEnergyBillRecord) as unknown as EnergyBillRecord[]\n  /*\n   * 여덟째 어휘 — **그 주기에 적용되는 요금 기준**. 커널 0.7.76 이 이 문을 열었다.\n   *\n   * ★ 청구서와 겹친다. 청구서가 `billingDemandKW` 를 실을 수 있고, 그러면 두 판정이 다 참이다.\n   * 그때 요금 기준 문으로 보내면 「금액은 이 문이 받지 않는다」로 거부된다 — 정산이 통째로\n   * 사라진다. 그래서 청구서인 것을 뺀다. 커널에서 배타로 만들어 달라고 올렸다.\n   */\n  const tariffBases = arr.filter(r => isEnergyTariffBasisRecord(r) && !isEnergyBillRecord(r)) as unknown as EnergyTariffBasisRecord[]\n  /*\n   * 아홉째 어휘 — **발전 단가**. 낸 것에 매겨지는 1kWh 당 값이고 날마다 바뀐다(커널 0.7.79).\n   *\n   * 다른 문과 겹치지 않는다: 계량 지점이나 설비 id 가 있으면 이 문이 아니고(커널이 배타로 막는다),\n   * 요금적용전력·기본요금 단가가 없으므로 요금 기준도 아니다.\n   */\n  const generationPrices = arr.filter(isEnergyGenerationPriceRecord) as unknown as EnergyGenerationPriceRecord[]\n  /* 마감된 발전 기간 — 지난 기록 채우기가 쓴다. 적산의 문과 배타다(구간이 있으면 이쪽). */\n  const generationPeriods = arr.filter(isEnergyGenerationPeriodRecord) as unknown as EnergyGenerationPeriodRecord[]\n  const energy = arr.filter(r => isEnergyRecord(r) && !isEnergyUsagePeriodRecord(r)) as EnergyRecord[]\n  /* 세 번째 어휘 — 설비가 낸 자기 에너지 상태(발전·저장·감축 여지·개폐 위치). 계량과 갈라 두는\n     이유는 커널에 적혀 있다: 계량은 구간에 누적되고, 이것들은 그 설비의 지금이다. */\n  /*\n   * 다섯 번째 어휘 — **발전 적산**(설비가 지금까지 만든 양). 커널 0.7.69 가 이 문을 열었다.\n   *\n   * ── ★ 설비 상태보다 **먼저** 가른다 ──────────────────────────────────────────\n   * 두 판정이 겹친다. `isEnergyEquipmentRecord` 는 `equipmentId` 가 있고 물류·계량 어휘가 아니면\n   * 참이므로 발전 적산도 함께 참이다. 그래서 순서가 갈림을 정한다.\n   *\n   * 순서를 잘못 두면 조용히 사라지는 것이 아니라 **엉뚱한 이유로 거부된다**: 설비 상태 문은 적산을\n   * 값으로 세지 않아 「바꿀 상태가 하나도 없다」로 돌려보낸다. 커넥터는 보냈다고 믿고, 화면에는\n   * 발전량이 없다.\n   */\n  const energyGeneration = arr.filter(isEnergyGenerationRecord) as unknown as EnergyGenerationRecord[]\n  const energyEquipment = arr.filter(r => isEnergyEquipmentRecord(r) && !isEnergyGenerationRecord(r)) as unknown as EnergyEquipmentRecord[]\n  /*\n   * 네 번째 어휘 — **운영 사실**(작업·설비·사람·자산·오더·품질). 관측 리듀서는 이것을 오래전부터\n   * 계산했는데 **들어올 문이 없었다**: 원본이 「이 작업이 끝났다」를 말할 길이 없어 시뮬 커널만 그것을\n   * 아는 상태가 남았다(같은 화면이 두 구동에서 다른 것을 말한다).\n   */\n  const operational = arr.filter(isOperationalRecord) as OperationalRecord[]\n  /*\n   * ── 이 목록은 **어휘를 더할 때마다 함께 늘어야 한다** (2026-08-30) ─────────\n   *\n   * EPCIS 갈래는 「나머지 전부」다. 새 어휘를 빼 주지 않으면 그 레코드가 제 문으로 가면서\n   * **EPCIS 문으로도 들어가** 거부된다. 받아들여지기도 하고 거부되기도 하는 상태가 되어,\n   * 유입 장부의 거부 수가 늘고 사람이 그것을 진짜 결함으로 읽는다.\n   *\n   * 실제로 발전 단가를 더할 때 그렇게 됐다. 목록을 손으로 지키는 대신 시험이 지킨다\n   * (§`canonical-ingest-vocabularies` — 어휘마다 한 문으로만 가는지).\n   */\n  const epcis = arr.filter(\n    r =>\n      !isEnergyRecord(r) &&\n      !isEnergyEquipmentRecord(r) &&\n      !isEnergyGenerationRecord(r) &&\n      !isEnergyUsagePeriodRecord(r) &&\n      !isEnergyBillRecord(r) &&\n      !isEnergyTariffBasisRecord(r) &&\n      !isEnergyGenerationPriceRecord(r) &&\n      !isEnergyGenerationPeriodRecord(r) &&\n      !isOperationalRecord(r) &&\n      !isMasterDataRecord(r)\n  ) as (CanonicalRecord | CanonicalAggregationRecord | CanonicalTransformationRecord)[]\n\n  /* 품목 어휘 안에서도 갈림이 있다(개체 관측 / 담김) — 그 판정도 커널의 것을 부른다. */\n  const epcisResult = epcis.length\n    ? ingest(\n        epcis.map(r => ({\n          ...r,\n          /*\n           * ── **시각의 이름을 둘 흡수한다** (2026-08-24 실측) ────────────────────\n           * `eventTimePath` 는 **한 이름**만 받는다. 호스트가 `'eventTime'` 으로 못박아 두었는데, 뒤에\n           * 생긴 커넥터는 `at` 을 싣는다(에너지 채널이 이미 `at` 을 쓰고 있어 그 어휘를 따랐다).\n           * 그래서 그 커넥터의 사건은 **전부 폴링 순간**으로 찍혔다 — 저널 18,150건이 그랬다.\n           *\n           * 그 결과 둘이 함께 망가졌다: 재고 관측이 트윈의 시계를 밀지 못해 시계가 `task.status` 의\n           * 최댓값(2026-04-15)에 **멈춰 있었고**, 이동 사건에서 「언제」가 사라져 순서만 남았다.\n           *\n           * 이름을 하나로 강요하지 않고 흡수한다 — `orderId`·`resourceRef`·`equipmentId` 를 함께 보는\n           * 것과 같은 규율이다(§`twin-event-keys`). 세대가 섞이는 것은 이 이음새의 성질이다.\n           *\n           * **없으면 만들지 않는다**: 절대값 스냅샷 관측은 원본의 갱신 시각이 아니라 **폴링 순간**이\n           * 맞는 관측 시각이다(「어제 값을 오늘 봤다」는 「어제 일어났다」가 아니다). 값을 말하는\n           * 레코드만 자기 시각을 갖는다.\n           */\n          ...(((r as any).eventTime ?? (r as any).at) !== undefined\n            ? { eventTime: (r as any).eventTime ?? (r as any).at }\n            : {}),\n          /* 판정은 커널이 한 곳에서 한다 — 여기서 다시 짐작하면 소비처마다 답이 달라진다. */\n          sourceType: isTransformationRecord(r)\n            ? 'twin-transformation'\n            : isAggregationRecord(r)\n              ? 'twin-aggregation'\n              : 'twin'\n        })),\n        TWIN_INGEST_RULES,\n        /*\n         * **레코드가 시각을 말하면 그것을 쓴다** (2026-08-23).\n         *\n         * `eventTimePath` 를 주지 않던 동안 이 경로는 **언제나 폴링 시각**을 썼다(`defaultEventTime`).\n         * 그래서 커넥터가 이미 싣고 있던 `eventTime`(변환 레코드의 `finishedAt` 등)이 **알리지 않고\n         * 무시됐다** — 커넥터를 붙인 쪽은 그것이 먹는다고 믿고 있었고, 어디에도 오류가 나지 않았다.\n         *\n         * 무엇이 걸렸나: 계보(변환)의 시각이다. 4월에 만든 로트가 8월에 만들어진 것으로 저널에 남았다.\n         * 그리고 실측 소요를 재는 폴드가 봉투 시각을 쓰므로(§`kpi-fold`: `workMs = 완료 − 첫 착수`),\n         * 폴링 간격을 작업시간으로 배울 수 있었다 — 못 배우는 것보다 나쁘다.\n         *\n         * 레코드에 `eventTime` 이 없으면 커널이 알리지 않고 기본값으로 떨어진다(§`resolve` — 없는 값은\n         * 오류가 아니다). 그래서 이 한 줄이 기존 경로를 막지 않는다: 시각을 말하는 레코드만 사실이 된다.\n         */\n        { tenantId, defaultEventTime, eventTimePath: 'eventTime' }\n      )\n    : { accepted: [], rejected: [] }\n  const energyResult = energy.length ? ingestEnergyRecords(energy, { tenantId, defaultEventTime, ...scope }) : { accepted: [], rejected: [] }\n  const equipmentResult = energyEquipment.length\n    ? ingestEnergyEquipmentRecords(energyEquipment, { tenantId, defaultEventTime, ...scope })\n    : { accepted: [], rejected: [] }\n  const usageResult = usagePeriods.length\n    ? ingestEnergyUsagePeriodRecords(usagePeriods, { tenantId, defaultEventTime, ...scope })\n    : { accepted: [], rejected: [] }\n  const billResult = bills.length ? ingestEnergyBillRecords(bills, { tenantId, defaultEventTime, ...scope }) : { accepted: [], rejected: [] }\n  const tariffBasisResult = tariffBases.length\n    ? ingestEnergyTariffBasisRecords(tariffBases, { tenantId, defaultEventTime, ...scope })\n    : { accepted: [], rejected: [] }\n  const generationPeriodResult = generationPeriods.length\n    ? ingestEnergyGenerationPeriodRecords(generationPeriods, { tenantId, defaultEventTime, ...scope })\n    : { accepted: [], rejected: [] }\n  const generationPriceResult = generationPrices.length\n    ? ingestEnergyGenerationPriceRecords(generationPrices, { tenantId, defaultEventTime, ...scope })\n    : { accepted: [], rejected: [] }\n  const generationResult = energyGeneration.length\n    ? ingestEnergyGenerationRecords(energyGeneration, { tenantId, defaultEventTime, ...scope })\n    : { accepted: [], rejected: [] }\n  const operationalResult = operational.length\n    ? ingestOperationalRecords(operational, { tenantId, defaultEventTime, ...scope })\n    : { accepted: [], rejected: [] }\n\n  /* 거부분을 합쳐 돌려준다 — 어느 어휘에서 거부됐는지는 이유 문구가 말한다. */\n  return {\n    accepted: [\n      ...epcisResult.accepted,\n      ...energyResult.accepted,\n      ...equipmentResult.accepted,\n      ...generationResult.accepted,\n      ...usageResult.accepted,\n      ...generationPriceResult.accepted,\n      ...generationPeriodResult.accepted,\n      ...billResult.accepted,\n      ...tariffBasisResult.accepted,\n      ...operationalResult.accepted\n    ],\n    rejected: [\n      ...epcisResult.rejected,\n      ...energyResult.rejected,\n      ...equipmentResult.rejected,\n      ...generationResult.rejected,\n      ...usageResult.rejected,\n      ...billResult.rejected,\n      ...tariffBasisResult.rejected,\n      ...generationPriceResult.rejected,\n      ...generationPeriodResult.rejected,\n      ...operationalResult.rejected,\n      ...master.rejected\n    ],\n    /* 사건이 아닌 것은 따로 낸다 — 부르는 쪽이 상태 세우는 문으로 보낸다(저널로 가지 않게). */\n    masterData: master.accepted\n  }\n}\n\n/**\n * 유입 결과 — 사건(봉투)과 **사건이 아닌 것**을 갈라 낸다.\n *\n * 마스터데이터를 `accepted` 에 섞지 않는 이유: 부르는 쪽이 그것을 저널에 적게 되고, 시각축이 없는 값이\n * 「그때 일어난 일」로 남는다. 갈래를 타입으로 갈라 두면 그 실수를 할 수 없다.\n */\nexport interface CanonicalIngestResult extends IngestResult {\n  masterData: MasterDataRecord[]\n}\n"]}
+{"version":3,"file":"canonical-ingest.js","sourceRoot":"","sources":["../../server/engine/canonical-ingest.ts"],"names":[],"mappings":"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","sourcesContent":["import { type CanonicalRecord, type CanonicalAggregationRecord, type CanonicalTransformationRecord, type AdapterRule, type EnergyRecord, type EnergyEquipmentRecord, type EnergyGenerationRecord, type EnergyUsagePeriodRecord, type EnergyBillRecord, type EnergyTariffBasisRecord, type EnergyGenerationPriceRecord, type EnergyGenerationPeriodRecord, type OperationalRecord, type IngestResult, type MasterDataRecord } from '@operato/ops-contract'\nimport { ingest, ingestEnergyRecords, ingestEnergyEquipmentRecords, ingestEnergyGenerationRecords, ingestEnergyUsagePeriodRecords, ingestEnergyBillRecords, ingestEnergyTariffBasisRecords, ingestEnergyGenerationPriceRecords, ingestEnergyGenerationPeriodRecords, ingestOperationalRecords, isAggregationRecord, isTransformationRecord, isEnergyRecord, isEnergyEquipmentRecord, isEnergyGenerationRecord, isEnergyUsagePeriodRecord, isEnergyBillRecord, isEnergyTariffBasisRecord, isEnergyGenerationPriceRecord, isEnergyGenerationPeriodRecord, isOperationalRecord, isMasterDataRecord, ingestMasterData } from '@operato/ops-contract'\nimport { factEventTime, undatedByKind } from './event-time.js'\n\n/*\n * 정규 레코드 → 커널 검증 ACL → CanonicalEnvelope (P1 seam 코어).\n * 순수(커널만 의존; shell·integration-base 무의존 → node:test 검증 가능).\n * 매핑(레거시 스키마 → 정규)은 이 앞 단계(jsonata step 또는 커넥터 openLiveFeed)가 끝낸다.\n * 여기 도착하는 레코드는 이미 정규 필드다 — 어휘마다 자기 필드 이름이 계약이다:\n *   EPCIS 품목 { epc, action, bizStep, disposition?, readPoint?, bizLocation? }\n *   에너지 계량 { meterId, kW?, kWh?, … } · 설비 에너지 { equipmentId, generatedKW?, soc?, … }\n *   발전 적산   { equipmentId, kWh, kWhSince?, … }\n *   사용 구간   { meterId, from, to, kWh, unitPrice?, basis?, … }  · 청구서 { from, to, total?, … }\n *   요금 기준   { from, to, billingDemandKW?, demandChargePerKW?, currency }\n *   담김(적재) { parentID, childEPCs[] | childQuantityList[], action, bizStep, … }\n *   운영 사실 { taskId | moverId | personId | assetId | orderId, status, … }  // vocabulary-guard: allow 저널 와이어 필드\n * 커널은 objectEvent 구성 + EPCIS 검증(위반=오염 차단) + 봉투 래핑만(방언 없음).\n *\n * 두 소비처가 이 단일 코어를 공유(중복 금지):\n *   - sim/scenario 경로: operato-twin twin-ingest 태스크(http-get→jsonata→여기).\n *   - live 커넥터 경로: reference-live(어댑터 openLiveFeed→여기).\n * SoT: design/integration/face2-adapters.md §5(seam)·§7(매핑=밖, 검증=커널).\n */\n\n/*\n * **표준 헤더 필드는 한 번만 적는다** — 세 규칙이 이것을 펼쳐 쓴다.\n *\n * ── 왜 뽑아냈나 (2026-09-07) ────────────────────────────────────────────────\n * 이 파일은 규칙 셋을 손으로 나란히 적고 있었고, 그래서 헤더 필드를 더할 때마다 **세 곳을 다 고쳐야**\n * 했다. 그 구조가 같은 결함을 네 번 만들었다.\n *\n * ```\n * quantityList        낱개 번호 없는 자재의 잔량을 말할 길이 없었다\n * ilmd                포천 재고 1,704행 전부에 소비기한이 있는데 상태에는 0건\n * errorDeclaration    정정이 또 하나의 사실로 쌓였다\n * bizTransactionList  저널에 칸·인덱스·질의가 다 있는데 실 시스템 연결에서 0건\n * ```\n *\n * 네 번째는 계약을 열고도 **이 파일이 그 스펙을 안 써서** 여전히 사라지고 있었다. 인티그레이션 레인이\n * 규칙 그대로 `mapRecord` 를 돌려서 찾았다 — 읽어서 맞다고 하지 않고 돌려 본 것이 잡았다.\n *\n * 이제 헤더 필드를 더하는 것은 **이 상수 한 줄**이고, 세 갈래에 동시에 닿는다.\n *\n * `action` 은 여기 없다 — `TransformationEvent` 에는 그 칸이 없다(무엇이 무엇으로 되었나에는 방향이\n * 하나뿐이다). 그것만 규칙마다 적는다.\n */\nconst TWIN_INGEST_HEADER = {\n  bizStep: '$.bizStep',\n  disposition: '$.disposition',\n  /*\n   * **정정 선언** — 「이 사건은 없던 일이 되었다」(커널 0.7.65 에서 이 자리가 열렸다).\n   *\n   * 세 값이 함께여야 뜻이 있어 묶음으로 온다. 커널이 선언 시각을 요구하고, 없으면 사건 시각으로\n   * 메우지 않고 이유와 함께 돌려준다 — 「언제 정정했나」와 「언제 일어났나」가 같아지면 둘을 다시\n   * 갈라낼 수 없다.\n   *\n   * 상태는 이것으로 흔들리지 않는다. 커널은 정정을 목록에 적고 재고를 그대로 둔다 — 무엇을 어떻게\n   * 되돌릴지는 도메인 판단이고, 참 재고는 그 뒤의 잔량 관측이 다시 말해 준다.\n   */\n  errorDeclaration: {\n    declarationTime: '$.errorDeclaration.declarationTime',\n    reason: '$.errorDeclaration.reason',\n    correctiveEventIDs: '$.errorDeclaration.correctiveEventIDs'\n  },\n  /*\n   * **오더 참조** — 「이 물건은 어느 오더 것인가」(표준 §7.3.5.4, 계약 0.9.11 에서 이 자리가 열렸다).\n   *\n   * 받는 쪽은 처음부터 다 서 있었다: 저널에 `biz_transaction` 칸과 인덱스(`ix_twin_event_9`), 이력추적\n   * 질의가 그 칸으로 거르고, 커널이 네 자리에서 그것을 채운다. 그래서 커널 안쪽에서 나는 사실만 그\n   * 칸을 갖고 실 시스템이 먹이는 트윈은 조용히 비었다 — 시뮬 2,492건 대 `mes-line-a` 0건.\n   */\n  bizTransactionList: '$.bizTransactionList',\n  readPoint: '$.readPoint',\n  bizLocation: '$.bizLocation'\n} as const\n\n/** 고정 정규 매핑(방언 아님 — 필드명 자체가 정규 계약). `sourceType` 으로 어느 품목 사실인지 고른다. */\nconst TWIN_INGEST_RULES: AdapterRule[] = [\n  {\n    sourceType: 'twin',\n    mapping: {\n      type: 'ObjectEvent',\n      ...TWIN_INGEST_HEADER,\n      action: '$.action',\n      epc: '$.epc',\n      /* 비직렬 수량 — 개체 없이 「이 자리에 이 품목이 얼마 남았다」만 오는 관측이 있다. */\n      quantityList: '$.quantityList',\n      /*\n       * **개체·로트의 마스터데이터**(로트 번호·소비기한 등) — 커널 0.7.58 에서 이 자리가 열렸다.\n       *\n       * 실측(포천): 원본 재고 1,704행 **전부**에 소비기한이 있는데 투영된 상태에는 **0건**이었다. 지난\n       * 재고 950건·59,785kg 이 어디에도 나타나지 않았고, 빈 화면이 「이상 없음」으로 읽혔다.\n       *\n       * ★ **표준이 `action: 'ADD'` 일 때만 허용한다**(또는 변환). 마스터데이터는 로트가 **생길 때**\n       * 말하는 사실이고, 주기 관측마다 실으면 커널이 거부한다 — 알리지 않고 통과시키지 않는 것이 옳다\n       * (커넥터가 첫 목격에 `ADD`, 그 뒤로 `OBSERVE` 를 내야 한다).\n       */\n      ilmd: '$.ilmd',\n      /*\n       * **정정 선언** — 「이 사건은 없던 일이 되었다」(커널 0.7.65 에서 이 자리가 열렸다).\n       *\n       * 세 값이 함께여야 뜻이 있어 묶음으로 온다. 커널이 선언 시각을 요구하고, 없으면 사건 시각으로\n       * 메우지 않고 이유와 함께 돌려준다 — 「언제 정정했나」와 「언제 일어났나」가 같아지면 둘을 다시\n       * 갈라낼 수 없다.\n       *\n       * 상태는 이것으로 흔들리지 않는다. 커널은 정정을 목록에 적고 재고를 그대로 둔다 — 무엇을 어떻게\n       * 되돌릴지는 도메인 판단이고, 참 재고는 그 뒤의 잔량 관측이 다시 말해 준다.\n       */\n    }\n  },\n  {\n    /* **변환의 사실** — 무엇으로 무엇이 되었나. 이름은 표준의 것을 그대로 쓴다(갈래 판정이 그 이름을 본다). */\n    sourceType: 'twin-transformation',\n    mapping: {\n      type: 'TransformationEvent',\n      ...TWIN_INGEST_HEADER,\n      inputEPCList: '$.inputEPCList',\n      inputQuantityList: '$.inputQuantityList',\n      outputEPCList: '$.outputEPCList',\n      outputQuantityList: '$.outputQuantityList',\n      transformationID: '$.transformationID',\n    }\n  },\n  {\n    /*\n     * **담김의 사실** — 무엇이 무엇에 실렸나(팔레트·상자). 오래 비어 있던 자리다: 관측 리듀서는 이 사실을\n     * 받으면 자식 물품에 `parent` 를 붙이는데, 문이 `ObjectEvent` 하나만 알아서 원본은 적재를 말할 길이\n     * 없었다(시뮬 원본을 붙여 돌려 보고서야 로그로 드러났다).\n     */\n    sourceType: 'twin-aggregation',\n    mapping: {\n      type: 'AggregationEvent',\n      ...TWIN_INGEST_HEADER,\n      action: '$.action',\n      parentID: '$.parentID',\n      childEPCs: '$.childEPCs',\n      /* 낱개 식별자 없이 **수량으로** 담긴 자식(「이 품번 40개」) — 입고·포장이 이 모양으로 온다. */\n      childQuantityList: '$.childQuantityList',\n    }\n  }\n]\n\n/*\n * 규칙을 시험이 돌릴 수 있게 낸다 — **읽어서 맞다고 하지 않기 위해.**\n *\n * 오늘 이 자리가 정확히 그것으로 새고 있었다: 계약을 열고 계약 시험을 초록으로 만든 뒤에도, 이 파일이\n * 그 스펙을 안 써서 값이 계속 사라졌다. 인티그레이션 레인이 이 규칙 그대로 `mapRecord` 를 돌려 봐서\n * 찾았다 — 규칙이 파일 안에 갇혀 있으면 그것을 돌려 볼 방법이 없다.\n *\n * 복사본을 낸다. 부르는 쪽이 고쳐도 유입 경로가 바뀌지 않아야 한다.\n */\nexport function canonicalRulesForTest(): AdapterRule[] {\n  return TWIN_INGEST_RULES.map(r => ({ ...r, mapping: { ...r.mapping } }))\n}\n\n/*\n * 정규 레코드 셋(`CanonicalRecord` · `CanonicalTransformationRecord` · `CanonicalAggregationRecord`)은\n * **계약으로 옮겼다**(2026-08-30, `@operato/ops-contract` 0.2.0).\n *\n * 여기 있던 이유는 소비 방식 때문이었다 — EPCIS 는 커널의 범용 어댑터를 지나서 타입을 요구하지 않았다.\n * 그런데 모양 자체는 EPCIS 2.0 의 필드 이름이고 호스트의 것이 아니다. 이제 MES 가 이 모양 그대로\n * 보낸다.\n *\n * **매핑 룰(`TWIN_INGEST_RULES`)은 여기 남는다** — 이 모양을 EPCIS 사건으로 옮기는 정책이지 모양이 아니다.\n */\n\n/** 정규 레코드[] → 검증된 CanonicalEnvelope[] (+ 거부분). 순수 함수. 단일→객체도 배열로 정규화. */\nexport function ingestCanonicalRecords(\n  records:\n    | CanonicalRecord\n    | CanonicalAggregationRecord\n    | CanonicalTransformationRecord\n    | EnergyRecord\n    | EnergyEquipmentRecord\n    | OperationalRecord\n    /* 다섯째 어휘 — 사건이 아닌 것(변하지 않는 속성). 저널로 가지 않는다(§`CanonicalIngestResult`). */\n    | MasterDataRecord\n    | (\n        | CanonicalRecord\n        | CanonicalAggregationRecord\n        | CanonicalTransformationRecord\n        | EnergyRecord\n        | EnergyEquipmentRecord\n        | OperationalRecord\n        | MasterDataRecord\n      )[]\n    | undefined\n    | null,\n  tenantId: string,\n  defaultEventTime: string,\n  /**\n   * **이 사실들이 어느 트윈의 것인가** — 마감된 구간 사실의 이름에 쓰인다(커널 §`SubjectBasis`).\n   *\n   * 커널은 도메인으로 서므로 자기가 어느 트윈인지 모른다. 그런데 설비 번호·계량 지점 번호는 트윈\n   * 안에서만 통하는 이름표라, 한 도메인에 현장이 둘이면 서로 다른 설비의 같은 날이 한 사실이 된다.\n   * 실측으로 그 일이 났다 — 두 발전소의 `002` 가 겹쳤다.\n   *\n   * 주지 않으면 이름표를 그대로 쓰고 `twin-local` 로 표시된다 — 겹칠 수 있다는 뜻이다.\n   */\n  scope?: { scopeId?: string; identityOf?: (kind: 'equipment' | 'meter', localId: string) => string | undefined }\n): CanonicalIngestResult {\n  const arr = Array.isArray(records) ? records : records ? [records] : []\n  /*\n   * ── **다섯째 어휘는 사건이 아니다** (2026-08-28) ────────────────────────────\n   *\n   * 마스터데이터 — 변하지 않는 속성(유통기한·로트번호·자리의 성질). 표준은 이것을 사건이 아니라\n   * **어휘 요소의 속성**으로 담고, 커널에 그 자리가 없어서 지금까지 사건에 실려 왔다.\n   *\n   * 그 결과가 유입에서 이렇게 났다. 전량을 읽는 원본이 유통기한을 실으려고 **들어오지 않은 것을\n   * `ADD`** 라고 말했고, `ilmd` 가 사건 단위라 자리별로 묶을 수도 없어 낱개로 나갔다 — 재기동 한 번에\n   * 2,665건이다.\n   *\n   * 그래서 여기서 갈라 낸다. 이것은 봉투가 되지 않고 저널에도 적히지 않는다(시각축이 없는 값이다).\n   * 갈래 판정은 커널의 것을 부른다 — 다른 넷과 같은 규율이다.\n   *\n   * 설계: `operato-twin/design/plans/master-data.md`\n   */\n  const masterCandidates = arr.filter(isMasterDataRecord)\n  const master = masterCandidates.length ? ingestMasterData(masterCandidates) : { accepted: [], rejected: [] }\n  /*\n   * **어휘가 넷이다** — 물류(EPCIS)·에너지 계량·설비 에너지·운영 사실. 예전에는 이 함수가 무조건\n   * `ObjectEvent` 를 만들었고, 그래서 계측을 이 길로 넣으면 `epc` 가 없어 거부되거나(그나마 나은 쪽)\n   * 엉뚱한 물품 관측이 됐다.\n   *\n   * 물류 어휘 안에는 모양이 둘이다(개체 관측 `epc` / 담김 `parentID`+`childEPCs`).\n   *\n   * 판정은 커널이 한 곳에서 한다(`isEnergyRecord`·`isOperationalRecord`·`isAggregationRecord`) — 여기서 다시 짐작하면\n   * 소비처마다 답이 달라진다. 봉투는 같은 것을 쓰므로 아래 소비처(미러·저널·브로드캐스팅)는 이 갈림을 알\n   * 필요가 없다.\n   */\n  /*\n   * 여섯째·일곱째 어휘 — **마감된 사용 구간**과 **청구서**. 커널 0.7.72 가 이 문들을 열었다.\n   *\n   * ── ★ 사용 구간을 계량보다 **먼저** 가른다 ─────────────────────────────────\n   * `isEnergyRecord` 는 `meterId` 가 있으면 참이므로 사용 구간에도 참이다. 순서를 정하지 않으면\n   * 시간별 사용량이 계량 표본으로 들어가고, 그 문은 `kWh` 를 **적산 레지스터**로 읽는다. 그러면\n   * 커널이 구간 전력량을 차분으로 구하는데 우리가 넣은 값이 이미 구간의 양이다 — 차분의 차분이 되어\n   * 값이 조용히 틀린다. 거부되지도 않는다.\n   */\n  const usagePeriods = arr.filter(isEnergyUsagePeriodRecord) as unknown as EnergyUsagePeriodRecord[]\n  const bills = arr.filter(isEnergyBillRecord) as unknown as EnergyBillRecord[]\n  /*\n   * 여덟째 어휘 — **그 주기에 적용되는 요금 기준**. 커널 0.7.76 이 이 문을 열었다.\n   *\n   * ★ 청구서와 겹친다. 청구서가 `billingDemandKW` 를 실을 수 있고, 그러면 두 판정이 다 참이다.\n   * 그때 요금 기준 문으로 보내면 「금액은 이 문이 받지 않는다」로 거부된다 — 정산이 통째로\n   * 사라진다. 그래서 청구서인 것을 뺀다. 커널에서 배타로 만들어 달라고 올렸다.\n   */\n  const tariffBases = arr.filter(r => isEnergyTariffBasisRecord(r) && !isEnergyBillRecord(r)) as unknown as EnergyTariffBasisRecord[]\n  /*\n   * 아홉째 어휘 — **발전 단가**. 낸 것에 매겨지는 1kWh 당 값이고 날마다 바뀐다(커널 0.7.79).\n   *\n   * 다른 문과 겹치지 않는다: 계량 지점이나 설비 id 가 있으면 이 문이 아니고(커널이 배타로 막는다),\n   * 요금적용전력·기본요금 단가가 없으므로 요금 기준도 아니다.\n   */\n  const generationPrices = arr.filter(isEnergyGenerationPriceRecord) as unknown as EnergyGenerationPriceRecord[]\n  /* 마감된 발전 기간 — 지난 기록 채우기가 쓴다. 적산의 문과 배타다(구간이 있으면 이쪽). */\n  const generationPeriods = arr.filter(isEnergyGenerationPeriodRecord) as unknown as EnergyGenerationPeriodRecord[]\n  const energy = arr.filter(r => isEnergyRecord(r) && !isEnergyUsagePeriodRecord(r)) as EnergyRecord[]\n  /* 세 번째 어휘 — 설비가 낸 자기 에너지 상태(발전·저장·감축 여지·개폐 위치). 계량과 갈라 두는\n     이유는 커널에 적혀 있다: 계량은 구간에 누적되고, 이것들은 그 설비의 지금이다. */\n  /*\n   * 다섯 번째 어휘 — **발전 적산**(설비가 지금까지 만든 양). 커널 0.7.69 가 이 문을 열었다.\n   *\n   * ── ★ 설비 상태보다 **먼저** 가른다 ──────────────────────────────────────────\n   * 두 판정이 겹친다. `isEnergyEquipmentRecord` 는 `equipmentId` 가 있고 물류·계량 어휘가 아니면\n   * 참이므로 발전 적산도 함께 참이다. 그래서 순서가 갈림을 정한다.\n   *\n   * 순서를 잘못 두면 조용히 사라지는 것이 아니라 **엉뚱한 이유로 거부된다**: 설비 상태 문은 적산을\n   * 값으로 세지 않아 「바꿀 상태가 하나도 없다」로 돌려보낸다. 커넥터는 보냈다고 믿고, 화면에는\n   * 발전량이 없다.\n   */\n  const energyGeneration = arr.filter(isEnergyGenerationRecord) as unknown as EnergyGenerationRecord[]\n  const energyEquipment = arr.filter(r => isEnergyEquipmentRecord(r) && !isEnergyGenerationRecord(r)) as unknown as EnergyEquipmentRecord[]\n  /*\n   * 네 번째 어휘 — **운영 사실**(작업·설비·사람·자산·오더·품질). 관측 리듀서는 이것을 오래전부터\n   * 계산했는데 **들어올 문이 없었다**: 원본이 「이 작업이 끝났다」를 말할 길이 없어 시뮬 커널만 그것을\n   * 아는 상태가 남았다(같은 화면이 두 구동에서 다른 것을 말한다).\n   */\n  const operational = arr.filter(isOperationalRecord) as OperationalRecord[]\n  /*\n   * ── 이 목록은 **어휘를 더할 때마다 함께 늘어야 한다** (2026-08-30) ─────────\n   *\n   * EPCIS 갈래는 「나머지 전부」다. 새 어휘를 빼 주지 않으면 그 레코드가 제 문으로 가면서\n   * **EPCIS 문으로도 들어가** 거부된다. 받아들여지기도 하고 거부되기도 하는 상태가 되어,\n   * 유입 장부의 거부 수가 늘고 사람이 그것을 진짜 결함으로 읽는다.\n   *\n   * 실제로 발전 단가를 더할 때 그렇게 됐다. 목록을 손으로 지키는 대신 시험이 지킨다\n   * (§`canonical-ingest-vocabularies` — 어휘마다 한 문으로만 가는지).\n   */\n  const epcis = arr.filter(\n    r =>\n      !isEnergyRecord(r) &&\n      !isEnergyEquipmentRecord(r) &&\n      !isEnergyGenerationRecord(r) &&\n      !isEnergyUsagePeriodRecord(r) &&\n      !isEnergyBillRecord(r) &&\n      !isEnergyTariffBasisRecord(r) &&\n      !isEnergyGenerationPriceRecord(r) &&\n      !isEnergyGenerationPeriodRecord(r) &&\n      !isOperationalRecord(r) &&\n      !isMasterDataRecord(r)\n  ) as (CanonicalRecord | CanonicalAggregationRecord | CanonicalTransformationRecord)[]\n\n  /* 품목 어휘 안에서도 갈림이 있다(개체 관측 / 담김) — 그 판정도 커널의 것을 부른다. */\n  const epcisResult = epcis.length\n    ? ingest(\n        epcis.map(r => ({\n          ...r,\n          /*\n           * ── **시각의 이름을 둘 흡수한다** (2026-08-24 실측) ────────────────────\n           * `eventTimePath` 는 **한 이름**만 받는다. 호스트가 `'eventTime'` 으로 못박아 두었는데, 뒤에\n           * 생긴 커넥터는 `at` 을 싣는다(에너지 채널이 이미 `at` 을 쓰고 있어 그 어휘를 따랐다).\n           * 그래서 그 커넥터의 사건은 **전부 폴링 순간**으로 찍혔다 — 저널 18,150건이 그랬다.\n           *\n           * 그 결과 둘이 함께 망가졌다: 재고 관측이 트윈의 시계를 밀지 못해 시계가 `task.status` 의\n           * 최댓값(2026-04-15)에 **멈춰 있었고**, 이동 사건에서 「언제」가 사라져 순서만 남았다.\n           *\n           * 이름을 하나로 강요하지 않고 흡수한다 — `orderId`·`resourceRef`·`equipmentId` 를 함께 보는\n           * 것과 같은 규율이다(§`twin-event-keys`). 세대가 섞이는 것은 이 이음새의 성질이다.\n           *\n           * **없으면 만들지 않는다**: 절대값 스냅샷 관측은 원본의 갱신 시각이 아니라 **폴링 순간**이\n           * 맞는 관측 시각이다(「어제 값을 오늘 봤다」는 「어제 일어났다」가 아니다). 값을 말하는\n           * 레코드만 자기 시각을 갖는다.\n           */\n          /*\n           * ── 세 번째로 같은 자리를 밟았다 (2026-09-06) ────────────────────────\n           * 여기가 `eventTime ?? at` **두 이름만** 보고 있었다. `nonconformance.disposition` 은\n           * `data.decidedAt` 을 싣고(contract 가 required), 그래서 ingest 시각으로 떨어졌다 —\n           * backfill 로 5일 지난 사실을 받으니 5일 틀린 값이 저장됐다.\n           *\n           * 이름을 하나 더 넣는 것으로는 안 끝난다. type 마다의 칸을 한 표에 두고, 못 읽은 것은\n           * 세어서 낸다(§`event-time.ts`).\n           */\n          ...(factEventTime(r) !== undefined ? { eventTime: factEventTime(r) } : {}),\n          /* 판정은 커널이 한 곳에서 한다 — 여기서 다시 짐작하면 소비처마다 답이 달라진다. */\n          sourceType: isTransformationRecord(r)\n            ? 'twin-transformation'\n            : isAggregationRecord(r)\n              ? 'twin-aggregation'\n              : 'twin'\n        })),\n        TWIN_INGEST_RULES,\n        /*\n         * **레코드가 시각을 말하면 그것을 쓴다** (2026-08-23).\n         *\n         * `eventTimePath` 를 주지 않던 동안 이 경로는 **언제나 폴링 시각**을 썼다(`defaultEventTime`).\n         * 그래서 커넥터가 이미 싣고 있던 `eventTime`(변환 레코드의 `finishedAt` 등)이 **알리지 않고\n         * 무시됐다** — 커넥터를 붙인 쪽은 그것이 먹는다고 믿고 있었고, 어디에도 오류가 나지 않았다.\n         *\n         * 무엇이 걸렸나: 계보(변환)의 시각이다. 4월에 만든 로트가 8월에 만들어진 것으로 저널에 남았다.\n         * 그리고 실측 소요를 재는 폴드가 봉투 시각을 쓰므로(§`kpi-fold`: `workMs = 완료 − 첫 착수`),\n         * 폴링 간격을 작업시간으로 배울 수 있었다 — 못 배우는 것보다 나쁘다.\n         *\n         * 레코드에 `eventTime` 이 없으면 커널이 알리지 않고 기본값으로 떨어진다(§`resolve` — 없는 값은\n         * 오류가 아니다). 그래서 이 한 줄이 기존 경로를 막지 않는다: 시각을 말하는 레코드만 사실이 된다.\n         */\n        { tenantId, defaultEventTime, eventTimePath: 'eventTime' }\n      )\n    : { accepted: [], rejected: [] }\n  const energyResult = energy.length ? ingestEnergyRecords(energy, { tenantId, defaultEventTime, ...scope }) : { accepted: [], rejected: [] }\n  const equipmentResult = energyEquipment.length\n    ? ingestEnergyEquipmentRecords(energyEquipment, { tenantId, defaultEventTime, ...scope })\n    : { accepted: [], rejected: [] }\n  const usageResult = usagePeriods.length\n    ? ingestEnergyUsagePeriodRecords(usagePeriods, { tenantId, defaultEventTime, ...scope })\n    : { accepted: [], rejected: [] }\n  const billResult = bills.length ? ingestEnergyBillRecords(bills, { tenantId, defaultEventTime, ...scope }) : { accepted: [], rejected: [] }\n  const tariffBasisResult = tariffBases.length\n    ? ingestEnergyTariffBasisRecords(tariffBases, { tenantId, defaultEventTime, ...scope })\n    : { accepted: [], rejected: [] }\n  const generationPeriodResult = generationPeriods.length\n    ? ingestEnergyGenerationPeriodRecords(generationPeriods, { tenantId, defaultEventTime, ...scope })\n    : { accepted: [], rejected: [] }\n  const generationPriceResult = generationPrices.length\n    ? ingestEnergyGenerationPriceRecords(generationPrices, { tenantId, defaultEventTime, ...scope })\n    : { accepted: [], rejected: [] }\n  const generationResult = energyGeneration.length\n    ? ingestEnergyGenerationRecords(energyGeneration, { tenantId, defaultEventTime, ...scope })\n    : { accepted: [], rejected: [] }\n  /*\n   * ── fact type 마다 시각 칸 이름이 다르다 (2026-09-06) ────────────────────────\n   * 운영 레코드의 봉투 시각은 `at` 이다. 그런데 `nonconformance.disposition` 은 자기 시각을\n   * **payload 의 `decidedAt`** 에 싣는다(contract 가 그 자리에 required 로 선언했다). 그래서 `at` 이\n   * 없고 `defaultEventTime`(= ingest 시각)으로 떨어졌다.\n   *\n   * ```\n   * [측정함 2026-09-06, mes-line-a backfill 뒤]\n   * event_time  2026-09-05 23:50:51    data.decidedAt  2026-09-01T02:50:51.832Z    5일 차이\n   * ```\n   *\n   * push 경로에서는 몇 초 차이라 아무도 못 알아챈다. backfill 이 그 간격을 벌려서 드러냈다 —\n   * backfill 이 만든 결함이 아니라 원래 있던 것이 보인 것이다.\n   *\n   * 여기서 `at` 을 채워 넣는다. 더 깊은 고침은 contract 쪽이지만(선언과 봉투가 다른 이름을 쓰는\n   * 비대칭), 그것은 배포를 기다려야 하고 그동안 값이 계속 틀리게 저장된다.\n   */\n  const operationalDated = operational.map(r => {\n    const at = factEventTime(r)\n    return at !== undefined && (r as any).at === undefined ? { ...(r as any), at } : r\n  })\n  const operationalResult = operationalDated.length\n    ? ingestOperationalRecords(operationalDated, { tenantId, defaultEventTime, ...scope })\n    : { accepted: [], rejected: [] }\n\n  /* 거부분을 합쳐 돌려준다 — 어느 어휘에서 거부됐는지는 이유 문구가 말한다. */\n  return {\n    accepted: [\n      ...epcisResult.accepted,\n      ...energyResult.accepted,\n      ...equipmentResult.accepted,\n      ...generationResult.accepted,\n      ...usageResult.accepted,\n      ...generationPriceResult.accepted,\n      ...generationPeriodResult.accepted,\n      ...billResult.accepted,\n      ...tariffBasisResult.accepted,\n      ...operationalResult.accepted\n    ],\n    rejected: [\n      ...epcisResult.rejected,\n      ...energyResult.rejected,\n      ...equipmentResult.rejected,\n      ...generationResult.rejected,\n      ...usageResult.rejected,\n      ...billResult.rejected,\n      ...tariffBasisResult.rejected,\n      ...generationPriceResult.rejected,\n      ...generationPeriodResult.rejected,\n      ...operationalResult.rejected,\n      ...master.rejected\n    ],\n    /* 사건이 아닌 것은 따로 낸다 — 부르는 쪽이 상태 세우는 문으로 보낸다(저널로 가지 않게). */\n    masterData: master.accepted,\n    /*\n     * **시각을 못 읽어 ingest 시각으로 떨어진 것** — type 별 수.\n     *\n     * 오류가 아니다. 절대값 snapshot 은 polling 순간이 맞는 시각이라 여기 세어지는 것이 정상이다.\n     * 다만 그 수가 어디에도 안 남으면 `event_time == created_at` 이 유일한 단서가 되고, 그것은\n     * 우연히 같은 것과 구별되지 않는다.\n     */\n    undated: undatedByKind([...epcis, ...operational])\n  }\n}\n\n/**\n * 유입 결과 — 사건(봉투)과 **사건이 아닌 것**을 갈라 낸다.\n *\n * 마스터데이터를 `accepted` 에 섞지 않는 이유: 부르는 쪽이 그것을 저널에 적게 되고, 시각축이 없는 값이\n * 「그때 일어난 일」로 남는다. 갈래를 타입으로 갈라 두면 그 실수를 할 수 없다.\n */\nexport interface CanonicalIngestResult extends IngestResult {\n  masterData: MasterDataRecord[]\n  /**\n   * 시각을 못 읽어 ingest 시각으로 떨어진 record 를 **type 별로** 센다.\n   *\n   * 비어 있으면 전부 자기 시각을 말한 것이다. 값이 있어도 오류는 아니다 — 절대값 snapshot 은\n   * polling 순간이 맞는 시각이다. 다만 그 수가 남아야 「5일 틀린 값이 저장됐다」를 나중에 찾을 수\n   * 있다(2026-09-06 에 그것을 backfill 로 찾았다).\n   */\n  undated: Record<string, number>\n}\n"]}

package/dist-server/engine/event-time.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 운영 fact 종류가 자기 시각을 싣는 칸 — 봉투의 `at` 이 없을 때 읽는다.
+ *
+ * 새 종류가 자기 시각을 payload 에 실으면 여기 한 줄을 더한다.
+ */
+export declare const KIND_TIME_FIELD: Record<string, string>;
+/**
+ * 이 레코드가 말하는 시각. **못 읽으면 `undefined`** — 여기서 지금 시각으로 채우지 않는다.
+ *
+ * 보는 순서는 공통 이름이 먼저다. connector 가 봉투 층에서 시각을 실어 주면 그것이 그 레코드에 대한
+ * 가장 바깥의 판단이고, 종류마다의 칸은 그것이 없을 때 읽는다.
+ */
+export declare function factEventTime(record: unknown): string | undefined;
+/**
+ * 시각을 못 읽은 레코드를 종류별로 센다 — **조용히 ingest 시각으로 떨어진 것들.**
+ *
+ * 오류가 아니다. 절대값 snapshot 관측은 원본의 갱신 시각이 아니라 polling 순간이 맞는 시각이라
+ * (「어제 값을 오늘 봤다」는 「어제 일어났다」가 아니다) 여기 세어지는 것이 정상이다.
+ *
+ * 다만 그 수가 어디에도 안 남으면 `event_time == created_at` 이 유일한 단서가 되고, 그것은 우연히
+ * 같은 것과 구별되지 않는다.
+ */
+export declare function undatedByKind(records: readonly unknown[]): Record<string, number>;
+/** 표에 있는 종류인데 시각을 못 읽었다 — 그것은 실제로 결함이다. */
+export declare function shouldHaveTime(kind: string): boolean;

package/dist-server/engine/event-time.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KIND_TIME_FIELD = void 0;
+exports.factEventTime = factEventTime;
+exports.undatedByKind = undatedByKind;
+exports.shouldHaveTime = shouldHaveTime;
+/*
+ * **레코드가 말하는 「언제 일어났나」를 읽는다** — fact 종류마다 칸 이름이 다르다.
+ *
+ * ── 같은 defect 가 세 번째다 ────────────────────────────────────────────────
+ * `canonical-ingest.ts` 가 `eventTime ?? at` **두 이름만** 보고 있었다. 그 주석에 이미 두 번의 사고가
+ * 적혀 있다 — 처음엔 `eventTime` 하나만 봐서 energy connector 의 사실 18,150건이 polling 시각으로
+ * 찍혔고, 그 다음에 `at` 을 더했다.
+ *
+ * 세 번째는 `nonconformance.disposition` 이었다.
+ *
+ * ```
+ * [측정함 2026-09-06, mes-line-a backfill 뒤]
+ * event_time  2026-09-05 23:50:51    payload decidedAt  2026-09-01T02:50:51.832Z     5일 차이
+ * ```
+ *
+ * ── root cause: 선언과 봉투가 다른 이름을 쓴다 ──────────────────────────────
+ * 운영 레코드의 봉투 시각은 `at` 이다(`OperationalRecordEnvelopeFields`). 그런데 처분 fact 는 자기
+ * 시각을 **payload 의 `decidedAt`** 에 싣는다 — contract 가 그 자리에 required 로 선언했고 plant 도
+ * 맞게 보낸다. 읽는 쪽에 그 이름이 없어서 `defaultEventTime`(= ingest 시각)으로 떨어졌다.
+ *
+ * ── push 경로에서는 안 보인다 ───────────────────────────────────────────────
+ * 사실이 나자마자 보내면 ingest 시각과 event 시각이 몇 초 차이다. backfill 이 그 간격을 벌려서
+ * 드러냈다 — **backfill 이 만든 defect 가 아니라 원래 있던 것이 보인 것**이다.
+ *
+ * ── 이름을 늘리는 것으로는 안 끝난다 ────────────────────────────────────────
+ * 다음 fact 종류가 또 다른 이름을 쓰면 같은 자리를 밟는다. 그래서 두 가지를 함께 한다.
+ *
+ * ```
+ * 1  종류마다의 칸 이름을 한 표에 둔다     새 종류를 더할 때 여기가 눈에 띈다
+ * 2  못 읽으면 그 수를 낸다                조용히 ingest 시각으로 떨어지지 않는다
+ * ```
+ *
+ * 종류 판정은 **contract 의 것을 부른다**(`operationalKindOf`). 여기서 다시 짐작하면 두 곳이 다른
+ * 답을 내고, 그때 어느 쪽이 맞는지 아무도 모른다.
+ */
+const ops_contract_1 = require("@operato/ops-contract");
+/**
+ * 운영 fact 종류가 자기 시각을 싣는 칸 — 봉투의 `at` 이 없을 때 읽는다.
+ *
+ * 새 종류가 자기 시각을 payload 에 실으면 여기 한 줄을 더한다.
+ */
+exports.KIND_TIME_FIELD = {
+    /* `DispositionFact.decidedAt` — contract 가 required 로 선언했다. */
+    disposition: 'decidedAt'
+};
+/*
+ * `equipment-period` 는 일부러 안 넣는다. 그 fact 의 봉투 시각은 **구간의 끝**이고(그때 성립한다),
+ * `recordTime` 은 「그 구간을 언제 적었나」다. 둘이 갈려 있어야 늦게 적은 구간이 늦게 일어난 것으로
+ * 읽히지 않는다 — contract 가 그 판단을 이미 적어 두었다.
+ */
+function iso(v) {
+    return typeof v === 'string' && v.trim() ? v : undefined;
+}
+/**
+ * 이 레코드가 말하는 시각. **못 읽으면 `undefined`** — 여기서 지금 시각으로 채우지 않는다.
+ *
+ * 보는 순서는 공통 이름이 먼저다. connector 가 봉투 층에서 시각을 실어 주면 그것이 그 레코드에 대한
+ * 가장 바깥의 판단이고, 종류마다의 칸은 그것이 없을 때 읽는다.
+ */
+function factEventTime(record) {
+    const r = record;
+    const common = iso(r?.eventTime) ?? iso(r?.at);
+    if (common)
+        return common;
+    const kind = (0, ops_contract_1.operationalKindOf)(record);
+    const named = kind ? exports.KIND_TIME_FIELD[kind] : undefined;
+    return named ? iso(r?.[named]) : undefined;
+}
+/**
+ * 시각을 못 읽은 레코드를 종류별로 센다 — **조용히 ingest 시각으로 떨어진 것들.**
+ *
+ * 오류가 아니다. 절대값 snapshot 관측은 원본의 갱신 시각이 아니라 polling 순간이 맞는 시각이라
+ * (「어제 값을 오늘 봤다」는 「어제 일어났다」가 아니다) 여기 세어지는 것이 정상이다.
+ *
+ * 다만 그 수가 어디에도 안 남으면 `event_time == created_at` 이 유일한 단서가 되고, 그것은 우연히
+ * 같은 것과 구별되지 않는다.
+ */
+function undatedByKind(records) {
+    const out = {};
+    for (const r of records) {
+        if (factEventTime(r) !== undefined)
+            continue;
+        const kind = (0, ops_contract_1.operationalKindOf)(r) ?? r?.type ?? '(종류 모름)';
+        out[kind] = (out[kind] ?? 0) + 1;
+    }
+    return out;
+}
+/** 표에 있는 종류인데 시각을 못 읽었다 — 그것은 실제로 결함이다. */
+function shouldHaveTime(kind) {
+    return kind in exports.KIND_TIME_FIELD;
+}
+//# sourceMappingURL=event-time.js.map

package/dist-server/engine/event-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-time.js","sourceRoot":"","sources":["../../server/engine/event-time.ts"],"names":[],"mappings":";;;AA+DA,sCAQC;AAWD,sCAQC;AAGD,wCAEC;AA/FD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wDAAyD;AAEzD;;;;GAIG;AACU,QAAA,eAAe,GAA2B;IACrD,+DAA+D;IAC/D,WAAW,EAAE,WAAW;CACzB,CAAA;AAED;;;;GAIG;AAEH,SAAS,GAAG,CAAC,CAAU;IACrB,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AAC1D,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,MAAe;IAC3C,MAAM,CAAC,GAAG,MAAa,CAAA;IACvB,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAC9C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,MAAM,IAAI,GAAG,IAAA,gCAAiB,EAAC,MAAM,CAAC,CAAA;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,uBAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACtD,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AAC5C,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,aAAa,CAAC,OAA2B;IACvD,MAAM,GAAG,GAA2B,EAAE,CAAA;IACtC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,aAAa,CAAC,CAAC,CAAC,KAAK,SAAS;YAAE,SAAQ;QAC5C,MAAM,IAAI,GAAG,IAAA,gCAAiB,EAAC,CAAC,CAAC,IAAM,CAAS,EAAE,IAAe,IAAI,SAAS,CAAA;QAC9E,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;IAClC,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,2CAA2C;AAC3C,SAAgB,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,IAAI,uBAAe,CAAA;AAChC,CAAC","sourcesContent":["/*\n * **레코드가 말하는 「언제 일어났나」를 읽는다** — fact 종류마다 칸 이름이 다르다.\n *\n * ── 같은 defect 가 세 번째다 ────────────────────────────────────────────────\n * `canonical-ingest.ts` 가 `eventTime ?? at` **두 이름만** 보고 있었다. 그 주석에 이미 두 번의 사고가\n * 적혀 있다 — 처음엔 `eventTime` 하나만 봐서 energy connector 의 사실 18,150건이 polling 시각으로\n * 찍혔고, 그 다음에 `at` 을 더했다.\n *\n * 세 번째는 `nonconformance.disposition` 이었다.\n *\n * ```\n * [측정함 2026-09-06, mes-line-a backfill 뒤]\n * event_time  2026-09-05 23:50:51    payload decidedAt  2026-09-01T02:50:51.832Z     5일 차이\n * ```\n *\n * ── root cause: 선언과 봉투가 다른 이름을 쓴다 ──────────────────────────────\n * 운영 레코드의 봉투 시각은 `at` 이다(`OperationalRecordEnvelopeFields`). 그런데 처분 fact 는 자기\n * 시각을 **payload 의 `decidedAt`** 에 싣는다 — contract 가 그 자리에 required 로 선언했고 plant 도\n * 맞게 보낸다. 읽는 쪽에 그 이름이 없어서 `defaultEventTime`(= ingest 시각)으로 떨어졌다.\n *\n * ── push 경로에서는 안 보인다 ───────────────────────────────────────────────\n * 사실이 나자마자 보내면 ingest 시각과 event 시각이 몇 초 차이다. backfill 이 그 간격을 벌려서\n * 드러냈다 — **backfill 이 만든 defect 가 아니라 원래 있던 것이 보인 것**이다.\n *\n * ── 이름을 늘리는 것으로는 안 끝난다 ────────────────────────────────────────\n * 다음 fact 종류가 또 다른 이름을 쓰면 같은 자리를 밟는다. 그래서 두 가지를 함께 한다.\n *\n * ```\n * 1  종류마다의 칸 이름을 한 표에 둔다     새 종류를 더할 때 여기가 눈에 띈다\n * 2  못 읽으면 그 수를 낸다                조용히 ingest 시각으로 떨어지지 않는다\n * ```\n *\n * 종류 판정은 **contract 의 것을 부른다**(`operationalKindOf`). 여기서 다시 짐작하면 두 곳이 다른\n * 답을 내고, 그때 어느 쪽이 맞는지 아무도 모른다.\n */\nimport { operationalKindOf } from '@operato/ops-contract'\n\n/**\n * 운영 fact 종류가 자기 시각을 싣는 칸 — 봉투의 `at` 이 없을 때 읽는다.\n *\n * 새 종류가 자기 시각을 payload 에 실으면 여기 한 줄을 더한다.\n */\nexport const KIND_TIME_FIELD: Record<string, string> = {\n  /* `DispositionFact.decidedAt` — contract 가 required 로 선언했다. */\n  disposition: 'decidedAt'\n}\n\n/*\n * `equipment-period` 는 일부러 안 넣는다. 그 fact 의 봉투 시각은 **구간의 끝**이고(그때 성립한다),\n * `recordTime` 은 「그 구간을 언제 적었나」다. 둘이 갈려 있어야 늦게 적은 구간이 늦게 일어난 것으로\n * 읽히지 않는다 — contract 가 그 판단을 이미 적어 두었다.\n */\n\nfunction iso(v: unknown): string | undefined {\n  return typeof v === 'string' && v.trim() ? v : undefined\n}\n\n/**\n * 이 레코드가 말하는 시각. **못 읽으면 `undefined`** — 여기서 지금 시각으로 채우지 않는다.\n *\n * 보는 순서는 공통 이름이 먼저다. connector 가 봉투 층에서 시각을 실어 주면 그것이 그 레코드에 대한\n * 가장 바깥의 판단이고, 종류마다의 칸은 그것이 없을 때 읽는다.\n */\nexport function factEventTime(record: unknown): string | undefined {\n  const r = record as any\n  const common = iso(r?.eventTime) ?? iso(r?.at)\n  if (common) return common\n\n  const kind = operationalKindOf(record)\n  const named = kind ? KIND_TIME_FIELD[kind] : undefined\n  return named ? iso(r?.[named]) : undefined\n}\n\n/**\n * 시각을 못 읽은 레코드를 종류별로 센다 — **조용히 ingest 시각으로 떨어진 것들.**\n *\n * 오류가 아니다. 절대값 snapshot 관측은 원본의 갱신 시각이 아니라 polling 순간이 맞는 시각이라\n * (「어제 값을 오늘 봤다」는 「어제 일어났다」가 아니다) 여기 세어지는 것이 정상이다.\n *\n * 다만 그 수가 어디에도 안 남으면 `event_time == created_at` 이 유일한 단서가 되고, 그것은 우연히\n * 같은 것과 구별되지 않는다.\n */\nexport function undatedByKind(records: readonly unknown[]): Record<string, number> {\n  const out: Record<string, number> = {}\n  for (const r of records) {\n    if (factEventTime(r) !== undefined) continue\n    const kind = operationalKindOf(r) ?? ((r as any)?.type as string) ?? '(종류 모름)'\n    out[kind] = (out[kind] ?? 0) + 1\n  }\n  return out\n}\n\n/** 표에 있는 종류인데 시각을 못 읽었다 — 그것은 실제로 결함이다. */\nexport function shouldHaveTime(kind: string): boolean {\n  return kind in KIND_TIME_FIELD\n}\n"]}

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

@@ -22,3 +22,5 @@ export * from './operation-basis.js';
 export * from './measured-yield.js';
 export * from './declared-stimulus.js';
 export * from './integration-coverage.js';
+export { factIdentity } from './ingest-dedupe.js';
+export { factEventTime, shouldHaveTime, undatedByKind } from './event-time.js';

package/dist-server/engine/index.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.undatedByKind = exports.shouldHaveTime = exports.factEventTime = exports.factIdentity = void 0;
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./twin-engine.js"), exports);
 tslib_1.__exportStar(require("./canonical-ingest.js"), exports);
@@ -32,4 +33,26 @@ tslib_1.__exportStar(require("./operation-basis.js"), exports);
 tslib_1.__exportStar(require("./measured-yield.js"), exports);
 tslib_1.__exportStar(require("./declared-stimulus.js"), exports);
 tslib_1.__exportStar(require("./integration-coverage.js"), exports);
+/*
+ * 사실의 정체(identity)와 시각을 판단하는 함수들.
+ *
+ * 모듈 전체를 export 하지 않고 이 둘만 내보낸다. `FactDeduper` 같은 상태를 가진 클래스는 커널
+ * 안에서만 쓰여야 하고, 밖에서 인스턴스를 따로 만들면 중복 판단 기억이 두 벌이 된다.
+ *
+ * 밖에서 이 둘이 필요한 이유는 하나다 — 저널에 앉은 사실이 제대로 된 정체와 시각을 가졌는지
+ * 확인할 때, 유입할 때와 **똑같은 함수로** 판단해야 하기 때문이다. 확인하는 쪽이 규칙을 다시
+ * 구현하면 두 규칙이 어긋나는 날 확인이 조용히 통과한다.
+ */
+var ingest_dedupe_js_1 = require("./ingest-dedupe.js");
+Object.defineProperty(exports, "factIdentity", { enumerable: true, get: function () { return ingest_dedupe_js_1.factIdentity; } });
+/*
+ * `shouldHaveTime` is the part that matters outside: it separates "this record legitimately has no
+ * time of its own" (a snapshot observation — the polling moment IS the right time) from "the kind
+ * declares a time field and we could not read it", which is a real defect. Anything checking the
+ * journal must use this split rather than inventing its own, or it reports healthy rows as broken.
+ */
+var event_time_js_1 = require("./event-time.js");
+Object.defineProperty(exports, "factEventTime", { enumerable: true, get: function () { return event_time_js_1.factEventTime; } });
+Object.defineProperty(exports, "shouldHaveTime", { enumerable: true, get: function () { return event_time_js_1.shouldHaveTime; } });
+Object.defineProperty(exports, "undatedByKind", { enumerable: true, get: function () { return event_time_js_1.undatedByKind; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/engine/index.ts"],"names":[],"mappings":";;;AAAA,2DAAgC;AAChC,gEAAqC;AACrC,wDAA6B;AAC7B,gEAAqC;AACrC,4DAAiC;AACjC,qEAAqE;AACrE,0DAA+B;AAC/B,qGAA0E;AAC1E,0DAA0D;AAC1D,oGAAyE;AACzE,4CAA4C;AAC5C,kGAAuE;AACvE,sCAAsC;AACtC,0DAA+B;AAC/B,wDAA6B;AAC7B,gEAAgE;AAChE,2DAAgC;AAChC,yDAA8B;AAC9B,6DAAkC;AAClC,gEAAqC;AACrC,kEAAuC;AACvC,2DAAgC;AAChC,kEAAuC;AACvC,gDAAgD;AAChD,6DAAkC;AAClC,yDAAyD;AACzD,kEAAuC;AACvC,+DAAoC;AACpC,8DAAmC;AACnC,iEAAsC;AACtC,oEAAyC","sourcesContent":["export * from './twin-engine.js'\nexport * from './canonical-ingest.js'\nexport * from './kpi-fold.js'\nexport * from './property-effects.js'\nexport * from './kpi-baseline.js'\n/* 지표 정본 표(TWIN_METRIC)·목표 판정 — 소비처(twin-ai 등)가 지표 이름을 다시 열거하지 않게. */\nexport * from './kpi-target.js'\nexport * from '@things-factory/headless-twin/dist-shared/kpi-broadcast.js'\n/* 집약 채널 태그(접두사 + 트윈별 태그 생성) — 소비처가 문자열을 다시 적지 않게 내보낸다. */\nexport * from '@things-factory/headless-twin/dist-shared/entity-delta.js'\n/* 공간 계층의 단계 — 씬 표현·성과 카드·AI 가 같은 목록을 쓴다. */\nexport * from '@things-factory/headless-twin/dist-shared/twin-level.js'\n/* 부하 계기판 — 어떤 작업이 이벤트 루프를 얼마나 쓰는지. */\nexport * from './load-meter.js'\nexport * from './loop-lag.js'\n/* 런타임 레지스트리 키 규약 — 소비처(다른 키 캐시·테스트)가 `:` 를 다시 적지 않게 함께 내보낸다. */\nexport * from './runtime-key.js'\nexport * from './kpi-query.js'\nexport * from './spec-coverage.js'\nexport * from './travel-estimator.js'\nexport * from './measured-estimator.js'\nexport * from './model-basis.js'\nexport * from './live-feed-registry.js'\n/* 동기화 건강 — 「이 트윈이 현장과 맞춰지고 있나」. 판정·추이·사유·표본. */\nexport * from './ingest-health.js'\n/* 로컬 선언(현장·트윈) — 소비처(twin-ai 도구)가 명세·검사 규칙을 다시 적지 않게. */\nexport * from './local-declarations.js'\nexport * from './operation-basis.js'\nexport * from './measured-yield.js'\nexport * from './declared-stimulus.js'\nexport * from './integration-coverage.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/engine/index.ts"],"names":[],"mappings":";;;;AAAA,2DAAgC;AAChC,gEAAqC;AACrC,wDAA6B;AAC7B,gEAAqC;AACrC,4DAAiC;AACjC,qEAAqE;AACrE,0DAA+B;AAC/B,qGAA0E;AAC1E,0DAA0D;AAC1D,oGAAyE;AACzE,4CAA4C;AAC5C,kGAAuE;AACvE,sCAAsC;AACtC,0DAA+B;AAC/B,wDAA6B;AAC7B,gEAAgE;AAChE,2DAAgC;AAChC,yDAA8B;AAC9B,6DAAkC;AAClC,gEAAqC;AACrC,kEAAuC;AACvC,2DAAgC;AAChC,kEAAuC;AACvC,gDAAgD;AAChD,6DAAkC;AAClC,yDAAyD;AACzD,kEAAuC;AACvC,+DAAoC;AACpC,8DAAmC;AACnC,iEAAsC;AACtC,oEAAyC;AAEzC;;;;;;;;;GASG;AACH,uDAAiD;AAAxC,gHAAA,YAAY,OAAA;AAErB;;;;;GAKG;AACH,iDAA8E;AAArE,8GAAA,aAAa,OAAA;AAAE,+GAAA,cAAc,OAAA;AAAE,8GAAA,aAAa,OAAA","sourcesContent":["export * from './twin-engine.js'\nexport * from './canonical-ingest.js'\nexport * from './kpi-fold.js'\nexport * from './property-effects.js'\nexport * from './kpi-baseline.js'\n/* 지표 정본 표(TWIN_METRIC)·목표 판정 — 소비처(twin-ai 등)가 지표 이름을 다시 열거하지 않게. */\nexport * from './kpi-target.js'\nexport * from '@things-factory/headless-twin/dist-shared/kpi-broadcast.js'\n/* 집약 채널 태그(접두사 + 트윈별 태그 생성) — 소비처가 문자열을 다시 적지 않게 내보낸다. */\nexport * from '@things-factory/headless-twin/dist-shared/entity-delta.js'\n/* 공간 계층의 단계 — 씬 표현·성과 카드·AI 가 같은 목록을 쓴다. */\nexport * from '@things-factory/headless-twin/dist-shared/twin-level.js'\n/* 부하 계기판 — 어떤 작업이 이벤트 루프를 얼마나 쓰는지. */\nexport * from './load-meter.js'\nexport * from './loop-lag.js'\n/* 런타임 레지스트리 키 규약 — 소비처(다른 키 캐시·테스트)가 `:` 를 다시 적지 않게 함께 내보낸다. */\nexport * from './runtime-key.js'\nexport * from './kpi-query.js'\nexport * from './spec-coverage.js'\nexport * from './travel-estimator.js'\nexport * from './measured-estimator.js'\nexport * from './model-basis.js'\nexport * from './live-feed-registry.js'\n/* 동기화 건강 — 「이 트윈이 현장과 맞춰지고 있나」. 판정·추이·사유·표본. */\nexport * from './ingest-health.js'\n/* 로컬 선언(현장·트윈) — 소비처(twin-ai 도구)가 명세·검사 규칙을 다시 적지 않게. */\nexport * from './local-declarations.js'\nexport * from './operation-basis.js'\nexport * from './measured-yield.js'\nexport * from './declared-stimulus.js'\nexport * from './integration-coverage.js'\n\n/*\n * 사실의 정체(identity)와 시각을 판단하는 함수들.\n *\n * 모듈 전체를 export 하지 않고 이 둘만 내보낸다. `FactDeduper` 같은 상태를 가진 클래스는 커널\n * 안에서만 쓰여야 하고, 밖에서 인스턴스를 따로 만들면 중복 판단 기억이 두 벌이 된다.\n *\n * 밖에서 이 둘이 필요한 이유는 하나다 — 저널에 앉은 사실이 제대로 된 정체와 시각을 가졌는지\n * 확인할 때, 유입할 때와 **똑같은 함수로** 판단해야 하기 때문이다. 확인하는 쪽이 규칙을 다시\n * 구현하면 두 규칙이 어긋나는 날 확인이 조용히 통과한다.\n */\nexport { factIdentity } from './ingest-dedupe.js'\n\n/*\n * `shouldHaveTime` is the part that matters outside: it separates \"this record legitimately has no\n * time of its own\" (a snapshot observation — the polling moment IS the right time) from \"the kind\n * declares a time field and we could not read it\", which is a real defect. Anything checking the\n * journal must use this split rather than inventing its own, or it reports healthy rows as broken.\n */\nexport { factEventTime, shouldHaveTime, undatedByKind } from './event-time.js'\n"]}