docs(research): define capability gateway boundary

[seekskyworld]

Problem

Issue #19 documents the move from resident entry tools toward capability discovery, but its reusable ownership and authority boundaries are not indexed as a canonical research record.

Value

The record makes Explicit and Adaptive behavior auditable while preserving Pi as the source of truth and preventing a gateway from becoming a second scheduler, provider stack, or authority plane.

Approach

• Add a validated research record for capability groups, loading modes, Setup exception, evidence limits, and non-goals.
• Link it from docs/research/README.md.
• Cross-link the related diagnostic record and source Issues.

Validation

• git diff --check — passed.
• npx --yes bun@1.3.14 run lint — passed.
• npx --yes bun@1.3.14 run typecheck — passed.
• Markdown reviewed against docs/README.md and docs/research/README.md.

Impact

• User-visible behavior: None.
• Model-visible context/tools: None.
• Runtime/lifecycle: None.
• Persisted config/data: None.
• Compatibility/risk: Documentation-only; no gateway or default-surface change is introduced.

Related to #19

[tt-a1i]

Review：Changes Requested

固定审查版本：388f8f501e84f0660a4cf83a4894a38eb65e6516。

问题 / 价值 / 方法： 将散落在 Issue 的能力发现与加载边界整理成可查阅的研究记录，并加入索引。保留 Pi 的生命周期与权限所有权，不新增运行时机制、配置入口或框架。方向合理。

Standards

1 项 P2：新建记录被放入“早于 Decision 0001、尚未迁移”的 Legacy records 区，错误表达了文档的治理身份。请移至当前研究区，见行内评论。

Spec

核心研究范围已覆盖。另有一组非阻塞补充：区分 #19 的常驻网关历史提案、#20 的零常驻后续结论与当前可选 Adaptive 的实现；补固定版本来源，以及 PR Approach 承诺的相关诊断记录/PR 与 Issue 回链即可。不需要新增设计层或校验器。

未将“lifecycle 工具由 owner 按资源状态管理”的歧义直接认定为运行时缺陷：它也可以指执行层校验。

验证

此前在同一 exact head 的隔离 checkout 上完成：

• bun install --frozen-lockfile 后，bun run check 通过。
• capabilities / tool-surface 专项测试：24/24 通过。
• 5 个本地 Markdown 链接可达，git diff --check 通过。
• 初次测试因未安装依赖无法启动，安装后通过；这不是产品缺陷。
• 本轮未重跑全量 bun run test，未调用模型或执行真实 TUI 验收。文档检查也不证明其引用的 Benchmark 结论。
• GitHub 现有 CI 绿色，但 PR 落后 main；同步后仍需核对最终版本。

本次只提交 review，未改文件、未合并。

[tt-a1i]

⚠️[P2] 将新建研究移出 Legacy records

此列表上方明确写着记录早于 Decision 0001、尚未迁移到新 metadata 契约；但这份新记录标注创建于 2026-08-30，而 Decision 0001 已于 2026-08-29 生效。放在这里会把新文档误标成历史豁免记录，也与文件自身的 validated 状态说明不一致。

请将条目放到独立的当前研究小节，并按现有 docs/README.md 约定声明适用来源/版本、相关 PR 和替代关系。只需调整文档分类及必要信息，不需要引入新格式框架。

[tt-a1i]

💡 [P3，非阻塞] 为当前 Adaptive 行为补版本来源

Adaptive 的描述与当前源码一致，但来源段的 #19/#20 没有描述“用户可选 Adaptive”：#19 提议默认常驻网关，#20 才收敛为普通 turn 零常驻。作为 validated 研究，建议把历史提案、当前实现和后续建议分开标注，并补固定版本依据，例如 当前审查版本的 README 与 capabilities 实现。

另外，PR Approach 承诺的相关诊断记录链接和 Issue 回链目前还未补齐；诊断文档未合并时，链接对应 PR #307 即可。这里需要补可追溯性，不需要修改运行时或另造文档。

[tt-a1i]

Code Review Summary

Changes Requested：1 项 P2，1 组非阻塞建议。 审查版本 388f8f5。

正式 review 与行内反馈。

• 需修： 新建研究误列为 Legacy records；移至当前研究区，补现有契约要求的信息。
• 建议： 为 Adaptive 补当前版本来源，区分历史提案/当前行为/后续建议，补相关诊断 PR 和 Issue 回链。
• 方向认可： 整理能力加载边界有价值；不需要改运行时或增加框架。
• 验证： exact-head bun run check、专项 24/24、5 个本地链接及 diff 检查通过。未重跑全量测试；现有 CI 绿色，PR 仍落后 main。

