docs: add v0.1 component specs

This commit is contained in:
Codex
2026-05-29 10:11:17 +08:00
parent 535d0c3f80
commit f896439940
14 changed files with 604 additions and 38 deletions
@@ -28,9 +28,15 @@
- `spec-v01-services.md`:服务总览、保留和 deferred 对象。
- `spec-v01-cicd.md`:版本 lane、GitOps、namespace、registry 和发布验收。
- `spec-v01-postgres.md`Postgres durable store、schema migration 和 DB SecretRef。
- `spec-v01-secret-distribution.md`Code Agent API Key、Postgres DSN 和运行时 Secret 分发。
- `spec-v01-secret-distribution.md`Code Agent provider credential、Postgres DSN 和运行时 Secret 分发。
- `spec-v01-validation.md`:两层验证模型、自测试和综合联调验收。
- 未来新增单服务规格必须使用 `spec-v01-<service-or-capability>.md`,例如 `spec-v01-agentrun-mgr.md``spec-v01-agentrun-runner.md`
- `spec-v01-agentrun-mgr.md`manager REST API、tenant boundary、runner claim、event/status authority
- `spec-v01-agentrun-runner.md`:短生命周期 runner、claim/poll/report、日志和 failureKind。
- `spec-v01-backend-adapter.md`backend adapter 合同、event normalization、failure mapping 和 redaction。
- `spec-v01-backend-codex.md`:第一真实 Codex backend、`~/.codex` 测试凭据 Secret projection 和真实 turn 验收。
- `spec-v01-cli.md`AgentRun CLI 命令族、JSON 输出、短返回、日志可见和测试规格。
- `spec-v01-scheduler.md`:自动 scheduler 的 deferred 边界。
- 未来新增单服务规格必须使用 `spec-v01-<service-or-capability>.md`
- `v0.2` 或更高版本的规格不得写入 `spec-v01-*`;只能在对应版本 lane 中创建自己的 `spec-v02-*``spec-v03-*`
- 每个可实现规格应包含“测试规格”小节;测试编号写在对应 spec 内,不创建或恢复根目录 `TEST.md`
@@ -52,13 +58,19 @@
- 发布和验收规格:[spec-v01-cicd.md](spec-v01-cicd.md)。
- 服务总览规格:[spec-v01-services.md](spec-v01-services.md)。
- Postgres durable store 规格:[spec-v01-postgres.md](spec-v01-postgres.md)。
- Secret/API Key 分发规格:[spec-v01-secret-distribution.md](spec-v01-secret-distribution.md)。
- Secret/provider credential 分发规格:[spec-v01-secret-distribution.md](spec-v01-secret-distribution.md)。
- 验证模型规格:[spec-v01-validation.md](spec-v01-validation.md)。
- Manager 服务规格:[spec-v01-agentrun-mgr.md](spec-v01-agentrun-mgr.md)。
- Runner 服务规格:[spec-v01-agentrun-runner.md](spec-v01-agentrun-runner.md)。
- Backend adapter 规格:[spec-v01-backend-adapter.md](spec-v01-backend-adapter.md)。
- Codex backend 规格:[spec-v01-backend-codex.md](spec-v01-backend-codex.md)。
- CLI 规格:[spec-v01-cli.md](spec-v01-cli.md)。
- Scheduler deferred 规格:[spec-v01-scheduler.md](spec-v01-scheduler.md)。
## 验收标准
- `AGENTS.md` 索引本文和其他 `spec-v01-*` 规格。
- `docs/reference/` 中存在 `spec-v01-documentation-governance.md``spec-v01-services.md``spec-v01-cicd.md``spec-v01-postgres.md``spec-v01-secret-distribution.md``spec-v01-validation.md`
- `docs/reference/` 中存在 `spec-v01-documentation-governance.md``spec-v01-services.md``spec-v01-cicd.md``spec-v01-postgres.md``spec-v01-secret-distribution.md``spec-v01-validation.md``spec-v01-agentrun-mgr.md``spec-v01-agentrun-runner.md``spec-v01-backend-adapter.md``spec-v01-backend-codex.md``spec-v01-cli.md``spec-v01-scheduler.md`
- `AGENTS.md``docs/reference/` 不得把旧 `agentrun_dev``agentrun_prod``G14:/root/agentrun``/root/agentrun` 写成当前工作区、namespace、发布目标或验收目标;只允许在废弃说明和历史背景中提及。
- `docs/` 根目录不新增临时 Markdown 报告或 JSON dump。
- 仓库根目录不存在 `TEST.md`;测试场景维护在对应 `spec-v01-*.md` 的“测试规格”小节。