@operato/twin-kernel 0.7.86 → 0.7.87

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-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,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operato/twin-kernel",
-  "version": "0.7.86",
+  "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": {