本次只提交审查，未改文件、未合并。

[seekskyworld]

Problem

Issue #19 documents the move from resident entry tools toward capability discovery, but its reusable ownership and authority boundaries are not indexed as a canonical research record.

Value

The record makes Explicit and Adaptive behavior auditable while preserving Pi as the source of truth and preventing a gateway from becoming a second scheduler, provider stack, or authority plane.

Approach

• Add a validated research record for capability groups, loading modes, Setup exception, evidence limits, and non-goals.
• Link it from docs/research/README.md.
• Cross-link the related diagnostic record and source Issues.

Validation

• git diff --check — passed.
• npx --yes bun@1.3.14 run lint — passed.
• npx --yes bun@1.3.14 run typecheck — passed.
• Markdown reviewed against docs/README.md and docs/research/README.md.

Impact

• User-visible behavior: None.
• Model-visible context/tools: None.
• Runtime/lifecycle: None.
• Persisted config/data: None.
• Compatibility/risk: Documentation-only; no gateway or default-surface change is introduced.

Related to #19

[tt-a1i]

Review：Changes Requested

固定审查版本：388f8f501e84f0660a4cf83a4894a38eb65e6516。

问题 / 价值 / 方法： 将散落在 Issue 的能力发现与加载边界整理成可查阅的研究记录，并加入索引。保留 Pi 的生命周期与权限所有权，不新增运行时机制、配置入口或框架。方向合理。

Standards

1 项 P2：新建记录被放入“早于 Decision 0001、尚未迁移”的 Legacy records 区，错误表达了文档的治理身份。请移至当前研究区，见行内评论。

Spec

核心研究范围已覆盖。另有一组非阻塞补充：区分 #19 的常驻网关历史提案、#20 的零常驻后续结论与当前可选 Adaptive 的实现；补固定版本来源，以及 PR Approach 承诺的相关诊断记录/PR 与 Issue 回链即可。不需要新增设计层或校验器。

未将“lifecycle 工具由 owner 按资源状态管理”的歧义直接认定为运行时缺陷：它也可以指执行层校验。

验证

此前在同一 exact head 的隔离 checkout 上完成：

• bun install --frozen-lockfile 后，bun run check 通过。
• capabilities / tool-surface 专项测试：24/24 通过。
• 5 个本地 Markdown 链接可达，git diff --check 通过。
• 初次测试因未安装依赖无法启动，安装后通过；这不是产品缺陷。
• 本轮未重跑全量 bun run test，未调用模型或执行真实 TUI 验收。文档检查也不证明其引用的 Benchmark 结论。
• GitHub 现有 CI 绿色，但 PR 落后 main；同步后仍需核对最终版本。

本次只提交 review，未改文件、未合并。

[tt-a1i]

⚠️[P2] 将新建研究移出 Legacy records

此列表上方明确写着记录早于 Decision 0001、尚未迁移到新 metadata 契约；但这份新记录标注创建于 2026-08-30，而 Decision 0001 已于 2026-08-29 生效。放在这里会把新文档误标成历史豁免记录，也与文件自身的 validated 状态说明不一致。

请将条目放到独立的当前研究小节，并按现有 docs/README.md 约定声明适用来源/版本、相关 PR 和替代关系。只需调整文档分类及必要信息，不需要引入新格式框架。

[tt-a1i]

💡 [P3，非阻塞] 为当前 Adaptive 行为补版本来源

Adaptive 的描述与当前源码一致，但来源段的 #19/#20 没有描述“用户可选 Adaptive”：#19 提议默认常驻网关，#20 才收敛为普通 turn 零常驻。作为 validated 研究，建议把历史提案、当前实现和后续建议分开标注，并补固定版本依据，例如 当前审查版本的 README 与 capabilities 实现。

另外，PR Approach 承诺的相关诊断记录链接和 Issue 回链目前还未补齐；诊断文档未合并时，链接对应 PR #307 即可。这里需要补可追溯性，不需要修改运行时或另造文档。

[tt-a1i]

Code Review Summary

Changes Requested：1 项 P2，1 组非阻塞建议。 审查版本 388f8f5。

正式 review 与行内反馈。

• 需修： 新建研究误列为 Legacy records；移至当前研究区，补现有契约要求的信息。
• 建议： 为 Adaptive 补当前版本来源，区分历史提案/当前行为/后续建议，补相关诊断 PR 和 Issue 回链。
• 方向认可： 整理能力加载边界有价值；不需要改运行时或增加框架。
• 验证： exact-head bun run check、专项 24/24、5 个本地链接及 diff 检查通过。未重跑全量测试；现有 CI 绿色，PR 仍落后 main。

