[loopx-agent]

A native benchmark wake already carries its saved quota decision. Previously the
client used one model/tool exchange to locate the decision reader and a second
to obtain the first facts. This change makes quota context-project --initial-read publish and read the saved capture in one call. A caller that
already knows the required fields can use repeated --select pointers instead.

The existing lifecycle still chooses full or delta presentation after native
SessionStart. The output is the ordinary verified reader page with navigation
attached: continuation and later field selection use the pinned reader, while a
missing output falls back to the same SHA-bound capture. The change adds no
guard, hook, notification, acknowledgement, checkpoint, spend or authority
transfer. Ordinary projection and explicit opt-out remain available.

The rebased implementation consumes prepare_codex_context(...).delivery and
its initial_read_plan, so #8111 uses the sole projection owner introduced by
#8100. It preserves the newer private-capture validation and the main retry
path while adding the one-call saved page.

Current head aa0f9492a1, based on main dd7a1c1034. File and SQLite paths
cover cold/resume delivery, continuation after compaction, concurrent pinned
reads, wrong scope, disabled transport and malformed first-page options.

Validation

• uv run --extra test python -m mypy: 17 source files, no issues.
• npm run typecheck:control-plane: passed.
• Changed Python Ruff, py_compile, RFC bilingual and diff hygiene: passed.
• Affected Python suites: 379 passed, 15 skipped, with one inherited
  bounded-reader failure that reproduces on main dd7a1c1034.
• Focused saved-page/native-checkpoint cases: 7 passed, 10 skipped.
• loopx canary premerge --from-git-diff --git-diff-base origin/main: 19
  selected checks, 0 automated failures, plus the existing maintainability
  advisory and benchmark-sensitive manual review hold.
• Public/private boundary scan: passed.

These are local interaction and correctness results, not hosted token savings,
solver score gains, live-model adoption or total-cost qualification.

[mergify]

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

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

[loopx-agent]

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

Approval conclusion (author-owned PR; GitHub blocks formal self-approval)

动机 / Motivation

处理已保存 benchmark 唤醒结果的 Agent，需要先取得当前任务和停止条件。

原来先调用投影取得读取入口，再调用 reader 才拿到事实；现在同一次原生工具调用直接返回首读页，已知字段也可一次选取。

已验证首读直接返回当前事实，长内容可继续分页，压缩后仍从原文件恢复，原始决定和权限保持不变。

本次不重新准入、不追加扣额或确认步骤，不切换宿主，也不宣称生产模型节省、solver 分数或长期净收益。

这里批准的是准确 head e5110ce2457464dc38fbf144d163d9a5e8e8c8ab 的这个有界读取能力，未发现阻断项。常规测试及架构检查仍有独立复现的基线失败，下面保留其原状态；批准不等于合并就绪。

改动思路 / Approach

现有 selector 与 reader 已拥有完整性和地址规则；Python 只组合一次发布和读取，没有第二套准入、选择或状态 owner。

当前边界是已保存原生决定的首读；保留普通读取及关闭态，不扩大为宿主升级、调度或效果实验。

不改动会保留每次唤醒的入口发现往返；在 benchmark 提示中自行解析并拼接下一条命令，则会再造一套导航规则。复用产品 reader 直接把首读页交给现有调用方，比后者更小，也没有新存储、控制器或人工准备步骤。原生生命周期仍先确定本次 full/delta，再读取当前完整捕获；页面和导航共同受原输出上限约束。

独立执行了真实 native client 的 cold/resume 两种 benchmark 路径，只有 Responses 推理被本地合成服务替代。生成的首条工具调用实际返回事实，原始决定、选择及明确的轮间 fixture 结算保持不变。这是入口与状态完整性证据，不能证明真实模型理解、生产采用或收费 token 收益。

具体改动 / Changes

完整 diff 为五文件 +121/-13：三处运行时/CLI +37/-10，既有测试 +71/-3，参考文档 +13。没有修改 TypeScript 决策 owner、持久化格式、模型设置或页面。

先读了本次变更之前的 spec_ref docs/reference/required-work-context.md，spec_revision 12803354ab13a003de8620ab496250617224ff37。原文没有给这些小节编号，以下是评审映射：SAVED-IDENTITY 保留原决定身份及零新增 authority IO；BOUNDED-READER 保留输出预算、字节 cursor 和摘要校验；OFF-PARITY 保留关闭态原始完整数据；EPOCH-NOT-TURN 保留压缩后沿原捕获恢复，不重做准入或结算。四项均由当前真实 CLI/native 路径及负例验证，新增“一次首读”的说明不用于倒推旧规范。

关键代码讲解

• preflight_context_instruction 给既有命令加上 --initial-read，保留原路径、完整摘要及恢复命令；已知字段可以改为重复 --select。
• project_saved_context_capture 在发布前核对原 Goal、Agent、Turn 与参数组合。普通导航路径继续存在，新读取模式仅在 native JSON、offset0 和明确选择下使用。
• _saved_context_read_page 调用既有 verified reader，把导航计入同一页面预算；失败仍指向原捕获，而非另一条 guard。地址选择、完整性和生命周期规则继续由原 owner 负责。

同一份合成源在 base 和 head 的传统两步读取中都完整还原。新首读调用在 base 不可用，在 head 直接返回页；长 UTF-8 选择分两页完整还原，压缩后的两个并发读者得到完全相同的值，journal 和文件集合不变。关闭态完整对象、未知后续材料及原始字节也逐值相同。错误 Goal/Agent/Turn、摘要、字段、互斥参数和关闭态首读共七项拒绝均未返回正文。

对主干的风险 / Risks

最强反例是“首屏看起来成功，却把未读尾部当成完整要求”，或者恢复时又发布一次决定。这里沿实际 cursor 读取完整选中值，并核对同一原文件、摘要和压缩后 journal；原醒来消息也仍保留不依赖首次输出的恢复入口。页 EOF 仍不代表全文保留、理解或新的执行权。

语义与 CI 对齐

语义词汇复用既有协议；没有新的状态分类、substring 规则或跨域义务。逐条比较了原/新唤醒文本的 actor、顺序、scope、摘要来源、停止和恢复条件；原约束均保留，明确变化是启用 benchmark 的首读默认直接交付页面。关闭态与普通导航未被该提示自动激活。没有查询、轮询或等待 CI。

PASS：两项 native-client 路径、独立 CLI 正反例、changed-file Ruff、配置指定的17项 mypy 和完整 semantic-vocabulary 检查。标准 premerge 的六项直接检查通过；19项选择检查初次17项通过，缺少 npm TypeScript 依赖的检查在按仓库要求安装后独立通过。原完整 premerge 仍保留其失败记录和 benchmark-sensitive 人工 hold，不能称整体全绿。

FAIL 保留：完整 saved-context 模块在 head 为37通过/2失败/10跳过，base为36通过/相同2失败/10跳过。两项旧默认配置断言的完整失败块、失败 fixture 定义和运行环境一致；显式 inherited off 对照也在两版保留相同三项 omitted-mode 断言失败。另一个 advisory ratchet 的完整 JSON 在仅归一 checkout 根路径后相同，仍是未改动 next-action 函数的62/60 decision-points。没有改阈值、删断言或将失败写为通过；strict CQR 对这些失败保留 failed，并绑定独立基线归因及其他已通过的必需覆盖。

我的整体评价 / Verdict

goal_achieved 仅指这个一次首读的有界能力；long_horizon 为 preserved，原决定与后续选择/结算边界未变；user_experience 为 improved，已有授权和已知字段不再需要额外发现往返，没有新增人工配置或确认。

复用现有 reader 的整理已应用；当前没有生产者填充的 first_read_reference shortcut 可在相邻局部清理时删除，属于非阻断简化建议，不要求另建任务。strict CQR 通过也没有让原失败或合并限制消失。当前分支需要处理 main 冲突；整合产生新 head 后必须重新核验，不能沿用本 head 的结论直接合并。

视觉检查不适用：所审是现有 benchmark 唤醒和 CLI 输出，没有页面、布局或产品显示改动。未验证范围是 noneditable package、native Windows、live receiver 采用、真实模型理解、solver 效果及长期完整费用。独立合成探针保留在私有评审证据中，公开可重放的回归入口是本 PR 的 saved-context 测试；没有上传私有脚本或原始记录。

English verdict: APPROVE — e5110ce delivers the first saved native-context page through the existing verified reader. Real native-client flows, exact-value CLI comparisons, scope failures and post-compaction replay pass. Independently matched baseline failures remain failed; conflict resolution, merge policy and live-model benefit remain separate qualifications.

[huangruiteng]

Reviewer: model_agent | GPT-5 Codex | OpenAI | self_reported

APPROVE. Exact head aa0f9492a1f86e17a7294aa274c1e44a851e09d7 now consumes the prepared projection introduced by #8100 and returns the saved first page through the existing verified reader. The changed path passes 379 tests, with one bounded-reader failure reproduced unchanged on main dd7a1c1034.

动机 / Motivation

处理已保存 benchmark 唤醒结果的 Agent，需要先取得当前任务和停止条件。旧路径先调用一次 context-project 取得 reader 入口，再调用一次 context-read 才获得事实；这会消耗一个没有新决策价值的模型/tool round。

Agents processing saved native benchmark wakes need to read the current task and stop conditions before dependent work. Same immutable saved capture: before, projection returned a navigation object and a second reader call returned the page; after, native JSON context-project --initial-read publishes and reads the first page in one call, while known fields can use repeated --select. The page still exposes continuation, current-field recovery and the original SHA-bound capture. This slice does not re-admit, add spend, change scheduling, prove live-model adoption, claim hosted token savings or establish solver-score gains.

规格依据是 Required work context，固定 revision dd7a1c10348194dd357bdd9dbb74deba5b53fe76。评审映射使用既有条款 SAVED-IDENTITY、BOUNDED-READER、OFF-PARITY 和 EPOCH-NOT-TURN：分别要求保留原决定身份、页与导航共享预算、关闭态原始数据，以及压缩后沿原 capture 恢复。

改动思路 / Approach

现有 TypeScript selector 和 Python reader 已拥有完整性、地址顺序、分页和摘要校验；本 PR 只把已保存决定的发布与首屏读取串在同一次 CLI 调用里。prepare_codex_context(...).delivery 和 initial_read_plan 仍是唯一 projection owner，_saved_context_read_page 只把当前 navigation 与 reader presentation 组合起来。

flowchart LR
  S[Saved quota capture] --> P[prepare_codex_context]
  P --> N[Native navigation + initial plan]
  N --> R[Verified context reader]
  R --> F[First page with navigation]
  F --> C[next_command or recovery.command]

Loading

上图是 exact-head source 的示意，不是运行 receipt。The mechanism remains in the existing transaction, selector and reader owners; the current PR boundary is the first saved page and its bounded continuation, not live-host adoption or benchmark economics. The current PR boundary is the first saved page and its bounded continuation, not live-host adoption or benchmark economics.

具体改动 / Changes

完整 diff 为 5 files、+123/−14。生产实现 3 files、+39/−11；参考文档 +13；测试 fixture +71/−3。没有新增 TypeScript decision owner、持久状态、调度行为或权限模型。

关键代码讲解

• preflight_context_instruction：把既有 projection command 改为 --initial-read，同时保留原 capture、digest 和 recovery command；已知字段可改为重复 --select。
• _saved_context_read_page：把 navigation 作为 page presentation 交给既有 reader，首屏和导航共用原 output budget；失败时补原 recovery command。
• project_saved_context_capture：校验首读只用于 enabled native JSON、offset 0、无 replay/continuation 参数，并消费 #8100 的 prepared delivery 与 pinned selection reference。
• --initial-read / --select registration：复用既有 reader 参数，不新增命令或状态字段，只扩展 context-project 的合法入口。

SAVED-IDENTITY 由 Goal/Agent/Turn 与 capture digest 校验实现；BOUNDED-READER 由 _saved_context_read_page 和 test_saved_page_continues... 实现；OFF-PARITY 由 default/off 测试实现；EPOCH-NOT-TURN 由 PreCompact 后并发读取同一 reference、journal/文件集合不变实现。

对主干的风险 / Risks

最强反例是首屏看似成功却把未读尾部当成完整要求，或 recovery 时重新发布决定。当前 page 只返回选中的连续字节和 next_command，主动读取会沿原 reference 完成；PreCompact 后两个并发 reader 仍得到同一值，且 journal 与文件集合不变。错误 Goal、Agent、Turn、冲突参数、off 与 malformed request 都在返回 content 前失败。

另一个风险是 rebase 后退回旧 project_codex_context owner。当前实现显式使用 prepare_codex_context(...).delivery，并把 first_read_reference 传给 one-call reader，因此与 #8100 的 capture-bound plan 一致；main 的 private-capture 校验也保留。

验证结果：mypy 17 files、TypeScript strict typecheck、Ruff、py_compile、bilingual 和 diff hygiene 通过。受影响套件为 379 passed, 15 skipped, 1 failed；唯一失败 test_bounded_continuation_rechecks_original_capture_and_utf8_cursor 在不可变 main dd7a1c1034 上以相同断言失败，记为 pre_existing_unrelated。新增 saved-page/native-checkpoint 聚焦用例为 7 passed, 10 skipped；premerge 19 项无自动失败，保留既有 maintainability advisory 与 benchmark-sensitive manual hold，public/private scan 通过。

语义与 CI 对齐

唤醒文本仍然读取同一 immutable capture，actor、顺序、摘要来源、权限、继续和停止条件未变；变化只把展示入口和读取入口合成一次调用。关闭 native delivery 时不接受 --initial-read，普通 projection、context-read 续页和原 recovery 保持可用。remote CI 在审查时仍有 pending job，因此本结论依据 exact-head 本地验证；merge readiness 另行检查。

我的整体评价 / Verdict

goal_achieved 仅指“一次调用取得已保存决定首屏”这个有界能力。long_horizon 为 preserved：原决定、session lifecycle、compaction 后的同一 capture 和后续选择/结算边界都保留；user_experience 为 improved：已有授权和已知字段不再需要先发现 reader 的额外 round。没有 rendered UI 变更，visual review 为 not_applicable，检查面是 CLI/JSON 和 native instruction。

代码体积为 necessary：生产实现复用既有 selector、private IO 与 verified reader，测试覆盖 continuation、compaction、并发、off 和错误 scope；没有另造一个 context pipeline。兼容性没有 persisted contract 变化，属于 co-deployed CLI/presentation 扩展。

English verdict: APPROVE — exact head aa0f9492a1f86e17a7294aa274c1e44a851e09d7 delivers and reads the saved native-context first page through the existing verified reader, preserves #8100's prepared plan and off/recovery parity, and passes the changed-invariant suites.