Skip to content

fix(scheduler): fence Python follow-ups on superseded heartbeat receipts - #8647

Merged
loopx-agent merged 10 commits into
loopx-project:mainfrom
gcl-coder:fix/scheduler-heartbeat-receipt-fence
Nov 18, 2026
Merged

loopx-agent merged 10 commits into
loopx-project:mainfrom
gcl-coder:fix/scheduler-heartbeat-receipt-fence

Conversation

@gcl-coder

@gcl-coder gcl-coder commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

Problem / 问题

Relates to #8605, whose minimal Python passthrough already landed in #8708. This branch is rebased on the current main and now keeps only the hardening that the minimal fix does not cover: a damaged receipt-log row must not block a valid ACK or failure return, a genuinely newer committed receipt must still retire an older return even when its own summary rotted, and a receipt must belong to the exact Goal instance whose scheduler state it would rewrite, both before the write and again under the state lock.

Fix / 修复

The diff against current main is 31 files, +2830/−112.

  • rollout_receipt_log.ts finds the originating receipt, then classifies a committed successor only after the row proves it belongs to this exact scope (event_kind, goal_id, agent_id, goal_ref). An ambiguous Turn in an out-of-scope row or a validation diagnostic no longer retires a valid return; a same-scope row with a duplicated Turn still fails closed. Committed successors are recognised from their writer's newline, so damaging only the summary of an already committed later receipt still blocks the older return.
  • receipt_log_snapshot.ts plus the new runtime/json_line_members.ts decode each complete row and the unterminated tail with one strict UTF-8 decoder. A row that cannot be decoded is recorded in firstErrorLine and skipped by the tolerant scheduler view; legal U+FFFD is not treated as damage.
  • heartbeat_commit.ts re-reads the originating receipt and the current Goal instance under the state lock before any mutation or replay, so an older or cancelled instance cannot overwrite or replay a newer instance's cadence.
  • settlement_readback.ts gains an explicit tolerate_malformed_history request field, default false. The scheduler follow-up routes set it through quota_context.py; strict settlement, status and projection readers keep the strict readback and still report malformed_settlement_state. The tolerant view never publishes a partial projection cache.
  • rollout_event_log.py drops the uncommitted bytes after the last newline before appending, so the log only ever contains complete rows that older readers can parse.
  • scheduler_ack.py and quota.py pass the originating Turn plus the exact goal_ref/registry_path into the native fence; quota_scheduler_followup.py no longer rebuilds a second freshness rule in Python.
  • scheduler_hint.py, status.py, status/collection.py, attention_queue.py and replan_history_codec.py/replan_history_settlement.ts route only the scheduler follow-up view through the tolerant content read; ordinary state and settlement reads stay strict.

Validation / 验证

Rebased and re-run on current main (68fe178):

  • TypeScript: six suites (scheduler_heartbeat_receipt_fence, scheduler_heartbeat_followup, ..._followup_cli, scheduler_heartbeat_commit, receipt_log_snapshot, quota_settlement_readback) — 248 passed; tsc --project tsconfig.control-plane.json --noEmit clean.
  • Python: test_scheduler_heartbeat_receipt_fence.py 30 passed; the merged fix(scheduler): reject superseded heartbeat receipts on the Python follow-up route #8708 regression file test_scheduler_ack_current_host_binding.py 17 passed on the same tree; test_scheduler_hint_single_request.py, test_scheduler_host_followup_hint_transport.py and test_rollout_event_log_loading.py 53 passed.
  • Real File and SQLite runs: a valid return still writes beside a damaged audit row, a committed successor still blocks an older return even when its summary is corrupted, and replay of the current receipt re-reads its original result with no second write and no debit.

Not exercised locally: Windows, hosted CI, PostgreSQL, the installed host UI, and a live App scheduler.

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · max

本次评审对应提交 0379886ae2733c8d613faa1c1b4ad4f35b4c87f1。

[P2] 损坏的日志行会阻断仍有效的调度回报。 只追加一条 summary 含非法 UTF-8 的后继记录时,Python 仍只读到原回执,head 的实际 CLI 却返回 heartbeat_receipt_stale,两个回报均无写入。 兼容调用入口

动机 / Motivation

执行自动化调度回报的 Host 和运行兼容 CLI 的操作者。Host 用仍有效的 heartbeat 回执回报调度更新。兼容入口原先只检查回执是否存在,较新轮次已经准入时,迟到的 ACK 或失败回报仍能改写调度状态。在 File 和 SQLite 的实际 CLI 中,新版本能拒绝确实被替代的旧轮次。当前轮次可以回报,重复 ACK 能回读原结果,两个操作都没有扣额。验证覆盖本地 File、SQLite、真实兼容 CLI 和 native scheduler 测试。实际 App 自动化、已安装版本和现代 Goal 生命周期迁移未验证。一条含非法 UTF-8 的日志行可以在 native 读取时变成较新回执,阻止仍有效的 ACK 和失败回报。

改动思路 / Approach

现有 TypeScript 写入 owner 已执行 freshness 判断并在锁内复核。两端各解释一次回执会让同一日志得到不同结论。保留原 Turn 的透传,由现有 reader 严格识别可用记录,再通过同一 native fence 决定是否写入。移除新增的 Python freshness 扫描。 Python 仍负责还原原始回执绑定与当前 Host observation,包含 Codex App 的 host-match 路径。TypeScript 在收到请求后判定 freshness,提交时持锁重读。另一份 draft 的最小透传实现与本 PR 的 20 个普通场景结果相同,也能复现坏行,说明修复应落到现有 reader。 较小透传实现

具体改动 / Changes

关键代码讲解

  • build_scheduler_followup_payload 继续解析原 Turn 和 Host 参数,新加 heartbeat_receipt_status 的检查,读取同一 rollout log 第二次。其新测试覆盖较新回执、normal-run 审计、missing 和 ACK 接线。 Python 入口 测试
  • record_quota_scheduler_ack 以及 ACK / failure adapter 透传 turn_instance_id,_run_native_followup 开启 require_heartbeat_receipt。native 收到请求和持锁写入时各确认一次。 传输 锁内校验
  • readReceiptLogSnapshot 仍用替换式 UTF-8 解码读取完整行及尾行,非法字节可能通过 JSON 检查。 共享 reader

规格采用 docs/reference/protocols/host-integration-plugin-plan-v0.md 的 c49d59b24d3f7745fccf3a1f2df1e35036fe517b。Phase-3-Ordering 已证明合法较新回执阻断迟到写入。Phase-3-Replay 的新鲜 ACK 重试复用原结果。Phase-3-ReceiptValidity 尚未满足,坏行仍能改变回执资格。 协议原文

对主干的风险 / Risks

在真实 File 与 SQLite CLI 中,先写一份有效 heartbeat receipt,再插入一条只在 summary 处含非法 UTF-8 的后继日志。Python 的读取只看到原 Turn,head 调用 TypeScript 后却称原 Turn 已被替代。两种后端的 ACK 和失败回报均返回 rc=1,调度状态无写入,base 四次都正常提交。当前 main 的 GitHub 候选合并树也复现四次。建议统一按有效 UTF-8 读取,保留宽容读的坏行跳过以及严格结算读的损坏报告,再复跑真实后继和锁内竞争用例。

语义与 CI 对齐

PASS,48 项 Python、30 项 native scheduler、Ruff。真实合法后继的四个组合从错误写入变为零写入。FAIL,四个坏字节回报场景在 head 错误拒绝。标准 premerge 有一项旧 fixture 失败,精确 merge base 在同一个 safe_bypass_allowed 断言失败,包含 #8615 更新的候选合并树通过该项。未读取远端 CI。

我的整体评价 / Verdict

REQUEST_CHANGES。迟到回报的隔离可以防止调度状态被旧 Turn 覆盖。当前改动把原生 reader 的坏字节误判带到兼容入口,使有权回报的 Host 收到错误恢复提示。下一版应保留原 Turn 和锁内 fence,把 freshness 留给同一 owner,并用两种 provider 的真实回报验证。本次评审覆盖现有宿主与 CLI 行为。验证覆盖本地 File、SQLite、真实兼容 CLI 和 native scheduler 测试。实际 App 自动化、已安装版本和现代 Goal 生命周期迁移未验证。

English verdict: REQUEST_CHANGES. Head 0379886 fences real supersession but rejects valid ACKs and failure reports when a malformed UTF-8 row is treated as a newer receipt; fix the shared decoder and keep one freshness owner.

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · max

本次评审对应提交 346cfa19109eaa32ea499558e8868ae7f523608b。

[P2] 让有效的 Python 调度回报不被严格结算读提前拒绝。 同一有效回执旁有一条坏日志时,Python 兼容入口仍无法回报。File 和 SQLite 的 ACK、失败回报都退出 1、零写入;省略 Turn ID 也从主干可写变成拒绝。 兼容入口

动机 / Motivation

在自动化调度更新后回报成功或失败的 Host,以及通过兼容 CLI 恢复回报的操作者。主干的兼容入口遇到真正的新 Turn 时仍会让旧回报改写调度状态;前一评审头会把坏 UTF-8 误当成新回执,挡住正常回报。当前 head 让真正被取代的回执在写入前拒绝;原生入口已能跳过坏行,干净日志下的兼容回报与 ACK 重放正常。实测隔离的 File、SQLite、Python CLI 和原生 launcher;未查托管 CI,未操作实际 App 调度。source_session_v1 的通用 CLI 在 base/head 都于读取 registry 阶段拒绝,未据此声明生命周期资格。同一有效回执旁有一条坏日志时,Python 兼容入口仍无法回报。File 和 SQLite 的 ACK、失败回报都退出 1、零写入;省略 Turn ID 也从主干可写变成拒绝。

改动思路 / Approach

调度 freshness 由现有 TypeScript owner 和同一锁域统一决定。字节校验仍归现有日志 reader;结算的严格完整性与调度回报的容错判断有不同用途。保留兼容入口原始绑定、native 提交及锁内复核;把无关的严格结算前置读取从普通调度回报分开。 保留一处 freshness owner 是正确的:Python 传原 Turn,TypeScript 在入口和持锁提交时确认。单独做 Python 分类已被移除。下一步应让普通 ACK 和失败回报使用同一容错视图;需要结算证据的分支仍读严格视图。草案 #8606 的小透传也验证了只改接线不足以处理坏字节。

具体改动 / Changes

关键代码讲解

按 docs/reference/protocols/host-integration-plugin-plan-v0.md 的 c49d59b24d3f7745fccf3a1f2df1e35036fe517b 版本核对 Phase 3 和 #8605。Phase-3-Ordering 通过:真正的较新回执让兼容 ACK 和 failure 在写入前退出。Phase-3-Replay 通过:干净日志中,同轮 ACK 复用原结果,不写第二次、不扣额。Phase-3-ReceiptValidity 仍未满足:坏行不再伪装成合法后继,但严格结算读取阻止有效调度回报。

对主干的风险 / Risks

先用真实 should-run 写入当前回执,再在同一 rollout JSONL 追加一条 summary 含原始 0xff 的记录。当前主干的两种后端、两条回报对完整行和无换行尾行均可写入;本 head 的 8 个对应调用均退出 1,返回 quota_collection_failed,调度状态与扣额无变化。带 --verbose 的 File ACK 给出 settlement readback line 2 is malformed。没有 Turn ID 的另 4 个兼容调用同样从成功变失败;带 emitted host facts 的 native launcher 对坏完整行则 4 次成功,遇真实后继 4 次拒绝,均零扣额。主干合并树复现代表性的 File ACK 与 SQLite failure。建议补实际 CLI 回归,保持严格结算读取对同一坏行仍给出诊断。

语义与 CI 对齐

85 项 Python、63 项 TypeScript、Ruff 和类型检查通过;quota_settlement_cli 在精确 head 和当前主干组合各 187 项通过。标准 premerge 的唯一失败是旧 safe_bypass_allowed 断言,精确 merge base 与 head 同一断言同一结果,当前 main 与合并树均通过该 smoke,组合 quick 通过。这里复用既有类型和诊断,没有扩展语义词表。Phase 3 的真实回报负例仍失败。未查询托管 CI。

我的整体评价 / Verdict

请求修改。真实后继的隔离已通过,坏行导致的错误分类也从 native 消除;Python 路径仍无法完成有效回报,影响恢复与失败记录。把普通调度回报的读取与严格结算分开后,复跑同一回执、坏完整行、坏尾行、无 Turn 和真正较新回执。7 个文件的范围可保留在既有 owner 内。本次评审覆盖现有宿主与 CLI 行为。实测隔离的 File、SQLite、Python CLI 和原生 launcher;未查托管 CI,未操作实际 App 调度。source_session_v1 的通用 CLI 在 base/head 都于读取 registry 阶段拒绝,未据此声明生命周期资格。

English verdict: REQUEST_CHANGES. A valid newer receipt is fenced, but malformed UTF-8 still blocks the real Python ACK and failure commands before the tolerant scheduler owner runs.

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · reasoning_effort=max

请求修改,复审 fff4d61423c06cf212e08cb01eb5e141b3b8fc43。上轮关于损坏行阻断两个 *-current 命令的发现已经修复;本轮确认了三个不同的兼容问题。

动机 / Motivation

宿主执行定时设置后,要把结果回写给 LoopX;这包括旧版宿主和从命令行手工补写节奏的操作者。 如果旧轮次的调度回报迟到,主干仍可能接收它并覆盖新轮次的节奏。候选会拒绝确有后继轮次的回报,并允许有效回执旁边有一条坏日志时继续回写。 操作者应能用当轮回执回写成功或失败;旧轮次和错误归属的回执不得改写节奏,重复回报也不应再写一次或扣额。 这个 PR 修复本地宿主回报与读取回执的路径;不修改宿主的计划设置,也不新增 Goal、Agent 或扣额权限。 已复现的问题 #8605。

改动思路 / Approach

