@operato/twin-kernel 0.7.81 → 0.7.83

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,26 @@ export class EmsKernel extends FlowEngine {
             const eq = this.equipment.get(id);
             if (!eq)
                 continue;
-            const kind = eq.generatedKWhAccumulation;
+            /*
+             * 종류는 **관측과 함께 이어받은 것**이 먼저다. 설비 상태는 재기동에서 되살아나지 않으므로
+             * (관측 축은 원천에서), 밤에 재기동하면 상태의 종류가 비어 있다 — 그러면 자정이 지나도
+             * 「어느 기간의 값인지 모른다」로 마감하지 못한다.
+             */
+            const kind = obs.accumulation ?? eq.generatedKWhAccumulation;
+            /*
+             * ── 마감하지 못하면 **손대지 않는다** (2026-08-30, 고침) ─────────────────
+             *
+             * 종류를 모르면 마감할 수 없다. 그런데 그대로 아래로 내려보내면 관측이 **오늘 것으로 덮인다** —
+             * 표본이 왔을 때는 그 재설정이 맞지만(새 관측이니까), 시계로 부를 때는 새 표본이 없다.
+             * 덮으면 어제는 영영 마감되지 않는다.
+             *
+             * 실제로 그렇게 됐다: 밤에 재기동해 종류가 비었고, 시계가 자정을 지날 때마다 어제 관측이
+             * 오늘로 밀렸다. 아침 표본이 와도 마감할 어제가 남아 있지 않다.
+             */
+            if (kind === undefined || kind === 'unknown') {
+                this.unclosedGenerationPeriods++;
+                continue;
+            }
             /*
              * 마감은 `applyGenerated` 와 **같은 함수**로 한다 — 규칙을 두 벌 만들면 표본으로 닫은 날과
              * 시계로 닫은 날이 다른 값을 낸다.
@@ -591,7 +610,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 +642,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 +1634,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-cjs/index.cjs

@@ -8182,7 +8182,11 @@ 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;
+      if (kind === void 0 || kind === "unknown") {
+        this.unclosedGenerationPeriods++;
+        continue;
+      }
       this.closeGenerationPeriod(id, eq, {
         atMs: nowMs,
         kWh: obs.lastKWh,
@@ -8219,7 +8223,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 +8245,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 +8961,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);

package/package.json

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