@operato/twin-kernel 0.7.85 → 0.7.87

package/dist/ems-kernel.js

@@ -679,7 +679,9 @@ export class EmsKernel extends FlowEngine {
                 boundary,
                 subject: subj.subject,
                 subjectBasis: subj.basis
-            }, periodFactId(this.tenantId, ENERGY_EVENT.generationPeriod, subj.subject, periodStart, periodEnd));
+            }, periodFactId(this.tenantId, ENERGY_EVENT.generationPeriod, subj.subject, periodStart, periodEnd), 
+            /* 이 사실이 성립한 것은 기간의 끝이다 — 우리가 계산한 시각이 아니다. */
+            periodEnd);
             eq.generatedKWhLastPeriod = total;
             eq.generatedKWhLastPeriodEnd = new Date(endMs).toISOString();
             /* 상태만 읽는 화면이 덜 잰 값을 온전한 값으로 읽지 않게, 관측 구간을 함께 남긴다. */

package/dist/energy-ingest.d.ts

@@ -35,6 +35,11 @@ export interface EnergyIngestOptions {
      * 그때도 `twin-local` 이되 범위는 비어 있다.
      */
     scopeId?: string;
+    /**
+     * **지금** — 아직 오지 않은 시각의 사실을 받지 않기 위해 쓴다. 주지 않으면 `defaultEventTime` 을 쓰고,
+     * 그것도 없으면 판단하지 않는다(없는 기준으로 거절하지 않는다).
+     */
+    nowISO?: string;
 }
 export interface EnergyIngestResult {
     accepted: CanonicalEnvelope[];
@@ -200,14 +205,6 @@ export interface EnergyBillRecord {
     billingDemandKW?: number;
 }
 export declare function isEnergyBillRecord(record: unknown): boolean;
-/**
- * 이 사실의 **주체를 무엇으로 부를까** — 선언이 있으면 그 이름, 없으면 이름표와 그 범위.
- *
- * 선언이 없을 때 트윈 범위를 이름에 넣는 이유는 **겹침을 숨기지 않기 위해서**다. 넣지 않으면 서로 다른
- * 설비의 같은 날이 한 사실이 되고, 여러 현장을 함께 계산하는 곳에서 한쪽이 조용히 사라진다(실측).
- * 넣되 `subjectBasis` 로 **이 이름이 트윈 안에서만 통한다**고 밝힌다 — 그릇으로 정한 이름을 고유한
- * 척하지 않는다.
- */
 export declare function resolveSubject(kind: 'equipment' | 'meter', localId: string, opts: EnergyIngestOptions): {
     subject: string;
     basis: 'declared' | 'twin-local';

package/dist/energy-ingest.js

@@ -452,6 +452,11 @@ export function ingestEnergyGenerationPeriodRecords(records, opts) {
         const subj = resolveSubject('equipment', equipmentId, opts);
         data.subject = subj.subject;
         data.subjectBasis = subj.basis;
+        const futureError = futureFactError(span.to, opts);
+        if (futureError) {
+            rejected.push({ record: r, errors: [futureError] });
+            continue;
+        }
         accepted.push({
             eventId: periodFactId(opts.tenantId, ENERGY_EVENT.generationPeriod, subj.subject, span.from, span.to),
             eventType: ENERGY_EVENT.generationPeriod,
@@ -498,6 +503,11 @@ export function ingestEnergyGenerationPriceRecords(records, opts) {
             continue;
         }
         const data = { from: span.from, to: span.to, unitPrice, currency };
+        const futureError = futureFactError(span.from, opts);
+        if (futureError) {
+            rejected.push({ record: r, errors: [futureError] });
+            continue;
+        }
         accepted.push({
             eventId: periodFactId(opts.tenantId, ENERGY_EVENT.generationPrice, '', span.from, span.to),
             eventType: ENERGY_EVENT.generationPrice,
@@ -563,6 +573,11 @@ export function ingestEnergyTariffBasisRecords(records, opts) {
             ...(demandChargePerKW !== undefined ? { demandChargePerKW } : {}),
             ...(currency ? { currency } : {})
         };
+        const futureError = futureFactError(span.from, opts);
+        if (futureError) {
+            rejected.push({ record: r, errors: [futureError] });
+            continue;
+        }
         accepted.push({
             eventId: periodFactId(opts.tenantId, ENERGY_EVENT.tariffBasis, '', span.from, span.to),
             eventType: ENERGY_EVENT.tariffBasis,
@@ -607,6 +622,30 @@ export function isEnergyBillRecord(record) {
  * 넣되 `subjectBasis` 로 **이 이름이 트윈 안에서만 통한다**고 밝힌다 — 그릇으로 정한 이름을 고유한
  * 척하지 않는다.
  */
+/**
+ * **아직 오지 않은 시각의 사실은 받지 않는다.**
+ *
+ * ── 왜 필요한가 (2026-08-30) ──────────────────────────────────────────────
+ * 한 원본이 **끝나지 않은 이번 달**의 요금 정보를 청구서로 보냈다. 청구서의 사건 시각은 기간의 끝이라
+ * 그 사실이 **내일** 일어난 것으로 저널에 적혔다. 성과 계산은 「가장 늦은 사건」으로 구간을 잡으므로
+ * 구간 전체가 미래로 밀렸고, 그 현장의 화면에서 어제 발전량이 사라졌다. 오류는 하나도 나지 않았다.
+ *
+ * 지난 기록 채우기는 이미 이 판단을 하고 있었다(§`judgeBackfill`). 라이브 문에만 없어서 **한 종류에
+ * 규칙이 두 벌**이었다. 같은 사실이 어느 문으로 들어오느냐에 따라 받아지기도 하고 거절되기도 했다.
+ *
+ * 기준 선언(요금 기준·발전 단가)은 기간이 미래로 뻗어도 된다 — 그쪽은 사건 시각이 **기간의 시작**이라
+ * 이 판정에 걸리지 않는다. 앞으로 이렇게 매기겠다는 선언은 오늘 성립한다.
+ */
+function futureFactError(eventTime, opts) {
+    const nowText = opts.nowISO ?? opts.defaultEventTime;
+    if (!nowText)
+        return undefined;
+    const nowMs = Date.parse(nowText);
+    const atMs = Date.parse(eventTime);
+    if (!Number.isFinite(nowMs) || !Number.isFinite(atMs) || atMs <= nowMs)
+        return undefined;
+    return `아직 오지 않은 시각의 사실이다(${eventTime}) — 끝나지 않은 기간은 마감된 사실이 아니다`;
+}
 export function resolveSubject(kind, localId, opts) {
     const declared = opts.identityOf?.(kind, localId);
     if (declared)
@@ -699,6 +738,11 @@ export function ingestEnergyUsagePeriodRecords(records, opts) {
             ...(currency ? { currency } : {}),
             ...(basis ? { basis } : {})
         };
+        const futureError = futureFactError(span.to, opts);
+        if (futureError) {
+            rejected.push({ record: r, errors: [futureError] });
+            continue;
+        }
         accepted.push({
             eventId: periodFactId(opts.tenantId, ENERGY_EVENT.usagePeriod, subj.subject, span.from, span.to),
             eventType: ENERGY_EVENT.usagePeriod,
@@ -745,6 +789,11 @@ export function ingestEnergyBillRecords(records, opts) {
             ...(currency ? { currency } : {}),
             ...(billingDemandKW !== undefined ? { billingDemandKW } : {})
         };
+        const futureError = futureFactError(span.to, opts);
+        if (futureError) {
+            rejected.push({ record: r, errors: [futureError] });
+            continue;
+        }
         accepted.push({
             eventId: periodFactId(opts.tenantId, ENERGY_EVENT.bill, '', span.from, span.to),
             eventType: ENERGY_EVENT.bill,

package/dist/flow-engine.d.ts

@@ -1291,8 +1291,15 @@ export declare abstract class FlowEngine implements TwinKernel {
      * 커넥터가 지난 기록으로도 보내면, 순번 이름으로는 그 둘이 다른 사실이 되어 **발전량이 두 배로**
      * 잡힌다. 유입 문은 이미 내용으로 이름을 짓고 있었는데(§`periodFactId`) 커널 자신만 아니었다 —
      * 한 종류에 규칙이 두 벌이었다.
+     *
+     * ── 시각도 내용에서 온다 ─────────────────────────────────────────────────
+     * `emitOp` 은 **지금**을 찍는다. 마감된 구간에 그것을 찍으면 「우리가 언제 계산했나」가 되고, 재기동이
+     * 늦으면 어제의 사실이 오늘 시각을 갖는다. 실제로 그렇게 났다 — 부팅에서 닫힌 8월 29일치가 22:24 를
+     * 달고 나왔고, 시각 구간으로 읽는 중복 판정이 그것을 못 봐서 같은 하루가 12줄이 되었다(이름은 6개).
+     *
+     * 이 사실이 성립하는 것은 **기간의 끝**이다. 유입 문도 그 시각을 찍는다.
      */
-    protected emitPeriodFact(eventType: string, data: unknown, eventId: string): void;
+    protected emitPeriodFact(eventType: string, data: unknown, eventId: string, eventTime: string): void;
     /**
      * 이 트윈의 **범위 이름** — 선언된 정체성이 없을 때 이름표가 어디까지 통하는지(§`SubjectBasis`).
      *

package/dist/flow-engine.js

@@ -2798,10 +2798,17 @@ export class FlowEngine {
      * 커넥터가 지난 기록으로도 보내면, 순번 이름으로는 그 둘이 다른 사실이 되어 **발전량이 두 배로**
      * 잡힌다. 유입 문은 이미 내용으로 이름을 짓고 있었는데(§`periodFactId`) 커널 자신만 아니었다 —
      * 한 종류에 규칙이 두 벌이었다.
+     *
+     * ── 시각도 내용에서 온다 ─────────────────────────────────────────────────
+     * `emitOp` 은 **지금**을 찍는다. 마감된 구간에 그것을 찍으면 「우리가 언제 계산했나」가 되고, 재기동이
+     * 늦으면 어제의 사실이 오늘 시각을 갖는다. 실제로 그렇게 났다 — 부팅에서 닫힌 8월 29일치가 22:24 를
+     * 달고 나왔고, 시각 구간으로 읽는 중복 판정이 그것을 못 봐서 같은 하루가 12줄이 되었다(이름은 6개).
+     *
+     * 이 사실이 성립하는 것은 **기간의 끝**이다. 유입 문도 그 시각을 찍는다.
      */
-    emitPeriodFact(eventType, data, eventId) {
+    emitPeriodFact(eventType, data, eventId, eventTime) {
         this.revision++;
-        const e = { eventId, eventType, eventTime: this.now(), tenantId: this.tenantId, ...(this._correlationId ? { correlationId: this._correlationId } : {}), data };
+        const e = { eventId, eventType, eventTime, tenantId: this.tenantId, ...(this._correlationId ? { correlationId: this._correlationId } : {}), data };
         for (const h of this.handlers)
             h(e);
     }

package/dist-cjs/index.cjs

@@ -2824,6 +2824,11 @@ function ingestEnergyGenerationPeriodRecords(records, opts) {
     const subj = resolveSubject("equipment", equipmentId, opts);
     data.subject = subj.subject;
     data.subjectBasis = subj.basis;
+    const futureError = futureFactError(span.to, opts);
+    if (futureError) {
+      rejected.push({ record: r, errors: [futureError] });
+      continue;
+    }
     accepted.push({
       eventId: periodFactId(opts.tenantId, ENERGY_EVENT.generationPeriod, subj.subject, span.from, span.to),
       eventType: ENERGY_EVENT.generationPeriod,
@@ -2857,6 +2862,11 @@ function ingestEnergyGenerationPriceRecords(records, opts) {
       continue;
     }
     const data = { from: span.from, to: span.to, unitPrice, currency };
+    const futureError = futureFactError(span.from, opts);
+    if (futureError) {
+      rejected.push({ record: r, errors: [futureError] });
+      continue;
+    }
     accepted.push({
       eventId: periodFactId(opts.tenantId, ENERGY_EVENT.generationPrice, "", span.from, span.to),
       eventType: ENERGY_EVENT.generationPrice,
@@ -2902,6 +2912,11 @@ function ingestEnergyTariffBasisRecords(records, opts) {
       ...demandChargePerKW !== void 0 ? { demandChargePerKW } : {},
       ...currency ? { currency } : {}
     };
+    const futureError = futureFactError(span.from, opts);
+    if (futureError) {
+      rejected.push({ record: r, errors: [futureError] });
+      continue;
+    }
     accepted.push({
       eventId: periodFactId(opts.tenantId, ENERGY_EVENT.tariffBasis, "", span.from, span.to),
       eventType: ENERGY_EVENT.tariffBasis,
@@ -2919,6 +2934,14 @@ 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 futureFactError(eventTime, opts) {
+  const nowText = opts.nowISO ?? opts.defaultEventTime;
+  if (!nowText) return void 0;
+  const nowMs = Date.parse(nowText);
+  const atMs = Date.parse(eventTime);
+  if (!Number.isFinite(nowMs) || !Number.isFinite(atMs) || atMs <= nowMs) return void 0;
+  return `\uC544\uC9C1 \uC624\uC9C0 \uC54A\uC740 \uC2DC\uAC01\uC758 \uC0AC\uC2E4\uC774\uB2E4(${eventTime}) \u2014 \uB05D\uB098\uC9C0 \uC54A\uC740 \uAE30\uAC04\uC740 \uB9C8\uAC10\uB41C \uC0AC\uC2E4\uC774 \uC544\uB2C8\uB2E4`;
+}
 function resolveSubject(kind, localId, opts) {
   const declared = opts.identityOf?.(kind, localId);
   if (declared) return { subject: declared, basis: "declared" };
@@ -2997,6 +3020,11 @@ function ingestEnergyUsagePeriodRecords(records, opts) {
       ...currency ? { currency } : {},
       ...basis ? { basis } : {}
     };
+    const futureError = futureFactError(span.to, opts);
+    if (futureError) {
+      rejected.push({ record: r, errors: [futureError] });
+      continue;
+    }
     accepted.push({
       eventId: periodFactId(opts.tenantId, ENERGY_EVENT.usagePeriod, subj.subject, span.from, span.to),
       eventType: ENERGY_EVENT.usagePeriod,
@@ -3037,6 +3065,11 @@ function ingestEnergyBillRecords(records, opts) {
       ...currency ? { currency } : {},
       ...billingDemandKW !== void 0 ? { billingDemandKW } : {}
     };
+    const futureError = futureFactError(span.to, opts);
+    if (futureError) {
+      rejected.push({ record: r, errors: [futureError] });
+      continue;
+    }
     accepted.push({
       eventId: periodFactId(opts.tenantId, ENERGY_EVENT.bill, "", span.from, span.to),
       eventType: ENERGY_EVENT.bill,
@@ -5645,10 +5678,17 @@ var FlowEngine = class {
    * 커넥터가 지난 기록으로도 보내면, 순번 이름으로는 그 둘이 다른 사실이 되어 **발전량이 두 배로**
    * 잡힌다. 유입 문은 이미 내용으로 이름을 짓고 있었는데(§`periodFactId`) 커널 자신만 아니었다 —
    * 한 종류에 규칙이 두 벌이었다.
+   *
+   * ── 시각도 내용에서 온다 ─────────────────────────────────────────────────
+   * `emitOp` 은 **지금**을 찍는다. 마감된 구간에 그것을 찍으면 「우리가 언제 계산했나」가 되고, 재기동이
+   * 늦으면 어제의 사실이 오늘 시각을 갖는다. 실제로 그렇게 났다 — 부팅에서 닫힌 8월 29일치가 22:24 를
+   * 달고 나왔고, 시각 구간으로 읽는 중복 판정이 그것을 못 봐서 같은 하루가 12줄이 되었다(이름은 6개).
+   *
+   * 이 사실이 성립하는 것은 **기간의 끝**이다. 유입 문도 그 시각을 찍는다.
    */
-  emitPeriodFact(eventType, data, eventId) {
+  emitPeriodFact(eventType, data, eventId, eventTime) {
     this.revision++;
-    const e = { eventId, eventType, eventTime: this.now(), tenantId: this.tenantId, ...this._correlationId ? { correlationId: this._correlationId } : {}, data };
+    const e = { eventId, eventType, eventTime, tenantId: this.tenantId, ...this._correlationId ? { correlationId: this._correlationId } : {}, data };
     for (const h of this.handlers) h(e);
   }
   /**
@@ -8840,7 +8880,9 @@ var EmsKernel = class extends FlowEngine {
           subject: subj.subject,
           subjectBasis: subj.basis
         },
-        periodFactId(this.tenantId, ENERGY_EVENT.generationPeriod, subj.subject, periodStart, periodEnd)
+        periodFactId(this.tenantId, ENERGY_EVENT.generationPeriod, subj.subject, periodStart, periodEnd),
+        /* 이 사실이 성립한 것은 기간의 끝이다 — 우리가 계산한 시각이 아니다. */
+        periodEnd
       );
       eq.generatedKWhLastPeriod = total;
       eq.generatedKWhLastPeriodEnd = new Date(endMs).toISOString();

package/package.json

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