本次只提交审查，未改文件、未合并。

[seekskyworld]

Problem

Issue #19 documents the move from resident entry tools toward capability discovery, but its reusable ownership and authority boundaries are not indexed as a canonical research record.

Value

The record makes Explicit and Adaptive behavior auditable while preserving Pi as the source of truth and preventing a gateway from becoming a second scheduler, provider stack, or authority plane.

Approach

• Add a validated research record for capability groups, loading modes, Setup exception, evidence limits, and non-goals.
• Link it from docs/research/README.md.
• Cross-link the related diagnostic record and source Issues.

Validation

• git diff --check — passed.
• npx --yes bun@1.3.14 run lint — passed.
• npx --yes bun@1.3.14 run typecheck — passed.
• Markdown reviewed against docs/README.md and docs/research/README.md.

Impact

• User-visible behavior: None.
• Model-visible context/tools: None.
• Runtime/lifecycle: None.
• Persisted config/data: None.
• Compatibility/risk: Documentation-only; no gateway or default-surface change is introduced.

Related to #19

[tt-a1i]

Review：Changes Requested

固定审查版本：388f8f501e84f0660a4cf83a4894a38eb65e6516。

问题 / 价值 / 方法： 将散落在 Issue 的能力发现与加载边界整理成可查阅的研究记录，并加入索引。保留 Pi 的生命周期与权限所有权，不新增运行时机制、配置入口或框架。方向合理。

Standards

1 项 P2：新建记录被放入“早于 Decision 0001、尚未迁移”的 Legacy records 区，错误表达了文档的治理身份。请移至当前研究区，见行内评论。

Spec

核心研究范围已覆盖。另有一组非阻塞补充：区分 #19 的常驻网关历史提案、#20 的零常驻后续结论与当前可选 Adaptive 的实现；补固定版本来源，以及 PR Approach 承诺的相关诊断记录/PR 与 Issue 回链即可。不需要新增设计层或校验器。

未将“lifecycle 工具由 owner 按资源状态管理”的歧义直接认定为运行时缺陷：它也可以指执行层校验。

验证

此前在同一 exact head 的隔离 checkout 上完成：

• bun install --frozen-lockfile 后，bun run check 通过。
• capabilities / tool-surface 专项测试：24/24 通过。
• 5 个本地 Markdown 链接可达，git diff --check 通过。
• 初次测试因未安装依赖无法启动，安装后通过；这不是产品缺陷。
• 本轮未重跑全量 bun run test，未调用模型或执行真实 TUI 验收。文档检查也不证明其引用的 Benchmark 结论。
• GitHub 现有 CI 绿色，但 PR 落后 main；同步后仍需核对最终版本。

本次只提交 review，未改文件、未合并。

[tt-a1i]

⚠️[P2] 将新建研究移出 Legacy records

此列表上方明确写着记录早于 Decision 0001、尚未迁移到新 metadata 契约；但这份新记录标注创建于 2026-08-30，而 Decision 0001 已于 2026-08-29 生效。放在这里会把新文档误标成历史豁免记录，也与文件自身的 validated 状态说明不一致。

请将条目放到独立的当前研究小节，并按现有 docs/README.md 约定声明适用来源/版本、相关 PR 和替代关系。只需调整文档分类及必要信息，不需要引入新格式框架。

[tt-a1i]

💡 [P3，非阻塞] 为当前 Adaptive 行为补版本来源

Adaptive 的描述与当前源码一致，但来源段的 #19/#20 没有描述“用户可选 Adaptive”：#19 提议默认常驻网关，#20 才收敛为普通 turn 零常驻。作为 validated 研究，建议把历史提案、当前实现和后续建议分开标注，并补固定版本依据，例如 当前审查版本的 README 与 capabilities 实现。

另外，PR Approach 承诺的相关诊断记录链接和 Issue 回链目前还未补齐；诊断文档未合并时，链接对应 PR #307 即可。这里需要补可追溯性，不需要修改运行时或另造文档。

[tt-a1i]

Code Review Summary

Changes Requested：1 项 P2，1 组非阻塞建议。 审查版本 388f8f5。

正式 review 与行内反馈。

• 需修： 新建研究误列为 Legacy records；移至当前研究区，补现有契约要求的信息。
• 建议： 为 Adaptive 补当前版本来源，区分历史提案/当前行为/后续建议，补相关诊断 PR 和 Issue 回链。
• 方向认可： 整理能力加载边界有价值；不需要改运行时或增加框架。
• 验证： exact-head bun run check、专项 24/24、5 个本地链接及 diff 检查通过。未重跑全量测试；现有 CI 绿色，PR 仍落后 main。

