@things-factory/headless-twin 10.1.45 → 10.1.46

package/dist-server/engine/checkpoint-fold.d.ts

@@ -0,0 +1,5 @@
+export declare function foldForCheckpoint(inst: {
+    mode?: 'sim' | 'live';
+    projector?: any;
+    kernel?: any;
+} | undefined): number;

package/dist-server/engine/checkpoint-fold.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.foldForCheckpoint = foldForCheckpoint;
+/*
+ * **체크포인트를 쓰기 직전에 끝난 오더를 접는다** — ADR-0092 결정 1.
+ *
+ * 커널은 스스로 접지 않는다. 접는 때를 체크포인트에 맞춰야 접힌 쪽이 씨앗과 같은 때에 적히고, 재기동 동치(`재개점 + 꼬리 ==
+ * 0부터 접기`)가 선다. 그래서 체크포인트를 쓰는 호스트가 부른다. 두 구동이 가진 커널이 다르다 — 미러는 `projector`(관측 모드
+ * 커널), 시뮬은 `kernel` 이다. 둘 중 그 구동의 것을 부르고, 접는 문이 없는 옛 커널이면 아무것도 하지 않는다.
+ */
+function foldForCheckpoint(inst) {
+    const k = inst?.mode === 'live' ? inst.projector : inst?.kernel;
+    if (typeof k?.foldFinishedOrders !== 'function')
+        return 0;
+    return Number(k.foldFinishedOrders()) || 0;
+}
+//# sourceMappingURL=checkpoint-fold.js.map

package/dist-server/engine/checkpoint-fold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-fold.js","sourceRoot":"","sources":["../../server/engine/checkpoint-fold.ts"],"names":[],"mappings":";;AAOA,8CAIC;AAXD;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAC,IAA0E;IAC1G,MAAM,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAA;IAC/D,IAAI,OAAO,CAAC,EAAE,kBAAkB,KAAK,UAAU;QAAE,OAAO,CAAC,CAAA;IACzD,OAAO,MAAM,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC,IAAI,CAAC,CAAA;AAC5C,CAAC","sourcesContent":["/*\n * **체크포인트를 쓰기 직전에 끝난 오더를 접는다** — ADR-0092 결정 1.\n *\n * 커널은 스스로 접지 않는다. 접는 때를 체크포인트에 맞춰야 접힌 쪽이 씨앗과 같은 때에 적히고, 재기동 동치(`재개점 + 꼬리 ==\n * 0부터 접기`)가 선다. 그래서 체크포인트를 쓰는 호스트가 부른다. 두 구동이 가진 커널이 다르다 — 미러는 `projector`(관측 모드\n * 커널), 시뮬은 `kernel` 이다. 둘 중 그 구동의 것을 부르고, 접는 문이 없는 옛 커널이면 아무것도 하지 않는다.\n */\nexport function foldForCheckpoint(inst: { mode?: 'sim' | 'live'; projector?: any; kernel?: any } | undefined): number {\n  const k = inst?.mode === 'live' ? inst.projector : inst?.kernel\n  if (typeof k?.foldFinishedOrders !== 'function') return 0\n  return Number(k.foldFinishedOrders()) || 0\n}\n"]}

package/dist-server/engine/twin-engine.js

@@ -46,6 +46,8 @@ const restart_policy_js_1 = require("./restart-policy.js");
 const kpi_query_js_1 = require("./kpi-query.js");
 const node_crypto_1 = require("node:crypto");
 const entity_delta_js_1 = require("@things-factory/headless-twin/dist-shared/entity-delta.js");
+const ops_contract_1 = require("@operato/ops-contract");
+const checkpoint_fold_js_1 = require("./checkpoint-fold.js");
 const load_meter_js_1 = require("./load-meter.js");
 const loop_lag_js_1 = require("./loop-lag.js");
 const touched_items_js_1 = require("@things-factory/headless-twin/dist-shared/touched-items.js");