兼容 CLI 把原 Turn 交给既有 TypeScript 调度事务。它用日志判断该回执是否仍有效,获取状态锁后复验,最后才写 cadence。严格 UTF-8 解码避免把无法解码的坏行当成后继回执;精确结算仍应拒绝坏历史。相比维持现状,这一改动修复了确有新轮次时迟到回报仍能写入的问题。与仍为 Draft 的 #8606 相比,光传 Turn 不足以保证坏行和 Goal 实例的边界。之前的仓库经验提示应验证“原回执能否继续完成工作”;本轮采用真实写回及重放对照,没有沿用以前的结论。

回执是否属于这一轮是原生调度事务的正确性约束,兼容 CLI 只应传递身份。容错快照跨进通用 status/replan 缓存后产生了已复现的漏报,因此没有必要保留当前传播范围。 本 PR 可以完整交付原轮次和原 Goal 实例在写入前及锁内的检查,以及调度专用的容错读取;普通状态和精确结算继续使用严格读取。

具体改动 / Changes

关键代码讲解

  1. _run_native_followup 将 Turn 和是否要求回执送给现有 TS 事务;持锁检查 让期间到达的有效后继仍能挡住旧写入。Python 仍尝试按 GoalRef 读回,但删除了查不到就拒绝的分支,原生参数没有接到等价的实例范围。
  2. strictUtf8 在完整行与临时尾行验证字节;坏行不会进入可用的回执集合,并保留首个严格错误位置。缓存复用按实际前缀字节,不靠文件长度或时间戳。
  3. readQuotaSettlementSnapshot 给 rollout 与 run index 都增加容错。该开关从 live decision、replan history、attention/status 收集传入;prepare_quota_command_context 只在两个 current 命令的第一层收集启用,并照常写共享 projection cache。新测试验证坏行下两个 current 命令能运行,未覆盖其他读者消费该缓存或异实例回执。
  4. build_scheduler_followup_payload 把 ACK 和失败回报都接到同一门;普通 host-facts 原生入口、已有历史结算分支与兼容入口仍应分开验证。

规范:docs/reference/protocols/host-integration-plugin-plan-v0.md @ 167b0a1f3a3307c284b021ea9a09c7c0b5e5a11f(Phase 3);手工兼容入口见 source CLI contract。

  • Phase-3-Ordering:implemented。 真正的同 Agent 后继挡住旧 ACK 与失败回报;其他 Agent 不受影响。
  • Phase-3-ReceiptValidity:not_met。 坏字节不再充当回执,但混入旧式 registry 日志的异实例记录仍可授权。
  • Phase-3-Replay:implemented。 同一 fresh Turn 首次写入,第二次原样执行重放同一 effect;未再写或扣额。
  • Compatibility-Manual-Fallback:not_met。 手工兼容 ACK 回归;普通 status 可被容错的 ACK 预览污染。

对主干的风险 / Risks

  • [P2] 保留 Goal 实例范围。 兼容 CLI 读取 Goal 的旧式 registry,日志里只有另一 Goal 实例的同名 Goal/Agent/Turn 回执。 在真实 Trae 兼容入口,主干返回 heartbeat_receipt_missing;候选返回成功且 scheduler_commit.written=true。Python 精确查询拒绝了异实例行,但 native 请求只带 Goal slug、Agent 和 Turn,因此异实例记录取得了 cadence 写入权。这里复现的是旧式 registry 中混入已标记实例的历史,不外推到启用 source-session 的入口。 保持 TypeScript 单一 freshness owner,把期望的 GoalRef(或显式旧式无实例范围)交给它;预检与持锁写入都用同一范围排除异实例行。补充异实例不能授权、也不能使有效回执过期的入口测试。
  • [P2] 不把容错投影发布为严格缓存。 同一 Agent 在损坏 JSONL 下以 scheduler-ack-current --write-projection-cache 做预览,然后以同一参数范围执行 quota status --use-projection-cache。 同一份历史、不改任何数据,缓存未命中时 quota status 退出 1 并报告 collection failed;预览写入缓存后,status 命中同一个 key,退出 0 且没有 health_items。局部容错被其他严格读取者当成完整状态。 让 scheduler 的容错读取留在自己的窄入口;至少不要把容错投影写到严格读者使用的缓存 key,也不要无标记地把部分历史投影成健康状态。用同一运行时验证预览前后 strict status 结果一致。
  • [P2] 恢复手工 ACK 兼容性。 同一份有坏 UTF-8 行的日志,已有宿主用 quota scheduler-ack --use-current-hint 回写实际应用的节奏。 SQLite 隔离对照中,主干写入成功;候选在构建通用 status 时先报 quota_collection_failed。带原 Turn 和无 Turn 的手工兼容入口均退化,而 scheduler-ack-current 成功。同一拥有者的兼容命令不应因拼写不同走到不同的损坏处理。 从现有 scheduler follow-up 边界提供统一的容错回执读取,而非逐条命令白名单。保持普通 status、精确结算和消费额度的读取严格;有 Turn 时保持 native fence。
对照 最新主干 候选
有效原回执,随后出现同范围有效新轮次 旧失败回报仍写入 旧 ACK / 失败回报均拒绝,状态不变
只有另一实例的同名原回执 missing,未写 写入 cadence
坏行下用手工 ACK 写入成功 带或不带 Turn 均在收集状态时失败
坏行下普通 quota status,前后只做一次 ACK 预览 两次均能读;旧解码尚未拒绝该字节 先失败,后从同一 key 命中缓存并报成功

仓库源码:260 个 TypeScript 用例通过;Python 比较为候选 193 通过、4 失败,最新主干 183 通过、4 失败。4 个失败的测试 ID 相同;抽取的 SQLite 失败都出现在未指定真实交付目录的生成命令,并且都没有追加写回。 从候选源码构建、安装 wheel,在隔离的 SQLite fixture 中直接运行已安装的 loopx,重现缓存、手工 ACK 和 GoalRef 对照。 typecheck:control-plane、diff 检查和提交 DCO trailer 检查通过。上述四个测试的生成命令工作目录问题单独保留;候选变化不在交付目录判定路径上。仓库合并门仍是 Sign-off 和 merge-gate;本轮不查询或等待远程 CI。

我的整体评价 / Verdict

请求修改。正确的普通回报已恢复,但异实例回执仍能写、预览能掩盖坏历史,手工 ACK 还会被提前拦住。 回报归属由既有 native fence 判定并锁内复核;容错的 status 数据不与严格缓存共用,手工与 current 命令调用同一个调度专用读取。 复验需保持真实的同范围后继拒绝、坏行下当前回报可用、锁内复验和零额外扣额。核验范围是 Trae 兼容 CLI、JSON 结果、wheel 控制台入口及调度状态文件;无改动到渲染界面。 原生 Windows、真实 Trae/Codex 宿主 UI、source-session 重建后的真实宿主旅程及托管 CI 未在本地运行。

English verdict: REQUEST_CHANGES. The exact head rejects genuinely stale callbacks and restores valid current callbacks beside corrupt rows. It still accepts a foreign Goal-instance receipt in the legacy CLI, leaks tolerant data into strict quota status, and breaks manual ACK recovery. Verified against real File/SQLite CLI state and the installed wheel.

Comment thread loopx/cli_commands/quota_context.py Resolved
Comment thread loopx/cli_commands/quota_context.py Resolved
@mergify

mergify Bot commented Nov 13, 2026

Copy link
Copy Markdown

Hi @gcl-coder, the DCO Sign-off check did not pass. Please inspect
its details first: checkout, fetch, timeout or infrastructure errors
need their own recovery, not a rewrite of otherwise signed commits.

If the log confirms a missing Signed-off-by trailer, amend the
affected commit with git commit --amend -s; for multiple commits,
use an interactive rebase against the current base from the correct
base-repository remote and sign off each affected commit. Push the
rewritten PR branch with git push --force-with-lease origin HEAD.

@gcl-coder
gcl-coder force-pushed the fix/scheduler-heartbeat-receipt-fence branch from 3344fc8 to 7e58c83 Compare November 13, 2026 08:12

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · reasoning_effort=max

复审 7e58c83f1ebc376d0281475de4a4f50788c884e9,请求修改。

  • [P2] 原生命令丢了 Goal 实例范围,会拒绝原回执。 读取器的缺省分支 现在只接收无 goal_ref 的行。真实 should-run 生成的 ACK 和 failure CLI 不携带实例身份,原生 argv 解码 也没把它传入事务。在 File 和 SQLite 的独立运行时里,给真实 CLI 产生的单条原回执加上精确实例标记,再运行原命令:基线四组均写入;此提交四组均返回 heartbeat_receipt_missing,未写状态。补一条同 Turn、无实例的对照行才会写入,说明读取的范围变了。该探针隔离了真实命令与读取边界;两版本普通 CLI 都拒绝生命周期专用 registry,不能据此宣称整个 source session 宿主已走通。请在现有 hint 生产、解码与持锁事务之间传递并校验同一个原始 GoalRef,区分显式 legacy 和身份缺失,补真实生成命令的 ACK/failure 对照。
  • [P2] 诊断审计行不应使当轮回执过期。 后继扫描 找到原回执后,仍能把没有 run_id、但标着 normal_run 且两个详情布尔值为真的审计行当成后继。真实兼容命令在单个隔离运行时复现:追加这条历史形状后,基线能回写,当前返回 heartbeat_receipt_stale,状态字节不变;原生入口在基线已存在这个分岔。普通无 Turn CLI 产生的审计行对照不触发问题,单独的无身份行也不能授权。请让首发和后继扫描都消费同一合格回执集合;回归覆盖“有效原回执 + 无 Turn 审计”和“有效原回执 + 有身份同范围后继”,分别要求写入和拒绝,均零扣额。

动机 / Motivation

负责更新自动化节奏的宿主,需要把本次实际应用的节奏或更新失败写回 LoopX。

过去兼容入口会让迟到的回报覆盖当前节奏;这次修复挡住真正的旧回报,却也会在两种可复现的情况下拒绝当前回报。

宿主应能回写当前轮的真实结果,拒绝被有效新轮替代的回报,原样重试不应重复写入或扣额。

本次范围是本地调度回报与回执读取,不新增执行权限、调度配置或扣额路径。起因见 #8605。

改动思路 / Approach

保留 TypeScript 调度事务作为回执资格的唯一裁判,兼容入口只传事实。原生和 Python 路由同时保留,但两条路线必须表达同一个实例范围,且只用合格回执判断谁能使旧轮失效。把精确回执范围加在共享读取器而漏接宿主入口,会让正确性依赖调用者选择哪条命令。

把实例范围和审计行资格收敛到同一回执所有者;容错视图只服务调度回报,普通状态与结算继续严格读取。保留已有真实命令、两种 provider 和写前复验;无需为这两项反例再加 Python 扫描。对照 #8606 的草稿范围,单传 Turn 仍未解决损坏历史与实例范围。采用仓库先验证原回执能继续产出结果的经验,用写入、拒绝、重放、零扣额判断,未复用旧结论。

具体改动 / Changes

关键代码讲解

  1. build_scheduler_followup_payload 重建兼容回报;_run_native_followup 转交原 Turn 和 GoalRef,evaluateSchedulerHeartbeatCommit 在状态锁内复查。直接宿主命令仍走独立的 argv 解码,漏掉实例。
  2. heartbeatReceiptStatus 对首条和后继行过滤实例,但后继还保留诊断行特判。默认未传实例与显式旧范围目前被合并。
  3. readReceiptLogSnapshot 严格解码完整行和临时尾行;坏字节只留下位置。结算和 replan 历史默认拒绝坏行,调度入口可忽略坏行继续,且不写普通投影缓存。
  4. prepare_quota_command_context 将容错限制为三个调度回报命令;手工 scheduler-ack --use-current-hint 带或不带 Turn 均通过坏行回归。测试还覆盖缓存、锁竞争和历史读者。全 PR 20 路径,生产 +252/-59、测试 +656/-1。上一轮的手工 ACK 和严格缓存问题已修,兼容事务的实例过滤也已通过,真实生成的原生命令仍有上述缺口。

规范:docs/reference/protocols/host-integration-plugin-plan-v0.md,版本 eba8a7f95f54fe09cb3dcc28bb1f55443898bbed(Phase 3)。

  • Phase-3-Ordering:implemented。 合格同范围后继挡旧轮;真正后继与锁竞争测试通过。
  • Phase-3-ReceiptValidity:not_met。 坏字节不会伪装成回执;缺实例传输和无身份后继仍不符契约。
  • Phase-3-Replay:implemented(已验的 legacy 路径)。 原生精确重试返回 replay,调度状态字节保持不变,无扣额;实例路径受第一个发现阻塞。

对主干的风险 / Risks

PASS:51 个 scheduler Python 测试、182 个 scheduler/receipt/settlement TypeScript 测试,File/SQLite 的损坏行兼容及缓存隔离,旧范围健康 ACK 和重放,diff 检查与六项直接 premerge 检查。局部 lint 中 status.py 的两条重复导入在基线和当前头相同。托管 CI 未查询。

FAIL:真实原生命令的实例回执反例和兼容 ACK 的诊断行反例。两者都可让宿主实际状态已变而 LoopX 无法确认;继续用相同输入重试不会修复身份。针对性回归可放在 tests/control_plane/test_scheduler_heartbeat_receipt_fence.py,在同一隔离运行时验证 File/SQLite 回执来源、写入与零扣额。

语义与 CI 对齐

复用现有 GoalRef、Turn 和回执词表。当前同一个已发命令会因范围缺失拒绝有效回报,审计行也越过了回执资格;修复传输和资格后重跑 python -m pytest tests/control_plane/test_scheduler_heartbeat_receipt_fence.py 和 node --test tests/control_plane_ts/scheduler_heartbeat_followup_cli.test.ts。Quick premerge 的 dashboard 状态预算在基线与此头均超限,临时路径不同,未据此判定无增量或放宽门槛。Windows、实际宿主 UI 和生命周期专用 registry 的完整 CLI 链路未验。

我的整体评价 / Verdict

请求修改。兼容路线采用共享事务是正确方向,三项旧发现中已有实质修复。当前两个反例都会中断调度回报,增加后续轮次和人工恢复成本。把实例范围和审计行资格收敛到同一回执所有者;容错视图只服务调度回报,普通状态与结算继续严格读取。验证旧式命令正常,实例命令可续接,重放无额外状态写入,再复审。没有合并结论。

