@operato/twin-kernel 0.7.80 → 0.7.82

package/dist/contract.d.ts

@@ -2096,6 +2096,18 @@ export interface GenerationPeriodObservation {
     /** 이 기간에서 마지막으로 본 적산과 그 시각 — 기간 누적은 이것이 곧 총량이다. */
     lastKWh: number;
     lastMs: number;
+    /**
+     * 그 적산이 **어떤 누적인가** — 마감할 때 총량을 얻는 방법이 이것으로 갈린다.
+     *
+     * ── 왜 여기 함께 두나 (2026-08-30) ────────────────────────────────────────
+     * 설비 상태는 원천이 다시 보내 주므로 재기동에서 되살리지 않는다(관측 축은 원천에서). 그 규율은
+     * 맞다. 그런데 **누적의 종류는 관측이 아니라 그 원본이 어떤 값을 주는지에 대한 사실**이다 —
+     * 값은 다음 표본에 다시 오지만 종류도 그때까지 없다.
+     *
+     * 태양광은 밤에 표본을 보내지 않는다. 그래서 밤에 재기동하면 종류가 사라지고, 시계가 자정을
+     * 지나도 **어느 기간의 값인지 몰라 마감하지 못한다.** 실제로 그렇게 됐다(2026-08-30 04:54).
+     */
+    accumulation?: 'lifetime' | 'daily' | 'monthly' | 'billing' | 'unknown';
 }
 /**
  * 조치방향 — code=안정 조치 키(언어 중립). command 있으면 원클릭 실행, 없으면 권고.

package/dist/ems-kernel.js

@@ -548,7 +548,12 @@ export class EmsKernel extends FlowEngine {
             const eq = this.equipment.get(id);
             if (!eq)
                 continue;
-            const kind = eq.generatedKWhAccumulation;
+            /*
+             * 종류는 **관측과 함께 이어받은 것**이 먼저다. 설비 상태는 재기동에서 되살아나지 않으므로
+             * (관측 축은 원천에서), 밤에 재기동하면 상태의 종류가 비어 있다 — 그러면 자정이 지나도
+             * 「어느 기간의 값인지 모른다」로 마감하지 못한다.
+             */
+            const kind = obs.accumulation ?? eq.generatedKWhAccumulation;
             /*
              * 마감은 `applyGenerated` 와 **같은 함수**로 한다 — 규칙을 두 벌 만들면 표본으로 닫은 날과
              * 시계로 닫은 날이 다른 값을 낸다.
@@ -591,7 +596,8 @@ export class EmsKernel extends FlowEngine {
      */
     closeGenerationPeriod(id, eq, at) {
         const obs = this.generationPeriodObs.get(id);
-        const fresh = { dayIndex: at.dayIndex, fromMs: at.atMs, lastKWh: at.kWh, lastMs: at.atMs };
+        /* 종류를 함께 들고 간다 — 재기동에서 설비 상태는 사라지지만 이 관측은 이어진다. */
+        const fresh = { dayIndex: at.dayIndex, fromMs: at.atMs, lastKWh: at.kWh, lastMs: at.atMs, accumulation: at.kind };
         /* 계기가 되돌아간 뒤의 관측은 쓸 수 없다 — 되돌아간 시점 앞뒤가 한 기간에 섞인다. */
         if (at.faulted || !obs || at.kind === undefined || at.kind === 'unknown') {
             this.generationPeriodObs.set(id, fresh);
@@ -622,7 +628,7 @@ export class EmsKernel extends FlowEngine {
             if (at.dayIndex !== obs.dayIndex)
                 this.generationPeriodObs.set(id, fresh);
             else
-                this.generationPeriodObs.set(id, { ...obs, lastKWh: at.kWh, lastMs: at.atMs });
+                this.generationPeriodObs.set(id, { ...obs, lastKWh: at.kWh, lastMs: at.atMs, accumulation: (at.kind ?? obs.accumulation) });
             return;
         }
         /*
@@ -1614,7 +1620,8 @@ export class EmsKernel extends FlowEngine {
                 dayIndex: Number(o.dayIndex),
                 fromMs: Number(o.fromMs),
                 lastKWh: Number(o.lastKWh),
-                lastMs: Number(o.lastMs)
+                lastMs: Number(o.lastMs),
+                ...(o.accumulation ? { accumulation: o.accumulation } : {})
             });
         }
         /* 못 마감한 수도 이어받는다 — 이어받지 않으면 재기동마다 0 으로 돌아가 문제가 사라진 것처럼 보인다. */

package/dist/energy-ingest.js

@@ -399,7 +399,6 @@ export function ingestEnergyGenerationPriceRecords(records, opts) {
     const list = records === undefined || records === null ? [] : Array.isArray(records) ? records : [records];
     const accepted = [];
     const rejected = [];
-    let seq = 0;
     for (const r of list) {
         const errors = [];
         const span = readSpan(r, errors);
@@ -416,7 +415,7 @@ export function ingestEnergyGenerationPriceRecords(records, opts) {
         }
         const data = { from: span.from, to: span.to, unitPrice, currency };
         accepted.push({
-            eventId: `${opts.tenantId}-generation-price-${++seq}`,
+            eventId: periodFactId(opts.tenantId, ENERGY_EVENT.generationPrice, '', span.from, span.to),
             eventType: ENERGY_EVENT.generationPrice,
             eventTime: span.from,
             tenantId: opts.tenantId,
@@ -453,7 +452,6 @@ export function ingestEnergyTariffBasisRecords(records, opts) {
     const list = records === undefined || records === null ? [] : Array.isArray(records) ? records : [records];
     const accepted = [];
     const rejected = [];
-    let seq = 0;
     for (const r of list) {
         const errors = [];
         const span = readSpan(r, errors);
@@ -482,7 +480,7 @@ export function ingestEnergyTariffBasisRecords(records, opts) {
             ...(currency ? { currency } : {})
         };
         accepted.push({
-            eventId: `${opts.tenantId}-tariff-basis-${++seq}`,
+            eventId: periodFactId(opts.tenantId, ENERGY_EVENT.tariffBasis, '', span.from, span.to),
             eventType: ENERGY_EVENT.tariffBasis,
             /* **시작 시각**이다 — 그때부터 유효하다(§ 위 주석). */
             eventTime: span.from,
@@ -500,6 +498,27 @@ export function isEnergyBillRecord(record) {
         return false;
     return r.energyCharge !== undefined || r.demandCharge !== undefined || r.total !== undefined;
 }
+/*
+ * ── 마감된 구간 사실의 **정체성** (2026-08-30) ───────────────────────────────
+ *
+ * 커널이 다루는 사실에는 두 종류가 있다.
+ *
+ *   시점의 관측    「이 시각에 이 값이었다」    같은 값이 두 번 오면 **두 사실**이다
+ *   마감된 구간    「이 기간에 이만큼이었다」   같은 기간이 두 번 오면 **한 사실**이다
+ *
+ * 둘째 종류는 정체성이 내용에 있다 — **종류·대상·시작·끝**이 같으면 같은 사실이다. 어느 커넥터가
+ * 어떻게 보내든, 재기동을 몇 번 하든 그렇다.
+ *
+ * 그래서 이 문들의 봉투 id 를 **순번이 아니라 내용에서** 만든다. 순번으로 만들면 같은 기간을 다시
+ * 보낼 때마다 다른 id 가 나오고, 읽는 쪽이 같은 사실인지 알 방법이 없다.
+ *
+ * **이것만으로 중복이 막히지는 않는다.** 저널은 아직 이 id 를 유일성으로 쓰지 않는다(그 판단은
+ * 호스트의 것이고 드라이버마다 다르다). 여기서 하는 일은 **막을 근거를 만드는 것**이다.
+ */
+function periodFactId(tenantId, kind, subject, from, to) {
+    /* 대상이 없는 사실(요금 기준·청구서·발전 단가)은 그 자리를 비운다 — 없는 것을 지어내지 않는다. */
+    return [tenantId, kind, subject, from, to].join('|');
+}
 /** 두 시각을 읽고 순서를 본다 — 뒤집힌 구간은 받지 않는다(합이 음수가 된다). */
 function readSpan(r, errors) {
     const from = String(r?.from ?? '').trim();
@@ -534,7 +553,6 @@ export function ingestEnergyUsagePeriodRecords(records, opts) {
     const list = records === undefined || records === null ? [] : Array.isArray(records) ? records : [records];
     const accepted = [];
     const rejected = [];
-    let seq = 0;
     for (const r of list) {
         const errors = [];
         const meterId = String(r?.meterId ?? '').trim();
@@ -581,7 +599,7 @@ export function ingestEnergyUsagePeriodRecords(records, opts) {
             ...(basis ? { basis } : {})
         };
         accepted.push({
-            eventId: `${opts.tenantId}-usage-period-${++seq}`,
+            eventId: periodFactId(opts.tenantId, ENERGY_EVENT.usagePeriod, meterId, span.from, span.to),
             eventType: ENERGY_EVENT.usagePeriod,
             /* 구간의 **끝**이 이 사실이 성립한 시각이다 — 시작으로 달면 저널이 그 구간을 미리 안 것이 된다. */
             eventTime: span.to,
@@ -595,7 +613,6 @@ export function ingestEnergyBillRecords(records, opts) {
     const list = records === undefined || records === null ? [] : Array.isArray(records) ? records : [records];
     const accepted = [];
     const rejected = [];
-    let seq = 0;
     for (const r of list) {
         const errors = [];
         const span = readSpan(r, errors);
@@ -628,7 +645,7 @@ export function ingestEnergyBillRecords(records, opts) {
             ...(billingDemandKW !== undefined ? { billingDemandKW } : {})
         };
         accepted.push({
-            eventId: `${opts.tenantId}-bill-${++seq}`,
+            eventId: periodFactId(opts.tenantId, ENERGY_EVENT.bill, '', span.from, span.to),
             eventType: ENERGY_EVENT.bill,
             eventTime: span.to,
             tenantId: opts.tenantId,

package/dist-cjs/index.cjs

@@ -8182,7 +8182,7 @@ var EmsKernel = class extends FlowEngine {
       if (today <= obs.dayIndex) continue;
       const eq = this.equipment.get(id);
       if (!eq) continue;
-      const kind = eq.generatedKWhAccumulation;
+      const kind = obs.accumulation ?? eq.generatedKWhAccumulation;
       this.closeGenerationPeriod(id, eq, {
         atMs: nowMs,
         kWh: obs.lastKWh,
@@ -8219,7 +8219,7 @@ var EmsKernel = class extends FlowEngine {
    */
   closeGenerationPeriod(id, eq, at) {
     const obs = this.generationPeriodObs.get(id);
-    const fresh = { dayIndex: at.dayIndex, fromMs: at.atMs, lastKWh: at.kWh, lastMs: at.atMs };
+    const fresh = { dayIndex: at.dayIndex, fromMs: at.atMs, lastKWh: at.kWh, lastMs: at.atMs, accumulation: at.kind };
     if (at.faulted || !obs || at.kind === void 0 || at.kind === "unknown") {
       this.generationPeriodObs.set(id, fresh);
       return;
@@ -8241,7 +8241,7 @@ var EmsKernel = class extends FlowEngine {
     if (startMs === void 0 || endMs === void 0 || boundary === void 0 || !Number.isFinite(startMs) || !Number.isFinite(endMs)) {
       if (at.dayIndex > obs.dayIndex) this.unclosedGenerationPeriods++;
       if (at.dayIndex !== obs.dayIndex) this.generationPeriodObs.set(id, fresh);
-      else this.generationPeriodObs.set(id, { ...obs, lastKWh: at.kWh, lastMs: at.atMs });
+      else this.generationPeriodObs.set(id, { ...obs, lastKWh: at.kWh, lastMs: at.atMs, accumulation: at.kind ?? obs.accumulation });
       return;
     }
     const total = obs.lastKWh;
@@ -8957,7 +8957,8 @@ var EmsKernel = class extends FlowEngine {
         dayIndex: Number(o.dayIndex),
         fromMs: Number(o.fromMs),
         lastKWh: Number(o.lastKWh),
-        lastMs: Number(o.lastMs)
+        lastMs: Number(o.lastMs),
+        ...o.accumulation ? { accumulation: o.accumulation } : {}
       });
     }
     if (Number.isFinite(e.unclosedGenerationPeriods)) this.unclosedGenerationPeriods = Number(e.unclosedGenerationPeriods);
@@ -10049,7 +10050,6 @@ function ingestEnergyGenerationPriceRecords(records, opts) {
   const list = records === void 0 || records === null ? [] : Array.isArray(records) ? records : [records];
   const accepted = [];
   const rejected = [];
-  let seq = 0;
   for (const r of list) {
     const errors = [];
     const span = readSpan(r, errors);
@@ -10063,7 +10063,7 @@ function ingestEnergyGenerationPriceRecords(records, opts) {
     }
     const data = { from: span.from, to: span.to, unitPrice, currency };
     accepted.push({
-      eventId: `${opts.tenantId}-generation-price-${++seq}`,
+      eventId: periodFactId(opts.tenantId, ENERGY_EVENT.generationPrice, "", span.from, span.to),
       eventType: ENERGY_EVENT.generationPrice,
       eventTime: span.from,
       tenantId: opts.tenantId,
@@ -10083,7 +10083,6 @@ function ingestEnergyTariffBasisRecords(records, opts) {
   const list = records === void 0 || records === null ? [] : Array.isArray(records) ? records : [records];
   const accepted = [];
   const rejected = [];
-  let seq = 0;
   for (const r of list) {
     const errors = [];
     const span = readSpan(r, errors);
@@ -10109,7 +10108,7 @@ function ingestEnergyTariffBasisRecords(records, opts) {
       ...currency ? { currency } : {}
     };
     accepted.push({
-      eventId: `${opts.tenantId}-tariff-basis-${++seq}`,
+      eventId: periodFactId(opts.tenantId, ENERGY_EVENT.tariffBasis, "", span.from, span.to),
       eventType: ENERGY_EVENT.tariffBasis,
       /* **시작 시각**이다 — 그때부터 유효하다(§ 위 주석). */
       eventTime: span.from,
@@ -10125,6 +10124,9 @@ function isEnergyBillRecord(record) {
   if (r.from === void 0 || r.to === void 0) return false;
   return r.energyCharge !== void 0 || r.demandCharge !== void 0 || r.total !== void 0;
 }
+function periodFactId(tenantId, kind, subject, from, to) {
+  return [tenantId, kind, subject, from, to].join("|");
+}
 function readSpan(r, errors) {
   const from = String(r?.from ?? "").trim();
   const to = String(r?.to ?? "").trim();
@@ -10154,7 +10156,6 @@ function ingestEnergyUsagePeriodRecords(records, opts) {
   const list = records === void 0 || records === null ? [] : Array.isArray(records) ? records : [records];
   const accepted = [];
   const rejected = [];
-  let seq = 0;
   for (const r of list) {
     const errors = [];
     const meterId = String(r?.meterId ?? "").trim();
@@ -10194,7 +10195,7 @@ function ingestEnergyUsagePeriodRecords(records, opts) {
       ...basis ? { basis } : {}
     };
     accepted.push({
-      eventId: `${opts.tenantId}-usage-period-${++seq}`,
+      eventId: periodFactId(opts.tenantId, ENERGY_EVENT.usagePeriod, meterId, span.from, span.to),
       eventType: ENERGY_EVENT.usagePeriod,
       /* 구간의 **끝**이 이 사실이 성립한 시각이다 — 시작으로 달면 저널이 그 구간을 미리 안 것이 된다. */
       eventTime: span.to,
@@ -10208,7 +10209,6 @@ function ingestEnergyBillRecords(records, opts) {
   const list = records === void 0 || records === null ? [] : Array.isArray(records) ? records : [records];
   const accepted = [];
   const rejected = [];
-  let seq = 0;
   for (const r of list) {
     const errors = [];
     const span = readSpan(r, errors);
@@ -10235,7 +10235,7 @@ function ingestEnergyBillRecords(records, opts) {
       ...billingDemandKW !== void 0 ? { billingDemandKW } : {}
     };
     accepted.push({
-      eventId: `${opts.tenantId}-bill-${++seq}`,
+      eventId: periodFactId(opts.tenantId, ENERGY_EVENT.bill, "", span.from, span.to),
       eventType: ENERGY_EVENT.bill,
       eventTime: span.to,
       tenantId: opts.tenantId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operato/twin-kernel",
-  "version": "0.7.80",
+  "version": "0.7.82",
   "type": "module",
   "description": "Twin Domain Kernel — framework-agnostic, zero-dep (domain + sim + 3-channel contract). WMS/YMS/MES, EPCIS 2.0 · ISA-95.",
   "publishConfig": {