feat(amsg): hook 契约补任务身份与状态读写口，任务按时区推进，推送订阅改用户级

[Tosd0]

这一批补的是 amsg 后台主动消息在真实使用中暴露出来的三处契约缺口：hook 手里缺任务身份和状态读写口、push 里缺调度身份、任务的时区与订阅归属没有落到库里。

1. hook 契约补齐

之前	现在
onAfterSend / onStaleSkip 想写 client_state，只能由宿主自己缓存一份 fire 级 ctx 上的写口	两个 hook 的载荷直接带 readState(ns) / writeState(ns, entries)
「这次生成了哪几段正文」这类上下文，要按任务行 id 自建登记表（连带 TTL 清扫和并发隔离）传给 onAfterSend	onAfterSend 收到本次 fire 的 scratch，与 onBeforeFire / onLLMOutput 是同一个对象引用
任务身份只能从 sessionId 里切字符串取	onLLMOutput / executeToolCalls 的 ctx 带 taskId / taskUuid / occurrenceMs

宿主自建缓存那条尤其要紧：isolate 冷启动后、本次 tick 里还没有任何 fire 跑过时缓存是空的——服务停摆恢复后的第一波过期跳过一条痕迹都留不下，而那正是 onStaleSkip 存在的意义；缓存下来的闭包还握着上一次 invocation 的数据库绑定。

2. push 带上调度身份，体积算得准

每条从任务发出去的 push 顶层多了 taskId / taskUuid / recurrenceType / occurrenceMs（冻结 prompt 路径和 fire-time hook 路径都算）。客户端据此认领任务、判断它还会不会再来——角色在 fire 里给自己排的任务客户端从没见过，此前只能靠宿主往 metadata 里逐个抄，抄漏一个就会把循环任务误判成一次性的。

体积计量新增导出 PUSH_ENVELOPE_RESERVED_BYTES（384 字节）和 measurePushPayload(payload, { reserveEnvelope: true })。hook 把 payload 交还给库之后，库还会补 messageId / sessionId / timestamp / messageIndex / totalMessages 和上面那四个字段，hook 手里量到的从来不是最终 payload——不留这一截，卡在边界上的消息会「量出来装得下、补完字段就超了」，既没走旁路存储也发不出去。

3. 任务生命周期

• 任务行支持 IANA tzId，daily / weekly 按该时区的墙钟推进。此前固定 +24h / +7d，纽约的 08:00 每日任务过一次夏令时切换就永久变成 09:00。全程走 Intl，不手搓偏移；不给 tzId 维持 UTC 行为。
• scheduleTask 撞车返回已存在任务的投影：{ created: false, reason: 'duplicate', uuid, task }。此前只有 uuid，重跑那一轮的宿主什么都记不下来。投影走与 GET /messages 同一份白名单，不含任何凭据。
• 循环任务的过期快进也调 onStaleSkip（action: 'fast_forwarded'，带 skippedCount / skippedOccurrences / nextSendAt）并写 lastError。此前只有一次性任务的过期会回调，循环任务攒下的那几次是完全静默跳过的。

4. 推送订阅改成用户级

新增 push_subscriptions 表和 PUT / GET / DELETE /push-subscription 三个端点，一个用户一份，落库前用 per-user key 加密。任务不再携带订阅，到点投递时现读那一份。

订阅冻结在每条任务里的话，用户清站点数据、重装 PWA、或推送服务轮换 endpoint 之后，每条老任务都攥着一个已死的订阅，而「刷新订阅」只能按客户端本地已知的任务清单逐行 PUT——它不知道的任务（角色在 fire 里给自己排的那些）就永远刷不到，成了死循环：推不出去 → 状态记不下来 → 客户端不知道这条任务存在 → 更刷不到它。

破坏性变更

变更	使用方要做什么
POST /schedule-message 与 PUT /update-message 不再收 pushSubscription（带了返回 400 PUSH_SUBSCRIPTION_NOT_ACCEPTED）	拿到订阅后调一次 putPushSubscription()，之后每次启动幂等再调一次。原来那套「按任务清单逐行 PUT 刷订阅」整段可以删掉
排程时该用户还没登记订阅 → 409 PUSH_SUBSCRIPTION_MISSING	首次排程前先登记
onStaleSkip 现在循环任务也会调	按 info.action 分流；原来假设「被调到 = 一次性任务已终态」的分支会把还活着的循环任务当成死的
新增 push_subscriptions 表	部署后跑一次 POST /init-tenant（或手工执行 schema.sql 里那段）

GET /capabilities 的 features 相应追加九个串，供前端探测部署是否落后：hook-state-accessors、after-send-scratch、fire-task-identity、push-task-identity、push-envelope-reserved-bytes、schedule-task-duplicate-row、recurring-stale-skip-hook、task-timezone、user-push-subscription。

测试

五个包全量 704 通过（client 85 / instant 187 / server 298 / shared 75 / sw 59），build 全绿。新增 43 例 server + 6 例 client，其中当回归守卫用的：

• 跨夏令时墙钟不变（recurrence.test.mjs）：纽约 daily 任务跨 2026-03-08，墙钟保持 08:00、真实间隔 23h；同一文件里显式断言旧的 +24h 实现会落到 09:00。另有秋令时 25h、weekly、伦敦 BST、gap 时刻不倒退、非法 tzId 退回 UTC。
• 循环快进必须留痕（run-tick.test.mjs）：快进时 onStaleSkip 收到 skippedCount: 4 和四个 skippedOccurrences、lastError.skippedCount 落库——旧行为下一次都不调。
• onStaleSkip 自带的 writeState 在「本跳零 fire」时真能落库——这是宿主自建缓存方案盖不住的那个洞。
• 信封余量盖得住（webpush-webcrypto.test.mjs）：按预留额度组的 payload 补完字段仍在限内，而不留信封的老口径正好溢出。
• 换订阅后老任务推到新 endpoint（push-subscription.test.mjs）：这是第 4 节存在的理由；另有落库是密文、无订阅排程 409、带订阅排程 400。

未直接覆盖：pg / neon 适配器的三个订阅方法（这两个适配器本来就没有连库测试，SQL 照 D1 版翻译，D1 那条路径测试全覆盖）、多租户线 /push-subscription 的 GET / DELETE（单用户线三个方法全测了）。

附带

docs: 那个提交是之前审查报告里的文档类小项清扫，一并带过来了。

https://claude.ai/code/session_01DpV5FADagj4MTUMo4r9UUX