@@ -56,7 +58,7 @@ const attention_digest_js_1 = require("./attention-digest.js");
 const live_feed_registry_js_1 = require("./live-feed-registry.js");
 const ingest_health_js_1 = require("./ingest-health.js");
 const ingest_dedupe_js_1 = require("./ingest-dedupe.js");
-const ops_contract_1 = require("@operato/ops-contract");
+const ops_contract_2 = require("@operato/ops-contract");
 /* 커널 런타임 로드 — CJS 번들(dist-cjs). 타입은 위 import type 로. replay = 이벤트열→상태 재구성(복구·시간여행). */
 const { WmsKernel, YmsKernel, MesKernel, EmsKernel, TwinRuntime, StateProjector, replay, replayFrom, replayWithCheckpoint, replaySegments } = require('@operato/twin-kernel');
 const { readBoardLocations, readBoardEquipment, DOMAIN_CATALOG, OP_EVENT, validateScenario } = require('@operato/ops-contract');
@@ -300,6 +302,8 @@ class TwinEngine {
          * 그것을 다시 `{revision, state}` 로 감싸 넣어 왔다 → 꺼낸 값에 축이 하나도 없어 웜스타트가
          * 알리지 않고 넘어갔다(저널에 수천 건이 있어도 트윈이 빈 채로 떴다).
          */
+        /* 끝난 오더를 접고 나서 상태를 뜬다 — 접힌 쪽이 이 체크포인트와 같은 때에 적힌다(ADR-0092 · `checkpoint-fold.ts`). */
+        (0, checkpoint_fold_js_1.foldForCheckpoint)(inst);
         const state = (0, warm_start_js_1.unwrapState)(this.snapshot(domainId, instanceId));
         if (!state)
             return;
@@ -1354,7 +1358,7 @@ class TwinEngine {
         if (!cached)
             return;
         const plan = (0, warm_start_js_1.planLiveContinuity)(cached);
-        if (!plan.ackedCount && !plan.attentionSinceCount && !plan.energy)
+        if (!plan.ackedCount && !plan.attentionSinceCount && !plan.energy && !plan.foldedOrders)
             return;
         if (typeof kernel.hydrateContinuity !== 'function') {
             (0, log_js_1.twinWarn)(`[twin-engine] kernel for "${id}" cannot carry continuity (no hydrateContinuity) — the open demand window, ` +
@@ -3255,7 +3259,7 @@ class TwinEngine {
              */
             if (model?.utcOffsetMinutes === undefined) {
                 for (const e of (model?.equipment ?? [])) {
-                    const hasProfile = (e?.properties ?? []).some(p => String(p?.id) === ops_contract_1.EMS_PROPERTY.genDailyProfile && String(p?.value ?? '').trim());
+                    const hasProfile = (e?.properties ?? []).some(p => String(p?.id) === ops_contract_2.EMS_PROPERTY.genDailyProfile && String(p?.value ?? '').trim());
                     if (hasProfile)
                         warnings.push((0, reference_master_js_3.generationWithoutTimeZone)(String(model?.spaceId ?? ''), String(e.id)));
                 }
@@ -3372,7 +3376,9 @@ class TwinEngine {
          * 그물이다** — 사건 없이 바뀌는 자리를 찾으면 그것을 고치는 것이 답이고 이 그물은 시간을 벌 뿐이다.
          */
         const full = inst.fullBroadcastDue === true || !inst.dirtyItems;
-        const deltas = (0, entity_delta_js_1.buildEntityDeltas)(st, inst.id, full ? undefined : { items: inst.dirtyItems });
+        /* 「최근 T 완료」의 T 는 모델의 선언이다(ADR-0092) — 커널이 불러올 때 이미 거절했으므로 여기 오는 값은 옳다. */
+        const fold = (0, ops_contract_1.orderFoldPolicyOf)(inst.model?.orderFold);
+        const deltas = (0, entity_delta_js_1.buildEntityDeltas)(st, inst.id, full ? undefined : { items: inst.dirtyItems }, 'policy' in fold ? fold.policy : undefined);
         this.broadcastPasses++;
         if (full)
             this.broadcastFullPasses++;