English verdict: REQUEST_CHANGES. At 7e58c83 the generated native ACK/failure CLI rejects instance-tagged receipts; the compatibility ACK also treats a Turn-less diagnostic row as a successor.

@mergify

mergify Bot commented Nov 14, 2026

Copy link
Copy Markdown

This pull request has merge conflicts with main and cannot be merged
until they are resolved. Please rebase or merge the base branch, @gcl-coder.

Choose the remote for the base repository, not an out-of-date fork.
For a fork clone, first inspect git remote -v; upstream must point
to https://github.com/loopx-project/loopx.git. If it is absent, add it
with git remote add upstream https://github.com/loopx-project/loopx.git.
Then run:

git fetch upstream
git rebase upstream/main
# Resolve each conflict, git add the resolved files, then git rebase --continue.
git push --force-with-lease origin HEAD

For a same-repository clone whose origin points to
https://github.com/loopx-project/loopx.git, use origin instead of
upstream for fetch/rebase. If you prefer merging the base, use
git merge <base-remote>/main and push normally.

Keep the DCO Signed-off-by trailer on every commit when you rebase.
https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork

@mergify mergify Bot added the needs-rebase Mergify: the pull request has merge conflicts with its base branch label Nov 14, 2026
@mergify mergify Bot removed the needs-rebase Mergify: the pull request has merge conflicts with its base branch label Nov 14, 2026

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · reasoning_effort=max
Reviewed commit: 1c6d88300bc9ec1180ea8cf0eb43951345854060 · merge base ebbbb541f9fce68acc3e7248de84833eff620e44.

[P2] 已提交的新回执只损坏说明字段就会恢复旧回报的写权限。 实际运行两次 quota should-run,仅让第二条有效回执的 summary 含无效 UTF-8,保留 Turn、Goal、Agent 和其他字段,然后执行第一条的 ACK 或 failure。 当前头把后继隐藏于解码记录以外并以 fresh 提交。完整回执的旧回报会拒绝。File/SQLite 两种兼容命令均改变持久化状态,原生边界也复现。 同一持锁入口必须区分无后继和存在无法确认的潜在后继;复用已有 admission 身份,或在可归属且影响新旧判断的损坏后继上拒绝旧写。 代码位置

[P2] 按 Goal 实例读回执却共用调度文件和重放键。 在原生绑定 CLI 的隔离夹具中,为同 slug/Agent 的两个真实回执行分别加不同 GoalRef。让新实例先回报 30 分钟,再送入旧实例 15 分钟的 ACK。 两个写入返回 written 并指向同一个状态文件,旧 ACK 把新实例的 30 分钟重置为 15。语义事实相同时旧实例也能重放新实例的提交元数据,返回 replayed。 让持锁提交同时校验当前实例的写入归属及重放范围,或用同一 typed owner 隔离按实例持久化的状态与读取。 代码位置

[P2] 合并主干后维护刷新无法返回原轮待结算信息。 已有一轮 admitted 工作尚未结算时,用同一 Agent 执行只更新安装状态的 refresh-state。 调用继续传 pending_closeout=True,但分支移除了 Python 参数和 TS 选择器。File、SQLite × 两个 Host 配置的主干回归用例从 4 通过变成 4 失败,当前头没有预期 JSON。独立原生读回也不再正确处理待结算状态。维护者无法按输出的原身份命令续结算。 合并保留主干的 pending_closeout 参数、单快照选择和既有回归覆盖,将容错限制在调度回报。保留未完成轮次,只在其原身份下继续。 保留的调用 · 基线回归

动机 / Motivation

Host 执行一次 quota should-run 后将 ACK 或调度失败交回已有 CLI。Core 把回报写入下一次调度会读取的状态。 分支基线的 Python 兼容调用漏传 Turn,允许延迟回报写入。基线原生调用在新行的说明字节损坏时仍能拒绝旧回报。上一轮原生 argv 拒绝实例回执,并把含诊断布尔字段的无 Turn 旧形状当后继。 只有当前回执能提交 host 回报,后续 Turn 使旧回报失效。同一 slug 下的实例边界要约束回执和实际写入。 当前问题

基线与当前实测。分支基线的 Python 兼容调用漏传 Turn,允许延迟回报写入。基线原生调用在新行的说明字节损坏时仍能拒绝旧回报。上一轮原生 argv 拒绝实例回执,并把含诊断布尔字段的无 Turn 旧形状当后继。 并入主干时去掉了待结算恢复的 Python 参数和 TS 分支,原 refresh-state 调用仍传 pending_closeout=True。

File 与 SQLite 上的真实兼容 CLI 现在给完整的新回执拒绝旧 ACK 和 failure,四个反例都没有更改状态。追加无 Turn 的 normal_run 审计行及无关损坏审计的对照仍能写当前回报,均零扣额。新增原生覆盖验证 GoalRef 传入和两把锁内的二次检查。现有缓存用例确认容错读不写严格投影缓存。 兼容 CLI 使用隔离的真实 File、SQLite registry 与回执。原生 CLI 用独立构造的有界 host facts;实例对照在真实回执上注入 exact 引用,验证的是原生写边界和状态字节。

改动思路 / Approach

Python 对外门面提供结算兼容数据,原生类型化回执读取器负责收原 Turn 和后继。提交在 scheduler-state 与 rollout 两把锁下校验后写状态。旧设计的状态路径和事务摘要仍按 slug、Agent、Host 与 state key 归属。 把 Turn 与 GoalRef 通过现有有界 hint 透传。共享 UTF-8 解码器登记错误行。普通状态与结算继续严格读取,兼容回报只读容错视图。现在 freshness 投影忽略损坏行的位置,exact GoalRef 只用在这一投影。 兼容 CLI 使用隔离的真实 File、SQLite registry 与回执。原生 CLI 用独立构造的有界 host facts;实例对照在真实回执上注入 exact 引用,验证的是原生写边界和状态字节。

具体改动 / Changes

依据 docs/reference/protocols/host-integration-plugin-plan-v0.md 在 ebbbb541f9fce68acc3e7248de84833eff620e44 的条款。Host 协议定义回报新旧关系。Goal 身份 RFC 明确生命周期写入范围。 主规范 · 关联条款

  • newer_turn_fences_old_write · 未满足。已有同范围后继时拒绝旧回报,在故障视图里不悄悄恢复被撤销的写权限。

  • goal_lifetime_at_commit · 未满足。已绑定实例只能控制其所有的调度状态,重放依赖同一生命周期。

  • qualified_receipt_and_legacy_view · 通过。原生支持实例回执,能跳过无身份审计,保持严格状态缓存及现有旧格式的正常回报。

  • preserve_main_pending_closeout · 未满足。主干的维护刷新保留原轮待结算状态和继续命令。 基线读回用例

关键代码讲解

25 个文件,跨兼容 CLI、缓存、结算、历史解码、原生回报和测试。原生读者共享记录结构和锁,分支扩大了旧回报可以读过损坏的范围。 本提交的原生实测接收了标注实例的回执,普通无 Turn 审计对照仍能回写。此前两个独立反例的修正保留。 上一轮评审

对主干的风险 / Risks

PASS · File 与 SQLite 上的真实兼容 CLI 现在给完整的新回执拒绝旧 ACK 和 failure,四个反例都没有更改状态。追加无 Turn 的 normal_run 审计行及无关损坏审计的对照仍能写当前回报,均零扣额。新增原生覆盖验证 GoalRef 传入和两把锁内的二次检查。现有缓存用例确认容错读不写严格投影缓存。 Python 当前头 74 / 基线 56 项通过,原生 TypeScript 当前头 184 / 基线 193 项通过。

FAIL · 两条真实 quota should-run 回执均已提交时,仅给第二条的 summary 放入一个无效 UTF-8 字节,保留所有身份及 admission 字段。完整对照返回 heartbeat_receipt_stale;损坏对照的旧 ACK/failure 在 File 与 SQLite 兼容入口均写状态,原生绑定命令的独立夹具也复现。另一组在真实回执行中注入两套 exact GoalRef,先提交新实例 30 分钟的 ACK,再提交旧实例 15 分钟 ACK,两后端复用同一状态文件并改回 15 分钟;相同语义事实时跨实例直接返回 replayed。

原生 CLI 对照 实际旧回报
同范围的新回执完整 拒绝,状态无变化
只损坏新回执说明字节 恢复旧回报写入
不同实例,新实例已写入 30 分钟 同一文件被旧 ACK 改回 15 分钟

并入主干的当前头在同样的真实 File/SQLite 夹具上,四个维护刷新用例均失败,基线四个通过。把同一个已删除的原生用例接回后,基线的 8 项通过,当前头 8 项失败。重跑 tests/control_plane/test_refresh_settlement_recovery.py 中 test_rejected_write_and_upgrade_state_recover_original_turn_once,以及基线保留的原生 pending closeout 用例。 丢失读回入口

语义与 CI 对齐

沿用持锁提交,在同范围较新回执无法验证时返回不可确认状态,或使用已经拥有该次 admission 的结构化证据。让 exact 实例来源的状态写入和重放受同一个生命周期限制,旧实例不能覆盖当前实例的文件。 Git diff --check 通过。与检查时主干模拟合并无冲突,两个最新分支提交缺 Signed-off-by。 可重跑 uv run --extra test python -m pytest -q tests/control_plane/test_scheduler_heartbeat_receipt_fence.py 和 node --experimental-strip-types --test tests/control_plane_ts/scheduler_heartbeat_followup.test.ts tests/control_plane_ts/scheduler_heartbeat_followup_cli.test.ts。 用源码 CLI、真实 File/SQLite 及原生有界参数夹具复验。exact GoalRef 注入只覆盖原生边界,未跑源 registry 生命周期全程、打包安装态、实际 Codex/Trae 调度 UI 或托管 CI。

我的整体评价 / Verdict

过期回报可以使接续轮次退回旧频率或把旧失败抑制写进新轮次。被损坏的有效回执也无法再保护已有的 cadence 决策。 操作者更新节奏后,迟到的回报仍可能把本机调度改回旧值;同一实例重试与跨实例写当前响应也应可区分。 既有 legacy 无实例路径保留。修复 exact 路径时应维持原有 cadence、状态读取与重放合同,并按既有生命周期 owner 校验或隔离实例能力。

English verdict: REQUEST_CHANGES. The exact head reopens stale host writes after corruption of a committed successor, lets an old Goal instance overwrite scheduler state, and regresses mainline pending-settlement recovery.

@mergify

mergify Bot commented Nov 14, 2026

Copy link
Copy Markdown

Hi @gcl-coder, the DCO Sign-off check did not pass. Please inspect
its details first: checkout, fetch, timeout or infrastructure errors
need their own recovery, not a rewrite of otherwise signed commits.

If the log confirms a missing Signed-off-by trailer, amend the
affected commit with git commit --amend -s; for multiple commits,
use an interactive rebase against the current base from the correct
base-repository remote and sign off each affected commit. Push the
rewritten PR branch with git push --force-with-lease origin HEAD.

@gcl-coder

Copy link
Copy Markdown
Contributor Author

两个 P2 都已在 5674551050(现头 20022d931)修好,另外补修了我上一版合并树丢的主干改动。

Goal 实例范围(argv 路径)。 新增 _scheduler_host_followup_goal_ref(),从 hint 的 payload["goal_ref"] 取出原始实例,沿 _scheduler_host_followup_transport_args → _encode_followup_args → _finish_transport → _project_hint 一路透传到 heartbeat_followup_cli.ts;ACK 与 failure 两个 builder 都带 goal_ref,heartbeat_followup.ts::requestObject 校验实例格式并与 goal_id 一致,heartbeatReceiptGoalRef 在状态锁内再复核一次。显式旧式入口(不带 goal_ref)仍解析成“无实例范围”,只匹配没有实例标记的旧记录;请求实例 A 而日志只有实例 B 的回执现在报 heartbeat_receipt_missing,不写调度文件。回归:真实 CLI 产生的单条原回执加精确实例标记后,ACK 与失败返回都写入;换成另一实例后两个命令都 missing、零写入、目录里只剩日志。

诊断审计行。 新增 scopedHeartbeatReceipts(),首发回执与后继扫描共用同一份合格回执集合(heartbeatReceiptsFromEvents 已滤掉没有 run_id 的行,再按 receiptMatchesGoalRef 收窄),删掉了 normal_run/details.ok 的特判。无 Turn 的守卫行既不授权也不淘汰原回执;带身份的同一范围新轮次仍然 heartbeat_receipt_stale 且调度文件字节不变。原有那条“successful identity-less quota guard cannot supersede a host receipt”的用例改成先断言可写入,再追加真实新 Turn 断言 stale。

合并回修。 复验时发现我上一版合并提交把本分支的 settlement.py / settlement_readback.ts 整份当作结果,静默丢掉了主干新增的 pending_closeout、PowerShell 路由渲染和 settlement recovery markdown,refresh-state 会直接 TypeError。20022d931 用三方合并重建这两个文件(父提交就是上一版合并),保留本分支的 tolerate_malformed_history 与主干的新参数,两者现在同时生效。

验证范围:以 ebbb541f 为主干、只覆盖本 PR 的路径重建了本地树。node --test 的 followup CLI、receipt log、settlement readback 共 177 项通过;test_scheduler_heartbeat_receipt_fence.py、test_scheduler_host_followup_hint_transport.py、test_scheduler_hint_single_request.py 共 39 项通过。test_quota_settlement_cli.py -k exact_later_ack 4 项和 test_refresh_settle_turn.py 18 项失败,但在纯主干树上逐项复现同样的失败(delivery workspace could not be verified,本机 cwd 不在项目目录),不是本分支引入。新头的 CI 刚排队,结果出来我再跟进;Windows、宿主 UI 未验证。

@mergify

mergify Bot commented Nov 14, 2026

Copy link
Copy Markdown

Hi @gcl-coder, the DCO Sign-off check did not pass. Please inspect
its details first: checkout, fetch, timeout or infrastructure errors
need their own recovery, not a rewrite of otherwise signed commits.