本次只提交审查，未改文件、未合并。

[seekskyworld]

Problem

Issue #19 documents the move from resident entry tools toward capability discovery, but its reusable ownership and authority boundaries are not indexed as a canonical research record.

Value

The record makes Explicit and Adaptive behavior auditable while preserving Pi as the source of truth and preventing a gateway from becoming a second scheduler, provider stack, or authority plane.

Approach

• Add a validated research record for capability groups, loading modes, Setup exception, evidence limits, and non-goals.
• Link it from docs/research/README.md.
• Cross-link the related diagnostic record and source Issues.

Validation

• git diff --check — passed.
• npx --yes bun@1.3.14 run lint — passed.
• npx --yes bun@1.3.14 run typecheck — passed.
• Markdown reviewed against docs/README.md and docs/research/README.md.

Impact

• User-visible behavior: None.
• Model-visible context/tools: None.
• Runtime/lifecycle: None.
• Persisted config/data: None.
• Compatibility/risk: Documentation-only; no gateway or default-surface change is introduced.

Related to #19

[tt-a1i]

Review：Changes Requested

固定审查版本：388f8f501e84f0660a4cf83a4894a38eb65e6516。

问题 / 价值 / 方法： 将散落在 Issue 的能力发现与加载边界整理成可查阅的研究记录，并加入索引。保留 Pi 的生命周期与权限所有权，不新增运行时机制、配置入口或框架。方向合理。

Standards

1 项 P2：新建记录被放入“早于 Decision 0001、尚未迁移”的 Legacy records 区，错误表达了文档的治理身份。请移至当前研究区，见行内评论。

Spec

核心研究范围已覆盖。另有一组非阻塞补充：区分 #19 的常驻网关历史提案、#20 的零常驻后续结论与当前可选 Adaptive 的实现；补固定版本来源，以及 PR Approach 承诺的相关诊断记录/PR 与 Issue 回链即可。不需要新增设计层或校验器。

未将“lifecycle 工具由 owner 按资源状态管理”的歧义直接认定为运行时缺陷：它也可以指执行层校验。

验证

此前在同一 exact head 的隔离 checkout 上完成：

• bun install --frozen-lockfile 后，bun run check 通过。
• capabilities / tool-surface 专项测试：24/24 通过。
• 5 个本地 Markdown 链接可达，git diff --check 通过。
• 初次测试因未安装依赖无法启动，安装后通过；这不是产品缺陷。
• 本轮未重跑全量 bun run test，未调用模型或执行真实 TUI 验收。文档检查也不证明其引用的 Benchmark 结论。
• GitHub 现有 CI 绿色，但 PR 落后 main；同步后仍需核对最终版本。

本次只提交 review，未改文件、未合并。

[tt-a1i]

⚠️[P2] 将新建研究移出 Legacy records

此列表上方明确写着记录早于 Decision 0001、尚未迁移到新 metadata 契约；但这份新记录标注创建于 2026-08-30，而 Decision 0001 已于 2026-08-29 生效。放在这里会把新文档误标成历史豁免记录，也与文件自身的 validated 状态说明不一致。

请将条目放到独立的当前研究小节，并按现有 docs/README.md 约定声明适用来源/版本、相关 PR 和替代关系。只需调整文档分类及必要信息，不需要引入新格式框架。

[tt-a1i]

💡 [P3，非阻塞] 为当前 Adaptive 行为补版本来源

Adaptive 的描述与当前源码一致，但来源段的 #19/#20 没有描述“用户可选 Adaptive”：#19 提议默认常驻网关，#20 才收敛为普通 turn 零常驻。作为 validated 研究，建议把历史提案、当前实现和后续建议分开标注，并补固定版本依据，例如 当前审查版本的 README 与 capabilities 实现。

另外，PR Approach 承诺的相关诊断记录链接和 Issue 回链目前还未补齐；诊断文档未合并时，链接对应 PR #307 即可。这里需要补可追溯性，不需要修改运行时或另造文档。

[tt-a1i]

Code Review Summary

Changes Requested：1 项 P2，1 组非阻塞建议。 审查版本 388f8f5。

正式 review 与行内反馈。

• 需修： 新建研究误列为 Legacy records；移至当前研究区，补现有契约要求的信息。
• 建议： 为 Adaptive 补当前版本来源，区分历史提案/当前行为/后续建议，补相关诊断 PR 和 Issue 回链。
• 方向认可： 整理能力加载边界有价值；不需要改运行时或增加框架。
• 验证： exact-head bun run check、专项 24/24、5 个本地链接及 diff 检查通过。未重跑全量测试；现有 CI 绿色，PR 仍落后 main。

本次只提交审查，未改文件、未合并。

