dsh-whale-post-deliver

投递策略：离线留在信箱等人／在线立刻投出（★可换的挂点 —— 示例①）

• 提供接口：whale.deliver
• 依赖接口：whale.roster（★可选 —— 用不到就不取 ✓）
• 自测：node selftest.mjs（只看退出码：0 过／非 0 不过）

接口带 apiVersion；核心不认识任何成员名与类型标识 —— 名单与类型一律从接口取。

它只回答一个问题（★别让它管别的 ✗）

★★ 这封信现在投进对方的会话，还是留在信箱里等人？ ✗✓ —— 三态：

返回	什么时候
'delivered'	★在线件，且对方有活体会话 ⇒ 真投出去了 ✓
'kept'	★离线件 ✓；★或在线件但对方没有活体会话 ⇒ 不投也不消费 ✓
'rejected'	★收件人在 blocked 名单里 ⇒ 信不进它的信箱 ✓

接口

方法	一句话
deliver(letter, ctx)	★就是上面那个问题的答案；★ctx.targets 由核心给（组已展开 ✓）
blocked(id)	★这个收件人被明确挡掉了吗 ✓
sessionOf(id)	★那个会话此刻活着吗（★就是下面那个探针 ✓）
★★dormancyOf(id) ✗	★★{ state, days, lastMs, source } —— ★谁还醒着 ✓（见下"休眠判定"✓）
log	★判定留痕（自测与排障用 ✓）

★★休眠判定（S10 v2 —— 2026-10-10 从缸里正本移植 ✗✓）

★★ v1 的教训（★正本原话 ✗） ✗：★「不许拿「邮差还活着」当「它在读信」 ✗ —— ★真局一照就穿帮：小毛咪的邮差每 10 分钟替她续 hello，可她本人不读信（★量到的是邮差，不是她 ✗）」✓✓

★所以判定走两路，★都带 source，不许把推断说成声明 ✗：

路	依据	source
★① 明示位	★配置给的 declaredDormant(id) / 名单里那个标记 ✓	★'declared' ✓
★★② 推断 ✗✓	★★它信箱里最老的一封没读的信，躺了多久 ✓ —— ★这才是"没读信"的明证 ✓	★'inferred' ✓

★★ 四档状态 ✗：★awake（dormantSoftDays 以内 ✓）／★quiet（soft～hard ✓）／★dormant（≥ hard ✓）／ ★★★ unknown ✗✓ —— ★★ "我们不知道" ✓ —— ★不是"它休眠" ✗✓

★★ 两条硬纪律 ✗✓：

1. ★★★ 没有积压 ⇒ 不许判休眠 ✗✓（★"没信可读 ≠ 不读信" ✓ —— 所以才会是 unknown ✓）
2. ★★ 只用落盘 mtime ✓（★不信内容里的时间戳 —— "这封信什么时候到的"是盘说了算 ✓）

★行为：★明示休眠的收件人 ⇒ deliver 返回 'rejected' ✓（★与核心同口径：--force 也不豁免 ✓）； ★★ 只是 quiet／inferred ⇒ 一律不退回 ✗（★不许自己猜休眠 ✓）。

★接真引擎的唯一接线口：sessionOf ✗✓

★★ 核心**不认识"引擎""会话"**这些概念 ✗ —— 它只认一个探针函数：

sessionOf(id) => ({ live: true, inject: (text) => { /* 把这段文字送进那个会话 */ } })   // 或 undefined

★两种接法（等价 ✓）：

• createBus({ probes: { sessionOf } }) —— ★直接喂给核心 ✓；
• 把本件配好 sessionOf —— ★核心会自动取 services.deliver.sessionOf ✓。

★规则三句（★别混 ✗）：

1. ★它只影响"在线件能不能真投出去" ✓ —— 探针说"没这个会话"（或压根没接探针）⇒ 在线件判 'kept'： 信留在 inbox/ 等人（只晚到，不会不到 ✓）；
2. ★★pump 的消费授权不看它 ✗ —— 要消费得给 inject 或声明 reader: true （"会话活着" ≠ "信交到了读者手里" ✓）；
3. ★给了 inject 就会真调它，它抛异常 ⇒ 不消费 ✓ —— 交不出去的信，绝不当成交出去了。

配置

字段	默认	含义
sessionOf	不接	★上面那个探针 ✓（不接 ⇒ 在线件一律判 'kept' ✓）
blocked	[]	★明确挡掉的收件人 id ✓（信不进它的信箱 ✓）
★dormantSoftDays ✗	3	★★"醒着"的天数上限 ✓（超过它 ⇒ quiet ✓）
★dormantHardDays ✗	7	★★"休眠"的门槛 ✓（≥ 它 ⇒ dormant ✓）
★★oldestPendingMs ✗	不接	★★推断路的探针 ✗：(id) => 该收件箱里"最老的一封没读的信"的落盘时间（ms；0 ⇒ 没有积压 ✓）。★不接 ⇒ 如实报 unknown ✓（★"不知道"就说不知道 ✓）
★declaredDormant ✗	不接	★明示位探针：(id) => boolean ✓（★"谁被标了休眠"由名单/配置给 —— 本件不认识具体属性名 ✓）
★now ✗	不接	★注入时钟（自测用 ✓）

换掉它（★这是"挂点"的意义 ✓）

★想做别的投递策略（比如"在线件先发短信再投"）⇒ ★只换这一件 ✓， ★核心与别的插件一行都不用动 ✓（它们只认 deliver(letter, ctx) 这个接口 ✓）。