Repository navigation
Prioritize new Lark replies over already attempted cards - #8848
Conversation
Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
…ioritize-first-lark-replies-20261116 Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · reasoning_effort=max
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
评审提交 afb3bbb22744cb77758d89f7223153044c51dc89,对照基线 f21b3a57abfb26fa6eafd808f0f5ac3516f84a12。
动机 / Motivation
未发现阻断性问题。
在私聊或 App 等待新回复,以及在 Lark 等待首次 Steward 卡片的人。原 worker 重启或仍有历史队列时,若几张卡片已经尝试发送但尚未核实结果,它们会在空闲槽位上排在新回复前。新的待发送工作先取得释放的槽位。已有发送记录的卡片随后还会核对原回执并转为已送达。本次只调整现有私聊交付 worker 的排序。卡片格式、原 Bot 和回调权限继续沿当前规则。
规范 docs/reference/protocols/manager-evidence-and-continuity-v0.md @ f21b3a57abfb26fa6eafd808f0f5ac3516f84a12。核对 Dispatch intent and reconciliation,即发送前留存原尝试,未知外部结果按 provider 幂等标识或读回对账,继续绑定原请求。 规范原文
改动思路 / Approach
从卡片日志已有的发送时间或 provider 消息 ID 推导排序,复用 reply worker 的既有两类优先级和卡片对账入口。在私聊 worker 里给首次发送分配下一个槽,原卡片对账仍依托同一条日志、请求 ID 和 provider 读回。 新增的是一次本地状态判断,继续用现有并发上限、原发送 UUID 和 provider receipt。
具体改动 / Changes
关键代码讲解
LarkPrivateConversations.is_recovery_path。在普通的历史重试标志之外也读取卡片日志。已记录发送起点或 provider 消息 ID 的卡片加入现有恢复优先级,Web 投影走已有分支。 private_conversations.py L1855LarkGoalTopicRuntimeService._reconcile_private。沿相同工作池,先按是否需要恢复排序,再使用当前进程内尝试次数。分配槽位时不用再查 provider。 goal_topic_runtime_service.py L221private_steward_triage.reconcile。使用原请求 ID 的幂等键。已有 provider ID 走准确读回,没有 ID 的旧尝试保留冻结卡片内容。 private_steward_triage.py L353
对主干的风险 / Risks
同一独立用例主干两个场景均由旧卡取得唯一释放的槽,候选均由新卡取得。两轮都最终验证 11 张卡,provider 产生 11 个唯一写入。 候选另通过 20 项调度与 7 项卡片集成用例。发送响应丢失的一组在两边都观察到一次需要继续尝试的情况,最终以原日志与 provider 去重后的结果验收。diff 预合并检查及 DCO 核对通过。 相关测试
我的整体评价 / Verdict
批准此提交。首次发送的等待顺序改变,历史发送继续在同一 worker 内完成回执对账。 本地源码使用真实持久日志、worker 和合成 Bot。真实 Lark 网络和已安装服务待验证。 改动位于交付调度,卡片和回复的渲染沿现有实现。
English verdict: APPROVE. fresh private work wins the released slot, and existing card attempts still reconcile without duplicate provider effects.
…tegrate-lark-reply-recovery-20261116 Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
…tegrate-lark-reply-recovery-20261116 Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · reasoning_effort=max
Request changes conclusion (author-owned PR; GitHub blocks formal self-review)
评审提交 7e71a593309b7bdbd196b32b154c2c1113eadc73,对照主干 59e68906d4082f43fae52e4219e374c5e97539a9。
[P2] 保留暂不可读的已发现历史恢复。 历史发现已把下一次探测推迟 60 秒。一次读取失败后,del ready[path] 同时移除了唯一的已就绪记录。复验中只损坏一轮,主干在记录恢复可读的当轮接回原任务,候选约一分钟后才接回。当前排序可以遍历成功分类的路径,保留仍存在的 ready 记录给下一轮。 历史探测
动机 / Motivation
在飞书私聊或 App 等待回复、同时存在已尝试卡片和历史恢复的用户。
主干会把尚未取得回执的已尝试卡片排在部分新回复前。排序时遇到一条暂不可读记录,当前扫描也会跳过其他已就绪回复。
在真实 worker 上先发现一条历史恢复并启动 60 秒探测冷却。下一次分配空位时让记录短暂不可读,同时排进一条新回复,然后恢复原记录。
当前实现先派发新回复。读取恢复后,主干在下一次扫描接回已发现的原历史任务,候选直到下次 60 秒探测才把它接回。
复验覆盖本地真实 worker、磁盘 journal 和观察时钟,发送端使用合成替身。受管服务和真实飞书回调待验。
改动思路 / Approach
继续用原飞书私聊投递 worker 的四个处理槽和持久化 journal。已记录发送时点或提供商消息 ID 的卡片进入恢复类,新回复可先拿到空位。原任务锁继续处理回执与不确定的写入。按发送尝试分类,在释放的槽位安排新回复或既有 provider reconcile。
具体改动 / Changes
3 个文件新增 85 行、删除 12 行。私聊、App 投影和新卡片参加同一个排序,已尝试卡片的两个状态都有覆盖。
关键代码讲解
- is_recovery_path。读取持久化
triage.send_started_at或message_id,确定卡片归入恢复类。已完成的消息、图片后续和 App 分支仍沿原入口。 排序输入 - _reconcile_private。历史扫描已加入 ready 后,重新读取 journal 可能遇到瞬时故障。当前异常分支删除 ready,
pending_body_paths又会跳过已 delivered 的历史项。因此只剩带冷却的历史扫描能接回。 worker 处理
对主干的风险 / Risks
- 私聊投递测试文件 526 项通过,其中本次另行定向核验的 24 项也通过。把新测试放在当前主干运行,六个原历史场景通过,十二个已尝试卡片场景及一个不可读卡片场景复现原问题。Quick premerge 的六个直接和两个选定检查通过。
- 独立反例用实际线程池和磁盘 journal 驱动。t=100 发现历史项,t=101 短暂不可读,t=102 恢复相同字节。新回复在候选的 t=101 已排入处理,主干 t=102 恢复历史项,候选 t=162 才恢复。两边都只处理一次,原文件字节一致。
我的整体评价 / Verdict
请求更改。新回复能先获得空位,但复用的历史恢复被从 ready 移除并受原探测冷却阻挡。两个分支需要同时成立。本轮排序时跳过不可读路径,保留已发现且仍存在的 ready 记录。补一个进入探测冷却后的历史记录读失败再恢复用例。 复验覆盖本地真实 worker、磁盘 journal 和观察时钟,发送端使用合成替身。受管服务和真实飞书回调待验。
English verdict: REQUEST_CHANGES. Fresh replies advance, but dropping a temporarily unreadable historical item from the ready set delays its next attempt until discovery backoff expires.
Signed-off-by: huangruiteng <huangrt01@163.com>
* docs: add Japanese README Signed-off-by: Ikko Eltociear Ashimine <eltociear@gmail.com> * docs: sync Japanese README with Goal lifecycle and route it through README checks Signed-off-by: Ikko Eltociear Ashimine <eltociear@gmail.com> --------- Signed-off-by: Ikko Eltociear Ashimine <eltociear@gmail.com>
…rk-recovery-retain-ready-20261116 Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · reasoning_effort=max
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
评审提交 2c3e2c75944f25be62fd8294463109d5f8268ee6。PR 元数据显示 base 59e68906d4082f43fae52e4219e374c5e97539a9,其 19 文件比较包含已进入主干的 16 个文件。以当前主干 cac86bbad92ba99c3430b3f7eaa9632727573821 和 PR 的实际 merge base f599a60ce64fd78db80d6318c84e3af58bfc1df9 核对,功能差异为 3 个文件,新增 109 行、删除 18 行。已出现在主干的 16 个文件在该 merge base 同内容。
动机 / Motivation
使用现有 LoopX 私聊回复、App 回复或飞书卡片的用户。 有 send_started_at 或 provider message_id 的历史卡片可优先占满 worker。上一提交跳过损坏优先级读时移除了已发现的路径,原历史探测退避期间不能从扫描重新取得它。 用原四槽 worker 分别积压已尝试卡片、未知发送和历史失败,再提交 Lark、App 或新卡片。另在历史发现已经设置退避后,使旧 journal 一轮不可读,下一轮恢复原字节。
当前提交让新回复先使用刚释放的槽。已发现的历史条目恢复可读后于下一轮重试,原送达回执仍由实际投递写入。
本地使用真实 worker、Core、journal 与合成飞书 provider,按需要控制读错和时钟。线上飞书、实际积压延迟分布和远程 CI 尚未测量。
改动思路 / Approach
沿用现有 ready 集合与四槽 worker。分类读取成功的项按新回复/历史恢复和原尝试计数排序。读坏的项本轮不占槽,在后续扫描重读同一 journal。 scope、原消息、App、Session 和已冻结 provider attempt 的实际准入/恢复由同一 _reconcile_* 与 triage.reconcile、Core owner 决定。
现有私聊 scheduler 的范围及第一条回复,不引入 provider IO 或 state 新模型。 一个局部排序和一个分类异常隔离可修复真实共享池延迟。
具体改动 / Changes
功能差异为两处生产代码和一个测试文件。该调度问题没有专项书面规格,按原问题和已发表的历史退避反例复核。原来源与投递读回继续沿用 Lark 扩展约束。 前一轮评审 · 原私聊说明
关键代码讲解
LarkPrivateConversations.is_recovery_path。卡片已有send_started_at或message_id时按历史恢复处理。现有 App 投影和首次回复仍走新回复类别。 调度分类LarkGoalTopicRuntimeService._reconcile_private。保留分类读取失败的已发现路径,当前 tick 只遍历成功分类者。保留旧的探测间隔和单请求 owner,恢复可读时继续原路径。 workerreconcile_request与triage.reconcile。来源、当前绑定与冻结发送仍由原 reconcile 验证。一次分类本身不产生 provider 调用。 原投递分派 · 卡片原校验
对主干的风险 / Risks
- 带已发送标记或未知发送尝试的卡片排到恢复队列。新 Lark、App 或卡片在槽位释放后的第一轮进入实际 worker,卡片与历史条目仍能续接。 当前提交通过 601 项私聊、入口、卡片与读回测试。主干 f599a60 上移植的四个积压对照均因新回复未获首个释放槽失败。 并发回归
- 同一已发现历史 journal 在第 101 秒读坏时,新回复当轮进入。第 102 秒恢复字节,当前提交在既有 160 秒探测退避结束前处理原项。把同一个用例移到上一版
7e71a593309b,第 102 秒仍没有该次恢复。 来源撤销和回调读回继续经既有传输与 Core。真实本地 pump 接受并完成私聊请求,在历史读取未返回时写下原私聊回复的 delivered receipt。 历史退避回归 · 本地 pump - 当前实际 feature merge base 上的 quick premerge 通过四项直接检查、Python 编译与两项 catalog canary。当前主干合并树无冲突。
语义与 CI 对齐
复用已有 journal 状态和 provider attempt 字段作为局部顺序提示。历史退避、恢复后的可调度性和原来源的结果读回分别有实际入口覆盖。
我的整体评价 / Verdict
当前提交通过代码评审。新请求优先获得可用槽,已有历史项在暂时读错后仍可续接。同一私聊保留原发送校验与用户回执。实现复用原有调度队列和历史退避,现有私聊及 App 接入无需迁移。
English verdict: APPROVE on 2c3e2c75944f25be62fd8294463109d5f8268ee6. Fresh private replies use the next available slot. Previously discovered recovery work survives a transient priority read failure and resumes through the original delivery checks.
huangruiteng
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · Codex · OpenAI · self_reported
动机 / Motivation
使用 Lark 私聊、App 回复或飞书卡片接续工作的用户,在 worker 重启或历史投递仍有积压时,可能让已经发起但尚未确认结果的旧卡片长期占住空闲槽位。新回复因此被无关的恢复探测推迟。此前一次优先级读取失败还会把已发现的历史任务从 ready 集合移除,使其继续等待 discovery backoff,进一步放大等待。
当前提交先让新回复使用释放出的槽位,同时保留已发现但短暂不可读的历史请求;恢复可读后仍在下一轮按原路径接续。它只调整现有四槽 private delivery worker 的调度提示,不改变来源授权、发送幂等、provider attempt 或回执对账。
改动思路 / Approach
入口仍是现有 _reconcile_private worker。pending_body_paths 发现 ready journals 后,is_recovery_path 只读取持久化的 send_started_at 或 message_id,把已尝试卡片与普通新回复分开排序;实际执行继续交给 reconcile_request、原 scope 检查和 triage.reconcile。
错误 owner 也保持原边界:某一 journal 的分类读取失败时,本轮跳过该路径,不删除已发现的 ready 记录;下一轮扫描仍能看到它。这样新回复可先执行,历史 backoff 和 provider 读回语义不被重写。
| 时序 | 当前 head 的观测 |
|---|---|
| 旧卡片已尝试、新回复到达 | 新回复使用下一个释放槽位 |
| 已发现历史请求短暂不可读 | 本轮跳过,恢复后在下一轮接回 |
| 来源撤销、actor 不符或意图变化 | 原 reconcile 与 Core owner 继续拒绝 |
具体改动 / Changes
实际功能差异是 3 个文件、+109/-18:private_conversations.py 扩展恢复分类,goal_topic_runtime_service.py 隔离分类读错并保留 ready 路径,tests/test_lark_private_conversations.py 覆盖 Lark、App、卡片、三种历史积压和短暂读坏恢复。PR 元数据中的另外 16 个文件来自较旧 base 比较,在真实 merge base f599a60ce64fd78db80d6318c84e3af58bfc1df9 中已经位于主干。
关键代码讲解
LarkPrivateConversations.is_recovery_path在既有 delivered 和 image-followup 条件之外,读取卡片 journal 的发送起点或 provider message ID。它只产生排序 hint,不授予发送权限。LarkGoalTopicRuntimeService._reconcile_private用recovering字典保存成功分类结果;捕获损坏 JSON 或瞬时读取异常时continue,不再修改原ready集合。后续只遍历成功分类路径,因此一个坏 journal 不会阻塞同批新回复。triage.reconcile仍是原发送与 provider 读回 owner,继续使用原 request ID、冻结内容和幂等保证。新增测试覆盖failed_turn、sent_card、unknown_card_send以及priority_read失败后恢复。
该调度改动没有专项 RFC;其约束来自私聊 delivery 的既有持久 journal、恢复分类和 provider reconciliation 契约。主干的来源撤销、Card/App 投影和完成回执行为保持不变。
对主干的风险 / Risks
PASS:当前 head 的聚焦测试共 23 项通过,覆盖新回复优先、读坏 journal 不阻塞、分类失败后保留 ready、backoff 中恢复以及原路径重试。此前作者自审的完整私聊相关套件记录为 601 项通过;本轮没有等待或依赖远端 CI。
主要风险是分类读取会触及持久 journal;实现把异常限制在该路径的分类阶段,并在异常时跳过本轮调度,而不是改变原状态。来源撤销、重复发送和未知 provider 结果仍由原 reconcile/Core owner 处理。真实受管 Lark 服务、实际生产积压分布和长期 throughput 没有在本轮重新实测,因此不声称完整生产资格。
我的整体评价 / Verdict
APPROVE。该提交解决了复审指出的组合缺陷:新回复可以先拿到槽位,已发现的历史请求不会因一次读坏而被移出 ready 并等待 backoff 结束。实现复用现有 worker 和 journal,不增加新的持久状态或第二套授权模型;未能覆盖的生产服务范围保持明确。
English verdict: APPROVE at 2c3e2c7. Fresh replies win the released slot, and discovered recovery work survives a transient priority-read failure while retaining original reconciliation checks.
The merge-base changed after approval.
huangruiteng
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · Codex · OpenAI · self_reported
动机 / Motivation
使用 Lark 私聊、App 回复或飞书卡片接续工作的用户,在 worker 重启或历史投递仍有积压时,可能让已经发起但尚未确认结果的旧卡片长期占住空闲槽位。新回复因此被无关的恢复探测推迟。此前一次优先级读取失败还会把已发现的历史任务从 ready 集合移除,使其继续等待 discovery backoff,进一步放大等待。
当前提交先让新回复使用释放出的槽位,同时保留已发现但短暂不可读的历史请求;恢复可读后仍在下一轮按原路径接续。它只调整现有四槽 private delivery worker 的调度提示,不改变来源授权、发送幂等、provider attempt 或回执对账。
改动思路 / Approach
入口仍是现有 _reconcile_private worker。pending_body_paths 发现 ready journals 后,is_recovery_path 只读取持久化的 send_started_at 或 message_id,把已尝试卡片与普通新回复分开排序;实际执行继续交给 reconcile_request、原 scope 检查和 triage.reconcile。
错误 owner 也保持原边界:某一 journal 的分类读取失败时,本轮跳过该路径,不删除已发现的 ready 记录;下一轮扫描仍能看到它。这样新回复可先执行,历史 backoff 和 provider 读回语义不被重写。
| 时序 | 当前 head 的观测 |
|---|---|
| 旧卡片已尝试、新回复到达 | 新回复使用下一个释放槽位 |
| 已发现历史请求短暂不可读 | 本轮跳过,恢复后在下一轮接回 |
| 来源撤销、actor 不符或意图变化 | 原 reconcile 与 Core owner 继续拒绝 |
具体改动 / Changes
实际功能差异是 3 个文件、+109/-18:private_conversations.py 扩展恢复分类,goal_topic_runtime_service.py 隔离分类读错并保留 ready 路径,tests/test_lark_private_conversations.py 覆盖 Lark、App、卡片、三种历史积压和短暂读坏恢复。PR 元数据中的另外 16 个文件来自较旧 base 比较,在真实 merge base f599a60ce64fd78db80d6318c84e3af58bfc1df9 中已经位于主干。
关键代码讲解
LarkPrivateConversations.is_recovery_path在既有 delivered 和 image-followup 条件之外,读取卡片 journal 的发送起点或 provider message ID。它只产生排序 hint,不授予发送权限。LarkGoalTopicRuntimeService._reconcile_private用recovering字典保存成功分类结果;捕获损坏 JSON 或瞬时读取异常时continue,不再修改原ready集合。后续只遍历成功分类路径,因此一个坏 journal 不会阻塞同批新回复。triage.reconcile仍是原发送与 provider 读回 owner,继续使用原 request ID、冻结内容和幂等保证。新增测试覆盖failed_turn、sent_card、unknown_card_send以及priority_read失败后恢复。
该调度改动没有专项 RFC;其约束来自私聊 delivery 的既有持久 journal、恢复分类和 provider reconciliation 契约。主干的来源撤销、Card/App 投影和完成回执行为保持不变。
对主干的风险 / Risks
PASS:当前 head 的聚焦测试共 23 项通过,覆盖新回复优先、读坏 journal 不阻塞、分类失败后保留 ready、backoff 中恢复以及原路径重试。此前作者自审的完整私聊相关套件记录为 601 项通过;本轮没有等待或依赖远端 CI。
主要风险是分类读取会触及持久 journal;实现把异常限制在该路径的分类阶段,并在异常时跳过本轮调度,而不是改变原状态。来源撤销、重复发送和未知 provider 结果仍由原 reconcile/Core owner 处理。真实受管 Lark 服务、实际生产积压分布和长期 throughput 没有在本轮重新实测,因此不声称完整生产资格。
我的整体评价 / Verdict
APPROVE。该提交解决了复审指出的组合缺陷:新回复可以先拿到槽位,已发现的历史请求不会因一次读坏而被移出 ready 并等待 backoff 结束。实现复用现有 worker 和 journal,不增加新的持久状态或第二套授权模型;未能覆盖的生产服务范围保持明确。
English verdict: APPROVE at 2c3e2c7. Fresh replies win the released slot, and discovered recovery work survives a transient priority-read failure while retaining original reconciliation checks.
Goal And Delivered Outcome
A private Lark card can have a persisted send attempt while its receipt still awaits verification. After worker startup, several untouched card receipts could take every available slot ahead of a newly queued reply.
The private delivery worker now schedules those cards with recovery work. The first send of a new Lark reply, App reply or Lark card can use the next available slot.
A journal can become unreadable between discovery and priority selection. The worker skips that scheduling hint and continues the other replies. An already-discovered journal stays eligible during a temporary read failure. The next scan retries its priority read while other ready replies can use the available slots.
Author Declaration
Written by OpenAI Codex. No written specification; the reproduced scheduling failure in this PR is the basis.
LarkPrivateConversations.is_recovery_pathLarkGoalTopicRuntimeService._reconcile_privateReview follow-up
A historical delivery was already eligible for recovery when its journal became briefly unreadable. Dropping its in-memory scheduling entry forced it to wait for the historical discovery cooldown. The worker now retains the entry and schedules from the paths it could classify in the current scan.
The regression uses the real worker scheduling loop and temporary on-disk journals with a controlled clock. At tick 100 it discovers the historical delivery and sets the next probe to tick 160. At tick 101 the journal is unreadable and a new reply still goes through. At tick 102 the journal becomes readable and the original recovery runs in that scan. The previous revision failed at tick 102. The test checks the original journal content and the remaining sequence of attempts.
Scope And Continuation
The scheduling fix covers the existing private delivery worker. Provider normalization of card receipts and callback subscription ownership are separate follow-up work.
Validation
uv run --extra test loopx canary premerge --tier quick --from-git-diff --git-diff-base origin/main7e71a5933.f599a60ce6.dashboard-browser (3)run reported 184 of 200 visible owner-work rows in its expansion fixture. Prior jobFrontend / Visual Evidence
UI impact
none. The change affects worker scheduling.Type of Change
LoopX Area
Shared-authority RFC fixture impact
N/A. The existing delivery journal provides the scheduling inputs.
Boundary Checklist