[seekskyworld]

Problem

Issue #19 documents the move from resident entry tools toward capability discovery, but its reusable ownership and authority boundaries are not indexed as a canonical research record.

Value

The record makes Explicit and Adaptive behavior auditable while preserving Pi as the source of truth and preventing a gateway from becoming a second scheduler, provider stack, or authority plane.

Approach

• Add a validated research record for capability groups, loading modes, Setup exception, evidence limits, and non-goals.
• Link it from docs/research/README.md.
• Cross-link the related diagnostic record and source Issues.

Validation

• git diff --check — passed.
• npx --yes bun@1.3.14 run lint — passed.
• npx --yes bun@1.3.14 run typecheck — passed.
• Markdown reviewed against docs/README.md and docs/research/README.md.

Impact

• User-visible behavior: None.
• Model-visible context/tools: None.
• Runtime/lifecycle: None.
• Persisted config/data: None.
• Compatibility/risk: Documentation-only; no gateway or default-surface change is introduced.

Related to #19

[tt-a1i]

Review：Changes Requested

固定审查版本：388f8f501e84f0660a4cf83a4894a38eb65e6516。

问题 / 价值 / 方法： 将散落在 Issue 的能力发现与加载边界整理成可查阅的研究记录，并加入索引。保留 Pi 的生命周期与权限所有权，不新增运行时机制、配置入口或框架。方向合理。

Standards

1 项 P2：新建记录被放入“早于 Decision 0001、尚未迁移”的 Legacy records 区，错误表达了文档的治理身份。请移至当前研究区，见行内评论。

Spec

核心研究范围已覆盖。另有一组非阻塞补充：区分 #19 的常驻网关历史提案、#20 的零常驻后续结论与当前可选 Adaptive 的实现；补固定版本来源，以及 PR Approach 承诺的相关诊断记录/PR 与 Issue 回链即可。不需要新增设计层或校验器。

未将“lifecycle 工具由 owner 按资源状态管理”的歧义直接认定为运行时缺陷：它也可以指执行层校验。

验证

此前在同一 exact head 的隔离 checkout 上完成：

• bun install --frozen-lockfile 后，bun run check 通过。
• capabilities / tool-surface 专项测试：24/24 通过。
• 5 个本地 Markdown 链接可达，git diff --check 通过。
• 初次测试因未安装依赖无法启动，安装后通过；这不是产品缺陷。
• 本轮未重跑全量 bun run test，未调用模型或执行真实 TUI 验收。文档检查也不证明其引用的 Benchmark 结论。
• GitHub 现有 CI 绿色，但 PR 落后 main；同步后仍需核对最终版本。

本次只提交 review，未改文件、未合并。

[tt-a1i]

⚠️[P2] 将新建研究移出 Legacy records

此列表上方明确写着记录早于 Decision 0001、尚未迁移到新 metadata 契约；但这份新记录标注创建于 2026-08-30，而 Decision 0001 已于 2026-08-29 生效。放在这里会把新文档误标成历史豁免记录，也与文件自身的 validated 状态说明不一致。

请将条目放到独立的当前研究小节，并按现有 docs/README.md 约定声明适用来源/版本、相关 PR 和替代关系。只需调整文档分类及必要信息，不需要引入新格式框架。

[tt-a1i]

💡 [P3，非阻塞] 为当前 Adaptive 行为补版本来源

Adaptive 的描述与当前源码一致，但来源段的 #19/#20 没有描述“用户可选 Adaptive”：#19 提议默认常驻网关，#20 才收敛为普通 turn 零常驻。作为 validated 研究，建议把历史提案、当前实现和后续建议分开标注，并补固定版本依据，例如 当前审查版本的 README 与 capabilities 实现。

另外，PR Approach 承诺的相关诊断记录链接和 Issue 回链目前还未补齐；诊断文档未合并时，链接对应 PR #307 即可。这里需要补可追溯性，不需要修改运行时或另造文档。

[tt-a1i]

Code Review Summary

Changes Requested：1 项 P2，1 组非阻塞建议。 审查版本 388f8f5。

正式 review 与行内反馈。

• 需修： 新建研究误列为 Legacy records；移至当前研究区，补现有契约要求的信息。
• 建议： 为 Adaptive 补当前版本来源，区分历史提案/当前行为/后续建议，补相关诊断 PR 和 Issue 回链。
• 方向认可： 整理能力加载边界有价值；不需要改运行时或增加框架。
• 验证： exact-head bun run check、专项 24/24、5 个本地链接及 diff 检查通过。未重跑全量测试；现有 CI 绿色，PR 仍落后 main。

本次只提交审查，未改文件、未合并。