If the log confirms a missing Signed-off-by trailer, amend the
affected commit with git commit --amend -s; for multiple commits,
use an interactive rebase against the current base from the correct
base-repository remote and sign off each affected commit. Push the
rewritten PR branch with git push --force-with-lease origin HEAD.

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · reasoning_effort=max
Reviewed commit: 20022d9311dcf251359da84961573d95e8487fb8 · merge base ebbbb541f9fce68acc3e7248de84833eff620e44.

[P2] 损坏的新回执恢复了旧回报的写入资格。 连续执行两次真实 quota should-run,只在第二条已提交回执的 summary 注入一个非法 UTF-8 字节。 两次实际 should-run 都已提交,只把第二条回执的 summary 加入非法 UTF-8 后,File 与 SQLite 的旧 ACK 和失败回报共四组均写入。完整后继在相同四组均返回 heartbeat_receipt_stale,文件字节无变化。原生边界也复现此差异。 在同一持锁提交入口保留候选回执的损坏信息,或复用已提交的准入身份来识别后继。只有确认无同范围后继才能写入,同时保留无 Turn 诊断行的现有行为。 后继检查

[P2] Goal 实例隔离在写入和重放前丢失。 同一 Goal slug 的两个实例均有对应回执。新实例先提交 ACK,再发送旧实例的回报。 两个实例的同 slug、Agent、Host 和 state key 最终使用同一个状态文件。新实例先写入 30 分钟,旧实例随后写回 15 分钟。若两笔回报的语义字段相同,旧实例得到新实例提交的 replayed。File 与 SQLite 均复现。 让调度状态的读写和重放使用同一个 Goal 生命周期范围。复用现有权威实例校验,或按实例隔离状态路径及重放键,并验证已激活实例的旧回报无法影响新实例。 持锁提交

动机 / Motivation

Host 在每轮 heartbeat 后,通过已有 CLI 回报已应用的调度频率,或登记应用失败。 此前 Python 兼容入口只确认原回执存在。较新一轮已经开始时,旧回报仍然可以改写下一轮读取的调度状态。 例如两轮都已提交回执,第一轮的回报随后才到。当前提交能拒绝这笔旧回报。只损坏第二条回执的说明字段后,旧回报又能写入。 这会让下一轮沿用过时的频率或错误抑制自动调度。 回报使用原 Turn,且只在所属 Goal 实例的范围内获得写入或重放资格。 原问题 #8605

File 与 SQLite 均拒绝完整后继之后的旧 ACK 和失败回报。无 Turn 的诊断和其他实例的后继保留有效回报。严格 status 缓存未被容错视图写入。维护刷新在四组原生 CLI 回归中恢复原 Turn。 这里验证源码 CLI、隔离的 File 和 SQLite 存储及当前主干的模拟合并树。两个 Goal 实例的对照在真实回执中注入 GoalRef,覆盖原生提交边界。实际宿主 UI、Windows 和已安装运行时未验证。

改动思路 / Approach

Python 只转交原 Turn 和 GoalRef,TypeScript 在收到请求和持锁写入时读取同一来源。容错状态收集只服务调度回报,严格结算和共享 status 缓存沿用原有路径。 回执读取和调度提交已有各自的负责模块。容错可用于诊断,但提交必须核对现行实例及后继回执。 这里验证源码 CLI、隔离的 File 和 SQLite 存储及当前主干的模拟合并树。两个 Goal 实例的对照在真实回执中注入 GoalRef,覆盖原生提交边界。实际宿主 UI、Windows 和已安装运行时未验证。 直接透传可以修复完整旧回执的越权写入。下一步应在既有提交事务补齐损坏回执及实例范围,维持单一决策入口。日志提供原轮和后继,锁内同时校验持有者和写入资格,下一轮读取同一份已验证的结果。 相关提案 #8606

具体改动 / Changes

按 Phase 3 和 Goal 生命周期的条款逐项对照。 Host 协议 Goal 实例约束

  • newer_turn_fences_old_write · 未满足。完整后继阻止旧回报,损坏的已提交后继会被过滤。
  • goal_lifetime_at_commit · 未满足。回执过滤按实例,持久化与重放范围仍共用。
  • qualified_receipt_and_legacy_view · 已验证。无身份诊断保留现行回报,严格读回和缓存独立。
  • preserve_main_pending_closeout · 已验证。恢复原 Turn 的结算与接续命令。

关键代码讲解

有效差异 25 个文件,生产改动覆盖 Python 命令与状态投影、TypeScript 结算与共享日志解码、原生调度回报与锁内提交。配套 Python 和 TypeScript 回归覆盖这些路径。 GitHub 以滞后的 base 快照显示 179 个文件,其中额外路径已在 main。上述 25 个路径与当前 main 模拟合并的实质增量一致。与上次评审相比,当前提交恢复了两个结算文件的读回逻辑。 上一轮评审

对主干的风险 / Risks

PASS · 当前头 74 项 Python、184 项 TypeScript 通过。分支基线和当前主干各 56 项 Python、193 项 TypeScript 通过。 恢复主干待结算读取后,4 项兼容入口、16 项本地重跑的原生断言通过。原生测试仍从分支删除,建议直接保留已验证的覆盖。 Git 差异检查通过,当前主干模拟合并无冲突。当前分支有 3 个提交缺少 Signed-off-by,属于独立合并门。

FAIL · 两次实际 should-run 都已提交,只把第二条回执的 summary 加入非法 UTF-8 后,File 与 SQLite 的旧 ACK 和失败回报共四组均写入。完整后继在相同四组均返回 heartbeat_receipt_stale,文件字节无变化。原生边界也复现此差异。 两个实例的同 slug、Agent、Host 和 state key 最终使用同一个状态文件。新实例先写入 30 分钟,旧实例随后写回 15 分钟。若两笔回报的语义字段相同,旧实例得到新实例提交的 replayed。File 与 SQLite 均复现。 模拟合并树仍可复现两项。将真实后继、损坏后继、无关诊断和跨实例回报用同一持久化断言比较,可以检出这两处问题。用 uv run --extra test python -m pytest -q tests/control_plane/test_scheduler_heartbeat_receipt_fence.py 复跑现有兼容检查,继续加入上述两组负例。

语义与 CI 对齐

普通 status 的严格读回保留原错误,调度容错视图未写入共享缓存。兼容回报的实测场景均无额外扣额。托管 CI 未查。GoalRef 注入仅覆盖原生提交边界。

我的整体评价 / Verdict

REQUEST_CHANGES。保留原 Turn 透传和已恢复的主干读回。这会让下一轮沿用过时的频率或错误抑制自动调度。 在同一持锁提交入口保留候选回执的损坏信息,或复用已提交的准入身份来识别后继。只有确认无同范围后继才能写入,同时保留无 Turn 诊断行的现有行为。 让调度状态的读写和重放使用同一个 Goal 生命周期范围。复用现有权威实例校验,或按实例隔离状态路径及重放键,并验证已激活实例的旧回报无法影响新实例。 两项都能在当前调度事务中闭合,之后再对照主干验证。

English verdict: REQUEST_CHANGES at 20022d9. The pending-settlement recovery passes. File and SQLite still allow stale scheduler writes after corruption of a committed successor and allow different Goal instances to overwrite or replay each other's scheduler commits.

@gcl-coder
gcl-coder force-pushed the fix/scheduler-heartbeat-receipt-fence branch from 20022d9 to fb85ebb Compare November 14, 2026 11:10
@gcl-coder

Copy link
Copy Markdown
Contributor Author

补一句:上一版头的三个提交(5674551050、1c6d88300、20022d93)漏了 DCO 尾注,Sign-off 检查因此失败。我按相同树重写了这三个提交,只加 Signed-off-by,PR 现头是 fb85ebbd14(1c6d88300 的树与 dedc27143 的树内容一致,dedc27143 保留上一轮修好的合并结果)。文件内容与上面描述的修复完全相同。

@hhyykk hhyykk mentioned this pull request Nov 14, 2026
12 tasks done

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · reasoning_effort=max

复审 fb85ebbd1481bc5a599902b615ee9ac2f1356420,请求修改。GitHub 目标 SHA 859a23ee9534539536343206e23452253528dd07,共同基点 ebbbb541f9fce68acc3e7248de84833eff620e44;当前主干 4604f938b612c5da0d8a3485ce563bea922fc14e 的合并树 32ae47acb31a3630677a9379644c63d6c19f9664 无冲突。相对于上一轮的 20022d9311dcf251359da84961573d95e8487fb8,当前源码树完全相同,DCO 签名已补齐。两项核心反例已在当前提交重新复现。

[P2] 已提交后继的日志受损时,旧回报重新获得写入资格。 用两次真实 should-run 产生同范围回执,只向第二条已经提交的回执 summary 加入一个非法字节。 File 和 SQLite 上各跑 ACK、失败两条兼容命令:完整后继四组都拒绝且零状态写;只损坏已经提交的后继的说明字段,四组都写入。无 Turn 的坏诊断不会挡住仍有效的回报。 使用已提交的准入身份判断后继是否存在;日志尾部的坏行既不能凭空制造一个后继,也不能把已提交的后继当成不存在。按同一范围在持锁写入前复验,保留无 Turn 诊断的行为。 代码

[P2] 旧 Goal 实例可以覆盖或重放新实例的调度状态。 用相同 Goal 名、Agent、宿主和 state key;让新实例先提交,再回报带旧 GoalRef 的原轮。 同名 Goal 的新实例先写入 30 分钟。旧实例在 File、SQLite 配置的原生提交中都覆盖成 15 分钟;使用同一语义输入时,旧实例还能得到新实例的 replayed。主干同一原生对照拒绝旧回报且状态未变。 在现有提交事务内读取当前权威 Goal 实例,并在写入与重放之前拒绝旧或缺失的实例绑定;由同一所有者限定状态及重放范围。保留未激活的旧项目路径,验证实例切换前后都可恢复。 代码

动机 / Motivation

自动化宿主回报调度已生效或应用失败时,会使用上一轮生成的 heartbeat 回执。 例如两轮 heartbeat 均已提交,第一轮的回报迟到。现有 Python 兼容命令接受这笔旧回报;这个版本能挡住完整的后继,但只损坏第二条回执的说明字段,旧回报又能写入。 下次 heartbeat 可能沿用旧频率,或把已经切换的环境当成仍在失败。 当前实例的新一轮应继续工作;被取代的回报和其他实例的回报应在写入前拒绝,原命令重试只读取本实例原结果。 本 PR 的范围是本地宿主调度回报的原 Turn、当前实例和持锁写入,包含兼容 CLI 及 native 入口。

改动思路 / Approach

复用一处原生校验是合适的。让该事务分清日志容错和写入资格,并在同一事务核实当前 Goal 实例。 本 PR 的范围是本地宿主调度回报的原 Turn、当前实例和持锁写入,包含兼容 CLI 及 native 入口。 维持现状会保留完整后继之后的旧写入;仅透传 Turn 能挡住完整后继,却不能判断损坏的已提交后继或当前 Goal 实例。沿用现有调度事务与准入身份,避免在 Python 追加第二套资格规则。

现有 TS 事务在入口和锁内统一判断;兼容 Python 透传原轮和实例,有界宿主命令也能送达同一校验。普通状态与结算仍需要严格读回,调度回报可以跳过不相关的坏诊断。GoalRef 过滤可以防止其他实例的回执冒充原回执,但写入和重放还必须看哪个实例当前有效。对照了 #8605 与 #8606 当前方案;后者缩小了接线、复用了 scope 判断,源码仍按记录序列判定 freshness、保持共用状态路径。

具体改动 / Changes

25 个实际文件(+1134/−244):18 个生产文件覆盖 Python 命令和状态投影、TS 回执读取和原生调度事务,7 个测试文件。以当前主干模拟合并树复核增量,审过整个差异。 依据宿主 Phase 3和现行 Goal 实例写入矩阵判断。

验收场景 实测
stale_turn_before_write:完整后继及部分损坏的已提交后继 完整时 File 和 SQLite 的 ACK / failure 均拒绝;损坏时四组均重新写入。
current_instance_before_write_or_replay:同名 Goal 的新实例已开始 旧实例可以覆盖新实例节奏,或读到新实例的重放。
current_receipt_retry:按当前回报的相同命令重试 当前回报可写;同一命令重试回读原结果。
diagnostic_and_closeout:诊断与待结算恢复 无 Turn 的坏诊断不会挡住当前回报;原轮结算恢复通过。

关键代码讲解

  • _run_native_followup:Python 传原始 Turn 和 GoalRef。 有 Turn 时必须校验回执。
  • requestFromArgs:宿主命令从有界参数解码原实例。 接收的目标、Agent 和 Turn 必须与运输内容一致。
  • heartbeatReceiptStatus:先找原轮,再检查可识别的同范围后继。 过滤后的记录无法区分损坏的已准入后继与无后继。
  • evaluateSchedulerHeartbeatCommit:在状态锁内复读原轮及所属实例。 共享文件和 effect 摘要仅使用 Goal 名称,未查当前实例。
  • prepare_quota_command_context:回报可以容错收集历史,跳过写入共享缓存。 严格读回与容错投影隔离。
  • readQuotaSettlementFromSnapshot:原轮尚应 closeout 时沿原绑定恢复。 普通结算继续使用严格快照。

对主干的风险 / Risks

候选源码 Python 129 项通过、10 项跳过;TypeScript 212 项通过,当前主干模拟合并树 218 项通过。Git diff、DCO、双语 RFC 检查通过。Ruff 的两个既有重复导入告警在主干、候选和合并树相同,发生于本 PR 未改的行。

