@operato/twin-kernel 0.7.79 → 0.7.81

package/dist/ems-kernel.d.ts

@@ -169,6 +169,15 @@ export declare class EmsKernel extends FlowEngine {
      * 않으면 늦게 온 옛 적산이 최신 값을 뒤로 돌린다 — 그리고 그것이 「계기가 되돌아갔다」로 잘못 적힌다.
      */
     private applyGenerated;
+    /**
+     * 시계가 기간의 끝을 지났으면 마감한다 — **표본을 기다리지 않는다.**
+     *
+     * 값이 오지 않는 밤에도 자정이 지나면 어제가 닫힌다. 마감에 쓰는 총량은 **그날 마지막으로 본 값**
+     * 이므로 표본이 더 오지 않아도 정확하다(하루 누적은 그 값이 곧 그날의 총량이다).
+     *
+     * 이 자리는 계량의 `closeDue` 와 같은 성질이다 — 호스트가 시각을 주며 부른다.
+     */
+    closeGenerationPeriodsDue(nowMs: number): void;
     /**
      * **기간이 끝났으면 그 기간의 발전량을 사실로 낸다.**
      *

package/dist/ems-kernel.js

@@ -532,6 +532,39 @@ export class EmsKernel extends FlowEngine {
         this.closeGenerationPeriod(id, eq, { atMs, kWh, dayIndex, kind, since, priorSince, periodAdvanced, faulted: dropped && sameDayDrop });
         this.revision++;
     }
+    /**
+     * 시계가 기간의 끝을 지났으면 마감한다 — **표본을 기다리지 않는다.**
+     *
+     * 값이 오지 않는 밤에도 자정이 지나면 어제가 닫힌다. 마감에 쓰는 총량은 **그날 마지막으로 본 값**
+     * 이므로 표본이 더 오지 않아도 정확하다(하루 누적은 그 값이 곧 그날의 총량이다).
+     *
+     * 이 자리는 계량의 `closeDue` 와 같은 성질이다 — 호스트가 시각을 주며 부른다.
+     */
+    closeGenerationPeriodsDue(nowMs) {
+        const today = this.localDayIndex(nowMs);
+        for (const [id, obs] of [...this.generationPeriodObs.entries()]) {
+            if (today <= obs.dayIndex)
+                continue;
+            const eq = this.equipment.get(id);
+            if (!eq)
+                continue;
+            const kind = eq.generatedKWhAccumulation;
+            /*
+             * 마감은 `applyGenerated` 와 **같은 함수**로 한다 — 규칙을 두 벌 만들면 표본으로 닫은 날과
+             * 시계로 닫은 날이 다른 값을 낸다.
+             *
+             * 그때 「지금 들어온 값」이 없으므로, 마지막으로 본 값을 그대로 넘긴다(그 값은 이미 상태에 있다).
+             */
+            this.closeGenerationPeriod(id, eq, {
+                atMs: nowMs,
+                kWh: obs.lastKWh,
+                dayIndex: today,
+                kind,
+                periodAdvanced: false,
+                faulted: false
+            });
+        }
+    }
     /**
      * **기간이 끝났으면 그 기간의 발전량을 사실로 낸다.**
      *
@@ -1523,6 +1556,16 @@ export class EmsKernel extends FlowEngine {
          * 부하를 먼저 만들고 마감한다 — 마감이 먼저면 마지막 값이 다음 구간으로 밀린다.
          */
         const at = this.nowMs();
+        /*
+         * ── 발전 기간도 **시계로** 마감한다 (2026-08-30) ───────────────────────────
+         *
+         * 앞 판은 새 표본이 올 때만 날짜가 바뀐 것을 알아챘다. 그런데 태양광은 해가 지면 값을 보내지
+         * 않는다 — 어제 마지막 표본이 19:40 이면 어제 하루치가 **다음 날 아침 첫 표본**에야 확정된다.
+         * 밤새 「어제 얼마 냈나」에 답이 없다.
+         *
+         * 계량은 이미 시계로 마감한다(`closeDue`). 한 커널 안에서 규칙이 두 벌일 이유가 없다.
+         */
+        this.closeGenerationPeriodsDue(at);
         /* 틱 길이를 함께 넘긴다 — 방전량을 에너지로 바꿀 때 필요하다(필드로 숨기면 어디서 온 값인지 흐려진다). */
         this.deriveLoad(at, dtMs);
         this.closeDue(at);

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

@@ -8168,6 +8168,31 @@ var EmsKernel = class extends FlowEngine {
     this.closeGenerationPeriod(id, eq, { atMs, kWh, dayIndex, kind, since, priorSince, periodAdvanced, faulted: dropped && sameDayDrop });
     this.revision++;
   }
+  /**
+   * 시계가 기간의 끝을 지났으면 마감한다 — **표본을 기다리지 않는다.**
+   *
+   * 값이 오지 않는 밤에도 자정이 지나면 어제가 닫힌다. 마감에 쓰는 총량은 **그날 마지막으로 본 값**
+   * 이므로 표본이 더 오지 않아도 정확하다(하루 누적은 그 값이 곧 그날의 총량이다).
+   *
+   * 이 자리는 계량의 `closeDue` 와 같은 성질이다 — 호스트가 시각을 주며 부른다.
+   */
+  closeGenerationPeriodsDue(nowMs) {
+    const today = this.localDayIndex(nowMs);
+    for (const [id, obs] of [...this.generationPeriodObs.entries()]) {
+      if (today <= obs.dayIndex) continue;
+      const eq = this.equipment.get(id);
+      if (!eq) continue;
+      const kind = eq.generatedKWhAccumulation;
+      this.closeGenerationPeriod(id, eq, {
+        atMs: nowMs,
+        kWh: obs.lastKWh,
+        dayIndex: today,
+        kind,
+        periodAdvanced: false,
+        faulted: false
+      });
+    }
+  }
   /**
    * **기간이 끝났으면 그 기간의 발전량을 사실로 낸다.**
    *
@@ -8898,6 +8923,7 @@ var EmsKernel = class extends FlowEngine {
   tick(dtMs) {
     super.tick(dtMs);
     const at = this.nowMs();
+    this.closeGenerationPeriodsDue(at);
     this.deriveLoad(at, dtMs);
     this.closeDue(at);
   }
@@ -10023,7 +10049,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);
@@ -10037,7 +10062,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,
@@ -10057,7 +10082,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);
@@ -10083,7 +10107,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,
@@ -10099,6 +10123,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();
@@ -10128,7 +10155,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();
@@ -10168,7 +10194,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,
@@ -10182,7 +10208,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);
@@ -10209,7 +10234,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.79",
+  "version": "0.7.81",
   "type": "module",
   "description": "Twin Domain Kernel — framework-agnostic, zero-dep (domain + sim + 3-channel contract). WMS/YMS/MES, EPCIS 2.0 · ISA-95.",
   "publishConfig": {