wayfinder: 形成 Agent 平台 M1 启动与落地路线

## Destination

形成覆盖完整 M1 上线验收的可执行路线：以真实内部 Pilot 为首个里程碑，收敛权威架构与外部契约，明确并行交付边界，最终得到无冲突、有依赖、可进入人工授权周期的 Implementation Issue DAG。

地图完成不等于 M1 已实现或上线。

## Notes

- [M1 API、可观测、Eval 与审计范围修订](https://github.com/AgoraIO-Extensions/agent-infra/issues/464) 已完成决策，独立 Connection 直连与审计关联按 [交付衔接最终结论](https://github.com/AgoraIO-Extensions/agent-infra/issues/470#issuecomment-5646568047) 执行。平台 PRD 已形成 [独立评审稿 #475](https://github.com/AgoraIO-Extensions/agent-infra/pull/475)，工程 Spec 已形成 [独立评审稿](https://github.com/AgoraIO-Extensions/agent-infra/pull/477)，Runtime HLD 已形成 [API 任务与执行证据评审稿](https://github.com/AgoraIO-Extensions/agent-infra/pull/480)，三份候选均保持 Draft；文档差额、实施契约和验收进度统一回读 [完整 M1 汇合任务](https://github.com/AgoraIO-Extensions/agent-infra/issues/150)。需求确认、Draft PR 或 CI 通过均不代表权威文档已合入或能力已交付。
- 权威依据依次为两份 M1 PRD、M1 工程架构 Spec 与 AI 主导开发工作流 Spec。
- 责任划分：主系统 Map、Web、Platform Core/API、Codex Runtime、Registry/Secret、Kubernetes Workload Plane、Platform Delivery、ACK/Agent Workload 部署方案、平台部署、Pilot E2E、跨系统收口与 Connection 系统均由 [@LichKing-2234](https://github.com/LichKing-2234) 主责；Connection 仍由独立 Map 管理。Wayfinder 子票的 assignee 只表示当前 claim。
- 前后端架构与前端 UI 技术选型由 [M1 工程架构 Spec 的“技术栈”](https://github.com/AgoraIO-Extensions/agent-infra/blob/main/docs/architecture/SPEC-agent-infra-M1-engineering-architecture.md#21-%E6%8A%80%E6%9C%AF%E6%A0%88) 单点定义：React 19、TanStack Router、Vite、TanStack Query 与 Tailwind CSS + shadcn/ui；Hono、Node.js 24 LTS、PostgreSQL + Drizzle。
- Runtime 与 Adapter 选型由 [Agent Runtime M1 HLD 的“Runtime Registry 与交互模式”](https://github.com/AgoraIO-Extensions/agent-infra/blob/main/docs/architecture/HLD-agent-runtime-M1.md#3-runtime-registry-%E4%B8%8E%E4%BA%A4%E4%BA%92%E6%A8%A1%E5%BC%8F) 单点定义：Codex Native、Claude Native、OpenCode/Generic ACP、Pi RPC；自定义平台入口仅支持 Generic ACP，Worker 到 Pod-local RuntimeHost 使用版本化 HTTP/SSE。
- 每次处理决策票时使用 `grilling` 与 `domain-modeling`；需要外部事实时使用 `research`。
- 采用“横向架构基线先行，纵向 Pilot 验收”：身份与授权、数据权威、Runtime Contract、Connection 凭证边界、事件恢复、Kubernetes 调谐、审计与可观测性先形成门禁。
- 首个 Pilot：3–5 名内部员工在真实内部环境中，通过 Web 使用 Codex 标准模板；个人 GitHub Connection 读取受控测试仓库并创建 PR；验证未授权访问、撤权、恢复与审计。
- 现有 Issue 与 PR 只作为决策和实现证据，先判断吸收、改写、取代或关闭，不默认恢复或合并。
- Connection 的既有决策保留在 [Connection M1 启动与落地路线](https://github.com/AgoraIO-Extensions/agent-infra/issues/152)；当前权威文档与新实施 DAG 由 [Connection 独立 MCP/API 文档对齐](https://github.com/AgoraIO-Extensions/agent-infra/issues/432) 的现有负责人承接。历史 delegated 方案不再作为当前执行要求，旧票在新 DAG 评审前保留原状态。
- 架构契约稳定后，主系统并行推进 Web、Platform Core/API、Agent Workload 调谐、Codex Runtime Adapter、Platform Delivery；Connection/GitHub Provider 由独立子地图并行推进并在 Pilot 汇合。
- 当前路线收口入口为 [完整 M1 阶段、实施边界与依赖](https://github.com/AgoraIO-Extensions/agent-infra/issues/150)，其原生规划前置已完成。主系统 Fake readiness 由 [主系统 readiness 验收](https://github.com/AgoraIO-Extensions/agent-infra/issues/194) 承接；[联合 Platform/Connection Pilot 验收](https://github.com/AgoraIO-Extensions/agent-infra/issues/435) 已建立，旧 delegated 验收稿仍暂停准入，须消费新的权威文档后在原票修订。各阶段的成功声明与签收保持独立。
- #389、#400、#403、#404、#405、#406 的已确认修正范围由各票负责，依赖与三层验收交接统一在 #150 核对。Project 日期只作投影，重估须基于未完成工作、人工确认和资源窗口；本地图不把现有日期当作交付承诺。
- Wayfinder 默认只规划和决策；功能实现、发布与上线仍遵守 Issue -> 实现与验证 -> PR 以及人工授权门禁。

## Decisions so far

- [收敛现有 M1 Issue、PR 与权威文档](https://github.com/AgoraIO-Extensions/agent-infra/issues/145): Platform/Runtime 正式基线已合并，废弃与完成的旧架构票已收口；Connection 多 Consumer 方向移入 [独立子地图](https://github.com/AgoraIO-Extensions/agent-infra/issues/152)。
- [核验 M1 试点依赖的公司基础设施契约](https://github.com/AgoraIO-Extensions/agent-infra/issues/146): 七类依赖均未达到 Pilot-ready，已毕业为部署身份边界、Hub、KMS、Kubernetes、LLM Gateway 与文件范围六张主系统决策票。
- [决定 Pilot 是否验收附件与结果文件](https://github.com/AgoraIO-Extensions/agent-infra/issues/165): 首个 Codex Web Pilot 只交付文本、状态、GitHub PR 链接与摘要；文件传输和对象存储延后，但仍属于完整 M1。
- [确定开源主系统的部署身份边界](https://github.com/AgoraIO-Extensions/agent-infra/issues/160): 主系统只定义协议无关的 Identity Adapter/IdentityContext；具体认证与目录实现属于部署环境。
- [锁定部署无关的 OCI Registry 与 Runtime Manifest 准入契约](https://github.com/AgoraIO-Extensions/agent-infra/issues/161): 主系统只定义 ImageRegistryAdapter、不可变 Digest 与通用 Runtime Manifest；具体 Registry 和准入政策属于部署环境。
- [确定内置 Secret 加密与主密钥生命周期](https://github.com/AgoraIO-Extensions/agent-infra/issues/162): 项目使用随机 DEK + AEAD 自行保存密文；API 只持有加密公钥，Worker 独占解密 keyring，并通过可恢复两阶段协议激活候选 Secret。
- [确定 Kubernetes Workload Plane 与部署拓扑边界](https://github.com/AgoraIO-Extensions/agent-infra/issues/163): Worker、KubernetesRuntimeAdapter、Agent Workload 与部署路由位于 ACK；Web/API 位置无关，只有 Worker 持有现代 Kubernetes GA API 权限。
- [确定部署无关的模型端点与配置契约](https://github.com/AgoraIO-Extensions/agent-infra/issues/164): 部署目录只固定获准 Base URL、协议与能力政策；每个 Agent Owner 独立配置加密凭证、模型清单、默认模型和 reasoning。
- [确定 Agent Platform 主系统架构基线与变更门禁](https://github.com/AgoraIO-Extensions/agent-infra/issues/147): 冻结跨模块 contracts、权威与安全不变量；单一深 platform-core、Contract-first Web、DB/outbox API-Worker 协作和窄 Spec/ADR 门禁。
- [docs: mark RuntimeHost for future open-source extraction](https://github.com/AgoraIO-Extensions/agent-infra/issues/166): Pod-local RuntimeHost 与固定 Driver 通过版本化 Contract 隔离平台和原生协议；未来抽取只约束依赖、Conformance、安全与供应链质量，M1 不交付公共 package、通用 daemon 或动态插件。[PR #168](https://github.com/AgoraIO-Extensions/agent-infra/pull/168) 已将结论写入正式 HLD 与工程 Spec。
- [对齐主系统 PRD、工程 Spec 与 Architecture Baseline v1](https://github.com/AgoraIO-Extensions/agent-infra/issues/173): 权威文档已落地，工程 Spec 已固定前后端架构与前端 UI 技术栈；两条 ADR 随 [合并 PR](https://github.com/AgoraIO-Extensions/agent-infra/pull/174) 进入 main，merge SHA `82b5019` 的 main CI 通过。
- [确定主系统五条并行交付流的责任与接口交接](https://github.com/AgoraIO-Extensions/agent-infra/issues/148): 每个 artifact 单一 DRI，按 Web、Core/API、Workload、Runtime、Delivery 归属；Contract-first 小步汇入 main，消费方强制评审。
- [定义内部 Pilot 的架构准入与验收标准](https://github.com/AgoraIO-Extensions/agent-infra/issues/149): 完整创建链路、动态隔离/撤权、关键故障恢复、模板升级回滚、5 日真实观察和最小运维闭环构成硬门禁。
- [确定 Agent Platform 主系统 Implementation Issue DAG](https://github.com/AgoraIO-Extensions/agent-infra/issues/178): 主系统拆为 16 张 capability-sized Implementation Issues；Contract/Store 基础合并后 Web、Core/API、Workload、Runtime、Delivery 可并行，Platform Tool Gateway 独立交付，主系统先以 Fake Connection 完成 Pilot-readiness E2E，真实 GitHub Pilot 留待完整 M1 汇合票。
- [指定五条主系统交付流 DRI 与 Contract Reviewers](https://github.com/AgoraIO-Extensions/agent-infra/issues/176): 主系统平台、Registry/Secret、Kubernetes Workload Plane、Platform Delivery、ACK/Agent Workload 部署方案、平台部署、Pilot E2E、跨系统收口与 Connection 系统均由 @LichKing-2234 主责；跨边界 Contract 继续由消费方评审。
- [确定 wire contract Schema authority 与生成兼容门禁](https://github.com/AgoraIO-Extensions/agent-infra/issues/210): Zod 4 作为唯一手写 wire-schema source，单向生成并提交规范 OpenAPI 3.1 与机器校验 JSON Schema 2020-12；公共、浏览器/delegated、RuntimeHost 与 Workload Schema 分别由 #179/#180/#181/#182 主责，实施前先完成工程 Spec 与最小 ADR 对齐。
- [形成 Connection M1 启动与落地路线](https://github.com/AgoraIO-Extensions/agent-infra/issues/152)：独立路线决策已完成，权威文档由 [PR #408](https://github.com/AgoraIO-Extensions/agent-infra/pull/408) 落入 main；实现继续由 [Connection 交付总票 #402](https://github.com/AgoraIO-Extensions/agent-infra/issues/402) 协调，规划完成不表示 Connection 或真实 Pilot 已完成。

- [明确 M1 Agent API、可观测、Eval 与审计范围](https://github.com/AgoraIO-Extensions/agent-infra/issues/464)：API、全链路可观测、Eval 与审计范围及交付衔接已收口，Connection 独立直连并关联审计；权威文档和实施规划按 [最终结论](https://github.com/AgoraIO-Extensions/agent-infra/issues/470#issuecomment-5646568047) 继续。

## Not yet specified

- Pilot 之后 Claude、OpenCode、Pi、企微、自定义 Agent、共享 Connection 与完整上线加固的具体批次，由 #150 基于已完成的架构与 Pilot 决策、两份当前 PRD 和现有实施票继续细化。
- 完整 M1 的容量目标、发布推广、值班与故障演练安排，由 #150 核对真实试点资源、责任和证据后安排；缺少工作量或资源窗口依据时保持待估。
- 对象存储产品、bucket/role、短期 URL、文件扫描与保留契约在 Pilot 后、完整 M1 上线前由 #150 安排独立决策和资源任务，文件能力仍属于完整 M1。

## Out of scope

- Skill Hub、统一 Sandbox、多 Agent 协作、知识能力、Agent 删除、Webhook、定时任务和主动通知等尚未获准提前的 PRD Roadmap 能力。
- 在本地图内直接实现领域功能、合并历史 PR、发布镜像、部署环境或宣称 M1/Pilot 已上线。
- [补齐 GitHub Wayfinding tracker 操作约定](https://github.com/AgoraIO-Extensions/agent-infra/issues/151): 详细 GitHub CLI/GraphQL 命令目录已由独立 Workflow Map 的权威模型与仓库契约覆盖，不属于 Agent Platform M1 产品路线，按 `not planned` 关闭。