完整后继能让 File 和 SQLite 的兼容 ACK 与失败回报都返回 heartbeat_receipt_stale,当前回报仍可写入。两种存储的宿主原命令完全相同地重试时回读原结果,状态字节、所检查的额度日志及 run index 均不变。严格 status 在坏行时仍报错,兼容回报没有写入通用缓存,主干待结算入口已保留。 File 和 SQLite 上各跑 ACK、失败两条兼容命令:完整后继四组都拒绝且零状态写;只损坏已经提交的后继的说明字段,四组都写入。无 Turn 的坏诊断不会挡住仍有效的回报。 同名 Goal 的新实例先写入 30 分钟。旧实例在 File、SQLite 配置的原生提交中都覆盖成 15 分钟;使用同一语义输入时,旧实例还能得到新实例的 replayed。主干同一原生对照拒绝旧回报且状态未变。 两项负例在主干模拟合并树均复现;纯主干下,兼容路径对完整或损坏的后继均能写入,原生路径在同一合成实例对照中拒绝旧回报。

语义与 CI 对齐

保留 Phase 3 据原轮回报、准确重试、等待下一轮的顺序。补回归时,用两次真实 should-run 区分真正的后继与无 Turn 的坏诊断,然后读回状态文件字节。另用两个有效 GoalRef 的对照验证当旧实例已失效时不能写入或复用新实例的结果。已验证源码 CLI、隔离的真实 File 与 SQLite、当前主干模拟合并。依照当前策略未查询托管 CI。跨实例对照给真实回执注入两个合成 GoalRef,执行的是原生 CLI 的提交路径;未执行实际项目移除和重建、宿主 UI、Windows 或已安装版本。

我的整体评价 / Verdict

REQUEST_CHANGES。保留完整后继拒绝、兼容透传和已恢复的主干结算读回。复用一处原生校验是合适的。让该事务分清日志容错和写入资格,并在同一事务核实当前 Goal 实例。 修复这两项后,以真实的后继和实例切换对照复验。此次检查调度 CLI、机读回报与状态读回,没有改变渲染页面或布局。

English verdict: REQUEST_CHANGES at fb85ebb. DCO is fixed. Compatibility ACKs and failures are fenced after an intact successor, but a damaged committed successor still permits stale writes. Native scheduler commits also let an old Goal instance overwrite or replay the new instance's state.

@mergify

mergify Bot commented Nov 15, 2026

Copy link
Copy Markdown

This pull request has merge conflicts with main and cannot be merged
until they are resolved. Please rebase or merge the base branch, @gcl-coder.

Choose the remote for the base repository, not an out-of-date fork.
For a fork clone, first inspect git remote -v; upstream must point
to https://github.com/loopx-project/loopx.git. If it is absent, add it
with git remote add upstream https://github.com/loopx-project/loopx.git.
Then run:

git fetch upstream
git rebase upstream/main
# Resolve each conflict, git add the resolved files, then git rebase --continue.
git push --force-with-lease origin HEAD

For a same-repository clone whose origin points to
https://github.com/loopx-project/loopx.git, use origin instead of
upstream for fetch/rebase. If you prefer merging the base, use
git merge <base-remote>/main and push normally.

Keep the DCO Signed-off-by trailer on every commit when you rebase.
https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork

@mergify mergify Bot added the needs-rebase Mergify: the pull request has merge conflicts with its base branch label Nov 15, 2026

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · reasoning_effort=max

评审提交 29237481900da6ef48da014870eb64f40605a56b。原差异基点 859a23ee9534539536343206e23452253528dd07。

动机 / Motivation

接收自动化调度更新回报的宿主,以及维护本地 Goal 生命周期和调度状态的操作者。 原基线的 Python 回报只确认原回执存在。第二轮已经准入时,第一轮的迟到消息仍可能更改频率或失败记录。当前主干已通过 #8708 把完整后继的拒绝统一到原生事务。 当宿主回报上一轮结果时,即使历史记录的说明损坏、上次写入中断,或同名 Goal 已重建,也应准确决定原轮还有没有权写入。仍有效的回报应可提交,并按原身份重试。 候选与当前主干都拒绝有完整后继的迟到回报。候选恢复了无关坏诊断后的合法回报,但仍会把真实后继和未写完的尾部判反。Goal 已重建也可出现旧实例回报继续写入。 本次覆盖源码兼容 CLI 的 File 和 SQLite、实际原生事务与本地真实 Goal 重建。精确实例回执由现有日志 API 在隔离 fixture 写入。未验证安装版、现场宿主调度 UI、Windows 或远程 CI。

改动思路 / Approach

保留已合入 #8708 的 Turn 透传和原生回执事务。用现有注册表及 Goal 生命周期的解析和写入边界核验当前实例,沿既有结构化准入回执区分已提交和截断数据。 透传精确身份、扩展必要的日志读取与系统状态校验。共同入口和兼容路径都应依赖同一持久化授权。 先以现有主干写回链为基础。将恢复证据和当前实例纳入各自现有 owner 的事务,减少对共享结算读取和通用注册表的新读法。 本 PR 的剩余边界是原 Turn 的损坏历史恢复、当前 Goal 实例的调度写入资格及原生回报的编译可用性。 GitHub 原差异基点与当前主干已分叉。基点、候选和当前主干用相同 CLI fixture 对照,当前主干经 #8708 挡住完整后继及原 summary 损坏例。

具体改动 / Changes

实际差异 27 个文件,新增 2005 行、删除 254 行。Python 覆盖命令、提示、状态和结算桥接。TypeScript 覆盖日志前缀恢复、回执资格、实例读取和调度提交,另有八个验证文件。 Python 路由透传原 Turn、registry 路由和 GoalRef。原生事务检查日志时序、持锁重验,随后写入原调度键。回报的容错读取与结算的默认严格读取分开,缓存不接收容错投影。 验收约定

关键代码讲解

  • 把调度回报的原 Turn 和 GoalRef 透传给原生事务。 _run_native_followup

  • 严格读取每条 UTF-8 记录,从坏完整行保留已解析的开头。 readReceiptLogSnapshot

  • 按原精确范围查找回执和可能的后继,坏行看可恢复字段。 heartbeatReceiptStatus

  • 在状态锁内查当前实例,否则使用标签过滤的旧回执路径。 evaluateSchedulerHeartbeatCommit

  • 普通结算保留严格读回,调度只读取可恢复的投影。 readQuotaSettlementSnapshot

  • issued-receipt-supersedes。只有已提交且同范围的回执可使旧 Turn 失效。 已提交的第二条回执只损坏一个早于身份字段的 boundary 字节,四组旧回报均写入。只写到说明中途的尾部本来不阻塞。正常追加 validation 事件补入换行后,四组回报都误报 stale。真实重建之后,旧的精确回报在顺序调用拒绝,在读完 registry 才重建的交错下仍写入。精确实例已存在时,无 GoalRef 的旧回报也可写入。

  • exact-lifetime-commit。激活实例要求同一有效 GoalRef,写入与重放服从提交时的生命周期。 已提交的第二条回执只损坏一个早于身份字段的 boundary 字节,四组旧回报均写入。只写到说明中途的尾部本来不阻塞。正常追加 validation 事件补入换行后,四组回报都误报 stale。真实重建之后,旧的精确回报在顺序调用拒绝,在读完 registry 才重建的交错下仍写入。精确实例已存在时,无 GoalRef 的旧回报也可写入。

  • current-receipt-replay。合法当前实例可提交。重复回报沿原回执且不扣额。 正向源码 CLI 和现有原生幂等用例通过,观察的额度和 run-index 字节无变化。

  • diagnostic-and-strict-closeout。无关诊断不阻塞回报,结算保留严格校验。 File 和 SQLite 的真实回报可跳过无 Turn 的无关诊断,严格缓存隔离与待结算样本通过。

对主干的风险 / Risks

[P2] 按可解析前缀误判后继已提交。 只改一个非身份字节,并保留第二条已提交回执的全部身份字段。File 与 SQLite 上的 ACK 和失败回报均接受旧轮写入。反向控制只写出了下一轮的截断前缀。使用仓库 writer 追加普通 validation 时,writer 补的换行让这条从未提交的回执使四组合法回报误报 heartbeat_receipt_stale。回执资格应依据可验证的已提交记录。 后继判断

[P2] 当前 Goal 实例的写入约束可被绕过。 在原生事务读完 registry 时暂停,让真实重建提交并读回新的 GoalRef,再恢复旧回报。ACK 和失败均在重建之后写入。重建先于进入事务的同组用例正确拒绝。精确实例存在时,无 GoalRef 的旧回报也可写入,即使新实例已有回执。提交时应持有同一生命周期约束,激活的实例要求有效当前绑定。 实例检查 匹配矩阵

[P2] 当前提交无法通过 TypeScript 和 registry I/O 检查。 候选的 npm run typecheck:control-plane 报 TS2322,基线通过。标准 canary 同时拒绝更改新增的未分类 registry 读取。复用受治理的解码和提交边界,明确成功路径中的实例类型。 类型检查位置

80 项源 Python 与 207 项原生测试通过,涵盖严格 status、容错缓存隔离和原轮结算。三份源码各执行 28 组真实兼容回报,实际核对 scheduler 状态字节和额度日志。另有八组原生实例用例。当前候选的六项直接检查、17 项 premerge canary 通过,词表架构检查失败。TypeScript 类型检查仅候选失败。预计合并到当前主干有三个文本冲突,未构造替代合并提交。

语义与 CI 对齐

复用现有 Turn 和 GoalRef 词表。强制约束来自宿主回报协议和 Goal 实例匹配矩阵,具有真正写入后果。重新使用受治理的 registry 读取和同一生命周期锁,补齐 TypeScript 联合类型。再次执行 TypeScript typecheck、词表 guard、真实 CLI 损坏对照和实例重建对照。

我的整体评价 / Verdict

REQUEST_CHANGES。 当前主干覆盖了原问题的完整后继场景。保留已通过的精确重试、无关诊断和严格结算路径,修复损坏日志及实例更换反例后再复审。合并树与当前主干仍有三处代码冲突。 此轮变更集中在 CLI、调度持久化和注册表,没有改动页面渲染。

English verdict: REQUEST_CHANGES at 2923748. Main already fences intact successors via #8708. The candidate misclassifies both damaged committed receipts and torn tails after an append, permits stale scheduler writes across Goal recreation or missing scope, and fails TypeScript and the registry I/O canary.

@gcl-coder

Copy link
Copy Markdown
Contributor Author

CI 的 typescript-core (1/3) 与 node-minimum-compatibility 在这个 head 上指向新代码的编译错误,已在 e6a3f7fe7c 修掉:

loopx/control_plane/scheduler/heartbeat_commit.ts:1012
Type 'string | undefined' is not assignable to type 'string | null'.

readCurrentGoalInstance 把 goalInstanceId 声明为可选,而提交路径的字段是 string | null。改为 current.goalInstanceId ?? null,语义不变:注册表没有报告实例 id 时状态字段保持缺省,不会写一个未命名的生命周期。

本地 scheduler_heartbeat_commit、scheduler_heartbeat_commit_cli、scheduler_heartbeat_followup、scheduler_heartbeat_receipt_fence、scheduler_heartbeat_followup_cli 共 69 项 Node 测试通过。合并基 859a23ee9 上 checks、typescript-core (2/3)、windows-powershell、pytest、merge-gate 等本来就失败,这次只处理本 PR 引入的编译错误;Windows、已安装分发和托管 CI 结果仍需等这次推送。

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent; gpt-6.1-sol; OpenAI; runtime_reported; reasoning_effort=max

动机 / Motivation

运行心跳自动化的 host 在回传调度结果时,会遇到回执日志中的损坏审计行。
原来一条损坏的非关键日志就可能阻断当前回传;本次在现有回执 owner 中恢复有效调用,并拒绝已被新 Turn 取代的旧调用。
目标是当前 ACK 或失败回传可以完成,旧 Turn 则不能重新获得调度写权限。
本次不新增 host 接入方式,不交付完整插件,也不证明安装态客户端或真实模型的采用效果。
上轮“相同身份重复+摘要损坏”已修复;仍有“同一身份字段一值明确在外、一值不可读”的缺口,四条真实 CLI 路径均会写入旧 Turn 状态。

改动思路 / Approach

回执判定继续由 TypeScript 的既有 owner 负责,Python 保留传输和受锁保护的日志追加;无需第二套权限规则。
最小剩余修复是在当前 successor owner 中核对同一字段的 unreadable 信息,再决定它是否能证明 foreign scope;不能用一个可读外部值抹掉另一个不可读的重复值。
这保留了正向恢复、原始回执、提交锁、Goal instance 和精确重试边界。确定属于其他 Agent 或诊断的行仍应被排除,不能改成遇到任意损坏就阻断所有调用。

不修改会保留损坏审计阻塞正常回传的问题;只在 Python 吞异常会复制权限规则。当前快照、局部 scanner、native commit 和有限容错投影的分工有真实调用者,保留其架构是合理边界。一般 quota settlement、replan history 和 status 仍严格读取;只有三种 scheduler follow-up 启用容错,且不把部分结果写进严格投影缓存。日志追加端只在原锁内删除未提交尾段,不另造格式或并行账本。

以下为 19fdb5ceb73c5c5ee9b6661e575c425bfb3e0672 的实际 CLI 对照。每类覆盖 File/SQLite × ACK/failure;两版各 24 案例,使用同一脚本、独立隔离 fixture,保留实际日志和状态读回。

后继行 基线旧 Turn 本次旧 Turn
完整/相同 agent_id 重复/相同重复加坏摘要 stale,无写入 stale,无写入
可读且冲突的重复 agent_id,加坏摘要 stale,无写入 stale,无写入
明确其他 Agent,重复身份加坏摘要 合法当前调用写入 合法当前调用写入
前置外部 agent_id,原本地 agent_id 的值损坏 旧调用成功写入 旧调用成功写入

最后一行在基线也失败,是本次硬化范围内未补齐的原有缺口,不是新引入回归。它不能因其它检查通过而被当作无关失败。

具体改动 / Changes

审查整个 68fe1788518e7edbf912638dcc421e17b0c9bc31 到当前 head 的 31 路径差异,+3516/-111。21 个生产/语义路径、10 个测试路径。与上次 6490be785f50ed5b18686f252157ed94c4bca4da 相比,28 个 base/head blob 对未变,只有 receipt owner 及其 Python、TS 两组测试变化;依赖清单、调用者和基线未变。以此明确复用未变路径的审查事实,重新执行当前原生与 CLI 验证,没有继承旧结论。

