@steve02081504/fount-p2p 0.0.26 → 0.0.28

package/overlay/index.mjs

@@ -15,7 +15,7 @@ let overlayRateGate = null
  * @returns {void}
  */
 export function setOverlayRateGate(rateGate) {
-	overlayRateGate = typeof rateGate === 'function' ? rateGate : null
+	overlayRateGate = rateGate || null
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@steve02081504/fount-p2p",
-	"version": "0.0.26",
+	"version": "0.0.28",
 	"description": "fount federation P2P layer — link, trust graph, mailbox, DAG, EVFS.",
 	"keywords": [
 		"network",

package/registries/event_type.mjs

@@ -15,7 +15,7 @@ const defsByOwner = new Map()
  * @returns {void}
  */
 export function registerEventTypeDefs(ownerId, defs) {
-	defsByOwner.set(String(ownerId), defs)
+	defsByOwner.set(ownerId, defs)
 }
 
 /**
@@ -23,7 +23,7 @@ export function registerEventTypeDefs(ownerId, defs) {
  * @returns {void}
  */
 export function unregisterEventTypeDefs(ownerId) {
-	defsByOwner.delete(String(ownerId))
+	defsByOwner.delete(ownerId)
 }
 
 /** @returns {void} */

package/registries/room_provider.mjs

@@ -21,7 +21,7 @@ const providers = new Map()
  * @returns {void}
  */
 export function registerFederationRoomProvider(ownerId, enumerateRooms) {
-	providers.set(String(ownerId), enumerateRooms)
+	providers.set(ownerId, enumerateRooms)
 }
 
 /**
@@ -29,7 +29,7 @@ export function registerFederationRoomProvider(ownerId, enumerateRooms) {
  * @returns {void}
  */
 export function unregisterFederationRoomProvider(ownerId) {
-	providers.delete(String(ownerId))
+	providers.delete(ownerId)
 }
 
 /**

package/reputation/engine.mjs

@@ -1,6 +1,8 @@
 /**
  * 信誉纯内存算子（模拟器与磁盘 store 共用）。
  */
+import { normalizeHex64 } from '../core/hexIds.mjs'
+
 import {
 	clampReputationScore,
 	computeRepMaxEff,
@@ -176,9 +178,9 @@ export function pruneReputationFile(data, tunables = reputationTunables, now = D
  * @returns {boolean} 是否已加分
  */
 export function bumpReputationOnRelayPure(data, peerNodeHash, dedupeKey, now = Date.now(), tunables = reputationTunables) {
-	const id = String(peerNodeHash || '').trim()
+	const id = normalizeHex64(peerNodeHash)
 	if (!id) return false
-	const key = String(dedupeKey || `conn:${id}`).trim()
+	const key = dedupeKey || `conn:${id}`
 	data.relayBumpSeen = data.relayBumpSeen.filter(hit => now - hit.t <= tunables.relayBumpDedupeMs)
 	if (relayBumpIsDuplicate(data.relayBumpSeen, id, key, now, tunables.relayBumpDedupeMs)) return false
 	data.relayBumpSeen.push({ peerNodeHash: id, key, t: now })
@@ -213,7 +215,7 @@ export function recordGossipAllUnknownWantPure(data, peerNodeHash, now = Date.no
  * @returns {void}
  */
 export function recordMessageRateViolationPure(data, peerNodeHash, tunables = reputationTunables, excessRatio = 1) {
-	const id = String(peerNodeHash || '').trim()
+	const id = normalizeHex64(peerNodeHash)
 	if (!id) return
 	const ratio = Math.max(0, Math.min(1, Number(excessRatio) || 0))
 	if (ratio <= 0) return
@@ -227,7 +229,7 @@ export function recordMessageRateViolationPure(data, peerNodeHash, tunables = re
  * @returns {void}
  */
 export function bumpChunkStorageReputationPure(data, storagePeerKey, tunables = reputationTunables) {
-	const id = String(storagePeerKey || '').trim()
+	const id = normalizeHex64(storagePeerKey)
 	if (!id) return
 	adjustNodeReputation(data, id, tunables.chunkStoreRepBump)
 }
@@ -239,7 +241,7 @@ export function bumpChunkStorageReputationPure(data, storagePeerKey, tunables =
  * @returns {void}
  */
 export function penalizeChunkStorageFailurePure(data, blamePeerKey, tunables = reputationTunables) {
-	const id = String(blamePeerKey || '').trim()
+	const id = normalizeHex64(blamePeerKey)
 	if (!id) return
 	adjustNodeReputation(data, id, -tunables.chunkFetchFailPenalty)
 }
@@ -251,7 +253,7 @@ export function penalizeChunkStorageFailurePure(data, blamePeerKey, tunables = r
  * @returns {void}
  */
 export function penalizeArchiveServeMismatchPure(data, peerNodeHash, tunables = reputationTunables) {
-	const id = String(peerNodeHash || '').trim()
+	const id = normalizeHex64(peerNodeHash)
 	if (!id) return
 	adjustNodeReputation(data, id, -tunables.archiveServeMismatchPenalty)
 }
@@ -280,7 +282,7 @@ export function applySubjectiveSlashPure(data, target, sender, claim, verified,
  * @returns {Array<{ hop: number, node: string, dRep: number }>} 已应用的上游惩罚
  */
 export function applyDecayCollusionAfterSlashPure(data, targetPubKeyHash, inviteEdges, tunables = reputationTunables) {
-	const target = targetPubKeyHash.trim().toLowerCase()
+	const target = normalizeHex64(targetPubKeyHash)
 	/** @type {Array<{ hop: number, node: string, dRep: number }>} */
 	const applied = []
 	let frontier = new Set([target])
@@ -301,8 +303,8 @@ export function applyDecayCollusionAfterSlashPure(data, targetPubKeyHash, invite
 	for (let hop = 1; hop <= effectiveMaxHop(); hop++) {
 		const upstream = new Set()
 		for (const edge of inviteEdges) {
-			const to = String(edge.to ?? '').trim().toLowerCase()
-			const from = String(edge.from ?? '').trim().toLowerCase()
+			const to = normalizeHex64(edge.to)
+			const from = normalizeHex64(edge.from)
 			if (frontier.has(to) && from) upstream.add(from)
 		}
 		if (!upstream.size) break
@@ -331,7 +333,7 @@ export function applyDecayCollusionAfterSlashPure(data, targetPubKeyHash, invite
  * @returns {void}
  */
 export function applyReputationResetToScoresPure(data, targetPubKeyHash) {
-	const t = targetPubKeyHash.trim().toLowerCase()
+	const t = normalizeHex64(targetPubKeyHash)
 	const row = repRow(data, t)
 	row.score = 0
 	delete row.offenseStreak
@@ -351,8 +353,8 @@ export function applyReputationResetToScoresPure(data, targetPubKeyHash) {
  * @returns {void}
  */
 export function seedMemberReputationFromIntroducerPure(data, memberPubKeyHash, introducerPubKeyHash, repEdge, tunables = reputationTunables, powBonus = 0) {
-	const memberKey = memberPubKeyHash.trim().toLowerCase()
-	const introducerKey = introducerPubKeyHash?.trim().toLowerCase() || ''
+	const memberKey = normalizeHex64(memberPubKeyHash)
+	const introducerKey = normalizeHex64(introducerPubKeyHash)
 	if (data.byNodeHash[memberKey]) return
 	const introducerReputation = introducerKey
 		? Number(data.byNodeHash[introducerKey]?.score ?? 0)
@@ -392,7 +394,7 @@ function baselineRow(row) {
  * @returns {{ z: number, anomaly: boolean }} 偏离度
  */
 export function observeBehaviorSamplePure(data, peerNodeHash, sample, now = Date.now(), tunables = reputationTunables) {
-	const id = String(peerNodeHash || '').trim()
+	const id = normalizeHex64(peerNodeHash)
 	if (!id) return { z: 0, anomaly: false }
 	const row = repRow(data, id)
 	const baseline = baselineRow(row)
@@ -427,7 +429,7 @@ export function observeBehaviorSamplePure(data, peerNodeHash, sample, now = Date
  * @returns {void}
  */
 export function applyQuarantinePure(data, peerNodeHash, now = Date.now(), tunables = reputationTunables) {
-	const id = String(peerNodeHash || '').trim()
+	const id = normalizeHex64(peerNodeHash)
 	if (!id) return
 	const row = repRow(data, id)
 	row.quarantinedUntil = now + Number(tunables.quarantineTtlMs ?? 900_000)
@@ -441,7 +443,7 @@ export function applyQuarantinePure(data, peerNodeHash, now = Date.now(), tunabl
  * @returns {boolean} 是否处于本地隔离
  */
 export function isQuarantinedPure(data, peerNodeHash, now = Date.now()) {
-	const id = String(peerNodeHash || '').trim()
+	const id = normalizeHex64(peerNodeHash)
 	const until = Number(data.byNodeHash?.[id]?.quarantinedUntil ?? 0)
 	return Number.isFinite(until) && until > now
 }

package/schemas/discovery.mjs

@@ -9,9 +9,9 @@ const MAX_DISCOVERY_ADS = 64
  */
 function sanitizeDiscoveryAdvertisement(ad) {
 	if (!isPlainObject(ad)) return null
-	const groupId = String(ad.groupId || '').trim()
+	const groupId = String(ad.groupId || '')
 	const advertiserPubKeyHash = normalizeHex64(ad.advertiserPubKeyHash)
-	const signature = String(ad.signature || '').trim().toLowerCase()
+	const signature = String(ad.signature || '')
 	if (!groupId || !isHex64(advertiserPubKeyHash) || !isSignatureHex128(signature)) return null
 	const advertiserNodeHash = normalizeHex64(ad.advertiserNodeHash)
 	const body = {
@@ -19,7 +19,7 @@ function sanitizeDiscoveryAdvertisement(ad) {
 		title: String(ad.title || '').slice(0, 200),
 		blurb: String(ad.blurb || '').slice(0, 500),
 		advertiserPubKeyHash,
-		advertiserNodeHash: isHex64(advertiserNodeHash) ? advertiserNodeHash : String(ad.advertiserNodeHash || '').trim(),
+		advertiserNodeHash: isHex64(advertiserNodeHash) ? advertiserNodeHash : String(ad.advertiserNodeHash || ''),
 		observedAt: Number(ad.observedAt) || 0,
 		signature,
 	}
@@ -47,10 +47,10 @@ export function assertDiscoveryNodeHash(nodeHash) {
 
 /**
  * @param {unknown} requestId 请求 id
- * @returns {string} 非空 trimmed 字符串
+ * @returns {string} 非空字符串
  */
 export function assertDiscoveryRequestId(requestId) {
-	const id = String(requestId ?? '').trim()
+	const id = String(requestId ?? '')
 	if (!id) throw new Error('discovery.requestId required')
 	return id
 }

package/schemas/federation_pull.mjs

@@ -14,7 +14,7 @@ const ENVELOPE_BLOB_MIN_LEN = 2
  * @returns {boolean} 是否像合法 ECIES blob 段
  */
 function isEnvelopeBlob(value) {
-	return String(value ?? '').trim().length >= ENVELOPE_BLOB_MIN_LEN
+	return String(value ?? '').length >= ENVELOPE_BLOB_MIN_LEN
 }
 
 /**
@@ -24,14 +24,14 @@ function isEnvelopeBlob(value) {
 export function parsePullAttestation(attestation) {
 	if (!isPlainObject(attestation)) return null
 	const requesterPubKeyHash = normalizeHex64(attestation.requesterPubKeyHash)
-	const groupId = String(attestation.groupId || '').trim()
-	const requestId = String(attestation.requestId || '').trim()
+	const groupId = String(attestation.groupId || '')
+	const requestId = String(attestation.requestId || '')
 	const timestamp = Number(attestation.timestamp)
-	const signature = String(attestation.signature || '').trim().toLowerCase()
+	const signature = String(attestation.signature || '')
 	if (!isHex64(requesterPubKeyHash) || !groupId || !Number.isFinite(timestamp) || !isSignatureHex128(signature))
 		return null
 	const wantIds = attestation.wantIds?.length
-		? [...new Set(attestation.wantIds.map(id => id.trim().toLowerCase()).filter(id => EVENT_ID_HEX.test(id)))]
+		? [...new Set(attestation.wantIds.map(id => normalizeHex64(id)).filter(id => EVENT_ID_HEX.test(id)))]
 		: undefined
 	return {
 		requesterPubKeyHash,
@@ -49,13 +49,13 @@ export function parsePullAttestation(attestation) {
  */
 export function parsePullResponseEnvelope(envelope) {
 	if (!isPlainObject(envelope)) return null
-	const requestId = String(envelope.requestId || '').trim()
+	const requestId = String(envelope.requestId || '')
 	const requesterPubKeyHash = normalizeHex64(envelope.requesterPubKeyHash)
-	const requesterNodeHash = String(envelope.requesterNodeHash || '').trim()
-	const ephemPub = String(envelope.ephemPub || '').trim()
-	const iv = String(envelope.iv || '').trim()
-	const ciphertext = String(envelope.ciphertext || '').trim()
-	const authTag = String(envelope.authTag || '').trim()
+	const requesterNodeHash = String(envelope.requesterNodeHash || '')
+	const ephemPub = String(envelope.ephemPub || '')
+	const iv = String(envelope.iv || '')
+	const ciphertext = String(envelope.ciphertext || '')
+	const authTag = String(envelope.authTag || '')
 	if (!requestId || !isHex64(requesterPubKeyHash) || !requesterNodeHash) return null
 	if (!isEnvelopeBlob(ephemPub) || !isEnvelopeBlob(iv) || !isEnvelopeBlob(ciphertext) || !isEnvelopeBlob(authTag))
 		return null
@@ -76,27 +76,19 @@ export function parsePullResponseEnvelope(envelope) {
  */
 export function parseJoinSnapshotRequest(data) {
 	if (!isPlainObject(data)) return null
-	const requestId = String(data.requestId || '').trim()
-	const requesterNodeHash = String(data.requesterNodeHash || '').trim()
-	const groupId = String(data.groupId || '').trim()
+	const requestId = String(data.requestId || '')
+	const requesterNodeHash = String(data.requesterNodeHash || '')
+	const groupId = String(data.groupId || '')
 	const attestation = parsePullAttestation(data.attestation)
 	if (!requestId || !requesterNodeHash || !groupId || !attestation) return null
 	if (attestation.groupId !== groupId || attestation.requestId !== requestId) return null
-	const tipsHash = String(data.tipsHash || '').trim()
+	const tipsHash = String(data.tipsHash || '')
 	return {
 		requestId,
 		requesterNodeHash,
 		requesterPubKeyHash: attestation.requesterPubKeyHash,
 		groupId,
-		tipsHash: tipsHash ? tipsHash.toLowerCase() : undefined,
+		tipsHash: tipsHash || undefined,
 		attestation,
 	}
 }
-
-/**
- * @param {unknown} data 入群快照响应载荷
- * @returns {object | null} 解析结果
- */
-export function parseJoinSnapshotResponse(data) {
-	return parsePullResponseEnvelope(data)
-}

package/schemas/part_query.mjs

@@ -82,10 +82,10 @@ const REQUEST_ID_MAX_LENGTH = 128
 
 /**
  * @param {unknown} value 原始 requestId
- * @returns {string | null} 修剪后的 requestId；非法 null
+ * @returns {string | null} 合法 requestId；非法 null
  */
 function normalizeRequestId(value) {
-	const requestId = String(value || '').trim()
+	const requestId = String(value || '')
 	if (!requestId || requestId.length > REQUEST_ID_MAX_LENGTH) return null
 	return requestId
 }
@@ -103,7 +103,7 @@ export function parsePartQueryReq(value, tunables = partQueryTunables) {
 	if (!isHex64(originNodeHash)) return null
 	const partpath = parsePartpath(value.partpath)
 	if (!partpath) return null
-	const kind = String(value.kind || '').trim()
+	const kind = String(value.kind || '')
 	if (!kind) return null
 	if (!Object.prototype.hasOwnProperty.call(value, 'query')) return null
 	if (measureJsonBytes(value.query) > (tunables.maxQueryBytes ?? 2048)) return null
@@ -145,7 +145,7 @@ export function parsePartQueryRes(value, tunables = partQueryTunables) {
  */
 export function normalizePartQueryCacheMaterial(partpath, kind, query) {
 	const path = parsePartpath(partpath)
-	const k = String(kind || '').trim()
+	const k = String(kind || '')
 	if (!path || !k) return null
 	if (measureJsonBytes(query) > partQueryTunables.maxQueryBytes) return null
 	try {

package/timeline/verify_remote.mjs

@@ -3,7 +3,7 @@
  */
 import { Buffer } from 'node:buffer'
 
-import { isHex64, isSignatureHex128 } from '../core/hexIds.mjs'
+import { isHex64, isSignatureHex128, normalizeHex64 } from '../core/hexIds.mjs'
 import { pubKeyHash, verify } from '../crypto/crypto.mjs'
 import { eventBodyForSign, signPayloadBytes } from '../dag/index.mjs'
 
@@ -12,11 +12,11 @@ import { eventBodyForSign, signPayloadBytes } from '../dag/index.mjs'
  * @returns {Promise<boolean>} 验签是否通过
  */
 export async function verifyTimelineRemoteSignature(event) {
-	const sender = String(event?.sender || '').trim().toLowerCase()
+	const sender = normalizeHex64(event?.sender)
 	if (!isHex64(sender)) return false
-	const signatureHex = String(event?.signature || '').trim()
+	const signatureHex = String(event?.signature || '')
 	if (!isSignatureHex128(signatureHex)) return false
-	const pubKeyHex = String(event?.senderPubKey || '').trim().toLowerCase()
+	const pubKeyHex = normalizeHex64(event?.senderPubKey)
 	if (!isHex64(pubKeyHex)) return false
 	const publicKeyBytes = new Uint8Array(Buffer.from(pubKeyHex, 'hex'))
 	if (pubKeyHash(publicKeyBytes) !== sender) return false

package/transport/group_link_set.mjs

@@ -30,7 +30,7 @@ export function createGroupLinkSet(options) {
 	const allowNode = options.allowNode ?? (() => true)
 	const { groupId } = options
 	const scope = options.scope ?? `group:${groupId}`
-	const roomSecret = options.roomSecret
+	const { roomSecret } = options
 	const members = new Set(options.members || [])
 	const selfNodeHash = registry.localIdentity.nodeHash
 	const groupSettings = options.groupSettings ?? {}
@@ -59,7 +59,7 @@ export function createGroupLinkSet(options) {
 	 * @returns {void}
 	 */
 	function registerCleanup(cleanup) {
-		if (typeof cleanup !== 'function') return
+		if (!cleanup) return
 		cleanups.add(cleanup)
 	}
 
@@ -182,7 +182,7 @@ export function createGroupLinkSet(options) {
 		}
 		started = true
 		active = true
-		if (typeof registry.ensureRuntime === 'function')
+		if (registry.ensureRuntime)
 			await registry.ensureRuntime()
 		registry.registerScopeInterest(scope, [...members])
 		registerCleanup(registry.subscribeScope(scope, (senderNodeHash, envelope) => {

package/transport/ice_servers.mjs

@@ -27,8 +27,8 @@ function normalizeIceEntry(raw) {
 	if (!raw || typeof raw !== 'object') return null
 	const urlsRaw = raw.urls
 	const urlsList = Array.isArray(urlsRaw)
-		? urlsRaw.map(u => String(u).trim()).filter(Boolean)
-		: [String(urlsRaw || '').trim()].filter(Boolean)
+		? urlsRaw.map(u => String(u || '')).filter(Boolean)
+		: [String(urlsRaw || '')].filter(Boolean)
 	if (!urlsList.length) return null
 	for (const u of urlsList)
 		if (!ICE_URL_RE.test(u)) return null

package/transport/link_registry.mjs

@@ -17,6 +17,7 @@ import { createLruMap } from '../utils/lru.mjs'
 import { DEFAULT_ICE_SERVERS } from './ice_servers.mjs'
 import { createMeshKeepalive } from './mesh_keepalive.mjs'
 import { createOfferAnswerDial } from './offer_answer.mjs'
+import { createPeerHealthTracker } from './peer_health.mjs'
 import { pickMeshEvictionVictim } from './peer_pool.mjs'
 import { createRuntimeBootstrap } from './runtime_bootstrap.mjs'
 
@@ -293,14 +294,14 @@ export function createLinkRegistry(options = {}) {
 			const providers = listLinkProviders()
 			for (const provider of providers)
 				try {
-					if (typeof provider.canReach === 'function') {
+					if (provider.canReach) {
 						const reachable = await Promise.resolve(provider.canReach({ nodeHash: normalized }))
 						if (!reachable) {
 							nodeDebug('p2p:dial skip', { peer: shortHash(normalized), provider: provider.id, reason: 'canReach=false' })
 							continue
 						}
 					}
-					if (typeof provider.isAvailable === 'function') {
+					if (provider.isAvailable) {
 						const available = await Promise.resolve(provider.isAvailable())
 						if (!available) {
 							nodeDebug('p2p:dial skip', { peer: shortHash(normalized), provider: provider.id, reason: 'isAvailable=false' })
@@ -470,17 +471,6 @@ export function createLinkRegistry(options = {}) {
 			|| await relayEnvelopeToNode(remoteNodeHash, envelope)
 	}
 
-	/**
-	 * 同步结果直接返回；thenable 才 await（避免每条 envelope 造 microtask）。
-	 * @param {unknown} value 可能为 Promise 的返回值
-	 * @returns {Promise<unknown>} 已 resolve 的值
-	 */
-	async function maybeAwait(value) {
-		if (value != null && typeof /** @type {{ then?: unknown }} */ value.then === 'function')
-			return await value
-		return value
-	}
-
 	/**
 	 * 将入站 envelope 派发到 scope 监听器（经 authorizer 校验）。
 	 * @param {string} senderNodeHash 发送方节点 64 hex
@@ -489,16 +479,15 @@ export function createLinkRegistry(options = {}) {
 	 * @returns {Promise<void>}
 	 */
 	async function dispatchEnvelope(senderNodeHash, envelope, link) {
-		const scope = envelope.scope || ''
+		const { scope } = envelope
 		for (const [prefix, authorizer] of scopeAuthorizers.entries())
-			if (scope.startsWith(prefix)) {
-				const allowed = await maybeAwait(authorizer(scope, senderNodeHash, envelope, link))
-				if (!allowed) return
-			}
+			if (scope.startsWith(prefix))
+				if (!await authorizer(scope, senderNodeHash, envelope, link)) return
+
 		for (const [prefix, listeners] of scopeListeners.entries())
 			if (scope.startsWith(prefix))
 				for (const listener of listeners)
-					await maybeAwait(listener(senderNodeHash, envelope, link))
+					await listener(senderNodeHash, envelope, link)
 	}
 
 	/**
@@ -522,6 +511,25 @@ export function createLinkRegistry(options = {}) {
 		return () => scopeAuthorizers.delete(prefix)
 	}
 
+	const peerHealth = createPeerHealthTracker({
+		/**
+		 * @param {(nodeHash: string, link: unknown) => void} listener link up 回调
+		 * @returns {() => void} 取消订阅
+		 */
+		onLinkUp: listener => {
+			linkUpListeners.add(listener)
+			return () => linkUpListeners.delete(listener)
+		},
+		/**
+		 * @param {(nodeHash: string) => void} listener link down 回调
+		 * @returns {() => void} 取消订阅
+		 */
+		onLinkDown: listener => {
+			linkDownListeners.add(listener)
+			return () => linkDownListeners.delete(listener)
+		},
+	})
+
 	return {
 		localIdentity,
 		buildLocalAdvert: bootstrap.buildLocalAdvert,
@@ -567,7 +575,7 @@ export function createLinkRegistry(options = {}) {
 		 * @returns {void}
 		 */
 		setPriorityWeightFunction(weightFunction) {
-			priorityWeightFunction = typeof weightFunction === 'function' ? weightFunction : null
+			priorityWeightFunction = weightFunction || null
 		},
 		/**
 		 * @param {string} nodeHash - 节点 64-hex hash
@@ -641,6 +649,22 @@ export function createLinkRegistry(options = {}) {
 		},
 		registerScopeAuthorizer,
 		subscribeScope,
+		/**
+		 * 获取指定邻居的健康记录。
+		 * @param {string} nodeHash 节点 64 hex
+		 * @returns {import('./peer_health.mjs').PeerHealthEntry | null} 健康记录；无记录时 null
+		 */
+		getPeerHealth: peerHealth.getPeerHealth,
+		/**
+		 * @returns {import('./peer_health.mjs').PeerHealthEntry[]} 所有邻居健康记录
+		 */
+		listPeerHealth: peerHealth.listPeerHealth,
+		/**
+		 * 订阅邻居健康变化。
+		 * @param {(nodeHash: string, entry: import('./peer_health.mjs').PeerHealthEntry) => void} listener 回调
+		 * @returns {() => void} 取消订阅
+		 */
+		onPeerHealth: peerHealth.onPeerHealth,
 		/**
 		 * 监听指定节点的 advert（per-hash，无 topic）。
 		 * @param {string} nodeHash 目标节点 64 hex
@@ -664,6 +688,7 @@ export function createLinkRegistry(options = {}) {
 		 */
 		async shutdown() {
 			await meshKeepalive?.stop()
+			peerHealth.stop()
 			setDiscoveryLinkDialer(null)
 			setDiscoveryPeerClueListener(null)
 			await bootstrap.shutdown()
@@ -756,6 +781,12 @@ export const registerScopeInterest = bindRegistryMethod('registerScopeInterest')
 export const releaseScopeInterest = bindRegistryMethod('releaseScopeInterest')
 /** @type {(...methodArguments: unknown[]) => unknown} */
 export const subscribeScope = bindRegistryMethod('subscribeScope')
+/** @type {(...methodArguments: unknown[]) => unknown} */
+export const getPeerHealth = bindRegistryMethod('getPeerHealth')
+/** @type {(...methodArguments: unknown[]) => unknown} */
+export const listPeerHealth = bindRegistryMethod('listPeerHealth')
+/** @type {(...methodArguments: unknown[]) => unknown} */
+export const onPeerHealth = bindRegistryMethod('onPeerHealth')
 
 /**
  * 注册默认 registry 的 scope authorizer。

package/transport/mesh_keepalive.mjs

@@ -21,7 +21,7 @@ const INTENTIONAL_CLOSE = new Set([
  * @returns {boolean} 是否为本机主动关链（不重拨）
  */
 export function isMeshIntentionalClose(reason) {
-	return INTENTIONAL_CLOSE.has(String(reason || ''))
+	return INTENTIONAL_CLOSE.has(reason || '')
 }
 
 /**

package/transport/node_scope/wire.mjs

@@ -103,7 +103,7 @@ export function getNodeScopeContext() {
  */
 export function ensureNodeScope(options = {}) {
 	if (options.replicaUsername != null)
-		nodeScopeContext.replicaUsername = String(options.replicaUsername)
+		nodeScopeContext.replicaUsername = options.replicaUsername
 	if (nodeScopeSubscribeCleanup) return nodeScopeSubscribeCleanup
 	nodeScopeSubscribeCleanup = subscribeScope('node', (senderNodeHash, envelope) => {
 		const handlers = nodeActionHandlers.get(envelope.action)