[seekskyworld]

Problem

Issue #19 documents the move from resident entry tools toward capability discovery, but its reusable ownership and authority boundaries are not indexed as a canonical research record.

Value

The record makes Explicit and Adaptive behavior auditable while preserving Pi as the source of truth and preventing a gateway from becoming a second scheduler, provider stack, or authority plane.

Approach

• Add a validated research record for capability groups, loading modes, Setup exception, evidence limits, and non-goals.
• Link it from docs/research/README.md.
• Cross-link the related diagnostic record and source Issues.

Validation

• git diff --check — passed.
• npx --yes bun@1.3.14 run lint — passed.
• npx --yes bun@1.3.14 run typecheck — passed.
• Markdown reviewed against docs/README.md and docs/research/README.md.

Impact

• User-visible behavior: None.
• Model-visible context/tools: None.
• Runtime/lifecycle: None.
• Persisted config/data: None.
• Compatibility/risk: Documentation-only; no gateway or default-surface change is introduced.

Related to #19

[tt-a1i]

Review：Changes Requested

固定审查版本：388f8f501e84f0660a4cf83a4894a38eb65e6516。

问题 / 价值 / 方法： 将散落在 Issue 的能力发现与加载边界整理成可查阅的研究记录，并加入索引。保留 Pi 的生命周期与权限所有权，不新增运行时机制、配置入口或框架。方向合理。

Standards

1 项 P2：新建记录被放入“早于 Decision 0001、尚未迁移”的 Legacy records 区，错误表达了文档的治理身份。请移至当前研究区，见行内评论。

Spec

核心研究范围已覆盖。另有一组非阻塞补充：区分 #19 的常驻网关历史提案、#20 的零常驻后续结论与当前可选 Adaptive 的实现；补固定版本来源，以及 PR Approach 承诺的相关诊断记录/PR 与 Issue 回链即可。不需要新增设计层或校验器。

未将“lifecycle 工具由 owner 按资源状态管理”的歧义直接认定为运行时缺陷：它也可以指执行层校验。

验证

此前在同一 exact head 的隔离 checkout 上完成：

• bun install --frozen-lockfile 后，bun run check 通过。
• capabilities / tool-surface 专项测试：24/24 通过。
• 5 个本地 Markdown 链接可达，git diff --check 通过。
• 初次测试因未安装依赖无法启动，安装后通过；这不是产品缺陷。
• 本轮未重跑全量 bun run test，未调用模型或执行真实 TUI 验收。文档检查也不证明其引用的 Benchmark 结论。
• GitHub 现有 CI 绿色，但 PR 落后 main；同步后仍需核对最终版本。

本次只提交 review，未改文件、未合并。

[tt-a1i]

⚠️[P2] 将新建研究移出 Legacy records

此列表上方明确写着记录早于 Decision 0001、尚未迁移到新 metadata 契约；但这份新记录标注创建于 2026-08-30，而 Decision 0001 已于 2026-08-29 生效。放在这里会把新文档误标成历史豁免记录，也与文件自身的 validated 状态说明不一致。

请将条目放到独立的当前研究小节，并按现有 docs/README.md 约定声明适用来源/版本、相关 PR 和替代关系。只需调整文档分类及必要信息，不需要引入新格式框架。

[tt-a1i]

💡 [P3，非阻塞] 为当前 Adaptive 行为补版本来源

Adaptive 的描述与当前源码一致，但来源段的 #19/#20 没有描述“用户可选 Adaptive”：#19 提议默认常驻网关，#20 才收敛为普通 turn 零常驻。作为 validated 研究，建议把历史提案、当前实现和后续建议分开标注，并补固定版本依据，例如 当前审查版本的 README 与 capabilities 实现。

另外，PR Approach 承诺的相关诊断记录链接和 Issue 回链目前还未补齐；诊断文档未合并时，链接对应 PR #307 即可。这里需要补可追溯性，不需要修改运行时或另造文档。

[tt-a1i]

Code Review Summary

Changes Requested：1 项 P2，1 组非阻塞建议。 审查版本 388f8f5。

正式 review 与行内反馈。

• 需修： 新建研究误列为 Legacy records；移至当前研究区，补现有契约要求的信息。
• 建议： 为 Adaptive 补当前版本来源，区分历史提案/当前行为/后续建议，补相关诊断 PR 和 Issue 回链。
• 方向认可： 整理能力加载边界有价值；不需要改运行时或增加框架。
• 验证： exact-head bun run check、专项 24/24、5 个本地链接及 diff 检查通过。未重跑全量测试；现有 CI 绿色，PR 仍落后 main。

本次只提交审查，未改文件、未合并。