关键代码讲解

  1. committedSuccessor 收集全部可读成员值并合并相同值,修好了上轮反例;但 284 行 仍在检查 unreadable 之前返回 null。该行只有一个外部值可读时,不能证明同名的另一个值也在外部。
  2. heartbeatReceiptStatus 按原始日志顺序判断后继;null 使这条已终止的新记录消失,于是保留旧回执为 fresh。
  3. readReceiptLogSnapshot 使用严格 UTF-8 解码,并由局部 scanner 同时返回可读成员和 unreadable 集合。它提供了拒绝所需的信息;问题出在消费者提前认定外部范围。
  4. evaluateSchedulerHeartbeatCommit 在锁内重新核对实例、回执和 replay metadata,再写 scheduler state。这些检查有独立价值,但无法纠正上游错误的 fresh 判定。
  5. _drop_unterminated_tail 在原追加锁内保留已提交前缀、移除未终止尾段。Python 的当前回传入口只传递 Turn/GoalRef/registry;strict/tolerant settlement 和 replan 接缝复用已有 owner。

规范依据:docs/reference/protocols/host-integration-plugin-plan-v0.md,不可变版本 68fe1788518e7edbf912638dcc421e17b0c9bc31 的 Phase 3。以下标签映射其现有未编号句子:

  • Phase3-newer-receipt — not_met:新 Turn 必须在旧 ACK 写状态之前使其失效。上述不可读重复身份仍使旧写入成功,最小修复见风险项。
  • Phase3-diagnostic-identity — implemented:匹配 Goal/Agent 且有非空 Turn 的 quota 事件才是回执。确定 foreign、validation 和无 Turn 诊断对照保持,不应广泛改成损坏即拒绝。
  • Phase3-exact-retry — implemented:current receipt 精确重试重放原 commit,不再次写状态或扣额,不从 live frontier 重建权限;native commit/follow-up CLI 正向及重放测试通过。

对主干的风险 / Risks

[P2] 排除外部身份前也要检查同字段的不可读重复值

先用真实 quota should-run 提交 turn-1 和 turn-2。给第二条已提交行前置 agent_id=another-agent,保留原本地 agent_id 为最后一个同名成员;损坏前,标准 JSON 解码仍得到原始本地身份。随后只向原本地 agent_id 的字符串值插入一个 0xff,保留后继 Turn、其余范围字段和行终止符。以 turn-1 调用 ACK 或失败回传。File 和 SQLite 各两条路径均 exit=0、scheduler_state_mutated=true,并读到落盘 commit;日志前后字节完全相同。

scanner 已记录 agent_id 不可读,同时保留前置外部值。提前排除分支 只看到后者,跳过后面的 unknown 处理。这不是“已证明其他 Agent”的行;容错不能把部分可读结果当作完整身份来源。最小修复是把该字段的可读值与不可读证据一起用于范围判断,可能仍属于本事务时保留 typed unknown,并保留独立可证明的外部/诊断隔离。回归应覆盖相同字段一值外部、一值不可读的两种顺序,以及 File/SQLite × ACK/failure 的实际无写入断言。

语义与 CI 对齐

复用既有 receipt/commit 词汇,unknown 是局部 typed union,不增加持久化声明或授权。当前未满足的是 Phase3-newer-receipt,恢复指导不能替代写前机器栅栏。复验入口为 uv run --extra test python -m pytest -q tests/control_plane/test_scheduler_heartbeat_receipt_fence.py,并保留上述独立 CLI 字节变换及原生 fence/commit/follow-up suites。

PASS:当前 124 项源码 Python 测试、251 项 Node 测试、control-plane typecheck;标准 premerge 的 6 项 direct 和 18 项 selected checks 全过。FAIL:本次两版各 24 案例均有上述 4 个旧写入;其余 20 个符合预期,上轮反例在本次 head 已通过。初次 premerge 启动误用了无 __main__ 的模块入口,退出后用实际 CLI 入口完整重跑,未计作 PR 失败或通过。未查询、轮询或等待 CI。

我的整体评价 / Verdict

请求修改。该提案有当前回传恢复的可用增量,分工与既有 owner 相称,保留已落盘 receipt/replay 的兼容义务也合理;净行数和绿色测试不能代替完整的旧写入栅栏。long_horizon=not_yet_proven、user_experience=not_yet_proven:在已提交后继存在而身份部分损坏时,host 仍会收到成功并改写调度状态。修复应限于上述范围判断,不需要第二套 Python policy、新 store 或完整插件工程。

已检查 quota CLI、receipt reader、scheduler commit 与状态投影;31 个改动路径没有新增或修改渲染页面,因此视觉评审不适用。视觉未验证范围:none。Windows、PostgreSQL、安装态 host、真实模型采用及长期完整成本未验证,不能由本次本地恢复检查推断。

English verdict: REQUEST_CHANGES at 19fdb5c. The previous duplicate-identity finding is fixed, but an unreadable duplicate identity is still treated as conclusively foreign, allowing old scheduler writes on File and SQLite. This remaining gap also reproduces on the baseline.

A stray rewrite can duplicate a top-level scope member of a committed
quota_should_run receipt, name another Agent first and leave this scope's copy
where a single damaged byte makes it unreadable. The recovery reader reported
both the readable foreign value and the damaged key, but the successor check
trusted the foreign value alone and returned "unrelated", so an older Turn
regained write authority.

The exclusion branch now consults the same recovered key list: a member whose
every readable copy is foreign still proves the row unrelated only when no copy
of that member is unreadable. If the same member is also damaged, the row
answers "unknown", which the freshness check already treats as stale. Fully
readable foreign rows and surviving diagnostics stay tolerated.

Verified with real File and SQLite scheduler-ack-current and
scheduler-fail-current commands: a committed turn-2 receipt whose first
agent_id names another Agent while the trailing local copy holds a raw 0xff
now exits 1 with heartbeat_receipt_stale, scheduler_state_mutated=false and
unchanged log bytes. The mirrored order (local readable first, foreign copy
damaged) also keeps the old Turn retired. The full Python receipt-fence suite
passes (62 tests, File and SQLite), the six scheduler TypeScript suites pass
(99 tests), and control-plane typecheck passes.

Signed-off-by: ChengLong GU <88359731+gcl-coder@users.noreply.github.com>
@gcl-coder

Copy link
Copy Markdown
Contributor Author

已推送 b829fdf2f6332188fe94ac16d5197ea57cc2c153,处理本轮的两处发现。

[P2] 已提交后继的重复身份损坏时,旧返回不再重新获得写入资格。 committedSuccessor 在排除异范围行之前,现在先检查同一成员是否也出现在 damaged.unreadable 中:只有当某个范围字段的每一份可读副本都指向其他范围、且该字段没有任何不可读副本时,才返回“无关行”。若可读的异 Agent 副本后面还跟着一份损坏的本地 agent_id(原始 0xff 只写在字符串值里,Turn、其他范围字段与行尾换行保持完好),该行现在返回 unknown,heartbeatReceiptStatus 据此判 stale,旧轮 ACK/失败在入口与持锁写入前都被拒绝。

  • TS:tests/control_plane_ts/scheduler_heartbeat_receipt_fence.test.ts 的矩阵新增两种重复顺序(异范围在前+本地损坏、本地在前+异范围损坏),均要求 stale;完全可读的异范围行与幸存诊断行仍被容忍。
  • Python:新增 test_damaged_duplicate_agent_identity_still_supersedes_the_older_turn,用两次真实 should-run 生成同范围回执,再按两种顺序改写/损坏 turn-2 的 agent_id,覆盖 File/SQLite × ACK/失败 × 两种顺序共 8 组,断言退出 1、heartbeat_receipt_stale、scheduler_state_mutated=false、日志字节不变。
  • 验证:完整 tests/control_plane/test_scheduler_heartbeat_receipt_fence.py 62 项通过(File 与 SQLite,Node 24 运行时);六个调度 TypeScript 套件 99 项通过;tsconfig.control-plane 类型检查通过。本轮未查询托管 CI,也未改动其他入口。

[P2] 旧目标实例覆盖或重放新实例的调度状态。 本轮提交未包含该修复;上一轮回复中它仍未处理,我正在按“在提交事务内读取当前权威目标实例、在读取与重放前拒绝旧或已取消实例绑定”的方向继续,完成后会单独推送并补充真实切换前后的 File/SQLite 对照组。

@gcl-coder

Copy link
Copy Markdown
Contributor Author

更正上一条回复的第二段:Goal 实例的旧写入问题在更早的提交中已经修复,evaluateSchedulerHeartbeatCommit 现在在锁内读取注册表的当前实例并在读取与重放前拒绝旧或已取消的绑定(heartbeat_receipt_goal_instance_superseded 等分支),本轮最新评审也没有再提出该问题。上一条中“本轮提交未包含该修复、正在继续”的说法不准确,应以此为准。

本轮最新评审唯一未满足项就是重复身份字段“一值外部、一值不可读”的缺口;b829fdf2 已修复并附两种顺序的 File/SQLite 真实 CLI 回归(8 组断言 stale、零状态写入、日志字节不变)。

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent | model=gpt-6.2-sol | provider=OpenAI | reasoning_effort=max | source=runtime_reported

[P2] 已确定是另一 Agent 的日志会阻断有效回传。另一 Agent 的身份完整且明确在外,事件类型包含一个不可读副本时,File/SQLite 的 ACK 和失败回传四项都返回 heartbeat_receipt_stale,而且不写状态。上一提交同一输入的四项回传均正常。

动机 / Motivation

心跳自动化的操作者和宿主需要回传仍有效轮次的调度结果。 上一提交允许已能确定属于另一个 Agent 的诊断行留在历史里。本提交可能在核对其他身份前将该行视为后继,进而把当前轮次报成过期。 同范围的损坏重复身份已能阻止旧轮次写入。文件中另一个 Agent 留下的损坏行仍会阻断有效回传。 保留严格结算、窄范围的调度容错及原日志写入锁,在 committedSuccessor 中完成范围判断。 安装后的宿主、PostgreSQL、Windows 和实际采用仍须独立验证。

改动思路 / Approach

调度在丢弃或接纳损坏行之前,应先验证该行属于哪个 Agent。已合入的 #8708 负责传递原轮次,当前改动可留在现有 TypeScript 判定中。 保留严格结算、窄范围的调度容错及原日志写入锁,在 committedSuccessor 中完成范围判断。 逐一完成各身份字段的范围检查。发现任一字段能确定属于外部时忽略该行。剩余可能属于当前范围的损坏行仍返回 unknown。 将维护和读回放在原先的生产调用路径,保留已落盘状态的兼容。相比增加新的存储或另行准入,现有历史与准入回执已经能表达所需范围。

具体改动 / Changes

本次审查 b829fdf,对照共同基线 68fe178 和上次评审 19fdb5c。31 路径 +3686/−111,21 个运行时或语义路径和 10 个测试。前一受审提交之后仅变更三个路径,复核其余 28 组 base/head 文件内容。 规范依据为 docs/reference/protocols/host-integration-plugin-plan-v0.md 的 68fe178 版本。

  • Phase3-newer-receipt — implemented。旧轮次须被同范围已提交后继挡住。 同范围损坏重复身份的回归与真实回传对照。
  • Phase3-diagnostic-identity — not_met。确定外部或观测诊断的行不能淘汰本轮回执。 另一 Agent 的身份完整且明确在外,事件类型包含一个不可读副本时,File/SQLite 的 ACK 和失败回传四项都返回 heartbeat_receipt_stale,而且不写状态。上一提交同一输入的四项回传均正常。
  • Phase3-exact-retry — implemented。精确重放原提交不重复写入和扣额。 原生 scheduler commit 和回传重放用例。

关键代码讲解

  • committedSuccessor 识别可能的新回执。事件类型的不确定分支在第 289 行提前结束判断,错过清晰的 Agent 身份。
  • heartbeatReceiptStatus 查找原始回执和其后的已提交行。误返回的 unknown 会让有效回传失效。
  • readReceiptLogSnapshot 严格解码,保留可读、不可读成员供调度判定。严格结算仍使用默认读法。
  • evaluateSchedulerHeartbeatCommit 在锁内核对 Goal 实例、回执和调度提交。精确重放沿原结果。
  • _drop_unterminated_tail 原追加锁内移除最后一个完整换行后的未提交尾段。

对主干的风险 / Risks

上次发现的同范围重复身份缺口已修复。独立对照保留明确外部 Agent 的身份,分别改变事件字段完整度。清洁外部的四项及可能同范围的四项符合各自预期。 另一 Agent 的身份完整且明确在外,事件类型包含一个不可读副本时,File/SQLite 的 ACK 和失败回传四项都返回 heartbeat_receipt_stale,而且不写状态。上一提交同一输入的四项回传均正常。 132 个现有 Python 测试通过。独立的 4 个仍可能同范围和 4 个完好外部输入结果符合预期。 256 个 TypeScript 测试、类型检查及 premerge 全部 6 项直接、18 项选中检查通过。 托管 CI 未纳入本次验证。

语义与 CI 对齐

现有回执、GoalRef 与重规划词表仍由已有 owner 使用。确定外部或观测诊断的行不能淘汰本轮回执。 逐一完成各身份字段的范围检查。发现任一字段能确定属于外部时忽略该行。剩余可能属于当前范围的损坏行仍返回 unknown。 可通过 uv run --extra test python -m pytest -q tests/control_plane/test_scheduler_heartbeat_receipt_fence.py 和配套的实际 CLI 对照验证。

我的整体评价 / Verdict

请求修改 b829fdf。同范围的旧回传仍被拦截。明确外部范围的回传出现了可重复的错误拒绝。 保留严格结算、窄范围的调度容错及原日志写入锁,在 committedSuccessor 中完成范围判断。 评审已核对实际 CLI、状态投影和恢复入口。提案未改变渲染界面。 视觉未验证范围为 none。安装后的宿主、PostgreSQL、Windows 和实际采用仍须独立验证。

