triflux 10.41.1 → 10.43.0

package/hub/lib/timeout-defaults.mjs

@@ -0,0 +1,45 @@
+// hub 조율 평면 타임아웃/TTL의 단일 기준값. 환경은 호출 시점에 읽는다.
+
+export const MIN_DURATION_MS = 1_000;
+export const MAX_DURATION_MS = 86_400_000;
+export const DEFAULT_ASSIGN_TIMEOUT_MS = 600_000;
+export const DEFAULT_ASSIGN_TTL_MS = 600_000;
+export const DEFAULT_HANDOFF_TTL_MS = 600_000;
+export const DEFAULT_SWARM_LOCK_TTL_MS = 600_000;
+export const DEFAULT_REGISTER_TIMEOUT_SEC = 600;
+export const REGISTER_HEARTBEAT_GRACE_MS = 120_000;
+export const DEFAULT_STALL_INTERVENTION_SEC = 1_200;
+export const DEFAULT_HARD_CEILING_SEC = 21_600;
+
+function readEnvSeconds(env, name, fallbackSec) {
+  const value = Number(env?.[name]);
+  return Number.isFinite(value) && value > 0 ? Math.trunc(value) : fallbackSec;
+}
+
+export function resolveStallInterventionMs(env = process.env) {
+  return (
+    readEnvSeconds(env, "TFX_STALL_THRESHOLD", DEFAULT_STALL_INTERVENTION_SEC) *
+    1000
+  );
+}
+
+export function resolveHardCeilingMs(env = process.env) {
+  return (
+    readEnvSeconds(env, "TFX_HARD_CEILING_SEC", DEFAULT_HARD_CEILING_SEC) * 1000
+  );
+}
+
+export function resolveWorkerLeaseTtlMs(env = process.env) {
+  return resolveStallInterventionMs(env) + REGISTER_HEARTBEAT_GRACE_MS;
+}
+
+export function clampDurationMs(
+  value,
+  fallback = DEFAULT_ASSIGN_TIMEOUT_MS,
+  min = MIN_DURATION_MS,
+  max = MAX_DURATION_MS,
+) {
+  const numeric = Number(value);
+  if (!Number.isFinite(numeric)) return fallback;
+  return Math.max(min, Math.min(Math.trunc(numeric), max));
+}

package/hub/lib/worker-lifecycle.mjs

@@ -0,0 +1,101 @@
+// 활동 기반 워커 lifecycle. 시간 기본값은 timeout-defaults SSOT에서만 가져온다.
+import {
+  resolveHardCeilingMs,
+  resolveStallInterventionMs,
+} from "./timeout-defaults.mjs";
+
+export { resolveHardCeilingMs, resolveStallInterventionMs };
+
+export function isActivityLifecycleEnabled(env = process.env) {
+  return env.TFX_ACTIVITY_LIFECYCLE !== "0";
+}
+
+/**
+ * 활동 신호를 기준으로 무활동 개입과 절대 상한을 판정한다.
+ * 호출자는 observe()에 자기 채널의 기존 활동 서명을 전달하고, check()에
+ * 개입 대상 문맥을 제공한다. 이 모듈은 신호를 생성하거나 개입을 실행하지 않는다.
+ */
+export function createActivityLifecycle({
+  enabled = isActivityLifecycleEnabled(),
+  interventionMs = resolveStallInterventionMs(),
+  hardCeilingMs = resolveHardCeilingMs(),
+  maxInterventions = 1,
+  onIntervene,
+  now = Date.now,
+} = {}) {
+  const startedAt = now();
+  let lastActivityAt = startedAt;
+  let lastSignature;
+  let hasSignature = false;
+  let interventions = 0;
+  let timeoutReason = "";
+  let pendingIntervention = null;
+
+  const markActivity = () => {
+    lastActivityAt = now();
+  };
+
+  async function intervene(context = {}) {
+    if (!enabled || typeof onIntervene !== "function") return false;
+    if (interventions >= maxInterventions || pendingIntervention) return false;
+
+    interventions += 1;
+    const inactiveMs = Math.max(0, now() - lastActivityAt);
+    pendingIntervention = Promise.resolve(
+      onIntervene({ ...context, inactiveMs, interventions }),
+    )
+      .then((handled) => handled === true)
+      .catch(() => false);
+    try {
+      const handled = await pendingIntervention;
+      if (handled) markActivity();
+      return handled;
+    } finally {
+      pendingIntervention = null;
+    }
+  }
+
+  return Object.freeze({
+    observe(...args) {
+      if (!enabled) return false;
+      const [signature] = args;
+      const changed =
+        args.length === 0 || !hasSignature || signature !== lastSignature;
+      if (changed) {
+        lastSignature = signature;
+        hasSignature = true;
+        markActivity();
+      }
+      return changed;
+    },
+    async check(context = {}) {
+      if (!enabled || timeoutReason) return timeoutReason;
+      const current = now();
+      if (current - startedAt >= hardCeilingMs) {
+        timeoutReason = "hard_ceiling";
+        return timeoutReason;
+      }
+      if (current - lastActivityAt < interventionMs || pendingIntervention)
+        return "";
+      if (await intervene(context)) return "";
+      timeoutReason = "inactivity";
+      return timeoutReason;
+    },
+    intervene,
+    get enabled() {
+      return enabled;
+    },
+    get hardCeilingMs() {
+      return hardCeilingMs;
+    },
+    get interventionMs() {
+      return interventionMs;
+    },
+    get interventions() {
+      return interventions;
+    },
+    get timeoutReason() {
+      return timeoutReason;
+    },
+  });
+}