[seekskyworld]

Problem

Issue #19 documents the move from resident entry tools toward capability discovery, but its reusable ownership and authority boundaries are not indexed as a canonical research record.

Value

The record makes Explicit and Adaptive behavior auditable while preserving Pi as the source of truth and preventing a gateway from becoming a second scheduler, provider stack, or authority plane.

Approach

• Add a validated research record for capability groups, loading modes, Setup exception, evidence limits, and non-goals.
• Link it from docs/research/README.md.
• Cross-link the related diagnostic record and source Issues.

Validation

• git diff --check — passed.
• npx --yes bun@1.3.14 run lint — passed.
• npx --yes bun@1.3.14 run typecheck — passed.
• Markdown reviewed against docs/README.md and docs/research/README.md.

Impact

• User-visible behavior: None.
• Model-visible context/tools: None.
• Runtime/lifecycle: None.
• Persisted config/data: None.
• Compatibility/risk: Documentation-only; no gateway or default-surface change is introduced.

Related to #19

[tt-a1i]

Review：Changes Requested

固定审查版本：388f8f501e84f0660a4cf83a4894a38eb65e6516。

问题 / 价值 / 方法： 将散落在 Issue 的能力发现与加载边界整理成可查阅的研究记录，并加入索引。保留 Pi 的生命周期与权限所有权，不新增运行时机制、配置入口或框架。方向合理。

Standards

1 项 P2：新建记录被放入“早于 Decision 0001、尚未迁移”的 Legacy records 区，错误表达了文档的治理身份。请移至当前研究区，见行内评论。

Spec

核心研究范围已覆盖。另有一组非阻塞补充：区分 #19 的常驻网关历史提案、#20 的零常驻后续结论与当前可选 Adaptive 的实现；补固定版本来源，以及 PR Approach 承诺的相关诊断记录/PR 与 Issue 回链即可。不需要新增设计层或校验器。

未将“lifecycle 工具由 owner 按资源状态管理”的歧义直接认定为运行时缺陷：它也可以指执行层校验。

验证

此前在同一 exact head 的隔离 checkout 上完成：

• bun install --frozen-lockfile 后，bun run check 通过。
• capabilities / tool-surface 专项测试：24/24 通过。
• 5 个本地 Markdown 链接可达，git diff --check 通过。
• 初次测试因未安装依赖无法启动，安装后通过；这不是产品缺陷。
• 本轮未重跑全量 bun run test，未调用模型或执行真实 TUI 验收。文档检查也不证明其引用的 Benchmark 结论。
• GitHub 现有 CI 绿色，但 PR 落后 main；同步后仍需核对最终版本。

本次只提交 review，未改文件、未合并。

[tt-a1i]

⚠️[P2] 将新建研究移出 Legacy records

此列表上方明确写着记录早于 Decision 0001、尚未迁移到新 metadata 契约；但这份新记录标注创建于 2026-08-30，而 Decision 0001 已于 2026-08-29 生效。放在这里会把新文档误标成历史豁免记录，也与文件自身的 validated 状态说明不一致。

请将条目放到独立的当前研究小节，并按现有 docs/README.md 约定声明适用来源/版本、相关 PR 和替代关系。只需调整文档分类及必要信息，不需要引入新格式框架。

[tt-a1i]

💡 [P3，非阻塞] 为当前 Adaptive 行为补版本来源

Adaptive 的描述与当前源码一致，但来源段的 #19/#20 没有描述“用户可选 Adaptive”：#19 提议默认常驻网关，#20 才收敛为普通 turn 零常驻。作为 validated 研究，建议把历史提案、当前实现和后续建议分开标注，并补固定版本依据，例如 当前审查版本的 README 与 capabilities 实现。

另外，PR Approach 承诺的相关诊断记录链接和 Issue 回链目前还未补齐；诊断文档未合并时，链接对应 PR #307 即可。这里需要补可追溯性，不需要修改运行时或另造文档。

[tt-a1i]

Code Review Summary

Changes Requested：1 项 P2，1 组非阻塞建议。 审查版本 388f8f5。

正式 review 与行内反馈。

• 需修： 新建研究误列为 Legacy records；移至当前研究区，补现有契约要求的信息。
• 建议： 为 Adaptive 补当前版本来源，区分历史提案/当前行为/后续建议，补相关诊断 PR 和 Issue 回链。
• 方向认可： 整理能力加载边界有价值；不需要改运行时或增加框架。
• 验证： exact-head bun run check、专项 24/24、5 个本地链接及 diff 检查通过。未重跑全量测试；现有 CI 绿色，PR 仍落后 main。

本次只提交审查，未改文件、未合并。