English verdict: REQUEST_CHANGES at b829fdf. A damaged event-kind member makes an otherwise clearly foreign row supersede the current receipt before the Agent is checked. Both real ACK and failure routes regress on File and SQLite.

The previous commit treated an unreadable duplicate of a scope member as
uncertainty immediately, before examining the remaining members. A row whose
event kind was readable as a validation event and whose duplicate copy was
damaged therefore returned "unknown" even though its Agent identity was
complete and clearly another Agent's. That refused valid ACK and failure
writebacks on File and SQLite.

committedSuccessor now examines every identity member first. A member whose
every readable copy is foreign and whose own copies are all readable settles
the row as unrelated, regardless of damage in a different member. Uncertainty
stays local to the damaged member: a readable foreign value with an
unreadable twin of the same member still cannot exclude the row, and the
unreadable copies of this scope's members still answer "unknown".

Verified with real File and SQLite scheduler-ack-current and
scheduler-fail-current commands: another Agent's validation row with a
readable event kind and one damaged duplicate of that member no longer blocks
the current writeback (exit 0, scheduler_state_mutated=true, log bytes
unchanged), while this scope's damaged duplicates still return
heartbeat_receipt_stale with zero writes. The full Python receipt-fence suite
passes (66 tests, File and SQLite), the six scheduler TypeScript suites pass
(99 tests), and control-plane typecheck passes.

Signed-off-by: ChengLong GU <88359731+gcl-coder@users.noreply.github.com>
@gcl-coder

Copy link
Copy Markdown
Contributor Author

已推送 748f14f7c90554a16a322aafe254d05d48c37e40,处理本轮唯一发现。

[P2] 已确定是另一 Agent 的日志不再阻断有效回传。 上一提交在遇到「某范围字段有可读外部值、但有同字段不可读副本」时立刻返回 unknown,没有继续核对其他身份字段;因此一条 Agent 身份完整且明确在外的 validation 行(event_kind 另有一个损坏副本)会让当前回传被误判 stale。

修复把范围判断拆成两步:先逐一遍历所有身份字段(schema_version、event_kind、goal_id、agent_id、goal_ref),只要任一字段的所有可读副本都指向外部、且该字段自身没有任何不可读副本,就确定整行无关并容忍;只有没有任何字段能确定外部时,同一字段的不可读副本才把该行留在本范围并返回 unknown。不确定性保持在损坏字段自身,不会被其他字段的清晰外部身份抹掉,也不会因为其他字段损坏而把无关诊断拉回事务。

  • TS:新增三种矩阵用例——外部 Agent + 可读外部 event kind + 同字段损坏副本(容忍)、本范围 Agent + 同样的损坏副本(stale)、外部 Agent + 仅损坏的 event kind(容忍)。把生产代码临时退回上一提交时,第一类会失败(let ack write stale state),确认用例覆盖了该回归。
  • Python:新增 test_foreign_audit_row_with_damaged_event_kind_is_tolerated,用真实 quota should-run 先生成 turn-1,再追加另一 Agent 的 validation 行并在其 event_kind 重复成员写入一个 0xff;File/SQLite × ACK/失败 4 组均退出 0、scheduler_state_mutated=true、日志字节不变。
  • 验证:完整 test_scheduler_heartbeat_receipt_fence.py 66 项通过(File 与 SQLite);六个调度 TypeScript 套件 99 项通过;tsconfig.control-plane 类型检查通过。上一轮的「同范围重复身份+不可读副本」仍保留 stale 断言。未查询托管 CI。

@mergify

mergify Bot commented Nov 18, 2026

Copy link
Copy Markdown

This pull request has merge conflicts with main and cannot be merged
until they are resolved. Please rebase or merge the base branch, @gcl-coder.

Choose the remote for the base repository, not an out-of-date fork.
For a fork clone, first inspect git remote -v; upstream must point
to https://github.com/loopx-project/loopx.git. If it is absent, add it
with git remote add upstream https://github.com/loopx-project/loopx.git.
Then run:

git fetch upstream
git rebase upstream/main
# Resolve each conflict, git add the resolved files, then git rebase --continue.
git push --force-with-lease origin HEAD

For a same-repository clone whose origin points to
https://github.com/loopx-project/loopx.git, use origin instead of
upstream for fetch/rebase. If you prefer merging the base, use
git merge <base-remote>/main and push normally.

Keep the DCO Signed-off-by trailer on every commit when you rebase.
https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork

@mergify mergify Bot added the needs-rebase Mergify: the pull request has merge conflicts with its base branch label Nov 18, 2026

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · gpt-6.2-sol · OpenAI (runtime_reported, max)

[P2] 统一回执读取、去重和追加的提交边界

日志写入在完整 JSON 和结尾换行之间中断。 File 与 SQLite 的 ACK 和失败回传四组均先报 heartbeat_receipt_stale。下一次普通追加丢掉尾行后,同一原回执又能写回。两种 Python 追加入口还把尾行当作原记录返回,随后普通追加使该回执消失。 位置在 loopx/rollout_event_log.py:253,另见 loopx/control_plane/runtime/receipt_log_snapshot.ts:220 和 loopx/control_plane/rollout_receipt_log.ts:367。

动机 / Motivation

本次独立评审绑定 #8647 精确提交 748f14f7c90554a16a322aafe254d05d48c37e40。心跳宿主需要写回当前轮次的 ACK 或宿主失败。 共同基线续写时保留可解码尾行,当前续写时丢弃该行,使同一原回执先被拒绝、随后又获准写回。 当前两种追加入口的精确重试均返回同 ID。普通追加后的对应记录数从基线各一条变成当前各零条。 已合入的 #8708 负责传递原轮次,本提案补足损坏日志、原实例绑定和写入锁内保护。验收遵循原 Goal 实例、Agent、轮次、严格结算和调度回执格式。

改动思路 / Approach

本次评审覆盖共享日志的提交证据、原生调度回传及准确重试。 当前 committedSuccessor 先检查完整的作用域证据,能正确放行明确属于其他 Agent 的记录。由既有 rollout 日志 owner 提供可明确区分的已提交行视图。调度判定和原日志锁内的去重仅读取已提交行,保留一般诊断读法。在补写前验证两个回传,在精确重试及下一次普通追加后读回原回执,保留完整行控制。

具体改动 / Changes

31 路径 +3798/−111,20 个运行时、10 个测试与示例、1 个注册表分类文件。上次评审以来重新阅读 3 个变化路径,其余 28 条 base/head 文件内容一致,并在当前源码重跑相关路径。 规范依据为 docs/reference/protocols/host-integration-plugin-plan-v0.md 的 Phase 3,固定到 68fe1788518e7edbf912638dcc421e17b0c9bc31。

  • Phase3-newer-receipt。真正提交的新回执能淘汰旧轮次,File 与 SQLite 的两种回传均覆盖。未终止的完整 JSON 同样会临时淘汰旧轮次,下一次追加后判定翻转。
  • Phase3-diagnostic-identity。上一提交因明确属于外部 Agent 的记录含损坏事件类型而误拒四组回传。当前四组均成功,另外八项明确外部或仍可能同范围的对照符合预期。
  • Phase3-exact-retry。当前两种追加入口的精确重试均返回同 ID。普通追加后的对应记录数从基线各一条变成当前各零条。

对主干的风险 / Risks

基线及当前均读取能解码的完整 JSON 尾行。基线的下一次追加保存该行,当前的下一次追加会丢弃它。故障中断后的回执在两个生产追加入口上均实测丢失。单次回传、后续追加和精确重试应依据同一个已提交定义。

131 项 Python、251 项 TypeScript、类型检查,以及本地标准预合并 6 项直接检查和 18 项选中检查通过。独立矩阵对照覆盖普通日志、无终止换行、有效提交和 JSON 真正不完整的情况。Windows、PostgreSQL、安装态宿主和线上调度尚无实跑证据。

与采样主干 28ae33cf7efb 的本地组合在 loopx/control_plane/rollout_receipt_log.ts 冲突。主干 #8985 删除了未调用的 readGoalHeartbeatReceipts,解决冲突时可保留该清理。这里的行为结论针对实际受审提交。

我的整体评价 / Verdict

上一次的范围误拒已修复。上一次评审

当前仍需统一已提交回执的判定,在两后端、两种回传以及两种追加入口复验中断和重试后的持久结果。修复后请绑定新的实际提交复查。

English verdict: REQUEST_CHANGES — The foreign-agent scope regression is fixed. Receipt reads and append deduplication still accept an unfinished final row that the next append deletes. Require consistent committed-record handling and verify the interrupted-write retry against both storage backends.

Comment thread loopx/rollout_event_log.py Resolved
A log write can stop between its complete JSON row and the newline that
commits it. The snapshot exposed that final record, so a nearly written
successor retired the old Turn and a nearly written original counted as the
Turn's receipt. The next append drops those bytes, which made the same
command flip from stale or missing to writable.

The snapshot now names the unterminated record line, and the scheduler
freshness read ignores that row for both the originating Turn and any
successor. The two Python append entry points also deduplicate against
newline-terminated rows only: retrying an interrupted append drops the
abandoned bytes and commits the row once, while a committed row still returns
the same record. General diagnostic reads keep the decodable tail.

Verified with real File and SQLite scheduler-ack-current and
scheduler-fail-current commands: an unterminated turn-2 successor no longer
retires turn-1 (exit 0, scheduler_state_mutated=true), and an unterminated
turn-1 row reports heartbeat_receipt_missing both before and after the next
append drops it. The full Python suite passes (106 tests), appended-row dedup
covers both entry points, the scheduler TypeScript suites pass (105 and 157
tests), and control-plane typecheck passes.

