aps-agent/docs/plan/a1-a2-plan.md

A1–A2 串行实施计划（全自动执行）

由技术负责人指定：串行推进、自动完成。每步都必须带可验证证据，做完即提交。

前置状态

项	状态
A0	已完成：7 份 ADR（含 0008/0009/0010）、术语表、资产盘点 26 条、评审结论、两份设计文档入库
A1	5/8：A1.1 骨架、A1.2 依赖方向检查、A1.3 server 最小闭环、A1.7 协议、A1.8 HTTP 契约
测试	21 条：契约 7 + 依赖方向 8 + 服务端冒烟 6（pnpm test）

步骤

#	任务	做什么	验收证据
1	B0 前置	aps/ 目录 + ADR-0010（开发期同仓形态）+ 边界规则	ADR 提交、目录说明
2	A1.6 CI 基线	eslint + prettier 基线、跨库访问检查、能力描述检查、APS/平台 CI 分流	本地 pnpm lint 通过；CI 工作流含全部检查
3	A1.4 client 最小界面	Vite + React 三栏骨架：左会话列表、中对话流（SSE）、右工作区占位；连接状态；用协议 v1 类型	pnpm --filter @aps/client-app build 通过；服务端托管构建产物后能打开
4	A1.5 一键启动	pnpm dev 同时起服务端与前端；pnpm start 构建后单端口托管	实测两条命令可用；文档写清前置条件
5	A2.1 Provider SDK	manifest / execute / status 接口 + 能力分级 + 错误分类	类型编译 + 契约测试
6	A2.2 Core.invoke	最小执行入口：幂等键、超时、执行记录、回执	单测：幂等重放、超时未知、错误分类
7	A2.3/A2.4	内存假 Provider + 契约测试套件	契约套件对假 Provider 全绿
8	A2.7	问法评测集跑通（假引擎）	六项指标输出并记录

纪律

1. 每步一个提交，提交信息写清任务号与证据
2. contracts/ 单点负责：本计划期间由主线改
3. 每个新规则都要有会真失败的用例（依赖方向、契约漂移都已是这个标准）
4. 做完一步就更新任务表，不攒到最后

风险

风险	应对
前端引入 React/Vite 后 CI 变慢	只在 client 相关 job 跑构建；其余 job 不受影响
eslint 首次接入报大量历史问题	当前代码是新的，问题量小；真有问题分文件修，不整体关闭规则
A2.2 与 A3.1 的接口边界重叠	A2.2 只做 Core.invoke 与执行记录；引擎接口归 A3.1，二者不互相引用