@operato/twin-kernel 0.7.70 → 0.7.71

package/dist/contract.d.ts

@@ -2030,10 +2030,9 @@ export interface GenerationPeriodObservation {
     equipmentId: string;
     /** 선언된 시각 기준의 며칠째인가(§`localDayIndexAt`). */
     dayIndex: number;
-    /** 이 기간에서 처음 본 적산과 그 시각 — 평생 적산의 기준점이다. */
-    fromKWh: number;
+    /** 이 기간에서 처음 관측한 시각 — 기간 시작과 다르면 그만큼 재지 않았다. */
     fromMs: number;
-    /** 이 기간에서 마지막으로 본 적산과 그 시각 — 하루 누적은 이것이 곧 총량이다. */
+    /** 이 기간에서 마지막으로 본 적산과 그 시각 — 기간 누적은 이것이 곧 총량이다. */
     lastKWh: number;
     lastMs: number;
 }

package/dist/ems-kernel.js

@@ -430,19 +430,18 @@ export class EmsKernel extends FlowEngine {
      */
     closeGenerationPeriod(id, eq, at) {
         const obs = this.generationPeriodObs.get(id);
-        const fresh = { dayIndex: at.dayIndex, fromKWh: at.kWh, fromMs: at.atMs, lastKWh: at.kWh, lastMs: at.atMs };
-        /* 계기가 되돌아간 뒤의 기준점은 쓸 수 없다 — 차이가 음수가 되거나, 더 나쁘게 작아진 총량이 참인 척한다. */
+        const fresh = { dayIndex: at.dayIndex, fromMs: at.atMs, lastKWh: at.kWh, lastMs: at.atMs };
+        /* 계기가 되돌아간 뒤의 관측은 쓸 수 없다 — 되돌아간 시점 앞뒤가 한 기간에 섞인다. */
         if (at.faulted || !obs || at.kind === undefined || at.kind === 'unknown') {
             this.generationPeriodObs.set(id, fresh);
             return;
         }
         const declaredClose = at.periodAdvanced && !!at.priorSince && !!at.since;
-        const dayClose = at.dayIndex > obs.dayIndex && (at.kind === 'daily' || at.kind === 'lifetime');
+        const dayClose = at.dayIndex > obs.dayIndex && at.kind === 'daily';
         let startMs;
         let endMs;
         let boundary;
-        if (declaredClose && at.kind !== 'lifetime') {
-            /* 평생 적산에 기준점이 나아가는 것은 뜻이 서지 않는다(기간이 하루가 아니다) — 자정 마감만 쓴다. */
+        if (declaredClose) {
             startMs = Date.parse(at.priorSince);
             endMs = Date.parse(at.since);
             boundary = 'declared';
@@ -454,10 +453,10 @@ export class EmsKernel extends FlowEngine {
         }
         if (startMs === undefined || endMs === undefined || boundary === undefined || !Number.isFinite(startMs) || !Number.isFinite(endMs)) {
             /*
-             * 하루가 지났는데 마감할 근거가 없다 — 월·요금기간 종류인데 기준점이 오지 않는 경우다. 세어 둔다:
-             * 세지 않으면 그 발전소의 발전량이 아무 표시 없이 영원히 나오지 않는다.
+             * 하루가 지났는데 마감할 근거가 없다 — 하루가 아닌 기간인데 원본이 기준점을 말하지 않는 경우다.
+             * 세어 둔다: 세지 않으면 그 발전소의 발전량이 아무 표시 없이 영원히 나오지 않는다.
              */
-            if (at.dayIndex > obs.dayIndex && (at.kind === 'monthly' || at.kind === 'billing'))
+            if (at.dayIndex > obs.dayIndex)
                 this.unclosedGenerationPeriods++;
             if (at.dayIndex !== obs.dayIndex)
                 this.generationPeriodObs.set(id, fresh);
@@ -465,7 +464,19 @@ export class EmsKernel extends FlowEngine {
                 this.generationPeriodObs.set(id, { ...obs, lastKWh: at.kWh, lastMs: at.atMs });
             return;
         }
-        const total = at.kind === 'lifetime' ? obs.lastKWh - obs.fromKWh : obs.lastKWh;
+        /*
+         * ── 총량은 관측한 값 그대로다 — 뺄셈을 하지 않는다 (2026-08-28) ────────────
+         *
+         * 기간 누적은 그 기간에 쌓인 값이므로, 마지막으로 본 값이 곧 그 기간의 총량이다.
+         *
+         * 평생 누적을 뺄셈으로 하루 몫으로 바꾸는 갈래가 잠깐 있었는데 **지웠다.** 사용자 판단이다: 발전
+         * 원본이 주는 「평생 총량」은 진짜 평생치가 아니다(레지스터가 차면 되돌아가고, 설비를 교체하면
+         * 0부터 시작한다). 누적이 필요하면 기간 사실을 합해서 만드는 것이고, 원본에서 받을 값이 아니다.
+         *
+         * `'lifetime'` 은 **어휘에는 남는다** — 되돌아감을 기간 경계가 아니라 계기의 이상으로 판정하는
+         * 데 쓰인다(§위 `periodic`). 그 종류로 오는 값은 기간 사실을 만들지 않고 위에서 세어 둔다.
+         */
+        const total = obs.lastKWh;
         if (Number.isFinite(total) && total >= 0) {
             this.emitOp(ENERGY_EVENT.generationPeriod, {
                 equipmentId: id,
@@ -1283,11 +1294,10 @@ export class EmsKernel extends FlowEngine {
         for (const o of e.generationPeriods ?? []) {
             if (!o?.equipmentId)
                 continue;
-            if (![o.dayIndex, o.fromKWh, o.fromMs, o.lastKWh, o.lastMs].every(v => Number.isFinite(Number(v))))
+            if (![o.dayIndex, o.fromMs, o.lastKWh, o.lastMs].every(v => Number.isFinite(Number(v))))
                 continue;
             this.generationPeriodObs.set(o.equipmentId, {
                 dayIndex: Number(o.dayIndex),
-                fromKWh: Number(o.fromKWh),
                 fromMs: Number(o.fromMs),
                 lastKWh: Number(o.lastKWh),
                 lastMs: Number(o.lastMs)

package/dist-cjs/index.cjs

@@ -7995,17 +7995,17 @@ var EmsKernel = class extends FlowEngine {
    */
   closeGenerationPeriod(id, eq, at) {
     const obs = this.generationPeriodObs.get(id);
-    const fresh = { dayIndex: at.dayIndex, fromKWh: at.kWh, fromMs: at.atMs, lastKWh: at.kWh, lastMs: at.atMs };
+    const fresh = { dayIndex: at.dayIndex, fromMs: at.atMs, lastKWh: at.kWh, lastMs: at.atMs };
     if (at.faulted || !obs || at.kind === void 0 || at.kind === "unknown") {
       this.generationPeriodObs.set(id, fresh);
       return;
     }
     const declaredClose = at.periodAdvanced && !!at.priorSince && !!at.since;
-    const dayClose = at.dayIndex > obs.dayIndex && (at.kind === "daily" || at.kind === "lifetime");
+    const dayClose = at.dayIndex > obs.dayIndex && at.kind === "daily";
     let startMs;
     let endMs;
     let boundary;
-    if (declaredClose && at.kind !== "lifetime") {
+    if (declaredClose) {
       startMs = Date.parse(at.priorSince);
       endMs = Date.parse(at.since);
       boundary = "declared";
@@ -8015,12 +8015,12 @@ var EmsKernel = class extends FlowEngine {
       boundary = "offset";
     }
     if (startMs === void 0 || endMs === void 0 || boundary === void 0 || !Number.isFinite(startMs) || !Number.isFinite(endMs)) {
-      if (at.dayIndex > obs.dayIndex && (at.kind === "monthly" || at.kind === "billing")) this.unclosedGenerationPeriods++;
+      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 });
       return;
     }
-    const total = at.kind === "lifetime" ? obs.lastKWh - obs.fromKWh : obs.lastKWh;
+    const total = obs.lastKWh;
     if (Number.isFinite(total) && total >= 0) {
       this.emitOp(ENERGY_EVENT.generationPeriod, {
         equipmentId: id,
@@ -8601,10 +8601,9 @@ var EmsKernel = class extends FlowEngine {
     if (e.peakSince && Number.isFinite(e.peakSince.kW)) this.peak = { kW: e.peakSince.kW, windowStartMs: e.peakSince.windowStartMs };
     for (const o of e.generationPeriods ?? []) {
       if (!o?.equipmentId) continue;
-      if (![o.dayIndex, o.fromKWh, o.fromMs, o.lastKWh, o.lastMs].every((v) => Number.isFinite(Number(v)))) continue;
+      if (![o.dayIndex, o.fromMs, o.lastKWh, o.lastMs].every((v) => Number.isFinite(Number(v)))) continue;
       this.generationPeriodObs.set(o.equipmentId, {
         dayIndex: Number(o.dayIndex),
-        fromKWh: Number(o.fromKWh),
         fromMs: Number(o.fromMs),
         lastKWh: Number(o.lastKWh),
         lastMs: Number(o.lastMs)

package/package.json

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