[seekskyworld]

Problem

Issue #19 documents the move from resident entry tools toward capability discovery, but its reusable ownership and authority boundaries are not indexed as a canonical research record.

Value

The record makes Explicit and Adaptive behavior auditable while preserving Pi as the source of truth and preventing a gateway from becoming a second scheduler, provider stack, or authority plane.

Approach

• Add a validated research record for capability groups, loading modes, Setup exception, evidence limits, and non-goals.
• Link it from docs/research/README.md.
• Cross-link the related diagnostic record and source Issues.

Validation

• git diff --check — passed.
• npx --yes bun@1.3.14 run lint — passed.
• npx --yes bun@1.3.14 run typecheck — passed.
• Markdown reviewed against docs/README.md and docs/research/README.md.

Impact

• User-visible behavior: None.
• Model-visible context/tools: None.
• Runtime/lifecycle: None.
• Persisted config/data: None.
• Compatibility/risk: Documentation-only; no gateway or default-surface change is introduced.

Related to #19

[tt-a1i]

Review：Changes Requested

固定审查版本：388f8f501e84f0660a4cf83a4894a38eb65e6516。

问题 / 价值 / 方法： 将散落在 Issue 的能力发现与加载边界整理成可查阅的研究记录，并加入索引。保留 Pi 的生命周期与权限所有权，不新增运行时机制、配置入口或框架。方向合理。

Standards

1 项 P2：新建记录被放入“早于 Decision 0001、尚未迁移”的 Legacy records 区，错误表达了文档的治理身份。请移至当前研究区，见行内评论。

Spec

核心研究范围已覆盖。另有一组非阻塞补充：区分 #19 的常驻网关历史提案、#20 的零常驻后续结论与当前可选 Adaptive 的实现；补固定版本来源，以及 PR Approach 承诺的相关诊断记录/PR 与 Issue 回链即可。不需要新增设计层或校验器。

未将“lifecycle 工具由 owner 按资源状态管理”的歧义直接认定为运行时缺陷：它也可以指执行层校验。

验证

此前在同一 exact head 的隔离 checkout 上完成：

• bun install --frozen-lockfile 后，bun run check 通过。
• capabilities / tool-surface 专项测试：24/24 通过。
• 5 个本地 Markdown 链接可达，git diff --check 通过。
• 初次测试因未安装依赖无法启动，安装后通过；这不是产品缺陷。
• 本轮未重跑全量 bun run test，未调用模型或执行真实 TUI 验收。文档检查也不证明其引用的 Benchmark 结论。
• GitHub 现有 CI 绿色，但 PR 落后 main；同步后仍需核对最终版本。

本次只提交 review，未改文件、未合并。

[tt-a1i]

⚠️[P2] 将新建研究移出 Legacy records

此列表上方明确写着记录早于 Decision 0001、尚未迁移到新 metadata 契约；但这份新记录标注创建于 2026-08-30，而 Decision 0001 已于 2026-08-29 生效。放在这里会把新文档误标成历史豁免记录，也与文件自身的 validated 状态说明不一致。

请将条目放到独立的当前研究小节，并按现有 docs/README.md 约定声明适用来源/版本、相关 PR 和替代关系。只需调整文档分类及必要信息，不需要引入新格式框架。

[tt-a1i]

💡 [P3，非阻塞] 为当前 Adaptive 行为补版本来源

Adaptive 的描述与当前源码一致，但来源段的 #19/#20 没有描述“用户可选 Adaptive”：#19 提议默认常驻网关，#20 才收敛为普通 turn 零常驻。作为 validated 研究，建议把历史提案、当前实现和后续建议分开标注，并补固定版本依据，例如 当前审查版本的 README 与 capabilities 实现。

另外，PR Approach 承诺的相关诊断记录链接和 Issue 回链目前还未补齐；诊断文档未合并时，链接对应 PR #307 即可。这里需要补可追溯性，不需要修改运行时或另造文档。

[tt-a1i]

Code Review Summary

Changes Requested：1 项 P2，1 组非阻塞建议。 审查版本 388f8f5。

正式 review 与行内反馈。

• 需修： 新建研究误列为 Legacy records；移至当前研究区，补现有契约要求的信息。
• 建议： 为 Adaptive 补当前版本来源，区分历史提案/当前行为/后续建议，补相关诊断 PR 和 Issue 回链。
• 方向认可： 整理能力加载边界有价值；不需要改运行时或增加框架。
• 验证： exact-head bun run check、专项 24/24、5 个本地链接及 diff 检查通过。未重跑全量测试；现有 CI 绿色，PR 仍落后 main。

本次只提交审查，未改文件、未合并。