Orginize

2026-08-18 18:11:28 -04:00
parent 0e9a650fa2
commit bbaf47028f
259 changed files with 0 additions and 0 deletions
@@ -0,0 +1,49 @@
+/**
+ * Swarm session lifecycle labels for operators (non-authoritative; driven by env + peer count).
+ * @param {Record<string, unknown> | null | undefined} env
+ * @param {number} peerCount
+ */
+export function bareOsSwarmLifecycleSnapshot(env, peerCount) {
+  const peers = Math.max(0, Math.floor(peerCount))
+  const syncing =
+    env &&
+    (env.BARE_OS_SWARM_SYNCING === '1' || env.BARE_OS_SWARM_SYNCING === 'true')
+  const degraded =
+    env &&
+    (env.BARE_OS_SWARM_DEGRADED === '1' || env.BARE_OS_SWARM_DEGRADED === 'true')
+  /** @type {'discovering' | 'syncing' | 'steady' | 'degraded'} */
+  let state = 'steady'
+  if (degraded) state = 'degraded'
+  else if (syncing) state = 'syncing'
+  else if (peers === 0) state = 'discovering'
+
+  /** @type {number | undefined} */
+  let dhtActiveQueries
+  /** @type {number | undefined} */
+  let udxEphemeralPort
+  const raw = env && env.BARE_OS_HYPERDHT_STATS_JSON
+  if (raw != null && String(raw).trim()) {
+    try {
+      const j = JSON.parse(String(raw))
+      if (typeof j.activeQueries === 'number') dhtActiveQueries = j.activeQueries
+      if (typeof j.udpPort === 'number') udxEphemeralPort = j.udpPort
+    } catch {
+      /* ignore invalid operator JSON */
+    }
+  }
+
+  return {
+    schema: 1,
+    state,
+    peerCount: peers,
+    note:
+      'Lifecycle is derived from BARE_OS_SWARM_* env hints and live peer count; host may override via env.',
+    hyperdhtSketch: {
+      schema: 1,
+      note: 'Capped non-secret hints from BARE_OS_HYPERDHT_STATS_JSON when the host sets it.',
+      dhtActiveQueries,
+      udxEphemeralPort
+    },
+    atMs: Date.now()
+  }
+}