/**
 * 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'
  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.',
    atMs: Date.now()
  }
}