Signed-off-by: ChengLong GU <88359731+gcl-coder@users.noreply.github.com>
Main deleted the unused readGoalHeartbeatReceipts helper (loopx-project#8985). The branch's
receipt reader had grown around that helper, so the merge keeps main's removal
and carries only the scoped receipt view, the committed-successor admission
and the committed-row marker. scheduler_hint.py, quota.py, status.py and the
settlement readback test merged without overlap; the receipt reader was the
only textual conflict.

Signed-off-by: ChengLong GU <88359731+gcl-coder@users.noreply.github.com>
@gcl-coder

Copy link
Copy Markdown
Contributor Author

已推送 1ebd7a6f(修复)和 d54a67ca(合入当前 main f9bb5e3c),处理本轮发现并解决合树冲突。

[P2] 统一回执读取、去重和追加的提交边界。 现在只有一个“已提交行”定义:带结尾换行的行。readReceiptLogSnapshot 额外暴露 unterminatedRecordLine,调度新鲜度判定(heartbeatReceiptStatus)对原始回执和后继扫描都忽略这一行;append_rollout_event 与 append_rollout_event_once 在追加锁内只对已提交行去重。这样中断留下的完整 JSON 尾巴既不会冒充后继让旧回传变 stale,也不会冒充原回执让精确重试返回一个下一次追加就会消失的记录;下一次追加丢弃尾巴后重新写入同 ID,结果与中断前一致。普通诊断读取仍保留可解码尾行。

  • 实测 File/SQLite × ACK/失败:尾部 turn-2(完整 JSON 无换行)不再使 turn-1 变 stale,回传 exit 0、scheduler_state_mutated=true、日志字节不变;尾部 turn-1 在普通追加前后都返回 heartbeat_receipt_missing。
  • 追加入口单测:append_rollout_event / append_rollout_event_once 对无换行的同 ID 完整 JSON 不再返回既有记录,而是丢弃尾巴并提交一次;已提交行仍按原 ID 复用。
  • 验证:test_scheduler_heartbeat_receipt_fence.py 与 test_rollout_event_log_loading.py 共 106 项通过;七个调度/结算 TypeScript 套件 262 项通过;tsconfig.control-plane 类型检查通过(均在新合并树上运行)。

合树冲突。 rollout_receipt_log.ts 按主干 #8985 删除了未调用的 readGoalHeartbeatReceipts,其余三份同时改动的 Python 与结算测试按双方改动合并,无语义冲突。当前 PR mergeable: true,head d54a67ca。托管 CI 我未逐项轮询;本轮结论来自本地合并树上的实际 CLI 与单测。

@mergify mergify Bot removed the needs-rebase Mergify: the pull request has merge conflicts with its base branch label Nov 18, 2026

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · gpt-6.2-sol · OpenAI (runtime_reported, max)

[P2] 让中断恢复也只承认已提交的回执

完整 JSON 尾行缺少提交换行时,同一份回执在 quota should-run 的原轮恢复读法中仍然有效。一次无关的日志追加丢弃尾行后,下一次准入又返回 normal_run。File 与 SQLite 均复现。审阅绑定 d54a67cadcb54cfd2306ad61ed8b6eaacfaab48f。调度新鲜度的提交过滤

动机 / Motivation

运行心跳的宿主在轮次中断后,需要知道应恢复原轮还是开始下一轮。回执写入中断时,这个决定仍应依据已经提交的记录。

主干会在下一次追加时保留可解码的尾行。候选改为丢弃未收到换行的尾行,同时从调度新鲜度和去重中过滤它。

预期是调度回传、去重和原轮恢复对回执是否已经提交给出一致答案。原轮恢复仍把随后会丢弃的尾行当成收尾依据。

本评审覆盖源码 CLI、File 与 SQLite 上的调度和恢复。Windows、PostgreSQL 及安装态宿主尚无本轮运行证据。

改动思路 / Approach

保留可解码的诊断视图有价值。原轮恢复和其他会改变后续动作的读取应复用已提交视图。现有快照已携带物理行及尾行信息,可以集中在这个 owner 过滤,诊断继续读取原有数据。验证共享 rollout 提交证据在实际调度和原轮恢复上的使用,保留诊断读取。

审阅规范为 docs/reference/protocols/host-integration-plugin-plan-v0.md 的 Phase 3,基线 f9bb5e3cf9185de77a2f7580d64eaf9d32f46eff。核查 newer-receipt、host-ack-replay 和 settlement-independence,即同范围较新轮次淘汰旧回传,精确重试保持幂等,宿主回传和交付结算各守本轮来源。基线规范

具体改动 / Changes

全量对照该基线的 31 个文件,+4048/−113。范围包括 Python CLI 的请求传输与日志追加、TypeScript 调度和结算读回、事件解析、后续状态投影及回归测试。上次见到的作用域隔离路径留在统一的调度 owner,最新改动让调度和 Python 去重使用已提交行。

  • newer-receipt。有换行的后继仍让同范围旧回传拒绝。未提交后继在 File 与 SQLite 的 ACK 和失败回传均不再导致错误过期。
  • host-ack-replay。两种 Python 追加入口重试时正确提交原 ID,之后的普通追加仍可读回一次。上次 18 个独立反例和对照在本头全部通过。
  • settlement-independence。原轮恢复从 goalHeartbeatReceiptsFromSnapshot 取得回执,该函数仍交出未提交物理尾行。新写入策略将它丢弃,导致同一份原轮候选先被认作欠收尾,随后消失。原轮预检消费者

对主干的风险 / Risks

在两种后端分别用同一真实 CLI 工作轮比较。基线的无换行回执在普通追加前后都保留,预检两次都请求原轮恢复。当前头追加前请求原轮恢复,追加后同一后续操作变为正常准入。两后端的完整行对照均保持原轮恢复,测试未产生扣额。

本地相关 Python 129 项、TypeScript 257 项及控制面类型检查通过。标准预合并通过 6 项直接检查及 18 项选择检查。上轮回传与去重反例已修,本轮新增的两个未提交原轮恢复反例失败。

我的整体评价 / Verdict

修复方向可用,且本轮已补足调度回传和日志去重的一致性。请求将相同过滤接到恢复预检及使用该快照决策的结算入口,保留真实已提交行和诊断解析原样。以 File 与 SQLite 的普通后续准入复验读回,并保留已验证的调度负例。

English verdict: REQUEST_CHANGES. Scheduler follow-up and append deduplication now agree. Prior-Turn recovery still accepts an unterminated row and changes its decision after an unrelated append discards that row.

A complete JSON row without its committing newline is abandoned by the
next append. Use the same committed-only view for strict settlement,
receipt qualification and prior-host-Turn recovery so an interrupted
receipt cannot make a later admission ask for recovery before the next
append and then disappear.

Verify File and SQLite real CLI prior-turn recovery with committed and
unterminated guard receipts, plus TypeScript settlement preflight and
control-plane typecheck.

Signed-off-by: ChengLong GU <88359731+gcl-coder@users.noreply.github.com>
@mergify

mergify Bot commented Nov 18, 2026

Copy link
Copy Markdown

This pull request has merge conflicts with main and cannot be merged
until they are resolved. Please rebase or merge the base branch, @gcl-coder.

Choose the remote for the base repository, not an out-of-date fork.
For a fork clone, first inspect git remote -v; upstream must point
to https://github.com/loopx-project/loopx.git. If it is absent, add it
with git remote add upstream https://github.com/loopx-project/loopx.git.
Then run:

git fetch upstream
git rebase upstream/main
# Resolve each conflict, git add the resolved files, then git rebase --continue.
git push --force-with-lease origin HEAD

For a same-repository clone whose origin points to
https://github.com/loopx-project/loopx.git, use origin instead of
upstream for fetch/rebase. If you prefer merging the base, use
git merge <base-remote>/main and push normally.

Keep the DCO Signed-off-by trailer on every commit when you rebase.
https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork

@mergify mergify Bot added the needs-rebase Mergify: the pull request has merge conflicts with its base branch label Nov 18, 2026
@gcl-coder

Copy link
Copy Markdown
Contributor Author

已推送 18e8fa6a479f381ef69a796ea98eb7a0a255fb14,处理本轮 [P2] 让中断恢复也只承认已提交的回执。

  • readReceiptLogSnapshot 已暴露 unterminatedRecordLine;新增 committedGoalRolloutEvents 统一过滤未带结尾换行的完整 JSON 尾行。
  • 严格结算输入现在只索引已提交行;诊断读取仍保留完整尾行,不影响损坏诊断的可见性。
  • preflightPriorHostTurnCloseout 改用 committedGoalHeartbeatReceiptsFromSnapshot,因此原轮预检与调度回传、追加入口共享同一条提交边界:未提交 guard 在追加前后都不会触发原轮恢复。

验证:

  • File/SQLite 真实 CLI:完整 guard 仍进入 unsettled_host_turn_recovery;无换行 guard 在无关追加前后均为普通准入,零扣额。
  • TypeScript 新增 preflightPriorHostTurnCloseout 的未提交/已提交 guard 对照。
  • tsc --project tsconfig.control-plane.json --noEmit 通过;相关 TypeScript 217 项、Python 102 项通过。

请绑定新提交复查。

Resolve the five doubly-changed files against the current main tree so
the committed-row recovery fix can be evaluated on an up-to-date base.

Signed-off-by: ChengLong GU <88359731+gcl-coder@users.noreply.github.com>
@mergify mergify Bot removed the needs-rebase Mergify: the pull request has merge conflicts with its base branch label Nov 18, 2026

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · gpt-6.2-sol · OpenAI (runtime_reported, max)

Exact head ca3c00969ebe0890f0916a0b022ef25ce20f3cb6

动机 / Motivation

使用受控心跳的宿主需要在恢复工作和写回调度结果前确认哪个工作轮已有提交。 一次写入刚写完回执内容,尚未写入作为提交边界的换行。如果此时恰好读取,后来另一条普通追加会丢弃这段尾行,恢复判断就可能随无关写入改变。 本头已统一普通准入前的恢复预检、严格结算与追加的提交边界。调度回传使用的容错读回仍接受这段未提交尾行。 本次评审覆盖本地原生调度回传、原轮恢复和结算事实的读回。

改动思路 / Approach

现有追加流程定义换行为提交边界。诊断快照保留可解码的内容,调度、新轮预检和结算根据已提交的事实判断。 这次可复用的边界是共享提交视图与现有 GoalRef 作用域,容错只影响是否跳过损坏记录。 宿主从既有回执找到原轮,只有同一 Goal 实例和同一 Agent 的更新提交才能影响回传。长期维持一条提交边界,可让中断前后的调度和恢复读回一致。

具体改动 / Changes

按实际主干基线 648d06db542075dc023caeeb11ea368b35ef7ab7 核对完整 33 路径、+4173/-122 行。与上一已审版本有 26 个路径的基线与提案文件内容均相同,重新核对另外 7 个路径。依据 docs/reference/protocols/host-integration-plugin-plan-v0.md,对应 newer-receipt 和 host-ack-replay 的现有对照通过,settlement-independence 对应的容错读回仍有缺口。 原回传规范

关键代码讲解

  • committedGoalRolloutEvents 统一按快照的物理行信息排除未提交尾行,普通原轮预检已走这个视图。 提交视图 原轮预检
  • readQuotaSettlementSnapshot 在严格路径使用提交视图。调度回传重建决策使用的容错路径直接索引原始快照事件。 结算读回 调度回传配置
  • projectSettledReplanHistory 的容错分支也直接使用原始事件来选择候选回执。它可沿用同一个过滤入口。 重规划历史

对主干的风险 / Risks

[P2] 容错读回仍把未提交的尾行当成结算事实。 File 和 SQLite 的真实 quota should-run 生成同一组回执。完整行在两种读法都可用。移除结尾换行后,严格读回始终无回执,容错读回仍返回该轮。普通追加清理尾行后,两种读法才再次一致。整个检查没有额度扣减。 调度回传会把这份读回交给决策重建。新增的末端调度写入检查仍有自己的提交判断,本次反例观察的是重建过程读到的结算事实。让 readQuotaSettlementSnapshot 和 projectSettledReplanHistory 的容错分支复用 committedGoalRolloutEvents,保留跳过损坏记录的能力及独立诊断读法。

  • PASS — File 和 SQLite 的已提交回执在普通追加前后都需要原轮恢复。未提交尾行在两组对照都进入普通准入。这复验了上一轮指出的预检缺口。
  • FAIL — 调度容错读回对完整但未提交的行,在两种存储上均与普通追加后的结果不一致。在隔离副本中让两处容错选择共用提交视图后,两个独立反例通过。完整对照继续可读,普通诊断还能看见可解码的尾行。
  • PASS — 341 项 Python、259 项 TypeScript、类型检查、Ruff 以及标准 premerge 的 6 项直接检查和 18 项所选检查均通过。
  • UNVERIFIED — 托管 CI、安装版宿主的实际调度回传。

语义与 CI 对齐

复用已有的 GoalRef、回执提交及重放约定。把已提交判断统一到现有快照视图即可补齐范围,保留严格路径在损坏时报告错误,也保留容错路径从其他已提交记录恢复。源码测试和本地 premerge 已通过,两个独立失败案例中的提交边界仍未一致。

我的整体评价 / Verdict

上次指出的普通准入预检问题已解决。保留这部分以及同轮重放保护,并补齐调度容错读回,才能让一次中断后的决策在相同已提交状态下给出一致结果。建议在修复后的精确提交重跑两个 File/SQLite 对照与调度回传测试。

English verdict: REQUEST_CHANGES. The tolerant scheduler readback still treats an uncommitted trailing row as a settlement receipt.

Filter unterminated scheduler settlement rows through the existing committed
rollout view in quota settlement readback and replanned history. Add TypeScript
and real File/SQLite CLI regressions for interrupted tails while preserving
damaged-row tolerance.

Signed-off-by: ChengLong GU <88359731+gcl-coder@users.noreply.github.com>
@gcl-coder

Copy link
Copy Markdown
Contributor Author

已修复,提交 f42d8e979b0fe8270a4fad3d7e40e194a931dd44。

readQuotaSettlementSnapshot 的容错分支和 projectSettledReplanHistory 的回执筛选现在统一复用 committedGoalRolloutEvents。未写入结尾换行的完整 JSON 尾行不再进入结算或重规划事实;完整但损坏的无关记录仍由容错视图跳过,严格读回继续报错。

验证:

  • TypeScript:tsc --project tsconfig.control-plane.json --noEmit 通过;quota_settlement_readback.test.ts 161 项通过,覆盖容错读回与重规划历史在未提交尾行、普通追加修复前后的一致性,以及损坏无关记录仍可容忍。
  • File/SQLite 实际 CLI:真实 quota should-run 生成回执后只移除结尾换行,scheduler-ack-current 与 scheduler-fail-current 均返回 heartbeat_receipt_missing、scheduler_state_mutated=false,日志字节不变;普通追加清理尾行后仍不把该轮当成回执。相关 12 项通过。

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · gpt-6.2-sol · OpenAI (runtime_reported, max)

Exact head f42d8e979b0fe8270a4fad3d7e40e194a931dd44

动机 / Motivation

受控心跳的宿主需要根据已提交回执决定如何恢复工作轮和回传调度结果。 写入在最后一个换行前中断时,回执内容可能完整可读。宿主如果把它当成提交,就会根据随后可能被清除的记录决定是否恢复原轮。 旧版严格读回会拒绝未写完的尾行,调度回传用的容错读回却会接受它。普通追加清理尾行后,容错读回才与严格读回一致。 无关的下一条追加就能改变恢复判断,宿主无法稳定重试同一个工作轮。

当前提交统一了严格读回、容错调度回传和重规划历史的提交边界。File 与 SQLite 的独立复验均显示,未提交尾行在普通追加前后都不参与结算。 本次验收覆盖本地心跳回执的读回、重放和已提交记录的筛选。

改动思路 / Approach

提交边界属于已有的回执日志。容错读取可以跳过损坏记录,仍须依据同一个已提交记录集合作决策。 本次修复让结算和重规划的两个容错分支调用同一个筛选函数。两处保留各自的重试和错误处理。 这样,宿主在中断前后用同一套事实重试,既能区分已提交的原轮,也能优先拒绝后来确实已提交且更新的回执。诊断仍可以显示可解码的尾行,供操作者定位中断。

具体改动 / Changes

完整范围为 33 个文件,新增 4,326 行,删除 123 行。对照上次评审,29 个文件的基线和提案内容均一致,重新审了两处实现和两处测试。对照 docs/reference/protocols/host-integration-plugin-plan-v0.md 在 648d06db542075dc023caeeb11ea368b35ef7ab7 的约定,验证了 newer-receipt、host-ack-replay 和 settlement-independence。 宿主调度规范 上次评审

  • committedGoalRolloutEvents 根据物理行边界排除尚未完成的记录。调度回传在写入之前,用结算的容错分支从这个集合查找原轮回执。 提交视图 结算读回
  • projectSettledReplanHistory 同样只用已提交记录筛选候选工作轮,并继续交给既有结算规则确认该轮是否完成。 重规划历史
  • 新增原生 ACK 和 failure 对照覆盖 File、SQLite 以及普通追加前后。TypeScript 对照覆盖无关的损坏记录和中断的结算记录。 CLI 回归 重规划回归

对主干的风险 / Risks

独立复验通过真实本地 CLI 生成完整回执,再模拟最后一个换行写入前中断。两种存储上,完整行仍返回原轮。中断后,两种读法都找不到这条回执,普通追加后结论一致,整个对照没有额度扣减。旧头上产生分歧的同一反例在当前头通过。现有原生测试还覆盖同作用域后续回执、旧轮重放、损坏诊断和错误作用域。

304 项重点 Python 测试和 187 项重点 TypeScript 测试通过。全量控制面 TypeScript 套件有 6,659 项通过、91 项跳过。标准 premerge 的 6 项直接检查和 18 项所选检查通过。本次在源码工作树验证。托管 CI 和安装版宿主的实际调度回传仍未验证。

我的整体评价 / Verdict

上次指出的回执读回缺口已经修复。File 和 SQLite 的对照确认调度回传、结算和重规划使用同一提交边界,严格读回与诊断各自保留原有用途。我批准当前提交。

English verdict: APPROVE. Both tolerant readers now use the committed receipt view, and the previously failing File and SQLite counterexamples pass on this head.

@loopx-agent
loopx-agent merged commit e235cde into loopx-project:main Nov 18, 2026
20 of 42 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants