From f9ef0d199bb2b9728040cab9041f26805e5c4eee Mon Sep 17 00:00:00 2001 From: mika <211269698+mikamikasuki@users.noreply.github.com> Date: Sun, 4 Oct 2026 04:47:01 -0700 Subject: [PATCH] docs(rfc): move dated checkpoint into ledger Signed-off-by: mika <211269698+mikamikasuki@users.noreply.github.com> --- docs/architecture/rfcs/STATUS.md | 2 +- docs/architecture/rfcs/STATUS.zh-CN.md | 2 +- ...xternal-evidence-research-capability-v0.md | 27 ++++--------------- ...l-evidence-research-capability-v0.zh-CN.md | 22 ++++----------- ...026-10-02-public-github-method-delivery.md | 27 +++++++++++++++++++ ...-02-public-github-method-delivery.zh-CN.md | 22 +++++++++++++++ 6 files changed, 61 insertions(+), 41 deletions(-) create mode 100644 docs/architecture/rfcs/ledger/external-evidence-research-capability-v0/2026-10-02-public-github-method-delivery.md create mode 100644 docs/architecture/rfcs/ledger/external-evidence-research-capability-v0/2026-10-02-public-github-method-delivery.zh-CN.md diff --git a/docs/architecture/rfcs/STATUS.md b/docs/architecture/rfcs/STATUS.md index 97cfb88f22..619eefaa2c 100644 --- a/docs/architecture/rfcs/STATUS.md +++ b/docs/architecture/rfcs/STATUS.md @@ -32,7 +32,7 @@ appendix may keep dated history, but no dated log heading may precede it. | [RFC: Composable State Machines and Recovery Verification (v0)](composable-state-machines-recovery-verification-v0.md) | Accepted | none | — | | [Explicit Todo continuation: Stage A](cross-session-memory-substrate-v0.md) | Accepted | none | — | | [RFC: LoopX Desktop Execution Frontends v0](desktop-execution-frontends-v0.md) | Accepted | none | — | -| [RFC: External Evidence Research Capability v0](external-evidence-research-capability-v0.md) | Accepted | none | — | +| [RFC: External Evidence Research Capability v0](external-evidence-research-capability-v0.md) | Accepted | none | [1 entry](ledger/external-evidence-research-capability-v0/) | | [RFC: Frontier Science Research Program v0](frontier-science-research-program-v0.md) | Accepted | none | — | | [RFC: Goal Artifact Lifecycle Projection (milestone / guard / next-transition) v0](goal-artifact-lifecycle-projection-v0.md) | Accepted | none | — | | [RFC: Goal Channel Collaboration v0](goal-channel-collaboration-v0.md) | Accepted | none | — | diff --git a/docs/architecture/rfcs/STATUS.zh-CN.md b/docs/architecture/rfcs/STATUS.zh-CN.md index 7d70441b22..d0d2e90aff 100644 --- a/docs/architecture/rfcs/STATUS.zh-CN.md +++ b/docs/architecture/rfcs/STATUS.zh-CN.md @@ -29,7 +29,7 @@ | [RFC：可组合状态机与恢复验证（v0）](composable-state-machines-recovery-verification-v0.zh-CN.md) | 已接受 | 无 | — | | [显式 Todo 接续：阶段 A](cross-session-memory-substrate-v0.zh-CN.md) | 已接受 | 无 | — | | [RFC：LoopX 桌面执行前端 v0](desktop-execution-frontends-v0.zh-CN.md) | 已接受 | 无 | — | -| [RFC：外部证据研究能力 v0](external-evidence-research-capability-v0.zh-CN.md) | 已接受 | 无 | — | +| [RFC：外部证据研究能力 v0](external-evidence-research-capability-v0.zh-CN.md) | 已接受 | 无 | [1 条](ledger/external-evidence-research-capability-v0/) | | [RFC：前沿科学研究计划 v0](frontier-science-research-program-v0.zh-CN.md) | 已接受 | 无 | — | | [RFC：Goal Artifact 生命周期投影（milestone / guard / next-transition）v0](goal-artifact-lifecycle-projection-v0.zh-CN.md) | 已接受 | 无 | — | | [RFC: Goal Channel 协作模型 v0](goal-channel-collaboration-v0.zh-CN.md) | 已接受 | 无 | — | diff --git a/docs/architecture/rfcs/external-evidence-research-capability-v0.md b/docs/architecture/rfcs/external-evidence-research-capability-v0.md index e1b5412c8f..a015b4ad81 100644 --- a/docs/architecture/rfcs/external-evidence-research-capability-v0.md +++ b/docs/architecture/rfcs/external-evidence-research-capability-v0.md @@ -102,28 +102,7 @@ inventory-only row for the same provider id. - retirement waits for downstream coverage of every admitted source; - CLI and effect-runtime TypeScript tests pass from the source checkout. -## Delivery checkpoint (2026-10-02) - -The public GitHub method now completes a bounded real journey: anonymous pinned -file reads, exact-plan receipt validation, a separate parent decision, projection -into the existing deepresearch source ledger, actual lineage readback and retirement. -Optional source refs and literal search terms are bound into the request/plan digest; -legacy requests retain their existing identity. The provider is bundled in extensions -under `method:public-github`; capability and ledger owners remain unchanged. - -Passed: real public-provider/source CLI journey; negative cases for private or stale -readiness, malformed/unpinned sources, plan/admission mutation, partial/empty/failed -reads, independent admission and coverage, wrong-question projection, budget failure -and idempotent replay; packaged desktop/mobile conversation readback and reload; -existing Lark Markdown presentation. Source bodies are not persisted. The shared -Markdown readback uses existing answer/report and Lark transports; no frontend -configuration or parallel evidence authority is needed. - -Commands are in the [versioned capability guide](../../../loopx/capabilities/external_research/README.md#public-github-method--公开-github-方法). -Live Lark delivery, authenticated connector execution and broader semantic research -quality remain untested; this checkpoint does not promote those providers or close -S6/S8. Failed or partial results preserve original-source fallback, and neither a -successful read nor a parent admission certifies evidence completeness. +- Checkpoint moved to the execution ledger: [Public GitHub method delivery checkpoint (2026-10-02)](ledger/external-evidence-research-capability-v0/2026-10-02-public-github-method-delivery.md). ## Non-goals @@ -133,3 +112,7 @@ successful read nor a parent admission certifies evidence completeness. - automatic evidence admission; - trading, publishing, or other downstream effect authority; - treating registration or usage counters as proof of evidence quality. + +## Appendix A: Execution ledger + +Dated delivery records live in the [per-entry ledger](ledger/external-evidence-research-capability-v0/). diff --git a/docs/architecture/rfcs/external-evidence-research-capability-v0.zh-CN.md b/docs/architecture/rfcs/external-evidence-research-capability-v0.zh-CN.md index d939db48c7..cfdddfe13a 100644 --- a/docs/architecture/rfcs/external-evidence-research-capability-v0.zh-CN.md +++ b/docs/architecture/rfcs/external-evidence-research-capability-v0.zh-CN.md @@ -81,23 +81,7 @@ Connector registry 继续只拥有库存与遥测。`supported` 绝不映射为 - 全部被采纳来源完成下游覆盖前不得退休； - CLI 与 effect-runtime TypeScript 测试在源码 checkout 中通过。 -## 交付检查点（2026-10-02） - -公开 GitHub method 已完成有界真实链路：匿名读取固定提交文件、精确 plan 回执校验、 -独立父 Agent 决定、投影到现有 deepresearch 来源账本、实际 lineage 回读与退休。 -可选 source refs 和字面检索词进入 request/plan digest；旧请求身份保持兼容。 -provider 以 `method:public-github` 内置在 extensions，能力和账本 owner 不变。 - -通过：真实公开 provider/源码 CLI 链路；私有或过期 readiness、无效/未固定来源、 -plan/admission 篡改、部分/空/失败读取、独立采纳与覆盖、问题不匹配、预算耗尽及 -幂等重放等负向用例；打包桌面/移动会话回读与重载；现有 Lark Markdown 展示。 -不持久化来源正文。同源 Markdown 沿用现有答复/报告和 Lark 运输路径， -无需新增前端配置或并行证据权威。 - -命令参见[版本化能力指南](../../../loopx/capabilities/external_research/README.md#public-github-method--公开-github-方法)。 -真实 Lark 送达、带凭据 connector 执行和更广泛语义研究质量尚未验证； -该检查点不晋升这些 provider，也不关闭 S6/S8。失败或部分结果保留原始来源退路； -读取成功和父 Agent 采纳均不证明证据完整性。 +- 检查点已移至执行账本：[公开 GitHub 方法交付检查点（2026-10-02）](ledger/external-evidence-research-capability-v0/2026-10-02-public-github-method-delivery.zh-CN.md)。 ## 非目标 @@ -107,3 +91,7 @@ plan/admission 篡改、部分/空/失败读取、独立采纳与覆盖、问题 - 自动采纳证据； - 交易、发布或其他下游 effect 权限； - 把注册或使用计数当作证据质量证明。 + +## 附录 A：执行账本 + +带日期的交付记录见[逐条执行账本](ledger/external-evidence-research-capability-v0/)。 diff --git a/docs/architecture/rfcs/ledger/external-evidence-research-capability-v0/2026-10-02-public-github-method-delivery.md b/docs/architecture/rfcs/ledger/external-evidence-research-capability-v0/2026-10-02-public-github-method-delivery.md new file mode 100644 index 0000000000..56c9e45c45 --- /dev/null +++ b/docs/architecture/rfcs/ledger/external-evidence-research-capability-v0/2026-10-02-public-github-method-delivery.md @@ -0,0 +1,27 @@ +# Public GitHub method delivery checkpoint + +Moved from `external-evidence-research-capability-v0.md`, former section `Delivery checkpoint (2026-10-02)`, on 2026-10-04 from RFC baseline `30efccd6c7d4e2300c2ac87ddc6ddb1dfb855a40`. + +[中文镜像](2026-10-02-public-github-method-delivery.zh-CN.md) + + +The public GitHub method now completes a bounded real journey: anonymous pinned +file reads, exact-plan receipt validation, a separate parent decision, projection +into the existing deepresearch source ledger, actual lineage readback and retirement. +Optional source refs and literal search terms are bound into the request/plan digest; +legacy requests retain their existing identity. The provider is bundled in extensions +under `method:public-github`; capability and ledger owners remain unchanged. + +Passed: real public-provider/source CLI journey; negative cases for private or stale +readiness, malformed/unpinned sources, plan/admission mutation, partial/empty/failed +reads, independent admission and coverage, wrong-question projection, budget failure +and idempotent replay; packaged desktop/mobile conversation readback and reload; +existing Lark Markdown presentation. Source bodies are not persisted. The shared +Markdown readback uses existing answer/report and Lark transports; no frontend +configuration or parallel evidence authority is needed. + +Commands are in the [versioned capability guide](../../../../../loopx/capabilities/external_research/README.md#public-github-method--公开-github-方法). +Live Lark delivery, authenticated connector execution and broader semantic research +quality remain untested; this checkpoint does not promote those providers or close +S6/S8. Failed or partial results preserve original-source fallback, and neither a +successful read nor a parent admission certifies evidence completeness. diff --git a/docs/architecture/rfcs/ledger/external-evidence-research-capability-v0/2026-10-02-public-github-method-delivery.zh-CN.md b/docs/architecture/rfcs/ledger/external-evidence-research-capability-v0/2026-10-02-public-github-method-delivery.zh-CN.md new file mode 100644 index 0000000000..f096871a2d --- /dev/null +++ b/docs/architecture/rfcs/ledger/external-evidence-research-capability-v0/2026-10-02-public-github-method-delivery.zh-CN.md @@ -0,0 +1,22 @@ +# 公开 GitHub 方法交付检查点 + +搬自 `external-evidence-research-capability-v0.zh-CN.md`，原小节为 `交付检查点（2026-10-02）`；于 2026-10-04 基于 RFC 基线 `30efccd6c7d4e2300c2ac87ddc6ddb1dfb855a40` 搬迁。 + +[English mirror](2026-10-02-public-github-method-delivery.md) + + +公开 GitHub method 已完成有界真实链路：匿名读取固定提交文件、精确 plan 回执校验、 +独立父 Agent 决定、投影到现有 deepresearch 来源账本、实际 lineage 回读与退休。 +可选 source refs 和字面检索词进入 request/plan digest；旧请求身份保持兼容。 +provider 以 `method:public-github` 内置在 extensions，能力和账本 owner 不变。 + +通过：真实公开 provider/源码 CLI 链路；私有或过期 readiness、无效/未固定来源、 +plan/admission 篡改、部分/空/失败读取、独立采纳与覆盖、问题不匹配、预算耗尽及 +幂等重放等负向用例；打包桌面/移动会话回读与重载；现有 Lark Markdown 展示。 +不持久化来源正文。同源 Markdown 沿用现有答复/报告和 Lark 运输路径， +无需新增前端配置或并行证据权威。 + +命令参见[版本化能力指南](../../../../../loopx/capabilities/external_research/README.md#public-github-method--公开-github-方法)。 +真实 Lark 送达、带凭据 connector 执行和更广泛语义研究质量尚未验证； +该检查点不晋升这些 provider，也不关闭 S6/S8。失败或部分结果保留原始来源退路； +读取成功和父 Agent 采纳均不证明证据完整性。